Framework for digital coordination as goal-driven communication

Find a file

tegwick a362dec13e All checks were successful check / test (push) Successful in 54s Details CI Smoke / host-smoke (push) Successful in 0s Details CI Smoke / container-smoke (push) Successful in 2s Details Refresh WORK-RECORDS.md after archiving finished workplans. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Assistant: claude-code Assistant-Model: opus Assistant-Process: 61492@bnt-lap001 Assistant-Session: 8e8b440c-c018-4275-aadc-b5b721c5b979		2026-09-22 12:01:17 +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	Specify prj- drivers and cross-owner wait mode.	2026-09-14 16:46:45 +02:00
src/coordination_engine	Specify prj- drivers and cross-owner wait mode.	2026-09-14 16:46:45 +02:00
tests	Specify prj- drivers and cross-owner wait mode.	2026-09-14 16:46:45 +02:00
workplans	Archive finished workplans WP-0001, 0002, 0003 and 0005.	2026-09-22 12:00:42 +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	Specify prj- drivers and cross-owner wait mode.	2026-09-14 16:46:45 +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	Specify prj- drivers and cross-owner wait mode.	2026-09-14 16:46:45 +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	Refresh WORK-RECORDS.md after archiving finished workplans.	2026-09-22 12:01:17 +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.

Project-repository workplans (prj-) are coordination drivers; product repos implement. See v0.2 and cross-owner wait mode. Residual flavor is not a driver.

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.