Struct Topology 

pub struct Topology {
    pub machines: Vec<MachineNode>,
    pub workloads: Vec<WorkloadNode>,
    pub node_losses: Vec<NodeLoss>,
    pub oversubscribed: Vec<Oversubscription>,
}

The declared fleet, read as a graph, plus every verdict derivable from it.

This is the single traversal. The Mermaid render (Topology::to_mermaid) and the capacity report are projections of these fields — a diagram generated by its own second walk of the config would be free to disagree with the analysis printed above it, which is worse than no diagram.

Fields

machines: Vec<MachineNode>

workloads: Vec<WorkloadNode>

node_losses: Vec<NodeLoss>

One entry per declared machine: what is lost when that machine is.

oversubscribed: Vec<Oversubscription>

Machines whose declared [allocatable] does not cover what is projected onto them. Empty is the good case.

Implementations

impl Topology

pub fn to_mermaid(&self) -> String

Render the model as a Mermaid flowchart.

A projection, not a second traversal. Every node and edge below is read off fields analyze already computed, so the picture cannot disagree with the verdicts printed beside it. A diagram generated by its own walk of the config would be free to drift into decoration, which is worse than no diagram — it is the failure mode this method’s shape exists to make impossible.

The edge worth the whole render is -.->|hydrate|: the backup path is the one relationship in this graph that is invisible in the TOML, has no runtime today, and is exactly what decides whether a node loss is an incident or a restore.

pub fn render_node_loss(&self, machine: &str) -> Option<String>

Render the survivability answer for one machine as plain text.

Returns None when no machine by that name is declared — the caller owns the wording of that refusal, since it has the declared list.

pub fn render_capacity(&self) -> String

Render the capacity arithmetic — the whole fleet, oversubscription called out rather than left to the reader to spot.

pub fn render(&self) -> String

Render every machine’s loss, plus the capacity view — the default whole-fleet report.

Trait Implementations

impl Clone for Topology

fn clone(&self) -> Topology

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Topology

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

Formats the value using the given formatter.

impl Serialize for Topology

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

where __S: Serializer,

Serialize this value into the given Serde serializer.