@unbrained/pm-cli 2026.10.9 → 2026.10.11

package/.claude-plugin/marketplace.json

@@ -1,36 +1 @@
-{
-  "name": "pm",
-  "owner": {
-    "name": "unbrained",
-    "url": "https://github.com/unbraind/pm-cli"
-  },
-  "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
-  "version": "2026.10.9",
-  "plugins": [
-    {
-      "name": "pm-claude",
-      "source": "./plugins/pm-claude",
-      "description": "Native pm CLI integration for Claude Code — 32 MCP tools, 14 workflow skills with slash invocations, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
-      "version": "2026.10.9",
-      "author": {
-        "name": "unbrained",
-        "url": "https://github.com/unbraind/pm-cli"
-      },
-      "homepage": "https://github.com/unbraind/pm-cli",
-      "repository": "https://github.com/unbraind/pm-cli",
-      "license": "MIT",
-      "keywords": [
-        "pm-cli",
-        "project-management",
-        "mcp",
-        "tasks",
-        "agents",
-        "workflows",
-        "git-native",
-        "task-tracker",
-        "ai"
-      ],
-      "category": "productivity"
-    }
-  ]
-}
+{"name":"pm","owner":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"description":"Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.","version":"2026.10.11","plugins":[{"name":"pm-claude","source":"./plugins/pm-claude","description":"Native pm CLI integration for Claude Code — 32 MCP tools, 14 workflow skills with slash invocations, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.","version":"2026.10.11","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","project-management","mcp","tasks","agents","workflows","git-native","task-tracker","ai"],"category":"productivity"}]}

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 2026.10.11 - 2026-10-11
+
+### Fixed
+
+- Reconcile complete release ledgers with exact historical dispositions ([pm-q91qyd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-q91qyd.toon))
+- Keep installed-release init within its unchanged raw budget on macOS ([pm-release-acceptance-path-cost](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-release-acceptance-path-cost.toon))
+
+### Other
+
+- Refresh aged Unicorn 77 alongside ESLint 10.12 without changing strict lint policy ([pm-unicorn-77](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-unicorn-77.toon))
+- Reconcile release ledgers and tag origins with bounded publication and acceptance ([pm-release-ledger-origin-delivery](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/changesets/pm-release-ledger-origin-delivery.toon))
+- Refresh eligible ESLint 10.12 for release quality gates ([pm-eslint-1012](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-eslint-1012.toon))
+
+## 2026.10.10 - 2026-10-10
+
+### Added
+
+- Add SDK reliability windows and preserve nightly and release-origin recurrence ([pm-reliability-window-delivery](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/changesets/pm-reliability-window-delivery.toon))
+- Cross-version workspace compatibility matrix: prove that workspaces written by older and newer pm releases stay readable and mergeable ([pm-pae3wo](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-pae3wo.toon))
+
+### Changed
+
+- Refresh eligible Node type and Greptile release-review tooling patches ([pm-release-devtool-patches](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-release-devtool-patches.toon))
+
+### Fixed
+
+- Platform nightly legs fail on half of all days and nothing measures the rate: each alert opens a fresh issue and closes on repair, so a 28-occurrence family reads as 28 first occurrences ([pm-2zjs0g](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-2zjs0g.toon))
+- Full-item stdin JSON must preserve declared schema and extension custom fields ([pm-stdin-schema-fields](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-stdin-schema-fields.toon))
+- Agent-task token ratchet changes verdict with temporary-root path length ([pm-agent-token-path](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-agent-token-path.toon))
+- Exact-tag recovery must preserve the complete reviewed release-control import closure ([pm-gh1429](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1429.toon))
+- Installed-agent acceptance must recover infeasible context budgets and retain structured refusal diagnostics ([pm-gh1428](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1428.toon))
+
 ## 2026.10.9 - 2026-10-09
 
 ### Added
@@ -104,10 +136,6 @@
 - GH-1368: Agent UX: context next silently ignores inherited --fields and --depth options, including invalid values ([pm-gh1368](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1368.toon))
 - GH-1367: Agent UX: context handoff omission receipts suggest depth flags that do not restore omitted sections ([pm-gh1367](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1367.toon))
 
-### Other
-
-- Published artifact weight: the npm tarball ships 20MB of inline-source sourcemaps plus duplicate tsc and bundle outputs ([pm-998juj](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-998juj.toon))
-
 ## 2026.10.3 - 2026-10-03
 
 ### Security

package/dist/cli/register-mutation.js

@@ -1,6 +1,6 @@
-(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)}
+(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]="d5fac06e-2565-5bed-b1f3-9c204099537a")}catch{}})();import{resolveBodyFileContent,resolveCliBulkIdsInput,EXIT_CODE,PmCliError,createUnknownSubcommandError,readSettings,resolvePmRoot,resolveRuntimeFieldRegistry}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)}
-`),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};
+`),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 readItemDocumentOptions(input,mode,options,globalOptions){const settings=await readSettings(resolvePmRoot(process.cwd(),globalOptions.path));return itemDocumentToMutationOptions(input,mode,options,resolveRuntimeFieldRegistry(settings.schema).definitions)}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=await readItemDocumentOptions(input??"","create",options,globalOptions)}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=await readItemDocumentOptions(input??"","update",options,globalOptions)}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