feat(runtime): own SetPosition collision reports
This commit is contained in:
Erik
parent
ec627c13a2
commit
237d1184d2
19 changed files with 3744 additions and 103 deletions
|
|
@ -241,6 +241,9 @@ src/
|
|||
Physics/
|
||||
RuntimePhysicsState.cs -> per-session engine/cache/scratch/shadows,
|
||||
collision receipts, bodies/hosts/worksets
|
||||
RuntimeCollisionReportingState.cs -> exact-key retail collision table,
|
||||
environment latch, ordered callbacks, and
|
||||
SetPosition report-result ownership
|
||||
RuntimeSetPositionState.cs -> exact placement/lost-cell operations,
|
||||
authored mover retention, ordered host
|
||||
receipts, and collision-generation wake
|
||||
|
|
@ -336,9 +339,11 @@ src/
|
|||
```
|
||||
|
||||
The 4B2 production SetPosition routes and shared local-controller body remain
|
||||
dormant until exact authored mover preparation, collision-report return,
|
||||
presentation-only rebucketing, placement-prefix quiescence, and an atomic
|
||||
Runtime body/controller publication transaction land as one reviewed cutover.
|
||||
dormant. Runtime now owns the exact collision table, environment latch, and
|
||||
report-result semantics needed by that cutover. Activation still waits for
|
||||
exact authored mover preparation, presentation-only rebucketing,
|
||||
placement-prefix quiescence, and an atomic Runtime body/controller publication
|
||||
transaction to land as one reviewed cutover.
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -107,7 +107,7 @@ readiness/requeue adaptation. See
|
|||
| AD-51 | **Filed at Campaign N slice N4 (2026-07-29).** The inbound sequence tracker keeps a reclaimed-word pool (per-parked-word draw ordinals + `PriorityQueue` consumed lowest-draw-order-first) that retail has no counterpart for: on a VALIDATED cleartext `RejectRetransmit`, the word the gap walk parked for the reject packet's OWN sequence is removed, every later-drawn parked word is shifted down one position, and the excess word feeds the next fresh draws. | `src/AcDream.Core.Net/Transport/InboundSequenceTracker.cs` (`OnCleartextRejectSequence`, `NextWord`, `ParkedWord`); trigger at `src/AcDream.Core.Net/WorldSession.cs` (RejectRetransmit consumption) | Retail's inbound invariant is "every missing id was an encrypted packet whose keystream word the server drew" — true against retail servers, whose cleartext packets always borrow live sequences (acks/NAKs reuse `highestIDSent_`; `FlowQueue::TransmitNewPackets @ 0x00547A60` sequences only reliable packets). ACE breaks it in exactly one place: `RejectRetransmit` takes a FRESH sequence through FlushPackets, cleartext, drawing NO S2C keystream word, and is cached (ACE NetworkSession.cs:299-304, :722-725, :743-748). Without the reclaim, our gap walk pre-draws a word for that id, the inbound stream runs permanently one word ahead, and every later encrypted packet fails checksum — the N2 desync class reintroduced through the reject path. The pool is provably empty against a retail server, so retail behavior is untouched. Reject BODY ids keep the N2 discard (their words were drawn on both sides — consumed-in-place). Known unreachable corner: a reject whose own id later appears inside another reject's body (first reject pruned after 120 s of sustained loss with the session alive) would discard a never-drawn word; probabilistically impossible against ACE's 60 s silence timeout and the 0.6 s NAK cadence. | Against a hypothetical non-ACE server that assigns fresh cleartext sequences to packets OTHER than RejectRetransmit, those ids would still mis-park with no reclaim trigger — inbound desync. Only ACE-family servers exist for this client today, and ACE has exactly the one path. | `SharedNet::ProcessNewestSeqNum @ 0x00541930` (the gap walk whose invariant ACE breaks); `SharedNet::HandleEmptyAck @ 0x005448F0` (retail's reject consumption — body ids only, no own-sequence machinery because retail never needs it) |
|
||||
| AD-52 | **Filed at Campaign N slice N6 (2026-07-29).** The inbound fragment assembler evicts incomplete partial messages 60 s after their last ACCEPTED fragment (swept on retail's 5 s flush cadence from `ReliableTransport.Sweep`) and remembers the last 64 completed multi-fragment sequences in a ring so a late duplicate fragment of an already-completed message drops instead of allocating a fresh partial that can never complete. Retail's prune target and horizon differ: its 5 s-TTL `FlushTimedOutEphInfo` table holds ephemeral-blob ORDERING stamps (the AD-49 deferral), not partial payloads. | `src/AcDream.Core.Net/Packets/FragmentAssembler.cs` (`SweepExpired`, `PartialTtlSeconds`, `CompletedRingSize`); cadence in `src/AcDream.Core.Net/Transport/ReliableTransport.cs` (`AssemblerSweepSeconds`) | N4's RejectRetransmit abandonment made an unrecoverable partial a REACHABLE permanent state: ACE pruned a fragment-bearing packet from its 120 s S2C cache and told us to stop asking, so that blob can never complete — without a TTL it leaks for the session's lifetime. 60 s is ≫ every recovery horizon (0.6 s NAK cadence, ACE's 2 s ack, the 120 s cache) and the stamp refreshes on every accepted fragment (retail's own re-stamp rule, `ArrivedEphInfo::UpdateNetBlobID @ 0x0054AE00`), so only a server-abandoned partial can age out — a merely-slow one cannot. The ring is bounded (64 × 4 B) and its only false negative (a duplicate arriving after 64 later completions) degrades to the pre-N6 behavior, now reclaimed by the TTL. | If ACE ever legitimately re-served a fragment of a completed message under a REUSED fragment sequence within the ring window, it would be dropped — but fragment sequences are strictly monotonic per session (ACE SessionConnectionData.FragmentSequence), so reuse cannot happen inside one connection. An evicted partial whose fragments later straggle in re-partials and re-evicts — bounded churn, no corruption. | `Indicator::FlushTimedOutEphInfo @ 0x0054A3D0` (the 5.0 s flush gate at 0x0054A3DC); `ArrivedEphInfo::fTimedOut @ 0x0054AE30` (per-entry 5.0 s TTL); `ArrivedEphInfo::UpdateNetBlobID @ 0x0054AE00` (re-stamp on update); retail has no partial-payload TTL — its blob layer trusts its own NAK persistence, which N4's ACE-mandated abandonment (`SharedNet::HandleEmptyAck @ 0x005448F0`) breaks |
|
||||
| AD-38 | Outgoing teleport viewports retire when retail's quantized animation level exceeds the last captured visible level 1022 (index 96), suppressing levels 1023/1024 up to 20.2 ms before retail's literal `elapsed >= 1.0` state edge. Incoming fades retain the exact timer. | `src/AcDream.Core/World/TeleportAnimSequencer.cs` (`OutgoingViewportReachedTerminalProjection`) | An uncapped 2000 FPS pass can publish the finite tunnel at levels 1023/1024 even though the paired 2013 retail capture switches viewports after 1022. The table-level cutover preserves the captured visible viewport ordering without throttling the application. | Exit sound, viewport replacement, and logout tunnel entry can occur at most two easing-table quanta (about 20.2 ms) earlier than retail's logical timer. | `UIGlobals::GetAnimLevel @ 0x004EE540`; `gmSmartBoxUI::UseTime @ 0x004D6E30`; paired retail/acdream captures documented in `docs/research/2026-07-15-retail-portal-space-pseudocode.md` |
|
||||
| AD-1 | **NARROWED 2026-07-31 (placement Slice 4B2 checkpoint 1).** Runtime now owns exact lost-cell residence, adjusted frame retention, 25-second root/direct-child lifetime, generation-scoped wake, revisioned Withdraw/Place receipts, and one public generation-gated observe/retry/exact-ack seam. Shared local-controller body adoption remains deferred to the atomic all-route ownership cutover. Production authoritative placement still routes through the legacy recoverable outdoor demote and outdoor-restore `max(terrainZ, z)` lift until the remaining 4B2 prerequisites and routes cut over atomically. | `src/AcDream.Runtime/Physics/RuntimeSetPositionState.cs`; `src/AcDream.Runtime/Physics/RuntimePlacementProjectionChannel.cs`; legacy route in `src/AcDream.Core/Physics/PhysicsEngine.cs` | The canonical owner remains dormant and separately gated, so this ownership checkpoint cannot partially change the accepted production world. | Until 4B2, a production gap can still commit an outdoor approximation inside/under a building or lift a legitimate below-heightmap restore instead of entering the now-available Runtime lost-cell owner. | `GotoLostCell` pc:283418; `SetPositionInternal` 0x00515bd0, pc:283892-283945 |
|
||||
| AD-1 | **NARROWED 2026-07-31 (placement Slice 4B2 checkpoint 2).** Runtime now owns exact lost-cell residence, adjusted frame retention, 25-second root/direct-child lifetime, generation-scoped wake, revisioned Withdraw/Place receipts, one public generation-gated observe/retry/exact-ack seam, and the retail collision-table/report-result state needed by SetPosition. Shared local-controller body adoption remains deferred to the atomic all-route ownership cutover. Production authoritative placement still routes through the legacy recoverable outdoor demote and outdoor-restore `max(terrainZ, z)` lift until the remaining authored-mover, rebucketing, prefix-quiescence, body-publication, and route-cutover prerequisites land atomically. | `src/AcDream.Runtime/Physics/RuntimeSetPositionState.cs`; `src/AcDream.Runtime/Physics/RuntimeCollisionReportingState.cs`; `src/AcDream.Runtime/Physics/RuntimePlacementProjectionChannel.cs`; legacy route in `src/AcDream.Core/Physics/PhysicsEngine.cs` | The canonical owners remain dormant and separately gated, so this ownership checkpoint cannot partially change the accepted production world. | Until 4B2, a production gap can still commit an outdoor approximation inside/under a building or lift a legitimate below-heightmap restore instead of entering the now-available Runtime lost-cell owner. | `GotoLostCell` pc:283418; `SetPositionInternal` 0x00515bd0, pc:283892-283945; `CPhysicsObj::handle_all_collisions` 0x00514780 |
|
||||
| AD-2 | Async readiness gates replace retail's synchronous destination cell load. **#229 refinement (2026-07-20):** login and F751 portal-space exit now share `WorldRevealReadinessBarrier`, so neither path can expose the normal viewport until the same render-publication, composite-texture, and collision domains converge. A hydratable indoor claim requires its owning Near-tier static/EnvCell mesh set, destination composites, and exact EnvCell physics (`IsSpawnCellReady`); an outdoor claim requires those render domains plus terrain/collision residency for the required Near ring. Hard-recenter generations and tier-aware completion application prevent stale overlapping loads/unloads or Far/Near jobs from opening or erasing the gate; mesh upload remains separate from balanced landblock ownership. Claims beyond NumCells still take the loud unhydratable-placement path. `RuntimeWorldTransitState` owns the shared reveal generation, accepted readiness, transit correlation, and exact generation/cell-scoped host-acknowledgement suffix. `WorldRevealCoordinator` is a graphical adapter holding only App resource receipts; normalized Runtime checkpoints observe ownership without defining another readiness path. **Slice E3 refinement (2026-07-24):** the same generation now publishes an immediate `WorldGenerationQuiescence` edge: old-world drawing/spatial queries, simulation/effect clocks, reconciliation, targeting, and 3-D audio stop while retained physical teardown advances through metered cursors and destination network/UI/streaming/readiness remain live. **Slice E4 refinement (2026-07-24):** accepted render/physics/static publication may span update frames through retained exact cursors, but reveal still consumes only the completed spatial/render-ready generation; building and EnvCell snapshots remain invisible until complete and the final spatial identity swap stays observer-atomic. **Slice E5 refinement (2026-07-24):** the reveal generation owns one exact destination reservation across every typed budget dimension. Stale completion cannot consume or clear its replacement, and hydratable incomplete content is never force-revealed; portal transit retains the DAT tunnel and centered retail wait cue until readiness converges. The hold→materialize→regain-control lifecycle remains owned by `TeleportAnimSequencer`. | `src/AcDream.Runtime/World/RuntimeWorldTransitState.cs`; `src/AcDream.App/Streaming/WorldRevealCoordinator.cs`; `src/AcDream.App/Streaming/WorldGenerationQuiescence.cs`; `src/AcDream.App/Streaming/WorldRevealReadinessBarrier.cs`; `src/AcDream.App/Streaming/StreamingOriginRecenterCoordinator.cs`; `src/AcDream.App/Streaming/LandblockPresentationPipeline.cs`; `src/AcDream.App/Streaming/StreamingController.cs`; `src/AcDream.App/Rendering/PortalTunnelPresentation.cs`; `src/AcDream.App/UI/PortalWaitNoticeController.cs`; `src/AcDream.App/Streaming/GpuWorldState.cs` (`IsRenderReady`); `src/AcDream.App/Rendering/Wb/LandblockSpawnAdapter.cs`; `src/AcDream.Core/Physics/PhysicsEngine.cs` (`IsSpawnCellReady`, `IsNeighborhoodTerrainResident`) | This is the asynchronous equivalent of retail leaving `SmartBox::position_update_complete` false while `CellManager::blocking_for_cells` is set: neither initial login nor portal arrival may reveal or continue simulating an old/partial collision world, a terrain-only Far shell, or a published-but-not-drawable GPU landblock. Indoor does not require a terrain heightmap, only the owning render landblock and exact EnvCell. | Gate opens early → grey/untextured first login or portal reveal, free-fall, wrong-cell rooting, missing scenery, or a still-active old generation; predicate never satisfies (streamer/DAT/upload failure) → login remains behind the world render gate, while portal transit remains in the authored tunnel and presents the centered wait cue after five seconds. | `SmartBox::UseTime` 0x00455410; `gmSmartBoxUI::UseTime` 0x004D6E30; `gmSmartBoxUI::EndTeleportAnimation` 0x004D65A0 |
|
||||
| AD-5 | Outdoor `point_in_cell` is an identity compare against the global XY-column cell from `LandDefs.AdjustToOutside` (no per-cell containment test) | `src/AcDream.Core/Physics/CellTransit.cs:865` | Landcells are disjoint 24 m columns — identity-compare against the column under the sphere centre is exactly equivalent to retail's per-candidate test | If block-origin/lcoord math is wrong at a landblock seam, the compare silently never matches — outdoor membership freezes at boundaries (the pre-#106 symptom) | `find_cell_list` pick pc:308788-308825; `CLandCell::point_in_cell` (get_block_offset pc:308804) |
|
||||
| ~~AD-6~~ | **RETIRED 2026-07-31 (placement/streaming Slice 3B).** Cell/cache/topology/building/static-shadow publication plus every retained non-suspended owner touching or withdrawn from the prefix is one Runtime-owned collision generation. Retained includes dynamics and adjacent-root statics; only target-root statics are superseded by the authored replacement. App and Headless build one shared off-side `CollisionWorldState` through one-work-unit preparation/capture/seal cursors. Admission captures the active root in O(1); a stable landblock/owner slot suffix materializes non-target leaves incrementally, so resident-world size cannot become a synchronous clone spike. Reusable per-prefix owner slots and one Runtime-scoped versioned journal replace event-time exact-copy fanout: repeated live mutations coalesce by owner, every draft reconciles only that owner's latest exact state one owner per seal call, discovered relevant owners receive scoped exact updates, and visited unrelated owners receive only a cheap coalesced dirty notification before metered replay. Once topology sealing finishes, observed owners temporarily write through exactly until same-call activation; the finite pre-seal queue therefore drains even under continuous multi-owner movement. New drafts start at their captured journal suffix; old slots are superseded rather than reused behind live cursors and compact through the same meter. Unrelated churn therefore never restarts or starves target capture/sealing. Deterministically ordered concurrent preparations receive committed—not merely sealed—peer deltas and rebase one cache, graph, landblock, or owner leaf per seal step; cancellation therefore cannot leak unpublished topology. Demotion/withdrawal cancels a matching queued or active rebase, suppresses the prefix in unfinished source scans, and retires one owner/cache/graph/outdoor leaf per seal call. The complete previous generation remains queryable until one zero-managed-byte volatile root transfer in the same update-thread call as final reconciliation; that preserves PhysicsDataCache, CellGraph, PhysicsEngine, and ShadowObjectRegistry facade identity, revokes staging, and requires no quiet frame. A stale admission or staging failure disposes only that private generation and cannot withdraw the active world or invalidate a newer admission. Authored same-ID target statics, live-current-cell changes, owner departure/reuse, newly relevant seam-crossing statics, and teardown remain coherent across drafts; empty per-prefix owner containers are reclaimed without invalidating captured seal cursors. The commit clears repaired withdrawal markers before its single notification/readiness acknowledgement, so no optional hydration callback can omit reflood and no observer sees mixed old/new cells. | `src/AcDream.Runtime/Physics/RuntimePhysicsState.cs` (`PrepareCollisionGeneration`, `AdvanceCollisionGenerationPreparation`, `AdvanceCollisionGenerationSeal`, `CommitCollisionGeneration`); `src/AcDream.Core/Physics/CollisionWorldState.cs`; `PhysicsDataCache.cs`; `PhysicsEngine.cs`; `ShadowObjectRegistry.cs`; `src/AcDream.App/Streaming/LandblockPhysicsPublisher.cs`; `src/AcDream.Headless/Hosting/HeadlessSessionWorldProjection.cs`; `tests/AcDream.Runtime.Tests/Physics/RuntimePhysicsStateTests.cs`; `tests/AcDream.App.Tests/Streaming/LandblockPhysicsPublisherTests.cs`; `tests/AcDream.Headless.Tests/HeadlessSessionHostTests.cs` | — | — | `CObjCell::init_objects` → `CPhysicsObj::recalc_cross_cells`, 0x0052b420 / 0x00515a30; `CPhysicsObj::SetPositionInternal` shadow replacement tail 0x00515330 |
|
||||
|
|
@ -155,7 +155,7 @@ AP-94..AP-112 for the confirmed retail-UI completion gaps.
|
|||
|
||||
| # | Divergence | Where (file:line) | Why it is safe / justified | Risk if assumption breaks | Retail oracle |
|
||||
|---|---|---|---|---|---|
|
||||
| AP-1 | **NARROWED 2026-07-31 (placement/streaming Slice 4B2 checkpoint 1).** Core exposes the pure retail `SetPosition` transaction; Runtime owns its exact accepted operation, complete canonical commit, deferred residence, lifetime, generation wake, and revisioned host receipts; and one public generation-gated channel exposes observe/retry/exact-head acknowledgement without another queue. Shared local-controller body adoption remains deferred to the atomic all-route ownership cutover. Production zero-delta routes deliberately remain on the legacy resolver until 4B2 supplies the real collision-report return, exact authored mover preparation, presentation-only rebucketing, placement-prefix quiescence, and the atomic graphical/headless route cutover. | `src/AcDream.Core/Physics/PhysicsSetPosition.cs`; `src/AcDream.Runtime/Physics/RuntimeSetPositionState.cs`; `src/AcDream.Runtime/Physics/RuntimePlacementProjectionChannel.cs`; `tests/AcDream.Core.Tests/Physics/PhysicsSetPositionTests.cs`; `tests/AcDream.Runtime.Tests/Physics/RuntimeSetPositionStateTests.cs`; `docs/research/2026-07-31-canonical-set-position.md` | The mechanism, ownership, and host seam land independently without partially changing production placement behavior. | Until 4B2, fresh spawn, same-generation refresh, authoritative Position, portal arrival, external teleport, parent detach, pickup release, and world-drop hydration can still run the old approximation despite the canonical owner now existing. | `CPhysicsObj::SetPosition` 0x005160C0; `SetPositionInternal` 0x00515BD0; `AdjustPosition` 0x00511D80; `CheckPositionInternal` 0x00511E90; `CTransition::find_valid_position` 0x0050C310; `find_placement_position` 0x0050C170; `validate_placement_transition` 0x0050ADC0; `validate_placement` 0x0050B210 |
|
||||
| AP-1 | **NARROWED 2026-07-31 (placement/streaming Slice 4B2 checkpoint 2).** Core exposes the pure retail `SetPosition` transaction; Runtime owns its exact accepted operation, complete canonical commit, deferred residence, lifetime, generation wake, revisioned host receipts, and exact-key retail collision table/environment-latch/report-result state; and one public generation-gated channel exposes observe/retry/exact-head acknowledgement without another placement queue. Collision starts, expiry/force ends, static and `ReportAsEnvironment` routing, reciprocal eligibility, missile-state clearing, callback ordering, and failed-placement `Collided` versus `NoValidPosition` classification now share one presentation-free owner. Shared local-controller body adoption remains deferred to the atomic all-route ownership cutover. Production zero-delta routes deliberately remain on the legacy resolver until 4B2 supplies exact authored mover preparation, presentation-only rebucketing, placement-prefix quiescence, and the atomic graphical/headless route cutover. | `src/AcDream.Core/Physics/PhysicsSetPosition.cs`; `src/AcDream.Runtime/Physics/RuntimeSetPositionState.cs`; `src/AcDream.Runtime/Physics/RuntimeCollisionReportingState.cs`; `src/AcDream.Runtime/Physics/RuntimePlacementProjectionChannel.cs`; `tests/AcDream.Core.Tests/Physics/PhysicsSetPositionTests.cs`; `tests/AcDream.Runtime.Tests/Physics/RuntimeSetPositionStateTests.cs`; `tests/AcDream.Runtime.Tests/Physics/RuntimeCollisionReportingStateTests.cs`; `docs/research/2026-07-31-canonical-set-position.md`; `docs/research/2026-07-31-runtime-set-position-collision-reporting.md` | The mechanism, ownership, report-result oracle, and host seam land independently without partially changing production placement behavior. | Until 4B2, fresh spawn, same-generation refresh, authoritative Position, portal arrival, external teleport, parent detach, pickup release, and world-drop hydration can still run the old approximation despite the canonical owners now existing. | `CPhysicsObj::SetPosition` 0x005160C0; `SetPositionInternal` 0x00515BD0; `CPhysicsObj::handle_all_collisions` 0x00514780; `track_object_collision` 0x00513F10; `report_collision_end` 0x00514620; `AdjustPosition` 0x00511D80; `CheckPositionInternal` 0x00511E90; `CTransition::find_valid_position` 0x0050C310; `find_placement_position` 0x0050C170; `validate_placement_transition` 0x0050ADC0; `validate_placement` 0x0050B210 |
|
||||
|
||||
| ~~AP-3~~ | **RETIRED 2026-07-31 (Campaign P Slice 1B).** `TransitionalInsert` now returns `OK_TS` immediately for every valid contact plane. Its ordinary StepDown tail is reachable only from invalid contact and retains the retail Contact / `!sphere_path.step_down` / check-cell / ObjectInfo.StepDown gates plus the exact one-versus-two-sphere probe split. | `src/AcDream.Core/Physics/TransitionTypes.cs` (`TransitionalInsert`, `GetStepDownProbePlan`); `tests/AcDream.Core.Tests/Physics/RetailEdgeResponseOrderingTests.cs` | — | — | `CTransition::transitional_insert` 0x0050B6F0, named-retail pseudo-C pc:273191–273307 |
|
||||
| ~~AP-4~~ | **RETIRED 2026-07-31 (Campaign P Slice 1B).** `EdgeSlideAfterStepDownFailed` now evaluates retail Branch 1 (`!OnWalkable || !EdgeSlide` → restore + `OK_TS`) before the steep-contact `CliffSlide` branch. The former compensation is removed. | `src/AcDream.Core/Physics/TransitionTypes.cs` (`EdgeSlideAfterStepDownFailed`); `tests/AcDream.Core.Tests/Physics/RetailEdgeResponseOrderingTests.cs` | — | — | `CTransition::edge_slide` 0x0050B3D0, named-retail pseudo-C pc:273001–273090 |
|
||||
|
|
|
|||
|
|
@ -60,12 +60,27 @@ automated gates pass and the connected buff/death gate was user-accepted on
|
|||
2026-07-31. The final session also accepted burden/exhaustion, wall/corner,
|
||||
crowd, two-client remote/door/portal, and shallow-water behavior. The user
|
||||
waived the general sweep and explicitly deferred the barred-house gate as
|
||||
#274. A separate tight-gap clearance mismatch is carried as #273 pending an
|
||||
exact-location capture. World-interaction Slice 5 vendor browsing resumes.
|
||||
#274. The later exact-location #273 tight-gap gate is now fixed and accepted.
|
||||
|
||||
**Remaining physics-divergence closeout (ACTIVE 2026-07-31):** the user then
|
||||
authorized retirement of the remaining proven collision/placement gaps before
|
||||
vendor work resumes. Nested retry, edge/StepDown/Path-6 ordering, exact cell
|
||||
availability, atomic collision generations, canonical Core SetPosition,
|
||||
Runtime lost-cell residence, and the dormant placement receipt channel are
|
||||
landed. Placement Slice 4B2 checkpoint 2 adds the presentation-free Runtime
|
||||
owner for retail collision tracking, environment latch, ordered callbacks,
|
||||
missile-state clearing, expiry/force-end lifetime, and SetPosition's exact
|
||||
report-result boolean. It deliberately does not activate an App or Headless
|
||||
production route. Next are exact authored mover preparation, the atomic shared
|
||||
body/controller transaction, presentation-only placement observers, collision-
|
||||
prefix quiescence, and the all-route cutover which can retire AP-1/AD-1. AP-22
|
||||
authored object shapes and AD-10 remote contact-plane projection follow, then
|
||||
the final matrix and ledger closeout. Detailed handoff:
|
||||
[`2026-07-31-runtime-set-position-collision-reporting-handoff.md`](../research/2026-07-31-runtime-set-position-collision-reporting-handoff.md).
|
||||
|
||||
---
|
||||
|
||||
## Current program: world interaction completion (M4 prelude)
|
||||
## Paused program: world interaction completion (M4 prelude)
|
||||
|
||||
The active work order is
|
||||
[`2026-07-23-world-interaction-completion.md`](2026-07-23-world-interaction-completion.md).
|
||||
|
|
|
|||
|
|
@ -87,10 +87,18 @@ program: spell-bar overflow, status Use/Assess, assessment information,
|
|||
equipped-child picking, vendor browsing, and authoritative vendor
|
||||
transactions. This is deliberately using the extracted interaction owners and
|
||||
canonical shared main-panel host before quest/emote/character-creation bodies
|
||||
broaden the feature surface. Slices 1–4 are user-accepted. Campaign P closed
|
||||
on 2026-07-31 with tight-gap collision clearance (#273) and the deferred
|
||||
restricted-house gate (#274) explicitly carried; resume at Slice 5 vendor
|
||||
browsing.
|
||||
broaden the feature surface. Slices 1–4 are user-accepted. Campaign P's
|
||||
connected feel matrix closed on 2026-07-31 with tight-gap collision clearance
|
||||
(#273) and the deferred restricted-house gate (#274) explicitly carried. The
|
||||
user subsequently authorized the remaining physics-divergence closeout before
|
||||
vendor work. Placement Slice 4B2 checkpoint 2 now gives Runtime the retail
|
||||
SetPosition collision table, environment latch, ordered report callbacks, and
|
||||
exact report-result owner without activating production placement. The
|
||||
remaining order is authored mover/body preparation, atomic graphical/no-window
|
||||
body publication, presentation-only projection and prefix quiescence, then the
|
||||
all-route SetPosition cutover; AP-22 shape fidelity and AD-10 remote contact-
|
||||
plane projection follow. Resume Slice 5 vendor browsing only after that
|
||||
closeout or a new explicit user direction.
|
||||
|
||||
The separately authorized modern-runtime performance program has completed
|
||||
Slices A–D: corrected measurement, prepared-package bake/dedup, package-only
|
||||
|
|
|
|||
|
|
@ -252,15 +252,21 @@ prepared-mover caching, and caps synchronous Scatter/RandomScatter work at 64
|
|||
attempts; this keeps valid authored retail request shapes while rejecting a
|
||||
hostile `uint.MaxValue` loop at the authority boundary.
|
||||
|
||||
Two boundaries intentionally remain open for 4B2:
|
||||
One authority boundary intentionally remains open for 4B2:
|
||||
|
||||
- `RuntimePortalPlacementAuthority` validates immutable token shape only;
|
||||
4B2 must bind it to active `RuntimeWorldTransitState` generation, teleport
|
||||
sequence, destination, and host acknowledgement before reveal.
|
||||
- Runtime applies the canonical collision-report state but fails the handler
|
||||
return closed. Retail returns report/track success, not collision presence;
|
||||
the per-object report/tracking owner required for that boolean is not yet in
|
||||
Runtime, and the former environment/object-presence guess is forbidden.
|
||||
|
||||
The former collision-report boundary is closed by
|
||||
`RuntimeCollisionReportingState`. Runtime now owns retail's exact-key object
|
||||
contact table, environment latch, strict ordinary/ethereal expiry, force-end,
|
||||
static and `ReportAsEnvironment` routing, reciprocal callback eligibility,
|
||||
missile-state clearing, ordered reentrant dispatch, and the report-result
|
||||
boolean which distinguishes placement `Collided` from `NoValidPosition`.
|
||||
Successful SetPosition commits reporting after Contact/OnWalkable and ground
|
||||
callbacks but before its single physical response and shadow reflood. See
|
||||
`docs/research/2026-07-31-runtime-set-position-collision-reporting.md`.
|
||||
|
||||
### Slice 4B2 checkpoint 1 — public dormant host seam
|
||||
|
||||
|
|
@ -284,13 +290,13 @@ preparation followed by one validated atomic body/controller publication.
|
|||
Either choice belongs to the all-route ownership cutover, not this narrow
|
||||
dormant-seam checkpoint.
|
||||
|
||||
This is still a deliberately non-activating checkpoint. Production spawn,
|
||||
This remains a deliberately non-activating checkpoint. Production spawn,
|
||||
Position, projectile, drop/pickup/parent, and portal routes do not submit to
|
||||
the dormant SetPosition owner yet. The cutover remains blocked on the real
|
||||
retail collision report/tracking return, exact ordered Setup spheres/scale/
|
||||
step heights/flags/cell-local preparation, presentation-only rebucketing, and
|
||||
placement-prefix quiescence before collision retirement. AP-1 and AD-1 remain
|
||||
open until those prerequisites and every production route land together.
|
||||
the dormant SetPosition owner yet. The cutover remains blocked on exact
|
||||
ordered Setup spheres/scale/step heights/flags/cell-local preparation,
|
||||
presentation-only rebucketing, and placement-prefix quiescence before
|
||||
collision retirement. AP-1 and AD-1 remain open until those prerequisites and
|
||||
every production route land together.
|
||||
|
||||
AD-2 remains the explicit async adaptation: collision readiness can publish in
|
||||
a different frame from retail's blocking load. A failed wake is safely re-
|
||||
|
|
|
|||
|
|
@ -1,5 +1,11 @@
|
|||
# Remaining physics-divergence campaign handoff — 2026-07-31
|
||||
|
||||
> **Checkpoint 2 update:** Slice 4B2 prerequisite A, Runtime SetPosition
|
||||
> collision-report ownership, is implemented in the next checkpoint. Continue
|
||||
> with the dedicated
|
||||
> [`runtime SetPosition collision-reporting handoff`](2026-07-31-runtime-set-position-collision-reporting-handoff.md),
|
||||
> not the prerequisite-A instructions preserved below as historical context.
|
||||
|
||||
## Purpose and stopping point
|
||||
|
||||
This is the deliberate handoff boundary requested after placement Slice 4B2
|
||||
|
|
|
|||
|
|
@ -0,0 +1,243 @@
|
|||
# Runtime SetPosition collision-report ownership handoff - 2026-07-31
|
||||
|
||||
## Purpose and exact stopping point
|
||||
|
||||
This handoff records placement Slice 4B2 checkpoint 2: the isolated Runtime
|
||||
owner for retail SetPosition collision tracking and report-result semantics.
|
||||
The checkpoint intentionally stops before authored mover preparation, shared
|
||||
local-controller body publication, graphical/headless placement projection,
|
||||
collision-prefix quiescence, or any production SetPosition route cutover.
|
||||
|
||||
Production behavior is therefore unchanged by this checkpoint. The new owner
|
||||
is populated only by the dormant `RuntimeSetPositionState` and focused tests.
|
||||
AP-1 and AD-1 remain narrowed/open; AP-22 and AD-10 remain open.
|
||||
|
||||
## Exact workspace
|
||||
|
||||
- Worktree: `C:\Users\erikn\.codex\worktrees\af5e\acdream`
|
||||
- Branch: `codex/port-claude-agents`
|
||||
- Starting checkpoint: `ec627c13`
|
||||
(`docs(physics): hand off remaining divergence campaign`)
|
||||
- This handoff belongs to the same behavior commit as the implementation.
|
||||
- No upstream is configured for this worktree branch.
|
||||
- Remotes:
|
||||
- `origin`: `https://git.snakedesert.se/erik/acdream.git`
|
||||
- `github`: `git@github.com:eriknihlen/acdream.git`
|
||||
|
||||
Continue in this worktree unless the user explicitly requests otherwise.
|
||||
`AGENTS.md` has an unrelated pre-existing content diff and must not be staged,
|
||||
restored, or rewritten as part of this checkpoint. Several other paths report
|
||||
line-ending/stat noise without a content diff; stage only the exact paths
|
||||
listed in the final commit.
|
||||
|
||||
## Retail oracle
|
||||
|
||||
The complete readable oracle is
|
||||
[`2026-07-31-runtime-set-position-collision-reporting.md`](2026-07-31-runtime-set-position-collision-reporting.md).
|
||||
The named-retail anchors are:
|
||||
|
||||
- `CPhysicsObj::report_object_collision_end` `0x00510A90`
|
||||
- `CPhysicsObj::report_environment_collision` `0x00512FC0`
|
||||
- `CPhysicsObj::report_object_collision` `0x00513060`
|
||||
- `CPhysicsObj::track_object_collision` `0x00513F10`
|
||||
- `CPhysicsObj::report_collision_start` `0x00513FD0`
|
||||
- `CPhysicsObj::report_collision_end` `0x00514620`
|
||||
- `CPhysicsObj::handle_all_collisions` `0x00514780`
|
||||
- successful `CPhysicsObj::SetPositionInternal(CTransition const*)`
|
||||
`0x00515330`
|
||||
- `CPhysicsObj::leave_world` `0x005155A0`
|
||||
- placement failure in `CPhysicsObj::SetPositionInternal` `0x00515BD0`
|
||||
|
||||
The source is `docs/research/named-retail/acclient_2013_pseudo_c.txt`; the
|
||||
struct authority is `docs/research/named-retail/acclient.h`.
|
||||
|
||||
## What this checkpoint implements
|
||||
|
||||
`RuntimeCollisionReportingState` is the sole per-session owner of:
|
||||
|
||||
- one environment-collision latch per exact `RuntimeEntityKey`;
|
||||
- one ordered object-contact table per exact owner incarnation;
|
||||
- retained peer server GUID, touch time, and ethereal-at-touch state;
|
||||
- static and `ReportAsEnvironment` routing;
|
||||
- asymmetric `IgnoreCollisions` and reciprocal `ReportCollisions` eligibility;
|
||||
- strict ordinary `age > 1.0` and ethereal `age > 0.0` expiry;
|
||||
- force-end-before-callback mutation for reentrant safety;
|
||||
- missing-peer self-only end reports without resolving a later GUID reuse;
|
||||
- exact `Missile | AlignPath | PathClipped` clearing on the canonical record,
|
||||
borrowed body, retained shadow state, and mutation version;
|
||||
- a monotonic immutable report FIFO with observer-failure isolation;
|
||||
- the retail callback-eligibility boolean used by failed placement to choose
|
||||
`Collided` versus `NoValidPosition`;
|
||||
- terminal ownership diagnostics and deterministic session/disposal cleanup.
|
||||
|
||||
Successful dormant SetPosition commits contact, water/walkable and ground
|
||||
edges first, runs reporting next, applies physical response once, and then
|
||||
refloods the shadow. An intervening Vector or Movement update suppresses only
|
||||
the stale physical response; it does not erase collision tracking or reports.
|
||||
Failed placement always supplies retail's `previousContact = false` and
|
||||
`previousOnWalkable = false`, reports once, applies its one response pass, and
|
||||
maps the report result exactly.
|
||||
|
||||
Hidden, teleport/withdrawal, deletion, session reset, and disposal use distinct
|
||||
lifetime edges. Leaving the world force-ends the departing owner's table but
|
||||
retains its environment latch and incoming peer records. Destruction then
|
||||
forgets only the departing owner state. Other owners retain exact-key contacts
|
||||
until their own expiry/force pass and can emit a missing-target end using the
|
||||
preserved server GUID. Hidden and session-clear paths force-end while the old
|
||||
report flags and bodies are still eligible, before state/reset teardown.
|
||||
|
||||
## Architectural boundaries
|
||||
|
||||
- Runtime owns all canonical collision-report state and report-result logic.
|
||||
- Core exposes only the exact successful SetPosition ordering seam and the
|
||||
retained-shadow collision identity required by Runtime.
|
||||
- App and Headless gain no report table, queue, heuristic, or production
|
||||
placement consumer.
|
||||
- Reports are presentation-free and keyed by exact Runtime identity.
|
||||
- Network/update callbacks may re-enter, but every later mutation revalidates
|
||||
current identity, body, and the relevant authority version.
|
||||
- Physical-response velocity authority is deliberately separate from report
|
||||
authority, matching retail's ordering without overwriting a newer vector.
|
||||
|
||||
## Validation and independent review
|
||||
|
||||
The saved final diff passed:
|
||||
|
||||
- combined focused Runtime collision-report and SetPosition tests: 76/76;
|
||||
- complete Runtime project: 562/562;
|
||||
- graphical/headless Runtime-physics ownership and dormancy guards: 4/4;
|
||||
- focused Core SetPosition/contact/response ordering tests: 29/29;
|
||||
- complete Core project: 4,224 passed / 1 intentional skip;
|
||||
- from-source Release solution rebuild: 0 errors and 21 pre-existing test-
|
||||
project nullable/analyzer warnings; this checkpoint introduces none;
|
||||
- complete Release solution: 10,309 passed / 4 intentional skips;
|
||||
- warmed steady-contact refresh: 0 managed bytes across 10,000 calls;
|
||||
- warmed immediate dormant SetPosition commit: still below the existing
|
||||
2,048-byte-per-operation ceiling, with no new captured-delegate cost;
|
||||
- architecture/adversarial re-review: clean after fixing Hidden/session/delete
|
||||
reentrancy, stale shadow-state authority, allocation churn, and batch cost;
|
||||
- retail-conformance re-review: clean against every named address above.
|
||||
|
||||
The final retail re-review found and closed two last ordering defects before
|
||||
sign-off: object collision now snapshots the mover's Missile bit before the
|
||||
source callback and, when that snapshot was set, unconditionally masks the
|
||||
current `Missile | AlignPath | PathClipped` bits afterward. Thus an ordinary
|
||||
callback-added Missile is retained when the mover was not previously a missile,
|
||||
but a callback which clears Missile and re-adds path bits cannot evade the
|
||||
pre-gated retail mask. Environment collision retains retail's post-callback
|
||||
current-Missile test. Successful SetPosition now
|
||||
publishes reports before installing the new stationary-fall counter, applies
|
||||
the physical response next, installs StationaryFall/Stop/Stuck transient bits
|
||||
after response, and only then refloods the shadow.
|
||||
|
||||
The host guard reads both production source trees. It proves App and Headless
|
||||
borrow `GameRuntime.EntityObjects.Physics`, declare no second collision table
|
||||
or return heuristic, and still contain no placement-channel consumer. No
|
||||
connected/live gate is required for this dormant checkpoint because no
|
||||
production route can populate or publish the new report owner.
|
||||
|
||||
## Exact implementation and test paths
|
||||
|
||||
The behavior commit containing this handoff changes exactly these ten code and
|
||||
test paths:
|
||||
|
||||
- `src/AcDream.Core/Physics/PhysicsObjUpdate.cs`
|
||||
- `src/AcDream.Core/Physics/ShadowObjectRegistry.cs`
|
||||
- `src/AcDream.Runtime/Entities/RuntimeEntityDirectory.cs`
|
||||
- `src/AcDream.Runtime/Entities/RuntimeEntityObjectLifetime.cs`
|
||||
- `src/AcDream.Runtime/Entities/RuntimeEntityRecord.cs`
|
||||
- `src/AcDream.Runtime/Physics/RuntimeCollisionReportingState.cs`
|
||||
- `src/AcDream.Runtime/Physics/RuntimePhysicsState.cs`
|
||||
- `src/AcDream.Runtime/Physics/RuntimeSetPositionState.cs`
|
||||
- `tests/AcDream.Runtime.Tests/Physics/RuntimeCollisionReportingStateTests.cs`
|
||||
- `tests/AcDream.App.Tests/Runtime/RuntimePhysicsOwnershipTests.cs`
|
||||
|
||||
The same commit synchronizes the architecture, divergence register, canonical
|
||||
SetPosition research, roadmap, milestones, project memory, prior campaign
|
||||
handoff pointer, retail-oracle note, and this detailed handoff. `AGENTS.md` and
|
||||
the pre-existing line-ending/stat-noise paths are deliberately excluded.
|
||||
|
||||
## Remaining work - required order
|
||||
|
||||
### 1. Exact authored mover preparation
|
||||
|
||||
Build every SetPosition request from Setup's ordered authored spheres, exact
|
||||
scale/presence semantics, StepUp/StepDown heights, flags, cell-local frame and
|
||||
orientation, and current position/vector/state authority versions. Do not
|
||||
synthesize a cylinder from visual radius/height or pre-mutate canonical state.
|
||||
|
||||
### 2. Atomic local-controller/body publication
|
||||
|
||||
Prepare off-canonical, then perform one Runtime-validated atomic transaction
|
||||
which publishes the exact same body to graphical and no-window controllers.
|
||||
Every body writer, remote/projectile binding, SetPosition operation, clock
|
||||
epoch, deletion, reset and disposal path must participate. Do not resurrect
|
||||
the rejected snapshot/rollback lease documented in the prior handoff.
|
||||
|
||||
### 3. Presentation-only host projection
|
||||
|
||||
Implement graphical and headless observers over the existing dormant placement
|
||||
receipt channel. Withdraw removes presentation/spatial consumers while
|
||||
retaining Runtime identity; Place projects only the immutable committed frame;
|
||||
Discard retires the older revision. Host failure retries the exact FIFO head
|
||||
and never rolls Runtime back.
|
||||
|
||||
### 4. Collision-prefix quiescence and atomic route activation
|
||||
|
||||
Park SetPosition residents before retiring their collision prefix, publish the
|
||||
complete replacement generation, wake exact matching residents, and cut every
|
||||
spawn/Position/portal/projectile/drop/pickup/parent/delete route over together.
|
||||
Only then may AP-1 and AD-1 retire.
|
||||
|
||||
### 5. Remaining campaign slices
|
||||
|
||||
- Port retail-authored object collision shape precedence and retire AP-22.
|
||||
- Remove remote terrain-normal preprojection and let the transition resolver
|
||||
use the retained contact plane, retiring AD-10.
|
||||
- Run the full automated and connected matrix, update all ledgers, and close
|
||||
the remaining physics campaign only with direct evidence.
|
||||
|
||||
## Rollback
|
||||
|
||||
This checkpoint is one bisectable commit. Revert the commit containing this
|
||||
file to remove collision-report ownership without disturbing the earlier
|
||||
SetPosition residence and receipt-channel checkpoints. Do not revive the old
|
||||
collision-presence guess or the rejected body snapshot lease.
|
||||
|
||||
Because a Git commit cannot embed its own final hash, resolve the exact
|
||||
checkpoint and revert command without ambiguity using:
|
||||
|
||||
```powershell
|
||||
$checkpoint = git log -1 --format=%H -- `
|
||||
docs/research/2026-07-31-runtime-set-position-collision-reporting-handoff.md
|
||||
git show --stat $checkpoint
|
||||
git revert $checkpoint
|
||||
```
|
||||
|
||||
Earlier rollback points remain:
|
||||
|
||||
```powershell
|
||||
git revert 270f5154 # dormant public placement receipt channel
|
||||
git revert 4c02ac42 # Runtime SetPosition/lost-cell residence owner
|
||||
git revert e84a388e # pure Core retail SetPosition transaction
|
||||
```
|
||||
|
||||
## Resume procedure
|
||||
|
||||
1. Continue in
|
||||
`C:\Users\erikn\.codex\worktrees\af5e\acdream` and verify
|
||||
`git branch --show-current` reports `codex/port-claude-agents`.
|
||||
2. Resolve the exact checkpoint with the `git log` command above and confirm
|
||||
it is the current `HEAD` before starting the next behavior slice.
|
||||
3. Read `AGENTS.md`, `docs/architecture/acdream-architecture.md`, this file,
|
||||
the collision-report oracle, the canonical SetPosition research, and the
|
||||
prior remaining-campaign handoff completely.
|
||||
4. Run `git status --short`. Preserve the unrelated `AGENTS.md` content diff
|
||||
and every documented line-ending/stat-noise path. Never stage by blanket.
|
||||
5. Begin only **Exact authored mover preparation**, the first remaining item
|
||||
above. Do not activate production routes, retire AP-1/AD-1, begin AP-22 or
|
||||
AD-10, or resurrect the rejected body snapshot/rollback lease.
|
||||
6. Use exact-path staging and rerun the matching focused projects,
|
||||
`dotnet build AcDream.slnx -c Release --nologo`, and
|
||||
`dotnet test AcDream.slnx -c Release --no-build --nologo` before the next
|
||||
reviewed checkpoint.
|
||||
|
|
@ -0,0 +1,182 @@
|
|||
# Runtime SetPosition collision-report ownership
|
||||
|
||||
**Scope:** placement/streaming Slice 4B2 prerequisite A only. This closes the
|
||||
missing Runtime owner for retail collision tracking and the boolean returned by
|
||||
`CPhysicsObj::handle_all_collisions`. It does **not** activate any graphical or
|
||||
headless production SetPosition route.
|
||||
|
||||
## Named-retail oracle
|
||||
|
||||
Primary sources:
|
||||
|
||||
- `CPhysicsObj::report_object_collision_end` `0x00510A90`
|
||||
- `CPhysicsObj::report_environment_collision` `0x00512FC0`
|
||||
- `CPhysicsObj::report_object_collision` `0x00513060`
|
||||
- `CPhysicsObj::track_object_collision` `0x00513F10`
|
||||
- `CPhysicsObj::report_collision_start` `0x00513FD0`
|
||||
- `CPhysicsObj::report_collision_end` `0x00514620`
|
||||
- `CPhysicsObj::handle_all_collisions` `0x00514780`
|
||||
- `CPhysicsObj::SetPositionInternal(CTransition const*)` `0x00515330`
|
||||
- `CPhysicsObj::leave_world` `0x005155A0`
|
||||
- placement failure path in `CPhysicsObj::SetPositionInternal` `0x00515BD0`
|
||||
- `CPhysicsObj::CollisionRecord`, `EnvCollisionProfile`,
|
||||
`ObjCollisionProfile`, and `AtkCollisionProfile` in
|
||||
`docs/research/named-retail/acclient.h`
|
||||
|
||||
The source text is
|
||||
`docs/research/named-retail/acclient_2013_pseudo_c.txt`. The addresses above
|
||||
are the behavioral authority; the older unnamed chunks remain fallback only.
|
||||
|
||||
### Environment reporting
|
||||
|
||||
```text
|
||||
report_environment_collision(meInContact):
|
||||
reported = false
|
||||
if !colliding_with_environment:
|
||||
if self.ReportCollisions && self.weenie != null:
|
||||
DoCollision(EnvCollisionProfile(self.velocity, meInContact))
|
||||
reported = true
|
||||
colliding_with_environment = true
|
||||
if self.Missile:
|
||||
self.state &= ~(Missile | AlignPath | PathClipped)
|
||||
return reported
|
||||
```
|
||||
|
||||
The latch is independent of callback eligibility. An object with no collision
|
||||
callback still latches its environment contact, and a repeated environment hit
|
||||
returns false. Retail has no environment-end callback. `leave_world` does not
|
||||
clear this latch; the next `handle_all_collisions` call re-arms it only after a
|
||||
non-environment frame.
|
||||
|
||||
### Object reporting and tracking
|
||||
|
||||
```text
|
||||
track_object_collision(other, meInContact):
|
||||
if other.Static:
|
||||
return report_environment_collision(meInContact)
|
||||
|
||||
record = { touched_time = PhysicsTimer.curr_time,
|
||||
ethereal = other.Ethereal }
|
||||
existed = collision_table.clobber(other.id, record)
|
||||
if existed:
|
||||
return false
|
||||
return report_object_collision(other, meInContact)
|
||||
```
|
||||
|
||||
The table insert/refresh precedes callbacks. Duplicate contacts refresh their
|
||||
time but never replay a start callback. DAT/static classification and physics
|
||||
state come from the exact shadow object which produced the collision; object-ID
|
||||
presence is not a valid substitute.
|
||||
|
||||
`report_object_collision` first maps `ReportAsEnvironment` to the environment
|
||||
path. Otherwise:
|
||||
|
||||
- the mover reports only when the other object is not `IgnoreCollisions` and
|
||||
the mover has `ReportCollisions` plus a weenie;
|
||||
- a mover which had Missile set before the source callback unconditionally
|
||||
masks its current `Missile | AlignPath | PathClipped` bits after striking a
|
||||
non-ignored object, even when the callback cleared Missile but re-added path
|
||||
bits; when pre-callback Missile was clear, callback-added Missile is retained;
|
||||
- the reciprocal report occurs only when the other has `ReportCollisions`, the
|
||||
mover is not `IgnoreCollisions`, and the other has a weenie;
|
||||
- the return is true when at least one callback is attempted. It is never a
|
||||
collision-presence boolean.
|
||||
|
||||
### Expiry and end reporting
|
||||
|
||||
`report_collision_end(force)` removes records before dispatching callbacks.
|
||||
This ordering is required for safe reentrancy.
|
||||
|
||||
```text
|
||||
ordinary record: remove when age > 1.0, or force
|
||||
ethereal record: remove when age > 0.0, or force
|
||||
```
|
||||
|
||||
Equality remains alive. A still-resolvable non-`ReportAsEnvironment` peer may
|
||||
receive reciprocal collision-end callbacks. When the peer no longer resolves,
|
||||
the owner can still receive its self-only end using the stored retail object
|
||||
ID. A later incarnation must never satisfy the old contact record.
|
||||
|
||||
### `handle_all_collisions` and SetPosition ordering
|
||||
|
||||
```text
|
||||
handle_all_collisions(info, previousContact, previousOnWalkable):
|
||||
reported = false
|
||||
for other in info.collidedObjects, in encounter order:
|
||||
reported |= track_object_collision(other, previousContact)
|
||||
report_collision_end(force = false)
|
||||
|
||||
if environment latch is already set:
|
||||
latch = info.collided_with_environment
|
||||
else if info.collided_with_environment
|
||||
|| (!previousOnWalkable && self.OnWalkable):
|
||||
reported |= report_environment_collision(previousContact)
|
||||
|
||||
apply retail collision velocity/stationary response
|
||||
return reported
|
||||
```
|
||||
|
||||
Successful `SetPositionInternal(CTransition const*)` commits the resolved
|
||||
cell/frame, Contact/WaterContact/OnWalkable state, and HitGround/LeaveGround
|
||||
edge before `handle_all_collisions`; it ignores the returned boolean and only
|
||||
then replaces/refloods shadows. Collision reports observe the old stationary-
|
||||
fall state; the new counter is installed before physical response, while the
|
||||
StationaryFall/Stop/Stuck transient bits are replaced after response and before
|
||||
shadow reflood. The placement failure path calls
|
||||
`handle_all_collisions(info, false, false)` and maps true to
|
||||
`SetPositionError::Collided` (`4`) and false to `NoValidPosition` (`2`).
|
||||
|
||||
Consequently acdream must keep report/tracking separate from the physical
|
||||
response: failed placement runs both once, while successful Runtime commit
|
||||
runs reporting between the contact/ground commit and shadow reflood without
|
||||
double-applying velocity response.
|
||||
|
||||
## Runtime ownership contract
|
||||
|
||||
The implementation is presentation-free and belongs to the per-session
|
||||
`RuntimePhysicsState` graph. Its invariants are:
|
||||
|
||||
- owner and peer identities are exact `RuntimeEntityKey` values, not server
|
||||
GUID or local ID alone;
|
||||
- each tracked record retains the peer server GUID, touch time in the Runtime
|
||||
simulation-clock domain, and ethereal-at-touch bit;
|
||||
- collided IDs and authored/static ownership are admitted through the exact
|
||||
retained `ShadowObjectRegistry` registration which produced the collision;
|
||||
every dynamic Static/Ethereal/Ignore/ReportAsEnvironment decision then reads
|
||||
the current canonical `PhysicsBody.State`, never a stale shadow snapshot;
|
||||
- immutable reports preserve encounter order and dispatch through a retained,
|
||||
reentrancy-safe FIFO;
|
||||
- callback exceptions are isolated, while the retail report-result boolean is
|
||||
determined by callback eligibility and does not depend on subscribers;
|
||||
- every callback boundary revalidates the exact record/body/authority before
|
||||
any later canonical mutation;
|
||||
- force-end mutates the complete expired set before publishing ends; exact-key
|
||||
admission guards prevent callback reentry from recreating a leaving owner,
|
||||
and session teardown blocks the whole owner batch before its first callback;
|
||||
- one source lifetime token covers a complete precollected end batch, so a
|
||||
callback-accepted delete stops every later peer report even while teardown
|
||||
sidecars remain resolvable;
|
||||
- lifetime forget, session reset, and disposal cannot donate state to GUID
|
||||
reuse;
|
||||
- terminal ownership diagnostics include contact/report state and converge to
|
||||
zero;
|
||||
- graphical and no-window hosts borrow the same Runtime owner. No host owns a
|
||||
second collision table or report-result heuristic.
|
||||
|
||||
The warmed steady-contact refresh path allocates zero managed bytes. Expired
|
||||
contact storage is allocated lazily only after the first actual expiry, and
|
||||
session-batch teardown is linear in owner count.
|
||||
|
||||
## Deliberately deferred
|
||||
|
||||
The canonical SetPosition owner remains dormant in production. The following
|
||||
belong to later 4B2 commits and are not part of this checkpoint:
|
||||
|
||||
- exact ordered Setup spheres, authored scale and step-height preparation;
|
||||
- the atomic shared local-controller body transaction;
|
||||
- presentation-only rebucketing and placement-prefix quiescence;
|
||||
- graphical/headless spawn, Position, portal, projectile, drop, pickup,
|
||||
parent, and delete route cutover.
|
||||
|
||||
AP-1 and AD-1 therefore remain open, narrowed only by removal of the
|
||||
collision-report prerequisite.
|
||||
Loading…
Add table
Add a link
Reference in a new issue