Documentation
¶
Overview ¶
Command testgrid-link-check is the warning-only, weekly bot (RQ2 / #1284) that verifies the Evidence deep-links the recipe-health matrix emits (RQ1 / #1283) still resolve against the live evidence dashboard.
It reads the committed presence manifest (the set of coordinates RQ1 links), fetches the dashboard's published data (data/index.json) with a bounded HTTP client pinned to the dashboard origin (off-origin redirects refused), and reports any linked coordinate the live data no longer serves as a dead-link warning. A coordinate the dashboard serves but RQ1 has not linked yet is expected, not a warning. The report is Markdown for $GITHUB_STEP_SUMMARY.
It is advisory: it never blocks a merge and never edits the doc, so it always exits 0 — a fetch failure or a dead link is reported, not fatal. Structurally a clone of .github/workflows/bom-refresh.yaml minus the create-pull-request step (report-only, contents: read).
Usage: testgrid-link-check [-report-out <path>] [-index-file <path>]
Source Files