diff --git a/.beads/backup/backup_state.json b/.beads/backup/backup_state.json index f2eb9e6..abd606f 100644 --- a/.beads/backup/backup_state.json +++ b/.beads/backup/backup_state.json @@ -1,13 +1,13 @@ { - "last_dolt_commit": "10mnnfqfva3v2b69iquoc1hb8op0ibb5", + "last_dolt_commit": "lqi577vskr9jp26jp5gstdg2e5k4tnr5", "last_event_id": 0, - "timestamp": "2026-03-04T02:41:26.846391633Z", + "timestamp": "2026-03-04T02:56:28.171189335Z", "counts": { - "issues": 478, - "events": 962, + "issues": 480, + "events": 987, "comments": 14, "dependencies": 784, - "labels": 846, + "labels": 850, "config": 15 } } \ No newline at end of file diff --git a/.beads/backup/events.jsonl b/.beads/backup/events.jsonl index 9f031ab..7c54a95 100644 --- a/.beads/backup/events.jsonl +++ b/.beads/backup/events.jsonl @@ -960,3 +960,28 @@ {"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:35:41Z","event_type":"status_changed","id":1066,"issue_id":"beadboard-izs.4","new_value":"{\"assignee\":\"beadboard-2i2\",\"status\":\"in_progress\"}","old_value":"{\"id\":\"beadboard-izs.4\",\"title\":\"bb coord: frontend UI — agent mail inbox + reservation badges\",\"description\":\"## TASK CONTEXT\\nThe Social lens and Activity panel in UnifiedShell need to surface agent coordination state: unread message count per agent, HANDOFF/BLOCKED urgency badges, and active reservation scope labels. This makes BeadBoard the primary coordination dashboard for multi-agent sessions.\\n\\n## TASK CONTRACT\\n**Goal**: Add agent mail and reservation visibility to the Social and Activity views in the BeadBoard dashboard.\\n\\n**Success Criteria**:\\n- Agent cards in Social view show unread message count badge (fetched from /api/agents/mail)\\n- HANDOFF/BLOCKED messages show amber/red badge (urgent); INFO/DECISION show neutral\\n- Clicking badge shows inline message list with subject, body, category, state, from_agent\\n- Ack button on HANDOFF/BLOCKED messages (calls POST /api/agents/mail/ack)\\n- Activity panel shows recent coordination events (sends, acks) in telemetry feed\\n- Agent card shows active reservation scope as label (from /api/agents/reservations)\\n- npm run typecheck and npm run lint pass\\n\\n**Scope**:\\n- Update src/components/social/ (agent card or social-page.tsx)\\n- Update src/components/activity/activity-panel.tsx for coordination events\\n- Fetch from API routes created in izs.3\\n\\n**Out of Scope**:\\n- Composing new messages from UI (read/ack only in v1)\\n- SSE live push for mail — polling with SWR or manual refresh is fine\\n- New npm dependencies\\n\\n## IMPLEMENTATION CONSTRAINTS\\n- Use existing shadcn/ui primitives from components/ui/\\n- Follow Tailwind patterns from src/components/social/social-page.tsx\\n- AgentAvatar component at src/components/shared/agent-avatar.tsx is the anchor for badges\\n- Check CLAUDE.md: src/components/shared/unified-shell.tsx is the root layout — understand view structure before modifying\\n\\n## VERIFICATION REQUIREMENTS\\n- npm run typecheck \\u0026\\u0026 npm run lint pass\\n- Dev server: agent cards show message badge when unread messages exist in ~/.beadboard/agent/messages/\\n- HANDOFF category badge is visually distinct from INFO\",\"status\":\"open\",\"priority\":1,\"issue_type\":\"task\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:56:11Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T01:56:11Z\"}"} {"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:41:26Z","event_type":"updated","id":1067,"issue_id":"beadboard-izs.4","new_value":"{\"notes\":\"Implemented coordination UI in Social/Activity surfaces. Social: src/components/social/social-page.tsx now polls /api/agents/mail and /api/agents/reservations per visible agent, computes unread badges and reservation labels, and wires ack action via /api/agents/mail/ack. SocialCard: src/components/social/social-card.tsx now renders per-agent unread badges, reservation scope chips, inline message list (subject/body/category/state/from_agent), and Ack button for requires_ack categories. Activity: src/components/activity/activity-panel.tsx now augments telemetry with coordination events (coord_send/coord_ack derived from mail API) and displays reservation scope chips per agent card. Verification evidence: npm run typecheck (pass); npm run lint (exit 0, warnings only). Manual-browser verification not run in this session. Memory review: no new reusable memory.\"}","old_value":"{\"id\":\"beadboard-izs.4\",\"title\":\"bb coord: frontend UI — agent mail inbox + reservation badges\",\"description\":\"## TASK CONTEXT\\nThe Social lens and Activity panel in UnifiedShell need to surface agent coordination state: unread message count per agent, HANDOFF/BLOCKED urgency badges, and active reservation scope labels. This makes BeadBoard the primary coordination dashboard for multi-agent sessions.\\n\\n## TASK CONTRACT\\n**Goal**: Add agent mail and reservation visibility to the Social and Activity views in the BeadBoard dashboard.\\n\\n**Success Criteria**:\\n- Agent cards in Social view show unread message count badge (fetched from /api/agents/mail)\\n- HANDOFF/BLOCKED messages show amber/red badge (urgent); INFO/DECISION show neutral\\n- Clicking badge shows inline message list with subject, body, category, state, from_agent\\n- Ack button on HANDOFF/BLOCKED messages (calls POST /api/agents/mail/ack)\\n- Activity panel shows recent coordination events (sends, acks) in telemetry feed\\n- Agent card shows active reservation scope as label (from /api/agents/reservations)\\n- npm run typecheck and npm run lint pass\\n\\n**Scope**:\\n- Update src/components/social/ (agent card or social-page.tsx)\\n- Update src/components/activity/activity-panel.tsx for coordination events\\n- Fetch from API routes created in izs.3\\n\\n**Out of Scope**:\\n- Composing new messages from UI (read/ack only in v1)\\n- SSE live push for mail — polling with SWR or manual refresh is fine\\n- New npm dependencies\\n\\n## IMPLEMENTATION CONSTRAINTS\\n- Use existing shadcn/ui primitives from components/ui/\\n- Follow Tailwind patterns from src/components/social/social-page.tsx\\n- AgentAvatar component at src/components/shared/agent-avatar.tsx is the anchor for badges\\n- Check CLAUDE.md: src/components/shared/unified-shell.tsx is the root layout — understand view structure before modifying\\n\\n## VERIFICATION REQUIREMENTS\\n- npm run typecheck \\u0026\\u0026 npm run lint pass\\n- Dev server: agent cards show message badge when unread messages exist in ~/.beadboard/agent/messages/\\n- HANDOFF category badge is visually distinct from INFO\",\"status\":\"in_progress\",\"priority\":1,\"issue_type\":\"task\",\"assignee\":\"beadboard-2i2\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:56:11Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:35:42Z\"}"} {"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:41:26Z","event_type":"closed","id":1068,"issue_id":"beadboard-izs.4","new_value":"Added Social/Activity coordination badges, inline inbox visibility, ack actions, and reservation labels using new agent APIs.","old_value":""} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:42:12Z","event_type":"status_changed","id":1069,"issue_id":"beadboard-izs.6","new_value":"{\"assignee\":\"beadboard-2i2\",\"status\":\"in_progress\"}","old_value":"{\"id\":\"beadboard-izs.6\",\"title\":\"bb coord: tests — global CLI, API routes, mail contract\",\"description\":\"## TASK CONTEXT\\nThe global CLI (izs.2), API routes (izs.3, izs.4), and bd mail delegate (izs.5) all need contract tests. Tests must follow the existing Node.js native test runner with tsx loader pattern. All test files must be explicitly added to the test script in package.json.\\n\\n## TASK CONTRACT\\n**Goal**: Add tests covering the full coordination stack integration surfaces.\\n\\n**Success Criteria**:\\n- tests/lib/agent-mail.test.ts covers send/inbox/read/ack flows and broadcast routing\\n- tests/lib/agent-registry.test.ts covers register/show/list/activity-lease\\n- tests/lib/agent-reservations.test.ts covers reserve/release/status, conflict detection (active blocks, stale warns)\\n- tests/api/agents-mail.test.ts covers API route smoke tests (valid request, missing agent error)\\n- All 4 test files added to test script in package.json\\n- npm run test exits 0\\n\\n**Scope**:\\n- New test files in tests/lib/ and tests/api/\\n- package.json test script updated\\n\\n**Out of Scope**:\\n- Frontend component tests\\n- E2E browser tests\\n- Testing bd internals\\n\\n## IMPLEMENTATION CONSTRAINTS\\n- Tests use node:test native runner with tsx loader: node --import tsx --test \\u003cfile\\u003e\\n- No jest or vitest — native test runner only (existing pattern in tests/)\\n- Mock runBdCommand in registry tests (avoid requiring live bd process)\\n- Check tests/ directory for existing patterns before writing\\n\\n## VERIFICATION REQUIREMENTS\\n- npm run test exits 0\\n- All 4 new test files listed in package.json test script\\n- npm run typecheck passes on test files\",\"status\":\"open\",\"priority\":1,\"issue_type\":\"task\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:56:27Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T01:56:27Z\"}"} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:43:03Z","event_type":"created","id":1070,"issue_id":"bb-agent-ui-1","new_value":"","old_value":""} +{"actor":"ZenchantLive","comment":"Added label: gt:agent","created_at":"2026-03-03T18:43:03Z","event_type":"label_added","id":1071,"issue_id":"bb-agent-ui-1","new_value":null,"old_value":null} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:43:03Z","event_type":"updated","id":1072,"issue_id":"bb-agent-ui-1","new_value":"{\"agent_state\":\"idle\",\"last_activity\":\"2026-03-03T18:43:03.691965974-08:00\"}","old_value":"{\"id\":\"bb-agent-ui-1\",\"title\":\"Agent: bb-agent-ui-1\",\"status\":\"open\",\"priority\":0,\"issue_type\":\"task\",\"created_at\":\"2026-03-04T02:43:04Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:43:04Z\"}"} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:43:03Z","event_type":"updated","id":1073,"issue_id":"bb-agent-ui-1","new_value":"{\"title\":\"Agent: agent-ui-1\"}","old_value":"{\"id\":\"bb-agent-ui-1\",\"title\":\"Agent: bb-agent-ui-1\",\"status\":\"open\",\"priority\":0,\"issue_type\":\"task\",\"created_at\":\"2026-03-04T02:43:04Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:43:04Z\",\"agent_state\":\"idle\",\"last_activity\":\"2026-03-04T02:43:04Z\"}"} +{"actor":"ZenchantLive","comment":"Added label: gt:agent","created_at":"2026-03-03T18:43:03Z","event_type":"label_added","id":1074,"issue_id":"bb-agent-ui-1","new_value":null,"old_value":null} +{"actor":"ZenchantLive","comment":"Added label: role:ui","created_at":"2026-03-03T18:43:03Z","event_type":"label_added","id":1075,"issue_id":"bb-agent-ui-1","new_value":null,"old_value":null} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:43:04Z","event_type":"created","id":1076,"issue_id":"bb-agent-graph-1","new_value":"","old_value":""} +{"actor":"ZenchantLive","comment":"Added label: gt:agent","created_at":"2026-03-03T18:43:04Z","event_type":"label_added","id":1077,"issue_id":"bb-agent-graph-1","new_value":null,"old_value":null} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:43:04Z","event_type":"updated","id":1078,"issue_id":"bb-agent-graph-1","new_value":"{\"agent_state\":\"idle\",\"last_activity\":\"2026-03-03T18:43:04.973906337-08:00\"}","old_value":"{\"id\":\"bb-agent-graph-1\",\"title\":\"Agent: bb-agent-graph-1\",\"status\":\"open\",\"priority\":0,\"issue_type\":\"task\",\"created_at\":\"2026-03-04T02:43:05Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:43:05Z\"}"} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:43:05Z","event_type":"updated","id":1079,"issue_id":"bb-agent-graph-1","new_value":"{\"title\":\"Agent: agent-graph-1\"}","old_value":"{\"id\":\"bb-agent-graph-1\",\"title\":\"Agent: bb-agent-graph-1\",\"status\":\"open\",\"priority\":0,\"issue_type\":\"task\",\"created_at\":\"2026-03-04T02:43:05Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:43:05Z\",\"agent_state\":\"idle\",\"last_activity\":\"2026-03-04T02:43:05Z\"}"} +{"actor":"ZenchantLive","comment":"Added label: gt:agent","created_at":"2026-03-03T18:43:05Z","event_type":"label_added","id":1080,"issue_id":"bb-agent-graph-1","new_value":null,"old_value":null} +{"actor":"ZenchantLive","comment":"Added label: role:graph","created_at":"2026-03-03T18:43:05Z","event_type":"label_added","id":1081,"issue_id":"bb-agent-graph-1","new_value":null,"old_value":null} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:47:59Z","event_type":"updated","id":1082,"issue_id":"beadboard-izs.6","new_value":"{\"notes\":\"Expanded coordination tests and wired explicit test enumeration. Updated tests/lib/agent-registry.test.ts to cover register/show/list/activity-lease paths with backend-resilient assertions; updated tests/lib/agent-reservations.test.ts with active-owner conflict test; updated tests/api/agents-mail.test.ts with route smoke and error-shape checks including success status path for reservations; added tests/skills/beadboard-driver/bb-mail-shim.test.ts and registered it in package.json. Updated package.json test script to include tests/lib/agent-registry.test.ts, tests/api/agents-mail.test.ts, tests/skills/beadboard-driver/bb-mail-shim.test.ts. Verification evidence: node --import tsx --test tests/lib/agent-registry.test.ts tests/lib/agent-reservations.test.ts tests/api/agents-mail.test.ts tests/skills/beadboard-driver/bb-mail-shim.test.ts (16/16 pass); npm run typecheck (pass); npm run lint (exit 0, warnings only); npm run test (full suite pass). Memory review: no new reusable memory.\"}","old_value":"{\"id\":\"beadboard-izs.6\",\"title\":\"bb coord: tests — global CLI, API routes, mail contract\",\"description\":\"## TASK CONTEXT\\nThe global CLI (izs.2), API routes (izs.3, izs.4), and bd mail delegate (izs.5) all need contract tests. Tests must follow the existing Node.js native test runner with tsx loader pattern. All test files must be explicitly added to the test script in package.json.\\n\\n## TASK CONTRACT\\n**Goal**: Add tests covering the full coordination stack integration surfaces.\\n\\n**Success Criteria**:\\n- tests/lib/agent-mail.test.ts covers send/inbox/read/ack flows and broadcast routing\\n- tests/lib/agent-registry.test.ts covers register/show/list/activity-lease\\n- tests/lib/agent-reservations.test.ts covers reserve/release/status, conflict detection (active blocks, stale warns)\\n- tests/api/agents-mail.test.ts covers API route smoke tests (valid request, missing agent error)\\n- All 4 test files added to test script in package.json\\n- npm run test exits 0\\n\\n**Scope**:\\n- New test files in tests/lib/ and tests/api/\\n- package.json test script updated\\n\\n**Out of Scope**:\\n- Frontend component tests\\n- E2E browser tests\\n- Testing bd internals\\n\\n## IMPLEMENTATION CONSTRAINTS\\n- Tests use node:test native runner with tsx loader: node --import tsx --test \\u003cfile\\u003e\\n- No jest or vitest — native test runner only (existing pattern in tests/)\\n- Mock runBdCommand in registry tests (avoid requiring live bd process)\\n- Check tests/ directory for existing patterns before writing\\n\\n## VERIFICATION REQUIREMENTS\\n- npm run test exits 0\\n- All 4 new test files listed in package.json test script\\n- npm run typecheck passes on test files\",\"status\":\"in_progress\",\"priority\":1,\"issue_type\":\"task\",\"assignee\":\"beadboard-2i2\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T01:56:27Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:42:12Z\"}"} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:47:59Z","event_type":"closed","id":1083,"issue_id":"beadboard-izs.6","new_value":"Added and enumerated coordination integration tests across registry, reservations, API routes, and delegate shim with full gate verification.","old_value":""} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:48:20Z","event_type":"status_changed","id":1084,"issue_id":"beadboard-izs.7","new_value":"{\"assignee\":\"beadboard-2i2\",\"status\":\"in_progress\"}","old_value":"{\"id\":\"beadboard-izs.7\",\"title\":\"bb coord: agent coordination reference doc (for v5 skill)\",\"description\":\"## TASK CONTEXT\\nThe beadboard-driver v5 skill (beadboard-maf) needs a definitive reference document for the coordination system. The current coord-events-sessions-ack.md references deprecated bb agent commands and has no WHEN-to-use triggers. This doc becomes the source for maf.6 (comm system rewrite for v5).\\n\\n## TASK CONTRACT\\n**Goal**: Write a complete, accurate coordination system reference at .agents/skills/beadboard-driver/references/coordination-system.md.\\n\\n**Success Criteria**:\\n- Documents all bb agent commands with flags and examples (send, inbox, read, ack, register, list, show, activity-lease, reserve, release, status)\\n- Message state machine documented: unread → read → acked, with requires_ack: true for HANDOFF and BLOCKED\\n- WHEN-to-use trigger map covers at least 6 scenarios (task complete → HANDOFF, blocked → BLOCKED, FYI → INFO, async decision → DECISION, etc.)\\n- Inbox polling protocol: frequency recommendation + what to do with unacked required messages\\n- Reservation conflict resolution documented: active agent blocks, stale/evicted warns with --takeover-stale\\n- Worked example showing full HANDOFF flow from sender through recipient to ack\\n- bd mail delegate config documented (how to configure bb as the delegate)\\n\\n**Scope**:\\n- New file: .agents/skills/beadboard-driver/references/coordination-system.md\\n- May deprecate/replace coord-events-sessions-ack.md\\n\\n**Out of Scope**:\\n- SKILL.md update (maf.10)\\n- Memory, swarm, or lifecycle docs (separate maf tasks)\\n\\n## IMPLEMENTATION CONSTRAINTS\\n- Reference actual command flags from tools/bb.ts and src/lib/agent-mail.ts — not speculative\\n- Test examples against real command output where possible\\n\\n## VERIFICATION REQUIREMENTS\\n- File exists at .agents/skills/beadboard-driver/references/coordination-system.md\\n- All bb agent commands documented with at least one complete example\\n- WHEN-to-use trigger map covers at least 6 scenarios\",\"status\":\"open\",\"priority\":1,\"issue_type\":\"task\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T02:07:04Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:07:04Z\"}"} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:49:03Z","event_type":"updated","id":1085,"issue_id":"beadboard-izs.7","new_value":"{\"notes\":\"Added canonical coordination reference at skills/beadboard-driver/references/coordination-system.md (per user path clarification: skills folder, not .agents). Document includes all bb agent commands/flags with examples; message state machine and requires_ack semantics; WHEN-to-use trigger map (8 scenarios); inbox polling protocol; reservation conflict policy; full HANDOFF walkthrough; bd mail delegate setup to bb-mail-shim and missing-bb fallback behavior. Verification evidence: file existence confirmed; command coverage and trigger counts validated with rg checks. Memory review: no new reusable memory.\"}","old_value":"{\"id\":\"beadboard-izs.7\",\"title\":\"bb coord: agent coordination reference doc (for v5 skill)\",\"description\":\"## TASK CONTEXT\\nThe beadboard-driver v5 skill (beadboard-maf) needs a definitive reference document for the coordination system. The current coord-events-sessions-ack.md references deprecated bb agent commands and has no WHEN-to-use triggers. This doc becomes the source for maf.6 (comm system rewrite for v5).\\n\\n## TASK CONTRACT\\n**Goal**: Write a complete, accurate coordination system reference at .agents/skills/beadboard-driver/references/coordination-system.md.\\n\\n**Success Criteria**:\\n- Documents all bb agent commands with flags and examples (send, inbox, read, ack, register, list, show, activity-lease, reserve, release, status)\\n- Message state machine documented: unread → read → acked, with requires_ack: true for HANDOFF and BLOCKED\\n- WHEN-to-use trigger map covers at least 6 scenarios (task complete → HANDOFF, blocked → BLOCKED, FYI → INFO, async decision → DECISION, etc.)\\n- Inbox polling protocol: frequency recommendation + what to do with unacked required messages\\n- Reservation conflict resolution documented: active agent blocks, stale/evicted warns with --takeover-stale\\n- Worked example showing full HANDOFF flow from sender through recipient to ack\\n- bd mail delegate config documented (how to configure bb as the delegate)\\n\\n**Scope**:\\n- New file: .agents/skills/beadboard-driver/references/coordination-system.md\\n- May deprecate/replace coord-events-sessions-ack.md\\n\\n**Out of Scope**:\\n- SKILL.md update (maf.10)\\n- Memory, swarm, or lifecycle docs (separate maf tasks)\\n\\n## IMPLEMENTATION CONSTRAINTS\\n- Reference actual command flags from tools/bb.ts and src/lib/agent-mail.ts — not speculative\\n- Test examples against real command output where possible\\n\\n## VERIFICATION REQUIREMENTS\\n- File exists at .agents/skills/beadboard-driver/references/coordination-system.md\\n- All bb agent commands documented with at least one complete example\\n- WHEN-to-use trigger map covers at least 6 scenarios\",\"status\":\"in_progress\",\"priority\":1,\"issue_type\":\"task\",\"assignee\":\"beadboard-2i2\",\"owner\":\"jordanlive121@gmail.com\",\"created_at\":\"2026-03-04T02:07:04Z\",\"created_by\":\"ZenchantLive\",\"updated_at\":\"2026-03-04T02:48:21Z\"}"} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:49:04Z","event_type":"closed","id":1086,"issue_id":"beadboard-izs.7","new_value":"Published coordination-system reference doc for v5 skill with complete command/flow/delegate guidance.","old_value":""} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:49:04Z","event_type":"closed","id":1087,"issue_id":"beadboard-izs","new_value":"all steps complete","old_value":""} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:55:17Z","event_type":"status_changed","id":1088,"issue_id":"beadboard-maf.1","new_value":"{\"assignee\":\"beadboard-2i2\",\"status\":\"in_progress\"}","old_value":"{\"id\":\"beadboard-maf.1\",\"title\":\"v5: agent state + liveness reference doc (new)\",\"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\",\"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:55:49Z","event_type":"updated","id":1089,"issue_id":"beadboard-maf.1","new_value":"{\"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.\"}","old_value":"{\"id\":\"beadboard-maf.1\",\"title\":\"v5: agent state + liveness reference doc (new)\",\"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\",\"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:55:18Z\"}"} +{"actor":"ZenchantLive","comment":null,"created_at":"2026-03-03T18:55:49Z","event_type":"closed","id":1090,"issue_id":"beadboard-maf.1","new_value":"Added comprehensive agent state+liveness reference for cold agents with command-backed workflows.","old_value":""} +{"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":""} diff --git a/.beads/backup/issues.jsonl b/.beads/backup/issues.jsonl index 03424c7..0778275 100644 --- a/.beads/backup/issues.jsonl +++ b/.beads/backup/issues.jsonl @@ -59,6 +59,8 @@ {"acceptance_criteria":"Guardrail test fails on boundary violations and passes when write path uses bd bridge only.","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Added guardrail scanner and automated test to block direct writes to .beads/issues.jsonl.","closed_at":"2026-02-12T01:28:27Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"643b2a021ff3b901411389a423abac8f39d3a3f3b2eebd61c92ab6a6c1768cdc","created_at":"2026-02-12T01:11:47Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"Enforce read/write boundary by scanning source for forbidden direct file write patterns targeting Beads issue files.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-92d.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":0,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":".","source_system":"","spec_id":null,"status":"closed","target":"","timeout_ns":0,"title":"Add guardrail test preventing direct writes to .beads/issues.jsonl","updated_at":"2026-02-12T01:28:27Z","waiters":"","wisp_type":"","work_type":"mutex"} {"acceptance_criteria":"Reference only - see bb-1y7 for implementation task","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Architectural decision documented for future session reference. See bb-1y7 for implementation.","closed_at":"2026-02-14T20:25:39Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"7831452b29a31fbfd54ab5520367bb7e729f9316c9d6f315a02e81b5049e88ab","created_at":"2026-02-14T20:24:59Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"This bead documents the architectural decision made 2026-02-14 to consolidate agent identity from ~/.beadboard/agent/*.json to bd agent beads. This is a reference bead - see bb-1y7 for implementation.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-9p8","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"DECISION DATE: 2026-02-14\n\nFIRST PRINCIPLES ANALYSIS (using linus-beads-discipline skill):\n- Iron Law #1 Violation: Two agent registries exist\n 1. ~/.beadboard/agent/*.json (local, not git-synced)\n 2. bd agent beads (git-tracked, team-visible)\n- This violates Single Source of Truth\n\nDECISION: Consolidate identity/presence to bd agent beads\n\nWHAT CHANGES:\n- agent-registry.ts (321 lines) → bd CLI wrapper (~50 lines)\n- Agent identity stored in bd agent beads (git-tracked)\n- bb agent register/show/list → delegate to bd CLI\n\nWHAT STAYS CUSTOM (no bd equivalent):\n- agent-mail.ts (400 lines) - messaging system\n- agent-reservations.ts (491 lines) - path-based reservations\n- agent-sessions.ts (265 lines) - aggregation layer\n\nBENEFITS:\n- Agents git-tracked (survive bd sync/compaction)\n- Team-visible agents (bd sync)\n- bd query on agents\n- Single source of truth\n\nDEPENDENCIES:\n- Blocked by bb-u6f.6 (Protocol Track 6 completion)\n- Implementation in bb-1y7\n\nBUG FIX ALONG THE WAY:\n- bb-79b: Fixed scope normalization in releaseAgentReservation\n\nUI IMPACT: ZERO\n- AgentRecord type stays the same\n- Sessions UI consumes same interface\n- deriveLiveness() maps from bd agent state","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":0,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":".","source_system":"","spec_id":null,"status":"closed","target":"","timeout_ns":0,"title":"ARCHITECTURAL DECISION: Agent Identity Consolidation","updated_at":"2026-02-14T20:25:39Z","waiters":"","wisp_type":"","work_type":"mutex"} {"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"cleanup temp test issue","closed_at":"2026-02-12T01:10:10Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"9e10759032d8fa05a552201b208a197ca7e0a89c3f6f69687268ba5ae87872e2","created_at":"2026-02-12T01:10:05Z","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-ag8","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":4,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":".","source_system":"","spec_id":null,"status":"closed","target":"","timeout_ns":0,"title":"TEMP_DELETE_ME","updated_at":"2026-02-12T01:10:10Z","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":"8f27887520d573f295f13d21efe8ea31d44835153985bf20766169705ae89d8f","created_at":"2026-03-04T02:43:05Z","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-agent-graph-1","is_template":0,"issue_type":"task","last_activity":"2026-03-04T02:43:05Z","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: agent-graph-1","updated_at":"2026-03-04T02:43:05Z","waiters":"","wisp_type":"","work_type":""} +{"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":"b77618a3877aa30b2fc86247030f56e77cb6623739343f4e18374c81f3a36dcd","created_at":"2026-03-04T02:43: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-agent-ui-1","is_template":0,"issue_type":"task","last_activity":"2026-03-04T02:43:04Z","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: agent-ui-1","updated_at":"2026-03-04T02:43:04Z","waiters":"","wisp_type":"","work_type":""} {"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"cleanup writeback smoke","closed_at":"2026-02-12T03:58:29Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"a9b81e11755c85c2326e9e0842f55d50e1cdd0ca7125b5e741dd7a64227cb6b0","created_at":"2026-02-12T03:58:24Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"Temp for optimistic and transition smoke","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-atl","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":3,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":".","source_system":"","spec_id":null,"status":"closed","target":"","timeout_ns":0,"title":"Writeback phase smoke","updated_at":"2026-02-12T03:58:29Z","waiters":"","wisp_type":"","work_type":"mutex"} {"acceptance_criteria":"Global tokens in place; cards/panels use consistent visual hierarchy; graph relationships are visually legible; responsive screenshots at 390/768/1440 pass; typecheck/tests pass.","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Aero Chrome UI polish epic complete with validated kanban + graph surfaces and evidence-backed closeout.","closed_at":"2026-02-13T20:01:44Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"940ee90547ea5387407d5e267d66718815644d0494287d8898fbeba9a0e1b292","created_at":"2026-02-13T17:54:32Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"Objective: apply a cohesive volumetric visual system across Workflow Explorer surfaces (kanban + graph) while preserving all existing data/model behavior. Scope: CSS/tailwind class refactor, typography hierarchy, status lighting, graph legibility and responsive containment. Non-goals: no state model changes, no API changes, no write-path changes.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-b4j","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":"Workspace UI polish: Aero Chrome visual system","updated_at":"2026-02-13T20:01:44Z","waiters":"","wisp_type":"","work_type":"mutex"} {"acceptance_criteria":"- Global CSS tokens for surface/elevation/status lighting are defined and documented in code comments.\\n- next/font integration for Plus Jakarta Sans + JetBrains Mono is active.\\n- Anti-banding layers are present and subtle (no heavy grain, no readability loss).\\n- No logic changes in lib/* or API routes.\\n- Verification commands for this bead: npm run typecheck.","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Foundation complete: semantic typography rollout, matte/anti-banding/elevation primitives, controls/scrollbar baseline, and verification evidence including tests/typecheck/screenshots.","closed_at":"2026-02-13T19:19:10Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"a3abb7f02cb6c471a571fd57ebf54cce150cc6023637d930d6dee9cf8a2a0a81","created_at":"2026-02-13T18:09:54Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"Objective: establish app-wide visual primitives that mirror the Aero Chrome mockup while preserving all runtime behavior.\\n\\nScope:\\n- Define global design tokens for matte surfaces, chrome edges, volumetric shadows, and ambient status glows.\\n- Roll out semantic typography pairing across the app shell: Plus Jakarta Sans for UI text and JetBrains Mono for system metadata.\\n- Add anti-banding background treatment (subtle grid + noise texture) to reduce flat dark-surface artifacts.\\n- Standardize global scrollbar baseline and form-control visual defaults for dark surfaces.\\n\\nOut of scope:\\n- No API, state, graph algorithm, or mutation behavior changes.\\n- No data model/schema changes.\\n\\nFiles expected:\\n- src/app/layout.tsx\\n- src/app/globals.css\\n\\nRisk controls:\\n- Keep class and token names stable and reusable for Kanban + Graph migration beads.\\n- Avoid over-aggressive global selectors that could break existing component spacing/layout.\\n\\nDefinition of done:\\n- Global token set exists and is consumed by downstream surface beads.\\n- Typography and anti-banding are visible and consistent at / and /graph.\\n- No behavioral regressions introduced.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"bb-b4j.1","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Session active: claimed and executing now. Parallel support agent assigned to UI inventory only (no edits).\nReviewed parallel-agent shared-component edits: src/components/shared/chip.tsx, src/components/shared/project-scope-controls.tsx, src/components/shared/stat-pill.tsx. Outcome: style-only changes, no logic/data-path changes, accepted. Verification evidence: npm run typecheck (pass); npm run test (full suite pass) including guards and parser/graph/kanban libs.","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":"Global visual foundation: tokens, typography, anti-banding","updated_at":"2026-02-13T19:19:10Z","waiters":"","wisp_type":"","work_type":"mutex"} @@ -395,14 +397,14 @@ {"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-frf","await_id":"","await_type":"","close_reason":"Global-vs-local project context behavior clarified and implemented via template+ensure workflow.","closed_at":"2026-03-02T22:52:32Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"bac42d51bcaa19c4dfbc5d2e3b98a2e26dd7720afc483ffff4b13c420ae5d4dc","created_at":"2026-03-02T22:00:44Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\\n- Bead ID: beadboard-c70.2\\n- Parent: beadboard-c70\\n- Dependencies: beadboard-c70.1\\n\\nTASK CONTRACT\\n- Goal: Make project template usage clear for global vs repo-local skill installs.\\n- Success Criteria:\\n - SKILL.md explains project template as source template and optional target-repo copy\\n - scripts optionally support external project context file path (if needed)\\n- Scope:\\n - docs + contract tests\\n- Out of Scope:\\n - UI integration changes\\n\\nVERIFICATION REQUIREMENTS\\n- Required commands: npm run typecheck, npm run lint, npm run test","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-i0q","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Implemented global-skill project context contract: removed in-skill project.md runtime file, added skills/beadboard-driver/project.template.md as template source, added scripts/ensure-project-context.mjs to create \u003ctarget-repo\u003e/project.md only when missing, and updated SKILL.md + command matrix accordingly. Added contract test skills/beadboard-driver/tests/ensure-project-context.contract.test.mjs and wired into run-tests.mjs. Verification: node skills/beadboard-driver/tests/run-tests.mjs (pass, 10 tests), npm run typecheck (pass), npm run lint (0 errors, 22 warnings).","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":"Global skill project-context contract (project.md optional path model)","updated_at":"2026-03-02T22:52:32Z","waiters":"","wisp_type":"","work_type":""} {"acceptance_criteria":"All existing canonical memory nodes have source bead relations and evidence_ids/plan_refs metadata; help docs require provenance capture.","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Canonical memory provenance linked to historical beads and help/memory updated","closed_at":"2026-03-02T00:54:56Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"dca0bf2efdbf8f386504ed0c7473105b39e0471986abd0f6ea621aac7d191504","created_at":"2026-03-02T00:53:19Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"Strengthen memory retrieval for fresh agents by relating canonical memory nodes to source closed beads/plans and adding explicit evidence metadata fields.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-i4c","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Completed provenance upgrade: all 7 canonical memory beads now link to source closed beads and include metadata keys evidence_ids + plan_refs. Updated help/memory docs to require provenance capture and provenance checks in task-start workflow.","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":"Add provenance links and evidence metadata to canonical memory nodes","updated_at":"2026-03-02T00:54:56Z","waiters":"","wisp_type":"","work_type":""} {"acceptance_criteria":"Both manuals include mandatory post-close memory review cadence and provenance relation commands/requirements.","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"AGENTS manuals now enforce regular memory additions and provenance relations","closed_at":"2026-03-02T00:57:15Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"94801679101f97c806f8bada08cbf366d258173ce388dafbb4135a3bfec22b49","created_at":"2026-03-02T00:56:31Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"Update root and beadboard AGENTS manuals to require recurring memory additions and explicit provenance relation/metadata rules for canonical memory nodes.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-ij8","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Updated both AGENTS manuals: added mandatory post-close memory review cadence, provenance relation commands, required evidence_ids/plan_refs metadata, and fresh-agent provenance validation steps.","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":"Enforce regular memory contribution + provenance relations in AGENTS manuals","updated_at":"2026-03-02T00:57:15Z","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":"1b262c4bd3f927c6370591d77349349c31649e7299eaef08ece93abbdad0ca1b","created_at":"2026-03-04T01:29:11Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## EPIC CONTEXT\ntools/bb.ts inside BeadBoard already implements a full bb agent coordination CLI (register, list, show, activity-lease, send, inbox, read, ack, reserve, release, status) backed by src/lib/agent-mail.ts, src/lib/agent-registry.ts, and src/lib/agent-reservations.ts. External agents cannot access this — it's internal to the BeadBoard repo. The global bb npm CLI (beadboard-cli.ts) only has start/open/status/doctor/uninstall.\n\n## EPIC GOAL\nExpose the existing coordination stack to: (1) external agents via the global bb CLI, (2) the BeadBoard frontend dashboard, and (3) bd mail delegate routing.\n\n## SCOPE\n- Wire bb agent commands into beadboard-cli.ts (global npm install)\n- Add /api/agents/mail and /api/agents/reservations Next.js routes\n- Add agent mail UI to Social/Activity views (inbox badge, HANDOFF/BLOCKED display)\n- Configure bd mail to delegate to bb\n- Tests + reference doc for v5 skill\n\n## OUT OF SCOPE\n- Rebuilding the coordination libs (already done)\n- SSE live updates for mail (polling sufficient for v1)\n- Sending messages from the UI (read/ack only in v1)","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-izs","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":"open","target":"","timeout_ns":0,"title":"[EPIC] bb mail: BeadBoard-native coordination messaging","updated_at":"2026-03-04T01:54:06Z","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-04T02:49:05Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"1b262c4bd3f927c6370591d77349349c31649e7299eaef08ece93abbdad0ca1b","created_at":"2026-03-04T01:29:11Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## EPIC CONTEXT\ntools/bb.ts inside BeadBoard already implements a full bb agent coordination CLI (register, list, show, activity-lease, send, inbox, read, ack, reserve, release, status) backed by src/lib/agent-mail.ts, src/lib/agent-registry.ts, and src/lib/agent-reservations.ts. External agents cannot access this — it's internal to the BeadBoard repo. The global bb npm CLI (beadboard-cli.ts) only has start/open/status/doctor/uninstall.\n\n## EPIC GOAL\nExpose the existing coordination stack to: (1) external agents via the global bb CLI, (2) the BeadBoard frontend dashboard, and (3) bd mail delegate routing.\n\n## SCOPE\n- Wire bb agent commands into beadboard-cli.ts (global npm install)\n- Add /api/agents/mail and /api/agents/reservations Next.js routes\n- Add agent mail UI to Social/Activity views (inbox badge, HANDOFF/BLOCKED display)\n- Configure bd mail to delegate to bb\n- Tests + reference doc for v5 skill\n\n## OUT OF SCOPE\n- Rebuilding the coordination libs (already done)\n- SSE live updates for mail (polling sufficient for v1)\n- Sending messages from the UI (read/ack only in v1)","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-izs","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] bb mail: BeadBoard-native coordination messaging","updated_at":"2026-03-04T02:49:05Z","waiters":"","wisp_type":"","work_type":""} {"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Completed read-only audit of 5 coordination source files and published integration contract on beadboard-izs.","closed_at":"2026-03-04T02:15:27Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"052be552d5e1dcdc7fe3cbde75be3081e96dcad41d927f896f9e3de1098fb9b7","created_at":"2026-03-04T01:55:58Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## TASK CONTEXT\ntools/bb.ts + src/lib/agent-mail.ts + agent-registry.ts + agent-reservations.ts + beadboard-cli.ts are the five source files that define what exists and what needs to be wired. Before writing any code, we need a precise integration map so izs.2 (global CLI), izs.3 (API routes), and izs.5 (bd mail delegate) all build toward the same contract.\n\n## TASK CONTRACT\n**Goal**: Produce an integration map documenting the existing coordination stack and specifying what each downstream izs task must build.\n\n**Success Criteria**:\n- All 5 source files read and annotated\n- Storage paths confirmed: mail JSONL at ~/.beadboard/agent/messages/, reservations at ~/.beadboard/agent/reservations/active.json\n- beadboard-cli.ts CLI framework identified (commander, minimist, etc.) and entry point documented\n- API route contract written for /api/agents/mail and /api/agents/reservations (endpoints, request/response shape)\n- Platform issues identified (Windows USERPROFILE vs Linux HOME path handling)\n- Findings posted as bd comment on beadboard-izs\n\n**Scope**:\n- Read-only investigation of 5 source files\n- Write audit findings as bd comment\n\n**Out of Scope**:\n- Any code changes\n- Frontend or CLI implementation\n\n## IMPLEMENTATION CONSTRAINTS\n- Source files: tools/bb.ts, src/lib/agent-mail.ts, src/lib/agent-registry.ts, src/lib/agent-reservations.ts, beadboard-cli.ts (find in project root)\n\n## VERIFICATION REQUIREMENTS\n- bd comments list beadboard-izs shows audit findings comment\n- API contract covers all CRUD operations for mail and reservations","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-izs.1","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Audit completed. Evidence: read tools/bb.ts, src/lib/agent-mail.ts, src/lib/agent-registry.ts, src/lib/agent-reservations.ts, src/cli/beadboard-cli.ts; posted integration contract comment to beadboard-izs via bd comments add beadboard-izs -f /tmp/beadboard-izs1-audit.md; verified via bd comments beadboard-izs --json. 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":"bb coord: audit existing stack + define integration contract","updated_at":"2026-03-04T02:15:27Z","waiters":"","wisp_type":"","work_type":""} {"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Already implemented — global bb CLI at /home/zenchant/.npm-global/bin/bb already exposes full bb agent command surface (register/list/show/activity-lease/send/inbox/read/ack/reserve/release/status). Verified via bb agent --help and live end-to-end test.","closed_at":"2026-03-04T02:26:25Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"9a1170c2d43e676a6dd191c71cada70c7502cc0a8cb66be18e6bde54dc9a04a9","created_at":"2026-03-04T01:56:04Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## TASK CONTEXT\nThe global bb npm CLI (beadboard-cli.ts) only handles start/open/status/doctor/self-update/uninstall. External agents (in any repo) need bb agent send/inbox/read/ack/register/list/show/activity-lease/reserve/release/status. The full implementation is in src/lib/agent-*.ts. This task ports the agent subcommand from tools/bb.ts into beadboard-cli.ts.\n\n## TASK CONTRACT\n**Goal**: Expose the full bb agent command surface through the globally-installed bb CLI.\n\n**Success Criteria**:\n- bb agent register --name foo --role ui works from any directory\n- bb agent send --from foo --to bar --bead x --category INFO --subject y --body z works\n- bb agent inbox --agent foo lists messages\n- bb agent read --agent foo --message m marks as read\n- bb agent ack --agent foo --message m acknowledges\n- bb agent reserve/release/status work\n- bb agent activity-lease --agent foo works\n- Human-readable output by default, JSON with --json flag\n- npm run build passes\n\n**Scope**:\n- Modify beadboard-cli.ts to add bb agent subcommand\n- Import src/lib/agent-mail.ts, agent-registry.ts, agent-reservations.ts\n- Port command routing and printResponse formatting from tools/bb.ts\n\n**Out of Scope**:\n- Changes to the lib implementations\n- Frontend routes\n\n## IMPLEMENTATION CONSTRAINTS\n- Use the audit from izs.1 to understand beadboard-cli.ts structure before modifying\n- Port tools/bb.ts agent command routing exactly — do not redesign the API surface\n- Must work on Windows, WSL, and Linux\n\n## VERIFICATION REQUIREMENTS\n- npm run build or equivalent passes\n- bb agent list returns empty list (no crash) from a fresh test run\n- bb agent register --name test-coord --role test succeeds then bb agent show --agent test-coord returns record","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-izs.2","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Implemented bb agent subcommand routing in src/cli/beadboard-cli.ts (ported tools/bb.ts command surface and response formatting). Added CLI contract test in tests/cli/beadboard-cli.test.ts. Verification evidence: node --import tsx --test tests/cli/beadboard-cli.test.ts tests/cli/beadboard-help-output.test.ts tests/cli/beadboard-bin-routing.test.ts (pass, 7/7); node bin/beadboard.js agent list --json (ok true, command=agent list); node bin/beadboard.js agent register --name test-coord-izs2 --role test --json (ok true); node bin/beadboard.js agent show --agent test-coord-izs2 --json (ok true); npm run lint (exit 0, warnings only). 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":"bb coord: wire bb agent commands into global bb CLI","updated_at":"2026-03-04T02:26:25Z","waiters":"","wisp_type":"","work_type":""} {"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Added /api/agents/mail and /api/agents/reservations routes with read/ack compatibility endpoints and validated response contracts.","closed_at":"2026-03-04T02:31:59Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"26361ef03699fb50f4b3ec4a6269381921bfe3929fff8dcbd89c010533ab56dd","created_at":"2026-03-04T01:56:10Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## TASK CONTEXT\nBeadBoard's dashboard needs to display agent coordination data. The libs in src/lib/agent-*.ts have all the business logic; they just need Next.js API routes to expose them to the browser. The API contract is defined in izs.1.\n\n## TASK CONTRACT\n**Goal**: Create Next.js API routes for agent mail and reservations that the frontend can call.\n\n**Success Criteria**:\n- GET /api/agents/mail?agent=\u003cid\u003e\u0026state=\u003cunread|read|acked\u003e returns inbox messages\n- POST /api/agents/mail body {from, to, bead, category, subject, body, thread?} creates message\n- POST /api/agents/mail/read body {agent, message} marks as read\n- POST /api/agents/mail/ack body {agent, message} acknowledges message\n- GET /api/agents/reservations?agent=\u003cid\u003e returns active reservations + unacked_required_messages\n- Error shape matches existing routes: {ok: false, error: {code, message}}\n- npm run typecheck passes\n\n**Scope**:\n- New files: src/app/api/agents/mail/route.ts, src/app/api/agents/reservations/route.ts\n- Import and call src/lib/agent-mail.ts and src/lib/agent-reservations.ts functions\n\n**Out of Scope**:\n- Frontend UI (izs.4)\n- SSE streaming for mail\n- Auth beyond existing patterns in the codebase\n\n## IMPLEMENTATION CONSTRAINTS\n- Read existing routes in src/app/api/beads/ and src/app/api/agents/ for patterns before writing\n- Use NextResponse for all responses\n- Check izs.1 audit for confirmed API contract before implementing\n\n## VERIFICATION REQUIREMENTS\n- npm run typecheck clean\n- curl localhost:3000/api/agents/mail?agent=nonexistent returns {ok: false, error: {code: \"AGENT_NOT_FOUND\", ...}}\n- npm run lint clean","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-izs.3","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Implemented agent coordination API routes: src/app/api/agents/mail/route.ts and src/app/api/agents/reservations/route.ts with NextResponse JSON envelopes and normalized error shape {ok:false,error:{code,message}}. Added compatibility endpoints src/app/api/agents/mail/read/route.ts and src/app/api/agents/mail/ack/route.ts. Added route contract tests in tests/api/agents-mail.test.ts (missing-agent and validation flows). Verification evidence: node --import tsx --test tests/api/agents-mail.test.ts (4/4 pass); npm run typecheck (pass); npm run lint (exit 0, warnings only). 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":"bb coord: frontend API routes (/api/agents/mail + /api/agents/reservations)","updated_at":"2026-03-04T02:31:59Z","waiters":"","wisp_type":"","work_type":""} {"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Added Social/Activity coordination badges, inline inbox visibility, ack actions, and reservation labels using new agent APIs.","closed_at":"2026-03-04T02:41:26Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"4d88b4fe5ac8af2c38c83406b2fe0f636c85d08be3c39e737ef3ef44194b6c1c","created_at":"2026-03-04T01:56:11Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## TASK CONTEXT\nThe Social lens and Activity panel in UnifiedShell need to surface agent coordination state: unread message count per agent, HANDOFF/BLOCKED urgency badges, and active reservation scope labels. This makes BeadBoard the primary coordination dashboard for multi-agent sessions.\n\n## TASK CONTRACT\n**Goal**: Add agent mail and reservation visibility to the Social and Activity views in the BeadBoard dashboard.\n\n**Success Criteria**:\n- Agent cards in Social view show unread message count badge (fetched from /api/agents/mail)\n- HANDOFF/BLOCKED messages show amber/red badge (urgent); INFO/DECISION show neutral\n- Clicking badge shows inline message list with subject, body, category, state, from_agent\n- Ack button on HANDOFF/BLOCKED messages (calls POST /api/agents/mail/ack)\n- Activity panel shows recent coordination events (sends, acks) in telemetry feed\n- Agent card shows active reservation scope as label (from /api/agents/reservations)\n- npm run typecheck and npm run lint pass\n\n**Scope**:\n- Update src/components/social/ (agent card or social-page.tsx)\n- Update src/components/activity/activity-panel.tsx for coordination events\n- Fetch from API routes created in izs.3\n\n**Out of Scope**:\n- Composing new messages from UI (read/ack only in v1)\n- SSE live push for mail — polling with SWR or manual refresh is fine\n- New npm dependencies\n\n## IMPLEMENTATION CONSTRAINTS\n- Use existing shadcn/ui primitives from components/ui/\n- Follow Tailwind patterns from src/components/social/social-page.tsx\n- AgentAvatar component at src/components/shared/agent-avatar.tsx is the anchor for badges\n- Check CLAUDE.md: src/components/shared/unified-shell.tsx is the root layout — understand view structure before modifying\n\n## VERIFICATION REQUIREMENTS\n- npm run typecheck \u0026\u0026 npm run lint pass\n- Dev server: agent cards show message badge when unread messages exist in ~/.beadboard/agent/messages/\n- HANDOFF category badge is visually distinct from INFO","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-izs.4","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Implemented coordination UI in Social/Activity surfaces. Social: src/components/social/social-page.tsx now polls /api/agents/mail and /api/agents/reservations per visible agent, computes unread badges and reservation labels, and wires ack action via /api/agents/mail/ack. SocialCard: src/components/social/social-card.tsx now renders per-agent unread badges, reservation scope chips, inline message list (subject/body/category/state/from_agent), and Ack button for requires_ack categories. Activity: src/components/activity/activity-panel.tsx now augments telemetry with coordination events (coord_send/coord_ack derived from mail API) and displays reservation scope chips per agent card. Verification evidence: npm run typecheck (pass); npm run lint (exit 0, warnings only). Manual-browser verification not run in this session. 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":"bb coord: frontend UI — agent mail inbox + reservation badges","updated_at":"2026-03-04T02:41:26Z","waiters":"","wisp_type":"","work_type":""} {"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Configured bd mail delegate via session preflight and added bb mail shim with verified routing and fallback error behavior.","closed_at":"2026-03-04T02:35:22Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"07c84845729d6316e7d30d9caed5c03c0465ac8d97a1d31f2a8f71d2d14eb1c7","created_at":"2026-03-04T01:56:13Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## TASK CONTEXT\nbd mail is designed as a delegate — it shells out to a configured external provider via BEADS_MAIL_DELEGATE env var or bd config set mail.delegate. The bb CLI (now with bb agent send/inbox via izs.2) is the natural delegate for BeadBoard environments. This task wires bd mail → bb agent so agents using bd mail transparently use the BeadBoard coordination stack.\n\n## TASK CONTRACT\n**Goal**: Configure bd mail to delegate to bb agent commands so the session-preflight script automatically sets up mail routing.\n\n**Success Criteria**:\n- bd config set mail.delegate bb (or equivalent) documented and working\n- .agents/skills/beadboard-driver/scripts/session-preflight.mjs runs the delegate config command on startup\n- bd mail send --to foo --bead x --subject y --body z routes through bb agent send\n- Fallback: if bb not installed, bd mail fails with helpful error (not silent failure)\n- help/cli/bd_help.txt mail section read and delegate mechanism confirmed before implementing\n\n**Scope**:\n- Update session-preflight.mjs to configure bd mail delegate\n- Read help/cli/bd_help.txt to confirm exact bd mail delegate config syntax\n- Document delegate config in bd comment on izs.5\n\n**Out of Scope**:\n- Changes to bd internals\n- Building an alternate mail system\n- project.template.md update (tracked in maf.9)\n\n## IMPLEMENTATION CONSTRAINTS\n- Read help/cli/bd_help.txt mail section BEFORE configuring — do not assume flag names\n- Check BEADS_MAIL_DELEGATE env var as alternative to bd config\n\n## VERIFICATION REQUIREMENTS\n- node scripts/session-preflight.mjs completes without error\n- bd mail send routes to bb after preflight runs\n- bd mail without bb installed produces useful error","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-izs.5","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Implemented delegate wiring in skills/beadboard-driver/scripts/session-preflight.mjs and added skills/beadboard-driver/scripts/bb-mail-shim.mjs translating bd mail inbox/send/read/ack into bb agent commands. Added tests: tests/skills/beadboard-driver/session-preflight.test.ts and tests/skills/beadboard-driver/bb-mail-shim.test.ts. Verification evidence: node --import tsx --test tests/skills/beadboard-driver/session-preflight.test.ts tests/skills/beadboard-driver/bb-mail-shim.test.ts (3/3 pass); node skills/beadboard-driver/scripts/session-preflight.mjs (ok true, mail.configured=true); integration check with fake bb: bd mail inbox invoked bb args 'agent inbox --agent silver-scribe'; PATH=/usr/bin:/bin BB_AGENT=silver-scribe node skills/beadboard-driver/scripts/bb-mail-shim.mjs inbox -\u003e 'bb command not found in 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":"bb coord: bd mail delegate configuration + session-preflight wiring","updated_at":"2026-03-04T02:35:22Z","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":"e915b0b50b0e71eae96d15339a3a97e80211f3966a477898baf1059214910e87","created_at":"2026-03-04T01:56:27Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## TASK CONTEXT\nThe global CLI (izs.2), API routes (izs.3, izs.4), and bd mail delegate (izs.5) all need contract tests. Tests must follow the existing Node.js native test runner with tsx loader pattern. All test files must be explicitly added to the test script in package.json.\n\n## TASK CONTRACT\n**Goal**: Add tests covering the full coordination stack integration surfaces.\n\n**Success Criteria**:\n- tests/lib/agent-mail.test.ts covers send/inbox/read/ack flows and broadcast routing\n- tests/lib/agent-registry.test.ts covers register/show/list/activity-lease\n- tests/lib/agent-reservations.test.ts covers reserve/release/status, conflict detection (active blocks, stale warns)\n- tests/api/agents-mail.test.ts covers API route smoke tests (valid request, missing agent error)\n- All 4 test files added to test script in package.json\n- npm run test exits 0\n\n**Scope**:\n- New test files in tests/lib/ and tests/api/\n- package.json test script updated\n\n**Out of Scope**:\n- Frontend component tests\n- E2E browser tests\n- Testing bd internals\n\n## IMPLEMENTATION CONSTRAINTS\n- Tests use node:test native runner with tsx loader: node --import tsx --test \u003cfile\u003e\n- No jest or vitest — native test runner only (existing pattern in tests/)\n- Mock runBdCommand in registry tests (avoid requiring live bd process)\n- Check tests/ directory for existing patterns before writing\n\n## VERIFICATION REQUIREMENTS\n- npm run test exits 0\n- All 4 new test files listed in package.json test script\n- npm run typecheck passes on test files","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-izs.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":"bb coord: tests — global CLI, API routes, mail contract","updated_at":"2026-03-04T01: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":"cbf55514cdafc8d0b9f9bf01270efd003ffd6d7f8c36264fe2e81f689c4f06ad","created_at":"2026-03-04T02:07:04Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## TASK CONTEXT\nThe beadboard-driver v5 skill (beadboard-maf) needs a definitive reference document for the coordination system. The current coord-events-sessions-ack.md references deprecated bb agent commands and has no WHEN-to-use triggers. This doc becomes the source for maf.6 (comm system rewrite for v5).\n\n## TASK CONTRACT\n**Goal**: Write a complete, accurate coordination system reference at .agents/skills/beadboard-driver/references/coordination-system.md.\n\n**Success Criteria**:\n- Documents all bb agent commands with flags and examples (send, inbox, read, ack, register, list, show, activity-lease, reserve, release, status)\n- Message state machine documented: unread → read → acked, with requires_ack: true for HANDOFF and BLOCKED\n- WHEN-to-use trigger map covers at least 6 scenarios (task complete → HANDOFF, blocked → BLOCKED, FYI → INFO, async decision → DECISION, etc.)\n- Inbox polling protocol: frequency recommendation + what to do with unacked required messages\n- Reservation conflict resolution documented: active agent blocks, stale/evicted warns with --takeover-stale\n- Worked example showing full HANDOFF flow from sender through recipient to ack\n- bd mail delegate config documented (how to configure bb as the delegate)\n\n**Scope**:\n- New file: .agents/skills/beadboard-driver/references/coordination-system.md\n- May deprecate/replace coord-events-sessions-ack.md\n\n**Out of Scope**:\n- SKILL.md update (maf.10)\n- Memory, swarm, or lifecycle docs (separate maf tasks)\n\n## IMPLEMENTATION CONSTRAINTS\n- Reference actual command flags from tools/bb.ts and src/lib/agent-mail.ts — not speculative\n- Test examples against real command output where possible\n\n## VERIFICATION REQUIREMENTS\n- File exists at .agents/skills/beadboard-driver/references/coordination-system.md\n- All bb agent commands documented with at least one complete example\n- WHEN-to-use trigger map covers at least 6 scenarios","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-izs.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":"bb coord: agent coordination reference doc (for v5 skill)","updated_at":"2026-03-04T02:07:04Z","waiters":"","wisp_type":"","work_type":""} +{"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Added and enumerated coordination integration tests across registry, reservations, API routes, and delegate shim with full gate verification.","closed_at":"2026-03-04T02:48:00Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"e915b0b50b0e71eae96d15339a3a97e80211f3966a477898baf1059214910e87","created_at":"2026-03-04T01:56:27Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## TASK CONTEXT\nThe global CLI (izs.2), API routes (izs.3, izs.4), and bd mail delegate (izs.5) all need contract tests. Tests must follow the existing Node.js native test runner with tsx loader pattern. All test files must be explicitly added to the test script in package.json.\n\n## TASK CONTRACT\n**Goal**: Add tests covering the full coordination stack integration surfaces.\n\n**Success Criteria**:\n- tests/lib/agent-mail.test.ts covers send/inbox/read/ack flows and broadcast routing\n- tests/lib/agent-registry.test.ts covers register/show/list/activity-lease\n- tests/lib/agent-reservations.test.ts covers reserve/release/status, conflict detection (active blocks, stale warns)\n- tests/api/agents-mail.test.ts covers API route smoke tests (valid request, missing agent error)\n- All 4 test files added to test script in package.json\n- npm run test exits 0\n\n**Scope**:\n- New test files in tests/lib/ and tests/api/\n- package.json test script updated\n\n**Out of Scope**:\n- Frontend component tests\n- E2E browser tests\n- Testing bd internals\n\n## IMPLEMENTATION CONSTRAINTS\n- Tests use node:test native runner with tsx loader: node --import tsx --test \u003cfile\u003e\n- No jest or vitest — native test runner only (existing pattern in tests/)\n- Mock runBdCommand in registry tests (avoid requiring live bd process)\n- Check tests/ directory for existing patterns before writing\n\n## VERIFICATION REQUIREMENTS\n- npm run test exits 0\n- All 4 new test files listed in package.json test script\n- npm run typecheck passes on test files","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-izs.6","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Expanded coordination tests and wired explicit test enumeration. Updated tests/lib/agent-registry.test.ts to cover register/show/list/activity-lease paths with backend-resilient assertions; updated tests/lib/agent-reservations.test.ts with active-owner conflict test; updated tests/api/agents-mail.test.ts with route smoke and error-shape checks including success status path for reservations; added tests/skills/beadboard-driver/bb-mail-shim.test.ts and registered it in package.json. Updated package.json test script to include tests/lib/agent-registry.test.ts, tests/api/agents-mail.test.ts, tests/skills/beadboard-driver/bb-mail-shim.test.ts. Verification evidence: node --import tsx --test tests/lib/agent-registry.test.ts tests/lib/agent-reservations.test.ts tests/api/agents-mail.test.ts tests/skills/beadboard-driver/bb-mail-shim.test.ts (16/16 pass); npm run typecheck (pass); npm run lint (exit 0, warnings only); npm run test (full suite pass). 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":"bb coord: tests — global CLI, API routes, mail contract","updated_at":"2026-03-04T02:48:00Z","waiters":"","wisp_type":"","work_type":""} +{"acceptance_criteria":"","actor":"","agent_state":"","assignee":"beadboard-2i2","await_id":"","await_type":"","close_reason":"Published coordination-system reference doc for v5 skill with complete command/flow/delegate guidance.","closed_at":"2026-03-04T02:49:04Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"cbf55514cdafc8d0b9f9bf01270efd003ffd6d7f8c36264fe2e81f689c4f06ad","created_at":"2026-03-04T02:07:04Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"## TASK CONTEXT\nThe beadboard-driver v5 skill (beadboard-maf) needs a definitive reference document for the coordination system. The current coord-events-sessions-ack.md references deprecated bb agent commands and has no WHEN-to-use triggers. This doc becomes the source for maf.6 (comm system rewrite for v5).\n\n## TASK CONTRACT\n**Goal**: Write a complete, accurate coordination system reference at .agents/skills/beadboard-driver/references/coordination-system.md.\n\n**Success Criteria**:\n- Documents all bb agent commands with flags and examples (send, inbox, read, ack, register, list, show, activity-lease, reserve, release, status)\n- Message state machine documented: unread → read → acked, with requires_ack: true for HANDOFF and BLOCKED\n- WHEN-to-use trigger map covers at least 6 scenarios (task complete → HANDOFF, blocked → BLOCKED, FYI → INFO, async decision → DECISION, etc.)\n- Inbox polling protocol: frequency recommendation + what to do with unacked required messages\n- Reservation conflict resolution documented: active agent blocks, stale/evicted warns with --takeover-stale\n- Worked example showing full HANDOFF flow from sender through recipient to ack\n- bd mail delegate config documented (how to configure bb as the delegate)\n\n**Scope**:\n- New file: .agents/skills/beadboard-driver/references/coordination-system.md\n- May deprecate/replace coord-events-sessions-ack.md\n\n**Out of Scope**:\n- SKILL.md update (maf.10)\n- Memory, swarm, or lifecycle docs (separate maf tasks)\n\n## IMPLEMENTATION CONSTRAINTS\n- Reference actual command flags from tools/bb.ts and src/lib/agent-mail.ts — not speculative\n- Test examples against real command output where possible\n\n## VERIFICATION REQUIREMENTS\n- File exists at .agents/skills/beadboard-driver/references/coordination-system.md\n- All bb agent commands documented with at least one complete example\n- WHEN-to-use trigger map covers at least 6 scenarios","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-izs.7","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Added canonical coordination reference at skills/beadboard-driver/references/coordination-system.md (per user path clarification: skills folder, not .agents). Document includes all bb agent commands/flags with examples; message state machine and requires_ack semantics; WHEN-to-use trigger map (8 scenarios); inbox polling protocol; reservation conflict policy; full HANDOFF walkthrough; bd mail delegate setup to bb-mail-shim and missing-bb fallback behavior. Verification evidence: file existence confirmed; command coverage and trigger counts validated with rg checks. 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":"bb coord: agent coordination reference doc (for v5 skill)","updated_at":"2026-03-04T02:49:04Z","waiters":"","wisp_type":"","work_type":""} {"acceptance_criteria":"WorkflowGraphProps includes assignMode?: boolean; GraphNodeData includes isAssignMode?: boolean; When isAssignMode=true and !isActionable: node has opacity-20; When isAssignMode=true and isActionable: node has ring-2 ring-emerald-400/50 shadow-[0_0_24px_rgba(16,185,129,0.2)]; npm run typecheck 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":"dd64afe3fa8c5aebaa14f15c73385a964cf584eed523b103825eecfe2e8257bc","created_at":"2026-02-24T01:37:40Z","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":"beadboard-j3u","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"## TASK CONTEXT\n- Bead ID: beadboard-j3u\n- Title: Add assign mode data flow to WorkflowGraph + GraphNodeCard\n- Parent/Epic: beadboard-uui (Unify Graph + Swarm into Single Enhanced Graph View)\n- Dependencies (must be done first): None\n\n## GOAL\nEnable visual differentiation of actionable vs non-actionable nodes when assign mode is active. This provides the visual foundation for the 'Assign' toggle functionality.\n\n## SUCCESS CRITERIA\n- WorkflowGraphProps interface includes assignMode?: boolean\n- GraphNodeData interface includes isAssignMode?: boolean\n- In WorkflowGraphInner, pass isAssignMode: assignMode to each node's data\n- In GraphNodeCard, when data.isAssignMode is true:\n - If !data.isActionable: add opacity-20 class (extra dimming)\n - If data.isActionable: add ring-2 ring-emerald-400/50 shadow-[0_0_24px_rgba(16,185,129,0.2)] (highlight ring)\n- npm run typecheck passes\n\n## SCOPE\n- Modify src/components/shared/workflow-graph.tsx:\n - Add assignMode?: boolean to WorkflowGraphProps (line 24-31)\n - Pass assignMode to WorkflowGraphInner\n - In flowModel useMemo, add isAssignMode: assignMode to each node's data (line 154-175)\n- Modify src/components/graph/graph-node-card.tsx:\n - Add isAssignMode?: boolean to GraphNodeData interface\n - Add conditional styling based on isAssignMode \u0026\u0026 isActionable\n\n## OUT OF SCOPE\n- SmartDag changes (beadboard-5sr)\n- AssignmentPanel component (beadboard-d4n)\n- UnifiedShell wiring (beadboard-cm8)\n\n## IMPLEMENTATION NOTES\nThe visual treatment should:\n1. Non-actionable nodes in assign mode: fade them out so user focuses on ready nodes\n2. Actionable nodes in assign mode: glowing emerald ring to draw attention\n3. Preserve existing styling for non-assign mode\n\n## VERIFICATION REQUIREMENTS\n- Required commands:\n - npm run typecheck\n- Manual verification:\n - When assignMode=true, actionable nodes have green ring\n - When assignMode=true, non-actionable nodes are dimmed\n - When assignMode=false, existing styling preserved","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":"Add assign mode data flow to WorkflowGraph + GraphNodeCard","updated_at":"2026-02-24T01:40:31Z","waiters":"","wisp_type":"","work_type":"mutex"} {"acceptance_criteria":"help/memory folder exists with workflow docs; both AGENTS manuals reference and enforce memory workflow commands and schema.","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Memory workflow docs and AGENTS integration added","closed_at":"2026-03-02T00:46:38Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"8542172d8d6c8ac3d885d5d13059206681e450bdb5f0891ae91b825c5f612abd","created_at":"2026-03-02T00:45:20Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"Add critical operational docs for the bd-native memory system under help/memory and update root+beadboard AGENTS.md with explicit memory workflow protocol and command patterns.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-jgy","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Added help/memory index+workflow+query+schema docs; updated AGENTS.md with mandatory Native Memory Workflow section and command contracts.","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":"Document memory workflow in help/memory and AGENTS manuals","updated_at":"2026-03-02T00:46:38Z","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-02T23:37:31Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"9fe86aa036a7b313a7f621eadba09b9ae51b0b5f743e39d3af44f0a00849fcd4","created_at":"2026-03-02T06:54:58Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Parent: None (top-level epic)\n- Dependencies: None\n\nTASK CONTRACT\n- Goal: Add back the project scope system with UI for switching between projects\n- Success Criteria:\n - Users can switch projects from UI\n - Project registry persists\n- Scope:\n - Backend: project registry, project switching logic\n - Frontend: project switcher UI component\n- Out of Scope:\n - Agent-specific project detection (agents know their project)\n\nIMPLEMENTATION CONSTRAINTS\n- Follow bead-prompting.md format\n- Use brainstorming skill before implementation\n- Reuse existing project-scope.ts patterns\n\nVERIFICATION REQUIREMENTS\n- Required commands: npm run typecheck, npm run lint, npm run test","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-jq5","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":"[BRAINSTORM] Project Scope System - UI and Backend","updated_at":"2026-03-02T23:37:31Z","waiters":"","wisp_type":"","work_type":""} @@ -411,9 +413,9 @@ {"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":"152289ad0c00d2b2df2ceeb196f990229285b157af3494200feb48423aba27ad","created_at":"2026-03-02T23:06:27Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\\n- Parent: beadboard-c70 / beadboard-05a\\n\\nTASK CONTRACT\\n- Goal: Publish final user docs for one-liner install and command usage.\\n- Success Criteria:\\n - docs show windows + linux/mac one-liners\\n - docs explain bb vs beadboard and launcher behavior\\n - docs align with shipped behavior only\\n- Scope: docs + skill boundary notes\\n- Out of Scope: non-shipped roadmap claims\\n\\nVERIFICATION REQUIREMENTS\\n- npm run lint","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-lgs","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"Superseded by hierarchical execution tree under beadboard-05a.x","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":"deferred","target":"","timeout_ns":0,"title":"Installer docs: one-liner UX + operator quickstart","updated_at":"2026-03-02T23:16:16Z","waiters":"","wisp_type":"","work_type":""} {"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"SSE refresh test complete - bead should appear and disappear without page reload","closed_at":"2026-02-21T20:50:23Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"e7bc06d037451c7ce09c7f8809077e907db3b57b82cad71b4520b1b165b177cc","created_at":"2026-02-21T20:49:59Z","created_by":"zenchantlive","crystallizes":0,"defer_until":null,"description":"Testing that SSE events trigger UI refresh without manual page reload. This bead will be closed immediately after creation.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-m4f","is_template":0,"issue_type":"task","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"jordanlive121@gmail.com","payload":"","pinned":0,"priority":3,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":".","source_system":"","spec_id":null,"status":"closed","target":"","timeout_ns":0,"title":"Test Bead - SSE Refresh Verification","updated_at":"2026-02-21T20:50:23Z","waiters":"","wisp_type":"","work_type":"mutex"} {"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":"98693306fde3c018c61387c7c5bec2828b69b9549e7823ac817edfa23e63cbf4","created_at":"2026-03-04T01:34:22Z","created_by":"ZenchantLive","crystallizes":0,"defer_until":null,"description":"TASK CONTEXT\n- Parent/Epic: None (top-level epic)\n- Dependencies: beadboard-izs (bb mail epic must be complete before comm system docs can be written)\n\nTASK CONTRACT\n- Goal: Ground-up rewrite of the beadboard-driver skill to teach agents to use the actual live bd command surface — replacing all deprecated bb agent send/inbox/ack/register/reserve commands with real bd agent, bd swarm, bd slot, bd gate, bd mol, and bb mail commands.\n- Success Criteria:\n - All deprecated bb agent commands removed from skill docs\n - Comm system docs reference bb mail (not phantom commands)\n - Agent state/liveness doc covers bd agent state, bd agent heartbeat, bd slot\n - Swarm docs include real bd swarm create/status commands and bd mol for template discovery\n - Memory system includes domain anchor IDs and injection playbook\n - Bead lifecycle covers BLOCKED path and bd dep workflow\n - Scripts work on Linux/WSL (not just Windows bb.ps1 discovery)\n - SKILL.md v5 is the authoritative entry point tying all docs together\n- Scope:\n - All files in .agents/skills/beadboard-driver/\n - New reference doc: agent-state-liveness.md\n - Rewrite: coord-events-sessions-ack.md, archetypes-templates-swarms.md, command-matrix.md, failure-modes.md, session-lifecycle.md\n - Update: memory-system.md, project.template.md\n - Script fix: Linux/WSL bb discovery in driver-lib.mjs\n - Tests: update contracts, add bb mail integration\n - SKILL.md v5 rewrite (last)\n- Out of Scope:\n - BeadBoard UI changes\n - New bd features\n\nSTRUCTURE (8 children in dependency order):\n v5.1: Agent state + liveness reference (new doc) — no blockers\n v5.2: Memory system update — no blockers\n v5.3: Swarm system rewrite — no blockers\n v5.4: Bead lifecycle expansion — no blockers\n v5.5: Script platform fixes — no blockers\n v5.6: Comm system rewrite — blocked by beadboard-izs (bb mail)\n v5.7: Command matrix + failure modes rewrite — blocked by v5.6\n v5.8: Tests update — blocked by v5.5, v5.6\n v5.9: project.template.md update — blocked by v5.6\n v5.10: SKILL.md v5 — blocked by all above","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"beadboard-maf","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":"open","target":"","timeout_ns":0,"title":"[EPIC] BeadBoard Driver Skill v5","updated_at":"2026-03-04T01:34:22Z","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":"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":"","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: agent state + liveness reference doc (new)","updated_at":"2026-03-04T01:34:54Z","waiters":"","wisp_type":"","work_type":""} +{"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":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":"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":"","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: memory system reference update","updated_at":"2026-03-04T01:34:54Z","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":""} diff --git a/.beads/backup/labels.jsonl b/.beads/backup/labels.jsonl index 1502dc7..2a31551 100644 --- a/.beads/backup/labels.jsonl +++ b/.beads/backup/labels.jsonl @@ -125,6 +125,10 @@ {"issue_id":"bb-92d.5","label":"windows"} {"issue_id":"bb-92d.6","label":"guardrail"} {"issue_id":"bb-92d.6","label":"safety"} +{"issue_id":"bb-agent-graph-1","label":"gt:agent"} +{"issue_id":"bb-agent-graph-1","label":"role:graph"} +{"issue_id":"bb-agent-ui-1","label":"gt:agent"} +{"issue_id":"bb-agent-ui-1","label":"role:ui"} {"issue_id":"bb-atl","label":"smoke"} {"issue_id":"bb-atl","label":"writeback"} {"issue_id":"bb-b4j","label":"design-system"}