Files
Neutron/docs/tasks.md
T

315 lines
22 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 priority: stabilize Jimmy's ground/air input, facing, jump/landing,
body/contact response and route/control transitions before more gadgets. Keep
our movement baseline; JN-Engine is an original-code index, not a movement model.
See gameplay/jimmy-movement-stabilization.md for bounded evidence/verification gates.
- [x] Jimmy controller arithmetic/facing checkpoint: source ground/air components,
shared keyboard latch, control-independent full-axis facing, exact jump hold and
gravity intermediates.108 saved original component observations match managed
checks. Capsule compatibility remains explicit; broad collision is not complete.
- [ ] Next Jimmy chunk: source ordinary-air destination pitch/roll and retained
mode fields together with the actor-root visual bridge.12 original target writes
are recorded; do not silently enable physics tilt without matching presentation.
- [ ] Then verify root-changing contact publication, world-response/integration
flags, successful fence/ladder completion, hazard/impulse and dynamic eligibility
before replacing the lab/outside capsule.27 dispatch cases establish eligibility
only; the unfinished successful-climb harness remains ignored investigation work.
- [x] Scooter feedback: Goddard gradually levels pitch/roll after tilted dismount;
engine uses missing source positional frequency/history correction.13 Scooter,
2 audio,10 Patrol and24 Python groups plus native input replays pass. See
gameplay/scooter-dismount-leveling.md and scooter-pitch.md. Audible/native
Windows comparison remains open; the recovered nominal engine formula stands.
- [x] Bounded liveVR08 Grappler: shared body context/full base callback, follow
camera, original rope/SWING/cursor/audio, ownership/RETURN/retained scalars,
normal/debug selection.13 managed groups/40 Python checks and9-phase native
Linux SDL replay pass. See gameplay/grappler-live.md for evidence and limits.
- [ ] Native Windows and whole-originalVR08 comparison; shared dynamic pairs,
special policies/other levels and non-RETURN attachment continuity remain open.
- [x] Scooter source wheel/support/contact recovery and bounded live VR05/LEV1:
separate vehicle, real4-wheel supports, normal owned-tile outside use, source
drive/impact/camera/pose/audio, summon/contact mount/cleanup and RETURN.53 native
component observations, managed integration and10-phase Linux SDL replays pass.
See gameplay/scooter-live.md; preserve parked general collision continuation.
- [ ] Scooter whole-original/native Windows comparison; mouse/analog/camera
modes2..20, special mission helpers, general dynamic pairs and retained LOAD/
save lifecycle remain open. Other levels require evidence before enabling.
Historical Grappler gates below were closed for boundedVR08 by this checkpoint;
component reports remain evidence, not current live status.
- [x] Grappler aim/root-Euler ray/first-hit material, normalized constraint and
post-base contact:42 additional original cases,72 total/10 managed/18 Python;
actualVR08 query and existing camera/Rocketship/GPU regressions pass.
- [x] Grappler live gates: carry shared sphere/contact context through attached
47B4B0 and43AA40; complete follow camera and rope/cursor presentation/lifetime,
then actualVR08 attach/reel/swing/detach/control-loss/RETURN. See grappler-query.md.
- [x] User-clarified orbit Left/Right inversion: reverse horizontal azimuth
mapping while preserving correct Up/Down and gameplay controls.
- [x] Grappler isolated attachment/reel/damping component:30 copied-original
observations,5 managed/14 Python checks plus25 movement/15 gadget groups pass.
- [x] Grappler next: complete retained REA/source findings from
artifacts/grappler-{ray,motion,resources}/, close body/camera/helper contracts
and compare original components before enabling boundedVR08. Investigators
reached usage limits; all file ownership returned to primary.
- [x] Correct orbit inspection's mirrored world: share gameplay handedness,
verify36 angle/elevation/aspect cases, GPU reflection and unchanged gameplay.
- [x] Correct user-reported Rocketship wall scaling: recover material RGBA
consumer, replace geometry deformation with red damage flash, regress actual
wall contact/per-vertex geometry/color through repeated impacts and expiry.
- [x] Live boundedVR02 Rocketship: source aircraft callbacks/support, owned actor
control, fresh/retained input order, maneuvers/camera, exact passenger/fire art,
engine audio, F1, cutscene/force-control/reset/noclip and distinct pickup/LOAD callers.
- [x]96 isolated original observations;14 flight/12 final integration groups;
native GTX1070/private Xvfb1920×1080 ten-phase SDL replay; full268 Python+2 HUD/
managed/33 GPU+17 material suite and539 unchanged original hashes.
- [x] Clean e77add5 Linux/Windows packages,18 resource files/four exact RGBA hashes;
standalone Linux ten-phase native replay and1920×1080 F1 Player-page readback.
- [ ] Rocketship outside VR02, special hazard/mission/RNG effects, general original
pair scheduling and full original/native Windows comparison. See live report.
- [x] User-requested F1→Player Give All Gadgets: grant all eight without selecting,
preserve other inventory, keep the32-line layout; debug-menu checks/build pass.
**Gadget component checkpoint2026-11-03:**
[Rocketship arithmetic/resources](gameplay/rocketship-component.md).
- [x] Use supplied decompiler leads with independent REA/source guards for
Rocketship owner/control/body dimensions, flight input/apply and VR02 filter.
- [x] Implement isolated keyboard/vertical components;13 managed groups compare
14 input+14 vertical copied-original observations and explicit boundaries.
- [x] Export exact Rocketship resources/VR02 records with5 checks; recover
Grappler attachment/material/swing/lifetime source with12 checks. Rocket source
3 checks, existing Gadget15/Movement25 and .NET10 build pass;539 hashes verify.
- [x] Close ordinary VR02 Rocketship callbacks, Euler/maneuver/camera and
owned/GAM reset/attachment gates; integrate actual art/audio, F1 and live control
with source RETURN/cutscene ownership regressions. General pair/lifetime remains bounded.
- [x] Close boundedVR08 Grappler ray/material context, attached dispatcher/camera/Euler and
helper lifetime before live mode7. No substitute hook/pull behavior.
Historical component-only claims are superseded for liveVR02 Rocketship and
liveVR08 Grappler. Scalar/query reports remain component evidence, not current
feature status; see gameplay/grappler-live.md.
**Supplied friend's decomp assessment completed2026-11-03.**
See [assessment](reviews/jn-engine-survey.md), independent gameplay/capture
reviews and the prepared local evidence request. No source import or gameplay
change. Same EXE/shared corpus, different declared OMT2.dll;208 class specs and
saved helper bodies are useful leads, prototype C gameplay is not authoritative.
For subsequent gadget work, cross-check target6's429D00/426A70 and Rocketship
report with local REA. Raw original traces, analysed Ghidra project, capture DLL
identity and offered code permission remain open; do not treat proposals as
delivered runtime evidence. Preserved port/release validation is unchanged.
**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.
- [x] Clean d6ca417 Linux/Windows packages, all16 source canvas hashes in both,
standalone Linux eight-phase gameplay and widescreen F1 Player view from /tmp;
539 originals verify after packaging. Native Windows comparison remains open.
- [x] Save Scooter separate actor/mount/vehicle and original asset contracts;
wheel body/support lifecycle remains a gate before faithful live integration.
- [ ] Rocketship other-level/special consumers, Scooter, Remote and live 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.