Add README version parity check

Add scripts/check-readme-version.mjs to validate that the README.md "Current version/status" entry matches package.json version (pkg path can be overridden via README_VERSION_PKG_PATH). Wire it into package.json as "check:version-sync" and include it in the existing "check" script so version parity is enforced during prepublish checks. The script throws a clear error if the table row is missing or out of sync, and prints a success message when versions match.

Author: bradpotts

package.json

@@ -49,7 +49,8 @@
     "lint": "eslint .",
     "format": "prettier --write .",
     "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 check:ecosystem",
+    "check:version-sync": "node scripts/check-readme-version.mjs",
+    "check": "npm run typecheck && npm run lint && npm run build && npm run check:version-sync && npm run check:ecosystem",
     "prepublishOnly": "npm run check"
   },
   "dependencies": {

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