Framework for digital coordination as goal-driven communication

Find a file

tegwick 628f984a10 All checks were successful check / test (push) Successful in 7m8s Details CI Smoke / host-smoke (push) Successful in 0s Details CI Smoke / container-smoke (push) Successful in 1s Details Implement worker coordination runtime and finish WP-0003 Assistant: codex Assistant-Model: gpt-6-astra Assistant-Session: 01a07b5b-ea58-7ad2-bdbb-0b1c995cfc35		2026-09-07 23:19:52 +02:00
.claude/rules	docs: workplan-first agent guidance prose (CUST-WP-0055 T04 batch 5)	2026-07-08 19:51:14 +02:00
.forgejo/workflows	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
docs	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
history	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
registry	Add registry/NO_CAPABILITIES.md (reuse-surface REUSE-WP-0017-T03)	2026-07-06 18:50:37 +02:00
spec	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
src/coordination_engine	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
tests	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
workplans	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
.custodian-brief.md	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
.gitignore	Initial commit	2026-06-01 18:21:12 +00:00
.repo-classification.yaml	Human-review .repo-classification.yaml (CUST-WP-0050 follow-up)	2026-06-22 17:56:16 +02:00
AGENTS.md	docs(agents): repoint remote State Hub URL to the in-cluster address	2026-08-25 00:20:48 +02:00
CLAUDE.md	Add State Hub bootstrap workplan and agent integration files	2026-06-22 21:44:35 +02:00
INTENT.md	Seeded repo with intent and specs	2026-06-01 23:59:23 +02:00
LICENSE	Adopt Target Revenue Source License V1C1 (org-wide preliminary rollout)	2026-07-30 00:01:31 +02:00
Makefile	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
pyproject.toml	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
README.md	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
SCOPE.md	chore: commit work in progress before registrar reconciliation	2026-08-25 17:44:39 +02:00
uv.lock	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00
WORK-RECORDS.md	Implement worker coordination runtime and finish WP-0003	2026-09-07 23:19:52 +02:00

README.md

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.

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 for configuration, worker acknowledgements, checkpoint continuation, backups and local verification.

The v0.1 contract and adapter decision 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.