Skip to content

chore: mark action bundles as generated and cover extract-version in check_dist - #81

Merged
marc0olo merged 1 commit into
mainfrom
chore/mark-dist-generated
Sep 17, 2026
Merged

marc0olo merged 1 commit into
mainfrom
chore/mark-dist-generated

Conversation

@marc0olo

@marc0olo marc0olo commented Aug 3, 2026

Copy link
Copy Markdown
Member

The four JavaScript actions run from a committed dist/index.js, so every dependency is bundled into it and the bundles dominate every review. #79 changed 28 lines of package.json and pnpm-lock.yaml plus 3,176 lines of rebuilt bundle.

Behaviour changes

  • actions/*/dist/** is marked linguist-generated=true, so GitHub collapses the bundles in pull request diffs. The diff stat still lists them; only the contents fold.
  • check_dist:required now covers extract-version as well. It is a node24 action with an 856K bundle that release workflows use to read the version being published, and its bundle went unverified. It is already in sync, so this adds coverage without a rebuild.

For the reviewer

check_dist is what makes collapsing safe rather than reckless: it rebuilds and fails on any difference, so the hidden output is provably what the reviewed source compiles to.

CONTRIBUTING.md and the README now record the consequence that is easy to miss — a dependency fix changes nothing about what runs until the bundles are rebuilt, because the lockfile is not consulted when GitHub executes an action.

🤖 Generated with Claude Code

@marc0olo
marc0olo requested review from a team as code owners August 3, 2026 16:05
@marc0olo
marc0olo force-pushed the chore/mark-dist-generated branch 2 times, most recently from dba8737 to 52c4a56 Compare August 3, 2026 17:11
@marc0olo marc0olo changed the title chore: mark action bundles as generated and automate rebuilding them chore: mark action bundles as generated and cover extract-version in check_dist Aug 3, 2026
@marc0olo
marc0olo force-pushed the chore/mark-dist-generated branch 2 times, most recently from 6b648ab to 81762e4 Compare August 4, 2026 07:38
@marc0olo
marc0olo requested a lite review from Copilot August 4, 2026 07:39

Copilot AI 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

Reduces review noise from committed JavaScript action bundles by marking them as generated in GitHub diffs, while strengthening safety by ensuring the dist-check workflow also verifies the extract-version bundle.

Changes:

  • Add .gitattributes rule to mark actions/*/dist/** as linguist-generated=true so bundled output collapses in PR diffs.
  • Expand self-check-dist workflow matrix to include extract-version, ensuring its committed dist/ is verified for drift.
  • Document the rationale and workflow expectations in README.md and .github/CONTRIBUTING.md.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
README.md Documents collapsing generated action bundles in PR diffs and emphasizes pairing it with a dist drift check.
.github/workflows/self-check-dist.yaml Adds extract-version to the dist verification matrix so its bundle is also checked.
.github/CONTRIBUTING.md Explains why bundles are committed and clarifies that dependency-only updates don’t affect runtime until bundles are rebuilt.
.gitattributes Marks actions/*/dist/** as generated so GitHub collapses bundle diffs.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

The four JavaScript actions run from a committed dist/index.js, so every runtime
dependency is bundled into it. That puts large generated artifacts in the middle
of every review: #79 changed 28 lines of package.json and pnpm-lock.yaml plus
3,176 lines of rebuilt bundle, so 99% of that review was generated output.

Marks them as generated in .gitattributes so they collapse in pull request
diffs. Reviewers see the source changes, and check_dist:required continues to
guarantee that the collapsed output is exactly what that source compiles to,
which is what makes collapsing it safe rather than reckless.

Adds extract-version to the check_dist matrix. It is a node24 action with an
856K bundle that was not covered, so a stale bundle there went unverified, and
it is the action release workflows use to read the version being published. Its
committed bundle is currently in sync, so this adds coverage without requiring
a rebuild.

Documents both in CONTRIBUTING.md, including the part that is easy to miss: a
dependency fix without rebuilt bundles does not change what runs, because the
lockfile is not consulted when GitHub executes an action. Adds a matching
convention to the README, since this repo documents conventions for other
repositories too.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Copilot AI 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.

🟢 Approval recommended

No unresolved blocking issues were identified.

Review details
  • Files reviewed: 4/4 changed files
  • Comments generated: 0 new
  • Review effort level: Lite

@marc0olo
marc0olo merged commit 8ae33d6 into main Sep 17, 2026
19 checks passed
@marc0olo
marc0olo deleted the chore/mark-dist-generated branch September 17, 2026 13:11
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.

3 participants