fix: unresolvable private-org uses: example in _checks.yml
Summary
This public repo's .github/workflows/_checks.yml carries a documentation comment showing consumers how to call the shared "foundation checks" reusable workflow. The comment's example used a cross-org uses: reference of the shape:
uses: wave-av/<private-sibling-repo>/.github/workflows/checks.yml@<ref>
...pointing at a private wave-av repository (not named here โ this is a public repo, and the private repo's name should never appear on a public surface).
A public repository cannot resolve a private repository's reusable workflow: the GitHub Actions run fails before any job is created, producing zero jobs, zero steps, and zero check-runs. That reads to a human (and to gh pr checks) as "nothing objected", not as a failure โ which is exactly how this line goes unnoticed.
This particular instance is documentation, not a live workflow step โ this file's own on: workflow_call block is never invoked with that private target inside this repo's own CI, so no check run here is currently broken. But it is the literal text a consumer copies when wiring up the shared gate in their own repo, so it silently propagates the same unresolvable reference downstream to every repo that follows the example.
Fix
Replace the private cross-org example with the equivalent local, same-repo path, which is what a public consumer should actually copy:
uses: ./.github/workflows/_checks.yml
This mirrors the pattern already opened as a draft in wave-av/adk#113 (the first repo in this sweep found to carry the identical line) and the shipped guard at wave-foundation-public's scripts/public-repo-guard/content-policy.sh (rule unresolvable-uses), which blocks this exact shape (uses: wave-av/<private-repo>/.github/workflows/...) as a BLOCKING merge gate on public repos going forward.
Scope
- Single line change, comment-only, no functional CI behavior change.
- Verified with a widened copy of
scripts/public-repo-guard/content-policy.shagainst this repo's working tree: 1 hit before this change, 0 hits after, for theunresolvable-usesrule. - Part of a broader sweep across all 33 public
wave-avrepos for this defect shape (reusable-workflow, composite-action, and raw-fetch variants); tracked atwave-foundation-public#100.
Test plan
- Confirm
.github/workflows/_checks.ymlstill parses as valid YAML (comment-only change, no indentation or key changes). - Confirm no other file in this repo references the private sibling repo (swept clean, aside from what this PR fixes).
๐ค Generated with Claude Code
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.
Summary by Sourcery
Update the public reusable-workflow example to use the repository-local checks workflow instead of a private cross-organization reference.
Bug Fixes:
- Replace the unresolvable private cross-repository reusable-workflow example with a valid local workflow reference for public consumers.
Documentation:
- Correct the reusable workflow usage example in the checks workflow documentation comment.