@mutmutco/cli 3.91.0 → 3.93.0

package/dist/main.cjs

@@ -4304,6 +4304,24 @@ async function surfaceLabelApplies(repo, deps = {}) {
   return (known?.length ?? 0) > 0;
 }
 
+// src/parse-error-hints.ts
+var TARGET_SELECTOR_FLAGS = /* @__PURE__ */ new Set(["--repo", "--ref", "--target", "--project", "--issue"]);
+function targetFlagValueFromArgv(flag, argv) {
+  const i = argv.indexOf(flag);
+  if (i < 0) return void 0;
+  const next = argv[i + 1];
+  if (!next || next.startsWith("-")) return void 0;
+  return next;
+}
+function formatPositionalTarget(commandPath3, argName, opts = {}) {
+  const concrete = opts.flag && opts.argv ? targetFlagValueFromArgv(opts.flag, opts.argv) : void 0;
+  if (concrete) return `mmi-cli ${commandPath3} ${concrete}`;
+  return `mmi-cli ${commandPath3} <${argName}>`;
+}
+function unknownTargetFlagMessage(flag, positional) {
+  return `unknown option '${flag}' \u2014 this command takes its target as a positional: ${positional}`;
+}
+
 // src/session-start.ts
 var import_node_fs8 = require("node:fs");
 var import_node_path6 = require("node:path");
@@ -25636,7 +25654,7 @@ async function checkDocsIndexAtHead(opts, deps) {
   if (!await deps.refResolves(root, ref)) return void 0;
   const paths = await deps.listDocsAtRef(root, ref);
   if (!paths.includes(DOCS_INDEX_PATH)) return void 0;
-  const relDocs = paths.filter((p) => p.startsWith("docs/")).map((p) => p.slice("docs/".length)).filter(isRoutableDocsPath);
+  const relDocs = paths.filter((p) => p.startsWith("docs/") && p.endsWith(".md")).map((p) => p.slice("docs/".length)).filter(isRoutableDocsPath);
   const [indexContent, docContents] = await Promise.all([
     deps.readAtRef(root, ref, DOCS_INDEX_PATH),
     Promise.all(relDocs.map((rel) => deps.readAtRef(root, ref, `docs/${rel}`)))
@@ -30000,13 +30018,12 @@ function commandOwnLongFlags(cmd) {
   }
   return [...flags];
 }
-var TARGET_SELECTOR_FLAGS = /* @__PURE__ */ new Set(["--repo", "--ref", "--target", "--project"]);
-function positionalTargetForm(cmd) {
+function positionalTargetForm(cmd, opts = {}) {
   if (!cmd) return void 0;
   const args = cmd.registeredArguments ?? [];
   const first = args[0];
   if (!first) return void 0;
-  return `mmi-cli ${commandPath2(cmd)} <${first.name()}>`;
+  return formatPositionalTarget(commandPath2(cmd), first.name(), opts);
 }
 function resolveParseHint() {
   if (lastParseErrorKind === "unknown-command") {
@@ -30051,12 +30068,13 @@ function envelopeAwareWriteErr(str) {
   const match = /unknown option '([^']+)'/.exec(plain);
   if (match) {
     const flag = match[1];
+    const argv = process.argv.slice(2);
+    const invoked = resolveCommandFromArgv(program2, argv);
+    const positional = TARGET_SELECTOR_FLAGS.has(flag) ? positionalTargetForm(invoked, { flag, argv }) : void 0;
     if (argvWantsJson2()) {
-      const invoked = resolveCommandFromArgv(program2, process.argv.slice(2));
-      const suggestion = didYouMean(flag, commandOwnLongFlags(invoked));
-      const corrected = suggestion ? `mmi-cli ${process.argv.slice(2).map((a) => a === flag ? suggestion : a).join(" ")}` : void 0;
-      const positional = !suggestion && TARGET_SELECTOR_FLAGS.has(flag) ? positionalTargetForm(invoked) : void 0;
-      const message = positional ? `unknown option '${flag}' \u2014 this command takes its target as a positional: ${positional}` : `unknown option '${flag}'`;
+      const suggestion = positional ? void 0 : didYouMean(flag, commandOwnLongFlags(invoked));
+      const corrected = suggestion ? `mmi-cli ${argv.map((a) => a === flag ? suggestion : a).join(" ")}` : void 0;
+      const message = positional ? unknownTargetFlagMessage(flag, positional) : `unknown option '${flag}'`;
       process.stderr.write(
         formatErrorEnvelope(message, {
           code: ERROR_CODES.ERR_UNKNOWN_FLAG,
@@ -30068,6 +30086,10 @@ function envelopeAwareWriteErr(str) {
       unknownFlagJsonHandled = true;
       return;
     }
+    if (positional) {
+      process.stderr.write(str.replace(/unknown option '[^']+'/, unknownTargetFlagMessage(flag, positional)));
+      return;
+    }
     process.stderr.write(str);
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "3.91.0",
+  "version": "3.93.0",
   "description": "MMI Future CLI — the org dev toolbox and shared cross-IDE engine for every registry-declared MMI coding surface.",
   "type": "module",
   "license": "UNLICENSED",