docguard-cli 0.27.0__tar.gz → 0.29.0__tar.gz

docguard_cli-0.29.0/.agent/commands/docguard.fix.md

@@ -0,0 +1,84 @@
+---
+description: Find and fix all CDD documentation issues using AI-driven research
+handoffs:
+  - label: Verify Fixes
+    agent: docguard.guard
+    prompt: Run guard to verify all fixes pass
+  - label: Check Score
+    agent: docguard.score
+    prompt: Show score improvement after fixes
+---
+
+# /docguard.fix — Find and Fix CDD Documentation Issues
+
+You are an AI agent responsible for maintaining documentation quality using DocGuard.
+
+## Step 1: Mechanical fixes first (no AI judgment needed)
+
+```bash
+npx docguard-cli fix --write
+```
+
+This deterministically applies the safe fix class: broken doc anchors, stale
+counts bound to code collections, stale version references. Each fix is
+provenance-checked and fail-closed — it never rewrites content whose source of
+truth it cannot verify. Doing this first shrinks the issue list you research.
+
+## Step 2: Assess what remains
+
+```bash
+npx docguard-cli diagnose
+```
+
+Parse the output — issues are categorized with AI-ready fix prompts. Every
+finding carries a stable code; run `npx docguard-cli explain <CODE>` whenever
+the right remediation isn't obvious from the message.
+
+If no issues remain, report "All CDD documentation is up to date" and stop.
+
+## Step 3: Fix each issue
+
+| Issue Type | Action |
+|-----------|--------|
+| `missing-file` | Run `npx docguard-cli fix --doc <name>` to generate |
+| `empty-doc` / `partial-doc` | Proceed to Step 4 for codebase research |
+| `missing-config` | Create `.docguard.json` based on project type |
+| `stale-doc` | Update `docguard:last-reviewed` date and content |
+| `quality-issue` | Fix negation language, add missing sections |
+| false positive | Suppress at the site: `// docguard:ignore <CODE>` (with a reason comment), and report it: `npx docguard-cli feedback` |
+
+**Doc wrong vs code wrong:** a doc/code mismatch does not automatically mean
+the doc is stale. Canonical docs are the spec — if the code drifted from a
+documented decision, flag the code (or record the deviation with a
+`// DRIFT: reason` comment + DRIFT-LOG.md entry) instead of silently rewriting
+the doc to match the regression.
+
+## Step 4: Write real content
+
+For each document that needs content:
+
+```bash
+npx docguard-cli fix --doc <name>
+```
+
+Where `<name>` is: `architecture`, `data-model`, `security`, `test-spec`, `environment`
+
+Read the output carefully — it contains:
+- **RESEARCH STEPS**: Exactly what files to read and commands to run
+- **WRITE THE DOCUMENT**: Expected structure and content for each section
+
+Execute the research steps, then write with REAL project content. No placeholders.
+Never edit inside `<!-- docguard:section ... source=code -->` markers by hand —
+those bodies are regenerated from code by `docguard sync --write`; pin them
+(`pinned="reason"`) if a hand-maintained exception is genuinely needed.
+
+## Step 5: Verify (iterate up to 3 times)
+
+```bash
+npx docguard-cli guard
+npx docguard-cli score
+```
+
+All checks should pass. If any fail, read the output and fix remaining issues.
+Report the final CDD score, plus anything you suppressed (with reasons) or
+reported as a false positive.

docguard_cli-0.29.0/.agent/commands/docguard.guard.md

@@ -0,0 +1,67 @@
+---
+description: Run DocGuard guard validation — check all validators and fix any issues
+handoffs:
+  - label: Fix Issues
+    agent: docguard.fix
+    prompt: Fix all documentation issues found by guard
+  - label: Check Score
+    agent: docguard.score
+    prompt: Show CDD maturity score after fixes
+---
+
+# /docguard.guard — Validate CDD Compliance
+
+You are an AI agent enforcing Canonical-Driven Development (CDD) compliance using DocGuard.
+
+## Step 1: Run Guard (machine-readable)
+
+```bash
+npx docguard-cli guard --format json
+```
+
+Read the JSON contract — do not parse prose:
+
+| Field | Meaning |
+|-------|---------|
+| `status` | `PASS` / `WARN` / `FAIL` (severity-aware; matches the exit code: 0/2/1) |
+| `findings[]` | Structured issues: `{code, severity, confidence, message, location, suggestion}` |
+| `nextStep` | The single suggested follow-up command (`null` on PASS) |
+| `reportable[]` | Low-confidence findings (possible false positives) — verify before acting |
+| `coverage` | Markdown tier map: `canonical / tracked / ignored / unclassified[]` |
+| `semanticClaims.count` | Documented counts/limits/enums NOT yet verified against code |
+| `validators[]` | Per-validator results, including `na` (nothing to validate ≠ pass) |
+
+## Step 2: Understand each finding before fixing
+
+- Every finding carries a stable code (e.g. `STR001`, `ENV003`, `XRF002`). Run
+  `npx docguard-cli explain <CODE>` for its contract, cause, and remediation.
+- `confidence: "low"` means the scanner itself is unsure — verify against the
+  code before changing anything, and report real false positives with
+  `npx docguard-cli feedback`.
+- A finding's `suggestion` may include a ready-to-run `command` or an inline
+  `pragma`. Prefer those over inventing your own fix.
+
+## Step 3: Fix, suppress, or escalate
+
+1. **Mechanical issues first**: `npx docguard-cli fix --write` applies safe,
+   provenance-checked fixes (broken anchors, stale counts/versions). Never
+   hand-edit what the tool can fix deterministically.
+2. **Prose/content issues**: follow the `/docguard.fix` workflow (research →
+   write real content).
+3. **Genuine false positives**: suppress at the finding site with the code —
+   `// docguard:ignore <CODE>` on (or above) the flagged line — or mark a whole
+   validator not-applicable in a doc:
+   `<!-- docguard:validator <key> n/a — reason -->`. Always include the reason.
+   Never suppress to silence a real issue.
+4. If `semanticClaims.count > 0`, offer to run `npx docguard-cli verify --semantic`
+   and check each extracted claim against the code — a green guard asserts
+   structure, not the truth of documented numbers.
+
+## Step 4: Report
+
+Show the user:
+1. `status` and pass/total, plus anything in `coverage.unclassified` (docs no
+   validator watches — suggest enrolling or ignoring them)
+2. Each finding fixed (by code), each suppressed (with reason), each reported
+   as a false positive
+3. Final score: `npx docguard-cli score`

{docguard_cli-0.27.0/templates → docguard_cli-0.29.0/.agent}/commands/docguard.review.md

@@ -22,8 +22,21 @@ npx docguard-cli score
 ```
 
 Read all output. Identify where documentation no longer matches the codebase.
+Findings carry stable codes — `npx docguard-cli explain <CODE>` when unclear.
 
-## Step 2: Semantic Analysis (Beyond CLI)
+## Step 2: Verify Documented Claims Against Code
+
+```bash
+npx docguard-cli verify --semantic
+```
+
+This extracts every checkable claim in the canonical docs — counts, limits,
+rate numbers, retention windows, status enums — as a task list with the nearest
+cited code path. **You perform each verification**: read the cited code, compare
+the value, and report every mismatch with both values. This is the highest-value
+review step; deterministic validators cannot judge these.
+
+## Step 3: Semantic Analysis (Beyond CLI)
 
 For each canonical doc, verify alignment with actual code:
 
@@ -35,16 +48,20 @@ For each canonical doc, verify alignment with actual code:
 | Test Coverage | Critical flows in TEST-SPEC.md have actual test files |
 | Terminology | Same concepts named consistently across all docs |
 
-## Step 3: Update Stale Docs
+## Step 4: Update Stale Docs
 
 For each stale or drifted document:
-1. Read the relevant source code files
-2. Update the specific section that changed
-3. Update the `docguard:last-reviewed` date to today
-4. If the change is intentional drift, add an entry to DRIFT-LOG.md
-5. Add entry to CHANGELOG.md under [Unreleased]
+1. **Decide which side is wrong first.** Canonical docs are the spec — if the
+   code regressed from a documented decision, flag the code (or record a
+   `// DRIFT: reason` + DRIFT-LOG.md entry); don't rewrite the doc to match a
+   regression.
+2. Sections inside `<!-- docguard:section ... source=code -->` markers are
+   regenerated — run `npx docguard-cli sync --write` instead of editing by hand.
+3. For hand-maintained sections: read the relevant source, update the specific
+   section, refresh `docguard:last-reviewed` to today.
+4. Add entry to CHANGELOG.md under [Unreleased].
 
-## Step 4: Verify
+## Step 5: Verify
 
 ```bash
 npx docguard-cli guard

{docguard_cli-0.27.0/extensions/spec-kit-docguard → docguard_cli-0.29.0/.agent}/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.27.0
+  version: 0.28.0
   source: extensions/spec-kit-docguard/skills/docguard-fix
 ---
-<!-- docguard:version: 0.27.0 -->
+<!-- docguard:version: 0.28.0 -->
 
 # DocGuard Fix Skill
 

{docguard_cli-0.27.0 → docguard_cli-0.29.0}/.agent/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.27.0
+  version: 0.28.0
   source: extensions/spec-kit-docguard/skills/docguard-guard
 ---
-<!-- docguard:version: 0.27.0 -->
+<!-- docguard:version: 0.28.0 -->
 
 # DocGuard Guard Skill
 

{docguard_cli-0.27.0/extensions/spec-kit-docguard → docguard_cli-0.29.0/.agent}/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.27.0
+  version: 0.28.0
   source: extensions/spec-kit-docguard/skills/docguard-review
 ---
-<!-- docguard:version: 0.27.0 -->
+<!-- docguard:version: 0.28.0 -->
 
 # DocGuard Review Skill
 

{docguard_cli-0.27.0/extensions/spec-kit-docguard → docguard_cli-0.29.0/.agent}/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.27.0
+  version: 0.28.0
   source: extensions/spec-kit-docguard/skills/docguard-score
 ---
-<!-- docguard:version: 0.27.0 -->
+<!-- docguard:version: 0.28.0 -->
 
 # DocGuard Score Skill
 

{docguard_cli-0.27.0/extensions/spec-kit-docguard → docguard_cli-0.29.0/.agent}/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.27.0
+  version: 0.28.0
   source: extensions/spec-kit-docguard/skills/docguard-sync
 ---
-<!-- docguard:version: 0.27.0 -->
+<!-- docguard:version: 0.28.0 -->
 
 # DocGuard Sync Skill
 

{docguard_cli-0.27.0 → docguard_cli-0.29.0}/.docguard.json

@@ -49,7 +49,7 @@
         "extract": "basename-no-ext",
         "ignore": [
           "agents", "hooks", "ci", "badge", "llms", "publish",
-          "setup", "impact"
+          "setup", "impact", "sync-tests"
         ],
         "docs": ["README.md"],
         "section": "Usage"

docguard_cli-0.29.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,21 @@
+# Pull Request
+
+## What & why
+
+<!-- One or two sentences: what changes, and what problem it solves. -->
+
+## CDD checklist (this repo guards itself)
+
+- [ ] `npx docguard-cli guard` passes locally (`--changed-only` for quick runs)
+- [ ] `npm test` passes (`node --test tests/*.test.mjs`)
+- [ ] `CHANGELOG.md` has an entry under `[Unreleased]`
+- [ ] Canonical docs updated if behavior changed (`docs-canonical/` — or a
+      `// DRIFT: reason` comment + `DRIFT-LOG.md` entry if the deviation is intentional)
+- [ ] New validator findings carry a stable code registered in `cli/findings.mjs`
+      (see CONTRIBUTING — findings rule)
+- [ ] Counts in prose (commands, validators) untouched or re-verified — guard's
+      `canonical-sync` will catch drift, but fixing it before CI is kinder
+
+## Screenshots / output
+
+<!-- For CLI-visible changes: paste the relevant before/after terminal output. -->

{docguard_cli-0.27.0 → docguard_cli-0.29.0}/.wolf/anatomy.md

@@ -1,7 +1,7 @@
 # anatomy.md
 
-> Auto-maintained by OpenWolf. Last scanned: 2026-06-19T19:17:33.183Z
-> Files: 589 tracked | Anatomy hits: 0 | Misses: 0
+> Auto-maintained by OpenWolf. Last scanned: 2026-07-03T20:32:09.442Z
+> Files: 649 tracked | Anatomy hits: 0 | Misses: 0
 
 ## ../../../../../../../tmp/
 
@@ -9,33 +9,35 @@
 
 ## ./
 
-- `.docguard.json` (~522 tok)
+- `.docguard.json` (~526 tok)
 - `.docguardignore` — # Python distribution artifacts (~199 tok)
 - `.DS_Store` (~3818 tok)
 - `.gitignore` — Git ignore rules (~167 tok)
 - `.jules-setup.sh` — Google Jules Environment Startup Script (~429 tok)
 - `.npmignore` — Development (~76 tok)
 - `.npmrc` — Supply-Chain Security Hardening (~59 tok)
-- `action.yml` — CI: 'DocGuard — CDD Compliance' (~4322 tok)
-- `AGENTS.md` — AI Agent Instructions — DocGuard (~1275 tok)
-- `CHANGELOG.md` — Changelog (~40407 tok)
+- `action.yml` — Declares fs (~7591 tok)
+- `AGENTS.md` — AI Agent Instructions — DocGuard (~1582 tok)
+- `CHANGELOG.md` — Changelog (~44379 tok)
 - `CLAUDE.md` — OpenWolf (~57 tok)
 - `CODE_OF_CONDUCT.md` — Contributor Covenant Code of Conduct (~532 tok)
 - `COMPARISONS.md` — Comparisons & Honest Limitations (~3053 tok)
-- `CONTRIBUTING.md` — Contributing to DocGuard (~1467 tok)
+- `CONTRIBUTING.md` — Contributing to DocGuard (~1780 tok)
 - `docguard-cli-0.22.0.tgz` (~80828 tok)
 - `docguard-cli-0.23.0.tgz` (~81238 tok)
-- `DRIFT-LOG.md` — Drift Log (~583 tok)
+- `DRIFT-LOG.md` — Drift Log (~711 tok)
 - `LICENSE` — Project license (~286 tok)
 - `package-lock.json` — npm lock file (~617 tok)
 - `package.json` — Node.js package manifest (~446 tok)
 - `PHILOSOPHY.md` — The Philosophy of Canonical-Driven Development (~1757 tok)
 - `pr_description.md` (~260 tok)
-- `pyproject.toml` — The enforcement tool for Canonical-Driven Development (CDD). Audit, generate, and guard your project (~351 tok)
-- `README.md` — Project documentation (~7411 tok)
-- `ROADMAP.md` — DocGuard Roadmap (~2193 tok)
+- `pyproject.toml` — The enforcement tool for Canonical-Driven Development (CDD). Audit, generate, and guard your project (~358 tok)
+- `README.es.md` — 🛡️ DocGuard (~1098 tok)
+- `README.md` — Project documentation (~8061 tok)
+- `README.pt-BR.md` — 🛡️ DocGuard (~1075 tok)
+- `ROADMAP.md` — DocGuard Roadmap (~2432 tok)
 - `SECURITY.md` — Security Policy (~357 tok)
-- `STANDARD.md` — DocGuard Standard v0.1 (~6435 tok)
+- `STANDARD.md` — DocGuard Standard v0.1 (~6533 tok)
 - `SUPPLY-CHAIN-AUDIT.md` — Supply-Chain Security Audit (~726 tok)
 - `SUPPORT.md` — Support (~335 tok)
 - `test-draft.js` — Declares tmpDir (~192 tok)
@@ -925,6 +927,10 @@
 - `mechanical.mjs` — Mechanical Fix Registry — applies deterministic, no-LLM fixes in place. (~3008 tok)
 - `sections.mjs` — Section-addressable docs — the foundation for surgical, non-destructive doc (~1676 tok)
 
+## .github/
+
+- `PULL_REQUEST_TEMPLATE.md` — Pull Request (~223 tok)
+
 ## .github/ISSUE_TEMPLATE/
 
 - `docguard-feedback.md` (~215 tok)
@@ -942,54 +948,126 @@
 ## cli/
 
 - `config.mjs` — DocGuard — configuration loading. (~3265 tok)
-- `docguard.mjs` — DocGuard CLI — The enforcement tool for Canonical-Driven Development (CDD) (~8443 tok)
-- `findings.mjs` — Findings — the structured, LLM-addressable result unit (v0.27). (~2174 tok)
-- `shared-ignore.mjs` — Shared Ignore Utility — Unified file filtering for all validators. (~2780 tok)
+- `docguard.mjs` — DocGuard CLI — The enforcement tool for Canonical-Driven Development (CDD) (~9439 tok)
+- `findings.mjs` — Findings — the structured, LLM-addressable result unit (v0.27). (~9378 tok)
+- `shared-ignore.mjs` — Shared Ignore Utility — Unified file filtering for all validators. (~4132 tok)
 - `shared-source.mjs` — Shared Source Resolution — Monorepo-aware source discovery. (~4655 tok)
+- `shared.mjs` — Shared constants for DocGuard CLI — colors, profiles, version. (~3496 tok)
 
 ## cli/commands/
 
 - `agent.mjs` — `docguard agent` — the one-shot agent task graph. (~1644 tok)
-- `explain.mjs` — Explain Command — v0.16-P6. (~9022 tok)
+- `agents.mjs` — Agents Command — Generate agent-specific config files from AGENTS.md (~3307 tok)
+- `diff.mjs` — Diff Command — Show differences between canonical docs and implementation (~4128 tok)
+- `explain.mjs` — Explain Command — v0.16-P6. (~9474 tok)
 - `feedback.mjs` — Feedback Command — close the loop with the tool's maintainers (v0.27). (~1920 tok)
-- `generate.mjs` — Generate Command — Reverse-engineer canonical docs from an existing codebase (~15364 tok)
-- `guard.mjs` — Guard Command — Validate project against its canonical documentation (~9556 tok)
-- `score.mjs` — Score Command — Calculate CDD maturity score (0-100) (~11214 tok)
+- `generate.mjs` — Generate Command — Reverse-engineer canonical docs from an existing codebase (~6250 tok)
+- `guard.mjs` — Guard Command — Validate project against its canonical documentation (~11608 tok)
+- `init.mjs` — Init Command — Initialize CDD documentation from templates (~7278 tok)
+- `llms.mjs` — llms Command — Generate llms.txt from canonical documentation (~2137 tok)
+- `mcp.mjs` — MCP Command — DocGuard as a Model Context Protocol server (stdio). (~2902 tok)
+- `memory.mjs` — Memory Command — v0.17-P2. (~2957 tok)
+- `score.mjs` — Score Command — Calculate CDD maturity score (0-100) (~12136 tok)
+- `sync-tests.mjs` — `docguard sync --tests` — reconcile the TEST-SPEC Source-to-Test Map from disk. (~3191 tok)
+- `sync.mjs` — Sync Command — keep the documentation memory ALWAYS UP TO DATE. (~2371 tok)
+- `verify.mjs` — Verify Command — `docguard verify --semantic` (LLM field report #5). (~833 tok)
 
 ## cli/scanners/
 
+- `agent-readability.mjs` — Agent Readability scanner — how well do this repo's docs serve an AI agent? (~2228 tok)
 - `inventory.mjs` — Inventory scanners — code-truth the generator PRE-FILLS instead of leaving (~1699 tok)
 - `memory-plan.mjs` — Memory Plan — the orchestration artifact behind AI-powered Generate. (~5744 tok)
 - `project-type.mjs` — Project-Type Detection — the language-agnostic spine. (~4190 tok)
 - `routes.mjs` — Deep Route Scanner (~7712 tok)
+- `semantic-claims.mjs` — Semantic claim extractor (LLM field report #5). (~1998 tok)
+- `speckit.mjs` — Spec Kit Scanner — Detect, validate, and integrate with GitHub Spec Kit (~4785 tok)
 
 ## cli/validators/
 
-- `doc-quality.mjs` — Doc Quality Validator — Measures documentation writing quality (~6349 tok)
-- `freshness.mjs` — Freshness Validator — Check if documentation is stale relative to code changes. (~3462 tok)
-- `metrics-consistency.mjs` — Metrics Consistency Validator — Detects stale hardcoded numbers in docs. (~2714 tok)
-- `security.mjs` — Security Validator — Basic checks for secrets in code (~2882 tok)
-- `todo-tracking.mjs` — TODO/FIXME Tracking Validator — Ensures code annotations are documented (~3644 tok)
+- `api-surface.mjs` — API-Surface Validator — Detects drift between the documented API surface (~5063 tok)
+- `architecture.mjs` — Architecture Validator — Enhanced with automatic import analysis (~3926 tok)
+- `canonical-sync.mjs` — Canonical-Sync Validator — v0.19-A. (~2947 tok)
+- `changelog.mjs` — Changelog Validator — Checks CHANGELOG.md has an [Unreleased] section, (~1050 tok)
+- `cross-reference.mjs` — Cross-Reference Validator — S-8 / K-7 (~4592 tok)
+- `doc-quality.mjs` — Doc Quality Validator — Measures documentation writing quality (~6826 tok)
+- `docs-coverage.mjs` — Docs-Coverage Validator — Detects code features not referenced in docs. (~5516 tok)
+- `docs-diff.mjs` — Docs-Diff Validator — Checks alignment between canonical docs and code. (~3326 tok)
+- `docs-sync.mjs` — Docs-Sync Validator — Checks that source files have matching canonical doc entries (~2949 tok)
+- `drift.mjs` — Drift Validator — Every // DRIFT: comment must have a DRIFT-LOG.md entry (~1290 tok)
+- `environment.mjs` — Environment Validator — Checks ENVIRONMENT.md docs and .env.example (~2085 tok)
+- `freshness.mjs` — Freshness Validator — Check if documentation is stale relative to code changes. (~3540 tok)
+- `generated-staleness.mjs` — Generated-Doc Staleness Validator — M-1 / S-7 (~2919 tok)
+- `metadata-sync.mjs` — Metadata Sync Validator — Detects stale version references across docs. (~2155 tok)
+- `metrics-consistency.mjs` — Metrics Consistency Validator — Detects stale hardcoded numbers in docs. (~3635 tok)
+- `schema-sync.mjs` — Schema Sync Validator — Ensures database schemas are documented in DATA-MODEL.md (~2108 tok)
+- `security.mjs` — Security Validator — Basic checks for secrets in code (~2831 tok)
+- `spec-kit.mjs` — Spec-Kit Validator — Validates Spec Kit artifacts (specs/, plans/, tasks/, constitution). (~224 tok)
+- `structure.mjs` — Structure Validator — Checks that all required CDD files exist (~1647 tok)
+- `surface-sync.mjs` — Surface-Sync Validator — item-level drift detection for enumerable surfaces. (~4219 tok)
+- `test-spec.mjs` — Test Spec Validator — Checks that tests exist per TEST-SPEC.md coverage rules (~4463 tok)
+- `todo-tracking.mjs` — TODO/FIXME Tracking Validator — Ensures code annotations are documented (~3916 tok)
+- `traceability.mjs` — Traceability Validator — Checks that canonical docs are linked to source code (~4324 tok)
 
 ## cli/writers/
 
 - `mechanical.mjs` — Mechanical Fix Registry — applies deterministic, no-LLM fixes in place. (~3290 tok)
+- `sarif.mjs` — SARIF 2.1.0 writer — `docguard guard --format sarif`. (~1315 tok)
+
+## docs-canonical/
+
+- `ARCHITECTURE.md` — Architecture (~2883 tok)
+- `DATA-MODEL.md` — Data Model (~1668 tok)
+- `REQUIREMENTS.md` — Requirements (~673 tok)
+- `SURFACE-AUDIT.md` — DocGuard Surface Audit (~5703 tok)
+
+## docs/
+
+- `ai-integration.md` — AI Integration Guide (~2024 tok)
+- `commands.md` — Commands Reference (~2157 tok)
+- `configuration.md` — Configuration (~1375 tok)
+- `faq.md` — Frequently Asked Questions (~1519 tok)
 
 ## extensions/spec-kit-docguard/
 
 - `extension.yml` (~1026 tok)
 
+## schemas/
+
+- `docguard-config.schema.json` — behavior: docs (~2889 tok)
+
+## templates/
+
+- `ENVIRONMENT.md.template` — Environment & Configuration (~394 tok)
+- `REQUIREMENTS.md.template` — Requirements (~632 tok)
+- `SECURITY.md.template` — Security (~342 tok)
+- `TEST-SPEC.md.template` — /*.ts --> | <!-- e.g. tests/unit/**/*.test.ts --> | Unit | (~771 tok)
+
+## templates/commands/
+
+- `docguard.fix.md` — /docguard.fix — Find and Fix CDD Documentation Issues (~771 tok)
+- `docguard.guard.md` — /docguard.guard — Validate CDD Compliance (~736 tok)
+- `docguard.init.md` — /docguard.init — Set Up CDD Documentation (~621 tok)
+- `docguard.review.md` — /docguard.review — Review Documentation vs Code (~630 tok)
+- `docguard.update.md` — /docguard.update — Update Docs After Code Changes (~499 tok)
+
 ## tests/
 
+- `agent-readability.test.mjs` — Declares metric (~1049 tok)
 - `agent.test.mjs` — Exports x (~1138 tok)
-- `commands.test.mjs` — DocGuard CLI Tests — Tests all commands and flags (~10304 tok)
+- `agents-sync.test.mjs` — CLI: run (~1367 tok)
+- `changelog.test.mjs` — Exports x, x (~1315 tok)
+- `commands.test.mjs` — DocGuard CLI Tests — Tests all commands and flags (~10442 tok)
 - `ensure-skills-idempotent.test.mjs` — v0.24 — Skill install is idempotent (field report, Issue D). (~1133 tok)
+- `field-report-3-deferred.test.mjs` — v0.28 — the detection-gap items deferred from LLM field report #3. (~3122 tok)
 - `field-report-3.test.mjs` — v0.27 — LLM field report #3. (~3315 tok)
 - `freshness.test.mjs` — runGit: commitOldCode (~3536 tok)
 - `inventory.test.mjs` — Declares make (~1048 tok)
+- `llms-full-pack.test.mjs` — CLI: run (~1304 tok)
+- `mcp.test.mjs` — MCP Server Tests — `docguard mcp` over stdio. (~2138 tok)
 - `mechanical.test.mjs` — Declares write (~1161 tok)
 - `memory-plan.test.mjs` — Exports u, Button (~1834 tok)
-- `metrics-consistency.test.mjs` — Declares guardResults (~1986 tok)
+- `metrics-consistency.test.mjs` — Declares guardResults (~3942 tok)
 - `metrics-dedup.test.mjs` — v0.14.1-N1 — Metrics-Consistency dedup. (~1450 tok)
 - `project-type.test.mjs` — Declares make (~2140 tok)
+- `sarif.test.mjs` — Declares CLI (~1455 tok)
 - `shared-source.test.mjs` — API routes: GET (4 endpoints) (~1714 tok)