Files
Neutron/docs/progress.md
T

126 lines
8.1 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.
## Latest user-tested correction
User testing found background music continuing during cutscenes. Recovered CAM
416776..4167E1 stops/unloads the selected music; DEFAULT447F12..447F45 restarts it
when control returns. The runtime now performs that handoff. Source-byte/director
checks and actual SDL dummy streams verify silence through all16 lab cues, normal
completion restart, reset silence and skip restart. See analysis/sound-effects.md.
Both platform executables were republished with this correction. The packaged
Linux and isolated Wine64 Windows executables pass the full music-lifecycle audio
check. Linux packaged prompt/input/resize still passes with zero Vulkan validation
errors. Native Windows listening remains unverified by the agent; source user
report and exact static rules support this fix.
An additional managed replay now walks through explanation, jet pack, Carl and
outside LOAD using only movement inputs, source live contacts and NPC patrol/body
updates. It reachesSCENE60/score150 with jet pack owned after888 movement steps
and7100.55 travel; the player is never repositioned. This strengthens port lab
navigation coverage without proving original collision/cadence fidelity.
## 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 has36 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 at c929f94:35 Python regressions,2 targeted UI
checks, all managed groups, GPU story/route/practice/VR04 replays, SDL dummy streams
and539 unchanged original hashes. The subsequent music correction passes targeted
source-byte/director/SDL audio checks on both packages, plus native Linux window
and input-only managed navigation regressions; hashes were reverified.
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.