| Fase | Naam | Afhankelijkheid | Scope |
|---|---|---|---|
| 1A | Safe movers | Geen kernel | CSRF, help, stripe, verify routes verplaatsen naar Hono |
| 1B | DApps / IPFS / Extension | Fase 1A | Dapp-routes, IPFS pin/gateway, extension bridge |
| 1C | Auth / Boot | Fase 1A | Auth-routes, QR-login, boot step-machine, LockGate |
| 1D | Kernel / VAPI | Fase 1B + 1C | Kernel-accessor, VAPI-handlers, orchestrator |
| Container | <maos-app> shim | Onafhankelijk | Custom element + bridge 8KB + SDK |
| SharedWorker | VAPI-router | Fase 1D (interface) | Exact method+path capability checks |
Routes die geen kernel-imports hebben verplaatsen van Next.js route.ts naar Hono-routes. Geen gedragswijziging, alleen framework-migratie.
Doel: CSRF-token generatie + validatie draait op Hono i.p.v. Next.js API route.
Bestanden:
apps/core/src/app/api/csrf/route.ts (bron, te vervangen)src/proxy.ts (middleware: CSRF-check voor alle POST/PUT/DELETE)apps/core/src/app/api/ (verwijder na migratie)Acceptatie:
GET /api/csrf geeft nieuw tokenRisico: CORS-wijzigingen kunnen bestaande clients beinvloeden. Test met alle tiers.
Doel: 6 help-routes (FAQ, docs, search, feedback, contact, changelog) verplaatsen naar Hono.
Bestanden:
apps/core/src/app/api/help/ (6 route.ts files)apps/core/src/app/api/help/route.tsapps/core/src/app/api/help/[slug]/route.tsapps/core/src/app/api/help/search/route.tsapps/core/src/app/api/help/feedback/route.tsapps/core/src/app/api/help/contact/route.tsapps/core/src/app/api/help/changelog/route.tsAcceptatie:
Risico: Weinig. Read-only routes, geen staat.
Doel: 3 Stripe-routes (checkout, webhook, portal) verplaatsen naar Hono met behoud van webhook-verificatie.
Bestanden:
apps/core/src/app/api/stripe/checkout/route.tsapps/core/src/app/api/stripe/webhook/route.tsapps/core/src/app/api/stripe/portal/route.tsAcceptatie:
Risico: Stripe-webhook verifieert raw body. Hono moet c.req.raw() behouden voor signature-check.
Doel: 3 verify-routes (create, status, callback) verplaatsen naar Hono.
Bestanden:
apps/core/src/app/api/verify/create/route.tsapps/core/src/app/api/verify/status/route.tsapps/core/src/app/api/verify/callback/route.tsAcceptatie:
Risico: Laag. State-loze routes.
Dapp-registratie, IPFS-pin/gateway, en extension-bridge worden gemigreerd. Vereist Fase 1A (CSRF is klaar).
Doel: 4 Dapp-routes (list, register, update, publish) verplaatsen naar Hono. Manifest-validatie + Ed25519-sig-check in Hono.
Bestanden:
apps/core/src/app/api/dapps/route.ts (list)apps/core/src/app/api/dapps/register/route.tsapps/core/src/app/api/dapps/update/route.tsapps/core/src/app/api/dapps/publish/route.tsAcceptatie:
Risico: Signature-verificatie moet identiek zijn aan huidige kernel-check. Test met bestaande manifests.
Doel: IPFS pinning + verified-fetch gateway naar Hono. SW CID-cache koppeling.
Bestanden:
apps/core/src/app/api/ipfs/[cid]/route.tsapps/core/src/app/api/ipfs/pin/route.tsapps/core/src/app/api/ipfs/gateway/route.tsAcceptatie:
Risico: IPFS-fetch kan langzaam zijn. Timeout + retry-logica nodig. Gateway-proxy moet CORS goed instellen.
Doel: Extension-communicatie naar Hono: intent-queue + SSE + ID-verificatie.
Bestanden:
apps/core/src/app/api/extension/connect/route.tsapps/core/src/app/api/extension/events/route.ts (SSE)apps/core/src/app/api/extension/intent/route.tsAcceptatie:
Risico: SSE-verbindingen in Hono vereisen specifieke streaming-response handling. MV3 service-worker-herstart moet worden getest.
Authenticatie en boot-flow worden geimplementeerd. Vereist Fase 1A.
Doel: 10 auth/QR-routes (incl. SSE scan-events) verplaatsen naar Hono.
Bestanden:
apps/core/src/app/api/auth/ (10 route.ts files)apps/core/src/app/api/auth/session/verify/route.tsapps/core/src/app/api/auth/session/revoke/route.tsapps/core/src/app/api/auth/qr-login/route.tsapps/core/src/app/api/auth/qr-login/scan-events/route.ts (SSE)Acceptatie:
Risico: SSE in Hono vereist streaming. QR-sessies moeten跨 tabs gedeeld worden via SharedWorker.
Doel: Implementeer de boot step-machine (start → step → verify → complete) met idempotente retry + stray-step deny.
Bestanden:
src/boot/boot-machine.tssrc/boot/boot-steps.tssrc/boot/boot-audit.tsapps/core/src/app/api/boot/status/route.tsAcceptatie:
Risico: Boot is kritiek pad. Fout hier blokkeert hele OS. Uitgebreid testen nodig.
Doel: LockGate met 60s grace + wallet-signature unlock (viem recoverMessageAddress) + 5 retries / 15min lockout.
Bestanden:
src/boot/lock-gate.tssrc/boot/wallet-unlock.tsapps/core/src/app/api/auth/unlock/route.tsAcceptatie:
Risico: viem is een extra dependency in boot-pad. Controleer bundle-grootte. SharedWorker moet lockout-state delen.
Kernel-accessor, VAPI-handlers, orchestrator. Vereist Fase 1B + 1C.
Doel: Kernel-accessor singleton migreren van Next.js naar Hono-context. Puur, geen zustand-imports.
Bestanden:
src/kernel-accessor.ts (huidige singleton)src/kernel/kernel-context.tsapps/core/src/app/api/kernel/route.tsapps/core/src/app/api/vapi/route.tsAcceptatie:
Risico: Grote refactor. Bestaande VAPI-handlers zijn afhankelijk van huidige API. Geleidelijk migreren.
Doel: 60+ VAPI-handlers (wallet, storage, chain, dapp, extension) verplaatsen naar Hono-routes. Per handler: gedrag gelijk, testen verplicht.
Bestanden:
src/vapi/ (60+ handler files)src/vapi/handlers/wallet-handlers.tssrc/vapi/handlers/storage-handlers.tssrc/vapi/handlers/chain-handlers.tssrc/vapi/handlers/dapp-handlers.tssrc/vapi/handlers/vfs-backend-handlers.tssrc/vapi/handlers/extension-handlers.tsAcceptatie:
Risico: Grootste ticket. 60+ handlers. Test-coverage is kritiek. Per batch migreren.
Doel: Orchestrator (sessiebeheer, DApp-lifecycle, intent-queue) naar Hono middleware.
Bestanden:
src/orchestrator/ (alle bestanden)src/orchestrator/session-manager.tssrc/orchestrator/dapp-lifecycle.tssrc/orchestrator/intent-queue.tsAcceptatie:
Risico: Orchestrator is centraal. Fouten hier breken alles. Uitgebreid integratie-testen.
Doel: Verwijder zustand-imports uit kernel. Vervang storage-scope.node.ts fs-reader door attest-loader. Kill VAPI_EQUIVALENTS brede STORAGE mapping.
Bestanden:
src/vapi/storage-scope.node.ts (verwijderen, vervangen door attest-loader)src/kernel/attest-loader.tssrc/vapi/handlers/kernel-permissions.ts (zustand verwijderen)src/kernel/permission-match.ts (exact method+path)Acceptatie:
Risico: kernel-permissions is in veel plekken import. Geleidelijk vervangen, niet in een keer.
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:
src/orchestrator/enforcement.ts — voeg isEssential(moduleId) check toe aan unmount()-loopsrc/orchestrator/resource-orchestrator.ts — getMountedModules() retourneert isEssential vlag per modulesrc/orchestrator/mount-registry.ts — registry slaat isEssential op bij mountAcceptatie:
isEssential=true worden NOOIT gedisposed bij emergency cleanupfalse) worden disposed bij geheugendrukisEssential=false (niet essentieel = disposable)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.
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:
src/orchestrator/kernel-orchestrator.ts — voeg preload()-methode toe na start()src/workers/client-kernel-worker.ts — roep kernel.preload() aan na kernel.start() (regel 113)src/shared/kernel-config.ts — voeg preload.enabled toe (default: false)Acceptatie:
kernel.preload() vult PermissionRegistry + Storage scope cache + DApp manifest cacheKernelConfig.preload.enabled = false defaultpreload.enabled = false: gedrag exact als voorheen (lazy init)Risico: Laag. Preload is best-effort. Fouten worden gecatcht en gelogd.
De <maos-app> custom element + 8KB bridge-shim + SDK worden parallel gebouwd. Geen afhankelijkheid van Hono-migratie.
Doel: <maos-app> custom element met lifecycle: resolve → verify → spawn → attest → mount → suspend/resume → destroy.
Bestanden:
src/container/maos-app.tssrc/container/lifecycle.tssrc/container/verify.tsAcceptatie:
el.spawn() lost CID op, verifieert, maakt iframe + port aanel.suspend() verwijdert iframe uit DOM (RAM -80%)el.resume() herlaadt uit snapshotel.destroy() revoket port = instant killRisico: Custom element lifecycle is complex. Shadow DOM niet gebruiken (compatibiliteit).
Doel: 8KB bridge-shim in iframe die maos.request() biedt aan DApps. Geen window.ethereum direct.
Bestanden:
src/container/bridge-shim.tssrc/shared/dapp-bridge.ts (huidige, refactoren)Acceptatie:
maos.request('wallet:sign', { tx }) werkt via MessageChannelmaos.request('storage:read', { path }) werktmaos.fetch(url, opts) naar manifest-allowlistRisico: 8KB-limit is strikt. Bundle-analyse na build verplicht.
Doel: Manifest-schema valideren (JSON Schema) + Ed25519-sig-check in container en SharedWorker.
Bestanden:
src/container/manifest-schema.tssrc/container/manifest-verify.tsAcceptatie:
Risico: Ed25519 vereist crypto.subtle. Test in alle browsers.
Doel: SharedWorker wordt VAPI-router met exact method+path capability checks. Elke call van iframe wordt gecontroleerd tegen manifest-grants.
Bestanden:
src/workers/vapi-router.tssrc/workers/capability-check.tssrc/workers/port-manager.tssrc/workers/dapp-* (huidige, refactoren)Acceptatie:
storage:read matcht niet met storage:read:/app/other/Risico: SharedWorker is nieuw in dit archetype. Test cross-browser compatibiliteit (Chrome/Edge: ok, Firefox: ok, Safari: Limited).
| Fase | Tickets | Geschat | Afhankelijkheid |
|---|---|---|---|
| 1A safe movers | 4 | 2-3 dagen | Geen |
| 1B dapps/ipfs/extension | 3 | 3-5 dagen | Fase 1A |
| 1C auth/boot | 3 | 4-6 dagen | Fase 1A |
| 1D kernel/vapi | 4 + 2 (Q17/Q18) | 5-8 dagen | Fase 1B + 1C |
| Container shim | 3 | 3-5 dagen | Onafhankelijk |
| SharedWorker router | 1 | 3-5 dagen | Fase 1D interface |
| Totaal | 20 | 19-30 dagen |
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) <─┘