Files
Neutron/docs/checkpoint/coverage.md
T

167 lines
19 KiB
Markdown

# Core architecture coverage map
2026-11-07 normal callbacks: [actor contacts](actor-normal-contacts.md) adds30
full emitted original/C# snapshots (S/P/M),13 interface/182 method bindings and5
pure scalar getter fields. Inherited ceiling/reflection/angular response is a
standalone component; Jimmy's ordinary374 override stays separate. Late scalar
reads are tested with explicit injected endpoint changes. Soldier174/Jimmy204
full policies, retained helper order and live scene binding remain open. No new
port-render/original-game/native Windows runtime coverage is claimed.
2026-11-07 populated follow-up: [dynamic reclip](dynamic-reclip.md) adds14 full
original/C# comparisons and12 kernel-step matches (S/P/M). Real synthetic static
walls/ceiling now exercise shared nearest, retries,370/374 order and primitive
mode. Kernel arithmetic corrections follow captured divergences and original
float-store boundaries; no numerical tolerance was added. Actual actor callbacks,
post-callback flag/radius ownership and retained helper order still gate live pairs.
2026-11-07: [dynamic/shared context](dynamic-context.md) adds17 complete original/
C# test-composition cases and12 captured kernel argument matches (S/P/M).
Hit/last-polygon retention, old static callback and final local-root publication
are recovered under empty-grid/non-reentrant fixtures. Original kernel A,C,B
arguments differ from construction topology; final position alone hid that error.
Jeep's default deletion predicate is guarded; full active cleanup remains open.
Live collision, nonempty shared reclip, real actor callbacks and retained helper
order remain gated. No new R/whole-original/native Windows coverage is claimed.
2026-11-06 TSK-entry correction: [menu/player lifetime](../gameplay/main-menu-player-lifetime.md)
establishes backgroundJimmy construction and reuse before the first playable
story scene. Input is now after Jimmy for that TSK path, while direct fresh-GAM
order remains. This replaces the named assumption that initial story equals fresh
registry insertion. First-neutral-tick/300-idle native Vulkan and eight managed
Carl trajectories pass; full-suite/platform results are tracked in progress.md.
50 more native derived-caller cases and body/transform ownership are documented.
Original startup diagnostics now reach background allocation after a recorded
repaint intervention, with black frames; no full-original visual/runtime parity
or native Windows execution is claimed.
2026-11-06: [Carl lifecycle trace](../gameplay/jimmy-cutscene-lifecycle.md) adds
292 bounded original-code cases and closes local contact/task/animation/STOP and
DEFAULT-provider questions. Actual first-resumed-frame state remains unobserved.
The new original-state observer passes Wine32 attach/read/leave-running; local
original captures show MAIN only and remain visually unusable. This expands S/P
and investigation-tool coverage, not original gameplay comparison or a new port fix.
MOVE/CONTROL/INPUT's Carl gate and full-body/OMT dependencies stay open.
2026-11-05 follow-up: camera-entry reset is verified, but post-skip neutral idle
remains a port bug. CONTROL/INPUT/skip coverage is reopened around Carl's full
lifecycle;48 port traces and additional original boundaries are documented in
[the focused decompilation checkpoint](../gameplay/jimmy-cutscene-decompilation.md).
No further gameplay change is made before its source-ownership gate is closed.
2026-11-05 handoff correction: CAM/MCA destination state at game+274 is now reset
along with current Euler (20 original-component cases; managed/native Linux
handoff checks). Neutral ground input separately retains residual bank in seven
original trajectories; whole-frame landing comparison remains open. See
[rotation handoffs](../gameplay/jimmy-rotation-handoff.md).
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.
2026-11-05 movement continuation: [Jimmy stabilization](../gameplay/jimmy-movement-stabilization.md)
supersedes MOVE/JET arithmetic details below. Ground, air and control-independent
full-axis facing now have108 native component comparisons including the jump
suffix. COLL keeps its admission gate: real support polygon pressure is live in
the source body, while lab/outside retain capsule compatibility.27 special
contact dispatch and12 air-target observations expose remaining gates; they do
not certify special callbacks or the ordinary air-pitch visual bridge.
The following [air-target/render continuation](../gameplay/jimmy-air-bridge.md)
implements ordinary pitch/roll targets, dirty/Init and retained seed ownership,
full current Euler publication and source hierarchical model rotation.146 native
observations now compare with managed components. The model-local sole correction
is modern; exact final OMT render decomposition and broad collision remain open.
[Body contact ownership](body-contact-implementation.md) now closes the finite
current/previous XYZW barrier, independent body modes, context lifetime and landing
payload ordering.100 new complete original comparisons and six callback-state
comparisons pass. Special callback mechanics, actor mode persistence and scene-wide
dynamic/shared context remain separate gates; lab/outside capsule is preserved.
[Ordered pair lifecycle](pair-lifecycle.md) adds28 complete original/C# component
comparisons: physical-list pair order, one-sided sphere exclusions, gate retention,
callback-mutated roots/membership and enter/stay/leave. The component has explicit
mode2 injection and is not admitted to live scenes. VR04's6 inspected actor records
and20 bindings do not yet constitute the full physical/helper registration list.
[Physical registration](physical-registration.md) now inventories all72 VR04
records/13 actual interfaces and executes12 original registration/loader cases.
Common append versus Jimmy49E guard, nested Init and live per-object registry
traversal are verified.21 helper edges/12 RTTI identities are catalogued; actual
retained helper membership, deletion/activation and shared reclip remain open.
| 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. Uncontrolled body/fire now continue while movement/input are gated. Other systems remain grouped; fixed60Hz policy. | S/M/R. Controlled player partial order implemented; bounded raw-owner preparation implemented; full wrapper/registry/cadence 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;479D20 impulse→acceleration→gravity; authored114→26C body speed separate from controller608. | Body/fire continue without control; input/controller gated. VR04 uses ordinary source static body and variable radius; lab/outside capsule retained. Fresh/retained order and overhead wrapper explicit. | S/P/M/R. Source body references/phase checks and native VR04 flight pass; complete registry/base/transform/cadence open. | Continue dynamic/special C4 contracts and C3 base transforms; preserve published speed ownership across preparation/Init. |
| 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;47B4B0 FIFO grid/retries;370/374/37C; signed materials/friction; radius60/100;47A430 ordered pairs/47CA90 one-sided sphere exclusions. | VR04 uses ordinary source static body; lab/outside keep24-unit capsule.28-case pair component remains separate; live dynamic response provisional. | S/P/M/R. Prior kernel/dispatcher/body comparisons and native VR04 pass;28 complete pair observations now match. Real actor callbacks, full physical list and shared reclip remain open. | C4: complete VR04 physical registration/activation/helpers, then shared dynamic context; lab/outside need160/164/FENCE/LADDER before solver expansion. |
| 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. | Pre-assignment objective selection and per-actor Carl override implemented; bounded synchronous director. | S/M/R. Script callbacks recovered for route; generic class coverage and reentrancy incomplete. | Continue other class-specific callbacks and reentrancy under the recovered owner/phase boundaries. |
| CONTROL | Global5099E4 null during valid CAM/MCA; PlayerControlled completion target; DEFAULT447D..447F restores camera/UI/music. | Director raw ownership plus explicit debug effective override; eligible player body/fire continue; only input/controller tail is gated. | S/M/R. Raw/effective control and ordered preparation are implemented; full base/class wrappers and scheduler remain incomplete. | Continue full wrapper/base and collision contact phases around deferred LOAD. |
| CAMERA | Shared viewport eye is recaptured by ground/air follow after scripts; strict>1000 DEFAULT snap; aim uses pre-update eye; source ray/gain and per-level far planes. | Static source query integrated for the three route scenes; other scenes use provisional sweep. Separate chase/script eyes and merged clip maximum remain. | S/M/R. Handoff source bytes/projections recovered, not implemented; full follow/input/quantization and visual comparison open. | C5 shared viewport eye/aim and DEFAULT transition; preserve source phase boundary. |
| 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 | Deferred request/selective reuse; Init stored+11→live+139; retained Jimmy/Goddard.49E clears; registration repeats Init before STRT. Per-object28→40C and same-pass appends; RETURN root/flags. | Reconstructed scene with retained input order and bounded state; app-owned presentation. | S/P/M/R.12 original registration/loader cases now pass; all72 serialized VR04 records mapped. Helper lifetime/activation and full ordering still open;50988A is editor R input. | Close helper reuse/removal and physical sequence alongside C4; other gadget/level branches remain gated. |
| INVENTORY | PostLoad common prefix enables eight owned gadgets4→1, then VR01..08 disables1→4; full tail re-enables the practice gadget. LV1B disables1/7; other wire values 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 other level tails remain incomplete; bounded route mode/hold/fire carry is implemented. | 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. |
| SCOOTER |4211A0/412A90 owned vehicle/4 children;465220/465830 drive/input;467080 post-normal wheel support;421910 impact;4130A0 camera;4281B3 cleanup. | Now live VR05 and outsideLEV1, normal tile plus F1. Body→input/frame→rider-copy→wheel phases, exact unscaled resources, source camera/audio and RETURN. | S/P/M/R:53 isolated original observations, actual-level managed tests,10-phase native/headless replays. No complete original-game comparison. | Whole-original/native Windows comparison; shared global/pair state, retained LOAD/helper/save lifecycle and other levels remain bounded. See gameplay/scooter-live.md. |
## 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. |
| Jimmy mode/hold/owned-fire timer | Constructor, controller/fire ticks; property/Init/PostLoad/cleanup boundaries traced for supported route states | Ordinary route container retains these scalars; jump/body reset independently. TSK/debug checkpoint load carries none. First grounded tick can clear retained mode/timer. |
| 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.