beadboard/NEXT_SESSION_PROMPT.md

104 lines
3 KiB
Markdown

# 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.