Files
Neutron/docs/gameplay/jimmy-cutscene-decompilation.md
T

81 lines
5.0 KiB
Markdown

# Focused decompilation checkpoint: cutscene lifecycle
2026-11-05. User redirects work toward understanding the original before further
implementation. Preserve runtime baseline a2e89c6 and packaged runtime dae13ac.
No src/, regression test, build script, original or packaged binary changes are
part of this checkpoint. New work is read-only diagnostics and source findings.
## Confirmed requirement and corrected coverage
User comparison confirms ordinary landing can leave Jimmy banked in the original.
The reported port-only failure is specifically after **skipping Carl's lab
conversation**: Jimmy must remain upright when control returns, including idle.
The earlier correction proved camera-entry current/destination flattening and
locked continuation. It did not prove resumed **neutral** input stays upright.
Its held movement/jump resumption check cannot certify that missing boundary.
The post-skip bug is open; do not classify it as the original landing quirk.
## Findings this pass
- [48-case port trace](jimmy-cutscene-port-trace.md): all24 fresh-order cases
republish a stale air-bank target on the first neutral input; all24 retained-
order cases remain upright. The player is grounded by return. This isolates
the first port writer, not a source-justified fix.
- [Original return/skip boundaries](jimmy-cutscene-return-source.md): raw control
grants, DEFAULT and no-selection cleanup do not supply the hypothesized mode/
turn reset. Original skip does write Jimmy's shared input latch and a global
skip flag, with per-camera completion/resource behavior absent from the port's
immediate fast-forward model. Its causal role in upright return is unproven.
- [Source chain and registration order](jimmy-cutscene-chain-order.md): the actual
GAM chain is neutron1a→Carlwalk→default. AI trigger contact can dispatch during
physics; Carl contact first sets state, with conversation activation in his
later actor update. The port's post-player contact grouping is an approximation.
- Three fresh REA/Ghidra pseudocode results and the existing full instruction
Evidence corroborate the focused source contracts. DEFAULT's unrecognized
procedure remains an explicit provider gap; assembly/byte guards support the
bounded statements. Complete Evidence is retained locally and sessions closed.
These findings improve the interaction model. They do not establish that the
original enters/ends the scene with the same support/mode/turn values as the port.
No additional rotation reset or blanket ordering switch is implemented.
## Recovery gate before implementation
1. Trace the original Carl route from physical enter to talk activation, then
accepted Escape/Space skip, completion/DEFAULT and the first idle callbacks.
Record support, raw owner, current/destination Euler, dirty, movement mode,
turn, shared skip, action latch and relevant input suppression at each boundary.
2. Close source actor/input ordering for the observed fresh and retained route,
including deferred callbacks and contact/support eligibility. Explain where
the source avoids the demonstrated first stale write. A local no-reset finding
or a synthetic component outcome does not substitute for that explanation.
3. Compare a bounded original composition/runtime trace with the reproducible
port failure. Keep original instructions, inference and user observation
separate. Cover skip and natural end independently; user observation here
specifically concerns skip.
4. Implement only the directly supported missing owner/transition/order after
this gate closes. Verify first idle frame and sustained idle after skip in
both orders, held-input resumption, normal landing bank, and existing scene/
body/fire behavior. Preserve original state rather than clamping every frame.
This is a focused investigation pass, not a requirement to decompile every
level before resuming implementation. Broader movement/contact/animation recovery
continues after its state and verification boundaries are made explicit.
## Verification and remaining work
The source guards for return and chain complete against the original identity;
the managed diagnostic compiles and records48 port cases. Its sources and traces
have SHA256 provenance under artifacts/jimmy-cutscene-return/port-trace/.
Original hashes and production-source identity are verified before publishing
this research checkpoint. Existing packages remain the earlier baseline.
The original skip-to-idle causal explanation remains unresolved; no full original
frame or new native Windows parity is claimed.
Final checkpoint verification: chain guard passes6 direct calls,11 instruction
sites,6 virtual slots,11 ranges and8 actual GAM records; return guard passes12
sites,12 slots and13 ranges. The48-case diagnostic's recorded source/output
hashes match.539 original files remain unchanged. A diff against a2e89c6 confirms
no changes under src/, tests/ or scripts/. These checks do not certify the missing
original skip-to-idle frame; that remains the next source-recovery task.