Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
a8dc07f9fc | ||
|
|
dd7688bce9 | ||
|
|
7d56538d9f |
No files matched your search
@@ -0,0 +1,81 @@
|
|||||||
|
# Neutron GamePort
|
||||||
|
|
||||||
|
## What This Is
|
||||||
|
|
||||||
|
A faithful reconstruction of the original Windows 98 Neutron game for native Linux x64 and Windows 10/11 x64, using shared C#/.NET 10 code, Vulkan 1.3+ through Silk.NET.Vulkan, and SDL3. It preserves the original game's identity and reuses recovered original assets. The current project already implements substantial playable content; this planning effort covers the remaining full reconstruction.
|
||||||
|
|
||||||
|
## Core Value
|
||||||
|
|
||||||
|
Match the original game's behavior and presentation as accurately as possible, using original evidence and explicit verification to govern every reconstruction decision.
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
### Validated
|
||||||
|
|
||||||
|
These are existing capabilities with bounded evidence, not claims that the whole game or all platforms are verified. See `docs/progress.md`, `docs/compatibility.md`, and the linked investigation reports for exact revisions and limits.
|
||||||
|
|
||||||
|
- ✓ Shared .NET 10 runtime with Vulkan rendering and SDL3 window/input/audio — existing code and recorded native Linux checks.
|
||||||
|
- ✓ Original inventory and hash verification, bounded asset parsers, offline preparation and original-format GAM/TSK reading — existing tools and regressions; 539 originals comprise the recorded baseline.
|
||||||
|
- ✓ Playable lab/tutorial/outside content, script and cutscene execution, original-derived geometry, actors, HUD, music and speech — existing bounded routes and runtime checks; full original fidelity remains open.
|
||||||
|
- ✓ Recovered movement/body/collision components with isolated original-code comparisons — existing component evidence; physical registration, derived callbacks and broad live admission remain incomplete.
|
||||||
|
- ✓ Bounded implementations of several gadgets and vehicles — existing per-scene reports; broader actor interactions, levels and retained lifetimes remain open.
|
||||||
|
- ✓ Local Linux and Windows self-contained publishing and package provenance — existing scripts and recorded checks; Windows cross-publishing and Wine evidence do not establish complete native Windows compatibility.
|
||||||
|
|
||||||
|
### Active
|
||||||
|
|
||||||
|
- [ ] Close remaining Jimmy movement, body/contact, animation, camera and retained scene-state gaps while preserving verified baseline behavior.
|
||||||
|
- [ ] Recover physical registration, activation, helper cleanup, real actor responses and shared collision context before expanding live source solver admission.
|
||||||
|
- [ ] Complete original gameplay systems, gadgets, enemies/AI, damage, interactions and level-specific mechanics from authoritative evidence.
|
||||||
|
- [ ] Complete all original levels and progression, menus, configuration, save/load and fresh/retained/RETURN lifetimes.
|
||||||
|
- [ ] Match original rendering, materials, lighting, fog, transparency, animation, camera framing and UI behavior as closely as evidence permits.
|
||||||
|
- [ ] Complete original audio playback, banks, positional effects, timing, attenuation and lifecycle behavior.
|
||||||
|
- [ ] Establish repeatable original-versus-port comparisons, document discrepancies and resolve them in dependency order.
|
||||||
|
- [ ] Verify integrated gameplay and local release packages on native Linux and native Windows, retaining explicit evidence and remaining limitations.
|
||||||
|
|
||||||
|
### Out of Scope
|
||||||
|
|
||||||
|
- Creative reinterpretation, replacement movement tuning or visual modernization that changes the original identity — fidelity takes precedence.
|
||||||
|
- New gadgets or broader gameplay expansion before the current movement/route checkpoint closes — preserve the current stabilization priority.
|
||||||
|
- Runtime online services, telemetry, cloud CI, and uploads of original assets or generated packages — local operation and evidence preservation are mandatory.
|
||||||
|
- Replacing authoritative evidence with third-party reconstruction behavior — external decompiler indexes provide investigation leads only.
|
||||||
|
|
||||||
|
## Context
|
||||||
|
|
||||||
|
The authoritative specification is `../prompt.MD`; `../AGENTS.md` and `AGENTS.md` provide project rules and current priorities. Original binaries and assets live in `../Original/` and must never be modified or executed in place. Use generated copies and separate analysis/extraction/build output.
|
||||||
|
|
||||||
|
The complete codebase map is in `.planning/codebase/`. Existing architecture composes a persistent presentation session with scene-local simulation, scripts, resources and audio. Recovered algorithms and isolated original-component probes coexist with bounded live adapters and explicitly modern compatibility paths. Lab/outside capsule collision must remain until the source replacement gate is satisfied.
|
||||||
|
|
||||||
|
`docs/checkpoint/next-work-plan.md`, `docs/checkpoint/coverage.md`, `docs/checkpoint/implementation-plan.md`, and `docs/gameplay/jimmy-movement-stabilization.md` preserve the current recovery sequence. The successful TSK-backed first-story retained-input ordering correction is already documented; it must not be planned as an untouched defect or replaced by an invented orientation reset. Remaining derived actor responses, helper lifetime, collision admission, animation and camera handoffs need their own evidence gates.
|
||||||
|
|
||||||
|
The user explicitly selected the remaining full reconstruction as the planning scope and emphasized that it must be as accurate as possible to the original. A complete playable scene is an intermediate checkpoint, not the final scope. Existing runtime and component tests do not prove complete original-game fidelity. Whole-original runtime reference capture and broader native Windows comparisons remain open according to current reports.
|
||||||
|
|
||||||
|
## Constraints
|
||||||
|
|
||||||
|
- **Technology:** C#/.NET 10, Silk.NET.Vulkan, Vulkan 1.3+, SDL3; one shared native Linux/Windows x64 implementation.
|
||||||
|
- **Fidelity:** Preserve original algorithms, control semantics, floating-point/store behavior where significant, timing, progression and asset identity. Record approximations and unresolved questions explicitly.
|
||||||
|
- **Evidence:** Use REA for original-binary investigations; preserve complete Evidence, addresses, file offsets, provider gaps and relevant byte cross-checks. Distinguish static recovery, inference, implementation, compilation, component execution and whole-game runtime verification.
|
||||||
|
- **Validation:** Compilation alone cannot establish completion. Require meaningful regressions and integrated runtime comparisons at the appropriate scope; native Windows verification remains distinct from cross-publish and Wine.
|
||||||
|
- **Preservation:** Verify original hashes against `docs/original-manifest.json`; keep generated data outside originals and source commits.
|
||||||
|
- **Workflow:** Local builds/tests/packages only. Commit and push completed, verified source/tools/docs to existing `Gitea/main`; do not add cloud CI or upload originals/generated packages.
|
||||||
|
- **Coordination:** At most three investigators alongside primary, exclusive file ownership, primary integration and verification. Preserve unrelated working-tree changes.
|
||||||
|
|
||||||
|
## Key Decisions
|
||||||
|
|
||||||
|
| Decision | Rationale | Outcome |
|
||||||
|
|----------|-----------|---------|
|
||||||
|
| Plan the remaining full reconstruction | User selected full scope rather than a movement-only milestone | Confirmed |
|
||||||
|
| Make original fidelity the governing priority | User explicitly requires accuracy as high as possible | Confirmed |
|
||||||
|
| Stabilize movement and interacting lifetimes before expansion | Current project instructions and recovery dependencies | Existing policy |
|
||||||
|
| Reuse evidence and validated implementation with bounded claims | Avoid repeating solved investigations or overstating coverage | Existing policy |
|
||||||
|
| Require original comparison and native platform evidence for final completion | Component tests and cross-builds have narrower guarantees | Pending full verification |
|
||||||
|
|
||||||
|
## Evolution
|
||||||
|
|
||||||
|
This document evolves at phase transitions and milestone boundaries.
|
||||||
|
|
||||||
|
After each phase transition, move verified requirements to Validated with evidence references, record invalidated scope and new requirements, update decisions, and check that the project description remains accurate.
|
||||||
|
|
||||||
|
After each milestone, review every section, confirm the fidelity priority, revisit deferrals and update context with actual implementation and verification status. Keep full-game completion separate from intermediate scene and component checkpoints.
|
||||||
|
|
||||||
|
---
|
||||||
|
*Last updated: 2026-11-12 after initialization and user scope approval*
|
||||||
@@ -0,0 +1,70 @@
|
|||||||
|
{
|
||||||
|
"model_profile": "inherit",
|
||||||
|
"commit_docs": true,
|
||||||
|
"parallelization": true,
|
||||||
|
"search_gitignored": false,
|
||||||
|
"brave_search": false,
|
||||||
|
"firecrawl": false,
|
||||||
|
"exa_search": false,
|
||||||
|
"tavily_search": false,
|
||||||
|
"ref_search": false,
|
||||||
|
"perplexity": false,
|
||||||
|
"jina": false,
|
||||||
|
"git": {
|
||||||
|
"branching_strategy": "none",
|
||||||
|
"create_tag": true,
|
||||||
|
"repo_tagging": "single",
|
||||||
|
"phase_branch_template": "gsd/phase-{phase}-{slug}",
|
||||||
|
"milestone_branch_template": "gsd/{milestone}-{slug}",
|
||||||
|
"quick_branch_template": null
|
||||||
|
},
|
||||||
|
"workflow": {
|
||||||
|
"research": true,
|
||||||
|
"plan_check": true,
|
||||||
|
"verifier": true,
|
||||||
|
"nyquist_validation": true,
|
||||||
|
"auto_advance": false,
|
||||||
|
"node_repair": true,
|
||||||
|
"node_repair_budget": 2,
|
||||||
|
"ui_phase": true,
|
||||||
|
"ui_safety_gate": true,
|
||||||
|
"ai_integration_phase": true,
|
||||||
|
"api_coverage_gate": true,
|
||||||
|
"human_verify_mode": "end-of-phase",
|
||||||
|
"context_guard_mode": "warn",
|
||||||
|
"text_mode": false,
|
||||||
|
"compact_content": false,
|
||||||
|
"research_before_questions": false,
|
||||||
|
"discuss_mode": "discuss",
|
||||||
|
"skip_discuss": false,
|
||||||
|
"code_review": true,
|
||||||
|
"code_review_depth": "standard",
|
||||||
|
"code_review_command": null,
|
||||||
|
"pattern_mapper": true,
|
||||||
|
"plan_bounce": false,
|
||||||
|
"plan_bounce_script": null,
|
||||||
|
"plan_bounce_passes": 2,
|
||||||
|
"auto_prune_state": false,
|
||||||
|
"post_planning_gaps": true,
|
||||||
|
"security_enforcement": true,
|
||||||
|
"security_asvs_level": 1,
|
||||||
|
"security_block_on": "high"
|
||||||
|
},
|
||||||
|
"ship": {
|
||||||
|
"pr_body_sections": []
|
||||||
|
},
|
||||||
|
"hooks": {
|
||||||
|
"context_warnings": true
|
||||||
|
},
|
||||||
|
"project_code": null,
|
||||||
|
"phase_naming": "sequential",
|
||||||
|
"agent_skills": {},
|
||||||
|
"claude_md_path": "./.claude/CLAUDE.md",
|
||||||
|
"plan_review": {
|
||||||
|
"source_grounding": true,
|
||||||
|
"source_grounding_authority": "grep"
|
||||||
|
},
|
||||||
|
"resolve_model_ids": "omit",
|
||||||
|
"mode": "yolo",
|
||||||
|
"granularity": "standard"
|
||||||
|
}
|
||||||
@@ -0,0 +1,97 @@
|
|||||||
|
# Reconstruction Architecture and Dependency Gates
|
||||||
|
|
||||||
|
**Project:** Neutron GamePort
|
||||||
|
**Researched:** 2026-11-12
|
||||||
|
**Scope:** Local repository research for the remaining full reconstruction; no binary analysis, source execution, implementation changes or new runtime verification.
|
||||||
|
|
||||||
|
## Recommendation
|
||||||
|
|
||||||
|
Extend the existing explicit scene composition and recovered component architecture. Preserve the distinction between a recovered algorithm, a synthetic original-component comparison, a live scene adapter and verified whole-game behavior. Complete movement and interacting lifetimes before expanding gameplay. The architecture already supports playable scenes; replacing it with a new engine or a speculative universal solver would discard the source-order contracts that existing evidence establishes.
|
||||||
|
|
||||||
|
This is a dependency analysis of current project reports and selected code, not independent certification of their original-binary findings. The generic CLI confidence classifier returns LOW for the `curated` provider label; it has no repository-evidence provider. Therefore the conclusions below state their documentary basis and limits rather than claiming a provider-certified HIGH confidence result.
|
||||||
|
|
||||||
|
## Existing Boundaries to Preserve
|
||||||
|
|
||||||
|
| Owner | Existing responsibility | Remaining architectural obligation |
|
||||||
|
|-------|-------------------------|-------------------------------------|
|
||||||
|
| `Program.Main` / `RenderSession` | Persistent native window/Vulkan device and session diagnostics; scene replacement | Keep resource replacement separate from original object retention; retain explicit cleanup and native ownership |
|
||||||
|
| `Program.Run` | Concrete scene composition, held input, fixed-step policy and callback scheduling | Extend actual per-object registry order, live mutation and phase ownership rather than treating grouped updates as original semantics |
|
||||||
|
| `LabSimulation` / `PlayerSceneBinding` | Player body/controller/fire/control boundaries; fresh versus retained input ordering; script and vehicle bridges | Preserve independent control, body and effect eligibility, retained scalar ownership and authored transform publications |
|
||||||
|
| `OriginalBodyPhysics`, static/dynamic/pair/normal components | Bounded recovered numeric and callback contracts | Admit only actor states whose membership, callbacks, live reads and helper lifetime have been recovered |
|
||||||
|
| `SceneDirector` / interactions / tasks | Script actions, task broadcasts, cutscene control, contacts and transitions | Recover remaining real derived callbacks, action acceptance/completion and complete progression consumers |
|
||||||
|
| `Assets` / offline extractors | Original-format decoding and prepared render/audio resources | Preserve source identity/material metadata, explicit missing resources and immutable originals |
|
||||||
|
| Application visuals / renderer | Morphs, sprites, UI, camera projection and Vulkan resources | Replace named approximations with source-backed transforms, playback, materials, layers and render states |
|
||||||
|
| `SceneAudio` / `SdlAudio` | Scene music/speech/effects and native stream ownership | Separate original handle/bank/software clocks from SDL transport; complete positional/lifecycle policies |
|
||||||
|
|
||||||
|
Source: [codebase architecture](../codebase/ARCHITECTURE.md), [coverage](../../docs/checkpoint/coverage.md), [implementation ledger](../../docs/checkpoint/implementation-plan.md).
|
||||||
|
|
||||||
|
## Physical Scene Admission Is the Immediate Gate
|
||||||
|
|
||||||
|
The physical list and the ordinary object registry have separate ownership. Common registration repeats transform/zero/Init work and appends without identity deduplication; Jimmy's outer `49E` guard encloses the whole bridge. A scene-wide two-pass Init/PostLoad abstraction or a snapshot of registry membership would disagree with the recorded same-pass appended-child behavior. Serialized class counts and vtable identities cannot be treated as actual active-body counts.
|
||||||
|
|
||||||
|
The registration report inventories all 72 VR04 records/13 interfaces and compares 12 original-component registration/loader cases. Generated-helper edges are catalogued, but constructor/re-entry, conditional creation, removal, activation and retained LOAD/RETURN membership still need full ownership traces. The next integration must recover the actual ordered participants, not simply append every serialized actor or infer eligibility from its presence in the GAM file.
|
||||||
|
|
||||||
|
Normal response is also distinct from pair enter/stay/leave notification. Thirty original/C# normal-contact snapshots establish inherited response, Jimmy's ordinary bypass, live accessor order and bounded derived endpoints. Soldier mode10's complete `174` call is only a recorded endpoint; its RNG/action/target policy remains open. The grappler-related Jimmy `204` endpoint is likewise not a recovered universal cleanup policy.
|
||||||
|
|
||||||
|
The dynamic query/reclip components already compare empty and populated synthetic contexts, but sequential fixed actors are not a live mutable dispatcher. Post-callback inhibition, geometry permission, radius and `42C` reads must stay live; callback root mutation can be overwritten by final query-local publication. Do not cache constructor values or insert an unevidenced context reset. Preserve old nearest/hit/last-polygon state where recovered.
|
||||||
|
|
||||||
|
**Integration order:** real derived responses and game/task consumers → helper activation/removal/re-entry and fresh/retained physical order → shared mutable query context/accessors → bounded response adapter for explicitly supported VR04 states → route and platform verification → broader special-material actors and lab/outside admission.
|
||||||
|
|
||||||
|
Sources: [registration](../../docs/checkpoint/physical-registration.md), [helpers](../../docs/checkpoint/vr04-generated-bodies.md), [normal contacts](../../docs/checkpoint/actor-normal-contacts.md), [dynamic context](../../docs/checkpoint/dynamic-context.md), [populated reclip](../../docs/checkpoint/dynamic-reclip.md), [pair lifecycle](../../docs/checkpoint/pair-lifecycle.md).
|
||||||
|
|
||||||
|
## Camera, Animation and Retained State
|
||||||
|
|
||||||
|
- **Shared camera state:** The source report establishes a shared viewport eye read by both scripted camera writes and follow input, strict DEFAULT snapping only above distance1000, and aim computed from the pre-update eye. Current `Program.cs` selects director versus simulation cameras and `LabSimulation` retains its own `CameraEye`; partial gadget bridges do not establish complete shared viewport semantics. Model the owner explicitly after validating the remaining callers. Keep projection, layer masks/fog, noclip and modern orbit policy separate.
|
||||||
|
- **Animation:** Existing morph assets and deterministic visual checks do not establish the original action acceptance, playback clock, repeat/end events or interruption policy. Recover these across jump/land/STOP/talk/skip/control return before relying on them to drive actor transitions or progression. The port's fixed60Hz simulation policy must not become an assumed oracle for every original animation or script clock.
|
||||||
|
- **Retained scene state:** Ordinary LOAD/RETURN, TSK loading, debug reset and fresh direct-GAM startup are different paths. Preserve original tasks/items/root state separately from session diagnostics and scene GPU/audio recreation. Current bounded retained player scalars are not permission to carry arbitrary helpers, timers, modes or handles through every transition.
|
||||||
|
- **Sound clocks:** Original software elapsed/duration, strict completion boundaries, repeat and bank ownership govern cutscene behavior; transport queue-empty and dummy-stream success prove narrower properties. Integrate source channel state before broad playback-dependent script completion.
|
||||||
|
|
||||||
|
Sources: [camera handoff](../../docs/checkpoint/camera-handoff.md), [coverage](../../docs/checkpoint/coverage.md), [implementation ledger C5–C8](../../docs/checkpoint/implementation-plan.md), [next-work plan](../../docs/checkpoint/next-work-plan.md).
|
||||||
|
|
||||||
|
## Solved Checkpoints Versus Remaining Work
|
||||||
|
|
||||||
|
| Reuse as established bounded work | Still required |
|
||||||
|
|----------------------------------|----------------|
|
||||||
|
| C1 pre-task objective notification and C2 per-actor Carl task override | Other real derived task/contact policies and full progression |
|
||||||
|
| Controlled player body-before-callback order, fresh/retained input distinction | Broader object scheduler, mutable helpers and actor-specific eligibility |
|
||||||
|
| TSK-backed first-story retained Jimmy ordering correction; first-neutral/300-idle regression | Whole-original Carl runtime reference and native Windows comparison; broader handoffs |
|
||||||
|
| Static camera ray/FIFO/wall-first adapter and per-level far limits | Complete shared eye/aim handoff, special follow branches and visual comparison |
|
||||||
|
| VR04 ordinary source static body and bounded body publication/mode components | Dynamic registry/response, successful Jimmy hazards/climbs, lab/outside source admission |
|
||||||
|
| Dynamic query and populated reclip component comparisons | Real actors/accessors and shared ordered scene context |
|
||||||
|
| Bounded gadget/vehicle scenes and retained scalar bridges | Broader levels, special interactions, helper cleanup and arbitrary save/load lifetimes |
|
||||||
|
|
||||||
|
Historical prose in `next-work-plan.md` still says the Carl correction has not begun; later updates and `docs/tasks.md` establish that the source startup-order classification and port correction are already implemented. Do not reopen that defect as untouched work or add an invented leveling reset. Similarly, the old C4 kernel-only checkpoint has been superseded by ordinary-body integration and later component reports, while its broader admission gate remains.
|
||||||
|
|
||||||
|
## Dependency Order for the Full Reconstruction
|
||||||
|
|
||||||
|
1. **Close the movement/route checkpoint:** real callbacks, helper lifetime/physical order, shared reclip, animation/control/camera handoffs and an integrated lab→VR04→lab→outside regression. Retain the existing playable baseline until each replacement gate closes.
|
||||||
|
2. **Complete shared actor/gameplay contracts:** source damage/hazards, AI/action/RNG, interactions, gadgets/vehicles and their activation/cleanup. Derive scope from original resources and consumers; existing bounded scenes are reusable implementations, not proof of universal support.
|
||||||
|
3. **Complete original progression and persistence:** load/RETURN and task/item state, every reachable level/mission, authored scripts and win/loss paths. Add full menu/configuration/save UI once their state ownership is recovered. Level inspection/rendering is insufficient.
|
||||||
|
4. **Complete presentation and audio contracts:** animation/pivots, material/light/fog/alpha/culling/layers, shared camera and UI; bank/handle clocks, positional mixing and effects. Independent static research can run alongside earlier work, but live integration must respect gameplay and lifetime dependencies.
|
||||||
|
5. **Verify complete journeys and release packages:** original comparison across representative and full-game routes, native Linux and native Windows gameplay/input/audio/rendering, offline package resource/provenance checks and reproducible discrepancy triage.
|
||||||
|
|
||||||
|
These are dependency groups, not a demand to defer all rendering/audio work until the end. Resolve a presentation or sound contract earlier when it blocks a verified gameplay route. Keep the roadmap within the selected standard granularity while allowing phase plans to subdivide evidence gates.
|
||||||
|
|
||||||
|
## Verification Architecture
|
||||||
|
|
||||||
|
For each admitted capability, maintain an evidence chain: authoritative binary/asset identity → addresses/offsets and REA Evidence or documented provider gap → bounded source contract/probe → managed regression → live scene replay → native platform/package result → whole-original comparison where observable. Preserve complete snapshots and hashes locally. A successful level render, synthetic callback endpoint or cross-publish closes only its named gate.
|
||||||
|
|
||||||
|
Use deterministic source/component checks for phase and numeric differences; GPU readbacks for pose/camera/material differences; actual SDL input for integrated ownership and controls; physical/native audio checks for audible behavior; original-format round-trips and live reload for persistence. Define a discrepancy ledger with original/port scenario, first divergence, evidence, fix and remaining uncertainty. Never certify full fidelity from matching a few constants or rendered scenes.
|
||||||
|
|
||||||
|
Both packages must identify a clean verified runtime commit and contain matching original/prepared resources. Execute from a standalone directory without source/SDK/development-library paths. Reverify original hashes. Windows cross-publish, Wine compatibility, historical user reports and new native Windows execution remain separate receipts. Push only source/tools/docs to approved Gitea; original assets, generated traces and packages stay local.
|
||||||
|
|
||||||
|
## Open Questions for Phase Research
|
||||||
|
|
||||||
|
- Complete soldier RNG/action/target response and real enter/stay/leave task effects.
|
||||||
|
- Constructor-only/conditional helper activation, cleanup mutation and retained physical ordering.
|
||||||
|
- General live/reentrant scalar getter and shared context ownership beyond fixed synthetic probes.
|
||||||
|
- Successful Jimmy FENCE/LADDER/hazard paths and multi-frame mode/animation effects.
|
||||||
|
- Complete shared viewport handoff, source aim quantization and special follow branches.
|
||||||
|
- Playback clocks/end callbacks, original sound bank lifecycle and full save/menu callers.
|
||||||
|
- A usable whole-original reference environment and current native Windows verification.
|
||||||
|
|
||||||
|
## Sources and Limits
|
||||||
|
|
||||||
|
Primary local planning inputs: [PROJECT.md](../PROJECT.md), [architecture map](../codebase/ARCHITECTURE.md), [tasks](../../docs/tasks.md), [coverage](../../docs/checkpoint/coverage.md), [implementation ledger](../../docs/checkpoint/implementation-plan.md), and [next-work plan](../../docs/checkpoint/next-work-plan.md). Selected current code checks: `src/GamePort/Program.cs` camera selection and `src/GamePort/Game/LabSimulation.cs` camera ownership. Specialized evidence reports are linked beside their findings above.
|
||||||
|
|
||||||
|
No original files were modified or executed. No current build, platform execution or original-runtime comparison was performed for this report. Architectural recommendations are inference from documented contracts; exact remaining original behavior must be recovered in phase-specific investigation.
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
# 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.
|
||||||
@@ -0,0 +1,116 @@
|
|||||||
|
# Reconstruction Pitfalls
|
||||||
|
|
||||||
|
**Project:** Neutron GamePort
|
||||||
|
**Reviewed:** 2026-11-12
|
||||||
|
**Scope:** Remaining full reconstruction; local documentation review only. No new original-binary investigation, execution, build or runtime comparison was performed.
|
||||||
|
|
||||||
|
## Evidence and confidence
|
||||||
|
|
||||||
|
The risks below are cross-referenced repository findings, not externally researched ecosystem claims. Their supporting source/component observations have the bounds specified in the linked reports; their implications for phase ordering are planning inferences. Whole-game accuracy is unverified. The generic `classify-confidence --provider curated --verified` seam returned LOW for this local-source provider; that label must not be mistaken for a new certification of the original experiments. Use the underlying receipts and their explicit execution scope when deciding admission.
|
||||||
|
|
||||||
|
## Critical pitfalls
|
||||||
|
|
||||||
|
### 1. Promoting component parity into live gameplay fidelity
|
||||||
|
|
||||||
|
**Failure:** A matching pair, normal-response or reclip fixture is wired into every scene as though actual actors, registry membership and task effects were recovered.
|
||||||
|
|
||||||
|
**Warning signs:** Completion claims cite only fixture counts; synthetic callback endpoints are described as real soldier/Jimmy policies; serialized GAM records become the active physical-body count.
|
||||||
|
|
||||||
|
**Prevention:** Require actual class construction, activation, physical order, derived response, enter/stay/leave consumers and shared context before expanding each live adapter. Keep lab/outside capsule compatibility until its replacement dependencies close. Compare complete callback events, flags and state snapshots, not just final positions. Soldier complete174 and Jimmy204 remain record-only endpoints in the normal-contact report.
|
||||||
|
|
||||||
|
**Phase implication:** Physical lifecycle and derived callbacks precede broad actor, enemy and gadget collision expansion.
|
||||||
|
|
||||||
|
Sources: [normal contacts](../../docs/checkpoint/actor-normal-contacts.md), [physical registration](../../docs/checkpoint/physical-registration.md), [pair lifecycle](../../docs/checkpoint/pair-lifecycle.md), [coverage](../../docs/checkpoint/coverage.md).
|
||||||
|
|
||||||
|
### 2. Fixing symptoms by changing legitimate original movement
|
||||||
|
|
||||||
|
**Failure:** A universal angle reset, added damping or imported tuned movement masks an ownership/scheduling divergence and removes original behavior.
|
||||||
|
|
||||||
|
**Warning signs:** Ordinary landing bank is called a bug; fresh direct-scene and TSK-backed retained entry are given the same input order; JN-Engine's tuned movement becomes the oracle.
|
||||||
|
|
||||||
|
**Prevention:** Preserve current movement and the successful first-story TSK retained-input correction. Trace the first divergent owner and caller phase before changing arithmetic. Recheck neutral return, sustained idle, held input, both turn directions, natural/skip completion and repeated scenes. External decompiler indexes provide leads only.
|
||||||
|
|
||||||
|
**Phase implication:** Movement, control/animation ownership and route handoffs remain the first implementation checkpoint. The Carl initialization correction is existing work, not an untouched future fix.
|
||||||
|
|
||||||
|
Sources: [menu/player lifetime](../../docs/gameplay/main-menu-player-lifetime.md), [movement stabilization](../../docs/gameplay/jimmy-movement-stabilization.md), [next-work plan updates](../../docs/checkpoint/next-work-plan.md).
|
||||||
|
|
||||||
|
### 3. Flattening physical registration and retained lifetime
|
||||||
|
|
||||||
|
**Failure:** Deduplication, snapshot traversal or a generic reset silently changes ordering across fresh load, retained LOAD and RETURN.
|
||||||
|
|
||||||
|
**Warning signs:** Constructor registrations are treated as final active membership; Init and PostLoad run as two global passes; setting a flag is treated as deleting a node; helper reuse/cleanup is assumed from a constructor edge.
|
||||||
|
|
||||||
|
**Prevention:** Keep ordinary registry and physical list independent. Common registration can append an existing pointer; Jimmy's outer guard is separate. Preserve Init-before-parent-append and per-object Init/PostLoad traversal that can visit new tails. Recover actual helper removal, activation and re-entry before representing retained lists. Compare complete ordered lists across scene transitions.
|
||||||
|
|
||||||
|
**Phase implication:** Lifecycle closure must precede arbitrary retained saves, general dynamic contacts and full-level progression admission.
|
||||||
|
|
||||||
|
Sources: [registration](../../docs/checkpoint/physical-registration.md), [generated helpers](../../docs/checkpoint/vr04-generated-bodies.md), [dynamic context](../../docs/checkpoint/dynamic-context.md).
|
||||||
|
|
||||||
|
### 4. Caching values across source callbacks
|
||||||
|
|
||||||
|
**Failure:** A refactor snapshots radius, inhibition, geometry permission or velocity before callbacks, changing subsequent reclip and final publication.
|
||||||
|
|
||||||
|
**Warning signs:** Accessors become constructor constants; a callback's root edit is assumed to survive final local-root publication; collision mode and class-specific controller state share an enum or layout.
|
||||||
|
|
||||||
|
**Prevention:** Preserve source getter order and independent fields. Test callbacks that mutate radius, flags, Y velocity and roots, plus retained old-hit/last-polygon behavior. Distinguish XYZ writes from full XYZW setters. Do not apply inherited reflection to Jimmy ordinary374, which takes its own material-policy path.
|
||||||
|
|
||||||
|
**Phase implication:** Response adapters require live getter and ownership contracts before integration.
|
||||||
|
|
||||||
|
Sources: [normal contacts](../../docs/checkpoint/actor-normal-contacts.md), [populated reclip](../../docs/checkpoint/dynamic-reclip.md).
|
||||||
|
|
||||||
|
### 5. Treating mathematically equivalent arithmetic as source equivalent
|
||||||
|
|
||||||
|
**Failure:** Double promotion, normalization changes, reordered operations, triangle winding fixes or a faster broadphase alter strict branches, ties and accumulated state.
|
||||||
|
|
||||||
|
**Warning signs:** Double intermediates are called an x87 emulator; only root tolerance is checked; duplicated source cell visits are removed; heading wraps or unclamped damping are normalized to conventional behavior.
|
||||||
|
|
||||||
|
**Prevention:** Preserve evidenced float-store boundaries, kernel A,C,B winding, strict comparisons and traversal order. Record the first exact differing field and kernel argument. Widening precision or optimizing needs new differential evidence; degenerate inputs outside the bounded contract remain explicit unknowns.
|
||||||
|
|
||||||
|
**Phase implication:** Preserve numeric probes throughout collision, actors and rendering-transform work; optimize after equivalence and measured need.
|
||||||
|
|
||||||
|
Sources: [dynamic reclip](../../docs/checkpoint/dynamic-reclip.md), [normal contacts](../../docs/checkpoint/actor-normal-contacts.md), [codebase concerns](../codebase/CONCERNS.md).
|
||||||
|
|
||||||
|
### 6. Mistaking successful rendering or audio transport for original presentation
|
||||||
|
|
||||||
|
**Failure:** Zero Vulkan errors, identical port screenshots or SDL dummy-stream success are reported as visual/audible parity.
|
||||||
|
|
||||||
|
**Warning signs:** Merged far-plane policy implies per-layer fog/clipping fidelity; queue-empty replaces the original software sound clock; fixed 60 Hz is called recovered original scheduling; a correct transform kernel implies exact final OMT visual decomposition.
|
||||||
|
|
||||||
|
**Prevention:** Compare original reference frames and sound intervals at identified states. Keep lighting/fog/material/blend/culling, sprite/pivot/decomposition, morph clocks, camera handoff, sound-bank/channel duration/attenuation and physical listening as separate targets. Retain device-independent numeric and transport checks, but report their narrower guarantees.
|
||||||
|
|
||||||
|
**Phase implication:** Presentation and audio need source-specific recovery and integrated comparisons; start reference acquisition early rather than leaving all fidelity checks until release.
|
||||||
|
|
||||||
|
Sources: [coverage](../../docs/checkpoint/coverage.md), [compatibility](../../docs/compatibility.md), [air bridge](../../docs/gameplay/jimmy-air-bridge.md).
|
||||||
|
|
||||||
|
### 7. Shipping a different revision from the one verified
|
||||||
|
|
||||||
|
**Failure:** Current source, historical GPU tests and an older local package are merged into one completion claim; Wine is presented as native Windows verification.
|
||||||
|
|
||||||
|
**Warning signs:** No exact package identity; user Windows reports attributed to an agent-run current build; startup black frames treated as a playable original reference; source-only changes inherit old SDL coverage.
|
||||||
|
|
||||||
|
**Prevention:** Bind every receipt to source commit, package provenance, resource hashes, platform, scenario and validation setting. Run the same integrated route/control/window/audio checks on clean standalone Linux and native Windows packages. Keep original-component Wine32, port Wine64, whole-original reference and native Windows evidence separate. A blocked original runtime comparison remains an open release obligation.
|
||||||
|
|
||||||
|
**Phase implication:** Reference/native Windows access is an early dependency; final full-game acceptance requires current integrated evidence, not a cross-publish alone.
|
||||||
|
|
||||||
|
Sources: [progress](../../docs/progress.md), [compatibility](../../docs/compatibility.md), [codebase concerns](../codebase/CONCERNS.md).
|
||||||
|
|
||||||
|
## Further risks during full reconstruction
|
||||||
|
|
||||||
|
| Risk | Warning sign | Prevention / roadmap consequence |
|
||||||
|
|------|--------------|----------------------------------|
|
||||||
|
| Asset inventory mistaken for playable coverage | All GAMs parse, therefore all levels are called complete | Track each original route, mechanic, actor and script consumer through implementation and runtime verification. |
|
||||||
|
| Unsupported missing-content conclusion | Level3B/E GAMs described as missing, or absent OMTs called a proven fatal normal-game blocker | GAMs exist; distinguish their referenced absent archives from proven reachability. Investigate hardcoded/serialized routes without inventing substitutes. See [resource evidence](../../docs/analysis/level-resource-mapping.md). |
|
||||||
|
| Save round-trip mistaken for load fidelity | Binary equality substitutes for repeated task/entity callbacks and retained scene ownership | Recover full original load UI, callback multiplicity, placement and helper lifetimes; test loading at real progression boundaries. See [coverage SAVE](../../docs/checkpoint/coverage.md). |
|
||||||
|
| Invalid copied-code evidence accepted | Partial captures or relocation scans are counted as source behavior | Preserve full REA replies, source/probe hashes, reviewed operand mappings and completion markers; exclude invalid captures. Provider errors remain errors. See [normal contacts](../../docs/checkpoint/actor-normal-contacts.md). |
|
||||||
|
| Original evidence altered or published | Extraction/probes target Original, or package files enter source commits | Generated copies/output only; verify all 539 baseline hashes, stage explicit source/docs paths and keep assets/packages local. |
|
||||||
|
| Old narratives override newer receipts | A solved Carl bug is reopened from an older section | Follow dated continuation updates and exact receipt scope; reconcile current reports before planning changes. |
|
||||||
|
|
||||||
|
## Phase-specific gates
|
||||||
|
|
||||||
|
1. **Core movement/lifetimes:** preserve baseline, close real response/helper/state owners and validate lab → VR04 → lab → outside before expansion.
|
||||||
|
2. **Actors/gadgets/combat:** recover actual callbacks, RNG/action policies, activation and physical order before broader admission; bounded training-scene behavior is not full-game coverage.
|
||||||
|
3. **Progression/save/menu:** exercise complete authored routes, fresh/load/RETURN paths and task callbacks; do not equate parsable resources with playable progression.
|
||||||
|
4. **Rendering/audio/UI:** obtain observable original references, then address named state/clock/transform differences with isolated and integrated evidence.
|
||||||
|
5. **Release:** identify exact clean builds and resource manifests; verify full original content and native Linux/Windows behavior, with no unverified fidelity claims hidden by successful packaging.
|
||||||
|
|
||||||
|
These gates are dependency recommendations inferred from current findings. They are not new binary findings or implementation approvals.
|
||||||
@@ -0,0 +1,59 @@
|
|||||||
|
# Technology and Verification Foundation
|
||||||
|
|
||||||
|
**Project:** Neutron GamePort remaining full reconstruction
|
||||||
|
**Researched:** 2026-11-12
|
||||||
|
**Method:** Local specification, source/configuration cross-checks and existing verification reports. No dependency updates, new runtime tests or binary analysis were performed.
|
||||||
|
|
||||||
|
## Keep the Existing Stack
|
||||||
|
|
||||||
|
| Component | Repository version/requirement | Role and decision |
|
||||||
|
|-----------|-------------------------------|-------------------|
|
||||||
|
| C# / .NET | `net10.0`; SDK selector 10.0.100 with latestFeature roll-forward; bootstrap SDK 10.0.402 | Retain one shared Linux/Windows x64 executable. Do not plan a foundation rewrite. |
|
||||||
|
| Silk.NET.Vulkan / KHR / EXT | 2.23.0 | Existing Vulkan bindings, pinned in the project and lockfile. |
|
||||||
|
| Vulkan | 1.3 minimum | Existing renderer requests Version13 and rejects older devices. Host driver/loader remains required even with self-contained packages. |
|
||||||
|
| SDL3 | 3.4.2 in bootstrap | Existing handwritten P/Invoke for native window, input, surface and audio. Retain the shared platform boundary. |
|
||||||
|
| GLSL / SPIR-V tools | Local shader compiler and validator | Preserve original fixed-function behavior through explicit Vulkan shaders/states rather than modernizing the look. |
|
||||||
|
| Python / Bash / C | Local tooling; documented Python 3.12 | Offline preparation, repeatable local scripts and isolated original-component probes. None is a packaged gameplay runtime dependency. |
|
||||||
|
| REA / Ghidra / full JDK | Existing launcher; documented Ghidra 12.1.4 / Java 21 paths | Required investigation route for original binaries. Check actual local launcher/tool identities when producing new evidence. |
|
||||||
|
| Wine | Documented 11.0 | Isolated original/component investigation and preliminary Windows compatibility only. It cannot substitute for native Windows verification. |
|
||||||
|
|
||||||
|
Versions describe this repository, not upstream latest releases or newly verified installations. `docs/dependencies.md` records runtime pack 10.0.13; confirm generated publish runtime metadata for each package rather than deriving runtime version from SDK version.
|
||||||
|
|
||||||
|
Sources: [project](../../GamePort.csproj), [SDK selection](../../global.json), [bootstrap](../../scripts/bootstrap.sh), [dependencies](../../docs/dependencies.md), [renderer](../../src/GamePort/Rendering/Vulkan/VulkanRenderer.cs), [REA launcher](../../scripts/rea.sh).
|
||||||
|
|
||||||
|
## Existing Local Delivery and Evidence Facilities
|
||||||
|
|
||||||
|
- `scripts/env.sh` selects local SDK/cache/native tools and disables .NET CLI telemetry. NuGet dependencies are locked in `packages.lock.json`.
|
||||||
|
- `scripts/test.sh` combines Python parser/source regressions, managed algorithm programs, Vulkan rendering and SDL dummy-audio checks. Tests must retain their bounded claims: exact component output does not establish original full-game scheduling or visuals.
|
||||||
|
- `scripts/build-linux.sh`, `scripts/build-windows.sh` and `scripts/package.sh` already implement local self-contained publishing and original-derived asset assembly. Packages include SDL3, shaders, resources, licenses and source provenance. They remain local artifacts.
|
||||||
|
- Original preservation uses `tools/recon/inventory.py` with `docs/original-manifest.json`. Existing reports record 539 hashes; run the verifier at actual implementation/package checkpoints.
|
||||||
|
- Runtime has no required hosted service, account system, remote database or telemetry. Gitea is solely the authorized source-control destination for completed verified source/tools/docs.
|
||||||
|
|
||||||
|
Sources: [integration map](../codebase/INTEGRATIONS.md), [test entry](../../scripts/test.sh), [packaging](../../scripts/package.sh), [project rules](../../AGENTS.md).
|
||||||
|
|
||||||
|
## Remaining Capability Gaps
|
||||||
|
|
||||||
|
| Gap | Existing evidence | Required closure and roadmap implication |
|
||||||
|
|-----|-------------------|------------------------------------------|
|
||||||
|
| Whole-original reference execution | Compatibility reports record isolated Wine windows with unusable original GL/Vulkan rendering; component execution is available | Establish a working local original reference environment/capture path early. Use a generated copy, local Windows/legacy VM or other supported local investigation path. Feasibility of a particular environment is unverified. Do not silently promote component probes to whole-game reference evidence. |
|
||||||
|
| Native Windows verification | Windows x64 cross-publish, preliminary Wine checks and bounded user reports exist | Plan repeatable native Windows input, audio, resize, driver and integrated progression checks. Record revision, device/environment and scenario results. A new cross-publish does not refresh prior Windows runtime evidence. |
|
||||||
|
| Audible and positional audio comparison | Dummy streams verify consumption/lifecycle; broader speakers/latency/attenuation verification remains open | Compare effects/bank selection, spatial behavior, timing and actual listening output against the original on both native platforms. SDL API availability alone does not resolve policy. |
|
||||||
|
| Rendering equivalence | Native Linux/llvmpipe GPU checks and readbacks exist | Add reference-matched camera/scene captures and per-state discrepancy review for materials, lighting, fog, alpha, pivots and animation. Zero Vulkan validation errors proves API correctness, not fidelity. |
|
||||||
|
| Timing and retained system composition | Numerous copied-original component cases; fixed 60 Hz port policy; source ordering corrections already integrated | Recover remaining shared scheduling, actor lifetime and callback contracts before broad solver admission. Compare event/state traces as well as pixels and final positions. |
|
||||||
|
| Full content and release coverage | 35 GAMs catalogued, 33 with matching geometry; local packages contain substantial playable content | Audit all reachable original routes and resources. Missing Level3B/E geometry is recorded but normal gameplay use is unverified: it is not an established blocker or permission to fabricate replacement assets. |
|
||||||
|
|
||||||
|
Sources: [compatibility ledger](../../docs/compatibility.md), [current progress](../../docs/progress.md), [next-work plan](../../docs/checkpoint/next-work-plan.md), [authoritative specification](../../../prompt.MD).
|
||||||
|
|
||||||
|
## Roadmap Decisions
|
||||||
|
|
||||||
|
1. Treat the existing shared renderer/platform/build system as the foundation. Extend focused recovered modules and local checks instead of reselecting engines or libraries.
|
||||||
|
2. Establish the original-reference and native-platform comparison matrix at the start and grow it with each gameplay slice; reserve final cross-platform acceptance for complete routes and clean packages.
|
||||||
|
3. Keep the current Jimmy stabilization and collision admission gates ahead of gameplay expansion. Additional tooling should answer a named unresolved source/runtime question, not become an independent infrastructure rewrite.
|
||||||
|
4. Preserve generated extraction, original-code probes, snapshots and build output separately from immutable originals. Commit findings/tools/source only; no original assets or generated packages may be pushed.
|
||||||
|
5. Record source commit, package identity and verification scope together. Research does not refresh historical runtime receipts.
|
||||||
|
|
||||||
|
## Confidence and Unresolved Questions
|
||||||
|
|
||||||
|
The stack/configuration observations are directly cross-checked against repository files; historical runtime results are report evidence, not newly reproduced results. No claim is made about current upstream releases. The generic GSD `classify-confidence --provider curated --verified` returned LOW without a recognized package/ecosystem; that provider score does not independently validate these local artifacts.
|
||||||
|
|
||||||
|
Open questions are the working original capture environment, comprehensive native Windows availability, original cadence/reference trace coverage, audible output parity and the complete reachable content matrix. These require phase-specific local investigation and execution; they are not reasons to replace the mandated technology stack.
|
||||||
@@ -0,0 +1,181 @@
|
|||||||
|
# Project Research Summary
|
||||||
|
|
||||||
|
**Project:** Neutron GamePort — remaining full reconstruction
|
||||||
|
**Domain:** Evidence-led reconstruction of a legacy native 3D game
|
||||||
|
**Researched:** 2026-11-12
|
||||||
|
**Confidence:** High in mandated scope and existing boundaries; medium in roadmap decomposition; unresolved for complete original/runtime fidelity.
|
||||||
|
|
||||||
|
## Executive Summary
|
||||||
|
|
||||||
|
This is an existing playable reconstruction, not a new engine project. Retain the shared C#/.NET 10, Silk.NET.Vulkan/Vulkan 1.3+ and SDL3 foundation, original-derived resources, local tooling and bounded recovered components. The user requires the remaining full game to match the original as accurately as possible. Original behavior, including quirks, takes priority over conventional movement or presentation improvements. A faithful scene is an intermediate milestone; complete campaign and supported optional-content coverage remain required.
|
||||||
|
|
||||||
|
The immediate implementation dependency is movement and interacting ownership: real derived actor responses, physical/helper registration and cleanup, callback-mutated fields, shared dynamic/static reclip, animation and camera handoffs. Preserve the implemented TSK-backed first-story ordering correction and legitimate landing bank. Expand existing gadgets, actors and levels only after their source admission dependencies close. Complete gameplay, progression/persistence and presentation/audio through integrated playable slices rather than treating their isolated algorithms as full scene support.
|
||||||
|
|
||||||
|
The largest acceptance gap is reference evidence. Existing copied-original component execution, Linux SDL/Vulkan tests, Windows cross-publishing and Wine results have useful but different scopes. Establish a usable copied-original reference environment and repeatable native Windows checks early; grow comparison coverage throughout implementation. Full-game completion requires current integrated native Linux/Windows and original-versus-port evidence, exact source/package provenance and explicit discrepancy closure. This research reviewed local documents and selected configuration/code; it did not refresh any runtime receipt or recover new binary behavior.
|
||||||
|
|
||||||
|
## Key Findings
|
||||||
|
|
||||||
|
### Recommended Stack
|
||||||
|
|
||||||
|
Retain the existing implementation. Repository versions are .NET 10 (`net10.0`, bootstrap SDK 10.0.402), Silk.NET.Vulkan/KHR/EXT 2.23.0 and bootstrap SDL3 3.4.2. Vulkan 1.3 is mandatory. These describe repository configuration, not newly checked upstream releases or installations. Host Vulkan loader/driver support remains necessary for self-contained packages.
|
||||||
|
|
||||||
|
- **C#/.NET 10:** one shared native Linux/Windows x64 runtime and managed regression programs.
|
||||||
|
- **Silk.NET.Vulkan and GLSL/SPIR-V:** existing resource ownership and shader pipeline; extend source fixed-function equivalents instead of redesigning the look.
|
||||||
|
- **SDL3:** existing native window/input/audio transport; original policy and timing remain project responsibilities.
|
||||||
|
- **Python/Bash/C, REA/Ghidra and Wine:** local preparation, evidence and isolated probes. They are not online or packaged runtime dependencies. REA is required for future original-binary investigations; Wine is preliminary compatibility evidence.
|
||||||
|
- **Local build/package scripts and hash manifests:** reuse established facilities, adding exact revision/platform/resource receipts rather than replacing infrastructure.
|
||||||
|
|
||||||
|
See [STACK.md](STACK.md) for configuration sources and verification capability gaps.
|
||||||
|
|
||||||
|
### Expected Features
|
||||||
|
|
||||||
|
All original-required behavior belongs in the full reconstruction scope. Existing bounded implementations are reusable progress, not grounds to omit their remaining consumers or lifetimes.
|
||||||
|
|
||||||
|
**Must complete:**
|
||||||
|
|
||||||
|
- Jimmy movement, original input, body/contact modes, animation/control and camera ownership across fresh entry, scripts, LOAD and RETURN.
|
||||||
|
- Actual actors, enemies/AI, RNG/action policies, health/damage/hazards, combat and class-specific task/contact effects.
|
||||||
|
- All original gadgets/vehicles and inventory/energy behavior across intended consumers and scenes, preserving currently live bounded features.
|
||||||
|
- Reachable campaign levels, authored scripts, tasks, objectives, collectibles, branch/optional content and ending/win/loss behavior where evidenced.
|
||||||
|
- Original frontend, HUD, options/configuration and complete runtime save/load/resume semantics.
|
||||||
|
- Original geometry, pivots/morphs, materials, lighting/fog/alpha/depth/cull/layer behavior and camera presentation.
|
||||||
|
- Music/speech/effects, contextual banks/channels, clocks, loops, attenuation/panning and physical audible output.
|
||||||
|
- Offline clean packages and integrated native Linux/Windows and original-reference comparisons.
|
||||||
|
|
||||||
|
**No new differentiators:** Fidelity is the value. Keep existing user-authorized diagnostics distinct from original frontend/gameplay. Do not add creative mechanics, tuned replacement movement, visual modernization, online services or telemetry. No original-required category is deferred beyond the full reconstruction merely to shorten this roadmap.
|
||||||
|
|
||||||
|
See [FEATURES.md](FEATURES.md) for per-category existing capabilities, dependency and acceptance targets. Level3B/E GAMs exist but their referenced OMTs are absent; normal gameplay reachability is unverified, so missing geometry is not an established campaign blocker.
|
||||||
|
|
||||||
|
### Architecture Approach
|
||||||
|
|
||||||
|
Preserve explicit application composition and scheduling. `RenderSession` owns persistent native presentation; scene composition connects simulation, script/interactions, decoded resources, visual adapters and audio. Original object retention is different from GPU/audio resource recreation. Recovered components require explicit actor/scene admission, with complete registry/helper lifetime and real callback policies before broad integration.
|
||||||
|
|
||||||
|
Keep body/controller/fire/control clocks independent; fresh direct-GAM ordering differs from retained TSK story entry. Maintain source live getter order and separate collision modes from class-specific state. Shared camera eye/aim, animation completion and sound software clocks need their own owners rather than generic resets or transport-driven substitutes. Extend focused modules and tests without inventing a universal engine or solver.
|
||||||
|
|
||||||
|
See [ARCHITECTURE.md](ARCHITECTURE.md) for boundary tables, the immediate physical admission gate and solved-versus-open checkpoints.
|
||||||
|
|
||||||
|
### Critical Pitfalls
|
||||||
|
|
||||||
|
1. **Component parity promoted to live fidelity:** Require actual derived policies, active membership, helper lifetime and task effects; compare ordered full state/events before admitting new actors/scenes.
|
||||||
|
2. **Symptom fixes erase original behavior:** Preserve legitimate landing bank and the implemented startup ordering correction. Trace the first divergent writer instead of adding leveling resets or importing third-party tuned movement.
|
||||||
|
3. **Convenient lifecycle/numeric rewrites alter semantics:** Preserve mutable registry traversal, repeated registrations, callback-time scalar reads, retained query state, strict comparisons, winding and evidenced float-store boundaries.
|
||||||
|
4. **Port-only visuals/audio mistaken for original parity:** Zero Vulkan errors and dummy streams prove narrower properties. Compare identified original frames, clocks, listener states and audible output.
|
||||||
|
5. **Verification and shipped revisions diverge:** Bind receipts to exact source/package/resource identity; distinguish native Windows, Wine, component execution and whole-original runtime. Never inherit historical coverage for a changed build.
|
||||||
|
|
||||||
|
See [PITFALLS.md](PITFALLS.md) for warning signs, mitigation and report references.
|
||||||
|
|
||||||
|
## Implications for Roadmap
|
||||||
|
|
||||||
|
Use eight dependency-led phases at standard granularity. Each phase should contain small source-recovery → implementation → integrated-verification slices; phase boundaries do not justify delaying necessary audio, camera or reference work.
|
||||||
|
|
||||||
|
### Phase 1: Fidelity Baseline and Reference Access
|
||||||
|
|
||||||
|
**Rationale:** Later acceptance needs a trustworthy original/platform comparison path and current coverage matrix.
|
||||||
|
**Delivers:** Revision-specific evidence/discrepancy ledger, original-reference capture route and initial native Linux/Windows scenario matrix; explicit unresolved environment limitations.
|
||||||
|
**Addresses:** Original comparison, preservation and current baseline provenance.
|
||||||
|
**Avoids:** Treating probes, startup frames, cross-publish or older packages as full-game reference evidence. Independent source-backed recovery can continue if reference execution is unavailable, but its acceptance gate stays open.
|
||||||
|
|
||||||
|
### Phase 2: Movement, Contact and Retained Ownership
|
||||||
|
|
||||||
|
**Rationale:** This is the existing stabilization gate before broader gameplay expansion.
|
||||||
|
**Delivers:** Real derived response/helper/physical-order/shared-reclip contracts, supported live admission, animation/control/camera handoffs and integrated lab → VR04 → lab → outside verification.
|
||||||
|
**Addresses:** Jimmy movement, source timing, contacts, fresh/retained/RETURN state and route ownership.
|
||||||
|
**Avoids:** Reopening the solved Carl startup correction, generic resets and premature lab/outside capsule replacement.
|
||||||
|
|
||||||
|
### Phase 3: Actors, Hazards and Combat
|
||||||
|
|
||||||
|
**Rationale:** Gadgets and campaign scripts depend on real class consumers and actor responses.
|
||||||
|
**Delivers:** Supported enemy/NPC sensing/action/RNG, damage/health/death/recovery, special contacts and actual task/contact side effects in playable slices.
|
||||||
|
**Addresses:** Actor/AI/combat and level mechanics foundations.
|
||||||
|
**Avoids:** Synthetic callbacks and generic patrols being called complete original AI.
|
||||||
|
|
||||||
|
### Phase 4: Gadgets, Vehicles and Interaction Coverage
|
||||||
|
|
||||||
|
**Rationale:** Expand on recovered actor/lifetime contracts and preserve already-live bounded gadget scenes.
|
||||||
|
**Delivers:** Remaining original gadgets, all intended consumers and supported modes, activation/cleanup, inventory/energy and transition behavior.
|
||||||
|
**Addresses:** Remote and other remaining functionality, broader existing gadget/vehicle use and source-supported inputs.
|
||||||
|
**Avoids:** Fixture/F1-grant demonstrations substituted for normal gameplay acquisition/use or blanket physical admission.
|
||||||
|
|
||||||
|
### Phase 5: Campaign, Tasks and Level Completion
|
||||||
|
|
||||||
|
**Rationale:** Full progression relies on actors, interactions and gadget consumers.
|
||||||
|
**Delivers:** All evidenced reachable campaign and optional routes, authored missions/scripts, objectives/collectibles, entrances/exits and final outcomes.
|
||||||
|
**Addresses:** Full original content and class-specific progression consumers.
|
||||||
|
**Avoids:** Counting parsed GAMs or rendered levels as playable completion; resolve absent-archive reachability before treating it as a blocker.
|
||||||
|
|
||||||
|
### Phase 6: Frontend, Configuration and Persistence
|
||||||
|
|
||||||
|
**Rationale:** Complete supported gameplay state must survive real player-facing save/resume and menu flows.
|
||||||
|
**Delivers:** Original frontend/HUD/options, persisted configuration, runtime save/load and repeatable equivalent resume across supported checkpoints and retained lifetimes.
|
||||||
|
**Addresses:** Full player workflow beyond debug tools and CLI save operations.
|
||||||
|
**Avoids:** Binary round-trip mistaken for live load correctness; preserving unknown TSK fields does not establish their gameplay semantics. Add necessary persistence earlier when campaign slices require it.
|
||||||
|
|
||||||
|
### Phase 7: Visual, Animation and Audio Fidelity Closure
|
||||||
|
|
||||||
|
**Rationale:** Systematic final presentation closure needs representative complete gameplay, while blocking presentation contracts are recovered earlier.
|
||||||
|
**Delivers:** Matched original/port frames and event/audio timelines; corrected rendering states, pivots, playback, camera/UI details, contextual banks/channels and audible spatial behavior.
|
||||||
|
**Addresses:** Remaining fixed-function and original presentation/sound differences.
|
||||||
|
**Avoids:** Modernization, assumed 60 Hz equivalence and transport/API correctness used as fidelity evidence.
|
||||||
|
|
||||||
|
### Phase 8: Full-Game Native Acceptance and Local Release
|
||||||
|
|
||||||
|
**Rationale:** Only integrated complete journeys can establish final scope and platform claims.
|
||||||
|
**Delivers:** Current clean standalone Linux and Windows packages, full progression/optional-content comparison, physical audio/input/window checks, original hash verification and discrepancy audit.
|
||||||
|
**Addresses:** Complete reconstruction acceptance and reproducible local delivery.
|
||||||
|
**Avoids:** Historical receipts or Wine replacing current native Windows execution; generated packages/original assets remain local while verified source/tools/docs go to Gitea.
|
||||||
|
|
||||||
|
### Phase Ordering Rationale
|
||||||
|
|
||||||
|
Reference access starts early and comparison grows throughout the work. Movement and lifecycle gates precede expansion; actual actors precede their gadget consumers; these enable campaign and complete persistence. Presentation and audio investigations can run independently with exclusive ownership, integrating as soon as they block a gameplay slice. The final presentation and release phases close cross-cutting differences rather than postponing every fidelity check until the end.
|
||||||
|
|
||||||
|
### Research Flags
|
||||||
|
|
||||||
|
- **Phases 1–2:** Targeted environment feasibility and deep original source/runtime investigation; complete helper/response/camera/animation contracts remain open.
|
||||||
|
- **Phases 3–6:** Phase-specific REA/asset/caller recovery is required for real actors, gadget consumers, campaign reachability and frontend/save semantics. Existing bounded implementations reduce work but do not establish remaining policies.
|
||||||
|
- **Phase 7:** Original render/audio state and playback research is essential; reference captures determine acceptance tolerances.
|
||||||
|
- **Phase 8:** Existing package/build patterns can be reused without ecosystem re-research. Native platform execution and original comparison are mandatory validation, not assumed standard behavior.
|
||||||
|
|
||||||
|
## Confidence Assessment
|
||||||
|
|
||||||
|
| Area | Confidence | Notes |
|
||||||
|
|------|------------|-------|
|
||||||
|
| Stack | High for repository foundation | Mandated by specification and corroborated by project configuration; installation/current runtime not reverified here. |
|
||||||
|
| Features | High for full scope; medium for remaining exact behavior | Explicit user/spec scope; detailed remaining behavior still requires original evidence. |
|
||||||
|
| Architecture | High for current boundaries; medium for proposed phase order | Multiple local reports agree; future dependency grouping is planning inference. |
|
||||||
|
| Pitfalls | High as recorded risks | Supported by prior divergence/lifecycle reports; this review does not reproduce their experiments. |
|
||||||
|
|
||||||
|
**Overall confidence:** Medium for the execution roadmap, with strong documented constraints and explicit unresolved original behavior. Generic provider-classifier LOW results in dimension files do not independently certify or invalidate underlying repository evidence.
|
||||||
|
|
||||||
|
### Gaps to Address
|
||||||
|
|
||||||
|
- Working whole-original capture environment and repeatable native Windows access remain unverified dependencies.
|
||||||
|
- Complete physical helper membership/removal/activation, derived soldier/Jimmy effects, shared mutable reclip, camera handoff and animation/sound clocks need focused investigation.
|
||||||
|
- Full reachable content, original frontend/save callers, contextual audio and per-layer rendering remain incomplete; do not fabricate behavior from resource names.
|
||||||
|
- Comparison tolerances must be justified per system from original observations; no blanket pixel-perfect or bit-exact whole-game claim is supported.
|
||||||
|
- Historical reports contain superseded narratives. Prefer dated continuation evidence with exact revision/platform scope before implementation.
|
||||||
|
|
||||||
|
## Sources
|
||||||
|
|
||||||
|
### Authoritative Scope and Repository Rules
|
||||||
|
|
||||||
|
- [PROJECT.md](../PROJECT.md) — user-selected full remaining reconstruction and maximum-fidelity priority.
|
||||||
|
- [prompt.MD](../../../prompt.MD) — original mission, platforms, preservation and full completion requirements.
|
||||||
|
- [AGENTS.md](../../AGENTS.md) — current movement priority, REA requirements and Gitea/local-only artifact policy.
|
||||||
|
|
||||||
|
### Synthesized Research
|
||||||
|
|
||||||
|
- [STACK.md](STACK.md) — existing technology/configuration and verification facilities.
|
||||||
|
- [FEATURES.md](FEATURES.md) — original-required categories, bounded existing support and acceptance gaps.
|
||||||
|
- [ARCHITECTURE.md](ARCHITECTURE.md) — ownership/admission dependencies and solved versus unresolved work.
|
||||||
|
- [PITFALLS.md](PITFALLS.md) — fidelity risks and concrete prevention.
|
||||||
|
|
||||||
|
### Underlying Local Evidence Indexes
|
||||||
|
|
||||||
|
- [Progress](../../docs/progress.md), [compatibility](../../docs/compatibility.md), [tasks](../../docs/tasks.md) — historical implementation/runtime receipts and current limits.
|
||||||
|
- [Coverage](../../docs/checkpoint/coverage.md), [implementation ledger](../../docs/checkpoint/implementation-plan.md), [next-work plan](../../docs/checkpoint/next-work-plan.md) — source recovery and admission gates, including later correction updates.
|
||||||
|
- [Codebase architecture](../codebase/ARCHITECTURE.md), [concerns](../codebase/CONCERNS.md) — current source structure and risks.
|
||||||
|
- Specialized source/probe/runtime reports are linked beside individual findings in the four dimension files. Their evidence scopes remain binding; this synthesis is not new binary or runtime evidence.
|
||||||
|
|
||||||
|
---
|
||||||
|
*Research completed: 2026-11-12*
|
||||||
|
*Ready for roadmap: yes, with unresolved verification dependencies retained explicitly.*
|
||||||
Reference in new issue
Block a user