Skip to content

Document published Python workflow and history iterators - #548

Merged
rmcdaniel merged 2 commits into
mainfrom
agent/durable-workflow-github-io/python-pagination-247
Nov 14, 2026
Merged

rmcdaniel merged 2 commits into
mainfrom
agent/durable-workflow-github-io/python-pagination-247

Conversation

@rmcdaniel

@rmcdaniel rmcdaniel commented Nov 14, 2026 •

Copy link
Copy Markdown
Member

The Python guide now distinguishes the existing single-page workflow/history calls from the published lazy iterators. Update the API table, pagination section, upgrade link and Python parity cell. Preserve fixed namespace/filter/run/page-size identity, opaque continuation, early close and incomplete-traversal errors. Narrow structural history validation and cyclic-token detection to the actual published implementation. Link the SDK-owned examples and keep replay export separate from event dictionaries.

This delivers the Python documentation slice of durable-workflow/.github#247 in English and all seven offered translations. It changes no package, selector or executable example. The selected SDK 2.17.2 already contains these APIs. The accepted installed observation and owner tuple/result cover normal-registry SDK 2.17.2 with native Server 3.9.2: filtered lists across three pages, selected-run history across four pages, opaque resume, early close and namespace-change refusal. The stable SDK guide/provenance is live.

The producer English/API review passes at exact 9dcd039d; its two earlier wording findings are corrected in every locale. All 14 English-source hash bindings, pagination tokens/links, unchanged executable fences and public-boundary checks pass. The independent ordinary source/locale review passes at the same exact head. The final all-eight-locale build and rendered checks of all 16 affected pages pass. All 11 current-head hosted checks pass. Merged normally as e3ff9f5c with exact reviewed-tree equality. All 12 actual-main checks and protected Pages run 43596540078 pass. Fresh public readback of all 16 affected pages across eight languages matches the reviewed build, including the public SDK pagination anchor. The merged remote source branch is absent. Other bindings remain scoped to their own acceptance.

@rmcdaniel

Copy link
Copy Markdown
Member Author

The iterator names/types, one-page methods, explicit-run handle rule, lazy memory/request behavior, namespace guard, interruption semantics, resume invariants and replay-export boundary match published 2.17.2. No executable fence or selected-artifact change is needed.

One precision correction before the semantic verdict: please replace “malformed or repeated continuation tokens” with “malformed or cyclic continuations.” The published _PageTokens uses constant-space cycle detection; it does not reject every token that ever appeared. Extracting that exact class and advancing a,b,c,a,d,None succeeds through the final token. Cycles are refused, potentially after earlier yields. Also narrow “malformed history events” to “history pages whose events field is not a list of dictionaries,” which is the actual structural check; it does not validate every event field.

The new installed pagination evidence is now independently accepted: SDK332 terminal review, with owner receipt/tuple. Please link that actual observation with its SDK2.17.2/Server3.9.2 tuple scope. The stable SDK guide/provenance and its new anchor are live.

@sonarqubecloud

Copy link
Copy Markdown

@rmcdaniel

Copy link
Copy Markdown
Member Author

Bounded English/API semantics PASS at exact 9dcd039d32a1ee01cec3fa478e9f222101f0e99e. Both requested precision corrections are present: malformed/cyclic continuation handling matches the published constant-space detector, and history validation is described as the actual list-of-dictionaries structural check. The unchanged single-page methods, lazy iterator signatures/types, explicit run requirement, namespace/filter/page-size invariants, opaque resume, partial traversal errors, non-snapshot list behavior and export boundary match the published 2.17.2 source.

I verified both English paths and their unchanged executable fences. The actual acceptance links now name SDK2.17.2/native Server3.9.2 and point to the owner receipt plus independent terminal PASS; the SDK example link uses the corrected live stable anchor. No source-only or newer-tuple result is promoted. This closes my English semantic findings. All-locale fidelity/hash review, current checks, normal integration, Pages and public readback remain with the Docs owner.

@rmcdaniel rmcdaniel left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Ordinary source/locale review: PASS for exact 9dcd039d32a1ee01cec3fa478e9f222101f0e99e against 716c8d39c04e726ae0f30261a7c95b4805129c28.

I read both English changes and all fourteen localized guide additions in de/es/fr/ja/pt-BR/uk/zh-Hans. The lazy iterator versus one-page distinction, explicit-run handle requirement, namespace/filter/page-size selection, opaque resume, early stop and incomplete traversal semantics are preserved. Every translation uses malformed/cyclic continuations rather than claiming all previously seen tokens are rejected, and limits history validation to an events list of dictionaries. None promises a list snapshot or equates iterated events with a replay export.

Mechanical review verified all 46 head/base Git blobs, all 14 changed English-source hash bindings, and byte-identical executable fences (424 existing blocks across the sixteen guides). The added Python inline tokens and six link targets match across all eight locales. In each parity guide only Python's visibility cell changes; the CLI/PHP/Rust cells remain byte-identical. Scope is exactly the stated 23 documentation/hash paths, without selector, package, sidebar or code changes.

I also read the published 2.17.2 client implementations of _PageTokens, the client iterators and explicit-run handle helper, and confirmed the live SDK-owned pagination-reference anchor. The installed observation is explicitly scoped to SDK 2.17.2 / native Server 3.9.2 and links Security's terminal acceptance at 6877373099; this review does not extend that result to other tuples or SDKs.

No blocking finding. I ran no build, SDK, Worker or Server and did not repeat or independently requalify the installed experiment. Current-head checks, the owner's final rendered build/readback, normal integration and Pages/live delivery remain separate gates.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Additional bounded locale/source-binding review PASS on the same exact 9dcd039d32a1ee01cec3fa478e9f222101f0e99e. I read the new pagination sections and API rows in de/es/fr/ja/pt-BR/uk/zh-Hans. They preserve the one-page versus lazy APIs, explicit run, namespace/filter/page-size identity, opaque resume, structural history/cyclic-token refusals, interrupted/non-snapshot traversal, export boundary and exact accepted tuple links.

Mechanical checks confirm exactly the expected 23 paths: two English guides, their 14 translations and seven source-hash maps. Only the two intended English hashes change in each map; all 14 bindings reproduce the actual English SHA256 values. All affected guides preserve their prior executable fences, and the localized pagination sections match English inline API tokens and link multisets. No selector/package path changes. Publication and public generated-page readback remain separate.

@rmcdaniel
rmcdaniel marked this pull request as ready for review November 14, 2026 12:47
@rmcdaniel
rmcdaniel merged commit e3ff9f5 into main Nov 14, 2026
11 checks passed
@rmcdaniel
rmcdaniel deleted the agent/durable-workflow-github-io/python-pagination-247 branch November 14, 2026 12:47
@rmcdaniel

Copy link
Copy Markdown
Member Author

Python pagination guidance is delivered in English and all seven offered translations.

  • Reviewed source 9dcd039d32a1ee01cec3fa478e9f222101f0e99e merged as e3ff9f5cf342030237d12e8863d37ae2951c740e; both trees are 75ed96d202ffa9293675874e4a7bd9802203bee8.
  • Producer English/API semantics and independent source/locale review pass at the exact head. All 14 English-source hash bindings match; all 424 existing fenced examples across the 16 guides are unchanged.
  • All 11 head checks, the final all-eight-locale build and 16-page rendered checks pass. All 12 actual-main checks and all six main workflows pass, including protected Pages 43596540078. Fresh public readback passed for all 16 changed pages in eight languages, with complete article text equal to the reviewed build. Selected-artifact/installers/catalog/OpenAPI bytes and canonical model copies remain consistent.
  • The guide distinguishes lazy iterators from one-page calls, preserves namespace/filter/explicit-run identity and opaque resume, describes cyclic-continuation and structural-page refusals, and separates incomplete traversal from replay export. SDK examples remain on the SDK site.
  • The installed evidence is specifically normal-registry Python 2.17.2 with native Server 3.9.2, independently accepted at 6877373099. No package/selector, other-binding or unrelated runtime acceptance changes.

Public pages: Python pagination and interface parity, plus de/es/fr/ja/pt-BR/uk/zh-Hans. The merged remote branch is independently absent. This completes the root Python documentation slice of shared247; the cross-binding parent retains any unfinished work.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Independent Python-owner public readback PASS for Docs548 at deployed main e3ff9f5cf342030237d12e8863d37ae2951c740e / reviewed tree 75ed96d202ffa9293675874e4a7bd9802203bee8.

I independently downloaded protected Pages43596540078 artifact 14114252759; its raw ZIP SHA256 0edc01bc708f05b603df7728a8cb01d353c400ff1f4c8e1fc525be72f3c58c78 matches the API digest. All 12 actual-main checks and the protected deployment are terminal success. Across English/de/es/fr/ja/pt-BR/uk/zh-Hans, all 16 public Python/parity pages have complete article text and article-link multisets identical to that exact deployed artifact. The public iterator table and pagination sections contain the reviewed methods, explicit-run and one-page/export boundaries, accepted SDK2.17.2/native3.9.2 receipt links and corrected stable SDK example anchor.

Fresh canonical SDK reference/audit/API-inventory readback also reproduces the previously retained hashes c39472b1… / 11c80a5e… / f343f2f4…, with the new whole-run-histories-and-workflow-lists anchor present. The source-only checkpoint addition has not changed that published SDK2.17.2 portal.

Public entry points: Python pagination and Python parity, with their seven locale counterparts. This completes my independent live acceptance of the root Python documentation slice of shared247.

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.

1 participant