docs: the storage diagram on the warehouse page - #329
Merged
Merged
Conversation
…rDuck are the view
The warehouse page made the argument in prose and never showed it. This adds
the picture, at the top, before "a runner forgets" — four swimlanes carrying
one verdict from a machine that is about to be destroyed to a record that
outlives it:
THE RUN certify · review · a human ruling — all ephemeral
THE STORE one gzipped JSON entry, hash-linked, on corral/ledger;
ledger verify walks it, ledger checkpoint prunes it,
Rekor holds the receipt
THE VIEW DuckDB reading the branch in place over HTTPS, or
ledger push to a local file or md: — 8 tables + corral_seal
QUESTIONS the ones a single run structurally cannot answer
Drawn in the same visual language as docs/design/corral-today.svg and the
adversarial-review diagram: cream boxes are model seats, green are code and
ask no model anything, amber-dashed are stored, red outlines are the
operator's, dotted arrows are read back and never written.
Shipped as a static asset under site/public/diagrams/ and referenced with
<img> rather than inlined. Inlining was the obvious move and is wrong here:
an inline SVG's <style> is NOT scoped to the SVG, and this one styles .t, .s,
.lane, .group, .title and .key — generic enough to leak into the page and
restyle the site. As a separate document it is isolated, cacheable, and
clickable through to full size.
Every number on the plate was read from the live branch on 2026-09-11:
104 entries, 382 KB, 3.6 KB average, ~37 MB projected at 10,000 audits.
The alt text carries the whole flow, because the diagram IS the argument on
this page and a reader who cannot see it would otherwise get nothing.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011NgkB3eLPBhgfqU1XopR1V
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The warehouse page argued branch-as-store in prose and never showed it. This puts the picture at the top, before "a runner forgets."
Four swimlanes, following one verdict from a machine that is about to be destroyed to a record that outlives it:
certify·review· a human ruling — all ephemeralcorral/ledger;ledger verifywalks it,ledger checkpointprunes it, Rekor holds the receiptledger pushto a local file ormd:— 8 tables +corral_sealDrawn in the same visual language as
docs/design/corral-today.svgand the adversarial-review diagram, so it reads as the third plate in that set rather than a one-off: cream boxes are model seats, green are code and ask no model anything, amber-dashed are stored, red outlines are the operator's, dotted arrows are read back and never written.Two decisions worth flagging
Static asset, not inlined. Inlining an SVG is the obvious move and is wrong here — an inline SVG's
<style>is not scoped to the SVG, and this one styles.t,.s,.lane,.group,.titleand.key. Those are generic enough to leak into the page and restyle the site. As a separate document undersite/public/diagrams/it is isolated, cacheable, and clickable through to full size.Full alt text. The diagram is the argument on this page, so the alt carries the whole flow rather than naming the file.
Verification
Every number on the plate was read from the live branch on 2026-09-11 — 104 entries, 382 KB total, 3.6 KB average, ~37 MB projected at 10,000 audits. Site builds (82 pages),
markup.spec.tspasses both cases including its negative control, disclosure guard clean, Go docs gates pass.🤖 Generated with Claude Code
https://claude.ai/code/session_011NgkB3eLPBhgfqU1XopR1V