@unbrained/pm-cli 2026.10.12 → 2026.10.14

package/dist/cli/main.d.ts

@@ -18,35 +18,35 @@ import { buildPostActionTelemetryOutcome, inferPostActionErrorCode, inferPostAct
 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;
 /** Build replayable recovery guidance after removing sensitive matcher values from every invocation representation. */
@@ -55,30 +55,30 @@ declare function runAndClearAfterCommandHooks(outcome: TelemetryCommandOutcome):
 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;
+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;
-    }>;
+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 toLooseFieldDefinitionType(fieldType: string): "string" | "number" | "boolean";
 declare function commandHasLongOption(command: Command, longFlag: string): boolean;
@@ -98,14 +98,14 @@ declare function emitExtensionSkippedProfile(profileEnabled: boolean | undefined
 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;
+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>>;
@@ -135,29 +135,29 @@ declare function registerDynamicExtensionCommandPaths(rootProgram: Command, invo
  */
 declare function ensureIdempotentTopLevelCommandRegistration(rootProgram: Command): void;
 type TelemetryCommandErrorEmitter = (params: {
-    command: string;
-    errorCode: string;
-    errorMessage: string;
-    exitCode: number;
-    options: Record<string, unknown>;
-    resolutionStage: TelemetryResolutionStage;
+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;
+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>;
@@ -168,100 +168,100 @@ declare function handleRunPmCliCommanderUsageError(context: RunPmCliErrorContext
 declare function shouldHandleRunPmCliCommanderError(error: unknown): boolean;
 declare function handleRunPmCliCommanderError(context: RunPmCliErrorContext): Promise<void>;
 declare function handleRunPmCliError(params: {
-    error: unknown;
-    invocationArgv: string[];
+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>;
 /** 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;
+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 {};