docguard-cli 0.40.4__tar.gz → 0.40.5__tar.gz

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/.agent/skills/docguard-fix/SKILL.md

@@ -6,10 +6,10 @@ description: AI-driven documentation repair with structured research workflow, t
 compatibility: Requires DocGuard CLI installed (npm i -g docguard-cli or npx docguard-cli)
 metadata:
   author: docguard
-  version: 0.40.4
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-fix
 ---
-<!-- docguard:version: 0.40.4 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Fix Skill
 

{docguard_cli-0.40.4/extensions/spec-kit-docguard → docguard_cli-0.40.5/.agent}/skills/docguard-guard/SKILL.md

@@ -7,10 +7,10 @@ description: Run DocGuard guard validation against Canonical-Driven Development
 compatibility: Requires DocGuard CLI installed (npm i -g docguard-cli or npx docguard-cli)
 metadata:
   author: docguard
-  version: 0.40.4
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-guard
 ---
-<!-- docguard:version: 0.40.4 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Guard Skill
 

{docguard_cli-0.40.4/extensions/spec-kit-docguard → docguard_cli-0.40.5/.agent}/skills/docguard-review/SKILL.md

@@ -6,10 +6,10 @@ description: Cross-document consistency analysis and quality assessment. Perform
 compatibility: Requires DocGuard CLI installed (npm i -g docguard-cli or npx docguard-cli)
 metadata:
   author: docguard
-  version: 0.40.4
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-review
 ---
-<!-- docguard:version: 0.40.4 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Review Skill
 

{docguard_cli-0.40.4/extensions/spec-kit-docguard → docguard_cli-0.40.5/.agent}/skills/docguard-score/SKILL.md

@@ -6,10 +6,10 @@ description: CDD maturity assessment with category-aware improvement roadmap. Ru
 compatibility: Requires DocGuard CLI installed (npm i -g docguard-cli or npx docguard-cli)
 metadata:
   author: docguard
-  version: 0.40.4
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-score
 ---
-<!-- docguard:version: 0.40.4 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Score Skill
 

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/.agent/skills/docguard-sync/SKILL.md

@@ -4,10 +4,10 @@ description: Keep canonical documentation ALWAYS UP TO DATE. Refreshes code-trut
 compatibility: Requires DocGuard CLI installed (npm i -g docguard-cli or npx docguard-cli)
 metadata:
   author: docguard
-  version: 0.40.4
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-sync
 ---
-<!-- docguard:version: 0.40.4 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Sync Skill
 

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/.docguard-specs.json

@@ -423,12 +423,12 @@
           {
             "requirementId": "FR-018",
             "file": "tests/hooks-contract.test.mjs",
-            "line": 11
+            "line": 13
           },
           {
             "requirementId": "FR-019",
             "file": "tests/hooks-contract.test.mjs",
-            "line": 12
+            "line": 14
           },
           {
             "requirementId": "FR-020",

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/.wolf/buglog.json

@@ -5781,6 +5781,82 @@
       "related_bugs": [],
       "occurrences": 5,
       "last_seen": "2026-09-15T03:05:00.000Z"
+    },
+    {
+      "id": "bug-349",
+      "timestamp": "2026-09-15T03:45:00.000Z",
+      "error_message": "The published Spec Kit extension installed successfully while fix and review resolved to the wrong command files and three shipped commands were undeclared",
+      "file": "extensions/spec-kit-docguard/extension.yml",
+      "root_cause": "The installer validated manifest syntax and file existence but the repository had no contract test for one-to-one command identity or completeness against the shipped commands directory",
+      "fix": "Map each namespaced command to its same-named file, declare init/sync/trace, add a read-only review command, and enforce unique complete name-to-file registration in tests",
+      "tags": [
+        "release",
+        "spec-kit",
+        "manifest",
+        "command-routing",
+        "packaging"
+      ],
+      "related_bugs": [
+        "bug-311",
+        "bug-331"
+      ],
+      "occurrences": 1,
+      "last_seen": "2026-09-15T03:45:00.000Z"
+    },
+    {
+      "id": "bug-350",
+      "timestamp": "2026-09-15T03:52:00.000Z",
+      "error_message": "The published extension manifest description exceeded Spec Kit's documented 200-character limit and differed from the catalog description",
+      "file": "extensions/spec-kit-docguard/extension.yml; .github/scripts/speckit-submission.py",
+      "root_cause": "The installer accepted the overlong value and the manifest and catalog generator maintained independent untested descriptions",
+      "fix": "Use one bounded description on both surfaces and test exact parity plus the upstream length limit",
+      "tags": [
+        "release",
+        "spec-kit",
+        "manifest",
+        "catalog",
+        "metadata"
+      ],
+      "related_bugs": [
+        "bug-311",
+        "bug-349"
+      ],
+      "occurrences": 1,
+      "last_seen": "2026-09-15T03:52:00.000Z"
+    },
+    {
+      "id": "bug-351",
+      "timestamp": "2026-09-15T04:00:00.000Z",
+      "error_message": "gh pr diff rejected the unsupported --check flag during self-review",
+      "file": "session GitHub CLI commands",
+      "root_cause": "The whitespace-check flag belongs to git diff, not gh pr diff",
+      "fix": "Use git diff --check for whitespace validation and gh pr diff --patch or --name-only for pull-request review",
+      "tags": [
+        "tooling",
+        "github-cli",
+        "self-review"
+      ],
+      "related_bugs": [],
+      "occurrences": 1,
+      "last_seen": "2026-09-15T04:00:00.000Z"
+    },
+    {
+      "id": "bug-352",
+      "timestamp": "2026-09-15T04:15:00.000Z",
+      "error_message": "A passing freshness assertion failed the v0.40.5 release gate when temporary Git repository cleanup raised ENOTEMPTY",
+      "file": "tests/freshness.test.mjs",
+      "root_cause": "The suite removed Git object directories with a single rmSync attempt even though filesystem and antivirus activity can transiently repopulate or retain entries during recursive deletion",
+      "fix": "Use Node's bounded maxRetries and retryDelay options for recursive cleanup, matching the repository's established Git-fixture cleanup pattern",
+      "tags": [
+        "tests",
+        "release",
+        "filesystem",
+        "flaky-test",
+        "cleanup"
+      ],
+      "related_bugs": [],
+      "occurrences": 1,
+      "last_seen": "2026-09-15T04:15:00.000Z"
     }
   ]
 }

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/.wolf/cerebrum.md

@@ -14,6 +14,8 @@
 
 ## Key Learnings
 
+- **2026-09-15 — A successful Spec Kit install does not prove manifest correctness.** The v0.40.4 ZIP passed validation and installed, yet `fix` resolved to `generate`, `review` resolved to `diagnose`, three shipped command files were absent from `provides.commands`, and its description exceeded the documented 200-character limit. Treat the manifest as an executable public API: require unique names and files, match every `speckit.docguard.<verb>` to `commands/<verb>.md`, compare declarations with the complete shipped directory, keep catalog metadata byte-aligned, and inspect the installed inventory before catalog submission.
+
 - **2026-09-14 — Release-generated skill parity:** The scheduled release updates extension skill metadata through `fix --write`, whose headless mode correctly skips setup. It must then run an explicit managed-agent sync before tests and staging; otherwise `.agent/skills` remains one release behind. A repository parity test should compare every managed copy byte-for-byte with its extension source.
 - **2026-09-14 — Lifecycle control plane:** Active approved prose owns behavioral intent; `.docguard-specs.json` owns reviewed lifecycle, lineage, scope, and persistence policy while regenerating observed evidence deterministically. Approval, delivery, context, retirement reason, storage, and persistence model are separate dimensions. Use immutable `specId#requirementId` identities and preserve retired tombstones; path-qualified IDs are only a migration format.
 - **2026-09-14 — Retirement is stricter than completion:** Checked tasks and `Status: Completed` are review signals. Verification requires exact-revision implementation/test evidence plus reconciled canonical outcomes. Retirement additionally requires a retained Git ref, clean replacement/evidence docs, no live backreferences, a compatible persistence model, and fresh context. The public verb is `retire` because Spec Kit Archive already means consolidation.

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.40.5] - 2026-09-15
+
+Automated weekly release — batches everything merged since `v0.40.4`.
+
+### Changed
+
+- test: retry transient freshness cleanup (#393)
+- fix: make Spec Kit command manifest complete (#392)
+
+
+### Fixed
+
+- Retry removal of temporary Git repositories when the operating system reports
+  a transient `ENOTEMPTY`, preventing a completed freshness test from randomly
+  blocking the release gate during teardown.
+- Register every command shipped by the Spec Kit extension, route `fix` and
+  `review` to their matching command files, keep the manifest description inside
+  Spec Kit's 200-character limit, and add release-contract tests that reject
+  missing, duplicate, mismatched, undeclared, or divergent metadata.
+- Record the supported `git diff --check` and `gh pr diff --patch` split in the
+  project learning log so release self-review does not repeat an invalid CLI call.
+
 ## [0.40.4] - 2026-09-15
 
 Automated weekly release — batches everything merged since `v0.40.3`.

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: docguard-cli
-Version: 0.40.4
+Version: 0.40.5
 Summary: The enforcement tool for Canonical-Driven Development (CDD). Audit, generate, and guard your project documentation. No Python dependencies (requires Node.js 18+).
 Project-URL: Homepage, https://github.com/raccioly/docguard
 Project-URL: Documentation, https://github.com/raccioly/docguard#readme

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/docs-canonical/TEST-SPEC.md

@@ -58,6 +58,7 @@ All test files live in `tests/` and match the glob `tests/*.test.mjs` — the te
 | `cli/commands/agents.mjs` | `tests/commands.test.mjs` | ✅ |
 | `cli/commands/agent.mjs`, `cli/scanners/task-context.mjs` | `tests/agent.test.mjs`, `tests/task-context.test.mjs` | ✅ |
 | `cli/commands/hooks.mjs` | `tests/commands.test.mjs` | ✅ |
+| `extensions/spec-kit-docguard/extension.yml`, `extensions/spec-kit-docguard/commands/*.md` | `tests/hooks-contract.test.mjs` | ✅ |
 | `cli/commands/diagnose.mjs` | `tests/commands.test.mjs` | ✅ |
 | `cli/commands/badge.mjs` | `tests/commands.test.mjs` | ✅ |
 | `cli/commands/ci.mjs` | `tests/commands.test.mjs` | ✅ |

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/extensions/spec-kit-docguard/README.md

@@ -45,12 +45,15 @@ docguard score
 
 | Command | Alias | Purpose |
 |---------|-------|---------|
+| `speckit.docguard.init` | `docguard.init` | Initialize CDD in a project |
 | `speckit.docguard.guard` | `docguard.guard` | Run configurable quality gate with severity triage |
 | `speckit.docguard.fix` | `docguard.fix` | AI-driven documentation repair with codebase research |
 | `speckit.docguard.review` | `docguard.review` | Cross-document semantic consistency analysis (read-only) |
 | `speckit.docguard.score` | `docguard.score` | CDD maturity score with ROI improvement roadmap |
 | `speckit.docguard.diagnose` | — | Diagnose issues + generate multi-perspective AI prompts |
 | `speckit.docguard.generate` | — | Reverse-engineer canonical docs from codebase |
+| `speckit.docguard.sync` | — | Refresh code-truth sections and flag prose for review |
+| `speckit.docguard.trace` | — | Generate requirements traceability matrix |
 | `speckit.docguard.brief` | — | Load current spec intent before specification |
 | `speckit.docguard.preflight` | — | Gate the generated spec before task generation |
 | `speckit.docguard.complete` | — | Plan reviewed completion and regenerate active context after verification |

docguard_cli-0.40.5/extensions/spec-kit-docguard/commands/review.md

@@ -0,0 +1,50 @@
+---
+description: "Review documentation against code without modifying the repository"
+allowed-tools: Bash, Read
+handoffs:
+  - label: Fix Reviewed Issues
+    agent: docguard.fix
+    prompt: Fix the documentation issues confirmed by the review
+  - label: Run Guard
+    agent: docguard.guard
+    prompt: Validate all checks after approved fixes
+---
+
+# DocGuard Review
+
+Perform a read-only semantic review of canonical documentation against the
+repository. Report evidence and recommendations; do not edit files.
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding when it is not empty.
+
+## Execution
+
+1. Run the deterministic inventory and quality checks:
+
+```bash
+npx --yes docguard-cli@latest diagnose $ARGUMENTS
+npx --yes docguard-cli@latest diff $ARGUMENTS
+npx --yes docguard-cli@latest score $ARGUMENTS
+npx --yes docguard-cli@latest verify --evidence --format json $ARGUMENTS
+npx --yes docguard-cli@latest verify --semantic $ARGUMENTS
+```
+
+2. Read the canonical documents and their cited code. Check architecture,
+   schemas, security claims, test coverage, terminology, and cross-references.
+3. For every contradiction, identify whether approved documentation or current
+   code owns the intended behavior. A mismatch can be a code regression.
+4. Return a severity-ranked report with exact file paths, evidence, confidence,
+   and a proposed next action. Keep unsupported claims explicitly unverified.
+
+## Constraints
+
+- Do not modify files or treat a clean structural guard as proof that prose is
+  factually correct.
+- Do not rewrite canonical intent to match code until ownership is resolved.
+- Cap the report at 50 findings and aggregate lower-priority overflow.

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/extensions/spec-kit-docguard/extension.yml

@@ -3,8 +3,8 @@ schema_version: "1.0"
 extension:
   id: "docguard"
   name: "DocGuard — CDD Enforcement"
-  version: "0.40.4"
-  description: "Canonical-Driven Development enforcement as a true spec-kit extension. LLM-first design with automated validators, 5 AI behavior skills, spec-kit skill chaining, and workflow hooks. One pinned runtime dependency (@babel/parser); pure Node.js otherwise."
+  version: "0.40.5"
+  description: "Documentation integrity for AI-assisted repositories: lifecycle registry, drift validation, traceability, safe archival, SARIF/JUnit, MCP, GitHub Actions, and Spec Kit hooks."
   author: "Ricardo Accioly"
   repository: "https://github.com/raccioly/docguard"
   license: "MIT"
@@ -25,16 +25,20 @@ requires:
 
 provides:
   commands:
+    - name: "speckit.docguard.init"
+      file: "commands/init.md"
+      description: "Initialize Canonical-Driven Development in a project"
+
     - name: "speckit.docguard.guard"
       file: "commands/guard.md"
       description: "Run configurable quality gate with severity triage and remediation plan"
 
     - name: "speckit.docguard.fix"
-      file: "commands/generate.md"
+      file: "commands/fix.md"
       description: "AI-driven documentation repair with codebase research and validation loops"
 
     - name: "speckit.docguard.review"
-      file: "commands/diagnose.md"
+      file: "commands/review.md"
       description: "Cross-document semantic consistency analysis (read-only)"
 
     - name: "speckit.docguard.score"
@@ -49,6 +53,14 @@ provides:
       file: "commands/generate.md"
       description: "Reverse-engineer canonical docs from existing codebase"
 
+    - name: "speckit.docguard.sync"
+      file: "commands/sync.md"
+      description: "Refresh generated code-truth sections while preserving human prose"
+
+    - name: "speckit.docguard.trace"
+      file: "commands/trace.md"
+      description: "Generate the requirements traceability matrix"
+
     - name: "speckit.docguard.brief"
       file: "commands/brief.md"
       description: "Brief prior spec intent and lifecycle before creating a new specification"

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/extensions/spec-kit-docguard/skills/docguard-fix/SKILL.md

@@ -6,10 +6,10 @@ description: AI-driven documentation repair with structured research workflow, t
 compatibility: Requires DocGuard CLI installed (npm i -g docguard-cli or npx docguard-cli)
 metadata:
   author: docguard
-  version: 0.40.4
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-fix
 ---
-<!-- docguard:version: 0.40.4 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Fix Skill
 

{docguard_cli-0.40.4/.agent → docguard_cli-0.40.5/extensions/spec-kit-docguard}/skills/docguard-guard/SKILL.md

@@ -7,10 +7,10 @@ description: Run DocGuard guard validation against Canonical-Driven Development
 compatibility: Requires DocGuard CLI installed (npm i -g docguard-cli or npx docguard-cli)
 metadata:
   author: docguard
-  version: 0.40.4
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-guard
 ---
-<!-- docguard:version: 0.40.4 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Guard Skill
 

{docguard_cli-0.40.4/.agent → docguard_cli-0.40.5/extensions/spec-kit-docguard}/skills/docguard-review/SKILL.md

@@ -6,10 +6,10 @@ description: Cross-document consistency analysis and quality assessment. Perform
 compatibility: Requires DocGuard CLI installed (npm i -g docguard-cli or npx docguard-cli)
 metadata:
   author: docguard
-  version: 0.40.4
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-review
 ---
-<!-- docguard:version: 0.40.4 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Review Skill
 

{docguard_cli-0.40.4/.agent → docguard_cli-0.40.5/extensions/spec-kit-docguard}/skills/docguard-score/SKILL.md

@@ -6,10 +6,10 @@ description: CDD maturity assessment with category-aware improvement roadmap. Ru
 compatibility: Requires DocGuard CLI installed (npm i -g docguard-cli or npx docguard-cli)
 metadata:
   author: docguard
-  version: 0.40.4
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-score
 ---
-<!-- docguard:version: 0.40.4 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Score Skill
 

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/extensions/spec-kit-docguard/skills/docguard-sync/SKILL.md

@@ -4,10 +4,10 @@ description: Keep canonical documentation ALWAYS UP TO DATE. Refreshes code-trut
 compatibility: Requires DocGuard CLI installed (npm i -g docguard-cli or npx docguard-cli)
 metadata:
   author: docguard
-  version: 0.40.4
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-sync
 ---
-<!-- docguard:version: 0.40.4 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Sync Skill
 

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/extensions/spec-kit-docguard/templates/github-workflows/docguard-autofix.yml

@@ -44,7 +44,7 @@ jobs:
           fetch-depth: 0
 
       - name: Run DocGuard fix --write + auto-commit + PR comment
-        uses: raccioly/docguard@v0.40.4
+        uses: raccioly/docguard@v0.40.5
         with:
           command: fix
           auto-commit: 'true'

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/extensions/spec-kit-docguard/templates/github-workflows/docguard-guard.yml

@@ -35,7 +35,7 @@ jobs:
           node-version: '20'
 
       - name: Install DocGuard
-        run: npm install --global --ignore-scripts docguard-cli@0.40.4
+        run: npm install --global --ignore-scripts docguard-cli@0.40.5
 
       - name: Run DocGuard
         shell: bash

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "docguard-cli",
-  "version": "0.40.4",
+  "version": "0.40.5",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "docguard-cli",
-      "version": "0.40.4",
+      "version": "0.40.5",
       "license": "MIT",
       "dependencies": {
         "@babel/parser": "7.29.8"

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docguard-cli",
-  "version": "0.40.4",
+  "version": "0.40.5",
   "description": "The enforcement tool for Canonical-Driven Development (CDD). Audit, generate, and guard your project documentation.",
   "type": "module",
   "bin": {

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "docguard-cli"
-version = "0.40.4"
+version = "0.40.5"
 description = "The enforcement tool for Canonical-Driven Development (CDD). Audit, generate, and guard your project documentation. No Python dependencies (requires Node.js 18+)."
 readme = "README.md"
 license = { text = "MIT" }

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.raccioly/docguard",
   "title": "DocGuard",
   "description": "Deterministic doc-drift detection: guard, score, explain, verify-claims and diagnose MCP tools.",
-  "version": "0.40.4",
+  "version": "0.40.5",
   "websiteUrl": "https://github.com/raccioly/docguard#readme",
   "repository": {
     "url": "https://github.com/raccioly/docguard",
@@ -14,7 +14,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "docguard-cli",
-      "version": "0.40.4",
+      "version": "0.40.5",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/templates/ci/github-actions.yml

@@ -31,7 +31,7 @@ jobs:
           node-version: '20'
 
       - name: Install DocGuard
-        run: npm install --global --ignore-scripts docguard-cli@0.40.4
+        run: npm install --global --ignore-scripts docguard-cli@0.40.5
 
       - name: Run DocGuard
         shell: bash

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/tests/catalog-submission.test.mjs

@@ -92,8 +92,11 @@ test('catalog form respects upstream description and tag bounds', () => {
   const text = execFileSync('python3', ['-B', script, '--url', '1.2.3', download], { encoding: 'utf8' }).trim();
   const url = new URL(text);
   const description = url.searchParams.get('description');
+  const manifestDescription = readFileSync(manifestPath, 'utf8')
+    .match(/^  description: "([^"]+)"$/m)?.[1];
   const tags = url.searchParams.get('tags').split(',').map(tag => tag.trim()).filter(Boolean);
   assert.ok(description.length > 0 && description.length <= 200);
+  assert.equal(description, manifestDescription);
   assert.ok(tags.length >= 2 && tags.length <= 5);
 });
 

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/tests/freshness.test.mjs

@@ -15,7 +15,14 @@ const runGit = (args, cwd) => {
 describe('readLastReviewedDate — future dates cannot mask staleness', () => {
   let dir;
   beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'fresh-review-')); });
-  afterEach(() => { if (dir) rmSync(dir, { recursive: true, force: true }); });
+  afterEach(() => {
+    if (dir) rmSync(dir, {
+      recursive: true,
+      force: true,
+      maxRetries: 5,
+      retryDelay: 50,
+    });
+  });
 
   it('reads a valid past-dated header', () => {
     const f = join(dir, 'A.md');
@@ -47,7 +54,12 @@ describe('Freshness Validator', () => {
   });
 
   afterEach(() => {
-    rmSync(tmpDir, { recursive: true, force: true });
+    rmSync(tmpDir, {
+      recursive: true,
+      force: true,
+      maxRetries: 5,
+      retryDelay: 50,
+    });
   });
 
   it('skips when the directory is not a git repository', () => {

{docguard_cli-0.40.4 → docguard_cli-0.40.5}/tests/hooks-contract.test.mjs

@@ -1,6 +1,8 @@
 import { describe, it, beforeEach, afterEach } from 'node:test';
 import { strict as assert } from 'node:assert';
-import { mkdtempSync, mkdirSync, rmSync, symlinkSync, chmodSync, readFileSync } from 'node:fs';
+import {
+  mkdtempSync, mkdirSync, rmSync, symlinkSync, chmodSync, readFileSync, readdirSync,
+} from 'node:fs';
 import { spawnSync } from 'node:child_process';
 import { join } from 'node:path';
 import { tmpdir } from 'node:os';
@@ -181,3 +183,42 @@ describe('Spec Kit hook registration contracts', () => {
     });
   }
 });
+
+describe('Spec Kit command registration contracts', () => {
+  it('declares every shipped command with a unique matching file', () => {
+    const manifest = readFileSync(
+      new URL('../extensions/spec-kit-docguard/extension.yml', import.meta.url),
+      'utf8',
+    );
+    const block = manifest.match(/^  commands:\n([\s\S]*?)(?=^  #|^  workflows:)/m)?.[1];
+    assert.ok(block, 'provides.commands block is missing');
+
+    const entries = [...block.matchAll(
+      /^    - name: "([^"]+)"\n      file: "([^"]+)"\n      description: "([^"]+)"/gm,
+    )].map(([, name, file, description]) => ({ name, file, description }));
+    assert.ok(entries.length > 0, 'no commands were parsed from the manifest');
+    assert.equal(new Set(entries.map(({ name }) => name)).size, entries.length, 'command names must be unique');
+    assert.equal(new Set(entries.map(({ file }) => file)).size, entries.length, 'command files must be unique');
+
+    for (const { name, file, description } of entries) {
+      const verb = name.replace(/^speckit\.docguard\./, '');
+      assert.notEqual(verb, name, `command is outside the docguard namespace: ${name}`);
+      assert.equal(file, `commands/${verb}.md`, `${name} must map to its matching command file`);
+      assert.ok(description.trim(), `${name} must have a description`);
+      const command = readFileSync(
+        new URL(`../extensions/spec-kit-docguard/${file}`, import.meta.url),
+        'utf8',
+      );
+      assert.match(command, /^---\ndescription:/, `${file} must have command frontmatter`);
+    }
+
+    const shipped = readdirSync(
+      new URL('../extensions/spec-kit-docguard/commands/', import.meta.url),
+      { withFileTypes: true },
+    )
+      .filter(entry => entry.isFile() && entry.name.endsWith('.md'))
+      .map(entry => `commands/${entry.name}`)
+      .sort();
+    assert.deepEqual(entries.map(({ file }) => file).sort(), shipped);
+  });
+});