# CAIN ORACLE — Production Readiness

| Capability | Status | Evidence |
|---|---|---|
| Prediction object + certificate | IMPLEMENTED, TESTED, LIVE | `cain/oracle/prediction.py`, `certificate.py` |
| World-model assurance | IMPLEMENTED, TESTED | `worldmodel.py` |
| Calibration + prediction-error impact | IMPLEMENTED, TESTED | `calibration.py` |
| Counterfactual authorization | IMPLEMENTED, TESTED, LIVE | `counterfactual.py` |
| Simulator admissibility | IMPLEMENTED, TESTED | `reality.py` |
| Reality override | IMPLEMENTED, TESTED | `reality.py` |
| Multi-oracle disagreement | IMPLEMENTED, TESTED, LIVE | `disagreement.py` |
| Evidence-independence graph | IMPLEMENTED, TESTED | `independence.py` |
| Prediction-failure learning (governance firewall) | IMPLEMENTED, TESTED | `learning.py` |
| Predictive chaos (fail-closed) | IMPLEMENTED, TESTED | `chaos.py` |
| Assurance path selection | IMPLEMENTED, TESTED | `paths.py` |
| Clean-room verifier | IMPLEMENTED, TESTED | `cain-oracle-verify/verify.py` |
| 4 hosted stages | **LIVE (RESTRICTION_ONLY)** — installed by default via `default_stages_v19` | `hosted_stages.py`; `install_hosted_pipeline` |
| HTTP surface | IMPLEMENTED, TESTED | `platform-gateway/routers/oracle.py` |
| Latency benchmark | MEASURED (local) | `artifacts/oracle/ORACLE_BENCH.json` |
| Real production effect reconciled with a real prediction | **PARTIAL** — over the hosted path; no external system |
| Real physical system | **NOT IMPLEMENTED** — SIMULATED | none |
| Third-party validation | **NOT IMPLEMENTED** | none |

## Known limitations / blockers
1. Prediction reliability is a heuristic; calibration needs production outcome data to be meaningful.
2. No real physical system; physical AI is SIMULATED.
3. No third-party audit; same-project tests only.
4. Prediction reconciliation over the hosted path is partial — no external effect system is wired.

## Deployment stages
OFF → OBSERVE → SHADOW → RESTRICTION_ONLY (current, installed by default) → ENFORCED. Selected by
`CAIN_HOSTED_PIPELINE_VERSION` (default `19`); `17`/`18` remain available for rollback. The ORACLE stages can only add
a refusal and abstain otherwise. Consequence-critical execution defaults to fail-closed.
