johno/gastown
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Add wisp architecture documentation

Browse Source 
- Create wisp-architecture.md with canonical storage spec
- Document role assignments (Deacon/Witness/Refinery use wisps)
- Specify .beads-ephemeral/ as gitignored storage
- Define patrol execution pattern with required squash
- Update architecture.md to reference new doc

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Steve Yegge
2025-12-21 23:35:31 -08:00
parent fad9e1a5f6
commit 97db49f72c
2 changed files with 261 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/architecture.md
View File

@@ -548,11 +548,17 @@ bd mol burn gt-abc123.exec-001 # Discard wisps without digest
**Wisp storage:**
Wisps are stored in a per-rig ephemeral database:
- `<rig>/.beads-ephemeral/` - Separate from permanent beads
- `<rig>/.beads-ephemeral/` - Separate from permanent beads, **gitignored**
- Fast writes, no sync overhead
- Auto-cleaned on squash/burn
- Digests write to permanent beads
**See**: [wisp-architecture.md](wisp-architecture.md) for full specification including:
- Canonical storage locations
- Role assignments (which agents use wisps)
- Patrol pattern implementation
- Beads implementation requirements
**Patrols use wisps:**
Patrol agents (long-running monitors) execute in infinite wisp loops: