docs: publish generated public API reference

.github/workflows/docs.yml

@@ -11,6 +11,7 @@ on:
       - "mkdocs.yml"
       - "pyproject.toml"
       - "scripts/validate_docs.py"
+      - "scripts/generate_api_reference.py"
       - "tests/validate.sh"
       - ".github/workflows/docs.yml"
   pull_request:
@@ -21,6 +22,7 @@ on:
       - "mkdocs.yml"
       - "pyproject.toml"
       - "scripts/validate_docs.py"
+      - "scripts/generate_api_reference.py"
       - "tests/validate.sh"
       - ".github/workflows/docs.yml"
   workflow_dispatch:
@@ -52,6 +54,9 @@ jobs:
       - name: Validate repository links and examples
         run: python scripts/validate_docs.py
 
+      - name: Validate generated public API reference
+        run: python scripts/generate_api_reference.py --check
+
       - name: Build documentation with strict warnings
         run: python -m mkdocs build --strict --site-dir site
 

CHANGELOG.md

@@ -30,6 +30,8 @@ and versions are tracked in the repo-root `VERSION` file.
   production-lifecycle positioning for Click and Typer adopters.
 - Add deterministic SPDX SBOMs, artifact checksums, and OIDC-backed GitHub
   attestations to protected release workflows.
+- Add a generated public API reference and a strict CI drift check so every
+  stable facade export remains searchable and documented.
 
 ### Changed
 

README.md

@@ -89,6 +89,8 @@ The supported public facade, compatibility promises, deprecation warning
 mechanism, and migration requirements are documented in
 [`docs/api-stability.md`](https://basefoundry.github.io/base-cli/api-stability/) and
 [`docs/migrations.md`](https://basefoundry.github.io/base-cli/migrations/).
+The complete generated facade is listed in the
+[`public API reference`](https://basefoundry.github.io/base-cli/api-reference/).
 
 Security reporting, runtime trust boundaries, threat assumptions, and the
 release security checklist are documented in [`SECURITY.md`](SECURITY.md),