> ## 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`    | 82        | 201     | 47         | 36           | 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`       | 4         | 19      | —          | 5            | Yes     | Yes     |
| **suite**        | **123**   |         |            |              |         |         |

## 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.

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

| Substrate                                                      | Scorers                                                                                                                                                                                                                                   |
| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rust `-core` kernel — Python + TS                              | `alias_match`, `audio_fp`, `date`, `dice`, `ensemble`, `exact`, `given_name_aliased_jw`, `initialism_match`, `jaccard`, `jaro_winkler`, `levenshtein`, `name_freq_weighted_jw`, `phash`, `qgram`, `radial`, `soundex_match`, `token_sort` |
| Rust `-core` kernel — Python arrow-native only (TS falls back) | `date_diff`, `geo_haversine`                                                                                                                                                                                                              |
| WASM `-core` kernel — TS only (Python falls back)              | —                                                                                                                                                                                                                                         |
| Language fallback — no `-core` kernel                          | `embedding`, `numeric_diff`, `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    | 64     | 18          | 8       |
| `goldenmatch`    | cli\_commands | 13     | 23          | 1       |
| `goldenmatch`    | a2a\_skills   | 29     | 18          | 10      |
| `goldenmatch`    | scorers       | 19     | 3           | 0       |
| `goldenmatch`    | transforms    | 13     | 0           | 0       |
| `goldencheck`    | mcp\_tools    | 18     | 1           | 0       |
| `goldencheck`    | cli\_commands | 13     | 9           | 0       |
| `goldencheck`    | a2a\_skills   | 9      | 0           | 0       |
| `goldenflow`     | mcp\_tools    | 10     | 0           | 0       |
| `goldenflow`     | cli\_commands | 9      | 7           | 0       |
| `goldenflow`     | a2a\_skills   | 6      | 0           | 0       |
| `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       |
| `infermap`       | mcp\_tools    | 4      | 0           | 0       |
| `infermap`       | cli\_commands | 4      | 1           | 0       |

## Gaps & asymmetries (auto-detected)

* **No A2A skills surface:** `goldenanalysis`, `infermap`.
* `goldenmatch` **mcp\_tools** — Python-only: `create_domain`, `documents_ingest`, `documents_suggest_schema`, `explain_routing`, `identity_audit`, `identity_audit_seal`, `identity_audit_verify`, `identity_profile`, `identity_show`, `identity_stats`, `identity_worklist`, `lint_routing`, `list_domains`, `list_plugins`, `plan_routing`, `pprl_auto_config`, `pprl_link`, `test_domain`.
* `goldenmatch` **mcp\_tools** — TS-only: `build_clusters`, `find_exact_matches`, `find_fuzzy_matches`, `read_file`, `score_pair`, `score_strings`, `server_info`, `write_csv`.
* `goldenmatch` **cli\_commands** — Python-only: `analyze-blocking`, `anomalies`, `autoconfig`, `compare-clusters`, `config`, `explain`, `incremental`, `ingest-docs`, `init`, `interactive`, `label`, `lineage`, `pprl`, `review`, `rollback`, `runs`, `schedule`, `sensitivity`, `serve-ui`, `setup`, `sync`, `unmerge`, `watch`.
* `goldenmatch` **cli\_commands** — TS-only: `tui`.
* `goldenmatch` **a2a\_skills** — Python-only: `analyze_blocking`, `compare_clusters`, `configure`, `documents_ingest`, `documents_suggest_schema`, `identity_audit`, `identity_audit_seal`, `identity_audit_verify`, `identity_show`, `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`, `fix_quality`, `memory_import`, `scan_quality`, `score`.
* `goldenmatch` **scorers** — Python-only: `date_diff`, `geo_haversine`, `numeric_diff`.
* `goldencheck` **mcp\_tools** — Python-only: `install_domain`.
* `goldencheck` **cli\_commands** — Python-only: `agent-serve`, `denial-constraints`, `init`, `learn`, `refs`, `review`, `scan-db`, `schedule`, `serve`.
* `goldenflow` **cli\_commands** — Python-only: `agent-serve`, `init`, `interactive`, `mcp-serve`, `schedule`, `serve`, `watch`.
* `goldenpipe` **cli\_commands** — Python-only: `interactive`.
* `infermap` **cli\_commands** — Python-only: `mcp-serve`.