hermes-agent/tests/scripts/test_release_acp_registry.py
teknium1 c8c6ce1731 feat(acp-registry): switch to uvx distribution, drop npm launcher
The ACP Registry schema supports uvx as a first-class distribution method
alongside npx and binary. Pointing the registry directly at the existing
hermes-agent PyPI release removes:

- the @nousresearch npm scope (we don't own it)
- a separate npm publish step on every weekly release
- 90 lines of Node launcher + tests in packages/hermes-agent-acp/

The Zed registry now installs Hermes via:

  uvx --from 'hermes-agent[acp]==<version>' hermes-acp

This is the same command the npm launcher was shelling out to anyway, so
end-user behavior is unchanged. Registry CI validates the PyPI URL +
version-pin exact match automatically.

Changes:
- acp_registry/agent.json: distribution.npx -> distribution.uvx
- delete packages/hermes-agent-acp/ entirely
- scripts/release.py: drop npm-launcher bump paths, keep manifest lockstep
- tests/acp/test_registry_manifest.py: assert uvx shape + version pin
- tests/scripts/test_release_acp_registry.py: rewrite for uvx-only shape
- docs (user-guide + dev-guide): drop all npm-launcher references
- delete docs/plans/acp-registry-zed-integration.md (stale, npm-shaped)

Validated against agentclientprotocol/registry agent.schema.json via
jsonschema. hermes-agent==0.13.0 is already live on PyPI.
2026-05-14 22:27:09 -07:00

113 lines
4 KiB
Python

"""Tests for the ACP Registry version-lockstep bump in scripts/release.py.
The official ACP Registry manifest must match ``pyproject.toml`` exactly —
``tests/acp/test_registry_manifest.py`` enforces this at lint time, and the
upstream registry CI rejects ``@latest`` / floating pins. The release script
is the single place that bumps the manifest in lockstep with pyproject; if
that bump ever silently breaks, weekly releases fail the manifest test
until someone hand-edits the JSON.
"""
from __future__ import annotations
import importlib.util
import json
from pathlib import Path
def _load_release_module(monkeypatch, tmp_root: Path):
"""Import scripts/release.py with REPO_ROOT pinned to a temp tree."""
spec = importlib.util.spec_from_file_location(
"_release_under_test",
Path(__file__).resolve().parents[2] / "scripts" / "release.py",
)
assert spec and spec.loader
module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(module)
monkeypatch.setattr(module, "REPO_ROOT", tmp_root)
monkeypatch.setattr(
module, "ACP_REGISTRY_MANIFEST", tmp_root / "acp_registry" / "agent.json"
)
return module
def _write_manifest(root: Path, version: str) -> None:
manifest_dir = root / "acp_registry"
manifest_dir.mkdir(parents=True)
(manifest_dir / "agent.json").write_text(
json.dumps(
{
"id": "hermes-agent",
"name": "Hermes Agent",
"version": version,
"description": "test",
"distribution": {
"uvx": {
"package": f"hermes-agent[acp]=={version}",
"args": ["hermes-acp"],
}
},
},
indent=2,
)
+ "\n",
encoding="utf-8",
)
def test_update_acp_registry_versions_bumps_manifest_and_pin(monkeypatch, tmp_path):
_write_manifest(tmp_path, "0.13.0")
module = _load_release_module(monkeypatch, tmp_path)
module._update_acp_registry_versions("0.14.0")
manifest = json.loads(
(tmp_path / "acp_registry" / "agent.json").read_text(encoding="utf-8")
)
assert manifest["version"] == "0.14.0"
assert manifest["distribution"]["uvx"]["package"] == "hermes-agent[acp]==0.14.0"
# args stay untouched so we don't accidentally rewrite them.
assert manifest["distribution"]["uvx"]["args"] == ["hermes-acp"]
def test_update_acp_registry_versions_is_silent_when_manifest_missing(
monkeypatch, tmp_path
):
"""Older release branches predate the ACP Registry asset — must no-op."""
module = _load_release_module(monkeypatch, tmp_path)
# No fixture written; function should not raise.
module._update_acp_registry_versions("0.14.0")
def test_update_version_files_bumps_manifest_alongside_pyproject(
monkeypatch, tmp_path
):
"""End-to-end: update_version_files() is the function release.py actually
calls, so it must drive the manifest bump too."""
_write_manifest(tmp_path, "0.13.0")
(tmp_path / "pyproject.toml").write_text(
'[project]\nname = "hermes-agent"\nversion = "0.13.0"\n', encoding="utf-8"
)
version_dir = tmp_path / "hermes_cli"
version_dir.mkdir()
(version_dir / "__init__.py").write_text(
'__version__ = "0.13.0"\n__release_date__ = "2026-05-14"\n',
encoding="utf-8",
)
module = _load_release_module(monkeypatch, tmp_path)
monkeypatch.setattr(module, "VERSION_FILE", version_dir / "__init__.py")
monkeypatch.setattr(module, "PYPROJECT_FILE", tmp_path / "pyproject.toml")
module.update_version_files("0.14.0", "2026-05-21")
pyproject_text = (tmp_path / "pyproject.toml").read_text(encoding="utf-8")
assert 'version = "0.14.0"' in pyproject_text
manifest = json.loads(
(tmp_path / "acp_registry" / "agent.json").read_text(encoding="utf-8")
)
assert manifest["version"] == "0.14.0"
assert manifest["distribution"]["uvx"]["package"] == "hermes-agent[acp]==0.14.0"