spec-kitty-cli 0.2.20__tar.gz

spec_kitty_cli-0.2.20/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Global code owner
+* @localden

spec_kitty_cli-0.2.20/.github/workflows/docs-pages.yml

@@ -0,0 +1,60 @@
+name: Deploy Docs to GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'docs/**'
+      - 'examples/**'
+      - 'spec-driven.md'
+      - 'README.md'
+      - '.github/workflows/docs-pages.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup .NET SDK
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '7.0.x'
+
+      - name: Install DocFX
+        run: dotnet tool update --global docfx --version 2.76.0
+
+      - name: Build documentation
+        run: |
+          export PATH="$HOME/.dotnet/tools:$PATH"
+          docfx docs/docfx.json
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v2
+        with:
+          path: docs/_site
+
+  deploy:
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v3

spec_kitty_cli-0.2.20/.github/workflows/docs.yml

@@ -0,0 +1,67 @@
+# Build and deploy DocFX documentation to GitHub Pages
+name: Deploy Documentation to Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+    paths:
+      - 'docs/**'
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Fetch all history for git info
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.x'
+
+      - name: Setup DocFX
+        run: dotnet tool install -g docfx
+
+      - name: Build with DocFX
+        run: |
+          cd docs
+          docfx docfx.json
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'docs/_site'
+
+  # Deploy job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

spec_kitty_cli-0.2.20/.github/workflows/protect-main.yml

@@ -0,0 +1,114 @@
+name: Protect Main Branch
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  check-merge-compliance:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - name: Verify commit came from PR
+        run: |
+          # Skip check for repository initialization (first commit)
+          if [[ "${{ github.event.before }}" == "0000000000000000000000000000000000000000" ]]; then
+            echo "✅ Initial commit detected, skipping merge compliance check"
+            exit 0
+          fi
+
+          # Get commit message and metadata
+          COMMIT_MSG="${{ github.event.head_commit.message }}"
+          COMMITTER="${{ github.event.head_commit.committer.name }}"
+
+          echo "Commit message: $COMMIT_MSG"
+          echo "Committer: $COMMITTER"
+
+          # Check if this is a merge commit from a PR
+          # Valid patterns:
+          # 1. "Merge pull request #..." (GitHub merge commits)
+          # 2. Commits from "GitHub" or "github-actions[bot]" (automated merges)
+          # 3. Tag pushes (handled by release workflow, not direct commits)
+
+          if [[ "$COMMIT_MSG" =~ ^Merge\ pull\ request\ #[0-9]+ ]] || \
+             [[ "$COMMITTER" == "GitHub" ]] || \
+             [[ "$COMMITTER" == "github-actions[bot]" ]]; then
+            echo "✅ Commit is from an approved PR merge or automated process"
+            exit 0
+          fi
+
+          # Check if this is a squash/rebase merge
+          # GitHub squash merges include the PR number in the commit message
+          if [[ "$COMMIT_MSG" =~ \(#[0-9]+\) ]]; then
+            echo "✅ Commit is from a squash/rebase merge (contains PR reference)"
+            exit 0
+          fi
+
+          # If we get here, this appears to be a direct push
+          echo "::error::❌ Direct push to main branch detected!"
+          echo "::error::"
+          echo "::error::All changes to main must go through a pull request."
+          echo "::error::"
+          echo "::error::To fix this:"
+          echo "::error::1. Create a feature branch from the commit before this one"
+          echo "::error::2. Cherry-pick or reapply your changes to that branch"
+          echo "::error::3. Open a pull request for review"
+          echo "::error::"
+          echo "::error::To prevent this in the future:"
+          echo "::error::1. Enable branch protection rules for main:"
+          echo "::error::   - Go to Settings > Branches > Add rule"
+          echo "::error::   - Enable 'Require pull request reviews before merging'"
+          echo "::error::   - Enable 'Require status checks to pass before merging'"
+          echo "::error::"
+          echo "::error::📖 See: docs/releases/readiness-checklist.md for the complete workflow"
+
+          # Add to job summary
+          cat >> $GITHUB_STEP_SUMMARY <<EOF
+          # ❌ Direct Push Detected
+
+          This commit was pushed directly to \`main\` without going through a pull request.
+
+          ## Required Action
+
+          All changes to \`main\` must be reviewed via pull requests.
+
+          ### How to Fix
+
+          1. **Revert this commit** (if it hasn't been deployed):
+             \`\`\`bash
+             git revert HEAD
+             git push origin main
+             \`\`\`
+
+          2. **Create a feature branch**:
+             \`\`\`bash
+             git checkout -b fix/proper-pr-workflow
+             git cherry-pick <this-commit-sha>
+             git push origin fix/proper-pr-workflow
+             \`\`\`
+
+          3. **Open a pull request** for review
+
+          ### Prevent Future Issues
+
+          Enable branch protection rules:
+          - Go to **Settings > Branches > Add rule**
+          - Branch name pattern: \`main\`
+          - Enable **"Require pull request reviews before merging"**
+          - Enable **"Require status checks to pass before merging"**
+          - Select **release-readiness** as a required check
+
+          ## Reference
+
+          📖 [Release Readiness Checklist](https://github.com/${{ github.repository }}/blob/main/docs/releases/readiness-checklist.md)
+          EOF
+
+          exit 1

spec_kitty_cli-0.2.20/.github/workflows/release-readiness.yml

@@ -0,0 +1,105 @@
+name: Release Readiness Check
+
+on:
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Optional tag to validate (for dry runs)'
+        required: false
+        type: string
+  schedule:
+    # Run nightly to monitor drift
+    - cron: '0 2 * * *'
+
+concurrency:
+  group: release-readiness-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  check-readiness:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build tomli packaging pytest
+          pip install -e .[test]
+
+      - name: Run tests
+        run: |
+          echo "::group::Running test suite"
+          python -m pytest -v
+          echo "::endgroup::"
+
+      - name: Validate release metadata
+        id: validate
+        continue-on-error: true
+        run: |
+          if [[ -n "${{ inputs.tag }}" ]]; then
+            echo "Running validation in tag mode for dry run: ${{ inputs.tag }}"
+            python scripts/release/validate_release.py --mode tag --tag "${{ inputs.tag }}"
+          else
+            echo "Running validation in branch mode"
+            python scripts/release/validate_release.py --mode branch
+          fi
+
+      - name: Test packaging
+        run: |
+          echo "::group::Building wheel to catch packaging issues"
+          python -m build --wheel
+          echo "::endgroup::"
+
+      - name: Generate readiness summary
+        if: always()
+        run: |
+          echo "# Release Readiness Report" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+
+          if [[ "${{ steps.validate.outcome }}" == "success" ]]; then
+            echo "✅ **All readiness checks passed**" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "This branch is ready for release:" >> $GITHUB_STEP_SUMMARY
+            echo "- Version is properly bumped" >> $GITHUB_STEP_SUMMARY
+            echo "- Changelog entry exists and is populated" >> $GITHUB_STEP_SUMMARY
+            echo "- Version progression is monotonic" >> $GITHUB_STEP_SUMMARY
+            echo "- Tests pass" >> $GITHUB_STEP_SUMMARY
+            echo "- Package builds successfully" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **Readiness checks failed**" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "Please complete the following before merging:" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "### Required Actions" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "1. **Version Bump** - Update version in \`pyproject.toml\`" >> $GITHUB_STEP_SUMMARY
+            echo "2. **Changelog Entry** - Add release notes under \`## [X.Y.Z]\` in \`CHANGELOG.md\`" >> $GITHUB_STEP_SUMMARY
+            echo "3. **Version Progression** - Ensure new version > latest tag" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "See the validation output above for specific errors." >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "📖 **Reference**: [Release Readiness Checklist](https://github.com/${{ github.repository }}/blob/main/docs/releases/readiness-checklist.md)" >> $GITHUB_STEP_SUMMARY
+          fi
+
+      - name: Fail if validation failed
+        if: steps.validate.outcome != 'success'
+        run: |
+          echo "::error::Release readiness checks failed. Review the validation output and job summary for details."
+          exit 1

spec_kitty_cli-0.2.20/.github/workflows/release.yml

@@ -0,0 +1,95 @@
+name: Publish Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+
+      - name: Install tooling
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine tomli packaging pytest
+          pip install -e .[test]
+
+      - name: Run tests
+        run: python -m pytest
+
+      - name: Validate release metadata
+        run: python scripts/release/validate_release.py --mode tag --tag "${GITHUB_REF_NAME}"
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Check distributions
+        run: twine check dist/*.whl dist/*.tar.gz
+
+      - name: Extract changelog for release
+        id: changelog
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          python scripts/release/extract_changelog.py "${VERSION}" > release-notes.md
+          cat release-notes.md
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          skip-existing: true
+          verbose: true
+
+      - name: Record artifact checksums
+        if: success()
+        run: |
+          sha256sum dist/*.whl dist/*.tar.gz > SHA256SUMS.txt
+          cat SHA256SUMS.txt
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          body_path: release-notes.md
+          files: |
+            dist/*.whl
+            dist/*.tar.gz
+            SHA256SUMS.txt
+          draft: false
+          prerelease: false
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: release-distributions
+          path: |
+            dist/
+            SHA256SUMS.txt
+          retention-days: 30
+
+      - name: Report failure if secret missing
+        if: failure()
+        run: |
+          echo "::error::Release workflow failed. Common issues:"
+          echo "::error::1. PYPI_API_TOKEN secret is not configured"
+          echo "::error::2. Validation checks failed (version/changelog mismatch)"
+          echo "::error::3. Tests failed"
+          echo "::error::Check the logs above for specific failure reasons."

spec_kitty_cli-0.2.20/.github/workflows/scripts/check-release-exists.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# check-release-exists.sh
+# Check if a GitHub release already exists for the given version
+# Usage: check-release-exists.sh <version>
+
+if [[ $# -ne 1 ]]; then
+  echo "Usage: $0 <version>" >&2
+  exit 1
+fi
+
+VERSION="$1"
+
+if gh release view "$VERSION" >/dev/null 2>&1; then
+  echo "exists=true" >> $GITHUB_OUTPUT
+  echo "Release $VERSION already exists, skipping..."
+else
+  echo "exists=false" >> $GITHUB_OUTPUT
+  echo "Release $VERSION does not exist, proceeding..."
+fi

spec_kitty_cli-0.2.20/.github/workflows/scripts/create-github-release.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# create-github-release.sh
+# Create a GitHub release with all template zip files
+# Usage: create-github-release.sh <version>
+
+if [[ $# -ne 1 ]]; then
+  echo "Usage: $0 <version>" >&2
+  exit 1
+fi
+
+VERSION="$1"
+
+# Remove 'v' prefix from version for release title
+VERSION_NO_V=${VERSION#v}
+
+gh release create "$VERSION" \
+  .genreleases/spec-kitty-template-copilot-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-copilot-ps-"$VERSION".zip \
+  .genreleases/spec-kitty-template-claude-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-claude-ps-"$VERSION".zip \
+  .genreleases/spec-kitty-template-gemini-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-gemini-ps-"$VERSION".zip \
+  .genreleases/spec-kitty-template-cursor-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-cursor-ps-"$VERSION".zip \
+  .genreleases/spec-kitty-template-opencode-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-opencode-ps-"$VERSION".zip \
+  .genreleases/spec-kitty-template-qwen-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-qwen-ps-"$VERSION".zip \
+  .genreleases/spec-kitty-template-windsurf-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-windsurf-ps-"$VERSION".zip \
+  .genreleases/spec-kitty-template-codex-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-codex-ps-"$VERSION".zip \
+  .genreleases/spec-kitty-template-kilocode-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-kilocode-ps-"$VERSION".zip \
+  .genreleases/spec-kitty-template-auggie-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-auggie-ps-"$VERSION".zip \
+  .genreleases/spec-kitty-template-roo-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-roo-ps-"$VERSION".zip \
+  .genreleases/spec-kitty-template-q-sh-"$VERSION".zip \
+  .genreleases/spec-kitty-template-q-ps-"$VERSION".zip \
+  --title "Spec Kitty Templates - $VERSION_NO_V" \
+  --notes-file release_notes.md