From 123d67d6a0c4c3a98f2b8d363dde9e6a155554ae Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sun, 12 Jul 2026 21:08:48 +0000
Subject: [PATCH] docs: DISCOVERY-MAP D-OGAR-DOC-LAYER entry (charter #191
 follow-up)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The ogar-doc charter (docs/OGAR-DOC-LAYER-PROPOSAL.md, merged #191) mandated a
DISCOVERY-MAP ledger entry (D9). Appending D-OGAR-DOC-LAYER [S] — the document
persistence + reconstruction layer: raw bytes as a KV reference, awareness as a
GUID-keyed SoA subtree, reconstruct_document ActionDef re-emits an updated PDF.
Fires the v2-deferred typed_field mint (0x080A) + adds document (0x080B). Grade
[S] until the 5+3 council + a probe promote it; the canon mints land WITH the
council-verified build, never ahead of it. Append-only canon; no concept minted
in this commit.

Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016b33swuXE23hKtqxsHu9p1
---
 docs/DISCOVERY-MAP.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/DISCOVERY-MAP.md b/docs/DISCOVERY-MAP.md
index c295d64..75e7e87 100644
--- a/docs/DISCOVERY-MAP.md
+++ b/docs/DISCOVERY-MAP.md
@@ -1213,3 +1213,25 @@ isolation. The map's job is to keep them visible.
   IR-shape tests (effect-annotations-first-class, typed-signature, semantic-
   preservation) pass; the change is a declared-capability growth, not an IR
   reshape.
+
+- **D-OGAR-DOC-LAYER** (2026-07-12; [S] — spec, council-pending): `ogar-doc`
+  is the document persistence + reconstruction layer over `ogar-ocr` (the
+  shipped 14-cap `ocr_actions` table). It PERSISTS a `doc.v1`: the **raw bytes
+  as a KV reference** (the `document` node value = `{sha256, kv_key, mime,
+  counts}`, never the bytes — raw lives in the consumer's blob store) + the
+  **awareness as a GUID-keyed SoA subtree** (page / region / table-cell / field
+  nodes, each a facet on the 4+12 register the ClassView projects). It
+  RECONSTRUCTS via a `reconstruct_document` ActionDef — walk the awareness
+  subtree, bind a template (`ogar-render-askama` + the proven
+  `tesseract-ocr-pdf::render_searchable_pdf` brick), re-emit a PDF; mutate a
+  field node + re-fire ⇒ the document re-issues with updated knowledge (the
+  operator's Spire.Doc-style headline). This FIRES the v2-deferred `typed_field`
+  mint (0x080A reserved — the trigger recorded in the D-entry above) + adds a
+  `document` mint (0x080B); three facts-only ActionDefs (`persist` / `read` /
+  `reconstruct_document`, External kausal). Consumers inherit it via the classid
+  membrane (`lance_graph_contract::ogar_codebook::canonical_concept_id`) — no
+  per-consumer `tesseract-ogar` dep, dodging the customer-binary dep-graph
+  landmine. OGAR-AS-IR §3 + SURREAL-AST-TRAP-PREFLIGHT answered in the charter.
+  Charter: `docs/OGAR-DOC-LAYER-PROPOSAL.md` (merged #191). Grade [S] until the
+  5+3 council + a probe promote it; the canon mints (0x080A/0x080B) land WITH
+  the council-verified build, never ahead of it.