Skip to content

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together - #3090

Open
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga
Open

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together#3090
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga

Conversation

@VaguelySerious

@VaguelySeriousVaguelySerious commented Jul 24, 2026

Copy link
Copy Markdown
Member

Prep for the 5.0.0 GA release. Draft on purpose — merging this arms the GA publish.

  1. Exits changesets pre-release mode (.changeset/pre.json"mode": "exit"). The next Release run on main opens a plain "Version Packages" PR; merging that one publishes 5.0.0 to the latest dist-tag.
  2. Adds @workflow/world-vercel to the fixed group with workflow and @workflow/core. @workflow/world-vercel does not depend on @workflow/core, so nothing kept them aligned before — the Vercel adapter drifted to 5.0.0-beta.32 while core was at 5.0.0-beta.36. From 5.0.0 on, the adapter version is the SDK version.
  3. Derives the GitHub Release flags from the published version, not the branch.main was hardcoded to --prerelease=true --latest=false, which would have marked the 5.0.0 release as a prerelease. Now any version with a prerelease identifier is a prerelease on any branch, and the "Latest" marker follows the GA line on main.
  4. Updates the release-strategy section of AGENTS.md to match.

Verification

Dry-ran the whole thing in a scratch worktree off origin/main (changeset pre exit + changeset version over all 439 pending changesets):

  • All 26 public packages land on exactly 5.0.0 — including @workflow/ai, @workflow/serde, @workflow/utils, and the worlds, which were on trailing beta numbers. The check-release-major.js guard (RELEASE_VERSION: 5) passes.
  • Fixed group works: after that run, a changeset touching only @workflow/core bumps @workflow/core, workflowand@workflow/world-vercel to 5.0.1 together.
  • Release-flag logic checked against workflow@5.0.0 on main (--prerelease=false --latest), workflow@4.2.1 on stable (--prerelease=false --latest=false), and workflow@5.1.0-beta.1 / workflow@6.0.0-rc.2 on main (--prerelease=true --latest=false).

Required companion change on stable

stable is not in pre mode and no package sets publishConfig.tag, so once main leaves pre mode both branches publish to latest — the next 4.x patch would move latest back to 4.x. Companion PR against stable pins ci:publish to changeset publish --tag previous (and mirrors the release-flag change); it needs to land before or alongside this one. The tag is previous rather than v4 because npm rejects tag names that parse as a semver range.

Trade-off worth knowing

The fixed group means a @workflow/world-vercel-only fix now also republishes workflow and @workflow/core (and their dependents), and a core-only fix produces an empty ## X.Y.Z section in the world-vercel changelog. That's the cost of guaranteed alignment.

Take `main` out of changesets pre-release mode so the next "Version
Packages" PR publishes 5.0.0 to the `latest` dist-tag instead of another
`5.0.0-beta.N`.
Also add `@workflow/world-vercel` to the `workflow` / `@workflow/core`
fixed group, so the Vercel adapter carries the same version as the SDK
from 5.0.0 onward, and derive the GitHub Release prerelease/latest flags
from the published version rather than the branch name.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

@changeset-bot

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: f051d75

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 46 packages
NameType
@workflow/example-astroPatch
@workflow/example-appPatch
@workflow/example-expressPatch
@workflow/example-fastifyPatch
@workflow/example-honoPatch
@workflow/example-nestPatch
nextjs-turbopackPatch
nextjs-webpackPatch
@workflow/example-nitro-v2Patch
@workflow/example-nitroPatch
@workflow/example-nuxtPatch
@workflow/example-sveltekitPatch
workflow-sdk-compiler-playgroundPatch
@workflow/example-tanstack-startPatch
@workflow/example-vitePatch
@workflow/vitest-workbenchPatch
@workflow/aiPatch
@workflow/astroPatch
@workflow/buildersPatch
@workflow/cliPatch
@workflow/corePatch
@workflow/docs-typecheckPatch
@workflow/errorsPatch
@workflow/nestPatch
@workflow/nextPatch
@workflow/nitroPatch
@workflow/nuxtPatch
@workflow/rollupPatch
@workflow/serdePatch
@workflow/sveltekitPatch
@workflow/swc-pluginPatch
@workflow/tsconfigPatch
@workflow/typescript-pluginPatch
@workflow/utilsPatch
@workflow/vitePatch
@workflow/vitestPatch
@workflow/web-sharedPatch
@workflow/webPatch
workflowPatch
@workflow/world-localPatch
@workflow/world-postgresPatch
@workflow/world-testingPatch
@workflow/world-vercelPatch
@workflow/worldPatch
docsPatch
tarballsPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

E2E Test Summary

Summary
PassedFailedSkippedTotal
✅ ▲ Vercel Production145502391694
✅ 💻 Local Development162102271848
✅ 📦 Local Production162102271848
✅ 🐘 Local Postgres162102271848
✅ 🪟 Windows15400154
✅ 📋 Other102002121232
✅ vercel-multi-region270027
Total7519011328651
Details by Category

✅ ▲ Vercel Production

AppPassedFailedSkipped
✅ astro126028
✅ example126028
✅ express126028
✅ fastify126028
✅ hono126028
✅ nextjs-turbopack15103
✅ nextjs-webpack15103
✅ nitro126028
✅ nuxt126028
✅ sveltekit14509
✅ vite126028

✅ 💻 Local Development

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 📦 Local Production

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🐘 Local Postgres

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🪟 Windows

AppPassedFailedSkipped
✅ nextjs-turbopack15400

✅ 📋 Other

AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable128026
✅ e2e-local-dev-tanstack-start-128026
✅ e2e-local-postgres-nest-stable128026
✅ e2e-local-postgres-tanstack-start-128026
✅ e2e-local-prod-nest-stable128026
✅ e2e-local-prod-tanstack-start-128026
✅ e2e-vercel-prod-nest126028
✅ e2e-vercel-prod-tanstack-start126028

✅ vercel-multi-region

AppPassedFailedSkipped
✅ nextjs-turbopack2700

📋 View full workflow run

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit f051d75 · Fri, 24 Jul 2026 20:19:34 GMT · run logs

Backend: vercel · app: nextjs-turbopack

MetricScenarioBest (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep242 (-66%) 💚1342 🔴 (+28%) 🔻1401 🔴 (+31%) 🔻1466 🔴 (+1.8%)30
TTFSstream175 (-82%) 💚1343 🔴 (+31%) 🔻1361 🔴 (+31%) 🔻1594 🔴 (+52%) 🔻30
TTFShook + stream463 (-61%) 💚1541 🔴 (+17%) 🔻1610 🔴 (+16%) 🔻1790 🔴 (+7.1%)30
STSO1020 steps (1-20)189 (+17%) 🔻299 🔴 (+20%) 🔻332 🔴 (+10%)395 🔴 (+30%) 🔻19
STSO1020 steps (101-120)211 (+14%)309 🔴 (+12%)610 🔴 (+87%) 🔻2294 🔴 (+546%) 🔻19
STSO1020 steps (1001-1020)513 (+13%)603 🔴 (+8.8%)624 🔴 (+4.3%)676 🔴 (-18%) 💚19
WO1020 steps416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)1
SLstream latency103 (+37%) 🔻165 🔴 (+36%) 🔻191 🔴 (+38%) 🔻380 🔴 (-55%) 💚30
SOstream overhead (text)124 (+28%) 🔻290 🔴 (+85%) 🔻413 (+112%) 🔻563 (+126%) 🔻30
SOstream overhead (structured)118 (+20%) 🔻225 (+31%) 🔻292 (+18%) 🔻497 (+78%) 🔻30
ℹ️ Metric definitions & methodology

Best/P75/P90/P99 deltas compare against the most recent benchmark run on main at the time of this run. 🔻 flags a delta worse than +15%, 💚 one better than −15%.

Metrics — TTFS: time to first step body (in-deployment start() → first step body, deployment clocks) · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (whole-run time outside step bodies, in-deployment anchored) · SL: stream latency (in-deployment write → read propagation, readAt - writtenAt) · SO: stream overhead (end-to-end write+consume time beyond the modelled generation window)

Scenarios — step: one trivial no-op step, no stream; no hooks, so the run stays in turbo mode (in-process fast path) · stream: one streaming step; no hooks, so the run stays in turbo mode (in-process fast path) · hook + stream: registers a hook before one step, which exits turbo mode (dispatch path) · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges, and WO is the whole-run overhead outside step bodies · stream latency: parallel reader/writer steps on a dedicated stream; SL is the in-deployment write->read propagation (readAt - writtenAt) · stream overhead (text): writer streams 300 variable-length text token deltas paced at 100/s for 3s (a haiku-size LLM's token throughput) while a parallel reader drains the whole stream; SO is the end-to-end write+consume time beyond the 3s generation window (overhead/backpressure) · stream overhead (structured): same workload as stream overhead (text), but each delta is an AI-SDK-style structured object ({ type: 'text-delta', id, text }) instead of a raw string, so the SO gap vs the text scenario is the added serialization cost

🔴 marks a percentile over its target (within target is left unmarked). Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · SO 250/500/1000 · STSO (1-20) 20/30/60 · STSO (101-120) 30/45/90 · STSO (1001-1020) 40/60/120

All metrics are measured from deployment-side timestamps only. Runs are triggered by an in-deployment route that stamps the anchor (clientStart) right before start(), so the CI runner’s request and its path through api.vercel.com sit outside every measured window. TTFS = in-deployment start() → first step body (turbo uses the in-process fast path, non-turbo the dispatch path), and includes the VQS dispatch hop plus any /flow cold start. STSO/WO are measured between step bodies on the deployment. SL is measured inside the workflow (parallel reader/writer steps), so it no longer includes the api.vercel.com read path.

Cold starts are kept in the numbers on purpose — they are part of real bursty-workload latency. The workbench deployment cold-starts the /flow invocation for a large fraction of runs, inflating P75+; the Best column shows the fastest (warm-start) sample for comparison.

@VaguelySeriousVaguelySerious changed the title [release] Exit changeset pre mode for 5.0.0 GA[release] Exit changeset pre mode for v5, tie core and world-vercel versions togetherJul 24, 2026
@VaguelySerious
VaguelySerious marked this pull request as ready for review July 27, 2026 18:39
@VaguelySerious
VaguelySerious requested review from a team and ijjk as code ownersJuly 27, 2026 18:39
Sign up for freeto 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.

1 participant

@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
[release] Exit changeset pre mode for v5, tie core and world-vercel versions together by VaguelySerious · Pull Request #3090 · vercel/workflow · GitHub
Skip to content

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together - #3090

Open
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga
Open

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together#3090
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga

Conversation

@VaguelySerious

@VaguelySeriousVaguelySerious commented Jul 24, 2026

Copy link
Copy Markdown
Member

Prep for the 5.0.0 GA release. Draft on purpose — merging this arms the GA publish.

  1. Exits changesets pre-release mode (.changeset/pre.json"mode": "exit"). The next Release run on main opens a plain "Version Packages" PR; merging that one publishes 5.0.0 to the latest dist-tag.
  2. Adds @workflow/world-vercel to the fixed group with workflow and @workflow/core. @workflow/world-vercel does not depend on @workflow/core, so nothing kept them aligned before — the Vercel adapter drifted to 5.0.0-beta.32 while core was at 5.0.0-beta.36. From 5.0.0 on, the adapter version is the SDK version.
  3. Derives the GitHub Release flags from the published version, not the branch.main was hardcoded to --prerelease=true --latest=false, which would have marked the 5.0.0 release as a prerelease. Now any version with a prerelease identifier is a prerelease on any branch, and the "Latest" marker follows the GA line on main.
  4. Updates the release-strategy section of AGENTS.md to match.

Verification

Dry-ran the whole thing in a scratch worktree off origin/main (changeset pre exit + changeset version over all 439 pending changesets):

  • All 26 public packages land on exactly 5.0.0 — including @workflow/ai, @workflow/serde, @workflow/utils, and the worlds, which were on trailing beta numbers. The check-release-major.js guard (RELEASE_VERSION: 5) passes.
  • Fixed group works: after that run, a changeset touching only @workflow/core bumps @workflow/core, workflowand@workflow/world-vercel to 5.0.1 together.
  • Release-flag logic checked against workflow@5.0.0 on main (--prerelease=false --latest), workflow@4.2.1 on stable (--prerelease=false --latest=false), and workflow@5.1.0-beta.1 / workflow@6.0.0-rc.2 on main (--prerelease=true --latest=false).

Required companion change on stable

stable is not in pre mode and no package sets publishConfig.tag, so once main leaves pre mode both branches publish to latest — the next 4.x patch would move latest back to 4.x. Companion PR against stable pins ci:publish to changeset publish --tag previous (and mirrors the release-flag change); it needs to land before or alongside this one. The tag is previous rather than v4 because npm rejects tag names that parse as a semver range.

Trade-off worth knowing

The fixed group means a @workflow/world-vercel-only fix now also republishes workflow and @workflow/core (and their dependents), and a core-only fix produces an empty ## X.Y.Z section in the world-vercel changelog. That's the cost of guaranteed alignment.

Take `main` out of changesets pre-release mode so the next "Version
Packages" PR publishes 5.0.0 to the `latest` dist-tag instead of another
`5.0.0-beta.N`.
Also add `@workflow/world-vercel` to the `workflow` / `@workflow/core`
fixed group, so the Vercel adapter carries the same version as the SDK
from 5.0.0 onward, and derive the GitHub Release prerelease/latest flags
from the published version rather than the branch name.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

@changeset-bot

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: f051d75

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 46 packages
NameType
@workflow/example-astroPatch
@workflow/example-appPatch
@workflow/example-expressPatch
@workflow/example-fastifyPatch
@workflow/example-honoPatch
@workflow/example-nestPatch
nextjs-turbopackPatch
nextjs-webpackPatch
@workflow/example-nitro-v2Patch
@workflow/example-nitroPatch
@workflow/example-nuxtPatch
@workflow/example-sveltekitPatch
workflow-sdk-compiler-playgroundPatch
@workflow/example-tanstack-startPatch
@workflow/example-vitePatch
@workflow/vitest-workbenchPatch
@workflow/aiPatch
@workflow/astroPatch
@workflow/buildersPatch
@workflow/cliPatch
@workflow/corePatch
@workflow/docs-typecheckPatch
@workflow/errorsPatch
@workflow/nestPatch
@workflow/nextPatch
@workflow/nitroPatch
@workflow/nuxtPatch
@workflow/rollupPatch
@workflow/serdePatch
@workflow/sveltekitPatch
@workflow/swc-pluginPatch
@workflow/tsconfigPatch
@workflow/typescript-pluginPatch
@workflow/utilsPatch
@workflow/vitePatch
@workflow/vitestPatch
@workflow/web-sharedPatch
@workflow/webPatch
workflowPatch
@workflow/world-localPatch
@workflow/world-postgresPatch
@workflow/world-testingPatch
@workflow/world-vercelPatch
@workflow/worldPatch
docsPatch
tarballsPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

E2E Test Summary

Summary
PassedFailedSkippedTotal
✅ ▲ Vercel Production145502391694
✅ 💻 Local Development162102271848
✅ 📦 Local Production162102271848
✅ 🐘 Local Postgres162102271848
✅ 🪟 Windows15400154
✅ 📋 Other102002121232
✅ vercel-multi-region270027
Total7519011328651
Details by Category

✅ ▲ Vercel Production

AppPassedFailedSkipped
✅ astro126028
✅ example126028
✅ express126028
✅ fastify126028
✅ hono126028
✅ nextjs-turbopack15103
✅ nextjs-webpack15103
✅ nitro126028
✅ nuxt126028
✅ sveltekit14509
✅ vite126028

✅ 💻 Local Development

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 📦 Local Production

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🐘 Local Postgres

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🪟 Windows

AppPassedFailedSkipped
✅ nextjs-turbopack15400

✅ 📋 Other

AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable128026
✅ e2e-local-dev-tanstack-start-128026
✅ e2e-local-postgres-nest-stable128026
✅ e2e-local-postgres-tanstack-start-128026
✅ e2e-local-prod-nest-stable128026
✅ e2e-local-prod-tanstack-start-128026
✅ e2e-vercel-prod-nest126028
✅ e2e-vercel-prod-tanstack-start126028

✅ vercel-multi-region

AppPassedFailedSkipped
✅ nextjs-turbopack2700

📋 View full workflow run

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit f051d75 · Fri, 24 Jul 2026 20:19:34 GMT · run logs

Backend: vercel · app: nextjs-turbopack

MetricScenarioBest (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep242 (-66%) 💚1342 🔴 (+28%) 🔻1401 🔴 (+31%) 🔻1466 🔴 (+1.8%)30
TTFSstream175 (-82%) 💚1343 🔴 (+31%) 🔻1361 🔴 (+31%) 🔻1594 🔴 (+52%) 🔻30
TTFShook + stream463 (-61%) 💚1541 🔴 (+17%) 🔻1610 🔴 (+16%) 🔻1790 🔴 (+7.1%)30
STSO1020 steps (1-20)189 (+17%) 🔻299 🔴 (+20%) 🔻332 🔴 (+10%)395 🔴 (+30%) 🔻19
STSO1020 steps (101-120)211 (+14%)309 🔴 (+12%)610 🔴 (+87%) 🔻2294 🔴 (+546%) 🔻19
STSO1020 steps (1001-1020)513 (+13%)603 🔴 (+8.8%)624 🔴 (+4.3%)676 🔴 (-18%) 💚19
WO1020 steps416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)1
SLstream latency103 (+37%) 🔻165 🔴 (+36%) 🔻191 🔴 (+38%) 🔻380 🔴 (-55%) 💚30
SOstream overhead (text)124 (+28%) 🔻290 🔴 (+85%) 🔻413 (+112%) 🔻563 (+126%) 🔻30
SOstream overhead (structured)118 (+20%) 🔻225 (+31%) 🔻292 (+18%) 🔻497 (+78%) 🔻30
ℹ️ Metric definitions & methodology

Best/P75/P90/P99 deltas compare against the most recent benchmark run on main at the time of this run. 🔻 flags a delta worse than +15%, 💚 one better than −15%.

Metrics — TTFS: time to first step body (in-deployment start() → first step body, deployment clocks) · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (whole-run time outside step bodies, in-deployment anchored) · SL: stream latency (in-deployment write → read propagation, readAt - writtenAt) · SO: stream overhead (end-to-end write+consume time beyond the modelled generation window)

Scenarios — step: one trivial no-op step, no stream; no hooks, so the run stays in turbo mode (in-process fast path) · stream: one streaming step; no hooks, so the run stays in turbo mode (in-process fast path) · hook + stream: registers a hook before one step, which exits turbo mode (dispatch path) · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges, and WO is the whole-run overhead outside step bodies · stream latency: parallel reader/writer steps on a dedicated stream; SL is the in-deployment write->read propagation (readAt - writtenAt) · stream overhead (text): writer streams 300 variable-length text token deltas paced at 100/s for 3s (a haiku-size LLM's token throughput) while a parallel reader drains the whole stream; SO is the end-to-end write+consume time beyond the 3s generation window (overhead/backpressure) · stream overhead (structured): same workload as stream overhead (text), but each delta is an AI-SDK-style structured object ({ type: 'text-delta', id, text }) instead of a raw string, so the SO gap vs the text scenario is the added serialization cost

🔴 marks a percentile over its target (within target is left unmarked). Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · SO 250/500/1000 · STSO (1-20) 20/30/60 · STSO (101-120) 30/45/90 · STSO (1001-1020) 40/60/120

All metrics are measured from deployment-side timestamps only. Runs are triggered by an in-deployment route that stamps the anchor (clientStart) right before start(), so the CI runner’s request and its path through api.vercel.com sit outside every measured window. TTFS = in-deployment start() → first step body (turbo uses the in-process fast path, non-turbo the dispatch path), and includes the VQS dispatch hop plus any /flow cold start. STSO/WO are measured between step bodies on the deployment. SL is measured inside the workflow (parallel reader/writer steps), so it no longer includes the api.vercel.com read path.

Cold starts are kept in the numbers on purpose — they are part of real bursty-workload latency. The workbench deployment cold-starts the /flow invocation for a large fraction of runs, inflating P75+; the Best column shows the fastest (warm-start) sample for comparison.

@VaguelySeriousVaguelySerious changed the title [release] Exit changeset pre mode for 5.0.0 GA[release] Exit changeset pre mode for v5, tie core and world-vercel versions togetherJul 24, 2026
@VaguelySerious
VaguelySerious marked this pull request as ready for review July 27, 2026 18:39
@VaguelySerious
VaguelySerious requested review from a team and ijjk as code ownersJuly 27, 2026 18:39
Sign up for freeto 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.

1 participant

@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [release] Exit changeset pre mode for v5, tie core and world-vercel versions together by VaguelySerious · Pull Request #3090 · vercel/workflow · GitHub
Skip to content

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together - #3090

Open
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga
Open

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together#3090
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga

Conversation

@VaguelySerious

@VaguelySeriousVaguelySerious commented Jul 24, 2026

Copy link
Copy Markdown
Member

Prep for the 5.0.0 GA release. Draft on purpose — merging this arms the GA publish.

  1. Exits changesets pre-release mode (.changeset/pre.json"mode": "exit"). The next Release run on main opens a plain "Version Packages" PR; merging that one publishes 5.0.0 to the latest dist-tag.
  2. Adds @workflow/world-vercel to the fixed group with workflow and @workflow/core. @workflow/world-vercel does not depend on @workflow/core, so nothing kept them aligned before — the Vercel adapter drifted to 5.0.0-beta.32 while core was at 5.0.0-beta.36. From 5.0.0 on, the adapter version is the SDK version.
  3. Derives the GitHub Release flags from the published version, not the branch.main was hardcoded to --prerelease=true --latest=false, which would have marked the 5.0.0 release as a prerelease. Now any version with a prerelease identifier is a prerelease on any branch, and the "Latest" marker follows the GA line on main.
  4. Updates the release-strategy section of AGENTS.md to match.

Verification

Dry-ran the whole thing in a scratch worktree off origin/main (changeset pre exit + changeset version over all 439 pending changesets):

  • All 26 public packages land on exactly 5.0.0 — including @workflow/ai, @workflow/serde, @workflow/utils, and the worlds, which were on trailing beta numbers. The check-release-major.js guard (RELEASE_VERSION: 5) passes.
  • Fixed group works: after that run, a changeset touching only @workflow/core bumps @workflow/core, workflowand@workflow/world-vercel to 5.0.1 together.
  • Release-flag logic checked against workflow@5.0.0 on main (--prerelease=false --latest), workflow@4.2.1 on stable (--prerelease=false --latest=false), and workflow@5.1.0-beta.1 / workflow@6.0.0-rc.2 on main (--prerelease=true --latest=false).

Required companion change on stable

stable is not in pre mode and no package sets publishConfig.tag, so once main leaves pre mode both branches publish to latest — the next 4.x patch would move latest back to 4.x. Companion PR against stable pins ci:publish to changeset publish --tag previous (and mirrors the release-flag change); it needs to land before or alongside this one. The tag is previous rather than v4 because npm rejects tag names that parse as a semver range.

Trade-off worth knowing

The fixed group means a @workflow/world-vercel-only fix now also republishes workflow and @workflow/core (and their dependents), and a core-only fix produces an empty ## X.Y.Z section in the world-vercel changelog. That's the cost of guaranteed alignment.

Take `main` out of changesets pre-release mode so the next "Version
Packages" PR publishes 5.0.0 to the `latest` dist-tag instead of another
`5.0.0-beta.N`.
Also add `@workflow/world-vercel` to the `workflow` / `@workflow/core`
fixed group, so the Vercel adapter carries the same version as the SDK
from 5.0.0 onward, and derive the GitHub Release prerelease/latest flags
from the published version rather than the branch name.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

@changeset-bot

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: f051d75

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 46 packages
NameType
@workflow/example-astroPatch
@workflow/example-appPatch
@workflow/example-expressPatch
@workflow/example-fastifyPatch
@workflow/example-honoPatch
@workflow/example-nestPatch
nextjs-turbopackPatch
nextjs-webpackPatch
@workflow/example-nitro-v2Patch
@workflow/example-nitroPatch
@workflow/example-nuxtPatch
@workflow/example-sveltekitPatch
workflow-sdk-compiler-playgroundPatch
@workflow/example-tanstack-startPatch
@workflow/example-vitePatch
@workflow/vitest-workbenchPatch
@workflow/aiPatch
@workflow/astroPatch
@workflow/buildersPatch
@workflow/cliPatch
@workflow/corePatch
@workflow/docs-typecheckPatch
@workflow/errorsPatch
@workflow/nestPatch
@workflow/nextPatch
@workflow/nitroPatch
@workflow/nuxtPatch
@workflow/rollupPatch
@workflow/serdePatch
@workflow/sveltekitPatch
@workflow/swc-pluginPatch
@workflow/tsconfigPatch
@workflow/typescript-pluginPatch
@workflow/utilsPatch
@workflow/vitePatch
@workflow/vitestPatch
@workflow/web-sharedPatch
@workflow/webPatch
workflowPatch
@workflow/world-localPatch
@workflow/world-postgresPatch
@workflow/world-testingPatch
@workflow/world-vercelPatch
@workflow/worldPatch
docsPatch
tarballsPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

E2E Test Summary

Summary
PassedFailedSkippedTotal
✅ ▲ Vercel Production145502391694
✅ 💻 Local Development162102271848
✅ 📦 Local Production162102271848
✅ 🐘 Local Postgres162102271848
✅ 🪟 Windows15400154
✅ 📋 Other102002121232
✅ vercel-multi-region270027
Total7519011328651
Details by Category

✅ ▲ Vercel Production

AppPassedFailedSkipped
✅ astro126028
✅ example126028
✅ express126028
✅ fastify126028
✅ hono126028
✅ nextjs-turbopack15103
✅ nextjs-webpack15103
✅ nitro126028
✅ nuxt126028
✅ sveltekit14509
✅ vite126028

✅ 💻 Local Development

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 📦 Local Production

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🐘 Local Postgres

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🪟 Windows

AppPassedFailedSkipped
✅ nextjs-turbopack15400

✅ 📋 Other

AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable128026
✅ e2e-local-dev-tanstack-start-128026
✅ e2e-local-postgres-nest-stable128026
✅ e2e-local-postgres-tanstack-start-128026
✅ e2e-local-prod-nest-stable128026
✅ e2e-local-prod-tanstack-start-128026
✅ e2e-vercel-prod-nest126028
✅ e2e-vercel-prod-tanstack-start126028

✅ vercel-multi-region

AppPassedFailedSkipped
✅ nextjs-turbopack2700

📋 View full workflow run

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit f051d75 · Fri, 24 Jul 2026 20:19:34 GMT · run logs

Backend: vercel · app: nextjs-turbopack

MetricScenarioBest (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep242 (-66%) 💚1342 🔴 (+28%) 🔻1401 🔴 (+31%) 🔻1466 🔴 (+1.8%)30
TTFSstream175 (-82%) 💚1343 🔴 (+31%) 🔻1361 🔴 (+31%) 🔻1594 🔴 (+52%) 🔻30
TTFShook + stream463 (-61%) 💚1541 🔴 (+17%) 🔻1610 🔴 (+16%) 🔻1790 🔴 (+7.1%)30
STSO1020 steps (1-20)189 (+17%) 🔻299 🔴 (+20%) 🔻332 🔴 (+10%)395 🔴 (+30%) 🔻19
STSO1020 steps (101-120)211 (+14%)309 🔴 (+12%)610 🔴 (+87%) 🔻2294 🔴 (+546%) 🔻19
STSO1020 steps (1001-1020)513 (+13%)603 🔴 (+8.8%)624 🔴 (+4.3%)676 🔴 (-18%) 💚19
WO1020 steps416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)1
SLstream latency103 (+37%) 🔻165 🔴 (+36%) 🔻191 🔴 (+38%) 🔻380 🔴 (-55%) 💚30
SOstream overhead (text)124 (+28%) 🔻290 🔴 (+85%) 🔻413 (+112%) 🔻563 (+126%) 🔻30
SOstream overhead (structured)118 (+20%) 🔻225 (+31%) 🔻292 (+18%) 🔻497 (+78%) 🔻30
ℹ️ Metric definitions & methodology

Best/P75/P90/P99 deltas compare against the most recent benchmark run on main at the time of this run. 🔻 flags a delta worse than +15%, 💚 one better than −15%.

Metrics — TTFS: time to first step body (in-deployment start() → first step body, deployment clocks) · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (whole-run time outside step bodies, in-deployment anchored) · SL: stream latency (in-deployment write → read propagation, readAt - writtenAt) · SO: stream overhead (end-to-end write+consume time beyond the modelled generation window)

Scenarios — step: one trivial no-op step, no stream; no hooks, so the run stays in turbo mode (in-process fast path) · stream: one streaming step; no hooks, so the run stays in turbo mode (in-process fast path) · hook + stream: registers a hook before one step, which exits turbo mode (dispatch path) · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges, and WO is the whole-run overhead outside step bodies · stream latency: parallel reader/writer steps on a dedicated stream; SL is the in-deployment write->read propagation (readAt - writtenAt) · stream overhead (text): writer streams 300 variable-length text token deltas paced at 100/s for 3s (a haiku-size LLM's token throughput) while a parallel reader drains the whole stream; SO is the end-to-end write+consume time beyond the 3s generation window (overhead/backpressure) · stream overhead (structured): same workload as stream overhead (text), but each delta is an AI-SDK-style structured object ({ type: 'text-delta', id, text }) instead of a raw string, so the SO gap vs the text scenario is the added serialization cost

🔴 marks a percentile over its target (within target is left unmarked). Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · SO 250/500/1000 · STSO (1-20) 20/30/60 · STSO (101-120) 30/45/90 · STSO (1001-1020) 40/60/120

All metrics are measured from deployment-side timestamps only. Runs are triggered by an in-deployment route that stamps the anchor (clientStart) right before start(), so the CI runner’s request and its path through api.vercel.com sit outside every measured window. TTFS = in-deployment start() → first step body (turbo uses the in-process fast path, non-turbo the dispatch path), and includes the VQS dispatch hop plus any /flow cold start. STSO/WO are measured between step bodies on the deployment. SL is measured inside the workflow (parallel reader/writer steps), so it no longer includes the api.vercel.com read path.

Cold starts are kept in the numbers on purpose — they are part of real bursty-workload latency. The workbench deployment cold-starts the /flow invocation for a large fraction of runs, inflating P75+; the Best column shows the fastest (warm-start) sample for comparison.

@VaguelySeriousVaguelySerious changed the title [release] Exit changeset pre mode for 5.0.0 GA[release] Exit changeset pre mode for v5, tie core and world-vercel versions togetherJul 24, 2026
@VaguelySerious
VaguelySerious marked this pull request as ready for review July 27, 2026 18:39
@VaguelySerious
VaguelySerious requested review from a team and ijjk as code ownersJuly 27, 2026 18:39
Sign up for freeto 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.

1 participant

@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [release] Exit changeset pre mode for v5, tie core and world-vercel versions together by VaguelySerious · Pull Request #3090 · vercel/workflow · GitHub
Skip to content

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together - #3090

Open
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga
Open

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together#3090
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga

Conversation

@VaguelySerious

@VaguelySeriousVaguelySerious commented Jul 24, 2026

Copy link
Copy Markdown
Member

Prep for the 5.0.0 GA release. Draft on purpose — merging this arms the GA publish.

  1. Exits changesets pre-release mode (.changeset/pre.json"mode": "exit"). The next Release run on main opens a plain "Version Packages" PR; merging that one publishes 5.0.0 to the latest dist-tag.
  2. Adds @workflow/world-vercel to the fixed group with workflow and @workflow/core. @workflow/world-vercel does not depend on @workflow/core, so nothing kept them aligned before — the Vercel adapter drifted to 5.0.0-beta.32 while core was at 5.0.0-beta.36. From 5.0.0 on, the adapter version is the SDK version.
  3. Derives the GitHub Release flags from the published version, not the branch.main was hardcoded to --prerelease=true --latest=false, which would have marked the 5.0.0 release as a prerelease. Now any version with a prerelease identifier is a prerelease on any branch, and the "Latest" marker follows the GA line on main.
  4. Updates the release-strategy section of AGENTS.md to match.

Verification

Dry-ran the whole thing in a scratch worktree off origin/main (changeset pre exit + changeset version over all 439 pending changesets):

  • All 26 public packages land on exactly 5.0.0 — including @workflow/ai, @workflow/serde, @workflow/utils, and the worlds, which were on trailing beta numbers. The check-release-major.js guard (RELEASE_VERSION: 5) passes.
  • Fixed group works: after that run, a changeset touching only @workflow/core bumps @workflow/core, workflowand@workflow/world-vercel to 5.0.1 together.
  • Release-flag logic checked against workflow@5.0.0 on main (--prerelease=false --latest), workflow@4.2.1 on stable (--prerelease=false --latest=false), and workflow@5.1.0-beta.1 / workflow@6.0.0-rc.2 on main (--prerelease=true --latest=false).

Required companion change on stable

stable is not in pre mode and no package sets publishConfig.tag, so once main leaves pre mode both branches publish to latest — the next 4.x patch would move latest back to 4.x. Companion PR against stable pins ci:publish to changeset publish --tag previous (and mirrors the release-flag change); it needs to land before or alongside this one. The tag is previous rather than v4 because npm rejects tag names that parse as a semver range.

Trade-off worth knowing

The fixed group means a @workflow/world-vercel-only fix now also republishes workflow and @workflow/core (and their dependents), and a core-only fix produces an empty ## X.Y.Z section in the world-vercel changelog. That's the cost of guaranteed alignment.

Take `main` out of changesets pre-release mode so the next "Version
Packages" PR publishes 5.0.0 to the `latest` dist-tag instead of another
`5.0.0-beta.N`.
Also add `@workflow/world-vercel` to the `workflow` / `@workflow/core`
fixed group, so the Vercel adapter carries the same version as the SDK
from 5.0.0 onward, and derive the GitHub Release prerelease/latest flags
from the published version rather than the branch name.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

@changeset-bot

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: f051d75

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 46 packages
NameType
@workflow/example-astroPatch
@workflow/example-appPatch
@workflow/example-expressPatch
@workflow/example-fastifyPatch
@workflow/example-honoPatch
@workflow/example-nestPatch
nextjs-turbopackPatch
nextjs-webpackPatch
@workflow/example-nitro-v2Patch
@workflow/example-nitroPatch
@workflow/example-nuxtPatch
@workflow/example-sveltekitPatch
workflow-sdk-compiler-playgroundPatch
@workflow/example-tanstack-startPatch
@workflow/example-vitePatch
@workflow/vitest-workbenchPatch
@workflow/aiPatch
@workflow/astroPatch
@workflow/buildersPatch
@workflow/cliPatch
@workflow/corePatch
@workflow/docs-typecheckPatch
@workflow/errorsPatch
@workflow/nestPatch
@workflow/nextPatch
@workflow/nitroPatch
@workflow/nuxtPatch
@workflow/rollupPatch
@workflow/serdePatch
@workflow/sveltekitPatch
@workflow/swc-pluginPatch
@workflow/tsconfigPatch
@workflow/typescript-pluginPatch
@workflow/utilsPatch
@workflow/vitePatch
@workflow/vitestPatch
@workflow/web-sharedPatch
@workflow/webPatch
workflowPatch
@workflow/world-localPatch
@workflow/world-postgresPatch
@workflow/world-testingPatch
@workflow/world-vercelPatch
@workflow/worldPatch
docsPatch
tarballsPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

E2E Test Summary

Summary
PassedFailedSkippedTotal
✅ ▲ Vercel Production145502391694
✅ 💻 Local Development162102271848
✅ 📦 Local Production162102271848
✅ 🐘 Local Postgres162102271848
✅ 🪟 Windows15400154
✅ 📋 Other102002121232
✅ vercel-multi-region270027
Total7519011328651
Details by Category

✅ ▲ Vercel Production

AppPassedFailedSkipped
✅ astro126028
✅ example126028
✅ express126028
✅ fastify126028
✅ hono126028
✅ nextjs-turbopack15103
✅ nextjs-webpack15103
✅ nitro126028
✅ nuxt126028
✅ sveltekit14509
✅ vite126028

✅ 💻 Local Development

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 📦 Local Production

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🐘 Local Postgres

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🪟 Windows

AppPassedFailedSkipped
✅ nextjs-turbopack15400

✅ 📋 Other

AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable128026
✅ e2e-local-dev-tanstack-start-128026
✅ e2e-local-postgres-nest-stable128026
✅ e2e-local-postgres-tanstack-start-128026
✅ e2e-local-prod-nest-stable128026
✅ e2e-local-prod-tanstack-start-128026
✅ e2e-vercel-prod-nest126028
✅ e2e-vercel-prod-tanstack-start126028

✅ vercel-multi-region

AppPassedFailedSkipped
✅ nextjs-turbopack2700

📋 View full workflow run

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit f051d75 · Fri, 24 Jul 2026 20:19:34 GMT · run logs

Backend: vercel · app: nextjs-turbopack

MetricScenarioBest (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep242 (-66%) 💚1342 🔴 (+28%) 🔻1401 🔴 (+31%) 🔻1466 🔴 (+1.8%)30
TTFSstream175 (-82%) 💚1343 🔴 (+31%) 🔻1361 🔴 (+31%) 🔻1594 🔴 (+52%) 🔻30
TTFShook + stream463 (-61%) 💚1541 🔴 (+17%) 🔻1610 🔴 (+16%) 🔻1790 🔴 (+7.1%)30
STSO1020 steps (1-20)189 (+17%) 🔻299 🔴 (+20%) 🔻332 🔴 (+10%)395 🔴 (+30%) 🔻19
STSO1020 steps (101-120)211 (+14%)309 🔴 (+12%)610 🔴 (+87%) 🔻2294 🔴 (+546%) 🔻19
STSO1020 steps (1001-1020)513 (+13%)603 🔴 (+8.8%)624 🔴 (+4.3%)676 🔴 (-18%) 💚19
WO1020 steps416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)1
SLstream latency103 (+37%) 🔻165 🔴 (+36%) 🔻191 🔴 (+38%) 🔻380 🔴 (-55%) 💚30
SOstream overhead (text)124 (+28%) 🔻290 🔴 (+85%) 🔻413 (+112%) 🔻563 (+126%) 🔻30
SOstream overhead (structured)118 (+20%) 🔻225 (+31%) 🔻292 (+18%) 🔻497 (+78%) 🔻30
ℹ️ Metric definitions & methodology

Best/P75/P90/P99 deltas compare against the most recent benchmark run on main at the time of this run. 🔻 flags a delta worse than +15%, 💚 one better than −15%.

Metrics — TTFS: time to first step body (in-deployment start() → first step body, deployment clocks) · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (whole-run time outside step bodies, in-deployment anchored) · SL: stream latency (in-deployment write → read propagation, readAt - writtenAt) · SO: stream overhead (end-to-end write+consume time beyond the modelled generation window)

Scenarios — step: one trivial no-op step, no stream; no hooks, so the run stays in turbo mode (in-process fast path) · stream: one streaming step; no hooks, so the run stays in turbo mode (in-process fast path) · hook + stream: registers a hook before one step, which exits turbo mode (dispatch path) · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges, and WO is the whole-run overhead outside step bodies · stream latency: parallel reader/writer steps on a dedicated stream; SL is the in-deployment write->read propagation (readAt - writtenAt) · stream overhead (text): writer streams 300 variable-length text token deltas paced at 100/s for 3s (a haiku-size LLM's token throughput) while a parallel reader drains the whole stream; SO is the end-to-end write+consume time beyond the 3s generation window (overhead/backpressure) · stream overhead (structured): same workload as stream overhead (text), but each delta is an AI-SDK-style structured object ({ type: 'text-delta', id, text }) instead of a raw string, so the SO gap vs the text scenario is the added serialization cost

🔴 marks a percentile over its target (within target is left unmarked). Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · SO 250/500/1000 · STSO (1-20) 20/30/60 · STSO (101-120) 30/45/90 · STSO (1001-1020) 40/60/120

All metrics are measured from deployment-side timestamps only. Runs are triggered by an in-deployment route that stamps the anchor (clientStart) right before start(), so the CI runner’s request and its path through api.vercel.com sit outside every measured window. TTFS = in-deployment start() → first step body (turbo uses the in-process fast path, non-turbo the dispatch path), and includes the VQS dispatch hop plus any /flow cold start. STSO/WO are measured between step bodies on the deployment. SL is measured inside the workflow (parallel reader/writer steps), so it no longer includes the api.vercel.com read path.

Cold starts are kept in the numbers on purpose — they are part of real bursty-workload latency. The workbench deployment cold-starts the /flow invocation for a large fraction of runs, inflating P75+; the Best column shows the fastest (warm-start) sample for comparison.

@VaguelySeriousVaguelySerious changed the title [release] Exit changeset pre mode for 5.0.0 GA[release] Exit changeset pre mode for v5, tie core and world-vercel versions togetherJul 24, 2026
@VaguelySerious
VaguelySerious marked this pull request as ready for review July 27, 2026 18:39
@VaguelySerious
VaguelySerious requested review from a team and ijjk as code ownersJuly 27, 2026 18:39
Sign up for freeto 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.

1 participant

@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' [release] Exit changeset pre mode for v5, tie core and world-vercel versions together by VaguelySerious · Pull Request #3090 · vercel/workflow · GitHub
Skip to content

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together - #3090

Open
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga
Open

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together#3090
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga

Conversation

@VaguelySerious

@VaguelySeriousVaguelySerious commented Jul 24, 2026

Copy link
Copy Markdown
Member

Prep for the 5.0.0 GA release. Draft on purpose — merging this arms the GA publish.

  1. Exits changesets pre-release mode (.changeset/pre.json"mode": "exit"). The next Release run on main opens a plain "Version Packages" PR; merging that one publishes 5.0.0 to the latest dist-tag.
  2. Adds @workflow/world-vercel to the fixed group with workflow and @workflow/core. @workflow/world-vercel does not depend on @workflow/core, so nothing kept them aligned before — the Vercel adapter drifted to 5.0.0-beta.32 while core was at 5.0.0-beta.36. From 5.0.0 on, the adapter version is the SDK version.
  3. Derives the GitHub Release flags from the published version, not the branch.main was hardcoded to --prerelease=true --latest=false, which would have marked the 5.0.0 release as a prerelease. Now any version with a prerelease identifier is a prerelease on any branch, and the "Latest" marker follows the GA line on main.
  4. Updates the release-strategy section of AGENTS.md to match.

Verification

Dry-ran the whole thing in a scratch worktree off origin/main (changeset pre exit + changeset version over all 439 pending changesets):

  • All 26 public packages land on exactly 5.0.0 — including @workflow/ai, @workflow/serde, @workflow/utils, and the worlds, which were on trailing beta numbers. The check-release-major.js guard (RELEASE_VERSION: 5) passes.
  • Fixed group works: after that run, a changeset touching only @workflow/core bumps @workflow/core, workflowand@workflow/world-vercel to 5.0.1 together.
  • Release-flag logic checked against workflow@5.0.0 on main (--prerelease=false --latest), workflow@4.2.1 on stable (--prerelease=false --latest=false), and workflow@5.1.0-beta.1 / workflow@6.0.0-rc.2 on main (--prerelease=true --latest=false).

Required companion change on stable

stable is not in pre mode and no package sets publishConfig.tag, so once main leaves pre mode both branches publish to latest — the next 4.x patch would move latest back to 4.x. Companion PR against stable pins ci:publish to changeset publish --tag previous (and mirrors the release-flag change); it needs to land before or alongside this one. The tag is previous rather than v4 because npm rejects tag names that parse as a semver range.

Trade-off worth knowing

The fixed group means a @workflow/world-vercel-only fix now also republishes workflow and @workflow/core (and their dependents), and a core-only fix produces an empty ## X.Y.Z section in the world-vercel changelog. That's the cost of guaranteed alignment.

Take `main` out of changesets pre-release mode so the next "Version
Packages" PR publishes 5.0.0 to the `latest` dist-tag instead of another
`5.0.0-beta.N`.
Also add `@workflow/world-vercel` to the `workflow` / `@workflow/core`
fixed group, so the Vercel adapter carries the same version as the SDK
from 5.0.0 onward, and derive the GitHub Release prerelease/latest flags
from the published version rather than the branch name.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

@changeset-bot

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: f051d75

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 46 packages
NameType
@workflow/example-astroPatch
@workflow/example-appPatch
@workflow/example-expressPatch
@workflow/example-fastifyPatch
@workflow/example-honoPatch
@workflow/example-nestPatch
nextjs-turbopackPatch
nextjs-webpackPatch
@workflow/example-nitro-v2Patch
@workflow/example-nitroPatch
@workflow/example-nuxtPatch
@workflow/example-sveltekitPatch
workflow-sdk-compiler-playgroundPatch
@workflow/example-tanstack-startPatch
@workflow/example-vitePatch
@workflow/vitest-workbenchPatch
@workflow/aiPatch
@workflow/astroPatch
@workflow/buildersPatch
@workflow/cliPatch
@workflow/corePatch
@workflow/docs-typecheckPatch
@workflow/errorsPatch
@workflow/nestPatch
@workflow/nextPatch
@workflow/nitroPatch
@workflow/nuxtPatch
@workflow/rollupPatch
@workflow/serdePatch
@workflow/sveltekitPatch
@workflow/swc-pluginPatch
@workflow/tsconfigPatch
@workflow/typescript-pluginPatch
@workflow/utilsPatch
@workflow/vitePatch
@workflow/vitestPatch
@workflow/web-sharedPatch
@workflow/webPatch
workflowPatch
@workflow/world-localPatch
@workflow/world-postgresPatch
@workflow/world-testingPatch
@workflow/world-vercelPatch
@workflow/worldPatch
docsPatch
tarballsPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

E2E Test Summary

Summary
PassedFailedSkippedTotal
✅ ▲ Vercel Production145502391694
✅ 💻 Local Development162102271848
✅ 📦 Local Production162102271848
✅ 🐘 Local Postgres162102271848
✅ 🪟 Windows15400154
✅ 📋 Other102002121232
✅ vercel-multi-region270027
Total7519011328651
Details by Category

✅ ▲ Vercel Production

AppPassedFailedSkipped
✅ astro126028
✅ example126028
✅ express126028
✅ fastify126028
✅ hono126028
✅ nextjs-turbopack15103
✅ nextjs-webpack15103
✅ nitro126028
✅ nuxt126028
✅ sveltekit14509
✅ vite126028

✅ 💻 Local Development

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 📦 Local Production

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🐘 Local Postgres

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🪟 Windows

AppPassedFailedSkipped
✅ nextjs-turbopack15400

✅ 📋 Other

AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable128026
✅ e2e-local-dev-tanstack-start-128026
✅ e2e-local-postgres-nest-stable128026
✅ e2e-local-postgres-tanstack-start-128026
✅ e2e-local-prod-nest-stable128026
✅ e2e-local-prod-tanstack-start-128026
✅ e2e-vercel-prod-nest126028
✅ e2e-vercel-prod-tanstack-start126028

✅ vercel-multi-region

AppPassedFailedSkipped
✅ nextjs-turbopack2700

📋 View full workflow run

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit f051d75 · Fri, 24 Jul 2026 20:19:34 GMT · run logs

Backend: vercel · app: nextjs-turbopack

MetricScenarioBest (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep242 (-66%) 💚1342 🔴 (+28%) 🔻1401 🔴 (+31%) 🔻1466 🔴 (+1.8%)30
TTFSstream175 (-82%) 💚1343 🔴 (+31%) 🔻1361 🔴 (+31%) 🔻1594 🔴 (+52%) 🔻30
TTFShook + stream463 (-61%) 💚1541 🔴 (+17%) 🔻1610 🔴 (+16%) 🔻1790 🔴 (+7.1%)30
STSO1020 steps (1-20)189 (+17%) 🔻299 🔴 (+20%) 🔻332 🔴 (+10%)395 🔴 (+30%) 🔻19
STSO1020 steps (101-120)211 (+14%)309 🔴 (+12%)610 🔴 (+87%) 🔻2294 🔴 (+546%) 🔻19
STSO1020 steps (1001-1020)513 (+13%)603 🔴 (+8.8%)624 🔴 (+4.3%)676 🔴 (-18%) 💚19
WO1020 steps416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)1
SLstream latency103 (+37%) 🔻165 🔴 (+36%) 🔻191 🔴 (+38%) 🔻380 🔴 (-55%) 💚30
SOstream overhead (text)124 (+28%) 🔻290 🔴 (+85%) 🔻413 (+112%) 🔻563 (+126%) 🔻30
SOstream overhead (structured)118 (+20%) 🔻225 (+31%) 🔻292 (+18%) 🔻497 (+78%) 🔻30
ℹ️ Metric definitions & methodology

Best/P75/P90/P99 deltas compare against the most recent benchmark run on main at the time of this run. 🔻 flags a delta worse than +15%, 💚 one better than −15%.

Metrics — TTFS: time to first step body (in-deployment start() → first step body, deployment clocks) · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (whole-run time outside step bodies, in-deployment anchored) · SL: stream latency (in-deployment write → read propagation, readAt - writtenAt) · SO: stream overhead (end-to-end write+consume time beyond the modelled generation window)

Scenarios — step: one trivial no-op step, no stream; no hooks, so the run stays in turbo mode (in-process fast path) · stream: one streaming step; no hooks, so the run stays in turbo mode (in-process fast path) · hook + stream: registers a hook before one step, which exits turbo mode (dispatch path) · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges, and WO is the whole-run overhead outside step bodies · stream latency: parallel reader/writer steps on a dedicated stream; SL is the in-deployment write->read propagation (readAt - writtenAt) · stream overhead (text): writer streams 300 variable-length text token deltas paced at 100/s for 3s (a haiku-size LLM's token throughput) while a parallel reader drains the whole stream; SO is the end-to-end write+consume time beyond the 3s generation window (overhead/backpressure) · stream overhead (structured): same workload as stream overhead (text), but each delta is an AI-SDK-style structured object ({ type: 'text-delta', id, text }) instead of a raw string, so the SO gap vs the text scenario is the added serialization cost

🔴 marks a percentile over its target (within target is left unmarked). Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · SO 250/500/1000 · STSO (1-20) 20/30/60 · STSO (101-120) 30/45/90 · STSO (1001-1020) 40/60/120

All metrics are measured from deployment-side timestamps only. Runs are triggered by an in-deployment route that stamps the anchor (clientStart) right before start(), so the CI runner’s request and its path through api.vercel.com sit outside every measured window. TTFS = in-deployment start() → first step body (turbo uses the in-process fast path, non-turbo the dispatch path), and includes the VQS dispatch hop plus any /flow cold start. STSO/WO are measured between step bodies on the deployment. SL is measured inside the workflow (parallel reader/writer steps), so it no longer includes the api.vercel.com read path.

Cold starts are kept in the numbers on purpose — they are part of real bursty-workload latency. The workbench deployment cold-starts the /flow invocation for a large fraction of runs, inflating P75+; the Best column shows the fastest (warm-start) sample for comparison.

@VaguelySeriousVaguelySerious changed the title [release] Exit changeset pre mode for 5.0.0 GA[release] Exit changeset pre mode for v5, tie core and world-vercel versions togetherJul 24, 2026
@VaguelySerious
VaguelySerious marked this pull request as ready for review July 27, 2026 18:39
@VaguelySerious
VaguelySerious requested review from a team and ijjk as code ownersJuly 27, 2026 18:39
Sign up for freeto 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.

1 participant

@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [release] Exit changeset pre mode for v5, tie core and world-vercel versions together by VaguelySerious · Pull Request #3090 · vercel/workflow · GitHub
Skip to content

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together - #3090

Open
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga
Open

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together#3090
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga

Conversation

@VaguelySerious

@VaguelySeriousVaguelySerious commented Jul 24, 2026

Copy link
Copy Markdown
Member

Prep for the 5.0.0 GA release. Draft on purpose — merging this arms the GA publish.

  1. Exits changesets pre-release mode (.changeset/pre.json"mode": "exit"). The next Release run on main opens a plain "Version Packages" PR; merging that one publishes 5.0.0 to the latest dist-tag.
  2. Adds @workflow/world-vercel to the fixed group with workflow and @workflow/core. @workflow/world-vercel does not depend on @workflow/core, so nothing kept them aligned before — the Vercel adapter drifted to 5.0.0-beta.32 while core was at 5.0.0-beta.36. From 5.0.0 on, the adapter version is the SDK version.
  3. Derives the GitHub Release flags from the published version, not the branch.main was hardcoded to --prerelease=true --latest=false, which would have marked the 5.0.0 release as a prerelease. Now any version with a prerelease identifier is a prerelease on any branch, and the "Latest" marker follows the GA line on main.
  4. Updates the release-strategy section of AGENTS.md to match.

Verification

Dry-ran the whole thing in a scratch worktree off origin/main (changeset pre exit + changeset version over all 439 pending changesets):

  • All 26 public packages land on exactly 5.0.0 — including @workflow/ai, @workflow/serde, @workflow/utils, and the worlds, which were on trailing beta numbers. The check-release-major.js guard (RELEASE_VERSION: 5) passes.
  • Fixed group works: after that run, a changeset touching only @workflow/core bumps @workflow/core, workflowand@workflow/world-vercel to 5.0.1 together.
  • Release-flag logic checked against workflow@5.0.0 on main (--prerelease=false --latest), workflow@4.2.1 on stable (--prerelease=false --latest=false), and workflow@5.1.0-beta.1 / workflow@6.0.0-rc.2 on main (--prerelease=true --latest=false).

Required companion change on stable

stable is not in pre mode and no package sets publishConfig.tag, so once main leaves pre mode both branches publish to latest — the next 4.x patch would move latest back to 4.x. Companion PR against stable pins ci:publish to changeset publish --tag previous (and mirrors the release-flag change); it needs to land before or alongside this one. The tag is previous rather than v4 because npm rejects tag names that parse as a semver range.

Trade-off worth knowing

The fixed group means a @workflow/world-vercel-only fix now also republishes workflow and @workflow/core (and their dependents), and a core-only fix produces an empty ## X.Y.Z section in the world-vercel changelog. That's the cost of guaranteed alignment.

Take `main` out of changesets pre-release mode so the next "Version
Packages" PR publishes 5.0.0 to the `latest` dist-tag instead of another
`5.0.0-beta.N`.
Also add `@workflow/world-vercel` to the `workflow` / `@workflow/core`
fixed group, so the Vercel adapter carries the same version as the SDK
from 5.0.0 onward, and derive the GitHub Release prerelease/latest flags
from the published version rather than the branch name.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

@changeset-bot

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: f051d75

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 46 packages
NameType
@workflow/example-astroPatch
@workflow/example-appPatch
@workflow/example-expressPatch
@workflow/example-fastifyPatch
@workflow/example-honoPatch
@workflow/example-nestPatch
nextjs-turbopackPatch
nextjs-webpackPatch
@workflow/example-nitro-v2Patch
@workflow/example-nitroPatch
@workflow/example-nuxtPatch
@workflow/example-sveltekitPatch
workflow-sdk-compiler-playgroundPatch
@workflow/example-tanstack-startPatch
@workflow/example-vitePatch
@workflow/vitest-workbenchPatch
@workflow/aiPatch
@workflow/astroPatch
@workflow/buildersPatch
@workflow/cliPatch
@workflow/corePatch
@workflow/docs-typecheckPatch
@workflow/errorsPatch
@workflow/nestPatch
@workflow/nextPatch
@workflow/nitroPatch
@workflow/nuxtPatch
@workflow/rollupPatch
@workflow/serdePatch
@workflow/sveltekitPatch
@workflow/swc-pluginPatch
@workflow/tsconfigPatch
@workflow/typescript-pluginPatch
@workflow/utilsPatch
@workflow/vitePatch
@workflow/vitestPatch
@workflow/web-sharedPatch
@workflow/webPatch
workflowPatch
@workflow/world-localPatch
@workflow/world-postgresPatch
@workflow/world-testingPatch
@workflow/world-vercelPatch
@workflow/worldPatch
docsPatch
tarballsPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

E2E Test Summary

Summary
PassedFailedSkippedTotal
✅ ▲ Vercel Production145502391694
✅ 💻 Local Development162102271848
✅ 📦 Local Production162102271848
✅ 🐘 Local Postgres162102271848
✅ 🪟 Windows15400154
✅ 📋 Other102002121232
✅ vercel-multi-region270027
Total7519011328651
Details by Category

✅ ▲ Vercel Production

AppPassedFailedSkipped
✅ astro126028
✅ example126028
✅ express126028
✅ fastify126028
✅ hono126028
✅ nextjs-turbopack15103
✅ nextjs-webpack15103
✅ nitro126028
✅ nuxt126028
✅ sveltekit14509
✅ vite126028

✅ 💻 Local Development

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 📦 Local Production

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🐘 Local Postgres

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🪟 Windows

AppPassedFailedSkipped
✅ nextjs-turbopack15400

✅ 📋 Other

AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable128026
✅ e2e-local-dev-tanstack-start-128026
✅ e2e-local-postgres-nest-stable128026
✅ e2e-local-postgres-tanstack-start-128026
✅ e2e-local-prod-nest-stable128026
✅ e2e-local-prod-tanstack-start-128026
✅ e2e-vercel-prod-nest126028
✅ e2e-vercel-prod-tanstack-start126028

✅ vercel-multi-region

AppPassedFailedSkipped
✅ nextjs-turbopack2700

📋 View full workflow run

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit f051d75 · Fri, 24 Jul 2026 20:19:34 GMT · run logs

Backend: vercel · app: nextjs-turbopack

MetricScenarioBest (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep242 (-66%) 💚1342 🔴 (+28%) 🔻1401 🔴 (+31%) 🔻1466 🔴 (+1.8%)30
TTFSstream175 (-82%) 💚1343 🔴 (+31%) 🔻1361 🔴 (+31%) 🔻1594 🔴 (+52%) 🔻30
TTFShook + stream463 (-61%) 💚1541 🔴 (+17%) 🔻1610 🔴 (+16%) 🔻1790 🔴 (+7.1%)30
STSO1020 steps (1-20)189 (+17%) 🔻299 🔴 (+20%) 🔻332 🔴 (+10%)395 🔴 (+30%) 🔻19
STSO1020 steps (101-120)211 (+14%)309 🔴 (+12%)610 🔴 (+87%) 🔻2294 🔴 (+546%) 🔻19
STSO1020 steps (1001-1020)513 (+13%)603 🔴 (+8.8%)624 🔴 (+4.3%)676 🔴 (-18%) 💚19
WO1020 steps416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)1
SLstream latency103 (+37%) 🔻165 🔴 (+36%) 🔻191 🔴 (+38%) 🔻380 🔴 (-55%) 💚30
SOstream overhead (text)124 (+28%) 🔻290 🔴 (+85%) 🔻413 (+112%) 🔻563 (+126%) 🔻30
SOstream overhead (structured)118 (+20%) 🔻225 (+31%) 🔻292 (+18%) 🔻497 (+78%) 🔻30
ℹ️ Metric definitions & methodology

Best/P75/P90/P99 deltas compare against the most recent benchmark run on main at the time of this run. 🔻 flags a delta worse than +15%, 💚 one better than −15%.

Metrics — TTFS: time to first step body (in-deployment start() → first step body, deployment clocks) · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (whole-run time outside step bodies, in-deployment anchored) · SL: stream latency (in-deployment write → read propagation, readAt - writtenAt) · SO: stream overhead (end-to-end write+consume time beyond the modelled generation window)

Scenarios — step: one trivial no-op step, no stream; no hooks, so the run stays in turbo mode (in-process fast path) · stream: one streaming step; no hooks, so the run stays in turbo mode (in-process fast path) · hook + stream: registers a hook before one step, which exits turbo mode (dispatch path) · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges, and WO is the whole-run overhead outside step bodies · stream latency: parallel reader/writer steps on a dedicated stream; SL is the in-deployment write->read propagation (readAt - writtenAt) · stream overhead (text): writer streams 300 variable-length text token deltas paced at 100/s for 3s (a haiku-size LLM's token throughput) while a parallel reader drains the whole stream; SO is the end-to-end write+consume time beyond the 3s generation window (overhead/backpressure) · stream overhead (structured): same workload as stream overhead (text), but each delta is an AI-SDK-style structured object ({ type: 'text-delta', id, text }) instead of a raw string, so the SO gap vs the text scenario is the added serialization cost

🔴 marks a percentile over its target (within target is left unmarked). Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · SO 250/500/1000 · STSO (1-20) 20/30/60 · STSO (101-120) 30/45/90 · STSO (1001-1020) 40/60/120

All metrics are measured from deployment-side timestamps only. Runs are triggered by an in-deployment route that stamps the anchor (clientStart) right before start(), so the CI runner’s request and its path through api.vercel.com sit outside every measured window. TTFS = in-deployment start() → first step body (turbo uses the in-process fast path, non-turbo the dispatch path), and includes the VQS dispatch hop plus any /flow cold start. STSO/WO are measured between step bodies on the deployment. SL is measured inside the workflow (parallel reader/writer steps), so it no longer includes the api.vercel.com read path.

Cold starts are kept in the numbers on purpose — they are part of real bursty-workload latency. The workbench deployment cold-starts the /flow invocation for a large fraction of runs, inflating P75+; the Best column shows the fastest (warm-start) sample for comparison.

@VaguelySeriousVaguelySerious changed the title [release] Exit changeset pre mode for 5.0.0 GA[release] Exit changeset pre mode for v5, tie core and world-vercel versions togetherJul 24, 2026
@VaguelySerious
VaguelySerious marked this pull request as ready for review July 27, 2026 18:39
@VaguelySerious
VaguelySerious requested review from a team and ijjk as code ownersJuly 27, 2026 18:39
Sign up for freeto 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.

1 participant

@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [release] Exit changeset pre mode for v5, tie core and world-vercel versions together by VaguelySerious · Pull Request #3090 · vercel/workflow · GitHub
Skip to content

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together - #3090

Open
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga
Open

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together#3090
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga

Conversation

@VaguelySerious

@VaguelySeriousVaguelySerious commented Jul 24, 2026

Copy link
Copy Markdown
Member

Prep for the 5.0.0 GA release. Draft on purpose — merging this arms the GA publish.

  1. Exits changesets pre-release mode (.changeset/pre.json"mode": "exit"). The next Release run on main opens a plain "Version Packages" PR; merging that one publishes 5.0.0 to the latest dist-tag.
  2. Adds @workflow/world-vercel to the fixed group with workflow and @workflow/core. @workflow/world-vercel does not depend on @workflow/core, so nothing kept them aligned before — the Vercel adapter drifted to 5.0.0-beta.32 while core was at 5.0.0-beta.36. From 5.0.0 on, the adapter version is the SDK version.
  3. Derives the GitHub Release flags from the published version, not the branch.main was hardcoded to --prerelease=true --latest=false, which would have marked the 5.0.0 release as a prerelease. Now any version with a prerelease identifier is a prerelease on any branch, and the "Latest" marker follows the GA line on main.
  4. Updates the release-strategy section of AGENTS.md to match.

Verification

Dry-ran the whole thing in a scratch worktree off origin/main (changeset pre exit + changeset version over all 439 pending changesets):

  • All 26 public packages land on exactly 5.0.0 — including @workflow/ai, @workflow/serde, @workflow/utils, and the worlds, which were on trailing beta numbers. The check-release-major.js guard (RELEASE_VERSION: 5) passes.
  • Fixed group works: after that run, a changeset touching only @workflow/core bumps @workflow/core, workflowand@workflow/world-vercel to 5.0.1 together.
  • Release-flag logic checked against workflow@5.0.0 on main (--prerelease=false --latest), workflow@4.2.1 on stable (--prerelease=false --latest=false), and workflow@5.1.0-beta.1 / workflow@6.0.0-rc.2 on main (--prerelease=true --latest=false).

Required companion change on stable

stable is not in pre mode and no package sets publishConfig.tag, so once main leaves pre mode both branches publish to latest — the next 4.x patch would move latest back to 4.x. Companion PR against stable pins ci:publish to changeset publish --tag previous (and mirrors the release-flag change); it needs to land before or alongside this one. The tag is previous rather than v4 because npm rejects tag names that parse as a semver range.

Trade-off worth knowing

The fixed group means a @workflow/world-vercel-only fix now also republishes workflow and @workflow/core (and their dependents), and a core-only fix produces an empty ## X.Y.Z section in the world-vercel changelog. That's the cost of guaranteed alignment.

Take `main` out of changesets pre-release mode so the next "Version
Packages" PR publishes 5.0.0 to the `latest` dist-tag instead of another
`5.0.0-beta.N`.
Also add `@workflow/world-vercel` to the `workflow` / `@workflow/core`
fixed group, so the Vercel adapter carries the same version as the SDK
from 5.0.0 onward, and derive the GitHub Release prerelease/latest flags
from the published version rather than the branch name.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

@changeset-bot

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: f051d75

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 46 packages
NameType
@workflow/example-astroPatch
@workflow/example-appPatch
@workflow/example-expressPatch
@workflow/example-fastifyPatch
@workflow/example-honoPatch
@workflow/example-nestPatch
nextjs-turbopackPatch
nextjs-webpackPatch
@workflow/example-nitro-v2Patch
@workflow/example-nitroPatch
@workflow/example-nuxtPatch
@workflow/example-sveltekitPatch
workflow-sdk-compiler-playgroundPatch
@workflow/example-tanstack-startPatch
@workflow/example-vitePatch
@workflow/vitest-workbenchPatch
@workflow/aiPatch
@workflow/astroPatch
@workflow/buildersPatch
@workflow/cliPatch
@workflow/corePatch
@workflow/docs-typecheckPatch
@workflow/errorsPatch
@workflow/nestPatch
@workflow/nextPatch
@workflow/nitroPatch
@workflow/nuxtPatch
@workflow/rollupPatch
@workflow/serdePatch
@workflow/sveltekitPatch
@workflow/swc-pluginPatch
@workflow/tsconfigPatch
@workflow/typescript-pluginPatch
@workflow/utilsPatch
@workflow/vitePatch
@workflow/vitestPatch
@workflow/web-sharedPatch
@workflow/webPatch
workflowPatch
@workflow/world-localPatch
@workflow/world-postgresPatch
@workflow/world-testingPatch
@workflow/world-vercelPatch
@workflow/worldPatch
docsPatch
tarballsPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

E2E Test Summary

Summary
PassedFailedSkippedTotal
✅ ▲ Vercel Production145502391694
✅ 💻 Local Development162102271848
✅ 📦 Local Production162102271848
✅ 🐘 Local Postgres162102271848
✅ 🪟 Windows15400154
✅ 📋 Other102002121232
✅ vercel-multi-region270027
Total7519011328651
Details by Category

✅ ▲ Vercel Production

AppPassedFailedSkipped
✅ astro126028
✅ example126028
✅ express126028
✅ fastify126028
✅ hono126028
✅ nextjs-turbopack15103
✅ nextjs-webpack15103
✅ nitro126028
✅ nuxt126028
✅ sveltekit14509
✅ vite126028

✅ 💻 Local Development

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 📦 Local Production

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🐘 Local Postgres

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🪟 Windows

AppPassedFailedSkipped
✅ nextjs-turbopack15400

✅ 📋 Other

AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable128026
✅ e2e-local-dev-tanstack-start-128026
✅ e2e-local-postgres-nest-stable128026
✅ e2e-local-postgres-tanstack-start-128026
✅ e2e-local-prod-nest-stable128026
✅ e2e-local-prod-tanstack-start-128026
✅ e2e-vercel-prod-nest126028
✅ e2e-vercel-prod-tanstack-start126028

✅ vercel-multi-region

AppPassedFailedSkipped
✅ nextjs-turbopack2700

📋 View full workflow run

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit f051d75 · Fri, 24 Jul 2026 20:19:34 GMT · run logs

Backend: vercel · app: nextjs-turbopack

MetricScenarioBest (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep242 (-66%) 💚1342 🔴 (+28%) 🔻1401 🔴 (+31%) 🔻1466 🔴 (+1.8%)30
TTFSstream175 (-82%) 💚1343 🔴 (+31%) 🔻1361 🔴 (+31%) 🔻1594 🔴 (+52%) 🔻30
TTFShook + stream463 (-61%) 💚1541 🔴 (+17%) 🔻1610 🔴 (+16%) 🔻1790 🔴 (+7.1%)30
STSO1020 steps (1-20)189 (+17%) 🔻299 🔴 (+20%) 🔻332 🔴 (+10%)395 🔴 (+30%) 🔻19
STSO1020 steps (101-120)211 (+14%)309 🔴 (+12%)610 🔴 (+87%) 🔻2294 🔴 (+546%) 🔻19
STSO1020 steps (1001-1020)513 (+13%)603 🔴 (+8.8%)624 🔴 (+4.3%)676 🔴 (-18%) 💚19
WO1020 steps416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)1
SLstream latency103 (+37%) 🔻165 🔴 (+36%) 🔻191 🔴 (+38%) 🔻380 🔴 (-55%) 💚30
SOstream overhead (text)124 (+28%) 🔻290 🔴 (+85%) 🔻413 (+112%) 🔻563 (+126%) 🔻30
SOstream overhead (structured)118 (+20%) 🔻225 (+31%) 🔻292 (+18%) 🔻497 (+78%) 🔻30
ℹ️ Metric definitions & methodology

Best/P75/P90/P99 deltas compare against the most recent benchmark run on main at the time of this run. 🔻 flags a delta worse than +15%, 💚 one better than −15%.

Metrics — TTFS: time to first step body (in-deployment start() → first step body, deployment clocks) · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (whole-run time outside step bodies, in-deployment anchored) · SL: stream latency (in-deployment write → read propagation, readAt - writtenAt) · SO: stream overhead (end-to-end write+consume time beyond the modelled generation window)

Scenarios — step: one trivial no-op step, no stream; no hooks, so the run stays in turbo mode (in-process fast path) · stream: one streaming step; no hooks, so the run stays in turbo mode (in-process fast path) · hook + stream: registers a hook before one step, which exits turbo mode (dispatch path) · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges, and WO is the whole-run overhead outside step bodies · stream latency: parallel reader/writer steps on a dedicated stream; SL is the in-deployment write->read propagation (readAt - writtenAt) · stream overhead (text): writer streams 300 variable-length text token deltas paced at 100/s for 3s (a haiku-size LLM's token throughput) while a parallel reader drains the whole stream; SO is the end-to-end write+consume time beyond the 3s generation window (overhead/backpressure) · stream overhead (structured): same workload as stream overhead (text), but each delta is an AI-SDK-style structured object ({ type: 'text-delta', id, text }) instead of a raw string, so the SO gap vs the text scenario is the added serialization cost

🔴 marks a percentile over its target (within target is left unmarked). Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · SO 250/500/1000 · STSO (1-20) 20/30/60 · STSO (101-120) 30/45/90 · STSO (1001-1020) 40/60/120

All metrics are measured from deployment-side timestamps only. Runs are triggered by an in-deployment route that stamps the anchor (clientStart) right before start(), so the CI runner’s request and its path through api.vercel.com sit outside every measured window. TTFS = in-deployment start() → first step body (turbo uses the in-process fast path, non-turbo the dispatch path), and includes the VQS dispatch hop plus any /flow cold start. STSO/WO are measured between step bodies on the deployment. SL is measured inside the workflow (parallel reader/writer steps), so it no longer includes the api.vercel.com read path.

Cold starts are kept in the numbers on purpose — they are part of real bursty-workload latency. The workbench deployment cold-starts the /flow invocation for a large fraction of runs, inflating P75+; the Best column shows the fastest (warm-start) sample for comparison.

@VaguelySeriousVaguelySerious changed the title [release] Exit changeset pre mode for 5.0.0 GA[release] Exit changeset pre mode for v5, tie core and world-vercel versions togetherJul 24, 2026
@VaguelySerious
VaguelySerious marked this pull request as ready for review July 27, 2026 18:39
@VaguelySerious
VaguelySerious requested review from a team and ijjk as code ownersJuly 27, 2026 18:39
Sign up for freeto 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.

1 participant

@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); [release] Exit changeset pre mode for v5, tie core and world-vercel versions together by VaguelySerious · Pull Request #3090 · vercel/workflow · GitHub
Skip to content

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together - #3090

Open
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga
Open

[release] Exit changeset pre mode for v5, tie core and world-vercel versions together#3090
VaguelySerious wants to merge 1 commit into
mainfrom
peter/exit-pre-mode-5-ga

Conversation

@VaguelySerious

@VaguelySeriousVaguelySerious commented Jul 24, 2026

Copy link
Copy Markdown
Member

Prep for the 5.0.0 GA release. Draft on purpose — merging this arms the GA publish.

  1. Exits changesets pre-release mode (.changeset/pre.json"mode": "exit"). The next Release run on main opens a plain "Version Packages" PR; merging that one publishes 5.0.0 to the latest dist-tag.
  2. Adds @workflow/world-vercel to the fixed group with workflow and @workflow/core. @workflow/world-vercel does not depend on @workflow/core, so nothing kept them aligned before — the Vercel adapter drifted to 5.0.0-beta.32 while core was at 5.0.0-beta.36. From 5.0.0 on, the adapter version is the SDK version.
  3. Derives the GitHub Release flags from the published version, not the branch.main was hardcoded to --prerelease=true --latest=false, which would have marked the 5.0.0 release as a prerelease. Now any version with a prerelease identifier is a prerelease on any branch, and the "Latest" marker follows the GA line on main.
  4. Updates the release-strategy section of AGENTS.md to match.

Verification

Dry-ran the whole thing in a scratch worktree off origin/main (changeset pre exit + changeset version over all 439 pending changesets):

  • All 26 public packages land on exactly 5.0.0 — including @workflow/ai, @workflow/serde, @workflow/utils, and the worlds, which were on trailing beta numbers. The check-release-major.js guard (RELEASE_VERSION: 5) passes.
  • Fixed group works: after that run, a changeset touching only @workflow/core bumps @workflow/core, workflowand@workflow/world-vercel to 5.0.1 together.
  • Release-flag logic checked against workflow@5.0.0 on main (--prerelease=false --latest), workflow@4.2.1 on stable (--prerelease=false --latest=false), and workflow@5.1.0-beta.1 / workflow@6.0.0-rc.2 on main (--prerelease=true --latest=false).

Required companion change on stable

stable is not in pre mode and no package sets publishConfig.tag, so once main leaves pre mode both branches publish to latest — the next 4.x patch would move latest back to 4.x. Companion PR against stable pins ci:publish to changeset publish --tag previous (and mirrors the release-flag change); it needs to land before or alongside this one. The tag is previous rather than v4 because npm rejects tag names that parse as a semver range.

Trade-off worth knowing

The fixed group means a @workflow/world-vercel-only fix now also republishes workflow and @workflow/core (and their dependents), and a core-only fix produces an empty ## X.Y.Z section in the world-vercel changelog. That's the cost of guaranteed alignment.

Take `main` out of changesets pre-release mode so the next "Version
Packages" PR publishes 5.0.0 to the `latest` dist-tag instead of another
`5.0.0-beta.N`.
Also add `@workflow/world-vercel` to the `workflow` / `@workflow/core`
fixed group, so the Vercel adapter carries the same version as the SDK
from 5.0.0 onward, and derive the GitHub Release prerelease/latest flags
from the published version rather than the branch name.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

@changeset-bot

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: f051d75

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 46 packages
NameType
@workflow/example-astroPatch
@workflow/example-appPatch
@workflow/example-expressPatch
@workflow/example-fastifyPatch
@workflow/example-honoPatch
@workflow/example-nestPatch
nextjs-turbopackPatch
nextjs-webpackPatch
@workflow/example-nitro-v2Patch
@workflow/example-nitroPatch
@workflow/example-nuxtPatch
@workflow/example-sveltekitPatch
workflow-sdk-compiler-playgroundPatch
@workflow/example-tanstack-startPatch
@workflow/example-vitePatch
@workflow/vitest-workbenchPatch
@workflow/aiPatch
@workflow/astroPatch
@workflow/buildersPatch
@workflow/cliPatch
@workflow/corePatch
@workflow/docs-typecheckPatch
@workflow/errorsPatch
@workflow/nestPatch
@workflow/nextPatch
@workflow/nitroPatch
@workflow/nuxtPatch
@workflow/rollupPatch
@workflow/serdePatch
@workflow/sveltekitPatch
@workflow/swc-pluginPatch
@workflow/tsconfigPatch
@workflow/typescript-pluginPatch
@workflow/utilsPatch
@workflow/vitePatch
@workflow/vitestPatch
@workflow/web-sharedPatch
@workflow/webPatch
workflowPatch
@workflow/world-localPatch
@workflow/world-postgresPatch
@workflow/world-testingPatch
@workflow/world-vercelPatch
@workflow/worldPatch
docsPatch
tarballsPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

E2E Test Summary

Summary
PassedFailedSkippedTotal
✅ ▲ Vercel Production145502391694
✅ 💻 Local Development162102271848
✅ 📦 Local Production162102271848
✅ 🐘 Local Postgres162102271848
✅ 🪟 Windows15400154
✅ 📋 Other102002121232
✅ vercel-multi-region270027
Total7519011328651
Details by Category

✅ ▲ Vercel Production

AppPassedFailedSkipped
✅ astro126028
✅ example126028
✅ express126028
✅ fastify126028
✅ hono126028
✅ nextjs-turbopack15103
✅ nextjs-webpack15103
✅ nitro126028
✅ nuxt126028
✅ sveltekit14509
✅ vite126028

✅ 💻 Local Development

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 📦 Local Production

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🐘 Local Postgres

AppPassedFailedSkipped
✅ astro-stable128026
✅ express-stable128026
✅ fastify-stable128026
✅ hono-stable128026
✅ nextjs-turbopack-canary135019
✅ nextjs-turbopack-stable15400
✅ nextjs-webpack-canary135019
✅ nextjs-webpack-stable15400
✅ nitro-stable128026
✅ nuxt-stable128026
✅ sveltekit-stable14707
✅ vite-stable128026

✅ 🪟 Windows

AppPassedFailedSkipped
✅ nextjs-turbopack15400

✅ 📋 Other

AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable128026
✅ e2e-local-dev-tanstack-start-128026
✅ e2e-local-postgres-nest-stable128026
✅ e2e-local-postgres-tanstack-start-128026
✅ e2e-local-prod-nest-stable128026
✅ e2e-local-prod-tanstack-start-128026
✅ e2e-vercel-prod-nest126028
✅ e2e-vercel-prod-tanstack-start126028

✅ vercel-multi-region

AppPassedFailedSkipped
✅ nextjs-turbopack2700

📋 View full workflow run

@github-actions

github-actionsBot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit f051d75 · Fri, 24 Jul 2026 20:19:34 GMT · run logs

Backend: vercel · app: nextjs-turbopack

MetricScenarioBest (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep242 (-66%) 💚1342 🔴 (+28%) 🔻1401 🔴 (+31%) 🔻1466 🔴 (+1.8%)30
TTFSstream175 (-82%) 💚1343 🔴 (+31%) 🔻1361 🔴 (+31%) 🔻1594 🔴 (+52%) 🔻30
TTFShook + stream463 (-61%) 💚1541 🔴 (+17%) 🔻1610 🔴 (+16%) 🔻1790 🔴 (+7.1%)30
STSO1020 steps (1-20)189 (+17%) 🔻299 🔴 (+20%) 🔻332 🔴 (+10%)395 🔴 (+30%) 🔻19
STSO1020 steps (101-120)211 (+14%)309 🔴 (+12%)610 🔴 (+87%) 🔻2294 🔴 (+546%) 🔻19
STSO1020 steps (1001-1020)513 (+13%)603 🔴 (+8.8%)624 🔴 (+4.3%)676 🔴 (-18%) 💚19
WO1020 steps416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)416833 (+9.0%)1
SLstream latency103 (+37%) 🔻165 🔴 (+36%) 🔻191 🔴 (+38%) 🔻380 🔴 (-55%) 💚30
SOstream overhead (text)124 (+28%) 🔻290 🔴 (+85%) 🔻413 (+112%) 🔻563 (+126%) 🔻30
SOstream overhead (structured)118 (+20%) 🔻225 (+31%) 🔻292 (+18%) 🔻497 (+78%) 🔻30
ℹ️ Metric definitions & methodology

Best/P75/P90/P99 deltas compare against the most recent benchmark run on main at the time of this run. 🔻 flags a delta worse than +15%, 💚 one better than −15%.

Metrics — TTFS: time to first step body (in-deployment start() → first step body, deployment clocks) · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (whole-run time outside step bodies, in-deployment anchored) · SL: stream latency (in-deployment write → read propagation, readAt - writtenAt) · SO: stream overhead (end-to-end write+consume time beyond the modelled generation window)

Scenarios — step: one trivial no-op step, no stream; no hooks, so the run stays in turbo mode (in-process fast path) · stream: one streaming step; no hooks, so the run stays in turbo mode (in-process fast path) · hook + stream: registers a hook before one step, which exits turbo mode (dispatch path) · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges, and WO is the whole-run overhead outside step bodies · stream latency: parallel reader/writer steps on a dedicated stream; SL is the in-deployment write->read propagation (readAt - writtenAt) · stream overhead (text): writer streams 300 variable-length text token deltas paced at 100/s for 3s (a haiku-size LLM's token throughput) while a parallel reader drains the whole stream; SO is the end-to-end write+consume time beyond the 3s generation window (overhead/backpressure) · stream overhead (structured): same workload as stream overhead (text), but each delta is an AI-SDK-style structured object ({ type: 'text-delta', id, text }) instead of a raw string, so the SO gap vs the text scenario is the added serialization cost

🔴 marks a percentile over its target (within target is left unmarked). Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · SO 250/500/1000 · STSO (1-20) 20/30/60 · STSO (101-120) 30/45/90 · STSO (1001-1020) 40/60/120

All metrics are measured from deployment-side timestamps only. Runs are triggered by an in-deployment route that stamps the anchor (clientStart) right before start(), so the CI runner’s request and its path through api.vercel.com sit outside every measured window. TTFS = in-deployment start() → first step body (turbo uses the in-process fast path, non-turbo the dispatch path), and includes the VQS dispatch hop plus any /flow cold start. STSO/WO are measured between step bodies on the deployment. SL is measured inside the workflow (parallel reader/writer steps), so it no longer includes the api.vercel.com read path.

Cold starts are kept in the numbers on purpose — they are part of real bursty-workload latency. The workbench deployment cold-starts the /flow invocation for a large fraction of runs, inflating P75+; the Best column shows the fastest (warm-start) sample for comparison.

@VaguelySeriousVaguelySerious changed the title [release] Exit changeset pre mode for 5.0.0 GA[release] Exit changeset pre mode for v5, tie core and world-vercel versions togetherJul 24, 2026
@VaguelySerious
VaguelySerious marked this pull request as ready for review July 27, 2026 18:39
@VaguelySerious
VaguelySerious requested review from a team and ijjk as code ownersJuly 27, 2026 18:39
Sign up for freeto 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.

1 participant

@VaguelySerious