Struct PolicyEngine 

pub struct PolicyEngine { /* private fields */ }

The policy engine evaluates actions against both the constitution and the policy rule set.

Implementations

impl PolicyEngine

pub fn new( constitution: Constitution, rules_dir: &Path, patterns_dir: &Path, ) -> Self

Create a new policy engine from a constitution and a rules directory.

pub fn with_rules( constitution: Constitution, rules: PolicyRuleSet, patterns_dir: &Path, ) -> Self

Create a policy engine with an explicit rule set (for testing).

pub fn evaluate(&self, action: &Action) -> ActionDecision

Evaluate an action against the constitution and policy rules.

Decision priority:

1. Constitution forbidden → Blocked (always wins)
2. Policy rules can downgrade (block or require approval) but cannot upgrade a constitution NeedsApproval to Allowed.
3. Constitution requires_approval / auto_allowed
4. Default: NeedsApproval

pub fn evaluate_with_context( &self, action: &Action, workflow_id: Option<&str>, estimated_cost: Option<f64>, ) -> ActionDecision

Evaluate an action with workflow context.

pub fn get_pattern_context( &self, action_type: &str, action_command: &str, ) -> Result<Option<String>>

Get pattern context for an action (for AI model injection).

pub fn rules(&self) -> &PolicyRuleSet

Get a reference to the current rule set.

pub fn rules_mut(&mut self) -> &mut PolicyRuleSet

Get a mutable reference to the current rule set.

pub fn save_rules(&self) -> Result<()>

Save the current rules back to the rules directory.

pub fn reload_rules(&mut self)

Reload rules from the rules directory.

pub fn constitution(&self) -> &Constitution

Get a reference to the constitution.

pub fn pattern_store(&self) -> &PatternStore

Get a reference to the pattern store.