# CAIN REALITY — Architecture

**REALITY = External Reality Reconciliation & Ground-Truth Assurance Fabric.**

> NO EXTERNAL GROUND TRUTH → NO VERIFIED OUTCOME.
> EXPECTED ≠ OBSERVED ≠ VERIFIED; AGENT CLAIM ≠ SYSTEM TRUTH; SIMULATION ≠ REAL-WORLD OBSERVATION.

REALITY closes the EPICENTER production gap: it proves that an externally observable system state actually matches the
effect and mission outcome CAIN authorized and expected. It adds no new moat and builds no second CAIN.

## Position

```
AGENT → MISSION CONTRACT → AUTHORITY → HERMES → ORACLE → ARGUS → VIGIL → CRUCIBLE → CAIN DECISION → MCPGATE →
IRONCLAD EFFECT → EXTERNAL SYSTEM → EXTERNAL OBSERVER → REALITY SNAPSHOT → REALITY RECONCILIATION →
CAUSAL EFFECT VERIFICATION → EPICENTER MISSION VERIFICATION → GROUND-TRUTH CERTIFICATE → CLEAN-ROOM VERIFICATION →
EVIDENCE → CONTINUOUS RECERTIFICATION
```

## Eleven levels that never collapse
INTERNAL_INTENT, AUTHORIZED_INTENT, AUTHORIZED_EFFECT, REQUESTED_EFFECT, EXECUTED_EFFECT, OBSERVED_EFFECT,
VERIFIED_EFFECT, EXTERNAL_STATE, RECONCILED_STATE, MISSION_OUTCOME, GROUND_TRUTH.

## Collision matrix (reused, not duplicated)

| Existing | Where | REALITY difference |
|---|---|---|
| IRONCLAD effect verification | `cain/ironclad/` | REALITY observes the EXTERNAL system independently and attributes causality |
| EPICENTER mission completion | `cain/epicenter/` | REALITY supplies the external reality evidence the mission verdict needs |
| ORACLE evidence independence / prediction | `cain/oracle/` | REALITY reuses the independence graph and calibrates the world model against real observations |
| ARGUS / VIGIL / HERMES / CRUCIBLE | various | REALITY feeds external-reality contradictions into them; does not replace them |
| govmission E38 outcome proof | `cain/govmission/` | REALITY is the external observation/reconciliation layer |

## Modules (`cain/reality/`)
`objects` · `observers` · `reconciliation` · `causal` · `temporal` · `drift` · `certificate` · `replay` · `chaos` ·
`lab` · `properties14` · `hosted_stages`. Clean-room verifier: `cain-reality-verify`. Adapters: `HTTP_API`,
`GIT_REPOSITORY`, `NTFY_TOPIC`.

## Status
See `REALITY_PUBLIC_TRUTH.md`. A REAL external canary was executed (ntfy.sh); same-project tests only; no real
physical system; no third-party validation.
