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

+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()