@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/cli/main.js

@@ -1,4 +1,4 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="19f4cc1d-7f76-5759-878d-bfdf83194eca")}catch{}})();import{Command,CommanderError}from"commander";import{PM_COMMAND_ALIAS_CONTRACTS,findPmNamespacedCommand,resolvePmCommandOperation}from"../sdk/cli-contracts/command-aliases.js";import{createPmCliProgram}from"../sdk/cli-program.js";import{runWithDiscoveredContextIntentContracts}from"../sdk/context-intent-runtime.js";import{describeUnknownError,isCommanderError,normalizeThrownExitCode,readThrownExitCode,wrapThrownErrorForSentry}from"../sdk/error-runtime.js";import{createExtensionCommandSdk}from"../sdk/extension-command-context.js";import{runExtensionMigrations}from"../sdk/extension/migrations.js";import{repairProjectionRecovery}from"./runtime/projection-retry.js";import{applyInvocationAuthorOverride}from"../sdk/invocation-author.js";import{attachOutputTokenAccounting}from"../sdk/output-token-accounting.js";import{validateReadOutputOptions}from"../sdk/read-output-contracts.js";import{runWithReproducibleProcessEnvironment}from"../sdk/reproducibility/process.js";import{EXIT_CODE,PmCliError,activateExtensions,clearActiveExtensionHooks,consumeAfterCommandAffectedItems,createCoreCommandHookContext,createEmptyExtensionRegistrationRegistry,createLazyModule,deriveTelemetryCommandResolution,discoverExtensions,emitTelemetryErrorEvent,ensureSentryInit,getActiveCommandResult,getActiveExtensionRegistrations,getSettingsPath,loadExtensions,maybeRunFirstUseTelemetryPrompt,pathExists,printError,printResult,readSettings,readSettingsWithMetadata,resetActiveExtensionRuntimeState,resolveGlobalPmRoot,resolveItemTypeRegistry,resolvePmCliVersion,resolvePmPackageRootFromModule,resolvePmRoot,resolveRuntimeFieldRegistry,resolveTelemetryErrorCategory,runActiveCommandHandler,runActiveParserOverride,runActivePreflightOverride,runAfterCommandHooks,runBeforeCommandHooks,runWithConfigurationOnlySettings,runWithHarnessDetectionSignals,runWithWorkspaceHarnessSignalDescriptors,sentryCaptureCliError,sentryFinishCommandSpan,sentryFlush,sentryLogCliUsageError,sentrySetCommandContext,sentryStartCommandSpan,setActiveCommandContext,setActiveCommandResult,setActiveExtensionCommands,setActiveExtensionHooks,setActiveExtensionParsers,setActiveExtensionPreflight,setActiveExtensionRegistrations,setActiveExtensionRenderers,setActiveExtensionServices,startTelemetryCommand,writeStderr}from"../sdk/runtime-primitives.js";import{PmClient}from"../sdk/runtime.js";import{recordDeprecatedAliasUsage}from"../sdk/telemetry.js";import{finishActiveTelemetryCommand,recordAfterCommandContextUsage}from"./after-command-context-usage.js";import{extractProvidedOptionFlags,normalizeLongOptionFlag,redactSensitiveCommandArgs,renderPmCommand}from"./argv-utils.js";import{applyBootstrapPagerPolicy,findBootstrapCommandTokenIndex,normalizeBootstrapInvocation,parseBootstrapCommandName,parseBootstrapGlobalOptions,parseBootstrapHelpRequest,stripGlobalBootstrapTokens}from"./bootstrap-args.js";import{installCommandNamespaces}from"./command-namespaces.js";import{appendCommanderExtensionFailures,formatCommanderUsageJson,formatCommanderUsageMessage,isKnownHelpCommandPath,resolveCommanderUsageContext,resolveUnknownCommanderToken}from"./commander-usage.js";import{loadContextIntentSnapshotForInvocation}from"./context-intent-invocation.js";import{classifyCommanderError,classifyPmCliError,classifyUnknownError,formatPmCliErrorForDisplay,formatPmCliErrorForJson,formatUnknownErrorForJson,projectLeanErrorEnvelope}from"./error-guidance.js";import{applyDynamicExtensionArguments,applyDynamicExtensionFlagOptions,buildCanonicalExtensionAliases,buildDynamicExtensionCommandMetadataHelp,buildResidualDynamicExtensionFlagHelp,collectDynamicExtensionFlagHelpByCommand,collectExtensionCommandHelpDescriptors,collectSafeExtensionCommandPaths,ensureCommandPath,extensionFlagTakesValueForInvocation,findCommandByPath,normalizeExtensionCommandPath,reportExtensionCommandCollision}from"./extension-command-help.js";import{collectLoosePositionalArgs,stripLooseCommandOptionTokens}from"./extension-command-options.js";import{loadExtensionRecoveryFailures,loadUnknownCommandRecoveryFailures}from"./extension-recovery.js";import{attachRichHelpText,isFullHelpDiscovery,setPmCommandHelpVisibilityTier}from"./help-content.js";import{attachCreateUpdatePolicyHelpText,maybeRenderBootstrapJsonHelp}from"./help-json-payload.js";import{collectMandatoryMigrationBlockers,enforceItemFormatWriteGateAndPreflightMigration,enforceMandatoryMigrationWriteGate,enforceMutationGuardPreflight}from"./migration-gates.js";import{applyDefaultOutputFormat,clearResolvedGlobalOptions,collect,formatHookWarnings,getCommandPath,getGlobalOptions,invalidateSearchCachesForMutation,setResolvedGlobalOptions,syncCommanderActionOptions}from"./registration-helpers.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,copyReadOutputInvocationProvenance,dynamicCommandArguments,extractCommandScopedOptions,forwardReadOutputIncludeModes,isImporterOrExporterCommandPath,recordCliReadOutputInvocationProvenance,validateDynamicExtensionCommandArgs,validateDynamicExtensionCommandInvocation}from"./runtime/invocation-options.js";import{LIST_QUERY_COMMAND_NAMES,enforceExplicitRetryForFlagTypos,invocationRequestsVersion,isStaticExtensionInventoryInvocation,resolveStructuredMutationPreviewInvocation,resolveCoreCommandRegistrationSelection,shouldAttachRichHelpTextForInvocation,shouldRegisterDynamicExtensionPaths,shouldRegisterRuntimeSchemaFlags}from"./runtime/selection.js";import{buildPostActionTelemetryOutcome,inferPostActionErrorCode,inferPostActionFailureMessage,normalizeTelemetryCommandResolution,normalizeTelemetryErrorCategory,normalizeTelemetryResolutionStage,readRecordBoolean,readRecordNumber,readRecordString}from"./runtime/telemetry-outcome.js";const PM_PACKAGE_ROOT_ENV="PM_CLI_PACKAGE_ROOT",DEPRECATED_ALIAS_INVOCATION=Symbol("pm.deprecatedAliasInvocation"),COMMAND_ALIASES_BY_FIRST_TOKEN=new Map;for(const contract of PM_COMMAND_ALIAS_CONTRACTS){const firstToken=contract.alias.split(" ")[0],matches=COMMAND_ALIASES_BY_FIRST_TOKEN.get(firstToken)??[];matches.push(contract),COMMAND_ALIASES_BY_FIRST_TOKEN.set(firstToken,matches)}for(const matches of COMMAND_ALIASES_BY_FIRST_TOKEN.values())matches.sort((left,right)=>right.alias.split(" ").length-left.alias.split(" ").length);function resolvePmPackageRoot(){return resolvePmPackageRootFromModule(import.meta.url,["../.."])}(typeof process.env[PM_PACKAGE_ROOT_ENV]!="string"||process.env[PM_PACKAGE_ROOT_ENV]?.trim().length===0)&&(process.env[PM_PACKAGE_ROOT_ENV]=resolvePmPackageRoot());let activeExtensionHookContext=null,activeTelemetryCommandContext=null;function setActiveExtensionHookContextForTest(context){activeExtensionHookContext=context}function setActiveRuntimeExtensionCommandDescriptorsForTest(descriptors){activeRuntimeExtensionCommandDescriptors=descriptors}let runtimeExtensionSnapshotCache=null,runtimeExtensionDiscoverySnapshotCache=null,activeRuntimeExtensionCommandDescriptors=new Map;const HANDLED_ERROR_SENTRY_FLUSH_TIMEOUT_MS=250,EXPECTED_HANDLED_ERROR_EXIT_CODES=new Set([EXIT_CODE.USAGE,EXIT_CODE.NOT_FOUND,EXIT_CODE.CONFLICT]),TRUE_LIKE_ENV_VALUES=new Set(["1","true","yes","on"]),loadSetupRegistrationModule=createLazyModule(()=>import("./register-setup.js")),loadListQueryRegistrationModule=createLazyModule(()=>import("./register-list-query.js")),loadMutationRegistrationModule=createLazyModule(()=>import("./register-mutation.js")),loadOperationRegistrationModule=createLazyModule(()=>import("./register-operations.js"));function renderAttemptedCommand(argv){return renderPmCommand(argv)}function inferMissingFieldsFromErrorMessage(message){const matches=message.match(/--[a-zA-Z0-9][a-zA-Z0-9_-]*/g);if(!matches||matches.length===0)return;const normalized=[...new Set(matches.map(entry=>normalizeLongOptionFlag(entry)??entry))];return normalized.length>0?normalized:void 0}function inferMissingFieldsForRecovery(rawMessage,invocationArgv,existingRecovery){if(existingRecovery?.suggested_retry||rawMessage.includes("failed in extension handler (")||!/\b(?:missing|required|requires)\b/i.test(rawMessage))return;const providedFields=extractProvidedOptionFlags(invocationArgv),providedSet=new Set(providedFields.map(flag=>normalizeLongOptionFlag(flag)??flag)),rawInferred=inferMissingFieldsFromErrorMessage(rawMessage),commandName=invocationArgv.find(token=>program.commands.some(candidate=>candidate.name()===token)),command=commandName?program.commands.find(candidate=>candidate.name()===commandName):void 0,declaredFlags=new Set([...program.options,...command?.options??[]].flatMap(option=>option.flags.split(/[ ,|]+/).map(flag=>normalizeLongOptionFlag(flag)).filter(flag=>flag!==void 0))),trulyMissing=rawInferred?.filter(flag=>{const normalized=normalizeLongOptionFlag(flag)??flag;return providedSet.has(normalized)?!1:declaredFlags.has(normalized)||extensionFlagTakesValueForInvocation(invocationArgv,commandName,normalized,activeRuntimeExtensionCommandDescriptors)!==void 0});return trulyMissing&&trulyMissing.length>0?trulyMissing:void 0}function resolveRecoverySuggestedRetry(invocationArgv,attemptedCommand,inferredMissing,existingRecovery){if(existingRecovery?.suggested_retry)return existingRecovery.suggested_retry;const missingFlag=inferredMissing?.[0],normalizedMissing=missingFlag?normalizeLongOptionFlag(missingFlag):void 0,commandName=invocationArgv.find(token=>program.commands.some(candidate=>candidate.name()===token)),command=commandName?program.commands.find(candidate=>candidate.name()===commandName):void 0,missingOption=normalizedMissing?command?.options.find(option=>option.flags.split(/[ ,|]+/).includes(normalizedMissing)):void 0,extensionFlagTakesValue=extensionFlagTakesValueForInvocation(invocationArgv,commandName,normalizedMissing,activeRuntimeExtensionCommandDescriptors),missingTokens=normalizedMissing?missingOption?.isBoolean()===!0||extensionFlagTakesValue===!1?[normalizedMissing]:[normalizedMissing,"<value>"]:[],suggestedRetry=normalizedMissing?renderAttemptedCommand([...invocationArgv,...missingTokens]):attemptedCommand;return suggestedRetry===attemptedCommand?void 0:suggestedRetry}function projectExistingRecoveryOptionalFields(existingRecovery){if(!existingRecovery)return{};const optionalFields=["recovery_mode","missing_required_fields","suggested_flags","suggested_retry_args","allowed_values","candidate_commands","candidate_commands_total","candidate_commands_truncated","fallback_candidates","next_best_command"],projected={};for(const field of optionalFields){const value=existingRecovery[field];value!=null&&(projected[field]=value)}return projected}function buildRecoveryPayload(params){const existingRecovery=params.existingRecovery;return{attempted_command:existingRecovery?.attempted_command??params.attemptedCommand,normalized_args:existingRecovery?.normalized_args??[...params.invocationArgv],provided_fields:existingRecovery?.provided_fields??(params.providedFields.length>0?params.providedFields:void 0),missing:existingRecovery?.missing??params.inferredMissing,...projectExistingRecoveryOptionalFields(existingRecovery),...params.suggestedRetry?{suggested_retry:params.suggestedRetry}:{}}}function buildPmCliRecoveryContext(context,invocationArgv,rawMessage){const safeInvocationArgv=redactSensitiveCommandArgs(invocationArgv),commandArgs=stripGlobalBootstrapTokens(safeInvocationArgv),commandIndex=findBootstrapCommandTokenIndex(commandArgs),[rootCommand,subcommand]=commandIndex===void 0?[]:commandArgs.slice(commandIndex,commandIndex+2),explainRequested=safeInvocationArgv.includes("--explain"),rawExistingRecovery=repairProjectionRecovery(safeInvocationArgv,context?.code,context?.recovery),existingRecovery=rawExistingRecovery&&(rootCommand==="history-redact"||rootCommand==="history"&&subcommand==="redact")?{...rawExistingRecovery,...rawExistingRecovery.attempted_command?{attempted_command:renderAttemptedCommand(safeInvocationArgv)}:{},...rawExistingRecovery.normalized_args?{normalized_args:[...safeInvocationArgv]}:{},...rawExistingRecovery.suggested_retry?{suggested_retry:renderAttemptedCommand(safeInvocationArgv)}:{},...rawExistingRecovery.suggested_retry_args?{suggested_retry_args:[...safeInvocationArgv]}:{}}:rawExistingRecovery;if(existingRecovery?.recovery_mode==="compact"&&!explainRequested)return{...context,recovery:existingRecovery};const attemptedCommand=renderAttemptedCommand(safeInvocationArgv),providedFields=extractProvidedOptionFlags(safeInvocationArgv),inferredMissing=inferMissingFieldsForRecovery(rawMessage,safeInvocationArgv,existingRecovery),suggestedRetry=resolveRecoverySuggestedRetry(safeInvocationArgv,attemptedCommand,inferredMissing,existingRecovery),recovery=buildRecoveryPayload({invocationArgv:safeInvocationArgv,attemptedCommand,providedFields,inferredMissing,suggestedRetry,existingRecovery});return{...context,recovery}}async function runAndClearAfterCommandHooks(outcome){const telemetryRuntime=activeTelemetryCommandContext;activeTelemetryCommandContext=null,await finishActiveTelemetryCommand(telemetryRuntime,outcome);const runtime=activeExtensionHookContext;if(activeExtensionHookContext=null,!runtime){clearActiveExtensionHooks();return}let hookWarnings=[];const affected=consumeAfterCommandAffectedItems();try{await recordAfterCommandContextUsage({pmRoot:runtime.pmRoot,author:runtime.globalOptions.author,itemIds:outcome.ok?affected?.map(item=>item.id)??[]:[],intent:runtime.commandName})}catch{hookWarnings.push("context_usage_feedback_write_failed")}try{hookWarnings.push(...await runAfterCommandHooks(runtime.hooks,{command:runtime.commandName,args:runtime.commandArgs,options:{...runtime.commandOptions},global:{...runtime.globalOptions},pm_root:runtime.pmRoot,ok:outcome.ok,error:outcome.error,result:getActiveCommandResult(),affected}))}catch(error){hookWarnings=[`afterCommand hooks failed: ${error instanceof Error?error.message:String(error)}`]}finally{clearActiveExtensionHooks()}!runtime.globalOptions.json&&hookWarnings.length>0&&printError(`[pm] warning: afterCommand hook_warnings=${formatHookWarnings(hookWarnings)}`),runtime.profileEnabled&&hookWarnings.length>0&&printError(`profile:extensions hook_warnings=${formatHookWarnings(hookWarnings)}`)}async function ensureSentryForErrorReporting(){await ensureSentryInit()}function envFlagEnabled(key){return TRUE_LIKE_ENV_VALUES.has((process.env[key]??"").trim().toLowerCase())}function shouldLogHandledErrorToSentry(exitCode){return envFlagEnabled("PM_SENTRY_CAPTURE_EXPECTED_ERRORS")?!0:!EXPECTED_HANDLED_ERROR_EXIT_CODES.has(Math.trunc(exitCode))}async function maybeLogHandledCliErrorToSentry(params){return shouldLogHandledErrorToSentry(params.exit_code)?(await ensureSentryForErrorReporting(),sentryLogCliUsageError(params),!0):!1}async function handleGenericRunPmCliError(params){const message=describeUnknownError(params.error),classification=classifyUnknownError(message);params.bootstrapGlobal.json?printError(JSON.stringify(formatUnknownErrorForJson(message,EXIT_CODE.GENERIC_FAILURE),null,2)):printError(message),process.exitCode=EXIT_CODE.GENERIC_FAILURE;let errorCategory="runtime",commandResolution="runtime_failed";try{await ensureSentryForErrorReporting(),sentryCaptureCliError(params.error);const telemetry=await params.emitTelemetryCommandError({command:params.attemptedCommand,errorCode:classification.code,errorMessage:classification.detail,exitCode:EXIT_CODE.GENERIC_FAILURE,options:{bootstrap_global_options:params.bootstrapGlobal},resolutionStage:"execute"});errorCategory=telemetry.errorCategory,commandResolution=telemetry.commandResolution,sentryFinishCommandSpan(!1,message,{error_code:classification.code,error_category:errorCategory,exit_code:EXIT_CODE.GENERIC_FAILURE,command_resolution:commandResolution,resolution_stage:"execute"})}catch(reportingError){params.bootstrapGlobal.json||printError(`Failed to report error: ${describeUnknownError(reportingError)}`)}try{await runAndClearAfterCommandHooks({ok:!1,error:message,exit_code:EXIT_CODE.GENERIC_FAILURE,error_code:classification.code,error_category:errorCategory,command_resolution:commandResolution,resolution_stage:"execute"})}catch(hookError){params.bootstrapGlobal.json||printError(`Failed to run error hooks: ${describeUnknownError(hookError)}`)}try{await sentryFlush()}catch(flushError){params.bootstrapGlobal.json||printError(`Failed to flush error reporting: ${describeUnknownError(flushError)}`)}}const RUNTIME_FIELD_COMMAND_BY_COMMAND_PATH={create:"create",update:"update","update-many":"update_many",list:"list","list-all":"list","list-draft":"list","list-open":"list","list-in-progress":"list","list-blocked":"list","list-closed":"list","list-canceled":"list",search:"search",calendar:"calendar",context:"context","templates save":"create"},runtimeFieldLooseFlagDefinitionCache=new Map;function toLooseFieldDefinitionType(fieldType){return fieldType==="number"?"number":fieldType==="boolean"?"boolean":"string"}function commandHasLongOption(command,longFlag){return command.options.some(option=>option.long===longFlag)}function commandHasShortOption(command,shortFlag){return command.options.some(option=>option.short===shortFlag)}function addRuntimeFieldOption(command,flagToken,description,repeatable){const normalizedToken=flagToken.trim();if(!normalizedToken)return;const helpText=description.length>0?description:`Runtime schema field (${flagToken})`;if(normalizedToken.startsWith("-")&&!normalizedToken.startsWith("--")){if(commandHasShortOption(command,normalizedToken))return;if(repeatable){command.option(`${normalizedToken} <value>`,`${helpText} (repeatable)`,collect);return}command.option(`${normalizedToken} <value>`,helpText);return}const longFlag=normalizedToken.startsWith("--")?normalizedToken:`--${normalizedToken}`;if(!commandHasLongOption(command,longFlag)){if(repeatable){command.option(`${longFlag} <value>`,`${helpText} (repeatable)`,collect);return}command.option(`${longFlag} <value>`,helpText)}}async function collectRuntimeFieldLooseFlagDefinitionsForCommand(commandPath,pmRoot){const runtimeCommand=RUNTIME_FIELD_COMMAND_BY_COMMAND_PATH[commandPath];if(!runtimeCommand)return[];const cacheKey=`${pmRoot}:${runtimeCommand}`,cached=runtimeFieldLooseFlagDefinitionCache.get(cacheKey);if(cached)return cached;if(!await pathExists(getSettingsPath(pmRoot)))return runtimeFieldLooseFlagDefinitionCache.set(cacheKey,[]),[];const settings=await readSettings(pmRoot),definitions=(resolveRuntimeFieldRegistry(settings.schema).command_to_fields.get(runtimeCommand)??[]).flatMap(field=>[field.cli_flag,...field.cli_aliases].map(token=>({long:`--${token}`,type:toLooseFieldDefinitionType(field.type),value_type:toLooseFieldDefinitionType(field.type)})));return runtimeFieldLooseFlagDefinitionCache.set(cacheKey,definitions),definitions}async function registerRuntimeSchemaFieldFlags(rootProgram,invocationArgv){const bootstrapGlobalOptions=parseBootstrapGlobalOptions(invocationArgv),pmRoot=resolvePmRoot(process.cwd(),bootstrapGlobalOptions.path);if(!await pathExists(getSettingsPath(pmRoot)))return;const cachedDiscovery=runtimeExtensionDiscoverySnapshotCache?.key===buildRuntimeExtensionDiscoverySnapshotCacheKey(pmRoot)?runtimeExtensionDiscoverySnapshotCache.snapshot:null,settings=cachedDiscovery===null?await readSettings(pmRoot):cachedDiscovery.settings,fieldRegistry=resolveRuntimeFieldRegistry(settings.schema),mappings=[{path:"create",command:"create"},{path:"update",command:"update"},{path:"update-many",command:"update_many"},{path:"list",command:"list"},{path:"list-all",command:"list"},{path:"list-draft",command:"list"},{path:"list-open",command:"list"},{path:"list-in-progress",command:"list"},{path:"list-blocked",command:"list"},{path:"list-closed",command:"list"},{path:"list-canceled",command:"list"},{path:"search",command:"search"},{path:"calendar",command:"calendar"},{path:"context",command:"context"},{path:"templates save",command:"create"}];for(const mapping of mappings){const command=findCommandByPath(rootProgram,mapping.path.split(" "));if(command)for(const field of fieldRegistry.command_to_fields.get(mapping.command)??[]){const description=field.description??"";addRuntimeFieldOption(command,field.cli_flag,description,field.repeatable);for(const alias of field.cli_aliases)addRuntimeFieldOption(command,alias,`Alias for --${field.cli_flag}`,field.repeatable)}}}async function maybeAttachCreateUpdatePolicyHelpText(rootProgram,pmRoot,invocationArgv,registrations,settings){const bootstrapCommand=parseBootstrapCommandName(invocationArgv);if(!(bootstrapCommand!=="create"&&bootstrapCommand!=="update"))try{const resolvedSettings=settings??await readSettings(pmRoot),typeRegistry=resolveItemTypeRegistry(resolvedSettings,registrations);attachCreateUpdatePolicyHelpText(rootProgram,typeRegistry,invocationArgv)}catch{}}function defaultPreflightDecision(){return{enforce_item_format_gate:!0,run_preflight_item_format_sync:!0,run_extension_migrations:!0,enforce_mandatory_migration_gate:!0}}function buildRuntimeExtensionSnapshotCacheKey(pmRoot,activationScope="all"){return activationScope==="all"?`pm-root:${pmRoot}`:`pm-root:${pmRoot}:activation:${activationScope}`}function bootstrapProfileEnabled(invocationArgv){return invocationArgv.some(token=>token==="--profile")}function buildRuntimeExtensionDiscoverySnapshotCacheKey(pmRoot){return`pm-root:${pmRoot}`}function emitSettingsReadWarnings(warnings){for(const warning of warnings)warning.startsWith("settings_read_")&&printError(`[pm] warning: ${warning} \u2014 settings.json could not be loaded and pm fell back to defaults; run pm health for remediation.`)}function emitExtensionProfile(globalOptions,snapshot){globalOptions.profile&&(printError(`profile:extensions loaded=${snapshot.loadedCount} failed=${snapshot.loadFailedCount} warnings=${snapshot.loadWarnings.length} activation_failed=${snapshot.activationFailedCount} hook_counts=before:${snapshot.hooks.beforeCommand.length}|after:${snapshot.hooks.afterCommand.length}|write:${snapshot.hooks.onWrite.length}|read:${snapshot.hooks.onRead.length}|index:${snapshot.hooks.onIndex.length} command_overrides=${snapshot.commands.overrides.length} command_handlers=${snapshot.commands.handlers.length} parser_overrides=${snapshot.parsers.overrides.length} preflight_overrides=${snapshot.preflight.overrides.length} service_overrides=${snapshot.services.overrides.length} renderer_overrides=${snapshot.renderers.overrides.length}`),snapshot.activationWarnings.length>0&&printError(`profile:extensions activation_warnings=${formatHookWarnings(snapshot.activationWarnings)}`))}function emitExtensionSkippedProfile(profileEnabled,snapshot,probe){if(!profileEnabled)return;const command=normalizeExtensionCommandPath(probe.commandPath??"")||"<none>";printError(`profile:extensions activation=skipped command=${command} effective=${snapshot.discovery.effective.length} warnings=${snapshot.discovery.warnings.length} discovery_ms=${snapshot.discoveryMs}`)}async function loadRuntimeExtensionDiscoverySnapshot(pmRoot,readSettingsWithMetadataFn=readSettingsWithMetadata){const cacheKey=buildRuntimeExtensionDiscoverySnapshotCacheKey(pmRoot);if(runtimeExtensionDiscoverySnapshotCache?.key===cacheKey)return runtimeExtensionDiscoverySnapshotCache.snapshot;try{const startedAt=Date.now(),{settings,warnings:settingsReadWarnings}=await readSettingsWithMetadataFn(pmRoot),discovery=await discoverExtensions({pmRoot,settings,cwd:process.cwd(),noExtensions:!1}),snapshot={pmRoot,settings,discovery,discoveryMs:Date.now()-startedAt,settingsReadWarnings:[...settingsReadWarnings]};return runtimeExtensionDiscoverySnapshotCache={key:cacheKey,snapshot},snapshot}catch{return runtimeExtensionDiscoverySnapshotCache={key:cacheKey,snapshot:null},null}}async function loadRuntimeExtensionSnapshot(pmRoot,probe,readSettingsFn=readSettings){const activationScope=probe?buildRuntimeExtensionActivationScope(probe):"all",cacheKey=buildRuntimeExtensionSnapshotCacheKey(pmRoot,activationScope);if(runtimeExtensionSnapshotCache?.key===cacheKey)return runtimeExtensionSnapshotCache.snapshot;try{const settings=await readSettingsFn(pmRoot),loadResult=await loadExtensions({pmRoot,settings,cwd:process.cwd(),noExtensions:!1,extensionFilter:probe?buildRuntimeExtensionFilterForProbe(probe):void 0}),activationResult=await activateExtensions({...loadResult,loaded:loadResult.loaded}),commandHandlers=[...new Set(activationResult.commands.handlers.map(entry=>normalizeExtensionCommandPath(entry.command)))].filter(entry=>entry.length>0).sort((left,right)=>left.localeCompare(right)),commandFlagHelp=collectDynamicExtensionFlagHelpByCommand(activationResult.registrations.flags),canonicalAliases=buildCanonicalExtensionAliases(activationResult.commands.handlers,activationResult.registrations.commands),commandDescriptors=collectExtensionCommandHelpDescriptors(commandHandlers,activationResult.registrations.commands,activationResult.registrations.flags,canonicalAliases),snapshot={hooks:activationResult.hooks,commands:activationResult.commands,parsers:activationResult.parsers,preflight:activationResult.preflight,services:activationResult.services,renderers:activationResult.renderers,registrations:activationResult.registrations,pmRoot,settings,commandHandlers,commandFlagHelp,commandDescriptors,commandAliases:canonicalAliases,loadWarnings:[...loadResult.warnings],activationWarnings:[...activationResult.warnings],loadedCount:loadResult.loaded.length,loadFailedCount:loadResult.failed.length,activationFailedCount:activationResult.failed.length,contextIntentPackages:loadResult.loaded.map(({name,module})=>({name,module}))};return runtimeExtensionSnapshotCache={key:cacheKey,snapshot},snapshot}catch{return runtimeExtensionSnapshotCache={key:cacheKey,snapshot:null},null}}async function maybeLoadRuntimeExtensions(command){const globalOptions=getGlobalOptions(command);if(globalOptions.noExtensions){const noExtPmRoot=resolvePmRoot(process.cwd(),globalOptions.path);return await pathExists(getSettingsPath(noExtPmRoot))&&emitSettingsReadWarnings((await readSettingsWithMetadata(noExtPmRoot)).warnings),null}const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),discoverySnapshot=await loadRuntimeExtensionDiscoverySnapshot(pmRoot);if(!discoverySnapshot)return null;emitSettingsReadWarnings(discoverySnapshot.settingsReadWarnings);const probe={commandPath:getCommandPath(command),commandArgs:collectParsedActivationCommandArgs(command)};if(!discoveryNeedsActivationForProbe(discoverySnapshot.discovery,probe))return emitExtensionSkippedProfile(globalOptions.profile,discoverySnapshot,probe),null;const snapshot=await loadRuntimeExtensionSnapshot(pmRoot,probe);return snapshot?(emitExtensionProfile(globalOptions,snapshot),{hooks:snapshot.hooks,commands:snapshot.commands,parsers:snapshot.parsers,preflight:snapshot.preflight,services:snapshot.services,renderers:snapshot.renderers,registrations:snapshot.registrations,pmRoot}):null}async function loadRuntimeExtensionCommandDescriptorsForRecovery(pmRoot){const snapshot=await loadRuntimeExtensionSnapshot(pmRoot);return snapshot?new Map(snapshot.commandDescriptors):activeRuntimeExtensionCommandDescriptors}async function resolveHelpRecoveryDescriptors(helpRequest,bootstrapGlobal){return!helpRequest.requested||bootstrapGlobal.noExtensions||isKnownHelpCommandPath(program,helpRequest.commandPathTokens)?activeRuntimeExtensionCommandDescriptors:loadRuntimeExtensionCommandDescriptorsForRecovery(resolvePmRoot(process.cwd(),bootstrapGlobal.path))}async function executeRegisteredRuntimeMigrations(migrations,pmRoot){return(await runExtensionMigrations({pmRoot,migrations,author:"pm-extension-migration"})).migrations.filter(migration=>migration.outcome==="failed").map(migration=>`extension_migration_failed:${migration.layer}:${migration.extension}:${migration.id}`)}function buildExtensionCommandSdk(pmRoot,global2,commandPath){const author=typeof global2.author=="string"&&global2.author.trim()?global2.author.trim():"pm-extension";return createExtensionCommandSdk(pmRoot,PmClient.forActiveExtensionHost({pmRoot,author}),author,normalizeExtensionCommandPath(commandPath))}async function runRequiredExtensionCommand(command,options,globalOptions,extensionFlagDefinitions=[]){const commandPath=getCommandPath(command);let commandArgs=stripLooseCommandOptionTokens(command.args.map(String),extensionFlagDefinitions),commandOptions={...options},resolvedGlobalOptions={...globalOptions};const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),parserOverride=await runActiveParserOverride({command:commandPath,args:commandArgs,options:commandOptions,global:resolvedGlobalOptions,pm_root:pmRoot});globalOptions.profile&&parserOverride.warnings.length>0&&printError(`profile:extensions parser_warnings=${formatHookWarnings(parserOverride.warnings)}`),commandArgs=parserOverride.context.args,commandOptions=parserOverride.context.options,resolvedGlobalOptions=parserOverride.context.global,validateDynamicExtensionCommandInvocation(activeRuntimeExtensionCommandDescriptors.get(normalizeExtensionCommandPath(commandPath)),commandArgs,commandOptions,extensionFlagDefinitions),setActiveCommandResult(void 0),setActiveCommandContext({command:commandPath,args:commandArgs,options:{...commandOptions},global:{...resolvedGlobalOptions},pm_root:pmRoot});const extensionCommandResult=await runActiveCommandHandler({command:commandPath,args:commandArgs,options:commandOptions,global:resolvedGlobalOptions,pm_root:pmRoot,sdk:buildExtensionCommandSdk(pmRoot,resolvedGlobalOptions,commandPath)});if(resolvedGlobalOptions.profile&&extensionCommandResult.warnings.length>0&&printError(`profile:extensions command_handler_warnings=${formatHookWarnings(extensionCommandResult.warnings)}`),!extensionCommandResult.handled){if(extensionCommandResult.warnings.length>0){const warningCode=extensionCommandResult.warnings[0],cause=extensionCommandResult.errorMessage?.trim(),causeSuffix=cause?` ${cause}`:"";throw new PmCliError(`Command "${commandPath}" failed in extension handler (${warningCode}).${causeSuffix}`,EXIT_CODE.GENERIC_FAILURE,{code:extensionCommandResult.errorCode??"command_failed",nextSteps:extensionCommandResult.remediation?[extensionCommandResult.remediation]:void 0})}throw new PmCliError(`Command "${commandPath}" is provided by extensions and is not currently available.`,EXIT_CODE.NOT_FOUND)}return extensionCommandResult.exitCode!==void 0&&(process.exitCode=extensionCommandResult.exitCode),setActiveCommandResult(extensionCommandResult.result),extensionCommandResult.result}const WRAPPED_ACTION_HANDLER=Symbol("pm.wrappedActionHandler");function resolveActionCommand(actionArgs,fallback){const possibleCommand=actionArgs[actionArgs.length-1];return possibleCommand instanceof Command?possibleCommand:fallback}function maybePrintExtensionProfileWarnings(enabled,label,warnings){enabled&&warnings.length>0&&printError(`profile:extensions ${label}=${formatHookWarnings(warnings)}`)}function validateDynamicInvocationArgs(params){const dynamicDescriptor=activeRuntimeExtensionCommandDescriptors.get(normalizeExtensionCommandPath(params.commandPath));if(!dynamicDescriptor||!isImporterOrExporterCommandPath(params.activeRegistrations,params.commandPath))return;const positionalArgs=dynamicCommandArguments(dynamicDescriptor).length===0?collectLoosePositionalArgs(params.commandArgs):stripLooseCommandOptionTokens(params.commandArgs,params.extensionFlagDefinitions);validateDynamicExtensionCommandArgs(dynamicDescriptor,positionalArgs)}function syncCommanderActionArgs(actionCommand,actionArgs,commandArgs){actionCommand.args=[...commandArgs],"_processArguments"in actionCommand&&typeof actionCommand._processArguments=="function"&&actionCommand._processArguments(),actionArgs.length>0&&Array.isArray(actionArgs[0])&&(actionArgs[0]=[...actionCommand.processedArgs])}function wrapProgramActionsForExtensionHandlers(rootProgram){const visit=entry=>{const actionEntry=entry;if(typeof actionEntry._actionHandler=="function"&&actionEntry[WRAPPED_ACTION_HANDLER]!==!0){const originalAction=actionEntry._actionHandler;actionEntry._actionHandler=async function(...actionArgs){const actionCommand=resolveActionCommand(actionArgs,entry),startedAt=Date.now();clearResolvedGlobalOptions(actionCommand);let globalOptions=getGlobalOptions(actionCommand);const commandPath=resolvePmCommandOperation(getCommandPath(actionCommand));if(["package inventory","packages inventory","extension inventory"].includes(commandPath))return await originalAction.apply(this,actionArgs);const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);let commandArgs=actionCommand.args.map(String);const activeRegistrations=getActiveExtensionRegistrations(),extensionFlagDefinitions=activeRegistrations?collectExtensionFlagDefinitionsForInvocation(activeRegistrations,commandPath,commandArgs):[],runtimeFieldFlagDefinitions=await collectRuntimeFieldLooseFlagDefinitionsForCommand(commandPath,pmRoot);let commandOptions=extractCommandScopedOptions(actionCommand,commandArgs,[...extensionFlagDefinitions,...runtimeFieldFlagDefinitions]);const parserOverride=await runActiveParserOverride({command:commandPath,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:pmRoot});maybePrintExtensionProfileWarnings(globalOptions.profile,"parser_warnings",parserOverride.warnings),commandArgs=parserOverride.context.args,commandOptions=parserOverride.context.options,copyReadOutputInvocationProvenance(actionCommand,commandOptions),globalOptions=parserOverride.context.global,validateDynamicInvocationArgs({activeRegistrations,commandPath,commandArgs,extensionFlagDefinitions}),globalOptions=await applyDefaultOutputFormat(globalOptions),setResolvedGlobalOptions(actionCommand,globalOptions),syncCommanderActionArgs(actionCommand,actionArgs,commandArgs),syncCommanderActionOptions(actionCommand,commandOptions),setActiveCommandResult(void 0),setActiveCommandContext({command:commandPath,args:commandArgs,options:{...commandOptions},global:{...globalOptions},pm_root:pmRoot});const extensionCommandResult=await runActiveCommandHandler({command:commandPath,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:pmRoot,sdk:buildExtensionCommandSdk(pmRoot,globalOptions,commandPath)});if(maybePrintExtensionProfileWarnings(globalOptions.profile,"command_handler_warnings",extensionCommandResult.warnings),extensionCommandResult.handled){setActiveCommandResult(extensionCommandResult.result),printResult(extensionCommandResult.result,{...globalOptions,command:commandPath,commandArgs,commandOptions,pmRoot}),globalOptions.profile&&printError(`profile:command=${commandPath} took_ms=${Date.now()-startedAt}`);return}return await originalAction.apply(this,actionArgs)},actionEntry[WRAPPED_ACTION_HANDLER]=!0}for(const child of entry.commands)visit(child)};visit(rootProgram)}async function clearDynamicExtensionCommandState(params){activeRuntimeExtensionCommandDescriptors=new Map,setActiveExtensionServices({overrides:[]}),params&&await maybeAttachCreateUpdatePolicyHelpText(params.rootProgram,params.pmRoot,params.invocationArgv,createEmptyExtensionRegistrationRegistry(),params.settings)}function attachDynamicExtensionHelp(command,descriptor,flagHelp,metadataHelp){if(descriptor?.flags&&descriptor.flags.length>0){applyDynamicExtensionFlagOptions(command,descriptor.flags);const residualFlagHelp=buildResidualDynamicExtensionFlagHelp(command,descriptor.flags);residualFlagHelp&&command.addHelpText("after",residualFlagHelp)}else flagHelp&&command.addHelpText("after",flagHelp);metadataHelp&&command.addHelpText("after",metadataHelp)}function applyDynamicExtensionRootHelpVisibility(rootProgram,preexistingTopLevelCommands,descriptors){const tierRank={core:0,standard:1,full:2,internal:3},applyVisibility=(command,pathParts)=>{const commandPath=pathParts.join(" "),matchingDescriptors=[...descriptors.entries()].filter(([path])=>path===commandPath||path.startsWith(`${commandPath} `)).map(([,descriptor])=>descriptor),tier=matchingDescriptors.length===0?"standard":matchingDescriptors.reduce((selected,descriptor)=>tierRank[descriptor.tier]<tierRank[selected]?descriptor.tier:selected,"internal");setPmCommandHelpVisibilityTier(command,tier);for(const child of command.commands)applyVisibility(child,[...pathParts,child.name()])};for(const command of rootProgram.commands)preexistingTopLevelCommands.has(command.name())||applyVisibility(command,[command.name()])}async function registerDynamicExtensionCommandPaths(rootProgram,invocationArgv){const bootstrapGlobalOptions=parseBootstrapGlobalOptions(invocationArgv),pmRoot=resolvePmRoot(process.cwd(),bootstrapGlobalOptions.path);if(bootstrapGlobalOptions.noExtensions){await clearDynamicExtensionCommandState({rootProgram,pmRoot,invocationArgv});return}const discoverySnapshot=await loadRuntimeExtensionDiscoverySnapshot(pmRoot),probe=buildBootstrapActivationProbe(invocationArgv);if(!discoverySnapshot){await clearDynamicExtensionCommandState();return}if(!discoveryNeedsActivationForProbe(discoverySnapshot.discovery,probe)){await clearDynamicExtensionCommandState({rootProgram,pmRoot,invocationArgv,settings:discoverySnapshot.settings}),emitExtensionSkippedProfile(bootstrapProfileEnabled(invocationArgv),discoverySnapshot,probe);return}const snapshot=await loadRuntimeExtensionSnapshot(pmRoot,probe);if(!snapshot){await clearDynamicExtensionCommandState({rootProgram,pmRoot,invocationArgv,settings:discoverySnapshot.settings});return}setActiveExtensionServices(snapshot.services),activeRuntimeExtensionCommandDescriptors=new Map(snapshot.commandDescriptors),await maybeAttachCreateUpdatePolicyHelpText(rootProgram,pmRoot,invocationArgv,snapshot.registrations,snapshot.settings);const commandPaths=collectSafeExtensionCommandPaths(rootProgram,snapshot.commandHandlers,snapshot.commandDescriptors,snapshot.commandAliases,warning=>reportExtensionCommandCollision(snapshot.activationWarnings,printError,warning)),preexistingTopLevelCommands=new Set(rootProgram.commands.map(command=>command.name())),registerCommandPath=commandPath=>{const pathParts=commandPath.split(" ").filter(part=>part.length>0),descriptor=snapshot.commandDescriptors.get(commandPath),existingCommand=findCommandByPath(rootProgram,pathParts),flagHelp=snapshot.commandFlagHelp.get(commandPath),metadataHelp=descriptor?buildDynamicExtensionCommandMetadataHelp(descriptor):null;if(existingCommand){attachDynamicExtensionHelp(existingCommand,descriptor,flagHelp,metadataHelp);return}const dynamicCommand=ensureCommandPath(rootProgram,pathParts);descriptor?.description&&dynamicCommand.description(descriptor.description);let residualDynamicFlagHelp=flagHelp;descriptor&&(applyDynamicExtensionArguments(dynamicCommand,descriptor),descriptor.flags.length>0&&(applyDynamicExtensionFlagOptions(dynamicCommand,descriptor.flags),residualDynamicFlagHelp=buildResidualDynamicExtensionFlagHelp(dynamicCommand,descriptor.flags)??void 0)),residualDynamicFlagHelp&&dynamicCommand.addHelpText("after",residualDynamicFlagHelp),metadataHelp&&dynamicCommand.addHelpText("after",metadataHelp),dynamicCommand.allowUnknownOption(!0).allowExcessArguments(!0).action(async(...actionArgs)=>{const maybeCommand=actionArgs[actionArgs.length-1],command=maybeCommand instanceof Command?maybeCommand:dynamicCommand,globalOptions=getGlobalOptions(command),startedAt=Date.now(),extensionFlagDefinitions=collectExtensionFlagDefinitionsForInvocation(snapshot.registrations,commandPath,command.args.map(String)),scopedOptions=extractCommandScopedOptions(command,command.args.map(String),extensionFlagDefinitions),result=await runRequiredExtensionCommand(command,scopedOptions,globalOptions,extensionFlagDefinitions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,{...globalOptions,command:commandPath,commandArgs:command.args.map(String),commandOptions:scopedOptions,pmRoot}),globalOptions.profile&&printError(`profile:command=${commandPath} took_ms=${Date.now()-startedAt}`)})};for(const commandPath of commandPaths)registerCommandPath(commandPath);applyDynamicExtensionRootHelpVisibility(rootProgram,preexistingTopLevelCommands,snapshot.commandDescriptors)}const CLI_VERSION=resolvePmCliVersion(import.meta.url,["../.."])??"0.0.0";let program=createPmCliProgram(CLI_VERSION);async function recordActiveDeprecatedAliasUsage(rootProgram){if(!activeTelemetryCommandContext)return;const alias=Reflect.get(rootProgram,DEPRECATED_ALIAS_INVOCATION);typeof alias=="string"&&await recordDeprecatedAliasUsage(alias)}async function runCommandPreparation(actionCommand,skipped,run){const commandPath=getCommandPath(actionCommand);return["item mutate","item complete"].includes(commandPath)&&actionCommand.optsWithGlobals().dryRun===!0?skipped:run()}function attachProgramLifecycleHooks(rootProgram,invocationArgv){invocationArgv&&isStaticExtensionInventoryInvocation(invocationArgv)||(rootProgram.hook("preAction",async(_thisCommand,actionCommand)=>{activeExtensionHookContext=null,activeTelemetryCommandContext=null,clearActiveExtensionHooks(),clearResolvedGlobalOptions(actionCommand);const rawGlobalOptions=actionCommand.optsWithGlobals(),bootstrapGlobalOptions=getGlobalOptions(actionCommand),commandPath=resolvePmCommandOperation(getCommandPath(actionCommand));let commandArgs=actionCommand.args.map(String),commandOptions=extractCommandScopedOptions(actionCommand,commandArgs),globalOptions={...bootstrapGlobalOptions};validateReadOutputOptions(commandPath,{...commandOptions,outputInclude:rawGlobalOptions.outputInclude,outputLimit:rawGlobalOptions.outputLimit,outputBudget:rawGlobalOptions.outputBudget,outputFormat:rawGlobalOptions.outputFormat,outputSession:rawGlobalOptions.outputSession,outputCursor:rawGlobalOptions.outputCursor}),forwardReadOutputIncludeModes(actionCommand,commandPath,globalOptions,commandOptions),await runCommandPreparation(actionCommand,void 0,()=>maybeRunFirstUseTelemetryPrompt(commandPath,globalOptions));const fallbackPmRoot=resolvePmRoot(process.cwd(),bootstrapGlobalOptions.path),runtimeExtensions=await maybeLoadRuntimeExtensions(actionCommand);if(!runtimeExtensions){activeExtensionHookContext=createCoreCommandHookContext({commandName:commandPath,commandArgs,commandOptions,globalOptions,pmRoot:fallbackPmRoot}),activeTelemetryCommandContext=await startTelemetryCommand({command:commandPath,pm_version:CLI_VERSION,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:fallbackPmRoot}),await recordActiveDeprecatedAliasUsage(rootProgram),sentrySetCommandContext(commandPath,commandArgs,commandOptions,{source_context:activeTelemetryCommandContext?.source_context,source_context_source:activeTelemetryCommandContext?.source_context_source}),sentryStartCommandSpan(commandPath),await enforceItemFormatWriteGateAndPreflightMigration(commandPath,commandOptions,fallbackPmRoot,defaultPreflightDecision()),await enforceMutationGuardPreflight(commandPath,commandArgs,commandOptions,globalOptions,fallbackPmRoot);return}setActiveExtensionHooks(runtimeExtensions.hooks),setActiveExtensionCommands(runtimeExtensions.commands),setActiveExtensionParsers(runtimeExtensions.parsers),setActiveExtensionPreflight(runtimeExtensions.preflight),setActiveExtensionServices(runtimeExtensions.services),setActiveExtensionRenderers(runtimeExtensions.renderers),setActiveExtensionRegistrations(runtimeExtensions.registrations);const extensionFlagDefinitions=collectExtensionFlagDefinitionsForInvocation(runtimeExtensions.registrations,commandPath,commandArgs);commandOptions=extractCommandScopedOptions(actionCommand,commandArgs,extensionFlagDefinitions),forwardReadOutputIncludeModes(actionCommand,commandPath,globalOptions,commandOptions);const parserOverride=await runActiveParserOverride({command:commandPath,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:runtimeExtensions.pmRoot});globalOptions.profile&&parserOverride.warnings.length>0&&printError(`profile:extensions parser_warnings=${formatHookWarnings(parserOverride.warnings)}`),commandArgs=parserOverride.context.args,commandOptions=parserOverride.context.options,copyReadOutputInvocationProvenance(actionCommand,commandOptions),globalOptions=parserOverride.context.global,syncCommanderActionOptions(actionCommand,commandOptions);const preflightOverride=await runActivePreflightOverride({command:commandPath,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:runtimeExtensions.pmRoot,decision:defaultPreflightDecision()});globalOptions.profile&&preflightOverride.warnings.length>0&&printError(`profile:extensions preflight_warnings=${formatHookWarnings(preflightOverride.warnings)}`),commandArgs=preflightOverride.context.args,commandOptions=preflightOverride.context.options,copyReadOutputInvocationProvenance(actionCommand,commandOptions),globalOptions=preflightOverride.context.global,syncCommanderActionOptions(actionCommand,commandOptions);const preflightDecision=preflightOverride.decision;await enforceItemFormatWriteGateAndPreflightMigration(commandPath,commandOptions,runtimeExtensions.pmRoot,preflightDecision),await enforceMutationGuardPreflight(commandPath,commandArgs,commandOptions,globalOptions,runtimeExtensions.pmRoot);const migrationWarnings=preflightDecision.run_extension_migrations?await runCommandPreparation(actionCommand,[],()=>executeRegisteredRuntimeMigrations(runtimeExtensions.registrations.migrations,runtimeExtensions.pmRoot)):[];globalOptions.profile&&migrationWarnings.length>0&&printError(`profile:extensions migration_warnings=${formatHookWarnings(migrationWarnings)}`);const migrationBlockers=collectMandatoryMigrationBlockers(runtimeExtensions.registrations.migrations);activeExtensionHookContext={hooks:runtimeExtensions.hooks,commandName:commandPath,commandArgs,commandOptions:{...commandOptions},globalOptions:{...globalOptions},pmRoot:runtimeExtensions.pmRoot,profileEnabled:!!globalOptions.profile,migrationBlockers},setActiveCommandResult(void 0),setActiveCommandContext({command:commandPath,args:commandArgs,options:{...commandOptions},global:{...globalOptions},pm_root:runtimeExtensions.pmRoot}),activeTelemetryCommandContext=await startTelemetryCommand({command:commandPath,pm_version:CLI_VERSION,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:runtimeExtensions.pmRoot}),await recordActiveDeprecatedAliasUsage(rootProgram),sentrySetCommandContext(commandPath,commandArgs,commandOptions,{source_context:activeTelemetryCommandContext?.source_context,source_context_source:activeTelemetryCommandContext?.source_context_source}),sentryStartCommandSpan(commandPath);const hookWarnings=await runBeforeCommandHooks(runtimeExtensions.hooks,{command:commandPath,args:commandArgs,options:{...commandOptions},global:{...globalOptions},pm_root:runtimeExtensions.pmRoot});globalOptions.profile&&hookWarnings.length>0&&printError(`profile:extensions hook_warnings=${formatHookWarnings(hookWarnings)}`),preflightDecision.enforce_mandatory_migration_gate&&enforceMandatoryMigrationWriteGate(commandPath,commandOptions,migrationBlockers)}),rootProgram.hook("postAction",async()=>{const outcome=buildPostActionTelemetryOutcome();sentryFinishCommandSpan(outcome.ok,outcome.error,{error_code:outcome.error_code,error_category:outcome.error_category,exit_code:outcome.exit_code,command_resolution:outcome.command_resolution,resolution_stage:outcome.resolution_stage}),await runAndClearAfterCommandHooks(outcome)}))}attachProgramLifecycleHooks(program);const IDEMPOTENT_TOP_LEVEL_REGISTRATION=Symbol("pmCliIdempotentTopLevelRegistration");function ensureIdempotentTopLevelCommandRegistration(rootProgram){const guarded=rootProgram;if(guarded[IDEMPOTENT_TOP_LEVEL_REGISTRATION])return;guarded[IDEMPOTENT_TOP_LEVEL_REGISTRATION]=!0;const registerOriginalCommand=rootProgram.command.bind(rootProgram);rootProgram.command=((nameAndArgs,...rest)=>{const commandName=nameAndArgs.split(/\s+/u)[0];return rootProgram.commands.some(existing=>existing.name()===commandName||existing.aliases().includes(commandName))?new Command(commandName):registerOriginalCommand(nameAndArgs,...rest)})}async function registerCoreCommandFamilies(rootProgram,selection){if(ensureIdempotentTopLevelCommandRegistration(rootProgram),selection.setup){const{registerSetupCommands}=await loadSetupRegistrationModule();registerSetupCommands(rootProgram)}if(selection.listQuery){const{registerListQueryCommands}=await loadListQueryRegistrationModule(),commandFilter=typeof selection.targetCommandName=="string"&&LIST_QUERY_COMMAND_NAMES.has(selection.targetCommandName)?new Set([selection.targetCommandName]):void 0;registerListQueryCommands(rootProgram,commandFilter?{commandFilter}:void 0)}if(selection.mutation){const{registerMutationCommands}=await loadMutationRegistrationModule();registerMutationCommands(rootProgram,{targetCommandName:selection.targetCommandName})}if(selection.operation){const{registerOperationCommands}=await loadOperationRegistrationModule();registerOperationCommands(rootProgram)}}function createTelemetryCommandErrorEmitter(params){return async event=>{const errorCategory=resolveTelemetryErrorCategory(event.errorCode),commandResolution=deriveTelemetryCommandResolution({ok:!1,errorCode:event.errorCode,errorCategory});return await emitTelemetryErrorEvent({command:event.command,args:params.invocationArgv,options:event.options,global:params.bootstrapGlobal,pm_version:CLI_VERSION,pm_root:params.bootstrapPmRoot,error_code:event.errorCode,error_message:event.errorMessage,exit_code:event.exitCode,error_category:errorCategory,command_resolution:commandResolution,resolution_stage:event.resolutionStage}),{errorCategory,commandResolution}}}async function prepareExtensionServicesForRunPmCliError(params){if(params.bootstrapGlobal.noExtensions||isStaticExtensionInventoryInvocation(params.invocationArgv))return;const bootstrapProbe=buildBootstrapActivationProbe(params.invocationArgv),discoverySnapshot=await loadRuntimeExtensionDiscoverySnapshot(params.bootstrapPmRoot);if(discoverySnapshot&&discoveryNeedsActivationForProbe(discoverySnapshot.discovery,bootstrapProbe)){const bootstrapSnapshot=await loadRuntimeExtensionSnapshot(params.bootstrapPmRoot,bootstrapProbe);setRecoveredExtensionServices(bootstrapSnapshot);return}discoverySnapshot&&emitExtensionSkippedProfile(bootstrapProfileEnabled(params.invocationArgv),discoverySnapshot,bootstrapProbe),setActiveExtensionServices({overrides:[]})}function setRecoveredExtensionServices(bootstrapSnapshot){if(!bootstrapSnapshot){setActiveExtensionServices({overrides:[]});return}setActiveExtensionServices(bootstrapSnapshot.services)}async function finishRunPmCliFailure(params){sentryFinishCommandSpan(!1,params.errorMessage,{error_code:params.classificationCode,error_category:params.errorCategory,exit_code:params.exitCode,command_resolution:params.commandResolution,resolution_stage:params.resolutionStage}),await runAndClearAfterCommandHooks({ok:!1,error:params.errorMessage,exit_code:params.exitCode,error_code:params.classificationCode,error_category:params.errorCategory,command_resolution:params.commandResolution,resolution_stage:params.resolutionStage})}async function finishRunPmCliSuccessParse(){sentryFinishCommandSpan(!0,void 0,{exit_code:EXIT_CODE.SUCCESS,command_resolution:"success",resolution_stage:"parse"}),await runAndClearAfterCommandHooks({ok:!0,exit_code:EXIT_CODE.SUCCESS,command_resolution:"success",resolution_stage:"parse"}),process.exitCode=EXIT_CODE.SUCCESS}async function handleRunPmCliKnownError(context,numericExitCode){const hasExplicitExitCode=typeof numericExitCode=="number"&&Number.isFinite(numericExitCode);if(!(context.error instanceof PmCliError)&&(isCommanderError(context.error)||!hasExplicitExitCode))return!1;const errorMessage=describeUnknownError(context.error),exitCode=context.error instanceof PmCliError?context.error.exitCode:normalizeThrownExitCode(numericExitCode),rawContext=context.error instanceof PmCliError?context.error.context:void 0,enrichedContext=buildPmCliRecoveryContext(rawContext,context.invocationArgv,errorMessage),classification=classifyPmCliError(errorMessage,enrichedContext),jsonErrorPayload=context.bootstrapGlobal.lean?projectLeanErrorEnvelope(formatPmCliErrorForJson(errorMessage,exitCode,enrichedContext)):formatPmCliErrorForJson(errorMessage,exitCode,enrichedContext),renderedError=context.jsonErrors?JSON.stringify(context.bootstrapGlobal.tokenAccounting?attachOutputTokenAccounting(jsonErrorPayload,value=>`${JSON.stringify(value,null,2)}
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3297eae7-8022-57c0-9be1-e01d904adf47")}catch{}})();import{Command,CommanderError}from"commander";import{PM_COMMAND_ALIAS_CONTRACTS,findPmNamespacedCommand,resolvePmCommandOperation}from"../sdk/cli-contracts/command-aliases.js";import{createPmCliProgram}from"../sdk/cli-program.js";import{runWithDiscoveredContextIntentContracts}from"../sdk/context-intent-runtime.js";import{describeUnknownError,isCommanderError,normalizeThrownExitCode,readThrownExitCode,wrapThrownErrorForSentry}from"../sdk/error-runtime.js";import{createExtensionCommandSdk}from"../sdk/extension-command-context.js";import{runExtensionMigrations}from"../sdk/extension/migrations.js";import{repairProjectionRecovery}from"./runtime/projection-retry.js";import{applyInvocationAuthorOverride}from"../sdk/invocation-author.js";import{attachOutputTokenAccounting}from"../sdk/output-token-accounting.js";import{validateReadOutputOptions}from"../sdk/read-output-contracts.js";import{runWithReproducibleProcessEnvironment}from"../sdk/reproducibility/process.js";import{EXIT_CODE,PmCliError,activateExtensions,clearActiveExtensionHooks,consumeAfterCommandAffectedItems,createCoreCommandHookContext,createEmptyExtensionRegistrationRegistry,createLazyModule,deriveTelemetryCommandResolution,discoverExtensions,emitTelemetryErrorEvent,ensureSentryInit,getActiveCommandResult,getActiveExtensionRegistrations,getSettingsPath,loadExtensions,maybeRunFirstUseTelemetryPrompt,pathExists,printError,printResult,readSettings,readSettingsWithMetadata,resetActiveExtensionRuntimeState,resolveGlobalPmRoot,resolveItemTypeRegistry,resolvePmCliVersion,resolvePmPackageRootFromModule,resolvePmRoot,resolveRuntimeFieldRegistry,resolveTelemetryErrorCategory,runActiveCommandHandler,runActiveParserOverride,runActivePreflightOverride,runAfterCommandHooks,runBeforeCommandHooks,runWithConfigurationOnlySettings,runWithHarnessDetectionSignals,runWithWorkspaceHarnessSignalDescriptors,sentryCaptureCliError,sentryFinishCommandSpan,sentryFlush,sentryLogCliUsageError,sentrySetCommandContext,sentryStartCommandSpan,setActiveCommandContext,setActiveCommandResult,setActiveExtensionCommands,setActiveExtensionHooks,setActiveExtensionParsers,setActiveExtensionPreflight,setActiveExtensionRegistrations,setActiveExtensionRenderers,setActiveExtensionServices,startTelemetryCommand,writeStderr}from"../sdk/runtime-primitives.js";import{PmClient}from"../sdk/runtime.js";import{recordDeprecatedAliasUsage}from"../sdk/telemetry.js";import{finishActiveTelemetryCommand,recordAfterCommandContextUsage}from"./after-command-context-usage.js";import{extractProvidedOptionFlags,normalizeLongOptionFlag,redactSensitiveCommandArgs,renderPmCommand}from"./argv-utils.js";import{applyBootstrapPagerPolicy,findBootstrapCommandTokenIndex,normalizeBootstrapInvocation,parseBootstrapCommandName,parseBootstrapGlobalOptions,parseBootstrapHelpRequest,stripGlobalBootstrapTokens}from"./bootstrap-args.js";import{installCommandNamespaces}from"./command-namespaces.js";import{appendCommanderExtensionFailures,formatCommanderUsageJson,formatCommanderUsageMessage,isKnownHelpCommandPath,resolveCommanderUsageContext,resolveUnknownCommanderToken}from"./commander-usage.js";import{loadContextIntentSnapshotForInvocation}from"./context-intent-invocation.js";import{classifyCommanderError,classifyPmCliError,classifyUnknownError,formatPmCliErrorForDisplay,formatPmCliErrorForJson,formatUnknownErrorForJson,projectLeanErrorEnvelope}from"./error-guidance.js";import{applyDynamicExtensionArguments,applyDynamicExtensionFlagOptions,buildCanonicalExtensionAliases,buildDynamicExtensionCommandMetadataHelp,buildResidualDynamicExtensionFlagHelp,collectDynamicExtensionFlagHelpByCommand,collectExtensionCommandHelpDescriptors,collectSafeExtensionCommandPaths,ensureCommandPath,extensionFlagTakesValueForInvocation,findCommandByPath,normalizeExtensionCommandPath,reportExtensionCommandCollision}from"./extension-command-help.js";import{collectLoosePositionalArgs,stripLooseCommandOptionTokens}from"./extension-command-options.js";import{loadExtensionRecoveryFailures,loadUnknownCommandRecoveryFailures}from"./extension-recovery.js";import{attachRichHelpText,isFullHelpDiscovery,setPmCommandHelpVisibilityTier}from"./help-content.js";import{attachCreateUpdatePolicyHelpText,maybeRenderBootstrapJsonHelp}from"./help-json-payload.js";import{collectMandatoryMigrationBlockers,enforceItemFormatWriteGateAndPreflightMigration,enforceMandatoryMigrationWriteGate,enforceMutationGuardPreflight}from"./migration-gates.js";import{applyDefaultOutputFormat,clearResolvedGlobalOptions,collect,formatHookWarnings,getCommandPath,getGlobalOptions,invalidateSearchCachesForMutation,setResolvedGlobalOptions,syncCommanderActionOptions}from"./registration-helpers.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,copyReadOutputInvocationProvenance,dynamicCommandArguments,extractCommandScopedOptions,forwardReadOutputIncludeModes,isImporterOrExporterCommandPath,recordCliReadOutputInvocationProvenance,validateDynamicExtensionCommandArgs,validateDynamicExtensionCommandInvocation}from"./runtime/invocation-options.js";import{LIST_QUERY_COMMAND_NAMES,enforceExplicitRetryForFlagTypos,invocationRequestsVersion,isStaticExtensionInventoryInvocation,resolveStructuredMutationPreviewInvocation,resolveCoreCommandRegistrationSelection,shouldAttachRichHelpTextForInvocation,shouldRegisterDynamicExtensionPaths,shouldRegisterRuntimeSchemaFlags}from"./runtime/selection.js";import{buildPostActionTelemetryOutcome,inferPostActionErrorCode,inferPostActionFailureMessage,normalizeTelemetryCommandResolution,normalizeTelemetryErrorCategory,normalizeTelemetryResolutionStage,readRecordBoolean,readRecordNumber,readRecordString}from"./runtime/telemetry-outcome.js";const PM_PACKAGE_ROOT_ENV="PM_CLI_PACKAGE_ROOT",DEPRECATED_ALIAS_INVOCATION=Symbol("pm.deprecatedAliasInvocation"),COMMAND_ALIASES_BY_FIRST_TOKEN=new Map;for(const contract of PM_COMMAND_ALIAS_CONTRACTS){const firstToken=contract.alias.split(" ")[0],matches=COMMAND_ALIASES_BY_FIRST_TOKEN.get(firstToken)??[];matches.push(contract),COMMAND_ALIASES_BY_FIRST_TOKEN.set(firstToken,matches)}for(const matches of COMMAND_ALIASES_BY_FIRST_TOKEN.values())matches.sort((left,right)=>right.alias.split(" ").length-left.alias.split(" ").length);function resolvePmPackageRoot(){return resolvePmPackageRootFromModule(import.meta.url,["../.."])}(typeof process.env[PM_PACKAGE_ROOT_ENV]!="string"||process.env[PM_PACKAGE_ROOT_ENV]?.trim().length===0)&&(process.env[PM_PACKAGE_ROOT_ENV]=resolvePmPackageRoot());let activeExtensionHookContext=null,activeTelemetryCommandContext=null;function setActiveExtensionHookContextForTest(context){activeExtensionHookContext=context}function setActiveRuntimeExtensionCommandDescriptorsForTest(descriptors){activeRuntimeExtensionCommandDescriptors=descriptors}let runtimeExtensionSnapshotCache=null,runtimeExtensionDiscoverySnapshotCache=null,activeRuntimeExtensionCommandDescriptors=new Map;const HANDLED_ERROR_SENTRY_FLUSH_TIMEOUT_MS=250,EXPECTED_HANDLED_ERROR_EXIT_CODES=new Set([EXIT_CODE.USAGE,EXIT_CODE.NOT_FOUND,EXIT_CODE.CONFLICT]),TRUE_LIKE_ENV_VALUES=new Set(["1","true","yes","on"]),loadSetupRegistrationModule=createLazyModule(()=>import("./register-setup.js")),loadListQueryRegistrationModule=createLazyModule(()=>import("./register-list-query.js")),loadMutationRegistrationModule=createLazyModule(()=>import("./register-mutation.js")),loadOperationRegistrationModule=createLazyModule(()=>import("./register-operations.js"));function renderAttemptedCommand(argv){return renderPmCommand(argv)}function inferMissingFieldsFromErrorMessage(message){const matches=message.match(/--[a-zA-Z0-9][a-zA-Z0-9_-]*/g);if(!matches||matches.length===0)return;const normalized=[...new Set(matches.map(entry=>normalizeLongOptionFlag(entry)??entry))];return normalized.length>0?normalized:void 0}function inferMissingFieldsForRecovery(rawMessage,invocationArgv,existingRecovery){if(existingRecovery?.suggested_retry||rawMessage.includes("failed in extension handler (")||!/\b(?:missing|required|requires)\b/i.test(rawMessage))return;const providedFields=extractProvidedOptionFlags(invocationArgv),providedSet=new Set(providedFields.map(flag=>normalizeLongOptionFlag(flag)??flag)),rawInferred=inferMissingFieldsFromErrorMessage(rawMessage),commandName=invocationArgv.find(token=>program.commands.some(candidate=>candidate.name()===token)),command=commandName?program.commands.find(candidate=>candidate.name()===commandName):void 0,declaredFlags=new Set([...program.options,...command?.options??[]].flatMap(option=>option.flags.split(/[ ,|]+/).map(flag=>normalizeLongOptionFlag(flag)).filter(flag=>flag!==void 0))),trulyMissing=rawInferred?.filter(flag=>{const normalized=normalizeLongOptionFlag(flag)??flag;return providedSet.has(normalized)?!1:declaredFlags.has(normalized)||extensionFlagTakesValueForInvocation(invocationArgv,commandName,normalized,activeRuntimeExtensionCommandDescriptors)!==void 0});return trulyMissing&&trulyMissing.length>0?trulyMissing:void 0}function resolveRecoverySuggestedRetry(invocationArgv,attemptedCommand,inferredMissing,existingRecovery){if(existingRecovery?.suggested_retry)return existingRecovery.suggested_retry;const missingFlag=inferredMissing?.[0],normalizedMissing=missingFlag?normalizeLongOptionFlag(missingFlag):void 0,commandName=invocationArgv.find(token=>program.commands.some(candidate=>candidate.name()===token)),command=commandName?program.commands.find(candidate=>candidate.name()===commandName):void 0,missingOption=normalizedMissing?command?.options.find(option=>option.flags.split(/[ ,|]+/).includes(normalizedMissing)):void 0,extensionFlagTakesValue=extensionFlagTakesValueForInvocation(invocationArgv,commandName,normalizedMissing,activeRuntimeExtensionCommandDescriptors),missingTokens=normalizedMissing?missingOption?.isBoolean()===!0||extensionFlagTakesValue===!1?[normalizedMissing]:[normalizedMissing,"<value>"]:[],suggestedRetry=normalizedMissing?renderAttemptedCommand([...invocationArgv,...missingTokens]):attemptedCommand;return suggestedRetry===attemptedCommand?void 0:suggestedRetry}function projectExistingRecoveryOptionalFields(existingRecovery){if(!existingRecovery)return{};const optionalFields=["recovery_mode","missing_required_fields","suggested_flags","suggested_retry_args","allowed_values","candidate_commands","candidate_commands_total","candidate_commands_truncated","fallback_candidates","next_best_command"],projected={};for(const field of optionalFields){const value=existingRecovery[field];value!=null&&(projected[field]=value)}return projected}function buildRecoveryPayload(params){const existingRecovery=params.existingRecovery;return{attempted_command:existingRecovery?.attempted_command??params.attemptedCommand,normalized_args:existingRecovery?.normalized_args??[...params.invocationArgv],provided_fields:existingRecovery?.provided_fields??(params.providedFields.length>0?params.providedFields:void 0),missing:existingRecovery?.missing??params.inferredMissing,...projectExistingRecoveryOptionalFields(existingRecovery),...params.suggestedRetry?{suggested_retry:params.suggestedRetry}:{}}}function buildPmCliRecoveryContext(context,invocationArgv,rawMessage){const safeInvocationArgv=redactSensitiveCommandArgs(invocationArgv),commandArgs=stripGlobalBootstrapTokens(safeInvocationArgv),commandIndex=findBootstrapCommandTokenIndex(commandArgs),[rootCommand,subcommand]=commandIndex===void 0?[]:commandArgs.slice(commandIndex,commandIndex+2),explainRequested=safeInvocationArgv.includes("--explain"),rawExistingRecovery=repairProjectionRecovery(safeInvocationArgv,context?.code,context?.recovery),existingRecovery=rawExistingRecovery&&(rootCommand==="history-redact"||rootCommand==="history"&&subcommand==="redact")?{...rawExistingRecovery,...rawExistingRecovery.attempted_command?{attempted_command:renderAttemptedCommand(safeInvocationArgv)}:{},...rawExistingRecovery.normalized_args?{normalized_args:[...safeInvocationArgv]}:{},...rawExistingRecovery.suggested_retry?{suggested_retry:renderAttemptedCommand(safeInvocationArgv)}:{},...rawExistingRecovery.suggested_retry_args?{suggested_retry_args:[...safeInvocationArgv]}:{}}:rawExistingRecovery;if(existingRecovery?.recovery_mode==="compact"&&!explainRequested)return{...context,recovery:existingRecovery};const attemptedCommand=renderAttemptedCommand(safeInvocationArgv),providedFields=extractProvidedOptionFlags(safeInvocationArgv),inferredMissing=inferMissingFieldsForRecovery(rawMessage,safeInvocationArgv,existingRecovery),suggestedRetry=resolveRecoverySuggestedRetry(safeInvocationArgv,attemptedCommand,inferredMissing,existingRecovery),recovery=buildRecoveryPayload({invocationArgv:safeInvocationArgv,attemptedCommand,providedFields,inferredMissing,suggestedRetry,existingRecovery});return{...context,recovery}}async function runAndClearAfterCommandHooks(outcome){const telemetryRuntime=activeTelemetryCommandContext;activeTelemetryCommandContext=null,await finishActiveTelemetryCommand(telemetryRuntime,outcome);const runtime=activeExtensionHookContext;if(activeExtensionHookContext=null,!runtime){clearActiveExtensionHooks();return}let hookWarnings=[];const affected=consumeAfterCommandAffectedItems();try{await recordAfterCommandContextUsage({pmRoot:runtime.pmRoot,author:runtime.globalOptions.author,itemIds:outcome.ok?affected?.map(item=>item.id)??[]:[],intent:runtime.commandName})}catch{hookWarnings.push("context_usage_feedback_write_failed")}try{hookWarnings.push(...await runAfterCommandHooks(runtime.hooks,{command:runtime.commandName,args:runtime.commandArgs,options:{...runtime.commandOptions},global:{...runtime.globalOptions},pm_root:runtime.pmRoot,ok:outcome.ok,error:outcome.error,result:getActiveCommandResult(),affected}))}catch(error){hookWarnings=[`afterCommand hooks failed: ${error instanceof Error?error.message:String(error)}`]}finally{clearActiveExtensionHooks()}!runtime.globalOptions.json&&hookWarnings.length>0&&printError(`[pm] warning: afterCommand hook_warnings=${formatHookWarnings(hookWarnings)}`),runtime.profileEnabled&&hookWarnings.length>0&&printError(`profile:extensions hook_warnings=${formatHookWarnings(hookWarnings)}`)}async function ensureSentryForErrorReporting(){await ensureSentryInit()}function envFlagEnabled(key){return TRUE_LIKE_ENV_VALUES.has((process.env[key]??"").trim().toLowerCase())}function shouldLogHandledErrorToSentry(exitCode){return envFlagEnabled("PM_SENTRY_CAPTURE_EXPECTED_ERRORS")?!0:!EXPECTED_HANDLED_ERROR_EXIT_CODES.has(Math.trunc(exitCode))}async function maybeLogHandledCliErrorToSentry(params){return shouldLogHandledErrorToSentry(params.exit_code)?(await ensureSentryForErrorReporting(),sentryLogCliUsageError(params),!0):!1}async function handleGenericRunPmCliError(params){const message=describeUnknownError(params.error),classification=classifyUnknownError(message);params.bootstrapGlobal.json?printError(JSON.stringify(formatUnknownErrorForJson(message,EXIT_CODE.GENERIC_FAILURE),null,2)):printError(message),process.exitCode=EXIT_CODE.GENERIC_FAILURE;let errorCategory="runtime",commandResolution="runtime_failed";try{await ensureSentryForErrorReporting(),sentryCaptureCliError(params.error);const telemetry=await params.emitTelemetryCommandError({command:params.attemptedCommand,errorCode:classification.code,errorMessage:classification.detail,exitCode:EXIT_CODE.GENERIC_FAILURE,options:{bootstrap_global_options:params.bootstrapGlobal},resolutionStage:"execute"});errorCategory=telemetry.errorCategory,commandResolution=telemetry.commandResolution,sentryFinishCommandSpan(!1,message,{error_code:classification.code,error_category:errorCategory,exit_code:EXIT_CODE.GENERIC_FAILURE,command_resolution:commandResolution,resolution_stage:"execute"})}catch(reportingError){params.bootstrapGlobal.json||printError(`Failed to report error: ${describeUnknownError(reportingError)}`)}try{await runAndClearAfterCommandHooks({ok:!1,error:message,exit_code:EXIT_CODE.GENERIC_FAILURE,error_code:classification.code,error_category:errorCategory,command_resolution:commandResolution,resolution_stage:"execute"})}catch(hookError){params.bootstrapGlobal.json||printError(`Failed to run error hooks: ${describeUnknownError(hookError)}`)}try{await sentryFlush()}catch(flushError){params.bootstrapGlobal.json||printError(`Failed to flush error reporting: ${describeUnknownError(flushError)}`)}}const RUNTIME_FIELD_COMMAND_BY_COMMAND_PATH={create:"create",update:"update","update-many":"update_many",list:"list","list-all":"list","list-draft":"list","list-open":"list","list-in-progress":"list","list-blocked":"list","list-closed":"list","list-canceled":"list",search:"search",calendar:"calendar",context:"context","templates save":"create"},runtimeFieldLooseFlagDefinitionCache=new Map;function toLooseFieldDefinitionType(fieldType){return fieldType==="number"?"number":fieldType==="boolean"?"boolean":"string"}function commandHasLongOption(command,longFlag){return command.options.some(option=>option.long===longFlag)}function commandHasShortOption(command,shortFlag){return command.options.some(option=>option.short===shortFlag)}function addRuntimeFieldOption(command,flagToken,description,repeatable){const normalizedToken=flagToken.trim();if(!normalizedToken)return;const helpText=description.length>0?description:`Runtime schema field (${flagToken})`;if(normalizedToken.startsWith("-")&&!normalizedToken.startsWith("--")){if(commandHasShortOption(command,normalizedToken))return;if(repeatable){command.option(`${normalizedToken} <value>`,`${helpText} (repeatable)`,collect);return}command.option(`${normalizedToken} <value>`,helpText);return}const longFlag=normalizedToken.startsWith("--")?normalizedToken:`--${normalizedToken}`;if(!commandHasLongOption(command,longFlag)){if(repeatable){command.option(`${longFlag} <value>`,`${helpText} (repeatable)`,collect);return}command.option(`${longFlag} <value>`,helpText)}}async function collectRuntimeFieldLooseFlagDefinitionsForCommand(commandPath,pmRoot){const runtimeCommand=RUNTIME_FIELD_COMMAND_BY_COMMAND_PATH[commandPath];if(!runtimeCommand)return[];const cacheKey=`${pmRoot}:${runtimeCommand}`,cached=runtimeFieldLooseFlagDefinitionCache.get(cacheKey);if(cached)return cached;if(!await pathExists(getSettingsPath(pmRoot)))return runtimeFieldLooseFlagDefinitionCache.set(cacheKey,[]),[];const settings=await readSettings(pmRoot),definitions=(resolveRuntimeFieldRegistry(settings.schema).command_to_fields.get(runtimeCommand)??[]).flatMap(field=>[field.cli_flag,...field.cli_aliases].map(token=>({long:`--${token}`,type:toLooseFieldDefinitionType(field.type),value_type:toLooseFieldDefinitionType(field.type)})));return runtimeFieldLooseFlagDefinitionCache.set(cacheKey,definitions),definitions}async function registerRuntimeSchemaFieldFlags(rootProgram,invocationArgv){const bootstrapGlobalOptions=parseBootstrapGlobalOptions(invocationArgv),pmRoot=resolvePmRoot(process.cwd(),bootstrapGlobalOptions.path);if(!await pathExists(getSettingsPath(pmRoot)))return;const cachedDiscovery=runtimeExtensionDiscoverySnapshotCache?.key===buildRuntimeExtensionDiscoverySnapshotCacheKey(pmRoot)?runtimeExtensionDiscoverySnapshotCache.snapshot:null,settings=cachedDiscovery===null?await readSettings(pmRoot):cachedDiscovery.settings,fieldRegistry=resolveRuntimeFieldRegistry(settings.schema),mappings=[{path:"create",command:"create"},{path:"update",command:"update"},{path:"update-many",command:"update_many"},{path:"list",command:"list"},{path:"list-all",command:"list"},{path:"list-draft",command:"list"},{path:"list-open",command:"list"},{path:"list-in-progress",command:"list"},{path:"list-blocked",command:"list"},{path:"list-closed",command:"list"},{path:"list-canceled",command:"list"},{path:"search",command:"search"},{path:"calendar",command:"calendar"},{path:"context",command:"context"},{path:"templates save",command:"create"}];for(const mapping of mappings){const command=findCommandByPath(rootProgram,mapping.path.split(" "));if(command)for(const field of fieldRegistry.command_to_fields.get(mapping.command)??[]){const description=field.description??"";addRuntimeFieldOption(command,field.cli_flag,description,field.repeatable);for(const alias of field.cli_aliases)addRuntimeFieldOption(command,alias,`Alias for --${field.cli_flag}`,field.repeatable)}}}async function maybeAttachCreateUpdatePolicyHelpText(rootProgram,pmRoot,invocationArgv,registrations,settings){const bootstrapCommand=parseBootstrapCommandName(invocationArgv);if(!(bootstrapCommand!=="create"&&bootstrapCommand!=="update"))try{const resolvedSettings=settings??await readSettings(pmRoot),typeRegistry=resolveItemTypeRegistry(resolvedSettings,registrations);attachCreateUpdatePolicyHelpText(rootProgram,typeRegistry,invocationArgv)}catch{}}function defaultPreflightDecision(){return{enforce_item_format_gate:!0,run_preflight_item_format_sync:!0,run_extension_migrations:!0,enforce_mandatory_migration_gate:!0}}function buildRuntimeExtensionSnapshotCacheKey(pmRoot,activationScope="all"){return activationScope==="all"?`pm-root:${pmRoot}`:`pm-root:${pmRoot}:activation:${activationScope}`}function bootstrapProfileEnabled(invocationArgv){return invocationArgv.some(token=>token==="--profile")}function buildRuntimeExtensionDiscoverySnapshotCacheKey(pmRoot){return`pm-root:${pmRoot}`}function emitSettingsReadWarnings(warnings){for(const warning of warnings)warning.startsWith("settings_read_")&&printError(`[pm] warning: ${warning} \u2014 settings.json could not be loaded and pm fell back to defaults; run pm health for remediation.`)}function emitExtensionProfile(globalOptions,snapshot){globalOptions.profile&&(printError(`profile:extensions loaded=${snapshot.loadedCount} failed=${snapshot.loadFailedCount} warnings=${snapshot.loadWarnings.length} activation_failed=${snapshot.activationFailedCount} hook_counts=before:${snapshot.hooks.beforeCommand.length}|after:${snapshot.hooks.afterCommand.length}|write:${snapshot.hooks.onWrite.length}|read:${snapshot.hooks.onRead.length}|index:${snapshot.hooks.onIndex.length} command_overrides=${snapshot.commands.overrides.length} command_handlers=${snapshot.commands.handlers.length} parser_overrides=${snapshot.parsers.overrides.length} preflight_overrides=${snapshot.preflight.overrides.length} service_overrides=${snapshot.services.overrides.length} renderer_overrides=${snapshot.renderers.overrides.length}`),snapshot.activationWarnings.length>0&&printError(`profile:extensions activation_warnings=${formatHookWarnings(snapshot.activationWarnings)}`))}function emitExtensionSkippedProfile(profileEnabled,snapshot,probe){if(!profileEnabled)return;const command=normalizeExtensionCommandPath(probe.commandPath??"")||"<none>";printError(`profile:extensions activation=skipped command=${command} effective=${snapshot.discovery.effective.length} warnings=${snapshot.discovery.warnings.length} discovery_ms=${snapshot.discoveryMs}`)}async function loadRuntimeExtensionDiscoverySnapshot(pmRoot,readSettingsWithMetadataFn=readSettingsWithMetadata){const cacheKey=buildRuntimeExtensionDiscoverySnapshotCacheKey(pmRoot);if(runtimeExtensionDiscoverySnapshotCache?.key===cacheKey)return runtimeExtensionDiscoverySnapshotCache.snapshot;try{const startedAt=Date.now(),{settings,warnings:settingsReadWarnings}=await readSettingsWithMetadataFn(pmRoot),discovery=await discoverExtensions({pmRoot,settings,cwd:process.cwd(),noExtensions:!1}),snapshot={pmRoot,settings,discovery,discoveryMs:Date.now()-startedAt,settingsReadWarnings:[...settingsReadWarnings]};return runtimeExtensionDiscoverySnapshotCache={key:cacheKey,snapshot},snapshot}catch{return runtimeExtensionDiscoverySnapshotCache={key:cacheKey,snapshot:null},null}}async function loadRuntimeExtensionSnapshot(pmRoot,probe,readSettingsFn=readSettings){const activationScope=probe?buildRuntimeExtensionActivationScope(probe):"all",cacheKey=buildRuntimeExtensionSnapshotCacheKey(pmRoot,activationScope);if(runtimeExtensionSnapshotCache?.key===cacheKey)return runtimeExtensionSnapshotCache.snapshot;try{const settings=await readSettingsFn(pmRoot),loadResult=await loadExtensions({pmRoot,settings,cwd:process.cwd(),noExtensions:!1,extensionFilter:probe?buildRuntimeExtensionFilterForProbe(probe):void 0}),activationResult=await activateExtensions({...loadResult,loaded:loadResult.loaded}),commandHandlers=[...new Set(activationResult.commands.handlers.map(entry=>normalizeExtensionCommandPath(entry.command)))].filter(entry=>entry.length>0).sort((left,right)=>left.localeCompare(right)),commandFlagHelp=collectDynamicExtensionFlagHelpByCommand(activationResult.registrations.flags),canonicalAliases=buildCanonicalExtensionAliases(activationResult.commands.handlers,activationResult.registrations.commands),commandDescriptors=collectExtensionCommandHelpDescriptors(commandHandlers,activationResult.registrations.commands,activationResult.registrations.flags,canonicalAliases),snapshot={hooks:activationResult.hooks,commands:activationResult.commands,parsers:activationResult.parsers,preflight:activationResult.preflight,services:activationResult.services,renderers:activationResult.renderers,registrations:activationResult.registrations,pmRoot,settings,commandHandlers,commandFlagHelp,commandDescriptors,commandAliases:canonicalAliases,loadWarnings:[...loadResult.warnings],activationWarnings:[...activationResult.warnings],loadedCount:loadResult.loaded.length,loadFailedCount:loadResult.failed.length,activationFailedCount:activationResult.failed.length,contextIntentPackages:loadResult.loaded.map(({name,module})=>({name,module}))};return runtimeExtensionSnapshotCache={key:cacheKey,snapshot},snapshot}catch{return runtimeExtensionSnapshotCache={key:cacheKey,snapshot:null},null}}async function maybeLoadRuntimeExtensions(command){const globalOptions=getGlobalOptions(command);if(globalOptions.noExtensions){const noExtPmRoot=resolvePmRoot(process.cwd(),globalOptions.path);return await pathExists(getSettingsPath(noExtPmRoot))&&emitSettingsReadWarnings((await readSettingsWithMetadata(noExtPmRoot)).warnings),null}const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),discoverySnapshot=await loadRuntimeExtensionDiscoverySnapshot(pmRoot);if(!discoverySnapshot)return null;emitSettingsReadWarnings(discoverySnapshot.settingsReadWarnings);const probe={commandPath:getCommandPath(command),commandArgs:collectParsedActivationCommandArgs(command)};if(!discoveryNeedsActivationForProbe(discoverySnapshot.discovery,probe))return emitExtensionSkippedProfile(globalOptions.profile,discoverySnapshot,probe),null;const snapshot=await loadRuntimeExtensionSnapshot(pmRoot,probe);return snapshot?(emitExtensionProfile(globalOptions,snapshot),{hooks:snapshot.hooks,commands:snapshot.commands,parsers:snapshot.parsers,preflight:snapshot.preflight,services:snapshot.services,renderers:snapshot.renderers,registrations:snapshot.registrations,pmRoot}):null}async function loadRuntimeExtensionCommandDescriptorsForRecovery(pmRoot){const snapshot=await loadRuntimeExtensionSnapshot(pmRoot);return snapshot?new Map(snapshot.commandDescriptors):activeRuntimeExtensionCommandDescriptors}async function resolveHelpRecoveryDescriptors(helpRequest,bootstrapGlobal){return!helpRequest.requested||bootstrapGlobal.noExtensions||isKnownHelpCommandPath(program,helpRequest.commandPathTokens)?activeRuntimeExtensionCommandDescriptors:loadRuntimeExtensionCommandDescriptorsForRecovery(resolvePmRoot(process.cwd(),bootstrapGlobal.path))}async function executeRegisteredRuntimeMigrations(migrations,pmRoot){return(await runExtensionMigrations({pmRoot,migrations,author:"pm-extension-migration"})).migrations.filter(migration=>migration.outcome==="failed").map(migration=>`extension_migration_failed:${migration.layer}:${migration.extension}:${migration.id}`)}function buildExtensionCommandSdk(pmRoot,global2,commandPath){const author=typeof global2.author=="string"&&global2.author.trim()?global2.author.trim():"pm-extension";return createExtensionCommandSdk(pmRoot,PmClient.forActiveExtensionHost({pmRoot,author}),author,normalizeExtensionCommandPath(commandPath))}async function runRequiredExtensionCommand(command,options,globalOptions,extensionFlagDefinitions=[]){const commandPath=getCommandPath(command);let commandArgs=stripLooseCommandOptionTokens(command.args.map(String),extensionFlagDefinitions),commandOptions={...options},resolvedGlobalOptions={...globalOptions};const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),parserOverride=await runActiveParserOverride({command:commandPath,args:commandArgs,options:commandOptions,global:resolvedGlobalOptions,pm_root:pmRoot});globalOptions.profile&&parserOverride.warnings.length>0&&printError(`profile:extensions parser_warnings=${formatHookWarnings(parserOverride.warnings)}`),commandArgs=parserOverride.context.args,commandOptions=parserOverride.context.options,resolvedGlobalOptions=parserOverride.context.global,validateDynamicExtensionCommandInvocation(activeRuntimeExtensionCommandDescriptors.get(normalizeExtensionCommandPath(commandPath)),commandArgs,commandOptions,extensionFlagDefinitions),setActiveCommandResult(void 0),setActiveCommandContext({command:commandPath,args:commandArgs,options:{...commandOptions},global:{...resolvedGlobalOptions},pm_root:pmRoot});const extensionCommandResult=await runActiveCommandHandler({command:commandPath,args:commandArgs,options:commandOptions,global:resolvedGlobalOptions,pm_root:pmRoot,sdk:buildExtensionCommandSdk(pmRoot,resolvedGlobalOptions,commandPath)});if(resolvedGlobalOptions.profile&&extensionCommandResult.warnings.length>0&&printError(`profile:extensions command_handler_warnings=${formatHookWarnings(extensionCommandResult.warnings)}`),!extensionCommandResult.handled){if(extensionCommandResult.warnings.length>0){const warningCode=extensionCommandResult.warnings[0],cause=extensionCommandResult.errorMessage?.trim(),causeSuffix=cause?` ${cause}`:"";throw new PmCliError(`Command "${commandPath}" failed in extension handler (${warningCode}).${causeSuffix}`,EXIT_CODE.GENERIC_FAILURE,{code:extensionCommandResult.errorCode??"command_failed",nextSteps:extensionCommandResult.remediation?[extensionCommandResult.remediation]:void 0})}throw new PmCliError(`Command "${commandPath}" is provided by extensions and is not currently available.`,EXIT_CODE.NOT_FOUND)}return extensionCommandResult.exitCode!==void 0&&(process.exitCode=extensionCommandResult.exitCode),setActiveCommandResult(extensionCommandResult.result),extensionCommandResult.result}const WRAPPED_ACTION_HANDLER=Symbol("pm.wrappedActionHandler");function resolveActionCommand(actionArgs,fallback){const possibleCommand=actionArgs[actionArgs.length-1];return possibleCommand instanceof Command?possibleCommand:fallback}function maybePrintExtensionProfileWarnings(enabled,label,warnings){enabled&&warnings.length>0&&printError(`profile:extensions ${label}=${formatHookWarnings(warnings)}`)}function validateDynamicInvocationArgs(params){const dynamicDescriptor=activeRuntimeExtensionCommandDescriptors.get(normalizeExtensionCommandPath(params.commandPath));if(!dynamicDescriptor||!isImporterOrExporterCommandPath(params.activeRegistrations,params.commandPath))return;const positionalArgs=dynamicCommandArguments(dynamicDescriptor).length===0?collectLoosePositionalArgs(params.commandArgs):stripLooseCommandOptionTokens(params.commandArgs,params.extensionFlagDefinitions);validateDynamicExtensionCommandArgs(dynamicDescriptor,positionalArgs)}function syncCommanderActionArgs(actionCommand,actionArgs,commandArgs){actionCommand.args=[...commandArgs],"_processArguments"in actionCommand&&typeof actionCommand._processArguments=="function"&&actionCommand._processArguments(),actionArgs.length>0&&Array.isArray(actionArgs[0])&&(actionArgs[0]=[...actionCommand.processedArgs])}function wrapProgramActionsForExtensionHandlers(rootProgram){const visit=entry=>{const actionEntry=entry;if(typeof actionEntry._actionHandler=="function"&&actionEntry[WRAPPED_ACTION_HANDLER]!==!0){const originalAction=actionEntry._actionHandler;actionEntry._actionHandler=async function(...actionArgs){const actionCommand=resolveActionCommand(actionArgs,entry),startedAt=Date.now();clearResolvedGlobalOptions(actionCommand);let globalOptions=getGlobalOptions(actionCommand);const commandPath=resolvePmCommandOperation(getCommandPath(actionCommand));if(["package inventory","packages inventory","extension inventory"].includes(commandPath))return await originalAction.apply(this,actionArgs);const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);let commandArgs=actionCommand.args.map(String);const activeRegistrations=getActiveExtensionRegistrations(),extensionFlagDefinitions=activeRegistrations?collectExtensionFlagDefinitionsForInvocation(activeRegistrations,commandPath,commandArgs):[],runtimeFieldFlagDefinitions=await collectRuntimeFieldLooseFlagDefinitionsForCommand(commandPath,pmRoot);let commandOptions=extractCommandScopedOptions(actionCommand,commandArgs,[...extensionFlagDefinitions,...runtimeFieldFlagDefinitions]);const parserOverride=await runActiveParserOverride({command:commandPath,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:pmRoot});maybePrintExtensionProfileWarnings(globalOptions.profile,"parser_warnings",parserOverride.warnings),commandArgs=parserOverride.context.args,commandOptions=parserOverride.context.options,copyReadOutputInvocationProvenance(actionCommand,commandOptions),globalOptions=parserOverride.context.global,validateDynamicInvocationArgs({activeRegistrations,commandPath,commandArgs,extensionFlagDefinitions}),globalOptions=await applyDefaultOutputFormat(globalOptions),setResolvedGlobalOptions(actionCommand,globalOptions),syncCommanderActionArgs(actionCommand,actionArgs,commandArgs),syncCommanderActionOptions(actionCommand,commandOptions),setActiveCommandResult(void 0),setActiveCommandContext({command:commandPath,args:commandArgs,options:{...commandOptions},global:{...globalOptions},pm_root:pmRoot});const extensionCommandResult=await runActiveCommandHandler({command:commandPath,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:pmRoot,sdk:buildExtensionCommandSdk(pmRoot,globalOptions,commandPath)});if(maybePrintExtensionProfileWarnings(globalOptions.profile,"command_handler_warnings",extensionCommandResult.warnings),extensionCommandResult.handled){setActiveCommandResult(extensionCommandResult.result),printResult(extensionCommandResult.result,{...globalOptions,command:commandPath,commandArgs,commandOptions,pmRoot}),globalOptions.profile&&printError(`profile:command=${commandPath} took_ms=${Date.now()-startedAt}`);return}return await originalAction.apply(this,actionArgs)},actionEntry[WRAPPED_ACTION_HANDLER]=!0}for(const child of entry.commands)visit(child)};visit(rootProgram)}async function clearDynamicExtensionCommandState(params){activeRuntimeExtensionCommandDescriptors=new Map,setActiveExtensionServices({overrides:[]}),params&&await maybeAttachCreateUpdatePolicyHelpText(params.rootProgram,params.pmRoot,params.invocationArgv,createEmptyExtensionRegistrationRegistry(),params.settings)}function attachDynamicExtensionHelp(command,descriptor,flagHelp,metadataHelp){if(descriptor?.flags&&descriptor.flags.length>0){applyDynamicExtensionFlagOptions(command,descriptor.flags);const residualFlagHelp=buildResidualDynamicExtensionFlagHelp(command,descriptor.flags);residualFlagHelp&&command.addHelpText("after",residualFlagHelp)}else flagHelp&&command.addHelpText("after",flagHelp);metadataHelp&&command.addHelpText("after",metadataHelp)}function applyDynamicExtensionRootHelpVisibility(rootProgram,preexistingTopLevelCommands,descriptors){const tierRank={core:0,standard:1,full:2,internal:3},applyVisibility=(command,pathParts)=>{const commandPath=pathParts.join(" "),matchingDescriptors=[...descriptors.entries()].filter(([path])=>path===commandPath||path.startsWith(`${commandPath} `)).map(([,descriptor])=>descriptor),tier=matchingDescriptors.length===0?"standard":matchingDescriptors.reduce((selected,descriptor)=>tierRank[descriptor.tier]<tierRank[selected]?descriptor.tier:selected,"internal");setPmCommandHelpVisibilityTier(command,tier);for(const child of command.commands)applyVisibility(child,[...pathParts,child.name()])};for(const command of rootProgram.commands)preexistingTopLevelCommands.has(command.name())||applyVisibility(command,[command.name()])}async function registerDynamicExtensionCommandPaths(rootProgram,invocationArgv){const bootstrapGlobalOptions=parseBootstrapGlobalOptions(invocationArgv),pmRoot=resolvePmRoot(process.cwd(),bootstrapGlobalOptions.path);if(bootstrapGlobalOptions.noExtensions){await clearDynamicExtensionCommandState({rootProgram,pmRoot,invocationArgv});return}const discoverySnapshot=await loadRuntimeExtensionDiscoverySnapshot(pmRoot),probe=buildBootstrapActivationProbe(invocationArgv);if(!discoverySnapshot){await clearDynamicExtensionCommandState();return}if(!discoveryNeedsActivationForProbe(discoverySnapshot.discovery,probe)){await clearDynamicExtensionCommandState({rootProgram,pmRoot,invocationArgv,settings:discoverySnapshot.settings}),emitExtensionSkippedProfile(bootstrapProfileEnabled(invocationArgv),discoverySnapshot,probe);return}const snapshot=await loadRuntimeExtensionSnapshot(pmRoot,probe);if(!snapshot){await clearDynamicExtensionCommandState({rootProgram,pmRoot,invocationArgv,settings:discoverySnapshot.settings});return}setActiveExtensionServices(snapshot.services),activeRuntimeExtensionCommandDescriptors=new Map(snapshot.commandDescriptors),await maybeAttachCreateUpdatePolicyHelpText(rootProgram,pmRoot,invocationArgv,snapshot.registrations,snapshot.settings);const commandPaths=collectSafeExtensionCommandPaths(rootProgram,snapshot.commandHandlers,snapshot.commandDescriptors,snapshot.commandAliases,warning=>reportExtensionCommandCollision(snapshot.activationWarnings,printError,warning)),preexistingTopLevelCommands=new Set(rootProgram.commands.map(command=>command.name())),registerCommandPath=commandPath=>{const pathParts=commandPath.split(" ").filter(part=>part.length>0),descriptor=snapshot.commandDescriptors.get(commandPath),existingCommand=findCommandByPath(rootProgram,pathParts),flagHelp=snapshot.commandFlagHelp.get(commandPath),metadataHelp=descriptor?buildDynamicExtensionCommandMetadataHelp(descriptor):null;if(existingCommand){attachDynamicExtensionHelp(existingCommand,descriptor,flagHelp,metadataHelp);return}const dynamicCommand=ensureCommandPath(rootProgram,pathParts);descriptor?.description&&dynamicCommand.description(descriptor.description);let residualDynamicFlagHelp=flagHelp;descriptor&&(applyDynamicExtensionArguments(dynamicCommand,descriptor),descriptor.flags.length>0&&(applyDynamicExtensionFlagOptions(dynamicCommand,descriptor.flags),residualDynamicFlagHelp=buildResidualDynamicExtensionFlagHelp(dynamicCommand,descriptor.flags)??void 0)),residualDynamicFlagHelp&&dynamicCommand.addHelpText("after",residualDynamicFlagHelp),metadataHelp&&dynamicCommand.addHelpText("after",metadataHelp),dynamicCommand.allowUnknownOption(!0).allowExcessArguments(!0).action(async(...actionArgs)=>{const maybeCommand=actionArgs[actionArgs.length-1],command=maybeCommand instanceof Command?maybeCommand:dynamicCommand,globalOptions=getGlobalOptions(command),startedAt=Date.now(),extensionFlagDefinitions=collectExtensionFlagDefinitionsForInvocation(snapshot.registrations,commandPath,command.args.map(String)),scopedOptions=extractCommandScopedOptions(command,command.args.map(String),extensionFlagDefinitions),result=await runRequiredExtensionCommand(command,scopedOptions,globalOptions,extensionFlagDefinitions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,{...globalOptions,command:commandPath,commandArgs:command.args.map(String),commandOptions:scopedOptions,pmRoot}),globalOptions.profile&&printError(`profile:command=${commandPath} took_ms=${Date.now()-startedAt}`)})};for(const commandPath of commandPaths)registerCommandPath(commandPath);applyDynamicExtensionRootHelpVisibility(rootProgram,preexistingTopLevelCommands,snapshot.commandDescriptors)}const CLI_VERSION=resolvePmCliVersion(import.meta.url,["../.."])??"0.0.0";let program=createPmCliProgram(CLI_VERSION);async function recordActiveDeprecatedAliasUsage(rootProgram){if(!activeTelemetryCommandContext)return;const alias=Reflect.get(rootProgram,DEPRECATED_ALIAS_INVOCATION);typeof alias=="string"&&await recordDeprecatedAliasUsage(alias)}async function runCommandPreparation(actionCommand,skipped,run){const commandPath=getCommandPath(actionCommand);return["item mutate","item complete"].includes(commandPath)&&actionCommand.optsWithGlobals().dryRun===!0?skipped:run()}async function loadRuntimeReadDeclarations(actionCommand){const snapshot=await maybeLoadRuntimeExtensions(actionCommand);return setActiveExtensionRegistrations(snapshot?.registrations??null),snapshot}function attachProgramLifecycleHooks(rootProgram,invocationArgv){invocationArgv&&isStaticExtensionInventoryInvocation(invocationArgv)||(rootProgram.hook("preAction",async(_thisCommand,actionCommand)=>{activeExtensionHookContext=null,activeTelemetryCommandContext=null,clearActiveExtensionHooks(),clearResolvedGlobalOptions(actionCommand);const rawGlobalOptions=actionCommand.optsWithGlobals(),bootstrapGlobalOptions=getGlobalOptions(actionCommand),commandPath=resolvePmCommandOperation(getCommandPath(actionCommand));let commandArgs=actionCommand.args.map(String),commandOptions=extractCommandScopedOptions(actionCommand,commandArgs),globalOptions={...bootstrapGlobalOptions};const fallbackPmRoot=resolvePmRoot(process.cwd(),bootstrapGlobalOptions.path),runtimeExtensions=await loadRuntimeReadDeclarations(actionCommand);if(validateReadOutputOptions(commandPath,{...commandOptions,outputInclude:rawGlobalOptions.outputInclude,outputLimit:rawGlobalOptions.outputLimit,outputBudget:rawGlobalOptions.outputBudget,outputFormat:rawGlobalOptions.outputFormat,outputSession:rawGlobalOptions.outputSession,outputCursor:rawGlobalOptions.outputCursor}),forwardReadOutputIncludeModes(actionCommand,commandPath,globalOptions,commandOptions),await runCommandPreparation(actionCommand,void 0,()=>maybeRunFirstUseTelemetryPrompt(commandPath,globalOptions)),!runtimeExtensions){activeExtensionHookContext=createCoreCommandHookContext({commandName:commandPath,commandArgs,commandOptions,globalOptions,pmRoot:fallbackPmRoot}),activeTelemetryCommandContext=await startTelemetryCommand({command:commandPath,pm_version:CLI_VERSION,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:fallbackPmRoot}),await recordActiveDeprecatedAliasUsage(rootProgram),sentrySetCommandContext(commandPath,commandArgs,commandOptions,{source_context:activeTelemetryCommandContext?.source_context,source_context_source:activeTelemetryCommandContext?.source_context_source}),sentryStartCommandSpan(commandPath),await enforceItemFormatWriteGateAndPreflightMigration(commandPath,commandOptions,fallbackPmRoot,defaultPreflightDecision()),await enforceMutationGuardPreflight(commandPath,commandArgs,commandOptions,globalOptions,fallbackPmRoot);return}setActiveExtensionHooks(runtimeExtensions.hooks),setActiveExtensionCommands(runtimeExtensions.commands),setActiveExtensionParsers(runtimeExtensions.parsers),setActiveExtensionPreflight(runtimeExtensions.preflight),setActiveExtensionServices(runtimeExtensions.services),setActiveExtensionRenderers(runtimeExtensions.renderers),setActiveExtensionRegistrations(runtimeExtensions.registrations);const extensionFlagDefinitions=collectExtensionFlagDefinitionsForInvocation(runtimeExtensions.registrations,commandPath,commandArgs);commandOptions=extractCommandScopedOptions(actionCommand,commandArgs,extensionFlagDefinitions),forwardReadOutputIncludeModes(actionCommand,commandPath,globalOptions,commandOptions);const parserOverride=await runActiveParserOverride({command:commandPath,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:runtimeExtensions.pmRoot});globalOptions.profile&&parserOverride.warnings.length>0&&printError(`profile:extensions parser_warnings=${formatHookWarnings(parserOverride.warnings)}`),commandArgs=parserOverride.context.args,commandOptions=parserOverride.context.options,copyReadOutputInvocationProvenance(actionCommand,commandOptions),globalOptions=parserOverride.context.global,syncCommanderActionOptions(actionCommand,commandOptions);const preflightOverride=await runActivePreflightOverride({command:commandPath,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:runtimeExtensions.pmRoot,decision:defaultPreflightDecision()});globalOptions.profile&&preflightOverride.warnings.length>0&&printError(`profile:extensions preflight_warnings=${formatHookWarnings(preflightOverride.warnings)}`),commandArgs=preflightOverride.context.args,commandOptions=preflightOverride.context.options,copyReadOutputInvocationProvenance(actionCommand,commandOptions),globalOptions=preflightOverride.context.global,syncCommanderActionOptions(actionCommand,commandOptions);const preflightDecision=preflightOverride.decision;await enforceItemFormatWriteGateAndPreflightMigration(commandPath,commandOptions,runtimeExtensions.pmRoot,preflightDecision),await enforceMutationGuardPreflight(commandPath,commandArgs,commandOptions,globalOptions,runtimeExtensions.pmRoot);const migrationWarnings=preflightDecision.run_extension_migrations?await runCommandPreparation(actionCommand,[],()=>executeRegisteredRuntimeMigrations(runtimeExtensions.registrations.migrations,runtimeExtensions.pmRoot)):[];globalOptions.profile&&migrationWarnings.length>0&&printError(`profile:extensions migration_warnings=${formatHookWarnings(migrationWarnings)}`);const migrationBlockers=collectMandatoryMigrationBlockers(runtimeExtensions.registrations.migrations);activeExtensionHookContext={hooks:runtimeExtensions.hooks,commandName:commandPath,commandArgs,commandOptions:{...commandOptions},globalOptions:{...globalOptions},pmRoot:runtimeExtensions.pmRoot,profileEnabled:!!globalOptions.profile,migrationBlockers},setActiveCommandResult(void 0),setActiveCommandContext({command:commandPath,args:commandArgs,options:{...commandOptions},global:{...globalOptions},pm_root:runtimeExtensions.pmRoot}),activeTelemetryCommandContext=await startTelemetryCommand({command:commandPath,pm_version:CLI_VERSION,args:commandArgs,options:commandOptions,global:globalOptions,pm_root:runtimeExtensions.pmRoot}),await recordActiveDeprecatedAliasUsage(rootProgram),sentrySetCommandContext(commandPath,commandArgs,commandOptions,{source_context:activeTelemetryCommandContext?.source_context,source_context_source:activeTelemetryCommandContext?.source_context_source}),sentryStartCommandSpan(commandPath);const hookWarnings=await runBeforeCommandHooks(runtimeExtensions.hooks,{command:commandPath,args:commandArgs,options:{...commandOptions},global:{...globalOptions},pm_root:runtimeExtensions.pmRoot});globalOptions.profile&&hookWarnings.length>0&&printError(`profile:extensions hook_warnings=${formatHookWarnings(hookWarnings)}`),preflightDecision.enforce_mandatory_migration_gate&&enforceMandatoryMigrationWriteGate(commandPath,commandOptions,migrationBlockers)}),rootProgram.hook("postAction",async()=>{const outcome=buildPostActionTelemetryOutcome();sentryFinishCommandSpan(outcome.ok,outcome.error,{error_code:outcome.error_code,error_category:outcome.error_category,exit_code:outcome.exit_code,command_resolution:outcome.command_resolution,resolution_stage:outcome.resolution_stage}),await runAndClearAfterCommandHooks(outcome)}))}attachProgramLifecycleHooks(program);const IDEMPOTENT_TOP_LEVEL_REGISTRATION=Symbol("pmCliIdempotentTopLevelRegistration");function ensureIdempotentTopLevelCommandRegistration(rootProgram){const guarded=rootProgram;if(guarded[IDEMPOTENT_TOP_LEVEL_REGISTRATION])return;guarded[IDEMPOTENT_TOP_LEVEL_REGISTRATION]=!0;const registerOriginalCommand=rootProgram.command.bind(rootProgram);rootProgram.command=((nameAndArgs,...rest)=>{const commandName=nameAndArgs.split(/\s+/u)[0];return rootProgram.commands.some(existing=>existing.name()===commandName||existing.aliases().includes(commandName))?new Command(commandName):registerOriginalCommand(nameAndArgs,...rest)})}async function registerCoreCommandFamilies(rootProgram,selection){if(ensureIdempotentTopLevelCommandRegistration(rootProgram),selection.setup){const{registerSetupCommands}=await loadSetupRegistrationModule();registerSetupCommands(rootProgram)}if(selection.listQuery){const{registerListQueryCommands}=await loadListQueryRegistrationModule(),commandFilter=typeof selection.targetCommandName=="string"&&LIST_QUERY_COMMAND_NAMES.has(selection.targetCommandName)?new Set([selection.targetCommandName]):void 0;registerListQueryCommands(rootProgram,commandFilter?{commandFilter}:void 0)}if(selection.mutation){const{registerMutationCommands}=await loadMutationRegistrationModule();registerMutationCommands(rootProgram,{targetCommandName:selection.targetCommandName})}if(selection.operation){const{registerOperationCommands}=await loadOperationRegistrationModule();registerOperationCommands(rootProgram)}}function createTelemetryCommandErrorEmitter(params){return async event=>{const errorCategory=resolveTelemetryErrorCategory(event.errorCode),commandResolution=deriveTelemetryCommandResolution({ok:!1,errorCode:event.errorCode,errorCategory});return await emitTelemetryErrorEvent({command:event.command,args:params.invocationArgv,options:event.options,global:params.bootstrapGlobal,pm_version:CLI_VERSION,pm_root:params.bootstrapPmRoot,error_code:event.errorCode,error_message:event.errorMessage,exit_code:event.exitCode,error_category:errorCategory,command_resolution:commandResolution,resolution_stage:event.resolutionStage}),{errorCategory,commandResolution}}}async function prepareExtensionServicesForRunPmCliError(params){if(params.bootstrapGlobal.noExtensions||isStaticExtensionInventoryInvocation(params.invocationArgv))return;const bootstrapProbe=buildBootstrapActivationProbe(params.invocationArgv),discoverySnapshot=await loadRuntimeExtensionDiscoverySnapshot(params.bootstrapPmRoot);if(discoverySnapshot&&discoveryNeedsActivationForProbe(discoverySnapshot.discovery,bootstrapProbe)){const bootstrapSnapshot=await loadRuntimeExtensionSnapshot(params.bootstrapPmRoot,bootstrapProbe);setRecoveredExtensionServices(bootstrapSnapshot);return}discoverySnapshot&&emitExtensionSkippedProfile(bootstrapProfileEnabled(params.invocationArgv),discoverySnapshot,bootstrapProbe),setActiveExtensionServices({overrides:[]})}function setRecoveredExtensionServices(bootstrapSnapshot){if(!bootstrapSnapshot){setActiveExtensionServices({overrides:[]});return}setActiveExtensionServices(bootstrapSnapshot.services)}async function finishRunPmCliFailure(params){sentryFinishCommandSpan(!1,params.errorMessage,{error_code:params.classificationCode,error_category:params.errorCategory,exit_code:params.exitCode,command_resolution:params.commandResolution,resolution_stage:params.resolutionStage}),await runAndClearAfterCommandHooks({ok:!1,error:params.errorMessage,exit_code:params.exitCode,error_code:params.classificationCode,error_category:params.errorCategory,command_resolution:params.commandResolution,resolution_stage:params.resolutionStage})}async function finishRunPmCliSuccessParse(){sentryFinishCommandSpan(!0,void 0,{exit_code:EXIT_CODE.SUCCESS,command_resolution:"success",resolution_stage:"parse"}),await runAndClearAfterCommandHooks({ok:!0,exit_code:EXIT_CODE.SUCCESS,command_resolution:"success",resolution_stage:"parse"}),process.exitCode=EXIT_CODE.SUCCESS}async function handleRunPmCliKnownError(context,numericExitCode){const hasExplicitExitCode=typeof numericExitCode=="number"&&Number.isFinite(numericExitCode);if(!(context.error instanceof PmCliError)&&(isCommanderError(context.error)||!hasExplicitExitCode))return!1;const errorMessage=describeUnknownError(context.error),exitCode=context.error instanceof PmCliError?context.error.exitCode:normalizeThrownExitCode(numericExitCode),rawContext=context.error instanceof PmCliError?context.error.context:void 0,enrichedContext=buildPmCliRecoveryContext(rawContext,context.invocationArgv,errorMessage),classification=classifyPmCliError(errorMessage,enrichedContext),jsonErrorPayload=context.bootstrapGlobal.lean?projectLeanErrorEnvelope(formatPmCliErrorForJson(errorMessage,exitCode,enrichedContext)):formatPmCliErrorForJson(errorMessage,exitCode,enrichedContext),renderedError=context.jsonErrors?JSON.stringify(context.bootstrapGlobal.tokenAccounting?attachOutputTokenAccounting(jsonErrorPayload,value=>`${JSON.stringify(value,null,2)}
 `):jsonErrorPayload,null,2):formatPmCliErrorForDisplay(errorMessage,enrichedContext);context.jsonErrors?writeStderr(`${renderedError}
 `):printError(renderedError);const{errorCategory,commandResolution}=await context.emitTelemetryCommandError({command:context.attemptedCommand,errorCode:classification.code,errorMessage:classification.detail,exitCode,options:{bootstrap_global_options:context.bootstrapGlobal},resolutionStage:"execute"}),loggedHandledErrorToSentry=await maybeLogHandledCliErrorToSentry({command:context.attemptedCommand,error_code:classification.code,error_category:errorCategory,exit_code:exitCode,error_message:classification.detail,command_resolution:commandResolution,resolution_stage:"execute",source_context:activeTelemetryCommandContext?.source_context});return await finishRunPmCliFailure({errorMessage,exitCode,classificationCode:classification.code,errorCategory,commandResolution,resolutionStage:"execute"}),loggedHandledErrorToSentry&&(sentryCaptureCliError(wrapThrownErrorForSentry(context.error,errorMessage)),await sentryFlush(HANDLED_ERROR_SENTRY_FLUSH_TIMEOUT_MS)),process.exitCode=exitCode,!0}async function handleUnknownHelpCommandError(context,code){const unknownPath=parseBootstrapHelpRequest(context.invocationArgv).commandPathTokens.join(" ")||resolveUnknownCommanderToken(context.invocationArgv),unknownToken=resolvePmCommandOperation(unknownPath),unknownMessage=`unknown command '${unknownPath}'`,pmRoot=resolvePmRoot(process.cwd(),context.bootstrapGlobal.path),recoveryCommandDescriptors=context.bootstrapGlobal.noExtensions?activeRuntimeExtensionCommandDescriptors:await loadRuntimeExtensionCommandDescriptorsForRecovery(pmRoot),recoveryProbe=buildBootstrapActivationProbe(context.invocationArgv),failedExtensions=context.bootstrapGlobal.noExtensions?[]:await loadExtensionRecoveryFailures(pmRoot,{},collectActivationCommandCandidates(recoveryProbe)),usageContext=await resolveCommanderUsageContext({message:unknownMessage},program,recoveryCommandDescriptors,{failedExtensions},context.invocationArgv),classification=classifyCommanderError(usageContext.message,usageContext.commandName,usageContext.allowedTypes,{unknownCommandExamples:usageContext.unknownCommandExamples,unknownCommandNextSteps:usageContext.unknownCommandNextSteps,attemptedCommand:usageContext.attemptedCommand,normalizedInvocationArgs:usageContext.normalizedInvocationArgs,providedOptionFlags:usageContext.providedOptionFlags,unknownOptionSuggestions:usageContext.unknownOptionSuggestions,suggestedRetryCommand:usageContext.suggestedRetryCommand,failedExtensions}),{errorCategory,commandResolution}=await context.emitTelemetryCommandError({command:unknownToken,errorCode:classification.code,errorMessage:classification.detail,exitCode:EXIT_CODE.USAGE,options:{bootstrap_global_options:context.bootstrapGlobal,commander_code:code??"commander.helpDisplayed"},resolutionStage:"parse"}),loggedHandledErrorToSentry=await maybeLogHandledCliErrorToSentry({command:unknownToken,error_code:classification.code,error_category:errorCategory,exit_code:EXIT_CODE.USAGE,error_message:classification.detail,command_resolution:commandResolution,resolution_stage:"parse"}),baseRenderedUsage=context.jsonErrors?await formatCommanderUsageJson({message:unknownMessage},program,recoveryCommandDescriptors,context.bootstrapGlobal.lean===!0,{failedExtensions},context.invocationArgv):await formatCommanderUsageMessage({message:unknownMessage},program,recoveryCommandDescriptors,{failedExtensions},context.invocationArgv),renderedUsage=appendCommanderExtensionFailures(baseRenderedUsage,context.jsonErrors,failedExtensions);await finishRunPmCliFailure({errorMessage:unknownMessage,exitCode:EXIT_CODE.USAGE,classificationCode:classification.code,errorCategory,commandResolution,resolutionStage:"parse"}),context.jsonErrors?writeStderr(`${renderedUsage}
 `):printError(renderedUsage),loggedHandledErrorToSentry&&await sentryFlush(HANDLED_ERROR_SENTRY_FLUSH_TIMEOUT_MS),process.exitCode=EXIT_CODE.USAGE}async function handleRunPmCliHelpDisplayError(context,code,rawMessage){if(!(code==="commander.helpDisplayed"||code==="commander.help"||code==="commander.helpCommand")&&!rawMessage.includes("(outputHelp)"))return!1;const helpRequest=parseBootstrapHelpRequest(context.invocationArgv);return helpRequest.requested&&!isKnownHelpCommandPath(program,helpRequest.commandPathTokens)?(await handleUnknownHelpCommandError(context,code),!0):(await finishRunPmCliSuccessParse(),!0)}async function handleRunPmCliCommanderUsageError(context,code){const usageContext=await resolveCommanderUsageContext(context.error,program,activeRuntimeExtensionCommandDescriptors,{},context.invocationArgv),classification=classifyCommanderError(usageContext.message,usageContext.commandName,usageContext.allowedTypes,{unknownCommandExamples:usageContext.unknownCommandExamples,unknownCommandNextSteps:usageContext.unknownCommandNextSteps,attemptedCommand:usageContext.attemptedCommand,normalizedInvocationArgs:usageContext.normalizedInvocationArgs,providedOptionFlags:usageContext.providedOptionFlags,unknownOptionSuggestions:usageContext.unknownOptionSuggestions,suggestedRetryCommand:usageContext.suggestedRetryCommand}),{errorCategory,commandResolution}=await context.emitTelemetryCommandError({command:context.attemptedCommand,errorCode:classification.code,errorMessage:classification.detail,exitCode:EXIT_CODE.USAGE,options:{bootstrap_global_options:context.bootstrapGlobal,commander_code:code},resolutionStage:"parse"}),loggedHandledErrorToSentry=await maybeLogHandledCliErrorToSentry({command:context.attemptedCommand,error_code:classification.code,error_category:errorCategory,exit_code:EXIT_CODE.USAGE,error_message:classification.detail,command_resolution:commandResolution,resolution_stage:"parse",source_context:activeTelemetryCommandContext?.source_context}),baseRenderedUsage=context.jsonErrors?await formatCommanderUsageJson(context.error,program,activeRuntimeExtensionCommandDescriptors,context.bootstrapGlobal.lean===!0,{},context.invocationArgv):await formatCommanderUsageMessage(context.error,program,activeRuntimeExtensionCommandDescriptors,{},context.invocationArgv),recoveryFailures=await loadUnknownCommandRecoveryFailures(classification.code,context.bootstrapPmRoot,{},collectActivationCommandCandidates(buildBootstrapActivationProbe(context.invocationArgv))),renderedUsage=appendCommanderExtensionFailures(baseRenderedUsage,context.jsonErrors,recoveryFailures);await finishRunPmCliFailure({errorMessage:usageContext.message,exitCode:EXIT_CODE.USAGE,classificationCode:classification.code,errorCategory,commandResolution,resolutionStage:"parse"}),context.jsonErrors?writeStderr(`${renderedUsage}

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

@@ -6,23 +6,23 @@
 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";
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Lifecycle state reported for status. */
-    status: string;
+/** Value that configures or reports layer for this contract. */
+layer: "global" | "project";
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Lifecycle state reported for status. */
+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;
-    /** Value that configures or reports force capable for this contract. */
-    forceCapable: boolean;
-    /** Value that configures or reports force requested for this contract. */
-    forceRequested: boolean;
+/** Whether mutation applies to this operation. */
+isMutation: boolean;
+/** Value that configures or reports force capable for this contract. */
+forceCapable: boolean;
+/** Value that configures or reports force requested for this contract. */
+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;
@@ -30,9 +30,9 @@ export declare function resolveMigrationId(definition: Record<string, unknown>,
 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>;
+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;
@@ -45,9 +45,9 @@ export declare function enforceSchemaMigrationInput(commandPath: string, command
  * 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;
+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;

package/dist/cli/register-list-query.d.ts

@@ -9,8 +9,8 @@ import type { Command } from "commander";
 import { getGlobalOptions } from "./registration-helpers.js";
 /** Restrict command registration for lazy CLI startup without changing action behavior. */
 export interface RegisterListQueryCommandsOptions {
-    /** Canonical names to register; an absent or empty set registers every family, and context accepts ctx. */
-    commandFilter?: Set<string>;
+/** Canonical names to register; an absent or empty set registers every family, and context accepts ctx. */
+commandFilter?: Set<string>;
 }
 type ListOutputFormat = "csv" | "table" | "json" | "ndjson" | "toon";
 /** Parses the `pm list --format` value into a supported render mode. csv/table are human export modes; json/toon override the machine output format. Returns undefined when no `--format` was supplied so the global output format applies. */
@@ -21,7 +21,7 @@ declare function resolveReadCommandOutputFormat(commandLabel: string, rawFormat:
 export declare function registerListQueryCommands(program: Command, options?: RegisterListQueryCommandsOptions): void;
 /** Compatibility access to the format validators used by registered CLI actions. */
 export declare const _testOnlyRegisterListQuery: {
-    resolveReadCommandOutputFormat: typeof resolveReadCommandOutputFormat;
-    parseListFormat: typeof parseListFormat;
+resolveReadCommandOutputFormat: typeof resolveReadCommandOutputFormat;
+parseListFormat: typeof parseListFormat;
 };
 export {};

package/dist/cli/register-mutation-options.d.ts

@@ -5,6 +5,6 @@
  */
 /** Optional controls used by the selective CLI bootstrap. */
 export interface RegisterMutationCommandsOptions {
-    /** Register only this mutation command when the family can safely short-circuit. */
-    targetCommandName?: string;
+/** Register only this mutation command when the family can safely short-circuit. */
+targetCommandName?: string;
 }

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

@@ -1,81 +1,81 @@
 import type { Command } from "commander";
 /** Refuse mutations and trust acknowledgement before scheduling an execution-only background run. */
 declare function validateBackgroundTestOptions(options: Record<string, unknown>, values: {
-    addValues: string[];
-    addJsonValues: string[];
-    removeValues: string[];
-    removeIndexValues: string[];
+addValues: string[];
+addJsonValues: string[];
+removeValues: string[];
+removeIndexValues: string[];
 }): void;
 /** Translate CLI option values into the shared SDK linked-test action contract. */
 declare function buildRunTestOptions(options: Record<string, unknown>, values: {
-    addValues: string[];
-    addJsonValues: string[];
-    removeValues: string[];
-    removeIndexValues: string[];
+addValues: string[];
+addJsonValues: string[];
+removeValues: string[];
+removeIndexValues: string[];
 }): {
-    list: boolean;
-    run: boolean;
-    match: string | undefined;
-    onlyIndex: string | number | undefined;
-    onlyLast: boolean;
-    timeout: string | undefined;
-    progress: boolean;
-    envSet: string[];
-    envClear: string[];
-    sharedHostSafe: boolean;
-    pmContext: string | undefined;
-    overrideLinkedPmContext: boolean;
-    workspaceContext: string | undefined;
-    overrideLinkedWorkspaceContext: boolean;
-    allowUntrustedLinkedTests: boolean;
-    acknowledgeLinkedTests: boolean;
-    failOnContextMismatch: boolean;
-    failOnSkipped: boolean;
-    failOnEmptyTestRun: boolean;
-    requireAssertionsForPm: boolean;
-    checkContext: boolean;
-    autoPmContext: boolean;
-    author: string | undefined;
-    message: string | undefined;
-    force: boolean;
-    measure: string[];
-    metricBelow: string | undefined;
-    metricDiff: string | undefined;
-    update: string | undefined;
-    updateIndex: string | number | undefined;
-    setJson: string | undefined;
-    add: string[];
-    addJson: string[];
-    remove: string[];
-    removeIndex: string[];
+list: boolean;
+run: boolean;
+match: string | undefined;
+onlyIndex: string | number | undefined;
+onlyLast: boolean;
+timeout: string | undefined;
+progress: boolean;
+envSet: string[];
+envClear: string[];
+sharedHostSafe: boolean;
+pmContext: string | undefined;
+overrideLinkedPmContext: boolean;
+workspaceContext: string | undefined;
+overrideLinkedWorkspaceContext: boolean;
+allowUntrustedLinkedTests: boolean;
+acknowledgeLinkedTests: boolean;
+failOnContextMismatch: boolean;
+failOnSkipped: boolean;
+failOnEmptyTestRun: boolean;
+requireAssertionsForPm: boolean;
+checkContext: boolean;
+autoPmContext: boolean;
+author: string | undefined;
+message: string | undefined;
+force: boolean;
+measure: string[];
+metricBelow: string | undefined;
+metricDiff: string | undefined;
+update: string | undefined;
+updateIndex: string | number | undefined;
+setJson: string | undefined;
+add: string[];
+addJson: string[];
+remove: string[];
+removeIndex: string[];
 };
 /** Public contract for test-only operation adapter coverage. */
 export declare const _testOnlyRegisterOperations: {
-    buildRunTestOptions: typeof buildRunTestOptions;
-    buildRunTestAllOptions: typeof buildRunTestAllOptions;
-    runWorkspacePositionAction: typeof runWorkspacePositionAction;
-    validateBackgroundTestOptions: typeof validateBackgroundTestOptions;
+buildRunTestOptions: typeof buildRunTestOptions;
+buildRunTestAllOptions: typeof buildRunTestAllOptions;
+runWorkspacePositionAction: typeof runWorkspacePositionAction;
+validateBackgroundTestOptions: typeof validateBackgroundTestOptions;
 };
 declare function buildRunTestAllOptions(options: Record<string, unknown>): {
-    status: string | undefined;
-    limit: string | undefined;
-    offset: string | undefined;
-    timeout: string | undefined;
-    progress: boolean;
-    envSet: string[];
-    envClear: string[];
-    sharedHostSafe: boolean;
-    pmContext: string | undefined;
-    overrideLinkedPmContext: boolean;
-    workspaceContext: string | undefined;
-    overrideLinkedWorkspaceContext: boolean;
-    allowUntrustedLinkedTests: boolean;
-    failOnContextMismatch: boolean;
-    failOnSkipped: boolean;
-    failOnEmptyTestRun: boolean;
-    requireAssertionsForPm: boolean;
-    checkContext: boolean;
-    autoPmContext: boolean;
+status: string | undefined;
+limit: string | undefined;
+offset: string | undefined;
+timeout: string | undefined;
+progress: boolean;
+envSet: string[];
+envClear: string[];
+sharedHostSafe: boolean;
+pmContext: string | undefined;
+overrideLinkedPmContext: boolean;
+workspaceContext: string | undefined;
+overrideLinkedWorkspaceContext: boolean;
+allowUntrustedLinkedTests: boolean;
+failOnContextMismatch: boolean;
+failOnSkipped: boolean;
+failOnEmptyTestRun: boolean;
+requireAssertionsForPm: boolean;
+checkContext: boolean;
+autoPmContext: boolean;
 };
 declare function runWorkspacePositionAction(_options: Record<string, unknown>, command: Command): Promise<void>;
 /** Enforces the claim target XOR selection contract before dispatch. */

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

@@ -9,7 +9,7 @@ type LifecycleCommandVocabulary = "extension" | "package";
 declare function normalizeExtensionOptions(options: Record<string, unknown>, forcedAction?: ExtensionSubcommandAction, vocabulary?: LifecycleCommandVocabulary): Record<string, unknown>;
 /** Internal setup helpers exposed only for deterministic unit coverage. */
 export declare const _testOnlyRegisterSetup: {
-    normalizeExtensionOptions: typeof normalizeExtensionOptions;
+normalizeExtensionOptions: typeof normalizeExtensionOptions;
 };
 /** Register initialization, configuration, package, and extension setup commands. */
 export declare function registerSetupCommands(program: Command): void;

package/dist/cli/register-structured-mutation.d.ts

@@ -13,8 +13,8 @@ declare function runItemCompleteAction(id: string, positionalReason: string | un
 export declare function registerStructuredMutationCommands(program: Command): void;
 /** Internal action hooks used by exhaustive source-level registration tests. */
 export declare const structuredMutationTestOnly: {
-    runItemCompleteAction: typeof runItemCompleteAction;
-    runItemMutateAction: typeof runItemMutateAction;
-    runItemReopenAction: typeof runItemReopenAction;
+runItemCompleteAction: typeof runItemCompleteAction;
+runItemMutateAction: typeof runItemMutateAction;
+runItemReopenAction: typeof runItemReopenAction;
 };
 export {};

package/dist/cli/register-structured-mutation.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5e4ef16a-2514-5b22-b271-c98501736e55")}catch{}})();import{createStdinTokenResolver,EXIT_CODE,PmCliError,readSettings,resolveAuthor,resolvePmRoot}from"../sdk/runtime-primitives.js";import{buildItemCompletionMutations,commitItemCompletion,commitItemMutations,previewItemMutations}from"../sdk/item-transaction.js";import{runReopen}from"../sdk/lifecycle/reopen.js";import{parseAtomicMutationControls,resolveItemMutationDocument}from"../sdk/structured-mutations.js";import{collect,getGlobalOptions,invalidateSearchCachesForMutation,printResult}from"./registration-helpers.js";async function runItemReopenAction(id,reason,options,command){const globalOptions=getGlobalOptions(command),result=await runReopen(id,reason,{status:typeof options.status=="string"?options.status:void 0,author:typeof options.author=="string"?options.author:globalOptions.author,message:typeof options.message=="string"?options.message:void 0,force:options.force===!0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions)}async function runItemMutateAction(options,command){const globalOptions=getGlobalOptions(command),input=await createStdinTokenResolver().resolveValue("-","--stdin-json");if(input===void 0||input.trim().length===0)throw new PmCliError("pm item mutate requires a non-empty JSON batch on stdin.",EXIT_CODE.USAGE);const transactionId=typeof options.transactionId=="string"?options.transactionId.trim():"";if(transactionId.length===0)throw new PmCliError("pm item mutate requires --transaction-id <value>.",EXIT_CODE.USAGE);const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),settings=await readSettings(pmRoot),resolved=resolveItemMutationDocument(input,{transactionId,idPrefix:settings.id_prefix}),{mutations,references}=resolved,controls=parseAtomicMutationControls(options),author=resolveAuthor(typeof options.author=="string"?options.author:globalOptions.author,settings.author_default);if(options.dryRun===!0){const validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({transaction_id:transactionId,dry_run:!0,validation,mutation_count:mutations.length,mutations,references},globalOptions);return}const result=await commitItemMutations({pmRoot,transactionId,author,mutations,...controls});printResult({...result,mutation_count:mutations.length,references},globalOptions)}function resolveCompletionReason(positionalReason,optionReason){return typeof positionalReason=="string"&&positionalReason.trim().length>0?positionalReason.trim():typeof optionReason=="string"?optionReason.trim():""}async function runItemCompleteAction(id,positionalReason,options,command){const globalOptions=getGlobalOptions(command),transactionId=typeof options.transactionId=="string"?options.transactionId.trim():"";if(transactionId.length===0)throw new PmCliError("pm item complete requires --transaction-id <value>.",EXIT_CODE.USAGE);const reason=resolveCompletionReason(positionalReason,options.reason);if(reason.length===0)throw new PmCliError("pm item complete requires a close reason.",EXIT_CODE.USAGE);const evidence=Object.fromEntries(["file","doc","test","comment","note","learning"].filter(key=>options[key]!==void 0).map(key=>[key,options[key]])),force=options.force===!0,{lockTtlSeconds,lockWaitMs}=parseAtomicMutationControls(options),closeOptions={...typeof options.resolution=="string"?{resolution:options.resolution}:{},...typeof options.expectedResult=="string"?{expectedResult:options.expectedResult}:{},...typeof options.actualResult=="string"?{actualResult:options.actualResult}:{},...typeof options.completedAt=="string"?{completedAt:options.completedAt}:{},...typeof options.validateClose=="string"?{validateClose:options.validateClose}:{},...force?{force:!0}:{}},completion={id,reason,...Object.keys(evidence).length===0?{}:{evidence},...Object.keys(closeOptions).length===0?{}:{closeOptions},...force?{releaseOptions:{force:!0}}:{}},pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),author=resolveAuthor(typeof options.author=="string"?options.author:globalOptions.author,(await readSettings(pmRoot)).author_default);if(options.dryRun===!0){const mutations=buildItemCompletionMutations(completion),validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({transaction_id:transactionId,dry_run:!0,validation,mutation_count:mutations.length,mutations},globalOptions);return}const result=await commitItemCompletion({pmRoot,transactionId,author,...completion,lockTtlSeconds,lockWaitMs});printResult({...result,mutation_count:Object.keys(result.results).length},globalOptions)}function registerStructuredMutationCommands(program){const itemCommand=program.commands.find(command=>command.name()==="item")??program.command("item").description("Run item lifecycle operations.");itemCommand.command("reopen <id> <reason>").option("--status <value>","Active target status: open or in_progress").option("--message <value>","Human-readable recurrence history message").option("--force","Override ownership or stale-lock conflicts").option("--author <value>","Mutation author").description("Reopen terminal work with recurrence evidence.").action(runItemReopenAction),itemCommand.command("mutate").requiredOption("--transaction-id <value>","Stable idempotency key used to resume an interrupted batch").option("--stdin-json","Read the JSON mutation array from stdin",!0).option("--dry-run","Validate and preview the batch without writing").option("--create-compensation <mode>","Created-item compensation policy: close or delete","close").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--author <value>","Mutation author").description("Apply SDK-backed mutations atomically.").action(runItemMutateAction),itemCommand.command("complete <id> [reason]").requiredOption("--transaction-id <value>","Stable idempotency key for the composed completion").option("--reason <value>","Close reason when omitted positionally").option("--file <value>","Linked file evidence",collect).option("--doc <value>","Linked documentation evidence",collect).option("--test <value>","Linked test evidence",collect).option("--comment <value>","Evidence comment",collect).option("--note <value>","Completion note",collect).option("--learning <value>","Durable completion learning",collect).option("--resolution <value>","Structured resolution evidence").option("--expected-result <value>","Expected result evidence").option("--actual-result <value>","Actual result evidence").option("--completed-at <value>","Actual completion time").option("--validate-close <mode>","Close validation: off, warn, or strict").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--dry-run","Validate and preview completion without writing").option("--force","Override lifecycle and ownership conflicts").option("--author <value>","Completion author").description("Close with evidence and release the claim.").action(runItemCompleteAction)}const structuredMutationTestOnly={runItemCompleteAction,runItemMutateAction,runItemReopenAction};export{registerStructuredMutationCommands,structuredMutationTestOnly};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b8e1992a-e8ca-5c6f-8721-f8a5401f1ef1")}catch{}})();import{createStdinTokenResolver,EXIT_CODE,PmCliError,readSettings,resolveAuthor,resolvePmRoot}from"../sdk/runtime-primitives.js";import{buildItemCompletionMutations,commitItemCompletion,commitItemMutations,previewItemMutations}from"../sdk/item-transaction.js";import{runReopen}from"../sdk/lifecycle/reopen.js";import{parseAtomicMutationControls,resolveItemMutationDocument}from"../sdk/structured-mutations.js";import{collect,getGlobalOptions,invalidateSearchCachesForMutation,printResult}from"./registration-helpers.js";async function runItemReopenAction(id,reason,options,command){const globalOptions=getGlobalOptions(command),expectedResult=options.expectedResult??options.expected,result=await runReopen(id,reason,{status:typeof options.status=="string"?options.status:void 0,expectedResult:typeof expectedResult=="string"?expectedResult:void 0,author:typeof options.author=="string"?options.author:globalOptions.author,message:typeof options.message=="string"?options.message:void 0,force:options.force===!0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions)}async function runItemMutateAction(options,command){const globalOptions=getGlobalOptions(command),input=await createStdinTokenResolver().resolveValue("-","--stdin-json");if(input===void 0||input.trim().length===0)throw new PmCliError("pm item mutate requires a non-empty JSON batch on stdin.",EXIT_CODE.USAGE);const transactionId=typeof options.transactionId=="string"?options.transactionId.trim():"";if(transactionId.length===0)throw new PmCliError("pm item mutate requires --transaction-id <value>.",EXIT_CODE.USAGE);const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),settings=await readSettings(pmRoot),resolved=resolveItemMutationDocument(input,{transactionId,idPrefix:settings.id_prefix}),{mutations,references}=resolved,controls=parseAtomicMutationControls(options),author=resolveAuthor(typeof options.author=="string"?options.author:globalOptions.author,settings.author_default);if(options.dryRun===!0){const validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({transaction_id:transactionId,dry_run:!0,validation,mutation_count:mutations.length,mutations,references},globalOptions);return}const result=await commitItemMutations({pmRoot,transactionId,author,mutations,...controls});printResult({...result,mutation_count:mutations.length,references},globalOptions)}function resolveCompletionReason(positionalReason,optionReason){return typeof positionalReason=="string"&&positionalReason.trim().length>0?positionalReason.trim():typeof optionReason=="string"?optionReason.trim():""}async function runItemCompleteAction(id,positionalReason,options,command){const globalOptions=getGlobalOptions(command),transactionId=typeof options.transactionId=="string"?options.transactionId.trim():"";if(transactionId.length===0)throw new PmCliError("pm item complete requires --transaction-id <value>.",EXIT_CODE.USAGE);const reason=resolveCompletionReason(positionalReason,options.reason);if(reason.length===0)throw new PmCliError("pm item complete requires a close reason.",EXIT_CODE.USAGE);const evidence=Object.fromEntries(["file","doc","test","comment","note","learning"].filter(key=>options[key]!==void 0).map(key=>[key,options[key]])),force=options.force===!0,{lockTtlSeconds,lockWaitMs}=parseAtomicMutationControls(options),closeOptions={...typeof options.resolution=="string"?{resolution:options.resolution}:{},...typeof options.expectedResult=="string"?{expectedResult:options.expectedResult}:{},...typeof options.actualResult=="string"?{actualResult:options.actualResult}:{},...typeof options.completedAt=="string"?{completedAt:options.completedAt}:{},...typeof options.validateClose=="string"?{validateClose:options.validateClose}:{},...force?{force:!0}:{}},completion={id,reason,...Object.keys(evidence).length===0?{}:{evidence},...Object.keys(closeOptions).length===0?{}:{closeOptions},...force?{releaseOptions:{force:!0}}:{}},pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),author=resolveAuthor(typeof options.author=="string"?options.author:globalOptions.author,(await readSettings(pmRoot)).author_default);if(options.dryRun===!0){const mutations=buildItemCompletionMutations(completion),validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({transaction_id:transactionId,dry_run:!0,validation,mutation_count:mutations.length,mutations},globalOptions);return}const result=await commitItemCompletion({pmRoot,transactionId,author,...completion,lockTtlSeconds,lockWaitMs});printResult({...result,mutation_count:Object.keys(result.results).length},globalOptions)}function registerStructuredMutationCommands(program){const itemCommand=program.commands.find(command=>command.name()==="item")??program.command("item").description("Run item lifecycle operations.");itemCommand.command("reopen <id> <reason>").option("--status <value>","Active target status: open or in_progress").option("--expected-result <value>","Current active planning expectation; otherwise the receipt offers recovery").option("--expected <value>","Alias for --expected-result").option("--message <value>","Human-readable recurrence history message").option("--force","Override ownership or stale-lock conflicts").option("--author <value>","Mutation author").description("Reopen terminal work with recurrence evidence.").action(runItemReopenAction),itemCommand.command("mutate").requiredOption("--transaction-id <value>","Stable idempotency key used to resume an interrupted batch").option("--stdin-json","Read the JSON mutation array from stdin",!0).option("--dry-run","Validate and preview the batch without writing").option("--create-compensation <mode>","Created-item compensation policy: close or delete","close").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--author <value>","Mutation author").description("Apply SDK-backed mutations atomically.").action(runItemMutateAction),itemCommand.command("complete <id> [reason]").requiredOption("--transaction-id <value>","Stable idempotency key for the composed completion").option("--reason <value>","Close reason when omitted positionally").option("--file <value>","Linked file evidence",collect).option("--doc <value>","Linked documentation evidence",collect).option("--test <value>","Linked test evidence",collect).option("--comment <value>","Evidence comment",collect).option("--note <value>","Completion note",collect).option("--learning <value>","Durable completion learning",collect).option("--resolution <value>","Structured resolution evidence").option("--expected-result <value>","Expected result evidence").option("--actual-result <value>","Actual result evidence").option("--completed-at <value>","Actual completion time").option("--validate-close <mode>","Close validation: off, warn, or strict").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--dry-run","Validate and preview completion without writing").option("--force","Override lifecycle and ownership conflicts").option("--author <value>","Completion author").description("Close with evidence and release the claim.").action(runItemCompleteAction)}const structuredMutationTestOnly={runItemCompleteAction,runItemMutateAction,runItemReopenAction};export{registerStructuredMutationCommands,structuredMutationTestOnly};
 //# sourceMappingURL=register-structured-mutation.js.map

package/dist/cli/runtime/activation.d.ts

@@ -6,9 +6,9 @@ import { Command } from "commander";
 import { type ExtensionDiscoveryResult } from "../../sdk/runtime-primitives.js";
 /** Normalized command path, arguments and provided options used to select extension activation without importing extension code. */
 interface RuntimeExtensionActivationProbe {
-    commandPath?: string;
-    commandArgs?: string[];
-    allowCommandPrefixMatch?: boolean;
+commandPath?: string;
+commandArgs?: string[];
+allowCommandPrefixMatch?: boolean;
 }
 /** Collect positional words before the first option to probe the requested command path. */
 declare function collectLeadingCommandArgs(commandArgs: readonly string[] | undefined): string[];