Files
Neutron/docs/tasks.md
T

24 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

Execution order and acceptance criteria: next work plan.

  • Expand original lifecycle coverage:96 Carl contact,8 composed input/ controller/skip-prefix,48 task/objective and140 base/STOP cases; recover complete DEFAULT pseudocode through a mapped carrier. See gameplay/jimmy-cutscene-lifecycle.md.

  • Implement copied-original read-only launch/attach observation; verify actual Wine32 attach,928 samples and leave-running behavior. Three exact subject profiles have24 source anchors. Native Windows remains separate.

  • Capture the actual original Carl banked-entry/skip/neutral-return interval. Local Wine reaches MAIN with black frames and no Jimmy; the composed original routines do not establish a reset. Use the observer on a working copied original before changing gameplay. Preserve ordinary landing bank.

  • Current user direction: decompile the complete Carl skip-to-idle state lifecycle before further gameplay implementation. Preserve a2e89c6/dae13ac. Close original support/mode/turn/input/skip ownership and same-frame ordering; see gameplay/jimmy-cutscene-decompilation.md.

  • Reproduce the remaining post-skip bug with48 managed port traces: all24 fresh-order cases retilt, all24 retained-order cases stay upright. This is diagnostic evidence, not a source-justified scheduling or reset correction.

  • User airborne cutscene ENTRY tilt: reproduce and recover CAM/MCA current plus destination reset with dirty preserved; implement and verify20 original native cases, both player/input orders and native Carl handoff/resumption. See gameplay/jimmy-rotation-handoff.md.

  • Investigate landing-idle tilt: seven original-component trajectories retain neutral residual bank and active steering levels. No supported universal snap.

  • User confirms landing-idle residual bank also occurs in the original. Preserve it. The post-cutscene bank is a separate port bug; complete original frame comparison remains a fidelity gate for the skip path.

  • User feedback: restore original left/right turning animations and fix jetpack fire following pitch/roll as well as yaw. Source guards, visual/pose tests and native Linux rendering pass; see gameplay/jimmy-turn-fire-fixes.md.

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

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

  • Jimmy ordinary-air destination pitch/roll, retained apply-owned pitch seeds, destination/dirty Init, full authored Euler and logical-root rendering bridge. 12 target writes plus12 degree/14 hierarchical transforms compare against managed components. Sole alignment remains modern; final OMT decomposition precision is separate. See gameplay/jimmy-air-bridge.md.

  • Body callback publication/mode prerequisite: finite XYZW fresh equality, independent integration/support/collision/world/alternate modes, context lifetime and landing payload ownership.100 full native comparisons plus six callback state cases pass. Special callback/body admission remains gated; see checkpoint/body-contact-implementation.md.

  • Next verify successful fence/ladder completion, hazard/impulse, actor mode persistence/control/facing and dynamic eligibility before replacing the lab/outside capsule.27 dispatch cases establish eligibility only; the unfinished successful-climb harness remains ignored investigation work.

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

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

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

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

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

  • User-clarified orbit Left/Right inversion: reverse horizontal azimuth mapping while preserving correct Up/Down and gameplay controls.

  • Grappler isolated attachment/reel/damping component:30 copied-original observations,5 managed/14 Python checks plus25 movement/15 gadget groups pass.

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

  • Correct orbit inspection's mirrored world: share gameplay handedness, verify36 angle/elevation/aspect cases, GPU reflection and unchanged gameplay.

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

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

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

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

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

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