@unbrained/pm-cli 2026.6.12 → 2026.6.16

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\nfunction resolveCommandFromPathTokens(root: Command, pathTokens: string[]): Command | null {\n  if (pathTokens.length === 0) {\n    return root;\n  }\n  return findCommandByPath(root, pathTokens);\n}\n\nfunction 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\nfunction 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\nfunction 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\nfunction 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\nfunction 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\nfunction 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\nfunction 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\nfunction 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\nfunction 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":"878a1569-b6af-5522-8c4a-458db8c0cbf4"}
+{"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\nfunction resolveCommandFromPathTokens(root: Command, pathTokens: string[]): Command | null {\n  if (pathTokens.length === 0) {\n    return root;\n  }\n  return findCommandByPath(root, pathTokens);\n}\n\nfunction 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\nfunction 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\nfunction 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\nfunction 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\nfunction 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    const aliasFor = aliasOption.alias_for as string;\n    const canonical = canonicalByLong.get(aliasFor);\n    if (!canonical) {\n      continue;\n    }\n    const aliasLong = aliasOption.long as string;\n    const aliases = new Set<string>([...(canonical.aliases ?? []), aliasLong]);\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\nfunction 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\nfunction 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\nfunction 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\nfunction 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\nexport const _testOnly = {\n  attachCreateUpdatePolicyHelpText,\n  buildCreateUpdatePolicyHelpText,\n  buildHelpArgumentSummaries,\n  buildHelpOptionSummaries,\n  buildHelpSubcommandSummaries,\n  buildOptionAliasMap,\n  compactHelpOptionAliases,\n  readOptionAttributeName,\n};\n"],"names":[],"mappings":"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","debugId":"9cd6003e-01d2-51de-9fbd-aa1d49d03e68"}

package/dist/cli/main.d.ts

@@ -1,18 +1,241 @@
 #!/usr/bin/env node
+import { Command } from "commander";
+import { createEmptyExtensionRegistrationRegistry, type ExtensionCommandRegistry, type ExtensionDiscoveryResult, type ExtensionHookRegistry, type ExtensionParserRegistry, type ExtensionPreflightRegistry, type ExtensionServiceRegistry, type PreflightRuntimeDecision, type RegisteredExtensionSchemaMigrationDefinition, type ExtensionRendererRegistry } from "../core/extensions/index.js";
+import { type TelemetryErrorCategory } from "../core/shared/constants.js";
 import { type PmCliErrorContext } from "../core/shared/errors.js";
+import { type TelemetryCommandOutcome } from "../core/telemetry/runtime.js";
+import { type TelemetryCommandResolution, type TelemetryResolutionStage } from "../core/telemetry/observability.js";
+import type { GlobalOptions } from "../core/shared/command-types.js";
+import type { PmSettings } from "../types/index.js";
+import { type ExtensionCommandHelpDescriptor } from "./extension-command-help.js";
+import { normalizeBootstrapInvocation } from "./bootstrap-args.js";
+import { type MandatoryMigrationBlocker } from "./migration-gates.js";
+interface ActiveExtensionHookContext {
+    hooks: ExtensionHookRegistry;
+    commandName: string;
+    commandArgs: string[];
+    commandOptions: Record<string, unknown>;
+    globalOptions: GlobalOptions;
+    pmRoot: string;
+    profileEnabled: boolean;
+    migrationBlockers: MandatoryMigrationBlocker[];
+}
+declare function setActiveExtensionHookContextForTest(context: ActiveExtensionHookContext | null): void;
+interface RuntimeExtensionSnapshot {
+    hooks: ExtensionHookRegistry;
+    commands: ExtensionCommandRegistry;
+    parsers: ExtensionParserRegistry;
+    preflight: ExtensionPreflightRegistry;
+    services: ExtensionServiceRegistry;
+    renderers: ExtensionRendererRegistry;
+    registrations: ReturnType<typeof createEmptyExtensionRegistrationRegistry>;
+    pmRoot: string;
+    settings: PmSettings;
+    commandHandlers: string[];
+    commandFlagHelp: Map<string, string>;
+    commandDescriptors: Map<string, ExtensionCommandHelpDescriptor>;
+    loadWarnings: string[];
+    activationWarnings: string[];
+    loadedCount: number;
+    loadFailedCount: number;
+    activationFailedCount: number;
+}
+interface RuntimeExtensionDiscoverySnapshot {
+    pmRoot: string;
+    settings: PmSettings;
+    discovery: ExtensionDiscoveryResult;
+    discoveryMs: number;
+    settingsReadWarnings: string[];
+}
+interface RuntimeExtensionActivationProbe {
+    commandPath?: string;
+    commandArgs?: string[];
+    allowCommandPrefixMatch?: boolean;
+}
+declare function describeUnknownError(error: unknown): string;
 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;
+declare function inferMissingFieldsFromErrorMessage(message: string): string[] | undefined;
 declare function buildPmCliRecoveryContext(context: PmCliErrorContext | undefined, invocationArgv: string[], rawMessage: string): PmCliErrorContext;
+declare function readRecordString(record: Record<string, unknown> | null, ...keys: string[]): string | undefined;
+declare function readRecordBoolean(record: Record<string, unknown> | null, ...keys: string[]): boolean | undefined;
+declare function readRecordNumber(record: Record<string, unknown> | null, ...keys: string[]): number | undefined;
+declare function normalizeTelemetryCommandResolution(value: string | undefined): TelemetryCommandResolution | undefined;
+declare function normalizeTelemetryResolutionStage(value: string | undefined): TelemetryResolutionStage | undefined;
+declare function normalizeTelemetryErrorCategory(value: string | undefined): TelemetryErrorCategory | undefined;
+declare function inferPostActionFailureMessage(result: Record<string, unknown> | null): string | undefined;
+declare function inferPostActionErrorCode(ok: boolean, exitCode: number): string | undefined;
+declare function buildPostActionTelemetryOutcome(): TelemetryCommandOutcome;
+declare function runAndClearAfterCommandHooks(outcome: TelemetryCommandOutcome): Promise<void>;
+declare function envFlagEnabled(key: string): boolean;
 declare function shouldLogHandledErrorToSentry(exitCode: number): boolean;
+declare function maybeLogHandledCliErrorToSentry(params: {
+    command: string;
+    error_code: string;
+    error_category: TelemetryErrorCategory;
+    exit_code: number;
+    error_message: string;
+    command_resolution?: TelemetryCommandResolution;
+    resolution_stage?: TelemetryResolutionStage;
+    source_context?: string;
+}): Promise<boolean>;
+declare function handleGenericRunPmCliError(params: {
+    error: unknown;
+    attemptedCommand: string;
+    bootstrapGlobal: GlobalOptions;
+    emitTelemetryCommandError: (event: {
+        command: string;
+        errorCode: string;
+        errorMessage: string;
+        exitCode: number;
+        options: Record<string, unknown>;
+        resolutionStage: TelemetryResolutionStage;
+    }) => Promise<{
+        errorCategory: TelemetryErrorCategory;
+        commandResolution: TelemetryCommandResolution;
+    }>;
+}): Promise<void>;
+declare function extractCommandScopedOptions(command: Command, commandArgs: string[], extensionFlagDefinitions?: Array<Record<string, unknown>>): Record<string, unknown>;
+declare function collectExtensionFlagDefinitionsForCommand(registrations: ReturnType<typeof createEmptyExtensionRegistrationRegistry>, commandPath: string): Array<Record<string, unknown>>;
+declare function collectExtensionFlagDefinitionsForInvocation(registrations: ReturnType<typeof createEmptyExtensionRegistrationRegistry>, commandPath: string, commandArgs: string[]): Array<Record<string, unknown>>;
+declare function toLooseFieldDefinitionType(fieldType: string): "string" | "number" | "boolean";
+declare function commandHasLongOption(command: Command, longFlag: string): boolean;
+declare function commandHasShortOption(command: Command, shortFlag: string): boolean;
+declare function addRuntimeFieldOption(command: Command, flagToken: string, description: string, repeatable: boolean): void;
+declare function collectRuntimeFieldLooseFlagDefinitionsForCommand(commandPath: string, pmRoot: string): Promise<Array<Record<string, unknown>>>;
+declare function registerRuntimeSchemaFieldFlags(rootProgram: Command, invocationArgv: string[]): Promise<void>;
+declare function maybeAttachCreateUpdatePolicyHelpText(rootProgram: Command, pmRoot: string, invocationArgv: string[], registrations: ReturnType<typeof createEmptyExtensionRegistrationRegistry>, settings?: PmSettings): Promise<void>;
+declare function defaultPreflightDecision(): PreflightRuntimeDecision;
+declare function buildRuntimeExtensionSnapshotCacheKey(pmRoot: string): string;
+declare function bootstrapProfileEnabled(invocationArgv: string[]): boolean;
+declare function buildRuntimeExtensionDiscoverySnapshotCacheKey(pmRoot: string): string;
+declare function collectLeadingCommandArgs(commandArgs: readonly string[] | undefined): string[];
+declare function collectActivationCommandCandidates(probe: RuntimeExtensionActivationProbe): string[];
+declare function activationCommandMatchesProbe(command: string, probe: RuntimeExtensionActivationProbe): boolean;
+declare function extensionActivationCommands(extension: ExtensionDiscoveryResult["effective"][number]): string[];
+declare function extensionCapabilities(extension: ExtensionDiscoveryResult["effective"][number]): Set<string>;
+declare function hasAnyCapability(capabilities: Set<string>, expected: Set<string>): boolean;
+declare function commandPathNeedsSearchExtensions(commandPath: string | undefined): boolean;
+declare function probeUsesAnyFlag(probe: RuntimeExtensionActivationProbe, flags: Set<string>): boolean;
+declare function commandPathNeedsTemplateExtensions(probe: RuntimeExtensionActivationProbe): boolean;
+declare function extensionProvidesTemplatesRuntime(commands: readonly string[]): boolean;
+declare function extensionNeedsActivationForProbe(extension: ExtensionDiscoveryResult["effective"][number], probe: RuntimeExtensionActivationProbe): boolean;
+declare function discoveryNeedsActivationForProbe(discovery: ExtensionDiscoveryResult, probe: RuntimeExtensionActivationProbe): boolean;
+declare function buildBootstrapActivationProbe(invocationArgv: string[]): RuntimeExtensionActivationProbe;
+declare function collectParsedActivationCommandArgs(command: Command): string[];
+/**
+ * Surface settings-read warnings once per command on stderr. readSettings()
+ * silently falls back to defaults when settings.json is invalid, so most
+ * commands (create/list/search/...) generate the warning but never show it — a
+ * typo would change behavior with no explanation. Only the `settings_read_*`
+ * codes are surfaced (the corrupt-settings fallbacks: invalid_json /
+ * invalid_schema / merge_failed); other informational settings warnings (schema
+ * bootstrap, legacy-format coercion) stay quiet. Mirrors the same finding in
+ * `pm health`, which also carries a remediation_map for it.
+ */
+declare function emitSettingsReadWarnings(warnings: readonly string[]): void;
+declare function emitExtensionProfile(globalOptions: GlobalOptions, snapshot: RuntimeExtensionSnapshot): void;
+declare function emitExtensionSkippedProfile(profileEnabled: boolean | undefined, snapshot: RuntimeExtensionDiscoverySnapshot, probe: RuntimeExtensionActivationProbe): void;
+declare function loadRuntimeExtensionDiscoverySnapshot(pmRoot: string): Promise<RuntimeExtensionDiscoverySnapshot | null>;
+declare function loadRuntimeExtensionSnapshot(pmRoot: string): Promise<RuntimeExtensionSnapshot | null>;
+declare function maybeLoadRuntimeExtensions(command: Command): Promise<{
+    hooks: ExtensionHookRegistry;
+    commands: ExtensionCommandRegistry;
+    parsers: ExtensionParserRegistry;
+    preflight: ExtensionPreflightRegistry;
+    services: ExtensionServiceRegistry;
+    renderers: ExtensionRendererRegistry;
+    registrations: ReturnType<typeof createEmptyExtensionRegistrationRegistry>;
+    pmRoot: string;
+} | null>;
+declare function loadRuntimeExtensionCommandDescriptorsForRecovery(pmRoot: string): Promise<Map<string, ExtensionCommandHelpDescriptor>>;
+declare function executeRegisteredRuntimeMigrations(migrations: RegisteredExtensionSchemaMigrationDefinition[], pmRoot: string): Promise<string[]>;
+declare function runRequiredExtensionCommand(command: Command, options: Record<string, unknown>, globalOptions: GlobalOptions, extensionFlagDefinitions?: Array<Record<string, unknown>>): Promise<unknown>;
+declare function wrapProgramActionsForExtensionHandlers(rootProgram: Command): void;
+declare function registerDynamicExtensionCommandPaths(rootProgram: Command, invocationArgv: string[]): Promise<void>;
+interface CoreCommandRegistrationSelection {
+    setup: boolean;
+    listQuery: boolean;
+    mutation: boolean;
+    operation: boolean;
+    targetCommandName?: string;
+}
+declare function invocationRequestsVersion(invocationArgv: string[]): boolean;
+declare function resolveCoreCommandRegistrationSelection(invocationArgv: string[]): CoreCommandRegistrationSelection;
+declare function shouldAttachRichHelpTextForInvocation(invocationArgv: string[]): boolean;
+declare function shouldRegisterDynamicExtensionPaths(_rootProgram: Command, invocationArgv: string[]): boolean;
+declare function shouldRegisterRuntimeSchemaFlags(invocationArgv: string[]): boolean;
+declare function enforceExplicitRetryForFlagTypos(bootstrapInvocation: ReturnType<typeof normalizeBootstrapInvocation>): void;
 export declare function runPmCli(rawArgv?: string[]): Promise<void>;
 export declare const _testOnly: {
+    activationCommandMatchesProbe: typeof activationCommandMatchesProbe;
+    bootstrapProfileEnabled: typeof bootstrapProfileEnabled;
+    buildBootstrapActivationProbe: typeof buildBootstrapActivationProbe;
+    buildPostActionTelemetryOutcome: typeof buildPostActionTelemetryOutcome;
     buildPmCliRecoveryContext: typeof buildPmCliRecoveryContext;
+    buildRuntimeExtensionDiscoverySnapshotCacheKey: typeof buildRuntimeExtensionDiscoverySnapshotCacheKey;
+    buildRuntimeExtensionSnapshotCacheKey: typeof buildRuntimeExtensionSnapshotCacheKey;
+    addRuntimeFieldOption: typeof addRuntimeFieldOption;
+    collectActivationCommandCandidates: typeof collectActivationCommandCandidates;
+    collectExtensionFlagDefinitionsForCommand: typeof collectExtensionFlagDefinitionsForCommand;
+    collectExtensionFlagDefinitionsForInvocation: typeof collectExtensionFlagDefinitionsForInvocation;
+    collectLeadingCommandArgs: typeof collectLeadingCommandArgs;
+    collectParsedActivationCommandArgs: typeof collectParsedActivationCommandArgs;
+    collectRuntimeFieldLooseFlagDefinitionsForCommand: typeof collectRuntimeFieldLooseFlagDefinitionsForCommand;
+    commandHasLongOption: typeof commandHasLongOption;
+    commandHasShortOption: typeof commandHasShortOption;
+    commandPathNeedsSearchExtensions: typeof commandPathNeedsSearchExtensions;
+    commandPathNeedsTemplateExtensions: typeof commandPathNeedsTemplateExtensions;
+    describeUnknownError: typeof describeUnknownError;
+    defaultPreflightDecision: typeof defaultPreflightDecision;
+    discoveryNeedsActivationForProbe: typeof discoveryNeedsActivationForProbe;
+    emitExtensionProfile: typeof emitExtensionProfile;
+    emitExtensionSkippedProfile: typeof emitExtensionSkippedProfile;
+    emitSettingsReadWarnings: typeof emitSettingsReadWarnings;
+    enforceExplicitRetryForFlagTypos: typeof enforceExplicitRetryForFlagTypos;
+    envFlagEnabled: typeof envFlagEnabled;
+    executeRegisteredRuntimeMigrations: typeof executeRegisteredRuntimeMigrations;
+    extractCommandScopedOptions: typeof extractCommandScopedOptions;
+    extensionActivationCommands: typeof extensionActivationCommands;
+    extensionCapabilities: typeof extensionCapabilities;
+    extensionNeedsActivationForProbe: typeof extensionNeedsActivationForProbe;
+    extensionProvidesTemplatesRuntime: typeof extensionProvidesTemplatesRuntime;
+    hasAnyCapability: typeof hasAnyCapability;
+    handleGenericRunPmCliError: typeof handleGenericRunPmCliError;
+    inferMissingFieldsFromErrorMessage: typeof inferMissingFieldsFromErrorMessage;
+    inferPostActionErrorCode: typeof inferPostActionErrorCode;
+    inferPostActionFailureMessage: typeof inferPostActionFailureMessage;
+    invocationRequestsVersion: typeof invocationRequestsVersion;
     isCommanderError: typeof isCommanderError;
+    loadRuntimeExtensionCommandDescriptorsForRecovery: typeof loadRuntimeExtensionCommandDescriptorsForRecovery;
+    loadRuntimeExtensionDiscoverySnapshot: typeof loadRuntimeExtensionDiscoverySnapshot;
+    loadRuntimeExtensionSnapshot: typeof loadRuntimeExtensionSnapshot;
+    maybeLoadRuntimeExtensions: typeof maybeLoadRuntimeExtensions;
+    maybeAttachCreateUpdatePolicyHelpText: typeof maybeAttachCreateUpdatePolicyHelpText;
+    maybeLogHandledCliErrorToSentry: typeof maybeLogHandledCliErrorToSentry;
+    normalizeTelemetryCommandResolution: typeof normalizeTelemetryCommandResolution;
+    normalizeTelemetryErrorCategory: typeof normalizeTelemetryErrorCategory;
+    normalizeTelemetryResolutionStage: typeof normalizeTelemetryResolutionStage;
     normalizeThrownExitCode: typeof normalizeThrownExitCode;
+    probeUsesAnyFlag: typeof probeUsesAnyFlag;
+    readRecordBoolean: typeof readRecordBoolean;
+    readRecordNumber: typeof readRecordNumber;
+    readRecordString: typeof readRecordString;
+    registerDynamicExtensionCommandPaths: typeof registerDynamicExtensionCommandPaths;
+    registerRuntimeSchemaFieldFlags: typeof registerRuntimeSchemaFieldFlags;
+    resolveCoreCommandRegistrationSelection: typeof resolveCoreCommandRegistrationSelection;
     readThrownExitCode: typeof readThrownExitCode;
+    runAndClearAfterCommandHooks: typeof runAndClearAfterCommandHooks;
+    runRequiredExtensionCommand: typeof runRequiredExtensionCommand;
+    shouldAttachRichHelpTextForInvocation: typeof shouldAttachRichHelpTextForInvocation;
     shouldLogHandledErrorToSentry: typeof shouldLogHandledErrorToSentry;
+    shouldRegisterDynamicExtensionPaths: typeof shouldRegisterDynamicExtensionPaths;
+    shouldRegisterRuntimeSchemaFlags: typeof shouldRegisterRuntimeSchemaFlags;
+    setActiveExtensionHookContextForTest: typeof setActiveExtensionHookContextForTest;
+    toLooseFieldDefinitionType: typeof toLooseFieldDefinitionType;
+    wrapProgramActionsForExtensionHandlers: typeof wrapProgramActionsForExtensionHandlers;
     wrapThrownErrorForSentry: typeof wrapThrownErrorForSentry;
 };
 export {};