docs(plan-04): expand adapter-host plan to bite-sized executable form

[carlomigueldy]

Summary

Replaces the 66-line Plan 04 stub (docs/superpowers/plans/2026-05-23-plan-04-adapter-host.md) with a 4,200-line bite-sized executable plan written via superpowers:writing-plans. The expanded plan follows the same shape as Plan 03: every task has complete code blocks, exact commands, and expected output — no placeholders, no "TBD".

What the plan covers

26 TDD-style tasks delivering the full adapter plugin host vertical slice:

1. @dycode/adapter-sdk additive bump → 0.2.0 — new AdapterFlavor literal (pty | structured | mcp | verifier), required manifest.flavor, optional manifest.concurrencyCap, optional AdapterPlugin.configSchema slot
2. Persistence — migration 003-adapters + AdapterRepository (CRUD over the adapters table)
3. Host quartet — loader.ts (dynamic import() + manifest validation), discovery.ts (walks ~/.dycode/adapters/node_modules), registry.ts (in-memory map), host.ts (composes the three + install/uninstall allowlist)
4. Capability gate — assertCapability() refuses any operation requiring a capability the manifest did not declare
5. Lifecycle — InstanceController (per-instance create/start/cancel/health/dispose) + node-pty channel for flavor: 'pty' + 30s health-probe scheduler emitting agent.statusChanged
6. IPC bridge — AdapterEvent → EventLogEntry translator, persistence + bus publish, all 7 event variants covered
7. IPC handlers — adapter.list/install/uninstall/configure + runtime.scan, wired through the Plan 03 dispatcher, configure validates against the per-plugin configSchema, scan emits runtime.detected for newly registered ids
8. Fixture adapter + end-to-end Vitest spec that exercises the full lifecycle through DycodeClient against a spawned daemon child — no real CLI required
9. dycoded adapter list CLI subcommand
10. Docs — new docs/architecture/adapter-host.md, refreshed root CLAUDE.md, package maps, roadmap row flipped
11. Close-out — feature_list.json F15–F20 + PROGRESS.md entry + v0.0.4-plan-04 tag

Verification

• bash scripts/verify.sh — gates 1–4 green (typecheck, lint, format, test; 135 tests across 20 files)
• pnpm exec prettier --check on the plan file — clean
• Plan self-review checklist included — spec §5 coverage map, placeholder scan, type-consistency scan

Test plan

• Plan file lints + formats clean
• Reviewer reads the plan front-to-back, scores ≥ 10/10 on consistency / scalability / maintainability / correctness (project rule from root CLAUDE.md)
• Plan is then ready to be picked up via superpowers:subagent-driven-development for actual Plan 04 execution

Linked design

• docs/superpowers/specs/2026-05-23-dycode-design.md §5 — Adapter plugin SDK
• docs/superpowers/plans/README.md — roadmap (Plan 04 row stays not started until execution)

---

Generated by Claude Code