@mutmutco/hub 4.4.5 → 4.4.7

package/dist/index.cjs

@@ -22,12 +22,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ACCENT: () => ACCENT,
+  FACE_PRODUCT: () => FACE_PRODUCT,
   MM_GREEN: () => MM_GREEN,
   RESET: () => RESET,
   accent: () => accent,
   acquireSharedDocLock: () => acquireSharedDocLock,
+  attentionRows: () => attentionRows,
   brandLine: () => brandLine,
   buildWatcherCommand: () => buildWatcherCommand,
+  checkAtomicity: () => checkAtomicity,
   checklistLine: () => checklistLine,
   claudeArm: () => claudeArm,
   claudeHostEvidence: () => claudeHostEvidence,
@@ -67,7 +70,6 @@ __export(index_exports, {
   progressiveRow: () => progressiveRow,
   readLaunchTarget: () => readLaunchTarget,
   readPending: () => readPending,
-  receipt: () => receipt,
   receiptText: () => receiptText,
   reconcile: () => reconcile,
   reconcileCursorUserHooks: () => reconcileCursorUserHooks,
@@ -80,18 +82,17 @@ __export(index_exports, {
   schedulerStatus: () => schedulerStatus,
   sharedDocLockPath: () => sharedDocLockPath,
   sharedDocLockTimeoutReceipt: () => sharedDocLockTimeoutReceipt,
+  shippedTargetFrom: () => shippedTargetFrom,
   shouldHandOff: () => shouldHandOff,
-  signOff: () => signOff,
-  startSpinner: () => startSpinner,
   surfaceArmPlan: () => surfaceArmPlan,
   systemdServiceUnit: () => systemdServiceUnit,
   systemdTimerUnit: () => systemdTimerUnit,
   taskXml: () => taskXml,
   updateHeader: () => updateHeader,
+  updaterFace: () => updaterFace,
   watcherLockPath: () => watcherLockPath,
-  welcome: () => welcome,
   withSharedDocLock: () => withSharedDocLock,
-  wrapWords: () => wrapWords,
+  wrapWords: () => wrapWords2,
   writeLaunchTarget: () => writeLaunchTarget,
   writePending: () => writePending
 });
@@ -100,6 +101,206 @@ var import_node_child_process9 = require("node:child_process");
 var import_node_fs18 = require("node:fs");
 var import_node_path13 = require("node:path");
 
+// node_modules/@mutmutco/installer-face/dist/index.js
+var PRODUCTS = Object.freeze({
+  "mm-strategy": Object.freeze({
+    name: "MM Strategy",
+    accent: "38;2;249;115;22",
+    warm: "Welcome. Let's set up MM Strategy \u2014 about a minute."
+  }),
+  "mmi-hub": Object.freeze({
+    name: "mmi-hub",
+    accent: "38;2;125;211;252",
+    warm: "Welcome back. Checking your surfaces\u2026"
+  }),
+  "jerv-hub": Object.freeze({
+    name: "jerv-hub",
+    accent: "38;2;248;113;113",
+    warm: "Welcome back. Checking your surfaces\u2026"
+  }),
+  jervcode: Object.freeze({
+    name: "JervCode",
+    accent: "38;2;192;132;252",
+    warm: "Welcome back. Keeping JervCode current\u2026"
+  })
+});
+function identityFor(product) {
+  const identity = PRODUCTS[product];
+  if (!identity) {
+    throw new Error(`unknown product ${JSON.stringify(product)} \u2014 add it to installer/face/src/products.ts rather than composing a greeting locally (known: ${Object.keys(PRODUCTS).join(", ")})`);
+  }
+  return identity;
+}
+var GLYPH = Object.freeze({
+  diamond: "\u25C6",
+  hollow: "\u25C7",
+  bar: "\u2502",
+  check: "\u2714",
+  cross: "\u2716",
+  dot: "\u25CF",
+  boxTop: "\u256D",
+  boxTopEnd: "\u256E",
+  boxBottom: "\u2570",
+  boxBottomEnd: "\u256F",
+  rule: "\u2500"
+});
+var PALETTE = Object.freeze({
+  green: "38;2;31;209;138",
+  ink: "38;2;237;237;237",
+  muted: "38;2;150;150;150",
+  line: "38;2;42;42;42"
+});
+var TITLE_COLUMN = 6;
+var ANSI = /\u001b\[[0-9;]*m/g;
+function visibleWidth(text) {
+  return [...String(text).replace(ANSI, "")].length;
+}
+function faceWidth(columns) {
+  const raw = Number(columns);
+  return Math.max(40, Math.min(100, Number.isFinite(raw) && raw > 0 ? raw : 100));
+}
+function wrapWords(text, width) {
+  const limit = Math.max(8, Math.floor(width));
+  const lines = [];
+  let line = "";
+  for (const word of String(text).split(/\s+/u).filter(Boolean)) {
+    let token = word;
+    while (visibleWidth(token) > limit) {
+      if (line) {
+        lines.push(line);
+        line = "";
+      }
+      lines.push([...token].slice(0, limit).join(""));
+      token = [...token].slice(limit).join("");
+    }
+    if (!line) line = token;
+    else if (visibleWidth(line) + 1 + visibleWidth(token) <= limit) line += ` ${token}`;
+    else {
+      lines.push(line);
+      line = token;
+    }
+  }
+  if (line) lines.push(line);
+  return lines.length ? lines : [""];
+}
+function createFace({ product, color = false, columns }) {
+  const identity = identityFor(product);
+  const width = faceWidth(columns);
+  const paint = (sgr, text) => color ? `\x1B[${sgr}m${text}\x1B[0m` : String(text);
+  const bar = () => paint(PALETTE.muted, GLYPH.bar);
+  const indent = " ".repeat(TITLE_COLUMN - 1);
+  const welcome = () => [
+    `${paint(identity.accent, GLYPH.diamond)}  ${paint(identity.accent, identity.name)} \u2014 Mutatis Mutandis`,
+    bar(),
+    `${bar()}  ${identity.warm}`,
+    bar()
+  ];
+  const step = (title, seconds = null, kind = "ok") => {
+    const glyph = kind === "fail" ? paint(identity.accent, GLYPH.cross) : kind === "note" ? paint(PALETTE.muted, GLYPH.hollow) : paint(PALETTE.green, GLYPH.check);
+    const time = seconds === null || seconds === void 0 ? "" : paint(PALETTE.muted, `${Math.max(0, Math.round(seconds))}s`);
+    const column = Math.min(44, Math.max(0, width - 8));
+    const reserved = time ? 6 : 0;
+    const [first, ...rest] = wrapWords(title, width - TITLE_COLUMN - reserved);
+    const head = `${bar()}  ${glyph}  ${first}`;
+    const pad = Math.max(1, column - visibleWidth(head));
+    return [time ? `${head}${" ".repeat(pad)}${time}` : head, ...rest.map((line) => `${bar()}${indent}${line}`)].join("\n");
+  };
+  const relay = (text) => String(text).split("\n").map((line) => line.trim() === "" ? bar() : `${bar()}${indent}${line}`).join("\n");
+  const receipt = (lines) => {
+    const body = (Array.isArray(lines) ? lines : String(lines).split("\n")).flatMap((raw) => {
+      const line = String(raw);
+      if (visibleWidth(line) <= width - 6) return [line];
+      const lead = /^\s*/u.exec(line)?.[0] ?? "";
+      return wrapWords(line, width - 6 - lead.length).map((part) => `${lead}${part}`);
+    });
+    const content = Math.min(width - 6, Math.max(...body.map(visibleWidth)));
+    const rule = paint(identity.accent, GLYPH.rule.repeat(content + 4));
+    const frame = (left, right) => `${paint(identity.accent, left)}${rule}${paint(identity.accent, right)}`;
+    return [
+      frame(GLYPH.boxTop, GLYPH.boxTopEnd),
+      ...body.map((line) => `${paint(identity.accent, GLYPH.bar)}  ${line}${" ".repeat(Math.max(0, content - visibleWidth(line)))}  ${paint(identity.accent, GLYPH.bar)}`),
+      frame(GLYPH.boxBottom, GLYPH.boxBottomEnd)
+    ];
+  };
+  const signOff = () => `${paint(identity.accent, GLYPH.diamond)}  ${paint(identity.accent, `${identity.name} \xB7 Mutatis Mutandis`)}`;
+  const refusal = (message3) => `${bar()}  ${paint(identity.accent, GLYPH.cross)}  ${message3}`;
+  return { identity, width, welcome, step, relay, receipt, signOff, refusal, paint };
+}
+var RELAY_INDENT = " ".repeat(TITLE_COLUMN - 1);
+var SEPARATOR = "\xB7";
+var subjectOf = (row) => row.aspect ? `${row.surface} ${row.aspect}` : row.surface;
+var groupKey = (row) => `${subjectOf(row)}\0${row.state}\0${row.mark ?? ""}\0${row.note ?? ""}`;
+function renderRows(face, rows) {
+  if (rows.length === 0) return [];
+  const groups = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const key = groupKey(row);
+    const found = groups.get(key);
+    if (found) {
+      if (row.instance) found.instances.push(row.instance);
+    } else {
+      groups.set(key, { row, instances: row.instance ? [row.instance] : [] });
+    }
+  }
+  const subjects = [...groups.values()].map(({ row, instances }) => instances.length > 1 ? subjectOf(row) : [subjectOf(row), instances[0]].filter(Boolean).join(` ${SEPARATOR} `));
+  const column = Math.min(Math.max(...subjects.map(visibleWidth)), Math.max(12, face.width - 24));
+  const lines = [];
+  for (const [index, { row, instances }] of [...groups.values()].entries()) {
+    const subject = subjects[index];
+    const tail2 = instances.length > 1 ? `${row.state} ${SEPARATOR} ${instances.join(", ")}` : row.state;
+    const body = `${clip(subject, column).padEnd(column)}  ${row.mark ? `${markGlyph(face, row.mark)}  ` : ""}${tail2}`;
+    lines.push(...face.relay(body).split("\n"));
+    if (row.note) {
+      for (const part of wrapWords(row.note, Math.max(16, face.width - column - 10))) {
+        lines.push(...face.relay(`${" ".repeat(column)}  ${part}`).split("\n"));
+      }
+    }
+  }
+  return lines;
+}
+function markGlyph(face, kind) {
+  const glyph = kind === "fail" ? GLYPH.cross : kind === "note" ? GLYPH.hollow : GLYPH.check;
+  return face.paint(kind === "fail" ? face.identity.accent : kind === "note" ? "38;2;150;150;150" : "38;2;31;209;138", glyph);
+}
+function clip(text, width) {
+  if (visibleWidth(text) <= width) return text;
+  return `\u2026${[...text].slice(-(width - 1)).join("")}`;
+}
+var FRAMES = ["\u25D2", "\u25D0", "\u25D3", "\u25D1"];
+function createSpinner(face, { animate, stream = process.stderr, intervalMs = 90 }) {
+  let timer = null;
+  let text = "";
+  let frame = 0;
+  const clear = () => {
+    if (animate) stream.write("\r\x1B[2K");
+  };
+  const draw = () => {
+    if (!animate) return;
+    const line = face.step(text, null, "note").split("\n")[0].replace(GLYPH.hollow, FRAMES[frame % FRAMES.length]);
+    stream.write(`\r\x1B[2K${line}`);
+    frame += 1;
+  };
+  return {
+    start(next) {
+      text = next;
+      frame = 0;
+      draw();
+      if (animate && !timer) timer = setInterval(draw, intervalMs).unref();
+    },
+    say(next) {
+      text = next;
+      draw();
+    },
+    stop() {
+      if (timer) clearInterval(timer);
+      timer = null;
+      clear();
+    }
+  };
+}
+var SPINNER_FRAMES = Object.freeze([...FRAMES]);
+var ALLOWED = new Set(Object.values(GLYPH));
+
 // src/state.ts
 var import_node_fs = require("node:fs");
 var import_node_os = require("node:os");
@@ -164,11 +365,12 @@ function withLease(path, fn, waitMs = LEASE_WAIT_MS) {
   for (; ; ) {
     const attempt = tryAcquire(path);
     if (typeof attempt === "object") {
-      try {
-        return fn();
-      } finally {
-        attempt.release();
+      const result = fn();
+      if (result && typeof result.then === "function") {
+        return result.finally(() => attempt.release());
       }
+      attempt.release();
+      return result;
     }
     if (Date.now() >= deadline) {
       throw new UpdaterBusy(`another updater holds ${path} (waited ${waitMs}ms) \u2014 deferring`);
@@ -187,23 +389,29 @@ function appendJournal(path, event) {
     return false;
   }
 }
-function journalHighWater(path, surface) {
+function journalHighWater(path, surface, events) {
   let high = null;
+  for (const event of events ?? parseJournal(path)) {
+    if (event.dryRun) continue;
+    if (event.surface === surface && event.verdict === "ok" && event.to && (!high || compareSemver(event.to, high) > 0)) {
+      high = event.to;
+    }
+  }
+  return high;
+}
+function parseJournal(path) {
+  const events = [];
   try {
     for (const line of (0, import_node_fs.readFileSync)(path, "utf8").split("\n")) {
       if (!line.trim()) continue;
       try {
-        const event = JSON.parse(line);
-        if (event.dryRun) continue;
-        if (event.surface === surface && event.verdict === "ok" && event.to && (!high || compareSemver(event.to, high) > 0)) {
-          high = event.to;
-        }
+        events.push(JSON.parse(line));
       } catch {
       }
     }
   } catch {
   }
-  return high;
+  return events;
 }
 function journalSurfaceRepeatedFail(path, surface, currentRun) {
   let lastVerdict = null;
@@ -254,6 +462,9 @@ function fileExists(path) {
   return (0, import_node_fs.existsSync)(path);
 }
 
+// src/reconcile.ts
+var import_node_perf_hooks2 = require("node:perf_hooks");
+
 // src/npm.ts
 var import_node_child_process = require("node:child_process");
 var import_node_fs2 = require("node:fs");
@@ -294,10 +505,40 @@ function runNpm(args, env = process.env, options = {}) {
   const result = npm.kind === "node-script" ? (0, import_node_child_process.spawnSync)(process.execPath, [npm.script, ...args], { encoding: "utf8", env, cwd: options.cwd, windowsHide: true }) : (0, import_node_child_process.spawnSync)(npm.command, args, { encoding: "utf8", env, cwd: options.cwd, shell: process.platform === "win32", windowsHide: true });
   return { status: result.status, stdout: result.stdout ?? "", stderr: result.stderr ?? "" };
 }
+function runNpmAsync(args, env = process.env, options = {}) {
+  const npm = resolveNpm(env);
+  const [file, argv, shell] = npm.kind === "node-script" ? [process.execPath, [npm.script, ...args], false] : [npm.command, args, process.platform === "win32"];
+  return new Promise((resolve) => {
+    let stdout = "";
+    let stderr = "";
+    let child;
+    try {
+      child = (0, import_node_child_process.spawn)(file, argv, { env, cwd: options.cwd, windowsHide: true, shell });
+    } catch (error) {
+      resolve({ status: null, stdout, stderr: String(error?.message ?? error) });
+      return;
+    }
+    child.stdout?.setEncoding("utf8");
+    child.stderr?.setEncoding("utf8");
+    child.stdout?.on("data", (chunk) => {
+      stdout += chunk;
+    });
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk;
+    });
+    child.on("error", (error) => resolve({ status: null, stdout, stderr: String(error?.message ?? error) }));
+    child.on("close", (status) => resolve({ status, stdout, stderr }));
+  });
+}
+var globalRootMemo = /* @__PURE__ */ new WeakMap();
 function globalRoot(env = process.env) {
+  const key = env;
+  const memoized = globalRootMemo.get(key);
+  if (memoized !== void 0) return memoized;
   const root = runNpm(["root", "-g"], env);
-  if (root.status !== 0 || !root.stdout.trim()) return null;
-  return root.stdout.trim();
+  const resolved = root.status !== 0 || !root.stdout.trim() ? null : root.stdout.trim();
+  globalRootMemo.set(key, resolved);
+  return resolved;
 }
 function npmView(spec, field, env = process.env) {
   const args = ["view", spec, "--json"];
@@ -317,8 +558,15 @@ function parseNpmDistIntegrity(value) {
   return typeof only === "string" && only.length > 0 ? only : null;
 }
 var npmStringField = parseNpmDistIntegrity;
-function npmDistIntegrity(spec, env = process.env) {
-  return parseNpmDistIntegrity(npmView(spec, "dist.integrity", env));
+async function npmDistIntegrityAsync(spec, env = process.env) {
+  const args = ["view", spec, "dist.integrity", "--json"];
+  const result = await runNpmAsync(args, env);
+  if (result.status !== 0 || !result.stdout.trim()) return null;
+  try {
+    return parseNpmDistIntegrity(JSON.parse(result.stdout));
+  } catch {
+    return null;
+  }
 }
 function npmVersions(packageName, env = process.env) {
   const versions = npmView(packageName, "versions", env);
@@ -398,38 +646,60 @@ function gateCandidate(cachePath, repoUrl, candidate) {
   }
   return { ok: true, tagCommit: commit, bom };
 }
-function checkAtomicity(cachePath, tagCommit, bom, candidate, npm) {
-  const rows = [];
-  for (const row of npmPackRows(bom)) {
+var ATOMICITY_CONCURRENCY = 4;
+async function mapBounded(items, bound, fn) {
+  const results = new Array(items.length);
+  let next = 0;
+  const workers = Array.from({ length: Math.min(bound, items.length) }, async () => {
+    for (; ; ) {
+      const index = next++;
+      if (index >= items.length) return;
+      results[index] = await fn(items[index], index);
+    }
+  });
+  await Promise.all(workers);
+  return results;
+}
+async function checkAtomicity(cachePath, tagCommit, bom, candidate, npm) {
+  const bomRows = npmPackRows(bom);
+  const verdicts = new Array(bomRows.length).fill(null);
+  const pending = [];
+  bomRows.forEach((row, index) => {
     if (row.version !== candidate) {
-      rows.push({ id: row.id, ok: false, detail: `BOM row at ${row.version}, candidate ${candidate}` });
-      continue;
+      verdicts[index] = { id: row.id, ok: false, detail: `BOM row at ${row.version}, candidate ${candidate}` };
+      return;
     }
     const manifestText = showFile(cachePath, tagCommit, `${row.identity.packagePath}/package.json`);
     let name;
-    let manifestVersion;
+    let manifestVersion2;
     try {
       const manifest2 = JSON.parse(manifestText ?? "");
       name = manifest2.name;
-      manifestVersion = manifest2.version;
+      manifestVersion2 = manifest2.version;
     } catch {
     }
-    if (!name || manifestVersion !== candidate) {
-      rows.push({ id: row.id, name, ok: false, detail: `package.json at ${row.identity.packagePath} is not stamped ${candidate}` });
-      continue;
+    if (!name || manifestVersion2 !== candidate) {
+      verdicts[index] = { id: row.id, name, ok: false, detail: `package.json at ${row.identity.packagePath} is not stamped ${candidate}` };
+      return;
     }
-    const integrity = npm.distIntegrity(`${name}@${candidate}`);
+    pending.push({ index, id: row.id, name });
+  });
+  const integrities = await mapBounded(pending, ATOMICITY_CONCURRENCY, (entry) => Promise.resolve(npm.distIntegrity(`${entry.name}@${candidate}`)));
+  pending.forEach((entry, i) => {
+    const integrity = integrities[i];
     if (!integrity) {
-      rows.push({ id: row.id, name, ok: false, detail: `${name}@${candidate} not on npm` });
-      continue;
+      verdicts[entry.index] = { id: entry.id, name: entry.name, ok: false, detail: `${entry.name}@${candidate} not on npm` };
+      return;
     }
+    const row = bomRows[entry.index];
     const legacySsri = /^sha\d+-/.test(row.identity.value ?? "");
     if (legacySsri && integrity !== row.identity.value) {
-      rows.push({ id: row.id, name, ok: false, detail: `${name}@${candidate} dist.integrity differs from BOM identity` });
-      continue;
+      verdicts[entry.index] = { id: entry.id, name: entry.name, ok: false, detail: `${entry.name}@${candidate} dist.integrity differs from BOM identity` };
+      return;
     }
-    rows.push({ id: row.id, name, ok: true, detail: legacySsri ? `${name}@${candidate} published, integrity matches` : `${name}@${candidate} published` });
-  }
+    verdicts[entry.index] = { id: entry.id, name: entry.name, ok: true, detail: legacySsri ? `${entry.name}@${candidate} published, integrity matches` : `${entry.name}@${candidate} published` };
+  });
+  const rows = verdicts.map((row, index) => row ?? { id: bomRows[index].id, ok: false, detail: "atomicity probe produced no verdict" });
   return { ok: rows.length > 0 && rows.every((row) => row.ok), rows };
 }
 
@@ -605,6 +875,15 @@ function probeVersion(distPath) {
 function tail(output) {
   return output.split("\n").filter(Boolean).slice(-3).join(" | ");
 }
+function manifestVersion(packageRoot) {
+  if (!packageRoot) return null;
+  try {
+    const version = JSON.parse((0, import_node_fs5.readFileSync)((0, import_node_path4.join)(packageRoot, "package.json"), "utf8")).version;
+    return typeof version === "string" ? version : null;
+  } catch {
+    return null;
+  }
+}
 function stagePackage(options) {
   const { surface, packageName, target, witness, paths, env } = options;
   const stageRoot = (0, import_node_path4.join)(paths.staging, surface, target);
@@ -632,12 +911,17 @@ function npmGlobalArm(options) {
   const { surface, packageName, distRel, target, dryRun, paths } = options;
   const spec = `${packageName}@${target}`;
   const result = (from, to, verdict, detail) => ({ surface, from, to, verdict, detail });
+  const highWater = journalHighWater(paths.journalPath, surface, options.journalEvents);
+  const localRoot = globalRoot(env);
+  const localVersion = localRoot ? manifestVersion((0, import_node_path4.join)(localRoot, ...packageName.split("/"))) : null;
+  if (localVersion === target && highWater === target) {
+    return result(localVersion, target, "ok", `already at target ${target} (installed manifest + journal high-water)`);
+  }
   const dist = globalDist(env, packageName, distRel);
   const installed = dist ? probeVersion(dist) : null;
   if (installed && compareSemver(installed, target) > 0) {
     return result(installed, installed, "skip", `installed ${installed} is above candidate ${target} (monotonic)`);
   }
-  const highWater = journalHighWater(paths.journalPath, surface);
   if (highWater && compareSemver(highWater, target) > 0) {
     return result(installed, highWater, "skip", `journal high-water ${highWater} is above candidate ${target} (monotonic)`);
   }
@@ -861,7 +1145,7 @@ function claudeArm(options) {
   if (from && compareSemver(from, target) > 0) {
     return result(from, from, "skip", `installed ${from} is above candidate ${target} (monotonic)`);
   }
-  const highWater = journalHighWater(paths.journalPath, "claude");
+  const highWater = journalHighWater(paths.journalPath, "claude", options.journalEvents);
   if (highWater && compareSemver(highWater, target) > 0) {
     return result(from, highWater, "skip", `journal high-water ${highWater} is above candidate ${target} (monotonic)`);
   }
@@ -1421,7 +1705,7 @@ function cursorArm(options) {
   if (installed && compareSemver(installed, target) > 0) {
     return result(installed, installed, "skip", `installed ${installed} is above candidate ${target} (monotonic)`);
   }
-  const highWater = journalHighWater(paths.journalPath, "cursor");
+  const highWater = journalHighWater(paths.journalPath, "cursor", options.journalEvents);
   if (highWater && compareSemver(highWater, target) > 0) {
     return result(installed, highWater, "skip", `journal high-water ${highWater} is above candidate ${target} (monotonic)`);
   }
@@ -1565,11 +1849,11 @@ function parseListText(stdout) {
 }
 function probeJervcodeInstallation(env = process.env, runner = runHostCommand) {
   const manifestLocation = materializedManifestLocation(env);
-  const manifestVersion = installedVersion(env);
+  const manifestVersion2 = installedVersion(env);
   const manifestEvidence = () => ({
-    version: manifestVersion,
+    version: manifestVersion2,
     location: manifestLocation,
-    detail: manifestVersion ? "materialized pi package manifest" : "materialized pi package manifest was unreadable"
+    detail: manifestVersion2 ? "materialized pi package manifest" : "materialized pi package manifest was unreadable"
   });
   const hosted = hostEnv(env);
   const command = hostCommands(env).find((bin) => runner(bin, ["--version"], hosted).status === 0);
@@ -1585,9 +1869,9 @@ function probeJervcodeInstallation(env = process.env, runner = runHostCommand) {
     };
   }
   const hostError = result.status !== 0 ? `${hostLocation} failed: ${failure2(result)}` : `${hostLocation} did not list npm:${PI_PACKAGE}`;
-  if (manifestVersion) {
+  if (manifestVersion2) {
     return {
-      version: manifestVersion,
+      version: manifestVersion2,
       location: manifestLocation,
       detail: `${hostError}; using materialized pi package manifest`
     };
@@ -1618,7 +1902,7 @@ function jervcodeArm(options) {
   if (!before) return result(null, options.target, "defer", `cannot read ${(0, import_node_path9.join)(jervcodeAgentDir(env), "settings.json")}`);
   const from = installedVersion(env);
   const legacy = before.filter(isLegacyMmiPiPath);
-  const highWater = journalHighWater(options.paths.journalPath, "jervcode");
+  const highWater = journalHighWater(options.paths.journalPath, "jervcode", options.journalEvents);
   const floor = from && compareSemver(from, options.target) > 0 ? `installed ${from} is above candidate ${options.target} (monotonic)` : highWater && compareSemver(highWater, options.target) > 0 ? `journal high-water ${highWater} is above candidate ${options.target} (monotonic)` : null;
   if (options.dryRun) {
     const action = floor ? `hold ${from ?? "the install"} and skip the install (${floor})` : before.includes(exact) && from === options.target ? "keep exact pin" : `install ${exact}`;
@@ -1810,7 +2094,7 @@ function hermesHomes(env = process.env) {
 var VERDICT_RANK = { fail: 3, defer: 2, ok: 1, skip: 0 };
 function hermesArm(options) {
   const env = options.env ?? process.env;
-  if (!hermesHostPresent(env, options.hostCommandRunner)) {
+  if (!(options.hostPresent ?? hermesHostPresent(env, options.hostCommandRunner))) {
     return {
       surface: "hermes",
       from: null,
@@ -1853,7 +2137,7 @@ function armHermesHome(home, env, options, primary) {
     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 = primary ? journalHighWater(options.paths.journalPath, "hermes") : null;
+  const highWater = primary ? journalHighWater(options.paths.journalPath, "hermes", options.journalEvents) : null;
   if (highWater && compareSemver(highWater, options.target) > 0) return result(installed, highWater, "skip", `journal high-water ${highWater} is above candidate ${options.target} (monotonic)`);
   const hostRunner = options.hostCommandRunner ?? runHostCommand;
   if (installed === options.target && treeHealthy2(live)) {
@@ -1955,6 +2239,10 @@ function probeHermesLaunchStaging(env = process.env) {
 // src/reap.ts
 var import_node_fs14 = require("node:fs");
 var import_node_path11 = require("node:path");
+var import_node_perf_hooks = require("node:perf_hooks");
+function elapsedMs(startedAt) {
+  return Math.round((import_node_perf_hooks.performance.now() - startedAt) * 10) / 10;
+}
 var KEEP_GENERATIONS2 = 2;
 var SCRATCH_AGE_MS = 24 * 60 * 6e4;
 function listDirs(path) {
@@ -2051,10 +2339,11 @@ function reap(options) {
   const { paths, dryRun } = options;
   const env = options.env ?? process.env;
   const guarded = (category, run) => {
+    const startedAt = import_node_perf_hooks.performance.now();
     try {
-      return run();
+      return { ...run(), durationMs: elapsedMs(startedAt) };
     } catch (error) {
-      return { category, reaped: 0, verdict: "fail", detail: `reap failed: ${error?.message ?? error}` };
+      return { category, reaped: 0, verdict: "fail", detail: `reap failed: ${error?.message ?? error}`, durationMs: elapsedMs(startedAt) };
     }
   };
   const atomicWritePaths = [claudeMarketplacesPath(env)];
@@ -2071,8 +2360,9 @@ function shouldHandOff(self, options) {
   if (!options.dist) return false;
   return self.verdict === "ok" && Boolean(self.from) && self.from !== self.to;
 }
-function reconcile(options) {
+async function reconcile(options) {
   const env = options.env ?? process.env;
+  const shipped = options.shippedTarget?.trim() || null;
   const say = (line) => {
     options.narrate?.(line);
     options.onPhase?.(line);
@@ -2086,9 +2376,9 @@ function reconcile(options) {
     if (!appendJournal(paths.journalPath, { ts: (/* @__PURE__ */ new Date()).toISOString(), run, ...stamped })) summary.journalOk = false;
   };
   const summary = { run, target: null, gate: null, managedSurfaces: null, atomicity: null, cli: null, updater: null, plugins: [], reap: [], surfaces: [], journalOk: true, reexec: null, exit: 0 };
-  const recordArm = (arm) => {
+  const recordArm = (arm, durationMs) => {
     if (arm.verdict === "fail") arm.repeatFailure = journalSurfaceRepeatedFail(paths.journalPath, arm.surface, run);
-    journal({ kind: "arm", surface: arm.surface, from: arm.from, to: arm.to, verdict: arm.verdict, detail: arm.detail, compat: arm.compat });
+    journal({ kind: "arm", surface: arm.surface, from: arm.from, to: arm.to, verdict: arm.verdict, detail: arm.detail, compat: arm.compat, durationMs });
     options.onArm?.(arm);
     if (arm.verdict === "ok" && !options.dryRun && !arm.launchStaged) clearPending(paths, arm.surface);
     if (arm.verdict === "defer") summary.exit = Math.max(summary.exit, 2);
@@ -2097,7 +2387,8 @@ function reconcile(options) {
   try {
     say("acquiring single-writer lease");
     const leaseWaitMs = Number(env.MMI_UPDATER_LEASE_WAIT_MS) || void 0;
-    return withLease(paths.leasePath, () => {
+    return await withLease(paths.leasePath, async () => {
+      const journalEvents = parseJournal(paths.journalPath);
       if (!options.dryRun) {
         const pendingBefore = readPending(paths);
         if (pendingBefore.length) {
@@ -2106,53 +2397,69 @@ function reconcile(options) {
         }
       }
       summary.reap = reap({ paths, dryRun: options.dryRun, env });
-      for (const row of summary.reap) journal({ kind: "reap", surface: row.category, verdict: row.verdict, count: row.reaped, detail: row.detail });
+      for (const row of summary.reap) journal({ kind: "reap", surface: row.category, verdict: row.verdict, count: row.reaped, detail: row.detail, durationMs: row.durationMs });
       for (const row of summary.reap.filter((entry) => entry.verdict !== "skip")) say(`reap ${row.category}: ${row.verdict}${row.detail ? " \u2014 " + row.detail : ""}`);
-      say("polling npm for @mutmutco/cli versions");
-      const versions = npmVersions("@mutmutco/cli", env).sort((a, b) => compareSemver(b, a));
-      if (!versions.length) {
-        journal({ kind: "poll", verdict: "fail", detail: "@mutmutco/cli has no npm versions \u2014 cannot discover a candidate" });
-        summary.exit = 1;
-        summary.detail = "npm poll returned no versions for @mutmutco/cli";
-        return summary;
-      }
-      say("fetching release BOM gate cache");
-      ensureBareCache(paths.gitCache, repoUrl);
-      fetchIntoCache(paths.gitCache, repoUrl, "refs/heads/main:refs/heads/main");
-      for (const candidate of versions.slice(0, bound)) {
-        say(`gating candidate v${candidate}`);
-        const gate = gateCandidate(paths.gitCache, repoUrl, candidate);
-        if (!gate.ok) {
-          say(`candidate v${candidate} rejected (${gate.reason ?? "gate"})`);
-          journal({ kind: "candidate-reject", to: candidate, verdict: "skip", detail: gate.reason ?? "gate rejected" });
-          continue;
+      if (shipped) {
+        say(`shipped target v${shipped} \u2014 the payload is the release; no npm poll, no gate`);
+        summary.target = shipped;
+        summary.gate = "shipped payload";
+        summary.managedSurfaces = null;
+        journal({ kind: "target", to: shipped, verdict: "ok", detail: "shipped payload" });
+      } else {
+        say("polling npm for @mutmutco/cli versions");
+        const pollStartedAt = import_node_perf_hooks2.performance.now();
+        const versions = npmVersions("@mutmutco/cli", env).sort((a, b) => compareSemver(b, a));
+        const pollMs = elapsedMs(pollStartedAt);
+        if (!versions.length) {
+          journal({ kind: "poll", verdict: "fail", durationMs: pollMs, detail: "@mutmutco/cli has no npm versions \u2014 cannot discover a candidate" });
+          summary.exit = 1;
+          summary.detail = "npm poll returned no versions for @mutmutco/cli";
+          return summary;
         }
-        const atomicity = checkAtomicity(paths.gitCache, gate.tagCommit, gate.bom, candidate, {
-          distIntegrity: (spec) => npmDistIntegrity(spec, env)
-        });
-        if (!atomicity.ok) {
-          journal({ kind: "candidate-reject", to: candidate, verdict: "skip", detail: `atomicity: ${atomicity.rows.filter((row) => !row.ok).map((row) => row.detail).join("; ")}` });
-          continue;
+        journal({ kind: "poll", verdict: "ok", count: versions.length, durationMs: pollMs, detail: `${versions.length} versions; newest ${versions[0]}` });
+        say("fetching release BOM gate cache");
+        const fetchStartedAt = import_node_perf_hooks2.performance.now();
+        ensureBareCache(paths.gitCache, repoUrl);
+        fetchIntoCache(paths.gitCache, repoUrl, "refs/heads/main:refs/heads/main");
+        journal({ kind: "gate", surface: "cache", verdict: "ok", durationMs: elapsedMs(fetchStartedAt), detail: "release BOM gate cache: refs/heads/main fetched" });
+        const walkStartedAt = import_node_perf_hooks2.performance.now();
+        for (const candidate of versions.slice(0, bound)) {
+          say(`gating candidate v${candidate}`);
+          const candidateStartedAt = import_node_perf_hooks2.performance.now();
+          const gate = gateCandidate(paths.gitCache, repoUrl, candidate);
+          if (!gate.ok) {
+            say(`candidate v${candidate} rejected (${gate.reason ?? "gate"})`);
+            journal({ kind: "candidate-reject", to: candidate, verdict: "skip", durationMs: elapsedMs(candidateStartedAt), detail: gate.reason ?? "gate rejected" });
+            continue;
+          }
+          const atomicity = await checkAtomicity(paths.gitCache, gate.tagCommit, gate.bom, candidate, {
+            distIntegrity: (spec) => npmDistIntegrityAsync(spec, env)
+          });
+          if (!atomicity.ok) {
+            journal({ kind: "candidate-reject", to: candidate, verdict: "skip", durationMs: elapsedMs(candidateStartedAt), detail: `atomicity: ${atomicity.rows.filter((row) => !row.ok).map((row) => row.detail).join("; ")}` });
+            continue;
+          }
+          summary.target = candidate;
+          summary.managedSurfaces = Array.isArray(gate.bom?.managedSurfaces) ? gate.bom.managedSurfaces.map(String) : null;
+          summary.gate = `tag v${candidate} reachable from main, BOM stamp coherent`;
+          summary.atomicity = atomicity;
+          journal({ kind: "target", to: candidate, verdict: "ok", durationMs: elapsedMs(candidateStartedAt), detail: summary.gate });
+          break;
         }
-        summary.target = candidate;
-        summary.managedSurfaces = Array.isArray(gate.bom?.managedSurfaces) ? gate.bom.managedSurfaces.map(String) : null;
-        summary.gate = `tag v${candidate} reachable from main, BOM stamp coherent`;
-        summary.atomicity = atomicity;
-        journal({ kind: "target", to: candidate, verdict: "ok", detail: summary.gate });
-        break;
-      }
-      if (!summary.target) {
-        say("no green target \u2014 deferred");
-        journal({ kind: "target", verdict: "defer", detail: `no green candidate in the newest ${Math.min(bound, versions.length)} versions \u2014 registry not ready for this fleet stamp yet` });
-        for (const probe of enumerateSurfaces(env)) {
-          summary.surfaces.push({ id: probe.id, present: probe.present, action: probe.present ? "deferred-no-target" : "absent-skip" });
-          journal({ kind: "surface", surface: probe.id, present: probe.present, verdict: "skip", detail: probe.present ? "present; no green target yet" : `absent (${probe.marker}) \u2014 skipped` });
+        if (!summary.target) {
+          say("no green target \u2014 deferred");
+          journal({ kind: "target", verdict: "defer", durationMs: elapsedMs(walkStartedAt), detail: `no green candidate in the newest ${Math.min(bound, versions.length)} versions \u2014 registry not ready for this fleet stamp yet` });
+          for (const probe of enumerateSurfaces(env)) {
+            summary.surfaces.push({ id: probe.id, present: probe.present, action: probe.present ? "deferred-no-target" : "absent-skip" });
+            journal({ kind: "surface", surface: probe.id, present: probe.present, verdict: "skip", detail: probe.present ? "present; no green target yet" : `absent (${probe.marker}) \u2014 skipped` });
+          }
+          return summary;
         }
-        return summary;
       }
       say(`target v${summary.target} (${summary.gate})`);
       options.onTargetResolved?.(summary.target, summary.gate);
       say("updater: self-bootstrap");
+      const selfStartedAt = import_node_perf_hooks2.performance.now();
       const self = npmGlobalArm({
         surface: "updater",
         packageName: "@mutmutco/hub",
@@ -2160,10 +2467,11 @@ function reconcile(options) {
         target: summary.target,
         dryRun: options.dryRun,
         paths,
-        env
+        env,
+        journalEvents
       });
       summary.updater = self;
-      recordArm(self);
+      recordArm(self, elapsedMs(selfStartedAt));
       say(`updater: ${self.verdict}${self.detail ? " \u2014 " + self.detail : ""}`);
       const handoffDist = globalDist(env, "@mutmutco/hub", "dist/index.cjs");
       if (shouldHandOff(self, { dryRun: options.dryRun, dist: handoffDist, guard: env.MMI_UPDATER_REEXEC })) {
@@ -2173,6 +2481,7 @@ function reconcile(options) {
         return summary;
       }
       say(`cli: converging to v${summary.target}`);
+      const cliStartedAt = import_node_perf_hooks2.performance.now();
       const cli = npmGlobalArm({
         surface: "cli",
         packageName: "@mutmutco/cli",
@@ -2180,10 +2489,11 @@ function reconcile(options) {
         target: summary.target,
         dryRun: options.dryRun,
         paths,
-        env
+        env,
+        journalEvents
       });
       summary.cli = cli;
-      recordArm(cli);
+      recordArm(cli, elapsedMs(cliStartedAt));
       say(`cli: ${cli.verdict}${cli.detail ? " \u2014 " + cli.detail : ""}`);
       for (const probe of enumerateSurfaces(env)) {
         if (!probe.present) {
@@ -2198,11 +2508,12 @@ function reconcile(options) {
           continue;
         }
         say(`${probe.id}: converging to v${summary.target}`);
-        const arm = probe.id === "claude" ? claudeArm({ target: summary.target, dryRun: options.dryRun, paths, env, repoUrl }) : probe.id === "codex" ? codexArm({ target: summary.target, dryRun: options.dryRun, env, repoUrl }) : 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;
+        const armStartedAt = import_node_perf_hooks2.performance.now();
+        const arm = probe.id === "claude" ? claudeArm({ target: summary.target, dryRun: options.dryRun, paths, env, repoUrl, journalEvents }) : probe.id === "codex" ? codexArm({ target: summary.target, dryRun: options.dryRun, env, repoUrl }) : probe.id === "cursor" ? cursorArm({ target: summary.target, dryRun: options.dryRun, paths, env, journalEvents }) : probe.id === "jervcode" ? jervcodeArm({ target: summary.target, dryRun: options.dryRun, paths, env, journalEvents }) : probe.id === "hermes" ? hermesArm({ target: summary.target, dryRun: options.dryRun, paths, env, hostPresent: probe.present, journalEvents }) : null;
         if (arm) {
           summary.plugins.push(arm);
           summary.surfaces.push({ id: probe.id, present: true, action: `arm-${arm.verdict}` });
-          recordArm(arm);
+          recordArm(arm, elapsedMs(armStartedAt));
           say(`${probe.id}: ${arm.verdict}${arm.detail ? " \u2014 " + arm.detail : ""}`);
         } else {
           summary.surfaces.push({ id: probe.id, present: true, action: "arm-pending" });
@@ -2914,28 +3225,50 @@ var ARM_TITLE = {
   hermes: "Arming Hermes",
   jervcode: "Arming JervCode"
 };
-var CHECKLIST_TAIL = {
-  updated: "",
-  current: " current",
-  keep: " keep",
-  retry: " will retry",
-  failed: " failed",
-  pending: " pending"
+var FACE_PRODUCT = "mmi-hub";
+function updaterFace(options = {}) {
+  return createFace({ product: FACE_PRODUCT, color: options.color ?? false, columns: options.width });
+}
+var STATE_WORD = {
+  updated: "updated",
+  current: "current",
+  keep: "kept",
+  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) {
+function stepKindFor(kind) {
+  return kind === "failed" ? "fail" : kind === "retry" ? "note" : "ok";
+}
+function checklistLine(arm, seconds, face, options = {}) {
+  const { kind } = classify(arm);
+  const state = options.dryRun && kind === "updated" ? "would update" : STATE_WORD[kind];
+  const title = `${ARM_TITLE[arm.surface] ?? `Arming ${arm.surface}`} \u2014 ${state}`;
+  const truthful = kind === "failed" || kind === "retry" ? null : seconds;
+  return face.step(title, truthful, stepKindFor(kind));
+}
+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];
+}
+function attentionRows(summary) {
+  return collectRows(summary).filter((row) => row.kind === "failed" || row.kind === "retry" || row.kind === "pending").map((row) => ({
+    surface: row.name,
+    state: statusText(row.kind, false),
+    mark: row.kind === "failed" ? "fail" : "note",
+    note: row.kind === "failed" ? failConsequence(row) : row.kind === "retry" ? retryHint(row.detail) : "arm not landed"
+  }));
+}
+function wrapWords2(text, available) {
   if (available < 1) return [text];
   const lines = [];
   let current = "";
@@ -2956,7 +3289,7 @@ function noteLines(prefix, note, width) {
   const available = width - used - 1;
   const indent = available >= MIN_NOTE_SPACE ? " ".repeat(used + 1) : " ".repeat(Math.min(used + 1, Math.max(2, width - MIN_NOTE_SPACE)));
   const room = available >= MIN_NOTE_SPACE ? available : width - indent.length;
-  const parts = wrapWords(note, room);
+  const parts = wrapWords2(note, room);
   const first = available >= MIN_NOTE_SPACE ? prefix + " " + parts[0] : prefix.replace(/\s+$/, "");
   const lines = [first];
   for (const part of parts.slice(available >= MIN_NOTE_SPACE ? 1 : 0)) lines.push(indent + part);
@@ -2979,7 +3312,7 @@ function collectRows(summary) {
 }
 function headline(detail, width) {
   const first = (detail ?? "").split(/(?<=[.;:])\s/)[0]?.replace(/\s+/g, " ").trim() ?? "";
-  return wrapWords(first || "blocked", Math.max(10, width - 4))[0];
+  return wrapWords2(first || "blocked", Math.max(10, width - 4))[0];
 }
 function updateHeader(target, dryRun = false, options) {
   return brandLine(
@@ -3081,124 +3414,6 @@ 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"];
-var WORKER_SRC = `
-const { parentPort, workerData } = require('node:worker_threads');
-const frames = ${JSON.stringify(FRAMES)};
-const control = new Int32Array(workerData.sab);
-let frame = 0, label = '', timer = null;
-function tick() {
-  if (Atomics.load(control, 0) === 1) return; // paused by the main thread
-  if (!label) return;
-  process.stderr.write('\\r' + frames[frame++ % frames.length] + ' ' + label + '\\x1b[K');
-}
-parentPort.on('message', (message) => {
-  if (message && message.type === 'label') { label = message.label; if (!timer) timer = setInterval(tick, 80); }
-  else if (message === 'stop') { if (timer) clearInterval(timer); process.stderr.write('\\r\\x1b[K'); process.exit(0); }
-});
-`;
-var NOOP = { label() {
-}, persist() {
-}, stop() {
-}, active: false };
-function startSpinner(enabled) {
-  if (!enabled) return NOOP;
-  let worker;
-  let control;
-  try {
-    const sab = new SharedArrayBuffer(4);
-    control = new Int32Array(sab);
-    worker = new import_node_worker_threads.Worker(WORKER_SRC, { eval: true, workerData: { sab } });
-    worker.unref();
-    worker.on("error", () => {
-    });
-  } catch {
-    return NOOP;
-  }
-  let stopped = false;
-  return {
-    active: true,
-    label: (text) => {
-      if (!stopped) worker.postMessage({ type: "label", label: text });
-    },
-    persist: (line) => {
-      Atomics.store(control, 0, 1);
-      process.stderr.write("\r\x1B[K");
-      process.stdout.write(line + "\n");
-      Atomics.store(control, 0, 0);
-    },
-    stop: () => {
-      if (stopped) return;
-      stopped = true;
-      worker.postMessage("stop");
-    }
-  };
-}
-
 // src/stamp.ts
 var import_node_fs17 = require("node:fs");
 var ALWAYS_ARMED = ["cli", "updater"];
@@ -3296,17 +3511,33 @@ function printReconcile(summary, json, dryRun = false) {
 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);
+function openFace(args, json, dryRun) {
+  if (!faceEnabled(args, json)) return null;
+  const face = updaterFace(humanOptions(dryRun));
+  if (!process.env.MMI_UPDATER_REEXEC) for (const line of face.welcome()) process.stdout.write(line + "\n");
   return face;
 }
-function finishFace(summary, autoupdate, dryRun) {
+function finishFace(face, 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);
+  const write = (line) => {
+    process.stdout.write(line + "\n");
+  };
+  if (!summary.target) {
+    process.stdout.write(formatReconcileReport(summary, { ...options, tty: false }));
+  } else {
+    for (const line of renderRows(face, attentionRows(summary))) write(line);
+  }
+  const body = receiptText(summary, autoupdate, { dryRun });
+  const counts = reportCounts(summary);
+  if (counts.failed > 0) {
+    body.push("", "Fix: mmi-cli doctor, then mmi-hub update", `Log: ${options.journalPath}`);
+  }
+  const self = summary.updater;
+  if (!dryRun && self && self.from && self.to && self.from !== self.to && self.verdict !== "fail") {
+    body.push("", `Note: hub moved ${self.from} \u2192 ${self.to} while the surfaces above were converging, so they used ${self.from} logic \u2014 rerun \`mmi-hub update\` to bring them to ${self.to}`);
+  }
+  for (const line of face.receipt(body)) write(line);
+  write(face.signOff());
 }
 function handOff(reexec, args) {
   const child = (0, import_node_child_process9.spawnSync)(process.execPath, [reexec.dist, ...args], {
@@ -3337,7 +3568,13 @@ function heldOutput(write) {
     }
   };
 }
-function runUpdate(args, json, face = false) {
+function shippedTargetFrom(args) {
+  const index = args.indexOf("--shipped");
+  if (index < 0) return void 0;
+  const value = (args[index + 1] ?? "").trim();
+  return value && !value.startsWith("--") ? value : void 0;
+}
+async function runUpdate(args, json, face = null, shippedTarget) {
   const dryRun = args.includes("--dry-run");
   const verbose = args.includes("--verbose");
   const narrate = (line) => {
@@ -3346,19 +3583,35 @@ function runUpdate(args, json, face = false) {
   };
   const progressive = !json && !verbose && Boolean(process.stderr.isTTY);
   if (!progressive) {
-    return { summary: reconcile({ dryRun, narrate: verbose ? narrate : void 0 }), rendered: false };
+    return reconcile({ dryRun, narrate: verbose ? narrate : void 0, shippedTarget }).then((summary2) => ({ summary: summary2, rendered: false }));
   }
   const reportOptions = humanOptions(dryRun);
-  const spinner = startSpinner(true);
+  const spinner = createSpinner(face ?? updaterFace(reportOptions), { animate: true, stream: process.stderr });
+  let spinning = false;
+  const phase = (line) => {
+    if (spinning) spinner.say(line);
+    else {
+      spinner.start(line);
+      spinning = true;
+    }
+  };
+  const persist = (line) => {
+    if (spinning) {
+      spinner.stop();
+      spinning = false;
+    }
+    process.stdout.write(line + "\n");
+  };
   let headerEmitted = false;
   let summary;
-  const { emit, stream } = heldOutput((line) => spinner.persist(line));
+  const { emit, stream } = heldOutput(persist);
   let arms = 0;
   let mark = Date.now();
   try {
-    summary = reconcile({
+    summary = await reconcile({
       dryRun,
-      onPhase: (line) => spinner.label(line),
+      shippedTarget,
+      onPhase: (line) => phase(line),
       onTargetResolved: face ? void 0 : (target) => {
         emit(updateHeader(target, dryRun, reportOptions));
         emit("");
@@ -3368,7 +3621,7 @@ function runUpdate(args, json, face = false) {
         const seconds = (Date.now() - mark) / 1e3;
         mark = Date.now();
         if (arms++) stream();
-        emit(face ? checklistLine(arm, seconds, reportOptions) : progressiveRow(arm, reportOptions));
+        emit(face ? checklistLine(arm, seconds, face, reportOptions) : progressiveRow(arm, reportOptions));
       }
     });
   } finally {
@@ -3381,7 +3634,7 @@ function runUpdate(args, json, face = false) {
   else process.stdout.write(formatReconcileReport(summary, reportOptions));
   return { summary, rendered: true };
 }
-function main(args = process.argv.slice(2)) {
+async function main(args = process.argv.slice(2)) {
   if (args.includes("--version")) {
     process.stdout.write(ownVersion() + "\n");
     return 0;
@@ -3398,19 +3651,21 @@ function main(args = process.argv.slice(2)) {
     return status.failures.length ? 1 : 0;
   }
   if (command === "update") {
-    const face = openFace(args, json);
-    const { summary, rendered } = runUpdate(args, json, face);
+    const dryRun = args.includes("--dry-run");
+    const face = openFace(args, json, dryRun);
+    const { summary, rendered } = await runUpdate(args, json, face);
     if (summary.reexec) return handOff(summary.reexec, args);
-    if (face) finishFace(summary, null, args.includes("--dry-run"));
-    else if (!rendered) printReconcile(summary, json, args.includes("--dry-run"));
+    if (face) finishFace(face, summary, null, dryRun);
+    else if (!rendered) printReconcile(summary, json, dryRun);
     return summary.exit;
   }
   if (command === "install") {
-    const face = openFace(args, json);
     const dryRun = args.includes("--dry-run");
-    const { summary, rendered } = runUpdate(args, json, face);
+    const face = openFace(args, json, dryRun);
+    const shippedTarget = shippedTargetFrom(args);
+    const { summary, rendered } = await runUpdate(args, json, face, shippedTarget);
     if (summary.reexec) {
-      const handedOff = handOff(summary.reexec, ["update", ...args.filter((arg) => arg !== "install")]);
+      const handedOff = handOff(summary.reexec, ["update", ...args.filter((arg) => arg !== "install" && arg !== "--shipped" && arg !== shippedTarget)]);
       const scheduled = installTask();
       if (!json) {
         process.stdout.write(scheduled.ok ? `  Auto-update on \u2014 hourly task "MMI Fleet Updater".
@@ -3425,7 +3680,7 @@ function main(args = process.argv.slice(2)) {
     if (json) {
       process.stdout.write(JSON.stringify({ convergence: summary, autoupdate: schedule }, null, 2) + "\n");
     } else if (face) {
-      finishFace(summary, schedule, dryRun);
+      finishFace(face, summary, schedule, dryRun);
     } else {
       if (!rendered) printReconcile(summary, false, dryRun);
       process.stdout.write(schedule.ok ? `  Auto-update on \u2014 hourly task "MMI Fleet Updater".
@@ -3450,17 +3705,24 @@ function main(args = process.argv.slice(2)) {
   return 1;
 }
 if (typeof require !== "undefined" && require.main === module) {
-  process.exit(main());
+  main().then((code) => process.exit(code)).catch((error) => {
+    process.stderr.write(`mmi-hub: ${error?.stack ?? error}
+`);
+    process.exit(1);
+  });
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ACCENT,
+  FACE_PRODUCT,
   MM_GREEN,
   RESET,
   accent,
   acquireSharedDocLock,
+  attentionRows,
   brandLine,
   buildWatcherCommand,
+  checkAtomicity,
   checklistLine,
   claudeArm,
   claudeHostEvidence,
@@ -3500,7 +3762,6 @@ if (typeof require !== "undefined" && require.main === module) {
   progressiveRow,
   readLaunchTarget,
   readPending,
-  receipt,
   receiptText,
   reconcile,
   reconcileCursorUserHooks,
@@ -3513,16 +3774,15 @@ if (typeof require !== "undefined" && require.main === module) {
   schedulerStatus,
   sharedDocLockPath,
   sharedDocLockTimeoutReceipt,
+  shippedTargetFrom,
   shouldHandOff,
-  signOff,
-  startSpinner,
   surfaceArmPlan,
   systemdServiceUnit,
   systemdTimerUnit,
   taskXml,
   updateHeader,
+  updaterFace,
   watcherLockPath,
-  welcome,
   withSharedDocLock,
   wrapWords,
   writeLaunchTarget,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/hub",
-  "version": "4.4.5",
+  "version": "4.4.7",
   "description": "Install and maintain the MMI CLI and every present host surface from one release-gated Hub command.",
   "type": "module",
   "license": "UNLICENSED",
@@ -25,6 +25,9 @@
     "test": "node build.mjs && node --test test/*.test.cjs",
     "typecheck": "tsc --noEmit"
   },
+  "dependencies": {
+    "@mutmutco/installer-face": "^0.2.0"
+  },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "esbuild": "^0.28.1",