Trace Carl lifecycle and add read-only original state observer
This commit is contained in:
1 parent
c642b69849
commit
4cd62d3627
28 files changed
+2387
-5
No files matched your search
@@ -0,0 +1,148 @@
|
||||
# Jimmy base, animation completion and STOP during cutscene return
|
||||
|
||||
2026-11-06. Bounded original-code investigation of the dependencies omitted by
|
||||
[the skip composition](jimmy-skip-composition.md). No runtime change or new
|
||||
rotation reset is justified by these results.
|
||||
|
||||
## Identity and evidence
|
||||
|
||||
Original Neutron.exe SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Retained complete REA instruction Evidence
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`
|
||||
is reused and its subject hash verified. The helper verifies original identity,
|
||||
virtual bindings and PE-maps the source ranges. Addresses below are preferred
|
||||
EXE VAs; the listed text file offsets equal VA minus400000.
|
||||
|
||||
JN-Engine's C3DAnimated/C3DPlayer/C3DJimmy reports supplied indexing leads.
|
||||
The conclusions here come from authoritative bytes, retained REA instructions
|
||||
and the bounded native execution, rather than its reconstructed movement.
|
||||
|
||||
## Recovered base/update contract
|
||||
|
||||
| Boundary / VA / file offset | Original ownership and effects |
|
||||
|---|---|
|
||||
|Jimmy424600..424D10 /24600..24D10|The ordinary derived frame callback eventually invokes437940 at424C34. Its null-control prelude handles helpers/menu/sound; the inspected function contains no direct mode704/turn614 reset. It also calls other Jimmy helpers; this is not a full execution proof of that frame.|
|
||||
|43796A→40E050 /3796A→E050|Player wrapper invokes animated base **before** its raw-owner identity gate437A1B. Base behavior therefore remains relevant while raw control is null.|
|
||||
|40E050..40E1C8 /E050..E1C8|Global readiness gate; one-time pickup-link work; common object update462520; optional authored-transform pin when game58C CanMove==0; animation clock/completion check. No direct movement-mode/turn reset. Actual lab JIM1 CanMove is1, as the earlier supplied-GAM investigation records.|
|
||||
|462520..462649 /62520..62649|Optional body-context/current-root bridge, then458930→473240. A missing body context skips the former bridge but still reaches the common update.|
|
||||
|473240..473298 /73240..73298|Calls game3D4→4732B0 to maintain sound handles, expiration callback if its timer expires, then game3D8→43A420 facing.|
|
||||
|40E162..40E1C0 /E162..E1C0|Requires both game574/575 readiness bytes. Increments game4C4/complete584 clock. If completeAD play-loop is0 and game56C/complete62C record exists, current frame at least record48−1 calls complete104. There is no completion latch here.|
|
||||
|complete4A3BDC+104→43A900 /A3CE0→3A900|Actual Jimmy animation-ended callback. Tests current action through complete100→40DF80. STOP, ordinary talk and FALL do nothing in this callback.|
|
||||
|43A92E..43A9A9 /3A92E..3A9A9|FENCE/LADDER completion selects STOP, clears shared4F83E0 and special timer, invokes Stop, clears special movement fields, restores saved **position** through game314, and enables body state. No mode704/turn614 or Euler reset.|
|
||||
|43A9CA..43AA38 /3A9CA..3AA38|SPLAT/HIT completion selects STOP; HIT additionally clears shared4F83E0/special timer. This is not an ordinary scene-return rotation reset.|
|
||||
|
||||
The optional body-context bridge in462520 has not been exercised with a real
|
||||
world/body here. Its current-root writes and any level callback side effects
|
||||
remain a separate boundary; a null synthetic context must not establish their
|
||||
absence in the whole original.
|
||||
|
||||
## STOP is two different entry paths
|
||||
|
||||
Script preparation's game410→42AFC0 is not the same entry as assigning a target
|
||||
deactivation animation through completeE0:
|
||||
|
||||
```
|
||||
game410 ->42AFC0
|
||||
->43A750: speed608=0, velocity XYZ via2C4->471F40, sound148->429A00
|
||||
->sound148->429A00 again
|
||||
->complete150->43AFF0("STOP"): action acceptance
|
||||
->completeE0->40DD90("STOP",1) if accepted
|
||||
|
||||
TargetDeactAnim STOP ->completeE0->40DD90("STOP",1) directly
|
||||
```
|
||||
|
||||
43AFF0 first rejects an unchanged current action and protected HIT/SPLAT/FENCE/
|
||||
LADDER/other special states; it then recognizes STOP at43B28A. Its accepted STOP
|
||||
branch stops sound, selects the animation and clears acceleration through
|
||||
game278. There is no mode/turn/Euler reset. A Stop call can therefore clear
|
||||
speed/velocity while its STOP animation request is rejected. Direct animation
|
||||
selection has a distinct acceptance boundary.
|
||||
|
||||
| Selection dependency / VA / file offset | Recovered effects and limits |
|
||||
|---|---|
|
||||
|40DD90..40DF7C /DD90..DF7C|Requires complete634/635. Resets local animation clock; may bind the selected shape, call completeC8 shape refresh and preserve scale; builds the resource key with HI/LOW prefix; finds the animation record; updates name/record; dispatches completeE4 with start frame/repeat and completeC0 with animation definition. No movement-mode/turn/Euler reset in this procedure.|
|
||||
|completeC8→462270 /62270..62331|Reads bound shape radius and bounds. Calls game110→471240, game2E8→472120 and game2E0→4720C0. The latter setters write game1D4/1C4 bounding vectors, not Euler or destination Euler.|
|
||||
|completeE4→40DA30 /DA30..DAAD|Calls morph subobject frame/repeat and pause methods, mirrors loop byte completeAD, selects frame metadata if present. No mode/turn/Euler reset.|
|
||||
|completeC0→47ED54 /7ED54|OMT animation-definition transport is represented by an explicit resource adapter in the probe. Full DLL animation playback is not executed.|
|
||||
|
||||
## Native observations
|
||||
|
||||
`tools/binary/jimmy_base_return.py` and `_probe.c` generate a private mapped-source
|
||||
probe; it runs in the existing network-isolated Wine32 copy environment.
|
||||
Original files are neither modified nor mounted in that execution namespace.
|
||||
The final run emits the required success marker and exits0. Post-capture Python
|
||||
assertions validate **140 finite cases**:
|
||||
|
||||
- **84 base cases:** seven action names STOP/TALK/FALL/HIT/SPLAT/FENCE/LADDER,
|
||||
three readiness states, loop0/1 and before/at-final-frame. Each runs180 actual
|
||||
base/common/facing updates. Both Euler vectors stay(0,155,0), movement mode1
|
||||
and stored turn11.666668 survive. Eligible non-loop completion is called180
|
||||
times. The action-selection adapter in this matrix records/copies the new
|
||||
action name without changing playback flags; repeated completion here is
|
||||
deliberately not a claim about the full selected animation's playback.
|
||||
- **56 STOP cases:** same seven initial actions, readiness off/on, record absent/
|
||||
present and game410 Stop versus direct completeE0 selection. These execute
|
||||
actual42AFC0,43A750,429A00,43AFF0,40DD90,40DA30 and462270 as applicable.
|
||||
STOP selection/frame/pause paths are checked, including protected-action
|
||||
rejection versus direct selection. Mode/turn and initially distinct Euler
|
||||
vectors remain unchanged. Non-direct Stop clears speed and velocity.
|
||||
After an **explicit synthetic upright seed**, another180 actual base updates
|
||||
retain upright vectors and the old mode/turn. Successful real STOP selection
|
||||
sets loop1, so this interval has no animation-ended callback.
|
||||
|
||||
Base cases execute the actual462520 chain with a synthetic null body-context
|
||||
pointer. The pickup link is marked checked, CanMove is1, sound handles invalid,
|
||||
timer0 and facing dirty0. Resource lookup, shape/animation binding, shape bounds,
|
||||
morph current-frame/frame-set/pause transport and special Stop/restore/enable
|
||||
callbacks are explicit adapters. Actual action-name getter and string comparison
|
||||
semantics are used. These are original components on synthetic state, not actual
|
||||
Carl startup, body integration, registry scheduling, a full Jimmy frame, OMT
|
||||
playback/rendering or native Windows gameplay.
|
||||
|
||||
## Consequence and remaining question
|
||||
|
||||
The omitted base completion and accepted STOP request paths do not supply a
|
||||
hidden ordinary-mode or stored-turn reset in these bounded source cases. The
|
||||
successfully selected STOP loop also prevents a later completion callback from
|
||||
quietly repairing those fields. This strengthens the existing composition's
|
||||
retained-state interpretation; it still does not establish the actual original
|
||||
first resumed input order or entry state.
|
||||
|
||||
Preserve the evidence gate. The next comparison must identify a real divergence
|
||||
in entry/contact state, registry/frame placement, input eligibility or the
|
||||
remaining live body/derived-frame context before changing the port. A blanket
|
||||
rotation reset or switching all fresh sessions to retained ordering is not
|
||||
supported by this result.
|
||||
|
||||
## Artifacts and reproduction
|
||||
|
||||
- artifacts/jimmy-base-return/build/source.json: source ranges, PE offsets,
|
||||
hashes, virtual bindings and retained REA excerpts.
|
||||
- artifacts/jimmy-base-return/native-observations.json: all140 case records and
|
||||
source/probe/log/capture hashes.
|
||||
- probe/wine.log and probe/capture.json: final success marker and exit0.
|
||||
|
||||
```
|
||||
python3 tools/binary/jimmy_base_return.py ../Original \
|
||||
--output artifacts/jimmy-base-return/build \
|
||||
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json
|
||||
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wl,--image-base,0x10000000 \
|
||||
-I tools/binary artifacts/jimmy-base-return/build/jimmy_base_return_probe.c \
|
||||
-o artifacts/jimmy-base-return/build/probe.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/jimmy-base-return/build/probe.exe \
|
||||
--probe-success JIMMY_BASE_RETURN_COMPLETE --seconds 12 \
|
||||
--output artifacts/jimmy-base-return/probe
|
||||
python3 tools/binary/jimmy_base_return.py ../Original \
|
||||
--output artifacts/jimmy-base-return/build \
|
||||
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||||
--capture artifacts/jimmy-base-return/probe
|
||||
```
|
||||
|
||||
First-run prefix setup exceeded its initial capture interval; the initialized
|
||||
rerun established the84 base cases. The expanded resource adapter initially
|
||||
expected STOP instead of the source's HISTOP lookup; that harness assertion was
|
||||
corrected before the successful140-case capture. Source virtual bindings are
|
||||
checked before compilation. No failed harness/setup attempt is original gameplay
|
||||
evidence. No runtime/shared documentation edit or commit is made by this agent.
|
||||
@@ -0,0 +1,84 @@
|
||||
# Carl contact and conversation entry
|
||||
|
||||
2026-11-05. This investigation closes the local contact/admission boundary. It does **not** identify a source-supported fix for the bank returning after skipping Carl. Physical collision admission, the complete task callback graph, and the complete skip/resume frame remain separate boundaries.
|
||||
|
||||
## Evidence and reproduction
|
||||
|
||||
Original `Neutron.exe` SHA-256: `f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`. Retained REA disassembly: `artifacts/jimmy-movement-audit/rea-original-disassembly.json`, evidence `ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`. JN-Engine was used as an index; executable bytes and actual GAM fields establish the statements below.
|
||||
|
||||
Read-only guard/generator: `tools/binary/jimmy_carl_entry.py`. It checks the executable identity, direct calls, virtual bindings and instruction sites, records original file offsets/range hashes, and can retain bounded REA extracts. All addresses here are preferred-base VAs. For the cited executable text/data sites, raw file offset is VA minus `0x400000`; the helper calculates offsets from PE sections rather than assuming this mapping.
|
||||
|
||||
```sh
|
||||
python3 tools/binary/jimmy_carl_entry.py ../Original \
|
||||
--rea-disassembly artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||||
--generate-probe artifacts/jimmy-carl-entry/native \
|
||||
> artifacts/jimmy-carl-entry/source.json
|
||||
i686-w64-mingw32-gcc -O0 -Wall -Wextra \
|
||||
-o artifacts/jimmy-carl-entry/native/probe.exe \
|
||||
artifacts/jimmy-carl-entry/native/jimmy_carl_entry_probe.c
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/jimmy-carl-entry/native/probe.exe \
|
||||
--probe-success JIMMY_CARL_ENTRY_COMPLETE --seconds 12 \
|
||||
--output artifacts/jimmy-carl-entry/probe
|
||||
```
|
||||
|
||||
The generator compiled without warnings. The copied-original component ran under Wine in the existing network-disabled namespace, with `Original/` unmounted. `artifacts/jimmy-carl-entry/probe/wine.log` reports 96 passing cases and `JIMMY_CARL_ENTRY_COMPLETE`; `capture.json` records exit 0. This is **isolated original component execution**, not native Windows/full original gameplay verification. Originals were not executed in place or changed.
|
||||
|
||||
## Recovered contact and talk ownership
|
||||
|
||||
Carl's game interface is complete-object `+0xC0`. Its game vtable `0x495364` binds contact slot `0x40` to `0x40A3C0`, ordinary actor update `0x3C4` to `0x41B950`, and velocity preparation `0x410` to `0x40A6B0`. Its complete vtable `0x495804` binds state setter `0x124` to `0x4089B0`, talk `0x140` to `0x41B7B0`, trigger resolution `0x17C` to `0x41BB20`, and progress callback `0x180` to `0x413E50`.
|
||||
|
||||
| Boundary | Original evidence | State and dependencies |
|
||||
|---|---|---|
|
||||
| Physical notification gates | `47A46E/47A48F`, `47A4AA/47A4BD` | Both actors' game220 bind471A30 (own byte140 collision-enable); both game3A0 bind472F80 (`mov al,1; ret4`). Thus these pair-permission callbacks contain no raw-control, current-action or support admission check. Game178 on both binds471720 (own collision-kind124); kind2 selects47A5E0, otherwise47B3E0. Geometry/actual values remain a separate boundary. |
|
||||
| Contact prelude | `40A3CD→470A90` | Own slot `3C→470A60` checks duplicate membership in own contact list. Own deletion byte `+6` can suppress list append. Appends contacted pointer to own `+260` list and increments `+264`. Own `+408` may receive current-game callback `144`; lab complete table `4C3CD0+144→475D40` is exactly `or eax,-1; ret8`, with no actor side effects. |
|
||||
| Target admission | `40A44C..40A460` | Reads **Carl game+600** target; requires non-null and exact identity with incoming contacted game pointer. This is not a raw-controlled-pointer requirement. |
|
||||
| Talk-ready transition | `40A676..40A693` | Requires **Carl game+608 == 6**; invokes **Carl complete slot124(0)**. No support getter, Jimmy mode/turn write, target velocity/root/Euler store, distance threshold, or vertical threshold occurs in this branch. |
|
||||
| State ownership | `4089E5..408A04` | Setter copies own complete `+6C8` to `+6CC`, then writes requested state to `+6C8` (game+608). Complete byte `+970` can suppress state0/6 assignment. State0 tail `408B44..408B90` prepares/animates the NPC if its own flags permit it. |
|
||||
| AI before talk | `41B95D→408000`; `41B972..41B988` | Friend update runs inherited AI, increments own timer, then reads **resulting own AI state**. State0 dispatches complete140. It is not a test for a null target pointer. |
|
||||
| AI state0 dependencies | `408438..4084FC` | Reads target's **game+49D** targetability/invisibility flag at `40847C`; uses own facing/AI helpers and own distance/range data; can restore own state6/2. This is not Jimmy's support flag. The inherited update includes gates and indirect own AI callbacks; the native probe below does not execute this whole update. |
|
||||
| Conversation trigger selection | `41BB20..41BC1F` | Up to five named trigger lookups through `474070`; TalkState must not be `-1` and must equal own complete+554 task state or wildcard `-2`. No Jimmy support query. |
|
||||
| Progress before activation | `41B7CD→Carl413E50→41B810` | Base awards score100 through `42ADC0`, then invokes **Carl game410→40A6B0**, which sets **Carl velocity** to zero through own game2C4. It does not prepare Jimmy. Carl then advances `SCENE50→60` (other paths65→70,270→280) through `45F990`. Task notifications remain a separate dependency. |
|
||||
| Synchronous camera activation | `41B7D3..41B7D8` | Invokes resolved trigger's game slot5C with that trigger as argument. Only after it returns, `41B7DD..41B7FA` increments NPC talk counter, clears own elapsed timer, sets own AIstate9, and stops own animation. |
|
||||
| Jimmy counterpart contact | game table `4A373C+40→422D30`; `422D50→470A90` | Jimmy also receives a contact callback. Its subsequent concrete-type ladder tests pendulum, vehicles, projectile/enemy classes, button, AIT and load-level. It has no Carl/friends/AI generic test. Carl matches none of those concrete classes, so the C3DLOADLEVEL false branch `4232D0→423563` finishes without mode/turn/Euler preparation. This is static path analysis, not execution of the counterpart in the finite probe. |
|
||||
|
||||
The optional marker logic earlier in contact (`40A3E7..40A44C`, own game+8CD) has raw-controlled/Goddard identity handling and NPC marker/animation writes. It is separate from the state6 exact-target admission branch and supplies no Jimmy grounding gate. The state4 branch transforms relative positions/directions into **NPC-owned** fields; state6 does not execute it.
|
||||
|
||||
Actual `level1b.gam`, SHA-256 `316fff40db565c2add5b07cbccdef640ddb67c64d6625fea1429ce2a0542a234`, binds Carl at raw `0x1455` to target `Jim1`, TaskName `SCENE`, initial AIState9, and TalkState0=50/TalkTrigger0=`neutron1a`. Jimmy at raw `0x8` has TaskName `none`, RequiredLevel0, ExactLevel/RemoveLevel `-1`. `neutron1a` MCA at raw `0xE0B` names PlayerControlled=`JIM1`, NextTrigger=`carlwalk`. Carlwalk AIT at raw `0x1AFD` targets `C3DCARL`, sets AIState3 and chains `default`; it does not change Jimmy root/yaw. The helper retains these actual entity fields and entity file offsets.
|
||||
|
||||
## Finite component result
|
||||
|
||||
`jimmy_carl_entry_probe.c` executes complete original contact `40A3C0`, base `470A90`, actual duplicate-list predicate `470A60`, state setter `4089B0` and lab callback `475D40`. It uses synthetic complete objects/vtables, a native allocator adapter, a false-returning incoming type-query adapter, and NPC animation/preparation adapters. Original constructors, dynamic collision admission, AI update, task callbacks, trigger resolution, camera activation and skip are outside the probe.
|
||||
|
||||
Across 96 combinations of incoming target identity, own AIState6/3, raw-controlled identity, Jimmy mode0/1, Jimmy turn `-12/0/+12`, and synthetic support0/1:
|
||||
|
||||
- Actual base contact appends one contact node.
|
||||
- Own state becomes0 exactly when contacted target matches and own state was6.
|
||||
- Own state0 idle preparation/animation callbacks occur in those cases.
|
||||
- The entire `0x1F00`-byte synthetic Jimmy object remains unchanged, including mode, turn, bank and Euler destination.
|
||||
- Jimmy support virtual218 is never queried. The synthetic support value is a callback experiment, not a claim about a recovered physical-support field.
|
||||
|
||||
This confirms the local source reading: adding a grounded-only Carl-talk gate or resetting Jimmy mode/turn in the contact callback has no support in this recovered boundary. It does **not** prove the physical pair engine admits every airborne trajectory or that the full conversation activation frame leaves Jimmy unchanged; camera activation itself has its recovered orientation suffix.
|
||||
|
||||
## Startup/reuse hypothesis audit
|
||||
|
||||
A proposed explanation for the original/port difference was that original New Game might preload the lab behind the main menu, leaving a reusable Jimmy before the first playable lab controller. The inspected startup gives no positive support for that explanation:
|
||||
|
||||
| Source chain | Observation |
|
||||
|---|---|
|
||||
| `46A641→46B160`; `46A654` | Constructs application and stores global509980. |
|
||||
| `46A65B` pushes MAIN; `46A660→46A310→46A33D/44D0E0` | Startup selects a constructed MAIN controller. |
|
||||
| `44D122→459110→459168/44D2B0→44D306/4745A0` | Constructs CMainMenu using Jimmy-game/generic-game base constructors. Installs complete4D1070/game4D0C0C; class literal4F291C is `CMAINMENU`. This is not a level1b GAM load. |
|
||||
| `4591C3→4749A0→completeB4/44D3D0` | Menu InitGame clears task list through45F4C0, initializes world/camera defaults through474A10, sets own lifetime fields; no direct Jimmy constructor or lab request here. |
|
||||
| `44D139` app118→46F760; `44D149` app12C(3)→46F830 | Opens resource database and creates a 2D image from it, respectively. These bounded bodies do not load a lab or construct Jimmy. |
|
||||
| `404B4F..404B54` | Actual menu New Game item pushes string4EC71C (`NewGame.tsk`) and calls460E70. It then changes own menu/current-game state. |
|
||||
| `40D089..40D08E` | The other executable reference to NewGame.tsk is the script RESTARTGAME action. |
|
||||
| `45B1E2→422160` | Sole direct `C3DJimmy` constructor call in retained executable disassembly is inside the generic object factory. |
|
||||
|
||||
**Inference limit:** this is a positive constructor/initialization chain and a bounded negative result for preload. Menu-frame event/deferred-task behavior and any attract/demo route have not been exhaustively executed here. The result does not certify initial full registry order, and does not justify changing the port's fresh/retained ordering. Existing loader reuse facts remain valid when a prior Jimmy actually exists.
|
||||
|
||||
## Remaining questions and implementation comparison
|
||||
|
||||
The current port approximates contact using a broad sphere and starts Carl talk from its actor update after player processing. Original physical contact notifications occur through47A430 before ordinary registry updates; Carl's own talk then occurs from41B950 after its inherited AI update. Their relationship to Jimmy's update depends on actual registry order, collision state, and callback ownership; this report does not replace that schedule with a guessed global order.
|
||||
|
||||
Still unresolved: exact physical admission at the actual jumping contact; complete entry frame with task callbacks and source bodies; full MCA skip→Carlwalk→DEFAULT→first resumed input composition; and original first-play registry order at the user-observed case. No runtime implementation was changed by this investigation. Ordinary landing bank must remain until directly contradicted by evidence; contact preparation supplies no basis for a global upright clamp.
|
||||
@@ -5,6 +5,15 @@ 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](jimmy-cutscene-lifecycle.md)
|
||||
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.
|
||||
|
||||
@@ -0,0 +1,85 @@
|
||||
# Carl skip lifecycle: recovered boundaries and the remaining observation
|
||||
|
||||
2026-11-06. Execution of the accepted next-work plan, with the user's requirement
|
||||
to preserve original behavior exactly. Runtime a2e89c6 and packages dae13ac remain
|
||||
unchanged. This checkpoint adds evidence and observation tools, not a tilt fix.
|
||||
|
||||
## Event/state trace
|
||||
|
||||
Original source identity, PE offsets and REA Evidence are in the linked reports.
|
||||
These rows combine static facts and explicitly synthetic original-code execution;
|
||||
they are not a captured whole-original frame sequence.
|
||||
|
||||
| Boundary | Recovered state ownership | Evidence / remaining limit |
|
||||
|---|---|---|
|
||||
|Dynamic contact→Carl state0|Matching target and Carl state6 admit the talk-ready transition. Jimmy is not modified and support is not queried by that callback.|[Contact report](jimmy-carl-entry.md):96 native cases; actual physical trajectory/admission and whole AI update are separate.|
|
||||
|Carl talk→SCENE50→60→neutron1a|Task assignment/broadcast precedes the synchronous camera trigger. Jimmy's authored TaskName is `none`. All89 authored SCENE listeners across17 kinds are inventoried; six callback paths do not supply another Jimmy movement reset.|[Task report](jimmy-task-return.md): static callback closure and48 native dispatcher/objective cases; actor callbacks in that probe are adapters.|
|
||||
|MCA initial preparation|StopMotion clears speed/velocity independently of STOP animation acceptance. Both current and destination Euler become(0,currentYaw,0); dirty is preserved. Raw control is removed.|Earlier20 camera-entry cases; [full STOP/base report](jimmy-base-return.md) supplies the omitted selection/completion dependencies.|
|
||||
|Uncontrolled interval|Known controller ownership gate retains mode1/stored turn. Actual base/facing and ordinary STOP/talk/FALL completion provide no reset. Playback/resource state is distinct from movement mode.|140 native base/STOP cases. Full body context, complete Jimmy frame and OMT playback remain outside these probes.|
|
||||
|Accepted skip|Original sets Jimmy action/menu latch complete1E00 and shared skip4F83E4; stops sound, deactivates current actor/animation and invokes completion.|[Return source](jimmy-cutscene-return-source.md); actual skip prefix is executed by the composition. The complete skip frame is not.|
|
||||
|MCA completion→Carlwalk→DEFAULT|Completion grants named JIM1; Carlwalk changes Carl's AI. DEFAULT's already-owned early branch clears shared skip/resources, with no new Jimmy reset.|[Complete DEFAULT recovery](jimmy-default-decompilation.md) closes the previous provider-boundary gap using an explicitly mapped static carrier.|
|
||||
|First resumed callback|On synthetic supported/released state, input-before-player republishes stale roll before the controller clears mode/turn. Player-before-input clears those fields first and stays upright.|[Composition](jimmy-skip-composition.md):8 actual original-component cases agree with48 port traces. This does not establish the original route's actual entry state/order/delta.|
|
||||
|
||||
At the problematic composed boundary the seed is mode1, turn±11.666668,
|
||||
current/destination(0,155,0), supported=true and dt1/60. Fresh input reduces turn
|
||||
to±10.000001 and publishes the opposite roll. The next controller clears mode
|
||||
and turn; neutral ground input then retains the banked destination. Skip-prefix
|
||||
latch writes do not change this result. These values are measured synthetic
|
||||
component inputs/results, not values measured from the original Carl route.
|
||||
|
||||
## What this permits and what remains unresolved
|
||||
|
||||
The first stale port writer is known. Its arithmetic also occurs in the composed
|
||||
original routines, so adding a reset to raw control grant, DEFAULT, Carl contact,
|
||||
task broadcast or ordinary animation completion would lack source support.
|
||||
The user's observation that the original stays upright remains authoritative;
|
||||
the actual original state/order entering that first input is still missing.
|
||||
Normal landing bank must remain intact. No per-frame leveling, scheduler switch
|
||||
or input suppression has been introduced to make the diagnostic green.
|
||||
|
||||
The fresh-construction order is a conditional source fact, not a runtime trace
|
||||
of the user's route. Startup inspection constructs MAIN directly and supplies
|
||||
no positive lab-preload/reusable-Jimmy explanation. A new read-only observer can
|
||||
record real registry positions, raw ownership, mode, turn, current/destination
|
||||
Euler, dirty, cached support, viewport delta and input/skip flags. Its samples
|
||||
are non-atomic and cannot alone certify exact callback chronology.
|
||||
|
||||
## Runtime observation tool and local limit
|
||||
|
||||
[Original-state observer](original-state-observer.md) supports launch or attach
|
||||
to a verified generated game copy. It never writes actor memory or injects code.
|
||||
The attach path leaves the observed game running. Three exact executable profiles
|
||||
have24 independent instruction guards; the supplied HDnoCD variant has its own
|
||||
REA Evidence and global addresses, rather than assumed canonical equivalence.
|
||||
|
||||
The local Wine32 attach integration passes:928 parsed samples, source guards
|
||||
accepted, observer exit0, original still running after sampling. Provenance is
|
||||
`artifacts/original-state-observer/attach-runtime/observations.json`. The legacy
|
||||
window remains black; observed registry contains MAIN and no Jimmy, with viewport
|
||||
delta0. Focus/normal Return input and an isolated desktop also failed to reach a
|
||||
usable gameplay reference. Neither accepted input events nor MAIN's zero gameplay
|
||||
delta proves a menu selection or a whole-game timing fault. Native Windows and
|
||||
the actual Carl skip were not observed by this work.
|
||||
|
||||
To collect the missing comparison on native Windows, run a **copied** original,
|
||||
reach Carl, then attach for the banked entry/skip/neutral-return interval:
|
||||
|
||||
```text
|
||||
observer.exe --attach-copied-pid=1234 --seconds=60 > carl-original.jsonl
|
||||
```
|
||||
|
||||
Use the copied game's actual PID. Keep its path outside an `Original` directory;
|
||||
the tool checks the actual executable identity/path and refuses unsupported
|
||||
images. No automatic keys or close request are sent in attach mode. If the trace
|
||||
misses the first transition, a narrower callback-level observation is required;
|
||||
do not fill it with an inferred reset.
|
||||
|
||||
## Checkpoint status
|
||||
|
||||
292 new bounded original-code cases pass:96 contact,8 input/controller/skip-prefix
|
||||
composition,48 task/objective and140 base/STOP. They deliberately have different
|
||||
synthetic dependencies. The48 port diagnostic cases still describe the preserved
|
||||
failure, not successful gameplay. The mapped DEFAULT carrier regenerates exactly;
|
||||
539 original files remain unchanged. No src/tests/scripts or package change is
|
||||
part of this checkpoint. Steps1–2 of the next-work plan remain open at the actual
|
||||
original resumed-frame observation; step3's gameplay correction gate is not met.
|
||||
@@ -67,12 +67,18 @@ artifacts/jimmy-cutscene-return/rea-completion/. New successful pseudocode:
|
||||
|438A60 retained-mode input dispatch|ev_77ee22e6d49adc0c983af92ba74273faf5f4daf697ab520ea45d22b08bc11bcb|
|
||||
|42AE00 cleanup wrapper|ev_2ee50b10018363378445be32df38ab4f6b2125247b69485304867674d5d484da|
|
||||
|
||||
DEFAULT entry447CF0 did not resolve to a Ghidra procedure; the provider then
|
||||
DEFAULT entry447CF0 did not resolve to a Ghidra procedure in the original PE database; the provider then
|
||||
reported the numeric selector as an unmapped file offset. Its complete error is
|
||||
retained as00.json; no pseudocode is attributed to it. The guarded retained REA
|
||||
instructions support the DEFAULT statements above. No unchanged retry or claim
|
||||
that the whole original was executed follows from that provider result.
|
||||
|
||||
2026-11-06: a changed input strategy now supplies complete DEFAULT pseudocode
|
||||
through a separately mapped static raw carrier. Its Evidence subject and mapping
|
||||
are explicit in [the DEFAULT recovery report](jimmy-default-decompilation.md).
|
||||
The original PE function-boundary failure remains recorded; the carrier result
|
||||
agrees with the guarded instructions and supplies no additional Jimmy reset.
|
||||
|
||||
## Port cause versus original explanation
|
||||
|
||||
[The port diagnostic](jimmy-cutscene-port-trace.md) reproduces48 cases. On fresh
|
||||
|
||||
@@ -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.
|
||||
@@ -0,0 +1,126 @@
|
||||
# Original input/controller composition after scene return
|
||||
|
||||
2026-11-05. Independent bounded original-code execution for the accepted next-work
|
||||
plan. This addresses whether the port's fresh-versus-retained distinction is an
|
||||
invented implementation artifact or also exists in the known original components.
|
||||
It does not execute original startup, complete Carl activation or all skip logic.
|
||||
|
||||
## Source identity and recovery
|
||||
|
||||
Original Neutron.exe SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
REA complete instruction Evidence
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`
|
||||
provides the bounded source instruction context. The generator verifies that
|
||||
Evidence's subject identity, verifies the authoritative EXE hash, PE-maps every
|
||||
copied range and records source range hashes. Originals are never modified or
|
||||
executed in place. The generated probe runs under the existing isolated Wine32
|
||||
asset-probe boundary, with no network or original-directory mount.
|
||||
|
||||
## Executed source and synthetic boundary
|
||||
|
||||
| Original VA / raw file offset | Executed role |
|
||||
|---|---|
|
||||
|431518..431590 /31518..31590|Initial MCA current/destination flatten suffix; actual328→4723F0 and32C→472450 leaves.|
|
||||
|430F1D..430F5C /30F1D..30F5C|Accepted skip's JIM1 lookup, complete1E00 latch, shared4F83E4 set and audio-stop prefix. Lookup/audio transport are recorded shims; target cleanup and completion are outside this prefix.|
|
||||
|475A40..475A4C /75A40..75A4C|Actual raw control-pointer grant and removal. Shared skip is explicitly cleared to represent the already-verified DEFAULT field effect; complete DEFAULT is not executed.|
|
||||
|438A60..438BA2 /38A60..38BA2|Actual retained-mode dispatch. Its absolute jump-table operand and four table entries are relocated into the private source image.|
|
||||
|439900..439E33 /39900..39E33|Actual keyboard/zero-mouse ordinary air input through the real36C→472660 destination writer. The camera tail is replaced by the proper source-function epilogue.|
|
||||
|437940..437C3A /37940..37C3A|Actual player wrapper including control identity, jump/support dispatch, mode/turn reset and publication. Its40E050 base call is replaced only by actual43A420 facing; unrelated base resource/animation behavior is not simulated.|
|
||||
|43A420..43A5CD /3A420..3A5CD|Actual facing, actual334→458F90→472480 Euler-add chain; global ready gate forced true.|
|
||||
|429910..429963 /29910..29963|Actual landing effect/menu helper with synthetic menu488/noop and invalid sound handle. It does not change mode/turn/Euler.|
|
||||
|43915D..4395CF /3951D..395CF|Actual neutral ground keyboard suffix after the wrapper has selected mode0; ground camera/device prefix omitted.|
|
||||
|
||||
The actor is synthetic, supported=true, jump-held=false, ordinary raw gadget-1,
|
||||
zero mouse/analog/keyboard and initial speed0. Complete/game vtables are explicit.
|
||||
Ground/air motion apply and animation actions are recorded no-op resource shims;
|
||||
the known mode/turn writes and facing/input arithmetic execute from original code.
|
||||
The current-action helper represents STOP versus RUN inequality. There is no body,
|
||||
world collision, registry, full derived Jimmy input callback426030, animation engine,
|
||||
renderer, complete MCA update/completion, original startup or full-game execution.
|
||||
|
||||
The initial state deliberately models the problematic boundary: retained movement
|
||||
mode1 and stored turn±11.666668, with both current/destination flattened to
|
||||
(0,155,0). After180 uncontrolled player wrappers, those vectors remain upright
|
||||
and mode/turn survive. The composition then grants control and orders input/player
|
||||
callbacks either fresh-input-first or retained-player-first, followed by300 idle
|
||||
callbacks. Each order is run with and without the original skip-prefix writes,
|
||||
and with both turn signs: eight finite cases.
|
||||
|
||||
## Observed results
|
||||
|
||||
All8 cases complete with the required marker and capture wineExit0. Finite
|
||||
post-capture assertions validate the boundary values below.
|
||||
|
||||
| Order | Skip prefix | First resumed effect | After300 idle callbacks |
|
||||
|---|---|---|---|
|
||||
|Input before player|Off or on|Air input decays turn±11.666668 to±10.000001 and writes target roll∓10.000001. Actual player wrapper then clears mode/turn, after facing has consumed the bad target.|Four cases retain approximately±10° bank.|
|
||||
|Player before input|Off or on|Actual supported/released player wrapper clears mode1/turn before input. Mode0 neutral ground suffix preserves upright target.|Four cases stay exactly upright.|
|
||||
|
||||
Representative positive-turn fresh result is bit-for-print equivalent to the
|
||||
existing managed diagnostic: first target roll-10.000001; first player current
|
||||
roll360, mode0/turn0; idle current roll350.000183. Negative-turn result converges
|
||||
to9.99999523. This is original code reproducing the same component composition,
|
||||
not proof that this fresh composition is the normal original playable lifecycle.
|
||||
|
||||
With skip enabled, the prefix sets both latch and shared skip to1 and records
|
||||
one stopped sound; mode and turn remain unchanged. Those writes alone therefore
|
||||
do not erase the first stale target in this composition. Their full menu/input
|
||||
consumer and caller timing remain separate questions.
|
||||
|
||||
## Consequences and unresolved original behavior
|
||||
|
||||
The known controller/input contracts agree with the port's first-writer trace;
|
||||
there is no new source evidence for adding a rotation or turn reset at raw grant.
|
||||
The critical question is which callback order and entry state actual original
|
||||
startup and the reported Carl route establish. A fresh allocation partial-order
|
||||
proof must not be substituted for normal New Game execution: original startup/
|
||||
menu/loading may already have created a retained Jimmy before the first playable
|
||||
lab. Proving that chain would explain upright return without an invented reset.
|
||||
This investigation does not independently establish that startup chain.
|
||||
|
||||
Follow-up2026-11-06: [Carl/startup audit](jimmy-carl-entry.md) positively traces
|
||||
MAIN construction and supplies no lab-preload/Jimmy construction in that bounded
|
||||
chain. The new observer also sees only MAIN before the unusable black-screen
|
||||
boundary. Neither result supports switching all fresh scenes to retained order.
|
||||
The broader [lifecycle trace](jimmy-cutscene-lifecycle.md) keeps actual original
|
||||
Carl entry state/order/delta unresolved instead of adopting the preload hypothesis.
|
||||
|
||||
One additional inspected base branch is not a reset justification:40E050 pins
|
||||
current transform to authored transform when game58C CanMove==0, but actual
|
||||
lab JIM1 has serialized CanMove1. Other base resources/callbacks remain omitted
|
||||
from the composition and must be tracked if startup/order does not explain the
|
||||
user's whole-original observation.
|
||||
|
||||
## Artifacts and reproduction
|
||||
|
||||
- tools/binary/jimmy_skip_composition.py and _probe.c: read-only source guards,
|
||||
relocation generator and bounded synthetic composition.
|
||||
- artifacts/jimmy-skip-composition/build/source.json: ten original range hashes,
|
||||
PE offsets and relocation operands.
|
||||
- artifacts/jimmy-skip-composition/native-observations.json: all eight cases,
|
||||
per-boundary fields and source/harness/executable/log/capture provenance hashes.
|
||||
- probe/wine.log and probe/capture.json: successful marker and wineExit0.
|
||||
|
||||
From GamePort:
|
||||
|
||||
```
|
||||
python3 tools/binary/jimmy_skip_composition.py ../Original \
|
||||
--output artifacts/jimmy-skip-composition/build \
|
||||
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json
|
||||
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wl,--image-base,0x10000000 \
|
||||
-I tools/binary artifacts/jimmy-skip-composition/build/jimmy_skip_composition_probe.c \
|
||||
-o artifacts/jimmy-skip-composition/build/probe.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/jimmy-skip-composition/build/probe.exe \
|
||||
--probe-success JIMMY_SKIP_COMPOSITION_COMPLETE --seconds 12 \
|
||||
--output artifacts/jimmy-skip-composition/probe
|
||||
```
|
||||
|
||||
Harness corrections preceded the successful run: initial Wine prefix creation
|
||||
outlasted its first capture, the absolute dispatch jump table needed relocation,
|
||||
and the skip-prefix exit initially preceded its cdecl argument cleanup. These
|
||||
failures were probe construction gaps, not original gameplay observations.
|
||||
The final compiled probe has no warnings; only the final success marker/exit and
|
||||
validated eight-case outputs establish the observations. No production/runtime/
|
||||
regression-test/build-script change or commit is made by this investigator.
|
||||
@@ -0,0 +1,153 @@
|
||||
# SCENE60 task broadcast and Jimmy's retained bank
|
||||
|
||||
2026-11-06. This investigation covers the task broadcast that Carl's talk
|
||||
progress runs **before** `neutron1a` activation. It provides no source-supported
|
||||
Jimmy movement reset and does not close the whole original skip-to-idle frame.
|
||||
No runtime, test, build-script or package change is made here.
|
||||
|
||||
## Identity and evidence
|
||||
|
||||
Authoritative `Neutron.exe` SHA256:
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Retained REA complete instruction Evidence:
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
|
||||
The helper validates that Evidence's subject hash, the authoritative binary,
|
||||
PE-mapped source sites, direct calls, tables and actual GAM records. Addresses
|
||||
below are preferred VAs; the listed text file offsets equal VA minus400000,
|
||||
independently checked through PE sections.
|
||||
|
||||
JN-Engine's `docs/decomp_ledger.csv` and `docs/gam_schema.md` supplied class/table
|
||||
leads only. All17 matching FourCC registrations, constructor game-table stores
|
||||
and game424 targets are verified against the supplied original. JN-Engine's
|
||||
movement implementation is not used.
|
||||
|
||||
## Assignment phases and direct Jimmy admission
|
||||
|
||||
| Original VA / file offset | Recovered owner/transition |
|
||||
|---|---|
|
||||
|413E5A,413E9D /13E5A,13E9D|Carl progress queries SCENE;50 becomes60 through45F990. The friend talk caller subsequently dispatches the selected conversation. This is an entry phase, not an automatic skip-completion broadcast.|
|
||||
|45F9EC,45F9F2 /5F9EC,5F9F2|SCENE milestone switch. Byte45FC48[60−35] is2;45FBF0[2] points45FA0B, which supplies objective arguments3,1.|
|
||||
|406F50..406F88 /6F50..6F88|For positive objective id, clear44 dwords at4F7D00, store id4F8194, zero timer4F8188, store low argument byte at indexed objective flag. This complete leaf does not write modal4F8198 or input suppression4F8430.|
|
||||
|45FB63..45FB8B /5FB63..5FB8B|Traverse task records4FC5FC, case-insensitively match name, then store supplied state at record+64. Repeated assignments are not suppressed.|
|
||||
|45FB8D..45FBE8 /5FB8D..5FBE8|Traverse registry50999C in list order. Compare supplied task against each game interface+430 TaskName. Only exact case-insensitive matches receive game424, synchronously.|
|
||||
|458880..45888A /58880..5888A|Plain task callback stores supplied state at **own** game494 and returns.|
|
||||
|4A373C+420,+424 /A3B5C,A3B60|Jimmy binds post-task hook472970 (no-op) and task callback40E340. Actual lab JIM1 has TaskName`none`, so the SCENE60 broadcast never reaches its424 callback. The45F990 loop does not invoke420.|
|
||||
|
||||
Actual `gam/level1b.gam` SHA256:
|
||||
`316fff40db565c2add5b07cbccdef640ddb67c64d6625fea1429ce2a0542a234`.
|
||||
JIM1 is index0/raw8, TaskName`none`, RequiredLevel0, ExactLevel/RemoveLevel−1.
|
||||
Carl is index8/raw1455, TaskName`SCENE`, RequiredLevel0,
|
||||
ExactLevel/RemoveLevel−1. Direct Jimmy exclusion alone would not prove that
|
||||
another listener cannot affect him; the following inventory addresses that gap.
|
||||
|
||||
## All authored matching listeners
|
||||
|
||||
There are89 serialized SCENE listeners, spanning17 kinds and six callback
|
||||
targets. The generated `source.json` retains every record index/raw offset,
|
||||
tag, authored gate, callback and a50/60 gate comparison. This is an inventory of
|
||||
**authored records**, not a runtime census of constructor-created helpers or
|
||||
retained actors.
|
||||
|
||||
| Callback VA / offset | Kinds and matching count | Recovered behavior |
|
||||
|---|---|---|
|
||||
|458880 /58880|3CAM,3MCA,3LIO,3NEU,3PAT,3SOU,STRT,LOAD:43|Store own TaskState. In particular, CAM/MCA task callbacks do **not** dispatch activation, prepare Jimmy, take control or play shots.|
|
||||
|40CA80..40CA9D /CA80..CA9D|3AIT:14|Store own TaskState, query its own task name through45FEA0, discard query result and return. This callback does not call AIT trigger40C300 or grant control.|
|
||||
|40E340..40E3D0 /E340..E3D0|3DUD,3BUT,3OMT,3TEL:9|Store own TaskState and apply own exact/required/remove activation gates through own complete110. Every matching authored instance in these kinds has all three gates−1, so50 and60 preserve existing activation.|
|
||||
|45F2B0..45F3A5 /5F2B0..5F3A5|3PIC,3ANI:21|Store own TaskState; if its picture is uncollected, test own exact/required gate. Set own visibility, pickup-active byte and collision byte. No NextTrigger/ActivateObject/ToggledObject dispatch occurs in this task callback.|
|
||||
|43EBB0..43EC07 /3EBB0..3EC07|3ROC:1|Run generic animated callback. If own linked pointer game680 is nonzero, set own rendering/effect and collision flags. The inspected callback tests that pointer without dereferencing it as another actor. Authored exact/required/remove gates are all−1.|
|
||||
|413F30..41411E /13F30..1411E|3CAR:1|Query new SCENE, run generic activation, then LV1B override on Carl. At60, resolve CARLESC3, set **Carl** AIstate6 and copy marker root to **Carl**, then leave base activation unchanged.|
|
||||
|
||||
For the pickup/sprite paths, `shrinkray` (required0), the unnamed animated sprite
|
||||
index72 (required0) and the late pickup index120 (required140) preserve the same
|
||||
gate outcome at50 and60. `apple` (exact30) is disabled at both. All remaining
|
||||
matching pickup/sprite records have required/exact−1 and preserve state.
|
||||
Actual collection table4F8438 and live visibility are not reconstructed by this
|
||||
authored gate calculation. All21 callbacks can still store their own TaskState
|
||||
on repeated assignments.
|
||||
|
||||
The source helper records exact game tables and constructor/registration sites
|
||||
for all17 kinds. Representative bindings include AIT48F8C0+424→40CA80,
|
||||
CAM497BFC+424→458880, MCA4A8F64+424→458880,
|
||||
PIC4AE548+424→45F2B0, Rocket4B25AC+424→43EBB0,
|
||||
Carl495364+424→413F30 and LOAD4D025C+424→458880.
|
||||
|
||||
## Activation dependencies and state ownership
|
||||
|
||||
The inspected callback tails do not contain a Jimmy mode704/turn614/Euler
|
||||
reset or a raw control-pointer grant. Their relevant indirect calls keep the
|
||||
listener as `this`:
|
||||
|
||||
- Animated complete110→40E3E0 controls that actor's display and collision.
|
||||
Its complete10C hook is472970 for the matching Button/DUD/OMT/TEL/Rocket
|
||||
classes. Carl's hook413D60 is an own-animation resource/preparation path,
|
||||
guarded by its own complete635 loaded byte; it requests Carl's STOP and
|
||||
sets Carl's motion parameters. It does not invoke a cutscene or Jimmy cleanup.
|
||||
- Own game3A4/3AC→473030/4730E0 forwards false/true to own game224.
|
||||
The common224→471A40 only writes own game140 collision-enabled byte.
|
||||
Own game214→471A00 writes own game13E, and pickup game1F4→471980
|
||||
writes own game134. These are flags, not immediate collision-pair callbacks.
|
||||
- Carl complete124→4089B0, state6, enters the408AC2 branch when eligible.
|
||||
Its own game410→40A6B0 preparation clears Carl velocity/speed. Carl
|
||||
game314→472360 copies Vec4 only to own game214 root. Neither receiver is
|
||||
Jimmy. Equal/locked-state branches remain local as well.
|
||||
- Display slot58 forwards to OMT resource visibility. This report does not
|
||||
execute the complete OMT renderer/animation graph or claim arbitrary engine
|
||||
observers have been exhausted. The recovered task callbacks themselves do
|
||||
not publish another actor's Euler/mode/turn or trigger a camera chain.
|
||||
|
||||
This closes the proposed **direct SCENE60 task reset** explanation and the
|
||||
authored CAM/MCA/AIT activation explanation. It does not establish the original
|
||||
first resumed frame or justify a blanket rotation reset, actor rescheduling or
|
||||
new input suppression. Later UI consumers of objective flags, runtime-created
|
||||
listeners and the full original registry remain separate observation boundaries.
|
||||
|
||||
## Bounded native verification
|
||||
|
||||
`jimmy_task_return_probe.c` executes original45F990 assignment/dispatch,
|
||||
406F50 objective selection and458880 state store from a private mapped copy.
|
||||
Only original absolute operands/jump-table targets needed by this finite path
|
||||
are relocated. Task and registry lists, game objects/vtables and `_stricmp`
|
||||
transport are explicit synthetic adapters. Matching actor callbacks in this
|
||||
probe are **adapters**, not actual Carl/pickup/Rocket/engine callbacks; those
|
||||
paths above are statically recovered.
|
||||
|
||||
All48 cases pass, varying prior task50/60, authored-like Jimmy task`none`
|
||||
versus synthetic matching`SCENE`, movement mode0/1, turn−12/0/+12 and both
|
||||
modal/input-flag seeds0/1. Each callback observes assigned task60 and already
|
||||
selected objective3. Authored-like Jimmy receives zero callbacks and remains
|
||||
byte-for-byte unchanged across all1F00 bytes. Synthetic matching Jimmy's only
|
||||
change is own game494 TaskState. Modal4F8198 and input suppression4F8430
|
||||
retain both tested seed values; objective timer4F8188 becomes zero.
|
||||
|
||||
Final capture reports wineExit0 and `JIMMY_TASK_RETURN_COMPLETE`; parsed output
|
||||
and provenance are in `artifacts/jimmy-task-return/native-observations.json`.
|
||||
The probe binary, generated source, complete copied EXE identity, static guards,
|
||||
Wine log and capture metadata are hashed there. No original startup, full Carl
|
||||
talk, skip, body, input/controller or renderer executes in this probe.
|
||||
|
||||
Initial capture timed out during Wine prefix creation. A missing-module repair
|
||||
then failed kernel32 loading. The successful run uses a copy of the previously
|
||||
successful generated Carl-contact Wine32 prefix. Logs for failed setup attempts
|
||||
and prefix repair/reuse metadata are retained; none is gameplay evidence.
|
||||
Original files were not modified or executed in place; isolated runs have no
|
||||
network or original-directory mount.
|
||||
|
||||
## Reproduction
|
||||
|
||||
From GamePort, with the existing local REA Evidence and Wine32 tooling:
|
||||
|
||||
```
|
||||
python3 tools/binary/jimmy_task_return.py ../Original \
|
||||
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||||
--output artifacts/jimmy-task-return/build
|
||||
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wl,--image-base,0x10000000 \
|
||||
-I tools/binary artifacts/jimmy-task-return/build/jimmy_task_return_probe.c \
|
||||
-o artifacts/jimmy-task-return/build/probe.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/jimmy-task-return/build/probe.exe \
|
||||
--probe-success JIMMY_TASK_RETURN_COMPLETE --seconds 12 \
|
||||
--output artifacts/jimmy-task-return/probe
|
||||
```
|
||||
|
||||
A fresh Wine prefix may need more time for initialization; successful completion requires
|
||||
both marker and process exit0, not merely screenshots or a returned wrapper.
|
||||
@@ -0,0 +1,212 @@
|
||||
# Read-only original process-state observer
|
||||
|
||||
2026-11-06. This investigation tool is separate from the modern runtime. It is
|
||||
intended to establish actual startup registry state and narrow the unresolved
|
||||
Carl skip-to-idle discrepancy. It does not supply a gameplay fix or certify exact
|
||||
callback order. No original execution is claimed by the initial compile/guard
|
||||
checks below.
|
||||
|
||||
## Execution boundary
|
||||
|
||||
`tools/recon/original_state_observer.c` launches one explicitly attested generated
|
||||
game copy with `CreateProcessA`, samples it with `ReadProcessMemory`, then requests
|
||||
ordinary `WM_CLOSE` on that process's own visible window. It never writes target
|
||||
memory, installs breakpoints, invokes target functions, forces actor state, or
|
||||
terminates another process. If ordinary close does not succeed, the child remains
|
||||
running; the caller must handle its own isolated environment. Existing Wine
|
||||
capture infrastructure cleans up only its private wineserver afterward.
|
||||
|
||||
The first argument must be `--copied-game=<path>`. This is the caller's explicit
|
||||
attestation that the target is a generated copy. Both the absolute path and the
|
||||
handle-resolved final path reject a case-insensitive `Original` path component.
|
||||
The tool accepts only the three exact hashes below and the original1019904-byte
|
||||
file size. It holds an authenticated read handle without write/delete sharing
|
||||
through process creation. The flag is not a cryptographic proof of provenance;
|
||||
use the existing generated-copy wrapper, never a hard link to an original file.
|
||||
|
||||
Alternatively, `--attach-copied-pid=<PID>` explicitly attests that an already
|
||||
running process uses a generated copy. This mode acquires only
|
||||
`PROCESS_VM_READ | PROCESS_QUERY_LIMITED_INFORMATION | SYNCHRONIZE`, obtains its
|
||||
actual image path with `QueryFullProcessImageNameA`, and applies the same final
|
||||
path, size, file hash and live instruction guards. PID is a strict positive
|
||||
32-bit decimal value; malformed/overflowed values are rejected. The process
|
||||
handle binds the selected process throughout validation/sampling, rather than
|
||||
reopening a potentially reused PID. Attach mode never calls `CreateProcess`,
|
||||
focuses a window, sends input, requests `WM_CLOSE`, or terminates the target.
|
||||
`--menu-keys` is rejected before opening the process. Sampling ends while the
|
||||
original session remains under the user's control.
|
||||
|
||||
No network API is used. Run under `tools/recon/reference_capture.py` for its
|
||||
existing no-network/no-original-mount boundary. Native Windows execution must
|
||||
likewise use a generated directory containing copies of the game and its assets.
|
||||
Game-created settings/saves then remain in that generated environment.
|
||||
|
||||
## Supported subjects and evidence
|
||||
|
||||
| Profile | Exact executable SHA256 |
|
||||
|---|---|
|
||||
|canonical|`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`|
|
||||
|hd-resolution|`b6675b7e7f3fc37512185ddb4d6ce1fbe9a36c8b83f3b4b3ed6979a56db3d2d4`|
|
||||
|hd-nocd|`8cd5d21997835a40978b8b83e344c97c92217bf6cd6858f7458b76935d64dedb`|
|
||||
|
||||
Canonical instruction Evidence is
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`,
|
||||
retained in artifacts/jimmy-movement-audit/rea-original-disassembly.json.
|
||||
The HDnoCD subject has separate complete REA instruction Evidence
|
||||
`ev_23555fac476985c913a80805a12b25c26c25347c6e8210ee188471dd815c276d`,
|
||||
retained in artifacts/jimmy-skip-original-sw/rea-hdnocd-disassembly.json.
|
||||
The supplied HD resolution variant preserves the observed operands. The HDnoCD
|
||||
profile is independently identified; its observation is not automatically a
|
||||
canonical-original behavior claim. Other supplied variants are rejected.
|
||||
|
||||
Each global address is independently guarded by its actual live instruction
|
||||
operand before sampling. Runtime inspection is refused if those anchors do not
|
||||
match within5s. This avoids assuming that the other variant has identical data
|
||||
addresses. Preferred-base VAs and PE file offsets follow:
|
||||
|
||||
| Read role | Instruction VA / file offset | canonical and HD global | HDnoCD global |
|
||||
|---|---|---|---|
|
||||
|Raw control owner|475A40..475A4B /75A40..75A4B setter|5099E4|509A04|
|
||||
|Registry sentinel pointer|473740 /73740 load|50999C|5099BC|
|
||||
|Viewport seconds|47374F /7374F load|696030|696050|
|
||||
|Current game complete pointer|46E360 /6E360 store|509948|509968|
|
||||
|Shared skip|430F3E /30F3E store|4F83E4|4F8404|
|
||||
|Input block|426062 /26062 load|4F8430|4F8450|
|
||||
|Modal gate|407060 /7060 load|4F8198|4F81B8|
|
||||
|Skip suppression|430F11 /30F11 compare|4F8182|4F81A2|
|
||||
|
||||
Registry nodes are `{next,previous,payload}` at offsets0/4/8, from the recovered
|
||||
46FF4A..46FF7F insertion and473740 traversal. Traversal stops at the sentinel,
|
||||
1024 nodes, an unreadable node or a repeated payload. `complete:false` means the
|
||||
sample cannot establish the whole list; mutation during a read is possible.
|
||||
Jimmy is recognized by game-interface vtable4A373C. The current game registry
|
||||
payload is its complete pointer+8C. A successful full-list sample records their
|
||||
actual indices without executing either actor or inferring constructor order.
|
||||
|
||||
Jimmy samples use the game interface: current Euler224..230, destination274..280,
|
||||
dirtyA, movement mode704, stored turn614, and action latch1D40 (=complete1E00).
|
||||
Support fields13F and4A0 are reported separately as cached and force-support
|
||||
bytes: actual458960 reads4A0 first, otherwise471A10 reads13F. They are not an
|
||||
executed support query. The source addresses are code-field contracts, not
|
||||
guessed layouts or corresponding fields from the modern simulation.
|
||||
|
||||
## Output and ordinary input
|
||||
|
||||
Output is bounded JSONL on stdout: authenticated identity, registry changes,
|
||||
nominal10ms state samples, optional normal input events, finish and completion
|
||||
marker. `Sleep(10)` is a sampling request, not a guaranteed interval or a game
|
||||
clock. Each record includes actual elapsed wall-clock milliseconds. Floating
|
||||
point NaN/infinity is written as JSON null. Narrow Win32 path/title bytes outside
|
||||
ASCII are escaped so the output remains valid JSON; use ASCII generated paths
|
||||
for reliable cross-machine reproduction.
|
||||
|
||||
`valid_mask` uses bits0..3 for readable skip/input/modal/suppression bytes, bit4
|
||||
for readable viewport delta, and bit5 for a readable full Jimmy field block.
|
||||
Zero values without the corresponding valid bit are placeholders, not evidence
|
||||
that the game state was zero. Jimmy fields are omitted without bit5.
|
||||
|
||||
By default no keys are sent. `--menu-keys` explicitly opts into ordinary Return
|
||||
presses at approximately3/6/9s, each held100ms while sampling continues. It finds
|
||||
only the child process's visible unowned window, requests normal window focus,
|
||||
and uses `SendInput` only when that window is foreground. Records include title,
|
||||
window/foreground handles, press/release and events accepted by `SendInput`.
|
||||
Accepted events do not prove that the game's input system consumed them or that
|
||||
a particular menu item was selected. This sequence is not a recovered New Game
|
||||
macro. `--copied-game-menu=<path>` is an explicit single-argument equivalent for
|
||||
the existing capture wrapper, which passes one `--probe-model` argument.
|
||||
|
||||
Samples consist of multiple independent reads without suspending the game. They
|
||||
can miss transitions shorter than the interval and can mix adjacent callbacks.
|
||||
They establish observed retained state and list membership; they cannot alone
|
||||
prove the first writer, same-frame control order, exact input/controller order,
|
||||
physics chronology, or the complete Carl skip lifecycle. A black screenshot is
|
||||
still not a usable visual reference even if process state can be read.
|
||||
|
||||
## Build and use
|
||||
|
||||
From GamePort:
|
||||
|
||||
```sh
|
||||
mkdir -p artifacts/original-state-observer
|
||||
i686-w64-mingw32-gcc -std=c11 -O2 -Wall -Wextra -Werror \
|
||||
tools/recon/original_state_observer.c -lbcrypt \
|
||||
-o artifacts/original-state-observer/observer.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/original-state-observer/observer.exe \
|
||||
--probe-model=--copied-game=NeutronHDnoCD.exe \
|
||||
--probe-success ORIGINAL_STATE_OBSERVER_COMPLETE --seconds 24 \
|
||||
--output artifacts/original-state-observer/capture
|
||||
```
|
||||
|
||||
The observer itself defaults to15s and accepts `--seconds=1..120` on native
|
||||
Windows. For normal
|
||||
input opt-in, substitute
|
||||
`--probe-model=--copied-game-menu=NeutronHDnoCD.exe` above. Original variants with
|
||||
a CD prompt may not proceed to gameplay in this environment; no prompt bypass or
|
||||
executable modification is implemented by this tool.
|
||||
|
||||
On native Windows, first start an ordinary generated copy and reach the desired
|
||||
Carl/tutorial route. Obtain that game's process ID, then start the observer from
|
||||
a separate terminal, redirecting stdout to a local trace:
|
||||
|
||||
```text
|
||||
observer.exe --attach-copied-pid=1234 --seconds=60 > carl-original.jsonl
|
||||
```
|
||||
|
||||
Replace1234 with the copied game's actual PID. The existing session is left
|
||||
running and receives no observer-generated input or close request. `--help`
|
||||
prints usage without opening a file or process. The same process path/hash
|
||||
restrictions apply even if another executable is named Neutron.exe.
|
||||
|
||||
Initial verification: MinGW32 compilation with all warnings treated as errors
|
||||
passes. All24 independently PE-mapped source anchors (8 per supported subject)
|
||||
match; artifacts/original-state-observer/source-guards.json records original
|
||||
hashes, exact bytes, addresses and file offsets. These are compilation/static
|
||||
checks only. The primary investigator owns subsequent isolated runtime captures,
|
||||
integration, additional evidence and any commit.
|
||||
|
||||
## Integrated Wine32 observation
|
||||
|
||||
The primary's generated-copy launch and focus/Return checks reach MAIN only:
|
||||
game-interface table4D0C0C, no Jimmy, black captures. An isolated xfwm4 desktop
|
||||
does not produce a usable gameplay reference. Viewport delta0 here does not prove
|
||||
the menu selected New Game or that menu/engine clocks share the gameplay clock.
|
||||
|
||||
The final attach revision is exercised by
|
||||
`tools/recon/original_observer_smoke.c`. This Wine-only driver requires the
|
||||
wrapper's generated `Z:\work\game` directory, launches the supplied HDnoCD
|
||||
copy, then attaches the observer for10s. It verifies observer exit0 and that the
|
||||
original remains active afterward, before sending its own child's ordinary close.
|
||||
The observer itself sends no input or close in attach mode.928 JSON samples parse,
|
||||
the exact live guards pass, and capture wineExit0 plus both completion markers
|
||||
are present. MAIN only is observed; this is API/tool validation, not a Carl trace.
|
||||
|
||||
The tested observer source/build hashes, driver identity, logs/capture metadata
|
||||
and parsed summary are in
|
||||
`artifacts/original-state-observer/attach-runtime/observations.json`. The initial
|
||||
launch capture lacked a pre-recorded observer executable hash and includes a
|
||||
Wine diagnostic interleaved with JSON; it is retained separately as a limited
|
||||
functional observation. The final attach capture has explicit build provenance
|
||||
and928 intact samples. Native Windows execution remains unverified.
|
||||
|
||||
Reproduce after building the observer and driver, using the already prepared
|
||||
generated Wine copy/prefix (no source original is mounted):
|
||||
|
||||
```sh
|
||||
i686-w64-mingw32-gcc -std=c11 -O2 -Wall -Wextra -Werror \
|
||||
tools/recon/original_observer_smoke.c -o artifacts/original-state-observer/attach-smoke.exe
|
||||
cp artifacts/original-state-observer/observer.exe artifacts/jimmy-skip-original-sw/observer-under-test.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/original-state-observer/attach-smoke.exe \
|
||||
--probe-success ORIGINAL_OBSERVER_ATTACH_COMPLETE --seconds 18 \
|
||||
--output artifacts/jimmy-skip-original-sw
|
||||
```
|
||||
|
||||
Primary's launch observation, before attach support: separate HDnoCD profile
|
||||
passes all live guards; normal focused menu input and an isolated window manager
|
||||
still yield only MAIN (game index0, interface vtable4D0C0C), no Jimmy, and delta0.
|
||||
The final run recorded2042 samples across22.02s. This validates the observer's
|
||||
bounded launch/read path under Wine, not original gameplay or Carl's return.
|
||||
Attach support was added for a reference machine where the user can reach the
|
||||
route before starting a bounded trace. Its strict compilation/source checks are
|
||||
separate from native Windows attach execution, which remains unverified here.
|
||||
Reference in new issue
Block a user