Skip to content

Document Server visibility queries and pagination - #546

Merged
rmcdaniel merged 4 commits into
mainfrom
agent/durable-workflow-github-io/visibility-query-reference
Nov 14, 2026
Merged

rmcdaniel merged 4 commits into
mainfrom
agent/durable-workflow-github-io/visibility-query-reference

Conversation

@rmcdaniel

@rmcdaniel rmcdaniel commented Nov 14, 2026 •

Copy link
Copy Markdown
Member

Operators can now look up the Server workflow-list query language instead of guessing at SQL syntax. Add a Service Mode reference covering fields, typed comparisons, escaping, precedence, pagination, limits and invalid queries, with URL-encoded curl examples. Link it from the Server API and search-attribute guides, using the existing sidebar. All three guides are updated in English and seven other locales.

This is the documentation portion of durable-workflow/.github#224. Embedded listing and Waterline query parity remain unfinished product work. Artifact selections, executable examples in existing guides and protocol/runtime code are unchanged.

The reference follows published native Server b6e04ce7e679464e91f6ceae83310d3bb3204092 and its existing parser, registry, datetime and listing tests. Producer semantic review and final-head rebind confirms the query contract, including plain-search fallback, negative membership, missing attributes, backend collation and native build-visibility refusal.

Validation: final-head all-eight-locale build and 24-page rendered readback pass, as do Bash syntax, all 21 source-hash bindings and executable-fence checks. All 11 current-head checks pass. Independent source/locale review has no findings. Protected Pages deployment and fresh public readback of all24 pages passed; see the delivery record. The curl examples have not been sent to a live customer runtime.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Bounded native producer semantic review: PASS for the four English/navigation files at d4ad6be838481095514b403179c28753e496a9f7. The successor b9cfa8e4 changes locale material only, so this English verdict retains that exact scope.

I checked against published native 3.10 source b6e04ce7e679464e91f6ceae83310d3bb3204092: parser/compile/match rules, typed registration and date parsing, HTTP list validation/paging, native compatibility refusal, and the existing parser/list/collation controls. The field/type/operator table, missing-value negatives, leading NOT Field IN, absence of grouped expressions, plain-search fallback, database text collation distinction, live offset ordering and page_size 1–200/default 50 match the implementation. The workflow parser does not impose the schedule parser's 2048-character bound. BuildId/BuildIds parsing does not qualify build visibility: a returned run with non-null compatibility is still refused as 409/unqualified_build_visibility, as documented.

This is a source semantic review; I ran no Server or Docs runtime. It establishes neither embedded/Waterline query parity nor their acceptance under shared #224. Locale fidelity, normal hosted checks, site build/review, Pages and public HTTP readback remain the Docs delivery gates. Separate #541/#534 and installed cohort holds are unchanged.

@sonarqubecloud

Copy link
Copy Markdown

@rmcdaniel

Copy link
Copy Markdown
Member Author

The bounded published-native semantic PASS 6876236912 retains its English scope at df8dd797. I read back the successors: the three English bodies/examples are unchanged; the reference adds only displayed_sidebar: tutorialSidebar, and the sidebar returns to its base entries. No published native behavior or qualification claim changed. Locale review, exact-head checks/build, Pages and public HTTP remain the Docs delivery gates.

@rmcdaniel

Copy link
Copy Markdown
Member Author

Local validation at df8dd7973eafb5eefe73deab875c54c47a6538f5 passes: normal Node 24 all-eight-locale build, all seven source-hash sets for the three changed guides, and exact executable-fence equality. Both new curl blocks pass Bash syntax validation. The published native producer semantic review and current-head rebind are read back.

Rendered checks cover all 24 pages: each new reference has the eight explicit section anchors, five tables, two authenticated URL-encoded curl blocks, correct NOT Field IN and error/type/status tokens, selected native version, immutable producer links and pending parity link. Both existing guides link to the localized reference; the reference displays the existing Service Mode sidebar and links back to the API. Static selection/installer/catalog/OpenAPI bytes are unchanged, and canonical/current-version model copies agree.

The initial static observer expected an API child link in a collapsed SSR sidebar. Checking the actual category link, article return link and incoming guide links corrected that observer assumption without a source change. Both owned build containers are independently absent by full ID and exact task inventory. No Server, SDK or customer API requests ran.

Initial missing-locale and sidebar-duplication CI failures remain in their original runs. Final source restores the base sidebar and changes no quality-gate policy. Current-head hosted build and independent ordinary source/locale review still precede normal merge, Pages and fresh public readback. Embedded and Waterline parity under #224 remain unfinished.

@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 and data review: PASS at exact df8dd7973eafb5eefe73deab875c54c47a6538f5.

I read all three English changes and all seven localized sets. The translations preserve status buckets, case-sensitive field names, typed/missing-value behavior, database text-comparison caveats, negated membership and precedence, quoting, live offset pagination, validation errors, and the explicit embedded/Waterline limitations. No source or translation finding remains in this scope.

Independently fetched and Git-blob-verified 56 head/base files; verified all 21 source-hash bindings, both new executable blocks and all 177 inline contract tokens in every reference, all eight anchors and matching link targets, and unchanged executable fences in the 16 existing guides. sidebars.js is byte-identical to base. The three English bodies equal the producer-reviewed d4ad6be sources, with only the new reference's displayed_sidebar: tutorialSidebar frontmatter added. I read the bounded producer review at #546 (comment) . Scope is exactly 31 Markdown/hash paths, with no artifact selection, JavaScript or analyzer-policy change.

Current-head checks have no failure; the executable documentation job is still running. This verdict covers ordinary source/locale/data review only. Final build/navigation, terminal CI, merge/Pages/live readback remain with Docs; it establishes no embedded/Waterline parity or installed runtime result.

@rmcdaniel
rmcdaniel marked this pull request as ready for review November 14, 2026 11:12
@rmcdaniel
rmcdaniel merged commit e5a6494 into main Nov 14, 2026
11 checks passed
@rmcdaniel
rmcdaniel deleted the agent/durable-workflow-github-io/visibility-query-reference branch November 14, 2026 11:12
@rmcdaniel

Copy link
Copy Markdown
Member Author

Delivered at main e5a649423f572891041c5ce2eb0fe8b3358af185, whose full tree 01a9b8f2099afb1bfd31bc780b53896ff36248d5 equals reviewed head df8dd797. All 11 head checks and all 12 actual-main checks completed successfully. Protected Pages deployment 43588927309 built and deployed that exact merge.

Fresh anonymous HTTP readback passes for the Visibility Query Language, its Server API and search-attribute entry points, in English and all seven other locales: 24 pages total. Complete article text matches the final reviewed build. All reference tables, examples, explicit anchors, immutable producer links, localized incoming/return links and existing Service Mode navigation are present. The canonical/current-version model copies agree. Static manifest, installers, catalog and OpenAPI bytes remain unchanged; manifest SHA-256 is fbbe991205d82a231bdd228173cef9c20c20d82933c4235c4773474ec08bea63.

The remote head branch is independently absent after merge, the local source is clean, both captured build IDs and exact task inventories are absent, and all owned check/deploy watchers have completed. Producer review/rebind, ordinary source/locale review, and build/readback validation retain their scopes.

This completes the documentation portion of shared #224. Embedded and Waterline grammar/result parity and their cross-backend tests remain unfinished; the parent stays open. No runtime, SDK, artifact selection or separate #541/#534 hold changed.

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