@unbrained/pm-cli 2026.9.27 → 2026.9.28

package/.claude-plugin/marketplace.json

@@ -4,16 +4,14 @@
     "name": "unbrained",
     "url": "https://github.com/unbraind/pm-cli"
   },
-  "metadata": {
-    "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
-    "version": "2026.9.27"
-  },
+  "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
+  "version": "2026.9.28",
   "plugins": [
     {
       "name": "pm-claude",
       "source": "./plugins/pm-claude",
-      "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
-      "version": "2026.9.27",
+      "description": "Native pm CLI integration for Claude Code — 32 MCP tools, 14 workflow skills with slash invocations, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
+      "version": "2026.9.28",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 2026.9.28 - 2026-09-28
+
+### Fixed
+
+- Allow self-isolating linked package tests without inherited PM_PATH ([pm-t05d8d](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-t05d8d.toon))
+- Preserve every tracker merge fence during nested init and detect lost active mappings ([pm-kynkl8](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-kynkl8.toon))
+- GH-1325: history diff cursor drops newest rows and strands the final page ([pm-c3aiik](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-c3aiik.toon))
+- Windows nightly merge-receipt classification test exceeds 60-second budget ([pm-v0600g](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-v0600g.toon))
+- GH-1327: Windows nightly static inventory unreadable-source assertion fails ([pm-ft90q2](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-ft90q2.toon))
+- GH-1326: Windows nightly bundled-package init test exceeds 30 seconds ([pm-kvhnb5](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-kvhnb5.toon))
+- MCP detached task completion coverage can miss cleanup under hosted shards ([pm-tm6h9x](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-tm6h9x.toon))
+- Full coverage refusal-closure retry test exceeds its four-minute budget under suite contention ([pm-mrrci4](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-mrrci4.toon))
+- GH-1328: linked-test execution does not disclose item evidence recording ([pm-aao1hy](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-aao1hy.toon))
+- GH-1330: per-command JSON help inherits the root intent and init example ([pm-s8ztcl](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-s8ztcl.toon))
+- Refuse malformed settings writes with typed recovery ([pm-z329kd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-z329kd.toon))
+- Refuse local package installation when source scan stops at entry limit ([pm-erogk1](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-erogk1.toon))
+
+### Security
+
+- Exclude Git metadata from local package directory installs ([pm-k7nxaz](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-k7nxaz.toon))
+
+### Other
+
+- Refresh September 27 compatible development dependency releases ([pm-u9qqip](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-u9qqip.toon))
+- Claude plugin spec-alignment hygiene vs 2026-07-11 official docs (minor, non-blocking) ([pm-dudr](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-dudr.toon))
+
 ## 2026.9.27 - 2026-09-27
 
 ### Fixed

package/dist/cli/help-json-payload.js

@@ -1,4 +1,4 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2561058a-135b-5e9b-b6e0-29518e3b4c4b")}catch(e2){}})();import{hasSubcommandFlagContractsForCommand,PM_COMMAND_ALIAS_CONTRACTS,PM_CORE_COMMAND_NAMES,resolvePmCommandOperation}from"../sdk/cli-contracts.js";import{commandOptionFlagLabel,resolveCommandOptionPolicyState,resolveTypeDefinition,EXIT_CODE,writeStderr,writeStdout}from"../sdk/runtime-primitives.js";import{buildDynamicExtensionHelpOptionSummaries,mergeHelpOptionSummaries,findCommandByPath,findDirectChildCommand,commandAliases}from"./extension-command-help.js";import{getPmCommandHelpVisibilityTier,isFullHelpDiscovery,normalizeHelpCommandPath,resolveHelpDetailMode,resolveHelpNarrative}from"./help-content.js";import{getCommandPath}from"./registration-helpers.js";import{parseBootstrapGlobalOptions,parseBootstrapHelpRequest,parseBootstrapCommandName,parseBootstrapTypeValue}from"./bootstrap-args.js";import{extractProvidedOptionFlags,renderPmCommand}from"./argv-utils.js";import{formatCommanderErrorForJson}from"./error-guidance.js";import{BUILTIN_TYPE_HELP_VALUES,buildUnknownCommandGuidanceFromRuntime,isKnownHelpCommandPath}from"./commander-usage.js";import{attachOutputTokenAccounting}from"../sdk/output-token-accounting.js";import{resolveCreateExplicitEmptyFlag}from"../sdk/agent/create-option-policy.js";import{formatPmPositionalActionFlagTip,PM_POSITIONAL_ACTION_CONTRACTS,resolvePmPositionalActionContract}from"../sdk/cli-contracts/grammar-contracts.js";import{resolvePmCommandCapabilityFamily,resolvePmCommandVisibilityTier}from"../sdk/agent-capability-contracts.js";const EXTENSION_TIER_ORDER={core:0,standard:1,full:2,internal:3};function resolveExtensionCommandSurface(commandPath,descriptors,allowDescendants=true){const exact=descriptors.get(resolvePmCommandOperation(commandPath));if(exact)return exact;if(!allowDescendants)return void 0;const descendants=[...descriptors.entries()].filter(([path])=>path.startsWith(`${commandPath} `)).map(([,descriptor])=>descriptor);if(descendants.length===0)return void 0;const tier=descendants.reduce((selected,descriptor)=>EXTENSION_TIER_ORDER[descriptor.tier]<EXTENSION_TIER_ORDER[selected]?descriptor.tier:selected,"internal");const families=new Set(descendants.map(({family})=>family));return{tier,family:families.size===1?descendants[0].family:"extensions"}}function resolveCommandFromPathTokens(root,pathTokens){if(pathTokens.length===0){return root}const exactCommand=findCommandByPath(root,pathTokens);if(exactCommand){return exactCommand}const requestedPath=pathTokens.join(" ");if(resolvePmCommandOperation(requestedPath)!==requestedPath)return null;if(!PM_CORE_COMMAND_NAMES.some(commandName=>commandName===requestedPath)&&!hasSubcommandFlagContractsForCommand(requestedPath)&&!resolvePmPositionalActionContract(requestedPath)&&!isKnownHelpCommandPath(root,pathTokens)){return null}for(let length=pathTokens.length-1;length>0;length-=1){const positionalParent=findCommandByPath(root,pathTokens.slice(0,length));if(positionalParent){return positionalParent}}return pathTokens.length===1?root:null}function extractOptionValueName(flags){const match=flags.match(/[<[]([^>\]]+)[>\]]/);if(!match){return null}const value=match[1]?.trim();return value&&value.length>0?value:null}function readOptionAttributeName(option){const optionRecord=option;if(typeof optionRecord.attributeName==="function"){const value=optionRecord.attributeName();return typeof value==="string"&&value.trim().length>0?value.trim():null}if(typeof optionRecord.attributeName==="string"&&optionRecord.attributeName.trim().length>0){return optionRecord.attributeName.trim()}return null}function buildOptionAliasMap(options){const aliasMap=new Map;for(const option of options){const optionRecord=option;const attributeName=readOptionAttributeName(option);if(!attributeName||typeof optionRecord.long!=="string"||optionRecord.long.trim().length===0){continue}const existing=aliasMap.get(attributeName)??[];existing.push(optionRecord.long.trim());aliasMap.set(attributeName,existing)}for(const[attributeName,values]of aliasMap.entries()){aliasMap.set(attributeName,[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right)))}return aliasMap}function renderAttemptedCommand(argv){return renderPmCommand(argv)}function buildHelpOptionSummaries(command){const options=command.options??[];const optionAliasMap=buildOptionAliasMap(options);return options.map(option=>{const optionRecord=option;const flags=typeof optionRecord.flags==="string"?optionRecord.flags.trim():"";const description=typeof optionRecord.description==="string"?optionRecord.description.trim():"";const attributeName=readOptionAttributeName(option);const aliasCandidates=attributeName?optionAliasMap.get(attributeName)??[]:[];const aliases=aliasCandidates.filter(entry=>entry!==optionRecord.long).map(entry=>entry.trim()).filter(entry=>entry.length>0);const aliasForMatch=description.match(/^Alias for ([^ ]+)/i);const aliasFor=aliasForMatch&&aliasForMatch[1]?aliasForMatch[1].trim():null;const required=optionRecord.mandatory===true||description.includes("[required]")||description.toLowerCase().includes("required;");const valueRequired=flags.includes("<");const takesValue=valueRequired||flags.includes("[");const summary={flags,long:typeof optionRecord.long==="string"?optionRecord.long:null,short:typeof optionRecord.short==="string"?optionRecord.short:null,description,takes_value:takesValue,value_required:valueRequired,value_name:extractOptionValueName(flags),variadic:optionRecord.variadic===true,required,aliases,alias_for:aliasFor};if(optionRecord.defaultValue!==void 0){summary.default_value=optionRecord.defaultValue}return summary})}function compactHelpOptionAliases(options){const canonicalByLong=new Map;const aliasOptions=[];for(const option of options){if(option.alias_for&&option.long){aliasOptions.push(option);continue}if(option.long){canonicalByLong.set(option.long,option)}}for(const aliasOption of aliasOptions){const aliasFor=aliasOption.alias_for;const canonical=canonicalByLong.get(aliasFor);if(!canonical){continue}const aliasLong=aliasOption.long;const aliases=new Set([...canonical.aliases??[],aliasLong]);canonical.aliases=[...aliases].sort((left,right)=>left.localeCompare(right))}return options.filter(option=>{if(!option.alias_for||!option.long){return true}return!canonicalByLong.has(option.alias_for)})}function buildHelpArgumentSummaries(command){const commandRecord=command;const argumentsList=Array.isArray(commandRecord.registeredArguments)?commandRecord.registeredArguments:Array.isArray(commandRecord._args)?commandRecord._args:[];return argumentsList.map(argument=>{const rawName=typeof argument.name==="function"?argument.name():typeof argument.name==="string"?argument.name:"argument";const description=typeof argument.description==="string"&&argument.description.trim().length>0?argument.description.trim():null;return{name:rawName.trim(),required:argument.required===true||description?.toLowerCase().startsWith("required;")===true,variadic:argument.variadic===true,description}})}function buildHelpSubcommandSummaries(command,extensionDescriptors=new Map,includeAll=false){const visible=command.createHelp().visibleCommands(command);const candidates=includeAll?[...new Set([...visible,...command.commands])]:visible;return candidates.filter(entry=>entry.name()!=="help"||command.parent===null).filter(entry=>!includeAll||(getPmCommandHelpVisibilityTier(entry)??resolvePmCommandVisibilityTier(entry.name()))!=="internal").map(entry=>{const commandPath=normalizeHelpCommandPath(getCommandPath(entry));const rootCommand=commandPath;const declaredTier=getPmCommandHelpVisibilityTier(entry);const extensionDescriptor=resolveExtensionCommandSurface(commandPath,extensionDescriptors,declaredTier!==void 0);const aliasContract=PM_COMMAND_ALIAS_CONTRACTS.find(({alias})=>alias===commandPath);return{name:entry.name().trim(),aliases:commandAliases(entry),description:entry.description().trim(),tier:extensionDescriptor?.tier??declaredTier??resolvePmCommandVisibilityTier(rootCommand),family:extensionDescriptor?.family??resolvePmCommandCapabilityFamily(rootCommand),...aliasContract?{alias_for:aliasContract.canonical,alias_lifecycle:aliasContract.lifecycle,...aliasContract.lifecycle==="deprecated"?{deprecated:true}:{}}:{}}}).sort((left,right)=>left.name.localeCompare(right.name))}function buildJsonHelpNarrative(detailMode,fallbackNarrative,extensionDescriptor){if(!extensionDescriptor){return fallbackNarrative}const extensionExamples=extensionDescriptor.examples??[];const extensionFailureHints=extensionDescriptor.failure_hints??[];return{intent:extensionDescriptor.intent??extensionDescriptor.description??fallbackNarrative.intent,examples:detailMode==="detailed"?extensionExamples.length>0?[...extensionExamples]:[...fallbackNarrative.examples]:extensionExamples.length>0?[extensionExamples[0]]:[...fallbackNarrative.examples],tips:detailMode==="detailed"?extensionFailureHints.length>0?[...extensionFailureHints]:[...fallbackNarrative.tips]:[],detail_mode:detailMode}}function resolveJsonHelpVisibilityTier(rootCommandPath,extensionDescriptor){if(rootCommandPath===void 0)return null;return extensionDescriptor?.tier??resolvePmCommandVisibilityTier(rootCommandPath)}function resolveJsonHelpCapabilityFamily(rootCommandPath,extensionDescriptor){if(rootCommandPath===void 0)return null;return extensionDescriptor?.family??resolvePmCommandCapabilityFamily(rootCommandPath)}function projectFullCommandAliases(rootProgram,targetCommand,fullDiscovery){if(targetCommand!==rootProgram||!fullDiscovery)return void 0;return PM_COMMAND_ALIAS_CONTRACTS.map(contract=>({alias:contract.alias,canonical:contract.canonical,canonical_argv:[...contract.canonical_argv],lifecycle:contract.lifecycle,hidden:contract.hidden,deprecated:contract.lifecycle==="deprecated"}))}function buildPositionalActionHelpProjection(action,targetCommand,resolvedPath,allOptions,extensionDescriptors=new Map,includeAll=false){if(!action){const argumentsList=buildHelpArgumentSummaries(targetCommand);const registeredSubcommands=buildHelpSubcommandSummaries(targetCommand,extensionDescriptors,includeAll);const registeredSubcommandNames=new Set(registeredSubcommands.map(({name})=>name));return{arguments:argumentsList,options:allOptions,subcommands:[...registeredSubcommands,...PM_POSITIONAL_ACTION_CONTRACTS.filter(({parent,action:name})=>parent===resolvedPath&&!registeredSubcommandNames.has(name)).map(({action:name,description})=>({name,aliases:[],description,tier:resolvePmCommandVisibilityTier(resolvedPath.split(" ")[0]),family:resolvePmCommandCapabilityFamily(resolvedPath.split(" ")[0])}))].sort((left,right)=>left.name.localeCompare(right.name)),usage:[resolvedPath,argumentsList.reduce((usage,argument)=>argument.required?usage.replace(`[${argument.name}${argument.variadic?"...":""}]`,`<${argument.name}${argument.variadic?"...":""}>`):usage,targetCommand.usage())].filter(token=>token.length>0).join(" ")}}const acceptedFlags=new Set(action.accepted_flags);return{arguments:action.slots.map(({name,required,variadic,value_kind:valueKind,polymorphic})=>({name,required,variadic,description:polymorphic?`Polymorphic ${valueKind} value; inspect the action contract before mutation.`:`${valueKind.replaceAll("_"," ")} value.`})),options:allOptions.filter(({long,aliases})=>long!==null&&acceptedFlags.has(long)||aliases.some(alias=>acceptedFlags.has(alias))),subcommands:[],usage:[action.command,...action.slots.map(({name,required,variadic})=>{const token=variadic?`${name}...`:name;return required?`<${token}>`:`[${token}]`})].join(" ")}}function buildJsonHelpPayload(rootProgram,targetCommand,argv,requestedPath,extensionDescriptors){const detailMode=resolveHelpDetailMode(argv);const fullDiscovery=isFullHelpDiscovery(argv);const commanderPath=normalizeHelpCommandPath(getCommandPath(targetCommand));const requestedCommandPath=normalizeHelpCommandPath(requestedPath.join(" "));const resolvedPath=requestedCommandPath.length>commanderPath.length?requestedCommandPath:commanderPath;const positionalAction=resolvePmPositionalActionContract(resolvedPath);const projectedPath=positionalAction?.command??commanderPath;const commandPath=projectedPath.length>0?projectedPath:void 0;const rootCommandPath=commandPath;const fallbackNarrative=resolveHelpNarrative(commandPath,detailMode);const extensionDescriptor=commandPath?extensionDescriptors.get(resolvePmCommandOperation(commandPath)):void 0;const extensionSurface=commandPath?resolveExtensionCommandSurface(commandPath,extensionDescriptors,getPmCommandHelpVisibilityTier(targetCommand)!==void 0):void 0;const narrative=buildJsonHelpNarrative(detailMode,fallbackNarrative,extensionDescriptor);const allOptionSummaries=compactHelpOptionAliases(mergeHelpOptionSummaries(buildHelpOptionSummaries(targetCommand),buildDynamicExtensionHelpOptionSummaries(extensionDescriptor)));const projection=buildPositionalActionHelpProjection(positionalAction,targetCommand,projectedPath,allOptionSummaries,extensionDescriptors,fullDiscovery);const fullCommandAliases=projectFullCommandAliases(rootProgram,targetCommand,fullDiscovery);return{format:"pm_help_v1",detail_mode:detailMode,root_command:rootProgram.name(),requested_path:requestedPath,resolved_path:projectedPath.length>0?projectedPath:rootProgram.name(),visibility_tier:resolveJsonHelpVisibilityTier(rootCommandPath,extensionSurface),capability_family:resolveJsonHelpCapabilityFamily(rootCommandPath,extensionSurface),description:positionalAction?.description??targetCommand.description(),usage:projection.usage,intent:positionalAction?.description??narrative.intent,examples:positionalAction?[positionalAction.example]:narrative.examples,tips:positionalAction?[formatPmPositionalActionFlagTip(positionalAction.accepted_flags)]:narrative.tips,arguments:projection.arguments,options:projection.options,subcommands:projection.subcommands,has_subcommands:projection.subcommands.length>0,...fullCommandAliases===void 0?{}:{command_aliases:fullCommandAliases}}}async function maybeRenderBootstrapJsonHelp(rootProgram,argv,extensionDescriptors,requestedArgv=argv){const bootstrapGlobal=parseBootstrapGlobalOptions(argv);if(!bootstrapGlobal.json){return false}const helpRequest=parseBootstrapHelpRequest(argv);if(!helpRequest.requested){return false}const targetCommand=resolveCommandFromPathTokens(rootProgram,helpRequest.commandPathTokens);if(!targetCommand){if(!bootstrapGlobal.quiet){const unknownMessage=`unknown command '${resolvePmCommandOperation(helpRequest.commandPathTokens.join(" "))}'`;const runtimeContext=buildUnknownCommandGuidanceFromRuntime(unknownMessage,rootProgram,extensionDescriptors);const envelope=formatCommanderErrorForJson(unknownMessage,"help",BUILTIN_TYPE_HELP_VALUES,EXIT_CODE.USAGE,{...runtimeContext,attemptedCommand:renderAttemptedCommand(argv),normalizedInvocationArgs:[...argv],providedOptionFlags:extractProvidedOptionFlags(argv)});const output=bootstrapGlobal.tokenAccounting?attachOutputTokenAccounting(envelope,value=>`${JSON.stringify(value,null,2)}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a0e4b3f7-ace2-5190-8e60-83d67109e95d")}catch(e2){}})();import{hasSubcommandFlagContractsForCommand,PM_COMMAND_ALIAS_CONTRACTS,PM_CORE_COMMAND_NAMES,resolvePmCommandOperation}from"../sdk/cli-contracts.js";import{commandOptionFlagLabel,resolveCommandOptionPolicyState,resolveTypeDefinition,EXIT_CODE,writeStderr,writeStdout}from"../sdk/runtime-primitives.js";import{buildDynamicExtensionHelpOptionSummaries,mergeHelpOptionSummaries,findCommandByPath,findDirectChildCommand,commandAliases}from"./extension-command-help.js";import{getPmCommandHelpVisibilityTier,isFullHelpDiscovery,normalizeHelpCommandPath,resolveHelpBundleForPath,resolveHelpDetailMode,resolveHelpNarrative,ROOT_HELP_BUNDLE}from"./help-content.js";import{getCommandPath}from"./registration-helpers.js";import{parseBootstrapGlobalOptions,parseBootstrapHelpRequest,parseBootstrapCommandName,parseBootstrapTypeValue}from"./bootstrap-args.js";import{extractProvidedOptionFlags,renderPmCommand}from"./argv-utils.js";import{formatCommanderErrorForJson}from"./error-guidance.js";import{BUILTIN_TYPE_HELP_VALUES,buildUnknownCommandGuidanceFromRuntime,isKnownHelpCommandPath}from"./commander-usage.js";import{attachOutputTokenAccounting}from"../sdk/output-token-accounting.js";import{resolveCreateExplicitEmptyFlag}from"../sdk/agent/create-option-policy.js";import{formatPmPositionalActionFlagTip,PM_POSITIONAL_ACTION_CONTRACTS,resolvePmPositionalActionContract}from"../sdk/cli-contracts/grammar-contracts.js";import{resolvePmCommandCapabilityFamily,resolvePmCommandVisibilityTier}from"../sdk/agent-capability-contracts.js";const EXTENSION_TIER_ORDER={core:0,standard:1,full:2,internal:3};function resolveExtensionCommandSurface(commandPath,descriptors,allowDescendants=true){const exact=descriptors.get(resolvePmCommandOperation(commandPath));if(exact)return exact;if(!allowDescendants)return void 0;const descendants=[...descriptors.entries()].filter(([path])=>path.startsWith(`${commandPath} `)).map(([,descriptor])=>descriptor);if(descendants.length===0)return void 0;const tier=descendants.reduce((selected,descriptor)=>EXTENSION_TIER_ORDER[descriptor.tier]<EXTENSION_TIER_ORDER[selected]?descriptor.tier:selected,"internal");const families=new Set(descendants.map(({family})=>family));return{tier,family:families.size===1?descendants[0].family:"extensions"}}function resolveCommandFromPathTokens(root,pathTokens){if(pathTokens.length===0){return root}const exactCommand=findCommandByPath(root,pathTokens);if(exactCommand){return exactCommand}const requestedPath=pathTokens.join(" ");if(resolvePmCommandOperation(requestedPath)!==requestedPath)return null;if(!PM_CORE_COMMAND_NAMES.some(commandName=>commandName===requestedPath)&&!hasSubcommandFlagContractsForCommand(requestedPath)&&!resolvePmPositionalActionContract(requestedPath)&&!isKnownHelpCommandPath(root,pathTokens)){return null}for(let length=pathTokens.length-1;length>0;length-=1){const positionalParent=findCommandByPath(root,pathTokens.slice(0,length));if(positionalParent){return positionalParent}}return pathTokens.length===1?root:null}function extractOptionValueName(flags){const match=flags.match(/[<[]([^>\]]+)[>\]]/);if(!match){return null}const value=match[1]?.trim();return value&&value.length>0?value:null}function readOptionAttributeName(option){const optionRecord=option;if(typeof optionRecord.attributeName==="function"){const value=optionRecord.attributeName();return typeof value==="string"&&value.trim().length>0?value.trim():null}if(typeof optionRecord.attributeName==="string"&&optionRecord.attributeName.trim().length>0){return optionRecord.attributeName.trim()}return null}function buildOptionAliasMap(options){const aliasMap=new Map;for(const option of options){const optionRecord=option;const attributeName=readOptionAttributeName(option);if(!attributeName||typeof optionRecord.long!=="string"||optionRecord.long.trim().length===0){continue}const existing=aliasMap.get(attributeName)??[];existing.push(optionRecord.long.trim());aliasMap.set(attributeName,existing)}for(const[attributeName,values]of aliasMap.entries()){aliasMap.set(attributeName,[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right)))}return aliasMap}function renderAttemptedCommand(argv){return renderPmCommand(argv)}function buildHelpOptionSummaries(command){const options=command.options??[];const optionAliasMap=buildOptionAliasMap(options);return options.map(option=>{const optionRecord=option;const flags=typeof optionRecord.flags==="string"?optionRecord.flags.trim():"";const description=typeof optionRecord.description==="string"?optionRecord.description.trim():"";const attributeName=readOptionAttributeName(option);const aliasCandidates=attributeName?optionAliasMap.get(attributeName)??[]:[];const aliases=aliasCandidates.filter(entry=>entry!==optionRecord.long).map(entry=>entry.trim()).filter(entry=>entry.length>0);const aliasForMatch=description.match(/^Alias for ([^ ]+)/i);const aliasFor=aliasForMatch&&aliasForMatch[1]?aliasForMatch[1].trim():null;const required=optionRecord.mandatory===true||description.includes("[required]")||description.toLowerCase().includes("required;");const valueRequired=flags.includes("<");const takesValue=valueRequired||flags.includes("[");const summary={flags,long:typeof optionRecord.long==="string"?optionRecord.long:null,short:typeof optionRecord.short==="string"?optionRecord.short:null,description,takes_value:takesValue,value_required:valueRequired,value_name:extractOptionValueName(flags),variadic:optionRecord.variadic===true,required,aliases,alias_for:aliasFor};if(optionRecord.defaultValue!==void 0){summary.default_value=optionRecord.defaultValue}return summary})}function compactHelpOptionAliases(options){const canonicalByLong=new Map;const aliasOptions=[];for(const option of options){if(option.alias_for&&option.long){aliasOptions.push(option);continue}if(option.long){canonicalByLong.set(option.long,option)}}for(const aliasOption of aliasOptions){const aliasFor=aliasOption.alias_for;const canonical=canonicalByLong.get(aliasFor);if(!canonical){continue}const aliasLong=aliasOption.long;const aliases=new Set([...canonical.aliases??[],aliasLong]);canonical.aliases=[...aliases].sort((left,right)=>left.localeCompare(right))}return options.filter(option=>{if(!option.alias_for||!option.long){return true}return!canonicalByLong.has(option.alias_for)})}function buildHelpArgumentSummaries(command){const commandRecord=command;const argumentsList=Array.isArray(commandRecord.registeredArguments)?commandRecord.registeredArguments:Array.isArray(commandRecord._args)?commandRecord._args:[];return argumentsList.map(argument=>{const rawName=typeof argument.name==="function"?argument.name():typeof argument.name==="string"?argument.name:"argument";const description=typeof argument.description==="string"&&argument.description.trim().length>0?argument.description.trim():null;return{name:rawName.trim(),required:argument.required===true||description?.toLowerCase().startsWith("required;")===true,variadic:argument.variadic===true,description}})}function buildHelpSubcommandSummaries(command,extensionDescriptors=new Map,includeAll=false){const visible=command.createHelp().visibleCommands(command);const candidates=includeAll?[...new Set([...visible,...command.commands])]:visible;return candidates.filter(entry=>entry.name()!=="help"||command.parent===null).filter(entry=>!includeAll||(getPmCommandHelpVisibilityTier(entry)??resolvePmCommandVisibilityTier(entry.name()))!=="internal").map(entry=>{const commandPath=normalizeHelpCommandPath(getCommandPath(entry));const rootCommand=commandPath;const declaredTier=getPmCommandHelpVisibilityTier(entry);const extensionDescriptor=resolveExtensionCommandSurface(commandPath,extensionDescriptors,declaredTier!==void 0);const aliasContract=PM_COMMAND_ALIAS_CONTRACTS.find(({alias})=>alias===commandPath);return{name:entry.name().trim(),aliases:commandAliases(entry),description:entry.description().trim(),tier:extensionDescriptor?.tier??declaredTier??resolvePmCommandVisibilityTier(rootCommand),family:extensionDescriptor?.family??resolvePmCommandCapabilityFamily(rootCommand),...aliasContract?{alias_for:aliasContract.canonical,alias_lifecycle:aliasContract.lifecycle,...aliasContract.lifecycle==="deprecated"?{deprecated:true}:{}}:{}}}).sort((left,right)=>left.name.localeCompare(right.name))}function buildJsonHelpNarrative(detailMode,fallbackNarrative,extensionDescriptor){if(!extensionDescriptor){return fallbackNarrative}const extensionExamples=extensionDescriptor.examples??[];const extensionFailureHints=extensionDescriptor.failure_hints??[];return{intent:extensionDescriptor.intent??extensionDescriptor.description??fallbackNarrative.intent,examples:detailMode==="detailed"?extensionExamples.length>0?[...extensionExamples]:[...fallbackNarrative.examples]:extensionExamples.length>0?[extensionExamples[0]]:[...fallbackNarrative.examples],tips:detailMode==="detailed"?extensionFailureHints.length>0?[...extensionFailureHints]:[...fallbackNarrative.tips]:[],detail_mode:detailMode}}function resolveJsonHelpNarrative(commandPath,commandDescription,detailMode,extensionDescriptor,hasPositionalAction){const isRootFallback=commandPath!==void 0&&resolveHelpBundleForPath(commandPath)===ROOT_HELP_BUNDLE;const fallback=isRootFallback?{intent:commandDescription,examples:[`pm ${commandPath} --help`],tips:[],detail_mode:detailMode}:resolveHelpNarrative(commandPath,detailMode);const intentSource=hasPositionalAction?"positional_action":extensionDescriptor?.intent||extensionDescriptor?.description?"extension":isRootFallback?commandDescription?"command_description":"unavailable":commandPath?"help_bundle":"root_help_bundle";return{narrative:buildJsonHelpNarrative(detailMode,fallback,extensionDescriptor),intentSource}}function resolveJsonHelpVisibilityTier(rootCommandPath,extensionDescriptor){if(rootCommandPath===void 0)return null;return extensionDescriptor?.tier??resolvePmCommandVisibilityTier(rootCommandPath)}function resolveJsonHelpCapabilityFamily(rootCommandPath,extensionDescriptor){if(rootCommandPath===void 0)return null;return extensionDescriptor?.family??resolvePmCommandCapabilityFamily(rootCommandPath)}function projectFullCommandAliases(rootProgram,targetCommand,fullDiscovery){if(targetCommand!==rootProgram||!fullDiscovery)return void 0;return PM_COMMAND_ALIAS_CONTRACTS.map(contract=>({alias:contract.alias,canonical:contract.canonical,canonical_argv:[...contract.canonical_argv],lifecycle:contract.lifecycle,hidden:contract.hidden,deprecated:contract.lifecycle==="deprecated"}))}function buildPositionalActionHelpProjection(action,targetCommand,resolvedPath,allOptions,extensionDescriptors=new Map,includeAll=false){if(!action){const argumentsList=buildHelpArgumentSummaries(targetCommand);const registeredSubcommands=buildHelpSubcommandSummaries(targetCommand,extensionDescriptors,includeAll);const registeredSubcommandNames=new Set(registeredSubcommands.map(({name})=>name));return{arguments:argumentsList,options:allOptions,subcommands:[...registeredSubcommands,...PM_POSITIONAL_ACTION_CONTRACTS.filter(({parent,action:name})=>parent===resolvedPath&&!registeredSubcommandNames.has(name)).map(({action:name,description})=>({name,aliases:[],description,tier:resolvePmCommandVisibilityTier(resolvedPath.split(" ")[0]),family:resolvePmCommandCapabilityFamily(resolvedPath.split(" ")[0])}))].sort((left,right)=>left.name.localeCompare(right.name)),usage:[resolvedPath,argumentsList.reduce((usage,argument)=>argument.required?usage.replace(`[${argument.name}${argument.variadic?"...":""}]`,`<${argument.name}${argument.variadic?"...":""}>`):usage,targetCommand.usage())].filter(token=>token.length>0).join(" ")}}const acceptedFlags=new Set(action.accepted_flags);return{arguments:action.slots.map(({name,required,variadic,value_kind:valueKind,polymorphic})=>({name,required,variadic,description:polymorphic?`Polymorphic ${valueKind} value; inspect the action contract before mutation.`:`${valueKind.replaceAll("_"," ")} value.`})),options:allOptions.filter(({long,aliases})=>long!==null&&acceptedFlags.has(long)||aliases.some(alias=>acceptedFlags.has(alias))),subcommands:[],usage:[action.command,...action.slots.map(({name,required,variadic})=>{const token=variadic?`${name}...`:name;return required?`<${token}>`:`[${token}]`})].join(" ")}}function buildJsonHelpPayload(rootProgram,targetCommand,argv,requestedPath,extensionDescriptors){const detailMode=resolveHelpDetailMode(argv);const fullDiscovery=isFullHelpDiscovery(argv);const commanderPath=normalizeHelpCommandPath(getCommandPath(targetCommand));const requestedCommandPath=normalizeHelpCommandPath(requestedPath.join(" "));const resolvedPath=requestedCommandPath.length>commanderPath.length?requestedCommandPath:commanderPath;const positionalAction=resolvePmPositionalActionContract(resolvedPath);const projectedPath=positionalAction?.command??commanderPath;const commandPath=projectedPath.length>0?projectedPath:void 0;const rootCommandPath=commandPath;const extensionDescriptor=commandPath?extensionDescriptors.get(resolvePmCommandOperation(commandPath)):void 0;const extensionSurface=commandPath?resolveExtensionCommandSurface(commandPath,extensionDescriptors,getPmCommandHelpVisibilityTier(targetCommand)!==void 0):void 0;const{narrative,intentSource}=resolveJsonHelpNarrative(commandPath,targetCommand.description().trim(),detailMode,extensionDescriptor,positionalAction!==void 0);const allOptionSummaries=compactHelpOptionAliases(mergeHelpOptionSummaries(buildHelpOptionSummaries(targetCommand),buildDynamicExtensionHelpOptionSummaries(extensionDescriptor)));const projection=buildPositionalActionHelpProjection(positionalAction,targetCommand,projectedPath,allOptionSummaries,extensionDescriptors,fullDiscovery);const fullCommandAliases=projectFullCommandAliases(rootProgram,targetCommand,fullDiscovery);return{format:"pm_help_v1",detail_mode:detailMode,root_command:rootProgram.name(),requested_path:requestedPath,resolved_path:projectedPath.length>0?projectedPath:rootProgram.name(),visibility_tier:resolveJsonHelpVisibilityTier(rootCommandPath,extensionSurface),capability_family:resolveJsonHelpCapabilityFamily(rootCommandPath,extensionSurface),description:positionalAction?.description??targetCommand.description(),usage:projection.usage,intent:positionalAction?.description??narrative.intent,intent_source:intentSource,examples:positionalAction?[positionalAction.example]:narrative.examples,tips:positionalAction?[formatPmPositionalActionFlagTip(positionalAction.accepted_flags)]:narrative.tips,arguments:projection.arguments,options:projection.options,subcommands:projection.subcommands,has_subcommands:projection.subcommands.length>0,...fullCommandAliases===void 0?{}:{command_aliases:fullCommandAliases}}}async function maybeRenderBootstrapJsonHelp(rootProgram,argv,extensionDescriptors,requestedArgv=argv){const bootstrapGlobal=parseBootstrapGlobalOptions(argv);if(!bootstrapGlobal.json){return false}const helpRequest=parseBootstrapHelpRequest(argv);if(!helpRequest.requested){return false}const targetCommand=resolveCommandFromPathTokens(rootProgram,helpRequest.commandPathTokens);if(!targetCommand){if(!bootstrapGlobal.quiet){const unknownMessage=`unknown command '${resolvePmCommandOperation(helpRequest.commandPathTokens.join(" "))}'`;const runtimeContext=buildUnknownCommandGuidanceFromRuntime(unknownMessage,rootProgram,extensionDescriptors);const envelope=formatCommanderErrorForJson(unknownMessage,"help",BUILTIN_TYPE_HELP_VALUES,EXIT_CODE.USAGE,{...runtimeContext,attemptedCommand:renderAttemptedCommand(argv),normalizedInvocationArgs:[...argv],providedOptionFlags:extractProvidedOptionFlags(argv)});const output=bootstrapGlobal.tokenAccounting?attachOutputTokenAccounting(envelope,value=>`${JSON.stringify(value,null,2)}
 `):envelope;writeStderr(`${JSON.stringify(output,null,2)}
 `)}process.exitCode=EXIT_CODE.USAGE;return true}if(!bootstrapGlobal.quiet){const payload=buildJsonHelpPayload(rootProgram,targetCommand,argv,helpRequest.commandPathTokens,extensionDescriptors);payload.requested_path=parseBootstrapHelpRequest(requestedArgv).commandPathTokens;writeStdout(`${JSON.stringify(payload,null,2)}
 `)}process.exitCode=EXIT_CODE.SUCCESS;return true}function buildCreateUpdatePolicyIntro(commandName,typeRegistry){const lines=["","Type-aware option policies:","  pass --type <value> with --help to render required/disabled/hidden option policy details for that type.",`  active type values: ${typeRegistry.types.join("|")}`];if(commandName==="create"){lines.push("  scheduling shortcut: use --schedule-preset lightweight for Reminder/Meeting/Event minimal create flows.")}return lines.join("\n")}function appendTypeOptionHelpLines(lines,typeDefinition){if(typeDefinition.options.length===0){lines.push("  type options: none");return}lines.push("  type options:");for(const option of typeDefinition.options){const requiredLabel=option.required?" (required)":"";const aliases=option.aliases??[];lines.push(`    - ${option.key}${requiredLabel}`);lines.push(`      values: ${option.values.length>0?option.values.join("|"):"any non-empty string"}`);lines.push(`      aliases: ${aliases.length>0?aliases.join("|"):"none"}`);if(option.description&&option.description.trim().length>0){lines.push(`      description: ${option.description.trim()}`)}}}function buildCreatePolicyRequiredSets(commandName,typeDefinition){const progressive=commandName==="create"?new Set(["title","type"]):new Set;const strict=new Set(progressive);if(commandName==="create"){for(const option of[...typeDefinition.required_create_fields,...typeDefinition.required_create_repeatables]){strict.add(option)}}return{progressive,strict}}function appendStrictCreatePolicyHelpLines(lines,typeDefinition,progressiveRequired,strictRequired){const progressive=new Set(progressiveRequired);const strictOnly=strictRequired.filter(option=>!progressive.has(option));const toFlags=options=>options.length>0?options.map(option=>commandOptionFlagLabel("create",option)).join(", "):"none";lines.push(`  required in strict mode: ${toFlags(strictOnly)}`);const explicitEmptyFlags=strictOnly.map(resolveCreateExplicitEmptyFlag).filter(flag=>flag!==void 0);lines.push(`  explicit empty assertion: ${explicitEmptyFlags.length>0?explicitEmptyFlags.join(", "):"none"}`);if(["Reminder","Meeting","Event"].includes(typeDefinition.name)){lines.push("  schedule preset: --schedule-preset lightweight switches schedule artifacts to progressive required-option policy.");lines.push("  strict parity remains available via --create-mode strict.")}}function buildCreateUpdatePolicyHelpText(commandName,typeRegistry,argv){const selectedTypeRaw=parseBootstrapTypeValue(argv);if(!selectedTypeRaw){return buildCreateUpdatePolicyIntro(commandName,typeRegistry)}const typeDefinition=resolveTypeDefinition(selectedTypeRaw,typeRegistry);if(!typeDefinition){const allowed=typeRegistry.types.join("|");return["",`Type-aware option policies: type "${selectedTypeRaw}" is not in the active registry.`,`  active type values: ${allowed}`].join("\n")}const argumentTerminatorIndex=argv.indexOf("--");const optionArgv=argumentTerminatorIndex<0?argv:argv.slice(0,argumentTerminatorIndex);const createModeTokenIndex=optionArgv.findIndex(token=>token==="--create-mode"||token.startsWith("--create-mode="));const createModeToken=createModeTokenIndex<0?void 0:optionArgv[createModeTokenIndex]?.startsWith("--create-mode=")?optionArgv[createModeTokenIndex]?.slice("--create-mode=".length):optionArgv[createModeTokenIndex+1];const strictCreateMode=commandName==="create"&&createModeToken?.toLowerCase()==="strict";const requiredSets=buildCreatePolicyRequiredSets(commandName,typeDefinition);const progressivePolicyState=resolveCommandOptionPolicyState(typeDefinition,commandName,requiredSets.progressive);const policyState=resolveCommandOptionPolicyState(typeDefinition,commandName,strictCreateMode?requiredSets.strict:requiredSets.progressive);const toFlags=options=>options.length>0?options.map(option=>commandOptionFlagLabel(commandName,option)).join(", "):"none";const lines=["",`Type-aware option policies for ${typeDefinition.name}:`,`  required: ${toFlags(policyState.required)}`,`  disabled: ${toFlags(policyState.disabled)}`,`  hidden: ${toFlags(policyState.hidden)}`];if(commandName==="create"){const strictPolicyState=resolveCommandOptionPolicyState(typeDefinition,commandName,requiredSets.strict);appendStrictCreatePolicyHelpLines(lines,typeDefinition,progressivePolicyState.required,strictPolicyState.required)}appendTypeOptionHelpLines(lines,typeDefinition);if(policyState.errors.length>0){lines.push(`  config errors: ${policyState.errors.join("; ")}`)}return lines.join("\n")}function attachCreateUpdatePolicyHelpText(rootProgram,typeRegistry,argv){const bootstrapCommand=parseBootstrapCommandName(argv);if(bootstrapCommand!=="create"&&bootstrapCommand!=="update"){return}const command=findDirectChildCommand(rootProgram,bootstrapCommand);if(!command){return}command.addHelpText("after",buildCreateUpdatePolicyHelpText(bootstrapCommand,typeRegistry,argv))}const _testOnly={attachCreateUpdatePolicyHelpText,buildCreateUpdatePolicyHelpText,buildJsonHelpPayload,buildPositionalActionHelpProjection,buildHelpArgumentSummaries,buildHelpOptionSummaries,buildHelpSubcommandSummaries,buildOptionAliasMap,compactHelpOptionAliases,readOptionAttributeName,resolveCommandFromPathTokens,resolveExtensionCommandSurface};export{_testOnly,attachCreateUpdatePolicyHelpText,maybeRenderBootstrapJsonHelp};

package/dist/cli/register-operations.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="af2cd676-7ace-5b65-aaf0-0a167a72df95")}catch(e2){}})();import{resolvePmCommandAlias,renderPmCommandAliasMigrationHint}from"../sdk/cli-contracts/command-aliases.js";import{setActiveCommandResult,EXIT_CODE,PmCliError,createUnknownSubcommandError,resolveAuthor,resolvePmRoot,readSettings}from"../sdk/runtime-primitives.js";import{runStartTask,runPauseTask,runCloseTask}from"../sdk/lifecycle/task-composition.js";import{parseStatsAnalyticsJson}from"./stats-analytics-json.js";import{createWorkspaceSnapshot,deleteWorkspaceSnapshot,inspectWorkspaceSnapshot,listWorkspaceSnapshots,planWorkspaceSnapshotRestore,restoreWorkspaceSnapshotWithRecovery,WORKSPACE_SNAPSHOT_ACTIONS}from"../sdk/workspace-snapshot.js";import{readWorkspacePosition}from"../sdk/governance/workspace-position.js";import{runClaim,runClaimNext,runRelease}from"./commands/lifecycle/claim.js";import{runContracts}from"./commands/workspace/contracts.js";import{runDuplicates}from"./commands/query/duplicates.js";import{runGc}from"./commands/governance/gc.js";import{runHealth}from"./commands/governance/health.js";import{runStats}from"./commands/query/stats.js";import{runTelemetry}from"./commands/governance/telemetry.js";import{runTest}from"./commands/test/test.js";import{runTestAll}from"./commands/test/test-all.js";import{runStartBackgroundRun,runTestRunsWorker}from"./commands/test/test-runs.js";import{runValidate}from"./commands/governance/validate.js";import{buildBackgroundTestAllCommandArgs,applyActiveCommandResultService,buildBackgroundTestCommandArgs,addHiddenOption,collect,getGlobalOptions,invalidateSearchCachesForMutation,printError,printResult,readOptionString}from"./registration-helpers.js";import{registerAssuranceCommand}from"./register-assurance.js";function resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand){const normalizedNamespace=namespaceOrSubcommand?.trim().toLowerCase();const normalizedSubcommand=subcommand?.trim().toLowerCase();if(normalizedNamespace===void 0||normalizedNamespace.length===0){return normalizedSubcommand}if(normalizedNamespace==="local-analytics"){return normalizedSubcommand&&normalizedSubcommand.length>0?normalizedSubcommand:"status"}if(normalizedSubcommand!==void 0&&normalizedSubcommand.length>0){throw createUnknownSubcommandError({command_path:"telemetry",token:`${namespaceOrSubcommand} ${subcommand}`,allowed:["status","flush","stats","clear","local-analytics"],token_kind:"path",examples:["pm telemetry stats --limit 10","pm telemetry local-analytics status --json"]})}return normalizedNamespace}function collectTestMutationValues(options){return{addValues:Array.isArray(options.add)?options.add:[],addJsonValues:Array.isArray(options.addJson)?options.addJson:[],removeValues:Array.isArray(options.remove)?options.remove:[],removeIndexValues:Array.isArray(options.removeIndex)?options.removeIndex:[]}}function validateBackgroundTestOptions(options,values){if(options.background!==true){return}if(options.run!==true){throw new PmCliError("--background requires --run",EXIT_CODE.USAGE)}if(options.acknowledgeLinkedTests===true){throw new PmCliError("--background cannot be combined with --acknowledge-linked-tests; acknowledgement is a non-executing foreground operation",EXIT_CODE.USAGE)}if(values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||values.removeIndexValues.length>0){throw new PmCliError("--background does not support --add/--add-json/--remove/--remove-index; update linked tests first, then run in background",EXIT_CODE.USAGE)}}async function runBackgroundLinkedTests(id,options,globalOptions,values){const result=await runStartBackgroundRun({kind:"test",commandArgs:buildBackgroundTestCommandArgs(id,{...options,add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues}),targetId:id,author:typeof options.author==="string"?options.author:void 0,noExtensions:globalOptions.noExtensions===true},globalOptions);printResult(result,globalOptions)}function buildRunTestOptions(options,values){return{add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues,list:Boolean(options.list),run:Boolean(options.run),match:typeof options.match==="string"?options.match:void 0,onlyIndex:typeof options.onlyIndex==="string"||typeof options.onlyIndex==="number"?options.onlyIndex:void 0,onlyLast:Boolean(options.onlyLast),timeout:typeof options.timeout==="string"?options.timeout:void 0,progress:Boolean(options.progress),envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:Boolean(options.sharedHostSafe),pmContext:typeof options.pmContext==="string"?options.pmContext:void 0,overrideLinkedPmContext:Boolean(options.overrideLinkedPmContext),workspaceContext:typeof options.workspaceContext==="string"?options.workspaceContext:void 0,overrideLinkedWorkspaceContext:Boolean(options.overrideLinkedWorkspaceContext),allowUntrustedLinkedTests:Boolean(options.allowUntrustedLinkedTests),acknowledgeLinkedTests:Boolean(options.acknowledgeLinkedTests),failOnContextMismatch:Boolean(options.failOnContextMismatch),failOnSkipped:Boolean(options.failOnSkipped),failOnEmptyTestRun:Boolean(options.failOnEmptyTestRun),requireAssertionsForPm:Boolean(options.requireAssertionsForPm),checkContext:Boolean(options.checkContext),autoPmContext:Boolean(options.autoPmContext),author:typeof options.author==="string"?options.author:void 0,message:typeof options.message==="string"?options.message:void 0,force:Boolean(options.force),measure:Array.isArray(options.measure)?options.measure:[],metricBelow:typeof options.metricBelow==="string"?options.metricBelow:void 0,metricDiff:typeof options.metricDiff==="string"?options.metricDiff:void 0}}const _testOnlyRegisterOperations={buildRunTestOptions,buildRunTestAllOptions,runWorkspacePositionAction,validateBackgroundTestOptions};async function runForegroundLinkedTests(id,options,globalOptions,values){const result=await runTest(id,buildRunTestOptions(options,values),globalOptions);if(values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||options.run===true||values.removeIndexValues.length>0){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(result,globalOptions);if(result.run_results.some(entry=>entry.status==="failed")||result.fail_on_skipped_triggered===true){process.exitCode=EXIT_CODE.DEPENDENCY_FAILED}}async function runTestCommandAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const values=collectTestMutationValues(options);validateBackgroundTestOptions(options,values);if(options.background===true){await runBackgroundLinkedTests(id,options,globalOptions,values)}else{await runForegroundLinkedTests(id,options,globalOptions,values)}if(globalOptions.profile){printError(`profile:command=test took_ms=${Date.now()-startedAt}`)}}function buildLifecycleMutationOptions(options){const author=readOptionString(options,"author");const assignee=readOptionString(options,"assignee");if(author!==void 0&&assignee!==void 0&&author!==assignee){throw new PmCliError("Lifecycle ownership received conflicting --author and --assignee values; use one actor value for both aliases.",EXIT_CODE.USAGE,{code:"conflicting_lifecycle_owner",examples:["pm claim pm-123","pm claim pm-123 --start","pm release pm-123"]})}return{author:author??assignee,message:readOptionString(options,"message")}}async function runTestAllAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const runInBackground=options.background===true;if(runInBackground){const result2=await runStartBackgroundRun({kind:"test-all",commandArgs:buildBackgroundTestAllCommandArgs(options),statusFilter:readOptionString(options,"status"),noExtensions:globalOptions.noExtensions===true},globalOptions);printResult(result2,globalOptions);if(globalOptions.profile){printError(`profile:command=test-all took_ms=${Date.now()-startedAt}`)}return}const result=await runTestAll(buildRunTestAllOptions(options),globalOptions);await invalidateSearchCachesForMutation(globalOptions,{ids:result.results.map(entry=>entry.id)});printResult(result,globalOptions);if(result.failed>0||result.fail_on_skipped_triggered===true){process.exitCode=EXIT_CODE.DEPENDENCY_FAILED}if(globalOptions.profile){printError(`profile:command=test-all took_ms=${Date.now()-startedAt}`)}}function buildRunTestAllOptions(options){return{status:readOptionString(options,"status"),limit:readOptionString(options,"limit"),offset:readOptionString(options,"offset"),timeout:readOptionString(options,"timeout"),progress:Boolean(options.progress),envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:Boolean(options.sharedHostSafe),pmContext:readOptionString(options,"pmContext"),overrideLinkedPmContext:Boolean(options.overrideLinkedPmContext),workspaceContext:readOptionString(options,"workspaceContext"),overrideLinkedWorkspaceContext:Boolean(options.overrideLinkedWorkspaceContext),allowUntrustedLinkedTests:Boolean(options.allowUntrustedLinkedTests),failOnContextMismatch:Boolean(options.failOnContextMismatch),failOnSkipped:Boolean(options.failOnSkipped),failOnEmptyTestRun:Boolean(options.failOnEmptyTestRun),requireAssertionsForPm:Boolean(options.requireAssertionsForPm),checkContext:Boolean(options.checkContext),autoPmContext:Boolean(options.autoPmContext)}}async function runTelemetryAction(namespaceOrSubcommand,subcommand,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runTelemetry({subcommand:resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand),limit:readOptionString(options,"limit")},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=telemetry took_ms=${Date.now()-startedAt}`)}}async function runStatsAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const analytics=parseStatsAnalyticsJson(readOptionString(options,"analytics"));const result=await runStats(globalOptions,{includeEmpty:options.includeEmpty===true,storage:options.storage===true,metadataCoverage:options.metadataCoverage===true,byAssignee:options.byAssignee===true,byTag:options.byTag===true,byPriority:options.byPriority===true,tagPrefix:readOptionString(options,"tagPrefix"),fieldUtilization:options.fieldUtilization===true,...analytics});if(result.recorded_observations?.some(entry=>entry.changed)===true){await invalidateSearchCachesForMutation(globalOptions,{ids:result.recorded_observations?.flatMap(entry=>entry.observation.item_id?[entry.observation.item_id]:[])})}printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=stats took_ms=${Date.now()-startedAt}`)}}async function runDuplicatesAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const threshold=readOptionString(options,"threshold");const limit=readOptionString(options,"limit");const result=await runDuplicates(globalOptions,{...options.exhaustive===true?{exhaustive:true}:{},status:Array.isArray(options.status)&&options.status.length>0?options.status:void 0,since:readOptionString(options,"since"),...threshold===void 0?{}:{threshold:Number(threshold)},...limit===void 0?{}:{limit:Number(limit)}});printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=duplicates took_ms=${Date.now()-startedAt}`)}}async function runHealthAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const strictExit=Boolean(options.strictExit)||Boolean(options.failOnWarn);const result=await runHealth(globalOptions,{strictExit,strictDirectories:Boolean(options.strictDirectories),requireMergeDrivers:Boolean(options.requireMergeDrivers),checkOnly:Boolean(options.checkOnly),checkTelemetry:Boolean(options.checkTelemetry),noRefresh:Boolean(options.noRefresh),refreshVectors:Boolean(options.refreshVectors),verboseStaleItems:Boolean(options.verboseStaleItems),verboseAuthorEvents:Boolean(options.verboseAuthorEvents),brief:Boolean(options.brief),summary:Boolean(options.summary)||strictExit,skipVectors:Boolean(options.skipVectors),skipIntegrity:Boolean(options.skipIntegrity),skipDrift:Boolean(options.skipDrift),full:Boolean(options.full)});printResult(result,globalOptions);if(strictExit&&!result.ok){setActiveCommandResult({...result,exit_code:EXIT_CODE.GENERIC_FAILURE,error_code:"health_findings",error_category:"validation",command_resolution:"health_findings",resolution_stage:"execute"});process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=health took_ms=${Date.now()-startedAt}`)}}async function runValidateAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runValidate({checkMetadata:Boolean(options.checkMetadata),metadataProfile:readOptionString(options,"metadataProfile"),checkResolution:Boolean(options.checkResolution),checkCompleteness:Boolean(options.checkCompleteness),checkLifecycle:Boolean(options.checkLifecycle),checkStaleBlockers:Boolean(options.checkStaleBlockers),dependencyCycleSeverity:readOptionString(options,"dependencyCycleSeverity"),parentCycleSeverity:readOptionString(options,"parentCycleSeverity"),checkFiles:Boolean(options.checkFiles),checkCommandReferences:Boolean(options.checkCommandReferences),scanMode:readOptionString(options,"scanMode"),includePmInternals:Boolean(options.includePmInternals),verboseFileLists:Boolean(options.verboseFileLists),verboseDiagnostics:Boolean(options.verboseDiagnostics),allAffectedIds:Boolean(options.allAffectedIds),checkHistoryDrift:Boolean(options.checkHistoryDrift),checkStorageIntegrity:Boolean(options.checkStorageIntegrity),fixHints:Boolean(options.fixHints),autoFix:Boolean(options.autoFix),dryRun:Boolean(options.dryRun),fixScope:Array.isArray(options.fixScope)?options.fixScope:void 0,pruneMissing:Boolean(options.pruneMissing),counts:Boolean(options.counts),full:Boolean(options.full)},globalOptions);printResult(result,globalOptions);const strictExit=Boolean(options.strictExit)||Boolean(options.failOnWarn);if(strictExit&&(result.has_warnings||!result.ok)){setActiveCommandResult({...result,exit_code:EXIT_CODE.GENERIC_FAILURE,error_code:"validation_findings",error_category:"validation",command_resolution:"validation_findings",resolution_stage:"execute"});process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=validate took_ms=${Date.now()-startedAt}`)}}async function runGcAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runGc(globalOptions,{dryRun:options.dryRun===true,scope:Array.isArray(options.scope)?options.scope:[]});printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=gc took_ms=${Date.now()-startedAt}`)}}async function runWorkspaceSnapshotAction(action,target,options,command){const globalOptions=getGlobalOptions(command);const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);const normalizedAction=action.trim().toLowerCase();if(!WORKSPACE_SNAPSHOT_ACTIONS.some(entry=>entry===normalizedAction)){throw createUnknownSubcommandError({command_path:"workspace snapshot",token:action,allowed:WORKSPACE_SNAPSHOT_ACTIONS,display_name:"workspace snapshot",token_kind:"action",examples:["pm workspace snapshot create before-migration","pm workspace snapshot restore before-migration"]})}if(normalizedAction==="list"){printResult(await listWorkspaceSnapshots(pmRoot),globalOptions);return}if(normalizedAction==="create"){printResult(await createWorkspaceSnapshot(pmRoot,target===void 0?{}:{name:target}),globalOptions);return}if(target===void 0){throw new PmCliError(`pm workspace snapshot ${normalizedAction} requires a snapshot name or fingerprint`,EXIT_CODE.USAGE)}if(normalizedAction==="inspect"){printResult(await inspectWorkspaceSnapshot(pmRoot,target),globalOptions);return}if(normalizedAction==="restore"){if(options.dryRun===true){printResult(await planWorkspaceSnapshotRestore(pmRoot,target),globalOptions);return}const settings=await readSettings(pmRoot);printResult(await restoreWorkspaceSnapshotWithRecovery(pmRoot,target,{force:options.force===true,author:resolveAuthor(readOptionString(options,"author"),settings.author_default),message:readOptionString(options,"message"),lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms}),globalOptions);return}printResult(await deleteWorkspaceSnapshot(pmRoot,target),globalOptions)}async function runWorkspacePositionAction(_options,command){const globalOptions=getGlobalOptions(command);printResult(await readWorkspacePosition(globalOptions),globalOptions)}async function runContractsAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runContracts({action:readOptionString(options,"action"),command:readOptionString(options,"command"),summary:Boolean(options.summary),schemaOnly:Boolean(options.schemaOnly),flagsOnly:Boolean(options.flagsOnly),availabilityOnly:Boolean(options.availabilityOnly),runtimeOnly:Boolean(options.runtimeOnly)||Boolean(options.activeOnly),full:Boolean(options.full)},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=contracts took_ms=${Date.now()-startedAt}`)}}async function runClaimAction(id,options,command){if(options.start===true){requireClaimTarget(id,false);await runStartTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const lifecycleOptions={...buildLifecycleMutationOptions(options),ifAvailable:options.ifAvailable===true,maxAttempts:options.maxAttempts};requireClaimTarget(id,options.next===true);const result=options.next===true?await runClaimNext(Boolean(options.force),globalOptions,lifecycleOptions,{type:typeof options.type==="string"?options.type:void 0,tag:typeof options.tag==="string"?options.tag:void 0,priority:options.priority,assigneeFilter:typeof options.assigneeFilter==="string"?options.assigneeFilter:void 0,parent:typeof options.parent==="string"?options.parent:void 0,sprint:typeof options.sprint==="string"?options.sprint:void 0,release:typeof options.release==="string"?options.release:void 0,includeDecisions:options.includeDecisions===true,includeGates:options.includeGates===true,includeContainers:options.includeContainers===true,tokenBudget:options.tokenBudget??options.token_budget,explainRanking:options.explainRanking===true||options.explain_ranking===true}):await runClaim(id,Boolean(options.force),globalOptions,lifecycleOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=claim took_ms=${Date.now()-startedAt}`)}}function requireClaimTarget(id,next){if(!next&&!id)throw new PmCliError("Specify an item id or pass --next",EXIT_CODE.USAGE);if(next&&id)throw new PmCliError("Specify either an item id or --next, not both",EXIT_CODE.USAGE)}async function runReleaseAction(id,options,command){if(options.pause===true){await runPauseTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runRelease(id,Boolean(options.force),globalOptions,{...buildLifecycleMutationOptions(options),ownershipReleaseBypass:options.ownershipReleaseBypass===true});await invalidateSearchCachesForMutation(globalOptions,result);printResult(await applyActiveCommandResultService("release",[id],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=release took_ms=${Date.now()-startedAt}`)}}async function printLifecycleAliasHint(command){const global2=getGlobalOptions(command);const alias=resolvePmCommandAlias(command.name());if(!alias||global2.json||global2.quiet)return;const settings=await readSettings(resolvePmRoot(process.cwd(),global2.path));if(settings.ux?.deprecation_hints)printError(renderPmCommandAliasMigrationHint(alias))}async function runStartTaskAction(id,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runStartTask(id,{...buildLifecycleMutationOptions(options),force:Boolean(options.force),next:options.next===true,ifAvailable:options.ifAvailable===true},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.update);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=start-task took_ms=${Date.now()-startedAt}`)}}async function runPauseTaskAction(id,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runPauseTask(id,{...buildLifecycleMutationOptions(options),force:Boolean(options.force)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=pause-task took_ms=${Date.now()-startedAt}`)}}async function runCloseTaskAction(id,reason,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runCloseTask(id,reason,{...buildLifecycleMutationOptions(options),validateClose:readOptionString(options,"validateClose"),force:Boolean(options.force)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=close-task took_ms=${Date.now()-startedAt}`)}}function addLinkedTestExecutionOptions(command){return command.option("--background","Run linked tests in managed background mode").option("--timeout <seconds>","Default run timeout in seconds").option("--progress","Emit linked-test progress to stderr (always shown in TTY, opt-in for non-TTY)").option("--env-set <value>","Set environment variable(s) for linked-test runs (KEY=VALUE, repeatable)",collect).option("--env-clear <value>","Clear environment variable(s) for linked-test runs (NAME, repeatable)",collect).option("--shared-host-safe","Apply additive shared-host-safe runtime defaults for linked-test runs").option("--pm-context <mode>","PM linked-test context mode: schema|tracker|auto (default: schema)").option("--override-linked-pm-context","Force run-level --pm-context to override per-linked-test pm_context_mode metadata").option("--workspace-context <mode>","Source-workspace mode: source|isolated|snapshot (default: source)").option("--override-linked-workspace-context","Force run-level --workspace-context over per-linked-test metadata").option("--allow-untrusted-linked-tests","Execute untrusted linked commands when project policy also permits it").option("--fail-on-context-mismatch","Fail linked PM commands when context item counts differ").option("--fail-on-skipped","Treat skipped linked tests as dependency failures").option("--fail-on-empty-test-run","Treat successful linked-test commands that report zero executed tests as failures").option("--require-assertions-for-pm","Require assertion metadata for linked PM command tests").option("--check-context","Preflight linked PM command context diagnostics before executing commands").option("--auto-pm-context","Auto-remediate PM tracker-read context mismatches by routing those linked commands through tracker context")}function registerOperationCommands(program){registerAssuranceCommand(program);const testCommand=program.command("test").argument("<id>","Item id").option("--add <value>","Add verified isolated test (CSV/markdown or stdin)",collect).option("--add-json <value>","Add verified isolated test (JSON object/array or stdin)",collect).option("--remove <value>","Remove linked test entry by exact command/path (command=<value> and path=<value> preserve commas and equals signs; or - for stdin)",collect).option("--remove-index <n>","Remove the 1-based linked-test index from --list order (repeatable)",collect).option("--list","List linked tests without mutating").option("--run","Run linked test commands").option("--match <value>","Run only linked tests whose command/path contains this substring").option("--only-index <n>","Run only the 1-based linked-test index from --list order").option("--only-last","Run only the most recently added linked test");testCommand.option("--acknowledge-linked-tests","Trust the item's current linked commands in this clone without executing them");addLinkedTestExecutionOptions(testCommand).option("--measure <value>","Record name=value[,unit=...][,threshold=...] evidence; repeatable",collect).option("--metric-below <value>","Return evidence below name=value").option("--metric-diff <name>","Diff the latest two values").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").description("Manage tests linked to an item and optionally run them.").action(runTestCommandAction);const testAllCommand=program.command("test-all").description("Run linked tests across matching items.").option("--status <value>","Filter items by status before running tests").option("--limit <n>","Limit matching items before running linked tests").option("--offset <n>","Skip matching items before running linked tests");addLinkedTestExecutionOptions(testAllCommand).action(runTestAllAction);program.command("test-runs-worker",{hidden:true}).argument("<runId>","Background run id").description("Internal background worker command.").action(async(runId,_options,command)=>{const globalOptions=getGlobalOptions(command);await runTestRunsWorker(runId,globalOptions)});program.command("telemetry").argument("[namespace-or-subcommand]","Telemetry subcommand: status, flush, stats, clear (default: status)").argument("[subcommand]","Compatibility alias target for local-analytics: status, flush, stats, clear").option("--limit <n>","Maximum command groups returned by telemetry stats").description("Inspect and manage local telemetry queue/runtime state.").action(runTelemetryAction);program.command("duplicates").description("Find duplicate clusters across all statuses.").option("--status <value>","Statuses (repeatable or comma-separated)",collect,[]).option("--since <value>","Created at or after this time").option("--threshold <value>","Minimum similarity (0-1)").option("--limit <n>","Maximum clusters").option("--exhaustive","Score all pairs within the safety bound").action(runDuplicatesAction);program.command("stats").description("Show project tracker statistics.").option("--include-empty","Restore zero-count registered item-type and lifecycle-status buckets").option("--storage","Include aggregate history-stream storage metrics (total streams/lines/bytes, largest + deepest streams, oldest/newest entries)").option("--metadata-coverage","Include metadata coverage % (acceptance_criteria, estimated_minutes, resolution, tags, parent) overall and by type").option("--by-assignee","Include a lifecycle-bucketed item breakdown grouped by assignee").option("--by-tag","Include a lifecycle-bucketed item breakdown grouped by tag").option("--by-priority","Include a lifecycle-bucketed item breakdown grouped by priority").option("--tag-prefix <value>","With --by-tag: only count tags starting with this prefix (e.g. domain:)").option("--field-utilization","Report content-field utilization rates (notes/learnings/files/docs/tests/comments/deps/body) for governance analysis").option("--analytics <json>","Improvement ledger/history analytics JSON").action(runStatsAction);program.command("health").description("Show project tracker health checks.").option("--strict-directories","Treat optional item-type directories as required failures").option("--require-merge-drivers","Treat absent clone-local merge drivers as a required health failure").option("--check-only","Run read-only health diagnostics without refreshing vectors").option("--check-telemetry","Probe telemetry endpoint health and include network diagnostics").option("--no-refresh","Disable automatic vector refresh attempts during health checks").option("--refresh-vectors","Explicitly enable vector refresh attempts during health checks").option("--verbose-stale-items","Include full stale vectorization ID lists in health output").option("--verbose-author-events","Include every actionable unknown-author event coordinate for review or disposition").option("--brief","Emit compact health details for low-token agent checks").option("--summary","Emit one-line-style health status with check names and warning count").option("--skip-vectors","Skip vectorization check for a faster run").option("--skip-integrity","Skip item/history file integrity check for a faster run").option("--skip-drift","Skip history drift hash check for a faster run").option("--full","Run all checks including slow integrity, drift, and vectorization checks").option("--strict-exit","Return non-zero exit when health is not ok and default to actionable summary output; use --full for complete details").option("--fail-on-warn","Alias for --strict-exit").action(runHealthAction);program.command("validate").description("Validate metadata, lifecycle policies, files, command references, and history.").option("--check-metadata","Run metadata completeness checks").option("--metadata-profile <value>","Metadata profile (core|strict|custom)").option("--check-resolution","Run closed-item resolution metadata checks").option("--check-completeness","Check declarative lifecycle field requirements").option("--check-lifecycle","Run active-item lifecycle governance drift checks").option("--check-stale-blockers","Include stale blocker-pattern diagnostics in lifecycle checks").option("--dependency-cycle-severity <value>","Set dependency-cycle warning policy for lifecycle checks (off|warn|error)").option("--parent-cycle-severity <value>","Set parent-hierarchy cycle warning policy for lifecycle checks (off|warn|error)").option("--check-files","Run linked-file and orphaned-file checks").option("--check-command-references","Run linked-command PM-ID reference checks").option("--scan-mode <value>","Select file candidate scan mode for --check-files (default|tracked-all|tracked-all-strict)").option("--include-pm-internals","Include PM storage internals in tracked-all candidate scans").option("--verbose-file-lists","Include full file-path lists for validate --check-files details").option("--verbose-diagnostics","Include full diagnostic ID lists").option("--all-affected-ids","Emit complete missing_* affected-ID lists with no truncation (implied by --json)").option("--strict-exit","Return non-zero exit when validation warnings are present").option("--fail-on-warn","Alias for --strict-exit").option("--fix-hints","Add a machine-executable fix_hints[] of pm commands to each failing check's details").option("--auto-fix","Apply safe, deterministic field backfills").option("--dry-run","Preview planned --auto-fix/--prune-missing fixes without applying them").option("--fix-scope <scope>","Grant --auto-fix scopes (metadata, resolution, estimates, timestamps, lifecycle; comma-separated or repeatable). Default: metadata, resolution; other scopes require explicit opt-in",collect).option("--prune-missing","Remove deleted-path file/doc links; preserves real files").option("--check-history-drift","Run item/history hash drift checks").option("--check-storage-integrity","Run the post-merge storage-integrity check (unreadable items, history conflict markers, resurrected deletes, unparseable config/schema)").option("--counts","Keep validation counts and totals while omitting per-item diagnostic arrays").option("--full","Return the complete validation diagnostic projection").action(runValidateAction);program.command("gc").option("--dry-run","Preview cleanup targets without deleting files; without this flag, pm gc deletes matched artifacts").option("--scope <value>","Limit cleanup to one or more scopes (comma-separated or repeatable): index, embeddings, runtime, locks, checkpoints, transactions",collect).description("Delete optional cache artifacts by default (including expired lock debris) and show a summary.").action(runGcAction);const workspaceCommand=program.command("workspace").description("Inspect workspace state and snapshots.");workspaceCommand.command("position").description("Show merge and history readiness.").action(runWorkspacePositionAction);workspaceCommand.command("snapshot").argument("<action>","Action: create, list, inspect, restore, delete").argument("[target]","Optional name for create; name or fingerprint otherwise").description("Manage content-addressed tracker snapshots.").option("--dry-run","Preview restore file, item, stream, and history-entry impact without mutating state").option("--force","Explicitly confirm a whole-workspace snapshot restore").option("--author <value>","Actor recorded on the restore audit event").option("--message <value>","Human-readable restore rationale").action(runWorkspaceSnapshotAction);program.command("contracts").description("Show machine-readable command and schema contracts for agents.").option("--action <value>","Filter tool schema branches to a specific action").option("--command <value>","Scope contracts output to one CLI command (narrow-by-default)").option("--summary","Return one command+intent row per top-level command for cheap agent bootstrap").option("--schema-only","Return schema-focused output only").option("--flags-only","Return command flag contracts only").option("--availability-only","Return action availability surface only").option("--runtime-only","Include only actions invocable in the current runtime").option("--active-only","Alias for --runtime-only").option("--full","Include full schema and command-flag surfaces (large; default brief output omits heavy sections for unfiltered queries)").action(runContractsAction);const claimCommand=program.command("claim").option("--start","Claim and start an explicit item").argument("[id]","Item id (omit with --next)").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force claim override").option("--if-available","Skip another author's claim (skipped=true)").option("--next","Atomically claim the next caller-available actionable item").option("--type <value>","Filter --next candidates by type").option("--tag <value>","Filter --next candidates by tag").option("--priority <value>","Filter --next candidates by priority").option("--assignee-filter <value>","Filter --next candidates: assigned|unassigned").option("--parent <id>","Scope --next candidates to a subtree").option("--sprint <value>","Filter --next candidates by sprint").option("--release <value>","Filter --next candidates by release").option("--max-attempts <n>","Bound the --next candidate walk (default 10; maximum 100)").option("--include-decisions","Allow --next to claim human-gated Decision items").option("--include-gates","Allow --next to claim outcome gates").option("--include-containers","Allow --next to claim containers with unfinished descendants").option("--token-budget <n>","Bound the estimated tokens used to rank --next candidates").option("--explain-ranking","Include ranking provenance for --next selection").description("Claim an item for active work.").action(runClaimAction);addHiddenOption(claimCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");addHiddenOption(claimCommand,"--token_budget <n>","Alias for --token-budget");addHiddenOption(claimCommand,"--explain_ranking","Alias for --explain-ranking");const releaseCommand=program.command("release").option("--pause","Use open status").argument("<id>","Item id").option("--author <value>","Author").option("--message <value>","Message").option("--force","Override ownership").description("Release ownership.").action(runReleaseAction);addHiddenOption(releaseCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const startTaskCommand=program.command("start-task",{hidden:true}).argument("<id>","Item id").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership or terminal override when required").description("Lifecycle alias: claim an item and move it to in_progress.").action(runStartTaskAction);addHiddenOption(startTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const pauseTaskCommand=program.command("pause-task",{hidden:true}).argument("<id>","Item id").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override when required").description("Lifecycle alias: move an item to open and release its claim.").action(runPauseTaskAction);addHiddenOption(pauseTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const closeTaskCommand=program.command("close-task",{hidden:true}).argument("<id>","Item id").argument("[reason]","Close reason text").option("--author <value>","Mutation author").option("--message <value>","History message").option("--validate-close <value>","Close-time validation mode: off|warn|strict").option("--force","Force ownership or terminal override when required").description("Lifecycle alias: close an item and release assignment metadata.").action(runCloseTaskAction);addHiddenOption(closeTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands")}export{_testOnlyRegisterOperations,registerOperationCommands,requireClaimTarget};
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2d28905b-e311-589e-88b7-051c2626aeae")}catch(e2){}})();import{resolvePmCommandAlias,renderPmCommandAliasMigrationHint}from"../sdk/cli-contracts/command-aliases.js";import{setActiveCommandResult,EXIT_CODE,PmCliError,createUnknownSubcommandError,resolveAuthor,resolvePmRoot,readSettings}from"../sdk/runtime-primitives.js";import{runStartTask,runPauseTask,runCloseTask}from"../sdk/lifecycle/task-composition.js";import{parseStatsAnalyticsJson}from"./stats-analytics-json.js";import{createWorkspaceSnapshot,deleteWorkspaceSnapshot,inspectWorkspaceSnapshot,listWorkspaceSnapshots,planWorkspaceSnapshotRestore,restoreWorkspaceSnapshotWithRecovery,WORKSPACE_SNAPSHOT_ACTIONS}from"../sdk/workspace-snapshot.js";import{readWorkspacePosition}from"../sdk/governance/workspace-position.js";import{runClaim,runClaimNext,runRelease}from"./commands/lifecycle/claim.js";import{runContracts}from"./commands/workspace/contracts.js";import{runDuplicates}from"./commands/query/duplicates.js";import{runGc}from"./commands/governance/gc.js";import{runHealth}from"./commands/governance/health.js";import{runStats}from"./commands/query/stats.js";import{runTelemetry}from"./commands/governance/telemetry.js";import{runTest}from"./commands/test/test.js";import{runTestAll}from"./commands/test/test-all.js";import{runStartBackgroundRun,runTestRunsWorker}from"./commands/test/test-runs.js";import{runValidate}from"./commands/governance/validate.js";import{buildBackgroundTestAllCommandArgs,applyActiveCommandResultService,buildBackgroundTestCommandArgs,addHiddenOption,collect,getGlobalOptions,invalidateSearchCachesForMutation,printError,printResult,readOptionString}from"./registration-helpers.js";import{registerAssuranceCommand}from"./register-assurance.js";function resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand){const normalizedNamespace=namespaceOrSubcommand?.trim().toLowerCase();const normalizedSubcommand=subcommand?.trim().toLowerCase();if(normalizedNamespace===void 0||normalizedNamespace.length===0){return normalizedSubcommand}if(normalizedNamespace==="local-analytics"){return normalizedSubcommand&&normalizedSubcommand.length>0?normalizedSubcommand:"status"}if(normalizedSubcommand!==void 0&&normalizedSubcommand.length>0){throw createUnknownSubcommandError({command_path:"telemetry",token:`${namespaceOrSubcommand} ${subcommand}`,allowed:["status","flush","stats","clear","local-analytics"],token_kind:"path",examples:["pm telemetry stats --limit 10","pm telemetry local-analytics status --json"]})}return normalizedNamespace}function collectTestMutationValues(options){return{addValues:Array.isArray(options.add)?options.add:[],addJsonValues:Array.isArray(options.addJson)?options.addJson:[],removeValues:Array.isArray(options.remove)?options.remove:[],removeIndexValues:Array.isArray(options.removeIndex)?options.removeIndex:[]}}function validateBackgroundTestOptions(options,values){if(options.background!==true){return}if(options.run!==true){throw new PmCliError("--background requires --run",EXIT_CODE.USAGE)}if(options.acknowledgeLinkedTests===true){throw new PmCliError("--background cannot be combined with --acknowledge-linked-tests; acknowledgement is a non-executing foreground operation",EXIT_CODE.USAGE)}if(values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||values.removeIndexValues.length>0){throw new PmCliError("--background does not support --add/--add-json/--remove/--remove-index; update linked tests first, then run in background",EXIT_CODE.USAGE)}}async function runBackgroundLinkedTests(id,options,globalOptions,values){const result=await runStartBackgroundRun({kind:"test",commandArgs:buildBackgroundTestCommandArgs(id,{...options,add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues}),targetId:id,author:typeof options.author==="string"?options.author:void 0,noExtensions:globalOptions.noExtensions===true},globalOptions);printResult(result,globalOptions)}function buildRunTestOptions(options,values){return{add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues,list:Boolean(options.list),run:Boolean(options.run),match:typeof options.match==="string"?options.match:void 0,onlyIndex:typeof options.onlyIndex==="string"||typeof options.onlyIndex==="number"?options.onlyIndex:void 0,onlyLast:Boolean(options.onlyLast),timeout:typeof options.timeout==="string"?options.timeout:void 0,progress:Boolean(options.progress),envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:Boolean(options.sharedHostSafe),pmContext:typeof options.pmContext==="string"?options.pmContext:void 0,overrideLinkedPmContext:Boolean(options.overrideLinkedPmContext),workspaceContext:typeof options.workspaceContext==="string"?options.workspaceContext:void 0,overrideLinkedWorkspaceContext:Boolean(options.overrideLinkedWorkspaceContext),allowUntrustedLinkedTests:Boolean(options.allowUntrustedLinkedTests),acknowledgeLinkedTests:Boolean(options.acknowledgeLinkedTests),failOnContextMismatch:Boolean(options.failOnContextMismatch),failOnSkipped:Boolean(options.failOnSkipped),failOnEmptyTestRun:Boolean(options.failOnEmptyTestRun),requireAssertionsForPm:Boolean(options.requireAssertionsForPm),checkContext:Boolean(options.checkContext),autoPmContext:Boolean(options.autoPmContext),author:typeof options.author==="string"?options.author:void 0,message:typeof options.message==="string"?options.message:void 0,force:Boolean(options.force),measure:Array.isArray(options.measure)?options.measure:[],metricBelow:typeof options.metricBelow==="string"?options.metricBelow:void 0,metricDiff:typeof options.metricDiff==="string"?options.metricDiff:void 0}}const _testOnlyRegisterOperations={buildRunTestOptions,buildRunTestAllOptions,runWorkspacePositionAction,validateBackgroundTestOptions};async function runForegroundLinkedTests(id,options,globalOptions,values){const result=await runTest(id,buildRunTestOptions(options,values),globalOptions);if(values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||options.run===true||values.removeIndexValues.length>0){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(result,globalOptions);if(result.run_results.some(entry=>entry.status==="failed")||result.fail_on_skipped_triggered===true){process.exitCode=EXIT_CODE.DEPENDENCY_FAILED}}async function runTestCommandAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const values=collectTestMutationValues(options);validateBackgroundTestOptions(options,values);if(options.background===true){await runBackgroundLinkedTests(id,options,globalOptions,values)}else{await runForegroundLinkedTests(id,options,globalOptions,values)}if(globalOptions.profile){printError(`profile:command=test took_ms=${Date.now()-startedAt}`)}}function buildLifecycleMutationOptions(options){const author=readOptionString(options,"author");const assignee=readOptionString(options,"assignee");if(author!==void 0&&assignee!==void 0&&author!==assignee){throw new PmCliError("Lifecycle ownership received conflicting --author and --assignee values; use one actor value for both aliases.",EXIT_CODE.USAGE,{code:"conflicting_lifecycle_owner",examples:["pm claim pm-123","pm claim pm-123 --start","pm release pm-123"]})}return{author:author??assignee,message:readOptionString(options,"message")}}async function runTestAllAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const runInBackground=options.background===true;if(runInBackground){const result2=await runStartBackgroundRun({kind:"test-all",commandArgs:buildBackgroundTestAllCommandArgs(options),statusFilter:readOptionString(options,"status"),noExtensions:globalOptions.noExtensions===true},globalOptions);printResult(result2,globalOptions);if(globalOptions.profile){printError(`profile:command=test-all took_ms=${Date.now()-startedAt}`)}return}const result=await runTestAll(buildRunTestAllOptions(options),globalOptions);await invalidateSearchCachesForMutation(globalOptions,{ids:result.results.map(entry=>entry.id)});printResult(result,globalOptions);if(result.failed>0||result.fail_on_skipped_triggered===true){process.exitCode=EXIT_CODE.DEPENDENCY_FAILED}if(globalOptions.profile){printError(`profile:command=test-all took_ms=${Date.now()-startedAt}`)}}function buildRunTestAllOptions(options){return{status:readOptionString(options,"status"),limit:readOptionString(options,"limit"),offset:readOptionString(options,"offset"),timeout:readOptionString(options,"timeout"),progress:Boolean(options.progress),envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:Boolean(options.sharedHostSafe),pmContext:readOptionString(options,"pmContext"),overrideLinkedPmContext:Boolean(options.overrideLinkedPmContext),workspaceContext:readOptionString(options,"workspaceContext"),overrideLinkedWorkspaceContext:Boolean(options.overrideLinkedWorkspaceContext),allowUntrustedLinkedTests:Boolean(options.allowUntrustedLinkedTests),failOnContextMismatch:Boolean(options.failOnContextMismatch),failOnSkipped:Boolean(options.failOnSkipped),failOnEmptyTestRun:Boolean(options.failOnEmptyTestRun),requireAssertionsForPm:Boolean(options.requireAssertionsForPm),checkContext:Boolean(options.checkContext),autoPmContext:Boolean(options.autoPmContext)}}async function runTelemetryAction(namespaceOrSubcommand,subcommand,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runTelemetry({subcommand:resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand),limit:readOptionString(options,"limit")},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=telemetry took_ms=${Date.now()-startedAt}`)}}async function runStatsAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const analytics=parseStatsAnalyticsJson(readOptionString(options,"analytics"));const result=await runStats(globalOptions,{includeEmpty:options.includeEmpty===true,storage:options.storage===true,metadataCoverage:options.metadataCoverage===true,byAssignee:options.byAssignee===true,byTag:options.byTag===true,byPriority:options.byPriority===true,tagPrefix:readOptionString(options,"tagPrefix"),fieldUtilization:options.fieldUtilization===true,...analytics});if(result.recorded_observations?.some(entry=>entry.changed)===true){await invalidateSearchCachesForMutation(globalOptions,{ids:result.recorded_observations?.flatMap(entry=>entry.observation.item_id?[entry.observation.item_id]:[])})}printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=stats took_ms=${Date.now()-startedAt}`)}}async function runDuplicatesAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const threshold=readOptionString(options,"threshold");const limit=readOptionString(options,"limit");const result=await runDuplicates(globalOptions,{...options.exhaustive===true?{exhaustive:true}:{},status:Array.isArray(options.status)&&options.status.length>0?options.status:void 0,since:readOptionString(options,"since"),...threshold===void 0?{}:{threshold:Number(threshold)},...limit===void 0?{}:{limit:Number(limit)}});printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=duplicates took_ms=${Date.now()-startedAt}`)}}async function runHealthAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const strictExit=Boolean(options.strictExit)||Boolean(options.failOnWarn);const result=await runHealth(globalOptions,{strictExit,strictDirectories:Boolean(options.strictDirectories),requireMergeDrivers:Boolean(options.requireMergeDrivers),checkOnly:Boolean(options.checkOnly),checkTelemetry:Boolean(options.checkTelemetry),noRefresh:Boolean(options.noRefresh),refreshVectors:Boolean(options.refreshVectors),verboseStaleItems:Boolean(options.verboseStaleItems),verboseAuthorEvents:Boolean(options.verboseAuthorEvents),brief:Boolean(options.brief),summary:Boolean(options.summary)||strictExit,skipVectors:Boolean(options.skipVectors),skipIntegrity:Boolean(options.skipIntegrity),skipDrift:Boolean(options.skipDrift),full:Boolean(options.full)});printResult(result,globalOptions);if(strictExit&&!result.ok){setActiveCommandResult({...result,exit_code:EXIT_CODE.GENERIC_FAILURE,error_code:"health_findings",error_category:"validation",command_resolution:"health_findings",resolution_stage:"execute"});process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=health took_ms=${Date.now()-startedAt}`)}}async function runValidateAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runValidate({checkMetadata:Boolean(options.checkMetadata),metadataProfile:readOptionString(options,"metadataProfile"),checkResolution:Boolean(options.checkResolution),checkCompleteness:Boolean(options.checkCompleteness),checkLifecycle:Boolean(options.checkLifecycle),checkStaleBlockers:Boolean(options.checkStaleBlockers),dependencyCycleSeverity:readOptionString(options,"dependencyCycleSeverity"),parentCycleSeverity:readOptionString(options,"parentCycleSeverity"),checkFiles:Boolean(options.checkFiles),checkCommandReferences:Boolean(options.checkCommandReferences),scanMode:readOptionString(options,"scanMode"),includePmInternals:Boolean(options.includePmInternals),verboseFileLists:Boolean(options.verboseFileLists),verboseDiagnostics:Boolean(options.verboseDiagnostics),allAffectedIds:Boolean(options.allAffectedIds),checkHistoryDrift:Boolean(options.checkHistoryDrift),checkStorageIntegrity:Boolean(options.checkStorageIntegrity),fixHints:Boolean(options.fixHints),autoFix:Boolean(options.autoFix),dryRun:Boolean(options.dryRun),fixScope:Array.isArray(options.fixScope)?options.fixScope:void 0,pruneMissing:Boolean(options.pruneMissing),counts:Boolean(options.counts),full:Boolean(options.full)},globalOptions);printResult(result,globalOptions);const strictExit=Boolean(options.strictExit)||Boolean(options.failOnWarn);if(strictExit&&(result.has_warnings||!result.ok)){setActiveCommandResult({...result,exit_code:EXIT_CODE.GENERIC_FAILURE,error_code:"validation_findings",error_category:"validation",command_resolution:"validation_findings",resolution_stage:"execute"});process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=validate took_ms=${Date.now()-startedAt}`)}}async function runGcAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runGc(globalOptions,{dryRun:options.dryRun===true,scope:Array.isArray(options.scope)?options.scope:[]});printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=gc took_ms=${Date.now()-startedAt}`)}}async function runWorkspaceSnapshotAction(action,target,options,command){const globalOptions=getGlobalOptions(command);const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);const normalizedAction=action.trim().toLowerCase();if(!WORKSPACE_SNAPSHOT_ACTIONS.some(entry=>entry===normalizedAction)){throw createUnknownSubcommandError({command_path:"workspace snapshot",token:action,allowed:WORKSPACE_SNAPSHOT_ACTIONS,display_name:"workspace snapshot",token_kind:"action",examples:["pm workspace snapshot create before-migration","pm workspace snapshot restore before-migration"]})}if(normalizedAction==="list"){printResult(await listWorkspaceSnapshots(pmRoot),globalOptions);return}if(normalizedAction==="create"){printResult(await createWorkspaceSnapshot(pmRoot,target===void 0?{}:{name:target}),globalOptions);return}if(target===void 0){throw new PmCliError(`pm workspace snapshot ${normalizedAction} requires a snapshot name or fingerprint`,EXIT_CODE.USAGE)}if(normalizedAction==="inspect"){printResult(await inspectWorkspaceSnapshot(pmRoot,target),globalOptions);return}if(normalizedAction==="restore"){if(options.dryRun===true){printResult(await planWorkspaceSnapshotRestore(pmRoot,target),globalOptions);return}const settings=await readSettings(pmRoot);printResult(await restoreWorkspaceSnapshotWithRecovery(pmRoot,target,{force:options.force===true,author:resolveAuthor(readOptionString(options,"author"),settings.author_default),message:readOptionString(options,"message"),lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms}),globalOptions);return}printResult(await deleteWorkspaceSnapshot(pmRoot,target),globalOptions)}async function runWorkspacePositionAction(_options,command){const globalOptions=getGlobalOptions(command);printResult(await readWorkspacePosition(globalOptions),globalOptions)}async function runContractsAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runContracts({action:readOptionString(options,"action"),command:readOptionString(options,"command"),summary:Boolean(options.summary),schemaOnly:Boolean(options.schemaOnly),flagsOnly:Boolean(options.flagsOnly),availabilityOnly:Boolean(options.availabilityOnly),runtimeOnly:Boolean(options.runtimeOnly)||Boolean(options.activeOnly),full:Boolean(options.full)},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=contracts took_ms=${Date.now()-startedAt}`)}}async function runClaimAction(id,options,command){if(options.start===true){requireClaimTarget(id,false);await runStartTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const lifecycleOptions={...buildLifecycleMutationOptions(options),ifAvailable:options.ifAvailable===true,maxAttempts:options.maxAttempts};requireClaimTarget(id,options.next===true);const result=options.next===true?await runClaimNext(Boolean(options.force),globalOptions,lifecycleOptions,{type:typeof options.type==="string"?options.type:void 0,tag:typeof options.tag==="string"?options.tag:void 0,priority:options.priority,assigneeFilter:typeof options.assigneeFilter==="string"?options.assigneeFilter:void 0,parent:typeof options.parent==="string"?options.parent:void 0,sprint:typeof options.sprint==="string"?options.sprint:void 0,release:typeof options.release==="string"?options.release:void 0,includeDecisions:options.includeDecisions===true,includeGates:options.includeGates===true,includeContainers:options.includeContainers===true,tokenBudget:options.tokenBudget??options.token_budget,explainRanking:options.explainRanking===true||options.explain_ranking===true}):await runClaim(id,Boolean(options.force),globalOptions,lifecycleOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=claim took_ms=${Date.now()-startedAt}`)}}function requireClaimTarget(id,next){if(!next&&!id)throw new PmCliError("Specify an item id or pass --next",EXIT_CODE.USAGE);if(next&&id)throw new PmCliError("Specify either an item id or --next, not both",EXIT_CODE.USAGE)}async function runReleaseAction(id,options,command){if(options.pause===true){await runPauseTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runRelease(id,Boolean(options.force),globalOptions,{...buildLifecycleMutationOptions(options),ownershipReleaseBypass:options.ownershipReleaseBypass===true});await invalidateSearchCachesForMutation(globalOptions,result);printResult(await applyActiveCommandResultService("release",[id],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=release took_ms=${Date.now()-startedAt}`)}}async function printLifecycleAliasHint(command){const global2=getGlobalOptions(command);const alias=resolvePmCommandAlias(command.name());if(!alias||global2.json||global2.quiet)return;const settings=await readSettings(resolvePmRoot(process.cwd(),global2.path));if(settings.ux?.deprecation_hints)printError(renderPmCommandAliasMigrationHint(alias))}async function runStartTaskAction(id,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runStartTask(id,{...buildLifecycleMutationOptions(options),force:Boolean(options.force),next:options.next===true,ifAvailable:options.ifAvailable===true},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.update);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=start-task took_ms=${Date.now()-startedAt}`)}}async function runPauseTaskAction(id,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runPauseTask(id,{...buildLifecycleMutationOptions(options),force:Boolean(options.force)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=pause-task took_ms=${Date.now()-startedAt}`)}}async function runCloseTaskAction(id,reason,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runCloseTask(id,reason,{...buildLifecycleMutationOptions(options),validateClose:readOptionString(options,"validateClose"),force:Boolean(options.force)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=close-task took_ms=${Date.now()-startedAt}`)}}function addLinkedTestExecutionOptions(command){return command.option("--background","Run linked tests in managed background mode").option("--timeout <seconds>","Default run timeout in seconds").option("--progress","Emit linked-test progress to stderr (always shown in TTY, opt-in for non-TTY)").option("--env-set <value>","Set environment variable(s) for linked-test runs (KEY=VALUE, repeatable)",collect).option("--env-clear <value>","Clear environment variable(s) for linked-test runs (NAME, repeatable)",collect).option("--shared-host-safe","Apply additive shared-host-safe runtime defaults for linked-test runs").option("--pm-context <mode>","PM test context: schema|tracker|auto|none (default: schema)").option("--override-linked-pm-context","Force run-level --pm-context to override per-linked-test pm_context_mode metadata").option("--workspace-context <mode>","Source-workspace mode: source|isolated|snapshot (default: source)").option("--override-linked-workspace-context","Force run-level --workspace-context over per-linked-test metadata").option("--allow-untrusted-linked-tests","Execute untrusted linked commands when project policy also permits it").option("--fail-on-context-mismatch","Fail linked PM commands when context item counts differ").option("--fail-on-skipped","Treat skipped linked tests as dependency failures").option("--fail-on-empty-test-run","Treat successful linked-test commands that report zero executed tests as failures").option("--require-assertions-for-pm","Require assertion metadata for linked PM command tests").option("--check-context","Preflight linked PM command context diagnostics before executing commands").option("--auto-pm-context","Auto-remediate PM tracker-read context mismatches by routing those linked commands through tracker context")}function registerOperationCommands(program){registerAssuranceCommand(program);const testCommand=program.command("test").argument("<id>","Item id").option("--add <value>","Add verified isolated test (CSV/markdown or stdin)",collect).option("--add-json <value>","Add verified isolated test (JSON object/array or stdin)",collect).option("--remove <value>","Remove linked test entry by exact command/path (command=<value> and path=<value> preserve commas and equals signs; or - for stdin)",collect).option("--remove-index <n>","Remove the 1-based linked-test index from --list order (repeatable)",collect).option("--list","List linked tests without mutating").option("--run","Run linked test commands").option("--match <value>","Run only linked tests whose command/path contains this substring").option("--only-index <n>","Run only the 1-based linked-test index from --list order").option("--only-last","Run only the most recently added linked test");testCommand.option("--acknowledge-linked-tests","Trust the item's current linked commands in this clone without executing them");addLinkedTestExecutionOptions(testCommand).option("--measure <value>","Record name=value[,unit=...][,threshold=...] evidence; repeatable",collect).option("--metric-below <value>","Return evidence below name=value").option("--metric-diff <name>","Diff the latest two values").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").description("Manage tests linked to an item and optionally run them.").action(runTestCommandAction);const testAllCommand=program.command("test-all").description("Run linked tests across matching items.").option("--status <value>","Filter items by status before running tests").option("--limit <n>","Limit matching items before running linked tests").option("--offset <n>","Skip matching items before running linked tests");addLinkedTestExecutionOptions(testAllCommand).action(runTestAllAction);program.command("test-runs-worker",{hidden:true}).argument("<runId>","Background run id").description("Internal background worker command.").action(async(runId,_options,command)=>{const globalOptions=getGlobalOptions(command);await runTestRunsWorker(runId,globalOptions)});program.command("telemetry").argument("[namespace-or-subcommand]","Telemetry subcommand: status, flush, stats, clear (default: status)").argument("[subcommand]","Compatibility alias target for local-analytics: status, flush, stats, clear").option("--limit <n>","Maximum command groups returned by telemetry stats").description("Inspect and manage local telemetry queue/runtime state.").action(runTelemetryAction);program.command("duplicates").description("Find duplicate clusters across all statuses.").option("--status <value>","Statuses (repeatable or comma-separated)",collect,[]).option("--since <value>","Created at or after this time").option("--threshold <value>","Minimum similarity (0-1)").option("--limit <n>","Maximum clusters").option("--exhaustive","Score all pairs within the safety bound").action(runDuplicatesAction);program.command("stats").description("Show project tracker statistics.").option("--include-empty","Restore zero-count registered item-type and lifecycle-status buckets").option("--storage","Include aggregate history-stream storage metrics (total streams/lines/bytes, largest + deepest streams, oldest/newest entries)").option("--metadata-coverage","Include metadata coverage % (acceptance_criteria, estimated_minutes, resolution, tags, parent) overall and by type").option("--by-assignee","Include a lifecycle-bucketed item breakdown grouped by assignee").option("--by-tag","Include a lifecycle-bucketed item breakdown grouped by tag").option("--by-priority","Include a lifecycle-bucketed item breakdown grouped by priority").option("--tag-prefix <value>","With --by-tag: only count tags starting with this prefix (e.g. domain:)").option("--field-utilization","Report content-field utilization rates (notes/learnings/files/docs/tests/comments/deps/body) for governance analysis").option("--analytics <json>","Improvement ledger/history analytics JSON").action(runStatsAction);program.command("health").description("Show project tracker health checks.").option("--strict-directories","Treat optional item-type directories as required failures").option("--require-merge-drivers","Treat absent clone-local merge drivers as a required health failure").option("--check-only","Run read-only health diagnostics without refreshing vectors").option("--check-telemetry","Probe telemetry endpoint health and include network diagnostics").option("--no-refresh","Disable automatic vector refresh attempts during health checks").option("--refresh-vectors","Explicitly enable vector refresh attempts during health checks").option("--verbose-stale-items","Include full stale vectorization ID lists in health output").option("--verbose-author-events","Include every actionable unknown-author event coordinate for review or disposition").option("--brief","Emit compact health details for low-token agent checks").option("--summary","Emit one-line-style health status with check names and warning count").option("--skip-vectors","Skip vectorization check for a faster run").option("--skip-integrity","Skip item/history file integrity check for a faster run").option("--skip-drift","Skip history drift hash check for a faster run").option("--full","Run all checks including slow integrity, drift, and vectorization checks").option("--strict-exit","Return non-zero exit when health is not ok and default to actionable summary output; use --full for complete details").option("--fail-on-warn","Alias for --strict-exit").action(runHealthAction);program.command("validate").description("Validate metadata, lifecycle policies, files, command references, and history.").option("--check-metadata","Run metadata completeness checks").option("--metadata-profile <value>","Metadata profile (core|strict|custom)").option("--check-resolution","Run closed-item resolution metadata checks").option("--check-completeness","Check declarative lifecycle field requirements").option("--check-lifecycle","Run active-item lifecycle governance drift checks").option("--check-stale-blockers","Include stale blocker-pattern diagnostics in lifecycle checks").option("--dependency-cycle-severity <value>","Set dependency-cycle warning policy for lifecycle checks (off|warn|error)").option("--parent-cycle-severity <value>","Set parent-hierarchy cycle warning policy for lifecycle checks (off|warn|error)").option("--check-files","Run linked-file and orphaned-file checks").option("--check-command-references","Run linked-command PM-ID reference checks").option("--scan-mode <value>","Select file candidate scan mode for --check-files (default|tracked-all|tracked-all-strict)").option("--include-pm-internals","Include PM storage internals in tracked-all candidate scans").option("--verbose-file-lists","Include full file-path lists for validate --check-files details").option("--verbose-diagnostics","Include full diagnostic ID lists").option("--all-affected-ids","Emit complete missing_* affected-ID lists with no truncation (implied by --json)").option("--strict-exit","Return non-zero exit when validation warnings are present").option("--fail-on-warn","Alias for --strict-exit").option("--fix-hints","Add a machine-executable fix_hints[] of pm commands to each failing check's details").option("--auto-fix","Apply safe, deterministic field backfills").option("--dry-run","Preview planned --auto-fix/--prune-missing fixes without applying them").option("--fix-scope <scope>","Grant --auto-fix scopes (metadata, resolution, estimates, timestamps, lifecycle; comma-separated or repeatable). Default: metadata, resolution; other scopes require explicit opt-in",collect).option("--prune-missing","Remove deleted-path file/doc links; preserves real files").option("--check-history-drift","Run item/history hash drift checks").option("--check-storage-integrity","Run the post-merge storage-integrity check (unreadable items, history conflict markers, resurrected deletes, unparseable config/schema)").option("--counts","Keep validation counts and totals while omitting per-item diagnostic arrays").option("--full","Return the complete validation diagnostic projection").action(runValidateAction);program.command("gc").option("--dry-run","Preview cleanup targets without deleting files; without this flag, pm gc deletes matched artifacts").option("--scope <value>","Limit cleanup to one or more scopes (comma-separated or repeatable): index, embeddings, runtime, locks, checkpoints, transactions",collect).description("Delete optional cache artifacts by default (including expired lock debris) and show a summary.").action(runGcAction);const workspaceCommand=program.command("workspace").description("Inspect workspace state and snapshots.");workspaceCommand.command("position").description("Show merge and history readiness.").action(runWorkspacePositionAction);workspaceCommand.command("snapshot").argument("<action>","Action: create, list, inspect, restore, delete").argument("[target]","Optional name for create; name or fingerprint otherwise").description("Manage content-addressed tracker snapshots.").option("--dry-run","Preview restore file, item, stream, and history-entry impact without mutating state").option("--force","Explicitly confirm a whole-workspace snapshot restore").option("--author <value>","Actor recorded on the restore audit event").option("--message <value>","Human-readable restore rationale").action(runWorkspaceSnapshotAction);program.command("contracts").description("Show machine-readable command and schema contracts for agents.").option("--action <value>","Filter tool schema branches to a specific action").option("--command <value>","Scope contracts output to one CLI command (narrow-by-default)").option("--summary","Return one command+intent row per top-level command for cheap agent bootstrap").option("--schema-only","Return schema-focused output only").option("--flags-only","Return command flag contracts only").option("--availability-only","Return action availability surface only").option("--runtime-only","Include only actions invocable in the current runtime").option("--active-only","Alias for --runtime-only").option("--full","Include full schema and command-flag surfaces (large; default brief output omits heavy sections for unfiltered queries)").action(runContractsAction);const claimCommand=program.command("claim").option("--start","Claim and start an explicit item").argument("[id]","Item id (omit with --next)").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force claim override").option("--if-available","Skip another author's claim (skipped=true)").option("--next","Atomically claim the next caller-available actionable item").option("--type <value>","Filter --next candidates by type").option("--tag <value>","Filter --next candidates by tag").option("--priority <value>","Filter --next candidates by priority").option("--assignee-filter <value>","Filter --next candidates: assigned|unassigned").option("--parent <id>","Scope --next candidates to a subtree").option("--sprint <value>","Filter --next candidates by sprint").option("--release <value>","Filter --next candidates by release").option("--max-attempts <n>","Bound the --next candidate walk (default 10; maximum 100)").option("--include-decisions","Allow --next to claim human-gated Decision items").option("--include-gates","Allow --next to claim outcome gates").option("--include-containers","Allow --next to claim containers with unfinished descendants").option("--token-budget <n>","Bound the estimated tokens used to rank --next candidates").option("--explain-ranking","Include ranking provenance for --next selection").description("Claim an item for active work.").action(runClaimAction);addHiddenOption(claimCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");addHiddenOption(claimCommand,"--token_budget <n>","Alias for --token-budget");addHiddenOption(claimCommand,"--explain_ranking","Alias for --explain-ranking");const releaseCommand=program.command("release").option("--pause","Use open status").argument("<id>","Item id").option("--author <value>","Author").option("--message <value>","Message").option("--force","Override ownership").description("Release ownership.").action(runReleaseAction);addHiddenOption(releaseCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const startTaskCommand=program.command("start-task",{hidden:true}).argument("<id>","Item id").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership or terminal override when required").description("Lifecycle alias: claim an item and move it to in_progress.").action(runStartTaskAction);addHiddenOption(startTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const pauseTaskCommand=program.command("pause-task",{hidden:true}).argument("<id>","Item id").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override when required").description("Lifecycle alias: move an item to open and release its claim.").action(runPauseTaskAction);addHiddenOption(pauseTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const closeTaskCommand=program.command("close-task",{hidden:true}).argument("<id>","Item id").argument("[reason]","Close reason text").option("--author <value>","Mutation author").option("--message <value>","History message").option("--validate-close <value>","Close-time validation mode: off|warn|strict").option("--force","Force ownership or terminal override when required").description("Lifecycle alias: close an item and release assignment metadata.").action(runCloseTaskAction);addHiddenOption(closeTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands")}export{_testOnlyRegisterOperations,registerOperationCommands,requireClaimTarget};
 //# sourceMappingURL=register-operations.js.map