Skip to content

Select Workflow 2.26.0 - #517

Merged
rmcdaniel merged 1 commit into
mainfrom
docs/workflow-2.26.0
Nov 12, 2026
Merged

rmcdaniel merged 1 commit into
mainfrom
docs/workflow-2.26.0

Conversation

@rmcdaniel

Copy link
Copy Markdown
Member

Selects Workflow 2.26.0 in static/stable-releases.json and documents what changed.

Release selection

  • artifacts.workflow → 2.26.0 (on Packagist). Compatibility: current embedded line is 2.26, the upgrade contract link points at 2.26.0, and a new 2.25/2.26 section says to run php artisan migrate for the new workflow_child_supervisions table. It also notes that the earlier backfill migrations no longer lock tables and can be rerun if interrupted. Support floors and worker protocol 1.22 are unchanged (checked at the tag).

Workflow 2.26 behavior

  • Child workflows: new "Continue-as-new and open children" section. The continued run takes over supervising open children, the chain's final run applies their parent-close policy, and a handed-on child is retried under its recorded retry policy. The disposition matrix and the "how it works" bullet are updated to match.
  • Continue-as-new: recommends shouldContinueAsNewAtStep() and historyBudgetAtStep() for loops. Both are added to the method table, the workflow API reference and the testing loop example. The older whole-history methods are unchanged.
  • Redrive: a completed child workflow call is now reused and not restarted, and now() after it is the child's original finish time. Adds the refusal reasons unsupported_open_child, unsupported_child_outcome, unsupported_child_workflow, external_child_result_not_supported and unavailable_child_result, the service-run refusal, and rollback guidance.
  • The activity-outcome lock change (workflow PR 1000) is internal and has no doc change.

Pending items

  • PHP SDK activity continuations: they stay off by default, and turning them on currently costs throughput. Under load, runs were 24–49% slower and transactions per workflow doubled (server issue 1078).
  • Search attributes: on native Server, a list query that filters on an unregistered key, including one whose registration was deleted, is refused as not defined. Verified in rust/src/runtime/visibility_query.rs at server tag 3.7.0: the query compiler only accepts built-in columns and keys in search_attribute_definitions.

All seven translations and source hashes are updated. check-doc-translations.js (with DOCS_TRANSLATION_BASE), npm test and check-public-boundary.sh pass locally.

🤖 Generated with Claude Code

Select workflow 2.26.0 in stable-releases.json.

Workflow 2.25 and 2.26 keep the 2.21 support floors and embedded worker
protocol 1.22. Record the 2.26 migration (workflow_child_supervisions),
the non-locking batched backfills in the earlier upgrade migrations, and
point the embedded upgrade contract link at 2.26.0.

- Child workflows: a parent that continues as new hands its open
  children to the continued run; the chain's final run applies their
  parent-close policy, and a handed-on child is still retried.
- Continue-as-new: recommend the replay-stable historyBudgetAtStep() and
  shouldContinueAsNewAtStep() for loops; add them to the workflow API.
- Redrive: reuse of completed child workflow calls, the five new child
  refusal reasons, service-run refusal, and rollback guidance.
- PHP SDK: activity continuations are default-off and currently cost
  throughput (server issue 1078 benchmark).
- Search attributes: native Server refuses filtering on an unregistered
  key as not defined.

All seven translations and source hashes updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@rmcdaniel rmcdaniel added the agent:general Pull request opened by General agent label Nov 12, 2026
@sonarqubecloud

Copy link
Copy Markdown

@rmcdaniel

Copy link
Copy Markdown
Member Author

General: holding the merge until Workflow 2.26.0's published-package release verification passes. It's currently blocked by an upstream PHP asset replacement in the central setup-php-linux action, which is being fixed in durable-workflow/.github. The content is reviewed and ready.

@rmcdaniel
rmcdaniel merged commit 3af4746 into main Nov 12, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent:general Pull request opened by General agent

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant