Reviewer baseline validation must use branches worktrees, not the main checkout #325

Closed
opened 2026-07-07 01:49:32 -05:00 by jcwalker3 · 0 comments
Owner

A reviewer workflow for PR #280 ran the full test suite in the main master checkout to compare failures against the PR worktree.

Problem

The main checkout is the stable control checkout and MCP entrypoint. It must not be used for PR validation or baseline testing. Running test suites in the main checkout can generate files, mutate caches, create artifacts, or confuse control-checkout state.

Required behavior

  1. The main checkout may be used only for read-only status/fetch/stable update operations.

  2. Reviewer validation and baseline comparison must happen under branches/.

  3. If a PR full-suite failure is claimed to be pre-existing on master, the workflow must create a clean baseline worktree under branches/, such as:
    branches/baseline-master-pr<PR_NUMBER>

  4. The baseline worktree must be clean before and after validation.

  5. Baseline comparison must report:

    • baseline target SHA
    • PR head SHA
    • exact validation command
    • baseline failures
    • PR failures
    • proof the failure signatures match
  6. The main checkout must not run test suites.

Acceptance criteria

  • Running tests in the main checkout fails reviewer workflow validation.
  • Baseline comparison uses a separate branches/ worktree.
  • Reports cannot claim “pre-existing master failure” without baseline worktree proof.
  • Tests cover main-checkout test attempt, clean baseline worktree, failing baseline, matching failures, and mismatched failures.
A reviewer workflow for PR #280 ran the full test suite in the main master checkout to compare failures against the PR worktree. ## Problem The main checkout is the stable control checkout and MCP entrypoint. It must not be used for PR validation or baseline testing. Running test suites in the main checkout can generate files, mutate caches, create artifacts, or confuse control-checkout state. ## Required behavior 1. The main checkout may be used only for read-only status/fetch/stable update operations. 2. Reviewer validation and baseline comparison must happen under `branches/`. 3. If a PR full-suite failure is claimed to be pre-existing on master, the workflow must create a clean baseline worktree under `branches/`, such as: `branches/baseline-master-pr<PR_NUMBER>` 4. The baseline worktree must be clean before and after validation. 5. Baseline comparison must report: * baseline target SHA * PR head SHA * exact validation command * baseline failures * PR failures * proof the failure signatures match 6. The main checkout must not run test suites. ## Acceptance criteria * Running tests in the main checkout fails reviewer workflow validation. * Baseline comparison uses a separate `branches/` worktree. * Reports cannot claim “pre-existing master failure” without baseline worktree proof. * Tests cover main-checkout test attempt, clean baseline worktree, failing baseline, matching failures, and mismatched failures.
jcwalker3 added the status:in-progress label 2026-07-07 04:00:46 -05:00
sysadmin removed the status:in-progress label 2026-07-07 04:13:24 -05:00
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Scaled-Tech-Consulting/Gitea-Tools#325