Files
Neutron/docs/tasks.md
T

119 lines
8.1 KiB
Markdown

# Tasks
Full-game completion remains the objective. Original files are authoritative;
compile, runtime and original-fidelity verification are separate.
## Integrated milestones
- [x] Inventory/hashes, binary/API identification, full GAM round-trip and OMT audit.
- [x] .NET10/SDL3/Vulkan1.3 shared native code and self-contained platform packages.
- [x] Original lab geometry, corrected Jimmy atlas, original morphs and inspection.
- [x] Walking/jumping/chase camera and source-triangle provisional collision.
- [x] Linux headless/window/input/resize/audio-stream checks; initial native Windows
rendering user-confirmed; preliminary Wine64 movement package checks.
- [x] Original TSK/task gates/checkpoint CLI and independent music/speech streams.
- [x]16-cue lab camera/speech/actions/control restoration and skip execution.
- [x] Source actor/sprite/model preparation,9 lab props and all33 available scenes.
- [x] B/E GAM correction: both supplied; missing registered OMT geometry is not an
established progression blocker. No substitution or extra-file request.
- [x] Lab jet pack/Carl/exit task route and objective/inventory/score effects.
- [x] Original objective/practice art, strict input regions, modal pause and VR04 entry.
- [x] Shared Goddard/Carl patrol subset and recovered body support with DLL checks.
- [x] Button/vertical-door behavior and source dynamic broadphase/box triangle rules.
- [x] Powered-jump state/effect/energy arithmetic, original FLY/fire morphs and GPU replay.
- [x] Correct mode1 input dispatch and source airborne steering for jumps/bursts;
Up acceleration, Down braking, Left/Right turn and powered travel regressions.
- [x] Carl conversation control lock, grounded air-turn reset, original level far
planes and timed objective/O behavior. Full suite passes; both packages rebuilt;
user verifies their own Windows build works. Detailed evidence: progress.md.
- [x] Source RETURN departure-root/TSK identity, player/companion restoration and
one-time STRT suppression; source NC-shape terrain exclusion; input-only
underground passage both ways from explicit riverlab/SCENE65 fixture.
- [x] User-requested F1 debug menu with diagnostics, paused audio/gameplay,
camera/cutscene/energy/jetpack/task/scene/start/reset controls and input capture.
- [x] Force Control TRUE/FALSE override in F1; persists through scripted shots,
restores authored ownership when disabled, clears on reset/new scene.
- [x] F2 live diagnostics plus F1 visibility toggle; non-pausing compact overlay,
measured frame timing and session-owned visibility across scene rebuilds.
- [x] Application-owned window/Vulkan renderer across loads; bounded scene
replacement and native fullscreen/bounds/focus retention checks.
- [x] Uniform widescreen game/debug UI with anchors and matched native pointer
mapping, strict boundaries and high-DPI rounding checks.
## Immediate continuation
**Direction changed: pause feature expansion for the architecture checkpoint.**
Read `checkpoint/README.md`, `coverage.md` and `implementation-plan.md`. Preserved
baseline69d0187 remains the testing tool. The loop/motion, script/state and
camera/audio/UI investigations document the original lab→VR04→lab→outside route.
Complete core owner/order/lifetime evidence and unknowns, then execute the gated
plan in verified chunks. Earlier priorities below are a backlog.
- [x] Preserve clean playable source tag and independent Linux/Windows package copies.
- [x] Verify539 unchanged originals at checkpoint entry.
- [x] Recover frame-before-controller physics and construction-order registry passes.
- [x] Record core-system coverage, state ownership, assumptions and bounded plan.
- [x] Integrate independent reports/original-byte regressions; architecture exit review.
- [x] C1 objective-before-records order; managed and full integration checks pass.
- [x] C2 per-actor Carl override; full integration and route checks pass.
- [x] C3 input/frame/fresh construction, C5 grid predicate, C6 software voice clock
and C7 ordinary selective-loader evidence follow-ups.
- [x] Old level-game lifetime resolved: normal Init restores stored+11→live+139;
ordinary destructor explicitly unlinks its registry node.
- [x] Controlled player phase split and retained input order; delayed impulses,
stored movement mode and same-frame landing reset. Full-scene scheduler open.
- [x] Static first-hit camera adapter integrated for LV1B/VR04/LEV1 with shared
segment kernel and source hit weighting/gain. Full camera handoff/state open.
- [x] Source PostLoad gadget availability through tutorial/normal level entry.
- [ ] Next: retained mode/fire/body reset fixture through the full property/control
callback chain, remaining scene callback/morph phases, shared viewport/DEFAULT
handoff and C4 collision. C6 source channel allocation/clock/banks remains separate.
1. Lab regressions are corrected and republished, with user verification of their
own Windows build. Keep comprehensive native Windows driver/audio/input
coverage separate from that report and preliminary Wine checks. Continue
original physics/audio/UI recovery and progression beyond the outside checkpoint.
2. Managed input-only lab navigation now reaches the outside LOAD with live source
contacts and NPC updates. Keep the direct-contact smoke distinguished from this
replay. User confirms lab/tutorial/lab/outside is reachable. Underground passage
now passes from explicit riverlab/SCENE65 fixture; recover actual progression
into that task state and extend input coverage to later scenes. RETURN uses
the recovered TSK departure root. Find consumers of independent42AF00
+1E38/+1E48 checkpoint separately; do not conflate the two again.
3. Recover47BD80 collision response/479D20 movement phase and source object exclusions.
Support trace/magnitude/radii/factors and dynamic broadphase are recovered;
wall response, Jimmy capsule/visual pivot, stairs and camera obstruction remain
modern approximations. Preserve source normals and invisible proxy geometry.
4. Complete contextual SFX bank switching, source volume/pan/attenuation/channel
policies, jetpack sound callbacks and MPEG-in-RIFF bird1/id162 decoding. Default
SoundEffects.omt identity and pickup/button/door stream lifecycle are integrated;
physical/native Windows output and original timing remain unverified.
5. Complete practice highlights/cursor/controller handling and energy/gadget UI.
Objective slide/timeout/O behavior is now recovered and integrated.
6. Recover Carl sensing409CC0, Goddard follow-state4, actor class defaults and full
morph state/playback-end synchronization. Generic patrol states alone are not AI.
7. Recover original global cadence/object phase order, mouse steering/relative input,
exact clipping/fullscreen/focus/scaling behavior and material/fog/light/blend states.
## Full reconstruction and verification
- [ ] Working original gameplay captures and physics/input/render/audio comparisons.
- [ ] One complete, source-faithful playable scene including navigation and transitions.
- [ ] All inventory/gadgets, health/damage, enemies/combat, scoring and win/loss behavior.
- [ ] All levels, class-specific triggers/AI and full original progression.
- [ ] Menus, cutscenes, configuration and complete runtime save/load.
- [ ] Original render-state, animation, lighting/fog/alpha and camera fidelity.
- [ ] Speaker output, positional mixing, original timing and native Windows audio.
- [ ] Native Windows input/resize/story/driver validation of the current build.
- [ ] Verified Linux/Windows release packages and documented remaining discrepancies.
## Commands
From GamePort: `source scripts/env.sh`, `dotnet build`, `scripts/test.sh`.
`scripts/package.sh` rebuilds local packages. `NEUTRON_WINDOW_TEST=1 scripts/test.sh`
adds window checks with a working DISPLAY. `tools/recon/reference_capture.py`
executes copied originals/generated probes in an isolated local harness.
Verify preservation using `python3 tools/recon/inventory.py ../Original --verify
docs/original-manifest.json`. No remotes/uploads/cloud work. Check Git status and
exclusive file ownership before edits; all prior agent ownership returned to primary.