Bytefray v4.0.0-alpha3 — Spectator Intelligence & Perspective Cam

Bytefray v4.0.0-alpha3 — Spectator Intelligence & Perspective Cam

Bytefray v4.0.0-alpha3 introduces the v4 spectator presentation pipeline. Replay viewing now offers first-person entrant perspective modes, deterministic dynamic playback pacing, and contextual event feeds without altering canonical simulation determinism.

Highlights

• Perspective Cam (V / P to cycle, 1–9 direct select)

  • View matches strictly from an entrant's own delivered knowledge boundary under Agent API v2.
  • Anonymous Radar Contacts: Observed enemies appear as prominent gold CURRENT radar contacts and ghosted STALE rings with tick age (T-{age}). No synthetic enemy tracks, entrant IDs, process IDs, or continuity are inferred or displayed.
  • Own-Process Reach: Visualizes active process anchors and their local sensor reach boundaries.
  • READ Sample History: Displays historical memory cell sample tints, strictly separated from spatial contact identities.
  • Perspective-Safe HUD: Persistent opponent cards redact lifecycle state to UNKNOWN and core/score/territory/kills to ? placeholders during live viewing, revealing canonical values at the match terminal tick.
  • Perspective-Safe Capture Callouts: Reactive core-capture callouts suppress opponent-vs-opponent eliminations and strip killer attribution on own capture.

• Spectator Director (G to toggle)

  • Deterministic dynamic playback pacing that cruises smoothly through quiet exploration periods (up to 18 tps) and decelerates/holds during key combat events (disruptions, core damage, first contacts, eliminations).
  • Multi-entrant and Perspective pacing strictly respect the active entrant's knowledge domain.

• Fight Night Presentation (N to toggle)

  • Compact factual event ribbon anchored in the arena letterbox gutter showing recent contact, write, disruption, and elimination events with 2-, 3-, and 4-entrant presentation.

• Non-Intrusive Architecture & 100% Compatibility

  • Fixed-rate canonical Broadcast replay remains default. Replay playback functions independently with zero trace dependency, gracefully falling back to Broadcast mode if no trace is supplied.
  • Incremental PerspectiveCursor maintains (1)$ amortized per-frame performance.
  • Canonical simulation rulesets (bytefray-rules-4-alpha1 and bytefray-rules-4-alpha2), Agent API v2, and replay schema 4 wire shapes remain 100% frozen and bitwise compatible.

Release Qualification

• Full repository suite: 2,832 passed, 14 skipped, 2 deselected (313s)
• Focused spectator suite: 496 passed
• Static validation: ruff check . clean, mypy engine/src/battle_engine clean, mypy client/src/battle_client clean
• Packaging: Pure Python wheel (check_wheel.py validated), source tarball, and Windows portable AMD64 package tested across 2-, 3-, and 4-entrant matches.

---

Update: A follow-up release is available with the Agent Designer spectator integration fix: v4.0.0-alpha4. It makes the spectator features above available automatically from the Designer's Simple/Advanced workflow; this release's assets are unchanged.