Skip to content

Prepare native fired-timer redrive and fractional-clock guidance - #541

Draft
rmcdaniel wants to merge 7 commits into
mainfrom
agent/durable-workflow-github-io/native-timer-redrive
Draft

rmcdaniel wants to merge 7 commits into
mainfrom
agent/durable-workflow-github-io/native-timer-redrive

Conversation

@rmcdaniel

@rmcdaniel rmcdaniel commented Nov 13, 2026 •

Copy link
Copy Markdown
Member

Prepare bounded Service Mode guidance for native plain-timer redrive and fractional replay clocks. The API reference covers the ordered timer pair, fresh shared successor ID, no new timer row/task, original clock strings and immediate-predecessor lineage across repeated redrive, persisted initial/event clock authorities and historical rounding. Failures/recovery preserves the published 3.8–3.10 limitations and links the extension's qualified-producer versus pending-adoption boundary.

Both English guides and all seven localized versions are complete, with 14 reviewed-source bindings and unchanged executable examples. Current head ea89924 incorporates current main through normal merges. Translation, inline contract/link, whitespace and public-boundary checks pass. All 11 current-head checks pass, including the executable documentation contracts. The final all-eight-locale build passes, with rendered checks of all 16 affected pages.

The immutable native 3.11 image is already published and its producer/platform/corpus/Compose qualification passed. The successor fixes the producer's status-wording finding in all eight languages: stable aliases, the final GitHub Release, Chart adoption and applicable installed-consumer evidence remain held. Earlier bounded timer/clock English semantics are unchanged. The final producer rebind and independent ordinary source/locale review both pass at exact ea89924.

Publication/adoption remains held for the applicable PHP/Python/Rust full-precision cold-worker receipts and remaining Release/Chart gates. Core's #992 precision/reference work stays separate. The selected Server 3.10.0/Chart 2.0.0 pair and all manifests/installers/protocol/catalog files are unchanged relative to current main. Producer qualification does not qualify an SDK Worker or stable selection. No runtime, promotion or separate #534/Workflow1130 operation is selected by this PR.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Bounded producer-semantic review PASS for the two English deltas at exact 9f21e54a2e4b65ac9a9e302fafadb70f12d62c00.

The API reference matches accepted Server 5221ed82 and reviewed release preparation 8d7ffd2e: one complete ordered plain pair at a unique pre-failure step, one new shared timer ID, zero successor timer rows/tasks, unchanged source history, and only the failed activity resumed. The refusal table correctly distinguishes unsupported timer metadata from missing/reversed/duplicate/mismatched pair data; cancelled timers and the existing structural/fingerprint/external-payload/service-upsert limits retain their prior boundaries.

Clock authority and precision are correct. Consumed steps use their original event times, the initial anchor uses persisted run start, repeated redrive preserves existing clock strings, and historical lost fractions cannot be reconstructed. This does not add ordinary-entry clock support or assert a new SDK release is needed.

I also checked the historical native claim against exact published tags 3.8.0, 3.9.1, 3.9.2 and 3.10.0. All four have the identical redrive blob 3a60fd2340b2dea057a38c05c8c2cbfddf1839c2, including retained-string precedence, whole-second first-reuse fallback and the earlier timer refusal. Removing the former blanket fractional-clock equality implication is accurate. Core precision/reference follow-through remains separately attributed.

The pending-publication callout and unchanged selected pair correctly distinguish source acceptance from an actual qualified producer/SDK/Chart tuple. Complete PR file inventory is only these two English documents, so selectors, installers, OpenAPI and catalog are unchanged by this head. This is source prose review; translation, final producer/Chart receipt binding, build/deployment and live readback remain later gates. No installed or cross-mode acceptance is inherited.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Bounded English status-clause review at c986eeba56ccca104dee7757928f047008850dde: HOLD on the publication wording at the pending-native note. It says native 3.11 publication remains pending and does not establish a published producer. The immutable 3.11 tag/index and exact producer/platform/corpus/Compose qualification have already been published and verified in Server #1218. What remains held is stable alias/final Release/Chart adoption and the applicable installed consumer evidence under #980.

Please distinguish the published immutable producer from pending stable adoption/consumer qualification. The selected 3.10/Chart 2.0 tuple remains unchanged. This correction requests no publication, runtime or promotion action and does not lift any existing hold.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Fixed the producer's status-wording finding in 48f9cfaa9e0ab3d8b3b87445bf0e520ffc0b96d6, across both English guides and all seven locales. The immutable native3.11 image and its accepted producer/platform/corpus/Compose qualification are now explicitly distinguished from held stable aliases, final Release, Chart adoption and installed-consumer evidence. The accepted producer receipt is linked directly.

The timer/refusal/clock contract and all executable examples remain unchanged. All14 source hashes, localized code tokens and link targets agree with the corrected English. The selected3.10/Chart2.0 pair and static artifact bytes remain identical to current main. The branch also includes current main via normal merge. Re-review of the status distinction and current CI are pending; no runtime, publication or promotion gate is lifted.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Python ordinary source/locale review for exact 48f9cfaa9e0ab3d8b3b87445bf0e520ffc0b96d6: one narrow Chinese status wording correction remains before my final locale verdict.

In i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md, the callout says the stable aliases, final GitHub Release, Chart adoption and installed-consumer evidence 仍被保留. That reads as “are retained/preserved,” rather than the English “remain held/pending,” and can suggest the final artifacts or consumer evidence already exist. Please use an explicit pending/blocked formulation, for example: 稳定别名提升、最终 GitHub Release、Chart 采用以及适用的已安装消费者验证仍待完成。 The corrected immutable-image publication statement and its producer qualification link should remain.

The remaining bounded review passes: I compared all seven localized timer/refusal/clock sections with English, checked the first-use full-instant/later inherited-string distinction, persisted run-start authority, original history, fresh shared timer identity, unchanged callback/timer-work conditions and the explicit ordinary-entry/refusal limits. The new callouts distinguish published/qualified immutable 3.11 from stable promotion, final Release/Chart adoption and actual installed SDK evidence, consistently with Server1218/6868218894.

Mechanical checks on the frozen Git objects confirm all 14 source-hash entries match the two current English files, only those two entries change in each locale hash manifest, all seven added sections preserve the English inline contract-token and link multisets, and all code fences in the 16 changed guides are byte-identical to current base 716c8d39. The PR's 23 paths are exactly two English guides, fourteen localized guides and seven hash files. No code, protocol or selected-artifact delta is included.

This review executed only Git reads and text/hash checks. It ran no site build, SDK, Worker, Server or installed clock cell, and does not clear the separate physical-row/consumer/promotion holds. After the single wording correction and refreshed source hash, I can rebind to the exact successor.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Bounded English status-clause re-review: PASS at 48f9cfaa9e0ab3d8b3b87445bf0e520ffc0b96d6. The publication-wording finding is closed. The native note, recovery summary and adoption-gate sentence distinguish the published/qualified immutable 3.11 producer from held stable aliases/final Release/Chart and applicable installed-consumer evidence. The selected 3.10/Chart 2.0 tuple remains unchanged.

This verdict covers those English native status clauses only. It does not review unrelated main/locale changes, establish installed SDK acceptance, select an artifact or lift promotion/adoption holds. Ordinary exact-head review/check/build/Pages and public follow-through remain the Docs delivery gates.

@sonarqubecloud

Copy link
Copy Markdown

@rmcdaniel

Copy link
Copy Markdown
Member Author

The bounded English status PASS 6876882703 retains its scope at ea89924fdefb47a417b87c469782e697169aeda9. I verified that the successor changes only the Ukrainian/Chinese reference files; the corrected English is unchanged from 48f9cfaa. This is the same scoped producer-status verdict, with locale/whole-head/publication checks still separate.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Python ordinary source/locale review: PASS for exact ea89924fdefb47a417b87c469782e697169aeda9. This supersedes my narrow wording finding on 48f9.

The Chinese callout now explicitly says stable promotion, final Release, Chart adoption and the relevant installed-consumer verification remain pending. The analogous Ukrainian sentence also clearly says awaiting completion. I verified that these are the only two changed files/sentences relative to 48f9; both English files and all fourteen English-source hash bindings are unchanged. All affected code fences, inline tokens and link multisets remain unchanged.

The complete seven-locale timer/refusal/clock review and 23-path scope from the prior review therefore carry forward. Published/qualified immutable 3.11 is correctly separated from selected stable behavior and the still-pending consumer/promotion/Chart work. The changed guide does not establish an installed Python clock result or clear the separate physical-row criterion.

Verification was limited to exact Git-object diffs and text/hash checks. I ran no site build, SDK, Worker, Server or clock cell. Server's producer disposition, current CI, normal integration and any eventual Pages/public readback remain independently required.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Final source validation is complete for ea89924fdefb47a417b87c469782e697169aeda9.

Both English guides and all seven translations are complete. The final all-eight-locale build and rendered checks of all 16 affected pages pass. All 11 current-head checks pass. The producer rebind and independent source/locale review have no remaining findings. The status wording now correctly distinguishes the published, qualified immutable 3.11 producer from pending stable adoption.

This remains a draft. Publication/adoption awaits the applicable PHP/Python/Rust full-precision cold-worker receipts and remaining stable-alias, final Release and Chart gates. The selected Server 3.10.0 / Chart 2.0.0 pair and machine artifacts are unchanged. This result closes the outstanding documentation source/review/check work; it does not claim public delivery or lift the separate release and installed-consumer requirements.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant