Skip to content

docs: pin the GitHub Action at v2.1.1 - #374

Merged
refeed merged 1 commit into
mainfrom
docs/action-v2.1.1
Sep 9, 2026
Merged

docs: pin the GitHub Action at v2.1.1#374
refeed merged 1 commit into
mainfrom
docs/action-v2.1.1

Conversation

@refeed

@refeed refeed commented Sep 9, 2026

Copy link
Copy Markdown
Member

Every snippet showing the GitHub Action pinned @v2, which installs py-tirith 1.2.0. Two
releases have shipped since.

Why it matters that this is manual

The action pins its CLI to an exact tag on purpose — one action ref means one known CLI, so a
caller's green pipeline cannot turn red with nothing in their repository changing. The cost is that
@v2 never drifts: anyone copying our snippets stays on 1.2.0 until we move the docs deliberately.

@v2.1.1 installs 1.2.1, whose comment renders the planned changes as a diff block above the
findings table — one row per changing resource with the attributes that move underneath it, from the
masked plan. v2.1.0
shipped that for the platform path and v2.1.1
added the local-mode path it had missed, so v2.1.1 is the first tag where the feature is true in
both modes.

The diff

Ten references, one substitution, nothing else:

file refs
README.md 1
documentation/src/pages/index.js — the landing page 1
documentation/src/data/demoPhases.js 5
documentation/docs/tirith-usage/ci-integration.md 1
.cursor/rules/tirith-policies.mdc, .claude/skills/tirith-policies/reference/pipelines.md 2

The two agent-facing packs are included because leaving them behind hands an agent a stale pin, which
is the copy most likely to be followed without checking.

static/llms-full.txt and static/docs/ are regenerated with
documentation/scripts/generate-llms-full.py, not hand-edited — that script exists precisely so
those files are not a second source of truth. Their only change is the same version line.

Every changed line in the whole PR:

-  - uses: StackGuardian/tirith-iac-governance-action@v2
+  - uses: StackGuardian/[email protected]

Two things I found and deliberately left alone

Both belong in their own change rather than smuggled into a version bump:

  • The GitLab snippet in README.md and ci-integration.md installs
    [email protected] — five releases stale.
  • Both files state "There is no GitLab-native equivalent of the action", which stopped being true
    when the GitLab CI/CD component was published to the catalog.

Noted in #373 so they are not lost.

Closes #373

Every snippet showed @v2, which installs py-tirith 1.2.0. v2.1.1 installs
1.2.1, whose comment renders the planned changes as a diff block above the
findings -- in both modes, after v2.1.0 shipped it for the platform path only.

The action pins its CLI to an exact tag so one action ref means one known CLI,
so @v2 will not drift on its own and anyone copying these snippets stays on
1.2.0 until we move them.

Ten references, one substitution: README, the landing page, the demo phases,
the CI integration page, and the two agent-facing packs, which would otherwise
hand an agent a stale pin. static/llms-full.txt and static/docs/ regenerated
with documentation/scripts/generate-llms-full.py rather than edited.

Closes #373
@sonarqubecloud

sonarqubecloud Bot commented Sep 9, 2026

Copy link
Copy Markdown

❌ The last analysis has failed.

See analysis details on SonarQube Cloud

@codecov

codecov Bot commented Sep 9, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@refeed
refeed merged commit 05e7b0f into main Sep 9, 2026
21 of 22 checks passed
@refeed
refeed deleted the docs/action-v2.1.1 branch September 9, 2026 12:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs pin the GitHub Action at @v2, which is two releases behind

2 participants