Skip to content

make spelling regenerates typos.toml and drops the inline-code exemption, failing lint on a clean checkout #294

Description

@leynos

Problem

make spelling (chained into make lint and make markdownlint) runs
scripts/generate_typos_config.py, which rewrites the tracked typos.toml.
The regenerated file drops the inline-code exemption pattern
"`[^`\n]+`" from extend-ignore-re. Three backtick-wrapped identifiers
then trip the gate (artifact x2, color x1) in files otherwise untouched,
and the working tree is left dirty with the generator's edit.

Reproduced on a pristine origin/main worktree on 2026-08-07: identical three
failures, exit 123. Two independent agents hit it on different branches the
same day, so it is not branch-specific.

Impact

  • make lint and make markdownlint are red on a clean checkout of main.
  • Every branch inherits the failure, and the dirty typos.toml risks being
    committed accidentally.

Likely fix

Per AGENTS.md, typos.toml is generated and must not be hand-edited — which is
presumably how the pattern got there. Move the inline-code exemption into
typos.local.toml (the input the generator honours) so regeneration preserves
it, or teach the generator to emit it.

Note PR #259 owns the spelling-policy tooling and rewrote the generator and
config; the fix likely belongs there or immediately after it.

Evidence

  • Failing pattern: extend-ignore-re loses "`[^`\n]+`" on regeneration.
  • Failures: artifact (x2), color (x1), all inside backtick code spans.
  • Clean-checkout reproduction: exit 123 on origin/main, 2026-08-07.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workinghighUnblocks delivery within the current sprint or release window. Reaction time is days, not hours.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions