Files
Neutron/docs/tasks.md
T

16 KiB
Raw Blame History

Tasks

Full-game completion remains the objective. Original files are authoritative; compile, runtime and original-fidelity verification are separate.

Integrated milestones

  • Inventory/hashes, binary/API identification, full GAM round-trip and OMT audit.

  • .NET10/SDL3/Vulkan1.3 shared native code and self-contained platform packages.

  • Original lab geometry, corrected Jimmy atlas, original morphs and inspection.

  • Walking/jumping/chase camera and source-triangle provisional collision.

  • Linux headless/window/input/resize/audio-stream checks; initial native Windows rendering user-confirmed; preliminary Wine64 movement package checks.

  • Original TSK/task gates/checkpoint CLI and independent music/speech streams.

  • 16-cue lab camera/speech/actions/control restoration and skip execution.

  • Source actor/sprite/model preparation,9 lab props and all33 available scenes.

  • B/E GAM correction: both supplied; missing registered OMT geometry is not an established progression blocker. No substitution or extra-file request.

  • Lab jet pack/Carl/exit task route and objective/inventory/score effects.

  • Original objective/practice art, strict input regions, modal pause and VR04 entry.

  • Shared Goddard/Carl patrol subset and recovered body support with DLL checks.

  • Button/vertical-door behavior and source dynamic broadphase/box triangle rules.

  • Powered-jump state/effect/energy arithmetic, original FLY/fire morphs and GPU replay.

  • Correct mode1 input dispatch and source airborne steering for jumps/bursts; Up acceleration, Down braking, Left/Right turn and powered travel regressions.

  • 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.

  • 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.

  • User-requested F1 debug menu with diagnostics, paused audio/gameplay, camera/cutscene/energy/jetpack/task/scene/start/reset controls and input capture.

  • Force Control TRUE/FALSE override in F1; persists through scripted shots, restores authored ownership when disabled, clears on reset/new scene.

  • F2 live diagnostics plus F1 visibility toggle; non-pausing compact overlay, measured frame timing and session-owned visibility across scene rebuilds.

  • Application-owned window/Vulkan renderer across loads; bounded scene replacement and native fullscreen/bounds/focus retention checks.

  • Uniform widescreen game/debug UI with anchors and matched native pointer mapping, strict boundaries and high-DPI rounding checks.

  • 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

Gadget component checkpoint2026-11-03: Rocketship arithmetic/resources.

  • Use supplied decompiler leads with independent REA/source guards for Rocketship owner/control/body dimensions, flight input/apply and VR02 filter.
  • Implement isolated keyboard/vertical components;13 managed groups compare 14 input+14 vertical copied-original observations and explicit boundaries.
  • 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.
  • Close Rocketship aircraft callbacks, normal Euler/slip/roll/camera and owned-versus-GAM property/reset/helper/attachment gates; then integrate bounded VR02 vehicle ownership, actual art/audio, F1 and live control/RETURN checks.
  • Close Grappler ray/material context, attached dispatcher/camera/Euler and helper lifetime before live mode7. No substitute hook/pull behavior.

No live Rocketship/Grappler or new package claim; d6ca417 remains playable baseline.

Supplied friend's decomp assessment completed2026-11-03. See assessment, 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.

  • Recover original gadget group0 selection, mode/display separation, ownership, practice destinations and exact UI resources with local REA evidence.
  • Implement widescreen gadget screen, strict pointer regions, Tab/Space latch, selection/input capture and direct Practice entry.
  • Implement owned default ray, original quantized target heading/obstruction, texture phases, half opacity and tested alpha/additive Vulkan materials.
  • Render actual VR04 soldiers with original WALK/SHRINK morph, source timer, authored-mode restoration and persistent ordinary10-point score callback.
  • Managed/source/GPU checks and native Linux menu/ray input fixtures.
  • Rebuild clean7b5230c Linux/Windows gadget packages, verify54 canvases/new manifests in both, and run standalone Linux menu/ray fixtures from /tmp.
  • Invisible source, timed activation/recharge/flash, original meter, companion body/visibility and named-Jimmy cutscene cleanup; shared energy warning lifecycle.
  • Independent review,182 Python/15 Invisible managed groups, native Linux SDL six-phase render at1920×1080; complete integration30 GPU+17 material checks pass.
  • Build clean1897dd2 Invisible Linux/Windows packages, check exact meter pixels in both and standalone Linux six-phase/F1 widescreen renders from /tmp.
  • Recover Bubble visual/equip/drain/cleanup source contracts with REA/guards.
  • Recover Bubble movementmode2 input/apply, direct300/900 bounce, actualVR01 static/floor111 coverage and six copied-original body numeric references.
  • Implement original Canv1/effect/motion and boundedVR01 body/floor state; 13 integration/11 motion/8 visual groups and independent review pass.
  • Complete202 Python+2 HUD, managed,31 GPU+17 material and native1920×1080 SDL Bubble checks;539 original hashes unchanged.
  • Commit clean1ae5f42 Bubble milestone, rebuild Linux/Windows packages, verify exact Canv1 pixels in both and standalone Linux gameplay/debug view from /tmp.
  • Recover Baseball equip/hold/release, owned20-slot pool, queued landing impulse, exact original TIME font and VR07 moving-target/parent contracts.
  • Implement Baseball, original ball/aim rendering, F1 grant, bounded VR07 source body/targets, eleven integration/six visual groups; independent review.
  • Headless and native1920×1080 actual SDL aim/release/target-hit/respawn pass; 1010 extra complete player/target ticks are an explicit accelerated port fixture.
  • 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 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.
  • 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. 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.

  • Preserve clean playable source tag and independent Linux/Windows package copies.
  • Verify539 unchanged originals at checkpoint entry.
  • Recover frame-before-controller physics and construction-order registry passes.
  • Record core-system coverage, state ownership, assumptions and bounded plan.
  • Integrate independent reports/original-byte regressions; architecture exit review.
  • C1 objective-before-records order; managed and full integration checks pass.
  • C2 per-actor Carl override; full integration and route checks pass.
  • C3 input/frame/fresh construction, C5 grid predicate, C6 software voice clock and C7 ordinary selective-loader evidence follow-ups.
  • Old level-game lifetime resolved: normal Init restores stored+11→live+139; ordinary destructor explicitly unlinks its registry node.
  • Controlled player phase split and retained input order; delayed impulses, stored movement mode and same-frame landing reset. Full-scene scheduler open.
  • Static first-hit camera adapter integrated for LV1B/VR04/LEV1 with shared segment kernel and source hit weighting/gain. Full camera handoff/state open.
  • Source PostLoad gadget availability through tutorial/normal level entry.
  • Bounded retained mode/hold/fire route fixture through property/Init/PostLoad/ cleanup/control; authored/live body provenance and isolated original routines.
  • Full tutorial gadget re-enable tails and LV1B item1/7 restrictions; replaces previous prefix-only availability. Other level tails/selection remain open.
  • Companion/shadow reset trace and equal-state AI guard; no blanket AI carry.
  • 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.
  • Local REA6.8.0/Ghidra12.1.4/full JDK21 launcher, selected native pseudocode Evidence/snapshot export; client MCP configuration unchanged. See rea.md.
  • 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.
  • Root+150 upward query/bounce/mode1 cancellation traced and integrated for the three route scenes, independently of raw control and camera debug switch.
  • Retained physical re-registration/repeated Init chain and shared camera-eye handoff documented with byte guards and retained REA successes/provider gaps.
  • C4 static grid/retry dispatcher recovered and isolated managed component compared against seven original fixtures; route material IDs and metadata gate.
  • Contact/landing/published-speed/friction contracts and actual special material coverage recovered with REA. Ten isolated original body fixtures completed.
  • 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.