Pattern Proposal: Typed Governance State Contracts

Summary

Pydantic models define governance inventories, health, risks, actions, findings and metrics.

Candidate Pattern

• ID: typed-governance-contracts
• Classification: governance
• Maturity: established
• Type: implemented

Observed Signals

No specific signals listed.

Evidence

Supporting Evidence

• src/cas_runner/governance/models.py (ResolutionResult, TraceableMetric, GovernanceInventory, GovernanceHealth, GovernanceThroughput, GovernanceRisks, ComplianceFinding, ComplianceMetrics, GovernanceException, GovernanceAction) - Defines governance and compliance state objects.
• pyproject.toml - pydantic and jsonschema dependencies support typed contracts.

Scope Assessment

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

Rationale

• Intent: Make governance state explicit, validation-friendly and portable between engines and dashboards.
• Context: src/cas_runner/governance/models.py defines multiple governance and compliance models, supported by pydantic and jsonschema dependencies.
• Force: governance engines need shared vocabulary
• Force: compliance findings must be auditable
• Force: health and metrics must be comparable across runs

Traceability

Artifact source: proposed-patterns