the-nexus/docs/mission-bus.md

Mission Bus

The Mission Bus grounds the multi-agent teaming epic with a concrete, executable shared module.

What it adds

• one unified mission stream for messages, checkpoints, and handoffs
• role-based permissions for lead, write, read, and audit
• cross-agent handoff packets so Agent A can checkpoint and Agent B can resume
• declared isolation profiles for Level 1, Level 2, and Level 3 mission cells

Files

• nexus/mission_bus.py
• config/mission_bus_profiles.json

Example

from nexus.mission_bus import MissionBus, MissionRole, load_profiles
from pathlib import Path

bus = MissionBus("mission-883", title="multi-agent teaming", config=load_profiles(Path("config/mission_bus_profiles.json")))
bus.register_participant("timmy", MissionRole.LEAD)
bus.register_participant("ezra", MissionRole.WRITE)
checkpoint = bus.create_checkpoint("ezra", summary="checkpoint", state={"branch": "fix/883"})
bus.handoff("ezra", "timmy", checkpoint.checkpoint_id, note="resume from here")
packet = bus.build_resume_packet(bus.events[-1].handoff_id)

Scope of this slice

This slice does not yet wire a live transport or rootless container launcher. It codifies the mission bus contract, role permissions, handoff packet, and isolation profile surface so later work can execute against a stable interface.