Skip to content

docs: catch up docs with runs.list status arrays, Nest defaults, and attribute limits - #4206

Merged
pranaygp merged 1 commit into
mainfrom
workflow-docs-cleanup-sept-16
Sep 16, 2026
Merged

pranaygp merged 1 commit into
mainfrom
workflow-docs-cleanup-sept-16

Conversation

@pranaygp

@pranaygp pranaygp commented Sep 16, 2026 •

Copy link
Copy Markdown
Contributor

Description

Docs cleanup for functionality that merged in the last day without (complete) docs changes:

  • runs.list({ status }) accepts an array (Allow runs.list({ status }) to accept an array #3707): the runs.list() reference table now lists workflowName and status, including array/any-match and empty-array semantics and the world-vercel single-status restriction. The World authoring guide gets a matching "Run listing" implementation note. Also adds the missing pending status to the WorkflowRun type table.
  • NestJS preloadBundles default ([nest] Harden the NestJS integration for production #3695): the reference, getting-started page, and @workflow/nest README said true; the code defaults to false when VERCEL is set. Also clarifies the skipBuild default in the getting-started config sample.
  • 8KiB attr_set write limit ([core] Enforce the 8KiB attribute event-data limit before writes #4082): the limit was documented on the setAttributes reference page only; the attributes observability guide now mentions it next to the other attribute limits.

Docs Preview

Page v5 preview
World SDK › Storage › runs.list() https://workflow-docs-git-workflow-docs-cleanup-sept-16.vercel.sh/v5/docs/api-reference/workflow-runtime/world/storage#runslist
Building a World › Key implementation details https://workflow-docs-git-workflow-docs-cleanup-sept-16.vercel.sh/v5/worlds/building-a-world#key-implementation-details
WorkflowModule › WorkflowModuleOptions https://workflow-docs-git-workflow-docs-cleanup-sept-16.vercel.sh/v5/docs/api-reference/workflow-nest/workflow-module#workflowmoduleoptions
Getting started › NestJS › Configuration options https://workflow-docs-git-workflow-docs-cleanup-sept-16.vercel.sh/v5/docs/getting-started/nestjs#configuration-options
Observability › Attributes › Usage https://workflow-docs-git-workflow-docs-cleanup-sept-16.vercel.sh/v5/docs/observability/attributes#usage

All edits are v5-only (@workflow/world 4.x still takes a single status, and the Nest options are new in 5.x), so there are no v4 pages to compare.

How did you test your changes?

Docs-only. pnpm test:docs in packages/docs-typecheck passes for every edited page (remaining local failures are pre-existing @workflow/vitest/world-sim samples that need those packages built), and the Docs Code Samples / Docs Links / Docs Preview Smoke Checks CI jobs are green. Verified each section above renders on the preview deployment.

PR Checklist - Required to merge

  • 📦 pnpm changeset was run to create a changelog for this PR (patch for @workflow/nest, whose README changed)
  • 🔒 DCO sign-off passes (run git commit --signoff on your commits)
  • 📝 Ping @vercel/workflow in a comment once the PR is ready, and the above checklist is complete

🤖 Generated with Claude Code

…attribute limits

Document the array form of `runs.list({ status })` (#3707) in the World
storage reference and the World authoring guide, correct the `preloadBundles`
default for `WorkflowModule` on Vercel (#3695), and surface the 8KiB
`attr_set` write limit (#4082) on the attributes guide.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Signed-off-by: Pranay Prakash <1797812+pranaygp@users.noreply.github.com>

Co-Authored-By: Pranay Prakash <1797812+pranaygp@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings September 16, 2026 17:53
@pranaygp
pranaygp requested a review from a team as a code owner September 16, 2026 17:53
@changeset-bot

changeset-bot Bot commented Sep 16, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 2331b7b

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

This PR includes changesets to release 16 packages
Name Type
@workflow/nest Patch
workflow Patch
@workflow/world-testing Patch
@workflow/core Patch
@workflow/builders Patch
@workflow/cli Patch
@workflow/next Patch
@workflow/nitro Patch
@workflow/vitest Patch
@workflow/web-shared Patch
@workflow/web Patch
@workflow/astro Patch
@workflow/rollup Patch
@workflow/sveltekit Patch
@workflow/vite Patch
@workflow/nuxt Patch

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

Copilot AI 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.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@vercel

vercel Bot commented Sep 16, 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 Sep 16, 2026 5:57pm UTC
example-nextjs-workflow-webpack Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
example-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workbench-astro-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workbench-express-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workbench-fastify-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workbench-hono-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workbench-nestjs-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workbench-nitro-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workbench-nuxt-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workbench-python-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workbench-sveltekit-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workbench-tanstack-start-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workbench-vite-workflow Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workflow-docs Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workflow-swc-playground Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workflow-tarballs Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC
workflow-web Ready Ready Preview, v0 Sep 16, 2026 5:57pm UTC

@github-actions

Copy link
Copy Markdown
Contributor

Sim World

Simulated world deterministic testing for races. Traces

🟠 world-sim scenario book — 1 fail of 41 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
✅ 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

@pranaygp
pranaygp merged commit 426bdb6 into main Sep 16, 2026
67 checks passed
@pranaygp
pranaygp deleted the workflow-docs-cleanup-sept-16 branch September 16, 2026 18:17
@github-actions

Copy link
Copy Markdown
Contributor

No backport to stable for 426bdb6 (AI decision).

All three doc updates describe behavior that exists only on main: stable's packages/world/src/runs.ts still types runs.list({ status }) as a single WorkflowRunStatus, preloadBundles appears nowhere in stable (the Nest module options are 5.x-only), and the 8KiB attr_set limit is not implemented on stable. Backporting would document nonexistent capabilities on the maintenance line, and two of the touched files (docs/content/docs/v5/getting-started/nestjs.mdx, docs/content/worlds/v5/building-a-world.mdx) do not exist on stable at all.

To override, re-run the Backport to stable workflow manually via workflow_dispatch and paste this commit SHA into the ref input:

426bdb6ab98e08902c4cab4cf9a7e1983add55f6

VaguelySerious added a commit that referenced this pull request Sep 20, 2026
#4206 landed a longer cell for `params.status` on main while this branch carried its own. Adopt main's, so the merge that follows is a fast, conflict-free catch-up.

Co-Authored-By: Peter Wielander <29887157+VaguelySerious@users.noreply.github.com>

This branch was successfully deployed

17 active and 1 inactive deployments
Preview – workflow-swc-playground — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workbench-nuxt-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – example-nextjs-workflow-webpack — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workbench-sveltekit-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workbench-tanstack-start-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workbench-vite-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workbench-astro-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – example-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workbench-nitro-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workbench-hono-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workbench-fastify-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workbench-nestjs-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workbench-express-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workflow-tarballs — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workflow-web — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – example-nextjs-workflow-turbopack — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workbench-python-workflow — 2331b7b2 Deployed Sep 16, 2026 by vercel[bot]
Preview – workflow-docs — 2331b7b2 Deployed Sep 16, 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.

3 participants