toga-ai 1.0.21 → 1.0.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toga-ai",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
   "keywords": [
     "claude",

package/scripts/install.js

@@ -45,6 +45,25 @@ function getBundleVersion() {
   }
 }
 
+function getLatestNpmVersion() {
+  try {
+    const result = spawnSync('npm', ['view', 'toga-ai', 'version', '--json'], {
+      stdio: 'pipe', shell: false, timeout: 5000,
+    });
+    if (result.status !== 0 || !result.stdout) return null;
+    return result.stdout.toString().trim().replace(/"/g, '');
+  } catch (e) { return null; }
+}
+
+function semverLt(a, b) {
+  const parse = (v) => v.replace(/[^0-9.]/g, '').split('.').map(Number);
+  const [aMajor, aMinor, aPatch] = parse(a);
+  const [bMajor, bMinor, bPatch] = parse(b);
+  if (aMajor !== bMajor) return aMajor < bMajor;
+  if (aMinor !== bMinor) return aMinor < bMinor;
+  return aPatch < bPatch;
+}
+
 /* ------------------------------------------------------------------ */
 /* repo discovery (git update source)                                   */
 /* ------------------------------------------------------------------ */
@@ -491,6 +510,25 @@ function main() {
 
   const bundleVersion = getBundleVersion();
 
+  // Warn if running a stale npx-cached version (common Windows problem).
+  // Skip during --post-install (npm already ran the right version).
+  if (!isPostInstall) {
+    const latestVersion = getLatestNpmVersion();
+    if (latestVersion && semverLt(bundleVersion, latestVersion)) {
+      console.log('');
+      console.log('⚠  STALE VERSION DETECTED');
+      console.log('═════════════════════════════════════════════');
+      console.log('  You are running toga-ai@' + bundleVersion + ' but toga-ai@' + latestVersion + ' is available.');
+      console.log('  Your npx cache has an old version. Run the following to fix it:');
+      console.log('');
+      console.log('    npm cache clean --force');
+      console.log('    npx toga-ai@latest');
+      console.log('');
+      console.log('  (This is a common npx caching issue on Windows.)');
+      process.exit(1);
+    }
+  }
+
   console.log('');
   console.log('toga-ai — TOGA Technology Claude harness');
   console.log('═════════════════════════════════════════════');