fix: stabilize PyPI deployment pipeline (#49)

* fix: stabilize PyPI deployment pipeline

Root cause: v0.4.2 tag pointed to a commit where version.py still said
0.4.1, causing PyPI to reject the duplicate version upload.

- Remove setup.py (conflicts with pyproject.toml: wrong python_requires,
  missing deps, causes setuptools warnings)
- Simplify publish.yml: replace 6 redundant pip/uv steps with uv build
  + twine check verification
- Fix pyproject.toml deprecations: SPDX license format, remove deprecated
  classifier, bump setuptools>=77.0.0
- Update _config.yml to remove deleted setup.py from exclude list
- Add PR workflow instructions to CLAUDE.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: pin Python 3.12 in publish workflow

Address review feedback: explicitly pin Python version via setup-uv
to avoid fragility when runner images update their default Python.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: auto-release on version bump

Add workflow that triggers when version.py changes on main:
- Extracts version from version.py
- Deletes stale tags pointing to wrong commits
- Creates GitHub Release (which triggers publish.yml → PyPI)

This makes the release flow fully automatic: merge PR with
version bump → auto-release → auto-publish to PyPI.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: OriNachum

.github/workflows/auto-release.yml

@@ -0,0 +1,56 @@
+name: Auto Release on Version Bump
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "src/open_responses_server/version.py"
+
+permissions:
+  contents: write
+
+jobs:
+  auto-release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Extract version
+        id: version
+        run: |
+          VERSION=$(python3 -c "import re; print(re.search(r'__version__\s*=\s*\"([^\"]+)\"', open('src/open_responses_server/version.py').read()).group(1))")
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "tag=v$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Check if release already exists
+        id: check
+        run: |
+          if gh release view "${{ steps.version.outputs.tag }}" >/dev/null 2>&1; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Delete stale tag if exists
+        if: steps.check.outputs.exists == 'false'
+        run: |
+          if git rev-parse "${{ steps.version.outputs.tag }}" >/dev/null 2>&1; then
+            git push origin ":refs/tags/${{ steps.version.outputs.tag }}" || true
+          fi
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Create GitHub Release
+        if: steps.check.outputs.exists == 'false'
+        run: |
+          gh release create "${{ steps.version.outputs.tag }}" \
+            --title "Release ${{ steps.version.outputs.tag }}" \
+            --generate-notes \
+            --target "${{ github.sha }}"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/publish.yml

@@ -15,32 +15,16 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Set up Python 3.x
-        uses: actions/setup-python@v5
+      - name: Install uv and Python
+        uses: astral-sh/setup-uv@v4
         with:
-          python-version: "3.x"
-
-      - name: Install uv
-        run: |
-          python -m pip install --upgrade pip
-          pip install uv
-
-      - name: Set up uv env
-        run: |
-          uv venv
-
-      - name: Install build dependencies with uv
-        run: |
-          uv pip install build setuptools wheel
-          uv pip install -e ".[dev]"
-
-      - name: Install build module
-        run: |
-          python -m pip install --upgrade pip
-          pip install build
+          python-version: "3.12"
 
       - name: Build release distributions
-        run: python -m build
+        run: uv build
+
+      - name: Verify distributions
+        run: uvx twine check dist/*
 
       - name: Upload distributions
         uses: actions/upload-artifact@v4
@@ -69,4 +53,4 @@ jobs:
       - name: Publish release distributions to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
-          packages-dir: dist/
+          packages-dir: dist/

CLAUDE.md

@@ -91,3 +91,7 @@ Version lives in `src/open_responses_server/version.py` as `__version__` and is
 ## CLI Entry Point
 
 The `otc` command is defined in `pyproject.toml` pointing to `open_responses_server.cli:main`. Commands: `start`, `configure`, `help`.
+
+## PR Workflow
+
+When a plan is ready and implementation is complete, create a PR and run the `/pr-review` skill. The PR review workflow should: wait 5 minutes for automated reviewers to run, then check every 2 minutes for completion before fetching and addressing review comments.

_config.yml

@@ -52,7 +52,6 @@ exclude:
   - demo/
   - examples/
   - pyproject.toml
-  - setup.py
   - uv.lock
   - run_tests.sh
   - release.py

pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools>=61.0", "wheel"]
+requires = ["setuptools>=77.0.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
@@ -10,7 +10,7 @@ authors = [
     { name = "Ori Nachum", email = "ori.nachum@gmail.com" }
 ]
 readme = "README.md"
-license = { text = "MIT" }
+license = "MIT"
 requires-python = ">=3.12"
 dependencies = [
     "mcp>=1.0.0",
@@ -24,7 +24,6 @@ dependencies = [
 ]
 classifiers = [
     "Programming Language :: Python :: 3",
-    "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Environment :: Web Environment",
 ]