@softspark/ai-toolkit 4.30.3 → 4.31.0

package/kb/procedures/{release-preparation-sop.md → sop-release.md}

@@ -13,7 +13,7 @@ description: "Step-by-step checklist for preparing a new ai-toolkit release —
 
 Complete checklist for preparing a new `@softspark/ai-toolkit` release.
 Run this **before** tagging. After tagging and publishing, run the
-[Release Verification SOP](release-verification-sop.md) to smoke-test.
+[Release Verification SOP](sop-release-verification.md) to smoke-test.
 
 **Pipeline:**
 ```
@@ -32,10 +32,10 @@ git tag → CI publish → Release Verification SOP
 
 ```bash
 # 0. Ecosystem sync (mandatory for minor/major releases; optional for patch)
-#    Full procedure: kb/procedures/ecosystem-sync-sop.md
+#    Full procedure: kb/procedures/sop-ecosystem-sync.md
 python3 scripts/ecosystem_doctor.py --format text > /tmp/eco-report.txt
 cat /tmp/eco-report.txt
-# If drift detected: stop here, follow ecosystem-sync-sop.md Phase 2-4 to
+# If drift detected: stop here, follow sop-ecosystem-sync.md Phase 2-4 to
 # classify each drift (A-F), update generators as needed, refresh snapshot,
 # THEN resume this SOP.
 python3 scripts/ecosystem_doctor.py --update    # after all drift resolved
@@ -126,7 +126,7 @@ Output classifies every registered tool as **Clean**, **Drift**, or **Errored**.
 
 ### 0.2 Act on drift
 
-For each drifting tool, follow [ecosystem-sync-sop.md](ecosystem-sync-sop.md) Phase 2-4:
+For each drifting tool, follow [sop-ecosystem-sync.md](sop-ecosystem-sync.md) Phase 2-4:
 
 | Drift class | Release impact |
 |-------------|----------------|
@@ -195,7 +195,7 @@ The canonical version lives in `package.json`. These files **must** match:
 
 | File | Field | When to update |
 |------|-------|---------------|
-| `kb/procedures/maintenance-sop.md` | frontmatter `version:` | If SOP content changed |
+| `kb/procedures/sop-maintenance.md` | frontmatter `version:` | If SOP content changed |
 | `kb/reference/skills-catalog.md` | frontmatter `version:` | If skills added/removed |
 | `kb/reference/agents-catalog.md` | frontmatter `version:` | If agents added/removed |
 | `kb/reference/hooks-catalog.md` | frontmatter `version:` | If hooks changed |
@@ -591,7 +591,7 @@ This triggers `.github/workflows/publish.yml` which:
 
 **Provenance is non-negotiable.** If `id-token: write` permission or the `--provenance` flag is missing from `publish.yml`, fix it BEFORE tagging — an unsigned release is a regression against the v2.8.0 standard.
 
-**After CI completes:** Run the [Release Verification SOP](release-verification-sop.md)
+**After CI completes:** Run the [Release Verification SOP](sop-release-verification.md)
 to smoke-test the published package AND verify the provenance attestation landed on npm.
 
 ---

package/kb/reference/architecture-overview.md

@@ -228,7 +228,7 @@ Three tiers determine how to approach a task:
 |------|-------|-----------|-------|
 | Task | `disable-model-invocation: true` | User via `/skill` only | 32 |
 | Hybrid | (neither) | User via `/skill` + agent knowledge | 31 |
-| Knowledge | `user-invocable: false` | Claude auto-loads | 46 |
+| Knowledge | `user-invocable: false` | Claude auto-loads | 51 |
 
 ## Multi-Agent Execution
 

package/kb/reference/copilot-compatibility.md

@@ -159,7 +159,7 @@ running the generators directly:
 
 - `scripts/generate_copilot.py` / `generate_copilot_hooks.py` contract tests
   (`tests/test_copilot.bats`, `tests/test_copilot_hooks.bats`).
-- Release layout check in `kb/procedures/release-verification-sop.md` asserts the
+- Release layout check in `kb/procedures/sop-release-verification.md` asserts the
   `.github/{agents,skills,instructions,prompts,hooks}` surfaces.
 - `validate.py --strict` + `audit_skills.py --ci` in CI.
 

package/kb/reference/licensing.md

@@ -131,7 +131,7 @@ MIT remnant would need each contributor's agreement.
 
 It is a test rather than a checklist line on purpose. This project has two
 same-day postmortems about SOPs that existed and were skipped; CI does not skip.
-[Release Preparation](../procedures/release-preparation-sop.md) Phase 5c runs the
+[Release Preparation](../procedures/sop-release.md) Phase 5c runs the
 same gate before tagging so a failure surfaces before the tag, not after.
 
 ## If the licence ever changes again
@@ -144,5 +144,5 @@ source, cross-verify against a second independent copy, and only then write
 ## Related
 
 - [`LICENSE`](../../LICENSE), [`NOTICE`](../../NOTICE)
-- [Release Preparation SOP](../procedures/release-preparation-sop.md) — Phase 5c
+- [Release Preparation SOP](../procedures/sop-release.md) — Phase 5c
 - [Distribution Model](distribution-model.md) — what ships and where

package/kb/reference/quick-wins-implementation-summary.md

@@ -53,7 +53,7 @@ Updated baseline docs:
 - `kb/reference/skills-catalog.md`
 - `kb/reference/plugin-pack-conventions.md`
 - `kb/reference/claude-ecosystem-benchmark-snapshot.md`
-- `kb/procedures/maintenance-sop.md`
+- `kb/procedures/sop-maintenance.md`
 
 ## Validation Evidence
 

package/kb/reference/supported-tools-registry.md

@@ -285,13 +285,13 @@ See [DSH Compatibility](./dsh-compatibility.md) for commands, topology, subscrip
 2. Delete its section from this document.
 3. Delete its snapshot entry from `benchmarks/ecosystem-doctor-snapshot.json` (or let the next `--update` prune it — currently not pruned automatically).
 4. Decide whether to keep the generator (`scripts/generate_<tool>_*.py`) for backwards compatibility or delete it.
-5. Remove references from `README.md`, `manifest.json` `description` field, and `kb/procedures/maintenance-sop.md` `Supported editors` line.
+5. Remove references from `README.md`, `manifest.json` `description` field, and `kb/procedures/sop-maintenance.md` `Supported editors` line.
 
 ---
 
 ## Related
 
-- [Ecosystem Sync SOP](../procedures/ecosystem-sync-sop.md) — how to use the doctor
+- [Ecosystem Sync SOP](../procedures/sop-ecosystem-sync.md) — how to use the doctor
 - [MCP Editor Compatibility](./mcp-editor-compatibility.md) — MCP-specific subset
 - `scripts/ecosystem_tools.json` — source of truth
 - `scripts/ecosystem_doctor.py` — drift detector

package/kb/troubleshooting/plugin-double-load.md

@@ -94,4 +94,4 @@ Expect `Total plugin skills loaded: 0`, `Total plugin agents loaded: 0`, and the
 ## Related
 
 - `kb/reference/global-install-model.md`
-- `kb/procedures/maintenance-sop.md`
+- `kb/procedures/sop-maintenance.md`