docguard-cli 0.25.0__tar.gz → 0.26.0__tar.gz

docguard_cli-0.26.0/.github/scripts/speckit-submission.py

@@ -0,0 +1,209 @@
+#!/usr/bin/env python3
+"""Build a spec-kit "Extension Submission" for DocGuard.
+
+Per github/spec-kit#2707 (maintainer mnriem) and spec-kit's Extension
+Publishing Guide, a community catalog add/update MUST go through the
+Extension Submission issue template
+(.github/ISSUE_TEMPLATE/extension_submission.yml) — NOT a direct PR editing
+catalog.community.json. This script never touches the spec-kit repo; it only
+prepares the submission so a human can open it through the real form (so
+GitHub auto-applies the template's labels and auto-assigns a maintainer).
+
+Two output modes:
+  --url   Print a prefilled issue-form URL. Open it, review, and submit
+          through the form. Checkbox groups can't be prefilled via URL, so
+          tick those by hand. Large fields may be truncated by URL length
+          limits — paste them from --body if so.
+  --body  Print Markdown mirroring every form field (a reliable copy/paste
+          source and an audit record).
+
+The field values live in ONE place below so --url and --body never drift.
+Only the version and download URL change per release.
+
+Usage: speckit-submission.py (--url|--body) <version> <download_url>
+"""
+import sys
+import json
+from urllib.parse import urlencode, quote
+
+FORM_URL = "https://github.com/github/spec-kit/issues/new"
+TEMPLATE = "extension_submission.yml"
+
+
+def changelog_section(version: str) -> str:
+    """Pull the release's CHANGELOG section, if available."""
+    try:
+        with open("CHANGELOG.md", encoding="utf-8") as f:
+            lines = f.readlines()
+    except FileNotFoundError:
+        lines = []
+    out, found = [], False
+    for line in lines:
+        if line.startswith(f"## [{version}]"):
+            found = True
+            continue
+        if found and line.startswith("## ["):
+            break
+        if found:
+            out.append(line.rstrip("\n"))
+    text = "\n".join(out).strip()
+    if not text:
+        text = (
+            f"See [CHANGELOG](https://github.com/raccioly/docguard/blob/main/"
+            f"CHANGELOG.md) for v{version} details."
+        )
+    return text
+
+
+def build(version: str, download_url: str):
+    catalog_entry = {
+        "docguard": {
+            "name": "DocGuard — CDD Enforcement",
+            "id": "docguard",
+            "description": (
+                "Canonical-Driven Development enforcement. Validates, scores, "
+                "and traces project documentation with automated checks, "
+                "AI-driven workflows, and spec-kit hooks. One pinned runtime "
+                "dependency; pure Node.js otherwise."
+            ),
+            "author": "raccioly",
+            "version": version,
+            "download_url": download_url,
+            "repository": "https://github.com/raccioly/docguard",
+            "homepage": "https://www.npmjs.com/package/docguard-cli",
+            "documentation": (
+                "https://github.com/raccioly/docguard/blob/main/"
+                "extensions/spec-kit-docguard/README.md"
+            ),
+            "changelog": (
+                "https://github.com/raccioly/docguard/blob/main/CHANGELOG.md"
+            ),
+            "license": "MIT",
+            "requires": {
+                "speckit_version": ">=0.1.0",
+                "tools": [
+                    {"name": "node", "version": ">=18.0.0", "required": True}
+                ],
+            },
+            "provides": {"commands": 6, "hooks": 3},
+            "tags": [
+                "documentation", "validation", "quality", "cdd",
+                "traceability", "ai-agents", "enforcement", "spec-kit",
+            ],
+            "verified": False,
+            "downloads": 0,
+            "stars": 0,
+        }
+    }
+
+    # (form-field-id, label, value). Order mirrors extension_submission.yml.
+    # `None`-valued ids are checkbox groups: rendered in --body, omitted in --url.
+    fields = [
+        ("extension-id", "Extension ID", "docguard"),
+        ("extension-name", "Extension Name", "DocGuard — CDD Enforcement"),
+        ("version", "Version", version),
+        ("description", "Description", catalog_entry["docguard"]["description"]),
+        ("author", "Author", "raccioly"),
+        ("repository", "Repository URL", "https://github.com/raccioly/docguard"),
+        ("download-url", "Download URL", download_url),
+        ("license", "License", "MIT"),
+        ("homepage", "Homepage (optional)", "https://www.npmjs.com/package/docguard-cli"),
+        ("documentation", "Documentation URL (optional)",
+         catalog_entry["docguard"]["documentation"]),
+        ("changelog", "Changelog URL (optional)",
+         "https://github.com/raccioly/docguard/blob/main/CHANGELOG.md"),
+        ("speckit-version", "Required Spec Kit Version", ">=0.1.0"),
+        ("required-tools", "Required Tools (optional)",
+         "- node (>=18.0.0) - required\n"
+         "- npx - required\n"
+         "- specify - optional (auto-initializes the SDD workflow during docguard init)"),
+        ("commands-count", "Number of Commands", "6"),
+        ("hooks-count", "Number of Hooks (optional)", "3"),
+        ("tags", "Tags",
+         "documentation, validation, quality, cdd, traceability, ai-agents, enforcement, spec-kit"),
+        ("features", "Key Features",
+         "- 19-validator quality gate with severity triage and a remediation plan\n"
+         "- AI-driven documentation repair with codebase research and validation loops\n"
+         "- Cross-document semantic consistency analysis (read-only review)\n"
+         "- CDD maturity score with an ROI-based improvement roadmap\n"
+         "- Reverse-engineers canonical docs from an existing codebase\n"
+         "- spec-kit workflow hooks (after_implement, before_tasks, after_tasks)"),
+        ("testing", "Testing Checklist", None),
+        ("requirements", "Submission Requirements", None),
+        ("testing-details", "Testing Details",
+         "**Tested on:** Linux + macOS with the spec-kit CLI.\n\n"
+         "**Install:**\n```bash\n"
+         f"specify extension add docguard --from {download_url}\n```\n\n"
+         "**Scenarios verified:**\n"
+         "1. Extension installs from the release ZIP without manifest validation errors.\n"
+         "2. All six `speckit.docguard.*` commands resolve and run.\n"
+         "3. The three workflow hooks register against spec-kit's lifecycle."),
+        ("example-usage", "Example Usage",
+         "```bash\n"
+         "# Install the extension\n"
+         f"specify extension add docguard --from {download_url}\n\n"
+         "# Run the documentation quality gate\n"
+         "/speckit.docguard.guard\n```"),
+        ("catalog-entry", "Proposed Catalog Entry",
+         "```json\n" + json.dumps(catalog_entry, indent=2) + "\n```"),
+        ("additional-context", "Additional Context",
+         "**This is an update to an existing catalog entry (`docguard`)** for a "
+         "new release — please bump the version and download URL on the current "
+         "entry rather than adding a duplicate.\n\n"
+         f"**Release notes (v{version}):**\n\n{changelog_section(version)}"),
+    ]
+
+    testing_items = [
+        "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",
+    ]
+    requirement_items = [
+        "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)",
+    ]
+    checkbox_items = {"testing": testing_items, "requirements": requirement_items}
+    return fields, checkbox_items, catalog_entry
+
+
+def render_body(fields, checkbox_items) -> str:
+    blocks = []
+    for fid, label, value in fields:
+        if value is None:  # checkbox group
+            ticked = "\n".join(f"- [x] {item}" for item in checkbox_items[fid])
+            blocks.append(f"### {label}\n\n{ticked}")
+        else:
+            blocks.append(f"### {label}\n\n{value}")
+    return "\n\n".join(blocks) + "\n"
+
+
+def render_url(fields, version) -> str:
+    params = {"template": TEMPLATE,
+              "title": f"[Extension]: Update DocGuard — CDD Enforcement (v{version})"}
+    for fid, _label, value in fields:
+        if value is None:
+            continue  # checkbox groups can't be prefilled via URL
+        params[fid] = value
+    return FORM_URL + "?" + urlencode(params, quote_via=quote)
+
+
+def main():
+    if len(sys.argv) != 4 or sys.argv[1] not in ("--url", "--body"):
+        print(__doc__)
+        sys.exit(1)
+    mode, version, download_url = sys.argv[1], sys.argv[2], sys.argv[3]
+    fields, checkbox_items, _ = build(version, download_url)
+    if mode == "--body":
+        sys.stdout.write(render_body(fields, checkbox_items))
+    else:
+        sys.stdout.write(render_url(fields, version) + "\n")
+
+
+if __name__ == "__main__":
+    main()

{docguard_cli-0.25.0 → docguard_cli-0.26.0}/.github/workflows/release.yml

@@ -197,17 +197,22 @@ jobs:
           TWINE_USERNAME: __token__
           TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
 
-  # ── Step 7: Sync Spec Kit community catalog ────────────────────────────
-  # Inlined here (rather than triggered via workflow_run from a sibling
-  # workflow) because workflow_run-triggered jobs get 401 on the
-  # `gh repo sync … --source github/spec-kit` API call even with a valid
-  # PAT in secrets. Same-workflow secret access is consistent — fixes the
-  # auto-sync that was failing on every release since the workflow_run
-  # auth quirk surfaced.
+  # ── Step 7: Prepare Spec Kit community catalog submission ──────────────
+  # Per spec-kit maintainer guidance (github/spec-kit#2707) and spec-kit's
+  # Extension Publishing Guide, a catalog add/update MUST go through the
+  # Extension Submission ISSUE TEMPLATE so GitHub auto-applies the template
+  # labels + auto-assigns a maintainer — NOT a direct PR editing
+  # catalog.community.json (the old fork-sync + patch-catalog.py + gh pr
+  # flow, now removed). This job does NOT touch github/spec-kit at all: it
+  # builds a prefilled issue-form link and opens a one-click reminder issue
+  # in THIS repo. A human submits the real form (so labels/assignment fire).
   sync-catalog:
     needs: [detect-version, build-extension, publish-npm, publish-pypi]
     if: needs.detect-version.outputs.changed == 'true'
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      issues: write # reminder issue in THIS repo only — never github/spec-kit
     steps:
       - name: Checkout docguard repo
         uses: actions/checkout@v6
@@ -217,118 +222,73 @@ jobs:
         run: |
           VERSION="${{ needs.detect-version.outputs.version }}"
           echo "version=$VERSION" >> "$GITHUB_OUTPUT"
-          echo "tag=v${VERSION}" >> "$GITHUB_OUTPUT"
           echo "download_url=https://github.com/raccioly/docguard/releases/download/v${VERSION}/spec-kit-docguard-v${VERSION}.zip" >> "$GITHUB_OUTPUT"
-          echo "updated_at=$(date -u +%Y-%m-%dT%H:%M:%SZ)" >> "$GITHUB_OUTPUT"
           echo "✅ Version: $VERSION"
 
-      - name: Extract release notes from CHANGELOG
-        id: notes
-        run: |
-          VERSION="${{ steps.meta.outputs.version }}"
-          NOTES=$(awk "/^## \\[${VERSION}\\]/{found=1; next} /^## \\[/{if(found) exit} found{print}" CHANGELOG.md)
-          if [ -z "$NOTES" ]; then
-            NOTES="Updated to v${VERSION}. See [CHANGELOG](https://github.com/raccioly/docguard/blob/main/CHANGELOG.md) for details."
-          fi
-          echo "$NOTES" > /tmp/changelog-section.md
-          echo "✅ Release notes extracted ($(wc -l < /tmp/changelog-section.md) lines)"
-
-      - name: Sync fork with upstream
-        env:
-          GH_TOKEN: ${{ secrets.SPECKIT_PR_TOKEN }}
-        run: |
-          gh repo sync raccioly/spec-kit --source github/spec-kit --branch main --force
-          echo "✅ Fork synced with upstream"
-
-      - name: Checkout spec-kit fork (fresh after sync)
-        uses: actions/checkout@v6
-        with:
-          repository: raccioly/spec-kit
-          token: ${{ secrets.SPECKIT_PR_TOKEN }}
-          path: spec-kit-fork
-          ref: main
-
-      - name: Update catalog.community.json
-        working-directory: spec-kit-fork
+      - name: Build prefilled submission link + body
         run: |
           VERSION="${{ steps.meta.outputs.version }}"
           DOWNLOAD_URL="${{ steps.meta.outputs.download_url }}"
-          UPDATED_AT="${{ steps.meta.outputs.updated_at }}"
-          cp ${{ github.workspace }}/.github/scripts/patch-catalog.py /tmp/patch-catalog.py
-          python3 /tmp/patch-catalog.py "$VERSION" "$DOWNLOAD_URL" "$UPDATED_AT"
+          python3 .github/scripts/speckit-submission.py --url "$VERSION" "$DOWNLOAD_URL" > /tmp/submit-url.txt
+          python3 .github/scripts/speckit-submission.py --body "$VERSION" "$DOWNLOAD_URL" > /tmp/submit-body.md
+          echo "✅ Built prefilled form URL ($(wc -c < /tmp/submit-url.txt) bytes) + body"
 
-      - name: Create or update branch
-        working-directory: spec-kit-fork
-        run: |
-          BRANCH="update-docguard"
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git checkout -B "$BRANCH"
-          git add extensions/catalog.community.json extensions/README.md
-          git commit -m "chore: update DocGuard extension to v${{ steps.meta.outputs.version }}" || echo "No changes to commit"
-          git push --force origin "$BRANCH"
-          echo "✅ Branch $BRANCH pushed"
-
-      - name: Create or update PR
-        working-directory: spec-kit-fork
+      - name: Open or refresh catalog-submission reminder (this repo)
         env:
-          GH_TOKEN: ${{ secrets.SPECKIT_PR_TOKEN }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           VERSION="${{ steps.meta.outputs.version }}"
-          BRANCH="update-docguard"
-          PR_TITLE="chore: update DocGuard extension to v${VERSION}"
-
-          cat > /tmp/pr-body.md << 'HEADER'
-          ## DocGuard Community Extension Update
-
-          Updates the DocGuard community extension catalog entry.
-
-          ### Changes
-          HEADER
-
-          echo "- Version: **v${VERSION}**" >> /tmp/pr-body.md
-          echo "- Download: \`spec-kit-docguard-v${VERSION}.zip\`" >> /tmp/pr-body.md
-          echo "- Repository: https://github.com/raccioly/docguard" >> /tmp/pr-body.md
-          echo "" >> /tmp/pr-body.md
-          echo "### Release Notes" >> /tmp/pr-body.md
-          echo "" >> /tmp/pr-body.md
-          cat /tmp/changelog-section.md >> /tmp/pr-body.md
-          echo "" >> /tmp/pr-body.md
-          echo "---" >> /tmp/pr-body.md
-          echo "*This PR was automatically generated by the DocGuard release pipeline.*" >> /tmp/pr-body.md
-
-          EXISTING_PR=$(gh pr list \
-            --repo github/spec-kit \
-            --head "raccioly:${BRANCH}" \
+          SUBMIT_URL=$(cat /tmp/submit-url.txt)
+          TITLE="📦 Submit DocGuard v${VERSION} to the spec-kit community catalog"
+
+          # Compose the reminder body: one-click prefilled form link + the full
+          # field-by-field body as a paste fallback (URL prefill can truncate).
+          {
+            echo "A new release (**v${VERSION}**) is out. Update the spec-kit"
+            echo "community catalog **via the Extension Submission issue template**"
+            echo "(NOT a PR — see github/spec-kit#2707)."
+            echo
+            echo "## 👉 One-click: open the prefilled submission form"
+            echo
+            echo "[**Open the Extension Submission form, prefilled for v${VERSION}**](${SUBMIT_URL})"
+            echo
+            echo "Then: review the fields, tick the two checkbox groups (Testing /"
+            echo "Requirements), and click **Submit new issue**. Submitting through"
+            echo "the form is what makes GitHub auto-apply labels and assign a"
+            echo "maintainer. If any long field came through truncated, paste it"
+            echo "from the copy below."
+            echo
+            echo "<details><summary>📋 Full submission body (copy/paste fallback)</summary>"
+            echo
+            cat /tmp/submit-body.md
+            echo
+            echo "</details>"
+          } > /tmp/reminder.md
+
+          # Idempotent per-version: refresh the existing reminder, else open one.
+          EXISTING=$(gh issue list \
+            --repo "$GITHUB_REPOSITORY" \
             --state open \
-            --json number \
-            --jq '.[0].number' 2>/dev/null || echo "")
-
-          if [ -z "$EXISTING_PR" ] || [ "$EXISTING_PR" = "null" ]; then
-            EXISTING_PR=$(gh pr list \
-              --repo github/spec-kit \
-              --state open \
-              --search "head:raccioly:${BRANCH}" \
-              --json number \
-              --jq '.[0].number' 2>/dev/null || echo "")
-          fi
+            --search "in:title \"DocGuard v${VERSION}\" spec-kit catalog" \
+            --json number,title \
+            --jq "[.[] | select(.title | contains(\"v${VERSION}\"))][0].number" 2>/dev/null || echo "")
 
-          if [ -n "$EXISTING_PR" ] && [ "$EXISTING_PR" != "null" ]; then
-            echo "Found existing PR #${EXISTING_PR} — updating title and body..."
-            gh pr edit "$EXISTING_PR" \
-              --repo github/spec-kit \
-              --title "$PR_TITLE" \
-              --body-file /tmp/pr-body.md
-            echo "✅ Updated existing PR #${EXISTING_PR} to v${VERSION}"
+          if [ -n "$EXISTING" ] && [ "$EXISTING" != "null" ]; then
+            gh issue edit "$EXISTING" --repo "$GITHUB_REPOSITORY" --body-file /tmp/reminder.md
+            echo "✅ Refreshed reminder issue #${EXISTING}"
           else
-            PR_URL=$(gh pr create \
-              --repo github/spec-kit \
-              --head "raccioly:${BRANCH}" \
-              --base main \
-              --title "$PR_TITLE" \
-              --body-file /tmp/pr-body.md 2>&1) && {
-              echo "✅ Created new PR: $PR_URL"
-            } || {
-              echo "⚠️ Could not create or find PR — branch was force-pushed with v${VERSION} content"
-            }
+            gh issue create --repo "$GITHUB_REPOSITORY" --title "$TITLE" --body-file /tmp/reminder.md
+            echo "✅ Opened catalog-submission reminder issue"
           fi
+
+      - name: Write run summary
+        run: |
+          VERSION="${{ steps.meta.outputs.version }}"
+          SUBMIT_URL=$(cat /tmp/submit-url.txt)
+          {
+            echo "### Spec Kit catalog submission — v${VERSION}"
+            echo
+            echo "[Open the prefilled Extension Submission form](${SUBMIT_URL})"
+            echo
+            echo "Submit it through the form (do **not** open a PR against the catalog)."
+          } >> "$GITHUB_STEP_SUMMARY"

docguard_cli-0.26.0/.github/workflows/sync-speckit-catalog.yml

@@ -0,0 +1,110 @@
+name: Prepare Spec Kit Catalog Submission (Manual)
+
+# Manual recovery only. The automatic version of this runs inside
+# release.yml (the `sync-catalog` job). Use this for one-off catalog
+# submissions outside the release flow, e.g. re-preparing after the
+# upstream issue was closed without action, or a metadata-only refresh.
+#
+# Per spec-kit maintainer guidance (github/spec-kit#2707) and spec-kit's
+# Extension Publishing Guide, a catalog add/update MUST go through the
+# Extension Submission ISSUE TEMPLATE so GitHub auto-applies the template
+# labels + auto-assigns a maintainer — NOT a direct PR editing
+# catalog.community.json. This workflow does NOT touch github/spec-kit: it
+# builds a prefilled issue-form link and a one-click reminder issue in THIS
+# repo. A human submits the real form so labels/assignment fire.
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Override version (leave empty to read from package.json)'
+        required: false
+        type: string
+
+permissions:
+  contents: read
+  issues: write # reminder issue in THIS repo only — never github/spec-kit
+
+jobs:
+  prepare-catalog-submission:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout docguard repo
+        uses: actions/checkout@v6
+
+      - name: Get version and metadata
+        id: meta
+        run: |
+          if [ -n "${{ inputs.version }}" ]; then
+            VERSION="${{ inputs.version }}"
+          else
+            VERSION=$(node -p "require('./package.json').version")
+          fi
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "download_url=https://github.com/raccioly/docguard/releases/download/v${VERSION}/spec-kit-docguard-v${VERSION}.zip" >> "$GITHUB_OUTPUT"
+          echo "✅ Version: $VERSION"
+
+      - name: Build prefilled submission link + body
+        run: |
+          VERSION="${{ steps.meta.outputs.version }}"
+          DOWNLOAD_URL="${{ steps.meta.outputs.download_url }}"
+          python3 .github/scripts/speckit-submission.py --url "$VERSION" "$DOWNLOAD_URL" > /tmp/submit-url.txt
+          python3 .github/scripts/speckit-submission.py --body "$VERSION" "$DOWNLOAD_URL" > /tmp/submit-body.md
+          echo "✅ Built prefilled form URL ($(wc -c < /tmp/submit-url.txt) bytes) + body"
+
+      - name: Open or refresh catalog-submission reminder (this repo)
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION="${{ steps.meta.outputs.version }}"
+          SUBMIT_URL=$(cat /tmp/submit-url.txt)
+          TITLE="📦 Submit DocGuard v${VERSION} to the spec-kit community catalog"
+
+          {
+            echo "Update the spec-kit community catalog for **v${VERSION}**"
+            echo "**via the Extension Submission issue template** (NOT a PR —"
+            echo "see github/spec-kit#2707)."
+            echo
+            echo "## 👉 One-click: open the prefilled submission form"
+            echo
+            echo "[**Open the Extension Submission form, prefilled for v${VERSION}**](${SUBMIT_URL})"
+            echo
+            echo "Then: review the fields, tick the two checkbox groups (Testing /"
+            echo "Requirements), and click **Submit new issue**. Submitting through"
+            echo "the form is what makes GitHub auto-apply labels and assign a"
+            echo "maintainer. If any long field came through truncated, paste it"
+            echo "from the copy below."
+            echo
+            echo "<details><summary>📋 Full submission body (copy/paste fallback)</summary>"
+            echo
+            cat /tmp/submit-body.md
+            echo
+            echo "</details>"
+          } > /tmp/reminder.md
+
+          EXISTING=$(gh issue list \
+            --repo "$GITHUB_REPOSITORY" \
+            --state open \
+            --search "in:title \"DocGuard v${VERSION}\" spec-kit catalog" \
+            --json number,title \
+            --jq "[.[] | select(.title | contains(\"v${VERSION}\"))][0].number" 2>/dev/null || echo "")
+
+          if [ -n "$EXISTING" ] && [ "$EXISTING" != "null" ]; then
+            gh issue edit "$EXISTING" --repo "$GITHUB_REPOSITORY" --body-file /tmp/reminder.md
+            echo "✅ Refreshed reminder issue #${EXISTING}"
+          else
+            gh issue create --repo "$GITHUB_REPOSITORY" --title "$TITLE" --body-file /tmp/reminder.md
+            echo "✅ Opened catalog-submission reminder issue"
+          fi
+
+      - name: Write run summary
+        run: |
+          VERSION="${{ steps.meta.outputs.version }}"
+          SUBMIT_URL=$(cat /tmp/submit-url.txt)
+          {
+            echo "### Spec Kit catalog submission — v${VERSION}"
+            echo
+            echo "[Open the prefilled Extension Submission form](${SUBMIT_URL})"
+            echo
+            echo "Submit it through the form (do **not** open a PR against the catalog)."
+          } >> "$GITHUB_STEP_SUMMARY"

{docguard_cli-0.25.0 → docguard_cli-0.26.0}/.wolf/anatomy.md

@@ -1,7 +1,11 @@
 # anatomy.md
 
-> Auto-maintained by OpenWolf. Last scanned: 2026-05-31T10:00:03.036Z
-> Files: 549 tracked | Anatomy hits: 0 | Misses: 0
+> Auto-maintained by OpenWolf. Last scanned: 2026-06-10T21:09:50.636Z
+> Files: 579 tracked | Anatomy hits: 0 | Misses: 0
+
+## ../../../../../../../tmp/
+
+- `append-buglog.mjs` — Declares path (~1335 tok)
 
 ## ./
 
@@ -14,7 +18,7 @@
 - `.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` — Change log (~35885 tok)
+- `CHANGELOG.md` — Changelog (~39309 tok)
 - `CLAUDE.md` — OpenWolf (~57 tok)
 - `CODE_OF_CONDUCT.md` — Contributor Covenant Code of Conduct (~532 tok)
 - `COMPARISONS.md` — Comparisons & Honest Limitations (~3053 tok)
@@ -27,8 +31,8 @@
 - `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` — Python project configuration (~376 tok)
-- `README.md` — Project documentation (~7230 tok)
+- `pyproject.toml` — The enforcement tool for Canonical-Driven Development (CDD). Audit, generate, and guard your project (~351 tok)
+- `README.md` — Project documentation (~7359 tok)
 - `ROADMAP.md` — DocGuard Roadmap (~1494 tok)
 - `SECURITY.md` — Security Policy (~357 tok)
 - `STANDARD.md` — DocGuard Standard v0.1 (~6435 tok)
@@ -920,3 +924,59 @@
 - `fix-memory.mjs` — Fix Memory — M-2 / S-10 (~1858 tok)
 - `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/scripts/
+
+- `speckit-submission-body.sh` — Build the body for a spec-kit "Extension Submission" issue. (~1482 tok)
+- `speckit-submission.py` — Build a spec-kit "Extension Submission" for DocGuard. (~2590 tok)
+
+## .github/workflows/
+
+- `release.yml` — CI: Auto Release — Tag, GitHub Release, npm, PyPI (~3386 tok)
+- `sync-speckit-catalog.yml` — CI: Prepare Spec Kit Catalog Submission (Manual) (~1385 tok)
+
+## cli/
+
+- `config.mjs` — DocGuard — configuration loading. (~3265 tok)
+- `docguard.mjs` — DocGuard CLI — The enforcement tool for Canonical-Driven Development (CDD) (~8124 tok)
+- `shared-ignore.mjs` — Shared Ignore Utility — Unified file filtering for all validators. (~2780 tok)
+- `shared-source.mjs` — Shared Source Resolution — Monorepo-aware source discovery. (~4357 tok)
+
+## cli/commands/
+
+- `agent.mjs` — `docguard agent` — the one-shot agent task graph. (~1644 tok)
+- `generate.mjs` — Generate Command — Reverse-engineer canonical docs from an existing codebase (~15364 tok)
+
+## cli/scanners/
+
+- `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)
+
+## cli/validators/
+
+- `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)
+
+## cli/writers/
+
+- `mechanical.mjs` — Mechanical Fix Registry — applies deterministic, no-LLM fixes in place. (~3290 tok)
+
+## extensions/spec-kit-docguard/
+
+- `extension.yml` (~1026 tok)
+
+## tests/
+
+- `agent.test.mjs` — Exports x (~1138 tok)
+- `commands.test.mjs` — DocGuard CLI Tests — Tests all commands and flags (~10304 tok)
+- `ensure-skills-idempotent.test.mjs` — v0.24 — Skill install is idempotent (field report, Issue D). (~1133 tok)
+- `freshness.test.mjs` — runGit: commitOldCode (~3536 tok)
+- `inventory.test.mjs` — Declares make (~1048 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-dedup.test.mjs` — v0.14.1-N1 — Metrics-Consistency dedup. (~1450 tok)
+- `project-type.test.mjs` — Declares make (~2140 tok)
+- `shared-source.test.mjs` — API routes: GET (4 endpoints) (~1714 tok)