fix: connect The Tower and Workshop canonically in docs
All checks were successful
Tests / lint (pull_request) Successful in 3s
Tests / test (pull_request) Successful in 1m4s

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:
kimi
2026-03-19 01:38:40 -04:00
parent f9d8509c15
commit 32b36d8363
3 changed files with 22 additions and 2 deletions

View File

@@ -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)

View File

@@ -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.

View File

@@ -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.