@mutmutco/cli 2.23.0 → 2.24.0

package/README.md

@@ -29,9 +29,12 @@ mmi-cli doctor --json
 
 - `mmi-cli rules sync` delivers the org-owned `AGENTS.md`, `CLAUDE.md`, and Claude settings files.
 - `mmi-cli docs sync` refreshes repo-owned `README.md` and `architecture.md` without clobbering dirty files.
-- `mmi-cli saga note`, `saga show`, `saga health`, `saga session`, `saga capture`, and `saga head-update` write and inspect session continuity through a cached Hub session token.
+- `mmi-cli saga note`, `saga show`, `saga health`, `saga session`, `saga capture`, and `saga head-update` write and inspect session continuity through a cached Hub session token. Saga writes are local-first: a transient server miss queues the note in a local pending file and a detached flush worker delivers it — a queued note is normal, not a failure.
 - `mmi-cli kb get` and `kb list` read the MM KB source (`kb list [prefix]` lists document paths, optionally under a prefix).
-- `mmi-cli northstar push|pull|list|delete|graduate` manages North Star, the per-user plan/SSOT store.
+- `mmi-cli northstar push|pull|list|status|sync|delete|graduate` manages North Star, the per-user plan/SSOT store.
+  `northstar push` is async by default — it queues a durable background push and prints a "queued" line,
+  which is the expected success path. `northstar status` shows pending/conflicted pushes; `northstar sync`
+  (or `push --wait`) gives durable server confirmation. Never treat a queued push as failure.
   `northstar graduate <slug> --merged-pr <url-or-number> --org-visible` marks a built-and-merged plan for
   KB curation without echoing the plan body.
   `mmi-cli plan` remains a compatibility alias.

package/dist/main.cjs

@@ -3582,6 +3582,20 @@ var FLUSH_LOCK_STALE_MS = 5 * 6e4;
 function pendingPath(dir = ".mmi") {
   return (0, import_node_path3.join)(dir, PENDING_FILE);
 }
+var PENDING_TMP_STALE_MS = 6e4;
+function sweepStaleTmp(dir = ".mmi", now = Date.now()) {
+  try {
+    for (const name of (0, import_node_fs3.readdirSync)(dir)) {
+      if (!name.startsWith(`${PENDING_FILE}.`) || !name.endsWith(".tmp")) continue;
+      const path2 = (0, import_node_path3.join)(dir, name);
+      try {
+        if (now - (0, import_node_fs3.statSync)(path2).mtimeMs > PENDING_TMP_STALE_MS) (0, import_node_fs3.unlinkSync)(path2);
+      } catch {
+      }
+    }
+  } catch {
+  }
+}
 function flushLockPath(dir = ".mmi") {
   return (0, import_node_path3.join)(dir, FLUSH_LOCK_FILE);
 }
@@ -3625,15 +3639,20 @@ function readPending(dir = ".mmi") {
   return out;
 }
 function writePending(entries, dir = ".mmi") {
+  const tmp = `${pendingPath(dir)}.${process.pid}.tmp`;
   try {
     (0, import_node_fs3.mkdirSync)(dir, { recursive: true });
+    sweepStaleTmp(dir);
     const trimmed = entries.slice(-PENDING_MAX);
     const body = trimmed.map((e) => JSON.stringify(e)).join("\n");
-    const tmp = `${pendingPath(dir)}.${process.pid}.tmp`;
     (0, import_node_fs3.writeFileSync)(tmp, trimmed.length ? `${body}
 ` : "", "utf8");
     (0, import_node_fs3.renameSync)(tmp, pendingPath(dir));
   } catch {
+    try {
+      (0, import_node_fs3.unlinkSync)(tmp);
+    } catch {
+    }
   }
 }
 function enqueuePending(body, dir = ".mmi") {
@@ -3646,6 +3665,7 @@ function enqueuePending(body, dir = ".mmi") {
       return;
     }
     (0, import_node_fs3.mkdirSync)(dir, { recursive: true });
+    sweepStaleTmp(dir);
     (0, import_node_fs3.appendFileSync)(pendingPath(dir), `${JSON.stringify({ id, body })}
 `, "utf8");
   } catch {
@@ -6423,7 +6443,8 @@ var MANAGED_GITIGNORE_LINES = [
   ".claude/worktrees/",
   ".mmi/.session",
   ".mmi/head-ts/",
-  ".mmi/saga-pending.jsonl",
+  ".mmi/saga-pending.jsonl*",
+  ".mmi/saga-flush.lock",
   ".aws-sam/",
   "/*.png"
 ];
@@ -7579,10 +7600,37 @@ async function resolveRcResumeTag(deps, base, sha) {
   const note = leftovers.length > 0 ? `resuming existing RC tag ${newest} already on ${sha.slice(0, 7)} (newest of ${sorted.length}); harmless leftover tag(s) on the same SHA: ${leftovers.join(", ")}` : `resuming existing RC tag ${newest} already on ${sha.slice(0, 7)} instead of minting a fresh rc`;
   return { tag: newest, note };
 }
-async function dispatchDeploy(deps, ctx, stage2, ref, model, watch, autoRunSince, autoRunHeadSha) {
+var DISPATCH_ATTEMPTS = 3;
+var DISPATCH_RETRY_DELAY_MS = 2e3;
+function isTransientDispatchFailure(e) {
+  const msg = e instanceof Error ? e.message : String(e);
+  return /timed? ?out|timeout|aborted|network|fetch failed|ECONNRESET|ECONNREFUSED|EAI_AGAIN/i.test(msg);
+}
+async function dispatchTenantDeployWithRetry(deps, input) {
+  const sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  for (let attempt = 1; ; attempt++) {
+    try {
+      await deps.dispatchTenantDeploy(input);
+      return;
+    } catch (e) {
+      if (attempt >= DISPATCH_ATTEMPTS || !isTransientDispatchFailure(e)) throw e;
+      await sleep(DISPATCH_RETRY_DELAY_MS * attempt);
+    }
+  }
+}
+async function dispatchDeploy(deps, ctx, stage2, ref, model, watch, autoRunSince, autoRunHeadSha, dispatchFailure = "throw") {
   if (model === "tenant-container" || model === "solo-container") {
     const since = (deps.now ?? Date.now)();
-    await deps.dispatchTenantDeploy({ repo: ctx.repo, slug: ctx.slug, ref, stage: stage2 });
+    try {
+      await dispatchTenantDeployWithRetry(deps, { repo: ctx.repo, slug: ctx.slug, ref, stage: stage2 });
+    } catch (e) {
+      if (dispatchFailure === "throw") throw e;
+      const msg = e instanceof Error ? e.message : String(e);
+      return {
+        note: `tenant-deploy dispatch FAILED: ${msg}. The promotion itself landed (merge/tag/Release pushed before the dispatch) \u2014 recover the deploy with \`mmi-cli tenant redeploy ${ctx.repo} ${stage2}\`; never re-tag.`,
+        deployStatus: "failure"
+      };
+    }
     const { runId, runUrl } = await correlateTenantRun(deps, since);
     const deployStatus = watch ? await watchTenantRun(deps, runId) : "pending";
     return { note: `dispatched tenant-deploy.yml (slug=${ctx.slug}, ref=${ref}, stage=${stage2})`, runId, runUrl, deployStatus };
@@ -7716,7 +7764,7 @@ async function runTrainApply(command, deps, options = {}) {
     const releaseUrl2 = clean(await deps.run("gh", ["release", "create", tag2, "--generate-notes", "--latest", "--repo", ctx.repo])) || void 0;
     const announceNote2 = deps.announce ? (await deps.announce({ repo: ctx.repo, tag: tag2, summaryFile: options.announceSummaryFile })).note : void 0;
     const autoRunSince2 = (deps.now ?? Date.now)();
-    const d2 = await dispatchDeploy(deps, ctx, "main", "main", deployModel2, watch, autoRunSince2, releaseSha2);
+    const d2 = await dispatchDeploy(deps, ctx, "main", "main", deployModel2, watch, autoRunSince2, releaseSha2, "report");
     await deps.run("git", ["checkout", "development"]);
     await deps.run("git", ["pull", "--ff-only", "origin", "development"]);
     await deps.run("git", ["merge", "main", "--no-edit"]);
@@ -7787,7 +7835,7 @@ async function runTrainApply(command, deps, options = {}) {
     const releaseUrl2 = clean(await deps.run("gh", ["release", "create", tag2, "--generate-notes", "--latest", "--repo", ctx.repo])) || void 0;
     const announceNote2 = deps.announce ? (await deps.announce({ repo: ctx.repo, tag: tag2, summaryFile: options.announceSummaryFile })).note : void 0;
     const autoRunSince2 = (deps.now ?? Date.now)();
-    const d2 = await dispatchDeploy(deps, ctx, "main", "main", deployModel2, watch, autoRunSince2, releaseSha2);
+    const d2 = await dispatchDeploy(deps, ctx, "main", "main", deployModel2, watch, autoRunSince2, releaseSha2, "report");
     const retirement2 = await retireRcRuntime(deps, ctx, deployModel2, d2.deployStatus, rcShaAtRelease);
     await deps.run("git", ["checkout", "development"]);
     await deps.run("git", ["pull", "--ff-only", "origin", "development"]);
@@ -7867,7 +7915,7 @@ async function runTrainApply(command, deps, options = {}) {
   const releaseUrl = clean(await deps.run("gh", ["release", "create", tag, "--target", "main", "--generate-notes", "--latest", "--repo", ctx.repo])) || void 0;
   await verifyPublishedRelease(deps, ctx.repo, tag, "main", releaseSha);
   const announceNote = deps.announce ? (await deps.announce({ repo: ctx.repo, tag, summaryFile: options.announceSummaryFile })).note : void 0;
-  const d = await dispatchDeploy(deps, ctx, "main", "main", deployModel, watch, autoRunSince, releaseSha);
+  const d = await dispatchDeploy(deps, ctx, "main", "main", deployModel, watch, autoRunSince, releaseSha, "report");
   const retirement = await retireRcRuntime(deps, ctx, deployModel, d.deployStatus, releasedRcSha);
   await deps.run("git", ["checkout", "development"]);
   await deps.run("git", ["pull", "--ff-only", "origin", "development"]);
@@ -9478,6 +9526,7 @@ var PROJECTS_ENVELOPE_KEY = "projects";
 // src/registry-client.ts
 var DEFAULT_TIMEOUT_MS2 = 8e3;
 var WAITED_TENANT_CONTROL_TIMEOUT_MS = 13e3;
+var TENANT_DEPLOY_TIMEOUT_MS = 12e4;
 var RETRY_ATTEMPTS = 3;
 function retriedFetch(deps, url, init) {
   const headers = { ...clientVersionHeaders(), ...init.headers };
@@ -9617,7 +9666,7 @@ async function tenantControl(payload, deps) {
   return postJson("/tenant-control", payload, deps, "POST", { noRetry, timeoutMs });
 }
 async function tenantDeploy(payload, deps) {
-  return postJson("/tenant-deploy", payload, deps, "POST", { noRetry: true });
+  return postJson("/tenant-deploy", payload, deps, "POST", { noRetry: true, timeoutMs: TENANT_DEPLOY_TIMEOUT_MS });
 }
 
 // src/tenant-verify-secrets.ts
@@ -10514,7 +10563,7 @@ async function planPush(deps, slug, opts = {}) {
   queue.push({ project: project2, slug, hash: hashContent(normalizeEol(raw)), attempts: 0, queuedAt: deps.now(), ...opts.force ? { force: true } : {} });
   deps.writeQueueRaw(serializeQueue(queue));
   deps.detachSync();
-  deps.log(`queued ${slug} for background push (\`mmi-cli northstar status\` to check, --wait to push synchronously)`);
+  deps.log(`queued ${slug} for background push \u2014 expected, not a failure (\`mmi-cli northstar status\` to check; \`mmi-cli northstar sync\` or --wait for durable confirmation)`);
   return true;
 }
 async function planPushNow(deps, slug, opts = {}) {

package/dist/saga.cjs

@@ -3681,6 +3681,20 @@ var FLUSH_LOCK_STALE_MS = 5 * 6e4;
 function pendingPath(dir = ".mmi") {
   return (0, import_node_path4.join)(dir, PENDING_FILE);
 }
+var PENDING_TMP_STALE_MS = 6e4;
+function sweepStaleTmp(dir = ".mmi", now = Date.now()) {
+  try {
+    for (const name of (0, import_node_fs4.readdirSync)(dir)) {
+      if (!name.startsWith(`${PENDING_FILE}.`) || !name.endsWith(".tmp")) continue;
+      const path2 = (0, import_node_path4.join)(dir, name);
+      try {
+        if (now - (0, import_node_fs4.statSync)(path2).mtimeMs > PENDING_TMP_STALE_MS) (0, import_node_fs4.unlinkSync)(path2);
+      } catch {
+      }
+    }
+  } catch {
+  }
+}
 function flushLockPath(dir = ".mmi") {
   return (0, import_node_path4.join)(dir, FLUSH_LOCK_FILE);
 }
@@ -3724,15 +3738,20 @@ function readPending(dir = ".mmi") {
   return out;
 }
 function writePending(entries, dir = ".mmi") {
+  const tmp = `${pendingPath(dir)}.${process.pid}.tmp`;
   try {
     (0, import_node_fs4.mkdirSync)(dir, { recursive: true });
+    sweepStaleTmp(dir);
     const trimmed = entries.slice(-PENDING_MAX);
     const body = trimmed.map((e) => JSON.stringify(e)).join("\n");
-    const tmp = `${pendingPath(dir)}.${process.pid}.tmp`;
     (0, import_node_fs4.writeFileSync)(tmp, trimmed.length ? `${body}
 ` : "", "utf8");
     (0, import_node_fs4.renameSync)(tmp, pendingPath(dir));
   } catch {
+    try {
+      (0, import_node_fs4.unlinkSync)(tmp);
+    } catch {
+    }
   }
 }
 function enqueuePending(body, dir = ".mmi") {
@@ -3745,6 +3764,7 @@ function enqueuePending(body, dir = ".mmi") {
       return;
     }
     (0, import_node_fs4.mkdirSync)(dir, { recursive: true });
+    sweepStaleTmp(dir);
     (0, import_node_fs4.appendFileSync)(pendingPath(dir), `${JSON.stringify({ id, body })}
 `, "utf8");
   } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "2.23.0",
+  "version": "2.24.0",
   "description": "MMI Future CLI — delivers the org rules (whole-file), plus saga and KB access. The cross-IDE engine the plugin's SessionStart hook drives.",
   "type": "module",
   "license": "UNLICENSED",