52 lines
3.4 KiB
Markdown
52 lines
3.4 KiB
Markdown
# Derived Jimmy frame around the controller
|
||
|
||
2026-11-06. This closes a caller-level omission in the earlier component
|
||
composition; the lifecycle correction is separately established by
|
||
[menu/player lifetime](main-menu-player-lifetime.md).
|
||
|
||
Canonical EXE SHA256f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8;
|
||
retained REA instruction Evidence
|
||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
|
||
The guard verifies14 source sites,21 virtual bindings,15 ranges and the actual
|
||
controller call. Text file offsets below equal preferred VA−400000; the helper
|
||
PE-maps them independently.
|
||
|
||
| Source boundary | Recovered ownership |
|
||
|---|---|
|
||
|424600..424D10 /24600..24D10|Actual Jimmy game3C4 caller. Null raw control closes/hides helper UI and stops sound handles. It does not itself clear movement mode or stored turn.|
|
||
|424721..424751|If the menu exists and shared4F8181 is set, poll menu4A8→403A10. State2 calls menu460; both state2 and other states return before the controller. This lock is distinct from raw ownership.|
|
||
|424767 complete208→424D10|Objective/UI helper before the controller. The separate objective presentation does not set modal input gate4F8198; that explicit-modal opener is406F90. See objective-timing.md.|
|
||
|424BFC complete1A4→425170|Upward world query/velocity handling. Its falling callback425120 maintains mode1; it is not a grounded resume reset.|
|
||
|424C08 complete1A8→4252E0|Downward/shadow-distance query and own helper state.|
|
||
|424C2B complete194→42AAC0|Airborne sound cleanup.|
|
||
|424C34→437940|Actual ordinary player wrapper. The source ownership/support/input-order conclusions remain here.|
|
||
|424C3F complete1C8→424E80|Invisible upkeep, with its own mode gate and ordinary non-Invisible return.|
|
||
|424C88 complete1B4→4255C0|Impact/material helper; world-hit dependencies remain separate.|
|
||
|424C94 complete1B0→425490|History/position correction. Calls game314→472360 Vec4 **root** setter; this is not an Euler setter.|
|
||
|
||
`jimmy_derived_frame_probe.c` executes the complete derived caller and ordinary
|
||
helpers on private copied source.437940 is a recording adapter, upward/downward
|
||
world queries return no hit, and menu/resource/visibility transports are explicit
|
||
adapters. Thus these cases test what the caller changes outside its controller,
|
||
not another execution of the controller/body/whole game.
|
||
|
||
All50 cases pass:48 combinations of raw ownerNULL/Jimmy/other, menu lock0/1,
|
||
menu state1/2, supported0/1 and rising0/1, plus two180-tick unlocked intervals.
|
||
The caller dispatches the controller only while the menu lock is clear; raw
|
||
ownership is passed onward rather than becoming another caller-side gate.
|
||
Mode1, turn11.666668 and distinct current/destination Euler stay unchanged outside
|
||
the recorded controller. Queries and menu-close callbacks have checked counts.
|
||
|
||
Artifacts: `artifacts/jimmy-derived-frame/native-observations.json` binds generated
|
||
source, executable, source contracts, original identity, capture metadata and log
|
||
hashes; capture wineExit0 and `JIMMY_DERIVED_FRAME_COMPLETE` are required. Primary
|
||
integration reran the parser/guards and verified all50 cases. No full body/world
|
||
hits, OMT playback, native Windows or actual original Carl frame is claimed.
|
||
|
||
```sh
|
||
python3 tools/binary/jimmy_derived_frame.py ../Original \
|
||
--output artifacts/jimmy-derived-frame/build \
|
||
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||
--capture artifacts/jimmy-derived-frame/probe
|
||
```
|