Implemented in src/components/shared/workflow-graph.tsx: added Fit to screen button in top-right control area; wired to handleFitToScreen() using reactflow fitView().
Verification: npm run typecheck => PASS. npm run lint => PASS (19 existing warnings, 0 errors). Additional regression check: node --import tsx --test tests/api/bead-comments-item-route.test.ts => PASS (9 tests). Memory review: no new reusable memory.


Added visible Fit to screen control in DAG graph and wired it to ReactFlow fitView for user-triggered viewport re-fit.


Added label: skills


Added label: agents


Added label: documentation


Added label: memory


Added label: coordination


Added label: teams


Added label: missions


Added label: template


Added label: scripts


Added label: tests


Added label: skill-md


Replaced by beadboard-1bg with updated structure following bead-prompting.md format


Implemented layout-shape controls in src/components/shared/workflow-graph.tsx: Horizontal/Vertical direction toggle, Compact/Normal density toggle, and retained Fit action. Layout now re-runs dagre with rankdir + spacing settings and updates node source/target port orientation.

Graph: add layout shape controls (not zoom)

Scope: let users change DAG shape so nodes are not forced into a long horizontal line. Implement layout direction toggle (Horizontal/Vertical) and compact spacing option in WorkflowGraph controls.

Graph has layout-shape controls; switching changes dagre rank direction and node/edge orientation; typecheck and lint pass.


Implemented layout-shape controls in src/components/shared/workflow-graph.tsx: Horizontal/Vertical direction toggle, Compact/Normal density toggle, and retained Fit action. Layout now re-runs dagre with rankdir + spacing settings and updates node source/target port orientation.
Verification: npm run typecheck => PASS. npm run lint => PASS with existing warnings (19 warnings, 0 errors). Memory review: no new reusable memory.


Added true DAG shape controls (direction + density) so users can change graph form instead of only zooming viewport.


"Rewrite

Core Skill Rewrite: beadboard-driver SKILL.md v4

Rewrite skill core contract in `skills/beadboard-driver/SKILL.md` for v4.

Required changes
1) Replace legacy "Activity Lease" wording with finalized telemetry/liveness semantics from bb-buff resiliency track.
2) Encode strict session loop:
   - bootstrap/adopt,
   - reserve,
   - work + protocol signaling,
   - typed state updates,
   - release + closeout evidence.
3) Add role/scope/swarm-aware examples (not single-agent-only examples).
4) Remove/flag any command examples that no longer exist or were renamed.
5) Add a compatibility section explaining what changed from v3 and why.

Validation requirements
- Every command shown must exist in current CLI surface or be explicitly marked as "pending in linked bead".
- Include at least one non-interactive machine-parseable flow example.

Files
- skills/beadboard-driver/SKILL.md

SKILL.md v4 reflects bb-buff semantics with no legacy drift, includes swarm/state examples, and documents compatibility delta from prior version.


"Rewrite

Format Check


"Rewrite


Reference Pack Rewrite: command matrix, lifecycle, failure modes

Refactor skill reference docs to match v4 contract and remove command drift.

Required updates
1) `references/command-matrix.md`
- remove deprecated entries,
- categorize commands by phase (bootstrap, coordination, state, closeout),
- annotate required/optional arguments and JSON envelopes.
2) `references/session-lifecycle.md`
- add swarm-aware and role-routing-aware lifecycle steps,
- include handoff and blocker obligations for multi-agent sessions.
3) `references/failure-modes.md`
- add new failure classes (state mismatch, swarm resolution failure, role fanout empty set, telemetry unavailable fallback),
- add deterministic remediation steps.

Cross-check
- reference docs must align with SKILL.md v4 and script behavior.

Files
- skills/beadboard-driver/references/command-matrix.md
- skills/beadboard-driver/references/session-lifecycle.md
- skills/beadboard-driver/references/failure-modes.md

All reference docs are v4-consistent, command-accurate, and remediation-complete for new runtime semantics.


Script Alignment: preflight/readiness/driver-lib v4

Align skill scripts with v4 runtime contract and diagnostics.

Targets
1) `scripts/session-preflight.mjs`
- validate availability of required tools/paths for v4 flow,
- output machine-readable diagnostics for new orchestration/resiliency expectations.
2) `scripts/readiness-report.mjs`
- include checks for state/telemetry/routing evidence fields when applicable.
3) `scripts/lib/driver-lib.mjs`
- centralize any command/path resolution helpers needed by v4.
4) Ensure script outputs are stable JSON for downstream automation agents.

Rules
- No hidden interactive prompts.
- Clear error codes + remediation in all failure outputs.

Files
- skills/beadboard-driver/scripts/session-preflight.mjs
- skills/beadboard-driver/scripts/readiness-report.mjs
- skills/beadboard-driver/scripts/lib/driver-lib.mjs

Skill scripts emit deterministic JSON diagnostics aligned with v4 contracts and include explicit error-code remediation.


Test Matrix Expansion: skill-local and repo-level v4 coverage

Expand and reconcile test coverage for skill package and repository-level skill tests.

Test surfaces
1) Skill-local tests
- skills/beadboard-driver/tests/*
2) Repo-level tests
- tests/skills/beadboard-driver/*

Required additions
- contract tests for updated command matrix assumptions,
- lifecycle tests for non-interactive v4 flow,
- failure-mode tests for newly documented error codes/remediations,
- script output schema assertions for preflight/readiness tools.

Gate
- ensure all existing skill tests still pass after v4 migration.

Files
- skills/beadboard-driver/tests/*
- tests/skills/beadboard-driver/*

Skill v4 behavior is covered by updated local and repo tests, including non-interactive flow, failure remediations, and output schema assertions.


Migration Handoff: v3 to v4 adoption guide

Publish migration and adoption handoff for other agents.

Deliverables
1) Migration note under `skills/beadboard-driver/references/` describing v3 -> v4 changes.
2) concise "how to adopt v4" checklist for external agents.
3) known limitations + pending linked beads matrix.
4) evidence block with exact test commands and results.

Purpose
Prevent repeat confusion and ensure low-intelligence agents can execute the new skill without tribal knowledge.

Files
- skills/beadboard-driver/references/migration-v4.md (new)
- optional addendum in SKILL.md links section

Migration guide exists with explicit delta, adoption checklist, and verification evidence references so other agents can reliably use v4 skill.


Memory System Docs: Query → Attach → Ratify → Evolve

TASK CONTEXT
- Bead ID: beadboard-btn.1
- Parent: beadboard-btn ([EPIC] BeadBoard Driver Skill v4 Rewrite)
- Dependencies: None

TASK CONTRACT
- Goal: Document how agents use beadboard's memory system
- Success Criteria:
  - Reference docs cover full memory workflow
  - Includes query commands, provenance validation, contract creation
- Scope:
  - Memory workflow (query → attach → ratify → evolve)
  - Domain anchors
  - Canonical memory nodes
  - Memory contracts
  - Noise budget
- Out of Scope:
  - Frontend UI for memory

IMPLEMENTATION CONSTRAINTS
- Reference docs in skills/beadboard-driver/references/
- Follow memory_fabric_workflow.txt patterns

VERIFICATION REQUIREMENTS
- Required commands: npm run typecheck, npm run lint


Memory System Docs

TASK CONTEXT
- Bead ID: beadboard-1bg.1
- Parent: beadboard-1bg
- Dependencies: None

TASK CONTRACT
- Goal: Document how agents use beadboard's memory system
- Success Criteria:
  - Reference docs cover full memory workflow
  - Includes query commands, provenance validation, contract creation
- Scope:
  - Memory workflow (query → attach → ratify → evolve)
  - Domain anchors
  - Canonical memory nodes
  - Memory contracts
  - Noise budget limits
- Out of Scope:
  - Frontend UI for memory

IMPLEMENTATION CONSTRAINTS
- Reference docs in skills/beadboard-driver/references/
- Follow help/memory/ patterns

VERIFICATION REQUIREMENTS
- Required commands: npm run typecheck, npm run lint


Coord Events + Sessions + Ack Docs

TASK CONTEXT
- Bead ID: beadboard-1bg.2
- Parent: beadboard-1bg
- Dependencies: None

TASK CONTRACT
- Goal: Document coord events, sessions, and message acknowledgment
- Success Criteria:
  - Reference docs for protocol events, inbox handling, ack workflow
- Scope:
  - Coord events (HANDOFF, BLOCKED, RESUME, INFO, INCURSION)
  - Sessions and inbox
  - Message ack workflow (unread → read → acked)
- Out of Scope:
  - Implementation details

IMPLEMENTATION CONSTRAINTS
- Reference docs in skills/beadboard-driver/references/

VERIFICATION REQUIREMENTS
- Required commands: npm run typecheck, npm run lint


Archetypes + Templates + Swarms Docs

TASK CONTEXT
- Bead ID: beadboard-1bg.3
- Parent: beadboard-1bg
- Dependencies: None

TASK CONTRACT
- Goal: Document agent roles, team compositions, and swarm operations
- Success Criteria:
  - Reference docs for archetypes, templates, swarm join/leave/manage
- Scope:
  - Archetypes (agent roles: coder, reviewer, writer)
  - Templates (team compositions)
  - Swarms (create, join, leave, close)
- Out of Scope:
  - Mission assignment logic

IMPLEMENTATION CONSTRAINTS
- Reference docs in skills/beadboard-driver/references/

VERIFICATION REQUIREMENTS
- Required commands: npm run typecheck, npm run lint


Missions + Realtime Docs

TASK CONTEXT
- Bead ID: beadboard-1bg.4
- Parent: beadboard-1bg
- Dependencies: beadboard-1bg.3

TASK CONTRACT
- Goal: Document work assignments and live updates
- Success Criteria:
  - Reference docs for mission assignment and realtime events
- Scope:
  - Missions (assign, graph, topology)
  - Realtime (SSE events, live updates)
- Out of Scope:
  - Implementation details

IMPLEMENTATION CONSTRAINTS
- Reference docs in skills/beadboard-driver/references/

VERIFICATION REQUIREMENTS
- Required commands: npm run typecheck, npm run lint


project.md Template

TASK CONTEXT
- Bead ID: beadboard-1bg.5
- Parent: beadboard-1bg
- Dependencies: beadboard-1bg.1, beadboard-1bg.2, beadboard-1bg.3, beadboard-1bg.4

TASK CONTRACT
- Goal: Create project.md template for env-specific workarounds
- Success Criteria:
  - Template file agents can copy and edit with project-specific knowledge
- Scope:
  - project.md template in skill
  - How to fill with env-specific workarounds
- Out of Scope:
  - Actual project setup

IMPLEMENTATION CONSTRAINTS
- Template in skills/beadboard-driver/

VERIFICATION REQUIREMENTS
- Required commands: npm run typecheck, npm run lint


Self-healing Scripts

TASK CONTEXT
- Bead ID: beadboard-1bg.6
- Parent: beadboard-1bg
- Dependencies: beadboard-1bg.1, beadboard-1bg.2, beadboard-1bg.3, beadboard-1bg.4, beadboard-1bg.5

TASK CONTRACT
- Goal: Create diagnostic and self-healing scripts
- Success Criteria:
  - Scripts for common env issues
- Scope:
  - Diagnostic scripts
  - Self-healing scripts (on-demand)
- Out of Scope:
  - Auto-run diagnostics

IMPLEMENTATION CONSTRAINTS
- Scripts in skills/beadboard-driver/scripts/

VERIFICATION REQUIREMENTS
- Required commands: npm run typecheck, npm run lint


Skill Tests

TASK CONTEXT
- Bead ID: beadboard-1bg.7
- Parent: beadboard-1bg
- Dependencies: beadboard-1bg.6

TASK CONTRACT
- Goal: Create skill-local and repo-level tests
- Success Criteria:
  - Tests prove system works
- Scope:
  - Skill-local tests
  - Repo-level tests
- Out of Scope:
  - Integration tests beyond skill

IMPLEMENTATION CONSTRAINTS
- Tests in skills/beadboard-driver/tests/ and tests/skills/beadboard-driver/

VERIFICATION REQUIREMENTS
- Required commands: npm run typecheck, npm run lint, npm run test


Core Skill Rewrite: skill.md v4

TASK CONTEXT
- Bead ID: beadboard-1bg.8
- Parent: beadboard-1bg
- Dependencies: beadboard-1bg.1, beadboard-1bg.2, beadboard-1bg.3, beadboard-1bg.4, beadboard-1bg.5, beadboard-1bg.6, beadboard-1bg.7

TASK CONTRACT
- Goal: Rewrite skill.md as entry point, manual, and TOC
- Success Criteria:
  - skill.md points to all reference docs
  - Acts as selling point for users
  - TOC for entire skill
- Scope:
  - Complete rewrite of skill.md
  - Pointers to scripts, references, project.md
- Out of Scope:
  - Implementation details

IMPLEMENTATION CONSTRAINTS
- skill.md in skills/beadboard-driver/

VERIFICATION REQUIREMENTS
- Required commands: npm run typecheck, npm run lint


Children complete - replaced by beadboard-1bg for new skill design


All sub-epics complete - replaced by beadboard-1bg for new skill design