fix: connect The Tower and Workshop canonically in docs
Add cross-references between The Tower (the-matrix/ in token-gated-economy) and the Workshop presence infrastructure in this repo. Updates ADR-023 and module docstrings. Fixes #372 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -157,6 +157,20 @@ bridge (#243) or polls it directly during development.
|
||||
- **Schema is versioned.** Breaking changes increment the version field.
|
||||
Workshop must handle unknown versions gracefully (show raw data or "unknown state").
|
||||
|
||||
## The Tower Is the Workshop
|
||||
|
||||
The Tower (`the-matrix/` in the `token-gated-economy` repo, served at `/tower`
|
||||
by `artifacts/api-server`) is the 3D renderer that consumes this presence
|
||||
schema. The data flow:
|
||||
|
||||
```
|
||||
Timmy cognitive state → WorkshopHeartbeat → ~/.timmy/presence.json
|
||||
→ /api/world/state (HTTP) and /api/world/ws (WebSocket)
|
||||
→ The Tower (the-matrix/) renders the 3D scene
|
||||
```
|
||||
|
||||
See #372 for the canonical connection between these two systems.
|
||||
|
||||
## Related
|
||||
|
||||
- #222 — Workshop epic
|
||||
@@ -164,3 +178,4 @@ bridge (#243) or polls it directly during development.
|
||||
- #239 — Sensory loop (feeds into state)
|
||||
- #242 — 3D world (consumes this state for rendering)
|
||||
- #246 — Confidence as visible trait (mood field serves this)
|
||||
- #372 — The Tower is the Workshop (canonical connection)
|
||||
|
||||
@@ -1,6 +1,9 @@
|
||||
"""Workshop world state API and WebSocket relay.
|
||||
|
||||
Serves Timmy's current presence state to the Workshop 3D renderer.
|
||||
Serves Timmy's current presence state to the Workshop 3D renderer
|
||||
(a.k.a. "The Tower" — ``the-matrix/`` in ``token-gated-economy``,
|
||||
served at ``/tower`` by ``artifacts/api-server``). See #372.
|
||||
|
||||
The primary consumer is the browser on first load — before any
|
||||
WebSocket events arrive, the client needs a full state snapshot.
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
"""Workshop presence heartbeat — periodic writer for ``~/.timmy/presence.json``.
|
||||
|
||||
Maintains Timmy's observable presence state for the Workshop 3D renderer.
|
||||
Maintains Timmy's observable presence state for the Workshop 3D renderer
|
||||
(a.k.a. "The Tower" — ``the-matrix/`` in ``token-gated-economy``). See #372.
|
||||
|
||||
Writes the presence file every 30 seconds (or on cognitive state change),
|
||||
skipping writes when state is unchanged.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user