docguard-cli 0.37.1 → 0.39.0

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

@@ -3,7 +3,7 @@ schema_version: "1.0"
 extension:
   id: "docguard"
   name: "DocGuard — CDD Enforcement"
-  version: "0.37.1"
+  version: "0.39.0"
   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."
   author: "Ricardo Accioly"
   repository: "https://github.com/raccioly/docguard"
@@ -57,6 +57,10 @@ provides:
       file: "commands/preflight.md"
       description: "Gate a generated specification against registry integrity and prior intent"
 
+    - name: "speckit.docguard.complete"
+      file: "commands/complete.md"
+      description: "Plan the reviewed implemented-to-verified lifecycle transaction"
+
   # GitHub Actions workflow starters — copyable templates users drop into
   # .github/workflows/ for guard/fix/sync/score integration.
   workflows:
@@ -88,9 +92,21 @@ hooks:
     description: "Load current spec intent and block specification on stale lifecycle state"
 
   after_implement:
-    command: "speckit.docguard.guard"
-    optional: false
-    description: "Quality gate — ensures docs stay in sync with code"
+    - command: "speckit.docguard.guard"
+      optional: false
+      priority: 5
+      description: "Quality gate — ensures docs stay in sync with code"
+    - command: "speckit.docguard.complete"
+      optional: true
+      priority: 10
+      prompt: "Review evidence and plan this spec's completion transaction?"
+      description: "Plan lifecycle verification after implementation"
+
+  after_converge:
+    command: "speckit.docguard.complete"
+    optional: true
+    prompt: "Review evidence and plan this converged spec's completion transaction?"
+    description: "Plan lifecycle verification after convergence"
 
   before_tasks:
     command: "speckit.docguard.preflight"

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.37.1
+  version: 0.39.0
   source: extensions/spec-kit-docguard/skills/docguard-fix
 ---
-<!-- docguard:version: 0.37.1 -->
+<!-- docguard:version: 0.39.0 -->
 
 # 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.37.1
+  version: 0.39.0
   source: extensions/spec-kit-docguard/skills/docguard-guard
 ---
-<!-- docguard:version: 0.37.1 -->
+<!-- docguard:version: 0.39.0 -->
 
 # 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.37.1
+  version: 0.39.0
   source: extensions/spec-kit-docguard/skills/docguard-review
 ---
-<!-- docguard:version: 0.37.1 -->
+<!-- docguard:version: 0.39.0 -->
 
 # 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.37.1
+  version: 0.39.0
   source: extensions/spec-kit-docguard/skills/docguard-score
 ---
-<!-- docguard:version: 0.37.1 -->
+<!-- docguard:version: 0.39.0 -->
 
 # 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.37.1
+  version: 0.39.0
   source: extensions/spec-kit-docguard/skills/docguard-sync
 ---
-<!-- docguard:version: 0.37.1 -->
+<!-- docguard:version: 0.39.0 -->
 
 # DocGuard Sync Skill
 

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

@@ -26,6 +26,22 @@ hooks:
       description: "Validate documentation passes CDD standards after implementation"
       enabled: true
       optional: false
+      priority: 5
+    - extension: docguard
+      command: speckit.docguard.complete
+      description: "Plan reviewed lifecycle verification after implementation"
+      enabled: true
+      optional: true
+      priority: 10
+      prompt: "Review evidence and plan this spec's completion transaction?"
+
+  after_converge:
+    - extension: docguard
+      command: speckit.docguard.complete
+      description: "Plan reviewed lifecycle verification after convergence"
+      enabled: true
+      optional: true
+      prompt: "Review evidence and plan this converged spec's completion transaction?"
 
   # Gate the generated spec before /speckit.tasks creates implementation work.
   before_tasks:

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docguard-cli",
-  "version": "0.37.1",
+  "version": "0.39.0",
   "description": "The enforcement tool for Canonical-Driven Development (CDD). Audit, generate, and guard your project documentation.",
   "type": "module",
   "bin": {
@@ -12,6 +12,7 @@
     "guard": "node cli/docguard.mjs guard",
     "init": "node cli/docguard.mjs init",
     "score": "node cli/docguard.mjs score",
+    "benchmark": "node benchmarks/run.mjs",
     "diff": "node cli/docguard.mjs diff",
     "generate": "node cli/docguard.mjs generate",
     "hooks": "node cli/docguard.mjs hooks",

package/schemas/docguard-benchmark.schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raccioly.github.io/docguard/schemas/docguard-benchmark.schema.json",
+  "title": "DocGuard benchmark corpus",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "schemaVersion", "cases"],
+  "properties": {
+    "$schema": { "const": "https://raccioly.github.io/docguard/schemas/docguard-benchmark.schema.json" },
+    "schemaVersion": { "const": 1 },
+    "cases": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/case" }
+    }
+  },
+  "$defs": {
+    "identity": { "type": "string", "pattern": "^[A-Z]{3}[0-9]{3}@[^/\\\\][^\\\\]*$" },
+    "source": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "path"],
+          "properties": {
+            "kind": { "const": "fixture" },
+            "path": { "type": "string", "pattern": "^fixtures/" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "url", "revision", "license"],
+          "properties": {
+            "kind": { "const": "git" },
+            "url": { "type": "string", "pattern": "^https://[^@]+\\.git$" },
+            "revision": { "type": "string", "pattern": "^[0-9a-f]{40}([0-9a-f]{24})?$" },
+            "license": { "type": "string", "minLength": 1, "maxLength": 128 }
+          }
+        }
+      ]
+    },
+    "mutation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "find", "replace", "expectedOccurrences"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "find": { "type": "string", "minLength": 1, "maxLength": 20000 },
+        "replace": { "type": "string", "maxLength": 20000 },
+        "expectedOccurrences": { "type": "integer", "minimum": 1, "maximum": 20 }
+      }
+    },
+    "case": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "split", "repositoryGroup", "causalFamily", "parserTier", "classification", "source", "scope", "expected", "forbidden", "repairOutcome"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{2,127}$" },
+        "split": { "enum": ["development", "evaluation"] },
+        "repositoryGroup": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "causalFamily": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "parserTier": { "enum": ["js-ast", "py-ast", "regex-fallback", "fallback-language", "mixed", "not-applicable"] },
+        "classification": { "enum": ["defect", "clean_control", "ambiguous", "unsupported_syntax", "policy_disagreement"] },
+        "repairOutcome": { "enum": ["accepted", "rejected", "not_evaluated"] },
+        "source": { "$ref": "#/$defs/source" },
+        "scope": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["validatorKey", "codes"],
+          "properties": {
+            "validatorKey": { "type": "string", "minLength": 1, "maxLength": 64 },
+            "codes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Z]{3}[0-9]{3}$" } }
+          }
+        },
+        "config": { "type": "object" },
+        "mutations": { "type": "array", "items": { "$ref": "#/$defs/mutation" } },
+        "expected": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/identity" } },
+        "forbidden": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/identity" } },
+        "oppositeControl": { "type": ["string", "null"], "pattern": "^[a-z0-9][a-z0-9._-]{2,127}$" }
+      }
+    }
+  }
+}

package/schemas/docguard-feedback-fixture.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raccioly.github.io/docguard/schemas/docguard-feedback-fixture.schema.json",
+  "title": "DocGuard synthetic feedback fixture",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "schemaVersion", "classification", "detector", "parserTier", "config", "expectedIdentity", "interestingness", "fixture", "oppositeControl", "provenance"],
+  "properties": {
+    "$schema": { "const": "https://raccioly.github.io/docguard/schemas/docguard-feedback-fixture.schema.json" },
+    "schemaVersion": { "const": 1 },
+    "classification": { "enum": ["false_positive", "false_negative", "unsupported_syntax", "ambiguous", "policy_disagreement"] },
+    "detector": {
+      "type": "object", "additionalProperties": false, "required": ["code", "validator"],
+      "properties": { "code": { "type": "string", "pattern": "^[A-Z]{3}[0-9]{3}$" }, "validator": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9]{1,63}$" } }
+    },
+    "parserTier": { "enum": ["js-ast", "py-ast", "regex-fallback", "fallback-language", "mixed", "not-applicable"] },
+    "config": { "type": "object" },
+    "expectedIdentity": { "type": "string", "pattern": "^[A-Z]{3}[0-9]{3}@.+$" },
+    "interestingness": {
+      "type": "object", "additionalProperties": false, "required": ["predicate"],
+      "properties": { "predicate": { "enum": ["finding_present", "finding_absent", "validator_unsupported"] } }
+    },
+    "fixture": { "$ref": "#/$defs/fileSet" },
+    "oppositeControl": { "$ref": "#/$defs/fileSet" },
+    "provenance": {
+      "type": "object", "additionalProperties": false, "required": ["synthetic", "redactionAttested"],
+      "properties": { "synthetic": { "const": true }, "redactionAttested": { "const": true } }
+    },
+    "contribution": {
+      "type": "object", "additionalProperties": false, "required": ["testOnly", "scopeDocumented", "benchmarkDelta"],
+      "properties": {
+        "testOnly": { "const": true }, "scopeDocumented": { "const": true },
+        "benchmarkDelta": {
+          "type": "object", "additionalProperties": false,
+          "required": ["falsePositives", "falseNegatives", "unsupportedCases", "abstainedSupportedCases"],
+          "properties": {
+            "falsePositives": { "type": "integer", "minimum": 0 }, "falseNegatives": { "type": "integer", "minimum": 0 },
+            "unsupportedCases": { "type": "integer", "minimum": 0 }, "abstainedSupportedCases": { "type": "integer", "minimum": 0 }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "fileSet": {
+      "type": "object", "additionalProperties": false, "required": ["files"],
+      "properties": { "files": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "$ref": "#/$defs/file" } } }
+    },
+    "file": {
+      "type": "object", "additionalProperties": false, "required": ["path", "content"],
+      "properties": { "path": { "type": "string", "minLength": 1 }, "content": { "type": "string", "maxLength": 131072 } }
+    }
+  }
+}

package/schemas/docguard-specs.schema.json

@@ -8,7 +8,7 @@
   "required": ["$schema", "schemaVersion", "specs", "tombstones"],
   "properties": {
     "$schema": { "const": "https://raccioly.github.io/docguard/schemas/docguard-specs.schema.json" },
-    "schemaVersion": { "const": 1 },
+    "schemaVersion": { "const": 2 },
     "specs": {
       "type": "array",
       "items": { "$ref": "#/definitions/spec" }
@@ -75,13 +75,18 @@
         "reconciliation": {
           "type": "object",
           "additionalProperties": false,
-          "required": ["lastReviewedRevision"],
+          "required": ["lastReviewedRevision", "outcomes"],
           "properties": {
             "lastReviewedRevision": {
               "anyOf": [
                 { "type": "null" },
                 { "type": "string", "pattern": "^[0-9a-f]{40}([0-9a-f]{24})?$" }
               ]
+            },
+            "outcomes": {
+              "type": "array",
+              "maxItems": 20,
+              "items": { "$ref": "#/definitions/outcome" }
             }
           }
         }
@@ -96,6 +101,18 @@
         "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
       }
     },
+    "outcome": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["revision", "reason", "evidence", "deviations", "successor"],
+      "properties": {
+        "revision": { "type": "string", "pattern": "^[0-9a-f]{40}([0-9a-f]{24})?$" },
+        "reason": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "evidence": { "type": "array", "maxItems": 100, "items": { "type": "string", "minLength": 1 } },
+        "deviations": { "type": "array", "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 500 } },
+        "successor": { "anyOf": [{ "type": "null" }, { "$ref": "#/definitions/specId" }] }
+      }
+    },
     "testEvidence": {
       "type": "object",
       "additionalProperties": false,

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

package/templates/feedback-fixture.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://raccioly.github.io/docguard/schemas/docguard-feedback-fixture.schema.json",
+  "schemaVersion": 1,
+  "classification": "false_positive",
+  "detector": { "code": "SEC001", "validator": "security" },
+  "parserTier": "js-ast",
+  "config": { "profile": "starter", "diskCache": false, "validators": { "security": true } },
+  "expectedIdentity": "SEC001@src/case.js",
+  "interestingness": { "predicate": "finding_present" },
+  "fixture": { "files": [{ "path": "src/case.js", "content": "const password = \"validation message with several words\";\n" }] },
+  "oppositeControl": { "files": [{ "path": "src/case.js", "content": "const password = \"real-looking-password\";\n" }] },
+  "provenance": { "synthetic": true, "redactionAttested": true },
+  "contribution": {
+    "testOnly": true,
+    "scopeDocumented": true,
+    "benchmarkDelta": { "falsePositives": 0, "falseNegatives": 0, "unsupportedCases": 0, "abstainedSupportedCases": 0 }
+  }
+}