@axiomatic-labs/claudeflow 2.12.231 → 2.12.233

package/lib/install.js

@@ -274,9 +274,15 @@ async function run() {
 
 function ensureGlobalCli(version) {
   // Returns { available: boolean, autoInstalled: boolean, upgraded: boolean, fromVersion?: string, error?: string }
-  const present = commandExists('claudeflow');
-  const installedVersion = present ? readGlobalCliVersion() : null;
-  const needsUpgrade = present && installedVersion && installedVersion !== version;
+  // `commandExists('claudeflow')` yields a false positive when install.js runs
+  // under `npx @axiomatic-labs/claudeflow ...` — npx injects its own
+  // `node_modules/.bin` into PATH and the subprocess sees the self-referential
+  // binary even though nothing is installed globally. Cross-check against
+  // `npm ls -g` (which never reports the npx cache) so the auto-installer
+  // does not skip a missing global.
+  const installedVersion = readGlobalCliVersion();
+  const present = Boolean(installedVersion);
+  const needsUpgrade = present && installedVersion !== version;
 
   if (present && !needsUpgrade) {
     return { available: true, autoInstalled: false, upgraded: false };
@@ -307,7 +313,12 @@ function ensureGlobalCli(version) {
       stdio: ['ignore', 'pipe', 'pipe'],
       timeout: 120000,
     });
-    if (commandExists('claudeflow')) {
+    // Verify with `npm ls -g` rather than `command -v`. Under npx, the
+    // subprocess PATH still contains the npx cache, so `command -v`
+    // would report true even if the global install wrote to a prefix
+    // that the user's shell cannot see.
+    const afterVersion = readGlobalCliVersion();
+    if (afterVersion) {
       return {
         available: true,
         autoInstalled: !needsUpgrade,
@@ -319,7 +330,7 @@ function ensureGlobalCli(version) {
       available: false,
       autoInstalled: false,
       upgraded: false,
-      error: 'installed but not on PATH',
+      error: 'installed but `npm ls -g` cannot see it — verify `npm config get prefix` is on $PATH',
     };
   } catch (err) {
     const msg = err?.stderr?.toString?.() || err?.message || String(err);
@@ -994,4 +1005,6 @@ module.exports = Object.assign(run, {
   isTemplateManagedAgent,
   listTemplateManagedAgents,
   mergeClaudeSettings,
+  commandExists,
+  readGlobalCliVersion,
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiomatic-labs/claudeflow",
-  "version": "2.12.231",
+  "version": "2.12.233",
   "description": "Claudeflow — AI-powered development toolkit for Claude Code. Skills, agents, hooks, and quality gates that ship production apps.",
   "bin": {
     "claudeflow": "./bin/cli.js"