@unbrained/pm-cli 2026.10.4 → 2026.10.5

package/dist/cli/register-mutation.js

@@ -1,6 +1,6 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3418cfe8-745d-5f3c-9d14-8293e7296875")}catch(e2){}})();import{resolveBodyFileContent,resolveCliBulkIdsInput,EXIT_CODE,PmCliError,createUnknownSubcommandError}from"../sdk/runtime-primitives.js";import{CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,MERGE_SUBCOMMAND_VALUES,PLAN_CREATE_METADATA_PARAMETER_KEYS,UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS}from"../sdk/cli-contracts.js";import{BUILTIN_ITEM_TYPE_VALUES,PLAN_STEP_LINK_KIND_VALUES}from"../types/index.js";import{MERGE_DRIVER_ARTIFACT_VALUES,runMergeDriver,runMergeInstall,runMergeReconcile,runMergeReceiptEvidenceReport}from"./commands/workspace/merge.js";import{runAppend}from"./commands/lifecycle/append.js";import{runClose}from"./commands/lifecycle/close.js";import{runCloseTask}from"../sdk/lifecycle/task-composition.js";import{runCloseMany}from"./commands/lifecycle/close-many.js";import{runCopy}from"./commands/lifecycle/copy.js";import{runCreate}from"./commands/lifecycle/create.js";import{runDelete}from"./commands/lifecycle/delete.js";import{runDeps}from"./commands/query/deps.js";import{runDocs}from"./commands/annotations/docs.js";import{runFiles,runFilesDiscover}from"./commands/annotations/files.js";import{runFocus}from"./commands/lifecycle/focus.js";import*as profileModule from"./commands/workspace/profile.js";import{runUpdate}from"./commands/lifecycle/update.js";import{runUpdateMany}from"./commands/lifecycle/update-many.js";import{createStdinTokenResolver,preserveMutationStdinTokenFields,preserveMutationStdinTokenLiterals}from"../sdk/runtime-primitives.js";import{resolveDescriptionStdin}from"./description-stdin.js";import{itemDocumentToMutationOptions}from"../sdk/structured-mutations.js";import{registerStructuredMutationCommands}from"./register-structured-mutation.js";import{registerHistoryMaintenanceCommands}from"./register-history-maintenance.js";import{registerHistoryAuthorAcknowledgeCommand}from"./register-history-author.js";import{PLAN_SUBCOMMANDS,runPlan}from"./commands/lifecycle/plan.js";import{registerAnnotationCommands}from"./register-annotations.js";import{registerFilesLookupCommand}from"./register-files-lookup.js";import{isPureSnakeCaseAlias}from"./schema-registration-helpers.js";import{registerSchemaCommand}from"./schema/registration.js";import{stringArrayOption}from"./option-values.js";import{looksLikeSchemaSubcommandTypo,parseSchemaOrderOption}from"./schema-registration-helpers.js";const BUILTIN_TYPE_NAME_LOOKUP=new Set(BUILTIN_ITEM_TYPE_VALUES.map(value=>value.toLowerCase()));const PLAN_CREATE_METADATA_OPTION_TARGETS=new Set(PLAN_CREATE_METADATA_PARAMETER_KEYS.map(key=>key==="estimate"?"estimatedMinutes":key));import{collect,applyActiveCommandResultService,addHiddenOption,addHiddenOptions,extractUpdateManyMutationOptionSource,formatHookWarnings,getGlobalOptions,invalidateSearchCachesForMutation,normalizeCreateOptions,normalizeUpdateOptions,printError,printResult,readOptionString,writeStdout}from"./registration-helpers.js";async function dispatchProfileSubcommand(profile,subcommand,name,options,globalOptions){switch(subcommand){case"list":return profile.runProfileList();case"show":return profile.runProfileShow(name);case"lint":return profile.runProfileLint(name);default:return profile.runProfileApply(name,{dryRun:options.dryRun===true,author:typeof options.author==="string"?options.author:void 0,force:options.force===true},globalOptions)}}function renderProfileResultHuman(profile,result){switch(result.action){case"list":writeStdout(`${profile.formatProfileListHuman(result)}
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5434cb0e-0d0d-551a-8ef5-d60f94cf5bde")}catch{}})();import{resolveBodyFileContent,resolveCliBulkIdsInput,EXIT_CODE,PmCliError,createUnknownSubcommandError}from"../sdk/runtime-primitives.js";import{CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,MERGE_SUBCOMMAND_VALUES,PLAN_CREATE_METADATA_PARAMETER_KEYS,UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS}from"../sdk/cli-contracts.js";import{BUILTIN_ITEM_TYPE_VALUES,PLAN_STEP_LINK_KIND_VALUES}from"../types/index.js";import{MERGE_DRIVER_ARTIFACT_VALUES,runMergeDriver,runMergeInstall,runMergeReconcile,runMergeReceiptEvidenceReport}from"./commands/workspace/merge.js";import{runAppend}from"./commands/lifecycle/append.js";import{runClose}from"./commands/lifecycle/close.js";import{runCloseTask}from"../sdk/lifecycle/task-composition.js";import{runCloseMany}from"./commands/lifecycle/close-many.js";import{runCopy}from"./commands/lifecycle/copy.js";import{runCreate}from"./commands/lifecycle/create.js";import{runDelete}from"./commands/lifecycle/delete.js";import{runDeps}from"./commands/query/deps.js";import{runDocs}from"./commands/annotations/docs.js";import{runFiles,runFilesDiscover}from"./commands/annotations/files.js";import{runFocus}from"./commands/lifecycle/focus.js";import*as profileModule from"./commands/workspace/profile.js";import{runUpdate}from"./commands/lifecycle/update.js";import{runUpdateMany}from"./commands/lifecycle/update-many.js";import{createStdinTokenResolver,preserveMutationStdinTokenFields,preserveMutationStdinTokenLiterals}from"../sdk/runtime-primitives.js";import{resolveDescriptionStdin}from"./description-stdin.js";import{itemDocumentToMutationOptions}from"../sdk/structured-mutations.js";import{registerStructuredMutationCommands}from"./register-structured-mutation.js";import{registerHistoryMaintenanceCommands}from"./register-history-maintenance.js";import{registerHistoryAuthorAcknowledgeCommand}from"./register-history-author.js";import{PLAN_SUBCOMMANDS,runPlan}from"./commands/lifecycle/plan.js";import{registerAnnotationCommands}from"./register-annotations.js";import{registerFilesLookupCommand}from"./register-files-lookup.js";import{isPureSnakeCaseAlias}from"./schema-registration-helpers.js";import{registerSchemaCommand}from"./schema/registration.js";import{stringArrayOption}from"./option-values.js";import{looksLikeSchemaSubcommandTypo,parseSchemaOrderOption}from"./schema-registration-helpers.js";const BUILTIN_TYPE_NAME_LOOKUP=new Set(BUILTIN_ITEM_TYPE_VALUES.map(value=>value.toLowerCase())),PLAN_CREATE_METADATA_OPTION_TARGETS=new Set(PLAN_CREATE_METADATA_PARAMETER_KEYS.map(key=>key==="estimate"?"estimatedMinutes":key));import{collect,applyActiveCommandResultService,addHiddenOption,addHiddenOptions,extractUpdateManyMutationOptionSource,formatHookWarnings,getGlobalOptions,invalidateSearchCachesForMutation,normalizeCreateOptions,normalizeUpdateOptions,printError,printResult,readOptionString,writeStdout}from"./registration-helpers.js";async function dispatchProfileSubcommand(profile,subcommand,name,options,globalOptions){switch(subcommand){case"list":return profile.runProfileList();case"show":return profile.runProfileShow(name);case"lint":return profile.runProfileLint(name);default:return profile.runProfileApply(name,{dryRun:options.dryRun===!0,author:typeof options.author=="string"?options.author:void 0,force:options.force===!0},globalOptions)}}function renderProfileResultHuman(profile,result){switch(result.action){case"list":writeStdout(`${profile.formatProfileListHuman(result)}
 `);return;case"show":writeStdout(`${profile.formatProfileShowHuman(result)}
 `);return;case"lint":writeStdout(`${profile.formatProfileLintHuman(result)}
 `);return;default:writeStdout(`${profile.formatProfileApplyHuman(result)}
-`);if(result.warnings.length>0){printError(`profile apply warnings: ${formatHookWarnings(result.warnings)}`)}break}}function parsePositiveIntOption(flag){return value=>{const parsed=Number(value);if(!Number.isInteger(parsed)||parsed<1){throw new PmCliError(`${flag} must be a positive integer (1-based index).`,EXIT_CODE.USAGE)}return parsed}}function registerBulkContentAndGovernanceFilters(command,action){command.option("--filter-has-notes",`Select only items that have notes before ${action}`).option("--filter-no-notes",`Select only items that have no notes before ${action}`).option("--filter-has-learnings",`Select only items that have learnings before ${action}`).option("--filter-no-learnings",`Select only items that have no learnings before ${action}`).option("--filter-has-files",`Select only items that have linked files before ${action}`).option("--filter-no-files",`Select only items that have no linked files before ${action}`).option("--filter-has-docs",`Select only items that have linked docs before ${action}`).option("--filter-no-docs",`Select only items that have no linked docs before ${action}`).option("--filter-has-tests",`Select only items that have linked tests before ${action}`).option("--filter-no-tests",`Select only items that have no linked tests before ${action}`).option("--filter-has-comments",`Select only items that have comments before ${action}`).option("--filter-no-comments",`Select only items that have no comments before ${action}`).option("--filter-has-deps",`Select only items that have dependencies before ${action}`).option("--filter-no-deps",`Select only items that have no dependencies before ${action}`).option("--filter-has-body",`Select only items that have a non-empty body before ${action}`).option("--filter-empty-body",`Select only items with an empty body before ${action}`).option("--filter-has-linked-command",`Select only items whose linked tests carry a runnable command before ${action}`).option("--filter-no-linked-command",`Select only items whose linked tests carry no runnable command before ${action}`).option("--filter-reviewer-missing",`Select only items missing reviewer before ${action}`).option("--filter-risk-missing",`Select only items missing risk before ${action}`).option("--filter-confidence-missing",`Select only items missing confidence before ${action}`).option("--filter-sprint-missing",`Select only items missing sprint before ${action}`).option("--filter-release-missing",`Select only items missing release before ${action}`)}const BULK_CONTENT_FILTER_CONFLICTS=[["filterHasNotes","filterNoNotes","--filter-has-notes","--filter-no-notes"],["filterHasLearnings","filterNoLearnings","--filter-has-learnings","--filter-no-learnings"],["filterHasFiles","filterNoFiles","--filter-has-files","--filter-no-files"],["filterHasDocs","filterNoDocs","--filter-has-docs","--filter-no-docs"],["filterHasTests","filterNoTests","--filter-has-tests","--filter-no-tests"],["filterHasComments","filterNoComments","--filter-has-comments","--filter-no-comments"],["filterHasDeps","filterNoDeps","--filter-has-deps","--filter-no-deps"],["filterHasBody","filterEmptyBody","--filter-has-body","--filter-empty-body"],["filterHasLinkedCommand","filterNoLinkedCommand","--filter-has-linked-command","--filter-no-linked-command"]];function mapBulkContentAndGovernanceFilters(options){const presence=key=>options[key]===true?true:void 0;for(const[hasKey,noKey,hasFlag,noFlag]of BULK_CONTENT_FILTER_CONFLICTS){if(options[hasKey]===true&&options[noKey]===true){throw new PmCliError(`Cannot combine ${hasFlag} with ${noFlag} for the same field.`,EXIT_CODE.USAGE)}}return{filterReviewerMissing:presence("filterReviewerMissing"),filterRiskMissing:presence("filterRiskMissing"),filterConfidenceMissing:presence("filterConfidenceMissing"),filterSprintMissing:presence("filterSprintMissing"),filterReleaseMissing:presence("filterReleaseMissing"),hasNotes:presence("filterHasNotes"),hasLearnings:presence("filterHasLearnings"),hasFiles:presence("filterHasFiles"),hasDocs:presence("filterHasDocs"),hasTests:presence("filterHasTests"),hasComments:presence("filterHasComments"),hasDeps:presence("filterHasDeps"),hasBody:presence("filterHasBody"),hasLinkedCommand:presence("filterHasLinkedCommand"),noNotes:presence("filterNoNotes"),noLearnings:presence("filterNoLearnings"),noFiles:presence("filterNoFiles"),noDocs:presence("filterNoDocs"),noTests:presence("filterNoTests"),noComments:presence("filterNoComments"),noDeps:presence("filterNoDeps"),emptyBody:presence("filterEmptyBody"),noLinkedCommand:presence("filterNoLinkedCommand")}}function registerCommanderOptionContracts(command,contracts){for(const contract of contracts){const sharedValues=[];let activeParseArgs=command.args;const repeatableParser=value=>{if(command.args!==activeParseArgs){sharedValues.length=0;activeParseArgs=command.args}sharedValues.push(value);return sharedValues};if(contract.required){command.requiredOption(contract.option,contract.description)}else if(contract.repeatable){command.option(contract.option,contract.description,repeatableParser)}else{command.option(contract.option,contract.description)}for(const aliasContract of contract.aliasOptions??[]){if(isPureSnakeCaseAlias(contract.option,aliasContract.option)){addHiddenOption(command,aliasContract.option,aliasContract.description,contract.repeatable===true,contract.repeatable?repeatableParser:void 0)}else if(contract.repeatable){command.option(aliasContract.option,aliasContract.description,repeatableParser)}else{command.option(aliasContract.option,aliasContract.description)}}}}function buildUpdateManyListOptions(options){const readString=key=>typeof options[key]==="string"?options[key]:void 0;return{type:readString("filterType"),tag:readString("filterTag"),priority:readString("filterPriority"),deadlineBefore:readString("filterDeadlineBefore"),deadlineAfter:readString("filterDeadlineAfter"),updatedAfter:readString("filterUpdatedAfter"),updatedBefore:readString("filterUpdatedBefore"),createdAfter:readString("filterCreatedAfter"),createdBefore:readString("filterCreatedBefore"),ids:readString("ids"),assignee:readString("filterAssignee"),assigneeFilter:readString("filterAssigneeFilter")??readString("filterAssignee_filter"),parent:readString("filterParent"),sprint:readString("filterSprint"),release:readString("filterRelease"),filterAcMissing:options.filterAcMissing===true?true:void 0,filterEstimatesMissing:options.filterEstimatesMissing===true||options.filterEstimateMissing===true?true:void 0,filterResolutionMissing:options.filterResolutionMissing===true?true:void 0,filterMetadataMissing:options.filterMetadataMissing===true?true:void 0,...mapBulkContentAndGovernanceFilters(options),limit:readString("limit"),offset:readString("offset"),includeBody:true}}function pickStringOption(...candidates){for(const candidate of candidates){if(typeof candidate==="string"){return candidate}}return void 0}function resolveCreatePositionals(typeOrTitle,secondTitle,options){if(typeof secondTitle==="string"&&secondTitle.length>0){return{positionalType:typeOrTitle,positionalTitle:secondTitle}}if(typeof typeOrTitle!=="string"||typeOrTitle.length===0){return{positionalType:void 0,positionalTitle:void 0}}const explicitTitleProvided=typeof options.title==="string"&&options.title.trim().length>0;return explicitTitleProvided&&options.type===void 0?{positionalType:typeOrTitle,positionalTitle:void 0}:{positionalType:void 0,positionalTitle:typeOrTitle}}function assertCreatePositionalTypeHasTitle(positionalType,positionalTitle,options){if(positionalType!==void 0||typeof positionalTitle!=="string"||positionalTitle.length===0||options.title!==void 0||options.type!==void 0||!BUILTIN_TYPE_NAME_LOOKUP.has(positionalTitle.trim().toLowerCase())){return}const matchedType=positionalTitle.trim();throw new PmCliError(`pm create needs a title \u2014 "${matchedType}" looks like an item type, not a title. Use either: pm create ${matchedType} "<title>" or pm create "<title>" --type ${matchedType}.`,EXIT_CODE.USAGE,{code:"create_positional_type_without_title",why:'Without this guard the single positional is used as the title and the type defaults to Task \u2014 so the command would silently create a Task literally titled "'+matchedType+'".',examples:[`pm create ${matchedType} "Wire up SSO for the agent harness"`,`pm create "Wire up SSO for the agent harness" --type ${matchedType}`],nextSteps:[`Re-run with both type and title: pm create ${matchedType} "<title>"`]})}const STRUCTURED_STDIN_CONFLICT_KEYS=["body","bodyFile","description","dep","depRemove","comment","note","learning","file","test","doc","reminder","event","typeOption","field","ids"];function assertSingleMutationStdinConsumer(options){const stdinFlags=STRUCTURED_STDIN_CONFLICT_KEYS.flatMap(key=>{const value=options[key];const count=typeof value==="string"&&value.trim()==="-"?1:Array.isArray(value)?value.filter(entry=>typeof entry==="string"&&entry.trim()==="-").length:0;const flag=`--${key.replace(/[A-Z]/g,letter=>`-${letter.toLowerCase()}`)}`;return Array.from({length:count},()=>flag)});if(options.stdinJson===true){stdinFlags.unshift("--stdin-json")}if(stdinFlags.length>1){throw new PmCliError(`Only one option may consume stdin per command invocation. Found: ${stdinFlags.join(", ")}.`,EXIT_CODE.USAGE)}}function preserveResolvedMutationStdinFields(options,bodyFileResolved,descriptionStdinResolved){const fields=[];if(bodyFileResolved)fields.push("body");if(descriptionStdinResolved)fields.push("description");preserveMutationStdinTokenFields(options,fields)}function isDescriptionStdinConsumer(options,stdinJsonConsumed){return!stdinJsonConsumed&&typeof options.description==="string"&&options.description.trim()==="-"}async function runCreateAction(typeOrTitle,secondTitle,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertSingleMutationStdinConsumer(options);const stdinJsonConsumed=options.stdinJson===true;if(stdinJsonConsumed){const input=await createStdinTokenResolver().resolveValue("-","--stdin-json");options=itemDocumentToMutationOptions(input??"","create",options)}const positionals=resolveCreatePositionals(typeOrTitle,secondTitle,options);assertCreatePositionalTypeHasTitle(positionals.positionalType,positionals.positionalTitle,options);if(typeof positionals.positionalType==="string"&&positionals.positionalType.length>0&&options.type===void 0){options.type=positionals.positionalType}if(typeof positionals.positionalTitle==="string"&&positionals.positionalTitle.length>0&&options.title===void 0)options.title=positionals.positionalTitle;const descriptionStdinResolved=isDescriptionStdinConsumer(options,stdinJsonConsumed);if(!stdinJsonConsumed){await resolveDescriptionStdin(options)}const bodyFileResolved=typeof options.bodyFile==="string";if(bodyFileResolved){options.body=await resolveBodyFileContent(String(options.bodyFile),options.body!==void 0?String(options.body):void 0);delete options.bodyFile}const normalized=normalizeCreateOptions(options,{requireType:false});preserveResolvedMutationStdinFields(normalized,bodyFileResolved,descriptionStdinResolved);if(stdinJsonConsumed)preserveMutationStdinTokenLiterals(normalized);const result=await runCreate(normalized,globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=create took_ms=${Date.now()-startedAt}`)}}function buildCloseManyListOptions(options){return{type:readOptionString(options,"filterType"),tag:readOptionString(options,"filterTag"),priority:readOptionString(options,"filterPriority"),deadlineBefore:readOptionString(options,"filterDeadlineBefore"),deadlineAfter:readOptionString(options,"filterDeadlineAfter"),updatedAfter:readOptionString(options,"filterUpdatedAfter"),updatedBefore:readOptionString(options,"filterUpdatedBefore"),createdAfter:readOptionString(options,"filterCreatedAfter"),createdBefore:readOptionString(options,"filterCreatedBefore"),ids:readOptionString(options,"ids"),assignee:readOptionString(options,"filterAssignee"),assigneeFilter:pickStringOption(options.filterAssigneeFilter,options.filterAssignee_filter),parent:readOptionString(options,"filterParent"),sprint:readOptionString(options,"filterSprint"),release:readOptionString(options,"filterRelease"),...mapBulkContentAndGovernanceFilters(options),limit:readOptionString(options,"limit"),offset:readOptionString(options,"offset")}}async function runCloseManyAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertSingleMutationStdinConsumer(options);options.ids=await resolveCliBulkIdsInput(readOptionString(options,"ids"));const result=await runCloseMany({status:readOptionString(options,"filterStatus"),list:buildCloseManyListOptions(options),reason:readOptionString(options,"reason"),completedAt:readOptionString(options,"completedAt"),resolution:readOptionString(options,"resolution"),expectedResult:pickStringOption(options.expectedResult,options.expected_result,options.expected),actualResult:pickStringOption(options.actualResult,options.actual_result,options.actual),validateClose:options.validateClose===true?"warn":readOptionString(options,"validateClose"),author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:Boolean(options.force),dryRun:options.dryRun===true?true:void 0,rollback:readOptionString(options,"rollback"),checkpoint:options.checkpoint===false?false:void 0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=close-many took_ms=${Date.now()-startedAt}`)}}async function runUpdateManyAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertSingleMutationStdinConsumer(options);options.ids=await resolveCliBulkIdsInput(readOptionString(options,"ids"));const result=await runUpdateMany({status:readOptionString(options,"filterStatus"),list:buildUpdateManyListOptions(options),update:normalizeUpdateOptions(extractUpdateManyMutationOptionSource(options)),dryRun:options.dryRun===true?true:void 0,rollback:readOptionString(options,"rollback"),checkpoint:options.checkpoint===false?false:void 0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(await applyActiveCommandResultService("update-many",[],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=update-many took_ms=${Date.now()-startedAt}`)}}async function runCloseAction(id,text,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const reasonFromOption=typeof options.reason==="string"&&options.reason.trim().length>0&&options.reason||typeof options.closeReason==="string"&&options.closeReason.trim().length>0&&options.closeReason||void 0;const resolvedText=typeof text==="string"&&text.length>0?text:reasonFromOption;const close=options.releaseAssignment===true?runCloseTask:runClose;const result=await close(id,resolvedText,{author:readOptionString(options,"author"),message:readOptionString(options,"message"),validateClose:options.validateClose===true?"warn":readOptionString(options,"validateClose"),force:Boolean(options.force),duplicateOf:readOptionString(options,"duplicateOf"),completedAt:readOptionString(options,"completedAt"),resolution:readOptionString(options,"resolution"),expectedResult:pickStringOption(options.expectedResult,options.expected_result,options.expected),actualResult:pickStringOption(options.actualResult,options.actual_result,options.actual)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=close took_ms=${Date.now()-startedAt}`)}}function normalizePlanAliases(options){const planOptions={...options};const aliasPairs=[["blocked_by","blockedBy"],["resume_context","resumeContext"],["from_search","fromSearch"],["step_title","stepTitle"],["step_body","stepBody"],["step_owner","stepOwner"],["step_status","stepStatus"],["step_evidence","stepEvidence"],["step_blocked_reason","stepBlockedReason"],["step_replacement","stepReplacement"],["depends_on","dependsOn"],["link_kind","linkKind"],["link_note","linkNote"],["promote_to_item_dep","promoteToItemDep"],["allow_multiple_active","allowMultipleActive"],["decision_text","decisionText"],["decision_rationale","decisionRationale"],["decision_evidence","decisionEvidence"],["discovery_text","discoveryText"],["validation_text","validationText"],["validation_command","validationCommand"],["validation_expected","validationExpected"],["materialize_type","materializeType"],["materialize_parent","materializeParent"],["materialize_tags","materializeTags"]];for(const[snake,camel]of aliasPairs){if(planOptions[snake]!==void 0&&planOptions[camel]===void 0){planOptions[camel]=planOptions[snake]}}const normalized=normalizeCreateOptions(planOptions,{requireType:false});normalized.blockedBy=planOptions.blockedBy;return normalized}function assertKnownPlanSubcommand(normalized,allowed){if(!normalized){throw new PmCliError(`pm plan requires a subcommand. Allowed: ${allowed.join(", ")}`,EXIT_CODE.USAGE,{code:"missing_required_argument",examples:['pm plan create --title "Refactor lock retry"',"pm plan show pm-a1b2 --depth standard",'pm plan add-step pm-a1b2 --step-title "Read lock.ts"']})}if(allowed.includes(normalized)){return}const examples=normalized==="list"||normalized==="ls"?["pm list --type Plan","pm list-all --type Plan"]:void 0;throw createUnknownSubcommandError({command_path:"plan",token:normalized,allowed,examples,retry_command:normalized==="list"||normalized==="ls"?"pm list --type Plan":void 0})}function parsePlanReorderTo(normalizedSubcommand,reorderToken){if(normalizedSubcommand!=="reorder-step"||typeof reorderToken!=="string"){return void 0}const parsed=Number.parseInt(reorderToken,10);if(!Number.isFinite(parsed)){throw new PmCliError(`reorder-step requires an integer new order, got "${reorderToken}"`,EXIT_CODE.USAGE)}return parsed}async function runPlanAction(subcommand,id,stepRef,reorderToken,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const normalizedSubcommand=(subcommand??"").trim().toLowerCase();assertKnownPlanSubcommand(normalizedSubcommand,PLAN_SUBCOMMANDS);const planOptions=normalizePlanAliases(options);const reorderTo=parsePlanReorderTo(normalizedSubcommand,reorderToken);const planId=normalizedSubcommand==="create"&&typeof id==="string"&&id.length>0&&planOptions.title===void 0?void 0:id;if(planId===void 0&&typeof id==="string"&&id.length>0){planOptions.title=id}const result=await runPlan({subcommand:normalizedSubcommand,id:planId,stepRef,reorderTo,options:planOptions,global:globalOptions});await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=plan took_ms=${Date.now()-startedAt}`)}}async function runMergeReconcileSubcommand(artifact,options,globalOptions){if(artifact!==void 0){throw new PmCliError("merge reconcile takes no positional arguments.",EXIT_CODE.USAGE)}const result=await runMergeReconcile({dryRun:options.dryRun===true,force:options.force===true,message:typeof options.message==="string"?options.message:void 0,author:globalOptions.author},globalOptions);printResult(result,globalOptions);if(!result.ok)process.exitCode=EXIT_CODE.GENERIC_FAILURE}async function runMergeDriverSubcommand(artifact,base,ours,theirs,options,globalOptions){if(artifact===void 0||base===void 0||ours===void 0||theirs===void 0){throw new PmCliError("merge driver requires <artifact> <base> <ours> <theirs> (git supplies %O %A %B). Example: pm merge driver history %O %A %B",EXIT_CODE.USAGE)}const result=await runMergeDriver({artifact,basePath:base,oursPath:ours,theirsPath:theirs,outputPath:typeof options.output==="string"?options.output:void 0,itemPath:typeof options.itemPath==="string"?options.itemPath:void 0,prefer:typeof options.prefer==="string"?options.prefer:void 0},globalOptions);printResult(result,globalOptions);if(!result.ok){process.exitCode=EXIT_CODE.GENERIC_FAILURE}}async function runMergeAction(subcommand,artifact,base,ours,theirs,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const normalized=subcommand.trim().toLowerCase();switch(normalized){case"install":{if(artifact!==void 0){throw new PmCliError("merge install takes no positional arguments.",EXIT_CODE.USAGE)}const result=await runMergeInstall({dryRun:options.dryRun===true},globalOptions);printResult(result,globalOptions);break}case"reconcile":await runMergeReconcileSubcommand(artifact,options,globalOptions);break;case"report":{if(artifact!==void 0){throw new PmCliError("merge report takes no positional arguments.",EXIT_CODE.USAGE)}const result=await runMergeReceiptEvidenceReport({includeReconciled:options.includeReconciled===true});printResult(result,globalOptions);if(!result.ok)process.exitCode=EXIT_CODE.GENERIC_FAILURE;break}case"driver":await runMergeDriverSubcommand(artifact,base,ours,theirs,options,globalOptions);break;default:throw createUnknownSubcommandError({command_path:"merge",token:subcommand,allowed:MERGE_SUBCOMMAND_VALUES,display_name:"merge"})}if(globalOptions.profile){printError(`profile:command=merge took_ms=${Date.now()-startedAt}`)}}async function runCopyAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runCopy(id,{title:readOptionString(options,"title"),author:readOptionString(options,"author"),message:readOptionString(options,"message"),allowDuplicate:options.allowDuplicate===true},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=copy took_ms=${Date.now()-startedAt}`)}}async function runFocusAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runFocus(id,{clear:options.clear===true},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=focus took_ms=${Date.now()-startedAt}`)}}async function runUpdateAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertSingleMutationStdinConsumer(options);const stdinJsonConsumed=options.stdinJson===true;if(stdinJsonConsumed){const input=await createStdinTokenResolver().resolveValue("-","--stdin-json");options=itemDocumentToMutationOptions(input??"","update",options)}const descriptionStdinResolved=isDescriptionStdinConsumer(options,stdinJsonConsumed);if(!stdinJsonConsumed){await resolveDescriptionStdin(options)}const bodyFileResolved=typeof options.bodyFile==="string";if(bodyFileResolved){options.body=await resolveBodyFileContent(String(options.bodyFile),options.body!==void 0?String(options.body):void 0);delete options.bodyFile}const normalized=normalizeUpdateOptions(options);preserveResolvedMutationStdinFields(normalized,bodyFileResolved,descriptionStdinResolved);if(stdinJsonConsumed)preserveMutationStdinTokenLiterals(normalized);const result=await runUpdate(id,normalized,globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(await applyActiveCommandResultService("update",[id],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=update took_ms=${Date.now()-startedAt}`)}}async function runDeleteAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runDelete(id,{author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:Boolean(options.force),dryRun:options.dryRun===true},globalOptions);if(result.dry_run!==true){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=delete took_ms=${Date.now()-startedAt}`)}}function resolveAppendBody(text,options){const bodyFromOption=readOptionString(options,"body");const bodyFromAlias=readOptionString(options,"text");const bodyFromPositional=typeof text==="string"?text:void 0;const bodySourceCount=[bodyFromOption,bodyFromAlias,bodyFromPositional].filter(value=>value!==void 0).length;if(bodySourceCount>1){throw new PmCliError("Specify append text with exactly one source: positional [text], --body, or --text",EXIT_CODE.USAGE)}const resolvedBody=bodyFromOption??bodyFromAlias??bodyFromPositional;if(resolvedBody===void 0){throw new PmCliError("Missing append text. Provide it as positional [text], --body <value>, or --text <value> (use - for stdin).",EXIT_CODE.USAGE)}return resolvedBody}async function runAppendAction(id,text,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runAppend(id,{body:resolveAppendBody(text,options),author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:Boolean(options.force)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=append took_ms=${Date.now()-startedAt}`)}}async function runProfileAction(subcommand,name,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const{PROFILE_SUBCOMMANDS}=profileModule;const normalizedSubcommand=(subcommand??"").trim().toLowerCase();if(!normalizedSubcommand){throw new PmCliError(`pm profile requires a subcommand. Allowed: ${PROFILE_SUBCOMMANDS.join(", ")}`,EXIT_CODE.USAGE,{code:"missing_required_argument",examples:["pm profile list","pm profile show agile","pm profile apply agile --dry-run","pm profile lint agile"]})}if(!PROFILE_SUBCOMMANDS.includes(normalizedSubcommand)){throw createUnknownSubcommandError({command_path:"profile",token:normalizedSubcommand,allowed:PROFILE_SUBCOMMANDS})}const result=await dispatchProfileSubcommand(profileModule,normalizedSubcommand,name,options,globalOptions);if(globalOptions.json===true||globalOptions.defaultOutputFormat==="json"){printResult(result,globalOptions)}else if(!globalOptions.quiet){renderProfileResultHuman(profileModule,result)}if(result.action==="lint"&&!result.ok){process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=profile took_ms=${Date.now()-startedAt}`)}}function readStringArrayOption(options,key){return stringArrayOption(options[key])??[]}async function runFilesAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const addValues=readStringArrayOption(options,"add");const addGlobValues=readStringArrayOption(options,"addGlob");const removeValues=readStringArrayOption(options,"remove");const migrateValues=readStringArrayOption(options,"migrate");const result=await runFiles(id,{add:addValues,addGlob:addGlobValues,remove:removeValues,migrate:migrateValues,note:readOptionString(options,"note"),list:Boolean(options.list),appendStable:Boolean(options.appendStable),validatePaths:Boolean(options.validatePaths),author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:Boolean(options.force)},globalOptions);if(addValues.length>0||addGlobValues.length>0||removeValues.length>0||migrateValues.length>0){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(await applyActiveCommandResultService("files",[id],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=files took_ms=${Date.now()-startedAt}`)}}async function runFilesDiscoverAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const mergedOptions={...command.optsWithGlobals(),...options};const result=await runFilesDiscover(id,{apply:Boolean(mergedOptions.apply),note:readOptionString(mergedOptions,"note"),appendStable:Boolean(mergedOptions.appendStable),author:readOptionString(mergedOptions,"author"),message:readOptionString(mergedOptions,"message"),force:Boolean(mergedOptions.force)},globalOptions);if(result.changed){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=files.discover took_ms=${Date.now()-startedAt}`)}}async function runDocsAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const addValues=readStringArrayOption(options,"add");const addGlobValues=readStringArrayOption(options,"addGlob");const removeValues=readStringArrayOption(options,"remove");const migrateValues=readStringArrayOption(options,"migrate");const result=await runDocs(id,{add:addValues,addGlob:addGlobValues,remove:removeValues,migrate:migrateValues,note:readOptionString(options,"note"),list:Boolean(options.list),validatePaths:Boolean(options.validatePaths),author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:Boolean(options.force)},globalOptions);if(addValues.length>0||addGlobValues.length>0||removeValues.length>0||migrateValues.length>0){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(await applyActiveCommandResultService("docs",[id],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=docs took_ms=${Date.now()-startedAt}`)}}async function runDepsAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runDeps(id,{format:options.format,maxDepth:readOptionString(options,"maxDepth"),collapse:options.collapse,summary:options.summary===true,full:options.full===true,nodeLimit:readOptionString(options,"nodeLimit"),edgeLimit:readOptionString(options,"edgeLimit"),tokenBudget:readOptionString(options,"tokenBudget"),cursor:readOptionString(options,"cursor"),direction:readOptionString(options,"direction"),...Array.isArray(options.kind)?{kind:options.kind}:{}},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=deps took_ms=${Date.now()-startedAt}`)}}function registerMutationCommands(program,registrationOptions={}){const createCommand=program.command("create").argument("[type-or-title]",'Item title, or item type when a title follows (e.g. `pm create task "Fix bug"`)').argument("[title]","Item title when the first argument is an item type").description("Create a new project management item.");registerCommanderOptionContracts(createCommand,CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS);createCommand.option("--stdin-json","Read a full item JSON document from stdin; explicit flags override document values").option("--body-file <path>","Load body from a file or stdin (-); conflicts with --body").option("--clear-deps","Clear dependency entries").option("--clear-comments","Clear comments").option("--clear-notes","Clear notes").option("--clear-learnings","Clear learnings").option("--clear-files","Clear linked files").option("--clear-tests","Clear linked tests").option("--clear-docs","Clear linked docs").option("--clear-reminders","Clear reminders").option("--clear-events","Clear events").option("--clear-type-options","Clear type options").option("--allow-duplicate","Explicitly create even when strict similarity governance finds likely duplicates").action(runCreateAction);if(registrationOptions.targetCommandName==="create"){return}program.command("copy").argument("<id>","Source item id").option("--title <value>","Optional title override for the copied item").option("--author <value>","Mutation author").option("--message <value>","History message").option("--allow-duplicate","Explicitly copy even when strict similarity governance finds likely duplicates").description("Copy an item into a new item id while resetting lifecycle fields.").action(runCopyAction);program.command("focus").argument("[id]","Item id to focus (omit to show current focus)").option("--clear","Clear the focused item").description("Set/clear/show the session focused item that new items default --parent to.").action(runFocusAction);const updateCommand=program.command("update").argument("<id>","Item id").description("Update item fields and metadata.");registerCommanderOptionContracts(updateCommand,UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS);updateCommand.option("--stdin-json","Read a full item JSON document from stdin; explicit flags override document values").option("--body-file <path>","Load body from a file or stdin (-); conflicts with --body").option("--replace-deps","Atomically replace dependency entries with the provided --dep values").option("--replace-tests","Atomically replace linked test entries with the provided --test values").option("--replace-files","Atomically replace linked file entries with the provided --file values").option("--replace-docs","Atomically replace linked doc entries with the provided --doc values").option("--clear-deps","Clear dependency entries").option("--clear-comments","Clear comments").option("--clear-notes","Clear notes").option("--clear-learnings","Clear learnings").option("--clear-files","Clear linked files").option("--clear-tests","Clear linked tests").option("--clear-docs","Clear linked docs").option("--clear-reminders","Clear reminders").option("--clear-events","Clear events").option("--clear-type-options","Clear type options").option("--force","Force ownership override");updateCommand.action(runUpdateAction);registerStructuredMutationCommands(program);const updateManyCommand=program.command("update-many").description("Bulk-update matched items with dry-run plans and rollback checkpoints.").option("--filter-status <value>","Filter by status before applying updates").option("--filter-type <value>","Filter by item type before applying updates").option("--filter-tag <value>","Filter by tag before applying updates").option("--filter-priority <value>","Filter by priority before applying updates").option("--filter-deadline-before <value>","Filter by deadline upper bound before applying updates").option("--filter-deadline-after <value>","Filter by deadline lower bound before applying updates").option("--filter-updated-after <value>","Filter by updated_at lower bound before applying updates (ISO/relative)").option("--filter-updated-before <value>","Filter by updated_at upper bound before applying updates (ISO/relative)").option("--filter-created-after <value>","Filter by created_at lower bound before applying updates (ISO/relative)").option("--filter-created-before <value>","Filter by created_at upper bound before applying updates (ISO/relative)").option("--filter-assignee <value>","Filter by assignee before applying updates").option("--filter-assignee-filter <value>","Filter assignee presence: assigned|unassigned before applying updates").option("--filter-parent <value>","Filter by parent item ID before applying updates").option("--filter-sprint <value>","Filter by sprint before applying updates").option("--filter-release <value>","Filter by release before applying updates").option("--filter-ac-missing","Select only items missing acceptance_criteria (bulk backfill)").option("--filter-estimates-missing","Select only items missing estimated_minutes (bulk backfill)").option("--filter-resolution-missing","Select only terminal items missing resolution (bulk backfill)").option("--filter-metadata-missing","Select only items missing any tracked metadata (AC, estimate, or resolution)");registerBulkContentAndGovernanceFilters(updateManyCommand,"applying updates");updateManyCommand.option("--ids <value>","Explicit ID allowlist: comma/newline text, - stdin, or @path file").option("--limit <n>","Limit matched item count before apply/preview").option("--offset <n>","Skip first n matched rows before apply/preview").option("--dry-run","Preview per-item diffs and checkpoint intent without mutating").option("--rollback <value>","Rollback a prior update-many checkpoint ID").option("--no-checkpoint","Disable checkpoint creation during apply mode").option("--title, -t <value>","Set title").option("--description, -d <value>","Set description").option("--body, -b <value>","Set body (allow empty string)").option("--status, -s <value>","Set status (use close command for closed)").option("--priority, -p <value>","Set priority").option("--type <value>","Set type").option("--tags <value>","Set comma-separated tags (replaces existing). Use --add-tags / --remove-tags to mutate additively.").option("--add-tags <value>","Add tags additively without replacing existing (repeatable; CSV accepted)",collect).option("--remove-tags <value>","Remove tags from the existing list (repeatable; CSV accepted)",collect).option("--deadline <value>","Set deadline (ISO/date string or relative)").option("--estimate, --estimated-minutes <value>","Set estimated minutes").option("--acceptance-criteria <value>","Set acceptance criteria").option("--ac <value>","Alias for --acceptance-criteria").option("--add-ac <value>","Add one semicolon-free acceptance criterion without replacing the existing list (repeatable)",collect).option("--remove-ac <value>","Remove one semicolon-free acceptance criterion by exact text match (repeatable)",collect).option("--definition-of-ready <value>","Set definition of ready").option("--order <value>","Set planning order/rank integer").option("--rank <value>","Alias for --order").option("--goal <value>","Set goal identifier").option("--objective <value>","Set objective identifier").option("--value <value>","Set business value summary").option("--impact <value>","Set business impact summary").option("--outcome <value>","Set expected outcome summary").option("--why-now <value>","Set why-now rationale").option("--assignee <value>","Set assignee").option("--parent <value>","Set parent item ID").option("--reviewer <value>","Set reviewer").option("--risk <value>","Set risk level").option("--confidence <value>","Set confidence level").option("--sprint <value>","Set sprint identifier").option("--release <value>","Set release identifier").option("--blocked-by <value>","Set blocked-by item ID or reason").option("--blocked-reason <value>","Set blocked reason").option("--unblock-note <value>","Set unblock rationale note").option("--reporter <value>","Set issue reporter").option("--severity <value>","Set issue severity").option("--environment <value>","Set issue environment context").option("--repro-steps <value>","Set issue reproduction steps").option("--resolution <value>","Set issue resolution summary").option("--expected-result <value>","Set issue expected behavior").option("--expected <value>","Short alias for --expected-result").option("--actual-result <value>","Set issue observed behavior").option("--actual <value>","Short alias for --actual-result").option("--affected-version <value>","Set affected version identifier").option("--fixed-version <value>","Set fixed version identifier").option("--component <value>","Set issue component ownership").option("--regression [value]","Set regression marker; bare flag means true, or pass true|false|1|0").option("--customer-impact <value>","Set customer impact summary").option("--dep <value>","Add dependency entry id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>",collect).option("--dep-remove <value>","Remove dependency entries by id/kind/author/timestamp signature",collect).option("--replace-deps","Atomically replace dependency entries with provided --dep values").option("--replace-tests","Atomically replace linked tests with provided --test values").option("--replace-files","Atomically replace linked files with provided --file values").option("--replace-docs","Atomically replace linked docs with provided --doc values").option("--comment <value>","Add comment seed author=<value>,created_at=<iso|now>,text=<value>",collect).option("--note <value>","Add note seed author=<value>,created_at=<iso|now>,text=<value>",collect).option("--learning <value>","Add learning seed author=<value>,created_at=<iso|now>,text=<value>",collect).option("--file <value>","Add linked file path=<value>,scope=<project|global>,note=<text>",collect).option("--test <value>","Add linked test command=<value>,path=<value>,scope=<project|global>",collect).option("--doc <value>","Add linked doc path=<value>,scope=<project|global>,note=<text>",collect).option("--reminder <value>","Add reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>",collect).option("--event <value>","Add event entry start=<iso|relative>,end=<iso|relative>,recur_*",collect).option("--type-option <value>","Set type options key=value (repeatable)",collect).option("--unset <field>","Clear scalar metadata field by name (repeatable)",collect).option("--clear-deps","Clear dependency entries").option("--clear-comments","Clear comments").option("--clear-notes","Clear notes").option("--clear-learnings","Clear learnings").option("--clear-files","Clear linked files").option("--clear-tests","Clear linked tests").option("--clear-docs","Clear linked docs").option("--clear-reminders","Clear reminders").option("--clear-events","Clear events").option("--clear-type-options","Clear type options").option("--author <value>","Mutation author").option("--message <value>","Mutation message").option("--force","Force ownership override");addHiddenOptions(updateManyCommand,[["--filter-assignee_filter <value>","Alias for --filter-assignee-filter"],["--estimated_minutes <value>","Alias for --estimated-minutes"],["--acceptance_criteria <value>","Alias for --acceptance-criteria"],["--definition_of_ready <value>","Alias for --definition-of-ready"],["--why_now <value>","Alias for --why-now"],["--blocked_by <value>","Alias for --blocked-by"],["--blocked_reason <value>","Alias for --blocked-reason"],["--unblock_note <value>","Alias for --unblock-note"],["--repro_steps <value>","Alias for --repro-steps"],["--expected_result <value>","Alias for --expected-result"],["--actual_result <value>","Alias for --actual-result"],["--affected_version <value>","Alias for --affected-version"],["--fixed_version <value>","Alias for --fixed-version"],["--customer_impact <value>","Alias for --customer-impact"],["--filter-estimate-missing","Alias for --filter-estimates-missing"]],false);addHiddenOptions(updateManyCommand,[["--dep_remove <value>","Alias for --dep-remove"],["--type_option <value>","Alias for --type-option"],["--add_tags <value>","Alias for --add-tags"],["--remove_tags <value>","Alias for --remove-tags"],["--add_ac <value>","Alias for --add-ac"],["--remove_ac <value>","Alias for --remove-ac"]],true);updateManyCommand.action(runUpdateManyAction);const closeCommand=program.command("close").option("--release-assignment","Release ownership after closure").argument("<id>","Item id").argument("[text]","Close reason text (alias: --reason)").option("-r, --reason <value>","Close reason text (alias for positional <text>)").option("--close-reason <value>","Close reason text (alias for positional <text>)").option("--completed-at <value>","Actual completion timestamp (ISO or relative), distinct from tracker close time").option("-d, --duplicate-of <id>","Close as a duplicate of the canonical item id and auto-fill duplicate closure metadata").option("--author <value>","Mutation author").option("-m, --message <value>","History message").option("--validate-close [mode]",'Validate closure metadata before close: "off", "warn", or "strict" (default: settings governance preset)').option("--resolution <value>","Closure resolution summary (checked by --validate-close strict)").option("--expected-result <value>","Expected outcome for closure validation").option("--expected <value>","Short alias for --expected-result").option("--actual-result <value>","Observed outcome for closure validation").option("--actual <value>","Short alias for --actual-result").option("--force","Force ownership override").description("Close an item. Close reason requirement follows governance.require_close_reason.");addHiddenOption(closeCommand,"--expected_result <value>","Alias for --expected-result",false);addHiddenOption(closeCommand,"--actual_result <value>","Alias for --actual-result",false);closeCommand.action(runCloseAction);const closeManyCommand=program.command("close-many").description("Bulk-close matched items with a shared reason and full runClose semantics (dry-run + rollback checkpoint).").option("--filter-status <value>","Filter by status before closing").option("--filter-type <value>","Filter by item type before closing").option("--filter-tag <value>","Filter by tag before closing").option("--filter-priority <value>","Filter by priority before closing").option("--filter-deadline-before <value>","Filter by deadline upper bound before closing").option("--filter-deadline-after <value>","Filter by deadline lower bound before closing").option("--filter-updated-after <value>","Filter by updated_at lower bound before closing (ISO/relative)").option("--filter-updated-before <value>","Filter by updated_at upper bound before closing (ISO/relative)").option("--filter-created-after <value>","Filter by created_at lower bound before closing (ISO/relative)").option("--filter-created-before <value>","Filter by created_at upper bound before closing (ISO/relative)").option("--filter-assignee <value>","Filter by assignee before closing").option("--filter-assignee-filter <value>","Filter assignee presence: assigned|unassigned before closing").option("--filter-parent <value>","Filter by parent item ID before closing").option("--filter-sprint <value>","Filter by sprint before closing").option("--filter-release <value>","Filter by release before closing");registerBulkContentAndGovernanceFilters(closeManyCommand,"closing");closeManyCommand.option("--ids <value>","Explicit ID allowlist: comma/newline text, - stdin, or @path file").option("--limit <n>","Limit matched item count before apply/preview").option("--offset <n>","Skip first n matched rows before apply/preview").option("--reason <value>","Shared close reason applied to matched items (required when governance.require_close_reason is enabled)").option("--completed-at <value>","Actual completion timestamp (ISO or relative) applied to every matched item").option("--resolution <value>","Shared closure resolution applied to every matched item (closure-validation field)").option("--expected-result <value>","Shared expected-result note (closure-validation field)").option("--expected <value>","Short alias for --expected-result").option("--actual-result <value>","Shared actual-result note (closure-validation field)").option("--actual <value>","Short alias for --actual-result").option("--validate-close [mode]",'Validate closure metadata per item: "off", "warn", or "strict" (default: settings governance preset)').option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Re-close already-terminal matches and override ownership").option("--dry-run","Preview matched items + per-item skip/active-child plan without mutating").option("--rollback <value>","Rollback a prior close-many checkpoint ID").option("--no-checkpoint","Disable checkpoint creation during apply mode");addHiddenOption(closeManyCommand,"--filter-assignee_filter <value>","Alias for --filter-assignee-filter",false);addHiddenOption(closeManyCommand,"--expected_result <value>","Alias for --expected-result",false);addHiddenOption(closeManyCommand,"--actual_result <value>","Alias for --actual-result",false);closeManyCommand.action(runCloseManyAction);program.command("delete").argument("<id>","Item id").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").option("--dry-run","Preview the item file that would be deleted without mutating").description("Delete an item and record the change in history.").action(runDeleteAction);program.command("append").argument("<id>","Item id").argument("[text]","Body text; same as --body (- reads stdin)").option("--body <value>","Text to append to body (or - for stdin)").option("--text <value>","Alias for --body").option("--author <value>","Mutation author").option("--message <value>","Mutation message").option("--force","Force ownership override").description("Append text to an item's body. For concurrent writes, use pm notes.").action(runAppendAction);const planCommand=program.command("plan").description("Agent-optimized Plan item workflow: create, manage steps, link dependencies, approve, and materialize.").argument("[subcommand]","Required; Plan subcommand: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize").argument("[id]","Plan id (required for non-create subcommands); for create this may be the positional title").argument("[step]","Step reference: stable id (plan-step-001) or order integer").argument("[new-order]","New order integer for reorder-step").option("--title <value>","Plan title").option("--description <value>","Plan description").option("--scope <value>","Short scope statement of the target change or investigation").option("--parent <value>","Parent pm item id").option("--related <value>","Related pm item ids (repeatable, csv-friendly)",collect).option("--blocks <value>","Pm item ids this plan blocks (repeatable, csv-friendly)",collect).option("--blocked-by <value>","Pm item ids that block this plan (repeatable, csv-friendly)",collect).option("--harness <value>","Plan harness provenance: codex|claude-code|cursor|generic").option("--mode <value>","Plan mode: draft|research|review|approved|executing|paused|completed|superseded").option("--resume-context <value>","Compact context summary for a future stateless agent").option("--tags <value>","Comma-separated tags").option("--priority <value>","Priority 0-4").option("--body <value>","Plan item body").option("--claim","Claim the plan on create for the author").option("--from-search <value>","Record the search query that led to plan creation").option("--template <value>","Seed plan steps from a built-in template: bug-investigation|feature-implementation|refactoring-sprint").option("--step-title <value>","Step title for add-step / update-step").option("--step <value>","Step title (repeatable on create: each --step appends an ordered step; elsewhere a single value aliases --step-title)",collect).option("--step-body <value>","Step body text").option("--step-owner <value>","Step owner").option("--step-status <value>","Step status: pending|in_progress|completed|blocked|skipped|superseded").option("--step-evidence <value>","Step evidence text (used by update-step/complete-step)").option("--step-blocked-reason <value>","Step blocked reason (required when blocking)").option("--step-replacement <value>","Replacement reference for a superseded step").option("--depends-on <value>","Pm item ids the step depends on (repeatable, csv-friendly)",collect).option("--link <value>","Pm item id to link (repeatable, csv-friendly)",collect).option("--link-kind <value>",`Link kind: ${PLAN_STEP_LINK_KIND_VALUES.join("|")}`).option("--link-note <value>","Optional note for the link").option("--promote-to-item-dep","Also add the linked id as a top-level item dependency when linking").option("--allow-multiple-active","Allow multiple steps to be in_progress at once").option("--file <value>","Step linked file path=<value>[,scope=project|global,note=<text>] (repeatable)",collect).option("--test <value>","Step linked test command=<value>[,path=<value>,note=<text>] (repeatable)",collect).option("--doc <value>","Step linked doc path=<value>[,scope=project|global,note=<text>] (repeatable)",collect).option("--decision-text <value>","Decision log entry text").option("--decision <value>","Alias for --decision-text").option("--decision-rationale <value>","Decision log entry rationale").option("--decision-evidence <value>","Decision log entry evidence").option("--discovery-text <value>","Discovery log entry text").option("--discovery <value>","Alias for --discovery-text").option("--validation-text <value>","Validation log entry text").option("--validation <value>","Alias for --validation-text").option("--validation-command <value>","Validation log entry command").option("--validation-expected <value>","Validation log entry expected outcome").option("--depth <value>","Show depth: brief|standard|deep (default: brief)").option("--fields <value>","Comma-separated field projection for show output").option("--steps <value>","Comma-separated step ids/orders for materialize").option("--materialize-type <value>","Item type for materialized steps (default: Task)").option("--materialize-parent <value>","Parent item id for materialized children (default: the plan)").option("--materialize-tags <value>","Comma-separated tags for materialized children").option("--field <name=value>","Custom field value forwarded to every materialized child (repeatable)",collect).option("--author <value>","Mutation author").option("--message <value>","Mutation message").option("--force","Force ownership override");registerCommanderOptionContracts(planCommand,CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS.filter(contract=>PLAN_CREATE_METADATA_OPTION_TARGETS.has(contract.target)));addHiddenOptions(planCommand,[["--resume_context <value>","Alias for --resume-context"],["--from_search <value>","Alias for --from-search"],["--step_title <value>","Alias for --step-title"],["--step_body <value>","Alias for --step-body"],["--step_owner <value>","Alias for --step-owner"],["--step_status <value>","Alias for --step-status"],["--step_evidence <value>","Alias for --step-evidence"],["--step_blocked_reason <value>","Alias for --step-blocked-reason"],["--step_replacement <value>","Alias for --step-replacement"],["--link_kind <value>","Alias for --link-kind"],["--link_note <value>","Alias for --link-note"],["--promote_to_item_dep","Alias for --promote-to-item-dep"],["--allow_multiple_active","Alias for --allow-multiple-active"],["--decision_text <value>","Alias for --decision-text"],["--decision_rationale <value>","Alias for --decision-rationale"],["--decision_evidence <value>","Alias for --decision-evidence"],["--discovery_text <value>","Alias for --discovery-text"],["--validation_text <value>","Alias for --validation-text"],["--validation_command <value>","Alias for --validation-command"],["--validation_expected <value>","Alias for --validation-expected"],["--materialize_type <value>","Alias for --materialize-type"],["--materialize_parent <value>","Alias for --materialize-parent"],["--materialize_tags <value>","Alias for --materialize-tags"]],false);addHiddenOptions(planCommand,[["--blocked_by <value>","Alias for --blocked-by"],["--depends_on <value>","Alias for --depends-on"]],true);planCommand.action(runPlanAction);void planCommand;registerHistoryMaintenanceCommands(program,false);registerHistoryAuthorAcknowledgeCommand(program);program.command("merge").argument("<subcommand>",`Merge subcommand: ${MERGE_SUBCOMMAND_VALUES.join(", ")}`).argument("[artifact]",`driver only: artifact class to merge (${MERGE_DRIVER_ARTIFACT_VALUES.join(", ")})`).argument("[base]","driver only: common-ancestor file path (git %O)").argument("[ours]","driver only: current-branch file path (git %A)").argument("[theirs]","driver only: other-branch file path (git %B)").option("--dry-run","install/reconcile: preview changes without writing").option("--message <text>","reconcile only: audit message recorded on repaired history streams").option("--force","reconcile only: permit the underlying audited history ownership override").option("--include-reconciled","report only: include clone-local receipts already recorded in history").option("--output <path>","driver only: write the merged content to this path instead of the ours path").option("--item-path <path>","driver only: original repository-relative path supplied by git as %P").option("--prefer <side>","driver only: side that wins unresolvable conflicts (ours|theirs; default ours)").description("Install merge drivers, reconcile or report post-merge history, or run a field-aware driver.").action(runMergeAction);registerSchemaCommand(program);const profileCommand=program.command("profile").argument("[subcommand]","Required; Profile subcommand: list, show, apply, or lint").argument("[name]","Profile name for show/apply/lint: agile, ops, or research").option("--dry-run","Preview the apply diff without writing any files (apply)").option("--author <value>","Mutation author").option("--force","Force ownership/lock override").description("List, show, apply, and lint project profiles \u2014 archetype bundles of item types, statuses, fields, workflows, config, templates, and recommended packages.");profileCommand.action(runProfileAction);registerAnnotationCommands(program,parsePositiveIntOption);const filesCommand=program.command("files").description("Manage files linked to an item.");filesCommand.argument("<id>","Item id").option("--add <value>","Add linked file entry (CSV/markdown pairs or - for stdin)",collect).option("--add-glob <value>","Add linked file entries from a glob (plain glob or pattern=<glob>,scope=<scope>,note=<text>; repeatable)",collect).option("--remove <value>","Remove linked file by path only (path=<value>, path:<value>, plain path, or - for stdin); does not accept note=/scope= \u2014 record removal context with --message",collect).option("--migrate <value>","Migrate linked file paths in-place (from=<prefix>,to=<prefix>; repeatable)",collect).option("--note <value>","Note attached to every link added by --add/--add-glob in this invocation (embedded note= wins)").option("--list","List linked files without mutating").option("--append-stable","Preserve existing linked-file order and append new links without full-array resorting").option("--validate-paths","Validate linked file paths for existence and file shape").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").action(runFilesAction);filesCommand.command("discover").argument("<id>","Item id").option("--apply","Add discovered missing files to the item").option("--note <value>","Note to attach to discovered file links").option("--append-stable","Preserve existing linked-file order and append discovered links without full-array resorting").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").description("Discover existing file paths referenced in item text and optionally link missing files.").action(runFilesDiscoverAction);registerFilesLookupCommand(filesCommand);program.command("docs").argument("<id>","Item id").option("--add <value>","Add linked doc entry (CSV/markdown pairs or - for stdin)",collect).option("--add-glob <value>","Add linked doc entries from a glob (plain glob or pattern=<glob>,scope=<scope>,note=<text>; repeatable)",collect).option("--remove <value>","Remove linked doc by path only (path=<value>, path:<value>, plain path, or - for stdin); does not accept note=/scope= \u2014 record removal context with --message",collect).option("--migrate <value>","Migrate linked doc paths in-place (from=<prefix>,to=<prefix>; repeatable)",collect).option("--note <value>","Note attached to every link added by --add/--add-glob in this invocation (embedded note= wins)").option("--list","List linked docs without mutating").option("--validate-paths","Validate linked doc paths for existence and file shape").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").description("Manage docs linked to an item.").action(runDocsAction);program.command("deps").argument("<id>","Item id").option("--format <value>","Output format (tree, graph, or context)","tree").option("--max-depth <value>","Maximum dependency traversal depth (0 keeps only the root)").option("--collapse <value>","Collapse mode (none or repeated)","none").option("--summary","Return counts only without full tree/graph payload").option("--full","Return the complete dependency row projection").option("--node-limit <value>","Maximum nodes in context output").option("--edge-limit <value>","Maximum edges and missing-reference rows in context output").option("--token-budget <value>","Maximum estimated tokens in context output").option("--cursor <value>","Continue an equivalent context query").option("--direction <value>","Context traversal direction (outgoing, incoming, or both)").option("--kind <value>","Restrict context traversal to registered relationship kinds (repeatable or comma-separated)",collect).description("Show dependency relationships for an item.").action(runDepsAction)}export{looksLikeSchemaSubcommandTypo,parsePositiveIntOption,parseSchemaOrderOption,registerCommanderOptionContracts,registerMutationCommands};
+`),result.warnings.length>0&&printError(`profile apply warnings: ${formatHookWarnings(result.warnings)}`);break}}function parsePositiveIntOption(flag){return value=>{const parsed=Number(value);if(!Number.isInteger(parsed)||parsed<1)throw new PmCliError(`${flag} must be a positive integer (1-based index).`,EXIT_CODE.USAGE);return parsed}}function registerBulkContentAndGovernanceFilters(command,action){command.option("--filter-has-notes",`Select only items that have notes before ${action}`).option("--filter-no-notes",`Select only items that have no notes before ${action}`).option("--filter-has-learnings",`Select only items that have learnings before ${action}`).option("--filter-no-learnings",`Select only items that have no learnings before ${action}`).option("--filter-has-files",`Select only items that have linked files before ${action}`).option("--filter-no-files",`Select only items that have no linked files before ${action}`).option("--filter-has-docs",`Select only items that have linked docs before ${action}`).option("--filter-no-docs",`Select only items that have no linked docs before ${action}`).option("--filter-has-tests",`Select only items that have linked tests before ${action}`).option("--filter-no-tests",`Select only items that have no linked tests before ${action}`).option("--filter-has-comments",`Select only items that have comments before ${action}`).option("--filter-no-comments",`Select only items that have no comments before ${action}`).option("--filter-has-deps",`Select only items that have dependencies before ${action}`).option("--filter-no-deps",`Select only items that have no dependencies before ${action}`).option("--filter-has-body",`Select only items that have a non-empty body before ${action}`).option("--filter-empty-body",`Select only items with an empty body before ${action}`).option("--filter-has-linked-command",`Select only items whose linked tests carry a runnable command before ${action}`).option("--filter-no-linked-command",`Select only items whose linked tests carry no runnable command before ${action}`).option("--filter-reviewer-missing",`Select only items missing reviewer before ${action}`).option("--filter-risk-missing",`Select only items missing risk before ${action}`).option("--filter-confidence-missing",`Select only items missing confidence before ${action}`).option("--filter-sprint-missing",`Select only items missing sprint before ${action}`).option("--filter-release-missing",`Select only items missing release before ${action}`)}const BULK_CONTENT_FILTER_CONFLICTS=[["filterHasNotes","filterNoNotes","--filter-has-notes","--filter-no-notes"],["filterHasLearnings","filterNoLearnings","--filter-has-learnings","--filter-no-learnings"],["filterHasFiles","filterNoFiles","--filter-has-files","--filter-no-files"],["filterHasDocs","filterNoDocs","--filter-has-docs","--filter-no-docs"],["filterHasTests","filterNoTests","--filter-has-tests","--filter-no-tests"],["filterHasComments","filterNoComments","--filter-has-comments","--filter-no-comments"],["filterHasDeps","filterNoDeps","--filter-has-deps","--filter-no-deps"],["filterHasBody","filterEmptyBody","--filter-has-body","--filter-empty-body"],["filterHasLinkedCommand","filterNoLinkedCommand","--filter-has-linked-command","--filter-no-linked-command"]];function mapBulkContentAndGovernanceFilters(options){const presence=key=>options[key]===!0?!0:void 0;for(const[hasKey,noKey,hasFlag,noFlag]of BULK_CONTENT_FILTER_CONFLICTS)if(options[hasKey]===!0&&options[noKey]===!0)throw new PmCliError(`Cannot combine ${hasFlag} with ${noFlag} for the same field.`,EXIT_CODE.USAGE);return{filterReviewerMissing:presence("filterReviewerMissing"),filterRiskMissing:presence("filterRiskMissing"),filterConfidenceMissing:presence("filterConfidenceMissing"),filterSprintMissing:presence("filterSprintMissing"),filterReleaseMissing:presence("filterReleaseMissing"),hasNotes:presence("filterHasNotes"),hasLearnings:presence("filterHasLearnings"),hasFiles:presence("filterHasFiles"),hasDocs:presence("filterHasDocs"),hasTests:presence("filterHasTests"),hasComments:presence("filterHasComments"),hasDeps:presence("filterHasDeps"),hasBody:presence("filterHasBody"),hasLinkedCommand:presence("filterHasLinkedCommand"),noNotes:presence("filterNoNotes"),noLearnings:presence("filterNoLearnings"),noFiles:presence("filterNoFiles"),noDocs:presence("filterNoDocs"),noTests:presence("filterNoTests"),noComments:presence("filterNoComments"),noDeps:presence("filterNoDeps"),emptyBody:presence("filterEmptyBody"),noLinkedCommand:presence("filterNoLinkedCommand")}}function registerCommanderOptionContracts(command,contracts){for(const contract of contracts){const sharedValues=[];let activeParseArgs=command.args;const repeatableParser=value=>(command.args!==activeParseArgs&&(sharedValues.length=0,activeParseArgs=command.args),sharedValues.push(value),sharedValues);contract.required?command.requiredOption(contract.option,contract.description):contract.repeatable?command.option(contract.option,contract.description,repeatableParser):command.option(contract.option,contract.description);for(const aliasContract of contract.aliasOptions??[])isPureSnakeCaseAlias(contract.option,aliasContract.option)?addHiddenOption(command,aliasContract.option,aliasContract.description,contract.repeatable===!0,contract.repeatable?repeatableParser:void 0):contract.repeatable?command.option(aliasContract.option,aliasContract.description,repeatableParser):command.option(aliasContract.option,aliasContract.description)}}function buildUpdateManyListOptions(options){const readString=key=>typeof options[key]=="string"?options[key]:void 0;return{type:readString("filterType"),tag:readString("filterTag"),priority:readString("filterPriority"),deadlineBefore:readString("filterDeadlineBefore"),deadlineAfter:readString("filterDeadlineAfter"),updatedAfter:readString("filterUpdatedAfter"),updatedBefore:readString("filterUpdatedBefore"),createdAfter:readString("filterCreatedAfter"),createdBefore:readString("filterCreatedBefore"),ids:readString("ids"),assignee:readString("filterAssignee"),assigneeFilter:readString("filterAssigneeFilter")??readString("filterAssignee_filter"),parent:readString("filterParent"),sprint:readString("filterSprint"),release:readString("filterRelease"),filterAcMissing:options.filterAcMissing===!0?!0:void 0,filterEstimatesMissing:options.filterEstimatesMissing===!0||options.filterEstimateMissing===!0?!0:void 0,filterResolutionMissing:options.filterResolutionMissing===!0?!0:void 0,filterMetadataMissing:options.filterMetadataMissing===!0?!0:void 0,...mapBulkContentAndGovernanceFilters(options),limit:readString("limit"),offset:readString("offset"),includeBody:!0}}function pickStringOption(...candidates){for(const candidate of candidates)if(typeof candidate=="string")return candidate}function resolveCreatePositionals(typeOrTitle,secondTitle,options){return typeof secondTitle=="string"&&secondTitle.length>0?{positionalType:typeOrTitle,positionalTitle:secondTitle}:typeof typeOrTitle!="string"||typeOrTitle.length===0?{positionalType:void 0,positionalTitle:void 0}:typeof options.title=="string"&&options.title.trim().length>0&&options.type===void 0?{positionalType:typeOrTitle,positionalTitle:void 0}:{positionalType:void 0,positionalTitle:typeOrTitle}}function assertCreatePositionalTypeHasTitle(positionalType,positionalTitle,options){if(positionalType!==void 0||typeof positionalTitle!="string"||positionalTitle.length===0||options.title!==void 0||options.type!==void 0||!BUILTIN_TYPE_NAME_LOOKUP.has(positionalTitle.trim().toLowerCase()))return;const matchedType=positionalTitle.trim();throw new PmCliError(`pm create needs a title \u2014 "${matchedType}" looks like an item type, not a title. Use either: pm create ${matchedType} "<title>" or pm create "<title>" --type ${matchedType}.`,EXIT_CODE.USAGE,{code:"create_positional_type_without_title",why:'Without this guard the single positional is used as the title and the type defaults to Task \u2014 so the command would silently create a Task literally titled "'+matchedType+'".',examples:[`pm create ${matchedType} "Wire up SSO for the agent harness"`,`pm create "Wire up SSO for the agent harness" --type ${matchedType}`],nextSteps:[`Re-run with both type and title: pm create ${matchedType} "<title>"`]})}const STRUCTURED_STDIN_CONFLICT_KEYS=["body","bodyFile","description","dep","depRemove","comment","note","learning","file","test","doc","reminder","event","typeOption","field","ids"];function assertSingleMutationStdinConsumer(options){const stdinFlags=STRUCTURED_STDIN_CONFLICT_KEYS.flatMap(key=>{const value=options[key],count=typeof value=="string"&&value.trim()==="-"?1:Array.isArray(value)?value.filter(entry=>typeof entry=="string"&&entry.trim()==="-").length:0,flag=`--${key.replace(/[A-Z]/g,letter=>`-${letter.toLowerCase()}`)}`;return Array.from({length:count},()=>flag)});if(options.stdinJson===!0&&stdinFlags.unshift("--stdin-json"),stdinFlags.length>1)throw new PmCliError(`Only one option may consume stdin per command invocation. Found: ${stdinFlags.join(", ")}.`,EXIT_CODE.USAGE)}function preserveResolvedMutationStdinFields(options,bodyFileResolved,descriptionStdinResolved){const fields=[];bodyFileResolved&&fields.push("body"),descriptionStdinResolved&&fields.push("description"),preserveMutationStdinTokenFields(options,fields)}function isDescriptionStdinConsumer(options,stdinJsonConsumed){return!stdinJsonConsumed&&typeof options.description=="string"&&options.description.trim()==="-"}async function runCreateAction(typeOrTitle,secondTitle,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now();assertSingleMutationStdinConsumer(options);const stdinJsonConsumed=options.stdinJson===!0;if(stdinJsonConsumed){const input=await createStdinTokenResolver().resolveValue("-","--stdin-json");options=itemDocumentToMutationOptions(input??"","create",options)}const positionals=resolveCreatePositionals(typeOrTitle,secondTitle,options);assertCreatePositionalTypeHasTitle(positionals.positionalType,positionals.positionalTitle,options),typeof positionals.positionalType=="string"&&positionals.positionalType.length>0&&options.type===void 0&&(options.type=positionals.positionalType),typeof positionals.positionalTitle=="string"&&positionals.positionalTitle.length>0&&options.title===void 0&&(options.title=positionals.positionalTitle);const descriptionStdinResolved=isDescriptionStdinConsumer(options,stdinJsonConsumed);stdinJsonConsumed||await resolveDescriptionStdin(options);const bodyFileResolved=typeof options.bodyFile=="string";bodyFileResolved&&(options.body=await resolveBodyFileContent(String(options.bodyFile),options.body!==void 0?String(options.body):void 0),delete options.bodyFile);const normalized=normalizeCreateOptions(options,{requireType:!1});preserveResolvedMutationStdinFields(normalized,bodyFileResolved,descriptionStdinResolved),stdinJsonConsumed&&preserveMutationStdinTokenLiterals(normalized);const result=await runCreate(normalized,globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=create took_ms=${Date.now()-startedAt}`)}function buildCloseManyListOptions(options){return{type:readOptionString(options,"filterType"),tag:readOptionString(options,"filterTag"),priority:readOptionString(options,"filterPriority"),deadlineBefore:readOptionString(options,"filterDeadlineBefore"),deadlineAfter:readOptionString(options,"filterDeadlineAfter"),updatedAfter:readOptionString(options,"filterUpdatedAfter"),updatedBefore:readOptionString(options,"filterUpdatedBefore"),createdAfter:readOptionString(options,"filterCreatedAfter"),createdBefore:readOptionString(options,"filterCreatedBefore"),ids:readOptionString(options,"ids"),assignee:readOptionString(options,"filterAssignee"),assigneeFilter:pickStringOption(options.filterAssigneeFilter,options.filterAssignee_filter),parent:readOptionString(options,"filterParent"),sprint:readOptionString(options,"filterSprint"),release:readOptionString(options,"filterRelease"),...mapBulkContentAndGovernanceFilters(options),limit:readOptionString(options,"limit"),offset:readOptionString(options,"offset")}}async function runCloseManyAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now();assertSingleMutationStdinConsumer(options),options.ids=await resolveCliBulkIdsInput(readOptionString(options,"ids"));const result=await runCloseMany({status:readOptionString(options,"filterStatus"),list:buildCloseManyListOptions(options),reason:readOptionString(options,"reason"),completedAt:readOptionString(options,"completedAt"),resolution:readOptionString(options,"resolution"),expectedResult:pickStringOption(options.expectedResult,options.expected_result,options.expected),actualResult:pickStringOption(options.actualResult,options.actual_result,options.actual),validateClose:options.validateClose===!0?"warn":readOptionString(options,"validateClose"),author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:!!options.force,dryRun:options.dryRun===!0?!0:void 0,rollback:readOptionString(options,"rollback"),checkpoint:options.checkpoint===!1?!1:void 0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=close-many took_ms=${Date.now()-startedAt}`)}async function runUpdateManyAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now();assertSingleMutationStdinConsumer(options),options.ids=await resolveCliBulkIdsInput(readOptionString(options,"ids"));const result=await runUpdateMany({status:readOptionString(options,"filterStatus"),list:buildUpdateManyListOptions(options),update:normalizeUpdateOptions(extractUpdateManyMutationOptionSource(options)),dryRun:options.dryRun===!0?!0:void 0,rollback:readOptionString(options,"rollback"),checkpoint:options.checkpoint===!1?!1:void 0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(await applyActiveCommandResultService("update-many",[],options,globalOptions,result),globalOptions),globalOptions.profile&&printError(`profile:command=update-many took_ms=${Date.now()-startedAt}`)}async function runCloseAction(id,text,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),reasonFromOption=typeof options.reason=="string"&&options.reason.trim().length>0&&options.reason||typeof options.closeReason=="string"&&options.closeReason.trim().length>0&&options.closeReason||void 0,resolvedText=typeof text=="string"&&text.length>0?text:reasonFromOption,result=await(options.releaseAssignment===!0?runCloseTask:runClose)(id,resolvedText,{author:readOptionString(options,"author"),message:readOptionString(options,"message"),validateClose:options.validateClose===!0?"warn":readOptionString(options,"validateClose"),force:!!options.force,duplicateOf:readOptionString(options,"duplicateOf"),completedAt:readOptionString(options,"completedAt"),resolution:readOptionString(options,"resolution"),expectedResult:pickStringOption(options.expectedResult,options.expected_result,options.expected),actualResult:pickStringOption(options.actualResult,options.actual_result,options.actual)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=close took_ms=${Date.now()-startedAt}`)}function normalizePlanAliases(options){const planOptions={...options},aliasPairs=[["blocked_by","blockedBy"],["resume_context","resumeContext"],["from_search","fromSearch"],["step_title","stepTitle"],["step_body","stepBody"],["step_owner","stepOwner"],["step_status","stepStatus"],["step_evidence","stepEvidence"],["step_blocked_reason","stepBlockedReason"],["step_replacement","stepReplacement"],["depends_on","dependsOn"],["link_kind","linkKind"],["link_note","linkNote"],["promote_to_item_dep","promoteToItemDep"],["allow_multiple_active","allowMultipleActive"],["decision_text","decisionText"],["decision_rationale","decisionRationale"],["decision_evidence","decisionEvidence"],["discovery_text","discoveryText"],["validation_text","validationText"],["validation_command","validationCommand"],["validation_expected","validationExpected"],["materialize_type","materializeType"],["materialize_parent","materializeParent"],["materialize_tags","materializeTags"]];for(const[snake,camel]of aliasPairs)planOptions[snake]!==void 0&&planOptions[camel]===void 0&&(planOptions[camel]=planOptions[snake]);const normalized=normalizeCreateOptions(planOptions,{requireType:!1});return normalized.blockedBy=planOptions.blockedBy,normalized}function assertKnownPlanSubcommand(normalized,allowed){if(!normalized)throw new PmCliError(`pm plan requires a subcommand. Allowed: ${allowed.join(", ")}`,EXIT_CODE.USAGE,{code:"missing_required_argument",examples:['pm plan create --title "Refactor lock retry"',"pm plan show pm-a1b2 --depth standard",'pm plan add-step pm-a1b2 --step-title "Read lock.ts"']});if(!allowed.includes(normalized))throw createUnknownSubcommandError({command_path:"plan",token:normalized,allowed,examples:normalized==="list"||normalized==="ls"?["pm list --type Plan","pm list-all --type Plan"]:void 0,retry_command:normalized==="list"||normalized==="ls"?"pm list --type Plan":void 0})}function parsePlanReorderTo(normalizedSubcommand,reorderToken){if(normalizedSubcommand!=="reorder-step"||typeof reorderToken!="string")return;const parsed=Number.parseInt(reorderToken,10);if(!Number.isFinite(parsed))throw new PmCliError(`reorder-step requires an integer new order, got "${reorderToken}"`,EXIT_CODE.USAGE);return parsed}async function runPlanAction(subcommand,id,stepRef,reorderToken,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),normalizedSubcommand=(subcommand??"").trim().toLowerCase();assertKnownPlanSubcommand(normalizedSubcommand,PLAN_SUBCOMMANDS);const planOptions=normalizePlanAliases(options),reorderTo=parsePlanReorderTo(normalizedSubcommand,reorderToken),planId=normalizedSubcommand==="create"&&typeof id=="string"&&id.length>0&&planOptions.title===void 0?void 0:id;planId===void 0&&typeof id=="string"&&id.length>0&&(planOptions.title=id);const result=await runPlan({subcommand:normalizedSubcommand,id:planId,stepRef,reorderTo,options:planOptions,global:globalOptions});await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=plan took_ms=${Date.now()-startedAt}`)}async function runMergeReconcileSubcommand(artifact,options,globalOptions){if(artifact!==void 0)throw new PmCliError("merge reconcile takes no positional arguments.",EXIT_CODE.USAGE);const result=await runMergeReconcile({dryRun:options.dryRun===!0,force:options.force===!0,message:typeof options.message=="string"?options.message:void 0,author:globalOptions.author},globalOptions);printResult(result,globalOptions),result.ok||(process.exitCode=EXIT_CODE.GENERIC_FAILURE)}async function runMergeDriverSubcommand(artifact,base,ours,theirs,options,globalOptions){if(artifact===void 0||base===void 0||ours===void 0||theirs===void 0)throw new PmCliError("merge driver requires <artifact> <base> <ours> <theirs> (git supplies %O %A %B). Example: pm merge driver history %O %A %B",EXIT_CODE.USAGE);const result=await runMergeDriver({artifact,basePath:base,oursPath:ours,theirsPath:theirs,outputPath:typeof options.output=="string"?options.output:void 0,itemPath:typeof options.itemPath=="string"?options.itemPath:void 0,prefer:typeof options.prefer=="string"?options.prefer:void 0},globalOptions);printResult(result,globalOptions),result.ok||(process.exitCode=EXIT_CODE.GENERIC_FAILURE)}async function runMergeAction(subcommand,artifact,base,ours,theirs,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now();switch(subcommand.trim().toLowerCase()){case"install":{if(artifact!==void 0)throw new PmCliError("merge install takes no positional arguments.",EXIT_CODE.USAGE);const result=await runMergeInstall({dryRun:options.dryRun===!0},globalOptions);printResult(result,globalOptions);break}case"reconcile":await runMergeReconcileSubcommand(artifact,options,globalOptions);break;case"report":{if(artifact!==void 0)throw new PmCliError("merge report takes no positional arguments.",EXIT_CODE.USAGE);const result=await runMergeReceiptEvidenceReport({includeReconciled:options.includeReconciled===!0});printResult(result,globalOptions),result.ok||(process.exitCode=EXIT_CODE.GENERIC_FAILURE);break}case"driver":await runMergeDriverSubcommand(artifact,base,ours,theirs,options,globalOptions);break;default:throw createUnknownSubcommandError({command_path:"merge",token:subcommand,allowed:MERGE_SUBCOMMAND_VALUES,display_name:"merge"})}globalOptions.profile&&printError(`profile:command=merge took_ms=${Date.now()-startedAt}`)}async function runCopyAction(id,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runCopy(id,{title:readOptionString(options,"title"),author:readOptionString(options,"author"),message:readOptionString(options,"message"),allowDuplicate:options.allowDuplicate===!0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=copy took_ms=${Date.now()-startedAt}`)}async function runFocusAction(id,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runFocus(id,{clear:options.clear===!0},globalOptions);printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=focus took_ms=${Date.now()-startedAt}`)}async function runUpdateAction(id,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now();assertSingleMutationStdinConsumer(options);const stdinJsonConsumed=options.stdinJson===!0;if(stdinJsonConsumed){const input=await createStdinTokenResolver().resolveValue("-","--stdin-json");options=itemDocumentToMutationOptions(input??"","update",options)}const descriptionStdinResolved=isDescriptionStdinConsumer(options,stdinJsonConsumed);stdinJsonConsumed||await resolveDescriptionStdin(options);const bodyFileResolved=typeof options.bodyFile=="string";bodyFileResolved&&(options.body=await resolveBodyFileContent(String(options.bodyFile),options.body!==void 0?String(options.body):void 0),delete options.bodyFile);const normalized=normalizeUpdateOptions(options);preserveResolvedMutationStdinFields(normalized,bodyFileResolved,descriptionStdinResolved),stdinJsonConsumed&&preserveMutationStdinTokenLiterals(normalized);const result=await runUpdate(id,normalized,globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(await applyActiveCommandResultService("update",[id],options,globalOptions,result),globalOptions),globalOptions.profile&&printError(`profile:command=update took_ms=${Date.now()-startedAt}`)}async function runDeleteAction(id,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runDelete(id,{author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:!!options.force,dryRun:options.dryRun===!0},globalOptions);result.dry_run!==!0&&await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=delete took_ms=${Date.now()-startedAt}`)}function resolveAppendBody(text,options){const bodyFromOption=readOptionString(options,"body"),bodyFromAlias=readOptionString(options,"text"),bodyFromPositional=typeof text=="string"?text:void 0;if([bodyFromOption,bodyFromAlias,bodyFromPositional].filter(value=>value!==void 0).length>1)throw new PmCliError("Specify append text with exactly one source: positional [text], --body, or --text",EXIT_CODE.USAGE);const resolvedBody=bodyFromOption??bodyFromAlias??bodyFromPositional;if(resolvedBody===void 0)throw new PmCliError("Missing append text. Provide it as positional [text], --body <value>, or --text <value> (use - for stdin).",EXIT_CODE.USAGE);return resolvedBody}async function runAppendAction(id,text,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runAppend(id,{body:resolveAppendBody(text,options),author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:!!options.force},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=append took_ms=${Date.now()-startedAt}`)}async function runProfileAction(subcommand,name,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),{PROFILE_SUBCOMMANDS}=profileModule,normalizedSubcommand=(subcommand??"").trim().toLowerCase();if(!normalizedSubcommand)throw new PmCliError(`pm profile requires a subcommand. Allowed: ${PROFILE_SUBCOMMANDS.join(", ")}`,EXIT_CODE.USAGE,{code:"missing_required_argument",examples:["pm profile list","pm profile show agile","pm profile apply agile --dry-run","pm profile lint agile"]});if(!PROFILE_SUBCOMMANDS.includes(normalizedSubcommand))throw createUnknownSubcommandError({command_path:"profile",token:normalizedSubcommand,allowed:PROFILE_SUBCOMMANDS});const result=await dispatchProfileSubcommand(profileModule,normalizedSubcommand,name,options,globalOptions);globalOptions.json===!0||globalOptions.defaultOutputFormat==="json"?printResult(result,globalOptions):globalOptions.quiet||renderProfileResultHuman(profileModule,result),result.action==="lint"&&!result.ok&&(process.exitCode=EXIT_CODE.GENERIC_FAILURE),globalOptions.profile&&printError(`profile:command=profile took_ms=${Date.now()-startedAt}`)}function readStringArrayOption(options,key){return stringArrayOption(options[key])??[]}async function runFilesAction(id,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),addValues=readStringArrayOption(options,"add"),addGlobValues=readStringArrayOption(options,"addGlob"),removeValues=readStringArrayOption(options,"remove"),migrateValues=readStringArrayOption(options,"migrate"),result=await runFiles(id,{add:addValues,addGlob:addGlobValues,remove:removeValues,migrate:migrateValues,note:readOptionString(options,"note"),list:!!options.list,appendStable:!!options.appendStable,validatePaths:!!options.validatePaths,author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:!!options.force},globalOptions);(addValues.length>0||addGlobValues.length>0||removeValues.length>0||migrateValues.length>0)&&await invalidateSearchCachesForMutation(globalOptions,result),printResult(await applyActiveCommandResultService("files",[id],options,globalOptions,result),globalOptions),globalOptions.profile&&printError(`profile:command=files took_ms=${Date.now()-startedAt}`)}async function runFilesDiscoverAction(id,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),mergedOptions={...command.optsWithGlobals(),...options},result=await runFilesDiscover(id,{apply:!!mergedOptions.apply,note:readOptionString(mergedOptions,"note"),appendStable:!!mergedOptions.appendStable,author:readOptionString(mergedOptions,"author"),message:readOptionString(mergedOptions,"message"),force:!!mergedOptions.force},globalOptions);result.changed&&await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=files.discover took_ms=${Date.now()-startedAt}`)}async function runDocsAction(id,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),addValues=readStringArrayOption(options,"add"),addGlobValues=readStringArrayOption(options,"addGlob"),removeValues=readStringArrayOption(options,"remove"),migrateValues=readStringArrayOption(options,"migrate"),result=await runDocs(id,{add:addValues,addGlob:addGlobValues,remove:removeValues,migrate:migrateValues,note:readOptionString(options,"note"),list:!!options.list,validatePaths:!!options.validatePaths,author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:!!options.force},globalOptions);(addValues.length>0||addGlobValues.length>0||removeValues.length>0||migrateValues.length>0)&&await invalidateSearchCachesForMutation(globalOptions,result),printResult(await applyActiveCommandResultService("docs",[id],options,globalOptions,result),globalOptions),globalOptions.profile&&printError(`profile:command=docs took_ms=${Date.now()-startedAt}`)}async function runDepsAction(id,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runDeps(id,{format:options.format,maxDepth:readOptionString(options,"maxDepth"),collapse:options.collapse,summary:options.summary===!0,full:options.full===!0,nodeLimit:readOptionString(options,"nodeLimit"),edgeLimit:readOptionString(options,"edgeLimit"),tokenBudget:readOptionString(options,"tokenBudget"),cursor:readOptionString(options,"cursor"),direction:readOptionString(options,"direction"),...Array.isArray(options.kind)?{kind:options.kind}:{}},globalOptions);printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=deps took_ms=${Date.now()-startedAt}`)}function registerMutationCommands(program,registrationOptions={}){const createCommand=program.command("create").argument("[type-or-title]",'Item title, or item type when a title follows (e.g. `pm create task "Fix bug"`)').argument("[title]","Item title when the first argument is an item type").description("Create a new project management item.");if(registerCommanderOptionContracts(createCommand,CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS),createCommand.option("--stdin-json","Read a full item JSON document from stdin; explicit flags override document values").option("--body-file <path>","Load body from a file or stdin (-); conflicts with --body").option("--clear-deps","Clear dependency entries").option("--clear-comments","Clear comments").option("--clear-notes","Clear notes").option("--clear-learnings","Clear learnings").option("--clear-files","Clear linked files").option("--clear-tests","Clear linked tests").option("--clear-docs","Clear linked docs").option("--clear-reminders","Clear reminders").option("--clear-events","Clear events").option("--clear-type-options","Clear type options").option("--allow-duplicate","Explicitly create even when strict similarity governance finds likely duplicates").action(runCreateAction),registrationOptions.targetCommandName==="create")return;program.command("copy").argument("<id>","Source item id").option("--title <value>","Optional title override for the copied item").option("--author <value>","Mutation author").option("--message <value>","History message").option("--allow-duplicate","Explicitly copy even when strict similarity governance finds likely duplicates").description("Copy an item into a new item id while resetting lifecycle fields.").action(runCopyAction),program.command("focus").argument("[id]","Item id to focus (omit to show current focus)").option("--clear","Clear the focused item").description("Set/clear/show the session focused item that new items default --parent to.").action(runFocusAction);const updateCommand=program.command("update").argument("<id>","Item id").description("Update item fields and metadata.");registerCommanderOptionContracts(updateCommand,UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS),updateCommand.option("--stdin-json","Read a full item JSON document from stdin; explicit flags override document values").option("--body-file <path>","Load body from a file or stdin (-); conflicts with --body").option("--replace-deps","Atomically replace dependency entries with the provided --dep values").option("--replace-tests","Atomically replace linked test entries with the provided --test values").option("--replace-files","Atomically replace linked file entries with the provided --file values").option("--replace-docs","Atomically replace linked doc entries with the provided --doc values").option("--clear-deps","Clear dependency entries").option("--clear-comments","Clear comments").option("--clear-notes","Clear notes").option("--clear-learnings","Clear learnings").option("--clear-files","Clear linked files").option("--clear-tests","Clear linked tests").option("--clear-docs","Clear linked docs").option("--clear-reminders","Clear reminders").option("--clear-events","Clear events").option("--clear-type-options","Clear type options").option("--force","Force ownership override"),updateCommand.action(runUpdateAction),registerStructuredMutationCommands(program);const updateManyCommand=program.command("update-many").description("Bulk-update matched items with dry-run plans and rollback checkpoints.").option("--filter-status <value>","Filter by status before applying updates").option("--filter-type <value>","Filter by item type before applying updates").option("--filter-tag <value>","Filter by tag before applying updates").option("--filter-priority <value>","Filter by priority before applying updates").option("--filter-deadline-before <value>","Filter by deadline upper bound before applying updates").option("--filter-deadline-after <value>","Filter by deadline lower bound before applying updates").option("--filter-updated-after <value>","Filter by updated_at lower bound before applying updates (ISO/relative)").option("--filter-updated-before <value>","Filter by updated_at upper bound before applying updates (ISO/relative)").option("--filter-created-after <value>","Filter by created_at lower bound before applying updates (ISO/relative)").option("--filter-created-before <value>","Filter by created_at upper bound before applying updates (ISO/relative)").option("--filter-assignee <value>","Filter by assignee before applying updates").option("--filter-assignee-filter <value>","Filter assignee presence: assigned|unassigned before applying updates").option("--filter-parent <value>","Filter by parent item ID before applying updates").option("--filter-sprint <value>","Filter by sprint before applying updates").option("--filter-release <value>","Filter by release before applying updates").option("--filter-ac-missing","Select only items missing acceptance_criteria (bulk backfill)").option("--filter-estimates-missing","Select only items missing estimated_minutes (bulk backfill)").option("--filter-resolution-missing","Select only terminal items missing resolution (bulk backfill)").option("--filter-metadata-missing","Select only items missing any tracked metadata (AC, estimate, or resolution)");registerBulkContentAndGovernanceFilters(updateManyCommand,"applying updates"),updateManyCommand.option("--ids <value>","Explicit ID allowlist: comma/newline text, - stdin, or @path file").option("--limit <n>","Limit matched item count before apply/preview").option("--offset <n>","Skip first n matched rows before apply/preview").option("--dry-run","Preview per-item diffs and checkpoint intent without mutating").option("--rollback <value>","Rollback a prior update-many checkpoint ID").option("--no-checkpoint","Disable checkpoint creation during apply mode").option("--title, -t <value>","Set title").option("--description, -d <value>","Set description").option("--body, -b <value>","Set body (allow empty string)").option("--status, -s <value>","Set status (use close command for closed)").option("--priority, -p <value>","Set priority").option("--type <value>","Set type").option("--tags <value>","Set comma-separated tags (replaces existing). Use --add-tags / --remove-tags to mutate additively.").option("--add-tags <value>","Add tags additively without replacing existing (repeatable; CSV accepted)",collect).option("--remove-tags <value>","Remove tags from the existing list (repeatable; CSV accepted)",collect).option("--deadline <value>","Set deadline (ISO/date string or relative)").option("--estimate, --estimated-minutes <value>","Set estimated minutes").option("--acceptance-criteria <value>","Set acceptance criteria").option("--ac <value>","Alias for --acceptance-criteria").option("--add-ac <value>","Add one semicolon-free acceptance criterion without replacing the existing list (repeatable)",collect).option("--remove-ac <value>","Remove one semicolon-free acceptance criterion by exact text match (repeatable)",collect).option("--definition-of-ready <value>","Set definition of ready").option("--order <value>","Set planning order/rank integer").option("--rank <value>","Alias for --order").option("--goal <value>","Set goal identifier").option("--objective <value>","Set objective identifier").option("--value <value>","Set business value summary").option("--impact <value>","Set business impact summary").option("--outcome <value>","Set expected outcome summary").option("--why-now <value>","Set why-now rationale").option("--assignee <value>","Set assignee").option("--parent <value>","Set parent item ID").option("--reviewer <value>","Set reviewer").option("--risk <value>","Set risk level").option("--confidence <value>","Set confidence level").option("--sprint <value>","Set sprint identifier").option("--release <value>","Set release identifier").option("--blocked-by <value>","Set blocked-by item ID or reason").option("--blocked-reason <value>","Set blocked reason").option("--unblock-note <value>","Set unblock rationale note").option("--reporter <value>","Set issue reporter").option("--severity <value>","Set issue severity").option("--environment <value>","Set issue environment context").option("--repro-steps <value>","Set issue reproduction steps").option("--resolution <value>","Set issue resolution summary").option("--expected-result <value>","Set issue expected behavior").option("--expected <value>","Short alias for --expected-result").option("--actual-result <value>","Set issue observed behavior").option("--actual <value>","Short alias for --actual-result").option("--affected-version <value>","Set affected version identifier").option("--fixed-version <value>","Set fixed version identifier").option("--component <value>","Set issue component ownership").option("--regression [value]","Set regression marker; bare flag means true, or pass true|false|1|0").option("--customer-impact <value>","Set customer impact summary").option("--dep <value>","Add dependency entry id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>",collect).option("--dep-remove <value>","Remove dependency entries by id/kind/author/timestamp signature",collect).option("--replace-deps","Atomically replace dependency entries with provided --dep values").option("--replace-tests","Atomically replace linked tests with provided --test values").option("--replace-files","Atomically replace linked files with provided --file values").option("--replace-docs","Atomically replace linked docs with provided --doc values").option("--comment <value>","Add comment seed author=<value>,created_at=<iso|now>,text=<value>",collect).option("--note <value>","Add note seed author=<value>,created_at=<iso|now>,text=<value>",collect).option("--learning <value>","Add learning seed author=<value>,created_at=<iso|now>,text=<value>",collect).option("--file <value>","Add linked file path=<value>,scope=<project|global>,note=<text>",collect).option("--test <value>","Add linked test command=<value>,path=<value>,scope=<project|global>",collect).option("--doc <value>","Add linked doc path=<value>,scope=<project|global>,note=<text>",collect).option("--reminder <value>","Add reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>",collect).option("--event <value>","Add event entry start=<iso|relative>,end=<iso|relative>,recur_*",collect).option("--type-option <value>","Set type options key=value (repeatable)",collect).option("--unset <field>","Clear scalar metadata field by name (repeatable)",collect).option("--clear-deps","Clear dependency entries").option("--clear-comments","Clear comments").option("--clear-notes","Clear notes").option("--clear-learnings","Clear learnings").option("--clear-files","Clear linked files").option("--clear-tests","Clear linked tests").option("--clear-docs","Clear linked docs").option("--clear-reminders","Clear reminders").option("--clear-events","Clear events").option("--clear-type-options","Clear type options").option("--author <value>","Mutation author").option("--message <value>","Mutation message").option("--force","Force ownership override"),addHiddenOptions(updateManyCommand,[["--filter-assignee_filter <value>","Alias for --filter-assignee-filter"],["--estimated_minutes <value>","Alias for --estimated-minutes"],["--acceptance_criteria <value>","Alias for --acceptance-criteria"],["--definition_of_ready <value>","Alias for --definition-of-ready"],["--why_now <value>","Alias for --why-now"],["--blocked_by <value>","Alias for --blocked-by"],["--blocked_reason <value>","Alias for --blocked-reason"],["--unblock_note <value>","Alias for --unblock-note"],["--repro_steps <value>","Alias for --repro-steps"],["--expected_result <value>","Alias for --expected-result"],["--actual_result <value>","Alias for --actual-result"],["--affected_version <value>","Alias for --affected-version"],["--fixed_version <value>","Alias for --fixed-version"],["--customer_impact <value>","Alias for --customer-impact"],["--filter-estimate-missing","Alias for --filter-estimates-missing"]],!1),addHiddenOptions(updateManyCommand,[["--dep_remove <value>","Alias for --dep-remove"],["--type_option <value>","Alias for --type-option"],["--add_tags <value>","Alias for --add-tags"],["--remove_tags <value>","Alias for --remove-tags"],["--add_ac <value>","Alias for --add-ac"],["--remove_ac <value>","Alias for --remove-ac"]],!0),updateManyCommand.action(runUpdateManyAction);const closeCommand=program.command("close").option("--release-assignment","Release ownership after closure").argument("<id>","Item id").argument("[text]","Close reason text (alias: --reason)").option("-r, --reason <value>","Close reason text (alias for positional <text>)").option("--close-reason <value>","Close reason text (alias for positional <text>)").option("--completed-at <value>","Actual completion timestamp (ISO or relative), distinct from tracker close time").option("-d, --duplicate-of <id>","Close as a duplicate of the canonical item id and auto-fill duplicate closure metadata").option("--author <value>","Mutation author").option("-m, --message <value>","History message").option("--validate-close [mode]",'Validate closure metadata before close: "off", "warn", or "strict" (default: settings governance preset)').option("--resolution <value>","Closure resolution summary (checked by --validate-close strict)").option("--expected-result <value>","Expected outcome for closure validation").option("--expected <value>","Short alias for --expected-result").option("--actual-result <value>","Observed outcome for closure validation").option("--actual <value>","Short alias for --actual-result").option("--force","Force ownership override").description("Close an item. Close reason requirement follows governance.require_close_reason.");addHiddenOption(closeCommand,"--expected_result <value>","Alias for --expected-result",!1),addHiddenOption(closeCommand,"--actual_result <value>","Alias for --actual-result",!1),closeCommand.action(runCloseAction);const closeManyCommand=program.command("close-many").description("Bulk-close matched items with a shared reason and full runClose semantics (dry-run + rollback checkpoint).").option("--filter-status <value>","Filter by status before closing").option("--filter-type <value>","Filter by item type before closing").option("--filter-tag <value>","Filter by tag before closing").option("--filter-priority <value>","Filter by priority before closing").option("--filter-deadline-before <value>","Filter by deadline upper bound before closing").option("--filter-deadline-after <value>","Filter by deadline lower bound before closing").option("--filter-updated-after <value>","Filter by updated_at lower bound before closing (ISO/relative)").option("--filter-updated-before <value>","Filter by updated_at upper bound before closing (ISO/relative)").option("--filter-created-after <value>","Filter by created_at lower bound before closing (ISO/relative)").option("--filter-created-before <value>","Filter by created_at upper bound before closing (ISO/relative)").option("--filter-assignee <value>","Filter by assignee before closing").option("--filter-assignee-filter <value>","Filter assignee presence: assigned|unassigned before closing").option("--filter-parent <value>","Filter by parent item ID before closing").option("--filter-sprint <value>","Filter by sprint before closing").option("--filter-release <value>","Filter by release before closing");registerBulkContentAndGovernanceFilters(closeManyCommand,"closing"),closeManyCommand.option("--ids <value>","Explicit ID allowlist: comma/newline text, - stdin, or @path file").option("--limit <n>","Limit matched item count before apply/preview").option("--offset <n>","Skip first n matched rows before apply/preview").option("--reason <value>","Shared close reason applied to matched items (required when governance.require_close_reason is enabled)").option("--completed-at <value>","Actual completion timestamp (ISO or relative) applied to every matched item").option("--resolution <value>","Shared closure resolution applied to every matched item (closure-validation field)").option("--expected-result <value>","Shared expected-result note (closure-validation field)").option("--expected <value>","Short alias for --expected-result").option("--actual-result <value>","Shared actual-result note (closure-validation field)").option("--actual <value>","Short alias for --actual-result").option("--validate-close [mode]",'Validate closure metadata per item: "off", "warn", or "strict" (default: settings governance preset)').option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Re-close already-terminal matches and override ownership").option("--dry-run","Preview matched items + per-item skip/active-child plan without mutating").option("--rollback <value>","Rollback a prior close-many checkpoint ID").option("--no-checkpoint","Disable checkpoint creation during apply mode"),addHiddenOption(closeManyCommand,"--filter-assignee_filter <value>","Alias for --filter-assignee-filter",!1),addHiddenOption(closeManyCommand,"--expected_result <value>","Alias for --expected-result",!1),addHiddenOption(closeManyCommand,"--actual_result <value>","Alias for --actual-result",!1),closeManyCommand.action(runCloseManyAction),program.command("delete").argument("<id>","Item id").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").option("--dry-run","Preview the item file that would be deleted without mutating").description("Delete an item and record the change in history.").action(runDeleteAction),program.command("append").argument("<id>","Item id").argument("[text]","Body text; same as --body (- reads stdin)").option("--body <value>","Text to append to body (or - for stdin)").option("--text <value>","Alias for --body").option("--author <value>","Mutation author").option("--message <value>","Mutation message").option("--force","Force ownership override").description("Append text to an item's body. For concurrent writes, use pm notes.").action(runAppendAction);const planCommand=program.command("plan").description("Agent-optimized Plan item workflow: create, manage steps, link dependencies, approve, and materialize.").argument("[subcommand]","Required; Plan subcommand: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize").argument("[id]","Plan id (required for non-create subcommands); for create this may be the positional title").argument("[step]","Step reference: stable id (plan-step-001) or order integer").argument("[new-order]","New order integer for reorder-step").option("--title <value>","Plan title").option("--description <value>","Plan description").option("--scope <value>","Short scope statement of the target change or investigation").option("--parent <value>","Parent pm item id").option("--related <value>","Related pm item ids (repeatable, csv-friendly)",collect).option("--blocks <value>","Pm item ids this plan blocks (repeatable, csv-friendly)",collect).option("--blocked-by <value>","Pm item ids that block this plan (repeatable, csv-friendly)",collect).option("--harness <value>","Plan harness provenance: codex|claude-code|cursor|generic").option("--mode <value>","Plan mode: draft|research|review|approved|executing|paused|completed|superseded").option("--resume-context <value>","Compact context summary for a future stateless agent").option("--tags <value>","Comma-separated tags").option("--priority <value>","Priority 0-4").option("--body <value>","Plan item body").option("--claim","Claim the plan on create for the author").option("--from-search <value>","Record the search query that led to plan creation").option("--template <value>","Seed plan steps from a built-in template: bug-investigation|feature-implementation|refactoring-sprint").option("--step-title <value>","Step title for add-step / update-step").option("--step <value>","Step title (repeatable on create: each --step appends an ordered step; elsewhere a single value aliases --step-title)",collect).option("--step-body <value>","Step body text").option("--step-owner <value>","Step owner").option("--step-status <value>","Step status: pending|in_progress|completed|blocked|skipped|superseded").option("--step-evidence <value>","Step evidence text (used by update-step/complete-step)").option("--step-blocked-reason <value>","Step blocked reason (required when blocking)").option("--step-replacement <value>","Replacement reference for a superseded step").option("--depends-on <value>","Pm item ids the step depends on (repeatable, csv-friendly)",collect).option("--link <value>","Pm item id to link (repeatable, csv-friendly)",collect).option("--link-kind <value>",`Link kind: ${PLAN_STEP_LINK_KIND_VALUES.join("|")}`).option("--link-note <value>","Optional note for the link").option("--promote-to-item-dep","Also add the linked id as a top-level item dependency when linking").option("--allow-multiple-active","Allow multiple steps to be in_progress at once").option("--file <value>","Step linked file path=<value>[,scope=project|global,note=<text>] (repeatable)",collect).option("--test <value>","Step linked test command=<value>[,path=<value>,note=<text>] (repeatable)",collect).option("--doc <value>","Step linked doc path=<value>[,scope=project|global,note=<text>] (repeatable)",collect).option("--decision-text <value>","Decision log entry text").option("--decision <value>","Alias for --decision-text").option("--decision-rationale <value>","Decision log entry rationale").option("--decision-evidence <value>","Decision log entry evidence").option("--discovery-text <value>","Discovery log entry text").option("--discovery <value>","Alias for --discovery-text").option("--validation-text <value>","Validation log entry text").option("--validation <value>","Alias for --validation-text").option("--validation-command <value>","Validation log entry command").option("--validation-expected <value>","Validation log entry expected outcome").option("--depth <value>","Show depth: brief|standard|deep (default: brief)").option("--fields <value>","Comma-separated field projection for show output").option("--steps <value>","Comma-separated step ids/orders for materialize").option("--materialize-type <value>","Item type for materialized steps (default: Task)").option("--materialize-parent <value>","Parent item id for materialized children (default: the plan)").option("--materialize-tags <value>","Comma-separated tags for materialized children").option("--field <name=value>","Custom field value forwarded to every materialized child (repeatable)",collect).option("--author <value>","Mutation author").option("--message <value>","Mutation message").option("--force","Force ownership override");registerCommanderOptionContracts(planCommand,CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS.filter(contract=>PLAN_CREATE_METADATA_OPTION_TARGETS.has(contract.target))),addHiddenOptions(planCommand,[["--resume_context <value>","Alias for --resume-context"],["--from_search <value>","Alias for --from-search"],["--step_title <value>","Alias for --step-title"],["--step_body <value>","Alias for --step-body"],["--step_owner <value>","Alias for --step-owner"],["--step_status <value>","Alias for --step-status"],["--step_evidence <value>","Alias for --step-evidence"],["--step_blocked_reason <value>","Alias for --step-blocked-reason"],["--step_replacement <value>","Alias for --step-replacement"],["--link_kind <value>","Alias for --link-kind"],["--link_note <value>","Alias for --link-note"],["--promote_to_item_dep","Alias for --promote-to-item-dep"],["--allow_multiple_active","Alias for --allow-multiple-active"],["--decision_text <value>","Alias for --decision-text"],["--decision_rationale <value>","Alias for --decision-rationale"],["--decision_evidence <value>","Alias for --decision-evidence"],["--discovery_text <value>","Alias for --discovery-text"],["--validation_text <value>","Alias for --validation-text"],["--validation_command <value>","Alias for --validation-command"],["--validation_expected <value>","Alias for --validation-expected"],["--materialize_type <value>","Alias for --materialize-type"],["--materialize_parent <value>","Alias for --materialize-parent"],["--materialize_tags <value>","Alias for --materialize-tags"]],!1),addHiddenOptions(planCommand,[["--blocked_by <value>","Alias for --blocked-by"],["--depends_on <value>","Alias for --depends-on"]],!0),planCommand.action(runPlanAction),registerHistoryMaintenanceCommands(program,!1),registerHistoryAuthorAcknowledgeCommand(program),program.command("merge").argument("<subcommand>",`Merge subcommand: ${MERGE_SUBCOMMAND_VALUES.join(", ")}`).argument("[artifact]",`driver only: artifact class to merge (${MERGE_DRIVER_ARTIFACT_VALUES.join(", ")})`).argument("[base]","driver only: common-ancestor file path (git %O)").argument("[ours]","driver only: current-branch file path (git %A)").argument("[theirs]","driver only: other-branch file path (git %B)").option("--dry-run","install/reconcile: preview changes without writing").option("--message <text>","reconcile only: audit message recorded on repaired history streams").option("--force","reconcile only: permit the underlying audited history ownership override").option("--include-reconciled","report only: include clone-local receipts already recorded in history").option("--output <path>","driver only: write the merged content to this path instead of the ours path").option("--item-path <path>","driver only: original repository-relative path supplied by git as %P").option("--prefer <side>","driver only: side that wins unresolvable conflicts (ours|theirs; default ours)").description("Install merge drivers, reconcile or report post-merge history, or run a field-aware driver.").action(runMergeAction),registerSchemaCommand(program),program.command("profile").argument("[subcommand]","Required; Profile subcommand: list, show, apply, or lint").argument("[name]","Profile name for show/apply/lint: agile, ops, or research").option("--dry-run","Preview the apply diff without writing any files (apply)").option("--author <value>","Mutation author").option("--force","Force ownership/lock override").description("List, show, apply, and lint project profiles \u2014 archetype bundles of item types, statuses, fields, workflows, config, templates, and recommended packages.").action(runProfileAction),registerAnnotationCommands(program,parsePositiveIntOption);const filesCommand=program.command("files").description("Manage files linked to an item.");filesCommand.argument("<id>","Item id").option("--add <value>","Add linked file entry (CSV/markdown pairs or - for stdin)",collect).option("--add-glob <value>","Add linked file entries from a glob (plain glob or pattern=<glob>,scope=<scope>,note=<text>; repeatable)",collect).option("--remove <value>","Remove linked file by path only (path=<value>, path:<value>, plain path, or - for stdin); does not accept note=/scope= \u2014 record removal context with --message",collect).option("--migrate <value>","Migrate linked file paths in-place (from=<prefix>,to=<prefix>; repeatable)",collect).option("--note <value>","Note attached to every link added by --add/--add-glob in this invocation (embedded note= wins)").option("--list","List linked files without mutating").option("--append-stable","Preserve existing linked-file order and append new links without full-array resorting").option("--validate-paths","Validate linked file paths for existence and file shape").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").action(runFilesAction),filesCommand.command("discover").argument("<id>","Item id").option("--apply","Add discovered missing files to the item").option("--note <value>","Note to attach to discovered file links").option("--append-stable","Preserve existing linked-file order and append discovered links without full-array resorting").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").description("Discover existing file paths referenced in item text and optionally link missing files.").action(runFilesDiscoverAction),registerFilesLookupCommand(filesCommand),program.command("docs").argument("<id>","Item id").option("--add <value>","Add linked doc entry (CSV/markdown pairs or - for stdin)",collect).option("--add-glob <value>","Add linked doc entries from a glob (plain glob or pattern=<glob>,scope=<scope>,note=<text>; repeatable)",collect).option("--remove <value>","Remove linked doc by path only (path=<value>, path:<value>, plain path, or - for stdin); does not accept note=/scope= \u2014 record removal context with --message",collect).option("--migrate <value>","Migrate linked doc paths in-place (from=<prefix>,to=<prefix>; repeatable)",collect).option("--note <value>","Note attached to every link added by --add/--add-glob in this invocation (embedded note= wins)").option("--list","List linked docs without mutating").option("--validate-paths","Validate linked doc paths for existence and file shape").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").description("Manage docs linked to an item.").action(runDocsAction),program.command("deps").argument("<id>","Item id").option("--format <value>","Output format (tree, graph, or context)","tree").option("--max-depth <value>","Maximum dependency traversal depth (0 keeps only the root)").option("--collapse <value>","Collapse mode (none or repeated)","none").option("--summary","Return counts only without full tree/graph payload").option("--full","Return the complete dependency row projection").option("--node-limit <value>","Maximum nodes in context output").option("--edge-limit <value>","Maximum edges and missing-reference rows in context output").option("--token-budget <value>","Maximum estimated tokens in context output").option("--cursor <value>","Continue an equivalent context query").option("--direction <value>","Context traversal direction (outgoing, incoming, or both)").option("--kind <value>","Restrict context traversal to registered relationship kinds (repeatable or comma-separated)",collect).description("Show dependency relationships for an item.").action(runDepsAction)}export{looksLikeSchemaSubcommandTypo,parsePositiveIntOption,parseSchemaOrderOption,registerCommanderOptionContracts,registerMutationCommands};
 //# sourceMappingURL=register-mutation.js.map

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]="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};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="83eb6904-cf04-5c83-8281-0b8b8bb04d48")}catch{}})();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(),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===!0){if(options.run!==!0)throw new PmCliError("--background requires --run",EXIT_CODE.USAGE);if(options.acknowledgeLinkedTests===!0)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===!0},globalOptions);printResult(result,globalOptions)}function buildRunTestOptions(options,values){return{add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues,list:!!options.list,run:!!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:!!options.onlyLast,timeout:typeof options.timeout=="string"?options.timeout:void 0,progress:!!options.progress,envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:!!options.sharedHostSafe,pmContext:typeof options.pmContext=="string"?options.pmContext:void 0,overrideLinkedPmContext:!!options.overrideLinkedPmContext,workspaceContext:typeof options.workspaceContext=="string"?options.workspaceContext:void 0,overrideLinkedWorkspaceContext:!!options.overrideLinkedWorkspaceContext,allowUntrustedLinkedTests:!!options.allowUntrustedLinkedTests,acknowledgeLinkedTests:!!options.acknowledgeLinkedTests,failOnContextMismatch:!!options.failOnContextMismatch,failOnSkipped:!!options.failOnSkipped,failOnEmptyTestRun:!!options.failOnEmptyTestRun,requireAssertionsForPm:!!options.requireAssertionsForPm,checkContext:!!options.checkContext,autoPmContext:!!options.autoPmContext,author:typeof options.author=="string"?options.author:void 0,message:typeof options.message=="string"?options.message:void 0,force:!!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);(values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||options.run===!0||values.removeIndexValues.length>0)&&await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),(result.run_results.some(entry=>entry.status==="failed")||result.fail_on_skipped_triggered===!0)&&(process.exitCode=EXIT_CODE.DEPENDENCY_FAILED)}async function runTestCommandAction(id,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),values=collectTestMutationValues(options);validateBackgroundTestOptions(options,values),options.background===!0?await runBackgroundLinkedTests(id,options,globalOptions,values):await runForegroundLinkedTests(id,options,globalOptions,values),globalOptions.profile&&printError(`profile:command=test took_ms=${Date.now()-startedAt}`)}function buildLifecycleMutationOptions(options){const author=readOptionString(options,"author"),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),startedAt=Date.now();if(options.background===!0){const result2=await runStartBackgroundRun({kind:"test-all",commandArgs:buildBackgroundTestAllCommandArgs(options),statusFilter:readOptionString(options,"status"),noExtensions:globalOptions.noExtensions===!0},globalOptions);printResult(result2,globalOptions),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),(result.failed>0||result.fail_on_skipped_triggered===!0)&&(process.exitCode=EXIT_CODE.DEPENDENCY_FAILED),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:!!options.progress,envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:!!options.sharedHostSafe,pmContext:readOptionString(options,"pmContext"),overrideLinkedPmContext:!!options.overrideLinkedPmContext,workspaceContext:readOptionString(options,"workspaceContext"),overrideLinkedWorkspaceContext:!!options.overrideLinkedWorkspaceContext,allowUntrustedLinkedTests:!!options.allowUntrustedLinkedTests,failOnContextMismatch:!!options.failOnContextMismatch,failOnSkipped:!!options.failOnSkipped,failOnEmptyTestRun:!!options.failOnEmptyTestRun,requireAssertionsForPm:!!options.requireAssertionsForPm,checkContext:!!options.checkContext,autoPmContext:!!options.autoPmContext}}async function runTelemetryAction(namespaceOrSubcommand,subcommand,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runTelemetry({subcommand:resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand),limit:readOptionString(options,"limit")},globalOptions);printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=telemetry took_ms=${Date.now()-startedAt}`)}async function runStatsAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),analytics=parseStatsAnalyticsJson(readOptionString(options,"analytics")),result=await runStats(globalOptions,{includeEmpty:options.includeEmpty===!0,storage:options.storage===!0,metadataCoverage:options.metadataCoverage===!0,byAssignee:options.byAssignee===!0,byTag:options.byTag===!0,byPriority:options.byPriority===!0,tagPrefix:readOptionString(options,"tagPrefix"),fieldUtilization:options.fieldUtilization===!0,...analytics});result.recorded_observations?.some(entry=>entry.changed)===!0&&await invalidateSearchCachesForMutation(globalOptions,{ids:result.recorded_observations?.flatMap(entry=>entry.observation.item_id?[entry.observation.item_id]:[])}),printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=stats took_ms=${Date.now()-startedAt}`)}async function runDuplicatesAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),threshold=readOptionString(options,"threshold"),limit=readOptionString(options,"limit"),result=await runDuplicates(globalOptions,{...options.exhaustive===!0?{exhaustive:!0}:{},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),globalOptions.profile&&printError(`profile:command=duplicates took_ms=${Date.now()-startedAt}`)}async function runHealthAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),strictExit=!!options.strictExit||!!options.failOnWarn,result=await runHealth(globalOptions,{strictExit,strictDirectories:!!options.strictDirectories,requireMergeDrivers:!!options.requireMergeDrivers,checkOnly:!!options.checkOnly,checkTelemetry:!!options.checkTelemetry,noRefresh:!!options.noRefresh,refreshVectors:!!options.refreshVectors,verboseStaleItems:!!options.verboseStaleItems,verboseAuthorEvents:!!options.verboseAuthorEvents,brief:!!options.brief,summary:!!options.summary||strictExit,skipVectors:!!options.skipVectors,skipIntegrity:!!options.skipIntegrity,skipDrift:!!options.skipDrift,full:!!options.full});printResult(result,globalOptions),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),globalOptions.profile&&printError(`profile:command=health took_ms=${Date.now()-startedAt}`)}async function runValidateAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runValidate({checkMetadata:!!options.checkMetadata,metadataProfile:readOptionString(options,"metadataProfile"),checkResolution:!!options.checkResolution,checkCompleteness:!!options.checkCompleteness,checkLifecycle:!!options.checkLifecycle,checkStaleBlockers:!!options.checkStaleBlockers,dependencyCycleSeverity:readOptionString(options,"dependencyCycleSeverity"),parentCycleSeverity:readOptionString(options,"parentCycleSeverity"),checkFiles:!!options.checkFiles,checkCommandReferences:!!options.checkCommandReferences,scanMode:readOptionString(options,"scanMode"),includePmInternals:!!options.includePmInternals,verboseFileLists:!!options.verboseFileLists,verboseDiagnostics:!!options.verboseDiagnostics,allAffectedIds:!!options.allAffectedIds,checkHistoryDrift:!!options.checkHistoryDrift,checkStorageIntegrity:!!options.checkStorageIntegrity,fixHints:!!options.fixHints,autoFix:!!options.autoFix,dryRun:!!options.dryRun,fixScope:Array.isArray(options.fixScope)?options.fixScope:void 0,pruneMissing:!!options.pruneMissing,counts:!!options.counts,full:!!options.full},globalOptions);printResult(result,globalOptions),(options.strictExit||options.failOnWarn)&&(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),globalOptions.profile&&printError(`profile:command=validate took_ms=${Date.now()-startedAt}`)}async function runGcAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runGc(globalOptions,{dryRun:options.dryRun===!0,scope:Array.isArray(options.scope)?options.scope:[]});printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=gc took_ms=${Date.now()-startedAt}`)}async function runWorkspaceSnapshotAction(action,target,options,command){const globalOptions=getGlobalOptions(command),pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),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===!0){printResult(await planWorkspaceSnapshotRestore(pmRoot,target),globalOptions);return}const settings=await readSettings(pmRoot);printResult(await restoreWorkspaceSnapshotWithRecovery(pmRoot,target,{force:options.force===!0,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),startedAt=Date.now(),result=await runContracts({action:readOptionString(options,"action"),command:readOptionString(options,"command"),summary:!!options.summary,schemaOnly:!!options.schemaOnly,flagsOnly:!!options.flagsOnly,availabilityOnly:!!options.availabilityOnly,runtimeOnly:!!options.runtimeOnly||!!options.activeOnly,full:!!options.full},globalOptions);printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=contracts took_ms=${Date.now()-startedAt}`)}async function runClaimAction(id,options,command){if(options.start===!0){requireClaimTarget(id,!1),await runStartTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command),startedAt=Date.now(),lifecycleOptions={...buildLifecycleMutationOptions(options),ifAvailable:options.ifAvailable===!0,maxAttempts:options.maxAttempts};requireClaimTarget(id,options.next===!0);const result=options.next===!0?await runClaimNext(!!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===!0,includeGates:options.includeGates===!0,includeContainers:options.includeContainers===!0,tokenBudget:options.tokenBudget??options.token_budget,explainRanking:options.explainRanking===!0||options.explain_ranking===!0}):await runClaim(id,!!options.force,globalOptions,lifecycleOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),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===!0){await runPauseTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runRelease(id,!!options.force,globalOptions,{...buildLifecycleMutationOptions(options),ownershipReleaseBypass:options.ownershipReleaseBypass===!0});await invalidateSearchCachesForMutation(globalOptions,result),printResult(await applyActiveCommandResultService("release",[id],options,globalOptions,result),globalOptions),globalOptions.profile&&printError(`profile:command=release took_ms=${Date.now()-startedAt}`)}async function printLifecycleAliasHint(command){const global2=getGlobalOptions(command),alias=resolvePmCommandAlias(command.name());!alias||global2.json||global2.quiet||(await readSettings(resolvePmRoot(process.cwd(),global2.path))).ux?.deprecation_hints&&printError(renderPmCommandAliasMigrationHint(alias))}async function runStartTaskAction(id,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runStartTask(id,{...buildLifecycleMutationOptions(options),force:!!options.force,next:options.next===!0,ifAvailable:options.ifAvailable===!0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.update),printResult(result,globalOptions),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),startedAt=Date.now(),result=await runPauseTask(id,{...buildLifecycleMutationOptions(options),force:!!options.force},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release),printResult(result,globalOptions),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),startedAt=Date.now(),result=await runCloseTask(id,reason,{...buildLifecycleMutationOptions(options),validateClose:readOptionString(options,"validateClose"),force:!!options.force},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release),printResult(result,globalOptions),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:!0}).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:!0}).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:!0}).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:!0}).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