tegwick
d2802fc55d
COORDINATION-WP-0005: map project-repository workplans onto CoordinationCase, refuse residual as a driver, and document the wait mode without enabling live worker injection. Assistant: grok Assistant-Session: 01a09dc1-b21e-77e1-919e-fcad2f82b267
34 lines
1.5 KiB
Markdown
34 lines
1.5 KiB
Markdown
# 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.
|
|
|
|
Project-repository workplans (`prj-`) are coordination **drivers**; product
|
|
repos implement. See [v0.2](spec/coordination-model-v0.2.md) and
|
|
[cross-owner wait mode](spec/cross-owner-wait-mode-v0.1.md). Residual flavor
|
|
is not a driver.
|
|
|
|
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.
|