Replaces the static React-Flow world forest with a real-time WebGL view of the swarm working, plus the live event contract that feeds it. Phase A — the live contract + feed: - frontend/src/lib/live/taxonomy.ts — the 13-event Clawmates Event Taxonomy as typed TS (the shared World/Observe contract). - frontend/src/lib/live/useClawmatesLive.ts — native shared-singleton live client (EventSource to /api/world/live, typed fan-out, replay-of-last-state to late subscribers, refcounted, synthetic fallback so views are always alive). - crates/cm-api/src/routes/world.rs — GET /api/world/live, authed + workspace- scoped SSE emitting the taxonomy (real agent.status from live-container state, a topology.update of the workspace's agents, telemetry with real doorsPending), mirroring run_events_sse. normalize() seam documented for run_events->world.touch. Phase B — the WebGL engine: - frontend/src/components/world/engine.ts — Gource-inspired force-directed model: org/company/team tree (sibling repulsion + parent spring + friction), agent pawns that converge on the touched node and beam it, world nodes that glow with heat and fade when idle. Framework-agnostic (renderer-independent) state+math. - frontend/src/components/world/WorldCanvas.tsx — three.js scene (ortho cam, UnrealBloom), render loop syncing engine state, camera auto-fit, HTML labels, raycast click->select, Hierarchy/Flat/Live formation switch. - Dashboard.tsx: swap <WorldFlow/> -> <WorldCanvas/> at the world-tier seam (shared claw-tier pieces untouched; WorldFlow.tsx kept for now). - Adds three (+ @types/three). Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
19 lines
717 B
Bash
19 lines
717 B
Bash
# Clawmates Live bridge — environment
|
|
# Copy to ../.env (the installer does this for you) and edit.
|
|
|
|
# demo = synthetic events, no backend needed (great first run)
|
|
# live = subscribe to the cm-api run SSE stream and normalize it
|
|
CLAWMATES_MODE=demo
|
|
|
|
# Port this bridge serves the browser SSE feed on
|
|
LIVE_PORT=8420
|
|
|
|
# Browser origins allowed to connect (CORS). Comma-separated.
|
|
LIVE_ALLOWED_ORIGINS=http://localhost:8080
|
|
|
|
# ---- live mode only -------------------------------------------------------
|
|
# Where the durable runner / cm-api publishes its run + turn SSE stream:
|
|
CM_API_SSE_URL=http://127.0.0.1:8080/v1/runs/stream
|
|
# Read-only service token scoped to run events (NOT a broker credential):
|
|
CM_API_TOKEN=
|