docs(planning): epic 38–43 north-star roadmap, planning docs, research

[ALLiDoizCode]

Summary

Lands the planning artifacts for the next five epics derived from the 2026-05-01 north-star roundtable. Documentation only — no code, no schema, no behavior change.

This PR is the planning baseline for epic-38. After it merges, the epic-38 branch will be rebased to start landing implementation stories.

What's in here

• north-star-epic-roadmap-2026-05-01.md — sequencing for epics 38–42 against tier 1/2/3 north-star goals (Tier 1: local delivery; Tier 2: passkey identity; Tier 3: home hosting end-to-end).
• Epic 38 — ILP-over-HTTP + RFC 9421. Adds RFC 0035 ILP-over-HTTP as a peer transport alongside BTP-over-WebSocket; signs every connector HTTP surface (admin API, peer ILP-over-HTTP, connector→app local delivery) with RFC 9421 HTTP Message Signatures. ~13 stories.
• Epic 39 — TOON local delivery pipeline. Materialises the directives doc as code. Any HTTP service plus a toon.json becomes a paid TOON node. Acceptance: unmodified strfry runs as a TOON node with zero SDK imports. ~16 stories.
• Epic 40 — Passkey-PRF identity root. One passkey ceremony → WebAuthn PRF → HKDF → all six signing keys (RFC 9421, BTP, EVM, Solana, Mina, Nostr). No seed phrase. Recovery via ≥2 passkeys at registration. ~12 stories.
• Epic 41 — TownHub discovery via Nostr. kind:30400 publish/subscribe to resolve ILP prefixes to .anon addresses. Closes the discovery gap so home-hosted nodes are reachable globally with no DNS, no IP, no centralised registry. ~9 stories.
• Epic 42 — Home-hosting acceptance E2E. The binary north-star test: stranger + fresh laptop + one passkey + Pi-class container → paid TOON node settling on three chains. ~8 stories.
• Epic 43 — Migration & cross-version compatibility. Cross-cutting: telemetry to drive flip-default decisions, mixed-deployment compat matrix, on-chain identity migration tooling, unified operator playbook. ~6 stories.
• Research artifacts (planning-artifacts/research/): connector north star, ILP-as-TCP directives + handoff + replies, HTTP-sigs/WebAuthn/Nostr technical research, ILP debit-card solution research.
• Test designs for epics 38 and 39 (paired with the epic docs per the established 32–36 convention).
• CLAUDE.md terminology update: deprecate "BLS" in favor of "app"/"handler" (driven by Epic 39 Story 39.15). "Agent runtime" remains deprecated and not coming back.

Sequencing (from the roadmap)

Sprint	Epics in flight
1–2	38 (start), 39 (start) — independent, parallel
3	38 (finish), 39 (finish), 40 (start)
4	40 (finish), 41 (start)
5	41 (finish), 42 (full epic)

~5 sprints / ~10 weeks from current state to the binary north-star acceptance test answering "yes." Epic 43 runs continuously across the same window.

Out of scope

• Implementation stories — those land on epic-38 after this baseline merges.
• Sprint-status entries for epics 38–43 already exist on main; this PR does not modify sprint-status.yaml.
• Any code changes.

Test plan

• All planning artifacts render cleanly (no broken markdown, prettier-clean)
• Cross-references between epic docs and roadmap are accurate
• Roadmap sequencing reviewed against current sprint capacity

🤖 Generated with Claude Code