docguard-cli 0.24.0__tar.gz → 0.25.1__tar.gz

{docguard_cli-0.24.0/.claude/worktrees/gallant-bhabha-0b72fc/extensions/spec-kit-docguard → docguard_cli-0.25.1/.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.21.1
+  version: 0.25.0
   source: extensions/spec-kit-docguard/skills/docguard-fix
 ---
-<!-- docguard:version: 0.21.1 -->
+<!-- docguard:version: 0.25.0 -->
 
 # DocGuard Fix Skill
 

{docguard_cli-0.24.0/.claude/worktrees/objective-robinson-841179/extensions/spec-kit-docguard → docguard_cli-0.25.1/.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.23.0
+  version: 0.25.0
   source: extensions/spec-kit-docguard/skills/docguard-guard
 ---
-<!-- docguard:version: 0.23.0 -->
+<!-- docguard:version: 0.25.0 -->
 
 # DocGuard Guard Skill
 

{docguard_cli-0.24.0/.claude/worktrees/gallant-bhabha-0b72fc → docguard_cli-0.25.1}/.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.21.1
+  version: 0.25.0
   source: extensions/spec-kit-docguard/skills/docguard-review
 ---
-<!-- docguard:version: 0.21.1 -->
+<!-- docguard:version: 0.25.0 -->
 
 # DocGuard Review Skill
 

{docguard_cli-0.24.0/.claude/worktrees/gallant-bhabha-0b72fc → docguard_cli-0.25.1}/.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.21.1
+  version: 0.25.0
   source: extensions/spec-kit-docguard/skills/docguard-score
 ---
-<!-- docguard:version: 0.21.1 -->
+<!-- docguard:version: 0.25.0 -->
 
 # DocGuard Score Skill
 

{docguard_cli-0.24.0/.claude/worktrees/gallant-bhabha-0b72fc → docguard_cli-0.25.1}/.agent/skills/docguard-sync/SKILL.md

@@ -4,9 +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.21.1
+  version: 0.25.0
   source: extensions/spec-kit-docguard/skills/docguard-sync
 ---
+<!-- docguard:version: 0.25.0 -->
 
 # DocGuard Sync Skill
 

docguard_cli-0.25.1/.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.24.0/.claude/worktrees/gallant-bhabha-0b72fc → docguard_cli-0.25.1}/.github/workflows/release.yml

@@ -21,23 +21,28 @@ jobs:
     steps:
       - uses: actions/checkout@v6
         with:
-          fetch-depth: 2 # Need previous commit to compare
+          fetch-depth: 1 # only need HEAD's package.json; the tag check hits the remote
 
-      - name: Check if version changed
+      - name: Check if this version needs releasing
         id: check
         run: |
           CURRENT=$(node -p "require('./package.json').version")
-          # Get version from previous commit
-          PREVIOUS=$(git show HEAD~1:package.json 2>/dev/null | node -p "JSON.parse(require('fs').readFileSync('/dev/stdin','utf-8')).version" 2>/dev/null || echo "0.0.0")
+          TAG="v${CURRENT}"
           echo "current=$CURRENT"
-          echo "previous=$PREVIOUS"
-          if [ "$CURRENT" != "$PREVIOUS" ]; then
+          # TAG-DRIVEN gate (not HEAD~1): a version needs releasing iff no tag
+          # v$CURRENT exists yet. The old HEAD~1 comparison skipped the release
+          # whenever a push carried commits AFTER the version-bump commit (the
+          # bump wasn't the tip) — e.g. a batched push of several commits. It saw
+          # HEAD and HEAD~1 both already carrying the new version and wrongly
+          # concluded "unchanged", silently skipping npm/PyPI/GitHub-Release.
+          # Checking the tag is also idempotent: a re-run won't double-publish.
+          if git ls-remote --tags origin "refs/tags/$TAG" | grep -q "refs/tags/$TAG$"; then
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+            echo "⏭️ $TAG already released — nothing to do"
+          else
             echo "version=$CURRENT" >> "$GITHUB_OUTPUT"
             echo "changed=true" >> "$GITHUB_OUTPUT"
-            echo "✅ Version changed: $PREVIOUS → $CURRENT"
-          else
-            echo "changed=false" >> "$GITHUB_OUTPUT"
-            echo "⏭️ Version unchanged ($CURRENT), skipping release"
+            echo "✅ $TAG is not yet released — releasing"
           fi
 
   # ── Step 2: Run full test suite ────────────────────────────────────────
@@ -55,6 +60,8 @@ jobs:
       - uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
+      - name: Install dependencies
+        run: npm ci
       - name: Run Tests
         run: npm test
       - name: Guard (self-check)
@@ -190,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
@@ -210,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"
-
-      - 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"
+          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 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.25.1/.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"