@mutmutco/hub 4.0.11 → 4.0.13

package/dist/index.cjs

@@ -35,6 +35,7 @@ __export(index_exports, {
   ownVersion: () => ownVersion,
   probeHermesInstallation: () => probeHermesInstallation,
   progressiveRow: () => progressiveRow,
+  reconcileCursorUserHooks: () => reconcileCursorUserHooks,
   reportFooterLines: () => reportFooterLines,
   retryHint: () => retryHint,
   schedulerStatus: () => schedulerStatus,
@@ -1038,6 +1039,8 @@ var import_node_os4 = require("node:os");
 var import_node_path8 = require("node:path");
 var PACKAGE = "@mutmutco/cursor-plugin";
 var MANIFEST = ".cursor-plugin/plugin.json";
+var USER_HOOKS_FILE = "hooks.json";
+var PLUGIN_HOOKS_REL = ["hooks", "cursor-hooks.json"];
 var KEEP_GENERATIONS = 2;
 var STRANDED_TMP_AGE_MS = 24 * 60 * 6e4;
 var TREE_FILES = [MANIFEST, "skills/mmi/SKILL.md", "hooks/cursor-hooks.json", "scripts/hook-run.mjs", "scripts/hook-policy.mjs"];
@@ -1100,6 +1103,84 @@ function cursorHostEvidence(env) {
   }
   return null;
 }
+function resolvedPluginRoot(root) {
+  return (0, import_node_path8.join)(root).replace(/\\/g, "/");
+}
+function isMmiEntry(entry, pluginRoot) {
+  return typeof entry === "object" && entry !== null && typeof entry.command === "string" && entry.command.includes(resolvedPluginRoot(pluginRoot));
+}
+function resolveCommand(command, pluginRoot) {
+  return command.replaceAll("${CURSOR_PLUGIN_ROOT}", resolvedPluginRoot(pluginRoot));
+}
+function desiredUserHooks(pluginRoot) {
+  try {
+    const doc = JSON.parse((0, import_node_fs10.readFileSync)((0, import_node_path8.join)(pluginRoot, ...PLUGIN_HOOKS_REL), "utf8"));
+    const hooks = doc.hooks;
+    if (typeof hooks !== "object" || hooks === null || Array.isArray(hooks)) return null;
+    const desired = /* @__PURE__ */ new Map();
+    for (const [event, entries] of Object.entries(hooks)) {
+      if (!Array.isArray(entries)) return null;
+      desired.set(event, entries.map((entry) => {
+        const command = typeof entry.command === "string" ? entry.command : "";
+        return { ...entry, command: resolveCommand(command, pluginRoot) };
+      }));
+    }
+    return desired;
+  } catch {
+    return null;
+  }
+}
+function mergeUserHooks(existing, desired, pluginRoot) {
+  if (typeof existing !== "object" || existing === null || Array.isArray(existing)) return null;
+  const merged = { ...existing };
+  const hooks = merged.hooks ?? {};
+  if (typeof hooks !== "object" || hooks === null || Array.isArray(hooks)) return null;
+  const nextHooks = {};
+  for (const [event, entries] of Object.entries(hooks)) {
+    if (!Array.isArray(entries)) return null;
+    const kept = entries.filter((entry) => !isMmiEntry(entry, pluginRoot));
+    nextHooks[event] = [...kept, ...desired.get(event) ?? []];
+  }
+  for (const [event, entries] of desired) {
+    if (!(event in hooks)) nextHooks[event] = entries;
+  }
+  merged.hooks = nextHooks;
+  return merged;
+}
+function reconcileCursorUserHooks(pluginRoot, homeDir) {
+  const desired = desiredUserHooks(pluginRoot);
+  if (!desired) return "source-unreadable";
+  const path = (0, import_node_path8.join)(homeDir, ".cursor", USER_HOOKS_FILE);
+  if (!(0, import_node_fs10.existsSync)(path)) {
+    (0, import_node_fs10.writeFileSync)(path, JSON.stringify({ version: 1, hooks: Object.fromEntries(desired) }, null, 2) + "\n", "utf8");
+    return "updated";
+  }
+  let existing;
+  try {
+    existing = JSON.parse((0, import_node_fs10.readFileSync)(path, "utf8"));
+  } catch {
+    return "user-conflict";
+  }
+  const merged = mergeUserHooks(existing, desired, pluginRoot);
+  if (!merged) return "user-conflict";
+  if (JSON.stringify(merged) === JSON.stringify(existing)) return "current";
+  const tmp = `${path}.tmp-${process.pid}`;
+  (0, import_node_fs10.writeFileSync)(tmp, JSON.stringify(merged, null, 2) + "\n", "utf8");
+  (0, import_node_fs10.renameSync)(tmp, path);
+  return "updated";
+}
+function userHooksDetail(pluginRoot, homeDir) {
+  switch (reconcileCursorUserHooks(pluginRoot, homeDir)) {
+    case "updated":
+      return "; user hooks bridged into ~/.cursor/hooks.json";
+    case "user-conflict":
+      return `; USER HOOKS CONFLICT at ${(0, import_node_path8.join)(homeDir, ".cursor", USER_HOOKS_FILE)} \u2014 Cursor gates are NOT bridged; fix or remove that file and reconcile`;
+    case "source-unreadable":
+      return "; user hooks source unreadable \u2014 Cursor gates are NOT bridged";
+    default:
+      return "";
+  }
+}
 function writeRollbackPointer(root, entry) {
   const path = (0, import_node_path8.join)(root, "quarantine", "rollback.json");
   const tmp = `${path}.tmp-${process.pid}`;
@@ -1188,7 +1269,7 @@ function cursorArm(options) {
     return result(installed, highWater, "skip", `journal high-water ${highWater} is above candidate ${target} (monotonic)`);
   }
   if (installed === target && treeHealthy2(live)) {
-    return result(installed, target, "ok", `already at target ${target}`);
+    return result(installed, target, "ok", `already at target ${target}${userHooksDetail(live, (0, import_node_os4.homedir)())}`);
   }
   if ((0, import_node_fs10.existsSync)(live) && !mmiOwned(live)) {
     return result(installed, target, "defer", `${live} carries no MMI ownership marker (plugin manifest name, or a ${PACKAGE} package.json) \u2014 refusing to displace an unmanaged directory (mmi-cli plugin heal adopts it)`);
@@ -1256,7 +1337,7 @@ function cursorArm(options) {
   writeRollbackPointer(root, { installed: target, previous: installed, generation: displaced ? quarantined : null });
   const pruned = pruneQuarantine(root, displaced ? quarantined : null);
   const previous = displaced ? `previous generation quarantined at ${quarantined}` : "no previous generation to quarantine";
-  return result(installed, target, "ok", `switched ${installed ?? "absent"} -> ${target}; ${previous}${pruned ? `; pruned ${pruned} older generation${pruned === 1 ? "" : "s"}` : ""}`);
+  return result(installed, target, "ok", `switched ${installed ?? "absent"} -> ${target}; ${previous}${pruned ? `; pruned ${pruned} older generation${pruned === 1 ? "" : "s"}` : ""}${userHooksDetail(live, (0, import_node_os4.homedir)())}`);
 }
 
 // src/arm-jervcode.ts
@@ -2909,6 +2990,7 @@ if (typeof require !== "undefined" && require.main === module) {
   ownVersion,
   probeHermesInstallation,
   progressiveRow,
+  reconcileCursorUserHooks,
   reportFooterLines,
   retryHint,
   schedulerStatus,

package/package.json

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