Skip to content

[docs] Fill gaps in the dynamic workflows concept page - #4550

Merged
alangenfeld merged 3 commits into
alangenfeld/workflow-dynamic-workflows-cookbookfrom
alangenfeld/dynamic-workflows-concept-docs
Oct 2, 2026
Merged

alangenfeld merged 3 commits into
alangenfeld/workflow-dynamic-workflows-cookbookfrom
alangenfeld/dynamic-workflows-concept-docs

Conversation

@alangenfeld

@alangenfeld alangenfeld commented Oct 1, 2026 •

Copy link
Copy Markdown
Collaborator

Summary & Motivation

Fills gaps the 5.0.0 dogfood surfaced on the dynamic workflows concept page: a table of the per-gate refusals and which of them are fatal, how a Vercel project gets dynamic-source storage, what the 2,048-byte execution-context budget actually buys, that the workflow ID hashes raw source bytes, and that "trusted" means reviewed application code rather than anything a model did not write.

Stacked on #4541, which adds the cookbook recipe this page now links to.

Test Plan

Docs only. Links, anchors, quoted error messages, and the fatal/retryable behavior were checked by hand against the runtime source on main.

#4534 (open) edits this page's exportName rule. This PR leaves that line alone, quotes only the stable prefix of the execution-context error that #4534 extends, and does not document #4534's validation messages.

Docs Preview

Page Link
Dynamic workflows /docs/advanced/dynamic-workflows
Errors for each gate #errors-for-each-gate
Enabling storage on Vercel #enabling-storage-on-vercel

@vercel

vercel Bot commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
example-nextjs-workflow-turbopack Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
example-nextjs-workflow-webpack Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
example-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workbench-astro-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workbench-express-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workbench-fastify-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workbench-hono-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workbench-nestjs-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workbench-nitro-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workbench-nuxt-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workbench-python-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workbench-sveltekit-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workbench-tanstack-start-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workbench-vite-workflow Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workflow-docs Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workflow-swc-playground Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workflow-tarballs Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC
workflow-web Ready Ready Preview, v0 Oct 1, 2026 9:16pm UTC

@changeset-bot

changeset-bot Bot commented Oct 1, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 33e7dc3

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

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

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-actions Bot commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

Sim World

Simulated world deterministic testing for races. Traces

🟠 world-sim scenario book — 1 fail of 42 total

fence=per-spec

scenario outcome events virt replay violations
✅ smoke-no-steps completed 3 0ms ok 0
✅ smoke-one-step completed 6 0ms ok 0
✅ hook-at-step-started completed 12 0ms ok 0
✅ hook-at-step-completed completed 12 0ms ok 0
✅ hook-at-hook-created completed 12 0ms ok 0
✅ deadline-hook-wins completed 7 1.0h ok 0
✅ deadline-expires completed 7 1.0h ok 0
✅ step-vs-timer-early-settlement completed 8 1.0h ok 0
✅ long-sleep completed 11 30.0d ok 0
✅ hook-never-arrives stalled 3 0ms skipped 0
✅ step-retries-twice completed 10 2.0s ok 0
✅ parallel-steps completed 9 0ms ok 0
✅ hook-on-execution-state completed 12 0ms ok 0
✅ peek-hook-before-branch completed 12 0ms ok 0
✅ peek-hook-after-branch completed 12 0ms ok 0
✅ peek-hook-at-registration completed 12 0ms ok 0
✅ race-hook-before-probe completed 12 0ms ok 0
✅ race-hook-after-probe completed 12 0ms ok 0
✅ race-duplicate-delivery completed 13 0ms ok 0
✅ attr-hook-before-step completed 11 0ms ok 0
✅ attr-hook-after-step completed 11 0ms ok 0
✅ attr-from-step-body completed 13 0ms ok 0
✅ fork-hook-after-timeout completed 14 1.0m ok 0
✅ fork-hook-before-timeout completed 14 1.0m ok 0
✅ count-hook-after-timeout completed 17 1.0m ok 0
✅ count-hook-before-timeout completed 20 1.0m ok 0
✅ stale-read-step-count-fork completed 20 1.0m ok 0
✅ stale-read-equal-step-counts completed 14 1.0m ok 0
✅ step-vs-step-fork completed 12 0ms ok 0
✅ step-vs-step-fork-fenced completed 12 0ms ok 0
✅ fence-catches-benign-direction completed 12 5ms ok 0
✅ in-flight-before-decision completed 17 1.0m ok 0
❌ in-flight-before-decision-counted completed 17 1.0m ok 0
✅ in-flight-after-decision completed 19 2.0m ok 0
✅ stale-read-step-count-fork-fenced completed 20 1.0m ok 0
✅ fork-hook-wins completed 13 1.0m ok 0
✅ fork-timeout-wins completed 13 1.0m ok 0
✅ unclaimed-payload-under-fork completed 17 1.0m ok 0
✅ claimed-payload-under-fork completed 17 1.0m ok 0
✅ writers-independent-step-bodies completed 12 0ms ok 0
✅ writers-scripted-tempo completed 12 0ms ok 0
✅ cancel-mid-step cancelled 7 0ms skipped 0

Full trace: world-sim.txt

Comment thread docs/content/docs/v5/advanced/dynamic-workflows.mdx

@vercel vercel Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Additional Suggestion:

A generated TypeScript incremental build cache (workbench/example/tsconfig.tsbuildinfo) was accidentally committed as a tracked file and is not git-ignored.

Fix on Vercel

@alangenfeld
alangenfeld force-pushed the alangenfeld/dynamic-workflows-concept-docs branch from 9b1adb6 to 54bb4bb Compare October 1, 2026 19:53
@vercel
vercel Bot temporarily deployed to Preview – workflow-docs October 1, 2026 19:54 Inactive
@alangenfeld
alangenfeld marked this pull request as ready for review October 1, 2026 21:01
@alangenfeld
alangenfeld requested a review from a team as a code owner October 1, 2026 21:01
@alangenfeld
alangenfeld force-pushed the alangenfeld/dynamic-workflows-concept-docs branch from 54bb4bb to abeaabf Compare October 1, 2026 21:06
@alangenfeld
alangenfeld force-pushed the alangenfeld/dynamic-workflows-concept-docs branch from abeaabf to c43f36c Compare October 1, 2026 21:10
Signed-off-by: Alex Langenfeld <alex.langenfeld@vercel.com>
Signed-off-by: Alex Langenfeld <alex.langenfeld@vercel.com>
Signed-off-by: Alex Langenfeld <alex.langenfeld@vercel.com>
@alangenfeld
alangenfeld merged commit 8943673 into alangenfeld/workflow-dynamic-workflows-cookbook Oct 2, 2026
55 of 56 checks passed
@alangenfeld
alangenfeld deleted the alangenfeld/dynamic-workflows-concept-docs branch October 2, 2026 19:42
alangenfeld added a commit that referenced this pull request Oct 2, 2026
## Summary & Motivation

Fills gaps the 5.0.0 dogfood surfaced on the dynamic workflows concept
page: a table of the per-gate refusals and which of them are fatal, how
a Vercel project gets dynamic-source storage, what the 2,048-byte
execution-context budget actually buys, that the workflow ID hashes raw
source bytes, and that "trusted" means reviewed application code rather
than anything a model did not write.

Stacked on #4541, which adds the cookbook recipe this page now links to.

## Test Plan

Docs only. Links, anchors, quoted error messages, and the
fatal/retryable behavior were checked by hand against the runtime source
on main.

#4534 (open) edits this page's `exportName` rule. This PR leaves that
line alone, quotes only the stable prefix of the execution-context error
that #4534 extends, and does not document #4534's validation messages.

## Docs Preview

| Page | Link |
| --- | --- |
| Dynamic workflows |
[/docs/advanced/dynamic-workflows](https://workflow-docs-rakhde7hj.vercel.sh/docs/advanced/dynamic-workflows)
|
| Errors for each gate |
[#errors-for-each-gate](https://workflow-docs-rakhde7hj.vercel.sh/docs/advanced/dynamic-workflows#errors-for-each-gate)
|
| Enabling storage on Vercel |
[#enabling-storage-on-vercel](https://workflow-docs-rakhde7hj.vercel.sh/docs/advanced/dynamic-workflows#enabling-storage-on-vercel)
|

---------

Signed-off-by: Alex Langenfeld <alex.langenfeld@vercel.com>

This branch was successfully deployed

1 active deployment
Preview – workflow-docs — 33e7dc3d Deployed Oct 1, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants