beadboard/NEXT_SESSION_PROMPT.md

# Next Session: Post-v5 Follow-On (beadboard-txj)

## TL;DR

`beadboard-maf` (Driver Skill v5) is complete and closed. Start next on `beadboard-txj` (Enhanced Graph Edge Visualization), beginning with `beadboard-txj.2`.

---

## What Changed (Completed This Session)

### v5 epic closed

- Closed: `beadboard-maf` and all children `maf.1` through `maf.10`.

### Major outputs landed

- New/refreshed skill references under `skills/beadboard-driver/references/`:
  - `agent-state-liveness.md` (new)
  - `memory-system.md`
  - `archetypes-templates-swarms.md`
  - `session-lifecycle.md`
  - `coord-events-sessions-ack.md`
  - `command-matrix.md`
  - `failure-modes.md`
  - `coordination-system.md` (already added in izs; used as canonical source)
- Script/platform updates:
  - `skills/beadboard-driver/scripts/lib/driver-lib.mjs`
  - Added `skills/beadboard-driver/scripts/ensure-bb-mail-configured.mjs`
- Test expansion:
  - Added bb-mail lifecycle and config contract coverage
  - Updated cross-platform resolve/preflight tests
  - Registered all new tests in `skills/beadboard-driver/tests/run-tests.mjs` and `package.json`
- Template + entrypoint rewrite:
  - `skills/beadboard-driver/project.template.md`
  - `skills/beadboard-driver/SKILL.md` (full v5 rewrite)

### Commit log (this session chain)

- `a4de66a` fix(skill): support linux and wsl bb discovery
- `5364885` docs(skill): rewrite coordination events and ack protocol
- `1880301` docs(skill): refresh command matrix and failure modes
- `003aba3` test(skill): add bb mail lifecycle and preflight coverage
- `60415cc` docs(skill): expand project template for v5 coordination
- `3006698` docs(skill): rewrite beadboard-driver entrypoint for v5

---

## Verification Evidence

For code-affecting bead `maf.8`, gates were run and passed:

```bash
npm run typecheck
npm run lint
npm run test
```

- `typecheck`: pass
- `lint`: pass (warnings only, no errors)
- `test`: pass (full suite including new skill contract tests)

---

## Important Notes

- Communication path remains global-install based:
  - `bd mail` delegates through `bb-mail-shim.mjs` to global `bb` CLI
  - Requirement is still `bb/beadboard` on `PATH`
- `project.md` policy is now explicit in template/skill:
  - first agent creates `project.md` in target repo root
  - subsequent agents must read/update it before work

---

## Open Risks / Follow-Ups

1. `dolt` remote auto-push warnings occurred during some bead closes due to non-fast-forward; local work is committed.
2. One large commit (`003aba3`) intentionally includes deletion of tracked `tmp/bbmaf8*` fixture/worktree artifacts.

---

## Exact Next Bead(s)

```bash
cd /mnt/c/Users/Zenchant/codex/beadboard
bd ready
bd show beadboard-txj beadboard-txj.2
bd update beadboard-txj.2 --status in_progress --assignee <agent-bead-id>
```

---

## Skills Used

- beadboard-driver
- verification-before-completion
- (execution pattern) implementing beads in dependency order with per-bead commits

---

## Memory Review

- No new canonical memory bead created in this session.
- Reused existing hard-memory anchors/rules during execution.