atomadic-forge 0.76.0__tar.gz → 0.77.0__tar.gz

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## v0.77.0 — 2026-05-08
+
+- fix(forge): cherry-pick — collapse Class.method explosion (root-cause)
+- feat(doc-update): auto-update 6 previously missed doc files on release
+
+
 ## v0.76.0 — 2026-05-08
 
 - feat(forge): graft — surgical single-symbol cross-repo capability transfer

{atomadic_forge-0.76.0/src/atomadic_forge.egg-info → atomadic_forge-0.77.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atomadic-forge
-Version: 0.76.0
+Version: 0.77.0
 Summary: Atomadic Forge — absorb, enforce, emerge. Polyglot (Python · JavaScript/TypeScript · Rust · Go · Swift · Kotlin) architecture guardian for AI-generated code.
 Author: Atomadic
 License-Expression: BUSL-1.1
@@ -226,7 +226,7 @@ Full tool reference: [docs/MCP_TOOLS.md](docs/MCP_TOOLS.md) | First call: `welco
 | MCP tools | **10 tools · 116 actions** |
 | CLI verbs | **59** |
 | Source files | **232** (~47K LOC) |
-| Tests | **1578 passing** across **114 test files** |
+| Tests | **1588 passing** across **115 test files** |
 | Lean4 formal proofs | **872 theorems** (mathematically verified core logic) |
 | Monadic tiers | **5** (a0 → a4, strict upward-only composition) |
 | Languages | Python, JS/TS, Swift, Kotlin, Go, Rust |

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/README.md

@@ -194,7 +194,7 @@ Full tool reference: [docs/MCP_TOOLS.md](docs/MCP_TOOLS.md) | First call: `welco
 | MCP tools | **10 tools · 116 actions** |
 | CLI verbs | **59** |
 | Source files | **232** (~47K LOC) |
-| Tests | **1578 passing** across **114 test files** |
+| Tests | **1588 passing** across **115 test files** |
 | Lean4 formal proofs | **872 theorems** (mathematically verified core logic) |
 | Monadic tiers | **5** (a0 → a4, strict upward-only composition) |
 | Languages | Python, JS/TS, Swift, Kotlin, Go, Rust |

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/docs/CI_CD.md

@@ -46,7 +46,7 @@ jobs:
         run: |
           pip install atomadic-forge          # PyPI (preferred)
           # Or pin to an exact tag:
-          #   pip install "git+https://github.com/atomadictech/atomadic-forge@v0.60.0"
+          #   pip install "git+https://github.com/atomadictech/atomadic-forge@v0.77.0"
           # Or vendor wheels: pip install --no-index --find-links wheels/ atomadic-forge
 
       - name: Wire scan (upward-import discipline)
@@ -97,7 +97,7 @@ forge-certify:
   image: python:3.11-slim
   timeout: 10 minutes
   before_script:
-    - pip install "git+https://github.com/atomadictech/atomadic-forge@v0.60.0"
+    - pip install "git+https://github.com/atomadictech/atomadic-forge@v0.77.0"
   script:
     - forge wire src/your_package --fail-on-violations --json > wire.json
     - forge certify . --package your_package --fail-under 75 --json > certify.json
@@ -156,7 +156,7 @@ Then in **the consuming repo's** `.pre-commit-config.yaml`:
 ```yaml
 repos:
   - repo: https://github.com/atomadictech/atomadic-forge
-    rev: v0.60.0
+    rev: v0.77.0
     hooks:
       - id: forge-wire
       - id: forge-certify

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/docs/COMMANDS.md

@@ -1,6 +1,6 @@
 # Atomadic Forge — Command Reference
 
-All verbs available in the `forge` CLI as of 0.60.0.
+All verbs available in the `forge` CLI as of 0.77.0
 
 > For the structured per-verb reference (with options, examples, and
 > output samples), see [02-commands.md](02-commands.md). This page is

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/docs/FORMALIZATION.md

@@ -39,7 +39,7 @@ Forge certify scores out of **100** in two layers:
 JS / TS packages cap at **60/100** today: they earn the four
 structural axes, but the +25 runtime-import smoke and +30 behavioural
 pytest are Python-only. Wiring `npm test` / Vitest into the
-behavioural axis is on the post-v0.60.0 roadmap.
+behavioural axis is on the post-v0.77.0 roadmap.
 
 ---
 
@@ -131,7 +131,7 @@ runtime dependency makes the package unusable.
 
 **Why JS/TS does not get this gate yet.** AAM §5.4 (Threats to
 Validity) explicitly flags polyglot runtime gating as a roadmap
-item (post-v0.60.0): the equivalent for JS would be an `npm test`
+item (post-v0.77.0): the equivalent for JS would be an `npm test`
 invocation, which requires a Node toolchain we do not yet bundle.
 
 **Citation.** AAM §5.1 (Core Pipeline Pseudocode); AAM §5.4 (Threats

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/docs/MCP_TOOLS.md

@@ -1,6 +1,6 @@
 # Forge MCP Tools Reference
 
-Forge ships a Model Context Protocol server exposing **10 tools dispatching 112 registry-callable actions**. Counts are auto-synced from `forge_metrics.json` by `doc-update`.
+Forge ships a Model Context Protocol server exposing **10 tools dispatching 116 registry-callable actions**. Counts are auto-synced from `forge_metrics.json` by `doc-update`.
 The per-tool table below lists the primary dispatch actions; the headline total also includes compatibility routes that keep older callers working.
 All legacy tool names redirect automatically — existing callers keep working.
 
@@ -17,7 +17,7 @@ All legacy tool names redirect automatically — existing callers keep working.
 | Tool | Actions | Purpose |
 |------|---------|---------|
 | [`welcome`](#welcome) | — | Session onboarding: scan, score, narrative, capability tour |
-| [`explore`](#explore) | 16 | Analyze and understand a codebase — recon, call graphs, smells, harvest, discovery |
+| [`explore`](#explore) | 17 | Analyze and understand a codebase — recon, call graphs, smells, harvest, discovery |
 | [`audit`](#audit) | 23 | Quality gates, change safety, trust verification |
 | [`plan`](#plan) | 10 | Dev orientation and utilities — context packs, recipes, commit messages, steersman packs |
 | [`transmute`](#transmute) | 3 | **FLAGSHIP** spaghetti-to-certified pipeline |

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/docs/RECEIPT.md

@@ -30,7 +30,7 @@ referenced from the Receipt.
 {
   "schema_version": "atomadic-forge.receipt/v1",
   "generated_at_utc": "2026-04-28T17:42:11Z",
-  "forge_version": "0.60.0",
+  "forge_version": "0.77.0",
   "verdict": "PASS",
   "project":           { ... },
   "certify":           { ... },
@@ -108,7 +108,7 @@ cited:
 {
   "schema_version": "atomadic-forge.receipt/v1",
   "generated_at_utc": "2026-04-28T17:42:11Z",
-  "forge_version": "0.60.0",
+  "forge_version": "0.77.0",
   "verdict": "PASS",
 
   "project": {

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "atomadic-forge"
-version = "0.76.0"
+version = "0.77.0"
 description = "Atomadic Forge — absorb, enforce, emerge. Polyglot (Python · JavaScript/TypeScript · Rust · Go · Swift · Kotlin) architecture guardian for AI-generated code."
 readme = "README.md"
 requires-python = ">=3.10"

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/src/atomadic_forge/a1_at_functions/cherry_pick.py

@@ -62,6 +62,7 @@ def select_items(scout_report: dict, *, names: Iterable[str] | None = None,
             "confidence": _confidence_of(s),
             "reasons": _reasons_for(s),
         })
+    items = _dedup_methods_under_class(items)
     return {
         "schema_version": "atomadic-forge.cherry/v1",
         "source_repo": scout_report.get("repo", ""),
@@ -69,6 +70,32 @@ def select_items(scout_report: dict, *, names: Iterable[str] | None = None,
     }
 
 
+def _dedup_methods_under_class(items: list[dict]) -> list[dict]:
+    """Collapse ``Class.method`` items when ``Class`` is already selected.
+
+    The 47-file class explosion fix: scout enumerates a class plus every
+    public method as separate symbols (``IndexStore`` and
+    ``IndexStore.add``, ``IndexStore.search``, ...). Without this filter,
+    finalize copies the same source file once per qualname under
+    different slugs, exploding a single class into N near-identical files.
+
+    When the parent class is in the manifest, we drop its methods —
+    they ride along inside the class body. When the parent is absent
+    (rare; scout dropped it), we keep the methods so capability isn't
+    lost.
+    """
+    class_quals = {it["qualname"] for it in items if "." not in it["qualname"]}
+    out: list[dict] = []
+    for it in items:
+        qual = it["qualname"]
+        if "." in qual:
+            parent = qual.rsplit(".", 1)[0]
+            if parent in class_quals:
+                continue
+        out.append(it)
+    return out
+
+
 def _confidence_of(symbol: dict) -> float:
     # High confidence when name tokens drove the decision; lower when we fell
     # back to the kind-default (function→a1, class→a2).  Cheap proxy: complexity

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/src/atomadic_forge/a1_at_functions/doc_auto_update.py

@@ -2,9 +2,11 @@
 
 Zero LLM tokens.  Reads forge_metrics.json, inspects MCP enum lists and CLI
 command decorators, then rewrites bounded sections in README.md, CHANGELOG.md,
-docs/IDE_INTEGRATION.md, WHITEPAPER.md, and docs/AGENTS_GUIDE.md
-programmatically.  Every value is derived from live code or the metrics artifact
-— no human-authored prose is touched.
+docs/IDE_INTEGRATION.md, WHITEPAPER.md, docs/AGENTS_GUIDE.md,
+tests/README.md, docs/CI_CD.md, docs/COMMANDS.md, docs/RECEIPT.md,
+docs/FORMALIZATION.md, and docs/MCP_TOOLS.md programmatically.  Every value
+is derived from live code or the metrics artifact — no human-authored prose
+is touched.
 
 Updateable sections
 -------------------
@@ -29,6 +31,26 @@ WHITEPAPER.md
 docs/AGENTS_GUIDE.md
   • Summary table rows matching ``| explore | NN actions |`` pattern (if present).
 
+tests/README.md
+  • "NN test files covering N,NNN passing tests" line.
+
+docs/CI_CD.md
+  • Git-pinned install URLs ``atomadic-forge@vX.Y.Z`` → current version.
+  • Pre-commit ``rev: vX.Y.Z`` pin → current version.
+
+docs/COMMANDS.md
+  • "as of X.Y.Z" version anchor in header.
+
+docs/RECEIPT.md
+  • ``"forge_version": "X.Y.Z"`` in example JSON payloads.
+
+docs/FORMALIZATION.md
+  • ``post-vX.Y.Z`` roadmap anchors.
+
+docs/MCP_TOOLS.md
+  • Header line ``NN tools dispatching NN registry-callable actions``.
+  • Per-tool action counts in the summary table.
+
 Pure: no subprocess unless git is requested.  No writes when dry_run=True.
 """
 from __future__ import annotations
@@ -78,6 +100,33 @@ _DRIFT_TOOLS_RE = re.compile(r'(\d+)\s+MCP\s+tools')
 _DRIFT_ACTIONS_RE = re.compile(r'dispatching\s+(\d+)\s+actions')
 _DRIFT_TESTS_RE = re.compile(r'([\d,]+)\s+passing\s+tests')
 
+# ── version-anchor regexes (update_version_anchors) ───────────────────────────
+# tests/README.md: "NN test files covering N,NNN passing tests"
+_TESTS_README_RE = re.compile(r'\d+ test files covering [\d,]+ passing tests')
+
+# docs/CI_CD.md: git-pinned install URL and pre-commit rev pin
+_CICD_GIT_URL_RE = re.compile(r'(atomadic-forge@)v[\d.]+')
+_CICD_REV_RE = re.compile(r'(rev:\s*)v[\d.]+')
+
+# docs/COMMANDS.md: "as of X.Y.Z" header anchor
+_COMMANDS_VER_RE = re.compile(r'(as of )[\d.]+')
+
+# docs/RECEIPT.md: forge_version in example JSON blocks (both occurrences)
+_RECEIPT_VER_RE = re.compile(r'("forge_version":\s*")[\d.]+(")')
+
+# docs/FORMALIZATION.md: "post-vX.Y.Z" roadmap anchors
+_FORMALIZATION_POST_VER_RE = re.compile(r'post-v[\d.]+')
+
+# docs/MCP_TOOLS.md: header count line
+_MCP_TOOLS_HEADER_RE = re.compile(
+    r'\d+ tools dispatching \d+ registry-callable actions'
+)
+# docs/MCP_TOOLS.md: per-tool summary table rows
+# Matches: | [`toolname`](#anchor) | NN | description |
+_MCP_TOOLS_ROW_RE = re.compile(
+    r'(\|\s*\[`(?P<tool>[^`]+)`\]\(#[^)]+\)\s*\|\s*)(?P<count>\d+)(\s*\|)'
+)
+
 
 # ── helpers ───────────────────────────────────────────────────────────────────
 
@@ -602,12 +651,146 @@ def detect_doc_drift(project_root: Path) -> dict[str, Any]:
     }
 
 
+# ── version-anchor updater ────────────────────────────────────────────────────
+
+def update_version_anchors(
+    project_root: Path,
+    *,
+    dry_run: bool = False,
+) -> dict[str, Any]:
+    """Rewrite version-pinned strings in docs that drift on every release.
+
+    Covers tests/README.md, docs/CI_CD.md, docs/COMMANDS.md, docs/RECEIPT.md,
+    docs/FORMALIZATION.md, and docs/MCP_TOOLS.md.  Each pattern is keyed to
+    live forge_metrics.json so no version string needs manual updating.
+    """
+    metrics = _load_metrics(project_root)
+    if not metrics:
+        return {
+            "schema_version": SCHEMA_VERSION_DOC_AUTO_UPDATE_V1,
+            "available": False,
+            "reason": "forge_metrics.json not found or empty",
+            "changes": [],
+            "dry_run": dry_run,
+        }
+
+    version = metrics.get("package_version", "")
+    test_files = metrics.get("test_files", "?")
+    test_functions = metrics.get("test_functions", "?")
+    mcp_tools = metrics.get("mcp_tools", "?")
+    mcp_actions = metrics.get("mcp_actions", "?")
+    changes: list[str] = []
+
+    # ── tests/README.md ───────────────────────────────────────────────────────
+    tests_readme = project_root / "tests" / "README.md"
+    if tests_readme.exists():
+        text = tests_readme.read_text(encoding="utf-8")
+        new_text = _TESTS_README_RE.sub(
+            f"{test_files} test files covering {test_functions} passing tests",
+            text,
+        )
+        if new_text != text:
+            if not dry_run:
+                tests_readme.write_text(new_text, encoding="utf-8")
+            changes.append(
+                f"tests/README.md: test counts → {test_files} files / {test_functions} tests"
+            )
+
+    if not version:
+        return {
+            "schema_version": SCHEMA_VERSION_DOC_AUTO_UPDATE_V1,
+            "available": True,
+            "changes": changes,
+            "warnings": ["package_version missing — skipped version-pinned files"],
+            "dry_run": dry_run,
+        }
+
+    # ── docs/CI_CD.md ─────────────────────────────────────────────────────────
+    cicd_path = project_root / "docs" / "CI_CD.md"
+    if cicd_path.exists():
+        text = cicd_path.read_text(encoding="utf-8")
+        new_text = _CICD_GIT_URL_RE.sub(rf"\g<1>v{version}", text)
+        new_text = _CICD_REV_RE.sub(rf"\g<1>v{version}", new_text)
+        if new_text != text:
+            if not dry_run:
+                cicd_path.write_text(new_text, encoding="utf-8")
+            changes.append(f"docs/CI_CD.md: pinned version → v{version}")
+
+    # ── docs/COMMANDS.md ──────────────────────────────────────────────────────
+    commands_path = project_root / "docs" / "COMMANDS.md"
+    if commands_path.exists():
+        text = commands_path.read_text(encoding="utf-8")
+        new_text = _COMMANDS_VER_RE.sub(rf"\g<1>{version}", text)
+        if new_text != text:
+            if not dry_run:
+                commands_path.write_text(new_text, encoding="utf-8")
+            changes.append(f"docs/COMMANDS.md: version anchor → {version}")
+
+    # ── docs/RECEIPT.md ───────────────────────────────────────────────────────
+    receipt_path = project_root / "docs" / "RECEIPT.md"
+    if receipt_path.exists():
+        text = receipt_path.read_text(encoding="utf-8")
+        new_text = _RECEIPT_VER_RE.sub(rf'\g<1>{version}\g<2>', text)
+        if new_text != text:
+            if not dry_run:
+                receipt_path.write_text(new_text, encoding="utf-8")
+            changes.append(f"docs/RECEIPT.md: forge_version → {version}")
+
+    # ── docs/FORMALIZATION.md ─────────────────────────────────────────────────
+    formalization_path = project_root / "docs" / "FORMALIZATION.md"
+    if formalization_path.exists():
+        text = formalization_path.read_text(encoding="utf-8")
+        new_text = _FORMALIZATION_POST_VER_RE.sub(f"post-v{version}", text)
+        if new_text != text:
+            if not dry_run:
+                formalization_path.write_text(new_text, encoding="utf-8")
+            changes.append(f"docs/FORMALIZATION.md: post-version anchors → post-v{version}")
+
+    # ── docs/MCP_TOOLS.md ─────────────────────────────────────────────────────
+    mcp_tools_path = project_root / "docs" / "MCP_TOOLS.md"
+    if mcp_tools_path.exists() and mcp_tools != "?" and mcp_actions != "?":
+        text = mcp_tools_path.read_text(encoding="utf-8")
+        # Header line
+        new_text = _MCP_TOOLS_HEADER_RE.sub(
+            f"{mcp_tools} tools dispatching {mcp_actions} registry-callable actions",
+            text,
+        )
+        # Per-tool summary table rows
+        action_counts = _count_mcp_actions_per_tool(project_root)
+
+        def _replace_mcp_tools_row(match: re.Match[str]) -> str:
+            tool = match.group("tool")
+            if tool not in action_counts:
+                return match.group(0)
+            new_count = str(action_counts[tool])
+            if match.group("count") == new_count:
+                return match.group(0)
+            return match.group(1) + new_count + match.group(4)
+
+        new_text = _MCP_TOOLS_ROW_RE.sub(_replace_mcp_tools_row, new_text)
+        if new_text != text:
+            if not dry_run:
+                mcp_tools_path.write_text(new_text, encoding="utf-8")
+            changes.append(
+                f"docs/MCP_TOOLS.md: header/rows → {mcp_tools} tools / {mcp_actions} actions"
+            )
+
+    return {
+        "schema_version": SCHEMA_VERSION_DOC_AUTO_UPDATE_V1,
+        "available": True,
+        "changes": changes,
+        "dry_run": dry_run,
+    }
+
+
 # ── main entry point ──────────────────────────────────────────────────────────
 
 def run_doc_auto_update(
     project_root: Path,
     *,
-    sections: tuple[str, ...] = ("readme", "changelog", "extended_docs"),
+    sections: tuple[str, ...] = (
+        "readme", "changelog", "extended_docs", "version_anchors"
+    ),
     dry_run: bool = False,
 ) -> dict[str, Any]:
     """Run all doc auto-update passes.
@@ -615,9 +798,13 @@ def run_doc_auto_update(
     Args:
         project_root: Repository root.
         sections: Which sections to update — any combination of
-                  ``"readme"``, ``"changelog"``, and ``"extended_docs"``.
-                  Defaults to all three.  ``"extended_docs"`` patches
-                  IDE_INTEGRATION.md, WHITEPAPER.md, and AGENTS_GUIDE.md.
+                  ``"readme"``, ``"changelog"``, ``"extended_docs"``, and
+                  ``"version_anchors"``.  Defaults to all four.
+                  ``"extended_docs"`` patches IDE_INTEGRATION.md,
+                  WHITEPAPER.md, and AGENTS_GUIDE.md.
+                  ``"version_anchors"`` patches tests/README.md,
+                  docs/CI_CD.md, docs/COMMANDS.md, docs/RECEIPT.md,
+                  docs/FORMALIZATION.md, and docs/MCP_TOOLS.md.
         dry_run: If True, return what would change without writing.
 
     Returns dict with ``schema_version``, ``results`` per section,
@@ -642,6 +829,11 @@ def run_doc_auto_update(
         results["extended_docs"] = r
         total += len(r.get("changes", []))
 
+    if "version_anchors" in sections:
+        r = update_version_anchors(root, dry_run=dry_run)
+        results["version_anchors"] = r
+        total += len(r.get("changes", []))
+
     # Self-verify: residual drift after all writes confirms every pattern fired.
     post_drift = detect_doc_drift(root) if not dry_run else {"drift_count": 0}
 

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0/src/atomadic_forge.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atomadic-forge
-Version: 0.76.0
+Version: 0.77.0
 Summary: Atomadic Forge — absorb, enforce, emerge. Polyglot (Python · JavaScript/TypeScript · Rust · Go · Swift · Kotlin) architecture guardian for AI-generated code.
 Author: Atomadic
 License-Expression: BUSL-1.1
@@ -226,7 +226,7 @@ Full tool reference: [docs/MCP_TOOLS.md](docs/MCP_TOOLS.md) | First call: `welco
 | MCP tools | **10 tools · 116 actions** |
 | CLI verbs | **59** |
 | Source files | **232** (~47K LOC) |
-| Tests | **1578 passing** across **114 test files** |
+| Tests | **1588 passing** across **115 test files** |
 | Lean4 formal proofs | **872 theorems** (mathematically verified core logic) |
 | Monadic tiers | **5** (a0 → a4, strict upward-only composition) |
 | Languages | Python, JS/TS, Swift, Kotlin, Go, Rust |

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/src/atomadic_forge.egg-info/SOURCES.txt

@@ -355,6 +355,7 @@ tests/test_capability_scout.py
 tests/test_card_renderer.py
 tests/test_certify_operational_axis.py
 tests/test_chat.py
+tests/test_cherry_dedup_class_methods.py
 tests/test_cherry_pick.py
 tests/test_classify_tier.py
 tests/test_classify_tier_ast_signals.py

atomadic_forge-0.77.0/tests/test_cherry_dedup_class_methods.py

@@ -0,0 +1,80 @@
+"""Tests for cherry-pick class/method dedup (47-file class explosion fix).
+
+When scout enumerates a class plus every public method as separate
+symbols, the cherry manifest must collapse the methods under the class
+so finalize copies the source file once — not once per method.
+"""
+from __future__ import annotations
+
+from atomadic_forge.a1_at_functions.cherry_pick import select_items
+
+
+def _scout_with_class_and_methods(method_count: int = 47) -> dict:
+    """A fake scout report with one class + N public methods, all in one file."""
+    symbols = [
+        {
+            "name": "IndexStore",
+            "qualname": "IndexStore",
+            "file": "src/jcm/search_index.py",
+            "tier_guess": "a2_mo_composites",
+            "complexity": 200,
+            "has_self_assign": True,
+            "effects": ["io"],
+            "kind": "class",
+        }
+    ]
+    for i in range(method_count):
+        symbols.append({
+            "name": f"method_{i}",
+            "qualname": f"IndexStore.method_{i}",
+            "file": "src/jcm/search_index.py",
+            "tier_guess": "a1_at_functions",
+            "complexity": 50,
+            "has_self_assign": False,
+            "effects": ["pure"],
+            "kind": "method",
+        })
+    return {"repo": "jcm", "symbols": symbols}
+
+
+def test_class_picked_methods_folded():
+    """When the class is in the manifest, none of its methods survive cherry."""
+    report = _scout_with_class_and_methods(47)
+    manifest = select_items(report, pick_all=True)
+    quals = [it["qualname"] for it in manifest["items"]]
+    assert "IndexStore" in quals
+    # Not one method survives — they ride along inside the class body.
+    assert not any("." in q for q in quals)
+    # Exactly one item, not 48.
+    assert len(manifest["items"]) == 1
+
+
+def test_orphan_methods_kept_when_class_absent():
+    """If scout dropped the parent class, the methods are still cherry-picked
+    so capability isn't silently lost."""
+    report = _scout_with_class_and_methods(3)
+    # Strip the class; keep only the methods.
+    report["symbols"] = [s for s in report["symbols"] if s["kind"] == "method"]
+    manifest = select_items(report, pick_all=True)
+    quals = [it["qualname"] for it in manifest["items"]]
+    assert quals == [
+        "IndexStore.method_0", "IndexStore.method_1", "IndexStore.method_2",
+    ]
+
+
+def test_free_function_alongside_class():
+    """A free function in the same module is independent — kept."""
+    report = _scout_with_class_and_methods(2)
+    report["symbols"].append({
+        "name": "tokenize",
+        "qualname": "tokenize",
+        "file": "src/jcm/search_index.py",
+        "tier_guess": "a1_at_functions",
+        "complexity": 30,
+        "has_self_assign": False,
+        "effects": ["pure"],
+        "kind": "function",
+    })
+    manifest = select_items(report, pick_all=True)
+    quals = sorted(it["qualname"] for it in manifest["items"])
+    assert quals == ["IndexStore", "tokenize"]

{atomadic_forge-0.76.0 → atomadic_forge-0.77.0}/tests/test_doc_auto_update.py

@@ -16,6 +16,7 @@ from atomadic_forge.a1_at_functions.doc_auto_update import (
     update_changelog,
     update_extended_docs,
     update_readme,
+    update_version_anchors,
 )
 
 
@@ -184,6 +185,108 @@ def test_count_mcp_actions_per_tool_real_project() -> None:
     assert counts.get("audit", 0) > 10
 
 
+def test_update_version_anchors_tests_readme(tmp_project: Path) -> None:
+    tests_dir = tmp_project / "tests"
+    tests_dir.mkdir()
+    (tests_dir / "README.md").write_text(
+        "The `tests/` directory contains 111 test files covering 1,550 passing tests\n",
+        encoding="utf-8",
+    )
+    result = update_version_anchors(tmp_project, dry_run=False)
+    assert result["available"]
+    text = (tests_dir / "README.md").read_text(encoding="utf-8")
+    assert "106 test files covering 1490 passing tests" in text
+    assert any("tests/README.md" in c for c in result["changes"])
+
+
+def test_update_version_anchors_cicd(tmp_project: Path) -> None:
+    docs_dir = tmp_project / "docs"
+    docs_dir.mkdir()
+    (docs_dir / "CI_CD.md").write_text(
+        'pip install "git+https://github.com/atomadictech/atomadic-forge@v0.60.0"\n'
+        "rev: v0.60.0\n",
+        encoding="utf-8",
+    )
+    result = update_version_anchors(tmp_project, dry_run=False)
+    assert result["available"]
+    text = (docs_dir / "CI_CD.md").read_text(encoding="utf-8")
+    assert "@v0.55.0" in text
+    assert "rev: v0.55.0" in text
+    assert "v0.60.0" not in text
+    assert any("CI_CD.md" in c for c in result["changes"])
+
+
+def test_update_version_anchors_commands(tmp_project: Path) -> None:
+    docs_dir = tmp_project / "docs"
+    docs_dir.mkdir(exist_ok=True)
+    (docs_dir / "COMMANDS.md").write_text(
+        "All verbs available in the `forge` CLI as of 0.60.0.\n",
+        encoding="utf-8",
+    )
+    result = update_version_anchors(tmp_project, dry_run=False)
+    assert result["available"]
+    text = (docs_dir / "COMMANDS.md").read_text(encoding="utf-8")
+    assert "as of 0.55.0" in text
+    assert any("COMMANDS.md" in c for c in result["changes"])
+
+
+def test_update_version_anchors_receipt(tmp_project: Path) -> None:
+    docs_dir = tmp_project / "docs"
+    docs_dir.mkdir(exist_ok=True)
+    (docs_dir / "RECEIPT.md").write_text(
+        '  "forge_version": "0.60.0",\n'
+        '  "forge_version": "0.60.0",\n',
+        encoding="utf-8",
+    )
+    result = update_version_anchors(tmp_project, dry_run=False)
+    assert result["available"]
+    text = (docs_dir / "RECEIPT.md").read_text(encoding="utf-8")
+    assert '"forge_version": "0.55.0"' in text
+    assert "0.60.0" not in text
+    assert any("RECEIPT.md" in c for c in result["changes"])
+
+
+def test_update_version_anchors_formalization(tmp_project: Path) -> None:
+    docs_dir = tmp_project / "docs"
+    docs_dir.mkdir(exist_ok=True)
+    (docs_dir / "FORMALIZATION.md").write_text(
+        "on the post-v0.60.0 roadmap.\n"
+        "post-v0.60.0 equivalent for JS\n",
+        encoding="utf-8",
+    )
+    result = update_version_anchors(tmp_project, dry_run=False)
+    assert result["available"]
+    text = (docs_dir / "FORMALIZATION.md").read_text(encoding="utf-8")
+    assert "post-v0.55.0" in text
+    assert "v0.60.0" not in text
+    assert any("FORMALIZATION.md" in c for c in result["changes"])
+
+
+def test_update_version_anchors_mcp_tools_header(tmp_project: Path) -> None:
+    docs_dir = tmp_project / "docs"
+    docs_dir.mkdir(exist_ok=True)
+    (docs_dir / "MCP_TOOLS.md").write_text(
+        "Forge ships a Model Context Protocol server exposing "
+        "**10 tools dispatching 81 registry-callable actions**.\n"
+        "| [`explore`](#explore) | 14 | Analyze |\n",
+        encoding="utf-8",
+    )
+    result = update_version_anchors(tmp_project, dry_run=False)
+    assert result["available"]
+    text = (docs_dir / "MCP_TOOLS.md").read_text(encoding="utf-8")
+    assert "10 tools dispatching 78 registry-callable actions" in text
+    assert any("MCP_TOOLS.md" in c for c in result["changes"])
+
+
+def test_run_doc_auto_update_includes_version_anchors(tmp_project: Path) -> None:
+    (tmp_project / "docs").mkdir(exist_ok=True)
+    result = run_doc_auto_update(
+        tmp_project, sections=("version_anchors",), dry_run=True
+    )
+    assert result["available"]
+    assert "version_anchors" in result["results"]
+
+
 def test_extended_docs_updates_wrapped_whitepaper_tool_phrase(tmp_project: Path) -> None:
     (tmp_project / "WHITEPAPER.md").write_text(
         "Traction: **10 MCP\n"