Struct ReconcileCtx 

pub struct ReconcileCtx<'a> {
    pub workspace_root: &'a Path,
    pub service: &'a ServiceConfig,
    pub component: &'a ServiceComponent,
    pub mirror: &'a MirrorConfig,
    pub env: &'a str,
    pub scope: ProviderScope,
}

Inputs a reconciler sees for one bring-up.

Fields

workspace_root: &'a Path

Workspace root (parent of .yah/). Used to resolve relative paths on the component.

service: &'a ServiceConfig

Service that owns the component.

component: &'a ServiceComponent

Component being brought up.

mirror: &'a MirrorConfig

Mirror manifest the bring-up targets.

env: &'a str

Environment name (file stem of mirrors/<env>.toml).

scope: ProviderScope

(tenant, namespace) this bring-up is scoped to (W206). Credentialed providers resolve at this scope; defaults to ProviderScope::singleton.

Implementations

impl<'a> ReconcileCtx<'a>

pub fn workload_dir(&self) -> PathBuf

Absolute path to the component’s workload directory (the parent of workload.toml).

In-tree components resolve to <workspace_root>/<path>. For git-sourced components (R561-F1, “BYO git”) this points into the local clone — <source_cache>/<subdir>/<path> — which is empty until materialize runs (approach A: clone-at-reconcile, so config load + validation stay offline).

pub async fn materialize(&self) -> Result<()>

Ensure a git-sourced component’s code is present locally before build (R561-F1, approach A). No-op for in-tree components. Idempotent: clones on the first call, fetches + re-checks-out the pinned ref thereafter.

Reconcilers MUST call this at the top of up before reading workload_dir for a remote component.

pub fn workload_kind(&self) -> Result<String>

Read <workload_dir>/workload.toml and extract just the kind discriminator.

Why this and not the strongly-typed workload_spec::Workload parse: the on-disk schema_version = 1 form predates the SchemaVersion::V1 enum and won’t round-trip through the strong types until B3 lands (see crates/yah/cloud/src/config.rs test web_workload_round_trips). Reconcilers only need the kind to dispatch; per-kind tooling (e.g. mesofact-dev’s WatchOptions::from_workload) does its own parsing for the build/out_dir fields it cares about.

pub fn slot(&self, role: &str) -> Option<&'a MirrorProviderSlot>

Look up a provider slot by role (e.g. "static", "compute").

Tries the component-qualified key first ("<role>:<component id>") before falling back to the bare role. A mirror role is normally service-wide — one providers.static slot serves every static-kind component — but a service can declare more than one component with the same role (e.g. two mesofact-static/mesofact-spa components sharing one mirror), and those need distinct ports to ever both come up. The qualified key is how a mirror opts a specific component out of sharing the bare-role slot:

[providers."static:site"]
kind = "local-static"
port = 4331

[providers."static:app"]
kind = "local-static"
port = 4332

A mirror with only the bare role (the common, single-component case) is unaffected — the qualified lookup misses and falls through.