fix(test-insights): stop pinning the Buildkite plugin to its first release

[jd]

The two Buildkite upload snippets hardcode mergifyio/mergify-ci#v1 in their
.astro source. v1 is the oldest of six releases — v1 through v6 are
distinct tags, not a floating major — so every reader who copies one of these
snippets pins the first version ever cut and never receives anything shipped
since.

Nothing else in the docs does this. Every Buildkite page writes
@@BUILDKITE_PLUGIN_VERSION@@, which plugins/remark-buildkite-version.ts
substitutes from src/data/buildkite-plugin-version.json at build time. That
plugin only visits markdown nodes, so the sentinel does nothing inside an
.astro component and these two were left pinning by hand. The fix is the one
the GitHub Actions counterpart already uses: import the data file and
interpolate it, exactly as MergifyCIUploadStepMatrix.astro does with
gha-mergify-ci-version.json.

Bumping v1 to v6 would have recreated the same problem one release later.

This matters now because the commit at the bottom of this stack recommends the
plugin's job_name property again. A reader who copies the matrix snippet and
pins v1 gets a plugin where that property predates the code reading it — the
docs would recommend a knob that is dead in the version the snippet installs.

The non-matrix component has the same pin and is the more widely used of the
two: eleven test-framework recipes render it. Both are fixed here, since it is
one bug with one cause.

Verified on the built output: all 78 rendered occurrences of the plugin
reference now read v6, none read v1, and no template literal leaked into
the HTML. pnpm check 0 errors, pnpm build 384 pages, pnpm test 144
passed, pnpm check:internal-leaks clean.

Refs MRGFY-8720

Depends-On: #12417

[jd]

This pull request is part of a Mergify stack:

#	Pull Request	Link
1	fix(test-insights): point the framework recipes at a dashboard page that exists	#12417
2	fix(test-insights): stop pinning the Buildkite plugin to its first release	#12426	👈

[mergify]

Merge Protections

🟢 All 7 merge protections satisfied — ready to merge.

Show 7 satisfied protections

🟢 ⛓️ Depends-On Requirements

Requirement based on the presence of Depends-On in the body of the pull request

• depends-on = Mergifyio/docs#12417 [⛓️ fix(test-insights): make the closing CTA one partial, not eleven copies #12417]

🟢 🤖 Continuous Integration

• all of:
  • check-success = build
  • check-success = lint
  • check-success = test
  • any of:
    • check-success = test-broken-links
    • label = ignore-broken-links
  • any of:
    • check-success=Cloudflare Pages
    • -head-repo-full-name~=^Mergifyio/

🟢 👀 Review Requirements

• any of:
  • #approved-reviews-by >= 2
  • author = dependabot[bot]
  • all of:
    • author = mergify-ci-bot
    • -head ~= ^docs-agent/

🟢 Enforce conventional commit

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

• title ~= ^(fix|feat|internal|docs|style|refactor|perf|test|build|ci|chore|revert|ui)(?:\(.+\))?!?:

🟢 🔎 Reviews

• #changes-requested-reviews-by = 0
• #review-requested = 0
• #review-threads-unresolved = 0

🟢 📕 PR description

• body ~= (?ms:.{48,})

🟢 🚦 Auto-queue

When all merge protections are satisfied, this pull request will be queued automatically.

[Copilot]

Pull request overview

This PR fixes the Buildkite plugin version used in the Test Insights upload snippets by removing the hardcoded #v1 pin and instead sourcing the version from src/data/buildkite-plugin-version.json, matching how markdown snippets already get the version substituted at build time.

Changes:

• Import ~/data/buildkite-plugin-version.json in the two affected .astro components.
• Interpolate buildkitePluginVersion.version into the Buildkite plugin reference so the rendered docs track the configured version (currently v6).

Reviewed changes

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

File	Description
src/components/BuildkiteCIUploadStepMatrix.astro	Replaces hardcoded #v1 with an interpolated version from the shared JSON data source.
src/components/BuildkiteCIUploadStep.astro	Replaces hardcoded #v1 with an interpolated version from the shared JSON data source.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[jd]

Revision history

#	Type	Changes	Reason	Date
1	initial	479ee49		2026-08-21 15:09 UTC
2	rebase	479ee49 → 86c9072 (rebase only)		2026-08-21 15:09 UTC
3	rebase	86c9072 → f03d9da (rebase only)	restacked onto the rebased base; content unchanged	2026-08-24 08:33 UTC

[jd]

Restacked only — 479ee49 → 86c9072 (compare). The content of this commit is unchanged; it moved because the base #12417 was rebased onto main.

[jd]

Restacked only — 86c9072 → f03d9da (compare). The content of this commit is unchanged; it moved because the base (#12417) was rebased onto main after #12490 landed.

[mergify]

Merge Queue Status

• ✅ Entered queue — 2026-08-24 12:27 UTC · Rule: default · triggered by merge protections
• ✅ Checks passed · on draft merge queue: checking main (9f4beac) and #12426 together #12504
• ✅ Merged — 2026-08-24 12:30 UTC · at f03d9dabd93e76ae52e7faf4a3ea6ca1a30e3562 · squash

This pull request spent 3 minutes 21 seconds in the queue, including 2 minutes 45 seconds running CI.

Required conditions to merge

• depends-on = Mergifyio/docs#12417 [⛓️ fix(test-insights): make the closing CTA one partial, not eleven copies #12417]
  • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
• github-review-approved [🛡 GitHub repository ruleset rule Require pull request for default branch]
  • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
• schedule=Mon-Fri 09:00-17:30[Europe/Paris]
• all of [🛡 Merge Protections rule Enforce conventional commit]:
  • title ~= ^(fix|feat|internal|docs|style|refactor|perf|test|build|ci|chore|revert|ui)(?:\(.+\))?!?:
    • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
• all of [🛡 Merge Protections rule 👀 Review Requirements]:
  • any of:
    • #approved-reviews-by >= 2
      • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
    • author = dependabot[bot]
      • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
    • all of:
      • author = mergify-ci-bot
        • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
      • -head ~= ^docs-agent/
        • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
• all of [🛡 Merge Protections rule 📕 PR description]:
  • body ~= (?ms:.{48,})
    • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
• all of [🛡 Merge Protections rule 🔎 Reviews]:
  • #changes-requested-reviews-by = 0
    • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
  • #review-requested = 0
    • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
  • #review-threads-unresolved = 0
    • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
• all of [🛡 Merge Protections rule 🤖 Continuous Integration]:
  • all of:
    • check-success = build
    • check-success = lint
    • check-success = test
    • any of:
      • check-success = test-broken-links
      • label = ignore-broken-links
        • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426
    • any of:
      • check-success=Cloudflare Pages
      • -head-repo-full-name~=^Mergifyio/
        • fix(test-insights): stop pinning the Buildkite plugin to its first release #12426