feat: add version consistency check for examples

Add scripts/check-versions.mjs to verify that example package.json files
reference the correct version of @modelcontextprotocol/ext-apps.

- Allows "../.." (local dev) or "^{root-version}" as valid dependencies
- Runs in CI before npm install to catch mismatches early
- Available locally via `npm run check:versions`

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

Co-Authored-By: Claude <[email protected]>

Author: ochafik

.github/workflows/ci.yml

@@ -36,6 +36,10 @@ jobs:
         shell: bash
         run: '! grep -E "\"resolved\": \"https?://" package-lock.json | grep -v registry.npmjs.org'
 
+      - name: Verify example dependency versions
+        shell: bash
+        run: node scripts/check-versions.mjs
+
       - uses: actions/setup-node@v4
         with:
           node-version: "20"

package.json

@@ -57,7 +57,8 @@
     "docs": "typedoc",
     "docs:watch": "typedoc --watch",
     "prettier": "prettier -u \"**/*.{js,jsx,ts,tsx,mjs,json,md,yml,yaml}\" --check",
-    "prettier:fix": "prettier -u \"**/*.{js,jsx,ts,tsx,mjs,json,md,yml,yaml}\" --write"
+    "prettier:fix": "prettier -u \"**/*.{js,jsx,ts,tsx,mjs,json,md,yml,yaml}\" --write",
+    "check:versions": "node scripts/check-versions.mjs"
   },
   "author": "Olivier Chafik",
   "devDependencies": {

scripts/check-versions.mjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * Checks that example package.json files reference the same version
+ * of @modelcontextprotocol/ext-apps as the root package.json.
+ *
+ * This ensures examples stay in sync with the library version.
+ */
+
+import { readFileSync, readdirSync, statSync, existsSync } from "fs";
+import { join } from "path";
+
+const rootPkg = JSON.parse(readFileSync("package.json", "utf-8"));
+const rootVersion = rootPkg.version;
+const pkgName = rootPkg.name;
+
+const expectedDep = `^${rootVersion}`;
+
+let hasError = false;
+
+const examplesDir = "examples";
+const examples = readdirSync(examplesDir).filter((d) => {
+  const pkgPath = join(examplesDir, d, "package.json");
+  return statSync(join(examplesDir, d)).isDirectory() && existsSync(pkgPath);
+});
+
+for (const example of examples) {
+  const pkgPath = join(examplesDir, example, "package.json");
+  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+
+  const dep = pkg.dependencies?.[pkgName];
+  // Allow "../.." (local dev) or the correct versioned dependency
+  if (dep && dep !== expectedDep && dep !== "../..") {
+    console.error(
+      `❌ ${pkgPath}: expected "${pkgName}": "${expectedDep}" (or "../.."), got "${dep}"`,
+    );
+    hasError = true;
+  }
+}
+
+if (hasError) {
+  console.error(
+    `\nRun the following to fix:\n  npm pkg set dependencies.${pkgName}=${expectedDep} --workspaces`,
+  );
+  process.exit(1);
+} else {
+  console.log(
+    `✅ All examples reference ${pkgName}@${expectedDep} (root version: ${rootVersion})`,
+  );
+}