crapkit

Work one crapkit debt item end to end: the packet that replaces reading the file, the ceiling the edit is judged against, the verdict that clears the commit. Use when the session already names crapkit (crapkit.toml, .crapkit/, crapkit-ratchet.tsv, a CRAP score, `crapkit next-item`, `crapkit brief`), when the user asks to burn down debt or lower complexity in a repo crapkit measures, when a commit is refused with "crapkit: commit blocked by the complexity gate", "crapkit gate: N staged function(s) exceed the complexity ceiling" or "decompose before committing", or when an edit draws the mid-session advisory "crapkit advisory: N function(s) over ceiling C". Not for eslint, husky, or any other pre-commit gate.

Adopting crapkit in a repo for the first time.

Recover a crapkit run that refused, and tell a real refusal from a line that only looks like one: which exit code means what, the five causes behind "produced no artifact", the tainted-baseline escape, and why a crapkit-ratchet.tsv conflict goes to `crapkit ratchet merge` and never to hand-resolution. Use when a crapkit command exits 3/5/6/7/8/9, a lane reports "produced no artifact", doctor says a shell "cannot run" a lane's first word or that a lane "declares no results_artifact", a run "cannot serve as a baseline", marks "were recorded under" another metric version, a ratchet regression names a function you never touched, verify reports a tainted baseline, git conflicts crapkit-ratchet.tsv, `crapkit claude-hook` exits 2 with an advisory, or `crapkit doctor --plugin-root` reports drift.