This repository was archived by the owner on Nov 4, 2026. It is now read-only.
Repository navigation
Releases
Releases · jaystewartuk/groundtruth
v0.3.0 — citation checks, --strict-sources, --version
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 checknow 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-sourcesturns 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.sourceWarningsin--jsonoutput, 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.--jsonnused to
print a table and exit0— a green build from a run that never did what
was asked, which is the exact failure this tool exists to prevent.
Fixed
- The
versioninput and pinned Action refs inREADME.mdstill said
0.2.0after the 0.2.1 release. CI now checkspackage.json,
action.yml, andREADME.mdagree 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 atjaystewartuk/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_acrosslanded.
v0.2.1 — on the GitHub Marketplace
No behaviour change: @groundtruth-sh/cli@0.2.1 on npm is functionally identical to 0.2.0, and the Action's runner is untouched. This release exists so the Action can be published to the GitHub Marketplace — the listing takes its name, description and icon from action.yml.
- uses: actions/checkout@v4
- uses: jaystewartuk/groundtruth@v0.2.1
Pin the exact ref — there is no floating v0 major alias while pre-1.0.
See the changelog for 0.1.0 and 0.2.0.