Struct TriggerStatus 

pub struct TriggerStatus {

    pub trigger: String,
    pub name: Option<String>,
    pub kind: String,
    pub workflow: String,
    pub connector: Option<String>,
    pub connector_tool: Option<String>,
    pub enabled: bool,
    pub paused: bool,
    pub due: bool,
    pub timezone: Option<String>,
    pub next_due_local: Option<String>,
    pub leased_by: Option<String>,
    pub next_due_at: Option<i64>,
    pub last_fired_at: Option<i64>,
    pub consecutive_failures: u32,
    pub last_error: Option<String>,
    pub exhausted: bool,
    pub never_fired: bool,
    pub plan_head: Option<String>,
    pub unusable: Option<String>,
    pub cursor: Option<String>,
    pub op_cursor: Option<i64>,
    pub chain_root: String,
}

One trigger considered, for --dry-run and status.

Fields

trigger: String

name: Option<String>

The declaration’s name, when it carries one.

name is what a human uses to identify a trigger, and it is accepted on write — but nothing read it back (#73), so identity fell onto the workflow hash, which is stable only until the plan is re-declared. It rides in extra_fields rather than being a typed field: OMS §A.7 has no Trigger name, and inventing one would be a spec-level decision for a label.

kind: String

workflow: String

connector: Option<String>

The connector’s name, and — when its code is a grain (#185) — the Definition that carries it.

Reported because a reader looking at a heartbeat needs to know which of the two connector kinds this is: the answer decides whether the code travelled with the memory or lives on whichever machine happens to run the pass, and that is the first question a stale-poll investigation asks.

connector_tool: Option<String>

enabled: bool

paused: bool

due: bool

timezone: Option<String>

The IANA zone a SCHEDULE trigger’s cron is evaluated in (#297).

None for UTC and for every non-schedule kind. Reported because “when is this due” now depends on it, and on a DST boundary the UTC instant moves by an hour while the local wall time does not — so a status surface that showed only the UTC instant would look like the schedule had drifted.

next_due_local: Option<String>

The next due instant in the trigger’s own zone, beside the UTC one (#297). None when the zone is UTC or nothing is due.

leased_by: Option<String>

next_due_at: Option<i64>

last_fired_at: Option<i64>

consecutive_failures: u32

last_error: Option<String>

exhausted: bool

Will never fire again — a one-shot past its instant.

never_fired: bool

Never fired and no failure recorded — the state an unnoticed misconfiguration sits in, so it is reported rather than inferred.

plan_head: Option<String>

The plan this trigger names has been EDITED: the current head of its supersession chain, when that is not the hash the trigger points at.

A Workflow is content-addressed, so editing one mints a new address and a trigger keeps starting the version it was declared against. That is the correct default — a plan edit must not silently change what fires unattended — but it is invisible without this: nothing in a listing distinguished a trigger running the current plan from one running a version three edits old, and the run itself succeeds either way.

Reported, never followed. areev trigger retarget is the deliberate act that moves it, and it is a human’s to take.

unusable: Option<String>

Why this declaration can never fire, if it cannot.

A trigger can become unusable without ever being written through a validating path — it can arrive by bundle import from an implementation that validated differently, or predate the check. So the evaluator reports it rather than assuming the write path caught everything.

cursor: Option<String>

The connector’s last reported position, for a trigger that has ever polled. Opaque and connector-defined (#128) — surfaced so an operator can SEE the state that a re-pointed trigger’s evaluation carries forward, which before this was invisible even though nothing else could carry it by hand.

op_cursor: Option<i64>

The op-log position, a memory trigger’s cursor equivalent.

chain_root: String

The hash evaluation state is actually keyed under: trg:<chain_root> (#128). Equal to trigger for a trigger that has never been superseded — the common case, unchanged from before this field existed. Differs only for a trigger re-pointed by SUPERSEDE, where it names the ORIGINAL declaration’s hash — the identity the cursor and dedup fence actually survive under.

Trait Implementations

impl Clone for TriggerStatus

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 TriggerStatus

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

Formats the value using the given formatter.

impl Serialize for TriggerStatus

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

where __S: Serializer,

Serialize this value into the given Serde serializer.