architecture / how-everything-is-checked

architecture / how-everything-is-checked

How everything is checked

v0.12.0 · 03 / 05 · 2 min read · docs/ARCHITECTURE.md

Two properties hold across the automated ones: no network (loopback

SurfaceCoversRun
Unit tests (*_test.go)renderer + link positions, search, selection/copy, cache, config, keys, store, navigation (click, back/forward, failures, overtaken loads), extraction scenarios, JS shells and the headless render (a fake browser script, including a timeout that must kill its children), the language guesser, the whole update path (a stub release API, a checksummed archive, refusal of corrupt, mismatched or foreign downloads) and the update windowgo test -race ./...
Extraction audit (scripts/qa/audit.py)70+ real developer-docs URLs through a binary: backslash breaks, empty links, repeated lines, thin pages, shells, and the opening lines of each page (QA round 3)WR=./wr python3 scripts/qa/audit.py --tops
QA corpora (scripts/qa/)460+ real URLs in 10 categories, chroma lexers, synthetic cases, PTY copy — output in qa-out/CORPUS=corpus python3 scripts/qa/harness.py etc.
QA scenario tests (qa_scenarios_test.go)every finding in docs/QA-FINDINGS.md has a test; a meta-test keeps the three in syncgo test -race ./... (WR_QA_STRICT=1 asserts open findings)
--eval9 deterministic offline scenarios (input, extraction, render, links, session navigation, search, store, cache, config) as JSON, exit 1 on failurego run . --eval
MCP smoke (scripts/qa/mcp_smoke.py)the agent protocol end to end against any binary: modern server/discover, legacy handshake, tools/list, reading tools, a full session, configWR=./wr python3 scripts/qa/mcp_smoke.py
Benchmarks (bench_test.go)extraction, render, load path (cache vs no cache), interaction, store, search — local, deterministic, with allocationsgo test -run '^$' -bench . -benchmem

Two properties hold across the automated ones: no network (loopback httptest stands in for the web, for the release API and for the release assets; a shell script stands in for Chromium) and no wall-clock dependence (animations off, synthetic pages). The audit and the QA corpora are the exceptions on purpose: they exist to meet the real web. CI runs gofmt, go mod tidy -diff, go vet, go test -race ./... and go build ./...; the git hooks repeat the fast ones on commit and push.

edit this page on GitHub ↗report a problem ↗