signaltty — Architecture Deliverable (Phase 0)

First deliverable for the native Linux multi-agent workspace. Covers: architecture diagram, process/server model, data model, lifecycle/attention models, PTY lifecycle, terminal-backend research, GTK vs Qt, agent integration, IPC schema, persistence, security, crate layout, roadmap, risks.

Design rule: the server owns the processes, the terminal backend renders terminal state, agent adapters provide semantic agent state, notifications describe human attention, and the UI helps the user find the work that needs them.

Docs index:

• 01 — Architecture & process model
• 02 — Data model (server/workspace/tab/pane)
• 03 — Lifecycle & attention models
• 04 — PTY lifecycle
• 05 — Terminal backend research
• 06 — GUI toolkit decision (GTK vs Qt)
• 07 — Agent integration strategy
• 08 — IPC schema
• 09 — Persistence & restore
• 10 — Security model
• 11 — Crate layout
• 12 — MVP roadmap & risks
• 13 — Plugins & workflows
• 14 — Product direction (cmux + herdr, t3code visual bar)
• 15 — Agent skills (install + phase routing)
• 16 — Visual references (Geist, Linear, Vercel)
• 17 — Agent development and verification
• Agent-ready repository research, 2026-10-03
• cmux and Herdr source review, 2026-10-03
• App verification, 2026-09-29
• Native UI refinement verification, 2026-09-29–30
• Workspace visual hierarchy verification, 2026-09-30
• Automatic hook configuration verification, 2026-09-30
• Codex pane runtime verification, 2026-09-30
• Local agent workflow verification, 2026-09-30
• Per-file diff review verification, 2026-10-03
• ADRs