Skip to content

create-vale-rule: an empty result is not a clean pass; read notices and vale-parse-error findings #364

Description

@theCodeDrift

From the 2026-09-21 dogfood notes.

A front-matter parse error used to abort the entire Vale invocation and check returned [] for the run, indistinguishable from a clean pass. 0.11.2 retries around the file Vale blames and reports it as a vale-parse-error finding (ruleId: "vale-parse-error", severity: "error"; .changeset/one-bad-file-zeroes-the-run.md). This is the same family as the 0.11.1 "absent read as clean" fixes.

create-vale-rule.md mentions notices once (the excluded-file advisory) and never mentions vale-parse-error. A rule author who sees no findings has no prompt to check whether Vale actually read the file.

What to do

  • Recipe: a short passage in the verify/check section — an empty result is only a pass if notices is empty and no vale-parse-error finding is present; what each of those looks like; topic version bump.
  • Cross-check verify-rule.md for the same gap.
  • No changeset (recipe only).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    CLIRelated to the taskless CLIdocumentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions