@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/cli/main.d.ts

@@ -3,119 +3,119 @@
  * Coordinates CLI invocation state, extension lifecycle and command dispatch.
  */
 import { Command } from "commander";
-import { describeUnknownError, isCommanderError, normalizeThrownExitCode, readThrownExitCode, wrapThrownErrorForSentry } from "../sdk/error-runtime.js";
-import { type ActiveExtensionHookContext, type ExtensionCommandRegistry, type ExtensionDiscoveryResult, type ExtensionHookRegistry, type ExtensionParserRegistry, type ExtensionPreflightRegistry, type ExtensionRendererRegistry, type ExtensionServiceRegistry, type GlobalOptions, type PmCliErrorContext, type PreflightRuntimeDecision, type RegisteredExtensionSchemaMigrationDefinition, type TelemetryCommandOutcome, type TelemetryCommandResolution, type TelemetryErrorCategory, type TelemetryResolutionStage, createEmptyExtensionRegistrationRegistry, readSettings, readSettingsWithMetadata } from "../sdk/runtime-primitives.js";
+import { describeUnknownError,isCommanderError,normalizeThrownExitCode,readThrownExitCode,wrapThrownErrorForSentry } from "../sdk/error-runtime.js";
+import { type ActiveExtensionHookContext,type ExtensionCommandRegistry,type ExtensionDiscoveryResult,type ExtensionHookRegistry,type ExtensionParserRegistry,type ExtensionPreflightRegistry,type ExtensionRendererRegistry,type ExtensionServiceRegistry,type GlobalOptions,type PmCliErrorContext,type PreflightRuntimeDecision,type RegisteredExtensionSchemaMigrationDefinition,type TelemetryCommandOutcome,type TelemetryCommandResolution,type TelemetryErrorCategory,type TelemetryResolutionStage,createEmptyExtensionRegistrationRegistry,readSettings,readSettingsWithMetadata } from "../sdk/runtime-primitives.js";
 import type { PmSettings } from "../types/index.js";
 import { resolveUnknownCommanderToken } from "./commander-usage.js";
 import { type ExtensionCommandHelpDescriptor } from "./extension-command-help.js";
 import { type LooseCommandFlagDefinition } from "./extension-command-options.js";
 import { type MandatoryMigrationBlocker } from "./migration-gates.js";
 import type { RuntimeExtensionActivationProbe } from "./runtime/activation.js";
-import { activationCommandMatchesProbe, buildBootstrapActivationProbe, buildRuntimeExtensionActivationScope, buildRuntimeExtensionFilterForProbe, collectActivationCommandCandidates, collectLeadingCommandArgs, collectParsedActivationCommandArgs, commandPathNeedsSearchExtensions, commandPathNeedsTemplateExtensions, discoveryNeedsActivationForProbe, extensionActivationCommands, extensionCapabilities, extensionNeedsActivationForProbe, extensionProvidesTemplatesRuntime, hasAnyCapability, hasGlobalExtensionContributions, matchesStaticExtensionCommand, probeUsesAnyFlag, resolveStaticExtensionActivationDecision } from "./runtime/activation.js";
-import { collectExtensionFlagDefinitionsForCommand, collectExtensionFlagDefinitionsForInvocation, extractCommandScopedOptions, isImporterOrExporterCommandPath, recordCliReadOutputInvocationProvenance, validateDynamicExtensionCommandInvocation } from "./runtime/invocation-options.js";
-import { enforceExplicitRetryForFlagTypos, invocationRequestsVersion, resolveCoreCommandRegistrationSelection, shouldAttachRichHelpTextForInvocation, shouldRegisterDynamicExtensionPaths, shouldRegisterRuntimeSchemaFlags } from "./runtime/selection.js";
-import { buildPostActionTelemetryOutcome, inferPostActionErrorCode, inferPostActionFailureMessage, normalizeTelemetryCommandResolution, normalizeTelemetryErrorCategory, normalizeTelemetryResolutionStage, readRecordBoolean, readRecordNumber, readRecordString } from "./runtime/telemetry-outcome.js";
-declare function setActiveExtensionHookContextForTest(context: ActiveExtensionHookContext<MandatoryMigrationBlocker> | null): void;
-declare function setActiveRuntimeExtensionCommandDescriptorsForTest(descriptors: Map<string, ExtensionCommandHelpDescriptor>): void;
+import { activationCommandMatchesProbe,buildBootstrapActivationProbe,buildRuntimeExtensionActivationScope,buildRuntimeExtensionFilterForProbe,collectActivationCommandCandidates,collectLeadingCommandArgs,collectParsedActivationCommandArgs,commandPathNeedsSearchExtensions,commandPathNeedsTemplateExtensions,discoveryNeedsActivationForProbe,extensionActivationCommands,extensionCapabilities,extensionNeedsActivationForProbe,extensionProvidesTemplatesRuntime,hasAnyCapability,hasGlobalExtensionContributions,matchesStaticExtensionCommand,probeUsesAnyFlag,resolveStaticExtensionActivationDecision } from "./runtime/activation.js";
+import { collectExtensionFlagDefinitionsForCommand,collectExtensionFlagDefinitionsForInvocation,extractCommandScopedOptions,isImporterOrExporterCommandPath,recordCliReadOutputInvocationProvenance,validateDynamicExtensionCommandInvocation } from "./runtime/invocation-options.js";
+import { enforceExplicitRetryForFlagTypos,invocationRequestsVersion,resolveCoreCommandRegistrationSelection,shouldAttachRichHelpTextForInvocation,shouldRegisterDynamicExtensionPaths,shouldRegisterRuntimeSchemaFlags } from "./runtime/selection.js";
+import { buildPostActionTelemetryOutcome,inferPostActionErrorCode,inferPostActionFailureMessage,normalizeTelemetryCommandResolution,normalizeTelemetryErrorCategory,normalizeTelemetryResolutionStage,readRecordBoolean,readRecordNumber,readRecordString } from "./runtime/telemetry-outcome.js";
+declare function setActiveExtensionHookContextForTest(context:ActiveExtensionHookContext<MandatoryMigrationBlocker> | null):void;
+declare function setActiveRuntimeExtensionCommandDescriptorsForTest(descriptors:Map<string,ExtensionCommandHelpDescriptor>):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>;
-commandAliases: Map<string, string>;
-loadWarnings: string[];
-activationWarnings: string[];
-loadedCount: number;
-loadFailedCount: number;
-activationFailedCount: number;
-contextIntentPackages: Array<{
-name: string;
-module: unknown;
+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>;
+commandAliases:Map<string,string>;
+loadWarnings:string[];
+activationWarnings:string[];
+loadedCount:number;
+loadFailedCount:number;
+activationFailedCount:number;
+contextIntentPackages:Array<{
+name:string;
+module:unknown;
 }>;
 }
 interface RuntimeExtensionDiscoverySnapshot {
-pmRoot: string;
-settings: PmSettings;
-discovery: ExtensionDiscoveryResult;
-discoveryMs: number;
-settingsReadWarnings: string[];
+pmRoot:string;
+settings:PmSettings;
+discovery:ExtensionDiscoveryResult;
+discoveryMs:number;
+settingsReadWarnings:string[];
 }
-declare function inferMissingFieldsFromErrorMessage(message: string): string[] | undefined;
+declare function inferMissingFieldsFromErrorMessage(message:string):string[] | undefined;
 /** Build replayable recovery guidance after removing sensitive matcher values from every invocation representation. */
-declare function buildPmCliRecoveryContext(context: PmCliErrorContext | undefined, invocationArgv: string[], rawMessage: string): PmCliErrorContext;
-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;
+declare function buildPmCliRecoveryContext(context:PmCliErrorContext | undefined,invocationArgv:string[],rawMessage:string):PmCliErrorContext;
+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;
+errorCategory:TelemetryErrorCategory;
+commandResolution:TelemetryCommandResolution;
 }>;
-}): Promise<void>;
-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<LooseCommandFlagDefinition[]>;
-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, activationScope?: string): string;
-declare function bootstrapProfileEnabled(invocationArgv: string[]): boolean;
-declare function buildRuntimeExtensionDiscoverySnapshotCacheKey(pmRoot: string): string;
+}):Promise<void>;
+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<LooseCommandFlagDefinition[]>;
+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,activationScope?:string):string;
+declare function bootstrapProfileEnabled(invocationArgv:string[]):boolean;
+declare function buildRuntimeExtensionDiscoverySnapshotCacheKey(pmRoot:string):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, readSettingsWithMetadataFn?: typeof readSettingsWithMetadata): Promise<RuntimeExtensionDiscoverySnapshot | null>;
-declare function loadRuntimeExtensionSnapshot(pmRoot: string, probe?: RuntimeExtensionActivationProbe, readSettingsFn?: typeof readSettings): 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;
+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,readSettingsWithMetadataFn?:typeof readSettingsWithMetadata):Promise<RuntimeExtensionDiscoverySnapshot | null>;
+declare function loadRuntimeExtensionSnapshot(pmRoot:string,probe?:RuntimeExtensionActivationProbe,readSettingsFn?:typeof readSettings):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>;
 /** Load the complete installed registry for recovery without registering guessed command handlers. */
-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?: LooseCommandFlagDefinition[]): Promise<unknown>;
+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?:LooseCommandFlagDefinition[]):Promise<unknown>;
 /** Wrap each action once so validated parser overrides and extension handlers precede the original core action. */
-declare function wrapProgramActionsForExtensionHandlers(rootProgram: Command): void;
+declare function wrapProgramActionsForExtensionHandlers(rootProgram:Command):void;
 /** Apply descendant-derived visibility to every generated extension namespace. */
-declare function applyDynamicExtensionRootHelpVisibility(rootProgram: Command, preexistingTopLevelCommands: ReadonlySet<string>, descriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>): void;
-declare function registerDynamicExtensionCommandPaths(rootProgram: Command, invocationArgv: string[]): Promise<void>;
+declare function applyDynamicExtensionRootHelpVisibility(rootProgram:Command,preexistingTopLevelCommands:ReadonlySet<string>,descriptors:ReadonlyMap<string,ExtensionCommandHelpDescriptor>):void;
+declare function registerDynamicExtensionCommandPaths(rootProgram:Command,invocationArgv:string[]):Promise<void>;
 /**
  * The root `program` is a module-level singleton. Any path that enters
  * `runPmCli` a second time in the same process (an embedding host, a long-lived
@@ -133,135 +133,135 @@ declare function registerDynamicExtensionCommandPaths(rootProgram: Command, invo
  * short-circuits exact duplicates — every first-time registration still flows
  * through Commander untouched.
  */
-declare function ensureIdempotentTopLevelCommandRegistration(rootProgram: Command): void;
-type TelemetryCommandErrorEmitter = (params: {
-command: string;
-errorCode: string;
-errorMessage: string;
-exitCode: number;
-options: Record<string, unknown>;
-resolutionStage: TelemetryResolutionStage;
+declare function ensureIdempotentTopLevelCommandRegistration(rootProgram:Command):void;
+type TelemetryCommandErrorEmitter = (params:{
+command:string;
+errorCode:string;
+errorMessage:string;
+exitCode:number;
+options:Record<string,unknown>;
+resolutionStage:TelemetryResolutionStage;
 }) => Promise<{
-errorCategory: TelemetryErrorCategory;
-commandResolution: TelemetryCommandResolution;
+errorCategory:TelemetryErrorCategory;
+commandResolution:TelemetryCommandResolution;
 }>;
 interface RunPmCliErrorContext {
-error: unknown;
-invocationArgv: string[];
-bootstrapGlobal: GlobalOptions;
-jsonErrors: boolean;
-bootstrapPmRoot: string;
-attemptedCommand: string;
-emitTelemetryCommandError: TelemetryCommandErrorEmitter;
+error:unknown;
+invocationArgv:string[];
+bootstrapGlobal:GlobalOptions;
+jsonErrors:boolean;
+bootstrapPmRoot:string;
+attemptedCommand:string;
+emitTelemetryCommandError:TelemetryCommandErrorEmitter;
 }
-declare function prepareExtensionServicesForRunPmCliError(params: {
-invocationArgv: string[];
-bootstrapGlobal: GlobalOptions;
-bootstrapPmRoot: string;
-}): Promise<void>;
-declare function setRecoveredExtensionServices(bootstrapSnapshot: Pick<RuntimeExtensionSnapshot, "services"> | null): void;
-declare function handleRunPmCliKnownError(context: RunPmCliErrorContext, numericExitCode: number | undefined): Promise<boolean>;
+declare function prepareExtensionServicesForRunPmCliError(params:{
+invocationArgv:string[];
+bootstrapGlobal:GlobalOptions;
+bootstrapPmRoot:string;
+}):Promise<void>;
+declare function setRecoveredExtensionServices(bootstrapSnapshot:Pick<RuntimeExtensionSnapshot,"services"> | null):void;
+declare function handleRunPmCliKnownError(context:RunPmCliErrorContext,numericExitCode:number | undefined):Promise<boolean>;
 /** Classify failed help requests by semantic operation so optional package recovery and error telemetry retain the attempted command. */
-declare function handleUnknownHelpCommandError(context: RunPmCliErrorContext, code: string | undefined): Promise<void>;
-declare function handleRunPmCliHelpDisplayError(context: RunPmCliErrorContext, code: string | undefined, rawMessage: string): Promise<boolean>;
-declare function handleRunPmCliCommanderUsageError(context: RunPmCliErrorContext, code: string): Promise<void>;
-declare function shouldHandleRunPmCliCommanderError(error: unknown): boolean;
-declare function handleRunPmCliCommanderError(context: RunPmCliErrorContext): Promise<void>;
-declare function handleRunPmCliError(params: {
-error: unknown;
-invocationArgv: string[];
-}): Promise<void>;
+declare function handleUnknownHelpCommandError(context:RunPmCliErrorContext,code:string | undefined):Promise<void>;
+declare function handleRunPmCliHelpDisplayError(context:RunPmCliErrorContext,code:string | undefined,rawMessage:string):Promise<boolean>;
+declare function handleRunPmCliCommanderUsageError(context:RunPmCliErrorContext,code:string):Promise<void>;
+declare function shouldHandleRunPmCliCommanderError(error:unknown):boolean;
+declare function handleRunPmCliCommanderError(context:RunPmCliErrorContext):Promise<void>;
+declare function handleRunPmCliError(params:{
+error:unknown;
+invocationArgv:string[];
+}):Promise<void>;
 /** Implements run pm cli for the public runtime surface of this module. */
-export declare function runPmCli(rawArgv?: string[]): Promise<void>;
+export declare function runPmCli(rawArgv?:string[]):Promise<void>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-activationCommandMatchesProbe: typeof activationCommandMatchesProbe;
-applyDynamicExtensionRootHelpVisibility: typeof applyDynamicExtensionRootHelpVisibility;
-bootstrapProfileEnabled: typeof bootstrapProfileEnabled;
-buildBootstrapActivationProbe: typeof buildBootstrapActivationProbe;
-buildPostActionTelemetryOutcome: typeof buildPostActionTelemetryOutcome;
-buildPmCliRecoveryContext: typeof buildPmCliRecoveryContext;
-buildRuntimeExtensionDiscoverySnapshotCacheKey: typeof buildRuntimeExtensionDiscoverySnapshotCacheKey;
-buildRuntimeExtensionActivationScope: typeof buildRuntimeExtensionActivationScope;
-buildRuntimeExtensionSnapshotCacheKey: typeof buildRuntimeExtensionSnapshotCacheKey;
-buildRuntimeExtensionFilterForProbe: typeof buildRuntimeExtensionFilterForProbe;
-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;
-ensureIdempotentTopLevelCommandRegistration: typeof ensureIdempotentTopLevelCommandRegistration;
-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;
-hasGlobalExtensionContributions: typeof hasGlobalExtensionContributions;
-handleGenericRunPmCliError: typeof handleGenericRunPmCliError;
-handleRunPmCliCommanderError: typeof handleRunPmCliCommanderError;
-handleRunPmCliError: typeof handleRunPmCliError;
-handleRunPmCliHelpDisplayError: typeof handleRunPmCliHelpDisplayError;
-handleRunPmCliKnownError: typeof handleRunPmCliKnownError;
-handleRunPmCliCommanderUsageError: typeof handleRunPmCliCommanderUsageError;
-handleUnknownHelpCommandError: typeof handleUnknownHelpCommandError;
-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;
-matchesStaticExtensionCommand: typeof matchesStaticExtensionCommand;
-normalizeTelemetryCommandResolution: typeof normalizeTelemetryCommandResolution;
-normalizeTelemetryErrorCategory: typeof normalizeTelemetryErrorCategory;
-normalizeTelemetryResolutionStage: typeof normalizeTelemetryResolutionStage;
-normalizeThrownExitCode: typeof normalizeThrownExitCode;
-probeUsesAnyFlag: typeof probeUsesAnyFlag;
-prepareExtensionServicesForRunPmCliError: typeof prepareExtensionServicesForRunPmCliError;
-readRecordBoolean: typeof readRecordBoolean;
-readRecordNumber: typeof readRecordNumber;
-readRecordString: typeof readRecordString;
-recordCliReadOutputInvocationProvenance: typeof recordCliReadOutputInvocationProvenance;
-registerDynamicExtensionCommandPaths: typeof registerDynamicExtensionCommandPaths;
-registerRuntimeSchemaFieldFlags: typeof registerRuntimeSchemaFieldFlags;
-resolveCoreCommandRegistrationSelection: typeof resolveCoreCommandRegistrationSelection;
-resolveStaticExtensionActivationDecision: typeof resolveStaticExtensionActivationDecision;
-resolveUnknownHelpToken: typeof resolveUnknownCommanderToken;
-readThrownExitCode: typeof readThrownExitCode;
-runAndClearAfterCommandHooks: typeof runAndClearAfterCommandHooks;
-runRequiredExtensionCommand: typeof runRequiredExtensionCommand;
-shouldAttachRichHelpTextForInvocation: typeof shouldAttachRichHelpTextForInvocation;
-shouldLogHandledErrorToSentry: typeof shouldLogHandledErrorToSentry;
-shouldRegisterDynamicExtensionPaths: typeof shouldRegisterDynamicExtensionPaths;
-shouldRegisterRuntimeSchemaFlags: typeof shouldRegisterRuntimeSchemaFlags;
-shouldHandleRunPmCliCommanderError: typeof shouldHandleRunPmCliCommanderError;
-setActiveExtensionHookContextForTest: typeof setActiveExtensionHookContextForTest;
-setActiveRuntimeExtensionCommandDescriptorsForTest: typeof setActiveRuntimeExtensionCommandDescriptorsForTest;
-setRecoveredExtensionServices: typeof setRecoveredExtensionServices;
-toLooseFieldDefinitionType: typeof toLooseFieldDefinitionType;
-isImporterOrExporterCommandPath: typeof isImporterOrExporterCommandPath;
-validateDynamicExtensionCommandInvocation: typeof validateDynamicExtensionCommandInvocation;
-wrapProgramActionsForExtensionHandlers: typeof wrapProgramActionsForExtensionHandlers;
-wrapThrownErrorForSentry: typeof wrapThrownErrorForSentry;
+export declare const _testOnly:{
+activationCommandMatchesProbe:typeof activationCommandMatchesProbe;
+applyDynamicExtensionRootHelpVisibility:typeof applyDynamicExtensionRootHelpVisibility;
+bootstrapProfileEnabled:typeof bootstrapProfileEnabled;
+buildBootstrapActivationProbe:typeof buildBootstrapActivationProbe;
+buildPostActionTelemetryOutcome:typeof buildPostActionTelemetryOutcome;
+buildPmCliRecoveryContext:typeof buildPmCliRecoveryContext;
+buildRuntimeExtensionDiscoverySnapshotCacheKey:typeof buildRuntimeExtensionDiscoverySnapshotCacheKey;
+buildRuntimeExtensionActivationScope:typeof buildRuntimeExtensionActivationScope;
+buildRuntimeExtensionSnapshotCacheKey:typeof buildRuntimeExtensionSnapshotCacheKey;
+buildRuntimeExtensionFilterForProbe:typeof buildRuntimeExtensionFilterForProbe;
+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;
+ensureIdempotentTopLevelCommandRegistration:typeof ensureIdempotentTopLevelCommandRegistration;
+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;
+hasGlobalExtensionContributions:typeof hasGlobalExtensionContributions;
+handleGenericRunPmCliError:typeof handleGenericRunPmCliError;
+handleRunPmCliCommanderError:typeof handleRunPmCliCommanderError;
+handleRunPmCliError:typeof handleRunPmCliError;
+handleRunPmCliHelpDisplayError:typeof handleRunPmCliHelpDisplayError;
+handleRunPmCliKnownError:typeof handleRunPmCliKnownError;
+handleRunPmCliCommanderUsageError:typeof handleRunPmCliCommanderUsageError;
+handleUnknownHelpCommandError:typeof handleUnknownHelpCommandError;
+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;
+matchesStaticExtensionCommand:typeof matchesStaticExtensionCommand;
+normalizeTelemetryCommandResolution:typeof normalizeTelemetryCommandResolution;
+normalizeTelemetryErrorCategory:typeof normalizeTelemetryErrorCategory;
+normalizeTelemetryResolutionStage:typeof normalizeTelemetryResolutionStage;
+normalizeThrownExitCode:typeof normalizeThrownExitCode;
+probeUsesAnyFlag:typeof probeUsesAnyFlag;
+prepareExtensionServicesForRunPmCliError:typeof prepareExtensionServicesForRunPmCliError;
+readRecordBoolean:typeof readRecordBoolean;
+readRecordNumber:typeof readRecordNumber;
+readRecordString:typeof readRecordString;
+recordCliReadOutputInvocationProvenance:typeof recordCliReadOutputInvocationProvenance;
+registerDynamicExtensionCommandPaths:typeof registerDynamicExtensionCommandPaths;
+registerRuntimeSchemaFieldFlags:typeof registerRuntimeSchemaFieldFlags;
+resolveCoreCommandRegistrationSelection:typeof resolveCoreCommandRegistrationSelection;
+resolveStaticExtensionActivationDecision:typeof resolveStaticExtensionActivationDecision;
+resolveUnknownHelpToken:typeof resolveUnknownCommanderToken;
+readThrownExitCode:typeof readThrownExitCode;
+runAndClearAfterCommandHooks:typeof runAndClearAfterCommandHooks;
+runRequiredExtensionCommand:typeof runRequiredExtensionCommand;
+shouldAttachRichHelpTextForInvocation:typeof shouldAttachRichHelpTextForInvocation;
+shouldLogHandledErrorToSentry:typeof shouldLogHandledErrorToSentry;
+shouldRegisterDynamicExtensionPaths:typeof shouldRegisterDynamicExtensionPaths;
+shouldRegisterRuntimeSchemaFlags:typeof shouldRegisterRuntimeSchemaFlags;
+shouldHandleRunPmCliCommanderError:typeof shouldHandleRunPmCliCommanderError;
+setActiveExtensionHookContextForTest:typeof setActiveExtensionHookContextForTest;
+setActiveRuntimeExtensionCommandDescriptorsForTest:typeof setActiveRuntimeExtensionCommandDescriptorsForTest;
+setRecoveredExtensionServices:typeof setRecoveredExtensionServices;
+toLooseFieldDefinitionType:typeof toLooseFieldDefinitionType;
+isImporterOrExporterCommandPath:typeof isImporterOrExporterCommandPath;
+validateDynamicExtensionCommandInvocation:typeof validateDynamicExtensionCommandInvocation;
+wrapProgramActionsForExtensionHandlers:typeof wrapProgramActionsForExtensionHandlers;
+wrapThrownErrorForSentry:typeof wrapThrownErrorForSentry;
 };
 export {};