@mutmutco/cli 2.32.3 → 2.33.0

package/dist/main.cjs

@@ -3423,7 +3423,7 @@ function resolveRulesBase(orgRulesSource, defaultBase) {
 }
 
 // src/index.ts
-var import_node_child_process9 = require("node:child_process");
+var import_node_child_process10 = require("node:child_process");
 
 // src/cli-shared.ts
 var import_promises = require("node:fs/promises");
@@ -7229,7 +7229,7 @@ ${buildReportBody(body, sourceRepo)}`;
 
 // src/skill-lesson.ts
 var SKILL_LESSON_LABEL = "skill-lesson";
-var SKILL_NAMES = ["bootstrap", "browser-automation", "grind", "hotfix", "mmi", "rcand", "release", "secrets", "stage"];
+var SKILL_NAMES = ["bootstrap", "browser-automation", "build", "grind", "hotfix", "mmi", "rcand", "release", "secrets", "stage"];
 function assertSkillName(name) {
   const match = SKILL_NAMES.find((skill) => skill === name);
   if (!match) throw new Error(`unknown skill "${name}" \u2014 expected one of: ${SKILL_NAMES.join(", ")}`);
@@ -7355,127 +7355,92 @@ function buildPanelPlan(input) {
   };
 }
 
-// src/grind-policy.ts
-var DEFAULT_SEARCH_DENY_DOMAINS = [
-  "stackoverflow.com",
-  "stackexchange.com",
-  "github.com/issues",
-  "reddit.com"
-];
-
-// src/verify-fusion.ts
-var DEFAULT_MODELS = {
-  builder: "builder-slot",
-  verifier: "verifier-slot",
-  third: "third-slot",
-  synthesizer: "verifier-slot"
+// src/build-policy.ts
+var TIER_BUDGETS = {
+  light: {
+    tier: "light",
+    agents: 2,
+    planners: 0,
+    parallelSitesCap: 1,
+    verificationDepth: "panel-once",
+    reasoningEffort: "standard"
+  },
+  standard: {
+    tier: "standard",
+    agents: 3,
+    planners: 0,
+    parallelSitesCap: 2,
+    verificationDepth: "full-panel",
+    reasoningEffort: "standard-high"
+  },
+  deep: {
+    tier: "deep",
+    agents: 4,
+    planners: 2,
+    parallelSitesCap: 3,
+    verificationDepth: "full-double-pass",
+    reasoningEffort: "high"
+  },
+  max: {
+    tier: "max",
+    agents: 5,
+    planners: 3,
+    parallelSitesCap: 4,
+    verificationDepth: "integration-checkpoints",
+    reasoningEffort: "max"
+  }
 };
-function resolveFusionProviderUrl(explicit) {
-  if (explicit) return explicit;
-  const env = process.env.MMI_FUSION_PROVIDER_URL?.trim();
-  return env || null;
-}
-function buildFusionPlan(input) {
-  const routing = input.routing;
-  const lenses = input.lenses ?? [...GRIND_LENSES];
-  const provider = resolveFusionProviderUrl(input.providerUrl ?? void 0);
-  const models = {
-    ...DEFAULT_MODELS,
-    ...input.models,
-    synthesizer: input.models?.synthesizer ?? input.models?.third ?? input.models?.verifier ?? DEFAULT_MODELS.synthesizer
-  };
-  if (models.verifier === models.builder) {
-    throw new Error("fusion plan: verifier must not equal builder");
+function getTierBudgets(tier) {
+  return TIER_BUDGETS[tier];
+}
+function isWideOrArchitectural(scope) {
+  return scope === "wide" || scope === "architectural";
+}
+function isCrossModuleOrProduct(blast) {
+  return blast === "cross-module" || blast === "product";
+}
+function pickEffortTier(signals) {
+  if (signals.explicitTier) {
+    return {
+      tier: signals.explicitTier,
+      reason: `explicit user override \u2192 ${signals.explicitTier}`,
+      budgets: getTierBudgets(signals.explicitTier)
+    };
   }
-  if (models.synthesizer === models.builder) {
-    throw new Error("fusion plan: synthesizer must not equal builder");
+  if (signals.risk === "critical") {
+    return { tier: "max", reason: "critical risk", budgets: getTierBudgets("max") };
   }
-  const toolPolicy = {
-    webSearch: Boolean(input.toolPolicy?.webSearch),
-    maxQueriesPerLens: input.toolPolicy?.maxQueriesPerLens ?? 3,
-    denyDomains: input.toolPolicy?.denyDomains ?? []
-  };
-  return {
-    provider,
-    routing,
-    lenses,
-    models,
-    toolPolicy,
-    criteria: input.criteria,
-    diff: input.diff,
-    fallback: "host-panel",
-    instructions: "Hosted fusion when provider is configured; else spawn host lenses and pipe JSON to `mmi-cli verify synthesize`. Synthesizer slot must differ from builder."
-  };
-}
-function adaptFusionResponse(raw) {
-  if (raw.lenses) {
-    const lenses = parseLensResults(raw.lenses);
-    const base2 = synthesizePanelReport(lenses);
+  if (signals.foundational && (isWideOrArchitectural(signals.scope) || signals.blastRadius === "product")) {
     return {
-      ...base2,
-      consensus: raw.consensus?.length ? raw.consensus : base2.consensus,
-      contradictions: raw.contradictions ?? base2.contradictions,
-      partial_coverage: raw.partial_coverage ?? base2.partial_coverage,
-      unique_insights: raw.unique_insights ?? base2.unique_insights,
-      blind_spots: raw.blind_spots ?? base2.blind_spots,
-      nits: raw.nits ?? base2.nits
+      tier: "max",
+      reason: "foundational seam with wide/architectural scope or product blast radius",
+      budgets: getTierBudgets("max")
     };
   }
-  const blockers = (raw.blockers ?? []).map((b, i) => ({
-    id: `fusion-${i}`,
-    title: b.title,
-    file: b.file,
-    line: b.line,
-    why: b.why,
-    sources: b.sources ?? ["hosted-fusion"]
-  }));
-  return {
-    consensus: raw.consensus ?? [],
-    contradictions: raw.contradictions ?? [],
-    partial_coverage: raw.partial_coverage ?? [],
-    unique_insights: raw.unique_insights ?? [],
-    blind_spots: raw.blind_spots ?? [],
-    blockers,
-    nits: raw.nits ?? []
-  };
-}
-async function runFusionProvider(plan2, deps = {}) {
-  const url = resolveFusionProviderUrl(deps.providerUrl ?? plan2.provider ?? void 0);
-  if (!url) {
-    return { ok: false, source: "fallback", error: "no fusion provider configured" };
+  if (signals.risk === "high") {
+    return { tier: "deep", reason: "high risk", budgets: getTierBudgets("deep") };
   }
-  const fetchImpl = deps.fetch ?? fetch;
-  const apiKey = deps.apiKey ?? process.env.MMI_FUSION_API_KEY?.trim();
-  const headers = { "content-type": "application/json" };
-  if (apiKey) headers.authorization = `Bearer ${apiKey}`;
-  try {
-    const res = await fetchImpl(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({
-        routing: plan2.routing,
-        lenses: plan2.lenses,
-        models: plan2.models,
-        toolPolicy: plan2.toolPolicy,
-        criteria: plan2.criteria,
-        diff: plan2.diff
-      }),
-      signal: AbortSignal.timeout(3e4)
-    });
-    if (!res.ok) {
-      return { ok: false, source: "fallback", error: `provider HTTP ${res.status}` };
-    }
-    const body = await res.json();
-    return { ok: true, source: "hosted-fusion", report: adaptFusionResponse(body) };
-  } catch (e) {
-    return { ok: false, source: "fallback", error: e.message };
+  if (signals.ambiguity === "high") {
+    return { tier: "deep", reason: "high ambiguity", budgets: getTierBudgets("deep") };
   }
-}
-function parseFusionLenses(raw) {
-  return raw.split(",").map((s) => assertGrindLens(s.trim()));
-}
-function parseFusionRouting(raw) {
-  return assertVerifyRouting(raw);
+  if (signals.scope === "architectural") {
+    return { tier: "deep", reason: "architectural scope", budgets: getTierBudgets("deep") };
+  }
+  if (isCrossModuleOrProduct(signals.blastRadius)) {
+    return {
+      tier: "deep",
+      reason: `${signals.blastRadius} blast radius`,
+      budgets: getTierBudgets("deep")
+    };
+  }
+  if (signals.scope === "trivial" && signals.ambiguity === "low" && signals.risk === "low") {
+    return {
+      tier: "light",
+      reason: "trivial scope with low risk and low ambiguity",
+      budgets: getTierBudgets("light")
+    };
+  }
+  return { tier: "standard", reason: "default \u2014 normal slice", budgets: getTierBudgets("standard") };
 }
 
 // src/gc.ts
@@ -8248,15 +8213,24 @@ function decideStage(inputs) {
 }
 
 // src/cursor-plugin-seed.ts
+var import_node_child_process7 = require("node:child_process");
 var import_node_fs11 = require("node:fs");
 var import_node_os4 = require("node:os");
 var import_node_path11 = require("node:path");
+var import_node_util6 = require("node:util");
 function isSemverVersion(v) {
   return typeof v === "string" && /^v?\d+\.\d+\.\d+/.test(v.trim());
 }
 var MMI_HUB_REPO = "mutmutco/MMI-Hub";
 var CURSOR_THIRD_PARTY_STATE_KEY = "cursor/thirdPartyExtensibilityEnabled";
 var PLUGIN_JSON_REL = ".cursor-plugin/plugin.json";
+var execFileBuffer = (0, import_node_util6.promisify)(import_node_child_process7.execFile);
+function gitFetchReleaseTagArgs(hubCheckout, tag) {
+  return ["-C", hubCheckout, "fetch", "origin", "tag", tag, "--quiet"];
+}
+function ghReleaseTarballApiArgs(tag) {
+  return ["api", `repos/${MMI_HUB_REPO}/tarball/refs/tags/${tag}`];
+}
 function cursorUserGlobalStatePath() {
   if (process.platform === "win32") {
     const base2 = process.env.APPDATA || (0, import_node_path11.join)((0, import_node_os4.homedir)(), "AppData", "Roaming");
@@ -8295,7 +8269,7 @@ function releaseTag(releasedVersion) {
 async function extractPluginMmiFromHubCheckout(hubCheckout, tag, tmpRoot, execFileP5) {
   const tarFile = (0, import_node_path11.join)(tmpRoot, "archive.tar");
   try {
-    await execFileP5("git", ["-C", hubCheckout, "fetch", "origin", `tag ${tag}`, "--quiet"], { timeout: 6e4 });
+    await execFileP5("git", gitFetchReleaseTagArgs(hubCheckout, tag), { timeout: 6e4 });
     await execFileP5("git", ["-C", hubCheckout, "archive", "--format=tar", `--output=${tarFile}`, tag, "plugins/mmi"], {
       timeout: 6e4
     });
@@ -8306,13 +8280,18 @@ async function extractPluginMmiFromHubCheckout(hubCheckout, tag, tmpRoot, execFi
     return void 0;
   }
 }
-async function downloadPluginMmiViaGh(tag, tmpRoot, execFileP5) {
+async function downloadPluginMmiViaGh(tag, tmpRoot) {
   const tarPath = (0, import_node_path11.join)(tmpRoot, "repo.tgz");
   try {
-    await execFileP5("gh", ["api", `repos/${MMI_HUB_REPO}/tarball/refs/tags/${tag}`, "--output", tarPath], {
-      timeout: 12e4
+    (0, import_node_fs11.mkdirSync)(tmpRoot, { recursive: true });
+    const { stdout } = await execFileBuffer("gh", ghReleaseTarballApiArgs(tag), {
+      timeout: 12e4,
+      maxBuffer: 100 * 1024 * 1024,
+      encoding: "buffer",
+      windowsHide: true
     });
-    await execFileP5("tar", ["-xzf", tarPath, "-C", tmpRoot], { timeout: 12e4 });
+    (0, import_node_fs11.writeFileSync)(tarPath, stdout);
+    await execFileBuffer("tar", ["-xzf", tarPath, "-C", tmpRoot], { timeout: 12e4, windowsHide: true });
     const top = (0, import_node_fs11.readdirSync)(tmpRoot).find((entry) => entry !== "repo.tgz");
     if (!top) return void 0;
     const pluginMmi = (0, import_node_path11.join)(tmpRoot, top, "plugins", "mmi");
@@ -8328,7 +8307,7 @@ async function resolvePluginMmiSource(releasedVersion, hubCheckout, tmpRoot, exe
     const fromHub = await extractPluginMmiFromHubCheckout(hubCheckout, tag, tmpRoot, execFileP5);
     if (fromHub) return fromHub;
   }
-  return downloadPluginMmiViaGh(tag, (0, import_node_path11.join)(tmpRoot, "gh"), execFileP5);
+  return downloadPluginMmiViaGh(tag, (0, import_node_path11.join)(tmpRoot, "gh"));
 }
 function cursorPluginPinsNeedingSeed(pins, releasedVersion) {
   if (!isSemverVersion(releasedVersion)) return pins.filter((pin) => !pin.hasPluginJson || !pin.hasHooksJson || pin.isEmpty);
@@ -9054,12 +9033,12 @@ async function runStageLiveDown(deps, t) {
 }
 
 // src/stage-runner.ts
-var import_node_child_process7 = require("node:child_process");
+var import_node_child_process8 = require("node:child_process");
 var import_node_fs12 = require("node:fs");
 var import_node_path12 = require("node:path");
 var import_node_net2 = require("node:net");
-var import_node_util6 = require("node:util");
-var execFileP4 = (0, import_node_util6.promisify)(import_node_child_process7.execFile);
+var import_node_util7 = require("node:util");
+var execFileP4 = (0, import_node_util7.promisify)(import_node_child_process8.execFile);
 var EARLY_EXIT_GRACE_MS = 2e3;
 function waitForProcessStability(child, graceMs = EARLY_EXIT_GRACE_MS) {
   return new Promise((resolve, reject) => {
@@ -9255,7 +9234,7 @@ async function startStage(config = {}, opts = {}) {
   const extraEnv = {};
   for (const [k, v] of Object.entries(config.env ?? {})) extraEnv[k] = sub(v) ?? v;
   const up = sub(config.up.trim());
-  const child = (0, import_node_child_process7.spawn)(up, {
+  const child = (0, import_node_child_process8.spawn)(up, {
     cwd,
     shell: true,
     // POSIX-only: the process group exists for the group-kill in stopStage. On win32 teardown is
@@ -10346,12 +10325,12 @@ async function runTenantRedeploy(deps, options) {
 }
 
 // src/hotfix-coverage.ts
-var import_node_child_process8 = require("node:child_process");
+var import_node_child_process9 = require("node:child_process");
 var CHERRY_TRAILER = /\(cherry picked from commit ([0-9a-f]{7,40})\)/g;
 function checkHotfixCoverage(options = {}) {
   const { cwd = process.cwd(), mainRef = "origin/main", rcRef = "origin/rc", manifestPaths = [] } = options;
   const ack = (options.ack ?? []).filter(Boolean);
-  const git = options.git ?? ((args, opts) => (0, import_node_child_process8.execFileSync)("git", args, { cwd, encoding: "utf8", input: opts?.input, stdio: ["pipe", "pipe", "pipe"] }));
+  const git = options.git ?? ((args, opts) => (0, import_node_child_process9.execFileSync)("git", args, { cwd, encoding: "utf8", input: opts?.input, stdio: ["pipe", "pipe", "pipe"] }));
   const revList = (range) => {
     const out = git(["rev-list", "--no-merges", range]).trim();
     return out ? out.split("\n") : [];
@@ -10690,9 +10669,8 @@ async function runHotfixRelease(deps, versionInput, options = {}) {
   if (releaseExists) {
     releaseNote = `Release ${tag} already exists \u2014 resumed without recreating`;
   } else {
-    const tagCommit = clean2(await deps.run("git", ["rev-parse", `${tag}^{commit}`]));
-    await deps.run("gh", ["release", "create", tag, "--repo", ctx.repo, "--target", tagCommit, "--generate-notes", "--latest"]);
-    releaseNote = `Release ${tag} created (target ${tagCommit.slice(0, 7)})`;
+    await deps.run("gh", ["release", "create", tag, "--repo", ctx.repo, "--target", "main", "--generate-notes", "--latest"]);
+    releaseNote = `Release ${tag} created (target main)`;
     if (deps.announce) {
       announceNote = (await deps.announce({ repo: ctx.repo, tag, summaryFile: options.announceSummaryFile })).note;
     }
@@ -11547,6 +11525,13 @@ async function verifyBootstrap(repo, repoClass, deps, releaseTrack) {
     ok: Boolean(config?.projectOwner && config?.projectNumber && config?.projectId && config?.statusFieldId && config?.statusOptions),
     label: "registry project board META exists"
   });
+  if (config?.projectId && config.projectNumber == null) {
+    checks.push({
+      ok: false,
+      label: "registry projectNumber present when projectId set",
+      detail: "projectNumber is missing \u2014 bootstrap apply must pass PROJECT_NUMBER or derive it from the live board GraphQL query"
+    });
+  }
   if (config?.projectOwner && config.projectNumber != null) {
     const fieldsQuery = `query($login: String!, $number: Int!) { organization(login: $login) { projectV2(number: $number) { fields(first: 50) { nodes { ... on ProjectV2FieldCommon { id name } ... on ProjectV2SingleSelectField { id name options { id name } } } } } } }`;
     const fields = await (async () => {
@@ -12173,6 +12158,25 @@ function boardRegistryGaps(meta) {
   if (meta.projectNumber != null) return [];
   return ["projectNumber"];
 }
+function previewRegistryMetaMerge(existing, patch) {
+  const out = { ...existing ?? {} };
+  for (const [key, value] of Object.entries(patch)) {
+    if (value === null) delete out[key];
+    else out[key] = value;
+  }
+  return out;
+}
+function boardLinkWriteError(patch, existing) {
+  const patchHasProjectId = typeof patch.projectId === "string" && patch.projectId.length > 0;
+  const patchHasProjectNumber = typeof patch.projectNumber === "number" && Number.isFinite(patch.projectNumber);
+  if (patchHasProjectId && !patchHasProjectNumber && existing?.projectNumber == null) {
+    return "projectId requires projectNumber in registry META \u2014 pass projectNumber with board coords";
+  }
+  if (patch.projectNumber === null && boardRegistryGaps(previewRegistryMetaMerge(existing, patch)).length) {
+    return "projectId requires projectNumber in registry META \u2014 pass projectNumber with board coords";
+  }
+  return null;
+}
 function boardRegistryGapMessage(repo) {
   return `Board META incomplete for ${repo}: registry has projectId but no projectNumber \u2014 board claim and auto-add will fail until projectNumber is backfilled (re-run \`node infra/migrate/seed-registry.mjs\` or \`mmi-cli bootstrap apply --execute\` with board vars)`;
 }
@@ -13866,7 +13870,7 @@ function scheduleRelatedDiscovery(o) {
   try {
     const args = ["issue", "discover-related", "--number", String(o.number), "--title", o.title, "--body", o.body];
     if (o.repo) args.push("--repo", o.repo);
-    (0, import_node_child_process9.spawn)(process.execPath, [process.argv[1], ...args], {
+    (0, import_node_child_process10.spawn)(process.execPath, [process.argv[1], ...args], {
       detached: true,
       stdio: "ignore",
       windowsHide: true,
@@ -13880,7 +13884,7 @@ function detachPlanSync() {
   if (planSyncDetached) return;
   planSyncDetached = true;
   try {
-    (0, import_node_child_process9.spawn)(process.execPath, [process.argv[1], "northstar", "sync", "--quiet"], {
+    (0, import_node_child_process10.spawn)(process.execPath, [process.argv[1], "northstar", "sync", "--quiet"], {
       detached: true,
       stdio: "ignore",
       windowsHide: true,
@@ -13959,7 +13963,7 @@ function openInEditor(path2) {
     return;
   }
   try {
-    (0, import_node_child_process9.spawn)(editor, [path2], { stdio: "inherit" });
+    (0, import_node_child_process10.spawn)(editor, [path2], { stdio: "inherit" });
   } catch {
     console.log(`open ${path2} manually`);
   }
@@ -14390,6 +14394,9 @@ project.command("set [owner/repo]").description("MASTER-ONLY: upsert a project M
   } catch (e) {
     return fail(e.message.replace(/^project set: /, "project set: "));
   }
+  const existing = await fetchProjectBySlug(slug, registryClientDeps(cfg));
+  const boardError = boardLinkWriteError(patch, existing);
+  if (boardError) return fail(`project set: ${boardError}`);
   const res = await upsertProject(slug, patch, registryClientDeps(cfg));
   return reportWrite("project set", res);
 });
@@ -14666,39 +14673,37 @@ verify.command("synthesize").description("merge lens JSON array into a PanelRepo
     return fail(`verify synthesize: ${e.message}`);
   }
 });
-var fusion = verify.command("fusion").description("optional hosted fusion provider for grind verify (#1377)");
-fusion.command("plan").description("plan a hosted fusion job \u2014 print FusionPlan JSON (falls back to host panel when provider unset)").requiredOption("--criteria-file <path>", "UTF-8 file with success criteria").requiredOption("--diff-file <path>", "UTF-8 file with git diff output").option("--routing <routing>", "Balanced | Budget | Paranoid", "Balanced").option("--lenses <list>", `comma-separated lens names (default: ${GRIND_LENSES.join(",")})`, GRIND_LENSES.join(",")).option("--provider-url <url>", "fusion provider base URL (else MMI_FUSION_PROVIDER_URL)").option("--web-search", "enable bounded web search in fusion tool policy").action(async (o) => {
-  try {
-    const routing = parseFusionRouting(o.routing);
-    const lenses = parseFusionLenses(o.lenses);
-    const criteria = await (0, import_promises5.readFile)(o.criteriaFile, "utf8");
-    const diff = await (0, import_promises5.readFile)(o.diffFile, "utf8");
-    const plan2 = buildFusionPlan({
-      routing,
-      lenses,
-      criteria,
-      diff,
-      providerUrl: o.providerUrl ?? null,
-      toolPolicy: {
-        webSearch: Boolean(o.webSearch),
-        maxQueriesPerLens: 3,
-        denyDomains: [...DEFAULT_SEARCH_DENY_DOMAINS]
-      }
-    });
-    console.log(JSON.stringify(plan2));
-  } catch (e) {
-    return fail(`verify fusion plan: ${e.message}`);
+var build = program2.command("build").description("Build skill helpers \u2014 effort-tier selection and milestone partitioning");
+build.command("tier").description("Recommend an effort tier (light|standard|deep|max) from scope/risk/ambiguity signals").option("--scope <s>", "trivial|narrow|normal|wide|architectural").option("--risk <r>", "low|medium|high|critical").option("--ambiguity <a>", "low|medium|high").option("--blast-radius <b>", "isolated|module|cross-module|product").option("--foundational", "touches shared seams").option("--explicit <t>", "force a tier: light|standard|deep|max").option("--json", "output JSON").action((opts) => {
+  const signals = {
+    scope: opts.scope,
+    risk: opts.risk,
+    ambiguity: opts.ambiguity,
+    blastRadius: opts.blastRadius,
+    foundational: opts.foundational ?? void 0,
+    explicitTier: opts.explicit
+  };
+  const decision = pickEffortTier(signals);
+  if (opts.json) console.log(JSON.stringify(decision, null, 2));
+  else {
+    console.log(`tier:      ${decision.tier}`);
+    console.log(`reason:    ${decision.reason}`);
+    console.log(`agents:    ${decision.budgets.agents}`);
+    console.log(`planners:  ${decision.budgets.planners}`);
+    console.log(`parallel:  ${decision.budgets.parallelSitesCap} sites`);
+    console.log(`verify:    ${decision.budgets.verificationDepth}`);
+    console.log(`reasoning: ${decision.budgets.reasoningEffort}`);
   }
 });
-fusion.command("run").description("execute hosted fusion from a FusionPlan JSON file; prints PanelReport or fallback envelope").requiredOption("--plan-file <path>", "UTF-8 FusionPlan JSON from verify fusion plan").option("--provider-url <url>", "override fusion provider URL (else plan.provider or MMI_FUSION_PROVIDER_URL)").action(async (o) => {
-  try {
-    const raw = await (0, import_promises5.readFile)(o.planFile, "utf8");
-    const plan2 = JSON.parse(raw);
-    const result = await runFusionProvider(plan2, { providerUrl: o.providerUrl ?? plan2.provider ?? null });
-    console.log(JSON.stringify(result));
-    if (!result.ok) process.exitCode = 1;
-  } catch (e) {
-    return fail(`verify fusion run: ${e.message}`);
+build.command("plan").description("Partition a set of issue refs into sites + waves (parallel/serialize/batch) for milestone construction").argument("[issues...]", "issue refs like owner/repo#N or #N").option("--json", "output JSON").action((issues, opts) => {
+  const plan2 = {
+    waves: issues.length > 0 ? [{ wave: 0, mode: "parallel", issues }] : [],
+    note: issues.length === 0 ? "No issues provided." : "v1 partitioning: single parallel wave. Use grind --auto Phase 00 patterns for deeper analysis."
+  };
+  if (opts.json) console.log(JSON.stringify(plan2, null, 2));
+  else {
+    console.log(plan2.note);
+    for (const w of plan2.waves) console.log(`wave ${w.wave} (${w.mode}): ${w.issues.join(" ")}`);
   }
 });
 program2.command("skill-lesson").description("file a skill-lesson on the Hub board (GitHub auth, dedups open lessons) and print {number,url} JSON").requiredOption("--skill <name>", `which skill misfired (${SKILL_NAMES.join(" | ")})`).option("--title <title>", "one-line summary of what misfired").option("--title-file <path|->", "read the one-line summary from a UTF-8 file, or from stdin with -").option("--body <body>", "lesson body: what misfired, the evidence, and the proposed amendment (markdown)").option("--body-file <path|->", "read the lesson body from a UTF-8 file, or from stdin with -").option("--priority <priority>", "urgent | high | medium | low (board Priority field when configured)", "medium").option("--repo <owner/repo>", `target repo (defaults to the org Hub: ${HUB_REPO})`).option("--force", "file a new issue even when an open lesson looks like a duplicate").option("--json", "machine-readable output (already the default \u2014 skill-lesson always prints JSON)").action(async (o) => {
@@ -16166,7 +16171,7 @@ program2.command("session-start").description("run the SessionStart verbs (rules
   } catch (e) {
     console.error(`[mmi-hook] saga session failed: ${e.message}`);
   }
-  spawnDetachedSelf(["docs", "sync", "--quiet"], { spawn: import_node_child_process9.spawn, execPath: process.execPath, scriptPath: process.argv[1] });
+  spawnDetachedSelf(["docs", "sync", "--quiet"], { spawn: import_node_child_process10.spawn, execPath: process.execPath, scriptPath: process.argv[1] });
   let northstarInjected = false;
   const { parallel, sequential } = buildSessionStartPlan({
     rulesSync: (io) => runRulesSync({ quiet: true }, io),

package/package.json

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