Files
Neutron/docs/checkpoint/coverage.md
T

11 KiB

Core architecture coverage map

Checkpoint scope: lab → tutorial VR04 → lab → outside, including intro, explanation, pickup/practice, RETURN, Carl conversation and exit. This compares source contracts with the current port and preserved playable baseline69d0187, not all gameplay in all levels. Rows marked “now” include the implementation continuation; the original baseline remains a separate comparison point. Address details/PE offsets and source-byte extractors are in the linked reports. S=static/data recovery, P=isolated original component probe, M=managed port regression, R=port runtime. No row has full original-game runtime comparison. Coverage does not mean implementation completeness.

ID / system Recovered contract / anchors Port implementation Evidence / remaining gap Next bounded action
LOOP Viewport47E4F0 physics before registry473740, including input44DF80; second sync473770; construction order and selective retained-character/new-game ordering. Separate engine morph clock. Player now integrates prior body state, then fresh input/player/fire or retained player/fire/input. Other systems remain grouped; fixed60Hz policy. S/M/R. Controlled player partial order implemented; full registry/cadence and uncontrolled-body preparation open. C3 continue other callbacks and morph/control phases; C4 support/response remains separate.
INPUT Game interface+8C slot3C4→44DF80→475A70 reads controlled5099E4 and calls3CC; Jimmy interface+C0→426030. SDL arrows/jump aliases; control gate, modern debug override; mouse/controller incomplete. S/M/R, user Windows route. Input occurs in object traversal after physics; device sampling/focus and latency open. Trace event pump, key/mouse and focus gates alongside retained registry order.
MOVE 437940/439900 ground/air arithmetic; physics479D20 consumes queued impulse once before acceleration/gravity. Recovered arithmetic placed in same-tick controller→physics; fixed dt, custom yaw/model conventions. S/P/M/R. Local arithmetic evidence does not validate enclosing phase. Split pending velocity/impulse only after C3 oracle.
JET 437F90 controller;421FB0 effect; fresh constructor order places fire after Jimmy, both after global physics. States0..5, hold>.4,8s, energy. Explicit state table with post-collision effect ticking and VR immunity. S/M/R. Fresh same-pass countdown recovered; retained child lifecycle, sound and expiry→animation open. Trace retained Jimmy/fire resets and phase end events before scheduler integration.
COLL 479D20/47BD80 body response; support and quick magnitude; dynamic boxes; NC-shape registration exclusion. Source support and box pieces around modern swept24-unit capsule, feet/root grounding and slide. S/P/M/R. Response/masks/stairs/contact order not fully recovered; source radius60 is not port capsule24. C4: isolate response and root convention; replace adapter behind route tests.
ANIM Engine morph10002DB0; linear interpolation10002F9A; game logical→OMT sync4624B0. ASE sample timing, unconditional loop closure, pose/action aliases,1/60 advance. S/P/M/R. Playback flags, rate, completion callbacks, transition order open. Recover one-shot/loop/end notifications before more aliases.
SCRIPT Source AI/CAM/MCA dispatch and chains; task45F990 objective406F50 BEFORE records BEFORE per-entity424. Bounded synchronous director; baseline objective after records/actor batch. S/M/R. Script callbacks recovered for route; generic class coverage and reentrancy incomplete. C1: ordered objective notification; C2: per-actor Carl override.
CONTROL Global5099E4 null during valid CAM/MCA; PlayerControlled completion target; DEFAULT447D..447F restores camera/UI/music. Director raw ownership plus explicit debug effective override; player physics stops when uncontrolled. S/M/R. Null control is not proof all objects/physics stop; scheduler gap remains. Map raw ownership transitions against phase gates and deferred LOAD.
CAMERA Shared viewport; strict>1000 DEFAULT snap; source eye correction/gain; first wall-grid hit then general-grid FIFO; per-level far planes. Static source query now integrated for the three route scenes; other scenes use provisional sweep. Separate chase/script eyes and merged clip maximum remain. S/M/R. Query/kernel/counts tested; x87 boundaries, shared handoff/previous-eye and input branches open. C5 next shared viewport/DEFAULT and complete follow state.
AUDIO CAM416776..E1 stops music; DEFAULT447F12..45 restarts; bank696008 / gate4F8434; handle47D890 polls inherited software duration and repeat+30. Separate SDL streams, floating-file-duration cutscene completion, independent per-file SFX. S/M/R (dummy streams). Source duration/allocation/play-failure/bank/attenuation lifecycle incomplete; speakers/native Windows timing not verified. C6: explicit bank owner and software channel-clock tests; SDL queue-empty is not the source oracle.
UI 406F50 selector/timer;4043D9 controlled clock;407070/O edge;404D97 practice resume.44 objective flags distinct from selector. Timed objective subset, modal practice, modern UiViewport/debug. S/M/R. Other flags/gadgets/highlights/cursor/energy/layout transitions open; source widescreen not recovered. Keep modern scale policy separate; recover UI dispatcher/mode gates before expanding.
LOAD CEditor deferred scene request; selective teardown/reuse; Init stored+11→live+139 resolves old-game deletion; Jimmy/Goddard retained. RETURN root/flags and per-object28→40C. Snapshot/reconstructed scene state with retained input-order identity; app-owned presentation. S/M/R. Old-game removal closed. Per-field/helper resets and fades remain;50988A is editor R input. C7: retained-field/route lifecycle fixtures, then state-container integration.
INVENTORY PostLoad423DEF..423EC1 enables eight owned gadgets4→1, then VR01..08 disables1→4; other values/items preserved. Availability pass now applied at level entry and verified across TSK tutorial/return; snapshots preserve raw values. S/M/R. Full selected-gadget/UI and retained scalar state remain incomplete. Keep availability separate from ownership, task changes and arbitrary state carry.
SAVE TSK45FEE0 writer /4603F0 reader; records, arrays, return strings, stored departure root; queued460E70→460EA0. Original-format round-trip and CLI save, scene snapshots; no full source save UI/load lifecycle. S/M. Source reader duplicates matching task callback then all-entity420 post-task hook; this is distinct from Jimmy placement PostLoad423A90. Current fresh-director path differs. C7 after C1/C2; test repeated callbacks before adopting loader behavior.
CHECKPOINT Pickup42AF00 stores+1E38 root/+1E48 level separately from+9A8 RETURN root. Capture exposed, not used for return; source capture consumers unknown. S/M. Do not interpret as death/respawn until read consumer found. Track unresolved consumer; no speculative gameplay.

Interaction and ownership map

State / owner Changes when / consumers Persists or resets
Task records4FC5FC, name+0/state+64 45F990 objective hook → record mutation → matching actor424; queries gate triggers/LOAD/NPC TSK serialized; carried snapshots in port. Same-value assignments still dispatch.
Current controlled entity5099E4 Input dispatch, Jimmy behavior, UI clock, script/camera handoff Runtime ownership; not interchangeable with task state or whole-world pause. Port F1 override is separate modern state.
Scene actor game interface, body, OMT morph Physics prior body state → registry update → logical/visual sync; animation on engine path Level-owned construction/destruction; exact spawned effects order not yet recovered.
Objective selector4F8194 / transient timing and flags Task hook406F50, O and practice modal; UI dispatcher reads control Selector serialized; timer starts hidden20 and is runtime-only. Port implements one selected objective rather than full flags.
Departed root complete+9A8 Ordinary43B5A0 captures; RETURN preserves; PostLoad consumes pending flag TSK StoredVector persists; pending+954/+9A5 not serialized. STRT yaw remains authored.
Return level/start strings Practice choice records origin; RETURN LOAD selects them TSK persists strings independently of root and pickup capture.
Pickup checkpoint complete+1E38/+1E48 Pickup callback42AF00 writes; read consumer not proven Do not equate with departure root or invent reset/respawn semantics.
Music/effects/cutscene voice CAM takes bank/voice and stops music; DEFAULT restores source defaults Runtime bank/handle lifetime, not task ownership; current port independently opens WAVs.
Viewport/camera target CAM/MCA target/eye; DEFAULT snap and follow; clip/layer resource settings Original camera handoff is shared viewport state; baseline chase and scripted cameras diverge.
Modern application presentation and debug RenderSession keeps window/GPU; debug visibility across loads User-authorized session policy, outside original TSK or gameplay claims. Scene audio/gameplay disposed/recreated.

Assumptions and symptom-level adapters to replace

  1. Fixed60Hz remains a deterministic port policy. Baseline controller-before- physics has now been replaced for the controlled player; other grouped scene callbacks and morph timing remain incomplete. Preserve arithmetic tests but do not treat existing travel measurements as the source oracle.
  2. Floor snap/visual sole correction and24-unit swept capsule solve visible penetration/navigation symptoms. They do not recover Jimmy's body/root geometry or47BD80 response. Keep rendering pivot and physics support investigations separate.
  3. Carl activation is applied after a generic actor batch in the baseline; source virtual callbacks execute per actor in registry order. C2 replaces this adapter without inventing full NPC sensing.
  4. Route static sphere clipping is now replaced by source grids/kernel. Chase state and DEFAULT's simple camera reset still mask ownership gaps. Per-level far limits are recovered; merged-layer maximum is a rendering policy pending masks/fog, not complete clipping recovery.
  5. File duration is a cutscene completion estimate. The source also uses software duration, but integer elapsed boundaries, repeat, invalid/stopped channels, clock pause and effects-bank ownership remain lifecycle inputs. SDL queue-empty is not a better source oracle. Dummy playback does not verify original timing or physical speaker output. See voice-clock.md for the resolved vtable evidence.
  6. Current RETURN root, MCA control target, NC exclusion, air-turn clear and objective timeout have direct evidence. Retain those rules, but revalidate their phase/owner when the surrounding scheduler changes; don't discard them as guesses.

Limits and unresolved gates

Route coverage is stronger than later levels, but still lacks original end-to-end runtime comparison. No feature-expansion work is justified by this map alone. The source's UI/task/return state boundaries are sufficient for C1/C2 now. Scheduler, physics, camera, audio and loader chunks each require their specified probe before changing behavior. See the linked reports for exact offsets and additional questions.