Skip to content

ci(release-npm): switch to workflow_run trigger so npm publish auto-fires#261

Merged
avrabe merged 1 commit intomainfrom
fix/release-npm-workflow-run
May 3, 2026
Merged

ci(release-npm): switch to workflow_run trigger so npm publish auto-fires#261
avrabe merged 1 commit intomainfrom
fix/release-npm-workflow-run

Conversation

@avrabe
Copy link
Copy Markdown
Contributor

@avrabe avrabe commented May 3, 2026

Summary

  • Diagnoses why release-npm.yml hasn't fired since v0.6.0 and fixes it.
  • The Release workflow creates the GitHub Release page using GITHUB_TOKEN. GitHub deliberately suppresses downstream workflow triggers from runs that authenticated with GITHUB_TOKEN (loop-prevention guarantee), so the historical release: published trigger on this file never fires for v0.7.0 / v0.8.0 — both stuck without npm publication despite binaries being on the Release page.
  • Switches the trigger to workflow_run on the upstream Release workflow — the documented escape hatch for chaining workflows when the upstream uses GITHUB_TOKEN.

Why this approach

Option Cost Tradeoff
A: workflow_run (this PR) ~10 lines of YAML Clean, no PAT needed, no rotation
B: PAT in release.yml's gh release create Generate / store / rotate a RELEASE_PAT secret Keeps original trigger semantics; ongoing PAT chore
C: Inline npm-publish jobs into release.yml Largest refactor Loses workflow isolation

Picked A.

Notable changes

  • head_branch on a tag-pushed source workflow is the tag name itself (e.g. v0.8.0), so version resolution stays one liner.
  • Tag-format guard added: only proceeds if TAG matches ^v[0-9]+\.[0-9]+\.[0-9]+.
  • Both jobs gated on workflow_run.conclusion == 'success' so failed/cancelled Release runs don't fire downstream publishes; workflow_dispatch bypasses the gate for manual backfills.
  • Adds the standard "release-variant" concurrency: block consistent with chore(ci): add concurrency control to all workflows #258.

Backfill plan

Once this lands on main, manually dispatch the npm publish for the two stuck releases:

gh workflow run release-npm.yml -f version=v0.7.0
gh workflow run release-npm.yml -f version=v0.8.0

Both have all 5 platform binary archives present on their Release pages, so the platform-package jobs will succeed and the root @pulseengine/rivet package will publish.

Conflict note

#258 (CI concurrency hardening) also touches release-npm.yml's top section. If #258 lands first, this PR will need a small rebase to keep the new variable names (workflow_run.head_branch instead of release.tag_name). Either order works.

Test plan

  • CI yamllint passes on this PR.
  • After merge: gh workflow run release-npm.yml -f version=v0.7.0 → all 5 platform packages publish, then root publishes.
  • After v0.7.0 backfill: gh workflow run release-npm.yml -f version=v0.8.0 → same.
  • Verify npm view @pulseengine/rivet version returns 0.8.0.
  • Future v0.9.0 release auto-triggers release-npm.yml via workflow_run (validates the actual fix).

🤖 Generated with Claude Code

…ires after Release

The Release workflow creates the GitHub Release page using the default
GITHUB_TOKEN, and GitHub deliberately suppresses downstream workflow
triggers from runs that authenticated with GITHUB_TOKEN (loop-prevention
guarantee). As a result, release-npm.yml's `release: published` trigger
never fires for v0.7.0 or v0.8.0 — both stuck without npm publication
despite the binary archives being on the GitHub Release page.

Switch to workflow_run on the upstream Release workflow. This is the
documented escape hatch for chaining workflows when the upstream uses
GITHUB_TOKEN. Side effects:

  * head_branch on a tag-push source workflow is the tag name itself
    (e.g. v0.8.0), so version resolution stays straightforward.
  * Guard added against non-release tags so a manual Release run on a
    branch ref doesn't accidentally trigger an npm publish.
  * Both jobs gated on workflow_run.conclusion == 'success' so failed
    upstream releases don't fire downstream publishes; workflow_dispatch
    bypasses the gate for manual backfills.

Backfilling v0.7.0 and v0.8.0 npm publication will be done via
workflow_dispatch once this lands on main.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@avrabe avrabe merged commit 08b87f8 into main May 3, 2026
14 checks passed
@avrabe avrabe deleted the fix/release-npm-workflow-run branch May 3, 2026 15:39
Copy link
Copy Markdown

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

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

⚠️ Performance Alert ⚠️

Possible performance regression was detected for benchmark 'Rivet Criterion Benchmarks'.
Benchmark result of this commit is worse than the previous benchmark result exceeding threshold 1.20.

Benchmark suite Current: a3218bf Previous: 9b45c86 Ratio
link_graph_build/10000 38478901 ns/iter (± 3117364) 29210248 ns/iter (± 1823498) 1.32
query/10000 148433 ns/iter (± 1277) 110920 ns/iter (± 1377) 1.34

This comment was automatically generated by workflow using github-action-benchmark.

@codecov
Copy link
Copy Markdown

codecov Bot commented May 4, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

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