Trace Carl lifecycle and add read-only original state observer

This commit is contained in:
UnixNight committed 2026-11-06 10:27:10 -05:00
1 parent c642b69849
commit 4cd62d3627
28 files changed
+2387 -5

No files matched your search

@@ -0,0 +1,60 @@
# DEFAULT source recovery through a mapped analysis carrier
2026-11-06. This closes a provider function-boundary gap, not the Carl return
behavior gate. No gameplay change follows from this result.
The original PE database did not recognize447CF0 as a function. Instead of
repeating that failed selector, `tools/binary/default_raw_carrier.py` maps the
verified EXE's initialized sections from VA447CF0 onward into a separate raw
analysis file. It retains the original virtual spacing and zero-fills virtual
tails/gaps. `mapping.json` identifies every source file range and carrier offset.
This file is static analysis input; it is neither an executable nor a captured
process image. Imports, earlier code and runtime-initialized state are not supplied.
Source EXE SHA256:
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Carrier SHA256:
`a5bf4114beaf23fcaaf608e042a5873ff353ab4fa1189ba6b7466ed55fe91b99`.
The regenerated carrier is byte-identical to the analyzed file.
REA/Ghidra12.1.4 successfully decompiled entry447CF0 using this changed input.
Evidence:
`ev_58ecada52eaf5028945af6330fc9721a6a085495dbfd8ffdbb665a1fcad27420`.
Complete result, provider snapshot, mapping and stderr remain local under
`artifacts/jimmy-skip-raw-default/`. The Evidence subject is the carrier hash,
not the EXE hash. The existing original-instruction guard independently binds
the relevant instructions to EXE offsets447CF0−400000 and onward.
## Recovered behavior and limits
The complete decompilation agrees with the guarded original instructions:
- `none` returns; named triggers resolve and dispatch according to concrete type.
- DEFAULT447D34..447FC5 resolves JIM1. If JIM1 already owns raw control, its early
branch447D5C..447D9A loads sound effects, clears the applicable actor flag and
shared skip, and returns. It does not execute the later owner/camera/music branch.
- Otherwise it selects the appropriate Jimmy/vehicle owner, grants through118,
conditionally snaps the shared camera eye when distance exceeds1000, and handles
sound/music/UI/shared state. The SCENE30 menu callback is a separate conditional.
- No direct Jimmy mode704/turn614/current-or-destination-Euler reset appears in
DEFAULT. A raw owner grant is still475A40's pointer store, not actor Init.
Carl's MCA completion names JIM1 before dispatching Carlwalk→DEFAULT, making the
already-owned early branch relevant. This result supplies no hidden reset to
explain the user's upright original return. Indirect callees retain the coverage
and limits documented in the return-source report; pseudocode is a navigation aid,
and the original instructions remain authoritative.
## Reproduction
From GamePort, with the local REA/Ghidra environment:
```sh
python3 tools/binary/default_raw_carrier.py ../Original --output artifacts/default-recovery
scripts/rea.sh decompile artifacts/default-recovery/default.bin 0x447cf0 \
--provider ghidra --target-format raw-binary --architecture x86 \
--entry-point 0x447cf0 --snapshot artifacts/default-recovery/snapshot.json \
--format json --full-output > artifacts/default-recovery/result.json
```
No original code was executed by this analysis and no original files were changed.