russell@unturf.com
0aada29a8e
1-pager (docs/_source/arborist-one-pager.rst, 1 page) for AI-literate readers: the trichotomy, the 8-dim cache key, CTI synthetic-elision-impossible, soft-channel separation, real-traffic bench numbers (mis-cite 100% @ 0% FP, warrant 92/92, quote 0.54 STRICT-rate). 2-pager (docs/_source/arborist-two-pager.rst, 3 pages = 2 body + 1 appendix) for technical reviewers: letterhead, Permacomputer Preamble license box, six numbered sections, plus appendix figures (pager-arch-stack 3-layer architecture, pager-verifier-flow question→pointer→verifier→trichotomy). Both pages live under docs/_source/ so the same RST renders into the Sphinx readthedocs site (toctree caption "Summary pages" added to docs/_source/index.rst) AND into standalone PDFs via rst2pdf (docs/pager.style, lazy install into .venv). Makefile targets: docs-one-pager, docs-two-pager, docs-pagers, docs-pagers-clean. Diagrams render through the existing DOT pipeline.
36 lines
1.8 KiB
Text
36 lines
1.8 KiB
Text
// Compact verifier flow for the 2-pager appendix.
|
|
// (Question, source-chunks) → model → (text, pointers) → verifier → label.
|
|
// Render: dot -Tsvg pager-verifier-flow.dot -o pager-verifier-flow.svg
|
|
|
|
digraph verifier_flow {
|
|
rankdir=LR
|
|
ranksep=0.35
|
|
nodesep=0.25
|
|
node [shape=box, style="rounded,filled", fontname="Helvetica", fontsize=12]
|
|
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"]
|
|
|
|
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"]
|
|
|
|
audit [label="audit chain\n+ providence cache\n(8-dim key, governance-aware)", fillcolor="#fde7e9", shape=note]
|
|
|
|
question -> retrieval -> pointers
|
|
pointers -> model
|
|
model -> verifier [label="answer\n+ pointer IDs"]
|
|
verifier -> label_strict
|
|
verifier -> label_hybrid
|
|
verifier -> label_ungrounded
|
|
label_strict -> audit [style=dashed, color="#888888"]
|
|
label_hybrid -> audit [style=dashed, color="#888888"]
|
|
label_ungrounded -> audit [style=dashed, color="#888888"]
|
|
|
|
{rank=same; label_strict; label_hybrid; label_ungrounded}
|
|
}
|