Files
Neutron/docs/checkpoint/body-contact-implementation.md

111 lines
6.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Body callback ownership implementation
2026-11-05. Continues Jimmy movement after the air/render checkpoint27be8ed.
Current lab/outside capsule and all special-contact admission gates are preserved.
This implements the body publication/mode prerequisites, not new climb/hazard
mechanics or a complete original body in every level.
## Evidence and implementation
[Root publication](body-root-publication.md) records19 new original component
cases using actual copied479D20/47B4B0/kernel. [Body modes](body-modes.md) records87
new observations using full479D20/support/friction and a synthetic dispatcher.
Both reuse retained REA Evidence and guard original spans/offsets/provenance.
`OriginalBodyState` now retains finite live-root W, source previous Vec4, support
anchor and independent `BodyModes`: integration210, support1C8, collision220,
world response1D0 and alternate228. Nullable modes mean the ordinary constructor
defaults; the explicit point constructor supplies W1. Scooter reset now uses that
point constructor instead of zero-initializing W through default(struct).
`OrdinaryBodyStep.PreviousPosition` deliberately stays the frame-entry XYZ
diagnostic consumed by the existing provisional dynamic adapter. It is not used
as a substitute for the newly retained previous Vec4.
- Support clear precedes the integration gate. Inactive integration preserves
roots, anchor, pending work and the existing collision context, then returns.
- The geometry argument/global getter remains independent of body modes. Global
geometry-off follows the recovered gravity/support policy. A scene getter
optionally models support's fresh global read after callbacks.
- World response-off copies current root to previous and translates, retaining
gravity/impulse, optional support/friction and the previous static context.
- Collision-off translates or holds according to228, preserves previous root,
skips support/friction and still reaches suppression. Neither unclipped branch
acquires the world branch's−25000 candidate clamp.
- World callbacks now receive the live entry root, not the tentative clipped
candidate. They may edit live/previous independently. Fresh XYZW equality
controls publication of the precomputed candidate and its original W. Callback
roots rejected by that barrier receive neither old fallingY nor candidate clamp.
Changing both roots to equal still permits the old candidate to overwrite them.
- Support uses fresh live/previous XYZ after publication/rejection. Landing37C
observes the floor root, anchor and zeroed vertical acceleration but old velocity.
Callback root/anchor/acceleration/impulse/modes survive; source cached VX/Z plus
Y0 and supported=true are published afterward. Friction/suppression read current
speed/motion and retain their own ownership.
- The existing wall hook remains wall-only. Ordinary/profile ceiling/reflection
behavior is kept separate. Static context resets only in the world branch;
other branches retain it, reporting zero new traversal work.
`tests/GamePort.BodyOwnershipTests` compares81 complete native mode/landing outputs
and19 root outputs. The17 native root-isolation cases no-op support; the managed
support gate mirrors those publication outputs, while two cases execute actual
support in both implementations. For six native synthetic-dispatch mutation cases,
a real wall delivers the managed callback: owned state/flags/branch continuation
compare, while intentionally different clipped XYZ is not claimed as numeric
conformance. All100 complete comparisons and six state comparisons pass.
Existing20 body,13 Scooter and13 Grappler groups pass in initial targeted runs.
Artifacts: artifacts/body-contact-integration/{ownership-initial,body-initial,
scooter-initial,grappler-initial,build-initial}.log. The full regression, native and
package results are recorded below as verification finishes.
## Remaining integration boundary
No real Jimmy material120..129/110..119/FENCE/LADDER callback is enabled here.
Animation acceptance/end/fallback, hazard/impulse updater4255C0, successful ray
filters, control/facing/action state, dynamic eligibility and scene-wide shared
collision globals still need separate recovery and runtime proof. No callback is
classified ordinary merely to bypass constructor rejection.
LabSimulation still reconstructs the admitted ordinary body each pass; actual
multi-frame special modes must persist actor state when their callbacks are
integrated. Vehicles/projectiles already retain their body records. The per-body
static context remains a bounded approximation of original scene-global ownership.
Radius/factor/friction/suppression arguments remain fixed during the admitted
pass; reentrant/nested body updates and other mutable getter side effects are not
established by these finite probes. Modern F3 noclip is a separate policy.
The root record adds no TSK/save fields or runtime original-code dependency.
Physics remains independent of raw player control. The existing rendering/air
state and upright local alignment from the previous checkpoint are preserved.
## Final regression and native verification
Full scripts/test.sh exits0:333 Python tests,2 HUD extraction checks,45 managed
projects,36 main Vulkan render completions (zero validation errors), original
asset decoders, lab/underground routes, saves, animation and SDL dummy audio
lifecycle, plus539 unchanged original hashes. The main restore/build emitsNU1900
warnings for unavailable vulnerability metadata; no compilation errors occur.
Packaging uses cached dependencies with NuGetAudit=false. Logs and structured
summary: artifacts/body-contact-integration/full-tests.log and validation-summary.json.
Native Linux GTX1070/private Xvfb1920×1080 passes both10-stage Scooter replays,
right-mouse VR04 jetpack, Shift lab walking and control phases with received SDL
input/resize and zero Vulkan errors. All five Jimmy final/airborne captures match
the preserved air-bridge baseline byte-for-byte; baseline-readbacks.json records
that comparison. Default gameplay/scene collision admission is preserved.
## Packaged checkpoint
Both self-contained platform packages identify clean runtime commit
`c9d0c5be59eedba3a92dcd46d1beb96b2e9e941a`, source_dirty=no.519 original copies
and4271 prepared scene/resource files match in each; package-identity.json records
binary/build identities. Standalone Linux from /tmp with SDK variables unset
passes both Scooter scenes and Jimmy walking/jetpack. All27 stage/final readbacks
match development exactly, with zero enabled Vulkan validation errors. Logs:
package-{scooter-vr05,scooter-outside,walk,jetpack}.log and package-readbacks.json.
Post-package audit verifies all539 originals unchanged. Windows cross-publishing
and resource checks remain separate from pending native Windows and original
whole-game comparison. Documentation commits after the runtime revision record
validation; package BUILD-INFO.txt retains exact source provenance.