Struct ToolPolicyEngine 

pub struct ToolPolicyEngine { /* private fields */ }

The ring regulation engine — evaluates fight rules to decide whether a fighter can throw a given move.

Uses deny-wins semantics: if ANY matching rule denies the move, the overall decision is denial. The strictest referee always prevails.

Thread-safe invocation tracking via DashMap supports concurrent bouts.

Implementations

impl ToolPolicyEngine

pub fn new() -> Self

Create a new engine with no rules — an anything-goes ring.

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

Add a fight rule to the ring regulations.

pub fn remove_rule(&mut self, name: &str) -> bool

Remove a fight rule by name. Returns true if a rule was removed.

pub fn evaluate( &self, tool_name: &str, fighter_name: &str, capabilities: &[String], ) -> PolicyDecision

Evaluate all matching rules for a tool invocation by a fighter.

The referee checks every applicable rule, sorted by priority (highest first). Deny wins: if any matching rule denies the move, the overall result is denial regardless of allow rules.

If no rules match at all, the default is to allow — permissive by default, like an unsanctioned bout.

pub fn rules(&self) -> &[PolicyRule]

Get all currently registered fight rules.

pub fn matching_rules( &self, tool_name: &str, fighter_name: &str, ) -> Vec<&PolicyRule>

Get all rules whose tool and fighter patterns match the given names. Does NOT check conditions — just pattern matching.

Trait Implementations

impl Debug for ToolPolicyEngine

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ToolPolicyEngine

fn default() -> Self

Returns the “default value” for a type.