@mutmutco/cli 2.28.0 → 2.30.0

package/dist/saga.cjs

@@ -3430,6 +3430,26 @@ function clientVersionHeaders() {
 
 // src/saga-commands.ts
 var import_node_crypto3 = require("node:crypto");
+var import_promises2 = require("node:fs/promises");
+
+// src/issue-body.ts
+async function resolveTextArg(input, deps, labels) {
+  const hasValue = input.value !== void 0;
+  const hasFile = input.file !== void 0;
+  if (hasValue && hasFile) {
+    throw new Error(`pass only one of ${labels.value} or ${labels.file}`);
+  }
+  if (!hasValue && !hasFile) {
+    throw new Error(`pass ${labels.value} or ${labels.file}`);
+  }
+  if (hasValue) return input.value ?? "";
+  const source = input.file ?? "";
+  const text = source === "-" ? await deps.readStdin() : await deps.readFile(source, "utf8");
+  if (text.trim().length === 0) {
+    throw new Error(`${labels.file} produced an empty ${labels.noun}`);
+  }
+  return text;
+}
 
 // src/saga-capture.ts
 function parseHookInput(stdin) {
@@ -3566,6 +3586,7 @@ async function runHeadEngine(prompt, timeoutMs = HEAD_ENGINE_TIMEOUT_MS) {
 
 // src/saga-health.ts
 var MEMORY_STALE_DAYS = 14;
+var SESSION_START_LIVENESS = { attempts: 1, timeoutMs: 3e3 };
 function buildHealth(i) {
   const problems = [];
   if (!i.sagaApiUrl) problems.push("Hub API URL not configured");
@@ -3591,6 +3612,7 @@ function buildHealth(i) {
     authorized: i.authorized,
     sagaApiUrl: i.sagaApiUrl,
     pendingNotes: i.pendingNotes ?? 0,
+    honchoPending: i.honchoPending ?? 0,
     key: i.key,
     source: i.source,
     problems,
@@ -3607,73 +3629,14 @@ function healthBanner(report) {
   if (report.warnings.length) return `saga health: NOTE - ${report.warnings.join("; ")}`;
   return null;
 }
-function resumeCue() {
-  return '> STATUS/RESUME CUE \u2014 For any status, resume, or "where do I stand" report: read THIS saga HEAD first (`mmi-cli saga show`), then reconcile its NEXT / LAST 5 / DECISIONS against the live board + git/gh before reporting. Do not rebuild the picture from board/issues/memory while skipping the HEAD. PRECEDENCE: the HEAD is prior-session belief and MAY BE SUPERSEDED \u2014 the current live user/master instruction WINS over any conflicting HEAD anchor, NEXT, or checklist; follow the live instruction and treat the stale HEAD item as superseded.';
-}
-
-// src/fetch-retry.ts
-async function fetchWithRetry(fetchImpl, url, init, opts = {}) {
-  const attempts = opts.attempts ?? 3;
-  const baseDelayMs = opts.baseDelayMs ?? 250;
-  const retryOn = opts.retryOn ?? ((res) => res.status >= 500);
-  const sleep = opts.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
-  let lastErr;
-  for (let i = 0; i < attempts; i++) {
-    const isLast = i === attempts - 1;
-    const attemptInit = opts.timeoutMs ? { ...init, signal: AbortSignal.timeout(opts.timeoutMs) } : init;
-    try {
-      const res = await fetchImpl(url, attemptInit);
-      if (!isLast && retryOn(res)) {
-        await sleep(baseDelayMs * 2 ** i);
-        continue;
-      }
-      return res;
-    } catch (e) {
-      lastErr = e;
-      if (isLast) throw e;
-      await sleep(baseDelayMs * 2 ** i);
-    }
-  }
-  throw lastErr;
-}
-
-// src/saga-note.ts
-var AGENT_SURFACE_TOKENS = ["claude", "codex", "cursor", "gemini"];
-var ROUTE_LEVEL_403 = "saga API route-level 403 from HubSessionAuthorizer/session policy";
-function agentSurface(env = process.env) {
-  const surface = env.MMI_AGENT_SURFACE?.trim() || (env.CODEX_THREAD_ID?.trim() && !env.CLAUDE_SESSION_ID?.trim() ? "codex" : "claude");
-  if (AGENT_SURFACE_TOKENS.includes(surface)) return surface;
-  throw new Error(`MMI_AGENT_SURFACE must be one of: ${AGENT_SURFACE_TOKENS.join(", ")}`);
-}
-function buildNoteCapture(summary, o, id, evidence) {
-  const queueOp = o.queueAdd ? { op: "add", text: o.queueAdd } : o.queueDone != null ? { op: "done", index: Number(o.queueDone) } : void 0;
-  const state = o.diagnostic ? "diagnostic" : o.verified ? "verified" : "asserted";
-  const source = o.diagnostic ? "probe" : "note";
-  const ev = {};
-  if (evidence.sha) ev.sha = evidence.sha;
-  if (evidence.branch) ev.branch = evidence.branch;
-  if (evidence.pr) ev.pr = evidence.pr;
-  if (evidence.file) ev.file = evidence.file;
-  const anchor = o.anchor ? { intent: o.anchor, setAt: (/* @__PURE__ */ new Date()).toISOString() } : void 0;
-  return {
-    event: "note",
-    id,
-    summary,
-    next: o.next,
-    decision: o.decision,
-    queueOp,
-    state,
-    source,
-    evidence: Object.keys(ev).length ? ev : void 0,
-    surface: agentSurface(),
-    supersedes: o.supersedes,
-    anchor,
-    anchorForce: o.anchorForce || void 0
-  };
-}
-function formatCaptureFailure(status, message) {
-  if (status === 403 && message === "Forbidden") return `saga: ${ROUTE_LEVEL_403} (HTTP 403)`;
-  return `saga: HTTP ${status}`;
+function memorySyncBanner(report) {
+  const saga = report.pendingNotes;
+  const honcho = report.honchoPending;
+  if (saga <= 0 && honcho <= 0) return null;
+  const parts = [];
+  if (saga > 0) parts.push(`${saga} saga`);
+  if (honcho > 0) parts.push(`${honcho} honcho`);
+  return `MEMORY SYNC \u2014 ${parts.join(" + ")} write(s) queued locally \u2014 run \`mmi-cli saga flush\` / \`honcho flush\` (this device only).`;
 }
 
 // src/saga-pending.ts
@@ -3852,6 +3815,81 @@ async function flushPending(post, dir = ".mmi") {
   return { flushed, dropped, remaining: readPending(dir).length };
 }
 
+// src/honcho-pending.ts
+var HONCHO_QUEUE_DIR = ".mmi/honcho";
+function readHonchoPending(dir = HONCHO_QUEUE_DIR) {
+  return readPending(dir);
+}
+
+// src/fetch-retry.ts
+async function fetchWithRetry(fetchImpl, url, init, opts = {}) {
+  const attempts = opts.attempts ?? 3;
+  const baseDelayMs = opts.baseDelayMs ?? 250;
+  const retryOn = opts.retryOn ?? ((res) => res.status >= 500);
+  const sleep = opts.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  let lastErr;
+  for (let i = 0; i < attempts; i++) {
+    const isLast = i === attempts - 1;
+    const attemptInit = opts.timeoutMs ? { ...init, signal: AbortSignal.timeout(opts.timeoutMs) } : init;
+    try {
+      const res = await fetchImpl(url, attemptInit);
+      if (!isLast && retryOn(res)) {
+        await sleep(baseDelayMs * 2 ** i);
+        continue;
+      }
+      return res;
+    } catch (e) {
+      lastErr = e;
+      if (isLast) throw e;
+      await sleep(baseDelayMs * 2 ** i);
+    }
+  }
+  throw lastErr;
+}
+
+// src/saga-note.ts
+var AGENT_SURFACE_TOKENS = ["claude", "codex", "cursor", "gemini"];
+var ROUTE_LEVEL_403 = "saga API route-level 403 from HubSessionAuthorizer/session policy";
+function agentSurface(env = process.env) {
+  const surface = env.MMI_AGENT_SURFACE?.trim() || (env.CODEX_THREAD_ID?.trim() && !env.CLAUDE_SESSION_ID?.trim() ? "codex" : "claude");
+  if (AGENT_SURFACE_TOKENS.includes(surface)) return surface;
+  throw new Error(`MMI_AGENT_SURFACE must be one of: ${AGENT_SURFACE_TOKENS.join(", ")}`);
+}
+function buildNoteCapture(summary, o, id, evidence) {
+  const queueOp = o.queueAdd ? { op: "add", text: o.queueAdd } : o.queueDone != null ? { op: "done", index: Number(o.queueDone) } : void 0;
+  const state = o.diagnostic ? "diagnostic" : o.verified ? "verified" : "asserted";
+  const source = o.diagnostic ? "probe" : "note";
+  const ev = {};
+  if (evidence.sha) ev.sha = evidence.sha;
+  if (evidence.branch) ev.branch = evidence.branch;
+  if (evidence.pr) ev.pr = evidence.pr;
+  if (evidence.file) ev.file = evidence.file;
+  const anchor = o.anchor ? {
+    intent: o.anchor,
+    ...o.anchorSlug ? { slug: o.anchorSlug } : {},
+    setAt: (/* @__PURE__ */ new Date()).toISOString()
+  } : void 0;
+  return {
+    event: "note",
+    id,
+    summary,
+    next: o.next,
+    decision: o.decision,
+    queueOp,
+    state,
+    source,
+    evidence: Object.keys(ev).length ? ev : void 0,
+    surface: agentSurface(),
+    supersedes: o.supersedes,
+    anchor,
+    anchorForce: o.anchorForce || void 0
+  };
+}
+function formatCaptureFailure(status, message) {
+  if (status === 403 && message === "Forbidden") return `saga: ${ROUTE_LEVEL_403} (HTTP 403)`;
+  return `saga: HTTP ${status}`;
+}
+
 // src/hub-auth.ts
 var import_node_crypto = require("node:crypto");
 var import_node_fs5 = require("node:fs");
@@ -4147,6 +4185,13 @@ async function runNote(summary, o) {
   const capture = buildNoteCapture(summary, o, (0, import_node_crypto3.randomUUID)(), { sha: sha || void 0, branch: key.branch });
   await postCapture(capture);
 }
+function resolveSummary(summary, o) {
+  return resolveTextArg({ value: summary, file: o.messageFile }, { readFile: import_promises2.readFile, readStdin }, {
+    value: "a summary argument",
+    file: "--message-file",
+    noun: "message"
+  });
+}
 async function runSagaFlush(o, io = consoleIo) {
   if (o.run) {
     try {
@@ -4181,7 +4226,6 @@ async function runSagaShow(opts, io = consoleIo) {
     const qs = opts.latestAnywhere ? "scope=anywhere" : new URLSearchParams({ project: key.project, branch: key.branch }).toString();
     const res = await fetchWithRetry(fetch, `${cfg.sagaApiUrl}/saga/head?${qs}`, { headers: await hubHeaders() }, { attempts: 2, timeoutMs: 3e3 });
     if (res.ok) {
-      io.log(resumeCue());
       return io.log(await res.text());
     }
     if (!opts.quiet) io.log(`saga show failed: HTTP ${res.status}`);
@@ -4192,9 +4236,9 @@ async function runSagaShow(opts, io = consoleIo) {
     }
   }
 }
-async function probeBackend(url) {
+async function probeBackend(url, opts = { attempts: 3, timeoutMs: 4e3 }) {
   try {
-    const res = await fetchWithRetry(fetch, `${url}/saga/head`, { headers: await hubHeaders() }, { attempts: 3, timeoutMs: 4e3 });
+    const res = await fetchWithRetry(fetch, `${url}/saga/head`, { headers: await hubHeaders() }, opts);
     let message = "";
     try {
       const body = await res.clone().json();
@@ -4233,12 +4277,13 @@ async function runSagaHealth(o, io = consoleIo) {
   const session = resolveSessionId();
   const key = await sagaKey(cfg, session);
   const source = session.source;
+  const livenessOpts = o.banner ? SESSION_START_LIVENESS : { attempts: 3, timeoutMs: 4e3 };
   const [identity, liveness] = await Promise.all([
     hubAuthSession({ baseUrl: cfg.sagaApiUrl ?? defaultHubUrl(), githubToken }).then((s) => s?.login),
-    cfg.sagaApiUrl ? probeBackend(cfg.sagaApiUrl) : Promise.resolve({ reachable: false })
+    cfg.sagaApiUrl ? probeBackend(cfg.sagaApiUrl, livenessOpts) : Promise.resolve({ reachable: false })
   ]);
-  const authorized = cfg.sagaApiUrl && liveness.reachable ? await probeSagaAccess(cfg.sagaApiUrl, key) : void 0;
-  const memoryAgeDays = cfg.sagaApiUrl && liveness.reachable ? await fetchMemoryAge(cfg.sagaApiUrl, key.project) : void 0;
+  const authorized = o.banner ? void 0 : cfg.sagaApiUrl && liveness.reachable ? await probeSagaAccess(cfg.sagaApiUrl, key) : void 0;
+  const memoryAgeDays = o.banner ? void 0 : cfg.sagaApiUrl && liveness.reachable ? await fetchMemoryAge(cfg.sagaApiUrl, key.project) : void 0;
   const report = buildHealth({
     key,
     source,
@@ -4249,12 +4294,15 @@ async function runSagaHealth(o, io = consoleIo) {
     authorized,
     sagaApiUrl: cfg.sagaApiUrl,
     pendingNotes: readPending().length,
+    honchoPending: readHonchoPending().length,
     memoryAgeDays
   });
   if (o.json) return io.log(JSON.stringify(report));
   if (o.banner) {
     const banner = healthBanner(report);
     if (banner) io.log(banner);
+    const sync = memorySyncBanner(report);
+    if (sync) io.log(sync);
     return;
   }
   if (o.quiet) return;
@@ -4265,8 +4313,24 @@ async function runSagaHealth(o, io = consoleIo) {
 }
 function registerSagaCommands(program2) {
   const saga = program2.command("saga").description("per-session continuity");
-  saga.command("note <summary>").description("record a one-line structured note into your saga (the per-turn capture)").option("--next <text>", 'set "where I left off" (NEXT)').option("--decision <text>", "append a verbatim decision").option("--queue-add <text>", "add a worklist item").option("--queue-done <n>", "mark worklist item N done").option("--verified", "mark this claim as checked against source (state: verified, else asserted)").option("--diagnostic", "isolate a probe write (state: diagnostic, source: probe) \u2014 never resume/LAST 5").option("--supersedes <key>", "retire prior decisions matching an evidence key (pr:N | file:path)").option("--anchor <intent>", "set the sprint North-Star (write-protected; needs --anchor-force to change)").option("--anchor-force", "overwrite an existing anchor").action((summary, o) => runNote(summary, o));
-  saga.command("probe <summary>").description("record a diagnostic probe note (alias for `saga note --diagnostic`)").option("--next <text>", 'set "where I left off" (NEXT)').option("--decision <text>", "append a verbatim decision").option("--queue-add <text>", "add a worklist item").option("--queue-done <n>", "mark worklist item N done").action((summary, o) => runNote(summary, { ...o, diagnostic: true }));
+  saga.command("note [summary]").description("record a one-line structured note into your saga (the per-turn capture)").option("--next <text>", 'set "where I left off" (NEXT)').option("--decision <text>", "append a verbatim decision").option("--queue-add <text>", "add a worklist item").option("--queue-done <n>", "mark worklist item N done").option("--verified", "mark this claim as checked against source (state: verified, else asserted)").option("--diagnostic", "isolate a probe write (state: diagnostic, source: probe) \u2014 never resume/LAST 5").option("--supersedes <key>", "retire prior decisions matching an evidence key (pr:N | file:path)").option("--anchor <intent>", "set the sprint North-Star (write-protected; needs --anchor-force to change)").option("--anchor-slug <slug>", "bind the anchor to a North Star plan slug (SSOT at plans/.../<slug>.md)").option("--anchor-force", "overwrite an existing anchor").option("--message-file <path|->", "read the summary from a UTF-8 file, or from stdin with - (avoids cmd.exe quoting)").action(async (summary, o) => {
+    let text;
+    try {
+      text = await resolveSummary(summary, o);
+    } catch (e) {
+      return fail(`saga note: ${e.message}`);
+    }
+    await runNote(text, o);
+  });
+  saga.command("probe [summary]").description("record a diagnostic probe note (alias for `saga note --diagnostic`)").option("--next <text>", 'set "where I left off" (NEXT)').option("--decision <text>", "append a verbatim decision").option("--queue-add <text>", "add a worklist item").option("--queue-done <n>", "mark worklist item N done").option("--message-file <path|->", "read the summary from a UTF-8 file, or from stdin with - (avoids cmd.exe quoting)").action(async (summary, o) => {
+    let text;
+    try {
+      text = await resolveSummary(summary, o);
+    } catch (e) {
+      return fail(`saga probe: ${e.message}`);
+    }
+    await runNote(text, { ...o, diagnostic: true });
+  });
   saga.command("flush").option("--json", "machine-readable {flushed, dropped, remaining}").option("--run", "detached worker: drain the queue silently (spawned by note/capture)").description("roll the local pending-note queue forward (re-POST queued saga writes); reports what landed").action((o) => runSagaFlush(o));
   saga.command("show").option("--quiet", "no-op silently when unconfigured/unreachable (SessionStart hook)").option("--latest-anywhere", "resume the newest saga across all repos (default: current repo)").description("print your resume block \u2014 current repo HEAD + project memory (where you left off)").action((opts) => runSagaShow(opts));
   saga.command("capture").option("--quiet", "capture silently (for the Stop hook)").description("per-turn deterministic capture (Stop hook): turn boundary + current sha + gated HEAD-update").action(async (opts) => {
@@ -4380,8 +4444,16 @@ function socketPath(env = process.env, platform = process.platform, user) {
   return platform === "win32" ? `\\\\.\\pipe\\mmi-cli-${hash}` : (0, import_node_path6.join)(daemonDir(env), `mmi-cli-${hash}.sock`);
 }
 var HOT_VERBS = /* @__PURE__ */ new Set(["note", "probe", "capture", "session", "head-update"]);
+function argvReadsStdin(args) {
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a.endsWith("-file=-")) return true;
+    if (a.endsWith("-file") && args[i + 1] === "-") return true;
+  }
+  return false;
+}
 function daemonEligible(args) {
-  return args[0] === "saga" && HOT_VERBS.has(args[1] ?? "") && !args.includes("--run") && !args.includes("--help") && !args.includes("-h");
+  return args[0] === "saga" && HOT_VERBS.has(args[1] ?? "") && !args.includes("--run") && !args.includes("--help") && !args.includes("-h") && !argvReadsStdin(args);
 }
 function buildStamp(version, bundleMtimeMs) {
   return `${version}#${Math.trunc(bundleMtimeMs)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "2.28.0",
+  "version": "2.30.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",
@@ -39,7 +39,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "esbuild": "^0.28.0",
+    "esbuild": "^0.28.1",
     "typescript": "^5.7.0",
     "vitest": "^4.1.0"
   }