Solution architecture · responsibilities and implementation

How KISOP works.

KISOP is easier to understand in two views. The first explains what each part is responsible for. The second records the July 8–9, 2026 implementation: what was running, what had just been built, and what was still planned. For current status, use the build log.

How the parts fit together

KISOP is a person-owned system for keeping the information that shapes a life and coordinating with people and services without handing over the whole archive.

This is a map of responsibilities, not a pipeline. The Consent Gate and Together Protocol do different jobs. One controls requests to read information; the other helps separate archives coordinate.

YOU

Personal Neutral Archive

Holds one person's information on storage that person controls.

Consent Gate

Controls and records requests to read information from the archive.

Together Protocol

Lets separate archives coordinate without opening themselves to one another.

Message Transport

Carries signed, sealed messages through folders, text, or future transports.

Applications

Plans, buying together, circles, reminders, offers, and agreements use the same coordination rules.

The human layer works across the system: family, friends, Community Helpers, clinicians, builders, and local centers help people use, question, and improve it.

The Commons

Community-funded code, language, and knowledge support every layer and remain available to everyone.

The implementation map

The conceptual map above explains the parts. This dated map shows the public site, membership intake, and one working personal archive as they stood on July 9, 2026.

The files stayed where they were. We taught a database to bow to them: it is built from them, verified against them, and deletable without them noticing.
live today ★ built July 8–9, 2026 designed · queued · says so
THE PUBLIC SITE — RUNS ENTIRELY IN THE VISITOR'S BROWSER · LIVE ~507 pages from one static file · EN/ES · tools make documents on the visitor's device Stores nothing. No accounts, no cookies, no analytics — its privacy claims are true because there is no backend to reach. Only outbound door: the intake service one POST — kind · area · the one human sentence · agreed versions INTAKE & MEMBERSHIP — COMMUNITY TRUST DOMAIN · DESIGNED, BUILD #1 ON THE INFRASTRUCTURE LIST Django + Postgres + HTMX on our own machines · email-verify · review portal · one-tap decisions Holds only applications and the member ledger. Its own oath: the database must be rebuildable from its file exports. We never ask for SSN, date of birth, street address, or ID documents. Not asking is the trust demo. NO LINE ON PURPOSE — the site and the intake never touch the archive below. Each person's archive is a separate trust domain: their machine, their keys, their say. ONE PERSON'S ARCHIVE — THE PNA · V1 LIVE (BUILT JUL 8, 2026) · THIS MAP'S SUBJECT _inbox/ the only write door ingest The shelf — files, canonical 13 partitions · originals never edited provenance.yaml on every item (source, date, sha256, consent class C0–C5) derived/ — machine-made content beside its original, labeled, supersede-only append-only · hash-verified · plain YAML ★ The card catalog — built Jul 9 _indexes/catalog.sqlite (open source, public-domain engine, nothing listens) items · assertions · FTS5 · money · labs typed facts from receipts & records — questions answered in milliseconds, locally disposable · never synced · never backed up the catalog is built from the shelf (→), verified against it (⇠), and deletable with no effect on the shelf ★ pna extract receipt → typed copy in the item's own derived/ ★ The consent gate — pna-mcp · built & tested (local); network bind next The ONE door for every look. Reads policy.yaml (the only authorization truth) · every call logged, allowed or refused Sealed items (C0) are absent from what callers see. Saying "denied" would leak that they exist. Local now (stdio, no socket); private-net next. Local AI — queued (hardware answer) Sensitive-class reading & extraction run on machines in the house; no cloud ever; results land in derived/, labeled, through the same one-door rules as everyone else. Replication + backups — provisioning queued Designed: a live replica the owner physically holds + two encrypted backup targets, keys printed and hers. Today: one copy, full-disk encryption; the build reports state it in bold. Dies-gracefully test, run on every version: kill the catalog, the gate, every service; the shelf still answers to ls, cat, and grep. What this component represents: the reference implementation of the KISOP standard — the proof, in running code, that “your records, your machine, your say” can be engineered. THE COMMONS — SHARED KNOWLEDGE Terms registry (multilingual plain-language terms, versioned editions) · open specifications · community guidelines & screening policy What the community funds becomes public goods for everyone. Capabilities travel. Personal archives never do. Same database engine reused here as a distribution format for registry editions: one idiom across the whole system.

AI-based systems can connect here. KISOP does not depend on them.

This architecture is vendor-neutral. The archive, Consent Gate, Together Protocol, message delivery, and applications can work with ordinary software, paper, and people. A person may choose a model-based tool when it supports a particular outcome, but using one is not the outcome and is never a required layer.

The AI reference architectures examine optional connections to Claude, ChatGPT, Copilot, and open or local models. Each must show what data leaves the person's control, how consent applies, what was actually tested, and how to disconnect it.

Component ledger — status by component

The component-by-component status ledger that lived here moved on August 8, 2026 to the build log — the site's one status inventory, updated every time reality changes, so this map can never quietly disagree with it. The map above stays what it was on the day it was drawn: the machine's shape, with the July 8–9, 2026 build marked ★ where it landed.

One receipt, end to end

StepWhat happensToday
1 · CapturePhoto or text of a receipt lands in _inbox/ (later: forwarded via the message rail, stamped with sender + date)live (manual) · rail designed
2 · IngestHash-verified copy into Receipts/ with provenance; refuses overwrites; source preserved on any mismatchlive
3 · ExtractTyped copy written beside the original as a labeled, dated file; new readings supersede. The old reading is never overwritten★ built this week
4 · IndexCatalog rebuilt from the files; facts become queryable rows with lineage back to their source file★ built this week
5 · Ask"What did groceries cost this quarter?" Answered by SQL, locally, citing its way back to the original image★ built this week
6 · Share, scopedA consented brief, or a consent-scoped export: one queryable file holding exactly what a grant allows, the grant's own plain words embedded inside itdesigned

Steps 1–5 ran end-to-end in the July 8–9 build on synthetic data (a made-up $32.78 grocery receipt), with the answer independently cross-checked against the line-item sum. The gate that step 6 depends on is now built and tested; step 6 itself (the consent-scoped export surface) is still designed and waits correctly for that, since scoped sharing before the export path exists would be theater.

Why this shape — the five promises, audited

The KISOP standard makes five demands of any compatible system. This build's own reports audit it against all five, and publish the misses:

PromiseThis build
1 · Consent-gated, every access loggedHONORED (local) — the gate is built and tested: every access through it is consent-class- and verb-checked and logged one line per call; C0 is invisible (sealed ≡ nonexistent); an unwritable log refuses the call. Not yet network-bound (the one remaining step), and raw filesystem access bypasses it by design (the unplug test)
2 · Never removes or degrades data; append-onlyHONORED — proven byte-for-byte, refusals tested at two layers
3 · Provenance on everything; machine-made content labeledHONORED, one gap published — labeling AI-made items still needs a manual step; it's on our own attack list
4 · Works against the open specHONORED — plain files and YAML, no private API; delete the tools and the archive reads fine in a text editor
5 · Dies gracefully — fully usable if uninstalled or discontinuedHONORED — the unplug test passes live and in the automated suite, every version

That is what this component represents: a proof, the first running instance the standard can point at, gaps published, tests attached. Every promise now has a running, tested answer; two still carry a published caveat: consent-gating is enforced on the local machine and is not network-bound yet, and machine-made labeling still needs a manual step. The plan, the order, and the owner of each caveat are written down; the build log is where their standing updates.