@mutmutco/cli 3.19.2 → 3.20.0

package/dist/main.cjs

@@ -3602,6 +3602,10 @@ async function failGraceful(msg) {
 var ERROR_CODES = {
   /** A required flag was not supplied (e.g. `issue create` without `--priority`). */
   ERR_MISSING_FLAG: "ERR_MISSING_FLAG",
+  /** Two mutually-exclusive flags were both supplied (e.g. `--title` with `--title-file`). */
+  ERR_CONFLICTING_FLAGS: "ERR_CONFLICTING_FLAGS",
+  /** A flag was supplied but its resolved value is empty (e.g. an empty `--title-file` or empty stdin). */
+  ERR_EMPTY_INPUT: "ERR_EMPTY_INPUT",
   /** A flag's value is outside its allowed set (e.g. `--priority nope`). */
   ERR_BAD_ENUM: "ERR_BAD_ENUM",
   /** An unknown flag or subcommand — usually a typo; carries a `did_you_mean`. */
@@ -3619,6 +3623,16 @@ var ERROR_CODE_REFERENCE = [
     meaning: "A required flag was not supplied.",
     typical_fix: "Run `mmi-cli explain <command>` and retry with the required flag."
   },
+  {
+    code: ERROR_CODES.ERR_CONFLICTING_FLAGS,
+    meaning: "Two mutually-exclusive flags were supplied together.",
+    typical_fix: "Pass only one of the conflicting flags (see `offending_flag`) and retry."
+  },
+  {
+    code: ERROR_CODES.ERR_EMPTY_INPUT,
+    meaning: "A flag was supplied but resolved to an empty value (e.g. an empty file or empty stdin).",
+    typical_fix: "Provide non-empty content for the flag in `offending_flag` (a file with text, or a real pipe/heredoc for stdin)."
+  },
   {
     code: ERROR_CODES.ERR_BAD_ENUM,
     meaning: "A flag value is outside the allowed enum.",
@@ -3680,6 +3694,7 @@ function didYouMean(input, candidates) {
   for (const candidate of candidates) {
     const cand = strip(candidate);
     if (!cand) continue;
+    if (cand === target) continue;
     const distance = levenshtein(target, cand);
     const prefix = cand.startsWith(target) || target.startsWith(cand);
     const threshold = Math.max(2, Math.ceil(cand.length * 0.4));
@@ -10135,6 +10150,16 @@ function buildPrArgs({ title, body, base, head, repo, draft }) {
 
 // src/issue-body.ts
 var import_node_os4 = require("node:os");
+var TextArgError = class extends Error {
+  constructor(message, code, offendingFlag) {
+    super(message);
+    this.code = code;
+    this.offendingFlag = offendingFlag;
+    this.name = "TextArgError";
+  }
+  code;
+  offendingFlag;
+};
 function emptyStdinMessage(fileFlag) {
   if ((0, import_node_os4.platform)() === "win32") {
     return `${fileFlag} - read empty stdin (on Windows, ${fileFlag} - is unreliable through the npm .cmd shim \u2014 use ${fileFlag} <path>, or pipe to \`node cli/dist/index.cjs\` directly)`;
@@ -10145,17 +10170,20 @@ 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}`);
+    throw new TextArgError(`pass only one of ${labels.value} or ${labels.file}`, ERROR_CODES.ERR_CONFLICTING_FLAGS, labels.value);
   }
   if (!hasValue && !hasFile) {
-    throw new Error(`pass ${labels.value} or ${labels.file}`);
+    throw new TextArgError(`pass ${labels.value} or ${labels.file}`, ERROR_CODES.ERR_MISSING_FLAG, labels.value);
   }
   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(
-      source === "-" ? emptyStdinMessage(labels.file) : `${labels.file} produced an empty ${labels.noun}`
+    throw new TextArgError(
+      source === "-" ? emptyStdinMessage(labels.file) : `${labels.file} produced an empty ${labels.noun}`,
+      // The flag WAS supplied — it just resolved empty — so this is ERR_EMPTY_INPUT, not ERR_MISSING_FLAG.
+      ERROR_CODES.ERR_EMPTY_INPUT,
+      labels.file
     );
   }
   return text;
@@ -21036,7 +21064,7 @@ withExamples(mutating(
     });
     if (o.parent !== void 0) parseIssueRef(o.parent);
   } catch (e) {
-    return fail(`issue create: ${e.message}`);
+    return fail(`issue create: ${e.message}`, e instanceof TextArgError ? { code: e.code, offending_flag: e.offendingFlag } : void 0);
   }
   for (const label of extraLabels) {
     const la = ["label", "create", label, "--color", "ededed"];
@@ -21311,14 +21339,14 @@ program2.command("skill-lesson").description("file a skill-lesson on the Hub boa
   console.log(JSON.stringify({ ...created, deduped: false, label: SKILL_LESSON_LABEL, skill, priority, projectItemId, onBoard }));
 });
 var pr = program2.command("pr").description("pull requests \u2014 reliable create with structured output");
-withExamples(pr.command("create").description("create a PR and print {number,url} JSON").option("--title <title>", "PR title").option("--title-file <path|->", "read the PR title from a UTF-8 file, or from stdin with -").option("--body <body>", "PR body (markdown)").option("--body-file <path|->", "read PR body from a UTF-8 file, or from stdin with -").option("--base <branch>", "base branch (defaults to the repo default)").option("--head <branch>", "head branch (defaults to the current branch)").option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--draft", "open the PR in draft state (#2667)").action(async (o) => {
+withExamples(pr.command("create").description("create a PR and print {number,url} JSON").option("--title <title>", "PR title").option("--title-file <path|->", "read the PR title from a UTF-8 file, or from stdin with -").option("--body <body>", "PR body (markdown)").option("--body-file <path|->", "read PR body from a UTF-8 file, or from stdin with -").option("--base <branch>", "base branch (defaults to the repo default)").option("--head <branch>", "head branch (defaults to the current branch)").option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--draft", "open the PR in draft state (#2667)").option("--json", "machine-readable output (default; accepted for parity)").action(async (o) => {
   let body;
   let title;
   try {
     title = await resolveIssueTitle({ title: o.title, titleFile: o.titleFile }, { readFile: import_promises5.readFile, readStdin });
     body = await resolveIssueBody({ body: o.body, bodyFile: o.bodyFile }, { readFile: import_promises5.readFile, readStdin });
   } catch (e) {
-    return fail(`pr create: ${e.message}`);
+    return fail(`pr create: ${e.message}`, e instanceof TextArgError ? { code: e.code, offending_flag: e.offendingFlag } : void 0);
   }
   const created = await ghCreate(buildPrArgs({ title, body, base: o.base, head: o.head, repo: o.repo, draft: o.draft }));
   console.log(JSON.stringify(created));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "3.19.2",
+  "version": "3.20.0",
   "description": "MMI Future CLI — the org dev toolbox (board, registry, keyless secrets, release train, bootstrap, doctor) and the cross-IDE engine the plugin's session-start hook drives.",
   "type": "module",
   "license": "UNLICENSED",