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

5.6 KiB

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.

2026-11-06 continuation: integrated lifecycle trace records292 additional bounded original-code cases and complete DEFAULT recovery. Known original components reproduce the port's order-sensitive first stale writer; contact/task/STOP/ordinary animation paths supply no new reset. A copied-original read-only observer is implemented and its Wine32 attach path verified. Local original rendering still supplies no Jimmy/Carl gameplay trace. The source gate remains open; preserving exact original behavior takes precedence over forcing the diagnostic upright with an unsupported reset.

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: 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: 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: 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.