Files
Neutron/docs/tasks.md
T

204 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.
- [x] Requested F1 General/Player/Systems pages, F3 noclip with cutscene flight,
motion/input capture, entry restoration, movement/camera/audio/UI/TSK controls;
full suite plus native Linux1920x1080 SDL regression pass. See debug-menu.md.
## Immediate continuation
**Current direction: user-requested gameplay gadgets; collision work parked.**
Preserve35a2a66 body implementation,0272f7b release notes and baseline69d0187.
Recover/implement original gadget selection/use with local REA and original art;
extend the existing shrink-ray/jetpack device first where source contracts permit.
Current investigations own named files in docs/gameplay/, with runtime integration
owned by primary. Remaining special/dynamic collision and camera gates below are
the resume backlog, not prerequisites imposed on this user-directed gadget work.
- [x] Recover original gadget group0 selection, mode/display separation, ownership,
practice destinations and exact UI resources with local REA evidence.
- [x] Implement widescreen gadget screen, strict pointer regions, Tab/Space latch,
selection/input capture and direct Practice entry.
- [x] Implement owned default ray, original quantized target heading/obstruction,
texture phases, half opacity and tested alpha/additive Vulkan materials.
- [x] Render actual VR04 soldiers with original WALK/SHRINK morph, source timer,
authored-mode restoration and persistent ordinary10-point score callback.
- [x] Managed/source/GPU checks and native Linux menu/ray input fixtures.
- [x] Rebuild clean7b5230c Linux/Windows gadget packages, verify54 canvases/new
manifests in both, and run standalone Linux menu/ray fixtures from /tmp.
- [x] Invisible source, timed activation/recharge/flash, original meter, companion
body/visibility and named-Jimmy cutscene cleanup; shared energy warning lifecycle.
- [x] Independent review,182 Python/15 Invisible managed groups, native Linux SDL
six-phase render at1920×1080; complete integration30 GPU+17 material checks pass.
- [x] Build clean1897dd2 Invisible Linux/Windows packages, check exact meter pixels
in both and standalone Linux six-phase/F1 widescreen renders from /tmp.
- [x] Recover Bubble visual/equip/drain/cleanup source contracts with REA/guards.
- [x] Recover Bubble movementmode2 input/apply, direct300/900 bounce, actualVR01
static/floor111 coverage and six copied-original body numeric references.
- [x] Implement original Canv1/effect/motion and boundedVR01 body/floor state;
13 integration/11 motion/8 visual groups and independent review pass.
- [x] Complete202 Python+2 HUD, managed,31 GPU+17 material and native1920×1080
SDL Bubble checks;539 original hashes unchanged.
- [x] Commit clean1ae5f42 Bubble milestone, rebuild Linux/Windows packages, verify
exact Canv1 pixels in both and standalone Linux gameplay/debug view from /tmp.
- [x] Recover Baseball equip/hold/release, owned20-slot pool, queued landing
impulse, exact original TIME font and VR07 moving-target/parent contracts.
- [x] Implement Baseball, original ball/aim rendering, F1 grant, bounded VR07
source body/targets, eleven integration/six visual groups; independent review.
- [x] Headless and native1920×1080 actual SDL aim/release/target-hit/respawn pass;
1010 extra complete player/target ticks are an explicit accelerated port fixture.
- [x] Complete232 Python+2 HUD/all managed/32 GPU+17 material regression; final
12-group Baseball callbacks and16 source groups pass;539 original hashes verify.
- [ ] Clean Baseball Linux/Windows package validation.
- [x] Save Scooter separate actor/mount/vehicle and original asset contracts;
wheel body/support lifecycle remains a gate before faithful live integration.
- [ ] Rocketship, Scooter, Remote and Grappler; full enemy AI and
original/native Windows comparison. Retain collision/camera/retained-helper gates.
Details: [Baseball continuation](gameplay/baseball-implementation.md). Investigators
have returned all file ownership to primary. Complete final regression, native
Linux input and release checks pass; the remaining gadget effects are the next
gameplay backlog. Native Windows gadget verification remains open.
**Prior direction: architecture checkpoint and evidence-led implementation.**
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.
- [x] Bounded retained mode/hold/fire route fixture through property/Init/PostLoad/
cleanup/control; authored/live body provenance and isolated original routines.
- [x] Full tutorial gadget re-enable tails and LV1B item1/7 restrictions; replaces
previous prefix-only availability. Other level tails/selection remain open.
- [x] Companion/shadow reset trace and equal-state AI guard; no blanket AI carry.
- [x] Bounded uncontrolled body/fire versus controlled movement, ordered CAM/MCA/
AI preparation, no repeated later-shot reset, held input restoration and authored
player-transform synchronization; managed/GPU/native Linux checks.
- [x] Local REA6.8.0/Ghidra12.1.4/full JDK21 launcher, selected native pseudocode
Evidence/snapshot export; client MCP configuration unchanged. See rea.md.
- [x] C4 bounded sphere/triangle kernel recovered with REA and isolated original
component references; explicit managed kernel and regressions added. Live adapter
replacement remains gated on traversal, callbacks, support and friction.
- [x] Root+150 upward query/bounce/mode1 cancellation traced and integrated for
the three route scenes, independently of raw control and camera debug switch.
- [x] Retained physical re-registration/repeated Init chain and shared camera-eye
handoff documented with byte guards and retained REA successes/provider gaps.
- [x] C4 static grid/retry dispatcher recovered and isolated managed component
compared against seven original fixtures; route material IDs and metadata gate.
- [x] Contact/landing/published-speed/friction contracts and actual special material
coverage recovered with REA. Ten isolated original body fixtures completed.
- [x] C4 ordinary body composition matches ten numeric references; VR04 uses the
recovered static subset with source radius/support/friction and published speed.
Twenty managed groups and native/headless powered-flight replays pass.
- [ ] Next: C4 original dynamic actor/pair eligibility and shared reclip context;
special160/164/FENCE/LADDER contact policies before lab/outside replacement;
full Jimmy/base wrapper/helper traversal and shared viewport/DEFAULT handoff.
Physical re-registration chain is recovered; full implementation/order remains.
C6 source channel allocation/
clock/banks remains separate. Fire's missing Ghidra procedure definition is an
analysis limitation; its immutable source-byte contract is already guarded.
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.