docs: rewrite arborist-one-pager + arborist-two-pager for external readers — drop ticket refs, schema versions, and internal vocabulary; reframe around user value (verified answers, fabricated-citation prevention, replay)

Old drafts read as internal substrate notes. Rewrites lead with what the system does for a consumer or evaluator and what it costs to run, with no references to internal tickets, table names, schema-version strings, governance hash dimensions, or per-record audit-mode tokens. Appendix diagrams updated in lockstep: friendly labels ("grounded / partly grounded / not grounded") replace the schema-column trichotomy, layer names paraphrased away from SURFACE/CORE/PROVIDENCE.
This commit is contained in:
russell@unturf.com 2026-05-14 10:02:08 -04:00
parent 0aada29a8e
commit 75ae470581
No known key found for this signature in database
8 changed files with 296 additions and 326 deletions

View file

@ -1,4 +1,5 @@
// Compact 3-layer architecture for the 2-pager appendix.
// External-facing labels — no schema-column or table-name vocabulary.
// Render: dot -Tsvg pager-arch-stack.dot -o pager-arch-stack.svg
digraph arch_stack {
@ -9,11 +10,11 @@ digraph arch_stack {
edge [fontname="Helvetica", fontsize=9]
bgcolor="white"
surface [label="SURFACE — ingested documents\nWikipedia · HTML · TeX · git · claim-packs\nchunked → Merkle-rooted → FTS5-indexed", fillcolor="#e9f3ff"]
core [label="CORE — distilled documents\nMerkle-bound to surfaces by per-chunk\ninclusion proofs (derivations.proof_blob)", fillcolor="#dff5e7"]
cache [label="PROVIDENCE CACHE — verified Q&A\n8-dim cache_key · audit_mode label ∈\n{STRICT, HYBRID, UNGROUNDED}", fillcolor="#fff3d6"]
surface [label="Ingested documents\n(Wikipedia · HTML · TeX · git · claim-packs)\nchunked → hashed → full-text-indexed", fillcolor="#e9f3ff"]
core [label="Derived layers\n(summaries, indices, distillations)\nhash-bound back to source chunks", fillcolor="#dff5e7"]
cache [label="Answer cache\nverified Q&A · grounded / partly / not grounded\ncryptographic chain back to source bytes", fillcolor="#fff3d6"]
audit [label="AUDIT CHAIN — every state change\nappends sha256(prev || canonical(body))\nto audit_events (single SQLite file)", fillcolor="#fde7e9", shape=note]
audit [label="Audit chain\nevery write appends a hash-linked row;\na single tampered record breaks the chain", fillcolor="#fde7e9", shape=note]
surface -> core [label="distill", fontsize=9]
core -> cache [label="verify → cache", fontsize=9]

Binary file not shown.

Before

Width:  |  Height:  |  Size: 44 KiB

After

Width:  |  Height:  |  Size: 38 KiB

Before After
Before After

View file

@ -4,77 +4,77 @@
<!-- Generated by graphviz version 2.43.0 (0)
-->
<!-- Title: arch_stack Pages: 1 -->
<svg width="379pt" height="268pt"
viewBox="0.00 0.00 379.00 268.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
<svg width="434pt" height="268pt"
viewBox="0.00 0.00 433.50 268.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 264)">
<title>arch_stack</title>
<polygon fill="white" stroke="transparent" points="-4,4 -4,-264 375,-264 375,4 -4,4"/>
<polygon fill="white" stroke="transparent" points="-4,4 -4,-264 429.5,-264 429.5,4 -4,4"/>
<!-- surface -->
<g id="node1" class="node">
<title>surface</title>
<path fill="#e9f3ff" stroke="black" d="M319,-44C319,-44 98,-44 98,-44 92,-44 86,-38 86,-32 86,-32 86,-12 86,-12 86,-6 92,0 98,0 98,0 319,0 319,0 325,0 331,-6 331,-12 331,-12 331,-32 331,-32 331,-38 325,-44 319,-44"/>
<text text-anchor="middle" x="208.5" y="-31.2" font-family="Helvetica,sans-Serif" font-size="11.00">SURFACE — ingested documents</text>
<text text-anchor="middle" x="208.5" y="-19.2" font-family="Helvetica,sans-Serif" font-size="11.00">Wikipedia · HTML · TeX · git · claim&#45;packs</text>
<text text-anchor="middle" x="208.5" y="-7.2" font-family="Helvetica,sans-Serif" font-size="11.00">chunked → Merkle&#45;rooted → FTS5&#45;indexed</text>
<path fill="#e9f3ff" stroke="black" d="M380.5,-44C380.5,-44 153.5,-44 153.5,-44 147.5,-44 141.5,-38 141.5,-32 141.5,-32 141.5,-12 141.5,-12 141.5,-6 147.5,0 153.5,0 153.5,0 380.5,0 380.5,0 386.5,0 392.5,-6 392.5,-12 392.5,-12 392.5,-32 392.5,-32 392.5,-38 386.5,-44 380.5,-44"/>
<text text-anchor="middle" x="267" y="-31.2" font-family="Helvetica,sans-Serif" font-size="11.00">Ingested documents</text>
<text text-anchor="middle" x="267" y="-19.2" font-family="Helvetica,sans-Serif" font-size="11.00">(Wikipedia · HTML · TeX · git · claim&#45;packs)</text>
<text text-anchor="middle" x="267" y="-7.2" font-family="Helvetica,sans-Serif" font-size="11.00">chunked → hashed → full&#45;text&#45;indexed</text>
</g>
<!-- core -->
<g id="node2" class="node">
<title>core</title>
<path fill="#dff5e7" stroke="black" d="M245.5,-116C245.5,-116 31.5,-116 31.5,-116 25.5,-116 19.5,-110 19.5,-104 19.5,-104 19.5,-84 19.5,-84 19.5,-78 25.5,-72 31.5,-72 31.5,-72 245.5,-72 245.5,-72 251.5,-72 257.5,-78 257.5,-84 257.5,-84 257.5,-104 257.5,-104 257.5,-110 251.5,-116 245.5,-116"/>
<text text-anchor="middle" x="138.5" y="-103.2" font-family="Helvetica,sans-Serif" font-size="11.00">CORE — distilled documents</text>
<text text-anchor="middle" x="138.5" y="-91.2" font-family="Helvetica,sans-Serif" font-size="11.00">Merkle&#45;bound to surfaces by per&#45;chunk</text>
<text text-anchor="middle" x="138.5" y="-79.2" font-family="Helvetica,sans-Serif" font-size="11.00">inclusion proofs (derivations.proof_blob)</text>
<path fill="#dff5e7" stroke="black" d="M295.5,-116C295.5,-116 112.5,-116 112.5,-116 106.5,-116 100.5,-110 100.5,-104 100.5,-104 100.5,-84 100.5,-84 100.5,-78 106.5,-72 112.5,-72 112.5,-72 295.5,-72 295.5,-72 301.5,-72 307.5,-78 307.5,-84 307.5,-84 307.5,-104 307.5,-104 307.5,-110 301.5,-116 295.5,-116"/>
<text text-anchor="middle" x="204" y="-103.2" font-family="Helvetica,sans-Serif" font-size="11.00">Derived layers</text>
<text text-anchor="middle" x="204" y="-91.2" font-family="Helvetica,sans-Serif" font-size="11.00">(summaries, indices, distillations)</text>
<text text-anchor="middle" x="204" y="-79.2" font-family="Helvetica,sans-Serif" font-size="11.00">hash&#45;bound back to source chunks</text>
</g>
<!-- surface&#45;&gt;core -->
<g id="edge1" class="edge">
<title>surface&#45;&gt;core</title>
<path fill="none" stroke="black" d="M187.5,-44C181.11,-50.39 173.98,-57.52 167.17,-64.33"/>
<polygon fill="black" stroke="black" points="164.57,-61.98 159.97,-71.53 169.52,-66.93 164.57,-61.98"/>
<text text-anchor="middle" x="190.5" y="-55.8" font-family="Helvetica,sans-Serif" font-size="9.00">distill</text>
<path fill="none" stroke="black" d="M248.1,-44C242.47,-50.25 236.2,-57.22 230.2,-63.89"/>
<polygon fill="black" stroke="black" points="227.41,-61.75 223.32,-71.53 232.62,-66.44 227.41,-61.75"/>
<text text-anchor="middle" x="252" y="-55.8" font-family="Helvetica,sans-Serif" font-size="9.00">distill</text>
</g>
<!-- audit -->
<g id="node4" class="node">
<title>audit</title>
<polygon fill="#fde7e9" stroke="black" points="365,-260 128,-260 128,-216 371,-216 371,-254 365,-260"/>
<polyline fill="none" stroke="black" points="365,-260 365,-254 "/>
<polyline fill="none" stroke="black" points="371,-254 365,-254 "/>
<text text-anchor="middle" x="249.5" y="-247.2" font-family="Helvetica,sans-Serif" font-size="11.00">AUDIT CHAIN — every state change</text>
<text text-anchor="middle" x="249.5" y="-235.2" font-family="Helvetica,sans-Serif" font-size="11.00">appends sha256(prev || canonical(body))</text>
<text text-anchor="middle" x="249.5" y="-223.2" font-family="Helvetica,sans-Serif" font-size="11.00">to audit_events (single SQLite file)</text>
<polygon fill="#fde7e9" stroke="black" points="419.5,-260 174.5,-260 174.5,-216 425.5,-216 425.5,-254 419.5,-260"/>
<polyline fill="none" stroke="black" points="419.5,-260 419.5,-254 "/>
<polyline fill="none" stroke="black" points="425.5,-254 419.5,-254 "/>
<text text-anchor="middle" x="300" y="-247.2" font-family="Helvetica,sans-Serif" font-size="11.00">Audit chain</text>
<text text-anchor="middle" x="300" y="-235.2" font-family="Helvetica,sans-Serif" font-size="11.00">every write appends a hash&#45;linked row;</text>
<text text-anchor="middle" x="300" y="-223.2" font-family="Helvetica,sans-Serif" font-size="11.00">a single tampered record breaks the chain</text>
</g>
<!-- surface&#45;&gt;audit -->
<g id="edge5" class="edge">
<title>surface&#45;&gt;audit</title>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M241.95,-44.24C250.98,-51.8 259.59,-61.18 264.5,-72 270.08,-84.3 269.38,-158.79 260.95,-206.05"/>
<polygon fill="#888888" stroke="#888888" points="257.49,-205.49 258.96,-215.98 264.35,-206.86 257.49,-205.49"/>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M294.75,-44.09C302.85,-51.88 310.68,-61.42 315,-72 320.38,-85.18 319.5,-160.34 311.42,-206.13"/>
<polygon fill="#888888" stroke="#888888" points="307.98,-205.49 309.46,-215.98 314.84,-206.85 307.98,-205.49"/>
</g>
<!-- cache -->
<g id="node3" class="node">
<title>cache</title>
<path fill="#fff3d6" stroke="black" d="M215,-188C215,-188 12,-188 12,-188 6,-188 0,-182 0,-176 0,-176 0,-156 0,-156 0,-150 6,-144 12,-144 12,-144 215,-144 215,-144 221,-144 227,-150 227,-156 227,-156 227,-176 227,-176 227,-182 221,-188 215,-188"/>
<text text-anchor="middle" x="113.5" y="-175.2" font-family="Helvetica,sans-Serif" font-size="11.00">PROVIDENCE CACHE — verified Q&amp;A</text>
<text text-anchor="middle" x="113.5" y="-163.2" font-family="Helvetica,sans-Serif" font-size="11.00">8&#45;dim cache_key · audit_mode label ∈</text>
<text text-anchor="middle" x="113.5" y="-151.2" font-family="Helvetica,sans-Serif" font-size="11.00">{STRICT, HYBRID, UNGROUNDED}</text>
<path fill="#fff3d6" stroke="black" d="M266,-188C266,-188 12,-188 12,-188 6,-188 0,-182 0,-176 0,-176 0,-156 0,-156 0,-150 6,-144 12,-144 12,-144 266,-144 266,-144 272,-144 278,-150 278,-156 278,-156 278,-176 278,-176 278,-182 272,-188 266,-188"/>
<text text-anchor="middle" x="139" y="-175.2" font-family="Helvetica,sans-Serif" font-size="11.00">Answer cache</text>
<text text-anchor="middle" x="139" y="-163.2" font-family="Helvetica,sans-Serif" font-size="11.00">verified Q&amp;A · grounded / partly / not grounded</text>
<text text-anchor="middle" x="139" y="-151.2" font-family="Helvetica,sans-Serif" font-size="11.00">cryptographic chain back to source bytes</text>
</g>
<!-- core&#45;&gt;cache -->
<g id="edge2" class="edge">
<title>core&#45;&gt;cache</title>
<path fill="none" stroke="black" d="M131,-116C129.01,-121.57 126.82,-127.71 124.68,-133.71"/>
<polygon fill="black" stroke="black" points="121.24,-132.93 121.17,-143.53 127.83,-135.29 121.24,-132.93"/>
<text text-anchor="middle" x="160.5" y="-127.8" font-family="Helvetica,sans-Serif" font-size="9.00">verify → cache</text>
<path fill="none" stroke="black" d="M184.5,-116C178.69,-122.25 172.22,-129.22 166.03,-135.89"/>
<polygon fill="black" stroke="black" points="163.18,-133.82 158.94,-143.53 168.31,-138.58 163.18,-133.82"/>
<text text-anchor="middle" x="209" y="-127.8" font-family="Helvetica,sans-Serif" font-size="9.00">verify → cache</text>
</g>
<!-- core&#45;&gt;audit -->
<g id="edge4" class="edge">
<title>core&#45;&gt;audit</title>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M200.73,-116.01C213.64,-123.04 225.91,-132.2 234.5,-144 247.33,-161.63 250.87,-186.11 251.31,-205.54"/>
<polygon fill="#888888" stroke="#888888" points="247.81,-205.72 251.28,-215.73 254.81,-205.74 247.81,-205.72"/>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M254.11,-116.13C265.91,-123.34 277.28,-132.55 285,-144 297.19,-162.08 300.75,-186.55 301.37,-205.85"/>
<polygon fill="#888888" stroke="#888888" points="297.87,-205.99 301.44,-215.97 304.87,-205.94 297.87,-205.99"/>
</g>
<!-- cache&#45;&gt;audit -->
<g id="edge3" class="edge">
<title>cache&#45;&gt;audit</title>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M151.73,-188.09C163.18,-194.29 175.8,-201.01 187.5,-207 190.37,-208.47 193.33,-209.97 196.32,-211.46"/>
<polygon fill="#888888" stroke="#888888" points="194.83,-214.63 205.35,-215.94 197.94,-208.36 194.83,-214.63"/>
<text text-anchor="middle" x="213" y="-199.8" font-family="Helvetica,sans-Serif" font-size="9.00">every write</text>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M187.31,-188C204.58,-195.51 224.22,-204.05 242.21,-211.88"/>
<polygon fill="#888888" stroke="#888888" points="240.88,-215.11 251.45,-215.89 243.68,-208.69 240.88,-215.11"/>
<text text-anchor="middle" x="255.5" y="-199.8" font-family="Helvetica,sans-Serif" font-size="9.00">every write</text>
</g>
</g>
</svg>

Before

Width:  |  Height:  |  Size: 5.6 KiB

After

Width:  |  Height:  |  Size: 5.5 KiB

Before After
Before After

View file

@ -1,5 +1,5 @@
// Compact verifier flow for the 2-pager appendix.
// (Question, source-chunks) → model → (text, pointers) → verifier → label.
// External-facing labels — no internal vocabulary.
// Render: dot -Tsvg pager-verifier-flow.dot -o pager-verifier-flow.svg
digraph verifier_flow {
@ -10,27 +10,27 @@ digraph verifier_flow {
edge [fontname="Helvetica", fontsize=11]
bgcolor="white"
question [label="QUESTION", fillcolor="#fff7e6", shape=note]
retrieval [label="retrieval\n(FTS5 + phrase route\n+ rivalry exclusion)", fillcolor="#e9f3ff"]
pointers [label="POINTER MAP\nE1 → span\nE2 → span\n…", fillcolor="#dff5e7", shape=note]
model [label="LLM\nsees: question +\npointer-tagged chunks\nemits: prose with [E1] [E2] tags\n(never types the quote string)", fillcolor="#f0e6ff"]
verifier [label="verifier\n(quote · span · entity\n· paraphrase — binary,\nno LLM call)", fillcolor="#fff3d6"]
question [label="Question", fillcolor="#fff7e6", shape=note]
retrieval [label="Retrieve\ncandidate source chunks", fillcolor="#e9f3ff"]
pointers [label="Labelled chunks\nE1 → text\nE2 → text\n…", fillcolor="#dff5e7", shape=note]
model [label="Language model\nsees: question + labelled chunks\nemits: prose tagged [E1] [E2]\n(never types the quote text)", fillcolor="#f0e6ff"]
verifier [label="Verifier\nfour mechanical strategies,\nno model in the loop", fillcolor="#fff3d6"]
label_strict [label="STRICT\nevery claim verifies", fillcolor="#28a745", fontcolor="white"]
label_hybrid [label="HYBRID\nsome verify, some don't", fillcolor="#ffc107"]
label_ungrounded [label="UNGROUNDED\nnone verify", fillcolor="#dc3545", fontcolor="white"]
label_grounded [label="grounded\nevery claim verifies", fillcolor="#28a745", fontcolor="white"]
label_partial [label="partly grounded\nsome verify, some don't", fillcolor="#ffc107"]
label_ungrounded [label="not grounded\nnone verify", fillcolor="#dc3545", fontcolor="white"]
audit [label="audit chain\n+ providence cache\n(8-dim key, governance-aware)", fillcolor="#fde7e9", shape=note]
audit [label="Audit chain\n+ answer cache\n(reproducible, replayable)", fillcolor="#fde7e9", shape=note]
question -> retrieval -> pointers
pointers -> model
model -> verifier [label="answer\n+ pointer IDs"]
verifier -> label_strict
verifier -> label_hybrid
model -> verifier [label="answer with [E1] [E2] tags"]
verifier -> label_grounded
verifier -> label_partial
verifier -> label_ungrounded
label_strict -> audit [style=dashed, color="#888888"]
label_hybrid -> audit [style=dashed, color="#888888"]
label_grounded -> audit [style=dashed, color="#888888"]
label_partial -> audit [style=dashed, color="#888888"]
label_ungrounded -> audit [style=dashed, color="#888888"]
{rank=same; label_strict; label_hybrid; label_ungrounded}
{rank=same; label_grounded; label_partial; label_ungrounded}
}

Binary file not shown.

Before

Width:  |  Height:  |  Size: 68 KiB

After

Width:  |  Height:  |  Size: 62 KiB

Before After
Before After

View file

@ -4,149 +4,145 @@
<!-- Generated by graphviz version 2.43.0 (0)
-->
<!-- Title: verifier_flow Pages: 1 -->
<svg width="1288pt" height="152pt"
viewBox="0.00 0.00 1288.00 152.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
<svg width="1389pt" height="152pt"
viewBox="0.00 0.00 1389.00 152.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 148)">
<title>verifier_flow</title>
<polygon fill="white" stroke="transparent" points="-4,4 -4,-148 1284,-148 1284,4 -4,4"/>
<polygon fill="white" stroke="transparent" points="-4,4 -4,-148 1385,-148 1385,4 -4,4"/>
<!-- question -->
<g id="node1" class="node">
<title>question</title>
<polygon fill="#fff7e6" stroke="black" points="74,-90 0,-90 0,-54 80,-54 80,-84 74,-90"/>
<polyline fill="none" stroke="black" points="74,-90 74,-84 "/>
<polyline fill="none" stroke="black" points="80,-84 74,-84 "/>
<text text-anchor="middle" x="40" y="-68.9" font-family="Helvetica,sans-Serif" font-size="12.00">QUESTION</text>
<polygon fill="#fff7e6" stroke="black" points="64,-90 0,-90 0,-54 70,-54 70,-84 64,-90"/>
<polyline fill="none" stroke="black" points="64,-90 64,-84 "/>
<polyline fill="none" stroke="black" points="70,-84 64,-84 "/>
<text text-anchor="middle" x="35" y="-68.9" font-family="Helvetica,sans-Serif" font-size="12.00">Question</text>
</g>
<!-- retrieval -->
<g id="node2" class="node">
<title>retrieval</title>
<path fill="#e9f3ff" stroke="black" d="M239,-95.5C239,-95.5 119,-95.5 119,-95.5 113,-95.5 107,-89.5 107,-83.5 107,-83.5 107,-60.5 107,-60.5 107,-54.5 113,-48.5 119,-48.5 119,-48.5 239,-48.5 239,-48.5 245,-48.5 251,-54.5 251,-60.5 251,-60.5 251,-83.5 251,-83.5 251,-89.5 245,-95.5 239,-95.5"/>
<text text-anchor="middle" x="179" y="-81.9" font-family="Helvetica,sans-Serif" font-size="12.00">retrieval</text>
<text text-anchor="middle" x="179" y="-68.9" font-family="Helvetica,sans-Serif" font-size="12.00">(FTS5 + phrase route</text>
<text text-anchor="middle" x="179" y="-55.9" font-family="Helvetica,sans-Serif" font-size="12.00">+ rivalry exclusion)</text>
<path fill="#e9f3ff" stroke="black" d="M250,-90C250,-90 109,-90 109,-90 103,-90 97,-84 97,-78 97,-78 97,-66 97,-66 97,-60 103,-54 109,-54 109,-54 250,-54 250,-54 256,-54 262,-60 262,-66 262,-66 262,-78 262,-78 262,-84 256,-90 250,-90"/>
<text text-anchor="middle" x="179.5" y="-75.4" font-family="Helvetica,sans-Serif" font-size="12.00">Retrieve</text>
<text text-anchor="middle" x="179.5" y="-62.4" font-family="Helvetica,sans-Serif" font-size="12.00">candidate source chunks</text>
</g>
<!-- question&#45;&gt;retrieval -->
<g id="edge1" class="edge">
<title>question&#45;&gt;retrieval</title>
<path fill="none" stroke="black" d="M80.26,-72C85.5,-72 91.02,-72 96.66,-72"/>
<polygon fill="black" stroke="black" points="96.9,-75.5 106.9,-72 96.9,-68.5 96.9,-75.5"/>
<path fill="none" stroke="black" d="M70.13,-72C75.41,-72 81.06,-72 86.91,-72"/>
<polygon fill="black" stroke="black" points="86.91,-75.5 96.91,-72 86.91,-68.5 86.91,-75.5"/>
</g>
<!-- pointers -->
<g id="node3" class="node">
<title>pointers</title>
<polygon fill="#dff5e7" stroke="black" points="372,-102 278,-102 278,-42 378,-42 378,-96 372,-102"/>
<polyline fill="none" stroke="black" points="372,-102 372,-96 "/>
<polyline fill="none" stroke="black" points="378,-96 372,-96 "/>
<text text-anchor="middle" x="328" y="-88.4" font-family="Helvetica,sans-Serif" font-size="12.00">POINTER MAP</text>
<text text-anchor="middle" x="328" y="-75.4" font-family="Helvetica,sans-Serif" font-size="12.00">E1 → span</text>
<text text-anchor="middle" x="328" y="-62.4" font-family="Helvetica,sans-Serif" font-size="12.00">E2 → span</text>
<text text-anchor="middle" x="328" y="-49.4" font-family="Helvetica,sans-Serif" font-size="12.00">…</text>
<polygon fill="#dff5e7" stroke="black" points="396,-102 289,-102 289,-42 402,-42 402,-96 396,-102"/>
<polyline fill="none" stroke="black" points="396,-102 396,-96 "/>
<polyline fill="none" stroke="black" points="402,-96 396,-96 "/>
<text text-anchor="middle" x="345.5" y="-88.4" font-family="Helvetica,sans-Serif" font-size="12.00">Labelled chunks</text>
<text text-anchor="middle" x="345.5" y="-75.4" font-family="Helvetica,sans-Serif" font-size="12.00">E1 → text</text>
<text text-anchor="middle" x="345.5" y="-62.4" font-family="Helvetica,sans-Serif" font-size="12.00">E2 → text</text>
<text text-anchor="middle" x="345.5" y="-49.4" font-family="Helvetica,sans-Serif" font-size="12.00">…</text>
</g>
<!-- retrieval&#45;&gt;pointers -->
<g id="edge2" class="edge">
<title>retrieval&#45;&gt;pointers</title>
<path fill="none" stroke="black" d="M251.35,-72C256.79,-72 262.24,-72 267.59,-72"/>
<polygon fill="black" stroke="black" points="267.72,-75.5 277.72,-72 267.72,-68.5 267.72,-75.5"/>
<path fill="none" stroke="black" d="M262.02,-72C267.51,-72 273,-72 278.39,-72"/>
<polygon fill="black" stroke="black" points="278.62,-75.5 288.62,-72 278.62,-68.5 278.62,-75.5"/>
</g>
<!-- model -->
<g id="node4" class="node">
<title>model</title>
<path fill="#f0e6ff" stroke="black" d="M596,-108.5C596,-108.5 417,-108.5 417,-108.5 411,-108.5 405,-102.5 405,-96.5 405,-96.5 405,-47.5 405,-47.5 405,-41.5 411,-35.5 417,-35.5 417,-35.5 596,-35.5 596,-35.5 602,-35.5 608,-41.5 608,-47.5 608,-47.5 608,-96.5 608,-96.5 608,-102.5 602,-108.5 596,-108.5"/>
<text text-anchor="middle" x="506.5" y="-94.9" font-family="Helvetica,sans-Serif" font-size="12.00">LLM</text>
<text text-anchor="middle" x="506.5" y="-81.9" font-family="Helvetica,sans-Serif" font-size="12.00">sees: question +</text>
<text text-anchor="middle" x="506.5" y="-68.9" font-family="Helvetica,sans-Serif" font-size="12.00">pointer&#45;tagged chunks</text>
<text text-anchor="middle" x="506.5" y="-55.9" font-family="Helvetica,sans-Serif" font-size="12.00">emits: prose with [E1] [E2] tags</text>
<text text-anchor="middle" x="506.5" y="-42.9" font-family="Helvetica,sans-Serif" font-size="12.00">(never types the quote string)</text>
<path fill="#f0e6ff" stroke="black" d="M629,-102C629,-102 441,-102 441,-102 435,-102 429,-96 429,-90 429,-90 429,-54 429,-54 429,-48 435,-42 441,-42 441,-42 629,-42 629,-42 635,-42 641,-48 641,-54 641,-54 641,-90 641,-90 641,-96 635,-102 629,-102"/>
<text text-anchor="middle" x="535" y="-88.4" font-family="Helvetica,sans-Serif" font-size="12.00">Language model</text>
<text text-anchor="middle" x="535" y="-75.4" font-family="Helvetica,sans-Serif" font-size="12.00">sees: question + labelled chunks</text>
<text text-anchor="middle" x="535" y="-62.4" font-family="Helvetica,sans-Serif" font-size="12.00">emits: prose tagged [E1] [E2]</text>
<text text-anchor="middle" x="535" y="-49.4" font-family="Helvetica,sans-Serif" font-size="12.00">(never types the quote text)</text>
</g>
<!-- pointers&#45;&gt;model -->
<g id="edge3" class="edge">
<title>pointers&#45;&gt;model</title>
<path fill="none" stroke="black" d="M378.17,-72C383.46,-72 388.98,-72 394.64,-72"/>
<polygon fill="black" stroke="black" points="394.95,-75.5 404.95,-72 394.95,-68.5 394.95,-75.5"/>
<path fill="none" stroke="black" d="M402.25,-72C407.58,-72 413.11,-72 418.74,-72"/>
<polygon fill="black" stroke="black" points="418.99,-75.5 428.99,-72 418.99,-68.5 418.99,-75.5"/>
</g>
<!-- verifier -->
<g id="node5" class="node">
<title>verifier</title>
<path fill="#fff3d6" stroke="black" d="M849,-102C849,-102 719,-102 719,-102 713,-102 707,-96 707,-90 707,-90 707,-54 707,-54 707,-48 713,-42 719,-42 719,-42 849,-42 849,-42 855,-42 861,-48 861,-54 861,-54 861,-90 861,-90 861,-96 855,-102 849,-102"/>
<text text-anchor="middle" x="784" y="-88.4" font-family="Helvetica,sans-Serif" font-size="12.00">verifier</text>
<text text-anchor="middle" x="784" y="-75.4" font-family="Helvetica,sans-Serif" font-size="12.00">(quote · span · entity</text>
<text text-anchor="middle" x="784" y="-62.4" font-family="Helvetica,sans-Serif" font-size="12.00">· paraphrase — binary,</text>
<text text-anchor="middle" x="784" y="-49.4" font-family="Helvetica,sans-Serif" font-size="12.00">no LLM call)</text>
<path fill="#fff3d6" stroke="black" d="M984,-95.5C984,-95.5 827,-95.5 827,-95.5 821,-95.5 815,-89.5 815,-83.5 815,-83.5 815,-60.5 815,-60.5 815,-54.5 821,-48.5 827,-48.5 827,-48.5 984,-48.5 984,-48.5 990,-48.5 996,-54.5 996,-60.5 996,-60.5 996,-83.5 996,-83.5 996,-89.5 990,-95.5 984,-95.5"/>
<text text-anchor="middle" x="905.5" y="-81.9" font-family="Helvetica,sans-Serif" font-size="12.00">Verifier</text>
<text text-anchor="middle" x="905.5" y="-68.9" font-family="Helvetica,sans-Serif" font-size="12.00">four mechanical strategies,</text>
<text text-anchor="middle" x="905.5" y="-55.9" font-family="Helvetica,sans-Serif" font-size="12.00">no model in the loop</text>
</g>
<!-- model&#45;&gt;verifier -->
<g id="edge4" class="edge">
<title>model&#45;&gt;verifier</title>
<path fill="none" stroke="black" d="M608.13,-72C637.15,-72 668.55,-72 696.63,-72"/>
<polygon fill="black" stroke="black" points="696.81,-75.5 706.81,-72 696.81,-68.5 696.81,-75.5"/>
<text text-anchor="middle" x="657.5" y="-87.2" font-family="Helvetica,sans-Serif" font-size="11.00">answer</text>
<text text-anchor="middle" x="657.5" y="-75.2" font-family="Helvetica,sans-Serif" font-size="11.00">+ pointer IDs</text>
<path fill="none" stroke="black" d="M641.1,-72C692.45,-72 753.92,-72 804.56,-72"/>
<polygon fill="black" stroke="black" points="804.87,-75.5 814.87,-72 804.87,-68.5 804.87,-75.5"/>
<text text-anchor="middle" x="728" y="-75.2" font-family="Helvetica,sans-Serif" font-size="11.00">answer with [E1] [E2] tags</text>
</g>
<!-- label_strict -->
<!-- label_grounded -->
<g id="node6" class="node">
<title>label_strict</title>
<path fill="#28a745" stroke="black" d="M1023.5,-144C1023.5,-144 913.5,-144 913.5,-144 907.5,-144 901.5,-138 901.5,-132 901.5,-132 901.5,-120 901.5,-120 901.5,-114 907.5,-108 913.5,-108 913.5,-108 1023.5,-108 1023.5,-108 1029.5,-108 1035.5,-114 1035.5,-120 1035.5,-120 1035.5,-132 1035.5,-132 1035.5,-138 1029.5,-144 1023.5,-144"/>
<text text-anchor="middle" x="968.5" y="-129.4" font-family="Helvetica,sans-Serif" font-size="12.00" fill="white">STRICT</text>
<text text-anchor="middle" x="968.5" y="-116.4" font-family="Helvetica,sans-Serif" font-size="12.00" fill="white">every claim verifies</text>
<title>label_grounded</title>
<path fill="#28a745" stroke="black" d="M1158.5,-144C1158.5,-144 1048.5,-144 1048.5,-144 1042.5,-144 1036.5,-138 1036.5,-132 1036.5,-132 1036.5,-120 1036.5,-120 1036.5,-114 1042.5,-108 1048.5,-108 1048.5,-108 1158.5,-108 1158.5,-108 1164.5,-108 1170.5,-114 1170.5,-120 1170.5,-120 1170.5,-132 1170.5,-132 1170.5,-138 1164.5,-144 1158.5,-144"/>
<text text-anchor="middle" x="1103.5" y="-129.4" font-family="Helvetica,sans-Serif" font-size="12.00" fill="white">grounded</text>
<text text-anchor="middle" x="1103.5" y="-116.4" font-family="Helvetica,sans-Serif" font-size="12.00" fill="white">every claim verifies</text>
</g>
<!-- verifier&#45;&gt;label_strict -->
<!-- verifier&#45;&gt;label_grounded -->
<g id="edge5" class="edge">
<title>verifier&#45;&gt;label_strict</title>
<path fill="none" stroke="black" d="M861.07,-94.51C872.92,-98.01 885.11,-101.62 896.83,-105.09"/>
<polygon fill="black" stroke="black" points="895.96,-108.48 906.54,-107.96 897.95,-101.77 895.96,-108.48"/>
<title>verifier&#45;&gt;label_grounded</title>
<path fill="none" stroke="black" d="M991.9,-95.53C1003.75,-98.79 1015.84,-102.13 1027.48,-105.33"/>
<polygon fill="black" stroke="black" points="1026.56,-108.71 1037.13,-107.99 1028.42,-101.96 1026.56,-108.71"/>
</g>
<!-- label_hybrid -->
<!-- label_partial -->
<g id="node7" class="node">
<title>label_hybrid</title>
<path fill="#ffc107" stroke="black" d="M1037,-90C1037,-90 900,-90 900,-90 894,-90 888,-84 888,-78 888,-78 888,-66 888,-66 888,-60 894,-54 900,-54 900,-54 1037,-54 1037,-54 1043,-54 1049,-60 1049,-66 1049,-66 1049,-78 1049,-78 1049,-84 1043,-90 1037,-90"/>
<text text-anchor="middle" x="968.5" y="-75.4" font-family="Helvetica,sans-Serif" font-size="12.00">HYBRID</text>
<text text-anchor="middle" x="968.5" y="-62.4" font-family="Helvetica,sans-Serif" font-size="12.00">some verify, some don&#39;t</text>
<title>label_partial</title>
<path fill="#ffc107" stroke="black" d="M1172,-90C1172,-90 1035,-90 1035,-90 1029,-90 1023,-84 1023,-78 1023,-78 1023,-66 1023,-66 1023,-60 1029,-54 1035,-54 1035,-54 1172,-54 1172,-54 1178,-54 1184,-60 1184,-66 1184,-66 1184,-78 1184,-78 1184,-84 1178,-90 1172,-90"/>
<text text-anchor="middle" x="1103.5" y="-75.4" font-family="Helvetica,sans-Serif" font-size="12.00">partly grounded</text>
<text text-anchor="middle" x="1103.5" y="-62.4" font-family="Helvetica,sans-Serif" font-size="12.00">some verify, some don&#39;t</text>
</g>
<!-- verifier&#45;&gt;label_hybrid -->
<!-- verifier&#45;&gt;label_partial -->
<g id="edge6" class="edge">
<title>verifier&#45;&gt;label_hybrid</title>
<path fill="none" stroke="black" d="M861.07,-72C866.44,-72 871.87,-72 877.31,-72"/>
<polygon fill="black" stroke="black" points="877.72,-75.5 887.72,-72 877.72,-68.5 877.72,-75.5"/>
<title>verifier&#45;&gt;label_partial</title>
<path fill="none" stroke="black" d="M996.18,-72C1001.59,-72 1007.03,-72 1012.43,-72"/>
<polygon fill="black" stroke="black" points="1012.77,-75.5 1022.77,-72 1012.77,-68.5 1012.77,-75.5"/>
</g>
<!-- label_ungrounded -->
<g id="node8" class="node">
<title>label_ungrounded</title>
<path fill="#dc3545" stroke="black" d="M1009,-36C1009,-36 928,-36 928,-36 922,-36 916,-30 916,-24 916,-24 916,-12 916,-12 916,-6 922,0 928,0 928,0 1009,0 1009,0 1015,0 1021,-6 1021,-12 1021,-12 1021,-24 1021,-24 1021,-30 1015,-36 1009,-36"/>
<text text-anchor="middle" x="968.5" y="-21.4" font-family="Helvetica,sans-Serif" font-size="12.00" fill="white">UNGROUNDED</text>
<text text-anchor="middle" x="968.5" y="-8.4" font-family="Helvetica,sans-Serif" font-size="12.00" fill="white">none verify</text>
<path fill="#dc3545" stroke="black" d="M1140,-36C1140,-36 1067,-36 1067,-36 1061,-36 1055,-30 1055,-24 1055,-24 1055,-12 1055,-12 1055,-6 1061,0 1067,0 1067,0 1140,0 1140,0 1146,0 1152,-6 1152,-12 1152,-12 1152,-24 1152,-24 1152,-30 1146,-36 1140,-36"/>
<text text-anchor="middle" x="1103.5" y="-21.4" font-family="Helvetica,sans-Serif" font-size="12.00" fill="white">not grounded</text>
<text text-anchor="middle" x="1103.5" y="-8.4" font-family="Helvetica,sans-Serif" font-size="12.00" fill="white">none verify</text>
</g>
<!-- verifier&#45;&gt;label_ungrounded -->
<g id="edge7" class="edge">
<title>verifier&#45;&gt;label_ungrounded</title>
<path fill="none" stroke="black" d="M861.07,-49.49C876.09,-45.05 891.68,-40.44 906.14,-36.16"/>
<polygon fill="black" stroke="black" points="907.35,-39.45 915.94,-33.25 905.36,-32.74 907.35,-39.45"/>
<path fill="none" stroke="black" d="M991.9,-48.47C1009.75,-43.55 1028.18,-38.48 1044.74,-33.91"/>
<polygon fill="black" stroke="black" points="1046.08,-37.17 1054.79,-31.14 1044.22,-30.43 1046.08,-37.17"/>
</g>
<!-- audit -->
<g id="node9" class="node">
<title>audit</title>
<polygon fill="#fde7e9" stroke="black" points="1274,-95.5 1076,-95.5 1076,-48.5 1280,-48.5 1280,-89.5 1274,-95.5"/>
<polyline fill="none" stroke="black" points="1274,-95.5 1274,-89.5 "/>
<polyline fill="none" stroke="black" points="1280,-89.5 1274,-89.5 "/>
<text text-anchor="middle" x="1178" y="-81.9" font-family="Helvetica,sans-Serif" font-size="12.00">audit chain</text>
<text text-anchor="middle" x="1178" y="-68.9" font-family="Helvetica,sans-Serif" font-size="12.00">+ providence cache</text>
<text text-anchor="middle" x="1178" y="-55.9" font-family="Helvetica,sans-Serif" font-size="12.00">(8&#45;dim key, governance&#45;aware)</text>
<polygon fill="#fde7e9" stroke="black" points="1375,-95.5 1211,-95.5 1211,-48.5 1381,-48.5 1381,-89.5 1375,-95.5"/>
<polyline fill="none" stroke="black" points="1375,-95.5 1375,-89.5 "/>
<polyline fill="none" stroke="black" points="1381,-89.5 1375,-89.5 "/>
<text text-anchor="middle" x="1296" y="-81.9" font-family="Helvetica,sans-Serif" font-size="12.00">Audit chain</text>
<text text-anchor="middle" x="1296" y="-68.9" font-family="Helvetica,sans-Serif" font-size="12.00">+ answer cache</text>
<text text-anchor="middle" x="1296" y="-55.9" font-family="Helvetica,sans-Serif" font-size="12.00">(reproducible, replayable)</text>
</g>
<!-- label_strict&#45;&gt;audit -->
<!-- label_grounded&#45;&gt;audit -->
<g id="edge8" class="edge">
<title>label_strict&#45;&gt;audit</title>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M1035.72,-108.77C1048.7,-105.39 1062.59,-101.77 1076.4,-98.18"/>
<polygon fill="#888888" stroke="#888888" points="1077.63,-101.48 1086.43,-95.57 1075.87,-94.7 1077.63,-101.48"/>
<title>label_grounded&#45;&gt;audit</title>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M1168.2,-107.94C1179.18,-104.83 1190.8,-101.54 1202.37,-98.26"/>
<polygon fill="#888888" stroke="#888888" points="1203.39,-101.61 1212.05,-95.51 1201.48,-94.87 1203.39,-101.61"/>
</g>
<!-- label_hybrid&#45;&gt;audit -->
<!-- label_partial&#45;&gt;audit -->
<g id="edge9" class="edge">
<title>label_hybrid&#45;&gt;audit</title>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M1049.13,-72C1054.63,-72 1060.23,-72 1065.85,-72"/>
<polygon fill="#888888" stroke="#888888" points="1065.99,-75.5 1075.99,-72 1065.99,-68.5 1065.99,-75.5"/>
<title>label_partial&#45;&gt;audit</title>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M1184.19,-72C1189.53,-72 1194.94,-72 1200.35,-72"/>
<polygon fill="#888888" stroke="#888888" points="1200.72,-75.5 1210.72,-72 1200.72,-68.5 1200.72,-75.5"/>
</g>
<!-- label_ungrounded&#45;&gt;audit -->
<g id="edge10" class="edge">
<title>label_ungrounded&#45;&gt;audit</title>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M1021.06,-31.42C1038,-35.83 1057.45,-40.89 1076.75,-45.91"/>
<polygon fill="#888888" stroke="#888888" points="1075.94,-49.32 1086.5,-48.45 1077.7,-42.54 1075.94,-49.32"/>
<path fill="none" stroke="#888888" stroke-dasharray="5,2" d="M1152.08,-31.49C1167.19,-35.77 1184.45,-40.66 1201.63,-45.53"/>
<polygon fill="#888888" stroke="#888888" points="1201.15,-49.03 1211.73,-48.39 1203.06,-42.3 1201.15,-49.03"/>
</g>
</g>
</svg>

Before

Width:  |  Height:  |  Size: 10 KiB

After

Width:  |  Height:  |  Size: 9.6 KiB

Before After
Before After