Skip to content

fix(ci): unbreak workflow YAML and add a complete actions.lock - #104

Merged
hyperpolymath merged 1 commit into
mainfrom
fix/workflow-dependency-locking
Aug 27, 2026
Merged

fix(ci): unbreak workflow YAML and add a complete actions.lock#104
hyperpolymath merged 1 commit into
mainfrom
fix/workflow-dependency-locking

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

Remediates GitHub Workflow Dependency Locking (public preview, no changelog entry), which rejects runs at startup_failure — zero jobs, no logs, nothing in REST or GraphQL. Full analysis: hyperpolymath/standards#657.

Proven on hyperpolymath/anamnesis: 6 of 6 workflows dead → 0 startup_failure, 13 running.

Five steps, in order — each blocks the next

1. Unbreak the workflow YAML. Any permissions: carrying a scalar with an indented mapping under it:

permissions: read-all
  actions: read        # <- mapping under a scalar. Unparseable.

This reaches past the one file: gh actions-lock refuses to run when any workflow in the repo fails to parse, so the repo can never acquire a lockfile and can never self-heal.

2. Repin standards reusables off commits with no actions.lock. The rejection requires the callee to be covered at the pinned SHA — unsatisfiable at a pre-lockfile commit.

3. Generate the lockfile with gh actions-lock.

4. Hand-add the reusable-caller entries the tool omits, as '<path>': [].

⚠️ Measured across 218 repos: P(startup_failure | has lockfile) = 91.7% vs 15.8% without — because every workflow a lockfile omits is rejected. A partial lock is worse than none. Running gh actions-lock and stopping there is how this outage spread.

5. Restore SPDX-License-Identifier to line 1, which the tool displaces with its own banner and which the workflow-security linter greps via head -1.

Verified before this PR was opened

0 unparseable workflows · lockfile covers every workflow, no omissions · SPDX on line 1 in every file. The script refuses to push if any of the three fails.

🤖 Generated with Claude Code

Remediates GitHub Workflow Dependency Locking (public preview), which
rejects runs at startup_failure with zero jobs and no logs. See
hyperpolymath/standards#657.

Five steps, in order, because each blocks the next:

1. Unbroke any workflow whose `permissions:` carried a scalar with an
   indented mapping under it - blind-permissions-insertion damage. This
   matters beyond the one file: gh actions-lock refuses to run when ANY
   workflow in the repo fails to parse, so the repo could never acquire a
   lockfile and could never self-heal.

2. Repinned hyperpolymath/standards reusables off commits that have no
   actions.lock. The rejection requires the CALLEE to be covered at the
   pinned SHA, which is unsatisfiable at a pre-lockfile commit.

3. Generated the lockfile with gh actions-lock.

4. Hand-added the reusable-workflow caller entries the tool omits, as
   '<path>': []. Measured across 218 repos: P(startup_failure | has
   lockfile) = 91.7% vs 15.8% without, because every workflow a lockfile
   OMITS is rejected. A PARTIAL lock is worse than none - running
   gh actions-lock and stopping there is how this outage spread.

5. Restored SPDX-License-Identifier to line 1, which the tool displaces
   with its own banner and which the workflow-security linter greps with
   head -1.

Verified before push: 0 unparseable workflows, lockfile covers every
workflow with no omissions, SPDX on line 1 in every file.

Proven on hyperpolymath/anamnesis: 6 of 6 workflows dead -> 0
startup_failure, 13 running.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@hyperpolymath
hyperpolymath merged commit aed5c48 into main Aug 27, 2026
@hyperpolymath
hyperpolymath deleted the fix/workflow-dependency-locking branch August 27, 2026 12:32
@sonarqubecloud

Copy link
Copy Markdown

Quality Gate Failed Quality Gate failed

Failed conditions
C Security Rating on New Code (required ≥ A)

See analysis details on SonarQube Cloud

Catch issues before they fail your Quality Gate with our IDE extension SonarQube for IDE

@gitar-bot

gitar-bot Bot commented Aug 27, 2026

Copy link
Copy Markdown

Important

You are using the Gitar free plan. Upgrade to unlock code review, CI analysis, auto-apply, custom automations, and more.

Gitar

@coderabbitai

coderabbitai Bot commented Aug 27, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: f31e555f-bd08-4ffa-ba18-61d1ffea934e

📥 Commits

Reviewing files that changed from the base of the PR and between 6186ca9 and a9b5372.

⛔ Files ignored due to path filters (1)
  • .github/workflows/actions.lock is excluded by !**/*.lock
📒 Files selected for processing (12)
  • .github/workflows/boj-build.yml
  • .github/workflows/casket-pages.yml
  • .github/workflows/codeql.yml
  • .github/workflows/dogfood-gate.yml
  • .github/workflows/governance.yml
  • .github/workflows/hypatia-scan.yml
  • .github/workflows/instant-sync.yml
  • .github/workflows/main-estate-audit.yml
  • .github/workflows/mirror.yml
  • .github/workflows/push-email-notify.yml
  • .github/workflows/scorecard.yml
  • .github/workflows/secret-scanner.yml

📝 Walkthrough

Summary by CodeRabbit

  • Chores
    • Updated automated workflows to use current, explicitly versioned action releases.
    • Refreshed reusable workflow references for governance, security scanning, mirroring and scorecard checks.
    • Added required read permissions for workflow and security automation.
    • Improved workflow maintenance tracking through managed-workflow metadata.

Walkthrough

Changes

GitHub Actions workflow updates

Layer / File(s) Summary
Direct action references
.github/workflows/boj-build.yml, .github/workflows/casket-pages.yml, .github/workflows/codeql.yml, .github/workflows/dogfood-gate.yml, .github/workflows/instant-sync.yml, .github/workflows/main-estate-audit.yml, .github/workflows/push-email-notify.yml
Action references now use updated version tags. CodeQL actions now use v4.36.0. Management comments were added.
Reusable workflow pins and permissions
.github/workflows/governance.yml, .github/workflows/hypatia-scan.yml, .github/workflows/mirror.yml, .github/workflows/scorecard.yml, .github/workflows/secret-scanner.yml
Reusable workflow references now use updated commits. The workflows add actions: read permissions and management comments.

Estimated code review effort: 2 (Simple) | ~10 minutes

Poem

A rabbit checks each workflow line

Tags and pins now neatly align
Actions read what they require
Lock comments mark the desired wire
The burrow builds with fewer signs of mire

✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch

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.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@codacy-production

Copy link
Copy Markdown

Not up to standards ⛔

🔴 Issues 3 high

Alerts:
⚠ 3 issues (≤ 0 issues of at least minor severity)

Results:
3 new issues

Category Results
Security 3 high

View in Codacy

AI Reviewer: first review requested successfully. AI can make mistakes. Always validate suggestions.

Run reviewer

TIP This summary will be updated as you push new changes.

@codacy-production codacy-production Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

While this PR successfully addresses several YAML parsing issues and establishes a standard for workflow metadata, it introduces significant security regressions and logic flaws that should prevent merging in its current state. Most notably, three workflows have been moved from secure commit SHA pinning to mutable semver tags, increasing the risk of tag-floating attacks—especially concerning for workflows handling sensitive secrets and credentials.

Additionally, the Codacy analysis indicates the PR is not up to standards. A logic error in the Secret Scanner workflow's permission block effectively disables required permissions for the job, and the 'actions.lock' file mentioned in the PR description is entirely missing from the diff. These gaps must be addressed to ensure the CI pipeline is truly 'unbroken' and secure.

About this PR

  • The critical '.github/workflows/actions.lock' file is excluded from the diff, preventing verification of the 'complete lock' claim or the manual additions described in the PR description.
1 comment outside of the diff
[REDACTED:HIGH_ENTROPY]

line 23 🟡 MEDIUM RISK
Suggestion: This workflow uses 'actions/checkout@v4.4.0', which is inconsistent with the v6.0.2 standard being applied to other workflows in this PR. Consider updating this to match the repository baseline.

Test suggestions

  • Verify that all workflows are parseable by the GitHub Actions engine (no YAML syntax errors in permissions).
  • Verify that 'actions.lock' contains entries for all 13 workflows mentioned in the description.
  • Verify that the security linter correctly identifies the SPDX license on the first line of all modified files.
  • Verify that reusable workflow calls succeed with the newly added 'actions: read' permission.
Prompt proposal for missing tests
Consider implementing these tests if applicable:
1. Verify that all workflows are parseable by the GitHub Actions engine (no YAML syntax errors in permissions).
2. Verify that 'actions.lock' contains entries for all 13 workflows mentioned in the description.
3. Verify that the security linter correctly identifies the SPDX license on the first line of all modified files.
4. Verify that reusable workflow calls succeed with the newly added 'actions: read' permission.
Low confidence findings
  • There are no automated tests or linting steps added in this PR to ensure that future workflow changes maintain the SPDX-on-line-1 requirement or lockfile completeness.

TIP Improve review quality by adding custom instructions
TIP How was this review? Give us feedback

group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
permissions:
actions: read

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔴 HIGH RISK

The 'actions: read' permission added at the top level is shadowed by the job-level 'permissions' block on line 16. Since other reusable workflows in this PR were updated to include 'actions: read', it is likely the 'scan' job also requires it. You should explicitly add 'actions: read' to the job-level block on line 17.

steps:
- name: Trigger Propagation
uses: peter-evans/repository-dispatch@28959ce8df70de7be546dd1250a005dd32156697 # v3
uses: peter-evans/repository-dispatch@v4.0.1

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔴 HIGH RISK

Suggestion: Pinning third-party actions to a full commit SHA is required to ensure the integrity of code processing sensitive information like the 'FARM_DISPATCH_TOKEN'. Moving to a semver tag (v4.0.1) represents a loss of immutability.

See Issue in Codacy

path: .casket-ssg
- name: Setup GHCup
uses: haskell-actions/setup@cd0d9bdd65b20557f41bea4dbe43d0b5fbbfe553 # v2
uses: haskell-actions/setup@v2.11.0

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔴 HIGH RISK

Suggestion: Pinning third-party actions to a full commit SHA is a security requirement to ensure immutability. The current use of a semver tag (v2.11.0) is vulnerable to tag-floating attacks. The diff indicates this workflow previously used SHAs.

See Issue in Codacy

steps:
- name: Send push notification email
uses: dawidd6/action-send-mail@0bbdab096651ee93f37ec02383e088183d41ff0b # pinned
uses: dawidd6/action-send-mail@v3.12.0

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔴 HIGH RISK

Suggestion: Pinning third-party actions to a full commit SHA is a security requirement to ensure the immutability of the code being executed. This is critical for actions handling sensitive credentials (like SMTP secrets). Reverting from a SHA to a semver tag (v3.12.0) is a regression from the project's security standards.

See Issue in Codacy

runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- uses: actions/checkout@v7.0.1

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 MEDIUM RISK

Suggestion: The version of 'actions/checkout' used here (v7.0.1) is inconsistent with most other workflows in the repository (e.g., 'boj-build.yml') which were updated to v6.0.2. Consider standardizing to ensure a predictable CI environment.

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.

1 participant