Add newly cut minor branch to snapshot build pipeline during minor freeze

[edsavage]

Summary

The minor-freeze automation cuts the release branch and bumps main, but it did not register the new branch in the daily snapshot build pipeline defined in catalog-info.yaml. As a result the newly cut branch got no daily SNAPSHOT builds, and any scheduled/triggered build for it would be blocked by the snapshot pipeline's filter_condition. This was missed for 9.5.

This PR both automates the registration for future freezes and fixes the current gap by adding 9.5.

Changes

• dev-tools/update_catalog_snapshot.py (new): a scoped, comment-preserving text edit (stdlib only — no YAML round-trip, so comments/formatting are preserved) that, for a MAJOR.MINOR branch:
  • adds build.branch == "<branch>" to the snapshot pipeline filter_condition, immediately after main (newest-first ordering);
  • inserts a Daily <branch> schedule (before Daily main) with the next free "half past the hour" cron slot (30 HH * * *), avoiding collisions with existing schedules.
  • Idempotent, and only the snapshot pipeline block is touched (the staging pipeline already matches any MAJOR.MINOR via regex and has no schedules).
• dev-tools/bump_main_minor_freeze.sh (Leg B): invokes the updater so the catalog-info.yaml change lands in the same PR into main as the .backportrc.json update. The PR summary/body now lists the snapshot change.
• catalog-info.yaml: registers the already-cut 9.5 branch (filter + Daily 9.5 @ 30 05 * * *).
• dev-tools/unittest/test_update_catalog_snapshot.py (new): unit tests for filter/schedule insertion, ordering, next-free-hour selection, idempotency, partial-state completion, input validation, section scoping, plus a check that editing the real catalog-info.yaml yields valid YAML with unique cronlines.

Diff to the live file

filter_condition: ... "main" || "9.5" || "9.4" || "9.3" || "8.19" || "7.17"

+ Daily 9.5:
+   branch: '9.5'
+   cronline: 30 05 * * *
+   message: Daily SNAPSHOT build for 9.5

Test plan

• python3 -m pytest dev-tools/unittest/ -q passes (73 passed, 2 git-integration skipped)
• bash -n dev-tools/bump_main_minor_freeze.sh OK
• Editing the real catalog-info.yaml parses as valid YAML; all snapshot cronlines remain unique
• Re-running the updater for 9.5 is a no-op (idempotent)
• Next minor freeze: confirm the Leg B PR into main includes the new Daily <branch> schedule + filter entry

Notes / follow-ups

• Cron slots are assigned as max(existing hour) + 1 at 30 HH. With branches being EOL'd over time this won't realistically exhaust the 0–23 range; the script errors clearly if it ever would, prompting a prune of EOL schedules.
• This does not remove EOL branch schedules — that remains a manual/cleanup decision.

Related

• Same minor-freeze automation as [ML] Automate minor version bump in CI pipeline #3064, [ML] Skip backport for minor-freeze version bump PRs #3070, Fix branchLabelMapping precedence for main override in .backportrc.json #3072, Make minor-freeze version bump idempotent for already-completed bumps #3073.

Made with Cursor

[elasticsearchmachine]

Pinging @elastic/ml-core (Team:ML)

[Copilot]

Pull request overview

Adds automation to ensure newly cut MAJOR.MINOR release branches are registered in the Backstage/Buildkite snapshot pipeline (catalog-info.yaml) during minor freeze, and patches the current gap by registering 9.5. This prevents newly cut branches from being blocked by the snapshot pipeline filter_condition and ensures they receive daily SNAPSHOT builds.

Changes:

• Add dev-tools/update_catalog_snapshot.py to perform a scoped, comment-preserving text edit of the snapshot pipeline’s filter_condition and schedules (idempotent).
• Invoke the updater from dev-tools/bump_main_minor_freeze.sh so the catalog update lands alongside the main bump/backport config changes in Leg B.
• Update catalog-info.yaml to include 9.5 in the snapshot filter and add a Daily 9.5 schedule; add unit tests covering insertion/ordering/idempotency and real-file YAML validity checks.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File	Description
dev-tools/update_catalog_snapshot.py	New updater script to add a release branch to snapshot pipeline filter + daily schedule via comment-preserving text transform.
dev-tools/unittest/test_update_catalog_snapshot.py	New pytest coverage for filter/schedule insertion logic, idempotency, scoping, and real catalog-info.yaml YAML validity/cron uniqueness.
dev-tools/bump_main_minor_freeze.sh	Calls the new updater and includes catalog-info.yaml in the Leg B commit/PR body summary.
catalog-info.yaml	Registers branch 9.5 for snapshot builds (filter condition + Daily 9.5 schedule).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.