From 4895e2d9306f9cdb51ab1fd7ebaa41eec34d2f8b Mon Sep 17 00:00:00 2001
From: Axel Meyer <axel.meyer@durania.net>
Date: Sat, 16 May 2026 18:01:48 +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 b6c394e..005f03c 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,15 @@ graph LR
 ```
 <!-- topology:end -->
 
+## API
+
+### `run_tests(ctx)`
+**Syntax:** `M.run_tests(ctx)` -> void
+
+**Description:** Test-runner entrypoint. Executes 17 assertions against
+`lib-core.input`. 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):