beadboard/NEXT_SESSION_PROMPT.md

Next Session: Runtime Manager Rollout Complete (beadboard-vyt)

What Changed (2026-03-03)

beadboard-vyt is completed and closed.

Delivered across phases 0-8:

1. Runtime manager ADR + contract alignment
   • docs/adr/2026-03-03-runtime-manager-global-install.md
   • docs/adr/2026-03-03-global-installer-contract-and-manifest.md
2. Runtime manager library
   • src/lib/runtime-manager.ts
3. Runtime-aware launcher metadata
   • install/beadboard.mjs
4. Wrapper migration to runtime metadata + atomic shim rewrite
   • install/install.sh
   • install/install.ps1
5. Global CLI entrypoint (doctor, self-update, uninstall)
   • bin/beadboard.js
   • src/cli/beadboard-cli.ts
6. Driver remediation copy alignment (npm-global first)
   • skills/beadboard-driver/scripts/lib/driver-lib.mjs
   • skills/beadboard-driver/scripts/session-preflight.mjs
7. CI/docs rollout updates
   • .github/workflows/installer-smoke.yml
   • README.md
   • docs/ops/global-install-rollout.md

Verification Evidence

Focused TDD/acceptance tests added and passing:

1. tests/docs/runtime-manager-adr-contract.test.ts
2. tests/lib/runtime-manager.test.ts
3. tests/scripts/beadboard-launcher-runtime.test.ts
4. tests/scripts/install-legacy-migration.test.ts
5. tests/cli/beadboard-cli.test.ts
6. Updated installer/driver/docs/ci contract tests all passing.

Full gates run in-session:

1. npm run typecheck -> pass
2. npm run lint -> fail outside rollout scope (known pre-existing .beads/fix.js and .beads/fix2.js errors)
3. npm run test -> pass (full explicitly enumerated suite)

Targeted acceptance checks run and passing:

1. node --import tsx --test tests/lib/runtime-manager.test.ts
2. node --import tsx --test tests/scripts/beadboard-launcher-runtime.test.ts
3. node --import tsx --test tests/scripts/install-legacy-migration.test.ts
4. node --import tsx --test tests/skills/beadboard-driver/resolve-bb.test.ts

Open Risks

1. Global lint remains non-green due known unrelated .beads/fix.js and .beads/fix2.js rule violations.
2. Repo remains broadly dirty from unrelated concurrent work; commits in this session were intentionally scoped by file selection.

Next Bead

Run bd ready and pick top priority from ready queue; likely quality/stabilization follow-up around existing global lint/test drift if requested.

Skills Used This Session

1. executing-plans
2. test-driven-development
3. verification-before-completion

Memory Review

Memory review completed: no new reusable memory created.