@unbrained/pm-cli 2026.10.14 → 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 {};

package/dist/cli/migration-gates.d.ts

@@ -7,49 +7,49 @@ import { type PreflightRuntimeDecision } from "../sdk/runtime-primitives.js";
 /** Documents the mandatory migration blocker payload exchanged by command, SDK, and package integrations. */
 export interface MandatoryMigrationBlocker {
 /** Value that configures or reports layer for this contract. */
-layer: "global" | "project";
+layer:"global" | "project";
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Lifecycle state reported for status. */
-status: string;
+status:string;
 }
 /** Documents the write gate decision payload exchanged by command, SDK, and package integrations. */
 export interface WriteGateDecision {
 /** Whether mutation applies to this operation. */
-isMutation: boolean;
+isMutation:boolean;
 /** Value that configures or reports force capable for this contract. */
-forceCapable: boolean;
+forceCapable:boolean;
 /** Value that configures or reports force requested for this contract. */
-forceRequested: boolean;
+forceRequested:boolean;
 }
 /** Implements resolve migration id for the public runtime surface of this module. */
-export declare function resolveMigrationId(definition: Record<string, unknown>, fallbackIndex: number): string;
+export declare function resolveMigrationId(definition:Record<string,unknown>,fallbackIndex:number):string;
 /** Implements resolve normalized migration status for the public runtime surface of this module. */
-export declare function resolveNormalizedMigrationStatus(definition: Record<string, unknown>): string;
+export declare function resolveNormalizedMigrationStatus(definition:Record<string,unknown>):string;
 /** Implements collect mandatory migration blockers for the public runtime surface of this module. */
-export declare function collectMandatoryMigrationBlockers(migrations: Array<{
-layer: "global" | "project";
-name: string;
-definition: Record<string, unknown>;
-}>): MandatoryMigrationBlocker[];
+export declare function collectMandatoryMigrationBlockers(migrations:Array<{
+layer:"global" | "project";
+name:string;
+definition:Record<string,unknown>;
+}>):MandatoryMigrationBlocker[];
 /** Implements decide write gate for the public runtime surface of this module. */
-export declare function decideWriteGate(commandPath: string, options: Record<string, unknown>): WriteGateDecision;
+export declare function decideWriteGate(commandPath:string,options:Record<string,unknown>):WriteGateDecision;
 /** Normalize configured active-status spellings for preflight comparison. */
-export declare function normalizedLifecycleStatus(value: string | undefined): string;
+export declare function normalizedLifecycleStatus(value:string | undefined):string;
 /** Convert incomplete schema-evolution CLI invocations into typed usage errors. */
-export declare function enforceSchemaMigrationInput(commandPath: string, commandArgs: string[], options: Record<string, unknown>): void;
+export declare function enforceSchemaMigrationInput(commandPath:string,commandArgs:string[],options:Record<string,unknown>):void;
 /**
  * Apply SDK-owned provenance and secret policy to one parsed CLI invocation.
  * Advisory output is stderr-only so JSON/TOON result envelopes stay unchanged.
  */
-export declare function enforceMutationGuardPreflight(commandPath: string, commandArgs: string[], options: Record<string, unknown>, global: {
-author?: string;
-force?: boolean;
-json?: boolean;
-}, pmRoot: string): Promise<void>;
+export declare function enforceMutationGuardPreflight(commandPath:string,commandArgs:string[],options:Record<string,unknown>,global:{
+author?:string;
+force?:boolean;
+json?:boolean;
+},pmRoot:string):Promise<void>;
 /** Implements enforce mandatory migration write gate for the public runtime surface of this module. */
-export declare function enforceMandatoryMigrationWriteGate(commandPath: string, options: Record<string, unknown>, blockers: MandatoryMigrationBlocker[]): void;
+export declare function enforceMandatoryMigrationWriteGate(commandPath:string,options:Record<string,unknown>,blockers:MandatoryMigrationBlocker[]):void;
 /** Implements enforce item format write gate and preflight migration for the public runtime surface of this module. */
-export declare function enforceItemFormatWriteGateAndPreflightMigration(commandPath: string, options: Record<string, unknown>, pmRoot: string, decision: PreflightRuntimeDecision): Promise<void>;
+export declare function enforceItemFormatWriteGateAndPreflightMigration(commandPath:string,options:Record<string,unknown>,pmRoot:string,decision:PreflightRuntimeDecision):Promise<void>;

package/dist/cli/option-values.d.ts

@@ -1,3 +1,3 @@
 /** @module cli/option-values Shared normalization for repeatable Commander option values. */
 /** Preserve collected arrays and legacy scalar values, leaving absent options undefined. */
-export declare function stringArrayOption(value: unknown): string[] | undefined;
+export declare function stringArrayOption(value:unknown):string[] | undefined;

package/dist/cli/public.d.ts

@@ -1,2 +1,2 @@
 /** Run one embedded CLI invocation without leaking its exit status into the host process. */
-export declare function runPmCli(rawArgv?: string[]): Promise<void>;
+export declare function runPmCli(rawArgv?:string[]):Promise<void>;

package/dist/cli/register-annotations.d.ts

@@ -6,6 +6,6 @@
  */
 import type { Command } from "commander";
 /** Converts a Commander token into a positive annotation index. */
-export type PositiveIntegerOptionParser = (value: string, previous: number | undefined) => number;
+export type PositiveIntegerOptionParser = (value:string,previous:number | undefined) => number;
 /** Register bounded annotation commands on the root Commander program. */
-export declare function registerAnnotationCommands(program: Command, parsePositiveInteger: (flag: string) => PositiveIntegerOptionParser): void;
+export declare function registerAnnotationCommands(program:Command,parsePositiveInteger:(flag:string) => PositiveIntegerOptionParser):void;

package/dist/cli/register-assurance.d.ts

@@ -5,4 +5,4 @@
  */
 import type { Command } from "commander";
 /** Register the declarative assurance command family. */
-export declare function registerAssuranceCommand(program: Command): void;
+export declare function registerAssuranceCommand(program:Command):void;

package/dist/cli/register-files-lookup.d.ts

@@ -6,4 +6,4 @@
  */
 import type { Command } from "commander";
 /** Register the reverse linked-file lookup below the existing files command. */
-export declare function registerFilesLookupCommand(filesCommand: Command): void;
+export declare function registerFilesLookupCommand(filesCommand:Command):void;

package/dist/cli/register-history-activity.d.ts

@@ -5,4 +5,4 @@
  */
 import type { Command } from "commander";
 /** Configure an activity leaf with the shared projection and streaming contract. */
-export declare function registerHistoryActivityCommand(command: Command): void;
+export declare function registerHistoryActivityCommand(command:Command):void;

package/dist/cli/register-history-author.d.ts

@@ -5,4 +5,4 @@
  */
 import type { Command } from "commander";
 /** Register the evidence-backed immutable-history author disposition command. */
-export declare function registerHistoryAuthorAcknowledgeCommand(program: Command): void;
+export declare function registerHistoryAuthorAcknowledgeCommand(program:Command):void;

package/dist/cli/register-history-maintenance.d.ts

@@ -6,4 +6,4 @@
  */
 import type { Command } from "commander";
 /** Install identical maintenance actions at the history namespace or legacy root. */
-export declare function registerHistoryMaintenanceCommands(parent: Command, native: boolean): void;
+export declare function registerHistoryMaintenanceCommands(parent:Command,native:boolean):void;