feat: add CI/CD workflows and version management

Add GitHub Actions for CI (pre-commit + tests on PR), version-check
(pyproject.toml and __init__.py consistency), auto-tag on merge to
main, and release creation on tag push. Add make bump target for
semver version bumping.

Author: stephen-kintsugi

.github/workflows/auto-tag.yml

@@ -0,0 +1,34 @@
+name: Auto Tag
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  auto-tag:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Create tag if needed
+        run: |
+          VERSION=$(grep '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/')
+          TAG="v${VERSION}"
+
+          echo "Detected version: $VERSION"
+          echo "Tag: $TAG"
+
+          if git rev-parse "$TAG" >/dev/null 2>&1; then
+            echo "Tag $TAG already exists. Nothing to do."
+            exit 0
+          fi
+
+          echo "Creating and pushing tag $TAG"
+          git tag "$TAG"
+          git push origin "$TAG"

.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install Poetry
+        uses: snok/install-poetry@v1
+        with:
+          version: latest
+          virtualenvs-create: true
+          virtualenvs-in-project: true
+
+      - name: Install dependencies
+        run: poetry install --no-interaction
+
+      - name: Run pre-commit hooks
+        run: poetry run pre-commit run --all-files
+
+      - name: Run tests
+        run: poetry run pytest tests/ -v

.github/workflows/release.yml

@@ -0,0 +1,25 @@
+name: Create Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Create GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          TAG="${GITHUB_REF#refs/tags/}"
+          gh release create "$TAG" \
+            --title "Release $TAG" \
+            --generate-notes

.github/workflows/version-check.yml

@@ -0,0 +1,29 @@
+name: Version Check
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  check-version-sync:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Check version consistency
+        run: |
+          PYPROJECT_VERSION=$(grep '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/')
+          INIT_VERSION=$(grep '^__version__ = ' squawk_alembic/__init__.py | sed 's/__version__ = "\(.*\)"/\1/')
+
+          echo "pyproject.toml version: $PYPROJECT_VERSION"
+          echo "__init__.py version:    $INIT_VERSION"
+
+          if [ "$PYPROJECT_VERSION" != "$INIT_VERSION" ]; then
+            echo "::error::Version mismatch: pyproject.toml ($PYPROJECT_VERSION) != __init__.py ($INIT_VERSION)"
+            echo "Run 'make bump VERSION=x.y.z' to update both files."
+            exit 1
+          fi
+
+          echo "Versions match."

Makefile

@@ -1,4 +1,6 @@
-.PHONY: setup_pre_commit run_pre-commit run_unit_tests run_ruff run_pyrefly clean help
+.PHONY: setup_pre_commit run_pre-commit run_unit_tests run_ruff run_pyrefly clean help bump
+
+INIT_PY := squawk_alembic/__init__.py
 
 # This trick comes from https://marmelab.com/blog/2016/02/29/auto-documented-makefile.html
 help:
@@ -23,3 +25,18 @@ run_pyrefly: ## Run pyrefly, a static type checker for Python
 clean: ## Clean up the project (e.g., remove cache files)
 	@find . -type f -name '*.pyc' -delete
 	@find . -type d -name '__pycache__' -delete
+
+bump: ## Bump version (usage: make bump VERSION=0.2.0)
+ifndef VERSION
+	$(error Usage: make bump VERSION=0.2.0)
+endif
+	@echo "Bumping version to $(VERSION)"
+	@if ! echo "$(VERSION)" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+$$'; then \
+		echo "Error: VERSION must be in semver format (e.g. 0.2.0)"; \
+		exit 1; \
+	fi
+	sed -i.bak 's/^version = ".*"/version = "$(VERSION)"/' pyproject.toml
+	rm -f pyproject.toml.bak
+	sed -i.bak 's/^__version__ = ".*"/__version__ = "$(VERSION)"/' $(INIT_PY)
+	rm -f $(INIT_PY).bak
+	@echo "Updated pyproject.toml and $(INIT_PY) to $(VERSION)"

squawk_alembic/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"