@unbrained/pm-cli 2026.10.4 → 2026.10.6

package/dist/cli/main.js

@@ -1,6 +1,6 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a441a914-7d0e-5ed4-8bb9-8b94c540f0a1")}catch(e2){}})();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";const DEPRECATED_ALIAS_INVOCATION=Symbol("pm.deprecatedAliasInvocation");const COMMAND_ALIASES_BY_FIRST_TOKEN=new Map;for(const contract of PM_COMMAND_ALIAS_CONTRACTS){const firstToken=contract.alias.split(" ")[0];const 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,["../.."])}if(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;let activeTelemetryCommandContext=null;function setActiveExtensionHookContextForTest(context){activeExtensionHookContext=context}function setActiveRuntimeExtensionCommandDescriptorsForTest(descriptors){activeRuntimeExtensionCommandDescriptors=descriptors}let runtimeExtensionSnapshotCache=null;let runtimeExtensionDiscoverySnapshotCache=null;let activeRuntimeExtensionCommandDescriptors=new Map;const HANDLED_ERROR_SENTRY_FLUSH_TIMEOUT_MS=250;const EXPECTED_HANDLED_ERROR_EXIT_CODES=new Set([EXIT_CODE.USAGE,EXIT_CODE.NOT_FOUND,EXIT_CODE.CONFLICT]);const TRUE_LIKE_ENV_VALUES=new Set(["1","true","yes","on"]);const loadSetupRegistrationModule=createLazyModule(()=>import("./register-setup.js"));const loadListQueryRegistrationModule=createLazyModule(()=>import("./register-list-query.js"));const loadMutationRegistrationModule=createLazyModule(()=>import("./register-mutation.js"));const 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 void 0}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 void 0}const providedFields=extractProvidedOptionFlags(invocationArgv);const providedSet=new Set(providedFields.map(flag=>normalizeLongOptionFlag(flag)??flag));const rawInferred=inferMissingFieldsFromErrorMessage(rawMessage);const commandName=invocationArgv.find(token=>program.commands.some(candidate=>candidate.name()===token));const command=commandName?program.commands.find(candidate=>candidate.name()===commandName):void 0;const declaredFlags=new Set([...program.options,...command?.options??[]].flatMap(option=>option.flags.split(/[ ,|]+/).map(flag=>normalizeLongOptionFlag(flag)).filter(flag=>flag!==void 0)));const trulyMissing=rawInferred?.filter(flag=>{const normalized=normalizeLongOptionFlag(flag)??flag;if(providedSet.has(normalized)){return false}return 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];const normalizedMissing=missingFlag?normalizeLongOptionFlag(missingFlag):void 0;const commandName=invocationArgv.find(token=>program.commands.some(candidate=>candidate.name()===token));const command=commandName?program.commands.find(candidate=>candidate.name()===commandName):void 0;const missingOption=normalizedMissing?command?.options.find(option=>option.flags.split(/[ ,|]+/).includes(normalizedMissing)):void 0;const extensionFlagTakesValue=extensionFlagTakesValueForInvocation(invocationArgv,commandName,normalizedMissing,activeRuntimeExtensionCommandDescriptors);const missingTokens=normalizedMissing?missingOption?.isBoolean()===true||extensionFlagTakesValue===false?[normalizedMissing]:[normalizedMissing,"<value>"]:[];const 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"];const projected={};for(const field of optionalFields){const value=existingRecovery[field];if(value!==void 0&&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);const commandArgs=stripGlobalBootstrapTokens(safeInvocationArgv);const commandIndex=findBootstrapCommandTokenIndex(commandArgs);const[rootCommand,subcommand]=commandIndex===void 0?[]:commandArgs.slice(commandIndex,commandIndex+2);const explainRequested=safeInvocationArgv.includes("--explain");const rawExistingRecovery=repairProjectionRecovery(safeInvocationArgv,context?.code,context?.recovery);const 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);const providedFields=extractProvidedOptionFlags(safeInvocationArgv);const inferredMissing=inferMissingFieldsForRecovery(rawMessage,safeInvocationArgv,existingRecovery);const suggestedRetry=resolveRecoverySuggestedRetry(safeInvocationArgv,attemptedCommand,inferredMissing,existingRecovery);const 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;activeExtensionHookContext=null;if(!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){const message=error instanceof Error?error.message:String(error);hookWarnings=[`afterCommand hooks failed: ${message}`]}finally{clearActiveExtensionHooks()}if(!runtime.globalOptions.json&&hookWarnings.length>0){printError(`[pm] warning: afterCommand hook_warnings=${formatHookWarnings(hookWarnings)}`)}if(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){if(envFlagEnabled("PM_SENTRY_CAPTURE_EXPECTED_ERRORS")){return true}return!EXPECTED_HANDLED_ERROR_EXIT_CODES.has(Math.trunc(exitCode))}async function maybeLogHandledCliErrorToSentry(params){if(!shouldLogHandledErrorToSentry(params.exit_code)){return false}await ensureSentryForErrorReporting();sentryLogCliUsageError(params);return true}async function handleGenericRunPmCliError(params){const message=describeUnknownError(params.error);const classification=classifyUnknownError(message);if(params.bootstrapGlobal.json){printError(JSON.stringify(formatUnknownErrorForJson(message,EXIT_CODE.GENERIC_FAILURE),null,2))}else{printError(message)}process.exitCode=EXIT_CODE.GENERIC_FAILURE;let errorCategory="runtime";let 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(false,message,{error_code:classification.code,error_category:errorCategory,exit_code:EXIT_CODE.GENERIC_FAILURE,command_resolution:commandResolution,resolution_stage:"execute"})}catch(reportingError){if(!params.bootstrapGlobal.json){printError(`Failed to report error: ${describeUnknownError(reportingError)}`)}}try{await runAndClearAfterCommandHooks({ok:false,error:message,exit_code:EXIT_CODE.GENERIC_FAILURE,error_code:classification.code,error_category:errorCategory,command_resolution:commandResolution,resolution_stage:"execute"})}catch(hookError){if(!params.bootstrapGlobal.json){printError(`Failed to run error hooks: ${describeUnknownError(hookError)}`)}}try{await sentryFlush()}catch(flushError){if(!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"};const runtimeFieldLooseFlagDefinitionCache=new Map;function toLooseFieldDefinitionType(fieldType){if(fieldType==="number"){return"number"}if(fieldType==="boolean"){return"boolean"}return"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)){return}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}`;const cached=runtimeFieldLooseFlagDefinitionCache.get(cacheKey);if(cached){return cached}if(!await pathExists(getSettingsPath(pmRoot))){runtimeFieldLooseFlagDefinitionCache.set(cacheKey,[]);return[]}const settings=await readSettings(pmRoot);const fieldRegistry=resolveRuntimeFieldRegistry(settings.schema);const definitions=(fieldRegistry.command_to_fields.get(runtimeCommand)??[]).flatMap(field=>{const flagTokens=[field.cli_flag,...field.cli_aliases];return flagTokens.map(token=>({long:`--${token}`,type:toLooseFieldDefinitionType(field.type),value_type:toLooseFieldDefinitionType(field.type)}))});runtimeFieldLooseFlagDefinitionCache.set(cacheKey,definitions);return definitions}async function registerRuntimeSchemaFieldFlags(rootProgram,invocationArgv){const bootstrapGlobalOptions=parseBootstrapGlobalOptions(invocationArgv);const pmRoot=resolvePmRoot(process.cwd(),bootstrapGlobalOptions.path);if(!await pathExists(getSettingsPath(pmRoot))){return}const cachedDiscovery=runtimeExtensionDiscoverySnapshotCache?.key===buildRuntimeExtensionDiscoverySnapshotCacheKey(pmRoot)?runtimeExtensionDiscoverySnapshotCache.snapshot:null;const settings=cachedDiscovery===null?await readSettings(pmRoot):cachedDiscovery.settings;const fieldRegistry=resolveRuntimeFieldRegistry(settings.schema);const 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){continue}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"){return}try{const resolvedSettings=settings??await readSettings(pmRoot);const typeRegistry=resolveItemTypeRegistry(resolvedSettings,registrations);attachCreateUpdatePolicyHelpText(rootProgram,typeRegistry,invocationArgv)}catch{}}function defaultPreflightDecision(){return{enforce_item_format_gate:true,run_preflight_item_format_sync:true,run_extension_migrations:true,enforce_mandatory_migration_gate:true}}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){if(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){if(!globalOptions.profile){return}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}`);if(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();const{settings,warnings:settingsReadWarnings}=await readSettingsWithMetadataFn(pmRoot);const discovery=await discoverExtensions({pmRoot,settings,cwd:process.cwd(),noExtensions:false});const snapshot={pmRoot,settings,discovery,discoveryMs:Date.now()-startedAt,settingsReadWarnings:[...settingsReadWarnings]};runtimeExtensionDiscoverySnapshotCache={key:cacheKey,snapshot};return snapshot}catch{runtimeExtensionDiscoverySnapshotCache={key:cacheKey,snapshot:null};return null}}async function loadRuntimeExtensionSnapshot(pmRoot,probe,readSettingsFn=readSettings){const activationScope=probe?buildRuntimeExtensionActivationScope(probe):"all";const cacheKey=buildRuntimeExtensionSnapshotCacheKey(pmRoot,activationScope);if(runtimeExtensionSnapshotCache?.key===cacheKey){return runtimeExtensionSnapshotCache.snapshot}try{const settings=await readSettingsFn(pmRoot);const loadResult=await loadExtensions({pmRoot,settings,cwd:process.cwd(),noExtensions:false,extensionFilter:probe?buildRuntimeExtensionFilterForProbe(probe):void 0});const activationResult=await activateExtensions({...loadResult,loaded:loadResult.loaded});const commandHandlers=[...new Set(activationResult.commands.handlers.map(entry=>normalizeExtensionCommandPath(entry.command)))].filter(entry=>entry.length>0).sort((left,right)=>left.localeCompare(right));const commandFlagHelp=collectDynamicExtensionFlagHelpByCommand(activationResult.registrations.flags);const canonicalAliases=buildCanonicalExtensionAliases(activationResult.commands.handlers,activationResult.registrations.commands);const commandDescriptors=collectExtensionCommandHelpDescriptors(commandHandlers,activationResult.registrations.commands,activationResult.registrations.flags,canonicalAliases);const 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}))};runtimeExtensionSnapshotCache={key:cacheKey,snapshot};return snapshot}catch{runtimeExtensionSnapshotCache={key:cacheKey,snapshot:null};return null}}async function maybeLoadRuntimeExtensions(command){const globalOptions=getGlobalOptions(command);if(globalOptions.noExtensions){const noExtPmRoot=resolvePmRoot(process.cwd(),globalOptions.path);if(await pathExists(getSettingsPath(noExtPmRoot))){emitSettingsReadWarnings((await readSettingsWithMetadata(noExtPmRoot)).warnings)}return null}const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);const discoverySnapshot=await loadRuntimeExtensionDiscoverySnapshot(pmRoot);if(!discoverySnapshot){return null}emitSettingsReadWarnings(discoverySnapshot.settingsReadWarnings);const probe={commandPath:getCommandPath(command),commandArgs:collectParsedActivationCommandArgs(command)};if(!discoveryNeedsActivationForProbe(discoverySnapshot.discovery,probe)){emitExtensionSkippedProfile(globalOptions.profile,discoverySnapshot,probe);return null}const snapshot=await loadRuntimeExtensionSnapshot(pmRoot,probe);if(!snapshot){return null}emitExtensionProfile(globalOptions,snapshot);return{hooks:snapshot.hooks,commands:snapshot.commands,parsers:snapshot.parsers,preflight:snapshot.preflight,services:snapshot.services,renderers:snapshot.renderers,registrations:snapshot.registrations,pmRoot}}async function loadRuntimeExtensionCommandDescriptorsForRecovery(pmRoot){const snapshot=await loadRuntimeExtensionSnapshot(pmRoot);return snapshot?new Map(snapshot.commandDescriptors):activeRuntimeExtensionCommandDescriptors}async function executeRegisteredRuntimeMigrations(migrations,pmRoot){const result=await runExtensionMigrations({pmRoot,migrations,author:"pm-extension-migration"});return result.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);let commandOptions={...options};let resolvedGlobalOptions={...globalOptions};const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);const parserOverride=await runActiveParserOverride({command:commandPath,args:commandArgs,options:commandOptions,global:resolvedGlobalOptions,pm_root:pmRoot});if(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)}`)}if(!extensionCommandResult.handled){if(extensionCommandResult.warnings.length>0){const warningCode=extensionCommandResult.warnings[0];const cause=extensionCommandResult.errorMessage?.trim();const 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)}if(extensionCommandResult.exitCode!==void 0){process.exitCode=extensionCommandResult.exitCode}setActiveCommandResult(extensionCommandResult.result);return 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){if(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];if("_processArguments"in actionCommand&&typeof actionCommand._processArguments==="function"){actionCommand._processArguments()}if(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]!==true){const originalAction=actionEntry._actionHandler;actionEntry._actionHandler=async function wrappedActionHandler(...actionArgs){const actionCommand=resolveActionCommand(actionArgs,entry);const 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();const extensionFlagDefinitions=activeRegistrations?collectExtensionFlagDefinitionsForInvocation(activeRegistrations,commandPath,commandArgs):[];const 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)});maybePrintExtensionProfileWarnings(globalOptions.profile,"command_handler_warnings",extensionCommandResult.warnings);if(extensionCommandResult.handled){setActiveCommandResult(extensionCommandResult.result);printResult(extensionCommandResult.result,{...globalOptions,command:commandPath,commandArgs,commandOptions,pmRoot});if(globalOptions.profile){printError(`profile:command=${commandPath} took_ms=${Date.now()-startedAt}`)}return}return await originalAction.apply(this,actionArgs)};actionEntry[WRAPPED_ACTION_HANDLER]=true}for(const child of entry.commands){visit(child)}};visit(rootProgram)}async function clearDynamicExtensionCommandState(params){activeRuntimeExtensionCommandDescriptors=new Map;setActiveExtensionServices({overrides:[]});if(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);if(residualFlagHelp){command.addHelpText("after",residualFlagHelp)}}else if(flagHelp){command.addHelpText("after",flagHelp)}if(metadataHelp){command.addHelpText("after",metadataHelp)}}function applyDynamicExtensionRootHelpVisibility(rootProgram,preexistingTopLevelCommands,descriptors){const tierRank={core:0,standard:1,full:2,internal:3};const applyVisibility=(command,pathParts)=>{const commandPath=pathParts.join(" ");const matchingDescriptors=[...descriptors.entries()].filter(([path])=>path===commandPath||path.startsWith(`${commandPath} `)).map(([,descriptor])=>descriptor);const 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){if(!preexistingTopLevelCommands.has(command.name())){applyVisibility(command,[command.name()])}}}async function registerDynamicExtensionCommandPaths(rootProgram,invocationArgv){const bootstrapGlobalOptions=parseBootstrapGlobalOptions(invocationArgv);const pmRoot=resolvePmRoot(process.cwd(),bootstrapGlobalOptions.path);if(bootstrapGlobalOptions.noExtensions){await clearDynamicExtensionCommandState({rootProgram,pmRoot,invocationArgv});return}const discoverySnapshot=await loadRuntimeExtensionDiscoverySnapshot(pmRoot);const 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));const preexistingTopLevelCommands=new Set(rootProgram.commands.map(command=>command.name()));const registerCommandPath=commandPath=>{const pathParts=commandPath.split(" ").filter(part=>part.length>0);const descriptor=snapshot.commandDescriptors.get(commandPath);const existingCommand=findCommandByPath(rootProgram,pathParts);const flagHelp=snapshot.commandFlagHelp.get(commandPath);const metadataHelp=descriptor?buildDynamicExtensionCommandMetadataHelp(descriptor):null;if(existingCommand){attachDynamicExtensionHelp(existingCommand,descriptor,flagHelp,metadataHelp);return}const dynamicCommand=ensureCommandPath(rootProgram,pathParts);if(descriptor?.description){dynamicCommand.description(descriptor.description)}let residualDynamicFlagHelp=flagHelp;if(descriptor){applyDynamicExtensionArguments(dynamicCommand,descriptor);if(descriptor.flags.length>0){applyDynamicExtensionFlagOptions(dynamicCommand,descriptor.flags);residualDynamicFlagHelp=buildResidualDynamicExtensionFlagHelp(dynamicCommand,descriptor.flags)??void 0}}if(residualDynamicFlagHelp){dynamicCommand.addHelpText("after",residualDynamicFlagHelp)}if(metadataHelp){dynamicCommand.addHelpText("after",metadataHelp)}dynamicCommand.allowUnknownOption(true).allowExcessArguments(true).action(async(...actionArgs)=>{const maybeCommand=actionArgs[actionArgs.length-1];const command=maybeCommand instanceof Command?maybeCommand:dynamicCommand;const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const extensionFlagDefinitions=collectExtensionFlagDefinitionsForInvocation(snapshot.registrations,commandPath,command.args.map(String));const scopedOptions=extractCommandScopedOptions(command,command.args.map(String),extensionFlagDefinitions);const result=await runRequiredExtensionCommand(command,scopedOptions,globalOptions,extensionFlagDefinitions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,{...globalOptions,command:commandPath,commandArgs:command.args.map(String),commandOptions:scopedOptions,pmRoot});if(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);if(typeof alias==="string")await recordDeprecatedAliasUsage(alias)}async function runCommandPreparation(actionCommand,skipped,run){const commandPath=getCommandPath(actionCommand);if(["item mutate","item complete"].includes(commandPath)&&actionCommand.optsWithGlobals().dryRun===true)return skipped;return run()}function attachProgramLifecycleHooks(rootProgram,invocationArgv){if(invocationArgv&&isStaticExtensionInventoryInvocation(invocationArgv))return;rootProgram.hook("preAction",async(_thisCommand,actionCommand)=>{activeExtensionHookContext=null;activeTelemetryCommandContext=null;clearActiveExtensionHooks();clearResolvedGlobalOptions(actionCommand);const rawGlobalOptions=actionCommand.optsWithGlobals();const bootstrapGlobalOptions=getGlobalOptions(actionCommand);const commandPath=resolvePmCommandOperation(getCommandPath(actionCommand));let commandArgs=actionCommand.args.map(String);let commandOptions=extractCommandScopedOptions(actionCommand,commandArgs);let 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);const 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});if(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()});if(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)):[];if(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:Boolean(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});if(globalOptions.profile&&hookWarnings.length>0){printError(`profile:extensions hook_warnings=${formatHookWarnings(hookWarnings)}`)}if(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]=true;const registerOriginalCommand=rootProgram.command.bind(rootProgram);rootProgram.command=((nameAndArgs,...rest)=>{const commandName=nameAndArgs.split(/\s+/u)[0];if(rootProgram.commands.some(existing=>existing.name()===commandName||existing.aliases().includes(commandName))){return new Command(commandName)}return registerOriginalCommand(nameAndArgs,...rest)})}async function registerCoreCommandFamilies(rootProgram,selection){ensureIdempotentTopLevelCommandRegistration(rootProgram);if(selection.setup){const{registerSetupCommands}=await loadSetupRegistrationModule();registerSetupCommands(rootProgram)}if(selection.listQuery){const{registerListQueryCommands}=await loadListQueryRegistrationModule();const 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);const commandResolution=deriveTelemetryCommandResolution({ok:false,errorCode:event.errorCode,errorCategory});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});return{errorCategory,commandResolution}}}async function prepareExtensionServicesForRunPmCliError(params){if(params.bootstrapGlobal.noExtensions||isStaticExtensionInventoryInvocation(params.invocationArgv)){return}const bootstrapProbe=buildBootstrapActivationProbe(params.invocationArgv);const discoverySnapshot=await loadRuntimeExtensionDiscoverySnapshot(params.bootstrapPmRoot);if(discoverySnapshot&&discoveryNeedsActivationForProbe(discoverySnapshot.discovery,bootstrapProbe)){const bootstrapSnapshot=await loadRuntimeExtensionSnapshot(params.bootstrapPmRoot,bootstrapProbe);setRecoveredExtensionServices(bootstrapSnapshot);return}if(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(false,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:false,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(true,void 0,{exit_code:EXIT_CODE.SUCCESS,command_resolution:"success",resolution_stage:"parse"});await runAndClearAfterCommandHooks({ok:true,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 false}const errorMessage=describeUnknownError(context.error);const exitCode=context.error instanceof PmCliError?context.error.exitCode:normalizeThrownExitCode(numericExitCode);const rawContext=context.error instanceof PmCliError?context.error.context:void 0;const enrichedContext=buildPmCliRecoveryContext(rawContext,context.invocationArgv,errorMessage);const classification=classifyPmCliError(errorMessage,enrichedContext);const jsonErrorPayload=context.bootstrapGlobal.lean?projectLeanErrorEnvelope(formatPmCliErrorForJson(errorMessage,exitCode,enrichedContext)):formatPmCliErrorForJson(errorMessage,exitCode,enrichedContext);const renderedError=context.jsonErrors?JSON.stringify(context.bootstrapGlobal.tokenAccounting?attachOutputTokenAccounting(jsonErrorPayload,value=>`${JSON.stringify(value,null,2)}
-`):jsonErrorPayload,null,2):formatPmCliErrorForDisplay(errorMessage,enrichedContext);if(context.jsonErrors)writeStderr(`${renderedError}
-`);else 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"});const 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});await finishRunPmCliFailure({errorMessage,exitCode,classificationCode:classification.code,errorCategory,commandResolution,resolutionStage:"execute"});if(loggedHandledErrorToSentry){sentryCaptureCliError(wrapThrownErrorForSentry(context.error,errorMessage));await sentryFlush(HANDLED_ERROR_SENTRY_FLUSH_TIMEOUT_MS)}process.exitCode=exitCode;return true}async function handleUnknownHelpCommandError(context,code){const unknownToken=resolvePmCommandOperation(parseBootstrapHelpRequest(context.invocationArgv).commandPathTokens.join(" "))||resolveUnknownCommanderToken(context.invocationArgv);const unknownMessage=`unknown command '${unknownToken}'`;const pmRoot=resolvePmRoot(process.cwd(),context.bootstrapGlobal.path);const recoveryCommandDescriptors=await loadRuntimeExtensionCommandDescriptorsForRecovery(pmRoot);const recoveryProbe=buildBootstrapActivationProbe(context.invocationArgv);const failedExtensions=await loadExtensionRecoveryFailures(pmRoot,{},collectActivationCommandCandidates(recoveryProbe));const usageContext=await resolveCommanderUsageContext({message:unknownMessage},program,recoveryCommandDescriptors,{failedExtensions});const 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});const{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"});const 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"});const baseRenderedUsage=context.jsonErrors?await formatCommanderUsageJson({message:unknownMessage},program,recoveryCommandDescriptors,context.bootstrapGlobal.lean===true,{failedExtensions}):await formatCommanderUsageMessage({message:unknownMessage},program,recoveryCommandDescriptors,{failedExtensions});const renderedUsage=appendCommanderExtensionFailures(baseRenderedUsage,context.jsonErrors,failedExtensions);await finishRunPmCliFailure({errorMessage:unknownMessage,exitCode:EXIT_CODE.USAGE,classificationCode:classification.code,errorCategory,commandResolution,resolutionStage:"parse"});if(context.jsonErrors)writeStderr(`${renderedUsage}
-`);else printError(renderedUsage);if(loggedHandledErrorToSentry){await sentryFlush(HANDLED_ERROR_SENTRY_FLUSH_TIMEOUT_MS)}process.exitCode=EXIT_CODE.USAGE}async function handleRunPmCliHelpDisplayError(context,code,rawMessage){const isHelpDisplayCode=code==="commander.helpDisplayed"||code==="commander.help"||code==="commander.helpCommand";if(!isHelpDisplayCode&&!rawMessage.includes("(outputHelp)")){return false}const helpRequest=parseBootstrapHelpRequest(context.invocationArgv);if(helpRequest.requested&&!isKnownHelpCommandPath(program,helpRequest.commandPathTokens)){await handleUnknownHelpCommandError(context,code);return true}await finishRunPmCliSuccessParse();return true}async function handleRunPmCliCommanderUsageError(context,code){const usageContext=await resolveCommanderUsageContext(context.error,program,activeRuntimeExtensionCommandDescriptors);const 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});const{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"});const 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});const baseRenderedUsage=context.jsonErrors?await formatCommanderUsageJson(context.error,program,activeRuntimeExtensionCommandDescriptors,context.bootstrapGlobal.lean===true):await formatCommanderUsageMessage(context.error,program,activeRuntimeExtensionCommandDescriptors);const recoveryFailures=await loadUnknownCommandRecoveryFailures(classification.code,context.bootstrapPmRoot,{},collectActivationCommandCandidates(buildBootstrapActivationProbe(context.invocationArgv)));const renderedUsage=appendCommanderExtensionFailures(baseRenderedUsage,context.jsonErrors,recoveryFailures);await finishRunPmCliFailure({errorMessage:usageContext.message,exitCode:EXIT_CODE.USAGE,classificationCode:classification.code,errorCategory,commandResolution,resolutionStage:"parse"});if(context.jsonErrors)writeStderr(`${renderedUsage}
-`);else printError(renderedUsage);if(loggedHandledErrorToSentry){await sentryFlush(HANDLED_ERROR_SENTRY_FLUSH_TIMEOUT_MS)}process.exitCode=EXIT_CODE.USAGE}function shouldHandleRunPmCliCommanderError(error){if(typeof error!=="object"||error===null||!("code"in error)){return false}const code=error.code;if(typeof code==="string"&&(code==="commander.version"||code.startsWith("commander."))){return true}const rawMessage=String(error.message??"");return rawMessage.includes("(outputHelp)")}async function handleRunPmCliCommanderError(context){const code=context.error.code;const rawMessage=String(context.error.message??"");if(await handleRunPmCliHelpDisplayError(context,code,rawMessage)){return}if(code==="commander.version"){await finishRunPmCliSuccessParse();return}await handleRunPmCliCommanderUsageError(context,code)}async function handleRunPmCliError(params){const bootstrapGlobal=parseBootstrapGlobalOptions(params.invocationArgv);const bootstrapPmRoot=resolvePmRoot(process.cwd(),bootstrapGlobal.path);const context={error:params.error,invocationArgv:params.invocationArgv,bootstrapGlobal,jsonErrors:bootstrapGlobal.json,bootstrapPmRoot,attemptedCommand:parseBootstrapCommandName(params.invocationArgv)??"<unknown>",emitTelemetryCommandError:createTelemetryCommandErrorEmitter({invocationArgv:params.invocationArgv,bootstrapGlobal,bootstrapPmRoot})};await prepareExtensionServicesForRunPmCliError({invocationArgv:params.invocationArgv,bootstrapGlobal,bootstrapPmRoot});if(await handleRunPmCliKnownError(context,readThrownExitCode(params.error))){return}if(shouldHandleRunPmCliCommanderError(params.error)){await handleRunPmCliCommanderError(context);return}await handleGenericRunPmCliError({error:params.error,attemptedCommand:context.attemptedCommand,bootstrapGlobal,emitTelemetryCommandError:context.emitTelemetryCommandError})}function assertRequestedNamespaceAvailable(program2,invocationArgv,helpRequest){const tokens=helpRequest.requested?helpRequest.commandPathTokens:stripGlobalBootstrapTokens(invocationArgv);const requestedNamespace=findPmNamespacedCommand(tokens);if(requestedNamespace&&!findCommandByPath(program2,[...requestedNamespace.canonical_argv])){throw new CommanderError(EXIT_CODE.USAGE,"commander.unknownCommand",`unknown command '${requestedNamespace.alias}'`)}}function captureInvokedDeprecatedAlias(rootProgram,rawArgv){let commandIndex=findBootstrapCommandTokenIndex(rawArgv);if(commandIndex===void 0)return;if(["pm","pm-cli"].includes(rawArgv[commandIndex]?.trim().toLowerCase())){const offset=findBootstrapCommandTokenIndex(rawArgv.slice(commandIndex+1));if(offset===void 0)return;commandIndex+=offset+1}const candidates=COMMAND_ALIASES_BY_FIRST_TOKEN.get(rawArgv[commandIndex]);const tokens=rawArgv.slice(commandIndex).filter(token=>!["--global","--project","--local"].includes(token));const resolved=candidates?.find(contract=>contract.alias.split(" ").every((token,index)=>tokens[index]===token));if(resolved?.lifecycle==="deprecated")Reflect.set(rootProgram,DEPRECATED_ALIAS_INVOCATION,resolved.alias)}async function runPmCliInReproducibleContext(rawArgv,settingsPolicy){program=createPmCliProgram(CLI_VERSION);program.hook("preAction",(_thisCommand,actionCommand)=>{settingsPolicy.configurationOnly=["item mutate","item complete"].includes(getCommandPath(actionCommand))&&actionCommand.optsWithGlobals().dryRun===true});attachProgramLifecycleHooks(program,rawArgv);runtimeExtensionSnapshotCache=null;runtimeExtensionDiscoverySnapshotCache=null;activeRuntimeExtensionCommandDescriptors=new Map;resetActiveExtensionRuntimeState();let invocationArgv=[...rawArgv];let restorePmAuthor;let restorePagerPolicy;try{const bootstrapInvocation=normalizeBootstrapInvocation(rawArgv);invocationArgv=bootstrapInvocation.argv;captureInvokedDeprecatedAlias(program,rawArgv);const invocationProcessArgv=[process.argv[0],process.argv[1],...invocationArgv];const isBareInvocation=invocationArgv.length===0;const bootstrapGlobal=parseBootstrapGlobalOptions(invocationArgv);if(bootstrapGlobal.authorMissingValue){throw new PmCliError("--author requires a non-empty value.",EXIT_CODE.USAGE,{code:"missing_required_argument",nextSteps:["Pass an explicit author identifier with --author <id>."]})}restorePmAuthor=applyInvocationAuthorOverride(bootstrapGlobal.author);enforceExplicitRetryForFlagTypos(bootstrapInvocation);restorePagerPolicy=applyBootstrapPagerPolicy(invocationArgv);const registrationSelection=resolveCoreCommandRegistrationSelection(invocationArgv);await registerCoreCommandFamilies(program,registrationSelection);installCommandNamespaces(program,true);const registerDynamicCommands=shouldRegisterDynamicExtensionPaths(program,invocationArgv);if(registerDynamicCommands){await registerDynamicExtensionCommandPaths(program,invocationArgv)}else{activeRuntimeExtensionCommandDescriptors=new Map;setActiveExtensionServices({overrides:[]})}if(shouldRegisterRuntimeSchemaFlags(invocationArgv)){await registerRuntimeSchemaFieldFlags(program,invocationArgv)}installCommandNamespaces(program);const helpRequest=parseBootstrapHelpRequest(invocationArgv);assertRequestedNamespaceAvailable(program,invocationArgv,helpRequest);if(shouldAttachRichHelpTextForInvocation(invocationArgv)){attachRichHelpText(program,invocationArgv)}wrapProgramActionsForExtensionHandlers(program);const renderedBootstrapJsonHelp=await maybeRenderBootstrapJsonHelp(program,invocationArgv,activeRuntimeExtensionCommandDescriptors,rawArgv);if(renderedBootstrapJsonHelp){return}if(helpRequest.requested&&!isKnownHelpCommandPath(program,helpRequest.commandPathTokens)){throw new CommanderError(EXIT_CODE.USAGE,"commander.helpDisplayed","(outputHelp)")}if(isBareInvocation||isFullHelpDiscovery(invocationArgv)&&parseBootstrapCommandName(invocationArgv)===void 0){program.outputHelp();return}if(isStaticExtensionInventoryInvocation(invocationArgv)){await program.parseAsync(invocationProcessArgv);return}const invocationPmRoot=resolvePmRoot(process.cwd(),bootstrapGlobal.path);const invocationSettings=await readSettings(invocationPmRoot);const intentSnapshot=await loadContextIntentSnapshotForInvocation(invocationArgv,invocationPmRoot,bootstrapGlobal.noExtensions,loadRuntimeExtensionSnapshot);await runWithDiscoveredContextIntentContracts({pmRoot:invocationPmRoot,packages:intentSnapshot?.contextIntentPackages},()=>runWithHarnessDetectionSignals({env:{...process.env,PM_PATH:invocationPmRoot},argv:invocationProcessArgv,cwd:process.cwd()},()=>runWithWorkspaceHarnessSignalDescriptors(invocationSettings.agent_identity.harness_signals,()=>program.parseAsync(invocationProcessArgv),{probesEnabled:invocationSettings.agent_identity?.probes_enabled})))}catch(error){await handleRunPmCliError({error,invocationArgv})}finally{restorePagerPolicy?.();restorePmAuthor?.()}}async function runPmCli(rawArgv=process.argv.slice(2)){let invocationArgv=rawArgv;try{invocationArgv=normalizeBootstrapInvocation(rawArgv).argv}catch{}const preview=resolveStructuredMutationPreviewInvocation(invocationArgv);const settingsPolicy={configurationOnly:preview!==void 0};const isConfigurationOnly=()=>settingsPolicy.configurationOnly;const runInvocation=async()=>{try{await runWithReproducibleProcessEnvironment(process.env,()=>runPmCliInReproducibleContext(rawArgv,settingsPolicy))}catch(error){await handleRunPmCliError({error,invocationArgv:[...rawArgv]})}};if(preview!==void 0){const bootstrapRoot=resolvePmRoot(process.cwd(),parseBootstrapGlobalOptions(invocationArgv).path);const actionRoot=resolvePmRoot(process.cwd(),preview.path);const globalRoot=resolveGlobalPmRoot(process.cwd());await runWithConfigurationOnlySettings(bootstrapRoot,()=>runWithConfigurationOnlySettings(actionRoot,()=>runWithConfigurationOnlySettings(globalRoot,runInvocation,isConfigurationOnly),isConfigurationOnly),isConfigurationOnly)}else{await runInvocation()}}const _testOnly={activationCommandMatchesProbe,applyDynamicExtensionRootHelpVisibility,bootstrapProfileEnabled,buildBootstrapActivationProbe,buildPostActionTelemetryOutcome,buildPmCliRecoveryContext,buildRuntimeExtensionDiscoverySnapshotCacheKey,buildRuntimeExtensionActivationScope,buildRuntimeExtensionSnapshotCacheKey,buildRuntimeExtensionFilterForProbe,addRuntimeFieldOption,collectActivationCommandCandidates,collectExtensionFlagDefinitionsForCommand,collectExtensionFlagDefinitionsForInvocation,collectLeadingCommandArgs,collectParsedActivationCommandArgs,collectRuntimeFieldLooseFlagDefinitionsForCommand,commandHasLongOption,commandHasShortOption,commandPathNeedsSearchExtensions,commandPathNeedsTemplateExtensions,describeUnknownError,defaultPreflightDecision,discoveryNeedsActivationForProbe,emitExtensionProfile,emitExtensionSkippedProfile,emitSettingsReadWarnings,ensureIdempotentTopLevelCommandRegistration,enforceExplicitRetryForFlagTypos,envFlagEnabled,executeRegisteredRuntimeMigrations,extractCommandScopedOptions,extensionActivationCommands,extensionCapabilities,extensionNeedsActivationForProbe,extensionProvidesTemplatesRuntime,hasAnyCapability,hasGlobalExtensionContributions,handleGenericRunPmCliError,handleRunPmCliCommanderError,handleRunPmCliError,handleRunPmCliHelpDisplayError,handleRunPmCliKnownError,handleRunPmCliCommanderUsageError,handleUnknownHelpCommandError,inferMissingFieldsFromErrorMessage,inferPostActionErrorCode,inferPostActionFailureMessage,invocationRequestsVersion,isCommanderError,loadRuntimeExtensionCommandDescriptorsForRecovery,loadRuntimeExtensionDiscoverySnapshot,loadRuntimeExtensionSnapshot,maybeLoadRuntimeExtensions,maybeAttachCreateUpdatePolicyHelpText,maybeLogHandledCliErrorToSentry,matchesStaticExtensionCommand,normalizeTelemetryCommandResolution,normalizeTelemetryErrorCategory,normalizeTelemetryResolutionStage,normalizeThrownExitCode,probeUsesAnyFlag,prepareExtensionServicesForRunPmCliError,readRecordBoolean,readRecordNumber,readRecordString,recordCliReadOutputInvocationProvenance,registerDynamicExtensionCommandPaths,registerRuntimeSchemaFieldFlags,resolveCoreCommandRegistrationSelection,resolveStaticExtensionActivationDecision,resolveUnknownHelpToken:resolveUnknownCommanderToken,readThrownExitCode,runAndClearAfterCommandHooks,runRequiredExtensionCommand,shouldAttachRichHelpTextForInvocation,shouldLogHandledErrorToSentry,shouldRegisterDynamicExtensionPaths,shouldRegisterRuntimeSchemaFlags,shouldHandleRunPmCliCommanderError,setActiveExtensionHookContextForTest,setActiveRuntimeExtensionCommandDescriptorsForTest,setRecoveredExtensionServices,toLooseFieldDefinitionType,isImporterOrExporterCommandPath,validateDynamicExtensionCommandInvocation,wrapProgramActionsForExtensionHandlers,wrapThrownErrorForSentry};export{_testOnly,runPmCli};
+(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]="2309d6a4-a061-51d8-be5e-5e1dd62e9b3e")}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 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)}
+`):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 unknownToken=resolvePmCommandOperation(parseBootstrapHelpRequest(context.invocationArgv).commandPathTokens.join(" "))||resolveUnknownCommanderToken(context.invocationArgv),unknownMessage=`unknown command '${unknownToken}'`,pmRoot=resolvePmRoot(process.cwd(),context.bootstrapGlobal.path),recoveryCommandDescriptors=await loadRuntimeExtensionCommandDescriptorsForRecovery(pmRoot),recoveryProbe=buildBootstrapActivationProbe(context.invocationArgv),failedExtensions=await loadExtensionRecoveryFailures(pmRoot,{},collectActivationCommandCandidates(recoveryProbe)),usageContext=await resolveCommanderUsageContext({message:unknownMessage},program,recoveryCommandDescriptors,{failedExtensions}),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}):await formatCommanderUsageMessage({message:unknownMessage},program,recoveryCommandDescriptors,{failedExtensions}),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),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):await formatCommanderUsageMessage(context.error,program,activeRuntimeExtensionCommandDescriptors),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}
+`):printError(renderedUsage),loggedHandledErrorToSentry&&await sentryFlush(HANDLED_ERROR_SENTRY_FLUSH_TIMEOUT_MS),process.exitCode=EXIT_CODE.USAGE}function shouldHandleRunPmCliCommanderError(error){if(typeof error!="object"||error===null||!("code"in error))return!1;const code=error.code;return typeof code=="string"&&(code==="commander.version"||code.startsWith("commander."))?!0:String(error.message??"").includes("(outputHelp)")}async function handleRunPmCliCommanderError(context){const code=context.error.code,rawMessage=String(context.error.message??"");if(!await handleRunPmCliHelpDisplayError(context,code,rawMessage)){if(code==="commander.version"){await finishRunPmCliSuccessParse();return}await handleRunPmCliCommanderUsageError(context,code)}}async function handleRunPmCliError(params){const bootstrapGlobal=parseBootstrapGlobalOptions(params.invocationArgv),bootstrapPmRoot=resolvePmRoot(process.cwd(),bootstrapGlobal.path),context={error:params.error,invocationArgv:params.invocationArgv,bootstrapGlobal,jsonErrors:bootstrapGlobal.json,bootstrapPmRoot,attemptedCommand:parseBootstrapCommandName(params.invocationArgv)??"<unknown>",emitTelemetryCommandError:createTelemetryCommandErrorEmitter({invocationArgv:params.invocationArgv,bootstrapGlobal,bootstrapPmRoot})};if(await prepareExtensionServicesForRunPmCliError({invocationArgv:params.invocationArgv,bootstrapGlobal,bootstrapPmRoot}),!await handleRunPmCliKnownError(context,readThrownExitCode(params.error))){if(shouldHandleRunPmCliCommanderError(params.error)){await handleRunPmCliCommanderError(context);return}await handleGenericRunPmCliError({error:params.error,attemptedCommand:context.attemptedCommand,bootstrapGlobal,emitTelemetryCommandError:context.emitTelemetryCommandError})}}function assertRequestedNamespaceAvailable(program2,invocationArgv,helpRequest){const tokens=helpRequest.requested?helpRequest.commandPathTokens:stripGlobalBootstrapTokens(invocationArgv),requestedNamespace=findPmNamespacedCommand(tokens);if(requestedNamespace&&!findCommandByPath(program2,[...requestedNamespace.canonical_argv]))throw new CommanderError(EXIT_CODE.USAGE,"commander.unknownCommand",`unknown command '${requestedNamespace.alias}'`)}function captureInvokedDeprecatedAlias(rootProgram,rawArgv){let commandIndex=findBootstrapCommandTokenIndex(rawArgv);if(commandIndex===void 0)return;if(["pm","pm-cli"].includes(rawArgv[commandIndex]?.trim().toLowerCase())){const offset=findBootstrapCommandTokenIndex(rawArgv.slice(commandIndex+1));if(offset===void 0)return;commandIndex+=offset+1}const candidates=COMMAND_ALIASES_BY_FIRST_TOKEN.get(rawArgv[commandIndex]),tokens=rawArgv.slice(commandIndex).filter(token=>!["--global","--project","--local"].includes(token)),resolved=candidates?.find(contract=>contract.alias.split(" ").every((token,index)=>tokens[index]===token));resolved?.lifecycle==="deprecated"&&Reflect.set(rootProgram,DEPRECATED_ALIAS_INVOCATION,resolved.alias)}async function runPmCliInReproducibleContext(rawArgv,settingsPolicy){program=createPmCliProgram(CLI_VERSION),program.hook("preAction",(_thisCommand,actionCommand)=>{settingsPolicy.configurationOnly=["item mutate","item complete"].includes(getCommandPath(actionCommand))&&actionCommand.optsWithGlobals().dryRun===!0}),attachProgramLifecycleHooks(program,rawArgv),runtimeExtensionSnapshotCache=null,runtimeExtensionDiscoverySnapshotCache=null,activeRuntimeExtensionCommandDescriptors=new Map,resetActiveExtensionRuntimeState();let invocationArgv=[...rawArgv],restorePmAuthor,restorePagerPolicy;try{const bootstrapInvocation=normalizeBootstrapInvocation(rawArgv);invocationArgv=bootstrapInvocation.argv,captureInvokedDeprecatedAlias(program,rawArgv);const invocationProcessArgv=[process.argv[0],process.argv[1],...invocationArgv],isBareInvocation=invocationArgv.length===0,bootstrapGlobal=parseBootstrapGlobalOptions(invocationArgv);if(bootstrapGlobal.authorMissingValue)throw new PmCliError("--author requires a non-empty value.",EXIT_CODE.USAGE,{code:"missing_required_argument",nextSteps:["Pass an explicit author identifier with --author <id>."]});restorePmAuthor=applyInvocationAuthorOverride(bootstrapGlobal.author),enforceExplicitRetryForFlagTypos(bootstrapInvocation),restorePagerPolicy=applyBootstrapPagerPolicy(invocationArgv);const registrationSelection=resolveCoreCommandRegistrationSelection(invocationArgv);await registerCoreCommandFamilies(program,registrationSelection),installCommandNamespaces(program,!0),shouldRegisterDynamicExtensionPaths(program,invocationArgv)?await registerDynamicExtensionCommandPaths(program,invocationArgv):(activeRuntimeExtensionCommandDescriptors=new Map,setActiveExtensionServices({overrides:[]})),shouldRegisterRuntimeSchemaFlags(invocationArgv)&&await registerRuntimeSchemaFieldFlags(program,invocationArgv),installCommandNamespaces(program);const helpRequest=parseBootstrapHelpRequest(invocationArgv);if(assertRequestedNamespaceAvailable(program,invocationArgv,helpRequest),shouldAttachRichHelpTextForInvocation(invocationArgv)&&attachRichHelpText(program,invocationArgv),wrapProgramActionsForExtensionHandlers(program),await maybeRenderBootstrapJsonHelp(program,invocationArgv,activeRuntimeExtensionCommandDescriptors,rawArgv))return;if(helpRequest.requested&&!isKnownHelpCommandPath(program,helpRequest.commandPathTokens))throw new CommanderError(EXIT_CODE.USAGE,"commander.helpDisplayed","(outputHelp)");if(isBareInvocation||isFullHelpDiscovery(invocationArgv)&&parseBootstrapCommandName(invocationArgv)===void 0){program.outputHelp();return}if(isStaticExtensionInventoryInvocation(invocationArgv)){await program.parseAsync(invocationProcessArgv);return}const invocationPmRoot=resolvePmRoot(process.cwd(),bootstrapGlobal.path),invocationSettings=await readSettings(invocationPmRoot),intentSnapshot=await loadContextIntentSnapshotForInvocation(invocationArgv,invocationPmRoot,bootstrapGlobal.noExtensions,loadRuntimeExtensionSnapshot);await runWithDiscoveredContextIntentContracts({pmRoot:invocationPmRoot,packages:intentSnapshot?.contextIntentPackages},()=>runWithHarnessDetectionSignals({env:{...process.env,PM_PATH:invocationPmRoot},argv:invocationProcessArgv,cwd:process.cwd()},()=>runWithWorkspaceHarnessSignalDescriptors(invocationSettings.agent_identity.harness_signals,()=>program.parseAsync(invocationProcessArgv),{probesEnabled:invocationSettings.agent_identity?.probes_enabled})))}catch(error){await handleRunPmCliError({error,invocationArgv})}finally{restorePagerPolicy?.(),restorePmAuthor?.()}}async function runPmCli(rawArgv=process.argv.slice(2)){let invocationArgv=rawArgv;try{invocationArgv=normalizeBootstrapInvocation(rawArgv).argv}catch{}const preview=resolveStructuredMutationPreviewInvocation(invocationArgv),settingsPolicy={configurationOnly:preview!==void 0},isConfigurationOnly=()=>settingsPolicy.configurationOnly,runInvocation=async()=>{try{await runWithReproducibleProcessEnvironment(process.env,()=>runPmCliInReproducibleContext(rawArgv,settingsPolicy))}catch(error){await handleRunPmCliError({error,invocationArgv:[...rawArgv]})}};if(preview!==void 0){const bootstrapRoot=resolvePmRoot(process.cwd(),parseBootstrapGlobalOptions(invocationArgv).path),actionRoot=resolvePmRoot(process.cwd(),preview.path),globalRoot=resolveGlobalPmRoot(process.cwd());await runWithConfigurationOnlySettings(bootstrapRoot,()=>runWithConfigurationOnlySettings(actionRoot,()=>runWithConfigurationOnlySettings(globalRoot,runInvocation,isConfigurationOnly),isConfigurationOnly),isConfigurationOnly)}else await runInvocation()}const _testOnly={activationCommandMatchesProbe,applyDynamicExtensionRootHelpVisibility,bootstrapProfileEnabled,buildBootstrapActivationProbe,buildPostActionTelemetryOutcome,buildPmCliRecoveryContext,buildRuntimeExtensionDiscoverySnapshotCacheKey,buildRuntimeExtensionActivationScope,buildRuntimeExtensionSnapshotCacheKey,buildRuntimeExtensionFilterForProbe,addRuntimeFieldOption,collectActivationCommandCandidates,collectExtensionFlagDefinitionsForCommand,collectExtensionFlagDefinitionsForInvocation,collectLeadingCommandArgs,collectParsedActivationCommandArgs,collectRuntimeFieldLooseFlagDefinitionsForCommand,commandHasLongOption,commandHasShortOption,commandPathNeedsSearchExtensions,commandPathNeedsTemplateExtensions,describeUnknownError,defaultPreflightDecision,discoveryNeedsActivationForProbe,emitExtensionProfile,emitExtensionSkippedProfile,emitSettingsReadWarnings,ensureIdempotentTopLevelCommandRegistration,enforceExplicitRetryForFlagTypos,envFlagEnabled,executeRegisteredRuntimeMigrations,extractCommandScopedOptions,extensionActivationCommands,extensionCapabilities,extensionNeedsActivationForProbe,extensionProvidesTemplatesRuntime,hasAnyCapability,hasGlobalExtensionContributions,handleGenericRunPmCliError,handleRunPmCliCommanderError,handleRunPmCliError,handleRunPmCliHelpDisplayError,handleRunPmCliKnownError,handleRunPmCliCommanderUsageError,handleUnknownHelpCommandError,inferMissingFieldsFromErrorMessage,inferPostActionErrorCode,inferPostActionFailureMessage,invocationRequestsVersion,isCommanderError,loadRuntimeExtensionCommandDescriptorsForRecovery,loadRuntimeExtensionDiscoverySnapshot,loadRuntimeExtensionSnapshot,maybeLoadRuntimeExtensions,maybeAttachCreateUpdatePolicyHelpText,maybeLogHandledCliErrorToSentry,matchesStaticExtensionCommand,normalizeTelemetryCommandResolution,normalizeTelemetryErrorCategory,normalizeTelemetryResolutionStage,normalizeThrownExitCode,probeUsesAnyFlag,prepareExtensionServicesForRunPmCliError,readRecordBoolean,readRecordNumber,readRecordString,recordCliReadOutputInvocationProvenance,registerDynamicExtensionCommandPaths,registerRuntimeSchemaFieldFlags,resolveCoreCommandRegistrationSelection,resolveStaticExtensionActivationDecision,resolveUnknownHelpToken:resolveUnknownCommanderToken,readThrownExitCode,runAndClearAfterCommandHooks,runRequiredExtensionCommand,shouldAttachRichHelpTextForInvocation,shouldLogHandledErrorToSentry,shouldRegisterDynamicExtensionPaths,shouldRegisterRuntimeSchemaFlags,shouldHandleRunPmCliCommanderError,setActiveExtensionHookContextForTest,setActiveRuntimeExtensionCommandDescriptorsForTest,setRecoveredExtensionServices,toLooseFieldDefinitionType,isImporterOrExporterCommandPath,validateDynamicExtensionCommandInvocation,wrapProgramActionsForExtensionHandlers,wrapThrownErrorForSentry};export{_testOnly,runPmCli};
 //# sourceMappingURL=main.js.map

package/dist/cli/migration-gates.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="840b471e-c996-57e2-b97c-3a84bd68f050")}catch(e2){}})();import{pathExists,getActiveExtensionRegistrations,resolveItemTypeRegistry,migrateItemFilesToFormat,getSettingsPath,persistSelectedItemFormat,readSettingsWithMetadata,writeSettings,EXIT_CODE,PmCliError,toNonEmptyStringOrUndefined,printError,evaluateMutationGuard,isMutationAction,resolveAuthor,locateItem,readLocatedItem}from"../sdk/runtime-primitives.js";function resolveMigrationId(definition,fallbackIndex){const explicit=toNonEmptyStringOrUndefined(definition.id);if(explicit){return explicit}return`migration-${String(fallbackIndex+1).padStart(3,"0")}`}function resolveNormalizedMigrationStatus(definition){const normalized=toNonEmptyStringOrUndefined(definition.status)?.toLowerCase();return normalized??"pending"}function isMandatoryMigrationDefinition(definition){return definition.mandatory===true}function compareMandatoryMigrationBlockers(left,right){const byLayer=left.layer.localeCompare(right.layer);if(byLayer!==0){return byLayer}const byName=left.name.localeCompare(right.name);if(byName!==0){return byName}return left.id.localeCompare(right.id)}function collectMandatoryMigrationBlockers(migrations){const blockers=[];migrations.forEach((entry,index)=>{if(!isMandatoryMigrationDefinition(entry.definition)){return}const status=resolveNormalizedMigrationStatus(entry.definition);if(status==="applied"){return}blockers.push({layer:entry.layer,name:entry.name,id:resolveMigrationId(entry.definition,index),status})});blockers.sort(compareMandatoryMigrationBlockers);return blockers}function hasMutatingListValues(value){return Array.isArray(value)&&value.length>0}const ALWAYS_MUTATING_COMMANDS=new Set(["create","beads import","todos import"]);const FORCEABLE_MUTATING_COMMANDS=new Set(["restore","update","close","delete","append","claim","release"]);const TEXT_APPEND_COMMANDS=new Set(["comments","notes","learnings"]);const LIST_MUTATION_COMMANDS=new Set(["files","docs","test"]);const POSITIONAL_MUTATION_VERBS=new Set(["activate","add","add-field","add-status","add-type","apply","compact","create","deactivate","delete","disable","edit","enable","import","infer","install","materialize","migrate","redact","remove","remove-field","remove-status","remove-type","remap-status","rename-field","rename-type","repair","run","save","set","unset","update","upgrade"]);function decideWriteGate(commandPath,options){const forceRequested=options.force===true;if(ALWAYS_MUTATING_COMMANDS.has(commandPath)){return{isMutation:true,forceCapable:false,forceRequested:false}}if(FORCEABLE_MUTATING_COMMANDS.has(commandPath)){return{isMutation:true,forceCapable:true,forceRequested}}if(TEXT_APPEND_COMMANDS.has(commandPath)){return{isMutation:typeof options.add==="string",forceCapable:true,forceRequested}}if(LIST_MUTATION_COMMANDS.has(commandPath)){return{isMutation:hasMutatingListValues(options.add)||hasMutatingListValues(options.remove),forceCapable:true,forceRequested}}return{isMutation:false,forceCapable:false,forceRequested:false}}function isMutationInvocation(commandPath,commandArgs,options){if(decideWriteGate(commandPath,options).isMutation){return true}const normalizedCommand=commandPath.trim().toLowerCase();if(!isMutationAction(normalizedCommand)){return false}if(["close-many","close-task","copy","delete","discover","focus","pause-task","start-task","update-many"].includes(normalizedCommand)){return true}return commandArgs.some(argument=>POSITIONAL_MUTATION_VERBS.has(argument.trim().toLowerCase()))}function normalizedLifecycleStatus(value){return(value??"in_progress").trim().toLowerCase().replaceAll("-","_")}function enforceSchemaMigrationInput(commandPath,commandArgs,options){const subcommand=commandArgs[0]?.trim().toLowerCase()??"";if(commandPath.trim().toLowerCase()!=="schema"||!["rename-type","rename-field","remap-status"].includes(subcommand)){return}const missing=[];if(!toNonEmptyStringOrUndefined(commandArgs[1]))missing.push("source");if(!toNonEmptyStringOrUndefined(options.to))missing.push("--to");if(missing.length===0){return}throw new PmCliError(`Schema migration requires ${missing.join(", ")}.`,EXIT_CODE.USAGE,{code:"schema_migration_input_required",required:missing.join(","),why:"Schema migrations require a source and target. A workspace-bound stable migration id is derived automatically when --migration-id is omitted.",recovery:{recovery_mode:"compact",missing_required_fields:missing,suggested_flags:missing.filter(entry=>entry.startsWith("--")),suggested_retry:`pm schema ${subcommand} <source> --to <target>`}})}async function warnForUnclaimedInProgressUpdate(commandPath,commandArgs,options,pmRoot,settings){if(commandPath.trim().toLowerCase()!=="update"||typeof options.status!=="string"||normalizedLifecycleStatus(options.status)!==normalizedLifecycleStatus(settings.schema.workflow.in_progress_status)){return}const rawId=commandArgs[0];if(!rawId){return}const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const located=await locateItem(pmRoot,rawId,settings.id_prefix,settings.item_format,typeRegistry.type_to_folder);if(!located){return}const current=await readLocatedItem(located,{schema:settings.schema});const requestedAssignee=typeof options.assignee==="string"?options.assignee.trim():void 0;const prospectiveAssignee=requestedAssignee===void 0?current.document.metadata.assignee?.trim():["","none","null","undefined"].includes(requestedAssignee.toLowerCase())?void 0:requestedAssignee;if(prospectiveAssignee){return}printError(`warning:in_progress_item_unclaimed:${located.id}:claim_with=pm claim ${located.id}`)}async function enforceMutationGuardPreflight(commandPath,commandArgs,options,global2,pmRoot){if(!isMutationInvocation(commandPath,commandArgs,options)){return}enforceSchemaMigrationInput(commandPath,commandArgs,options);if(!await pathExists(getSettingsPath(pmRoot))){return}const settings=await readSettingsWithMetadata(pmRoot);if(global2.json!==true){await warnForUnclaimedInProgressUpdate(commandPath,commandArgs,options,pmRoot,settings.settings)}const result=evaluateMutationGuard({author:resolveAuthor(global2.author,settings.settings.author_default),payload:{command:commandPath,args:commandArgs,options},settings:settings.settings.mutation_guard,force:global2.force===true||options.force===true});for(const warning of result.warnings){printError(`warning:${warning}`)}}function enforceMandatoryMigrationWriteGate(commandPath,options,blockers){if(blockers.length===0){return}const decision=decideWriteGate(commandPath,options);if(!decision.isMutation){return}if(decision.forceCapable&&decision.forceRequested){return}const codes=blockers.map(entry=>`extension_migration_blocking:${entry.layer}:${entry.name}:${entry.id}:${entry.status}`);const forceGuidance=decision.forceCapable?"Re-run this command with --force to bypass.":"This command path does not support --force bypass.";throw new PmCliError(`Write command "${commandPath}" blocked by unresolved mandatory extension migrations (${codes.join(",")}). ${forceGuidance}`,EXIT_CODE.CONFLICT)}async function enforceItemFormatWriteGateAndPreflightMigration(commandPath,options,pmRoot,decision){const writeGate=decideWriteGate(commandPath,options);if(!writeGate.isMutation){return}if(!decision.enforce_item_format_gate&&!decision.run_preflight_item_format_sync){return}if(!await pathExists(getSettingsPath(pmRoot))){return}const{settings,metadata,warnings}=await readSettingsWithMetadata(pmRoot);for(const warning of warnings){printError(`warning:${warning}`)}if(decision.enforce_item_format_gate&&!metadata.has_explicit_item_format){persistSelectedItemFormat(settings);await writeSettings(pmRoot,settings,"item_format:auto_select_default")}if(decision.run_preflight_item_format_sync){const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());await migrateItemFilesToFormat(pmRoot,settings.item_format,"item_format:pre_mutation_sync",typeRegistry.type_to_folder,settings.schema)}}export{collectMandatoryMigrationBlockers,decideWriteGate,enforceItemFormatWriteGateAndPreflightMigration,enforceMandatoryMigrationWriteGate,enforceMutationGuardPreflight,enforceSchemaMigrationInput,normalizedLifecycleStatus,resolveMigrationId,resolveNormalizedMigrationStatus};
+(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]="714821f9-dd8f-5958-a751-29e8dfc06471")}catch{}})();import{pathExists,getActiveExtensionRegistrations,resolveItemTypeRegistry,migrateItemFilesToFormat,getSettingsPath,persistSelectedItemFormat,readSettingsWithMetadata,writeSettings,EXIT_CODE,PmCliError,toNonEmptyStringOrUndefined,printError,evaluateMutationGuard,isMutationAction,resolveAuthor,locateItem,readLocatedItem}from"../sdk/runtime-primitives.js";function resolveMigrationId(definition,fallbackIndex){return toNonEmptyStringOrUndefined(definition.id)||`migration-${String(fallbackIndex+1).padStart(3,"0")}`}function resolveNormalizedMigrationStatus(definition){return toNonEmptyStringOrUndefined(definition.status)?.toLowerCase()??"pending"}function isMandatoryMigrationDefinition(definition){return definition.mandatory===!0}function compareMandatoryMigrationBlockers(left,right){const byLayer=left.layer.localeCompare(right.layer);if(byLayer!==0)return byLayer;const byName=left.name.localeCompare(right.name);return byName!==0?byName:left.id.localeCompare(right.id)}function collectMandatoryMigrationBlockers(migrations){const blockers=[];return migrations.forEach((entry,index)=>{if(!isMandatoryMigrationDefinition(entry.definition))return;const status=resolveNormalizedMigrationStatus(entry.definition);status!=="applied"&&blockers.push({layer:entry.layer,name:entry.name,id:resolveMigrationId(entry.definition,index),status})}),blockers.sort(compareMandatoryMigrationBlockers),blockers}function hasMutatingListValues(value){return Array.isArray(value)&&value.length>0}const ALWAYS_MUTATING_COMMANDS=new Set(["create","beads import","todos import"]),FORCEABLE_MUTATING_COMMANDS=new Set(["restore","update","close","delete","append","claim","release"]),TEXT_APPEND_COMMANDS=new Set(["comments","notes","learnings"]),LIST_MUTATION_COMMANDS=new Set(["files","docs","test"]),POSITIONAL_MUTATION_VERBS=new Set(["activate","add","add-field","add-status","add-type","apply","compact","create","deactivate","delete","disable","edit","enable","import","infer","install","materialize","migrate","redact","remove","remove-field","remove-status","remove-type","remap-status","rename-field","rename-type","repair","run","save","set","unset","update","upgrade"]);function decideWriteGate(commandPath,options){const forceRequested=options.force===!0;return ALWAYS_MUTATING_COMMANDS.has(commandPath)?{isMutation:!0,forceCapable:!1,forceRequested:!1}:FORCEABLE_MUTATING_COMMANDS.has(commandPath)?{isMutation:!0,forceCapable:!0,forceRequested}:TEXT_APPEND_COMMANDS.has(commandPath)?{isMutation:typeof options.add=="string",forceCapable:!0,forceRequested}:LIST_MUTATION_COMMANDS.has(commandPath)?{isMutation:hasMutatingListValues(options.add)||hasMutatingListValues(options.remove),forceCapable:!0,forceRequested}:{isMutation:!1,forceCapable:!1,forceRequested:!1}}function isMutationInvocation(commandPath,commandArgs,options){if(decideWriteGate(commandPath,options).isMutation)return!0;const normalizedCommand=commandPath.trim().toLowerCase();return isMutationAction(normalizedCommand)?["close-many","close-task","copy","delete","discover","focus","pause-task","start-task","update-many"].includes(normalizedCommand)?!0:commandArgs.some(argument=>POSITIONAL_MUTATION_VERBS.has(argument.trim().toLowerCase())):!1}function normalizedLifecycleStatus(value){return(value??"in_progress").trim().toLowerCase().replaceAll("-","_")}function enforceSchemaMigrationInput(commandPath,commandArgs,options){const subcommand=commandArgs[0]?.trim().toLowerCase()??"";if(commandPath.trim().toLowerCase()!=="schema"||!["rename-type","rename-field","remap-status"].includes(subcommand))return;const missing=[];if(toNonEmptyStringOrUndefined(commandArgs[1])||missing.push("source"),toNonEmptyStringOrUndefined(options.to)||missing.push("--to"),missing.length!==0)throw new PmCliError(`Schema migration requires ${missing.join(", ")}.`,EXIT_CODE.USAGE,{code:"schema_migration_input_required",required:missing.join(","),why:"Schema migrations require a source and target. A workspace-bound stable migration id is derived automatically when --migration-id is omitted.",recovery:{recovery_mode:"compact",missing_required_fields:missing,suggested_flags:missing.filter(entry=>entry.startsWith("--")),suggested_retry:`pm schema ${subcommand} <source> --to <target>`}})}async function warnForUnclaimedInProgressUpdate(commandPath,commandArgs,options,pmRoot,settings){if(commandPath.trim().toLowerCase()!=="update"||typeof options.status!="string"||normalizedLifecycleStatus(options.status)!==normalizedLifecycleStatus(settings.schema.workflow.in_progress_status))return;const rawId=commandArgs[0];if(!rawId)return;const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations()),located=await locateItem(pmRoot,rawId,settings.id_prefix,settings.item_format,typeRegistry.type_to_folder);if(!located)return;const current=await readLocatedItem(located,{schema:settings.schema}),requestedAssignee=typeof options.assignee=="string"?options.assignee.trim():void 0;(requestedAssignee===void 0?current.document.metadata.assignee?.trim():!["","none","null","undefined"].includes(requestedAssignee.toLowerCase())&&requestedAssignee)||printError(`warning:in_progress_item_unclaimed:${located.id}:claim_with=pm claim ${located.id}`)}async function enforceMutationGuardPreflight(commandPath,commandArgs,options,global2,pmRoot){if(!isMutationInvocation(commandPath,commandArgs,options)||(enforceSchemaMigrationInput(commandPath,commandArgs,options),!await pathExists(getSettingsPath(pmRoot))))return;const settings=await readSettingsWithMetadata(pmRoot);global2.json!==!0&&await warnForUnclaimedInProgressUpdate(commandPath,commandArgs,options,pmRoot,settings.settings);const result=evaluateMutationGuard({author:resolveAuthor(global2.author,settings.settings.author_default),payload:{command:commandPath,args:commandArgs,options},settings:settings.settings.mutation_guard,force:global2.force===!0||options.force===!0});for(const warning of result.warnings)printError(`warning:${warning}`)}function enforceMandatoryMigrationWriteGate(commandPath,options,blockers){if(blockers.length===0)return;const decision=decideWriteGate(commandPath,options);if(!decision.isMutation||decision.forceCapable&&decision.forceRequested)return;const codes=blockers.map(entry=>`extension_migration_blocking:${entry.layer}:${entry.name}:${entry.id}:${entry.status}`),forceGuidance=decision.forceCapable?"Re-run this command with --force to bypass.":"This command path does not support --force bypass.";throw new PmCliError(`Write command "${commandPath}" blocked by unresolved mandatory extension migrations (${codes.join(",")}). ${forceGuidance}`,EXIT_CODE.CONFLICT)}async function enforceItemFormatWriteGateAndPreflightMigration(commandPath,options,pmRoot,decision){if(!decideWriteGate(commandPath,options).isMutation||!decision.enforce_item_format_gate&&!decision.run_preflight_item_format_sync||!await pathExists(getSettingsPath(pmRoot)))return;const{settings,metadata,warnings}=await readSettingsWithMetadata(pmRoot);for(const warning of warnings)printError(`warning:${warning}`);if(decision.enforce_item_format_gate&&!metadata.has_explicit_item_format&&(persistSelectedItemFormat(settings),await writeSettings(pmRoot,settings,"item_format:auto_select_default")),decision.run_preflight_item_format_sync){const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());await migrateItemFilesToFormat(pmRoot,settings.item_format,"item_format:pre_mutation_sync",typeRegistry.type_to_folder,settings.schema)}}export{collectMandatoryMigrationBlockers,decideWriteGate,enforceItemFormatWriteGateAndPreflightMigration,enforceMandatoryMigrationWriteGate,enforceMutationGuardPreflight,enforceSchemaMigrationInput,normalizedLifecycleStatus,resolveMigrationId,resolveNormalizedMigrationStatus};
 //# sourceMappingURL=migration-gates.js.map

package/dist/cli/option-values.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9e5f7e21-caa0-5a5c-9d38-36d834aba1e0")}catch(e2){}})();function stringArrayOption(value){if(Array.isArray(value))return value;if(typeof value==="string")return[value];return void 0}export{stringArrayOption};
+(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]="7f9ea812-e170-5c91-a646-88286797d97d")}catch{}})();function stringArrayOption(value){if(Array.isArray(value))return value;if(typeof value=="string")return[value]}export{stringArrayOption};
 //# sourceMappingURL=option-values.js.map

package/dist/cli/public.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b63b9ea0-d392-547a-a05b-0911712d5016")}catch(e2){}})();import{runPmCli as runInternalPmCli}from"./main.js";async function runPmCli(rawArgv){const previousExitCode=process.exitCode;try{await runInternalPmCli(rawArgv)}finally{process.exitCode=previousExitCode}}export{runPmCli};
+(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]="b63b9ea0-d392-547a-a05b-0911712d5016")}catch{}})();import{runPmCli as runInternalPmCli}from"./main.js";async function runPmCli(rawArgv){const previousExitCode=process.exitCode;try{await runInternalPmCli(rawArgv)}finally{process.exitCode=previousExitCode}}export{runPmCli};
 //# sourceMappingURL=public.js.map

package/dist/cli/register-annotations.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="dc9822ba-df3c-5179-827e-ef2551786b14")}catch(e2){}})();import{EXIT_CODE,PmCliError}from"../sdk/runtime-primitives.js";import{renderPmCommand}from"../sdk/command-line.js";import{runComments}from"./commands/annotations/comments.js";import{runLearnings}from"./commands/annotations/learnings.js";import{runNotes}from"./commands/annotations/notes.js";import{addHiddenOption,getGlobalOptions,invalidateSearchCachesForMutation,printError,printResult,readOptionString}from"./registration-helpers.js";function assertNoTransposedAnnotationAction(collection,id,text,options){if(id.trim().toLowerCase()!=="add"||!text?.trim()){return}const suppliedText=readOptionString(options,"add")??readOptionString(options,"text")??readOptionString(options,"note")??readOptionString(options,"body")??readOptionString(options,"comment");const file=readOptionString(options,"file");const retryArgs=[collection,text.trim()];if(suppliedText!==void 0)retryArgs.push("--add",suppliedText);else if(options.stdin===true)retryArgs.push("--stdin");else if(file!==void 0)retryArgs.push("--file",file);else retryArgs.push("--add","-");const suggestedRetry=renderPmCommand(retryArgs);const stdinRetry=renderPmCommand([collection,text.trim(),"--add","-"]);throw new PmCliError(`The positional token "add" was parsed as the item id, while "${text.trim()}" was parsed as annotation text. ${collection} does not use an add subcommand.`,EXIT_CODE.USAGE,{code:"annotation_transposed_subcommand",reason:"noun_verb_object_transposition",required:`Place the item id immediately after ${collection}, then use --add for annotation text.`,examples:[...new Set([suggestedRetry,stdinRetry])],recovery:{attempted_command:`pm ${collection} add ${text.trim()}`,normalized_args:[collection,"add",text.trim()],parsed_positionals:[{role:"transposed_subcommand",value:"add"},{role:"item_id",value:text.trim()}],suggested_retry:suggestedRetry}})}function resolveAnnotationTextAliases(label,options,aliases){const supplied=aliases.flatMap(alias=>{const value=readOptionString(options,alias);return value===void 0?[]:[{alias,value}]});const distinctValues=[...new Set(supplied.map(({value})=>value))];if(distinctValues.length>1){throw new PmCliError(`Specify ${label} text with one alias or the same value across aliases: ${supplied.map(({alias})=>`--${alias}`).join(", ")}`,EXIT_CODE.USAGE,{code:"annotation_alias_conflict"})}return supplied[0]?.value}function resolveCommentSources(text,options){const editIndex=typeof options.edit==="number"?options.edit:void 0;const deleteIndex=typeof options.delete==="number"?options.delete:void 0;const addFromOption=resolveAnnotationTextAliases("comment",options,["add","text","body","comment"]);const addFromPositional=typeof text==="string"?text:void 0;const readFromStdin=options.stdin===true;const readFromFile=readOptionString(options,"file");const sourceCount=Number(addFromOption!==void 0)+Number(addFromPositional!==void 0)+Number(readFromStdin)+Number(readFromFile!==void 0);if(sourceCount>1){if(addFromOption!==void 0&&addFromPositional!==void 0&&!readFromStdin&&readFromFile===void 0){throw new PmCliError("Specify comment text either as positional [text] or with --add, not both",EXIT_CODE.USAGE)}throw new PmCliError("Specify comment text with exactly one source: positional [text], --add, --stdin, or --file",EXIT_CODE.USAGE)}const add=addFromOption??addFromPositional;return{add,readFromStdin,readFromFile,editIndex,deleteIndex,isMutation:typeof add==="string"||readFromStdin||readFromFile!==void 0||editIndex!==void 0||deleteIndex!==void 0}}function resolveSingleAnnotationSources(label,positional,options){const addFromOption=resolveAnnotationTextAliases(label,options,label==="note"?["add","text","note"]:["add","text"]);const addFromPositional=typeof positional==="string"?positional:void 0;if(addFromOption!==void 0&&addFromPositional!==void 0){throw new PmCliError(`Specify ${label} text either as positional [text] or with --add, not both`,EXIT_CODE.USAGE)}const add=addFromOption??addFromPositional;const addJson=label==="note"?readOptionString(options,"addJson"):void 0;const readFromStdin=options.stdin===true;const readFromFile=readOptionString(options,"file");const editIndex=typeof options.edit==="number"?options.edit:void 0;const deleteIndex=typeof options.delete==="number"?options.delete:void 0;return{add,addJson,readFromStdin,readFromFile,editIndex,deleteIndex,isMutation:typeof add==="string"||addJson!==void 0||readFromStdin||readFromFile!==void 0||editIndex!==void 0||deleteIndex!==void 0}}async function runCommentsAction(id,text,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertNoTransposedAnnotationAction("comments",id,text,options);const sources=resolveCommentSources(text,options);const result=await runComments(id,{add:sources.add,stdin:sources.readFromStdin,file:sources.readFromFile,edit:sources.editIndex,delete:sources.deleteIndex,limit:readOptionString(options,"limit"),fullHistory:options.fullHistory===true,ifAbsent:options.ifAbsent===true,author:readOptionString(options,"author"),message:readOptionString(options,"message"),ownershipAppendBypass:options.ownershipAppendBypass===true,force:Boolean(options.force)},globalOptions);if(sources.isMutation&&result.changed!==false){await invalidateSearchCachesForMutation(globalOptions,result)}printAnnotationResult("comments",result,globalOptions,startedAt)}async function runNotesAction(id,text,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertNoTransposedAnnotationAction("notes",id,text,options);const sources=resolveSingleAnnotationSources("note",text,options);const result=await runNotes(id,{add:sources.add,addJson:sources.addJson,stdin:sources.readFromStdin,file:sources.readFromFile,edit:sources.editIndex,delete:sources.deleteIndex,limit:readOptionString(options,"limit"),since:readOptionString(options,"since"),eventType:readOptionString(options,"eventType"),includeMeta:options.includeMeta===true,fullHistory:options.fullHistory===true,ifAbsent:options.ifAbsent===true,author:readOptionString(options,"author"),message:readOptionString(options,"message"),ownershipAppendBypass:options.ownershipAppendBypass===true,force:Boolean(options.force)},globalOptions);if(sources.isMutation&&result.changed!==false){await invalidateSearchCachesForMutation(globalOptions,result)}printAnnotationResult("notes",result,globalOptions,startedAt)}async function runLearningsAction(id,text,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertNoTransposedAnnotationAction("learnings",id,text,options);const sources=resolveSingleAnnotationSources("learning",text,options);const result=await runLearnings(id,{add:sources.add,stdin:sources.readFromStdin,file:sources.readFromFile,edit:sources.editIndex,delete:sources.deleteIndex,limit:readOptionString(options,"limit"),fullHistory:options.fullHistory===true,ifAbsent:options.ifAbsent===true,author:readOptionString(options,"author"),message:readOptionString(options,"message"),ownershipAppendBypass:options.ownershipAppendBypass===true,force:Boolean(options.force)},globalOptions);if(sources.isMutation&&result.changed!==false){await invalidateSearchCachesForMutation(globalOptions,result)}printAnnotationResult("learnings",result,globalOptions,startedAt)}function printAnnotationResult(command,result,globalOptions,startedAt){printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=${command} took_ms=${Date.now()-startedAt}`)}}function registerAnnotationCommands(program,parsePositiveInteger){const commentsCommand=program.command("comments").argument("<id>","Item id").argument("[text]","Optional comment text shorthand (equivalent to --add)").option("--add <text>","Append comment text; use text=<value> for structured input or - for stdin").option("--stdin","Read comment text from stdin (supports multiline markdown)").option("--file <path>","Read comment text from a file or stdin (-)").option("--edit <index>","Replace one comment using positional text, --add, --stdin, or --file",parsePositiveInteger("--edit")).option("--delete <index>","Delete the comment at 1-based <index>",parsePositiveInteger("--delete")).option("--limit <n>","Return only latest n comments").option("--full-history","Return complete comment history instead of a bounded mutation receipt").option("--if-absent","Append only when resolved author and text are absent").option("--author [value]","Comment author; defaults to PM_AUTHOR or settings").option("--message <value>","History message").option("--force","Force ownership override").description("List, add, edit, or delete comments for an item.").action(runCommentsAction);addHiddenOption(commentsCommand,"--body <text>","Alias for --add",false);addHiddenOption(commentsCommand,"--text <text>","Alias for --add",false);addHiddenOption(commentsCommand,"--comment <text>","Alias for --add",false);const notesCommand=program.command("notes").argument("<id>","Item id").argument("[text]","Optional note text shorthand for --add").option("--add <text>","Add a text note (- reads stdin)").option("--note <text>","Alias for --add").option("--add-json <json>","Append a JSON event").option("--stdin","Read note text from stdin").option("--file <path>","Read note from file or stdin (-)").option("--edit <index>","Replace a 1-based note using the selected text input",parsePositiveInteger("--edit")).option("--delete <index>","Delete the note at 1-based <index>",parsePositiveInteger("--delete")).option("--limit <n>","Return only latest n notes").option("--since <timestamp>","Filter JSON events from this ISO time").option("--event-type <value>","Filter JSON events by top-level type").option("--include-meta","Include count and truncation metadata").option("--full-history","Return complete note history instead of a bounded receipt").option("--if-absent","Append only when resolved author and text are absent").option("--author [value]","Author; defaults to PM_AUTHOR/settings").option("--message <value>","History message").option("--force","Force ownership override").description("Manage merge-safe text notes and JSON context events.").action(runNotesAction);addHiddenOption(notesCommand,"--text <text>","Alias for --add",false);const learningsCommand=program.command("learnings").argument("<id>","Item id").argument("[text]","Optional learning text shorthand for --add").option("--add <text>","Append learning text; use text=<value> or - for stdin").option("--stdin","Read learning text from stdin").option("--file <path>","Read learning text from a file or stdin (-)").option("--edit <index>","Replace one learning using positional text, --add, --stdin, or --file",parsePositiveInteger("--edit")).option("--delete <index>","Delete the learning at 1-based <index>",parsePositiveInteger("--delete")).option("--limit <n>","Return only latest n learnings").option("--full-history","Return complete learning history instead of a bounded receipt").option("--if-absent","Append only when resolved author and text are absent").option("--author [value]","Learning author (optional; falls back to PM_AUTHOR/settings)").option("--message <value>","History message").option("--force","Force ownership override").description("List, add, edit, or delete learnings for an item.").action(runLearningsAction);addHiddenOption(learningsCommand,"--text <text>","Alias for --add",false)}export{registerAnnotationCommands};
+(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]="e464e0e0-01a2-56c9-a05d-9b1b9dd6a6ee")}catch{}})();import{EXIT_CODE,PmCliError}from"../sdk/runtime-primitives.js";import{renderPmCommand}from"../sdk/command-line.js";import{runComments}from"./commands/annotations/comments.js";import{runLearnings}from"./commands/annotations/learnings.js";import{runNotes}from"./commands/annotations/notes.js";import{addHiddenOption,getGlobalOptions,invalidateSearchCachesForMutation,printError,printResult,readOptionString}from"./registration-helpers.js";function assertNoTransposedAnnotationAction(collection,id,text,options){if(id.trim().toLowerCase()!=="add"||!text?.trim())return;const suppliedText=readOptionString(options,"add")??readOptionString(options,"text")??readOptionString(options,"note")??readOptionString(options,"body")??readOptionString(options,"comment"),file=readOptionString(options,"file"),retryArgs=[collection,text.trim()];suppliedText!==void 0?retryArgs.push("--add",suppliedText):options.stdin===!0?retryArgs.push("--stdin"):file!==void 0?retryArgs.push("--file",file):retryArgs.push("--add","-");const suggestedRetry=renderPmCommand(retryArgs),stdinRetry=renderPmCommand([collection,text.trim(),"--add","-"]);throw new PmCliError(`The positional token "add" was parsed as the item id, while "${text.trim()}" was parsed as annotation text. ${collection} does not use an add subcommand.`,EXIT_CODE.USAGE,{code:"annotation_transposed_subcommand",reason:"noun_verb_object_transposition",required:`Place the item id immediately after ${collection}, then use --add for annotation text.`,examples:[...new Set([suggestedRetry,stdinRetry])],recovery:{attempted_command:`pm ${collection} add ${text.trim()}`,normalized_args:[collection,"add",text.trim()],parsed_positionals:[{role:"transposed_subcommand",value:"add"},{role:"item_id",value:text.trim()}],suggested_retry:suggestedRetry}})}function resolveAnnotationTextAliases(label,options,aliases){const supplied=aliases.flatMap(alias=>{const value=readOptionString(options,alias);return value===void 0?[]:[{alias,value}]});if([...new Set(supplied.map(({value})=>value))].length>1)throw new PmCliError(`Specify ${label} text with one alias or the same value across aliases: ${supplied.map(({alias})=>`--${alias}`).join(", ")}`,EXIT_CODE.USAGE,{code:"annotation_alias_conflict"});return supplied[0]?.value}function resolveCommentSources(text,options){const editIndex=typeof options.edit=="number"?options.edit:void 0,deleteIndex=typeof options.delete=="number"?options.delete:void 0,addFromOption=resolveAnnotationTextAliases("comment",options,["add","text","body","comment"]),addFromPositional=typeof text=="string"?text:void 0,readFromStdin=options.stdin===!0,readFromFile=readOptionString(options,"file");if(+(addFromOption!==void 0)+ +(addFromPositional!==void 0)+Number(readFromStdin)+ +(readFromFile!==void 0)>1)throw addFromOption!==void 0&&addFromPositional!==void 0&&!readFromStdin&&readFromFile===void 0?new PmCliError("Specify comment text either as positional [text] or with --add, not both",EXIT_CODE.USAGE):new PmCliError("Specify comment text with exactly one source: positional [text], --add, --stdin, or --file",EXIT_CODE.USAGE);const add=addFromOption??addFromPositional;return{add,readFromStdin,readFromFile,editIndex,deleteIndex,isMutation:typeof add=="string"||readFromStdin||readFromFile!==void 0||editIndex!==void 0||deleteIndex!==void 0}}function resolveSingleAnnotationSources(label,positional,options){const addFromOption=resolveAnnotationTextAliases(label,options,label==="note"?["add","text","note"]:["add","text"]),addFromPositional=typeof positional=="string"?positional:void 0;if(addFromOption!==void 0&&addFromPositional!==void 0)throw new PmCliError(`Specify ${label} text either as positional [text] or with --add, not both`,EXIT_CODE.USAGE);const add=addFromOption??addFromPositional,addJson=label==="note"?readOptionString(options,"addJson"):void 0,readFromStdin=options.stdin===!0,readFromFile=readOptionString(options,"file"),editIndex=typeof options.edit=="number"?options.edit:void 0,deleteIndex=typeof options.delete=="number"?options.delete:void 0;return{add,addJson,readFromStdin,readFromFile,editIndex,deleteIndex,isMutation:typeof add=="string"||addJson!==void 0||readFromStdin||readFromFile!==void 0||editIndex!==void 0||deleteIndex!==void 0}}async function runCommentsAction(id,text,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now();assertNoTransposedAnnotationAction("comments",id,text,options);const sources=resolveCommentSources(text,options),result=await runComments(id,{add:sources.add,stdin:sources.readFromStdin,file:sources.readFromFile,edit:sources.editIndex,delete:sources.deleteIndex,limit:readOptionString(options,"limit"),fullHistory:options.fullHistory===!0,ifAbsent:options.ifAbsent===!0,author:readOptionString(options,"author"),message:readOptionString(options,"message"),ownershipAppendBypass:options.ownershipAppendBypass===!0,force:!!options.force},globalOptions);sources.isMutation&&result.changed!==!1&&await invalidateSearchCachesForMutation(globalOptions,result),printAnnotationResult("comments",result,globalOptions,startedAt)}async function runNotesAction(id,text,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now();assertNoTransposedAnnotationAction("notes",id,text,options);const sources=resolveSingleAnnotationSources("note",text,options),result=await runNotes(id,{add:sources.add,addJson:sources.addJson,stdin:sources.readFromStdin,file:sources.readFromFile,edit:sources.editIndex,delete:sources.deleteIndex,limit:readOptionString(options,"limit"),since:readOptionString(options,"since"),eventType:readOptionString(options,"eventType"),includeMeta:options.includeMeta===!0,fullHistory:options.fullHistory===!0,ifAbsent:options.ifAbsent===!0,author:readOptionString(options,"author"),message:readOptionString(options,"message"),ownershipAppendBypass:options.ownershipAppendBypass===!0,force:!!options.force},globalOptions);sources.isMutation&&result.changed!==!1&&await invalidateSearchCachesForMutation(globalOptions,result),printAnnotationResult("notes",result,globalOptions,startedAt)}async function runLearningsAction(id,text,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now();assertNoTransposedAnnotationAction("learnings",id,text,options);const sources=resolveSingleAnnotationSources("learning",text,options),result=await runLearnings(id,{add:sources.add,stdin:sources.readFromStdin,file:sources.readFromFile,edit:sources.editIndex,delete:sources.deleteIndex,limit:readOptionString(options,"limit"),fullHistory:options.fullHistory===!0,ifAbsent:options.ifAbsent===!0,author:readOptionString(options,"author"),message:readOptionString(options,"message"),ownershipAppendBypass:options.ownershipAppendBypass===!0,force:!!options.force},globalOptions);sources.isMutation&&result.changed!==!1&&await invalidateSearchCachesForMutation(globalOptions,result),printAnnotationResult("learnings",result,globalOptions,startedAt)}function printAnnotationResult(command,result,globalOptions,startedAt){printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=${command} took_ms=${Date.now()-startedAt}`)}function registerAnnotationCommands(program,parsePositiveInteger){const commentsCommand=program.command("comments").argument("<id>","Item id").argument("[text]","Optional comment text shorthand (equivalent to --add)").option("--add <text>","Append comment text; use text=<value> for structured input or - for stdin").option("--stdin","Read comment text from stdin (supports multiline markdown)").option("--file <path>","Read comment text from a file or stdin (-)").option("--edit <index>","Replace one comment using positional text, --add, --stdin, or --file",parsePositiveInteger("--edit")).option("--delete <index>","Delete the comment at 1-based <index>",parsePositiveInteger("--delete")).option("--limit <n>","Return only latest n comments").option("--full-history","Return complete comment history instead of a bounded mutation receipt").option("--if-absent","Append only when resolved author and text are absent").option("--author [value]","Comment author; defaults to PM_AUTHOR or settings").option("--message <value>","History message").option("--force","Force ownership override").description("List, add, edit, or delete comments for an item.").action(runCommentsAction);addHiddenOption(commentsCommand,"--body <text>","Alias for --add",!1),addHiddenOption(commentsCommand,"--text <text>","Alias for --add",!1),addHiddenOption(commentsCommand,"--comment <text>","Alias for --add",!1);const notesCommand=program.command("notes").argument("<id>","Item id").argument("[text]","Optional note text shorthand for --add").option("--add <text>","Add a text note (- reads stdin)").option("--note <text>","Alias for --add").option("--add-json <json>","Append a JSON event").option("--stdin","Read note text from stdin").option("--file <path>","Read note from file or stdin (-)").option("--edit <index>","Replace a 1-based note using the selected text input",parsePositiveInteger("--edit")).option("--delete <index>","Delete the note at 1-based <index>",parsePositiveInteger("--delete")).option("--limit <n>","Return only latest n notes").option("--since <timestamp>","Filter JSON events from this ISO time").option("--event-type <value>","Filter JSON events by top-level type").option("--include-meta","Include count and truncation metadata").option("--full-history","Return complete note history instead of a bounded receipt").option("--if-absent","Append only when resolved author and text are absent").option("--author [value]","Author; defaults to PM_AUTHOR/settings").option("--message <value>","History message").option("--force","Force ownership override").description("Manage merge-safe text notes and JSON context events.").action(runNotesAction);addHiddenOption(notesCommand,"--text <text>","Alias for --add",!1);const learningsCommand=program.command("learnings").argument("<id>","Item id").argument("[text]","Optional learning text shorthand for --add").option("--add <text>","Append learning text; use text=<value> or - for stdin").option("--stdin","Read learning text from stdin").option("--file <path>","Read learning text from a file or stdin (-)").option("--edit <index>","Replace one learning using positional text, --add, --stdin, or --file",parsePositiveInteger("--edit")).option("--delete <index>","Delete the learning at 1-based <index>",parsePositiveInteger("--delete")).option("--limit <n>","Return only latest n learnings").option("--full-history","Return complete learning history instead of a bounded receipt").option("--if-absent","Append only when resolved author and text are absent").option("--author [value]","Learning author (optional; falls back to PM_AUTHOR/settings)").option("--message <value>","History message").option("--force","Force ownership override").description("List, add, edit, or delete learnings for an item.").action(runLearningsAction);addHiddenOption(learningsCommand,"--text <text>","Alias for --add",!1)}export{registerAnnotationCommands};
 //# sourceMappingURL=register-annotations.js.map

package/dist/cli/register-assurance.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="70a8a9b3-0fe4-5903-8e9c-85db1f0ca522")}catch(e2){}})();import{runAssuranceAction}from"../sdk/governance/assurance-action.js";import{printResult}from"../sdk/runtime-primitives.js";import{getGlobalOptions,readOptionString}from"./registration-helpers.js";async function runAssuranceCliAction(action,kindOrGate,id,options,command){const global2=getGlobalOptions(command);const isRun=action==="run";const isVerdicts=action==="verdicts";const isPresetAction=action==="presets"||action==="apply";const isPromote=action==="promote";const result=await runAssuranceAction({action,...isRun||isVerdicts||isPresetAction||isPromote?{}:{kind:kindOrGate},id:isRun||isVerdicts||isPromote?id??kindOrGate:id,preset:isPresetAction?id??kindOrGate:void 0,definition:readOptionString(options,"definition"),trigger:readOptionString(options,"trigger"),tree:readOptionString(options,"tree"),gate:readOptionString(options,"gate"),limit:readOptionString(options,"limit"),dry_run:options.dryRun===true,fullChangedFields:global2.fullChangedFields,idOnly:global2.idOnly,author:readOptionString(options,"author"),message:readOptionString(options,"message"),owner:readOptionString(options,"owner"),apply:options.apply===true,enforcement:readOptionString(options,"enforcement")},global2);printResult(result,global2);if(typeof result==="object"&&result!==null&&"exit_code"in result&&result.exit_code===1){process.exitCode=1}}function registerAssuranceCommand(program){program.command("assurance").argument("<action>","Action; inspect `pm contracts --command assurance`").argument("[kind]","Declaration kind or run gate id").argument("[id]","Declaration/gate id").description("Manage SDK-owned assurance contracts.").option("--definition <json>","Put declaration JSON").option("--trigger <value>","Gate trigger").option("--tree <value>","Revision identity").option("--gate <id>","Verdict gate filter").option("--limit <number>","Verdict limit").option("--dry-run","Evaluate without recording").option("--author <value>","Mutation author").option("--message <value>","Mutation rationale").option("--owner <item-id>","Preset/derivation owner").option("--apply","Persist derived proposals").option("--enforcement <level>","Promote to warn or block").action(runAssuranceCliAction)}export{registerAssuranceCommand};
+(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]="3952425a-adce-59dd-84b6-97ac571eaa73")}catch{}})();import{runAssuranceAction}from"../sdk/governance/assurance-action.js";import{printResult}from"../sdk/runtime-primitives.js";import{getGlobalOptions,readOptionString}from"./registration-helpers.js";async function runAssuranceCliAction(action,kindOrGate,id,options,command){const global2=getGlobalOptions(command),isRun=action==="run",isVerdicts=action==="verdicts",isPresetAction=action==="presets"||action==="apply",isPromote=action==="promote",result=await runAssuranceAction({action,...isRun||isVerdicts||isPresetAction||isPromote?{}:{kind:kindOrGate},id:isRun||isVerdicts||isPromote?id??kindOrGate:id,preset:isPresetAction?id??kindOrGate:void 0,definition:readOptionString(options,"definition"),trigger:readOptionString(options,"trigger"),tree:readOptionString(options,"tree"),gate:readOptionString(options,"gate"),limit:readOptionString(options,"limit"),dry_run:options.dryRun===!0,fullChangedFields:global2.fullChangedFields,idOnly:global2.idOnly,author:readOptionString(options,"author"),message:readOptionString(options,"message"),owner:readOptionString(options,"owner"),apply:options.apply===!0,enforcement:readOptionString(options,"enforcement")},global2);printResult(result,global2),typeof result=="object"&&result!==null&&"exit_code"in result&&result.exit_code===1&&(process.exitCode=1)}function registerAssuranceCommand(program){program.command("assurance").argument("<action>","Action; inspect `pm contracts --command assurance`").argument("[kind]","Declaration kind or run gate id").argument("[id]","Declaration/gate id").description("Manage SDK-owned assurance contracts.").option("--definition <json>","Put declaration JSON").option("--trigger <value>","Gate trigger").option("--tree <value>","Revision identity").option("--gate <id>","Verdict gate filter").option("--limit <number>","Verdict limit").option("--dry-run","Evaluate without recording").option("--author <value>","Mutation author").option("--message <value>","Mutation rationale").option("--owner <item-id>","Preset/derivation owner").option("--apply","Persist derived proposals").option("--enforcement <level>","Promote to warn or block").action(runAssuranceCliAction)}export{registerAssuranceCommand};
 //# sourceMappingURL=register-assurance.js.map

package/dist/cli/register-files-lookup.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2cac3cd9-887c-56e0-a197-cc36d2203c9e")}catch(e2){}})();import{runFilesLookup}from"../sdk/files.js";import{parseSourceLineRange}from"../sdk/traceability/source-traceability.js";import{EXIT_CODE,PmCliError}from"../sdk/runtime-primitives.js";import{getGlobalOptions,printResult}from"./registration-helpers.js";function parseIntegerBound(flag,minimum){return value=>{const parsed=Number(value);if(!Number.isInteger(parsed)||parsed<minimum){throw new PmCliError(`${flag} must be an integer greater than or equal to ${minimum}.`,EXIT_CODE.USAGE)}return parsed}}async function runFilesLookupAction(paths,options,command){const globalOptions=getGlobalOptions(command);if(options.scope!==void 0&&options.scope!=="project"&&options.scope!=="global"){throw new PmCliError("--scope must be either project or global.",EXIT_CODE.USAGE)}const result=await runFilesLookup({paths,scope:options.scope,limit:typeof options.limit==="number"?options.limit:void 0,offset:typeof options.offset==="number"?options.offset:void 0,noTruncate:options.noTruncate===true,strictRead:options.strictRead===true,explain:options.explain===true,lineRange:typeof options.lines==="string"?parseSourceLineRange(options.lines):void 0,decisionDepth:typeof options.decisionDepth==="number"?options.decisionDepth:void 0},globalOptions);printResult(result,globalOptions)}function registerFilesLookupCommand(filesCommand){filesCommand.command("lookup").argument("<paths...>","Project-relative or absolute source paths").option("--scope <scope>","Restrict links to project or global scope").option("--limit <n>","Maximum referencing items to return",parseIntegerBound("--limit",1)).option("--offset <n>","Number of referencing items to skip",parseIntegerBound("--offset",0)).option("--no-truncate","Return every referencing item").option("--strict-read","Fail when any authoritative item cannot be read").option("--explain","Include ranked source-to-work rationale").option("--lines <start:end>","Attribute an inclusive source line range").option("--decision-depth <n>","Maximum governing-decision relationship depth",parseIntegerBound("--decision-depth",1)).description("Find and explain pm items that govern requested source paths.").action(runFilesLookupAction)}export{registerFilesLookupCommand};
+(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]="d861c49e-6054-54af-a733-069cd9238f8a")}catch{}})();import{runFilesLookup}from"../sdk/files.js";import{parseSourceLineRange}from"../sdk/traceability/source-traceability.js";import{EXIT_CODE,PmCliError}from"../sdk/runtime-primitives.js";import{getGlobalOptions,printResult}from"./registration-helpers.js";function parseIntegerBound(flag,minimum){return value=>{const parsed=Number(value);if(!Number.isInteger(parsed)||parsed<minimum)throw new PmCliError(`${flag} must be an integer greater than or equal to ${minimum}.`,EXIT_CODE.USAGE);return parsed}}async function runFilesLookupAction(paths,options,command){const globalOptions=getGlobalOptions(command);if(options.scope!==void 0&&options.scope!=="project"&&options.scope!=="global")throw new PmCliError("--scope must be either project or global.",EXIT_CODE.USAGE);const result=await runFilesLookup({paths,scope:options.scope,limit:typeof options.limit=="number"?options.limit:void 0,offset:typeof options.offset=="number"?options.offset:void 0,noTruncate:options.noTruncate===!0,strictRead:options.strictRead===!0,explain:options.explain===!0,lineRange:typeof options.lines=="string"?parseSourceLineRange(options.lines):void 0,decisionDepth:typeof options.decisionDepth=="number"?options.decisionDepth:void 0},globalOptions);printResult(result,globalOptions)}function registerFilesLookupCommand(filesCommand){filesCommand.command("lookup").argument("<paths...>","Project-relative or absolute source paths").option("--scope <scope>","Restrict links to project or global scope").option("--limit <n>","Maximum referencing items to return",parseIntegerBound("--limit",1)).option("--offset <n>","Number of referencing items to skip",parseIntegerBound("--offset",0)).option("--no-truncate","Return every referencing item").option("--strict-read","Fail when any authoritative item cannot be read").option("--explain","Include ranked source-to-work rationale").option("--lines <start:end>","Attribute an inclusive source line range").option("--decision-depth <n>","Maximum governing-decision relationship depth",parseIntegerBound("--decision-depth",1)).description("Find and explain pm items that govern requested source paths.").action(runFilesLookupAction)}export{registerFilesLookupCommand};
 //# sourceMappingURL=register-files-lookup.js.map

package/dist/cli/register-history-activity.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="10ce695f-65e7-5ea4-bdd8-472ad9527506")}catch(e2){}})();import{EXIT_CODE,PmCliError}from"../sdk/runtime-primitives.js";import{runActivity}from"./commands/history/activity.js";import{collect,getGlobalOptions,normalizeActivityOptions,printActivityJsonStream,printError,printResult,resolveActivityStreamMode}from"./registration-helpers.js";async function runActivityAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();if([options.raw,options.compact,options.full,options.provenance].filter(value=>value===true).length>1){throw new PmCliError("Activity projection options are mutually exclusive. Use --raw, --compact, --provenance, or --full.",EXIT_CODE.USAGE)}const streamMode=resolveActivityStreamMode(options.stream);if(streamMode&&!globalOptions.json){throw new PmCliError("--stream requires --json output mode.",EXIT_CODE.USAGE)}const normalized=normalizeActivityOptions(options);const result=await runActivity(streamMode&&options.full!==true&&options.provenance!==true?{...normalized,raw:true,compact:true}:normalized,globalOptions);if(streamMode){printActivityJsonStream(result,normalized,globalOptions)}else{printResult(result,globalOptions)}if(globalOptions.profile){printError(`profile:command=activity took_ms=${Date.now()-startedAt}`)}}function registerHistoryActivityCommand(command){command.option("--id <value>","Filter by item ID").option("--op <value>","Filter by history operation").option("--author <value>","Filter by history author").option("--from <value>","Lower timestamp bound (ISO/date string or relative)").option("--to <value>","Upper timestamp bound (ISO/date string or relative)").option("--limit <n>","Return only the latest n activity entries").option("--unbounded","Explicitly return every matching activity entry (disables the default bound)").option("--compact","Condensed output: show only id, op, ts, author, msg per entry").option("--raw","Show the legacy compact per-event stream instead of the item digest").option("--full","Show full activity entries with JSON Patch payloads").option("--provenance","Show patch-free author, harness, instance, and extensible provenance").option("--provenance-summary","Include bounded provenance completeness counts").option("--harness <value>","Filter by recorded or vocabulary-resolved harness (repeatable)",collect).option("--agent-instance <value>","Filter by privacy-safe agent instance (repeatable)",collect).option("--provenance-filter <dimension=value>","Filter by an exact declared provenance value (repeatable)",collect).option("--stream [mode]","Emit line-delimited JSON rows (requires --json). Optional mode: rows|ndjson|jsonl").description("Show recent activity across items.").action(runActivityAction)}export{registerHistoryActivityCommand};
+(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]="a51d6d75-0f11-5bdf-a384-2ca10ef064ef")}catch{}})();import{EXIT_CODE,PmCliError}from"../sdk/runtime-primitives.js";import{runActivity}from"./commands/history/activity.js";import{collect,getGlobalOptions,normalizeActivityOptions,printActivityJsonStream,printError,printResult,resolveActivityStreamMode}from"./registration-helpers.js";async function runActivityAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now();if([options.raw,options.compact,options.full,options.provenance].filter(value=>value===!0).length>1)throw new PmCliError("Activity projection options are mutually exclusive. Use --raw, --compact, --provenance, or --full.",EXIT_CODE.USAGE);const streamMode=resolveActivityStreamMode(options.stream);if(streamMode&&!globalOptions.json)throw new PmCliError("--stream requires --json output mode.",EXIT_CODE.USAGE);const normalized=normalizeActivityOptions(options),result=await runActivity(streamMode&&options.full!==!0&&options.provenance!==!0?{...normalized,raw:!0,compact:!0}:normalized,globalOptions);streamMode?printActivityJsonStream(result,normalized,globalOptions):printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=activity took_ms=${Date.now()-startedAt}`)}function registerHistoryActivityCommand(command){command.option("--id <value>","Filter by item ID").option("--op <value>","Filter by history operation").option("--author <value>","Filter by history author").option("--from <value>","Lower timestamp bound (ISO/date string or relative)").option("--to <value>","Upper timestamp bound (ISO/date string or relative)").option("--limit <n>","Return only the latest n activity entries").option("--unbounded","Explicitly return every matching activity entry (disables the default bound)").option("--compact","Condensed output: show only id, op, ts, author, msg per entry").option("--raw","Show the legacy compact per-event stream instead of the item digest").option("--full","Show full activity entries with JSON Patch payloads").option("--provenance","Show patch-free author, harness, instance, and extensible provenance").option("--provenance-summary","Include bounded provenance completeness counts").option("--harness <value>","Filter by recorded or vocabulary-resolved harness (repeatable)",collect).option("--agent-instance <value>","Filter by privacy-safe agent instance (repeatable)",collect).option("--provenance-filter <dimension=value>","Filter by an exact declared provenance value (repeatable)",collect).option("--stream [mode]","Emit line-delimited JSON rows (requires --json). Optional mode: rows|ndjson|jsonl").description("Show recent activity across items.").action(runActivityAction)}export{registerHistoryActivityCommand};
 //# sourceMappingURL=register-history-activity.js.map

package/dist/cli/register-history-author.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="771083a4-6b0a-530d-b607-bf1c1010ff0e")}catch(e2){}})();import{resolvePmRoot}from"../sdk/runtime-primitives.js";import{acknowledgeUnknownAuthorHistoryEventsFromTransport}from"../sdk/author-attribution.js";import{collect,getGlobalOptions,printResult,readOptionString}from"./registration-helpers.js";async function runHistoryAuthorAcknowledgeAction(options,command){const globalOptions=getGlobalOptions(command);const rawEvents=Array.isArray(options.event)?options.event:[];const result=await acknowledgeUnknownAuthorHistoryEventsFromTransport(resolvePmRoot(process.cwd(),globalOptions.path),{historyEvent:rawEvents,allActionable:options.allActionable===true,dryRun:options.dryRun===true,planFingerprint:readOptionString(options,"planFingerprint"),limit:options.limit,attributedAuthor:readOptionString(options,"attributedAuthor"),reviewer:readOptionString(options,"reviewer"),reason:readOptionString(options,"reason")});printResult(result,globalOptions)}function registerHistoryAuthorAcknowledgeCommand(program){program.command("history-author-acknowledge").option("--event <item-id:line>","Unknown-author event coordinate (repeatable)",collect).option("--all-actionable","Select all actionable events").option("--dry-run","Preview a deterministic source-bound plan").option("--plan-fingerprint <sha256>","Apply the exact fingerprint returned by --dry-run").option("--limit <n>","Maximum coordinate rows returned in the plan").option("--attributed-author <value>","Reviewed principal attribution").option("--reviewer <value>","Disposition reviewer").option("--reason <value>","Review evidence").description("Append audited dispositions for immutable unknown-author events.").action(runHistoryAuthorAcknowledgeAction)}export{registerHistoryAuthorAcknowledgeCommand};
+(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]="458845bd-2d07-59d5-b322-6ab634fcefa9")}catch{}})();import{resolvePmRoot}from"../sdk/runtime-primitives.js";import{acknowledgeUnknownAuthorHistoryEventsFromTransport}from"../sdk/author-attribution.js";import{collect,getGlobalOptions,printResult,readOptionString}from"./registration-helpers.js";async function runHistoryAuthorAcknowledgeAction(options,command){const globalOptions=getGlobalOptions(command),rawEvents=Array.isArray(options.event)?options.event:[],result=await acknowledgeUnknownAuthorHistoryEventsFromTransport(resolvePmRoot(process.cwd(),globalOptions.path),{historyEvent:rawEvents,allActionable:options.allActionable===!0,dryRun:options.dryRun===!0,planFingerprint:readOptionString(options,"planFingerprint"),limit:options.limit,attributedAuthor:readOptionString(options,"attributedAuthor"),reviewer:readOptionString(options,"reviewer"),reason:readOptionString(options,"reason")});printResult(result,globalOptions)}function registerHistoryAuthorAcknowledgeCommand(program){program.command("history-author-acknowledge").option("--event <item-id:line>","Unknown-author event coordinate (repeatable)",collect).option("--all-actionable","Select all actionable events").option("--dry-run","Preview a deterministic source-bound plan").option("--plan-fingerprint <sha256>","Apply the exact fingerprint returned by --dry-run").option("--limit <n>","Maximum coordinate rows returned in the plan").option("--attributed-author <value>","Reviewed principal attribution").option("--reviewer <value>","Disposition reviewer").option("--reason <value>","Review evidence").description("Append audited dispositions for immutable unknown-author events.").action(runHistoryAuthorAcknowledgeAction)}export{registerHistoryAuthorAcknowledgeCommand};
 //# sourceMappingURL=register-history-author.js.map