Skip to content

BrainAPI is a knowledge graph–powered AI memory layer that transforms unstructured data into structured knowledge, enabling intelligent search, recommendations, and contextual memory for AI agents and applications.

ci: support development container release tags

Christian61dc3ec62400
diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index 13601e3..e787ad5 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -21,20 +21,12 @@ jobs:
with:
fetch-depth: 0
- id: tag
- shell: bash
- run: |
- if [[ "$GITHUB_REF_NAME" =~ ^v([0-9]+\.[0-9]+\.[0-9]+(-rc\.[0-9]+)?)$ ]]; then
- echo "version=${BASH_REMATCH[1]}" >> "$GITHUB_OUTPUT"
- else
- echo "Unsupported release tag: $GITHUB_REF_NAME" >&2
- exit 1
- fi
+ run: python scripts/release_version.py "$GITHUB_REF_NAME" >> "$GITHUB_OUTPUT"
- name: Require tag version to match project metadata
run: |
project_version=$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')
- tag_version="${{ steps.tag.outputs.version }}"
- normalized_version="${tag_version/-rc./rc}"
- test "$project_version" = "$normalized_version"
+ expected_version="${{ steps.tag.outputs.project_version }}"
+ test "$project_version" = "$expected_version"
- name: Require the tagged commit to be on main
run: git merge-base --is-ancestor "$GITHUB_SHA" origin/main
diff --git a/README.md b/README.md
index c5b7777..4337ae3 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
<p align="center">
<a href="https://discord.gg/VTngQTaeDf"><img src="https://img.shields.io/badge/Discord-Join%20Lumen%20Brain-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"/></a>
- <img src="https://img.shields.io/badge/version-2.17.0--dev-blue?style=for-the-badge" alt="Version"/>
+ <img src="https://img.shields.io/badge/version-2.19.0--dev-blue?style=for-the-badge" alt="Version"/>
<img src="https://img.shields.io/badge/python-3.11+-green?style=for-the-badge&logo=python&logoColor=white" alt="Python"/>
<img src="https://img.shields.io/badge/license-BUSL--1.1-blue?style=for-the-badge" alt="License"/>
</p>
diff --git a/deploy/env.heavy.example b/deploy/env.heavy.example
index 052731f..bb99c8f 100644
--- a/deploy/env.heavy.example
+++ b/deploy/env.heavy.example
@@ -225,7 +225,7 @@ TRACE_HEALTH_TIMEOUT_SECONDS=1
TRACE_AGENT_LOOP_ITERATIONS=20
TRACE_AGENT_TOOL_LOOP_ITERATIONS=20
# Compose inputs (pass this file with `docker compose --env-file`).
-BRAINAPI_IMAGE="ghcr.io/lumen-labs/brainapi:v2.17.0-rc.1"
+BRAINAPI_IMAGE="ghcr.io/lumen-labs/brainapi:v2.19.0-dev"
BRAINAPI_ENV_FILE="env.heavy.example"
BACKUP_DIR="/srv/brainapi/backups"
PLUGIN_FAILURE_POLICY="fail"
diff --git a/deploy/env.light.example b/deploy/env.light.example
index b98ca43..f828647 100644
--- a/deploy/env.light.example
+++ b/deploy/env.light.example
@@ -221,7 +221,7 @@ TRACE_HEALTH_TIMEOUT_SECONDS=1
TRACE_AGENT_LOOP_ITERATIONS=20
TRACE_AGENT_TOOL_LOOP_ITERATIONS=20
# Compose inputs (pass this file with `docker compose --env-file`).
-BRAINAPI_IMAGE="ghcr.io/lumen-labs/brainapi:v2.17.0-rc.1"
+BRAINAPI_IMAGE="ghcr.io/lumen-labs/brainapi:v2.19.0-dev"
BRAINAPI_ENV_FILE="env.light.example"
BACKUP_DIR="/srv/brainapi/backups"
PLUGIN_FAILURE_POLICY="fail"
diff --git a/pyproject.toml b/pyproject.toml
index 596ebc4..7d958be 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "brainapi2"
-version = "2.17.0rc1"
+version = "2.19.0.dev0"
description = "Version 2.x.x of the BrainAPI memory layer."
authors = [
{name = "Christian",email = "[email protected]"}
diff --git a/scripts/release_version.py b/scripts/release_version.py
new file mode 100644
index 0000000..239a304
--- /dev/null
+++ b/scripts/release_version.py
@@ -0,0 +1,69 @@
+"""Parse container release tags and normalize them to Python project versions."""
+
+from __future__ import annotations
+
+import re
+import sys
+from dataclasses import dataclass
+
+
+_STABLE_TAG = re.compile(r"^v(?P<base>\d+\.\d+\.\d+)$")
+_RC_TAG = re.compile(r"^v(?P<base>\d+\.\d+\.\d+)-rc\.(?P<number>\d+)$")
+_DEV_TAG = re.compile(
+ r"^v(?P<base>\d+\.\d+\.\d+)-dev(?:\.(?P<number>\d+))?$"
+)
+
+
+@dataclass(frozen=True)
+class ReleaseVersion:
+ tag_version: str
+ project_version: str
+
+
+def parse_release_tag(tag: str) -> ReleaseVersion:
+ """Return the container tag version and its PEP 440 project equivalent."""
+ if match := _STABLE_TAG.fullmatch(tag):
+ base = match.group("base")
+ return ReleaseVersion(tag_version=base, project_version=base)
+
+ if match := _RC_TAG.fullmatch(tag):
+ base = match.group("base")
+ number = match.group("number")
+ return ReleaseVersion(
+ tag_version=f"{base}-rc.{number}",
+ project_version=f"{base}rc{number}",
+ )
+
+ if match := _DEV_TAG.fullmatch(tag):
+ base = match.group("base")
+ number = match.group("number") or "0"
+ tag_version = f"{base}-dev"
+ if match.group("number") is not None:
+ tag_version = f"{tag_version}.{number}"
+ return ReleaseVersion(
+ tag_version=tag_version,
+ project_version=f"{base}.dev{number}",
+ )
+
+ raise ValueError(
+ f"Unsupported release tag: {tag}. Expected vX.Y.Z, vX.Y.Z-rc.N, "
+ "vX.Y.Z-dev, or vX.Y.Z-dev.N"
+ )
+
+
+def main(argv: list[str]) -> int:
+ if len(argv) != 2:
+ print(f"Usage: {argv[0]} <release-tag>", file=sys.stderr)
+ return 2
+ try:
+ release = parse_release_tag(argv[1])
+ except ValueError as error:
+ print(error, file=sys.stderr)
+ return 2
+ print(f"version={release.tag_version}")
+ print(f"project_version={release.project_version}")
+ return 0
+
+
+if __name__ == "__main__":
+ raise SystemExit(main(sys.argv))
diff --git a/tests/test_deploy_production_contract.py b/tests/test_deploy_production_contract.py
index b2bcfa0..1720183 100644
--- a/tests/test_deploy_production_contract.py
+++ b/tests/test_deploy_production_contract.py
@@ -185,6 +185,8 @@ def test_release_workflow_enforces_artifact_gate_before_publish():
)
assert "check_release_readiness.py gate-artifacts" in workflow
assert "needs: [validate-tag, verify-required-checks]" in workflow
+ assert 'python scripts/release_version.py "$GITHUB_REF_NAME"' in workflow
+ assert "steps.tag.outputs.project_version" in workflow
def test_mcp_has_only_one_lifespan_definition():
diff --git a/tests/test_release_version.py b/tests/test_release_version.py
new file mode 100644
index 0000000..e5d1f05
--- /dev/null
+++ b/tests/test_release_version.py
@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+import pytest
+
+from scripts.release_version import ReleaseVersion, parse_release_tag
+
+
+ ("tag", "expected"),
+ [
+ ("v2.19.0", ReleaseVersion("2.19.0", "2.19.0")),
+ ("v2.19.0-rc.1", ReleaseVersion("2.19.0-rc.1", "2.19.0rc1")),
+ ("v2.19.0-dev", ReleaseVersion("2.19.0-dev", "2.19.0.dev0")),
+ ("v2.19.0-dev.3", ReleaseVersion("2.19.0-dev.3", "2.19.0.dev3")),
+ ],
+)
+def test_parse_release_tag(tag: str, expected: ReleaseVersion):
+ assert parse_release_tag(tag) == expected
+
+
+ "tag",
+ [
+ "2.19.0",
+ "v2.19",
+ "v2.19.0-rc",
+ "v2.19.0-dev.foo",
+ "v2.19.0-beta.1",
+ ],
+)
+def test_parse_release_tag_rejects_unsupported_formats(tag: str):
+ with pytest.raises(ValueError, match="Unsupported release tag"):
+ parse_release_tag(tag)
diff --git a/uv.lock b/uv.lock
index 5c93f5e..37a3dbd 100644
--- a/uv.lock
+++ b/uv.lock
@@ -272,7 +272,7 @@ wheels = [
[[package]]
name = "brainapi2"
-version = "2.17.0rc1"
+version = "2.19.0.dev0"
source = { editable = "." }
dependencies = [
{ name = "anthropic" },