tmux-amq/.claude/rules/architecture.md

22 lines
976 B
Markdown
Raw Normal View History

## Architecture
- `store.py` owns SQLite messages, leases, endpoints, and schema migration.
- `service.py` exposes the authenticated local Unix-socket protocol and runs
endpoint-scoped delivery polling.
- `tmux.py` owns tmux endpoint/session lifecycle; `control.py` owns tmux control
mode and injection.
- `ptytap.py` transparently proxies the agent PTY while `routing.py` observes
complete input lines for direct repository addressing.
- `broker.py` connects observed routing intent to durable queue state and
control-mode delivery.
- `cli.py` is the operator surface for lifecycle, messaging, inspection,
replay/export, purging, completion, and diagnostics.
The terminal boundary has three layers: tmux for topology/output, the broker
for identity and durable intent, and `tamq tap` for full-duplex input
observation. Preserve that separation when adding coordination-engine support.
## Quick Reference
`~/state-hub/mcp_server/TOOLS.md` — MCP tool reference