Skip to content

Add npm release workflow with provenance#9

Merged
teallarson merged 3 commits intomainfrom
teallarson/release-workflow
Mar 4, 2026
Merged

Add npm release workflow with provenance#9
teallarson merged 3 commits intomainfrom
teallarson/release-workflow

Conversation

@teallarson
Copy link
Copy Markdown
Collaborator

Summary

  • Renames package to @arcadeai/create-agent with create-agent bin
  • Adds .github/workflows/release.yml: tag-triggered, publishes to npm with OIDC provenance (Trusted Publishers — no stored NPM_TOKEN needed) and creates a GitHub Release
  • Documents the release process in CLAUDE.md and README.md

How releases work

Nothing publishes on merge to main. To release:

```bash
npm version patch # or minor/major
git push origin main --follow-tags
```

Pushing the v* tag fires the workflow → npm publish with provenance → GitHub Release created.

One-time setup needed before first release

  1. Bootstrap the package on npm manually (it must exist before Trusted Publishers can be configured)
  2. On npmjs.com: configure Trusted Publisher for ArcadeAI/create-arcade-agent, workflow release.yml, environment npm
  3. Optionally create a npm GitHub Environment for approval gates

Full instructions in CLAUDE.md.

🤖 Generated with Claude Code

teallarson and others added 3 commits March 4, 2026 14:21
better-auth v1.5.x split the Drizzle adapter into a separate peer
dependency (@better-auth/drizzle-adapter). Add it explicitly and bump
better-auth to ^1.5.3 in both ai-sdk and mastra templates to fix the
Module not found build error.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Rename package to @arcadeai/create-agent with create-agent bin
- Add publishConfig, repository, and homepage fields to package.json
- Add .github/workflows/release.yml: tag-triggered publish to npm with
  OIDC provenance (Trusted Publishers) and GitHub Release creation
- Document release process in CLAUDE.md and README.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@teallarson teallarson marked this pull request as ready for review March 4, 2026 21:26
@teallarson teallarson requested a review from sdserranog March 4, 2026 21:27
@teallarson teallarson merged commit 6b8f2cf into main Mar 4, 2026
@teallarson teallarson deleted the teallarson/release-workflow branch March 4, 2026 21:57
Comment thread CLAUDE.md

### One-time setup (must be done before first release)

1. **Bootstrap the package on npm** — the package must exist before Trusted Publishers can be configured:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I think we should omit this. This is something no one else will do ever again

Comment thread README.md
npm audit signatures # verify provenance attestation
```

**First-time / one-time setup:** Before the workflow can publish, the package must exist on npm and npm Trusted Publishers must be configured. See [`CLAUDE.md`](./CLAUDE.md) for the full one-time setup instructions.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

same with this

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.

2 participants