fabro/docs/public
Bryan Helmkamp f91e51162f
Describe the parallel branch fields in generated clients
`parallel_group_id` used `oneOf: [$ref StageId, null]`, and the generator
drops a sibling description in that position, so the TypeScript client
documented the field as "Canonical stage execution identifier in
`node_id@visit` form" — the shared StageId text, which says nothing about
what this field means. Switching to `allOf` lets the field's own
description through.

Dropping `type: "null"` also makes the contract match the server, which
omits both fields rather than sending null (`skip_serializing_if` on
`Option`, pinned by list_run_stages_exposes_parallel_branch_identity).
The Rust types are unchanged — still `Option<StageId>` and `Option<u32>`,
which accept an explicit null on input either way — so this only narrows
what clients are told to expect on the wire. Wording updated to match,
and reworded to avoid an apostrophe the generator escapes into the
JSDoc.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-28 18:05:24 -04:00
..
administration docs(secrets): document settings-declared credentials, fix stale local-run guidance 2026-07-25 09:04:59 -04:00
agents fix(agent): stop the Kimi leak assertion from passing vacuously 2026-07-25 15:13:41 -04:00
api-reference Describe the parallel branch fields in generated clients 2026-07-28 18:05:24 -04:00
changelog fix(glob): harden artifact traversal 2026-07-25 11:56:57 -04:00
core-concepts fix(agent): simplify GPT-5.6 tool routing 2026-07-25 11:49:40 -04:00
examples Merge branch 'main' into feat/shared-checkout-parallel 2026-07-24 06:29:57 -04:00
execution Add structured review targets to human gates 2026-07-28 13:24:12 -04:00
getting-started refactor: rationalize server secret scopes (vault-only for optional int… (#401) 2026-05-25 17:26:01 -04:00
human-tools fix(config): disable Slack unless configured 2026-06-02 18:41:36 -04:00
images Add system resources settings page (#328) 2026-05-20 17:22:53 -04:00
integrations fix(workflow): make publish failures terminal 2026-07-27 11:25:18 -04:00
languages refactor(docs): split docs/ into public/ and internal/ 2026-04-27 07:21:13 -07:00
logo refactor(docs): split docs/ into public/ and internal/ 2026-04-27 07:21:13 -07:00
reference Merge origin/main into feat/human-review-target 2026-07-28 16:48:02 -04:00
tutorials Shared-checkout parallel execution (recovered from run 01KY7YH7RYCJ1BDVTTP96ZA4HV) 2026-07-24 06:19:11 -04:00
workflows refactor: remove duplicated review target rendering and validation 2026-07-28 15:14:23 -04:00
.mintignore refactor(docs): move .mintignore into docs/public and update skill paths 2026-04-27 07:29:59 -07:00
docs.json refactor(glob): unify workspace path matching 2026-07-25 10:30:19 -04:00
dot-highlight.js refactor(docs): split docs/ into public/ and internal/ 2026-04-27 07:21:13 -07:00
favicon.svg refactor(docs): split docs/ into public/ and internal/ 2026-04-27 07:21:13 -07:00