feat: Demo autopilot, Help overlay, README overhaul #63

Merged
perplexity merged 1 commits from feat/demo-help-readme into main 2026-03-19 17:12:57 -04:00
Owner

Sprint 3 — Demo Autopilot, Help Overlay, README

Demo Autopilot (js/demo.js)

When The Matrix runs without a backend (mock mode), it now simulates all visual systems with realistic data:

  • Agent state changes (idle ↔ active with auto-revert)
  • Sat flow particles between random agent pairs
  • Economy/treasury panel with drifting balances
  • Chat messages from all 5 agents
  • Streaming tokens word-by-word
  • Connection line pulses
  • Ambient mood cycling (calm → focused → storm → night → dawn)
  • Bark messages with typing animation

Replaces the basic startDemoBarks() with a comprehensive showcase.

Help Overlay

  • ? key toggles a controls reference overlay
  • Shows WASD movement, camera controls, interaction shortcuts
  • Matrix-green terminal styling, dismissible via Escape or click-outside
  • Subtle "? HELP" hint in top-right corner

README Overhaul

  • Documents all 19 modules (was 6)
  • Full feature list: 3D world, visitor system, economy, communication, ambient, infra
  • Demo mode instructions
  • Controls table
  • Updated protocol message table
  • Architecture diagram

Smoke Test

  • 87 checks (was 82)
  • Added: demo.js module + exports, help-hint + help-overlay HTML elements

Build: 66KB app, 478KB three.js — both under budget
Test: 87/87 pass

## Sprint 3 — Demo Autopilot, Help Overlay, README ### Demo Autopilot (`js/demo.js`) When The Matrix runs without a backend (mock mode), it now simulates all visual systems with realistic data: - Agent state changes (idle ↔ active with auto-revert) - Sat flow particles between random agent pairs - Economy/treasury panel with drifting balances - Chat messages from all 5 agents - Streaming tokens word-by-word - Connection line pulses - Ambient mood cycling (calm → focused → storm → night → dawn) - Bark messages with typing animation Replaces the basic `startDemoBarks()` with a comprehensive showcase. ### Help Overlay - `?` key toggles a controls reference overlay - Shows WASD movement, camera controls, interaction shortcuts - Matrix-green terminal styling, dismissible via Escape or click-outside - Subtle "? HELP" hint in top-right corner ### README Overhaul - Documents all 19 modules (was 6) - Full feature list: 3D world, visitor system, economy, communication, ambient, infra - Demo mode instructions - Controls table - Updated protocol message table - Architecture diagram ### Smoke Test - 87 checks (was 82) - Added: demo.js module + exports, help-hint + help-overlay HTML elements --- **Build:** 66KB app, 478KB three.js — both under budget **Test:** 87/87 pass
perplexity added 1 commit 2026-03-19 17:12:48 -04:00
- Demo autopilot (js/demo.js): simulates all visual systems in mock mode —
  agent state changes, sat flow payments, economy updates, chat messages,
  streaming tokens, connection pulses, barks, ambient mood cycling
- Help overlay: ? key or click hint shows keyboard shortcuts
  (WASD, camera, interaction controls)
- README overhaul: documents all 19 modules, features, demo mode,
  protocol, controls, architecture
- Smoke test updated: 87 checks (was 82)
- Replaces basic demo barks with full system showcase
perplexity merged commit e17a5c5eab into main 2026-03-19 17:12:57 -04:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: perplexity/the-matrix#63