okhp3-repository-janitor

Topics in the source

• okhp3-repository-janitor
• Scope
• Safety contract
• Audit workflow
• Authorized lifecycle execution
• Scheduled operation
• Output contract
• Resources

OverKill Hill P³ · overkillhill.com · github.com/OKHP3 Keep a multi-repository Git estate understandable without losing work. Treat origin/main as the comparison baseline, not as evidence that other work is disposable. Audit explicitly named roots and origin identities. Python 3.9+ and a Git version supporting the documented safe-fetch flags are required for the helper. Missing origin/main is a coverage hold; do not silently substitute another branch or invent a new main branch. 1. Begin with a read-only inventory. Do not delete repositories, branches, stashes, refs, or commits during discovery. 2. Preserve before pruning. Record dirty files, stashes, local-only commits, and unreachable commits. Propose dated archive refs as recovery points; creating them requires explicit recovery authorization and is never part of audit-only discovery. 3. Refresh remotes only when requested, using the helper's explicit no-prune, no-prune-tags, no-auto-maintenance fetch. Git configuration can enable pruning even without a command-line prune flag. Do not permit it during inventory. 4. Compare each checkout to the refreshed origin/main. Report both file-level and commit-level differences. 5. Treat a

This is an excerpt. Refer to the complete source and its current requirements.