feat: guard merged branch cleanup path #516
Labels
Clear labels
allocator
anti-stomp
architecture
bug
chore
codex
concurrency
contamination
control-plane
dashboard
database
design
documentation
enhancement
gitea
glitchtip
important
incident
incident-bridge
integration
jenkins
labels
leases
mcp
mcp-health
mcp-menu
multi-project
mutating
nice-to-have
observability
portability
preflight
protected-branch
queue
read-only
reconnect
recovery
refactor
release
reliability
resumable-review
reviewer
roadmap
safety
security
self-hosted
sentry
stale-runtime
status:blocked
status:in-progress
status:pr-open
status:ready
terminal-lock
testing
tracker
type:bug
type:feature
type:feature
type:guardrail
visibility
workflow
workflow-hardening
workflow-hardening
Controller-owned work allocator
Prevent concurrent LLM session stomping
Architecture / structural design
OpenAI Codex client / workflow session surface
Concurrent session safety
Workflow or session contamination incident
MCP control-plane coordination and allocation authority
MCP operational dashboard/queue view
Internal coordination storage (SQLite/Postgres)
Design / investigation, no implementation
Docs / runbooks
New feature or improvement
Gitea MCP workflow
GlitchTip integration
Operational or process incident requiring durable audit trail
Sentry-to-Gitea incident bridging
Integration testing
Jenkins integration
Label taxonomy management
Lease adopt/release/expire lifecycle
MCP server / tooling
MCP namespace and runtime health
MCP menu surface
Work spanning multiple monitoring projects or Gitea repos
Mutating action; requires gating
Observability, metrics, traces, error reporting
Cross-platform / portability
Shared preflight gates before mutation
Protected branch / stable-branch policy concern
Work queue visibility and allocation
Read-only, no mutation
MCP client reconnect/reload recovery path
Recovery paths for stale/foreign leases
Code refactor / restructure
Release / versioning
Reliability / failure handling
Persist and resume prepared review verdicts across sessions
Reviewer workflow tooling
Roadmap / umbrella issue
Safety rails and fail-closed mutation guards
Security / trust boundary
Self-hosted infrastructure integration
Sentry error monitoring integration
Stale backend daemon / runtime-vs-master parity failures
Issue is blocked
Issue is being worked on
Issue has an open pull request
Issue is ready for work
Terminal review lock (#332) path
Tests / test coverage
Issue tracker hygiene / meta
Bug or defect
Feature or enhancement
Feature or enhancement
Safety gate or guardrail
Workflow state visibility for LLMs/operators
Cross-tool workflow
LLM workflow coordination hardening
LLM workflow coordination hardening
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: Scaled-Tech-Consulting/Gitea-Tools#516
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Summary
gitea_cleanup_merged_pr_branchMCP path for merged PR source branch cleanup with explicitgitea.branch.deleteauthority,branches/worktree enforcement, merged/open-PR/ancestry checks, and exact confirmation text.git branch -d,git push --delete, and colon-ref deletes are not accepted as authorized cleanup proof.Closes #514
Validation
/Users/jasonwalker/Development/Gitea-Tools/venv/bin/python -m py_compile branch_cleanup_guard.py gitea_mcp_server.py final_report_validator.py task_capability_map.py role_session_router.py tests/test_branch_cleanup_guard.py/Users/jasonwalker/Development/Gitea-Tools/venv/bin/python -m pytest tests/test_branch_cleanup_guard.py tests/test_delete_branch_capability.py tests/test_resolve_task_capability.py tests/test_role_session_router.py tests/test_final_report_validator.py tests/test_post_merge_cleanup_proof.py -q(98 passed, 3 subtests passed)git diff --check/Users/jasonwalker/Development/Gitea-Tools/venv/bin/python -m pytest -q-> 1804 passed, 6 skipped, 1 known failure:tests/test_mcp_server.py::TestMergePR::test_merge_blocked_on_stale_approval_headprgs/masterat4d24c34, so it is not introduced by this PR.LLM Metadata
/Users/jasonwalker/Development/Gitea-Tools/branches/issue-514-branch-delete-guardfeat/issue-514-branch-delete-guardgitea_lock_issuepr: #516
branch: feat/issue-514-branch-delete-guard
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/issue-514-branch-delete-guard
profile: prgs-author
session_id: unknown
phase: claimed
head_before:
3550262613expires_at: 2026-07-09T04:31:27Z
reviewer_active: no
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: 10371-bc73a2a41c79
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/review-feat-issue-514-branch-delete-guard
phase: claimed
candidate_head:
d57ca94ec5target_branch: master
target_branch_sha: none
last_activity: 2026-07-09T03:02:12Z
expires_at: 2026-07-09T05:02:12Z
blocker: none
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: 10371-bc73a2a41c79
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/review-feat-issue-514-branch-delete-guard
phase: released
candidate_head:
d57ca94ec5target_branch: master
target_branch_sha: none
last_activity: 2026-07-09T03:07:30Z
expires_at: 2026-07-09T05:07:30Z
blocker: manual-release
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: continue-prgs-rc-516
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/issue-514-branch-delete-guard
phase: claimed
candidate_head:
7acd55d2d2target_branch: master
target_branch_sha: none
last_activity: 2026-07-09T13:28:31Z
expires_at: 2026-07-09T15:28:31Z
blocker: none
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: continue-prgs-rc-516
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/issue-514-branch-delete-guard
phase: claimed
candidate_head:
7acd55d2d2target_branch: master
target_branch_sha: none
last_activity: 2026-07-09T13:29:01Z
expires_at: 2026-07-09T15:29:01Z
blocker: none
Review REQUEST_CHANGES — PR #516
Cannot approve while the PR is not mergeable against current master.
Blockers
7acd55d2d2e2aaf3ac6378dc853f85034ebafb1aconflicts ingitea_mcp_server.py.Canonical PR State
STATE: blocked on merge conflicts with master
WHO_IS_NEXT: author
NEXT_ACTION: merge or rebase onto current prgs/master, resolve gitea_mcp_server.py conflicts, re-run claimed pytest suite, push, request re-review
NEXT_PROMPT:
WHAT_HAPPENED: Reviewer attempted review; PR not mergeable; local master merge conflicts in gitea_mcp_server.py
WHY: Master advanced with #511 and other merges; tip needs conflict resolution before review can complete
ISSUE: #514
HEAD_SHA:
7acd55d2d2REVIEW_STATUS: REQUEST_CHANGES
MERGE_READY: no
BLOCKERS: merge conflict with master in gitea_mcp_server.py — unblocks when author merges/rebases prgs/master, resolves conflicts, pushes a mergeable tip, and re-requests review
VALIDATION: not re-run at conflicted tip; prior author claim was 98 passed on older base
LAST_UPDATED_BY: sysadmin (prgs-reviewer)
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: continue-prgs-rc-516
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/issue-514-branch-delete-guard
phase: claimed
candidate_head:
7acd55d2d2target_branch: master
target_branch_sha:
cc4b95839dlast_activity: 2026-07-09T13:51:41Z
expires_at: 2026-07-09T15:51:41Z
blocker: none
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: continue-prgs-rc-516
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/issue-514-branch-delete-guard
phase: released
candidate_head:
7acd55d2d2target_branch: master
target_branch_sha:
cc4b95839dlast_activity: 2026-07-09T13:51:54Z
expires_at: 2026-07-09T15:51:54Z
blocker: manual-release
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: continue-prgs-rc-516
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/review-pr-516-branch-delete-guard
phase: claimed
candidate_head:
d7c29afde5target_branch: master
target_branch_sha:
cc4b95839dlast_activity: 2026-07-09T14:57:28Z
expires_at: 2026-07-09T16:57:28Z
blocker: none
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: continue-prgs-rc-516
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/review-pr-516-branch-delete-guard
phase: claimed
candidate_head:
d7c29afde5target_branch: master
target_branch_sha:
cc4b95839dlast_activity: 2026-07-09T15:01:55Z
expires_at: 2026-07-09T17:01:55Z
blocker: none
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: continue-prgs-rc-516
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/review-pr-516-branch-delete-guard
phase: claimed
candidate_head:
d7c29afde5target_branch: master
target_branch_sha:
cc4b95839dlast_activity: 2026-07-09T15:02:41Z
expires_at: 2026-07-09T17:02:41Z
blocker: none
Canonical PR State
STATE: review-approved
WHO_IS_NEXT: merger
NEXT_ACTION: merge PR #516 after explicit operator authorization
NEXT_PROMPT:
WHAT_HAPPENED: Reviewed PR #516 for issue #514; approved head
d7c29afde5.WHY: Guarded merged-branch cleanup path is reconciler-scoped with confirmation text, ancestry/open-PR checks, and final-report block on raw git deletes.
ISSUE: #514
HEAD_SHA:
d7c29afde5REVIEW_STATUS: APPROVED
MERGE_READY: yes (awaiting explicit merge authorization)
BLOCKERS: none
VALIDATION: pytest branch_cleanup_guard + related suites -> 88 passed, 3 subtests
LAST_UPDATED_BY: sysadmin (prgs-reviewer)
Review notes
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: continue-prgs-rc-516
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/review-pr-516-branch-delete-guard
phase: claimed
candidate_head:
d7c29afde5target_branch: master
target_branch_sha:
cc4b95839dlast_activity: 2026-07-09T15:03:30Z
expires_at: 2026-07-09T17:03:30Z
blocker: none
Canonical PR State
STATE:
approved
WHO_IS_NEXT:
merger
NEXT_ACTION:
Merge PR #516 with expected head SHA
d7c29afde5after controller authorization.NEXT_PROMPT:
WHAT_HAPPENED:
Reviewer approved PR #516. Guarded merged-branch cleanup path and raw git delete bypass detection match #514 intent; tests pass.
WHY:
Scope is limited to cleanup guard + MCP tool + capability map + final-report gate + docs. Fail-closed on reviewer role, missing branch.delete, root checkout, unmerged PR, protected branches, open-head collision, missing ancestry, and exact confirmation text. Reconciler-scoped as required.
ISSUE:
#514
BASE:
master
HEAD:
feat/issue-514-branch-delete-guard
HEAD_SHA:
d7c29afde5REVIEW_STATUS:
approved
VALIDATION:
pytest tests/test_branch_cleanup_guard.py -q → 7 passed; mergeable=true; author jcwalker3 ≠ reviewer sysadmin
BLOCKERS:
none
SUPERSEDES:
none
SUPERSEDED_BY:
none
MERGE_READY:
yes — approved, mergeable, head matches expected SHA, no blockers
LAST_UPDATED_BY:
sysadmin / prgs-reviewer / 2026-07-09
Review notes
Workflow-load helper result: workflow_hash=435e6aad9ba4; final_report_schema_hash=a7634e7b8689; boundary_status=clean.
Non-blocking: ancestry check uses PROJECT_ROOT git context (existing pattern); PR has several master-merge commits for conflict resolution only.
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: continue-prgs-rc-516
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/review-pr-516-branch-delete-guard
phase: released
candidate_head:
d7c29afde5target_branch: master
target_branch_sha:
cc4b95839dlast_activity: 2026-07-09T15:05:40Z
expires_at: 2026-07-09T17:05:40Z
blocker: manual-release
adopted_at: 2026-07-09T15:38:00Z
adopted_by_identity: sysadmin
adopted_by_profile: prgs-merger
adopted_from_session_id: continue-prgs-rc-516
adopted_from_profile: prgs-reviewer
adopted_from_reviewer_identity: sysadmin
adopted_from_comment_id: 8177
adoption_reason: merger-handoff-approved-head
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-merger
session_id: 91637-6176639e7f06
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/merge-pr-516-branch-delete-guard
phase: adopted
candidate_head:
d7c29afde5target_branch: master
target_branch_sha:
cc4b95839dlast_activity: 2026-07-09T15:38:00Z
expires_at: 2026-07-09T17:38:00Z
blocker: none
adopted_at: 2026-07-09T15:38:48Z
adopted_by_identity: sysadmin
adopted_by_profile: prgs-merger
adopted_from_session_id: 91637-6176639e7f06
adopted_from_profile: prgs-merger
adopted_from_reviewer_identity: sysadmin
adopted_from_comment_id: 8201
adoption_reason: merger-handoff-approved-head
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-merger
session_id: 1956-a0e5513faf75
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/merger-queue
phase: adopted
candidate_head:
d7c29afde5target_branch: master
target_branch_sha:
cc4b95839dlast_activity: 2026-07-09T15:38:48Z
expires_at: 2026-07-09T17:38:48Z
blocker: none
adopted_at: 2026-07-09T15:43:45Z
adopted_by_identity: sysadmin
adopted_by_profile: prgs-merger
adopted_from_session_id: 1956-a0e5513faf75
adopted_from_profile: prgs-merger
adopted_from_reviewer_identity: sysadmin
adopted_from_comment_id: 8208
adoption_reason: merger-handoff-approved-head
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-merger
session_id: 31616-825c35d82173
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/merger-queue
phase: adopted
candidate_head:
d7c29afde5target_branch: master
target_branch_sha:
cc4b95839dlast_activity: 2026-07-09T15:43:45Z
expires_at: 2026-07-09T17:43:45Z
blocker: none
adopted_at: 2026-07-09T15:44:29Z
adopted_by_identity: sysadmin
adopted_by_profile: prgs-merger
adopted_from_session_id: 31616-825c35d82173
adopted_from_profile: prgs-merger
adopted_from_reviewer_identity: sysadmin
adopted_from_comment_id: 8217
adoption_reason: merger-handoff-approved-head
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #516
issue: #514
reviewer_identity: sysadmin
profile: prgs-merger
session_id: 1956-a0e5513faf75
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/merger-queue
phase: adopted
candidate_head:
d7c29afde5target_branch: master
target_branch_sha:
cc4b95839dlast_activity: 2026-07-09T15:44:29Z
expires_at: 2026-07-09T17:44:29Z
blocker: none