@mutmutco/hub 4.4.0 → 4.4.1

package/dist/index.cjs

@@ -21,8 +21,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ACCENT: () => ACCENT,
+  MM_GREEN: () => MM_GREEN,
+  RESET: () => RESET,
+  accent: () => accent,
   acquireSharedDocLock: () => acquireSharedDocLock,
+  brandLine: () => brandLine,
   buildWatcherCommand: () => buildWatcherCommand,
+  checklistLine: () => checklistLine,
   claudeArm: () => claudeArm,
   claudeHostEvidence: () => claudeHostEvidence,
   clearLaunchTarget: () => clearLaunchTarget,
@@ -61,9 +67,12 @@ __export(index_exports, {
   progressiveRow: () => progressiveRow,
   readLaunchTarget: () => readLaunchTarget,
   readPending: () => readPending,
+  receipt: () => receipt,
+  receiptText: () => receiptText,
   reconcile: () => reconcile,
   reconcileCursorUserHooks: () => reconcileCursorUserHooks,
   releaseSharedDocLock: () => releaseSharedDocLock,
+  reportCounts: () => reportCounts,
   reportFooterLines: () => reportFooterLines,
   retiredSurfaces: () => retiredSurfaces,
   retryHint: () => retryHint,
@@ -72,6 +81,7 @@ __export(index_exports, {
   sharedDocLockPath: () => sharedDocLockPath,
   sharedDocLockTimeoutReceipt: () => sharedDocLockTimeoutReceipt,
   shouldHandOff: () => shouldHandOff,
+  signOff: () => signOff,
   startSpinner: () => startSpinner,
   surfaceArmPlan: () => surfaceArmPlan,
   systemdServiceUnit: () => systemdServiceUnit,
@@ -79,6 +89,7 @@ __export(index_exports, {
   taskXml: () => taskXml,
   updateHeader: () => updateHeader,
   watcherLockPath: () => watcherLockPath,
+  welcome: () => welcome,
   withSharedDocLock: () => withSharedDocLock,
   wrapWords: () => wrapWords,
   writeLaunchTarget: () => writeLaunchTarget,
@@ -2818,6 +2829,13 @@ var RED = "\x1B[31m";
 var RESET = "\x1B[0m";
 var ACCENT = "\x1B[38;2;125;211;252m";
 var MUTED = "\x1B[38;2;150;150;150m";
+var MM_GREEN = "\x1B[38;2;31;209;138m";
+function accent(text, color) {
+  return color ? ACCENT + text + RESET : text;
+}
+function brandLine(rest, color = false) {
+  return `${accent("mmi-hub", color)} \xB7 Mutatis Mutandis \u2014 ${rest}`;
+}
 var RETRY_HINTS = [
   [/applies when the host exits|applies on a quiet tick/, "installs when the app closes"],
   [/in flight|changed while/, "rerun update \u2014 host race"],
@@ -2887,6 +2905,36 @@ function glyphFor(kind) {
 function colorFor(kind) {
   return kind === "failed" ? RED : kind === "retry" ? YELLOW : GREEN;
 }
+var ARM_TITLE = {
+  updater: "Updating mmi-hub",
+  cli: "Installing mmi-cli",
+  claude: "Arming Claude Code",
+  codex: "Arming Codex",
+  cursor: "Arming Cursor",
+  hermes: "Arming Hermes",
+  jervcode: "Arming JervCode"
+};
+var CHECKLIST_TAIL = {
+  updated: "",
+  current: " current",
+  keep: " keep",
+  retry: " will retry",
+  failed: " failed",
+  pending: " pending"
+};
+function checklistLine(arm, seconds, options = {}) {
+  const tty = options.tty ?? false;
+  const color = tty && (options.color ?? true);
+  const dryRun = options.dryRun ?? false;
+  const kind = classify(arm).kind;
+  const tone = kind === "failed" ? RED : kind === "retry" ? YELLOW : MM_GREEN;
+  const paint = (text) => color ? tone + text + RESET : text;
+  const glyph = kind === "failed" ? "\u2716" : kind === "retry" ? "\u25CF" : "\u2714";
+  const title = ARM_TITLE[arm.surface] ?? `Arming ${arm.surface}`;
+  const tail2 = dryRun && kind === "updated" ? " would update" : CHECKLIST_TAIL[kind];
+  const time = seconds !== null && kind !== "retry" && kind !== "failed" ? `  ${Math.max(1, Math.round(seconds))}s` : "";
+  return `  ${paint(glyph)}  ${title}${tail2}${time}`;
+}
 function wrapWords(text, available) {
   if (available < 1) return [text];
   const lines = [];
@@ -2934,8 +2982,10 @@ function headline(detail, width) {
   return wrapWords(first || "blocked", Math.max(10, width - 4))[0];
 }
 function updateHeader(target, dryRun = false, options) {
-  const accent = (text) => options?.color ? ACCENT + text + RESET : text;
-  return dryRun ? `${accent("mmi-hub")} \xB7 Mutatis Mutandis \u2014 update plan to ${target} (dry run)` : `${accent("mmi-hub")} \xB7 Mutatis Mutandis \u2014 updating to ${target} (verified)`;
+  return brandLine(
+    dryRun ? `update plan to ${target} (dry run)` : `updating to ${target} (verified)`,
+    Boolean(options?.color)
+  );
 }
 function renderRowLines(row, ctx) {
   const paint = (kind, text) => ctx.color ? colorFor(kind) + text + RESET : text;
@@ -2955,6 +3005,16 @@ function progressiveRow(arm, options = {}) {
   const dryRun = options.dryRun ?? false;
   return renderRowLines(classify(arm), { tty, color, dryRun, width, statusWidth: progressiveStatusWidth(dryRun) }).join("\n");
 }
+function reportCounts(summary) {
+  const rows = collectRows(summary);
+  return {
+    updated: rows.filter((row) => row.kind === "updated").length,
+    current: rows.filter((row) => row.kind === "current" || row.kind === "keep").length,
+    retry: rows.filter((row) => row.kind === "retry").length,
+    failed: rows.filter((row) => row.kind === "failed").length,
+    total: rows.length
+  };
+}
 function reportFooterLines(summary, options = {}) {
   const width = Math.max(40, options.width ?? DEFAULT_WIDTH);
   const tty = options.tty ?? false;
@@ -2963,12 +3023,7 @@ function reportFooterLines(summary, options = {}) {
   const journalPath = options.journalPath ?? "~/.mmi/updater/journal.jsonl";
   const paint = (kind, text) => color ? colorFor(kind) + text + RESET : text;
   const rows = collectRows(summary);
-  const counts = {
-    updated: rows.filter((row) => row.kind === "updated").length,
-    retry: rows.filter((row) => row.kind === "retry").length,
-    failed: rows.filter((row) => row.kind === "failed").length,
-    total: rows.length
-  };
+  const counts = reportCounts(summary);
   const footer = dryRun ? `${counts.updated}/${counts.total} would update` : `${counts.updated}/${counts.total} updated` + (counts.retry ? ` \xB7 ${counts.retry} will retry` : "") + (counts.failed ? ` \xB7 ${counts.failed} failed` : "");
   const out = ["", "  " + footer];
   if (tty && !dryRun && counts.failed === 0) {
@@ -3002,13 +3057,7 @@ function formatReconcileReport(summary, options = {}) {
   const out = [];
   const paint = (kind, text) => color ? colorFor(kind) + text + RESET : text;
   const rows = collectRows(summary);
-  const counts = {
-    updated: rows.filter((row) => row.kind === "updated").length,
-    current: rows.filter((row) => row.kind === "current" || row.kind === "keep").length,
-    retry: rows.filter((row) => row.kind === "retry").length,
-    failed: rows.filter((row) => row.kind === "failed").length,
-    total: rows.length
-  };
+  const counts = reportCounts(summary);
   if (!summary.target) {
     if ((summary.exit >= 1 || summary.deferred) && summary.detail) {
       out.push("MMI Hub \u2014 cannot update now");
@@ -3032,6 +3081,68 @@ function formatReconcileReport(summary, options = {}) {
   return out.join("\n") + "\n";
 }
 
+// src/face.ts
+var DEFAULT_WIDTH2 = 100;
+function welcome(color, output = process.stdout) {
+  const mark = color ? MM_GREEN + "\u25C6" + RESET : "\u25C6";
+  output.write(`${mark}  ${accent("mmi-hub", color)} \u2014 Mutatis Mutandis
+`);
+  output.write("\u2502\n");
+  output.write("\u2502  Welcome back. Checking your surfaces\u2026\n");
+  output.write("\u2502\n");
+}
+var TONES = { "\u2714": MM_GREEN, "\u2716": RED, "\u25CF": YELLOW };
+function paintGlyph(line, color) {
+  if (!color) return line;
+  const glyph = line.trimStart()[0];
+  const tone = TONES[glyph];
+  if (!tone) return line;
+  const at = line.indexOf(glyph);
+  return line.slice(0, at) + tone + glyph + RESET + line.slice(at + 1);
+}
+function receipt(text, options = {}) {
+  const color = options.color ?? false;
+  const width = Math.max(40, options.width ?? DEFAULT_WIDTH2);
+  const output = options.output ?? process.stdout;
+  const edges = 2 * 2 + 2;
+  const available = width - edges;
+  const lines = [];
+  for (const paragraph of text.split("\n")) {
+    if (!paragraph.trim()) lines.push(null);
+    else if (paragraph.length <= available) lines.push(paragraph);
+    else for (const line of wrapWords(paragraph, available)) lines.push(line);
+  }
+  const inner = Math.min(available, Math.max(20, ...lines.map((line) => line?.length ?? 0)));
+  const rule = "\u2500".repeat(inner + 2 * 2);
+  const frame = (text2) => color ? ACCENT + text2 + RESET : text2;
+  const blank = `${frame("\u2502")}${" ".repeat(inner + 2 * 2)}${frame("\u2502")}`;
+  output.write(frame(`\u256D${rule}\u256E`) + "\n");
+  for (const line of lines) {
+    output.write(line === null ? blank + "\n" : `${frame("\u2502")}  ${paintGlyph(line.padEnd(inner), color)}  ${frame("\u2502")}
+`);
+  }
+  output.write(frame(`\u2570${rule}\u256F`) + "\n");
+}
+function signOff(color, output = process.stdout) {
+  output.write(`\u2570  ${accent("mmi-hub \xB7 Mutatis Mutandis", color)}
+`);
+}
+function receiptText(summary, autoupdate, options = {}) {
+  const dry = options.dryRun ?? false;
+  const counts = reportCounts(summary);
+  const health = "Check health any time:  mmi-hub status";
+  if (!summary.target) {
+    return `${summary.exit >= 1 ? "\u2716" : "\u25CF"}  mmi-hub is not ready \u2014 no green release yet (hourly retry)
+${health}`;
+  }
+  const ready = counts.failed === 0;
+  const glyph = counts.failed > 0 ? "\u2716" : counts.retry > 0 ? "\u25CF" : dry ? "\u25C7" : "\u2714";
+  const state = counts.failed > 0 ? `${counts.failed} of ${counts.total} surfaces failed` : counts.retry > 0 ? `${counts.retry} of ${counts.total} surfaces will retry` : counts.updated > 0 ? `${counts.updated}/${counts.total} surfaces ${dry ? "would update" : "updated"}` : `all ${counts.total} surfaces current`;
+  const tail2 = autoupdate ? ` \xB7 ${autoupdate.ok ? "auto-update on" : `auto-update NOT enabled \u2014 ${autoupdate.detail}`}` : ` \xB7 ${summary.target}${dry ? " (planned)" : " (verified)"}`;
+  return `${glyph}  mmi-hub is ${ready ? "ready" : "not ready"} \u2014 ${state}${tail2}
+${health}`;
+}
+
 // src/spinner.ts
 var import_node_worker_threads = require("node:worker_threads");
 var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
@@ -3166,18 +3277,36 @@ var HELP = `mmi-hub ${ownVersion()} \u2014 install and maintain MMI tooling
 State remains under $MMI_UPDATER_HOME (default ~/.mmi/updater), and the Windows task name remains
 "MMI Fleet Updater", so existing installations continue in place.
 Status performs no npm install, host repair, scheduler write, state mkdir, or repository cleanup.`;
-function printReconcile(summary, json, dryRun = false) {
-  if (json) {
-    process.stdout.write(JSON.stringify(summary, null, 2) + "\n");
-    return;
-  }
-  process.stdout.write(formatReconcileReport(summary, {
+function humanOptions(dryRun) {
+  return {
     tty: Boolean(process.stdout.isTTY),
     color: !process.env.NO_COLOR,
     width: process.stdout.columns ?? 100,
     dryRun,
     journalPath: statePaths(process.env).journalPath
-  }));
+  };
+}
+function printReconcile(summary, json, dryRun = false) {
+  if (json) {
+    process.stdout.write(JSON.stringify(summary, null, 2) + "\n");
+    return;
+  }
+  process.stdout.write(formatReconcileReport(summary, humanOptions(dryRun)));
+}
+function faceEnabled(args, json) {
+  return !json && !args.includes("--verbose") && !process.env.NO_COLOR && process.env.TERM !== "dumb" && Boolean(process.stdout.isTTY) && Boolean(process.stderr.isTTY);
+}
+function openFace(args, json) {
+  const face = faceEnabled(args, json);
+  if (face && !process.env.MMI_UPDATER_REEXEC) welcome(true);
+  return face;
+}
+function finishFace(summary, autoupdate, dryRun) {
+  const options = humanOptions(dryRun);
+  if (!summary.target) process.stdout.write(formatReconcileReport(summary, options));
+  else if (summary.exit >= 1) process.stdout.write(reportFooterLines(summary, options).join("\n") + "\n");
+  receipt(receiptText(summary, autoupdate, { dryRun }), { color: options.color, width: options.width });
+  signOff(true);
 }
 function handOff(reexec, args) {
   const child = (0, import_node_child_process9.spawnSync)(process.execPath, [reexec.dist, ...args], {
@@ -3208,7 +3337,7 @@ function heldOutput(write) {
     }
   };
 }
-function runUpdate(args, json) {
+function runUpdate(args, json, face = false) {
   const dryRun = args.includes("--dry-run");
   const verbose = args.includes("--verbose");
   const narrate = (line) => {
@@ -3219,30 +3348,27 @@ function runUpdate(args, json) {
   if (!progressive) {
     return { summary: reconcile({ dryRun, narrate: verbose ? narrate : void 0 }), rendered: false };
   }
-  const reportOptions = {
-    tty: Boolean(process.stdout.isTTY),
-    color: !process.env.NO_COLOR,
-    width: process.stdout.columns ?? 100,
-    dryRun,
-    journalPath: statePaths(process.env).journalPath
-  };
+  const reportOptions = humanOptions(dryRun);
   const spinner = startSpinner(true);
   let headerEmitted = false;
   let summary;
   const { emit, stream } = heldOutput((line) => spinner.persist(line));
   let arms = 0;
+  let mark = Date.now();
   try {
     summary = reconcile({
       dryRun,
       onPhase: (line) => spinner.label(line),
-      onTargetResolved: (target) => {
+      onTargetResolved: face ? void 0 : (target) => {
         emit(updateHeader(target, dryRun, reportOptions));
         emit("");
         headerEmitted = true;
       },
       onArm: (arm) => {
+        const seconds = (Date.now() - mark) / 1e3;
+        mark = Date.now();
         if (arms++) stream();
-        emit(progressiveRow(arm, reportOptions));
+        emit(face ? checklistLine(arm, seconds, reportOptions) : progressiveRow(arm, reportOptions));
       }
     });
   } finally {
@@ -3250,6 +3376,7 @@ function runUpdate(args, json) {
   }
   if (summary.reexec) return { summary, rendered: true };
   stream();
+  if (face) return { summary, rendered: true };
   if (headerEmitted) process.stdout.write(reportFooterLines(summary, reportOptions).join("\n") + "\n");
   else process.stdout.write(formatReconcileReport(summary, reportOptions));
   return { summary, rendered: true };
@@ -3271,13 +3398,17 @@ function main(args = process.argv.slice(2)) {
     return status.failures.length ? 1 : 0;
   }
   if (command === "update") {
-    const { summary, rendered } = runUpdate(args, json);
+    const face = openFace(args, json);
+    const { summary, rendered } = runUpdate(args, json, face);
     if (summary.reexec) return handOff(summary.reexec, args);
-    if (!rendered) printReconcile(summary, json, args.includes("--dry-run"));
+    if (face) finishFace(summary, null, args.includes("--dry-run"));
+    else if (!rendered) printReconcile(summary, json, args.includes("--dry-run"));
     return summary.exit;
   }
   if (command === "install") {
-    const { summary, rendered } = runUpdate(args, json);
+    const face = openFace(args, json);
+    const dryRun = args.includes("--dry-run");
+    const { summary, rendered } = runUpdate(args, json, face);
     if (summary.reexec) {
       const handedOff = handOff(summary.reexec, ["update", ...args.filter((arg) => arg !== "install")]);
       const scheduled = installTask();
@@ -3293,8 +3424,10 @@ function main(args = process.argv.slice(2)) {
     const schedule = installTask();
     if (json) {
       process.stdout.write(JSON.stringify({ convergence: summary, autoupdate: schedule }, null, 2) + "\n");
+    } else if (face) {
+      finishFace(summary, schedule, dryRun);
     } else {
-      if (!rendered) printReconcile(summary, false, args.includes("--dry-run"));
+      if (!rendered) printReconcile(summary, false, dryRun);
       process.stdout.write(schedule.ok ? `  Auto-update on \u2014 hourly task "MMI Fleet Updater".
 ` : `  Auto-update NOT enabled \u2014 ${schedule.detail}
 `);
@@ -3321,8 +3454,14 @@ if (typeof require !== "undefined" && require.main === module) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ACCENT,
+  MM_GREEN,
+  RESET,
+  accent,
   acquireSharedDocLock,
+  brandLine,
   buildWatcherCommand,
+  checklistLine,
   claudeArm,
   claudeHostEvidence,
   clearLaunchTarget,
@@ -3361,9 +3500,12 @@ if (typeof require !== "undefined" && require.main === module) {
   progressiveRow,
   readLaunchTarget,
   readPending,
+  receipt,
+  receiptText,
   reconcile,
   reconcileCursorUserHooks,
   releaseSharedDocLock,
+  reportCounts,
   reportFooterLines,
   retiredSurfaces,
   retryHint,
@@ -3372,6 +3514,7 @@ if (typeof require !== "undefined" && require.main === module) {
   sharedDocLockPath,
   sharedDocLockTimeoutReceipt,
   shouldHandOff,
+  signOff,
   startSpinner,
   surfaceArmPlan,
   systemdServiceUnit,
@@ -3379,6 +3522,7 @@ if (typeof require !== "undefined" && require.main === module) {
   taskXml,
   updateHeader,
   watcherLockPath,
+  welcome,
   withSharedDocLock,
   wrapWords,
   writeLaunchTarget,

package/package.json

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