Use git tag name for release package version

- Build script now uses tag name (e.g., 1.0.0-rc1) instead of base
  version from manifest.json
- CI passes VERSION_TAG env var to build (git describe doesn't work
  in shallow checkout)
- Local builds still detect tags via git describe

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: richardkmichael

.github/workflows/release.yml

@@ -32,6 +32,8 @@ jobs:
 
       - name: Build extensions
         run: npm run build
+        env:
+          VERSION_TAG: ${{ github.ref_name }}
 
       - name: Create GitHub Release
         env:

CLAUDE.md

@@ -411,3 +411,12 @@ Error: Could not connect to Chrome. Check if Chrome is running and remote debugg
 ```
 
 Start Chrome manually with: `./chrome-canary.sh --start`
+
+# Release
+
+## Tags
+
+Releases use annotated, not lightweight, tags.  The annotated tag message is simply the tag name
+itself: `v1.0.0`, because the release notes explain the release content.
+
+Prerelease tags use `-rcX` notation, e.g., `v1.0.0-rc3`.

scripts/copy.js

@@ -18,15 +18,21 @@ if (!browser || !['chrome', 'firefox'].includes(browser)) {
 const TARGET = path.join(ROOT, 'build', browser);
 
 function getVersionName(baseVersion) {
+  // Check for VERSION_TAG env var (set by CI for release builds)
+  const versionTag = process.env.VERSION_TAG;
+  if (versionTag) {
+    return versionTag.startsWith('v') ? versionTag.slice(1) : versionTag;
+  }
+
   try {
     // Get short commit hash
     const commitHash = execSync('git rev-parse --short HEAD', { cwd: ROOT, encoding: 'utf8' }).trim();
 
-    // Check if HEAD is tagged (production release)
+    // Check if HEAD is tagged (release build)
     try {
-      execSync('git describe --exact-match HEAD', { cwd: ROOT, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
-      // HEAD is tagged - production build, use base version
-      return baseVersion;
+      const tag = execSync('git describe --exact-match HEAD', { cwd: ROOT, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+      // HEAD is tagged - use tag name as version (strip 'v' prefix if present)
+      return tag.startsWith('v') ? tag.slice(1) : tag;
     } catch {
       // Not tagged - development build
     }