chaindiff 0.3.0__tar.gz → 0.3.1__tar.gz

{chaindiff-0.3.0/src/chaindiff.egg-info → chaindiff-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chaindiff
-Version: 0.3.0
+Version: 0.3.1
 Summary: Decide whether a node client upgrade is safe.
 Author: ehsanhajian
 License-Expression: MIT
@@ -262,7 +262,7 @@ A stale catalog cannot return exit 0 for `latest`. A setting with no rule is rep
 
 `check`, `plan`, and `scan` use the catalog shipped with the package. `refresh` is the only command that talks to GitHub. Set `GH_TOKEN` or `GITHUB_TOKEN` if you hit the unauthenticated rate limit.
 
-GitHub Actions refreshes the catalog twice a week, Monday and Thursday at 06:15 UTC, and merges the update when the release lists change. Run `chaindiff refresh` any time. `chaindiff refresh --client geth` limits the fetch to one client.
+GitHub Actions refreshes the catalog twice a week, Monday and Thursday at 06:15 UTC, and merges the update when the release lists change. When a new stable tag appears, that run publishes the next patch release, such as 0.3.1, so a fresh `pip install` includes the tag. A prerelease does not publish a ChainDiff release. The new tag is not reviewed. Run `chaindiff refresh` any time. `chaindiff refresh --client geth` limits the fetch to one client.
 
 The stored catalog is tags, dates, titles, and URLs. Release-note bodies stay on GitHub. A release title that mentions a security fix is reported as a warning. That warning does not by itself make the upgrade safe or unsafe.
 

{chaindiff-0.3.0 → chaindiff-0.3.1}/README.md

@@ -237,7 +237,7 @@ A stale catalog cannot return exit 0 for `latest`. A setting with no rule is rep
 
 `check`, `plan`, and `scan` use the catalog shipped with the package. `refresh` is the only command that talks to GitHub. Set `GH_TOKEN` or `GITHUB_TOKEN` if you hit the unauthenticated rate limit.
 
-GitHub Actions refreshes the catalog twice a week, Monday and Thursday at 06:15 UTC, and merges the update when the release lists change. Run `chaindiff refresh` any time. `chaindiff refresh --client geth` limits the fetch to one client.
+GitHub Actions refreshes the catalog twice a week, Monday and Thursday at 06:15 UTC, and merges the update when the release lists change. When a new stable tag appears, that run publishes the next patch release, such as 0.3.1, so a fresh `pip install` includes the tag. A prerelease does not publish a ChainDiff release. The new tag is not reviewed. Run `chaindiff refresh` any time. `chaindiff refresh --client geth` limits the fetch to one client.
 
 The stored catalog is tags, dates, titles, and URLs. Release-note bodies stay on GitHub. A release title that mentions a security fix is reported as a warning. That warning does not by itself make the upgrade safe or unsafe.
 

{chaindiff-0.3.0 → chaindiff-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "chaindiff"
-version = "0.3.0"
+version = "0.3.1"
 description = "Decide whether a node client upgrade is safe."
 readme = "README.md"
 license = "MIT"

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/__init__.py

@@ -1,3 +1,3 @@
 """Decide whether a node client upgrade is safe."""
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/avalanchego.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "avalanchego",
   "github": "ava-labs/avalanchego",
-  "fetched_at": "2026-10-07T06:03:39Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 1,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/besu.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "besu",
   "github": "besu-eth/besu",
-  "fetched_at": "2026-10-02T12:57:35Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 0,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/bor.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "bor",
   "github": "0xPolygon/bor",
-  "fetched_at": "2026-10-06T07:37:26Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 4,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/bsc.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "bsc",
   "github": "bnb-chain/bsc",
-  "fetched_at": "2026-10-07T05:56:42Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 2,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/erigon.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "erigon",
   "github": "erigontech/erigon",
-  "fetched_at": "2026-10-02T12:59:57Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 107,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/external-node.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "external-node",
   "github": "matter-labs/zksync-era",
-  "fetched_at": "2026-10-07T12:25:55Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 83,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/geth.json

@@ -2,9 +2,16 @@
   "schema_version": 1,
   "client": "geth",
   "github": "ethereum/go-ethereum",
-  "fetched_at": "2026-10-02T12:57:35Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 0,
   "releases": [
+    {
+      "tag": "v1.17.8",
+      "name": "Protein Sludge Pack (v1.17.8)",
+      "published_at": "2026-10-08T16:35:36Z",
+      "prerelease": false,
+      "url": "https://github.com/ethereum/go-ethereum/releases/tag/v1.17.8"
+    },
     {
       "tag": "v1.17.7",
       "name": "Intact Neuro-Coil (v1.17.7)",

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/heimdall.json

@@ -2,9 +2,16 @@
   "schema_version": 1,
   "client": "heimdall",
   "github": "0xPolygon/heimdall-v2",
-  "fetched_at": "2026-10-06T07:37:39Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 0,
   "releases": [
+    {
+      "tag": "v0.12.2-beta",
+      "name": "v0.12.2-beta",
+      "published_at": "2026-10-07T21:21:37Z",
+      "prerelease": true,
+      "url": "https://github.com/0xPolygon/heimdall-v2/releases/tag/v0.12.2-beta"
+    },
     {
       "tag": "v0.12.1",
       "name": "v0.12.1",

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/juno.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "juno",
   "github": "NethermindEth/juno",
-  "fetched_at": "2026-10-07T12:36:30Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 0,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/l2geth.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "l2geth",
   "github": "scroll-tech/go-ethereum",
-  "fetched_at": "2026-10-07T06:42:21Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 0,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/lighthouse.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "lighthouse",
   "github": "sigp/lighthouse",
-  "fetched_at": "2026-10-02T12:57:35Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 0,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/linea-besu.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "linea-besu",
   "github": "LFDT-Lineth/lineth-monorepo",
-  "fetched_at": "2026-10-07T06:27:39Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 324,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/maru.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "maru",
   "github": "LFDT-Lineth/lineth-monorepo",
-  "fetched_at": "2026-10-07T06:27:39Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 330,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/nethermind.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "nethermind",
   "github": "NethermindEth/nethermind",
-  "fetched_at": "2026-10-02T12:57:35Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 39,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/nimbus.json

@@ -2,9 +2,16 @@
   "schema_version": 1,
   "client": "nimbus",
   "github": "status-im/nimbus-eth2",
-  "fetched_at": "2026-10-02T12:57:35Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 2,
   "releases": [
+    {
+      "tag": "v26.10.0",
+      "name": "v26.10.0",
+      "published_at": "2026-10-04T11:28:04Z",
+      "prerelease": false,
+      "url": "https://github.com/status-im/nimbus-eth2/releases/tag/v26.10.0"
+    },
     {
       "tag": "v26.9.1",
       "name": "v26.9.1",

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/nitro.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "nitro",
   "github": "OffchainLabs/nitro",
-  "fetched_at": "2026-10-06T04:50:39Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 53,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/op-geth.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "op-geth",
   "github": "ethereum-optimism/op-geth",
-  "fetched_at": "2026-10-05T08:11:05Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 0,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/op-node.json

@@ -2,9 +2,16 @@
   "schema_version": 1,
   "client": "op-node",
   "github": "ethereum-optimism/optimism",
-  "fetched_at": "2026-10-05T08:13:19Z",
-  "ignored_tag_count": 2311,
+  "fetched_at": "2026-10-12T15:15:39Z",
+  "ignored_tag_count": 2317,
   "releases": [
+    {
+      "tag": "op-node/v1.19.9",
+      "name": "op-node v1.19.9",
+      "published_at": "2026-10-07T08:42:44Z",
+      "prerelease": false,
+      "url": "https://github.com/ethereum-optimism/optimism/releases/tag/op-node/v1.19.9"
+    },
     {
       "tag": "op-node/v1.19.8",
       "name": "op-node v1.19.8",

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/op-reth.json

@@ -2,9 +2,16 @@
   "schema_version": 1,
   "client": "op-reth",
   "github": "ethereum-optimism/optimism",
-  "fetched_at": "2026-10-05T08:13:19Z",
-  "ignored_tag_count": 2355,
+  "fetched_at": "2026-10-12T15:15:39Z",
+  "ignored_tag_count": 2361,
   "releases": [
+    {
+      "tag": "op-reth/v2.6.0",
+      "name": "op-reth v2.6.0",
+      "published_at": "2026-10-07T08:42:36Z",
+      "prerelease": false,
+      "url": "https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.6.0"
+    },
     {
       "tag": "op-reth/v2.5.0",
       "name": "op-reth v2.5.0",

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/pathfinder.json

@@ -2,9 +2,16 @@
   "schema_version": 1,
   "client": "pathfinder",
   "github": "software-mansion/pathfinder",
-  "fetched_at": "2026-10-07T12:36:30Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 0,
   "releases": [
+    {
+      "tag": "v0.24.2",
+      "name": "v0.24.2",
+      "published_at": "2026-10-07T15:59:15Z",
+      "prerelease": false,
+      "url": "https://github.com/software-mansion/pathfinder/releases/tag/v0.24.2"
+    },
     {
       "tag": "v0.24.1",
       "name": "v0.24.1",

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/prysm.json

@@ -2,9 +2,16 @@
   "schema_version": 1,
   "client": "prysm",
   "github": "OffchainLabs/prysm",
-  "fetched_at": "2026-10-02T12:57:35Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 1,
   "releases": [
+    {
+      "tag": "v7.2.1",
+      "name": "v.7.2.1",
+      "published_at": "2026-10-05T21:18:08Z",
+      "prerelease": false,
+      "url": "https://github.com/OffchainLabs/prysm/releases/tag/v7.2.1"
+    },
     {
       "tag": "v7.2.0",
       "name": "v7.2.0",

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/reth.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "client": "reth",
   "github": "paradigmxyz/reth",
-  "fetched_at": "2026-10-02T12:57:35Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 0,
   "releases": [
     {

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff/data/releases/teku.json

@@ -2,9 +2,16 @@
   "schema_version": 1,
   "client": "teku",
   "github": "Consensys-Incorporated/teku",
-  "fetched_at": "2026-10-02T12:57:35Z",
+  "fetched_at": "2026-10-12T15:15:39Z",
   "ignored_tag_count": 2,
   "releases": [
+    {
+      "tag": "26.10.0",
+      "name": "26.10.0",
+      "published_at": "2026-10-08T22:05:15Z",
+      "prerelease": false,
+      "url": "https://github.com/Consensys-Incorporated/teku/releases/tag/26.10.0"
+    },
     {
       "tag": "26.9.1",
       "name": "26.9.1",

chaindiff-0.3.1/src/chaindiff/versionbump.py

@@ -0,0 +1,143 @@
+"""Bump the patch version when the catalog gains a stable client tag."""
+
+from __future__ import annotations
+
+import json
+import re
+import sys
+from pathlib import Path
+
+_VERSION_LINE = re.compile(r'(?m)^version = "(\d+\.\d+\.\d+)"\s*$')
+_INIT_LINE = re.compile(r'(?m)^__version__ = "(\d+\.\d+\.\d+)"\s*$')
+_PATCH = re.compile(r"^(\d+)\.(\d+)\.(\d+)$")
+
+
+def stable_tags(releases_dir: Path) -> dict[str, set[str]]:
+    found: dict[str, set[str]] = {}
+    if not releases_dir.is_dir():
+        return found
+    for path in sorted(releases_dir.glob("*.json")):
+        payload = json.loads(path.read_text())
+        tags = {
+            str(item.get("tag", ""))
+            for item in payload.get("releases", [])
+            if item.get("tag") and not item.get("prerelease")
+        }
+        found[path.stem] = tags
+    return found
+
+
+def new_stable_tags(
+    before: dict[str, set[str]],
+    after: dict[str, set[str]],
+) -> list[tuple[str, str]]:
+    fresh: list[tuple[str, str]] = []
+    for client in sorted(after):
+        added = after[client] - before.get(client, set())
+        fresh.extend((client, tag) for tag in sorted(added))
+    return fresh
+
+
+def bump_patch(version: str) -> str:
+    matched = _PATCH.fullmatch(version.strip())
+    if matched is None:
+        raise ValueError(f"{version} is not a major.minor.patch version")
+    major, minor, patch = matched.groups()
+    return f"{major}.{minor}.{int(patch) + 1}"
+
+
+def _read_version(text: str, pattern: re.Pattern[str], path: Path) -> str:
+    matched = pattern.search(text)
+    if matched is None:
+        raise ValueError(f"{path} has no major.minor.patch version")
+    return matched.group(1)
+
+
+def bump_project(root: Path) -> str:
+    pyproject_path = root / "pyproject.toml"
+    init_path = root / "src" / "chaindiff" / "__init__.py"
+    pyproject = pyproject_path.read_text()
+    init = init_path.read_text()
+    current = _read_version(pyproject, _VERSION_LINE, pyproject_path)
+    init_version = _read_version(init, _INIT_LINE, init_path)
+    if current != init_version:
+        raise ValueError(f"pyproject.toml is {current} and __init__.py is {init_version}")
+    updated = bump_patch(current)
+    pyproject_path.write_text(_VERSION_LINE.sub(f'version = "{updated}"', pyproject, count=1))
+    init_path.write_text(_INIT_LINE.sub(f'__version__ = "{updated}"', init, count=1))
+    return updated
+
+
+def release_notes(tags: list[tuple[str, str]], version: str) -> str:
+    lines = [
+        f"ChainDiff {version} includes new stable client tags.",
+        "",
+        "New stable releases:",
+    ]
+    lines.extend(f"- {client} {tag}" for client, tag in tags)
+    lines.extend(
+        [
+            "",
+            "These tags are in the catalog. They are not reviewed.",
+            "A check that targets one of them stays review required until an advisory is added.",
+            "",
+        ]
+    )
+    return "\n".join(lines)
+
+
+def _releases_dir(root: Path) -> Path:
+    return root / "src" / "chaindiff" / "data" / "releases"
+
+
+def snapshot(root: Path, destination: Path) -> None:
+    payload = {client: sorted(tags) for client, tags in stable_tags(_releases_dir(root)).items()}
+    destination.write_text(json.dumps(payload))
+
+
+def _load_snapshot(path: Path) -> dict[str, set[str]]:
+    payload = json.loads(path.read_text())
+    return {str(client): set(tags) for client, tags in payload.items()}
+
+
+def bump_if_new(root: Path, before_path: Path, notes_path: Path) -> str | None:
+    fresh = new_stable_tags(_load_snapshot(before_path), stable_tags(_releases_dir(root)))
+    if not fresh:
+        return None
+    version = bump_project(root)
+    notes = release_notes(fresh, version)
+    notes_path.write_text(notes)
+    notes_path.with_name("new-version.txt").write_text(version + "\n")
+    commit_path = notes_path.with_name("new-stable-commit.txt")
+    commit_path.write_text(
+        "Refresh the catalog for new stable client releases.\n\n" + notes
+    )
+    return version
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = list(sys.argv[1:] if argv is None else argv)
+    if len(args) == 3 and args[0] == "snapshot":
+        snapshot(Path(args[1]), Path(args[2]))
+        return 0
+    if len(args) == 4 and args[0] == "bump-if-new":
+        try:
+            version = bump_if_new(Path(args[1]), Path(args[2]), Path(args[3]))
+        except ValueError as exc:
+            print(str(exc), file=sys.stderr)
+            return 1
+        if version is None:
+            print("No new stable client tag.")
+        else:
+            print(f"Patch version is {version}.")
+        return 0
+    print(
+        "usage: python -m chaindiff.versionbump snapshot ROOT DEST\n"
+        "       python -m chaindiff.versionbump bump-if-new ROOT BEFORE NOTES",
+        file=sys.stderr,
+    )
+    return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{chaindiff-0.3.0 → chaindiff-0.3.1/src/chaindiff.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chaindiff
-Version: 0.3.0
+Version: 0.3.1
 Summary: Decide whether a node client upgrade is safe.
 Author: ehsanhajian
 License-Expression: MIT
@@ -262,7 +262,7 @@ A stale catalog cannot return exit 0 for `latest`. A setting with no rule is rep
 
 `check`, `plan`, and `scan` use the catalog shipped with the package. `refresh` is the only command that talks to GitHub. Set `GH_TOKEN` or `GITHUB_TOKEN` if you hit the unauthenticated rate limit.
 
-GitHub Actions refreshes the catalog twice a week, Monday and Thursday at 06:15 UTC, and merges the update when the release lists change. Run `chaindiff refresh` any time. `chaindiff refresh --client geth` limits the fetch to one client.
+GitHub Actions refreshes the catalog twice a week, Monday and Thursday at 06:15 UTC, and merges the update when the release lists change. When a new stable tag appears, that run publishes the next patch release, such as 0.3.1, so a fresh `pip install` includes the tag. A prerelease does not publish a ChainDiff release. The new tag is not reviewed. Run `chaindiff refresh` any time. `chaindiff refresh --client geth` limits the fetch to one client.
 
 The stored catalog is tags, dates, titles, and URLs. Release-note bodies stay on GitHub. A release title that mentions a security fix is reported as a warning. That warning does not by itself make the upgrade safe or unsafe.
 

{chaindiff-0.3.0 → chaindiff-0.3.1}/src/chaindiff.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ src/chaindiff/pair.py
 src/chaindiff/refresh.py
 src/chaindiff/report.py
 src/chaindiff/scan.py
+src/chaindiff/versionbump.py
 src/chaindiff/versions.py
 src/chaindiff.egg-info/PKG-INFO
 src/chaindiff.egg-info/SOURCES.txt
@@ -99,4 +100,5 @@ tests/test_network.py
 tests/test_pair.py
 tests/test_refresh.py
 tests/test_scan.py
+tests/test_versionbump.py
 tests/test_versions.py

{chaindiff-0.3.0 → chaindiff-0.3.1}/tests/test_catalog.py

@@ -126,35 +126,35 @@ def test_shipped_catalog_drops_known_non_releases():
     _, bsc = load_releases("bsc")
     assert any(item.tag == "v1.7.8" and not item.prerelease for item in bsc)
     assert any(item.tag == "v1.8.0-alpha" and item.prerelease for item in bsc)
-    assert latest_stable(bsc).tag == "v1.7.8"
+    assert latest_stable(bsc).version >= parse_version("1.7.8")
     _, avalanchego = load_releases("avalanchego")
     assert any(item.tag == "v1.15.1" and not item.prerelease for item in avalanchego)
     assert any(item.tag == "v1.15.0-fuji" and item.prerelease for item in avalanchego)
-    assert latest_stable(avalanchego).tag == "v1.15.1"
+    assert latest_stable(avalanchego).version >= parse_version("1.15.1")
     _, linea_besu = load_releases("linea-besu")
     assert any(item.tag == "releases/linea-besu-package/v2.3.0" and not item.prerelease for item in linea_besu)
     assert any(item.tag == "releases/linea-besu-package/v2.1.1" and item.prerelease for item in linea_besu)
-    assert latest_stable(linea_besu).tag == "releases/linea-besu-package/v2.3.0"
+    assert latest_stable(linea_besu).version >= parse_version("2.3.0")
     assert all(item.tag.startswith("releases/linea-besu-package/") for item in linea_besu)
     assert all(not item.tag.startswith("releases/maru/") for item in linea_besu)
     assert all(not item.tag.startswith("releases/coordinator/") for item in linea_besu)
     _, maru = load_releases("maru")
     assert any(item.tag == "releases/maru/v1.4.0" and not item.prerelease for item in maru)
     assert any(item.tag == "releases/maru/v1.3.0" and not item.prerelease for item in maru)
-    assert latest_stable(maru).tag == "releases/maru/v1.4.0"
+    assert latest_stable(maru).version >= parse_version("1.4.0")
     assert all(item.tag.startswith("releases/maru/") for item in maru)
     assert all(not item.tag.startswith("releases/linea-besu-package/") for item in maru)
     assert all(not item.tag.startswith("releases/coordinator/") for item in maru)
     _, l2geth = load_releases("l2geth")
     assert any(item.tag == "scroll-v5.10.2" and not item.prerelease for item in l2geth)
     assert any(item.tag == "scroll-v5.8.52-fix" and item.prerelease for item in l2geth)
-    assert latest_stable(l2geth).tag == "scroll-v5.10.2"
+    assert latest_stable(l2geth).version >= parse_version("5.10.2")
     assert all(item.tag.startswith("scroll-") for item in l2geth)
     assert all(not item.tag.startswith("v1.") for item in l2geth)
     _, external_node = load_releases("external-node")
     assert any(item.tag == "core-v31.5.0" and not item.prerelease for item in external_node)
     assert any(item.tag == "core-v29.4.0" and not item.prerelease for item in external_node)
-    assert latest_stable(external_node).tag == "core-v31.5.0"
+    assert latest_stable(external_node).version >= parse_version("31.5.0")
     assert all(item.tag.startswith("core-") for item in external_node)
     assert all(not item.tag.startswith("prover-") for item in external_node)
     assert all(not item.tag.startswith("contract_verifier-") for item in external_node)
@@ -162,11 +162,11 @@ def test_shipped_catalog_drops_known_non_releases():
     _, pathfinder = load_releases("pathfinder")
     assert any(item.tag == "v0.24.0" and not item.prerelease for item in pathfinder)
     assert any(item.tag == "v0.22.8-beta.1" and item.prerelease for item in pathfinder)
-    assert latest_stable(pathfinder).tag == "v0.24.1"
+    assert latest_stable(pathfinder).version >= parse_version("0.24.0")
     _, juno = load_releases("juno")
     assert any(item.tag == "v0.16.6" and not item.prerelease for item in juno)
     assert any(item.tag == "v0.16.6-rc.4" and item.prerelease for item in juno)
-    assert latest_stable(juno).tag == "v0.16.8"
+    assert latest_stable(juno).version >= parse_version("0.16.6")
 
 
 def test_release_roundtrip(tmp_path, monkeypatch):

chaindiff-0.3.1/tests/test_versionbump.py

@@ -0,0 +1,94 @@
+import json
+from pathlib import Path
+
+import pytest
+
+from chaindiff.versionbump import (
+    bump_if_new,
+    bump_patch,
+    bump_project,
+    new_stable_tags,
+    snapshot,
+    stable_tags,
+)
+
+
+def _catalog(root: Path, releases: dict[str, list[dict]]) -> None:
+    directory = root / "src" / "chaindiff" / "data" / "releases"
+    directory.mkdir(parents=True, exist_ok=True)
+    for client, items in releases.items():
+        payload = {"schema_version": 1, "client": client, "releases": items}
+        (directory / f"{client}.json").write_text(json.dumps(payload))
+
+
+def _project(root: Path, version: str = "0.3.0") -> None:
+    (root / "pyproject.toml").write_text(f'[project]\nversion = "{version}"\n')
+    init = root / "src" / "chaindiff" / "__init__.py"
+    init.parent.mkdir(parents=True, exist_ok=True)
+    init.write_text(f'__version__ = "{version}"\n')
+
+
+def test_stable_tags_skip_prereleases(tmp_path):
+    _catalog(
+        tmp_path,
+        {
+            "geth": [
+                {"tag": "v1.17.8", "prerelease": False},
+                {"tag": "v1.17.9-rc.1", "prerelease": True},
+            ]
+        },
+    )
+    assert stable_tags(tmp_path / "src" / "chaindiff" / "data" / "releases") == {
+        "geth": {"v1.17.8"}
+    }
+
+
+def test_new_stable_tags_ignore_an_unchanged_catalog():
+    before = {"geth": {"v1.17.7"}}
+    after = {"geth": {"v1.17.7", "v1.17.8"}, "lighthouse": {"v8.2.4"}}
+    assert new_stable_tags(before, after) == [("geth", "v1.17.8"), ("lighthouse", "v8.2.4")]
+    assert new_stable_tags(before, {"geth": {"v1.17.7"}}) == []
+
+
+def test_bump_patch_increments_the_last_component():
+    assert bump_patch("0.3.0") == "0.3.1"
+    assert bump_patch("0.3.9") == "0.3.10"
+    with pytest.raises(ValueError):
+        bump_patch("0.3")
+
+
+def test_bump_project_keeps_the_two_version_files_together(tmp_path):
+    _project(tmp_path, "0.3.1")
+    assert bump_project(tmp_path) == "0.3.2"
+    assert 'version = "0.3.2"' in (tmp_path / "pyproject.toml").read_text()
+    assert '__version__ = "0.3.2"' in (tmp_path / "src/chaindiff/__init__.py").read_text()
+
+
+def test_bump_if_new_writes_notes_only_for_a_new_stable_tag(tmp_path):
+    _project(tmp_path)
+    _catalog(tmp_path, {"geth": [{"tag": "v1.17.7", "prerelease": False}]})
+    before = tmp_path / "before.json"
+    notes = tmp_path / "notes.txt"
+    snapshot(tmp_path, before)
+    assert bump_if_new(tmp_path, before, notes) is None
+    assert not notes.exists()
+    assert 'version = "0.3.0"' in (tmp_path / "pyproject.toml").read_text()
+
+    _catalog(
+        tmp_path,
+        {
+            "geth": [
+                {"tag": "v1.17.7", "prerelease": False},
+                {"tag": "v1.17.8", "prerelease": False},
+                {"tag": "v1.17.9-rc.1", "prerelease": True},
+            ],
+            "lighthouse": [{"tag": "v8.2.4", "prerelease": False}],
+        },
+    )
+    assert bump_if_new(tmp_path, before, notes) == "0.3.1"
+    text = notes.read_text()
+    assert "geth v1.17.8" in text
+    assert "lighthouse v8.2.4" in text
+    assert "v1.17.9-rc.1" not in text
+    assert "not reviewed" in text
+    assert (tmp_path / "new-version.txt").read_text().strip() == "0.3.1"