Kernel VFS-spec + permissiematrix

Besluiten vastgelegd: DApp-code op IPFS (niet in VFS) • alleen DApp-data in VFS • exacte methode+pad-match (geen family-matching) • versie alleen bij publish • gedeelde mappen met ACL • encryptie verplicht • hot path 100% client-side

Principe: VFS leeft client-side (OPFS + IndexedDB) achter SharedWorker. Iframe vraagt, Worker beslist (allow(sig-manifest, methode, pad)), Hono is alleen controle (publish/pin/backup/revoke), geen dataplane.

1. Namespaces (geen relatieve paden, geen .., geen symlinks buiten scope)

NamespaceWieDefaultQuota
vfs://app/<id>/Eigen DApp-data, kleinread+write eigen id20MB default, verhoging via grant
vfs://user/Privé user-docs/mediageen toegang, per pad grant500MB user-totaal
vfs://shared/<project>/Samenwerking met ACLgeen toegangtelt bij owner-project (1GB)
vfs://tmp/<id>/Ephemeral, geen sync/backupeigen id50MB, LRU-evict
vfs://vault/Keys/secrets, nooit naar iframe als plaintextalleen via vault: methoden5MB

2. Methoden — exacte permissie per call

Regel: storage:<methode>:<pad>. write impliceert geen delete/rename. Geen storage of storage:write als wildcard.

VAPI-methodeVereiste grant (voorbeeld)Gedrag
storage.readFilestorage:read:/app/<id>/settings.jsonPad genormaliseerd, buiten scope = deny + audit
storage.writeFilestorage:write:/app/<id>/…Atomair: tmp + rename. Overschrijft, geen versie per write
storage.deletestorage:delete:/app/<id>/…Naar trash (30d undo), geen direct wipe. Wipe alleen met storage:delete:/… + wipe:true + step-up
storage.renamestorage:rename:/app/<id>/…Binnen zelfde namespace. Cross-namespace = deny
storage.mkdirstorage:write:/app/<id>/…mkdir -p semantiek
storage.list / stat / existsstorage:read:/… op parent/padlist gepagineerd (cursor+limit 100), geen recursive zonder flag
storage.lockimpliciet bij write (lease 5s)Concurrent writes: laatste-wint nooit stil, conflict = error + versie-teruggaaf
shared.grant / shared.revokeowner van /shared/<project>ACL-mutatie via permission-request. Revoke = port-reset bij houders

3. Gedeelde mappen (ACL)

4. Encryptie verplicht (at-rest)

5. Versies: alleen bij publish + trash lokaal

6. Opslag-architectuur (client-side dataplane)

iframe (maos.request) ──MessageChannel──▶ SharedWorker VAPI-router
    allow(manifest.sig, methode, pad, quota, ACL) ──deny?→ 403 + audit
        └──▶ OPFS (blobs) + IndexedDB (meta: quota/acl/trash/audit/keys-ref)
Hono (controle, geen hot path): /api/dapps/register /api/ipfs/pin /api/vault/policy /api/permissions/revoke
SW: alleen IPFS-fetch verify + CID-cache voor bundles, geen VFS-RPC

7. Migratie uit MAOSv6 (koppeling)