Context
The final pre-publish notes pass (operator-directed, 2026-07-03): the release cannot run while the iteration banner sits in resources/content/release-notes/v13.1.0.md:7 ("iteration 2 of N — deliberately-early draft… Do not read as final"). Iterations 2 (PR #14530) and 3 (PR #14554, diagram layer) passed review; the remaining gap is cut-prep. Per the release-notes skill §7, banner removal is exactly the final-iteration job — this leaf executes it.
Live latest-open sweep at 2026-07-03T20:52Z: no equivalent (#14552 is the iteration-3 diagram AUTHORING leaf; this is the distinct cut-prep pass). Sequencing: depends on PR #14554 merging first — item 2 below edits the diagrams that PR introduces.
The Problem
Three cut-blockers:
- The iteration banner (line 7) — stale twice over: it blocks the release by design, and it still says "iteration 2 of N" although iteration 3 shipped.
- Both diagrams violate the render bar the substrate itself prescribes:
guide-authoring-bar.md:32 — "flowchart TD, not LR for chains > ~5 nodes — LR lays them left-to-right, GitHub/portal scale-to-fit, and it becomes unreadable." The War Story loop is 6 nodes LR; the Golden Path route is 9 nodes LR (operator-observed: scaled down too much). Reviewer-miss on record: the bar sign-off verified content fidelity node-by-node but skipped the orientation check — the render-verify discipline exists for exactly this.
- The headline stat is a day stale and unstamped: the notes say 688 PRs / 778 issues / 8 epics; the live analyzer (2026-07-03, verified v13.0 cutoff 2026-03-27) reports 702 merged PRs / 794 closed issues / 9 epics closed (
#11318 closed since). Per the #14530 review's requested item, the stat line carries its source + as-of so every future regeneration inherits the discipline.
The Fix
One PR on the flat-root staging file (sync-fenced branch naming):
- Remove the banner blockquote entirely (skill §7 final-iteration action).
- Flip both
flowchart LR → flowchart TD — content identical, orientation only, per the guide-authoring bar.
- Update + source-stamp the stat line and the changelog-shape counts from the live analyzer run (702 / 794 / 9; fix(ai) 143, docs(agentos) 46, feat(agentos) 21).
- Sweep for any other "iteration" references that imply non-final state.
Acceptance Criteria
Out of Scope
- The version bump + publish execution (operator-owned, #14475 /
publish.mjs)
- New content (the bar is passed for the minor-release precedent SET; the Body-chapter/digest/actionability items were calibrated against the v13.0 MAJOR and move to the v14 notes lane)
Related
Related: #14475 (cut leaf — this feeds it) · #14483 (notes epic) · #14552 / PR #14554 (diagram layer — merge dependency) · #14489 / PR #14530 (iteration 2)
Origin Session ID: 8cf234b7-e698-47ca-99e2-bf865196b6aa (continuation 233a6b21)
Retrieval Hint: v13.1 notes cut-prep banner removal TD mermaid orientation stamped counts
Context
The final pre-publish notes pass (operator-directed, 2026-07-03): the release cannot run while the iteration banner sits in
resources/content/release-notes/v13.1.0.md:7("iteration 2 of N — deliberately-early draft… Do not read as final"). Iterations 2 (PR#14530) and 3 (PR#14554, diagram layer) passed review; the remaining gap is cut-prep. Per the release-notes skill §7, banner removal is exactly the final-iteration job — this leaf executes it.Live latest-open sweep at 2026-07-03T20:52Z: no equivalent (
#14552is the iteration-3 diagram AUTHORING leaf; this is the distinct cut-prep pass). Sequencing: depends on PR#14554merging first — item 2 below edits the diagrams that PR introduces.The Problem
Three cut-blockers:
guide-authoring-bar.md:32— "flowchart TD, notLRfor chains > ~5 nodes — LR lays them left-to-right, GitHub/portal scale-to-fit, and it becomes unreadable." The War Story loop is 6 nodes LR; the Golden Path route is 9 nodes LR (operator-observed: scaled down too much). Reviewer-miss on record: the bar sign-off verified content fidelity node-by-node but skipped the orientation check — the render-verify discipline exists for exactly this.#11318closed since). Per the#14530review's requested item, the stat line carries its source + as-of so every future regeneration inherits the discipline.The Fix
One PR on the flat-root staging file (sync-fenced branch naming):
flowchart LR→flowchart TD— content identical, orientation only, per the guide-authoring bar.Acceptance Criteria
flowchart TD; nodes/edges/labels byte-identical otherwiseResolvesthis leaf,Refs#14475 #14483Out of Scope
publish.mjs)Related
Related: #14475 (cut leaf — this feeds it) · #14483 (notes epic) · #14552 / PR
#14554(diagram layer — merge dependency) · #14489 / PR#14530(iteration 2)Origin Session ID: 8cf234b7-e698-47ca-99e2-bf865196b6aa (continuation 233a6b21)
Retrieval Hint:
v13.1 notes cut-prep banner removal TD mermaid orientation stamped counts