Scan a repository for toil — the un-fun, load-bearing maintenance work everyone ignores: flaky, skipped, and focused tests; TODO/FIXME/HACK rot; expiring TLS certs; feature flags read but never set; unpinned dependencies; unowned operational scripts; and stray debug statements. Returns a prioritized queue. Set mode='plain' for a flavor-free report.

Record that someone cleared a piece of toil, by its toil_id from a scan. Persists to a local ledger so the invisible work becomes visible. Rescans to resolve the item's title.

Report the credit ledger for standup or retro: who cleared what toil, the current Champion of the Grease Trap, and how much is still open.

Report the repo's toil budget: total estimated remediation minutes, a debt ratio, an A-E maintainability grade, and counts by kind. Google SRE says keep toil under 50 percent.

Explain why a specific finding (by its toil id) is real debt, with evidence and a fix.

Return the top-N highest-priority toil items as an action plan for an agent to work through.

Record a toil snapshot and report how the toil budget has moved since last time.