P0 ticket-plan Fase 1

p class="sub">Gefaseerde implementatie: safe movers → dapps/ipfs/extension → auth/boot → kernel/vapi • container-shim • SharedWorker router • kernel-puimheid • status: ontwerp, nog geen code

Principe: Fase 1 bouwt van buiten naar binnen. Eerst de routes die geen kernel-aanpassing nodig hebben (safe movers), dan DApp/IPFS/extension-routes, dan auth/boot, dan kernel+VAPI als laatste (meest tests nodig). Parallel loopt de container-shim en SharedWorker VAPI-router als onafhankelijke track.

Overzicht fases

FaseNaamAfhankelijkheidScope
1ASafe moversGeen kernelCSRF, help, stripe, verify routes verplaatsen naar Hono
1BDApps / IPFS / ExtensionFase 1ADapp-routes, IPFS pin/gateway, extension bridge
1CAuth / BootFase 1AAuth-routes, QR-login, boot step-machine, LockGate
1DKernel / VAPIFase 1B + 1CKernel-accessor, VAPI-handlers, orchestrator
Container<maos-app> shimOnafhankelijkCustom element + bridge 8KB + SDK
SharedWorkerVAPI-routerFase 1D (interface)Exact method+path capability checks

Fase 1A: Safe movers

Routes die geen kernel-imports hebben verplaatsen van Next.js route.ts naar Hono-routes. Geen gedragswijziging, alleen framework-migratie.

ticket-1A-01: CSRF-route naar Hono

Prio: P0 • Impact: laag • Risico: laag

Doel: CSRF-token generatie + validatie draait op Hono i.p.v. Next.js API route.

Bestanden:

Acceptatie:

Risico: CORS-wijzigingen kunnen bestaande clients beinvloeden. Test met alle tiers.

ticket-1A-02: Help-routes naar Hono

p class="meta">Prio: P0 • Impact: laag • Risico: laag

Doel: 6 help-routes (FAQ, docs, search, feedback, contact, changelog) verplaatsen naar Hono.

Bestanden:

Acceptatie:

Risico: Weinig. Read-only routes, geen staat.

ticket-1A-03: Stripe-routes naar Hono

Prio: P0 • Impact: middel • Risico: middel

Doel: 3 Stripe-routes (checkout, webhook, portal) verplaatsen naar Hono met behoud van webhook-verificatie.

Bestanden:

Acceptatie:

Risico: Stripe-webhook verifieert raw body. Hono moet c.req.raw() behouden voor signature-check.

ticket-1A-04: Verify/DID-routes naar Hono

Prio: P0 • Impact: laag • Risico: laag

Doel: 3 verify-routes (create, status, callback) verplaatsen naar Hono.

Bestanden:

Acceptatie:

Risico: Laag. State-loze routes.

Fase 1B: DApps / IPFS / Extension

Dapp-registratie, IPFS-pin/gateway, en extension-bridge worden gemigreerd. Vereist Fase 1A (CSRF is klaar).

ticket-1B-01: Dapp-routes naar Hono

Prio: P0 • Impact: hoog • Risico: middel

Doel: 4 Dapp-routes (list, register, update, publish) verplaatsen naar Hono. Manifest-validatie + Ed25519-sig-check in Hono.

Bestanden:

Acceptatie:

Risico: Signature-verificatie moet identiek zijn aan huidige kernel-check. Test met bestaande manifests.

ticket-1B-02: IPFS pin + gateway routes

Prio: P0 • Impact: hoog • Risico: hoog

Doel: IPFS pinning + verified-fetch gateway naar Hono. SW CID-cache koppeling.

Bestanden:

Acceptatie:

Risico: IPFS-fetch kan langzaam zijn. Timeout + retry-logica nodig. Gateway-proxy moet CORS goed instellen.

ticket-1B-03: Extension bridge routes

Prio: P0 • Impact: hoog • Risico: hoog

Doel: Extension-communicatie naar Hono: intent-queue + SSE + ID-verificatie.

Bestanden:

Acceptatie:

Risico: SSE-verbindingen in Hono vereisen specifieke streaming-response handling. MV3 service-worker-herstart moet worden getest.

Fase 1C: Auth / Boot

Authenticatie en boot-flow worden geimplementeerd. Vereist Fase 1A.

ticket-1C-01: Auth-routes naar Hono

Prio: P0 • Impact: hoog • Risico: hoog

Doel: 10 auth/QR-routes (incl. SSE scan-events) verplaatsen naar Hono.

Bestanden:

Acceptatie:

Risico: SSE in Hono vereist streaming. QR-sessies moeten跨 tabs gedeeld worden via SharedWorker.

ticket-1C-02: Boot step-machine

Prio: P0 • Impact: hoog • Risico: hoog

Doel: Implementeer de boot step-machine (start → step → verify → complete) met idempotente retry + stray-step deny.

Bestanden:

Acceptatie:

Risico: Boot is kritiek pad. Fout hier blokkeert hele OS. Uitgebreid testen nodig.

ticket-1C-03: LockGate + wallet-unlock

Prio: P0 • Impact: hoog • Risico: hoog

Doel: LockGate met 60s grace + wallet-signature unlock (viem recoverMessageAddress) + 5 retries / 15min lockout.

Bestanden:

Acceptatie:

Risico: viem is een extra dependency in boot-pad. Controleer bundle-grootte. SharedWorker moet lockout-state delen.

Fase 1D: Kernel / VAPI (laatst, meest tests)

Kernel-accessor, VAPI-handlers, orchestrator. Vereist Fase 1B + 1C.

ticket-1D-01: Kernel-accessor naar Hono

Prio: P0 • Impact: hoog • Risico: hoog

Doel: Kernel-accessor singleton migreren van Next.js naar Hono-context. Puur, geen zustand-imports.

Bestanden:

Acceptatie:

Risico: Grote refactor. Bestaande VAPI-handlers zijn afhankelijk van huidige API. Geleidelijk migreren.

ticket-1D-02: VAPI-handlers migratie

Prio: P0 • Impact: zeer hoog • Risico: hoog

Doel: 60+ VAPI-handlers (wallet, storage, chain, dapp, extension) verplaatsen naar Hono-routes. Per handler: gedrag gelijk, testen verplicht.

Bestanden:

Acceptatie:

Risico: Grootste ticket. 60+ handlers. Test-coverage is kritiek. Per batch migreren.

ticket-1D-03: Orchestrator migratie

Prio: P0 • Impact: hoog • Risico: hoog

Doel: Orchestrator (sessiebeheer, DApp-lifecycle, intent-queue) naar Hono middleware.

Bestanden:

Acceptatie:

Risico: Orchestrator is centraal. Fouten hier breken alles. Uitgebreid integratie-testen.

ticket-1D-04: Kernel puimheid (zustand verwijderen)

Prio: P0 • Impact: hoog • Risico: hoog

Doel: Verwijder zustand-imports uit kernel. Vervang storage-scope.node.ts fs-reader door attest-loader. Kill VAPI_EQUIVALENTS brede STORAGE mapping.

Bestanden:

Acceptatie:

Risico: kernel-permissions is in veel plekken import. Geleidelijk vervangen, niet in een keer.

ticket-Q18-01: isEssential vlag emergency cleanup (productie-blokker)

Prio: P0 — BLOKKER • Impact: hoog • Risico: hoog

Doel: Voeg isEssential-vlag toe aan elke module in de Mount registry. Emergency cleanup (Enforcement) unmountt alleen modules zonder isEssential=true. Essentiële modules (kernel-core, wallet-session, permission-store) worden nooit gedisposed, ongeacht geheugendruk.

Bestanden:

Acceptatie:

Risico: Kernel-core modules moeten correct gemarkeerd worden. Foutieve markering = essentiële module wordt disposed = kernel-crash.

Productie-blokker: Zonder deze fix kan emergency cleanup de kernel zelf crashen. Moet opgelost voor live-gang.

ticket-Q17-01: kernel.preload() bij boot

Prio: P0 • Impact: hoog • Risico: laag

Doel: Implementeer kernel.preload()-call na init-stap 11 in de boot-sequentie. Preload vult de init-cache (PermissionRegistry, Storage scope resolver, DApp manifest cache) zodat de eerste DApp-call niet 10s lazy-init wacht.

Bestanden:

Acceptatie:

Risico: Laag. Preload is best-effort. Fouten worden gecatcht en gelogd.

Container-shim (onafhankelijke track)

De <maos-app> custom element + 8KB bridge-shim + SDK worden parallel gebouwd. Geen afhankelijkheid van Hono-migratie.

ticket-C-01: maos-app custom element

Prio: P0 • Impact: hoog • Risico: middel

Doel: <maos-app> custom element met lifecycle: resolve → verify → spawn → attest → mount → suspend/resume → destroy.

Bestanden:

Acceptatie:

Risico: Custom element lifecycle is complex. Shadow DOM niet gebruiken (compatibiliteit).

ticket-C-02: DApp bridge-shim (8KB)

Prio: P0 • Impact: hoog • Risico: middel

Doel: 8KB bridge-shim in iframe die maos.request() biedt aan DApps. Geen window.ethereum direct.

Bestanden:

Acceptatie:

Risico: 8KB-limit is strikt. Bundle-analyse na build verplicht.

ticket-C-03: Manifest schema + Ed25519 verificatie

Prio: P0 • Impact: hoog • Risico: middel

Doel: Manifest-schema valideren (JSON Schema) + Ed25519-sig-check in container en SharedWorker.

Bestanden:

Acceptatie:

Risico: Ed25519 vereist crypto.subtle. Test in alle browsers.

SharedWorker VAPI-router (onafhankelijke track)

ticket-SW-01: VAPI-router met capability checks

Prio: P0 • Impact: zeer hoog • Risico: hoog

Doel: SharedWorker wordt VAPI-router met exact method+path capability checks. Elke call van iframe wordt gecontroleerd tegen manifest-grants.

Bestanden:

Acceptatie:

Risico: SharedWorker is nieuw in dit archetype. Test cross-browser compatibiliteit (Chrome/Edge: ok, Firefox: ok, Safari: Limited).

Geschatte doorlooptijd

FaseTicketsGeschatAfhankelijkheid
1A safe movers42-3 dagenGeen
1B dapps/ipfs/extension33-5 dagenFase 1A
1C auth/boot34-6 dagenFase 1A
1D kernel/vapi4 + 2 (Q17/Q18)5-8 dagenFase 1B + 1C
Container shim33-5 dagenOnafhankelijk
SharedWorker router13-5 dagenFase 1D interface
Totaal2019-30 dagen

Volgorde + afhankelijkheden

Fase 1A (safe movers) ─────┬──> Fase 1B (dapps/ipfs/ext) ──┐
                            |                                |
                            └──> Fase 1C (auth/boot) ───────┤
                                                             |
Container shim (parallel) ──────────────────────────────────┤
                                                             |
SharedWorker router (wacht op 1D interface) ─────────────────┤
                                                             |
                                              Fase 1D (kernel/vapi) <─┘
Volgende stap Na akkoord: tickets uitwerken in issue-tracker, per ticket branch aanmaken, implementatie starten met Fase 1A (safe movers).