@kontextmind/kxm 0.7.82 → 0.7.84

package/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "kxm",
       "source": "./plugins/kxm",
       "description": "Durable workflows, peer agents, and kxm tui",
-      "version": "0.7.82",
+      "version": "0.7.84",
       "category": "development",
       "tags": ["kxm", "multi-agent", "workflows", "mcp"]
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontextmind/kxm",
-  "version": "0.7.82",
+  "version": "0.7.84",
   "description": "KXM local-first multi-agent orchestration and operator dashboard",
   "type": "module",
   "author": "KontextMind",

package/plugins/kxm/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "kxm",
   "displayName": "KXM",
-  "version": "0.7.82",
+  "version": "0.7.84",
   "description": "Headless multi-agent orchestration, durable workflows, and a live operator dashboard for Pi and Claude Code",
   "author": {
     "name": "KontextMind",

package/plugins/kxm/dist/cli.js

@@ -18176,6 +18176,13 @@ function readInstalledKxmVersion(root) {
   }
   return pkg.version;
 }
+function installedKxmVersion(root) {
+  try {
+    return readInstalledKxmVersion(root);
+  } catch {
+    return void 0;
+  }
+}
 function parseSemver(value) {
   const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(value.trim());
   if (!match) return void 0;
@@ -18335,7 +18342,7 @@ import { dirname, join as join2 } from "node:path";
 import { fileURLToPath } from "node:url";
 var ROOT_MARKERS = ["scripts/kxm-hub.mjs", "scripts/kxm.mjs"];
 var MAX_WALK_DEPTH = 10;
-function findKxmRepoRoot(fromUrl = import.meta.url) {
+function tryFindKxmRepoRoot(fromUrl = import.meta.url) {
   let dir = dirname(fileURLToPath(fromUrl));
   for (let depth = 0; depth < MAX_WALK_DEPTH; depth += 1) {
     if (ROOT_MARKERS.some((marker) => existsSync2(join2(dir, marker)))) return dir;
@@ -18343,6 +18350,11 @@ function findKxmRepoRoot(fromUrl = import.meta.url) {
     if (parent === dir) break;
     dir = parent;
   }
+  return void 0;
+}
+function findKxmRepoRoot(fromUrl = import.meta.url) {
+  const found = tryFindKxmRepoRoot(fromUrl);
+  if (found !== void 0) return found;
   throw new Error(
     `kxm: cannot locate the KXM repo root from ${fileURLToPath(fromUrl)} (walked ${MAX_WALK_DEPTH} levels looking for ${ROOT_MARKERS[0]})`
   );
@@ -44588,14 +44600,30 @@ async function hubGet(url, fetchImpl) {
 }
 function installProbeFrom(runtime) {
   const partial = runtime.io.installProbe ?? {};
+  const moduleDir = partial.moduleDir ?? dirname20(fileURLToPath3(import.meta.url));
   return {
-    moduleDir: partial.moduleDir ?? dirname20(fileURLToPath3(import.meta.url)),
-    repoRoot: partial.repoRoot ?? resolve24("."),
+    moduleDir,
+    // Classify the install that is **running**, never the directory the caller
+    // happens to be standing in. Deriving this from cwd made `kxm update --kxm`
+    // answer "kxm is running from source at <cwd>; update it with git pull there"
+    // on an npm-global install whenever the operator ran it inside a kxm
+    // checkout — and a git pull there deploys nothing, because the services exec
+    // the installed copy. An unrecognisable layout falls back to the module
+    // directory, which classifies as `unknown` ("update it the way it was
+    // installed") rather than inventing a source install.
+    repoRoot: partial.repoRoot ?? tryFindKxmRepoRoot(import.meta.url) ?? moduleDir,
     homeDir: partial.homeDir ?? homedir7(),
     platform: partial.platform ?? process.platform,
     env: partial.env ?? runtime.env
   };
 }
+function moduleInstallRoot() {
+  try {
+    return findKxmRepoRoot(import.meta.url);
+  } catch {
+    return dirname20(fileURLToPath3(import.meta.url));
+  }
+}
 function warnIgnoredProjectUpdateYaml(runtime) {
   const projectFile = join41(runtime.dirs.workspace, "update.yaml");
   if (!existsSync31(projectFile)) return;
@@ -44603,11 +44631,20 @@ function warnIgnoredProjectUpdateYaml(runtime) {
   runtime.io.stderr(`kxm: ignoring .kxm/update.yaml in ${runtime.dirs.workdir}; update settings are read only from ${userFile}
 `);
 }
-async function refreshKxmUpdateNotice(runtime, config) {
+async function refreshKxmUpdateNotice(runtime, config, current) {
   const resolved = config ?? loadKxmUpdateConfig(runtime.env);
-  const current = readInstalledKxmVersion(resolve24("."));
+  const installed = current ?? installedKxmVersion(findKxmRepoRoot(import.meta.url)) ?? installedKxmVersion(moduleInstallRoot());
+  if (installed === void 0) {
+    return {
+      current: "unknown",
+      available: false,
+      auto: false,
+      source: resolved.source,
+      message: `kxm update check skipped: the installed version is unreadable at ${moduleInstallRoot()}`
+    };
+  }
   const fetched = await fetchLatestKxmVersion(resolved.source, runtime.env, runtime.fetchImpl);
-  const notice = noticeFromVersions(current, fetched.latest, resolved, fetched.error, fetched.asset);
+  const notice = noticeFromVersions(installed, fetched.latest, resolved, fetched.error, fetched.asset);
   writeUpdateCache(runtime.dirs.state, notice);
   return notice;
 }
@@ -47128,16 +47165,16 @@ async function cmdUpdate(runtime, harness, options) {
   warnIgnoredProjectUpdateYaml(runtime);
   const probe = installProbeFrom(runtime);
   const classified = classifyInstallRoot(probe);
-  const current = readInstalledKxmVersion(findKxmRepoRoot(import.meta.url));
+  const current = installedKxmVersion(classified.root) ?? installedKxmVersion(findKxmRepoRoot(import.meta.url));
   let notice;
   let kindReport = classified;
   if (classified.kind === "source") {
     if (options.check) {
-      const message = `kxm ${current} (running from source at ${classified.root})`;
+      const message = `kxm ${current ?? "unknown"} (running from source at ${classified.root})`;
       print(runtime.io, runtime.json, {
         ok: true,
         command: "update check",
-        current,
+        current: current ?? "unknown",
         available: false,
         auto: false,
         source: "github",
@@ -47159,15 +47196,15 @@ async function cmdUpdate(runtime, harness, options) {
       return 2;
     }
     notice = {
-      current,
+      current: current ?? "unknown",
       available: false,
       auto: false,
       source: "github",
-      message: `kxm ${current} (running from source)`
+      message: `kxm ${current ?? "unknown"} (running from source)`
     };
   } else {
     try {
-      notice = await refreshKxmUpdateNotice(runtime);
+      notice = await refreshKxmUpdateNotice(runtime, void 0, current);
     } catch (error) {
       if (error instanceof KxmUpdateConfigError) {
         print(runtime.io, runtime.json, { ok: false, command: "update", error: error.code, ...installKindPayload(classified) }, error.message);

package/plugins/kxm/dist/extension.js

@@ -16238,7 +16238,7 @@ import { dirname as dirname5, join as join5 } from "node:path";
 import { fileURLToPath } from "node:url";
 var ROOT_MARKERS = ["scripts/kxm-hub.mjs", "scripts/kxm.mjs"];
 var MAX_WALK_DEPTH = 10;
-function findKxmRepoRoot(fromUrl = import.meta.url) {
+function tryFindKxmRepoRoot(fromUrl = import.meta.url) {
   let dir = dirname5(fileURLToPath(fromUrl));
   for (let depth = 0; depth < MAX_WALK_DEPTH; depth += 1) {
     if (ROOT_MARKERS.some((marker) => existsSync5(join5(dir, marker)))) return dir;
@@ -16246,6 +16246,11 @@ function findKxmRepoRoot(fromUrl = import.meta.url) {
     if (parent === dir) break;
     dir = parent;
   }
+  return void 0;
+}
+function findKxmRepoRoot(fromUrl = import.meta.url) {
+  const found = tryFindKxmRepoRoot(fromUrl);
+  if (found !== void 0) return found;
   throw new Error(
     `kxm: cannot locate the KXM repo root from ${fileURLToPath(fromUrl)} (walked ${MAX_WALK_DEPTH} levels looking for ${ROOT_MARKERS[0]})`
   );

package/plugins/kxm/dist/mcp-server.js

@@ -17182,7 +17182,7 @@ async function deliverInboxNotification(messageId, delivered, notify) {
 }
 
 // plugins/kxm/src/mcp-server.ts
-var VERSION = "0.7.82";
+var VERSION = "0.7.84";
 var inbox = /* @__PURE__ */ new Map();
 var notifiedInbox = /* @__PURE__ */ new Set();
 var meshClient;

package/plugins/kxm/dist/runtime-supervisor.js

@@ -14791,7 +14791,7 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 var ROOT_MARKERS = ["scripts/kxm-hub.mjs", "scripts/kxm.mjs"];
 var MAX_WALK_DEPTH = 10;
-function findKxmRepoRoot(fromUrl = import.meta.url) {
+function tryFindKxmRepoRoot(fromUrl = import.meta.url) {
   let dir = dirname(fileURLToPath(fromUrl));
   for (let depth = 0; depth < MAX_WALK_DEPTH; depth += 1) {
     if (ROOT_MARKERS.some((marker) => existsSync(join(dir, marker)))) return dir;
@@ -14799,6 +14799,11 @@ function findKxmRepoRoot(fromUrl = import.meta.url) {
     if (parent === dir) break;
     dir = parent;
   }
+  return void 0;
+}
+function findKxmRepoRoot(fromUrl = import.meta.url) {
+  const found = tryFindKxmRepoRoot(fromUrl);
+  if (found !== void 0) return found;
   throw new Error(
     `kxm: cannot locate the KXM repo root from ${fileURLToPath(fromUrl)} (walked ${MAX_WALK_DEPTH} levels looking for ${ROOT_MARKERS[0]})`
   );

package/plugins/kxm/dist/runtime.js

@@ -15119,7 +15119,7 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 var ROOT_MARKERS = ["scripts/kxm-hub.mjs", "scripts/kxm.mjs"];
 var MAX_WALK_DEPTH = 10;
-function findKxmRepoRoot(fromUrl = import.meta.url) {
+function tryFindKxmRepoRoot(fromUrl = import.meta.url) {
   let dir = dirname(fileURLToPath(fromUrl));
   for (let depth = 0; depth < MAX_WALK_DEPTH; depth += 1) {
     if (ROOT_MARKERS.some((marker) => existsSync(join(dir, marker)))) return dir;
@@ -15127,6 +15127,11 @@ function findKxmRepoRoot(fromUrl = import.meta.url) {
     if (parent === dir) break;
     dir = parent;
   }
+  return void 0;
+}
+function findKxmRepoRoot(fromUrl = import.meta.url) {
+  const found = tryFindKxmRepoRoot(fromUrl);
+  if (found !== void 0) return found;
   throw new Error(
     `kxm: cannot locate the KXM repo root from ${fileURLToPath(fromUrl)} (walked ${MAX_WALK_DEPTH} levels looking for ${ROOT_MARKERS[0]})`
   );

package/plugins/kxm/dist/server.js

@@ -14943,7 +14943,7 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 var ROOT_MARKERS = ["scripts/kxm-hub.mjs", "scripts/kxm.mjs"];
 var MAX_WALK_DEPTH = 10;
-function findKxmRepoRoot(fromUrl = import.meta.url) {
+function tryFindKxmRepoRoot(fromUrl = import.meta.url) {
   let dir = dirname(fileURLToPath(fromUrl));
   for (let depth = 0; depth < MAX_WALK_DEPTH; depth += 1) {
     if (ROOT_MARKERS.some((marker) => existsSync(join(dir, marker)))) return dir;
@@ -14951,6 +14951,11 @@ function findKxmRepoRoot(fromUrl = import.meta.url) {
     if (parent === dir) break;
     dir = parent;
   }
+  return void 0;
+}
+function findKxmRepoRoot(fromUrl = import.meta.url) {
+  const found = tryFindKxmRepoRoot(fromUrl);
+  if (found !== void 0) return found;
   throw new Error(
     `kxm: cannot locate the KXM repo root from ${fileURLToPath(fromUrl)} (walked ${MAX_WALK_DEPTH} levels looking for ${ROOT_MARKERS[0]})`
   );

package/plugins/kxm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-plugin",
-  "version": "0.7.82",
+  "version": "0.7.84",
   "private": true,
   "type": "module",
   "engines": {

package/plugins/kxm/src/cli/hub.ts

@@ -73,9 +73,18 @@ export async function hubGet(url: string, fetchImpl: typeof fetch): Promise<{ ok
 
 export function installProbeFrom(runtime: Runtime): InstallProbe {
   const partial = runtime.io.installProbe ?? {};
+  const moduleDir = partial.moduleDir ?? dirname(fileURLToPath(import.meta.url));
   return {
-    moduleDir: partial.moduleDir ?? dirname(fileURLToPath(import.meta.url)),
-    repoRoot: partial.repoRoot ?? resolve("."),
+    moduleDir,
+    // Classify the install that is **running**, never the directory the caller
+    // happens to be standing in. Deriving this from cwd made `kxm update --kxm`
+    // answer "kxm is running from source at <cwd>; update it with git pull there"
+    // on an npm-global install whenever the operator ran it inside a kxm
+    // checkout — and a git pull there deploys nothing, because the services exec
+    // the installed copy. An unrecognisable layout falls back to the module
+    // directory, which classifies as `unknown` ("update it the way it was
+    // installed") rather than inventing a source install.
+    repoRoot: partial.repoRoot ?? tryFindKxmRepoRoot(import.meta.url) ?? moduleDir,
     homeDir: partial.homeDir ?? homedir(),
     platform: partial.platform ?? process.platform,
     env: partial.env ?? runtime.env,
@@ -84,6 +93,17 @@ export function installProbeFrom(runtime: Runtime): InstallProbe {
 
 import { fileURLToPath } from "node:url";
 import { dirname } from "node:path";
+import { findKxmRepoRoot, tryFindKxmRepoRoot } from "../repo-root.ts";
+import { installedKxmVersion } from "../kxm-update.ts";
+
+/** The install root derived from the loaded module; `unknown` never crashes a caller. */
+function moduleInstallRoot(): string {
+  try {
+    return findKxmRepoRoot(import.meta.url);
+  } catch {
+    return dirname(fileURLToPath(import.meta.url));
+  }
+}
 import { homedir } from "node:os";
 
 export function warnIgnoredProjectUpdateYaml(runtime: Runtime): void {
@@ -93,11 +113,33 @@ export function warnIgnoredProjectUpdateYaml(runtime: Runtime): void {
   runtime.io.stderr(`kxm: ignoring .kxm/update.yaml in ${runtime.dirs.workdir}; update settings are read only from ${userFile}\n`);
 }
 
-export async function refreshKxmUpdateNotice(runtime: Runtime, config?: KxmUpdateConfig): Promise<KxmUpdateNotice> {
+export async function refreshKxmUpdateNotice(
+  runtime: Runtime,
+  config?: KxmUpdateConfig,
+  current?: string,
+): Promise<KxmUpdateNotice> {
   const resolved = config ?? loadKxmUpdateConfig(runtime.env);
-  const current = readInstalledKxmVersion(resolve("."));
+  // The version being compared is the one **running**, taken from the install
+  // root. Reading it from the caller's directory made `cd ~ && kxm update --kxm`
+  // die with a raw ENOENT on `$HOME/package.json` — and silently compared a
+  // stranger's version wherever the operator happened to stand and a
+  // package.json did exist. Callers that already resolved it pass it in.
+  const installed = current
+    ?? installedKxmVersion(findKxmRepoRoot(import.meta.url))
+    ?? installedKxmVersion(moduleInstallRoot());
+  if (installed === undefined) {
+    // No version to compare against: say nothing rather than crash a hub start
+    // over an update notice.
+    return {
+      current: "unknown",
+      available: false,
+      auto: false,
+      source: resolved.source,
+      message: `kxm update check skipped: the installed version is unreadable at ${moduleInstallRoot()}`,
+    };
+  }
   const fetched = await fetchLatestKxmVersion(resolved.source, runtime.env, runtime.fetchImpl);
-  const notice = noticeFromVersions(current, fetched.latest, resolved, fetched.error, fetched.asset);
+  const notice = noticeFromVersions(installed, fetched.latest, resolved, fetched.error, fetched.asset);
   writeUpdateCache(runtime.dirs.state, notice);
   return notice;
 }

package/plugins/kxm/src/cli/system.ts

@@ -63,6 +63,7 @@ import {
   type InstallProbe,
 } from "../kxm-install-kind.ts";
 import {
+  installedKxmVersion,
   fetchLatestKxmVersion,
   kxmReleaseAssetName,
   noticeFromVersions,
@@ -296,16 +297,22 @@ export async function cmdUpdate(runtime: Runtime, harness: string | undefined, o
   warnIgnoredProjectUpdateYaml(runtime);
   const probe = installProbeFrom(runtime);
   const classified = classifyInstallRoot(probe);
-  const current = readInstalledKxmVersion(findKxmRepoRoot(import.meta.url));
+  // The version of the install being updated, taken from the root that was just
+  // classified — not from whichever directory the operator stood in. A
+  // `readInstalledKxmVersion(resolve("."))` in the notice path turned
+  // `cd ~ && kxm update --kxm` into an uncaught ENOENT on `$HOME/package.json`,
+  // and would happily compare a stranger project's version wherever one did
+  // exist. Unreadable is now a stated refusal.
+  const current = installedKxmVersion(classified.root) ?? installedKxmVersion(findKxmRepoRoot(import.meta.url));
   let notice: KxmUpdateNotice;
   let kindReport = classified;
   if (classified.kind === "source") {
     if (options.check) {
-      const message = `kxm ${current} (running from source at ${classified.root})`;
+      const message = `kxm ${current ?? "unknown"} (running from source at ${classified.root})`;
       print(runtime.io, runtime.json, {
         ok: true,
         command: "update check",
-        current,
+        current: current ?? "unknown",
         available: false,
         auto: false,
         source: "github",
@@ -327,15 +334,15 @@ export async function cmdUpdate(runtime: Runtime, harness: string | undefined, o
       return 2;
     }
     notice = {
-      current,
+      current: current ?? "unknown",
       available: false,
       auto: false,
       source: "github",
-      message: `kxm ${current} (running from source)`,
+      message: `kxm ${current ?? "unknown"} (running from source)`,
     };
   } else {
     try {
-      notice = await refreshKxmUpdateNotice(runtime);
+      notice = await refreshKxmUpdateNotice(runtime, undefined, current);
     } catch (error) {
       if (error instanceof KxmUpdateConfigError) {
         print(runtime.io, runtime.json, { ok: false, command: "update", error: error.code, ...installKindPayload(classified) }, error.message);

package/plugins/kxm/src/kxm-update.ts

@@ -51,6 +51,21 @@ export function readInstalledKxmVersion(root: string): string {
   return pkg.version;
 }
 
+/**
+ * `readInstalledKxmVersion` without the raw filesystem failure. The installed
+ * version is read to decide whether a candidate is an upgrade, a downgrade or
+ * the same thing — so a directory that has no readable `package.json` must come
+ * back as "unknown" and be refused in words, not surface as an uncaught ENOENT
+ * stack from `kxm update`.
+ */
+export function installedKxmVersion(root: string): string | undefined {
+  try {
+    return readInstalledKxmVersion(root);
+  } catch {
+    return undefined;
+  }
+}
+
 export function parseSemver(value: string): [number, number, number] | undefined {
   const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(value.trim());
   if (!match) return undefined;

package/plugins/kxm/src/mcp-server.ts

@@ -8,7 +8,7 @@ import { AGENT_COMMANDS_MAP, enforceToolPolicy, getMcpTools, reconcileInbox } fr
 import { deliverInboxNotification } from "./inbox.ts";
 import type { HubEvent, MessageRecord } from "./protocol.ts";
 
-const VERSION = "0.7.82";
+const VERSION = "0.7.84";
 const inbox = new Map<string, MessageRecord>();
 const notifiedInbox = new Set<string>();
 let meshClient: HubClient | undefined;

package/plugins/kxm/src/repo-root.ts

@@ -14,7 +14,12 @@ const MAX_WALK_DEPTH = 10;
  * layout; marker discovery is correct in both, and in npm-installed
  * layouts, which also ship `scripts/`.
  */
-export function findKxmRepoRoot(fromUrl: string = import.meta.url): string {
+/**
+ * The repo/package root this module was loaded from, or `undefined` when the
+ * layout is not recognisable. For callers that must degrade to "cannot tell how
+ * it was installed" instead of throwing — install classification, mostly.
+ */
+export function tryFindKxmRepoRoot(fromUrl: string = import.meta.url): string | undefined {
   let dir = dirname(fileURLToPath(fromUrl));
   for (let depth = 0; depth < MAX_WALK_DEPTH; depth += 1) {
     if (ROOT_MARKERS.some((marker) => existsSync(join(dir, marker)))) return dir;
@@ -22,6 +27,12 @@ export function findKxmRepoRoot(fromUrl: string = import.meta.url): string {
     if (parent === dir) break;
     dir = parent;
   }
+  return undefined;
+}
+
+export function findKxmRepoRoot(fromUrl: string = import.meta.url): string {
+  const found = tryFindKxmRepoRoot(fromUrl);
+  if (found !== undefined) return found;
   throw new Error(
     `kxm: cannot locate the KXM repo root from ${fileURLToPath(fromUrl)} ` +
       `(walked ${MAX_WALK_DEPTH} levels looking for ${ROOT_MARKERS[0]})`,