Give the README a wordmark and two diagrams - #1
Conversation
The README argued for reproducibility in prose alone. Two of its claims are
structural and read better as pictures: that every pin is resolved before a
single rule runs, and that the three tiers never merge.
Adds four hand-authored SVGs under docs/Images/readme/, following the visual
grammar already established by the Crux daemon README so the two repositories
read as siblings — one monospace stack with no webfonts, since GitHub sanitises
SVG and will not fetch one; a dark panel with corner washes; glass panes with
accent bars; and the same accent palette throughout.
probecrux-{light,dark}.svg the wordmark. The CRUX half is Crux's own glyph
geometry translated rather than redrawn, so the
two marks are identical where they overlap; PROBE
is constructed to the same metrics (699 cap
height, 179-unit stem).
how-it-works.svg acquire, pin, scan, evaluate, with the
deterministic, heuristic and advisory tiers drawn
as visibly separate panes.
receipt.svg what the receipt attests set against what it does
not, plus the project and operator key classes.
Both canonical quotes are reproduced verbatim in receipt.svg and left in the
prose as well, so neither the manifest wording nor a text search for it depends
on an image.
No existing wording changed. The status and pre-1.0 rule-identifier warnings
keep their position directly beneath the hero.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The manifest holds eighteen rules, fifteen of them deterministic. The README still said seventeen and fourteen, and the previous commit hardened that into two SVGs — where it costs an image re-export to fix rather than a one-line edit. Corrected in the hero, the rule-set section, the tier table, the pipeline diagram and its alt text. The drift predates this branch: R018 was minted and R004 widened without the README following. Nothing tests the README's counts against the parsed manifest, which is precisely the failure R002 exists to detect — a document that has drifted is worse than no document, because it tells a reader the work was done. `crates/probecrux-manifest/tests/rules_manifest.rs` already asserts 18 and 15; only the prose was unguarded. Also corrects `docs/architecture.md`, which counted fourteen deterministic rules in its v1-scope section. Its per-rule ordering and deferral lists are left alone — those are scope decisions, not a count, and are not mine to guess at. receipt.svg was rendering `does_not_attest` without its last two sentences — "ProbeCrux reports findings for triage. It does not issue assurance." Those are the two doing the heaviest lifting, one naming what the tool is and the other the strongest disclaimer in the project, and a diagram is the worst place to shorten a string the manifest requires verbatim. Both panels are rewrapped to a common measure; the full wording now fits without changing the layout, and the aria-label carries it too. The pipeline diagram's badge now reads "no network during evaluation" rather than "no network during a run". Since D023 the container makes two calls around evaluation for the hosted input path, and it ships curl to do it. The narrower claim is the one that survives someone reading the Dockerfile. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
Pushed Counts. Verified against One place beyond your list had the same drift:
Worth noting the same shape exists in the README prose and I have not touched it: the D023. Badge now reads The test. Leaving it to you as you said you'd add it at merge, so we don't both write it. If you'd rather I did, say so. Both diagrams re-rendered in headless Chromium and checked at size after the edits. |
Two of the README's claims are structural and read better as pictures: that every pin is resolved before a single rule runs, and that the three tiers never merge. This adds artwork for both, plus a wordmark.
The visual grammar is taken from the Crux daemon README so the two repositories read as siblings: one monospace stack, a dark panel with corner washes, glass panes with accent bars, the same accent palette. No webfonts and no external references anywhere — GitHub sanitises SVG and will not fetch one, so a linked font would silently fall back.
What is here
docs/Images/readme/probecrux-{light,dark}.svgCRUXhalf is Crux's own glyph geometry translated rather than redrawn, so the two marks are identical where they overlap.PROBEis constructed to the same metrics — 699 cap height, 179-unit stem, matching optical gaps.docs/Images/readme/how-it-works.svgdocs/architecture.md.docs/Images/readme/receipt.svgprojectandoperatorkey classes.docs/Images/readme/CueCrux-Arc-Loop{,-White}.pngWhat did not change
No existing wording. Both canonical quotes appear verbatim in
receipt.svgand remain in the prose, so neither the manifest wording nor a text search for it depends on an image. The status warning and the pre-1.0 rule-identifier warning keep their position directly beneath the hero — the hero does not bury them.Worth a look while reviewing
NOTICEfile. Crux's carries a trade-marks clause covering these marks. This PR does not add one; it probably should exist before the repository gets much public traffic. Happy to add it here or separately.prefers-color-scheme.width="339", which puts its cap height at roughly 36 px — the same optical size asCRUXat Crux'swidth="216".How it was checked
Every file was rendered in headless Chromium and inspected at size, in both GitHub themes. That pass caught two defects worth naming: the
Pwas derived from theRand kept the point where the leg springs off, leaving a spur and a sloped bowl underside; and an earlier revision routed a wire through two of the tier panes. Both are fixed here.The SVGs were drafted with GPT-5.6 against an extracted style contract, then reviewed and corrected by hand — the two defects above were found and fixed in review, not by the generator.
🤖 Generated with Claude Code