Performance-budgets + strangler migratie + MV3 patterns

Besluiten vastgelegd: Q15 hard budgets als CI gates • Q16 strangler migratie achter proxy • MV3 survivability patronen • status: ontwerp, nog geen code

Principe: Performance is geen optie maar een verplichting. Hard budgets worden gecontroleerd via CI-pijplijnen. Migratie van Next.js naar Hono gebeurt incrementeel achter een proxy (strangler fig pattern). MV3-extensie heeft specifieke beperkingen die het OS-ontwerp beinvloeden.

1. Q15 — Hard budgets als CI gates

KEUZE: Alle performance-vereisten worden gecontroleerd als CI-gates. Bij overschrijding = build-faal. Geen uitzonderingen, geen handmatige overrides.

1.1 Budgetoverzicht

MethodeBudgetToolingFaal-gedrag
Shell boot<1.5 secondenLighthouse CI (Performance score ≥90)Build faal
DApp open (koud)<800msk6 load-test (p95)Build faal
DApp open (warm)<300msk6 load-test (p95)Build faal
VAPI-call (lokaal)p95 <50msk6 micro-benchmarkBuild faal
Bridge-shim≤8KB (minified)Rollup bundle-analyzerBuild faal
Shell totaal≤120KB (minified)Rollup bundle-analyzerBuild faal

1.2 CI-pijplijn integratie

git push ──▶ CI pipeline ──▶ build ──▶ bundle-analyse ──▶ Lighthouse ──▶ k6 tests ──▶ deploy
                                       │                    │              │
                                       └── bundle >120KB? ── FAAL        │
                                       └── shim >8KB? ────── FAAL        │
                                                                          └── boot >1.5s? ── FAAL
                                                                          └── DApp >800ms? ── FAAL
                                                                          └── VAPI >50ms? ─── FAAL

1.3 Toelichting per budget

1.4 Bij overschrijding

REGEL: Bij overschrijding van elk budget wordt de build automatisch gefaald. Geen handmatige override, geen "waarschuwing-only" modus. Performance is een verplichting, geen suggestie.

2. Q16 — Strangler migratie achter proxy

KEUZE: Migratie van Next.js naar Hono gebeurt incrementeel via strangler fig pattern. /kernel-routes worden achter een proxy gemigreerd. Oude STORAGE-grants worden automatisch gemigreerd naar exacte pad-grants met reviewed:false, wat één keer opnieuw bevestigen vereist. Geen big-bang migratie.

2.1 Strangler fig architectuur

Client ──▶ Proxy (Caddy/Nginx) ──┬── /kernel/* ──▶ Hono (nieuw)  ──▶ nieuw kernel
                                 │
                                 └── /* ─────────▶ Next.js (oud) ──▶ overig

2.2 Migratie-stappen

FaseRoute(s)MethodeVerificatie
1/kernel/api/vault/*Proxy naar HonoVergelijk responses, geen verschil = ok
2/kernel/api/permissions/*Proxy naar HonoCapability-check in Worker identical
3/kernel/api/dapps/*Proxy naar HonoManifest-validatie + sig-check vergelijken
4/kernel/api/vapi/*Proxy naar Hono60+ handlers vergelijken, test-coverage ≥90%
5Next.js uitschakelenProxy verwijderenAlle routes op Hono, geen fallback meer

2.3 STORAGE-grants migratie

2.4 Proxy-regels

# Caddy configuratie (voorbeeld)
kernel.maos.local {
    handle /kernel/* {
        reverse_proxy localhost:3001  # Hono
    }
    handle {
        reverse_proxy localhost:3000  # Next.js (oud)
    }
}

3. MV3 survivability patronen

MV3 BEPERKINGEN: Chrome MV3 heeft significante beperkingen die het OS-ontwerp beinvloeden. Service workers worden na 30 seconden inactiviteit afgesloten. WebSockets zijn onbetrouwbaar. Alarms zijn het enige betrouwbare wake-up mechanisme.

3.1 Alarms-only survival (30s-1min)

3.2 SSE/WS via single offscreen document

3.3 storage.session + local hydration

Storage-typeGebruikBeperking
storage.sessionTijdelijke sessie-state (intent-queue, actieve tabs)Wordt gewist bij browser-sluiting
storage.localPersistente settings, wallet-refs, manifest-cacheMax 10MB, synchronisatie across devices optioneel

3.4 EIP-6963 freeze + UUID-dedup + rdns untrusted

3.5 Queue-model: reads passthrough / sends queued

3.6 externally_connectable + sender validation + CSP

3.7 TWIST als defense-in-depth

4. Referentie: gesette stack

Definitieve architectuur:
ComponentBesluit
Browser-onlyMUST. Geen server-side rendering, geen Node.js dependencies in client.
FrameworkVite + Hono. Hono voor API-routes, Vite voor build.
3-tierIframe (UI) + SharedWorker (VAPI-router) + Service Worker (IPFS/cache).
Signed manifestsEd25519 over canonical JSON. Verificatie bij publish + mount.
VFSClient-side encrypted OPFS + IndexedDB. Hot path 100% lokaal.
WalletIntent-queue volledige goedkeuring. Geen directe broadcast.
RPCVast: chain 270 + 260. Geen custom RPC, geen fallback.
NetworkWorker-proxy-only. DApp heeft geen raw fetch.
Hibernate15 minuten inactiviteit → snapshot + suspend.
Core-trainBundle-update, DApps per-CID, minCore-check verplicht.
ExtensionTier-1 via wallet queue. Geen directe communicatie.

5. Integratie met bestaande specs

SpecKoppeling
Container-specShell budget ≤120KB, bridge-shim ≤8KB, DApp open <800ms.
VFS-specVAPI-call p95 <50ms, OPFS in SharedWorker.
Wallet-specIntent-queue goedkeuring, vaste RPC 270+260.
Boot-extensionExtension Tier-1, MV3 survival, TWIST verificatie.
Core-vs-IPFSCore-train, minCore-check, per-CID DApps.
Volgende stap Na akkoord: CI-pijplijn opzetten met Lighthouse + bundle-analyzer + k6. Proxy-configuratie voor strangler migratie. MV3-extensie aanpassen aan survivability patronen.