# R5 entry handoff — fresh-session entry point (2026-07-03, night)

Successor to `2026-07-03-r4-verify-session-handoff.md` (now fully closed
out — its items 1-4 are all struck through with outcomes). Worktree
`vigorous-joliot-f0c3ad`, branch `claude/vigorous-joliot-f0c3ad`, tree
CLEAN at `304327b0`. Full suite green: **3,964**.

## State — the R2-R4 arc is DONE

R4 shipped + user-verified; the whole follow-up queue closed **today,
all user-verified live**:

| Item | Outcome |
|---|---|
| #161 landing pose | FIXED `b1cf0102` — retail's apply pass runs with `ModifyInterpretedState=false` (the BN decomp SMEARS the params bitfield store into the mush at raw 305778: `(word & 0x37ff) \| cancelMoveTo<<15 \| disableJump<<17`; ACE MotionInterp.cs:444-449 confirms). Fwd is PRESERVED through a fall; HitGround re-dispatches it → landing link. Plus: HitGround must run BEFORE the DR gravity-bit clear (its verbatim `state&0x400` gate — AP-81); K-fix17 SetCycle blocks deleted; `copy_movement_from` now copies `current_style` (raw 0051e757); ALL apply_current_movement caller polarities fixed (raw arg3 = DisableJumpDuringLink → `(N,0)` = allowJump TRUE). Lesson: [[feedback-bn-decomp-field-names]] (2nd artifact class). |
| #162 glide class | CLOSED, **no adaptation**. User A/B: retail does NOT glide — and post-#161 acdream matches (walk/run-by-distance movetos + clean mid-chain key takeover). Head-interrupt + CancelMoveTo re-audited retail-verbatim; ACE's mt-0 reflections carry the mover's REAL locomotion, so cancels never strand the legs. Evidence: ISSUES Recently-closed #162 + the launch-162 capture analysis. |
| #163 temp diags | STRIPPED `5ebe2be3` ([autowalk-gate]+clock, [autowalk-feed], [MOVETO-CANCEL]). Durable ProbeAutoWalk family kept. |
| R2-R4 visual pass | **PASSED** (jump/ledge momentum, run-in-circles, stop settle, retail-observer view). Filed #165 (remote wall-swallow) + #166 (slope-landing sled — the AD-25+AP-7+TS-4 composite, post-R6 per user). |

## NEXT: R5 — MovementManager facade + PositionManager (Sticky/Constraint) + TargetManager

**Retires: TS-39** (MoveToManager `StickTo`/`Unstick` are unbound no-op
seams — sticky movetos complete-and-stop instead of sticking; retail
hands off to `PositionManager::StickTo(tlid, radius, height)`, and every
`PerformMovement` head calls `unstick_from_object` →
`PositionManager::UnStick`) **and AP-79** (the P4 TargetTracker minimal
adapter — GameWindow feeds `HandleUpdateTarget` from the entity table;
retail's TargetManager is a full voyeur-subscription system with
per-target quantums).

### Retail function inventory (grep'd, addresses verified)

- **MovementManager** (facade, mostly thin): 00524000 MakeMoveToManager ·
  00524020 SetWeenieObject · 005240d0 PerformMovement · 00524170
  move_to_interpreted_state · 005241b0 CancelMoveTo · 005241c0
  EnterDefaultState · 00524260 IsMovingTo · 00524280 motions_pending ·
  005242d0 MotionDone · 005242f0 UseTime · 00524300 HitGround · 00524320
  LeaveGround · 00524340/00524350 HandleEnter/ExitWorld · 00524360
  ReportExhaustion · 00524440 unpack_movement · 00524790
  HandleUpdateTarget (routes TargetInfo → MoveToManager). Much of this
  facade's BEHAVIOR is already ported piecemeal (funnel, RouteServerMoveTo,
  TickRemoteMoveTo, the UseTime/CheckForCompletedMotions slots) — R5's job
  is the STRUCTURE: one owner object per entity replacing the GameWindow
  wiring sprawl, without changing dispatch behavior pinned by the
  183-case + funnel + moveto suites.
- **StickyManager**: 00555400 UnStick · 00555430 adjust_offset · 00555610
  UseTime · 005556e0 SetPhysicsObject · 00555710 StickTo · 00555780
  HandleUpdateTarget.
- **ConstraintManager**: 00556090 SetPhysicsObject · 005560c0 UnConstrain ·
  005560d0 IsFullyConstrained · 00556180 adjust_offset · 00556240
  ConstrainTo. (`jump_is_allowed` already calls an `IsFullyConstrained`
  stub — find it before re-porting.)
- **PositionManager** (owns the two): CPhysicsObj::MakePositionManager
  00510210 (also sets transient bit 0x80 + update_time). `stick_to_object`
  / `unstick_from_object` on CPhysicsObj are the entry seams (today
  Action seams on MotionInterpreter, wired per-entity in GameWindow).
- **TargetManager**: 0051a370 ctor · 0051a4a0 SetTargetQuantum · 0051a4f0
  SendVoyeurUpdate · 0051a5e0 GetInterpolatedPosition · 0051a650
  CheckAndUpdateVoyeur · 0051a6f0 NotifyVoyeurOfEvent · 0051a7e0
  ClearTarget · 0051a830 AddVoyeur · 0051a930 ReceiveUpdate · 0051aa90
  HandleTargetting · 0051ac30 SetTarget · 0051ad90 RemoveVoyeur.
  AP-79's seams (`_setTarget`/`_clearTarget`/quantum get/set +
  GameWindow's tracker blocks for remotes AND the `_playerMoveToTarget*`
  player twin) are the integration points to replace.

### Already ported — do NOT re-port

MoveToManager (R4, full incl. the queue model), MotionInterpreter (R3
full; #161 corrected the apply-pass params), MotionTableManager +
GetObjectSequence (R2), CSequence (R1), RemoteWeenie + PhysicsBody.InWorld
(R4-V5), DefaultSink binding order (bind BEFORE SetPosition — the
`LoginQueue_DrainsToEmpty_UnderProductionFeed` invariant).

### R5-adjacent verification items (found reading unpack_movement this session)

1. **Head stance-change dispatch**: raw @00524502-0052452c — before the
   type switch, for ALL movement types: `if (InqStyle() !=
   command_ids[stanceIdx]) CMotionInterp::DoMotion(style, defaults)` (BN
   mislabels InqStyle as `CBaseFilter::GetPinVersion`). Verify our UM
   path does this for types 6-9 (mt-0 handles style inside the funnel).
2. **mt-0 header flags**: 0x100 → read sticky guid → `stick_to_object`
   (raw @00524589); 0x200 → `standing_longjump` store (raw @0052458e).
   `UpdateMotion.cs` PARSES both (cited §2f) — verify they're APPLIED
   (sticky needs TS-39's machinery = this phase; longjump flag should
   reach `MotionInterpreter.StandingLongJump`).
3. **#164** (filed): action-replay dispatches drop the per-action
   Autonomous bit (raw 305982 sets params bit 0x1000 → AddAction). Fix
   while touching the action path.

## The load-bearing lessons (compressed)

- **The queue model** (unchanged from R4): every `pending_motions`
  enqueue needs a manager completion partner; one orphan = permanent
  MotionsPending wedge.
- **BN smeared bitfield stores**: a fresh local struct + later "mush"
  expression = decode the mush BEFORE porting "ctor defaults". ACE's C#
  port of the same function is the fastest cross-check. Cost of missing
  it: #161 + the wrong W6 entry-cache theory + a wrong pinned test.
- **Tests can pin bug values**: `AirborneBody_NoCycleDispatches_...`
  asserted the CLOBBERED fwd (0x40000015) with a comment admitting it was
  untested. When flipping behavior, audit what the old assertions PINNED.

## Session gotchas

- Launch recipe unchanged (CLAUDE.md). Client LOCKS builds — ask the user
  to close it, never kill. Graceful close clears the ACE session in ~5 s.
- PowerShell `Tee-Object` writes UTF-16 → grep the background task's
  plain-text output file instead of the tee'd log.
- ACDREAM_DUMP_MOTION=1 + ACDREAM_REMOTE_VEL_DIAG=1 give the full UM/seq
  evidence chain ([UM_RAW] hex incl. autonomy byte, [FWD_WIRE],
  [SEQSTATE], [MOTIONDONE]); #165's first step is ACDREAM_PROBE_RESOLVE
  at a wall.