[Extension]: Update DocGuard — CDD Enforcement (v0.36.1)

[raccioly]

Extension ID

docguard

Extension Name

DocGuard — CDD Enforcement

Version

0.36.1

Description

A deterministic documentation-integrity engine with an MCP server, SARIF/JUnit output, configurable validators, stable finding codes, and explicit coverage limitations. Helps teams review documentation drift, refresh generated sections, and prepare evidence for AI agents. Node.js with one pinned parser dependency.

Author

raccioly

Repository URL

https://github.com/raccioly/docguard

Download URL

https://github.com/raccioly/docguard/releases/download/v0.36.1/spec-kit-docguard-v0.36.1.zip

License

MIT

Homepage (optional)

https://www.npmjs.com/package/docguard-cli

Documentation URL (optional)

https://github.com/raccioly/docguard/blob/main/extensions/spec-kit-docguard/README.md

Changelog URL (optional)

https://github.com/raccioly/docguard/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.1.0

Required Tools (optional)

• Node.js >=18.0.0
• Installed DocGuard CLI: project-local docguard-cli package or docguard on PATH. Extension helper scripts do not implicitly download through npx.

Number of Commands

6

Number of Hooks (optional)

3

Tags

documentation, validation, quality, cdd, traceability, ai-agents, enforcement, spec-kit

Key Features

• Configurable documentation checks with stable findings and coverage states.
• Source-derived context and explicit uncertainty for AI workflows.
• False-positive reductions backed by paired regression cases.
• Custom Markdown role mapping for validation and read-only planning.
• Structured, validated score/guard JSON in the Spec Kit helper.
• Workflow hooks and deterministic mechanical fixes with explicit limits.

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

The final patch passed 1,541 tests on each of Node 18, 20, 22, and 24 in GitHub CI. Supply-chain checks passed. The GitHub release workflow also passed its runtime matrix and published the release artifacts.

The published v0.36.1 ZIP was installed with specify extension add --from in a disposable macOS Spec Kit project. Its manifest and LICENSE were verified, and the published helper ran with --json --verbose against the installed npm CLI. It returned valid JSON and preserved FAIL for an intentionally incomplete fixture. The Python package wrapper executed the installed v0.36.1 npm CLI successfully; the MCPB bundle's manifest and package versions match.

The deterministic CLI was assessed against disposable snapshots of six real projects without editing those repositories. Known coverage limitations are documented. The two unchecked items are deliberately not blanket attestations: every AI-driven slash-command outcome and universal prose correctness were not independently established by these tests. Documentation was reviewed, and the release records describe the concrete validation scope.

Example Usage

npm install --save-dev docguard-cli@0.36.1

specify extension add docguard --from https://github.com/raccioly/docguard/releases/download/v0.36.1/spec-kit-docguard-v0.36.1.zip

/speckit.docguard.guard

Proposed Catalog Entry

Update the existing docguard entry to version 0.36.1 and the download URL above. Repository, author, license, six registered commands, and three declared hooks remain unchanged. Hook activation depends on the consuming project's configuration.

Additional Context

This updates the existing open submission rather than creating a duplicate. v0.36.0 introduced documentation trust and precision improvements; v0.36.1 corrects extension descriptions and fixes the verbose helper's legacy output parsing and CLI resolution.

Release: https://github.com/raccioly/docguard/releases/tag/v0.36.1
Final patch PR and checks: raccioly/docguard#345
Validation record: https://github.com/raccioly/docguard/blob/main/docs-implementation/PRECISION-VALIDATION.md