# Policy explainers

Purpose
- Provide evidence-backed explanations for policy decisions.
- Always show evidence hashes, signals, and rule rationale.

Surfaces
- Findings table links to the explainer drawer.
- Explainer drawer shows rule stack, inputs, signals, and evidence hashes.
- Timeline and runs tabs show policy events and run inputs.

Drawer layout
- Header: status, severity, policy version, shadow flag, AOC badge.
- Evidence panel: SBOM digest, advisory snapshot, VEX IDs, reachability graph hash, runtime hit flag, attestation refs.
- Rule hits: ordered list with because, signals snapshot, actions taken.
- Reachability path: signed call path and edge bundle hash when available.
- Signals: trust_score, reachability state and score, uncertainty level, runtime hits.

Interactions
- Verify evidence triggers the policy explain verify flow and shows DSSE status.
- Toggle baseline compares against previous policy version.
- Download exports JSON with evidence hashes for offline review.

Accessibility
- Keyboard navigation across header, evidence, rules, actions.
- Screen reader labels include status, severity, reachability state, trust score.

Offline behavior
- Explainers work with offline bundles and embedded attestations.
- If transparency logs are unavailable, show offline verify status with bundle digest.

Error states
- Missing evidence shows unknown chips and rerun guidance.
- Attestation mismatch shows warning badge and governance links.