Framework for digital coordination as goal-driven communication

Find a file

tegwick d2802fc55d Some checks failed CI Smoke / host-smoke (push) Waiting to run Details CI Smoke / container-smoke (push) Waiting to run Details check / test (push) Has been cancelled Details Specify prj- drivers and cross-owner wait mode. 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		2026-09-14 16:46:45 +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	Specify prj- drivers and cross-owner wait mode.	2026-09-14 16:46:45 +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	Index COORDINATION-WP-0005 after fix-consistency writeback.	2026-09-14 13:51:41 +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.