npm - @unbrained/pm-cli - Versions diffs - 2026.10.24 → 2026.10.25 - Mend

@unbrained/pm-cli 2026.10.24 → 2026.10.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (156) hide show

package/dist/sdk/cli-contracts/registration-helpers.js CHANGED Viewed

@@ -1,8 +1,8 @@
-(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]="f71d68b8-a4cd-5fda-83a0-0528ac44aed0")}catch{}})();import{Option}from"commander";import{resolvePmHistoryOperation}from"./command-aliases.js";import{pathExists,refreshSearchArtifactsForMutation,shouldRunSearchRefreshInForeground,EXIT_CODE,PmCliError,printError,printResult,writeStdout,getSettingsPath,resolvePmRoot,readSettings,runActiveServiceOverride,setActiveCommandResult}from"../runtime-primitives.js";import{ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,CREATE_COMMANDER_STRING_OPTION_CONTRACTS,LIST_COMMANDER_STRING_OPTION_CONTRACTS,NEXT_COMMANDER_STRING_OPTION_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,readFirstValueFromCommanderOptions,readFirstStringFromCommanderOptions,readStringArrayFromCommanderOptions}from"../cli-contracts.js";import{buildBackgroundTestCommandArgs,buildBackgroundTestAllCommandArgs}from"../test/command-args.js";async function applyActiveCommandResultService(command,args,options,global2,result){const pmRoot=resolvePmRoot(process.cwd(),global2.path),override=await runActiveServiceOverride("command_result",{command,args,options,global:global2,pm_root:pmRoot,result});return override.handled?override.result:result}function syncCommanderActionOptions(actionCommand,commandOptions){for(const[key,value]of Object.entries(commandOptions)){const source=actionCommand.getOptionValueSource(key),unchanged=source!==void 0&&Object.is(actionCommand.getOptionValue(key),value);actionCommand.setOptionValueWithSource(key,value,unchanged?source:"cli")}}function readJoinedRepeatedOption(options,contract){const values=[],observedArrays=new Set;for(const key of contract.keys){if(!Object.hasOwn(options,key))continue;const value=options[key];if(value!=null){if(typeof value=="string"){values.push(value);continue}if(!Array.isArray(value)||!value.every(entry=>typeof entry=="string"))return;observedArrays.has(value)||(observedArrays.add(value),values.push(...value))}}return values.length>0?values.join("; "):void 0}const RESOLVED_GLOBAL_OPTIONS=Symbol("pm.resolvedGlobalOptions");function commandOptionsReader(command){return typeof command=="object"&&command!==null?command:{}}function resolveCommanderContract(contracts,target){return contracts.find(entry=>entry.target===target)??{target,keys:[target]}}function setResolvedGlobalOptions(command,globalOptions){command[RESOLVED_GLOBAL_OPTIONS]={...globalOptions}}function clearResolvedGlobalOptions(command){delete command[RESOLVED_GLOBAL_OPTIONS]}function readStringCommandOption(options,key){return typeof options[key]=="string"?options[key]:void 0}function getGlobalOptions(command){const commandPath=resolvePmHistoryOperation(getCommandPath(command)),resolved=command[RESOLVED_GLOBAL_OPTIONS];if(resolved)return{...resolved,...commandPath.length>0?{command:commandPath}:{}};const reader=commandOptionsReader(command),opts=typeof reader.optsWithGlobals=="function"?reader.optsWithGlobals():typeof reader.opts=="function"?reader.opts():{};return{json:opts.json===!0?!0:void 0,quiet:!!opts.quiet,noChangedFields:opts.changedFields===!1,...opts.fullChangedFields===!0?{fullChangedFields:!0}:{},idOnly:opts.idOnly===!0,...opts.lean===!0?{lean:!0}:{},...opts.tokenAccounting===!0?{tokenAccounting:!0}:{},outputInclude:readStringCommandOption(opts,"outputInclude"),outputLimit:readStringCommandOption(opts,"outputLimit"),outputBudget:readStringCommandOption(opts,"outputBudget"),outputSession:readStringCommandOption(opts,"outputSession"),outputCursor:readStringCommandOption(opts,"outputCursor"),...opts.outputRowContract===!0?{outputRowContract:!0}:{},...opts.outputFormat==="toon"||opts.outputFormat==="json"?{outputFormat:opts.outputFormat}:{},path:readStringCommandOption(opts,"pmPath")??readStringCommandOption(opts,"path"),noExtensions:opts.extensions===!1,noPager:!!opts.noPager,profile:!!opts.profile,...commandPath.length>0?{command:commandPath}:{},...typeof opts.author=="string"?{author:opts.author}:{}}}function getCommandPath(command){const parts=[];let current=command;for(;current?.parent;)parts.unshift(current.name()),current=current.parent;return parts.join(" ")}async function applyDefaultOutputFormat(globalOptions){if(globalOptions.json===!0)return globalOptions;const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);if(!await pathExists(getSettingsPath(pmRoot)))return globalOptions;const settings=await readSettings(pmRoot);return{...globalOptions,defaultOutputFormat:settings.output.default_format}}function collect(value,previous){const next=previous??[];return next.push(value),next}function optionTrue(options,key){return options[key]===!0?!0:void 0}function optionFalse(options,key){return options[key]===!1?!0:void 0}function readOptionString(options,key){return typeof options[key]=="string"?options[key]:void 0}function addHiddenOption(command,flags,description,repeatable=!1,repeatableParser=void 0){const option=new Option(flags,description).hideHelp();repeatable&&option.argParser(repeatableParser??collect),command.addOption(option)}function addHiddenOptions(command,aliases,repeatable){for(const[flags,description]of aliases)addHiddenOption(command,flags,description,repeatable)}function anyOptionTrue(options,keys){return keys.some(key=>options[key]===!0)?!0:void 0}function readStringOrFiniteNumberFromCommanderOptions(options,contract){const value=readFirstValueFromCommanderOptions(options,contract);return typeof value=="string"||typeof value=="number"&&Number.isFinite(value)?value:void 0}function copyUnknownOptions(target,source){for(const[key,value]of Object.entries(source))key==="__proto__"||key==="constructor"||key==="prototype"||Object.hasOwn(target,key)||(target[key]=value)}function formatHookWarnings(warnings){return warnings.join(",")}function normalizeCreateOptions(commandOptions,options={}){const readCreateString=target=>readFirstStringFromCommanderOptions(commandOptions,resolveCommanderContract(CREATE_COMMANDER_STRING_OPTION_CONTRACTS,target)),readCreateList=target=>readStringArrayFromCommanderOptions(commandOptions,resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,target)),type=readCreateString("type");if(options.requireType!==!1&&type===void 0)throw new PmCliError("Missing required option --type <value>. Why required: create resolves runtime schema fields/workflow from item type. Retry: add --type <built-in or configured custom type> (example: --type Task).",EXIT_CODE.USAGE);const normalized={title:readCreateString("title"),description:readCreateString("description"),type,template:readCreateString("template"),createMode:readCreateString("createMode"),schedulePreset:readCreateString("schedulePreset"),status:readCreateString("status"),closeReason:readCreateString("closeReason"),completedAt:readCreateString("completedAt"),priority:readCreateString("priority"),tags:readCreateString("tags"),addTags:readCreateList("addTags"),body:readCreateString("body"),deadline:readCreateString("deadline"),estimatedMinutes:readCreateString("estimatedMinutes"),acceptanceCriteria:readJoinedRepeatedOption(commandOptions,resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,"acceptanceCriteria")),definitionOfReady:readCreateString("definitionOfReady"),order:readCreateString("order"),rank:readCreateString("rank"),goal:readCreateString("goal"),objective:readCreateString("objective"),value:readCreateString("value"),impact:readCreateString("impact"),outcome:readCreateString("outcome"),whyNow:readCreateString("whyNow"),author:readCreateString("author"),message:readCreateString("message"),assignee:readCreateString("assignee"),parent:readCreateString("parent"),allowMissingParent:anyOptionTrue(commandOptions,["allowMissingParent","allow_missing_parent"])===!0,allowUnresolvedDeps:anyOptionTrue(commandOptions,["allowUnresolvedDeps","allow_unresolved_deps"])===!0,allowDuplicate:optionTrue(commandOptions,"allowDuplicate")===!0,reviewer:readCreateString("reviewer"),risk:readCreateString("risk"),confidence:readCreateString("confidence"),sprint:readCreateString("sprint"),release:readCreateString("release"),blockedBy:readCreateString("blockedBy"),blockedReason:readCreateString("blockedReason"),unblockNote:readCreateString("unblockNote"),reporter:readCreateString("reporter"),severity:readCreateString("severity"),environment:readCreateString("environment"),reproSteps:readCreateString("reproSteps"),resolution:readCreateString("resolution"),expectedResult:readCreateString("expectedResult"),actualResult:readCreateString("actualResult"),affectedVersion:readCreateString("affectedVersion"),fixedVersion:readCreateString("fixedVersion"),component:readCreateString("component"),regression:commandOptions.regression===!0?"true":readCreateString("regression"),customerImpact:readCreateString("customerImpact"),dep:readCreateList("dep"),comment:readCreateList("comment"),note:readCreateList("note"),learning:readCreateList("learning"),file:readCreateList("file"),test:readCreateList("test"),doc:readCreateList("doc"),reminder:readCreateList("reminder"),event:readCreateList("event"),typeOption:readCreateList("typeOption"),field:readCreateList("field"),unset:readCreateList("unset"),clearDeps:optionTrue(commandOptions,"clearDeps"),clearComments:optionTrue(commandOptions,"clearComments"),clearNotes:optionTrue(commandOptions,"clearNotes"),clearLearnings:optionTrue(commandOptions,"clearLearnings"),clearFiles:optionTrue(commandOptions,"clearFiles"),clearTests:optionTrue(commandOptions,"clearTests"),clearDocs:optionTrue(commandOptions,"clearDocs"),clearReminders:optionTrue(commandOptions,"clearReminders"),clearEvents:optionTrue(commandOptions,"clearEvents"),clearTypeOptions:optionTrue(commandOptions,"clearTypeOptions")};return copyUnknownOptions(normalized,commandOptions),normalized}function normalizeUpdateOptions(commandOptions){const readUpdateString=target=>readFirstStringFromCommanderOptions(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,target)),readUpdateList=target=>readStringArrayFromCommanderOptions(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,target)),normalized={title:readUpdateString("title"),description:readUpdateString("description"),body:readUpdateString("body"),status:readUpdateString("status"),closeReason:readUpdateString("closeReason"),priority:readUpdateString("priority"),type:readUpdateString("type"),tags:readUpdateString("tags"),addTags:readUpdateList("addTags"),removeTags:readUpdateList("removeTags"),deadline:readUpdateString("deadline"),estimatedMinutes:readUpdateString("estimatedMinutes"),acceptanceCriteria:readJoinedRepeatedOption(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,"acceptanceCriteria")),addAc:readUpdateList("addAc"),removeAc:readUpdateList("removeAc"),definitionOfReady:readUpdateString("definitionOfReady"),order:readUpdateString("order"),rank:readUpdateString("rank"),goal:readUpdateString("goal"),objective:readUpdateString("objective"),value:readUpdateString("value"),impact:readUpdateString("impact"),outcome:readUpdateString("outcome"),whyNow:readUpdateString("whyNow"),author:readUpdateString("author"),message:readUpdateString("message"),force:!!commandOptions.force,ownershipMetadataBypass:commandOptions.ownershipMetadataBypass===!0?!0:void 0,ownershipDependencyBypass:commandOptions.ownershipDependencyBypass===!0?!0:void 0,assignee:readUpdateString("assignee"),parent:readUpdateString("parent"),allowUnresolvedDeps:anyOptionTrue(commandOptions,["allowUnresolvedDeps","allow_unresolved_deps"])===!0,reviewer:readUpdateString("reviewer"),risk:readUpdateString("risk"),confidence:readUpdateString("confidence"),sprint:readUpdateString("sprint"),release:readUpdateString("release"),blockedBy:readUpdateString("blockedBy"),blockedReason:readUpdateString("blockedReason"),unblockNote:readUpdateString("unblockNote"),reporter:readUpdateString("reporter"),severity:readUpdateString("severity"),environment:readUpdateString("environment"),reproSteps:readUpdateString("reproSteps"),resolution:readUpdateString("resolution"),expectedResult:readUpdateString("expectedResult"),actualResult:readUpdateString("actualResult"),affectedVersion:readUpdateString("affectedVersion"),fixedVersion:readUpdateString("fixedVersion"),component:readUpdateString("component"),regression:commandOptions.regression===!0?"true":readUpdateString("regression"),customerImpact:readUpdateString("customerImpact"),dep:readUpdateList("dep"),depRemove:readUpdateList("depRemove"),replaceDeps:optionTrue(commandOptions,"replaceDeps"),replaceTests:optionTrue(commandOptions,"replaceTests"),replaceFiles:optionTrue(commandOptions,"replaceFiles"),replaceDocs:optionTrue(commandOptions,"replaceDocs"),comment:readUpdateList("comment"),note:readUpdateList("note"),learning:readUpdateList("learning"),file:readUpdateList("file"),test:readUpdateList("test"),doc:readUpdateList("doc"),reminder:readUpdateList("reminder"),event:readUpdateList("event"),typeOption:readUpdateList("typeOption"),field:readUpdateList("field"),unset:readUpdateList("unset"),clearDeps:optionTrue(commandOptions,"clearDeps"),clearComments:optionTrue(commandOptions,"clearComments"),clearNotes:optionTrue(commandOptions,"clearNotes"),clearLearnings:optionTrue(commandOptions,"clearLearnings"),clearFiles:optionTrue(commandOptions,"clearFiles"),clearTests:optionTrue(commandOptions,"clearTests"),clearDocs:optionTrue(commandOptions,"clearDocs"),clearReminders:optionTrue(commandOptions,"clearReminders"),clearEvents:optionTrue(commandOptions,"clearEvents"),clearTypeOptions:optionTrue(commandOptions,"clearTypeOptions")};return copyUnknownOptions(normalized,commandOptions),normalized}const UPDATE_MANY_CONTROL_OPTION_KEYS=new Set(["filterStatus","filterType","filterTag","filterPriority","filterDeadlineBefore","filterDeadlineAfter","filterUpdatedAfter","filterUpdatedBefore","filterCreatedAfter","filterCreatedBefore","filterAssignee","filterAssigneeFilter","filterAssignee_filter","filterParent","filterSprint","filterRelease","filterAcMissing","filterEstimatesMissing","filterEstimateMissing","filterResolutionMissing","filterMetadataMissing","filterReviewerMissing","filterRiskMissing","filterConfidenceMissing","filterSprintMissing","filterReleaseMissing","filterHasNotes","filterNoNotes","filterHasLearnings","filterNoLearnings","filterHasFiles","filterNoFiles","filterHasDocs","filterNoDocs","filterHasTests","filterNoTests","filterHasComments","filterNoComments","filterHasDeps","filterNoDeps","filterHasBody","filterEmptyBody","filterHasLinkedCommand","filterNoLinkedCommand","ids","limit","offset","dryRun","rollback","checkpoint"]);function extractUpdateManyMutationOptionSource(commandOptions){const mutationOptions={};for(const[key,value]of Object.entries(commandOptions))UPDATE_MANY_CONTROL_OPTION_KEYS.has(key)||(mutationOptions[key]=value);return mutationOptions}function readListOptionString(options,target){const contract=resolveCommanderContract(LIST_COMMANDER_STRING_OPTION_CONTRACTS,target),stringValue=readFirstStringFromCommanderOptions(options,contract);if(stringValue!==void 0)return stringValue;for(const key of contract.keys){const value=options[key];if(Array.isArray(value)){const strings=value.filter(entry=>typeof entry=="string");if(strings.length>0)return strings.join(",")}if(target==="ids"&&typeof value=="string")return value;if(typeof value=="number"&&Number.isFinite(value))return String(value)}}function readSelectionFilterOptionFields(options){const filterFilesMissing=optionTrue(options,"filterFilesMissing"),filterDocsMissing=optionTrue(options,"filterDocsMissing");return{filterReviewerMissing:optionTrue(options,"filterReviewerMissing"),filterRiskMissing:optionTrue(options,"filterRiskMissing"),filterConfidenceMissing:optionTrue(options,"filterConfidenceMissing"),filterSprintMissing:optionTrue(options,"filterSprintMissing"),filterReleaseMissing:optionTrue(options,"filterReleaseMissing"),hasNotes:optionTrue(options,"hasNotes"),hasLearnings:optionTrue(options,"hasLearnings"),hasFiles:optionTrue(options,"hasFiles"),hasDocs:optionTrue(options,"hasDocs"),hasTests:optionTrue(options,"hasTests"),hasComments:optionTrue(options,"hasComments"),hasDeps:optionTrue(options,"hasDeps"),hasBody:optionTrue(options,"hasBody"),hasLinkedCommand:optionTrue(options,"hasLinkedCommand"),noNotes:optionFalse(options,"notes"),noLearnings:optionFalse(options,"learnings"),noFiles:optionFalse(options,"files")??filterFilesMissing,filterFilesMissing,noDocs:optionFalse(options,"docs")??filterDocsMissing,filterDocsMissing,noTests:optionFalse(options,"tests"),noComments:optionFalse(options,"comments"),noDeps:optionFalse(options,"deps"),emptyBody:optionTrue(options,"emptyBody"),noLinkedCommand:optionFalse(options,"linkedCommand")}}function normalizeListOptions(options){const normalized={status:readListOptionString(options,"status"),type:readListOptionString(options,"type"),tag:readListOptionString(options,"tag"),priority:readListOptionString(options,"priority"),deadlineBefore:readListOptionString(options,"deadlineBefore"),deadlineAfter:readListOptionString(options,"deadlineAfter"),updatedAfter:readListOptionString(options,"updatedAfter"),updatedBefore:readListOptionString(options,"updatedBefore"),createdAfter:readListOptionString(options,"createdAfter"),createdBefore:readListOptionString(options,"createdBefore"),today:optionTrue(options,"today"),recent:optionTrue(options,"recent"),ids:readListOptionString(options,"ids"),assignee:readListOptionString(options,"assignee"),assigneeFilter:readListOptionString(options,"assigneeFilter"),parent:readListOptionString(options,"parent"),sprint:readListOptionString(options,"sprint"),release:readListOptionString(options,"release"),limit:readListOptionString(options,"limit"),offset:readListOptionString(options,"offset"),noTruncate:optionFalse(options,"truncate"),includeBody:optionTrue(options,"includeBody"),strictRead:optionTrue(options,"strictRead"),compact:optionTrue(options,"compact"),brief:optionTrue(options,"brief"),full:optionTrue(options,"full"),fields:readListOptionString(options,"fields"),sort:readListOptionString(options,"sort"),order:readListOptionString(options,"order"),tree:optionTrue(options,"tree"),treeDepth:readListOptionString(options,"treeDepth"),filterAcMissing:optionTrue(options,"filterAcMissing"),filterEstimatesMissing:anyOptionTrue(options,["filterEstimatesMissing","filterEstimateMissing"]),filterResolutionMissing:optionTrue(options,"filterResolutionMissing"),filterMetadataMissing:optionTrue(options,"filterMetadataMissing"),...readSelectionFilterOptionFields(options)};return copyUnknownOptions(normalized,options),normalized}function normalizeAggregateOptions(options){return{groupBy:typeof options.groupBy=="string"?options.groupBy:void 0,setMode:typeof options.setMode=="string"?options.setMode:void 0,limit:readListOptionString(options,"limit"),after:readListOptionString(options,"after"),count:options.count===!0?!0:void 0,completion:options.completion===!0?!0:void 0,sum:typeof options.sum=="string"?options.sum:void 0,avg:typeof options.avg=="string"?options.avg:void 0,includeUnparented:options.includeUnparented===!0||options.include_unparented===!0,status:typeof options.status=="string"?options.status:void 0,type:readListOptionString(options,"type"),tag:readListOptionString(options,"tag"),priority:readListOptionString(options,"priority"),deadlineBefore:readListOptionString(options,"deadlineBefore"),deadlineAfter:readListOptionString(options,"deadlineAfter"),assignee:readListOptionString(options,"assignee"),assigneeFilter:readListOptionString(options,"assigneeFilter"),parent:readListOptionString(options,"parent"),sprint:readListOptionString(options,"sprint"),release:readListOptionString(options,"release")}}function printListJsonStream(commandName,result,globalOptions){if(setActiveCommandResult(result),globalOptions.quiet)return;const warnings=Array.isArray(result.warnings)?result.warnings:[],metaPayload={type:"meta",command:commandName,count:result.count,now:result.now,filters:result.filters};if(warnings.length>0&&(metaPayload.warnings=warnings),!!writeStdout(`${JSON.stringify(metaPayload)}
+(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]="f491571f-4e99-5892-9c4d-e5129725665a")}catch{}})();import{Option}from"commander";import{resolvePmHistoryOperation}from"./command-aliases.js";import{pathExists,refreshSearchArtifactsForMutation,shouldRunSearchRefreshInForeground,EXIT_CODE,PmCliError,printError,printResult,writeStdout,getSettingsPath,resolvePmRoot,readSettings,runActiveServiceOverride,setActiveCommandResult}from"../runtime-primitives.js";import{ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,CREATE_COMMANDER_STRING_OPTION_CONTRACTS,LIST_COMMANDER_STRING_OPTION_CONTRACTS,NEXT_COMMANDER_STRING_OPTION_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,readFirstValueFromCommanderOptions,readFirstStringFromCommanderOptions,readStringArrayFromCommanderOptions}from"../cli-contracts.js";import{buildBackgroundTestCommandArgs,buildBackgroundTestAllCommandArgs}from"../test/command-args.js";async function applyActiveCommandResultService(command,args,options,global2,result){const pmRoot=resolvePmRoot(process.cwd(),global2.path),override=await runActiveServiceOverride("command_result",{command,args,options,global:global2,pm_root:pmRoot,result});return override.handled?override.result:result}function syncCommanderActionOptions(actionCommand,commandOptions){for(const[key,value]of Object.entries(commandOptions)){const source=actionCommand.getOptionValueSource(key),unchanged=source!==void 0&&Object.is(actionCommand.getOptionValue(key),value);actionCommand.setOptionValueWithSource(key,value,unchanged?source:"cli")}}function readJoinedRepeatedOption(options,contract){const values=[],observedArrays=new Set;for(const key of contract.keys){if(!Object.hasOwn(options,key))continue;const value=options[key];if(value!=null){if(typeof value=="string"){values.push(value);continue}if(!Array.isArray(value)||!value.every(entry=>typeof entry=="string"))return;observedArrays.has(value)||(observedArrays.add(value),values.push(...value))}}return values.length>0?values.join("; "):void 0}const RESOLVED_GLOBAL_OPTIONS=Symbol("pm.resolvedGlobalOptions");function commandOptionsReader(command){return typeof command=="object"&&command!==null?command:{}}function resolveCommanderContract(contracts,target){return contracts.find(entry=>entry.target===target)??{target,keys:[target]}}function setResolvedGlobalOptions(command,globalOptions){command[RESOLVED_GLOBAL_OPTIONS]={...globalOptions}}function clearResolvedGlobalOptions(command){delete command[RESOLVED_GLOBAL_OPTIONS]}function readStringCommandOption(options,key){return typeof options[key]=="string"?options[key]:void 0}function getGlobalOptions(command){const commandPath=resolvePmHistoryOperation(getCommandPath(command)),resolved=command[RESOLVED_GLOBAL_OPTIONS];if(resolved)return{...resolved,...commandPath.length>0?{command:commandPath}:{}};const reader=commandOptionsReader(command),opts=typeof reader.optsWithGlobals=="function"?reader.optsWithGlobals():typeof reader.opts=="function"?reader.opts():{};return{json:opts.json===!0?!0:void 0,quiet:!!opts.quiet,noChangedFields:opts.changedFields===!1,...opts.fullChangedFields===!0?{fullChangedFields:!0}:{},idOnly:opts.idOnly===!0,...opts.lean===!0?{lean:!0}:{},...opts.tokenAccounting===!0?{tokenAccounting:!0}:{},outputInclude:readStringCommandOption(opts,"outputInclude"),outputLimit:readStringCommandOption(opts,"outputLimit"),outputBudget:readStringCommandOption(opts,"outputBudget"),outputSession:readStringCommandOption(opts,"outputSession"),outputCursor:readStringCommandOption(opts,"outputCursor"),...opts.outputRowContract===!0?{outputRowContract:!0}:{},...opts.outputFormat==="toon"||opts.outputFormat==="json"?{outputFormat:opts.outputFormat}:{},path:readStringCommandOption(opts,"pmPath")??readStringCommandOption(opts,"path"),noExtensions:opts.extensions===!1,noPager:!!opts.noPager,profile:!!opts.profile,...commandPath.length>0?{command:commandPath}:{},...typeof opts.author=="string"?{author:opts.author}:{}}}function getCommandPath(command){const parts=[];let current=command;for(;current?.parent;)parts.unshift(current.name()),current=current.parent;return parts.join(" ")}async function applyDefaultOutputFormat(globalOptions){if(globalOptions.json===!0)return globalOptions;const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);if(!await pathExists(getSettingsPath(pmRoot)))return globalOptions;const settings=await readSettings(pmRoot);return{...globalOptions,defaultOutputFormat:settings.output.default_format}}function collect(value,previous){const next=previous??[];return next.push(value),next}function optionTrue(options,key){return options[key]===!0?!0:void 0}function optionFalse(options,key){return options[key]===!1?!0:void 0}function readOptionString(options,key){return typeof options[key]=="string"?options[key]:void 0}function addHiddenOption(command,flags,description,repeatable=!1,repeatableParser=void 0){const option=new Option(flags,description).hideHelp();repeatable&&option.argParser(repeatableParser??collect),command.addOption(option)}function addHiddenOptions(command,aliases,repeatable){for(const[flags,description]of aliases)addHiddenOption(command,flags,description,repeatable)}function anyOptionTrue(options,keys){return keys.some(key=>options[key]===!0)?!0:void 0}function readStringOrFiniteNumberFromCommanderOptions(options,contract){const value=readFirstValueFromCommanderOptions(options,contract);return typeof value=="string"||typeof value=="number"&&Number.isFinite(value)?value:void 0}function copyUnknownOptions(target,source){for(const[key,value]of Object.entries(source))key==="__proto__"||key==="constructor"||key==="prototype"||Object.hasOwn(target,key)||(target[key]=value)}function formatHookWarnings(warnings){return warnings.join(",")}function normalizeCreateOptions(commandOptions,options={}){const readCreateString=target=>readFirstStringFromCommanderOptions(commandOptions,resolveCommanderContract(CREATE_COMMANDER_STRING_OPTION_CONTRACTS,target)),readCreateList=target=>readStringArrayFromCommanderOptions(commandOptions,resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,target)),type=readCreateString("type");if(options.requireType!==!1&&type===void 0)throw new PmCliError("Missing required option --type <value>. Why required: create resolves runtime schema fields/workflow from item type. Retry: add --type <built-in or configured custom type> (example: --type Task).",EXIT_CODE.USAGE);const normalized={title:readCreateString("title"),description:readCreateString("description"),type,template:readCreateString("template"),createMode:readCreateString("createMode"),schedulePreset:readCreateString("schedulePreset"),status:readCreateString("status"),closeReason:readCreateString("closeReason"),completedAt:readCreateString("completedAt"),priority:readCreateString("priority"),tags:readCreateString("tags"),addTags:readCreateList("addTags"),body:readCreateString("body"),deadline:readCreateString("deadline"),estimatedMinutes:readCreateString("estimatedMinutes"),acceptanceCriteria:readJoinedRepeatedOption(commandOptions,resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,"acceptanceCriteria")),definitionOfReady:readCreateString("definitionOfReady"),order:readCreateString("order"),rank:readCreateString("rank"),goal:readCreateString("goal"),objective:readCreateString("objective"),value:readCreateString("value"),impact:readCreateString("impact"),outcome:readCreateString("outcome"),whyNow:readCreateString("whyNow"),author:readCreateString("author"),message:readCreateString("message"),assignee:readCreateString("assignee"),parent:readCreateString("parent"),allowMissingParent:anyOptionTrue(commandOptions,["allowMissingParent","allow_missing_parent"])===!0,allowUnresolvedDeps:anyOptionTrue(commandOptions,["allowUnresolvedDeps","allow_unresolved_deps"])===!0,allowDuplicate:optionTrue(commandOptions,"allowDuplicate")===!0,reviewer:readCreateString("reviewer"),risk:readCreateString("risk"),confidence:readCreateString("confidence"),sprint:readCreateString("sprint"),release:readCreateString("release"),blockedBy:readCreateString("blockedBy"),blockedReason:readCreateString("blockedReason"),unblockNote:readCreateString("unblockNote"),reporter:readCreateString("reporter"),severity:readCreateString("severity"),environment:readCreateString("environment"),reproSteps:readCreateString("reproSteps"),resolution:readCreateString("resolution"),expectedResult:readCreateString("expectedResult"),actualResult:readCreateString("actualResult"),affectedVersion:readCreateString("affectedVersion"),fixedVersion:readCreateString("fixedVersion"),component:readCreateString("component"),regression:commandOptions.regression===!0?"true":readCreateString("regression"),customerImpact:readCreateString("customerImpact"),dep:readCreateList("dep"),comment:readCreateList("comment"),note:readCreateList("note"),learning:readCreateList("learning"),file:readCreateList("file"),test:readCreateList("test"),doc:readCreateList("doc"),reminder:readCreateList("reminder"),event:readCreateList("event"),typeOption:readCreateList("typeOption"),field:readCreateList("field"),unset:readCreateList("unset"),clearDeps:optionTrue(commandOptions,"clearDeps"),clearComments:optionTrue(commandOptions,"clearComments"),clearNotes:optionTrue(commandOptions,"clearNotes"),clearLearnings:optionTrue(commandOptions,"clearLearnings"),clearFiles:optionTrue(commandOptions,"clearFiles"),clearTests:optionTrue(commandOptions,"clearTests"),clearDocs:optionTrue(commandOptions,"clearDocs"),clearReminders:optionTrue(commandOptions,"clearReminders"),clearEvents:optionTrue(commandOptions,"clearEvents"),clearTypeOptions:optionTrue(commandOptions,"clearTypeOptions")};return copyUnknownOptions(normalized,commandOptions),normalized}function normalizeUpdateOptions(commandOptions){const readUpdateString=target=>readFirstStringFromCommanderOptions(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,target)),readUpdateList=target=>readStringArrayFromCommanderOptions(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,target)),normalized={title:readUpdateString("title"),description:readUpdateString("description"),body:readUpdateString("body"),status:readUpdateString("status"),closeReason:readUpdateString("closeReason"),priority:readUpdateString("priority"),type:readUpdateString("type"),tags:readUpdateString("tags"),addTags:readUpdateList("addTags"),removeTags:readUpdateList("removeTags"),deadline:readUpdateString("deadline"),estimatedMinutes:readUpdateString("estimatedMinutes"),acceptanceCriteria:readJoinedRepeatedOption(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,"acceptanceCriteria")),addAc:readUpdateList("addAc"),removeAc:readUpdateList("removeAc"),definitionOfReady:readUpdateString("definitionOfReady"),order:readUpdateString("order"),rank:readUpdateString("rank"),goal:readUpdateString("goal"),objective:readUpdateString("objective"),value:readUpdateString("value"),impact:readUpdateString("impact"),outcome:readUpdateString("outcome"),whyNow:readUpdateString("whyNow"),author:readUpdateString("author"),message:readUpdateString("message"),force:!!commandOptions.force,ownershipMetadataBypass:commandOptions.ownershipMetadataBypass===!0?!0:void 0,ownershipDependencyBypass:commandOptions.ownershipDependencyBypass===!0?!0:void 0,assignee:readUpdateString("assignee"),parent:readUpdateString("parent"),allowUnresolvedDeps:anyOptionTrue(commandOptions,["allowUnresolvedDeps","allow_unresolved_deps"])===!0,reviewer:readUpdateString("reviewer"),risk:readUpdateString("risk"),confidence:readUpdateString("confidence"),sprint:readUpdateString("sprint"),release:readUpdateString("release"),blockedBy:readUpdateString("blockedBy"),blockedReason:readUpdateString("blockedReason"),unblockNote:readUpdateString("unblockNote"),reporter:readUpdateString("reporter"),severity:readUpdateString("severity"),environment:readUpdateString("environment"),reproSteps:readUpdateString("reproSteps"),resolution:readUpdateString("resolution"),expectedResult:readUpdateString("expectedResult"),actualResult:readUpdateString("actualResult"),affectedVersion:readUpdateString("affectedVersion"),fixedVersion:readUpdateString("fixedVersion"),component:readUpdateString("component"),regression:commandOptions.regression===!0?"true":readUpdateString("regression"),customerImpact:readUpdateString("customerImpact"),dep:readUpdateList("dep"),depRemove:readUpdateList("depRemove"),replaceDeps:optionTrue(commandOptions,"replaceDeps"),replaceTests:optionTrue(commandOptions,"replaceTests"),replaceFiles:optionTrue(commandOptions,"replaceFiles"),replaceDocs:optionTrue(commandOptions,"replaceDocs"),comment:readUpdateList("comment"),note:readUpdateList("note"),learning:readUpdateList("learning"),file:readUpdateList("file"),test:readUpdateList("test"),doc:readUpdateList("doc"),reminder:readUpdateList("reminder"),event:readUpdateList("event"),typeOption:readUpdateList("typeOption"),field:readUpdateList("field"),unset:readUpdateList("unset"),clearDeps:optionTrue(commandOptions,"clearDeps"),clearComments:optionTrue(commandOptions,"clearComments"),clearNotes:optionTrue(commandOptions,"clearNotes"),clearLearnings:optionTrue(commandOptions,"clearLearnings"),clearFiles:optionTrue(commandOptions,"clearFiles"),clearTests:optionTrue(commandOptions,"clearTests"),clearDocs:optionTrue(commandOptions,"clearDocs"),clearReminders:optionTrue(commandOptions,"clearReminders"),clearEvents:optionTrue(commandOptions,"clearEvents"),clearTypeOptions:optionTrue(commandOptions,"clearTypeOptions")};return copyUnknownOptions(normalized,commandOptions),normalized}const UPDATE_MANY_CONTROL_OPTION_KEYS=new Set(["filterStatus","filterType","filterTag","filterPriority","filterDeadlineBefore","filterDeadlineAfter","filterUpdatedAfter","filterUpdatedBefore","filterCreatedAfter","filterCreatedBefore","filterAssignee","filterAssigneeFilter","filterAssignee_filter","filterParent","filterSprint","filterRelease","filterAcMissing","filterEstimatesMissing","filterEstimateMissing","filterResolutionMissing","filterMetadataMissing","filterReviewerMissing","filterRiskMissing","filterConfidenceMissing","filterSprintMissing","filterReleaseMissing","filterHasNotes","filterNoNotes","filterHasLearnings","filterNoLearnings","filterHasFiles","filterNoFiles","filterHasDocs","filterNoDocs","filterHasTests","filterNoTests","filterHasComments","filterNoComments","filterHasDeps","filterNoDeps","filterHasBody","filterEmptyBody","filterHasLinkedCommand","filterNoLinkedCommand","ids","limit","offset","dryRun","rollback","checkpoint"]);function extractUpdateManyMutationOptionSource(commandOptions){const mutationOptions={};for(const[key,value]of Object.entries(commandOptions))UPDATE_MANY_CONTROL_OPTION_KEYS.has(key)||(mutationOptions[key]=value);return mutationOptions}function readListOptionString(options,target){const contract=resolveCommanderContract(LIST_COMMANDER_STRING_OPTION_CONTRACTS,target),stringValue=readFirstStringFromCommanderOptions(options,contract);if(stringValue!==void 0)return stringValue;for(const key of contract.keys){const value=options[key];if(Array.isArray(value)){const strings=value.filter(entry=>typeof entry=="string");if(strings.length>0)return strings.join(",")}if(target==="ids"&&typeof value=="string")return value;if(typeof value=="number"&&Number.isFinite(value))return String(value)}}function readSelectionFilterOptionFields(options){const filterFilesMissing=optionTrue(options,"filterFilesMissing"),filterDocsMissing=optionTrue(options,"filterDocsMissing");return{filterReviewerMissing:optionTrue(options,"filterReviewerMissing"),filterRiskMissing:optionTrue(options,"filterRiskMissing"),filterConfidenceMissing:optionTrue(options,"filterConfidenceMissing"),filterSprintMissing:optionTrue(options,"filterSprintMissing"),filterReleaseMissing:optionTrue(options,"filterReleaseMissing"),hasNotes:optionTrue(options,"hasNotes"),hasLearnings:optionTrue(options,"hasLearnings"),hasFiles:optionTrue(options,"hasFiles"),hasDocs:optionTrue(options,"hasDocs"),hasTests:optionTrue(options,"hasTests"),hasComments:optionTrue(options,"hasComments"),hasDeps:optionTrue(options,"hasDeps"),hasBody:optionTrue(options,"hasBody"),hasLinkedCommand:optionTrue(options,"hasLinkedCommand"),noNotes:optionFalse(options,"notes"),noLearnings:optionFalse(options,"learnings"),noFiles:optionFalse(options,"files")??filterFilesMissing,filterFilesMissing,noDocs:optionFalse(options,"docs")??filterDocsMissing,filterDocsMissing,noTests:optionFalse(options,"tests"),noComments:optionFalse(options,"comments"),noDeps:optionFalse(options,"deps"),emptyBody:optionTrue(options,"emptyBody"),noLinkedCommand:optionFalse(options,"linkedCommand")}}function normalizeListOptions(options){const normalized={status:readListOptionString(options,"status"),type:readListOptionString(options,"type"),tag:readListOptionString(options,"tag"),priority:readListOptionString(options,"priority"),deadlineBefore:readListOptionString(options,"deadlineBefore"),deadlineAfter:readListOptionString(options,"deadlineAfter"),updatedAfter:readListOptionString(options,"updatedAfter"),updatedBefore:readListOptionString(options,"updatedBefore"),createdAfter:readListOptionString(options,"createdAfter"),createdBefore:readListOptionString(options,"createdBefore"),today:optionTrue(options,"today"),recent:optionTrue(options,"recent"),ids:readListOptionString(options,"ids"),assignee:readListOptionString(options,"assignee"),assigneeFilter:readListOptionString(options,"assigneeFilter"),parent:readListOptionString(options,"parent"),sprint:readListOptionString(options,"sprint"),release:readListOptionString(options,"release"),limit:readListOptionString(options,"limit"),offset:readListOptionString(options,"offset"),noTruncate:optionFalse(options,"truncate"),includeBody:optionTrue(options,"includeBody"),strictRead:optionTrue(options,"strictRead"),compact:optionTrue(options,"compact"),brief:optionTrue(options,"brief"),full:optionTrue(options,"full"),fields:readListOptionString(options,"fields"),sort:readListOptionString(options,"sort"),order:readListOptionString(options,"order"),tree:optionTrue(options,"tree"),treeDepth:readListOptionString(options,"treeDepth"),filterAcMissing:optionTrue(options,"filterAcMissing"),filterEstimatesMissing:anyOptionTrue(options,["filterEstimatesMissing","filterEstimateMissing"]),filterResolutionMissing:optionTrue(options,"filterResolutionMissing"),filterMetadataMissing:optionTrue(options,"filterMetadataMissing"),...readSelectionFilterOptionFields(options)};return copyUnknownOptions(normalized,options),normalized}function normalizeAggregateOptions(options){return{groupBy:typeof options.groupBy=="string"?options.groupBy:void 0,setMode:typeof options.setMode=="string"?options.setMode:void 0,limit:readListOptionString(options,"limit"),after:readListOptionString(options,"after"),count:options.count===!0?!0:void 0,completion:options.completion===!0?!0:void 0,sum:typeof options.sum=="string"?options.sum:void 0,avg:typeof options.avg=="string"?options.avg:void 0,includeUnparented:options.includeUnparented===!0||options.include_unparented===!0,status:typeof options.status=="string"?options.status:void 0,type:readListOptionString(options,"type"),tag:readListOptionString(options,"tag"),priority:readListOptionString(options,"priority"),deadlineBefore:readListOptionString(options,"deadlineBefore"),deadlineAfter:readListOptionString(options,"deadlineAfter"),assignee:readListOptionString(options,"assignee"),assigneeFilter:readListOptionString(options,"assigneeFilter"),parent:readListOptionString(options,"parent"),sprint:readListOptionString(options,"sprint"),release:readListOptionString(options,"release")}}function printListJsonStream(commandName,result,globalOptions){if(setActiveCommandResult(result),globalOptions.quiet)return;const warnings=Array.isArray(result.warnings)?result.warnings:[],metaPayload={type:"meta",command:commandName,count:result.count,now:result.now,filters:result.filters};if(warnings.length>0&&(metaPayload.warnings=warnings),!!writeStdout(`${JSON.stringify(metaPayload)}
 `)){for(const item of result.items)if(!writeStdout(`${JSON.stringify({type:"item",command:commandName,item})}
 `))return;writeStdout(`${JSON.stringify({type:"end",command:commandName,count:result.count})}
 `)}}function printActivityJsonStream(result,options,globalOptions){if(setActiveCommandResult(result),globalOptions.quiet)return;const metaPayload={type:"meta",command:"activity",count:result.count,filters:{id:options.id??null,op:options.op??null,author:options.author??null,from:options.from??null,to:options.to??null,limit:options.limit??null}};if(!writeStdout(`${JSON.stringify(metaPayload)}
 `))return;const entries=result.compact&&result.compact_activity?result.compact_activity:result.activity??[];for(const entry of entries)if(!writeStdout(`${JSON.stringify({type:"entry",command:"activity",entry})}
 `))return;writeStdout(`${JSON.stringify({type:"end",command:"activity",count:result.count})}
-`)}function normalizeSearchOptions(options){const readSearchString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,target)),readSearchStringOrNumber=target=>{const candidate=readFirstValueFromCommanderOptions(options,resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,target));if(typeof candidate=="string"||typeof candidate=="number"&&Number.isFinite(candidate))return candidate},fields=readSearchString("fields"),compactRequested=options.compact===!0,fullRequested=options.full===!0,defaultCompact=!compactRequested&&!fullRequested&&fields===void 0,normalized={mode:options.semantic===!0?"semantic":options.hybrid===!0?"hybrid":readSearchString("mode"),matchMode:readSearchString("matchMode"),minScore:readSearchStringOrNumber("minScore"),count:optionTrue(options,"count"),semanticWeight:readSearchStringOrNumber("semanticWeight"),includeLinked:optionTrue(options,"includeLinked"),titleExact:optionTrue(options,"titleExact"),phraseExact:optionTrue(options,"phraseExact"),highlight:optionTrue(options,"highlight"),status:readSearchString("status"),type:readSearchString("type"),tag:readSearchString("tag"),priority:readSearchString("priority"),deadlineBefore:readSearchString("deadlineBefore"),deadlineAfter:readSearchString("deadlineAfter"),updatedAfter:readSearchString("updatedAfter"),updatedBefore:readSearchString("updatedBefore"),createdAfter:readSearchString("createdAfter"),createdBefore:readSearchString("createdBefore"),assignee:readSearchString("assignee"),sprint:readSearchString("sprint"),release:readSearchString("release"),parent:readSearchString("parent"),limit:readSearchString("limit"),fields,compact:compactRequested||defaultCompact?!0:void 0,full:optionTrue(options,"full"),...readSelectionFilterOptionFields(options)};return copyUnknownOptions(normalized,options),normalized}function normalizeSearchKeywordsInput(keywords){const query=keywords.map(entry=>entry.trim()).filter(entry=>entry.length>0).join(" ");if(query.length===0)throw new PmCliError("Search query must not be empty",EXIT_CODE.USAGE);return query}function normalizeActivityOptions(options){const readActivityString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,target)),normalized={id:readActivityString("id"),op:readActivityString("op"),author:readActivityString("author"),from:readActivityString("from"),to:readActivityString("to"),limit:readActivityString("limit"),compact:options.full===!0||options.provenance===!0?!1:options.compact===!0||options.raw===!0?!0:void 0,...options.raw===!0||options.compact===!0||options.full===!0?{raw:!0}:{},unbounded:optionTrue(options,"unbounded"),provenance:optionTrue(options,"provenance"),provenanceSummary:optionTrue(options,"provenanceSummary"),harness:Array.isArray(options.harness)?options.harness:void 0,agentInstance:Array.isArray(options.agentInstance)?options.agentInstance:void 0,provenanceFilter:Array.isArray(options.provenanceFilter)?options.provenanceFilter:void 0};return Object.fromEntries(Object.entries(normalized).filter(([,value])=>value!==void 0))}const ACTIVITY_STREAM_ENABLED_VALUES=new Set(["","rows","ndjson","jsonl","true","1","yes","on"]),ACTIVITY_STREAM_DISABLED_VALUES=new Set(["false","off","none","0"]);function resolveActivityStreamMode(raw){if(raw===!0)return!0;if(raw===!1||raw===void 0||raw===null)return!1;if(typeof raw=="string"){const normalized=raw.trim().toLowerCase();if(ACTIVITY_STREAM_ENABLED_VALUES.has(normalized))return!0;if(ACTIVITY_STREAM_DISABLED_VALUES.has(normalized))return!1}throw new PmCliError("Activity --stream accepts rows|ndjson|jsonl (or no value)",EXIT_CODE.USAGE)}function normalizeContextOptions(options){const readContextString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,target)),readContextStringOrNumber=target=>readStringOrFiniteNumberFromCommanderOptions(options,resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,target)),sectionRaw=options.section,section=Array.isArray(sectionRaw)?sectionRaw.filter(v=>typeof v=="string"&&v.trim().length>0):typeof sectionRaw=="string"&&sectionRaw.trim().length>0?[sectionRaw]:void 0,normalized={date:readContextString("date"),from:readContextString("from"),to:readContextString("to"),past:options.past===!0?!0:void 0,type:readContextString("type"),tag:readContextString("tag"),priority:readContextString("priority"),assignee:readContextString("assignee"),assigneeFilter:readContextString("assigneeFilter"),sprint:readContextString("sprint"),release:readContextString("release"),parent:readContextString("parent"),limit:readContextString("limit"),format:readContextString("format"),depth:readContextString("depth"),fields:readContextString("fields"),section:section&&section.length>0?section:void 0,activityLimit:readContextString("activityLimit"),staleThreshold:readContextString("staleThreshold"),tokenBudget:readContextStringOrNumber("tokenBudget"),noExtensionHealth:options.extensionHealth===!1?!0:void 0,noTags:options.tags===!1?!0:void 0};for(const[key,value]of Object.entries(options))Object.hasOwn(normalized,key)||(normalized[key]=value);return normalized}function normalizeNextOptions(options){const readNextString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS,target)),readNextStringOrNumber=target=>readStringOrFiniteNumberFromCommanderOptions(options,resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS,target)),normalized={type:readNextString("type"),tag:readNextString("tag"),priority:readNextStringOrNumber("priority"),assignee:readNextString("assignee"),assigneeFilter:readNextString("assigneeFilter"),sprint:readNextString("sprint"),release:readNextString("release"),parent:readNextString("parent"),limit:readNextString("limit"),blockedLimit:readNextString("blockedLimit"),readyOnly:options.readyOnly===!0||options.ready_only===!0?!0:void 0,format:readNextString("format"),tokenBudget:readNextStringOrNumber("tokenBudget")};for(const[key,value]of Object.entries(options))Object.hasOwn(normalized,key)||(normalized[key]=value);return normalized}function collectMutationItemIds(result){if(!result||typeof result!="object")return[];const record=result,ids=new Set,pushId=value=>{if(typeof value!="string")return;const normalized=value.trim();normalized.length!==0&&ids.add(normalized)};pushId(record.id);const item=record.item;item&&typeof item=="object"&&pushId(item.id);const explicitIds=record.ids;if(Array.isArray(explicitIds))for(const candidate of explicitIds)pushId(candidate);const items=record.items;if(Array.isArray(items))for(const candidate of items)!candidate||typeof candidate!="object"||pushId(candidate.id);return[...ids].sort((left,right)=>left.localeCompare(right))}async function invalidateSearchCachesForMutation(globalOptions,result){const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),refreshResult=await refreshSearchArtifactsForMutation(pmRoot,collectMutationItemIds(result),{background:!shouldRunSearchRefreshInForeground()});globalOptions.profile&&refreshResult.warnings.length>0&&printError(`profile:search_refresh_warnings=${formatHookWarnings(refreshResult.warnings)}`)}const _testOnly={collectMutationItemIds};export{_testOnly,addHiddenOption,addHiddenOptions,applyActiveCommandResultService,applyDefaultOutputFormat,buildBackgroundTestAllCommandArgs,buildBackgroundTestCommandArgs,clearResolvedGlobalOptions,collect,extractUpdateManyMutationOptionSource,formatHookWarnings,getCommandPath,getGlobalOptions,invalidateSearchCachesForMutation,normalizeActivityOptions,normalizeAggregateOptions,normalizeContextOptions,normalizeCreateOptions,normalizeListOptions,normalizeNextOptions,normalizeSearchKeywordsInput,normalizeSearchOptions,normalizeUpdateOptions,printActivityJsonStream,printError,printListJsonStream,printResult,readOptionString,resolveActivityStreamMode,setActiveCommandResult,setResolvedGlobalOptions,syncCommanderActionOptions,writeStdout};
+`)}function normalizeSearchOptions(options){const readSearchString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,target)),readSearchStringOrNumber=target=>{const candidate=readFirstValueFromCommanderOptions(options,resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,target));if(typeof candidate=="string"||typeof candidate=="number"&&Number.isFinite(candidate))return candidate},fields=readSearchString("fields"),compactRequested=options.compact===!0,fullRequested=options.full===!0,defaultCompact=!compactRequested&&!fullRequested&&fields===void 0,normalized={mode:options.semantic===!0?"semantic":options.hybrid===!0?"hybrid":readSearchString("mode"),matchMode:readSearchString("matchMode"),minScore:readSearchStringOrNumber("minScore"),count:optionTrue(options,"count"),semanticWeight:readSearchStringOrNumber("semanticWeight"),includeLinked:optionTrue(options,"includeLinked"),titleExact:optionTrue(options,"titleExact"),phraseExact:optionTrue(options,"phraseExact"),highlight:optionTrue(options,"highlight"),status:readSearchString("status"),type:readSearchString("type"),tag:readSearchString("tag"),priority:readSearchString("priority"),deadlineBefore:readSearchString("deadlineBefore"),deadlineAfter:readSearchString("deadlineAfter"),updatedAfter:readSearchString("updatedAfter"),updatedBefore:readSearchString("updatedBefore"),createdAfter:readSearchString("createdAfter"),createdBefore:readSearchString("createdBefore"),assignee:readSearchString("assignee"),sprint:readSearchString("sprint"),release:readSearchString("release"),parent:readSearchString("parent"),limit:readSearchString("limit"),fields,compact:compactRequested||defaultCompact?!0:void 0,full:optionTrue(options,"full"),...readSelectionFilterOptionFields(options)};return copyUnknownOptions(normalized,options),normalized}function normalizeSearchKeywordsInput(keywords){const query=keywords.map(entry=>entry.trim()).filter(entry=>entry.length>0).join(" ");if(query.length===0)throw new PmCliError("Search query must not be empty",EXIT_CODE.USAGE);return query}function normalizeActivityOptions(options){const readActivityString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,target)),normalized={id:readActivityString("id"),op:readActivityString("op"),author:readActivityString("author"),from:readActivityString("from"),to:readActivityString("to"),limit:readActivityString("limit"),after:readActivityString("after"),compact:options.full===!0||options.provenance===!0?!1:options.compact===!0||options.raw===!0?!0:void 0,...options.raw===!0||options.compact===!0||options.full===!0?{raw:!0}:{},unbounded:optionTrue(options,"unbounded"),provenance:optionTrue(options,"provenance"),provenanceSummary:optionTrue(options,"provenanceSummary"),harness:Array.isArray(options.harness)?options.harness:void 0,agentInstance:Array.isArray(options.agentInstance)?options.agentInstance:void 0,provenanceFilter:Array.isArray(options.provenanceFilter)?options.provenanceFilter:void 0};return Object.fromEntries(Object.entries(normalized).filter(([,value])=>value!==void 0))}const ACTIVITY_STREAM_ENABLED_VALUES=new Set(["","rows","ndjson","jsonl","true","1","yes","on"]),ACTIVITY_STREAM_DISABLED_VALUES=new Set(["false","off","none","0"]);function resolveActivityStreamMode(raw){if(raw===!0)return!0;if(raw===!1||raw===void 0||raw===null)return!1;if(typeof raw=="string"){const normalized=raw.trim().toLowerCase();if(ACTIVITY_STREAM_ENABLED_VALUES.has(normalized))return!0;if(ACTIVITY_STREAM_DISABLED_VALUES.has(normalized))return!1}throw new PmCliError("Activity --stream accepts rows|ndjson|jsonl (or no value)",EXIT_CODE.USAGE)}function normalizeContextOptions(options){const readContextString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,target)),readContextStringOrNumber=target=>readStringOrFiniteNumberFromCommanderOptions(options,resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,target)),sectionRaw=options.section,section=Array.isArray(sectionRaw)?sectionRaw.filter(v=>typeof v=="string"&&v.trim().length>0):typeof sectionRaw=="string"&&sectionRaw.trim().length>0?[sectionRaw]:void 0,normalized={date:readContextString("date"),from:readContextString("from"),to:readContextString("to"),past:options.past===!0?!0:void 0,type:readContextString("type"),tag:readContextString("tag"),priority:readContextString("priority"),assignee:readContextString("assignee"),assigneeFilter:readContextString("assigneeFilter"),sprint:readContextString("sprint"),release:readContextString("release"),parent:readContextString("parent"),limit:readContextString("limit"),format:readContextString("format"),depth:readContextString("depth"),fields:readContextString("fields"),section:section&&section.length>0?section:void 0,activityLimit:readContextString("activityLimit"),staleThreshold:readContextString("staleThreshold"),tokenBudget:readContextStringOrNumber("tokenBudget"),noExtensionHealth:options.extensionHealth===!1?!0:void 0,noTags:options.tags===!1?!0:void 0};for(const[key,value]of Object.entries(options))Object.hasOwn(normalized,key)||(normalized[key]=value);return normalized}function normalizeNextOptions(options){const readNextString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS,target)),readNextStringOrNumber=target=>readStringOrFiniteNumberFromCommanderOptions(options,resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS,target)),normalized={type:readNextString("type"),tag:readNextString("tag"),priority:readNextStringOrNumber("priority"),assignee:readNextString("assignee"),assigneeFilter:readNextString("assigneeFilter"),sprint:readNextString("sprint"),release:readNextString("release"),parent:readNextString("parent"),limit:readNextString("limit"),blockedLimit:readNextString("blockedLimit"),readyOnly:options.readyOnly===!0||options.ready_only===!0?!0:void 0,format:readNextString("format"),tokenBudget:readNextStringOrNumber("tokenBudget")};for(const[key,value]of Object.entries(options))Object.hasOwn(normalized,key)||(normalized[key]=value);return normalized}function collectMutationItemIds(result){if(!result||typeof result!="object")return[];const record=result,ids=new Set,pushId=value=>{if(typeof value!="string")return;const normalized=value.trim();normalized.length!==0&&ids.add(normalized)};pushId(record.id);const item=record.item;item&&typeof item=="object"&&pushId(item.id);const explicitIds=record.ids;if(Array.isArray(explicitIds))for(const candidate of explicitIds)pushId(candidate);const items=record.items;if(Array.isArray(items))for(const candidate of items)!candidate||typeof candidate!="object"||pushId(candidate.id);return[...ids].sort((left,right)=>left.localeCompare(right))}async function invalidateSearchCachesForMutation(globalOptions,result){const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),refreshResult=await refreshSearchArtifactsForMutation(pmRoot,collectMutationItemIds(result),{background:!shouldRunSearchRefreshInForeground()});globalOptions.profile&&refreshResult.warnings.length>0&&printError(`profile:search_refresh_warnings=${formatHookWarnings(refreshResult.warnings)}`)}const _testOnly={collectMutationItemIds};export{_testOnly,addHiddenOption,addHiddenOptions,applyActiveCommandResultService,applyDefaultOutputFormat,buildBackgroundTestAllCommandArgs,buildBackgroundTestCommandArgs,clearResolvedGlobalOptions,collect,extractUpdateManyMutationOptionSource,formatHookWarnings,getCommandPath,getGlobalOptions,invalidateSearchCachesForMutation,normalizeActivityOptions,normalizeAggregateOptions,normalizeContextOptions,normalizeCreateOptions,normalizeListOptions,normalizeNextOptions,normalizeSearchKeywordsInput,normalizeSearchOptions,normalizeUpdateOptions,printActivityJsonStream,printError,printListJsonStream,printResult,readOptionString,resolveActivityStreamMode,setActiveCommandResult,setResolvedGlobalOptions,syncCommanderActionOptions,writeStdout};
 //# sourceMappingURL=registration-helpers.js.map

package/dist/sdk/cli-contracts/runtime-contracts.js CHANGED Viewed

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0e712e06-ae64-59c2-aea5-2cba11c55447")}catch{}})();import{PM_TOOL_PARAMETER_PROPERTIES}from"./tool-parameter-tables.js";import{resolveExtensionFlagValueContract,resolveExtensionLongFlagName,EXIT_CODE,SETTINGS_DEFAULTS,PmCliError,activateExtensions,getActiveExtensionRegistrations,loadExtensions,pathExists,commandOptionFlagLabel,resolveCommandOptionPolicyState,resolveItemTypeRegistry,resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry,getSettingsPath,resolvePmRoot,readSettings}from"../runtime-primitives.js";import{PM_HISTORY_OPERATION_CONTRACT}from"../../core/history/operation-contract.js";import{buildMcpToolContracts}from"../../mcp/tool-definitions.js";import{ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,ACTIVITY_FLAG_CONTRACTS,AGGREGATE_FLAG_CONTRACTS,ASSURANCE_FLAG_CONTRACTS,APPEND_FLAG_CONTRACTS,CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS,CALENDAR_FLAG_CONTRACTS,CLAIM_FLAG_CONTRACTS,CLOSE_TASK_FLAG_CONTRACTS,COMMENTS_FLAG_CONTRACTS,CLOSE_FLAG_CONTRACTS,CLOSE_MANY_FLAG_CONTRACTS,COMPLETION_FLAG_CONTRACTS,CONFIG_FLAG_CONTRACTS,CONTRACTS_FLAG_CONTRACTS,COPY_FLAG_CONTRACTS,CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,CONTEXT_FLAG_CONTRACTS,CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,CREATE_COMMANDER_STRING_OPTION_CONTRACTS,CREATE_FLAG_CONTRACTS,DELETE_FLAG_CONTRACTS,DEPS_FLAG_CONTRACTS,GRAPH_FLAG_CONTRACTS,DOCS_FLAG_CONTRACTS,EXTENSION_ACTIVATE_FLAG_CONTRACTS,EXTENSION_ADOPT_ALL_FLAG_CONTRACTS,EXTENSION_ADOPT_FLAG_CONTRACTS,EXTENSION_CATALOG_FLAG_CONTRACTS,EXTENSION_DEACTIVATE_FLAG_CONTRACTS,EXTENSION_DESCRIBE_FLAG_CONTRACTS,EXTENSION_DOCTOR_FLAG_CONTRACTS,EXTENSION_EXPLORE_FLAG_CONTRACTS,EXTENSION_FLAG_CONTRACTS,EXTENSION_INIT_FLAG_CONTRACTS,EXTENSION_INSTALL_FLAG_CONTRACTS,EXTENSION_MANAGE_FLAG_CONTRACTS,EXTENSION_MIGRATE_FLAG_CONTRACTS,EXTENSION_RELOAD_FLAG_CONTRACTS,EXTENSION_UNINSTALL_FLAG_CONTRACTS,FILES_FLAG_CONTRACTS,FOCUS_FLAG_CONTRACTS,GC_FLAG_CONTRACTS,GET_FLAG_CONTRACTS,GUIDE_FLAG_CONTRACTS,GLOBAL_FLAG_CONTRACTS,HEALTH_FLAG_CONTRACTS,HISTORY_FLAG_CONTRACTS,HISTORY_COMPACT_FLAG_CONTRACTS,HISTORY_REDACT_FLAG_CONTRACTS,HISTORY_REPAIR_FLAG_CONTRACTS,HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS,INSTALL_FLAG_CONTRACTS,INIT_FLAG_CONTRACTS,ITEM_COMPLETE_FLAG_CONTRACTS,ITEM_MUTATE_FLAG_CONTRACTS,ITEM_REOPEN_FLAG_CONTRACTS,LEARNINGS_FLAG_CONTRACTS,LIST_COMMANDER_STRING_OPTION_CONTRACTS,LIST_FILTER_FLAG_CONTRACTS,MERGE_FLAG_CONTRACTS,NOTES_FLAG_CONTRACTS,PACKAGE_FLAG_CONTRACTS,PACKAGE_INIT_FLAG_CONTRACTS,PM_EXTENSION_CAPABILITY_CONTRACTS,PM_EXTENSION_POLICY_MODE_CONTRACTS,PM_EXTENSION_POLICY_SURFACE_CONTRACTS,PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS,PM_EXTENSION_SERVICE_NAME_CONTRACTS,PM_EXTENSION_TRUST_MODE_CONTRACTS,PM_OUTPUT_DEGRADATION_STEPS,PLAN_FLAG_CONTRACTS,PM_CORE_COMMAND_NAMES,PM_DEPRECATED_TOOL_ACTIONS,PM_TOOL_ACTIONS,PM_TOOL_PARAMETERS_SCHEMA,REINDEX_FLAG_CONTRACTS,RELEASE_FLAG_CONTRACTS,RESTORE_FLAG_CONTRACTS,SCHEMA_FLAG_CONTRACTS,PROFILE_FLAG_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,EVAL_FLAG_CONTRACTS,EVENTS_FLAG_CONTRACTS,WORKSPACE_FLAG_CONTRACTS,NEXT_FLAG_CONTRACTS,SEARCH_FLAG_CONTRACTS,STATS_FLAG_CONTRACTS,DUPLICATES_FLAG_CONTRACTS,START_TASK_FLAG_CONTRACTS,PAUSE_TASK_FLAG_CONTRACTS,TELEMETRY_FLAG_CONTRACTS,TEST_ALL_FLAG_CONTRACTS,TEST_FLAG_CONTRACTS,TEST_RUNS_FLAG_CONTRACTS,UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,UPDATE_FLAG_CONTRACTS,UPDATE_MANY_FLAG_CONTRACTS,UPGRADE_FLAG_CONTRACTS,VALIDATE_FLAG_CONTRACTS,compactFlagAliasContracts,SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,PM_COMMAND_ALIAS_CONTRACTS,PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS,resolvePmCommandOutputBudget}from"../cli-contracts.js";import{PM_NAMESPACED_COMMAND_ALIASES,resolvePmCommandOperation}from"./command-aliases.js";import{HISTORY_ATTEST_FLAG_CONTRACTS,PM_POSITIONAL_ACTION_FLAG_CONTRACTS,resolveSubcommandFlagContractsForCommand}from"./flag-contracts.js";import{GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES,GOVERNANCE_CREATE_MODE_DEFAULT_VALUES,GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES,GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES}from"../../types.js";import{BRIEF_LIST_FIELDS,DEFAULT_COMPACT_LIST_FIELDS,LIST_COMMAND_DEFAULT_PROJECTIONS}from"../query/list.js";import{getActiveContextIntentContracts}from"../context-intent-contracts.js";import{readOutputIncludeModeOptions,resolveReadOutputSurface,PM_READ_OUTPUT_SURFACE_CONTRACTS}from"../read-output-contracts.js";import{enrichCliFlagInvocationContracts}from"../flag-invocation-contracts.js";import{resolvePmCommandVisibilityTier}from"../agent-capability-contracts.js";import{PM_ERROR_CODE_CATALOG}from"../generated-error-code-catalog.js";import{resolvePmCommandOutputEnvelope}from"../output-contracts.js";import{PM_COMMAND_EXIT_OUTCOME_CONTRACTS,resolvePmCommandExitContract}from"./command-exit-contracts.js";import{BUILTIN_RELATIONSHIP_KINDS}from"../relationship-kinds/contract.js";import{ASSURANCE_GATE_TRIGGERS,ASSURANCE_MEASUREMENT_SOURCE_KINDS}from"../governance/assurance.js";import{PM_CLI_GRAMMAR_CONTRACT,PM_COMMAND_DESTINATION_CONTRACTS,PM_COMMAND_POSITIONAL_CONTRACTS,PM_POSITIONAL_ACTION_CONTRACTS,positionalShapeKey,resolvePmCommandPositionalContract}from"./grammar-contracts.js";const AGENT_BOOTSTRAP_FLAGS=new Map([["claim",["--if-available","--next","--type","--priority","--token-budget","--explain-ranking"]],["close",["--reason","--validate-close","--resolution","--expected-result","--actual-result","--message"]],["context",["--limit","--after","--depth","--section","--token-budget","--explain-ranking"]],["contracts",["--command","--flags-only","--summary","--runtime-only","--availability-only","--full"]],["create",["--title","--type","--status","--priority","--dep","--comment"]],["get",["--full","--depth","--fields","--tree","--tree-depth","--format"]],["health",["--check-only","--summary","--brief","--check-telemetry","--strict-exit","--full"]],["list",["--status","--type","--limit","--after","--brief","--fields"]],["next",["--limit","--blocked-limit","--ready-only","--token-budget","--explain-ranking","--format"]],["search",["--mode","--status","--type","--limit","--after","--fields"]],["update",["--status","--message","--dep","--comment","--file","--test"]],["validate",["--check-resolution","--check-history-drift","--check-storage-integrity","--counts","--strict-exit","--fix-hints"]]]),AGENT_BOUNDED_FLAG_PRIORITY=["--limit","--after","--offset","--token-budget","--brief","--summary","--compact","--fields","--full","--format","--since","--until"],LIST_COMMAND_NAMES=new Set(["list","list-all","list-draft","list-open","list-in-progress","list-blocked","list-closed","list-canceled"]),PACKAGE_OWNED_ACTIONS=new Set(["calendar","guide","reindex","completion","test-runs-list","test-runs-status","test-runs-logs","test-runs-stop","test-runs-resume","templates-list","templates-save","templates-show"]),PACKAGE_OWNED_COMMANDS=new Set(["meet","event","remind","search-advanced","dedupe-audit","dedupe-merge","comments-audit","cal","calendar","completion","completion-statuses","completion-tags","completion-types","guide","reindex","normalize","templates","templates list","templates save","templates show","test-runs","test-runs list","test-runs status","test-runs logs","test-runs stop","test-runs resume"]),PACKAGE_OWNED_COMMAND_INSTALL_HINTS=new Map([["meet","calendar"],["event","calendar"],["remind","calendar"],["search-advanced","search-advanced"],["dedupe-audit","governance-audit"],["dedupe-merge","governance-audit"],["comments-audit","governance-audit"],["cal","calendar"],["calendar","calendar"],["completion","guide-shell"],["completion-statuses","guide-shell"],["completion-tags","guide-shell"],["completion-types","guide-shell"],["guide","guide-shell"],["reindex","search-advanced"],["normalize","governance-audit"],["templates","templates"],["templates list","templates"],["templates save","templates"],["templates show","templates"],["test-runs","linked-test-adapters"],["test-runs list","linked-test-adapters"],["test-runs status","linked-test-adapters"],["test-runs logs","linked-test-adapters"],["test-runs stop","linked-test-adapters"],["test-runs resume","linked-test-adapters"]]),PACKAGE_OWNED_ACTION_COMMAND_PATHS=new Map([["calendar","calendar|cal"],["guide","guide"],["reindex","reindex"],["completion","completion"],["test-runs-list","test-runs|test-runs list"],["test-runs-status","test-runs status"],["test-runs-logs","test-runs logs"],["test-runs-stop","test-runs stop"],["test-runs-resume","test-runs resume"],["templates-list","templates|templates list"],["templates-save","templates save"],["templates-show","templates show"]]),PACKAGE_OWNED_COMMAND_ACTIONS=new Map([...PACKAGE_OWNED_ACTION_COMMAND_PATHS.entries()].flatMap(([action,commandPaths])=>splitCommandPathAliases(commandPaths).map(commandPath=>[commandPath,action]))),CANONICAL_COMMAND_ALIASES=[{canonical:"context",aliases:["ctx"]},{canonical:"package",aliases:["extension","packages"]}],COMMAND_ALIAS_TO_CANONICAL=new Map(CANONICAL_COMMAND_ALIASES.flatMap(entry=>entry.aliases.map(alias=>[alias,entry.canonical]))),COMMAND_NAMESPACE_DISPLAY_LIMIT=10,COMMAND_NAMESPACE_FALLBACK_LIMIT=20,COMMAND_INTENTS=new Map([["activity","Read activity."],["aggregate","Group counts."],["append","Append body."],["assurance","Evaluate assurance."],["assurance derive","Derive checks."],["assurance risk","Select checks for changes."],["assurance lineages","Measure recurrence coverage."],["beads","Manage Beads interoperability."],["cal","Manage calendar integration."],["calendar","Manage calendar integration."],["changelog","Generate changelog output."],["claim","Claim work."],["close","Close work."],["close-many","Close matching work."],["close-task","Close task work."],["command-kit","Inspect command authoring primitives."],["comments","Manage comments."],["comments-audit","Audit comment governance."],["completion","Generate shell completions."],["config","Manage settings."],["context","Build context."],["contracts","Inspect contracts."],["copy","Copy work."],["create","Create work."],["dedupe-audit","Audit duplicate work."],["dedupe-merge","Merge duplicate work."],["delete","Delete work."],["deps","Manage deps."],["duplicates","Find duplicate clusters."],["docs","Link docs."],["eval","Run evaluations."],["event","Manage events."],["events","Read events."],["files","Link files."],["focus","Manage focus."],["gc","Clean caches."],["get","Read item."],["graph","Query graph."],["guide","Show user guides."],["health","Check health."],["help","Show help."],["history","Inspect history."],["init","Initialize workspace."],["install","Install packages."],["item","Mutate items."],["learnings","Manage learnings."],["list","List work."],["list-all","List work across every status."],["list-blocked","List blocked work."],["list-canceled","List canceled work."],["list-closed","List closed work."],["list-draft","List draft work."],["list-in-progress","List in-progress work."],["list-open","List open work."],["meet","Record meeting context."],["merge","Manage tracker merges."],["next","Pick next work."],["notes","Manage notes."],["normalize","Normalize tracker data."],["ops","Run operations."],["package","Manage packages."],["packages","Manage packages."],["pause-task","Pause task work."],["plan","Manage plans."],["profile","Manage profiles."],["reindex","Refresh search index."],["release","Release claim."],["remind","Manage reminders."],["restore","Restore history."],["schema","Customize schema."],["search","Search work."],["search-advanced","Run advanced search."],["start-task","Start task work."],["stats","Show stats."],["telemetry","Manage telemetry."],["templates","Manage work templates."],["test","Run linked tests."],["test-all","Run all linked tests."],["test-runs","Inspect background test runs."],["todos","Manage source-code todos."],["twin","Manage repository twins."],["update","Update work."],["update-many","Update matching work."],["upgrade","Upgrade packages."],["validate","Validate data."],["vcs","Inspect version-control context."],["workspace","Manage workspaces."],["history-author-acknowledge","Acknowledge reviewed history authors."],["history-compact","Compact history."],["history-attest","Export or verify detached history proof."],["history-redact","Redact sensitive history values."],["history-repair","Repair history integrity."]]),EXTENSION_LIFECYCLE_FLAG_CONTRACTS=[["init",EXTENSION_INIT_FLAG_CONTRACTS],["install",EXTENSION_INSTALL_FLAG_CONTRACTS],["uninstall",EXTENSION_UNINSTALL_FLAG_CONTRACTS],["explore",EXTENSION_EXPLORE_FLAG_CONTRACTS],["manage",EXTENSION_MANAGE_FLAG_CONTRACTS],["describe",EXTENSION_DESCRIBE_FLAG_CONTRACTS],["reload",EXTENSION_RELOAD_FLAG_CONTRACTS],["doctor",EXTENSION_DOCTOR_FLAG_CONTRACTS],["catalog",EXTENSION_CATALOG_FLAG_CONTRACTS],["adopt",EXTENSION_ADOPT_FLAG_CONTRACTS],["adopt-all",EXTENSION_ADOPT_ALL_FLAG_CONTRACTS],["activate",EXTENSION_ACTIVATE_FLAG_CONTRACTS],["deactivate",EXTENSION_DEACTIVATE_FLAG_CONTRACTS],["migrate",EXTENSION_MIGRATE_FLAG_CONTRACTS]],PACKAGE_LIFECYCLE_FLAG_CONTRACTS=[...EXTENSION_LIFECYCLE_FLAG_CONTRACTS.map(([subcommand,flags])=>subcommand==="init"?[subcommand,PACKAGE_INIT_FLAG_CONTRACTS]:[subcommand,flags]),["upgrade",UPGRADE_FLAG_CONTRACTS]],CORE_COMMAND_FLAG_CONTRACT_ENTRIES=[...EXTENSION_LIFECYCLE_FLAG_CONTRACTS.map(([subcommand,flags])=>[`extension ${subcommand}`,flags]),...PACKAGE_LIFECYCLE_FLAG_CONTRACTS.flatMap(([subcommand,flags])=>[[`package ${subcommand}`,flags],[`packages ${subcommand}`,flags]]),["init",INIT_FLAG_CONTRACTS],["config",CONFIG_FLAG_CONTRACTS],["extension",EXTENSION_FLAG_CONTRACTS],["package",PACKAGE_FLAG_CONTRACTS],["packages",PACKAGE_FLAG_CONTRACTS],["install",INSTALL_FLAG_CONTRACTS],["create",CREATE_FLAG_CONTRACTS],["item mutate",ITEM_MUTATE_FLAG_CONTRACTS],["item complete",ITEM_COMPLETE_FLAG_CONTRACTS],["item reopen",ITEM_REOPEN_FLAG_CONTRACTS],["copy",COPY_FLAG_CONTRACTS],["focus",FOCUS_FLAG_CONTRACTS],["update",UPDATE_FLAG_CONTRACTS],["update-many",UPDATE_MANY_FLAG_CONTRACTS],["upgrade",UPGRADE_FLAG_CONTRACTS],["calendar",CALENDAR_FLAG_CONTRACTS],["cal",CALENDAR_FLAG_CONTRACTS],["context",CONTEXT_FLAG_CONTRACTS],["ctx",CONTEXT_FLAG_CONTRACTS],["get",GET_FLAG_CONTRACTS],["search",SEARCH_FLAG_CONTRACTS],["eval",EVAL_FLAG_CONTRACTS],["events",EVENTS_FLAG_CONTRACTS],["workspace",WORKSPACE_FLAG_CONTRACTS],["workspace position",[]],["workspace snapshot",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot create",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot list",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot inspect",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot restore",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot delete",WORKSPACE_FLAG_CONTRACTS],["next",NEXT_FLAG_CONTRACTS],["aggregate",AGGREGATE_FLAG_CONTRACTS],["deps",DEPS_FLAG_CONTRACTS],["graph",GRAPH_FLAG_CONTRACTS],["guide",GUIDE_FLAG_CONTRACTS],["reindex",REINDEX_FLAG_CONTRACTS],["history",HISTORY_FLAG_CONTRACTS],["history-compact",HISTORY_COMPACT_FLAG_CONTRACTS],["history-attest",HISTORY_ATTEST_FLAG_CONTRACTS],["history-redact",HISTORY_REDACT_FLAG_CONTRACTS],["history-repair",HISTORY_REPAIR_FLAG_CONTRACTS],["history-author-acknowledge",HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS],["merge",MERGE_FLAG_CONTRACTS],["schema",SCHEMA_FLAG_CONTRACTS],["profile",PROFILE_FLAG_CONTRACTS],["plan",PLAN_FLAG_CONTRACTS],["restore",RESTORE_FLAG_CONTRACTS],["delete",DELETE_FLAG_CONTRACTS],["close",CLOSE_FLAG_CONTRACTS],["close-many",CLOSE_MANY_FLAG_CONTRACTS],["append",APPEND_FLAG_CONTRACTS],["claim",CLAIM_FLAG_CONTRACTS],["release",RELEASE_FLAG_CONTRACTS],["start-task",START_TASK_FLAG_CONTRACTS],["pause-task",PAUSE_TASK_FLAG_CONTRACTS],["close-task",CLOSE_TASK_FLAG_CONTRACTS],["comments",COMMENTS_FLAG_CONTRACTS],["notes",NOTES_FLAG_CONTRACTS],["learnings",LEARNINGS_FLAG_CONTRACTS],["files",FILES_FLAG_CONTRACTS],["docs",DOCS_FLAG_CONTRACTS],["test",TEST_FLAG_CONTRACTS],["test-runs-worker",[]],["test-all",TEST_ALL_FLAG_CONTRACTS],["telemetry",TELEMETRY_FLAG_CONTRACTS],["test-runs",TEST_RUNS_FLAG_CONTRACTS],["gc",GC_FLAG_CONTRACTS],["stats",STATS_FLAG_CONTRACTS],["ops",[]],["duplicates",DUPLICATES_FLAG_CONTRACTS],["validate",VALIDATE_FLAG_CONTRACTS],["health",HEALTH_FLAG_CONTRACTS],["assurance",ASSURANCE_FLAG_CONTRACTS],...PM_POSITIONAL_ACTION_FLAG_CONTRACTS,["contracts",CONTRACTS_FLAG_CONTRACTS],["completion",COMPLETION_FLAG_CONTRACTS],["activity",ACTIVITY_FLAG_CONTRACTS],...[...LIST_COMMAND_NAMES].map(command=>[command,LIST_FILTER_FLAG_CONTRACTS])],CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND=new Map(CORE_COMMAND_FLAG_CONTRACT_ENTRIES);for(const{alias,canonical}of PM_NAMESPACED_COMMAND_ALIASES){const flags=CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND.get(alias);flags!==void 0&&CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND.set(canonical,flags)}function packageOwnedActionForCommand(command){return PACKAGE_OWNED_COMMAND_ACTIONS.get(command)||(command.startsWith("test-runs ")?`test-runs-${command.slice(10)}`:command.startsWith("templates ")?`templates-${command.slice(10)}`:command)}function resolveActionCommandPath(action){const historyAlias=PM_NAMESPACED_COMMAND_ALIASES.find(contract=>contract.alias===action);return historyAlias?`${historyAlias.canonical}|${historyAlias.alias}`:PM_CORE_COMMAND_NAMES.includes(action)?normalizeCommandPath(action):action.startsWith("extension-")?normalizeCommandPath(`extension ${action.slice(10)}`):action.startsWith("package-")?normalizeCommandPath(`package ${action.slice(8)}`):action.startsWith("item-")?normalizeCommandPath(`item ${action.slice(5)}`):action.startsWith("test-runs-")?normalizeCommandPath(`test-runs ${action.slice(10)}`):action.startsWith("templates-")?normalizeCommandPath(`templates ${action.slice(10)}`):PACKAGE_OWNED_ACTIONS.has(action)?PACKAGE_OWNED_ACTION_COMMAND_PATHS.get(action)??normalizeCommandPath(action):null}function actionDescriptorMatchesSelectedCommand(descriptor,selectedCommand){const historyOperation=resolvePmCommandOperation(selectedCommand);return historyOperation!==selectedCommand||PM_NAMESPACED_COMMAND_ALIASES.some(entry=>entry.alias===selectedCommand)?descriptor.action===historyOperation:descriptor.command_path===null?!1:splitCommandPathAliases(descriptor.command_path).some(commandPath=>commandPath===selectedCommand?!0:commandPath.startsWith(`${selectedCommand} `)||selectedCommand.startsWith(`${commandPath} `))}function splitCommandPathAliases(commandPath){return commandPath.split("|").map(entry=>normalizeCommandPath(entry)).filter(entry=>entry.length>0)}function resolveScopedCommandsFromActionDescriptors(descriptors,commandCatalog){const commandSet=new Set(commandCatalog),scoped=new Set;for(const descriptor of descriptors)if(descriptor.command_path)for(const commandPath of splitCommandPathAliases(descriptor.command_path)){const tokens=commandPath.split(" ").filter(entry=>entry.length>0);if(tokens.length!==0)for(let end=tokens.length;end>0;end-=1){const candidate=tokens.slice(0,end).join(" ");if(commandSet.has(candidate)){scoped.add(candidate);break}}}return[...scoped].sort((left,right)=>left.localeCompare(right))}function normalizeToken(value){if(typeof value!="string")return;const trimmed=value.trim().toLowerCase();return trimmed.length>0?trimmed:void 0}function extractActionBranches(schema){const oneOf=schema.oneOf;return Array.isArray(oneOf)?oneOf.filter(entry=>typeof entry=="object"&&entry!==null):[]}function filterSchemaByAction(schema,action){if(!action)return{...schema};const filtered=extractActionBranches(schema).filter(entry=>{const properties=entry.properties;if(typeof properties!="object"||properties===null)return!1;const actionProperty=properties.action;return typeof actionProperty!="object"||actionProperty===null?!1:actionProperty.const===action});return{...schema,oneOf:filtered}}function filterSchemaByActions(schema,actions){const filtered=extractActionBranches(schema).filter(entry=>{const properties=entry.properties;if(typeof properties!="object"||properties===null)return!1;const actionProperty=properties.action;if(typeof actionProperty!="object"||actionProperty===null)return!1;const actionConst=actionProperty.const;return typeof actionConst=="string"&&actions.has(actionConst)});return{...schema,oneOf:filtered}}function normalizeCommandPath(value){return value.trim().toLowerCase().split(/\s+/).filter(entry=>entry.length>0).join(" ")}function normalizeActionNameFromCommand(commandPath){return commandPath.replace(/\s+/g,"-")}function toOptionalTrimmedString(value){if(typeof value!="string")return null;const trimmed=value.trim();return trimmed.length>0?trimmed:null}function normalizeStringList(values){if(!Array.isArray(values))return[];const normalized=[],seen=new Set;for(const value of values){const trimmed=toOptionalTrimmedString(value);!trimmed||seen.has(trimmed)||(seen.add(trimmed),normalized.push(trimmed))}return normalized}function assignExtensionFlagBoolean(contract,key,enabled){enabled&&(contract[key]=!0)}function normalizeExtensionFlagName(value,kind){if(value==null)return null;if(typeof value!="string")throw new TypeError("Expected string for extension flag name.");const trimmed=value.trim();return trimmed.length===0?null:kind==="long"?trimmed.startsWith("--")&&trimmed.length>2?resolveExtensionLongFlagName(trimmed):null:trimmed.startsWith("-")&&!trimmed.startsWith("--")&&trimmed.length>1?trimmed:null}function toExtensionFlagContract(definition){const normalizedLong=normalizeExtensionFlagName(definition.long,"long"),normalizedShort=normalizeExtensionFlagName(definition.short,"short"),flag=normalizedLong??normalizedShort;if(!flag)return null;const contract={flag};normalizedShort&&normalizedLong&&(contract.short=normalizedShort),assignExtensionFlagBoolean(contract,"required",definition.required===!0),assignExtensionFlagBoolean(contract,"repeatable",definition.repeatable===!0),assignExtensionFlagBoolean(contract,"list",definition.list===!0);const description=toOptionalTrimmedString(definition.description);description&&(contract.description=description);const value=resolveExtensionFlagValueContract(definition);contract.value_arity=value.value_arity;const valueName=toOptionalTrimmedString(definition.value_name)??value.value_name;valueName&&(contract.value_name=valueName);const rawValueType=value.value_type??(value.value_name?"string":null);return rawValueType&&(contract.value_type=rawValueType),contract}function collectExtensionFlagContractsByCommand(registrations){const grouped=new Map;for(const registration of registrations){const commandPath=normalizeCommandPath(registration.target_command);if(commandPath.length===0)continue;const bucket=grouped.get(commandPath)??{flags:[],sources:[],dedupe:new Set,sourceDedupe:new Set},sourceKey=`${registration.layer}:${registration.name}`;bucket.sourceDedupe.has(sourceKey)||(bucket.sourceDedupe.add(sourceKey),bucket.sources.push({layer:registration.layer,name:registration.name}));for(const definition of registration.flags){const contract=toExtensionFlagContract(definition);if(!contract)continue;const key=`${contract.flag}|${contract.short??""}`;bucket.dedupe.has(key)||(bucket.dedupe.add(key),bucket.flags.push(contract))}grouped.set(commandPath,bucket)}const normalized=new Map;for(const[commandPath,bucket]of grouped.entries())normalized.set(commandPath,{flags:bucket.flags,sources:bucket.sources.sort((left,right)=>{const layerOrder=left.layer.localeCompare(right.layer);return layerOrder!==0?layerOrder:(left.name??"").localeCompare(right.name??"")})});return normalized}function extensionReadOutputDiscovery(definition,flags){return definition.read_output===void 0?{flags}:{read_output:definition.read_output,flags:[...flags,...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS.filter(({flag})=>flag.startsWith("--output-"))]}}function collectExtensionCommandContracts(runtimeProbe){const flagsByCommand=collectExtensionFlagContractsByCommand(runtimeProbe.flagRegistrations),definitionsByCommand=new Map;for(const definition of runtimeProbe.commandDefinitions){const command=normalizeCommandPath(definition.command);if(command.length===0)continue;const action=toOptionalTrimmedString(definition.action)??normalizeActionNameFromCommand(command),args=Array.isArray(definition.arguments)?definition.arguments.map(argument=>{const name=toOptionalTrimmedString(argument.name);return name?{name,required:argument.required===!0,variadic:argument.variadic===!0,description:toOptionalTrimmedString(argument.description)}:null}).filter(argument=>argument!==null):[];definitionsByCommand.set(command,{...definition.tier===void 0?{}:{tier:definition.tier},...extensionReadOutputDiscovery(definition,flagsByCommand.get(command)?.flags??[]),command,action,source:{layer:definition.layer,name:definition.name},description:toOptionalTrimmedString(definition.description),intent:toOptionalTrimmedString(definition.intent),arguments:args,examples:normalizeStringList(definition.examples),failure_hints:normalizeStringList(definition.failure_hints)})}const extensionCommands=new Set;for(const command of runtimeProbe.handlers)extensionCommands.add(normalizeCommandPath(command));for(const command of definitionsByCommand.keys())extensionCommands.add(command);for(const command of flagsByCommand.keys())extensionCommands.add(command);const contracts=[];for(const command of[...extensionCommands].sort((left,right)=>left.localeCompare(right))){const definition=definitionsByCommand.get(command);contracts.push(buildCollectedExtensionCommandContract(command,definition,flagsByCommand.get(command)?.flags??[]))}return contracts}function buildCollectedExtensionCommandContract(command,definition,registeredFlags){return definition?{...definition,flags:definition.flags.length>0?definition.flags:registeredFlags}:{command,action:normalizeActionNameFromCommand(command),source:null,description:null,intent:null,arguments:[],flags:registeredFlags,examples:[],failure_hints:[]}}function extensionSchemaPropertyNameFromFlag(flag){const normalized=flag.flag.replace(/^-+/,"").trim();if(normalized.length===0)return null;const cleaned=normalized.replace(/-([a-z0-9])/g,(_match,char)=>char.toUpperCase()).replace(/[^a-zA-Z0-9]/g,"");return cleaned.length>0?cleaned:null}function buildExtensionArgumentSchema(argument,action){return argument.variadic?{type:"array",items:{type:"string"},description:argument.description??`Variadic argument '${argument.name}' for extension action '${action}'.`}:{type:"string",description:argument.description??`Argument '${argument.name}' for extension action '${action}'.`}}function buildExtensionFlagSchema(flag,action){const valueType=flag.value_type??"boolean",schemaType=valueType==="boolean"?"boolean":valueType==="number"?["number","string"]:"string",acceptsMultipleValues=flag.repeatable===!0||flag.list===!0;return{type:acceptsMultipleValues?"array":schemaType,...acceptsMultipleValues?{items:{type:schemaType}}:{},description:flag.description??`Extension option '${flag.flag}' for action '${action}'.`}}function buildExtensionActionSchemaBranch(contract){const commands=contract.command.split("|").map(command=>command.trim()).filter(command=>command.length>0),properties={action:{type:"string",const:contract.action,description:contract.intent??contract.description??`Invoke extension command '${contract.command}'.`}},required=["action"];for(const argument of contract.arguments)properties[argument.name]=buildExtensionArgumentSchema(argument,contract.action),argument.required&&required.push(argument.name);for(const flag of contract.flags){const propertyName=extensionSchemaPropertyNameFromFlag(flag);!propertyName||properties[propertyName]!==void 0||(properties[propertyName]=SUBCOMMAND_GLOBAL_FLAG_CONTRACTS.some(host=>host.flag===flag.flag&&host.flag.startsWith("--output-"))?PM_TOOL_PARAMETER_PROPERTIES[propertyName]:buildExtensionFlagSchema(flag,contract.action),flag.required===!0&&required.push(propertyName))}return{type:"object",properties,required,additionalProperties:!0,"x-extension-source":contract.source,"x-extension-command":commands[0]??contract.command,"x-extension-commands":commands}}function mergeExtensionFlagContract(existing,incoming){existing.description??=incoming.description,existing.value_name??=incoming.value_name,existing.value_type??=incoming.value_type,incoming.required===!0&&(existing.required=!0),incoming.repeatable===!0&&(existing.repeatable=!0)}function mergeExtensionContractsByAction(contracts){const byAction=new Map;for(const contract of contracts){const existing=byAction.get(contract.action);if(!existing){byAction.set(contract.action,{...contract,flags:[...contract.flags],examples:[...contract.examples],failure_hints:[...contract.failure_hints]});continue}existing.command=[...new Set([existing.command,contract.command])].sort((left,right)=>left.localeCompare(right)).join("|"),existing.arguments=existing.arguments.length>=contract.arguments.length?existing.arguments:contract.arguments;const flagKeys=new Set(existing.flags.map(flag=>`${flag.flag}|${flag.short??""}`));for(const flag of contract.flags){const key=`${flag.flag}|${flag.short??""}`;if(!flagKeys.has(key))flagKeys.add(key),existing.flags.push(flag);else{const existingFlag=existing.flags.find(candidate=>`${candidate.flag}|${candidate.short??""}`===key);existingFlag&&mergeExtensionFlagContract(existingFlag,flag)}}existing.examples=[...new Set([...existing.examples,...contract.examples])],existing.failure_hints=[...new Set([...existing.failure_hints,...contract.failure_hints])]}return[...byAction.values()].sort((left,right)=>left.action.localeCompare(right.action))}async function resolveRuntimeExtensionActionProbe(global2,readSettingsFn=readSettings){const defaultPolicyState={mode:SETTINGS_DEFAULTS.extensions.policy.mode,trust_mode:SETTINGS_DEFAULTS.extensions.policy.trust_mode,default_sandbox_profile:SETTINGS_DEFAULTS.extensions.policy.default_sandbox_profile};if(global2.noExtensions)return{handlers:new Set,disabledReason:"extensions_disabled",commandDefinitions:[],flagRegistrations:[],registrations:null,policyState:defaultPolicyState};const pmRoot=resolvePmRoot(process.cwd(),global2.path);if(!await pathExists(getSettingsPath(pmRoot)))return{handlers:new Set,disabledReason:null,commandDefinitions:[],flagRegistrations:[],registrations:null,policyState:defaultPolicyState};try{const settings=await readSettingsFn(pmRoot),loadResult=await loadExtensions({pmRoot,settings,cwd:process.cwd(),noExtensions:!1}),activationResult=await activateExtensions({...loadResult,loaded:loadResult.loaded});return{handlers:new Set(activationResult.commands.handlers.map(entry=>normalizeCommandPath(entry.command))),disabledReason:null,commandDefinitions:activationResult.registrations.commands,flagRegistrations:activationResult.registrations.flags,registrations:activationResult.registrations,policyState:{mode:loadResult.policy.mode,trust_mode:loadResult.policy.trust_mode,default_sandbox_profile:loadResult.policy.default_sandbox_profile}}}catch{return{handlers:new Set,disabledReason:"extension_runtime_probe_failed",commandDefinitions:[],flagRegistrations:[],registrations:null,policyState:defaultPolicyState}}}function collectActionContractDescriptors(extensionContracts,options={}){const descriptors=new Map;for(const action of PM_TOOL_ACTIONS){const packageOwned=PACKAGE_OWNED_ACTIONS.has(action);if(packageOwned&&!options.includePackageOwnedActions)continue;const commandPath=resolveActionCommandPath(action);descriptors.set(action,{action,provider:packageOwned?"extension":"core",requires_extension:packageOwned,command_path:commandPath})}if(options.includePackageOwnedActions)for(const action of PACKAGE_OWNED_ACTIONS)descriptors.has(action)||descriptors.set(action,{action,provider:"extension",requires_extension:!0,command_path:resolveActionCommandPath(action)});for(const contract of extensionContracts)descriptors.has(contract.action)||descriptors.set(contract.action,{action:contract.action,provider:"extension",requires_extension:!0,command_path:PM_NAMESPACED_COMMAND_ALIASES.find(entry=>entry.alias===contract.command)?.canonical??normalizeCommandPath(contract.command)});return[...descriptors.values()].sort((left,right)=>(left.action??"").localeCompare(right.action??""))}function resolveActionAvailability(descriptor,runtimeProbe){if(descriptor.provider==="core"&&!descriptor.requires_extension)return{action:descriptor.action,invocable:!0,available:!0,requires_extension:!1,provider:"core",disabled_reason:null,command_path:descriptor.command_path,cli_exposed:descriptor.command_path!==null&&(!PACKAGE_OWNED_COMMANDS.has(descriptor.action)||runtimeProbe.handlers.has(descriptor.action))};const commandPaths=descriptor.command_path?splitCommandPathAliases(descriptor.command_path):[],extensionCommandAvailable=commandPaths.some(commandPath=>runtimeProbe.handlers.has(commandPath)||runtimeProbe.handlers.has(resolvePmCommandOperation(commandPath))),optionalPackageHint=commandPaths.map(commandPath=>PACKAGE_OWNED_COMMAND_INSTALL_HINTS.get(resolvePmCommandOperation(commandPath))).find(hint=>typeof hint=="string"),invocable=runtimeProbe.disabledReason===null&&extensionCommandAvailable;return{action:descriptor.action,invocable,available:invocable,requires_extension:!0,provider:"extension",disabled_reason:invocable?null:runtimeProbe.disabledReason??(optionalPackageHint?`optional_package_not_installed:${optionalPackageHint}`:"extension_command_not_registered"),command_path:descriptor.command_path,cli_exposed:extensionCommandAvailable,policy_state:{mode:runtimeProbe.policyState.mode,trust_mode:runtimeProbe.policyState.trust_mode,default_sandbox_profile:runtimeProbe.policyState.default_sandbox_profile}}}function resolveCoreCommandFlags(command){const flags=CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND.get(command)??GLOBAL_FLAG_CONTRACTS,encoding=resolveSubcommandFlagContractsForCommand(command).find(contract=>contract.flag==="--output-format"&&contract.aliases?.includes("--format"));return encoding?[...flags,encoding]:flags}function isCoreCommandPath(command){return PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(command))?!1:CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND.has(command)}function normalizeCommandForRuntimeFieldFlags(command){return LIST_COMMAND_NAMES.has(command)?"list":command==="cal"?"calendar":command==="ctx"?"context":command==="update-many"?"update_many":command}function toRuntimeLongFlagToken(token){const trimmed=token.trim();return trimmed?trimmed.startsWith("--")?trimmed:trimmed.startsWith("-")?null:`--${trimmed}`:null}function toRuntimeShortFlagToken(token){const trimmed=token.trim();return!trimmed||trimmed.startsWith("--")?null:trimmed.startsWith("-")?trimmed:null}function buildRuntimeFieldFlagContracts(fieldRegistry){const buckets=new Map;for(const definition of fieldRegistry.definitions){const primaryFlag=toRuntimeLongFlagToken(definition.cli_flag);if(!primaryFlag)continue;const shortAlias=definition.cli_aliases.map(alias=>toRuntimeShortFlagToken(alias)).find(alias=>alias!==null),longAliases=definition.cli_aliases.map(alias=>toRuntimeLongFlagToken(alias)).filter(alias=>alias!==null&&alias!==primaryFlag);for(const command of definition.commands){const bucket=buckets.get(command)??{flags:[],seen:new Set},primaryContract=shortAlias?{flag:primaryFlag,short:shortAlias}:{flag:primaryFlag},primaryKey=`${primaryContract.flag}|${primaryContract.short??""}`;bucket.seen.has(primaryKey)||(bucket.seen.add(primaryKey),bucket.flags.push(primaryContract));for(const alias of longAliases){const key=`${alias}|`;bucket.seen.has(key)||(bucket.seen.add(key),bucket.flags.push({flag:alias}))}buckets.set(command,bucket)}}const result=new Map;for(const[command,bucket]of buckets.entries())result.set(command,compactFlagAliasContracts(bucket.flags));return result}function mergeFlagContracts(primary,secondary){const merged=[],seen=new Set;for(const contract of[...primary,...secondary]){const key=`${contract.flag}|${contract.short??""}`;seen.has(key)||(seen.add(key),merged.push(contract))}return compactFlagAliasContracts(merged)}function buildCommandFlagSurface(commands,extensionFlagMap,runtimeFieldFlagMap,includeSemanticMetadata,extensionContracts){const flagsByPath=new Map(extensionFlagMap);for(const{alias,canonical}of PM_NAMESPACED_COMMAND_ALIASES){const flags=extensionFlagMap.get(canonical)??extensionFlagMap.get(alias);flags&&(flagsByPath.set(alias,flags),flagsByPath.set(canonical,flags))}return commands.map(command=>{const isCoreCommand=isCoreCommandPath(command),coreFlags=isCoreCommand?resolveCoreCommandFlags(command):[],runtimeFlags=runtimeFieldFlagMap.get(normalizeCommandForRuntimeFieldFlags(command))??[],extensionFlags=flagsByPath.get(command),coreWithRuntime=mergeFlagContracts(coreFlags,runtimeFlags),flags=mergeFlagContracts(coreWithRuntime,extensionFlags?.flags??[]),provider=coreFlags.length>0&&(extensionFlags?.flags.length??0)>0?"mixed":isCoreCommand?"core":"extension";return{command,flags,...includeSemanticMetadata?{canonical_command:canonicalSummaryCommand(command),visibility:runtimeCommandVisibilityTier(command,extensionContracts),positionals:resolvePmCommandPositionalContract(command)?.slots??[],flag_invocations:enrichCliFlagInvocationContracts(command,flags)}:{},provider,extension_sources:extensionFlags?.sources}}).sort((left,right)=>left.command.localeCompare(right.command))}function buildCommandAliasSurface(commands,aliasContracts=PM_COMMAND_ALIAS_CONTRACTS){const commandSet=new Set(commands),grouped=new Map;for(const entry of CANONICAL_COMMAND_ALIASES){const aliases=entry.aliases.filter(alias=>commandSet.has(alias));grouped.set(entry.canonical,{canonical:entry.canonical,aliases,contracts:[]})}for(const contract of aliasContracts){if(!commandSet.has(contract.canonical)||contract.registration==="commander"&&!commandSet.has(contract.alias))continue;const entry=grouped.get(contract.canonical)??{canonical:contract.canonical,aliases:[],contracts:[]};entry.aliases.includes(contract.alias)||entry.aliases.push(contract.alias),entry.contracts.push(contract),grouped.set(contract.canonical,entry)}return[...grouped.values()].map(({contracts,...entry})=>contracts.length===0?entry:{...entry,contracts}).sort((left,right)=>left.canonical.localeCompare(right.canonical))}function buildCommanderAliasSurface(){return{create_string_options:CREATE_COMMANDER_STRING_OPTION_CONTRACTS,create_repeatable_options:CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,update_string_options:UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,update_repeatable_options:UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,list_string_options:LIST_COMMANDER_STRING_OPTION_CONTRACTS,search_string_options:SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,calendar_string_options:CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS,context_string_options:CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,activity_string_options:ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS}}function resolveCreateRequiredOptionContract(typeDefinition,createMode){const baseRequiredOptions=new Set(["title","type"]);if(createMode==="strict"){for(const field of typeDefinition.required_create_fields)baseRequiredOptions.add(field);for(const field of typeDefinition.required_create_repeatables)baseRequiredOptions.add(field)}const policyState=resolveCommandOptionPolicyState(typeDefinition,"create",baseRequiredOptions),requiredOptionKeys=[...new Set(policyState.required)].sort((left,right)=>left.localeCompare(right)),requiredFlags=[...new Set(requiredOptionKeys.map(option=>commandOptionFlagLabel("create",option)))].sort((left,right)=>left.localeCompare(right)),requiredTypeOptions=[...new Set(typeDefinition.options.filter(option=>option.required===!0).map(option=>option.key))].sort((left,right)=>left.localeCompare(right));return{required_option_keys:requiredOptionKeys,required_flags:requiredFlags,required_type_options:requiredTypeOptions,policy_errors:[...new Set(policyState.errors)].sort((left,right)=>left.localeCompare(right))}}function buildCreateRequiredOptionContracts(typeRegistry){const byTypeStrict={},byTypeProgressive={};for(const typeName of[...typeRegistry.types].sort((left,right)=>left.localeCompare(right))){const typeDefinition=typeRegistry.by_type[typeName];byTypeStrict[typeName]=resolveCreateRequiredOptionContract(typeDefinition,"strict"),byTypeProgressive[typeName]=resolveCreateRequiredOptionContract(typeDefinition,"progressive")}return{default_create_mode:"strict",by_create_mode:{strict:{by_type:byTypeStrict},progressive:{by_type:byTypeProgressive}}}}function attachCreateRequiredOptionContracts(schema,metadata){const branches=extractActionBranches(schema);if(branches.length===0)return schema;let touched=!1;const enrichedBranches=branches.map(branch=>{const properties=branch.properties;if(typeof properties!="object"||properties===null)return branch;const actionProperty=properties.action;return typeof actionProperty!="object"||actionProperty===null||actionProperty.const!=="create"?branch:(touched=!0,{...branch,"x-create-required-options":metadata})});return touched?{...schema,oneOf:enrichedBranches}:schema}function resolveContractsSelection(options){const explicitlyScoped=normalizeToken(options.action)!==void 0||normalizeToken(options.command)!==void 0,projectionSelected=options.schemaOnly===!0||options.flagsOnly===!0||options.availabilityOnly===!0,summary=options.summary===!0||options.full!==!0&&options.runtimeOnly!==!0&&!explicitlyScoped&&!projectionSelected,schemaOnly=options.schemaOnly===!0,flagsOnly=options.flagsOnly===!0,availabilityOnly=options.availabilityOnly===!0,runtimeOnly=options.runtimeOnly===!0,fullOutput=options.full===!0,selectedAction=normalizeToken(options.action),selectedCommand=normalizeToken(options.command),unfilteredDefaultBriefMode=!summary&&!fullOutput&&!schemaOnly&&!flagsOnly&&!availabilityOnly&&!selectedAction&&!selectedCommand;return{selectedAction,selectedCommand,summary,schemaOnly,flagsOnly,availabilityOnly,runtimeOnly,fullOutput,omitUnfilteredSchema:unfilteredDefaultBriefMode,omitUnfilteredCommandFlags:unfilteredDefaultBriefMode,omitUnfilteredCommanderAliases:unfilteredDefaultBriefMode||selectedCommand!==void 0&&!fullOutput}}function assertSingleContractsProjection(selection){if([selection.summary,selection.schemaOnly,selection.flagsOnly,selection.availabilityOnly].filter(value=>value).length>1)throw new PmCliError("Choose only one projection flag: --summary, --schema-only, --flags-only, or --availability-only.",EXIT_CODE.USAGE)}async function readContractsSettings(pmRoot,readSettingsFn=readSettings){try{return await readSettingsFn(pmRoot)}catch{return structuredClone(SETTINGS_DEFAULTS)}}async function resolveContractsRuntimeContext(global2,pmRoot,selection){const settings=await readContractsSettings(pmRoot),runtimeProbe=await resolveRuntimeExtensionActionProbe(global2),typeRegistry=resolveItemTypeRegistry(settings,runtimeProbe.registrations??getActiveExtensionRegistrations()),runtimeFieldRegistry=resolveRuntimeFieldRegistry(settings.schema),extensionContracts=collectExtensionCommandContracts(runtimeProbe);return{settings,runtimeProbe,typeRegistry,statusRegistry:resolveRuntimeStatusRegistry(settings.schema),runtimeFieldRegistry,runtimeFieldFlagMap:buildRuntimeFieldFlagContracts(runtimeFieldRegistry),createRequiredOptionContracts:buildCreateRequiredOptionContracts(typeRegistry),extensionContracts,mergedExtensionContracts:mergeExtensionContractsByAction(extensionContracts.filter(entry=>isCommandDiscoverable(selection,entry.command,extensionContracts))),extensionFlagMap:collectExtensionFlagContractsByCommand(runtimeProbe.flagRegistrations)}}function shouldIncludePackageOwnedActions(selection){return selection.availabilityOnly&&(selection.selectedAction!==void 0&&PACKAGE_OWNED_ACTIONS.has(selection.selectedAction)||selection.selectedCommand!==void 0&&PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(selection.selectedCommand)))}function collectContractsActionDescriptors(selection,mergedExtensionContracts){const actionDescriptors=collectActionContractDescriptors(mergedExtensionContracts,{includePackageOwnedActions:shouldIncludePackageOwnedActions(selection)});if(selection.selectedAction===void 0&&selection.selectedCommand===void 0){const deprecatedActions=new Set(PM_DEPRECATED_TOOL_ACTIONS);return actionDescriptors.filter(descriptor=>!deprecatedActions.has(descriptor.action)&&(selection.fullOutput||(mergedExtensionContracts.find(entry=>entry.action===descriptor.action)?.tier??resolvePmCommandVisibilityTier(descriptor.action))!=="internal"))}return shouldIncludePackageOwnedActions(selection)&&selection.selectedCommand!==void 0&&PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(selection.selectedCommand))&&!actionDescriptors.some(entry=>entry.command_path===selection.selectedCommand)&&actionDescriptors.push({action:packageOwnedActionForCommand(resolvePmCommandOperation(selection.selectedCommand)),provider:"extension",requires_extension:!0,command_path:selection.selectedCommand}),actionDescriptors}function assertKnownContractsAction(selection,actionDescriptors){const actionNames=new Set(actionDescriptors.map(entry=>entry.action));if(selection.selectedAction&&!actionNames.has(selection.selectedAction))throw new PmCliError(`Unknown action: "${selection.selectedAction}".`,EXIT_CODE.USAGE)}function buildContractsCommandCatalog(actionDescriptors,mergedExtensionContracts){return[...new Set([...PM_CORE_COMMAND_NAMES.filter(entry=>!PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(entry))),...[...CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND.keys()].filter(entry=>!PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(entry))),...actionDescriptors.flatMap(entry=>entry.command_path?splitCommandPathAliases(entry.command_path).filter(command=>entry.provider==="extension"||!PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(command))||mergedExtensionContracts.some(contract=>contract.action===entry.action)):[]),...mergedExtensionContracts.flatMap(entry=>entry.command.split("|").flatMap(command=>{const alias=PM_NAMESPACED_COMMAND_ALIASES.find(entry2=>entry2.alias===command||entry2.canonical===command);return alias===void 0?[command]:[alias.alias,alias.canonical]}))])].map(entry=>normalizeCommandPath(entry)).filter(entry=>entry.length>0).sort((left,right)=>left.localeCompare(right))}function buildCommandNamespaceError(command,namespaceChildren){const displayedNamespaceChildren=namespaceChildren.slice(0,COMMAND_NAMESPACE_DISPLAY_LIMIT),hiddenNamespaceChildCount=namespaceChildren.length-displayedNamespaceChildren.length,displayedChildCommandList=hiddenNamespaceChildCount>0?`${displayedNamespaceChildren.join(", ")}, and ${hiddenNamespaceChildCount} more`:displayedNamespaceChildren.join(", "),fallbackCandidates=namespaceChildren.slice(0,COMMAND_NAMESPACE_FALLBACK_LIMIT),childCommandExamples=namespaceChildren.slice(0,5).map(childCommand=>`pm contracts --command "${childCommand}" --flags-only --json`),suggestedChildCommand=namespaceChildren[0];return new PmCliError(`Command "${command}" is a command namespace. Choose a concrete child command: ${displayedChildCommandList}.`,EXIT_CODE.USAGE,{code:"command_namespace",required:"Use a concrete child command path listed under this namespace.",why:"Command groups expose help at the namespace root, but command flag contracts belong to executable child commands.",examples:childCommandExamples,nextSteps:[`Retry with a child command, for example: ${childCommandExamples[0]}`],recovery:{suggested_retry:`pm contracts --command "${suggestedChildCommand}" --flags-only --json`,fallback_candidates:fallbackCandidates.map(childCommand=>({source:"command_namespace",command:`pm contracts --command "${childCommand}" --flags-only --json`,reason:`Child command under ${command}`}))}})}function buildPackageOwnedCommandError(command,packageHint){return new PmCliError(`Unknown command: "${command}". Command "${command}" is provided by the optional "${packageHint}" package. Run "pm package install ${packageHint} --project" and retry.`,EXIT_CODE.USAGE,{code:"unknown_command",required:`Install the optional "${packageHint}" package, or choose a command from pm contracts --flags-only --json.`,why:"Command contracts include core commands plus commands registered by active packages and extensions.",examples:[`pm package install ${packageHint} --project`,`pm contracts --command ${command} --flags-only --json`],nextSteps:[`Install the optional package first: pm package install ${packageHint} --project`],recovery:{suggested_retry:`pm package install ${packageHint} --project`}})}function buildUnknownCommandError(command){return new PmCliError(`Unknown command: "${command}".`,EXIT_CODE.USAGE,{code:"unknown_command",required:"Use a command path listed by pm contracts --flags-only --json.",why:"Command contracts are generated from the active core, package, and extension command registry.",examples:["pm contracts --flags-only --json","pm --help"],nextSteps:["Verify spelling and active packages/extensions, then rerun with a known command path."],recovery:{suggested_retry:"pm contracts --flags-only --json"}})}function assertKnownContractsCommand(selection,commandCatalog){if(!selection.selectedCommand||new Set(commandCatalog).has(selection.selectedCommand))return;const namespaceChildren=commandCatalog.filter(command=>command.startsWith(`${selection.selectedCommand} `));if(namespaceChildren.length>0)throw buildCommandNamespaceError(selection.selectedCommand,namespaceChildren);const packageHint=PACKAGE_OWNED_COMMAND_INSTALL_HINTS.get(resolvePmCommandOperation(selection.selectedCommand));throw packageHint?buildPackageOwnedCommandError(selection.selectedCommand,packageHint):buildUnknownCommandError(selection.selectedCommand)}function resolveContractsActionContext(selection,runtime){const actionDescriptors=collectContractsActionDescriptors(selection,runtime.mergedExtensionContracts);assertKnownContractsAction(selection,actionDescriptors);const commandCatalog=buildContractsCommandCatalog(actionDescriptors,runtime.mergedExtensionContracts);assertKnownContractsCommand(selection,commandCatalog);const selectedPackageOwnedAction=selection.selectedCommand?PACKAGE_OWNED_COMMAND_ACTIONS.get(resolvePmCommandOperation(selection.selectedCommand)):void 0,commandScopedDescriptors=selection.selectedCommand?actionDescriptors.filter(descriptor=>selectedPackageOwnedAction?descriptor.action===selectedPackageOwnedAction:actionDescriptorMatchesSelectedCommand(descriptor,selection.selectedCommand)):actionDescriptors;if(selection.selectedCommand&&selection.selectedAction&&!commandScopedDescriptors.some(descriptor=>descriptor.action===selection.selectedAction))throw new PmCliError(`Action "${selection.selectedAction}" is not mapped to command "${selection.selectedCommand}" in contracts output.`,EXIT_CODE.USAGE);const scopedActionDescriptors=selection.selectedAction?commandScopedDescriptors.filter(descriptor=>descriptor.action===selection.selectedAction):commandScopedDescriptors,allActionAvailability=[...new Map(scopedActionDescriptors.map(descriptor=>resolveActionAvailability(descriptor,runtime.runtimeProbe)).map(entry=>[selectedPackageOwnedAction?entry.action:`${entry.action}|${entry.command_path??""}`,entry])).values()],actionAvailability=selection.runtimeOnly&&!selection.selectedAction&&!selection.availabilityOnly?allActionAvailability.filter(entry=>entry.invocable):allActionAvailability;return{actionDescriptors,commandCatalog,commandScopedDescriptors,scopedActionDescriptors,selectedPackageOwnedAction,actionAvailability,actions:[...new Set(actionAvailability.map(entry=>entry.action))]}}function buildSchemaActionSet(schema){return new Set(extractActionBranches(schema).map(entry=>{const properties=entry.properties;if(typeof properties!="object"||properties===null)return null;const actionProperty=properties.action;if(typeof actionProperty!="object"||actionProperty===null)return null;const actionConst=actionProperty.const;return typeof actionConst=="string"?actionConst:null}).filter(entry=>entry!==null))}function buildMergedContractsSchema(mergedExtensionContracts){const schema=PM_TOOL_PARAMETERS_SCHEMA,schemaBranches=extractActionBranches(schema),schemaActionSet=buildSchemaActionSet(schema),extensionBranches=mergedExtensionContracts.filter(contract=>!schemaActionSet.has(contract.action)).map(contract=>buildExtensionActionSchemaBranch(contract));return extensionBranches.length>0?{...schema,oneOf:[...schemaBranches,...extensionBranches]}:schema}function filterContractsSchema(selection,actionContext,mergedSchema){const descriptorActionSet=new Set(actionContext.actionDescriptors.map(descriptor=>descriptor.action)),filteredSchema=selection.selectedAction?filterSchemaByAction(mergedSchema,selection.selectedAction):selection.selectedCommand?filterSchemaByActions(mergedSchema,new Set(actionContext.scopedActionDescriptors.map(descriptor=>descriptor.action))):filterSchemaByActions(mergedSchema,descriptorActionSet);return selection.runtimeOnly&&!selection.selectedAction?filterSchemaByActions(filteredSchema,new Set(actionContext.actions)):filteredSchema}function resolveContractsSchemaContext(selection,runtime,actionContext){const mergedSchema=buildMergedContractsSchema(runtime.mergedExtensionContracts),filteredSchema=!selection.flagsOnly&&!selection.availabilityOnly?attachCreateRequiredOptionContracts(filterContractsSchema(selection,actionContext,mergedSchema),runtime.createRequiredOptionContracts):filterContractsSchema(selection,actionContext,mergedSchema);return{mergedSchema,filteredSchema}}function resolveContractsCommands(selection,actionContext){return selection.selectedCommand!==void 0?[selection.selectedCommand]:selection.selectedAction?resolveScopedCommandsFromActionDescriptors(actionContext.scopedActionDescriptors,actionContext.commandCatalog):actionContext.commandCatalog}function runtimeCommandVisibilityTier(command,extensionContracts){return extensionContracts.find(entry=>resolvePmCommandOperation(entry.command)===resolvePmCommandOperation(command))?.tier??resolvePmCommandVisibilityTier(command)}function isCommandDiscoverable(selection,command,extensionContracts){return selection.fullOutput||selection.selectedCommand!==void 0||selection.selectedAction!==void 0||runtimeCommandVisibilityTier(command,extensionContracts)!=="internal"}function resolveOutputCommands(selection,commands,extensionContracts){if(selection.selectedCommand!==void 0||selection.selectedAction!==void 0)return commands;const hiddenAliases=new Set(PM_COMMAND_ALIAS_CONTRACTS.filter(contract=>contract.hidden&&(contract.lifecycle==="deprecated"||!selection.fullOutput&&!selection.availabilityOnly)).map(contract=>contract.alias));if(selection.summary&&!selection.fullOutput)for(const alias of COMMAND_ALIAS_TO_CANONICAL.keys())hiddenAliases.add(alias);return commands.filter(command=>!hiddenAliases.has(command)&&isCommandDiscoverable(selection,command,extensionContracts))}function canonicalSummaryCommand(command){const historyAlias=PM_NAMESPACED_COMMAND_ALIASES.find(contract=>contract.alias===command||contract.canonical===command);if(historyAlias)return historyAlias.canonical;const rootCommand=command.split(" ")[0];return rootCommand.startsWith("list-")?"list":COMMAND_ALIAS_TO_CANONICAL.get(rootCommand)??rootCommand}const COMMAND_OPERATION_INTENTS=new Map([["activate","Activate"],["adopt","Adopt"],["adopt-all","Adopt all"],["catalog","Catalog"],["complete","Complete"],["create","Create"],["deactivate","Deactivate"],["delete","Delete"],["describe","Describe"],["doctor","Diagnose"],["explore","Explore"],["init","Initialize"],["inspect","Inspect"],["install","Install"],["list","List"],["manage","Manage"],["migrate","Migrate"],["mutate","Mutate"],["reload","Reload"],["restore","Restore"],["run","Run"],["snapshot","Manage snapshots for"],["uninstall","Uninstall"],["upgrade","Upgrade"]]),COMMAND_INTENT_SUBJECT_OVERRIDES=new Map([["extension adopt-all","extensions"],["package adopt-all","packages"],["workspace snapshot list","workspace snapshots"]]);function summarizeCommandIntent(command,extensionContracts){const declared=COMMAND_INTENTS.get(resolvePmCommandOperation(command))??(command.includes(" ")?void 0:COMMAND_INTENTS.get(canonicalSummaryCommand(command)));if(declared!==void 0)return{intent:declared,intent_source:"command"};const extensionContract=extensionContracts.find(contract=>splitCommandPathAliases(contract.command).some(path=>resolvePmCommandOperation(path)===resolvePmCommandOperation(command)));if(extensionContract?.intent!==null&&extensionContract?.intent!==void 0)return{intent:extensionContract.intent,intent_source:"command"};if(extensionContract?.description!==null&&extensionContract?.description!==void 0)return{intent:extensionContract.description,intent_source:"description"};const tokens=command.split(" "),operation=tokens.at(-1),subject=tokens.slice(0,-1).join(" "),verb=COMMAND_OPERATION_INTENTS.get(operation),intentSubject=COMMAND_INTENT_SUBJECT_OVERRIDES.get(command)??subject;return{intent:verb===void 0||subject.length===0?`Run ${command}.`:`${verb} ${intentSubject}.`,intent_source:"generated"}}function buildCommandSummarySurface(commands,extensionContracts=[],options={}){const includeFormatBudgets=options.includeFormatBudgets??!0,includeIntentProvenance=options.includeIntentProvenance??!0;return[...new Set(commands.map(normalizeCommandPath))].filter(command=>command.length>0).sort((left,right)=>left.localeCompare(right)).map(command=>{const budget=resolvePmCommandOutputBudget(command,{generateFallback:!0}),rootCommand=command.split(" ")[0],canonicalRoot=COMMAND_ALIAS_TO_CANONICAL.get(rootCommand)??(rootCommand.startsWith("list-")?"list":rootCommand.startsWith("history-")?"history":rootCommand),availableFlags=new Set([...resolveCoreCommandFlags(command).map(contract=>contract.flag),...extensionContracts.filter(contract=>splitCommandPathAliases(contract.command).some(path=>resolvePmCommandOperation(path)===resolvePmCommandOperation(command))).flatMap(contract=>contract.flags.map(flag=>flag.flag))]),flags=(AGENT_BOOTSTRAP_FLAGS.get(resolvePmCommandOperation(command))??AGENT_BOOTSTRAP_FLAGS.get(canonicalRoot)??AGENT_BOUNDED_FLAG_PRIORITY).filter(flag=>availableFlags.has(flag)),intent=summarizeCommandIntent(command,extensionContracts);return{command,intent:intent.intent,...includeIntentProvenance||intent.intent_source!=="command"?{intent_source:intent.intent_source}:{},...flags.length>0?{flags}:{},default_max_estimated_tokens:budget.default_max_estimated_tokens,...includeFormatBudgets?{default_max_estimated_tokens_by_format:{...budget.default_max_estimated_tokens_by_format}}:{}}})}function buildCommandOutputContracts(commands){return commands.map(command=>({budget:resolvePmCommandOutputBudget(command,{generateFallback:!0}),envelope:resolvePmCommandOutputEnvelope(command)}))}function buildCommandExitContractGroups(commands){const groups=new Map;for(const command of commands){const contract=resolvePmCommandExitContract(command),exitCodes=contract===void 0?[EXIT_CODE.SUCCESS,EXIT_CODE.GENERIC_FAILURE,EXIT_CODE.USAGE,EXIT_CODE.NOT_FOUND,EXIT_CODE.CONFLICT,EXIT_CODE.DEPENDENCY_FAILED]:contract.exit_codes,key=exitCodes.join(","),group=groups.get(key)??{commands:[],exit_codes:exitCodes};group.commands.push(command),groups.set(key,group)}return[...groups.values()]}function resolveExtensionCommandContracts(selection,runtime,outputCommands){if(selection.selectedCommand)return runtime.extensionContracts.filter(entry=>splitCommandPathAliases(entry.command).some(path=>resolvePmCommandOperation(path)===resolvePmCommandOperation(selection.selectedCommand)));if(selection.selectedAction){const outputCommandSet=new Set(outputCommands);return runtime.extensionContracts.filter(entry=>splitCommandPathAliases(entry.command).some(command=>outputCommandSet.has(command)))}return runtime.extensionContracts.filter(entry=>isCommandDiscoverable(selection,entry.command,runtime.extensionContracts))}function createContractsResult(selection,schemaContext,actionContext,outputCommands){return{schema_version:typeof schemaContext.mergedSchema["x-schema-version"]=="string"?schemaContext.mergedSchema["x-schema-version"]:null,schema_id:typeof schemaContext.mergedSchema.$id=="string"?schemaContext.mergedSchema.$id:null,selected:{action:selection.selectedAction??null,command:selection.selectedCommand??null,summary:selection.summary,schema_only:selection.schemaOnly,flags_only:selection.flagsOnly,availability_only:selection.availabilityOnly,runtime_only:selection.runtimeOnly,command_scoped:selection.selectedCommand!==void 0},commands:selection.summary?[]:outputCommands,...!selection.summary&&!selection.flagsOnly?{actions:actionContext.actions,action_availability:actionContext.actionAvailability}:{}}}function attachRuntimeContractsResult(result,runtime,selection){(selection.selectedCommand==="history"||selection.fullOutput)&&!selection.flagsOnly&&!selection.schemaOnly&&!selection.availabilityOnly&&(result.history_operations=PM_HISTORY_OPERATION_CONTRACT);const selectedCommand=selection.selectedCommand;result.runtime_schema={statuses:runtime.statusRegistry.definitions.map(definition=>definition.id),open_status:runtime.statusRegistry.open_status,close_status:runtime.statusRegistry.close_status,canceled_status:runtime.statusRegistry.canceled_status,types:[...runtime.typeRegistry.types],fields_by_command:Object.fromEntries([...runtime.runtimeFieldRegistry.command_to_fields.entries()].filter(([command])=>selectedCommand===void 0||command===selectedCommand).map(([command,definitions])=>[command,[...new Set(definitions.map(definition=>`--${definition.cli_flag}`))].sort((left,right)=>left.localeCompare(right))]))},!(selectedCommand!==void 0&&!selection.fullOutput)&&(result.extension_contracts={capabilities:[...PM_EXTENSION_CAPABILITY_CONTRACTS],services:[...PM_EXTENSION_SERVICE_NAME_CONTRACTS],policy_modes:[...PM_EXTENSION_POLICY_MODE_CONTRACTS],policy_mode_scope:"extensions.policy.mode",policy_surfaces:[...PM_EXTENSION_POLICY_SURFACE_CONTRACTS],trust_modes:[...PM_EXTENSION_TRUST_MODE_CONTRACTS],trust_mode_scope:"extensions.policy.trust_mode",sandbox_profiles:[...PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS],manifest_versions:[1,2],compatibility:{current:"v2",previous:["v1"],breaking_strategy:"versioned_breaking"}},result.governance_contracts={ownership_enforcement_modes:[...GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES],create_modes:[...GOVERNANCE_CREATE_MODE_DEFAULT_VALUES],close_validation_modes:[...GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES],workflow_enforcement_modes:[...GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES]},result.relationship_kind_contracts=[...BUILTIN_RELATIONSHIP_KINDS,...(runtime.runtimeProbe.registrations?.relationship_kinds??[]).flatMap(registration=>registration.definitions)].sort((left,right)=>left.kind.localeCompare(right.kind)).map(definition=>({canonical:definition.kind,aliases:[...definition.aliases??[]],...definition.inverse===void 0?{}:{inverse:definition.inverse},ordering:definition.ordering,hierarchy:definition.hierarchy})))}function attachSchemaContractsResult(result,selection,schemaContext,extensionCommandContracts){if(!(selection.flagsOnly||selection.availabilityOnly)){if(!selection.omitUnfilteredSchema){result.schema=schemaContext.filteredSchema,result.extension_commands=extensionCommandContracts;return}result.schema_omitted_reason="unfiltered_default_brief",result.extension_commands=extensionCommandContracts}}function attachFlagContractsResult(result,selection,runtime,outputCommands,commandAliases){if(!(selection.schemaOnly||selection.availabilityOnly)){if(selection.omitUnfilteredCommandFlags)result.command_flags_omitted_reason="unfiltered_default_brief";else{result.command_flags=buildCommandFlagSurface(outputCommands,runtime.extensionFlagMap,runtime.runtimeFieldFlagMap,selection.selectedCommand!==void 0,runtime.extensionContracts);const commandSet=new Set(outputCommands);result.list_projections=Object.entries(LIST_COMMAND_DEFAULT_PROJECTIONS).filter(([command])=>commandSet.has(command)).map(([command,defaultProjection])=>({command,default:defaultProjection,brief_fields:[...BRIEF_LIST_FIELDS,"priority"],compact_fields:[...DEFAULT_COMPACT_LIST_FIELDS]}))}result.command_aliases=selection.fullOutput?commandAliases:commandAliases.map(({canonical,aliases})=>({canonical,aliases})),selection.fullOutput||(result.command_alias_contracts_omitted_reason="compact_projection; restore with --full")}}function attachCommanderAliasContractsResult(result,selection){if(!(selection.schemaOnly||selection.flagsOnly||selection.availabilityOnly)){if(!selection.omitUnfilteredCommanderAliases){result.commander_aliases=buildCommanderAliasSurface();return}result.commander_aliases_omitted_reason=selection.selectedCommand?"command_scoped":"unfiltered_default_brief"}}function attachAgentCommandContractsResult(result,outputCommands,extensionCommandContracts,options){result.command_summaries=buildCommandSummarySurface(outputCommands,extensionCommandContracts,{includeFormatBudgets:options.includeFormatBudgets,includeIntentProvenance:options.includeIntentProvenance}),result.output_policy={token_estimate:"ceil(utf8_bytes / 4)",degradation_ladder:[...PM_OUTPUT_DEGRADATION_STEPS],allows_unbounded_opt_out:!0},result.output_projection_contracts={global_ladder_field:"output_policy.degradation_ladder",global_ladder_scope:"union_not_per_command",discovery:"pm contracts --command <command> --summary",...options.includeProjectionModeMatrix?{commands:[...new Set(outputCommands.map(normalizeCommandPath))].filter(command=>resolveReadOutputSurface(command)!==void 0).sort((left,right)=>left.localeCompare(right)).map(command=>({command,modes:[...readOutputIncludeModeOptions(command).keys()]}))}:{}},result.grammar_contracts={nouns:PM_CLI_GRAMMAR_CONTRACT.nouns,shared_verbs:PM_CLI_GRAMMAR_CONTRACT.shared_verbs,scope_before_verb:PM_CLI_GRAMMAR_CONTRACT.scope_before_verb,visible_top_level_ceiling:PM_CLI_GRAMMAR_CONTRACT.visible_top_level_ceiling,ceiling_raise_requires_pm_item:PM_CLI_GRAMMAR_CONTRACT.ceiling_raise_requires_pm_item,positional_shape_budget:PM_CLI_GRAMMAR_CONTRACT.positional_shape_budget,positional_shape_count:new Set(PM_COMMAND_POSITIONAL_CONTRACTS.map(({slots})=>positionalShapeKey(slots))).size,positional_action_count:PM_POSITIONAL_ACTION_CONTRACTS.length,positional_action_parents:[...new Set(PM_POSITIONAL_ACTION_CONTRACTS.map(({parent})=>parent))].sort((left,right)=>left.localeCompare(right)),...options.includePositionalSignatures?{positional_signatures:PM_COMMAND_POSITIONAL_CONTRACTS}:{}}}async function runContracts(options,global2){const selection=resolveContractsSelection(options);assertSingleContractsProjection(selection);const pmRoot=resolvePmRoot(process.cwd(),global2.path),runtime=await resolveContractsRuntimeContext(global2,pmRoot,selection),actionContext=resolveContractsActionContext(selection,runtime),schemaContext=resolveContractsSchemaContext(selection,runtime,actionContext),commands=resolveContractsCommands(selection,actionContext),outputCommands=resolveOutputCommands(selection,commands,runtime.extensionContracts),result=createContractsResult(selection,schemaContext,actionContext,outputCommands),extensionCommandContracts=resolveExtensionCommandContracts(selection,runtime,outputCommands),includeCommandDetails=selection.fullOutput||selection.selectedCommand!==void 0;if((selection.summary||selection.fullOutput)&&attachAgentCommandContractsResult(result,outputCommands,extensionCommandContracts,{includeFormatBudgets:includeCommandDetails,includeIntentProvenance:includeCommandDetails,includePositionalSignatures:includeCommandDetails,includeProjectionModeMatrix:includeCommandDetails}),selection.summary)return result;const commandAliases=buildCommandAliasSurface(actionContext.commandCatalog.filter(command=>isCommandDiscoverable(selection,command,runtime.extensionContracts)));return selection.flagsOnly&&!selection.fullOutput||attachRuntimeContractsResult(result,runtime,selection),attachSchemaContractsResult(result,selection,schemaContext,extensionCommandContracts),attachFlagContractsResult(result,selection,runtime,outputCommands,commandAliases),attachCommanderAliasContractsResult(result,selection),(selection.selectedCommand==="assurance"||selection.fullOutput)&&(result.assurance_contracts={measurement_source_kinds:[...ASSURANCE_MEASUREMENT_SOURCE_KINDS],gate_triggers:[...ASSURANCE_GATE_TRIGGERS]}),selection.fullOutput&&result.grammar_contracts&&(result.grammar_contracts.destinations=PM_COMMAND_DESTINATION_CONTRACTS.map(row=>({...row,reason:row.reason??""}))),selection.fullOutput&&!selection.schemaOnly&&!selection.flagsOnly&&!selection.availabilityOnly&&(result.mcp_tools=buildMcpToolContracts(),result.context_intents=getActiveContextIntentContracts(),result.read_output_dimensions=PM_READ_OUTPUT_SURFACE_CONTRACTS,result.error_codes=PM_ERROR_CODE_CATALOG,result.command_output_contracts=buildCommandOutputContracts(outputCommands),result.diagnostic_output_contracts=PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS,result.command_exit_contracts={vocabulary:PM_COMMAND_EXIT_OUTCOME_CONTRACTS,command_sets:buildCommandExitContractGroups(outputCommands)}),result}const _testOnlyContractsCommand={actionDescriptorMatchesSelectedCommand,attachCreateRequiredOptionContracts,buildExtensionActionSchemaBranch,buildCommandSummarySurface,buildCommandOutputContracts,buildCommandExitContractGroups,buildRuntimeFieldFlagContracts,collectActionContractDescriptors,collectExtensionCommandContracts,collectExtensionFlagContractsByCommand,extractActionBranches,extensionSchemaPropertyNameFromFlag,filterSchemaByAction,filterSchemaByActions,isCoreCommandPath,mergeExtensionContractsByAction,normalizeExtensionFlagName,normalizeActionNameFromCommand,normalizeCommandForRuntimeFieldFlags,normalizeCommandPath,packageOwnedActionForCommand,readContractsSettings,resolveActionCommandPath,resolveActionAvailability,resolveCoreCommandFlags,resolveRuntimeExtensionActionProbe,resolveScopedCommandsFromActionDescriptors,splitCommandPathAliases,toRuntimeLongFlagToken,toRuntimeShortFlagToken};export{_testOnlyContractsCommand,buildCommandAliasSurface,runContracts};
+(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]="bcdd81cd-9922-5292-b762-0e19da0e408c")}catch{}})();import{PM_TOOL_PARAMETER_PROPERTIES}from"./tool-parameter-tables.js";import{resolveExtensionFlagValueContract,resolveExtensionLongFlagName,EXIT_CODE,SETTINGS_DEFAULTS,PmCliError,activateExtensions,getActiveExtensionRegistrations,loadExtensions,pathExists,commandOptionFlagLabel,resolveCommandOptionPolicyState,resolveItemTypeRegistry,resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry,getSettingsPath,resolvePmRoot,readSettings}from"../runtime-primitives.js";import{PM_HISTORY_OPERATION_CONTRACT}from"../../core/history/operation-contract.js";import{buildMcpToolContracts}from"../../mcp/tool-definitions.js";import{ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,ACTIVITY_FLAG_CONTRACTS,AGGREGATE_FLAG_CONTRACTS,ASSURANCE_FLAG_CONTRACTS,APPEND_FLAG_CONTRACTS,CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS,CALENDAR_FLAG_CONTRACTS,CLAIM_FLAG_CONTRACTS,CLOSE_TASK_FLAG_CONTRACTS,COMMENTS_FLAG_CONTRACTS,CLOSE_FLAG_CONTRACTS,CLOSE_MANY_FLAG_CONTRACTS,COMPLETION_FLAG_CONTRACTS,CONFIG_FLAG_CONTRACTS,CONTRACTS_FLAG_CONTRACTS,COPY_FLAG_CONTRACTS,CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,CONTEXT_FLAG_CONTRACTS,CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,CREATE_COMMANDER_STRING_OPTION_CONTRACTS,CREATE_FLAG_CONTRACTS,DELETE_FLAG_CONTRACTS,DEPS_FLAG_CONTRACTS,GRAPH_FLAG_CONTRACTS,DOCS_FLAG_CONTRACTS,EXTENSION_ACTIVATE_FLAG_CONTRACTS,EXTENSION_ADOPT_ALL_FLAG_CONTRACTS,EXTENSION_ADOPT_FLAG_CONTRACTS,EXTENSION_CATALOG_FLAG_CONTRACTS,EXTENSION_DEACTIVATE_FLAG_CONTRACTS,EXTENSION_DESCRIBE_FLAG_CONTRACTS,EXTENSION_DOCTOR_FLAG_CONTRACTS,EXTENSION_EXPLORE_FLAG_CONTRACTS,EXTENSION_FLAG_CONTRACTS,EXTENSION_INIT_FLAG_CONTRACTS,EXTENSION_INSTALL_FLAG_CONTRACTS,EXTENSION_MANAGE_FLAG_CONTRACTS,EXTENSION_MIGRATE_FLAG_CONTRACTS,EXTENSION_RELOAD_FLAG_CONTRACTS,EXTENSION_UNINSTALL_FLAG_CONTRACTS,FILES_FLAG_CONTRACTS,FOCUS_FLAG_CONTRACTS,GC_FLAG_CONTRACTS,GET_FLAG_CONTRACTS,GUIDE_FLAG_CONTRACTS,GLOBAL_FLAG_CONTRACTS,HEALTH_FLAG_CONTRACTS,HISTORY_FLAG_CONTRACTS,HISTORY_COMPACT_FLAG_CONTRACTS,HISTORY_REDACT_FLAG_CONTRACTS,HISTORY_REPAIR_FLAG_CONTRACTS,HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS,INSTALL_FLAG_CONTRACTS,INIT_FLAG_CONTRACTS,ITEM_COMPLETE_FLAG_CONTRACTS,ITEM_MUTATE_FLAG_CONTRACTS,ITEM_REOPEN_FLAG_CONTRACTS,LEARNINGS_FLAG_CONTRACTS,LIST_COMMANDER_STRING_OPTION_CONTRACTS,LIST_FILTER_FLAG_CONTRACTS,MERGE_FLAG_CONTRACTS,NOTES_FLAG_CONTRACTS,PACKAGE_FLAG_CONTRACTS,PACKAGE_INIT_FLAG_CONTRACTS,PM_EXTENSION_CAPABILITY_CONTRACTS,PM_EXTENSION_POLICY_MODE_CONTRACTS,PM_EXTENSION_POLICY_SURFACE_CONTRACTS,PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS,PM_EXTENSION_SERVICE_NAME_CONTRACTS,PM_EXTENSION_TRUST_MODE_CONTRACTS,PM_OUTPUT_DEGRADATION_STEPS,PLAN_FLAG_CONTRACTS,PM_CORE_COMMAND_NAMES,PM_DEPRECATED_TOOL_ACTIONS,PM_TOOL_ACTIONS,PM_TOOL_PARAMETERS_SCHEMA,REINDEX_FLAG_CONTRACTS,RELEASE_FLAG_CONTRACTS,RESTORE_FLAG_CONTRACTS,SCHEMA_FLAG_CONTRACTS,PROFILE_FLAG_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,EVAL_FLAG_CONTRACTS,EVENTS_FLAG_CONTRACTS,WORKSPACE_FLAG_CONTRACTS,NEXT_FLAG_CONTRACTS,SEARCH_FLAG_CONTRACTS,STATS_FLAG_CONTRACTS,DUPLICATES_FLAG_CONTRACTS,START_TASK_FLAG_CONTRACTS,PAUSE_TASK_FLAG_CONTRACTS,TELEMETRY_FLAG_CONTRACTS,TEST_ALL_FLAG_CONTRACTS,TEST_FLAG_CONTRACTS,TEST_RUNS_FLAG_CONTRACTS,UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,UPDATE_FLAG_CONTRACTS,UPDATE_MANY_FLAG_CONTRACTS,UPGRADE_FLAG_CONTRACTS,VALIDATE_FLAG_CONTRACTS,compactFlagAliasContracts,SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,PM_COMMAND_ALIAS_CONTRACTS,PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS,resolvePmCommandOutputBudget}from"../cli-contracts.js";import{PM_NAMESPACED_COMMAND_ALIASES,resolvePmCommandOperation}from"./command-aliases.js";import{HISTORY_ATTEST_FLAG_CONTRACTS,PM_POSITIONAL_ACTION_FLAG_CONTRACTS,resolveSubcommandFlagContractsForCommand}from"./flag-contracts.js";import{GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES,GOVERNANCE_CREATE_MODE_DEFAULT_VALUES,GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES,GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES}from"../../types.js";import{BRIEF_LIST_FIELDS,DEFAULT_COMPACT_LIST_FIELDS,LIST_COMMAND_DEFAULT_PROJECTIONS}from"../query/list.js";import{getActiveContextIntentContracts}from"../context-intent-contracts.js";import{readOutputIncludeModeOptions,resolveReadOutputSurface,PM_READ_OUTPUT_SURFACE_CONTRACTS}from"../read-output-contracts.js";import{enrichCliFlagInvocationContracts}from"../flag-invocation-contracts.js";import{resolvePmCommandVisibilityTier}from"../agent-capability-contracts.js";import{PM_ERROR_CODE_CATALOG}from"../generated-error-code-catalog.js";import{resolvePmCommandOutputEnvelope}from"../output-contracts.js";import{PM_COMMAND_EXIT_OUTCOME_CONTRACTS,resolvePmCommandExitContract}from"./command-exit-contracts.js";import{BUILTIN_RELATIONSHIP_KINDS}from"../relationship-kinds/contract.js";import{ASSURANCE_GATE_TRIGGERS,ASSURANCE_MEASUREMENT_SOURCE_KINDS}from"../governance/assurance.js";import{PM_CLI_GRAMMAR_CONTRACT,PM_COMMAND_DESTINATION_CONTRACTS,PM_COMMAND_POSITIONAL_CONTRACTS,PM_POSITIONAL_ACTION_CONTRACTS,positionalShapeKey,resolvePmCommandPositionalContract}from"./grammar-contracts.js";const AGENT_BOOTSTRAP_FLAGS=new Map([["activity",["--limit","--after","--full"]],["claim",["--if-available","--next","--type","--priority","--token-budget","--explain-ranking"]],["close",["--reason","--validate-close","--resolution","--expected-result","--actual-result","--message"]],["context",["--limit","--after","--depth","--section","--token-budget","--explain-ranking"]],["contracts",["--command","--flags-only","--summary","--runtime-only","--availability-only","--full"]],["create",["--title","--type","--status","--priority","--dep","--comment"]],["get",["--full","--depth","--fields","--tree","--tree-depth","--format"]],["health",["--check-only","--summary","--brief","--check-telemetry","--strict-exit","--full"]],["list",["--status","--type","--limit","--after","--brief","--fields"]],["next",["--limit","--blocked-limit","--ready-only","--token-budget","--explain-ranking","--format"]],["search",["--mode","--status","--type","--limit","--after","--fields"]],["update",["--status","--message","--dep","--comment","--file","--test"]],["validate",["--check-resolution","--check-history-drift","--check-storage-integrity","--counts","--strict-exit","--fix-hints"]]]),AGENT_BOUNDED_FLAG_PRIORITY=["--limit","--after","--offset","--token-budget","--brief","--summary","--compact","--fields","--full","--format","--since","--until"],LIST_COMMAND_NAMES=new Set(["list","list-all","list-draft","list-open","list-in-progress","list-blocked","list-closed","list-canceled"]),PACKAGE_OWNED_ACTIONS=new Set(["calendar","guide","reindex","completion","test-runs-list","test-runs-status","test-runs-logs","test-runs-stop","test-runs-resume","templates-list","templates-save","templates-show"]),PACKAGE_OWNED_COMMANDS=new Set(["meet","event","remind","search-advanced","dedupe-audit","dedupe-merge","comments-audit","cal","calendar","completion","completion-statuses","completion-tags","completion-types","guide","reindex","normalize","templates","templates list","templates save","templates show","test-runs","test-runs list","test-runs status","test-runs logs","test-runs stop","test-runs resume"]),PACKAGE_OWNED_COMMAND_INSTALL_HINTS=new Map([["meet","calendar"],["event","calendar"],["remind","calendar"],["search-advanced","search-advanced"],["dedupe-audit","governance-audit"],["dedupe-merge","governance-audit"],["comments-audit","governance-audit"],["cal","calendar"],["calendar","calendar"],["completion","guide-shell"],["completion-statuses","guide-shell"],["completion-tags","guide-shell"],["completion-types","guide-shell"],["guide","guide-shell"],["reindex","search-advanced"],["normalize","governance-audit"],["templates","templates"],["templates list","templates"],["templates save","templates"],["templates show","templates"],["test-runs","linked-test-adapters"],["test-runs list","linked-test-adapters"],["test-runs status","linked-test-adapters"],["test-runs logs","linked-test-adapters"],["test-runs stop","linked-test-adapters"],["test-runs resume","linked-test-adapters"]]),PACKAGE_OWNED_ACTION_COMMAND_PATHS=new Map([["calendar","calendar|cal"],["guide","guide"],["reindex","reindex"],["completion","completion"],["test-runs-list","test-runs|test-runs list"],["test-runs-status","test-runs status"],["test-runs-logs","test-runs logs"],["test-runs-stop","test-runs stop"],["test-runs-resume","test-runs resume"],["templates-list","templates|templates list"],["templates-save","templates save"],["templates-show","templates show"]]),PACKAGE_OWNED_COMMAND_ACTIONS=new Map([...PACKAGE_OWNED_ACTION_COMMAND_PATHS.entries()].flatMap(([action,commandPaths])=>splitCommandPathAliases(commandPaths).map(commandPath=>[commandPath,action]))),CANONICAL_COMMAND_ALIASES=[{canonical:"context",aliases:["ctx"]},{canonical:"package",aliases:["extension","packages"]}],COMMAND_ALIAS_TO_CANONICAL=new Map(CANONICAL_COMMAND_ALIASES.flatMap(entry=>entry.aliases.map(alias=>[alias,entry.canonical]))),COMMAND_NAMESPACE_DISPLAY_LIMIT=10,COMMAND_NAMESPACE_FALLBACK_LIMIT=20,COMMAND_INTENTS=new Map([["activity","Read activity."],["aggregate","Group counts."],["append","Append body."],["assurance","Evaluate assurance."],["assurance derive","Derive checks."],["assurance risk","Select checks for changes."],["assurance lineages","Measure recurrence coverage."],["beads","Manage Beads interoperability."],["cal","Manage calendar integration."],["calendar","Manage calendar integration."],["changelog","Generate changelog output."],["claim","Claim work."],["close","Close work."],["close-many","Close matching work."],["close-task","Close task work."],["command-kit","Inspect command authoring primitives."],["comments","Manage comments."],["comments-audit","Audit comment governance."],["completion","Generate shell completions."],["config","Manage settings."],["context","Build context."],["contracts","Inspect contracts."],["copy","Copy work."],["create","Create work."],["dedupe-audit","Audit duplicate work."],["dedupe-merge","Merge duplicate work."],["delete","Delete work."],["deps","Manage deps."],["duplicates","Find duplicate clusters."],["docs","Link docs."],["eval","Run evaluations."],["event","Manage events."],["events","Read events."],["files","Link files."],["focus","Manage focus."],["gc","Clean caches."],["get","Read item."],["graph","Query graph."],["guide","Show user guides."],["health","Check health."],["help","Show help."],["history","Inspect history."],["init","Initialize workspace."],["install","Install packages."],["item","Mutate items."],["learnings","Manage learnings."],["list","List work."],["list-all","List work across every status."],["list-blocked","List blocked work."],["list-canceled","List canceled work."],["list-closed","List closed work."],["list-draft","List draft work."],["list-in-progress","List in-progress work."],["list-open","List open work."],["meet","Record meeting context."],["merge","Manage tracker merges."],["next","Pick next work."],["notes","Manage notes."],["normalize","Normalize tracker data."],["ops","Run operations."],["package","Manage packages."],["packages","Manage packages."],["pause-task","Pause task work."],["plan","Manage plans."],["profile","Manage profiles."],["reindex","Refresh search index."],["release","Release claim."],["remind","Manage reminders."],["restore","Restore history."],["schema","Customize schema."],["search","Search work."],["search-advanced","Run advanced search."],["start-task","Start task work."],["stats","Show stats."],["telemetry","Manage telemetry."],["templates","Manage work templates."],["test","Run linked tests."],["test-all","Run all linked tests."],["test-runs","Inspect background test runs."],["todos","Manage source-code todos."],["twin","Manage repository twins."],["update","Update work."],["update-many","Update matching work."],["upgrade","Upgrade packages."],["validate","Validate data."],["vcs","Inspect version-control context."],["workspace","Manage workspaces."],["history-author-acknowledge","Acknowledge reviewed history authors."],["history-compact","Compact history."],["history-attest","Export or verify detached history proof."],["history-redact","Redact sensitive history values."],["history-repair","Repair history integrity."]]),EXTENSION_LIFECYCLE_FLAG_CONTRACTS=[["init",EXTENSION_INIT_FLAG_CONTRACTS],["install",EXTENSION_INSTALL_FLAG_CONTRACTS],["uninstall",EXTENSION_UNINSTALL_FLAG_CONTRACTS],["explore",EXTENSION_EXPLORE_FLAG_CONTRACTS],["manage",EXTENSION_MANAGE_FLAG_CONTRACTS],["describe",EXTENSION_DESCRIBE_FLAG_CONTRACTS],["reload",EXTENSION_RELOAD_FLAG_CONTRACTS],["doctor",EXTENSION_DOCTOR_FLAG_CONTRACTS],["catalog",EXTENSION_CATALOG_FLAG_CONTRACTS],["adopt",EXTENSION_ADOPT_FLAG_CONTRACTS],["adopt-all",EXTENSION_ADOPT_ALL_FLAG_CONTRACTS],["activate",EXTENSION_ACTIVATE_FLAG_CONTRACTS],["deactivate",EXTENSION_DEACTIVATE_FLAG_CONTRACTS],["migrate",EXTENSION_MIGRATE_FLAG_CONTRACTS]],PACKAGE_LIFECYCLE_FLAG_CONTRACTS=[...EXTENSION_LIFECYCLE_FLAG_CONTRACTS.map(([subcommand,flags])=>subcommand==="init"?[subcommand,PACKAGE_INIT_FLAG_CONTRACTS]:[subcommand,flags]),["upgrade",UPGRADE_FLAG_CONTRACTS]],CORE_COMMAND_FLAG_CONTRACT_ENTRIES=[...EXTENSION_LIFECYCLE_FLAG_CONTRACTS.map(([subcommand,flags])=>[`extension ${subcommand}`,flags]),...PACKAGE_LIFECYCLE_FLAG_CONTRACTS.flatMap(([subcommand,flags])=>[[`package ${subcommand}`,flags],[`packages ${subcommand}`,flags]]),["init",INIT_FLAG_CONTRACTS],["config",CONFIG_FLAG_CONTRACTS],["extension",EXTENSION_FLAG_CONTRACTS],["package",PACKAGE_FLAG_CONTRACTS],["packages",PACKAGE_FLAG_CONTRACTS],["install",INSTALL_FLAG_CONTRACTS],["create",CREATE_FLAG_CONTRACTS],["item mutate",ITEM_MUTATE_FLAG_CONTRACTS],["item complete",ITEM_COMPLETE_FLAG_CONTRACTS],["item reopen",ITEM_REOPEN_FLAG_CONTRACTS],["copy",COPY_FLAG_CONTRACTS],["focus",FOCUS_FLAG_CONTRACTS],["update",UPDATE_FLAG_CONTRACTS],["update-many",UPDATE_MANY_FLAG_CONTRACTS],["upgrade",UPGRADE_FLAG_CONTRACTS],["calendar",CALENDAR_FLAG_CONTRACTS],["cal",CALENDAR_FLAG_CONTRACTS],["context",CONTEXT_FLAG_CONTRACTS],["ctx",CONTEXT_FLAG_CONTRACTS],["get",GET_FLAG_CONTRACTS],["search",SEARCH_FLAG_CONTRACTS],["eval",EVAL_FLAG_CONTRACTS],["events",EVENTS_FLAG_CONTRACTS],["workspace",WORKSPACE_FLAG_CONTRACTS],["workspace position",[]],["workspace snapshot",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot create",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot list",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot inspect",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot restore",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot delete",WORKSPACE_FLAG_CONTRACTS],["next",NEXT_FLAG_CONTRACTS],["aggregate",AGGREGATE_FLAG_CONTRACTS],["deps",DEPS_FLAG_CONTRACTS],["graph",GRAPH_FLAG_CONTRACTS],["guide",GUIDE_FLAG_CONTRACTS],["reindex",REINDEX_FLAG_CONTRACTS],["history",HISTORY_FLAG_CONTRACTS],["history-compact",HISTORY_COMPACT_FLAG_CONTRACTS],["history-attest",HISTORY_ATTEST_FLAG_CONTRACTS],["history-redact",HISTORY_REDACT_FLAG_CONTRACTS],["history-repair",HISTORY_REPAIR_FLAG_CONTRACTS],["history-author-acknowledge",HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS],["merge",MERGE_FLAG_CONTRACTS],["schema",SCHEMA_FLAG_CONTRACTS],["profile",PROFILE_FLAG_CONTRACTS],["plan",PLAN_FLAG_CONTRACTS],["restore",RESTORE_FLAG_CONTRACTS],["delete",DELETE_FLAG_CONTRACTS],["close",CLOSE_FLAG_CONTRACTS],["close-many",CLOSE_MANY_FLAG_CONTRACTS],["append",APPEND_FLAG_CONTRACTS],["claim",CLAIM_FLAG_CONTRACTS],["release",RELEASE_FLAG_CONTRACTS],["start-task",START_TASK_FLAG_CONTRACTS],["pause-task",PAUSE_TASK_FLAG_CONTRACTS],["close-task",CLOSE_TASK_FLAG_CONTRACTS],["comments",COMMENTS_FLAG_CONTRACTS],["notes",NOTES_FLAG_CONTRACTS],["learnings",LEARNINGS_FLAG_CONTRACTS],["files",FILES_FLAG_CONTRACTS],["docs",DOCS_FLAG_CONTRACTS],["test",TEST_FLAG_CONTRACTS],["test-runs-worker",[]],["test-all",TEST_ALL_FLAG_CONTRACTS],["telemetry",TELEMETRY_FLAG_CONTRACTS],["test-runs",TEST_RUNS_FLAG_CONTRACTS],["gc",GC_FLAG_CONTRACTS],["stats",STATS_FLAG_CONTRACTS],["ops",[]],["duplicates",DUPLICATES_FLAG_CONTRACTS],["validate",VALIDATE_FLAG_CONTRACTS],["health",HEALTH_FLAG_CONTRACTS],["assurance",ASSURANCE_FLAG_CONTRACTS],...PM_POSITIONAL_ACTION_FLAG_CONTRACTS,["contracts",CONTRACTS_FLAG_CONTRACTS],["completion",COMPLETION_FLAG_CONTRACTS],["activity",ACTIVITY_FLAG_CONTRACTS],...[...LIST_COMMAND_NAMES].map(command=>[command,LIST_FILTER_FLAG_CONTRACTS])],CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND=new Map(CORE_COMMAND_FLAG_CONTRACT_ENTRIES);for(const{alias,canonical}of PM_NAMESPACED_COMMAND_ALIASES){const flags=CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND.get(alias);flags!==void 0&&CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND.set(canonical,flags)}function packageOwnedActionForCommand(command){return PACKAGE_OWNED_COMMAND_ACTIONS.get(command)||(command.startsWith("test-runs ")?`test-runs-${command.slice(10)}`:command.startsWith("templates ")?`templates-${command.slice(10)}`:command)}function resolveActionCommandPath(action){const historyAlias=PM_NAMESPACED_COMMAND_ALIASES.find(contract=>contract.alias===action);return historyAlias?`${historyAlias.canonical}|${historyAlias.alias}`:PM_CORE_COMMAND_NAMES.includes(action)?normalizeCommandPath(action):action.startsWith("extension-")?normalizeCommandPath(`extension ${action.slice(10)}`):action.startsWith("package-")?normalizeCommandPath(`package ${action.slice(8)}`):action.startsWith("item-")?normalizeCommandPath(`item ${action.slice(5)}`):action.startsWith("test-runs-")?normalizeCommandPath(`test-runs ${action.slice(10)}`):action.startsWith("templates-")?normalizeCommandPath(`templates ${action.slice(10)}`):PACKAGE_OWNED_ACTIONS.has(action)?PACKAGE_OWNED_ACTION_COMMAND_PATHS.get(action)??normalizeCommandPath(action):null}function actionDescriptorMatchesSelectedCommand(descriptor,selectedCommand){const historyOperation=resolvePmCommandOperation(selectedCommand);return historyOperation!==selectedCommand||PM_NAMESPACED_COMMAND_ALIASES.some(entry=>entry.alias===selectedCommand)?descriptor.action===historyOperation:descriptor.command_path===null?!1:splitCommandPathAliases(descriptor.command_path).some(commandPath=>commandPath===selectedCommand?!0:commandPath.startsWith(`${selectedCommand} `)||selectedCommand.startsWith(`${commandPath} `))}function splitCommandPathAliases(commandPath){return commandPath.split("|").map(entry=>normalizeCommandPath(entry)).filter(entry=>entry.length>0)}function resolveScopedCommandsFromActionDescriptors(descriptors,commandCatalog){const commandSet=new Set(commandCatalog),scoped=new Set;for(const descriptor of descriptors)if(descriptor.command_path)for(const commandPath of splitCommandPathAliases(descriptor.command_path)){const tokens=commandPath.split(" ").filter(entry=>entry.length>0);if(tokens.length!==0)for(let end=tokens.length;end>0;end-=1){const candidate=tokens.slice(0,end).join(" ");if(commandSet.has(candidate)){scoped.add(candidate);break}}}return[...scoped].sort((left,right)=>left.localeCompare(right))}function normalizeToken(value){if(typeof value!="string")return;const trimmed=value.trim().toLowerCase();return trimmed.length>0?trimmed:void 0}function extractActionBranches(schema){const oneOf=schema.oneOf;return Array.isArray(oneOf)?oneOf.filter(entry=>typeof entry=="object"&&entry!==null):[]}function filterSchemaByAction(schema,action){if(!action)return{...schema};const filtered=extractActionBranches(schema).filter(entry=>{const properties=entry.properties;if(typeof properties!="object"||properties===null)return!1;const actionProperty=properties.action;return typeof actionProperty!="object"||actionProperty===null?!1:actionProperty.const===action});return{...schema,oneOf:filtered}}function filterSchemaByActions(schema,actions){const filtered=extractActionBranches(schema).filter(entry=>{const properties=entry.properties;if(typeof properties!="object"||properties===null)return!1;const actionProperty=properties.action;if(typeof actionProperty!="object"||actionProperty===null)return!1;const actionConst=actionProperty.const;return typeof actionConst=="string"&&actions.has(actionConst)});return{...schema,oneOf:filtered}}function normalizeCommandPath(value){return value.trim().toLowerCase().split(/\s+/).filter(entry=>entry.length>0).join(" ")}function normalizeActionNameFromCommand(commandPath){return commandPath.replace(/\s+/g,"-")}function toOptionalTrimmedString(value){if(typeof value!="string")return null;const trimmed=value.trim();return trimmed.length>0?trimmed:null}function normalizeStringList(values){if(!Array.isArray(values))return[];const normalized=[],seen=new Set;for(const value of values){const trimmed=toOptionalTrimmedString(value);!trimmed||seen.has(trimmed)||(seen.add(trimmed),normalized.push(trimmed))}return normalized}function assignExtensionFlagBoolean(contract,key,enabled){enabled&&(contract[key]=!0)}function normalizeExtensionFlagName(value,kind){if(value==null)return null;if(typeof value!="string")throw new TypeError("Expected string for extension flag name.");const trimmed=value.trim();return trimmed.length===0?null:kind==="long"?trimmed.startsWith("--")&&trimmed.length>2?resolveExtensionLongFlagName(trimmed):null:trimmed.startsWith("-")&&!trimmed.startsWith("--")&&trimmed.length>1?trimmed:null}function toExtensionFlagContract(definition){const normalizedLong=normalizeExtensionFlagName(definition.long,"long"),normalizedShort=normalizeExtensionFlagName(definition.short,"short"),flag=normalizedLong??normalizedShort;if(!flag)return null;const contract={flag};normalizedShort&&normalizedLong&&(contract.short=normalizedShort),assignExtensionFlagBoolean(contract,"required",definition.required===!0),assignExtensionFlagBoolean(contract,"repeatable",definition.repeatable===!0),assignExtensionFlagBoolean(contract,"list",definition.list===!0),definition.default!==void 0&&(contract.default=definition.default);const description=toOptionalTrimmedString(definition.description);description&&(contract.description=description);const value=resolveExtensionFlagValueContract(definition);contract.value_arity=value.value_arity;const valueName=toOptionalTrimmedString(definition.value_name)??value.value_name;valueName&&(contract.value_name=valueName);const rawValueType=value.value_type??(value.value_name?"string":null);return rawValueType&&(contract.value_type=rawValueType),contract}function collectExtensionFlagContractsByCommand(registrations){const grouped=new Map;for(const registration of registrations){const commandPath=normalizeCommandPath(registration.target_command);if(commandPath.length===0)continue;const bucket=grouped.get(commandPath)??{flags:[],sources:[],dedupe:new Set,sourceDedupe:new Set},sourceKey=`${registration.layer}:${registration.name}`;bucket.sourceDedupe.has(sourceKey)||(bucket.sourceDedupe.add(sourceKey),bucket.sources.push({layer:registration.layer,name:registration.name}));for(const definition of registration.flags){const contract=toExtensionFlagContract(definition);if(!contract)continue;const key=`${contract.flag}|${contract.short??""}`;bucket.dedupe.has(key)||(bucket.dedupe.add(key),bucket.flags.push(contract))}grouped.set(commandPath,bucket)}const normalized=new Map;for(const[commandPath,bucket]of grouped.entries())normalized.set(commandPath,{flags:bucket.flags,sources:bucket.sources.sort((left,right)=>{const layerOrder=left.layer.localeCompare(right.layer);return layerOrder!==0?layerOrder:(left.name??"").localeCompare(right.name??"")})});return normalized}function extensionReadOutputDiscovery(definition,flags){return definition.read_output===void 0?{flags}:{read_output:definition.read_output,flags:[...flags,...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS.filter(({flag})=>flag.startsWith("--output-"))]}}function collectExtensionCommandContracts(runtimeProbe){const flagsByCommand=collectExtensionFlagContractsByCommand(runtimeProbe.flagRegistrations),definitionsByCommand=new Map;for(const definition of runtimeProbe.commandDefinitions){const command=normalizeCommandPath(definition.command);if(command.length===0)continue;const action=toOptionalTrimmedString(definition.action)??normalizeActionNameFromCommand(command),args=Array.isArray(definition.arguments)?definition.arguments.map(argument=>{const name=toOptionalTrimmedString(argument.name);return name?{name,required:argument.required===!0,variadic:argument.variadic===!0,description:toOptionalTrimmedString(argument.description)}:null}).filter(argument=>argument!==null):[];definitionsByCommand.set(command,{...definition.tier===void 0?{}:{tier:definition.tier},...extensionReadOutputDiscovery(definition,flagsByCommand.get(command)?.flags??[]),command,action,source:{layer:definition.layer,name:definition.name},description:toOptionalTrimmedString(definition.description),intent:toOptionalTrimmedString(definition.intent),arguments:args,examples:normalizeStringList(definition.examples),failure_hints:normalizeStringList(definition.failure_hints)})}const extensionCommands=new Set;for(const command of runtimeProbe.handlers)extensionCommands.add(normalizeCommandPath(command));for(const command of definitionsByCommand.keys())extensionCommands.add(command);for(const command of flagsByCommand.keys())extensionCommands.add(command);const contracts=[];for(const command of[...extensionCommands].sort((left,right)=>left.localeCompare(right))){const definition=definitionsByCommand.get(command);contracts.push(buildCollectedExtensionCommandContract(command,definition,flagsByCommand.get(command)?.flags??[]))}return contracts}function buildCollectedExtensionCommandContract(command,definition,registeredFlags){return definition?{...definition,flags:definition.flags.length>0?definition.flags:registeredFlags}:{command,action:normalizeActionNameFromCommand(command),source:null,description:null,intent:null,arguments:[],flags:registeredFlags,examples:[],failure_hints:[]}}function extensionSchemaPropertyNameFromFlag(flag){const normalized=flag.flag.replace(/^-+/,"").trim();if(normalized.length===0)return null;const cleaned=normalized.replace(/-([a-z0-9])/g,(_match,char)=>char.toUpperCase()).replace(/[^a-zA-Z0-9]/g,"");return cleaned.length>0?cleaned:null}function buildExtensionArgumentSchema(argument,action){return argument.variadic?{type:"array",items:{type:"string"},description:argument.description??`Variadic argument '${argument.name}' for extension action '${action}'.`}:{type:"string",description:argument.description??`Argument '${argument.name}' for extension action '${action}'.`}}function buildExtensionFlagSchema(flag,action){const valueType=flag.value_type??"boolean",schemaType=valueType==="boolean"?"boolean":valueType==="number"?["number","string"]:"string",acceptsMultipleValues=flag.repeatable===!0||flag.list===!0;return{type:acceptsMultipleValues?"array":schemaType,...acceptsMultipleValues?{items:{type:schemaType}}:{},...flag.default!==void 0?{default:flag.default}:{},description:flag.description??`Extension option '${flag.flag}' for action '${action}'.`}}function buildExtensionActionSchemaBranch(contract){const commands=contract.command.split("|").map(command=>command.trim()).filter(command=>command.length>0),properties={action:{type:"string",const:contract.action,description:contract.intent??contract.description??`Invoke extension command '${contract.command}'.`}},required=["action"];for(const argument of contract.arguments)properties[argument.name]=buildExtensionArgumentSchema(argument,contract.action),argument.required&&required.push(argument.name);for(const flag of contract.flags){const propertyName=extensionSchemaPropertyNameFromFlag(flag);!propertyName||properties[propertyName]!==void 0||(properties[propertyName]=SUBCOMMAND_GLOBAL_FLAG_CONTRACTS.some(host=>host.flag===flag.flag&&host.flag.startsWith("--output-"))?PM_TOOL_PARAMETER_PROPERTIES[propertyName]:buildExtensionFlagSchema(flag,contract.action),flag.required===!0&&required.push(propertyName))}return{type:"object",properties,required,additionalProperties:!0,"x-extension-source":contract.source,"x-extension-command":commands[0]??contract.command,"x-extension-commands":commands}}function mergeExtensionFlagContract(existing,incoming){existing.description??=incoming.description,existing.value_name??=incoming.value_name,existing.value_type??=incoming.value_type,incoming.required===!0&&(existing.required=!0),incoming.repeatable===!0&&(existing.repeatable=!0)}function mergeExtensionContractsByAction(contracts){const byAction=new Map;for(const contract of contracts){const existing=byAction.get(contract.action);if(!existing){byAction.set(contract.action,{...contract,flags:[...contract.flags],examples:[...contract.examples],failure_hints:[...contract.failure_hints]});continue}existing.command=[...new Set([existing.command,contract.command])].sort((left,right)=>left.localeCompare(right)).join("|"),existing.arguments=existing.arguments.length>=contract.arguments.length?existing.arguments:contract.arguments;const flagKeys=new Set(existing.flags.map(flag=>`${flag.flag}|${flag.short??""}`));for(const flag of contract.flags){const key=`${flag.flag}|${flag.short??""}`;if(!flagKeys.has(key))flagKeys.add(key),existing.flags.push(flag);else{const existingFlag=existing.flags.find(candidate=>`${candidate.flag}|${candidate.short??""}`===key);existingFlag&&mergeExtensionFlagContract(existingFlag,flag)}}existing.examples=[...new Set([...existing.examples,...contract.examples])],existing.failure_hints=[...new Set([...existing.failure_hints,...contract.failure_hints])]}return[...byAction.values()].sort((left,right)=>left.action.localeCompare(right.action))}async function resolveRuntimeExtensionActionProbe(global2,readSettingsFn=readSettings){const defaultPolicyState={mode:SETTINGS_DEFAULTS.extensions.policy.mode,trust_mode:SETTINGS_DEFAULTS.extensions.policy.trust_mode,default_sandbox_profile:SETTINGS_DEFAULTS.extensions.policy.default_sandbox_profile};if(global2.noExtensions)return{handlers:new Set,disabledReason:"extensions_disabled",commandDefinitions:[],flagRegistrations:[],registrations:null,policyState:defaultPolicyState};const pmRoot=resolvePmRoot(process.cwd(),global2.path);if(!await pathExists(getSettingsPath(pmRoot)))return{handlers:new Set,disabledReason:null,commandDefinitions:[],flagRegistrations:[],registrations:null,policyState:defaultPolicyState};try{const settings=await readSettingsFn(pmRoot),loadResult=await loadExtensions({pmRoot,settings,cwd:process.cwd(),noExtensions:!1}),activationResult=await activateExtensions({...loadResult,loaded:loadResult.loaded});return{handlers:new Set(activationResult.commands.handlers.map(entry=>normalizeCommandPath(entry.command))),disabledReason:null,commandDefinitions:activationResult.registrations.commands,flagRegistrations:activationResult.registrations.flags,registrations:activationResult.registrations,policyState:{mode:loadResult.policy.mode,trust_mode:loadResult.policy.trust_mode,default_sandbox_profile:loadResult.policy.default_sandbox_profile}}}catch{return{handlers:new Set,disabledReason:"extension_runtime_probe_failed",commandDefinitions:[],flagRegistrations:[],registrations:null,policyState:defaultPolicyState}}}function collectActionContractDescriptors(extensionContracts,options={}){const descriptors=new Map;for(const action of PM_TOOL_ACTIONS){const packageOwned=PACKAGE_OWNED_ACTIONS.has(action);if(packageOwned&&!options.includePackageOwnedActions)continue;const commandPath=resolveActionCommandPath(action);descriptors.set(action,{action,provider:packageOwned?"extension":"core",requires_extension:packageOwned,command_path:commandPath})}if(options.includePackageOwnedActions)for(const action of PACKAGE_OWNED_ACTIONS)descriptors.has(action)||descriptors.set(action,{action,provider:"extension",requires_extension:!0,command_path:resolveActionCommandPath(action)});for(const contract of extensionContracts)descriptors.has(contract.action)||descriptors.set(contract.action,{action:contract.action,provider:"extension",requires_extension:!0,command_path:PM_NAMESPACED_COMMAND_ALIASES.find(entry=>entry.alias===contract.command)?.canonical??normalizeCommandPath(contract.command)});return[...descriptors.values()].sort((left,right)=>(left.action??"").localeCompare(right.action??""))}function resolveActionAvailability(descriptor,runtimeProbe){if(descriptor.provider==="core"&&!descriptor.requires_extension)return{action:descriptor.action,invocable:!0,available:!0,requires_extension:!1,provider:"core",disabled_reason:null,command_path:descriptor.command_path,cli_exposed:descriptor.command_path!==null&&(!PACKAGE_OWNED_COMMANDS.has(descriptor.action)||runtimeProbe.handlers.has(descriptor.action))};const commandPaths=descriptor.command_path?splitCommandPathAliases(descriptor.command_path):[],extensionCommandAvailable=commandPaths.some(commandPath=>runtimeProbe.handlers.has(commandPath)||runtimeProbe.handlers.has(resolvePmCommandOperation(commandPath))),optionalPackageHint=commandPaths.map(commandPath=>PACKAGE_OWNED_COMMAND_INSTALL_HINTS.get(resolvePmCommandOperation(commandPath))).find(hint=>typeof hint=="string"),invocable=runtimeProbe.disabledReason===null&&extensionCommandAvailable;return{action:descriptor.action,invocable,available:invocable,requires_extension:!0,provider:"extension",disabled_reason:invocable?null:runtimeProbe.disabledReason??(optionalPackageHint?`optional_package_not_installed:${optionalPackageHint}`:"extension_command_not_registered"),command_path:descriptor.command_path,cli_exposed:extensionCommandAvailable,policy_state:{mode:runtimeProbe.policyState.mode,trust_mode:runtimeProbe.policyState.trust_mode,default_sandbox_profile:runtimeProbe.policyState.default_sandbox_profile}}}function resolveCoreCommandFlags(command){const flags=CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND.get(command)??GLOBAL_FLAG_CONTRACTS,encoding=resolveSubcommandFlagContractsForCommand(command).find(contract=>contract.flag==="--output-format"&&contract.aliases?.includes("--format"));return encoding?[...flags,encoding]:flags}function isCoreCommandPath(command){return PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(command))?!1:CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND.has(command)}function normalizeCommandForRuntimeFieldFlags(command){return LIST_COMMAND_NAMES.has(command)?"list":command==="cal"?"calendar":command==="ctx"?"context":command==="update-many"?"update_many":command}function toRuntimeLongFlagToken(token){const trimmed=token.trim();return trimmed?trimmed.startsWith("--")?trimmed:trimmed.startsWith("-")?null:`--${trimmed}`:null}function toRuntimeShortFlagToken(token){const trimmed=token.trim();return!trimmed||trimmed.startsWith("--")?null:trimmed.startsWith("-")?trimmed:null}function buildRuntimeFieldFlagContracts(fieldRegistry){const buckets=new Map;for(const definition of fieldRegistry.definitions){const primaryFlag=toRuntimeLongFlagToken(definition.cli_flag);if(!primaryFlag)continue;const shortAlias=definition.cli_aliases.map(alias=>toRuntimeShortFlagToken(alias)).find(alias=>alias!==null),longAliases=definition.cli_aliases.map(alias=>toRuntimeLongFlagToken(alias)).filter(alias=>alias!==null&&alias!==primaryFlag);for(const command of definition.commands){const bucket=buckets.get(command)??{flags:[],seen:new Set},primaryContract=shortAlias?{flag:primaryFlag,short:shortAlias}:{flag:primaryFlag},primaryKey=`${primaryContract.flag}|${primaryContract.short??""}`;bucket.seen.has(primaryKey)||(bucket.seen.add(primaryKey),bucket.flags.push(primaryContract));for(const alias of longAliases){const key=`${alias}|`;bucket.seen.has(key)||(bucket.seen.add(key),bucket.flags.push({flag:alias}))}buckets.set(command,bucket)}}const result=new Map;for(const[command,bucket]of buckets.entries())result.set(command,compactFlagAliasContracts(bucket.flags));return result}function mergeFlagContracts(primary,secondary){const merged=[],seen=new Set;for(const contract of[...primary,...secondary]){const key=`${contract.flag}|${contract.short??""}`;seen.has(key)||(seen.add(key),merged.push(contract))}return compactFlagAliasContracts(merged)}function buildCommandFlagSurface(commands,extensionFlagMap,runtimeFieldFlagMap,includeSemanticMetadata,extensionContracts){const flagsByPath=new Map(extensionFlagMap);for(const{alias,canonical}of PM_NAMESPACED_COMMAND_ALIASES){const flags=extensionFlagMap.get(canonical)??extensionFlagMap.get(alias);flags&&(flagsByPath.set(alias,flags),flagsByPath.set(canonical,flags))}return commands.map(command=>{const isCoreCommand=isCoreCommandPath(command),coreFlags=isCoreCommand?resolveCoreCommandFlags(command):[],runtimeFlags=runtimeFieldFlagMap.get(normalizeCommandForRuntimeFieldFlags(command))??[],extensionFlags=flagsByPath.get(command),coreWithRuntime=mergeFlagContracts(coreFlags,runtimeFlags),flags=mergeFlagContracts(coreWithRuntime,extensionFlags?.flags??[]),provider=coreFlags.length>0&&(extensionFlags?.flags.length??0)>0?"mixed":isCoreCommand?"core":"extension";return{command,flags,...includeSemanticMetadata?{canonical_command:canonicalSummaryCommand(command),visibility:runtimeCommandVisibilityTier(command,extensionContracts),positionals:resolvePmCommandPositionalContract(command)?.slots??[],flag_invocations:enrichCliFlagInvocationContracts(command,flags)}:{},provider,extension_sources:extensionFlags?.sources}}).sort((left,right)=>left.command.localeCompare(right.command))}function buildCommandAliasSurface(commands,aliasContracts=PM_COMMAND_ALIAS_CONTRACTS){const commandSet=new Set(commands),grouped=new Map;for(const entry of CANONICAL_COMMAND_ALIASES){const aliases=entry.aliases.filter(alias=>commandSet.has(alias));grouped.set(entry.canonical,{canonical:entry.canonical,aliases,contracts:[]})}for(const contract of aliasContracts){if(!commandSet.has(contract.canonical)||contract.registration==="commander"&&!commandSet.has(contract.alias))continue;const entry=grouped.get(contract.canonical)??{canonical:contract.canonical,aliases:[],contracts:[]};entry.aliases.includes(contract.alias)||entry.aliases.push(contract.alias),entry.contracts.push(contract),grouped.set(contract.canonical,entry)}return[...grouped.values()].map(({contracts,...entry})=>contracts.length===0?entry:{...entry,contracts}).sort((left,right)=>left.canonical.localeCompare(right.canonical))}function buildCommanderAliasSurface(){return{create_string_options:CREATE_COMMANDER_STRING_OPTION_CONTRACTS,create_repeatable_options:CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,update_string_options:UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,update_repeatable_options:UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,list_string_options:LIST_COMMANDER_STRING_OPTION_CONTRACTS,search_string_options:SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,calendar_string_options:CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS,context_string_options:CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,activity_string_options:ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS}}function resolveCreateRequiredOptionContract(typeDefinition,createMode){const baseRequiredOptions=new Set(["title","type"]);if(createMode==="strict"){for(const field of typeDefinition.required_create_fields)baseRequiredOptions.add(field);for(const field of typeDefinition.required_create_repeatables)baseRequiredOptions.add(field)}const policyState=resolveCommandOptionPolicyState(typeDefinition,"create",baseRequiredOptions),requiredOptionKeys=[...new Set(policyState.required)].sort((left,right)=>left.localeCompare(right)),requiredFlags=[...new Set(requiredOptionKeys.map(option=>commandOptionFlagLabel("create",option)))].sort((left,right)=>left.localeCompare(right)),requiredTypeOptions=[...new Set(typeDefinition.options.filter(option=>option.required===!0).map(option=>option.key))].sort((left,right)=>left.localeCompare(right));return{required_option_keys:requiredOptionKeys,required_flags:requiredFlags,required_type_options:requiredTypeOptions,policy_errors:[...new Set(policyState.errors)].sort((left,right)=>left.localeCompare(right))}}function buildCreateRequiredOptionContracts(typeRegistry){const byTypeStrict={},byTypeProgressive={};for(const typeName of[...typeRegistry.types].sort((left,right)=>left.localeCompare(right))){const typeDefinition=typeRegistry.by_type[typeName];byTypeStrict[typeName]=resolveCreateRequiredOptionContract(typeDefinition,"strict"),byTypeProgressive[typeName]=resolveCreateRequiredOptionContract(typeDefinition,"progressive")}return{default_create_mode:"strict",by_create_mode:{strict:{by_type:byTypeStrict},progressive:{by_type:byTypeProgressive}}}}function attachCreateRequiredOptionContracts(schema,metadata){const branches=extractActionBranches(schema);if(branches.length===0)return schema;let touched=!1;const enrichedBranches=branches.map(branch=>{const properties=branch.properties;if(typeof properties!="object"||properties===null)return branch;const actionProperty=properties.action;return typeof actionProperty!="object"||actionProperty===null||actionProperty.const!=="create"?branch:(touched=!0,{...branch,"x-create-required-options":metadata})});return touched?{...schema,oneOf:enrichedBranches}:schema}function resolveContractsSelection(options){const explicitlyScoped=normalizeToken(options.action)!==void 0||normalizeToken(options.command)!==void 0,projectionSelected=options.schemaOnly===!0||options.flagsOnly===!0||options.availabilityOnly===!0,summary=options.summary===!0||options.full!==!0&&options.runtimeOnly!==!0&&!explicitlyScoped&&!projectionSelected,schemaOnly=options.schemaOnly===!0,flagsOnly=options.flagsOnly===!0,availabilityOnly=options.availabilityOnly===!0,runtimeOnly=options.runtimeOnly===!0,fullOutput=options.full===!0,selectedAction=normalizeToken(options.action),selectedCommand=normalizeToken(options.command),unfilteredDefaultBriefMode=!summary&&!fullOutput&&!schemaOnly&&!flagsOnly&&!availabilityOnly&&!selectedAction&&!selectedCommand;return{selectedAction,selectedCommand,summary,schemaOnly,flagsOnly,availabilityOnly,runtimeOnly,fullOutput,omitUnfilteredSchema:unfilteredDefaultBriefMode,omitUnfilteredCommandFlags:unfilteredDefaultBriefMode,omitUnfilteredCommanderAliases:unfilteredDefaultBriefMode||selectedCommand!==void 0&&!fullOutput}}function assertSingleContractsProjection(selection){if([selection.summary,selection.schemaOnly,selection.flagsOnly,selection.availabilityOnly].filter(value=>value).length>1)throw new PmCliError("Choose only one projection flag: --summary, --schema-only, --flags-only, or --availability-only.",EXIT_CODE.USAGE)}async function readContractsSettings(pmRoot,readSettingsFn=readSettings){try{return await readSettingsFn(pmRoot)}catch{return structuredClone(SETTINGS_DEFAULTS)}}async function resolveContractsRuntimeContext(global2,pmRoot,selection){const settings=await readContractsSettings(pmRoot),runtimeProbe=await resolveRuntimeExtensionActionProbe(global2),typeRegistry=resolveItemTypeRegistry(settings,runtimeProbe.registrations??getActiveExtensionRegistrations()),runtimeFieldRegistry=resolveRuntimeFieldRegistry(settings.schema),extensionContracts=collectExtensionCommandContracts(runtimeProbe);return{settings,runtimeProbe,typeRegistry,statusRegistry:resolveRuntimeStatusRegistry(settings.schema),runtimeFieldRegistry,runtimeFieldFlagMap:buildRuntimeFieldFlagContracts(runtimeFieldRegistry),createRequiredOptionContracts:buildCreateRequiredOptionContracts(typeRegistry),extensionContracts,mergedExtensionContracts:mergeExtensionContractsByAction(extensionContracts.filter(entry=>isCommandDiscoverable(selection,entry.command,extensionContracts))),extensionFlagMap:collectExtensionFlagContractsByCommand(runtimeProbe.flagRegistrations)}}function shouldIncludePackageOwnedActions(selection){return selection.availabilityOnly&&(selection.selectedAction!==void 0&&PACKAGE_OWNED_ACTIONS.has(selection.selectedAction)||selection.selectedCommand!==void 0&&PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(selection.selectedCommand)))}function collectContractsActionDescriptors(selection,mergedExtensionContracts){const actionDescriptors=collectActionContractDescriptors(mergedExtensionContracts,{includePackageOwnedActions:shouldIncludePackageOwnedActions(selection)});if(selection.selectedAction===void 0&&selection.selectedCommand===void 0){const deprecatedActions=new Set(PM_DEPRECATED_TOOL_ACTIONS);return actionDescriptors.filter(descriptor=>!deprecatedActions.has(descriptor.action)&&(selection.fullOutput||(mergedExtensionContracts.find(entry=>entry.action===descriptor.action)?.tier??resolvePmCommandVisibilityTier(descriptor.action))!=="internal"))}return shouldIncludePackageOwnedActions(selection)&&selection.selectedCommand!==void 0&&PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(selection.selectedCommand))&&!actionDescriptors.some(entry=>entry.command_path===selection.selectedCommand)&&actionDescriptors.push({action:packageOwnedActionForCommand(resolvePmCommandOperation(selection.selectedCommand)),provider:"extension",requires_extension:!0,command_path:selection.selectedCommand}),actionDescriptors}function assertKnownContractsAction(selection,actionDescriptors){const actionNames=new Set(actionDescriptors.map(entry=>entry.action));if(selection.selectedAction&&!actionNames.has(selection.selectedAction))throw new PmCliError(`Unknown action: "${selection.selectedAction}".`,EXIT_CODE.USAGE)}function buildContractsCommandCatalog(actionDescriptors,mergedExtensionContracts){return[...new Set([...PM_CORE_COMMAND_NAMES.filter(entry=>!PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(entry))),...[...CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND.keys()].filter(entry=>!PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(entry))),...actionDescriptors.flatMap(entry=>entry.command_path?splitCommandPathAliases(entry.command_path).filter(command=>entry.provider==="extension"||!PACKAGE_OWNED_COMMANDS.has(resolvePmCommandOperation(command))||mergedExtensionContracts.some(contract=>contract.action===entry.action)):[]),...mergedExtensionContracts.flatMap(entry=>entry.command.split("|").flatMap(command=>{const alias=PM_NAMESPACED_COMMAND_ALIASES.find(entry2=>entry2.alias===command||entry2.canonical===command);return alias===void 0?[command]:[alias.alias,alias.canonical]}))])].map(entry=>normalizeCommandPath(entry)).filter(entry=>entry.length>0).sort((left,right)=>left.localeCompare(right))}function buildCommandNamespaceError(command,namespaceChildren){const displayedNamespaceChildren=namespaceChildren.slice(0,COMMAND_NAMESPACE_DISPLAY_LIMIT),hiddenNamespaceChildCount=namespaceChildren.length-displayedNamespaceChildren.length,displayedChildCommandList=hiddenNamespaceChildCount>0?`${displayedNamespaceChildren.join(", ")}, and ${hiddenNamespaceChildCount} more`:displayedNamespaceChildren.join(", "),fallbackCandidates=namespaceChildren.slice(0,COMMAND_NAMESPACE_FALLBACK_LIMIT),childCommandExamples=namespaceChildren.slice(0,5).map(childCommand=>`pm contracts --command "${childCommand}" --flags-only --json`),suggestedChildCommand=namespaceChildren[0];return new PmCliError(`Command "${command}" is a command namespace. Choose a concrete child command: ${displayedChildCommandList}.`,EXIT_CODE.USAGE,{code:"command_namespace",required:"Use a concrete child command path listed under this namespace.",why:"Command groups expose help at the namespace root, but command flag contracts belong to executable child commands.",examples:childCommandExamples,nextSteps:[`Retry with a child command, for example: ${childCommandExamples[0]}`],recovery:{suggested_retry:`pm contracts --command "${suggestedChildCommand}" --flags-only --json`,fallback_candidates:fallbackCandidates.map(childCommand=>({source:"command_namespace",command:`pm contracts --command "${childCommand}" --flags-only --json`,reason:`Child command under ${command}`}))}})}function buildPackageOwnedCommandError(command,packageHint){return new PmCliError(`Unknown command: "${command}". Command "${command}" is provided by the optional "${packageHint}" package. Run "pm package install ${packageHint} --project" and retry.`,EXIT_CODE.USAGE,{code:"unknown_command",required:`Install the optional "${packageHint}" package, or choose a command from pm contracts --flags-only --json.`,why:"Command contracts include core commands plus commands registered by active packages and extensions.",examples:[`pm package install ${packageHint} --project`,`pm contracts --command ${command} --flags-only --json`],nextSteps:[`Install the optional package first: pm package install ${packageHint} --project`],recovery:{suggested_retry:`pm package install ${packageHint} --project`}})}function buildUnknownCommandError(command){return new PmCliError(`Unknown command: "${command}".`,EXIT_CODE.USAGE,{code:"unknown_command",required:"Use a command path listed by pm contracts --flags-only --json.",why:"Command contracts are generated from the active core, package, and extension command registry.",examples:["pm contracts --flags-only --json","pm --help"],nextSteps:["Verify spelling and active packages/extensions, then rerun with a known command path."],recovery:{suggested_retry:"pm contracts --flags-only --json"}})}function assertKnownContractsCommand(selection,commandCatalog){if(!selection.selectedCommand||new Set(commandCatalog).has(selection.selectedCommand))return;const namespaceChildren=commandCatalog.filter(command=>command.startsWith(`${selection.selectedCommand} `));if(namespaceChildren.length>0)throw buildCommandNamespaceError(selection.selectedCommand,namespaceChildren);const packageHint=PACKAGE_OWNED_COMMAND_INSTALL_HINTS.get(resolvePmCommandOperation(selection.selectedCommand));throw packageHint?buildPackageOwnedCommandError(selection.selectedCommand,packageHint):buildUnknownCommandError(selection.selectedCommand)}function resolveContractsActionContext(selection,runtime){const actionDescriptors=collectContractsActionDescriptors(selection,runtime.mergedExtensionContracts);assertKnownContractsAction(selection,actionDescriptors);const commandCatalog=buildContractsCommandCatalog(actionDescriptors,runtime.mergedExtensionContracts);assertKnownContractsCommand(selection,commandCatalog);const selectedPackageOwnedAction=selection.selectedCommand?PACKAGE_OWNED_COMMAND_ACTIONS.get(resolvePmCommandOperation(selection.selectedCommand)):void 0,commandScopedDescriptors=selection.selectedCommand?actionDescriptors.filter(descriptor=>selectedPackageOwnedAction?descriptor.action===selectedPackageOwnedAction:actionDescriptorMatchesSelectedCommand(descriptor,selection.selectedCommand)):actionDescriptors;if(selection.selectedCommand&&selection.selectedAction&&!commandScopedDescriptors.some(descriptor=>descriptor.action===selection.selectedAction))throw new PmCliError(`Action "${selection.selectedAction}" is not mapped to command "${selection.selectedCommand}" in contracts output.`,EXIT_CODE.USAGE);const scopedActionDescriptors=selection.selectedAction?commandScopedDescriptors.filter(descriptor=>descriptor.action===selection.selectedAction):commandScopedDescriptors,allActionAvailability=[...new Map(scopedActionDescriptors.map(descriptor=>resolveActionAvailability(descriptor,runtime.runtimeProbe)).map(entry=>[selectedPackageOwnedAction?entry.action:`${entry.action}|${entry.command_path??""}`,entry])).values()],actionAvailability=selection.runtimeOnly&&!selection.selectedAction&&!selection.availabilityOnly?allActionAvailability.filter(entry=>entry.invocable):allActionAvailability;return{actionDescriptors,commandCatalog,commandScopedDescriptors,scopedActionDescriptors,selectedPackageOwnedAction,actionAvailability,actions:[...new Set(actionAvailability.map(entry=>entry.action))]}}function buildSchemaActionSet(schema){return new Set(extractActionBranches(schema).map(entry=>{const properties=entry.properties;if(typeof properties!="object"||properties===null)return null;const actionProperty=properties.action;if(typeof actionProperty!="object"||actionProperty===null)return null;const actionConst=actionProperty.const;return typeof actionConst=="string"?actionConst:null}).filter(entry=>entry!==null))}function buildMergedContractsSchema(mergedExtensionContracts){const schema=PM_TOOL_PARAMETERS_SCHEMA,schemaBranches=extractActionBranches(schema),schemaActionSet=buildSchemaActionSet(schema),extensionBranches=mergedExtensionContracts.filter(contract=>!schemaActionSet.has(contract.action)).map(contract=>buildExtensionActionSchemaBranch(contract));return extensionBranches.length>0?{...schema,oneOf:[...schemaBranches,...extensionBranches]}:schema}function filterContractsSchema(selection,actionContext,mergedSchema){const descriptorActionSet=new Set(actionContext.actionDescriptors.map(descriptor=>descriptor.action)),filteredSchema=selection.selectedAction?filterSchemaByAction(mergedSchema,selection.selectedAction):selection.selectedCommand?filterSchemaByActions(mergedSchema,new Set(actionContext.scopedActionDescriptors.map(descriptor=>descriptor.action))):filterSchemaByActions(mergedSchema,descriptorActionSet);return selection.runtimeOnly&&!selection.selectedAction?filterSchemaByActions(filteredSchema,new Set(actionContext.actions)):filteredSchema}function resolveContractsSchemaContext(selection,runtime,actionContext){const mergedSchema=buildMergedContractsSchema(runtime.mergedExtensionContracts),filteredSchema=!selection.flagsOnly&&!selection.availabilityOnly?attachCreateRequiredOptionContracts(filterContractsSchema(selection,actionContext,mergedSchema),runtime.createRequiredOptionContracts):filterContractsSchema(selection,actionContext,mergedSchema);return{mergedSchema,filteredSchema}}function resolveContractsCommands(selection,actionContext){return selection.selectedCommand!==void 0?[selection.selectedCommand]:selection.selectedAction?resolveScopedCommandsFromActionDescriptors(actionContext.scopedActionDescriptors,actionContext.commandCatalog):actionContext.commandCatalog}function runtimeCommandVisibilityTier(command,extensionContracts){return extensionContracts.find(entry=>resolvePmCommandOperation(entry.command)===resolvePmCommandOperation(command))?.tier??resolvePmCommandVisibilityTier(command)}function isCommandDiscoverable(selection,command,extensionContracts){return selection.fullOutput||selection.selectedCommand!==void 0||selection.selectedAction!==void 0||runtimeCommandVisibilityTier(command,extensionContracts)!=="internal"}function resolveOutputCommands(selection,commands,extensionContracts){if(selection.selectedCommand!==void 0||selection.selectedAction!==void 0)return commands;const hiddenAliases=new Set(PM_COMMAND_ALIAS_CONTRACTS.filter(contract=>contract.hidden&&(contract.lifecycle==="deprecated"||!selection.fullOutput&&!selection.availabilityOnly)).map(contract=>contract.alias));if(selection.summary&&!selection.fullOutput)for(const alias of COMMAND_ALIAS_TO_CANONICAL.keys())hiddenAliases.add(alias);return commands.filter(command=>!hiddenAliases.has(command)&&isCommandDiscoverable(selection,command,extensionContracts))}function canonicalSummaryCommand(command){const historyAlias=PM_NAMESPACED_COMMAND_ALIASES.find(contract=>contract.alias===command||contract.canonical===command);if(historyAlias)return historyAlias.canonical;const rootCommand=command.split(" ")[0];return rootCommand.startsWith("list-")?"list":COMMAND_ALIAS_TO_CANONICAL.get(rootCommand)??rootCommand}const COMMAND_OPERATION_INTENTS=new Map([["activate","Activate"],["adopt","Adopt"],["adopt-all","Adopt all"],["catalog","Catalog"],["complete","Complete"],["create","Create"],["deactivate","Deactivate"],["delete","Delete"],["describe","Describe"],["doctor","Diagnose"],["explore","Explore"],["init","Initialize"],["inspect","Inspect"],["install","Install"],["list","List"],["manage","Manage"],["migrate","Migrate"],["mutate","Mutate"],["reload","Reload"],["restore","Restore"],["run","Run"],["snapshot","Manage snapshots for"],["uninstall","Uninstall"],["upgrade","Upgrade"]]),COMMAND_INTENT_SUBJECT_OVERRIDES=new Map([["extension adopt-all","extensions"],["package adopt-all","packages"],["workspace snapshot list","workspace snapshots"]]);function summarizeCommandIntent(command,extensionContracts){const declared=COMMAND_INTENTS.get(resolvePmCommandOperation(command))??(command.includes(" ")?void 0:COMMAND_INTENTS.get(canonicalSummaryCommand(command)));if(declared!==void 0)return{intent:declared,intent_source:"command"};const extensionContract=extensionContracts.find(contract=>splitCommandPathAliases(contract.command).some(path=>resolvePmCommandOperation(path)===resolvePmCommandOperation(command)));if(extensionContract?.intent!==null&&extensionContract?.intent!==void 0)return{intent:extensionContract.intent,intent_source:"command"};if(extensionContract?.description!==null&&extensionContract?.description!==void 0)return{intent:extensionContract.description,intent_source:"description"};const tokens=command.split(" "),operation=tokens.at(-1),subject=tokens.slice(0,-1).join(" "),verb=COMMAND_OPERATION_INTENTS.get(operation),intentSubject=COMMAND_INTENT_SUBJECT_OVERRIDES.get(command)??subject;return{intent:verb===void 0||subject.length===0?`Run ${command}.`:`${verb} ${intentSubject}.`,intent_source:"generated"}}function buildCommandSummarySurface(commands,extensionContracts=[],options={}){const includeFormatBudgets=options.includeFormatBudgets??!0,includeIntentProvenance=options.includeIntentProvenance??!0;return[...new Set(commands.map(normalizeCommandPath))].filter(command=>command.length>0).sort((left,right)=>left.localeCompare(right)).map(command=>{const budget=resolvePmCommandOutputBudget(command,{generateFallback:!0}),rootCommand=command.split(" ")[0],canonicalRoot=COMMAND_ALIAS_TO_CANONICAL.get(rootCommand)??(rootCommand.startsWith("list-")?"list":rootCommand.startsWith("history-")?"history":rootCommand),availableFlags=new Set([...resolveCoreCommandFlags(command).map(contract=>contract.flag),...extensionContracts.filter(contract=>splitCommandPathAliases(contract.command).some(path=>resolvePmCommandOperation(path)===resolvePmCommandOperation(command))).flatMap(contract=>contract.flags.map(flag=>flag.flag))]),flags=(AGENT_BOOTSTRAP_FLAGS.get(resolvePmCommandOperation(command))??AGENT_BOOTSTRAP_FLAGS.get(canonicalRoot)??AGENT_BOUNDED_FLAG_PRIORITY).filter(flag=>availableFlags.has(flag)),intent=summarizeCommandIntent(command,extensionContracts);return{command,intent:intent.intent,...includeIntentProvenance||intent.intent_source!=="command"?{intent_source:intent.intent_source}:{},...flags.length>0?{flags}:{},default_max_estimated_tokens:budget.default_max_estimated_tokens,...includeFormatBudgets?{default_max_estimated_tokens_by_format:{...budget.default_max_estimated_tokens_by_format}}:{}}})}function buildCommandOutputContracts(commands){return commands.map(command=>({budget:resolvePmCommandOutputBudget(command,{generateFallback:!0}),envelope:resolvePmCommandOutputEnvelope(command)}))}function buildCommandExitContractGroups(commands){const groups=new Map;for(const command of commands){const contract=resolvePmCommandExitContract(command),exitCodes=contract===void 0?[EXIT_CODE.SUCCESS,EXIT_CODE.GENERIC_FAILURE,EXIT_CODE.USAGE,EXIT_CODE.NOT_FOUND,EXIT_CODE.CONFLICT,EXIT_CODE.DEPENDENCY_FAILED]:contract.exit_codes,key=exitCodes.join(","),group=groups.get(key)??{commands:[],exit_codes:exitCodes};group.commands.push(command),groups.set(key,group)}return[...groups.values()]}function resolveExtensionCommandContracts(selection,runtime,outputCommands){if(selection.selectedCommand)return runtime.extensionContracts.filter(entry=>splitCommandPathAliases(entry.command).some(path=>resolvePmCommandOperation(path)===resolvePmCommandOperation(selection.selectedCommand)));if(selection.selectedAction){const outputCommandSet=new Set(outputCommands);return runtime.extensionContracts.filter(entry=>splitCommandPathAliases(entry.command).some(command=>outputCommandSet.has(command)))}return runtime.extensionContracts.filter(entry=>isCommandDiscoverable(selection,entry.command,runtime.extensionContracts))}function createContractsResult(selection,schemaContext,actionContext,outputCommands){return{schema_version:typeof schemaContext.mergedSchema["x-schema-version"]=="string"?schemaContext.mergedSchema["x-schema-version"]:null,schema_id:typeof schemaContext.mergedSchema.$id=="string"?schemaContext.mergedSchema.$id:null,selected:{action:selection.selectedAction??null,command:selection.selectedCommand??null,summary:selection.summary,schema_only:selection.schemaOnly,flags_only:selection.flagsOnly,availability_only:selection.availabilityOnly,runtime_only:selection.runtimeOnly,command_scoped:selection.selectedCommand!==void 0},commands:selection.summary?[]:outputCommands,...!selection.summary&&!selection.flagsOnly?{actions:actionContext.actions,action_availability:actionContext.actionAvailability}:{}}}function attachRuntimeContractsResult(result,runtime,selection){(selection.selectedCommand==="history"||selection.fullOutput)&&!selection.flagsOnly&&!selection.schemaOnly&&!selection.availabilityOnly&&(result.history_operations=PM_HISTORY_OPERATION_CONTRACT);const selectedCommand=selection.selectedCommand;result.runtime_schema={statuses:runtime.statusRegistry.definitions.map(definition=>definition.id),open_status:runtime.statusRegistry.open_status,close_status:runtime.statusRegistry.close_status,canceled_status:runtime.statusRegistry.canceled_status,types:[...runtime.typeRegistry.types],fields_by_command:Object.fromEntries([...runtime.runtimeFieldRegistry.command_to_fields.entries()].filter(([command])=>selectedCommand===void 0||command===selectedCommand).map(([command,definitions])=>[command,[...new Set(definitions.map(definition=>`--${definition.cli_flag}`))].sort((left,right)=>left.localeCompare(right))]))},!(selectedCommand!==void 0&&!selection.fullOutput)&&(result.extension_contracts={capabilities:[...PM_EXTENSION_CAPABILITY_CONTRACTS],services:[...PM_EXTENSION_SERVICE_NAME_CONTRACTS],policy_modes:[...PM_EXTENSION_POLICY_MODE_CONTRACTS],policy_mode_scope:"extensions.policy.mode",policy_surfaces:[...PM_EXTENSION_POLICY_SURFACE_CONTRACTS],trust_modes:[...PM_EXTENSION_TRUST_MODE_CONTRACTS],trust_mode_scope:"extensions.policy.trust_mode",sandbox_profiles:[...PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS],manifest_versions:[1,2],compatibility:{current:"v2",previous:["v1"],breaking_strategy:"versioned_breaking"}},result.governance_contracts={ownership_enforcement_modes:[...GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES],create_modes:[...GOVERNANCE_CREATE_MODE_DEFAULT_VALUES],close_validation_modes:[...GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES],workflow_enforcement_modes:[...GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES]},result.relationship_kind_contracts=[...BUILTIN_RELATIONSHIP_KINDS,...(runtime.runtimeProbe.registrations?.relationship_kinds??[]).flatMap(registration=>registration.definitions)].sort((left,right)=>left.kind.localeCompare(right.kind)).map(definition=>({canonical:definition.kind,aliases:[...definition.aliases??[]],...definition.inverse===void 0?{}:{inverse:definition.inverse},ordering:definition.ordering,hierarchy:definition.hierarchy})))}function attachSchemaContractsResult(result,selection,schemaContext,extensionCommandContracts){if(!(selection.flagsOnly||selection.availabilityOnly)){if(!selection.omitUnfilteredSchema){result.schema=schemaContext.filteredSchema,result.extension_commands=extensionCommandContracts;return}result.schema_omitted_reason="unfiltered_default_brief",result.extension_commands=extensionCommandContracts}}function attachFlagContractsResult(result,selection,runtime,outputCommands,commandAliases){if(!(selection.schemaOnly||selection.availabilityOnly)){if(selection.omitUnfilteredCommandFlags)result.command_flags_omitted_reason="unfiltered_default_brief";else{result.command_flags=buildCommandFlagSurface(outputCommands,runtime.extensionFlagMap,runtime.runtimeFieldFlagMap,selection.selectedCommand!==void 0,runtime.extensionContracts);const commandSet=new Set(outputCommands);result.list_projections=Object.entries(LIST_COMMAND_DEFAULT_PROJECTIONS).filter(([command])=>commandSet.has(command)).map(([command,defaultProjection])=>({command,default:defaultProjection,brief_fields:[...BRIEF_LIST_FIELDS,"priority"],compact_fields:[...DEFAULT_COMPACT_LIST_FIELDS]}))}result.command_aliases=selection.fullOutput?commandAliases:commandAliases.map(({canonical,aliases})=>({canonical,aliases})),selection.fullOutput||(result.command_alias_contracts_omitted_reason="compact_projection; restore with --full")}}function attachCommanderAliasContractsResult(result,selection){if(!(selection.schemaOnly||selection.flagsOnly||selection.availabilityOnly)){if(!selection.omitUnfilteredCommanderAliases){result.commander_aliases=buildCommanderAliasSurface();return}result.commander_aliases_omitted_reason=selection.selectedCommand?"command_scoped":"unfiltered_default_brief"}}function attachAgentCommandContractsResult(result,outputCommands,extensionCommandContracts,options){result.command_summaries=buildCommandSummarySurface(outputCommands,extensionCommandContracts,{includeFormatBudgets:options.includeFormatBudgets,includeIntentProvenance:options.includeIntentProvenance}),result.output_policy={token_estimate:"ceil(utf8_bytes / 4)",degradation_ladder:[...PM_OUTPUT_DEGRADATION_STEPS],allows_unbounded_opt_out:!0},result.output_projection_contracts={global_ladder_field:"output_policy.degradation_ladder",global_ladder_scope:"union_not_per_command",discovery:"pm contracts --command <command> --summary",...options.includeProjectionModeMatrix?{commands:[...new Set(outputCommands.map(normalizeCommandPath))].filter(command=>resolveReadOutputSurface(command)!==void 0).sort((left,right)=>left.localeCompare(right)).map(command=>({command,modes:[...readOutputIncludeModeOptions(command).keys()]}))}:{}},result.grammar_contracts={nouns:PM_CLI_GRAMMAR_CONTRACT.nouns,shared_verbs:PM_CLI_GRAMMAR_CONTRACT.shared_verbs,scope_before_verb:PM_CLI_GRAMMAR_CONTRACT.scope_before_verb,visible_top_level_ceiling:PM_CLI_GRAMMAR_CONTRACT.visible_top_level_ceiling,ceiling_raise_requires_pm_item:PM_CLI_GRAMMAR_CONTRACT.ceiling_raise_requires_pm_item,positional_shape_budget:PM_CLI_GRAMMAR_CONTRACT.positional_shape_budget,positional_shape_count:new Set(PM_COMMAND_POSITIONAL_CONTRACTS.map(({slots})=>positionalShapeKey(slots))).size,positional_action_count:PM_POSITIONAL_ACTION_CONTRACTS.length,positional_action_parents:[...new Set(PM_POSITIONAL_ACTION_CONTRACTS.map(({parent})=>parent))].sort((left,right)=>left.localeCompare(right)),...options.includePositionalSignatures?{positional_signatures:PM_COMMAND_POSITIONAL_CONTRACTS}:{}}}async function runContracts(options,global2){const selection=resolveContractsSelection(options);assertSingleContractsProjection(selection);const pmRoot=resolvePmRoot(process.cwd(),global2.path),runtime=await resolveContractsRuntimeContext(global2,pmRoot,selection),actionContext=resolveContractsActionContext(selection,runtime),schemaContext=resolveContractsSchemaContext(selection,runtime,actionContext),commands=resolveContractsCommands(selection,actionContext),outputCommands=resolveOutputCommands(selection,commands,runtime.extensionContracts),result=createContractsResult(selection,schemaContext,actionContext,outputCommands),extensionCommandContracts=resolveExtensionCommandContracts(selection,runtime,outputCommands),includeCommandDetails=selection.fullOutput||selection.selectedCommand!==void 0;if((selection.summary||selection.fullOutput)&&attachAgentCommandContractsResult(result,outputCommands,extensionCommandContracts,{includeFormatBudgets:includeCommandDetails,includeIntentProvenance:includeCommandDetails,includePositionalSignatures:includeCommandDetails,includeProjectionModeMatrix:includeCommandDetails}),selection.summary)return result;const commandAliases=buildCommandAliasSurface(actionContext.commandCatalog.filter(command=>isCommandDiscoverable(selection,command,runtime.extensionContracts)));return selection.flagsOnly&&!selection.fullOutput||attachRuntimeContractsResult(result,runtime,selection),attachSchemaContractsResult(result,selection,schemaContext,extensionCommandContracts),attachFlagContractsResult(result,selection,runtime,outputCommands,commandAliases),attachCommanderAliasContractsResult(result,selection),(selection.selectedCommand==="assurance"||selection.fullOutput)&&(result.assurance_contracts={measurement_source_kinds:[...ASSURANCE_MEASUREMENT_SOURCE_KINDS],gate_triggers:[...ASSURANCE_GATE_TRIGGERS]}),selection.fullOutput&&result.grammar_contracts&&(result.grammar_contracts.destinations=PM_COMMAND_DESTINATION_CONTRACTS.map(row=>({...row,reason:row.reason??""}))),selection.fullOutput&&!selection.schemaOnly&&!selection.flagsOnly&&!selection.availabilityOnly&&(result.mcp_tools=buildMcpToolContracts(),result.context_intents=getActiveContextIntentContracts(),result.read_output_dimensions=PM_READ_OUTPUT_SURFACE_CONTRACTS,result.error_codes=PM_ERROR_CODE_CATALOG,result.command_output_contracts=buildCommandOutputContracts(outputCommands),result.diagnostic_output_contracts=PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS,result.command_exit_contracts={vocabulary:PM_COMMAND_EXIT_OUTCOME_CONTRACTS,command_sets:buildCommandExitContractGroups(outputCommands)}),result}const _testOnlyContractsCommand={actionDescriptorMatchesSelectedCommand,attachCreateRequiredOptionContracts,buildExtensionActionSchemaBranch,buildCommandSummarySurface,buildCommandOutputContracts,buildCommandExitContractGroups,buildRuntimeFieldFlagContracts,collectActionContractDescriptors,collectExtensionCommandContracts,collectExtensionFlagContractsByCommand,extractActionBranches,extensionSchemaPropertyNameFromFlag,filterSchemaByAction,filterSchemaByActions,isCoreCommandPath,mergeExtensionContractsByAction,normalizeExtensionFlagName,normalizeActionNameFromCommand,normalizeCommandForRuntimeFieldFlags,normalizeCommandPath,packageOwnedActionForCommand,readContractsSettings,resolveActionCommandPath,resolveActionAvailability,resolveCoreCommandFlags,resolveRuntimeExtensionActionProbe,resolveScopedCommandsFromActionDescriptors,splitCommandPathAliases,toRuntimeLongFlagToken,toRuntimeShortFlagToken};export{_testOnlyContractsCommand,buildCommandAliasSurface,runContracts};
 //# sourceMappingURL=runtime-contracts.js.map