Files
Neutron/docs/compatibility.md
T

23 KiB

Compatibility and validation

Compilation, native runtime, original behavior and full feature completion are separate evidence categories. The game is not fully reconstructed/playable yet.

C4 ordinary body (2026-10-27 UTC): all ten original-code body references match managed composition. VR04 uses source static response/support/friction and live radius60/100; lab/outside retain the capsule. Twenty body groups plus full suite pass:129 Python+2 HUD, managed checks,27 zero-error enabled-validation GPU renders, SDL dummy lifecycle and539 unchanged originals. Native GTX1070/private Xvfb at 1920x1080 passes300-frame jetpack input/resize/steering/landing. Logs/readback: artifacts/body-composition/. Source scope/independent review are linked from checkpoint/collision-body-implementation.md. Original dynamic actor eligibility, special callbacks, logical/render pivot and modern noclip occupancy remain open. Native Windows and whole-original-game comparisons remain unverified. The final expanded Python suite passes130 checks after the Init authored/live speed closure; the129-check full-integration log predates that extra regression.

C4 static composition follow-up: seven copied-original dispatcher fixtures match the isolated managed grid/retry component; ten copied479D20/support fixtures complete as references for future body composition. No live capsule replacement is claimed. Prepared scenes retain signed material IDs; actual lab/outside special contacts prevent ordinary-only assumptions. See checkpoint/collision-body-probe.md. The temporary automatic approval usage-limit failure was resolved through normal review after its stated reset; original component execution then completed. Full scripts/test.sh passes122 Python plus2 HUD checks, managed suites and27 zero-error enabled-validation GPU completions;11 focused dispatcher groups pass. SDL dummy lifecycle and539 original hashes pass. Evidence is under artifacts/collision-integration/. No new native Windows or whole-game original comparison; preserved baseline and prior release packages are unchanged. Linux-x64 and win-x64 self-contained publish succeeds into separate build artifact directories. Restore's NU1900 records unavailable vulnerability metadata; compile/ publish succeeds. No new distribution package or native Windows execution claimed.

C4 continuation (2026-10-26): REA/bytes recover the bounded47BD80 sphere kernel; ten isolated original Wine32 synthetic cases pass with explicitly guarded fixture rebasing. The managed component matches numeric references; live capsule replacement remains gated. Source-root overhead velocity reflection/mode1 jump/fire cancellation is integrated for LV1B/VR04/LEV1, including without control and with the modern camera query disabled. Full sound/gadget cleanup and other scene filters remain. Registration/repeated Init and shared-eye handoff reports distinguish recovery from pending runtime changes. See checkpoint/collision-response.md and linked reports.

Final scripts/test.sh passes in artifacts/collision-response/integration-final.log: 104 Python checks plus separate HUD checks,25 movement groups, five new sphere groups, remaining managed checks,27 zero-error enabled-validation GPU completions, SDL dummy lifecycle and539 unchanged original hashes. Both input-only routes use the source geometry queries and retain their progression/contact checks. Native Linux GTX1070 at1280x720 passes Carl/control, jetpack SDL keys/resize and debug tools/checkpoint reload (four commands, five renders), zero validation errors. The original component probe is not whole-game or native Windows validation.

Both self-contained packages identify clean57dfcc6, source_dirty=no. Standalone Linux from /tmp passes the control-phase fixture and nondefault tutorial/RETURN assertions. These release invocations lack validation layers; enabled source and native-window evidence above is separate. Logs: artifacts/collision-response/ package.log, package-control.log and package-return.log. Baseline untouched; Windows cross-publication adds no native Windows runtime claim.

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.

Both self-contained packages identify clean commit c285b57 (source_dirty=no). Standalone Linux launches from /tmp pass the airborne control-phase fixture and nondefault tutorial/RETURN scalar, root, companion and availability assertions. Release validation layers are unavailable; enabled-validation results above are separate. Logs: artifacts/uncontrolled-phases/package.log, package-control.log and package-return.log. Preserved baseline untouched; Windows cross-publication adds no native Windows runtime evidence.

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.