Skip to content

[ci] skip heavy checks for proven documentation-only PRs - #346

Merged
wangtiance merged 1 commit into
ThinkFlowLab:mainfrom
wangtiance:codex/ci-docs-only-gate
Nov 16, 2026
Merged

wangtiance merged 1 commit into
ThinkFlowLab:mainfrom
wangtiance:codex/ci-docs-only-gate

Conversation

@wangtiance

Copy link
Copy Markdown
Collaborator

Documentation-only PRs currently run the full release suite. Complete the remaining PR-2 implementation in #273 by proving the whole PR diff is documentation-only after the shared static hooks succeed, then skipping Python, frontend/build/wheel and all browser matrix jobs while keeping the stable aggregate check.

  • Use a narrow allowlist: root README/CONTRIBUTING/CHANGELOG files and Markdown or common screenshot formats under docs/. Code/configuration under docs, AGENTS/skills, workflows, tests and mixed changes keep full checks.
  • Compare the merge-base range with NUL-delimited paths and rename detection disabled so both old and new names are checked. Missing history, invalid comparisons, empty diffs and Git failures select the full gate.
  • Accept heavy-lane skips only with successful static checks, an explicit docs-only PR decision, a positive changed-path count and every expected lane receipt. Failed, cancelled, missing or unexplained results remain blocking. Summaries include the decision and reason in Chinese and English.
  • Keep full checks for main pushes, manual runs and nightly; no merge-queue activation or Python ready-subset cutover. Preserve the existing aggregate check name and shared static configuration.
  • Align the documented PR budget to 30 minutes, as requested. Existing per-job limits remain distinct from an enforced end-to-end deadline.

Validation

  • 96 CI-tool tests passed, using real temporary Git histories, actual selector → aggregate execution, failure/cancellation/missing-receipt cases and existing profile/layer regressions.
  • Counterfactual: unchanged upstream aggregate rejects the docs-only skipped receipts; the new aggregate accepts the proven case.
  • actionlint, all applicable shared pre-commit hooks on the exact committed PR diff, i18n (3014 keys), 34 documentation links/anchors and whitespace checks passed.
  • Local default pytest startup is blocked by missing pillow_heif. These pure CI-tool suites ran with --noconftest -p ci_profile and the real plugin to avoid unrelated application startup; no production fixture or test assertion was weakened. Full application/unit/build/browser suites were not run locally.
  • Hosted code-change CI remains to run on this PR. A real hosted docs-only PR must verify the skip path after merge; the current PR itself changes CI code and should run full checks.

New branch: codex/ci-docs-only-gate, based on verified current upstream c2ced6c9 and rebased before publication. Screenshots N/A: CI-only change; no model/provider calls.

Refs #273 (Proposed PR plan, PR-2).

## summary

Classify the complete PR diff after shared static checks and skip heavy
lanes only for an explicit nonempty documentation allowlist.

- Retain code, mixed, renamed-code and unknown comparisons in the full
  gate, including all main pushes, manual runs and nightly callers.
- Require successful static evidence and every skipped lane receipt in
  the stable aggregate; failures and cancellations remain blocking.
- Exercise real Git ranges and aggregate execution, document the policy
  in both languages, and align the PR budget target to 30 minutes.
@wangtiance wangtiance added ready ready label to trigger CI type:ci Build, test and release automation area:ci Continuous integration and checks area:docs Documentation / 文档 labels Nov 16, 2026
@github-actions
github-actions Bot requested a review from wuzhf9 November 16, 2026 03:55
@wangtiance
wangtiance merged commit 691135f into ThinkFlowLab:main Nov 16, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:ci Continuous integration and checks area:docs Documentation / 文档 ready ready label to trigger CI type:ci Build, test and release automation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant