Preserve retained Jimmy update order on initial story entry

This commit is contained in:
UnixNight committed 2026-11-06 17:08:59 -05:00
1 parent 4cd62d3627
commit ea04210f52
24 files changed
+1209 -22

No files matched your search

+51
View File
@@ -0,0 +1,51 @@
# 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
```