Files

Defame1297 ca744d5d6c fix(vale-config): correct the missing-style failure mode

Gotcha 1 said a style in BasedOnStyles that is not built-in and not
already under StylesPath "finds nothing until vale sync fetches it — a
clean run is not proof anything linted". Reproduced against vale 3.15.2:
that case is a hard `E100 [loadStyles] style '<name>' does not exist on
StylesPath`, exit 2. Nothing is linted and nothing is silent.

Worse, the same commit deleted the Gotcha that was the actual diagnostic —
that Packages and BasedOnStyles are separate keys and a style lints only
once it is in both. So the surviving rule sent a reader staring at E100 to
run `vale sync`, which fetches only what Packages declares and reports
"Synced 0 package(s)" against a BasedOnStyles-only name. The remediation
loop did not terminate. Reproduced end to end.

The genuinely silent case is the reverse — declared in Packages and
synced, but absent from BasedOnStyles — and it is now the one labelled as
such. Testing also turned up that StylesPath must exist as a directory
even when Vale is the only style (E201, exit 2), which was documented
nowhere.

references/configuration-reference.md gains a seven-row resolution matrix,
each row backed by a fixture. Its Frontmatter Scopes section claimed
provenance from the vale.sh research corpus, which contains no frontmatter
material at all; it is house-verified and now says so under its own slug.

Issue #99's wave-3 comment recorded this defect as found and repaired. It
was not — the file was byte-identical to the commit that introduced it, so
nothing here was treated as already correct.

Refs #99

2026-08-30 20:51:32 +00:00

1.3 KiB

Raw Blame History

Sources

context7-websites-vale-sh

URL: context7:/websites/vale_sh
Description: Official Vale documentation site (vale.sh) indexed by Context7 — .vale.ini config reference, style/rule/check model, installation across package managers and Docker.
Research doc: plugins/lint/docs/research/docs/vale/sources.md
Contributing files: SKILL.md, references/configuration-reference.md
Status: extracted

house-vale-3-15-2-repro

URL: (house-verified — reproduced locally against the vale binary, not an external source)
Description: Behaviour of Vale 3.15.2 established by running it against purpose-built fixtures in this repo, where vale.sh documents nothing: the E100 [loadStyles] / exit-2 failure for a BasedOnStyles name absent from StylesPath, vale sync reporting Synced 0 package(s) for a name not declared in Packages, the E201 / exit-2 failure when the StylesPath directory does not exist, the exit-0 no-op of an empty style directory, and the text.frontmatter.<key> scope matrix across multi-line YAML forms.
Research doc: none — house-verified reproduction, not part of the plugin's research corpus (no plugins/lint/docs/research/ topic file backs this entry)
Contributing files: SKILL.md, references/configuration-reference.md
Status: extracted

1.3 KiB Raw Blame History

Sources

context7-websites-vale-sh

house-vale-3-15-2-repro

1.3 KiB

Raw Blame History