#!/usr/bin/env python3 """Guard original camera orientation suffixes and prepare a separate native probe.""" import argparse import hashlib import json from pathlib import Path import re from checkpoint_script_state import EXE_SHA256, find_case, read_va from pe_inspect import PE REA_ID = 'ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904' RANGES = ( ('CAM orientation suffix', 0x416671, 0x4166eb, 'ded5dc3a2eeb96b8a970ade5193f98c6fcfd565e031efb9ce807348c821f854b'), ('MCA orientation suffix', 0x431518, 0x431590, 'abfb135a13645f0388da3c44f592053a2738eb6c4399e8e66cade6d86c1892ab'), ('current Euler getter', 0x4723f0, 0x47241a, 'f576bd9ce9d110bc9f6228ad84351add5aa2ce0a5fd2bcbb6ac1873a69d588e8'), ('current Euler full setter', 0x472450, 0x472474, '28a62af15c1ebffac1313d212fc3279d73b6cab8a37aca55bf0b4c48ccc76e32'), ('Jimmy facing', 0x43a420, 0x43a5cd, '1080773fae9170a107488528780efcd349cb930ca8a33fc8a845358b95f9ad38'), ('Euler-add thunk', 0x458f90, 0x458fb0, 'f63412bcbafc82323cff26c093e41a457e40a5b60afd2ed5fed02340a4405b1a'), ('Euler-add leaf', 0x472480, 0x47265b, '77e017813241344ff0f6fdde80102d08774dd044ae65f29f48f999ccd1e03d3d'), ) def collect(original, rea_disassembly=None): pe = PE(find_case(Path(original), 'Neutron.exe')) if hashlib.sha256(pe.data).hexdigest() != EXE_SHA256: raise ValueError('Unsupported original EXE identity') rows = [] for name, start, end, expected in RANGES: actual = hashlib.sha256(read_va(pe, start, end-start)).hexdigest() if actual != expected: raise ValueError(f'Changed original {name}') rows.append(dict(name=name, va=hex(start), file_offset=hex(pe.offset(start-pe.base)), length=end-start, sha256=actual)) result = dict(source_sha256=EXE_SHA256, rea_evidence_id=REA_ID, ranges=rows, current_euler='game+224..230', destination_euler='game+274..280', dirty='game+A; unchanged by both orientation suffixes', scope='Static byte guard; generated probe executes bounded copied suffixes, not camera activation or the whole game.') if rea_disassembly: bundle = json.loads(Path(rea_disassembly).read_text()) record = next(r for r in bundle['records'] if r['evidence_id'] == REA_ID) assembly = record['raw_result']['stdout'] extracts = {} for name, start, end, _ in RANGES: lines=[] for line in assembly.splitlines(): m = re.match(r'\s*([0-9a-f]+):', line) if m and start <= int(m[1],16) < end: lines.append(line) if not lines: raise ValueError(f'Retained REA misses {name}') extracts[name]='\n'.join(lines)+'\n' result['rea_extracts'] = extracts return result def generate(original, output, rea_disassembly=None): original = Path(original).resolve() output = Path(output).resolve() if output.is_relative_to(original) or original.is_relative_to(output): raise ValueError('Probe directory must be separate from originals') result = collect(original, rea_disassembly) output.mkdir(parents=True, exist_ok=True) for name in ('jimmy_cutscene_rotation_probe.c', 'grappler_scalar_probe.c'): (output/name).write_text(Path(__file__).with_name(name).read_text()) (output/'source.json').write_text(json.dumps(result,indent=2)+'\n') return result if __name__ == '__main__': parser=argparse.ArgumentParser(description=__doc__) parser.add_argument('original',type=Path) parser.add_argument('--rea-disassembly',type=Path) parser.add_argument('--generate-probe',type=Path) args=parser.parse_args() result=generate(args.original,args.generate_probe,args.rea_disassembly) if args.generate_probe else collect(args.original,args.rea_disassembly) print(json.dumps(result,indent=2))