atomadic-forge 0.75.0__tar.gz → 0.75.2__tar.gz

{atomadic_forge-0.75.0 → atomadic_forge-0.75.2}/.github/workflows/mcp-registry-publish.yml

@@ -73,9 +73,9 @@ jobs:
           v="${{ steps.ver.outputs.version }}"
           # Pull live numbers so the registry description always cites
           # the current MCP tool / action count instead of drifting.
-          tools=$(jq -r '.mcp_tools // 10' forge_metrics.json)
-          actions=$(jq -r '.mcp_actions // 64' forge_metrics.json)
-          theorems=$(jq -r '.lean_theorems.count // 886' forge_metrics.json)
+          tools=$(jq -r '.mcp_tools // .metrics.mcp_tool_count // 10' forge_metrics.json)
+          actions=$(jq -r '.mcp_actions // .metrics.mcp_action_count // 64' forge_metrics.json)
+          theorems=$(jq -r '.lean_theorems.count // .metrics.lean4_theorem_count // 886' forge_metrics.json)
           # Rewrite version (top-level + first package entry) and refresh
           # the description string with the live numbers.
           # Registry caps description at 100 chars — keep it punchy +

{atomadic_forge-0.75.0 → atomadic_forge-0.75.2}/.github/workflows/metrics-auto-regen.yml

@@ -73,7 +73,22 @@ jobs:
           # Save the previous lean_theorems block so we can preserve it
           # when no proof corpus is attached (avoid zeroing the public
           # number on a routine source-only push).
-          python -c "import json; d=json.load(open('forge_metrics.json')); print(json.dumps(d.get('lean_theorems', {})))" > /tmp/prev_lean.json
+          python - <<'PY' > /tmp/prev_lean.json
+          import json
+          d = json.load(open("forge_metrics.json"))
+          if isinstance(d.get("lean_theorems"), dict):
+              print(json.dumps(d["lean_theorems"]))
+          else:
+              m = d.get("metrics", {})
+              count = int(m.get("lean4_theorem_count") or 0)
+              print(json.dumps({
+                  "count": count,
+                  "theorems": count,
+                  "lemmas": 0,
+                  "files": int(m.get("lean4_file_count") or 0),
+                  "found": bool(count),
+              }))
+          PY
           forge metrics --apply --tests-passing ${{ steps.pytest.outputs.passed }}
           # If no proof corpus was attached this run, restore prior lean block.
           if [ -z "${FORGE_PROOF_CORPUS:-}" ]; then
@@ -82,10 +97,14 @@ jobs:
           p = pathlib.Path("forge_metrics.json")
           d = json.loads(p.read_text())
           prev = json.loads(pathlib.Path("/tmp/prev_lean.json").read_text())
-          # Only restore if the freshly-computed block reports found=False
-          # (i.e. proof corpus unavailable) AND the prior had a real count.
-          if not d.get("lean_theorems", {}).get("found") and prev.get("count"):
-              d["lean_theorems"] = prev
+          # Only restore if proof corpus unavailable AND the prior had a
+          # real count. Supports both flat and public nested metric shapes.
+          if prev.get("count"):
+              if isinstance(d.get("metrics"), dict):
+                  if not d["metrics"].get("lean4_theorem_count"):
+                      d["metrics"]["lean4_theorem_count"] = prev["count"]
+              elif not d.get("lean_theorems", {}).get("found"):
+                  d["lean_theorems"] = prev
               p.write_text(json.dumps(d, indent=2, sort_keys=True) + "\n")
           PY
           fi

{atomadic_forge-0.75.0 → atomadic_forge-0.75.2}/.github/workflows/metrics-drift.yml

@@ -43,22 +43,23 @@ jobs:
           cp forge_metrics.json /tmp/forge_metrics.committed.json
           # Recompute (Lean count zero in CI unless FORGE_PROOF_CORPUS is wired).
           forge metrics --apply
-          # If the only delta is the timestamp, that's expected — strip it
-          # before diffing so we only fail on substantive drift.
-          jq 'del(.generated_at_utc)' /tmp/forge_metrics.committed.json > /tmp/a.json
-          jq 'del(.generated_at_utc)' forge_metrics.json > /tmp/b.json
+          # If the only delta is the timestamp, that's expected — strip
+          # legacy and public timestamp fields before diffing so we only
+          # fail on substantive drift.
+          jq 'del(.generated_at_utc, .generated_utc)' /tmp/forge_metrics.committed.json > /tmp/a.json
+          jq 'del(.generated_at_utc, .generated_utc)' forge_metrics.json > /tmp/b.json
           # Always strip `tests_passing` from the diff — that field is
           # populated externally (CI test job + --tests-passing flag) and
           # the committed artifact carries the full pytest count, while
           # this gate doesn't run pytest. Comparing them is meaningless.
-          jq 'del(.tests_passing)' /tmp/a.json > /tmp/a2.json && mv /tmp/a2.json /tmp/a.json
-          jq 'del(.tests_passing)' /tmp/b.json > /tmp/b2.json && mv /tmp/b2.json /tmp/b.json
+          jq 'del(.tests_passing, .metrics.test_count)' /tmp/a.json > /tmp/a2.json && mv /tmp/a2.json /tmp/a.json
+          jq 'del(.tests_passing, .metrics.test_count)' /tmp/b.json > /tmp/b2.json && mv /tmp/b2.json /tmp/b.json
           # If FORGE_PROOF_CORPUS is not set, also ignore the lean_theorems
           # block (will be 0 in CI but the committed artifact has the real
           # count from the IP repo).
           if [ -z "${FORGE_PROOF_CORPUS:-}" ]; then
-            jq 'del(.lean_theorems)' /tmp/a.json > /tmp/a2.json && mv /tmp/a2.json /tmp/a.json
-            jq 'del(.lean_theorems)' /tmp/b.json > /tmp/b2.json && mv /tmp/b2.json /tmp/b.json
+            jq 'del(.lean_theorems, .metrics.lean4_theorem_count)' /tmp/a.json > /tmp/a2.json && mv /tmp/a2.json /tmp/a.json
+            jq 'del(.lean_theorems, .metrics.lean4_theorem_count)' /tmp/b.json > /tmp/b2.json && mv /tmp/b2.json /tmp/b.json
           fi
           if ! diff -u /tmp/a.json /tmp/b.json; then
             echo "::error::forge_metrics.json is stale. Run 'forge metrics --apply' and commit the result."

{atomadic_forge-0.75.0 → atomadic_forge-0.75.2}/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 ## Unreleased
 
+## v0.75.2 — 2026-05-08
+
+### Changed
+
+- c411603 fix(docs): close wrapped whitepaper drift (GP Lane C W6)
+
+
+## v0.75.1 — 2026-05-08
+
+### Changed
+
+- 7f63594 feat(metrics): add repo public surface sync (GP Lane C W6)
+- d8ac951 docs: sync README + metrics for v0.75.0 — 300-seed proof banner
+
+
 ## v0.75.0 — 2026-05-08
 
 - docs: HARVEST_LEDGER — 🎯🎯🎯🎯 HOLY GRAIL: 300 SEEDS ABSORBED (v0.75.0)

{atomadic_forge-0.75.0/src/atomadic_forge.egg-info → atomadic_forge-0.75.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atomadic-forge
-Version: 0.75.0
+Version: 0.75.2
 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
@@ -67,6 +67,16 @@ AI agents write code **10x faster** than humans can review it. Pattern violation
 
 **Forge fixes that.**
 
+> 🎯 **300+ public OSS Python repositories absorbed end-to-end.** fastapi
+> (98k★), scrapy (61k★), django-rest-framework (30k★), pytest (13.8k★),
+> langgraph (31k★), openai-agents-python (26k★), cookiecutter (25k★),
+> aiohttp (16k★), deepeval (15k★), DocsGPT (17k★), txtai (12k★), E2B
+> (12k★), copier, apscheduler, msgspec, peewee, alembic, tortoise-orm,
+> presidio, dagster, IBM mcp-context-forge, and ~290 more — every single
+> one ran through one `forge auto` command, emerged 5-tier-organized,
+> wire-clean, scaffold-complete, deterministic. Wire-PASS holds across
+> the entire 300-seed corpus. Receipts in [`HARVEST_LEDGER.md`](HARVEST_LEDGER.md).
+
 - **Catches architectural violations AI agents leave behind.** Deterministic tier-law enforcement — no LLM in the loop, no hallucinations.
 - **Saves 40-60% on LLM tokens.** Structured code = smaller context windows = fewer tokens per turn.
 - **One command: spaghetti -> certified architecture.** Python, JavaScript, TypeScript, **Rust, Go, Swift, Kotlin** — full pipeline (recon, wire, certify, scaffold, evolve) on every language.
@@ -166,7 +176,7 @@ Forge enforces a **5-tier monadic law** — every source file belongs to exactly
 | `forge plan` | Bounded execution plan with risk + rollback |
 | `forge chat` | Terminal copilot over forge docs |
 
-**39 CLI verbs total.** Full reference: [docs/02-commands.md](docs/02-commands.md)
+**84 CLI verbs total.** Full reference: [docs/02-commands.md](docs/02-commands.md)
 
 ---
 
@@ -192,7 +202,7 @@ Forge ships a Model Context Protocol server. Add it to Cursor, Claude Code, Aide
 | `welcome` | — | RECOMMENDED FIRST CALL: onboarding scan, score, narrative, capability tour |
 | `explore` | 16 | Analyze, understand, discover — recon/explain/call_graph/call_graph_summary/smell/lineage/harvest/synergy/scan/swarm/churn/surface_gaps/capability_scout/dead_code/maintainability/concept_bridge |
 | `audit` | 23 | Quality gates, change safety, trust |
-| `plan` | 9 | Orient + dev utilities — context/compose/policy/recipes/generate/apply/locate/commit/scaffold |
+| `plan` | 10 | Orient + dev utilities — context/compose/policy/recipes/generate/apply/locate/commit/scaffold/steersman |
 | `transmute` | 3 | **FLAGSHIP** spaghetti→certified pipeline — auto/cherry/finalize |
 | `loop` | 4 | LLM iteration loops — iterate/resume/evolve/evolve_step |
 | `hive` | 13 | Multi-agent coordination — lifecycle, consensus, handoffs, enhancements |
@@ -214,9 +224,9 @@ Full tool reference: [docs/MCP_TOOLS.md](docs/MCP_TOOLS.md) | First call: `welco
 |--------|-------|
 
 | MCP tools | **10 tools · 112 actions** |
-| CLI verbs | **39** |
-| Source files | **226** (~45K LOC) |
-| Tests | **1555 passing** across **111 test files** |
+| CLI verbs | **84** |
+| Source files | **228** (~45K LOC) |
+| Tests | **1555 passing** across **112 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 |
@@ -226,6 +236,11 @@ Full tool reference: [docs/MCP_TOOLS.md](docs/MCP_TOOLS.md) | First call: `welco
 
 Forge eats its own cooking. Every CI run scores itself.
 
+> **Production-tested at scale.** 300+ public Python repos absorbed
+> end-to-end via `forge auto` — fastapi (98k★), scrapy (61k★), pytest
+> (13.8k★), DRF (30k★), cookiecutter (25k★), and ~295 others. Wire-PASS
+> on every single one. Full receipt: [`HARVEST_LEDGER.md`](HARVEST_LEDGER.md).
+
 ---
 
 ## Pricing

{atomadic_forge-0.75.0 → atomadic_forge-0.75.2}/README.md

@@ -35,6 +35,16 @@ AI agents write code **10x faster** than humans can review it. Pattern violation
 
 **Forge fixes that.**
 
+> 🎯 **300+ public OSS Python repositories absorbed end-to-end.** fastapi
+> (98k★), scrapy (61k★), django-rest-framework (30k★), pytest (13.8k★),
+> langgraph (31k★), openai-agents-python (26k★), cookiecutter (25k★),
+> aiohttp (16k★), deepeval (15k★), DocsGPT (17k★), txtai (12k★), E2B
+> (12k★), copier, apscheduler, msgspec, peewee, alembic, tortoise-orm,
+> presidio, dagster, IBM mcp-context-forge, and ~290 more — every single
+> one ran through one `forge auto` command, emerged 5-tier-organized,
+> wire-clean, scaffold-complete, deterministic. Wire-PASS holds across
+> the entire 300-seed corpus. Receipts in [`HARVEST_LEDGER.md`](HARVEST_LEDGER.md).
+
 - **Catches architectural violations AI agents leave behind.** Deterministic tier-law enforcement — no LLM in the loop, no hallucinations.
 - **Saves 40-60% on LLM tokens.** Structured code = smaller context windows = fewer tokens per turn.
 - **One command: spaghetti -> certified architecture.** Python, JavaScript, TypeScript, **Rust, Go, Swift, Kotlin** — full pipeline (recon, wire, certify, scaffold, evolve) on every language.
@@ -134,7 +144,7 @@ Forge enforces a **5-tier monadic law** — every source file belongs to exactly
 | `forge plan` | Bounded execution plan with risk + rollback |
 | `forge chat` | Terminal copilot over forge docs |
 
-**39 CLI verbs total.** Full reference: [docs/02-commands.md](docs/02-commands.md)
+**84 CLI verbs total.** Full reference: [docs/02-commands.md](docs/02-commands.md)
 
 ---
 
@@ -160,7 +170,7 @@ Forge ships a Model Context Protocol server. Add it to Cursor, Claude Code, Aide
 | `welcome` | — | RECOMMENDED FIRST CALL: onboarding scan, score, narrative, capability tour |
 | `explore` | 16 | Analyze, understand, discover — recon/explain/call_graph/call_graph_summary/smell/lineage/harvest/synergy/scan/swarm/churn/surface_gaps/capability_scout/dead_code/maintainability/concept_bridge |
 | `audit` | 23 | Quality gates, change safety, trust |
-| `plan` | 9 | Orient + dev utilities — context/compose/policy/recipes/generate/apply/locate/commit/scaffold |
+| `plan` | 10 | Orient + dev utilities — context/compose/policy/recipes/generate/apply/locate/commit/scaffold/steersman |
 | `transmute` | 3 | **FLAGSHIP** spaghetti→certified pipeline — auto/cherry/finalize |
 | `loop` | 4 | LLM iteration loops — iterate/resume/evolve/evolve_step |
 | `hive` | 13 | Multi-agent coordination — lifecycle, consensus, handoffs, enhancements |
@@ -182,9 +192,9 @@ Full tool reference: [docs/MCP_TOOLS.md](docs/MCP_TOOLS.md) | First call: `welco
 |--------|-------|
 
 | MCP tools | **10 tools · 112 actions** |
-| CLI verbs | **39** |
-| Source files | **226** (~45K LOC) |
-| Tests | **1555 passing** across **111 test files** |
+| CLI verbs | **84** |
+| Source files | **228** (~45K LOC) |
+| Tests | **1555 passing** across **112 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 |
@@ -194,6 +204,11 @@ Full tool reference: [docs/MCP_TOOLS.md](docs/MCP_TOOLS.md) | First call: `welco
 
 Forge eats its own cooking. Every CI run scores itself.
 
+> **Production-tested at scale.** 300+ public Python repos absorbed
+> end-to-end via `forge auto` — fastapi (98k★), scrapy (61k★), pytest
+> (13.8k★), DRF (30k★), cookiecutter (25k★), and ~295 others. Wire-PASS
+> on every single one. Full receipt: [`HARVEST_LEDGER.md`](HARVEST_LEDGER.md).
+
 ---
 
 ## Pricing

{atomadic_forge-0.75.0 → atomadic_forge-0.75.2}/docs/MCP_TOOLS.md

@@ -1,6 +1,7 @@
 # Forge MCP Tools Reference
 
-Forge ships a Model Context Protocol server exposing **10 tools dispatching 112 actions**. Counts are auto-synced from `forge_metrics.json` by `doc-update`.
+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`.
+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.
 
 - Local: `forge mcp serve --project /path/to/repo`
@@ -16,9 +17,9 @@ All legacy tool names redirect automatically — existing callers keep working.
 | Tool | Actions | Purpose |
 |------|---------|---------|
 | [`welcome`](#welcome) | — | Session onboarding: scan, score, narrative, capability tour |
-| [`explore`](#explore) | 21 | Analyze and understand a codebase — recon, call graphs, smells, harvest, discovery |
-| [`audit`](#audit) | 16 | Quality gates, change safety, trust verification |
-| [`plan`](#plan) | 9 | Dev orientation and utilities — context packs, recipes, commit messages |
+| [`explore`](#explore) | 16 | 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 |
 | [`loop`](#loop) | 4 | LLM iteration and self-improvement loops |
 | [`hive`](#hive) | 13 | Multi-agent coordination — consensus, handoffs, enhancements |
@@ -44,7 +45,7 @@ single most-useful next call for the session.
 
 ## `explore`
 
-**21 actions.** Use when you need to analyze, understand, or discover patterns in a codebase.
+**16 actions.** Use when you need to analyze, understand, or discover patterns in a codebase.
 No LLM is invoked — all analysis is deterministic.
 
 | Action | What it does |
@@ -73,7 +74,7 @@ No LLM is invoked — all analysis is deterministic.
 
 ## `audit`
 
-**16 actions.** Use when you need to check correctness, apply fixes, or gate a change.
+**23 actions.** Use when you need to check correctness, apply fixes, or gate a change.
 
 | Action | What it does |
 |--------|-------------|
@@ -91,17 +92,21 @@ No LLM is invoked — all analysis is deterministic.
 | `cna` | CNA (Compose-Not-Add) check — rejects new symbols that duplicate existing ones. |
 | `rollback` | Generate a rollback plan for a proposed change. |
 | `diff` | Structured diff analysis between two states. |
+| `ast_scope` | Build multi-repo AST blueprints plus deterministic Nexus-attestable edit locks. |
 | `surface_gaps` | Surface capability gaps in the current repo. |
 | `wire_stubs` | Generate stub implementations to satisfy wire constraints. |
-
-Additional actions registered but not in the base 16: `dead_code`, `maintainability`,
-`concept_bridge`, `auto_wire`, `doc_update` (totaling 21 in the full dispatch table).
+| `dead_code` | Identify unreachable or unused symbols. |
+| `maintainability` | Maintainability index per file/module. |
+| `concept_bridge` | Cross-domain concept linkage detection. |
+| `auto_wire` | Deterministically wire generated surface stubs. |
+| `doc_update` | Regenerate public docs from metrics. |
+| `doc_drift` | Detect public-doc metric drift. |
 
 ---
 
 ## `plan`
 
-**9 actions.** Dev utilities for orientation, workflow recipes, and commit hygiene.
+**10 actions.** Dev utilities for orientation, workflow recipes, commit hygiene, and tiny-model routing.
 
 | Action | What it does |
 |--------|-------------|
@@ -114,6 +119,7 @@ Additional actions registered but not in the base 16: `dead_code`, `maintainabil
 | `locate` | Return insertion-point line range + preview (~1000-token saving) |
 | `commit` | Assemble a structured commit message (~10k-token saving) |
 | `scaffold` | Scaffold a new module or feature at the correct tier |
+| `steersman` | Build AST-lock decision packs tiny enough for a 1B semantic router |
 
 ---
 

atomadic_forge-0.75.2/docs/commands/metrics.md

@@ -0,0 +1,46 @@
+# `atomadic-forge metrics`
+
+_Emit forge_metrics.json — canonical metrics for README/CHANGELOG/welcome/worker._
+
+- **Module**: `atomadic_forge.commands.metrics`
+- **Surface**: `typer_app`
+- **Source root**: `atomadic_forge_seed`
+- **Hidden**: `False`
+
+## Forge metrics
+
+Use the top-level command when updating Forge's own public counters.
+
+```bash
+forge metrics
+forge metrics --apply
+forge metrics --json
+```
+
+`--apply` rewrites `forge_metrics.json`. This artifact is Forge-specific:
+README badges, release automation, and Worker metadata read from it.
+
+## Product repo metrics
+
+Use the `repo` subcommand when updating any product repository's own public
+surface.
+
+```bash
+forge metrics repo --project /path/to/product
+forge metrics repo --project /path/to/product --apply
+forge metrics repo --project /path/to/product --json
+```
+
+The repo sync is intentionally separate from Forge metrics. It computes the
+target repo's source files, source lines, test files, languages, name, and
+version, then plans these bounded writes:
+
+| File | Update |
+|------|--------|
+| `repo_metrics.json` | Canonical product metrics artifact |
+| `README.md` | Metrics copy block between `<!-- forge:metrics:start -->` markers |
+| `server.json` | MCP registry version and description, when present |
+
+Dry-run is the default. Passing `--apply` writes the product surface and does
+not mutate `forge_metrics.json`.
+

{atomadic_forge-0.75.0 → atomadic_forge-0.75.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "atomadic-forge"
-version = "0.75.0"
+version = "0.75.2"
 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.75.0 → atomadic_forge-0.75.2}/src/atomadic_forge/a1_at_functions/doc_auto_update.py

@@ -11,7 +11,7 @@ Updateable sections
 README.md
   • "By the Numbers" table  (bounded by METRICS_START / METRICS_END anchors)
   • "## MCP Server — N Tools, M Actions" heading
-  • Tool-table rows for ``explore`` and ``audit`` (action counts)
+  • Tool-table rows for MCP tools whose action enums are discoverable
   • "**N CLI verbs total.**" count
 
 CHANGELOG.md
@@ -49,8 +49,7 @@ _METRICS_END = "\nForge eats its own cooking."
 
 _MCP_HEADER_RE = re.compile(r"## MCP Server — \d+ Tools, \d+ Actions")
 _CLI_COUNT_RE = re.compile(r"\*\*(\d+) CLI verbs total\.\*\*")
-_EXPLORE_ROW_RE = re.compile(r"(\| `explore` \| )(\d+)( \|)")
-_AUDIT_ROW_RE = re.compile(r"(\| `audit` \| )(\d+)( \|)")
+_TOOL_ROW_RE = re.compile(r"(\| `(?P<tool>[^`]+)` \| )(?P<count>\d+)( \|)")
 
 # ── CHANGELOG anchor ──────────────────────────────────────────────────────────
 _CHANGELOG_UNRELEASED = "## Unreleased"
@@ -60,8 +59,11 @@ _CHANGELOG_VER_RE = re.compile(r"^## v(\d+\.\d+\.\d+)", re.MULTILINE)
 # IDE_INTEGRATION.md: matches "**NN tools**" or "**NN tools dispatching NN actions**"
 _IDE_TOOLS_RE = re.compile(r'\*\*\d+ tools(?:\s+dispatching\s+\d+\s+actions)?\*\*')
 
-# WHITEPAPER.md: matches "NN MCP tools [word] dispatching NN actions" (optional mid-word)
-_WP_TOOLS_PHRASE_RE = re.compile(r'(\d+) MCP tools(?:\s+\w+)? dispatching (\d+) actions')
+# WHITEPAPER.md: matches "NN MCP tools [word] dispatching NN actions",
+# including prose line wraps between "MCP" and "tools".
+_WP_TOOLS_PHRASE_RE = re.compile(
+    r'(\d+)\s+MCP\s+tools(?:\s+\w+)?\s+dispatching\s+(\d+)\s+actions'
+)
 # WHITEPAPER.md: matches "NN,NNN passing tests" or "NN passing tests"
 _WP_TESTS_RE = re.compile(r'([\d,]+) passing tests')
 
@@ -145,6 +147,21 @@ def _count_mcp_actions_per_tool(project_root: Path) -> dict[str, int]:
     Anchors each enum to its tool name in the TOOLS dict so counts are
     correct even when audit grows larger than explore.
     """
+    try:
+        from .mcp_protocol import TOOLS
+        live: dict[str, int] = {}
+        for tool, spec in TOOLS.items():
+            props = (spec.get("inputSchema") or {}).get("properties") or {}
+            count = 0
+            for key in ("action", "op"):
+                enum = (props.get(key) or {}).get("enum") or []
+                count += len(enum)
+            if count:
+                live[tool] = count
+        if live:
+            return live
+    except Exception:
+        pass
     proto = project_root / "src" / "atomadic_forge" / "a1_at_functions" / "mcp_protocol.py"
     if not proto.exists():
         return {}
@@ -303,22 +320,22 @@ def update_readme(
         text = new_text
         changes.append("README: MCP Server heading updated")
 
-    # 3. explore / audit action counts in tool table
+    # 3. MCP action counts in tool table
     action_counts = _count_mcp_actions_per_tool(project_root)
-    if "explore" in action_counts:
-        new_text, n = _EXPLORE_ROW_RE.subn(
-            lambda m: m.group(1) + str(action_counts["explore"]) + m.group(3), text
-        )
-        if n:
-            text = new_text
-            changes.append(f"README: explore action count → {action_counts['explore']}")
-    if "audit" in action_counts:
-        new_text, n = _AUDIT_ROW_RE.subn(
-            lambda m: m.group(1) + str(action_counts["audit"]) + m.group(3), text
-        )
-        if n:
-            text = new_text
-            changes.append(f"README: audit action count → {action_counts['audit']}")
+    changed_tools: list[str] = []
+
+    def _replace_tool_count(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:
+            changed_tools.append(tool)
+        return match.group(1) + new_count + match.group(4)
+
+    text = _TOOL_ROW_RE.sub(_replace_tool_count, text)
+    for tool in sorted(set(changed_tools)):
+        changes.append(f"README: {tool} action count → {action_counts[tool]}")
 
     # 4. CLI verb count
     cli_verbs = metrics.get("cli_verbs", 0)