neon-sprawl/docs
VinPropane e31cd2df68 NEO-24: freshen server position before target-select + surface divergence on HUD
Fix "Tab says denied even though I'm in range of beta": root cause is the
race between the 20 Hz move-stream sampler and the target-select POST. A
Tab press right after the capsule stops can be validated against the
server's last sampled position, which trails the visible capsule by
several meters.

Client-side fixes (server contract unchanged):

- TargetSelectionClient.set_freshness_kick(authority, player): before each
  POST /target/select, submit a move-stream with the current player
  position so the server's stored snapshot is as fresh as possible when
  the range check runs. Wired in main.gd; optional so tests without the
  wiring still pass (regression-covered).
- PlayerPositionLabel now shows a "srv: (x,y,z) Δ=<d>m age=<ms>" line
  populated from PositionAuthorityClient.authoritative_ack, so any
  residual client/server divergence is visible in the HUD and future
  reports can point at it directly.
- Two new tests: select POST kicks exactly one freshness stream with the
  current player position before POSTing, and the kick is a no-op when
  the wiring is absent.

Docs: plan Decision 5, review follow-up #2, manual QA section 5 and
section 1, and client README updated to describe the new behaviors.
2026-04-21 23:21:16 -04:00
..
architecture docs: documentation vs implementation alignment (#7) 2026-03-30 19:03:03 -04:00
decomposition NEO-24: fix movement-driven target refresh via authoritative_ack signal 2026-04-21 22:35:41 -04:00
game-design chore: document governing design axioms (fun, cyberpunk theme) 2026-04-04 18:46:55 -04:00
manual-qa NEO-24: freshen server position before target-select + surface divergence on HUD 2026-04-21 23:21:16 -04:00
plans NEO-24: freshen server position before target-select + surface divergence on HUD 2026-04-21 23:21:16 -04:00
reviews NEO-24: freshen server position before target-select + surface divergence on HUD 2026-04-21 23:21:16 -04:00