roam-code 11.1.0__tar.gz → 11.1.2__tar.gz

{roam_code-11.1.0/src/roam_code.egg-info → roam_code-11.1.2}/PKG-INFO

@@ -1,15 +1,16 @@
 Metadata-Version: 2.4
 Name: roam-code
-Version: 11.1.0
+Version: 11.1.2
 Summary: Instant codebase comprehension for AI coding agents
 Author: CosmoHac
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/Cranot/roam-code
-Project-URL: Documentation, https://github.com/Cranot/roam-code#readme
+Project-URL: Documentation, https://cranot.github.io/roam-code/
 Project-URL: Repository, https://github.com/Cranot/roam-code
 Project-URL: Issues, https://github.com/Cranot/roam-code/issues
+Project-URL: Changelog, https://github.com/Cranot/roam-code/blob/main/CHANGELOG.md
 Keywords: code-intelligence,static-analysis,mcp-server,tree-sitter,architecture,code-graph,ai-coding,graph-analysis,code-quality,cli,codebase,code-analysis,ai-tools,mcp
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
@@ -50,7 +51,7 @@ Dynamic: license-file
 
 **The architectural intelligence layer for AI coding agents. Structural graph, architecture governance, multi-agent orchestration, vulnerability mapping, runtime analysis -- one CLI, zero API keys.**
 
-*137 commands · 101 MCP tools · 26 languages · 100% local*
+*139 commands · 101 MCP tools · 26 languages · 100% local*
 
 [![PyPI version](https://img.shields.io/pypi/v/roam-code?style=flat-square&color=blue)](https://pypi.org/project/roam-code/)
 [![GitHub stars](https://img.shields.io/github/stars/Cranot/roam-code?style=flat-square)](https://github.com/Cranot/roam-code/stargazers)
@@ -69,7 +70,7 @@ Roam is a structural intelligence engine for software. It pre-indexes your codeb
 Unlike LSPs (editor-bound, language-specific) or Sourcegraph (hosted search), Roam provides architecture-level graph queries -- offline, cross-language, and compact. It goes beyond comprehension: Roam governs architecture through budget gates, simulates refactoring outcomes, orchestrates multi-agent swarms with zero-conflict guarantees, maps vulnerability reachability paths, and enables graph-level code editing without syntax errors.
 
 ```
-Codebase ──> [Index] ──> Semantic Graph ──> 137 Commands ──> AI Agent
+Codebase ──> [Index] ──> Semantic Graph ──> 139 Commands ──> AI Agent
               │              │                  │
            tree-sitter    symbols            comprehend
            26 languages   + edges            govern
@@ -110,7 +111,15 @@ $ roam diff                    # blast radius of uncommitted changes
 
 ## What's New in v11
 
-### MCP v2 for Agent-First Workflows
+### v11.1.1 -- Command Quality Audit
+- **Full command audit**: all 139 commands reviewed for usefulness, duplicates, and test coverage. ~20 bugs fixed, 21 new test files (700+ tests), every command docstring updated with cross-references to related commands.
+- **Kotlin promoted to Tier 1** via new YAML-based declarative extractor architecture. Classes, interfaces, enums, objects, functions, methods, properties, and inheritance fully extracted.
+- **7 new commands**: `roam congestion`, `roam adrs`, `roam flag-dead`, `roam test-scaffold`, `roam sbom`, `roam triage`, `roam ci-setup`.
+- **CI templates**: `roam ci-setup` generates pipelines for GitHub Actions, GitLab CI, Azure Pipelines, Jenkins, and Bitbucket.
+- **Bug fixes**: `--undocumented` mode in `intent` (wrong DB table), `--changed` flag in `verify` (was permanently dead), lazy-load violation in `visualize` (~500ms penalty), exit code inconsistency in `rules`, VERDICT-first convention enforced across all commands.
+- **Code quality**: 15 unused variables removed, dead code swept (4 orphaned cmd files, 2 dead helper functions), algo detector false-positive rate reduced (regex-in-loop: 7 to 1, list-prepend deque suppression), 6 regex patterns pre-compiled for loop performance.
+
+### v11.0 -- MCP v2 for Agent-First Workflows
 - In-process MCP execution removes per-call subprocess overhead.
 - 4 compound operations (`roam_explore`, `roam_prepare_change`, `roam_review_change`, `roam_diagnose_issue`) reduce multi-step agent workflows to single calls.
 - Preset-based tool surfacing (`core`, `review`, `refactor`, `debug`, `architecture`, `full`) keeps default tool choice tight for agents while retaining full depth on demand.
@@ -258,7 +267,7 @@ roam health
 
 ## Commands
 
-The [5 core commands](#core-commands) shown above cover ~80% of agent workflows. All 137 commands are organized into 7 categories.
+The [5 core commands](#core-commands) shown above cover ~80% of agent workflows. All 139 commands are organized into 7 categories.
 
 <details>
 <summary><strong>Full command reference</strong></summary>
@@ -275,7 +284,7 @@ The [5 core commands](#core-commands) shown above cover ~80% of agent workflows.
 | `roam reset [--hard]` | Reset the roam index and cached data. `--hard` removes all `.roam/` artifacts |
 | `roam clean [--all]` | Remove stale or orphaned index entries without a full rebuild |
 | `roam understand` | Full codebase briefing: tech stack, architecture, key abstractions, health, conventions, complexity overview, entry points |
-| `roam onboard` | Structured onboarding guide: architecture map, key files, suggested reading order, and first tasks |
+| `roam onboard` | Alias for `understand` |
 | `roam tour [--write PATH]` | Auto-generated onboarding guide: top symbols, reading order, entry points, language breakdown. `--write` saves to Markdown |
 | `roam describe [--write] [--force] [-o PATH] [--agent-prompt]` | Auto-generate project description for AI agents. `--write` auto-detects your agent's config file. `--agent-prompt` returns a compact (<500 token) system prompt |
 | `roam agent-export [--format F] [--write]` | Generate agent-context bundle from project analysis (`AGENTS.md` + provider-specific overlays) |
@@ -285,6 +294,8 @@ The [5 core commands](#core-commands) shown above cover ~80% of agent workflows.
 | `roam schema [--diff] [--version V]` | JSON envelope schema versioning: view, diff, and validate output schemas |
 | `roam mcp [--list-tools] [--transport T]` | Start MCP server (stdio/SSE/streamable-http), inspect available tools, and expose roam to coding agents |
 | `roam mcp-setup <platform>` | Generate MCP config snippets for AI platforms: claude-code, cursor, windsurf, vscode, gemini-cli, codex-cli |
+| `roam ci-setup [--platform P] [--write]` | Generate CI/CD pipeline config (GitHub Actions, GitLab CI, Azure Pipelines, Jenkins, Bitbucket) with SARIF + quality gates |
+| `roam adrs [--status S] [--limit N]` | Discover Architecture Decision Records, link to affected code modules, show status and coverage |
 
 ### Daily Workflow
 
@@ -316,6 +327,7 @@ The [5 core commands](#core-commands) shown above cover ~80% of agent workflows.
 | `roam syntax-check [--changed] [PATHS...]` | Tree-sitter syntax integrity check for changed files and multi-agent judge workflows |
 | `roam verify [--threshold N]` | Pre-commit AI-code consistency check across naming, imports, error handling, and duplication signals |
 | `roam verify-imports [--file F]` | Import hallucination firewall: validate all imports against indexed symbol table, suggest corrections via FTS5 fuzzy matching |
+| `roam triage list\|add\|stats\|check` | Security finding suppression workflow: manage `.roam-suppressions.yml` (SAFE/ACKNOWLEDGED/WONT-FIX status lifecycle) |
 | `roam safe-delete <symbol>` | Safe deletion check: SAFE/REVIEW/UNSAFE verdict |
 | `roam test-map <name>` | Map a symbol or file to its test coverage |
 | `roam adversarial [--staged] [--range R]` | Adversarial architecture review: generates targeted challenges based on changes |
@@ -343,11 +355,8 @@ The [5 core commands](#core-commands) shown above cover ~80% of agent workflows.
 | `roam debt [--roi]` | Hotspot-weighted tech debt prioritization with SQALE remediation costs and optional refactoring ROI estimates |
 | `roam fitness [--explain]` | Architectural fitness functions from `.roam/fitness.yaml` |
 | `roam alerts` | Health degradation trend detection (Mann-Kendall + Sen's slope) |
-| `roam snapshot [--tag TAG]` | Persist health metrics snapshot for trend tracking |
-| `roam trend` | Health score history with sparkline visualization |
-| `roam digest [--brief] [--since TAG]` | Compare current metrics against last snapshot |
 | `roam forecast [--symbol S] [--horizon N] [--alert-only]` | Predict when metrics will exceed thresholds: Theil-Sen regression on snapshot history + churn-weighted per-symbol risk |
-| `roam budget [--init] [--staged] [--range R]` | Architectural budget enforcement: per-PR delta limits on health, cycles, complexity. CI gate (exit 1 on violation) |
+| `roam budget [--init] [--staged] [--range R]` | Architectural budget enforcement: per-PR delta limits on health, cycles, complexity. CI gate (exit 5 on violation) |
 | `roam bisect [--metric M] [--range R]` | Architectural git bisect: find the commit that degraded a specific metric |
 | `roam ingest-trace <file> [--otel\|--jaeger\|--zipkin\|--generic]` | Ingest runtime trace data (OpenTelemetry, Jaeger, Zipkin) for hotspot overlay |
 | `roam hotspots [--runtime] [--discrepancy]` | Runtime hotspot analysis: find symbols missed by static analysis but critical at runtime |
@@ -450,19 +459,19 @@ src/
     bridges/
       base.py                 # LanguageBridge
       registry.py             # register_bridge, detect_bridges
-    commands/  (134 files) # is_test_file, get_changed_files
+    commands/  (137 cmd files) # is_test_file, get_changed_files
     db/
       connection.py           # find_project_root, batched_in
       schema.py
     graph/
       builder.py              # build_symbol_graph, build_file_graph
       pagerank.py             # compute_pagerank, compute_centrality
-    languages/  (20 files) # ApexExtractor
+    languages/  (21 files) # ApexExtractor
     output/
       formatter.py            # to_json, json_envelope
     cli.py                    # cli, LazyGroup
     mcp_server.py
-tests/  (151 files)
+tests/  (186 files)
 ` ` `
 
 **Key symbols** (PageRank): `open_db` · `ensure_index` · `json_envelope` · `to_json` · `LanguageExtractor`
@@ -498,6 +507,7 @@ The sentinel pair `<!-- roam:minimap -->` / `<!-- /roam:minimap -->` is replaced
 | `roam spectral [--depth N] [--compare] [--gap-only] [--k K]` | Spectral bisection: Fiedler vector partition tree with algebraic connectivity gap verdict |
 | `roam layers` | Topological dependency layers + upward violations + Gini balance |
 | `roam dead [--all] [--summary] [--clusters]` | Unreferenced exported symbols with safety verdicts + confidence scoring (60-95%) |
+| `roam flag-dead [--config FILE] [--include-tests]` | Feature flag dead code detection: stale LaunchDarkly/Unleash/Split/custom flags with staleness analysis |
 | `roam fan [symbol\|file] [-n N] [--no-framework]` | Fan-in/fan-out: most connected symbols or files |
 | `roam risk [-n N] [--domain KW] [--explain]` | Domain-weighted risk ranking |
 | `roam why <name> [name2 ...]` | Role classification (Hub/Bridge/Core/Leaf), reach, criticality |
@@ -531,6 +541,7 @@ The sentinel pair `<!-- roam:minimap -->` / `<!-- /roam:minimap -->` is replaced
 | `roam docs-coverage` | Public-symbol doc coverage + stale docs + PageRank-ranked missing-doc hotlist |
 | `roam suggest-refactoring [--limit N] [--min-score N]` | Proactive refactoring recommendations ranked by complexity, coupling, churn, smells, coverage gaps, and debt |
 | `roam plan-refactor <symbol> [--operation auto\|extract\|move]` | Ordered refactor plan with blast radius, test gaps, layer risk, and simulation-based strategy preview |
+| `roam test-scaffold <name\|file> [--write] [--framework F]` | Generate test file/function/import skeletons from symbol data (pytest, jest, Go, JUnit, RSpec) |
 | `roam conventions` | Auto-detect naming styles, import preferences. Flags outliers |
 | `roam breaking [REV_RANGE]` | Breaking change detection: removed exports, signature changes |
 | `roam affected-tests <symbol\|file>` | Trace reverse call graph to test files |
@@ -565,6 +576,8 @@ The sentinel pair `<!-- roam:minimap -->` / `<!-- /roam:minimap -->` is replaced
 | `roam vuln-map --generic\|--npm-audit\|--trivy F` | Ingest vulnerability reports and match to codebase symbols |
 | `roam vuln-reach [--cve C] [--from E]` | Vulnerability reachability: exact paths from entry points to vulnerable calls |
 | `roam supply-chain [--top N]` | Dependency risk dashboard: pin coverage, risk scoring, supply-chain health |
+| `roam sbom [--format cyclonedx\|spdx] [--no-reachability] [-o FILE]` | SBOM generation (CycloneDX 1.5 / SPDX 2.3) enriched with call-graph reachability per dependency |
+| `roam congestion [--window N] [--min-authors N]` | Developer congestion detection: concurrent authors per file, coordination risk scoring |
 | `roam invariants [--staged] [--range R]` | Discover architectural contracts (invariants) from the codebase structure |
 
 ### Multi-Repo Workspace
@@ -586,7 +599,7 @@ The sentinel pair `<!-- roam:minimap -->` / `<!-- /roam:minimap -->` is replaced
 | `roam --json <command>` | Structured JSON output with consistent envelope |
 | `roam --compact <command>` | Token-efficient output: TSV tables, minimal JSON envelope |
 | `roam --sarif <command>` | SARIF 2.1.0 output for dead, health, complexity, rules, secrets, and algo (GitHub/CI integration) |
-| `roam <command> --gate EXPR` | CI quality gate (e.g., `--gate score>=70`). Exit code 1 on failure |
+| `roam health --gate` | CI quality gate. Reads `.roam-gates.yml` thresholds. Exit code 5 on failure |
 
 </details>
 
@@ -731,7 +744,7 @@ Blueprint  Bridge        fan-in:18   reach:34  moderate  Coupling point between
 $ roam describe --write
 Wrote CLAUDE.md (98 lines)  # auto-detects: CLAUDE.md, AGENTS.md, .cursor/rules, etc.
 
-$ roam health --gate score>=70
+$ roam health --gate
 Health: 78/100 — PASS
 ```
 
@@ -837,7 +850,7 @@ Run `roam --help` for all commands. Use `roam --json <cmd>` for structured outpu
 | "What breaks if I change X?" | `roam impact <symbol>` | No direct equivalent |
 | "What tests to run?" | `roam affected-tests <name>` | Grep for imports (misses indirect) |
 | "What's causing this bug?" | `roam diagnose <name>` | Manual call-chain tracing |
-| "Codebase health score for CI" | `roam health --gate score>=70` | No equivalent |
+| "Codebase health score for CI" | `roam health --gate` | No equivalent |
 
 </details>
 
@@ -1083,20 +1096,24 @@ jobs:
 
       - uses: Cranot/roam-code@main
         with:
-          command: health --gate score>=70
+          commands: health
+          gate: "score>=70"
+          sarif: true
           comment: true
-          fail-on-violation: true
 ```
 
 Use `roam init` to auto-generate this workflow.
 
 | Input | Default | Description |
 |-------|---------|-------------|
-| `command` | `health` | Roam command to run |
-| `python-version` | `3.12` | Python version |
-| `comment` | `false` | Post results as PR comment |
-| `fail-on-violation` | `false` | Fail the job on violations |
-| `roam-version` | (latest) | Pin to a specific version |
+| `commands` | `health` | Space-separated roam commands to run |
+| `gate` | (empty) | Quality gate expression (e.g., `score>=70`). Exit 5 on failure |
+| `sarif` | `false` | Upload SARIF results to GitHub Code Scanning |
+| `comment` | `true` | Post sticky PR comment with results |
+| `python-version` | `3.11` | Python version |
+| `version` | `latest` | Pin to a specific roam-code version |
+| `cache` | `true` | Cache the SQLite index between runs |
+| `changed-only` | `false` | Incremental mode: adapt commands to changed files |
 
 <details>
 <summary><strong>GitLab CI</strong></summary>
@@ -1109,7 +1126,7 @@ roam-analysis:
     - pip install roam-code
   script:
     - roam index
-    - roam health --gate score>=70
+    - roam health --gate
     - roam --json pr-risk origin/main..HEAD > roam-report.json
   artifacts:
     paths:
@@ -1128,7 +1145,7 @@ Universal pattern:
 ```bash
 pip install roam-code
 roam index
-roam health --gate score>=70    # exit 1 on failure
+roam health --gate               # exit 5 on failure (reads .roam-gates.yml)
 roam --json health > report.json
 ```
 
@@ -1167,9 +1184,9 @@ Zero infrastructure, zero vendor lock-in, zero data leaving your network.
 
 **Week 1-2 (pilot):** 1-2 developers run `roam init` on one repo. Use `roam preflight` before changes, `roam pr-risk` before PRs.
 
-**Week 3-4 (expand):** Add `roam health --gate score>=60` to CI as a non-blocking check.
+**Week 3-4 (expand):** Add `roam health --gate` to CI as a non-blocking check (configure thresholds in `.roam-gates.yml`).
 
-**Month 2+ (standardize):** Tighten to `--gate score>=70`. Expand to additional repos. Track trajectory with `roam trend`.
+**Month 2+ (standardize):** Tighten gate thresholds. Expand to additional repos. Track trajectory with `roam trends`.
 
 </details>
 
@@ -1222,12 +1239,14 @@ Cross-language edges mean `roam impact AccountService` shows blast radius across
 </details>
 
 | Ruby | `.rb` | classes, modules, methods, singleton methods, constants | require, require_relative, include/extend, calls, ClassName.new | class inheritance |
+| Kotlin | `.kt` `.kts` | classes, interfaces, enums, objects, functions, methods, properties | imports, calls, type refs | extends, implements |
+| Swift | `.swift` | classes, structs, enums, protocols, functions, methods, properties | imports, calls, type refs | extends, conforms |
 | JSONC | `.jsonc` | via JSON grammar | -- | -- |
 | MDX | `.mdx` | via Markdown grammar | -- | -- |
 
 ### Tier 2 -- Generic extraction
 
-Kotlin (`.kt` `.kts`), Swift (`.swift`), Scala (`.scala` `.sc`)
+Scala (`.scala` `.sc`)
 
 Tier 2 languages get symbol extraction and basic inheritance via a generic tree-sitter walker.
 
@@ -1304,6 +1323,37 @@ Codebase
 
 After the first full index, `roam index` only re-processes changed files (mtime + SHA-256 hash). Incremental updates are near-instant.
 
+### .roamignore
+
+Create a `.roamignore` file in your project root to exclude files from indexing. It uses **full gitignore syntax**:
+
+| Pattern | Meaning |
+|---------|---------|
+| `*.log` | Exclude all `.log` files (basename match) |
+| `vendor/` | Exclude the `vendor` directory and everything under it |
+| `/build/` | Exclude `build/` at repo root only (anchored) |
+| `src/**/*.pb.go` | Exclude `.pb.go` files at any depth under `src/` |
+| `**/test_*.py` | Exclude `test_*.py` files anywhere |
+| `?` | Match any single character (not `/`) |
+| `[abc]` / `[!abc]` | Character class / negated character class |
+| `!important.log` | Un-exclude (re-include) `important.log` |
+| `# comment` | Lines starting with `#` are comments |
+
+Key rules: `*` matches within a single path segment (not across `/`). `**` matches across `/` boundaries. Last matching pattern wins (for negation). Patterns containing `/` are anchored to the repo root.
+
+```
+# .roamignore example
+*_pb2.py
+*_pb2_grpc.py
+vendor/
+node_modules/
+*.generated.*
+/build/
+!build/keep/
+```
+
+You can also exclude patterns via `roam config --exclude "*.proto"` (stored in `.roam/config.json`) or inspect active patterns with `roam config --show`.
+
 <details>
 <summary><strong>Graph algorithms</strong></summary>
 
@@ -1406,7 +1456,7 @@ Static analysis trade-offs:
 - **Static analysis primarily** -- can't trace dynamic dispatch, reflection, or eval'd code. Runtime trace ingestion (`roam ingest-trace`) adds production data but requires external trace export
 - **Import resolution is heuristic** -- complex re-exports or conditional imports may not resolve
 - **Limited cross-language edges** -- Salesforce, Protobuf, REST API, and multi-repo edges are supported, but not arbitrary FFI
-- **Tier 2 languages** (Kotlin, Swift, Scala) get basic symbol extraction only
+- **Tier 2 languages** (Scala) get basic symbol extraction only
 - **Large monorepos** (100k+ files) may have slow initial indexing
 
 ## Troubleshooting
@@ -1418,7 +1468,7 @@ Static analysis trade-offs:
 | `database is locked` | `roam index --force` to rebuild |
 | Unicode errors on Windows | `chcp 65001` for UTF-8 |
 | Symbol resolves to wrong file | Use `file:symbol` syntax: `roam symbol myfile:MyFunction` |
-| Health score seems wrong | `roam health --json` for factor breakdown |
+| Health score seems wrong | `roam --json health` for factor breakdown |
 | Index stale after `git pull` | `roam index` (incremental). After major refactors: `roam index --force` |
 
 ## Update / Uninstall
@@ -1443,7 +1493,7 @@ Delete `.roam/` from your project root to clean up local data.
 git clone https://github.com/Cranot/roam-code.git
 cd roam-code
 pip install -e ".[dev]"   # includes pytest, ruff
-pytest tests/              # ~5000 tests, Python 3.9-3.13
+pytest tests/              # ~5500 tests, Python 3.9-3.13
 
 # Or use Make targets:
 make dev      # install with dev extras
@@ -1460,7 +1510,7 @@ roam-code/
 ├── action.yml                         # Reusable GitHub Action
 ├── src/roam/
 │   ├── __init__.py                    # Version (from pyproject.toml)
-│   ├── cli.py                         # Click CLI (137 commands)
+│   ├── cli.py                         # Click CLI (139 commands)
 │   ├── mcp_server.py                  # MCP server (101 tools, 10 resources, 5 prompts)
 │   ├── db/
 │   │   ├── connection.py              # SQLite (WAL, pragmas, batched IN)
@@ -1480,7 +1530,7 @@ roam-code/
 │   ├── languages/
 │   │   ├── base.py                    # Abstract LanguageExtractor
 │   │   ├── registry.py                # Language detection + aliasing
-│   │   ├── *_lang.py                  # One file per language (19 dedicated + generic)
+│   │   ├── *_lang.py                  # One file per language (20 dedicated + generic)
 │   │   └── generic_lang.py            # Tier 2 fallback
 │   ├── bridges/
 │   │   ├── base.py, registry.py       # Cross-language bridge framework
@@ -1517,7 +1567,7 @@ roam-code/
 │   │   ├── engine.py                  # YAML rule parser + graph query evaluator
 │   │   ├── builtin.py                 # 10 built-in governance rules
 │   │   ├── ast_match.py               # AST pattern matching with $METAVAR captures
-│   │   └── dataflow.py                # Inter-procedural dataflow analysis
+│   │   └── dataflow.py                # Intra-procedural dataflow analysis
 │   ├── runtime/
 │   │   ├── trace_ingest.py            # OpenTelemetry/Jaeger/Zipkin ingestion
 │   │   └── hotspots.py                # Runtime hotspot analysis
@@ -1532,7 +1582,7 @@ roam-code/
 │       ├── formatter.py               # Token-efficient formatting
 │       ├── sarif.py                   # SARIF 2.1.0 output
 │       └── schema_registry.py         # JSON envelope schema versioning
-└── tests/                             # ~5000 tests across 151 test files
+└── tests/                             # ~5500 tests across 186 test files
 ```
 
 </details>
@@ -1555,7 +1605,7 @@ Optional: Local semantic ONNX stack (`numpy`, `onnxruntime`, `tokenizers`) via `
 ### Shipped
 
 - [x] MCP v2 agent surface: in-process execution, compound operations, presets, schemas, annotations, and compatibility profiles.
-- [x] Full command and MCP inventory parity in docs: 137 CLI commands and 101 MCP tools.
+- [x] Full command and MCP inventory parity in docs: 139 CLI commands and 101 MCP tools.
 - [x] CI hardening: composite action, changed-only mode, trend-aware gates, sticky PR updater, and SARIF guardrails.
 - [x] Performance foundation: FTS5/BM25 search, O(changed) incremental indexing, DB/index optimizations.
 - [x] Agent governance suite: `vibe-check`, `ai-readiness`, `verify`, `ai-ratio`, `duplicates`, advanced `algo` scoring/SARIF.
@@ -1576,7 +1626,7 @@ Optional: Local semantic ONNX stack (`numpy`, `onnxruntime`, `tokenizers`) via `
 git clone https://github.com/Cranot/roam-code.git
 cd roam-code
 pip install -e .
-pytest tests/   # all ~5000 tests must pass
+pytest tests/   # all ~5500 tests must pass
 ```
 
 Good first contributions: add a [Tier 1 language](src/roam/languages/) (see `go_lang.py` or `php_lang.py` as templates), improve reference resolution, add benchmark repos, extend SARIF converters, add MCP tools.