Module ordering 

The ordering stage: foundation-first arrangement of the focus section.

The measured failure this fixes: the group introducing the abstraction everything else consumes landed 9th of 13 in model order, so the reviewer met consumers before the thing they consume.

It does not compute the dependency graph. artefact::graph builds that from classes, before the model runs, and this stage contracts it onto groups. That split matters: the stage used to union symbols across a whole group before computing a single edge, which threw away every distinction inside a group and let a cycle appear where the classes had none.

Deterministic and model-free: runs unconditionally after grouping.

Functions

apply

Reorder the focus section foundation-first, fill depends_on, role and pivot, order each group’s classes, rewrite rank, regroup the reading plan, and append the order stage.