viktor/beadboard
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
beadboard/skills/beadboard-driver/references/command-matrix.md
zenchantlive 18fbafdce4 refactor: extract agent bounded context + fix SSE comments + cleanup unused 
- Extract src/lib/agent/ bounded context with types, registry, messaging
- Add comments_count to BeadIssue for SSE comment detection
- Create batch endpoints for mail/reservations APIs
- Add memory validation to session-preflight
- Remove unused empty dirs (mockup, sessions, timeline)
- Move stashes to docs/references, gitignore them
2026-03-04 22:06:40 -08:00

3.2 KiB
Raw Blame History

Command Matrix

This matrix lists the operational command surface for the BeadBoard driver skill. Day-to-day runbooks use bd mail delegation rather than direct low-level agent CLI invocations.

Session and Identity

  • node skills/beadboard-driver/scripts/session-preflight.mjs
  • node skills/beadboard-driver/scripts/ensure-bb-mail-configured.mjs
  • bd create --title="Agent: <role-name>" --description="<agent scope>" --type=task --priority=0 --label="gt:agent,role:<orchestrator|ui|graph|backend|infra>"
  • bd agent state <agent-bead-id> spawning — agent bead created, environment not yet verified
  • bd agent state <agent-bead-id> running — environment verified, ready to claim work
  • bd agent state <agent-bead-id> working — work bead claimed, actively executing
  • bd agent state <agent-bead-id> stuck — blocked, waiting on intervention or response
  • bd agent state <agent-bead-id> done — work bead closed, all deliverables complete
  • bd agent state <agent-bead-id> stopped — session ending cleanly
  • bd agent heartbeat <agent-bead-id>
  • bd agent show <agent-bead-id>

Work Claim and Lifecycle

  • bd ready
  • bd show <bead-id>
  • bd update <bead-id> --status in_progress --assignee <agent-bead-id>
  • bd slot set <agent-bead-id> hook <bead-id>
  • bd update <bead-id> --notes "<evidence>"
  • bd close <bead-id> --reason "<completion summary>"
  • bd slot clear <agent-bead-id> hook

Mail and Coordination (bd mail delegated)

  • bd mail inbox
  • bd mail send --to <agent-id> --bead <bead-id> --category <HANDOFF|BLOCKED|DECISION|INFO> --subject "<short>" --body "<details>"
  • bd mail read <message-id>
  • bd mail ack <message-id>

Delegate setup and validation:

  • bd config set mail.delegate "node <abs-path>/skills/beadboard-driver/scripts/bb-mail-shim.mjs"
  • export BB_AGENT=<agent-id>
  • node skills/beadboard-driver/scripts/ensure-bb-mail-configured.mjs

Dependency and Graph Control

  • bd dep <blocker-id> --blocks <blocked-id>
  • bd dep add <blocked-id> <blocker-id>
  • bd dep list <bead-id>
  • bd dep tree <bead-id>
  • bd dep cycles
  • bd dep relate <issue-a> <issue-b>
  • bd dep unrelate <issue-a> <issue-b>

Swarm and Molecule Operations

  • bd swarm validate <epic-id>
  • bd swarm create <epic-id> [--coordinator <rig/address>] [--force]
  • bd swarm status <swarm-id>
  • bd swarm list
  • bd mol show <formula-or-mol-id>
  • bd mol pour <formula-id> --var key=value
  • bd mol ready
  • bd mol progress <mol-id>
  • bd mol stale

Gates and Blocked Work

  • bd gate list
  • bd gate list --all
  • bd gate check
  • bd gate check --type=bead
  • bd gate show <gate-id>
  • bd gate resolve <gate-id>

Comments and Audit Trail

  • bd comments <bead-id>
  • bd comments add <bead-id> "<coordination note>"
  • bd comments add <bead-id> -f <path-to-note-file>

Environment and Repair Helpers

  • node {baseDir}/scripts/setup-mail-delegate.mjs — configure mail.delegate (self-resolves shim path)
  • node {baseDir}/scripts/readiness-report.mjs --checks <json> --artifacts <json>
  • node {baseDir}/scripts/diagnose-env.mjs
  • node {baseDir}/scripts/heal-common-issues.mjs [--project-root <path>] [--apply] [--fix-git-index-lock]