Branch Fold Stability

Gallery / Serpentine Layout

A wide side branch (Survey) shares a topo column with the spine and sits one station below its fold threshold. Adding a station inside Survey must not re-grid the downstream Report onto a backward return row: inter-section placement is a function of the DAG, not of intra-section size (issue #1082).

Mermaid source

%%metro title: Branch-fold placement stability
%%metro style: dark
%%metro fold_threshold: 6
%%metro line: survey | Survey | #0570b0
%%metro line: align | Alignment | #2db572

graph LR
    subgraph ingest [Ingest]
        i1[Read]
        i2[Validate]
        i1 -->|survey,align| i2
    end

    subgraph survey [Survey]
        s1[Sketch]
        s2[Profile]
        s3[Classify]
        s4[Summarise]
        s1 -->|survey| s2
        s2 -->|survey| s3
        s3 -->|survey| s4
    end

    subgraph align [Alignment]
        a1[Index]
        a2[Map]
        a1 -->|align| a2
    end

    subgraph report [Report]
        r1[Aggregate]
        r2[Publish]
        r1 -->|align| r2
    end

    i2 -->|survey| s1
    i2 -->|align| a1
    a2 -->|align| r1

CLI command

nf-metro render examples/topologies/branch_fold_stability.mmd -o branch_fold_stability.svg

Rendered map