yak(ratchets-deferred-decisions-handoff-practice-ccjp): ratchets, deferred decisions, handoff practice

2026-10-28 23:14:18 +00:00
parent b72446b80e
commit e292b4ebfb
3 changed files with 75 additions and 6 deletions
@@ -58,8 +58,14 @@ coverage:
 # report scores that are pessimistic instead of absent - a false failure is
 # less bad than a false pass, but neither is acceptable in the Lens pass.
 #
-# Threshold is ex_crap's default (30); whether to ratchet it down is an open
-# decision tracked in the "ratchets, deferred decisions, handoff practice" yak.
+# Threshold is ex_crap's default (30), kept deliberately: decision 2026-10-28
+# (human, yak "ratchets, deferred decisions, handoff practice") is not to
+# ratchet --max-score down yet - below 30 is a policy change, not a cleanup.
+# Baseline at that threshold, same date: 0 offenders above 30, worst function
+# FirehoseWeb.CoreComponents.table/1 at 20.00 ("Summary: files=23 functions=140
+# scored=140 worst_score=20.00"). A failing run prints "High scores: N" plus the
+# offending functions; on a passing run read N=0 off the worst score rather than
+# inventing a count.
 crap:
 	@test -f cover/default.coverdata || { echo "crap: no exported coverage - run 'make test.coverage' first" >&2; exit 1; }
 	MIX_ENV=test $(MISE_EXEC) mix crap