# CAIN VIGIL — Specification

`cain/vigil/`. Canonical, deterministic, machine-verifiable.

## VigilState
Dimensions (0..1, higher = safer): authority, observability, evidence_quality, behavioral_stability,
world_state_confidence, memory_integrity, tool_integrity, model_integrity, environment_stability,
effect_verification_quality. Plus consequence_magnitude (LOW/MEDIUM/HIGH/CRITICAL), reversibility
(REVERSIBLE/PARTIAL/IRREVERSIBLE), drift, adversarial_pressure, delegation_depth, capability_level, assurance_level, state.

## States
`VIABLE · DEGRADED · UNCERTAIN · RESTRICTED · PAUSED · QUARANTINED · REVOKED · RECOVERY`.
Transitions are deterministic and auditable; authority can only contract. Recovery requires an explicit evidenced
recovery (`recovered=True, evidence_ok=True`).

## AutonomyViabilityEnvelope
Ceilings/floors: authority_ceiling, consequence_ceiling, uncertainty_ceiling, observability_floor, evidence_floor,
behavioral_drift_ceiling, world_state_confidence_floor, memory/tool/model_integrity_floor,
environment_stability_floor, delegation_ceiling, temporal_validity_s, reversibility_requirement,
adversarial_pressure_ceiling. `evaluate(state)` names every violated bound.

## AuthorityReleaseEngine + AuthorityReleaseCurve
Decisions: `ALLOW · ALLOW_WITH_RESTRICTION · REQUIRE_REAUTHORIZATION · REQUIRE_HUMAN · PAUSE · BLOCK · QUARANTINE · REVOKE`.
The curve is multidimensional (financial, data, tool, delegation, execution, physical, communication, resource,
deployment, self_modification) with levels FULL/REDUCED/RESTRICTED/ZERO. Every contraction names its cause.

## UncertaintyBudget
Classes: `KNOWN · ESTIMATED · INFERRED · UNVERIFIED · STALE · CONFLICTING · UNKNOWN · ADVERSARIAL`.
Asymmetric critical-unknown treatment; acceptable ceiling shrinks with consequence.

## ObservabilityBudget
Classes: `Observable · PartiallyObservable · Unobservable`. Unobservable is never safe.

## BehavioralDriftEngine
Jensen-Shannon divergence over per-dimension distributions + windowed change-point detection. Kinds:
DISTRIBUTION/S EQUENCE/FREQUENCY/STRUCTURAL/GOAL_PATTERN/DELEGATION/CAPABILITY shift.

## WorldStateConfidenceEngine
Confidence from source confidence × accuracy × consistency, halved on stale/dependent/false-consensus and on
disagreement; a floor by consequence.

## PredictiveFailureEngine + CapabilityAssuranceDelta
Trajectory + predicted failure mode + estimated time to boundary (labelled PREDICTED/ESTIMATED/UNCERTAIN);
capability growth faster than assurance ⇒ must_not_expand.

## Containment
Actions: RESTRICT_TOOL/SPENDING/DELEGATION/COMMUNICATION/PHYSICAL/DEPLOYMENT/SELF_MODIFICATION, PAUSE_AGENT,
QUARANTINE_AGENT, REVOKE_AUTHORITY, FREEZE_EVIDENCE, INITIATE_RECOVERY. Not overridable by ordinary authority.

## Status
IMPLEMENTED, TESTED (except prediction: EXPERIMENTAL forecast; physical: SIMULATED).
