Some checks failed
tamq-ci / test (push) Failing after 6s
Assistant: codex Assistant-Model: gpt-5.6-sol Assistant-Session: 01a03397-4d51-7fd1-8ff2-946eb22ea2bc
1.7 KiB
1.7 KiB
SCOPE
One-liner
Local durable message queue and tmux endpoint runtime for coordinating agent workers across gita-registered repositories.
Core Idea
Keep tmux topology, terminal input observation, and durable local message state behind a small CLI and Unix-socket protocol that agents can use without owning a distributed coordination service.
In Scope
- Local SQLite message history, leases, endpoint registrations, delivery state, acknowledgements, replay, export, and bounded purging.
- Managed tmux endpoint lifecycle, control-mode output/injection, and the
full-duplex
tamq tapPTY broker. - Exact
gitarepository validation and direct@repo: messagerouting. - Unix-socket operations for local clients and a future coordination-engine adapter.
- Policy profiles, safety-gated retries, local diagnostics, tests, packaging, shell completion, and operator documentation.
Out of Scope
- Owning goal planning, workflow scheduling, or cross-host coordination; those
belong to
coordination-engineand its consumers. - Acting as a network-accessible or multi-host message broker.
- Bypassing
gitaregistration or injecting arbitrary pane input outside the supported tap/control-mode boundaries. - Owning tmux, Codex, State Hub, or adjacent repositories' lifecycle.
Current State
- Version
0.1.0provides the local queue, endpoint manager, control-mode client, PTY tap, socket service, history operations, policy profiles, and CLI. - The local suite contains 50 passing tests as of 2026-08-24.
- Coordination-engine integration is deferred to
TAMQ-WP-0002.
Getting Oriented
- Start with: INTENT.md
- Agent instructions: AGENTS.md
- Workplans: workplans/
- Developer workflow:
uv sync --extra dev,make test, andmake check