chore: add github actions for pr quality gate and auto-release

Author: assignment-sets

.github/workflows/pr_quality.yaml

@@ -0,0 +1,26 @@
+name: PR Quality Gate
+
+on:
+  pull_request:
+    branches: [master]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Lint and Format Check
+        run: uv run poe check
+
+      - name: Run Tests with Coverage
+        run: uv run poe test

.github/workflows/release.yaml

@@ -0,0 +1,36 @@
+name: Auto Release & Publish
+
+on:
+  push:
+    branches: [master]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # MANDATORY for PyPI Trusted Publishing
+      contents: write # MANDATORY for Semantic Release to push tags/commits
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Required to read the git commit history
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Python Semantic Release
+        id: semantic
+        uses: python-semantic-release/python-semantic-release@v9
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+
+      # The step above automatically runs `uv build` (because we set it in pyproject.toml)
+      # BUT it only does this IF there are commits that trigger a release (feat:, fix:, etc.)
+
+      - name: Publish to PyPI
+        if: steps.semantic.outputs.released == 'true'
+        run: uv publish

pyproject.toml

@@ -29,6 +29,7 @@ dev = [
     "pre-commit>=4.5.1",
     "pytest>=9.0.2",
     "pytest-cov>=7.0.0",
+    "python-semantic-release>=10.5.3",
     "ruff>=0.15.2",
 ]
 
@@ -42,3 +43,9 @@ clean = """
 rm -rf .venv .ruff_cache .pytest_cache .coverage htmlcov dist build *.egg-info
 """
 lint = ["fix", "format"]
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+branch = "master"
+build_command = "uv build"
+commit_message = "chore(release): {version} [skip ci]"