# CAIN REALITY — Production Readiness

| Capability | Status | Evidence |
|---|---|---|
| External observer model + adapters (HTTP/Git/ntfy) | IMPLEMENTED, TESTED | `observers.py` |
| External state snapshot + expected state | IMPLEMENTED, TESTED | `objects.py` |
| Field-level + multi-observer + contradiction reconciliation | IMPLEMENTED, TESTED | `reconciliation.py` |
| Causal effect + concurrent-actor attribution | IMPLEMENTED, TESTED | `causal.py` |
| Temporal + eventual-consistency governance | IMPLEMENTED, TESTED | `temporal.py`, `reconciliation.py` |
| External drift + world-model calibration | IMPLEMENTED, TESTED | `drift.py` |
| Ground-truth certificate | IMPLEMENTED, TESTED | `certificate.py` |
| Replay + incident bundle | IMPLEMENTED, TESTED | `replay.py` |
| 3 hosted stages | **LIVE (RESTRICTION_ONLY)** — installed by default via `default_stages_v21` | `hosted_stages.py`; `install_hosted_pipeline` |
| Clean-room verifier | IMPLEMENTED, TESTED | `cain-reality-verify/verify.py` |
| **Real external end-to-end canary** | **EXECUTED (ntfy.sh, reversible, auto-expiring)** | `artifacts/reality/REALITY_CANARY.json` |
| Real industrial / database / Kubernetes production effect | **NOT IMPLEMENTED** | none |
| Physical system | **NOT IMPLEMENTED** — SIMULATED | none |
| Third-party validation | **NOT IMPLEMENTED** | none |

## Known limitations / blockers
1. One real external system (a public publish/observe topic) is demonstrated; database/K8s/cloud adapters are not yet
   wired to live production endpoints in this environment.
2. Observers authenticate by TLS + integrity method; no hardware root of trust yet.
3. The hosted reality stages are restriction-only and read caller-supplied assessment/certificate payloads.
4. No third-party audit; same-project tests only.

## Enforcement gate (derived)
A reconciliation may reach ENFORCED only when: `REAL_EXTERNAL_OBSERVATION + RECONCILIATION_MATCH +
CLEAN_ROOM_VERIFICATION + NO_UNRESOLVED_CONTRADICTION + VALID_AUTHORITY + VALID_EFFECT + MISSION_COMPLETION`.
Current state: RESTRICTION_ONLY (installed by default).

## Deployment stages
OFF → OBSERVE → SHADOW → RESTRICTION_ONLY (current, installed by default) → ENFORCED. Selected by
`CAIN_HOSTED_PIPELINE_VERSION` (default `21`); 17–20 remain for rollback.
