message-bus

What problem does it solve?

File-based message bus enabling reliable inter-agent coordination among workers and board directors, with atomic writes, heartbeat tracking, and event-driven signals to prevent race conditions and improve auditability.

Core Features & Use Cases

• Append-only message queue (queue.jsonl) for durable, ordered events.
• Shared status and lock state (worker-status.json, locks.json) with simple expiry and safety checks.
• Board deliberation artifacts (assessments.json, votes.json, discussion.jsonl) to support structured governance.
• Use Case: orchestrating parallel tasks across dozens of agents while detecting deadlocks and coordinating decisions via signals.

Quick Start

Initialize the message bus for your track and begin coordinating agents using the built-in queue and event signals.