18fbafdce4
- 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
85 lines
3.2 KiB
Markdown
85 lines
3.2 KiB
Markdown
# 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]`
|