chore: add tag-driven npm publish workflow with provenance

Adds .github/workflows/release.yml, triggered by v* tags (publish) or
workflow_dispatch (dry-run rehearsal). Runs the same verify/typecheck/build
gate as CI, checks the pushed tag matches the built package version, then
publishes dist/packages/convex-angular with npm provenance.

Author: azhukaudev

.github/workflows/release.yml

@@ -0,0 +1,53 @@
+name: Release
+
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch: # dry-run rehearsal: runs everything except the publish
+
+permissions:
+  contents: read
+  id-token: write # npm provenance
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+          registry-url: https://registry.npmjs.org
+
+      - run: pnpm install --frozen-lockfile
+
+      - run: pnpm verify:full
+
+      - run: pnpm typecheck:spec
+
+      - run: pnpm build:library
+
+      # The tag must match the built manifest — a mis-tagged release fails here
+      # instead of publishing the wrong version.
+      - name: Check tag matches package version
+        if: github.event_name == 'push'
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          PKG="$(node -p "require('./dist/packages/convex-angular/package.json').version")"
+          [ "$TAG" = "$PKG" ] || { echo "tag v$TAG != package $PKG"; exit 1; }
+
+      - name: Publish (dry run)
+        if: github.event_name == 'workflow_dispatch'
+        run: npm publish dist/packages/convex-angular --dry-run
+
+      - name: Publish
+        if: github.event_name == 'push'
+        run: npm publish dist/packages/convex-angular --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

CLAUDE.md

@@ -105,4 +105,4 @@ UI uses Angular Material 3 + SCSS. The theme lives in `src/styles.scss` (`mat.th
 - Tests are Jest via `jest-preset-angular`; specs live next to source as `*.spec.ts`. Both projects use the shared `jest.preset.js`.
 - Prettier: single quotes, `printWidth` 120, trailing commas. Imports are auto-sorted (`@ianvs/prettier-plugin-sort-imports`): builtins → third-party → `@convex-angular/*` → relative.
 - Public API surface is documented with TSDoc `@public`/`@internal` tags; keep new exports annotated and re-exported from `index.ts`.
-- Releases use Nx release (`nx.json` `release`), versioned from git tags; the library version lives in `packages/convex-angular/package.json`.
+- Releases use Nx release (`nx.json` `release`), versioned from git tags; the library version lives in `packages/convex-angular/package.json`. Pushing a `v*` tag triggers `.github/workflows/release.yml` (verify → build → tag/version consistency check → `npm publish --provenance`); `workflow_dispatch` runs the same pipeline as a dry run.