Skip to main content

Module conformance

Module conformance 

Source
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§

ConnectorFacts
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-independent const arrays, this output is deterministic regardless of which connectors are compiled in — so a committed copy can be round-trip-asserted in CI (see cli/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.