Enum PolicyEvent 

pub enum PolicyEvent {
    Finding(FindingEvent),
    WarnUnsafe {
        trigger: Trigger,
        policy: PolicyId,
    },
    CoreFinding {
        core_id: &'static str,
        code: &'static str,
        message: String,
    },
    EngineFailure {
        code: EngineFailureCode,
        message: String,
        trigger: Option<Trigger>,
        policy: Option<PolicyId>,
        path: Option<EventPath>,
    },
    FixSummary {
        trigger: Trigger,
        passes: u64,
        changed_paths: Vec<EventPath>,
    },
    CommitLanded {
        oid: String,
    },
    LandingRaceLost {
        attempt: u64,
        winning_oid: String,
    },
    LandingReserved {
        lost_races: u64,
    },
    CommitReplayed {
        prepared_oid: String,
        from_base: Option<String>,
        onto: String,
        oid: String,
    },
    ReplayHeadersDropped {
        prepared_oid: String,
        oid: String,
        headers: Vec<String>,
    },
    ReplayConflict {
        target_ref: String,
        paths: Vec<String>,
        winning_oid: String,
        prepared_oid: String,
    },
}

What: Every event a policy pass can produce. An enum is a closed set of named alternatives; each variant carries its own fields. Vec<EventPath> is an owned list of pathnames in their event form. Why: One list of events is rendered in order, whatever mixture of kinds it holds.

In TS you’d write (pseudocode):

type PolicyEvent = FindingEvent | ConfigurationWarningEvent | CoreFindingEvent | EngineFailureEvent | FixSummaryEvent;

Variants

Finding(FindingEvent)

A policy reported something.

WarnUnsafe

A policy that warn does not protect is configured as warn.

Fields

trigger: Trigger

The lifecycle point that ran the policy.

policy: PolicyId

The policy configured as warn.

CoreFinding

A fixed transform rejected the command; it has no severity and cannot be configured.

Fields

core_id: &'static str

The transform, for example commit-only.

code: &'static str

The transform-local code; rendering prefixes the transform name.

message: String

The explanation for the person who ran the command.

EngineFailure

The pass could not complete.

Fields

code: EngineFailureCode

The stable cause.

message: String

The explanation for the person who ran the command.

trigger: Option<Trigger>

The lifecycle point, when the failure belongs to one.

policy: Option<PolicyId>

The policy that could not complete, when one is responsible.

path: Option<EventPath>

The repository path responsible, when the failure is about one path.

FixSummary

Corrections were applied.

Fields

trigger: Trigger

The fixing lifecycle point.

passes: u64

How many passes changed candidate content before it settled.

changed_paths: Vec<EventPath>

The changed paths, each once, in Git’s byte order.

CommitLanded

The landed commit whose automatic backup the post-commit gate stopped. The commit stays local; the event names it so the user can push it deliberately.

Fields

oid: String

The exact landed commit object ID.

LandingRaceLost

A landing found the target moved (landing-race-lost).

Fields

attempt: u64

This transaction’s lost races so far, from 1.

winning_oid: String

The target value that won.

LandingReserved

A commit that lost enough races holds the next landing slot (landing-reserved).

Fields

lost_races: u64

Lost races when the reservation was granted.

CommitReplayed

A prepared commit was replayed onto the moved target (commit-replayed).

Fields

prepared_oid: String

The prepared commit.

from_base: Option<String>

The preparation base, absent when the branch was unborn.

onto: String

The target value the replay used as parent.

oid: String

The replayed commit, after revalidation.

ReplayHeadersDropped

A signed replay could not carry some custom headers (replay-headers-dropped).

Fields

prepared_oid: String

The prepared commit carrying the headers.

oid: String

The re-signed commit lacking them.

headers: Vec<String>

The dropped header names in prepared-commit order, each once.

ReplayConflict

The core finding concurrent-commit/replay-conflict, with the data a person needs to resolve it.

Fields

target_ref: String

The target ref the commit aimed at.

paths: Vec<String>

The conflicting paths in Git path byte order.

winning_oid: String

The earliest target commit touching a conflicting path.

prepared_oid: String

The prepared commit kept for cherry-picking.

Trait Implementations

impl Clone for PolicyEvent

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PolicyEvent

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

Formats the value using the given formatter.

impl Eq for PolicyEvent

impl PartialEq for PolicyEvent

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PolicyEvent