Struct StackDef 

pub struct StackDef {
    pub stack: Stack,
    pub secrets: SecretsSpec,
    pub integrations: BTreeMap<String, Integration>,
    pub services: BTreeMap<String, Service>,
    pub legacy_datastores: BTreeSet<String>,
}

Top level of stackless.toml. Unknown top-level sections are rejected (an old binary cannot honor a section it does not know).

Fields

stack: Stack

secrets: SecretsSpec

integrations: BTreeMap<String, Integration>

services: BTreeMap<String, Service>

legacy_datastores: BTreeSet<String>

Names from a stripped legacy [datastores.*] section in an instance snapshot. Empty for fresh files. Lets ${datastores.*.url} validate and resolve from journaled provision checkpoints on resume.

Implementations

impl StackDef

pub fn parse(text: &str) -> Result<Self, DefError>

Parse definition text. Syntax errors and schema mismatches are distinct codes: an agent fixes them differently.

pub fn parse_snapshot(text: &str) -> Result<Self, DefError>

Parse a definition snapshotted into an instance record.

Older snapshots may still contain [datastores.*]. Strip that section (fresh files still reject it via Self::parse) but keep the datastore names and ${datastores.*.url} interpolations so resume can resolve URLs from journaled provision checkpoints.

impl StackDef

pub fn validate_hosts(&self, known_substrates: &[&str]) -> Result<(), DefError>

Validate the whole definition against the rules registered substrates share. Callers pass the names of registered substrates (core knows none by name).

pub fn validate_for_substrate(&self, substrate: &str) -> Result<(), DefError>

up --on <s> fails at validation if any service lacks the config that substrate requires (ARCHITECTURE.md §2).

impl StackDef

pub fn plan(&self) -> Result<Vec<Step>, DefError>

Expand the topological order into lifecycle steps.

Trait Implementations

impl Debug for StackDef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StackDef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.