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,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.
|
||||
Reference in new issue
Block a user