tmux-amq/SCOPE.md
tegwick 7b4a972655
Some checks failed
tamq-ci / test (push) Failing after 6s
chore: register repository governance baseline
Assistant: codex
Assistant-Model: gpt-5.6-sol
Assistant-Session: 01a03397-4d51-7fd1-8ff2-946eb22ea2bc
2026-08-24 14:16:11 +02:00

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 tap PTY broker.
  • Exact gita repository validation and direct @repo: message routing.
  • 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-engine and its consumers.
  • Acting as a network-accessible or multi-host message broker.
  • Bypassing gita registration 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.0 provides 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, and make check