docguard-cli 0.36.2 → 0.37.1

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

@@ -3,8 +3,8 @@ schema_version: "1.0"
 extension:
   id: "docguard"
   name: "DocGuard — CDD Enforcement"
-  version: "0.36.2"
-  description: "Canonical-Driven Development enforcement as a true spec-kit extension. LLM-first design with automated validators, 4 AI behavior skills, spec-kit skill chaining, and workflow hooks. One pinned runtime dependency (@babel/parser); pure Node.js otherwise."
+  version: "0.37.1"
+  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"
   license: "MIT"
@@ -49,6 +49,14 @@ provides:
       file: "commands/generate.md"
       description: "Reverse-engineer canonical docs from existing codebase"
 
+    - name: "speckit.docguard.brief"
+      file: "commands/brief.md"
+      description: "Brief prior spec intent and lifecycle before creating a new specification"
+
+    - name: "speckit.docguard.preflight"
+      file: "commands/preflight.md"
+      description: "Gate a generated specification against registry integrity and prior intent"
+
   # GitHub Actions workflow starters — copyable templates users drop into
   # .github/workflows/ for guard/fix/sync/score integration.
   workflows:
@@ -74,15 +82,20 @@ provides:
       description: "Initialize a new canonical document with metadata header"
 
 hooks:
+  before_specify:
+    command: "speckit.docguard.brief"
+    optional: false
+    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"
 
   before_tasks:
-    command: "speckit.docguard.review"
-    optional: true
-    prompt: "Review documentation consistency before generating tasks?"
+    command: "speckit.docguard.preflight"
+    optional: false
+    description: "Gate the generated spec before task generation"
 
   after_tasks:
     command: "speckit.docguard.score"

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

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

@@ -3,13 +3,21 @@
 # to integrate DocGuard into the spec-kit workflow.
 #
 # DocGuard will automatically run as a quality gate after implementation
-# and optionally before task generation.
+# and preflight lifecycle state before specification and task generation.
 
 schema_version: "1.0"
 
 extension: docguard
 
 hooks:
+  # Brief current and retired spec intent before /speckit.specify starts.
+  before_specify:
+    - extension: docguard
+      command: speckit.docguard.brief
+      description: "Load current spec intent and block specification on stale lifecycle state"
+      enabled: true
+      optional: false
+
   # Run DocGuard guard after /speckit.implement completes
   # This ensures documentation stays in sync with code changes
   after_implement:
@@ -19,14 +27,13 @@ hooks:
       enabled: true
       optional: false
 
-  # Run DocGuard review before /speckit.tasks to catch doc drift early
+  # Gate the generated spec before /speckit.tasks creates implementation work.
   before_tasks:
     - extension: docguard
-      command: speckit.docguard.review
-      description: "Review documentation consistency before generating tasks"
+      command: speckit.docguard.preflight
+      description: "Gate the generated spec against registry integrity and prior intent"
       enabled: true
-      optional: true  # Optional — user can skip
-      prompt: "Run DocGuard review to check documentation health before task generation?"
+      optional: false
 
   # Run DocGuard guard after /speckit.tasks to validate doc coverage
   after_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.36.2
+        run: npm install --global --ignore-scripts docguard-cli@0.37.1
 
       - name: Run DocGuard
         shell: bash

package/package.json

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

package/schemas/docguard-config.schema.json

@@ -105,6 +105,8 @@
         "todoTracking":       { "type": "boolean" },
         "schemaSync":         { "type": "boolean" },
         "specKit":            { "type": "boolean" },
+        "documentLifecycle":  { "type": "boolean" },
+        "specRegistry":       { "type": "boolean" },
         "crossReference":    { "type": "boolean" },
         "generatedStaleness":{ "type": "boolean" },
         "canonicalSync":     { "type": "boolean" },

package/schemas/docguard-specs.schema.json

@@ -0,0 +1,162 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raccioly.github.io/docguard/schemas/docguard-specs.schema.json",
+  "title": "DocGuard Spec Lifecycle Registry",
+  "description": "Committed lifecycle controls and deterministic evidence for Spec Kit artifacts. Requirement prose remains in the authoritative spec.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "schemaVersion", "specs", "tombstones"],
+  "properties": {
+    "$schema": { "const": "https://raccioly.github.io/docguard/schemas/docguard-specs.schema.json" },
+    "schemaVersion": { "const": 1 },
+    "specs": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/spec" }
+    },
+    "tombstones": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/tombstone" }
+    }
+  },
+  "definitions": {
+    "specId": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]{2,127}$"
+    },
+    "stringSet": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "specIdSet": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "$ref": "#/definitions/specId" }
+    },
+    "lifecycle": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["approval", "delivery", "context", "retirementReason", "storage", "persistenceModel"],
+      "properties": {
+        "approval": { "enum": ["draft", "approved", "rejected"] },
+        "delivery": { "enum": ["planned", "in_progress", "implemented", "verified", "released"] },
+        "context": { "enum": ["current", "retired"] },
+        "retirementReason": { "enum": [null, "completed", "superseded", "abandoned"] },
+        "storage": { "enum": ["working_tree", "git_history"] },
+        "persistenceModel": { "enum": [null, "flow_back", "flow_forward", "living"] }
+      }
+    },
+    "reviewed": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["lifecycle", "relations", "scope", "reconciliation"],
+      "properties": {
+        "lifecycle": { "$ref": "#/definitions/lifecycle" },
+        "relations": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["extends", "duplicates", "conflictsWith", "supersedes", "supersededBy"],
+          "properties": {
+            "extends": { "$ref": "#/definitions/specIdSet" },
+            "duplicates": { "$ref": "#/definitions/specIdSet" },
+            "conflictsWith": { "$ref": "#/definitions/specIdSet" },
+            "supersedes": { "$ref": "#/definitions/specIdSet" },
+            "supersededBy": { "$ref": "#/definitions/specIdSet" }
+          }
+        },
+        "scope": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["canonicalDocs"],
+          "properties": {
+            "canonicalDocs": { "$ref": "#/definitions/stringSet" }
+          }
+        },
+        "reconciliation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["lastReviewedRevision"],
+          "properties": {
+            "lastReviewedRevision": {
+              "anyOf": [
+                { "type": "null" },
+                { "type": "string", "pattern": "^[0-9a-f]{40}([0-9a-f]{24})?$" }
+              ]
+            }
+          }
+        }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "digest"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+      }
+    },
+    "testEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requirementId", "file", "line"],
+      "properties": {
+        "requirementId": { "type": "string", "minLength": 1 },
+        "file": { "type": "string", "minLength": 1 },
+        "line": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "spec": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["specId", "path", "reviewed", "intent", "observed"],
+      "properties": {
+        "specId": { "$ref": "#/definitions/specId" },
+        "path": { "type": "string", "minLength": 1 },
+        "reviewed": { "$ref": "#/definitions/reviewed" },
+        "intent": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["requirements"],
+          "properties": {
+            "requirements": { "$ref": "#/definitions/stringSet" }
+          }
+        },
+        "observed": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["artifacts", "taskCompletion", "implementationEvidence", "testEvidence"],
+          "properties": {
+            "artifacts": { "type": "array", "items": { "$ref": "#/definitions/artifact" } },
+            "taskCompletion": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["checked", "total"],
+              "properties": {
+                "checked": { "type": "integer", "minimum": 0 },
+                "total": { "type": "integer", "minimum": 0 }
+              }
+            },
+            "implementationEvidence": { "type": "array", "items": { "type": "object" } },
+            "testEvidence": { "type": "array", "items": { "$ref": "#/definitions/testEvidence" } }
+          }
+        }
+      }
+    },
+    "tombstone": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["specId", "path", "archivedFrom", "blob", "retentionRef", "objectFormat", "recoverability", "requirements"],
+      "properties": {
+        "specId": { "anyOf": [{ "type": "null" }, { "$ref": "#/definitions/specId" }] },
+        "path": { "type": "string", "minLength": 1 },
+        "archivedFrom": { "type": "string", "pattern": "^[0-9a-f]{40}([0-9a-f]{24})?$" },
+        "blob": { "type": "string", "pattern": "^[0-9a-f]{40}([0-9a-f]{24})?$" },
+        "retentionRef": { "anyOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }] },
+        "objectFormat": { "enum": [null, "sha1", "sha256"] },
+        "recoverability": { "enum": [null, "verified"] },
+        "requirements": { "$ref": "#/definitions/stringSet" }
+      }
+    }
+  }
+}

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