Add README version parity check

Introduce scripts/check-readme-version.mjs to verify the README's "Current version/status" entry matches package.json. Add a new npm script check:version-sync and wire it into the overall check pipeline so CI/prepublish fails if the README and package version drift. The script supports overriding the package path via README_VERSION_PKG_PATH and prints a success message when versions match.

Author: bradpotts

package.json

@@ -55,7 +55,8 @@
     "lint": "eslint src tests",
     "test": "vitest run",
     "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 run test && npm run check:ecosystem",
+    "check:version-sync": "node scripts/check-readme-version.mjs",
+    "check": "npm run typecheck && npm run lint && npm run build && npm run test && npm run check:version-sync && npm run check:ecosystem",
     "prepublishOnly": "npm run check"
   },
   "devDependencies": {

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})`);