Automate package.json version bumping in release workflow (#190)

## Summary
Updated the NPM publish workflow to automatically bump the version in
`package.json` when a release is created, ensuring the published package
version matches the git release tag.

## Key Changes
- Updated permissions to allow writing to repository contents (required
for pushing commits)
- Removed outdated workflow comments
- Added automated version bumping step that extracts version from
release tag and updates `package.json`
- Added commit and push step to persist version changes back to the main
branch using GitHub Actions bot credentials
- Version bump occurs before the build and publish steps to ensure
consistency

## Implementation Details
- Version is extracted from `github.event.release.tag_name` and the `v`
prefix is stripped before applying to npm version command
- Uses `npm version` with `--no-git-tag-version` flag to update version
without creating duplicate git tags
- Commits both `package.json` and `package-lock.json` to maintain
lockfile consistency
- Pushes changes directly to main branch after release creation

https://claude.ai/code/session_01CAvVi3i1zrJrf1B7KsRj8o

Co-authored-by: Claude <noreply@anthropic.com>

Author: bartveneman

.github/workflows/release.yml

@@ -1,6 +1,3 @@
-# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
-# For more information see: https://help.github.com/actions/language-and-framework-guides/publishing-nodejs-packages
-
 name: NPM Publish
 
 on:
@@ -9,7 +6,7 @@ on:
 
 permissions:
   id-token: write # Required for OIDC
-  contents: read
+  contents: write # Required to push version bump commit
 
 jobs:
   publish-npm:
@@ -23,5 +20,16 @@ jobs:
       - run: npm install -g npm@latest
       - run: npm ci --ignore-scripts --no-audit --no-fund
       - run: npm test
+      - name: Bump version in package.json
+        run: |
+          VERSION="${{ github.event.release.tag_name }}"
+          npm version "${VERSION#v}" --no-git-tag-version
+      - name: Commit and push version bump
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add package.json package-lock.json
+          git commit -m "chore: bump version to ${{ github.event.release.tag_name }}"
+          git push origin HEAD:main
       - run: npm run build
       - run: npm publish --access public