186 lines
13 KiB
Markdown
186 lines
13 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.
|
||
|
||
- [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.
|
||
- [ ] Close Bubble movementmode2/jump/body contract, then implement original sprite
|
||
effect and physics in a bounded tutorial. Other effects/full enemy AI and
|
||
original/native Windows comparison remain independent backlog.
|
||
|
||
Details: [first gadget slice](gameplay/gadgets-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.
|