coulomb/coordination-engine
5
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Framework for digital coordination as goal-driven communication
52 commits 1 branch 0 tags 506 KiB
Find a file
tegwick f658556690
All checks were successful
check / test (push) Successful in 1m23s
Details
CI Smoke / container-smoke (push) Successful in 2s
Details
CI Smoke / host-smoke (push) Successful in 0s
Details
Add configurable ecosystem coordination frame with one-hour baseline 
Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a13eab-1e6a-7b33-9c37-372e90ada3a2
2026-10-15 20:41:33 +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
config Add configurable ecosystem coordination frame with one-hour baseline 2026-10-15 20:41:33 +02:00
docs Add configurable ecosystem coordination frame with one-hour baseline 2026-10-15 20:41:33 +02:00
history Implement worker coordination runtime and finish WP-0003 2026-09-07 23:19:52 +02:00
registry docs(reuse): establish reviewed NetKingdom security capabilities 2026-10-14 06:38:35 +02:00
spec COORDINATION-WP-0004-T02 done: record registered canon artifact; CUST-WP-0075 2026-10-03 03:25:51 +02:00
src/coordination_engine Add configurable ecosystem coordination frame with one-hour baseline 2026-10-15 20:41:33 +02:00
tests Add configurable ecosystem coordination frame with one-hour baseline 2026-10-15 20:41:33 +02:00
workplans COORDINATION-WP-0004-T02 done: record registered canon artifact; CUST-WP-0075 2026-10-03 03:25:51 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-10-03 03:26:04 +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 chore(consistency): refresh WORK-RECORDS index after CUST-WP-0075-T03 2026-10-03 03:26:05 +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.