Plugin registry reference

Calibrated Explanations uses a centralized plugin registry to discover explanation, interval, and plot builders/renderers.

Registry scope

  • Registry module: src/calibrated_explanations/plugins/registry.py

  • Built-in plugins: src/calibrated_explanations/plugins/builtins.py

  • CLI tooling: calibrated_explanations.plugins.cli

Key concepts

  • Plugin IDs are dot-delimited strings (core.explanation.factual).

  • Trusted vs. untrusted plugins control which plugins are allowed to load by default.

  • Metadata validation enforces deterministic governance fields (stable identifier, extension type, supported kinds/modes, capability/version markers, and trust/provenance metadata).

Trust model

The trust model is documented in docs/improvement/adrs/ADR-006-plugin-registry-trust-model.md. External plugins should register through the approved entry points and include the required metadata for auditability.