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.
Python ai-agentsai-memoryknowledge-graphknowledge-managementknowledge-representationreccomendation-system
ci: support development container release tags
Christian61dc3ec62400
diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yamlindex 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 metadatarun: |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 mainrun: git merge-base --is-ancestor "$GITHUB_SHA" origin/maindiff --git a/README.md b/README.mdindex 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.exampleindex 052731f..bb99c8f 100644--- a/deploy/env.heavy.example+++ b/deploy/env.heavy.example@@ -225,7 +225,7 @@ TRACE_HEALTH_TIMEOUT_SECONDS=1TRACE_AGENT_LOOP_ITERATIONS=20TRACE_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.exampleindex b98ca43..f828647 100644--- a/deploy/env.light.example+++ b/deploy/env.light.example@@ -221,7 +221,7 @@ TRACE_HEALTH_TIMEOUT_SECONDS=1TRACE_AGENT_LOOP_ITERATIONS=20TRACE_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.tomlindex 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.pynew file mode 100644index 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.pyindex 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 workflowassert "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 workflowdef test_mcp_has_only_one_lifespan_definition():diff --git a/tests/test_release_version.py b/tests/test_release_version.pynew file mode 100644index 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.lockindex 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" },