Struct MirrorConfig 

pub struct MirrorConfig {
    pub schema_version: u32,
    pub shape: MirrorShape,
    pub ingress: IngressProvider,
    pub providers: BTreeMap<String, MirrorProviderSlot>,
    pub drivers: BTreeMap<String, MirrorProviderSlot>,
    pub asset_aliases: BTreeMap<String, String>,
}

A service mirror — the projection of a ServiceConfig onto concrete infra. Lives at .yah/services/<svc>/mirrors/<env>.toml.

Fields

schema_version: u32

shape: MirrorShape

ingress: IngressProvider

Public-ingress provider fronting this mirror (W267). Defaults to IngressProvider::None.

Declared at mirror scope rather than per provider slot because a front door does fan-in: one cloudflared (or one passway) on a node multiplexes every hostname→port rule the mirror needs, so pinning it to a single slot would mint one edge connection per slot for no gain.

providers: BTreeMap<String, MirrorProviderSlot>

Provider slots, keyed by role ("static", "compute", …). Each value either references a provider declared under .yah/infra/providers/ or inlines a local-only provider (no creds, no infra file).

drivers: BTreeMap<String, MirrorProviderSlot>

Capability→driver bindings, keyed by capability ("pg", "s3", …) rather than by slot role (W265 §Drivers).

This is the generalization of Self::providers: providers.static / providers.object_store are the special case where the slot name and the capability happen to coincide, and keying by capability is what stops the slot enum growing one arm per tier-specific implementation. A service says “I need pg”; the mirror says which implementation of pg this tier uses; the app talks the same wire protocol either way and never forks.

[drivers.pg]
kind = "local-pg-dev"     # dev  — kamaji-supervised loopback postgres

Additive in P1: drivers lands alongside providers, and migrating the existing providers.static / providers.object_store declarations over is a separate pass (W265 §“Open follow-ups”). A mirror that declares neither is unchanged.

asset_aliases: BTreeMap<String, String>

Per-environment alias overrides for kind = "static-asset" components.

Keys are logical names (e.g. "whisper-default"); values must be filenames present in the component’s workload.toml catalog. Resolution only — this table may never introduce a filename absent from the catalog. Validated against the workload catalog at sync time.

Implementations

impl MirrorConfig

pub fn driver(&self, capability: Capability) -> Option<&MirrorProviderSlot>

The driver bound to capability in this mirror, if any.

None means the tier declares no implementation. In P1 that’s simply “this mirror doesn’t use that capability”; P2’s binding-error surface is what turns it into a diagnosable failure for a service that needs it.

impl MirrorConfig

pub fn load(path: &Path) -> Result<Self>

Parse a single mirrors/<env>.toml file.

pub fn save( &self, workspace_root: &Path, service: &str, env: &str, ) -> Result<()>

Persist to .yah/services/<service>/mirrors/<env>.toml, creating the mirrors/ directory if needed. Create-or-overwrite. The mirror file is named by env (its stem); service selects the owning service dir.

pub fn delete(workspace_root: &Path, service: &str, env: &str) -> Result<bool>

Remove .yah/services/<service>/mirrors/<env>.toml. Returns false when the file was already absent. Leaves the service and its other mirrors untouched.

Also checks legacy stems (e.g. local-sim when env = "pond") so deleting a canonical tier name removes whichever file exists on disk.

Trait Implementations

impl Clone for MirrorConfig

fn clone(&self) -> MirrorConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MirrorConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MirrorConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MirrorConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.