Skip to content
This repository was archived by the owner on Nov 4, 2026. It is now read-only.

v0.3.0 — citation checks, --strict-sources, --version

Latest

Choose a tag to compare

@jaystewartuk jaystewartuk released this 24 Sep 18:35
· 4 commits to main since this release
e7e8f07

Added

  • Assertion citations are now checked. Every assertion's source
    ("CLAUDE.md#L42") is a claim about the repo like any other, and it rots
    the same way: insert a paragraph and every line number below it shifts
    while the assertions keep passing against the wrong sentence. groundtruth check now verifies that the cited lines still state the claim, and reports
    where the sentence moved to when they do not. Running it against this
    repository for the first time found 9 of its own 15 citations already
    wrong.
  • --strict-sources turns those warnings into a non-zero exit. Off by
    default: a stale citation is a bug in your assertions file, not drift in
    the repo it describes, so upgrading never newly breaks a build.
  • --version / -v, which the bug-report template had been asking for
    without anything to answer it.
  • sourceWarnings in --json output, and in the Action's job log and job
    summary.

Changed

  • Unrecognised arguments are now a usage error (exit 2) instead of being
    silently ignored, and a flag missing its value is too. --jsonn used to
    print a table and exit 0 — a green build from a run that never did what
    was asked, which is the exact failure this tool exists to prevent.

Fixed

  • The version input and pinned Action refs in README.md still said
    0.2.0 after the 0.2.1 release. CI now checks package.json,
    action.yml, and README.md agree on the version.
  • The npm package page linked to the old jaystewart-dev/groundtruth
    repository, so its README badges all read "repo not found". The package
    metadata and README now point at jaystewartuk/groundtruth.
  • The assertion-kind count read "6" in the README, the shipped example file,
    the FAQ, and the glossary; there have been seven kinds since
    text_matches_across landed.