Add README version check script and npm hook

Introduce scripts/check-readme-version.mjs to verify the "Current version/status" entry in README.md's Repository Snapshot table matches package.json (or a package file set via README_VERSION_PKG_PATH). Add an npm script check:version-sync and run it as part of the composite "check" task so version parity is enforced during prepublish/check flows. The script errors on mismatch and prints an OK message when versions match.

Author: bradpotts

package.json

@@ -39,7 +39,8 @@
     "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,css,md}\"",
     "format:md": "prettier --write \"**/*.md\"",
     "check:ecosystem": "spectre-manifest-validate spectre.manifest.json && spectre-manifest-check spectre.manifest.json .",
-    "check": "npm run typecheck && npm run lint && npm run build && npm test -- --run && npm run check:ecosystem",
+    "check:version-sync": "node scripts/check-readme-version.mjs",
+    "check": "npm run typecheck && npm run lint && npm run build && npm test -- --run && npm run check:version-sync && npm run check:ecosystem",
     "prepublishOnly": "npm run check"
   },
   "funding": [

scripts/check-readme-version.mjs

@@ -0,0 +1,26 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const repoRoot = resolve(import.meta.dirname, '..');
+
+const pkgPath = process.env.README_VERSION_PKG_PATH ?? 'package.json';
+const pkg = JSON.parse(readFileSync(resolve(repoRoot, pkgPath), 'utf-8'));
+const readme = readFileSync(resolve(repoRoot, 'README.md'), 'utf-8');
+
+const match = readme.match(/\|\s*Current version\/status\s*\|\s*([^\s|]+)\s*\|/i);
+
+if (!match) {
+  throw new Error(
+    'README.md is missing the "Current version/status" row in the Repository Snapshot table.',
+  );
+}
+
+const readmeVersion = match[1];
+
+if (readmeVersion !== pkg.version) {
+  throw new Error(
+    `README.md "Current version/status" is "${readmeVersion}" but ${pkgPath} version is "${pkg.version}". Update README.md to match.`,
+  );
+}
+
+console.log(`README version parity: OK (${pkg.version})`);