Struct RuleSet 

pub struct RuleSet {
    pub enabled: BTreeMap<String, bool>,
    pub weights: BTreeMap<String, f32>,
    pub version: Option<String>,
}

Hot-reloadable rule configuration. Carries an enable flag and a soft weight in [0.0, 1.0] for each of the 8 categorical rules the encoder knows about. weights is stored for the closed-loop bandit / experiment generator; the encoder itself treats weight < ENABLE_WEIGHT_THRESHOLD as “off” and otherwise consults enabled.

Missing keys default to enabled / weight 1.0, so a sparse TOML file can express only the deltas from the v1 default ruleset.

Fields

enabled: BTreeMap<String, bool>

Per-rule on/off override. Keys come from RULE_NAMES. Anything not listed is enabled.

weights: BTreeMap<String, f32>

Per-rule weight in [0.0, 1.0]. Used by the bandit; the encoder uses it only to derive an effective on/off when the enabled map omits the key.

version: Option<String>

Optional version tag, surfaced by the dashboard / statusline so an operator can tell at a glance which ruleset is live.

Implementations

impl RuleSet

pub fn default_v1() -> Self

The v1 default ruleset. Stable inline rules and lossless tool-output cleanup are enabled; canary-only semantic rewrites stay disabled. This remains identical in observable behaviour to the constants-only encoder for prompt text.

success and failure are disabled by default as of 2026-04-24: a per-rule ablation study (commit d431b90, scripts/ablate_rules.py) showed they fire 11 and 28 times respectively on the real audit corpus but produce -13 and -42 tokens of “savings” — the unicode glyph substitutions (✓, ✗) tokenize to more tokens than the ASCII originals on the Claude tokenizers. Shipping them enabled actively harmed compression. Consumers that want the legacy behaviour can still opt in explicitly, and the safe_canary_v1 ruleset (introduced earlier for the same reason) remains available as a typed checkpoint.

pub fn safe_canary_v1() -> Self

Lower-risk canary ruleset from the autoresearch loop: disable the success/failure glyph substitutions while keeping lossless tool-output cleanup enabled. This preserves English polarity words, which reduces semantic risk on prompts where success/failure are domain terms.

pub fn agentic_canary_v2() -> Self

Agentic canary ruleset from the quality-first autoresearch loop. Enables deterministic tool-output codecs that change surface syntax but preserve reconstruction or explicit semantic fields for their supported structures.

pub fn is_enabled(&self, rule: &str) -> bool

True if the named rule is enabled. Missing entries default to enabled; a weight below ENABLE_WEIGHT_THRESHOLD also flips the rule off so a bandit can soft-demote without explicit toggling.

pub fn weight(&self, rule: &str) -> f32

Read effective weight for a rule. Missing entries return 1.0.

pub fn from_toml_str(s: &str) -> Result<Self, Error>

Parse a TOML document into a RuleSet. Any unrecognised key is silently dropped (forward compatibility), and any rule name not in RULE_NAMES is also dropped (defensive against a corrupted ruleset file).

Errors

Returns the underlying TOML parse error.

pub fn from_toml_file(path: &Path) -> Result<Self>

Load a RuleSet from a TOML file on disk.

Errors

I/O or parse errors.

pub fn to_toml_string(&self) -> Result<String, Error>

Render this ruleset as a TOML document. Used by the controller to write a tuned ruleset back to disk before signalling reload.

Errors

Serialization errors from toml::to_string_pretty.

Trait Implementations

impl Clone for RuleSet

fn clone(&self) -> RuleSet

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RuleSet

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

Formats the value using the given formatter.

impl Default for RuleSet

fn default() -> RuleSet

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RuleSet

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RuleSet

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.