Pattern Proposal: Explainable Governance Health Model

Summary

The dashboard health model calculates status and reasons from governance state.

Candidate Pattern

• ID: explainable-governance-health-model
• Classification: intelligence
• Maturity: strategic_direction
• Type: emerging

Observed Signals

No specific signals listed.

Evidence

Supporting Evidence

• src/cas_runner/dashboard/health_model.py (HealthStatus, calculate_health, get_health_reasons) - Computes health status and reasons.
• src/cas_runner/governance/models.py (GovernanceHealth) - Governance health is modelled as typed state.

Scope Assessment

• Evidence Strength: high
• Confidence: high
• Applies to: ideas-to-life-cas

Rationale

• Intent: Make system or governance health inspectable and explainable to operators or downstream agents.
• Context: src/cas_runner/dashboard/health_model.py defines HealthStatus, calculate_health and get_health_reasons, alongside GovernanceHealth in governance models.
• Force: operators need quick status understanding
• Force: governance state may be complex
• Force: status must be explainable, not opaque

Traceability

Artifact source: proposed-patterns