chore: register repository governance baseline
Some checks failed
tamq-ci / test (push) Failing after 6s
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
This commit is contained in:
parent
7c76f79463
commit
7b4a972655
18 changed files with 902 additions and 0 deletions
46
SCOPE.md
Normal file
46
SCOPE.md
Normal file
|
|
@ -0,0 +1,46 @@
|
|||
# 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`
|
||||
Loading…
Add table
Add a link
Reference in a new issue