Files
Neutron/docs/progress.md
T

104 lines
6.7 KiB
Markdown

# Progress — 2026-10-24
**The full reconstruction is incomplete.** The current implementation extends the
user-verified Windows rendering checkpoint into an interactive original lab and
jet pack tutorial flow. This is not a verified faithful complete scene or release.
## Current integrated behavior
- Default play runs LV1B STARTEXP and its16-cue CAM/MCA/AI camera/speech sequence.
Escape/Space skips actions and restores control; `--inspect` retains inspection.
- Original walking/backpedal/turn/jump arithmetic, source clips, chase camera and
fixed60Hz port simulation. Powered jumping now translates the recovered state
table,8-second effect timer,60/100 contact radii and energy/VR immunity rules.
- Original Carl/Goddard morphs, sprite quads and9 lab model actors, including the
OMT phones, source buttons and moving bars. Goddard's unregistered STOP/WALK/TALK
requests retain the current source clip rather than invented aliases.
- Shared patrol states1/3/7, state9 base motion and Carl's WALK/STOP profile.
Body support uses recovered radii, factors, quick magnitude and one-sided trace;
full wall response and Carl sensing remain incomplete.
- Lab explanation -> SCENE35 -> jet pack pickup -> SCENE50 -> Carl contact/talk
-> SCENE60 -> outside LOAD dispatch. Pickup adds50, Carl callback adds100 before
dialogue. Source task gates/objective selector and inventory slot0/3 persist.
- The pickup's internal tag `shrinkray` names the lab jet pack, proven by original
GET JET PACK art and powered-jump inventory checks. It is not a shrink-ray weapon.
- Original objective pad, three lab objective images, digits and PracticeYesNo
are rendered at source640x480 coordinates. O changes stationary panel offset.
Practice pauses the simulation; Y enters VR04/PHONEBOOTH and N resumes.
Return context is current GAM/latest STRT (LV1B/STARTEXP for NewGame), separate
from the still-unrecovered runtime checkpoint-root restoration.
- Button contact/cooldown/down/up/next-trigger and vertical-door duration,
reversal/hold/next-trigger logic. Source dynamic-box broadphase/triangle ordering
is translated; narrowphase/response still uses a modern approximation.
- Ordinary stars/trophy, score and acquired flags; all12 TSK files round-trip.
CLI checkpoint load/write preserves unknown fields, inventory, tasks, energy,
objective selector and RETURN context. Complete runtime/menu saving is unfinished.
- Music and speech use independent SDL streams. Positional effects/banks and
physical audio verification remain unfinished. Original default-bank pickup/button/
moving-door one-shots and owner loop stop are now connected; attenuation/volume
policy and jetpack sound callbacks remain unfinished.
## Source availability and evidence
All539 original hashes remain the baseline. All35 GAM files are supplied and33
have matching OMT geometry. Level3B/E GAMs exist, each1777 bytes, and are identical
after their four-byte level identifiers. Their classes name absent OMT archives,
but no serialized incoming GAM transition or supplied save selects them; loader
null handling does not establish a fatal failure. Normal gameplay use is unverified,
so these are not an established blocker and no extra files are currently requested.
The catalog preserves absent geometry without substitution.
Detailed recovery: analysis/lab-progression.md, scene-entities.md, scene-models.md,
patrol.md, original-collision.md, dynamic-collision.md, buttons-doors.md, ui.md,
jetpack.md, level-resource-mapping.md, and save-format.md. Addresses, source offsets,
confidence and approximation boundaries are retained there.
## Verification
Managed checks cover source data, director/actions/cameras, task/interactions,
patrol, recovered support, moving-box collision, jetpack states and HUD composition.
Python currently has35 top-level regression tests plus2 targeted UI extraction tests.
Existing11 collision and13 movement groups pass;14 jetpack groups pass. Eight
quick-magnitude float results are checked against an isolated original DLL probe.
Original mode2 standing/jump animation probes confirm zero dynamic-point offsets
for the tested clips. This is DLL evidence, not observed original game behavior.
Headless llvmpipe runs render the story, model actors, practice prompt, lab exit
and VR04 entry with zero Vulkan validation errors. The300-step VR04 powered replay
jumps once, rises418.98 units and lands; VR immunity retains20 energy. The ordinary
240-step replay travels1250.12 and rises137.62; port landing-count telemetry changed
with the explicit state table. These measurements verify port behavior only.
See artifacts/full-integration-test.log and practice/jetpack logs for current checks.
The full scripts/test.sh integration passed:35 Python regressions,2 targeted UI
checks, all managed groups, GPU story/route/practice/VR04 replays, SDL dummy streams
and539 unchanged original hashes. Both self-contained packages rebuilt successfully.
Linux package runs the12s story without SDK/source/Original mounted, zero Vulkan
validation errors. Its GTX1070/Xvfb practice window pauses, receives N, resumes11
steps and resizes800x600 with zero validation errors and original pickup audio.
The Windows package passes the same12-frame practice/input/resize/stream check
under isolated Wine64, matching simulation statistics (validation disabled).
It also renders the12s story under Wine. Generated package logs live under
artifacts/package-integration.log, linux-package-integration/, package-practice-window.log
and windows-practice-package/. Initial native Windows loading/rendering remains
user-confirmed for the earlier checkpoint; current native Windows story/input/audio
is still unverified. Wine is preliminary compatibility evidence only.
## Next work and limits
No usable original gameplay reference has been captured: isolated Wine GL/Vulkan
attempts fail rendering. Continue static recovery and isolated DLL probes locally;
comparison on a working original installation remains required for fidelity.
Next priorities are lab navigation/door collision and checkpoint return-position
fidelity; original collision47BD80/479D20 and phase/cadence; audio-bank/SFX mapping;
UI slide/highlights/energy gauges; actor sensing/animation completion. Then expand
remaining gadgets, damage/combat/enemies, menus/configuration, full saves and all
level progression. Lighting/fog/blend/culling and sprite/pivot fidelity are open.
Do not claim complete gameplay based on direct-contact route or GPU smoke tests.
All previous agent file ownership has returned to primary; investigators that
reached usage limits are not dependencies. Generated output stays separate from
Original and the nested local repository has no remotes. Read tasks.md and Git
status before continuing; preserve source evidence and update these notes.