Struct GovernanceEngine 

pub struct GovernanceEngine { /* private fields */ }

Governance engine.

Evaluates actions against governance rules and the environment’s risk threshold. Without the governance feature gate, all evaluations return Permit.

Implementations

impl GovernanceEngine

pub fn new(risk_threshold: f64, human_approval_required: bool) -> Self

Create a governance engine with the given risk threshold.

pub fn open() -> Self

Create an open governance engine that permits everything.

pub fn add_rule(&mut self, rule: GovernanceRule)

Add a governance rule.

pub fn active_rules(&self) -> Vec<&GovernanceRule>

Get all active rules.

pub fn rules_by_branch(&self, branch: &GovernanceBranch) -> Vec<&GovernanceRule>

Get rules by branch.

pub fn evaluate(&self, request: &GovernanceRequest) -> GovernanceResult

Evaluate a governance request.

Decision logic:

1. If any blocking/critical rule applies, deny.
2. If effect magnitude exceeds threshold:
   • If human_approval_required, escalate.
   • Otherwise deny.
3. If any warning rule applies, permit with warning.
4. Otherwise permit.

pub fn risk_threshold(&self) -> f64

Get the configured risk threshold.

pub fn rule_count(&self) -> usize

Get total rule count.

pub fn evaluate_in_environment( &self, request: &GovernanceRequest, env: &Environment, ) -> GovernanceResult

Evaluate a governance request in the context of a specific environment.

Different environment classes apply different risk thresholds:

• Development: uses the environment’s own risk_threshold (lenient, typically 0.9).
• Staging: uses the environment’s own risk_threshold (moderate, typically 0.6).
• Production: uses half the environment’s risk_threshold (strict, typically 0.15).
• Custom: uses the custom class’s risk_threshold directly.

After normal rule evaluation, an additional effect-magnitude check is performed against the environment-adjusted threshold. If the magnitude exceeds it, the decision is overridden to Deny.

pub fn evaluate_logged( &self, request: &GovernanceRequest, chain: Option<&ChainManager>, ) -> GovernanceResult

Evaluate a governance request and log the decision to the chain.

This is the recommended entry point when a ChainManager is available. It calls evaluate and records an ipc.dead_letter-style audit event via [ChainLoggable].

If no chain manager is provided, behaves identically to evaluate.

pub fn evaluate_in_environment_logged( &self, request: &GovernanceRequest, env: &Environment, chain: Option<&ChainManager>, ) -> GovernanceResult

Evaluate in an environment and log the decision to the chain.

pub fn chain_log_result( cm: &ChainManager, request: &GovernanceRequest, result: &GovernanceResult, )

Log a governance result to the ExoChain.

Can be called after any evaluate / evaluate_in_environment call to record the decision in the audit trail.

impl GovernanceEngine

pub fn to_rvf_mode(&self) -> GovernanceMode

Derive the equivalent RVF GovernanceMode from this engine’s config.

• risk_threshold >= 1.0 (open) → Autonomous
• human_approval_required → Approved
• otherwise → Restricted

pub fn to_rvf_policy(&self) -> GovernancePolicy

Build an RVF GovernancePolicy from this engine’s configuration.

Uses the default tool lists and cost budgets for each mode. Callers can customize the returned policy further if needed.