Skip to content

Add changelog.json entries for 2026.4.4 and 2026.4.5 - #4003

Open
AryanKansagara wants to merge 1 commit into
Shopify:mainfrom
AryanKansagara:docs-changelog-2026-4-4-and-4-5
Open

Add changelog.json entries for 2026.4.4 and 2026.4.5#4003
AryanKansagara wants to merge 1 commit into
Shopify:mainfrom
AryanKansagara:docs-changelog-2026-4-4-and-4-5

Conversation

@AryanKansagara

@AryanKansagara AryanKansagara commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

WHY are these changes introduced?

Fixes #4002

@shopify/hydrogen 2026.4.4 and 2026.4.5 are published to npm but absent from docs/changelog.json. Since getAvailableUpgrades builds its list purely by filtering releases from that file, h2 upgrade currently reports "up to date" to merchants on 2026.4.3 — including those missing the two customer-account authentication fixes in 2026.4.5.

WHAT is this pull request doing?

Adds the two missing release entries. The diff is purely additive — 67 insertions, 0 deletions, no reformatting of existing entries.

Content is derived from the release commits and the changesets shipped, not written from scratch:

Version Release commit PR Date
2026.4.5 2a2738ba #3912 2026-08-14
2026.4.4 b4df0552 #3791 2026-06-15

2026.4.5fixes #3856 (OAuth state mismatch recovery) and #3916 (token refresh resilience) from packages/hydrogen/CHANGELOG.md; features #3852 (~ alias) and #3887 (AI Toolkit) from the skeleton, which moved 2026.4.4 → 2026.4.6 across this release window.

2026.4.4fix #3790 (PerfKit sampling rate 100 → 10).

Two things worth flagging for the reviewer:

  1. PR [ci] release 2026.4.5 #3844 is titled [ci] release 2026.4.5 but did not bump @shopify/hydrogen — it stayed at 2026.4.4 in that commit, and the real bump landed in [ci] release 2026.4.5 #3912. I attributed 2026.4.5 to [ci] release 2026.4.5 #3912 on the basis of the actual packages/hydrogen/package.json version at each commit rather than the PR titles.
  2. I included the two skeleton-only changes as features on 2026.4.5. Precedent supports this (2026.4.3 lists fix(skeleton): include line item children recursively #3753, also a new-projects-only skeleton change), but they affect scaffolding rather than an upgrading merchant's runtime — easy to drop if you'd rather keep the entry to runtime changes only.

dependencies lists only @shopify/hydrogen for both, since no skeleton dependency changed in either release (react-router stayed 7.16.0, @shopify/cli stayed 3.93.2). This matches the 2026.4.1 entry, and the CLI composes a cumulativeRelease across intermediate versions, so unchanged deps do not need restating.

HOW to test your changes?

Confirm the gap and the fix, by simulating the CLI's own upgrade filter against the file before and after:

node -e "
const semver=require('semver');
const before=JSON.parse(require('child_process').execSync('git show main:docs/changelog.json'));
const after=JSON.parse(require('fs').readFileSync('docs/changelog.json','utf8'));
const f=(j,cur)=>j.releases.filter(r=>semver.gt(r.version,semver.coerce(cur).version)).map(r=>r.version);
for (const v of ['2026.4.3','2026.4.4'])
  console.log('on '+v+':  before='+(f(before,v).join(',')||'none')+'   after='+(f(after,v).join(',')||'none'));
"
on 2026.4.3:  before=none   after=2026.4.5,2026.4.4
on 2026.4.4:  before=none   after=2026.4.5

Schema validation — the existing suite covers this file:

pnpm --dir packages/cli exec vitest run src/commands/hydrogen/changelog-schema.test.ts
# 9 passed (9)

Cross-check the entries against the source of truth:

# the changesets these releases shipped
awk '/^## 2026\.4\.5/,/^## 2026\.4\.3/' packages/hydrogen/CHANGELOG.md

# the hydrogen version at each release commit
git show b4df0552:packages/hydrogen/package.json | grep '"version"'   # 2026.4.4
git show 2a2738ba:packages/hydrogen/package.json | grep '"version"'   # 2026.4.5

Note

If you run the schema test on a checkout whose path contains a space, the is valid JSON and matches getChangelog() output case fails — isHydrogenMonorepo is false there, so getChangelog() fetches the remote changelog and compares it against your local edit. That is #3988 (fix in #3989), not a problem with this change; I verified all 9 tests pass with that fix applied.

Post-merge steps

The updated file is served via https://hydrogen.shopify.dev/changelog.json, which proxies the raw content of docs/changelog.json on main. No further action beyond merging.

Checklist

  • I've read the Contributing Guidelines
  • I've considered possible cross-platform impacts (Mac, Linux, Windows) — data-only change, none
  • I've added a changeset if this PR contains user-facing or functional changes — not applicable; no packages/*/src or package.json changes, and this documents releases that already shipped
  • I've added tests to cover my changes — existing changelog-schema.test.ts covers this file; verified passing
  • I've added or updated the documentation — this PR is the documentation fix

Both versions are published to npm but were missing from
docs/changelog.json, which `hydrogen upgrade` uses as its only source
of available releases. Merchants on 2026.4.3 were told they were up to
date while two patch releases were available.

Entries are derived from the release commits b4df055 (Shopify#3791) and
2a2738b (Shopify#3912) and the changesets they shipped.
@AryanKansagara
AryanKansagara requested a review from a team as a code owner September 9, 2026 06:23
@AryanKansagara

Copy link
Copy Markdown
Contributor Author

TL;DR

@shopify/hydrogen 2026.4.4 and 2026.4.5 are published to npm but missing from
docs/changelog.json, which is the only source h2 upgrade reads. A merchant on
2026.4.3 is currently told they're up to date while both sit on npm.

This adds the two entries. +67/-0, no changes to existing ones.

Simulating the CLI's upgrade filter before and after:

on 2026.4.3:  before=none   after=2026.4.5,2026.4.4
on 2026.4.4:  before=none   after=2026.4.5

Two calls worth a second opinion:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs/changelog.json is missing 2026.4.4 and 2026.4.5, so h2 upgrade cannot offer them

1 participant