Pattern Proposal: Rule-Driven Health Evaluation Model

Summary

Compute system and governance health state through pure aggregation functions mapping findings to health statuses and explanatory reasons.

Candidate Pattern

• ID: rule-driven-health-evaluation-model
• Classification: architectural
• 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 aggregates explanatory reasons based on governance inventory and compliance inputs.

Scope Assessment

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

Rationale

• Intent: Decouple health score and status determination from presentation dashboards, making health calculation deterministic and testable.
• Context: The governance portal and CLI need to report overall health status (GREEN, YELLOW, RED) based on compliance violations and risk levels.
• Force: Directly embedding threshold logic into dashboard views leads to divergent status interpretations across different outputs.
• Force: Consumers need both a coarse-grained status enum and fine-grained textual reasons.

Traceability

Artifact source: proposed-patterns