TSZ CI And PR
Use for PR checks, CI triage, ready state, queue evidence, and landing. Use
tsz-pr-coordination for PR body/label contract.
Rules
- Use
gh; sign substantive comments with a provenance line (e.g.
Machine: studio or Provenance: studio / claude-code / claude-opus-4-8 / high).
- The PR author lands their own PR; never idle-wait on CI between pushes.
- Never merge draft/WIP PRs (
draft, WIP, [WIP], or body/branch says WIP).
- Every open PR runs the full CI suite (draft or not); path-based content skips apply only to docs-only or tooling-only diffs.
- Ready PRs land through GitHub's native merge queue.
- If asked to land, verify
state: MERGED; an armed queue request alone is not enough.
Inspect
gh pr view <pr> --json state,isDraft,mergeStateStatus,mergeable,autoMergeRequest,mergedAt,labels,title,url,headRefName,headRefOid
gh pr checks <pr> --json name,state,bucket,link,completedAt
gh run view <run-id> --log-failed
gh run view <run-id> --job <job-id> --log
Use gh pr checks <pr> --watch --interval 20 only when the result is needed
now.
Landing
- Confirm not WIP and head SHA matches inspected checks.
- Fix failures in-PR; comment with root cause and verification.
- Mark ready only after implementation and verification:
gh pr ready <pr>.
- Queue with GitHub's native merge queue only when exact-head PR-head checks
such as
CI Summary pass and policy permits:
gh pr merge <pr> --match-head-commit <sha>.
Do not pass --auto; with branch protection and passing checks, current
gh adds the PR to the native merge queue directly.
- Inspect
merge_group CI runs if queue validation stalls.
- Verify final merge:
gh pr view <pr> --json state,mergedAt,mergedBy,url.
Failure Hints
CI Summary: umbrella PR-head status.
merge_group CI: native queued-merge summary validation.
conformance-aggregate: accepted-regression drift can fail aggregate even
when shards pass.
unit-cloudbuild: often exposes memory, linking, or architecture guard
failures.
- Docs-only and bench-shell-only paths short-circuit most jobs.
Comment shape: provenance line, root cause, files changed, verification/CI
URL, remaining risk.
1---2name: tsz-ci-pr3description: Drive TSZ GitHub PRs through review, CI, and the merge queue. Use when checking PR status, debugging failing GitHub Actions, deciding whether a PR is WIP, marking draft PRs ready, enqueueing or verifying the queue, landing a PR, or interpreting TSZ CI gates.4---56# TSZ CI And PR78Use for PR checks, CI triage, ready state, queue evidence, and landing. Use9`tsz-pr-coordination` for PR body/label contract.1011## Rules1213- Use `gh`; sign substantive comments with a provenance line (e.g.14 `Machine: studio` or `Provenance: studio / claude-code / claude-opus-4-8 /15 high`).16- The PR author lands their own PR; never idle-wait on CI between pushes.17- Never merge draft/WIP PRs (`draft`, `WIP`, `[WIP]`, or body/branch says WIP).18- Every open PR runs the full CI suite (draft or not); path-based content skips apply only to docs-only or tooling-only diffs.19- Ready PRs land through GitHub's native merge queue.20- If asked to land, verify `state: MERGED`; an armed queue request alone is not enough.2122## Inspect2324```bash25gh pr view <pr> --json state,isDraft,mergeStateStatus,mergeable,autoMergeRequest,mergedAt,labels,title,url,headRefName,headRefOid26gh pr checks <pr> --json name,state,bucket,link,completedAt27gh run view <run-id> --log-failed28gh run view <run-id> --job <job-id> --log29```3031Use `gh pr checks <pr> --watch --interval 20` only when the result is needed32now.3334## Landing35361. Confirm not WIP and head SHA matches inspected checks.372. Fix failures in-PR; comment with root cause and verification.383. Mark ready only after implementation and verification:39 `gh pr ready <pr>`.404. Queue with GitHub's native merge queue only when exact-head PR-head checks41 such as `CI Summary` pass and policy permits:42 `gh pr merge <pr> --match-head-commit <sha>`.43 Do not pass `--auto`; with branch protection and passing checks, current44 `gh` adds the PR to the native merge queue directly.455. Inspect `merge_group` CI runs if queue validation stalls.466. Verify final merge:47 `gh pr view <pr> --json state,mergedAt,mergedBy,url`.4849## Failure Hints5051- `CI Summary`: umbrella PR-head status.52- `merge_group` CI: native queued-merge summary validation.53- `conformance-aggregate`: accepted-regression drift can fail aggregate even54 when shards pass.55- `unit-cloudbuild`: often exposes memory, linking, or architecture guard56 failures.57- Docs-only and bench-shell-only paths short-circuit most jobs.5859Comment shape: provenance line, root cause, files changed, verification/CI60URL, remaining risk.