From b82b899155711a5c9d1d4d2abf928ddbee4a0b96 Mon Sep 17 00:00:00 2001 From: tanmaycode1 Date: Thu, 29 Oct 2026 02:46:37 +0530 Subject: [PATCH 01/11] ci: publish every package whose version is not on its registry Releasing was by hand: bump the version, edit the CHANGELOG, merge, then twine/npm publish from a laptop, with a tag and a GitHub release only now and then (traceai-livekit-v0.1.2 is the one package tag). traceAI-crewai 0.1.9 was bumped but never published, traceAI-a2a and traceAI-minimax never at all, and 17 packages report a __version__ that differs from their pyproject.toml. release.yml runs on every push to main. A planner (.github/release/ release_plan.py, with tests) lists the 50 Python and 41 npm packages, asks PyPI and npm which versions exist, and hands the unpublished ones to two reusable workflows, the core packages first. Per package: build, twine check or pnpm pack, install in a clean environment and import (CommonJS and ESM for npm), check the installed version, publish (PyPI trusted publishing or PYPI_API_TOKEN; npm with provenance), wait until the registry serves it, tag `-v` / `npm--v`, and create the GitHub release from the package's CHANGELOG section (.github/release/release_notes.py). Until an owner adds the credentials (PYPI_TRUSTED_PUBLISHING=true with a trusted publisher per project, or PYPI_API_TOKEN; NPM_TOKEN) every run builds, checks and uploads the artifacts, then warns that nothing was published. Pull requests that touch a version only check and show the plan. workflow_dispatch takes a package list and a dry-run flag. `traceai` (python/traceai) is on the skip list: its PyPI name belongs to another publisher. The 17 __version__ strings now match their pyproject.toml, and the planner's --check (run in the workflow on every pull request) keeps them that way. CONTRIBUTING.md documents the process. Java and C# are not covered. Verified locally: planner tests, --check on the repository, a real plan (crewai 0.1.9, a2a 0.1.0 and minimax 0.1.0 would publish), the Python build + twine check + wheel smoke on traceAI-openai, the pnpm pack + tarball smoke on @traceai/openai, actionlint. --- .github/release/config.json | 6 + .github/release/release_notes.py | 47 ++++ .github/release/release_plan.py | 216 ++++++++++++++++++ .github/release/test_release_plan.py | 100 ++++++++ .github/workflows/release-python.yml | 132 +++++++++++ .github/workflows/release-typescript.yml | 133 +++++++++++ .github/workflows/release.yml | 209 +++++++++++++++++ CONTRIBUTING.md | 26 +++ .../anthropic/traceai_anthropic/version.py | 2 +- .../bedrock/traceai_bedrock/version.py | 2 +- .../frameworks/dspy/traceai_dspy/version.py | 2 +- .../traceai_google_genai/version.py | 2 +- .../frameworks/groq/traceai_groq/version.py | 2 +- .../haystack/traceai_haystack/version.py | 2 +- .../litellm/traceai_litellm/version.py | 2 +- .../llama_index/traceai_llamaindex/version.py | 2 +- python/frameworks/mcp/traceai_mcp/version.py | 2 +- .../mistralai/traceai_mistralai/version.py | 2 +- .../traceai_openai_agents/version.py | 2 +- .../openai/traceai_openai/version.py | 2 +- .../pipecat/traceai_pipecat/__init__.py | 2 +- .../pipecat/traceai_pipecat/version.py | 2 +- .../portkey/traceai_portkey/version.py | 2 +- .../smolagents/traceai_smolagents/version.py | 2 +- .../vertexai/traceai_vertexai/version.py | 2 +- 25 files changed, 886 insertions(+), 17 deletions(-) create mode 100644 .github/release/config.json create mode 100644 .github/release/release_notes.py create mode 100644 .github/release/release_plan.py create mode 100644 .github/release/test_release_plan.py create mode 100644 .github/workflows/release-python.yml create mode 100644 .github/workflows/release-typescript.yml create mode 100644 .github/workflows/release.yml diff --git a/.github/release/config.json b/.github/release/config.json new file mode 100644 index 000000000..c90cb2838 --- /dev/null +++ b/.github/release/config.json @@ -0,0 +1,6 @@ +{ + "_comment": "Packages release.yml never publishes, with the reason. Everything else under python/, python/frameworks/ and typescript/packages/ is published when its version is not on its registry.", + "skip": { + "traceai": "the PyPI name traceai belongs to another publisher; the package has no registry name yet" + } +} diff --git a/.github/release/release_notes.py b/.github/release/release_notes.py new file mode 100644 index 000000000..201bc2e77 --- /dev/null +++ b/.github/release/release_notes.py @@ -0,0 +1,47 @@ +#!/usr/bin/env python3 +"""The GitHub release notes of one package version: its CHANGELOG section, plus the install line. + + python3 .github/release/release_notes.py NAME VERSION [--changelog PATH] [--install "pip install ..."] +""" +from __future__ import annotations + +import argparse +import re +import sys +from pathlib import Path + +HEADING = re.compile(r"^##\s+\[?v?(?P[0-9][^\]\s]*)\]?.*$", re.M) + + +def section(text: str, version: str) -> str | None: + """The body under ``## [version]`` (Keep a Changelog) or ``## version ...``, or None.""" + heads = list(HEADING.finditer(text)) + for i, h in enumerate(heads): + if h.group("version") == version: + end = heads[i + 1].start() if i + 1 < len(heads) else len(text) + return text[h.end():end].strip() or None + return None + + +def notes(name: str, version: str, *, changelog_text: str | None, install: str, changelog_path: str | None = None) -> str: + body = section(changelog_text, version) if changelog_text else None + where = f" (`{changelog_path}`)" if changelog_path else "" + if body is None: + body = f"_This version has no CHANGELOG entry{where}; see the commits since the previous tag._" + return f"{body}\n\n**Install:** `{install}`\n" + + +def main(argv: list[str] | None = None) -> int: + ap = argparse.ArgumentParser(description=__doc__) + ap.add_argument("name") + ap.add_argument("version") + ap.add_argument("--changelog", help="the package's CHANGELOG.md") + ap.add_argument("--install", required=True, help="the install command to print") + args = ap.parse_args(argv) + text = Path(args.changelog).read_text() if args.changelog and Path(args.changelog).is_file() else None + sys.stdout.write(notes(args.name, args.version, changelog_text=text, install=args.install, changelog_path=args.changelog if text else None)) + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/.github/release/release_plan.py b/.github/release/release_plan.py new file mode 100644 index 000000000..d4c230593 --- /dev/null +++ b/.github/release/release_plan.py @@ -0,0 +1,216 @@ +#!/usr/bin/env python3 +"""Which packages of this repository are ready to publish. + +A package is "ready" when the version in its ``pyproject.toml`` / ``package.json`` is not on +its registry yet (PyPI or npm). Releasing is therefore still a version bump plus a changelog +entry in a normal pull request; the workflow in ``.github/workflows/release.yml`` does the +building, checking, publishing, tagging and the GitHub release. + + python3 .github/release/release_plan.py plan JSON on stdout (asks PyPI and npm) + python3 .github/release/release_plan.py --offline every package, no registry calls (dry runs, tests) + python3 .github/release/release_plan.py --check exit 1 when a package's __version__ disagrees + with its pyproject.toml, or a name is duplicated + python3 .github/release/release_plan.py --only NAME.. limit the plan to these package names + +Packages: ``python/pyproject.toml`` (the core, fi-instrumentation-otel), ``python/traceai/``, +every ``python/frameworks//pyproject.toml``, and every non-private +``typescript/packages//package.json``. ``config.json`` next to this file lists packages +that are never published, with the reason. Java (JitPack from tags) and C# are not covered. + +Plan shape:: + + {"python": [{"name", "version", "dir", "import_name", "tag", "core", "changelog"}, ...], + "typescript": [{"name", "version", "dir", "tag", "core", "changelog"}, ...]} + +``core`` marks the packages the others depend on (fi-instrumentation-otel, @traceai/fi-core, +@traceai/fi-semantic-conventions); the workflow publishes those first. +""" +from __future__ import annotations + +import argparse +import json +import os +import re +import sys +import urllib.error +import urllib.request +from pathlib import Path + +REPO_ROOT = Path(__file__).resolve().parents[2] +CONFIG = Path(__file__).resolve().parent / "config.json" +PYTHON_CORE = {"fi-instrumentation-otel"} +TS_CORE = {"@traceai/fi-core", "@traceai/fi-semantic-conventions"} +VERSION_RE = re.compile(r'^__version__\s*=\s*["\']([^"\']+)["\']', re.M) + + +def _toml_str(text: str, key: str) -> str | None: + m = re.search(rf'^{key}\s*=\s*"([^"]*)"', text, re.M) + return m.group(1) if m else None + + +def pypi_normalize(name: str) -> str: + """PEP 503 name normalisation: traceAI-DSPy -> traceai-dspy.""" + return re.sub(r"[-_.]+", "-", name).lower() + + +def import_name(pyproject_text: str, pkg_dir: Path) -> str | None: + """The top-level module a wheel installs, from the poetry or hatch package list.""" + m = re.search(r'include\s*=\s*"([^"/]+)"', pyproject_text) # poetry: packages = [{ include = "x" }] + candidates = [m.group(1)] if m else [] + m = re.search(r"^packages\s*=\s*\[([^\]]*)\]", pyproject_text, re.M) # hatch: packages = ["src/x"] + if m: + candidates += [p.strip().strip('"\'').split("/")[-1] for p in m.group(1).split(",") if p.strip()] + for c in candidates: + if (pkg_dir / c).is_dir() or (pkg_dir / "src" / c).is_dir(): + return c + return None + + +def declared_versions(pkg_dir: Path, module: str | None) -> dict[str, str]: + """``__version__`` strings the package itself carries: {relative file: version}.""" + out: dict[str, str] = {} + if not module: + return out + for base in (pkg_dir / module, pkg_dir / "src" / module): + for f in (base / "version.py", base / "__init__.py"): + if f.is_file(): + m = VERSION_RE.search(f.read_text()) + if m: + out[str(f.relative_to(pkg_dir))] = m.group(1) + return out + + +def python_packages(root: Path = REPO_ROOT) -> list[dict]: + dirs = [root / "python", root / "python" / "traceai"] + sorted(p for p in (root / "python" / "frameworks").iterdir() if p.is_dir()) + out = [] + for d in dirs: + f = d / "pyproject.toml" + if not f.is_file(): + continue + text = f.read_text() + name, version = _toml_str(text, "name"), _toml_str(text, "version") + if not name or not version: + continue + module = import_name(text, d) + out.append({ + "ecosystem": "python", + "name": name, + "version": version, + "dir": str(d.relative_to(root)), + "import_name": module, + "tag": f"{pypi_normalize(name)}-v{version}", + "core": name in PYTHON_CORE, + "changelog": str((d / "CHANGELOG.md").relative_to(root)) if (d / "CHANGELOG.md").is_file() else None, + "declared": declared_versions(d, module), + }) + return out + + +def typescript_packages(root: Path = REPO_ROOT) -> list[dict]: + out = [] + for d in sorted(p for p in (root / "typescript" / "packages").iterdir() if p.is_dir()): + f = d / "package.json" + if not f.is_file(): + continue + pkg = json.loads(f.read_text()) + if pkg.get("private") or not pkg.get("name") or not pkg.get("version"): + continue + name = pkg["name"] + out.append({ + "ecosystem": "typescript", + "name": name, + "version": pkg["version"], + "dir": str(d.relative_to(root)), + "tag": f"npm-{name.lstrip('@').replace('/', '-')}-v{pkg['version']}", + "core": name in TS_CORE, + "changelog": str((d / "CHANGELOG.md").relative_to(root)) if (d / "CHANGELOG.md").is_file() else None, + }) + return out + + +def load_config(path: Path = CONFIG) -> dict: + return json.loads(path.read_text()) if path.is_file() else {"skip": {}} + + +def consistency_problems(packages: list[dict]) -> list[str]: + """A __version__ that disagrees with the package version, or two packages with one name.""" + problems = [] + seen: dict[str, str] = {} + for p in packages: + key = f"{p['ecosystem']}:{pypi_normalize(p['name']) if p['ecosystem'] == 'python' else p['name']}" + if key in seen: + problems.append(f"{p['dir']}: name {p['name']} is also used by {seen[key]}") + seen[key] = p["dir"] + for rel, v in p.get("declared", {}).items(): + if v != p["version"]: + problems.append(f"{p['dir']}/{rel}: __version__ is {v} but pyproject.toml says {p['version']}") + return problems + + +def _get_json(url: str) -> dict | None: + req = urllib.request.Request(url, headers={"Accept": "application/json", "User-Agent": "traceAI-release-plan"}) + try: + with urllib.request.urlopen(req, timeout=30) as r: + return json.load(r) + except urllib.error.HTTPError as e: + if e.code == 404: + return None + raise + + +def published_versions(p: dict) -> set[str] | None: + """Versions the registry has for this package; None when the name does not exist there.""" + if p["ecosystem"] == "python": + d = _get_json(f"https://pypi.org/pypi/{p['name']}/json") + return set(d["releases"]) if d else None + d = _get_json("https://registry.npmjs.org/" + p["name"].replace("/", "%2F")) + return set(d.get("versions", {})) if d else None + + +def plan(packages: list[dict], config: dict, *, offline: bool = False, only: set[str] | None = None) -> dict: + out: dict = {"python": [], "typescript": [], "skipped": []} + skip = config.get("skip", {}) + for p in packages: + if only and p["name"] not in only: + continue + if p["name"] in skip: + out["skipped"].append({"name": p["name"], "reason": skip[p["name"]]}) + continue + if not offline: + have = published_versions(p) + if have is not None and p["version"] in have: + out["skipped"].append({"name": p["name"], "reason": f"{p['version']} is already published"}) + continue + p = {**p, "first_release": have is None} + entry = {k: v for k, v in p.items() if k not in ("declared", "ecosystem")} + out[p["ecosystem"]].append(entry) + for eco in ("python", "typescript"): + out[eco].sort(key=lambda e: (not e["core"], e["name"].lower())) + return out + + +def main(argv: list[str] | None = None) -> int: + ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + ap.add_argument("--offline", action="store_true", help="list every package without asking the registries") + ap.add_argument("--check", action="store_true", help="only check version consistency; exit 1 on a problem") + ap.add_argument("--only", nargs="*", metavar="NAME", help="limit the plan to these package names") + ap.add_argument("--root", default=str(REPO_ROOT), help=argparse.SUPPRESS) + args = ap.parse_args(argv) + root = Path(args.root) + packages = python_packages(root) + typescript_packages(root) + problems = consistency_problems(packages) + if problems: + for pr in problems: + print(f"release: {pr}", file=sys.stderr) + return 1 + if args.check: + print(f"release: {len(packages)} packages, versions consistent", file=sys.stderr) + return 0 + result = plan(packages, load_config(), offline=args.offline, only=set(args.only or []) or None) + json.dump(result, sys.stdout, indent=2) + print() + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/.github/release/test_release_plan.py b/.github/release/test_release_plan.py new file mode 100644 index 000000000..290ae363a --- /dev/null +++ b/.github/release/test_release_plan.py @@ -0,0 +1,100 @@ +"""Tests of the release planner, on a small repository laid out like this one (no network).""" +import json +import os +import sys +import tempfile +import unittest +from pathlib import Path + +sys.path.insert(0, os.path.dirname(__file__)) + +import release_notes # noqa: E402 +import release_plan # noqa: E402 + + +def write(path: Path, text: str) -> None: + path.parent.mkdir(parents=True, exist_ok=True) + path.write_text(text) + + +class FakeRepo: + def __init__(self): + self.tmp = tempfile.TemporaryDirectory() + self.root = Path(self.tmp.name) + write(self.root / "python/pyproject.toml", '[tool.poetry]\nname = "fi-instrumentation-otel"\nversion = "1.1.0"\npackages = [\n { include = "fi_instrumentation" },\n]\n') + write(self.root / "python/fi_instrumentation/__init__.py", '__version__ = "1.1.0"\n') + write(self.root / "python/frameworks/openai/pyproject.toml", '[tool.poetry]\nname = "traceAI-openai"\nversion = "0.1.10"\npackages = [{ include = "traceai_openai" }]\n') + write(self.root / "python/frameworks/openai/traceai_openai/version.py", '__version__ = "0.1.10"\n') + write(self.root / "python/frameworks/openai/CHANGELOG.md", "# Changelog\n\n## [0.1.10] - 2026-03-10\n### Fixed\n- Something.\n\n## [0.1.9] - 2026-01-01\n- Older.\n") + write(self.root / "python/frameworks/agno/pyproject.toml", '[project]\nname = "traceai-agno"\nversion = "0.1.0"\n\n[tool.hatch.build.targets.wheel]\npackages = ["traceai_agno"]\n') + write(self.root / "python/frameworks/agno/traceai_agno/__init__.py", "x = 1\n") + write(self.root / "python/frameworks/tests_e2e/README.md", "not a package\n") + write(self.root / "python/traceai/pyproject.toml", '[tool.poetry]\nname = "traceai"\nversion = "0.1.0"\n') + write(self.root / "typescript/packages/fi-core/package.json", json.dumps({"name": "@traceai/fi-core", "version": "1.0.0"})) + write(self.root / "typescript/packages/traceai_openai/package.json", json.dumps({"name": "@traceai/openai", "version": "0.1.13"})) + write(self.root / "typescript/packages/e2e/package.json", json.dumps({"name": "traceai-e2e-tests", "version": "0.0.0", "private": True})) + + +class PlanTests(unittest.TestCase): + def setUp(self): + self.repo = FakeRepo() + self.packages = release_plan.python_packages(self.repo.root) + release_plan.typescript_packages(self.repo.root) + + def tearDown(self): + self.repo.tmp.cleanup() + + def test_discovery_names_versions_and_tags(self): + by = {p["name"]: p for p in self.packages} + self.assertEqual(sorted(by), ["@traceai/fi-core", "@traceai/openai", "fi-instrumentation-otel", "traceAI-openai", "traceai", "traceai-agno"]) + self.assertEqual(by["traceAI-openai"]["tag"], "traceai-openai-v0.1.10") + self.assertEqual(by["@traceai/openai"]["tag"], "npm-traceai-openai-v0.1.13") + self.assertEqual(by["fi-instrumentation-otel"]["import_name"], "fi_instrumentation") + self.assertEqual(by["traceai-agno"]["import_name"], "traceai_agno") + self.assertTrue(by["fi-instrumentation-otel"]["core"] and by["@traceai/fi-core"]["core"]) + self.assertFalse(by["traceAI-openai"]["core"]) + self.assertEqual(by["traceAI-openai"]["changelog"], "python/frameworks/openai/CHANGELOG.md") + self.assertEqual(by["traceAI-openai"]["declared"], {"traceai_openai/version.py": "0.1.10"}) + + def test_consistency_catches_version_drift(self): + self.assertEqual(release_plan.consistency_problems(self.packages), []) + write(self.repo.root / "python/frameworks/openai/traceai_openai/version.py", '__version__ = "0.1.0"\n') + packages = release_plan.python_packages(self.repo.root) + self.assertEqual(release_plan.consistency_problems(packages), ["python/frameworks/openai/traceai_openai/version.py: __version__ is 0.1.0 but pyproject.toml says 0.1.10"]) + + def test_offline_plan_lists_everything_core_first_and_honours_skips(self): + cfg = {"skip": {"traceai": "the PyPI name belongs to another publisher"}} + p = release_plan.plan(self.packages, cfg, offline=True) + self.assertEqual([e["name"] for e in p["python"]], ["fi-instrumentation-otel", "traceai-agno", "traceAI-openai"]) + self.assertEqual([e["name"] for e in p["typescript"]], ["@traceai/fi-core", "@traceai/openai"]) + self.assertEqual(p["skipped"], [{"name": "traceai", "reason": "the PyPI name belongs to another publisher"}]) + self.assertNotIn("declared", p["python"][0]) + + def test_plan_skips_published_versions(self): + have = {"traceAI-openai": {"0.1.9", "0.1.10"}, "fi-instrumentation-otel": {"1.0.0"}, "@traceai/openai": None} + release_plan.published_versions = lambda p: have.get(p["name"], set()) + p = release_plan.plan(self.packages, {"skip": {}}, only={"traceAI-openai", "fi-instrumentation-otel", "@traceai/openai"}) + self.assertEqual([e["name"] for e in p["python"]], ["fi-instrumentation-otel"]) + self.assertEqual([(e["name"], e["first_release"]) for e in p["typescript"]], [("@traceai/openai", True)]) + self.assertEqual(p["skipped"], [{"name": "traceAI-openai", "reason": "0.1.10 is already published"}]) + + def test_check_mode_exit_codes(self): + self.assertEqual(release_plan.main(["--check", "--root", str(self.repo.root)]), 0) + write(self.repo.root / "python/fi_instrumentation/__init__.py", '__version__ = "0.9"\n') + self.assertEqual(release_plan.main(["--check", "--root", str(self.repo.root)]), 1) + + +class NotesTests(unittest.TestCase): + def test_changelog_section_is_extracted(self): + text = "# Changelog\n\n## [Unreleased]\n- wip\n\n## [0.1.10] - 2026-03-10\n### Fixed\n- Something.\n\n## [0.1.9]\n- Older.\n" + self.assertEqual(release_notes.section(text, "0.1.10"), "### Fixed\n- Something.") + self.assertIsNone(release_notes.section(text, "0.2.0")) + self.assertEqual(release_notes.section("## 0.1.9 (2026-01-01)\n- Older.\n", "0.1.9"), "- Older.") + + def test_notes_fall_back_when_there_is_no_section(self): + n = release_notes.notes("traceAI-openai", "0.2.0", changelog_text=None, install="pip install traceAI-openai==0.2.0") + self.assertIn("pip install traceAI-openai==0.2.0", n) + self.assertIn("no CHANGELOG entry", n) + + +if __name__ == "__main__": + unittest.main() diff --git a/.github/workflows/release-python.yml b/.github/workflows/release-python.yml new file mode 100644 index 000000000..fff572f5f --- /dev/null +++ b/.github/workflows/release-python.yml @@ -0,0 +1,132 @@ +# Called by release.yml for a set of Python packages (one job per package). Builds the sdist and +# wheel, checks them, installs the wheel in a clean environment and imports it, then (when +# `publish` is true) uploads to PyPI, waits for the version to be served, tags the commit and +# creates the GitHub release from the package's CHANGELOG. See release.yml for the whole picture. +name: Release (Python packages) + +on: + workflow_call: + inputs: + packages: + description: JSON array of planner entries ({name, version, dir, import_name, tag, changelog, ...}) + type: string + required: true + publish: + description: Upload to PyPI, tag and create the GitHub release (false = build and check only) + type: boolean + required: true + +defaults: + run: + shell: bash + +jobs: + package: + name: ${{ matrix.name }} ${{ matrix.version }} + runs-on: ubuntu-latest + timeout-minutes: 40 + permissions: + contents: write # the tag and the GitHub release + id-token: write # PyPI trusted publishing + strategy: + fail-fast: false + matrix: + include: ${{ fromJson(inputs.packages) }} + env: + NAME: ${{ matrix.name }} + VERSION: ${{ matrix.version }} + DIR: ${{ matrix.dir }} + IMPORT_NAME: ${{ matrix.import_name }} + TAG: ${{ matrix.tag }} + CHANGELOG: ${{ matrix.changelog }} + PUBLISH: ${{ inputs.publish }} + steps: + - uses: actions/checkout@v4 + with: + persist-credentials: false + - name: Where the distributions go + run: echo "DIST=$RUNNER_TEMP/dist" >> "$GITHUB_ENV" + - uses: actions/setup-python@v5 + with: + python-version: '3.11' + + - name: Install the build tools + run: python -m pip install --quiet build==1.2.2 twine==6.1.0 + + - name: Build the sdist and the wheel + run: python -m build --outdir "$DIST" "$DIR" + + - name: Check the distributions + run: | + ls -l "$DIST" + python -m twine check --strict "$DIST"/* + + - name: Install the wheel in a clean environment and import it + run: | + python -m venv "$RUNNER_TEMP/smoke" + "$RUNNER_TEMP/smoke/bin/pip" install --quiet "$DIST"/*.whl + cd "$RUNNER_TEMP" + "$RUNNER_TEMP/smoke/bin/python" - <<'PY' + import importlib, os + from importlib.metadata import version + name, want, module = os.environ["NAME"], os.environ["VERSION"], os.environ.get("IMPORT_NAME") + got = version(name) + assert got == want, f"installed {name} is {got}, the repository says {want}" + if module: + m = importlib.import_module(module) + declared = getattr(m, "__version__", None) + assert declared in (None, want), f"{module}.__version__ is {declared}, the package is {want}" + print(f"import {module}: ok" + (f", __version__ = {declared}" if declared else "")) + print(f"{name} {got}: installed and importable") + PY + "$RUNNER_TEMP/smoke/bin/pip" check + + - name: Keep the distributions + uses: actions/upload-artifact@v4 + with: + name: ${{ matrix.tag }} + path: ${{ runner.temp }}/dist/* + if-no-files-found: error + + - name: Not publishing + if: inputs.publish != true + run: echo "::notice title=${{ matrix.name }} ${{ matrix.version }} not published::built and checked only (publishing is off or this is a dry run)" + + - name: Publish to PyPI + if: inputs.publish + uses: pypa/gh-action-pypi-publish@release/v1 + with: + packages-dir: ${{ runner.temp }}/dist + # Empty when the secret is not set: the action then uses trusted publishing (OIDC). + password: ${{ secrets.PYPI_API_TOKEN }} + print-hash: true + + - name: Wait until PyPI serves the version + if: inputs.publish + run: | + python -m venv "$RUNNER_TEMP/verify" + for attempt in $(seq 1 20); do + if "$RUNNER_TEMP/verify/bin/pip" install --quiet --no-deps --no-cache-dir "$NAME==$VERSION" 2>/dev/null; then + echo "$NAME==$VERSION installs from PyPI" + exit 0 + fi + echo "attempt $attempt: not served yet" + sleep 30 + done + echo "::error title=$NAME $VERSION not on PyPI::published, but pip could not install it after 10 minutes" + exit 1 + + - name: Tag and create the GitHub release + if: inputs.publish + env: + GH_TOKEN: ${{ github.token }} + run: | + if gh release view "$TAG" > /dev/null 2>&1; then + echo "release $TAG already exists" + exit 0 + fi + python3 .github/release/release_notes.py "$NAME" "$VERSION" ${CHANGELOG:+--changelog "$CHANGELOG"} \ + --install "pip install \"$NAME==$VERSION\"" > "$RUNNER_TEMP/notes.md" + cat "$RUNNER_TEMP/notes.md" + gh release create "$TAG" --target "$GITHUB_SHA" --title "$NAME $VERSION" --notes-file "$RUNNER_TEMP/notes.md" "$DIST"/* + echo "- [$NAME $VERSION](${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/releases/tag/$TAG) published to PyPI" >> "$GITHUB_STEP_SUMMARY" diff --git a/.github/workflows/release-typescript.yml b/.github/workflows/release-typescript.yml new file mode 100644 index 000000000..a72bb6a3a --- /dev/null +++ b/.github/workflows/release-typescript.yml @@ -0,0 +1,133 @@ +# Called by release.yml for a set of TypeScript packages (one job per package). Installs the +# workspace, builds the package with its workspace dependencies, packs it, installs the tarball +# in a clean project and loads it (CommonJS and ESM), then (when `publish` is true) publishes to +# npm with provenance, waits for the version to be served, tags the commit and creates the GitHub +# release from the package's CHANGELOG. See release.yml for the whole picture. +name: Release (TypeScript packages) + +on: + workflow_call: + inputs: + packages: + description: JSON array of planner entries ({name, version, dir, tag, changelog, ...}) + type: string + required: true + publish: + description: Publish to npm, tag and create the GitHub release (false = build and check only) + type: boolean + required: true + +defaults: + run: + shell: bash + +jobs: + package: + name: ${{ matrix.name }} ${{ matrix.version }} + runs-on: ubuntu-latest + timeout-minutes: 40 + permissions: + contents: write # the tag and the GitHub release + id-token: write # npm provenance + strategy: + fail-fast: false + matrix: + include: ${{ fromJson(inputs.packages) }} + env: + NAME: ${{ matrix.name }} + VERSION: ${{ matrix.version }} + DIR: ${{ matrix.dir }} + TAG: ${{ matrix.tag }} + CHANGELOG: ${{ matrix.changelog }} + steps: + - uses: actions/checkout@v4 + with: + persist-credentials: false + - name: Where the distributions go + run: echo "DIST=$RUNNER_TEMP/dist" >> "$GITHUB_ENV" + - uses: pnpm/action-setup@v4 + with: + package_json_file: typescript/package.json + - uses: actions/setup-node@v4 + with: + node-version: '22' + registry-url: https://registry.npmjs.org + cache: pnpm + cache-dependency-path: typescript/pnpm-lock.yaml + + - name: Install the workspace + working-directory: typescript + run: pnpm install --frozen-lockfile --ignore-scripts + + - name: The version in package.json is the planned one + run: | + got=$(node -p "require('./$DIR/package.json').version") + [ "$got" = "$VERSION" ] || { echo "::error::$DIR/package.json says $got, the plan says $VERSION"; exit 1; } + + - name: Build the package and the workspace packages it depends on + working-directory: typescript + run: pnpm --filter "${NAME}..." run build + + - name: Pack + working-directory: typescript + run: | + mkdir -p "$DIST" + pnpm --filter "$NAME" pack --pack-destination "$DIST" + ls -l "$DIST" + + - name: Install the tarball in a clean project and load it + working-directory: ${{ runner.temp }} + run: | + mkdir smoke && cd smoke && npm init -y > /dev/null + npm install --no-audit --no-fund "$DIST"/*.tgz + node -e "const m = require(process.env.NAME); console.log('require ok:', Object.keys(m).length, 'exports')" + node --input-type=module -e "import(process.env.NAME).then((m) => console.log('import ok:', Object.keys(m).length, 'exports'))" + got=$(node -p "require('./node_modules/$NAME/package.json').version") + [ "$got" = "$VERSION" ] || { echo "::error::installed $NAME is $got, expected $VERSION"; exit 1; } + + - name: Keep the tarball + uses: actions/upload-artifact@v4 + with: + name: ${{ matrix.tag }} + path: ${{ runner.temp }}/dist/* + if-no-files-found: error + + - name: Not publishing + if: inputs.publish != true + run: echo "::notice title=${{ matrix.name }} ${{ matrix.version }} not published::built and checked only (publishing is off or this is a dry run)" + + - name: Publish to npm + if: inputs.publish + working-directory: typescript + env: + NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} + run: pnpm --filter "$NAME" publish --no-git-checks --access public --provenance + + - name: Wait until npm serves the version + if: inputs.publish + run: | + for attempt in $(seq 1 20); do + if [ "$(npm view "$NAME@$VERSION" version 2>/dev/null)" = "$VERSION" ]; then + echo "$NAME@$VERSION is on npm" + exit 0 + fi + echo "attempt $attempt: not served yet" + sleep 30 + done + echo "::error title=$NAME $VERSION not on npm::published, but the registry did not serve it after 10 minutes" + exit 1 + + - name: Tag and create the GitHub release + if: inputs.publish + env: + GH_TOKEN: ${{ github.token }} + run: | + if gh release view "$TAG" > /dev/null 2>&1; then + echo "release $TAG already exists" + exit 0 + fi + python3 .github/release/release_notes.py "$NAME" "$VERSION" ${CHANGELOG:+--changelog "$CHANGELOG"} \ + --install "npm install $NAME@$VERSION" > "$RUNNER_TEMP/notes.md" + cat "$RUNNER_TEMP/notes.md" + gh release create "$TAG" --target "$GITHUB_SHA" --title "$NAME $VERSION" --notes-file "$RUNNER_TEMP/notes.md" "$DIST"/* + echo "- [$NAME $VERSION](${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/releases/tag/$TAG) published to npm" >> "$GITHUB_STEP_SUMMARY" diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml new file mode 100644 index 000000000..9edb9e464 --- /dev/null +++ b/.github/workflows/release.yml @@ -0,0 +1,209 @@ +# Release: publish every package whose version is not on its registry yet. +# +# Releasing stays a normal pull request: bump `version` in the package's pyproject.toml or +# package.json and add the CHANGELOG entry. Once that reaches main, this workflow (per package, +# in parallel, the two cores first): +# 1. builds the package and checks the distribution (twine check / pnpm pack); +# 2. installs the built artifact in a clean environment and imports it, and checks that the +# installed version equals the one in the repository; +# 3. publishes it to PyPI (trusted publishing, or PYPI_API_TOKEN) or npm (NPM_TOKEN, with provenance); +# 4. waits until the registry serves that version; +# 5. tags the commit (`-v`, e.g. traceai-livekit-v0.1.2, or +# `npm--v`) and creates the GitHub release from the package's CHANGELOG section. +# +# Until the registry credentials are set up, every run does steps 1 and 2 and uploads the +# artifacts, then stops with a warning: nothing is published and nothing is tagged. Publishing +# turns on per ecosystem: +# PyPI the repository variable PYPI_TRUSTED_PUBLISHING=true (a trusted publisher on each PyPI +# project pointing at this repository and release-python.yml), or the secret PYPI_API_TOKEN; +# npm the secret NPM_TOKEN (publish rights on the @traceai scope). +# The pull_request trigger only checks: that every package's __version__ agrees with its +# pyproject.toml, and what the push to main would publish (shown in the run summary). +# Java (JitPack builds from tags) and C# are not covered. The planner is .github/release/release_plan.py. +name: Release + +on: + push: + branches: [main] + pull_request: + branches: [main, dev] + paths: + - python/pyproject.toml + - python/traceai/pyproject.toml + - python/frameworks/*/pyproject.toml + - python/**/version.py + - python/**/__init__.py + - typescript/packages/*/package.json + - .github/release/** + - .github/workflows/release.yml + - .github/workflows/release-python.yml + - .github/workflows/release-typescript.yml + workflow_dispatch: + inputs: + packages: + description: Package names to release, space-separated (empty = every package whose version is not published) + type: string + default: '' + dry_run: + description: Build and check only; publish nothing, tag nothing + type: boolean + default: false + +permissions: + contents: read + +concurrency: + group: release-${{ github.ref }} + cancel-in-progress: false + +defaults: + run: + shell: bash + +jobs: + plan: + name: Plan + runs-on: ubuntu-latest + timeout-minutes: 10 + outputs: + python_core: ${{ steps.plan.outputs.python_core }} + python: ${{ steps.plan.outputs.python }} + typescript_core: ${{ steps.plan.outputs.typescript_core }} + typescript: ${{ steps.plan.outputs.typescript }} + publish_python: ${{ steps.gates.outputs.publish_python }} + publish_typescript: ${{ steps.gates.outputs.publish_typescript }} + steps: + - uses: actions/checkout@v4 + with: + persist-credentials: false + - uses: actions/setup-python@v5 + with: + python-version: '3.11' + + - name: Test the planner + run: python3 -m unittest discover -s .github/release -p 'test_*.py' + + - name: Every __version__ agrees with its pyproject.toml + run: python3 .github/release/release_plan.py --check + + - name: Work out what is not published yet + id: plan + env: + ONLY: ${{ inputs.packages }} + run: | + # shellcheck disable=SC2086 + python3 .github/release/release_plan.py ${ONLY:+--only $ONLY} > "$RUNNER_TEMP/plan.json" + jq . "$RUNNER_TEMP/plan.json" + { + echo "python_core=$(jq -c '[.python[] | select(.core)]' "$RUNNER_TEMP/plan.json")" + echo "python=$(jq -c '[.python[] | select(.core | not)]' "$RUNNER_TEMP/plan.json")" + echo "typescript_core=$(jq -c '[.typescript[] | select(.core)]' "$RUNNER_TEMP/plan.json")" + echo "typescript=$(jq -c '[.typescript[] | select(.core | not)]' "$RUNNER_TEMP/plan.json")" + } >> "$GITHUB_OUTPUT" + { + echo "### Release plan" + echo + if [ "$(jq '(.python | length) + (.typescript | length)' "$RUNNER_TEMP/plan.json")" = 0 ]; then + echo "Every package version is already published. Nothing to do." + else + echo "| Package | Version | First release? |" + echo "|---|---|---|" + jq -r '(.python + .typescript)[] | "| \(.name) | \(.version) | \(if .first_release then "yes" else "no" end) |"' "$RUNNER_TEMP/plan.json" + fi + echo + echo "
Skipped" + echo + jq -r '.skipped[] | "- \(.name): \(.reason)"' "$RUNNER_TEMP/plan.json" + echo + echo "
" + } >> "$GITHUB_STEP_SUMMARY" + + - name: Decide whether publishing is on + id: gates + env: + # Secrets cannot be read in a job-level `if`; an empty value means "not set". + HAS_PYPI_TOKEN: ${{ secrets.PYPI_API_TOKEN != '' }} + PYPI_TRUSTED: ${{ vars.PYPI_TRUSTED_PUBLISHING == 'true' }} + HAS_NPM_TOKEN: ${{ secrets.NPM_TOKEN != '' }} + IS_RELEASE_EVENT: ${{ github.event_name != 'pull_request' && inputs.dry_run != true }} + run: | + py=false; ts=false + if [ "$IS_RELEASE_EVENT" = true ]; then + if [ "$HAS_PYPI_TOKEN" = true ] || [ "$PYPI_TRUSTED" = true ]; then py=true; fi + if [ "$HAS_NPM_TOKEN" = true ]; then ts=true; fi + fi + echo "publish_python=$py" >> "$GITHUB_OUTPUT" + echo "publish_typescript=$ts" >> "$GITHUB_OUTPUT" + if [ "$IS_RELEASE_EVENT" = true ]; then + [ "$py" = true ] || echo "::warning title=PyPI publishing is off::set the repository variable PYPI_TRUSTED_PUBLISHING=true (after adding a trusted publisher on each PyPI project for release-python.yml) or the secret PYPI_API_TOKEN. Python packages are built and checked only." + [ "$ts" = true ] || echo "::warning title=npm publishing is off::set the secret NPM_TOKEN (publish rights on @traceai). TypeScript packages are built and checked only." + else + echo "Check only (${{ github.event_name }}${{ inputs.dry_run == true && ', dry run' || '' }}): nothing is published." + fi + echo "Publish: python=$py typescript=$ts" >> "$GITHUB_STEP_SUMMARY" + + python-core: + name: Python core + needs: plan + if: needs.plan.outputs.python_core != '[]' + uses: ./.github/workflows/release-python.yml + with: + packages: ${{ needs.plan.outputs.python_core }} + publish: ${{ needs.plan.outputs.publish_python == 'true' }} + secrets: inherit + + python: + name: Python + needs: [plan, python-core] + # The core (fi-instrumentation-otel) must be on PyPI before a package that needs its new version. + if: >- + !cancelled() && needs.plan.result == 'success' + && (needs.python-core.result == 'success' || needs.python-core.result == 'skipped') + && needs.plan.outputs.python != '[]' + uses: ./.github/workflows/release-python.yml + with: + packages: ${{ needs.plan.outputs.python }} + publish: ${{ needs.plan.outputs.publish_python == 'true' }} + secrets: inherit + + typescript-core: + name: TypeScript core + needs: plan + if: needs.plan.outputs.typescript_core != '[]' + uses: ./.github/workflows/release-typescript.yml + with: + packages: ${{ needs.plan.outputs.typescript_core }} + publish: ${{ needs.plan.outputs.publish_typescript == 'true' }} + secrets: inherit + + typescript: + name: TypeScript + needs: [plan, typescript-core] + if: >- + !cancelled() && needs.plan.result == 'success' + && (needs.typescript-core.result == 'success' || needs.typescript-core.result == 'skipped') + && needs.plan.outputs.typescript != '[]' + uses: ./.github/workflows/release-typescript.yml + with: + packages: ${{ needs.plan.outputs.typescript }} + publish: ${{ needs.plan.outputs.publish_typescript == 'true' }} + secrets: inherit + + release: + # The one check to require: red when any package failed, green when every planned package + # went through (a package set that was empty counts as green). + name: Release + needs: [plan, python-core, python, typescript-core, typescript] + if: always() + runs-on: ubuntu-latest + timeout-minutes: 5 + steps: + - name: Verdict + env: + RESULTS: ${{ toJson(needs) }} + run: | + echo "$RESULTS" | jq -r 'to_entries[] | "\(.key): \(.value.result)"' + if echo "$RESULTS" | jq -e '[.[] | .result] | any(. == "failure" or . == "cancelled")' > /dev/null; then + echo "::error title=Release failed::see the failed package jobs above" + exit 1 + fi diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 12a19cef1..127dc0dbf 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -88,6 +88,32 @@ Create structure similar to existing packages, then update `pnpm-workspace.yaml` --- +## Releasing + +A release is a pull request, like any other change. For the package you are releasing: + +1. Bump `version` in its `pyproject.toml` (Python) or `package.json` (TypeScript). If the package + carries a `__version__` (in `version.py` or `__init__.py`), set it to the same value: CI fails + when the two disagree (`python3 .github/release/release_plan.py --check`). +2. Add the version's section to the package's `CHANGELOG.md` (`## [x.y.z] - YYYY-MM-DD`); it + becomes the text of the GitHub release. +3. Merge to `dev`, and `dev` to `main` as usual. + +When `main` changes, the [Release](.github/workflows/release.yml) workflow publishes every package +whose version is not on PyPI or npm yet: it builds the package, checks the distribution, installs it +in a clean environment and imports it, publishes it (the two core packages first), waits until the +registry serves the version, tags the commit (`traceai-livekit-v0.1.2`, `npm-traceai-openai-v0.1.13`) +and creates the GitHub release. A pull request that touches a version only shows what would be +published, in the run summary. `Actions > Release > Run workflow` releases by hand (optionally a +few named packages, or as a dry run). + +Publishing needs credentials that an owner sets once: a PyPI trusted publisher on each project +(workflow `release-python.yml` of this repository) plus the repository variable +`PYPI_TRUSTED_PUBLISHING=true`, or the secret `PYPI_API_TOKEN`; and the secret `NPM_TOKEN` with +publish rights on `@traceai`. Until then the workflow builds, checks and keeps the artifacts, and +warns that nothing was published. Packages that must never be published are listed, with the +reason, in `.github/release/config.json`. Java (JitPack from git tags) and C# are released by hand. + ## Guidelines - ✅ Write tests for all changes diff --git a/python/frameworks/anthropic/traceai_anthropic/version.py b/python/frameworks/anthropic/traceai_anthropic/version.py index 3dc1f76bc..569b1212f 100644 --- a/python/frameworks/anthropic/traceai_anthropic/version.py +++ b/python/frameworks/anthropic/traceai_anthropic/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.10" diff --git a/python/frameworks/bedrock/traceai_bedrock/version.py b/python/frameworks/bedrock/traceai_bedrock/version.py index 9cb17e797..569b1212f 100644 --- a/python/frameworks/bedrock/traceai_bedrock/version.py +++ b/python/frameworks/bedrock/traceai_bedrock/version.py @@ -1 +1 @@ -__version__ = "0.1.8" +__version__ = "0.1.10" diff --git a/python/frameworks/dspy/traceai_dspy/version.py b/python/frameworks/dspy/traceai_dspy/version.py index 3dc1f76bc..9cb17e797 100644 --- a/python/frameworks/dspy/traceai_dspy/version.py +++ b/python/frameworks/dspy/traceai_dspy/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.8" diff --git a/python/frameworks/google-genai/traceai_google_genai/version.py b/python/frameworks/google-genai/traceai_google_genai/version.py index 3dc1f76bc..b3f475621 100644 --- a/python/frameworks/google-genai/traceai_google_genai/version.py +++ b/python/frameworks/google-genai/traceai_google_genai/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.2" diff --git a/python/frameworks/groq/traceai_groq/version.py b/python/frameworks/groq/traceai_groq/version.py index 3dc1f76bc..c11f861af 100644 --- a/python/frameworks/groq/traceai_groq/version.py +++ b/python/frameworks/groq/traceai_groq/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.9" diff --git a/python/frameworks/haystack/traceai_haystack/version.py b/python/frameworks/haystack/traceai_haystack/version.py index 3dc1f76bc..c11f861af 100644 --- a/python/frameworks/haystack/traceai_haystack/version.py +++ b/python/frameworks/haystack/traceai_haystack/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.9" diff --git a/python/frameworks/litellm/traceai_litellm/version.py b/python/frameworks/litellm/traceai_litellm/version.py index 3dc1f76bc..569b1212f 100644 --- a/python/frameworks/litellm/traceai_litellm/version.py +++ b/python/frameworks/litellm/traceai_litellm/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.10" diff --git a/python/frameworks/llama_index/traceai_llamaindex/version.py b/python/frameworks/llama_index/traceai_llamaindex/version.py index 3dc1f76bc..c11f861af 100644 --- a/python/frameworks/llama_index/traceai_llamaindex/version.py +++ b/python/frameworks/llama_index/traceai_llamaindex/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.9" diff --git a/python/frameworks/mcp/traceai_mcp/version.py b/python/frameworks/mcp/traceai_mcp/version.py index 3dc1f76bc..b3f475621 100644 --- a/python/frameworks/mcp/traceai_mcp/version.py +++ b/python/frameworks/mcp/traceai_mcp/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.2" diff --git a/python/frameworks/mistralai/traceai_mistralai/version.py b/python/frameworks/mistralai/traceai_mistralai/version.py index 3dc1f76bc..9cb17e797 100644 --- a/python/frameworks/mistralai/traceai_mistralai/version.py +++ b/python/frameworks/mistralai/traceai_mistralai/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.8" diff --git a/python/frameworks/openai-agents/traceai_openai_agents/version.py b/python/frameworks/openai-agents/traceai_openai_agents/version.py index 3dc1f76bc..0a8da8825 100644 --- a/python/frameworks/openai-agents/traceai_openai_agents/version.py +++ b/python/frameworks/openai-agents/traceai_openai_agents/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.6" diff --git a/python/frameworks/openai/traceai_openai/version.py b/python/frameworks/openai/traceai_openai/version.py index 3dc1f76bc..569b1212f 100644 --- a/python/frameworks/openai/traceai_openai/version.py +++ b/python/frameworks/openai/traceai_openai/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.10" diff --git a/python/frameworks/pipecat/traceai_pipecat/__init__.py b/python/frameworks/pipecat/traceai_pipecat/__init__.py index 048e63db7..3b9da9f8b 100644 --- a/python/frameworks/pipecat/traceai_pipecat/__init__.py +++ b/python/frameworks/pipecat/traceai_pipecat/__init__.py @@ -18,7 +18,7 @@ enable_http_attribute_mapping, ) -__version__ = "0.1.0" +__version__ = "0.1.1" __all__ = [ "enable_fi_attribute_mapping", diff --git a/python/frameworks/pipecat/traceai_pipecat/version.py b/python/frameworks/pipecat/traceai_pipecat/version.py index 3dc1f76bc..485f44ac2 100644 --- a/python/frameworks/pipecat/traceai_pipecat/version.py +++ b/python/frameworks/pipecat/traceai_pipecat/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.1" diff --git a/python/frameworks/portkey/traceai_portkey/version.py b/python/frameworks/portkey/traceai_portkey/version.py index a68927d6c..48fef3235 100644 --- a/python/frameworks/portkey/traceai_portkey/version.py +++ b/python/frameworks/portkey/traceai_portkey/version.py @@ -1 +1 @@ -__version__ = "0.1.0" \ No newline at end of file +__version__ = "0.1.2" \ No newline at end of file diff --git a/python/frameworks/smolagents/traceai_smolagents/version.py b/python/frameworks/smolagents/traceai_smolagents/version.py index 3dc1f76bc..1276d0254 100644 --- a/python/frameworks/smolagents/traceai_smolagents/version.py +++ b/python/frameworks/smolagents/traceai_smolagents/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.5" diff --git a/python/frameworks/vertexai/traceai_vertexai/version.py b/python/frameworks/vertexai/traceai_vertexai/version.py index 3dc1f76bc..569b1212f 100644 --- a/python/frameworks/vertexai/traceai_vertexai/version.py +++ b/python/frameworks/vertexai/traceai_vertexai/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.10" From b33c164543e9b6565c2b78456d25912abf1139e4 Mon Sep 17 00:00:00 2001 From: tanmaycode1 Date: Thu, 29 Oct 2026 02:48:21 +0530 Subject: [PATCH 02/11] ci(release): grant the called workflows contents and id-token from the caller jobs A caller job must grant what a reusable workflow's jobs request, or the run fails at startup: contents: write for the tag and the GitHub release, id-token: write for PyPI trusted publishing and npm provenance. --- .github/workflows/release.yml | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 9edb9e464..7fac7f784 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -146,6 +146,9 @@ jobs: name: Python core needs: plan if: needs.plan.outputs.python_core != '[]' + permissions: + contents: write + id-token: write uses: ./.github/workflows/release-python.yml with: packages: ${{ needs.plan.outputs.python_core }} @@ -160,6 +163,9 @@ jobs: !cancelled() && needs.plan.result == 'success' && (needs.python-core.result == 'success' || needs.python-core.result == 'skipped') && needs.plan.outputs.python != '[]' + permissions: + contents: write + id-token: write uses: ./.github/workflows/release-python.yml with: packages: ${{ needs.plan.outputs.python }} @@ -170,6 +176,9 @@ jobs: name: TypeScript core needs: plan if: needs.plan.outputs.typescript_core != '[]' + permissions: + contents: write + id-token: write uses: ./.github/workflows/release-typescript.yml with: packages: ${{ needs.plan.outputs.typescript_core }} @@ -183,6 +192,9 @@ jobs: !cancelled() && needs.plan.result == 'success' && (needs.typescript-core.result == 'success' || needs.typescript-core.result == 'skipped') && needs.plan.outputs.typescript != '[]' + permissions: + contents: write + id-token: write uses: ./.github/workflows/release-typescript.yml with: packages: ${{ needs.plan.outputs.typescript }} From 0f1d36209a8a12bcb37337c3622ee2a713972712 Mon Sep 17 00:00:00 2001 From: Nikhil Pareek <8347993+nik13@users.noreply.github.com> Date: Thu, 29 Oct 2026 06:47:55 -0700 Subject: [PATCH 03/11] ci: automate SDK release PRs across five languages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Build on Tanmay’s #300 publisher with one release-please PR, publisher-owned tags, secure top-level PyPI OIDC, Maven Central, Go and NuGet. Cover every manifest and test root-core version isolation and cross-language updates. Co-Authored-By: Claude Code --- .github/release/complete_release.py | 47 + .github/release/config.json | 3 +- .github/release/github_release.py | 35 + .github/release/release_plan.py | 247 +++-- .github/release/test_release_extensions.py | 151 +++ .github/release/test_release_plan.py | 5 +- .github/release/test_release_strategies.cjs | 73 ++ .github/release/workflow_plan.py | 47 + .github/workflows/release-go.yml | 72 ++ .github/workflows/release-java.yml | 76 ++ .github/workflows/release-nuget.yml | 79 ++ .github/workflows/release-pr-title.yml | 24 + .github/workflows/release-python.yml | 65 +- .github/workflows/release-typescript.yml | 30 +- .github/workflows/release.yml | 378 +++++--- .release-please-manifest.json | 124 +++ CONTRIBUTING.md | 46 +- RELEASING.md | 128 +++ .../instrumentation/version.py | 2 +- python/frameworks/a2a/traceai_a2a/version.py | 2 +- .../traceai_ag2_classic/version.py | 2 +- python/frameworks/ag2/traceai_ag2/version.py | 2 +- .../traceai_agent_framework/version.py | 2 +- .../frameworks/agno/traceai_agno/__init__.py | 2 +- .../anthropic/traceai_anthropic/version.py | 2 +- .../autogen/traceai_autogen/__init__.py | 2 +- .../autogen/traceai_autogen/version.py | 2 +- .../bedrock/traceai_bedrock/version.py | 2 +- .../beeai/traceai_beeai/__init__.py | 2 +- .../cerebras/traceai_cerebras/version.py | 2 +- .../chromadb/traceai_chromadb/version.py | 2 +- .../traceai_claude_agent_sdk/__init__.py | 2 +- .../cohere/traceai_cohere/version.py | 2 +- .../crewai/traceai_crewai/version.py | 2 +- .../deepseek/traceai_deepseek/version.py | 2 +- .../traceai_discoveryengine/version.py | 2 +- .../frameworks/dspy/traceai_dspy/version.py | 2 +- .../traceai_elevenlabs_agents/version.py | 2 +- python/frameworks/exa/traceai_exa/version.py | 2 +- .../firecrawl/traceai_firecrawl/version.py | 2 +- .../fireworks/traceai_fireworks/version.py | 2 +- .../google-adk/traceai_google_adk/version.py | 2 +- .../traceai_google_genai_live/version.py | 2 +- .../traceai_google_genai/version.py | 2 +- .../frameworks/groq/traceai_groq/version.py | 2 +- .../guardrails/traceai_guardrails/version.py | 2 +- .../haystack/traceai_haystack/version.py | 2 +- .../traceai_hermes_agent/version.py | 2 +- .../traceai_huggingface/version.py | 2 +- .../instructor/traceai_instructor/version.py | 2 +- .../lancedb/traceai_lancedb/version.py | 2 +- .../langchain/traceai_langchain/version.py | 2 +- .../litellm/traceai_litellm/version.py | 2 +- .../livekit/traceai_livekit/__init__.py | 2 +- .../llama_index/traceai_llamaindex/version.py | 2 +- .../mcp-use/traceai_mcp_use/version.py | 2 +- python/frameworks/mcp/traceai_mcp/version.py | 2 +- .../milvus/traceai_milvus/version.py | 2 +- .../minimax/traceai_minimax/version.py | 2 +- .../mistralai/traceai_mistralai/version.py | 2 +- .../mongodb-vector/traceai_mongodb/version.py | 2 +- .../ollama/traceai_ollama/version.py | 2 +- .../traceai_openai_agents/version.py | 2 +- .../traceai_openai_realtime/version.py | 2 +- .../openai/traceai_openai/version.py | 2 +- .../parallel/traceai_parallel/version.py | 2 +- .../pgvector/traceai_pgvector/version.py | 2 +- .../pinecone/traceai_pinecone/version.py | 2 +- .../pipecat/traceai_pipecat/__init__.py | 2 +- .../pipecat/traceai_pipecat/version.py | 2 +- .../portkey/traceai_portkey/version.py | 2 +- .../traceai_pydantic_ai/__init__.py | 2 +- .../qdrant/traceai_qdrant/version.py | 2 +- .../redis-vector/traceai_redis/version.py | 2 +- .../replicate/traceai_replicate/version.py | 2 +- .../traceai_semantic_kernel/version.py | 2 +- .../smolagents/traceai_smolagents/version.py | 2 +- .../strands/traceai_strands/__init__.py | 2 +- .../tavily/traceai_tavily/version.py | 2 +- .../together/traceai_together/version.py | 2 +- .../typesafe/traceai_typesafe/version.py | 2 +- .../vertexai/traceai_vertexai/version.py | 2 +- .../frameworks/vllm/traceai_vllm/version.py | 2 +- .../voyage/traceai_voyage/version.py | 2 +- .../weaviate/traceai_weaviate/version.py | 2 +- python/frameworks/xai/traceai_xai/version.py | 2 +- release-please-config.json | 857 ++++++++++++++++++ 87 files changed, 2229 insertions(+), 394 deletions(-) create mode 100644 .github/release/complete_release.py create mode 100644 .github/release/github_release.py create mode 100644 .github/release/test_release_extensions.py create mode 100644 .github/release/test_release_strategies.cjs create mode 100644 .github/release/workflow_plan.py create mode 100644 .github/workflows/release-go.yml create mode 100644 .github/workflows/release-java.yml create mode 100644 .github/workflows/release-nuget.yml create mode 100644 .github/workflows/release-pr-title.yml create mode 100644 .release-please-manifest.json create mode 100644 RELEASING.md create mode 100644 release-please-config.json diff --git a/.github/release/complete_release.py b/.github/release/complete_release.py new file mode 100644 index 000000000..306d64963 --- /dev/null +++ b/.github/release/complete_release.py @@ -0,0 +1,47 @@ +#!/usr/bin/env python3 +"""Clear release-please's pending label only after all release tags exist. + +release-please release-pr refuses new PRs while a merged release PR is pending. +Publishers own the tags, so they must also acknowledge completed release PRs. +""" +import json +import os +import subprocess +from pathlib import Path + +from release_plan import REPO_ROOT, load_config, other_packages, python_packages, typescript_packages, published_versions + + +def gh_json(*args): + return json.loads(subprocess.check_output(["gh", *args], text=True)) + + +def main(): + repo = os.environ["GITHUB_REPOSITORY"] + pending = gh_json("pr", "list", "--repo", repo, "--base", "main", "--state", "merged", "--label", "autorelease: pending", + "--limit", "100", "--json", "number,headRefName") + pending = [p for p in pending if p["headRefName"].startswith("release-please--branches--main")] + if not pending: + return + releases = gh_json("api", "--paginate", "--slurp", f"repos/{repo}/releases?per_page=100") + tags = {r["tag_name"] for page in releases for r in page} + skip = load_config().get("skip", {}) + packages = python_packages(REPO_ROOT) + typescript_packages(REPO_ROOT) + other_packages(REPO_ROOT) + missing = [p["tag"] for p in packages if p["name"] not in skip and p["tag"] not in tags] + if missing: + print(f"Still pending: {len(missing)} package releases; finish credentials/publishing and rerun Release.") + return + for package in packages: + if package["name"] in skip: + continue + versions = published_versions(package) + if versions is None or package["version"] not in versions: + print(f"Still pending: {package['name']} {package['version']} is not served by its registry") + return + for pr in pending: + subprocess.run(["gh", "pr", "edit", str(pr["number"]), "--repo", repo, + "--remove-label", "autorelease: pending", "--add-label", "autorelease: tagged"], check=True) + + +if __name__ == "__main__": + main() diff --git a/.github/release/config.json b/.github/release/config.json index c90cb2838..69b533e84 100644 --- a/.github/release/config.json +++ b/.github/release/config.json @@ -1,6 +1,7 @@ { "_comment": "Packages release.yml never publishes, with the reason. Everything else under python/, python/frameworks/ and typescript/packages/ is published when its version is not on its registry.", "skip": { - "traceai": "the PyPI name traceai belongs to another publisher; the package has no registry name yet" + "traceai": "the PyPI name traceai belongs to another publisher; the package has no registry name yet", + "futureagi-hermes-plugin": "Hermes plugin dependency manifest, explicitly not a buildable distribution" } } diff --git a/.github/release/github_release.py b/.github/release/github_release.py new file mode 100644 index 000000000..23a95806d --- /dev/null +++ b/.github/release/github_release.py @@ -0,0 +1,35 @@ +#!/usr/bin/env python3 +"""Publisher-owned, idempotent tags/releases. Called only after registry verification.""" +import argparse +import os +import subprocess +from pathlib import Path + +import release_notes + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--install", required=True) + parser.add_argument("--dist") + args = parser.parse_args() + tag, name, version = (os.environ[k] for k in ("TAG", "NAME", "VERSION")) + if subprocess.run(["gh", "release", "view", tag], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL).returncode == 0: + print(f"Release {tag} already exists") + return + changelog = Path(os.environ.get("CHANGELOG") or "__no_changelog__") + notes = release_notes.notes(name, version, changelog_text=changelog.read_text() if changelog.is_file() else None, + install=args.install, changelog_path=str(changelog) if changelog.is_file() else None) + path = Path(os.environ["RUNNER_TEMP"]) / "release-notes.md" + path.write_text(notes) + command = ["gh", "release", "create", tag, "--target", os.environ["GITHUB_SHA"], + "--title", f"{name} {version}", "--notes-file", str(path), "--latest=false"] + # An existing registry version need not match this checkout byte-for-byte. Never attach + # newly built artifacts to its historical release; only new uploads get asset attachments. + if args.dist and os.environ.get("REGISTRY_PUBLISHED") != "true": + command += [str(p) for p in sorted(Path(args.dist).glob("*")) if p.is_file()] + subprocess.run(command, check=True) + + +if __name__ == "__main__": + main() diff --git a/.github/release/release_plan.py b/.github/release/release_plan.py index d4c230593..2f6e54d1d 100644 --- a/.github/release/release_plan.py +++ b/.github/release/release_plan.py @@ -1,105 +1,78 @@ #!/usr/bin/env python3 -"""Which packages of this repository are ready to publish. +"""Read-only release inventory and registry plan for all five SDK ecosystems. -A package is "ready" when the version in its ``pyproject.toml`` / ``package.json`` is not on -its registry yet (PyPI or npm). Releasing is therefore still a version bump plus a changelog -entry in a normal pull request; the workflow in ``.github/workflows/release.yml`` does the -building, checking, publishing, tagging and the GitHub release. - - python3 .github/release/release_plan.py plan JSON on stdout (asks PyPI and npm) - python3 .github/release/release_plan.py --offline every package, no registry calls (dry runs, tests) - python3 .github/release/release_plan.py --check exit 1 when a package's __version__ disagrees - with its pyproject.toml, or a name is duplicated - python3 .github/release/release_plan.py --only NAME.. limit the plan to these package names - -Packages: ``python/pyproject.toml`` (the core, fi-instrumentation-otel), ``python/traceai/``, -every ``python/frameworks//pyproject.toml``, and every non-private -``typescript/packages//package.json``. ``config.json`` next to this file lists packages -that are never published, with the reason. Java (JitPack from tags) and C# are not covered. - -Plan shape:: - - {"python": [{"name", "version", "dir", "import_name", "tag", "core", "changelog"}, ...], - "typescript": [{"name", "version", "dir", "tag", "core", "changelog"}, ...]} - -``core`` marks the packages the others depend on (fi-instrumentation-otel, @traceai/fi-core, -@traceai/fi-semantic-conventions); the workflow publishes those first. +--check validates Python runtime versions and release-please coverage without network. +--offline inventories publishable packages without registry calls. --only NAME ... +limits the plan. --root allows a separate source tree. No command publishes anything. +The release publisher, not release-please, owns tags and GitHub releases. """ from __future__ import annotations import argparse import json -import os import re import sys +import tomllib import urllib.error +import urllib.parse import urllib.request +import xml.etree.ElementTree as ET from pathlib import Path REPO_ROOT = Path(__file__).resolve().parents[2] CONFIG = Path(__file__).resolve().parent / "config.json" PYTHON_CORE = {"fi-instrumentation-otel"} TS_CORE = {"@traceai/fi-core", "@traceai/fi-semantic-conventions"} +ECOSYSTEMS = ("python", "typescript", "java", "go", "nuget") VERSION_RE = re.compile(r'^__version__\s*=\s*["\']([^"\']+)["\']', re.M) - - -def _toml_str(text: str, key: str) -> str | None: - m = re.search(rf'^{key}\s*=\s*"([^"]*)"', text, re.M) - return m.group(1) if m else None +MAVEN_NS = {"m": "http://maven.apache.org/POM/4.0.0"} def pypi_normalize(name: str) -> str: - """PEP 503 name normalisation: traceAI-DSPy -> traceai-dspy.""" return re.sub(r"[-_.]+", "-", name).lower() def import_name(pyproject_text: str, pkg_dir: Path) -> str | None: - """The top-level module a wheel installs, from the poetry or hatch package list.""" - m = re.search(r'include\s*=\s*"([^"/]+)"', pyproject_text) # poetry: packages = [{ include = "x" }] - candidates = [m.group(1)] if m else [] - m = re.search(r"^packages\s*=\s*\[([^\]]*)\]", pyproject_text, re.M) # hatch: packages = ["src/x"] - if m: - candidates += [p.strip().strip('"\'').split("/")[-1] for p in m.group(1).split(",") if p.strip()] - for c in candidates: - if (pkg_dir / c).is_dir() or (pkg_dir / "src" / c).is_dir(): - return c + """Find a module without executing package code.""" + data = tomllib.loads(pyproject_text) + poetry = data.get("tool", {}).get("poetry", {}) + candidates = [p["include"] for p in poetry.get("packages", []) if "include" in p] + hatch = data.get("tool", {}).get("hatch", {}).get("build", {}).get("targets", {}).get("wheel", {}) + candidates += [p.split("/")[-1] for p in hatch.get("packages", [])] + for candidate in candidates: + if (pkg_dir / candidate).is_dir() or (pkg_dir / "src" / candidate).is_dir(): + return candidate return None def declared_versions(pkg_dir: Path, module: str | None) -> dict[str, str]: - """``__version__`` strings the package itself carries: {relative file: version}.""" - out: dict[str, str] = {} - if not module: - return out - for base in (pkg_dir / module, pkg_dir / "src" / module): - for f in (base / "version.py", base / "__init__.py"): - if f.is_file(): - m = VERSION_RE.search(f.read_text()) - if m: - out[str(f.relative_to(pkg_dir))] = m.group(1) + out = {} + if module: + for base in (pkg_dir / module, pkg_dir / "src" / module): + for f in sorted(set(base.rglob("version.py")) | set(base.rglob("__init__.py"))): + if f.is_file() and (match := VERSION_RE.search(f.read_text())): + out[str(f.relative_to(pkg_dir))] = match.group(1) return out def python_packages(root: Path = REPO_ROOT) -> list[dict]: - dirs = [root / "python", root / "python" / "traceai"] + sorted(p for p in (root / "python" / "frameworks").iterdir() if p.is_dir()) out = [] - for d in dirs: - f = d / "pyproject.toml" - if not f.is_file(): - continue + for f in sorted((root / "python").rglob("pyproject.toml")): + d = f.parent text = f.read_text() - name, version = _toml_str(text, "name"), _toml_str(text, "version") + data = tomllib.loads(text) + pkg = data.get("project", data.get("tool", {}).get("poetry", {})) + name, version = pkg.get("name"), pkg.get("version") if not name or not version: continue module = import_name(text, d) out.append({ - "ecosystem": "python", - "name": name, - "version": version, - "dir": str(d.relative_to(root)), - "import_name": module, - "tag": f"{pypi_normalize(name)}-v{version}", - "core": name in PYTHON_CORE, + "ecosystem": "python", "name": name, "version": version, + "dir": str(d.relative_to(root)), "import_name": module, + # Python strategy recursively discovers version.py; scope the root core to + # its code so it cannot overwrite every sibling SDK's runtime version. + "release_path": "python/fi_instrumentation" if d == root / "python" else str(d.relative_to(root)), + "tag": f"{pypi_normalize(name)}-v{version}", "core": name in PYTHON_CORE, "changelog": str((d / "CHANGELOG.md").relative_to(root)) if (d / "CHANGELOG.md").is_file() else None, "declared": declared_versions(d, module), }) @@ -108,18 +81,13 @@ def python_packages(root: Path = REPO_ROOT) -> list[dict]: def typescript_packages(root: Path = REPO_ROOT) -> list[dict]: out = [] - for d in sorted(p for p in (root / "typescript" / "packages").iterdir() if p.is_dir()): - f = d / "package.json" - if not f.is_file(): - continue + for f in sorted((root / "typescript" / "packages").glob("*/package.json")): pkg = json.loads(f.read_text()) if pkg.get("private") or not pkg.get("name") or not pkg.get("version"): continue - name = pkg["name"] + name, d = pkg["name"], f.parent out.append({ - "ecosystem": "typescript", - "name": name, - "version": pkg["version"], + "ecosystem": "typescript", "name": name, "version": pkg["version"], "dir": str(d.relative_to(root)), "tag": f"npm-{name.lstrip('@').replace('/', '-')}-v{pkg['version']}", "core": name in TS_CORE, @@ -128,14 +96,46 @@ def typescript_packages(root: Path = REPO_ROOT) -> list[dict]: return out +def other_packages(root: Path = REPO_ROOT) -> list[dict]: + out = [] + pom = root / "java/pom.xml" + if pom.is_file(): + p = ET.fromstring(pom.read_text()) + version = p.findtext("m:version", namespaces=MAVEN_NS) + group = p.findtext("m:groupId", namespaces=MAVEN_NS) + artifact = p.findtext("m:artifactId", namespaces=MAVEN_NS) + artifacts = [artifact] + for module in p.findall("m:modules/m:module", MAVEN_NS): + child = ET.parse(root / "java" / module.text / "pom.xml").getroot() + artifacts.append(child.findtext("m:artifactId", namespaces=MAVEN_NS)) + out.append({"ecosystem": "java", "name": f"{group}:{artifact}", "version": version, + "dir": "java", "tag": f"java-v{version}", "core": False, + "group": group, "artifacts": artifacts, "changelog": "java/CHANGELOG.md"}) + manifest_path = root / ".release-please-manifest.json" + manifest = json.loads(manifest_path.read_text()) if manifest_path.is_file() else {} + for f in sorted((root / "go").glob("*/go.mod")): + module = re.search(r"^module\s+(\S+)", f.read_text(), re.M).group(1) + path = str(f.parent.relative_to(root)) + version = manifest.get(path, "0.1.0") + out.append({"ecosystem": "go", "name": module, "version": version, + "dir": path, "tag": f"{path}/v{version}", "core": False, + "changelog": f"{path}/CHANGELOG.md"}) + for f in sorted((root / "csharp/src/FIInstrumentation").glob("*.csproj")): + p = ET.fromstring(f.read_text()) + name, version = p.findtext(".//PackageId"), p.findtext(".//Version") + out.append({"ecosystem": "nuget", "name": name, "version": version, + "dir": str(f.parent.relative_to(root)), "project": str(f.relative_to(root)), + "tag": f"nuget-{name}-v{version}", "core": False, + "changelog": str(f.parent.relative_to(root)) + "/CHANGELOG.md"}) + return out + + def load_config(path: Path = CONFIG) -> dict: return json.loads(path.read_text()) if path.is_file() else {"skip": {}} def consistency_problems(packages: list[dict]) -> list[str]: - """A __version__ that disagrees with the package version, or two packages with one name.""" - problems = [] - seen: dict[str, str] = {} + problems, seen = [], {} for p in packages: key = f"{p['ecosystem']}:{pypi_normalize(p['name']) if p['ecosystem'] == 'python' else p['name']}" if key in seen: @@ -147,6 +147,27 @@ def consistency_problems(packages: list[dict]) -> list[str]: return problems +def coverage_problems(root: Path, packages: list[dict]) -> list[str]: + config_file = root / "release-please-config.json" + if not config_file.is_file(): + return [] # Small unit-test fixtures and dev trees before bootstrap. + cfg = json.loads(config_file.read_text())["packages"] + versions = json.loads((root / ".release-please-manifest.json").read_text()) + problems = [] + for p in packages: + path = p.get("release_path", p["dir"]) + if path not in cfg or path not in versions: + problems.append(f"{path}: missing release-please config or manifest entry") + for rel in p.get("declared", {}): + f = root / p["dir"] / rel + scoped_rel = str(f.relative_to(root / path)) + if "x-release-please-version" not in f.read_text(): + problems.append(f"{f.relative_to(root)}: missing release-please version marker") + if scoped_rel not in cfg.get(path, {}).get("extra-files", []): + problems.append(f"{p['dir']}/{rel}: missing release-please extra-file") + return problems + + def _get_json(url: str) -> dict | None: req = urllib.request.Request(url, headers={"Accept": "application/json", "User-Agent": "traceAI-release-plan"}) try: @@ -155,20 +176,44 @@ def _get_json(url: str) -> dict | None: except urllib.error.HTTPError as e: if e.code == 404: return None - raise + raise # Authentication failures, rate limits and server errors must never mean 'not published'. def published_versions(p: dict) -> set[str] | None: - """Versions the registry has for this package; None when the name does not exist there.""" - if p["ecosystem"] == "python": + eco = p["ecosystem"] + if eco == "python": d = _get_json(f"https://pypi.org/pypi/{p['name']}/json") return set(d["releases"]) if d else None - d = _get_json("https://registry.npmjs.org/" + p["name"].replace("/", "%2F")) - return set(d.get("versions", {})) if d else None - - -def plan(packages: list[dict], config: dict, *, offline: bool = False, only: set[str] | None = None) -> dict: - out: dict = {"python": [], "typescript": [], "skipped": []} + if eco == "typescript": + d = _get_json("https://registry.npmjs.org/" + p["name"].replace("/", "%2F")) + return set(d.get("versions", {})) if d else None + if eco == "nuget": + d = _get_json(f"https://api.nuget.org/v3-flatcontainer/{p['name'].lower()}/index.json") + return set(d["versions"]) if d else None + if eco == "go": + # Go proxy escaping: every uppercase letter becomes ! plus lowercase. + module = re.sub(r"[A-Z]", lambda m: "!" + m.group().lower(), p["name"]) + d = _get_json(f"https://proxy.golang.org/{module}/@v/v{p['version']}.info") + return {p["version"]} if d else None + if eco == "java": + # Query canonical repository files rather than the eventually consistent search index. + # One reactor publishes together; do not skip if any module is missing. + for artifact in p["artifacts"]: + url = f"https://repo.maven.apache.org/maven2/{p['group'].replace('.', '/')}/{artifact}/{p['version']}/{artifact}-{p['version']}.pom" + try: + with urllib.request.urlopen(url, timeout=30): + pass + except urllib.error.HTTPError as e: + if e.code == 404: + return None + raise + return {p["version"]} + raise ValueError(f"Unknown ecosystem: {eco}") + + +def plan(packages: list[dict], config: dict, *, offline: bool = False, only: set[str] | None = None, include_published: bool = False) -> dict: + out = {eco: [] for eco in ECOSYSTEMS} + out["skipped"] = [] skip = config.get("skip", {}) for p in packages: if only and p["name"] not in only: @@ -176,37 +221,41 @@ def plan(packages: list[dict], config: dict, *, offline: bool = False, only: set if p["name"] in skip: out["skipped"].append({"name": p["name"], "reason": skip[p["name"]]}) continue + if p["ecosystem"] == "java" and (p["group"] != "com.futureagi" or "SNAPSHOT" in p["version"]): + out["skipped"].append({"name": p["name"], "reason": "Central requires com.futureagi release coordinates; merge the Java release-profile PR first"}) + continue if not offline: have = published_versions(p) - if have is not None and p["version"] in have: + published = have is not None and p["version"] in have + if published and not include_published: out["skipped"].append({"name": p["name"], "reason": f"{p['version']} is already published"}) continue - p = {**p, "first_release": have is None} - entry = {k: v for k, v in p.items() if k not in ("declared", "ecosystem")} - out[p["ecosystem"]].append(entry) - for eco in ("python", "typescript"): + p = {**p, "first_release": have is None, "registry_published": published} + out[p["ecosystem"]].append({k: v for k, v in p.items() if k not in ("declared", "ecosystem")}) + for eco in ECOSYSTEMS: out[eco].sort(key=lambda e: (not e["core"], e["name"].lower())) return out def main(argv: list[str] | None = None) -> int: - ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) - ap.add_argument("--offline", action="store_true", help="list every package without asking the registries") - ap.add_argument("--check", action="store_true", help="only check version consistency; exit 1 on a problem") - ap.add_argument("--only", nargs="*", metavar="NAME", help="limit the plan to these package names") - ap.add_argument("--root", default=str(REPO_ROOT), help=argparse.SUPPRESS) + ap = argparse.ArgumentParser(description=__doc__) + ap.add_argument("--offline", action="store_true") + ap.add_argument("--check", action="store_true") + ap.add_argument("--include-published", action="store_true", help="include existing registry versions for tag/release reconciliation") + ap.add_argument("--only", nargs="*", metavar="NAME") + ap.add_argument("--root", default=str(REPO_ROOT)) args = ap.parse_args(argv) root = Path(args.root) - packages = python_packages(root) + typescript_packages(root) - problems = consistency_problems(packages) + packages = python_packages(root) + typescript_packages(root) + other_packages(root) + problems = consistency_problems(packages) + coverage_problems(root, packages) if problems: - for pr in problems: - print(f"release: {pr}", file=sys.stderr) + for problem in problems: + print(f"release: {problem}", file=sys.stderr) return 1 if args.check: - print(f"release: {len(packages)} packages, versions consistent", file=sys.stderr) + print(f"release: {len(packages)} packages, versions and coverage consistent", file=sys.stderr) return 0 - result = plan(packages, load_config(), offline=args.offline, only=set(args.only or []) or None) + result = plan(packages, load_config(), offline=args.offline, only=set(args.only or []) or None, include_published=args.include_published) json.dump(result, sys.stdout, indent=2) print() return 0 diff --git a/.github/release/test_release_extensions.py b/.github/release/test_release_extensions.py new file mode 100644 index 000000000..c6b16aad3 --- /dev/null +++ b/.github/release/test_release_extensions.py @@ -0,0 +1,151 @@ +"""All tests are offline: fixtures, fake HTTP, fake gh. No publishing credentials.""" +import importlib +import json +import os +import sys +import tempfile +import unittest +import urllib.error +from pathlib import Path +from unittest.mock import patch, Mock + +sys.path.insert(0, str(Path(__file__).parent)) +import release_plan +import workflow_plan +import github_release +import complete_release + + +class ExtensionTests(unittest.TestCase): + def test_python_discovery_includes_nested_plugin_manifest(self): + with tempfile.TemporaryDirectory() as d: + root = Path(d) + p = root / 'python/frameworks/hermes/plugin/futureagi/pyproject.toml' + p.parent.mkdir(parents=True) + p.write_text('[project]\nname="futureagi-hermes-plugin"\nversion="0.1.0"\n') + packages = release_plan.python_packages(root) + self.assertEqual(len(packages), 1) + self.assertEqual(packages[0]['dir'], 'python/frameworks/hermes/plugin/futureagi') + + def test_nested_runtime_version_is_checked(self): + with tempfile.TemporaryDirectory() as d: + p = Path(d) / 'fi_instrumentation/instrumentation/version.py' + p.parent.mkdir(parents=True) + p.write_text('__version__ = "1.2.1"\n') + self.assertEqual(release_plan.declared_versions(Path(d), 'fi_instrumentation'), + {'fi_instrumentation/instrumentation/version.py': '1.2.1'}) + + def test_go_discovery_uses_manifest_not_hardcoded_initial_after_first_release(self): + with tempfile.TemporaryDirectory() as d: + root = Path(d) + (root / 'go/openai').mkdir(parents=True) + (root / 'go/openai/go.mod').write_text('module github.com/future-agi/traceAI/go/openai\n\ngo 1.26.0\n') + (root / '.release-please-manifest.json').write_text('{"go/openai":"0.1.7"}') + p = release_plan.other_packages(root)[0] + self.assertEqual((p['version'], p['tag']), ('0.1.7', 'go/openai/v0.1.7')) + + def test_go_proxy_case_escaping(self): + with patch.object(release_plan, '_get_json', return_value={'Version': 'v0.1.0'}) as get: + p = {'ecosystem': 'go', 'name': 'github.com/future-agi/traceAI/go/openai', 'version': '0.1.0'} + self.assertEqual(release_plan.published_versions(p), {'0.1.0'}) + self.assertEqual(get.call_args.args[0], 'https://proxy.golang.org/github.com/future-agi/trace!a!i/go/openai/@v/v0.1.0.info') + + def test_registry_error_is_not_treated_as_unpublished(self): + for status in (401, 403, 429, 503): + error = urllib.error.HTTPError('https://example.com', status, 'failed', {}, None) + with patch('urllib.request.urlopen', side_effect=error): + with self.assertRaises(urllib.error.HTTPError): + release_plan._get_json('https://example.com') + + def test_registry_404_means_missing(self): + with patch('urllib.request.urlopen', side_effect=urllib.error.HTTPError('https://example.com', 404, 'missing', {}, None)): + self.assertIsNone(release_plan._get_json('https://example.com')) + + def test_java_cannot_publish_legacy_or_snapshot_coordinates(self): + p = {'ecosystem': 'java', 'name': 'ai.traceai:parent', 'group': 'ai.traceai', 'version': '1.0.0', 'core': False} + self.assertEqual(release_plan.plan([p], {}, offline=True)['java'], []) + p.update(group='com.futureagi', version='1.1.0-SNAPSHOT') + self.assertEqual(release_plan.plan([p], {}, offline=True)['java'], []) + + def test_java_skip_requires_every_reactor_artifact_on_central(self): + p = {'ecosystem': 'java', 'group': 'com.futureagi', 'version': '1.0.0', 'artifacts': ['parent', 'core']} + context = Mock(); context.__enter__ = Mock(); context.__exit__ = Mock(return_value=False) + with patch('urllib.request.urlopen', side_effect=[context, urllib.error.HTTPError('url', 404, 'missing', {}, None)]): + self.assertIsNone(release_plan.published_versions(p)) + with patch('urllib.request.urlopen', return_value=context) as get: + self.assertEqual(release_plan.published_versions(p), {'1.0.0'}) + self.assertEqual(get.call_count, 2) + + def test_nuget_registry_name_is_lowercase(self): + with patch.object(release_plan, '_get_json', return_value={'versions': ['1.0.0']}) as get: + self.assertEqual(release_plan.published_versions({'ecosystem': 'nuget', 'name': 'FI-Instrumentation-Otel'}), {'1.0.0'}) + self.assertIn('/fi-instrumentation-otel/', get.call_args.args[0]) + + def test_published_version_remains_for_tag_retry_but_will_not_reupload(self): + p = {'ecosystem': 'python', 'name': 'a', 'dir': 'python/a', 'version': '1.0.0', 'core': False, 'tag': 'a-v1.0.0'} + with patch.object(release_plan, 'published_versions', return_value={'1.0.0'}): + result = release_plan.plan([p], {}, include_published=True) + self.assertTrue(result['python'][0]['registry_published']) + self.assertEqual(workflow_plan.unfinished(json.loads(json.dumps(result)), set())['python'], result['python']) + self.assertEqual(workflow_plan.unfinished(result, {'a-v1.0.0'})['python'], []) + + def test_missing_registry_version_never_skipped_because_a_tag_exists(self): + p = {'tag': 'a-v1.0.0', 'registry_published': False} + data = {eco: [] for eco in release_plan.ECOSYSTEMS} + data['python'] = [p] + self.assertEqual(workflow_plan.unfinished(data, {'a-v1.0.0'})['python'], [p]) + + def test_existing_github_release_is_not_recreated(self): + with patch.dict(os.environ, {'TAG': 'tag', 'NAME': 'a', 'VERSION': '1.0.0'}), patch.object(sys, 'argv', ['script', '--install', 'pip install a']), patch('subprocess.run', return_value=Mock(returncode=0)) as run: + github_release.main() + self.assertEqual(run.call_count, 1) + + def test_registry_existing_release_does_not_attach_newly_built_artifacts(self): + with tempfile.TemporaryDirectory() as d: + (Path(d) / 'a.whl').write_text('not the old registry wheel') + env = {'TAG': 'tag', 'NAME': 'a', 'VERSION': '1.0.0', 'RUNNER_TEMP': d, 'GITHUB_SHA': 'a' * 40, 'REGISTRY_PUBLISHED': 'true'} + with patch.dict(os.environ, env), patch.object(sys, 'argv', ['script', '--install', 'pip install a', '--dist', d]), patch('subprocess.run', side_effect=[Mock(returncode=1), Mock(returncode=0)]) as run: + github_release.main() + command = run.call_args.args[0] + self.assertNotIn(str(Path(d) / 'a.whl'), command) + self.assertIn('--latest=false', command) + + def test_completion_only_considers_merged_release_please_branches(self): + with patch.dict(os.environ, {'GITHUB_REPOSITORY': 'owner/repo'}), patch.object(complete_release, 'gh_json', return_value=[{'number': 1, 'headRefName': 'some-feature'}]) as gh: + complete_release.main() + self.assertEqual(gh.call_count, 1) + + def test_completion_does_not_acknowledge_go_tag_until_proxy_serves_version(self): + package = {'ecosystem': 'go', 'name': 'example/module', 'version': '0.1.0', 'tag': 'go/module/v0.1.0'} + pending = [{'number': 1, 'headRefName': 'release-please--branches--main'}] + with patch.dict(os.environ, {'GITHUB_REPOSITORY': 'owner/repo'}), patch.object(complete_release, 'gh_json', side_effect=[pending, [[{'tag_name': package['tag']}]]]), patch.object(complete_release, 'python_packages', return_value=[]), patch.object(complete_release, 'typescript_packages', return_value=[]), patch.object(complete_release, 'other_packages', return_value=[package]), patch.object(complete_release, 'load_config', return_value={'skip': {}}), patch.object(complete_release, 'published_versions', return_value=None), patch('subprocess.run') as run: + complete_release.main() + run.assert_not_called() + + def test_workflow_plan_serializes_npm_semantic_before_core(self): + with tempfile.TemporaryDirectory() as d: + root = Path(d) + data = {eco: [] for eco in release_plan.ECOSYSTEMS} + data.update(skipped=[], typescript=[{'name': '@traceai/fi-core', 'core': True, 'version': '1.0.0', 'tag': 'core'}, {'name': '@traceai/fi-semantic-conventions', 'core': True, 'version': '1.0.0', 'tag': 'semantic'}]) + (root / 'plan.json').write_text(json.dumps(data)); (root / 'tags.txt').write_text('') + with patch.dict(os.environ, {'GITHUB_OUTPUT': str(root / 'output'), 'GITHUB_STEP_SUMMARY': str(root / 'summary')}), patch.object(sys, 'argv', ['script', str(root / 'plan.json'), str(root / 'tags.txt')]): + workflow_plan.main() + outputs = dict(line.split('=', 1) for line in (root / 'output').read_text().splitlines()) + self.assertEqual([p['name'] for p in json.loads(outputs['typescript_semantic'])], ['@traceai/fi-semantic-conventions']) + self.assertEqual([p['name'] for p in json.loads(outputs['typescript_core'])], ['@traceai/fi-core']) + + def test_real_repo_has_complete_manifest_and_runtime_markers(self): + root = release_plan.REPO_ROOT + packages = release_plan.python_packages(root) + release_plan.typescript_packages(root) + release_plan.other_packages(root) + self.assertEqual(release_plan.consistency_problems(packages), []) + self.assertEqual(release_plan.coverage_problems(root, packages), []) + config = json.loads((root / 'release-please-config.json').read_text()) + manifest = json.loads((root / '.release-please-manifest.json').read_text()) + self.assertEqual(set(config['packages']), {p.get('release_path', p['dir']) for p in packages}) + self.assertEqual(set(manifest), set(config['packages'])) + for p in packages: + self.assertEqual(manifest[p.get('release_path', p['dir'])], p['version']) + + +if __name__ == '__main__': + unittest.main() diff --git a/.github/release/test_release_plan.py b/.github/release/test_release_plan.py index 290ae363a..fdef6de4b 100644 --- a/.github/release/test_release_plan.py +++ b/.github/release/test_release_plan.py @@ -4,6 +4,7 @@ import sys import tempfile import unittest +from unittest.mock import patch from pathlib import Path sys.path.insert(0, os.path.dirname(__file__)) @@ -71,8 +72,8 @@ def test_offline_plan_lists_everything_core_first_and_honours_skips(self): def test_plan_skips_published_versions(self): have = {"traceAI-openai": {"0.1.9", "0.1.10"}, "fi-instrumentation-otel": {"1.0.0"}, "@traceai/openai": None} - release_plan.published_versions = lambda p: have.get(p["name"], set()) - p = release_plan.plan(self.packages, {"skip": {}}, only={"traceAI-openai", "fi-instrumentation-otel", "@traceai/openai"}) + with patch.object(release_plan, 'published_versions', side_effect=lambda p: have.get(p["name"], set())): + p = release_plan.plan(self.packages, {"skip": {}}, only={"traceAI-openai", "fi-instrumentation-otel", "@traceai/openai"}) self.assertEqual([e["name"] for e in p["python"]], ["fi-instrumentation-otel"]) self.assertEqual([(e["name"], e["first_release"]) for e in p["typescript"]], [("@traceai/openai", True)]) self.assertEqual(p["skipped"], [{"name": "traceAI-openai", "reason": "0.1.10 is already published"}]) diff --git a/.github/release/test_release_strategies.cjs b/.github/release/test_release_strategies.cjs new file mode 100644 index 000000000..6abeabf9b --- /dev/null +++ b/.github/release/test_release_strategies.cjs @@ -0,0 +1,73 @@ +// Run with NODE_PATH= node this-file.cjs. +// Exercises real release-please strategies against local files with fake history. +// No token, HTTP, git writes or GitHub mutations are possible in this test. +const assert = require('node:assert/strict'); +const fs = require('node:fs'); +const path = require('node:path'); +const {Manifest} = require('release-please/build/src/manifest.js'); +const {FileNotFoundError} = require('release-please/build/src/errors/index.js'); +const root = path.resolve(__dirname, '../..'); +const config = JSON.parse(fs.readFileSync(path.join(root, 'release-please-config.json'))); +const baseline = JSON.parse(fs.readFileSync(path.join(root, '.release-please-manifest.json'))); +const featureVersion = version => { + const [major, minor, patch] = version.split('.').map(Number); + return major === 0 ? `${major}.${minor}.${patch + 1}` : `${major}.${minor + 1}.0`; +}; +const caseExists = file => { + let current = root; + for (const part of file.split('/')) { + if (!fs.existsSync(current) || !fs.readdirSync(current).includes(part)) return false; + current = path.join(current, part); + } + return true; +}; +const changed = ['python/fi_instrumentation/instrumentation/config.py', 'python/frameworks/openai/traceai_openai/instrumentation.py', + 'typescript/packages/traceai_openai/src/index.ts', 'java/traceai-java-core/src/Example.java', + 'go/openai/example.go', 'csharp/src/FIInstrumentation/Example.cs']; +const scm = { + repository: {owner: 'future-agi', repo: 'traceAI', defaultBranch: 'main'}, + async getFileJson(file) { return JSON.parse(fs.readFileSync(path.join(root, file))); }, + async getFileContentsOnBranch(file) { + try { const text = fs.readFileSync(path.join(root, file), 'utf8'); + return {content: Buffer.from(text).toString('base64'), parsedContent: text, sha: 'a'.repeat(40)}; + } catch (err) { if (err.code === 'ENOENT') throw new FileNotFoundError(file); throw err; } + }, + async findFilesByFilenameAndRef(name, ref, prefix = '') { + const base = path.join(root, prefix); + return fs.readdirSync(base, {recursive: true}).filter(f => path.basename(f) === name && fs.statSync(path.join(base, f)).isFile()); + }, + async *releaseIterator() {}, + async *tagIterator() {}, + async *mergeCommitIterator() { + yield {sha: 'f'.repeat(40), message: 'feat: synthetic offline five-language regression', files: changed}; + yield {sha: config['bootstrap-sha'], message: 'chore: baseline', files: []}; + }, +}; +(async () => { + const manifest = await Manifest.fromManifest(scm, 'main'); + const prs = await manifest.buildPullRequests(); + assert.equal(prs.length, 1, 'one combined release PR, not one per language'); + const updates = new Map(); + for (const u of prs[0].updates) { + if (!u.createIfMissing && !caseExists(u.path)) continue; + const original = caseExists(u.path) ? fs.readFileSync(path.join(root, u.path), 'utf8') : ''; + const value = u.updater.updateContent(original); + if (value !== undefined) updates.set(u.path, value); + } + const next = JSON.parse(updates.get('.release-please-manifest.json')); + for (const p of ['python/fi_instrumentation', 'python/frameworks/openai', 'typescript/packages/traceai_openai', 'java', 'go/openai', 'csharp/src/FIInstrumentation']) { + assert.equal(next[p], featureVersion(baseline[p]), `${p}: feature bumps patch before 1.0, minor after 1.0`); + } + assert(updates.get('python/frameworks/openai/traceai_openai/version.py').includes(`__version__ = "${next['python/frameworks/openai']}"`)); + assert(updates.get('python/fi_instrumentation/instrumentation/version.py').includes(`__version__ = "${next['python/fi_instrumentation']}"`)); + assert(updates.get('python/pyproject.toml').includes(`version = "${next['python/fi_instrumentation']}"`)); + assert(!updates.has('python/frameworks/anthropic/traceai_anthropic/version.py'), 'core release must not rewrite untouched sibling SDK runtime versions'); + assert.equal(JSON.parse(updates.get('typescript/packages/traceai_openai/package.json')).version, next['typescript/packages/traceai_openai']); + assert(updates.get('csharp/src/FIInstrumentation/FIInstrumentation.csproj').includes(`${next['csharp/src/FIInstrumentation']}`)); + assert(!next.java.includes('SNAPSHOT'), 'one release PR, no Maven snapshot PR'); + assert.match(updates.get('java/pom.xml'), new RegExp(`${next.java.replaceAll('.', '\\.')}`)); + const {TagName} = require('release-please/build/src/util/tag-name.js'); + const {Version} = require('release-please/build/src/version.js'); + assert.equal(new TagName(Version.parse('0.1.0'), 'go/openai', '/', true).toString(), 'go/openai/v0.1.0'); + console.log(JSON.stringify({result: 'PASS', pullRequests: prs.length, syntheticBumps: Object.fromEntries(Object.keys(next).filter(p => next[p] !== baseline[p]).map(p => [p, {from: baseline[p], to: next[p]}])), updatedFiles: [...updates.keys()]}, null, 2)); +})().catch(err => { console.error(err); process.exitCode = 1; }); diff --git a/.github/release/workflow_plan.py b/.github/release/workflow_plan.py new file mode 100644 index 000000000..ea284b0f1 --- /dev/null +++ b/.github/release/workflow_plan.py @@ -0,0 +1,47 @@ +#!/usr/bin/env python3 +"""Filter registry inventory to unfinished releases and write workflow matrices. + +Keep a package until BOTH its registry version and GitHub release exist. This +allows retrying after a successful upload but failed verification/tagging. +""" +import json +import os +import sys +from pathlib import Path + +from release_plan import ECOSYSTEMS + + +def unfinished(plan, release_tags): + for eco in ECOSYSTEMS: + plan[eco] = [p for p in plan[eco] if not (p.get("registry_published") and p["tag"] in release_tags)] + return plan + + +def main(): + plan = unfinished(json.loads(Path(sys.argv[1]).read_text()), set(Path(sys.argv[2]).read_text().splitlines())) + Path(sys.argv[1]).write_text(json.dumps(plan, indent=2) + "\n") + with open(os.environ["GITHUB_OUTPUT"], "a") as output: + for eco in ECOSYSTEMS: + groups = {eco: plan[eco]} + if eco in ("python", "typescript"): + groups = {eco: [p for p in plan[eco] if not p["core"]], + eco + "_core": [p for p in plan[eco] if p["core"]]} + if eco == "typescript": + semantic = "@traceai/fi-semantic-conventions" + groups["typescript_semantic"] = [p for p in groups["typescript_core"] if p["name"] == semantic] + groups["typescript_core"] = [p for p in groups["typescript_core"] if p["name"] != semantic] + for name, entries in groups.items(): + output.write(f"{name}={json.dumps(entries, separators=(',', ':'))}\n") + with open(os.environ["GITHUB_STEP_SUMMARY"], "a") as summary: + summary.write("### Release plan\n\n| Package | Version | Registry upload needed? |\n|---|---|---|\n") + for eco in ECOSYSTEMS: + for p in plan[eco]: + summary.write(f"| {p['name']} | {p['version']} | {'no (reconcile release)' if p.get('registry_published') else 'yes'} |\n") + summary.write("\nSkipped:\n") + for p in plan["skipped"]: + summary.write(f"- {p['name']}: {p['reason']}\n") + + +if __name__ == "__main__": + main() diff --git a/.github/workflows/release-go.yml b/.github/workflows/release-go.yml new file mode 100644 index 000000000..3d01c59f5 --- /dev/null +++ b/.github/workflows/release-go.yml @@ -0,0 +1,72 @@ +name: Release (Go module tags) +on: + workflow_call: + inputs: + packages: + type: string + required: true + publish: + type: boolean + required: true +permissions: + contents: write +defaults: + run: + shell: bash +jobs: + module: + runs-on: ubuntu-latest + timeout-minutes: 30 + strategy: + fail-fast: false + matrix: + include: ${{ fromJson(inputs.packages) }} + env: + NAME: ${{ matrix.name }} + VERSION: ${{ matrix.version }} + DIR: ${{ matrix.dir }} + TAG: ${{ matrix.tag }} + CHANGELOG: ${{ matrix.changelog }} + steps: + - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4 + with: + persist-credentials: false + - uses: actions/setup-go@40f1582b2485089dde7abd97c1529aa768e1baff # v5 + with: + go-version-file: ${{ matrix.dir }}/go.mod + cache-dependency-path: ${{ matrix.dir }}/go.sum + - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5 + with: + python-version: '3.12' + - name: Verify and test the module + working-directory: ${{ matrix.dir }} + run: | + go mod download + go mod verify + go test ./... + go vet ./... + - name: Tag the module (no binary registry upload) + if: inputs.publish + env: + GH_TOKEN: ${{ github.token }} + run: python3 .github/release/github_release.py --install "go get $NAME@v$VERSION" + - name: Warm and verify the Go proxy index + if: inputs.publish + run: | + # The tag is go//vX.Y.Z; the proxy URL uses just vX.Y.Z. + # traceAI is case-sensitive: Go proxy module paths escape uppercase letters. + python3 - <<'PY' + import json, os, re, time, urllib.error, urllib.request + module = re.sub(r'[A-Z]', lambda m: '!' + m.group().lower(), os.environ['NAME']) + version = 'v' + os.environ['VERSION'] + url = f'https://proxy.golang.org/{module}/@v/{version}.info' + for attempt in range(30): + try: + with urllib.request.urlopen(url, timeout=30) as response: data = json.load(response) + assert data['Version'] == version, data + print(url, data['Version']); break + except urllib.error.HTTPError as e: + if e.code not in (404, 410): raise + time.sleep(20) + else: raise SystemExit('Go proxy has not indexed the new tag; check module visibility and rerun') + PY diff --git a/.github/workflows/release-java.yml b/.github/workflows/release-java.yml new file mode 100644 index 000000000..349172047 --- /dev/null +++ b/.github/workflows/release-java.yml @@ -0,0 +1,76 @@ +name: Release (Java reactor) +on: + workflow_call: + inputs: + packages: + type: string + required: true + publish: + type: boolean + required: true +permissions: + contents: write +defaults: + run: + shell: bash +jobs: + reactor: + runs-on: ubuntu-latest + timeout-minutes: 60 + strategy: + fail-fast: false + matrix: + include: ${{ fromJson(inputs.packages) }} + env: + NAME: ${{ matrix.name }} + VERSION: ${{ matrix.version }} + TAG: ${{ matrix.tag }} + CHANGELOG: ${{ matrix.changelog }} + REGISTRY_PUBLISHED: ${{ matrix.registry_published }} + steps: + - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4 + with: + persist-credentials: false + - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5 + with: + python-version: '3.12' + - uses: actions/setup-java@cf277c60eb25467037889841efdb72551f06f6c3 # v4 + with: + distribution: temurin + java-version: '17' + server-id: central + server-username: MAVEN_CENTRAL_USERNAME + server-password: MAVEN_CENTRAL_PASSWORD + gpg-private-key: ${{ secrets.MAVEN_GPG_PRIVATE_KEY }} + gpg-passphrase: MAVEN_GPG_PASSPHRASE + - name: Build and test all modules + working-directory: java + run: mvn -B -ntp verify + - name: Deploy signed sources, javadocs and binaries to Central + if: inputs.publish && !matrix.registry_published + working-directory: java + env: + MAVEN_CENTRAL_USERNAME: ${{ secrets.MAVEN_CENTRAL_USERNAME }} + MAVEN_CENTRAL_PASSWORD: ${{ secrets.MAVEN_CENTRAL_PASSWORD }} + MAVEN_GPG_PASSPHRASE: ${{ secrets.MAVEN_GPG_PASSPHRASE }} + run: mvn -B -ntp -P release deploy + - name: Verify every reactor artifact on Central + if: inputs.publish + env: + PACKAGE: ${{ toJson(matrix) }} + run: | + python3 - <<'PY' + import importlib.util, json, os, time + spec = importlib.util.spec_from_file_location('plan', '.github/release/release_plan.py') + plan = importlib.util.module_from_spec(spec); spec.loader.exec_module(plan) + p = json.loads(os.environ['PACKAGE']); p['ecosystem'] = 'java' + for attempt in range(60): + if plan.published_versions(p): break + time.sleep(30) + else: raise SystemExit('Central has not served every reactor artifact after 30 minutes; rerun after checking the deployment portal') + PY + - name: Tag and create the reactor release + if: inputs.publish + env: + GH_TOKEN: ${{ github.token }} + run: python3 .github/release/github_release.py --install "Maven com.futureagi:traceai-java-core:$VERSION" diff --git a/.github/workflows/release-nuget.yml b/.github/workflows/release-nuget.yml new file mode 100644 index 000000000..d36ec6897 --- /dev/null +++ b/.github/workflows/release-nuget.yml @@ -0,0 +1,79 @@ +name: Release (NuGet) +on: + workflow_call: + inputs: + packages: + type: string + required: true + publish: + type: boolean + required: true +permissions: + contents: write +defaults: + run: + shell: bash +jobs: + package: + runs-on: ubuntu-latest + timeout-minutes: 30 + strategy: + fail-fast: false + matrix: + include: ${{ fromJson(inputs.packages) }} + env: + NAME: ${{ matrix.name }} + VERSION: ${{ matrix.version }} + PROJECT: ${{ matrix.project }} + TAG: ${{ matrix.tag }} + CHANGELOG: ${{ matrix.changelog }} + REGISTRY_PUBLISHED: ${{ matrix.registry_published }} + steps: + - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4 + with: + persist-credentials: false + - uses: actions/setup-dotnet@67a3573c9a986a3f9c594539f4ab511d57bb3ce9 # v4 + with: + dotnet-version: '10.0.x' + - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5 + with: + python-version: '3.12' + - name: Build and pack + run: dotnet pack "$PROJECT" --configuration Release --output "$RUNNER_TEMP/dist" + - name: Install the exact local nupkg in a clean consumer + working-directory: ${{ runner.temp }} + run: | + dotnet new console --framework net10.0 --output smoke + dotnet add smoke package "$NAME" --version "$VERSION" --source "$RUNNER_TEMP/dist" --no-restore + dotnet restore smoke --source "$RUNNER_TEMP/dist" --source https://api.nuget.org/v3/index.json + dotnet build smoke --no-restore + - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4 + with: + name: ${{ matrix.tag }} + path: ${{ runner.temp }}/dist/* + if-no-files-found: error + - name: Publish to NuGet + if: inputs.publish && !matrix.registry_published + env: + NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }} + run: dotnet nuget push "$RUNNER_TEMP/dist/*.nupkg" --api-key "$NUGET_API_KEY" --source https://api.nuget.org/v3/index.json --skip-duplicate + - name: Verify the public registry version + if: inputs.publish + run: | + python3 - <<'PY' + import json, os, time, urllib.error, urllib.request + url = f"https://api.nuget.org/v3-flatcontainer/{os.environ['NAME'].lower()}/index.json" + for attempt in range(30): + try: + with urllib.request.urlopen(url, timeout=30) as response: versions = json.load(response)['versions'] + if os.environ['VERSION'] in versions: break + except urllib.error.HTTPError as e: + if e.code != 404: raise + time.sleep(20) + else: raise SystemExit('NuGet has not indexed the uploaded version; rerun once visible') + PY + - name: Tag and create the GitHub release + if: inputs.publish + env: + GH_TOKEN: ${{ github.token }} + run: python3 .github/release/github_release.py --install "dotnet add package $NAME --version $VERSION" --dist "$RUNNER_TEMP/dist" diff --git a/.github/workflows/release-pr-title.yml b/.github/workflows/release-pr-title.yml new file mode 100644 index 000000000..3350075d4 --- /dev/null +++ b/.github/workflows/release-pr-title.yml @@ -0,0 +1,24 @@ +# No checkout and no execution of PR code: safe for forks on pull_request_target. +name: Conventional PR title +on: + pull_request_target: + branches: [dev, main] + types: [opened, edited, synchronize, reopened, ready_for_review] +permissions: + contents: read +jobs: + title: + runs-on: ubuntu-latest + timeout-minutes: 5 + steps: + - name: Validate Conventional Commits title + env: + PR_TITLE: ${{ github.event.pull_request.title }} + run: | + node <<'JS' + const title = process.env.PR_TITLE; + if (!/^(feat|fix|perf|refactor|docs|style|test|build|ci|chore|revert|deps)(\([^)\r\n]+\))?!?: \S[^\r\n]*$/.test(title)) { + console.error('Use a Conventional Commit title, for example fix(openai): preserve streaming token counts'); + process.exit(1); + } + JS diff --git a/.github/workflows/release-python.yml b/.github/workflows/release-python.yml index fff572f5f..6f550a908 100644 --- a/.github/workflows/release-python.yml +++ b/.github/workflows/release-python.yml @@ -1,7 +1,4 @@ -# Called by release.yml for a set of Python packages (one job per package). Builds the sdist and -# wheel, checks them, installs the wheel in a clean environment and imports it, then (when -# `publish` is true) uploads to PyPI, waits for the version to be served, tags the commit and -# creates the GitHub release from the package's CHANGELOG. See release.yml for the whole picture. +# Build-only reusable workflow: trusted publishing MUST run in top-level release.yml. name: Release (Python packages) on: @@ -11,10 +8,6 @@ on: description: JSON array of planner entries ({name, version, dir, import_name, tag, changelog, ...}) type: string required: true - publish: - description: Upload to PyPI, tag and create the GitHub release (false = build and check only) - type: boolean - required: true defaults: run: @@ -26,8 +19,7 @@ jobs: runs-on: ubuntu-latest timeout-minutes: 40 permissions: - contents: write # the tag and the GitHub release - id-token: write # PyPI trusted publishing + contents: read strategy: fail-fast: false matrix: @@ -39,16 +31,16 @@ jobs: IMPORT_NAME: ${{ matrix.import_name }} TAG: ${{ matrix.tag }} CHANGELOG: ${{ matrix.changelog }} - PUBLISH: ${{ inputs.publish }} + REGISTRY_PUBLISHED: ${{ matrix.registry_published }} steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4 with: persist-credentials: false - name: Where the distributions go run: echo "DIST=$RUNNER_TEMP/dist" >> "$GITHUB_ENV" - - uses: actions/setup-python@v5 + - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5 with: - python-version: '3.11' + python-version: '3.12' - name: Install the build tools run: python -m pip install --quiet build==1.2.2 twine==6.1.0 @@ -82,51 +74,8 @@ jobs: "$RUNNER_TEMP/smoke/bin/pip" check - name: Keep the distributions - uses: actions/upload-artifact@v4 + uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4 with: name: ${{ matrix.tag }} path: ${{ runner.temp }}/dist/* if-no-files-found: error - - - name: Not publishing - if: inputs.publish != true - run: echo "::notice title=${{ matrix.name }} ${{ matrix.version }} not published::built and checked only (publishing is off or this is a dry run)" - - - name: Publish to PyPI - if: inputs.publish - uses: pypa/gh-action-pypi-publish@release/v1 - with: - packages-dir: ${{ runner.temp }}/dist - # Empty when the secret is not set: the action then uses trusted publishing (OIDC). - password: ${{ secrets.PYPI_API_TOKEN }} - print-hash: true - - - name: Wait until PyPI serves the version - if: inputs.publish - run: | - python -m venv "$RUNNER_TEMP/verify" - for attempt in $(seq 1 20); do - if "$RUNNER_TEMP/verify/bin/pip" install --quiet --no-deps --no-cache-dir "$NAME==$VERSION" 2>/dev/null; then - echo "$NAME==$VERSION installs from PyPI" - exit 0 - fi - echo "attempt $attempt: not served yet" - sleep 30 - done - echo "::error title=$NAME $VERSION not on PyPI::published, but pip could not install it after 10 minutes" - exit 1 - - - name: Tag and create the GitHub release - if: inputs.publish - env: - GH_TOKEN: ${{ github.token }} - run: | - if gh release view "$TAG" > /dev/null 2>&1; then - echo "release $TAG already exists" - exit 0 - fi - python3 .github/release/release_notes.py "$NAME" "$VERSION" ${CHANGELOG:+--changelog "$CHANGELOG"} \ - --install "pip install \"$NAME==$VERSION\"" > "$RUNNER_TEMP/notes.md" - cat "$RUNNER_TEMP/notes.md" - gh release create "$TAG" --target "$GITHUB_SHA" --title "$NAME $VERSION" --notes-file "$RUNNER_TEMP/notes.md" "$DIST"/* - echo "- [$NAME $VERSION](${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/releases/tag/$TAG) published to PyPI" >> "$GITHUB_STEP_SUMMARY" diff --git a/.github/workflows/release-typescript.yml b/.github/workflows/release-typescript.yml index a72bb6a3a..0f83bab57 100644 --- a/.github/workflows/release-typescript.yml +++ b/.github/workflows/release-typescript.yml @@ -39,16 +39,21 @@ jobs: DIR: ${{ matrix.dir }} TAG: ${{ matrix.tag }} CHANGELOG: ${{ matrix.changelog }} + REGISTRY_PUBLISHED: ${{ matrix.registry_published }} steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4 with: persist-credentials: false - name: Where the distributions go run: echo "DIST=$RUNNER_TEMP/dist" >> "$GITHUB_ENV" - - uses: pnpm/action-setup@v4 + - uses: pnpm/action-setup@f40ffcd9367d9f12939873eb1018b921a783ffaa # v4 with: package_json_file: typescript/package.json - - uses: actions/setup-node@v4 + - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5 + with: + python-version: '3.12' + - name: Configure npm registry + uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4 with: node-version: '22' registry-url: https://registry.npmjs.org @@ -86,7 +91,7 @@ jobs: [ "$got" = "$VERSION" ] || { echo "::error::installed $NAME is $got, expected $VERSION"; exit 1; } - name: Keep the tarball - uses: actions/upload-artifact@v4 + uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4 with: name: ${{ matrix.tag }} path: ${{ runner.temp }}/dist/* @@ -97,11 +102,11 @@ jobs: run: echo "::notice title=${{ matrix.name }} ${{ matrix.version }} not published::built and checked only (publishing is off or this is a dry run)" - name: Publish to npm - if: inputs.publish + if: inputs.publish && !matrix.registry_published working-directory: typescript env: NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - run: pnpm --filter "$NAME" publish --no-git-checks --access public --provenance + run: npm publish "$DIST"/*.tgz --access public --provenance - name: Wait until npm serves the version if: inputs.publish @@ -117,17 +122,8 @@ jobs: echo "::error title=$NAME $VERSION not on npm::published, but the registry did not serve it after 10 minutes" exit 1 - - name: Tag and create the GitHub release + - name: Tag and create the GitHub release (publisher is the sole tag owner) if: inputs.publish env: GH_TOKEN: ${{ github.token }} - run: | - if gh release view "$TAG" > /dev/null 2>&1; then - echo "release $TAG already exists" - exit 0 - fi - python3 .github/release/release_notes.py "$NAME" "$VERSION" ${CHANGELOG:+--changelog "$CHANGELOG"} \ - --install "npm install $NAME@$VERSION" > "$RUNNER_TEMP/notes.md" - cat "$RUNNER_TEMP/notes.md" - gh release create "$TAG" --target "$GITHUB_SHA" --title "$NAME $VERSION" --notes-file "$RUNNER_TEMP/notes.md" "$DIST"/* - echo "- [$NAME $VERSION](${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/releases/tag/$TAG) published to npm" >> "$GITHUB_STEP_SUMMARY" + run: python3 .github/release/github_release.py --install "npm install $NAME@$VERSION" --dist "$DIST" diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 7fac7f784..996b469ba 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -1,181 +1,258 @@ -# Release: publish every package whose version is not on its registry yet. -# -# Releasing stays a normal pull request: bump `version` in the package's pyproject.toml or -# package.json and add the CHANGELOG entry. Once that reaches main, this workflow (per package, -# in parallel, the two cores first): -# 1. builds the package and checks the distribution (twine check / pnpm pack); -# 2. installs the built artifact in a clean environment and imports it, and checks that the -# installed version equals the one in the repository; -# 3. publishes it to PyPI (trusted publishing, or PYPI_API_TOKEN) or npm (NPM_TOKEN, with provenance); -# 4. waits until the registry serves that version; -# 5. tags the commit (`-v`, e.g. traceai-livekit-v0.1.2, or -# `npm--v`) and creates the GitHub release from the package's CHANGELOG section. -# -# Until the registry credentials are set up, every run does steps 1 and 2 and uploads the -# artifacts, then stops with a warning: nothing is published and nothing is tagged. Publishing -# turns on per ecosystem: -# PyPI the repository variable PYPI_TRUSTED_PUBLISHING=true (a trusted publisher on each PyPI -# project pointing at this repository and release-python.yml), or the secret PYPI_API_TOKEN; -# npm the secret NPM_TOKEN (publish rights on the @traceai scope). -# The pull_request trigger only checks: that every package's __version__ agrees with its -# pyproject.toml, and what the push to main would publish (shown in the run summary). -# Java (JitPack builds from tags) and C# are not covered. The planner is .github/release/release_plan.py. +# Builds on Tanmay's #300 plan -> verify -> publish -> tag/release pipeline. +# release-please ONLY maintains a release PR. Publishers exclusively own tags/releases. name: Release - on: push: branches: [main] pull_request: branches: [main, dev] paths: - - python/pyproject.toml - - python/traceai/pyproject.toml - - python/frameworks/*/pyproject.toml + - python/**/pyproject.toml - python/**/version.py - python/**/__init__.py - typescript/packages/*/package.json + - java/**/pom.xml + - go/** + - csharp/**/*.csproj - .github/release/** - - .github/workflows/release.yml - - .github/workflows/release-python.yml - - .github/workflows/release-typescript.yml + - .github/workflows/release*.yml + - release-please-config.json + - .release-please-manifest.json workflow_dispatch: inputs: packages: - description: Package names to release, space-separated (empty = every package whose version is not published) + description: Space-separated package names (empty = all unfinished releases) type: string default: '' dry_run: - description: Build and check only; publish nothing, tag nothing + description: Build and verify only; no uploads, tags, releases or PR changes type: boolean - default: false - + default: true permissions: contents: read - concurrency: group: release-${{ github.ref }} cancel-in-progress: false - defaults: run: shell: bash - jobs: plan: name: Plan runs-on: ubuntu-latest - timeout-minutes: 10 + timeout-minutes: 15 outputs: python_core: ${{ steps.plan.outputs.python_core }} python: ${{ steps.plan.outputs.python }} + typescript_semantic: ${{ steps.plan.outputs.typescript_semantic }} typescript_core: ${{ steps.plan.outputs.typescript_core }} typescript: ${{ steps.plan.outputs.typescript }} - publish_python: ${{ steps.gates.outputs.publish_python }} - publish_typescript: ${{ steps.gates.outputs.publish_typescript }} + java: ${{ steps.plan.outputs.java }} + go: ${{ steps.plan.outputs.go }} + nuget: ${{ steps.plan.outputs.nuget }} + publish_python: ${{ steps.gates.outputs.python }} + publish_typescript: ${{ steps.gates.outputs.typescript }} + publish_java: ${{ steps.gates.outputs.java }} + publish_go: ${{ steps.gates.outputs.go }} + publish_nuget: ${{ steps.gates.outputs.nuget }} steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4 with: persist-credentials: false - - uses: actions/setup-python@v5 + - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5 with: - python-version: '3.11' - - - name: Test the planner + python-version: '3.12' + - name: Test all release scripts run: python3 -m unittest discover -s .github/release -p 'test_*.py' - - - name: Every __version__ agrees with its pyproject.toml + - name: Test real release-please strategies offline + run: | + npm install --prefix "$RUNNER_TEMP/release-please-test" --ignore-scripts --no-audit --no-fund release-please@17.11.2 + NODE_PATH="$RUNNER_TEMP/release-please-test/node_modules" node .github/release/test_release_strategies.cjs + - name: Validate runtime versions and release-please coverage run: python3 .github/release/release_plan.py --check - - - name: Work out what is not published yet + - name: Query registries and reconcile incomplete releases id: plan env: ONLY: ${{ inputs.packages }} + GH_TOKEN: ${{ github.token }} run: | - # shellcheck disable=SC2086 - python3 .github/release/release_plan.py ${ONLY:+--only $ONLY} > "$RUNNER_TEMP/plan.json" - jq . "$RUNNER_TEMP/plan.json" - { - echo "python_core=$(jq -c '[.python[] | select(.core)]' "$RUNNER_TEMP/plan.json")" - echo "python=$(jq -c '[.python[] | select(.core | not)]' "$RUNNER_TEMP/plan.json")" - echo "typescript_core=$(jq -c '[.typescript[] | select(.core)]' "$RUNNER_TEMP/plan.json")" - echo "typescript=$(jq -c '[.typescript[] | select(.core | not)]' "$RUNNER_TEMP/plan.json")" - } >> "$GITHUB_OUTPUT" - { - echo "### Release plan" - echo - if [ "$(jq '(.python | length) + (.typescript | length)' "$RUNNER_TEMP/plan.json")" = 0 ]; then - echo "Every package version is already published. Nothing to do." - else - echo "| Package | Version | First release? |" - echo "|---|---|---|" - jq -r '(.python + .typescript)[] | "| \(.name) | \(.version) | \(if .first_release then "yes" else "no" end) |"' "$RUNNER_TEMP/plan.json" - fi - echo - echo "
Skipped" - echo - jq -r '.skipped[] | "- \(.name): \(.reason)"' "$RUNNER_TEMP/plan.json" - echo - echo "
" - } >> "$GITHUB_STEP_SUMMARY" - - - name: Decide whether publishing is on + args=() + if [ -n "$ONLY" ]; then read -ra names <<< "$ONLY"; args=(--only "${names[@]}"); fi + python3 .github/release/release_plan.py --include-published "${args[@]}" > "$RUNNER_TEMP/plan.json" + gh api --paginate "repos/$GITHUB_REPOSITORY/releases?per_page=100" --jq '.[].tag_name' > "$RUNNER_TEMP/releases.txt" + python3 .github/release/workflow_plan.py "$RUNNER_TEMP/plan.json" "$RUNNER_TEMP/releases.txt" + cat "$RUNNER_TEMP/plan.json" + - name: Keep the plan + uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4 + with: + name: release-plan + path: ${{ runner.temp }}/plan.json + - name: Credential and event gates id: gates env: - # Secrets cannot be read in a job-level `if`; an empty value means "not set". - HAS_PYPI_TOKEN: ${{ secrets.PYPI_API_TOKEN != '' }} - PYPI_TRUSTED: ${{ vars.PYPI_TRUSTED_PUBLISHING == 'true' }} - HAS_NPM_TOKEN: ${{ secrets.NPM_TOKEN != '' }} - IS_RELEASE_EVENT: ${{ github.event_name != 'pull_request' && inputs.dry_run != true }} + RELEASE_EVENT: ${{ github.ref == 'refs/heads/main' && github.event_name != 'pull_request' && inputs.dry_run != true }} + PYPI: ${{ secrets.PYPI_API_TOKEN != '' || vars.PYPI_TRUSTED_PUBLISHING == 'true' }} + NPM: ${{ secrets.NPM_TOKEN != '' }} + MAVEN: ${{ secrets.MAVEN_CENTRAL_USERNAME != '' && secrets.MAVEN_CENTRAL_PASSWORD != '' && secrets.MAVEN_GPG_PRIVATE_KEY != '' && secrets.MAVEN_GPG_PASSPHRASE != '' }} + NUGET: ${{ secrets.NUGET_API_KEY != '' }} run: | - py=false; ts=false - if [ "$IS_RELEASE_EVENT" = true ]; then - if [ "$HAS_PYPI_TOKEN" = true ] || [ "$PYPI_TRUSTED" = true ]; then py=true; fi - if [ "$HAS_NPM_TOKEN" = true ]; then ts=true; fi - fi - echo "publish_python=$py" >> "$GITHUB_OUTPUT" - echo "publish_typescript=$ts" >> "$GITHUB_OUTPUT" - if [ "$IS_RELEASE_EVENT" = true ]; then - [ "$py" = true ] || echo "::warning title=PyPI publishing is off::set the repository variable PYPI_TRUSTED_PUBLISHING=true (after adding a trusted publisher on each PyPI project for release-python.yml) or the secret PYPI_API_TOKEN. Python packages are built and checked only." - [ "$ts" = true ] || echo "::warning title=npm publishing is off::set the secret NPM_TOKEN (publish rights on @traceai). TypeScript packages are built and checked only." - else - echo "Check only (${{ github.event_name }}${{ inputs.dry_run == true && ', dry run' || '' }}): nothing is published." - fi - echo "Publish: python=$py typescript=$ts" >> "$GITHUB_STEP_SUMMARY" - - python-core: - name: Python core + for eco in python typescript java go nuget; do + enabled=false + case "$eco" in + python) available=$PYPI;; typescript) available=$NPM;; java) available=$MAVEN;; go) available=true;; nuget) available=$NUGET;; + esac + if [ "$RELEASE_EVENT" = true ] && [ "$available" = true ]; then enabled=true; fi + echo "$eco=$enabled" >> "$GITHUB_OUTPUT" + echo "- $eco publishing: $enabled" >> "$GITHUB_STEP_SUMMARY" + if [ "$RELEASE_EVENT" = true ] && [ "$available" != true ]; then + echo "::warning::$eco publishing disabled: complete the RELEASING.md checklist. Builds still run." + fi + done + python-core-build: + name: Build python-core needs: plan - if: needs.plan.outputs.python_core != '[]' + if: >- + github.event_name != 'pull_request' && needs.plan.outputs.python_core != '[]' permissions: - contents: write - id-token: write + contents: read uses: ./.github/workflows/release-python.yml with: packages: ${{ needs.plan.outputs.python_core }} - publish: ${{ needs.plan.outputs.publish_python == 'true' }} - secrets: inherit - - python: - name: Python - needs: [plan, python-core] - # The core (fi-instrumentation-otel) must be on PyPI before a package that needs its new version. + python-core: + name: Publish python-core + needs: [plan, python-core-build] if: >- - !cancelled() && needs.plan.result == 'success' - && (needs.python-core.result == 'success' || needs.python-core.result == 'skipped') - && needs.plan.outputs.python != '[]' + !cancelled() && needs.python-core-build.result == 'success' + && needs.plan.outputs.publish_python == 'true' + runs-on: ubuntu-latest + timeout-minutes: 20 permissions: contents: write id-token: write + strategy: + fail-fast: false + matrix: + include: ${{ fromJson(needs.plan.outputs.python_core) }} + env: + NAME: ${{ matrix.name }} + VERSION: ${{ matrix.version }} + TAG: ${{ matrix.tag }} + CHANGELOG: ${{ matrix.changelog }} + REGISTRY_PUBLISHED: ${{ matrix.registry_published }} + steps: + - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4 + with: + persist-credentials: false + - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5 + with: + python-version: '3.12' + - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4 + with: + name: ${{ matrix.tag }} + path: ${{ runner.temp }}/dist + - name: Publish the verified distributions (top-level workflow for OIDC) + if: '!matrix.registry_published' + uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # release/v1 + with: + packages-dir: ${{ runner.temp }}/dist + password: ${{ secrets.PYPI_API_TOKEN }} + print-hash: true + - name: Verify public registry availability + run: | + python3 -m venv "$RUNNER_TEMP/verify" + for attempt in $(seq 1 20); do + if "$RUNNER_TEMP/verify/bin/pip" install --quiet --no-deps --no-cache-dir "$NAME==$VERSION" 2>/dev/null; then exit 0; fi + echo "attempt $attempt: $NAME==$VERSION is not served yet" + sleep 30 + done + echo "::error::PyPI has not served $NAME==$VERSION after ten minutes; rerun Release" + exit 1 + - name: Tag and create the GitHub release + env: + GH_TOKEN: ${{ github.token }} + run: python3 .github/release/github_release.py --install "pip install $NAME==$VERSION" --dist "$RUNNER_TEMP/dist" + python-build: + name: Build python + needs: [plan, python-core-build, python-core] + if: >- + !cancelled() && github.event_name != 'pull_request' && needs.plan.result == 'success' && (needs.python-core-build.result == 'success' || needs.python-core-build.result == 'skipped') && (needs.python-core.result == 'success' || needs.python-core.result == 'skipped') && needs.plan.outputs.python != '[]' + permissions: + contents: read uses: ./.github/workflows/release-python.yml with: packages: ${{ needs.plan.outputs.python }} - publish: ${{ needs.plan.outputs.publish_python == 'true' }} + python: + name: Publish python + needs: [plan, python-build] + if: >- + !cancelled() && needs.python-build.result == 'success' + && needs.plan.outputs.publish_python == 'true' + runs-on: ubuntu-latest + timeout-minutes: 20 + permissions: + contents: write + id-token: write + strategy: + fail-fast: false + matrix: + include: ${{ fromJson(needs.plan.outputs.python) }} + env: + NAME: ${{ matrix.name }} + VERSION: ${{ matrix.version }} + TAG: ${{ matrix.tag }} + CHANGELOG: ${{ matrix.changelog }} + REGISTRY_PUBLISHED: ${{ matrix.registry_published }} + steps: + - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4 + with: + persist-credentials: false + - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5 + with: + python-version: '3.12' + - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4 + with: + name: ${{ matrix.tag }} + path: ${{ runner.temp }}/dist + - name: Publish the verified distributions (top-level workflow for OIDC) + if: '!matrix.registry_published' + uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # release/v1 + with: + packages-dir: ${{ runner.temp }}/dist + password: ${{ secrets.PYPI_API_TOKEN }} + print-hash: true + - name: Verify public registry availability + run: | + python3 -m venv "$RUNNER_TEMP/verify" + for attempt in $(seq 1 20); do + if "$RUNNER_TEMP/verify/bin/pip" install --quiet --no-deps --no-cache-dir "$NAME==$VERSION" 2>/dev/null; then exit 0; fi + echo "attempt $attempt: $NAME==$VERSION is not served yet" + sleep 30 + done + echo "::error::PyPI has not served $NAME==$VERSION after ten minutes; rerun Release" + exit 1 + - name: Tag and create the GitHub release + env: + GH_TOKEN: ${{ github.token }} + run: python3 .github/release/github_release.py --install "pip install $NAME==$VERSION" --dist "$RUNNER_TEMP/dist" + typescript-semantic: + name: TypeScript semantic conventions + needs: plan + if: github.event_name != 'pull_request' && needs.plan.outputs.typescript_semantic != '[]' + permissions: + contents: write + id-token: write + uses: ./.github/workflows/release-typescript.yml + with: + packages: ${{ needs.plan.outputs.typescript_semantic }} + publish: ${{ needs.plan.outputs.publish_typescript == 'true' }} secrets: inherit - typescript-core: name: TypeScript core - needs: plan - if: needs.plan.outputs.typescript_core != '[]' + needs: [plan, typescript-semantic] + if: >- + !cancelled() && github.event_name != 'pull_request' && needs.plan.result == 'success' + && (needs.typescript-semantic.result == 'success' || needs.typescript-semantic.result == 'skipped') + && needs.plan.outputs.typescript_core != '[]' permissions: contents: write id-token: write @@ -184,12 +261,12 @@ jobs: packages: ${{ needs.plan.outputs.typescript_core }} publish: ${{ needs.plan.outputs.publish_typescript == 'true' }} secrets: inherit - typescript: name: TypeScript - needs: [plan, typescript-core] + needs: [plan, typescript-semantic, typescript-core] if: >- - !cancelled() && needs.plan.result == 'success' + !cancelled() && github.event_name != 'pull_request' && needs.plan.result == 'success' + && (needs.typescript-semantic.result == 'success' || needs.typescript-semantic.result == 'skipped') && (needs.typescript-core.result == 'success' || needs.typescript-core.result == 'skipped') && needs.plan.outputs.typescript != '[]' permissions: @@ -200,12 +277,38 @@ jobs: packages: ${{ needs.plan.outputs.typescript }} publish: ${{ needs.plan.outputs.publish_typescript == 'true' }} secrets: inherit - + java: + needs: plan + if: github.event_name != 'pull_request' && needs.plan.outputs.java != '[]' + permissions: + contents: write + uses: ./.github/workflows/release-java.yml + with: + packages: ${{ needs.plan.outputs.java }} + publish: ${{ needs.plan.outputs.publish_java == 'true' }} + secrets: inherit + go: + needs: plan + if: github.event_name != 'pull_request' && needs.plan.outputs.go != '[]' + permissions: + contents: write + uses: ./.github/workflows/release-go.yml + with: + packages: ${{ needs.plan.outputs.go }} + publish: ${{ needs.plan.outputs.publish_go == 'true' }} + nuget: + needs: plan + if: github.event_name != 'pull_request' && needs.plan.outputs.nuget != '[]' + permissions: + contents: write + uses: ./.github/workflows/release-nuget.yml + with: + packages: ${{ needs.plan.outputs.nuget }} + publish: ${{ needs.plan.outputs.publish_nuget == 'true' }} + secrets: inherit release: - # The one check to require: red when any package failed, green when every planned package - # went through (a package set that was empty counts as green). name: Release - needs: [plan, python-core, python, typescript-core, typescript] + needs: [plan, python-core-build, python-core, python-build, python, typescript-semantic, typescript-core, typescript, java, go, nuget] if: always() runs-on: ubuntu-latest timeout-minutes: 5 @@ -215,7 +318,30 @@ jobs: RESULTS: ${{ toJson(needs) }} run: | echo "$RESULTS" | jq -r 'to_entries[] | "\(.key): \(.value.result)"' - if echo "$RESULTS" | jq -e '[.[] | .result] | any(. == "failure" or . == "cancelled")' > /dev/null; then - echo "::error title=Release failed::see the failed package jobs above" - exit 1 - fi + if echo "$RESULTS" | jq -e '[.[] | .result] | any(. == "failure" or . == "cancelled")' > /dev/null; then exit 1; fi + release-pr: + name: Maintain one release PR + needs: [plan, release] + if: >- + !cancelled() && github.event_name == 'push' && github.ref == 'refs/heads/main' + && needs.plan.result == 'success' + runs-on: ubuntu-latest + timeout-minutes: 15 + permissions: + contents: write + pull-requests: write + steps: + - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4 + with: + persist-credentials: false + - name: Clear pending label only after all manifest versions have verified releases + env: + GH_TOKEN: ${{ secrets.RELEASE_PLEASE_TOKEN || github.token }} + run: python3 .github/release/complete_release.py + - uses: googleapis/release-please-action@45996ed1f6d02564a971a2fa1b5860e934307cf7 # v5.0.0 (Arize reference) + with: + token: ${{ secrets.RELEASE_PLEASE_TOKEN || github.token }} + target-branch: main + skip-github-release: true + config-file: release-please-config.json + manifest-file: .release-please-manifest.json diff --git a/.release-please-manifest.json b/.release-please-manifest.json new file mode 100644 index 000000000..e0502d62f --- /dev/null +++ b/.release-please-manifest.json @@ -0,0 +1,124 @@ +{ + "python/frameworks/a2a": "0.1.0", + "python/frameworks/ag2": "0.1.0", + "python/frameworks/ag2-classic": "0.1.0", + "python/frameworks/agent-framework": "0.1.0", + "python/frameworks/agno": "0.1.0", + "python/frameworks/anthropic": "0.1.10", + "python/frameworks/autogen": "0.2.1", + "python/frameworks/bedrock": "0.1.10", + "python/frameworks/beeai": "0.1.0", + "python/frameworks/cerebras": "0.1.0", + "python/frameworks/chromadb": "0.1.0", + "python/frameworks/claude-agent-sdk": "0.1.1", + "python/frameworks/cohere": "0.1.0", + "python/frameworks/crewai": "0.1.9", + "python/frameworks/deepseek": "0.1.0", + "python/frameworks/discoveryengine": "0.1.0", + "python/frameworks/dspy": "0.1.8", + "python/frameworks/elevenlabs-agents": "0.1.0", + "python/frameworks/exa": "0.1.0", + "python/frameworks/firecrawl": "0.1.0", + "python/frameworks/fireworks": "0.1.0", + "python/frameworks/google-adk": "0.1.5", + "python/frameworks/google-genai": "0.1.2", + "python/frameworks/google-genai-live": "0.1.0", + "python/frameworks/groq": "0.1.9", + "python/frameworks/guardrails": "0.2.0", + "python/frameworks/haystack": "0.1.9", + "python/frameworks/hermes-agent/hermes-plugin/futureagi": "0.1.0", + "python/frameworks/hermes-agent": "0.1.0", + "python/frameworks/huggingface": "0.1.0", + "python/frameworks/instructor": "0.2.0", + "python/frameworks/lancedb": "0.1.0", + "python/frameworks/langchain": "0.2.1", + "python/frameworks/litellm": "0.1.10", + "python/frameworks/livekit": "0.1.2", + "python/frameworks/llama_index": "0.1.9", + "python/frameworks/mcp": "0.1.2", + "python/frameworks/mcp-use": "0.1.0", + "python/frameworks/milvus": "0.1.0", + "python/frameworks/minimax": "0.1.0", + "python/frameworks/mistralai": "0.1.8", + "python/frameworks/mongodb-vector": "0.1.0", + "python/frameworks/ollama": "0.1.0", + "python/frameworks/openai": "0.1.10", + "python/frameworks/openai-agents": "0.1.6", + "python/frameworks/openai-realtime": "0.1.0", + "python/frameworks/parallel": "0.1.0", + "python/frameworks/pgvector": "0.1.0", + "python/frameworks/pinecone": "0.1.0", + "python/frameworks/pipecat": "0.1.1", + "python/frameworks/portkey": "0.1.2", + "python/frameworks/pydantic-ai": "0.1.0", + "python/frameworks/qdrant": "0.1.0", + "python/frameworks/redis-vector": "0.1.0", + "python/frameworks/replicate": "0.1.0", + "python/frameworks/semantic-kernel": "0.1.0", + "python/frameworks/smolagents": "0.1.5", + "python/frameworks/strands": "0.1.1", + "python/frameworks/tavily": "0.1.0", + "python/frameworks/together": "0.1.0", + "python/frameworks/typesafe": "0.1.0", + "python/frameworks/vertexai": "0.1.10", + "python/frameworks/vllm": "0.1.0", + "python/frameworks/voyage": "0.1.0", + "python/frameworks/weaviate": "0.1.0", + "python/frameworks/xai": "0.1.0", + "python/traceai": "0.1.0", + "typescript/packages/fi-core": "1.1.0", + "typescript/packages/fi-semantic-conventions": "1.0.0", + "typescript/packages/traceai_anthropic": "0.1.3", + "typescript/packages/traceai_bedrock": "0.1.1", + "typescript/packages/traceai_beeai": "0.1.0", + "typescript/packages/traceai_cerebras": "0.1.0", + "typescript/packages/traceai_chromadb": "0.1.0", + "typescript/packages/traceai_claude_agent_sdk": "0.1.0", + "typescript/packages/traceai_codex_sdk": "0.1.0", + "typescript/packages/traceai_cohere": "0.1.0", + "typescript/packages/traceai_cursor_sdk": "0.1.0", + "typescript/packages/traceai_deepseek": "0.1.0", + "typescript/packages/traceai_fireworks": "0.1.0", + "typescript/packages/traceai_genkit": "0.1.0", + "typescript/packages/traceai_google_adk": "0.1.0", + "typescript/packages/traceai_google_genai": "0.1.0", + "typescript/packages/traceai_groq": "0.1.0", + "typescript/packages/traceai_guardrails": "0.1.0", + "typescript/packages/traceai_huggingface": "0.1.0", + "typescript/packages/traceai_instructor": "0.1.0", + "typescript/packages/traceai_lancedb": "0.1.0", + "typescript/packages/traceai_langchain": "0.1.3", + "typescript/packages/traceai_livekit": "0.1.0", + "typescript/packages/traceai_llamaindex": "0.1.1", + "typescript/packages/traceai_mastra": "0.2.0", + "typescript/packages/traceai_mcp": "0.1.0", + "typescript/packages/traceai_milvus": "0.1.0", + "typescript/packages/traceai_mistral": "0.1.0", + "typescript/packages/traceai_mongodb": "0.1.0", + "typescript/packages/traceai_ollama": "0.1.0", + "typescript/packages/traceai_openai": "0.1.14", + "typescript/packages/traceai_openai_agents": "0.2.1", + "typescript/packages/traceai_pgvector": "0.1.0", + "typescript/packages/traceai_pi_coding_agent": "0.1.0", + "typescript/packages/traceai_pinecone": "0.1.0", + "typescript/packages/traceai_pipecat": "0.1.0", + "typescript/packages/traceai_portkey": "0.1.0", + "typescript/packages/traceai_qdrant": "0.1.0", + "typescript/packages/traceai_redis": "0.1.0", + "typescript/packages/traceai_strands": "0.1.0", + "typescript/packages/traceai_together": "0.1.0", + "typescript/packages/traceai_vercel": "0.1.0", + "typescript/packages/traceai_vertexai": "0.1.0", + "typescript/packages/traceai_vllm": "0.1.0", + "typescript/packages/traceai_voltagent": "0.1.0", + "typescript/packages/traceai_weaviate": "0.1.0", + "typescript/packages/traceai_xai": "0.1.0", + "java": "1.0.0", + "go/a2a": "0.1.0", + "go/anthropic": "0.1.0", + "go/eino": "0.1.0", + "go/genai": "0.1.0", + "go/openai": "0.1.0", + "csharp/src/FIInstrumentation": "1.0.0", + "python/fi_instrumentation": "1.2.1" +} diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 127dc0dbf..0174fc538 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -90,29 +90,29 @@ Create structure similar to existing packages, then update `pnpm-workspace.yaml` ## Releasing -A release is a pull request, like any other change. For the package you are releasing: - -1. Bump `version` in its `pyproject.toml` (Python) or `package.json` (TypeScript). If the package - carries a `__version__` (in `version.py` or `__init__.py`), set it to the same value: CI fails - when the two disagree (`python3 .github/release/release_plan.py --check`). -2. Add the version's section to the package's `CHANGELOG.md` (`## [x.y.z] - YYYY-MM-DD`); it - becomes the text of the GitHub release. -3. Merge to `dev`, and `dev` to `main` as usual. - -When `main` changes, the [Release](.github/workflows/release.yml) workflow publishes every package -whose version is not on PyPI or npm yet: it builds the package, checks the distribution, installs it -in a clean environment and imports it, publishes it (the two core packages first), waits until the -registry serves the version, tags the commit (`traceai-livekit-v0.1.2`, `npm-traceai-openai-v0.1.13`) -and creates the GitHub release. A pull request that touches a version only shows what would be -published, in the run summary. `Actions > Release > Run workflow` releases by hand (optionally a -few named packages, or as a dry run). - -Publishing needs credentials that an owner sets once: a PyPI trusted publisher on each project -(workflow `release-python.yml` of this repository) plus the repository variable -`PYPI_TRUSTED_PUBLISHING=true`, or the secret `PYPI_API_TOKEN`; and the secret `NPM_TOKEN` with -publish rights on `@traceai`. Until then the workflow builds, checks and keeps the artifacts, and -warns that nothing was published. Packages that must never be published are listed, with the -reason, in `.github/release/config.json`. Java (JitPack from git tags) and C# are released by hand. +Use Conventional Commit PR titles **and commits** (`fix(openai): ...`, `feat: ...`). +Send changes to **dev**. A maintainer moves dev to **main**; release-please then maintains +one release PR with per-package version bumps and changelogs. Do not hand-bump routine +changes. Merging the release PR publishes the changed versions through the build/verify/ +publish pipeline, with Python and npm core packages first. + +The publisher is the only owner of tags and GitHub releases; release-please does not tag. +Python, npm, Java (Maven Central under `com.futureagi`), Go module tags and NuGet are covered. +Go begins at 0.1.0. JitPack remains available for Java commit previews. + +See [RELEASING.md](RELEASING.md) for the one-time owner checklist, exact secret names, +PyPI trusted publishers (**workflow `release.yml`, not `release-python.yml`**), manual +recovery and dry runs. Pull requests never publish; workflow dispatch defaults to a dry +run and only main is eligible to publish. The workflow never auto-merges a release PR. + +When adding a package, add its release-please config and manifest entries, and Python +runtime-version `extra-files`/markers if applicable. Validate locally: + +```bash +python3 -m unittest discover -s .github/release -p 'test_*.py' +python3 .github/release/release_plan.py --check +python3 .github/release/release_plan.py --offline +``` ## Guidelines diff --git a/RELEASING.md b/RELEASING.md new file mode 100644 index 000000000..756478290 --- /dev/null +++ b/RELEASING.md @@ -0,0 +1,128 @@ +# Releasing traceAI + +## The release loop + +1. Send normal changes to **dev** using Conventional Commit PR titles (`fix(openai): ...`, `feat: ...`). Keep the actual commits conventional too when using merge commits; a PR title alone does not rewrite its commits. Do not hand-bump package versions for routine changes. +2. A maintainer merges dev into **main**. Release automation runs only on main. Nothing is published by a PR into dev or main. +3. The **Release** workflow inventories the current package versions and queries their registries. Unpublished versions are built, checked, uploaded and verified; versions already on a registry are never uploaded again. Python and npm core packages finish before their consumers. +4. At the end of a main push, release-please maintains **one combined release PR targeting main** with per-package versions and changelogs. Changes are scoped by package path. `fix` bumps patch; `feat` also bumps patch before 1.0 (`bump-patch-for-minor-pre-major`, matching [OpenInference](https://github.com/Arize-ai/openinference)). Breaking changes follow release-please's pre-major versioning rules. Java is one Maven reactor; `skip-snapshot` prevents a second SNAPSHOT PR. The Python core is scoped to `python/fi_instrumentation`, with `python/pyproject.toml` and `python/CHANGELOG.md` updated via root-relative paths: a Python strategy rooted at `python/` would recursively overwrite sibling SDK `version.py` files. npm semantic conventions publish before fi-core, then the remaining npm packages. +5. Review and merge that release PR. Its version changes trigger the same build/verify/publish pipeline. The next ordinary changes accumulate in the next release PR. No automatic merging is configured. + +This extends **Tanmay's [#300](https://github.com/future-agi/traceAI/pull/300)**: his planner, core-first publishing, clean-install checks and changelog-based GitHub releases are retained and extended to five languages. The branch contains a normal merge of his publishing branch, not a rewrite of it. + +### Exactly one owner for tags + +**Publishers own all tags and GitHub releases.** release-please runs with `skip-github-release: true`; it only authors the release PR. Tags are created after registry availability is verified (Go necessarily creates its tag first, then verifies the proxy). The publisher acknowledges completed merged release PRs by replacing `autorelease: pending` with `autorelease: tagged`. It does this only after every publishable current manifest version has a GitHub release, so missing credentials or a partial release cannot silently unblock the next release. + +| Ecosystem | Version source | Tag | Delivery | +|---|---|---|---| +| Python | `pyproject.toml`, plus marked runtime `__version__` files | normalized PyPI name + `-vX.Y.Z` | PyPI wheel + sdist | +| npm | each `typescript/packages/*/package.json` | `npm-` + scope/name with `/` replaced by `-`, then `-vX.Y.Z` | exact smoke-tested tarball, public, provenance | +| Java | `java/pom.xml`; release-please updates reactor POMs together | `java-vX.Y.Z` | signed Maven Central reactor, `com.futureagi` | +| Go | `.release-please-manifest.json` entry per module | `go//vX.Y.Z` | source tag; request Go proxy `.info` afterwards | +| NuGet | `csharp/src/FIInstrumentation/FIInstrumentation.csproj` | `nuget-fi-instrumentation-otel-vX.Y.Z` | `dotnet pack`, verified local consumer, push with `--skip-duplicate` | + +The Go proxy URL escapes uppercase letters: `traceAI` becomes `trace!a!i`. A module tag such as `go/openai/v0.1.0` is queried at `https://proxy.golang.org/github.com/future-agi/trace!a!i/go/openai/@v/v0.1.0.info`. No Go registry credentials are needed. JitPack remains a Java commit-preview route; Maven Central is the release route. + +### Bootstrap and the dev → main PR + +The manifest is seeded from the current versions on dev, **not** from old registry versions. Go starts at **0.1.0**. `bootstrap-sha` is the dev head `35f2e3dc364676fa5bdab1e71ae500daf9efc00c`: this deliberately excludes pre-bootstrap history from the first release PR. Keep that SHA as a fallback for components that have not yet acquired matching release tags; do not advance it on each release. + +When [#287](https://github.com/future-agi/traceAI/pull/287) reaches main, existing unpublished versions can ship immediately once their ecosystem's setup is complete. The workflow also repairs missing tags/releases for versions already on a registry, without re-uploading them or attaching newly built binaries to their historical version. Nothing automatically increments every SDK merely because #287 contains old history. The first qualifying **post-bootstrap** package change produces the next bump. + +Two manifests are tracked but intentionally **never published**: + +- `python/traceai`: the PyPI name `traceai` belongs to another publisher. No rename or takeover is attempted. +- `python/frameworks/hermes-agent/hermes-plugin/futureagi`: a Hermes dependency manifest, explicitly not a buildable distribution. + +Java publishing refuses legacy `ai.traceai` coordinates and SNAPSHOT versions. Merge the Java namespace/release-profile PR before expecting Central delivery. The release workflow will not claim that a legacy-coordinate build is a Central release. + +## One-time maintainer setup + +This is a checklist, not something the workflow changes for you. Never paste secret values into issues, PRs, logs or this file. + +### GitHub release PRs + +- [ ] Enable GitHub Actions for the repository and allow Actions to create/approve PRs in repository Actions settings (creation is needed; no automatic approval/merge is configured). +- [ ] Recommended: add **`RELEASE_PLEASE_TOKEN`**, a dedicated fine-grained token with access only to this repository, Contents read/write, Pull requests read/write and Issues read/write (labels). PRs created with this token trigger normal CI. A GitHub App installation token may be supplied instead by adapting the token step. +- [ ] The fallback `GITHUB_TOKEN` can create the PR when repository settings permit it, but GitHub suppresses most workflow events caused by that token: do not assume its generated PR will trigger all required checks. Supply `RELEASE_PLEASE_TOKEN` for unattended CI. +- [ ] Protect main and keep merge approval with a maintainer. The automation does not change branch protection or merge settings. + +### PyPI: trusted publishing preferred + +- [ ] For **each publishable Python project**, add a PyPI Trusted Publisher: owner **`future-agi`**, repository **`traceAI`**, workflow filename **`release.yml`**, environment **blank** (this workflow declares no environment). New projects need a pending publisher before their first upload. The planner's offline inventory lists the exact project names. +- [ ] Set repository **variable** **`PYPI_TRUSTED_PUBLISHING=true`** after all intended project entries exist. No PyPI secret is needed for this mode. +- [ ] Important correction to #300: the trusted publisher filename is **`release.yml`, not `release-python.yml`**. The pinned PyPI action explicitly does not support Trusted Publishing inside reusable workflows. `release-python.yml` now only builds/checks/uploads artifacts with read-only repository access. OIDC upload jobs live in the top-level `release.yml`. +- [ ] Token fallback only: add secret **`PYPI_API_TOKEN`** with upload rights for the intended projects. The publisher uses it when present. Account-scoped tokens can create new projects; project-scoped tokens cannot create another project. Remove the fallback token once trusted publishing is working. + +Sources: [PyPI publisher setup](https://docs.pypi.org/trusted-publishers/adding-a-publisher/) and [pinned PyPI action's reusable-workflow restriction](https://github.com/pypa/gh-action-pypi-publish/blob/7245906fb61fa33a13554f9d5fb856fe61758086/README.md#trusted-publishing). + +### npm + +- [ ] Add **`NPM_TOKEN`**, an automation-capable granular access token with publish permission for the intended **`@traceai`** packages and permission to create any new package names. Configure the required 2FA bypass for automation under your npm policy. Track its expiry and rotate it before expiry. +- [ ] Publishing uses `npm publish --access public --provenance` on a GitHub-hosted Linux runner with `id-token: write`. This is token authentication plus provenance; it does not claim npm Trusted Publishing/OIDC authentication is configured. +- [ ] Confirm the token's account has the necessary package/scope ownership. Already-published names are never renamed. + +### Maven Central: primary Java distribution + +- [ ] In [Central Portal](https://central.sonatype.com/), request namespace **`com.futureagi`**. +- [ ] Add a **DNS TXT record on the exact apex `futureagi.com`** (host `@`, depending on the DNS provider). Its value must be the **Verification Key generated by Central for this namespace request**; it is not a value this repository can pre-generate. Verify DNS propagation, then confirm namespace verification in Central. Do not use `traceai.ai`, `com.futureagi.com` or a `maven-central` subdomain. +- [ ] Generate a Central Portal user token and add **`MAVEN_CENTRAL_USERNAME`** and **`MAVEN_CENTRAL_PASSWORD`** as repository secrets. These are the Portal token's username/password, not your interactive login password. +- [ ] Create a release GPG signing key, publish its **public key** to a public keyserver accessible to Central, and verify the fingerprint. Export the **ASCII-armored private signing key** into **`MAVEN_GPG_PRIVATE_KEY`** and its passphrase into **`MAVEN_GPG_PASSPHRASE`**. Keep the private key out of git and command output. +- [ ] Merge the Java release-profile PR: groupId `com.futureagi`, unchanged artifactIds, sources/javadocs, signing, and `central-publishing-maven-plugin` server id **`central`**. setup-java provides credentials and imports the signing key. The publisher runs **`mvn -B -ntp -P release deploy` from `java/`**. +- [ ] The planner skips a version only when **every reactor artifact** has its POM on Central. Central deployments are verified against canonical repository files, not the delayed search index. Check the Portal for a failed/incomplete deployment before retrying; do not replace immutable artifacts. + +Sources: [namespace verification](https://central.sonatype.org/register/namespace/) and [Central publishing Maven plugin](https://central.sonatype.org/publish/publish-portal-maven/). + +### NuGet + +- [ ] Add **`NUGET_API_KEY`** with push rights for **`fi-instrumentation-otel`** and track its expiration. Grant new-package creation only if needed for a future package, not by default. +- [ ] The build targets **.NET 10** (`net10.0` in the current project), installs the exact packed nupkg into a fresh consumer, and uses `dotnet nuget push --skip-duplicate`. Registry verification precedes tagging. + +Missing credentials disable uploads for that ecosystem and emit a warning; build/check jobs still run. Go can create its source tags on main without registry credentials. Setup does not retroactively start a failed/finished run: rerun Release after finishing the checklist. + +## Checks and dry runs + +From the repository root, using Python **3.11+**: + +```bash +python3 -m unittest discover -s .github/release -p 'test_*.py' +python3 .github/release/release_plan.py --check +python3 .github/release/release_plan.py --offline +python3 .github/release/release_plan.py # read-only live registry queries +python3 .github/release/release_plan.py --only traceAI-openai @traceai/openai +``` + +For the real release-please strategy regression test (offline after installing the tool): + +```bash +npm install --prefix /tmp/traceai-release-please --ignore-scripts --no-audit --no-fund release-please@17.11.2 +NODE_PATH=/tmp/traceai-release-please/node_modules node .github/release/test_release_strategies.cjs +``` + +Once the config/manifest are present on the target branch, preview the actual PR without writing to GitHub: + +```bash +/tmp/traceai-release-please/node_modules/.bin/release-please release-pr \ + --repo-url future-agi/traceAI --target-branch main --dry-run \ + --token "$(gh auth token)" +``` + +Use a token with read access for this dry run. Do not enable shell tracing around tokens. The initial development preview used real dev history with **only** the two proposed, not-yet-merged config files overlaid locally; it found zero post-bootstrap commits and would open zero PRs. A separate fully offline fake-history test exercises a qualifying feature across all five languages and asserts one combined PR plus correct version-file changes. + +For a GitHub-hosted build-only run after the workflow lands on the default branch: + +```bash +gh workflow run release.yml --repo future-agi/traceAI --ref main \ + -f dry_run=true -f packages='traceAI-openai @traceai/openai' +``` + +A dispatch defaults to **dry run**. It creates no release PR, upload, tag or release. PR runs validate scripts/configuration and display the plan; they do not invoke the publishing/build matrices. + +## Manual release and recovery + +After reviewing the plan and completing the applicable setup, a maintainer may deliberately dispatch `Release` on **main** with `dry_run=false`, optionally selecting package names. Dispatches from another branch cannot publish. A manual dispatch does not open/update a release PR; the main push path does that. + +Rerun the same main version after a failure. Registry versions already present are marked `registry_published`; uploads are skipped, visibility checks still run, and absent GitHub releases are repaired. A package leaves the plan only after both its registry version and GitHub release exist. GitHub release/tag creation is idempotent. Never delete/repoint a released tag or overwrite a registry version to repair a failed build. Fix the package and let the next release PR bump it. + +For a deliberate manual version bump, update both the package manifest and its `.release-please-manifest.json` entry, synchronize any Python runtime version strings, and provide the changelog. For Go, the release-please manifest is the version source. Keep release configuration coverage when adding a package; `--check` and the strategy tests run in CI. diff --git a/python/fi_instrumentation/instrumentation/version.py b/python/fi_instrumentation/instrumentation/version.py index a955fdae1..b970fa364 100644 --- a/python/fi_instrumentation/instrumentation/version.py +++ b/python/fi_instrumentation/instrumentation/version.py @@ -1 +1 @@ -__version__ = "1.2.1" +__version__ = "1.2.1" # x-release-please-version diff --git a/python/frameworks/a2a/traceai_a2a/version.py b/python/frameworks/a2a/traceai_a2a/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/a2a/traceai_a2a/version.py +++ b/python/frameworks/a2a/traceai_a2a/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/ag2-classic/traceai_ag2_classic/version.py b/python/frameworks/ag2-classic/traceai_ag2_classic/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/ag2-classic/traceai_ag2_classic/version.py +++ b/python/frameworks/ag2-classic/traceai_ag2_classic/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/ag2/traceai_ag2/version.py b/python/frameworks/ag2/traceai_ag2/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/ag2/traceai_ag2/version.py +++ b/python/frameworks/ag2/traceai_ag2/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/agent-framework/traceai_agent_framework/version.py b/python/frameworks/agent-framework/traceai_agent_framework/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/agent-framework/traceai_agent_framework/version.py +++ b/python/frameworks/agent-framework/traceai_agent_framework/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/agno/traceai_agno/__init__.py b/python/frameworks/agno/traceai_agno/__init__.py index f96fd8852..3238bd056 100644 --- a/python/frameworks/agno/traceai_agno/__init__.py +++ b/python/frameworks/agno/traceai_agno/__init__.py @@ -55,4 +55,4 @@ "create_trace_context", ] -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/anthropic/traceai_anthropic/version.py b/python/frameworks/anthropic/traceai_anthropic/version.py index 569b1212f..b2b8e3d08 100644 --- a/python/frameworks/anthropic/traceai_anthropic/version.py +++ b/python/frameworks/anthropic/traceai_anthropic/version.py @@ -1 +1 @@ -__version__ = "0.1.10" +__version__ = "0.1.10" # x-release-please-version diff --git a/python/frameworks/autogen/traceai_autogen/__init__.py b/python/frameworks/autogen/traceai_autogen/__init__.py index 4cbd10aaf..8384652f2 100644 --- a/python/frameworks/autogen/traceai_autogen/__init__.py +++ b/python/frameworks/autogen/traceai_autogen/__init__.py @@ -20,7 +20,7 @@ _MODULE_V04_AGENTS = "autogen_agentchat.agents" _MODULE_V04_TEAMS = "autogen_agentchat.teams" -__version__ = "0.2.0" +__version__ = "0.2.1" # x-release-please-version _instruments = ("autogen-agentchat>=0.4.0",) diff --git a/python/frameworks/autogen/traceai_autogen/version.py b/python/frameworks/autogen/traceai_autogen/version.py index 3ced3581b..130276d81 100644 --- a/python/frameworks/autogen/traceai_autogen/version.py +++ b/python/frameworks/autogen/traceai_autogen/version.py @@ -1 +1 @@ -__version__ = "0.2.1" +__version__ = "0.2.1" # x-release-please-version diff --git a/python/frameworks/bedrock/traceai_bedrock/version.py b/python/frameworks/bedrock/traceai_bedrock/version.py index 569b1212f..b2b8e3d08 100644 --- a/python/frameworks/bedrock/traceai_bedrock/version.py +++ b/python/frameworks/bedrock/traceai_bedrock/version.py @@ -1 +1 @@ -__version__ = "0.1.10" +__version__ = "0.1.10" # x-release-please-version diff --git a/python/frameworks/beeai/traceai_beeai/__init__.py b/python/frameworks/beeai/traceai_beeai/__init__.py index 8068486f5..cd93c3643 100644 --- a/python/frameworks/beeai/traceai_beeai/__init__.py +++ b/python/frameworks/beeai/traceai_beeai/__init__.py @@ -57,4 +57,4 @@ "create_tracing_middleware", ] -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/cerebras/traceai_cerebras/version.py b/python/frameworks/cerebras/traceai_cerebras/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/cerebras/traceai_cerebras/version.py +++ b/python/frameworks/cerebras/traceai_cerebras/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/chromadb/traceai_chromadb/version.py b/python/frameworks/chromadb/traceai_chromadb/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/chromadb/traceai_chromadb/version.py +++ b/python/frameworks/chromadb/traceai_chromadb/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/claude-agent-sdk/traceai_claude_agent_sdk/__init__.py b/python/frameworks/claude-agent-sdk/traceai_claude_agent_sdk/__init__.py index 348b8223f..26ffedf24 100644 --- a/python/frameworks/claude-agent-sdk/traceai_claude_agent_sdk/__init__.py +++ b/python/frameworks/claude-agent-sdk/traceai_claude_agent_sdk/__init__.py @@ -36,7 +36,7 @@ async def main(): from traceai_claude_agent_sdk._session_tracker import SessionTracker from traceai_claude_agent_sdk._mcp_tracker import MCPTracker -__version__ = "0.1.1" +__version__ = "0.1.1" # x-release-please-version __all__ = [ # Main API diff --git a/python/frameworks/cohere/traceai_cohere/version.py b/python/frameworks/cohere/traceai_cohere/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/cohere/traceai_cohere/version.py +++ b/python/frameworks/cohere/traceai_cohere/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/crewai/traceai_crewai/version.py b/python/frameworks/crewai/traceai_crewai/version.py index c11f861af..a99028c1f 100644 --- a/python/frameworks/crewai/traceai_crewai/version.py +++ b/python/frameworks/crewai/traceai_crewai/version.py @@ -1 +1 @@ -__version__ = "0.1.9" +__version__ = "0.1.9" # x-release-please-version diff --git a/python/frameworks/deepseek/traceai_deepseek/version.py b/python/frameworks/deepseek/traceai_deepseek/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/deepseek/traceai_deepseek/version.py +++ b/python/frameworks/deepseek/traceai_deepseek/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/discoveryengine/traceai_discoveryengine/version.py b/python/frameworks/discoveryengine/traceai_discoveryengine/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/discoveryengine/traceai_discoveryengine/version.py +++ b/python/frameworks/discoveryengine/traceai_discoveryengine/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/dspy/traceai_dspy/version.py b/python/frameworks/dspy/traceai_dspy/version.py index 9cb17e797..bad05c2e5 100644 --- a/python/frameworks/dspy/traceai_dspy/version.py +++ b/python/frameworks/dspy/traceai_dspy/version.py @@ -1 +1 @@ -__version__ = "0.1.8" +__version__ = "0.1.8" # x-release-please-version diff --git a/python/frameworks/elevenlabs-agents/traceai_elevenlabs_agents/version.py b/python/frameworks/elevenlabs-agents/traceai_elevenlabs_agents/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/elevenlabs-agents/traceai_elevenlabs_agents/version.py +++ b/python/frameworks/elevenlabs-agents/traceai_elevenlabs_agents/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/exa/traceai_exa/version.py b/python/frameworks/exa/traceai_exa/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/exa/traceai_exa/version.py +++ b/python/frameworks/exa/traceai_exa/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/firecrawl/traceai_firecrawl/version.py b/python/frameworks/firecrawl/traceai_firecrawl/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/firecrawl/traceai_firecrawl/version.py +++ b/python/frameworks/firecrawl/traceai_firecrawl/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/fireworks/traceai_fireworks/version.py b/python/frameworks/fireworks/traceai_fireworks/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/fireworks/traceai_fireworks/version.py +++ b/python/frameworks/fireworks/traceai_fireworks/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/google-adk/traceai_google_adk/version.py b/python/frameworks/google-adk/traceai_google_adk/version.py index de49d1fae..df9de31c3 100644 --- a/python/frameworks/google-adk/traceai_google_adk/version.py +++ b/python/frameworks/google-adk/traceai_google_adk/version.py @@ -1 +1 @@ -__version__ = "0.1.5" \ No newline at end of file +__version__ = "0.1.5" # x-release-please-version \ No newline at end of file diff --git a/python/frameworks/google-genai-live/traceai_google_genai_live/version.py b/python/frameworks/google-genai-live/traceai_google_genai_live/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/google-genai-live/traceai_google_genai_live/version.py +++ b/python/frameworks/google-genai-live/traceai_google_genai_live/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/google-genai/traceai_google_genai/version.py b/python/frameworks/google-genai/traceai_google_genai/version.py index b3f475621..0d33eef3f 100644 --- a/python/frameworks/google-genai/traceai_google_genai/version.py +++ b/python/frameworks/google-genai/traceai_google_genai/version.py @@ -1 +1 @@ -__version__ = "0.1.2" +__version__ = "0.1.2" # x-release-please-version diff --git a/python/frameworks/groq/traceai_groq/version.py b/python/frameworks/groq/traceai_groq/version.py index c11f861af..a99028c1f 100644 --- a/python/frameworks/groq/traceai_groq/version.py +++ b/python/frameworks/groq/traceai_groq/version.py @@ -1 +1 @@ -__version__ = "0.1.9" +__version__ = "0.1.9" # x-release-please-version diff --git a/python/frameworks/guardrails/traceai_guardrails/version.py b/python/frameworks/guardrails/traceai_guardrails/version.py index d3ec452c3..e44b515c6 100644 --- a/python/frameworks/guardrails/traceai_guardrails/version.py +++ b/python/frameworks/guardrails/traceai_guardrails/version.py @@ -1 +1 @@ -__version__ = "0.2.0" +__version__ = "0.2.0" # x-release-please-version diff --git a/python/frameworks/haystack/traceai_haystack/version.py b/python/frameworks/haystack/traceai_haystack/version.py index c11f861af..a99028c1f 100644 --- a/python/frameworks/haystack/traceai_haystack/version.py +++ b/python/frameworks/haystack/traceai_haystack/version.py @@ -1 +1 @@ -__version__ = "0.1.9" +__version__ = "0.1.9" # x-release-please-version diff --git a/python/frameworks/hermes-agent/traceai_hermes_agent/version.py b/python/frameworks/hermes-agent/traceai_hermes_agent/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/hermes-agent/traceai_hermes_agent/version.py +++ b/python/frameworks/hermes-agent/traceai_hermes_agent/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/huggingface/traceai_huggingface/version.py b/python/frameworks/huggingface/traceai_huggingface/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/huggingface/traceai_huggingface/version.py +++ b/python/frameworks/huggingface/traceai_huggingface/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/instructor/traceai_instructor/version.py b/python/frameworks/instructor/traceai_instructor/version.py index d3ec452c3..e44b515c6 100644 --- a/python/frameworks/instructor/traceai_instructor/version.py +++ b/python/frameworks/instructor/traceai_instructor/version.py @@ -1 +1 @@ -__version__ = "0.2.0" +__version__ = "0.2.0" # x-release-please-version diff --git a/python/frameworks/lancedb/traceai_lancedb/version.py b/python/frameworks/lancedb/traceai_lancedb/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/lancedb/traceai_lancedb/version.py +++ b/python/frameworks/lancedb/traceai_lancedb/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/langchain/traceai_langchain/version.py b/python/frameworks/langchain/traceai_langchain/version.py index 3ced3581b..130276d81 100644 --- a/python/frameworks/langchain/traceai_langchain/version.py +++ b/python/frameworks/langchain/traceai_langchain/version.py @@ -1 +1 @@ -__version__ = "0.2.1" +__version__ = "0.2.1" # x-release-please-version diff --git a/python/frameworks/litellm/traceai_litellm/version.py b/python/frameworks/litellm/traceai_litellm/version.py index 569b1212f..b2b8e3d08 100644 --- a/python/frameworks/litellm/traceai_litellm/version.py +++ b/python/frameworks/litellm/traceai_litellm/version.py @@ -1 +1 @@ -__version__ = "0.1.10" +__version__ = "0.1.10" # x-release-please-version diff --git a/python/frameworks/livekit/traceai_livekit/__init__.py b/python/frameworks/livekit/traceai_livekit/__init__.py index 041a8db1d..403d15256 100644 --- a/python/frameworks/livekit/traceai_livekit/__init__.py +++ b/python/frameworks/livekit/traceai_livekit/__init__.py @@ -19,7 +19,7 @@ flush_on_job_shutdown, ) -__version__ = "0.1.2" +__version__ = "0.1.2" # x-release-please-version __all__ = [ "enable_fi_attribute_mapping", diff --git a/python/frameworks/llama_index/traceai_llamaindex/version.py b/python/frameworks/llama_index/traceai_llamaindex/version.py index c11f861af..a99028c1f 100644 --- a/python/frameworks/llama_index/traceai_llamaindex/version.py +++ b/python/frameworks/llama_index/traceai_llamaindex/version.py @@ -1 +1 @@ -__version__ = "0.1.9" +__version__ = "0.1.9" # x-release-please-version diff --git a/python/frameworks/mcp-use/traceai_mcp_use/version.py b/python/frameworks/mcp-use/traceai_mcp_use/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/mcp-use/traceai_mcp_use/version.py +++ b/python/frameworks/mcp-use/traceai_mcp_use/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/mcp/traceai_mcp/version.py b/python/frameworks/mcp/traceai_mcp/version.py index b3f475621..0d33eef3f 100644 --- a/python/frameworks/mcp/traceai_mcp/version.py +++ b/python/frameworks/mcp/traceai_mcp/version.py @@ -1 +1 @@ -__version__ = "0.1.2" +__version__ = "0.1.2" # x-release-please-version diff --git a/python/frameworks/milvus/traceai_milvus/version.py b/python/frameworks/milvus/traceai_milvus/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/milvus/traceai_milvus/version.py +++ b/python/frameworks/milvus/traceai_milvus/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/minimax/traceai_minimax/version.py b/python/frameworks/minimax/traceai_minimax/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/minimax/traceai_minimax/version.py +++ b/python/frameworks/minimax/traceai_minimax/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/mistralai/traceai_mistralai/version.py b/python/frameworks/mistralai/traceai_mistralai/version.py index 9cb17e797..bad05c2e5 100644 --- a/python/frameworks/mistralai/traceai_mistralai/version.py +++ b/python/frameworks/mistralai/traceai_mistralai/version.py @@ -1 +1 @@ -__version__ = "0.1.8" +__version__ = "0.1.8" # x-release-please-version diff --git a/python/frameworks/mongodb-vector/traceai_mongodb/version.py b/python/frameworks/mongodb-vector/traceai_mongodb/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/mongodb-vector/traceai_mongodb/version.py +++ b/python/frameworks/mongodb-vector/traceai_mongodb/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/ollama/traceai_ollama/version.py b/python/frameworks/ollama/traceai_ollama/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/ollama/traceai_ollama/version.py +++ b/python/frameworks/ollama/traceai_ollama/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/openai-agents/traceai_openai_agents/version.py b/python/frameworks/openai-agents/traceai_openai_agents/version.py index 0a8da8825..80efe0760 100644 --- a/python/frameworks/openai-agents/traceai_openai_agents/version.py +++ b/python/frameworks/openai-agents/traceai_openai_agents/version.py @@ -1 +1 @@ -__version__ = "0.1.6" +__version__ = "0.1.6" # x-release-please-version diff --git a/python/frameworks/openai-realtime/traceai_openai_realtime/version.py b/python/frameworks/openai-realtime/traceai_openai_realtime/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/openai-realtime/traceai_openai_realtime/version.py +++ b/python/frameworks/openai-realtime/traceai_openai_realtime/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/openai/traceai_openai/version.py b/python/frameworks/openai/traceai_openai/version.py index 569b1212f..b2b8e3d08 100644 --- a/python/frameworks/openai/traceai_openai/version.py +++ b/python/frameworks/openai/traceai_openai/version.py @@ -1 +1 @@ -__version__ = "0.1.10" +__version__ = "0.1.10" # x-release-please-version diff --git a/python/frameworks/parallel/traceai_parallel/version.py b/python/frameworks/parallel/traceai_parallel/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/parallel/traceai_parallel/version.py +++ b/python/frameworks/parallel/traceai_parallel/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/pgvector/traceai_pgvector/version.py b/python/frameworks/pgvector/traceai_pgvector/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/pgvector/traceai_pgvector/version.py +++ b/python/frameworks/pgvector/traceai_pgvector/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/pinecone/traceai_pinecone/version.py b/python/frameworks/pinecone/traceai_pinecone/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/pinecone/traceai_pinecone/version.py +++ b/python/frameworks/pinecone/traceai_pinecone/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/pipecat/traceai_pipecat/__init__.py b/python/frameworks/pipecat/traceai_pipecat/__init__.py index 3b9da9f8b..dceff4e2f 100644 --- a/python/frameworks/pipecat/traceai_pipecat/__init__.py +++ b/python/frameworks/pipecat/traceai_pipecat/__init__.py @@ -18,7 +18,7 @@ enable_http_attribute_mapping, ) -__version__ = "0.1.1" +__version__ = "0.1.1" # x-release-please-version __all__ = [ "enable_fi_attribute_mapping", diff --git a/python/frameworks/pipecat/traceai_pipecat/version.py b/python/frameworks/pipecat/traceai_pipecat/version.py index 485f44ac2..34d76ee9e 100644 --- a/python/frameworks/pipecat/traceai_pipecat/version.py +++ b/python/frameworks/pipecat/traceai_pipecat/version.py @@ -1 +1 @@ -__version__ = "0.1.1" +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/portkey/traceai_portkey/version.py b/python/frameworks/portkey/traceai_portkey/version.py index 48fef3235..0cb50a5ae 100644 --- a/python/frameworks/portkey/traceai_portkey/version.py +++ b/python/frameworks/portkey/traceai_portkey/version.py @@ -1 +1 @@ -__version__ = "0.1.2" \ No newline at end of file +__version__ = "0.1.2" # x-release-please-version \ No newline at end of file diff --git a/python/frameworks/pydantic-ai/traceai_pydantic_ai/__init__.py b/python/frameworks/pydantic-ai/traceai_pydantic_ai/__init__.py index 989f1d2e9..537bf6110 100644 --- a/python/frameworks/pydantic-ai/traceai_pydantic_ai/__init__.py +++ b/python/frameworks/pydantic-ai/traceai_pydantic_ai/__init__.py @@ -32,7 +32,7 @@ wrap_tool_function, ) -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version __all__ = [ # Main API diff --git a/python/frameworks/qdrant/traceai_qdrant/version.py b/python/frameworks/qdrant/traceai_qdrant/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/qdrant/traceai_qdrant/version.py +++ b/python/frameworks/qdrant/traceai_qdrant/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/redis-vector/traceai_redis/version.py b/python/frameworks/redis-vector/traceai_redis/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/redis-vector/traceai_redis/version.py +++ b/python/frameworks/redis-vector/traceai_redis/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/replicate/traceai_replicate/version.py b/python/frameworks/replicate/traceai_replicate/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/replicate/traceai_replicate/version.py +++ b/python/frameworks/replicate/traceai_replicate/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/semantic-kernel/traceai_semantic_kernel/version.py b/python/frameworks/semantic-kernel/traceai_semantic_kernel/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/semantic-kernel/traceai_semantic_kernel/version.py +++ b/python/frameworks/semantic-kernel/traceai_semantic_kernel/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/smolagents/traceai_smolagents/version.py b/python/frameworks/smolagents/traceai_smolagents/version.py index 1276d0254..79597ce75 100644 --- a/python/frameworks/smolagents/traceai_smolagents/version.py +++ b/python/frameworks/smolagents/traceai_smolagents/version.py @@ -1 +1 @@ -__version__ = "0.1.5" +__version__ = "0.1.5" # x-release-please-version diff --git a/python/frameworks/strands/traceai_strands/__init__.py b/python/frameworks/strands/traceai_strands/__init__.py index f72372605..e515e3b20 100644 --- a/python/frameworks/strands/traceai_strands/__init__.py +++ b/python/frameworks/strands/traceai_strands/__init__.py @@ -53,4 +53,4 @@ "get_model_attributes", ] -__version__ = "0.1.1" +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/tavily/traceai_tavily/version.py b/python/frameworks/tavily/traceai_tavily/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/tavily/traceai_tavily/version.py +++ b/python/frameworks/tavily/traceai_tavily/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/together/traceai_together/version.py b/python/frameworks/together/traceai_together/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/together/traceai_together/version.py +++ b/python/frameworks/together/traceai_together/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/typesafe/traceai_typesafe/version.py b/python/frameworks/typesafe/traceai_typesafe/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/typesafe/traceai_typesafe/version.py +++ b/python/frameworks/typesafe/traceai_typesafe/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/vertexai/traceai_vertexai/version.py b/python/frameworks/vertexai/traceai_vertexai/version.py index 569b1212f..b2b8e3d08 100644 --- a/python/frameworks/vertexai/traceai_vertexai/version.py +++ b/python/frameworks/vertexai/traceai_vertexai/version.py @@ -1 +1 @@ -__version__ = "0.1.10" +__version__ = "0.1.10" # x-release-please-version diff --git a/python/frameworks/vllm/traceai_vllm/version.py b/python/frameworks/vllm/traceai_vllm/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/vllm/traceai_vllm/version.py +++ b/python/frameworks/vllm/traceai_vllm/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/voyage/traceai_voyage/version.py b/python/frameworks/voyage/traceai_voyage/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/voyage/traceai_voyage/version.py +++ b/python/frameworks/voyage/traceai_voyage/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/weaviate/traceai_weaviate/version.py b/python/frameworks/weaviate/traceai_weaviate/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/weaviate/traceai_weaviate/version.py +++ b/python/frameworks/weaviate/traceai_weaviate/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/python/frameworks/xai/traceai_xai/version.py b/python/frameworks/xai/traceai_xai/version.py index 3dc1f76bc..75716eb9a 100644 --- a/python/frameworks/xai/traceai_xai/version.py +++ b/python/frameworks/xai/traceai_xai/version.py @@ -1 +1 @@ -__version__ = "0.1.0" +__version__ = "0.1.0" # x-release-please-version diff --git a/release-please-config.json b/release-please-config.json new file mode 100644 index 000000000..1b27a343d --- /dev/null +++ b/release-please-config.json @@ -0,0 +1,857 @@ +{ + "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json", + "bootstrap-sha": "35f2e3dc364676fa5bdab1e71ae500daf9efc00c", + "bump-patch-for-minor-pre-major": true, + "separate-pull-requests": false, + "sequential-calls": true, + "include-component-in-tag": true, + "include-v-in-tag": true, + "tag-separator": "-", + "pull-request-title-pattern": "chore${scope}: release${component} ${version}", + "packages": { + "python/frameworks/a2a": { + "release-type": "python", + "component": "traceai-a2a", + "package-name": "traceAI-a2a", + "extra-files": [ + "traceai_a2a/version.py" + ] + }, + "python/frameworks/ag2": { + "release-type": "python", + "component": "traceai-ag2", + "package-name": "traceAI-ag2", + "extra-files": [ + "traceai_ag2/version.py" + ] + }, + "python/frameworks/ag2-classic": { + "release-type": "python", + "component": "traceai-ag2-classic", + "package-name": "traceAI-ag2-classic", + "extra-files": [ + "traceai_ag2_classic/version.py" + ] + }, + "python/frameworks/agent-framework": { + "release-type": "python", + "component": "traceai-agent-framework", + "package-name": "traceAI-agent-framework", + "extra-files": [ + "traceai_agent_framework/version.py" + ] + }, + "python/frameworks/agno": { + "release-type": "python", + "component": "traceai-agno", + "package-name": "traceai-agno", + "extra-files": [ + "traceai_agno/__init__.py" + ] + }, + "python/frameworks/anthropic": { + "release-type": "python", + "component": "traceai-anthropic", + "package-name": "traceAI-anthropic", + "extra-files": [ + "traceai_anthropic/version.py" + ] + }, + "python/frameworks/autogen": { + "release-type": "python", + "component": "traceai-autogen", + "package-name": "traceAI-autogen", + "extra-files": [ + "traceai_autogen/__init__.py", + "traceai_autogen/version.py" + ] + }, + "python/frameworks/bedrock": { + "release-type": "python", + "component": "traceai-bedrock", + "package-name": "traceAI-bedrock", + "extra-files": [ + "traceai_bedrock/version.py" + ] + }, + "python/frameworks/beeai": { + "release-type": "python", + "component": "traceai-beeai", + "package-name": "traceai-beeai", + "extra-files": [ + "traceai_beeai/__init__.py" + ] + }, + "python/frameworks/cerebras": { + "release-type": "python", + "component": "traceai-cerebras", + "package-name": "traceAI-cerebras", + "extra-files": [ + "traceai_cerebras/version.py" + ] + }, + "python/frameworks/chromadb": { + "release-type": "python", + "component": "traceai-chromadb", + "package-name": "traceAI-chromadb", + "extra-files": [ + "traceai_chromadb/version.py" + ] + }, + "python/frameworks/claude-agent-sdk": { + "release-type": "python", + "component": "traceai-claude-agent-sdk", + "package-name": "traceai-claude-agent-sdk", + "extra-files": [ + "traceai_claude_agent_sdk/__init__.py" + ] + }, + "python/frameworks/cohere": { + "release-type": "python", + "component": "traceai-cohere", + "package-name": "traceAI-cohere", + "extra-files": [ + "traceai_cohere/version.py" + ] + }, + "python/frameworks/crewai": { + "release-type": "python", + "component": "traceai-crewai", + "package-name": "traceAI-crewai", + "extra-files": [ + "traceai_crewai/version.py" + ] + }, + "python/frameworks/deepseek": { + "release-type": "python", + "component": "traceai-deepseek", + "package-name": "traceAI-deepseek", + "extra-files": [ + "traceai_deepseek/version.py" + ] + }, + "python/frameworks/discoveryengine": { + "release-type": "python", + "component": "traceai-discoveryengine", + "package-name": "traceAI-discoveryengine", + "extra-files": [ + "traceai_discoveryengine/version.py" + ] + }, + "python/frameworks/dspy": { + "release-type": "python", + "component": "traceai-dspy", + "package-name": "traceAI-DSPy", + "extra-files": [ + "traceai_dspy/version.py" + ] + }, + "python/frameworks/elevenlabs-agents": { + "release-type": "python", + "component": "traceai-elevenlabs-agents", + "package-name": "traceAI-elevenlabs-agents", + "extra-files": [ + "traceai_elevenlabs_agents/version.py" + ] + }, + "python/frameworks/exa": { + "release-type": "python", + "component": "traceai-exa", + "package-name": "traceAI-exa", + "extra-files": [ + "traceai_exa/version.py" + ] + }, + "python/frameworks/firecrawl": { + "release-type": "python", + "component": "traceai-firecrawl", + "package-name": "traceAI-firecrawl", + "extra-files": [ + "traceai_firecrawl/version.py" + ] + }, + "python/frameworks/fireworks": { + "release-type": "python", + "component": "traceai-fireworks", + "package-name": "traceAI-fireworks", + "extra-files": [ + "traceai_fireworks/version.py" + ] + }, + "python/frameworks/google-adk": { + "release-type": "python", + "component": "traceai-google-adk", + "package-name": "traceAI-google-adk", + "extra-files": [ + "traceai_google_adk/version.py" + ] + }, + "python/frameworks/google-genai": { + "release-type": "python", + "component": "traceai-google-genai", + "package-name": "traceAI-google-genai", + "extra-files": [ + "traceai_google_genai/version.py" + ] + }, + "python/frameworks/google-genai-live": { + "release-type": "python", + "component": "traceai-google-genai-live", + "package-name": "traceAI-google-genai-live", + "extra-files": [ + "traceai_google_genai_live/version.py" + ] + }, + "python/frameworks/groq": { + "release-type": "python", + "component": "traceai-groq", + "package-name": "traceAI-groq", + "extra-files": [ + "traceai_groq/version.py" + ] + }, + "python/frameworks/guardrails": { + "release-type": "python", + "component": "traceai-guardrails", + "package-name": "traceAI-guardrails", + "extra-files": [ + "traceai_guardrails/version.py" + ] + }, + "python/frameworks/haystack": { + "release-type": "python", + "component": "traceai-haystack", + "package-name": "traceAI-haystack", + "extra-files": [ + "traceai_haystack/version.py" + ] + }, + "python/frameworks/hermes-agent/hermes-plugin/futureagi": { + "release-type": "python", + "component": "futureagi-hermes-plugin", + "package-name": "futureagi-hermes-plugin", + "skip-github-release": true, + "extra-files": [], + "exclude-paths": [ + "python/frameworks/hermes-agent/hermes-plugin/futureagi" + ] + }, + "python/frameworks/hermes-agent": { + "release-type": "python", + "component": "traceai-hermes-agent", + "package-name": "traceAI-hermes-agent", + "extra-files": [ + "traceai_hermes_agent/version.py" + ] + }, + "python/frameworks/huggingface": { + "release-type": "python", + "component": "traceai-huggingface", + "package-name": "traceAI-huggingface", + "extra-files": [ + "traceai_huggingface/version.py" + ] + }, + "python/frameworks/instructor": { + "release-type": "python", + "component": "traceai-instructor", + "package-name": "traceAI-instructor", + "extra-files": [ + "traceai_instructor/version.py" + ] + }, + "python/frameworks/lancedb": { + "release-type": "python", + "component": "traceai-lancedb", + "package-name": "traceAI-lancedb", + "extra-files": [ + "traceai_lancedb/version.py" + ] + }, + "python/frameworks/langchain": { + "release-type": "python", + "component": "traceai-langchain", + "package-name": "traceAI-langchain", + "extra-files": [ + "traceai_langchain/version.py" + ] + }, + "python/frameworks/litellm": { + "release-type": "python", + "component": "traceai-litellm", + "package-name": "traceAI-litellm", + "extra-files": [ + "traceai_litellm/version.py" + ] + }, + "python/frameworks/livekit": { + "release-type": "python", + "component": "traceai-livekit", + "package-name": "traceAI-livekit", + "extra-files": [ + "traceai_livekit/__init__.py" + ] + }, + "python/frameworks/llama_index": { + "release-type": "python", + "component": "traceai-llamaindex", + "package-name": "traceAI-llamaindex", + "extra-files": [ + "traceai_llamaindex/version.py" + ] + }, + "python/frameworks/mcp": { + "release-type": "python", + "component": "traceai-mcp", + "package-name": "traceAI-mcp", + "extra-files": [ + "traceai_mcp/version.py" + ] + }, + "python/frameworks/mcp-use": { + "release-type": "python", + "component": "traceai-mcp-use", + "package-name": "traceAI-mcp-use", + "extra-files": [ + "traceai_mcp_use/version.py" + ] + }, + "python/frameworks/milvus": { + "release-type": "python", + "component": "traceai-milvus", + "package-name": "traceAI-milvus", + "extra-files": [ + "traceai_milvus/version.py" + ] + }, + "python/frameworks/minimax": { + "release-type": "python", + "component": "traceai-minimax", + "package-name": "traceAI-minimax", + "extra-files": [ + "traceai_minimax/version.py" + ] + }, + "python/frameworks/mistralai": { + "release-type": "python", + "component": "traceai-mistralai", + "package-name": "traceAI-mistralai", + "extra-files": [ + "traceai_mistralai/version.py" + ] + }, + "python/frameworks/mongodb-vector": { + "release-type": "python", + "component": "traceai-mongodb", + "package-name": "traceAI-mongodb", + "extra-files": [ + "traceai_mongodb/version.py" + ] + }, + "python/frameworks/ollama": { + "release-type": "python", + "component": "traceai-ollama", + "package-name": "traceAI-ollama", + "extra-files": [ + "traceai_ollama/version.py" + ] + }, + "python/frameworks/openai": { + "release-type": "python", + "component": "traceai-openai", + "package-name": "traceAI-openai", + "extra-files": [ + "traceai_openai/version.py" + ] + }, + "python/frameworks/openai-agents": { + "release-type": "python", + "component": "traceai-openai-agents", + "package-name": "traceAI-openai-agents", + "extra-files": [ + "traceai_openai_agents/version.py" + ] + }, + "python/frameworks/openai-realtime": { + "release-type": "python", + "component": "traceai-openai-realtime", + "package-name": "traceAI-openai-realtime", + "extra-files": [ + "traceai_openai_realtime/version.py" + ] + }, + "python/frameworks/parallel": { + "release-type": "python", + "component": "traceai-parallel", + "package-name": "traceAI-parallel", + "extra-files": [ + "traceai_parallel/version.py" + ] + }, + "python/frameworks/pgvector": { + "release-type": "python", + "component": "traceai-pgvector", + "package-name": "traceAI-pgvector", + "extra-files": [ + "traceai_pgvector/version.py" + ] + }, + "python/frameworks/pinecone": { + "release-type": "python", + "component": "traceai-pinecone", + "package-name": "traceAI-pinecone", + "extra-files": [ + "traceai_pinecone/version.py" + ] + }, + "python/frameworks/pipecat": { + "release-type": "python", + "component": "traceai-pipecat", + "package-name": "traceAI-pipecat", + "extra-files": [ + "traceai_pipecat/__init__.py", + "traceai_pipecat/version.py" + ] + }, + "python/frameworks/portkey": { + "release-type": "python", + "component": "traceai-portkey", + "package-name": "traceAI-portkey", + "extra-files": [ + "traceai_portkey/version.py" + ] + }, + "python/frameworks/pydantic-ai": { + "release-type": "python", + "component": "traceai-pydantic-ai", + "package-name": "traceai-pydantic-ai", + "extra-files": [ + "traceai_pydantic_ai/__init__.py" + ] + }, + "python/frameworks/qdrant": { + "release-type": "python", + "component": "traceai-qdrant", + "package-name": "traceAI-qdrant", + "extra-files": [ + "traceai_qdrant/version.py" + ] + }, + "python/frameworks/redis-vector": { + "release-type": "python", + "component": "traceai-redis", + "package-name": "traceAI-redis", + "extra-files": [ + "traceai_redis/version.py" + ] + }, + "python/frameworks/replicate": { + "release-type": "python", + "component": "traceai-replicate", + "package-name": "traceAI-replicate", + "extra-files": [ + "traceai_replicate/version.py" + ] + }, + "python/frameworks/semantic-kernel": { + "release-type": "python", + "component": "traceai-semantic-kernel", + "package-name": "traceAI-semantic-kernel", + "extra-files": [ + "traceai_semantic_kernel/version.py" + ] + }, + "python/frameworks/smolagents": { + "release-type": "python", + "component": "traceai-smolagents", + "package-name": "traceAI-smolagents", + "extra-files": [ + "traceai_smolagents/version.py" + ] + }, + "python/frameworks/strands": { + "release-type": "python", + "component": "traceai-strands", + "package-name": "traceai-strands", + "extra-files": [ + "traceai_strands/__init__.py" + ] + }, + "python/frameworks/tavily": { + "release-type": "python", + "component": "traceai-tavily", + "package-name": "traceAI-tavily", + "extra-files": [ + "traceai_tavily/version.py" + ] + }, + "python/frameworks/together": { + "release-type": "python", + "component": "traceai-together", + "package-name": "traceAI-together", + "extra-files": [ + "traceai_together/version.py" + ] + }, + "python/frameworks/typesafe": { + "release-type": "python", + "component": "traceai-typesafe", + "package-name": "traceAI-typesafe", + "extra-files": [ + "traceai_typesafe/version.py" + ] + }, + "python/frameworks/vertexai": { + "release-type": "python", + "component": "traceai-vertexai", + "package-name": "traceAI-vertexai", + "extra-files": [ + "traceai_vertexai/version.py" + ] + }, + "python/frameworks/vllm": { + "release-type": "python", + "component": "traceai-vllm", + "package-name": "traceAI-vllm", + "extra-files": [ + "traceai_vllm/version.py" + ] + }, + "python/frameworks/voyage": { + "release-type": "python", + "component": "traceai-voyage", + "package-name": "traceAI-voyage", + "extra-files": [ + "traceai_voyage/version.py" + ] + }, + "python/frameworks/weaviate": { + "release-type": "python", + "component": "traceai-weaviate", + "package-name": "traceAI-weaviate", + "extra-files": [ + "traceai_weaviate/version.py" + ] + }, + "python/frameworks/xai": { + "release-type": "python", + "component": "traceai-xai", + "package-name": "traceAI-xai", + "extra-files": [ + "traceai_xai/version.py" + ] + }, + "python/traceai": { + "release-type": "python", + "component": "traceai", + "package-name": "traceai", + "skip-github-release": true, + "extra-files": [], + "exclude-paths": [ + "python/traceai" + ] + }, + "typescript/packages/fi-core": { + "release-type": "node", + "component": "npm-traceai-fi-core", + "package-name": "@traceai/fi-core" + }, + "typescript/packages/fi-semantic-conventions": { + "release-type": "node", + "component": "npm-traceai-fi-semantic-conventions", + "package-name": "@traceai/fi-semantic-conventions" + }, + "typescript/packages/traceai_anthropic": { + "release-type": "node", + "component": "npm-traceai-anthropic", + "package-name": "@traceai/anthropic" + }, + "typescript/packages/traceai_bedrock": { + "release-type": "node", + "component": "npm-traceai-bedrock", + "package-name": "@traceai/bedrock" + }, + "typescript/packages/traceai_beeai": { + "release-type": "node", + "component": "npm-traceai-beeai", + "package-name": "@traceai/beeai" + }, + "typescript/packages/traceai_cerebras": { + "release-type": "node", + "component": "npm-traceai-cerebras", + "package-name": "@traceai/cerebras" + }, + "typescript/packages/traceai_chromadb": { + "release-type": "node", + "component": "npm-traceai-chromadb", + "package-name": "@traceai/chromadb" + }, + "typescript/packages/traceai_claude_agent_sdk": { + "release-type": "node", + "component": "npm-traceai-claude-agent-sdk", + "package-name": "@traceai/claude-agent-sdk" + }, + "typescript/packages/traceai_codex_sdk": { + "release-type": "node", + "component": "npm-traceai-codex-sdk", + "package-name": "@traceai/codex-sdk" + }, + "typescript/packages/traceai_cohere": { + "release-type": "node", + "component": "npm-traceai-cohere", + "package-name": "@traceai/cohere" + }, + "typescript/packages/traceai_cursor_sdk": { + "release-type": "node", + "component": "npm-traceai-cursor-sdk", + "package-name": "@traceai/cursor-sdk" + }, + "typescript/packages/traceai_deepseek": { + "release-type": "node", + "component": "npm-traceai-deepseek", + "package-name": "@traceai/deepseek" + }, + "typescript/packages/traceai_fireworks": { + "release-type": "node", + "component": "npm-traceai-fireworks", + "package-name": "@traceai/fireworks" + }, + "typescript/packages/traceai_genkit": { + "release-type": "node", + "component": "npm-traceai-genkit", + "package-name": "@traceai/genkit" + }, + "typescript/packages/traceai_google_adk": { + "release-type": "node", + "component": "npm-traceai-fi-instrumentation-google-adk", + "package-name": "@traceai/fi-instrumentation-google-adk" + }, + "typescript/packages/traceai_google_genai": { + "release-type": "node", + "component": "npm-traceai-google-genai", + "package-name": "@traceai/google-genai" + }, + "typescript/packages/traceai_groq": { + "release-type": "node", + "component": "npm-traceai-groq", + "package-name": "@traceai/groq" + }, + "typescript/packages/traceai_guardrails": { + "release-type": "node", + "component": "npm-traceai-guardrails", + "package-name": "@traceai/guardrails" + }, + "typescript/packages/traceai_huggingface": { + "release-type": "node", + "component": "npm-traceai-huggingface", + "package-name": "@traceai/huggingface" + }, + "typescript/packages/traceai_instructor": { + "release-type": "node", + "component": "npm-traceai-instructor", + "package-name": "@traceai/instructor" + }, + "typescript/packages/traceai_lancedb": { + "release-type": "node", + "component": "npm-traceai-lancedb", + "package-name": "@traceai/lancedb" + }, + "typescript/packages/traceai_langchain": { + "release-type": "node", + "component": "npm-traceai-langchain", + "package-name": "@traceai/langchain" + }, + "typescript/packages/traceai_livekit": { + "release-type": "node", + "component": "npm-traceai-fi-instrumentation-livekit", + "package-name": "@traceai/fi-instrumentation-livekit" + }, + "typescript/packages/traceai_llamaindex": { + "release-type": "node", + "component": "npm-traceai-llamaindex", + "package-name": "@traceai/llamaindex" + }, + "typescript/packages/traceai_mastra": { + "release-type": "node", + "component": "npm-traceai-mastra", + "package-name": "@traceai/mastra" + }, + "typescript/packages/traceai_mcp": { + "release-type": "node", + "component": "npm-traceai-mcp", + "package-name": "@traceai/mcp" + }, + "typescript/packages/traceai_milvus": { + "release-type": "node", + "component": "npm-traceai-milvus", + "package-name": "@traceai/milvus" + }, + "typescript/packages/traceai_mistral": { + "release-type": "node", + "component": "npm-traceai-mistral", + "package-name": "@traceai/mistral" + }, + "typescript/packages/traceai_mongodb": { + "release-type": "node", + "component": "npm-traceai-mongodb", + "package-name": "@traceai/mongodb" + }, + "typescript/packages/traceai_ollama": { + "release-type": "node", + "component": "npm-traceai-ollama", + "package-name": "@traceai/ollama" + }, + "typescript/packages/traceai_openai": { + "release-type": "node", + "component": "npm-traceai-openai", + "package-name": "@traceai/openai" + }, + "typescript/packages/traceai_openai_agents": { + "release-type": "node", + "component": "npm-traceai-openai-agents", + "package-name": "@traceai/openai-agents" + }, + "typescript/packages/traceai_pgvector": { + "release-type": "node", + "component": "npm-traceai-pgvector", + "package-name": "@traceai/pgvector" + }, + "typescript/packages/traceai_pi_coding_agent": { + "release-type": "node", + "component": "npm-traceai-pi-coding-agent", + "package-name": "@traceai/pi-coding-agent" + }, + "typescript/packages/traceai_pinecone": { + "release-type": "node", + "component": "npm-traceai-pinecone", + "package-name": "@traceai/pinecone" + }, + "typescript/packages/traceai_pipecat": { + "release-type": "node", + "component": "npm-traceai-fi-instrumentation-pipecat", + "package-name": "@traceai/fi-instrumentation-pipecat" + }, + "typescript/packages/traceai_portkey": { + "release-type": "node", + "component": "npm-traceai-portkey", + "package-name": "@traceai/portkey" + }, + "typescript/packages/traceai_qdrant": { + "release-type": "node", + "component": "npm-traceai-qdrant", + "package-name": "@traceai/qdrant" + }, + "typescript/packages/traceai_redis": { + "release-type": "node", + "component": "npm-traceai-redis", + "package-name": "@traceai/redis" + }, + "typescript/packages/traceai_strands": { + "release-type": "node", + "component": "npm-traceai-strands", + "package-name": "@traceai/strands" + }, + "typescript/packages/traceai_together": { + "release-type": "node", + "component": "npm-traceai-together", + "package-name": "@traceai/together" + }, + "typescript/packages/traceai_vercel": { + "release-type": "node", + "component": "npm-traceai-vercel", + "package-name": "@traceai/vercel" + }, + "typescript/packages/traceai_vertexai": { + "release-type": "node", + "component": "npm-traceai-fi-instrumentation-vertexai", + "package-name": "@traceai/fi-instrumentation-vertexai" + }, + "typescript/packages/traceai_vllm": { + "release-type": "node", + "component": "npm-traceai-vllm", + "package-name": "@traceai/vllm" + }, + "typescript/packages/traceai_voltagent": { + "release-type": "node", + "component": "npm-traceai-voltagent", + "package-name": "@traceai/voltagent" + }, + "typescript/packages/traceai_weaviate": { + "release-type": "node", + "component": "npm-traceai-weaviate", + "package-name": "@traceai/weaviate" + }, + "typescript/packages/traceai_xai": { + "release-type": "node", + "component": "npm-traceai-xai", + "package-name": "@traceai/xai" + }, + "java": { + "release-type": "maven", + "component": "java", + "package-name": "com.futureagi:traceai-java-parent", + "skip-snapshot": true + }, + "go/a2a": { + "release-type": "go", + "component": "go/a2a", + "package-name": "github.com/future-agi/traceAI/go/a2a", + "tag-separator": "/", + "initial-version": "0.1.0" + }, + "go/anthropic": { + "release-type": "go", + "component": "go/anthropic", + "package-name": "github.com/future-agi/traceAI/go/anthropic", + "tag-separator": "/", + "initial-version": "0.1.0" + }, + "go/eino": { + "release-type": "go", + "component": "go/eino", + "package-name": "github.com/future-agi/traceAI/go/eino", + "tag-separator": "/", + "initial-version": "0.1.0" + }, + "go/genai": { + "release-type": "go", + "component": "go/genai", + "package-name": "github.com/future-agi/traceAI/go/genai", + "tag-separator": "/", + "initial-version": "0.1.0" + }, + "go/openai": { + "release-type": "go", + "component": "go/openai", + "package-name": "github.com/future-agi/traceAI/go/openai", + "tag-separator": "/", + "initial-version": "0.1.0" + }, + "csharp/src/FIInstrumentation": { + "release-type": "simple", + "component": "nuget-fi-instrumentation-otel", + "package-name": "fi-instrumentation-otel", + "extra-files": [ + { + "type": "xml", + "path": "FIInstrumentation.csproj", + "xpath": "/Project/PropertyGroup/Version" + } + ] + }, + "python/fi_instrumentation": { + "release-type": "python", + "component": "fi-instrumentation-otel", + "package-name": "fi-instrumentation-otel", + "extra-files": [ + { + "type": "toml", + "path": "/python/pyproject.toml", + "jsonpath": "$.tool.poetry.version" + }, + "instrumentation/version.py" + ], + "changelog-path": "/python/CHANGELOG.md" + } + } +} From e00b1252e3e7bfcacfea0a13ca5b8361438ce0c4 Mon Sep 17 00:00:00 2001 From: Nikhil Pareek <8347993+nik13@users.noreply.github.com> Date: Thu, 29 Oct 2026 06:51:58 -0700 Subject: [PATCH 04/11] fix(ci): pass signing key to Central BC signer Align the deployment environment with the actual release profile in #302; no local GnuPG keyring is needed. Co-Authored-By: Claude Code --- .github/workflows/release-java.yml | 3 +-- RELEASING.md | 2 +- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/.github/workflows/release-java.yml b/.github/workflows/release-java.yml index 349172047..8f47edf0f 100644 --- a/.github/workflows/release-java.yml +++ b/.github/workflows/release-java.yml @@ -41,8 +41,6 @@ jobs: server-id: central server-username: MAVEN_CENTRAL_USERNAME server-password: MAVEN_CENTRAL_PASSWORD - gpg-private-key: ${{ secrets.MAVEN_GPG_PRIVATE_KEY }} - gpg-passphrase: MAVEN_GPG_PASSPHRASE - name: Build and test all modules working-directory: java run: mvn -B -ntp verify @@ -52,6 +50,7 @@ jobs: env: MAVEN_CENTRAL_USERNAME: ${{ secrets.MAVEN_CENTRAL_USERNAME }} MAVEN_CENTRAL_PASSWORD: ${{ secrets.MAVEN_CENTRAL_PASSWORD }} + MAVEN_GPG_PRIVATE_KEY: ${{ secrets.MAVEN_GPG_PRIVATE_KEY }} MAVEN_GPG_PASSPHRASE: ${{ secrets.MAVEN_GPG_PASSPHRASE }} run: mvn -B -ntp -P release deploy - name: Verify every reactor artifact on Central diff --git a/RELEASING.md b/RELEASING.md index 756478290..f972785d0 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -69,7 +69,7 @@ Sources: [PyPI publisher setup](https://docs.pypi.org/trusted-publishers/adding- - [ ] Add a **DNS TXT record on the exact apex `futureagi.com`** (host `@`, depending on the DNS provider). Its value must be the **Verification Key generated by Central for this namespace request**; it is not a value this repository can pre-generate. Verify DNS propagation, then confirm namespace verification in Central. Do not use `traceai.ai`, `com.futureagi.com` or a `maven-central` subdomain. - [ ] Generate a Central Portal user token and add **`MAVEN_CENTRAL_USERNAME`** and **`MAVEN_CENTRAL_PASSWORD`** as repository secrets. These are the Portal token's username/password, not your interactive login password. - [ ] Create a release GPG signing key, publish its **public key** to a public keyserver accessible to Central, and verify the fingerprint. Export the **ASCII-armored private signing key** into **`MAVEN_GPG_PRIVATE_KEY`** and its passphrase into **`MAVEN_GPG_PASSPHRASE`**. Keep the private key out of git and command output. -- [ ] Merge the Java release-profile PR: groupId `com.futureagi`, unchanged artifactIds, sources/javadocs, signing, and `central-publishing-maven-plugin` server id **`central`**. setup-java provides credentials and imports the signing key. The publisher runs **`mvn -B -ntp -P release deploy` from `java/`**. +- [ ] Merge the Java release-profile PR: groupId `com.futureagi`, unchanged artifactIds, sources/javadocs, signing, and `central-publishing-maven-plugin` server id **`central`**. setup-java provides Central credentials; the release profile's BC signer reads the private key and passphrase directly from the deployment step's environment (no persistent GnuPG keyring). The publisher runs **`mvn -B -ntp -P release deploy` from `java/`**. - [ ] The planner skips a version only when **every reactor artifact** has its POM on Central. Central deployments are verified against canonical repository files, not the delayed search index. Check the Portal for a failed/incomplete deployment before retrying; do not replace immutable artifacts. Sources: [namespace verification](https://central.sonatype.org/register/namespace/) and [Central publishing Maven plugin](https://central.sonatype.org/publish/publish-portal-maven/). From 0a139428d589d3d5a2ebda0a250f1928efe4b9b8 Mon Sep 17 00:00:00 2001 From: Nikhil Pareek <8347993+nik13@users.noreply.github.com> Date: Thu, 29 Oct 2026 07:16:38 -0700 Subject: [PATCH 05/11] fix(ci): release already-merged SDK changes at bootstrap Audit all Python and npm manifests against registry upload timestamps and apply one-time patches to 38 packages whose same-version changes would otherwise be stranded. Keep metadata and dependency ranges unchanged, validate bootstrap version floors, and prove all Java reactor parents including the companion BOM bump together. Co-Authored-By: Claude Code --- .github/release/bootstrap-audit.json | 1731 +++++++++++++++++ .github/release/bootstrap_audit.py | 158 ++ .github/release/test_bootstrap_audit.py | 85 + .github/release/test_release_strategies.cjs | 20 +- .github/workflows/release.yml | 6 +- .release-please-manifest.json | 76 +- CONTRIBUTING.md | 4 +- RELEASING.md | 17 +- python/frameworks/anthropic/CHANGELOG.md | 7 + python/frameworks/anthropic/pyproject.toml | 2 +- .../anthropic/traceai_anthropic/version.py | 2 +- python/frameworks/bedrock/CHANGELOG.md | 7 + python/frameworks/bedrock/pyproject.toml | 2 +- .../bedrock/traceai_bedrock/version.py | 2 +- python/frameworks/cerebras/CHANGELOG.md | 7 + python/frameworks/cerebras/pyproject.toml | 2 +- .../cerebras/traceai_cerebras/version.py | 2 +- python/frameworks/chromadb/CHANGELOG.md | 5 + python/frameworks/chromadb/pyproject.toml | 2 +- .../chromadb/traceai_chromadb/version.py | 2 +- python/frameworks/cohere/CHANGELOG.md | 7 + python/frameworks/cohere/pyproject.toml | 2 +- .../cohere/traceai_cohere/version.py | 2 +- python/frameworks/deepseek/CHANGELOG.md | 7 + python/frameworks/deepseek/pyproject.toml | 2 +- .../deepseek/traceai_deepseek/version.py | 2 +- python/frameworks/dspy/CHANGELOG.md | 7 + python/frameworks/dspy/pyproject.toml | 2 +- .../frameworks/dspy/traceai_dspy/version.py | 2 +- python/frameworks/fireworks/CHANGELOG.md | 7 + python/frameworks/fireworks/pyproject.toml | 2 +- .../fireworks/traceai_fireworks/version.py | 2 +- python/frameworks/google-adk/CHANGELOG.md | 5 + python/frameworks/google-adk/pyproject.toml | 2 +- .../google-adk/traceai_google_adk/version.py | 2 +- python/frameworks/google-genai/CHANGELOG.md | 7 + python/frameworks/google-genai/pyproject.toml | 2 +- .../traceai_google_genai/version.py | 2 +- python/frameworks/groq/CHANGELOG.md | 7 + python/frameworks/groq/pyproject.toml | 2 +- .../frameworks/groq/traceai_groq/version.py | 2 +- python/frameworks/guardrails/CHANGELOG.md | 7 + python/frameworks/guardrails/pyproject.toml | 2 +- .../guardrails/traceai_guardrails/version.py | 2 +- python/frameworks/haystack/CHANGELOG.md | 7 + python/frameworks/haystack/pyproject.toml | 2 +- .../haystack/traceai_haystack/version.py | 2 +- python/frameworks/instructor/CHANGELOG.md | 7 + python/frameworks/instructor/pyproject.toml | 2 +- .../instructor/traceai_instructor/version.py | 2 +- python/frameworks/lancedb/CHANGELOG.md | 5 + python/frameworks/lancedb/pyproject.toml | 2 +- .../lancedb/traceai_lancedb/version.py | 2 +- python/frameworks/litellm/CHANGELOG.md | 7 + python/frameworks/litellm/pyproject.toml | 2 +- .../litellm/traceai_litellm/version.py | 2 +- python/frameworks/livekit/CHANGELOG.md | 7 + python/frameworks/livekit/pyproject.toml | 2 +- .../livekit/traceai_livekit/__init__.py | 2 +- python/frameworks/llama_index/CHANGELOG.md | 7 + python/frameworks/llama_index/pyproject.toml | 2 +- .../llama_index/traceai_llamaindex/version.py | 2 +- python/frameworks/mcp/CHANGELOG.md | 7 + python/frameworks/mcp/pyproject.toml | 2 +- python/frameworks/mcp/traceai_mcp/version.py | 2 +- python/frameworks/milvus/CHANGELOG.md | 5 + python/frameworks/milvus/pyproject.toml | 2 +- .../milvus/traceai_milvus/version.py | 2 +- python/frameworks/mistralai/CHANGELOG.md | 7 + python/frameworks/mistralai/pyproject.toml | 2 +- .../mistralai/traceai_mistralai/version.py | 2 +- python/frameworks/mongodb-vector/CHANGELOG.md | 5 + .../frameworks/mongodb-vector/pyproject.toml | 2 +- .../mongodb-vector/traceai_mongodb/version.py | 2 +- python/frameworks/openai-agents/CHANGELOG.md | 7 + .../frameworks/openai-agents/pyproject.toml | 2 +- .../traceai_openai_agents/version.py | 2 +- python/frameworks/openai/CHANGELOG.md | 2 +- python/frameworks/openai/pyproject.toml | 2 +- .../openai/traceai_openai/version.py | 2 +- python/frameworks/pgvector/CHANGELOG.md | 5 + python/frameworks/pgvector/pyproject.toml | 2 +- .../pgvector/traceai_pgvector/version.py | 2 +- python/frameworks/pinecone/CHANGELOG.md | 5 + python/frameworks/pinecone/pyproject.toml | 2 +- .../pinecone/traceai_pinecone/version.py | 2 +- python/frameworks/pipecat/CHANGELOG.md | 7 + python/frameworks/pipecat/pyproject.toml | 2 +- .../pipecat/traceai_pipecat/__init__.py | 2 +- .../pipecat/traceai_pipecat/version.py | 2 +- python/frameworks/portkey/CHANGELOG.md | 6 + python/frameworks/portkey/pyproject.toml | 2 +- .../portkey/traceai_portkey/version.py | 2 +- python/frameworks/qdrant/CHANGELOG.md | 5 + python/frameworks/qdrant/pyproject.toml | 2 +- .../qdrant/traceai_qdrant/version.py | 2 +- python/frameworks/redis-vector/CHANGELOG.md | 5 + python/frameworks/redis-vector/pyproject.toml | 2 +- .../redis-vector/traceai_redis/version.py | 2 +- python/frameworks/smolagents/CHANGELOG.md | 7 + python/frameworks/smolagents/pyproject.toml | 2 +- .../smolagents/traceai_smolagents/version.py | 2 +- python/frameworks/together/CHANGELOG.md | 7 + python/frameworks/together/pyproject.toml | 2 +- .../together/traceai_together/version.py | 2 +- python/frameworks/vertexai/CHANGELOG.md | 7 + python/frameworks/vertexai/pyproject.toml | 2 +- .../vertexai/traceai_vertexai/version.py | 2 +- python/frameworks/weaviate/CHANGELOG.md | 5 + python/frameworks/weaviate/pyproject.toml | 2 +- .../weaviate/traceai_weaviate/version.py | 2 +- python/frameworks/xai/CHANGELOG.md | 7 + python/frameworks/xai/pyproject.toml | 2 +- python/frameworks/xai/traceai_xai/version.py | 2 +- .../packages/traceai_llamaindex/CHANGELOG.md | 7 + .../packages/traceai_llamaindex/package.json | 2 +- typescript/packages/traceai_mcp/CHANGELOG.md | 7 + typescript/packages/traceai_mcp/package.json | 2 +- .../packages/traceai_vercel/CHANGELOG.md | 7 + .../packages/traceai_vercel/package.json | 2 +- 120 files changed, 2365 insertions(+), 120 deletions(-) create mode 100644 .github/release/bootstrap-audit.json create mode 100644 .github/release/bootstrap_audit.py create mode 100644 .github/release/test_bootstrap_audit.py create mode 100644 python/frameworks/cerebras/CHANGELOG.md create mode 100644 python/frameworks/cohere/CHANGELOG.md create mode 100644 python/frameworks/deepseek/CHANGELOG.md create mode 100644 python/frameworks/fireworks/CHANGELOG.md create mode 100644 python/frameworks/together/CHANGELOG.md create mode 100644 python/frameworks/xai/CHANGELOG.md create mode 100644 typescript/packages/traceai_mcp/CHANGELOG.md create mode 100644 typescript/packages/traceai_vercel/CHANGELOG.md diff --git a/.github/release/bootstrap-audit.json b/.github/release/bootstrap-audit.json new file mode 100644 index 000000000..451c73d65 --- /dev/null +++ b/.github/release/bootstrap-audit.json @@ -0,0 +1,1731 @@ +{ + "baseline": "35f2e3dc364676fa5bdab1e71ae500daf9efc00c", + "queried_at": "2026-10-29T14:05:42.114014+00:00", + "method": "First-parent package history after the last file upload of the baseline manifest version. Explicit one-time patch bumps; no historical replay.", + "summary": { + "python": { + "excluded": 2, + "unpublished_current_version": 25, + "unchanged_since_upload": 6, + "patch_required": 35 + }, + "typescript": { + "excluded": 0, + "unpublished_current_version": 12, + "unchanged_since_upload": 32, + "patch_required": 3 + } + }, + "packages": [ + { + "ecosystem": "python", + "name": "traceAI-a2a", + "version": "0.1.0", + "manifest": "python/frameworks/a2a/pyproject.toml", + "dir": "python/frameworks/a2a", + "release_path": "python/frameworks/a2a", + "registry_url": "https://pypi.org/pypi/traceAI-a2a/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-ag2-classic", + "version": "0.1.0", + "manifest": "python/frameworks/ag2-classic/pyproject.toml", + "dir": "python/frameworks/ag2-classic", + "release_path": "python/frameworks/ag2-classic", + "registry_url": "https://pypi.org/pypi/traceAI-ag2-classic/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-ag2", + "version": "0.1.0", + "manifest": "python/frameworks/ag2/pyproject.toml", + "dir": "python/frameworks/ag2", + "release_path": "python/frameworks/ag2", + "registry_url": "https://pypi.org/pypi/traceAI-ag2/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-agent-framework", + "version": "0.1.0", + "manifest": "python/frameworks/agent-framework/pyproject.toml", + "dir": "python/frameworks/agent-framework", + "release_path": "python/frameworks/agent-framework", + "registry_url": "https://pypi.org/pypi/traceAI-agent-framework/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceai-agno", + "version": "0.1.0", + "manifest": "python/frameworks/agno/pyproject.toml", + "dir": "python/frameworks/agno", + "release_path": "python/frameworks/agno", + "registry_url": "https://pypi.org/pypi/traceai-agno/json", + "uploaded_at": "2026-03-10T13:50:16.723296Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "python", + "name": "traceAI-anthropic", + "version": "0.1.10", + "manifest": "python/frameworks/anthropic/pyproject.toml", + "dir": "python/frameworks/anthropic", + "release_path": "python/frameworks/anthropic", + "registry_url": "https://pypi.org/pypi/traceAI-anthropic/json", + "uploaded_at": "2026-03-10T13:53:52.839714Z", + "status": "patch_required", + "next_version": "0.1.11", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-autogen", + "version": "0.2.1", + "manifest": "python/frameworks/autogen/pyproject.toml", + "dir": "python/frameworks/autogen", + "release_path": "python/frameworks/autogen", + "registry_url": "https://pypi.org/pypi/traceAI-autogen/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-bedrock", + "version": "0.1.10", + "manifest": "python/frameworks/bedrock/pyproject.toml", + "dir": "python/frameworks/bedrock", + "release_path": "python/frameworks/bedrock", + "registry_url": "https://pypi.org/pypi/traceAI-bedrock/json", + "uploaded_at": "2026-03-10T13:53:56.543348Z", + "status": "patch_required", + "next_version": "0.1.11", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceai-beeai", + "version": "0.1.0", + "manifest": "python/frameworks/beeai/pyproject.toml", + "dir": "python/frameworks/beeai", + "release_path": "python/frameworks/beeai", + "registry_url": "https://pypi.org/pypi/traceai-beeai/json", + "uploaded_at": "2026-03-10T13:50:28.296746Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "python", + "name": "traceAI-cerebras", + "version": "0.1.0", + "manifest": "python/frameworks/cerebras/pyproject.toml", + "dir": "python/frameworks/cerebras", + "release_path": "python/frameworks/cerebras", + "registry_url": "https://pypi.org/pypi/traceAI-cerebras/json", + "uploaded_at": "2026-03-10T13:50:34.107758Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-chromadb", + "version": "0.1.0", + "manifest": "python/frameworks/chromadb/pyproject.toml", + "dir": "python/frameworks/chromadb", + "release_path": "python/frameworks/chromadb", + "registry_url": "https://pypi.org/pypi/traceAI-chromadb/json", + "uploaded_at": "2026-03-10T13:50:37.415013Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceai-claude-agent-sdk", + "version": "0.1.1", + "manifest": "python/frameworks/claude-agent-sdk/pyproject.toml", + "dir": "python/frameworks/claude-agent-sdk", + "release_path": "python/frameworks/claude-agent-sdk", + "registry_url": "https://pypi.org/pypi/traceai-claude-agent-sdk/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-cohere", + "version": "0.1.0", + "manifest": "python/frameworks/cohere/pyproject.toml", + "dir": "python/frameworks/cohere", + "release_path": "python/frameworks/cohere", + "registry_url": "https://pypi.org/pypi/traceAI-cohere/json", + "uploaded_at": "2026-03-10T13:50:45.021586Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-crewai", + "version": "0.1.9", + "manifest": "python/frameworks/crewai/pyproject.toml", + "dir": "python/frameworks/crewai", + "release_path": "python/frameworks/crewai", + "registry_url": "https://pypi.org/pypi/traceAI-crewai/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-deepseek", + "version": "0.1.0", + "manifest": "python/frameworks/deepseek/pyproject.toml", + "dir": "python/frameworks/deepseek", + "release_path": "python/frameworks/deepseek", + "registry_url": "https://pypi.org/pypi/traceAI-deepseek/json", + "uploaded_at": "2026-03-10T13:50:51.178454Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-discoveryengine", + "version": "0.1.0", + "manifest": "python/frameworks/discoveryengine/pyproject.toml", + "dir": "python/frameworks/discoveryengine", + "release_path": "python/frameworks/discoveryengine", + "registry_url": "https://pypi.org/pypi/traceAI-discoveryengine/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-DSPy", + "version": "0.1.8", + "manifest": "python/frameworks/dspy/pyproject.toml", + "dir": "python/frameworks/dspy", + "release_path": "python/frameworks/dspy", + "registry_url": "https://pypi.org/pypi/traceAI-DSPy/json", + "uploaded_at": "2026-03-10T13:54:03.150970Z", + "status": "patch_required", + "next_version": "0.1.9", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-elevenlabs-agents", + "version": "0.1.0", + "manifest": "python/frameworks/elevenlabs-agents/pyproject.toml", + "dir": "python/frameworks/elevenlabs-agents", + "release_path": "python/frameworks/elevenlabs-agents", + "registry_url": "https://pypi.org/pypi/traceAI-elevenlabs-agents/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-exa", + "version": "0.1.0", + "manifest": "python/frameworks/exa/pyproject.toml", + "dir": "python/frameworks/exa", + "release_path": "python/frameworks/exa", + "registry_url": "https://pypi.org/pypi/traceAI-exa/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-firecrawl", + "version": "0.1.0", + "manifest": "python/frameworks/firecrawl/pyproject.toml", + "dir": "python/frameworks/firecrawl", + "release_path": "python/frameworks/firecrawl", + "registry_url": "https://pypi.org/pypi/traceAI-firecrawl/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-fireworks", + "version": "0.1.0", + "manifest": "python/frameworks/fireworks/pyproject.toml", + "dir": "python/frameworks/fireworks", + "release_path": "python/frameworks/fireworks", + "registry_url": "https://pypi.org/pypi/traceAI-fireworks/json", + "uploaded_at": "2026-03-10T13:50:56.768726Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-google-adk", + "version": "0.1.5", + "manifest": "python/frameworks/google-adk/pyproject.toml", + "dir": "python/frameworks/google-adk", + "release_path": "python/frameworks/google-adk", + "registry_url": "https://pypi.org/pypi/traceAI-google-adk/json", + "uploaded_at": "2026-05-15T11:42:17.239594Z", + "status": "patch_required", + "next_version": "0.1.6", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-google-genai-live", + "version": "0.1.0", + "manifest": "python/frameworks/google-genai-live/pyproject.toml", + "dir": "python/frameworks/google-genai-live", + "release_path": "python/frameworks/google-genai-live", + "registry_url": "https://pypi.org/pypi/traceAI-google-genai-live/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-google-genai", + "version": "0.1.2", + "manifest": "python/frameworks/google-genai/pyproject.toml", + "dir": "python/frameworks/google-genai", + "release_path": "python/frameworks/google-genai", + "registry_url": "https://pypi.org/pypi/traceAI-google-genai/json", + "uploaded_at": "2026-03-10T13:54:10.995231Z", + "status": "patch_required", + "next_version": "0.1.3", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-groq", + "version": "0.1.9", + "manifest": "python/frameworks/groq/pyproject.toml", + "dir": "python/frameworks/groq", + "release_path": "python/frameworks/groq", + "registry_url": "https://pypi.org/pypi/traceAI-groq/json", + "uploaded_at": "2026-03-10T13:54:14.486918Z", + "status": "patch_required", + "next_version": "0.1.10", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-guardrails", + "version": "0.2.0", + "manifest": "python/frameworks/guardrails/pyproject.toml", + "dir": "python/frameworks/guardrails", + "release_path": "python/frameworks/guardrails", + "registry_url": "https://pypi.org/pypi/traceAI-guardrails/json", + "uploaded_at": "2026-03-10T13:51:05.971848Z", + "status": "patch_required", + "next_version": "0.2.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-haystack", + "version": "0.1.9", + "manifest": "python/frameworks/haystack/pyproject.toml", + "dir": "python/frameworks/haystack", + "release_path": "python/frameworks/haystack", + "registry_url": "https://pypi.org/pypi/traceAI-haystack/json", + "uploaded_at": "2026-03-10T13:54:18.611982Z", + "status": "patch_required", + "next_version": "0.1.10", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "futureagi-hermes-plugin", + "version": "0.1.0", + "manifest": "python/frameworks/hermes-agent/hermes-plugin/futureagi/pyproject.toml", + "dir": "python/frameworks/hermes-agent/hermes-plugin/futureagi", + "release_path": "python/frameworks/hermes-agent/hermes-plugin/futureagi", + "status": "excluded", + "reason": "Hermes plugin dependency manifest, explicitly not a buildable distribution" + }, + { + "ecosystem": "python", + "name": "traceAI-hermes-agent", + "version": "0.1.0", + "manifest": "python/frameworks/hermes-agent/pyproject.toml", + "dir": "python/frameworks/hermes-agent", + "release_path": "python/frameworks/hermes-agent", + "registry_url": "https://pypi.org/pypi/traceAI-hermes-agent/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-huggingface", + "version": "0.1.0", + "manifest": "python/frameworks/huggingface/pyproject.toml", + "dir": "python/frameworks/huggingface", + "release_path": "python/frameworks/huggingface", + "registry_url": "https://pypi.org/pypi/traceAI-huggingface/json", + "uploaded_at": "2026-03-10T13:51:11.384477Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "python", + "name": "traceAI-instructor", + "version": "0.2.0", + "manifest": "python/frameworks/instructor/pyproject.toml", + "dir": "python/frameworks/instructor", + "release_path": "python/frameworks/instructor", + "registry_url": "https://pypi.org/pypi/traceAI-instructor/json", + "uploaded_at": "2026-03-10T13:51:15.272666Z", + "status": "patch_required", + "next_version": "0.2.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-lancedb", + "version": "0.1.0", + "manifest": "python/frameworks/lancedb/pyproject.toml", + "dir": "python/frameworks/lancedb", + "release_path": "python/frameworks/lancedb", + "registry_url": "https://pypi.org/pypi/traceAI-lancedb/json", + "uploaded_at": "2026-03-10T13:51:19.478967Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-langchain", + "version": "0.2.1", + "manifest": "python/frameworks/langchain/pyproject.toml", + "dir": "python/frameworks/langchain", + "release_path": "python/frameworks/langchain", + "registry_url": "https://pypi.org/pypi/traceAI-langchain/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-litellm", + "version": "0.1.10", + "manifest": "python/frameworks/litellm/pyproject.toml", + "dir": "python/frameworks/litellm", + "release_path": "python/frameworks/litellm", + "registry_url": "https://pypi.org/pypi/traceAI-litellm/json", + "uploaded_at": "2026-03-10T13:54:26.855364Z", + "status": "patch_required", + "next_version": "0.1.11", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-livekit", + "version": "0.1.2", + "manifest": "python/frameworks/livekit/pyproject.toml", + "dir": "python/frameworks/livekit", + "release_path": "python/frameworks/livekit", + "registry_url": "https://pypi.org/pypi/traceAI-livekit/json", + "uploaded_at": "2026-10-21T18:52:18.330496Z", + "status": "patch_required", + "next_version": "0.1.3", + "commits": [ + { + "sha": "fab1e035d404f20a88e0f0c103a4de91a759f321", + "committed_at": "2026-10-25T19:19:58-07:00", + "subject": "Merge pull request #281 from future-agi/fix/TH-8727-register-keeps-exporter" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-llamaindex", + "version": "0.1.9", + "manifest": "python/frameworks/llama_index/pyproject.toml", + "dir": "python/frameworks/llama_index", + "release_path": "python/frameworks/llama_index", + "registry_url": "https://pypi.org/pypi/traceAI-llamaindex/json", + "uploaded_at": "2026-03-10T13:54:30.775309Z", + "status": "patch_required", + "next_version": "0.1.10", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-mcp-use", + "version": "0.1.0", + "manifest": "python/frameworks/mcp-use/pyproject.toml", + "dir": "python/frameworks/mcp-use", + "release_path": "python/frameworks/mcp-use", + "registry_url": "https://pypi.org/pypi/traceAI-mcp-use/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-mcp", + "version": "0.1.2", + "manifest": "python/frameworks/mcp/pyproject.toml", + "dir": "python/frameworks/mcp", + "release_path": "python/frameworks/mcp", + "registry_url": "https://pypi.org/pypi/traceAI-mcp/json", + "uploaded_at": "2026-03-10T13:54:33.971105Z", + "status": "patch_required", + "next_version": "0.1.3", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-milvus", + "version": "0.1.0", + "manifest": "python/frameworks/milvus/pyproject.toml", + "dir": "python/frameworks/milvus", + "release_path": "python/frameworks/milvus", + "registry_url": "https://pypi.org/pypi/traceAI-milvus/json", + "uploaded_at": "2026-03-10T13:51:32.184959Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-minimax", + "version": "0.1.0", + "manifest": "python/frameworks/minimax/pyproject.toml", + "dir": "python/frameworks/minimax", + "release_path": "python/frameworks/minimax", + "registry_url": "https://pypi.org/pypi/traceAI-minimax/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-mistralai", + "version": "0.1.8", + "manifest": "python/frameworks/mistralai/pyproject.toml", + "dir": "python/frameworks/mistralai", + "release_path": "python/frameworks/mistralai", + "registry_url": "https://pypi.org/pypi/traceAI-mistralai/json", + "uploaded_at": "2026-03-10T13:54:37.381487Z", + "status": "patch_required", + "next_version": "0.1.9", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-mongodb", + "version": "0.1.0", + "manifest": "python/frameworks/mongodb-vector/pyproject.toml", + "dir": "python/frameworks/mongodb-vector", + "release_path": "python/frameworks/mongodb-vector", + "registry_url": "https://pypi.org/pypi/traceAI-mongodb/json", + "uploaded_at": "2026-03-10T13:51:37.021751Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-ollama", + "version": "0.1.0", + "manifest": "python/frameworks/ollama/pyproject.toml", + "dir": "python/frameworks/ollama", + "release_path": "python/frameworks/ollama", + "registry_url": "https://pypi.org/pypi/traceAI-ollama/json", + "uploaded_at": "2026-03-10T13:51:40.900357Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "python", + "name": "traceAI-openai-agents", + "version": "0.1.6", + "manifest": "python/frameworks/openai-agents/pyproject.toml", + "dir": "python/frameworks/openai-agents", + "release_path": "python/frameworks/openai-agents", + "registry_url": "https://pypi.org/pypi/traceAI-openai-agents/json", + "uploaded_at": "2026-03-10T13:54:45.128958Z", + "status": "patch_required", + "next_version": "0.1.7", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-openai-realtime", + "version": "0.1.0", + "manifest": "python/frameworks/openai-realtime/pyproject.toml", + "dir": "python/frameworks/openai-realtime", + "release_path": "python/frameworks/openai-realtime", + "registry_url": "https://pypi.org/pypi/traceAI-openai-realtime/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-openai", + "version": "0.1.10", + "manifest": "python/frameworks/openai/pyproject.toml", + "dir": "python/frameworks/openai", + "release_path": "python/frameworks/openai", + "registry_url": "https://pypi.org/pypi/traceAI-openai/json", + "uploaded_at": "2026-03-10T13:54:41.234960Z", + "status": "patch_required", + "next_version": "0.1.11", + "commits": [ + { + "sha": "b79e0dbd1e7b9cdc5bbe01ed62251ef74dd630a3", + "committed_at": "2026-10-27T22:09:34-07:00", + "subject": "Merge pull request #249 from future-agi/fix/th-8402-openai-compatible-provider-model" + }, + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-parallel", + "version": "0.1.0", + "manifest": "python/frameworks/parallel/pyproject.toml", + "dir": "python/frameworks/parallel", + "release_path": "python/frameworks/parallel", + "registry_url": "https://pypi.org/pypi/traceAI-parallel/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-pgvector", + "version": "0.1.0", + "manifest": "python/frameworks/pgvector/pyproject.toml", + "dir": "python/frameworks/pgvector", + "release_path": "python/frameworks/pgvector", + "registry_url": "https://pypi.org/pypi/traceAI-pgvector/json", + "uploaded_at": "2026-03-10T13:51:48.045381Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-pinecone", + "version": "0.1.0", + "manifest": "python/frameworks/pinecone/pyproject.toml", + "dir": "python/frameworks/pinecone", + "release_path": "python/frameworks/pinecone", + "registry_url": "https://pypi.org/pypi/traceAI-pinecone/json", + "uploaded_at": "2026-03-10T13:51:52.262637Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-pipecat", + "version": "0.1.1", + "manifest": "python/frameworks/pipecat/pyproject.toml", + "dir": "python/frameworks/pipecat", + "release_path": "python/frameworks/pipecat", + "registry_url": "https://pypi.org/pypi/traceAI-pipecat/json", + "uploaded_at": "2026-03-10T13:54:48.532098Z", + "status": "patch_required", + "next_version": "0.1.2", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-portkey", + "version": "0.1.2", + "manifest": "python/frameworks/portkey/pyproject.toml", + "dir": "python/frameworks/portkey", + "release_path": "python/frameworks/portkey", + "registry_url": "https://pypi.org/pypi/traceAI-portkey/json", + "uploaded_at": "2026-03-10T13:54:51.994641Z", + "status": "patch_required", + "next_version": "0.1.3", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceai-pydantic-ai", + "version": "0.1.0", + "manifest": "python/frameworks/pydantic-ai/pyproject.toml", + "dir": "python/frameworks/pydantic-ai", + "release_path": "python/frameworks/pydantic-ai", + "registry_url": "https://pypi.org/pypi/traceai-pydantic-ai/json", + "uploaded_at": "2026-03-10T13:51:59.642183Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "python", + "name": "traceAI-qdrant", + "version": "0.1.0", + "manifest": "python/frameworks/qdrant/pyproject.toml", + "dir": "python/frameworks/qdrant", + "release_path": "python/frameworks/qdrant", + "registry_url": "https://pypi.org/pypi/traceAI-qdrant/json", + "uploaded_at": "2026-03-10T13:52:03.434056Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-redis", + "version": "0.1.0", + "manifest": "python/frameworks/redis-vector/pyproject.toml", + "dir": "python/frameworks/redis-vector", + "release_path": "python/frameworks/redis-vector", + "registry_url": "https://pypi.org/pypi/traceAI-redis/json", + "uploaded_at": "2026-03-10T13:52:06.450780Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-replicate", + "version": "0.1.0", + "manifest": "python/frameworks/replicate/pyproject.toml", + "dir": "python/frameworks/replicate", + "release_path": "python/frameworks/replicate", + "registry_url": "https://pypi.org/pypi/traceAI-replicate/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-semantic-kernel", + "version": "0.1.0", + "manifest": "python/frameworks/semantic-kernel/pyproject.toml", + "dir": "python/frameworks/semantic-kernel", + "release_path": "python/frameworks/semantic-kernel", + "registry_url": "https://pypi.org/pypi/traceAI-semantic-kernel/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-smolagents", + "version": "0.1.5", + "manifest": "python/frameworks/smolagents/pyproject.toml", + "dir": "python/frameworks/smolagents", + "release_path": "python/frameworks/smolagents", + "registry_url": "https://pypi.org/pypi/traceAI-smolagents/json", + "uploaded_at": "2026-03-10T13:54:55.357292Z", + "status": "patch_required", + "next_version": "0.1.6", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceai-strands", + "version": "0.1.1", + "manifest": "python/frameworks/strands/pyproject.toml", + "dir": "python/frameworks/strands", + "release_path": "python/frameworks/strands", + "registry_url": "https://pypi.org/pypi/traceai-strands/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-tavily", + "version": "0.1.0", + "manifest": "python/frameworks/tavily/pyproject.toml", + "dir": "python/frameworks/tavily", + "release_path": "python/frameworks/tavily", + "registry_url": "https://pypi.org/pypi/traceAI-tavily/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-together", + "version": "0.1.0", + "manifest": "python/frameworks/together/pyproject.toml", + "dir": "python/frameworks/together", + "release_path": "python/frameworks/together", + "registry_url": "https://pypi.org/pypi/traceAI-together/json", + "uploaded_at": "2026-03-10T13:52:15.837870Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-typesafe", + "version": "0.1.0", + "manifest": "python/frameworks/typesafe/pyproject.toml", + "dir": "python/frameworks/typesafe", + "release_path": "python/frameworks/typesafe", + "registry_url": "https://pypi.org/pypi/traceAI-typesafe/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-vertexai", + "version": "0.1.10", + "manifest": "python/frameworks/vertexai/pyproject.toml", + "dir": "python/frameworks/vertexai", + "release_path": "python/frameworks/vertexai", + "registry_url": "https://pypi.org/pypi/traceAI-vertexai/json", + "uploaded_at": "2026-03-10T13:54:59.021874Z", + "status": "patch_required", + "next_version": "0.1.11", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + }, + { + "sha": "0b0224e21d0e2c45cd878a159fcb0e5a9f3e18f3", + "committed_at": "2026-03-10T19:54:28+05:30", + "subject": "Merge pull request #136 from future-agi/version/bump-framework-versions" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-vllm", + "version": "0.1.0", + "manifest": "python/frameworks/vllm/pyproject.toml", + "dir": "python/frameworks/vllm", + "release_path": "python/frameworks/vllm", + "registry_url": "https://pypi.org/pypi/traceAI-vllm/json", + "uploaded_at": "2026-03-11T08:07:15.657034Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "python", + "name": "traceAI-voyage", + "version": "0.1.0", + "manifest": "python/frameworks/voyage/pyproject.toml", + "dir": "python/frameworks/voyage", + "release_path": "python/frameworks/voyage", + "registry_url": "https://pypi.org/pypi/traceAI-voyage/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceAI-weaviate", + "version": "0.1.0", + "manifest": "python/frameworks/weaviate/pyproject.toml", + "dir": "python/frameworks/weaviate", + "release_path": "python/frameworks/weaviate", + "registry_url": "https://pypi.org/pypi/traceAI-weaviate/json", + "uploaded_at": "2026-03-11T08:07:20.065220Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "traceAI-xai", + "version": "0.1.0", + "manifest": "python/frameworks/xai/pyproject.toml", + "dir": "python/frameworks/xai", + "release_path": "python/frameworks/xai", + "registry_url": "https://pypi.org/pypi/traceAI-xai/json", + "uploaded_at": "2026-03-11T08:07:23.434082Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "43d87a74df840d3c711230b4a749f4a9c607e51b", + "committed_at": "2026-10-19T22:37:02+05:30", + "subject": "Merge pull request #277 from future-agi/main" + } + ] + }, + { + "ecosystem": "python", + "name": "fi-instrumentation-otel", + "version": "1.2.1", + "manifest": "python/pyproject.toml", + "dir": "python", + "release_path": "python/fi_instrumentation", + "registry_url": "https://pypi.org/pypi/fi-instrumentation-otel/json", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "python", + "name": "traceai", + "version": "0.1.0", + "manifest": "python/traceai/pyproject.toml", + "dir": "python/traceai", + "release_path": "python/traceai", + "status": "excluded", + "reason": "the PyPI name traceai belongs to another publisher; the package has no registry name yet" + }, + { + "ecosystem": "typescript", + "name": "@traceai/fi-core", + "version": "1.1.0", + "manifest": "typescript/packages/fi-core/package.json", + "dir": "typescript/packages/fi-core", + "release_path": "typescript/packages/fi-core", + "registry_url": "https://registry.npmjs.org/@traceai%2Ffi-core", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/fi-semantic-conventions", + "version": "1.0.0", + "manifest": "typescript/packages/fi-semantic-conventions/package.json", + "dir": "typescript/packages/fi-semantic-conventions", + "release_path": "typescript/packages/fi-semantic-conventions", + "registry_url": "https://registry.npmjs.org/@traceai%2Ffi-semantic-conventions", + "uploaded_at": "2026-03-10T14:06:26.792Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/anthropic", + "version": "0.1.3", + "manifest": "typescript/packages/traceai_anthropic/package.json", + "dir": "typescript/packages/traceai_anthropic", + "release_path": "typescript/packages/traceai_anthropic", + "registry_url": "https://registry.npmjs.org/@traceai%2Fanthropic", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/bedrock", + "version": "0.1.1", + "manifest": "typescript/packages/traceai_bedrock/package.json", + "dir": "typescript/packages/traceai_bedrock", + "release_path": "typescript/packages/traceai_bedrock", + "registry_url": "https://registry.npmjs.org/@traceai%2Fbedrock", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/beeai", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_beeai/package.json", + "dir": "typescript/packages/traceai_beeai", + "release_path": "typescript/packages/traceai_beeai", + "registry_url": "https://registry.npmjs.org/@traceai%2Fbeeai", + "uploaded_at": "2026-03-10T14:06:35.929Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/cerebras", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_cerebras/package.json", + "dir": "typescript/packages/traceai_cerebras", + "release_path": "typescript/packages/traceai_cerebras", + "registry_url": "https://registry.npmjs.org/@traceai%2Fcerebras", + "uploaded_at": "2026-03-10T14:06:37.965Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/chromadb", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_chromadb/package.json", + "dir": "typescript/packages/traceai_chromadb", + "release_path": "typescript/packages/traceai_chromadb", + "registry_url": "https://registry.npmjs.org/@traceai%2Fchromadb", + "uploaded_at": "2026-03-10T14:06:41.696Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/claude-agent-sdk", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_claude_agent_sdk/package.json", + "dir": "typescript/packages/traceai_claude_agent_sdk", + "release_path": "typescript/packages/traceai_claude_agent_sdk", + "registry_url": "https://registry.npmjs.org/@traceai%2Fclaude-agent-sdk", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/codex-sdk", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_codex_sdk/package.json", + "dir": "typescript/packages/traceai_codex_sdk", + "release_path": "typescript/packages/traceai_codex_sdk", + "registry_url": "https://registry.npmjs.org/@traceai%2Fcodex-sdk", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/cohere", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_cohere/package.json", + "dir": "typescript/packages/traceai_cohere", + "release_path": "typescript/packages/traceai_cohere", + "registry_url": "https://registry.npmjs.org/@traceai%2Fcohere", + "uploaded_at": "2026-03-10T14:06:46.183Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/cursor-sdk", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_cursor_sdk/package.json", + "dir": "typescript/packages/traceai_cursor_sdk", + "release_path": "typescript/packages/traceai_cursor_sdk", + "registry_url": "https://registry.npmjs.org/@traceai%2Fcursor-sdk", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/deepseek", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_deepseek/package.json", + "dir": "typescript/packages/traceai_deepseek", + "release_path": "typescript/packages/traceai_deepseek", + "registry_url": "https://registry.npmjs.org/@traceai%2Fdeepseek", + "uploaded_at": "2026-03-10T14:06:48.171Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/fireworks", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_fireworks/package.json", + "dir": "typescript/packages/traceai_fireworks", + "release_path": "typescript/packages/traceai_fireworks", + "registry_url": "https://registry.npmjs.org/@traceai%2Ffireworks", + "uploaded_at": "2026-03-10T14:06:50.191Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/genkit", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_genkit/package.json", + "dir": "typescript/packages/traceai_genkit", + "release_path": "typescript/packages/traceai_genkit", + "registry_url": "https://registry.npmjs.org/@traceai%2Fgenkit", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/fi-instrumentation-google-adk", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_google_adk/package.json", + "dir": "typescript/packages/traceai_google_adk", + "release_path": "typescript/packages/traceai_google_adk", + "registry_url": "https://registry.npmjs.org/@traceai%2Ffi-instrumentation-google-adk", + "uploaded_at": "2026-03-10T14:06:55.963Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/google-genai", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_google_genai/package.json", + "dir": "typescript/packages/traceai_google_genai", + "release_path": "typescript/packages/traceai_google_genai", + "registry_url": "https://registry.npmjs.org/@traceai%2Fgoogle-genai", + "uploaded_at": "2026-03-10T14:07:01.753Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/groq", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_groq/package.json", + "dir": "typescript/packages/traceai_groq", + "release_path": "typescript/packages/traceai_groq", + "registry_url": "https://registry.npmjs.org/@traceai%2Fgroq", + "uploaded_at": "2026-03-10T14:07:06.153Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/guardrails", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_guardrails/package.json", + "dir": "typescript/packages/traceai_guardrails", + "release_path": "typescript/packages/traceai_guardrails", + "registry_url": "https://registry.npmjs.org/@traceai%2Fguardrails", + "uploaded_at": "2026-03-10T14:07:10.582Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/huggingface", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_huggingface/package.json", + "dir": "typescript/packages/traceai_huggingface", + "release_path": "typescript/packages/traceai_huggingface", + "registry_url": "https://registry.npmjs.org/@traceai%2Fhuggingface", + "uploaded_at": "2026-03-10T14:07:12.927Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/instructor", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_instructor/package.json", + "dir": "typescript/packages/traceai_instructor", + "release_path": "typescript/packages/traceai_instructor", + "registry_url": "https://registry.npmjs.org/@traceai%2Finstructor", + "uploaded_at": "2026-03-10T14:07:16.689Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/lancedb", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_lancedb/package.json", + "dir": "typescript/packages/traceai_lancedb", + "release_path": "typescript/packages/traceai_lancedb", + "registry_url": "https://registry.npmjs.org/@traceai%2Flancedb", + "uploaded_at": "2026-03-10T14:07:18.813Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/langchain", + "version": "0.1.3", + "manifest": "typescript/packages/traceai_langchain/package.json", + "dir": "typescript/packages/traceai_langchain", + "release_path": "typescript/packages/traceai_langchain", + "registry_url": "https://registry.npmjs.org/@traceai%2Flangchain", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/fi-instrumentation-livekit", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_livekit/package.json", + "dir": "typescript/packages/traceai_livekit", + "release_path": "typescript/packages/traceai_livekit", + "registry_url": "https://registry.npmjs.org/@traceai%2Ffi-instrumentation-livekit", + "uploaded_at": "2026-03-10T14:07:24.079Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/llamaindex", + "version": "0.1.1", + "manifest": "typescript/packages/traceai_llamaindex/package.json", + "dir": "typescript/packages/traceai_llamaindex", + "release_path": "typescript/packages/traceai_llamaindex", + "registry_url": "https://registry.npmjs.org/@traceai%2Fllamaindex", + "uploaded_at": "2025-08-28T10:04:10.503Z", + "status": "patch_required", + "next_version": "0.1.2", + "commits": [ + { + "sha": "2cecd1b4f7f6dd70444fd1ad81f030f6a8678725", + "committed_at": "2026-03-03T12:21:33+05:30", + "subject": "Merge pull request #133 from future-agi/fix/e2e-tests" + }, + { + "sha": "916e92b714c2819e033c4951731c3c44fe936a61", + "committed_at": "2026-02-24T12:54:56+05:30", + "subject": "Merge pull request #127 from future-agi/stack/1-csharp" + } + ] + }, + { + "ecosystem": "typescript", + "name": "@traceai/mastra", + "version": "0.2.0", + "manifest": "typescript/packages/traceai_mastra/package.json", + "dir": "typescript/packages/traceai_mastra", + "release_path": "typescript/packages/traceai_mastra", + "registry_url": "https://registry.npmjs.org/@traceai%2Fmastra", + "uploaded_at": "2026-06-03T19:13:50.554Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/mcp", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_mcp/package.json", + "dir": "typescript/packages/traceai_mcp", + "release_path": "typescript/packages/traceai_mcp", + "registry_url": "https://registry.npmjs.org/@traceai%2Fmcp", + "uploaded_at": "2025-08-20T16:01:00.841Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "2cecd1b4f7f6dd70444fd1ad81f030f6a8678725", + "committed_at": "2026-03-03T12:21:33+05:30", + "subject": "Merge pull request #133 from future-agi/fix/e2e-tests" + }, + { + "sha": "916e92b714c2819e033c4951731c3c44fe936a61", + "committed_at": "2026-02-24T12:54:56+05:30", + "subject": "Merge pull request #127 from future-agi/stack/1-csharp" + }, + { + "sha": "4fa8e96f564fd4823e92c566e6efb2c476501917", + "committed_at": "2025-08-20T23:45:54+05:30", + "subject": "Merge pull request #105 from future-agi/bug/version-fix" + } + ] + }, + { + "ecosystem": "typescript", + "name": "@traceai/milvus", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_milvus/package.json", + "dir": "typescript/packages/traceai_milvus", + "release_path": "typescript/packages/traceai_milvus", + "registry_url": "https://registry.npmjs.org/@traceai%2Fmilvus", + "uploaded_at": "2026-03-10T14:07:26.128Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/mistral", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_mistral/package.json", + "dir": "typescript/packages/traceai_mistral", + "release_path": "typescript/packages/traceai_mistral", + "registry_url": "https://registry.npmjs.org/@traceai%2Fmistral", + "uploaded_at": "2026-03-10T14:07:30.598Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/mongodb", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_mongodb/package.json", + "dir": "typescript/packages/traceai_mongodb", + "release_path": "typescript/packages/traceai_mongodb", + "registry_url": "https://registry.npmjs.org/@traceai%2Fmongodb", + "uploaded_at": "2026-03-10T14:07:32.906Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/ollama", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_ollama/package.json", + "dir": "typescript/packages/traceai_ollama", + "release_path": "typescript/packages/traceai_ollama", + "registry_url": "https://registry.npmjs.org/@traceai%2Follama", + "uploaded_at": "2026-03-10T14:07:34.918Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/openai", + "version": "0.1.14", + "manifest": "typescript/packages/traceai_openai/package.json", + "dir": "typescript/packages/traceai_openai", + "release_path": "typescript/packages/traceai_openai", + "registry_url": "https://registry.npmjs.org/@traceai%2Fopenai", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/openai-agents", + "version": "0.2.1", + "manifest": "typescript/packages/traceai_openai_agents/package.json", + "dir": "typescript/packages/traceai_openai_agents", + "release_path": "typescript/packages/traceai_openai_agents", + "registry_url": "https://registry.npmjs.org/@traceai%2Fopenai-agents", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/pgvector", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_pgvector/package.json", + "dir": "typescript/packages/traceai_pgvector", + "release_path": "typescript/packages/traceai_pgvector", + "registry_url": "https://registry.npmjs.org/@traceai%2Fpgvector", + "uploaded_at": "2026-03-10T14:07:41.410Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/pi-coding-agent", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_pi_coding_agent/package.json", + "dir": "typescript/packages/traceai_pi_coding_agent", + "release_path": "typescript/packages/traceai_pi_coding_agent", + "registry_url": "https://registry.npmjs.org/@traceai%2Fpi-coding-agent", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/pinecone", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_pinecone/package.json", + "dir": "typescript/packages/traceai_pinecone", + "release_path": "typescript/packages/traceai_pinecone", + "registry_url": "https://registry.npmjs.org/@traceai%2Fpinecone", + "uploaded_at": "2026-03-10T14:07:45.506Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/fi-instrumentation-pipecat", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_pipecat/package.json", + "dir": "typescript/packages/traceai_pipecat", + "release_path": "typescript/packages/traceai_pipecat", + "registry_url": "https://registry.npmjs.org/@traceai%2Ffi-instrumentation-pipecat", + "uploaded_at": "2026-03-10T14:07:49.926Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/portkey", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_portkey/package.json", + "dir": "typescript/packages/traceai_portkey", + "release_path": "typescript/packages/traceai_portkey", + "registry_url": "https://registry.npmjs.org/@traceai%2Fportkey", + "uploaded_at": "2026-03-10T14:07:54.357Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/qdrant", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_qdrant/package.json", + "dir": "typescript/packages/traceai_qdrant", + "release_path": "typescript/packages/traceai_qdrant", + "registry_url": "https://registry.npmjs.org/@traceai%2Fqdrant", + "uploaded_at": "2026-03-10T14:07:57.908Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/redis", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_redis/package.json", + "dir": "typescript/packages/traceai_redis", + "release_path": "typescript/packages/traceai_redis", + "registry_url": "https://registry.npmjs.org/@traceai%2Fredis", + "uploaded_at": "2026-03-10T14:08:00.127Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/strands", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_strands/package.json", + "dir": "typescript/packages/traceai_strands", + "release_path": "typescript/packages/traceai_strands", + "registry_url": "https://registry.npmjs.org/@traceai%2Fstrands", + "uploaded_at": "2026-03-10T14:08:04.160Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/together", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_together/package.json", + "dir": "typescript/packages/traceai_together", + "release_path": "typescript/packages/traceai_together", + "registry_url": "https://registry.npmjs.org/@traceai%2Ftogether", + "uploaded_at": "2026-03-10T14:08:06.485Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/vercel", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_vercel/package.json", + "dir": "typescript/packages/traceai_vercel", + "release_path": "typescript/packages/traceai_vercel", + "registry_url": "https://registry.npmjs.org/@traceai%2Fvercel", + "uploaded_at": "2025-07-21T12:24:07.669Z", + "status": "patch_required", + "next_version": "0.1.1", + "commits": [ + { + "sha": "2cecd1b4f7f6dd70444fd1ad81f030f6a8678725", + "committed_at": "2026-03-03T12:21:33+05:30", + "subject": "Merge pull request #133 from future-agi/fix/e2e-tests" + }, + { + "sha": "916e92b714c2819e033c4951731c3c44fe936a61", + "committed_at": "2026-02-24T12:54:56+05:30", + "subject": "Merge pull request #127 from future-agi/stack/1-csharp" + } + ] + }, + { + "ecosystem": "typescript", + "name": "@traceai/fi-instrumentation-vertexai", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_vertexai/package.json", + "dir": "typescript/packages/traceai_vertexai", + "release_path": "typescript/packages/traceai_vertexai", + "registry_url": "https://registry.npmjs.org/@traceai%2Ffi-instrumentation-vertexai", + "uploaded_at": "2026-03-10T14:08:10.945Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/vllm", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_vllm/package.json", + "dir": "typescript/packages/traceai_vllm", + "release_path": "typescript/packages/traceai_vllm", + "registry_url": "https://registry.npmjs.org/@traceai%2Fvllm", + "uploaded_at": "2026-03-10T14:08:12.880Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/voltagent", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_voltagent/package.json", + "dir": "typescript/packages/traceai_voltagent", + "release_path": "typescript/packages/traceai_voltagent", + "registry_url": "https://registry.npmjs.org/@traceai%2Fvoltagent", + "uploaded_at": null, + "status": "unpublished_current_version" + }, + { + "ecosystem": "typescript", + "name": "@traceai/weaviate", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_weaviate/package.json", + "dir": "typescript/packages/traceai_weaviate", + "release_path": "typescript/packages/traceai_weaviate", + "registry_url": "https://registry.npmjs.org/@traceai%2Fweaviate", + "uploaded_at": "2026-03-10T14:08:15.065Z", + "status": "unchanged_since_upload", + "commits": [] + }, + { + "ecosystem": "typescript", + "name": "@traceai/xai", + "version": "0.1.0", + "manifest": "typescript/packages/traceai_xai/package.json", + "dir": "typescript/packages/traceai_xai", + "release_path": "typescript/packages/traceai_xai", + "registry_url": "https://registry.npmjs.org/@traceai%2Fxai", + "uploaded_at": "2026-03-10T14:08:16.928Z", + "status": "unchanged_since_upload", + "commits": [] + } + ] +} diff --git a/.github/release/bootstrap_audit.py b/.github/release/bootstrap_audit.py new file mode 100644 index 000000000..b14e7501b --- /dev/null +++ b/.github/release/bootstrap_audit.py @@ -0,0 +1,158 @@ +#!/usr/bin/env python3 +"""Read-only, reproducible audit of same-version code stranded at bootstrap. + +Read package manifests from --ref, query public registry upload timestamps, then +inspect first-parent package history after that timestamp. No package code runs. +--check validates the committed one-time bumps without querying a registry. +""" +from __future__ import annotations + +import argparse +from concurrent.futures import ThreadPoolExecutor +from datetime import datetime, timezone +import json +from pathlib import Path +import re +import subprocess +import tomllib + +from release_plan import REPO_ROOT, _get_json, load_config + +BASELINE = "35f2e3dc364676fa5bdab1e71ae500daf9efc00c" +AUDIT = Path(__file__).with_name("bootstrap-audit.json") + + +def git(root: Path, *args: str) -> str: + return subprocess.check_output(["git", "-C", str(root), *args], text=True) + + +def manifests(root: Path, ref: str) -> list[dict]: + out = [] + for file in git(root, "ls-tree", "-r", "--name-only", ref).splitlines(): + if file.startswith("python/") and file.endswith("/pyproject.toml"): + data = tomllib.loads(git(root, "show", f"{ref}:{file}")) + pkg = data.get("project", data.get("tool", {}).get("poetry", {})) + ecosystem = "python" + elif re.fullmatch(r"typescript/packages/[^/]+/package.json", file): + pkg = json.loads(git(root, "show", f"{ref}:{file}")) + ecosystem = "typescript" + else: + continue + if pkg.get("private") or not pkg.get("name") or not pkg.get("version"): + continue + directory = str(Path(file).parent) + out.append({"ecosystem": ecosystem, "name": pkg["name"], + "version": pkg["version"], "manifest": file, "dir": directory, + "release_path": "python/fi_instrumentation" if directory == "python" else directory}) + return out + + +def upload_time(package: dict, registry: dict | None) -> str | None: + if registry is None: + return None + version = package["version"] + if package["ecosystem"] == "python": + files = registry.get("releases", {}).get(version, []) + # Empty release entries are not downloadable versions. Use the LAST file + # upload so a wheel/sdist uploaded seconds apart is treated as one release. + return max((f["upload_time_iso_8601"] for f in files), default=None) + return registry.get("time", {}).get(version) if version in registry.get("versions", {}) else None + + +def patch_version(version: str, existing: set[str]) -> str: + match = re.fullmatch(r"(\d+)\.(\d+)\.(\d+)", version) + if not match: + raise ValueError(f"Bootstrap requires a stable semantic version: {version}") + major, minor, patch = map(int, match.groups()) + # Never suggest re-uploading a version, even if a registry is ahead of dev. + patches = [int(m.group(1)) for v in existing + if (m := re.fullmatch(rf"{major}\.{minor}\.(\d+)", v))] + return f"{major}.{minor}.{max([patch, *patches]) + 1}" + + +def package_history(root: Path, ref: str, package: dict, since: str) -> list[dict]: + directory = package["dir"] + paths = [directory] + if directory == "python": + # Core doesn't own sibling SDKs. Retain its own source, tests, examples, + # pyproject/lockfile and docs, rather than attributing every SDK to core. + paths += [":(exclude)python/frameworks", ":(exclude)python/traceai"] + text = git(root, "log", "--first-parent", f"--since-as-filter={since}", + "--format=%H%x09%cI%x09%s", ref, "--", *paths) + return [dict(zip(("sha", "committed_at", "subject"), line.split("\t", 2))) + for line in text.splitlines()] + + +def audit_package(root: Path, ref: str, package: dict, skipped: dict) -> dict: + if package["name"] in skipped: + return {**package, "status": "excluded", "reason": skipped[package["name"]]} + if package["ecosystem"] == "python": + url = f"https://pypi.org/pypi/{package['name']}/json" + else: + url = "https://registry.npmjs.org/" + package["name"].replace("/", "%2F") + registry = _get_json(url) + uploaded = upload_time(package, registry) + result = {**package, "registry_url": url, "uploaded_at": uploaded} + if not uploaded: + return {**result, "status": "unpublished_current_version"} + history = package_history(root, ref, package, uploaded) + if not history: + return {**result, "status": "unchanged_since_upload", "commits": []} + existing = set(registry["releases"] if package["ecosystem"] == "python" else registry["versions"]) + return {**result, "status": "patch_required", "next_version": patch_version(package["version"], existing), + "commits": history} + + +def check(root: Path, audit: dict) -> list[str]: + """Audit is a one-time floor, not a permanent pin on future releases.""" + versions = json.loads((root / ".release-please-manifest.json").read_text()) + errors = [] + for package in audit["packages"]: + if package["status"] != "patch_required": + continue + file = root / package["manifest"] + if package["ecosystem"] == "python": + data = tomllib.loads(file.read_text()) + current = data.get("project", data.get("tool", {}).get("poetry", {}))["version"] + else: + current = json.loads(file.read_text())["version"] + parse = lambda v: tuple(map(int, v.split("."))) + if parse(current) < parse(package["next_version"]): + errors.append(f"{package['name']}: {current} strands the audited bootstrap changes; expected >= {package['next_version']}") + if versions.get(package["release_path"]) != current: + errors.append(f"{package['name']}: release-please manifest doesn't match {current}") + return errors + + +def main() -> int: + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--root", type=Path, default=REPO_ROOT) + parser.add_argument("--ref", default=BASELINE) + parser.add_argument("--check", action="store_true") + parser.add_argument("--output", type=Path, default=AUDIT) + args = parser.parse_args() + if args.check: + problems = check(args.root, json.loads(args.output.read_text())) + if problems: + print("\n".join(problems)) + return 1 + print("bootstrap: all audited same-version changes have a new manifest version") + return 0 + ref = git(args.root, "rev-parse", args.ref).strip() + packages = manifests(args.root, ref) + skipped = load_config().get("skip", {}) + with ThreadPoolExecutor(max_workers=6) as pool: + entries = list(pool.map(lambda p: audit_package(args.root, ref, p, skipped), packages)) + summary = {eco: {status: sum(p["ecosystem"] == eco and p["status"] == status for p in entries) + for status in ("excluded", "unpublished_current_version", "unchanged_since_upload", "patch_required")} + for eco in ("python", "typescript")} + result = {"baseline": ref, "queried_at": datetime.now(timezone.utc).isoformat(), + "method": "First-parent package history after the last file upload of the baseline manifest version. Explicit one-time patch bumps; no historical replay.", + "summary": summary, "packages": entries} + args.output.write_text(json.dumps(result, indent=2) + "\n") + print(json.dumps(summary, indent=2)) + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/.github/release/test_bootstrap_audit.py b/.github/release/test_bootstrap_audit.py new file mode 100644 index 000000000..187c829ef --- /dev/null +++ b/.github/release/test_bootstrap_audit.py @@ -0,0 +1,85 @@ +"""Regression coverage for the one-time unpublished-fix audit (no network).""" +import json +from pathlib import Path +import sys +import tempfile +import unittest +from unittest.mock import patch + +sys.path.insert(0, str(Path(__file__).parent)) +import bootstrap_audit + + +class BootstrapTests(unittest.TestCase): + def setUp(self): + self.package = {"ecosystem": "python", "name": "traceAI-openai", "version": "0.1.10", + "manifest": "python/frameworks/openai/pyproject.toml", "dir": "python/frameworks/openai", + "release_path": "python/frameworks/openai"} + self.registry = {"releases": {"0.1.10": [ + {"upload_time_iso_8601": "2026-03-10T13:54:40Z"}, + {"upload_time_iso_8601": "2026-03-10T13:54:41Z"}]}} + + def test_python_uses_last_distribution_upload_not_first(self): + self.assertEqual(bootstrap_audit.upload_time(self.package, self.registry), "2026-03-10T13:54:41Z") + self.assertIsNone(bootstrap_audit.upload_time(self.package, {"releases": {"0.1.10": []}})) + + def test_npm_requires_version_and_exact_version_time(self): + p = {**self.package, "ecosystem": "typescript"} + self.assertEqual(bootstrap_audit.upload_time(p, {"versions": {"0.1.10": {}}, "time": {"0.1.10": "date"}}), "date") + self.assertIsNone(bootstrap_audit.upload_time(p, {"versions": {}, "time": {"modified": "date"}})) + + def test_patch_target_is_not_already_uploaded(self): + self.assertEqual(bootstrap_audit.patch_version("0.1.10", {"0.1.10", "0.1.11", "0.1.12", "0.2.0"}), "0.1.13") + + def test_registry_absence_does_not_trigger_unnecessary_bump(self): + with patch.object(bootstrap_audit, "_get_json", return_value=None), patch.object(bootstrap_audit, "package_history") as history: + p = bootstrap_audit.audit_package(Path("/tmp"), "baseline", self.package, {}) + self.assertEqual(p["status"], "unpublished_current_version") + history.assert_not_called() + + def test_unchanged_published_version_is_not_bumped(self): + with patch.object(bootstrap_audit, "_get_json", return_value=self.registry), patch.object(bootstrap_audit, "package_history", return_value=[]): + p = bootstrap_audit.audit_package(Path("/tmp"), "baseline", self.package, {}) + self.assertEqual(p["status"], "unchanged_since_upload") + + def test_openai_style_merged_fix_requires_patch(self): + with patch.object(bootstrap_audit, "_get_json", return_value=self.registry), patch.object(bootstrap_audit, "package_history", return_value=[{"sha": "fix"}]): + p = bootstrap_audit.audit_package(Path("/tmp"), "baseline", self.package, {}) + self.assertEqual((p["status"], p["next_version"]), ("patch_required", "0.1.11")) + + def test_history_uses_merge_dates_and_excludes_sibling_sdk_for_core(self): + with patch.object(bootstrap_audit, "git", return_value="sha\t2026-10-28T00:00:00Z\tMerge fix\n") as git: + bootstrap_audit.package_history(Path("/tmp"), "baseline", {"dir": "python"}, "date") + args = git.call_args.args + self.assertIn("--first-parent", args) + self.assertIn("--since-as-filter=date", args) + self.assertIn(":(exclude)python/frameworks", args) + + def test_one_time_floor_allows_later_releases_but_catches_stranded_versions(self): + p = {**self.package, "status": "patch_required", "next_version": "0.1.11"} + with tempfile.TemporaryDirectory() as directory: + root = Path(directory) + file = root / p["manifest"] + file.parent.mkdir(parents=True) + for version, passes in (("0.1.10", False), ("0.1.11", True), ("0.2.0", True)): + file.write_text(f'[project]\nversion="{version}"\n') + (root / ".release-please-manifest.json").write_text(json.dumps({p["release_path"]: version})) + self.assertEqual(bootstrap_audit.check(root, {"packages": [p]}) == [], passes) + + def test_manifest_inventory_reads_ref_without_importing_package_code(self): + files = "python/pyproject.toml\ntypescript/packages/a/package.json\ntypescript/packages/private/package.json\nREADME.md\n" + with patch.object(bootstrap_audit, "git", side_effect=[files, '[project]\nname="core"\nversion="1.0.0"', '{"name":"a","version":"0.1.0"}', '{"name":"private","version":"1.0.0","private":true}']): + packages = bootstrap_audit.manifests(Path("/tmp"), "baseline") + self.assertEqual([p["name"] for p in packages], ["core", "a"]) + self.assertEqual(packages[0]["release_path"], "python/fi_instrumentation") + + def test_committed_audit_covers_bootstrap_snapshot_and_all_bumps(self): + # No history dependency: Actions checks out only the latest commit. + audit = json.loads(bootstrap_audit.AUDIT.read_text()) + self.assertEqual(len({p["manifest"] for p in audit["packages"]}), 115) + self.assertEqual(bootstrap_audit.check(bootstrap_audit.REPO_ROOT, audit), []) + self.assertTrue(any(p["name"] == "traceAI-openai" and p["status"] == "patch_required" for p in audit["packages"])) + + +if __name__ == "__main__": + unittest.main() diff --git a/.github/release/test_release_strategies.cjs b/.github/release/test_release_strategies.cjs index 6abeabf9b..88e5ad8b8 100644 --- a/.github/release/test_release_strategies.cjs +++ b/.github/release/test_release_strategies.cjs @@ -6,7 +6,7 @@ const fs = require('node:fs'); const path = require('node:path'); const {Manifest} = require('release-please/build/src/manifest.js'); const {FileNotFoundError} = require('release-please/build/src/errors/index.js'); -const root = path.resolve(__dirname, '../..'); +const root = process.argv[2] ? path.resolve(process.argv[2]) : path.resolve(__dirname, '../..'); const config = JSON.parse(fs.readFileSync(path.join(root, 'release-please-config.json'))); const baseline = JSON.parse(fs.readFileSync(path.join(root, '.release-please-manifest.json'))); const featureVersion = version => { @@ -66,8 +66,24 @@ const scm = { assert(updates.get('csharp/src/FIInstrumentation/FIInstrumentation.csproj').includes(`${next['csharp/src/FIInstrumentation']}`)); assert(!next.java.includes('SNAPSHOT'), 'one release PR, no Maven snapshot PR'); assert.match(updates.get('java/pom.xml'), new RegExp(`${next.java.replaceAll('.', '\\.')}`)); + // The Java lane's BOM and every literal reactor parent must move with the + // root version. Merely checking the root POM misses a broken Maven reactor. + const {DOMParser} = require('@xmldom/xmldom'); + const parentOf = text => new DOMParser().parseFromString(text, 'text/xml').getElementsByTagName('parent')[0]; + const valueOf = (parent, name) => parent?.getElementsByTagName(name)[0]?.textContent; + const javaPoms = fs.readdirSync(path.join(root, 'java'), {recursive: true}) + .filter(f => path.basename(f) === 'pom.xml').map(f => `java/${f}`); + let checkedJavaParents = 0; + for (const file of javaPoms) { + const original = parentOf(fs.readFileSync(path.join(root, file), 'utf8')); + if (!['com.futureagi', 'ai.traceai'].includes(valueOf(original, 'groupId'))) continue; + const updated = parentOf(updates.get(file) || fs.readFileSync(path.join(root, file), 'utf8')); + assert.equal(valueOf(updated, 'version'), next.java, `${file}: parent version must follow root`); + checkedJavaParents++; + } + assert(checkedJavaParents > 0, 'test must cover the Java module parents'); const {TagName} = require('release-please/build/src/util/tag-name.js'); const {Version} = require('release-please/build/src/version.js'); assert.equal(new TagName(Version.parse('0.1.0'), 'go/openai', '/', true).toString(), 'go/openai/v0.1.0'); - console.log(JSON.stringify({result: 'PASS', pullRequests: prs.length, syntheticBumps: Object.fromEntries(Object.keys(next).filter(p => next[p] !== baseline[p]).map(p => [p, {from: baseline[p], to: next[p]}])), updatedFiles: [...updates.keys()]}, null, 2)); + console.log(JSON.stringify({result: 'PASS', pullRequests: prs.length, checkedJavaParents, bomPresent: javaPoms.includes('java/traceai-bom/pom.xml'), syntheticBumps: Object.fromEntries(Object.keys(next).filter(p => next[p] !== baseline[p]).map(p => [p, {from: baseline[p], to: next[p]}])), updatedFiles: [...updates.keys()]}, null, 2)); })().catch(err => { console.error(err); process.exitCode = 1; }); diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 996b469ba..293234332 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -68,8 +68,10 @@ jobs: run: | npm install --prefix "$RUNNER_TEMP/release-please-test" --ignore-scripts --no-audit --no-fund release-please@17.11.2 NODE_PATH="$RUNNER_TEMP/release-please-test/node_modules" node .github/release/test_release_strategies.cjs - - name: Validate runtime versions and release-please coverage - run: python3 .github/release/release_plan.py --check + - name: Validate runtime versions, coverage and bootstrap backlog + run: | + python3 .github/release/release_plan.py --check + python3 .github/release/bootstrap_audit.py --check - name: Query registries and reconcile incomplete releases id: plan env: diff --git a/.release-please-manifest.json b/.release-please-manifest.json index e0502d62f..ffab6e894 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -4,67 +4,67 @@ "python/frameworks/ag2-classic": "0.1.0", "python/frameworks/agent-framework": "0.1.0", "python/frameworks/agno": "0.1.0", - "python/frameworks/anthropic": "0.1.10", + "python/frameworks/anthropic": "0.1.11", "python/frameworks/autogen": "0.2.1", - "python/frameworks/bedrock": "0.1.10", + "python/frameworks/bedrock": "0.1.11", "python/frameworks/beeai": "0.1.0", - "python/frameworks/cerebras": "0.1.0", - "python/frameworks/chromadb": "0.1.0", + "python/frameworks/cerebras": "0.1.1", + "python/frameworks/chromadb": "0.1.1", "python/frameworks/claude-agent-sdk": "0.1.1", - "python/frameworks/cohere": "0.1.0", + "python/frameworks/cohere": "0.1.1", "python/frameworks/crewai": "0.1.9", - "python/frameworks/deepseek": "0.1.0", + "python/frameworks/deepseek": "0.1.1", "python/frameworks/discoveryengine": "0.1.0", - "python/frameworks/dspy": "0.1.8", + "python/frameworks/dspy": "0.1.9", "python/frameworks/elevenlabs-agents": "0.1.0", "python/frameworks/exa": "0.1.0", "python/frameworks/firecrawl": "0.1.0", - "python/frameworks/fireworks": "0.1.0", - "python/frameworks/google-adk": "0.1.5", - "python/frameworks/google-genai": "0.1.2", + "python/frameworks/fireworks": "0.1.1", + "python/frameworks/google-adk": "0.1.6", + "python/frameworks/google-genai": "0.1.3", "python/frameworks/google-genai-live": "0.1.0", - "python/frameworks/groq": "0.1.9", - "python/frameworks/guardrails": "0.2.0", - "python/frameworks/haystack": "0.1.9", + "python/frameworks/groq": "0.1.10", + "python/frameworks/guardrails": "0.2.1", + "python/frameworks/haystack": "0.1.10", "python/frameworks/hermes-agent/hermes-plugin/futureagi": "0.1.0", "python/frameworks/hermes-agent": "0.1.0", "python/frameworks/huggingface": "0.1.0", - "python/frameworks/instructor": "0.2.0", - "python/frameworks/lancedb": "0.1.0", + "python/frameworks/instructor": "0.2.1", + "python/frameworks/lancedb": "0.1.1", "python/frameworks/langchain": "0.2.1", - "python/frameworks/litellm": "0.1.10", - "python/frameworks/livekit": "0.1.2", - "python/frameworks/llama_index": "0.1.9", - "python/frameworks/mcp": "0.1.2", + "python/frameworks/litellm": "0.1.11", + "python/frameworks/livekit": "0.1.3", + "python/frameworks/llama_index": "0.1.10", + "python/frameworks/mcp": "0.1.3", "python/frameworks/mcp-use": "0.1.0", - "python/frameworks/milvus": "0.1.0", + "python/frameworks/milvus": "0.1.1", "python/frameworks/minimax": "0.1.0", - "python/frameworks/mistralai": "0.1.8", - "python/frameworks/mongodb-vector": "0.1.0", + "python/frameworks/mistralai": "0.1.9", + "python/frameworks/mongodb-vector": "0.1.1", "python/frameworks/ollama": "0.1.0", - "python/frameworks/openai": "0.1.10", - "python/frameworks/openai-agents": "0.1.6", + "python/frameworks/openai": "0.1.11", + "python/frameworks/openai-agents": "0.1.7", "python/frameworks/openai-realtime": "0.1.0", "python/frameworks/parallel": "0.1.0", - "python/frameworks/pgvector": "0.1.0", - "python/frameworks/pinecone": "0.1.0", - "python/frameworks/pipecat": "0.1.1", - "python/frameworks/portkey": "0.1.2", + "python/frameworks/pgvector": "0.1.1", + "python/frameworks/pinecone": "0.1.1", + "python/frameworks/pipecat": "0.1.2", + "python/frameworks/portkey": "0.1.3", "python/frameworks/pydantic-ai": "0.1.0", - "python/frameworks/qdrant": "0.1.0", - "python/frameworks/redis-vector": "0.1.0", + "python/frameworks/qdrant": "0.1.1", + "python/frameworks/redis-vector": "0.1.1", "python/frameworks/replicate": "0.1.0", "python/frameworks/semantic-kernel": "0.1.0", - "python/frameworks/smolagents": "0.1.5", + "python/frameworks/smolagents": "0.1.6", "python/frameworks/strands": "0.1.1", "python/frameworks/tavily": "0.1.0", - "python/frameworks/together": "0.1.0", + "python/frameworks/together": "0.1.1", "python/frameworks/typesafe": "0.1.0", - "python/frameworks/vertexai": "0.1.10", + "python/frameworks/vertexai": "0.1.11", "python/frameworks/vllm": "0.1.0", "python/frameworks/voyage": "0.1.0", - "python/frameworks/weaviate": "0.1.0", - "python/frameworks/xai": "0.1.0", + "python/frameworks/weaviate": "0.1.1", + "python/frameworks/xai": "0.1.1", "python/traceai": "0.1.0", "typescript/packages/fi-core": "1.1.0", "typescript/packages/fi-semantic-conventions": "1.0.0", @@ -89,9 +89,9 @@ "typescript/packages/traceai_lancedb": "0.1.0", "typescript/packages/traceai_langchain": "0.1.3", "typescript/packages/traceai_livekit": "0.1.0", - "typescript/packages/traceai_llamaindex": "0.1.1", + "typescript/packages/traceai_llamaindex": "0.1.2", "typescript/packages/traceai_mastra": "0.2.0", - "typescript/packages/traceai_mcp": "0.1.0", + "typescript/packages/traceai_mcp": "0.1.1", "typescript/packages/traceai_milvus": "0.1.0", "typescript/packages/traceai_mistral": "0.1.0", "typescript/packages/traceai_mongodb": "0.1.0", @@ -107,7 +107,7 @@ "typescript/packages/traceai_redis": "0.1.0", "typescript/packages/traceai_strands": "0.1.0", "typescript/packages/traceai_together": "0.1.0", - "typescript/packages/traceai_vercel": "0.1.0", + "typescript/packages/traceai_vercel": "0.1.1", "typescript/packages/traceai_vertexai": "0.1.0", "typescript/packages/traceai_vllm": "0.1.0", "typescript/packages/traceai_voltagent": "0.1.0", diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0174fc538..613fa64b7 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -106,7 +106,9 @@ recovery and dry runs. Pull requests never publish; workflow dispatch defaults t run and only main is eligible to publish. The workflow never auto-merges a release PR. When adding a package, add its release-please config and manifest entries, and Python -runtime-version `extra-files`/markers if applicable. Validate locally: +runtime-version `extra-files`/markers if applicable. The initial release also includes audited +one-time patches for fixes merged after their current registry version was uploaded; see +`RELEASING.md` and `.github/release/bootstrap-audit.json`. Validate locally: ```bash python3 -m unittest discover -s .github/release -p 'test_*.py' diff --git a/RELEASING.md b/RELEASING.md index f972785d0..669c7976f 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -28,7 +28,20 @@ The Go proxy URL escapes uppercase letters: `traceAI` becomes `trace!a!i`. A mod The manifest is seeded from the current versions on dev, **not** from old registry versions. Go starts at **0.1.0**. `bootstrap-sha` is the dev head `35f2e3dc364676fa5bdab1e71ae500daf9efc00c`: this deliberately excludes pre-bootstrap history from the first release PR. Keep that SHA as a fallback for components that have not yet acquired matching release tags; do not advance it on each release. -When [#287](https://github.com/future-agi/traceAI/pull/287) reaches main, existing unpublished versions can ship immediately once their ecosystem's setup is complete. The workflow also repairs missing tags/releases for versions already on a registry, without re-uploading them or attaching newly built binaries to their historical version. Nothing automatically increments every SDK merely because #287 contains old history. The first qualifying **post-bootstrap** package change produces the next bump. +When [#287](https://github.com/future-agi/traceAI/pull/287) reaches main, existing unpublished versions can ship immediately once their ecosystem's setup is complete. **Already-merged fixes must not be stranded behind an unchanged registry version.** The committed [bootstrap audit](.github/release/bootstrap-audit.json) inventories all **68 Python and 47 npm manifests** at that baseline, reads the public upload timestamp of each current version, and checks first-parent package history after the upload. It uses the last wheel/sdist upload, not registry project-modification time; core excludes sibling SDK directories. This is conservative: any package-directory change counts, including docs/version housekeeping. + +The audit found **35 Python and 3 npm same-version packages with later merged changes**. This PR applies explicit, one-time patch bumps to those **38 packages**, including Python OpenAI **0.1.10 → 0.1.11** for the already-merged #249 fix. Package manifests, Python runtime versions, release-please's manifest and changelogs move together. This option deliberately avoids replaying all old conventional commits or repeatedly forcing `release-as`. There are also **25 Python and 12 npm current versions not yet uploaded**, which need no additional bootstrap bump. Six published Python and 32 published npm packages have no package history after their current-version upload and are left unchanged; two Python manifests are excluded below. + +Thus the audited first run needs **60 Python + 15 npm new uploads**, five initial Go tags, and the Java reactor after its companion PR; NuGet 1.0.0 is already published. Registry state can change before the actual release, so the live planner remains authoritative. The workflow also repairs missing tags/releases for versions already on a registry, without re-uploading them or attaching newly built binaries to their historical version. Subsequent qualifying **post-bootstrap** changes use the normal release PR loop. + +To reproduce the read-only audit or validate its one-time version floor: + +```bash +python3 .github/release/bootstrap_audit.py --output /tmp/traceai-bootstrap-audit.json +python3 .github/release/bootstrap_audit.py --check +``` + +Reproducing history requires the baseline commit in the local clone. The offline check and CI tests need only the current checkout; they allow later versions rather than permanently pinning packages to the bootstrap patch. Two manifests are tracked but intentionally **never published**: @@ -108,7 +121,7 @@ Once the config/manifest are present on the target branch, preview the actual PR --token "$(gh auth token)" ``` -Use a token with read access for this dry run. Do not enable shell tracing around tokens. The initial development preview used real dev history with **only** the two proposed, not-yet-merged config files overlaid locally; it found zero post-bootstrap commits and would open zero PRs. A separate fully offline fake-history test exercises a qualifying feature across all five languages and asserts one combined PR plus correct version-file changes. +Use a token with read access for this dry run. Do not enable shell tracing around tokens. The initial development preview used real dev history with **only** the two proposed, not-yet-merged config files overlaid locally; it found zero post-bootstrap commits and would open zero PRs. A separate fully offline fake-history test exercises a qualifying feature across all five languages and asserts one combined PR plus correct version-file changes. It checks every internal Java parent POM, not just the reactor root; an additional local run over companion #302 also covers `traceai-bom`. For a GitHub-hosted build-only run after the workflow lands on the default branch: diff --git a/python/frameworks/anthropic/CHANGELOG.md b/python/frameworks/anthropic/CHANGELOG.md index fffc68e28..bc4405e97 100644 --- a/python/frameworks/anthropic/CHANGELOG.md +++ b/python/frameworks/anthropic/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.11] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.10 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.7] - 2025-06-10 ### Feature - Added support for ai-evaluation diff --git a/python/frameworks/anthropic/pyproject.toml b/python/frameworks/anthropic/pyproject.toml index 6a854f082..568a4341d 100644 --- a/python/frameworks/anthropic/pyproject.toml +++ b/python/frameworks/anthropic/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-anthropic" -version = "0.1.10" +version = "0.1.11" description = "OpenTelemetry instrumentation for Anthropic" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/anthropic/traceai_anthropic/version.py b/python/frameworks/anthropic/traceai_anthropic/version.py index b2b8e3d08..8c39d1009 100644 --- a/python/frameworks/anthropic/traceai_anthropic/version.py +++ b/python/frameworks/anthropic/traceai_anthropic/version.py @@ -1 +1 @@ -__version__ = "0.1.10" # x-release-please-version +__version__ = "0.1.11" # x-release-please-version diff --git a/python/frameworks/bedrock/CHANGELOG.md b/python/frameworks/bedrock/CHANGELOG.md index 70ed1dd36..3333a9104 100644 --- a/python/frameworks/bedrock/CHANGELOG.md +++ b/python/frameworks/bedrock/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.11] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.10 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.8] - 2025-07-08 ### Feature - Added support for Bedrock's new multi-modal response format diff --git a/python/frameworks/bedrock/pyproject.toml b/python/frameworks/bedrock/pyproject.toml index 926650474..a00a917a7 100644 --- a/python/frameworks/bedrock/pyproject.toml +++ b/python/frameworks/bedrock/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-bedrock" -version = "0.1.10" +version = "0.1.11" description = "OpenTelemetry instrumentation for Bedrock" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/bedrock/traceai_bedrock/version.py b/python/frameworks/bedrock/traceai_bedrock/version.py index b2b8e3d08..8c39d1009 100644 --- a/python/frameworks/bedrock/traceai_bedrock/version.py +++ b/python/frameworks/bedrock/traceai_bedrock/version.py @@ -1 +1 @@ -__version__ = "0.1.10" # x-release-please-version +__version__ = "0.1.11" # x-release-please-version diff --git a/python/frameworks/cerebras/CHANGELOG.md b/python/frameworks/cerebras/CHANGELOG.md new file mode 100644 index 000000000..9ea891f1f --- /dev/null +++ b/python/frameworks/cerebras/CHANGELOG.md @@ -0,0 +1,7 @@ +# Changelog + +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + diff --git a/python/frameworks/cerebras/pyproject.toml b/python/frameworks/cerebras/pyproject.toml index 420381c61..9d5e38145 100644 --- a/python/frameworks/cerebras/pyproject.toml +++ b/python/frameworks/cerebras/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-cerebras" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for Cerebras Cloud SDK" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/cerebras/traceai_cerebras/version.py b/python/frameworks/cerebras/traceai_cerebras/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/cerebras/traceai_cerebras/version.py +++ b/python/frameworks/cerebras/traceai_cerebras/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/chromadb/CHANGELOG.md b/python/frameworks/chromadb/CHANGELOG.md index 513b9ee4d..a8cfbca5a 100644 --- a/python/frameworks/chromadb/CHANGELOG.md +++ b/python/frameworks/chromadb/CHANGELOG.md @@ -2,6 +2,11 @@ All notable changes to traceAI-chromadb will be documented in this file. +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-01-24 ### Added diff --git a/python/frameworks/chromadb/pyproject.toml b/python/frameworks/chromadb/pyproject.toml index 0ed11e14e..5860c441e 100644 --- a/python/frameworks/chromadb/pyproject.toml +++ b/python/frameworks/chromadb/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-chromadb" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for ChromaDB vector database" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/chromadb/traceai_chromadb/version.py b/python/frameworks/chromadb/traceai_chromadb/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/chromadb/traceai_chromadb/version.py +++ b/python/frameworks/chromadb/traceai_chromadb/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/cohere/CHANGELOG.md b/python/frameworks/cohere/CHANGELOG.md new file mode 100644 index 000000000..9ea891f1f --- /dev/null +++ b/python/frameworks/cohere/CHANGELOG.md @@ -0,0 +1,7 @@ +# Changelog + +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + diff --git a/python/frameworks/cohere/pyproject.toml b/python/frameworks/cohere/pyproject.toml index 5c9edfcb8..30f9c745f 100644 --- a/python/frameworks/cohere/pyproject.toml +++ b/python/frameworks/cohere/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-cohere" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for Cohere - embeddings, chat, and rerank" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/cohere/traceai_cohere/version.py b/python/frameworks/cohere/traceai_cohere/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/cohere/traceai_cohere/version.py +++ b/python/frameworks/cohere/traceai_cohere/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/deepseek/CHANGELOG.md b/python/frameworks/deepseek/CHANGELOG.md new file mode 100644 index 000000000..9ea891f1f --- /dev/null +++ b/python/frameworks/deepseek/CHANGELOG.md @@ -0,0 +1,7 @@ +# Changelog + +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + diff --git a/python/frameworks/deepseek/pyproject.toml b/python/frameworks/deepseek/pyproject.toml index caf09b43d..1ad0c9708 100644 --- a/python/frameworks/deepseek/pyproject.toml +++ b/python/frameworks/deepseek/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-deepseek" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for DeepSeek - chat completions and reasoning models" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/deepseek/traceai_deepseek/version.py b/python/frameworks/deepseek/traceai_deepseek/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/deepseek/traceai_deepseek/version.py +++ b/python/frameworks/deepseek/traceai_deepseek/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/dspy/CHANGELOG.md b/python/frameworks/dspy/CHANGELOG.md index b8dda3584..a9db4fc56 100644 --- a/python/frameworks/dspy/CHANGELOG.md +++ b/python/frameworks/dspy/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.9] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.8 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.6] - 2025-05-29 ### Feature - Updated dependencies to the latest versions. diff --git a/python/frameworks/dspy/pyproject.toml b/python/frameworks/dspy/pyproject.toml index 2d549f2fa..690e73460 100644 --- a/python/frameworks/dspy/pyproject.toml +++ b/python/frameworks/dspy/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-DSPy" -version = "0.1.8" +version = "0.1.9" description = "OpenTelemetry instrumentation for DSPy" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/dspy/traceai_dspy/version.py b/python/frameworks/dspy/traceai_dspy/version.py index bad05c2e5..a99028c1f 100644 --- a/python/frameworks/dspy/traceai_dspy/version.py +++ b/python/frameworks/dspy/traceai_dspy/version.py @@ -1 +1 @@ -__version__ = "0.1.8" # x-release-please-version +__version__ = "0.1.9" # x-release-please-version diff --git a/python/frameworks/fireworks/CHANGELOG.md b/python/frameworks/fireworks/CHANGELOG.md new file mode 100644 index 000000000..9ea891f1f --- /dev/null +++ b/python/frameworks/fireworks/CHANGELOG.md @@ -0,0 +1,7 @@ +# Changelog + +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + diff --git a/python/frameworks/fireworks/pyproject.toml b/python/frameworks/fireworks/pyproject.toml index ce907fc5e..2a7507863 100644 --- a/python/frameworks/fireworks/pyproject.toml +++ b/python/frameworks/fireworks/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-fireworks" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for Fireworks AI" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/fireworks/traceai_fireworks/version.py b/python/frameworks/fireworks/traceai_fireworks/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/fireworks/traceai_fireworks/version.py +++ b/python/frameworks/fireworks/traceai_fireworks/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/google-adk/CHANGELOG.md b/python/frameworks/google-adk/CHANGELOG.md index ddc3b2f32..783e9de1f 100644 --- a/python/frameworks/google-adk/CHANGELOG.md +++ b/python/frameworks/google-adk/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +## [0.1.6] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.5 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.5] - 2026-05-15 - Fix `instrument()` crash on `google-adk >= 1.32`. Patch targets and diff --git a/python/frameworks/google-adk/pyproject.toml b/python/frameworks/google-adk/pyproject.toml index 4df0aa863..161808d6d 100644 --- a/python/frameworks/google-adk/pyproject.toml +++ b/python/frameworks/google-adk/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-google-adk" -version = "0.1.5" +version = "0.1.6" description = "OpenTelemetry instrumentation for Google ADK" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/google-adk/traceai_google_adk/version.py b/python/frameworks/google-adk/traceai_google_adk/version.py index df9de31c3..bdb1b524d 100644 --- a/python/frameworks/google-adk/traceai_google_adk/version.py +++ b/python/frameworks/google-adk/traceai_google_adk/version.py @@ -1 +1 @@ -__version__ = "0.1.5" # x-release-please-version \ No newline at end of file +__version__ = "0.1.6" # x-release-please-version \ No newline at end of file diff --git a/python/frameworks/google-genai/CHANGELOG.md b/python/frameworks/google-genai/CHANGELOG.md index 2f3dd8bac..f36b796e3 100644 --- a/python/frameworks/google-genai/CHANGELOG.md +++ b/python/frameworks/google-genai/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.3] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.2 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-07-04 ### Feature - Added Support for Google Gen AI diff --git a/python/frameworks/google-genai/pyproject.toml b/python/frameworks/google-genai/pyproject.toml index d706bb47c..e91cf117a 100644 --- a/python/frameworks/google-genai/pyproject.toml +++ b/python/frameworks/google-genai/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-google-genai" -version = "0.1.2" +version = "0.1.3" description = "OpenTelemetry instrumentation for Google Gen AI" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/google-genai/traceai_google_genai/version.py b/python/frameworks/google-genai/traceai_google_genai/version.py index 0d33eef3f..97c339acc 100644 --- a/python/frameworks/google-genai/traceai_google_genai/version.py +++ b/python/frameworks/google-genai/traceai_google_genai/version.py @@ -1 +1 @@ -__version__ = "0.1.2" # x-release-please-version +__version__ = "0.1.3" # x-release-please-version diff --git a/python/frameworks/groq/CHANGELOG.md b/python/frameworks/groq/CHANGELOG.md index fffc68e28..0215883a3 100644 --- a/python/frameworks/groq/CHANGELOG.md +++ b/python/frameworks/groq/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.10] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.9 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.7] - 2025-06-10 ### Feature - Added support for ai-evaluation diff --git a/python/frameworks/groq/pyproject.toml b/python/frameworks/groq/pyproject.toml index f74addb22..926127ccf 100644 --- a/python/frameworks/groq/pyproject.toml +++ b/python/frameworks/groq/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-groq" -version = "0.1.9" +version = "0.1.10" description = "OpenTelemetry instrumentation for Groq" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/groq/traceai_groq/version.py b/python/frameworks/groq/traceai_groq/version.py index a99028c1f..b2b8e3d08 100644 --- a/python/frameworks/groq/traceai_groq/version.py +++ b/python/frameworks/groq/traceai_groq/version.py @@ -1 +1 @@ -__version__ = "0.1.9" # x-release-please-version +__version__ = "0.1.10" # x-release-please-version diff --git a/python/frameworks/guardrails/CHANGELOG.md b/python/frameworks/guardrails/CHANGELOG.md index 979537080..2c17e7ea2 100644 --- a/python/frameworks/guardrails/CHANGELOG.md +++ b/python/frameworks/guardrails/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.2.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.2.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.3] - 2025-05-29 ### Feature - Updated dependencies to the latest versions. diff --git a/python/frameworks/guardrails/pyproject.toml b/python/frameworks/guardrails/pyproject.toml index bd7c5c854..6fa0f30f6 100644 --- a/python/frameworks/guardrails/pyproject.toml +++ b/python/frameworks/guardrails/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-guardrails" -version = "0.2.0" +version = "0.2.1" description = "OpenTelemetry instrumentation for Guardrails" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/guardrails/traceai_guardrails/version.py b/python/frameworks/guardrails/traceai_guardrails/version.py index e44b515c6..130276d81 100644 --- a/python/frameworks/guardrails/traceai_guardrails/version.py +++ b/python/frameworks/guardrails/traceai_guardrails/version.py @@ -1 +1 @@ -__version__ = "0.2.0" # x-release-please-version +__version__ = "0.2.1" # x-release-please-version diff --git a/python/frameworks/haystack/CHANGELOG.md b/python/frameworks/haystack/CHANGELOG.md index e0a37817d..7bc737ee2 100644 --- a/python/frameworks/haystack/CHANGELOG.md +++ b/python/frameworks/haystack/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.10] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.9 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.7] - 2025-06-10 ### Feature - Added support for ai-evaluation diff --git a/python/frameworks/haystack/pyproject.toml b/python/frameworks/haystack/pyproject.toml index 452183be2..fc3fbf25f 100644 --- a/python/frameworks/haystack/pyproject.toml +++ b/python/frameworks/haystack/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-haystack" -version = "0.1.9" +version = "0.1.10" description = "OpenTelemetry instrumentation for Haystack" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/haystack/traceai_haystack/version.py b/python/frameworks/haystack/traceai_haystack/version.py index a99028c1f..b2b8e3d08 100644 --- a/python/frameworks/haystack/traceai_haystack/version.py +++ b/python/frameworks/haystack/traceai_haystack/version.py @@ -1 +1 @@ -__version__ = "0.1.9" # x-release-please-version +__version__ = "0.1.10" # x-release-please-version diff --git a/python/frameworks/instructor/CHANGELOG.md b/python/frameworks/instructor/CHANGELOG.md index fffc68e28..5530f6b3d 100644 --- a/python/frameworks/instructor/CHANGELOG.md +++ b/python/frameworks/instructor/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.2.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.2.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.7] - 2025-06-10 ### Feature - Added support for ai-evaluation diff --git a/python/frameworks/instructor/pyproject.toml b/python/frameworks/instructor/pyproject.toml index 1e9c14bef..0fdfb4d8d 100644 --- a/python/frameworks/instructor/pyproject.toml +++ b/python/frameworks/instructor/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-instructor" -version = "0.2.0" +version = "0.2.1" description = "OpenTelemetry instrumentation for Instructor" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/instructor/traceai_instructor/version.py b/python/frameworks/instructor/traceai_instructor/version.py index e44b515c6..130276d81 100644 --- a/python/frameworks/instructor/traceai_instructor/version.py +++ b/python/frameworks/instructor/traceai_instructor/version.py @@ -1 +1 @@ -__version__ = "0.2.0" # x-release-please-version +__version__ = "0.2.1" # x-release-please-version diff --git a/python/frameworks/lancedb/CHANGELOG.md b/python/frameworks/lancedb/CHANGELOG.md index 70dc815b6..c5b4d81bf 100644 --- a/python/frameworks/lancedb/CHANGELOG.md +++ b/python/frameworks/lancedb/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-01-24 ### Added diff --git a/python/frameworks/lancedb/pyproject.toml b/python/frameworks/lancedb/pyproject.toml index bbfdfee82..715c5edef 100644 --- a/python/frameworks/lancedb/pyproject.toml +++ b/python/frameworks/lancedb/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-lancedb" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for LanceDB vector database" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/lancedb/traceai_lancedb/version.py b/python/frameworks/lancedb/traceai_lancedb/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/lancedb/traceai_lancedb/version.py +++ b/python/frameworks/lancedb/traceai_lancedb/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/litellm/CHANGELOG.md b/python/frameworks/litellm/CHANGELOG.md index bd8a8ead4..3bad22708 100644 --- a/python/frameworks/litellm/CHANGELOG.md +++ b/python/frameworks/litellm/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.11] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.10 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.8] - 2025-07-08 ### Feature - Added support for OpenAI's Dall-E image generation models diff --git a/python/frameworks/litellm/pyproject.toml b/python/frameworks/litellm/pyproject.toml index a8f902f48..5586ce495 100644 --- a/python/frameworks/litellm/pyproject.toml +++ b/python/frameworks/litellm/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-litellm" -version = "0.1.10" +version = "0.1.11" description = "OpenTelemetry instrumentation for LiteLLM" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/litellm/traceai_litellm/version.py b/python/frameworks/litellm/traceai_litellm/version.py index b2b8e3d08..8c39d1009 100644 --- a/python/frameworks/litellm/traceai_litellm/version.py +++ b/python/frameworks/litellm/traceai_litellm/version.py @@ -1 +1 @@ -__version__ = "0.1.10" # x-release-please-version +__version__ = "0.1.11" # x-release-please-version diff --git a/python/frameworks/livekit/CHANGELOG.md b/python/frameworks/livekit/CHANGELOG.md index 3d6796180..97ea57a17 100644 --- a/python/frameworks/livekit/CHANGELOG.md +++ b/python/frameworks/livekit/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.3] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.2 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.2] - 2026-10-21 ### Fixed - Spans that end last in a LiveKit job, the root `agent_session` span among them, are no longer lost (a job process on Linux diff --git a/python/frameworks/livekit/pyproject.toml b/python/frameworks/livekit/pyproject.toml index e748dc32d..2eebeab48 100644 --- a/python/frameworks/livekit/pyproject.toml +++ b/python/frameworks/livekit/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-livekit" -version = "0.1.2" +version = "0.1.3" description = "OpenTelemetry instrumentation for LiveKit" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/livekit/traceai_livekit/__init__.py b/python/frameworks/livekit/traceai_livekit/__init__.py index 403d15256..abeda5a53 100644 --- a/python/frameworks/livekit/traceai_livekit/__init__.py +++ b/python/frameworks/livekit/traceai_livekit/__init__.py @@ -19,7 +19,7 @@ flush_on_job_shutdown, ) -__version__ = "0.1.2" # x-release-please-version +__version__ = "0.1.3" # x-release-please-version __all__ = [ "enable_fi_attribute_mapping", diff --git a/python/frameworks/llama_index/CHANGELOG.md b/python/frameworks/llama_index/CHANGELOG.md index fc3b47200..5aacccbc9 100644 --- a/python/frameworks/llama_index/CHANGELOG.md +++ b/python/frameworks/llama_index/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.10] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.9 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.7] - 2025-06-10 ### Feature - Added support for ai-evaluation diff --git a/python/frameworks/llama_index/pyproject.toml b/python/frameworks/llama_index/pyproject.toml index 71b3d1bea..ffe316e0f 100644 --- a/python/frameworks/llama_index/pyproject.toml +++ b/python/frameworks/llama_index/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-llamaindex" -version = "0.1.9" +version = "0.1.10" description = "OpenTelemetry instrumentation for Llama Index" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/llama_index/traceai_llamaindex/version.py b/python/frameworks/llama_index/traceai_llamaindex/version.py index a99028c1f..b2b8e3d08 100644 --- a/python/frameworks/llama_index/traceai_llamaindex/version.py +++ b/python/frameworks/llama_index/traceai_llamaindex/version.py @@ -1 +1 @@ -__version__ = "0.1.9" # x-release-please-version +__version__ = "0.1.10" # x-release-please-version diff --git a/python/frameworks/mcp/CHANGELOG.md b/python/frameworks/mcp/CHANGELOG.md index 24783ca8e..19b8994b4 100644 --- a/python/frameworks/mcp/CHANGELOG.md +++ b/python/frameworks/mcp/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.3] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.2 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-06-05 ### Feature - Added support for MCP framework \ No newline at end of file diff --git a/python/frameworks/mcp/pyproject.toml b/python/frameworks/mcp/pyproject.toml index f37bc6df3..87409b451 100644 --- a/python/frameworks/mcp/pyproject.toml +++ b/python/frameworks/mcp/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-mcp" -version = "0.1.2" +version = "0.1.3" description = "OpenTelemetry instrumentation for MCP" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/mcp/traceai_mcp/version.py b/python/frameworks/mcp/traceai_mcp/version.py index 0d33eef3f..97c339acc 100644 --- a/python/frameworks/mcp/traceai_mcp/version.py +++ b/python/frameworks/mcp/traceai_mcp/version.py @@ -1 +1 @@ -__version__ = "0.1.2" # x-release-please-version +__version__ = "0.1.3" # x-release-please-version diff --git a/python/frameworks/milvus/CHANGELOG.md b/python/frameworks/milvus/CHANGELOG.md index 6dbf749ae..0b21ad3bd 100644 --- a/python/frameworks/milvus/CHANGELOG.md +++ b/python/frameworks/milvus/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-01-24 ### Added diff --git a/python/frameworks/milvus/pyproject.toml b/python/frameworks/milvus/pyproject.toml index 32bc05e03..692e2e38c 100644 --- a/python/frameworks/milvus/pyproject.toml +++ b/python/frameworks/milvus/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-milvus" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for Milvus vector database" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/milvus/traceai_milvus/version.py b/python/frameworks/milvus/traceai_milvus/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/milvus/traceai_milvus/version.py +++ b/python/frameworks/milvus/traceai_milvus/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/mistralai/CHANGELOG.md b/python/frameworks/mistralai/CHANGELOG.md index b8dda3584..a9db4fc56 100644 --- a/python/frameworks/mistralai/CHANGELOG.md +++ b/python/frameworks/mistralai/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.9] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.8 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.6] - 2025-05-29 ### Feature - Updated dependencies to the latest versions. diff --git a/python/frameworks/mistralai/pyproject.toml b/python/frameworks/mistralai/pyproject.toml index 2b2cc792a..fe1ba8bf9 100644 --- a/python/frameworks/mistralai/pyproject.toml +++ b/python/frameworks/mistralai/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-mistralai" -version = "0.1.8" +version = "0.1.9" description = "OpenTelemetry instrumentation for Mistral AI" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/mistralai/traceai_mistralai/version.py b/python/frameworks/mistralai/traceai_mistralai/version.py index bad05c2e5..a99028c1f 100644 --- a/python/frameworks/mistralai/traceai_mistralai/version.py +++ b/python/frameworks/mistralai/traceai_mistralai/version.py @@ -1 +1 @@ -__version__ = "0.1.8" # x-release-please-version +__version__ = "0.1.9" # x-release-please-version diff --git a/python/frameworks/mongodb-vector/CHANGELOG.md b/python/frameworks/mongodb-vector/CHANGELOG.md index 6d16d2191..be0ec1778 100644 --- a/python/frameworks/mongodb-vector/CHANGELOG.md +++ b/python/frameworks/mongodb-vector/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-01-24 ### Added diff --git a/python/frameworks/mongodb-vector/pyproject.toml b/python/frameworks/mongodb-vector/pyproject.toml index d94521b3e..29a395aa0 100644 --- a/python/frameworks/mongodb-vector/pyproject.toml +++ b/python/frameworks/mongodb-vector/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-mongodb" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for MongoDB Atlas Vector Search" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/mongodb-vector/traceai_mongodb/version.py b/python/frameworks/mongodb-vector/traceai_mongodb/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/mongodb-vector/traceai_mongodb/version.py +++ b/python/frameworks/mongodb-vector/traceai_mongodb/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/openai-agents/CHANGELOG.md b/python/frameworks/openai-agents/CHANGELOG.md index d9b97aa1a..ca4732a12 100644 --- a/python/frameworks/openai-agents/CHANGELOG.md +++ b/python/frameworks/openai-agents/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.7] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.6 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.3] - 2025-05-29 ### Feature - Updated dependencies to the latest versions. diff --git a/python/frameworks/openai-agents/pyproject.toml b/python/frameworks/openai-agents/pyproject.toml index a584d9a47..7b50c3967 100644 --- a/python/frameworks/openai-agents/pyproject.toml +++ b/python/frameworks/openai-agents/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-openai-agents" -version = "0.1.6" +version = "0.1.7" description = "OpenTelemetry instrumentation for OpenAI Agents" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/openai-agents/traceai_openai_agents/version.py b/python/frameworks/openai-agents/traceai_openai_agents/version.py index 80efe0760..1b09c6e18 100644 --- a/python/frameworks/openai-agents/traceai_openai_agents/version.py +++ b/python/frameworks/openai-agents/traceai_openai_agents/version.py @@ -1 +1 @@ -__version__ = "0.1.6" # x-release-please-version +__version__ = "0.1.7" # x-release-please-version diff --git a/python/frameworks/openai/CHANGELOG.md b/python/frameworks/openai/CHANGELOG.md index b3f2f8f24..e4238da5e 100644 --- a/python/frameworks/openai/CHANGELOG.md +++ b/python/frameworks/openai/CHANGELOG.md @@ -1,4 +1,4 @@ -## [Unreleased] +## [0.1.11] - 2026-10-29 ### Fixed - Embeddings respect `hide_inputs` for indexed input text and `hide_outputs` for both raw and indexed vectors, including with older fi-core releases. - Chat streams used with `with` / `async with` retain the traced iterator and finish once on exhaustion or early context exit; context-body errors mark an unfinished span as ERROR. diff --git a/python/frameworks/openai/pyproject.toml b/python/frameworks/openai/pyproject.toml index 6ca12234f..704849b98 100644 --- a/python/frameworks/openai/pyproject.toml +++ b/python/frameworks/openai/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-openai" -version = "0.1.10" +version = "0.1.11" description = "OpenTelemetry instrumentation for OpenAI" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/openai/traceai_openai/version.py b/python/frameworks/openai/traceai_openai/version.py index b2b8e3d08..8c39d1009 100644 --- a/python/frameworks/openai/traceai_openai/version.py +++ b/python/frameworks/openai/traceai_openai/version.py @@ -1 +1 @@ -__version__ = "0.1.10" # x-release-please-version +__version__ = "0.1.11" # x-release-please-version diff --git a/python/frameworks/pgvector/CHANGELOG.md b/python/frameworks/pgvector/CHANGELOG.md index e4acae362..ae792926c 100644 --- a/python/frameworks/pgvector/CHANGELOG.md +++ b/python/frameworks/pgvector/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-01-24 ### Added diff --git a/python/frameworks/pgvector/pyproject.toml b/python/frameworks/pgvector/pyproject.toml index 54dedc015..afa1b98b8 100644 --- a/python/frameworks/pgvector/pyproject.toml +++ b/python/frameworks/pgvector/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-pgvector" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for pgvector PostgreSQL extension" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/pgvector/traceai_pgvector/version.py b/python/frameworks/pgvector/traceai_pgvector/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/pgvector/traceai_pgvector/version.py +++ b/python/frameworks/pgvector/traceai_pgvector/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/pinecone/CHANGELOG.md b/python/frameworks/pinecone/CHANGELOG.md index 464f95d3a..2886e2dc4 100644 --- a/python/frameworks/pinecone/CHANGELOG.md +++ b/python/frameworks/pinecone/CHANGELOG.md @@ -2,6 +2,11 @@ All notable changes to traceAI-pinecone will be documented in this file. +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-01-24 ### Added diff --git a/python/frameworks/pinecone/pyproject.toml b/python/frameworks/pinecone/pyproject.toml index 3dec2db0a..1848e7a74 100644 --- a/python/frameworks/pinecone/pyproject.toml +++ b/python/frameworks/pinecone/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-pinecone" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for Pinecone vector database" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/pinecone/traceai_pinecone/version.py b/python/frameworks/pinecone/traceai_pinecone/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/pinecone/traceai_pinecone/version.py +++ b/python/frameworks/pinecone/traceai_pinecone/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/pipecat/CHANGELOG.md b/python/frameworks/pipecat/CHANGELOG.md index 1bdd33469..09083a28b 100644 --- a/python/frameworks/pipecat/CHANGELOG.md +++ b/python/frameworks/pipecat/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.2] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.1 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-08-19 ### Feature - Added support for Pipecat Instrumentation diff --git a/python/frameworks/pipecat/pyproject.toml b/python/frameworks/pipecat/pyproject.toml index c01644c2c..22eca5a46 100644 --- a/python/frameworks/pipecat/pyproject.toml +++ b/python/frameworks/pipecat/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-pipecat" -version = "0.1.1" +version = "0.1.2" description = "OpenTelemetry instrumentation for Pipecat" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/pipecat/traceai_pipecat/__init__.py b/python/frameworks/pipecat/traceai_pipecat/__init__.py index dceff4e2f..ec1cc7526 100644 --- a/python/frameworks/pipecat/traceai_pipecat/__init__.py +++ b/python/frameworks/pipecat/traceai_pipecat/__init__.py @@ -18,7 +18,7 @@ enable_http_attribute_mapping, ) -__version__ = "0.1.1" # x-release-please-version +__version__ = "0.1.2" # x-release-please-version __all__ = [ "enable_fi_attribute_mapping", diff --git a/python/frameworks/pipecat/traceai_pipecat/version.py b/python/frameworks/pipecat/traceai_pipecat/version.py index 34d76ee9e..0d33eef3f 100644 --- a/python/frameworks/pipecat/traceai_pipecat/version.py +++ b/python/frameworks/pipecat/traceai_pipecat/version.py @@ -1 +1 @@ -__version__ = "0.1.1" # x-release-please-version +__version__ = "0.1.2" # x-release-please-version diff --git a/python/frameworks/portkey/CHANGELOG.md b/python/frameworks/portkey/CHANGELOG.md index e69de29bb..16425b06d 100644 --- a/python/frameworks/portkey/CHANGELOG.md +++ b/python/frameworks/portkey/CHANGELOG.md @@ -0,0 +1,6 @@ +# Changelog + +## [0.1.3] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.2 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. diff --git a/python/frameworks/portkey/pyproject.toml b/python/frameworks/portkey/pyproject.toml index 01b532f2a..c1f3acbb6 100644 --- a/python/frameworks/portkey/pyproject.toml +++ b/python/frameworks/portkey/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-portkey" -version = "0.1.2" +version = "0.1.3" description = "OpenTelemetry instrumentation for Portkey AI" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/portkey/traceai_portkey/version.py b/python/frameworks/portkey/traceai_portkey/version.py index 0cb50a5ae..499255216 100644 --- a/python/frameworks/portkey/traceai_portkey/version.py +++ b/python/frameworks/portkey/traceai_portkey/version.py @@ -1 +1 @@ -__version__ = "0.1.2" # x-release-please-version \ No newline at end of file +__version__ = "0.1.3" # x-release-please-version \ No newline at end of file diff --git a/python/frameworks/qdrant/CHANGELOG.md b/python/frameworks/qdrant/CHANGELOG.md index 6d4da0242..6722ded4f 100644 --- a/python/frameworks/qdrant/CHANGELOG.md +++ b/python/frameworks/qdrant/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-01-24 ### Added diff --git a/python/frameworks/qdrant/pyproject.toml b/python/frameworks/qdrant/pyproject.toml index ce7135b75..d1c5d3327 100644 --- a/python/frameworks/qdrant/pyproject.toml +++ b/python/frameworks/qdrant/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-qdrant" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for Qdrant vector database" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/qdrant/traceai_qdrant/version.py b/python/frameworks/qdrant/traceai_qdrant/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/qdrant/traceai_qdrant/version.py +++ b/python/frameworks/qdrant/traceai_qdrant/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/redis-vector/CHANGELOG.md b/python/frameworks/redis-vector/CHANGELOG.md index ce9be041e..9f0752b6a 100644 --- a/python/frameworks/redis-vector/CHANGELOG.md +++ b/python/frameworks/redis-vector/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-01-24 ### Added diff --git a/python/frameworks/redis-vector/pyproject.toml b/python/frameworks/redis-vector/pyproject.toml index 57969fdc5..d7096f6a8 100644 --- a/python/frameworks/redis-vector/pyproject.toml +++ b/python/frameworks/redis-vector/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-redis" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for Redis Vector Search (RediSearch/RedisVL)" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/redis-vector/traceai_redis/version.py b/python/frameworks/redis-vector/traceai_redis/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/redis-vector/traceai_redis/version.py +++ b/python/frameworks/redis-vector/traceai_redis/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/smolagents/CHANGELOG.md b/python/frameworks/smolagents/CHANGELOG.md index 401872487..503633b2b 100644 --- a/python/frameworks/smolagents/CHANGELOG.md +++ b/python/frameworks/smolagents/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.6] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.5 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.3] - 2025-05-29 ### Feature - Updated dependencies to the latest versions. diff --git a/python/frameworks/smolagents/pyproject.toml b/python/frameworks/smolagents/pyproject.toml index 8b56dbf32..f279bc350 100644 --- a/python/frameworks/smolagents/pyproject.toml +++ b/python/frameworks/smolagents/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-smolagents" -version = "0.1.5" +version = "0.1.6" description = "OpenTelemetry instrumentation for Smolagents" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/smolagents/traceai_smolagents/version.py b/python/frameworks/smolagents/traceai_smolagents/version.py index 79597ce75..80efe0760 100644 --- a/python/frameworks/smolagents/traceai_smolagents/version.py +++ b/python/frameworks/smolagents/traceai_smolagents/version.py @@ -1 +1 @@ -__version__ = "0.1.5" # x-release-please-version +__version__ = "0.1.6" # x-release-please-version diff --git a/python/frameworks/together/CHANGELOG.md b/python/frameworks/together/CHANGELOG.md new file mode 100644 index 000000000..9ea891f1f --- /dev/null +++ b/python/frameworks/together/CHANGELOG.md @@ -0,0 +1,7 @@ +# Changelog + +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + diff --git a/python/frameworks/together/pyproject.toml b/python/frameworks/together/pyproject.toml index 40152f560..7fb9245a5 100644 --- a/python/frameworks/together/pyproject.toml +++ b/python/frameworks/together/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-together" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for Together AI - chat, completions, and embeddings" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/together/traceai_together/version.py b/python/frameworks/together/traceai_together/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/together/traceai_together/version.py +++ b/python/frameworks/together/traceai_together/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/vertexai/CHANGELOG.md b/python/frameworks/vertexai/CHANGELOG.md index 8095ebedb..4d7a80efc 100644 --- a/python/frameworks/vertexai/CHANGELOG.md +++ b/python/frameworks/vertexai/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.11] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.10 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.8] - 2025-07-08 ### Feature - Added support for Vertex AI's new modals diff --git a/python/frameworks/vertexai/pyproject.toml b/python/frameworks/vertexai/pyproject.toml index 839a292ba..20988231c 100644 --- a/python/frameworks/vertexai/pyproject.toml +++ b/python/frameworks/vertexai/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-vertexai" -version = "0.1.10" +version = "0.1.11" description = "OpenTelemetry instrumentation for Vertex AI" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/vertexai/traceai_vertexai/version.py b/python/frameworks/vertexai/traceai_vertexai/version.py index b2b8e3d08..8c39d1009 100644 --- a/python/frameworks/vertexai/traceai_vertexai/version.py +++ b/python/frameworks/vertexai/traceai_vertexai/version.py @@ -1 +1 @@ -__version__ = "0.1.10" # x-release-please-version +__version__ = "0.1.11" # x-release-please-version diff --git a/python/frameworks/weaviate/CHANGELOG.md b/python/frameworks/weaviate/CHANGELOG.md index d50cce6e1..cf3a232ef 100644 --- a/python/frameworks/weaviate/CHANGELOG.md +++ b/python/frameworks/weaviate/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-01-24 ### Added diff --git a/python/frameworks/weaviate/pyproject.toml b/python/frameworks/weaviate/pyproject.toml index d216bbe2b..767027e1f 100644 --- a/python/frameworks/weaviate/pyproject.toml +++ b/python/frameworks/weaviate/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-weaviate" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for Weaviate vector database" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/weaviate/traceai_weaviate/version.py b/python/frameworks/weaviate/traceai_weaviate/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/weaviate/traceai_weaviate/version.py +++ b/python/frameworks/weaviate/traceai_weaviate/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/python/frameworks/xai/CHANGELOG.md b/python/frameworks/xai/CHANGELOG.md new file mode 100644 index 000000000..9ea891f1f --- /dev/null +++ b/python/frameworks/xai/CHANGELOG.md @@ -0,0 +1,7 @@ +# Changelog + +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. + diff --git a/python/frameworks/xai/pyproject.toml b/python/frameworks/xai/pyproject.toml index 4f38b0fbb..67eb8b0cc 100644 --- a/python/frameworks/xai/pyproject.toml +++ b/python/frameworks/xai/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "traceAI-xai" -version = "0.1.0" +version = "0.1.1" description = "OpenTelemetry instrumentation for xAI (Grok)" authors = ["Future AGI "] readme = "README.md" diff --git a/python/frameworks/xai/traceai_xai/version.py b/python/frameworks/xai/traceai_xai/version.py index 75716eb9a..34d76ee9e 100644 --- a/python/frameworks/xai/traceai_xai/version.py +++ b/python/frameworks/xai/traceai_xai/version.py @@ -1 +1 @@ -__version__ = "0.1.0" # x-release-please-version +__version__ = "0.1.1" # x-release-please-version diff --git a/typescript/packages/traceai_llamaindex/CHANGELOG.md b/typescript/packages/traceai_llamaindex/CHANGELOG.md index 70b92a619..ec2dd1135 100644 --- a/typescript/packages/traceai_llamaindex/CHANGELOG.md +++ b/typescript/packages/traceai_llamaindex/CHANGELOG.md @@ -1,3 +1,10 @@ + + +## [0.1.2] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.1 was uploaded to npm; one-time bootstrap patch for the automated release pipeline. + ## [0.1.0] - 2025-08-27 ### Feature - Added support for LlamaIndex Typescript instrumentation diff --git a/typescript/packages/traceai_llamaindex/package.json b/typescript/packages/traceai_llamaindex/package.json index e6572dcea..eb8de6460 100644 --- a/typescript/packages/traceai_llamaindex/package.json +++ b/typescript/packages/traceai_llamaindex/package.json @@ -1,6 +1,6 @@ { "name": "@traceai/llamaindex", - "version": "0.1.1", + "version": "0.1.2", "description": "OpenTelemetry instrumentation for LlamaIndex", "main": "./dist/src/index.js", "module": "./dist/esm/index.js", diff --git a/typescript/packages/traceai_mcp/CHANGELOG.md b/typescript/packages/traceai_mcp/CHANGELOG.md new file mode 100644 index 000000000..360691545 --- /dev/null +++ b/typescript/packages/traceai_mcp/CHANGELOG.md @@ -0,0 +1,7 @@ +# Changelog + +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to npm; one-time bootstrap patch for the automated release pipeline. + diff --git a/typescript/packages/traceai_mcp/package.json b/typescript/packages/traceai_mcp/package.json index c7513c04b..234b8b004 100644 --- a/typescript/packages/traceai_mcp/package.json +++ b/typescript/packages/traceai_mcp/package.json @@ -1,6 +1,6 @@ { "name": "@traceai/mcp", - "version": "0.1.0", + "version": "0.1.1", "description": "OpenTelemetry instrumentation for MCP", "main": "./dist/src/index.js", "module": "./dist/esm/index.js", diff --git a/typescript/packages/traceai_vercel/CHANGELOG.md b/typescript/packages/traceai_vercel/CHANGELOG.md new file mode 100644 index 000000000..360691545 --- /dev/null +++ b/typescript/packages/traceai_vercel/CHANGELOG.md @@ -0,0 +1,7 @@ +# Changelog + +## [0.1.1] - 2026-10-29 + +### Fixed +- Publish package changes merged after 0.1.0 was uploaded to npm; one-time bootstrap patch for the automated release pipeline. + diff --git a/typescript/packages/traceai_vercel/package.json b/typescript/packages/traceai_vercel/package.json index dc0c012f1..0390a222a 100644 --- a/typescript/packages/traceai_vercel/package.json +++ b/typescript/packages/traceai_vercel/package.json @@ -1,6 +1,6 @@ { "name": "@traceai/vercel", - "version": "0.1.0", + "version": "0.1.1", "description": "OpenTelemetry instrumentation for Vercel", "main": "./dist/src/index.js", "module": "./dist/esm/index.js", From 896d14eb530ea38d449f8a4b14b523530b17d2e2 Mon Sep 17 00:00:00 2001 From: Nikhil Pareek <8347993+nik13@users.noreply.github.com> Date: Thu, 29 Oct 2026 09:45:44 -0700 Subject: [PATCH 06/11] fix(release): cover core manifests and stage npm dependencies Use explicit non-recursive core version updaters so manifest-only dependency fixes release safely. Stage exact transitive workspace tarballs for clean-install dry runs, then publish all npm packages sequentially in dependency order. Cover backdated branch merges, align the real strategy test with the deployed action, and fix bootstrap changelog whitespace. Co-Authored-By: Claude Code --- .github/release/bootstrap-audit.json | 2 +- .github/release/bootstrap_audit.py | 5 +- .github/release/npm_release.py | 153 ++++++++++++++++++ .github/release/release_plan.py | 14 +- .github/release/test_bootstrap_audit.py | 45 +++++- .github/release/test_npm_release.py | 115 +++++++++++++ .github/release/test_release_extensions.py | 21 ++- .github/release/test_release_strategies.cjs | 45 +++++- .github/release/workflow_plan.py | 9 +- .github/workflows/release-typescript.yml | 101 +++--------- .github/workflows/release.yml | 43 +---- .release-please-manifest.json | 2 +- RELEASING.md | 10 +- python/frameworks/cerebras/CHANGELOG.md | 1 - python/frameworks/cohere/CHANGELOG.md | 1 - python/frameworks/deepseek/CHANGELOG.md | 1 - python/frameworks/fireworks/CHANGELOG.md | 1 - python/frameworks/together/CHANGELOG.md | 1 - python/frameworks/xai/CHANGELOG.md | 1 - release-please-config.json | 40 ++++- typescript/packages/traceai_mcp/CHANGELOG.md | 1 - .../packages/traceai_vercel/CHANGELOG.md | 1 - 22 files changed, 457 insertions(+), 156 deletions(-) create mode 100644 .github/release/npm_release.py create mode 100644 .github/release/test_npm_release.py diff --git a/.github/release/bootstrap-audit.json b/.github/release/bootstrap-audit.json index 451c73d65..ebc118743 100644 --- a/.github/release/bootstrap-audit.json +++ b/.github/release/bootstrap-audit.json @@ -1119,7 +1119,7 @@ "version": "1.2.1", "manifest": "python/pyproject.toml", "dir": "python", - "release_path": "python/fi_instrumentation", + "release_path": "python", "registry_url": "https://pypi.org/pypi/fi-instrumentation-otel/json", "uploaded_at": null, "status": "unpublished_current_version" diff --git a/.github/release/bootstrap_audit.py b/.github/release/bootstrap_audit.py index b14e7501b..23190f4f7 100644 --- a/.github/release/bootstrap_audit.py +++ b/.github/release/bootstrap_audit.py @@ -43,7 +43,7 @@ def manifests(root: Path, ref: str) -> list[dict]: directory = str(Path(file).parent) out.append({"ecosystem": ecosystem, "name": pkg["name"], "version": pkg["version"], "manifest": file, "dir": directory, - "release_path": "python/fi_instrumentation" if directory == "python" else directory}) + "release_path": directory}) return out @@ -77,6 +77,9 @@ def package_history(root: Path, ref: str, package: dict, since: str) -> list[dic # Core doesn't own sibling SDKs. Retain its own source, tests, examples, # pyproject/lockfile and docs, rather than attributing every SDK to core. paths += [":(exclude)python/frameworks", ":(exclude)python/traceai"] + # A branch may be authored (and committed) before its registry upload. + # Compare first-parent landing/merge committer dates, not branch author dates. + # Filter without pruning traversal when later first-parent dates go backwards. text = git(root, "log", "--first-parent", f"--since-as-filter={since}", "--format=%H%x09%cI%x09%s", ref, "--", *paths) return [dict(zip(("sha", "committed_at", "subject"), line.split("\t", 2))) diff --git a/.github/release/npm_release.py b/.github/release/npm_release.py new file mode 100644 index 000000000..85b813e62 --- /dev/null +++ b/.github/release/npm_release.py @@ -0,0 +1,153 @@ +#!/usr/bin/env python3 +"""Stage exact workspace tarballs, clean-install them, then deliver in DAG order. + +The three phases keep credentials out of build and install scripts. Only publish +mutates a registry or GitHub; stage and verify work with unpublished dependencies. +""" +from __future__ import annotations + +import argparse +import json +import os +from pathlib import Path +import subprocess +import sys +import time + +from release_plan import REPO_ROOT, typescript_packages + + +def topological(packages: list[dict]) -> list[dict]: + """Stable dependency-first order, with a hard failure for a dependency cycle.""" + pending = {p["name"]: p for p in packages} + if len(pending) != len(packages): + raise ValueError("Duplicate npm package in release plan") + result = [] + while pending: + ready = sorted(name for name, p in pending.items() + if not (set(p.get("workspace_dependencies", [])) & pending.keys())) + if not ready: + raise ValueError("Cyclic npm workspace dependencies: " + ", ".join(sorted(pending))) + for name in ready: + result.append(pending.pop(name)) + return result + + +def dependency_closure(packages: list[dict], inventory: list[dict]) -> list[dict]: + by_name = {p["name"]: p for p in inventory} + needed = set() + + def visit(name): + if name in needed: + return + if name not in by_name: + raise ValueError(f"Workspace dependency is not a publishable package: {name}") + needed.add(name) + for dep in by_name[name].get("workspace_dependencies", []): + visit(dep) + + for package in packages: + visit(package["name"]) + if by_name[package["name"]]["version"] != package["version"]: + raise ValueError(f"Planned npm version differs from package.json: {package['name']}") + return topological([by_name[name] for name in sorted(needed)]) + + +def tarball_dir(dist: Path, package: dict) -> Path: + return dist / package["name"].lstrip("@").replace("/", "-") + + +def tarball(dist: Path, package: dict) -> Path: + files = list(tarball_dir(dist, package).glob("*.tgz")) + if len(files) != 1: + raise ValueError(f"Expected exactly one staged tarball for {package['name']}, found {len(files)}") + return files[0].resolve() + + +def stage(root: Path, packages: list[dict], dist: Path) -> None: + closure = dependency_closure(packages, typescript_packages(root)) + filters = [arg for p in packages for arg in ("--filter", p["name"] + "...")] + subprocess.run(["pnpm", *filters, "run", "build"], cwd=root / "typescript", check=True) + for package in closure: + dest = tarball_dir(dist, package) + dest.mkdir(parents=True, exist_ok=False) + subprocess.run(["pnpm", "--filter", package["name"], "pack", "--pack-destination", str(dest)], + cwd=root / "typescript", check=True) + tarball(dist, package) + + +def verify(root: Path, packages: list[dict], dist: Path, smoke: Path, *, offline: bool = False) -> None: + inventory = typescript_packages(root) + for package in packages: + closure = dependency_closure([package], inventory) + directory = tarball_dir(smoke, package) + directory.mkdir(parents=True, exist_ok=False) + (directory / "package.json").write_text('{"private":true}\n') + command = ["npm", "install", "--no-audit", "--no-fund"] + if offline: + command.append("--offline") + # Install all exact dependency tarballs together, not merely the target. + # npm still checks semver ranges and installs real external dependencies. + subprocess.run([*command, *(str(tarball(dist, p)) for p in closure)], cwd=directory, check=True) + for staged in closure: + installed = json.loads((directory / "node_modules" / staged["name"] / "package.json").read_text()) + if installed["version"] != staged["version"]: + raise ValueError(f"Installed {staged['name']} != staged workspace version {staged['version']}") + env = {**os.environ, "NAME": package["name"]} + subprocess.run(["node", "-e", "const m = require(process.env.NAME); console.log('require ok:', Object.keys(m).length, 'exports')"], + cwd=directory, env=env, check=True) + subprocess.run(["node", "--input-type=module", "-e", "import(process.env.NAME).then(m => console.log('import ok:', Object.keys(m).length, 'exports'))"], + cwd=directory, env=env, check=True) + + +def wait_until_served(name: str, version: str) -> None: + for attempt in range(20): + result = subprocess.run(["npm", "view", f"{name}@{version}", "version"], text=True, capture_output=True) + if result.returncode == 0 and result.stdout.strip() == version: + return + if attempt < 19: + print(f"{name}@{version}: not served yet (attempt {attempt + 1}/20)", flush=True) + time.sleep(30) + raise RuntimeError(f"npm did not serve {name}@{version}; include unfinished dependencies in the release plan") + + +def publish(root: Path, packages: list[dict], dist: Path) -> None: + inventory = {p["name"]: p for p in typescript_packages(root)} + for package in topological(packages): + # This also protects a manually selected consumer whose dependency was + # omitted from --only: never upload it against a missing dependency. + for dep in inventory[package["name"]].get("workspace_dependencies", []): + wait_until_served(dep, inventory[dep]["version"]) + if not package.get("registry_published"): + subprocess.run(["npm", "publish", str(tarball(dist, package)), "--access", "public", "--provenance"], + cwd=root / "typescript", check=True) + wait_until_served(package["name"], package["version"]) + env = {**os.environ, **{key: str(package.get(field) or "") for key, field in + (("NAME", "name"), ("VERSION", "version"), ("TAG", "tag"), ("CHANGELOG", "changelog"))}, + "REGISTRY_PUBLISHED": str(bool(package.get("registry_published"))).lower()} + subprocess.run([sys.executable, str(Path(__file__).with_name("github_release.py")), + "--install", f"npm install {package['name']}@{package['version']}", + "--dist", str(tarball_dir(dist, package))], cwd=root, env=env, check=True) + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("phase", choices=("stage", "verify", "publish")) + parser.add_argument("--packages", required=True, help="JSON array from the read-only release planner") + parser.add_argument("--root", type=Path, default=REPO_ROOT) + parser.add_argument("--dist", type=Path, required=True) + parser.add_argument("--smoke", type=Path) + args = parser.parse_args() + packages = topological(json.loads(args.packages)) + if not packages: + return + if args.phase == "verify": + if args.smoke is None: + parser.error("verify requires --smoke") + verify(args.root, packages, args.dist, args.smoke) + else: + {"stage": stage, "publish": publish}[args.phase](args.root, packages, args.dist) + + +if __name__ == "__main__": + main() diff --git a/.github/release/release_plan.py b/.github/release/release_plan.py index 2f6e54d1d..ecd0daf32 100644 --- a/.github/release/release_plan.py +++ b/.github/release/release_plan.py @@ -69,9 +69,9 @@ def python_packages(root: Path = REPO_ROOT) -> list[dict]: out.append({ "ecosystem": "python", "name": name, "version": version, "dir": str(d.relative_to(root)), "import_name": module, - # Python strategy recursively discovers version.py; scope the root core to - # its code so it cannot overwrite every sibling SDK's runtime version. - "release_path": "python/fi_instrumentation" if d == root / "python" else str(d.relative_to(root)), + # Core uses the non-recursive simple strategy with explicit updaters. + # The python/ root catches manifest-only dependency/security fixes too. + "release_path": str(d.relative_to(root)), "tag": f"{pypi_normalize(name)}-v{version}", "core": name in PYTHON_CORE, "changelog": str((d / "CHANGELOG.md").relative_to(root)) if (d / "CHANGELOG.md").is_file() else None, "declared": declared_versions(d, module), @@ -81,7 +81,9 @@ def python_packages(root: Path = REPO_ROOT) -> list[dict]: def typescript_packages(root: Path = REPO_ROOT) -> list[dict]: out = [] - for f in sorted((root / "typescript" / "packages").glob("*/package.json")): + files = sorted((root / "typescript" / "packages").glob("*/package.json")) + names = {json.loads(f.read_text()).get("name") for f in files} + for f in files: pkg = json.loads(f.read_text()) if pkg.get("private") or not pkg.get("name") or not pkg.get("version"): continue @@ -90,6 +92,10 @@ def typescript_packages(root: Path = REPO_ROOT) -> list[dict]: "ecosystem": "typescript", "name": name, "version": pkg["version"], "dir": str(d.relative_to(root)), "tag": f"npm-{name.lstrip('@').replace('/', '-')}-v{pkg['version']}", + # Include internal edges even when declared with an ordinary semver + # range, not only workspace:*. Dev-only edges do not affect delivery. + "workspace_dependencies": sorted({dep for section in ("dependencies", "optionalDependencies", "peerDependencies") + for dep in pkg.get(section, {}) if dep in names}), "core": name in TS_CORE, "changelog": str((d / "CHANGELOG.md").relative_to(root)) if (d / "CHANGELOG.md").is_file() else None, }) diff --git a/.github/release/test_bootstrap_audit.py b/.github/release/test_bootstrap_audit.py index 187c829ef..be8003a5a 100644 --- a/.github/release/test_bootstrap_audit.py +++ b/.github/release/test_bootstrap_audit.py @@ -1,5 +1,7 @@ """Regression coverage for the one-time unpublished-fix audit (no network).""" import json +import os +import subprocess from pathlib import Path import sys import tempfile @@ -55,6 +57,47 @@ def test_history_uses_merge_dates_and_excludes_sibling_sdk_for_core(self): self.assertIn("--since-as-filter=date", args) self.assertIn(":(exclude)python/frameworks", args) + def test_real_merge_counts_backdated_branch_commits_by_first_parent_landing_time(self): + with tempfile.TemporaryDirectory() as d: + root = Path(d) + + def git(*args, date=None): + env = {**os.environ, 'GIT_CONFIG_NOSYSTEM': '1', + 'GIT_AUTHOR_NAME': 'Release test', 'GIT_AUTHOR_EMAIL': 'test@example.invalid', + 'GIT_COMMITTER_NAME': 'Release test', 'GIT_COMMITTER_EMAIL': 'test@example.invalid'} + if date: + env.update(GIT_AUTHOR_DATE=date, GIT_COMMITTER_DATE=date) + return subprocess.check_output(['git', '-C', str(root), *args], text=True, env=env).strip() + + git('init', '-b', 'main') + file = root / self.package['manifest'] + file.parent.mkdir(parents=True) + file.write_text('[project]\nname="traceAI-openai"\nversion="0.1.10"\n') + git('add', '.'); git('commit', '-m', 'initial', date='2020-01-01T00:00:00Z') + git('checkout', '-b', 'old-branch') + (file.parent / 'fix.py').write_text('fixed = True\n') + git('add', '.'); git('commit', '-m', 'fix: old authored change', date='2020-01-02T00:00:00Z') + old_sha = git('rev-parse', 'HEAD') + git('checkout', 'main') + (root / 'README').write_text('main\n') + git('add', '.'); git('commit', '-m', 'advance main', date='2026-03-09T00:00:00Z') + # The package's current version uploaded on March 10. The branch's + # author AND committer dates are earlier; it only lands on March 11. + git('merge', '--no-ff', 'old-branch', '-m', 'Merge old branch', date='2026-03-11T00:00:00Z') + merge_sha = git('rev-parse', 'HEAD') + # Also backdate the next first-parent commit: --since-as-filter must + # traverse through it, rather than stopping early like --since. + (root / 'README').write_text('bootstrap\n') + git('add', '.'); git('commit', '-m', 'bootstrap', date='2026-03-09T00:00:00Z') + baseline = git('rev-parse', 'HEAD') + history = bootstrap_audit.package_history(root, baseline, self.package, '2026-03-10T13:54:41Z') + self.assertEqual([p['sha'] for p in history], [merge_sha]) + self.assertNotIn(old_sha, [p['sha'] for p in history]) + self.assertEqual(history[0]['committed_at'].replace('Z', '+00:00'), '2026-03-11T00:00:00+00:00') + with patch.object(bootstrap_audit, '_get_json', return_value=self.registry): + audit = bootstrap_audit.audit_package(root, baseline, self.package, {}) + self.assertEqual((audit['status'], audit['next_version']), ('patch_required', '0.1.11')) + def test_one_time_floor_allows_later_releases_but_catches_stranded_versions(self): p = {**self.package, "status": "patch_required", "next_version": "0.1.11"} with tempfile.TemporaryDirectory() as directory: @@ -71,7 +114,7 @@ def test_manifest_inventory_reads_ref_without_importing_package_code(self): with patch.object(bootstrap_audit, "git", side_effect=[files, '[project]\nname="core"\nversion="1.0.0"', '{"name":"a","version":"0.1.0"}', '{"name":"private","version":"1.0.0","private":true}']): packages = bootstrap_audit.manifests(Path("/tmp"), "baseline") self.assertEqual([p["name"] for p in packages], ["core", "a"]) - self.assertEqual(packages[0]["release_path"], "python/fi_instrumentation") + self.assertEqual(packages[0]["release_path"], "python") def test_committed_audit_covers_bootstrap_snapshot_and_all_bumps(self): # No history dependency: Actions checks out only the latest commit. diff --git a/.github/release/test_npm_release.py b/.github/release/test_npm_release.py new file mode 100644 index 000000000..9a852703b --- /dev/null +++ b/.github/release/test_npm_release.py @@ -0,0 +1,115 @@ +"""No registry writes. Real offline npm pack/install plus DAG/delivery regressions.""" +import json +import os +from pathlib import Path +import shutil +import subprocess +import sys +import tempfile +import unittest +from unittest.mock import patch + +sys.path.insert(0, str(Path(__file__).parent)) +import npm_release +import release_plan + + +class NpmTests(unittest.TestCase): + def test_real_graph_orders_vercel_before_mastra_and_all_other_edges(self): + packages = release_plan.typescript_packages() + ordered = [p['name'] for p in npm_release.topological(packages)] + self.assertLess(ordered.index('@traceai/vercel'), ordered.index('@traceai/mastra')) + for package in packages: + for dep in package['workspace_dependencies']: + self.assertLess(ordered.index(dep), ordered.index(package['name'])) + + def test_internal_semver_optional_and_peer_edges_are_detected_not_dev_edges(self): + with tempfile.TemporaryDirectory() as d: + root = Path(d) + for name, fields in [('a', {'dependencies': {'b': '^1.0.0'}, 'optionalDependencies': {'c': 'workspace:*'}, + 'peerDependencies': {'d': '^1.0.0'}, 'devDependencies': {'e': 'workspace:*'}}), + *[(name, {}) for name in 'bcde']]: + directory = root / 'typescript/packages' / name + directory.mkdir(parents=True) + (directory / 'package.json').write_text(json.dumps({'name': name, 'version': '1.0.0', **fields})) + self.assertEqual(release_plan.typescript_packages(root)[0]['workspace_dependencies'], ['b', 'c', 'd']) + + def test_arbitrary_depth_cycle_and_duplicate_plans(self): + packages = [{'name': n, 'workspace_dependencies': [dep] if dep else []} + for n, dep in [('d', 'c'), ('b', 'a'), ('a', None), ('c', 'b')]] + self.assertEqual([p['name'] for p in npm_release.topological(packages)], list('abcd')) + packages[2]['workspace_dependencies'] = ['d'] + with self.assertRaisesRegex(ValueError, 'Cyclic'): + npm_release.topological(packages) + with self.assertRaisesRegex(ValueError, 'Duplicate'): + npm_release.topological([{'name': 'a'}, {'name': 'a'}]) + + def test_consumer_only_plan_stages_transitive_dependencies_and_checks_versions(self): + packages = [{'name': n, 'version': '9.9.9', 'workspace_dependencies': [dep] if dep else []} + for n, dep in [('core', 'semantic'), ('semantic', None), ('consumer', 'core')]] + closure = npm_release.dependency_closure([packages[-1]], packages) + self.assertEqual([p['name'] for p in closure], ['semantic', 'core', 'consumer']) + with self.assertRaisesRegex(ValueError, 'differs'): + npm_release.dependency_closure([{**packages[-1], 'version': '1.0.0'}], packages) + with self.assertRaisesRegex(ValueError, 'not a publishable'): + npm_release.dependency_closure([{'name': 'missing'}], packages) + + @unittest.skipUnless(shutil.which('npm') and shutil.which('node'), 'offline integration requires Node/npm') + def test_real_offline_clean_install_unpublished_transitive_workspace_tarballs(self): + with tempfile.TemporaryDirectory() as d: + root = Path(d) + packages = [] + # These deliberately unpublished names/versions can never come from + # the network: --offline plus an empty npm cache enforce that. + specs = [('semantic', []), ('core', ['semantic']), ('vercel', ['semantic']), ('consumer', ['core', 'vercel'])] + env = {**os.environ, 'npm_config_cache': str(root / 'empty-cache'), 'npm_config_update_notifier': 'false'} + for name, dependencies in specs: + full = '@traceai-release-test/' + name + source = root / 'typescript/packages' / name + source.mkdir(parents=True) + manifest = {'name': full, 'version': '999.0.0', 'main': 'index.js', + 'dependencies': {'@traceai-release-test/' + dep: '^999.0.0' for dep in dependencies}} + (source / 'package.json').write_text(json.dumps(manifest)) + (source / 'index.js').write_text('exports.ok = true;\n' + '\n'.join(f'require("@traceai-release-test/{dep}");' for dep in dependencies)) + package = {'name': full, 'version': '999.0.0'} + dest = npm_release.tarball_dir(root / 'dist', package) + dest.mkdir(parents=True) + subprocess.run(['npm', 'pack', '--offline', '--ignore-scripts', '--pack-destination', str(dest)], + cwd=source, env=env, check=True, capture_output=True) + packages.append(package) + with patch.dict(os.environ, env): + # Only consumer is requested, but both core and the non-core + # dependency Vercel must be installed from the staged artifacts. + npm_release.verify(root, [packages[-1]], root / 'dist', root / 'smoke', offline=True) + installed = npm_release.tarball_dir(root / 'smoke', packages[-1]) / 'node_modules' + for package in packages: + self.assertEqual(json.loads((installed / package['name'] / 'package.json').read_text())['version'], '999.0.0') + + def test_publish_waits_for_every_dependency_before_uploading_consumer(self): + packages = [{'name': n, 'version': '1.0.0', 'workspace_dependencies': deps, 'tag': n, + 'registry_published': n == 'consumer'} + for n, deps in [('consumer', ['vercel', 'core']), ('vercel', []), ('core', [])]] + events = [] + with patch.object(npm_release, 'typescript_packages', return_value=packages), \ + patch.object(npm_release, 'wait_until_served', side_effect=lambda n, v: events.append(('served', n))), \ + patch.object(npm_release, 'tarball', side_effect=lambda dist, p: dist / (p['name'] + '.tgz')), \ + patch.object(npm_release.subprocess, 'run', side_effect=lambda cmd, **kw: events.append(('publish' if cmd[1] == 'publish' else 'release', cmd[2]))): + npm_release.publish(Path('/fixture'), packages, Path('/dist')) + self.assertLess(events.index(('served', 'vercel')), events.index(('served', 'consumer'))) + self.assertLess(events.index(('served', 'core')), events.index(('served', 'consumer'))) + self.assertNotIn(('publish', '/dist/consumer.tgz'), events, 'reconciliation never reuploads') + self.assertEqual([e[1] for e in events if e[0] == 'publish'], ['/dist/core.tgz', '/dist/vercel.tgz']) + + def test_omitted_unpublished_dependency_blocks_delivery_before_upload(self): + inventory = [{'name': 'consumer', 'version': '1.0.0', 'workspace_dependencies': ['core']}, + {'name': 'core', 'version': '1.0.0'}] + with patch.object(npm_release, 'typescript_packages', return_value=inventory), \ + patch.object(npm_release, 'wait_until_served', side_effect=RuntimeError('not served')), \ + patch.object(npm_release.subprocess, 'run') as run: + with self.assertRaisesRegex(RuntimeError, 'not served'): + npm_release.publish(Path('/fixture'), [inventory[0]], Path('/dist')) + run.assert_not_called() + + +if __name__ == '__main__': + unittest.main() diff --git a/.github/release/test_release_extensions.py b/.github/release/test_release_extensions.py index c6b16aad3..a66b960c6 100644 --- a/.github/release/test_release_extensions.py +++ b/.github/release/test_release_extensions.py @@ -122,17 +122,30 @@ def test_completion_does_not_acknowledge_go_tag_until_proxy_serves_version(self) complete_release.main() run.assert_not_called() - def test_workflow_plan_serializes_npm_semantic_before_core(self): + def test_workflow_plan_orders_every_npm_dependency_edge(self): with tempfile.TemporaryDirectory() as d: root = Path(d) data = {eco: [] for eco in release_plan.ECOSYSTEMS} - data.update(skipped=[], typescript=[{'name': '@traceai/fi-core', 'core': True, 'version': '1.0.0', 'tag': 'core'}, {'name': '@traceai/fi-semantic-conventions', 'core': True, 'version': '1.0.0', 'tag': 'semantic'}]) + # Mastra is alphabetically ahead of Vercel, and is a reconciliation + # entry, not an upload. It must still wait for Vercel's new version. + data.update(skipped=[], typescript=[ + {'name': '@traceai/mastra', 'workspace_dependencies': ['@traceai/fi-core', '@traceai/vercel'], 'registry_published': True}, + {'name': '@traceai/vercel', 'workspace_dependencies': ['@traceai/fi-semantic-conventions'], 'registry_published': False}, + {'name': '@traceai/fi-core', 'workspace_dependencies': ['@traceai/fi-semantic-conventions']}, + {'name': '@traceai/fi-semantic-conventions', 'workspace_dependencies': []}]) + for p in data['typescript']: + p.update(version='1.0.0', tag=p['name']) (root / 'plan.json').write_text(json.dumps(data)); (root / 'tags.txt').write_text('') with patch.dict(os.environ, {'GITHUB_OUTPUT': str(root / 'output'), 'GITHUB_STEP_SUMMARY': str(root / 'summary')}), patch.object(sys, 'argv', ['script', str(root / 'plan.json'), str(root / 'tags.txt')]): workflow_plan.main() outputs = dict(line.split('=', 1) for line in (root / 'output').read_text().splitlines()) - self.assertEqual([p['name'] for p in json.loads(outputs['typescript_semantic'])], ['@traceai/fi-semantic-conventions']) - self.assertEqual([p['name'] for p in json.loads(outputs['typescript_core'])], ['@traceai/fi-core']) + names = [p['name'] for p in json.loads(outputs['typescript'])] + for p in data['typescript']: + for dep in p['workspace_dependencies']: + self.assertLess(names.index(dep), names.index(p['name'])) + workflow = (release_plan.REPO_ROOT / '.github/workflows/release-typescript.yml').read_text() + self.assertNotIn('matrix:', workflow, 'a matrix would ignore the sorted list order') + self.assertIn('npm_release.py publish', workflow) def test_real_repo_has_complete_manifest_and_runtime_markers(self): root = release_plan.REPO_ROOT diff --git a/.github/release/test_release_strategies.cjs b/.github/release/test_release_strategies.cjs index 88e5ad8b8..b367ebb48 100644 --- a/.github/release/test_release_strategies.cjs +++ b/.github/release/test_release_strategies.cjs @@ -1,4 +1,4 @@ -// Run with NODE_PATH= node this-file.cjs. +// Run with NODE_PATH= node this-file.cjs. // Exercises real release-please strategies against local files with fake history. // No token, HTTP, git writes or GitHub mutations are possible in this test. const assert = require('node:assert/strict'); @@ -55,12 +55,12 @@ const scm = { if (value !== undefined) updates.set(u.path, value); } const next = JSON.parse(updates.get('.release-please-manifest.json')); - for (const p of ['python/fi_instrumentation', 'python/frameworks/openai', 'typescript/packages/traceai_openai', 'java', 'go/openai', 'csharp/src/FIInstrumentation']) { + for (const p of ['python', 'python/frameworks/openai', 'typescript/packages/traceai_openai', 'java', 'go/openai', 'csharp/src/FIInstrumentation']) { assert.equal(next[p], featureVersion(baseline[p]), `${p}: feature bumps patch before 1.0, minor after 1.0`); } assert(updates.get('python/frameworks/openai/traceai_openai/version.py').includes(`__version__ = "${next['python/frameworks/openai']}"`)); - assert(updates.get('python/fi_instrumentation/instrumentation/version.py').includes(`__version__ = "${next['python/fi_instrumentation']}"`)); - assert(updates.get('python/pyproject.toml').includes(`version = "${next['python/fi_instrumentation']}"`)); + assert(updates.get('python/fi_instrumentation/instrumentation/version.py').includes(`__version__ = "${next['python']}"`)); + assert(updates.get('python/pyproject.toml').includes(`version = "${next['python']}"`)); assert(!updates.has('python/frameworks/anthropic/traceai_anthropic/version.py'), 'core release must not rewrite untouched sibling SDK runtime versions'); assert.equal(JSON.parse(updates.get('typescript/packages/traceai_openai/package.json')).version, next['typescript/packages/traceai_openai']); assert(updates.get('csharp/src/FIInstrumentation/FIInstrumentation.csproj').includes(`${next['csharp/src/FIInstrumentation']}`)); @@ -85,5 +85,40 @@ const scm = { const {TagName} = require('release-please/build/src/util/tag-name.js'); const {Version} = require('release-please/build/src/version.js'); assert.equal(new TagName(Version.parse('0.1.0'), 'go/openai', '/', true).toString(), 'go/openai/v0.1.0'); - console.log(JSON.stringify({result: 'PASS', pullRequests: prs.length, checkedJavaParents, bomPresent: javaPoms.includes('java/traceai-bom/pom.xml'), syntheticBumps: Object.fromEntries(Object.keys(next).filter(p => next[p] !== baseline[p]).map(p => [p, {from: baseline[p], to: next[p]}])), updatedFiles: [...updates.keys()]}, null, 2)); + // A core dependency-only fix must release without touching any source file. + // Conversely a sibling-only fix must never bump core or rewrite other SDKs. + const scenarios = []; + for (const [files, expected] of [ + [['python/pyproject.toml'], ['python']], + [['python/fi_instrumentation/instrumentation/config.py'], ['python']], + [['python/frameworks/openai/pyproject.toml'], ['python/frameworks/openai']], + [['python/frameworks/new-sdk/pyproject.toml'], []], + ]) { + const scenarioScm = {...scm, async *mergeCommitIterator() { + yield {sha: 'e'.repeat(40), message: 'fix: update dependency security constraint', files}; + yield {sha: config['bootstrap-sha'], message: 'chore: baseline', files: []}; + }}; + const scenario = await Manifest.fromManifest(scenarioScm, 'main'); + const pulls = await scenario.buildPullRequests(); + assert.equal(pulls.length, expected.length ? 1 : 0, `${files}: release PR count`); + const contents = new Map(); + for (const update of pulls.flatMap(p => p.updates)) { + if (!update.createIfMissing && !caseExists(update.path)) continue; + const original = caseExists(update.path) ? fs.readFileSync(path.join(root, update.path), 'utf8') : ''; + const result = update.updater.updateContent(original); + if (result !== undefined) contents.set(update.path, result); + } + const versions = contents.has('.release-please-manifest.json') ? JSON.parse(contents.get('.release-please-manifest.json')) : baseline; + assert.deepEqual(Object.keys(versions).filter(p => versions[p] !== baseline[p]), expected); + if (expected.includes('python')) { + const [major, minor, patch] = baseline.python.split('.').map(Number); + assert.equal(versions.python, `${major}.${minor}.${patch + 1}`); + assert(contents.get('python/pyproject.toml').includes(`version = "${versions.python}"`)); + assert(contents.get('python/fi_instrumentation/instrumentation/version.py').includes(`__version__ = "${versions.python}"`)); + assert(contents.has('python/CHANGELOG.md')); + assert(![...contents.keys()].some(p => p.startsWith('python/frameworks/')), 'no sibling updates, not even unchanged version writes'); + } + scenarios.push({files, bumped: expected, pullRequests: pulls.length}); + } + console.log(JSON.stringify({result: 'PASS', pullRequests: prs.length, checkedJavaParents, bomPresent: javaPoms.includes('java/traceai-bom/pom.xml'), scenarios, syntheticBumps: Object.fromEntries(Object.keys(next).filter(p => next[p] !== baseline[p]).map(p => [p, {from: baseline[p], to: next[p]}])), updatedFiles: [...updates.keys()]}, null, 2)); })().catch(err => { console.error(err); process.exitCode = 1; }); diff --git a/.github/release/workflow_plan.py b/.github/release/workflow_plan.py index ea284b0f1..1aa3bd5ec 100644 --- a/.github/release/workflow_plan.py +++ b/.github/release/workflow_plan.py @@ -10,6 +10,7 @@ from pathlib import Path from release_plan import ECOSYSTEMS +from npm_release import topological def unfinished(plan, release_tags): @@ -24,13 +25,13 @@ def main(): with open(os.environ["GITHUB_OUTPUT"], "a") as output: for eco in ECOSYSTEMS: groups = {eco: plan[eco]} - if eco in ("python", "typescript"): + if eco == "python": groups = {eco: [p for p in plan[eco] if not p["core"]], eco + "_core": [p for p in plan[eco] if p["core"]]} if eco == "typescript": - semantic = "@traceai/fi-semantic-conventions" - groups["typescript_semantic"] = [p for p in groups["typescript_core"] if p["name"] == semantic] - groups["typescript_core"] = [p for p in groups["typescript_core"] if p["name"] != semantic] + # A single sequential worker consumes this dependency-first list; + # a parallel matrix cannot express arbitrary workspace edges. + groups = {eco: topological(plan[eco])} for name, entries in groups.items(): output.write(f"{name}={json.dumps(entries, separators=(',', ':'))}\n") with open(os.environ["GITHUB_STEP_SUMMARY"], "a") as summary: diff --git a/.github/workflows/release-typescript.yml b/.github/workflows/release-typescript.yml index 0f83bab57..ec28e82ef 100644 --- a/.github/workflows/release-typescript.yml +++ b/.github/workflows/release-typescript.yml @@ -1,19 +1,17 @@ -# Called by release.yml for a set of TypeScript packages (one job per package). Installs the -# workspace, builds the package with its workspace dependencies, packs it, installs the tarball -# in a clean project and loads it (CommonJS and ESM), then (when `publish` is true) publishes to -# npm with provenance, waits for the version to be served, tags the commit and creates the GitHub -# release from the package's CHANGELOG. See release.yml for the whole picture. +# One sequential worker builds exact tarballs, verifies fresh installs with local +# workspace dependencies, then publishes in DAG order. No dependency can race its +# consumer (including Vercel -> Mastra). Credentials exist only in the delivery step. name: Release (TypeScript packages) on: workflow_call: inputs: packages: - description: JSON array of planner entries ({name, version, dir, tag, changelog, ...}) + description: JSON array of dependency-ordered release planner entries type: string required: true publish: - description: Publish to npm, tag and create the GitHub release (false = build and check only) + description: Publish to npm, tag and create GitHub releases (false = build and check only) type: boolean required: true @@ -22,24 +20,15 @@ defaults: shell: bash jobs: - package: - name: ${{ matrix.name }} ${{ matrix.version }} + packages: + name: TypeScript packages in dependency order runs-on: ubuntu-latest - timeout-minutes: 40 + timeout-minutes: 180 permissions: - contents: write # the tag and the GitHub release - id-token: write # npm provenance - strategy: - fail-fast: false - matrix: - include: ${{ fromJson(inputs.packages) }} + contents: write + id-token: write env: - NAME: ${{ matrix.name }} - VERSION: ${{ matrix.version }} - DIR: ${{ matrix.dir }} - TAG: ${{ matrix.tag }} - CHANGELOG: ${{ matrix.changelog }} - REGISTRY_PUBLISHED: ${{ matrix.registry_published }} + PACKAGES: ${{ inputs.packages }} steps: - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4 with: @@ -59,71 +48,25 @@ jobs: registry-url: https://registry.npmjs.org cache: pnpm cache-dependency-path: typescript/pnpm-lock.yaml - - name: Install the workspace working-directory: typescript run: pnpm install --frozen-lockfile --ignore-scripts - - - name: The version in package.json is the planned one - run: | - got=$(node -p "require('./$DIR/package.json').version") - [ "$got" = "$VERSION" ] || { echo "::error::$DIR/package.json says $got, the plan says $VERSION"; exit 1; } - - - name: Build the package and the workspace packages it depends on - working-directory: typescript - run: pnpm --filter "${NAME}..." run build - - - name: Pack - working-directory: typescript - run: | - mkdir -p "$DIST" - pnpm --filter "$NAME" pack --pack-destination "$DIST" - ls -l "$DIST" - - - name: Install the tarball in a clean project and load it - working-directory: ${{ runner.temp }} - run: | - mkdir smoke && cd smoke && npm init -y > /dev/null - npm install --no-audit --no-fund "$DIST"/*.tgz - node -e "const m = require(process.env.NAME); console.log('require ok:', Object.keys(m).length, 'exports')" - node --input-type=module -e "import(process.env.NAME).then((m) => console.log('import ok:', Object.keys(m).length, 'exports'))" - got=$(node -p "require('./node_modules/$NAME/package.json').version") - [ "$got" = "$VERSION" ] || { echo "::error::installed $NAME is $got, expected $VERSION"; exit 1; } - - - name: Keep the tarball + - name: Build and pack targets plus their transitive workspace dependencies + run: python3 .github/release/npm_release.py stage --packages "$PACKAGES" --dist "$DIST" + - name: Clean-install exact staged tarballs and load each target (CJS and ESM) + run: python3 .github/release/npm_release.py verify --packages "$PACKAGES" --dist "$DIST" --smoke "$RUNNER_TEMP/smoke" + - name: Keep the tarballs uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4 with: - name: ${{ matrix.tag }} - path: ${{ runner.temp }}/dist/* + name: npm-packages + path: ${{ runner.temp }}/dist/**/*.tgz if-no-files-found: error - - name: Not publishing if: inputs.publish != true - run: echo "::notice title=${{ matrix.name }} ${{ matrix.version }} not published::built and checked only (publishing is off or this is a dry run)" - - - name: Publish to npm - if: inputs.publish && !matrix.registry_published - working-directory: typescript - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - run: npm publish "$DIST"/*.tgz --access public --provenance - - - name: Wait until npm serves the version - if: inputs.publish - run: | - for attempt in $(seq 1 20); do - if [ "$(npm view "$NAME@$VERSION" version 2>/dev/null)" = "$VERSION" ]; then - echo "$NAME@$VERSION is on npm" - exit 0 - fi - echo "attempt $attempt: not served yet" - sleep 30 - done - echo "::error title=$NAME $VERSION not on npm::published, but the registry did not serve it after 10 minutes" - exit 1 - - - name: Tag and create the GitHub release (publisher is the sole tag owner) + run: echo "::notice::npm packages built and checked only (publishing is off or this is a dry run)" + - name: Publish, wait for public availability, then tag and release (dependency-first) if: inputs.publish env: + NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} GH_TOKEN: ${{ github.token }} - run: python3 .github/release/github_release.py --install "npm install $NAME@$VERSION" --dist "$DIST" + run: python3 .github/release/npm_release.py publish --packages "$PACKAGES" --dist "$DIST" diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 293234332..90c4701ba 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -44,8 +44,6 @@ jobs: outputs: python_core: ${{ steps.plan.outputs.python_core }} python: ${{ steps.plan.outputs.python }} - typescript_semantic: ${{ steps.plan.outputs.typescript_semantic }} - typescript_core: ${{ steps.plan.outputs.typescript_core }} typescript: ${{ steps.plan.outputs.typescript }} java: ${{ steps.plan.outputs.java }} go: ${{ steps.plan.outputs.go }} @@ -66,7 +64,7 @@ jobs: run: python3 -m unittest discover -s .github/release -p 'test_*.py' - name: Test real release-please strategies offline run: | - npm install --prefix "$RUNNER_TEMP/release-please-test" --ignore-scripts --no-audit --no-fund release-please@17.11.2 + npm install --prefix "$RUNNER_TEMP/release-please-test" --ignore-scripts --no-audit --no-fund release-please@17.6.0 NODE_PATH="$RUNNER_TEMP/release-please-test/node_modules" node .github/release/test_release_strategies.cjs - name: Validate runtime versions, coverage and bootstrap backlog run: | @@ -236,41 +234,10 @@ jobs: env: GH_TOKEN: ${{ github.token }} run: python3 .github/release/github_release.py --install "pip install $NAME==$VERSION" --dist "$RUNNER_TEMP/dist" - typescript-semantic: - name: TypeScript semantic conventions - needs: plan - if: github.event_name != 'pull_request' && needs.plan.outputs.typescript_semantic != '[]' - permissions: - contents: write - id-token: write - uses: ./.github/workflows/release-typescript.yml - with: - packages: ${{ needs.plan.outputs.typescript_semantic }} - publish: ${{ needs.plan.outputs.publish_typescript == 'true' }} - secrets: inherit - typescript-core: - name: TypeScript core - needs: [plan, typescript-semantic] - if: >- - !cancelled() && github.event_name != 'pull_request' && needs.plan.result == 'success' - && (needs.typescript-semantic.result == 'success' || needs.typescript-semantic.result == 'skipped') - && needs.plan.outputs.typescript_core != '[]' - permissions: - contents: write - id-token: write - uses: ./.github/workflows/release-typescript.yml - with: - packages: ${{ needs.plan.outputs.typescript_core }} - publish: ${{ needs.plan.outputs.publish_typescript == 'true' }} - secrets: inherit typescript: - name: TypeScript - needs: [plan, typescript-semantic, typescript-core] - if: >- - !cancelled() && github.event_name != 'pull_request' && needs.plan.result == 'success' - && (needs.typescript-semantic.result == 'success' || needs.typescript-semantic.result == 'skipped') - && (needs.typescript-core.result == 'success' || needs.typescript-core.result == 'skipped') - && needs.plan.outputs.typescript != '[]' + name: TypeScript (dependency ordered) + needs: plan + if: github.event_name != 'pull_request' && needs.plan.outputs.typescript != '[]' permissions: contents: write id-token: write @@ -310,7 +277,7 @@ jobs: secrets: inherit release: name: Release - needs: [plan, python-core-build, python-core, python-build, python, typescript-semantic, typescript-core, typescript, java, go, nuget] + needs: [plan, python-core-build, python-core, python-build, python, typescript, java, go, nuget] if: always() runs-on: ubuntu-latest timeout-minutes: 5 diff --git a/.release-please-manifest.json b/.release-please-manifest.json index ffab6e894..96b447601 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -120,5 +120,5 @@ "go/genai": "0.1.0", "go/openai": "0.1.0", "csharp/src/FIInstrumentation": "1.0.0", - "python/fi_instrumentation": "1.2.1" + "python": "1.2.1" } diff --git a/RELEASING.md b/RELEASING.md index 669c7976f..c53c89c84 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -5,7 +5,7 @@ 1. Send normal changes to **dev** using Conventional Commit PR titles (`fix(openai): ...`, `feat: ...`). Keep the actual commits conventional too when using merge commits; a PR title alone does not rewrite its commits. Do not hand-bump package versions for routine changes. 2. A maintainer merges dev into **main**. Release automation runs only on main. Nothing is published by a PR into dev or main. 3. The **Release** workflow inventories the current package versions and queries their registries. Unpublished versions are built, checked, uploaded and verified; versions already on a registry are never uploaded again. Python and npm core packages finish before their consumers. -4. At the end of a main push, release-please maintains **one combined release PR targeting main** with per-package versions and changelogs. Changes are scoped by package path. `fix` bumps patch; `feat` also bumps patch before 1.0 (`bump-patch-for-minor-pre-major`, matching [OpenInference](https://github.com/Arize-ai/openinference)). Breaking changes follow release-please's pre-major versioning rules. Java is one Maven reactor; `skip-snapshot` prevents a second SNAPSHOT PR. The Python core is scoped to `python/fi_instrumentation`, with `python/pyproject.toml` and `python/CHANGELOG.md` updated via root-relative paths: a Python strategy rooted at `python/` would recursively overwrite sibling SDK `version.py` files. npm semantic conventions publish before fi-core, then the remaining npm packages. +4. At the end of a main push, release-please maintains **one combined release PR targeting main** with per-package versions and changelogs. Changes are scoped by package path. `fix` bumps patch; `feat` also bumps patch before 1.0 (`bump-patch-for-minor-pre-major`, matching [OpenInference](https://github.com/Arize-ai/openinference)). Breaking changes follow release-please's pre-major versioning rules. Java is one Maven reactor; `skip-snapshot` prevents a second SNAPSHOT PR. The Python core watches `python/` using the **non-recursive `simple` strategy** with explicit TOML/runtime updaters; this includes dependency-only fixes in `python/pyproject.toml` without discovering or overwriting sibling SDK `version.py` files. Its optional `version.txt` is absent and is not created; the manifest and marked runtime file remain authoritative. Sibling SDK paths have their own components and `python/frameworks`/`python/traceai` are excluded from core-only commit detection. All npm deliveries run sequentially in dependency-DAG order, including semantic conventions → fi-core and Vercel → Mastra, waiting for each published dependency version to be served before delivering its consumer. 5. Review and merge that release PR. Its version changes trigger the same build/verify/publish pipeline. The next ordinary changes accumulate in the next release PR. No automatic merging is configured. This extends **Tanmay's [#300](https://github.com/future-agi/traceAI/pull/300)**: his planner, core-first publishing, clean-install checks and changelog-based GitHub releases are retained and extended to five languages. The branch contains a normal merge of his publishing branch, not a rewrite of it. @@ -28,7 +28,7 @@ The Go proxy URL escapes uppercase letters: `traceAI` becomes `trace!a!i`. A mod The manifest is seeded from the current versions on dev, **not** from old registry versions. Go starts at **0.1.0**. `bootstrap-sha` is the dev head `35f2e3dc364676fa5bdab1e71ae500daf9efc00c`: this deliberately excludes pre-bootstrap history from the first release PR. Keep that SHA as a fallback for components that have not yet acquired matching release tags; do not advance it on each release. -When [#287](https://github.com/future-agi/traceAI/pull/287) reaches main, existing unpublished versions can ship immediately once their ecosystem's setup is complete. **Already-merged fixes must not be stranded behind an unchanged registry version.** The committed [bootstrap audit](.github/release/bootstrap-audit.json) inventories all **68 Python and 47 npm manifests** at that baseline, reads the public upload timestamp of each current version, and checks first-parent package history after the upload. It uses the last wheel/sdist upload, not registry project-modification time; core excludes sibling SDK directories. This is conservative: any package-directory change counts, including docs/version housekeeping. +When [#287](https://github.com/future-agi/traceAI/pull/287) reaches main, existing unpublished versions can ship immediately once their ecosystem's setup is complete. **Already-merged fixes must not be stranded behind an unchanged registry version.** The committed [bootstrap audit](.github/release/bootstrap-audit.json) inventories all **68 Python and 47 npm manifests** at that baseline, reads the public upload timestamp of each current version, and checks first-parent package history after the upload. It uses the last wheel/sdist upload, not registry project-modification time; core excludes sibling SDK directories. The history filter uses **first-parent committer/merge times, not author dates**: a branch authored before an upload still counts when its merge lands afterwards. `--since-as-filter` also traverses backdated later commits instead of stopping early. A real temporary-git regression covers both cases. This is conservative: any package-directory change counts, including docs/version housekeeping. The audit found **35 Python and 3 npm same-version packages with later merged changes**. This PR applies explicit, one-time patch bumps to those **38 packages**, including Python OpenAI **0.1.10 → 0.1.11** for the already-merged #249 fix. Package manifests, Python runtime versions, release-please's manifest and changelogs move together. This option deliberately avoids replaying all old conventional commits or repeatedly forcing `release-as`. There are also **25 Python and 12 npm current versions not yet uploaded**, which need no additional bootstrap bump. Six published Python and 32 published npm packages have no package history after their current-version upload and are left unchanged; two Python manifests are excluded below. @@ -109,7 +109,7 @@ python3 .github/release/release_plan.py --only traceAI-openai @traceai/openai For the real release-please strategy regression test (offline after installing the tool): ```bash -npm install --prefix /tmp/traceai-release-please --ignore-scripts --no-audit --no-fund release-please@17.11.2 +npm install --prefix /tmp/traceai-release-please --ignore-scripts --no-audit --no-fund release-please@17.6.0 NODE_PATH=/tmp/traceai-release-please/node_modules node .github/release/test_release_strategies.cjs ``` @@ -121,7 +121,7 @@ Once the config/manifest are present on the target branch, preview the actual PR --token "$(gh auth token)" ``` -Use a token with read access for this dry run. Do not enable shell tracing around tokens. The initial development preview used real dev history with **only** the two proposed, not-yet-merged config files overlaid locally; it found zero post-bootstrap commits and would open zero PRs. A separate fully offline fake-history test exercises a qualifying feature across all five languages and asserts one combined PR plus correct version-file changes. It checks every internal Java parent POM, not just the reactor root; an additional local run over companion #302 also covers `traceai-bom`. +Use a token with read access for this dry run. Do not enable shell tracing around tokens. The initial development preview used real dev history with **only** the two proposed, not-yet-merged config files overlaid locally; it found zero post-bootstrap commits and would open zero PRs. The strategy test uses **release-please 17.6.0**, matching the pinned production action. A separate fully offline fake-history test exercises a qualifying feature across all five languages and asserts one combined PR plus correct version-file changes. It also proves a fix touching **only** `python/pyproject.toml` releases core, while sibling-only fixes leave core and unrelated SDK runtime versions untouched. It checks every internal Java parent POM, not just the reactor root; an additional local run over companion #302 also covers `traceai-bom`. For a GitHub-hosted build-only run after the workflow lands on the default branch: @@ -130,7 +130,7 @@ gh workflow run release.yml --repo future-agi/traceAI --ref main \ -f dry_run=true -f packages='traceAI-openai @traceai/openai' ``` -A dispatch defaults to **dry run**. It creates no release PR, upload, tag or release. PR runs validate scripts/configuration and display the plan; they do not invoke the publishing/build matrices. +A dispatch defaults to **dry run**. It creates no release PR, upload, tag or release. npm clean-install verification supplies the target **and all transitive workspace dependency tarballs built locally**, including versions absent from npm. Only selected targets are published, never incidental dependency artifacts; a publish selection that omits an unpublished dependency fails before uploading the consumer (include that dependency in `packages`, or leave the selection empty). Builds/install scripts do not receive publishing credentials. Offline unit tests pack/install an unpublished four-package dependency graph with an empty npm cache and no network. PR runs validate scripts/configuration and display the plan; they do not invoke the publishing/build jobs. ## Manual release and recovery diff --git a/python/frameworks/cerebras/CHANGELOG.md b/python/frameworks/cerebras/CHANGELOG.md index 9ea891f1f..fa441c5eb 100644 --- a/python/frameworks/cerebras/CHANGELOG.md +++ b/python/frameworks/cerebras/CHANGELOG.md @@ -4,4 +4,3 @@ ### Fixed - Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. - diff --git a/python/frameworks/cohere/CHANGELOG.md b/python/frameworks/cohere/CHANGELOG.md index 9ea891f1f..fa441c5eb 100644 --- a/python/frameworks/cohere/CHANGELOG.md +++ b/python/frameworks/cohere/CHANGELOG.md @@ -4,4 +4,3 @@ ### Fixed - Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. - diff --git a/python/frameworks/deepseek/CHANGELOG.md b/python/frameworks/deepseek/CHANGELOG.md index 9ea891f1f..fa441c5eb 100644 --- a/python/frameworks/deepseek/CHANGELOG.md +++ b/python/frameworks/deepseek/CHANGELOG.md @@ -4,4 +4,3 @@ ### Fixed - Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. - diff --git a/python/frameworks/fireworks/CHANGELOG.md b/python/frameworks/fireworks/CHANGELOG.md index 9ea891f1f..fa441c5eb 100644 --- a/python/frameworks/fireworks/CHANGELOG.md +++ b/python/frameworks/fireworks/CHANGELOG.md @@ -4,4 +4,3 @@ ### Fixed - Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. - diff --git a/python/frameworks/together/CHANGELOG.md b/python/frameworks/together/CHANGELOG.md index 9ea891f1f..fa441c5eb 100644 --- a/python/frameworks/together/CHANGELOG.md +++ b/python/frameworks/together/CHANGELOG.md @@ -4,4 +4,3 @@ ### Fixed - Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. - diff --git a/python/frameworks/xai/CHANGELOG.md b/python/frameworks/xai/CHANGELOG.md index 9ea891f1f..fa441c5eb 100644 --- a/python/frameworks/xai/CHANGELOG.md +++ b/python/frameworks/xai/CHANGELOG.md @@ -4,4 +4,3 @@ ### Fixed - Publish package changes merged after 0.1.0 was uploaded to PyPI; one-time bootstrap patch for the automated release pipeline. - diff --git a/release-please-config.json b/release-please-config.json index 1b27a343d..a4cc5240c 100644 --- a/release-please-config.json +++ b/release-please-config.json @@ -839,19 +839,49 @@ } ] }, - "python/fi_instrumentation": { - "release-type": "python", + "python": { + "release-type": "simple", "component": "fi-instrumentation-otel", "package-name": "fi-instrumentation-otel", "extra-files": [ { "type": "toml", - "path": "/python/pyproject.toml", + "path": "pyproject.toml", "jsonpath": "$.tool.poetry.version" }, - "instrumentation/version.py" + "fi_instrumentation/instrumentation/version.py" + ], + "changelog-path": "CHANGELOG.md", + "exclude-paths": [ + "python/frameworks", + "python/traceai" ], - "changelog-path": "/python/CHANGELOG.md" + "changelog-sections": [ + { + "type": "feat", + "section": "Features" + }, + { + "type": "fix", + "section": "Bug Fixes" + }, + { + "type": "perf", + "section": "Performance Improvements" + }, + { + "type": "deps", + "section": "Dependencies" + }, + { + "type": "revert", + "section": "Reverts" + }, + { + "type": "docs", + "section": "Documentation" + } + ] } } } diff --git a/typescript/packages/traceai_mcp/CHANGELOG.md b/typescript/packages/traceai_mcp/CHANGELOG.md index 360691545..4f7504107 100644 --- a/typescript/packages/traceai_mcp/CHANGELOG.md +++ b/typescript/packages/traceai_mcp/CHANGELOG.md @@ -4,4 +4,3 @@ ### Fixed - Publish package changes merged after 0.1.0 was uploaded to npm; one-time bootstrap patch for the automated release pipeline. - diff --git a/typescript/packages/traceai_vercel/CHANGELOG.md b/typescript/packages/traceai_vercel/CHANGELOG.md index 360691545..4f7504107 100644 --- a/typescript/packages/traceai_vercel/CHANGELOG.md +++ b/typescript/packages/traceai_vercel/CHANGELOG.md @@ -4,4 +4,3 @@ ### Fixed - Publish package changes merged after 0.1.0 was uploaded to npm; one-time bootstrap patch for the automated release pipeline. - From f081e436e3ffdf68b3c1b43071affff8d3da4ef0 Mon Sep 17 00:00:00 2001 From: Nikhil Pareek <8347993+nik13@users.noreply.github.com> Date: Thu, 29 Oct 2026 15:32:03 -0700 Subject: [PATCH 07/11] fix(release): run each PyPI publish in its own environment PyPI accepts only one pending trusted publisher per repository, workflow and environment, so the 19 first-time projects cannot share one. The publish job now runs in pypi-; publishers on existing projects keep a blank environment, which accepts it. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/release.yml | 3 +++ RELEASING.md | 3 ++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 90c4701ba..2e775451e 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -188,6 +188,9 @@ jobs: !cancelled() && needs.python-build.result == 'success' && needs.plan.outputs.publish_python == 'true' runs-on: ubuntu-latest + # One environment per project: PyPI allows only one pending trusted publisher per + # (repository, workflow, environment), so first-time projects need distinct environments. + environment: pypi-${{ matrix.name }} timeout-minutes: 20 permissions: contents: write diff --git a/RELEASING.md b/RELEASING.md index c53c89c84..23aa1aa31 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -63,7 +63,8 @@ This is a checklist, not something the workflow changes for you. Never paste sec ### PyPI: trusted publishing preferred -- [ ] For **each publishable Python project**, add a PyPI Trusted Publisher: owner **`future-agi`**, repository **`traceAI`**, workflow filename **`release.yml`**, environment **blank** (this workflow declares no environment). New projects need a pending publisher before their first upload. The planner's offline inventory lists the exact project names. +- [ ] For **each publishable Python project that already exists on PyPI**, add a PyPI Trusted Publisher: owner **`future-agi`**, repository **`traceAI`**, workflow filename **`release.yml`**, environment **blank** (blank accepts the per-project environment the publish job runs in). +- [ ] For **each first-time project**, add an organization **pending** publisher (futureagi organization → Publishing) with the same owner, repository and workflow, and environment **`pypi-`** exactly as the release plan spells the name (for example `pypi-traceAI-ag2`). PyPI accepts only one pending publisher per (repository, workflow, environment), so each new project needs its own environment; the `Publish python` job runs in `pypi-${{ matrix.name }}`. - [ ] Set repository **variable** **`PYPI_TRUSTED_PUBLISHING=true`** after all intended project entries exist. No PyPI secret is needed for this mode. - [ ] Important correction to #300: the trusted publisher filename is **`release.yml`, not `release-python.yml`**. The pinned PyPI action explicitly does not support Trusted Publishing inside reusable workflows. `release-python.yml` now only builds/checks/uploads artifacts with read-only repository access. OIDC upload jobs live in the top-level `release.yml`. - [ ] Token fallback only: add secret **`PYPI_API_TOKEN`** with upload rights for the intended projects. The publisher uses it when present. Account-scoped tokens can create new projects; project-scoped tokens cannot create another project. Remove the fallback token once trusted publishing is working. From 4e4d25756d73404ad8893731fa84b3616a570827 Mon Sep 17 00:00:00 2001 From: Nikhil Pareek <8347993+nik13@users.noreply.github.com> Date: Thu, 29 Oct 2026 16:07:29 -0700 Subject: [PATCH 08/11] fix(release): create the 16 new PyPI projects with a one-time bootstrap token PyPI allows only three pending trusted publishers per organization, so 16 first-time projects cannot be created through trusted publishing. They are listed in config.json pypi_bootstrap_token; the plan marks a listed package that has never been published, and only those uploads use the PYPI_BOOTSTRAP_TOKEN secret. Every other upload keeps trusted publishing. RELEASING.md records the cleanup after the first release. Co-Authored-By: Claude Opus 5.5 --- .github/release/config.json | 21 ++++++++++++++++++++- .github/release/release_plan.py | 2 ++ .github/release/test_release_plan.py | 8 ++++++++ .github/workflows/release.yml | 6 ++++-- RELEASING.md | 1 + 5 files changed, 35 insertions(+), 3 deletions(-) diff --git a/.github/release/config.json b/.github/release/config.json index 69b533e84..a3204edea 100644 --- a/.github/release/config.json +++ b/.github/release/config.json @@ -3,5 +3,24 @@ "skip": { "traceai": "the PyPI name traceai belongs to another publisher; the package has no registry name yet", "futureagi-hermes-plugin": "Hermes plugin dependency manifest, explicitly not a buildable distribution" - } + }, + "_pypi_bootstrap_comment": "PyPI allows only three pending trusted publishers per organization, so these first-time projects are created by their first upload with the PYPI_BOOTSTRAP_TOKEN secret instead. Only a package in this list that has never been published uses the token. After the first release: add each project to the futureagi organization, add its trusted publisher (release.yml, blank environment), delete the token on PyPI and the secret, and empty this list.", + "pypi_bootstrap_token": [ + "traceAI-ag2", + "traceAI-discoveryengine", + "traceAI-elevenlabs-agents", + "traceAI-exa", + "traceAI-firecrawl", + "traceAI-google-genai-live", + "traceAI-hermes-agent", + "traceAI-mcp-use", + "traceAI-minimax", + "traceAI-openai-realtime", + "traceAI-parallel", + "traceAI-replicate", + "traceAI-semantic-kernel", + "traceAI-tavily", + "traceAI-typesafe", + "traceAI-voyage" + ] } diff --git a/.github/release/release_plan.py b/.github/release/release_plan.py index ecd0daf32..598f9bca0 100644 --- a/.github/release/release_plan.py +++ b/.github/release/release_plan.py @@ -237,6 +237,8 @@ def plan(packages: list[dict], config: dict, *, offline: bool = False, only: set out["skipped"].append({"name": p["name"], "reason": f"{p['version']} is already published"}) continue p = {**p, "first_release": have is None, "registry_published": published} + if p["ecosystem"] == "python": + p["pypi_bootstrap"] = have is None and p["name"] in set(config.get("pypi_bootstrap_token", [])) out[p["ecosystem"]].append({k: v for k, v in p.items() if k not in ("declared", "ecosystem")}) for eco in ECOSYSTEMS: out[eco].sort(key=lambda e: (not e["core"], e["name"].lower())) diff --git a/.github/release/test_release_plan.py b/.github/release/test_release_plan.py index fdef6de4b..3172e8e35 100644 --- a/.github/release/test_release_plan.py +++ b/.github/release/test_release_plan.py @@ -78,6 +78,14 @@ def test_plan_skips_published_versions(self): self.assertEqual([(e["name"], e["first_release"]) for e in p["typescript"]], [("@traceai/openai", True)]) self.assertEqual(p["skipped"], [{"name": "traceAI-openai", "reason": "0.1.10 is already published"}]) + def test_bootstrap_token_only_for_listed_projects_never_published(self): + have = {"traceai-agno": None, "traceAI-openai": None, "fi-instrumentation-otel": {"1.0.0"}} + cfg = {"skip": {}, "pypi_bootstrap_token": ["traceai-agno", "fi-instrumentation-otel"]} + with patch.object(release_plan, 'published_versions', side_effect=lambda p: have.get(p["name"], set())): + p = release_plan.plan(self.packages, cfg, only={"traceai-agno", "traceAI-openai", "fi-instrumentation-otel"}) + self.assertEqual({e["name"]: e["pypi_bootstrap"] for e in p["python"]}, + {"fi-instrumentation-otel": False, "traceai-agno": True, "traceAI-openai": False}) + def test_check_mode_exit_codes(self): self.assertEqual(release_plan.main(["--check", "--root", str(self.repo.root)]), 0) write(self.repo.root / "python/fi_instrumentation/__init__.py", '__version__ = "0.9"\n') diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 2e775451e..8a1b3bee0 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -155,7 +155,8 @@ jobs: uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # release/v1 with: packages-dir: ${{ runner.temp }}/dist - password: ${{ secrets.PYPI_API_TOKEN }} + # First-time projects listed in config.json pypi_bootstrap_token upload with the bootstrap token; everything else uses trusted publishing. + password: ${{ matrix.pypi_bootstrap && secrets.PYPI_BOOTSTRAP_TOKEN || secrets.PYPI_API_TOKEN }} print-hash: true - name: Verify public registry availability run: | @@ -221,7 +222,8 @@ jobs: uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # release/v1 with: packages-dir: ${{ runner.temp }}/dist - password: ${{ secrets.PYPI_API_TOKEN }} + # First-time projects listed in config.json pypi_bootstrap_token upload with the bootstrap token; everything else uses trusted publishing. + password: ${{ matrix.pypi_bootstrap && secrets.PYPI_BOOTSTRAP_TOKEN || secrets.PYPI_API_TOKEN }} print-hash: true - name: Verify public registry availability run: | diff --git a/RELEASING.md b/RELEASING.md index 23aa1aa31..330a583ee 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -67,6 +67,7 @@ This is a checklist, not something the workflow changes for you. Never paste sec - [ ] For **each first-time project**, add an organization **pending** publisher (futureagi organization → Publishing) with the same owner, repository and workflow, and environment **`pypi-`** exactly as the release plan spells the name (for example `pypi-traceAI-ag2`). PyPI accepts only one pending publisher per (repository, workflow, environment), so each new project needs its own environment; the `Publish python` job runs in `pypi-${{ matrix.name }}`. - [ ] Set repository **variable** **`PYPI_TRUSTED_PUBLISHING=true`** after all intended project entries exist. No PyPI secret is needed for this mode. - [ ] Important correction to #300: the trusted publisher filename is **`release.yml`, not `release-python.yml`**. The pinned PyPI action explicitly does not support Trusted Publishing inside reusable workflows. `release-python.yml` now only builds/checks/uploads artifacts with read-only repository access. OIDC upload jobs live in the top-level `release.yml`. +- [x] **First-release bootstrap (set up 2026-10-29).** PyPI allows only three pending trusted publishers per organization. `traceAI-a2a`, `traceAI-ag2-classic` and `traceAI-agent-framework` have org pending publishers. The other 16 first-time projects are listed in `.github/release/config.json` `pypi_bootstrap_token` and their first upload uses the **`PYPI_BOOTSTRAP_TOKEN`** secret (an account-scoped token, because only those can create projects). Nothing else uses it. **After the first release that creates them:** add each of the 16 projects to the futureagi organization, add its trusted publisher (owner `future-agi`, repository `traceAI`, workflow `release.yml`, blank environment), revoke the token on PyPI, delete the `PYPI_BOOTSTRAP_TOKEN` secret, and empty the list. - [ ] Token fallback only: add secret **`PYPI_API_TOKEN`** with upload rights for the intended projects. The publisher uses it when present. Account-scoped tokens can create new projects; project-scoped tokens cannot create another project. Remove the fallback token once trusted publishing is working. Sources: [PyPI publisher setup](https://docs.pypi.org/trusted-publishers/adding-a-publisher/) and [pinned PyPI action's reusable-workflow restriction](https://github.com/pypa/gh-action-pypi-publish/blob/7245906fb61fa33a13554f9d5fb856fe61758086/README.md#trusted-publishing). From 8cef4fc6d123208628594016b9796c177cef2b7f Mon Sep 17 00:00:00 2001 From: Nikhil Pareek <8347993+nik13@users.noreply.github.com> Date: Thu, 29 Oct 2026 16:37:14 -0700 Subject: [PATCH 09/11] ci(release): make npm publishing ready for trusted publishing The npm publish job installs npm 11.21.1 (trusted publishing needs 11.5.1 or later). npm tries OIDC first and falls back to NODE_AUTH_TOKEN, so the first release keeps using NPM_TOKEN and later releases switch to trusted publishing once per-package publishers exist. RELEASING.md records the migration, including npm's 2-day expiry on unused publisher configs and the workflow_call rule (configure release.yml). Co-Authored-By: Claude Opus 5.5 --- .github/workflows/release-typescript.yml | 5 +++++ RELEASING.md | 9 ++++++--- 2 files changed, 11 insertions(+), 3 deletions(-) diff --git a/.github/workflows/release-typescript.yml b/.github/workflows/release-typescript.yml index ec28e82ef..0f21a7b76 100644 --- a/.github/workflows/release-typescript.yml +++ b/.github/workflows/release-typescript.yml @@ -64,6 +64,11 @@ jobs: - name: Not publishing if: inputs.publish != true run: echo "::notice::npm packages built and checked only (publishing is off or this is a dry run)" + - name: Use npm 11 (trusted publishing needs npm 11.5.1 or later) + if: inputs.publish + # npm tries OIDC trusted publishing first and falls back to NODE_AUTH_TOKEN, so this + # works with the token today and with trusted publishers once they are configured. + run: npm install -g npm@11.21.1 && npm --version - name: Publish, wait for public availability, then tag and release (dependency-first) if: inputs.publish env: diff --git a/RELEASING.md b/RELEASING.md index 330a583ee..7dbb13eaa 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -74,9 +74,12 @@ Sources: [PyPI publisher setup](https://docs.pypi.org/trusted-publishers/adding- ### npm -- [ ] Add **`NPM_TOKEN`**, an automation-capable granular access token with publish permission for the intended **`@traceai`** packages and permission to create any new package names. Configure the required 2FA bypass for automation under your npm policy. Track its expiry and rotate it before expiry. -- [ ] Publishing uses `npm publish --access public --provenance` on a GitHub-hosted Linux runner with `id-token: write`. This is token authentication plus provenance; it does not claim npm Trusted Publishing/OIDC authentication is configured. -- [ ] Confirm the token's account has the necessary package/scope ownership. Already-published names are never renamed. +- [x] **`NPM_TOKEN`** (set 2026-10-29): granular token `traceai-github-release`, read and write on the `@traceai` scope only, bypass 2FA, **expires 2027-01-27**. It publishes the first release, including first-time package names, which cannot have a trusted publisher until they exist. +- [ ] **Move to npm trusted publishing before January 2027.** npm removes direct publishing with 2FA-bypass tokens then. The workflow already installs npm 11.21.1 and has `id-token: write` in both the caller and the reusable job. npm tries OIDC first and falls back to the token. + - **Timing:** a new npm trusted publisher expires if it is not used within **2 days**, so configure them right before a release, not in advance. + - **Per package:** for each `@traceai` package, go to Settings → Trusted publisher → GitHub Actions and enter owner `future-agi`, repository `traceAI`, workflow **`release.yml`** (npm checks the calling workflow when `workflow_call` is used), with no environment. Allow `npm publish`. + - **After a successful OIDC release:** set each package's publishing access to "Require two-factor authentication and disallow tokens", then revoke the token and delete the `NPM_TOKEN` secret. +- [ ] Publishing uses `npm publish --access public --provenance` on a GitHub-hosted Linux runner. `package.json` `repository.url` must match the GitHub repository for trusted publishing. Already-published names are never renamed. ### Maven Central: primary Java distribution From 7f8380036cfcf041624d98681e8098b3a16b74d5 Mon Sep 17 00:00:00 2001 From: Nikhil Pareek Date: Fri, 30 Oct 2026 21:46:18 -0700 Subject: [PATCH 10/11] fix(ci): allow npm trusted publishing through release gates Accept an explicit trusted-publishing opt-in alongside token authentication. Fail real main releases with pending npm work when neither path is configured, and cover the workflow shell with offline credential-gate regressions. Co-Authored-By: Claude Code --- .github/release/test_release_gates.py | 81 +++++++++++++++++++++++++++ .github/workflows/release.yml | 10 +++- RELEASING.md | 4 +- 3 files changed, 93 insertions(+), 2 deletions(-) create mode 100644 .github/release/test_release_gates.py diff --git a/.github/release/test_release_gates.py b/.github/release/test_release_gates.py new file mode 100644 index 000000000..11ac44659 --- /dev/null +++ b/.github/release/test_release_gates.py @@ -0,0 +1,81 @@ +"""Execute the workflow's credential gate with booleans only, without credentials or network.""" +import os +import subprocess +import tempfile +import textwrap +import unittest +from pathlib import Path + + +WORKFLOW = Path(__file__).resolve().parents[1] / 'workflows/release.yml' + + +class CredentialGateTests(unittest.TestCase): + def run_gate(self, *, token=False, trusted=False, release=True, pending=True): + workflow = WORKFLOW.read_text() + step = workflow.split(' - name: Credential and event gates\n', 1)[1].split('\n python-core-build:', 1)[0] + # Bind the exercised booleans to the real workflow inputs. Never expose a token. + self.assertIn("NPM_TOKEN_AVAILABLE: ${{ secrets.NPM_TOKEN != '' }}", step) + self.assertIn("NPM_TRUSTED_PUBLISHING: ${{ vars.NPM_TRUSTED_PUBLISHING == 'true' }}", step) + self.assertIn("TYPESCRIPT_PENDING: ${{ steps.plan.outputs.typescript != '[]' }}", step) + self.assertIn("RELEASE_EVENT: ${{ github.ref == 'refs/heads/main' && github.event_name != 'pull_request' && inputs.dry_run != true }}", step) + script = textwrap.dedent(step.split(' run: |\n', 1)[1]) + with tempfile.TemporaryDirectory() as d: + output, summary = Path(d) / 'output', Path(d) / 'summary' + output.touch() + env = { + 'PATH': os.defpath, + 'RELEASE_EVENT': str(release).lower(), + 'NPM_TOKEN_AVAILABLE': str(token).lower(), + 'NPM_TRUSTED_PUBLISHING': str(trusted).lower(), + 'TYPESCRIPT_PENDING': str(pending).lower(), + 'PYPI': 'true', 'MAVEN': 'true', 'NUGET': 'true', + 'GITHUB_OUTPUT': str(output), 'GITHUB_STEP_SUMMARY': str(summary), + } + result = subprocess.run(['bash', '--noprofile', '--norc', '-e', '-o', 'pipefail', '-c', script], + env=env, capture_output=True, text=True) + outputs = dict(line.split('=', 1) for line in output.read_text().splitlines()) + return result, outputs + + def test_token_only_allows_npm_publishing(self): + result, outputs = self.run_gate(token=True) + self.assertEqual(result.returncode, 0, result.stderr) + self.assertEqual(outputs['typescript'], 'true') + self.assertNotIn('::warning::', result.stdout) + + def test_oidc_only_allows_npm_publishing_and_reconciliation(self): + result, outputs = self.run_gate(trusted=True) + self.assertEqual(result.returncode, 0, result.stderr) + self.assertEqual(outputs['typescript'], 'true') + self.assertNotIn('::warning::', result.stdout) + + def test_both_credentials_remain_supported(self): + result, outputs = self.run_gate(token=True, trusted=True) + self.assertEqual(result.returncode, 0, result.stderr) + self.assertEqual(outputs['typescript'], 'true') + + def test_no_npm_configuration_fails_pending_release(self): + result, outputs = self.run_gate() + self.assertNotEqual(result.returncode, 0) + self.assertIn('::error::npm releases are pending', result.stdout) + self.assertIn('NPM_TOKEN nor NPM_TRUSTED_PUBLISHING', result.stdout) + self.assertEqual(outputs, {}) + + def test_non_release_events_never_publish_or_require_credentials(self): + for token, trusted in ((False, False), (True, False), (False, True), (True, True)): + with self.subTest(token=token, trusted=trusted): + result, outputs = self.run_gate(token=token, trusted=trusted, release=False) + self.assertEqual(result.returncode, 0, result.stderr) + self.assertTrue(all(value == 'false' for value in outputs.values())) + self.assertNotIn('::error::', result.stdout) + + def test_non_npm_selection_does_not_require_npm_credentials(self): + result, outputs = self.run_gate(pending=False) + self.assertEqual(result.returncode, 0, result.stderr) + self.assertEqual(outputs['typescript'], 'false') + for eco in ('python', 'java', 'go', 'nuget'): + self.assertEqual(outputs[eco], 'true') + + +if __name__ == '__main__': + unittest.main() diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 8a1b3bee0..88c756422 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -92,10 +92,18 @@ jobs: env: RELEASE_EVENT: ${{ github.ref == 'refs/heads/main' && github.event_name != 'pull_request' && inputs.dry_run != true }} PYPI: ${{ secrets.PYPI_API_TOKEN != '' || vars.PYPI_TRUSTED_PUBLISHING == 'true' }} - NPM: ${{ secrets.NPM_TOKEN != '' }} + NPM_TOKEN_AVAILABLE: ${{ secrets.NPM_TOKEN != '' }} + NPM_TRUSTED_PUBLISHING: ${{ vars.NPM_TRUSTED_PUBLISHING == 'true' }} + TYPESCRIPT_PENDING: ${{ steps.plan.outputs.typescript != '[]' }} MAVEN: ${{ secrets.MAVEN_CENTRAL_USERNAME != '' && secrets.MAVEN_CENTRAL_PASSWORD != '' && secrets.MAVEN_GPG_PRIVATE_KEY != '' && secrets.MAVEN_GPG_PASSPHRASE != '' }} NUGET: ${{ secrets.NUGET_API_KEY != '' }} run: | + NPM=false + if [ "$NPM_TOKEN_AVAILABLE" = true ] || [ "$NPM_TRUSTED_PUBLISHING" = true ]; then NPM=true; fi + if [ "$RELEASE_EVENT" = true ] && [ "$TYPESCRIPT_PENDING" = true ] && [ "$NPM" != true ]; then + echo "::error::npm releases are pending but neither NPM_TOKEN nor NPM_TRUSTED_PUBLISHING is configured. Complete the RELEASING.md checklist." + exit 1 + fi for eco in python typescript java go nuget; do enabled=false case "$eco" in diff --git a/RELEASING.md b/RELEASING.md index 7dbb13eaa..6d6aaa37e 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -78,7 +78,9 @@ Sources: [PyPI publisher setup](https://docs.pypi.org/trusted-publishers/adding- - [ ] **Move to npm trusted publishing before January 2027.** npm removes direct publishing with 2FA-bypass tokens then. The workflow already installs npm 11.21.1 and has `id-token: write` in both the caller and the reusable job. npm tries OIDC first and falls back to the token. - **Timing:** a new npm trusted publisher expires if it is not used within **2 days**, so configure them right before a release, not in advance. - **Per package:** for each `@traceai` package, go to Settings → Trusted publisher → GitHub Actions and enter owner `future-agi`, repository `traceAI`, workflow **`release.yml`** (npm checks the calling workflow when `workflow_call` is used), with no environment. Allow `npm publish`. - - **After a successful OIDC release:** set each package's publishing access to "Require two-factor authentication and disallow tokens", then revoke the token and delete the `NPM_TOKEN` secret. + - **Enable the OIDC-only path:** after configuring the per-package trusted publishers, set the GitHub Actions repository variable **`NPM_TRUSTED_PUBLISHING=true`** before deleting `NPM_TOKEN`. The credential gate accepts either this explicit opt-in or an existing token; the opt-in does not configure npm's trusted publishers for you. + - **After a successful OIDC release:** set each package's publishing access to "Require two-factor authentication and disallow tokens", then revoke the token and delete the `NPM_TOKEN` secret. Keep `NPM_TRUSTED_PUBLISHING=true` for future releases. +- A non-dry-run main release with pending npm uploads or tag/release reconciliation **fails** if neither a token nor the trusted-publishing opt-in is configured. PRs, dry runs and selections with no pending npm releases do not require npm credentials. An enabled but incorrectly configured trusted publisher fails at npm rather than silently skipping publication. - [ ] Publishing uses `npm publish --access public --provenance` on a GitHub-hosted Linux runner. `package.json` `repository.url` must match the GitHub repository for trusted publishing. Already-published names are never renamed. ### Maven Central: primary Java distribution From 42231beb39cfe3dc61f0bc5cbb696252d92c6a17 Mon Sep 17 00:00:00 2001 From: Nikhil Pareek Date: Fri, 30 Oct 2026 23:13:17 -0700 Subject: [PATCH 11/11] test(cerebras): compare __version__ with package metadata The test hardcoded 0.1.0 and fails now that release automation bumps the package to 0.1.1; it was skipped while cerebras was on the known-broken list (#293 removed it). Compare with installed metadata instead. Co-Authored-By: Claude Opus 5.5 --- python/frameworks/cerebras/tests/test_instrumentor.py | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/python/frameworks/cerebras/tests/test_instrumentor.py b/python/frameworks/cerebras/tests/test_instrumentor.py index d3c0ecfa0..b585fcb2f 100644 --- a/python/frameworks/cerebras/tests/test_instrumentor.py +++ b/python/frameworks/cerebras/tests/test_instrumentor.py @@ -10,8 +10,10 @@ class TestCerebrasInstrumentor: """Tests for CerebrasInstrumentor class.""" def test_version_defined(self): - """Test that version is defined.""" - assert __version__ == "0.1.0" + """The runtime version matches the installed package metadata.""" + from importlib.metadata import version + + assert __version__ == version("traceAI-cerebras") def test_instrumentation_dependencies(self): """Test instrumentation dependencies."""