Merge branch 'main' of github.com:BinarCode/aidocs-cli

Author: binaryk

.github/workflows/publish.yml

@@ -10,104 +10,133 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: write
+      id-token: write  # Required for trusted publishing to PyPI
 
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Get current version
-        id: current
+      - name: Get version from pyproject.toml
+        id: version
         run: |
           VERSION=$(grep -m1 'version = ' pyproject.toml | cut -d'"' -f2)
           echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "Current version: $VERSION"
-
-      - name: Determine version bump
-        id: bump
-        run: |
-          COMMIT_MSG=$(git log -1 --pretty=%B)
-          echo "Commit message: $COMMIT_MSG"
-
-          # Check if commit message indicates minor bump (feat/feature)
-          if echo "$COMMIT_MSG" | grep -qiE "^feat(\(.*\))?:|^feature(\(.*\))?:"; then
-            echo "bump=minor" >> $GITHUB_OUTPUT
-          else
-            echo "bump=patch" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Calculate new version
-        id: new
-        run: |
-          CURRENT="${{ steps.current.outputs.version }}"
-          BUMP="${{ steps.bump.outputs.bump }}"
-
-          IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
-
-          if [ "$BUMP" = "minor" ]; then
-            MINOR=$((MINOR + 1))
-            PATCH=0
-          else
-            PATCH=$((PATCH + 1))
-          fi
-
-          NEW_VERSION="$MAJOR.$MINOR.$PATCH"
-          echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
-          echo "New version: $NEW_VERSION (bump: $BUMP)"
+          echo "Version from pyproject.toml: $VERSION"
 
       - name: Check if version already released
         id: check
         run: |
-          NEW_VERSION="${{ steps.new.outputs.version }}"
-          if git tag | grep -q "^v$NEW_VERSION$"; then
+          VERSION="${{ steps.version.outputs.version }}"
+          if git tag | grep -q "^v$VERSION$"; then
             echo "skip=true" >> $GITHUB_OUTPUT
-            echo "Version v$NEW_VERSION already exists, skipping"
+            echo "Version v$VERSION already exists, skipping"
           else
             echo "skip=false" >> $GITHUB_OUTPUT
+            echo "Version v$VERSION not released yet"
           fi
 
-      - name: Update version in files
+      - name: Create tag and release
         if: steps.check.outputs.skip == 'false'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          NEW_VERSION="${{ steps.new.outputs.version }}"
+          VERSION="${{ steps.version.outputs.version }}"
+          COMMIT_MSG=$(git log -1 --pretty=%B | head -1)
 
-          # Update pyproject.toml
-          sed -i "s/^version = \".*\"/version = \"$NEW_VERSION\"/" pyproject.toml
+          git config user.name "GitHub Actions"
+          git config user.email "actions@github.com"
+          git tag -a "v$VERSION" -m "Release v$VERSION"
+          git push origin "v$VERSION"
 
-          # Update __init__.py
-          sed -i "s/__version__ = \".*\"/__version__ = \"$NEW_VERSION\"/" src/aidocs_cli/__init__.py
+          cat <<EOF | gh release create "v$VERSION" --title "v$VERSION" --notes-file -
+          ## Changes
 
-          echo "Updated version to $NEW_VERSION"
+          $COMMIT_MSG
 
-      - name: Commit version bump
+          ---
+          *Auto-generated release*
+          EOF
+
+      # Publish to PyPI
+      - name: Install uv
         if: steps.check.outputs.skip == 'false'
-        run: |
-          NEW_VERSION="${{ steps.new.outputs.version }}"
-          git config user.name "GitHub Actions"
-          git config user.email "actions@github.com"
-          git add pyproject.toml src/aidocs_cli/__init__.py
-          git commit -m "chore: bump version to $NEW_VERSION [skip ci]"
-          git push
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
 
-      - name: Create tag and release
+      - name: Set up Python
         if: steps.check.outputs.skip == 'false'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          NEW_VERSION="${{ steps.new.outputs.version }}"
-          COMMIT_MSG=$(git log -2 --pretty=%B | tail -n +3 | head -1)
+        run: uv python install 3.11
 
-          # Create tag
-          git tag -a "v$NEW_VERSION" -m "Release v$NEW_VERSION"
-          git push origin "v$NEW_VERSION"
+      - name: Build package
+        if: steps.check.outputs.skip == 'false'
+        run: uv build
 
-          # Create release
-          NOTES="## Changes
+      - name: Publish to PyPI
+        if: steps.check.outputs.skip == 'false'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
 
-          ${COMMIT_MSG}
+      # Update Homebrew formula
+      - name: Get release info for Homebrew
+        if: steps.check.outputs.skip == 'false'
+        id: homebrew
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          URL="https://github.com/${{ github.repository }}/archive/refs/tags/v$VERSION.tar.gz"
+          SHA256=$(curl -sL "$URL" | shasum -a 256 | cut -d' ' -f1)
 
-          ---
-          *Auto-generated release*"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "url=$URL" >> $GITHUB_OUTPUT
+          echo "sha256=$SHA256" >> $GITHUB_OUTPUT
 
-          gh release create "v$NEW_VERSION" --title "v$NEW_VERSION" --notes "$NOTES"
+          echo "Homebrew URL: $URL"
+          echo "Homebrew SHA256: $SHA256"
+
+      - name: Checkout homebrew-aidocs
+        if: steps.check.outputs.skip == 'false'
+        uses: actions/checkout@v4
+        with:
+          repository: binarcode/homebrew-aidocs
+          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+          path: homebrew-aidocs
+
+      - name: Update Homebrew formula
+        if: steps.check.outputs.skip == 'false'
+        run: |
+          cat > homebrew-aidocs/Formula/aidocs.rb << EOF
+          class Aidocs < Formula
+            include Language::Python::Virtualenv
+
+            desc "AI-powered documentation generator CLI for Claude Code"
+            homepage "https://github.com/binarcode/aidocs-cli"
+            url "${{ steps.homebrew.outputs.url }}"
+            sha256 "${{ steps.homebrew.outputs.sha256 }}"
+            license "MIT"
+
+            depends_on "python@3.11"
+
+            def install
+              venv = virtualenv_create(libexec, "python3.11")
+              venv.pip_install "aidocs==${{ steps.homebrew.outputs.version }}"
+              bin.install_symlink libexec/"bin/aidocs"
+            end
+
+            test do
+              assert_match "aidocs", shell_output("#{bin}/aidocs version")
+            end
+          end
+          EOF
+
+      - name: Commit and push Homebrew formula
+        if: steps.check.outputs.skip == 'false'
+        run: |
+          cd homebrew-aidocs
+          git config user.name "GitHub Actions"
+          git config user.email "actions@github.com"
+          git add Formula/aidocs.rb
+          git diff --staged --quiet || git commit -m "Update aidocs to ${{ steps.homebrew.outputs.version }}"
+          git push

.github/workflows/release.yml

@@ -0,0 +1,69 @@
+# Contributing to aidocs-cli
+
+Thank you for your interest in contributing to aidocs-cli!
+
+## Development Setup
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/binarcode/aidocs-cli.git
+   cd aidocs-cli
+   ```
+
+2. Install dependencies with uv:
+   ```bash
+   uv sync
+   ```
+
+3. Run locally:
+   ```bash
+   uv run aidocs --help
+   ```
+
+## Making Changes
+
+### Version Bump Required
+
+**Important:** When creating a PR, you must update the version number in two files:
+
+1. `pyproject.toml` - Update the `version` field
+2. `src/aidocs_cli/__init__.py` - Update the `__version__` variable
+
+Both files must have the same version number.
+
+### Version Format
+
+We use [Semantic Versioning](https://semver.org/):
+
+- **Patch** (0.15.x → 0.15.y): Bug fixes, minor changes
+- **Minor** (0.x.0 → 0.y.0): New features, non-breaking changes
+- **Major** (x.0.0 → y.0.0): Breaking changes
+
+### Why?
+
+Our release workflow reads the version from `pyproject.toml` and automatically:
+- Creates a GitHub release with that version
+- Publishes to PyPI
+- Updates the Homebrew formula
+
+If you don't bump the version, no release will be created when your PR is merged.
+
+## Pull Request Process
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Make your changes
+4. **Bump the version** in both files
+5. Commit your changes
+6. Push to your fork
+7. Open a Pull Request
+
+## Code Style
+
+- Follow PEP 8 for Python code
+- Use type hints where possible
+- Keep functions focused and well-documented
+
+## Questions?
+
+Open an issue if you have questions or need help.

.github/workflows/update-homebrew.yml

@@ -1,6 +1,6 @@
 [project]
 name = "aidocs"
-version = "0.14.2"
+version = "0.15.4"
 description = "AI-powered documentation generator for web applications. Install docs commands into your Claude Code project."
 readme = "README.md"
 license = { text = "MIT" }

CONTRIBUTING.md

@@ -1,6 +1,6 @@
 """AI-powered documentation generator CLI for Claude Code projects."""
 
-__version__ = "0.14.2"
+__version__ = "0.15.4"
 
 from .cli import app