Struct Manifest 

pub struct Manifest {
    pub id: String,
    pub version: String,
    pub description: Option<String>,
    pub execute: Execute,
    pub require_approval: bool,
    pub inventory: Option<InventoryHint>,
    pub emit: Option<EmitConfig>,
    pub staleness: Staleness,
}

YAML job manifest (= registered “what to run”, v0.18.0+).

Owns only script-intrinsic fields. Who (target), how to phase fanout (rollout), and when to stagger start (jitter) all moved to the Schedule / exec request side — same script can now be fired against different targets / rollouts without copying the script body.

deny_unknown_fields makes operators copy-pasting an older yaml that still has target: / rollout: see a clear parse error at kanade job create time instead of mysteriously losing it.

Fields

id: String

version: String

description: Option<String>

execute: Execute

require_approval: bool

inventory: Option<InventoryHint>

Opt-in marker that this job produces a JSON inventory fact payload on stdout. When present, the backend’s results projector parses ExecResult.stdout as JSON and upserts an inventory_facts row keyed by (pc_id, manifest.id). The display sub-config drives the SPA’s Inventory page render.

emit: Option<EmitConfig>

Issue #246: opt-in marker that this job emits per-line observability events on stdout (one JSON ObsEvent per newline). When present, the agent — after the script exits successfully — parses each non-empty stdout line as an ObsEvent, publishes it on obs.<pc_id> via the obs_outbox, and (intentionally) omits the stdout from the ExecResult so the timeline data doesn’t double up in execution_results.stdout (which would multiply rows by ~50/day/PC of noise).

Distinct from inventory: (single JSON object → projector upsert) — events are append-only timeline points consumed by the dedicated obs_events table.

staleness: Staleness

v0.26: Layer 2 staleness policy (SPEC.md §2.6.2). Controls what the agent does at fire time when it can’t verify the script_current / script_status KV values are fresh — especially relevant for runs_on: agent schedules where the agent may fire from cache while offline. Defaults to Staleness::Cached (silently use cached values), which matches every pre-v0.26 Manifest.

Implementations

impl Manifest

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

Cross-field semantic checks that don’t fit into pure serde derive. Currently delegates to Execute::validate_script_source — see that method’s docs for the rationale on which call sites should run this.

Trait Implementations

impl Clone for Manifest

fn clone(&self) -> Manifest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Manifest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Manifest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Manifest

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for Manifest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.