Framework hardening

.github/workflows/unit-tests.yml

@@ -0,0 +1,18 @@
+name: Framework unit tests
+
+on:
+  push:
+
+permissions:
+  contents: read
+
+jobs:
+  unit-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Run framework unit tests
+        run: python3 -m unittest discover -s tests

.github/workflows/validate.yml

@@ -2,8 +2,6 @@ name: Validate framework
 
 on:
   pull_request:
-  push:
-    branches: [main]
 
 permissions:
   contents: read
@@ -18,7 +16,7 @@ jobs:
           python-version: "3.11"
       - name: Compile tools
         run: python3 -m py_compile framework/tools/*.py install.py
-      - name: Run framework regression tests
+      - name: Run framework unit tests
         run: python3 -m unittest discover -s tests
       - name: Install and lint sanitized example
         run: |
@@ -28,7 +26,9 @@ jobs:
           python3 "$vault/tools/contracts.py" lint
           test -f "$vault/skills/dtm/SKILL.md"
           test -f "$vault/skills/voice/SKILL.md"
+          test -f "$vault/tools/workspaces.py"
           python3 "$vault/tools/wiki.py" lint
           python3 "$vault/tools/dtm.py" lint
+          python3 "$vault/tools/workspaces.py" lint
           python3 "$vault/tools/documents.py" lint
           python3 "$vault/tools/writing.py" lint

CHANGELOG.md

@@ -7,6 +7,12 @@ for tagged releases.
 
 No unreleased changes.
 
+## [2026-09-15]
+
+### Added
+
+- Publish workspace-index generation and lint tooling, with regression coverage for project and work indexes.
+
 ## [2026-09-08]
 
 ### Added

CONTRIBUTING.md

@@ -19,6 +19,7 @@ tmpdir="$(mktemp -d)"
 python3 install.py --vault "$tmpdir"
 python3 "$tmpdir/tools/wiki.py" lint
 python3 "$tmpdir/tools/dtm.py" lint
+python3 "$tmpdir/tools/workspaces.py" lint
 python3 "$tmpdir/tools/documents.py" lint
 python3 "$tmpdir/tools/writing.py" lint
 ```

docs/installation.md

@@ -88,6 +88,7 @@ the dependencies are installed.
 python3 tools/contracts.py lint
 python3 tools/wiki.py lint
 python3 tools/dtm.py lint
+python3 tools/workspaces.py lint
 python3 tools/documents.py lint
 python3 tools/writing.py lint
 ```

framework/publication-manifest.json

@@ -9,6 +9,7 @@
     {"source": "contracts", "destination": "framework/contracts"},
     {"source": "tools/wiki.py", "destination": "framework/tools/wiki.py"},
     {"source": "tools/dtm.py", "destination": "framework/tools/dtm.py"},
+    {"source": "tools/workspaces.py", "destination": "framework/tools/workspaces.py"},
     {"source": "tools/contracts.py", "destination": "framework/tools/contracts.py"},
     {"source": "tools/documents.py", "destination": "framework/tools/documents.py"},
     {"source": "tools/document_deliverables.py", "destination": "framework/tools/document_deliverables.py"},