--- a/hg-web/README.md	Sun Aug 02 09:07:36 2026 -0700
+++ b/hg-web/README.md	Sun Aug 02 10:07:40 2026 -0700
@@ -169,10 +169,18 @@
 ```bash
 bazel build //hg-web:hg_web_server
 bazel build //hg-web:hg_web_server_bundle
+bazel test //hg-web:tests
 bazel test //markdown_converter/tests:markdown_to_html_test
 bazel test //seobeo/tests:all
 ```
 
+`//hg-web:tests` creates a temporary two-commit Mercurial repository and runs
+the application in pinned Chromium through Playwright. It covers shell routes,
+files and README rendering, graph and changeset navigation, browser history,
+console and page errors, API validation, Mercurial wire protocol, Markdown
+script escaping, static assets, and backend outages. The test invokes the
+workspace Mercurial CLI with an isolated configuration and home directory.
+
 Build and run the complete local stack with one Bazel command:
 
 ```bash