docs(workbench): mark Vault P0/P1/P2 complete; document recall endpoint (#768)
Reconcile the living docs with the shipped Vault evidence surface: - README "Shipped surfaces": record the Vault P0 (honest empty/unavailable framing, #760), P1 (inspector depth + status/facet/text filters + evidence-rail progression, #762/#763/#764), and P2 (read-only exact-CGA recall, #766) arc as complete; enrich the Vault entry row. Read-only throughout — no runtime controls. - wave-R: extend the Vault surface bullet with the recall endpoint and the P0/P1/P2 completion note + the +inf-self-match-sentinel honesty point. - api-contract-v1: add GET /vault/entries/{index}/recall (purpose, errors, trust boundary, cross-link to the data shape). - data-shapes-v1: add VaultRecallHit / VaultRecall types. - UI-UX-GUIDE: enrich the Vault row (inspector depth, filters, rail, opt-in exact-CGA recall; read-only). Docs-only; no code or contract behavior change.
This commit is contained in:
parent
2b32bd2f8f
commit
ffcc61920a
5 changed files with 75 additions and 5 deletions
|
|
@ -237,6 +237,14 @@ alignment / safety). Phase E (robustness; continuous) and the parallel tracks
|
||||||
(the CORE-Logos *Studio* mutation/patch-forge path, the universal proposal
|
(the CORE-Logos *Studio* mutation/patch-forge path, the universal proposal
|
||||||
envelope) remain.
|
envelope) remain.
|
||||||
|
|
||||||
|
The **Vault** evidence surface is likewise complete end to end: **P0** honest
|
||||||
|
empty/unavailable framing (every state framed as the Vault; absence vs
|
||||||
|
persisted-empty split; #760), **P1** entry-inspector depth + status/facet/text
|
||||||
|
filters + an honest evidence-rail progression (#762/#763/#764), and **P2**
|
||||||
|
read-only exact-CGA recall evidence (`GET /vault/entries/{index}/recall`; #766).
|
||||||
|
It stays a read-only evidence surface — no runtime controls, no persistence
|
||||||
|
toggle, no approximate recall.
|
||||||
|
|
||||||
Doctrine is unchanged: read-only first, allowlisted execution only
|
Doctrine is unchanged: read-only first, allowlisted execution only
|
||||||
(`/evals/run`, ratify, `/demos/{id}/run`), every surface a real backend reader
|
(`/evals/run`, ratify, `/demos/{id}/run`), every surface a real backend reader
|
||||||
(no theater), determinism over persuasion.
|
(no theater), determinism over persuasion.
|
||||||
|
|
@ -250,7 +258,7 @@ Doctrine is unchanged: read-only first, allowlisted execution only
|
||||||
| Converse | **Chat** |
|
| Converse | **Chat** |
|
||||||
| Cognition | **Trace** (Pipeline / Field / Bundle / Surfaces / Grounding / Verdicts / Metadata / Raw tabs), **Contemplation** (staged learning loop) |
|
| Cognition | **Trace** (Pipeline / Field / Bundle / Surfaces / Grounding / Verdicts / Metadata / Raw tabs), **Contemplation** (staged learning loop) |
|
||||||
| Determinism | **Tour** (guided determinism narrative), **Replay** (hash-to-hash), **Demos** (Demo Theater) |
|
| Determinism | **Tour** (guided determinism narrative), **Replay** (hash-to-hash), **Demos** (Demo Theater) |
|
||||||
| Evidence | **Proposals** (+ HITL ratification), **Runs** (+ identity continuity), **Lived Life** (always-on heartbeat), **Vault**, **Audit** |
|
| Evidence | **Proposals** (+ HITL ratification), **Runs** (+ identity continuity), **Lived Life** (always-on heartbeat), **Vault** (honest empty/unavailable framing · inspector depth + status/facet/text filters · evidence-rail progression · exact-CGA recall), **Audit** |
|
||||||
| Discipline | **Evals** (wrong=0 ledger), **Calibration** (gold-tether arena, Wilson floor vs θ) |
|
| Discipline | **Evals** (wrong=0 ledger), **Calibration** (gold-tether arena, Wilson floor vs θ) |
|
||||||
| Substrate | **Packs**, **CORE-Logos** (read-only pack reader) |
|
| Substrate | **Packs**, **CORE-Logos** (read-only pack reader) |
|
||||||
| Settings | **Settings** (landing / density / inspector prefs) |
|
| Settings | **Settings** (landing / density / inspector prefs) |
|
||||||
|
|
|
||||||
|
|
@ -73,7 +73,7 @@ Current route count: 16.
|
||||||
| Evidence | Proposals | `/proposals` | `⌘4` | Review cognition and math proposal evidence. |
|
| Evidence | Proposals | `/proposals` | `⌘4` | Review cognition and math proposal evidence. |
|
||||||
| Evidence | Runs | `/runs` | `⌘6` | Browse recorded run/session evidence. |
|
| Evidence | Runs | `/runs` | `⌘6` | Browse recorded run/session evidence. |
|
||||||
| Evidence | Lived Life | `/lived-life` | Palette | Watch the always-on heartbeat hold one continuous life (closure read-not-repaired over uptime + learned-while-idle). |
|
| Evidence | Lived Life | `/lived-life` | Palette | Watch the always-on heartbeat hold one continuous life (closure read-not-repaired over uptime + learned-while-idle). |
|
||||||
| Evidence | Vault | `/vault` | `⌘8` | Inspect persisted vault metadata when persistence exists. |
|
| Evidence | Vault | `/vault` | `⌘8` | Inspect persisted vault entries when persistence exists — entry-inspector depth, status/facet/text filters, evidence rail, and opt-in exact-CGA recall evidence. Read-only (no runtime controls). |
|
||||||
| Evidence | Audit | `/audit` | `⌘9` | Read deterministic audit events. |
|
| Evidence | Audit | `/audit` | `⌘9` | Read deterministic audit events. |
|
||||||
| Discipline | Evals | `/evals` | `⌘5` | Run/read allowlisted eval lanes and wrong=0 ledgers. |
|
| Discipline | Evals | `/evals` | `⌘5` | Run/read allowlisted eval lanes and wrong=0 ledgers. |
|
||||||
| Discipline | Calibration | `/calibration` | Palette | Inspect practice-class reliability and license verdicts. |
|
| Discipline | Calibration | `/calibration` | Palette | Inspect practice-class reliability and license verdicts. |
|
||||||
|
|
|
||||||
|
|
@ -614,6 +614,32 @@ Query:
|
||||||
- `limit`: non-negative integer, default `100`
|
- `limit`: non-negative integer, default `100`
|
||||||
- `offset`: non-negative integer, default `0`
|
- `offset`: non-negative integer, default `0`
|
||||||
|
|
||||||
|
## GET /vault/entries/{index}/recall
|
||||||
|
|
||||||
|
Purpose:
|
||||||
|
|
||||||
|
Read-only proof that a persisted vault entry is recallable by CORE's *actual*
|
||||||
|
exact CGA machinery. Rehydrates the persisted `VaultStore`
|
||||||
|
(`VaultStore.from_dict` — bit-exact versors, no reprojection) and runs the real
|
||||||
|
`VaultStore.recall` using the selected entry's own stored versor as the query.
|
||||||
|
The exact `cga_inner` scan — never ANN / cosine / approximate.
|
||||||
|
|
||||||
|
`recall`'s exact-self-match `+inf` sentinel never crosses the boundary: each hit
|
||||||
|
reports the genuine finite `cga_inner` plus an `exact_self_match` flag. The raw
|
||||||
|
versor never leaves the engine — only content-addressed digests. The persisted
|
||||||
|
file is never written and the live runtime is never touched.
|
||||||
|
|
||||||
|
Path parameter:
|
||||||
|
|
||||||
|
- `index`: the entry's `entry_index` (live deque position).
|
||||||
|
|
||||||
|
Errors:
|
||||||
|
|
||||||
|
- Non-integer / out-of-range `index` → `404 not_found`.
|
||||||
|
- Absent persisted snapshot → `501 evidence_unavailable`.
|
||||||
|
|
||||||
|
See `VaultRecall` in [data-shapes-v1.md](./data-shapes-v1.md).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Evals
|
# Evals
|
||||||
|
|
|
||||||
|
|
@ -606,6 +606,35 @@ export type VaultEntry = {
|
||||||
metadata: Record<string, unknown>;
|
metadata: Record<string, unknown>;
|
||||||
versor_digest: string | null;
|
versor_digest: string | null;
|
||||||
};
|
};
|
||||||
|
|
||||||
|
// One result of CORE's exact CGA recall scan over the persisted vault.
|
||||||
|
// `cga_inner` is the genuine, finite exact inner product (never a similarity
|
||||||
|
// proxy). `exact_self_match` flags a byte-identical entry, promoted ahead of
|
||||||
|
// metric ranking (stored versors are CGA null vectors → ~0 self inner-product).
|
||||||
|
export type VaultRecallHit = {
|
||||||
|
entry_index: number;
|
||||||
|
rank: number;
|
||||||
|
cga_inner: number;
|
||||||
|
exact_self_match: boolean;
|
||||||
|
epistemic_status: string;
|
||||||
|
epistemic_state: string;
|
||||||
|
versor_digest: string | null;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Read-only proof that a persisted vault entry is recallable by CORE's actual
|
||||||
|
// exact CGA machinery. `exact_cga` is always true / `approximate` always false:
|
||||||
|
// this is the exact `cga_inner` scan, never ANN / cosine / approximate ranking.
|
||||||
|
export type VaultRecall = {
|
||||||
|
entry_index: number;
|
||||||
|
query_versor_digest: string | null;
|
||||||
|
top_k: number;
|
||||||
|
hits: VaultRecallHit[];
|
||||||
|
self_hit_rank: number | null;
|
||||||
|
self_hit_found: boolean;
|
||||||
|
exact_cga: boolean;
|
||||||
|
approximate: boolean;
|
||||||
|
source_path: string;
|
||||||
|
};
|
||||||
```
|
```
|
||||||
|
|
||||||
Vault shapes are available only from persisted `engine_state/session_state.json`
|
Vault shapes are available only from persisted `engine_state/session_state.json`
|
||||||
|
|
|
||||||
|
|
@ -222,9 +222,16 @@ versor-condition strip (see journal note below), and the conformance test.
|
||||||
primitive); mutation-boundary events visually weighted above routine events.
|
primitive); mutation-boundary events visually weighted above routine events.
|
||||||
- **Packs** — `GET /packs`, `GET /packs/{pack_id}`; new `TreeView` primitive;
|
- **Packs** — `GET /packs`, `GET /packs/{pack_id}`; new `TreeView` primitive;
|
||||||
manifest checksum displayed with `DigestBadge` (verify affordance).
|
manifest checksum displayed with `DigestBadge` (verify affordance).
|
||||||
- **Vault** — `GET /vault/summary`, `GET /vault/entries`; epistemic-state
|
- **Vault** — `GET /vault/summary`, `GET /vault/entries`,
|
||||||
badges; exact-recall provenance (`cga_inner` evidence shown, never an
|
`GET /vault/entries/{index}/recall`; epistemic-state badges; exact-recall
|
||||||
approximate score — runtime recall is exact by doctrine).
|
provenance (`cga_inner` evidence shown, never an approximate score — runtime
|
||||||
|
recall is exact by doctrine). **Vault P0/P1/P2 complete** (post-wave-R
|
||||||
|
follow-on): P0 honest empty/unavailable framing (#760); P1 entry-inspector
|
||||||
|
depth, status/facet/text filters, evidence-rail progression (#762/#763/#764);
|
||||||
|
P2 read-only exact-CGA recall evidence (#766) — rehydrates the persisted vault
|
||||||
|
and runs the real `VaultStore.recall`, reporting the genuine finite
|
||||||
|
`cga_inner` + an `exact_self_match` flag (the `+inf` self-match sentinel never
|
||||||
|
crosses the boundary). Read-only throughout; no runtime controls.
|
||||||
- **Settings** — localStorage prefs + read-only runtime config display; no
|
- **Settings** — localStorage prefs + read-only runtime config display; no
|
||||||
engine mutation (CLI-only, stated in the UI).
|
engine mutation (CLI-only, stated in the UI).
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue