ce-pipeline-builder

name	ce-pipeline-builder
description	Build CE-first end-to-end pipelines using WrapCalibratedExplainer with fit, calibrate, and explain or predict sequencing.

CE Pipeline Builder

You are implementing a CE-first pipeline. Load references/ce-first-policy.md for the full policy text. Non-negotiable invariants are repeated inline below for quick reference.

Mandatory CE-First Checklist (enforce in order)

1. Library check — if calibrated_explanations is not importable, fail fast:

   pip install calibrated-explanations
   

2. Wrapper — always use WrapCalibratedExplainer. Never invent a new wrapper class; never use CalibratedExplainer directly in user-facing code.
3. Fit — explainer.fit(x_proper, y_proper). Assert explainer.fitted is True before proceeding.
4. Calibrate — explainer.calibrate(x_cal, y_cal). Assert explainer.calibrated is True before proceeding.
5. Explain (standard) — explainer.explain_factual(X) or explainer.explore_alternatives(X).
6. Explain (guarded / in-distribution) — when higher security or in-distribution filtering is needed, use explainer.explain_guarded_factual(X) or explainer.explore_guarded_alternatives(X) instead of the standard paths. Also use when rule conditions of the form x < feature <= y are needed, since the guarded APIs support this natively.
7. Conjunctions — explanations.add_conjunctions(...) or explanations[idx].add_conjunctions(...).