Document architecture checkpoint and restore original task callback order
This commit is contained in:
1 parent
69d0187a21
commit
531883aaac
45 files changed
+2935
-43
No files matched your search
@@ -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");
|
||||
|
||||
@@ -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;
|
||||
|
||||
@@ -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");
|
||||
|
||||
@@ -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")),
|
||||
|
||||
@@ -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()
|
||||
@@ -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()
|
||||
@@ -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()
|
||||
@@ -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()
|
||||
@@ -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()
|
||||
@@ -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()
|
||||
@@ -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()
|
||||
@@ -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()
|
||||
Reference in new issue
Block a user