Add one-command release process via npm version hooks

preversion checks: on main, clean tree, up to date with remote
postversion: pushes commit + tag, triggering the CI release workflow
Releasing is now: npm version patch|minor|major

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: freddiecoleman

README.md

@@ -159,6 +159,16 @@ npm run build     # compile to dist/
 npm run dev       # run directly with tsx (no build step)
 ```
 
+## Releasing
+
+```bash
+npm version patch   # bug fix  (0.1.0 → 0.1.1)
+npm version minor   # feature  (0.1.0 → 0.2.0)
+npm version major   # breaking (0.1.0 → 1.0.0)
+```
+
+Checks that you're on a clean, up-to-date main branch, bumps the version, commits, tags, and pushes. CI publishes to npm.
+
 ## Built by
 
 [Spacetime Technology](https://github.com/spacetime-technology)

package.json

@@ -12,6 +12,8 @@
   ],
   "scripts": {
     "prepare": "husky",
+    "preversion": "bash scripts/prerelease.sh",
+    "postversion": "git push --follow-tags origin main",
     "prepublishOnly": "npm run build",
     "build": "tsc -p tsconfig.build.json",
     "dev": "tsx src/index.ts",

scripts/prerelease.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+set -e
+
+branch=$(git branch --show-current)
+[ "$branch" = "main" ] || { echo "error: on branch '$branch', must be on main"; exit 1; }
+
+[ -z "$(git status --porcelain)" ] || { echo "error: working tree is dirty — commit or stash first"; exit 1; }
+
+git fetch origin main --quiet
+[ "$(git rev-parse HEAD)" = "$(git rev-parse origin/main)" ] || { echo "error: not up to date with origin/main — pull first"; exit 1; }
+
+echo "checks passed"