roam-code 12.43__tar.gz → 12.45__tar.gz

{roam_code-12.43 → roam_code-12.45}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: roam-code
-Version: 12.43
+Version: 12.45
 Summary: Instant codebase comprehension for AI coding agents
 Author: CosmoHac
 License-Expression: Apache-2.0

{roam_code-12.43 → roam_code-12.45}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "roam-code"
-version = "12.43"
+version = "12.45"
 description = "Instant codebase comprehension for AI coding agents"
 readme = "README.md"
 requires-python = ">=3.9"

{roam_code-12.43 → roam_code-12.45}/src/roam/capability.py

@@ -143,16 +143,8 @@ def roam_capability(
         cap_name = name or _derive_name(func)
         # For Click Commands, the original module is on the callback
         callback = getattr(func, "callback", None)
-        module = (
-            getattr(callback, "__module__", "")
-            if callback is not None
-            else getattr(func, "__module__", "")
-        )
-        func_name = (
-            getattr(callback, "__name__", "")
-            if callback is not None
-            else getattr(func, "__name__", "")
-        )
+        module = getattr(callback, "__module__", "") if callback is not None else getattr(func, "__module__", "")
+        func_name = getattr(callback, "__name__", "") if callback is not None else getattr(func, "__name__", "")
         cap = Capability(
             name=cap_name,
             category=category,
@@ -245,6 +237,6 @@ def emit_yaml() -> str:
 
 def _yaml_str(s: str) -> str:
     """Quote a string for YAML if needed."""
-    if any(c in s for c in (':', '#', '\n', '"', "'", '[', ']', '{', '}', ',', '&', '*', '!', '|', '>')):
-        return '"' + s.replace('\\', '\\\\').replace('"', '\\"') + '"'
+    if any(c in s for c in (":", "#", "\n", '"', "'", "[", "]", "{", "}", ",", "&", "*", "!", "|", ">")):
+        return '"' + s.replace("\\", "\\\\").replace('"', '\\"') + '"'
     return s

{roam_code-12.43 → roam_code-12.45}/src/roam/catalog/detectors.py

@@ -2549,7 +2549,9 @@ def detect_async_fire_and_forget(conn: sqlite3.Connection) -> list[dict]:
                 ],
             )
         )
-        results[-1]["fix"] = "Store the task: `tasks.append(asyncio.create_task(coro()))` and await it later, or `await asyncio.create_task(coro())` directly."
+        results[-1]["fix"] = (
+            "Store the task: `tasks.append(asyncio.create_task(coro()))` and await it later, or `await asyncio.create_task(coro())` directly."
+        )
     return results
 
 

{roam_code-12.43 → roam_code-12.45}/src/roam/catalog/tasks.py

@@ -584,6 +584,52 @@ CATALOG: dict[str, dict] = {
             },
         ],
     },
+    "async-fire-and-forget-task": {
+        "name": "asyncio.create_task() whose return value is discarded",
+        "category": "concurrency",
+        "kind": "algorithm",
+        "ways": [
+            {
+                "id": "store-task-reference",
+                "name": "Store the task in a long-lived collection",
+                "time": "n/a",
+                "space": "O(N tasks)",
+                "rank": 1,
+                "tip": "Capture the task: `tasks.append(asyncio.create_task(coro()))` and `await asyncio.gather(*tasks)` later. Or `await asyncio.create_task(coro())` directly for fire-and-await.",
+            },
+            {
+                "id": "leaked-asyncio-task",
+                "name": "Leaked asyncio.create_task — gc may discard before completion",
+                "time": "n/a",
+                "space": "O(1) — task object eligible for gc",
+                "rank": 10,
+                "tip": "",
+            },
+        ],
+    },
+    "async-nested-run": {
+        "name": "asyncio.run() invoked inside an async function",
+        "category": "concurrency",
+        "kind": "algorithm",
+        "ways": [
+            {
+                "id": "await-the-coroutine",
+                "name": "await the coroutine directly",
+                "time": "non-blocking",
+                "space": "O(1)",
+                "rank": 1,
+                "tip": "Replace `asyncio.run(coro())` with `await coro()` — you're already inside an event loop.",
+            },
+            {
+                "id": "asyncio-run-in-async",
+                "name": "asyncio.run inside async — RuntimeError at runtime",
+                "time": "raises immediately",
+                "space": "n/a",
+                "rank": 10,
+                "tip": "",
+            },
+        ],
+    },
     "serial-await-loop": {
         "name": "Serial `await` inside loop (Promise.all opportunity)",
         "category": "concurrency",

{roam_code-12.43 → roam_code-12.45}/src/roam/commands/cmd_compare.py

@@ -70,28 +70,32 @@ def compare_cmd(ctx, baseline: str, target: str, top: int, threshold: int) -> No
     verdict = _verdict(delta)
 
     if json_mode:
-        click.echo(to_json(json_envelope(
-            "compare",
-            summary={
-                "verdict": verdict,
-                "baseline": str(base),
-                "target": str(targ),
-                "symbols_added": len(delta["symbols_added"]),
-                "symbols_removed": len(delta["symbols_removed"]),
-                "symbols_moved": len(delta["symbols_moved"]),
-                "complexity_regressions": len(delta["complexity_up"]),
-                "complexity_improvements": len(delta["complexity_down"]),
-            },
-            symbols_added=delta["symbols_added"][:top],
-            symbols_removed=delta["symbols_removed"][:top],
-            symbols_moved=delta["symbols_moved"][:top],
-            complexity_up=delta["complexity_up"][:top],
-            complexity_down=delta["complexity_down"][:top],
-            file_count_baseline=base_state["file_count"],
-            file_count_target=targ_state["file_count"],
-            symbol_count_baseline=base_state["symbol_count"],
-            symbol_count_target=targ_state["symbol_count"],
-        )))
+        click.echo(
+            to_json(
+                json_envelope(
+                    "compare",
+                    summary={
+                        "verdict": verdict,
+                        "baseline": str(base),
+                        "target": str(targ),
+                        "symbols_added": len(delta["symbols_added"]),
+                        "symbols_removed": len(delta["symbols_removed"]),
+                        "symbols_moved": len(delta["symbols_moved"]),
+                        "complexity_regressions": len(delta["complexity_up"]),
+                        "complexity_improvements": len(delta["complexity_down"]),
+                    },
+                    symbols_added=delta["symbols_added"][:top],
+                    symbols_removed=delta["symbols_removed"][:top],
+                    symbols_moved=delta["symbols_moved"][:top],
+                    complexity_up=delta["complexity_up"][:top],
+                    complexity_down=delta["complexity_down"][:top],
+                    file_count_baseline=base_state["file_count"],
+                    file_count_target=targ_state["file_count"],
+                    symbol_count_baseline=base_state["symbol_count"],
+                    symbol_count_target=targ_state["symbol_count"],
+                )
+            )
+        )
         return
 
     click.echo(f"VERDICT: {verdict}")
@@ -117,8 +121,16 @@ def compare_cmd(ctx, baseline: str, target: str, top: int, threshold: int) -> No
     _section("Symbols added", delta["symbols_added"], lambda x: f"+ {x['kind']:8} {x['qname']}  in {x['path']}")
     _section("Symbols removed", delta["symbols_removed"], lambda x: f"- {x['kind']:8} {x['qname']}  was in {x['path']}")
     _section("Symbols moved", delta["symbols_moved"], lambda x: f"~ {x['qname']}: {x['old_path']} → {x['new_path']}")
-    _section("Files got more complex", delta["complexity_up"], lambda x: f"↑ {x['path']}  Δ +{x['delta']}  (now {x['target']}, was {x['baseline']})")
-    _section("Files got simpler", delta["complexity_down"], lambda x: f"↓ {x['path']}  Δ -{abs(x['delta'])}  (now {x['target']}, was {x['baseline']})")
+    _section(
+        "Files got more complex",
+        delta["complexity_up"],
+        lambda x: f"↑ {x['path']}  Δ +{x['delta']}  (now {x['target']}, was {x['baseline']})",
+    )
+    _section(
+        "Files got simpler",
+        delta["complexity_down"],
+        lambda x: f"↓ {x['path']}  Δ -{abs(x['delta'])}  (now {x['target']}, was {x['baseline']})",
+    )
 
 
 def _load_index_state(db_path: Path) -> dict:
@@ -177,12 +189,14 @@ def _compute_delta(base: dict, targ: dict, *, threshold: int) -> dict[str, list]
     moved = []
     for name in common_names:
         if base_syms[name]["path"] != targ_syms[name]["path"]:
-            moved.append({
-                "qname": name,
-                "kind": targ_syms[name]["kind"],
-                "old_path": base_syms[name]["path"],
-                "new_path": targ_syms[name]["path"],
-            })
+            moved.append(
+                {
+                    "qname": name,
+                    "kind": targ_syms[name]["kind"],
+                    "old_path": base_syms[name]["path"],
+                    "new_path": targ_syms[name]["path"],
+                }
+            )
 
     base_cx = base["complexities"]
     targ_cx = targ["complexities"]

{roam_code-12.43 → roam_code-12.45}/src/roam/commands/cmd_skill_generate.py

@@ -53,6 +53,7 @@ def skill_generate_cmd(ctx, target: str, output_path: str | None, ai_safe_only:
     """
     # Force-load known capability modules
     from roam.commands.cmd_capabilities import _populate_registry
+
     _populate_registry()
 
     caps = REGISTRY.all()
@@ -96,50 +97,52 @@ def _emit_claude_skill(caps: list) -> str:
     ]
     for chunk in _wrap(description, 78, prefix="  "):
         lines.append(chunk)
-    lines.extend([
-        "---",
-        "",
-        "# Roam — Codebase Comprehension Skill",
-        "",
-        f"_Generated by `roam skill-generate --target claude` on {_today()}._",
-        "",
-        "**Repository:** <https://github.com/Cranot/roam-code>",
-        "",
-        "Roam pre-indexes codebases into a semantic graph (symbols, dependencies, "
-        "call graphs, architecture layers, git history) stored in a local SQLite DB. "
-        "Query it via CLI instead of repeatedly grepping files and guessing structure.",
-        "",
-        "## Setup",
-        "",
-        "```bash",
-        "pip install roam-code      # or: pipx install roam-code",
-        "cd <project-root>",
-        "roam init                  # indexes the codebase, creates .roam/index.db",
-        "```",
-        "",
-        "After `git pull` or major changes, run `roam reindex` (incremental, near-instant). "
-        "After large refactors: `roam reindex --force`.",
-        "",
-        "## When to use which command",
-        "",
-        "| Situation | Command |",
-        "|-----------|---------|",
-        "| Orient yourself in a new codebase | `roam understand` then `roam tour` |",
-        "| Find a symbol | `roam search <pattern>` |",
-        "| Free-form task (\"trace login flow\") | `roam retrieve \"<task>\"` |",
-        "| Before changing a symbol | `roam preflight <symbol>` |",
-        "| Files to read for context | `roam context <symbol>` |",
-        "| Verify a patch | `git diff \\| roam critique` |",
-        "| Pre-commit gate / agent verdict | `git diff --cached \\| roam permit` |",
-        "| Replay current detectors against past commits | `roam postmortem HEAD~30..HEAD` |",
-        "| EU AI Act Article 12 readiness | `roam article-12-check` |",
-        "",
-        "## Core capabilities",
-        "",
-        "These are the capabilities marked safe for autonomous agent calls. "
-        "See `roam capabilities` for the full list.",
-        "",
-    ])
+    lines.extend(
+        [
+            "---",
+            "",
+            "# Roam — Codebase Comprehension Skill",
+            "",
+            f"_Generated by `roam skill-generate --target claude` on {_today()}._",
+            "",
+            "**Repository:** <https://github.com/Cranot/roam-code>",
+            "",
+            "Roam pre-indexes codebases into a semantic graph (symbols, dependencies, "
+            "call graphs, architecture layers, git history) stored in a local SQLite DB. "
+            "Query it via CLI instead of repeatedly grepping files and guessing structure.",
+            "",
+            "## Setup",
+            "",
+            "```bash",
+            "pip install roam-code      # or: pipx install roam-code",
+            "cd <project-root>",
+            "roam init                  # indexes the codebase, creates .roam/index.db",
+            "```",
+            "",
+            "After `git pull` or major changes, run `roam reindex` (incremental, near-instant). "
+            "After large refactors: `roam reindex --force`.",
+            "",
+            "## When to use which command",
+            "",
+            "| Situation | Command |",
+            "|-----------|---------|",
+            "| Orient yourself in a new codebase | `roam understand` then `roam tour` |",
+            "| Find a symbol | `roam search <pattern>` |",
+            '| Free-form task ("trace login flow") | `roam retrieve "<task>"` |',
+            "| Before changing a symbol | `roam preflight <symbol>` |",
+            "| Files to read for context | `roam context <symbol>` |",
+            "| Verify a patch | `git diff \\| roam critique` |",
+            "| Pre-commit gate / agent verdict | `git diff --cached \\| roam permit` |",
+            "| Replay current detectors against past commits | `roam postmortem HEAD~30..HEAD` |",
+            "| EU AI Act Article 12 readiness | `roam article-12-check` |",
+            "",
+            "## Core capabilities",
+            "",
+            "These are the capabilities marked safe for autonomous agent calls. "
+            "See `roam capabilities` for the full list.",
+            "",
+        ]
+    )
     by_cat: dict[str, list] = {}
     for c in caps:
         by_cat.setdefault(c.category, []).append(c)
@@ -151,22 +154,24 @@ def _emit_claude_skill(caps: list) -> str:
             if cap.examples:
                 lines.append(f"  - Example: `{cap.examples[0]}`")
         lines.append("")
-    lines.extend([
-        "## Output modes",
-        "",
-        "- Text (default) — human-readable; safe to feed back into your context.",
-        "- `--json` — structured envelope with `verdict`, `summary`, schema_version. Parse this in code.",
-        "- `--sarif` — SARIF 2.1.0 for CI integration (GitHub Code Scanning).",
-        "",
-        "## Exit codes",
-        "",
-        "- 0 — success / ALLOW",
-        "- 5 — high-severity finding / BLOCK / gate failure",
-        "- 6 — REVIEW / partial",
-        "",
-        "All other non-zero codes are unexpected; report as an issue.",
-        "",
-    ])
+    lines.extend(
+        [
+            "## Output modes",
+            "",
+            "- Text (default) — human-readable; safe to feed back into your context.",
+            "- `--json` — structured envelope with `verdict`, `summary`, schema_version. Parse this in code.",
+            "- `--sarif` — SARIF 2.1.0 for CI integration (GitHub Code Scanning).",
+            "",
+            "## Exit codes",
+            "",
+            "- 0 — success / ALLOW",
+            "- 5 — high-severity finding / BLOCK / gate failure",
+            "- 6 — REVIEW / partial",
+            "",
+            "All other non-zero codes are unexpected; report as an issue.",
+            "",
+        ]
+    )
     return "\n".join(lines) + "\n"
 
 
@@ -183,8 +188,7 @@ def _emit_cursor_rule(caps: list) -> str:
         "",
         "# Roam codebase comprehension",
         "",
-        "Before making non-trivial code changes, use the roam-code CLI to understand "
-        "what you're about to touch.",
+        "Before making non-trivial code changes, use the roam-code CLI to understand what you're about to touch.",
         "",
         "1. `roam preflight <symbol>` — see what changing this affects.",
         "2. `roam context <symbol>` — get the exact files and line ranges to read.",
@@ -202,6 +206,7 @@ def _emit_cursor_rule(caps: list) -> str:
 def _emit_continue_snippet(caps: list) -> str:
     """Continue config.json snippet — slash commands."""
     import json
+
     snippet = {
         "slashCommands": [
             {

{roam_code-12.43 → roam_code-12.45}/src/roam/competitor_site_data.py

@@ -1363,7 +1363,7 @@ MAP_METADATA: dict[str, dict[str, object]] = {
         "peer": True,
         "graph": "PageRank + Tarjan + Louvain + layers",
         "note": "Graph algorithms (PageRank, SCC, Louvain, Fiedler) on tree-sitter ASTs fused with git history in SQLite. 136 MCP tools, 190 CLI commands. 19 Python idiom detectors (v12.7+). 54 algo detectors (12.40). Phase 0 monetization commands: permit / postmortem / article-12-check.",
-        "version_evaluated": "12.43",
+        "version_evaluated": "12.45",
         "repo_url": "https://github.com/Cranot/roam-code",
     },
     "CKB/CodeMCP": {

{roam_code-12.43 → roam_code-12.45}/src/roam/mcp-server-card.json

@@ -2,7 +2,7 @@
   "$schema": "https://schemas.modelcontextprotocol.io/server-card/v1",
   "name": "roam-code",
   "display_name": "roam — instant codebase intelligence",
-  "version": "12.43",
+  "version": "12.45",
   "description": "Architectural sight for AI agents before they edit. Pre-indexes symbols, call graphs, dependencies, architecture layers, and git history into a local SQLite DB. 136 MCP tools, 10 resources, 5 prompts, 27 languages. 100% local, zero API keys.",
   "vendor": {
     "name": "Cranot",

{roam_code-12.43 → roam_code-12.45}/src/roam/output/sarif.py

@@ -165,6 +165,7 @@ def _automation_details(tool_name: str, version: str) -> dict:
     """
     import os
     from datetime import datetime, timezone
+
     run_guid = f"{tool_name}/{version}/{datetime.now(timezone.utc).strftime('%Y%m%d')}"
     branch = os.environ.get("GITHUB_REF_NAME") or os.environ.get("CI_COMMIT_BRANCH") or "main"
     return {
@@ -180,24 +181,34 @@ def _version_control_provenance() -> list[dict]:
     Returns an empty list when git is unavailable so SARIF stays valid.
     """
     import subprocess
+
     try:
         sha = subprocess.run(
             ["git", "rev-parse", "HEAD"],
-            capture_output=True, text=True, timeout=2,
+            capture_output=True,
+            text=True,
+            timeout=2,
         ).stdout.strip()
         if not sha:
             return []
         try:
-            branch = subprocess.run(
-                ["git", "rev-parse", "--abbrev-ref", "HEAD"],
-                capture_output=True, text=True, timeout=2,
-            ).stdout.strip() or "main"
+            branch = (
+                subprocess.run(
+                    ["git", "rev-parse", "--abbrev-ref", "HEAD"],
+                    capture_output=True,
+                    text=True,
+                    timeout=2,
+                ).stdout.strip()
+                or "main"
+            )
         except Exception:
             branch = "main"
         try:
             remote = subprocess.run(
                 ["git", "config", "--get", "remote.origin.url"],
-                capture_output=True, text=True, timeout=2,
+                capture_output=True,
+                text=True,
+                timeout=2,
             ).stdout.strip()
         except Exception:
             remote = ""
@@ -221,6 +232,7 @@ def _load_suppressions() -> list[dict]:
     """
     import json
     from pathlib import Path
+
     candidate = Path.cwd() / ".roam" / "suppressions.json"
     if not candidate.exists():
         return []

{roam_code-12.43 → roam_code-12.45}/src/roam_code.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: roam-code
-Version: 12.43
+Version: 12.45
 Summary: Instant codebase comprehension for AI coding agents
 Author: CosmoHac
 License-Expression: Apache-2.0

{roam_code-12.43 → roam_code-12.45}/tests/test_capability_registry.py

@@ -4,6 +4,7 @@ Phase 1 of the v2 monetization plan; these tests guard the contract
 that the registry stays consistent across imports and emits stable
 YAML / JSON for downstream consumers.
 """
+
 from __future__ import annotations
 
 import json
@@ -112,6 +113,7 @@ def test_phase0_commands_register() -> None:
     """The 3 Phase 0 commands (permit, postmortem, article-12-check) decorate themselves."""
     # Force-import via the populator
     from roam.commands.cmd_capabilities import _populate_registry
+
     _populate_registry()
     assert REGISTRY.get("permit") is not None
     assert REGISTRY.get("postmortem") is not None

{roam_code-12.43 → roam_code-12.45}/tests/test_compare_cli.py

@@ -1,4 +1,5 @@
 """Tests for R8 — roam compare (structural index diff)."""
+
 from __future__ import annotations
 
 import sqlite3
@@ -39,6 +40,7 @@ def test_compute_delta_detects_added_and_removed(tmp_path) -> None:
     _make_index(targ_db, files=[(1, "a.py")], symbols=[("bar", "function", 1)])
 
     from roam.commands.cmd_compare import _load_index_state
+
     base = _load_index_state(base_db)
     targ = _load_index_state(targ_db)
     delta = _compute_delta(base, targ, threshold=1)
@@ -54,6 +56,7 @@ def test_compute_delta_detects_moves(tmp_path) -> None:
     _make_index(targ_db, files=[(1, "old.py"), (2, "new.py")], symbols=[("foo", "function", 2)])
 
     from roam.commands.cmd_compare import _load_index_state
+
     base = _load_index_state(base_db)
     targ = _load_index_state(targ_db)
     delta = _compute_delta(base, targ, threshold=1)
@@ -106,6 +109,7 @@ def test_cli_text_output(tmp_path) -> None:
 
 def test_cli_json_output(tmp_path) -> None:
     import json as jsonlib
+
     base_db = tmp_path / "base.db"
     targ_db = tmp_path / "targ.db"
     _make_index(base_db, files=[(1, "a.py")], symbols=[("foo", "function", 1)])

{roam_code-12.43 → roam_code-12.45}/tests/test_math.py

@@ -31,7 +31,9 @@ class TestCatalog:
         # broad-except-swallow, spread-accumulator, defer-in-loop;
         # X13 added chained-collection-walk; Z1/Z2/Z5 added useeffect-
         # missing-deps, dangerous-eval, unremoved-event-listener → 32.
-        assert len(CATALOG) == 32, f"Expected 32 tasks, got {len(CATALOG)}"
+        # R5 (v12.43) added async-fire-and-forget-task,
+        # async-nested-run → 34.
+        assert len(CATALOG) == 34, f"Expected 34 tasks, got {len(CATALOG)}"
 
     def test_detector_registry_covers_catalog(self):
         from roam.catalog.detectors import _MATH_DETECTORS

{roam_code-12.43 → roam_code-12.45}/tests/test_sarif_enrichment.py

@@ -4,6 +4,7 @@ The enrichment lets GitHub Code Scanning correlate runs across re-ingests,
 maps findings to a specific git commit, and respects user-defined
 suppressions from .roam/suppressions.json.
 """
+
 from __future__ import annotations
 
 import json
@@ -72,15 +73,17 @@ def test_suppressions_applied_when_file_present(tmp_path, monkeypatch) -> None:
     suppressions_dir = tmp_path / ".roam"
     suppressions_dir.mkdir()
     (suppressions_dir / "suppressions.json").write_text(
-        json.dumps([
-            {
-                "rule_id": "ROAM-DEMO-1",
-                "location": "src/x.py:10",
-                "reason": "false positive: this is intentional",
-                "kind": "external",
-                "status": "accepted",
-            }
-        ]),
+        json.dumps(
+            [
+                {
+                    "rule_id": "ROAM-DEMO-1",
+                    "location": "src/x.py:10",
+                    "reason": "false positive: this is intentional",
+                    "kind": "external",
+                    "status": "accepted",
+                }
+            ]
+        ),
         encoding="utf-8",
     )
 
@@ -104,15 +107,17 @@ def test_suppressions_object_shape_also_supported(tmp_path, monkeypatch) -> None
     suppressions_dir = tmp_path / ".roam"
     suppressions_dir.mkdir()
     (suppressions_dir / "suppressions.json").write_text(
-        json.dumps({
-            "suppressions": [
-                {
-                    "rule_id": "ROAM-DEMO-1",
-                    "location": "src/x.py:10",
-                    "reason": "wrapped",
-                }
-            ]
-        }),
+        json.dumps(
+            {
+                "suppressions": [
+                    {
+                        "rule_id": "ROAM-DEMO-1",
+                        "location": "src/x.py:10",
+                        "reason": "wrapped",
+                    }
+                ]
+            }
+        ),
         encoding="utf-8",
     )
 

{roam_code-12.43 → roam_code-12.45}/tests/test_skill_generate.py

@@ -4,6 +4,7 @@ Generates an agent-runtime skill manifest from the capability registry.
 Targets: claude (SKILL.md), cursor (.mdc rule), continue (config snippet),
 aider (.aiderrc).
 """
+
 from __future__ import annotations
 
 import json