What problem does it solve? Repositories accumulate entropy: stale pull requests, outdated architecture maps, aging broken-item registers, and unmapped branches or worktrees. Manually auditing all of this costs operator time and often results in scattered, unreviewable changes. ## Core Features & Use Cases - PR Triage: Classifies every open PR as merge-ready, needs-review, stale, or superseded using fixed freshness thresholds (14 days stale, superseded detection with cited PR numbers), with one-line justifications for each recommendation. - Stale Map Detection and Refresh: Flags documentation maps untouched for 30+ days while their described surfaces received 20+ commits, and drafts refreshed generated content inside the triage PR. - Broken Register Aging and Sprawl Reporting: Updates last_verified fields in the broken register, flags auto-resolvable items whose repro commands now pass, and reports worktree/branch counts against budget. - Use Case: Run a scheduled weekly hygiene pass on the dharma_swarm repo to produce a single repo hygiene <date> PR containing PR triage, refreshed maps, register aging, and sprawl counts, plus a JSON receipt under reports/loop_closure/oz_hygiene/. ## Quick Start Run the repo hygiene pass on this repository and open one consolidated triage PR with PR classifications, stale map refreshes, broken register aging, and a sprawl report.
