Struct ImportConfig 

pub struct ImportConfig {
    pub source: PathBuf,
    pub hash: Option<String>,
    pub materialize: bool,
    pub event: Option<String>,
    pub inputs: HashMap<String, String>,
}

Step-level config for StepKind::Import (W224, R533-F1). The W224 import primitive: a QED step whose source is a workflow.yml, carrying the content hash of that yml plus a toggle for whether the expansion is persisted.

[[steps]]
name = "release"
kind = "import"
[steps.import]
source = ".github/workflows/release.yml"
hash = "af1349b9f5f9a1a6a0404dea36dcc949..."  # blake3 of the source, pinned
# materialize = false                          # default — virtual expansion

Whether the expansion is persisted is the migration ramp (W224): virtual (default) recomputes the subgraph at plan time and stores nothing — zero drift by construction; materialize ejects it to generated TOML (R533-F6). While the yml is canonical the TOML is virtual; once ejected the yml is gone — never two editable canonical copies at once. The freshness check and plan-time expansion live in crate::import.

Fields

source: PathBuf

Path to the imported .github/workflows/*.yml, resolved relative to the camp root.

hash: Option<String>

blake3 content hash of the source bytes, pinned at import time (crate::import::content_hash). None while unpinned (a first import or a hand-authored block). On every run the runner recomputes the source hash and compares via Self::freshness: a mismatch means the source drifted since pinning. Under the default virtual expansion a mismatch is benign (re-expand + re-pin); for a materialized eject it marks the on-disk generated TOML stale (R533-F6).

materialize: bool

Persist the plan-time expansion as generated, hash-stamped TOML (the R533-F6 eject), vs. the default virtual expansion computed fresh at plan time and never stored. Virtual-by-default is zero-drift by construction (W224). F1 only carries the toggle; the eject/materialize machinery and its stale-source guard land in R533-F6.

event: Option<String>

GHA event the expansion impersonates while F1’s expansion still routes through the recast W200 front-end (push | workflow_dispatch). None defaults to push at runtime — matches release.yml’s tag-push primary trigger. Forwarded into the synthesized GhaWorkflowConfig by crate::import::expand_import.

inputs: HashMap<String, String>

workflow_dispatch inputs forwarded into the expansion context. Ignored when event != "workflow_dispatch".

Implementations

impl ImportConfig

pub fn freshness(&self, actual: &str) -> ImportFreshness

Compare a freshly-computed source hash against the pinned one.

actual is the content_hash of the bytes currently on disk; the caller computes it (the runner has just read the file, so it owns the bytes). Pure — no I/O here.

Trait Implementations

impl Clone for ImportConfig

fn clone(&self) -> ImportConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImportConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ImportConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ImportConfig

impl PartialEq for ImportConfig

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ImportConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ImportConfig