Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
Python agentagent-osaiai-agentsai-partnerchatopsclaudeclaude-codecodexdevtoolsdiscord-botlark-botllmlocal-firstlong-term-memoryopencodeslack-botvibe-codingvibeywechat
#!/usr/bin/env python3
"""Resolve an Avibe release tag to the package version used for builds."""
from __future__ import annotations
import argparse
import re
from collections.abc import Iterable, Sequence
from typing import Any
_VERSION_PATTERN = re.compile(
r"^(?P<release>[0-9]+\.[0-9]+\.[0-9]+)"
r"(?:[.-]?(?P<phase>a|b|rc|dev)(?P<phase_number>[0-9]+))?"
r"(?:\.post(?P<post_number>[0-9]+))?$"
)
def package_version_from_release_tag(tag: str) -> str:
normalized = tag.strip()
if normalized.startswith("gh-v"):
version = normalized.removeprefix("gh-v")
elif normalized.startswith("v"):
version = normalized.removeprefix("v")
else:
raise ValueError("release tag must start with 'v' or 'gh-v'")
match = _VERSION_PATTERN.fullmatch(version)
if not match or (match["phase"] == "dev" and match["post_number"] is not None):
raise ValueError(f"release tag does not contain a supported package version: {tag!r}")
# This bounded tag grammar is normalized without third-party dependencies:
# the helper also runs before build dependencies have been installed.
# Keep the original tag for release URLs, but use Hatch/PEP 440 spelling
# for distribution versions and filenames.
result = ".".join(str(int(part)) for part in match["release"].split("."))
if match["phase"]:
separator = "." if match["phase"] == "dev" else ""
result += f"{separator}{match['phase']}{int(match['phase_number'])}"
if match["post_number"] is not None:
result += f".post{int(match['post_number'])}"
if normalized.startswith("v") and normalized != f"v{result}":
raise ValueError(
f"official release tag must use canonical spelling v{result}; "
"release artifacts must match that exact version"
)
return result
def official_stable_version_key(tag: object) -> tuple[int, int, int, int] | None:
"""Order canonical stable official versions, excluding preview/engine tags."""
if not isinstance(tag, str) or not tag.startswith("v"):
return None
try:
version = package_version_from_release_tag(tag)
except ValueError:
return None
if tag != f"v{version}":
return None
match = _VERSION_PATTERN.fullmatch(version)
if match is None or match["phase"] is not None:
return None
major, minor, patch = (int(part) for part in match["release"].split("."))
post = int(match["post_number"]) if match["post_number"] is not None else -1
return major, minor, patch, post
def latest_official_release(releases: Iterable[Any]) -> dict[str, Any] | None:
"""Select by version, not repository-wide Latest or publication timestamp."""
selected = None
selected_key = None
for release in releases:
if not isinstance(release, dict):
raise ValueError("GitHub release collection must contain objects")
key = official_stable_version_key(release.get("tag_name"))
if key is None:
continue
if not isinstance(release.get("draft"), bool) or not isinstance(release.get("prerelease"), bool):
raise ValueError("Official release is missing draft/prerelease state")
if release["draft"] or release["prerelease"]:
continue
if selected_key is None or key > selected_key:
selected, selected_key = release, key
return selected
def main(argv: Sequence[str] | None = None) -> int:
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("tag", help="Release tag, for example gh-v3.0.10rc1")
args = parser.parse_args(argv)
try:
version = package_version_from_release_tag(args.tag)
except ValueError as exc:
parser.error(str(exc))
print(version)
return 0
if __name__ == "__main__":
raise SystemExit(main())