a73x

6195a955

Point the design doc at the workshop repo's glue daemons

a73x   2026-09-06 07:37

Commit message
Point the design doc at the workshop repo's glue daemons

docs/superpowers/specs/2026-09-05-server-authoritative-collab-design.md
Old New
@@ -189,16 +189,20 @@ the lease system keeps workers honest about what they claimed.
189 ## Companion pieces (out of this repo's scope) 189 ## Companion pieces (out of this repo's scope)
190 190
191 Per the standalone-tools philosophy, each seam lands as a feature of the tool 191 Per the standalone-tools philosophy, each seam lands as a feature of the tool
192 it belongs to, and the "platform" remains a personal composition: 192 it belongs to, and the "platform" remains a personal composition. The glue
193 daemons are designed in the **`workshop` repo** (`~/code/rad/workshop`):
194 `heimdall` (IRC bridge) and `durin` (foreman), plus how `brokkr` (the LAN
195 LLM gateway) provisions workers with model access:
193 196
194 - **eitri: job mode.** Boot a VM, inject key + task context, run, report, 197 - **eitri: job mode.** Boot a VM, inject key + task context, run, report,
195 tear down. Useful to anyone doing CI/sandboxed builds on their own 198 tear down. Useful to anyone doing CI/sandboxed builds on their own
196 hardware, independent of this forge. 199 hardware, independent of this forge.
197 - **Bridge bot + foreman: personal glue, unshipped.** The bot mirrors 200 - **heimdall + durin: personal glue, unshipped** (see `workshop`). heimdall
198 webhook events into IRC and translates human commands/DMs into API calls. 201 mirrors forge events into IRC and translates human commands/DMs into API
199 The foreman is a dumb elasticity loop: unclaimed tasks > idle workers → 202 calls. durin is a dumb elasticity loop: unclaimed `agent`-labeled issues >
200 ask eitri for a VM (up to a cap); idle worker > N minutes → reap. Lease 203 idle workers → ask eitri for a VM (up to a cap); idle worker > N minutes →
201 TTLs already handle worker death, so recruitment can afford to be naive. 204 reap. Lease TTLs already handle worker death, so recruitment can afford to
205 be naive.
202 - **Triage: a webhook subscriber**, not a forge feature. Dedup, labels, 206 - **Triage: a webhook subscriber**, not a forge feature. Dedup, labels,
203 severity, clarifying questions — all ordinary API calls. 207 severity, clarifying questions — all ordinary API calls.
204 208