da18ab2237
Phase 7 is mostly authored assets. This commit is the asset half; the
template half is a Builder child issue because this phase must not write
application code.
DoD items satisfied or advanced:
- [x] Eight diagrams present, both themes, readable at 1x and on mobile
8 SVGs, one byte-identical <style> block across all 8 (one visual
language by construction). Light and dark resolve from a single file
via prefers-color-scheme, verified per file in Chrome: 8/8 return two
distinct palettes. Geometry verified with getBBox(), not estimated:
0 findings after fixing 74 (text overflow, partial overlap, empty
text, out-of-viewBox). Mobile type at the 900px minimum is 14.1/12.2px.
- [x] Six code exhibits with a two-sentence rationale each
212 verbatim lines across five eras, copied with cp/sed from the
read-only archive. Every rationale is exactly two sentences about why
the code is good; every exhibit also carries an honest_note, and where
the code is not good the note says so (the 3,400-line procedural PHP
script is presented for its operational judgement, not its structure).
- [~] Every image optimised; total page weight budgeted and recorded
BUDGET.md records measured raw and gzip weights for all 15 served
files: 63,802 B raw / 13,220 B gzipped. Zero rasters by design. Page
weight of a real page is not measurable until Phase 2 templates and
Phase 3 serving exist, and is recorded as open rather than asserted.
- [x] Archive never linked or exposed
No mount paths or volume names under content/. Provenance recorded as
"private archive, path withheld".
- [ ] Client wall reads as deliberate -> needs markup/CSS (Builder)
- [ ] Lighthouse held at >= 95/95 -> needs a served page (Phase 3)
Also: the client wall is authored as data (45 entries, 44 distinct names) with
the 45-vs-46 discrepancy and the Diajio -> Diageo correction recorded
rather than papered over. No commercial marks are enabled: that is a
permission decision for Sam, so availability is recorded and permission is not
implied.
107 lines
6.8 KiB
XML
107 lines
6.8 KiB
XML
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 960 540" width="960" height="540" role="img" aria-labelledby="ttl dsc">
|
|
<title id="ttl">Retrieval pipeline</title>
|
|
<desc id="dsc">Left, offline ingest: content files are validated, chunked with metadata, embedded and upserted into Qdrant, while the same files render to static pages with no AI in the path. Right, per-visitor query: guardrail, query graph, filtered retrieval, then a streamed answer with citations.</desc>
|
|
<style>
|
|
text{font-family:ui-sans-serif,-apple-system,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;fill:#1b222b;font-size:15px}
|
|
.hd{font-size:15px;font-weight:600}
|
|
.sub{font-size:13px;fill:#5b6673}
|
|
.cap{font-size:12px;fill:#5b6673;letter-spacing:.06em;text-transform:uppercase;font-weight:600}
|
|
.big{font-size:19px;font-weight:600}
|
|
.node{fill:#f4f6f8;stroke:#c3ccd6;stroke-width:1.4}
|
|
.node-a{fill:#e9f1fd;stroke:#1a6bc4;stroke-width:1.4}
|
|
.node-t{fill:#e6f4f2;stroke:#0f766e;stroke-width:1.4}
|
|
.node-w{fill:#fdf1e3;stroke:#b45309;stroke-width:1.4}
|
|
.zone{fill:none;stroke:#aab4c0;stroke-width:1.4;stroke-dasharray:7 6}
|
|
.rule{stroke:#d0d7df;stroke-width:1}
|
|
.ln{stroke:#6b7684;stroke-width:1.6;fill:none}
|
|
.ln.d{stroke-dasharray:6 5}
|
|
.ln.a{stroke:#1a6bc4}
|
|
.ln.t{stroke:#0f766e}
|
|
.ln.w{stroke:#b45309}
|
|
.mN{fill:#6b7684}
|
|
.mA{fill:#1a6bc4}
|
|
.mT{fill:#0f766e}
|
|
.mW{fill:#b45309}
|
|
.dot{fill:#6b7684}
|
|
.tick{stroke:#aab4c0;stroke-width:1.2}
|
|
@media (prefers-color-scheme: dark){
|
|
text{fill:#e7edf4}
|
|
.sub,.cap{fill:#98a4b3}
|
|
.node{fill:#182028;stroke:#35424f}
|
|
.node-a{fill:#11253d;stroke:#5aa2f0}
|
|
.node-t{fill:#0d2624;stroke:#38b3a6}
|
|
.node-w{fill:#2a1d10;stroke:#d98b3f}
|
|
.zone{stroke:#43525f}
|
|
.rule{stroke:#2c3743}
|
|
.ln{stroke:#8496a6}
|
|
.ln.a{stroke:#5aa2f0}
|
|
.ln.t{stroke:#38b3a6}
|
|
.ln.w{stroke:#d98b3f}
|
|
.mN{fill:#8496a6}
|
|
.mA{fill:#5aa2f0}
|
|
.mT{fill:#38b3a6}
|
|
.mW{fill:#d98b3f}
|
|
.dot{fill:#8496a6}
|
|
.tick{stroke:#43525f}
|
|
}
|
|
</style>
|
|
<defs>
|
|
<marker id="aN" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path class="mN" d="M0,0 L10,5 L0,10 z"/></marker>
|
|
<marker id="aA" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path class="mA" d="M0,0 L10,5 L0,10 z"/></marker>
|
|
<marker id="aT" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path class="mT" d="M0,0 L10,5 L0,10 z"/></marker>
|
|
<marker id="aW" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path class="mW" d="M0,0 L10,5 L0,10 z"/></marker>
|
|
</defs>
|
|
<text x="24" y="40" class="big">Retrieval pipeline — ingest and query, side by side</text>
|
|
<path d="M480,64 L480,470" class="zone"/>
|
|
<text x="40" y="76" class="cap">ingest — runs offline</text>
|
|
<text x="504" y="76" class="cap">query — runs per visitor</text>
|
|
<rect x="40" y="92" width="250" height="48" rx="7" class="node "/>
|
|
<text x="165.0" y="114.0" class="hd" text-anchor="middle">content/ in git</text>
|
|
<text x="165.0" y="132.0" class="sub" text-anchor="middle">Markdown + front-matter + assets</text>
|
|
<path d="M165.0,140 L165.0,164" class="ln " marker-end="url(#aN)"/>
|
|
<rect x="40" y="164" width="250" height="48" rx="7" class="node "/>
|
|
<text x="165.0" y="186.0" class="hd" text-anchor="middle">validate front-matter</text>
|
|
<text x="165.0" y="204.0" class="sub" text-anchor="middle">schema is frozen; build fails closed</text>
|
|
<path d="M165.0,212 L165.0,236" class="ln " marker-end="url(#aN)"/>
|
|
<rect x="40" y="236" width="250" height="48" rx="7" class="node "/>
|
|
<text x="165.0" y="258.0" class="hd" text-anchor="middle">chunk + tag metadata</text>
|
|
<text x="165.0" y="276.0" class="sub" text-anchor="middle">area · level · confidence · period</text>
|
|
<path d="M165.0,284 L165.0,308" class="ln " marker-end="url(#aN)"/>
|
|
<rect x="40" y="308" width="250" height="48" rx="7" class="node node-t"/>
|
|
<text x="165.0" y="330.0" class="hd" text-anchor="middle">embed via OmniRoute</text>
|
|
<text x="165.0" y="348.0" class="sub" text-anchor="middle">one gateway, one trace log</text>
|
|
<path d="M165.0,356 L165.0,380" class="ln t" marker-end="url(#aT)"/>
|
|
<rect x="180" y="380" width="300" height="56" rx="7" class="node node-t"/>
|
|
<text x="330.0" y="406.0" class="hd" text-anchor="middle">Qdrant — payload-filtered store</text>
|
|
<text x="330.0" y="424.0" class="sub" text-anchor="middle">one point per chunk</text>
|
|
<rect x="40" y="400" width="116" height="64" rx="7" class="node node-a"/>
|
|
<text x="98.0" y="430.0" class="hd" text-anchor="middle">templ build</text>
|
|
<text x="98.0" y="448.0" class="sub" text-anchor="middle">Mode A pages</text>
|
|
<path d="M98,212 L98,400" class="ln a" marker-end="url(#aA)"/>
|
|
<text x="98.0" y="299.0" class="sub" text-anchor="middle">same file</text>
|
|
<text x="106" y="300" class="sub">no AI in this path</text>
|
|
<text x="106" y="318" class="sub">(acceptance test A1)</text>
|
|
<rect x="504" y="92" width="250" height="48" rx="7" class="node "/>
|
|
<text x="629.0" y="114.0" class="hd" text-anchor="middle">visitor prompt</text>
|
|
<text x="629.0" y="132.0" class="sub" text-anchor="middle">plain English, untrusted</text>
|
|
<path d="M629.0,140 L629.0,164" class="ln w" marker-end="url(#aW)"/>
|
|
<rect x="504" y="164" width="250" height="48" rx="7" class="node node-w"/>
|
|
<text x="629.0" y="186.0" class="hd" text-anchor="middle">guardrail: classify → allow / deny</text>
|
|
<text x="629.0" y="204.0" class="sub" text-anchor="middle">fails closed, no tools, no write path</text>
|
|
<path d="M629.0,212 L629.0,236" class="ln " marker-end="url(#aN)"/>
|
|
<rect x="504" y="236" width="250" height="48" rx="7" class="node "/>
|
|
<text x="629.0" y="258.0" class="hd" text-anchor="middle">LangGraph query graph</text>
|
|
<text x="629.0" y="276.0" class="sub" text-anchor="middle">route → retrieve → cite → compose</text>
|
|
<path d="M629.0,284 L629.0,308" class="ln " marker-end="url(#aN)"/>
|
|
<rect x="504" y="308" width="250" height="48" rx="7" class="node "/>
|
|
<text x="629.0" y="330.0" class="hd" text-anchor="middle">retrieve: top-k, filtered by area</text>
|
|
<text x="629.0" y="348.0" class="sub" text-anchor="middle">filtered before it is searched</text>
|
|
<path d="M629.0,356 L629.0,380" class="ln " marker-end="url(#aN)"/>
|
|
<rect x="504" y="380" width="250" height="56" rx="7" class="node node-a"/>
|
|
<text x="629.0" y="406.0" class="hd" text-anchor="middle">SSE stream + citations</text>
|
|
<text x="629.0" y="424.0" class="sub" text-anchor="middle">first token <4 s · every claim cited</text>
|
|
<path d="M480,408 L504,408" class="ln " marker-end="url(#aN)"/>
|
|
<text x="24" y="492" class="sub">Ingest and query share one store and one schema.</text>
|
|
<text x="24" y="512" class="sub">Static pages and corpus are built from the same files, so the two modes cannot drift.</text>
|
|
</svg>
|