Skip to content

docs: add branch cleanup audit#182

Closed
ProfRandom92 wants to merge 2 commits into
mainfrom
codex/create-branch-cleanup-audit-report
Closed

docs: add branch cleanup audit#182
ProfRandom92 wants to merge 2 commits into
mainfrom
codex/create-branch-cleanup-audit-report

Conversation

@ProfRandom92
Copy link
Copy Markdown
Owner

Summary:

  • Add docs/reports/branch-cleanup-audit.md containing a snapshot inventory of visible branches, classification buckets (likely safe-delete, manual-review, keep), commented-out gh delete template for safe-delete candidates, and an explicit note that no branches or PRs were modified.

Changed files:

  • docs/reports/branch-cleanup-audit.md

Testing:

  • Ran python scripts/run_checks.py which completed and wrote docs/reports/check-report.md.
  • Verified branch visibility with git branch -a --no-color which showed only the work branch, and checked workspace state with git status --short.

Risks:

  • The audit reflects only the local repository snapshot and may omit remote or freshly-fetched branches, so safe-delete candidates could change after fetching remotes.

Next:

  • Regenerate the audit if additional remotes/branches are fetched to reassess safe-delete and manual-review candidates.

Codex Task

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new documentation file, docs/reports/branch-cleanup-audit.md, which provides an audit of local repository branches and identifies candidates for deletion. The review feedback suggests improving the syntax of the included GitHub CLI command by using {owner} and {repo} placeholders for automatic interpolation, which reduces the need for manual editing.

Comment thread docs/reports/branch-cleanup-audit.md Outdated
None.

<!-- Safe-delete commands (commented out):
# gh api repos/:owner/:repo/git/refs/heads/<branch> -X DELETE
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The gh CLI automatically interpolates {owner} and {repo} from the current repository context. Using these placeholders instead of :owner and :repo allows the command to be executed with less manual editing and fewer errors.

Suggested change
# gh api repos/:owner/:repo/git/refs/heads/<branch> -X DELETE
# gh api repos/{owner}/{repo}/git/refs/heads/<branch> -X DELETE

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant