id	76
title	Rename misleading parameter names
status	✅
summary	Rename ratio to tokens-per-word, max-words to max-words-per-sentence, max-column-width-variance to max-column-width-ratio, and warn on directory-structure no-op.

Rename misleading parameter names

Part of the user-model work from plan 73. Addresses #68 (user model clarity) and #73 (Hugo user "did you mean?" hint).

Depends on: none (independent of other plans). Update plan 74 guide after landing.

Goal

Each config parameter name tells you what it measures and what unit it uses.

Blind trials (plan 73) found three names that mislead:

ratio: 0.75 in token-budget: 2/5 read it as a warning threshold. It is a words-to- tokens multiplier.
max-words: 40 in paragraph-structure: reads as per-paragraph limit. It is per-sentence.
max-column-width-variance: 60 in table-readability: reads as statistical variance. It is max/min ratio.

Also found: directory-structure: true without allowed is a silent no-op.

No deprecation. Rename in place, update all config files and docs in a single PR.

Update ApplySettings and DefaultSettings in internal/rules/tokenbudget/rule.go
Update internal/rules/MDS028-token-budget/README.md
Update .mdsmith.yml

Rename max-column-width-variance to max-column-width-ratio in MDS026 (table-readability):

Add config warning for MDS033 (directory-structure) when enabled without allowed:

In ApplySettings, when enabled but allowed is empty or absent, mark the rule as configured so Check runs
In Check, when configured with an empty allowed, emit a config warning: directory-structure: rule enabled but no "allowed" patterns configured
Update internal/rules/MDS033-directory-structure/README.md

Add "did you mean?" diagnostic for case-mismatched front-matter keys in catalog (MDS019):

Extract referenced {Field} placeholder names from the row template (or {{.Field}} if plan 75 has not yet landed)
For each name, check key presence in the file's front-matter map (not empty-value)
If exact key is missing but a case- insensitive match exists, emit: catalog: field "Title" not found; did you mean "title"?
Hugo users write .Title; this catches muscle-memory errors without false- positiving on intentionally empty values

Update all overrides in .mdsmith.yml that reference renamed keys.
Update docs/guides/directives/ guides and docs/guides/metrics-tradeoffs.md if they reference old names.
Run mdsmith check . to verify.