@mutmutco/hub 4.4.4 → 4.4.6

package/dist/index.cjs

@@ -80,6 +80,7 @@ __export(index_exports, {
   schedulerStatus: () => schedulerStatus,
   sharedDocLockPath: () => sharedDocLockPath,
   sharedDocLockTimeoutReceipt: () => sharedDocLockTimeoutReceipt,
+  shippedTargetFrom: () => shippedTargetFrom,
   shouldHandOff: () => shouldHandOff,
   signOff: () => signOff,
   startSpinner: () => startSpinner,
@@ -2073,6 +2074,7 @@ function shouldHandOff(self, options) {
 }
 function reconcile(options) {
   const env = options.env ?? process.env;
+  const shipped = options.shippedTarget?.trim() || null;
   const say = (line) => {
     options.narrate?.(line);
     options.onPhase?.(line);
@@ -2108,47 +2110,55 @@ 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.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 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;
         }
-        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;
+        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;
+          }
+          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;
+          }
+          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;
         }
-        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", 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);
@@ -3337,7 +3347,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;
+}
+function runUpdate(args, json, face = false, shippedTarget) {
   const dryRun = args.includes("--dry-run");
   const verbose = args.includes("--verbose");
   const narrate = (line) => {
@@ -3346,7 +3362,7 @@ 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 { summary: reconcile({ dryRun, narrate: verbose ? narrate : void 0, shippedTarget }), rendered: false };
   }
   const reportOptions = humanOptions(dryRun);
   const spinner = startSpinner(true);
@@ -3358,6 +3374,7 @@ function runUpdate(args, json, face = false) {
   try {
     summary = reconcile({
       dryRun,
+      shippedTarget,
       onPhase: (line) => spinner.label(line),
       onTargetResolved: face ? void 0 : (target) => {
         emit(updateHeader(target, dryRun, reportOptions));
@@ -3408,9 +3425,10 @@ function main(args = process.argv.slice(2)) {
   if (command === "install") {
     const face = openFace(args, json);
     const dryRun = args.includes("--dry-run");
-    const { summary, rendered } = runUpdate(args, json, face);
+    const shippedTarget = shippedTargetFrom(args);
+    const { summary, rendered } = 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".
@@ -3513,6 +3531,7 @@ if (typeof require !== "undefined" && require.main === module) {
   schedulerStatus,
   sharedDocLockPath,
   sharedDocLockTimeoutReceipt,
+  shippedTargetFrom,
   shouldHandOff,
   signOff,
   startSpinner,

package/package.json

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