Skip to content

Curating memory

/governance is the human review queue, available only to password sessions with curator or account-admin.

open http://127.0.0.1:4000/governance/sign-in

If you are already signed in at /sign-in, the queue appears in the console navigation — both doors write the same session.

Statement pages also offer individual decisions beside evidence and history. The queue supports bulk approve, reject, and defer. Select all and Deselect all toggle every row; bulk operations still process one row at a time. See Exploring memory in the web console.

Signing in

Sign-in stores a short-lived token in a signed session cookie. A valid member credential cannot open the console — the controller admits only account-admin and curator password identities.

Initial render and every socket reconnect re-check the token, identity kind, and role. A cookie alone is not authorization.

There is no machine route into this console. Approve, edit, reject, merge, defer, promotion, gate-rule administration, and bulk actions exist here and nowhere else.

The review queue

flowchart LR
    Q[Queue entry] --> V[Read the statement,<br/>its provenance and confidence]
    V --> D{Decision}
    D -->|approve| A["active — retrievable in its scope"]
    D -->|edit| E["Mint a replacement through the pipeline,<br/>supersede the original,<br/>re-run the gates"]
    D -->|reject| R["rejected — retained as evidence"]
    D -->|merge| M["Combine with an existing statement,<br/>merging provenance"]
    D -->|defer| P[Leave in the queue]
    A --> C{Personal knowledge<br/>moving to a wider scope?}
    C -->|"no verified consent"| AW["awaiting_consent —<br/>knowledge does not move"]

Each decision takes a transaction-scoped advisory lock on the queue entry, so two curators cannot decide the same item concurrently.

Every single or bulk decision reports its actual result, distinguishing activation from approval that remains blocked on subject consent.

A card that conflicts with existing knowledge shows the statements it conflicts with directly, not just their ids, so a curator can judge the disagreement without leaving the card.

Edit does not mean "type over it"

Curators never write knowledge text directly. An edit mints a replacement through the pipeline-only create action, supersedes the original, and sends the replacement back through Gate A and Gate B. Curator-authored text clears the same bar as extracted text.

Approving a scope-level review of a personal item without a granted, verified consent record parks the entry in awaiting_consent and leaves the knowledge where it was. Curator approval is not consent, and no role can override that.

Consent is granted by the subject, is specific to one target scope, and only counts when it arrived over a verified channel. A denial is accepted through any channel.

Gate rules

The gate matrix is a set of rules keyed by target level and sensitivity, each naming:

  • the Gate A mode (auto_keep, auto_reject, or human review) and its confidence minimum;
  • the Gate B mode (auto_place or human review) and its corroboration minimum;
  • the revalidation interval applied to accepted items.

Lookup order is the item's own scope, then the account-wide rule, then a built-in cell that demands human review at both gates. A missing rule falls back to human judgment, never to auto-activation — so an empty matrix is safe, merely laborious.

Start strict; loosen cells only after reviewing real decisions.

Skill requirement cards

The console is also where skill requirement cards are authored. Cards are human-authored and plainly versioned; they are procedural memory, not knowledge, and they do not pass the gates. See Checking skill readiness.

What every decision leaves behind

In the same transaction as the decision:

  • an immutable decision record naming the gate, the outcome, and the rule cell;
  • a lifecycle event;
  • a hash-chained audit entry;
  • the derived-cache refresh work implied by the new state.

Audit metadata carries ids, states, levels, channels, flags, and the statement hash — never the statement text. That is what makes the audit trail safe to keep after an erasure.

Current limitation

There is no connector administration UI and no Account archive administration UI in this release; both are driven from the command line. See Limitations.