Web UI: Worktree and branch hygiene dashboard #432

Closed
opened 2026-07-07 12:21:02 -05:00 by jcwalker3 · 1 comment
Owner

Problem statement

Local branches/ worktrees accumulate and are hard to inspect. Operators need visibility into active, dirty, stale, and anomalous worktrees.

Scope

Surface local worktree/branch cleanup state:

  • enumerate branches/ worktrees
  • classify active PR, active issue, dirty, stale clean, detached review, unsafe/unknown
  • highlight missing-preserved-worktree anomalies
  • provide cleanup prompt only (no deletion in MVP)

Acceptance criteria

  • Shows worktrees under branches/
  • Classifies each as: active PR, active issue, dirty, stale clean, detached review, unsafe/unknown
  • No deletion actions in MVP
  • Provides canonical cleanup prompt text only
  • Highlights missing-preserved-worktree anomalies (#404)

Non-goals

  • Deleting worktrees or branches from the UI
  • Running cleanup mutations without gated-action framework
  • Replacing gitea_reconcile_merged_cleanups backend

Relation to tracker

Child of tracker #425. Implements one slice of the MCP Control Plane internal web UI. Does not duplicate backend policy already enforced by MCP tools/workflows.

Dependencies

Depends on #426. Related backend: #401, #404.

Notes

Read local git worktree metadata server-side; keep MVP read-only.

## Problem statement Local `branches/` worktrees accumulate and are hard to inspect. Operators need visibility into active, dirty, stale, and anomalous worktrees. ## Scope Surface local worktree/branch cleanup state: - enumerate `branches/` worktrees - classify active PR, active issue, dirty, stale clean, detached review, unsafe/unknown - highlight missing-preserved-worktree anomalies - provide cleanup prompt only (no deletion in MVP) ## Acceptance criteria - Shows worktrees under `branches/` - Classifies each as: active PR, active issue, dirty, stale clean, detached review, unsafe/unknown - No deletion actions in MVP - Provides canonical cleanup prompt text only - Highlights missing-preserved-worktree anomalies (#404) ## Non-goals - Deleting worktrees or branches from the UI - Running cleanup mutations without gated-action framework - Replacing `gitea_reconcile_merged_cleanups` backend ## Relation to tracker Child of tracker #425. Implements one slice of the MCP Control Plane internal web UI. Does not duplicate backend policy already enforced by MCP tools/workflows. ## Dependencies Depends on #426. Related backend: #401, #404. ## Notes Read local git worktree metadata server-side; keep MVP read-only.
jcwalker3 added the status:in-progress label 2026-07-07 14:25:39 -05:00
Author
Owner

Issue claim heartbeat

<!-- gitea-issue-claim-heartbeat:v1 --> **Issue claim heartbeat** - kind: claim - issue: #432 - branch: feat/issue-432-worktree-hygiene - phase: claimed - profile: prgs-author - pr: none - blocker: none - next_action: create worktree and begin implementation
sysadmin removed the status:in-progress label 2026-07-09 08:24:39 -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#432