ci: add release-please for versioned contract releases

.github/workflows/release-please.yml

@@ -0,0 +1,24 @@
+name: release-please
+
+# Cuts versioned contract-checkpoint releases (tag + GitHub release + CHANGELOG)
+# from conventional commits. These are contract snapshots, NOT a deploy gate.
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    if: github.repository == 'scaleapi/scale-agentex'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: googleapis/release-please-action@5c625bfb5d1ff62eadeeb3772007f7f66fdcf071 # v4.4.1
+        with:
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}

agentex/src/_version.py

@@ -0,0 +1,3 @@
+"""Single source of the agentex contract version (bumped by release-please)."""
+
+__version__ = "0.1.0"  # x-release-please-version

agentex/src/api/app.py

@@ -21,6 +21,7 @@
 from fastapi.responses import JSONResponse
 from fastapi.staticfiles import StaticFiles
 
+from src._version import __version__
 from src.adapters.crud_store.exceptions import ItemDoesNotExist
 from src.adapters.http.adapter_httpx import HttpxGateway
 from src.api.authentication_middleware import AgentexAuthMiddleware
@@ -108,6 +109,7 @@ async def lifespan(_: FastAPI):
 
 fastapi_app = FastAPI(
     title="Agentex API",
+    version=__version__,
     openapi_url="/openapi.json",
     docs_url="/swagger",
     redoc_url="/api",

release-please-config.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "include-v-in-tag": true,
+  "include-component-in-tag": false,
+  "bump-minor-pre-major": true,
+  "bump-patch-for-minor-pre-major": false,
+  "bootstrap-sha": "ab469df91bba043ea25356c89147d29f7df03bad",
+  "changelog-sections": [
+    { "type": "feat", "section": "Features" },
+    { "type": "fix", "section": "Bug Fixes" },
+    { "type": "perf", "section": "Performance Improvements" },
+    { "type": "revert", "section": "Reverts" },
+    { "type": "docs", "section": "Documentation" },
+    { "type": "refactor", "section": "Refactors" },
+    { "type": "chore", "section": "Chores", "hidden": true },
+    { "type": "test", "section": "Tests", "hidden": true },
+    { "type": "ci", "section": "Continuous Integration", "hidden": true },
+    { "type": "build", "section": "Build System", "hidden": true },
+    { "type": "style", "section": "Styles", "hidden": true }
+  ],
+  "packages": {
+    ".": {
+      "release-type": "python",
+      "package-name": "agentex",
+      "extra-files": [
+        "agentex/src/_version.py",
+        { "type": "yaml", "path": "agentex/openapi.yaml", "jsonpath": "$.info.version" },
+        { "type": "toml", "path": "agentex/pyproject.toml", "jsonpath": "$.project.version" }
+      ]
+    }
+  }
+}