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
@@ -54,8 +54,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 functions
+# Blogex.LinkValidator.validate_link/1 and validate_links/1 at 6.00
+# ("Summary: files=12 functions=61 scored=61 worst_score=6.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