feat: add release management with hatch-vcs (#50)

* feat: add release management with hatch-vcs and GitHub Actions

Derive version from git tags via hatch-vcs instead of hardcoding in
pyproject.toml and coral/__init__.py. Add GitHub Actions workflow that
builds, publishes to PyPI, and creates a GitHub Release with
auto-generated release notes on v* tag push.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: remove PyPI publish from release workflow

Keep it simple — only build and create GitHub Release with artifacts.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: BobbyZhouZijian

.github/release.yml

@@ -0,0 +1,13 @@
+changelog:
+  categories:
+    - title: Features
+      labels:
+        - enhancement
+        - feature
+    - title: Bug Fixes
+      labels:
+        - bug
+        - fix
+    - title: Other Changes
+      labels:
+        - "*"

.github/workflows/release.yml

@@ -0,0 +1,33 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Build & Release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install hatch
+        run: pip install hatch
+
+      - name: Build package
+        run: hatch build
+
+      - uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: dist/*

coral/__init__.py

@@ -1,6 +1,8 @@
 """CORAL - Orchestration system for autonomous coding agents."""
 
-__version__ = "0.2.0"
+from importlib.metadata import version
+
+__version__ = version("coral")
 
 from coral.types import Attempt, Score, ScoreBundle, Task
 from coral.config import CoralConfig

coral/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.1.dev69+g5c20c8819.d20260410'
+__version_tuple__ = version_tuple = (0, 1, 'dev69', 'g5c20c8819.d20260410')
+
+__commit_id__ = commit_id = None

pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-vcs"]
 build-backend = "hatchling.build"
 
 [project]
 name = "coral"
-version = "0.2.0"
+dynamic = ["version"]
 description = "Orchestration system for autonomous coding agents"
 readme = "README.md"
 license = "MIT"
@@ -61,6 +61,12 @@ coral = "coral.cli:main"
 Homepage = "https://github.com/Human-Agent-Society/CORAL"
 Repository = "https://github.com/Human-Agent-Society/CORAL"
 
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "coral/_version.py"
+
 [tool.hatch.build.targets.wheel]
 packages = ["coral"]