From ed3418781c07d4c30ac2461a102cb44e4ce60656 Mon Sep 17 00:00:00 2001
From: Axel Meyer <axel.meyer@durania.net>
Date: Sat, 16 May 2026 18:01:46 +0200
Subject: [PATCH] docs: add API section documenting run_tests entrypoint

Test-lib README now declares its public surface (M.run_tests) so the
doc-convention lint passes structural validation. Brings parity with
maps-test which already has this section.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index 40e9c89..9a46dcc 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,15 @@ graph LR
 ```
 <!-- topology:end -->
 
+## API
+
+### `run_tests(ctx)`
+**Syntax:** `M.run_tests(ctx)` -> void
+
+**Description:** Test-runner entrypoint. Executes 25 assertions against
+`lib-core.command`. Called automatically by the engine's
+`--test-libs=` orchestrator. Exits via `engine.exit(engine.test.failures())`.
+
 ## Coverage Statement
 
 Per Fault-Injection-Audit-Convention (2026-05-16):