botmux 3.18.3 → 3.18.5

package/dist/utils/install-info.d.ts

@@ -1,7 +1,24 @@
 /** Pure check: is `rootDir` a source working copy rather than an npm install? */
 export declare function isLocalDevInstallAt(rootDir: string): boolean;
-/** Classify this running install. Cached — it cannot change at runtime. */
+/**
+ * Classify this running install. Cached — it cannot change at runtime.
+ *
+ * ⚠️ A COMPILED BINARY IS NEVER A SOURCE CHECKOUT, and the naive check cannot
+ * see that. `packageRoot()` walks up looking for package.json; inside a
+ * single-file executable there is none on disk (the module graph lives in the
+ * virtual `/$bunfs/`), so it returns `/` — and the test then becomes "does the
+ * FILESYSTEM ROOT have .git or src?". On this box neither exists so the answer is
+ * accidentally correct, but plenty of container images do have `/src`, and there
+ * the compiled binary would be misclassified as a dev checkout and sent down the
+ * `git pull --ff-only` update path.
+ *
+ * The standalone check is therefore an explicit early return, not a refinement of
+ * the filesystem probe. Node behaviour is bit-for-bit unchanged.
+ */
 export declare function isLocalDevInstall(): boolean;
+/** Test seam: drop the cached classification. Production never calls this — the
+ *  answer genuinely cannot change within one process. */
+export declare function __resetLocalDevInstallCacheForTests(): void;
 /**
  * The version baked in at compile time by scripts/build-bun-binary.mjs, or
  * undefined when running from Node.
@@ -25,6 +42,25 @@ export declare function bakedBinaryVersion(): string | undefined;
  *  npm-global install this is the real published version; in a source checkout
  *  it's the unbuilt '0.0.0' (CI injects the real version at publish). */
 export declare function botmuxVersionAt(rootDir: string): string;
+/**
+ * The version recorded in `rootDir`'s package.json, IGNORING the baked value.
+ *
+ * ⚠️ WHY THIS EXISTS — THE BAKED VERSION SHADOWS A COMPLETED UPDATE. `baked` is
+ * compiled into the running executable, so `botmuxVersionAt` returns it no matter
+ * which directory you ask about. That is right for "what am I running", and WRONG
+ * for "what is now installed on disk": after a package-manager update replaces the
+ * install tree, a compiled binary asking `botmuxVersionAt(root)` still gets its OWN
+ * old version (measured: package.json says 3.19.0, the call returns 3.18.4).
+ *
+ * The maintenance tick gates its restart on `after !== before`, so that shadowing
+ * makes a successful update look like "already on the latest version" — it never
+ * restarts onto what it just installed. Post-update reads must therefore use this
+ * function, not `botmuxVersionAt`.
+ *
+ * (Under Node `bakedBinaryVersion()` is undefined, so the two are identical there
+ * — which is why this defect only surfaces for the compiled binary.)
+ */
+export declare function diskVersionAt(rootDir: string): string;
 export declare function botmuxVersion(): string;
 /** Absolute path to this install's CLI entrypoint (`dist/cli.js`). The correct
  *  way to restart is `node <this>/dist/cli.js restart` — a raw `pm2 restart`

package/dist/utils/install-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-info.d.ts","sourceRoot":"","sources":["../../src/utils/install-info.ts"],"names":[],"mappings":"AAcA,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAID,2EAA2E;AAC3E,wBAAgB,iBAAiB,IAAI,OAAO,CAG3C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CASvD;AAED;;yEAEyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;+CAE+C;AAC/C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;iEAEiE;AACjE,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}
+{"version":3,"file":"install-info.d.ts","sourceRoot":"","sources":["../../src/utils/install-info.ts"],"names":[],"mappings":"AAeA,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAK3C;AAED;yDACyD;AACzD,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CASvD;AAED;;yEAEyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;+CAE+C;AAC/C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;iEAEiE;AACjE,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/utils/install-info.js

@@ -11,17 +11,38 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { isStandaloneBinary } from '../core/self-spawn.js';
 /** Pure check: is `rootDir` a source working copy rather than an npm install? */
 export function isLocalDevInstallAt(rootDir) {
     return existsSync(join(rootDir, '.git')) || existsSync(join(rootDir, 'src'));
 }
 let cached;
-/** Classify this running install. Cached — it cannot change at runtime. */
+/**
+ * Classify this running install. Cached — it cannot change at runtime.
+ *
+ * ⚠️ A COMPILED BINARY IS NEVER A SOURCE CHECKOUT, and the naive check cannot
+ * see that. `packageRoot()` walks up looking for package.json; inside a
+ * single-file executable there is none on disk (the module graph lives in the
+ * virtual `/$bunfs/`), so it returns `/` — and the test then becomes "does the
+ * FILESYSTEM ROOT have .git or src?". On this box neither exists so the answer is
+ * accidentally correct, but plenty of container images do have `/src`, and there
+ * the compiled binary would be misclassified as a dev checkout and sent down the
+ * `git pull --ff-only` update path.
+ *
+ * The standalone check is therefore an explicit early return, not a refinement of
+ * the filesystem probe. Node behaviour is bit-for-bit unchanged.
+ */
 export function isLocalDevInstall() {
-    if (cached === undefined)
-        cached = isLocalDevInstallAt(packageRoot());
+    if (cached === undefined) {
+        cached = isStandaloneBinary() ? false : isLocalDevInstallAt(packageRoot());
+    }
     return cached;
 }
+/** Test seam: drop the cached classification. Production never calls this — the
+ *  answer genuinely cannot change within one process. */
+export function __resetLocalDevInstallCacheForTests() {
+    cached = undefined;
+}
 /**
  * The version baked in at compile time by scripts/build-bun-binary.mjs, or
  * undefined when running from Node.
@@ -60,6 +81,27 @@ export function botmuxVersionAt(rootDir) {
     const baked = bakedBinaryVersion();
     if (baked)
         return baked;
+    return diskVersionAt(rootDir);
+}
+/**
+ * The version recorded in `rootDir`'s package.json, IGNORING the baked value.
+ *
+ * ⚠️ WHY THIS EXISTS — THE BAKED VERSION SHADOWS A COMPLETED UPDATE. `baked` is
+ * compiled into the running executable, so `botmuxVersionAt` returns it no matter
+ * which directory you ask about. That is right for "what am I running", and WRONG
+ * for "what is now installed on disk": after a package-manager update replaces the
+ * install tree, a compiled binary asking `botmuxVersionAt(root)` still gets its OWN
+ * old version (measured: package.json says 3.19.0, the call returns 3.18.4).
+ *
+ * The maintenance tick gates its restart on `after !== before`, so that shadowing
+ * makes a successful update look like "already on the latest version" — it never
+ * restarts onto what it just installed. Post-update reads must therefore use this
+ * function, not `botmuxVersionAt`.
+ *
+ * (Under Node `bakedBinaryVersion()` is undefined, so the two are identical there
+ * — which is why this defect only surfaces for the compiled binary.)
+ */
+export function diskVersionAt(rootDir) {
     try {
         const pkg = JSON.parse(readFileSync(join(rootDir, 'package.json'), 'utf-8'));
         return typeof pkg.version === 'string' ? pkg.version : '0.0.0';

package/dist/utils/install-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"install-info.js","sourceRoot":"","sources":["../../src/utils/install-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,iFAAiF;AACjF,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,IAAI,MAA2B,CAAC;AAEhC,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB;IAC/B,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,8EAA8E;IAC9E,2EAA2E;IAC3E,6DAA6D;IAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAClE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;yEAEyE;AACzE,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,4EAA4E;IAC5E,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7E,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;+CAE+C;AAC/C,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;iEAEiE;AACjE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC;AAED,2EAA2E;AAC3E,SAAS,WAAW;IAClB,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QACtD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"install-info.js","sourceRoot":"","sources":["../../src/utils/install-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,iFAAiF;AACjF,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,IAAI,MAA2B,CAAC;AAEhC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,GAAG,kBAAkB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;yDACyD;AACzD,MAAM,UAAU,mCAAmC;IACjD,MAAM,GAAG,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,8EAA8E;IAC9E,2EAA2E;IAC3E,6DAA6D;IAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAClE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;yEAEyE;AACzE,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,4EAA4E;IAC5E,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7E,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;+CAE+C;AAC/C,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;iEAEiE;AACjE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC;AAED,2EAA2E;AAC3E,SAAS,WAAW;IAClB,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QACtD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/workflows/v3/daemon-ipc-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon-ipc-client.d.ts","sourceRoot":"","sources":["../../../src/workflows/v3/daemon-ipc-client.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAML,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5E,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,oCAAqC,SAAQ,KAAK;aAChB,UAAU,CAAC,EAAE,OAAO;gBAArD,OAAO,EAAE,MAAM,EAAkB,UAAU,CAAC,EAAE,OAAO,YAAA;CAIlE;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,IAAI,CACV,gBAAgB,EAChB,WAAW,GAAG,SAAS,GAAG,gBAAgB,GAAG,qBAAqB,CACnE,GACA,uBAAuB,CAWzB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,MAAM,EAAE,IAAI,CACV,gBAAgB,EAChB,WAAW,GAAG,SAAS,GAAG,gBAAgB,GAAG,qBAAqB,CACnE,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,sBAAsB,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAgD1C"}
+{"version":3,"file":"daemon-ipc-client.d.ts","sourceRoot":"","sources":["../../../src/workflows/v3/daemon-ipc-client.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,EAML,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5E,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,oCAAqC,SAAQ,KAAK;aAChB,UAAU,CAAC,EAAE,OAAO;gBAArD,OAAO,EAAE,MAAM,EAAkB,UAAU,CAAC,EAAE,OAAO,YAAA;CAIlE;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,IAAI,CACV,gBAAgB,EAChB,WAAW,GAAG,SAAS,GAAG,gBAAgB,GAAG,qBAAqB,CACnE,GACA,uBAAuB,CAWzB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,MAAM,EAAE,IAAI,CACV,gBAAgB,EAChB,WAAW,GAAG,SAAS,GAAG,gBAAgB,GAAG,qBAAqB,CACnE,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,sBAAsB,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAgD1C"}

package/dist/workflows/v3/daemon-ipc-client.js

@@ -1,4 +1,5 @@
 /** Shared client for authenticated Workflow v3 daemon mutations. */
+import { loopbackFetchImpl } from '../../core/loopback-fetch.js';
 import { generateWorkflowDaemonIpcNonce, loadWorkflowDaemonIpcSecret, WORKFLOW_DAEMON_IPC_ROUTE_PREFIX, verifyWorkflowDaemonIpcResponse, workflowDaemonIpcHeaders, } from './daemon-ipc-auth.js';
 export class WorkflowDaemonMutationTransportError extends Error {
     causeValue;
@@ -42,7 +43,7 @@ export async function postWorkflowDaemonMutation(input) {
         timestamp,
         nonce,
     });
-    const fetchImpl = input.fetchImpl ?? fetch;
+    const fetchImpl = input.fetchImpl ?? loopbackFetchImpl;
     let response;
     try {
         response = await fetchImpl(`http://127.0.0.1:${target.ipcPort}${pathWithQuery}`, {

package/dist/workflows/v3/daemon-ipc-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"daemon-ipc-client.js","sourceRoot":"","sources":["../../../src/workflows/v3/daemon-ipc-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"daemon-ipc-client.js","sourceRoot":"","sources":["../../../src/workflows/v3/daemon-ipc-client.ts"],"names":[],"mappings":"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"}

package/dist/workflows/v3/session-relay-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-relay-client.d.ts","sourceRoot":"","sources":["../../../src/workflows/v3/session-relay-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,2BAA2B,EAC5B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAIrG,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE;IACvD,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,2BAA2B,CAAC;IAC/C,UAAU,CAAC,EAAE,OAAO,0BAA0B,CAAC;CAChD,GAAG,2BAA2B,GAAG,IAAI,CAgCrC;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAC1D,OAAO,EAAE,2BAA2B,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,sBAAsB,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;IACvE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAqC1C"}
+{"version":3,"file":"session-relay-client.d.ts","sourceRoot":"","sources":["../../../src/workflows/v3/session-relay-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,2BAA2B,EAC5B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAKrG,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE;IACvD,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,2BAA2B,CAAC;IAC/C,UAAU,CAAC,EAAE,OAAO,0BAA0B,CAAC;CAChD,GAAG,2BAA2B,GAAG,IAAI,CAgCrC;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAC1D,OAAO,EAAE,2BAA2B,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,sBAAsB,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;IACvE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAqC1C"}

package/dist/workflows/v3/session-relay-client.js

@@ -16,6 +16,7 @@ import { readManagedOriginCapability, } from '../../core/managed-origin-capabili
 import { findAncestorSessionContext } from '../../core/session-marker.js';
 import { WorkflowDaemonMutationTransportError } from './daemon-ipc-client.js';
 import { V3_SESSION_RUN_MUTATION_ROUTE_PREFIX } from './session-relay.js';
+import { loopbackFetchImpl } from '../../core/loopback-fetch.js';
 /**
  * Detect an isolated session and load its per-turn capability.
  *
@@ -83,7 +84,7 @@ export async function postWorkflowSessionRunMutation(input) {
             ? { originDispatchAttempt: input.context.dispatchAttempt }
             : {}),
     });
-    const fetchImpl = input.fetchImpl ?? fetch;
+    const fetchImpl = input.fetchImpl ?? loopbackFetchImpl;
     let response;
     try {
         response = await fetchImpl(`http://127.0.0.1:${ipcPort}${path}`, {

package/dist/workflows/v3/session-relay-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-relay-client.js","sourceRoot":"","sources":["../../../src/workflows/v3/session-relay-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-relay-client.js","sourceRoot":"","sources":["../../../src/workflows/v3/session-relay-client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "botmux",
-  "version": "3.18.3",
+  "version": "3.18.5",
   "description": "Bridge between IM platforms and AI coding CLIs — one topic, one CLI session with live streaming",
   "type": "module",
   "main": "dist/index-daemon.js",
   "files": [
     "dist/",
     "scripts/postinstall-bin.mjs",
+    "scripts/install-path-entry.mjs",
     "ecosystem.config.cjs",
     "README.md",
     "README.en.md",
@@ -79,12 +80,12 @@
   },
   "optionalDependencies": {
     "@napi-rs/canvas": "^0.1.65",
-    "botmux-darwin-arm64": "3.18.3",
-    "botmux-darwin-x64": "3.18.3",
-    "botmux-linux-arm64": "3.18.3",
-    "botmux-linux-arm64-musl": "3.18.3",
-    "botmux-linux-x64": "3.18.3",
-    "botmux-linux-x64-musl": "3.18.3"
+    "botmux-darwin-arm64": "3.18.5",
+    "botmux-darwin-x64": "3.18.5",
+    "botmux-linux-arm64": "3.18.5",
+    "botmux-linux-arm64-musl": "3.18.5",
+    "botmux-linux-x64": "3.18.5",
+    "botmux-linux-x64-musl": "3.18.5"
   },
   "devDependencies": {
     "@midscene/web": "^1.7.6",

package/scripts/install-path-entry.mjs

@@ -0,0 +1,263 @@
+/**
+ * Put `~/.botmux/bin` on the user's PATH by writing their shell's startup file.
+ *
+ * WHY THIS EXISTS
+ * `npm i -g botmux` has no `bin` field (removed with the Node fallback — see
+ * postinstall-bin.mjs), so the ONLY `botmux` command is the launcher written to
+ * `~/.botmux/bin/botmux`. If that directory is not on PATH, a successful install
+ * still leaves the user with `botmux: command not found`.
+ *
+ * Both installers used to just PRINT a hint, and the hint was:
+ *
+ *     echo 'export PATH="…"' >> ~/.profile
+ *
+ * which is wrong for a large share of users, because **zsh never reads
+ * `~/.profile`** (measured: `zsh -lic` on a home dir containing `.profile` reads
+ * `.zshenv` + `.zprofile` + `.zshrc` and the `.profile` echo never fires). A zsh
+ * user who followed the hint verbatim got a file that is silently ignored — the
+ * command stayed missing with no indication why. That was the reported bug.
+ *
+ * ── WHICH FILE PER SHELL (all measured, not recalled) ─────────────────────────
+ * Startup files actually sourced, by shell and invocation mode:
+ *
+ *   zsh   -c  → .zshenv
+ *         -i  → .zshenv .zshrc
+ *         -li → .zshenv .zprofile .zshrc
+ *   bash  -c  → (none)
+ *         -i  → .bashrc
+ *         -li → the FIRST of .bash_profile → .bash_login → .profile
+ *   fish      → ~/.config/fish/conf.d/*.fish in all three modes
+ *
+ * So the target per shell is the file that covers the most modes:
+ *   • zsh  → ~/.zshenv                       (the only file read in all 3)
+ *   • bash → ~/.bashrc AND its login file    (login vs interactive are disjoint)
+ *   • fish → ~/.config/fish/conf.d/botmux.fish
+ *
+ * bash genuinely needs both: writing only `.bashrc` misses login shells, and
+ * writing only the login file misses ordinary interactive ones.
+ *
+ * ⚠️ bash's login file is "the first that EXISTS", not always `.bash_profile` —
+ * see bashLoginFile() below for why creating the wrong one destroys the user's
+ * existing login config.
+ *
+ * ── fish SYNTAX ──────────────────────────────────────────────────────────────
+ * fish is not POSIX; `export PATH="$INSTALL_DIR:$PATH"` is not its syntax. (fish
+ * 3.6 happens to tolerate `export` as a compatibility shim and even produces a
+ * correct PATH — measured — but `set -gx` is the real form and is what we write.)
+ */
+
+import { existsSync, readFileSync, appendFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { basename } from 'node:path';
+
+/** Marker so we can detect our own previous edit and never write twice. */
+export const PATH_ENTRY_MARKER = '# added by botmux installer';
+
+/**
+ * Which shell is the user actually on? `$SHELL` is the login shell recorded in
+ * passwd, which is what future terminals will start — the right question here,
+ * and better than `process.ppid` guessing (the parent of a postinstall is npm,
+ * not the user's shell).
+ */
+export function detectShell(env = process.env) {
+  const shell = env.SHELL ?? '';
+  const name = basename(shell);
+  if (name.includes('zsh')) return 'zsh';
+  if (name.includes('fish')) return 'fish';
+  if (name.includes('bash')) return 'bash';
+  // Unknown or unset (containers, cron, exotic shells): POSIX `.profile` is the
+  // most portable thing we can offer, and sh/ksh/dash all read it at login.
+  return name ? 'other' : 'unknown';
+}
+
+/**
+ * bash's LOGIN startup file, chosen without shadowing anything.
+ *
+ * ⚠️ bash reads only the FIRST of `.bash_profile` → `.bash_login` → `.profile`.
+ * So creating `.bash_profile` on a machine whose login config lives in
+ * `.profile` (or `.bash_login`) silently stops that file from ever being read.
+ * Measured — a sentinel exported from `.profile` is visible to `bash -lic`, and
+ * becomes MISSING the moment an unrelated `.bash_profile` appears; same for
+ * `.bash_login`. That is destroying the user's environment to fix a PATH entry,
+ * which is far worse than the bug being fixed.
+ *
+ * So: append to whichever of the three already exists (that is the file bash is
+ * actually reading), and only fall back to CREATING `.bash_profile` when none of
+ * them exists — in which case there is nothing to shadow.
+ */
+function bashLoginFile(home) {
+  for (const name of ['.bash_profile', '.bash_login', '.profile']) {
+    const file = join(home, name);
+    if (existsSync(file)) return file;
+  }
+  return join(home, '.bash_profile');
+}
+
+/**
+ * Quote a path for literal use inside a shell startup file.
+ *
+ * ⚠️ SECURITY, not cosmetics. The install dir is caller-controlled
+ * (`BOTMUX_INSTALL_DIR`, or just an unusual home), and the line we write is
+ * EXECUTED by the user's shell on every startup. Interpolating it into double
+ * quotes lets `$(…)`, backticks and `$VAR` run: measured — an install dir
+ * containing `$(touch /tmp/PWNED)` created that file the first time zsh started,
+ * and did so on every shell thereafter.
+ *
+ * Single quotes make the shell treat every byte literally; the only character
+ * needing care is `'` itself, closed and re-opened via `'\''`. This form is
+ * identical in POSIX shells and in fish.
+ */
+function shellQuote(value) {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+
+/**
+ * The startup files to write for a shell, plus the line to write into each.
+ * Returns [] when we have nothing safe to say.
+ *
+ * `env` is read for the two relocation variables below; both are honoured
+ * because writing the un-relocated path produces a file the shell never reads —
+ * the same class of bug as writing `.profile` for zsh.
+ */
+export function pathEntryTargets(shell, installDir, home = homedir(), env = process.env) {
+  const q = shellQuote(installDir);
+  // ⚠️ The STATEMENT has to be idempotent too, not just the file write. An
+  // unconditional `export PATH=<dir>:$PATH` re-prepends on every shell startup, so
+  // a nested or re-sourced shell keeps growing PATH — measured: the same directory
+  // appeared twice at nesting depth 2, and `.bash_profile` files that source
+  // `.bashrc` hit it within a single login. `case` is POSIX and quote-safe (no
+  // subshell, no `grep`), and the `:` padding makes it an exact ELEMENT test, so a
+  // sibling like `<dir>-old` never satisfies it.
+  const posix = `case ":$PATH:" in *:${q}:*) ;; *) export PATH=${q}":$PATH" ;; esac  ${PATH_ENTRY_MARKER}`;
+  switch (shell) {
+    case 'zsh': {
+      // ⚠️ zsh reads its dotfiles from $ZDOTDIR when that is set, falling back to
+      // $HOME. Writing $HOME/.zshenv on a machine with ZDOTDIR set produces a file
+      // zsh never reads — measured: `zsh -c botmux` → "command not found".
+      const zdotdir = env.ZDOTDIR?.trim();
+      const base = zdotdir ? zdotdir : home;
+      return [{ file: join(base, '.zshenv'), line: posix }];
+    }
+    case 'bash': {
+      // Disjoint coverage — see header. Both, or one of the two common ways of
+      // opening a terminal is left broken. The login half must not shadow (above).
+      const login = bashLoginFile(home);
+      const targets = [{ file: join(home, '.bashrc'), line: posix }];
+      // When bash's login file IS .bashrc-adjacent there is nothing more to add;
+      // dedupe so we never append the same line to the same file twice.
+      if (login !== join(home, '.bashrc')) targets.push({ file: login, line: posix });
+      return targets;
+    }
+    case 'fish': {
+      // ⚠️ fish's config dir is $XDG_CONFIG_HOME/fish, defaulting to ~/.config/fish.
+      // Same failure as ZDOTDIR above — measured: with XDG_CONFIG_HOME set, a file
+      // under ~/.config/fish is ignored, while the same line under
+      // $XDG_CONFIG_HOME/fish/conf.d works (positive control).
+      const xdg = env.XDG_CONFIG_HOME?.trim();
+      const configHome = xdg ? xdg : join(home, '.config');
+      return [{
+        file: join(configHome, 'fish', 'conf.d', 'botmux.fish'),
+        // fish: `contains` is its own exact list-element test — PATH is a real list
+        // here, so no delimiter padding is needed.
+        line: `contains ${q} $PATH; or set -gx PATH ${q} $PATH  ${PATH_ENTRY_MARKER}`,
+      }];
+    }
+    case 'other':
+    case 'unknown':
+    default:
+      return [{ file: join(home, '.profile'), line: posix }];
+  }
+}
+
+/** Is `installDir` already handled by this file (ours or the user's own line)? */
+export function fileAlreadyHasEntry(file, installDir) {
+  if (!existsSync(file)) return false;
+  let text;
+  try { text = readFileSync(file, 'utf8'); } catch { return false; }
+
+  // ⚠️ TWO SEPARATE PREDICATES, deliberately not one clever one.
+  //
+  // Attempt #1 searched for the raw directory as a substring: `<installDir>-old`,
+  // `/backup<installDir>` and `<installDir>/other` all counted as configured, so
+  // the REAL directory was never written (measured, written=0 for each).
+  // Attempt #2 split the line into tokens and compared them — but the line we
+  // WRITE for a directory containing a quote is
+  //     export PATH='/x/q'\''bin'":$PATH"
+  // and ANY tokenizer that treats `'` as a separator shreds that into `/x/q`,
+  // `\`, `bin`, so the quoted spelling can never match a token (measured: marker
+  // count 1 → 2 on every re-install). Shell quoting cannot be undone by splitting
+  // on characters.
+  //
+  // So: recognise OUR line by its own known syntax (marker + the exact quoted
+  // form we would generate), and use conservative whole-token matching only for a
+  // line the USER wrote by hand.
+  const ourQuoted = shellQuote(installDir);
+  const lines = text.split('\n').filter(l => !/^\s*#/.test(l));
+
+  // (a) Our own line, byte-for-byte on the part that identifies the directory.
+  //     `PATH=` + the exact quoted dir is enough; the suffix may legitimately
+  //     differ (`":$PATH"` vs fish's ` $PATH`).
+  if (lines.some(l => l.includes(PATH_ENTRY_MARKER) && l.includes(ourQuoted))) return true;
+
+  // (b) A hand-written line. Compare whole PATH elements, and do NOT treat quotes
+  //     as element separators — strip the wrapping quotes first, then split on the
+  //     characters that actually delimit PATH elements.
+  const PATH_ASSIGNMENT = new RegExp(
+    [
+      'export\\s+PATH\\s*=',      // POSIX: export PATH="…"
+      '^\\s*PATH\\s*=',           // POSIX: PATH=…
+      'set\\s+(-\\w+\\s+)*PATH',  // fish:  set -gx PATH …
+      'fish_add_path',            // fish:  fish_add_path …
+      '\\bpath\\+=',              // zsh:   path+=(…)
+      '\\bpath=\\(',              // zsh:   path=(…)
+    ].join('|'),
+    'i',
+  );
+  const target = installDir.replace(/\/+$/, '');
+  return lines.some(l => {
+    if (!PATH_ASSIGNMENT.test(l)) return false;
+    // Quotes here are shell syntax around a plain path (the quote-containing case
+    // is handled by (a)); dropping them leaves the path bytes intact.
+    const bare = l.replace(/["']/g, '');
+    return bare
+      .split(/[:\s()=]+/)
+      .map(t => t.replace(/\/+$/, ''))
+      .some(t => t !== '' && t === target);
+  });
+}
+
+/**
+ * Append the PATH line to every startup file the user's shell reads.
+ *
+ * Returns `{ written: string[], skipped: string[], failed: [{file, error}] }`.
+ * Never throws: a PATH edit failing must not fail the install (the launcher is
+ * already in place and the caller prints a manual fallback).
+ */
+export function ensurePathEntry(opts) {
+  const installDir = opts.installDir;
+  const env = opts.env ?? process.env;
+  const home = opts.home ?? homedir();
+  const shell = opts.shell ?? detectShell(env);
+  const targets = pathEntryTargets(shell, installDir, home, env);
+
+  const written = [], skipped = [], failed = [];
+  for (const { file, line } of targets) {
+    if (fileAlreadyHasEntry(file, installDir)) { skipped.push(file); continue; }
+    try {
+      mkdirSync(dirname(file), { recursive: true });
+      if (existsSync(file)) {
+        // Keep the user's file intact; only append, and only with a leading
+        // newline so we never glue onto an unterminated last line.
+        const prev = readFileSync(file, 'utf8');
+        appendFileSync(file, `${prev.endsWith('\n') || prev === '' ? '' : '\n'}${line}\n`);
+      } else {
+        writeFileSync(file, `${line}\n`);
+      }
+      written.push(file);
+    } catch (err) {
+      failed.push({ file, error: err && err.message ? err.message : String(err) });
+    }
+  }
+  return { shell, written, skipped, failed };
+}

package/scripts/postinstall-bin.mjs

@@ -219,11 +219,45 @@ try {
   );
 }
 
-// ── PATH hint ─────────────────────────────────────────────────────────────────
-// Mirrors install.sh. Without ~/.botmux/bin on PATH the launcher we just wrote is
-// never the `botmux` the user's shell resolves.
-const pathEntries = (process.env.PATH ?? '').split(':');
-if (!pathEntries.includes(binDir)) {
-  console.log(`[botmux] add ${binDir} to your PATH so this launcher is the \`botmux\` your shell finds:`);
-  console.log(`[botmux]   echo 'export PATH="${binDir}:$PATH"' >> ~/.profile && . ~/.profile`);
+// ── PATH: write it, don't just suggest it ─────────────────────────────────────
+// This used to only PRINT `echo 'export PATH=…' >> ~/.profile`. Two problems:
+// the user had to act on it, and for zsh users the suggested file is WRONG —
+// zsh never reads ~/.profile (measured), so following the hint verbatim left
+// `botmux` still not found. There is no `bin` field any more, so PATH is the
+// only way this launcher becomes a command; we now write the right startup file
+// for the user's actual shell (bash/zsh/fish/other) and tell them what we did.
+//
+// ⚠️ FAIL-SOFT, and never `fail()`: the launcher is already installed and working
+// at this point, so a PATH edit that cannot happen must degrade to the printed
+// hint — not abort a successful install. That includes the sibling module simply
+// not being there: it ships via package.json `files`, and if a future edit drops
+// it (or a mirror repacks the tarball without it) the import throws. Guarding it
+// keeps `npm i -g botmux` succeeding either way.
+if (!(process.env.PATH ?? '').split(':').includes(binDir)) {
+  let ensurePathEntry = null;
+  try {
+    ({ ensurePathEntry } = await import('./install-path-entry.mjs'));
+  } catch (err) {
+    console.error(`[botmux] PATH helper unavailable (${err && err.message ? err.message : String(err)})`);
+  }
+  let written = [], skipped = [];
+  if (ensurePathEntry) {
+    try {
+      const r = ensurePathEntry({ installDir: binDir });
+      ({ written, skipped } = r);
+      for (const f of written) console.log(`[botmux] added ${binDir} to PATH in ${f} (${r.shell})`);
+      for (const f of skipped) console.log(`[botmux] ${f} already puts ${binDir} on PATH`);
+      for (const { file, error } of r.failed) console.error(`[botmux] could not update ${file}: ${error}`);
+    } catch (err) {
+      console.error(`[botmux] could not update your shell startup file: ${err && err.message ? err.message : String(err)}`);
+    }
+  }
+  if (written.length > 0) {
+    console.log('[botmux] open a new terminal (or re-source that file) and `botmux` will be on PATH');
+  } else if (skipped.length === 0) {
+    // Nothing written and nothing already present — fall back to telling them.
+    // Deliberately not naming a specific file here: the correct one depends on
+    // the shell, and naming the wrong one is what caused the original bug.
+    console.log(`[botmux] add ${binDir} to your PATH so this launcher is the \`botmux\` your shell finds`);
+  }
 }