@ironbee-ai/cli 0.8.0 → 0.8.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.8.2 (2026-05-08)
+
+### Features
+
+* **update:** warn on prefix mismatch and PATH shadow before installing ([675a1f3](https://github.com/ironbee-ai/ironbee-cli/commit/675a1f3b62350dc5e78469f62568409e967c81a3))
+
+## 0.8.1 (2026-05-08)
+
+### Bug Fixes
+
+* **ci:** bump release-npm to Node 22 + silence postinstall stderr noise ([ded3dbd](https://github.com/ironbee-ai/ironbee-cli/commit/ded3dbdfbe7447576ea6523d047eb5a55e669074))
+
 ## 0.8.0 (2026-05-08)
 
 ## 0.7.3 (2026-05-07)

package/dist/commands/update.d.ts

@@ -1,3 +1,26 @@
 import { Command } from "commander";
+/**
+ * Walk up from a known module dir to the npm prefix it sits under.
+ * Returns null when the dir is not in a recognizable npm global layout
+ * (e.g. ts-node dev runs from src/, or local node_modules installs).
+ */
+export declare function deriveInstallPrefix(dir: string): string | null;
+export interface PrefixMismatch {
+    running: string;
+    npm: string;
+}
+export declare function detectPrefixMismatch(runningDir: string, npmPrefix: string | null): PrefixMismatch | null;
+/**
+ * Derive the npm prefix from a binary path on PATH.
+ * - Unix: <prefix>/bin/<name> → prefix is the parent of the bin/ dir
+ * - Windows: <prefix>\<name>.cmd → prefix is the binary's directory
+ */
+export declare function derivePrefixFromBinary(binaryPath: string): string | null;
+export interface PathShadow {
+    shadowBinary: string;
+    shadowPrefix: string;
+    runningPrefix: string;
+}
+export declare function detectShadowOnPath(runningDir: string, firstPathBinary: string | null): PathShadow | null;
 export declare const updateCommand: Command;
 //# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,aAAa,EAAE,OAiCtB,CAAC"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiB9D;AA4BD,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,GAAG,IAAI,CASxG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASxE;AA6BD,MAAM,WAAW,UAAU;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,IAAI,CAaxG;AA+BD,eAAO,MAAM,aAAa,EAAE,OA4CtB,CAAC"}

package/dist/commands/update.js

@@ -1,10 +1,191 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateCommand = void 0;
+exports.deriveInstallPrefix = deriveInstallPrefix;
+exports.detectPrefixMismatch = detectPrefixMismatch;
+exports.derivePrefixFromBinary = derivePrefixFromBinary;
+exports.detectShadowOnPath = detectShadowOnPath;
 const commander_1 = require("commander");
 const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
 const output_1 = require("../lib/output");
 const version_1 = require("../lib/version");
+/**
+ * Walk up from a known module dir to the npm prefix it sits under.
+ * Returns null when the dir is not in a recognizable npm global layout
+ * (e.g. ts-node dev runs from src/, or local node_modules installs).
+ */
+function deriveInstallPrefix(dir) {
+    let cur = dir;
+    while (true) {
+        const parent = path.dirname(cur);
+        if (parent === cur) {
+            return null;
+        }
+        if (path.basename(cur) === "node_modules") {
+            // Unix global:  <prefix>/lib/node_modules
+            // Windows global: <prefix>/node_modules
+            if (path.basename(parent) === "lib") {
+                return path.dirname(parent);
+            }
+            return parent;
+        }
+        cur = parent;
+    }
+}
+function getNpmConfiguredPrefix() {
+    try {
+        const out = (0, child_process_1.execSync)("npm config get prefix", {
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        const trimmed = (out ?? "").toString().trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeForCompare(p) {
+    let resolved;
+    try {
+        resolved = (0, fs_1.realpathSync)(p);
+    }
+    catch {
+        resolved = path.resolve(p);
+    }
+    while (resolved.length > 1 && (resolved.endsWith("/") || resolved.endsWith(path.sep))) {
+        resolved = resolved.slice(0, -1);
+    }
+    return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+function detectPrefixMismatch(runningDir, npmPrefix) {
+    const running = deriveInstallPrefix(runningDir);
+    if (!running || !npmPrefix) {
+        return null;
+    }
+    if (normalizeForCompare(running) === normalizeForCompare(npmPrefix)) {
+        return null;
+    }
+    return { running, npm: npmPrefix };
+}
+/**
+ * Derive the npm prefix from a binary path on PATH.
+ * - Unix: <prefix>/bin/<name> → prefix is the parent of the bin/ dir
+ * - Windows: <prefix>\<name>.cmd → prefix is the binary's directory
+ */
+function derivePrefixFromBinary(binaryPath) {
+    if (!binaryPath) {
+        return null;
+    }
+    const dir = path.dirname(binaryPath);
+    if (process.platform !== "win32" && path.basename(dir) === "bin") {
+        return path.dirname(dir);
+    }
+    return dir;
+}
+function findFirstPathBinary(name) {
+    const pathEnv = process.env.PATH ?? "";
+    if (pathEnv.length === 0) {
+        return null;
+    }
+    const sep = process.platform === "win32" ? ";" : ":";
+    const dirs = pathEnv.split(sep);
+    const exts = process.platform === "win32"
+        ? (process.env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";")
+        : [""];
+    for (const dir of dirs) {
+        if (dir.length === 0) {
+            continue;
+        }
+        for (const ext of exts) {
+            const candidate = path.join(dir, name + ext);
+            try {
+                (0, fs_1.accessSync)(candidate, fs_1.constants.X_OK);
+                return candidate;
+            }
+            catch {
+                // not found / not executable, keep searching
+            }
+        }
+    }
+    return null;
+}
+function detectShadowOnPath(runningDir, firstPathBinary) {
+    const runningPrefix = deriveInstallPrefix(runningDir);
+    if (!runningPrefix || !firstPathBinary) {
+        return null;
+    }
+    const shadowPrefix = derivePrefixFromBinary(firstPathBinary);
+    if (!shadowPrefix) {
+        return null;
+    }
+    if (normalizeForCompare(runningPrefix) === normalizeForCompare(shadowPrefix)) {
+        return null;
+    }
+    return { shadowBinary: firstPathBinary, shadowPrefix, runningPrefix };
+}
+function warnPathShadow(s) {
+    const removeCmd = process.platform === "win32"
+        ? `del "${s.shadowBinary}"`
+        : `rm "${s.shadowBinary}"`;
+    output_1.log.blank();
+    output_1.log.warn(output_1.pc.bold("Another IronBee install is earlier on your PATH"));
+    output_1.log.warn(`  PATH-resolved binary: ${output_1.pc.cyan(s.shadowBinary)}`);
+    output_1.log.warn(`  This update is for:   ${output_1.pc.cyan(s.runningPrefix)}`);
+    output_1.log.warn("After install, your shell will keep resolving the OLDER one.");
+    output_1.log.warn("To fix, either:");
+    output_1.log.warn(`  1) Remove the shadow:  ${output_1.pc.cyan(removeCmd)}`);
+    output_1.log.warn("  2) Or install to the shadow's location:");
+    output_1.log.warn(`     ${output_1.pc.cyan(`npm install -g --prefix "${s.shadowPrefix}" @ironbee-ai/cli@latest`)}`);
+    output_1.log.blank();
+}
+function warnPrefixMismatch(mismatch) {
+    output_1.log.blank();
+    output_1.log.warn(output_1.pc.bold("Install location mismatch detected"));
+    output_1.log.warn(`  Active IronBee runs from: ${output_1.pc.cyan(mismatch.running)}`);
+    output_1.log.warn(`  npm install will write to: ${output_1.pc.cyan(mismatch.npm)}`);
+    output_1.log.warn("After install, your shell may keep resolving the OLD version on PATH.");
+    output_1.log.warn("To make the new version take effect, either:");
+    output_1.log.warn(`  1) Align npm prefix:  ${output_1.pc.cyan(`npm config set prefix "${mismatch.running}"`)}`);
+    output_1.log.warn("  2) Or install directly to the active location:");
+    output_1.log.warn(`     ${output_1.pc.cyan(`npm install -g --prefix "${mismatch.running}" @ironbee-ai/cli@latest`)}`);
+    output_1.log.blank();
+}
 exports.updateCommand = new commander_1.Command("update")
     .description("Update IronBee CLI to the latest version")
     .action(async () => {
@@ -21,6 +202,14 @@ exports.updateCommand = new commander_1.Command("update")
         return;
     }
     output_1.log.info(`New version available: ${output_1.pc.dim(local)} ${output_1.pc.yellow("→")} ${output_1.pc.green(output_1.pc.bold(latest))}`);
+    const mismatch = detectPrefixMismatch(__dirname, getNpmConfiguredPrefix());
+    if (mismatch) {
+        warnPrefixMismatch(mismatch);
+    }
+    const shadow = detectShadowOnPath(__dirname, findFirstPathBinary("ironbee"));
+    if (shadow) {
+        warnPathShadow(shadow);
+    }
     output_1.log.step(`Running ${output_1.pc.cyan("npm install -g @ironbee-ai/cli@latest")}...`);
     try {
         (0, child_process_1.execSync)("npm install -g @ironbee-ai/cli@latest", { stdio: "inherit" });

package/dist/commands/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AACpC,iDAAyC;AACzC,0CAAwC;AACxC,4CAAqE;AAExD,QAAA,aAAa,GAAY,IAAI,mBAAO,CAAC,QAAQ,CAAC;KACtD,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,KAAK,IAAmB,EAAE;IAC9B,MAAM,KAAK,GAAW,IAAA,yBAAe,GAAE,CAAC;IACxC,YAAG,CAAC,IAAI,CAAC,oBAAoB,WAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/C,YAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAErC,MAAM,MAAM,GAAkB,MAAM,IAAA,4BAAkB,GAAE,CAAC;IAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,YAAG,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACnB,YAAG,CAAC,OAAO,CAAC,kCAAkC,WAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;IACX,CAAC;IAED,YAAG,CAAC,IAAI,CAAC,0BAA0B,WAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,WAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,WAAE,CAAC,KAAK,CAAC,WAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACnG,YAAG,CAAC,IAAI,CAAC,WAAW,WAAE,CAAC,IAAI,CAAC,uCAAuC,CAAC,KAAK,CAAC,CAAC;IAE3E,IAAI,CAAC;QACD,IAAA,wBAAQ,EAAC,uCAAuC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACxE,YAAG,CAAC,KAAK,EAAE,CAAC;QACZ,YAAG,CAAC,OAAO,CAAC,cAAc,WAAE,CAAC,KAAK,CAAC,WAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;QACvD,YAAG,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACL,YAAG,CAAC,KAAK,EAAE,CAAC;QACZ,YAAG,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,KAAK,WAAE,CAAC,IAAI,CAAC,uCAAuC,CAAC,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ironbee-ai/cli",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "The CLI for IronBee — Verification and Intelligence Layer for Agentic Development",
   "main": "dist/index.js",
   "bin": {
@@ -8,6 +8,8 @@
   },
   "files": [
     "dist",
+    "scripts/run-postinstall.js",
+    "scripts/run-preuninstall.js",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
@@ -23,8 +25,8 @@
     "release:patch": "release-it patch --ci -VV",
     "release:minor": "release-it minor --ci -VV",
     "release:major": "release-it major --ci -VV",
-    "postinstall": "node dist/scripts/postinstall.js || true",
-    "preuninstall": "node dist/scripts/preuninstall.js || true"
+    "postinstall": "node scripts/run-postinstall.js",
+    "preuninstall": "node scripts/run-preuninstall.js"
   },
   "keywords": [
     "ai",

package/scripts/run-postinstall.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * Wrapper for the `postinstall` lifecycle hook.
+ *
+ * The published package ships `dist/scripts/postinstall.js` (compiled from
+ * `src/scripts/postinstall.ts`) and that's what we want to run when an
+ * end user installs the CLI via `npm install -g @ironbee-ai/cli`.
+ *
+ * In a fresh dev clone or CI checkout, `dist/` doesn't exist yet because
+ * `npm ci` runs lifecycle hooks BEFORE `npm run build`. The previous
+ * inline `node dist/scripts/postinstall.js || true` form swallowed the
+ * exit code at the shell level but still printed a `MODULE_NOT_FOUND`
+ * stack trace to stderr — confusing in CI logs and not portable to
+ * Windows cmd / PowerShell.
+ *
+ * This wrapper checks for the compiled file first and silently no-ops
+ * when it isn't there. Cross-platform, no stderr noise.
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const target = path.join(__dirname, "..", "dist", "scripts", "postinstall.js");
+if (!fs.existsSync(target)) {
+    // dist/ not built yet (dev clone, fresh CI before build) — skip.
+    process.exit(0);
+}
+
+try {
+    require(target);
+} catch (e) {
+    // Match the original `|| true` semantics: never break the install
+    // because the optional postinstall hook had a problem.
+    process.exit(0);
+}

package/scripts/run-preuninstall.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Wrapper for the `preuninstall` lifecycle hook. See
+ * `scripts/run-postinstall.js` for the why; same shape.
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const target = path.join(__dirname, "..", "dist", "scripts", "preuninstall.js");
+if (!fs.existsSync(target)) {
+    process.exit(0);
+}
+
+try {
+    require(target);
+} catch (e) {
+    process.exit(0);
+}