@mutmutco/cli 2.32.4 → 2.34.0

package/dist/saga.cjs

@@ -3900,6 +3900,309 @@ function formatCaptureFailure(status, message) {
   return `saga: HTTP ${status}`;
 }
 
+// src/saga-snapshot.ts
+var GS_OPEN = "gs-open:";
+var GS_RESOLVED = "gs-resolved:";
+var GS_CEILING = "gs-ceiling:";
+var BS_DONE = "bs-done:";
+var BS_PROGRESS = "bs-progress:";
+var BS_BLOCKED = "bs-blocked:";
+var BS_TIER = "bs-tier:";
+var BS_CEILING = "bs-ceiling:";
+var BS_HALT = "bs-halt:";
+var GRIND_PREFIX = /^grind\s+/i;
+var META_ACTION_SEP = " | ";
+var LEGACY_BLOCKER_OPEN = /^blocker:(.+)$/i;
+var LEGACY_BLOCKER_RESOLVED = /^resolved:(.+)$/i;
+var LEGACY_CEILING = /^ceiling:(.+)$/i;
+var LEGACY_BUILD_DONE = /^done:(.+)$/i;
+var LEGACY_BUILD_PROGRESS = /^progress:(.+)$/i;
+var LEGACY_BUILD_BLOCKED = /^blocked:([^|]+)\|([^|]+)(?:\|(.+))?$/i;
+var LEGACY_BUILD_TIER = /^tier:([^|]+)\|([^|]+)(?:\|(.+))?$/i;
+var LEGACY_BUILD_CEILING = /^ceiling:([^|]+)\|(.+)$/i;
+var LEGACY_BUILD_HALT = /^halt:(.+)$/i;
+function isGrindSnapshotItem(text) {
+  return text.startsWith(GS_OPEN) || text.startsWith(GS_RESOLVED) || text.startsWith(GS_CEILING) || LEGACY_BLOCKER_OPEN.test(text) || LEGACY_BLOCKER_RESOLVED.test(text) || LEGACY_CEILING.test(text);
+}
+function isBuildSnapshotItem(text) {
+  return text.startsWith(BS_DONE) || text.startsWith(BS_PROGRESS) || text.startsWith(BS_BLOCKED) || text.startsWith(BS_TIER) || text.startsWith(BS_CEILING) || text.startsWith(BS_HALT) || LEGACY_BUILD_DONE.test(text) || LEGACY_BUILD_PROGRESS.test(text) || LEGACY_BUILD_BLOCKED.test(text) || LEGACY_BUILD_TIER.test(text) || LEGACY_BUILD_CEILING.test(text) || LEGACY_BUILD_HALT.test(text);
+}
+function snapshotClearIndices(kind, head) {
+  const pred = kind === "grind" ? isGrindSnapshotItem : isBuildSnapshotItem;
+  return (head.queued ?? []).map((item, index) => ({ item, index })).filter(({ item }) => !item.done && pred(item.text)).map(({ index }) => index);
+}
+function parseGrindNext(next) {
+  if (!next?.trim()) return {};
+  const raw = next.replace(GRIND_PREFIX, "").trim();
+  const pipe = raw.indexOf(META_ACTION_SEP);
+  const meta = pipe >= 0 ? raw.slice(0, pipe).trim() : raw;
+  const nextAction = pipe >= 0 ? raw.slice(pipe + META_ACTION_SEP.length).trim() : void 0;
+  const out = { nextAction };
+  for (const part of meta.split(/\s+/)) {
+    const eq = part.indexOf("=");
+    if (eq < 0) continue;
+    const k = part.slice(0, eq);
+    const v = part.slice(eq + 1);
+    if (k === "class") out.class = v;
+    else if (k === "routing") out.routing = v;
+    else if (k === "ultra") out.ultra = v;
+    else if (k === "phase") out.phase = v;
+    else if (k === "verify") {
+      const [r, c] = v.split("/");
+      const rn = Number(r);
+      const cn = Number(c);
+      if (Number.isFinite(rn)) out.verifyRound = rn;
+      if (Number.isFinite(cn)) out.verifyCap = cn;
+    } else if (k === "resolved" && v) {
+      out.resolvedBlockerIds = v.split(",").map((s) => s.trim()).filter(Boolean);
+    }
+  }
+  return out;
+}
+function formatGrindNext(s) {
+  const parts = ["grind"];
+  if (s.class) parts.push(`class=${s.class}`);
+  if (s.routing) parts.push(`routing=${s.routing}`);
+  if (s.ultra) parts.push(`ultra=${s.ultra}`);
+  if (s.phase) parts.push(`phase=${s.phase}`);
+  if (Number.isFinite(s.verifyRound) && Number.isFinite(s.verifyCap)) parts.push(`verify=${s.verifyRound}/${s.verifyCap}`);
+  if (s.resolvedBlockerIds.length) parts.push(`resolved=${s.resolvedBlockerIds.join(",")}`);
+  const meta = parts.join(" ");
+  return s.nextAction ? `${meta}${META_ACTION_SEP}${s.nextAction}` : meta;
+}
+function parseGrindQueueItem(item, open, resolved, ceiling) {
+  if (item.text.startsWith(GS_OPEN) && !item.done) open.push(item.text.slice(GS_OPEN.length).trim());
+  else if (item.text.startsWith(GS_RESOLVED) && !item.done) resolved.push(item.text.slice(GS_RESOLVED.length).trim());
+  else if (item.text.startsWith(GS_CEILING) && !item.done) ceiling.value = item.text.slice(GS_CEILING.length).trim();
+  else {
+    const legacyOpen = item.text.match(LEGACY_BLOCKER_OPEN);
+    if (legacyOpen && !item.done) open.push(legacyOpen[1].trim());
+    const legacyResolved = item.text.match(LEGACY_BLOCKER_RESOLVED);
+    if (legacyResolved && item.done) resolved.push(legacyResolved[1].trim());
+    const legacyCeil = item.text.match(LEGACY_CEILING);
+    if (legacyCeil && !item.done) ceiling.value = legacyCeil[1].trim();
+  }
+}
+function parseGrindSnapshot(head) {
+  const fromNext = parseGrindNext(head.next);
+  const openBlockerIds = [];
+  const resolvedFromQueue = [];
+  const ceiling = { value: void 0 };
+  for (const item of head.queued ?? []) {
+    parseGrindQueueItem(item, openBlockerIds, resolvedFromQueue, ceiling);
+  }
+  const resolvedBlockerIds = [.../* @__PURE__ */ new Set([...resolvedFromQueue, ...fromNext.resolvedBlockerIds ?? []])];
+  const { resolvedBlockerIds: _drop, ...restNext } = fromNext;
+  return {
+    kind: "grind",
+    criteria: head.anchor?.intent,
+    openBlockerIds,
+    resolvedBlockerIds,
+    verificationCeiling: ceiling.value,
+    ...restNext
+  };
+}
+function parseBuildSnapshot(head) {
+  const doneLastTurn = [];
+  const inProgress = [];
+  const blocked = [];
+  const tierLedger = [];
+  const verificationCeiling = [];
+  let haltReason;
+  for (const item of head.queued ?? []) {
+    if (item.text.startsWith(BS_DONE) && !item.done) {
+      doneLastTurn.push(item.text.slice(BS_DONE.length).trim());
+      continue;
+    }
+    if (item.text.startsWith(BS_PROGRESS) && !item.done) {
+      inProgress.push(item.text.slice(BS_PROGRESS.length).trim());
+      continue;
+    }
+    if (item.text.startsWith(BS_BLOCKED) && !item.done) {
+      const body = item.text.slice(BS_BLOCKED.length);
+      const [site, decision, issue] = body.split("|");
+      blocked.push({ site: site?.trim() ?? "", decision: decision?.trim() ?? "", issue: issue?.trim() });
+      continue;
+    }
+    if (item.text.startsWith(BS_TIER) && !item.done) {
+      const body = item.text.slice(BS_TIER.length);
+      const [site, tier2, signals] = body.split("|");
+      tierLedger.push({ site: site?.trim() ?? "", tier: tier2?.trim() ?? "", signals: signals?.trim() });
+      continue;
+    }
+    if (item.text.startsWith(BS_CEILING) && !item.done) {
+      const body = item.text.slice(BS_CEILING.length);
+      const [site, rung] = body.split("|");
+      verificationCeiling.push({ site: site?.trim() ?? "", rung: rung?.trim() ?? "" });
+      continue;
+    }
+    if (item.text.startsWith(BS_HALT) && !item.done) {
+      haltReason = item.text.slice(BS_HALT.length).trim();
+      continue;
+    }
+    if (item.done) {
+      const d = item.text.match(LEGACY_BUILD_DONE);
+      if (d) doneLastTurn.push(d[1].trim());
+      continue;
+    }
+    const prog = item.text.match(LEGACY_BUILD_PROGRESS);
+    if (prog) {
+      inProgress.push(prog[1].trim());
+      continue;
+    }
+    const blk = item.text.match(LEGACY_BUILD_BLOCKED);
+    if (blk) {
+      blocked.push({ site: blk[1].trim(), decision: blk[2].trim(), issue: blk[3]?.trim() });
+      continue;
+    }
+    const tier = item.text.match(LEGACY_BUILD_TIER);
+    if (tier) {
+      tierLedger.push({ site: tier[1].trim(), tier: tier[2].trim(), signals: tier[3]?.trim() });
+      continue;
+    }
+    const ceil = item.text.match(LEGACY_BUILD_CEILING);
+    if (ceil) {
+      verificationCeiling.push({ site: ceil[1].trim(), rung: ceil[2].trim() });
+      continue;
+    }
+    const halt = item.text.match(LEGACY_BUILD_HALT);
+    if (halt) haltReason = halt[1].trim();
+  }
+  const nextFrontier = [];
+  if (head.next?.trim()) {
+    for (const line of head.next.split(";").map((s) => s.trim()).filter(Boolean)) {
+      nextFrontier.push(line);
+    }
+  }
+  return {
+    kind: "build",
+    milestone: head.anchor?.intent,
+    northStarSlug: head.anchor?.slug,
+    doneLastTurn,
+    inProgress,
+    blocked,
+    nextFrontier,
+    tierLedger,
+    verificationCeiling,
+    haltReason
+  };
+}
+function parseSnapshot(kind, head) {
+  return kind === "grind" ? parseGrindSnapshot(head) : parseBuildSnapshot(head);
+}
+function strOrU(v) {
+  return typeof v === "string" && v.length ? v : void 0;
+}
+function numOrU(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : void 0;
+}
+function asStringArray(v) {
+  return Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
+}
+function normalizeSnapshot(kind, raw) {
+  if (!raw || typeof raw !== "object") throw new Error("snapshot JSON must be an object");
+  const o = raw;
+  if (o.kind !== kind) throw new Error(`snapshot kind ${JSON.stringify(o.kind)} does not match --kind ${kind}`);
+  if (kind === "grind") {
+    return {
+      kind: "grind",
+      class: strOrU(o.class),
+      routing: strOrU(o.routing),
+      ultra: strOrU(o.ultra),
+      criteria: strOrU(o.criteria),
+      phase: strOrU(o.phase),
+      verifyRound: numOrU(o.verifyRound),
+      verifyCap: numOrU(o.verifyCap),
+      openBlockerIds: asStringArray(o.openBlockerIds),
+      resolvedBlockerIds: asStringArray(o.resolvedBlockerIds),
+      verificationCeiling: strOrU(o.verificationCeiling),
+      nextAction: strOrU(o.nextAction)
+    };
+  }
+  const blocked = Array.isArray(o.blocked) ? o.blocked.filter((b) => !!b && typeof b === "object").map((b) => ({ site: strOrU(b.site) ?? "", decision: strOrU(b.decision) ?? "", issue: strOrU(b.issue) })) : [];
+  const tierLedger = Array.isArray(o.tierLedger) ? o.tierLedger.filter((t) => !!t && typeof t === "object").map((t) => ({ site: strOrU(t.site) ?? "", tier: strOrU(t.tier) ?? "", signals: strOrU(t.signals) })) : [];
+  const verificationCeiling = Array.isArray(o.verificationCeiling) ? o.verificationCeiling.filter((v) => !!v && typeof v === "object").map((v) => ({ site: strOrU(v.site) ?? "", rung: strOrU(v.rung) ?? "" })) : [];
+  return {
+    kind: "build",
+    milestone: strOrU(o.milestone),
+    northStarSlug: strOrU(o.northStarSlug),
+    doneLastTurn: asStringArray(o.doneLastTurn),
+    inProgress: asStringArray(o.inProgress),
+    blocked,
+    nextFrontier: asStringArray(o.nextFrontier),
+    tierLedger,
+    verificationCeiling,
+    haltReason: strOrU(o.haltReason)
+  };
+}
+function planGrindSnapshotWrite(s, summary = "grind snapshot refresh") {
+  const queueOps = [];
+  for (const id of s.openBlockerIds) queueOps.push({ text: `${GS_OPEN}${id}` });
+  for (const id of s.resolvedBlockerIds) queueOps.push({ text: `${GS_RESOLVED}${id}` });
+  if (s.verificationCeiling) queueOps.push({ text: `${GS_CEILING}${s.verificationCeiling}` });
+  return {
+    summary,
+    next: formatGrindNext(s),
+    anchor: s.criteria,
+    queueOps,
+    clearIndices: []
+  };
+}
+function planBuildSnapshotWrite(s, summary = "build snapshot refresh") {
+  const queueOps = [];
+  for (const site of s.doneLastTurn) queueOps.push({ text: `${BS_DONE}${site}` });
+  for (const site of s.inProgress) queueOps.push({ text: `${BS_PROGRESS}${site}` });
+  for (const b of s.blocked) {
+    queueOps.push({ text: `${BS_BLOCKED}${b.site}|${b.decision}${b.issue ? `|${b.issue}` : ""}` });
+  }
+  for (const t of s.tierLedger) {
+    queueOps.push({ text: `${BS_TIER}${t.site}|${t.tier}${t.signals ? `|${t.signals}` : ""}` });
+  }
+  for (const v of s.verificationCeiling) queueOps.push({ text: `${BS_CEILING}${v.site}|${v.rung}` });
+  if (s.haltReason) queueOps.push({ text: `${BS_HALT}${s.haltReason}` });
+  return {
+    summary,
+    next: s.nextFrontier.length ? s.nextFrontier.join("; ") : void 0,
+    anchor: s.milestone,
+    anchorSlug: s.northStarSlug,
+    queueOps,
+    clearIndices: []
+  };
+}
+function planSnapshotWrite(snapshot, head, summary) {
+  const plan = snapshot.kind === "grind" ? planGrindSnapshotWrite(snapshot, summary) : planBuildSnapshotWrite(snapshot, summary);
+  plan.clearIndices = snapshotClearIndices(snapshot.kind, head);
+  return plan;
+}
+function formatSnapshotHuman(snapshot) {
+  if (snapshot.kind === "grind") {
+    const lines2 = [
+      `kind: grind`,
+      snapshot.class ? `class: ${snapshot.class}` : "",
+      snapshot.routing ? `routing: ${snapshot.routing}` : "",
+      snapshot.ultra ? `ultra: ${snapshot.ultra}` : "",
+      snapshot.criteria ? `criteria: ${snapshot.criteria}` : "",
+      snapshot.phase ? `phase: ${snapshot.phase}` : "",
+      snapshot.verifyRound != null ? `verify: ${snapshot.verifyRound}/${snapshot.verifyCap ?? "?"}` : "",
+      snapshot.openBlockerIds.length ? `open blockers: ${snapshot.openBlockerIds.join(", ")}` : "open blockers: (none)",
+      snapshot.resolvedBlockerIds.length ? `resolved: ${snapshot.resolvedBlockerIds.join(", ")}` : "",
+      snapshot.verificationCeiling ? `ceiling: ${snapshot.verificationCeiling}` : "",
+      snapshot.nextAction ? `next: ${snapshot.nextAction}` : ""
+    ].filter(Boolean);
+    return lines2.join("\n");
+  }
+  const lines = [
+    `kind: build`,
+    snapshot.milestone ? `milestone: ${snapshot.milestone}` : "",
+    snapshot.northStarSlug ? `north star: ${snapshot.northStarSlug}` : "",
+    snapshot.doneLastTurn.length ? `done: ${snapshot.doneLastTurn.join(", ")}` : "",
+    snapshot.inProgress.length ? `in progress: ${snapshot.inProgress.join(", ")}` : "",
+    snapshot.nextFrontier.length ? `next frontier: ${snapshot.nextFrontier.join("; ")}` : "",
+    snapshot.haltReason ? `halt: ${snapshot.haltReason}` : ""
+  ].filter(Boolean);
+  return lines.join("\n");
+}
+
 // src/hub-auth.ts
 var import_node_crypto = require("node:crypto");
 var import_node_fs5 = require("node:fs");
@@ -4321,6 +4624,60 @@ async function runSagaHealth(o, io = consoleIo) {
   if (report.warnings.length) io.log(report.warnings.map((w) => ` - ${w}`).join("\n"));
   if (report.pendingNotes > 0) io.log(` - ${report.pendingNotes} note(s) queued locally \u2014 \`mmi-cli saga flush\` to roll forward`);
 }
+async function fetchSagaHead(io = consoleIo) {
+  const cfg = await loadConfig();
+  if (!cfg.sagaApiUrl) {
+    io.err("saga snapshot: Hub API URL not configured");
+    return null;
+  }
+  try {
+    const key = await sagaKey(cfg);
+    const qs = new URLSearchParams(key).toString();
+    const res = await fetch(`${cfg.sagaApiUrl}/saga/state?${qs}`, { headers: await hubHeaders(), signal: AbortSignal.timeout(8e3) });
+    if (!res.ok) {
+      io.err(`saga snapshot: HTTP ${res.status}`);
+      return null;
+    }
+    const state = await res.json();
+    return state.head ?? {};
+  } catch (e) {
+    io.err(`saga snapshot: ${e.message}`);
+    return null;
+  }
+}
+async function postSnapshotNotes(plan, anchorForce) {
+  const [sha, key] = await Promise.all([gitOut(["rev-parse", "--short", "HEAD"]), sagaKey(await loadConfig())]);
+  const evidence = { sha: sha || void 0, branch: key.branch };
+  for (const idx of [...plan.clearIndices].sort((a, b) => b - a)) {
+    const cap = buildNoteCapture("snapshot retire", { queueDone: String(idx) }, (0, import_node_crypto3.randomUUID)(), evidence);
+    await postCapture(cap);
+  }
+  const primary = buildNoteCapture(plan.summary, {
+    next: plan.next,
+    anchor: plan.anchor,
+    anchorSlug: plan.anchorSlug,
+    anchorForce
+  }, (0, import_node_crypto3.randomUUID)(), evidence);
+  await postCapture(primary);
+  for (const op of plan.queueOps) {
+    const cap = buildNoteCapture("snapshot checklist", { queueAdd: op.text }, (0, import_node_crypto3.randomUUID)(), evidence);
+    await postCapture(cap);
+  }
+}
+async function runSagaSnapshotShow(opts, io = consoleIo) {
+  const head = await fetchSagaHead(io);
+  if (!head) return;
+  const snapshot = parseSnapshot(opts.kind, head);
+  if (opts.json) return io.log(JSON.stringify(snapshot, null, 2));
+  io.log(formatSnapshotHuman(snapshot));
+}
+async function runSagaSnapshotSet(snapshot, opts = {}, io = consoleIo) {
+  const head = await fetchSagaHead(io) ?? { queued: [] };
+  const plan = planSnapshotWrite(snapshot, head);
+  await postSnapshotNotes(plan, opts.anchorForce);
+  if (opts.json) return io.log(JSON.stringify({ ok: true, snapshot, retired: plan.clearIndices.length, queued: plan.queueOps.length + 1 }));
+  io.log(`saga snapshot: wrote ${snapshot.kind} snapshot (retired ${plan.clearIndices.length}, ${plan.queueOps.length + 1} capture(s))`);
+}
 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-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) => {
@@ -4386,6 +4743,69 @@ function registerSagaCommands(program2) {
     console.log(`project=${key.project} branch=${key.branch} session=${key.sessionId} source=${source}`);
   });
   saga.command("health").option("--json", "machine-readable output").option("--banner", "one-line SessionStart banner; silent when healthy").option("--quiet", "suppress detail output").description("zero-write health check: auth, backend reachability, resolved key").action((o) => runSagaHealth(o));
+  const snapshot = saga.command("snapshot").description("structured grind/build resume snapshot over saga HEAD");
+  snapshot.command("show").description("read the structured resume snapshot from current saga HEAD").requiredOption("--kind <kind>", "grind | build").option("--json", "output JSON").action(async (o) => {
+    const kind = o.kind;
+    if (kind !== "grind" && kind !== "build") return fail("saga snapshot show: --kind must be grind or build");
+    await runSagaSnapshotShow({ kind, json: o.json });
+  });
+  snapshot.command("set").description("write a structured resume snapshot (maps to saga note HEAD primitives)").requiredOption("--kind <kind>", "grind | build").option("--json-file <path>", "full snapshot JSON (overrides field flags)").option("--anchor-force", "overwrite an existing anchor").option("--json", "output result JSON").option("--class <c>", "grind class").option("--routing <r>", "grind routing tier").option("--ultra <u>", "ultra mode").option("--criteria <text>", "grind criteria / frame").option("--phase <p>", "phase reached").option("--verify-round <n>", "verify round", (v) => parseInt(v, 10)).option("--verify-cap <n>", "verify cap", (v) => parseInt(v, 10)).option("--open-blocker <id>", "open blocker id (repeatable)", (v, prev) => [...prev, v], []).option("--resolved-blocker <id>", "resolved blocker id (repeatable)", (v, prev) => [...prev, v], []).option("--verification-ceiling <text>", "verification ceiling").option("--next-action <text>", "next action").option("--milestone <text>", "build milestone one-liner").option("--north-star-slug <slug>", "North Star slug").option("--done <site>", "done last turn site (repeatable)", (v, prev) => [...prev, v], []).option("--in-progress <site>", "in-progress site (repeatable)", (v, prev) => [...prev, v], []).option("--blocked <spec>", "site|decision|issue (repeatable)", (v, prev) => [...prev, v], []).option("--next-frontier <item>", "frontier item (repeatable)", (v, prev) => [...prev, v], []).option("--tier <spec>", "site|tier|signals (repeatable)", (v, prev) => [...prev, v], []).option("--site-ceiling <spec>", "site|rung (repeatable)", (v, prev) => [...prev, v], []).option("--halt-reason <text>", "halt reason").action(async (o) => {
+    const kind = o.kind;
+    if (kind !== "grind" && kind !== "build") return fail("saga snapshot set: --kind must be grind or build");
+    let snap;
+    if (o.jsonFile) {
+      const raw = await (0, import_promises2.readFile)(o.jsonFile, "utf8");
+      let parsed;
+      try {
+        parsed = JSON.parse(raw);
+      } catch (e) {
+        return fail(`saga snapshot set: invalid JSON in ${o.jsonFile}: ${e.message}`);
+      }
+      try {
+        snap = normalizeSnapshot(kind, parsed);
+      } catch (e) {
+        return fail(`saga snapshot set: ${e.message}`);
+      }
+    } else if (kind === "grind") {
+      snap = {
+        kind: "grind",
+        class: o.class,
+        routing: o.routing,
+        ultra: o.ultra,
+        criteria: o.criteria,
+        phase: o.phase,
+        verifyRound: o.verifyRound,
+        verifyCap: o.verifyCap,
+        openBlockerIds: o.openBlocker ?? [],
+        resolvedBlockerIds: o.resolvedBlocker ?? [],
+        verificationCeiling: o.verificationCeiling,
+        nextAction: o.nextAction
+      };
+    } else {
+      snap = {
+        kind: "build",
+        milestone: o.milestone,
+        northStarSlug: o.northStarSlug,
+        doneLastTurn: o.done ?? [],
+        inProgress: o.inProgress ?? [],
+        blocked: (o.blocked ?? []).map((spec) => {
+          const [site, decision, issue] = spec.split("|");
+          return { site: site ?? "", decision: decision ?? "", issue };
+        }),
+        nextFrontier: o.nextFrontier ?? [],
+        tierLedger: (o.tier ?? []).map((spec) => {
+          const [site, tier, signals] = spec.split("|");
+          return { site: site ?? "", tier: tier ?? "", signals };
+        }),
+        verificationCeiling: (o.siteCeiling ?? []).map((spec) => {
+          const [site, rung] = spec.split("|");
+          return { site: site ?? "", rung: rung ?? "" };
+        }),
+        haltReason: o.haltReason
+      };
+    }
+    await runSagaSnapshotSet(snap, { anchorForce: o.anchorForce, json: o.json });
+  });
 }
 
 // src/saga-boot.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "2.32.4",
+  "version": "2.34.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",