# CAIN VIGIL — Containment

`cain/vigil/containment.py`, `VigilContainmentEngine`.

Severity 0..6 maps deterministically to containment actions:

| severity | actions |
|---|---|
| ≥1 | RESTRICT_TOOL, RESTRICT_SPENDING, RESTRICT_SELF_MODIFICATION |
| ≥2 | RESTRICT_DELEGATION, RESTRICT_DEPLOYMENT, FREEZE_EVIDENCE |
| ≥3 | RESTRICT_COMMUNICATION, RESTRICT_PHYSICAL |
| ≥4 | PAUSE_AGENT |
| ≥5 | QUARANTINE_AGENT, REVOKE_AUTHORITY |
| ≥6 | INITIATE_RECOVERY |

Every containment produces a digestible receipt.

## Governed containment (P153)
`may_override(authority, containment_severity)` returns `override_allowed=False` for any active containment: **no
agent can override VIGIL's containment through ordinary autonomous authority**. Containment is itself governed and
fail-closed.

## Status
IMPLEMENTED, TESTED, LIVE (the `vigil_containment` restriction-only hosted stage).
