Files
Neutron/docs/compatibility.md
T

194 lines
18 KiB
Markdown

# Compatibility and validation
Compilation, native runtime, original behavior and full feature completion are
separate evidence categories. **The game is not fully reconstructed/playable yet.**
Control-phase continuation (2026-10-26): body/fire eligibility and ordered raw
preparations are source-byte guarded separately from port behavior. Targeted24
movement groups, coupled director/preparation tests and the airborne control
fixture pass. Native Linux GTX1070 at1280x720 passes Carl/control-phase, F1 pause/
Force Control and F3/tools/same-window checkpoint checks, all with enabled Vulkan
validation and zero errors. The input-only route uses the actual binding and
Down braking at turns; source score/task/inventory/contact checks still pass.
Detailed gaps: checkpoint/control-phase-implementation.md. Native Windows and
original whole-game comparisons remain unverified for this chunk.
Full scripts/test.sh passes in artifacts/uncontrolled-phases/integration-final.log:
93 Python checks,24 movement groups plus remaining managed groups,27 zero-error
GPU renders with enabled validation, SDL dummy checks and539 unchanged hashes.
REA6.8.0/Ghidra12.1.4 decompiled five selected procedures locally using a generated
copy; complete Evidence is retained.421FB0 lacked a recognized procedure; that
limit is recorded without replacing its existing byte/vtable evidence. Static
pseudocode is not original execution. See rea.md for local installation and CLI.
Retained-state continuation (2026-10-26):14 new source-evidence tests and22
movement groups cover named property loading, cleanup/Init/PostLoad/control
boundaries and bounded route scalar carry. Corrected full tutorial/lab gadget
availability and TSK/unknown-state tests pass. An isolated Wine32 component probe
executes copied original vector accessors and43A750 with synthetic fixture vtables
and invalid sound handle; source targets are byte-guarded. It confirms body-field
writes and unrelated sentinel preservation, not full loader/gameplay or native
Windows behavior. Evidence: artifacts/retained-lifecycle/original-probe/wine.log.
Integration:84 Python checks, all managed groups and26 GPU render checks pass
with zero enabled-validation errors. Final nondefault mode1/hold.625/fire6.125
ordinary-load replay independently checks jump/body resets on tutorial and RETURN;
all539 original hashes unchanged. A fixed200ms effects-smoke baseline failed under
load; paused stream construction plus a bounded consumption poll removes that
sampling assumption (the initial failure did not record its queue baseline). All four SDL dummy audio checks pass in audio-final.log; final route is in
route-final.log. No new native Windows runtime verification.
Both self-contained packages rebuilt from clean9ad5a8e, source_dirty=no. Linux
standalone launch from /tmp passes nondefault lab→VR04→lab scalar/body/RETURN
assertions, with the same presentation instance retained. That release invocation
has validation unavailable; source GPU enabled-validation evidence remains separate.
Logs: artifacts/retained-lifecycle/package.log and package-route.log.
Debug expansion (2026-10-25): full scripts/test.sh passes, with70 Python checks,
21 movement groups, debug page/overlay groups, real SDL dummy pause/mute timing,
remaining managed/GPU routes and539 unchanged original hashes. Native Linux
GTX1070 at1920x1080 passes F1/Tab/F3, flight during a source cutscene, input capture,
camera/audio controls, checkpoint save/load and same-window rebuild. Enabled Vulkan
validation reports zero errors. Headless Player1920x1080 and Systems2560x1080
screenshots fit; see artifacts/debug-expansion/. SDL_SetAudioStreamGain is present
in the packaged Windows SDL3 DLL export table. Cross-build/export evidence does
not add native Windows runtime or original-game behavior verification.
Both platform packages rebuilt from clean d783898, source_dirty=no. Standalone
Linux package launched from /tmp with Player page/noclip1920x1080 passes on
llvmpipe; that invocation lacks validation layers. Evidence: package.log and
package-smoke.log under artifacts/debug-expansion/.
Latest implementation continuation: controlled player phase ordering, route static
camera query and PostLoad gadget availability pass the full `scripts/test.sh`.
Evidence: artifacts/implementation/integration-final.log;70 Python regressions,
20 movement groups,11 new camera groups,13 existing support groups, remaining
managed groups, GPU story/practice/RETURN/Carl/objective/jetpack/animation checks,
SDL dummy lifecycle and539 unchanged original hashes. GPU validation is enabled
and every run reports zero errors. Native Windows runtime and original-game
comparison are not added by these tests. Known limits remain explicit in the
current checkpoint coverage/implementation reports.
Both self-contained packages now identify clean09cf117. Linux release smoke from
`/tmp` passes practice/RETURN (including input order and gadget availability) and
outside load; see linux-package-return.log and linux-package-outside.log under
artifacts/implementation/. Those release invocations have validation unavailable;
the enabled-validation evidence is the full integration run above. Windows is
cross-published, with no additional native Windows runtime claim.
Architecture checkpoint: see `checkpoint/review.md` for coverage and remaining
gates. C1 objective/task order and C2 per-actor Carl callback corrections pass the
full `scripts/test.sh` integration, all GPU runs with zero Vulkan validation
errors. Final Python discovery passes62 tests including the additional source
evidence follow-ups. All539 original hashes remain unchanged. These checks do not
add native Windows or original whole-game runtime verification; earlier Windows
user reports remain limited to their tested builds and route.
Self-contained Linux/Windows packages rebuilt from clean531883a. The Linux release
package passes the60-frame Carl held-input/control-lock smoke from `/tmp`;
validation layers were unavailable for that invocation. Current Windows release
is cross-published, not newly native-runtime verified. Later loader-provenance
edits affect evidence/tests only; runtime code is unchanged from that package.
| Feature | Implemented / tested | Evidence and limits |
|---|---|---|
| Original preservation | Verified after extraction/runtime tests | All539 original SHA-256 hashes unchanged |
| GAM Python / C# | All35 files,3299 entities | Exact Python round-trip; C# corpus/start/corruption checks |
| OMT recovery | All100 archives audited | 2155meshes,2183materials,1614textures,875RIFF, zero failures |
| C# original loaders | Linux runtime | All128 PNG /254 ASE base meshes; morph/base UV tests |
| .NET10 Linux build | Pass, zero warnings/errors | Local SDK10.0.402/runtime10.0.13 |
| Windows x64 publish | Pass | Correct PE32+ app and SDL3.dll; initial native rendering user-reported |
| Windows story/practice package under Wine64 | Preliminary headless/window pass |12s story;12-frame practice pause/N/resume/resize and original streams; simulation matches Linux; validation disabled |
| Corrected Windows preview under Wine64 | Preliminary window pass | Six frames, key2 animation switch, resize800x600, exit0; validation disabled |
| Windows walking package under Wine64 | Preliminary240-step window pass | SDL arrows/Shift, walking/jump/landing and800x600 resize; matches Linux movement statistics; validation disabled |
| Linux self-contained package | Native headless/window verified |12s story without SDK/source/Original mounted; GTX1070 practice pause/N/resume/resize, zero validation errors |
| Vulkan1.3 lab | llvmpipe + GTX1070 | Real indexed/textured/depth frame/readback; validation enabled, zero errors |
| Original camera/projection | Source mapping/math + outside GPU before/after |All35 level far overrides; outside28000/tutorial50000; merged layer maximum is a port policy, per-layer masks/dynamic fog incomplete |
| Jimmy normal texture / morph | Native preview verified | Correct atlas slot0, base topology/UV retained; state speed/loop unverified |
| Standing preview placement | Corrected / Linux tested | +38.503Y from actual visible floor/base soles; exact original actor transform unresolved |
| Idle/run/jump/scratch preview | Linux keyboard + GPU tests | Default idle samples identical; 1/2/3/4 select clips; run image changes across frames |
| Null-material visibility | Binary rule implemented/tested | Original DX renderer skips null pointers; proxy geometry retained |
| SDL3 presentation/input | Linux Xvfb + GTX1070 | Six frames; injected keyboard event received |
| Swapchain resize | Linux tested | 960x720 ->800x600, zero validation errors |
| Persistent level presentation | Native GTX1070 six-load pass |One window/renderer; stable IDs/core resources, bounds/focus/fullscreen; invalid load retains rendering; zero cumulative Vulkan errors |
| Widescreen HUD/debug UI | Managed matrix + native captures/pointer pass |Uniform proportions, centered modal/F1, anchored HUD/F2;4:3/16:9/21:9/32:9, DPI and strict boundary checks |
| F1 debug menu | Managed/SDL audio tests + native Linux GTX1070 window pass |Pause/actions/input capture/resume/800x600 resize, zero validation errors;33 prepared scene/start choices; intentional modern tools, no new Windows runtime claim |
| F1 Force Control | Menu/director/interaction checks + native Linux SDL pass |Persistent override through source shots; disable/reset restores normal ownership; actual movement with neutron1a active, zero Vulkan errors; music handoff regression passes |
| F2 live debug overlay | Managed timing/layout/menu + native Linux SDL pass |Non-pausing movement, visibility/repeat/menu priority and800x600 resize; all checks true, zero Vulkan errors; session persistence; modern tools, no new Windows runtime claim |
| Focus / fullscreen | Code present, partial/unverified | Focus clears keys; fullscreen toggle not dynamically tested |
| Mouse/relative input/controller | Incomplete | SDL entry point declaration alone is not behavior |
| Audio stream | Linux dummy device | Original11025Hz mono WAV consumed10752bytes/500ms; speakers untested |
| Physics fragments/RNG | Standalone C# tests | Recovered arithmetic; controller/jump/collision state incomplete |
| Walking/jump/air controller |18 movement groups + GPU replay pass |Corrected mode1 fall-through to source air handler: acceleration/braking/turning during jumps and bursts; RETURN root placement; phase/collision/lean remain provisional |
| Static source collision |11 deterministic groups + source NC byte checks pass |2851 lab collision triangles after excluding18 NC-shape triangles; all2869 render/source triangles and325 null-material proxies retained; solver/dimensions provisional |
| Simulation cadence |18 movement groups pass | Fixed60Hz independent of60/120/144Hz rendering, ten-minute finite run; original cadence unresolved |
| Walking camera and animation | Linux headless/window pass | Original five motion clips, recovered eye180/target99; pivot, timing and obstruction solver provisional |
| Walk SDL input/resize | GTX1070/Xvfb input replay pass |Current corrected managed/headless replay1252.09; all five jump bindings produce identical300-frame powered replays,403.88 travel; zero validation errors |
| TSK saves/task gates | All12 originals byte-round-trip | Bounded parse/write, task/items/score/checkpoint CLI resume; full game-state/menu save incomplete |
| Lab CAM/MCA/AI interpreter | Source sequence/Carl lock tests + Linux GPU pass |16 intro cues; neutron1a locks move/turn/jump for all active MCA shots, restores JIM1 at completion/skip; no original comparison |
| Dynamic actors/sprites/models | Linux GPU pass |Carl/Goddard/Jimmy morphs, source Canv timing and9 original lab props; billboard/alpha, pivots and playback timing remain provisional |
| Scene music/speech | Linux dummy-device pass |CAM stops music before speech; full lab chain stays silent, DEFAULT restarts on completion/skip; reset tested. Packaged Linux/Wine64 lifecycle checks pass; speakers/latency/native Windows unverified |
| VR01 star/trophy contacts | Source-data tests pass |5-point stars,300 trophy, acquired flags and contact-enter semantics; distance/exclusions/box approximation |
| RETURN / scene reload |Source/director tests + Linux headless pass |Lab/VR04/lab restores departure root/companion using one renderer, retains STRT yaw and suppresses intro; fresh TSK loading separate; original fades unverified |
| Supplied scene availability |All35 GAMs supplied;33 have OMT geometry |Level3B/E GAMs are duplicate four-entity records apart from level code; registered OMT archives absent, normal gameplay use unverified; no substitution or established blocker |
| Lab task/contact route | Managed input replay + headless GPU pass |887 input-only movement steps with live contacts/NPC updates reachSCENE60, score150, jetpack andlevel1; separate direct-contact GPU rebuild check |
| Lab underground passage |2763-step managed input replay pass |Both switches,2 clear crossings and timed reclosure; closed-gate negative sweep; explicit riverlab/SCENE65 fixture, prior progression and original comparison unverified |
| Patrol/support |10 patrol +13 support groups pass |Source phases/profiles and8 DLL magnitude refs; Carl sensing, Goddard follow and full wall response incomplete |
| Buttons/doors | Source state tests and GPU props pass |Cooldown, hold/reversal, original model transforms; source broadphase/box order with modern narrowphase |
| Dynamic collision |10 managed groups pass |Includes actual closed/open lab bars; full source solver/activation exclusions incomplete |
| Lab objectives/practice | Source timer/O tests + managed/headless/SDL pass |Original popup slide/timeout and O latch integrated; pad/content separate; modal pause/No reset; practice highlights/controller still incomplete |
| Jetpack tutorial |14 vertical groups +16 movement groups +300-step VR04 GPU pass |Powered horizontal travel403.88, turn/brake/release and landing; rise418.98, zero validation errors; phase/shadow/collision/lean approximations |
| Powered SDL/package steering |Linux GTX1070 and preliminary Wine64 window pass |300 frames, Up/Left/Down/Shift received, resize800x600, travel403.88/landing; Linux zero validation errors, Wine validation disabled; native Windows pending |
| Default effects bank |251 exact RIFF exports, SDL dummy pass |Pickup/button/door sounds and owner-loop stop; positional/volume/channel policy incomplete; MPEG-in-RIFF bird1/id162 unsupported by SDL WAV |
| Complete scene/gameplay loop | Incomplete |Lab navigation, exact collision/pivot/cadence and original reference comparison still required |
| Menus/AI/combat/progression/saves | Incomplete | Required future work |
| Original execution | Attempted under isolated Wine11 | Window created, GL/Vulkan rendering unusable; no reference comparison |
| Native Windows functionality | User confirms lab/tutorial/lab/outside and corrected build works |User built/tested Windows; comprehensive native input/audio/resize/driver coverage and original comparison remain unverified by the agent |
Generated evidence: artifacts/full-integration-test.log, practice-window.log,
practice-transition.log, jetpack-runtime.log, final-tests.log, test-level1b.ppm, test-player.ppm,
resize-input.ppm, package-linux.ppm, extracted/audit.json and reference*/ logs.
The lab/player images have been visually inspected; they do not establish original
visual equivalence. Windows cross-publishing must not be represented as Windows
runtime validation. Package scope and prerequisites are in infrastructure.md.
Current four-fix regression evidence: artifacts/four-bugs-full-tests.log (complete
suite and539 preserved hashes), jump-binding-parity.json, outside-fixed-clip.png,
package-objective-window.log and package-carl-cutscene.log. Both platforms publish
successfully; packaged Linux popup/Carl checks pass with zero Vulkan validation
errors. The already-started Wine64 popup/O/resize check passes with validation
disabled. Further package checks were skipped at the user's request after they
reported their own Windows build works. No new agent native Windows claim is made.
Subsequent RETURN/underground checkpoint: artifacts/return-underground-tests.log
passes the complete suite (41 Python checks,18 movement groups, source checkpoint
checks, actual lab/VR04/lab rendering, underground input replay and539 unchanged
originals). RETURN restores the exact departure root and companion, retains STRT
yaw and suppresses intro, with zero Vulkan validation errors. NC registration
exclusion fixes the underground water-plane rise while retaining rendering.
Both Linux x64 and Windows x64 self-contained executables republish successfully.
No subsequent native Windows/Wine runtime check is claimed.
F1 menu checkpoint: artifacts/debug-menu-full-tests.log passes the full suite,
including actual SDL audio pause/resume and539 unchanged originals. Native Linux
window/input/action/resize evidence is artifacts/debug-window.log; screenshots
were visually inspected. Both Linux and Windows self-contained packages publish
successfully. No new Windows/Wine runtime check was run for this addition.
Live F2 diagnostics: artifacts/live-debug-full-tests.log passes the full suite
and539 original hashes. Native SDL live movement/menu/visibility/resize and the
existing force-control check pass with zero Vulkan errors. Headless lab/VR04/lab
retains visibility and samples1/2/3 with zero errors; camera/layout/timing groups
pass. See artifacts/live-debug-window.log and live-debug-return.log. No new
Windows runtime claim is made.
Both self-contained platform packages rebuild successfully with this addition.
Persistent presentation/widescreen checkpoint: full regression suite passes in
artifacts/persistent-widescreen-full-tests.log, including539 preserved hashes.
Native6-load/one-window/one-renderer fullscreen/bounds/focus/pointer checks pass
with zero enabled-layer errors (artifacts/window-transition-final.log). F1/force
and F2 input checks still pass. Both packages rebuild; packaged Linux1920x1080
lab/VR04/lab retains one renderer and exact RETURN state with validation unavailable.
No new native Windows runtime claim is made.
Known visual/behavior limits include incomplete lighting/fog/blend/culling/material
mapping, inferred model/root pivot, provisional collision/cadence/animation timing,
close-wall camera clipping near Jimmy, incomplete class-specific triggers/interactions,
and no original comparison captures. Walk evidence: artifacts/walk-tests.log,
test-walk.ppm, walk-start.png and walk-window.ppm. Original fidelity is unverified.