Skip to content

Preview Workflow 2.21 platform support and upgrade guidance - #482

Closed
rmcdaniel wants to merge 1 commit into
mainfrom
docs/481-workflow-2.21-support
Closed

rmcdaniel wants to merge 1 commit into
mainfrom
docs/481-workflow-2.21-support

Conversation

@rmcdaniel

@rmcdaniel rmcdaniel commented Nov 5, 2026 •

Copy link
Copy Markdown
Member

The published embedded requirements and the planned 2.21 support change need distinct guidance. This draft updates installation, compatibility, Laravel adoption and v1 migration in English and all seven offered translations. It corrects stale Laravel 9 destination claims against the actual published 2.20.4 manifest, shows the unreleased PHP ^8.2 / Laravel ^12.69.0|^13.30.0 boundary, and explains upgrading the application platform first while keeping its existing 2.20.x lock. Laravel 13 still needs PHP 8.3+. No schema/history/protocol migration is introduced by this support change.

The bare PHP SDK keeps its independent PHP ^8.1 requirement; its Laravel bridge follows its own published authority. All executable examples, stable-v1 files, runtime/protocol manifests, current release selectors and installers are unchanged. The seven existing translation review files cover the four changed guides. No new flag/version-selection system or prose-assertion tests are added.

Draft / producer dependency: Workflow #1047 is source-merged at 3d7d0a193d8fffe591f8286d1c4d5499120a297a; 2.21 is not yet tagged/published or Release-Verified. Packagist currently selects 2.20.4 (e3664430), with PHP ^8.1 / Laravel 10–13. The docs selector remains 2.20.3, whose platform range is unchanged. Keep this PR unmerged and auto-merge off until Workflow #1020 returns the actual 2.21 package/manifest and Release Verification, then refresh the preview/selector/current floor normally. SDK #239 owns its separate coordinated bridge update. No installed/runtime proof is inferred from source.

Validation: local whitespace/public-boundary and changed-file secret-format checks pass; all 32 guide edits preserve every executable fence, and only the four intended entries change in each translation review file. All 11 exact-head contexts pass. Canonical Node 24 qualification 42107841622 built all eight locales and passed links, translation contracts and existing source checks. Direct exact-head Sonar reports zero unresolved issues/hotspots. Local Node is 22, so no unsupported full-build result is claimed.

Automatic follower boundary: pull requests run ordinary source checks; Pages publishes only on main. A later merge must consume the real producer handoff before changing the live/current floor and then receive normal actual-main/Pages/artifact/live verification. This draft invokes no producer build/release, Composer install, runtime or provider action. Docs owns source findings and final delivery/cleanup; Workflow owns published authority and SDK PHP its bridge contract.

Refs #481. Scoped inventory and owner actions.

@sonarqubecloud

sonarqubecloud Bot commented Nov 5, 2026

Copy link
Copy Markdown

@rmcdaniel

rmcdaniel commented Nov 5, 2026 •

Copy link
Copy Markdown
Member Author

Source qualification is preserved for draft#482 at 1a17b2c61872324416d3d0413b75ca402fff27d9 / tree 096d37bc783f317d690ee4d0661871a7b41fc174, original base e0a600a1. All11 original contexts passed; Node24 built all eight locales, four guides/all seven translated counterparts were reviewed, and source Sonar had zero introduced issues. Examples, versioned1.x, selected installers/manifests and protocol authority are byte-preserved.

Next action / owner, audited2026-11-06 04:14 UTC: Workflow#1020 must return the actual published2.21 manifest/package + successful Release Verification, coordinated by General. Fresh latest GitHub Release is still2.20.4; the release handoff has not arrived. I renewed that exact request to Workflow without asking for another build/tag/release. SDK#239's independent bare-PHP/framework-bridge authority is preserved. Until that evidence, the draft stays unmerged/auto-off under#481's explicit live-floor gate.

Independent main One Identity#483 is now complete at acaca37a, including actual live status, with no guide/floor/selector change. Its acceptance does not requalify this old-head merge ref. Docs owns final normal maintained-base refresh/new exact-head checks, Pages/live acceptance and cleanup after the producer handoff; no force push or source-only release inference is used.

Post-#486 audit, 2026-11-06 06:20 UTC: fresh latest GitHub Release remains Workflow 2.20.4. The outstanding Workflow owner request is unchanged: return the actual published 2.21 manifest/package plus successful Release Verification on Workflow#1020. Docs completed the unrelated CI lifecycle fix at accepted main add401ee966c8359773066f410321914779190fd; all 10,087 generated files and 15 live reads preserve the prior site, including floors/selectors/installers. This draft and its exact head remain unchanged/unmerged/auto-off. Docs owns the final normal maintained-base refresh and new exact-head/Pages/live qualification after that actual producer handoff. No repeat producer run, release or speculative update is requested.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Superseded by #489, which merged the published Workflow 2.21 platform guidance (3317fee).

@rmcdaniel rmcdaniel closed this Nov 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent:durable-workflow-github-io status:blocked Waiting on a named dependency or decision

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant