Add GitHub Actions workflow for automated NPM publishing

This workflow automates the process of publishing the package to NPM when a new GitHub release is created. It includes:
- Setting up Node.js 20 environment
- Building and testing the package
- Extracting version from the release tag
- Publishing to NPM with provenance for enhanced security

Author: alexs-forgood-ai

.github/workflows/npm.yml

@@ -0,0 +1,50 @@
+name: Publish to NPM
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write # Required for npm provenance
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+    
+    - name: Set up Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+        registry-url: 'https://registry.npmjs.org'
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Build package
+      run: npm run build
+
+    - name: Run tests
+      run: npm test
+    
+    - name: Extract version from tag
+      id: version
+      run: |
+        # Remove 'v' prefix if present (e.g., v1.0.0 -> 1.0.0)
+        VERSION=${GITHUB_REF#refs/tags/}
+        VERSION=${VERSION#v}
+        echo "version=${VERSION}" >> $GITHUB_OUTPUT
+        echo "Version: ${VERSION}"
+    
+    - name: Update package.json version
+      run: |
+        npm version ${{ steps.version.outputs.version }} --no-git-tag-version
+    
+    - name: Publish to NPM
+      run: npm publish --provenance --access public
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}