Struct ServiceConfig 

pub struct ServiceConfig {
    pub schema_version: u32,
    pub name: String,
    pub domain: String,
    pub health_path: Option<String>,
    pub components: Vec<ServiceComponent>,
    pub db: DbCatalog,
}

An operator-facing service declaration from .yah/services/<svc>/service.toml.

A service groups one or more components (a static surface, a containerized API, an almanac…) under a single domain. Mirrors project the service onto concrete infra; see MirrorConfig.

Fields

schema_version: u32

name: String

domain: String

health_path: Option<String>

Path the front-door health probe requests, relative to domain. None means /.

/ is the right question for a service whose root serves a site, and the wrong one for an API. An account/RPC origin that versions its surface answers only under its prefix and 404s everything else on purpose — so probing the root reported a broken cell for a service that was behaving exactly as designed, which is the failure mode the probe exists to remove rather than add to. Naming the path here makes the probe ask a question the service has agreed to answer.

Service-scoped rather than per-component or per-mirror: one domain has one front door and therefore one canonical liveness URL, and that URL is a property of the service’s own router — it does not vary by environment, so repeating it per mirror would only let the copies drift.

Must be absolute (leading /); validate refuses anything else rather than silently joining it onto the origin.

components: Vec<ServiceComponent>

db: DbCatalog

Databases this service exposes, grouped by environment (W241). Every entry becomes a data-workbench / sql_* catalog id of the shape <env>:<service>:<name> (e.g. pond:scrabcake:main). Optional and default-empty — services without databases omit the [db] table entirely.

Implementations

impl ServiceConfig

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

Parse a single services/<svc>/service.toml file.

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

Persist to .yah/services/<name>/service.toml, creating the service directory if needed. Create-or-overwrite — the canonical replacement for the legacy sites.json write path. workspace_root is the camp dir (the parent of .yah/).

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

Remove .yah/services/<name>/ and everything under it (service.toml plus its mirrors/). Returns false when the directory was already absent, so callers can distinguish “deleted” from “no-op”.

Trait Implementations

impl Clone for ServiceConfig

fn clone(&self) -> ServiceConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ServiceConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ServiceConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.