refactor: restructure docs/generate.py into a Python sub-project

Replaces the monolithic 361-line script with a proper Python package
(toolbox_docs) with separated concerns: sorting, models, scanner,
renderer, and template/CSS assets. Adds 21 tests across sorting,
scanning, rendering, and integration. Output is byte-identical to
the original script.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: sigma

.github/workflows/docs.yml

@@ -18,7 +18,23 @@ env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
 
 jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install with dev dependencies
+        run: pip install docs/[dev]
+
+      - name: Run tests
+        run: pytest docs/tests/ -v
+
   build:
+    needs: test
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -27,8 +43,11 @@ jobs:
         with:
           python-version: "3.12"
 
+      - name: Install docs package
+        run: pip install --quiet docs/
+
       - name: Generate documentation
-        run: python docs/generate.py
+        run: python -m toolbox_docs
 
       - uses: actions/upload-pages-artifact@v4
         with:

.gitignore

@@ -4,3 +4,7 @@ result-*
 .direnv
 .claude/
 docs/_site/
+__pycache__/
+*.pyc
+*.egg-info/
+.pytest_cache/