Document architecture checkpoint and restore original task callback order

This commit is contained in:
UnixNight committed 2026-10-25 12:56:17 -04:00
1 parent 69d0187a21
commit 531883aaac
45 files changed
+2935 -43

No files matched your search

+6
View File
@@ -32,12 +32,18 @@ Require(newGame.LevelCode == "LV1B" && newGame.StartPoint == "STARTEXP", "Wrong
var tasks = new TaskStates(newGame.Tasks);
Require(tasks.Get("scene") == 30 && tasks.Get("missing") == 0, "Original task query semantics differ");
var assignments = 0;
var assignmentPhases = new List<string>();
tasks.Assigning += (name, value) => assignmentPhases.Add($"before:{tasks.Get(name)}:{value}");
tasks.Assigned += (name, value) => assignmentPhases.Add($"after:{tasks.Get(name)}:{value}");
tasks.Assigned += (_, _) => assignments++;
tasks.SetExisting("ScEnE", 35);
tasks.SetExisting("missing", 77);
tasks.SetExisting("SCENE", 35);
Require(tasks.Get("SCENE") == 35 && tasks.Get("missing") == 0 && tasks.Snapshot().Length == 12 && assignments == 3,
"Task assignment must broadcast without creating missing entries");
Require(assignmentPhases.SequenceEqual(new[] { "before:30:35", "after:35:35", "before:0:77",
"after:0:77", "before:35:35", "after:35:35" }),
"Objective phase must see old records, entity phase new records, including repeated/missing assignments");
var changed = newGame with { Score = 15, Tasks = tasks.Snapshot() };
Require(OriginalSave.Parse(changed.Encode()).Score == 15 && OriginalSave.Parse(changed.Encode()).Tasks[3].State == 35,
"Modified original save did not persist recovered fields");
+39
View File
@@ -7,6 +7,45 @@ using GamePort.Application;
var root = Path.GetFullPath(args.Length == 1 ? args[0] : "../Original");
var level = GamLevel.Load(AssetPath.Resolve(root,"gam/level1b.gam"));
var save = OriginalSave.Load(AssetPath.Resolve(root,"NewGame.tsk"));
// Original Carl413F30 owns its complete base+derived task callback. Observers
// must never see a generic-only Carl state or wait for SceneInteractions to fix it.
var orderedTasks = new TaskStates(save.Tasks);
var orderedDirector = new SceneDirector(level, orderedTasks, (_, _) => 1);
var orderedCarl = orderedDirector.FindActor("C3DCARL")!;
var orderedMarker = orderedDirector.FindActor("CARLESC3")!;
var notifiedCarl = false;
var notifiedAfterCarl = false;
orderedDirector.ActorChanged += actor =>
{
if (ReferenceEquals(actor, orderedCarl))
{
Check(orderedTasks.Get("SCENE") == 50 && actor.Active && actor.Visible && actor.AIstate == 6
&& actor.Position == orderedMarker.Position, "Carl callback observer sees final derived state");
notifiedCarl = true;
}
else if (notifiedCarl)
{
Check(orderedCarl.Position == orderedMarker.Position && orderedCarl.AIstate == 6,
"Later actor callbacks observe completed Carl override");
notifiedAfterCarl = true;
}
};
orderedCarl.Position = Vector3.Zero; orderedCarl.AIstate = 0;
orderedTasks.SetExisting("SCENE", 50);
Check(notifiedCarl && notifiedAfterCarl, "Authored registry includes Carl followed by task actors");
foreach (var scene in new[] { -1, 0, 30, 31, 59, 60, 61 })
{
var boundaryTasks = new TaskStates(save.Tasks.Select(t => t.Name == "SCENE" ? t with { State = scene } : t));
var boundaryDirector = new SceneDirector(level, boundaryTasks, (_, _) => 1);
var actor = boundaryDirector.FindActor("C3DCARL")!;
var generic = TaskActivation.Animated(actor.SourceGam!, scene);
Check(actor.Active == (scene is >= 0 and < 60 || scene == 60 && generic != false),
"LV1B Carl derived activation boundaries and generic result at60");
if (scene is > 30 and <= 60)
Check(actor.AIstate == 6 && actor.Position == boundaryDirector.FindActor("CARLESC3")!.Position,
"Carl marker/state override follows base activation at construction");
}
Console.WriteLine("PASS per-actor Carl task callback order, derived observation and LV1B boundaries");
var tasks = new TaskStates(save.Tasks);
var director = new SceneDirector(level,tasks,(_,_)=>.1);
var cues = 0;
+22 -10
View File
@@ -10,7 +10,7 @@ var lab = GamLevel.Load(AssetPath.Resolve(root, "gam/level1b.gam"));
var counter = 1;
var tasks = new TaskStates(original.Tasks);
var director = new SceneDirector(lab, tasks, (_, _) => 5);
var interactions = new SceneInteractions(director, tasks, original, lab.Code);
var interactions = new SceneInteractions(director, tasks, original);
director.Begin(lab.FindStart()!);
interactions.Reset();
director.Skip();
@@ -25,7 +25,19 @@ var help = -1;
var selected = -1;
var events = new List<string>();
interactions.CheckpointCaptured += p => { checkpoint = p; events.Add("checkpoint"); };
tasks.Assigned += (name, state) => { if (name == "SCENE" && state == 50) events.Add("task50"); };
interactions.ObjectiveChanged += objective =>
{
if (objective != 2) return;
Check(tasks.Get("SCENE") == 35, "Objective callback observes old task records before assignment");
events.Add("objective2");
};
tasks.Assigned += (name, state) =>
{
if (name != "SCENE" || state != 50) return;
Check(interactions.CurrentObjective == 2 && tasks.Get(name) == 50,
"Entity assignment observers see the selected objective and new task records");
events.Add("task50");
};
interactions.PracticeRequested += page => { help = page; events.Add("help"); };
interactions.Inventory.GadgetSelected += gadget => { selected = gadget; events.Add("gadget"); };
interactions.Collected += (_, points) => events.Add("score" + points);
@@ -33,10 +45,10 @@ interactions.Update(shrinkray.Position);
Check(tasks.Get("SCENE") == 50 && interactions.Score == 50, "Shrinkray grants50 and original task35->50");
Check(interactions.Inventory.State(0, 3) == 1 && selected == 3 && help == 0, "Shrinkray inventory/help/gadget side effects");
Check(checkpoint == shrinkray.Position && !shrinkray.Visible && !shrinkray.Active, "Capture current root before hiding acquired shrinkray");
Check(events.SequenceEqual(new[] { "checkpoint", "task50", "help", "gadget", "score50" }), "Recovered special hook ordering");
Check(events.SequenceEqual(new[] { "checkpoint", "objective2", "task50", "help", "gadget", "score50" }), "Recovered special hook ordering");
Check(interactions.Snapshot().ItemStates[301] == 1 && interactions.CurrentObjective == 2, "Acquired state and objective2 persist");
interactions.Update(shrinkray.Position);
Check(interactions.Score == 50 && events.Count == 5, "Repeated overlap cannot recollect");
Check(interactions.Score == 50 && events.Count == 6, "Repeated overlap cannot recollect");
Console.WriteLine("PASS source intro/explanation/shrinkray state, inventory and event ordering");
var carl = director.FindActor("C3DCARL")!;
@@ -69,7 +81,7 @@ Check(decoded.InventoryStates[3] == 1 && decoded.ItemStates[301] == 1 && decoded
Check(decoded.StoredVector == original.StoredVector, "Pickup42AF00 does not overwrite the separate saved transition root");
var restoredTasks = new TaskStates(decoded.Tasks);
var restoredDirector = new SceneDirector(lab, restoredTasks, (_, _) => 5);
var restored = new SceneInteractions(restoredDirector, restoredTasks, decoded, lab.Code);
var restored = new SceneInteractions(restoredDirector, restoredTasks, decoded);
restoredDirector.Begin(lab.FindStart()!); restored.Reset(); restoredDirector.Skip();
Check(!restoredDirector.FindActor("shrinkray")!.Active && restored.Inventory.State(0, 3) == 1, "Resume retains collected shrinkray/inventory");
restored.Update(restoredDirector.FindActor("shrinkray")!.Position);
@@ -82,7 +94,7 @@ foreach (var state in new[] { 30, 36, 50 })
{
var boundaryTasks = new TaskStates(original.Tasks.Select(t => t.Name == "SCENE" ? t with { State = state } : t));
var boundaryDirector = new SceneDirector(lab, boundaryTasks, (_, _) => 1);
var boundary = new SceneInteractions(boundaryDirector, boundaryTasks, original, lab.Code);
var boundary = new SceneInteractions(boundaryDirector, boundaryTasks, original);
boundary.Update(boundaryDirector.FindActor("shrinkray")!.Position);
Check(boundaryTasks.Get("SCENE") == state && boundary.Inventory.State(0, 3) == 0 && boundary.Score == 50,
"Shrinkray special effect exact task35 gate, ordinary score remains");
@@ -100,7 +112,7 @@ foreach (var talkState in new[] { -1, -2, 50, 49 })
("TalkState2", -2), ("TalkTrigger2", "fallback"));
var testTasks = new TaskStates([new("SCENE", 50)]);
var testDirector = new SceneDirector(new("TEST", [body, friend, camera0, camera1]), testTasks, (_, _) => 5);
var test = new SceneInteractions(testDirector, testTasks, original, "TEST");
var test = new SceneInteractions(testDirector, testTasks, original);
test.Update(Vector3.Zero);
Check(testDirector.CurrentTag == (talkState is -2 or 50 ? "first" : "fallback"), "First existing match/wildcard; -1 disabled, missing target skipped");
Check(testTasks.Get("SCENE") == 60 && test.Score == 100, "Selected trigger alone invokes Carl callback");
@@ -109,7 +121,7 @@ var noneFriend = Entity("3CAR", "friend", ("AIState", 6), ("TargetName", "jim"),
("TalkState0", 49), ("TalkTrigger0", "first"));
var noTasks = new TaskStates([new("SCENE", 50)]);
var noDirector = new SceneDirector(new("TEST", [body, noneFriend, camera0]), noTasks, (_, _) => 5);
var noTalk = new SceneInteractions(noDirector, noTasks, original, "TEST");
var noTalk = new SceneInteractions(noDirector, noTasks, original);
noTalk.Update(Vector3.Zero);
Check(noTasks.Get("SCENE") == 50 && noTalk.Score == 0 && noDirector.FindActor("friend")!.AIstate == 0,
"No matching talk target leaves state0 without award/task mutation");
@@ -121,13 +133,13 @@ foreach (var distance in new[] { 160f, 159.5f })
("TalkState0", 50), ("TalkTrigger0", "first"));
var edgeTasks = new TaskStates([new("SCENE", 50)]);
var edgeDirector = new SceneDirector(new("TEST", [body, friend, camera0]), edgeTasks, (_, _) => 5);
var edge = new SceneInteractions(edgeDirector, edgeTasks, original, "TEST");
var edge = new SceneInteractions(edgeDirector, edgeTasks, original);
edge.Update(new(distance, 0, 0));
Check(edge.Score == (distance < 160 ? 100 : 0), "Strict original sum-radius Carl contact boundary");
}
var waiting = new SceneDirector(lab, new TaskStates(original.Tasks), (_, _) => 5);
waiting.Begin(lab.FindStart()!);
var locked = new SceneInteractions(waiting, new TaskStates(original.Tasks), original, lab.Code);
var locked = new SceneInteractions(waiting, new TaskStates(original.Tasks), original);
locked.Update(waiting.FindActor("shrinkray")!.Position);
Check(locked.Score == 0 && locked.Snapshot().ItemStates[301] == 0, "Noncontrolled intro cannot collect pickups");
Console.WriteLine("PASS strict recovered Carl radius boundary and active-player control gate");
+1 -1
View File
@@ -14,7 +14,7 @@ var save = OriginalSave.Load(Path.Combine(original, "NewGame.tsk"));
var tasks = new TaskStates(save.Tasks);
var resources = new PreparedEntityResources(Path.Combine(prepared, "level1b/entities/entities.json"));
var director = new SceneDirector(level, tasks, resources.Duration);
var interactions = new SceneInteractions(director, tasks, save, level.Code);
var interactions = new SceneInteractions(director, tasks, save);
var mechanisms = new SceneMechanisms(director);
var visuals = new StaticSceneVisuals(world, director, original, Path.Combine(prepared, "level1b/models"));
var simulation = new LabSimulation(new SceneCollision(world), AseMesh.Load(AssetPath.Resolve(original, "ASE/jimstop.ase")),
@@ -16,7 +16,7 @@ var tasks = new TaskStates(save.Tasks);
tasks.SetExisting("SCENE", 65);
var resources = new PreparedEntityResources(Path.Combine(prepared, "level1b/entities/entities.json"));
var director = new SceneDirector(level, tasks, resources.Duration);
var interactions = new SceneInteractions(director, tasks, save, level.Code);
var interactions = new SceneInteractions(director, tasks, save);
var mechanisms = new SceneMechanisms(director);
var visuals = new StaticSceneVisuals(world, director, original, Path.Combine(prepared, "level1b/models"));
var simulation = new LabSimulation(new SceneCollision(world), AseMesh.Load(AssetPath.Resolve(original, "ASE/jimstop.ase")),
+32
View File
@@ -0,0 +1,32 @@
"""Immutable PE contract and bounded recovered camera algebra checks."""
import importlib.util
from pathlib import Path
import sys
import unittest
ROOT = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(ROOT / 'tools' / 'binary'))
spec = importlib.util.spec_from_file_location('checkpoint_camera_audio_ui',
ROOT / 'tools' / 'binary' / 'checkpoint_camera_audio_ui.py')
checkpoint = importlib.util.module_from_spec(spec)
spec.loader.exec_module(checkpoint)
class CameraAudioUiCheckpointTests(unittest.TestCase):
def test_original_contract_and_offsets(self):
result = checkpoint.recover(ROOT.parent / 'Original')
self.assertEqual(len(checkpoint.ANCHORS), len(result['anchors']))
self.assertEqual(len(checkpoint.CONSTANTS), len(result['constants']))
for entry in result['anchors'] + result['constants']:
self.assertEqual(int(entry['va'], 16) - 0x400000, int(entry['file_offset'], 16))
self.assertTrue(all(g['file_offset'] is None for g in result['globals']))
def test_ray_adjustment_toward_look_point(self):
self.assertEqual((0, 25, 75), checkpoint.obstructed_eye((0, 100, 0), (0, 0, 100)))
self.assertEqual((5, -4, 3), checkpoint.obstructed_eye((5, -4, 3), (5, -4, 3)))
# Translation must not affect the weighting; this guards point vs direction confusion.
self.assertEqual((100, 125, 175), checkpoint.obstructed_eye((100, 200, 100), (100, 100, 200)))
if __name__ == '__main__':
unittest.main()
+59
View File
@@ -0,0 +1,59 @@
"""Source camera predicate priorities/order, including deliberately non-nearest hits."""
import importlib.util
from pathlib import Path
import sys
import unittest
ROOT = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(ROOT / 'tools' / 'binary'))
spec = importlib.util.spec_from_file_location('checkpoint_camera_ray',
ROOT / 'tools' / 'binary' / 'checkpoint_camera_ray.py')
ray = importlib.util.module_from_spec(spec)
spec.loader.exec_module(ray)
class CameraRayCheckpointTests(unittest.TestCase):
def test_source_and_route_data(self):
data = ray.recover(ROOT.parent / 'Original')
self.assertEqual(len(ray.ANCHORS), len(data['anchors']))
expected = {'level1b.omt': (2851, 2483, 18), 'VR04.omt': (508, 420, 0),
'level1.omt': (5231, 3860, 24)}
for name, (polygons, walls, excluded) in expected.items():
entry = data['route_geometry'][name]
self.assertEqual({3: polygons}, entry['registered_polygon_corner_counts'])
self.assertEqual(walls, entry['wall_grid_polygons'])
self.assertEqual(excluded, entry['nc_polygons_excluded'])
self.assertEqual(0, entry['checkpoint_polygons_excluded'])
self.assertTrue(entry['shape_ids_ascending'])
def test_grid_rectangle_order_and_negative_truncation(self):
self.assertEqual(129, ray.cell_coordinate(-1))
self.assertEqual(130, ray.cell_coordinate(0))
expected = [(130, 130), (130, 131), (131, 130), (131, 131)]
self.assertEqual(expected, list(ray.cells_between((0, 0, 0), (501, 0, 501))))
self.assertEqual(expected, list(ray.cells_between((501, 100, 501), (0, -100, 0))))
self.assertEqual([], list(ray.cells_between((1e6, 0, 1e6), (1e6, 0, 1e6))))
def test_first_wall_hit_overrides_nearer_all_grid_hit(self):
wall = {(130, 130): ['far', 'near']}
all_grid = {(130, 130): ['nearest_floor']}
distances = {'far': 80, 'near': 20, 'nearest_floor': 10}
query = lambda p, a, b, sides: distances[p]
self.assertEqual(('far', 80), ray.first_hit((0, 0, 0), (100, 0, 0), wall, all_grid, query))
def test_cell_priority_duplicate_tests_fallback_and_gate(self):
seen = []
wall = {(130, 130): ['miss'], (130, 131): ['miss']}
all_grid = {(130, 130): ['hit']}
def accept(p, start, end, sides):
seen.append((p, sides))
return 1 if p == 'hit' else None
self.assertEqual(('hit', 1), ray.first_hit((0, 0, 0), (0, 0, 501), wall, all_grid, accept))
self.assertEqual([('miss', False), ('miss', False), ('hit', False)], seen)
seen.clear()
self.assertIsNone(ray.first_hit((0, 0, 0), (0, 0, 501), wall, all_grid, accept, enabled=False))
self.assertEqual([], seen)
if __name__ == '__main__':
unittest.main()
+28
View File
@@ -0,0 +1,28 @@
"""Regress the actual binary bridge, not a guessed phase-order simulation."""
from pathlib import Path
import sys
import unittest
ROOT = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(ROOT / 'tools' / 'binary'))
from checkpoint_input_frame import collect, SLOTS, CALLS
class InputFrameEvidenceTests(unittest.TestCase):
def test_original_dispatch_and_timer_evidence(self):
original = ROOT.parent / 'Original'
if not (original / 'Neutron.exe').exists():
self.skipTest('Original evidence is local-only and absent')
report = collect(original)
self.assertEqual(len(report['evidence']), 30)
self.assertEqual(len(SLOTS), 8)
self.assertEqual(len(CALLS), 6)
def test_physics_precedes_registry_in_same_viewport_override(self):
sites = {label: va for va, _, label in CALLS}
self.assertLess(sites['physics'], sites['all game objects'])
self.assertLess(sites['all game objects'], sites['all logical-to-visual transforms'])
if __name__ == '__main__':
unittest.main()
+26
View File
@@ -0,0 +1,26 @@
"""Original-source construction boundaries for the scheduler checkpoint."""
from pathlib import Path
import sys
import unittest
ROOT = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(ROOT / 'tools' / 'binary'))
from checkpoint_lab_registry import collect, ANCHORS, CALLS, SLOTS
class LabRegistryEvidenceTests(unittest.TestCase):
def test_original_lab_construction_trace(self):
original = ROOT.parent / 'Original'
if not (original / 'Neutron.exe').exists():
self.skipTest('Local original files absent')
report = collect(original)
self.assertEqual(len(report['evidence']), len(ANCHORS) + len(CALLS) + len(SLOTS))
self.assertEqual(report['lab']['code'], 'LV1B')
self.assertEqual(report['lab']['entities'], 129)
self.assertEqual(report['lab']['first_record'], dict(kind='3JIM', offset='0x8', tag='JIM1'))
self.assertEqual(report['lab']['serialized_goddards'], 0)
self.assertIn('Retained/reused', report['boundary'])
if __name__ == '__main__':
unittest.main()
+25
View File
@@ -0,0 +1,25 @@
import importlib.util
from pathlib import Path
import sys
import unittest
PROJECT = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(PROJECT / 'tools/binary'))
from checkpoint_loop_motion import recover
class CheckpointLoopEvidence(unittest.TestCase):
def test_original_frame_and_registry_anchors(self):
evidence = recover(PROJECT.parent / 'Original')
self.assertEqual([x['target'] for x in evidence['calls']],
['0x479bc0', '0x462a20', '0x4693a0', '0x47d8f0',
'0x473740', '0x473770', '0x477db0'])
self.assertEqual(evidence['viewport_slot_b8']['target'], '0x47e4f0')
self.assertEqual(len(evidence['anchors']), 11)
for item in evidence['calls'] + evidence['anchors']:
self.assertEqual(int(item['va'], 16) - 0x400000,
int(item['file_offset'], 16))
if __name__ == '__main__':
unittest.main()
+57
View File
@@ -0,0 +1,57 @@
"""Static evidence guards; no original executable is launched."""
import importlib.util
from pathlib import Path
import unittest
ROOT = Path(__file__).resolve().parents[1]
SPEC = importlib.util.spec_from_file_location(
"checkpoint_scene_loader", ROOT / "tools/binary/checkpoint_scene_loader.py")
loader = importlib.util.module_from_spec(SPEC)
SPEC.loader.exec_module(loader)
class SceneLoaderEvidenceTests(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.report = loader.collect(ROOT.parent / "Original")
def test_exact_original_sites_and_receiver_vtables(self):
self.assertTrue(self.report["known_binary"])
for site in self.report["sites"] + self.report["vtables"]:
with self.subTest(site=site["name"]):
self.assertTrue(site["matches"], site)
def test_pending_game_load_and_tsk_load_are_different_owners(self):
tables = {t["name"]: t["target"] for t in self.report["vtables"]}
self.assertEqual(tables["editor request load"], "0x46df70")
self.assertEqual(tables["editor consume load"], "0x46dff0")
self.assertEqual(tables["editor load GAM"], "0x46e170")
self.assertEqual(tables["editor reset/postload"], "0x46e570")
self.assertEqual(tables["Jimmy placement PostLoad"], "0x423610")
def test_reset_is_R_input_not_serialized_loader_flag(self):
self.assertEqual(self.report["acquired_reset_virtual_key"], ord("R"))
sites = {s["name"]: s for s in self.report["sites"]}
self.assertEqual(sites["acquired_reset_count"]["actual"], "b968100000") #4200 dwords
self.assertEqual(sites["jimmy_constructor_flag"]["direct_call_target"], "0x470f40")
self.assertEqual(sites["goddard_constructor_flag"]["direct_call_target"], "0x470f40")
self.assertEqual(sites["jimmy_constructor_reusable"]["actual"], "c685c900000001")
self.assertEqual(sites["goddard_constructor_reusable"]["actual"], "c686c900000001")
def test_factory_destruction_and_timer_dependencies(self):
sites = {s["name"]: s for s in self.report["sites"]}
self.assertEqual(sites["object_factory"]["direct_call_target"], "0x459cb0")
self.assertEqual(sites["teardown_delete_sweep"]["direct_call_target"], "0x473710")
self.assertEqual(sites["registry_timer_reset"]["direct_call_target"], "0x47e470")
def test_game_constructor_and_prefix_do_not_identify_old_game_removal(self):
sites = {s["name"]: s for s in self.report["sites"]}
self.assertEqual(sites["load_prefix_caption_cleanup"]["direct_call_target"], "0x4766e0")
self.assertEqual(sites["load_prefix_physics_cleanup"]["direct_call_target"], "0x479000")
self.assertEqual(sites["lab_constructor_base"]["direct_call_target"], "0x44d2b0")
self.assertEqual(sites["game_constructor_base"]["direct_call_target"], "0x4745a0")
self.assertEqual(sites["game_constructor_clear_control"]["direct_call_target"], "0x475a40")
if __name__ == "__main__":
unittest.main()
+60
View File
@@ -0,0 +1,60 @@
"""Original-data evidence for task ordering and separate transition state."""
import importlib.util
from pathlib import Path
import unittest
ROOT = Path(__file__).resolve().parents[1]
SPEC = importlib.util.spec_from_file_location(
"checkpoint_script_state", ROOT / "tools/binary/checkpoint_script_state.py")
evidence = importlib.util.module_from_spec(SPEC)
SPEC.loader.exec_module(evidence)
class ScriptStateEvidenceTests(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.original = ROOT.parent / "Original"
cls.report = evidence.collect(cls.original)
def test_binary_identity_sites_and_virtual_call_provenance(self):
self.assertTrue(self.report["known_binary"])
for site in self.report["sites"] + self.report["vtables"]:
with self.subTest(site=site["name"]):
self.assertTrue(site["matches"], site)
def test_objective_record_and_actor_call_order(self):
sites = {s["name"]: s for s in self.report["sites"]}
names = ["task_objective_before_records", "task_record_mutation", "task_entity_callback"]
self.assertEqual([int(sites[n]["va"], 16) for n in names], [0x45FB5B, 0x45FB7F, 0x45FBD9])
self.assertEqual(sites[names[0]]["direct_call_target"], "0x406f50")
self.assertEqual(sites["carl_query_scene"]["direct_call_target"], "0x45fea0")
self.assertEqual(sites["carl_generic_callback"]["direct_call_target"], "0x40e340")
def test_tsk_rebroadcast_and_deferred_load(self):
sites = {s["name"]: s for s in self.report["sites"]}
self.assertEqual(sites["tsk_setter_call"]["direct_call_target"], "0x45f990")
self.assertEqual(sites["load_update_reader"]["direct_call_target"], "0x4603f0")
# Slot420 is not Jimmy's placement PostLoad: its actual target matters.
slots = {s["name"]: s["target"] for s in self.report["vtables"]}
self.assertEqual(slots["Jimmy game post-task hook"], "0x472970")
def test_route_keeps_return_distinct_from_outside(self):
lab, tutorial = self.report["route"]
self.assertEqual((lab["code"], tutorial["code"]), ("LV1B", "VR04"))
exits = [e["fields"] for e in lab["entities"] if e["kind"] == "LOAD"]
self.assertTrue(any(e.get("LevelName", "").casefold() == "level1.gam"
and e.get("StartPoint", "").casefold() == "level1"
and e.get("RequiredLevel") == 60 for e in exits))
self.assertTrue(any(e["fields"].get("LevelName", "").casefold() == "return"
for e in tutorial["entities"]))
def test_non_call_and_negative_read_rejected(self):
pe = evidence.PE(evidence.find_case(self.original, "neutron.exe"))
with self.assertRaises(ValueError):
evidence.rel_call_target(pe, 0x45FB7F)
with self.assertRaises(ValueError):
evidence.read_va(pe, 0x45FB7F, -1)
if __name__ == "__main__":
unittest.main()
+19
View File
@@ -0,0 +1,19 @@
from pathlib import Path
import sys
import unittest
ROOT = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(ROOT / 'tools/binary'))
from checkpoint_voice_clock import collect
class VoiceClockEvidenceTests(unittest.TestCase):
def test_original_voice_uses_software_time_and_repeat(self):
report = collect(ROOT.parent / 'Original')
self.assertEqual(len(report['vtables']), 3)
self.assertEqual(len(report['anchors']), 12)
self.assertEqual([c['value'] for c in report['constants']], [.5, 1000.0])
if __name__ == '__main__':
unittest.main()