viktor/beadboard
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

bd: backup 2026-03-04 03:12

Browse source
This commit is contained in:
ZenchantLive 2026-03-03 19:12:52 -08:00
parent c6dea79a10
commit a9566059ba
4 changed files with 32 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

10
.beads/backup/backup_state.json
View file

@ -1,13 +1,13 @@
{
"last_dolt_commit": "lqi577vskr9jp26jp5gstdg2e5k4tnr5",
"last_dolt_commit": "q4apflpmoi8ccm6h6vmi89n6eu1otjva",
"last_event_id": 0,
"timestamp": "2026-03-04T02:56:28.171189335Z",
"timestamp": "2026-03-04T03:12:48.558542757Z",
"counts": {
"issues": 480,
"events": 987,
"issues": 481,
"events": 1006,
"comments": 14,
"dependencies": 784,
"labels": 850,
"labels": 851,
"config": 15
}
}

19
.beads/backup/events.jsonl
View file

@ -985,3 +985,22 @@
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:56:03Z","event_type":"status_changed","id":1091,"issue_id":"beadboard-maf.2","new_value":"{\"assignee\":\"beadboard-2i2\",\"status\":\"in_progress\"}","old_value":"{\"id\":\"beadboard-maf.2\",\"title\":\"v5: memory system reference update\",\"description\":\"TASK CONTEXT\\n- Bead ID: beadboard-maf.2\\n- Parent/Epic: beadboard-maf\\n- Dependencies: None (parallelizable with maf.1, maf.3-maf.5)\\n\\nTASK CONTRACT\\n- Goal: Update memory-system.md to add missing operational guidance: domain anchor IDs, WHEN-to-query trigger, and the full injection playbook from help/memory/query_and_injection.txt.\\n- Success Criteria:\\n - Domain anchor IDs added: beadboard-76p (Arch), beadboard-nq9 (Workflow), beadboard-5r1 (Agent Ops), beadboard-fld (UI/UX), beadboard-8st (Reliability)\\n - WHEN-to-query trigger added: at session start, before claiming work, when entering a new domain\\n - Full injection playbook included (Steps 1-7 from query_and_injection.txt): domain selection, bd query, provenance check, attach via dep relate, contract bead for hard rules, record acknowledgement, preserve provenance in notes\\n - 'Ratify by closing' clarified: closed decision bead = active canonical memory\\n - Noise budget promotion policy added: incident repeats 2+ times = soft candidate, survives release window = hard candidate\\n- Scope:\\n - skills/beadboard-driver/references/memory-system.md rewrite/expansion\\n- Out of Scope:\\n - Changes to bd itself\\n - New canonical memory creation\\n\\nIMPLEMENTATION CONSTRAINTS\\n- Source of truth for injection playbook: help/memory/query_and_injection.txt in beadboard repo\\n- Source of truth for schema: help/memory/schema_and_noise_budget.txt\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: None (doc task)\\n- Required artifacts: updated skills/beadboard-driver/references/memory-system.md\",\"status\":\"open\",\"priority\":1,\"issue_type\":\"task\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:34:54Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T01:34:54Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:56:26Z","event_type":"updated","id":1092,"issue_id":"beadboard-maf.2","new_value":"{\"notes\":\"Rewrote skills/beadboard-driver/references/memory-system.md with v5 memory protocol. Added required domain anchor IDs (beadboard-76p, beadboard-nq9, beadboard-5r1, beadboard-fld, beadboard-8st), WHEN-to-query triggers (session start / pre-claim / domain shift), full 7-step injection playbook from help/memory/query_and_injection.txt, ratification clarification (closed decision bead = active canonical memory), and noise-budget promotion policy (repeat incidents -\\u003e soft candidate; release-surviving workaround -\\u003e hard/soft). Verification artifact: updated memory-system.md in skills path. Memory review: no new reusable memory.\"}","old_value":"{\"id\":\"beadboard-maf.2\",\"title\":\"v5: memory system reference update\",\"description\":\"TASK CONTEXT\\n- Bead ID: beadboard-maf.2\\n- Parent/Epic: beadboard-maf\\n- Dependencies: None (parallelizable with maf.1, maf.3-maf.5)\\n\\nTASK CONTRACT\\n- Goal: Update memory-system.md to add missing operational guidance: domain anchor IDs, WHEN-to-query trigger, and the full injection playbook from help/memory/query_and_injection.txt.\\n- Success Criteria:\\n - Domain anchor IDs added: beadboard-76p (Arch), beadboard-nq9 (Workflow), beadboard-5r1 (Agent Ops), beadboard-fld (UI/UX), beadboard-8st (Reliability)\\n - WHEN-to-query trigger added: at session start, before claiming work, when entering a new domain\\n - Full injection playbook included (Steps 1-7 from query_and_injection.txt): domain selection, bd query, provenance check, attach via dep relate, contract bead for hard rules, record acknowledgement, preserve provenance in notes\\n - 'Ratify by closing' clarified: closed decision bead = active canonical memory\\n - Noise budget promotion policy added: incident repeats 2+ times = soft candidate, survives release window = hard candidate\\n- Scope:\\n - skills/beadboard-driver/references/memory-system.md rewrite/expansion\\n- Out of Scope:\\n - Changes to bd itself\\n - New canonical memory creation\\n\\nIMPLEMENTATION CONSTRAINTS\\n- Source of truth for injection playbook: help/memory/query_and_injection.txt in beadboard repo\\n- Source of truth for schema: help/memory/schema_and_noise_budget.txt\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: None (doc task)\\n- Required artifacts: updated skills/beadboard-driver/references/memory-system.md\",\"status\":\"in_progress\",\"priority\":1,\"issue_type\":\"task\",\"assignee\":\"beadboard-2i2\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:34:54Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:56:03Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:56:26Z","event_type":"closed","id":1093,"issue_id":"beadboard-maf.2","new_value":"Updated memory-system reference with anchor IDs, full injection playbook, and promotion/ratification rules.","old_value":""}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:56:43Z","event_type":"status_changed","id":1094,"issue_id":"beadboard-maf.3","new_value":"{\"assignee\":\"beadboard-2i2\",\"status\":\"in_progress\"}","old_value":"{\"id\":\"beadboard-maf.3\",\"title\":\"v5: swarm system reference rewrite\",\"description\":\"TASK CONTEXT\\n- Bead ID: beadboard-maf.3\\n- Parent/Epic: beadboard-maf\\n- Dependencies: None (parallelizable with maf.1, maf.2, maf.4, maf.5)\\n\\nTASK CONTRACT\\n- Goal: Rewrite archetypes-templates-swarms.md replacing vague 'use your environment swarm commands' with real bd swarm and bd mol commands, and adding template discovery so agents know what swarm they're in.\\n- Success Criteria:\\n - bd swarm create \\u003cepic-id\\u003e, bd swarm status, bd swarm list, bd swarm validate documented with examples\\n - bd mol show \\u003cproto-id\\u003e documented: how agents discover the template/proto their swarm was instantiated from\\n - Archetype contracts expanded: coder/reviewer/writer each get quality gates, handoff payload format, escalation triggers\\n - Swarm join flow for worker agents documented (not just orchestrators)\\n - Swarm closure ownership defined: who closes and when\\n - Command surface section replaced with real commands (no more 'expected operations' placeholder)\\n- Scope:\\n - skills/beadboard-driver/references/archetypes-templates-swarms.md rewrite\\n - bd swarm subcommands\\n - bd mol show (template discovery)\\n- Out of Scope:\\n - bd mol pour/wisp/bond (molecule instantiation is user/orchestrator territory)\\n - BeadBoard UI swarm views\\n\\nIMPLEMENTATION CONSTRAINTS\\n- Source of truth for bd swarm: run bd swarm --help and bd swarm create --help in beadboard/\\n- No invented commands — only document commands verified to exist\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: None (doc task)\\n- Required artifacts: updated skills/beadboard-driver/references/archetypes-templates-swarms.md\",\"status\":\"open\",\"priority\":1,\"issue_type\":\"task\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:36:29Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T01:36:29Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:57:07Z","event_type":"updated","id":1095,"issue_id":"beadboard-maf.3","new_value":"{\"notes\":\"Rewrote skills/beadboard-driver/references/archetypes-templates-swarms.md with verified command surface from bd swarm and bd mol. Added concrete commands/examples for create/status/list/validate and mol show --parallel, expanded coder/reviewer/writer archetype contracts (quality gates, handoff payloads, escalation triggers), documented worker join flow, and clarified swarm closure ownership/checklist. Removed placeholder command language in favor of real commands only. Verification artifact: updated archetypes-templates-swarms.md in skills path.\"}","old_value":"{\"id\":\"beadboard-maf.3\",\"title\":\"v5: swarm system reference rewrite\",\"description\":\"TASK CONTEXT\\n- Bead ID: beadboard-maf.3\\n- Parent/Epic: beadboard-maf\\n- Dependencies: None (parallelizable with maf.1, maf.2, maf.4, maf.5)\\n\\nTASK CONTRACT\\n- Goal: Rewrite archetypes-templates-swarms.md replacing vague 'use your environment swarm commands' with real bd swarm and bd mol commands, and adding template discovery so agents know what swarm they're in.\\n- Success Criteria:\\n - bd swarm create \\u003cepic-id\\u003e, bd swarm status, bd swarm list, bd swarm validate documented with examples\\n - bd mol show \\u003cproto-id\\u003e documented: how agents discover the template/proto their swarm was instantiated from\\n - Archetype contracts expanded: coder/reviewer/writer each get quality gates, handoff payload format, escalation triggers\\n - Swarm join flow for worker agents documented (not just orchestrators)\\n - Swarm closure ownership defined: who closes and when\\n - Command surface section replaced with real commands (no more 'expected operations' placeholder)\\n- Scope:\\n - skills/beadboard-driver/references/archetypes-templates-swarms.md rewrite\\n - bd swarm subcommands\\n - bd mol show (template discovery)\\n- Out of Scope:\\n - bd mol pour/wisp/bond (molecule instantiation is user/orchestrator territory)\\n - BeadBoard UI swarm views\\n\\nIMPLEMENTATION CONSTRAINTS\\n- Source of truth for bd swarm: run bd swarm --help and bd swarm create --help in beadboard/\\n- No invented commands — only document commands verified to exist\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: None (doc task)\\n- Required artifacts: updated skills/beadboard-driver/references/archetypes-templates-swarms.md\",\"status\":\"in_progress\",\"priority\":1,\"issue_type\":\"task\",\"assignee\":\"beadboard-2i2\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:36:29Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:56:43Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:57:07Z","event_type":"closed","id":1096,"issue_id":"beadboard-maf.3","new_value":"Replaced placeholder swarm guidance with real bd swarm/mol command workflows and role contracts.","old_value":""}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:57:23Z","event_type":"status_changed","id":1097,"issue_id":"beadboard-maf.4","new_value":"{\"assignee\":\"beadboard-2i2\",\"status\":\"in_progress\"}","old_value":"{\"id\":\"beadboard-maf.4\",\"title\":\"v5: bead lifecycle + dep workflow expansion\",\"description\":\"TASK CONTEXT\\n- Bead ID: beadboard-maf.4\\n- Parent/Epic: beadboard-maf\\n- Dependencies: None (parallelizable with maf.1, maf.2, maf.3, maf.5)\\n\\nTASK CONTRACT\\n- Goal: Expand session-lifecycle.md to cover the BLOCKED path, bd dep workflow, epic/parent bead guidance, and fix the --claim vs --assignee inconsistency.\\n- Success Criteria:\\n - --claim replaced everywhere with --assignee \\u003cagent-bead-id\\u003e (the correct flag)\\n - BLOCKED path documented: bd agent state \\u003cid\\u003e stuck + bb mail send BLOCKED + what to do while waiting\\n - bd dep add and bd dep relate documented with when-to-use guidance\\n - Epic/parent bead guidance: bd show \\u003cepic-id\\u003e before claiming child tasks, bd children \\u003cepic-id\\u003e to see sibling work\\n - Memory review step has substance: exact decision rule for when to create vs skip canonical memory\\n - Session start now includes: create agent bead, set state spawning, attach hook slot, query hard memory\\n- Scope:\\n - skills/beadboard-driver/references/session-lifecycle.md rewrite\\n - bd dep subcommands (add, relate, list, tree)\\n- Out of Scope:\\n - Communication protocol details (covered in maf.6)\\n\\nIMPLEMENTATION CONSTRAINTS\\n- --assignee requires an agent bead to exist first — document this ordering explicitly\\n- BLOCKED path must reference bd agent state stuck (not just mail events)\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: None (doc task)\\n- Required artifacts: updated skills/beadboard-driver/references/session-lifecycle.md\",\"status\":\"open\",\"priority\":1,\"issue_type\":\"task\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:36:29Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T01:36:29Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:57:44Z","event_type":"updated","id":1098,"issue_id":"beadboard-maf.4","new_value":"{\"notes\":\"Rewrote skills/beadboard-driver/references/session-lifecycle.md. Replaced deprecated --claim usage with correct --assignee ordering, added explicit session-start sequencing (agent bead creation, state spawning/running, hard-memory query), added epic/children read step, documented bd dep add/relate/list/tree with when-to-use guidance, expanded mandatory BLOCKED path (state stuck + BLOCKED mail + heartbeat + resume), and added concrete memory-review decision rule (create/supersede vs skip). Verification artifact: updated session-lifecycle.md in skills path.\"}","old_value":"{\"id\":\"beadboard-maf.4\",\"title\":\"v5: bead lifecycle + dep workflow expansion\",\"description\":\"TASK CONTEXT\\n- Bead ID: beadboard-maf.4\\n- Parent/Epic: beadboard-maf\\n- Dependencies: None (parallelizable with maf.1, maf.2, maf.3, maf.5)\\n\\nTASK CONTRACT\\n- Goal: Expand session-lifecycle.md to cover the BLOCKED path, bd dep workflow, epic/parent bead guidance, and fix the --claim vs --assignee inconsistency.\\n- Success Criteria:\\n - --claim replaced everywhere with --assignee \\u003cagent-bead-id\\u003e (the correct flag)\\n - BLOCKED path documented: bd agent state \\u003cid\\u003e stuck + bb mail send BLOCKED + what to do while waiting\\n - bd dep add and bd dep relate documented with when-to-use guidance\\n - Epic/parent bead guidance: bd show \\u003cepic-id\\u003e before claiming child tasks, bd children \\u003cepic-id\\u003e to see sibling work\\n - Memory review step has substance: exact decision rule for when to create vs skip canonical memory\\n - Session start now includes: create agent bead, set state spawning, attach hook slot, query hard memory\\n- Scope:\\n - skills/beadboard-driver/references/session-lifecycle.md rewrite\\n - bd dep subcommands (add, relate, list, tree)\\n- Out of Scope:\\n - Communication protocol details (covered in maf.6)\\n\\nIMPLEMENTATION CONSTRAINTS\\n- --assignee requires an agent bead to exist first — document this ordering explicitly\\n- BLOCKED path must reference bd agent state stuck (not just mail events)\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: None (doc task)\\n- Required artifacts: updated skills/beadboard-driver/references/session-lifecycle.md\",\"status\":\"in_progress\",\"priority\":1,\"issue_type\":\"task\",\"assignee\":\"beadboard-2i2\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:36:29Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:57:23Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:57:45Z","event_type":"closed","id":1099,"issue_id":"beadboard-maf.4","new_value":"Expanded session lifecycle into a complete command-backed runbook with correct claim/dependency/blocked flow.","old_value":""}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:57:59Z","event_type":"status_changed","id":1100,"issue_id":"beadboard-maf.5","new_value":"{\"assignee\":\"beadboard-2i2\",\"status\":\"in_progress\"}","old_value":"{\"id\":\"beadboard-maf.5\",\"title\":\"v5: script platform fix (Linux/WSL bb discovery)\",\"description\":\"TASK CONTEXT\\n- Bead ID: beadboard-maf.5\\n- Parent/Epic: beadboard-maf\\n- Dependencies: None (parallelizable with maf.1-maf.4)\\n\\nTASK CONTRACT\\n- Goal: Fix driver-lib.mjs discoverBbPath() which only searches for bb.ps1, causing BB_NOT_FOUND on all Linux/WSL agents even when bb is in PATH.\\n- Success Criteria:\\n - discoverBbPath() finds bb binary on Linux/WSL via PATH or known install locations\\n - Windows bb.ps1 discovery still works (no regression)\\n - session-preflight.contract.test.mjs passes on Linux (currently platform-assumption failure)\\n - resolve-bb.contract.test.mjs passes on Linux\\n - npm run typecheck, lint, test all pass\\n- Scope:\\n - scripts/lib/driver-lib.mjs: discoverBbPath() and validateRepoPath() functions\\n - Platform-branching: Windows checks bb.ps1, Linux/Mac checks bb binary in PATH and npm global\\n - Contract test updates for cross-platform assumptions\\n- Out of Scope:\\n - Windows path handling changes\\n - bb mail configuration (maf.5 in izs)\\n\\nIMPLEMENTATION CONSTRAINTS\\n- Do not break existing Windows discovery logic\\n- On Linux, check: PATH entries for 'bb', npm global bin, ~/.npm-global/bin/bb\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: npm run typecheck, npm run lint, npm run test\\n- Required artifacts: updated driver-lib.mjs, updated contract tests\",\"status\":\"open\",\"priority\":1,\"issue_type\":\"task\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:36:51Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T01:36:51Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T19:03:33Z","event_type":"updated","id":1101,"issue_id":"beadboard-maf.5","new_value":"{\"notes\":\"Implemented Linux/WSL discovery fix in skills/beadboard-driver/scripts/lib/driver-lib.mjs: (1) validateRepoPath now accepts bb.ps1 or bin/beadboard.js with platform-aware candidate order; (2) discoverBbPath now checks PATH via findCommandInPath('bb') before BFS; (3) BFS now searches both bb.ps1 and bin/beadboard.js cross-platform. Verification (2026-03-04): npm run typecheck -\\u003e pass; npm run lint -\\u003e pass (21 pre-existing warnings, 0 errors); npm run test -\\u003e pass.\"}","old_value":"{\"id\":\"beadboard-maf.5\",\"title\":\"v5: script platform fix (Linux/WSL bb discovery)\",\"description\":\"TASK CONTEXT\\n- Bead ID: beadboard-maf.5\\n- Parent/Epic: beadboard-maf\\n- Dependencies: None (parallelizable with maf.1-maf.4)\\n\\nTASK CONTRACT\\n- Goal: Fix driver-lib.mjs discoverBbPath() which only searches for bb.ps1, causing BB_NOT_FOUND on all Linux/WSL agents even when bb is in PATH.\\n- Success Criteria:\\n - discoverBbPath() finds bb binary on Linux/WSL via PATH or known install locations\\n - Windows bb.ps1 discovery still works (no regression)\\n - session-preflight.contract.test.mjs passes on Linux (currently platform-assumption failure)\\n - resolve-bb.contract.test.mjs passes on Linux\\n - npm run typecheck, lint, test all pass\\n- Scope:\\n - scripts/lib/driver-lib.mjs: discoverBbPath() and validateRepoPath() functions\\n - Platform-branching: Windows checks bb.ps1, Linux/Mac checks bb binary in PATH and npm global\\n - Contract test updates for cross-platform assumptions\\n- Out of Scope:\\n - Windows path handling changes\\n - bb mail configuration (maf.5 in izs)\\n\\nIMPLEMENTATION CONSTRAINTS\\n- Do not break existing Windows discovery logic\\n- On Linux, check: PATH entries for 'bb', npm global bin, ~/.npm-global/bin/bb\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: npm run typecheck, npm run lint, npm run test\\n- Required artifacts: updated driver-lib.mjs, updated contract tests\",\"status\":\"in_progress\",\"priority\":1,\"issue_type\":\"task\",\"assignee\":\"beadboard-2i2\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:36:51Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:57:59Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T19:03:33Z","event_type":"closed","id":1102,"issue_id":"beadboard-maf.5","new_value":"Platform-specific bb discovery now works on Linux/WSL and Windows-compatible entrypoints remain supported.","old_value":""}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T19:03:52Z","event_type":"status_changed","id":1103,"issue_id":"beadboard-maf.6","new_value":"{\"assignee\":\"beadboard-2i2\",\"status\":\"in_progress\"}","old_value":"{\"id\":\"beadboard-maf.6\",\"title\":\"v5: comm system rewrite (coord-events-sessions-ack.md)\",\"description\":\"## TASK CONTEXT\\n- Bead ID: beadboard-maf.6\\n- Parent/Epic: beadboard-maf\\n- Dependencies: beadboard-izs (bb mail epic must be fully complete — commands finalized and reference doc written in izs.7)\\n\\ncoord-events-sessions-ack.md currently documents deprecated command signatures. The coordination system is fully implemented in tools/bb.ts (bb agent send/inbox/read/ack/register/reserve/release/status), backed by src/lib/agent-mail.ts, agent-registry.ts, agent-reservations.ts. izs.7 produces the canonical reference doc — this task rewrites the skill reference using it.\\n\\n## TASK CONTRACT\\n**Goal**: Rewrite coord-events-sessions-ack.md (or replace with coordination-system.md from izs.7) with accurate bb agent command surface, WHEN-to-use triggers, and a worked BLOCKED flow example.\\n\\n**Success Criteria**:\\n- Uses bb agent send/inbox/read/ack with correct flags (not speculative — verified against tools/bb.ts)\\n- WHEN-to-use trigger map: condition that triggers each category (HANDOFF, BLOCKED, DECISION, INFO)\\n- Inbox polling protocol: when agents check inbox (session start, before claiming task, on state=stuck)\\n- Full BLOCKED walkthrough: agent sends bb agent send --category BLOCKED → bd agent state stuck → user sees in BeadBoard UI → user intervenes → agent resumes\\n- ACK escalation path documented for requires_ack=true messages\\n- bd mail delegate documented as the alternative invocation path (bd mail → bb agent)\\n- Reservation conflict protocol: active blocks, stale warns with --takeover-stale\\n- Zero references to phantom or deprecated API surfaces\\n- Must read izs.7 coordination-system.md FIRST — do not invent command syntax\\n\\n**Scope**:\\n- .agents/skills/beadboard-driver/references/coord-events-sessions-ack.md rewrite\\n- May link to or embed content from coordination-system.md (izs.7)\\n\\n**Out of Scope**:\\n- SKILL.md update (maf.10)\\n- Other reference docs\\n\\n## IMPLEMENTATION CONSTRAINTS\\n- Read izs.7 output (coordination-system.md) before writing anything\\n- Verify all command examples compile against actual tools/bb.ts command surface\\n\\n## VERIFICATION REQUIREMENTS\\n- All command examples match actual bb agent flags\\n- WHEN-to-use map covers at least 6 trigger scenarios\\n- Worked BLOCKED flow is end-to-end complete\",\"status\":\"open\",\"priority\":1,\"issue_type\":\"task\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:36:51Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:10:02Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T19:04:50Z","event_type":"updated","id":1104,"issue_id":"beadboard-maf.6","new_value":"{\"notes\":\"Rewrote skills/beadboard-driver/references/coord-events-sessions-ack.md against canonical izs.7 coordination-system.md and verified bb command surface in tools/bb.ts. Updated categories to HANDOFF/BLOCKED/DECISION/INFO only; added explicit ack semantics, inbox polling protocol, 7-scenario WHEN-to-use trigger map, complete BLOCKED -\\u003e bd agent state stuck -\\u003e user intervention -\\u003e ack -\\u003e running flow, bd mail delegate mapping, and reservation conflict/takeover-stale policy. Removed deprecated/phantom command and category references.\"}","old_value":"{\"id\":\"beadboard-maf.6\",\"title\":\"v5: comm system rewrite (coord-events-sessions-ack.md)\",\"description\":\"## TASK CONTEXT\\n- Bead ID: beadboard-maf.6\\n- Parent/Epic: beadboard-maf\\n- Dependencies: beadboard-izs (bb mail epic must be fully complete — commands finalized and reference doc written in izs.7)\\n\\ncoord-events-sessions-ack.md currently documents deprecated command signatures. The coordination system is fully implemented in tools/bb.ts (bb agent send/inbox/read/ack/register/reserve/release/status), backed by src/lib/agent-mail.ts, agent-registry.ts, agent-reservations.ts. izs.7 produces the canonical reference doc — this task rewrites the skill reference using it.\\n\\n## TASK CONTRACT\\n**Goal**: Rewrite coord-events-sessions-ack.md (or replace with coordination-system.md from izs.7) with accurate bb agent command surface, WHEN-to-use triggers, and a worked BLOCKED flow example.\\n\\n**Success Criteria**:\\n- Uses bb agent send/inbox/read/ack with correct flags (not speculative — verified against tools/bb.ts)\\n- WHEN-to-use trigger map: condition that triggers each category (HANDOFF, BLOCKED, DECISION, INFO)\\n- Inbox polling protocol: when agents check inbox (session start, before claiming task, on state=stuck)\\n- Full BLOCKED walkthrough: agent sends bb agent send --category BLOCKED → bd agent state stuck → user sees in BeadBoard UI → user intervenes → agent resumes\\n- ACK escalation path documented for requires_ack=true messages\\n- bd mail delegate documented as the alternative invocation path (bd mail → bb agent)\\n- Reservation conflict protocol: active blocks, stale warns with --takeover-stale\\n- Zero references to phantom or deprecated API surfaces\\n- Must read izs.7 coordination-system.md FIRST — do not invent command syntax\\n\\n**Scope**:\\n- .agents/skills/beadboard-driver/references/coord-events-sessions-ack.md rewrite\\n- May link to or embed content from coordination-system.md (izs.7)\\n\\n**Out of Scope**:\\n- SKILL.md update (maf.10)\\n- Other reference docs\\n\\n## IMPLEMENTATION CONSTRAINTS\\n- Read izs.7 output (coordination-system.md) before writing anything\\n- Verify all command examples compile against actual tools/bb.ts command surface\\n\\n## VERIFICATION REQUIREMENTS\\n- All command examples match actual bb agent flags\\n- WHEN-to-use map covers at least 6 trigger scenarios\\n- Worked BLOCKED flow is end-to-end complete\",\"status\":\"in_progress\",\"priority\":1,\"issue_type\":\"task\",\"assignee\":\"beadboard-2i2\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:36:51Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T03:03:53Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T19:04:51Z","event_type":"closed","id":1105,"issue_id":"beadboard-maf.6","new_value":"Coordination events/session/ack reference now matches live bb agent and bd mail delegate behavior, including end-to-end blocked recovery flow.","old_value":""}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T19:05:04Z","event_type":"status_changed","id":1106,"issue_id":"beadboard-maf.7","new_value":"{\"assignee\":\"beadboard-2i2\",\"status\":\"in_progress\"}","old_value":"{\"id\":\"beadboard-maf.7\",\"title\":\"v5: command matrix + failure modes rewrite\",\"description\":\"TASK CONTEXT\\n- Bead ID: beadboard-maf.7\\n- Parent/Epic: beadboard-maf\\n- Dependencies: beadboard-maf.6 (comm system must be rewritten so command matrix reflects real surface)\\n\\nTASK CONTRACT\\n- Goal: Rewrite command-matrix.md and failure-modes.md to remove all dead bb agent commands and add the full live command surface.\\n- Success Criteria:\\n - command-matrix.md: zero bb agent commands; full surface: bd agent state/heartbeat, bd swarm, bb mail, bd slot, bd gate, bd mol, bd dep, bd comments\\n - failure-modes.md: reservoir/reservation errors removed; new entries: bb mail not configured (error_code + remediation), Dolt not running, bd agent heartbeat missed (Witness marks dead), bd mail delegate not set\\n - All commands in matrix verified to exist (no invented flags)\\n- Scope:\\n - skills/beadboard-driver/references/command-matrix.md full rewrite\\n - skills/beadboard-driver/references/failure-modes.md update\\n- Out of Scope:\\n - New command implementations\\n\\nIMPLEMENTATION CONSTRAINTS\\n- Cross-reference against bd --help and bb --help output before writing\\n- Every command in the matrix must include the real flag names (not paraphrases)\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: None (doc task)\\n- Required artifacts: updated command-matrix.md, updated failure-modes.md\",\"status\":\"open\",\"priority\":1,\"issue_type\":\"task\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:37:08Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T01:37:08Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T19:08:47Z","event_type":"updated","id":1107,"issue_id":"beadboard-maf.7","new_value":"{\"notes\":\"Rewrote skills/beadboard-driver/references/command-matrix.md and failure-modes.md against live CLI help output (bd agent/swarm/slot/gate/mol/dep/comments/mail plus bb-backed delegate behavior). Removed old/dead direct command patterns (including --claim and direct bb agent workflow commands), corrected swarm create flags to documented --coordinator/--force surface, and added failure coverage for MAIL_DELEGATE_MISSING, BB_MAIL_NOT_CONFIGURED, DOLT_NOT_RUNNING, and AGENT_HEARTBEAT_MISSED.\"}","old_value":"{\"id\":\"beadboard-maf.7\",\"title\":\"v5: command matrix + failure modes rewrite\",\"description\":\"TASK CONTEXT\\n- Bead ID: beadboard-maf.7\\n- Parent/Epic: beadboard-maf\\n- Dependencies: beadboard-maf.6 (comm system must be rewritten so command matrix reflects real surface)\\n\\nTASK CONTRACT\\n- Goal: Rewrite command-matrix.md and failure-modes.md to remove all dead bb agent commands and add the full live command surface.\\n- Success Criteria:\\n - command-matrix.md: zero bb agent commands; full surface: bd agent state/heartbeat, bd swarm, bb mail, bd slot, bd gate, bd mol, bd dep, bd comments\\n - failure-modes.md: reservoir/reservation errors removed; new entries: bb mail not configured (error_code + remediation), Dolt not running, bd agent heartbeat missed (Witness marks dead), bd mail delegate not set\\n - All commands in matrix verified to exist (no invented flags)\\n- Scope:\\n - skills/beadboard-driver/references/command-matrix.md full rewrite\\n - skills/beadboard-driver/references/failure-modes.md update\\n- Out of Scope:\\n - New command implementations\\n\\nIMPLEMENTATION CONSTRAINTS\\n- Cross-reference against bd --help and bb --help output before writing\\n- Every command in the matrix must include the real flag names (not paraphrases)\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: None (doc task)\\n- Required artifacts: updated command-matrix.md, updated failure-modes.md\",\"status\":\"in_progress\",\"priority\":1,\"issue_type\":\"task\",\"assignee\":\"beadboard-2i2\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:37:08Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T03:05:05Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T19:08:47Z","event_type":"closed","id":1108,"issue_id":"beadboard-maf.7","new_value":"Command matrix and failure modes now reflect the current delegated coordination surface and verified CLI flags.","old_value":""}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T19:09:01Z","event_type":"status_changed","id":1109,"issue_id":"beadboard-maf.8","new_value":"{\"assignee\":\"beadboard-2i2\",\"status\":\"in_progress\"}","old_value":"{\"id\":\"beadboard-maf.8\",\"title\":\"v5: tests update\",\"description\":\"TASK CONTEXT\\n- Bead ID: beadboard-maf.8\\n- Parent/Epic: beadboard-maf\\n- Dependencies: beadboard-maf.5 (script fix), beadboard-maf.6 (comm system — tests must match new commands)\\n\\nTASK CONTRACT\\n- Goal: Update skill-local and repo-level tests so they pass on Linux/WSL and cover the new bb mail integration.\\n- Success Criteria:\\n - session-preflight.contract.test.mjs: remove Windows-only assumptions, pass on Linux\\n - resolve-bb.contract.test.mjs: Linux bb binary discovery tested\\n - bb-mail integration test: full send-\\u003einbox-\\u003eread-\\u003eack lifecycle in isolated tmpdir\\n - ensure-bb-mail-configured.mjs contract test: missing delegate detected and remediation shown\\n - All tests registered in run-tests.mjs and package.json\\n - npm run typecheck, lint, test all pass\\n- Scope:\\n - skills/beadboard-driver/tests/*.contract.test.mjs updates\\n - tests/skills/beadboard-driver/*.test.ts updates\\n - package.json test registration\\n- Out of Scope:\\n - Windows CI (follow-up epic)\\n\\nIMPLEMENTATION CONSTRAINTS\\n- No mocking of bd — use real bd in tmpdir\\n- New test files must be added to package.json test script (explicitly enumerated)\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: npm run typecheck, npm run lint, npm run test\\n- Required artifacts: all updated test files, updated package.json\",\"status\":\"open\",\"priority\":1,\"issue_type\":\"task\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:37:09Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T01:37:09Z\"}"}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T19:12:48Z","event_type":"created","id":1110,"issue_id":"bb-maf8-1772593966-a","new_value":"","old_value":""}
{"actor":"ZenchantLive","comment":"Added label: gt:agent","created_at":"2026-03-03T19:12:48Z","event_type":"label_added","id":1111,"issue_id":"bb-maf8-1772593966-a","new_value":null,"old_value":null}
{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T19:12:48Z","event_type":"updated","id":1112,"issue_id":"bb-maf8-1772593966-a","new_value":"{\"agent_state\":\"idle\",\"last_activity\":\"2026-03-03T19:12:48.207693789-08:00\"}","old_value":"{\"id\":\"bb-maf8-1772593966-a\",\"title\":\"Agent: bb-maf8-1772593966-a\",\"status\":\"open\",\"priority\":0,\"issue_type\":\"task\",\"created_at\":\"2026-03-04T03:12:48Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T03:12:48Z\"}"}

13
.beads/backup/issues.jsonl
View file

@ -135,6 +135,7 @@
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"RESTART: Messy hierarchy and poor descriptive detail. Replacing with a disciplined, prompt-based plan.","closed_at":"2026-02-14T21:58:10Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"f899099f00b34991c841b9fbe94688353120e203d1af6bf4a420dae75f9ded89","created_at":"2026-02-14T21:47:54Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"IMPLEMENTATION SPECIFICATION:\n1. SOP: Mandate 'Signal Discipline' (stuck/running/done states).\n2. TELEMETRY: Codified Wisp etiquette for high-frequency internal status.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-jp2.3","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"EXECUTION MANIFEST: Resilient SOP v3. (Detailed in doc/plans/roadmap)","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":2,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":".","source_system":"","spec_id":null,"status":"closed","target":"","timeout_ns":0,"title":"Skill Update: The Resilient Operative Handbook v3","updated_at":"2026-02-14T21:58:10Z","waiters":"","wisp_type":"","work_type":"mutex"}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Deleted: created before plan approval","closed_at":"2026-02-14T17:45:02Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"1bd97c59c4a698c8cb9bc0fd84531b7793e713cb7f38df076b0ef97f45f7c9e7","created_at":"2026-02-14T17:43:59Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"Implement the end-to-end Operative Protocol: identity adoption, heartbeat-backed reservations, and traceable incursions with real-time War Room visibility.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-kp5","is_template":0,"issue_type":"epic","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":".","source_system":"","spec_id":null,"status":"closed","target":"","timeout_ns":0,"title":"EPIC: The Operative Protocol (Agent Coordination v2)","updated_at":"2026-02-14T17:45:02Z","waiters":"","wisp_type":"","work_type":"mutex"}
{"acceptance_criteria":"For a claimed issue, BeadBoard reflects status changes without stale drift; repro and root cause documented; regression checks added.","actor":"","agent_state":"","assignee":"zenchantlive","await_id":"","await_type":"","close_reason":"Status refresh regression resolved: live read freshness + SSE event emission restored; verified via terminal event probe and manual status toggle without page refresh.","closed_at":"2026-02-13T23:36:30Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"f782de732be6cbfca4351aa783bf181192ac8ed1f6b785f24976f78dbf945f55","created_at":"2026-02-13T23:16:23Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"Triage and fix mismatch where bd shows updated status (e.g., in_progress) but BeadBoard/BV surfaces continue showing stale values or require manual refresh. Investigate DB-\u003eJSONL sync, scope/root selection, API read path, and SSE propagation.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-lvl","is_template":0,"issue_type":"bug","last_activity":null,"metadata":"{}","mol_type":"","notes":"Root-cause evidence: bd DB status diverged from .beads/issues.jsonl (bb-dcv.2 in_progress in bd show, open in JSONL before sync). After bd sync in repo root, JSONL updated immediately. Suspected freshness bug from disk-only read path.\nImplemented freshness-path fix: app reads now prefer bd list --json with fallback to disk JSONL. Updated src/lib/read-issues.ts, src/lib/aggregate-read.ts, src/app/page.tsx, src/app/graph/page.tsx, and src/app/api/beads/read/route.ts. Verification: npm run typecheck, npm run lint, npm run test all passed.\nSecond triage fix for live refresh: watcher now includes .beads/beads.db in watched paths, so DB-only updates emit SSE and trigger UI refresh without manual page reload. Updated src/lib/watcher.ts and tests/lib/watcher.test.ts (new beads.db event test). Verification: watcher test pass, typecheck pass, lint pass.\nFurther root cause: events fallback compared .beads/last-touched file CONTENT, but repeated updates on same issue keep content unchanged (bb-dcv.2) while only mtime changes. Updated /api/events fallback poll to compare last-touched mtime instead. Also expanded watcher inputs to include beads.db-wal and last-touched.\nPost-restart verification: end-to-end SSE probe now receives issues events after external bd update (saw_issues_event=true). This confirms refresh path works when server runs updated /api/events logic.","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":".","source_system":"","spec_id":null,"status":"closed","target":"","timeout_ns":0,"title":"Fix stale bead status rendering and refresh propagation in BeadBoard","updated_at":"2026-02-13T23:36:30Z","waiters":"","wisp_type":"","work_type":"mutex"}
{"acceptance_criteria":"","actor":"","agent_state":"idle","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"1bd553abd52b05fa5521c1e1851047aeba66ca55e921c0bca64d468f354bc167","created_at":"2026-03-04T03:12:48Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-maf8-1772593966-a","is_template":0,"issue_type":"task","last_activity":"2026-03-04T03:12:48Z","metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"","payload":"","pinned":0,"priority":0,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"Agent: bb-maf8-1772593966-a","updated_at":"2026-03-04T03:12:48Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Implemented ready/blocked swimlane model, blocked-tree deep links to lane focus, and verification passed (kanban tests, typecheck, full test suite).","closed_at":"2026-02-13T02:40:08Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"4dfc843cda81c719b1ff2c137e11e80909111c80505b4555b04affd93bc6a00d","created_at":"2026-02-13T01:55:04Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-n7p","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Implemented new swimlane model: removed deferred lane from board usage; added ready lane and dependency-derived blocked lane. Lane rules: closed-\u003eDone; blocked-\u003eBlocked if explicit status blocked OR has active incoming blocker edge; in_progress/review-\u003eIn Progress; otherwise Ready. Added laneToMutationStatus to map board lane writes to bead statuses (ready-\u003eopen). Updated board labels/colors, drag-drop lane source tracking, and controls stat label Open-\u003eReady. TDD: updated tests/lib/kanban.test.ts for ready/blocked semantics. Verification: node --import tsx --test tests/lib/kanban.test.ts (pass), npm run typecheck (pass), npm run test (pass).","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":".","source_system":"","spec_id":null,"status":"closed","target":"","timeout_ns":0,"title":"Swimlane status model: ready + dependency-derived blocked","updated_at":"2026-02-13T02:40:08Z","waiters":"","wisp_type":"","work_type":"mutex"}
{"acceptance_criteria":"All breakpoints render correctly; Left panel collapses appropriately; Right panel transforms correctly; Screenshots captured at 390px, 768px, 1440px; npm run typecheck passes; npm run lint passes","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"6eae3fc6358f65b406c0c4e82759fa031a917d91c948fdb427bb3e642527049f","created_at":"2026-02-16T02:35:59Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"GOAL:\nIntegrate responsive behavior across all shell components and verify correct display at all breakpoints.\n\nPROBLEM:\nWe have individual components with responsive behavior, but need to ensure they work together correctly at:\n- Mobile (\u003c 768px)\n- Tablet (768px - 1024px)\n- Desktop (≥ 1024px)\n- Ultrawide (≥ 1536px)\n\nACCEPTANCE CRITERIA:\n1. All breakpoints render correctly\n2. Left panel collapses on tablet, hidden on mobile\n3. Right panel is sidebar on desktop, slide-over on tablet, drawer on mobile\n4. Top bar remains visible at all sizes\n5. Card grid adjusts columns appropriately\n6. Screenshots captured at 390px, 768px, 1440px\n7. npm run typecheck passes\n8. npm run lint passes\n\nIMPLEMENTATION STEPS:\n1. Create src/hooks/use-responsive.ts for breakpoint detection\n2. Integrate responsive hook into UnifiedShell\n3. Add conditional rendering for panels\n4. Test all breakpoints manually\n5. Capture screenshots\n\nFILES TO CREATE/MODIFY:\n- src/hooks/use-responsive.ts (NEW)\n- src/app/page.tsx (modify UnifiedShell)\n\nHOOK INTERFACE:\n\n```typescript\ninterface ResponsiveState {\n breakpoint: 'mobile' | 'tablet' | 'desktop' | 'ultrawide';\n isMobile: boolean;\n isTablet: boolean;\n isDesktop: boolean;\n isUltrawide: boolean;\n leftPanelCollapsed: boolean;\n rightPanelAsDrawer: boolean;\n}\n\nfunction useResponsive(): ResponsiveState;\n```\n\nBREAKPOINT LOGIC:\n\n```typescript\nconst BREAKPOINTS = {\n mobile: 768,\n tablet: 1024,\n ultrawide: 1536,\n};\n\n// Mobile: \u003c 768px\n// - Left panel: hidden\n// - Right panel: full-screen drawer\n// - Card grid: 1 column\n\n// Tablet: 768px - 1024px\n// - Left panel: collapsed (icon only)\n// - Right panel: slide-over from right\n// - Card grid: 2 columns\n\n// Desktop: 1024px - 1536px\n// - Left panel: visible (13rem)\n// - Right panel: sidebar (17rem)\n// - Card grid: 3 columns\n\n// Ultrawide: \u003e= 1536px\n// - Left panel: visible (13rem)\n// - Right panel: sidebar (17rem)\n// - Card grid: 4+ columns\n```\n\nSKILLS TO USE:\n- verification-before-completion\n- linus-beads-discipline\n\nDEPENDENCIES:\n- Requires: 1.3, 1.4, 1.5 (all shell components)\n\nVERIFICATION:\n```bash\nnpm run typecheck\nnpm run lint\n# Visual check at all breakpoints\n# Screenshots: artifacts/shell-390.png, shell-768.png, shell-1440.png\n```\n\nEVIDENCE TO CAPTURE:\n- Screenshots at 390px, 768px, 1440px\n- npm run typecheck output\n- npm run lint output","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-puk","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":".","source_system":"","spec_id":null,"status":"tombstone","target":"","timeout_ns":0,"title":"1.6 Responsive Behavior: Integrate and test all breakpoints","updated_at":"2026-02-16T02:41:08Z","waiters":"","wisp_type":"","work_type":"mutex"}
{"acceptance_criteria":"- Users can edit core bead fields from both Kanban and Graph detail panels.\n- Both surfaces use the same validation and update path.\n- Save/cancel/error states are consistent across both surfaces.\n- Typecheck/tests/guards pass and no direct JSONL writes are introduced.","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Shared UI bead editing shipped across Kanban and Graph with verification evidence.","closed_at":"2026-02-13T05:11:43Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"5b537b9a557ab5646a98113e3dd3617466c2438250b24a139478dded7bb30a56","created_at":"2026-02-13T04:50:12Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"Objective:\nAdd true UI editing for bead fields across both detail panels (Kanban + Graph) using one shared edit core so behavior stays consistent.\n\nWhy:\nWrite-back infrastructure exists, but users currently cannot edit bead content from UI detail panels.\n\nScope:\n- Shared edit validation + mutation adapter.\n- Reusable editor UI block for issue fields.\n- Integration into both Kanban and Graph detail panels.\n- Verification for responsive behavior and mutation safety.\n\nOut of scope:\n- Dependency relation editing.\n- AI content generation.\n- Bulk editing.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-q1s","is_template":0,"issue_type":"epic","last_activity":null,"metadata":"{}","mol_type":"","notes":"Execution order enforced through child dependencies.\nExecution order: bb-q1s.1 shared core -\u003e bb-q1s.2 kanban + bb-q1s.3 graph (parallel) -\u003e bb-q1s.4 verification/polish.","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":".","source_system":"","spec_id":null,"status":"closed","target":"","timeout_ns":0,"title":"UI Bead Editing Across Kanban + Graph","updated_at":"2026-02-13T05:11:43Z","waiters":"","wisp_type":"","work_type":"mutex"}
@ -416,12 +417,12 @@
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Added comprehensive agent state+liveness reference for cold agents with command-backed workflows.","closed_at":"2026-03-04T02:55:50Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"c8e612f4d72a5d2057c0cbfbf980a0e83af8c123ac9f9f8a5428996b21f9dba1","created_at":"2026-03-04T01:34:54Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.1\n- Parent/Epic: beadboard-maf\n- Dependencies: None (parallelizable with maf.2-maf.5)\n\nTASK CONTRACT\n- Goal: Write a new agent-state-liveness.md reference covering bd agent state, bd agent heartbeat, bd slot, and the Witness death timeout — the live command surface agents use to report liveness to BeadBoard UI.\n- Success Criteria:\n - All liveness states documented: idle, spawning, running, working, stuck, done, stopped, dead\n - bd agent state \u003cid\u003e \u003cstate\u003e usage with examples for each state transition\n - bd agent heartbeat \u003cid\u003e documented with polling guidance (when to call, how often)\n - bd slot set \u003cagent-id\u003e hook \u003cbead-id\u003e documented: attach current work to agent slot\n - Witness death timeout explained: what happens when heartbeat is missed\n - bd agent state stuck documented as the signal for BLOCKED condition\n - Saved at skills/beadboard-driver/references/agent-state-liveness.md\n- Scope:\n - New reference doc only\n - All bd agent subcommands relevant to agents (state, heartbeat, show)\n - bd slot set/clear/show\n- Out of Scope:\n - bd agent backfill-labels (admin command)\n - BeadBoard UI internals for rendering liveness\n\nIMPLEMENTATION CONSTRAINTS\n- Written for a cold agent reading first time\n- Every command shown with a real example, not just signature\n\nVERIFICATION REQUIREMENTS\n- Required commands: None (doc task)\n- Required artifacts: skills/beadboard-driver/references/agent-state-liveness.md","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.1","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Created new reference: skills/beadboard-driver/references/agent-state-liveness.md. Includes all liveness states (idle/spawning/running/working/stuck/done/stopped/dead), bd agent state usage with transition examples, bd agent heartbeat guidance/cadence, bd slot set/clear/show usage, witness timeout interpretation, and explicit blocked workflow using state stuck + BLOCKED mail signal. Verification artifact: skills/beadboard-driver/references/agent-state-liveness.md exists. Memory review: no new reusable memory.","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"v5: agent state + liveness reference doc (new)","updated_at":"2026-03-04T02:55:50Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"31050ec7871f4fd004abfbfe5170a2aa3f1bc23555fb95949c4eeb7540b593b9","created_at":"2026-03-04T01:37:55Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.10\n- Parent/Epic: beadboard-maf\n- Dependencies: beadboard-maf.1 through beadboard-maf.9 (all reference docs, scripts, and tests must be complete first)\n\nTASK CONTRACT\n- Goal: Rewrite SKILL.md as the v5 entry point — a cold agent's first read that gives them the full operating mental model, a runbook with substance in every step, and a doc map that correctly routes to the new references.\n- Success Criteria:\n - Session runbook has substance in every step (no 'Establish session identity' without actual commands):\n Step 1: Run preflight (session-preflight.mjs + ensure-bb-mail-configured.mjs)\n Step 2: Create agent bead (bd create --label gt:agent,role:...)\n Step 3: Set state spawning -\u003e running (bd agent state)\n Step 4: Query hard memory for task domain\n Step 5: bd ready -\u003e bd show -\u003e claim with --assignee \u003cagent-bead-id\u003e + bd slot set hook\n Step 6: Execute, heartbeat, coordinate via bb mail\n Step 7: Verification gates (typecheck/lint/test)\n Step 8: Publish evidence, bd close\n Step 9: Memory review with decision rule\n - Zero references to deprecated bb agent commands\n - Use-The-Right-Doc map updated to include agent-state-liveness.md and bb-mail.md\n - Bottom Line section is agent-actionable, not marketing copy\n- Scope:\n - skills/beadboard-driver/SKILL.md full rewrite\n- Out of Scope:\n - Any reference doc content (all in maf.1-maf.9)\n\nIMPLEMENTATION CONSTRAINTS\n- SKILL.md is the first doc a cold agent reads — every step must be self-contained enough to act on\n- Must not reference any command not documented in a reference file\n\nVERIFICATION REQUIREMENTS\n- Required commands: None (doc task)\n- Required artifacts: rewritten skills/beadboard-driver/SKILL.md","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.10","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"v5: SKILL.md v5 rewrite (entry point)","updated_at":"2026-03-04T01:37:55Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Updated memory-system reference with anchor IDs, full injection playbook, and promotion/ratification rules.","closed_at":"2026-03-04T02:56:27Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"ef8adc982578c0d43be977a75f8eeb16e9c22cb09de5ea4a88c627218b36da7e","created_at":"2026-03-04T01:34:54Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.2\n- Parent/Epic: beadboard-maf\n- Dependencies: None (parallelizable with maf.1, maf.3-maf.5)\n\nTASK CONTRACT\n- Goal: Update memory-system.md to add missing operational guidance: domain anchor IDs, WHEN-to-query trigger, and the full injection playbook from help/memory/query_and_injection.txt.\n- Success Criteria:\n - Domain anchor IDs added: beadboard-76p (Arch), beadboard-nq9 (Workflow), beadboard-5r1 (Agent Ops), beadboard-fld (UI/UX), beadboard-8st (Reliability)\n - WHEN-to-query trigger added: at session start, before claiming work, when entering a new domain\n - Full injection playbook included (Steps 1-7 from query_and_injection.txt): domain selection, bd query, provenance check, attach via dep relate, contract bead for hard rules, record acknowledgement, preserve provenance in notes\n - 'Ratify by closing' clarified: closed decision bead = active canonical memory\n - Noise budget promotion policy added: incident repeats 2+ times = soft candidate, survives release window = hard candidate\n- Scope:\n - skills/beadboard-driver/references/memory-system.md rewrite/expansion\n- Out of Scope:\n - Changes to bd itself\n - New canonical memory creation\n\nIMPLEMENTATION CONSTRAINTS\n- Source of truth for injection playbook: help/memory/query_and_injection.txt in beadboard repo\n- Source of truth for schema: help/memory/schema_and_noise_budget.txt\n\nVERIFICATION REQUIREMENTS\n- Required commands: None (doc task)\n- Required artifacts: updated skills/beadboard-driver/references/memory-system.md","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.2","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Rewrote skills/beadboard-driver/references/memory-system.md with v5 memory protocol. Added required domain anchor IDs (beadboard-76p, beadboard-nq9, beadboard-5r1, beadboard-fld, beadboard-8st), WHEN-to-query triggers (session start / pre-claim / domain shift), full 7-step injection playbook from help/memory/query_and_injection.txt, ratification clarification (closed decision bead = active canonical memory), and noise-budget promotion policy (repeat incidents -\u003e soft candidate; release-surviving workaround -\u003e hard/soft). Verification artifact: updated memory-system.md in skills path. Memory review: no new reusable memory.","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"v5: memory system reference update","updated_at":"2026-03-04T02:56:27Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"02e7ede9e7b9ec2ba9310ae610af3ef6b50ea40b5ff5e8f6c97ddf9b1006ba7c","created_at":"2026-03-04T01:36:29Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.3\n- Parent/Epic: beadboard-maf\n- Dependencies: None (parallelizable with maf.1, maf.2, maf.4, maf.5)\n\nTASK CONTRACT\n- Goal: Rewrite archetypes-templates-swarms.md replacing vague 'use your environment swarm commands' with real bd swarm and bd mol commands, and adding template discovery so agents know what swarm they're in.\n- Success Criteria:\n - bd swarm create \u003cepic-id\u003e, bd swarm status, bd swarm list, bd swarm validate documented with examples\n - bd mol show \u003cproto-id\u003e documented: how agents discover the template/proto their swarm was instantiated from\n - Archetype contracts expanded: coder/reviewer/writer each get quality gates, handoff payload format, escalation triggers\n - Swarm join flow for worker agents documented (not just orchestrators)\n - Swarm closure ownership defined: who closes and when\n - Command surface section replaced with real commands (no more 'expected operations' placeholder)\n- Scope:\n - skills/beadboard-driver/references/archetypes-templates-swarms.md rewrite\n - bd swarm subcommands\n - bd mol show (template discovery)\n- Out of Scope:\n - bd mol pour/wisp/bond (molecule instantiation is user/orchestrator territory)\n - BeadBoard UI swarm views\n\nIMPLEMENTATION CONSTRAINTS\n- Source of truth for bd swarm: run bd swarm --help and bd swarm create --help in beadboard/\n- No invented commands — only document commands verified to exist\n\nVERIFICATION REQUIREMENTS\n- Required commands: None (doc task)\n- Required artifacts: updated skills/beadboard-driver/references/archetypes-templates-swarms.md","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.3","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"v5: swarm system reference rewrite","updated_at":"2026-03-04T01:36:29Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"5264bd61ea10a08ea41625dee46c7933344faa5d9f0bec29f9f271ea2e19cdb7","created_at":"2026-03-04T01:36:29Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.4\n- Parent/Epic: beadboard-maf\n- Dependencies: None (parallelizable with maf.1, maf.2, maf.3, maf.5)\n\nTASK CONTRACT\n- Goal: Expand session-lifecycle.md to cover the BLOCKED path, bd dep workflow, epic/parent bead guidance, and fix the --claim vs --assignee inconsistency.\n- Success Criteria:\n - --claim replaced everywhere with --assignee \u003cagent-bead-id\u003e (the correct flag)\n - BLOCKED path documented: bd agent state \u003cid\u003e stuck + bb mail send BLOCKED + what to do while waiting\n - bd dep add and bd dep relate documented with when-to-use guidance\n - Epic/parent bead guidance: bd show \u003cepic-id\u003e before claiming child tasks, bd children \u003cepic-id\u003e to see sibling work\n - Memory review step has substance: exact decision rule for when to create vs skip canonical memory\n - Session start now includes: create agent bead, set state spawning, attach hook slot, query hard memory\n- Scope:\n - skills/beadboard-driver/references/session-lifecycle.md rewrite\n - bd dep subcommands (add, relate, list, tree)\n- Out of Scope:\n - Communication protocol details (covered in maf.6)\n\nIMPLEMENTATION CONSTRAINTS\n- --assignee requires an agent bead to exist first — document this ordering explicitly\n- BLOCKED path must reference bd agent state stuck (not just mail events)\n\nVERIFICATION REQUIREMENTS\n- Required commands: None (doc task)\n- Required artifacts: updated skills/beadboard-driver/references/session-lifecycle.md","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.4","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"v5: bead lifecycle + dep workflow expansion","updated_at":"2026-03-04T01:36:29Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"e78bbffbb51b1ff9bfc8f6474ac4903ab89d48b37fbb35a92630da9e2798c4f3","created_at":"2026-03-04T01:36:51Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.5\n- Parent/Epic: beadboard-maf\n- Dependencies: None (parallelizable with maf.1-maf.4)\n\nTASK CONTRACT\n- Goal: Fix driver-lib.mjs discoverBbPath() which only searches for bb.ps1, causing BB_NOT_FOUND on all Linux/WSL agents even when bb is in PATH.\n- Success Criteria:\n - discoverBbPath() finds bb binary on Linux/WSL via PATH or known install locations\n - Windows bb.ps1 discovery still works (no regression)\n - session-preflight.contract.test.mjs passes on Linux (currently platform-assumption failure)\n - resolve-bb.contract.test.mjs passes on Linux\n - npm run typecheck, lint, test all pass\n- Scope:\n - scripts/lib/driver-lib.mjs: discoverBbPath() and validateRepoPath() functions\n - Platform-branching: Windows checks bb.ps1, Linux/Mac checks bb binary in PATH and npm global\n - Contract test updates for cross-platform assumptions\n- Out of Scope:\n - Windows path handling changes\n - bb mail configuration (maf.5 in izs)\n\nIMPLEMENTATION CONSTRAINTS\n- Do not break existing Windows discovery logic\n- On Linux, check: PATH entries for 'bb', npm global bin, ~/.npm-global/bin/bb\n\nVERIFICATION REQUIREMENTS\n- Required commands: npm run typecheck, npm run lint, npm run test\n- Required artifacts: updated driver-lib.mjs, updated contract tests","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.5","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"v5: script platform fix (Linux/WSL bb discovery)","updated_at":"2026-03-04T01:36:51Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"39f60821375aea6d49af9b3c80312d41c2069d18efae43ddd172c393c1ea900d","created_at":"2026-03-04T01:36:51Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## TASK CONTEXT\n- Bead ID: beadboard-maf.6\n- Parent/Epic: beadboard-maf\n- Dependencies: beadboard-izs (bb mail epic must be fully complete — commands finalized and reference doc written in izs.7)\n\ncoord-events-sessions-ack.md currently documents deprecated command signatures. The coordination system is fully implemented in tools/bb.ts (bb agent send/inbox/read/ack/register/reserve/release/status), backed by src/lib/agent-mail.ts, agent-registry.ts, agent-reservations.ts. izs.7 produces the canonical reference doc — this task rewrites the skill reference using it.\n\n## TASK CONTRACT\n**Goal**: Rewrite coord-events-sessions-ack.md (or replace with coordination-system.md from izs.7) with accurate bb agent command surface, WHEN-to-use triggers, and a worked BLOCKED flow example.\n\n**Success Criteria**:\n- Uses bb agent send/inbox/read/ack with correct flags (not speculative — verified against tools/bb.ts)\n- WHEN-to-use trigger map: condition that triggers each category (HANDOFF, BLOCKED, DECISION, INFO)\n- Inbox polling protocol: when agents check inbox (session start, before claiming task, on state=stuck)\n- Full BLOCKED walkthrough: agent sends bb agent send --category BLOCKED → bd agent state stuck → user sees in BeadBoard UI → user intervenes → agent resumes\n- ACK escalation path documented for requires_ack=true messages\n- bd mail delegate documented as the alternative invocation path (bd mail → bb agent)\n- Reservation conflict protocol: active blocks, stale warns with --takeover-stale\n- Zero references to phantom or deprecated API surfaces\n- Must read izs.7 coordination-system.md FIRST — do not invent command syntax\n\n**Scope**:\n- .agents/skills/beadboard-driver/references/coord-events-sessions-ack.md rewrite\n- May link to or embed content from coordination-system.md (izs.7)\n\n**Out of Scope**:\n- SKILL.md update (maf.10)\n- Other reference docs\n\n## IMPLEMENTATION CONSTRAINTS\n- Read izs.7 output (coordination-system.md) before writing anything\n- Verify all command examples compile against actual tools/bb.ts command surface\n\n## VERIFICATION REQUIREMENTS\n- All command examples match actual bb agent flags\n- WHEN-to-use map covers at least 6 trigger scenarios\n- Worked BLOCKED flow is end-to-end complete","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.6","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"v5: comm system rewrite (coord-events-sessions-ack.md)","updated_at":"2026-03-04T02:10:02Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"c81b5ea164b59246e5f60401e0bb9ab3cd38ea9cd9ff1ed97dc5b37f65736fd5","created_at":"2026-03-04T01:37:08Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.7\n- Parent/Epic: beadboard-maf\n- Dependencies: beadboard-maf.6 (comm system must be rewritten so command matrix reflects real surface)\n\nTASK CONTRACT\n- Goal: Rewrite command-matrix.md and failure-modes.md to remove all dead bb agent commands and add the full live command surface.\n- Success Criteria:\n - command-matrix.md: zero bb agent commands; full surface: bd agent state/heartbeat, bd swarm, bb mail, bd slot, bd gate, bd mol, bd dep, bd comments\n - failure-modes.md: reservoir/reservation errors removed; new entries: bb mail not configured (error_code + remediation), Dolt not running, bd agent heartbeat missed (Witness marks dead), bd mail delegate not set\n - All commands in matrix verified to exist (no invented flags)\n- Scope:\n - skills/beadboard-driver/references/command-matrix.md full rewrite\n - skills/beadboard-driver/references/failure-modes.md update\n- Out of Scope:\n - New command implementations\n\nIMPLEMENTATION CONSTRAINTS\n- Cross-reference against bd --help and bb --help output before writing\n- Every command in the matrix must include the real flag names (not paraphrases)\n\nVERIFICATION REQUIREMENTS\n- Required commands: None (doc task)\n- Required artifacts: updated command-matrix.md, updated failure-modes.md","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.7","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"v5: command matrix + failure modes rewrite","updated_at":"2026-03-04T01:37:08Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"d5293835bc2265fe3aace02c18a422e9483beb268b3a10121ee7395c8a3e443a","created_at":"2026-03-04T01:37:09Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.8\n- Parent/Epic: beadboard-maf\n- Dependencies: beadboard-maf.5 (script fix), beadboard-maf.6 (comm system — tests must match new commands)\n\nTASK CONTRACT\n- Goal: Update skill-local and repo-level tests so they pass on Linux/WSL and cover the new bb mail integration.\n- Success Criteria:\n - session-preflight.contract.test.mjs: remove Windows-only assumptions, pass on Linux\n - resolve-bb.contract.test.mjs: Linux bb binary discovery tested\n - bb-mail integration test: full send-\u003einbox-\u003eread-\u003eack lifecycle in isolated tmpdir\n - ensure-bb-mail-configured.mjs contract test: missing delegate detected and remediation shown\n - All tests registered in run-tests.mjs and package.json\n - npm run typecheck, lint, test all pass\n- Scope:\n - skills/beadboard-driver/tests/*.contract.test.mjs updates\n - tests/skills/beadboard-driver/*.test.ts updates\n - package.json test registration\n- Out of Scope:\n - Windows CI (follow-up epic)\n\nIMPLEMENTATION CONSTRAINTS\n- No mocking of bd — use real bd in tmpdir\n- New test files must be added to package.json test script (explicitly enumerated)\n\nVERIFICATION REQUIREMENTS\n- Required commands: npm run typecheck, npm run lint, npm run test\n- Required artifacts: all updated test files, updated package.json","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.8","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"v5: tests update","updated_at":"2026-03-04T01:37:09Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Replaced placeholder swarm guidance with real bd swarm/mol command workflows and role contracts.","closed_at":"2026-03-04T02:57:08Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"02e7ede9e7b9ec2ba9310ae610af3ef6b50ea40b5ff5e8f6c97ddf9b1006ba7c","created_at":"2026-03-04T01:36:29Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.3\n- Parent/Epic: beadboard-maf\n- Dependencies: None (parallelizable with maf.1, maf.2, maf.4, maf.5)\n\nTASK CONTRACT\n- Goal: Rewrite archetypes-templates-swarms.md replacing vague 'use your environment swarm commands' with real bd swarm and bd mol commands, and adding template discovery so agents know what swarm they're in.\n- Success Criteria:\n - bd swarm create \u003cepic-id\u003e, bd swarm status, bd swarm list, bd swarm validate documented with examples\n - bd mol show \u003cproto-id\u003e documented: how agents discover the template/proto their swarm was instantiated from\n - Archetype contracts expanded: coder/reviewer/writer each get quality gates, handoff payload format, escalation triggers\n - Swarm join flow for worker agents documented (not just orchestrators)\n - Swarm closure ownership defined: who closes and when\n - Command surface section replaced with real commands (no more 'expected operations' placeholder)\n- Scope:\n - skills/beadboard-driver/references/archetypes-templates-swarms.md rewrite\n - bd swarm subcommands\n - bd mol show (template discovery)\n- Out of Scope:\n - bd mol pour/wisp/bond (molecule instantiation is user/orchestrator territory)\n - BeadBoard UI swarm views\n\nIMPLEMENTATION CONSTRAINTS\n- Source of truth for bd swarm: run bd swarm --help and bd swarm create --help in beadboard/\n- No invented commands — only document commands verified to exist\n\nVERIFICATION REQUIREMENTS\n- Required commands: None (doc task)\n- Required artifacts: updated skills/beadboard-driver/references/archetypes-templates-swarms.md","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.3","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Rewrote skills/beadboard-driver/references/archetypes-templates-swarms.md with verified command surface from bd swarm and bd mol. Added concrete commands/examples for create/status/list/validate and mol show --parallel, expanded coder/reviewer/writer archetype contracts (quality gates, handoff payloads, escalation triggers), documented worker join flow, and clarified swarm closure ownership/checklist. Removed placeholder command language in favor of real commands only. Verification artifact: updated archetypes-templates-swarms.md in skills path.","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"v5: swarm system reference rewrite","updated_at":"2026-03-04T02:57:08Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Expanded session lifecycle into a complete command-backed runbook with correct claim/dependency/blocked flow.","closed_at":"2026-03-04T02:57:45Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"5264bd61ea10a08ea41625dee46c7933344faa5d9f0bec29f9f271ea2e19cdb7","created_at":"2026-03-04T01:36:29Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.4\n- Parent/Epic: beadboard-maf\n- Dependencies: None (parallelizable with maf.1, maf.2, maf.3, maf.5)\n\nTASK CONTRACT\n- Goal: Expand session-lifecycle.md to cover the BLOCKED path, bd dep workflow, epic/parent bead guidance, and fix the --claim vs --assignee inconsistency.\n- Success Criteria:\n - --claim replaced everywhere with --assignee \u003cagent-bead-id\u003e (the correct flag)\n - BLOCKED path documented: bd agent state \u003cid\u003e stuck + bb mail send BLOCKED + what to do while waiting\n - bd dep add and bd dep relate documented with when-to-use guidance\n - Epic/parent bead guidance: bd show \u003cepic-id\u003e before claiming child tasks, bd children \u003cepic-id\u003e to see sibling work\n - Memory review step has substance: exact decision rule for when to create vs skip canonical memory\n - Session start now includes: create agent bead, set state spawning, attach hook slot, query hard memory\n- Scope:\n - skills/beadboard-driver/references/session-lifecycle.md rewrite\n - bd dep subcommands (add, relate, list, tree)\n- Out of Scope:\n - Communication protocol details (covered in maf.6)\n\nIMPLEMENTATION CONSTRAINTS\n- --assignee requires an agent bead to exist first — document this ordering explicitly\n- BLOCKED path must reference bd agent state stuck (not just mail events)\n\nVERIFICATION REQUIREMENTS\n- Required commands: None (doc task)\n- Required artifacts: updated skills/beadboard-driver/references/session-lifecycle.md","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.4","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Rewrote skills/beadboard-driver/references/session-lifecycle.md. Replaced deprecated --claim usage with correct --assignee ordering, added explicit session-start sequencing (agent bead creation, state spawning/running, hard-memory query), added epic/children read step, documented bd dep add/relate/list/tree with when-to-use guidance, expanded mandatory BLOCKED path (state stuck + BLOCKED mail + heartbeat + resume), and added concrete memory-review decision rule (create/supersede vs skip). Verification artifact: updated session-lifecycle.md in skills path.","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"v5: bead lifecycle + dep workflow expansion","updated_at":"2026-03-04T02:57:45Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Platform-specific bb discovery now works on Linux/WSL and Windows-compatible entrypoints remain supported.","closed_at":"2026-03-04T03:03:33Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"e78bbffbb51b1ff9bfc8f6474ac4903ab89d48b37fbb35a92630da9e2798c4f3","created_at":"2026-03-04T01:36:51Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.5\n- Parent/Epic: beadboard-maf\n- Dependencies: None (parallelizable with maf.1-maf.4)\n\nTASK CONTRACT\n- Goal: Fix driver-lib.mjs discoverBbPath() which only searches for bb.ps1, causing BB_NOT_FOUND on all Linux/WSL agents even when bb is in PATH.\n- Success Criteria:\n - discoverBbPath() finds bb binary on Linux/WSL via PATH or known install locations\n - Windows bb.ps1 discovery still works (no regression)\n - session-preflight.contract.test.mjs passes on Linux (currently platform-assumption failure)\n - resolve-bb.contract.test.mjs passes on Linux\n - npm run typecheck, lint, test all pass\n- Scope:\n - scripts/lib/driver-lib.mjs: discoverBbPath() and validateRepoPath() functions\n - Platform-branching: Windows checks bb.ps1, Linux/Mac checks bb binary in PATH and npm global\n - Contract test updates for cross-platform assumptions\n- Out of Scope:\n - Windows path handling changes\n - bb mail configuration (maf.5 in izs)\n\nIMPLEMENTATION CONSTRAINTS\n- Do not break existing Windows discovery logic\n- On Linux, check: PATH entries for 'bb', npm global bin, ~/.npm-global/bin/bb\n\nVERIFICATION REQUIREMENTS\n- Required commands: npm run typecheck, npm run lint, npm run test\n- Required artifacts: updated driver-lib.mjs, updated contract tests","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.5","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Implemented Linux/WSL discovery fix in skills/beadboard-driver/scripts/lib/driver-lib.mjs: (1) validateRepoPath now accepts bb.ps1 or bin/beadboard.js with platform-aware candidate order; (2) discoverBbPath now checks PATH via findCommandInPath('bb') before BFS; (3) BFS now searches both bb.ps1 and bin/beadboard.js cross-platform. Verification (2026-03-04): npm run typecheck -\u003e pass; npm run lint -\u003e pass (21 pre-existing warnings, 0 errors); npm run test -\u003e pass.","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"v5: script platform fix (Linux/WSL bb discovery)","updated_at":"2026-03-04T03:03:33Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Coordination events/session/ack reference now matches live bb agent and bd mail delegate behavior, including end-to-end blocked recovery flow.","closed_at":"2026-03-04T03:04:51Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"39f60821375aea6d49af9b3c80312d41c2069d18efae43ddd172c393c1ea900d","created_at":"2026-03-04T01:36:51Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## TASK CONTEXT\n- Bead ID: beadboard-maf.6\n- Parent/Epic: beadboard-maf\n- Dependencies: beadboard-izs (bb mail epic must be fully complete — commands finalized and reference doc written in izs.7)\n\ncoord-events-sessions-ack.md currently documents deprecated command signatures. The coordination system is fully implemented in tools/bb.ts (bb agent send/inbox/read/ack/register/reserve/release/status), backed by src/lib/agent-mail.ts, agent-registry.ts, agent-reservations.ts. izs.7 produces the canonical reference doc — this task rewrites the skill reference using it.\n\n## TASK CONTRACT\n**Goal**: Rewrite coord-events-sessions-ack.md (or replace with coordination-system.md from izs.7) with accurate bb agent command surface, WHEN-to-use triggers, and a worked BLOCKED flow example.\n\n**Success Criteria**:\n- Uses bb agent send/inbox/read/ack with correct flags (not speculative — verified against tools/bb.ts)\n- WHEN-to-use trigger map: condition that triggers each category (HANDOFF, BLOCKED, DECISION, INFO)\n- Inbox polling protocol: when agents check inbox (session start, before claiming task, on state=stuck)\n- Full BLOCKED walkthrough: agent sends bb agent send --category BLOCKED → bd agent state stuck → user sees in BeadBoard UI → user intervenes → agent resumes\n- ACK escalation path documented for requires_ack=true messages\n- bd mail delegate documented as the alternative invocation path (bd mail → bb agent)\n- Reservation conflict protocol: active blocks, stale warns with --takeover-stale\n- Zero references to phantom or deprecated API surfaces\n- Must read izs.7 coordination-system.md FIRST — do not invent command syntax\n\n**Scope**:\n- .agents/skills/beadboard-driver/references/coord-events-sessions-ack.md rewrite\n- May link to or embed content from coordination-system.md (izs.7)\n\n**Out of Scope**:\n- SKILL.md update (maf.10)\n- Other reference docs\n\n## IMPLEMENTATION CONSTRAINTS\n- Read izs.7 output (coordination-system.md) before writing anything\n- Verify all command examples compile against actual tools/bb.ts command surface\n\n## VERIFICATION REQUIREMENTS\n- All command examples match actual bb agent flags\n- WHEN-to-use map covers at least 6 trigger scenarios\n- Worked BLOCKED flow is end-to-end complete","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.6","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Rewrote skills/beadboard-driver/references/coord-events-sessions-ack.md against canonical izs.7 coordination-system.md and verified bb command surface in tools/bb.ts. Updated categories to HANDOFF/BLOCKED/DECISION/INFO only; added explicit ack semantics, inbox polling protocol, 7-scenario WHEN-to-use trigger map, complete BLOCKED -\u003e bd agent state stuck -\u003e user intervention -\u003e ack -\u003e running flow, bd mail delegate mapping, and reservation conflict/takeover-stale policy. Removed deprecated/phantom command and category references.","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"v5: comm system rewrite (coord-events-sessions-ack.md)","updated_at":"2026-03-04T03:04:51Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Command matrix and failure modes now reflect the current delegated coordination surface and verified CLI flags.","closed_at":"2026-03-04T03:08:48Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"c81b5ea164b59246e5f60401e0bb9ab3cd38ea9cd9ff1ed97dc5b37f65736fd5","created_at":"2026-03-04T01:37:08Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.7\n- Parent/Epic: beadboard-maf\n- Dependencies: beadboard-maf.6 (comm system must be rewritten so command matrix reflects real surface)\n\nTASK CONTRACT\n- Goal: Rewrite command-matrix.md and failure-modes.md to remove all dead bb agent commands and add the full live command surface.\n- Success Criteria:\n - command-matrix.md: zero bb agent commands; full surface: bd agent state/heartbeat, bd swarm, bb mail, bd slot, bd gate, bd mol, bd dep, bd comments\n - failure-modes.md: reservoir/reservation errors removed; new entries: bb mail not configured (error_code + remediation), Dolt not running, bd agent heartbeat missed (Witness marks dead), bd mail delegate not set\n - All commands in matrix verified to exist (no invented flags)\n- Scope:\n - skills/beadboard-driver/references/command-matrix.md full rewrite\n - skills/beadboard-driver/references/failure-modes.md update\n- Out of Scope:\n - New command implementations\n\nIMPLEMENTATION CONSTRAINTS\n- Cross-reference against bd --help and bb --help output before writing\n- Every command in the matrix must include the real flag names (not paraphrases)\n\nVERIFICATION REQUIREMENTS\n- Required commands: None (doc task)\n- Required artifacts: updated command-matrix.md, updated failure-modes.md","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.7","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Rewrote skills/beadboard-driver/references/command-matrix.md and failure-modes.md against live CLI help output (bd agent/swarm/slot/gate/mol/dep/comments/mail plus bb-backed delegate behavior). Removed old/dead direct command patterns (including --claim and direct bb agent workflow commands), corrected swarm create flags to documented --coordinator/--force surface, and added failure coverage for MAIL_DELEGATE_MISSING, BB_MAIL_NOT_CONFIGURED, DOLT_NOT_RUNNING, and AGENT_HEARTBEAT_MISSED.","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"v5: command matrix + failure modes rewrite","updated_at":"2026-03-04T03:08:48Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"d5293835bc2265fe3aace02c18a422e9483beb268b3a10121ee7395c8a3e443a","created_at":"2026-03-04T01:37:09Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.8\n- Parent/Epic: beadboard-maf\n- Dependencies: beadboard-maf.5 (script fix), beadboard-maf.6 (comm system — tests must match new commands)\n\nTASK CONTRACT\n- Goal: Update skill-local and repo-level tests so they pass on Linux/WSL and cover the new bb mail integration.\n- Success Criteria:\n - session-preflight.contract.test.mjs: remove Windows-only assumptions, pass on Linux\n - resolve-bb.contract.test.mjs: Linux bb binary discovery tested\n - bb-mail integration test: full send-\u003einbox-\u003eread-\u003eack lifecycle in isolated tmpdir\n - ensure-bb-mail-configured.mjs contract test: missing delegate detected and remediation shown\n - All tests registered in run-tests.mjs and package.json\n - npm run typecheck, lint, test all pass\n- Scope:\n - skills/beadboard-driver/tests/*.contract.test.mjs updates\n - tests/skills/beadboard-driver/*.test.ts updates\n - package.json test registration\n- Out of Scope:\n - Windows CI (follow-up epic)\n\nIMPLEMENTATION CONSTRAINTS\n- No mocking of bd — use real bd in tmpdir\n- New test files must be added to package.json test script (explicitly enumerated)\n\nVERIFICATION REQUIREMENTS\n- Required commands: npm run typecheck, npm run lint, npm run test\n- Required artifacts: all updated test files, updated package.json","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.8","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"in_progress","target":"","timeout_ns":0,"title":"v5: tests update","updated_at":"2026-03-04T03:09:01Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"23b0e7c666f24e9e8b9e6cd12e4383ff6cef36e96c790d46b729ee81a860a190","created_at":"2026-03-04T01:37:55Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Bead ID: beadboard-maf.9\n- Parent/Epic: beadboard-maf\n- Dependencies: beadboard-maf.6 (bb mail commands must be finalized)\n\nTASK CONTRACT\n- Goal: Update project.template.md to include bb mail configuration, agent heartbeat policy, and swarm template field so agents filling it out get complete env-specific guidance.\n- Success Criteria:\n - bb mail configuration section added: bd config set mail.delegate 'bb mail', BD_ACTOR env var\n - Agent heartbeat policy field added: how often to heartbeat in this project\n - Swarm template field added: which bd mol proto this project uses (if any)\n - Validation step noted: ensure-bb-mail-configured.mjs and session-preflight.mjs should both pass before work\n - Blank template still has useful prompts for each field (not just empty lines)\n- Scope:\n - skills/beadboard-driver/project.template.md update\n- Out of Scope:\n - Creating actual project.md for any specific project\n\nIMPLEMENTATION CONSTRAINTS\n- Keep the template fillable by a human or agent in one sitting\n- Do not add so many fields that it becomes a burden to complete\n\nVERIFICATION REQUIREMENTS\n- Required commands: None (doc task)\n- Required artifacts: updated skills/beadboard-driver/project.template.md","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf.9","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"v5: project.template.md update","updated_at":"2026-03-04T01:37:55Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"Given a multi-param URL update, when the code is reviewed, then it must use a single buildUrlParams then router.push call, not sequential setX() calls.","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Ratified canonical memory","closed_at":"2026-03-02T02:28:25Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"3b834ed2860e79b1560932a39726c0e89b1830b64e4c1684115aeb8cc2897f54","created_at":"2026-03-02T02:28:17Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"Scope: Any code that updates multiple URL search params (view, taskId, assignMode, graphTab, etc.) in sequence. Out of Scope: Single-param updates. Rule: Never call multiple sequential setX() functions that each rebuild the URL from the same stale searchParams snapshot. Instead, use a single buildUrlParams() call to construct all params atomically, then one router.push(). Rationale: Each setX() reads the current searchParams at call time; if two run in the same tick, the second overwrites the first changes. Failure Mode: Params silently dropped, e.g. view changes but taskId reverts to previous value.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-mdo","is_template":0,"issue_type":"decision","last_activity":null,"metadata":"{\"domain\":\"memory-arch\",\"effective_date\":\"2026-03-02\",\"evidence_ids\":\"beadboard-y8k\",\"memory_strength\":\"hard\",\"memory_version\":1,\"owner\":\"team\",\"plan_refs\":\"\",\"superseded_by\":null,\"supersedes\":null}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"[MEMORY][ARCH][HARD] Atomic URL param updates to avoid stale closure races","updated_at":"2026-03-02T02:28:25Z","waiters":"","wisp_type":"","work_type":""}
{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"all steps complete","closed_at":"2026-03-03T05:58:02Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"1a878a6b4232da5118ec1b3debc7a4a99197e65dfdd956fe55cab2eea5e0ad9a","created_at":"2026-03-03T05:45:26Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\\n- Goal: make status backend diagnostics explicit and unambiguous.\\n\\nTASK CONTRACT\\n- Success Criteria:\\n - status text distinguishes sqlite legacy/migrated and dolt backend presence\\n - status json includes structured backend diagnostics\\n- Scope:\\n - install/beadboard.mjs status payload + rendering\\n - status tests updates\\n- Out of Scope:\\n - backend migration logic changes\\n\\nVERIFICATION REQUIREMENTS\\n- npm run typecheck\\n- npm run lint\\n- npm run test","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-mmd","is_template":0,"issue_type":"epic","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":1,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"[EPIC] Status Backend Clarity","updated_at":"2026-03-03T05:58:02Z","waiters":"","wisp_type":"","work_type":""}

1
.beads/backup/labels.jsonl
View file

@ -348,6 +348,7 @@
{"issue_id":"bb-lvl","label":"realtime"}
{"issue_id":"bb-lvl","label":"sse"}
{"issue_id":"bb-lvl","label":"status"}
{"issue_id":"bb-maf8-1772593966-a","label":"gt:agent"}
{"issue_id":"bb-n7p","label":"kanban"}
{"issue_id":"bb-n7p","label":"status"}
{"issue_id":"bb-n7p","label":"swimlane"}