@mutmutco/hub 3.139.0 → 3.139.1

package/dist/index.cjs

@@ -21,17 +21,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  enumerateSurfaces: () => enumerateSurfaces,
+  hermesArm: () => hermesArm,
+  hermesHome: () => hermesHome,
   hubStatus: () => hubStatus,
   launcherVbs: () => launcherVbs,
   localStartBoundary: () => localStartBoundary,
   main: () => main,
   ownVersion: () => ownVersion,
+  probeHermesInstallation: () => probeHermesInstallation,
   schedulerStatus: () => schedulerStatus,
   taskXml: () => taskXml
 });
 module.exports = __toCommonJS(index_exports);
-var import_node_fs15 = require("node:fs");
-var import_node_path12 = require("node:path");
+var import_node_fs16 = require("node:fs");
+var import_node_path13 = require("node:path");
 
 // src/state.ts
 var import_node_fs = require("node:fs");
@@ -321,6 +325,11 @@ function kimiHome(env = process.env) {
 function jervcodeAgentDir(env = process.env) {
   return env.MMI_UPDATER_JERVCODE_AGENT_DIR?.trim() || env.JERVCODE_CODING_AGENT_DIR?.trim() || env.PI_CODING_AGENT_DIR?.trim() || (0, import_node_path3.join)((0, import_node_os2.homedir)(), ".jerv", "agent");
 }
+function hermesHome(env = process.env, platform = process.platform) {
+  if (env.HERMES_HOME?.trim()) return env.HERMES_HOME.trim();
+  if (platform === "win32") return (0, import_node_path3.join)(env.LOCALAPPDATA?.trim() || (0, import_node_path3.join)((0, import_node_os2.homedir)(), "AppData", "Local"), "hermes");
+  return (0, import_node_path3.join)((0, import_node_os2.homedir)(), ".hermes");
+}
 function enumerateSurfaces(env = process.env) {
   const home = (0, import_node_os2.homedir)();
   const codexHome = env.CODEX_HOME || (0, import_node_path3.join)(home, ".codex");
@@ -333,7 +342,10 @@ function enumerateSurfaces(env = process.env) {
     // itself — so a machine running Kimi WITHOUT the plugin enumerated as "no Kimi" and the arm
     // could never make the first install. The plugin's absence is a converge action, not a skip.
     { id: "kimi", marker: kimiHome(env) },
-    { id: "jervcode", marker: (0, import_node_path3.join)(jervcodeAgentDir(env), "settings.json") }
+    { id: "jervcode", marker: (0, import_node_path3.join)(jervcodeAgentDir(env), "settings.json") },
+    // The host root is the marker, not plugins/mmi: an installed Hermes without MMI must be
+    // discovered so its native plugin tree can be converged for the first time.
+    { id: "hermes", marker: hermesHome(env) }
   ].map((probe) => ({ ...probe, present: (0, import_node_fs4.existsSync)(probe.marker) }));
 }
 
@@ -1287,10 +1299,133 @@ function jervcodeArm(options) {
   };
 }
 
-// src/reap.ts
-var import_node_child_process8 = require("node:child_process");
+// src/arm-hermes.ts
 var import_node_fs12 = require("node:fs");
 var import_node_path10 = require("node:path");
+var PACKAGE2 = "@mutmutco/hermes-plugin";
+var MANIFEST2 = "plugin.yaml";
+var TREE_MARKERS2 = [MANIFEST2, "__init__.py", "skills"];
+function yamlVersion(root) {
+  try {
+    const text = (0, import_node_fs12.readFileSync)((0, import_node_path10.join)(root, MANIFEST2), "utf8");
+    try {
+      const version = JSON.parse(text).version;
+      if (typeof version === "string" && version.trim()) return version.trim();
+    } catch {
+    }
+    const match = /^version:\s*["']?([^\s"'#]+)["']?\s*(?:#.*)?$/m.exec(text);
+    return match?.[1] ?? null;
+  } catch {
+    return null;
+  }
+}
+function treeHealthy3(root) {
+  return TREE_MARKERS2.slice(0, 2).every((file) => (0, import_node_fs12.existsSync)((0, import_node_path10.join)(root, file))) && (() => {
+    try {
+      return (0, import_node_fs12.statSync)((0, import_node_path10.join)(root, "skills")).isDirectory();
+    } catch {
+      return false;
+    }
+  })();
+}
+function packageIdentity(root) {
+  try {
+    return JSON.parse((0, import_node_fs12.readFileSync)((0, import_node_path10.join)(root, "package.json"), "utf8")).name === PACKAGE2;
+  } catch {
+    return false;
+  }
+}
+function probeHermesInstallation(env = process.env) {
+  const location = (0, import_node_path10.join)(hermesHome(env), "plugins", "mmi");
+  const version = yamlVersion(location);
+  return { version, location, detail: version ? "installed Hermes plugin manifest" : "installed Hermes plugin manifest was unreadable" };
+}
+function mmiOwned2(root) {
+  return packageIdentity(root);
+}
+function discard2(path) {
+  try {
+    (0, import_node_fs12.rmSync)(path, { recursive: true, force: true });
+  } catch {
+  }
+}
+function message2(error) {
+  return String(error?.message ?? error).replace(/\s+/g, " ").slice(0, 200);
+}
+function hermesArm(options) {
+  const env = options.env ?? process.env;
+  const home = hermesHome(env);
+  const parent = (0, import_node_path10.join)(home, "plugins");
+  const live = (0, import_node_path10.join)(parent, "mmi");
+  const installed = yamlVersion(live);
+  const result = (from, to, verdict, detail) => ({
+    surface: "hermes",
+    from,
+    to,
+    verdict,
+    detail
+  });
+  if (!(0, import_node_fs12.existsSync)(home)) return result(null, options.target, "skip", `absent (${home}) \u2014 skipped without writes`);
+  if ((0, import_node_fs12.existsSync)(live) && !mmiOwned2(live)) {
+    return result(installed, options.target, "defer", `${live} carries no ${PACKAGE2} package identity \u2014 refusing to displace an unmanaged Hermes mmi plugin`);
+  }
+  if (installed && compareSemver(installed, options.target) > 0) return result(installed, installed, "skip", `installed ${installed} is above candidate ${options.target} (monotonic)`);
+  const highWater = journalHighWater(options.paths.journalPath, "hermes");
+  if (highWater && compareSemver(highWater, options.target) > 0) return result(installed, highWater, "skip", `journal high-water ${highWater} is above candidate ${options.target} (monotonic)`);
+  if (installed === options.target && treeHealthy3(live)) return result(installed, options.target, "ok", `already at target ${options.target}`);
+  if (options.dryRun) return result(installed, options.target, "ok", `dry-run: would stage ${PACKAGE2}@${options.target} and atomically switch ${installed ?? "absent"} -> ${options.target}`);
+  const staged = stagePackage({ surface: "hermes", packageName: PACKAGE2, target: options.target, witness: MANIFEST2, paths: options.paths, env });
+  if ("defer" in staged) return result(installed, options.target, "defer", staged.defer);
+  if (yamlVersion(staged.packageRoot) !== options.target || !treeHealthy3(staged.packageRoot)) {
+    return result(installed, options.target, "defer", `staged Hermes manifest is ${yamlVersion(staged.packageRoot) ?? "unreadable"} or its tree is incomplete (expected ${options.target})`);
+  }
+  const scratch = (0, import_node_path10.join)(home, ".mmi-updater");
+  const incomingRoot = (0, import_node_path10.join)(scratch, "incoming");
+  const incoming = (0, import_node_path10.join)(incomingRoot, options.target);
+  const quarantine = (0, import_node_path10.join)(scratch, "quarantine", `${installed ?? "unknown"}-${Date.now()}`);
+  try {
+    (0, import_node_fs12.mkdirSync)(parent, { recursive: true });
+    (0, import_node_fs12.mkdirSync)((0, import_node_path10.join)(scratch, "quarantine"), { recursive: true });
+    discard2(incomingRoot);
+    (0, import_node_fs12.cpSync)(staged.packageRoot, incoming, { recursive: true });
+  } catch (error) {
+    return result(installed, options.target, "defer", `cannot place incoming Hermes generation: ${message2(error)}`);
+  }
+  if (yamlVersion(incoming) !== options.target || !treeHealthy3(incoming)) {
+    discard2(incomingRoot);
+    return result(installed, options.target, "defer", "incoming Hermes generation did not reproduce the verified payload");
+  }
+  const displaced = (0, import_node_fs12.existsSync)(live);
+  try {
+    if (displaced) (0, import_node_fs12.renameSync)(live, quarantine);
+    (0, import_node_fs12.renameSync)(incoming, live);
+  } catch (error) {
+    if (displaced && !(0, import_node_fs12.existsSync)(live)) try {
+      (0, import_node_fs12.renameSync)(quarantine, live);
+    } catch {
+    }
+    discard2(incomingRoot);
+    return result(installed, options.target, "defer", `Hermes generation switch failed; previous generation retained: ${message2(error)}`);
+  }
+  if (yamlVersion(live) !== options.target || !treeHealthy3(live)) {
+    const broken = (0, import_node_path10.join)(scratch, "rejected", `${options.target}-${Date.now()}`);
+    try {
+      (0, import_node_fs12.mkdirSync)((0, import_node_path10.join)(scratch, "rejected"), { recursive: true });
+      (0, import_node_fs12.renameSync)(live, broken);
+      if (displaced) (0, import_node_fs12.renameSync)(quarantine, live);
+    } catch (error) {
+      return result(installed, yamlVersion(live) ?? "unknown", "fail", `post-switch Hermes verification failed and recovery failed: ${message2(error)}`);
+    }
+    return result(installed, displaced ? installed ?? "unknown" : "none", "fail", `post-switch Hermes verification failed; rejected generation parked at ${broken}${displaced ? "; previous generation restored" : ""}`);
+  }
+  discard2(incomingRoot);
+  return result(installed, options.target, "ok", `converged ${installed ?? "absent"} -> ${options.target} (staged, verified, atomically switched${displaced ? `; previous generation quarantined at ${quarantine}` : ""})`);
+}
+
+// src/reap.ts
+var import_node_child_process8 = require("node:child_process");
+var import_node_fs13 = require("node:fs");
+var import_node_path11 = require("node:path");
 var KEEP_GENERATIONS2 = 2;
 var SCRATCH_AGE_MS = 24 * 60 * 6e4;
 var ORPHAN_MIN_AGE_MS = 10 * 6e4;
@@ -1298,7 +1433,7 @@ var SNAPSHOT_TIMEOUT_MS = 2e4;
 var MAX_UNWIND_ROUNDS = 4;
 function listDirs(path) {
   try {
-    return (0, import_node_fs12.readdirSync)(path, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+    return (0, import_node_fs13.readdirSync)(path, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
   } catch {
     return [];
   }
@@ -1306,7 +1441,7 @@ function listDirs(path) {
 function generationSets(root) {
   const children = listDirs(root);
   if (children.some((name) => parseSemver(name))) return [root];
-  return children.map((name) => (0, import_node_path10.join)(root, name)).filter((path) => listDirs(path).some((name) => parseSemver(name)));
+  return children.map((name) => (0, import_node_path11.join)(root, name)).filter((path) => listDirs(path).some((name) => parseSemver(name)));
 }
 function pruneGenerations(root, category, dryRun) {
   let reaped = 0;
@@ -1319,7 +1454,7 @@ function pruneGenerations(root, category, dryRun) {
         continue;
       }
       try {
-        (0, import_node_fs12.rmSync)((0, import_node_path10.join)(set, version), { recursive: true, force: true });
+        (0, import_node_fs13.rmSync)((0, import_node_path11.join)(set, version), { recursive: true, force: true });
         reaped += 1;
       } catch (error) {
         failures.push(`${version}: ${error?.code ?? error?.message ?? error}`);
@@ -1333,8 +1468,8 @@ function pruneGenerations(root, category, dryRun) {
 }
 var LEASE_STEAL_SCRATCH = /^lease\.lock\.stale-\d+$/;
 function atomicWriteScratch(path) {
-  const literal = (0, import_node_path10.basename)(path).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  return { dir: (0, import_node_path10.dirname)(path), pattern: new RegExp(`^${literal}\\.tmp-\\d+$`) };
+  const literal = (0, import_node_path11.basename)(path).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return { dir: (0, import_node_path11.dirname)(path), pattern: new RegExp(`^${literal}\\.tmp-\\d+$`) };
 }
 function reapScratch(context, dryRun) {
   const category = "scratch";
@@ -1352,7 +1487,7 @@ function reapScratch(context, dryRun) {
   for (const [dir, patterns] of scanned) {
     let entries;
     try {
-      entries = (0, import_node_fs12.readdirSync)(dir, { withFileTypes: true });
+      entries = (0, import_node_fs13.readdirSync)(dir, { withFileTypes: true });
     } catch {
       unreadable.push(dir);
       continue;
@@ -1360,10 +1495,10 @@ function reapScratch(context, dryRun) {
     for (const entry of entries) {
       if (!patterns.some((pattern) => pattern.test(entry.name))) continue;
       if (!entry.isFile()) continue;
-      const path = (0, import_node_path10.join)(dir, entry.name);
+      const path = (0, import_node_path11.join)(dir, entry.name);
       let ageMs;
       try {
-        ageMs = now - (0, import_node_fs12.statSync)(path).mtimeMs;
+        ageMs = now - (0, import_node_fs13.statSync)(path).mtimeMs;
       } catch {
         continue;
       }
@@ -1373,7 +1508,7 @@ function reapScratch(context, dryRun) {
         continue;
       }
       try {
-        (0, import_node_fs12.rmSync)(path, { force: true });
+        (0, import_node_fs13.rmSync)(path, { force: true });
         reaped += 1;
       } catch (error) {
         failures.push(`${entry.name}: ${error?.code ?? error?.message ?? error}`);
@@ -1675,7 +1810,7 @@ function reconcile(options) {
           continue;
         }
         say(`${probe.id}: converging to v${summary.target}`);
-        const arm = probe.id === "claude" ? claudeArm({ target: summary.target, dryRun: options.dryRun, env }) : probe.id === "codex" ? codexArm({ target: summary.target, dryRun: options.dryRun, env }) : probe.id === "kilo" ? kiloArm({ target: summary.target, dryRun: options.dryRun, env }) : probe.id === "kimi" ? kimiArm({ target: summary.target, dryRun: options.dryRun, paths, env }) : probe.id === "cursor" ? cursorArm({ target: summary.target, dryRun: options.dryRun, paths, env }) : probe.id === "jervcode" ? jervcodeArm({ target: summary.target, dryRun: options.dryRun, paths, env }) : null;
+        const arm = probe.id === "claude" ? claudeArm({ target: summary.target, dryRun: options.dryRun, env }) : probe.id === "codex" ? codexArm({ target: summary.target, dryRun: options.dryRun, env }) : probe.id === "kilo" ? kiloArm({ target: summary.target, dryRun: options.dryRun, env }) : probe.id === "kimi" ? kimiArm({ target: summary.target, dryRun: options.dryRun, paths, env }) : probe.id === "cursor" ? cursorArm({ target: summary.target, dryRun: options.dryRun, paths, env }) : probe.id === "jervcode" ? jervcodeArm({ target: summary.target, dryRun: options.dryRun, paths, env }) : probe.id === "hermes" ? hermesArm({ target: summary.target, dryRun: options.dryRun, paths, env }) : null;
         if (arm) {
           summary.plugins.push(arm);
           summary.surfaces.push({ id: probe.id, present: true, action: `arm-${arm.verdict}` });
@@ -1708,8 +1843,8 @@ function reconcile(options) {
 
 // src/scheduler.ts
 var import_node_child_process9 = require("node:child_process");
-var import_node_fs13 = require("node:fs");
-var import_node_path11 = require("node:path");
+var import_node_fs14 = require("node:fs");
+var import_node_path12 = require("node:path");
 var TASK_NAME = "MMI Fleet Updater";
 var LAUNCHER_FILE = "reconcile-hidden.vbs";
 var RUN_BOUND = "PT15M";
@@ -1781,7 +1916,7 @@ function taskXml(launcherPath, workDir, userId, startBoundary) {
 }
 function readLauncher(path) {
   try {
-    return (0, import_node_fs13.readFileSync)(path, "utf8");
+    return (0, import_node_fs14.readFileSync)(path, "utf8");
   } catch {
     return null;
   }
@@ -1833,7 +1968,7 @@ function schedulerStatus(env = process.env) {
     return { ok: false, supported: true, enabled: false, ...empty, detail: `"${TASK_NAME}" is not registered \u2014 run \`mmi-hub autoupdate on\`` };
   }
   const hubDist = globalDist(env, "@mutmutco/hub", "dist/index.cjs");
-  const launcherPath = (0, import_node_path11.join)(statePaths(env).root, LAUNCHER_FILE);
+  const launcherPath = (0, import_node_path12.join)(statePaths(env).root, LAUNCHER_FILE);
   const info = taskRunInfo();
   const runInfo = info ?? empty;
   const fail = (detail) => ({ ok: false, supported: true, enabled: true, ...runInfo, detail });
@@ -1866,10 +2001,10 @@ function installTask(env = process.env) {
   const paths = ensureState(env);
   const userId = `${env.USERDOMAIN || env.COMPUTERNAME || ""}\\${env.USERNAME || ""}`.replace(/^\\/, "");
   if (!env.USERNAME) return { ok: false, detail: "cannot resolve the registering user (USERNAME unset) \u2014 the task principal must be explicit" };
-  const launcherPath = (0, import_node_path11.join)(paths.root, LAUNCHER_FILE);
-  (0, import_node_fs13.writeFileSync)(launcherPath, launcherVbs(process.execPath, hubDist), "utf8");
-  const xmlPath = (0, import_node_path11.join)(paths.root, "task.xml");
-  (0, import_node_fs13.writeFileSync)(xmlPath, "\uFEFF" + taskXml(launcherPath, paths.root, userId, localStartBoundary(/* @__PURE__ */ new Date())), "utf16le");
+  const launcherPath = (0, import_node_path12.join)(paths.root, LAUNCHER_FILE);
+  (0, import_node_fs14.writeFileSync)(launcherPath, launcherVbs(process.execPath, hubDist), "utf8");
+  const xmlPath = (0, import_node_path12.join)(paths.root, "task.xml");
+  (0, import_node_fs14.writeFileSync)(xmlPath, "\uFEFF" + taskXml(launcherPath, paths.root, userId, localStartBoundary(/* @__PURE__ */ new Date())), "utf16le");
   const create = schtasks(["/create", "/tn", TASK_NAME, "/xml", xmlPath, "/f"]);
   if (create.status !== 0) {
     const denied = /access is denied/i.test(create.stderr + create.stdout);
@@ -1903,16 +2038,16 @@ function uninstallTask(env = process.env) {
 }
 function dropLauncher(env) {
   try {
-    (0, import_node_fs13.rmSync)((0, import_node_path11.join)(statePaths(env).root, LAUNCHER_FILE), { force: true });
+    (0, import_node_fs14.rmSync)((0, import_node_path12.join)(statePaths(env).root, LAUNCHER_FILE), { force: true });
   } catch {
   }
 }
 
 // src/status.ts
-var import_node_fs14 = require("node:fs");
+var import_node_fs15 = require("node:fs");
 function readJournal(path) {
   try {
-    const events = (0, import_node_fs14.readFileSync)(path, "utf8").split("\n").filter((line) => line.trim()).map((line) => {
+    const events = (0, import_node_fs15.readFileSync)(path, "utf8").split("\n").filter((line) => line.trim()).map((line) => {
       try {
         return JSON.parse(line);
       } catch {
@@ -1950,6 +2085,8 @@ function hubStatus(hubVersion, env = process.env, invokedPath = process.argv[1])
       actual.set(surface.id, probeCursorInstallation());
     } else if (surface.id === "jervcode") {
       actual.set(surface.id, probeJervcodeInstallation(env));
+    } else if (surface.id === "hermes") {
+      actual.set(surface.id, probeHermesInstallation(env));
     }
   }
   const installed = {};
@@ -2011,7 +2148,7 @@ function formatHubStatus(status) {
 // src/index.ts
 function ownVersion() {
   try {
-    return JSON.parse((0, import_node_fs15.readFileSync)((0, import_node_path12.join)(__dirname, "..", "package.json"), "utf8")).version;
+    return JSON.parse((0, import_node_fs16.readFileSync)((0, import_node_path13.join)(__dirname, "..", "package.json"), "utf8")).version;
   } catch {
     return "0.0.0";
   }
@@ -2113,11 +2250,15 @@ if (typeof require !== "undefined" && require.main === module) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  enumerateSurfaces,
+  hermesArm,
+  hermesHome,
   hubStatus,
   launcherVbs,
   localStartBoundary,
   main,
   ownVersion,
+  probeHermesInstallation,
   schedulerStatus,
   taskXml
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/hub",
-  "version": "3.139.0",
+  "version": "3.139.1",
   "description": "Install and maintain the MMI CLI and every present host surface from one release-gated Hub command.",
   "type": "module",
   "license": "UNLICENSED",