A privacy-first data mesh: Browsy is the extension that authenticates you (Authy) and hosts Wizy; Wizy manages your JSONs and derives recommendations; Nety carries only the social layer. Local data moves directly between permitted peers, session by session. Nothing personal leaves the device unencrypted.
Three concentric worlds. The class of a field decides where it may live and who may read it; the app never decides that on its own.
Journal answers, health and body data, identity proofs, precise location, private messages, keys.
App portraits, extended profile fields, shared playlists, project data, circle posts.
Published posts, public profile, public app summaries, social recommendations.
| App / piece | Lives in | Role here | Classes |
|---|---|---|---|
| Browsy | Browser extension | Host: Authy, Wizy, vault, peer pulls, grants, enforcement | P · L · S · D · M |
| Authy | Module inside Browsy | Identity, channels, levels, sessions, recovery, signing | P keys · M grants |
| Wizy | Module + workspace inside Browsy | JSON manager, merge, derive, projection, others view | P · L · S · D |
| Nety | Rust daemon + libp2p | Social/global transport, storage, compute, WoT ranking | S (and published D) |
| Localhost / web | localhost:8642 / flove.org | Authoring and export, same schema, signed via Authy | L · S authored |
| Appy | flove.org / localhost | Renders portraits and profiles; asks Browsy for a view | L · S |
| flovePortrait apps | Any single-file app | Produce flove-portrait/1 documents (Goddy, Souls, …) | L by default |
| MyFamily | Browsy L use case (app stays the editor) | Each added person is kept P/L/S and used L; local federated sharing | P · L (used) · S |
| Central (optional) | FastAPI / Turso | Public mirror, discovery, optional aggregation | S only |
Browsy is the only host. Authy and Wizy are its two organs. The vault is the only place P/L/M rest. Peers receive encrypted L projections; Nety only receives S.
Browsy is the host; Authy and Wizy live inside it. The local net and Nety social are two independent switches.
Session start: unlock → load → pull local peers → read social (optional) → merge → derive. The gates are the privacy contract.
Session thread. Gate 1–5 are binary: if a gate fails, the session stops at that point.
Share thread. The grant is signed by Authy; Wizy can never include a P path in a projection.
This is the shipped envelope today. It stays exactly the same for apps and Appy; Browsy/Wizy add owner, class, grants and signatures around it.
{
"schema": "flove-portrait/1",
"app": "goddy",
"version": 1,
"generatedAt": "…",
"lang": "en",
"phrase": "…",
"rows": [
{ "key": "from:to", "kind": "cell",
"title": "from → to", "items": ["2"] }
],
"completeness": { "layers": 7, "total": 9 },
"stats": { "count": 7, "intensity": 0.62, "max": 3 },
"consent": { "share": "app",
"purposes": ["self-reflection", "export"] },
"source": { "url": "https://flove.org/apps/metas/goddy.html" }
}
API: get · validate · consult · merge · selfTest · toSummary · toAgent. Appy renders it; the file is still downloadable.
owner, bundleId, version, signature.L by default; public slices become S only by consent.documents.goddy.rows; grants can narrow to prefixes/slices.consult(grant) intersects the grant with consent.purposes.Scale 1 · one portrait, one device. The app API does not change; the wrapper is additive.
Scale 2 · the same portrait across the mesh. The grant is the only bridge; Nety never sees L.
Every app exposes the same seven functions. They are the seam Browsy/Wizy hooks into; the app does not need to know about bundles or grants.
| Function | What it does | Input → output | Who calls it |
|---|---|---|---|
get() | Reads the live model and builds the portrait | () → flove-portrait/1 | App UI, Browsy/Wizy capture |
validate(payload) | Checks schema, app id and rows | (object) → {ok, errors[]} | Appy import, Wizy, tests |
consult(sel) | Returns a filtered read-only view for a purpose | ({purpose, enforceConsent, from, to, kinds, group, maxItems}) → flove-consult/1 | Wizy projections, agents |
merge(payload, opts) | Writes a portrait back into the app | (portrait, {mode}) → {ok, applied, mode} | Import, restore, peer sync |
selfTest() | Runs get → validate → consult | () → {ok, rows, consultRows, errors} | ?selftest, CI |
toSummary() | Returns the app's own summary model | () → app model | Appy legacy, Wizy context |
toAgent() | Returns the agent block (prompt, schema, suggestions) | () → floveAgentBlock | MyWizy / Flove AI |
get stays; validate becomes the first gate; consult accepts a grant and returns only the intersection; merge only accepts a verified bundle; selfTest is the M1 acceptance test; toSummary/toAgent stay local unless their output is exported as D/L/S.MyFamily is the L use case of Browsy. Each person added is kept as P, L or S and used as L: P is private, L is shared with others locally (federated), S is public data. Permissions over a P2P network are another planned trunk.
The record — person id, name, relation, 7 trait groups with nuances, 5 raters, notes, subject-consent, version — encrypted in the vault.
Chosen traits/raters shared with named peers or circles, with expiry, and only if the subject-consent state allows it.
A minimal separate artefact for the web-social path; never the raw record, nuances or children's data.
MyFamily is displayed as a use case on the browsy page ↗. Third-party questions B01–B10 are in browsy-questions.md; P2P permissions are a later trunk.
The Authenticate card in index.html has five bars: Self, Email, Telegram, Phone, Bio. In the risa model, Telegram presence is L2; a nonce + DM claim upgrades to L3 verified, the publish gate. linkIdentity() stores the key, awards Personal points and persists to flove:authy in localhost. From there the signed summary can be sent to local and (at L3) social keepers.
| Level | Proof | Adds | Publish S | Sign grants |
|---|---|---|---|---|
| L1 self | local profile | identity root | no | yes (own) |
| L2 presence | Telegram linked (unclaimed); email also presence | presence profile, local sharing | no | yes |
| L3 verified | Telegram claim (nonce + DM) | publish gate | yes | yes |
| L4 phone | SMS/call proof | stronger recovery | yes | yes |
| L5 bio | local biometric unlock | highest unlock bar | yes | yes |
flove:authy/1 in localStorage; the same payload is what Browsy will store later. Displayed vs awarded points differ (+4/+12/+6/+8 vs 20/50/100/200). The Authy index ↗ shows both until one table wins (pending A03).“Derived” (D) is anything Wizy produces from inputs rather than copying. The options are deliberately separate so the user can choose how much computation — and exposure — is acceptable.
| Option | Where | Inputs | Leaves device | Output | Shareable | Risk |
|---|---|---|---|---|---|---|
| D0 · none | Wizy in Browsy | P/L/S for merge + filtering | Nothing | Views: what I see / what X sees | Only as L/S projection | Lowest; over-sharing is the only leak |
| D1 · deterministic rules | Wizy in Browsy | P + L + S, class-tagged | Nothing | Scores, matches, auditable explanations | D as L/S if exported | Rule leakage / gaming |
| D2 · on-device model | Wizy in Browsy (WASM/small) | P + L + S or a de-identified subset | Model updates only, no payload | Natural-language advice | D as L/S if exported | Device cost; prompt/log leakage |
| D3 · remote de-identified | Nety compute / approved server | D-only feature vector + query | De-identified payload | Recommendation result | D as L/S if exported | Inference; metadata; provider trust |
| D4 · remote encrypted | Nety node / enclave (future) | Encrypted P/L payload | Ciphertext only | Encrypted result, decrypted locally | D as L/S if exported | Enclave trust; availability |
| D5 · peer-assisted | Permitted peer's Browsy | Only the granted L projection | The granted projection | Peer's derived answer | D unless exported | Trust + extra exposure |
| Option | What it is | Exposure | Suggested |
|---|---|---|---|
| O0 · raw projection | The owner's signed view, filtered by the grant | Exactly the granted paths | ✅ v1 default |
| O1 · recomputed view | The recipient's Wizy recomputes from granted L | More personalization, more inference | Opt-in per relationship |
| O2 · social comparison | Nety-ranked comparison using S only | Public/social only | Later |
| ID | Milestone | Goal + deliverables | Entry | Privacy gate / acceptance test |
|---|---|---|---|---|
| M0 | Spec & taxonomy | Classify every field P/L/S/D/M; grant schema v0; invariants; threat model v0 | Reviewed doc; Q1–Q3 | No unclassified field; every shipped JSON mapped; invariants signed off |
| M1 | Browsy shell + Wizy local | MV3 shell; Wizy workspace; bundle read/write; portrait wrapping; import/export; class tags; no network | M0 | Goddy portrait round-trips unchanged; P cannot be selected for export; vault refuses plaintext writes |
| M2 | Authy + vault | Ed25519 root; passphrase/WebAuthn unlock; encrypted vault; signed bundles; grants; recovery start | M1 | Tampered bundle rejected; wrong passphrase reveals nothing; rotation keeps grants valid |
| M3 | Local net L pulls | Peer discovery option; transport; deltas; verify/decrypt; revoke; offline queue; local audit | M2; Q3 | Two browsers exchange only granted paths; revoke stops next pull; zero Nety traffic for L |
| M4 | Nety social S | Opt-in social toggle; S schema/validation; signed reads; gateway prerequisite | M3; Nety gateway wired (currently not) | S contains no P/L; toggle off = zero Nety calls; publish requires consent |
| M5 | Derivations + others view | D0/D1 built; D2 spike; D3 consent flow; O0 projection; explanation UI | M4; Q7–Q8 | Default run fully offline; D3 shows exactly what leaves; O0 shows only granted paths |
| M6 | Hardening + overwrite | Threat review; a11y/mobile; docs; rewrite index P2P/Wizy/Nety; retire superseded plans | M5 | External checklist; no open critical privacy bug; Chrome + Firefox usable |
| M7 | Usability passes | Onboarding; grant editor; explanation readability; error states; measured tasks | First 3 real peers on M3+ | Time-to-share and task success measured; no privacy setting hidden behind a default |
Map every shipped JSON and app field to a class; default for new fields.
Suggested: P unless listed; L for portraits; S only for already-public fields.
File, JSON path, array slice or field — one unit for v1 and the grant schema.
Suggested: JSON path with array ranges; fields later.
QR/endpoint, LAN, WebRTC, or Nety DHT for addresses only.
Suggested: manual endpoint + signature first; WebRTC second; never L over Nety.
TTL, rotation, no-copy, UI wording, re-encryption.
Suggested: forward-only; short TTL; rotate keys on removal.
Unlock factor, at-rest format, memory rules, encrypted backup.
Suggested: WebAuthn + passphrase; P only in Browsy/Wizy memory.
Channels, levels, sessions, masks, recovery, Nety PeerId binding.
Suggested: Ed25519 root + proofs; self-backup; social quorum fallback.
D0/D1 first, D2 spike, D3 consent; explanation; shareability.
Suggested: local by default; D3 per request; D4/D5 later.
Projection vs recomputation; signer; inference; consent.
Suggested: O0 signed projection; O1 opt-in; O2 later.
Envelope, documents, consent, signature scope, portrait compatibility.
Suggested: flove-bundle/0.1; portraits in documents[]; Authy signs.
Deltas, vector clocks/CRDT, tombstones, TTL, conflict display.
Suggested: bundle version + vector clock; last signed snapshot; surface staleness.