> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bensevern.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Suite surface matrix

> Cross-package view of the Golden Suite: capability counts, the Rust -core compute substrate, Python/TypeScript parity, and auto-detected gaps — generated and gated in CI.

The per-package [config matrices](/docs/goldenmatch/config-matrix) each describe one package. This is the **cross-package** view. The anchor is the **Rust / Arrow-native / fused `-core` kernel**: it is the reference implementation, and the Python and TypeScript surfaces are ports that either dispatch to it (the fast path) or run a byte-identical pure-language fallback. So the sections below read against that reference — how the packages line up, which scorers a kernel actually backs vs which are fallback-only, where the two language ports diverge, and what's missing where. Everything below the line is generated from the parity manifests + AST (`scripts/gen_suite_matrix.py`) and verified in CI, so it can't drift.

## Per-package surface

Live counts (introspected from each package) side by side. `MCP` / `Exports` / `A2A` are the same numbers the llms.txt/README gate locks; `CLI` is the Python command count from the parity manifest.

| Package          | MCP tools | Exports | A2A skills | CLI commands | Recipes | TS port |
| ---------------- | --------- | ------- | ---------- | ------------ | ------- | ------- |
| `goldenmatch`    | 97        | 202     | 51         | 43           | Yes     | Yes     |
| `goldencheck`    | 19        | 43      | 9          | 22           | Yes     | Yes     |
| `goldenflow`     | 10        | 36      | 6          | 16           | Yes     | Yes     |
| `goldenpipe`     | 4         | 20      | 4          | 8            | Yes     | Yes     |
| `goldenanalysis` | 4         | 8       | —          | 4            | Yes     | Yes     |
| `infermap`       | 5         | 20      | —          | 6            | Yes     | Yes     |
| **suite**        | **139**   |         |            |              |         |         |

## Compute substrate — the Rust `-core` kernel is the reference

The Rust / Arrow-native / fused `-core` kernels are the source of truth for scoring; each language surface either dispatches to the kernel (the fast path) or runs a byte-identical pure-language **fallback**. This tracks which scorers a kernel actually backs vs which are fallback-only. Sources: Python `_NATIVE_SCORER_IDS` (arrow bucket kernel) and TS `WASM_COVERED_SCORERS` (`-core` WASM), gated as the `scorer_kernels` api\_parity surface.

**22 of 24 scorers are kernel-backed** (the reference fast path); the other 2 are pure-language fallbacks with no `-core` kernel.

| Substrate                                                      | Scorers                                                                                                                                                                                                                                                                                                              |
| -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rust `-core` kernel — Python + TS                              | `alias_match`, `array_intersect`, `audio_fp`, `cosine`, `date`, `date_diff`, `dice`, `ensemble`, `exact`, `geo_haversine`, `given_name_aliased_jw`, `initialism_match`, `jaccard`, `jaro_winkler`, `levenshtein`, `name_freq_weighted_jw`, `numeric_diff`, `phash`, `qgram`, `radial`, `soundex_match`, `token_sort` |
| Rust `-core` kernel — Python arrow-native only (TS falls back) | —                                                                                                                                                                                                                                                                                                                    |
| WASM `-core` kernel — TS only (Python falls back)              | —                                                                                                                                                                                                                                                                                                                    |
| Language fallback — no `-core` kernel                          | `embedding`, `record_embedding`                                                                                                                                                                                                                                                                                      |

## Cross-language parity (Python ↔ TypeScript)

Per surface: values shared by both languages vs each language's exclusives. A non-zero **Python-only** or **TS-only** is a *declared* cross-language gap (`parity/<pkg>.yaml`), not drift — but it is where the two ports diverge.

| Package          | Surface       | Shared | Python-only | TS-only |
| ---------------- | ------------- | ------ | ----------- | ------- |
| `goldenmatch`    | mcp\_tools    | 87     | 10          | 0       |
| `goldenmatch`    | cli\_commands | 33     | 10          | 0       |
| `goldenmatch`    | a2a\_skills   | 36     | 15          | 13      |
| `goldenmatch`    | scorers       | 24     | 0           | 0       |
| `goldenmatch`    | transforms    | 13     | 0           | 0       |
| `goldencheck`    | mcp\_tools    | 18     | 1           | 0       |
| `goldencheck`    | cli\_commands | 17     | 5           | 0       |
| `goldencheck`    | a2a\_skills   | 9      | 0           | 0       |
| `goldenflow`     | mcp\_tools    | 10     | 0           | 0       |
| `goldenflow`     | cli\_commands | 12     | 4           | 0       |
| `goldenflow`     | a2a\_skills   | 6      | 0           | 0       |
| `goldenflow`     | transforms    | 113    | 0           | 1       |
| `goldenpipe`     | mcp\_tools    | 4      | 0           | 0       |
| `goldenpipe`     | cli\_commands | 7      | 1           | 0       |
| `goldenpipe`     | a2a\_skills   | 4      | 0           | 0       |
| `goldenanalysis` | mcp\_tools    | 4      | 0           | 0       |
| `goldenanalysis` | cli\_commands | 4      | 0           | 0       |
| `goldenanalysis` | analyzers     | 5      | 0           | 0       |
| `infermap`       | mcp\_tools    | 5      | 0           | 0       |
| `infermap`       | cli\_commands | 6      | 0           | 0       |
| `infermap`       | scorers       | 7      | 0           | 0       |

## Gaps & asymmetries (auto-detected)

* **No A2A skills surface:** `goldenanalysis`, `infermap`.
* `goldenmatch` **mcp\_tools** — Python-only: `discover_semantic_model`, `documents_ingest`, `documents_suggest_schema`, `explain_routing`, `lint_routing`, `list_plugins`, `ontology_certify`, `ontology_discover`, `plan_routing`, `pprl_auto_config`.
* `goldenmatch` **cli\_commands** — Python-only: `discover-model`, `import-dbt`, `ingest-docs`, `llm`, `migrate-splink`, `ontology`, `serve-ui`, `setup`, `sync`, `watch`.
* `goldenmatch` **a2a\_skills** — Python-only: `analyze_blocking`, `certify_semantic_model`, `compare_clusters`, `configure`, `documents_ingest`, `documents_suggest_schema`, `incremental`, `list_runs`, `pprl`, `quality`, `retrieve_similar`, `review`, `rollback`, `schema_match`, `sensitivity`.
* `goldenmatch` **a2a\_skills** — TS-only: `agent_approve_reject`, `agent_deduplicate`, `agent_explain_cluster`, `agent_explain_pair`, `agent_match_sources`, `agent_review_queue`, `certify_serving_joins`, `customer_360`, `emit_semantic_model_from_store`, `fix_quality`, `memory_import`, `scan_quality`, `score`.
* `goldencheck` **mcp\_tools** — Python-only: `install_domain`.
* `goldencheck` **cli\_commands** — Python-only: `init`, `review`, `scan-db`, `schedule`, `serve`.
* `goldenflow` **cli\_commands** — Python-only: `init`, `interactive`, `schedule`, `watch`.
* `goldenflow` **transforms** — TS-only: `category_llm_correct`.
* `goldenpipe` **cli\_commands** — Python-only: `interactive`.
