bash tests/test_install_doc.sh # structure + live checks
bash tests/test_install_doc.sh --offline # structure only, no network
make test-doc
Two layers:
FAIL — local, deterministic: code-fence balance, internal section
references resolve, file-listing paths exist in repo, key tokens
(npm pkg, NodeSource URL, repo URL) present, model slugs
consistent between manual and profiles.example.yml.
WARN — online, flaky-tolerant: npm package resolves, NodeSource/nvm
URLs reachable, OpenRouter slugs still in the public model list.
A transient outage is a warning, not a failure.
Catches the failure classes that silently crept in before: a referenced
section number that no longer exists, a repo path renamed without updating
the manual, a stale npm package name, a renamed model slug.
Co-Authored-By: Claude <noreply@anthropic.com>
