Module order

Module order 

Source
Expand description

2026-09-26: The recommended merge order, the mermaid gitGraph that draws it (main as a line, each PR a branch merged back in order), and the “Recommended next steps” list.

Owner: bench gate. Invariants:

  • The chart and every list of PR numbers built by cap_prs show at most CHART_PR_BOUND PRs, and say how many more there are.
  • merge_order ranks only unmerged, non-draft PRs whose changed files were read.

Constants§

CHART_PR_BOUND
2026-09-26: The most PRs the chart draws and cap_prs lists.

Functions§

cap_prs
2026-09-26: #1, #2 … +k more: at most CHART_PR_BOUND numbers, then the count of the rest.
merge_order
2026-09-26: The recommended merge order over the orderable PRs, sorted by, in turn:
render_next_steps
2026-09-26: “Recommended next steps”: the head of merge_order, the unmerged PRs whose changed files were unreadable, unmerged PRs that contend with a merged one, and merged PRs with promotion debt. Its inputs are the changed paths and the draft and merged flags; the closing line names what they cannot show.
render_order_chart
2026-09-26: The chart: main as a line, each ordered PR as a branch off it, merged back in order, for the first CHART_PR_BOUND PRs. The caption says “Showing N of M” and lists the rest through cap_prs. With nothing to order, a sentence replaces the chart.