MECHANISM_NOTES

const MECHANISM_NOTES: Readonly<Record<AbstentionMechanism, string>>

Defined in: packages/core/src/core/shell/abstention.ts:95

The per-family note text — one distinct string per AbstentionMechanism.

Typed as a total Record, so adding a mechanism is a COMPILE ERROR until someone writes its sentence. A family that silently fell back to another family’s note would be the failure this table exists to prevent: [[QA-17]] measured that the note’s effect is family-specific, and docs/test-sessions/qa-17-substitution-note-2026-08-03/ records a narrowing by family name that was FALSIFIED — gh pr comment 42 --body "…" carrying an executing substitution classifies as generic substitution, and three of three hosted raters called it safe unassisted.

Every entry states a fact about what THE SHELL does, and then asks a question. Neither is a verdict about the command in front of the rater, which is what keeps the note neutral while still carrying the mechanism that the measurement showed is load-bearing.