@unbrained/pm-cli 2026.5.18 → 2026.5.27

package/dist/cli/help-json-payload.js.map

@@ -1 +1 @@
-{"version":3,"file":"help-json-payload.js","sources":["cli/help-json-payload.ts"],"sourceRoot":"/","sourcesContent":["import { Command } from \"commander\";\nimport {\n  commandOptionFlagLabel,\n  resolveCommandOptionPolicyState,\n  resolveItemTypeRegistry,\n  resolveTypeDefinition,\n} from \"../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { printError, writeStdout } from \"../core/output/output.js\";\nimport {\n  type HelpOptionSummary,\n  type ExtensionCommandHelpDescriptor,\n  buildDynamicExtensionHelpOptionSummaries,\n  mergeHelpOptionSummaries,\n  findCommandByPath,\n  findDirectChildCommand,\n  commandAliases,\n} from \"./extension-command-help.js\";\nimport {\n  normalizeHelpCommandPath,\n  resolveHelpDetailMode,\n  resolveHelpNarrative,\n} from \"./help-content.js\";\nimport { getCommandPath } from \"./registration-helpers.js\";\nimport {\n  parseBootstrapGlobalOptions,\n  parseBootstrapHelpRequest,\n  parseBootstrapCommandName,\n  parseBootstrapTypeValue,\n} from \"./bootstrap-args.js\";\nimport { extractProvidedOptionFlags, renderPmCommand } from \"./argv-utils.js\";\nimport { formatCommanderErrorForJson } from \"./error-guidance.js\";\nimport {\n  BUILTIN_TYPE_HELP_VALUES,\n  buildUnknownCommandGuidanceFromRuntime,\n} from \"./commander-usage.js\";\n\nexport interface HelpArgumentSummary {\n  name: string;\n  required: boolean;\n  variadic: boolean;\n  description: string | null;\n}\n\nexport interface HelpSubcommandSummary {\n  name: string;\n  aliases: string[];\n  description: string;\n}\n\nexport function resolveCommandFromPathTokens(root: Command, pathTokens: string[]): Command | null {\n  if (pathTokens.length === 0) {\n    return root;\n  }\n  return findCommandByPath(root, pathTokens);\n}\n\nexport function extractOptionValueName(flags: string): string | null {\n  const match = flags.match(/[<[]([^>\\]]+)[>\\]]/);\n  if (!match) {\n    return null;\n  }\n  const value = match[1]?.trim();\n  return value && value.length > 0 ? value : null;\n}\n\nexport function readOptionAttributeName(option: unknown): string | null {\n  const optionRecord = option as {\n    attributeName?: (() => string) | string;\n  };\n  if (typeof optionRecord.attributeName === \"function\") {\n    const value = optionRecord.attributeName();\n    return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : null;\n  }\n  if (typeof optionRecord.attributeName === \"string\" && optionRecord.attributeName.trim().length > 0) {\n    return optionRecord.attributeName.trim();\n  }\n  return null;\n}\n\nexport function buildOptionAliasMap(options: unknown[]): Map<string, string[]> {\n  const aliasMap = new Map<string, string[]>();\n  for (const option of options) {\n    const optionRecord = option as {\n      long?: string;\n    };\n    const attributeName = readOptionAttributeName(option);\n    if (!attributeName || typeof optionRecord.long !== \"string\" || optionRecord.long.trim().length === 0) {\n      continue;\n    }\n    const existing = aliasMap.get(attributeName) ?? [];\n    existing.push(optionRecord.long.trim());\n    aliasMap.set(attributeName, existing);\n  }\n  for (const [attributeName, values] of aliasMap.entries()) {\n    aliasMap.set(\n      attributeName,\n      [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) =>\n        left.localeCompare(right),\n      ),\n    );\n  }\n  return aliasMap;\n}\n\nfunction renderAttemptedCommand(argv: string[]): string {\n  return renderPmCommand(argv);\n}\n\nexport function buildHelpOptionSummaries(command: Command): HelpOptionSummary[] {\n  const options = (command.options ?? []) as unknown[];\n  const optionAliasMap = buildOptionAliasMap(options);\n  return options.map((option) => {\n    const optionRecord = option as {\n      flags?: string;\n      long?: string;\n      short?: string;\n      description?: string;\n      mandatory?: boolean;\n      variadic?: boolean;\n      defaultValue?: unknown;\n    };\n    const flags = typeof optionRecord.flags === \"string\" ? optionRecord.flags.trim() : \"\";\n    const description = typeof optionRecord.description === \"string\" ? optionRecord.description.trim() : \"\";\n    const attributeName = readOptionAttributeName(option);\n    const aliasCandidates = attributeName ? optionAliasMap.get(attributeName) ?? [] : [];\n    const aliases = aliasCandidates\n      .filter((entry) => entry !== optionRecord.long)\n      .map((entry) => entry.trim())\n      .filter((entry) => entry.length > 0);\n    const aliasForMatch = description.match(/^Alias for ([^ ]+)/i);\n    const aliasFor = aliasForMatch && aliasForMatch[1] ? aliasForMatch[1].trim() : null;\n    const required =\n      optionRecord.mandatory === true || description.includes(\"[required]\") || description.toLowerCase().includes(\"required;\");\n    const valueRequired = flags.includes(\"<\");\n    const takesValue = valueRequired || flags.includes(\"[\");\n    const summary: HelpOptionSummary = {\n      flags,\n      long: typeof optionRecord.long === \"string\" ? optionRecord.long : null,\n      short: typeof optionRecord.short === \"string\" ? optionRecord.short : null,\n      description,\n      takes_value: takesValue,\n      value_required: valueRequired,\n      value_name: extractOptionValueName(flags),\n      variadic: optionRecord.variadic === true,\n      required,\n      aliases,\n      alias_for: aliasFor,\n    };\n    if (optionRecord.defaultValue !== undefined) {\n      summary.default_value = optionRecord.defaultValue;\n    }\n    return summary;\n  });\n}\n\nexport function buildHelpArgumentSummaries(command: Command): HelpArgumentSummary[] {\n  const commandRecord = command as unknown as {\n    registeredArguments?: Array<{\n      name?: (() => string) | string;\n      required?: boolean;\n      variadic?: boolean;\n      description?: string;\n    }>;\n    _args?: Array<{\n      name?: (() => string) | string;\n      required?: boolean;\n      variadic?: boolean;\n      description?: string;\n    }>;\n  };\n  const argumentsList = Array.isArray(commandRecord.registeredArguments)\n    ? commandRecord.registeredArguments\n    : Array.isArray(commandRecord._args)\n      ? commandRecord._args\n      : [];\n\n  return argumentsList.map((argument) => {\n    const rawName =\n      typeof argument.name === \"function\"\n        ? argument.name()\n        : typeof argument.name === \"string\"\n          ? argument.name\n          : \"argument\";\n    const description = typeof argument.description === \"string\" && argument.description.trim().length > 0\n      ? argument.description.trim()\n      : null;\n    return {\n      name: rawName.trim(),\n      required: argument.required === true,\n      variadic: argument.variadic === true,\n      description,\n    };\n  });\n}\n\nexport function buildHelpSubcommandSummaries(command: Command): HelpSubcommandSummary[] {\n  return command.commands\n    .map((entry) => ({\n      name: entry.name().trim(),\n      aliases: commandAliases(entry),\n      description: entry.description().trim(),\n    }))\n    .sort((left, right) => left.name.localeCompare(right.name));\n}\n\nexport function buildJsonHelpPayload(\n  rootProgram: Command,\n  targetCommand: Command,\n  argv: string[],\n  requestedPath: string[],\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Record<string, unknown> {\n  const detailMode = resolveHelpDetailMode(argv);\n  const resolvedPath = normalizeHelpCommandPath(getCommandPath(targetCommand));\n  const commandPath = resolvedPath.length > 0 ? resolvedPath : undefined;\n  const fallbackNarrative = resolveHelpNarrative(commandPath, detailMode);\n  const extensionDescriptor = commandPath ? extensionDescriptors.get(commandPath) : undefined;\n  const extensionExamples = extensionDescriptor?.examples ?? [];\n  const extensionFailureHints = extensionDescriptor?.failure_hints ?? [];\n  const narrative = extensionDescriptor\n    ? {\n        intent: extensionDescriptor.intent ?? extensionDescriptor.description ?? fallbackNarrative.intent,\n        examples:\n          detailMode === \"detailed\"\n            ? extensionExamples.length > 0\n              ? [...extensionExamples]\n              : [...fallbackNarrative.examples]\n            : extensionExamples.length > 0\n              ? [extensionExamples[0]]\n              : [...fallbackNarrative.examples],\n        tips:\n          detailMode === \"detailed\"\n            ? extensionFailureHints.length > 0\n              ? [...extensionFailureHints]\n              : [...fallbackNarrative.tips]\n            : [],\n        detail_mode: detailMode,\n      }\n    : fallbackNarrative;\n  const optionSummaries = mergeHelpOptionSummaries(\n    buildHelpOptionSummaries(targetCommand),\n    buildDynamicExtensionHelpOptionSummaries(extensionDescriptor),\n  );\n  const subcommands = buildHelpSubcommandSummaries(targetCommand);\n  return {\n    format: \"pm_help_v1\",\n    detail_mode: detailMode,\n    root_command: rootProgram.name(),\n    requested_path: requestedPath,\n    resolved_path: resolvedPath.length > 0 ? resolvedPath : rootProgram.name(),\n    description: targetCommand.description(),\n    usage: targetCommand.usage(),\n    intent: narrative.intent,\n    examples: narrative.examples,\n    tips: narrative.tips,\n    arguments: buildHelpArgumentSummaries(targetCommand),\n    options: optionSummaries,\n    subcommands,\n    has_subcommands: subcommands.length > 0,\n  };\n}\n\nexport async function maybeRenderBootstrapJsonHelp(\n  rootProgram: Command,\n  argv: string[],\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<boolean> {\n  const bootstrapGlobal = parseBootstrapGlobalOptions(argv);\n  if (!bootstrapGlobal.json) {\n    return false;\n  }\n  const helpRequest = parseBootstrapHelpRequest(argv);\n  if (!helpRequest.requested) {\n    return false;\n  }\n  const targetCommand = resolveCommandFromPathTokens(rootProgram, helpRequest.commandPathTokens);\n  if (!targetCommand) {\n    if (!bootstrapGlobal.quiet) {\n      const unknownMessage = `unknown command '${helpRequest.commandPathTokens.join(\" \")}'`;\n      const runtimeContext = buildUnknownCommandGuidanceFromRuntime(unknownMessage, rootProgram, extensionDescriptors);\n      const envelope = formatCommanderErrorForJson(\n        unknownMessage,\n        \"help\",\n        BUILTIN_TYPE_HELP_VALUES,\n        EXIT_CODE.USAGE,\n        {\n          ...(runtimeContext ?? {}),\n          attemptedCommand: renderAttemptedCommand(argv),\n          normalizedInvocationArgs: [...argv],\n          providedOptionFlags: extractProvidedOptionFlags(argv),\n        },\n      );\n      printError(JSON.stringify(envelope, null, 2));\n    }\n    process.exitCode = EXIT_CODE.USAGE;\n    return true;\n  }\n  if (!bootstrapGlobal.quiet) {\n    const payload = buildJsonHelpPayload(rootProgram, targetCommand, argv, helpRequest.commandPathTokens, extensionDescriptors);\n    writeStdout(`${JSON.stringify(payload, null, 2)}\\n`);\n  }\n  process.exitCode = EXIT_CODE.SUCCESS;\n  return true;\n}\n\nexport function buildCreateUpdatePolicyHelpText(\n  commandName: \"create\" | \"update\",\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>,\n  argv: string[],\n): string {\n  const selectedTypeRaw = parseBootstrapTypeValue(argv);\n  if (!selectedTypeRaw) {\n    const allowed = typeRegistry.types.join(\"|\");\n    const lines = [\n      \"\",\n      \"Type-aware option policies:\",\n      \"  pass --type <value> with --help to render required/disabled/hidden option policy details for that type.\",\n      `  active type values: ${allowed}`,\n    ];\n    if (commandName === \"create\") {\n      lines.push(\n        \"  scheduling shortcut: use --schedule-preset lightweight for Reminder/Meeting/Event minimal create flows.\",\n      );\n    }\n    return lines.join(\"\\n\");\n  }\n\n  const typeDefinition = resolveTypeDefinition(selectedTypeRaw, typeRegistry);\n  if (!typeDefinition) {\n    const allowed = typeRegistry.types.join(\"|\");\n    return [\n      \"\",\n      `Type-aware option policies: type \"${selectedTypeRaw}\" is not in the active registry.`,\n      `  active type values: ${allowed}`,\n    ].join(\"\\n\");\n  }\n\n  const baseRequired =\n    commandName === \"create\"\n      ? new Set<string>([\"title\", \"description\", \"type\", ...typeDefinition.required_create_fields, ...typeDefinition.required_create_repeatables])\n      : new Set<string>();\n  const policyState = resolveCommandOptionPolicyState(typeDefinition, commandName, baseRequired);\n  const toFlags = (options: string[]): string =>\n    options.length > 0 ? options.map((option) => commandOptionFlagLabel(commandName, option)).join(\", \") : \"none\";\n\n  const lines = [\n    \"\",\n    `Type-aware option policies for ${typeDefinition.name}:`,\n    `  required: ${toFlags(policyState.required)}`,\n    `  disabled: ${toFlags(policyState.disabled)}`,\n    `  hidden: ${toFlags(policyState.hidden)}`,\n  ];\n  if (commandName === \"create\" && [\"Reminder\", \"Meeting\", \"Event\"].includes(typeDefinition.name)) {\n    lines.push(\n      \"  schedule preset: --schedule-preset lightweight switches schedule artifacts to progressive required-option policy.\",\n    );\n    lines.push(\"  strict parity remains available via --create-mode strict.\");\n  }\n  if (typeDefinition.options.length === 0) {\n    lines.push(\"  type options: none\");\n  } else {\n    lines.push(\"  type options:\");\n    for (const option of typeDefinition.options) {\n      const requiredLabel = option.required ? \" (required)\" : \"\";\n      const aliases = option.aliases ?? [];\n      lines.push(`    - ${option.key}${requiredLabel}`);\n      lines.push(`      values: ${option.values.length > 0 ? option.values.join(\"|\") : \"any non-empty string\"}`);\n      lines.push(`      aliases: ${aliases.length > 0 ? aliases.join(\"|\") : \"none\"}`);\n      if (option.description && option.description.trim().length > 0) {\n        lines.push(`      description: ${option.description.trim()}`);\n      }\n    }\n  }\n  if (policyState.errors.length > 0) {\n    lines.push(`  config errors: ${policyState.errors.join(\"; \")}`);\n  }\n  return lines.join(\"\\n\");\n}\n\nexport function attachCreateUpdatePolicyHelpText(\n  rootProgram: Command,\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>,\n  argv: string[],\n): void {\n  const bootstrapCommand = parseBootstrapCommandName(argv);\n  if (bootstrapCommand !== \"create\" && bootstrapCommand !== \"update\") {\n    return;\n  }\n  const command = findDirectChildCommand(rootProgram, bootstrapCommand);\n  if (!command) {\n    return;\n  }\n  command.addHelpText(\"after\", buildCreateUpdatePolicyHelpText(bootstrapCommand, typeRegistry, argv));\n}\n"],"names":[],"mappings":"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","debugId":"49c2174d-1221-5026-b8ae-5dfab9778c90"}
+{"version":3,"file":"help-json-payload.js","sources":["cli/help-json-payload.ts"],"sourceRoot":"/","sourcesContent":["import { Command } from \"commander\";\nimport {\n  commandOptionFlagLabel,\n  resolveCommandOptionPolicyState,\n  resolveItemTypeRegistry,\n  resolveTypeDefinition,\n} from \"../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { printError, writeStdout } from \"../core/output/output.js\";\nimport {\n  type HelpOptionSummary,\n  type ExtensionCommandHelpDescriptor,\n  buildDynamicExtensionHelpOptionSummaries,\n  mergeHelpOptionSummaries,\n  findCommandByPath,\n  findDirectChildCommand,\n  commandAliases,\n} from \"./extension-command-help.js\";\nimport {\n  normalizeHelpCommandPath,\n  resolveHelpDetailMode,\n  resolveHelpNarrative,\n} from \"./help-content.js\";\nimport { getCommandPath } from \"./registration-helpers.js\";\nimport {\n  parseBootstrapGlobalOptions,\n  parseBootstrapHelpRequest,\n  parseBootstrapCommandName,\n  parseBootstrapTypeValue,\n} from \"./bootstrap-args.js\";\nimport { extractProvidedOptionFlags, renderPmCommand } from \"./argv-utils.js\";\nimport { formatCommanderErrorForJson } from \"./error-guidance.js\";\nimport {\n  BUILTIN_TYPE_HELP_VALUES,\n  buildUnknownCommandGuidanceFromRuntime,\n} from \"./commander-usage.js\";\n\nexport interface HelpArgumentSummary {\n  name: string;\n  required: boolean;\n  variadic: boolean;\n  description: string | null;\n}\n\nexport interface HelpSubcommandSummary {\n  name: string;\n  aliases: string[];\n  description: string;\n}\n\nexport function resolveCommandFromPathTokens(root: Command, pathTokens: string[]): Command | null {\n  if (pathTokens.length === 0) {\n    return root;\n  }\n  return findCommandByPath(root, pathTokens);\n}\n\nexport function extractOptionValueName(flags: string): string | null {\n  const match = flags.match(/[<[]([^>\\]]+)[>\\]]/);\n  if (!match) {\n    return null;\n  }\n  const value = match[1]?.trim();\n  return value && value.length > 0 ? value : null;\n}\n\nexport function readOptionAttributeName(option: unknown): string | null {\n  const optionRecord = option as {\n    attributeName?: (() => string) | string;\n  };\n  if (typeof optionRecord.attributeName === \"function\") {\n    const value = optionRecord.attributeName();\n    return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : null;\n  }\n  if (typeof optionRecord.attributeName === \"string\" && optionRecord.attributeName.trim().length > 0) {\n    return optionRecord.attributeName.trim();\n  }\n  return null;\n}\n\nexport function buildOptionAliasMap(options: unknown[]): Map<string, string[]> {\n  const aliasMap = new Map<string, string[]>();\n  for (const option of options) {\n    const optionRecord = option as {\n      long?: string;\n    };\n    const attributeName = readOptionAttributeName(option);\n    if (!attributeName || typeof optionRecord.long !== \"string\" || optionRecord.long.trim().length === 0) {\n      continue;\n    }\n    const existing = aliasMap.get(attributeName) ?? [];\n    existing.push(optionRecord.long.trim());\n    aliasMap.set(attributeName, existing);\n  }\n  for (const [attributeName, values] of aliasMap.entries()) {\n    aliasMap.set(\n      attributeName,\n      [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) =>\n        left.localeCompare(right),\n      ),\n    );\n  }\n  return aliasMap;\n}\n\nfunction renderAttemptedCommand(argv: string[]): string {\n  return renderPmCommand(argv);\n}\n\nexport function buildHelpOptionSummaries(command: Command): HelpOptionSummary[] {\n  const options = (command.options ?? []) as unknown[];\n  const optionAliasMap = buildOptionAliasMap(options);\n  return options.map((option) => {\n    const optionRecord = option as {\n      flags?: string;\n      long?: string;\n      short?: string;\n      description?: string;\n      mandatory?: boolean;\n      variadic?: boolean;\n      defaultValue?: unknown;\n    };\n    const flags = typeof optionRecord.flags === \"string\" ? optionRecord.flags.trim() : \"\";\n    const description = typeof optionRecord.description === \"string\" ? optionRecord.description.trim() : \"\";\n    const attributeName = readOptionAttributeName(option);\n    const aliasCandidates = attributeName ? optionAliasMap.get(attributeName) ?? [] : [];\n    const aliases = aliasCandidates\n      .filter((entry) => entry !== optionRecord.long)\n      .map((entry) => entry.trim())\n      .filter((entry) => entry.length > 0);\n    const aliasForMatch = description.match(/^Alias for ([^ ]+)/i);\n    const aliasFor = aliasForMatch && aliasForMatch[1] ? aliasForMatch[1].trim() : null;\n    const required =\n      optionRecord.mandatory === true || description.includes(\"[required]\") || description.toLowerCase().includes(\"required;\");\n    const valueRequired = flags.includes(\"<\");\n    const takesValue = valueRequired || flags.includes(\"[\");\n    const summary: HelpOptionSummary = {\n      flags,\n      long: typeof optionRecord.long === \"string\" ? optionRecord.long : null,\n      short: typeof optionRecord.short === \"string\" ? optionRecord.short : null,\n      description,\n      takes_value: takesValue,\n      value_required: valueRequired,\n      value_name: extractOptionValueName(flags),\n      variadic: optionRecord.variadic === true,\n      required,\n      aliases,\n      alias_for: aliasFor,\n    };\n    if (optionRecord.defaultValue !== undefined) {\n      summary.default_value = optionRecord.defaultValue;\n    }\n    return summary;\n  });\n}\n\nexport function compactHelpOptionAliases(options: HelpOptionSummary[]): HelpOptionSummary[] {\n  const canonicalByLong = new Map<string, HelpOptionSummary>();\n  const aliasOptions: HelpOptionSummary[] = [];\n  for (const option of options) {\n    if (option.alias_for && option.long) {\n      aliasOptions.push(option);\n      continue;\n    }\n    if (option.long) {\n      canonicalByLong.set(option.long, option);\n    }\n  }\n  for (const aliasOption of aliasOptions) {\n    if (!aliasOption.alias_for || !aliasOption.long) {\n      continue;\n    }\n    const canonical = canonicalByLong.get(aliasOption.alias_for);\n    if (!canonical) {\n      continue;\n    }\n    const aliases = new Set([...(canonical.aliases ?? []), aliasOption.long]);\n    canonical.aliases = [...aliases].sort((left, right) => left.localeCompare(right));\n  }\n  return options.filter((option) => {\n    if (!option.alias_for || !option.long) {\n      return true;\n    }\n    return !canonicalByLong.has(option.alias_for);\n  });\n}\n\nexport function buildHelpArgumentSummaries(command: Command): HelpArgumentSummary[] {\n  const commandRecord = command as unknown as {\n    registeredArguments?: Array<{\n      name?: (() => string) | string;\n      required?: boolean;\n      variadic?: boolean;\n      description?: string;\n    }>;\n    _args?: Array<{\n      name?: (() => string) | string;\n      required?: boolean;\n      variadic?: boolean;\n      description?: string;\n    }>;\n  };\n  const argumentsList = Array.isArray(commandRecord.registeredArguments)\n    ? commandRecord.registeredArguments\n    : Array.isArray(commandRecord._args)\n      ? commandRecord._args\n      : [];\n\n  return argumentsList.map((argument) => {\n    const rawName =\n      typeof argument.name === \"function\"\n        ? argument.name()\n        : typeof argument.name === \"string\"\n          ? argument.name\n          : \"argument\";\n    const description = typeof argument.description === \"string\" && argument.description.trim().length > 0\n      ? argument.description.trim()\n      : null;\n    return {\n      name: rawName.trim(),\n      required: argument.required === true,\n      variadic: argument.variadic === true,\n      description,\n    };\n  });\n}\n\nexport function buildHelpSubcommandSummaries(command: Command): HelpSubcommandSummary[] {\n  return command.commands\n    .map((entry) => ({\n      name: entry.name().trim(),\n      aliases: commandAliases(entry),\n      description: entry.description().trim(),\n    }))\n    .sort((left, right) => left.name.localeCompare(right.name));\n}\n\nexport function buildJsonHelpPayload(\n  rootProgram: Command,\n  targetCommand: Command,\n  argv: string[],\n  requestedPath: string[],\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Record<string, unknown> {\n  const detailMode = resolveHelpDetailMode(argv);\n  const resolvedPath = normalizeHelpCommandPath(getCommandPath(targetCommand));\n  const commandPath = resolvedPath.length > 0 ? resolvedPath : undefined;\n  const fallbackNarrative = resolveHelpNarrative(commandPath, detailMode);\n  const extensionDescriptor = commandPath ? extensionDescriptors.get(commandPath) : undefined;\n  const extensionExamples = extensionDescriptor?.examples ?? [];\n  const extensionFailureHints = extensionDescriptor?.failure_hints ?? [];\n  const narrative = extensionDescriptor\n    ? {\n        intent: extensionDescriptor.intent ?? extensionDescriptor.description ?? fallbackNarrative.intent,\n        examples:\n          detailMode === \"detailed\"\n            ? extensionExamples.length > 0\n              ? [...extensionExamples]\n              : [...fallbackNarrative.examples]\n            : extensionExamples.length > 0\n              ? [extensionExamples[0]]\n              : [...fallbackNarrative.examples],\n        tips:\n          detailMode === \"detailed\"\n            ? extensionFailureHints.length > 0\n              ? [...extensionFailureHints]\n              : [...fallbackNarrative.tips]\n            : [],\n        detail_mode: detailMode,\n      }\n    : fallbackNarrative;\n  const optionSummaries = compactHelpOptionAliases(\n    mergeHelpOptionSummaries(\n      buildHelpOptionSummaries(targetCommand),\n      buildDynamicExtensionHelpOptionSummaries(extensionDescriptor),\n    ),\n  );\n  const subcommands = buildHelpSubcommandSummaries(targetCommand);\n  return {\n    format: \"pm_help_v1\",\n    detail_mode: detailMode,\n    root_command: rootProgram.name(),\n    requested_path: requestedPath,\n    resolved_path: resolvedPath.length > 0 ? resolvedPath : rootProgram.name(),\n    description: targetCommand.description(),\n    usage: targetCommand.usage(),\n    intent: narrative.intent,\n    examples: narrative.examples,\n    tips: narrative.tips,\n    arguments: buildHelpArgumentSummaries(targetCommand),\n    options: optionSummaries,\n    subcommands,\n    has_subcommands: subcommands.length > 0,\n  };\n}\n\nexport async function maybeRenderBootstrapJsonHelp(\n  rootProgram: Command,\n  argv: string[],\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<boolean> {\n  const bootstrapGlobal = parseBootstrapGlobalOptions(argv);\n  if (!bootstrapGlobal.json) {\n    return false;\n  }\n  const helpRequest = parseBootstrapHelpRequest(argv);\n  if (!helpRequest.requested) {\n    return false;\n  }\n  const targetCommand = resolveCommandFromPathTokens(rootProgram, helpRequest.commandPathTokens);\n  if (!targetCommand) {\n    if (!bootstrapGlobal.quiet) {\n      const unknownMessage = `unknown command '${helpRequest.commandPathTokens.join(\" \")}'`;\n      const runtimeContext = buildUnknownCommandGuidanceFromRuntime(unknownMessage, rootProgram, extensionDescriptors);\n      const envelope = formatCommanderErrorForJson(\n        unknownMessage,\n        \"help\",\n        BUILTIN_TYPE_HELP_VALUES,\n        EXIT_CODE.USAGE,\n        {\n          ...(runtimeContext ?? {}),\n          attemptedCommand: renderAttemptedCommand(argv),\n          normalizedInvocationArgs: [...argv],\n          providedOptionFlags: extractProvidedOptionFlags(argv),\n        },\n      );\n      printError(JSON.stringify(envelope, null, 2));\n    }\n    process.exitCode = EXIT_CODE.USAGE;\n    return true;\n  }\n  if (!bootstrapGlobal.quiet) {\n    const payload = buildJsonHelpPayload(rootProgram, targetCommand, argv, helpRequest.commandPathTokens, extensionDescriptors);\n    writeStdout(`${JSON.stringify(payload, null, 2)}\\n`);\n  }\n  process.exitCode = EXIT_CODE.SUCCESS;\n  return true;\n}\n\nexport function buildCreateUpdatePolicyHelpText(\n  commandName: \"create\" | \"update\",\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>,\n  argv: string[],\n): string {\n  const selectedTypeRaw = parseBootstrapTypeValue(argv);\n  if (!selectedTypeRaw) {\n    const allowed = typeRegistry.types.join(\"|\");\n    const lines = [\n      \"\",\n      \"Type-aware option policies:\",\n      \"  pass --type <value> with --help to render required/disabled/hidden option policy details for that type.\",\n      `  active type values: ${allowed}`,\n    ];\n    if (commandName === \"create\") {\n      lines.push(\n        \"  scheduling shortcut: use --schedule-preset lightweight for Reminder/Meeting/Event minimal create flows.\",\n      );\n    }\n    return lines.join(\"\\n\");\n  }\n\n  const typeDefinition = resolveTypeDefinition(selectedTypeRaw, typeRegistry);\n  if (!typeDefinition) {\n    const allowed = typeRegistry.types.join(\"|\");\n    return [\n      \"\",\n      `Type-aware option policies: type \"${selectedTypeRaw}\" is not in the active registry.`,\n      `  active type values: ${allowed}`,\n    ].join(\"\\n\");\n  }\n\n  const baseRequired =\n    commandName === \"create\"\n      ? new Set<string>([\"title\", \"description\", \"type\", ...typeDefinition.required_create_fields, ...typeDefinition.required_create_repeatables])\n      : new Set<string>();\n  const policyState = resolveCommandOptionPolicyState(typeDefinition, commandName, baseRequired);\n  const toFlags = (options: string[]): string =>\n    options.length > 0 ? options.map((option) => commandOptionFlagLabel(commandName, option)).join(\", \") : \"none\";\n\n  const lines = [\n    \"\",\n    `Type-aware option policies for ${typeDefinition.name}:`,\n    `  required: ${toFlags(policyState.required)}`,\n    `  disabled: ${toFlags(policyState.disabled)}`,\n    `  hidden: ${toFlags(policyState.hidden)}`,\n  ];\n  if (commandName === \"create\" && [\"Reminder\", \"Meeting\", \"Event\"].includes(typeDefinition.name)) {\n    lines.push(\n      \"  schedule preset: --schedule-preset lightweight switches schedule artifacts to progressive required-option policy.\",\n    );\n    lines.push(\"  strict parity remains available via --create-mode strict.\");\n  }\n  if (typeDefinition.options.length === 0) {\n    lines.push(\"  type options: none\");\n  } else {\n    lines.push(\"  type options:\");\n    for (const option of typeDefinition.options) {\n      const requiredLabel = option.required ? \" (required)\" : \"\";\n      const aliases = option.aliases ?? [];\n      lines.push(`    - ${option.key}${requiredLabel}`);\n      lines.push(`      values: ${option.values.length > 0 ? option.values.join(\"|\") : \"any non-empty string\"}`);\n      lines.push(`      aliases: ${aliases.length > 0 ? aliases.join(\"|\") : \"none\"}`);\n      if (option.description && option.description.trim().length > 0) {\n        lines.push(`      description: ${option.description.trim()}`);\n      }\n    }\n  }\n  if (policyState.errors.length > 0) {\n    lines.push(`  config errors: ${policyState.errors.join(\"; \")}`);\n  }\n  return lines.join(\"\\n\");\n}\n\nexport function attachCreateUpdatePolicyHelpText(\n  rootProgram: Command,\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>,\n  argv: string[],\n): void {\n  const bootstrapCommand = parseBootstrapCommandName(argv);\n  if (bootstrapCommand !== \"create\" && bootstrapCommand !== \"update\") {\n    return;\n  }\n  const command = findDirectChildCommand(rootProgram, bootstrapCommand);\n  if (!command) {\n    return;\n  }\n  command.addHelpText(\"after\", buildCreateUpdatePolicyHelpText(bootstrapCommand, typeRegistry, argv));\n}\n"],"names":[],"mappings":"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","debugId":"8ed1b6f2-0119-5667-be8f-8a1e245d795f"}

package/dist/cli/main.d.ts

@@ -1,2 +1,13 @@
 #!/usr/bin/env node
+declare function readThrownExitCode(error: unknown): number | undefined;
+declare function normalizeThrownExitCode(exitCode: number): number;
+declare function isCommanderError(error: unknown): boolean;
+declare function wrapThrownErrorForSentry(error: unknown, message: string): Error;
+export declare function runPmCli(rawArgv?: string[]): Promise<void>;
+export declare const _testOnly: {
+    isCommanderError: typeof isCommanderError;
+    normalizeThrownExitCode: typeof normalizeThrownExitCode;
+    readThrownExitCode: typeof readThrownExitCode;
+    wrapThrownErrorForSentry: typeof wrapThrownErrorForSentry;
+};
 export {};

package/dist/cli/main.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!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]="fa3533db-abe8-515b-9879-5faf8c891e25")}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]="253a39d8-edf5-592c-8b3e-ed509a8a6f11")}catch(e){}}();
 import fs from "node:fs";
 import path from "node:path";
 import { Command } from "commander";
@@ -11,6 +11,7 @@ import { resolveItemTypeRegistry, } from "../core/item/type-registry.js";
 import { resolveRuntimeFieldRegistry, } from "../core/schema/runtime-schema.js";
 import { EXIT_CODE, resolveTelemetryErrorCategory } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
+import { asRecordOrNull } from "../core/shared/primitives.js";
 import { printError, printResult, writeStdout } from "../core/output/output.js";
 import { maybeRunFirstUseTelemetryPrompt } from "../core/telemetry/consent.js";
 import { emitTelemetryErrorEvent, finishTelemetryCommand, startTelemetryCommand, } from "../core/telemetry/runtime.js";
@@ -19,11 +20,12 @@ import { sentryCaptureCliError, sentryFinishCommandSpan, sentryFlush, sentryLogC
 import { ensureSentryInit } from "../core/sentry/instrument.js";
 import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
-import { coerceLooseCommandOptionsWithFlagDefinitions, parseLooseCommandOptions } from "./extension-command-options.js";
+import { coerceLooseCommandOptionsWithFlagDefinitions, parseLooseCommandOptions, validateLooseCommandOptionsWithFlagDefinitions, } from "./extension-command-options.js";
 import { attachRichHelpText } from "./help-content.js";
 import { extractProvidedOptionFlags, normalizeLongOptionFlag, renderPmCommand, } from "./argv-utils.js";
 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, applyDynamicExtensionArguments, buildDynamicExtensionCommandMetadataHelp, findCommandByPath, ensureCommandPath, } from "./extension-command-help.js";
 import { parseBootstrapGlobalOptions, applyBootstrapPagerPolicy, parseBootstrapHelpRequest, parseBootstrapCommandName, normalizeBootstrapInvocation, } from "./bootstrap-args.js";
 import { collectMandatoryMigrationBlockers, enforceMandatoryMigrationWriteGate, enforceItemFormatWriteGateAndPreflightMigration, resolveMigrationId, resolveNormalizedMigrationStatus, } from "./migration-gates.js";
@@ -56,26 +58,10 @@ const TELEMETRY_RESOLUTION_STAGE_SET = new Set(["parse", "preflight", "execute",
 const TELEMETRY_ERROR_CATEGORY_SET = new Set(["usage", "validation", "conflict", "runtime", "unknown"]);
 let runtimeExtensionSnapshotCache = null;
 let activeRuntimeExtensionCommandDescriptors = new Map();
-let setupRegistrationModulePromise = null;
-let listQueryRegistrationModulePromise = null;
-let mutationRegistrationModulePromise = null;
-let operationRegistrationModulePromise = null;
-async function loadSetupRegistrationModule() {
-    setupRegistrationModulePromise ??= import("./register-setup.js");
-    return setupRegistrationModulePromise;
-}
-async function loadListQueryRegistrationModule() {
-    listQueryRegistrationModulePromise ??= import("./register-list-query.js");
-    return listQueryRegistrationModulePromise;
-}
-async function loadMutationRegistrationModule() {
-    mutationRegistrationModulePromise ??= import("./register-mutation.js");
-    return mutationRegistrationModulePromise;
-}
-async function loadOperationRegistrationModule() {
-    operationRegistrationModulePromise ??= import("./register-operations.js");
-    return operationRegistrationModulePromise;
-}
+const loadSetupRegistrationModule = createLazyModule(() => import("./register-setup.js"));
+const loadListQueryRegistrationModule = createLazyModule(() => import("./register-list-query.js"));
+const loadMutationRegistrationModule = createLazyModule(() => import("./register-mutation.js"));
+const loadOperationRegistrationModule = createLazyModule(() => import("./register-operations.js"));
 function describeUnknownError(error) {
     if (error instanceof PmCliError) {
         return error.message;
@@ -85,6 +71,35 @@ function describeUnknownError(error) {
     }
     return "Unknown failure";
 }
+function readThrownExitCode(error) {
+    if (typeof error !== "object" || error === null || !("exitCode" in error)) {
+        return undefined;
+    }
+    const exitCode = error.exitCode;
+    return typeof exitCode === "number" && Number.isFinite(exitCode) ? exitCode : undefined;
+}
+function normalizeThrownExitCode(exitCode) {
+    const normalized = Math.trunc(exitCode);
+    return normalized > EXIT_CODE.SUCCESS ? normalized : EXIT_CODE.GENERIC_FAILURE;
+}
+function isCommanderError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string" &&
+        error.code.startsWith("commander."));
+}
+function wrapThrownErrorForSentry(error, message) {
+    if (error instanceof Error) {
+        return error;
+    }
+    const wrapped = new Error(message);
+    const exitCode = readThrownExitCode(error);
+    if (exitCode !== undefined) {
+        wrapped.exitCode = normalizeThrownExitCode(exitCode);
+    }
+    return wrapped;
+}
 function renderAttemptedCommand(argv) {
     return renderPmCommand(argv);
 }
@@ -100,10 +115,10 @@ function buildPmCliRecoveryContext(context, invocationArgv, rawMessage) {
     const attemptedCommand = renderAttemptedCommand(invocationArgv);
     const providedFields = extractProvidedOptionFlags(invocationArgv);
     const providedSet = new Set(providedFields.map((flag) => normalizeLongOptionFlag(flag) ?? flag));
-    const rawInferred = inferMissingFieldsFromErrorMessage(rawMessage);
+    const existingRecovery = context?.recovery;
+    const rawInferred = existingRecovery?.suggested_retry ? undefined : inferMissingFieldsFromErrorMessage(rawMessage);
     const trulyMissing = rawInferred?.filter((flag) => !providedSet.has(normalizeLongOptionFlag(flag) ?? flag));
     const inferredMissing = trulyMissing && trulyMissing.length > 0 ? trulyMissing : undefined;
-    const existingRecovery = context?.recovery;
     let suggestedRetry = existingRecovery?.suggested_retry;
     if (!suggestedRetry && inferredMissing && inferredMissing.length > 0) {
         const missingFlag = inferredMissing[0];
@@ -130,12 +145,6 @@ function buildPmCliRecoveryContext(context, invocationArgv, rawMessage) {
         recovery,
     };
 }
-function asRecord(value) {
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        return null;
-    }
-    return value;
-}
 function readRecordString(record, ...keys) {
     if (!record) {
         return undefined;
@@ -228,7 +237,7 @@ function inferPostActionFailureMessage(result) {
     const runResults = result?.run_results;
     if (Array.isArray(runResults)) {
         const failedRuns = runResults.filter((entry) => {
-            const row = asRecord(entry);
+            const row = asRecordOrNull(entry);
             return row?.status === "failed";
         }).length;
         if (failedRuns > 0) {
@@ -256,7 +265,7 @@ function inferPostActionErrorCode(ok, exitCode) {
     return "command_failed";
 }
 function buildPostActionTelemetryOutcome() {
-    const result = asRecord(getActiveCommandResult());
+    const result = asRecordOrNull(getActiveCommandResult());
     const processExitCode = typeof process.exitCode === "number" && Number.isFinite(process.exitCode)
         ? Math.max(0, Math.trunc(process.exitCode))
         : undefined;
@@ -333,7 +342,13 @@ function extractCommandScopedOptions(command, commandArgs, extensionFlagDefiniti
     delete scoped.extensions;
     delete scoped.profile;
     delete scoped.pager;
+    // --no-changed-fields is a global output control (commander exposes it as `changedFields`),
+    // not a per-command mutation field; strip it so it never counts as an update input.
+    delete scoped.changedFields;
     const looseOptions = parseLooseCommandOptions(commandArgs);
+    if (extensionFlagDefinitions.length > 0) {
+        validateLooseCommandOptionsWithFlagDefinitions(looseOptions, extensionFlagDefinitions, getCommandPath(command));
+    }
     for (const [key, value] of Object.entries(looseOptions)) {
         if (scoped[key] === undefined) {
             scoped[key] = value;
@@ -353,6 +368,22 @@ function collectExtensionFlagDefinitionsForCommand(registrations, commandPath) {
         .filter((entry) => normalizeExtensionCommandPath(entry.target_command) === normalizedCommandPath)
         .flatMap((entry) => entry.flags);
 }
+function collectExtensionFlagDefinitionsForInvocation(registrations, commandPath, commandArgs) {
+    const exact = collectExtensionFlagDefinitionsForCommand(registrations, commandPath);
+    const pathParts = [commandPath];
+    let nestedMatch = [];
+    for (const arg of commandArgs) {
+        if (arg.startsWith("-")) {
+            break;
+        }
+        pathParts.push(arg);
+        const nested = collectExtensionFlagDefinitionsForCommand(registrations, pathParts.join(" "));
+        if (nested.length > 0) {
+            nestedMatch = nested;
+        }
+    }
+    return nestedMatch.length > 0 ? nestedMatch : exact;
+}
 const RUNTIME_FIELD_COMMAND_BY_COMMAND_PATH = {
     create: "create",
     update: "update",
@@ -660,7 +691,9 @@ async function runRequiredExtensionCommand(command, options, globalOptions) {
     if (!extensionCommandResult.handled) {
         if (extensionCommandResult.warnings.length > 0) {
             const warningCode = extensionCommandResult.warnings[0];
-            throw new PmCliError(`Command "${commandPath}" failed in extension handler (${warningCode}).`, EXIT_CODE.GENERIC_FAILURE);
+            const cause = extensionCommandResult.errorMessage?.trim();
+            const causeSuffix = cause ? ` ${cause}` : "";
+            throw new PmCliError(`Command "${commandPath}" failed in extension handler (${warningCode}).${causeSuffix}`, EXIT_CODE.GENERIC_FAILURE);
         }
         throw new PmCliError(`Command "${commandPath}" is provided by extensions and is not currently available.`, EXIT_CODE.NOT_FOUND);
     }
@@ -684,7 +717,7 @@ function wrapProgramActionsForExtensionHandlers(rootProgram) {
                 let commandArgs = actionCommand.args.map(String);
                 const activeRegistrations = getActiveExtensionRegistrations();
                 const extensionFlagDefinitions = activeRegistrations
-                    ? collectExtensionFlagDefinitionsForCommand(activeRegistrations, commandPath)
+                    ? collectExtensionFlagDefinitionsForInvocation(activeRegistrations, commandPath, commandArgs)
                     : [];
                 const runtimeFieldFlagDefinitions = await collectRuntimeFieldLooseFlagDefinitionsForCommand(commandPath, pmRoot);
                 let commandOptions = extractCommandScopedOptions(actionCommand, commandArgs, [
@@ -816,10 +849,12 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
         dynamicCommand
             .allowUnknownOption(true)
             .allowExcessArguments(true)
-            .action(async (_options, command) => {
+            .action(async (...actionArgs) => {
+            const maybeCommand = actionArgs[actionArgs.length - 1];
+            const command = maybeCommand instanceof Command ? maybeCommand : dynamicCommand;
             const globalOptions = getGlobalOptions(command);
             const startedAt = Date.now();
-            const extensionFlagDefinitions = collectExtensionFlagDefinitionsForCommand(snapshot.registrations, commandPath);
+            const extensionFlagDefinitions = collectExtensionFlagDefinitionsForInvocation(snapshot.registrations, commandPath, command.args.map(String));
             const scopedOptions = extractCommandScopedOptions(command, command.args.map(String), extensionFlagDefinitions);
             const result = await runRequiredExtensionCommand(command, scopedOptions, globalOptions);
             await invalidateSearchCachesForMutation(globalOptions, result);
@@ -865,6 +900,7 @@ program
 })
     .option("--json", "Output JSON instead of TOON")
     .option("--quiet", "Suppress stdout output")
+    .option("--no-changed-fields", "Omit the changed_fields array from mutation output (keeps changed_field_count)")
     .option("--path <dir>", "Override PM path for this command")
     .option("--no-extensions", "Disable extension loading")
     .option("--no-pager", "Disable pager integration for help and long output")
@@ -908,7 +944,7 @@ program.hook("preAction", async (_thisCommand, actionCommand) => {
     setActiveExtensionServices(runtimeExtensions.services);
     setActiveExtensionRenderers(runtimeExtensions.renderers);
     setActiveExtensionRegistrations(runtimeExtensions.registrations);
-    const extensionFlagDefinitions = collectExtensionFlagDefinitionsForCommand(runtimeExtensions.registrations, commandPath);
+    const extensionFlagDefinitions = collectExtensionFlagDefinitionsForInvocation(runtimeExtensions.registrations, commandPath, commandArgs);
     commandOptions = extractCommandScopedOptions(actionCommand, commandArgs, extensionFlagDefinitions);
     const parserOverride = await runActiveParserOverride({
         command: commandPath,
@@ -1113,6 +1149,7 @@ function resolveCoreCommandRegistrationSelection(invocationArgv) {
             listQuery: false,
             mutation: false,
             operation: false,
+            targetCommandName: normalizedCommand,
         };
     }
     if (LIST_QUERY_COMMAND_NAMES.has(normalizedCommand)) {
@@ -1121,6 +1158,7 @@ function resolveCoreCommandRegistrationSelection(invocationArgv) {
             listQuery: true,
             mutation: false,
             operation: false,
+            targetCommandName: normalizedCommand,
         };
     }
     if (MUTATION_COMMAND_NAMES.has(normalizedCommand)) {
@@ -1129,6 +1167,7 @@ function resolveCoreCommandRegistrationSelection(invocationArgv) {
             listQuery: false,
             mutation: true,
             operation: false,
+            targetCommandName: normalizedCommand,
         };
     }
     if (OPERATION_COMMAND_NAMES.has(normalizedCommand)) {
@@ -1137,6 +1176,7 @@ function resolveCoreCommandRegistrationSelection(invocationArgv) {
             listQuery: false,
             mutation: false,
             operation: true,
+            targetCommandName: normalizedCommand,
         };
     }
     return REGISTER_ALL_CORE_COMMAND_FAMILIES;
@@ -1152,7 +1192,11 @@ async function registerCoreCommandFamilies(rootProgram, selection) {
     }
     if (selection.listQuery) {
         const { registerListQueryCommands } = await loadListQueryRegistrationModule();
-        registerListQueryCommands(rootProgram);
+        const commandFilter = typeof selection.targetCommandName === "string" &&
+            LIST_QUERY_COMMAND_NAMES.has(selection.targetCommandName)
+            ? new Set([selection.targetCommandName])
+            : undefined;
+        registerListQueryCommands(rootProgram, commandFilter ? { commandFilter } : undefined);
     }
     if (selection.mutation) {
         const { registerMutationCommands } = await loadMutationRegistrationModule();
@@ -1199,8 +1243,8 @@ function shouldRegisterRuntimeSchemaFlags(invocationArgv) {
     }
     return RUNTIME_SCHEMA_FLAG_BOOTSTRAP_COMMANDS.has(commandName);
 }
-const bootstrapInvocation = normalizeBootstrapInvocation(process.argv.slice(2));
-async function main() {
+export async function runPmCli(rawArgv = process.argv.slice(2)) {
+    const bootstrapInvocation = normalizeBootstrapInvocation(rawArgv);
     const invocationArgv = bootstrapInvocation.argv;
     const invocationProcessArgv = [process.argv[0], process.argv[1], ...invocationArgv];
     const isBareInvocation = invocationArgv.length === 0;
@@ -1268,14 +1312,19 @@ async function main() {
             const bootstrapSnapshot = await loadRuntimeExtensionSnapshot(bootstrapPmRoot);
             setActiveExtensionServices(bootstrapSnapshot?.services ?? { overrides: [] });
         }
-        if (error instanceof PmCliError) {
-            const enrichedContext = buildPmCliRecoveryContext(error.context, invocationArgv, error.message);
-            const classification = classifyPmCliError(error.message, enrichedContext);
+        const numericExitCode = readThrownExitCode(error);
+        if (error instanceof PmCliError ||
+            (!isCommanderError(error) && typeof numericExitCode === "number" && Number.isFinite(numericExitCode))) {
+            const errorMessage = describeUnknownError(error);
+            const exitCode = error instanceof PmCliError ? error.exitCode : normalizeThrownExitCode(numericExitCode);
+            const context = error instanceof PmCliError ? error.context : undefined;
+            const enrichedContext = buildPmCliRecoveryContext(context, invocationArgv, errorMessage);
+            const classification = classifyPmCliError(errorMessage, enrichedContext);
             const { errorCategory, commandResolution } = await emitTelemetryCommandError({
                 command: attemptedCommand,
                 errorCode: classification.code,
                 errorMessage: classification.detail,
-                exitCode: error.exitCode,
+                exitCode,
                 options: {
                     bootstrap_global_options: bootstrapGlobal,
                 },
@@ -1286,37 +1335,37 @@ async function main() {
                 command: attemptedCommand,
                 error_code: classification.code,
                 error_category: errorCategory,
-                exit_code: error.exitCode,
+                exit_code: exitCode,
                 error_message: classification.detail,
                 command_resolution: commandResolution,
                 resolution_stage: "execute",
                 source_context: activeTelemetryCommandContext?.source_context,
             });
-            sentryFinishCommandSpan(false, error.message, {
+            sentryFinishCommandSpan(false, errorMessage, {
                 error_code: classification.code,
                 error_category: errorCategory,
-                exit_code: error.exitCode,
+                exit_code: exitCode,
                 command_resolution: commandResolution,
                 resolution_stage: "execute",
             });
             await runAndClearAfterCommandHooks({
                 ok: false,
-                error: error.message,
-                exit_code: error.exitCode,
+                error: errorMessage,
+                exit_code: exitCode,
                 error_code: classification.code,
                 error_category: errorCategory,
                 command_resolution: commandResolution,
                 resolution_stage: "execute",
             });
-            sentryCaptureCliError(error);
+            sentryCaptureCliError(wrapThrownErrorForSentry(error, errorMessage));
             if (jsonErrors) {
-                printError(JSON.stringify(formatPmCliErrorForJson(error.message, error.exitCode, enrichedContext), null, 2));
+                printError(JSON.stringify(formatPmCliErrorForJson(errorMessage, exitCode, enrichedContext), null, 2));
             }
             else {
-                printError(formatPmCliErrorForDisplay(error.message, enrichedContext));
+                printError(formatPmCliErrorForDisplay(errorMessage, enrichedContext));
             }
             await sentryFlush();
-            process.exitCode = error.exitCode;
+            process.exitCode = exitCode;
             return;
         }
         if (typeof error === "object" && error !== null && "code" in error) {
@@ -1521,6 +1570,11 @@ async function main() {
         process.exitCode = EXIT_CODE.GENERIC_FAILURE;
     }
 }
-void main();
+export const _testOnly = {
+    isCommanderError,
+    normalizeThrownExitCode,
+    readThrownExitCode,
+    wrapThrownErrorForSentry,
+};
 //# sourceMappingURL=main.js.map
-//# debugId=fa3533db-abe8-515b-9879-5faf8c891e25
+//# debugId=253a39d8-edf5-592c-8b3e-ed509a8a6f11