Struct ReactionConfig 

pub struct ReactionConfig {
    pub auto: bool,
    pub action: ReactionAction,
    pub message: Option<String>,
    pub priority: Option<EventPriority>,
    pub retries: Option<u32>,
    pub escalate_after: Option<EscalateAfter>,
    pub threshold: Option<String>,
    pub include_summary: bool,
    pub merge_method: Option<MergeMethod>,
}

A single reaction rule, typically read from ~/.ao-rs/config.yaml under reactions.<key>. See docs/reactions.md for the full list of reaction keys and the matrix of which actions make sense for each.

All fields except action have sensible defaults, so the minimal valid config is one line:

approved-and-green:
  action: notify

Everything else — retries, escalation, priority — falls back to a value the engine considers “reasonable for hobby use”.

Fields

auto: bool

Master on/off. false means the engine sees the reaction key but does nothing; useful for disabling individual rules without deleting them. Defaults to true so newly-added rules are live.

We skip serializing when true so a round-tripped config stays terse: the common case (enabled) doesn’t clutter the output. Pair with include_summary below — both default-valued fields omit on write so a user who hand-edited a minimal config reads back a minimal config.

action: ReactionAction

What to do when the reaction fires. No default — you have to pick.

message: Option<String>

Body for SendToAgent, override text for Notify. Ignored by AutoMerge. Missing for SendToAgent falls back to an engine-supplied boilerplate (Phase D).

priority: Option<EventPriority>

Priority for the resulting notification. Defaults to the reaction-key-specific default the engine picks (see docs/reactions.md).

retries: Option<u32>

Max attempts of SendToAgent before escalating to Notify. None means “retry forever”, matching TS.

escalate_after: Option<EscalateAfter>

Escalate after N attempts or after a wall-clock duration, whichever the user configured. Absent means “use retries as the only gate”.

threshold: Option<String>

Duration threshold for time-based triggers (e.g. "10m" for agent-stuck). Kept as an opaque string until Phase D adds a parser.

include_summary: bool

Whether to attach a context summary to the notification. Defaults to false because the engine doesn’t yet know how to produce one; Phase D might flip the default.

merge_method: Option<MergeMethod>

Merge method to use when action: auto-merge. If unset, the SCM plugin’s default is used.

Implementations

impl ReactionConfig

pub fn new(action: ReactionAction) -> Self

Convenience constructor for tests and Phase D wiring. Mirrors the minimum useful config (auto: true, action set, everything else default).

Trait Implementations

impl Clone for ReactionConfig

fn clone(&self) -> ReactionConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReactionConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ReactionConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ReactionConfig

fn eq(&self, other: &ReactionConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ReactionConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ReactionConfig

impl StructuralPartialEq for ReactionConfig