@unbrained/pm-cli 2026.7.11 → 2026.7.12

package/dist/cli/extension-command-help.d.ts

@@ -70,10 +70,22 @@ export interface HelpOptionSummary {
 }
 /** Implements normalize extension command path for the public runtime surface of this module. */
 export declare function normalizeExtensionCommandPath(commandPath: string): string;
+/** Build verified flattened-alias mappings within one extension and layer. */
+export declare function buildCanonicalExtensionAliases(handlers: ReadonlyArray<{
+    command: string;
+    layer: "project" | "global";
+    name: string;
+}>, definitions: ReadonlyArray<{
+    command: string;
+    layer: "project" | "global";
+    name: string;
+}>): Map<string, string>;
+/** Resolve whether a registered extension flag consumes a value. */
+export declare function extensionFlagTakesValueForInvocation(invocationArgv: string[], commandName: string | undefined, normalizedMissing: string | undefined, descriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>): boolean | undefined;
 /** Implements collect dynamic extension flag help by command for the public runtime surface of this module. */
 export declare function collectDynamicExtensionFlagHelpByCommand(registrations: RegisteredExtensionFlagDefinitions[]): Map<string, string>;
 /** Implements collect extension command help descriptors for the public runtime surface of this module. */
-export declare function collectExtensionCommandHelpDescriptors(commandHandlers: string[], commandDefinitions: RegisteredExtensionCommandDefinition[], flagRegistrations: RegisteredExtensionFlagDefinitions[]): Map<string, ExtensionCommandHelpDescriptor>;
+export declare function collectExtensionCommandHelpDescriptors(commandHandlers: string[], commandDefinitions: RegisteredExtensionCommandDefinition[], flagRegistrations: RegisteredExtensionFlagDefinitions[], canonicalAliases?: ReadonlyMap<string, string>): Map<string, ExtensionCommandHelpDescriptor>;
 /** Implements apply dynamic extension arguments for the public runtime surface of this module. */
 export declare function applyDynamicExtensionArguments(command: Command, descriptor: ExtensionCommandHelpDescriptor): void;
 /** Implements apply dynamic extension flag options for the public runtime surface of this module. */

package/dist/cli/extension-command-help.js

@@ -1,6 +1,6 @@
 /** Implements normalize extension command path for the public runtime surface of this module. */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="93c1fe71-1d1e-597f-82c3-9c34089e9196")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1e6b6cdc-855a-5090-a7bd-36d47c55295e")}catch(e){}}();
 export function normalizeExtensionCommandPath(commandPath) {
     return commandPath
         .trim()
@@ -9,6 +9,68 @@ export function normalizeExtensionCommandPath(commandPath) {
         .filter((part) => part.length > 0)
         .join(" ");
 }
+/** Build verified flattened-alias mappings within one extension and layer. */
+export function buildCanonicalExtensionAliases(handlers, definitions) {
+    const aliases = new Map();
+    for (const handler of handlers) {
+        const alias = normalizeExtensionCommandPath(handler.command);
+        for (const definition of definitions) {
+            if (definition.layer !== handler.layer ||
+                definition.name !== handler.name) {
+                continue;
+            }
+            const canonical = normalizeExtensionCommandPath(definition.command);
+            const parts = canonical.split(" ");
+            const action = parts.at(-1);
+            const suffix = parts.slice(1).join(" ");
+            const expectedAlias = suffix
+                ? `${parts[0]}-${action} ${suffix}`
+                : `${parts[0]}-${action}`;
+            if (action &&
+                alias === expectedAlias) {
+                aliases.set(alias, canonical);
+                break;
+            }
+        }
+    }
+    return aliases;
+}
+/** Resolve whether a registered extension flag consumes a value. */
+export function extensionFlagTakesValueForInvocation(invocationArgv, commandName, normalizedMissing, descriptors) {
+    if (!commandName || !normalizedMissing) {
+        return undefined;
+    }
+    let descriptor;
+    let matchedTokenCount = 0;
+    for (const [index, token] of invocationArgv.entries()) {
+        if (token !== commandName) {
+            continue;
+        }
+        const commandTokens = invocationArgv.slice(index);
+        for (const [path, candidate] of descriptors.entries()) {
+            const pathTokens = path.split(" ");
+            if (pathTokens.length > matchedTokenCount &&
+                pathTokens.every((pathToken, pathIndex) => commandTokens[pathIndex] === pathToken)) {
+                descriptor = candidate;
+                matchedTokenCount = pathTokens.length;
+            }
+        }
+    }
+    const flag = descriptor?.flags.find((candidate) => candidate.long === normalizedMissing ||
+        candidate.short === normalizedMissing);
+    if (!flag) {
+        return undefined;
+    }
+    const valueName = typeof flag.value_name === "string" && flag.value_name.trim().length > 0;
+    const valueType = typeof flag.value_type === "string"
+        ? flag.value_type
+        : typeof flag.type === "string"
+            ? flag.type
+            : undefined;
+    return (flag.required === true ||
+        valueName ||
+        (valueType !== undefined && valueType !== "boolean"));
+}
 function toNonEmptyFlagString(value) {
     if (typeof value !== "string") {
         return null;
@@ -190,19 +252,31 @@ function collectExtensionHelpCommandSet(commandHandlers, definitionsByCommand, f
     }
     return commandSet;
 }
+/** Resolve the canonical nested command behind an auto-generated flattened
+ * extension alias such as `csv-export export` -> `csv export`. Package authors
+ * should not have to duplicate command metadata merely because a compatibility
+ * alias was registered by the host package. */
+function resolveFlattenedAliasDescriptor(commandPath, definitionsByCommand, canonicalAliases) {
+    const canonical = canonicalAliases.get(commandPath);
+    return canonical ? definitionsByCommand.get(canonical) : undefined;
+}
 /** Implements collect extension command help descriptors for the public runtime surface of this module. */
-export function collectExtensionCommandHelpDescriptors(commandHandlers, commandDefinitions, flagRegistrations) {
+export function collectExtensionCommandHelpDescriptors(commandHandlers, commandDefinitions, flagRegistrations, canonicalAliases = new Map()) {
     const definitionsByCommand = collectExtensionDefinitionsByCommand(commandDefinitions);
     const flagsByCommand = collectExtensionFlagsByCommand(flagRegistrations);
     const commandSet = collectExtensionHelpCommandSet(commandHandlers, definitionsByCommand, flagsByCommand);
     const descriptors = new Map();
     const sortedCommands = [...commandSet].sort((left, right) => left.localeCompare(right));
     for (const commandPath of sortedCommands) {
-        const definition = definitionsByCommand.get(commandPath);
-        const flags = flagsByCommand.get(commandPath) ?? [];
+        const definition = definitionsByCommand.get(commandPath) ??
+            resolveFlattenedAliasDescriptor(commandPath, definitionsByCommand, canonicalAliases);
+        const flags = flagsByCommand.get(commandPath) ??
+            (definition ? flagsByCommand.get(definition.command) : undefined) ??
+            [];
         if (definition) {
             descriptors.set(commandPath, {
                 ...definition,
+                command: commandPath,
                 flags,
             });
             continue;
@@ -482,4 +556,4 @@ export function ensureCommandPath(root, pathParts) {
     return current;
 }
 //# sourceMappingURL=extension-command-help.js.map
-//# debugId=93c1fe71-1d1e-597f-82c3-9c34089e9196
+//# debugId=1e6b6cdc-855a-5090-a7bd-36d47c55295e

package/dist/cli/extension-command-help.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension-command-help.js","sources":["cli/extension-command-help.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/extension-command-help\n *\n * Provides CLI runtime support for Extension Command Help.\n */\nimport { Command } from \"commander\";\nimport type {\n  RegisteredExtensionCommandDefinition,\n  RegisteredExtensionFlagDefinitions,\n} from \"../core/extensions/index.js\";\n\n/** Documents the extension command argument help descriptor payload exchanged by command, SDK, and package integrations. */\nexport interface ExtensionCommandArgumentHelpDescriptor {\n  /** Value that configures or reports name for this contract. */\n  name: string;\n  /** Value that configures or reports required for this contract. */\n  required: boolean;\n  /** Value that configures or reports variadic for this contract. */\n  variadic: boolean;\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n}\n\n/** Documents the extension command help descriptor payload exchanged by command, SDK, and package integrations. */\nexport interface ExtensionCommandHelpDescriptor {\n  /** Value that configures or reports command for this contract. */\n  command: string;\n  /** Value that configures or reports action for this contract. */\n  action: string;\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Value that configures or reports intent for this contract. */\n  intent?: string;\n  /** Value that configures or reports examples for this contract. */\n  examples: string[];\n  /** Value that configures or reports failure hints for this contract. */\n  failure_hints: string[];\n  /** Value that configures or reports arguments for this contract. */\n  arguments: ExtensionCommandArgumentHelpDescriptor[];\n  /** Value that configures or reports flags for this contract. */\n  flags: Array<Record<string, unknown>>;\n  /** Value that configures or reports source for this contract. */\n  source?: {\n    layer: \"global\" | \"project\";\n    name: string;\n    package?: string;\n  };\n}\n\n/** Documents the help option summary payload exchanged by command, SDK, and package integrations. */\nexport interface HelpOptionSummary {\n  /** Value that configures or reports flags for this contract. */\n  flags: string;\n  /** Value that configures or reports long for this contract. */\n  long: string | null;\n  /** Value that configures or reports short for this contract. */\n  short: string | null;\n  /** Value that configures or reports description for this contract. */\n  description: string;\n  /** Value that configures or reports takes value for this contract. */\n  takes_value: boolean;\n  /** Value that configures or reports value required for this contract. */\n  value_required: boolean;\n  /** Value that configures or reports value name for this contract. */\n  value_name: string | null;\n  /** Value that configures or reports variadic for this contract. */\n  variadic: boolean;\n  /** Value that configures or reports required for this contract. */\n  required: boolean;\n  /** Value that configures or reports aliases for this contract. */\n  aliases: string[];\n  /** Value that configures or reports alias for for this contract. */\n  alias_for: string | null;\n  /** Fallback value used when callers do not provide an override. */\n  default_value?: unknown;\n}\n\n/** Implements normalize extension command path for the public runtime surface of this module. */\nexport function normalizeExtensionCommandPath(commandPath: string): string {\n  return commandPath\n    .trim()\n    .toLowerCase()\n    .split(/\\s+/)\n    .filter((part) => part.length > 0)\n    .join(\" \");\n}\n\nfunction toNonEmptyFlagString(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction toOptionalBoolean(value: unknown): boolean | undefined {\n  return typeof value === \"boolean\" ? value : undefined;\n}\n\nfunction formatDynamicExtensionFlagHelpLine(\n  definition: Record<string, unknown>,\n): string | null {\n  const visible = toOptionalBoolean(definition.visible);\n  if (visible === false) {\n    return null;\n  }\n  const longName = toNonEmptyFlagString(definition.long);\n  if (!longName || !longName.startsWith(\"--\") || longName.length < 3) {\n    return null;\n  }\n\n  const shortName = toNonEmptyFlagString(definition.short);\n  const shortPrefix =\n    shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\")\n      ? `${shortName}, `\n      : \"\";\n  const valueName = toNonEmptyFlagString(definition.value_name);\n  const valueSuffix = valueName ? ` <${valueName}>` : \"\";\n  const description =\n    toNonEmptyFlagString(definition.description) ??\n    \"Extension-provided option.\";\n  const markers: string[] = [];\n  if (toOptionalBoolean(definition.required) === true) {\n    markers.push(\"required\");\n  }\n  if (toOptionalBoolean(definition.enabled) === false) {\n    markers.push(\"disabled\");\n  }\n  const markerSuffix = markers.length > 0 ? ` [${markers.join(\", \")}]` : \"\";\n  return `${shortPrefix}${longName}${valueSuffix}  ${description}${markerSuffix}`;\n}\n\nfunction buildDynamicExtensionFlagHelp(\n  definitions: Array<Record<string, unknown>>,\n): string | null {\n  const lines = [\n    ...new Set(\n      definitions\n        .map(formatDynamicExtensionFlagHelpLine)\n        .filter((line): line is string => line !== null),\n    ),\n  ].sort((left, right) => left.localeCompare(right));\n  if (lines.length === 0) {\n    return null;\n  }\n  return `\\nExtension-provided flags:\\n  ${lines.join(\"\\n  \")}`;\n}\n\n/** Implements collect dynamic extension flag help by command for the public runtime surface of this module. */\nexport function collectDynamicExtensionFlagHelpByCommand(\n  registrations: RegisteredExtensionFlagDefinitions[],\n): Map<string, string> {\n  const grouped = new Map<string, Array<Record<string, unknown>>>();\n  for (const registration of registrations) {\n    const commandPath = normalizeExtensionCommandPath(\n      registration.target_command,\n    );\n    if (commandPath.length === 0) {\n      continue;\n    }\n    const existing = grouped.get(commandPath) ?? [];\n    existing.push(...registration.flags);\n    grouped.set(commandPath, existing);\n  }\n\n  const entries = [...grouped.entries()].sort(([left], [right]) =>\n    left.localeCompare(right),\n  );\n  const helpByCommand = new Map<string, string>();\n  for (const [commandPath, definitions] of entries) {\n    const helpText = buildDynamicExtensionFlagHelp(definitions);\n    if (!helpText) {\n      continue;\n    }\n    helpByCommand.set(commandPath, helpText);\n  }\n  return helpByCommand;\n}\n\nfunction normalizeExtensionCommandAction(\n  commandPath: string,\n  action: string | undefined,\n): string {\n  if (typeof action !== \"string\" || action.trim().length === 0) {\n    return commandPath.replace(/\\s+/g, \"-\");\n  }\n  return action.trim().toLowerCase();\n}\n\nfunction normalizeExtensionCommandStringList(\n  values: string[] | undefined,\n): string[] {\n  if (!Array.isArray(values)) {\n    return [];\n  }\n  const normalized: string[] = [];\n  const seen = new Set<string>();\n  for (const value of values) {\n    if (typeof value !== \"string\") {\n      continue;\n    }\n    const trimmed = value.trim();\n    if (trimmed.length === 0 || seen.has(trimmed)) {\n      continue;\n    }\n    seen.add(trimmed);\n    normalized.push(trimmed);\n  }\n  return normalized;\n}\n\nfunction normalizeExtensionCommandArguments(\n  values:\n    | Array<{\n        name?: unknown;\n        required?: unknown;\n        variadic?: unknown;\n        description?: unknown;\n      }>\n    | undefined,\n): ExtensionCommandArgumentHelpDescriptor[] {\n  if (!Array.isArray(values)) {\n    return [];\n  }\n  return values\n    .map((value) => {\n      const name = typeof value.name === \"string\" ? value.name.trim() : \"\";\n      if (name.length === 0) {\n        return null;\n      }\n      const normalized: ExtensionCommandArgumentHelpDescriptor = {\n        name,\n        required: value.required === true,\n        variadic: value.variadic === true,\n      };\n      if (\n        typeof value.description === \"string\" &&\n        value.description.trim().length > 0\n      ) {\n        normalized.description = value.description.trim();\n      }\n      return normalized;\n    })\n    .filter(\n      (entry): entry is ExtensionCommandArgumentHelpDescriptor =>\n        entry !== null,\n    );\n}\n\nfunction collectExtensionDefinitionsByCommand(\n  commandDefinitions: RegisteredExtensionCommandDefinition[],\n): Map<string, ExtensionCommandHelpDescriptor> {\n  const definitionsByCommand = new Map<\n    string,\n    ExtensionCommandHelpDescriptor\n  >();\n  for (const definition of commandDefinitions) {\n    const commandPath = normalizeExtensionCommandPath(definition.command);\n    if (commandPath.length === 0) {\n      continue;\n    }\n    const description =\n      typeof definition.description === \"string\" &&\n      definition.description.trim().length > 0\n        ? definition.description.trim()\n        : undefined;\n    const intent =\n      typeof definition.intent === \"string\" &&\n      definition.intent.trim().length > 0\n        ? definition.intent.trim()\n        : undefined;\n    definitionsByCommand.set(commandPath, {\n      command: commandPath,\n      action: normalizeExtensionCommandAction(commandPath, definition.action),\n      description,\n      intent,\n      examples: normalizeExtensionCommandStringList(definition.examples),\n      failure_hints: normalizeExtensionCommandStringList(\n        definition.failure_hints,\n      ),\n      arguments: normalizeExtensionCommandArguments(definition.arguments),\n      flags: [],\n      source: {\n        layer: definition.layer,\n        name: definition.name,\n        package: definition.source_package,\n      },\n    });\n  }\n  return definitionsByCommand;\n}\n\nfunction collectExtensionFlagsByCommand(\n  flagRegistrations: RegisteredExtensionFlagDefinitions[],\n): Map<string, Array<Record<string, unknown>>> {\n  const flagsByCommand = new Map<string, Array<Record<string, unknown>>>();\n  for (const registration of flagRegistrations) {\n    const commandPath = normalizeExtensionCommandPath(\n      registration.target_command,\n    );\n    if (commandPath.length === 0) {\n      continue;\n    }\n    const existing = flagsByCommand.get(commandPath) ?? [];\n    existing.push(...registration.flags);\n    flagsByCommand.set(commandPath, existing);\n  }\n  return flagsByCommand;\n}\n\nfunction collectExtensionHelpCommandSet(\n  commandHandlers: string[],\n  definitionsByCommand: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n  flagsByCommand: ReadonlyMap<string, Array<Record<string, unknown>>>,\n): Set<string> {\n  const commandSet = new Set<string>();\n  for (const commandPath of commandHandlers) {\n    const normalized = normalizeExtensionCommandPath(commandPath);\n    if (normalized.length > 0) {\n      commandSet.add(normalized);\n    }\n  }\n  for (const commandPath of definitionsByCommand.keys()) {\n    commandSet.add(commandPath);\n  }\n  for (const commandPath of flagsByCommand.keys()) {\n    commandSet.add(commandPath);\n  }\n  return commandSet;\n}\n\n/** Implements collect extension command help descriptors for the public runtime surface of this module. */\nexport function collectExtensionCommandHelpDescriptors(\n  commandHandlers: string[],\n  commandDefinitions: RegisteredExtensionCommandDefinition[],\n  flagRegistrations: RegisteredExtensionFlagDefinitions[],\n): Map<string, ExtensionCommandHelpDescriptor> {\n  const definitionsByCommand =\n    collectExtensionDefinitionsByCommand(commandDefinitions);\n  const flagsByCommand = collectExtensionFlagsByCommand(flagRegistrations);\n  const commandSet = collectExtensionHelpCommandSet(\n    commandHandlers,\n    definitionsByCommand,\n    flagsByCommand,\n  );\n  const descriptors = new Map<string, ExtensionCommandHelpDescriptor>();\n  const sortedCommands = [...commandSet].sort((left, right) =>\n    left.localeCompare(right),\n  );\n  for (const commandPath of sortedCommands) {\n    const definition = definitionsByCommand.get(commandPath);\n    const flags = flagsByCommand.get(commandPath) ?? [];\n    if (definition) {\n      descriptors.set(commandPath, {\n        ...definition,\n        flags,\n      });\n      continue;\n    }\n    descriptors.set(commandPath, {\n      command: commandPath,\n      action: normalizeExtensionCommandAction(commandPath, undefined),\n      examples: [],\n      failure_hints: [],\n      arguments: [],\n      flags,\n    });\n  }\n\n  return descriptors;\n}\n\nfunction buildExtensionArgumentToken(\n  argument: ExtensionCommandArgumentHelpDescriptor,\n): string {\n  const variadicSuffix = argument.variadic ? \"...\" : \"\";\n  if (argument.required) {\n    return `<${argument.name}${variadicSuffix}>`;\n  }\n  return `[${argument.name}${variadicSuffix}]`;\n}\n\n/** Implements apply dynamic extension arguments for the public runtime surface of this module. */\nexport function applyDynamicExtensionArguments(\n  command: Command,\n  descriptor: ExtensionCommandHelpDescriptor,\n): void {\n  for (const argument of descriptor.arguments) {\n    command.argument(\n      buildExtensionArgumentToken(argument),\n      argument.description ?? \"Extension argument.\",\n    );\n  }\n}\n\nfunction normalizeDynamicExtensionOptionNames(\n  definition: Record<string, unknown>,\n): string[] | null {\n  const visible = toOptionalBoolean(definition.visible);\n  if (visible === false) {\n    return null;\n  }\n  const longName = toNonEmptyFlagString(definition.long);\n  const shortName = toNonEmptyFlagString(definition.short);\n  const normalizedShort =\n    shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\")\n      ? shortName\n      : null;\n  const normalizedLong =\n    longName && longName.startsWith(\"--\") && longName.length > 2\n      ? longName\n      : null;\n  const optionNames = [normalizedShort, normalizedLong].filter(\n    (entry): entry is string => entry !== null,\n  );\n  return optionNames.length > 0 ? optionNames : null;\n}\n\nfunction formatDynamicExtensionOptionFlags(\n  definition: Record<string, unknown>,\n): string | null {\n  const optionNames = normalizeDynamicExtensionOptionNames(definition);\n  if (!optionNames) {\n    return null;\n  }\n  const optionValueName = toNonEmptyFlagString(definition.value_name);\n  const optionValueSuffix = optionValueName ? ` <${optionValueName}>` : \"\";\n  return `${optionNames.join(\", \")}${optionValueSuffix}`;\n}\n\nfunction formatDynamicExtensionParseOptionFlags(\n  definition: Record<string, unknown>,\n): string | null {\n  const optionNames = normalizeDynamicExtensionOptionNames(definition);\n  if (!optionNames) {\n    return null;\n  }\n  const valueType =\n    toNonEmptyFlagString(definition.value_type) ??\n    toNonEmptyFlagString(definition.type);\n  const valueName = toNonEmptyFlagString(definition.value_name);\n  const requiresValue =\n    valueType !== \"boolean\" &&\n    (valueName !== null ||\n      valueType !== null ||\n      toOptionalBoolean(definition.required) === true);\n  const valueSuffix = requiresValue ? ` <${valueName ?? \"value\"}>` : \"\";\n  return `${optionNames.join(\", \")}${valueSuffix}`;\n}\n\nfunction formatDynamicExtensionOptionDescription(\n  definition: Record<string, unknown>,\n): string {\n  const description =\n    toNonEmptyFlagString(definition.description) ??\n    \"Extension-provided option.\";\n  const markers: string[] = [];\n  if (toOptionalBoolean(definition.required) === true) {\n    markers.push(\"required\");\n  }\n  if (toOptionalBoolean(definition.enabled) === false) {\n    markers.push(\"disabled\");\n  }\n  const markerSuffix = markers.length > 0 ? ` [${markers.join(\", \")}]` : \"\";\n  return `${description}${markerSuffix}`;\n}\n\nfunction commandAlreadyHasOption(\n  command: Command,\n  definition: Record<string, unknown>,\n): boolean {\n  const longName = toNonEmptyFlagString(definition.long);\n  const shortName = toNonEmptyFlagString(definition.short);\n  return command.options.some((option) => {\n    const optionWithNames = option as { long?: string; short?: string };\n    return (\n      (longName !== null && optionWithNames.long === longName) ||\n      (shortName !== null && optionWithNames.short === shortName)\n    );\n  });\n}\n\n/** Implements apply dynamic extension flag options for the public runtime surface of this module. */\nexport function applyDynamicExtensionFlagOptions(\n  command: Command,\n  definitions: Array<Record<string, unknown>>,\n): void {\n  for (const definition of definitions) {\n    if (commandAlreadyHasOption(command, definition)) {\n      continue;\n    }\n    const flags = formatDynamicExtensionParseOptionFlags(definition);\n    if (!flags) {\n      continue;\n    }\n    command.option(flags, formatDynamicExtensionOptionDescription(definition));\n  }\n}\n\n/**\n * Builds the \"Extension-provided flags\" help block for only the definitions that\n * are NOT already rendered as real commander options on {@link command}. After\n * {@link applyDynamicExtensionFlagOptions} registers extension flags as first\n * class options, repeating them verbatim in an after-text block duplicated every\n * flag in `--help` output; this filters those already-listed flags out so the\n * block is emitted only when it carries flags the Options section does not.\n */\nexport function buildResidualDynamicExtensionFlagHelp(\n  command: Command,\n  definitions: Array<Record<string, unknown>>,\n): string | null {\n  return buildDynamicExtensionFlagHelp(\n    definitions.filter(\n      (definition) => !commandAlreadyHasOption(command, definition),\n    ),\n  );\n}\n\nfunction buildDynamicExtensionHelpOptionSummary(\n  definition: Record<string, unknown>,\n): HelpOptionSummary | null {\n  const flags = formatDynamicExtensionOptionFlags(definition);\n  if (!flags) {\n    return null;\n  }\n  const longName = toNonEmptyFlagString(definition.long);\n  const shortName = toNonEmptyFlagString(definition.short);\n  const normalizedLong =\n    longName && longName.startsWith(\"--\") && longName.length > 2\n      ? longName\n      : null;\n  const normalizedShort =\n    shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\")\n      ? shortName\n      : null;\n  const valueName = toNonEmptyFlagString(definition.value_name);\n  const required = toOptionalBoolean(definition.required) === true;\n  return {\n    flags,\n    long: normalizedLong,\n    short: normalizedShort,\n    description: formatDynamicExtensionOptionDescription(definition),\n    takes_value: valueName !== null,\n    value_required: valueName !== null,\n    value_name: valueName,\n    variadic: false,\n    required,\n    aliases: [],\n    alias_for: null,\n  };\n}\n\n/** Implements build dynamic extension help option summaries for the public runtime surface of this module. */\nexport function buildDynamicExtensionHelpOptionSummaries(\n  descriptor: ExtensionCommandHelpDescriptor | undefined,\n): HelpOptionSummary[] {\n  if (!descriptor) {\n    return [];\n  }\n  const summaries: HelpOptionSummary[] = [];\n  const seen = new Set<string>();\n  for (const definition of descriptor.flags) {\n    const summary = buildDynamicExtensionHelpOptionSummary(definition);\n    if (!summary || seen.has(summary.flags)) {\n      continue;\n    }\n    seen.add(summary.flags);\n    summaries.push(summary);\n  }\n  return summaries;\n}\n\n/** Implements merge help option summaries for the public runtime surface of this module. */\nexport function mergeHelpOptionSummaries(\n  base: HelpOptionSummary[],\n  extension: HelpOptionSummary[],\n): HelpOptionSummary[] {\n  if (extension.length === 0) {\n    return base;\n  }\n  const merged = [...base];\n  const seen = new Set(base.map((entry) => entry.flags));\n  for (const entry of extension) {\n    if (seen.has(entry.flags)) {\n      continue;\n    }\n    seen.add(entry.flags);\n    merged.push(entry);\n  }\n  return merged;\n}\n\n/** Implements build dynamic extension command metadata help for the public runtime surface of this module. */\nexport function buildDynamicExtensionCommandMetadataHelp(\n  descriptor: ExtensionCommandHelpDescriptor,\n): string | null {\n  const lines: string[] = [];\n  if (descriptor.intent) {\n    lines.push(`Intent: ${descriptor.intent}`);\n  }\n  if (descriptor.action) {\n    lines.push(`Action contract: ${descriptor.action}`);\n  }\n  if (descriptor.examples.length > 0) {\n    lines.push(\"Examples:\");\n    for (const example of descriptor.examples) {\n      lines.push(`  - ${example}`);\n    }\n  }\n  if (descriptor.failure_hints.length > 0) {\n    lines.push(\"Common failure hints:\");\n    for (const hint of descriptor.failure_hints) {\n      lines.push(`  - ${hint}`);\n    }\n  }\n  if (lines.length === 0) {\n    return null;\n  }\n  return `\\nExtension command metadata:\\n  ${lines.join(\"\\n  \")}`;\n}\n\n/** Implements command aliases for the public runtime surface of this module. */\nexport function commandAliases(command: Command): string[] {\n  const commandRecord = command as unknown as {\n    aliases?: () => string[];\n    alias?: () => string | undefined;\n    _aliases?: string[];\n  };\n  if (typeof commandRecord.aliases === \"function\") {\n    return commandRecord\n      .aliases()\n      .map((value) => value.trim().toLowerCase())\n      .filter((value) => value.length > 0);\n  }\n  if (typeof commandRecord.alias === \"function\") {\n    const alias = commandRecord.alias();\n    if (typeof alias === \"string\" && alias.trim().length > 0) {\n      return [alias.trim().toLowerCase()];\n    }\n  }\n  if (Array.isArray(commandRecord._aliases)) {\n    return commandRecord._aliases\n      .map((value) => value.trim().toLowerCase())\n      .filter((value) => value.length > 0);\n  }\n  return [];\n}\n\n/** Implements find direct child command for the public runtime surface of this module. */\nexport function findDirectChildCommand(\n  parent: Command,\n  name: string,\n): Command | null {\n  const normalizedTarget = name.trim().toLowerCase();\n  return (\n    parent.commands.find((entry) => {\n      if (entry.name().trim().toLowerCase() === normalizedTarget) {\n        return true;\n      }\n      return commandAliases(entry).includes(normalizedTarget);\n    }) ?? null\n  );\n}\n\n/** Implements find command by path for the public runtime surface of this module. */\nexport function findCommandByPath(\n  root: Command,\n  pathParts: string[],\n): Command | null {\n  let current: Command = root;\n  for (const part of pathParts) {\n    const next = findDirectChildCommand(current, part);\n    if (!next) {\n      return null;\n    }\n    current = next;\n  }\n  return current;\n}\n\n/** Implements ensure command path for the public runtime surface of this module. */\nexport function ensureCommandPath(\n  root: Command,\n  pathParts: string[],\n): Command | null {\n  if (pathParts.length === 0) {\n    return null;\n  }\n\n  let current: Command = root;\n  for (let index = 0; index < pathParts.length; index += 1) {\n    const part = pathParts[index];\n    const existing = findDirectChildCommand(current, part);\n    if (existing) {\n      current = existing;\n      continue;\n    }\n\n    const created = current.command(part);\n    if (index < pathParts.length - 1) {\n      created.description(\"Extension-provided command group.\");\n      // Without a handler, commander routes bare-group help through the error\n      // channel, which the root configureOutput intentionally swallows — the\n      // group would exit 0 in silence. Render help on stdout instead so agents\n      // always get subcommand discovery. A later terminal registration for the\n      // same path replaces this handler via Command.action().\n      created.action(() => {\n        created.help();\n      });\n    } else {\n      created.description(\"Extension-provided command path.\");\n    }\n    current = created;\n  }\n\n  return current;\n}\n"],"names":[],"mappings":"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","debugId":"93c1fe71-1d1e-597f-82c3-9c34089e9196"}
+{"version":3,"file":"extension-command-help.js","sources":["cli/extension-command-help.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/extension-command-help\n *\n * Provides CLI runtime support for Extension Command Help.\n */\nimport { Command } from \"commander\";\nimport type {\n  RegisteredExtensionCommandDefinition,\n  RegisteredExtensionFlagDefinitions,\n} from \"../core/extensions/index.js\";\n\n/** Documents the extension command argument help descriptor payload exchanged by command, SDK, and package integrations. */\nexport interface ExtensionCommandArgumentHelpDescriptor {\n  /** Value that configures or reports name for this contract. */\n  name: string;\n  /** Value that configures or reports required for this contract. */\n  required: boolean;\n  /** Value that configures or reports variadic for this contract. */\n  variadic: boolean;\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n}\n\n/** Documents the extension command help descriptor payload exchanged by command, SDK, and package integrations. */\nexport interface ExtensionCommandHelpDescriptor {\n  /** Value that configures or reports command for this contract. */\n  command: string;\n  /** Value that configures or reports action for this contract. */\n  action: string;\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Value that configures or reports intent for this contract. */\n  intent?: string;\n  /** Value that configures or reports examples for this contract. */\n  examples: string[];\n  /** Value that configures or reports failure hints for this contract. */\n  failure_hints: string[];\n  /** Value that configures or reports arguments for this contract. */\n  arguments: ExtensionCommandArgumentHelpDescriptor[];\n  /** Value that configures or reports flags for this contract. */\n  flags: Array<Record<string, unknown>>;\n  /** Value that configures or reports source for this contract. */\n  source?: {\n    layer: \"global\" | \"project\";\n    name: string;\n    package?: string;\n  };\n}\n\n/** Documents the help option summary payload exchanged by command, SDK, and package integrations. */\nexport interface HelpOptionSummary {\n  /** Value that configures or reports flags for this contract. */\n  flags: string;\n  /** Value that configures or reports long for this contract. */\n  long: string | null;\n  /** Value that configures or reports short for this contract. */\n  short: string | null;\n  /** Value that configures or reports description for this contract. */\n  description: string;\n  /** Value that configures or reports takes value for this contract. */\n  takes_value: boolean;\n  /** Value that configures or reports value required for this contract. */\n  value_required: boolean;\n  /** Value that configures or reports value name for this contract. */\n  value_name: string | null;\n  /** Value that configures or reports variadic for this contract. */\n  variadic: boolean;\n  /** Value that configures or reports required for this contract. */\n  required: boolean;\n  /** Value that configures or reports aliases for this contract. */\n  aliases: string[];\n  /** Value that configures or reports alias for for this contract. */\n  alias_for: string | null;\n  /** Fallback value used when callers do not provide an override. */\n  default_value?: unknown;\n}\n\n/** Implements normalize extension command path for the public runtime surface of this module. */\nexport function normalizeExtensionCommandPath(commandPath: string): string {\n  return commandPath\n    .trim()\n    .toLowerCase()\n    .split(/\\s+/)\n    .filter((part) => part.length > 0)\n    .join(\" \");\n}\n\n/** Build verified flattened-alias mappings within one extension and layer. */\nexport function buildCanonicalExtensionAliases(\n  handlers: ReadonlyArray<{\n    command: string;\n    layer: \"project\" | \"global\";\n    name: string;\n  }>,\n  definitions: ReadonlyArray<{\n    command: string;\n    layer: \"project\" | \"global\";\n    name: string;\n  }>,\n): Map<string, string> {\n  const aliases = new Map<string, string>();\n  for (const handler of handlers) {\n    const alias = normalizeExtensionCommandPath(handler.command);\n    for (const definition of definitions) {\n      if (\n        definition.layer !== handler.layer ||\n        definition.name !== handler.name\n      ) {\n        continue;\n      }\n      const canonical = normalizeExtensionCommandPath(definition.command);\n      const parts = canonical.split(\" \");\n      const action = parts.at(-1);\n      const suffix = parts.slice(1).join(\" \");\n      const expectedAlias = suffix\n        ? `${parts[0]}-${action} ${suffix}`\n        : `${parts[0]}-${action}`;\n      if (\n        action &&\n        alias === expectedAlias\n      ) {\n        aliases.set(alias, canonical);\n        break;\n      }\n    }\n  }\n  return aliases;\n}\n\n/** Resolve whether a registered extension flag consumes a value. */\nexport function extensionFlagTakesValueForInvocation(\n  invocationArgv: string[],\n  commandName: string | undefined,\n  normalizedMissing: string | undefined,\n  descriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): boolean | undefined {\n  if (!commandName || !normalizedMissing) {\n    return undefined;\n  }\n  let descriptor: ExtensionCommandHelpDescriptor | undefined;\n  let matchedTokenCount = 0;\n  for (const [index, token] of invocationArgv.entries()) {\n    if (token !== commandName) {\n      continue;\n    }\n    const commandTokens = invocationArgv.slice(index);\n    for (const [path, candidate] of descriptors.entries()) {\n      const pathTokens = path.split(\" \");\n      if (\n        pathTokens.length > matchedTokenCount &&\n        pathTokens.every(\n          (pathToken, pathIndex) => commandTokens[pathIndex] === pathToken,\n        )\n      ) {\n        descriptor = candidate;\n        matchedTokenCount = pathTokens.length;\n      }\n    }\n  }\n  const flag = descriptor?.flags.find(\n    (candidate) =>\n      candidate.long === normalizedMissing ||\n      candidate.short === normalizedMissing,\n  );\n  if (!flag) {\n    return undefined;\n  }\n  const valueName =\n    typeof flag.value_name === \"string\" && flag.value_name.trim().length > 0;\n  const valueType =\n    typeof flag.value_type === \"string\"\n      ? flag.value_type\n      : typeof flag.type === \"string\"\n        ? flag.type\n        : undefined;\n  return (\n    flag.required === true ||\n    valueName ||\n    (valueType !== undefined && valueType !== \"boolean\")\n  );\n}\n\nfunction toNonEmptyFlagString(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction toOptionalBoolean(value: unknown): boolean | undefined {\n  return typeof value === \"boolean\" ? value : undefined;\n}\n\nfunction formatDynamicExtensionFlagHelpLine(\n  definition: Record<string, unknown>,\n): string | null {\n  const visible = toOptionalBoolean(definition.visible);\n  if (visible === false) {\n    return null;\n  }\n  const longName = toNonEmptyFlagString(definition.long);\n  if (!longName || !longName.startsWith(\"--\") || longName.length < 3) {\n    return null;\n  }\n\n  const shortName = toNonEmptyFlagString(definition.short);\n  const shortPrefix =\n    shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\")\n      ? `${shortName}, `\n      : \"\";\n  const valueName = toNonEmptyFlagString(definition.value_name);\n  const valueSuffix = valueName ? ` <${valueName}>` : \"\";\n  const description =\n    toNonEmptyFlagString(definition.description) ??\n    \"Extension-provided option.\";\n  const markers: string[] = [];\n  if (toOptionalBoolean(definition.required) === true) {\n    markers.push(\"required\");\n  }\n  if (toOptionalBoolean(definition.enabled) === false) {\n    markers.push(\"disabled\");\n  }\n  const markerSuffix = markers.length > 0 ? ` [${markers.join(\", \")}]` : \"\";\n  return `${shortPrefix}${longName}${valueSuffix}  ${description}${markerSuffix}`;\n}\n\nfunction buildDynamicExtensionFlagHelp(\n  definitions: Array<Record<string, unknown>>,\n): string | null {\n  const lines = [\n    ...new Set(\n      definitions\n        .map(formatDynamicExtensionFlagHelpLine)\n        .filter((line): line is string => line !== null),\n    ),\n  ].sort((left, right) => left.localeCompare(right));\n  if (lines.length === 0) {\n    return null;\n  }\n  return `\\nExtension-provided flags:\\n  ${lines.join(\"\\n  \")}`;\n}\n\n/** Implements collect dynamic extension flag help by command for the public runtime surface of this module. */\nexport function collectDynamicExtensionFlagHelpByCommand(\n  registrations: RegisteredExtensionFlagDefinitions[],\n): Map<string, string> {\n  const grouped = new Map<string, Array<Record<string, unknown>>>();\n  for (const registration of registrations) {\n    const commandPath = normalizeExtensionCommandPath(\n      registration.target_command,\n    );\n    if (commandPath.length === 0) {\n      continue;\n    }\n    const existing = grouped.get(commandPath) ?? [];\n    existing.push(...registration.flags);\n    grouped.set(commandPath, existing);\n  }\n\n  const entries = [...grouped.entries()].sort(([left], [right]) =>\n    left.localeCompare(right),\n  );\n  const helpByCommand = new Map<string, string>();\n  for (const [commandPath, definitions] of entries) {\n    const helpText = buildDynamicExtensionFlagHelp(definitions);\n    if (!helpText) {\n      continue;\n    }\n    helpByCommand.set(commandPath, helpText);\n  }\n  return helpByCommand;\n}\n\nfunction normalizeExtensionCommandAction(\n  commandPath: string,\n  action: string | undefined,\n): string {\n  if (typeof action !== \"string\" || action.trim().length === 0) {\n    return commandPath.replace(/\\s+/g, \"-\");\n  }\n  return action.trim().toLowerCase();\n}\n\nfunction normalizeExtensionCommandStringList(\n  values: string[] | undefined,\n): string[] {\n  if (!Array.isArray(values)) {\n    return [];\n  }\n  const normalized: string[] = [];\n  const seen = new Set<string>();\n  for (const value of values) {\n    if (typeof value !== \"string\") {\n      continue;\n    }\n    const trimmed = value.trim();\n    if (trimmed.length === 0 || seen.has(trimmed)) {\n      continue;\n    }\n    seen.add(trimmed);\n    normalized.push(trimmed);\n  }\n  return normalized;\n}\n\nfunction normalizeExtensionCommandArguments(\n  values:\n    | Array<{\n        name?: unknown;\n        required?: unknown;\n        variadic?: unknown;\n        description?: unknown;\n      }>\n    | undefined,\n): ExtensionCommandArgumentHelpDescriptor[] {\n  if (!Array.isArray(values)) {\n    return [];\n  }\n  return values\n    .map((value) => {\n      const name = typeof value.name === \"string\" ? value.name.trim() : \"\";\n      if (name.length === 0) {\n        return null;\n      }\n      const normalized: ExtensionCommandArgumentHelpDescriptor = {\n        name,\n        required: value.required === true,\n        variadic: value.variadic === true,\n      };\n      if (\n        typeof value.description === \"string\" &&\n        value.description.trim().length > 0\n      ) {\n        normalized.description = value.description.trim();\n      }\n      return normalized;\n    })\n    .filter(\n      (entry): entry is ExtensionCommandArgumentHelpDescriptor =>\n        entry !== null,\n    );\n}\n\nfunction collectExtensionDefinitionsByCommand(\n  commandDefinitions: RegisteredExtensionCommandDefinition[],\n): Map<string, ExtensionCommandHelpDescriptor> {\n  const definitionsByCommand = new Map<\n    string,\n    ExtensionCommandHelpDescriptor\n  >();\n  for (const definition of commandDefinitions) {\n    const commandPath = normalizeExtensionCommandPath(definition.command);\n    if (commandPath.length === 0) {\n      continue;\n    }\n    const description =\n      typeof definition.description === \"string\" &&\n      definition.description.trim().length > 0\n        ? definition.description.trim()\n        : undefined;\n    const intent =\n      typeof definition.intent === \"string\" &&\n      definition.intent.trim().length > 0\n        ? definition.intent.trim()\n        : undefined;\n    definitionsByCommand.set(commandPath, {\n      command: commandPath,\n      action: normalizeExtensionCommandAction(commandPath, definition.action),\n      description,\n      intent,\n      examples: normalizeExtensionCommandStringList(definition.examples),\n      failure_hints: normalizeExtensionCommandStringList(\n        definition.failure_hints,\n      ),\n      arguments: normalizeExtensionCommandArguments(definition.arguments),\n      flags: [],\n      source: {\n        layer: definition.layer,\n        name: definition.name,\n        package: definition.source_package,\n      },\n    });\n  }\n  return definitionsByCommand;\n}\n\nfunction collectExtensionFlagsByCommand(\n  flagRegistrations: RegisteredExtensionFlagDefinitions[],\n): Map<string, Array<Record<string, unknown>>> {\n  const flagsByCommand = new Map<string, Array<Record<string, unknown>>>();\n  for (const registration of flagRegistrations) {\n    const commandPath = normalizeExtensionCommandPath(\n      registration.target_command,\n    );\n    if (commandPath.length === 0) {\n      continue;\n    }\n    const existing = flagsByCommand.get(commandPath) ?? [];\n    existing.push(...registration.flags);\n    flagsByCommand.set(commandPath, existing);\n  }\n  return flagsByCommand;\n}\n\nfunction collectExtensionHelpCommandSet(\n  commandHandlers: string[],\n  definitionsByCommand: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n  flagsByCommand: ReadonlyMap<string, Array<Record<string, unknown>>>,\n): Set<string> {\n  const commandSet = new Set<string>();\n  for (const commandPath of commandHandlers) {\n    const normalized = normalizeExtensionCommandPath(commandPath);\n    if (normalized.length > 0) {\n      commandSet.add(normalized);\n    }\n  }\n  for (const commandPath of definitionsByCommand.keys()) {\n    commandSet.add(commandPath);\n  }\n  for (const commandPath of flagsByCommand.keys()) {\n    commandSet.add(commandPath);\n  }\n  return commandSet;\n}\n\n/** Resolve the canonical nested command behind an auto-generated flattened\n * extension alias such as `csv-export export` -> `csv export`. Package authors\n * should not have to duplicate command metadata merely because a compatibility\n * alias was registered by the host package. */\nfunction resolveFlattenedAliasDescriptor(\n  commandPath: string,\n  definitionsByCommand: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n  canonicalAliases: ReadonlyMap<string, string>,\n): ExtensionCommandHelpDescriptor | undefined {\n  const canonical = canonicalAliases.get(commandPath);\n  return canonical ? definitionsByCommand.get(canonical) : undefined;\n}\n\n/** Implements collect extension command help descriptors for the public runtime surface of this module. */\nexport function collectExtensionCommandHelpDescriptors(\n  commandHandlers: string[],\n  commandDefinitions: RegisteredExtensionCommandDefinition[],\n  flagRegistrations: RegisteredExtensionFlagDefinitions[],\n  canonicalAliases: ReadonlyMap<string, string> = new Map(),\n): Map<string, ExtensionCommandHelpDescriptor> {\n  const definitionsByCommand =\n    collectExtensionDefinitionsByCommand(commandDefinitions);\n  const flagsByCommand = collectExtensionFlagsByCommand(flagRegistrations);\n  const commandSet = collectExtensionHelpCommandSet(\n    commandHandlers,\n    definitionsByCommand,\n    flagsByCommand,\n  );\n  const descriptors = new Map<string, ExtensionCommandHelpDescriptor>();\n  const sortedCommands = [...commandSet].sort((left, right) =>\n    left.localeCompare(right),\n  );\n  for (const commandPath of sortedCommands) {\n    const definition =\n      definitionsByCommand.get(commandPath) ??\n      resolveFlattenedAliasDescriptor(\n        commandPath,\n        definitionsByCommand,\n        canonicalAliases,\n      );\n    const flags =\n      flagsByCommand.get(commandPath) ??\n      (definition ? flagsByCommand.get(definition.command) : undefined) ??\n      [];\n    if (definition) {\n      descriptors.set(commandPath, {\n        ...definition,\n        command: commandPath,\n        flags,\n      });\n      continue;\n    }\n    descriptors.set(commandPath, {\n      command: commandPath,\n      action: normalizeExtensionCommandAction(commandPath, undefined),\n      examples: [],\n      failure_hints: [],\n      arguments: [],\n      flags,\n    });\n  }\n\n  return descriptors;\n}\n\nfunction buildExtensionArgumentToken(\n  argument: ExtensionCommandArgumentHelpDescriptor,\n): string {\n  const variadicSuffix = argument.variadic ? \"...\" : \"\";\n  if (argument.required) {\n    return `<${argument.name}${variadicSuffix}>`;\n  }\n  return `[${argument.name}${variadicSuffix}]`;\n}\n\n/** Implements apply dynamic extension arguments for the public runtime surface of this module. */\nexport function applyDynamicExtensionArguments(\n  command: Command,\n  descriptor: ExtensionCommandHelpDescriptor,\n): void {\n  for (const argument of descriptor.arguments) {\n    command.argument(\n      buildExtensionArgumentToken(argument),\n      argument.description ?? \"Extension argument.\",\n    );\n  }\n}\n\nfunction normalizeDynamicExtensionOptionNames(\n  definition: Record<string, unknown>,\n): string[] | null {\n  const visible = toOptionalBoolean(definition.visible);\n  if (visible === false) {\n    return null;\n  }\n  const longName = toNonEmptyFlagString(definition.long);\n  const shortName = toNonEmptyFlagString(definition.short);\n  const normalizedShort =\n    shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\")\n      ? shortName\n      : null;\n  const normalizedLong =\n    longName && longName.startsWith(\"--\") && longName.length > 2\n      ? longName\n      : null;\n  const optionNames = [normalizedShort, normalizedLong].filter(\n    (entry): entry is string => entry !== null,\n  );\n  return optionNames.length > 0 ? optionNames : null;\n}\n\nfunction formatDynamicExtensionOptionFlags(\n  definition: Record<string, unknown>,\n): string | null {\n  const optionNames = normalizeDynamicExtensionOptionNames(definition);\n  if (!optionNames) {\n    return null;\n  }\n  const optionValueName = toNonEmptyFlagString(definition.value_name);\n  const optionValueSuffix = optionValueName ? ` <${optionValueName}>` : \"\";\n  return `${optionNames.join(\", \")}${optionValueSuffix}`;\n}\n\nfunction formatDynamicExtensionParseOptionFlags(\n  definition: Record<string, unknown>,\n): string | null {\n  const optionNames = normalizeDynamicExtensionOptionNames(definition);\n  if (!optionNames) {\n    return null;\n  }\n  const valueType =\n    toNonEmptyFlagString(definition.value_type) ??\n    toNonEmptyFlagString(definition.type);\n  const valueName = toNonEmptyFlagString(definition.value_name);\n  const requiresValue =\n    valueType !== \"boolean\" &&\n    (valueName !== null ||\n      valueType !== null ||\n      toOptionalBoolean(definition.required) === true);\n  const valueSuffix = requiresValue ? ` <${valueName ?? \"value\"}>` : \"\";\n  return `${optionNames.join(\", \")}${valueSuffix}`;\n}\n\nfunction formatDynamicExtensionOptionDescription(\n  definition: Record<string, unknown>,\n): string {\n  const description =\n    toNonEmptyFlagString(definition.description) ??\n    \"Extension-provided option.\";\n  const markers: string[] = [];\n  if (toOptionalBoolean(definition.required) === true) {\n    markers.push(\"required\");\n  }\n  if (toOptionalBoolean(definition.enabled) === false) {\n    markers.push(\"disabled\");\n  }\n  const markerSuffix = markers.length > 0 ? ` [${markers.join(\", \")}]` : \"\";\n  return `${description}${markerSuffix}`;\n}\n\nfunction commandAlreadyHasOption(\n  command: Command,\n  definition: Record<string, unknown>,\n): boolean {\n  const longName = toNonEmptyFlagString(definition.long);\n  const shortName = toNonEmptyFlagString(definition.short);\n  return command.options.some((option) => {\n    const optionWithNames = option as { long?: string; short?: string };\n    return (\n      (longName !== null && optionWithNames.long === longName) ||\n      (shortName !== null && optionWithNames.short === shortName)\n    );\n  });\n}\n\n/** Implements apply dynamic extension flag options for the public runtime surface of this module. */\nexport function applyDynamicExtensionFlagOptions(\n  command: Command,\n  definitions: Array<Record<string, unknown>>,\n): void {\n  for (const definition of definitions) {\n    if (commandAlreadyHasOption(command, definition)) {\n      continue;\n    }\n    const flags = formatDynamicExtensionParseOptionFlags(definition);\n    if (!flags) {\n      continue;\n    }\n    command.option(flags, formatDynamicExtensionOptionDescription(definition));\n  }\n}\n\n/**\n * Builds the \"Extension-provided flags\" help block for only the definitions that\n * are NOT already rendered as real commander options on {@link command}. After\n * {@link applyDynamicExtensionFlagOptions} registers extension flags as first\n * class options, repeating them verbatim in an after-text block duplicated every\n * flag in `--help` output; this filters those already-listed flags out so the\n * block is emitted only when it carries flags the Options section does not.\n */\nexport function buildResidualDynamicExtensionFlagHelp(\n  command: Command,\n  definitions: Array<Record<string, unknown>>,\n): string | null {\n  return buildDynamicExtensionFlagHelp(\n    definitions.filter(\n      (definition) => !commandAlreadyHasOption(command, definition),\n    ),\n  );\n}\n\nfunction buildDynamicExtensionHelpOptionSummary(\n  definition: Record<string, unknown>,\n): HelpOptionSummary | null {\n  const flags = formatDynamicExtensionOptionFlags(definition);\n  if (!flags) {\n    return null;\n  }\n  const longName = toNonEmptyFlagString(definition.long);\n  const shortName = toNonEmptyFlagString(definition.short);\n  const normalizedLong =\n    longName && longName.startsWith(\"--\") && longName.length > 2\n      ? longName\n      : null;\n  const normalizedShort =\n    shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\")\n      ? shortName\n      : null;\n  const valueName = toNonEmptyFlagString(definition.value_name);\n  const required = toOptionalBoolean(definition.required) === true;\n  return {\n    flags,\n    long: normalizedLong,\n    short: normalizedShort,\n    description: formatDynamicExtensionOptionDescription(definition),\n    takes_value: valueName !== null,\n    value_required: valueName !== null,\n    value_name: valueName,\n    variadic: false,\n    required,\n    aliases: [],\n    alias_for: null,\n  };\n}\n\n/** Implements build dynamic extension help option summaries for the public runtime surface of this module. */\nexport function buildDynamicExtensionHelpOptionSummaries(\n  descriptor: ExtensionCommandHelpDescriptor | undefined,\n): HelpOptionSummary[] {\n  if (!descriptor) {\n    return [];\n  }\n  const summaries: HelpOptionSummary[] = [];\n  const seen = new Set<string>();\n  for (const definition of descriptor.flags) {\n    const summary = buildDynamicExtensionHelpOptionSummary(definition);\n    if (!summary || seen.has(summary.flags)) {\n      continue;\n    }\n    seen.add(summary.flags);\n    summaries.push(summary);\n  }\n  return summaries;\n}\n\n/** Implements merge help option summaries for the public runtime surface of this module. */\nexport function mergeHelpOptionSummaries(\n  base: HelpOptionSummary[],\n  extension: HelpOptionSummary[],\n): HelpOptionSummary[] {\n  if (extension.length === 0) {\n    return base;\n  }\n  const merged = [...base];\n  const seen = new Set(base.map((entry) => entry.flags));\n  for (const entry of extension) {\n    if (seen.has(entry.flags)) {\n      continue;\n    }\n    seen.add(entry.flags);\n    merged.push(entry);\n  }\n  return merged;\n}\n\n/** Implements build dynamic extension command metadata help for the public runtime surface of this module. */\nexport function buildDynamicExtensionCommandMetadataHelp(\n  descriptor: ExtensionCommandHelpDescriptor,\n): string | null {\n  const lines: string[] = [];\n  if (descriptor.intent) {\n    lines.push(`Intent: ${descriptor.intent}`);\n  }\n  if (descriptor.action) {\n    lines.push(`Action contract: ${descriptor.action}`);\n  }\n  if (descriptor.examples.length > 0) {\n    lines.push(\"Examples:\");\n    for (const example of descriptor.examples) {\n      lines.push(`  - ${example}`);\n    }\n  }\n  if (descriptor.failure_hints.length > 0) {\n    lines.push(\"Common failure hints:\");\n    for (const hint of descriptor.failure_hints) {\n      lines.push(`  - ${hint}`);\n    }\n  }\n  if (lines.length === 0) {\n    return null;\n  }\n  return `\\nExtension command metadata:\\n  ${lines.join(\"\\n  \")}`;\n}\n\n/** Implements command aliases for the public runtime surface of this module. */\nexport function commandAliases(command: Command): string[] {\n  const commandRecord = command as unknown as {\n    aliases?: () => string[];\n    alias?: () => string | undefined;\n    _aliases?: string[];\n  };\n  if (typeof commandRecord.aliases === \"function\") {\n    return commandRecord\n      .aliases()\n      .map((value) => value.trim().toLowerCase())\n      .filter((value) => value.length > 0);\n  }\n  if (typeof commandRecord.alias === \"function\") {\n    const alias = commandRecord.alias();\n    if (typeof alias === \"string\" && alias.trim().length > 0) {\n      return [alias.trim().toLowerCase()];\n    }\n  }\n  if (Array.isArray(commandRecord._aliases)) {\n    return commandRecord._aliases\n      .map((value) => value.trim().toLowerCase())\n      .filter((value) => value.length > 0);\n  }\n  return [];\n}\n\n/** Implements find direct child command for the public runtime surface of this module. */\nexport function findDirectChildCommand(\n  parent: Command,\n  name: string,\n): Command | null {\n  const normalizedTarget = name.trim().toLowerCase();\n  return (\n    parent.commands.find((entry) => {\n      if (entry.name().trim().toLowerCase() === normalizedTarget) {\n        return true;\n      }\n      return commandAliases(entry).includes(normalizedTarget);\n    }) ?? null\n  );\n}\n\n/** Implements find command by path for the public runtime surface of this module. */\nexport function findCommandByPath(\n  root: Command,\n  pathParts: string[],\n): Command | null {\n  let current: Command = root;\n  for (const part of pathParts) {\n    const next = findDirectChildCommand(current, part);\n    if (!next) {\n      return null;\n    }\n    current = next;\n  }\n  return current;\n}\n\n/** Implements ensure command path for the public runtime surface of this module. */\nexport function ensureCommandPath(\n  root: Command,\n  pathParts: string[],\n): Command | null {\n  if (pathParts.length === 0) {\n    return null;\n  }\n\n  let current: Command = root;\n  for (let index = 0; index < pathParts.length; index += 1) {\n    const part = pathParts[index];\n    const existing = findDirectChildCommand(current, part);\n    if (existing) {\n      current = existing;\n      continue;\n    }\n\n    const created = current.command(part);\n    if (index < pathParts.length - 1) {\n      created.description(\"Extension-provided command group.\");\n      // Without a handler, commander routes bare-group help through the error\n      // channel, which the root configureOutput intentionally swallows — the\n      // group would exit 0 in silence. Render help on stdout instead so agents\n      // always get subcommand discovery. A later terminal registration for the\n      // same path replaces this handler via Command.action().\n      created.action(() => {\n        created.help();\n      });\n    } else {\n      created.description(\"Extension-provided command path.\");\n    }\n    current = created;\n  }\n\n  return current;\n}\n"],"names":[],"mappings":"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","debugId":"1e6b6cdc-855a-5090-a7bd-36d47c55295e"}

package/dist/cli/main.js

@@ -5,7 +5,7 @@
  * Provides CLI runtime support for Main.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b20cc758-3f21-5d8e-99f4-0c85b0fabd20")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="48e267a5-172c-54c9-b398-94eb2971fb5a")}catch(e){}}();
 import { Command } from "commander";
 import { activateExtensions, clearActiveExtensionHooks, createEmptyExtensionRegistrationRegistry, discoverExtensions, getActiveCommandResult, getActiveExtensionRegistrations, loadExtensions, consumeAfterCommandAffectedItems, runActiveCommandHandler, runActiveParserOverride, runActivePreflightOverride, runAfterCommandHooks, runBeforeCommandHooks, setActiveCommandResult, setActiveCommandContext, setActiveExtensionCommands, setActiveExtensionHooks, setActiveExtensionParsers, setActiveExtensionPreflight, setActiveExtensionRegistrations, setActiveExtensionRenderers, setActiveExtensionServices, } from "../core/extensions/index.js";
 import { pathExists } from "../core/fs/fs-utils.js";
@@ -29,7 +29,7 @@ import { extractProvidedOptionFlags, normalizeLongOptionFlag, renderPmCommand, }
 import { classifyCommanderError, classifyPmCliError, classifyUnknownError, formatPmCliErrorForDisplay, formatPmCliErrorForJson, formatUnknownErrorForJson, } from "./error-guidance.js";
 import { applyDefaultOutputFormat, clearResolvedGlobalOptions, collect, formatHookWarnings, getCommandPath, getGlobalOptions, invalidateSearchCachesForMutation, setResolvedGlobalOptions, } from "./registration-helpers.js";
 import { createLazyModule } from "../core/shared/lazy-module.js";
-import { normalizeExtensionCommandPath, collectDynamicExtensionFlagHelpByCommand, collectExtensionCommandHelpDescriptors, applyDynamicExtensionFlagOptions, buildResidualDynamicExtensionFlagHelp, applyDynamicExtensionArguments, buildDynamicExtensionCommandMetadataHelp, findCommandByPath, ensureCommandPath, } from "./extension-command-help.js";
+import { normalizeExtensionCommandPath, collectDynamicExtensionFlagHelpByCommand, collectExtensionCommandHelpDescriptors, applyDynamicExtensionFlagOptions, buildResidualDynamicExtensionFlagHelp, applyDynamicExtensionArguments, buildDynamicExtensionCommandMetadataHelp, findCommandByPath, ensureCommandPath, buildCanonicalExtensionAliases, extensionFlagTakesValueForInvocation, } from "./extension-command-help.js";
 import { parseBootstrapGlobalOptions, applyBootstrapPagerPolicy, parseBootstrapHelpRequest, parseBootstrapCommandName, normalizeBootstrapInvocation, stripGlobalBootstrapTokens, } from "./bootstrap-args.js";
 import { collectMandatoryMigrationBlockers, enforceMandatoryMigrationWriteGate, enforceItemFormatWriteGateAndPreflightMigration, resolveMigrationId, resolveNormalizedMigrationStatus, } from "./migration-gates.js";
 import { isKnownHelpCommandPath, formatCommanderUsageMessage, formatCommanderUsageJson, resolveCommanderUsageContext, } from "./commander-usage.js";
@@ -151,7 +151,8 @@ function inferMissingFieldsFromErrorMessage(message) {
     return normalized.length > 0 ? normalized : undefined;
 }
 function inferMissingFieldsForRecovery(rawMessage, invocationArgv, existingRecovery) {
-    if (existingRecovery?.suggested_retry) {
+    if (existingRecovery?.suggested_retry ||
+        rawMessage.includes("failed in extension handler (")) {
         return undefined;
     }
     const providedFields = extractProvidedOptionFlags(invocationArgv);
@@ -175,8 +176,9 @@ function resolveRecoverySuggestedRetry(invocationArgv, attemptedCommand, inferre
     const missingOption = normalizedMissing
         ? command?.options.find((option) => option.flags.split(/[ ,|]+/).includes(normalizedMissing))
         : undefined;
+    const extensionFlagTakesValue = extensionFlagTakesValueForInvocation(invocationArgv, commandName, normalizedMissing, activeRuntimeExtensionCommandDescriptors);
     const missingTokens = normalizedMissing
-        ? missingOption?.isBoolean() === true
+        ? missingOption?.isBoolean() === true || extensionFlagTakesValue === false
             ? [normalizedMissing]
             : [normalizedMissing, "<value>"]
         : [];
@@ -1152,7 +1154,8 @@ async function loadRuntimeExtensionSnapshot(pmRoot, probe) {
             .filter((entry) => entry.length > 0)
             .sort((left, right) => left.localeCompare(right));
         const commandFlagHelp = collectDynamicExtensionFlagHelpByCommand(activationResult.registrations.flags);
-        const commandDescriptors = collectExtensionCommandHelpDescriptors(commandHandlers, activationResult.registrations.commands, activationResult.registrations.flags);
+        const canonicalAliases = buildCanonicalExtensionAliases(activationResult.commands.handlers, activationResult.registrations.commands);
+        const commandDescriptors = collectExtensionCommandHelpDescriptors(commandHandlers, activationResult.registrations.commands, activationResult.registrations.flags, canonicalAliases);
         const snapshot = {
             hooks: activationResult.hooks,
             commands: activationResult.commands,
@@ -2481,4 +2484,4 @@ export const _testOnly = {
     wrapThrownErrorForSentry,
 };
 //# sourceMappingURL=main.js.map
-//# debugId=b20cc758-3f21-5d8e-99f4-0c85b0fabd20
+//# debugId=48e267a5-172c-54c9-b398-94eb2971fb5a