heddle check --only known-errors
Known-Errors Check
The known-errors check fails any page that repeats a mistake the company has already shipped once and written down. Without it, a mistake you've already corrected once, like a retired product name, comes back the next time someone writes about that product. Mistakes that have shipped before, caught in code.
When Heddle is set up on your site, this check runs on every build alongside 15 others, so a page that fails it is fixed before a buyer or a search engine sees it.
Why it exists
Mistakes that have shipped before, caught in code. known-errors.json says what each one is, what is true instead and where it was seen; a rule with a pattern is enforced here, block by block, and the same file is given to the writing agents so they avoid it in the first place.
A rule without a pattern is a judgement only a reader can make, and is listed in the summary so nobody mistakes it for checked.
One rule is built in, because it shipped on the source site and is true of any byline. A post that refers to its own author in the third person ("my colleague Pat") has the narrator wrong. It runs on sources whose frontmatter names an author.
From lib/checks/known-errors.mjs in the Heddle repository at de0c02b.
Questions
What does the known errors check look for?
Mistakes known-errors.json says have shipped before, plus a byline written in the third person.
Does the known errors check need an AI model?
No. It reads the built pages or the sources directly, so it runs offline and costs nothing per run.
How do I run it?
Build the site, then run node bin/heddle.mjs check <site> --only known-errors from the Heddle repository.
Work with us
Let the agents bring you the leads.
Tell us about your business and who buys from you. On a short call we'll show you the searches your buyers make where you don't show up yet, and what the agents would do about them in their first month.
On the call, for your site
- The searches your buyers makeMeasured, with how many people make each one
- Where you show up, and where you don'tOn Google and in ChatGPT's answers
- The agents' first monthThe pages, fixes and links they would start with