gauntlet

Overview ¶

gauntlet runs choudoufu's real-estate test suite against stock OpenTofu and renders everything the project says about its own progress from the result. live/GAUNTLET.md, rendered by this tool, is the contract.

go run ./tools/gauntlet render                 # regenerate artifact, spec, site pages
go run ./tools/gauntlet next [-n N] [-json]    # the next unit(s) of work, deterministically
go run ./tools/gauntlet run [-set core] [-parallel N] [name] # run crossing scripts, record verdicts, render
go run ./tools/gauntlet behaviors [-all] [-port N] [-parallel N] [id...] # run the tier-1 behavior matrix (#522), record verdicts, render
go run ./tools/gauntlet add <name> <url> <ref> -lane <lane> -source "..." [-core -reason "..."]
go run ./tools/gauntlet import-legacy          # one-time seed from live/corpus-crossing-manifest.json
go run ./tools/gauntlet snapshot <version>     # copy the artifact to live/history/<version>.json
go run ./tools/gauntlet notes <old.json> <new.json> # release-highlights markdown from a snapshot diff
go run ./tools/gauntlet check                  # exit 1 if a rendered file is stale
go run ./tools/gauntlet merge-artifact <base> <ours> <theirs> # row-granular artifact merge across sibling estate PRs (#488)