Closes #33. BREAKING for anything that calls these two tools. Both used the standard flag package while numericsurface and upstreamlinks use cobra, so the repository spelled its flags two ways. They now expose RootCmd() *cobra.Command with SilenceUsage, RunE, output through cmd.OutOrStdout(), an osExit variable and POSIX --long flags -- the shape the tests drive with SetArgs/SetOut/SetErr instead of through a subprocess. ⛔ -root IS NO LONGER ACCEPTED, and the failure is loud rather than subtle: $ go run ./tools/conformancefigure -root content/en conformancefigure: unknown shorthand flag: 'r' in -root pflag reads -root as the cluster -r -o -o -t. The one caller outside this repository is the landing page, which runs conformancefigure@v0.1.0 -root layouts: it is pinned, so it keeps working, and its bump moves it to --root in the same wave rather than discovering this later. THE VOCABULARY CONTROL STAYS INSIDE conformancefigure, deliberately, where docexample's -selftest became a test. The difference is who runs them. conformancefigure is used from another repository through `go run ...@vX`, and that consumer never runs this module's tests -- so a control living only in a _test.go would silently stop protecting the landing page, which is the site whose HTML phrasing the vocabulary was extended for. It runs on every invocation AND has a test. docexample has no remote consumer, so its cases are a plain test now and the flag is gone. Its test also asserts the control BITES, in both directions: a case the vocabulary cannot match, and a case it reads as a different figure. A control that cannot fail is the defect it exists to refuse. New tests beyond the moved ones: conformancefigure an unreadable baseline refuses (2); a baseline with no OK rows refuses rather than comparing against a confident 0; a page stating a different total exits 1 naming both figures; a page stating NO total exits 1; a DATED sweep going stale is still not an error; --timeout reaches the HTTP client docexample the extraction cases; both refusals; a positional argument is refused Every package in the module now has tests: 72 subtests run, 0 skipped. All four guards green against content/en -- 4 conformance claims against 23511, 11 examples with 25 answers, 257 names over 11 sections, 12 upstream links. gofmt, go vet, actionlint, credscan clean. Measured 2026-10-21 with go1.27.1 and cobra v1.10.2. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Commits

Commits on Oct 21, 2026

conformancefigure and docexample through cobra; every flag is --long now