| Surface | Covers | Run |
|---|---|---|
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 window | go 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 sync | go test -race ./... (WR_QA_STRICT=1 asserts open findings) |
--eval | 9 deterministic offline scenarios (input, extraction, render, links, session navigation, search, store, cache, config) as JSON, exit 1 on failure | go 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, config | WR=./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 allocations | go 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.