@unbrained/pm-cli 2026.5.10 → 2026.5.11

package/dist/cli/bootstrap-args.js

@@ -1,3 +1,5 @@
+import { resolveSubcommandFlagContractsForCommand } from "../sdk/cli-contracts.js";
+import { levenshteinDistanceWithinLimit } from "../core/shared/levenshtein.js";
 function parseBootstrapPathToken(token, next) {
     if (token === "--path") {
         if (typeof next === "string" && next.length > 0) {
@@ -220,6 +222,215 @@ export function normalizeLegacyExtensionActionSyntax(argv) {
     }
     return [...argv.slice(0, extensionIndex + 1), forcedActionFlag, ...argv.slice(extensionIndex + 2)];
 }
+function normalizeFlagKeyToken(raw) {
+    const withoutPrefix = raw.replace(/^--?/, "");
+    return withoutPrefix
+        .replace(/_/g, "-")
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .toLowerCase();
+}
+function toComparableFlagKey(raw) {
+    return normalizeFlagKeyToken(raw).replace(/-/g, "");
+}
+function markUnambiguousFlag(map, key, canonicalFlag) {
+    const existing = map.get(key);
+    if (existing === undefined) {
+        map.set(key, canonicalFlag);
+        return;
+    }
+    if (existing !== canonicalFlag) {
+        map.set(key, null);
+    }
+}
+function collectLongFlagCandidates(contract) {
+    const candidates = [];
+    const pushLongFlag = (value) => {
+        if (typeof value !== "string") {
+            return;
+        }
+        if (!value.startsWith("--")) {
+            return;
+        }
+        candidates.push(value);
+    };
+    pushLongFlag(contract.flag);
+    for (const alias of contract.aliases ?? []) {
+        pushLongFlag(alias);
+    }
+    return candidates;
+}
+function buildFlagLookup(commandName) {
+    const contracts = resolveSubcommandFlagContractsForCommand(commandName);
+    const canonicalByNormalized = new Map();
+    const canonicalByCompact = new Map();
+    const canonicalComparablesMap = new Map();
+    for (const contract of contracts) {
+        const longCandidates = collectLongFlagCandidates(contract);
+        if (longCandidates.length === 0) {
+            continue;
+        }
+        const canonicalFlag = `--${normalizeFlagKeyToken(longCandidates[0])}`;
+        for (const candidate of longCandidates) {
+            markUnambiguousFlag(canonicalByNormalized, normalizeFlagKeyToken(candidate), canonicalFlag);
+            markUnambiguousFlag(canonicalByCompact, toComparableFlagKey(candidate), canonicalFlag);
+        }
+        const comparable = toComparableFlagKey(canonicalFlag);
+        if (!canonicalComparablesMap.has(canonicalFlag)) {
+            canonicalComparablesMap.set(canonicalFlag, comparable);
+        }
+    }
+    return {
+        canonicalByNormalized,
+        canonicalByCompact,
+        canonicalComparables: [...canonicalComparablesMap.entries()].map(([canonicalFlag, comparable]) => ({
+            canonicalFlag,
+            comparable,
+        })),
+    };
+}
+function resolveCanonicalFlag(rawKey, lookup) {
+    const normalizedKey = normalizeFlagKeyToken(rawKey);
+    const direct = lookup.canonicalByNormalized.get(normalizedKey);
+    if (typeof direct === "string") {
+        return {
+            flag: direct,
+            reason: "flag_alias",
+            confidence: "high",
+        };
+    }
+    const comparableKey = normalizedKey.replace(/-/g, "");
+    const compactMatch = lookup.canonicalByCompact.get(comparableKey);
+    if (typeof compactMatch === "string") {
+        return {
+            flag: compactMatch,
+            reason: "flag_alias",
+            confidence: "high",
+        };
+    }
+    const maxDistance = comparableKey.length >= 8 ? 2 : 1;
+    let bestDistance = Number.POSITIVE_INFINITY;
+    let bestFlag;
+    let tied = false;
+    for (const candidate of lookup.canonicalComparables) {
+        const distance = levenshteinDistanceWithinLimit(comparableKey, candidate.comparable, maxDistance);
+        if (distance === null) {
+            continue;
+        }
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            bestFlag = candidate.canonicalFlag;
+            tied = false;
+            continue;
+        }
+        if (distance === bestDistance && bestFlag !== candidate.canonicalFlag) {
+            tied = true;
+        }
+    }
+    if (!bestFlag || tied || !Number.isFinite(bestDistance) || bestDistance <= 0) {
+        return null;
+    }
+    return {
+        flag: bestFlag,
+        reason: "flag_typo",
+        confidence: bestDistance >= 2 ? "medium" : "high",
+    };
+}
+function parseBareKeyValueToken(token) {
+    if (token.includes("://")) {
+        return null;
+    }
+    const match = token.match(/^([A-Za-z][A-Za-z0-9_-]{1,63})([:=])(.*)$/);
+    if (!match) {
+        return null;
+    }
+    const key = match[1];
+    const value = match[3];
+    if (value.length === 0) {
+        return null;
+    }
+    return {
+        key,
+        value,
+    };
+}
+function normalizeLongOptionToken(token, lookup) {
+    if (!token.startsWith("--")) {
+        return { tokens: [token] };
+    }
+    const equalsIndex = token.indexOf("=");
+    const key = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;
+    const inlineValue = equalsIndex >= 0 ? token.slice(equalsIndex + 1) : undefined;
+    const resolution = resolveCanonicalFlag(key, lookup);
+    if (!resolution) {
+        return { tokens: [token] };
+    }
+    const normalizedToken = inlineValue === undefined ? resolution.flag : `${resolution.flag}=${inlineValue}`;
+    if (normalizedToken === token) {
+        return { tokens: [token] };
+    }
+    return {
+        tokens: [normalizedToken],
+        event: {
+            from: token,
+            to: [normalizedToken],
+            reason: resolution.reason,
+            confidence: resolution.confidence,
+        },
+    };
+}
+export function normalizeBootstrapInvocation(argv) {
+    const trace = [];
+    const legacyNormalized = normalizeLegacyExtensionActionSyntax(argv);
+    if (legacyNormalized.length !== argv.length || legacyNormalized.some((token, index) => token !== argv[index])) {
+        trace.push({
+            from: argv.join(" "),
+            to: [...legacyNormalized],
+            reason: "legacy_extension_action",
+            confidence: "high",
+        });
+    }
+    const commandName = parseBootstrapCommandName(legacyNormalized);
+    const lookup = buildFlagLookup(commandName);
+    const normalizedArgv = [];
+    for (let index = 0; index < legacyNormalized.length; index += 1) {
+        const token = legacyNormalized[index];
+        if (token === "--") {
+            normalizedArgv.push(...legacyNormalized.slice(index));
+            break;
+        }
+        const previous = normalizedArgv[normalizedArgv.length - 1];
+        if (token.startsWith("--")) {
+            const normalizedToken = normalizeLongOptionToken(token, lookup);
+            normalizedArgv.push(...normalizedToken.tokens);
+            if (normalizedToken.event) {
+                trace.push(normalizedToken.event);
+            }
+            continue;
+        }
+        const bareKeyValue = parseBareKeyValueToken(token);
+        if (bareKeyValue &&
+            !(typeof previous === "string" && previous.startsWith("-"))) {
+            const resolution = resolveCanonicalFlag(bareKeyValue.key, lookup);
+            if (resolution) {
+                const replacement = [resolution.flag, bareKeyValue.value];
+                normalizedArgv.push(...replacement);
+                trace.push({
+                    from: token,
+                    to: replacement,
+                    reason: "bare_key_value",
+                    confidence: resolution.confidence,
+                });
+                continue;
+            }
+        }
+        normalizedArgv.push(token);
+    }
+    return {
+        argv: normalizedArgv,
+        commandName,
+        trace,
+    };
+}
 export function parseBootstrapTypeValue(argv) {
     for (let index = 0; index < argv.length; index += 1) {
         const token = argv[index];

package/dist/cli/bootstrap-args.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-args.js","sourceRoot":"/","sources":["cli/bootstrap-args.ts"],"names":[],"mappings":"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","sourcesContent":["function parseBootstrapPathToken(\n  token: string,\n  next: string | undefined,\n): { consumed: number; pathValue?: string } | null {\n  if (token === \"--path\") {\n    if (typeof next === \"string\" && next.length > 0) {\n      return {\n        consumed: 2,\n        pathValue: next,\n      };\n    }\n    return {\n      consumed: 1,\n    };\n  }\n\n  if (!token.startsWith(\"--path=\")) {\n    return null;\n  }\n\n  const value = token.slice(\"--path=\".length);\n  if (value.length > 0) {\n    return {\n      consumed: 1,\n      pathValue: value,\n    };\n  }\n  return {\n    consumed: 1,\n  };\n}\n\nexport interface BootstrapGlobalOptions {\n  path?: string;\n  noExtensions: boolean;\n  noPager: boolean;\n  json: boolean;\n  quiet: boolean;\n}\n\nexport function parseBootstrapGlobalOptions(argv: string[]): BootstrapGlobalOptions {\n  let pathValue: string | undefined;\n  let noExtensions = false;\n  let noPager = false;\n  let json = false;\n  let quiet = false;\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (token === \"--no-extensions\") {\n      noExtensions = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--no-pager\") {\n      noPager = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--json\") {\n      json = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--quiet\") {\n      quiet = true;\n      index += 1;\n      continue;\n    }\n    const parsedPath = parseBootstrapPathToken(token, argv[index + 1]);\n    if (parsedPath) {\n      if (parsedPath.pathValue !== undefined) {\n        pathValue = parsedPath.pathValue;\n      }\n      index += parsedPath.consumed;\n      continue;\n    }\n    index += 1;\n  }\n  return {\n    path: pathValue,\n    noExtensions,\n    noPager,\n    json,\n    quiet,\n  };\n}\n\nexport function stripGlobalBootstrapTokens(argv: string[]): string[] {\n  const remaining: string[] = [];\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (\n      token === \"--json\" ||\n      token === \"--quiet\" ||\n      token === \"--no-extensions\" ||\n      token === \"--no-pager\" ||\n      token === \"--profile\" ||\n      token === \"--explain\"\n    ) {\n      index += 1;\n      continue;\n    }\n    if (token === \"--path\") {\n      index += 2;\n      continue;\n    }\n    if (token.startsWith(\"--path=\")) {\n      index += 1;\n      continue;\n    }\n    remaining.push(token);\n    index += 1;\n  }\n  return remaining;\n}\n\nexport interface BootstrapHelpRequest {\n  requested: boolean;\n  commandPathTokens: string[];\n}\n\nexport function parseBootstrapHelpRequest(argv: string[]): BootstrapHelpRequest {\n  const stripped = stripGlobalBootstrapTokens(argv);\n  const first = stripped[0]?.trim().toLowerCase();\n  if (first === \"help\") {\n    const commandPathTokens: string[] = [];\n    for (let index = 1; index < stripped.length; index += 1) {\n      const token = stripped[index];\n      if (token.startsWith(\"-\")) {\n        break;\n      }\n      commandPathTokens.push(token.trim().toLowerCase());\n    }\n    return {\n      requested: true,\n      commandPathTokens,\n    };\n  }\n\n  const helpFlagIndex = stripped.findIndex((token) => token === \"--help\" || token === \"-h\");\n  if (helpFlagIndex < 0) {\n    return {\n      requested: false,\n      commandPathTokens: [],\n    };\n  }\n\n  const commandPathTokens: string[] = [];\n  for (const token of stripped) {\n    if (token.startsWith(\"-\")) {\n      break;\n    }\n    commandPathTokens.push(token.trim().toLowerCase());\n  }\n  return {\n    requested: true,\n    commandPathTokens,\n  };\n}\n\nexport function parseBootstrapCommandName(argv: string[]): string | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (token === \"--path\") {\n      index += 1;\n      continue;\n    }\n    if (\n      token.startsWith(\"--path=\") ||\n      token === \"--json\" ||\n      token === \"--quiet\" ||\n      token === \"--no-extensions\" ||\n      token === \"--no-pager\" ||\n      token === \"--profile\" ||\n      token === \"--explain\"\n    ) {\n      continue;\n    }\n    if (token.startsWith(\"-\")) {\n      continue;\n    }\n    return token.trim().toLowerCase();\n  }\n  return undefined;\n}\n\nfunction shouldDisablePagerForInvocation(argv: string[], bootstrapGlobal: BootstrapGlobalOptions): boolean {\n  if (bootstrapGlobal.noPager) {\n    return true;\n  }\n  if (process.stdout.isTTY === true) {\n    return false;\n  }\n  const helpRequest = parseBootstrapHelpRequest(argv);\n  return helpRequest.requested;\n}\n\nexport function applyBootstrapPagerPolicy(argv: string[]): void {\n  const bootstrapGlobal = parseBootstrapGlobalOptions(argv);\n  if (!shouldDisablePagerForInvocation(argv, bootstrapGlobal)) {\n    return;\n  }\n  process.env.PAGER = \"cat\";\n  process.env.MANPAGER = \"cat\";\n  process.env.GIT_PAGER = \"cat\";\n  if (typeof process.env.LESS !== \"string\" || process.env.LESS.trim().length === 0) {\n    process.env.LESS = \"FRX\";\n  }\n}\n\ntype ExtensionSubcommandAction =\n  | \"init\"\n  | \"install\"\n  | \"uninstall\"\n  | \"explore\"\n  | \"manage\"\n  | \"doctor\"\n  | \"adopt\"\n  | \"adopt-all\"\n  | \"activate\"\n  | \"deactivate\";\n\nconst EXTENSION_ACTION_SYNTAX_TOKENS = new Set<ExtensionSubcommandAction>([\n  \"install\",\n  \"uninstall\",\n  \"explore\",\n  \"manage\",\n  \"doctor\",\n  \"adopt\",\n  \"adopt-all\",\n  \"activate\",\n  \"deactivate\",\n]);\n\nexport function normalizeLegacyExtensionActionSyntax(argv: string[]): string[] {\n  const extensionIndex = argv.findIndex((token) => token === \"extension\");\n  if (extensionIndex < 0) {\n    return [...argv];\n  }\n  const actionToken = argv[extensionIndex + 1];\n  if (!actionToken || actionToken.startsWith(\"-\")) {\n    return [...argv];\n  }\n  if (!EXTENSION_ACTION_SYNTAX_TOKENS.has(actionToken as ExtensionSubcommandAction)) {\n    return [...argv];\n  }\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    return [...argv];\n  }\n  const forcedActionFlag = `--${actionToken}`;\n  if (argv.includes(forcedActionFlag)) {\n    return [...argv];\n  }\n  return [...argv.slice(0, extensionIndex + 1), forcedActionFlag, ...argv.slice(extensionIndex + 2)];\n}\n\nexport function parseBootstrapTypeValue(argv: string[]): string | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (token === \"--type\") {\n      const candidate = argv[index + 1];\n      if (typeof candidate === \"string\" && candidate.trim().length > 0) {\n        return candidate.trim();\n      }\n      continue;\n    }\n    if (token.startsWith(\"--type=\")) {\n      const candidate = token.slice(\"--type=\".length).trim();\n      if (candidate.length > 0) {\n        return candidate;\n      }\n    }\n  }\n  return undefined;\n}\n"]}
+{"version":3,"file":"bootstrap-args.js","sourceRoot":"/","sources":["cli/bootstrap-args.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolveSubcommandFlagContractsForCommand, type CliFlagContract } from \"../sdk/cli-contracts.js\";\nimport { levenshteinDistanceWithinLimit } from \"../core/shared/levenshtein.js\";\n\nfunction parseBootstrapPathToken(\n  token: string,\n  next: string | undefined,\n): { consumed: number; pathValue?: string } | null {\n  if (token === \"--path\") {\n    if (typeof next === \"string\" && next.length > 0) {\n      return {\n        consumed: 2,\n        pathValue: next,\n      };\n    }\n    return {\n      consumed: 1,\n    };\n  }\n\n  if (!token.startsWith(\"--path=\")) {\n    return null;\n  }\n\n  const value = token.slice(\"--path=\".length);\n  if (value.length > 0) {\n    return {\n      consumed: 1,\n      pathValue: value,\n    };\n  }\n  return {\n    consumed: 1,\n  };\n}\n\nexport interface BootstrapGlobalOptions {\n  path?: string;\n  noExtensions: boolean;\n  noPager: boolean;\n  json: boolean;\n  quiet: boolean;\n}\n\nexport function parseBootstrapGlobalOptions(argv: string[]): BootstrapGlobalOptions {\n  let pathValue: string | undefined;\n  let noExtensions = false;\n  let noPager = false;\n  let json = false;\n  let quiet = false;\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (token === \"--no-extensions\") {\n      noExtensions = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--no-pager\") {\n      noPager = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--json\") {\n      json = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--quiet\") {\n      quiet = true;\n      index += 1;\n      continue;\n    }\n    const parsedPath = parseBootstrapPathToken(token, argv[index + 1]);\n    if (parsedPath) {\n      if (parsedPath.pathValue !== undefined) {\n        pathValue = parsedPath.pathValue;\n      }\n      index += parsedPath.consumed;\n      continue;\n    }\n    index += 1;\n  }\n  return {\n    path: pathValue,\n    noExtensions,\n    noPager,\n    json,\n    quiet,\n  };\n}\n\nexport function stripGlobalBootstrapTokens(argv: string[]): string[] {\n  const remaining: string[] = [];\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (\n      token === \"--json\" ||\n      token === \"--quiet\" ||\n      token === \"--no-extensions\" ||\n      token === \"--no-pager\" ||\n      token === \"--profile\" ||\n      token === \"--explain\"\n    ) {\n      index += 1;\n      continue;\n    }\n    if (token === \"--path\") {\n      index += 2;\n      continue;\n    }\n    if (token.startsWith(\"--path=\")) {\n      index += 1;\n      continue;\n    }\n    remaining.push(token);\n    index += 1;\n  }\n  return remaining;\n}\n\nexport interface BootstrapHelpRequest {\n  requested: boolean;\n  commandPathTokens: string[];\n}\n\nexport function parseBootstrapHelpRequest(argv: string[]): BootstrapHelpRequest {\n  const stripped = stripGlobalBootstrapTokens(argv);\n  const first = stripped[0]?.trim().toLowerCase();\n  if (first === \"help\") {\n    const commandPathTokens: string[] = [];\n    for (let index = 1; index < stripped.length; index += 1) {\n      const token = stripped[index];\n      if (token.startsWith(\"-\")) {\n        break;\n      }\n      commandPathTokens.push(token.trim().toLowerCase());\n    }\n    return {\n      requested: true,\n      commandPathTokens,\n    };\n  }\n\n  const helpFlagIndex = stripped.findIndex((token) => token === \"--help\" || token === \"-h\");\n  if (helpFlagIndex < 0) {\n    return {\n      requested: false,\n      commandPathTokens: [],\n    };\n  }\n\n  const commandPathTokens: string[] = [];\n  for (const token of stripped) {\n    if (token.startsWith(\"-\")) {\n      break;\n    }\n    commandPathTokens.push(token.trim().toLowerCase());\n  }\n  return {\n    requested: true,\n    commandPathTokens,\n  };\n}\n\nexport function parseBootstrapCommandName(argv: string[]): string | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (token === \"--path\") {\n      index += 1;\n      continue;\n    }\n    if (\n      token.startsWith(\"--path=\") ||\n      token === \"--json\" ||\n      token === \"--quiet\" ||\n      token === \"--no-extensions\" ||\n      token === \"--no-pager\" ||\n      token === \"--profile\" ||\n      token === \"--explain\"\n    ) {\n      continue;\n    }\n    if (token.startsWith(\"-\")) {\n      continue;\n    }\n    return token.trim().toLowerCase();\n  }\n  return undefined;\n}\n\nfunction shouldDisablePagerForInvocation(argv: string[], bootstrapGlobal: BootstrapGlobalOptions): boolean {\n  if (bootstrapGlobal.noPager) {\n    return true;\n  }\n  if (process.stdout.isTTY === true) {\n    return false;\n  }\n  const helpRequest = parseBootstrapHelpRequest(argv);\n  return helpRequest.requested;\n}\n\nexport function applyBootstrapPagerPolicy(argv: string[]): void {\n  const bootstrapGlobal = parseBootstrapGlobalOptions(argv);\n  if (!shouldDisablePagerForInvocation(argv, bootstrapGlobal)) {\n    return;\n  }\n  process.env.PAGER = \"cat\";\n  process.env.MANPAGER = \"cat\";\n  process.env.GIT_PAGER = \"cat\";\n  if (typeof process.env.LESS !== \"string\" || process.env.LESS.trim().length === 0) {\n    process.env.LESS = \"FRX\";\n  }\n}\n\ntype ExtensionSubcommandAction =\n  | \"init\"\n  | \"install\"\n  | \"uninstall\"\n  | \"explore\"\n  | \"manage\"\n  | \"doctor\"\n  | \"adopt\"\n  | \"adopt-all\"\n  | \"activate\"\n  | \"deactivate\";\n\nconst EXTENSION_ACTION_SYNTAX_TOKENS = new Set<ExtensionSubcommandAction>([\n  \"install\",\n  \"uninstall\",\n  \"explore\",\n  \"manage\",\n  \"doctor\",\n  \"adopt\",\n  \"adopt-all\",\n  \"activate\",\n  \"deactivate\",\n]);\n\nexport function normalizeLegacyExtensionActionSyntax(argv: string[]): string[] {\n  const extensionIndex = argv.findIndex((token) => token === \"extension\");\n  if (extensionIndex < 0) {\n    return [...argv];\n  }\n  const actionToken = argv[extensionIndex + 1];\n  if (!actionToken || actionToken.startsWith(\"-\")) {\n    return [...argv];\n  }\n  if (!EXTENSION_ACTION_SYNTAX_TOKENS.has(actionToken as ExtensionSubcommandAction)) {\n    return [...argv];\n  }\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    return [...argv];\n  }\n  const forcedActionFlag = `--${actionToken}`;\n  if (argv.includes(forcedActionFlag)) {\n    return [...argv];\n  }\n  return [...argv.slice(0, extensionIndex + 1), forcedActionFlag, ...argv.slice(extensionIndex + 2)];\n}\n\ntype BootstrapNormalizationReason = \"legacy_extension_action\" | \"flag_alias\" | \"flag_typo\" | \"bare_key_value\";\ntype BootstrapNormalizationConfidence = \"high\" | \"medium\";\n\nexport interface BootstrapNormalizationEvent {\n  from: string;\n  to: string[];\n  reason: BootstrapNormalizationReason;\n  confidence: BootstrapNormalizationConfidence;\n}\n\nexport interface BootstrapInvocationNormalizationResult {\n  argv: string[];\n  commandName: string | undefined;\n  trace: BootstrapNormalizationEvent[];\n}\n\ninterface FlagLookup {\n  canonicalByNormalized: Map<string, string | null>;\n  canonicalByCompact: Map<string, string | null>;\n  canonicalComparables: Array<{ canonicalFlag: string; comparable: string }>;\n}\n\nfunction normalizeFlagKeyToken(raw: string): string {\n  const withoutPrefix = raw.replace(/^--?/, \"\");\n  return withoutPrefix\n    .replace(/_/g, \"-\")\n    .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n    .toLowerCase();\n}\n\nfunction toComparableFlagKey(raw: string): string {\n  return normalizeFlagKeyToken(raw).replace(/-/g, \"\");\n}\n\nfunction markUnambiguousFlag(\n  map: Map<string, string | null>,\n  key: string,\n  canonicalFlag: string,\n): void {\n  const existing = map.get(key);\n  if (existing === undefined) {\n    map.set(key, canonicalFlag);\n    return;\n  }\n  if (existing !== canonicalFlag) {\n    map.set(key, null);\n  }\n}\n\nfunction collectLongFlagCandidates(contract: CliFlagContract): string[] {\n  const candidates: string[] = [];\n  const pushLongFlag = (value: string | undefined): void => {\n    if (typeof value !== \"string\") {\n      return;\n    }\n    if (!value.startsWith(\"--\")) {\n      return;\n    }\n    candidates.push(value);\n  };\n  pushLongFlag(contract.flag);\n  for (const alias of contract.aliases ?? []) {\n    pushLongFlag(alias);\n  }\n  return candidates;\n}\n\nfunction buildFlagLookup(commandName: string | undefined): FlagLookup {\n  const contracts = resolveSubcommandFlagContractsForCommand(commandName);\n  const canonicalByNormalized = new Map<string, string | null>();\n  const canonicalByCompact = new Map<string, string | null>();\n  const canonicalComparablesMap = new Map<string, string>();\n  for (const contract of contracts) {\n    const longCandidates = collectLongFlagCandidates(contract);\n    if (longCandidates.length === 0) {\n      continue;\n    }\n    const canonicalFlag = `--${normalizeFlagKeyToken(longCandidates[0])}`;\n    for (const candidate of longCandidates) {\n      markUnambiguousFlag(canonicalByNormalized, normalizeFlagKeyToken(candidate), canonicalFlag);\n      markUnambiguousFlag(canonicalByCompact, toComparableFlagKey(candidate), canonicalFlag);\n    }\n    const comparable = toComparableFlagKey(canonicalFlag);\n    if (!canonicalComparablesMap.has(canonicalFlag)) {\n      canonicalComparablesMap.set(canonicalFlag, comparable);\n    }\n  }\n  return {\n    canonicalByNormalized,\n    canonicalByCompact,\n    canonicalComparables: [...canonicalComparablesMap.entries()].map(([canonicalFlag, comparable]) => ({\n      canonicalFlag,\n      comparable,\n    })),\n  };\n}\n\nfunction resolveCanonicalFlag(\n  rawKey: string,\n  lookup: FlagLookup,\n): { flag: string; reason: \"flag_alias\" | \"flag_typo\"; confidence: BootstrapNormalizationConfidence } | null {\n  const normalizedKey = normalizeFlagKeyToken(rawKey);\n  const direct = lookup.canonicalByNormalized.get(normalizedKey);\n  if (typeof direct === \"string\") {\n    return {\n      flag: direct,\n      reason: \"flag_alias\",\n      confidence: \"high\",\n    };\n  }\n  const comparableKey = normalizedKey.replace(/-/g, \"\");\n  const compactMatch = lookup.canonicalByCompact.get(comparableKey);\n  if (typeof compactMatch === \"string\") {\n    return {\n      flag: compactMatch,\n      reason: \"flag_alias\",\n      confidence: \"high\",\n    };\n  }\n  const maxDistance = comparableKey.length >= 8 ? 2 : 1;\n  let bestDistance = Number.POSITIVE_INFINITY;\n  let bestFlag: string | undefined;\n  let tied = false;\n  for (const candidate of lookup.canonicalComparables) {\n    const distance = levenshteinDistanceWithinLimit(comparableKey, candidate.comparable, maxDistance);\n    if (distance === null) {\n      continue;\n    }\n    if (distance < bestDistance) {\n      bestDistance = distance;\n      bestFlag = candidate.canonicalFlag;\n      tied = false;\n      continue;\n    }\n    if (distance === bestDistance && bestFlag !== candidate.canonicalFlag) {\n      tied = true;\n    }\n  }\n  if (!bestFlag || tied || !Number.isFinite(bestDistance) || bestDistance <= 0) {\n    return null;\n  }\n  return {\n    flag: bestFlag,\n    reason: \"flag_typo\",\n    confidence: bestDistance >= 2 ? \"medium\" : \"high\",\n  };\n}\n\nfunction parseBareKeyValueToken(token: string): { key: string; value: string } | null {\n  if (token.includes(\"://\")) {\n    return null;\n  }\n  const match = token.match(/^([A-Za-z][A-Za-z0-9_-]{1,63})([:=])(.*)$/);\n  if (!match) {\n    return null;\n  }\n  const key = match[1];\n  const value = match[3];\n  if (value.length === 0) {\n    return null;\n  }\n  return {\n    key,\n    value,\n  };\n}\n\nfunction normalizeLongOptionToken(\n  token: string,\n  lookup: FlagLookup,\n): { tokens: string[]; event?: BootstrapNormalizationEvent } {\n  if (!token.startsWith(\"--\")) {\n    return { tokens: [token] };\n  }\n  const equalsIndex = token.indexOf(\"=\");\n  const key = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;\n  const inlineValue = equalsIndex >= 0 ? token.slice(equalsIndex + 1) : undefined;\n  const resolution = resolveCanonicalFlag(key, lookup);\n  if (!resolution) {\n    return { tokens: [token] };\n  }\n  const normalizedToken = inlineValue === undefined ? resolution.flag : `${resolution.flag}=${inlineValue}`;\n  if (normalizedToken === token) {\n    return { tokens: [token] };\n  }\n  return {\n    tokens: [normalizedToken],\n    event: {\n      from: token,\n      to: [normalizedToken],\n      reason: resolution.reason,\n      confidence: resolution.confidence,\n    },\n  };\n}\n\nexport function normalizeBootstrapInvocation(argv: string[]): BootstrapInvocationNormalizationResult {\n  const trace: BootstrapNormalizationEvent[] = [];\n  const legacyNormalized = normalizeLegacyExtensionActionSyntax(argv);\n  if (legacyNormalized.length !== argv.length || legacyNormalized.some((token, index) => token !== argv[index])) {\n    trace.push({\n      from: argv.join(\" \"),\n      to: [...legacyNormalized],\n      reason: \"legacy_extension_action\",\n      confidence: \"high\",\n    });\n  }\n  const commandName = parseBootstrapCommandName(legacyNormalized);\n  const lookup = buildFlagLookup(commandName);\n  const normalizedArgv: string[] = [];\n  for (let index = 0; index < legacyNormalized.length; index += 1) {\n    const token = legacyNormalized[index];\n    if (token === \"--\") {\n      normalizedArgv.push(...legacyNormalized.slice(index));\n      break;\n    }\n    const previous = normalizedArgv[normalizedArgv.length - 1];\n    if (token.startsWith(\"--\")) {\n      const normalizedToken = normalizeLongOptionToken(token, lookup);\n      normalizedArgv.push(...normalizedToken.tokens);\n      if (normalizedToken.event) {\n        trace.push(normalizedToken.event);\n      }\n      continue;\n    }\n    const bareKeyValue = parseBareKeyValueToken(token);\n    if (\n      bareKeyValue &&\n      !(typeof previous === \"string\" && previous.startsWith(\"-\"))\n    ) {\n      const resolution = resolveCanonicalFlag(bareKeyValue.key, lookup);\n      if (resolution) {\n        const replacement = [resolution.flag, bareKeyValue.value];\n        normalizedArgv.push(...replacement);\n        trace.push({\n          from: token,\n          to: replacement,\n          reason: \"bare_key_value\",\n          confidence: resolution.confidence,\n        });\n        continue;\n      }\n    }\n    normalizedArgv.push(token);\n  }\n  return {\n    argv: normalizedArgv,\n    commandName,\n    trace,\n  };\n}\n\nexport function parseBootstrapTypeValue(argv: string[]): string | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (token === \"--type\") {\n      const candidate = argv[index + 1];\n      if (typeof candidate === \"string\" && candidate.trim().length > 0) {\n        return candidate.trim();\n      }\n      continue;\n    }\n    if (token.startsWith(\"--type=\")) {\n      const candidate = token.slice(\"--type=\".length).trim();\n      if (candidate.length > 0) {\n        return candidate;\n      }\n    }\n  }\n  return undefined;\n}\n"]}

package/dist/cli/commander-usage.js

@@ -5,10 +5,13 @@ import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
 import { BUILTIN_ITEM_TYPE_VALUES } from "../types/index.js";
 import { getActiveExtensionRegistrations, runActiveServiceOverride, } from "../core/extensions/index.js";
+import { resolveSubcommandFlagContractsForCommand } from "../sdk/cli-contracts.js";
 import { formatCommanderErrorForDisplay, formatCommanderErrorForJson, } from "./error-guidance.js";
 import { normalizeHelpCommandPath } from "./help-content.js";
 import { getCommandPath } from "./registration-helpers.js";
-import { normalizeLegacyExtensionActionSyntax, parseBootstrapGlobalOptions, parseBootstrapCommandName, } from "./bootstrap-args.js";
+import { normalizeBootstrapInvocation, parseBootstrapGlobalOptions, parseBootstrapCommandName, } from "./bootstrap-args.js";
+import { extractProvidedOptionFlags, normalizeLongFlag, renderPmCommand, } from "./argv-utils.js";
+import { levenshteinDistanceWithinLimit } from "../core/shared/levenshtein.js";
 export const BUILTIN_TYPE_HELP_VALUES = BUILTIN_ITEM_TYPE_VALUES.join("|");
 export function collectRuntimeCommandPaths(root, extensionDescriptors) {
     const commandPaths = new Set();
@@ -55,6 +58,71 @@ export function scoreCommandPathMatch(commandPath, queryToken) {
     }
     return Number.POSITIVE_INFINITY;
 }
+function toComparableFlag(flag) {
+    return normalizeLongFlag(flag).slice(2).replace(/-/g, "");
+}
+function renderAttemptedCommand(argv) {
+    return renderPmCommand(argv);
+}
+function collectKnownLongFlags(commandName) {
+    const flags = new Set();
+    const contracts = resolveSubcommandFlagContractsForCommand(commandName);
+    for (const contract of contracts) {
+        if (contract.flag.startsWith("--")) {
+            flags.add(normalizeLongFlag(contract.flag));
+        }
+        for (const alias of contract.aliases ?? []) {
+            if (alias.startsWith("--")) {
+                flags.add(normalizeLongFlag(alias));
+            }
+        }
+    }
+    return [...flags].sort((left, right) => left.localeCompare(right));
+}
+function suggestNearestLongFlags(unknownOption, knownFlags) {
+    if (!unknownOption.startsWith("--")) {
+        return [];
+    }
+    const unknownComparable = toComparableFlag(unknownOption);
+    const maxDistance = unknownComparable.length >= 8 ? 2 : 1;
+    const candidates = [];
+    for (const flag of knownFlags) {
+        const distance = levenshteinDistanceWithinLimit(unknownComparable, toComparableFlag(flag), maxDistance);
+        if (distance === null) {
+            continue;
+        }
+        if (distance <= 0) {
+            continue;
+        }
+        candidates.push({ flag, distance });
+    }
+    return candidates
+        .sort((left, right) => {
+        if (left.distance !== right.distance) {
+            return left.distance - right.distance;
+        }
+        return left.flag.localeCompare(right.flag);
+    })
+        .map((entry) => entry.flag)
+        .slice(0, 3);
+}
+function rewriteUnknownOptionArgv(argv, unknownOption, replacementFlag) {
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (!token.startsWith("--")) {
+            continue;
+        }
+        const equalsIndex = token.indexOf("=");
+        const key = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;
+        if (normalizeLongFlag(key) !== normalizeLongFlag(unknownOption)) {
+            continue;
+        }
+        const next = [...argv];
+        next[index] = equalsIndex >= 0 ? `${replacementFlag}${token.slice(equalsIndex)}` : replacementFlag;
+        return next;
+    }
+    return undefined;
+}
 export function buildUnknownCommandGuidanceFromRuntime(rawMessage, root, extensionDescriptors) {
     const unknownCommandMatch = rawMessage.match(/unknown command '([^']+)'/i);
     if (!unknownCommandMatch || typeof unknownCommandMatch[1] !== "string") {
@@ -125,9 +193,11 @@ export function isKnownHelpCommandPath(root, commandPathTokens) {
 export async function resolveCommanderUsageContext(error, rootProgram, extensionDescriptors) {
     const rawMessage = typeof error === "object" && error !== null ? error.message : undefined;
     const message = rawMessage ?? "Invalid command usage";
-    const invocationArgv = normalizeLegacyExtensionActionSyntax(process.argv.slice(2));
+    const invocationArgv = normalizeBootstrapInvocation(process.argv.slice(2)).argv;
     const bootstrapGlobal = parseBootstrapGlobalOptions(invocationArgv);
     const commandName = parseBootstrapCommandName(invocationArgv);
+    const attemptedCommand = renderAttemptedCommand(invocationArgv);
+    const providedOptionFlags = extractProvidedOptionFlags(invocationArgv);
     let allowedTypes = BUILTIN_TYPE_HELP_VALUES;
     try {
         const pmRoot = resolvePmRoot(process.cwd(), bootstrapGlobal.path);
@@ -143,19 +213,50 @@ export async function resolveCommanderUsageContext(error, rootProgram, extension
         // Fall back to built-in type guidance when settings cannot be read.
     }
     const unknownCommandGuidance = buildUnknownCommandGuidanceFromRuntime(message, rootProgram, extensionDescriptors);
+    const unknownOptionMatch = message.match(/unknown option '([^']+)'/i);
+    const unknownOptionSuggestions = unknownOptionMatch && commandName
+        ? suggestNearestLongFlags(unknownOptionMatch[1], collectKnownLongFlags(commandName))
+        : undefined;
+    let suggestedRetryCommand;
+    if (unknownOptionMatch && unknownOptionSuggestions && unknownOptionSuggestions.length > 0) {
+        const rewritten = rewriteUnknownOptionArgv(invocationArgv, unknownOptionMatch[1], unknownOptionSuggestions[0]);
+        if (rewritten) {
+            suggestedRetryCommand = renderAttemptedCommand(rewritten);
+        }
+    }
+    if (!suggestedRetryCommand) {
+        const missingRequiredOption = message.match(/required option '([^']+)' not specified/i);
+        const requiredOptionToken = missingRequiredOption?.[1]?.trim().split(/\s+/)[0]?.replace(/[,:;]+$/g, "");
+        if (requiredOptionToken?.startsWith("--")) {
+            const hasFlag = invocationArgv.some((token) => token.startsWith(requiredOptionToken));
+            if (!hasFlag) {
+                suggestedRetryCommand = renderAttemptedCommand([...invocationArgv, requiredOptionToken, "<value>"]);
+            }
+        }
+    }
     return {
         message,
         commandName,
         allowedTypes,
+        attemptedCommand,
+        normalizedInvocationArgs: [...invocationArgv],
+        providedOptionFlags,
+        unknownOptionSuggestions,
+        suggestedRetryCommand,
         ...(unknownCommandGuidance ?? {}),
     };
 }
 export async function formatCommanderUsageMessage(error, rootProgram, extensionDescriptors) {
     const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors);
-    const { message, commandName, allowedTypes, unknownCommandExamples, unknownCommandNextSteps } = usageContext;
+    const { message, commandName, allowedTypes, unknownCommandExamples, unknownCommandNextSteps, attemptedCommand, normalizedInvocationArgs, providedOptionFlags, unknownOptionSuggestions, suggestedRetryCommand, } = usageContext;
     const formatted = formatCommanderErrorForDisplay(message, commandName, allowedTypes, {
         unknownCommandExamples,
         unknownCommandNextSteps,
+        attemptedCommand,
+        normalizedInvocationArgs,
+        providedOptionFlags,
+        unknownOptionSuggestions,
+        suggestedRetryCommand,
     });
     const serviceOverride = await runActiveServiceOverride("help_format", {
         message: formatted,
@@ -172,6 +273,11 @@ export async function formatCommanderUsageJson(error, rootProgram, extensionDesc
     const envelope = formatCommanderErrorForJson(usageContext.message, usageContext.commandName, usageContext.allowedTypes, EXIT_CODE.USAGE, {
         unknownCommandExamples: usageContext.unknownCommandExamples,
         unknownCommandNextSteps: usageContext.unknownCommandNextSteps,
+        attemptedCommand: usageContext.attemptedCommand,
+        normalizedInvocationArgs: usageContext.normalizedInvocationArgs,
+        providedOptionFlags: usageContext.providedOptionFlags,
+        unknownOptionSuggestions: usageContext.unknownOptionSuggestions,
+        suggestedRetryCommand: usageContext.suggestedRetryCommand,
     });
     return JSON.stringify(envelope, null, 2);
 }

package/dist/cli/commander-usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"commander-usage.js","sourceRoot":"/","sources":["cli/commander-usage.ts"],"names":[],"mappings":"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","sourcesContent":["import { Command } from \"commander\";\nimport { pathExists } from \"../core/fs/fs-utils.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport { BUILTIN_ITEM_TYPE_VALUES } from \"../types/index.js\";\nimport {\n  getActiveExtensionRegistrations,\n  runActiveServiceOverride,\n} from \"../core/extensions/index.js\";\nimport {\n  type CommanderGuidanceContext,\n  formatCommanderErrorForDisplay,\n  formatCommanderErrorForJson,\n} from \"./error-guidance.js\";\nimport { normalizeHelpCommandPath } from \"./help-content.js\";\nimport { getCommandPath } from \"./registration-helpers.js\";\nimport {\n  normalizeLegacyExtensionActionSyntax,\n  parseBootstrapGlobalOptions,\n  parseBootstrapCommandName,\n} from \"./bootstrap-args.js\";\nimport type { ExtensionCommandHelpDescriptor } from \"./extension-command-help.js\";\n\nexport const BUILTIN_TYPE_HELP_VALUES = BUILTIN_ITEM_TYPE_VALUES.join(\"|\");\n\nexport interface CommanderUsageContext extends CommanderGuidanceContext {\n  message: string;\n  commandName: string | undefined;\n  allowedTypes: string;\n}\n\nexport function collectRuntimeCommandPaths(\n  root: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): string[] {\n  const commandPaths = new Set<string>();\n  const queue: Command[] = [...root.commands];\n  while (queue.length > 0) {\n    const current = queue.shift();\n    if (!current) {\n      continue;\n    }\n    const normalizedPath = normalizeHelpCommandPath(getCommandPath(current));\n    const hasInternalSegment = normalizedPath.split(\" \").some((segment) => segment.startsWith(\"_\"));\n    if (normalizedPath.length > 0 && !hasInternalSegment) {\n      commandPaths.add(normalizedPath);\n    }\n    queue.push(...current.commands);\n  }\n  for (const descriptorPath of extensionDescriptors.keys()) {\n    const normalizedPath = normalizeHelpCommandPath(descriptorPath);\n    const hasInternalSegment = normalizedPath.split(\" \").some((segment) => segment.startsWith(\"_\"));\n    if (normalizedPath.length > 0 && !hasInternalSegment) {\n      commandPaths.add(normalizedPath);\n    }\n  }\n  return [...commandPaths].sort((left, right) => left.localeCompare(right));\n}\n\nexport function scoreCommandPathMatch(commandPath: string, queryToken: string): number {\n  const normalizedPath = commandPath.trim().toLowerCase();\n  const normalizedToken = queryToken.trim().toLowerCase();\n  if (normalizedToken.length === 0) {\n    return Number.POSITIVE_INFINITY;\n  }\n  const pathSegments = normalizedPath.split(\" \");\n  if (normalizedPath === normalizedToken) {\n    return 0;\n  }\n  if (pathSegments.includes(normalizedToken)) {\n    return 1;\n  }\n  if (pathSegments.some((segment) => segment.startsWith(normalizedToken))) {\n    return 2;\n  }\n  if (normalizedPath.includes(normalizedToken)) {\n    return 3;\n  }\n  return Number.POSITIVE_INFINITY;\n}\n\nexport function buildUnknownCommandGuidanceFromRuntime(\n  rawMessage: string,\n  root: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): CommanderGuidanceContext | undefined {\n  const unknownCommandMatch = rawMessage.match(/unknown command '([^']+)'/i);\n  if (!unknownCommandMatch || typeof unknownCommandMatch[1] !== \"string\") {\n    return undefined;\n  }\n  const normalizedUnknown = normalizeHelpCommandPath(unknownCommandMatch[1]);\n  if (normalizedUnknown.length === 0) {\n    return undefined;\n  }\n  const commandPaths = collectRuntimeCommandPaths(root, extensionDescriptors);\n  if (commandPaths.length === 0) {\n    return undefined;\n  }\n\n  const primaryToken = normalizedUnknown.split(\" \")[0] ?? normalizedUnknown;\n  const rankedCandidates = commandPaths\n    .map((commandPath) => {\n      const directScore = scoreCommandPathMatch(commandPath, normalizedUnknown);\n      const fallbackScore =\n        primaryToken !== normalizedUnknown ? scoreCommandPathMatch(commandPath, primaryToken) : Number.POSITIVE_INFINITY;\n      const score = Math.min(directScore, fallbackScore);\n      return { commandPath, score };\n    })\n    .filter((entry) => Number.isFinite(entry.score))\n    .sort((left, right) => {\n      if (left.score !== right.score) {\n        return left.score - right.score;\n      }\n      return left.commandPath.localeCompare(right.commandPath);\n    })\n    .map((entry) => entry.commandPath);\n\n  const fallbackTopLevel = [...new Set(commandPaths.map((commandPath) => commandPath.split(\" \")[0]).filter((segment) => segment.length > 0))];\n  fallbackTopLevel.sort((left, right) => left.localeCompare(right));\n  const suggestedPaths = (rankedCandidates.length > 0 ? rankedCandidates : fallbackTopLevel).slice(0, 3);\n  const examples = [...new Set([\"pm --help\", ...suggestedPaths.map((path) => `pm ${path} --help`)])];\n\n  return {\n    unknownCommandExamples: examples,\n    unknownCommandNextSteps: [\n      'Run \"pm --help\" to list commands available in this runtime, including active extensions.',\n      \"Use one of the suggested command paths above with --help to inspect valid flags and usage.\",\n    ],\n  };\n}\n\nexport function resolveChildCommandByToken(parent: Command, token: string): Command | undefined {\n  const normalizedToken = token.trim().toLowerCase();\n  return parent.commands.find((candidate) => {\n    if (candidate.name().trim().toLowerCase() === normalizedToken) {\n      return true;\n    }\n    const aliases = typeof candidate.aliases === \"function\" ? candidate.aliases() : [];\n    return aliases.some((alias) => alias.trim().toLowerCase() === normalizedToken);\n  });\n}\n\nexport function isKnownHelpCommandPath(root: Command, commandPathTokens: string[]): boolean {\n  if (commandPathTokens.length === 0) {\n    return true;\n  }\n  let current = root;\n  let matchedAny = false;\n  for (const token of commandPathTokens) {\n    const next = resolveChildCommandByToken(current, token);\n    if (!next) {\n      return matchedAny;\n    }\n    matchedAny = true;\n    current = next;\n  }\n  return matchedAny;\n}\n\nexport async function resolveCommanderUsageContext(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<CommanderUsageContext> {\n  const rawMessage = typeof error === \"object\" && error !== null ? (error as { message?: string }).message : undefined;\n  const message = rawMessage ?? \"Invalid command usage\";\n  const invocationArgv = normalizeLegacyExtensionActionSyntax(process.argv.slice(2));\n  const bootstrapGlobal = parseBootstrapGlobalOptions(invocationArgv);\n  const commandName = parseBootstrapCommandName(invocationArgv);\n  let allowedTypes = BUILTIN_TYPE_HELP_VALUES;\n  try {\n    const pmRoot = resolvePmRoot(process.cwd(), bootstrapGlobal.path);\n    if (await pathExists(getSettingsPath(pmRoot))) {\n      const settings = await readSettings(pmRoot);\n      const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n      if (typeRegistry.types.length > 0) {\n        allowedTypes = typeRegistry.types.join(\"|\");\n      }\n    }\n  } catch {\n    // Fall back to built-in type guidance when settings cannot be read.\n  }\n  const unknownCommandGuidance = buildUnknownCommandGuidanceFromRuntime(message, rootProgram, extensionDescriptors);\n  return {\n    message,\n    commandName,\n    allowedTypes,\n    ...(unknownCommandGuidance ?? {}),\n  };\n}\n\nexport async function formatCommanderUsageMessage(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<string> {\n  const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors);\n  const { message, commandName, allowedTypes, unknownCommandExamples, unknownCommandNextSteps } = usageContext;\n  const formatted = formatCommanderErrorForDisplay(message, commandName, allowedTypes, {\n    unknownCommandExamples,\n    unknownCommandNextSteps,\n  });\n  const serviceOverride = await runActiveServiceOverride(\"help_format\", {\n    message: formatted,\n    command: commandName,\n    allowed_types: allowedTypes,\n  });\n  if (serviceOverride.handled && typeof serviceOverride.result === \"string\") {\n    return serviceOverride.result;\n  }\n  return formatted;\n}\n\nexport async function formatCommanderUsageJson(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<string> {\n  const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors);\n  const envelope = formatCommanderErrorForJson(\n    usageContext.message,\n    usageContext.commandName,\n    usageContext.allowedTypes,\n    EXIT_CODE.USAGE,\n    {\n      unknownCommandExamples: usageContext.unknownCommandExamples,\n      unknownCommandNextSteps: usageContext.unknownCommandNextSteps,\n    },\n  );\n  return JSON.stringify(envelope, null, 2);\n}\n"]}
+{"version":3,"file":"commander-usage.js","sourceRoot":"/","sources":["cli/commander-usage.ts"],"names":[],"mappings":"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","sourcesContent":["import { Command } from \"commander\";\nimport { pathExists } from \"../core/fs/fs-utils.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport { BUILTIN_ITEM_TYPE_VALUES } from \"../types/index.js\";\nimport {\n  getActiveExtensionRegistrations,\n  runActiveServiceOverride,\n} from \"../core/extensions/index.js\";\nimport { resolveSubcommandFlagContractsForCommand } from \"../sdk/cli-contracts.js\";\nimport {\n  type CommanderGuidanceContext,\n  formatCommanderErrorForDisplay,\n  formatCommanderErrorForJson,\n} from \"./error-guidance.js\";\nimport { normalizeHelpCommandPath } from \"./help-content.js\";\nimport { getCommandPath } from \"./registration-helpers.js\";\nimport {\n  normalizeBootstrapInvocation,\n  parseBootstrapGlobalOptions,\n  parseBootstrapCommandName,\n} from \"./bootstrap-args.js\";\nimport {\n  extractProvidedOptionFlags,\n  normalizeLongFlag,\n  renderPmCommand,\n} from \"./argv-utils.js\";\nimport { levenshteinDistanceWithinLimit } from \"../core/shared/levenshtein.js\";\nimport type { ExtensionCommandHelpDescriptor } from \"./extension-command-help.js\";\n\nexport const BUILTIN_TYPE_HELP_VALUES = BUILTIN_ITEM_TYPE_VALUES.join(\"|\");\n\nexport interface CommanderUsageContext extends CommanderGuidanceContext {\n  message: string;\n  commandName: string | undefined;\n  allowedTypes: string;\n}\n\nexport function collectRuntimeCommandPaths(\n  root: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): string[] {\n  const commandPaths = new Set<string>();\n  const queue: Command[] = [...root.commands];\n  while (queue.length > 0) {\n    const current = queue.shift();\n    if (!current) {\n      continue;\n    }\n    const normalizedPath = normalizeHelpCommandPath(getCommandPath(current));\n    const hasInternalSegment = normalizedPath.split(\" \").some((segment) => segment.startsWith(\"_\"));\n    if (normalizedPath.length > 0 && !hasInternalSegment) {\n      commandPaths.add(normalizedPath);\n    }\n    queue.push(...current.commands);\n  }\n  for (const descriptorPath of extensionDescriptors.keys()) {\n    const normalizedPath = normalizeHelpCommandPath(descriptorPath);\n    const hasInternalSegment = normalizedPath.split(\" \").some((segment) => segment.startsWith(\"_\"));\n    if (normalizedPath.length > 0 && !hasInternalSegment) {\n      commandPaths.add(normalizedPath);\n    }\n  }\n  return [...commandPaths].sort((left, right) => left.localeCompare(right));\n}\n\nexport function scoreCommandPathMatch(commandPath: string, queryToken: string): number {\n  const normalizedPath = commandPath.trim().toLowerCase();\n  const normalizedToken = queryToken.trim().toLowerCase();\n  if (normalizedToken.length === 0) {\n    return Number.POSITIVE_INFINITY;\n  }\n  const pathSegments = normalizedPath.split(\" \");\n  if (normalizedPath === normalizedToken) {\n    return 0;\n  }\n  if (pathSegments.includes(normalizedToken)) {\n    return 1;\n  }\n  if (pathSegments.some((segment) => segment.startsWith(normalizedToken))) {\n    return 2;\n  }\n  if (normalizedPath.includes(normalizedToken)) {\n    return 3;\n  }\n  return Number.POSITIVE_INFINITY;\n}\n\nfunction toComparableFlag(flag: string): string {\n  return normalizeLongFlag(flag).slice(2).replace(/-/g, \"\");\n}\n\nfunction renderAttemptedCommand(argv: string[]): string {\n  return renderPmCommand(argv);\n}\n\nfunction collectKnownLongFlags(commandName: string | undefined): string[] {\n  const flags = new Set<string>();\n  const contracts = resolveSubcommandFlagContractsForCommand(commandName);\n  for (const contract of contracts) {\n    if (contract.flag.startsWith(\"--\")) {\n      flags.add(normalizeLongFlag(contract.flag));\n    }\n    for (const alias of contract.aliases ?? []) {\n      if (alias.startsWith(\"--\")) {\n        flags.add(normalizeLongFlag(alias));\n      }\n    }\n  }\n  return [...flags].sort((left, right) => left.localeCompare(right));\n}\n\nfunction suggestNearestLongFlags(unknownOption: string, knownFlags: string[]): string[] {\n  if (!unknownOption.startsWith(\"--\")) {\n    return [];\n  }\n  const unknownComparable = toComparableFlag(unknownOption);\n  const maxDistance = unknownComparable.length >= 8 ? 2 : 1;\n  const candidates: Array<{ flag: string; distance: number }> = [];\n  for (const flag of knownFlags) {\n    const distance = levenshteinDistanceWithinLimit(unknownComparable, toComparableFlag(flag), maxDistance);\n    if (distance === null) {\n      continue;\n    }\n    if (distance <= 0) {\n      continue;\n    }\n    candidates.push({ flag, distance });\n  }\n  return candidates\n    .sort((left, right) => {\n      if (left.distance !== right.distance) {\n        return left.distance - right.distance;\n      }\n      return left.flag.localeCompare(right.flag);\n    })\n    .map((entry) => entry.flag)\n    .slice(0, 3);\n}\n\nfunction rewriteUnknownOptionArgv(argv: string[], unknownOption: string, replacementFlag: string): string[] | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (!token.startsWith(\"--\")) {\n      continue;\n    }\n    const equalsIndex = token.indexOf(\"=\");\n    const key = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;\n    if (normalizeLongFlag(key) !== normalizeLongFlag(unknownOption)) {\n      continue;\n    }\n    const next = [...argv];\n    next[index] = equalsIndex >= 0 ? `${replacementFlag}${token.slice(equalsIndex)}` : replacementFlag;\n    return next;\n  }\n  return undefined;\n}\n\nexport function buildUnknownCommandGuidanceFromRuntime(\n  rawMessage: string,\n  root: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): CommanderGuidanceContext | undefined {\n  const unknownCommandMatch = rawMessage.match(/unknown command '([^']+)'/i);\n  if (!unknownCommandMatch || typeof unknownCommandMatch[1] !== \"string\") {\n    return undefined;\n  }\n  const normalizedUnknown = normalizeHelpCommandPath(unknownCommandMatch[1]);\n  if (normalizedUnknown.length === 0) {\n    return undefined;\n  }\n  const commandPaths = collectRuntimeCommandPaths(root, extensionDescriptors);\n  if (commandPaths.length === 0) {\n    return undefined;\n  }\n\n  const primaryToken = normalizedUnknown.split(\" \")[0] ?? normalizedUnknown;\n  const rankedCandidates = commandPaths\n    .map((commandPath) => {\n      const directScore = scoreCommandPathMatch(commandPath, normalizedUnknown);\n      const fallbackScore =\n        primaryToken !== normalizedUnknown ? scoreCommandPathMatch(commandPath, primaryToken) : Number.POSITIVE_INFINITY;\n      const score = Math.min(directScore, fallbackScore);\n      return { commandPath, score };\n    })\n    .filter((entry) => Number.isFinite(entry.score))\n    .sort((left, right) => {\n      if (left.score !== right.score) {\n        return left.score - right.score;\n      }\n      return left.commandPath.localeCompare(right.commandPath);\n    })\n    .map((entry) => entry.commandPath);\n\n  const fallbackTopLevel = [...new Set(commandPaths.map((commandPath) => commandPath.split(\" \")[0]).filter((segment) => segment.length > 0))];\n  fallbackTopLevel.sort((left, right) => left.localeCompare(right));\n  const suggestedPaths = (rankedCandidates.length > 0 ? rankedCandidates : fallbackTopLevel).slice(0, 3);\n  const examples = [...new Set([\"pm --help\", ...suggestedPaths.map((path) => `pm ${path} --help`)])];\n\n  return {\n    unknownCommandExamples: examples,\n    unknownCommandNextSteps: [\n      'Run \"pm --help\" to list commands available in this runtime, including active extensions.',\n      \"Use one of the suggested command paths above with --help to inspect valid flags and usage.\",\n    ],\n  };\n}\n\nexport function resolveChildCommandByToken(parent: Command, token: string): Command | undefined {\n  const normalizedToken = token.trim().toLowerCase();\n  return parent.commands.find((candidate) => {\n    if (candidate.name().trim().toLowerCase() === normalizedToken) {\n      return true;\n    }\n    const aliases = typeof candidate.aliases === \"function\" ? candidate.aliases() : [];\n    return aliases.some((alias) => alias.trim().toLowerCase() === normalizedToken);\n  });\n}\n\nexport function isKnownHelpCommandPath(root: Command, commandPathTokens: string[]): boolean {\n  if (commandPathTokens.length === 0) {\n    return true;\n  }\n  let current = root;\n  let matchedAny = false;\n  for (const token of commandPathTokens) {\n    const next = resolveChildCommandByToken(current, token);\n    if (!next) {\n      return matchedAny;\n    }\n    matchedAny = true;\n    current = next;\n  }\n  return matchedAny;\n}\n\nexport async function resolveCommanderUsageContext(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<CommanderUsageContext> {\n  const rawMessage = typeof error === \"object\" && error !== null ? (error as { message?: string }).message : undefined;\n  const message = rawMessage ?? \"Invalid command usage\";\n  const invocationArgv = normalizeBootstrapInvocation(process.argv.slice(2)).argv;\n  const bootstrapGlobal = parseBootstrapGlobalOptions(invocationArgv);\n  const commandName = parseBootstrapCommandName(invocationArgv);\n  const attemptedCommand = renderAttemptedCommand(invocationArgv);\n  const providedOptionFlags = extractProvidedOptionFlags(invocationArgv);\n  let allowedTypes = BUILTIN_TYPE_HELP_VALUES;\n  try {\n    const pmRoot = resolvePmRoot(process.cwd(), bootstrapGlobal.path);\n    if (await pathExists(getSettingsPath(pmRoot))) {\n      const settings = await readSettings(pmRoot);\n      const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n      if (typeRegistry.types.length > 0) {\n        allowedTypes = typeRegistry.types.join(\"|\");\n      }\n    }\n  } catch {\n    // Fall back to built-in type guidance when settings cannot be read.\n  }\n  const unknownCommandGuidance = buildUnknownCommandGuidanceFromRuntime(message, rootProgram, extensionDescriptors);\n  const unknownOptionMatch = message.match(/unknown option '([^']+)'/i);\n  const unknownOptionSuggestions =\n    unknownOptionMatch && commandName\n      ? suggestNearestLongFlags(unknownOptionMatch[1], collectKnownLongFlags(commandName))\n      : undefined;\n  let suggestedRetryCommand: string | undefined;\n  if (unknownOptionMatch && unknownOptionSuggestions && unknownOptionSuggestions.length > 0) {\n    const rewritten = rewriteUnknownOptionArgv(invocationArgv, unknownOptionMatch[1], unknownOptionSuggestions[0]);\n    if (rewritten) {\n      suggestedRetryCommand = renderAttemptedCommand(rewritten);\n    }\n  }\n  if (!suggestedRetryCommand) {\n    const missingRequiredOption = message.match(/required option '([^']+)' not specified/i);\n    const requiredOptionToken = missingRequiredOption?.[1]?.trim().split(/\\s+/)[0]?.replace(/[,:;]+$/g, \"\");\n    if (requiredOptionToken?.startsWith(\"--\")) {\n      const hasFlag = invocationArgv.some((token) => token.startsWith(requiredOptionToken));\n      if (!hasFlag) {\n        suggestedRetryCommand = renderAttemptedCommand([...invocationArgv, requiredOptionToken, \"<value>\"]);\n      }\n    }\n  }\n  return {\n    message,\n    commandName,\n    allowedTypes,\n    attemptedCommand,\n    normalizedInvocationArgs: [...invocationArgv],\n    providedOptionFlags,\n    unknownOptionSuggestions,\n    suggestedRetryCommand,\n    ...(unknownCommandGuidance ?? {}),\n  };\n}\n\nexport async function formatCommanderUsageMessage(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<string> {\n  const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors);\n  const {\n    message,\n    commandName,\n    allowedTypes,\n    unknownCommandExamples,\n    unknownCommandNextSteps,\n    attemptedCommand,\n    normalizedInvocationArgs,\n    providedOptionFlags,\n    unknownOptionSuggestions,\n    suggestedRetryCommand,\n  } = usageContext;\n  const formatted = formatCommanderErrorForDisplay(message, commandName, allowedTypes, {\n    unknownCommandExamples,\n    unknownCommandNextSteps,\n    attemptedCommand,\n    normalizedInvocationArgs,\n    providedOptionFlags,\n    unknownOptionSuggestions,\n    suggestedRetryCommand,\n  });\n  const serviceOverride = await runActiveServiceOverride(\"help_format\", {\n    message: formatted,\n    command: commandName,\n    allowed_types: allowedTypes,\n  });\n  if (serviceOverride.handled && typeof serviceOverride.result === \"string\") {\n    return serviceOverride.result;\n  }\n  return formatted;\n}\n\nexport async function formatCommanderUsageJson(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<string> {\n  const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors);\n  const envelope = formatCommanderErrorForJson(\n    usageContext.message,\n    usageContext.commandName,\n    usageContext.allowedTypes,\n    EXIT_CODE.USAGE,\n    {\n      unknownCommandExamples: usageContext.unknownCommandExamples,\n      unknownCommandNextSteps: usageContext.unknownCommandNextSteps,\n      attemptedCommand: usageContext.attemptedCommand,\n      normalizedInvocationArgs: usageContext.normalizedInvocationArgs,\n      providedOptionFlags: usageContext.providedOptionFlags,\n      unknownOptionSuggestions: usageContext.unknownOptionSuggestions,\n      suggestedRetryCommand: usageContext.suggestedRetryCommand,\n    },\n  );\n  return JSON.stringify(envelope, null, 2);\n}\n"]}

package/dist/cli/commands/completion.js

@@ -154,7 +154,7 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         `      COMPREPLY=(${compgen("--criterion --clear-criteria --format --policy --json --quiet --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    extension)",
-        `      COMPREPLY=(${compgen("init scaffold install uninstall explore manage doctor adopt adopt-all activate deactivate --init --scaffold --install --uninstall --explore --manage --doctor --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --strict-exit --fail-on-warn --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("init scaffold install uninstall explore manage reload doctor adopt adopt-all activate deactivate --init --scaffold --install --uninstall --explore --manage --reload --watch --doctor --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --strict-exit --fail-on-warn --json --quiet --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    comments)",
         `      COMPREPLY=(${compgen("--add --stdin --file --limit --author --message --allow-audit-comment --force --json --quiet --path --no-extensions --no-pager --profile --help")})`,
@@ -909,13 +909,15 @@ _pm() {
           ;;
         extension)
           _arguments \\
-            '1:extension_action:(init scaffold install uninstall explore manage doctor adopt adopt-all activate deactivate)' \\
+            '1:extension_action:(init scaffold install uninstall explore manage reload doctor adopt adopt-all activate deactivate)' \\
             '--init[Generate a starter extension scaffold at target path]' \\
             '--scaffold[Alias for --init]' \\
             '--install[Install extension from local path or GitHub source]' \\
             '--uninstall[Uninstall extension by name]' \\
             '--explore[List discovered extensions for selected scope]' \\
             '--manage[List managed extensions with update metadata]' \\
+            '--reload[Reload extensions with cache-busted module imports]' \\
+            '--watch[Enable watch mode with --reload]' \\
             '--doctor[Run consolidated extension diagnostics (summary/deep)]' \\
             '--adopt[Adopt an unmanaged extension into managed metadata]' \\
             '--adopt-all[Adopt all unmanaged extensions into managed metadata]' \\
@@ -1490,13 +1492,15 @@ complete -c pm -n '__fish_seen_subcommand_from completion' -a 'bash zsh fish' -d
 complete -c pm -n '__fish_seen_subcommand_from templates' -a 'save list show' -d 'Templates command'
 
 # extension lifecycle flags
-complete -c pm -n '__fish_seen_subcommand_from extension' -a 'init scaffold install uninstall explore manage doctor adopt adopt-all activate deactivate' -d 'Extension action subcommand'
+complete -c pm -n '__fish_seen_subcommand_from extension' -a 'init scaffold install uninstall explore manage reload doctor adopt adopt-all activate deactivate' -d 'Extension action subcommand'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l init -d 'Generate starter extension scaffold'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l scaffold -d 'Alias for --init'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l install -d 'Install extension from local path or GitHub source'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l uninstall -d 'Uninstall extension by name'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l explore -d 'List discovered extensions for selected scope'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l manage -d 'List managed extensions with update metadata'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l reload -d 'Reload extensions with cache-busted module imports'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l watch -d 'Enable watch mode with --reload'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l doctor -d 'Run consolidated extension diagnostics'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l adopt -d 'Adopt an unmanaged extension into managed metadata'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l adopt-all -d 'Adopt all unmanaged extensions into managed metadata'