Skip to content

feat(gh): use detached review worktrees - #2624

Open
codeforester wants to merge 3 commits into
mainfrom
enhancement/2623-20261020-feat-gh-use-detached-review-worktrees-and-prune-review-refs
Open

codeforester wants to merge 3 commits into
mainfrom
enhancement/2623-20261020-feat-gh-use-detached-review-worktrees-and-prune-review-refs

Conversation

@codeforester

@codeforester codeforester commented Oct 20, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • Add basectl gh review fetch for detached PR-review worktrees backed by refs/base-review/pr/<number>/<slug>.
  • Add basectl gh review prune, dry-run by default, with ownership, cleanliness, detached-state, ref/head, and current PR-state checks before removal.
  • Keep legacy local pr-* refs explicitly out of the permanent workflow; they remain a one-time audited cleanup.

Issue

Fixes #2623

Validation

  • bats cli/bash/commands/basectl/tests/gh-review.bats
  • Full source-checkout BATS suite: 1,067 passed.
  • Full Python suite: 1,828 passed.
  • Stability, command-reference, and documentation-link checks: 25 passed after enrolling the new stable commands.
  • shellcheck cli/bash/commands/basectl/subcommands/gh_review.sh
  • git diff --check

Docs Impact

  • Updated docs/github-workflow.md, docs/command-reference.md, and the basectl command README.
  • Updated Bash/Zsh completions and their parity tests.
  • Updated the stable compatibility fixture for the two new public commands.

@codeforester
codeforester requested a review from a team as a code owner October 20, 2026 13:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(gh): use detached review worktrees and prune review refs

1 participant