docguard-cli 0.40.3 → 0.40.5

package/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 |

package/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.

package/extensions/spec-kit-docguard/extension.yml

@@ -3,8 +3,8 @@ schema_version: "1.0"
 extension:
   id: "docguard"
   name: "DocGuard — CDD Enforcement"
-  version: "0.40.3"
-  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"

package/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.3
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-fix
 ---
-<!-- docguard:version: 0.40.3 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Fix Skill
 

package/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.3
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-guard
 ---
-<!-- docguard:version: 0.40.3 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Guard Skill
 

package/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.3
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-review
 ---
-<!-- docguard:version: 0.40.3 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Review Skill
 

package/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.3
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-score
 ---
-<!-- docguard:version: 0.40.3 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Score Skill
 

package/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.3
+  version: 0.40.5
   source: extensions/spec-kit-docguard/skills/docguard-sync
 ---
-<!-- docguard:version: 0.40.3 -->
+<!-- docguard:version: 0.40.5 -->
 
 # DocGuard Sync Skill
 

package/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.3
+        uses: raccioly/docguard@v0.40.5
         with:
           command: fix
           auto-commit: 'true'

package/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.3
+        run: npm install --global --ignore-scripts docguard-cli@0.40.5
 
       - name: Run DocGuard
         shell: bash

package/package.json

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

package/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.3
+        run: npm install --global --ignore-scripts docguard-cli@0.40.5
 
       - name: Run DocGuard
         shell: bash