Implementation plans — index
This folder holds detailed, actionable plans for work that is not yet implemented or only partially implemented in the repository. It complements vision and constraints (product direction) and CHANGELOG (what shipped).
Build order is gated by what to build first. A plan file is a subsystem design. It is not permission to open a later market.
How to use these documents
-
Pick a plan by area (table below).
-
Each plan states current state, target state, phased work, dependencies, and acceptance criteria.
-
Update the plan file when scope shifts; add a short entry to
changelog-details/when a phase completes if the change is non-trivial.
Status legend
| Status | Meaning |
|---|---|
|
No production-bound implementation; sketches or spikes only. |
|
User-visible or internal scaffolding exists; not feature-complete. |
|
Requirements or technology choice still open. |
Plan documents
| Document | Status (high level) | Scope |
|---|---|---|
|
Electron shell → full vault UX, storage, sync hooks, optional Kobalte alignment with the site. |
|
|
MV3 scaffold → messaging, vault handoff, provider assist flows, security model. |
|
|
Session marker + Veramo in browser → real auth story, SSR boundaries, feature parity decisions with desktop. |
|
|
Demo JSON + ad hoc GET → signed exports, optional proxy, schema alignment with OpenAPI/SDK. |
|
|
Directory permission + optional Web Bluetooth → USB/FIDO reality, threat model, UX for “public computer.” |
|
|
Event log, document store, graph index, VC anchors — turn vision sketch into phased schema and code. |
|
|
CI builds → codesigned installers, macOS notarization, extension store readiness. |
|
|
Optional D CLI under |
Cross-cutting themes
These appear in multiple plans; keep them consistent across documents.
-
Local-first and minimal trust in hosts: anything “cloud” is opt-in and explicit.
-
Interchange: prefer OpenAPI + JSON Schema as contracts before ad hoc JSON.
-
Provenance: VCs, hashes, and append-only or versioned events should agree across desktop, extension, and web where the same data is shown.
-
Regulatory posture: certification programs (HIPAA tooling, FDA SaMD, etc.) stay out of scope until a deliberate program exists; plans must not imply certification by shipping a feature flag.