Expand description
Connector conformance scoring (#330).
Grades every built-in source/sink against the faucet connector contract and
its capabilities, assigns a 0–100 score and a maturity tier
(Stable / Experimental / Beta / Draft), and lists capability badges.
The score is computed from authoritative, instantiation-free signals the
CLI already tracks — the registry index (cli/connectors/registry.json) and
the per-kind capability functions in crate::registry — so it is
deterministic and cannot drift from the code.
Scoring model (max 100): the core contract is the Stable gate — a
verified registry entry (40) + a real config schema (30) = 70. Everything
else is a bonus that lifts the score without gating the tier: documentation
(10), exactly-once delivery (10), and one kind-specific capability
(source: dataset discovery 10; sink: upsert 6 + schema evolution 4). So every
conforming built-in lands at Stable with capability badges, while an
incomplete third-party connector (no verified entry / no schema) drops to
Experimental / Beta.
Structs§
- Connector
Facts - Authoritative, instantiation-free capability signals for one connector.
- Dimension
- One scored dimension of a connector’s conformance.
- Report
- A connector’s full conformance report.
Enums§
- Tier
- Maturity tier derived from the conformance score.
Functions§
- build_
reports - Build conformance reports for every compiled-in connector, sources first.
- capability_
matrix_ markdown - Render the connector capability matrix as Markdown, derived entirely
from the registry allowlists (
registry::*_KINDS). Because those are feature-independentconstarrays, this output is deterministic regardless of which connectors are compiled in — so a committed copy can be round-trip-asserted in CI (seecli/tests/capability_matrix.rs), which is what stops the matrix from being hand-maintained and drifting (#465 Part 3). - facts_
for - Gather facts for one built-in connector kind from the registry.
- score
- Score a single connector from its facts. Pure and deterministic.
- tier_
for - The maturity tier of a single compiled-in connector kind — the lookup behind
the Tier column in
faucet list.