docs: correct stale PR-body-sync wording in process-hardening and testing docs - #1855
Conversation
This pull request has been ignored for the connected project Preview Branches by Supabase. |
Warning Review limit reachedYou’ve reached a temporary PR review limit under our Fair Usage Limits Policy. Next review available in:41 minutes Your organization has reached its usage spending cap. Adjust your spending cap in the billing tab. How can I continue?After more reviews become available, a review can be triggered using the To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews. How do review limits work?CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability. For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window. Please refer docs for additional details. Review details⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (2)
Comment |
Uh oh!
There was an error while loading. Please reload this page.
There was a problem hiding this comment.
Pull request overview
Updates documentation to match the already-shipped CI behavior for PR body synchronization, preventing confusion about when sync-pr-policy-body runs.
Changes:
- Clarifies in
docs/testing.mdthat PR body sync is gated on the PR’s diff changingPR_POLICY_BODY.md, not mere filesystem presence (and notes the inherited-file pitfall). - Updates
docs/process-hardening.mdto match the same corrected gating condition.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| docs/testing.md | Updates CI-topology wording for PR body sync gating; adds a reference to the regression tracked as #230. |
| docs/process-hardening.md | Corrects the process-hardening summary sentence to reflect diff-based gating for PR body sync. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
| UI scope runs a fail-fast `@critical` Chromium job on pull requests / merge queues, then required production Chromium journeys (`test:e2e:pr:shard`) across three **duration-aware explicit file groups** (`scripts/playwright-pr-shards.mjs`). Those later groups exclude `@critical`; main, scheduled, and ordinary manual runs skip the fail-fast job and retain the complete set. The dated per-file timing profile is the single source for membership and keeps both full and post-critical estimates within 30 seconds; filesystem/config parity tests fail closed on orphans, duplicates, or matcher drift. Cross-job webpack-cache transport is deliberately absent after the merged PR's final run moved a 1.09 GB artifact three times for no critical-path benefit. `.github/actions/setup-ui-e2e/**` is UI-scoped so changing the browser environment exercises its owner. `src/app/api/**` does not set `ui_changed` or `db_changed` — API handlers stay on unit/coverage (and offline RAG when retrieval-scoped). The `PR required` aggregate keeps `if: always()` and distinguishes `cancelled` from `failure` in its messages. `release-browser-matrix` runs on UI/performance/lockfile-relevant `main` pushes and on every release-branch, ordinary manual, and scheduled run; its Playwright wrapper owns the isolated production build, and successful in-run production Chromium leaves only Chromium mockups plus Firefox/WebKit. Missing prior Chromium proof falls back to the full matrix. The Lighthouse-baseline refresh dispatch is a focused measurement operation rather than a synthetic full run. Container scope calls the reusable Docker workflow and requires both app and worker image builds through the aggregate. | ||
| PR body synchronization is skipped unless the checked-out head actually contains `PR_POLICY_BODY.md`. The eval-canary liveness API probe runs once with the daily Ops Digest cadence rather than on every PR. These remove repeated provider-side work without weakening a required result. | ||
| PR body synchronization is skipped unless the current PR's own diff changes `PR_POLICY_BODY.md` — an inherited copy merely present on the checked-out head (e.g. from a `main` merge) no longer triggers it (`#230`). The eval-canary liveness API probe runs once with the daily Ops Digest cadence rather than on every PR. These remove repeated provider-side work without weakening a required result. |
Summary
docs/process-hardening.mdanddocs/testing.mdstill described the CIsync-pr-policy-bodygate as firing wheneverPR_POLICY_BODY.mdwas merely present on the checked-out PR head. That was the actual bug (ledger#230, fixed inaf8e717): an inherited copy of that scratch file — e.g. carried forward by a routinegit merge origin/main— could trip the sync and silently overwrite an unrelated PR's real description with stale scratch content.pr_policy_body_changednow derives from the PR's own diff, not filesystem presence, and is covered by a dedicated regression self-test inscripts/ci-change-scope.mjsthat runs in required CI). This PR only updates the two doc sentences that still described the old, incorrect behavior, and adds a pointer to#230indocs/testing.mdfor future readers.Verification
npx prettier --check docs/process-hardening.md docs/testing.md— passed ("All matched files use Prettier code style!")npm run verify:pr-local/verify:ui/verify:release— doc-comment-only change with no source, config, or behavior touched; not applicable per the verification pyramid's Tier 1 (documentation/comments) guidance.Risk and rollout
Notes
RAG impact:or## Clinical Governance Preflightsection is required — this PR does not touchsrc/lib/rag/**, retrieval/ranking, ingestion, answer generation, or any clinical-output surface.Generated by Claude Code