feat: release please

Author: Matt Carey

.cursor/rules/release-please-standards.mdc

@@ -0,0 +1,77 @@
+---
+description: Standards for using release-please in the repository
+globs: "**/*"
+---
+# Release Please Standards
+
+Standards for managing releases with release-please in the repository.
+
+<rule>
+name: release_please_standards
+description: Standards for using release-please for versioning and releases
+
+filters:
+  - type: path
+    pattern: ".*"
+
+actions:
+  - type: suggest
+    message: |
+      When working with releases:
+
+      1. Configuration Files:
+         ```
+         .release-please-config.json    # Release configuration
+         .release-please-manifest.json  # Version tracking
+         .github/workflows/release.yml  # Release workflow
+         ```
+
+      2. Commit Message Format:
+         ```
+         # Features (0.1.0 -> 0.2.0)
+         feat: add new feature
+         feat!: breaking change feature
+
+         # Bug Fixes (0.1.0 -> 0.1.1)
+         fix: bug fix description
+
+         # No Version Change
+         docs: update readme
+         chore: update dependencies
+         test: add new tests
+         ```
+
+      3. Release Process:
+         - Push to main branch triggers release-please
+         - Release-please creates/updates release PR
+         - Merging release PR:
+           1. Updates CHANGELOG.md
+           2. Creates GitHub release
+           3. Publishes to PyPI using UV
+
+      4. Required Secrets:
+         ```
+         PYPI_API_TOKEN  # For publishing to PyPI
+         ```
+
+examples:
+  - input: |
+      # Bad commit messages
+      updated readme
+      fixed bug in api
+      added feature
+
+      # Good commit messages
+      docs: update installation guide
+      fix: handle API timeout errors
+      feat: add new CRM integration
+    output: "Correctly formatted commit messages"
+
+metadata:
+  priority: high
+  version: 1.0
+  tags:
+    - release
+    - versioning
+    - git
+</rule> 

.github/workflows/release.yml

@@ -0,0 +1,39 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: google-github-actions/release-please-action@v4
+        id: release
+        with:
+          config-file: .release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+      # Only release to PyPI when a new release is created
+      - uses: actions/checkout@v4
+        if: ${{ steps.release.outputs.release_created }}
+
+      - name: Install uv
+        if: ${{ steps.release.outputs.release_created }}
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build and publish package
+        if: ${{ steps.release.outputs.release_created }}
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          cd packages/stackone-ai
+          uv build --no-sources
+          uv publish

.release-please-config.json

@@ -0,0 +1,15 @@
+{
+  "packages": {
+    "packages/stackone-ai": {
+      "release-type": "python",
+      "changelog-path": "CHANGELOG.md",
+      "bump-minor-pre-major": true,
+      "bump-patch-for-minor-pre-major": true,
+      "draft": false,
+      "prerelease": false,
+      "include-component-in-tag": true,
+      "include-v-in-tag": true
+    }
+  },
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json"
+}

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  "packages/stackone-ai": "0.0.1"
+}