Files

65 lines
13 KiB
Markdown

# Remaining Reconstruction Feature Landscape
**Project:** Neutron GamePort
**Reviewed:** 2026-11-12
**Scope:** Remaining full reconstruction, with original fidelity governing scope and acceptance.
## Evidence and interpretation
This is a local specification/report review, not a new binary investigation, build, runtime capture or independent validation of historical receipts. The user's full-reconstruction and maximum-accuracy requirements are explicit. Capability and gap statements below are attributed to repository reports; their exact revision/platform/fixture boundaries remain binding. Older narratives in long reports do not supersede later completion entries. The GSD `classify-confidence --provider local --verified` seam returned LOW because this provider has no curated classification; that label applies to this review's provider classification, not a downgrade of separately recorded original instruction/probe evidence.
Read the current [project context](../PROJECT.md), [current concerns](../codebase/CONCERNS.md), [progress](../../docs/progress.md), [tasks](../../docs/tasks.md), [coverage ledger](../../docs/checkpoint/coverage.md), and [authoritative specification](../../../prompt.MD) together. Treat all remaining-original functionality as required; this is not a market-feature selection exercise.
## Required feature categories
| Category | Existing bounded capability | Remaining reconstruction target | Complexity / acceptance evidence |
|---|---|---|---|
| Jimmy controls and movement | Recovered ground/air acceleration, facing, jump/hold/gravity components and fresh/retained order; native Linux input routes | Close remaining body/contact, mode/facing persistence and animation interactions; preserve original quirks and significant float stores; establish original timing rather than assuming fixed 60 Hz proves parity | High. Original-derived full-state trajectories plus original/port input replays at differing presentation rates; no speed-up from refresh rate |
| Physical world and contacts | Sphere/static kernels, bounded source bodies, ordered pair and normal-response components; lab/outside compatibility capsule | Actual physical registry membership/activation/removal, retained helpers, callback mutations, shared dynamic/static reclip, special hazard/FENCE/LADDER paths, complete derived actor policies | Very high. Complete ordered state/event traces, successful special-contact cases and bounded live scene admission after dependencies close |
| Animation, scripts and control | Original morph assets; CAM/MCA/AI lab chains, natural/skip and TSK story-entry correction | Full action acceptance, animation timing/completion/interruption and script dispatch across characters/scenes; control and body/effect clocks remain independent | High. Compare original action/event/pose sequences, including banked entry, skip/natural return, held input and repeated transitions |
| Cameras and original input | Authored and follow cameras, bounded static camera collision, corrected orbit; SDL keyboard/window handling | Shared scripted/follow viewport state and DEFAULT handoff, full clipping/state policy, source-supported mouse/relative/analog behavior and controller behavior if evidenced | High. Compare eye/target/projection/input state through first resumed frame; verify focus, fullscreen, resize and high-DPI mapping without distorted presentation |
| Actors, enemies and combat | Lab props/patrol subset, source-body components, bounded target/soldier responses | Complete actual class behaviors, sensing, follow, action selection, RNG-dependent policies, damage/health/death/recovery, combat effects and any original difficulty/win/loss rules | Very high. Real derived responses and complete interaction side effects; generic patrol or synthetic callback injection does not prove AI parity |
| Gadgets, vehicles and inventory | Shared selection/energy, ray/jetpack, Invisible, Bubble VR01, Baseball VR07, Rocketship VR02, Grappler VR08 and Scooter VR05/LEV1 | Complete remaining gadgets including Remote; all original intended consumers/scenes, dynamic interactions, mission/hazard policies, retained LOAD/helper/save lifetime and supported input modes | Very high. Inventory earned through normal progression and each intended use exercised without F1 grants or fixture-only shortcuts; current bounded live features remain preserved |
| Levels, tasks and progression | All 35 supplied GAMs parse; 33 have scene geometry; lab → practice → RETURN → outside route and task/score effects | Original reachable campaign, class-specific triggers/objectives/collectibles/NPCs, level-specific mechanics, entrances/exits and final progression outcomes | Very high. Fresh NewGame-to-ending route evidence, intermediate checkpoints and branch/optional content matrix; direct scene selection is not reachability |
| Menus, HUD and configuration | Objective/practice/gadget art and bounded logic; user-authorized modern diagnostics; native window/session handling | Original player-facing frontend, options/configuration persistence, complete HUD/objective flags, cursors/highlights, source-supported input and pause transitions | High. Original screens and modal/input/timer behavior compared; debug menus are test tools, not original frontend completion |
| Save/load and retained state | All 12 supplied TSKs byte-round-trip; tasks/items/RETURN departure-root CLI and carried snapshots | Complete runtime saving/loading and repeated callback semantics, unknown field meanings needed by gameplay, menu integration, arbitrary supported resume, correct fresh/retained/reset ownership | High. Save before/after meaningful interactions and reload to equivalent gameplay state while preserving unknown/raw fields; TSK round-trip alone is insufficient |
| Geometry, animation art and rendering | Original scene/models/morphs/textures, Vulkan material support and GPU/native Linux checks | Original fixed-function equivalents, per-layer lighting/fog/blend/depth/cull/texture states, sprite pivots, full actor root/hierarchy and morph playback fidelity | High. Matched-camera original/port captures, dynamic-state comparisons and documented differences; no pixel-perfect claim from port-only readbacks |
| Audio | Independent music/speech/effects streams, cutscene music stop/restart, default pickup/button/door sounds, some vehicle positional frequency | Full contextual banks, source channel/voice allocation and clocks, volume/pan/attenuation, loops, jetpack and remaining actor effects, encoded resource playback and physical output | High. Matched event/time/listener captures plus audible Linux/Windows verification; dummy-stream lifecycle tests remain narrower |
| Cross-platform release | Shared .NET 10/Vulkan 1.3+/SDL3 runtime; local Linux/Windows publishes and package provenance | Current complete-game packages validated natively on both targets, startup/input/audio/window/resource cleanup and practical driver coverage; offline runtime and reproducible local packaging | High. Standalone native Linux and Windows runs of the same clean source checkpoint and resources; cross-publish/Wine are separate preliminary evidence |
| Original comparison and preservation | 539-original manifest, byte guards, isolated original probes and port regression fixtures | Working copied-original reference captures, systematic discrepancy register, per-system tolerance rationale, integrated whole-game comparison and verified original hashes | Very high. Identify exact reference/port revision, route, input, clock, state and platform; preserve raw evidence locally and distinguish inference from runtime observation |
## Specific boundaries that must shape requirements
- The Carl first-neutral-tick bank has a supported TSK story-entry ordering correction. Preserve it and fresh direct-scene order. Ordinary landing residual bank is user-confirmed original behavior; do not introduce universal leveling. Whole-original Carl comparison remains open. See [menu/player lifetime](../../docs/gameplay/main-menu-player-lifetime.md) and [movement stabilization](../../docs/gameplay/jimmy-movement-stabilization.md).
- Pair/normal components are not a complete live physical world. Soldier complete174 RNG/action effects, helper cleanup/activation across LOAD/RETURN and real enter/stay/leave task consumers remain dependencies. Keep Jimmy ordinary374 separate from inherited reflection and read callback-mutated fields at original times. See [normal contacts](../../docs/checkpoint/actor-normal-contacts.md), [registration](../../docs/checkpoint/physical-registration.md), [populated reclip](../../docs/checkpoint/dynamic-reclip.md).
- The independent pickup checkpoint is not the TSK transition-departure root. Save-field preservation must not invent respawn behavior. See [save format](../../docs/save-format.md) and [runtime checkpoint](../../docs/analysis/runtime-checkpoint.md).
- Level3B and Level3E GAMs exist; their OMT archives are absent. Normal gameplay reachability is unverified, so do not declare missing files a campaign blocker, substitute geometry or request files merely from registry membership. Resolve actual reachable content through evidence. See [level-resource mapping](../../docs/analysis/level-resource-mapping.md).
- Some older task lines still call already-live Grappler/Scooter unimplemented. Use [Grappler live](../../docs/gameplay/grappler-live.md), [Scooter live](../../docs/gameplay/scooter-live.md), [Rocketship live](../../docs/gameplay/rocketship-live.md) and [Baseball implementation](../../docs/gameplay/baseball-implementation.md) as their bounded capability records.
- Bird1/id162 retains MPEG Layer3-in-RIFF data and is unsupported by the documented SDL WAV path; do not silently substitute audio. Bank/channel/attenuation policy remains incomplete. See [sound effects](../../docs/analysis/sound-effects.md).
## Dependency order for roadmap construction
1. Establish a usable original-reference comparison route and evidence/discrepancy matrix early. Continue source-backed work when a runtime reference is unavailable, but preserve the outstanding fidelity gate.
2. Finish movement/contact/animation/camera and retained registry/helper contracts; prove the lab → VR04 → lab → outside route as one interacting system before new gameplay expansion.
3. Expand real actor responses, hazards/combat and gadget consumers on that foundation, preserving current bounded features and explicit scene admission.
4. Complete campaign tasks, level-specific systems, frontend and save/resume in playable slices. Unknown reachability, task consumers and saved state require phase-specific recovery.
5. Complete visual/audio behavior alongside supported gameplay slices; do not defer all comparison until release, because presentation clocks and camera/input ownership affect gameplay.
6. Validate the full campaign and supported optional content against original evidence on native Linux and native Windows, then produce local clean packages and a discrepancy audit.
This order is an integration recommendation, not a claim that every system must be fully recovered before any bounded change. Rendering/audio investigations can proceed independently with exclusive ownership; gameplay expansion remains behind the current movement gate.
## Differentiators and explicit exclusions
No new competitive features are proposed. Fidelity to the original is the defining value. Preserve existing user-authorized diagnostics and modern platform support, but keep them separate from original gameplay claims. Exclude invented story/mechanics, replacement movement tuning, PBR/visual redesign, online services, telemetry, cloud CI, and original/generated-package uploads.
## Completion targets
- One faithful playable scene is an intermediate milestone, followed by all original reachable content and progression; loading all assets is not a playable-game criterion.
- Every feature has separate recovery, implementation, component-test, integrated-runtime and original-comparison status, with paths to evidence and known approximations.
- Expected results come from authoritative original instructions/data/execution and working-original observation where available; port outputs cannot be their own fidelity oracle.
- Native Linux and native Windows packages identify the same verified source/resources; original hashes remain unchanged; unresolved discrepancies remain visible and prevent unsupported full-fidelity claims.
## Sources
All source links above are local project evidence. Additional integration references: [next-work plan](../../docs/checkpoint/next-work-plan.md), [implementation plan](../../docs/checkpoint/implementation-plan.md), [compatibility](../../docs/compatibility.md), [presentation/UI](../../docs/presentation-and-ui.md), [graphics recovery](../../docs/analysis/graphics.md), [rendering](../../docs/rendering.md). Rendering and task reports contain historical entries; consult current progress and feature-specific completion reports before treating an older gap as current.