Repository navigation
fix(supply-chain): retire the frozen v1 floating tag - #244
Conversation
|
Warning Review limit reached
Next review available in: 51 minutes Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available. How can I continue?After more reviews become available, a review can be triggered using the To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews. How do review limits work?CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability. For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window. Please refer docs for additional details. Review details⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (89)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
There was a problem hiding this comment.
Pull request overview
This PR retires the frozen @v1 floating tag scheme for this reusable workflow library, switching all documented and live references to immutable pins so consumers reliably receive security updates.
Changes:
- Replaced org reusable-workflow references from
@v1to full SHA pins (with# vX.Y.Zcomments) across templates, docs, examples, and this repo’s own workflows. - Updated version pinning guidance and Renovate configuration to align with immutable semver point tags and SHA pin advancement.
- Added a pre-commit guardrail to block reintroduction of org
@v1references andfollowTaginrenovate.json.
Reviewed changes
Copilot reviewed 87 out of 87 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| workflow-templates/README.md | Updates template architecture guidance to reference SHA pinning. |
| workflow-templates/python-scorecard.yml | Updates reusable workflow pin from old frozen SHA to v7.0.1 SHA. |
| workflow-templates/python-sbom.yml | Updates reusable workflow pin to v7.0.1 SHA. |
| workflow-templates/python-reuse.yml | Updates reusable workflow pin to v7.0.1 SHA. |
| workflow-templates/python-pr-validation.yml | Updates reusable workflow pin to v7.0.1 SHA. |
| workflow-templates/python-mutation.yml | Updates reusable workflow pin to v7.0.1 SHA. |
| workflow-templates/python-fips-compatibility.yml | Updates reusable workflow pin to v7.0.1 SHA. |
| workflow-templates/python-container-security.yml | Updates reusable workflow pin to v7.0.1 SHA. |
| workflow-templates/python-compatibility.yml | Updates reusable workflow pin to v7.0.1 SHA. |
| USAGE_EXAMPLES.md | Rewrites pinning guidance and replaces @v1 examples with v7.0.1 SHA pins. |
| scripts/check-no-floating-v1.sh | Adds pre-commit script to detect org @v1 usage and followTag in renovate.json. |
| renovate.json | Removes followTag: "v1" and updates Renovate rule description for SHA advancement. |
| README.md | Updates primary usage examples from @v1 to a v7.0.1 SHA pin. |
| examples/publish-pypi-caller.yml | Updates example caller to v7.0.1 SHA pin. |
| examples/fuzzing-weekly.yml | Updates example caller to v7.0.1 SHA pin. |
| examples/fuzzing-pr-manual.yml | Updates example caller to v7.0.1 SHA pin. |
| examples/fuzzing-multi-sanitizer.yml | Updates example callers to v7.0.1 SHA pin. |
| examples/fuzzing-migration-example.md | Updates migration doc examples to v7.0.1 SHA pin. |
| examples/fuzzing-custom-directory.yml | Updates example caller to v7.0.1 SHA pin. |
| docs/workflows/workflow-optimizations.md | Updates workflow examples to v7.0.1 SHA pin. |
| docs/workflows/README.md | Updates general workflow usage and pinning guidance to SHA pins or point tags. |
| docs/workflows/python-supplemental-checks.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-standard-stack.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-sonarcloud.md | Updates workflow usage examples to v7.0.1 SHA pin. |
| docs/workflows/python-snyk.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-snyk-iac.md | Updates workflow usage examples to v7.0.1 SHA pin. |
| docs/workflows/python-slsa.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-security-analysis.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-scorecard.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-sbom.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-reuse.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-release.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-qlty-gate.md | Updates workflow usage examples to v7.0.1 SHA pin. |
| docs/workflows/python-qlty-coverage.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-publish-pypi.md | Updates workflow usage examples to v7.0.1 SHA pin. |
| docs/workflows/python-precommit.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-pr-validation.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-performance-regression.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-mutation.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-fuzzing.md | Updates workflow usage examples to v7.0.1 SHA pin. |
| docs/workflows/python-fips-compatibility.md | Updates workflow usage examples to v7.0.1 SHA pin. |
| docs/workflows/python-docs.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-docker.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-dependency-provenance.md | Updates workflow usage examples to v7.0.1 SHA pin. |
| docs/workflows/python-container-security.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-compatibility.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-codecov.md | Updates workflow usage example to v7.0.1 SHA pin. |
| docs/workflows/python-ci.md | Updates workflow usage examples to v7.0.1 SHA pin. |
| docs/workflows/NEW_WORKFLOWS_SUMMARY.md | Updates summary examples to v7.0.1 SHA pin. |
| docs/migration/pypi-publishing-migration.md | Updates migration examples to v7.0.1 SHA pin. |
| docs/migration/image-detection-pypi-migration.md | Updates migration example to v7.0.1 SHA pin. |
| CHANGELOG.md | Corrects changelog intro and documents retirement of floating v1 under Unreleased. |
| .pre-commit-config.yaml | Adds no-floating-v1 pre-commit hook configuration. |
| .github/workflows/supply-chain-promote-core.yml | Updates commented usage examples to v7.0.1 SHA pin. |
| .github/workflows/supply-chain-mirror-verify.yml | Updates commented usage examples to v7.0.1 SHA pin. |
| .github/workflows/supply-chain-consume-verify.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/supply-chain-build-verify.yml | Updates commented usage examples to v7.0.1 SHA pin. |
| .github/workflows/snyk-weekly.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/security-analysis.yml | Updates live reusable workflow pin to v7.0.1 SHA. |
| .github/workflows/scorecard.yml | Updates live reusable workflow pin to v7.0.1 SHA. |
| .github/workflows/python-supplemental-checks.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-standard-stack.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-sonarcloud.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-snyk.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-snyk-iac.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-security-analysis.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-scorecard.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-sbom.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-reuse.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-release.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-qlty-gate.yml | Updates commented usage examples to v7.0.1 SHA pin. |
| .github/workflows/python-qlty-coverage.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-publish-pypi.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-precommit.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-pr-validation.yml | Updates commented usage examples to v7.0.1 SHA pin. |
| .github/workflows/python-performance-regression.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-mutation.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-fuzzing.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-fips-compatibility.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-docs.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-docker.yml | Updates commented usage examples to v7.0.1 SHA pin. |
| .github/workflows/python-dependency-provenance.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-container-security.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-compatibility.yml | Updates commented usage examples to v7.0.1 SHA pin. |
| .github/workflows/python-codecov.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/python-ci.yml | Updates commented usage example to v7.0.1 SHA pin. |
| .github/workflows/dependency-provenance-weekly.yml | Updates commented usage example to v7.0.1 SHA pin. |
| if LC_ALL=C grep -Eql "${PATTERN}" "${file}" 2>/dev/null; then | ||
| found+=("${file}") | ||
| fi | ||
| if [[ "$(basename "${file}")" == "renovate.json" ]] \ | ||
| && grep -ql '"followTag"' "${file}" 2>/dev/null; then | ||
| found+=("${file} (followTag)") | ||
| fi |
|
|
||
| **Issue**: "Workflow not found" | ||
| **Fix**: Check path is exactly: `ByronWilliamsCPA/.github/.github/workflows/python-ci.yml@v1` | ||
| **Fix**: Check path is exactly: `ByronWilliamsCPA/.github/.github/workflows/python-ci.yml@d5cf99101d4150ae5832d154cb42993705a09e31 # v7.0.1` |
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
…tirement The rule's description claimed org reusable workflows float a v1 tag; that tag was frozen by the org tag-protection ruleset and has been retired (ByronWilliamsCPA/.github#244). Behavior unchanged: this rule only groups SHA-pin refresh PRs.
PR ReviewPremise: QUESTION (non-blocking). Sound, well-scoped v1-retirement that aligns the repo with its own CI-005 no-floating-tag policy. All external claims verified against live state: Important
Worth folding in
SonarQube: 0 issues, 0 hotspots (PR-specific). CodeRabbit: check is green but no review ran (rate-limited); do not read its check as coverage. Copilot: 2 comments, of which the staged-vs-worktree concern is neutralized by pre-commit's stash behavior in real runs; the USAGE_EXAMPLES.md:449 "path is exactly" wording nit is valid (the trailing 🤖 Generated with Claude Code |
The v1 tag froze at the v1.1.0 commit (6f71aec) when the org tag-protection ruleset made all v* tags immutable, while main advanced to v7.0.1. Docs still sold v1 as a moving tag, renovate.json followed it (freezing SHA-pin updates), the starter templates and this repo's own scorecard/security-analysis callers were SHA-pinned to the frozen commit, and @v1 callers silently ran v1.1.0-era code, including the Trivy scanner that PR #229 replaced after Trivy's release infrastructure was compromised. Commit fully to point-tag/SHA pinning (CI-005): - renovate.json: drop followTag "v1" so Renovate advances org workflow SHA pins to the latest immutable release tag - USAGE_EXAMPLES.md: rewrite Version Pinning around @<sha> # vX.Y.Z (recommended, Renovate-managed) and immutable @vX.Y.Z point tags - CHANGELOG.md: correct the intro that claimed v1 is re-pointed as changes land; document the retirement under Unreleased - sweep all @v1 usage examples (workflow headers, docs/workflows, examples, migration guides, READMEs) to the v7.0.1 SHA pin form - bump workflow-templates/*.yml and this repo's scorecard.yml and security-analysis.yml off the frozen 6f71aec pin to v7.0.1 - add no-floating-v1 pre-commit guard (scripts/check-no-floating-v1.sh) blocking org-workflow @v1 references and followTag reintroduction Intentionally untouched: tests/fixtures (negative fixtures), tests/libs (vendored), docs/audits (historical record), and third-party action examples (qlty-action, pr-size-labeler). The stale v1 tag itself is deleted separately by an org admin; tag deletion requires a ruleset bypass. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…bats Strengthen the guard added for the v1 tag retirement: - widen the pattern from @v1 to any bare @vn major (a future @v7 would freeze callers the same way) and match the org name case-insensitively, since GitHub resolves uses: owners case-insensitively - fail closed: route the staged-file listing through a temp file so a git failure cannot read as "no staged files", and treat grep exit >= 2 (unreadable file) as a hook failure instead of a silent pass - extend the followTag check to all Renovate config basenames (renovate.json5, .renovaterc variants), tolerate unquoted JSON5 keys, and line-anchor the key match so prose like "No followTag: ..." in a rule description does not trip the guard (caught by the guard itself blocking this very commit) - anchor renovate.json matchPackageNames as regex patterns so the rule cannot match forks or lookalike repos - clarify in USAGE_EXAMPLES that the # vX.Y.Z release comment is not part of the uses: path - add tests/check-no-floating-v1.bats (16 cases: bare-major blocking, allowed pin forms, path exclusions, followTag key variants vs prose, fail-closed git behavior) and correct the CLAUDE.md script/coverage inventory, which had also drifted on sync-secrets.bats Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The line-anchored key match missed compact single-line JSON
({"followTag": "v1"}), where the key sits mid-line; bats cases 10-11
caught the false negative. Match on structural context instead: a real
key is preceded by an object opener, a separator, or line start
({, comma, or ^), while prose like "No followTag: ..." in a rule
description is preceded by a word and space, so both false positives
and false negatives are covered.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
4a05617 to
0ec5407
Compare
|
PR Fix SummaryAddressed the /pr-review findings in two commits on top of the rebase onto current main ( Hook hardening (
Tests ( Config ( Docs ( PR body updated: verification section now describes the committed Bats coverage and the hook's staged-scope semantics; follow-up 1 notes the standards-manifest CI-057 inversion already landed ( Declined with rationale: CHANGELOG 🤖 Generated with Claude Code |
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
…tirement The rule's description claimed org reusable workflows float a v1 tag; that tag was frozen by the org tag-protection ruleset and has been retired (ByronWilliamsCPA/.github#244). Behavior unchanged: this rule only groups SHA-pin refresh PRs.
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
* fix(renovate): drop followTag on retired v1 floating tag The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion). * fix(review): migrate deprecated matchPackagePatterns to matchPackageNames Address CodeRabbit finding on PR #205: the org-workflow Renovate rule used the deprecated matchPackagePatterns matcher. matchPackageNames matches the two literal package names exactly (no regex dot ambiguity) and is consistent with the other rules in renovate.json. Validated with renovate-config-validator. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
The org tag-protection ruleset forbids re-pointing v* tags, so the floating v1 tag froze at the v1.1.0 commit; followTag "v1" therefore froze all org-workflow SHA-pin updates at v1.1.0-era code. Plain semver tracking of the immutable vX.Y.Z release tags (cut on every push to the source repo's main) restores update delivery. Companion to ByronWilliamsCPA/.github#244 and ByronWilliamsCPA/.claude#251 (CI-057 inversion).
…tirement (#75) * docs(renovate): correct org-workflow rule description after v1 tag retirement The rule's description claimed org reusable workflows float a v1 tag; that tag was frozen by the org tag-protection ruleset and has been retired (ByronWilliamsCPA/.github#244). Behavior unchanged: this rule only groups SHA-pin refresh PRs. * docs(renovate): restore original formatting, description change only



Summary
Resolves the Critical finding that the
v1distribution tag is frozen at v1.1.0 (6f71aec) whilemainis at v7.0.1, so@v1consumers never receive security fixes.Root cause: the org tag-protection ruleset (
ByronWilliamsCPA-tag-protection-semver) blocks update/deletion/non_fast_forward onrefs/tags/v*, which made the floating-tag scheme structurally impossible; the tag froze the day the ruleset landed, but docs,renovate.json, the starter templates, and two of this repo's own callers kept using it. This PR commits fully to point-tag/SHA pinning (option b, matching CI-005 andrelease-tag.yml's stated policy).Changes
followTag: "v1"so Renovate can advance org-workflow SHA pins to the latest immutable release tag (the rule previously froze all pin updates at the dead tag); the org matcher is now an anchoredmatchPackageNamesregex (the deprecated unanchoredmatchPackagePatternsform could match lookalike repo names)@<sha> # vX.Y.Z(recommended, Renovate-managed) and immutable@vX.Y.Zpoint tags; state explicitly that no floating major tag existsv1"is re-pointed as changes land"; document the retirement under Unreleased@v1usage examples (every workflow header,docs/workflows/*.md,examples/*, migration guides, READMEs) moved to the v7.0.1 SHA-pin formworkflow-templates/*.ymland this repo's ownscorecard.yml/security-analysis.ymlwere SHA-pinned to the frozen6f71aeccommit (running v1.1.0-era workflow code, including the pre-feat(python-sbom)!: cut over runtime CVE gate from Trivy to Grype (#152) #229 Trivy scanner); bumped to v7.0.1no-floating-v1pre-commit hook (scripts/check-no-floating-v1.sh) blocks org-workflow references to any bare floating major tag (@v1,@v2, ...; case-insensitive org match, fail-closed on git/grep errors) andfollowTagreintroduction across Renovate config variants, with Bats coverage intests/check-no-floating-v1.batsIntentionally untouched:
tests/fixtures(negative fixtures for the SHA-pin audit),tests/libs(vendored),docs/audits(historical record), third-party action examples. The guard's exclusion list carves out those paths plustests/*.bats(the update-pinned-actions suite embeds@v1fixture literals).Verification
pre-commit run --all-filesgreen. Note: theno-floating-v1hook itself scans staged files (same design as the PC-011 em-dash hook), so it enforces at commit time; the all-files run does not exercise ittests/check-no-floating-v1.bats, 16 cases: blocked bare majors for both orgs including lowercased org names, allowed point tags and SHA pins, third-party@v1actions, every path exclusion, quoted/unquotedfollowTagkeys vs prose mentions, fail-closed git failure); runs in CI viashell-tests.ymlactionlintclean on the two workflows with live pin changesgrep -rn '6f71aec'returns nothing; no non-historical@v1org-workflow references remain; a full-tree dry run of the guard's pattern against all tracked files matches nothing outside its exclusion listFollow-ups (separate from this PR)
followTagrule from consumer repos and the cookiecutter template. The standards-manifest part is already done: CI-057 was inverted to forbidfollowTagon org workflow rules (.clauderepo commitac1df86, which cites this PR); still open there:devops-deployment-agent.mdline 81 still instructs CI-057 to PASS only whenfollowTag: "v1"is present and needs the same inversionrefs/tags/v1via a one-time ruleset bypass, after re-verifying no live@v1callers exist (stragglers then fail loudly instead of silently running stale code). Note:update-pinned-actions.sh --pin-tagsdeliberately skips first-party@v1refs, so consumer-repo stragglers will not be auto-fixed; the loud failure after deletion is the detection mechanismGenerated with Claude Code