Publish NPM

1---
2name: publish-npm
3description: Publish the package to npmjs by bumping version, building, and creating a GitHub release
4argument-hint: "[patch|minor|major]"
5---
6 
7Publish the mcp-wallet-signer package to npmjs via GitHub release.
8 
9The argument is an optional semver bump type: `patch`, `minor`, or `major`. If not provided, recommend one based on the diff (see step 1).
10 
11## Steps
12 
13### 1. Analyze changes and bump version
14 
151. Read the `npm.version` field from `deno.jsonc` to get the current version.
162. Find the latest version tag with `git describe --tags --abbrev=0 --match 'v*'`.
173. Run `git log <tag>..HEAD --oneline` to get the commit list since that tag.
184. Based on the commits and diff, recommend a bump type:
19   - **patch**: bug fixes, formatting, docs, dependency bumps, CI changes
20   - **minor**: new features, new API surface, new tools/commands
21   - **major**: breaking changes to public API, removed exports, changed behavior
225. Show the user: the commit list, your recommended bump type with reasoning, and the resulting version. Ask for confirmation, offering all three bump types as options with your recommendation marked.
23 
24### 2. Build the npm package (smoke test)
25 
26Run `deno task build:npm` to verify the build succeeds before pushing. This runs `scripts/build-npm.ts` which does the dnt transform and builds the web UI.
27 
28### 3. Commit, tag, and push
29 
301. Bump version in `deno.jsonc` (`npm.version`) and `server.json` (top-level `version` and `packages[0].version`).
312. Stage and commit both files with message: `Bump version to <new-version>`
322. Create a git tag: `v<new-version>`
333. Push commit and tag: `git push && git push --tags`
34 
35### 4. Wait for CI checks
36 
37Wait for the CI workflow to pass on the pushed commit using `gh run watch $(gh run list --workflow=ci.yml --limit=1 --json databaseId --jq '.[0].databaseId')` with a timeout of 5 minutes.
38 
39If CI fails, show the logs with `gh run view <run-id> --log-failed` and **stop** — do not create a release with failing checks.
40 
41### 5. Create GitHub release
42 
43Run:
44```
45gh release create v<new-version> --title "v<new-version>" --generate-notes
46```
47 
48This triggers the `publish.yml` GitHub Actions workflow which builds and publishes to npm with provenance.
49 
50### 6. Wait for publish workflow
51 
52Get the run ID from `gh run list --workflow=publish.yml --limit=1` and watch it with `gh run watch <run-id>`. Use a timeout of 5 minutes.
53 
54If the workflow fails, show the logs with `gh run view <run-id> --log-failed` and stop.
55 
56### 7. Verify package on npmjs
57 
58Run `npm view mcp-wallet-signer version` and confirm the output matches `<new-version>`. If it doesn't, warn the user.
59