# Coordination Engine

Framework for digital coordination as goal-driven communication.

The first runtime observes State Hub work and wakes explicitly selected local
repository workers through TAMQ. It owns actionability/safety checks, durable
coordination leases, checkpoints, deduplication and sanitized audit receipts.
TAMQ independently owns terminals, its durable queue and delivery policy.

```sh
uv sync --locked
make check
uv run coordination-engine --help
```

Configure selected gita repositories before starting `coordination-engine serve`.
Installation does not enable a service or start workers. See the
[runbook](docs/worker-runtime.md) for configuration, worker acknowledgements,
checkpoint continuation, backups and local verification.

The [v0.1 contract](spec/worker-coordination-service-v0.1.md) and
[adapter decision](docs/adr/002-worker-runtime-boundary.md) describe the ownership
boundary. The authoritative transport contract lives in
`tmux-amq/spec/coordination-engine-adapter-v0.1.md`. This package speaks that Unix
socket protocol directly and does not install TAMQ's executable.

Transport delivery is distinct from workflow completion. A worker must recheck
scope and authority, acknowledge/renew its coordination lease, and publish its
own task updates and completion.