Add workflows to automate releases and publishing to npm

.github/workflows/publish.yml

@@ -0,0 +1,23 @@
+name: Publish to npm
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org
+      - run: npm ci
+      - run: npm run check:ci
+      - run: npm run test:run
+      - run: npm publish --provenance --access public

.github/workflows/release.yml

@@ -0,0 +1,24 @@
+name: Create GitHub Release
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Tag to release (for example: v1.2.3)"
+        required: true
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Create release from tag
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG_NAME: ${{ inputs.tag || github.ref_name }}
+        run: gh release create "$TAG_NAME" --generate-notes

README.md

@@ -148,7 +148,6 @@ sosumi fetch https://developer.apple.com/documentation/swift/array --json
 sosumi search "SwiftData" --json
 ```
 
-
 ### Chrome Extension
 
 You can also use Sosumi from a community-contributed 
@@ -263,6 +262,18 @@ be sure to re-run:
 npm run cf-typegen
 ```
 
+### Publishing
+
+Publishing is handled by two GitHub Actions workflows:
+
+- Release creation: `.github/workflows/release.yml`
+  - Trigger: pushed tags matching `v*` or manual dispatch with `tag`
+  - Command: `gh release create "$TAG_NAME" --generate-notes`
+- npm publish: `.github/workflows/publish.yml`
+  - Trigger: GitHub Release published (`release.published`)
+  - Auth: npm trusted publishing via OIDC (`id-token: write`)
+  - Command: `npm publish --provenance --access public`
+
 ## License
 
 This project is available under the MIT license.