docguard-cli 0.41.0 → 0.41.2

package/CHANGELOG.md

@@ -7,6 +7,49 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.41.2] - 2026-09-15
+
+Automated weekly release — batches everything merged since `v0.41.1`.
+
+### Changed
+
+- Require exact packed CLI version (#402)
+
+
+### Fixed
+
+- Require the extracted npm package's `--version` output to equal its exact
+  packed `package.json` version, preventing a plausible but stale semantic
+  version from passing release smoke tests.
+
+## [0.41.1] - 2026-09-15
+
+Automated weekly release — batches everything merged since `v0.41.0`.
+
+### Changed
+
+- Anchor lifecycle evidence to main (#400)
+- Anchor R9 lifecycle evidence to main (#399)
+- Fix living spec finalization and close R9 (#398)
+
+
+### Fixed
+
+- Allow an evidence-complete living specification to finish without creating a
+  stale `tasks.md` solely for lifecycle bookkeeping, while continuing to reject
+  missing task ledgers for other persistence models and empty or incomplete
+  ledgers wherever they are declared. Released living contracts can record later
+  maintenance without downgrading their release state.
+- Record the reviewed document-lifecycle maintenance outcome against its exact
+  source revision and qualified implementation/test evidence.
+- Close roadmap milestone R9 after independently verifying every v0.41.0
+  publication target and record the adoption workflow's reviewed outcome without
+  creating a stale task ledger.
+- Anchor the adoption workflow's final maintenance outcome to durable main commit
+  `2ff1baa` after the protected merge checks completed.
+- Anchor the document-lifecycle maintenance outcome to durable main commit
+  `2a47de5`, completing the post-merge evidence chain.
+
 ## [0.41.0] - 2026-09-15
 
 Automated weekly release — batches everything merged since `v0.40.5`.

package/cli/commands/specs.mjs

@@ -57,7 +57,10 @@ function archiveReadiness(spec, targetVerified = false) {
 }
 
 function completionTransition(spec) {
-  if (spec?.reviewed.lifecycle.delivery === 'verified') return 'verified→verified';
+  if (spec?.reviewed.lifecycle.persistenceModel === 'living'
+    && ['verified', 'released'].includes(spec.reviewed.lifecycle.delivery)) {
+    return `${spec.reviewed.lifecycle.delivery}→${spec.reviewed.lifecycle.delivery}`;
+  }
   return spec?.reviewed.lifecycle.delivery === 'in_progress'
     ? 'in_progress→implemented→verified'
     : 'implemented→verified';
@@ -77,14 +80,22 @@ export function planSpecCompletion(projectDir, config, flags, options = {}) {
 
   let reconcile = null;
   if (spec) {
-    const maintenance = spec.reviewed.lifecycle.delivery === 'verified'
+    const maintenance = ['verified', 'released'].includes(spec.reviewed.lifecycle.delivery)
       && spec.reviewed.lifecycle.persistenceModel === 'living';
     if (spec.reviewed.lifecycle.approval !== 'approved') blockers.push({ code: 'SPC002', message: 'Only an approved spec can become verified.' });
     if (!['in_progress', 'implemented'].includes(spec.reviewed.lifecycle.delivery) && !maintenance) {
       blockers.push({ code: 'SPC002', message: `Expected delivery=in_progress, implemented, or verified with persistenceModel=living; found ${spec.reviewed.lifecycle.delivery}/${spec.reviewed.lifecycle.persistenceModel || 'unset'}.` });
     }
     const tasks = spec.observed.taskCompletion;
-    if (!tasks.total || tasks.checked !== tasks.total) blockers.push({ code: 'SPC003', message: `All tasks must be checked (${tasks.checked}/${tasks.total}).` });
+    const hasTaskLedger = spec.observed.artifacts.some(artifact => /(?:^|\/)tasks\.md$/i.test(artifact.path));
+    if (hasTaskLedger && (!tasks.total || tasks.checked !== tasks.total)) {
+      blockers.push({ code: 'SPC003', message: `All declared tasks must be checked (${tasks.checked}/${tasks.total}).` });
+    } else if (!hasTaskLedger && spec.reviewed.lifecycle.persistenceModel !== 'living') {
+      blockers.push({
+        code: 'SPC003',
+        message: 'Completion requires a task ledger unless the approved spec is a living verification contract with qualified evidence for every requirement.',
+      });
+    }
     if (spec.observed.implementationEvidence.length === 0) blockers.push({ code: 'SPC004', message: 'At least one qualified source implementation annotation is required.' });
     if (spec.observed.testEvidence.length === 0) blockers.push({ code: 'SPC004', message: 'At least one qualified test annotation is required.' });
     const covered = new Set([...spec.observed.implementationEvidence, ...spec.observed.testEvidence].map(item => item.requirementId));
@@ -162,7 +173,7 @@ export function completeSpec(projectDir, config, flags, options = {}) {
     successor: flags.successor || null,
   };
   const specContent = appendImplementationOutcome(readFileSync(specPath, 'utf8'), outcome);
-  spec.reviewed.lifecycle.delivery = 'verified';
+  if (spec.reviewed.lifecycle.delivery !== 'released') spec.reviewed.lifecycle.delivery = 'verified';
   spec.reviewed.reconciliation.lastReviewedRevision = plan.revision;
   spec.reviewed.reconciliation.outcomes = [...spec.reviewed.reconciliation.outcomes, outcome].slice(-20);
   const artifact = spec.observed.artifacts.find(item => item.path === spec.path);

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

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

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.41.0
+  version: 0.41.2
   source: extensions/spec-kit-docguard/skills/docguard-fix
 ---
-<!-- docguard:version: 0.41.0 -->
+<!-- docguard:version: 0.41.2 -->
 
 # 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.41.0
+  version: 0.41.2
   source: extensions/spec-kit-docguard/skills/docguard-guard
 ---
-<!-- docguard:version: 0.41.0 -->
+<!-- docguard:version: 0.41.2 -->
 
 # 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.41.0
+  version: 0.41.2
   source: extensions/spec-kit-docguard/skills/docguard-review
 ---
-<!-- docguard:version: 0.41.0 -->
+<!-- docguard:version: 0.41.2 -->
 
 # 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.41.0
+  version: 0.41.2
   source: extensions/spec-kit-docguard/skills/docguard-score
 ---
-<!-- docguard:version: 0.41.0 -->
+<!-- docguard:version: 0.41.2 -->
 
 # 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.41.0
+  version: 0.41.2
   source: extensions/spec-kit-docguard/skills/docguard-sync
 ---
-<!-- docguard:version: 0.41.0 -->
+<!-- docguard:version: 0.41.2 -->
 
 # 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.41.0
+        uses: raccioly/docguard@v0.41.2
         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.41.0
+        run: npm install --global --ignore-scripts docguard-cli@0.41.2
 
       - name: Run DocGuard
         shell: bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docguard-cli",
-  "version": "0.41.0",
+  "version": "0.41.2",
   "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.41.0
+        run: npm install --global --ignore-scripts docguard-cli@0.41.2
 
       - name: Run DocGuard
         shell: bash