@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/lifecycle/update.js

@@ -1,3 +1,3 @@
-(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]="9ee587b5-5aa8-5d10-89d7-acc4a5edb53f")}catch{}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{resolveMutationStdinTokenFields}from"../../core/item/parse.js";import{COMMON_MUTATION_COMMAND_OPTION_KEYS,canonicalizeCommandOptionKey,commandOptionFlagLabel,resolveItemTypeRegistry,resolveCommandOptionPolicyState,resolveTypeDefinition,resolveTypeName,validateTypeOptions,normalizeItemId,toItemRecord,buildInvalidTypeError,assertParentReferenceIsNotSelf,normalizeParentReferenceValue,validateMissingParentReference,validateSprintOrReleaseValue,applyAcceptanceCriteriaMutations,applyTagRemovals,assertNoUnknownCsvKeys,looksLikeGenericKeyValueEntry,mergeAdditiveTags,parseCsvKv,parseOptionalNonNegativeInteger,parseOptionalNumber,parseTags,shouldResolveMutationStdinTokens,transferMutationStdinTokenPolicy,splitAcceptanceCriteria,resolvePriority,normalizeStatusInput,isTerminalStatus,collectRuntimeUpdateFieldValues,resolveItemTypesFilePath,resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry,describeAllowedTransitions,evaluateTransition,resolveTypeWorkflows,EXIT_CODE,PmCliError,stableValueEquals,resolveIsoOrRelative,getActiveExtensionRegistrations,collectRegisteredItemFieldNames,applyRegisteredItemFieldDefaultsAndValidation,parseRegisteredItemFieldAssignments,buildItemNotFoundError,listAllItemMetadataLight,locateItem,readLocatedItem,resolvePmRoot,readSettings,resolveAuthor}from"../runtime-primitives.js";import{mutateItemWithHistoryContextResolver}from"../../core/store/item-store.js";import{runClose}from"./close.js";import{normalizeRiskInput,normalizeSeverityInput,parseConfidenceInput,parseRegressionInput}from"./metadata-normalizers.js";import{applyLegacyNoneCollectionNormalizers,createLegacyNoneCollectionNormalizers,assertNoLegacyNoneToken,assertNoLegacyNoneTokens,isLegacyNoneToken}from"./legacy-none-tokens.js";import{ensureEnumValue as ensureEnum}from"./recurrence-parsers.js";import{parseEventEntries,parseReminderEntries,parseTypeOptionEntries}from"./repeatable-metadata-parsers.js";import{assertDependencyEdgesAllowed,assertDependencyTargetsResolvable,assertValidBareDependencyFlagValue}from"../dependency-flag-validation.js";import{normalizeDependencySeedId,normalizeItemReference,isExternalDependencyReference,normalizeDependencySourceKind}from"../dependency-provenance.js";import{resolveCanonicalRelationshipKind}from"../relationships.js";import{collectNewOrderingCycleWarnings}from"../graph/mutation-advisory.js";import{assertHierarchyMutationAllowed}from"../graph/hierarchy-integrity.js";import{resolveWorkspaceRelationshipKindRegistry}from"../graph/assembly.js";import{acquireHierarchyMutationLock}from"./hierarchy-mutation-lock.js";import{DEPENDENCY_KIND_VALUES,ISSUE_SEVERITY_VALUES,RISK_VALUES}from"../../types/index.js";import{parseDocs,parseFiles,parseLogSeed,parseTests,requireStringOption}from"./create.js";import{attachLinkedTestMutationProvenance}from"../test/trust.js";import{COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,parseCommandUnsetTargets,resolveRuntimeUnsetFieldDefinition}from"./shared-unset-fields.js";const UPDATE_UNSET_FIELD_DEFINITIONS=[...COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,{canonical:"close-reason",aliases:["close_reason","close-reason"],optionKey:"closeReason",metadataKey:"close_reason"},...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR,...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR],UPDATE_UNSET_ALIAS_MAP=(()=>{const map=new Map;for(const definition of UPDATE_UNSET_FIELD_DEFINITIONS)for(const alias of definition.aliases)map.set(alias,{optionKey:definition.optionKey,metadataKey:definition.metadataKey});return map})(),UPDATE_OPTION_KEY_TO_UNSET_CANONICAL=new Map(UPDATE_UNSET_FIELD_DEFINITIONS.map(definition=>[definition.optionKey,definition.canonical])),UPDATE_UNSET_SUPPORTED_CANONICAL_FIELDS=UPDATE_UNSET_FIELD_DEFINITIONS.map(definition=>definition.canonical).sort((left,right)=>left.localeCompare(right)).join(", "),OWNERSHIP_BYPASS_DISALLOWED_UNSET_ITEM_METADATA_KEYS=new Set(["close_reason","assignee","parent","blocked_by","blocked_reason","unblock_note","dependencies","comments","notes","learnings","files","tests","docs","reminders","events"]),UPDATE_LEGACY_NONE_COLLECTION_NORMALIZERS=createLegacyNoneCollectionNormalizers({depDisableFlagKey:"replaceDeps",fileDisableFlagKey:"replaceFiles",testDisableFlagKey:"replaceTests",docDisableFlagKey:"replaceDocs"});function normalizeLegacyNoneUpdateOptions(options){const normalized={...options,unset:options.unset?[...options.unset]:void 0},appendUnsetTarget=value=>{const current=normalized.unset?[...normalized.unset]:[];current.includes(value)||current.push(value),normalized.unset=current},scalarOptionKeys=new Set([...UPDATE_OPTION_KEY_TO_UNSET_CANONICAL.keys(),"rank"]);for(const optionKey of scalarOptionKeys){const candidate=normalized[optionKey];if(typeof candidate!="string"||!isLegacyNoneToken(candidate))continue;const canonicalUnset=optionKey==="rank"?"order":UPDATE_OPTION_KEY_TO_UNSET_CANONICAL.get(optionKey)??optionKey;appendUnsetTarget(canonicalUnset),normalized[optionKey]=void 0}return transferMutationStdinTokenPolicy(options,applyLegacyNoneCollectionNormalizers(normalized,UPDATE_LEGACY_NONE_COLLECTION_NORMALIZERS))}function parseUpdateUnsetTargets(raw,runtimeFieldRegistry,extensionFieldNames=[]){return parseCommandUnsetTargets({raw,supportedFields:UPDATE_UNSET_SUPPORTED_CANONICAL_FIELDS,resolveDefinition:trimmed=>{const extensionFieldName=extensionFieldNames.find(fieldName=>{const normalizedFieldName=fieldName.toLowerCase();return normalizedFieldName===trimmed||normalizedFieldName.replaceAll("_","-")===trimmed||normalizedFieldName.replaceAll("-","_")===trimmed});return UPDATE_UNSET_ALIAS_MAP.get(trimmed)??resolveRuntimeUnsetFieldDefinition(trimmed,"update",runtimeFieldRegistry)??(extensionFieldName?{optionKey:"field",metadataKey:extensionFieldName}:void 0)}})}const OWNERSHIP_BYPASS_RESTRICTED_FLAG_REPLACEMENTS=new Map([["--comment",id=>`pm comments ${id} --add "<text>" --force`],["--file",id=>`pm files ${id} --add "path=<path>,scope=<scope>,note=<note>" --force`],["--doc",id=>`pm docs ${id} --add "path=<path>,scope=<scope>,note=<note>" --force`]]);function buildOwnershipBypassRestrictedOptionsError(params){const replacementCommands=params.disallowedFlags.flatMap(flag=>{const replacement=OWNERSHIP_BYPASS_RESTRICTED_FLAG_REPLACEMENTS.get(flag);return replacement?[replacement(params.id)]:[]}),replacementSteps=params.disallowedFlags.flatMap(flag=>{const replacement=OWNERSHIP_BYPASS_RESTRICTED_FLAG_REPLACEMENTS.get(flag);return replacement?[`Replace ${flag} with: ${replacement(params.id)}`]:[]});return new PmCliError(params.message,EXIT_CODE.USAGE,{code:params.code,required:params.required,why:params.why,...replacementCommands.length>0?{examples:replacementCommands}:{},nextSteps:[`Re-run without: ${params.disallowedFlags.join(", ")}`,...replacementSteps]})}function enforceOwnershipBypassScope(id,options,clearItemMetadataKeys){const ownershipMetadataBypass=options.ownershipMetadataBypass===!0,ownershipDependencyBypass=options.ownershipDependencyBypass===!0;if(!ownershipMetadataBypass&&!ownershipDependencyBypass)return;if(ownershipMetadataBypass&&ownershipDependencyBypass)throw new PmCliError("Choose only one package-provided ownership bypass mode.",EXIT_CODE.USAGE);const pushIf=(condition,flag,list)=>{condition&&list.push(flag)};if(ownershipDependencyBypass){const disallowedFlags2=[];if(pushIf(options.title!==void 0,"--title",disallowedFlags2),pushIf(options.description!==void 0,"--description",disallowedFlags2),pushIf(options.body!==void 0,"--body",disallowedFlags2),pushIf(options.status!==void 0,"--status",disallowedFlags2),pushIf(options.closeReason!==void 0,"--close-reason",disallowedFlags2),pushIf(options.priority!==void 0,"--priority",disallowedFlags2),pushIf(options.type!==void 0,"--type",disallowedFlags2),pushIf(options.tags!==void 0,"--tags",disallowedFlags2),pushIf(Array.isArray(options.addTags)&&options.addTags.length>0,"--add-tags",disallowedFlags2),pushIf(Array.isArray(options.removeTags)&&options.removeTags.length>0,"--remove-tags",disallowedFlags2),pushIf(options.deadline!==void 0,"--deadline",disallowedFlags2),pushIf(options.estimatedMinutes!==void 0,"--estimate",disallowedFlags2),pushIf(options.acceptanceCriteria!==void 0,"--acceptance-criteria",disallowedFlags2),pushIf(Array.isArray(options.addAc)&&options.addAc.length>0,"--add-ac",disallowedFlags2),pushIf(Array.isArray(options.removeAc)&&options.removeAc.length>0,"--remove-ac",disallowedFlags2),pushIf(options.definitionOfReady!==void 0,"--definition-of-ready",disallowedFlags2),pushIf(options.order!==void 0||options.rank!==void 0,"--order/--rank",disallowedFlags2),pushIf(options.goal!==void 0,"--goal",disallowedFlags2),pushIf(options.objective!==void 0,"--objective",disallowedFlags2),pushIf(options.value!==void 0,"--value",disallowedFlags2),pushIf(options.impact!==void 0,"--impact",disallowedFlags2),pushIf(options.outcome!==void 0,"--outcome",disallowedFlags2),pushIf(options.whyNow!==void 0,"--why-now",disallowedFlags2),pushIf(options.assignee!==void 0,"--assignee",disallowedFlags2),pushIf(options.parent!==void 0,"--parent",disallowedFlags2),pushIf(options.reviewer!==void 0,"--reviewer",disallowedFlags2),pushIf(options.risk!==void 0,"--risk",disallowedFlags2),pushIf(options.confidence!==void 0,"--confidence",disallowedFlags2),pushIf(options.sprint!==void 0,"--sprint",disallowedFlags2),pushIf(options.release!==void 0,"--release",disallowedFlags2),pushIf(options.blockedBy!==void 0,"--blocked-by",disallowedFlags2),pushIf(options.blockedReason!==void 0,"--blocked-reason",disallowedFlags2),pushIf(options.unblockNote!==void 0,"--unblock-note",disallowedFlags2),pushIf(options.reporter!==void 0,"--reporter",disallowedFlags2),pushIf(options.severity!==void 0,"--severity",disallowedFlags2),pushIf(options.environment!==void 0,"--environment",disallowedFlags2),pushIf(options.reproSteps!==void 0,"--repro-steps",disallowedFlags2),pushIf(options.resolution!==void 0,"--resolution",disallowedFlags2),pushIf(options.expectedResult!==void 0,"--expected-result",disallowedFlags2),pushIf(options.actualResult!==void 0,"--actual-result",disallowedFlags2),pushIf(options.affectedVersion!==void 0,"--affected-version",disallowedFlags2),pushIf(options.fixedVersion!==void 0,"--fixed-version",disallowedFlags2),pushIf(options.component!==void 0,"--component",disallowedFlags2),pushIf(options.regression!==void 0,"--regression",disallowedFlags2),pushIf(options.customerImpact!==void 0,"--customer-impact",disallowedFlags2),pushIf(options.depRemove!==void 0,"--dep-remove",disallowedFlags2),pushIf(options.replaceDeps===!0,"--replace-deps",disallowedFlags2),pushIf(options.replaceTests===!0,"--replace-tests",disallowedFlags2),pushIf(options.replaceFiles===!0,"--replace-files",disallowedFlags2),pushIf(options.replaceDocs===!0,"--replace-docs",disallowedFlags2),pushIf(options.comment!==void 0,"--comment",disallowedFlags2),pushIf(options.note!==void 0,"--note",disallowedFlags2),pushIf(options.learning!==void 0,"--learning",disallowedFlags2),pushIf(options.file!==void 0,"--file",disallowedFlags2),pushIf(options.test!==void 0,"--test",disallowedFlags2),pushIf(options.doc!==void 0,"--doc",disallowedFlags2),pushIf(options.reminder!==void 0,"--reminder",disallowedFlags2),pushIf(options.event!==void 0,"--event",disallowedFlags2),pushIf(options.typeOption!==void 0,"--type-option",disallowedFlags2),pushIf(options.clearDeps===!0,"--clear-deps",disallowedFlags2),pushIf(options.clearComments===!0,"--clear-comments",disallowedFlags2),pushIf(options.clearNotes===!0,"--clear-notes",disallowedFlags2),pushIf(options.clearLearnings===!0,"--clear-learnings",disallowedFlags2),pushIf(options.clearFiles===!0,"--clear-files",disallowedFlags2),pushIf(options.clearTests===!0,"--clear-tests",disallowedFlags2),pushIf(options.clearDocs===!0,"--clear-docs",disallowedFlags2),pushIf(options.clearReminders===!0,"--clear-reminders",disallowedFlags2),pushIf(options.clearEvents===!0,"--clear-events",disallowedFlags2),pushIf(options.clearTypeOptions===!0,"--clear-type-options",disallowedFlags2),pushIf(options.force===!0,"--force",disallowedFlags2),pushIf(clearItemMetadataKeys.size>0,"--unset",disallowedFlags2),options.dep===void 0||options.dep.length===0)throw new PmCliError("The dependency ownership bypass requires at least one --dep value",EXIT_CODE.USAGE);if(disallowedFlags2.length>0)throw buildOwnershipBypassRestrictedOptionsError({id,code:"ownership_dependency_bypass_restricted_options",message:`The dependency ownership bypass supports append-only dependency additions via --dep. Remove restricted options: ${disallowedFlags2.join(", ")}`,required:"Pass only --dep additions (plus --message/--author) with the dependency ownership bypass.",why:"the dependency ownership bypass is a narrow non-owner override scoped to append-only dependency additions; every other mutation keeps its normal ownership rules.",disallowedFlags:disallowedFlags2});return}const disallowedFlags=[];pushIf(options.status!==void 0,"--status",disallowedFlags),pushIf(options.closeReason!==void 0,"--close-reason",disallowedFlags),pushIf(options.assignee!==void 0,"--assignee",disallowedFlags),pushIf(options.parent!==void 0,"--parent",disallowedFlags),pushIf(options.blockedBy!==void 0,"--blocked-by",disallowedFlags),pushIf(options.blockedReason!==void 0,"--blocked-reason",disallowedFlags),pushIf(options.unblockNote!==void 0,"--unblock-note",disallowedFlags),pushIf(options.dep!==void 0,"--dep",disallowedFlags),pushIf(options.depRemove!==void 0,"--dep-remove",disallowedFlags),pushIf(options.replaceDeps===!0,"--replace-deps",disallowedFlags),pushIf(options.replaceTests===!0,"--replace-tests",disallowedFlags),pushIf(options.replaceFiles===!0,"--replace-files",disallowedFlags),pushIf(options.replaceDocs===!0,"--replace-docs",disallowedFlags),pushIf(options.note!==void 0,"--note",disallowedFlags),pushIf(options.learning!==void 0,"--learning",disallowedFlags),pushIf(options.test!==void 0,"--test",disallowedFlags),pushIf(options.reminder!==void 0,"--reminder",disallowedFlags),pushIf(options.event!==void 0,"--event",disallowedFlags),pushIf(options.clearDeps===!0,"--clear-deps",disallowedFlags),pushIf(options.clearComments===!0,"--clear-comments",disallowedFlags),pushIf(options.clearNotes===!0,"--clear-notes",disallowedFlags),pushIf(options.clearLearnings===!0,"--clear-learnings",disallowedFlags),pushIf(options.clearFiles===!0,"--clear-files",disallowedFlags),pushIf(options.clearTests===!0,"--clear-tests",disallowedFlags),pushIf(options.clearDocs===!0,"--clear-docs",disallowedFlags),pushIf(options.clearReminders===!0,"--clear-reminders",disallowedFlags),pushIf(options.clearEvents===!0,"--clear-events",disallowedFlags);const disallowedUnset=[...clearItemMetadataKeys].filter(field=>OWNERSHIP_BYPASS_DISALLOWED_UNSET_ITEM_METADATA_KEYS.has(field)).sort((left,right)=>left.localeCompare(right)).map(field=>`--unset ${field.replaceAll("_","-")}`);if(disallowedFlags.push(...disallowedUnset),disallowedFlags.length>0)throw buildOwnershipBypassRestrictedOptionsError({id,code:"ownership_metadata_bypass_restricted_options",message:`The metadata ownership bypass only supports non-lifecycle metadata fields and evidence appends. Remove restricted options: ${disallowedFlags.join(", ")}`,required:"Limit the metadata ownership bypass to non-lifecycle metadata fields plus append-only --comment/--file/--doc evidence; route restricted appends and lifecycle changes through their dedicated commands.",why:"the metadata ownership bypass is a non-owner override scoped to metadata maintenance and append-only evidence; lifecycle, ownership, dependency mutations, restricted append fields, and clear/replace operations keep their normal ownership rules.",disallowedFlags})}function parseStatus(value,statusRegistry){const normalized=normalizeStatusInput(value,statusRegistry);if(!normalized){const allowedStatuses=statusRegistry.definitions.map(definition=>definition.id);throw new PmCliError(`Invalid --status value "${value}". Allowed: ${allowedStatuses.join(", ")}`,EXIT_CODE.USAGE)}return normalized}function enforceTypeWorkflowTransition(params){if(params.enforcement==="off"||params.typeWorkflows.length===0)return;const result=evaluateTransition({typeName:params.typeName,fromStatus:params.fromStatus,toStatus:params.toStatus,typeWorkflows:params.typeWorkflows,statusRegistry:params.statusRegistry});if(!result.hasRule||result.allowed)return;const normalizedFrom=normalizeStatusInput(params.fromStatus,params.statusRegistry)??params.fromStatus,normalizedTo=normalizeStatusInput(params.toStatus,params.statusRegistry)??params.toStatus,message=`Disallowed transition for type "${params.typeName}": ${normalizedFrom} -> ${normalizedTo}. Allowed transitions: ${describeAllowedTransitions(result.allowedTransitions)}.`;if(params.enforcement==="strict")throw new PmCliError(message,EXIT_CODE.USAGE);return`workflow_transition_not_allowed: ${message}`}function parseDependencyCreatedAt(value,currentIso){return!value||value.trim()===""||value.trim().toLowerCase()==="now"?currentIso:normalizeDependencyTimestamp(value)}function normalizeDependencyTimestamp(value){const parsed=Date.parse(value);if(!Number.isFinite(parsed))throw new PmCliError(`Invalid dependency created_at timestamp "${value}"`,EXIT_CODE.USAGE);return new Date(parsed).toISOString()}function parseOptionalDependencyString(value){if(value===void 0)return;const trimmed=value.trim();return trimmed.length>0?trimmed:void 0}const DEP_ADDITION_KEYS=["id","kind","type","author","created_at","source_kind"],DEP_REMOVE_KEYS=["id","kind","type","author","created_at","source_kind"];function looksLikeStructuredDependencyEntry(raw){return raw.startsWith("```")||raw.includes(`
-`)||/^(?:[-*+]\s+)?(?:id|kind|type|author|created_at|source_kind)\s*[:=]/i.test(raw)?!0:looksLikeGenericKeyValueEntry(raw)}function normalizeDependencyKindInput(raw){return typeof raw=="string"?resolveCanonicalRelationshipKind(raw)??raw.trim():raw}function parseDependencyAdditions(raw,prefix,nowIso,fallbackAuthor){return raw?(assertNoLegacyNoneTokens(raw,"--dep","Use --clear-deps to clear dependencies."),{additions:raw.map(entry=>{const trimmedEntry=entry.trim(),isStructured=looksLikeStructuredDependencyEntry(trimmedEntry);assertValidBareDependencyFlagValue(trimmedEntry,isStructured);const kv=isStructured?parseCsvKv(entry,"--dep"):{id:trimmedEntry,kind:"related"};isStructured&&assertNoUnknownCsvKeys(kv,"--dep",DEP_ADDITION_KEYS);const id=kv.id?.trim(),kind=normalizeDependencyKindInput((kv.kind??kv.type)?.trim());if(!id||!kind)throw new PmCliError("--dep requires id and kind, or a bare item id to add a related dependency",EXIT_CODE.USAGE);if(id.toLowerCase()==="undefined")throw new PmCliError(`--dep id must not use placeholder token "${id}". Use --clear-deps to clear dependencies.`,EXIT_CODE.USAGE);const sourceKind=normalizeDependencySourceKind(parseOptionalDependencyString(kv.source_kind)),explicitAuthor=parseOptionalDependencyString(kv.author);return{id:normalizeDependencySeedId(id,prefix,sourceKind),kind:ensureEnum(kind,DEPENDENCY_KIND_VALUES,"dependency kind","kind"),created_at:parseDependencyCreatedAt(kv.created_at,nowIso),author:explicitAuthor??fallbackAuthor,source_kind:sourceKind??"cli:update:dep",author_source:explicitAuthor?"asserted":"detected"}})}):{additions:[]}}function parseDependencyRemovals(raw,prefix){return raw?(assertNoLegacyNoneTokens(raw,"--dep-remove"),raw.map(entry=>{const trimmed=entry.trim();if(!trimmed)throw new PmCliError("--dep-remove requires id or key/value selectors",EXIT_CODE.USAGE);const isStructured=looksLikeStructuredDependencyEntry(trimmed);if(assertValidBareDependencyFlagValue(trimmed,isStructured,"--dep-remove"),isStructured){const kv=parseCsvKv(trimmed,"--dep-remove");assertNoUnknownCsvKeys(kv,"--dep-remove",DEP_REMOVE_KEYS);const idRaw=kv.id?.trim();if(!idRaw)throw new PmCliError("--dep-remove key/value form requires id=<value>",EXIT_CODE.USAGE);if(idRaw.toLowerCase()==="undefined")throw new PmCliError(`--dep-remove id must not use placeholder token "${idRaw}"`,EXIT_CODE.USAGE);const kindRaw=normalizeDependencyKindInput(parseOptionalDependencyString(kv.kind??kv.type)),sourceKind=normalizeDependencySourceKind(parseOptionalDependencyString(kv.source_kind)),author=parseOptionalDependencyString(kv.author),createdAt=parseOptionalDependencyString(kv.created_at);return{id:normalizeDependencySeedId(idRaw,prefix,sourceKind),kind:kindRaw?ensureEnum(kindRaw,DEPENDENCY_KIND_VALUES,"dependency kind","kind"):void 0,source_kind:sourceKind,author,created_at:createdAt?normalizeDependencyTimestamp(createdAt):void 0}}if(trimmed.toLowerCase()==="undefined")throw new PmCliError(`--dep-remove id must not use placeholder token "${trimmed}"`,EXIT_CODE.USAGE);return{id:normalizeItemId(trimmed,prefix)}})):[]}function dependencyKey(value){const sourceKind=value.source_kind?.trim().toLowerCase()??"";return[value.id.trim().toLowerCase(),value.kind,sourceKind].join("\0")}function storedDependencyIdentityKey(value){const sourceKind=value.source_kind?.trim().toLowerCase()??"",author=value.author?.trim().toLowerCase()??"",rawCreatedAt=value.created_at?.trim()??"",parsedCreatedAt=Date.parse(rawCreatedAt),createdAt=Number.isFinite(parsedCreatedAt)?new Date(parsedCreatedAt).toISOString():rawCreatedAt;return[value.id.trim().toLowerCase(),value.kind,sourceKind,author,createdAt].join("\0")}function reconcileBlockedByDependency(current,nextBlockedById,nowIsoValue,author){let next=[...current??[]],changed=!1;if(nextBlockedById===void 0){const filtered=next.filter(dep=>dep.kind!=="blocked_by");return filtered.length!==next.length&&(next=filtered,changed=!0),changed?{dependencies:next.length>0?next:void 0,changed:!0}:{dependencies:current,changed:!1}}return next.some(dep=>dep.kind==="blocked_by"&&dep.id===nextBlockedById)||(next.push({id:nextBlockedById,kind:"blocked_by",created_at:nowIsoValue,author,source_kind:"cli:update:blocked_by",author_source:"detected"}),changed=!0),changed?{dependencies:next.length>0?next:void 0,changed:!0}:{dependencies:current,changed:!1}}async function resolveBlockedByDependencyTarget(blockedByOption,blockedByCleared,pmRoot,idPrefix,itemFormat,typeToFolder){if(blockedByOption===void 0||blockedByCleared)return{};const blockedByValue=blockedByOption.trim();if(blockedByValue.length===0)return{};const located=await locateItem(pmRoot,normalizeItemId(blockedByValue,idPrefix),idPrefix,itemFormat,typeToFolder);return located?{id:located.id}:{unresolved:blockedByValue}}function applyBlockedByDependencyEdge(metadata,resolvedBlockedById,nowIsoValue,author,changedFields){const reconciled=reconcileBlockedByDependency(metadata.dependencies,resolvedBlockedById,nowIsoValue,author);reconciled.changed&&(reconciled.dependencies===void 0?delete metadata.dependencies:metadata.dependencies=reconciled.dependencies,changedFields.includes("dependencies")||changedFields.push("dependencies"))}function fileKey(value){return`${value.path}::${value.scope}`}function docKey(value){return`${value.path}::${value.scope}`}function testKey(value){return`${value.command}::${value.path??""}::${value.scope}::${value.pm_context_mode??""}::${value.workspace_context_mode??""}`}function matchesDependencySelector(value,selector){return!(value.id.trim().toLowerCase()!==selector.id.trim().toLowerCase()||selector.kind&&value.kind!==selector.kind||selector.source_kind!==void 0&&value.source_kind?.trim().toLowerCase()!==selector.source_kind.trim().toLowerCase()||selector.author!==void 0&&value.author?.trim().toLowerCase()!==selector.author.trim().toLowerCase()||selector.created_at!==void 0&&(value.created_at===void 0||!Number.isFinite(Date.parse(value.created_at))||new Date(Date.parse(value.created_at)).toISOString()!==selector.created_at))}function normalizeUpdatePolicyOptionKey(raw,typeName){const canonical=canonicalizeCommandOptionKey("update",raw);if(!canonical)throw new PmCliError(`Unsupported command_option_policies option "${raw}" for update command on type "${typeName}"`,EXIT_CODE.CONFLICT);return canonical}function collectProvidedUpdatePolicyOptions(options,runtimeFieldRegistry,extensionFieldNames){const provided=new Set,mark=(optionKey,isProvided)=>{isProvided&&provided.add(optionKey)};if(mark("title",options.title!==void 0),mark("description",options.description!==void 0),mark("body",options.body!==void 0),mark("status",options.status!==void 0),mark("closeReason",options.closeReason!==void 0),mark("priority",options.priority!==void 0),mark("type",options.type!==void 0),mark("tags",options.tags!==void 0||Array.isArray(options.addTags)&&options.addTags.length>0||Array.isArray(options.removeTags)&&options.removeTags.length>0),mark("deadline",options.deadline!==void 0),mark("estimatedMinutes",options.estimatedMinutes!==void 0),mark("acceptanceCriteria",options.acceptanceCriteria!==void 0||Array.isArray(options.addAc)&&options.addAc.length>0||Array.isArray(options.removeAc)&&options.removeAc.length>0),mark("definitionOfReady",options.definitionOfReady!==void 0),mark("order",options.order!==void 0||options.rank!==void 0),mark("goal",options.goal!==void 0),mark("objective",options.objective!==void 0),mark("value",options.value!==void 0),mark("impact",options.impact!==void 0),mark("outcome",options.outcome!==void 0),mark("whyNow",options.whyNow!==void 0),mark("author",options.author!==void 0),mark("message",options.message!==void 0),mark("assignee",options.assignee!==void 0),mark("parent",options.parent!==void 0),mark("reviewer",options.reviewer!==void 0),mark("risk",options.risk!==void 0),mark("confidence",options.confidence!==void 0),mark("sprint",options.sprint!==void 0),mark("release",options.release!==void 0),mark("blockedBy",options.blockedBy!==void 0),mark("blockedReason",options.blockedReason!==void 0),mark("unblockNote",options.unblockNote!==void 0),mark("reporter",options.reporter!==void 0),mark("severity",options.severity!==void 0),mark("environment",options.environment!==void 0),mark("reproSteps",options.reproSteps!==void 0),mark("resolution",options.resolution!==void 0),mark("expectedResult",options.expectedResult!==void 0),mark("actualResult",options.actualResult!==void 0),mark("affectedVersion",options.affectedVersion!==void 0),mark("fixedVersion",options.fixedVersion!==void 0),mark("component",options.component!==void 0),mark("regression",options.regression!==void 0),mark("customerImpact",options.customerImpact!==void 0),mark("dep",options.dep!==void 0),mark("depRemove",options.depRemove!==void 0),mark("dep",options.replaceDeps===!0),mark("comment",options.comment!==void 0),mark("note",options.note!==void 0),mark("learning",options.learning!==void 0),mark("file",options.file!==void 0),mark("test",options.test!==void 0),mark("test",options.replaceTests===!0),mark("file",options.replaceFiles===!0),mark("doc",options.replaceDocs===!0),mark("doc",options.doc!==void 0),mark("reminder",options.reminder!==void 0),mark("event",options.event!==void 0),mark("typeOption",options.typeOption!==void 0),mark("field",options.field!==void 0),mark("force",options.force===!0),mark("ownershipMetadataBypass",options.ownershipMetadataBypass===!0),mark("ownershipDependencyBypass",options.ownershipDependencyBypass===!0),mark("dep",options.clearDeps===!0),mark("comment",options.clearComments===!0),mark("note",options.clearNotes===!0),mark("learning",options.clearLearnings===!0),mark("file",options.clearFiles===!0),mark("test",options.clearTests===!0),mark("doc",options.clearDocs===!0),mark("reminder",options.clearReminders===!0),mark("event",options.clearEvents===!0),mark("typeOption",options.clearTypeOptions===!0),options.unset&&options.unset.length>0){const unsetTargets=parseUpdateUnsetTargets(options.unset,runtimeFieldRegistry,extensionFieldNames);for(const optionKey of unsetTargets.optionKeys)mark(optionKey,!0)}return provided}function enforceUpdateOptionsByType(typeName,options,typeRegistry,runtimeFieldRegistry,extensionFieldNames){const typeDefinition=resolveTypeDefinition(typeName,typeRegistry);if(!typeDefinition)throw new PmCliError(`Invalid type value "${typeName}"`,EXIT_CODE.USAGE);const policyState=resolveCommandOptionPolicyState(typeDefinition,"update",[]);if(policyState.errors.length>0)throw new PmCliError(policyState.errors.join("; "),EXIT_CODE.CONFLICT);const provided=collectProvidedUpdatePolicyOptions(options,runtimeFieldRegistry,extensionFieldNames);for(const disabled of policyState.disabled)if(provided.has(normalizeUpdatePolicyOptionKey(disabled,typeName)))throw new PmCliError(`Option ${commandOptionFlagLabel("update",disabled)} is disabled for type "${typeName}" by command_option_policies`,EXIT_CODE.USAGE);for(const required of policyState.required)if(!provided.has(normalizeUpdatePolicyOptionKey(required,typeName)))throw new PmCliError(`Missing required option ${commandOptionFlagLabel("update",required)} for type "${typeName}"`,EXIT_CODE.USAGE)}const UPDATE_LEGACY_COMMON_SCALAR_OPTION_EXCLUSIONS=new Set(["order","rank"]),UPDATE_LEGACY_COMMON_SCALAR_OPTION_KEYS=COMMON_MUTATION_COMMAND_OPTION_KEYS.filter(key=>!UPDATE_LEGACY_COMMON_SCALAR_OPTION_EXCLUSIONS.has(key)),UPDATE_LEGACY_SCALAR_OPTION_KEYS=["tags","closeReason",...UPDATE_LEGACY_COMMON_SCALAR_OPTION_KEYS],UPDATE_SIMPLE_FIELD_FLAG_KEYS=["title","description","body","status","closeReason","completedAt","priority","type",...COMMON_MUTATION_COMMAND_OPTION_KEYS,"dep","depRemove","comment","note","learning","file","test","doc","reminder","event","typeOption","field"],UPDATE_POST_TAG_SCALAR_MUTATIONS=[{optionKey:"deadline",metadataKey:"deadline",transform:(value,context)=>resolveIsoOrRelative(value,context.nowValue,"deadline")},{optionKey:"estimatedMinutes",metadataKey:"estimated_minutes",transform:value=>parseOptionalNonNegativeInteger(value,"estimated-minutes")},{optionKey:"acceptanceCriteria",metadataKey:"acceptance_criteria",transform:value=>value},{optionKey:"definitionOfReady",metadataKey:"definition_of_ready"},{optionKey:"goal",metadataKey:"goal"},{optionKey:"objective",metadataKey:"objective"},{optionKey:"value",metadataKey:"value"},{optionKey:"impact",metadataKey:"impact"},{optionKey:"outcome",metadataKey:"outcome"},{optionKey:"whyNow",metadataKey:"why_now"}],UPDATE_STAKEHOLDER_SCALAR_MUTATIONS=[{optionKey:"reviewer",metadataKey:"reviewer"},{optionKey:"risk",metadataKey:"risk",transform:value=>ensureEnum(normalizeRiskInput(value),RISK_VALUES,"risk")},{optionKey:"confidence",metadataKey:"confidence",transform:value=>parseConfidenceInput(value)}],UPDATE_ISSUE_SCALAR_MUTATIONS=[{optionKey:"blockedReason",metadataKey:"blocked_reason"},{optionKey:"unblockNote",metadataKey:"unblock_note"},{optionKey:"reporter",metadataKey:"reporter"},{optionKey:"severity",metadataKey:"severity",transform:value=>ensureEnum(normalizeSeverityInput(value),ISSUE_SEVERITY_VALUES,"severity")},{optionKey:"environment",metadataKey:"environment"},{optionKey:"reproSteps",metadataKey:"repro_steps"},{optionKey:"resolution",metadataKey:"resolution"},{optionKey:"expectedResult",metadataKey:"expected_result"},{optionKey:"actualResult",metadataKey:"actual_result"},{optionKey:"affectedVersion",metadataKey:"affected_version"},{optionKey:"fixedVersion",metadataKey:"fixed_version"},{optionKey:"component",metadataKey:"component"},{optionKey:"regression",metadataKey:"regression",transform:value=>parseRegressionInput(value)},{optionKey:"customerImpact",metadataKey:"customer_impact"}];function applyUpdateScalarMutations(definitions,options,context){for(const definition of definitions){const optionValue=options[definition.optionKey],shouldClear=context.clearItemMetadataKeys.has(definition.metadataKey);if(!(optionValue===void 0&&!shouldClear)){if(shouldClear){delete context.metadataRecord[definition.metadataKey],context.changedFields.push(definition.metadataKey);continue}if(typeof optionValue!="string")throw new PmCliError(`${commandOptionFlagLabel("update",String(definition.optionKey))} must be a string value`,EXIT_CODE.USAGE);context.metadataRecord[definition.metadataKey]=definition.transform?definition.transform(optionValue,context):optionValue.trim(),context.changedFields.push(definition.metadataKey)}}}async function resolveStdinUpdateOptions(options){return normalizeLegacyNoneUpdateOptions(await resolveMutationStdinTokenFields(options,[["body","--body"],["description","--description"]],[["dep","--dep"],["depRemove","--dep-remove"],["comment","--comment"],["note","--note"],["learning","--learning"],["file","--file"],["test","--test"],["doc","--doc"],["reminder","--reminder"],["event","--event"],["typeOption","--type-option"],["field","--field"]]))}async function resolveUpdateTransportOptions(options){return shouldResolveMutationStdinTokens(options)?await resolveStdinUpdateOptions(options):normalizeLegacyNoneUpdateOptions(options)}function buildClearCollectionDefinitions(options){return[{enabled:options.clearDeps||options.replaceDeps,optionKey:"dep",clearFlag:"--clear-deps",valueFlag:"--dep",values:options.dep,metadataKey:"dependencies"},{enabled:options.clearComments,optionKey:"comment",clearFlag:"--clear-comments",valueFlag:"--comment",values:options.comment,metadataKey:"comments"},{enabled:options.clearNotes,optionKey:"note",clearFlag:"--clear-notes",valueFlag:"--note",values:options.note,metadataKey:"notes"},{enabled:options.clearLearnings,optionKey:"learning",clearFlag:"--clear-learnings",valueFlag:"--learning",values:options.learning,metadataKey:"learnings"},{enabled:options.clearFiles||options.replaceFiles,optionKey:"file",clearFlag:"--clear-files",valueFlag:"--file",values:options.file,metadataKey:"files"},{enabled:options.clearTests||options.replaceTests,optionKey:"test",clearFlag:"--clear-tests",valueFlag:"--test",values:options.test,metadataKey:"tests"},{enabled:options.clearDocs||options.replaceDocs,optionKey:"doc",clearFlag:"--clear-docs",valueFlag:"--doc",values:options.doc,metadataKey:"docs"},{enabled:options.clearReminders,optionKey:"reminder",clearFlag:"--clear-reminders",valueFlag:"--reminder",values:options.reminder,metadataKey:"reminders"},{enabled:options.clearEvents,optionKey:"event",clearFlag:"--clear-events",valueFlag:"--event",values:options.event,metadataKey:"events"},{enabled:options.clearTypeOptions,optionKey:"typeOption",clearFlag:"--clear-type-options",valueFlag:"--type-option",values:options.typeOption,metadataKey:"type_options"}]}function validateLinkedArtifactReplacement(params){if(params.enabled&&(!params.values||params.values.length===0))throw new PmCliError(`${params.replaceFlag} requires at least one ${params.valueFlag} entry`,EXIT_CODE.USAGE);if(params.enabled&&params.clearEnabled)throw new PmCliError(`${params.replaceFlag} cannot be combined with ${params.clearFlag}`,EXIT_CODE.USAGE)}function assertUpdateMutationOptionCombinations(options){const hasAdditiveAcceptanceCriteriaMutation=(options.addAc?.length??0)>0||(options.removeAc?.length??0)>0;if(options.acceptanceCriteria!==void 0&&hasAdditiveAcceptanceCriteriaMutation)throw new PmCliError("Cannot combine --acceptance-criteria replacement with --add-ac or --remove-ac. Use --remove-ac and --add-ac together for an atomic one-entry repair.",EXIT_CODE.USAGE,{code:"acceptance_criteria_mutation_conflict",reason:"replacement_and_additive_mutation_combined",nextSteps:["Use --acceptance-criteria alone to replace the complete list.","Use --remove-ac <old> --add-ac <new> to repair one criterion without replacing unrelated entries."]});if(options.replaceDeps===!0&&(options.dep===void 0||options.dep.length===0))throw new PmCliError("--replace-deps requires at least one --dep entry",EXIT_CODE.USAGE);if(options.replaceDeps===!0&&options.depRemove!==void 0&&options.depRemove.length>0)throw new PmCliError("--replace-deps cannot be combined with --dep-remove",EXIT_CODE.USAGE);validateLinkedArtifactReplacement({enabled:options.replaceTests===!0,values:options.test,replaceFlag:"--replace-tests",clearEnabled:options.clearTests===!0,clearFlag:"--clear-tests",valueFlag:"--test"}),validateLinkedArtifactReplacement({enabled:options.replaceFiles===!0,values:options.file,replaceFlag:"--replace-files",clearEnabled:options.clearFiles===!0,clearFlag:"--clear-files",valueFlag:"--file"}),validateLinkedArtifactReplacement({enabled:options.replaceDocs===!0,values:options.doc,replaceFlag:"--replace-docs",clearEnabled:options.clearDocs===!0,clearFlag:"--clear-docs",valueFlag:"--doc"})}function applyClearCollectionDefinitions(params){for(const definition of params.definitions){if(!definition.enabled)continue;const isReplacement=definition.optionKey==="dep"&&params.options.replaceDeps===!0||definition.optionKey==="test"&&params.options.replaceTests===!0||definition.optionKey==="file"&&params.options.replaceFiles===!0||definition.optionKey==="doc"&&params.options.replaceDocs===!0;if(definition.values&&definition.values.length>0&&!isReplacement)throw new PmCliError(`Cannot combine ${definition.clearFlag} with ${definition.valueFlag}`,EXIT_CODE.USAGE);params.clearOptionKeys.add(definition.optionKey),params.clearItemMetadataKeys.add(definition.metadataKey)}}function buildScalarOptionPresence(options){const presence={};for(const key of UPDATE_LEGACY_SCALAR_OPTION_KEYS)presence[String(key)]=options[key]!==void 0;return presence.order=options.order!==void 0||options.rank!==void 0,presence}function rejectUnsetScalarConflicts(options,unsetTargets){const scalarOptionPresence=buildScalarOptionPresence(options);for(const[optionKey,hasValue]of Object.entries(scalarOptionPresence)){if(!hasValue||!unsetTargets.optionKeys.has(optionKey))continue;const unsetField=UPDATE_OPTION_KEY_TO_UNSET_CANONICAL.get(optionKey)??optionKey;throw new PmCliError(`Cannot combine --unset ${unsetField} with ${commandOptionFlagLabel("update",optionKey)}`,EXIT_CODE.USAGE)}if(unsetTargets.metadataKeys.has("acceptance_criteria")){if(Array.isArray(options.addAc)&&options.addAc.length>0)throw new PmCliError("Cannot combine --unset acceptance-criteria with --add-ac",EXIT_CODE.USAGE);if(Array.isArray(options.removeAc)&&options.removeAc.length>0)throw new PmCliError("Cannot combine --unset acceptance-criteria with --remove-ac",EXIT_CODE.USAGE)}if(unsetTargets.metadataKeys.has("tags")){if(Array.isArray(options.addTags)&&options.addTags.length>0)throw new PmCliError("Cannot combine --unset tags with --add-tags",EXIT_CODE.USAGE);if(Array.isArray(options.removeTags)&&options.removeTags.length>0)throw new PmCliError("Cannot combine --unset tags with --remove-tags",EXIT_CODE.USAGE)}}function rejectLegacyScalarTokens(options){const assertNoLegacyScalarToken=(value,optionKey)=>{const unsetField=UPDATE_OPTION_KEY_TO_UNSET_CANONICAL.get(optionKey),hint=unsetField?`Use --unset ${unsetField} to clear this field.`:void 0;assertNoLegacyNoneToken(value,commandOptionFlagLabel("update",optionKey),hint)};for(const key of UPDATE_LEGACY_SCALAR_OPTION_KEYS)assertNoLegacyScalarToken(options[key],String(key));assertNoLegacyScalarToken(options.order??options.rank,"order"),assertNoLegacyNoneTokens(options.reminder,"--reminder","Use --clear-reminders to clear reminders."),assertNoLegacyNoneTokens(options.event,"--event","Use --clear-events to clear linked events.")}function buildUpdateFieldFlags(options,runtimeFieldUpdates){const flags={};for(const key of UPDATE_SIMPLE_FIELD_FLAG_KEYS)flags[String(key)]=options[key]!==void 0;return flags.tags=options.tags!==void 0,flags.addTags=Array.isArray(options.addTags)&&options.addTags.length>0,flags.removeTags=Array.isArray(options.removeTags)&&options.removeTags.length>0,flags.addAc=Array.isArray(options.addAc)&&options.addAc.length>0,flags.removeAc=Array.isArray(options.removeAc)&&options.removeAc.length>0,flags.order=options.order!==void 0,flags.rank=options.rank!==void 0,flags.replaceDeps=options.replaceDeps===!0,flags.replaceTests=options.replaceTests===!0,flags.replaceFiles=options.replaceFiles===!0,flags.replaceDocs=options.replaceDocs===!0,flags.unset=options.unset!==void 0&&options.unset.length>0,flags.clearDeps=options.clearDeps===!0,flags.clearComments=options.clearComments===!0,flags.clearNotes=options.clearNotes===!0,flags.clearLearnings=options.clearLearnings===!0,flags.clearFiles=options.clearFiles===!0,flags.clearTests=options.clearTests===!0,flags.clearDocs=options.clearDocs===!0,flags.clearReminders=options.clearReminders===!0,flags.clearEvents=options.clearEvents===!0,flags.clearTypeOptions=options.clearTypeOptions===!0,flags.documentAnnotationSnapshot=options.documentAnnotationSnapshot!==void 0,flags.runtimeFields=Object.keys(runtimeFieldUpdates).length>0,flags}async function buildNoopUpdateResult(params){const located=await locateItem(params.pmRoot,params.id,params.settings.id_prefix,params.settings.item_format,params.typeRegistry.type_to_folder);if(!located)throw await buildItemNotFoundError(params.pmRoot,params.id,params.settings.id_prefix,params.typeRegistry.type_to_folder);const{document}=await readLocatedItem(located,{schema:params.settings.schema});return{item:toItemRecord(document.metadata),changed_fields:[],warnings:["noop_no_update_fields"]}}async function loadUpdateRelationshipGraph(params){if(!(!params.fieldFlags.dep&&!params.fieldFlags.blockedBy&&!params.fieldFlags.parent&&!params.clearedMetadataKeys.has("parent")))return listAllItemMetadataLight(params.pmRoot,params.settings.item_format,params.typeToFolder,void 0,params.settings.schema)}function assertUpdateHierarchyIntegrity(params){params.before&&assertHierarchyMutationAllowed(params.before,params.before.map(item=>item.id===params.document.metadata.id?params.document.metadata:item),params.document.metadata.id,status=>isTerminalStatus(status,params.statusRegistry),resolveWorkspaceRelationshipKindRegistry())}function assertMatchingOrderRank(options){if(options.order!==void 0&&options.rank!==void 0&&options.order!==options.rank)throw new PmCliError("--order and --rank must match when both are provided",EXIT_CODE.USAGE)}async function resolveParentReferenceForUpdate(params){if(params.options.parent===void 0||params.unsetTargets.metadataKeys.has("parent"))return{resolvedParentValue:void 0,warnings:[]};const resolvedParentValue=normalizeItemReference(normalizeParentReferenceValue(params.options.parent),params.settings.id_prefix);if(isExternalDependencyReference(resolvedParentValue))return{resolvedParentValue,warnings:[]};if(assertParentReferenceIsNotSelf(params.id,resolvedParentValue,params.settings.id_prefix),await locateItem(params.pmRoot,resolvedParentValue,params.settings.id_prefix,params.settings.item_format,params.typeRegistry.type_to_folder))return{resolvedParentValue,warnings:[]};const normalizedParentId=normalizeItemId(resolvedParentValue,params.settings.id_prefix);return{resolvedParentValue,warnings:validateMissingParentReference(normalizedParentId,params.parentReferencePolicy).warnings}}function blockedByResolutionWarnings(resolution){return resolution.unresolved===void 0?[]:[`blocked_by_unresolved:${resolution.unresolved}`]}async function collectWorkflowTransitionWarnings(params){if(params.workflowEnforcement==="off"||params.typeWorkflows.length===0||!params.fieldFlags.status||params.options.status===void 0)return[];const located=await locateItem(params.pmRoot,params.id,params.settings.id_prefix,params.settings.item_format,params.typeRegistry.type_to_folder);if(!located)throw await buildItemNotFoundError(params.pmRoot,params.id,params.settings.id_prefix,params.typeRegistry.type_to_folder);const{document}=await readLocatedItem(located,{schema:params.settings.schema}),effectiveType=params.options.type!==void 0?resolveTypeName(params.options.type,params.typeRegistry)??params.options.type:document.metadata?.type??"",warning=enforceTypeWorkflowTransition({enforcement:params.workflowEnforcement,typeWorkflows:params.typeWorkflows,statusRegistry:params.statusRegistry,typeName:effectiveType,fromStatus:document.metadata?.status??"",toStatus:params.options.status});return warning?[warning]:[]}async function routeCloseStatusUpdate(context){if(!context.fieldFlags.status||normalizeStatusInput(context.options.status,context.statusRegistry)!==context.statusRegistry.close_status)return;const otherFieldKeys=Object.entries(context.fieldFlags).filter(([key,value])=>value&&key!=="status"&&key!=="closeReason"&&key!=="completedAt").map(([key])=>key),routeWarnings=[];let preChangedFields=[];if(otherFieldKeys.length>0){const preUpdateOptions=transferMutationStdinTokenPolicy(context.options,{...context.options,status:void 0,closeReason:void 0,message:void 0}),preUpdate=await runUpdate(context.id,preUpdateOptions,context.global);preChangedFields=preUpdate.changed_fields,routeWarnings.push(...preUpdate.warnings)}const closeResult=await runClose(context.id,context.options.closeReason,{author:context.options.author,message:context.options.message,force:context.options.force,completedAt:context.options.completedAt},context.global),warnings=[...context.workflowTransitionWarnings,...routeWarnings,...closeResult.warnings,"auto_routed_from_update_to_close"];return{item:closeResult.item,changed_fields:[...preChangedFields,...closeResult.changed_fields],warnings}}function applySimpleItemMutations(document,options,statusRegistry,changedFields){return options.title!==void 0&&(document.metadata.title=requireStringOption(options.title,"--title"),changedFields.push("title")),options.description!==void 0&&(document.metadata.description=options.description,changedFields.push("description")),options.body!==void 0&&(document.body=options.body,changedFields.push("body")),normalizeStatusInput(document.metadata.status,statusRegistry)??document.metadata.status}const TERMINAL_EVIDENCE_METADATA_KEYS=["closed_at","completed_at","close_reason","resolution","expected_result","actual_result","fixed_version"];function clearTerminalEvidence(metadata,changedFields){for(const key of TERMINAL_EVIDENCE_METADATA_KEYS)metadata[key]!==void 0&&(delete metadata[key],changedFields.push(key))}function applyStatusMutation(document,context,statusInput,previousStatusNormalized,changedFields){const status=parseStatus(statusInput,context.statusRegistry);if(document.metadata.status=status,changedFields.push("status"),status===context.statusRegistry.close_status&&(document.metadata.closed_at===void 0||document.metadata.closed_at===null)){document.metadata.closed_at=context.nowIso,document.metadata.completed_at=context.nowIso,changedFields.push("closed_at","completed_at");return}!isTerminalStatus(status,context.statusRegistry)&&isTerminalStatus(previousStatusNormalized,context.statusRegistry)&&clearTerminalEvidence(document.metadata,changedFields)}function applyStatusAndCompletionMutations(document,context,previousStatusNormalized,changedFields){if(context.options.status!==void 0&&applyStatusMutation(document,context,context.options.status,previousStatusNormalized,changedFields),context.options.completedAt!==void 0){if(!isTerminalStatus(document.metadata.status,context.statusRegistry))throw new PmCliError("--completed-at can only be set on a terminal item",EXIT_CODE.USAGE);document.metadata.completed_at=resolveIsoOrRelative(context.options.completedAt,new Date(context.nowIso),"completed-at"),changedFields.push("completed_at")}}function applyCloseReasonMutations(document,context,previousStatusNormalized,changedFields){if(context.options.closeReason!==void 0||context.clearItemMetadataKeys.has("close_reason")){if(context.clearItemMetadataKeys.has("close_reason"))delete document.metadata.close_reason;else{const closeReason=context.options.closeReason?.trim()??"";if(closeReason.length===0)throw new PmCliError("--close-reason must not be empty",EXIT_CODE.USAGE);document.metadata.close_reason=closeReason}changedFields.push("close_reason");return}context.options.status!==void 0&&isTerminalStatus(previousStatusNormalized,context.statusRegistry)&&!isTerminalStatus(document.metadata.status,context.statusRegistry)&&document.metadata.close_reason!==void 0&&(delete document.metadata.close_reason,changedFields.push("close_reason"))}function applyStatusAndCloseReasonMutations(document,context,previousStatusNormalized,changedFields){applyStatusAndCompletionMutations(document,context,previousStatusNormalized,changedFields),applyCloseReasonMutations(document,context,previousStatusNormalized,changedFields)}function applyPriorityTypeAndOptions(document,context,changedFields){let activeTypeName=resolveTypeName(document.metadata.type,context.typeRegistry)??document.metadata.type;if(context.options.priority!==void 0&&(document.metadata.priority=resolvePriority(context.options.priority),changedFields.push("priority")),context.options.type!==void 0){const resolvedTypeName=resolveTypeName(context.options.type,context.typeRegistry);if(!resolvedTypeName)throw new PmCliError(buildInvalidTypeError(context.options.type,context.typeRegistry.types,resolveItemTypesFilePath(context.pmRoot,context.settings.schema)),EXIT_CODE.USAGE);document.metadata.type=resolvedTypeName,activeTypeName=resolvedTypeName,changedFields.push("type")}return enforceUpdateOptionsByType(activeTypeName,context.options,context.typeRegistry,context.runtimeFieldRegistry,context.extensionFieldNames),applyTypeOptionMutation(document,context,activeTypeName,changedFields),activeTypeName}function applyTypeOptionMutation(document,context,activeTypeName,changedFields){if(context.options.typeOption!==void 0||context.clearItemMetadataKeys.has("type_options")){if(context.clearItemMetadataKeys.has("type_options"))delete document.metadata.type_options;else{const parsedTypeOptions=parseTypeOptionEntries(context.options.typeOption??[]),validation2=validateTypeOptions(activeTypeName,parsedTypeOptions,context.typeRegistry);if(validation2.errors.length>0)throw new PmCliError(validation2.errors.join("; "),EXIT_CODE.USAGE);document.metadata.type_options=validation2.normalized}changedFields.push("type_options");return}if(context.options.type===void 0||document.metadata.type_options===void 0)return;const validation=validateTypeOptions(activeTypeName,document.metadata.type_options,context.typeRegistry);if(validation.errors.length>0)throw new PmCliError(`Current type options are incompatible with type "${activeTypeName}". ${validation.errors.join("; ")}. Use --clear-type-options to clear them.`,EXIT_CODE.USAGE);document.metadata.type_options=validation.normalized}function normalizeTouchedDependencyIdentities(current,additions){const touchedKeys=new Set(additions.map(entry=>dependencyKey(entry))),retainedStoredIdentities=new Set;return current.filter(entry=>{if(!touchedKeys.has(dependencyKey(entry)))return!0;const storedIdentity=storedDependencyIdentityKey(entry);return retainedStoredIdentities.has(storedIdentity)?!1:(retainedStoredIdentities.add(storedIdentity),!0)})}function assertDependencyRemovalSelectorsMatch(current,selectors,itemId){const unmatchedSelectors=selectors.filter(selector=>!current.some(entry=>matchesDependencySelector(entry,selector)));if(unmatchedSelectors.length!==0)throw new PmCliError(`Dependency removal did not match ${unmatchedSelectors.length===1?"a stored edge":"stored edges"}.`,EXIT_CODE.NOT_FOUND,{code:"dependency_remove_no_match",reason:"selector_not_found",unmatched_selectors:unmatchedSelectors,available_dependencies:current.map(entry=>({id:entry.id,kind:entry.kind,source_kind:entry.source_kind,author:entry.author,created_at:entry.created_at})),why:"Failing on a zero-match selector prevents a mistyped dependency removal from being reported as successful.",nextSteps:[`Inspect the current item with: pm get ${itemId} --full`,"Retry --dep-remove with the exact id plus any kind, source_kind, author, or created_at selectors needed to identify one stored row."]})}function applyDependencyMutations(document,context,changedFields){if(context.options.dep===void 0&&context.options.depRemove===void 0&&!context.clearItemMetadataKeys.has("dependencies"))return;let nextDependencies=context.clearItemMetadataKeys.has("dependencies")?[]:[...document.metadata.dependencies??[]];if(context.dependencyUpdates.additions.length>0){nextDependencies=normalizeTouchedDependencyIdentities(nextDependencies,context.dependencyUpdates.additions);const seen=new Set(nextDependencies.map(entry=>dependencyKey(entry)));for(const addition of context.dependencyUpdates.additions){const key=dependencyKey(addition);seen.has(key)||(nextDependencies.push(addition),seen.add(key))}}context.dependencyRemovals.length>0&&(assertDependencyRemovalSelectorsMatch(nextDependencies,context.dependencyRemovals,document.metadata.id),nextDependencies=nextDependencies.filter(entry=>!context.dependencyRemovals.some(selector=>matchesDependencySelector(entry,selector)))),nextDependencies.length===0?delete document.metadata.dependencies:document.metadata.dependencies=nextDependencies,changedFields.push("dependencies")}function applyLogCollectionMutations(document,context,changedFields){applyLogCollectionMutation(document,"comments",context.options.comment,context.commentUpdates.values,context.clearItemMetadataKeys,changedFields),applyLogCollectionMutation(document,"notes",context.options.note,context.noteUpdates.values,context.clearItemMetadataKeys,changedFields),applyLogCollectionMutation(document,"learnings",context.options.learning,context.learningUpdates.values,context.clearItemMetadataKeys,changedFields)}function applyLogCollectionMutation(document,key,optionValue,values,clearItemMetadataKeys,changedFields){optionValue===void 0&&!clearItemMetadataKeys.has(key)||(clearItemMetadataKeys.has(key)||!values||values.length===0?delete document.metadata[key]:document.metadata[key]=[...document.metadata[key]??[],...values],changedFields.push(key))}function applyEvidenceCollectionMutations(document,context,changedFields){applyUniqueLinkedCollectionMutation(document,"files",context.options.file,context.fileUpdates.values,fileKey,context.options.replaceFiles===!0,context.clearItemMetadataKeys,changedFields),applyTestCollectionMutation(document,context,changedFields),applyUniqueLinkedCollectionMutation(document,"docs",context.options.doc,context.docUpdates.values,docKey,context.options.replaceDocs===!0,context.clearItemMetadataKeys,changedFields)}function applyUniqueLinkedCollectionMutation(document,key,optionValue,values,keyOf,replace,clearItemMetadataKeys,changedFields){if(!(optionValue===void 0&&!clearItemMetadataKeys.has(key))){if(replace)document.metadata[key]=values;else if(clearItemMetadataKeys.has(key)||!values||values.length===0)delete document.metadata[key];else{const next=[...document.metadata[key]??[]],seen=new Set(next.map(entry=>keyOf(entry)));for(const entry of values){const keyValue=keyOf(entry);seen.has(keyValue)||(next.push(entry),seen.add(keyValue))}document.metadata[key]=next}changedFields.push(key)}}function applyTestCollectionMutation(document,context,changedFields){context.options.test===void 0&&!context.clearItemMetadataKeys.has("tests")||(context.clearItemMetadataKeys.has("tests")&&context.options.replaceTests===!0?document.metadata.tests=dedupeLinkedTests(context.testUpdates.values)??[]:context.clearItemMetadataKeys.has("tests")||!context.testUpdates.values||context.testUpdates.values.length===0?delete document.metadata.tests:document.metadata.tests=dedupeLinkedTests([...document.metadata.tests??[],...context.testUpdates.values]),document.metadata.tests!==void 0&&document.metadata.tests.length===0&&delete document.metadata.tests,changedFields.push("tests"))}function dedupeLinkedTests(values){if(!values||values.length===0)return;const next=[],seen=new Set;for(const entry of values){const key=testKey(entry);seen.has(key)||(next.push(entry),seen.add(key))}return next}function applyTagsAndPlanningMutations(document,context,scalarMutationContext){const addTagsValues=context.options.addTags,removeTagsValues=context.options.removeTags,hasAdditiveTagMutation=Array.isArray(addTagsValues)&&addTagsValues.length>0||Array.isArray(removeTagsValues)&&removeTagsValues.length>0;if(context.options.tags!==void 0||context.clearItemMetadataKeys.has("tags")||hasAdditiveTagMutation){const baseTags=context.clearItemMetadataKeys.has("tags")?[]:context.options.tags!==void 0?parseTags(context.options.tags):Array.isArray(document.metadata.tags)?[...document.metadata.tags]:[];document.metadata.tags=applyTagRemovals(mergeAdditiveTags(baseTags,addTagsValues),removeTagsValues),scalarMutationContext.changedFields.push("tags")}applyUpdateScalarMutations(UPDATE_POST_TAG_SCALAR_MUTATIONS,context.options,scalarMutationContext),applyOrderMutation(document,context,scalarMutationContext.changedFields)}function applyAcceptanceCriteriaAdditiveMutation(document,context,scalarMutationContext){const addValues=context.options.addAc,removeValues=context.options.removeAc;if(!(Array.isArray(addValues)&&addValues.length>0)&&!(Array.isArray(removeValues)&&removeValues.length>0))return;const mutation=applyAcceptanceCriteriaMutations(splitAcceptanceCriteria(document.metadata.acceptance_criteria),addValues,removeValues);if(mutation.unmatchedRemovals.length>0)throw new PmCliError(`Acceptance criteria removal did not match: ${mutation.unmatchedRemovals.join(", ")}`,EXIT_CODE.NOT_FOUND,{code:"acceptance_criteria_remove_unmatched",reason:"exact_match_not_found",field:"acceptance_criteria",unmatched:mutation.unmatchedRemovals,why:"Lossless removal fails instead of silently applying the remaining mutations when an exact selector is wrong.",nextSteps:["Read the current acceptance_criteria value and retry with the exact criterion text.","Use --acceptance-criteria alone only when replacing the complete list is intentional."]});const nextValue=mutation.criteria.join("; ");document.metadata.acceptance_criteria!==nextValue&&(nextValue===""&&document.metadata.acceptance_criteria===void 0||(document.metadata.acceptance_criteria=nextValue,scalarMutationContext.changedFields.includes("acceptance_criteria")||scalarMutationContext.changedFields.push("acceptance_criteria")))}function applyOrderMutation(document,context,changedFields){const orderRaw=context.options.order??context.options.rank;if(!(orderRaw===void 0&&!context.clearItemMetadataKeys.has("order"))){if(context.clearItemMetadataKeys.has("order"))delete document.metadata.order;else{const parsedOrder=parseOptionalNumber(orderRaw??"","order");if(!Number.isInteger(parsedOrder))throw new PmCliError("Order must be an integer",EXIT_CODE.USAGE);document.metadata.order=parsedOrder}changedFields.push("order")}}function applyOwnershipAndIssueMutations(document,context,scalarMutationContext,warnings){applyAssigneeMutation(document,context,scalarMutationContext.changedFields),applyParentMutation(document,context,scalarMutationContext.changedFields),applyUpdateScalarMutations(UPDATE_STAKEHOLDER_SCALAR_MUTATIONS,context.options,scalarMutationContext),applySprintReleaseMutation(document,context,"sprint",warnings,scalarMutationContext.changedFields),applySprintReleaseMutation(document,context,"release",warnings,scalarMutationContext.changedFields),applyBlockedByMutation(document,context,scalarMutationContext.changedFields),applyUpdateScalarMutations(UPDATE_ISSUE_SCALAR_MUTATIONS,context.options,scalarMutationContext)}function applyAssigneeMutation(document,context,changedFields){if(!(context.options.assignee===void 0&&!context.clearItemMetadataKeys.has("assignee"))){if(context.clearItemMetadataKeys.has("assignee"))delete document.metadata.assignee;else{const assignee=context.options.assignee?.trim()??"";if(assignee==="")throw new PmCliError("--assignee must not be empty. Use --unset assignee to clear it.",EXIT_CODE.USAGE);document.metadata.assignee=assignee}changedFields.push("assignee")}}function applyParentMutation(document,context,changedFields){context.options.parent===void 0&&!context.clearItemMetadataKeys.has("parent")||(context.clearItemMetadataKeys.has("parent")?delete document.metadata.parent:document.metadata.parent=context.resolvedParentValue??"",changedFields.push("parent"))}function applySprintReleaseMutation(document,context,key,warnings,changedFields){if(!(context.options[key]===void 0&&!context.clearItemMetadataKeys.has(key))){if(context.clearItemMetadataKeys.has(key))delete document.metadata[key];else{const validation=validateSprintOrReleaseValue(key,context.options[key]??"",context.settings.validation.sprint_release_format);document.metadata[key]=validation.value,warnings.push(...validation.warnings)}changedFields.push(key)}}function applyBlockedByMutation(document,context,changedFields){context.options.blockedBy===void 0&&!context.clearItemMetadataKeys.has("blocked_by")||(context.clearItemMetadataKeys.has("blocked_by")?delete document.metadata.blocked_by:document.metadata.blocked_by=context.options.blockedBy?.trim()??"",changedFields.push("blocked_by"),(context.clearItemMetadataKeys.has("blocked_by")||context.resolvedBlockedByDependencyId!==void 0)&&applyBlockedByDependencyEdge(document.metadata,context.resolvedBlockedByDependencyId,context.nowIso,context.author,changedFields))}function applyScheduleMutations(document,context,changedFields){(context.options.reminder!==void 0||context.clearItemMetadataKeys.has("reminders"))&&(context.clearItemMetadataKeys.has("reminders")?delete document.metadata.reminders:document.metadata.reminders=parseReminderEntries(context.options.reminder??[],context.nowValue,{valueMode:"trimmed"}),changedFields.push("reminders")),(context.options.event!==void 0||context.clearItemMetadataKeys.has("events"))&&(context.clearItemMetadataKeys.has("events")?delete document.metadata.events:document.metadata.events=parseEventEntries(context.options.event??[],context.nowValue,{allDayEmptyGuard:"truthy",recurrenceEmptyNumericGuard:"truthy"}),changedFields.push("events"))}function applyRuntimeAndRegisteredFieldMutations(metadataRecord,context,changedFields){clearDynamicFields(metadataRecord,context.runtimeFieldRegistry.definitions.map(definition=>definition.metadata_key),context.clearItemMetadataKeys,changedFields),clearDynamicFields(metadataRecord,context.extensionFieldNames,context.clearItemMetadataKeys,changedFields);for(const[fieldKey,fieldValue]of Object.entries(context.runtimeFieldUpdates)){if(context.clearItemMetadataKeys.has(fieldKey)){const fieldFlag=fieldKey.replaceAll("_","-"),updateFlag=context.runtimeFieldRegistry.definitions.find(candidate=>candidate.metadata_key===fieldKey)?.cli_flag??fieldFlag;throw new PmCliError(`Cannot combine --unset ${fieldFlag} with --${updateFlag}`,EXIT_CODE.USAGE)}stableValueEquals(metadataRecord[fieldKey],fieldValue)||(metadataRecord[fieldKey]=fieldValue,changedFields.push(fieldKey))}const registeredItemFieldUpdates=parseRegisteredItemFieldAssignments(context.options.field,context.extensionRegistrations);for(const fieldKey of Object.keys(registeredItemFieldUpdates))if(context.clearItemMetadataKeys.has(fieldKey))throw new PmCliError(`Cannot combine --unset ${fieldKey.replaceAll("_","-")} with --field ${fieldKey}=...`,EXIT_CODE.USAGE);for(const[fieldKey,fieldValue]of Object.entries(registeredItemFieldUpdates))stableValueEquals(metadataRecord[fieldKey],fieldValue)||(metadataRecord[fieldKey]=fieldValue,changedFields.push(fieldKey))}function clearDynamicFields(metadataRecord,fieldKeys,clearItemMetadataKeys,changedFields){for(const fieldKey of fieldKeys)!clearItemMetadataKeys.has(fieldKey)||metadataRecord[fieldKey]===void 0||(delete metadataRecord[fieldKey],changedFields.push(fieldKey))}function assertPersistedAnnotationSnapshot(document,snapshot){if(snapshot===void 0)return;const current=toItemRecord(document.metadata),key=["comments","notes","learnings"].find(field=>{const submitted=snapshot[field];return submitted!==void 0&&(!Array.isArray(submitted)||!stableValueEquals(submitted,current[field]??[]))});if(key!==void 0)throw new PmCliError(`Full-item --stdin-json update changed persisted ${key}; no item fields were written.`,EXIT_CODE.USAGE,{code:"stdin_json_persisted_annotation_changed",reason:`${key}_requires_annotation_command`,required:`Use pm ${key} ${document.metadata.id} --edit <index> --add <text> to correct an existing entry.`,why:"Full-item update appends new annotations but cannot replace or remove existing audit entries.",nextSteps:[`Inspect the current ${key} with pm ${key} ${document.metadata.id}.`,`Apply the correction with pm ${key} ${document.metadata.id} --edit <index> --add <text>.`]})}function mutateUpdateDocument(document,context){assertPersistedAnnotationSnapshot(document,context.options.documentAnnotationSnapshot);const beforeMetadata=structuredClone(toItemRecord(document.metadata)),beforeBody=document.body,changedFields=[],warnings=[],previousStatusNormalized=applySimpleItemMutations(document,context.options,context.statusRegistry,changedFields),metadataRecord=toItemRecord(document.metadata),scalarMutationContext={metadataRecord,clearItemMetadataKeys:context.clearItemMetadataKeys,changedFields,nowValue:context.nowValue};applyStatusAndCloseReasonMutations(document,context,previousStatusNormalized,changedFields),applyPriorityTypeAndOptions(document,context,changedFields),applyDependencyMutations(document,context,changedFields),applyLogCollectionMutations(document,context,changedFields),applyEvidenceCollectionMutations(document,context,changedFields),applyTagsAndPlanningMutations(document,context,scalarMutationContext),applyAcceptanceCriteriaAdditiveMutation(document,context,scalarMutationContext),applyOwnershipAndIssueMutations(document,context,scalarMutationContext,warnings),(context.options.dep!==void 0||context.options.depRemove!==void 0||context.options.blockedBy!==void 0||context.clearItemMetadataKeys.has("dependencies")||context.clearItemMetadataKeys.has("blocked_by"))&&assertDependencyEdgesAllowed(document.metadata.id,document.metadata.dependencies),normalizeStatusInput(document.metadata.status,context.statusRegistry)===context.statusRegistry.canceled_status&&document.metadata.assignee!==void 0&&(delete document.metadata.assignee,changedFields.includes("assignee")||changedFields.push("assignee")),applyScheduleMutations(document,context,changedFields),applyRuntimeAndRegisteredFieldMutations(metadataRecord,context,changedFields);try{applyRegisteredItemFieldDefaultsAndValidation(metadataRecord,context.extensionRegistrations,{skipDefaultFields:context.clearItemMetadataKeys})}catch(error){throw new PmCliError(error instanceof Error?error.message:"Invalid extension item field values",EXIT_CODE.USAGE)}const afterMetadata=toItemRecord(document.metadata),actualChangedFields=[...new Set(changedFields)].filter(field=>field==="body"?document.body!==beforeBody:!stableValueEquals(beforeMetadata[field],afterMetadata[field]));return context.options.acceptanceCriteria!==void 0&&actualChangedFields.includes("acceptance_criteria")&&warnings.push(`acceptance_criteria_replaced:${splitAcceptanceCriteria(beforeMetadata.acceptance_criteria).length}:${splitAcceptanceCriteria(afterMetadata.acceptance_criteria).length}`),{changedFields:actualChangedFields,warnings}}async function runUpdateWithContext(id,options,global2,execution={}){options=await resolveUpdateTransportOptions(options);const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot),statusRegistry=resolveRuntimeStatusRegistry(settings.schema),runtimeFieldRegistry=resolveRuntimeFieldRegistry(settings.schema),extensionRegistrations=getActiveExtensionRegistrations(),extensionFieldNames=collectRegisteredItemFieldNames(extensionRegistrations),typeRegistry=resolveItemTypeRegistry(settings,extensionRegistrations),workflowEnforcement=settings.governance.workflow_enforcement??"off",typeWorkflows=workflowEnforcement==="off"?[]:resolveTypeWorkflows(settings.schema),parentReferencePolicy=[{strict_error:"strict_error",warn:"warn",off:"off"},{strict_error:"warn",warn:"warn",off:"off"}][+(options.allowMissingParent===!0)][settings.validation.parent_reference],unsetTargets=parseUpdateUnsetTargets(options.unset,runtimeFieldRegistry,extensionFieldNames),clearOptionKeys=new Set(unsetTargets.optionKeys),clearItemMetadataKeys=new Set(unsetTargets.metadataKeys);assertUpdateMutationOptionCombinations(options),applyClearCollectionDefinitions({definitions:buildClearCollectionDefinitions(options),options,clearOptionKeys,clearItemMetadataKeys}),enforceOwnershipBypassScope(id,options,clearItemMetadataKeys),rejectUnsetScalarConflicts(options,unsetTargets),rejectLegacyScalarTokens(options);const author=resolveAuthor(options.author,settings.author_default),nowValue=new Date,nowIso=nowValue.toISOString(),dependencyUpdates=parseDependencyAdditions(options.dep,settings.id_prefix,nowIso,author);assertDependencyEdgesAllowed(id,dependencyUpdates.additions);const dependencyTargetWarnings=await assertDependencyTargetsResolvable({pmRoot,dependencies:dependencyUpdates.additions,idPrefix:settings.id_prefix,itemFormat:settings.item_format,typeToFolder:typeRegistry.type_to_folder,allowUnresolved:options.allowUnresolvedDeps,holders:[{id}],schema:settings.schema}),dependencyRemovals=parseDependencyRemovals(options.depRemove,settings.id_prefix),parsedCommentUpdates=parseLogSeed("--comment",options.comment,nowIso,author),commentUpdates=options.ownershipMetadataBypass===!0&&parsedCommentUpdates.values?{...parsedCommentUpdates,values:parsedCommentUpdates.values.map(entry=>({...entry,author}))}:parsedCommentUpdates,noteUpdates=parseLogSeed("--note",options.note,nowIso,author),learningUpdates=parseLogSeed("--learning",options.learning,nowIso,author),fileUpdates=parseFiles(options.file),testUpdates=parseTests(options.test);testUpdates.values=await attachLinkedTestMutationProvenance(testUpdates.values,author,nowIso);const docUpdates=parseDocs(options.doc),workflowTransitionWarnings=[],parentReference=await resolveParentReferenceForUpdate({id,options,unsetTargets,pmRoot,settings,typeRegistry,parentReferencePolicy}),blockedByResolution=await resolveBlockedByDependencyTarget(options.blockedBy,clearItemMetadataKeys.has("blocked_by"),pmRoot,settings.id_prefix,settings.item_format,typeRegistry.type_to_folder),resolvedBlockedByDependencyId=blockedByResolution.id,parentReferenceWarnings=[...parentReference.warnings,...blockedByResolutionWarnings(blockedByResolution)],runtimeFieldUpdates=collectRuntimeUpdateFieldValues(options,runtimeFieldRegistry,options.runtimeFieldCommands),fieldFlags=buildUpdateFieldFlags(options,runtimeFieldUpdates);if(!Object.values(fieldFlags).some(Boolean))return buildNoopUpdateResult({pmRoot,id,settings,typeRegistry});workflowTransitionWarnings.push(...await collectWorkflowTransitionWarnings({options,fieldFlags,workflowEnforcement,typeWorkflows,statusRegistry,typeRegistry,pmRoot,id,settings}));const routedClose=await routeCloseStatusUpdate({options,fieldFlags,statusRegistry,workflowTransitionWarnings,global:global2,id});if(routedClose)return routedClose;assertMatchingOrderRank(options);const relationshipRegistry=resolveWorkspaceRelationshipKindRegistry(),hierarchyMutationRequired=fieldFlags.parent&&!clearItemMetadataKeys.has("parent")||dependencyUpdates.additions.some(dependency=>relationshipRegistry.resolve(dependency.kind)?.hierarchy),releaseHierarchyMutationLock=await acquireHierarchyMutationLock({pmRoot,author,ttlSeconds:settings.locks.ttl_seconds,waitMs:settings.locks.wait_ms,required:hierarchyMutationRequired});try{let graphBeforeUpdate=await loadUpdateRelationshipGraph({fieldFlags,clearedMetadataKeys:clearItemMetadataKeys,pmRoot,settings,typeToFolder:typeRegistry.type_to_folder}),lifecycleTransition,recurrenceHistoryContext;const result=await mutateItemWithHistoryContextResolver({pmRoot,settings,typeToFolder:typeRegistry.type_to_folder,id,op:resolveUpdateHistoryOperation(options,execution),author,message:options.message,resolveHistoryContext:()=>recurrenceHistoryContext,force:options.force,bypassAssigneeConflict:options.ownershipMetadataBypass===!0||options.ownershipDependencyBypass===!0,extensionFieldNames,skipNoop:!0,mutate(document){lifecycleTransition=prepareRecurrenceTransition({document,recurrenceReason:execution.recurrenceReason,requestedStatus:options.status,statusRegistry}),recurrenceHistoryContext=lifecycleTransition?{recurrence:lifecycleTransition}:void 0,graphBeforeUpdate=graphBeforeUpdate?.map(item=>item.id===document.metadata.id?structuredClone(document.metadata):item);const mutation=mutateUpdateDocument(document,{options,settings,typeRegistry,statusRegistry,runtimeFieldRegistry,extensionRegistrations,extensionFieldNames,clearItemMetadataKeys,dependencyUpdates,dependencyRemovals,commentUpdates,noteUpdates,learningUpdates,fileUpdates,testUpdates,docUpdates,resolvedParentValue:parentReference.resolvedParentValue,resolvedBlockedByDependencyId,runtimeFieldUpdates,nowValue,nowIso,author,pmRoot});return assertUpdateHierarchyIntegrity({before:graphBeforeUpdate,document,statusRegistry}),mutation}});await releaseHierarchyMutationLock();const orderingCycleWarnings=graphBeforeUpdate?collectNewOrderingCycleWarnings(graphBeforeUpdate,graphBeforeUpdate.map(item=>item.id===result.item.id?result.item:item),result.item.id):[];return{item:toItemRecord(result.item),changed_fields:result.changedFields,warnings:[...workflowTransitionWarnings,...parentReferenceWarnings,...dependencyTargetWarnings,...orderingCycleWarnings,...result.warnings],...lifecycleTransition===void 0?{}:{lifecycle_transition:lifecycleTransition}}}finally{await releaseHierarchyMutationLock()}}function resolveUpdateHistoryOperation(options,execution){return options.ownershipMetadataBypass===!0||options.ownershipDependencyBypass===!0?"update_ownership_bypass":execution.recurrenceReason===void 0?"update":"reopen"}function prepareRecurrenceTransition(params){if(params.recurrenceReason===void 0)return;const fromStatus=normalizeStatusInput(params.document.metadata.status,params.statusRegistry)??params.document.metadata.status;if(!isTerminalStatus(fromStatus,params.statusRegistry))throw new PmCliError(`Item ${params.document.metadata.id} is already active with status ${fromStatus}; recurrence transitions require a terminal item.`,EXIT_CODE.CONFLICT,{code:"item_already_active",reason:"recurrence_requires_terminal_item",required:"Use item reopen only for a terminal item whose work has recurred.",why:"Appending a recurrence event to active work would corrupt lifecycle history.",recovery:{suggested_retry:`pm get ${params.document.metadata.id} --full`,suggested_retry_args:["get",params.document.metadata.id,"--full"]},nextSteps:[`Inspect the active item with: pm get ${params.document.metadata.id} --full`,`Continue the existing work with: pm update ${params.document.metadata.id} ...`]});const requestedStatus=params.requestedStatus??params.statusRegistry.open_status,toStatus=normalizeStatusInput(requestedStatus,params.statusRegistry)??requestedStatus,metadata=toItemRecord(params.document.metadata),previousTerminal=Object.fromEntries(["close_reason","resolution","expected_result","actual_result","fixed_version"].flatMap(key=>{const value=metadata[key];return typeof value=="string"?[[key,value]]:[]}));return{reason:params.recurrenceReason,from_status:fromStatus,to_status:toStatus,previous_terminal:previousTerminal}}async function runUpdate(id,options,global2){return runUpdateWithContext(id,options,global2)}async function runReopenUpdate(id,options,global2,recurrenceReason){const result=await runUpdateWithContext(id,options,global2,{recurrenceReason});if(result.lifecycle_transition===void 0)throw new PmCliError(`Item ${id} did not produce the required recurrence receipt.`,EXIT_CODE.GENERIC_FAILURE,{code:"reopen_receipt_missing",reason:"recurrence_transition_not_recorded",required:"A successful reopen must return the terminal-to-active lifecycle transition recorded in immutable history."});return{...result,lifecycle_transition:result.lifecycle_transition}}const _testOnlyUpdateCommand={applyStatusAndCloseReasonMutations,collectProvidedUpdatePolicyOptions,buildOwnershipBypassRestrictedOptionsError,enforceOwnershipBypassScope,enforceTypeWorkflowTransition,matchesDependencySelector,normalizeLegacyNoneUpdateOptions,normalizeUpdatePolicyOptionKey,parseDependencyAdditions,parseDependencyRemovals,parseUpdateUnsetTargets,reconcileBlockedByDependency,resolveRuntimeUnsetDefinition:(token,registry)=>resolveRuntimeUnsetFieldDefinition(token,"update",registry)};export{_testOnlyUpdateCommand,assertUpdateMutationOptionCombinations,parseDependencyAdditions,resolveUpdateTransportOptions,runReopenUpdate,runUpdate};
+(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]="1d77acec-3731-597e-ad30-9ea1d25c057f")}catch{}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{resolveMutationStdinTokenFields}from"../../core/item/parse.js";import{COMMON_MUTATION_COMMAND_OPTION_KEYS,canonicalizeCommandOptionKey,commandOptionFlagLabel,resolveItemTypeRegistry,resolveCommandOptionPolicyState,resolveTypeDefinition,resolveTypeName,validateTypeOptions,normalizeItemId,toItemRecord,buildInvalidTypeError,assertParentReferenceIsNotSelf,normalizeParentReferenceValue,validateMissingParentReference,validateSprintOrReleaseValue,applyAcceptanceCriteriaMutations,applyTagRemovals,assertNoUnknownCsvKeys,looksLikeGenericKeyValueEntry,mergeAdditiveTags,parseCsvKv,parseOptionalNonNegativeInteger,parseOptionalNumber,parseTags,shouldResolveMutationStdinTokens,transferMutationStdinTokenPolicy,splitAcceptanceCriteria,resolvePriority,normalizeStatusInput,isTerminalStatus,collectRuntimeUpdateFieldValues,resolveItemTypesFilePath,resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry,describeAllowedTransitions,evaluateTransition,resolveTypeWorkflows,EXIT_CODE,PmCliError,stableValueEquals,resolveIsoOrRelative,getActiveExtensionRegistrations,collectRegisteredItemFieldNames,applyRegisteredItemFieldDefaultsAndValidation,parseRegisteredItemFieldAssignments,buildItemNotFoundError,listAllItemMetadataLight,locateItem,readLocatedItem,resolvePmRoot,readSettings,resolveAuthor}from"../runtime-primitives.js";import{mutateItemWithHistoryContextResolver}from"../../core/store/item-store.js";import{runClose}from"./close.js";import{normalizeRiskInput,normalizeSeverityInput,parseConfidenceInput,parseRegressionInput}from"./metadata-normalizers.js";import{resolveCoreFieldRecovery}from"./core-field-recovery.js";import{applyLegacyNoneCollectionNormalizers,createLegacyNoneCollectionNormalizers,assertNoLegacyNoneToken,assertNoLegacyNoneTokens,isLegacyNoneToken}from"./legacy-none-tokens.js";import{ensureEnumValue as ensureEnum}from"./recurrence-parsers.js";import{parseEventEntries,parseReminderEntries,parseTypeOptionEntries}from"./repeatable-metadata-parsers.js";import{requireDependencyKind,assertDependencyEdgesAllowed,assertDependencyTargetsResolvable,assertValidBareDependencyFlagValue}from"../dependency-flag-validation.js";import{normalizeDependencySeedId,normalizeItemReference,isExternalDependencyReference,normalizeDependencySourceKind}from"../dependency-provenance.js";import{collectNewOrderingCycleWarnings}from"../graph/mutation-advisory.js";import{assertHierarchyMutationAllowed}from"../graph/hierarchy-integrity.js";import{assertNonHierarchyCardinalityMutationAllowed,relationshipKindNeedsIntegrityLock}from"../graph/cardinality-integrity.js";import{resolveWorkspaceRelationshipKindRegistry}from"../graph/assembly.js";import{acquireHierarchyMutationLock}from"./hierarchy-mutation-lock.js";import{ISSUE_SEVERITY_VALUES,RISK_VALUES}from"../../types/index.js";import{parseDocs,parseFiles,parseLogSeed,parseTests,requireStringOption}from"./create.js";import{attachLinkedTestMutationProvenance}from"../test/trust.js";import{COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,parseCommandUnsetTargets,resolveRuntimeUnsetFieldDefinition}from"./shared-unset-fields.js";const UPDATE_UNSET_FIELD_DEFINITIONS=[...COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,{canonical:"close-reason",aliases:["close_reason","close-reason"],optionKey:"closeReason",metadataKey:"close_reason"},...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR,...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR],UPDATE_UNSET_ALIAS_MAP=(()=>{const map=new Map;for(const definition of UPDATE_UNSET_FIELD_DEFINITIONS)for(const alias of definition.aliases)map.set(alias,{optionKey:definition.optionKey,metadataKey:definition.metadataKey});return map})(),UPDATE_OPTION_KEY_TO_UNSET_CANONICAL=new Map(UPDATE_UNSET_FIELD_DEFINITIONS.map(definition=>[definition.optionKey,definition.canonical])),UPDATE_UNSET_SUPPORTED_CANONICAL_FIELDS=UPDATE_UNSET_FIELD_DEFINITIONS.map(definition=>definition.canonical).sort((left,right)=>left.localeCompare(right)).join(", "),OWNERSHIP_BYPASS_DISALLOWED_UNSET_ITEM_METADATA_KEYS=new Set(["close_reason","assignee","parent","blocked_by","blocked_reason","unblock_note","dependencies","comments","notes","learnings","files","tests","docs","reminders","events"]),UPDATE_LEGACY_NONE_COLLECTION_NORMALIZERS=createLegacyNoneCollectionNormalizers({depDisableFlagKey:"replaceDeps",fileDisableFlagKey:"replaceFiles",testDisableFlagKey:"replaceTests",docDisableFlagKey:"replaceDocs"});function normalizeLegacyNoneUpdateOptions(options){const normalized={...options,unset:options.unset?[...options.unset]:void 0},appendUnsetTarget=value=>{const current=normalized.unset?[...normalized.unset]:[];current.includes(value)||current.push(value),normalized.unset=current},scalarOptionKeys=new Set([...UPDATE_OPTION_KEY_TO_UNSET_CANONICAL.keys(),"rank"]);for(const optionKey of scalarOptionKeys){const candidate=normalized[optionKey];if(typeof candidate!="string"||!isLegacyNoneToken(candidate))continue;const canonicalUnset=optionKey==="rank"?"order":UPDATE_OPTION_KEY_TO_UNSET_CANONICAL.get(optionKey)??optionKey;appendUnsetTarget(canonicalUnset),normalized[optionKey]=void 0}return transferMutationStdinTokenPolicy(options,applyLegacyNoneCollectionNormalizers(normalized,UPDATE_LEGACY_NONE_COLLECTION_NORMALIZERS))}function parseUpdateUnsetTargets(raw,runtimeFieldRegistry,extensionFieldNames=[]){return parseCommandUnsetTargets({raw,supportedFields:UPDATE_UNSET_SUPPORTED_CANONICAL_FIELDS,resolveDefinition:trimmed=>{const extensionFieldName=extensionFieldNames.find(fieldName=>{const normalizedFieldName=fieldName.toLowerCase();return normalizedFieldName===trimmed||normalizedFieldName.replaceAll("_","-")===trimmed||normalizedFieldName.replaceAll("-","_")===trimmed});return UPDATE_UNSET_ALIAS_MAP.get(trimmed)??resolveRuntimeUnsetFieldDefinition(trimmed,"update",runtimeFieldRegistry)??(extensionFieldName?{optionKey:"field",metadataKey:extensionFieldName}:void 0)}})}const OWNERSHIP_BYPASS_RESTRICTED_FLAG_REPLACEMENTS=new Map([["--comment",id=>`pm comments ${id} --add "<text>" --force`],["--file",id=>`pm files ${id} --add "path=<path>,scope=<scope>,note=<note>" --force`],["--doc",id=>`pm docs ${id} --add "path=<path>,scope=<scope>,note=<note>" --force`]]);function buildOwnershipBypassRestrictedOptionsError(params){const replacementCommands=params.disallowedFlags.flatMap(flag=>{const replacement=OWNERSHIP_BYPASS_RESTRICTED_FLAG_REPLACEMENTS.get(flag);return replacement?[replacement(params.id)]:[]}),replacementSteps=params.disallowedFlags.flatMap(flag=>{const replacement=OWNERSHIP_BYPASS_RESTRICTED_FLAG_REPLACEMENTS.get(flag);return replacement?[`Replace ${flag} with: ${replacement(params.id)}`]:[]});return new PmCliError(params.message,EXIT_CODE.USAGE,{code:params.code,required:params.required,why:params.why,...replacementCommands.length>0?{examples:replacementCommands}:{},nextSteps:[`Re-run without: ${params.disallowedFlags.join(", ")}`,...replacementSteps]})}function enforceOwnershipBypassScope(id,options,clearItemMetadataKeys){const ownershipMetadataBypass=options.ownershipMetadataBypass===!0,ownershipDependencyBypass=options.ownershipDependencyBypass===!0;if(!ownershipMetadataBypass&&!ownershipDependencyBypass)return;if(ownershipMetadataBypass&&ownershipDependencyBypass)throw new PmCliError("Choose only one package-provided ownership bypass mode.",EXIT_CODE.USAGE);const pushIf=(condition,flag,list)=>{condition&&list.push(flag)};if(ownershipDependencyBypass){const disallowedFlags2=[];if(pushIf(options.title!==void 0,"--title",disallowedFlags2),pushIf(options.description!==void 0,"--description",disallowedFlags2),pushIf(options.body!==void 0,"--body",disallowedFlags2),pushIf(options.status!==void 0,"--status",disallowedFlags2),pushIf(options.closeReason!==void 0,"--close-reason",disallowedFlags2),pushIf(options.priority!==void 0,"--priority",disallowedFlags2),pushIf(options.type!==void 0,"--type",disallowedFlags2),pushIf(options.tags!==void 0,"--tags",disallowedFlags2),pushIf(Array.isArray(options.addTags)&&options.addTags.length>0,"--add-tags",disallowedFlags2),pushIf(Array.isArray(options.removeTags)&&options.removeTags.length>0,"--remove-tags",disallowedFlags2),pushIf(options.deadline!==void 0,"--deadline",disallowedFlags2),pushIf(options.estimatedMinutes!==void 0,"--estimate",disallowedFlags2),pushIf(options.acceptanceCriteria!==void 0,"--acceptance-criteria",disallowedFlags2),pushIf(Array.isArray(options.addAc)&&options.addAc.length>0,"--add-ac",disallowedFlags2),pushIf(Array.isArray(options.removeAc)&&options.removeAc.length>0,"--remove-ac",disallowedFlags2),pushIf(options.definitionOfReady!==void 0,"--definition-of-ready",disallowedFlags2),pushIf(options.order!==void 0||options.rank!==void 0,"--order/--rank",disallowedFlags2),pushIf(options.goal!==void 0,"--goal",disallowedFlags2),pushIf(options.objective!==void 0,"--objective",disallowedFlags2),pushIf(options.value!==void 0,"--value",disallowedFlags2),pushIf(options.impact!==void 0,"--impact",disallowedFlags2),pushIf(options.outcome!==void 0,"--outcome",disallowedFlags2),pushIf(options.whyNow!==void 0,"--why-now",disallowedFlags2),pushIf(options.assignee!==void 0,"--assignee",disallowedFlags2),pushIf(options.parent!==void 0,"--parent",disallowedFlags2),pushIf(options.reviewer!==void 0,"--reviewer",disallowedFlags2),pushIf(options.risk!==void 0,"--risk",disallowedFlags2),pushIf(options.confidence!==void 0,"--confidence",disallowedFlags2),pushIf(options.sprint!==void 0,"--sprint",disallowedFlags2),pushIf(options.release!==void 0,"--release",disallowedFlags2),pushIf(options.blockedBy!==void 0,"--blocked-by",disallowedFlags2),pushIf(options.blockedReason!==void 0,"--blocked-reason",disallowedFlags2),pushIf(options.unblockNote!==void 0,"--unblock-note",disallowedFlags2),pushIf(options.reporter!==void 0,"--reporter",disallowedFlags2),pushIf(options.severity!==void 0,"--severity",disallowedFlags2),pushIf(options.environment!==void 0,"--environment",disallowedFlags2),pushIf(options.reproSteps!==void 0,"--repro-steps",disallowedFlags2),pushIf(options.resolution!==void 0,"--resolution",disallowedFlags2),pushIf(options.expectedResult!==void 0,"--expected-result",disallowedFlags2),pushIf(options.actualResult!==void 0,"--actual-result",disallowedFlags2),pushIf(options.affectedVersion!==void 0,"--affected-version",disallowedFlags2),pushIf(options.fixedVersion!==void 0,"--fixed-version",disallowedFlags2),pushIf(options.component!==void 0,"--component",disallowedFlags2),pushIf(options.regression!==void 0,"--regression",disallowedFlags2),pushIf(options.customerImpact!==void 0,"--customer-impact",disallowedFlags2),pushIf(options.depRemove!==void 0,"--dep-remove",disallowedFlags2),pushIf(options.replaceDeps===!0,"--replace-deps",disallowedFlags2),pushIf(options.replaceTests===!0,"--replace-tests",disallowedFlags2),pushIf(options.replaceFiles===!0,"--replace-files",disallowedFlags2),pushIf(options.replaceDocs===!0,"--replace-docs",disallowedFlags2),pushIf(options.comment!==void 0,"--comment",disallowedFlags2),pushIf(options.note!==void 0,"--note",disallowedFlags2),pushIf(options.learning!==void 0,"--learning",disallowedFlags2),pushIf(options.file!==void 0,"--file",disallowedFlags2),pushIf(options.test!==void 0,"--test",disallowedFlags2),pushIf(options.doc!==void 0,"--doc",disallowedFlags2),pushIf(options.reminder!==void 0,"--reminder",disallowedFlags2),pushIf(options.event!==void 0,"--event",disallowedFlags2),pushIf(options.typeOption!==void 0,"--type-option",disallowedFlags2),pushIf(options.clearDeps===!0,"--clear-deps",disallowedFlags2),pushIf(options.clearComments===!0,"--clear-comments",disallowedFlags2),pushIf(options.clearNotes===!0,"--clear-notes",disallowedFlags2),pushIf(options.clearLearnings===!0,"--clear-learnings",disallowedFlags2),pushIf(options.clearFiles===!0,"--clear-files",disallowedFlags2),pushIf(options.clearTests===!0,"--clear-tests",disallowedFlags2),pushIf(options.clearDocs===!0,"--clear-docs",disallowedFlags2),pushIf(options.clearReminders===!0,"--clear-reminders",disallowedFlags2),pushIf(options.clearEvents===!0,"--clear-events",disallowedFlags2),pushIf(options.clearTypeOptions===!0,"--clear-type-options",disallowedFlags2),pushIf(options.force===!0,"--force",disallowedFlags2),pushIf(clearItemMetadataKeys.size>0,"--unset",disallowedFlags2),options.dep===void 0||options.dep.length===0)throw new PmCliError("The dependency ownership bypass requires at least one --dep value",EXIT_CODE.USAGE);if(disallowedFlags2.length>0)throw buildOwnershipBypassRestrictedOptionsError({id,code:"ownership_dependency_bypass_restricted_options",message:`The dependency ownership bypass supports append-only dependency additions via --dep. Remove restricted options: ${disallowedFlags2.join(", ")}`,required:"Pass only --dep additions (plus --message/--author) with the dependency ownership bypass.",why:"the dependency ownership bypass is a narrow non-owner override scoped to append-only dependency additions; every other mutation keeps its normal ownership rules.",disallowedFlags:disallowedFlags2});return}const disallowedFlags=[];pushIf(options.status!==void 0,"--status",disallowedFlags),pushIf(options.closeReason!==void 0,"--close-reason",disallowedFlags),pushIf(options.assignee!==void 0,"--assignee",disallowedFlags),pushIf(options.parent!==void 0,"--parent",disallowedFlags),pushIf(options.blockedBy!==void 0,"--blocked-by",disallowedFlags),pushIf(options.blockedReason!==void 0,"--blocked-reason",disallowedFlags),pushIf(options.unblockNote!==void 0,"--unblock-note",disallowedFlags),pushIf(options.dep!==void 0,"--dep",disallowedFlags),pushIf(options.depRemove!==void 0,"--dep-remove",disallowedFlags),pushIf(options.replaceDeps===!0,"--replace-deps",disallowedFlags),pushIf(options.replaceTests===!0,"--replace-tests",disallowedFlags),pushIf(options.replaceFiles===!0,"--replace-files",disallowedFlags),pushIf(options.replaceDocs===!0,"--replace-docs",disallowedFlags),pushIf(options.note!==void 0,"--note",disallowedFlags),pushIf(options.learning!==void 0,"--learning",disallowedFlags),pushIf(options.test!==void 0,"--test",disallowedFlags),pushIf(options.reminder!==void 0,"--reminder",disallowedFlags),pushIf(options.event!==void 0,"--event",disallowedFlags),pushIf(options.clearDeps===!0,"--clear-deps",disallowedFlags),pushIf(options.clearComments===!0,"--clear-comments",disallowedFlags),pushIf(options.clearNotes===!0,"--clear-notes",disallowedFlags),pushIf(options.clearLearnings===!0,"--clear-learnings",disallowedFlags),pushIf(options.clearFiles===!0,"--clear-files",disallowedFlags),pushIf(options.clearTests===!0,"--clear-tests",disallowedFlags),pushIf(options.clearDocs===!0,"--clear-docs",disallowedFlags),pushIf(options.clearReminders===!0,"--clear-reminders",disallowedFlags),pushIf(options.clearEvents===!0,"--clear-events",disallowedFlags);const disallowedUnset=[...clearItemMetadataKeys].filter(field=>OWNERSHIP_BYPASS_DISALLOWED_UNSET_ITEM_METADATA_KEYS.has(field)).sort((left,right)=>left.localeCompare(right)).map(field=>`--unset ${field.replaceAll("_","-")}`);if(disallowedFlags.push(...disallowedUnset),disallowedFlags.length>0)throw buildOwnershipBypassRestrictedOptionsError({id,code:"ownership_metadata_bypass_restricted_options",message:`The metadata ownership bypass only supports non-lifecycle metadata fields and evidence appends. Remove restricted options: ${disallowedFlags.join(", ")}`,required:"Limit the metadata ownership bypass to non-lifecycle metadata fields plus append-only --comment/--file/--doc evidence; route restricted appends and lifecycle changes through their dedicated commands.",why:"the metadata ownership bypass is a non-owner override scoped to metadata maintenance and append-only evidence; lifecycle, ownership, dependency mutations, restricted append fields, and clear/replace operations keep their normal ownership rules.",disallowedFlags})}function parseStatus(value,statusRegistry){const normalized=normalizeStatusInput(value,statusRegistry);if(!normalized){const allowedStatuses=statusRegistry.definitions.map(definition=>definition.id);throw new PmCliError(`Invalid --status value "${value}". Allowed: ${allowedStatuses.join(", ")}`,EXIT_CODE.USAGE)}return normalized}function enforceTypeWorkflowTransition(params){if(params.enforcement==="off"||params.typeWorkflows.length===0)return;const result=evaluateTransition({typeName:params.typeName,fromStatus:params.fromStatus,toStatus:params.toStatus,typeWorkflows:params.typeWorkflows,statusRegistry:params.statusRegistry});if(!result.hasRule||result.allowed)return;const normalizedFrom=normalizeStatusInput(params.fromStatus,params.statusRegistry)??params.fromStatus,normalizedTo=normalizeStatusInput(params.toStatus,params.statusRegistry)??params.toStatus,message=`Disallowed transition for type "${params.typeName}": ${normalizedFrom} -> ${normalizedTo}. Allowed transitions: ${describeAllowedTransitions(result.allowedTransitions)}.`;if(params.enforcement==="strict")throw new PmCliError(message,EXIT_CODE.USAGE);return`workflow_transition_not_allowed: ${message}`}function parseDependencyCreatedAt(value,currentIso){return!value||value.trim()===""||value.trim().toLowerCase()==="now"?currentIso:normalizeDependencyTimestamp(value)}function normalizeDependencyTimestamp(value){const parsed=Date.parse(value);if(!Number.isFinite(parsed))throw new PmCliError(`Invalid dependency created_at timestamp "${value}"`,EXIT_CODE.USAGE);return new Date(parsed).toISOString()}function parseOptionalDependencyString(value){if(value===void 0)return;const trimmed=value.trim();return trimmed.length>0?trimmed:void 0}const DEP_ADDITION_KEYS=["id","kind","type","author","created_at","source_kind"],DEP_REMOVE_KEYS=["id","kind","type","author","created_at","source_kind"];function looksLikeStructuredDependencyEntry(raw){return raw.startsWith("```")||raw.includes(`
+`)||/^(?:[-*+]\s+)?(?:id|kind|type|author|created_at|source_kind)\s*[:=]/i.test(raw)?!0:looksLikeGenericKeyValueEntry(raw)}function normalizeDependencyKindInput(raw){return typeof raw=="string"?resolveWorkspaceRelationshipKindRegistry().resolve(raw)?.kind??raw.trim():raw}function parseDependencyAdditions(raw,prefix,nowIso,fallbackAuthor){return raw?(assertNoLegacyNoneTokens(raw,"--dep","Use --clear-deps to clear dependencies."),{additions:raw.map(entry=>{const trimmedEntry=entry.trim(),isStructured=looksLikeStructuredDependencyEntry(trimmedEntry);assertValidBareDependencyFlagValue(trimmedEntry,isStructured);const kv=isStructured?parseCsvKv(entry,"--dep"):{id:trimmedEntry,kind:"related"};isStructured&&assertNoUnknownCsvKeys(kv,"--dep",DEP_ADDITION_KEYS);const id=kv.id?.trim(),kind=normalizeDependencyKindInput((kv.kind??kv.type)?.trim());if(!id||!kind)throw new PmCliError("--dep requires id and kind, or a bare item id to add a related dependency",EXIT_CODE.USAGE);if(id.toLowerCase()==="undefined")throw new PmCliError(`--dep id must not use placeholder token "${id}". Use --clear-deps to clear dependencies.`,EXIT_CODE.USAGE);const sourceKind=normalizeDependencySourceKind(parseOptionalDependencyString(kv.source_kind)),explicitAuthor=parseOptionalDependencyString(kv.author);return{id:normalizeDependencySeedId(id,prefix,sourceKind),kind:requireDependencyKind(kind),created_at:parseDependencyCreatedAt(kv.created_at,nowIso),author:explicitAuthor??fallbackAuthor,source_kind:sourceKind??"cli:update:dep",author_source:explicitAuthor?"asserted":"detected"}})}):{additions:[]}}function parseDependencyRemovals(raw,prefix){return raw?(assertNoLegacyNoneTokens(raw,"--dep-remove"),raw.map(entry=>{const trimmed=entry.trim();if(!trimmed)throw new PmCliError("--dep-remove requires id or key/value selectors",EXIT_CODE.USAGE);const isStructured=looksLikeStructuredDependencyEntry(trimmed);if(assertValidBareDependencyFlagValue(trimmed,isStructured,"--dep-remove"),isStructured){const kv=parseCsvKv(trimmed,"--dep-remove");assertNoUnknownCsvKeys(kv,"--dep-remove",DEP_REMOVE_KEYS);const idRaw=kv.id?.trim();if(!idRaw)throw new PmCliError("--dep-remove key/value form requires id=<value>",EXIT_CODE.USAGE);if(idRaw.toLowerCase()==="undefined")throw new PmCliError(`--dep-remove id must not use placeholder token "${idRaw}"`,EXIT_CODE.USAGE);const kindRaw=normalizeDependencyKindInput(parseOptionalDependencyString(kv.kind??kv.type)),sourceKind=normalizeDependencySourceKind(parseOptionalDependencyString(kv.source_kind)),author=parseOptionalDependencyString(kv.author),createdAt=parseOptionalDependencyString(kv.created_at);return{id:normalizeDependencySeedId(idRaw,prefix,sourceKind),kind:kindRaw?requireDependencyKind(kindRaw):void 0,source_kind:sourceKind,author,created_at:createdAt?normalizeDependencyTimestamp(createdAt):void 0}}if(trimmed.toLowerCase()==="undefined")throw new PmCliError(`--dep-remove id must not use placeholder token "${trimmed}"`,EXIT_CODE.USAGE);return{id:normalizeItemId(trimmed,prefix)}})):[]}function dependencyKey(value){const sourceKind=value.source_kind?.trim().toLowerCase()??"";return[value.id.trim().toLowerCase(),value.kind,sourceKind].join("\0")}function storedDependencyIdentityKey(value){const sourceKind=value.source_kind?.trim().toLowerCase()??"",author=value.author?.trim().toLowerCase()??"",rawCreatedAt=value.created_at?.trim()??"",parsedCreatedAt=Date.parse(rawCreatedAt),createdAt=Number.isFinite(parsedCreatedAt)?new Date(parsedCreatedAt).toISOString():rawCreatedAt;return[value.id.trim().toLowerCase(),value.kind,sourceKind,author,createdAt].join("\0")}function reconcileBlockedByDependency(current,nextBlockedById,nowIsoValue,author){let next=[...current??[]],changed=!1;if(nextBlockedById===void 0){const filtered=next.filter(dep=>dep.kind!=="blocked_by");return filtered.length!==next.length&&(next=filtered,changed=!0),changed?{dependencies:next.length>0?next:void 0,changed:!0}:{dependencies:current,changed:!1}}return next.some(dep=>dep.kind==="blocked_by"&&dep.id===nextBlockedById)||(next.push({id:nextBlockedById,kind:"blocked_by",created_at:nowIsoValue,author,source_kind:"cli:update:blocked_by",author_source:"detected"}),changed=!0),changed?{dependencies:next.length>0?next:void 0,changed:!0}:{dependencies:current,changed:!1}}async function resolveBlockedByDependencyTarget(blockedByOption,blockedByCleared,pmRoot,idPrefix,itemFormat,typeToFolder){if(blockedByOption===void 0||blockedByCleared)return{};const blockedByValue=blockedByOption.trim();if(blockedByValue.length===0)return{};const located=await locateItem(pmRoot,normalizeItemId(blockedByValue,idPrefix),idPrefix,itemFormat,typeToFolder);return located?{id:located.id}:{unresolved:blockedByValue}}function applyBlockedByDependencyEdge(metadata,resolvedBlockedById,nowIsoValue,author,changedFields){const reconciled=reconcileBlockedByDependency(metadata.dependencies,resolvedBlockedById,nowIsoValue,author);reconciled.changed&&(reconciled.dependencies===void 0?delete metadata.dependencies:metadata.dependencies=reconciled.dependencies,changedFields.includes("dependencies")||changedFields.push("dependencies"))}function fileKey(value){return`${value.path}::${value.scope}`}function docKey(value){return`${value.path}::${value.scope}`}function testKey(value){return`${value.command}::${value.path??""}::${value.scope}::${value.pm_context_mode??""}::${value.workspace_context_mode??""}`}function matchesDependencySelector(value,selector){return!(value.id.trim().toLowerCase()!==selector.id.trim().toLowerCase()||selector.kind&&value.kind!==selector.kind||selector.source_kind!==void 0&&value.source_kind?.trim().toLowerCase()!==selector.source_kind.trim().toLowerCase()||selector.author!==void 0&&value.author?.trim().toLowerCase()!==selector.author.trim().toLowerCase()||selector.created_at!==void 0&&(value.created_at===void 0||!Number.isFinite(Date.parse(value.created_at))||new Date(Date.parse(value.created_at)).toISOString()!==selector.created_at))}function normalizeUpdatePolicyOptionKey(raw,typeName){const canonical=canonicalizeCommandOptionKey("update",raw);if(!canonical)throw new PmCliError(`Unsupported command_option_policies option "${raw}" for update command on type "${typeName}"`,EXIT_CODE.CONFLICT);return canonical}function collectProvidedUpdatePolicyOptions(options,runtimeFieldRegistry,extensionFieldNames){const provided=new Set,mark=(optionKey,isProvided)=>{isProvided&&provided.add(optionKey)};if(mark("title",options.title!==void 0),mark("description",options.description!==void 0),mark("body",options.body!==void 0),mark("status",options.status!==void 0),mark("closeReason",options.closeReason!==void 0),mark("priority",options.priority!==void 0),mark("type",options.type!==void 0),mark("tags",options.tags!==void 0||Array.isArray(options.addTags)&&options.addTags.length>0||Array.isArray(options.removeTags)&&options.removeTags.length>0),mark("deadline",options.deadline!==void 0),mark("estimatedMinutes",options.estimatedMinutes!==void 0),mark("acceptanceCriteria",options.acceptanceCriteria!==void 0||Array.isArray(options.addAc)&&options.addAc.length>0||Array.isArray(options.removeAc)&&options.removeAc.length>0),mark("definitionOfReady",options.definitionOfReady!==void 0),mark("order",options.order!==void 0||options.rank!==void 0),mark("goal",options.goal!==void 0),mark("objective",options.objective!==void 0),mark("value",options.value!==void 0),mark("impact",options.impact!==void 0),mark("outcome",options.outcome!==void 0),mark("whyNow",options.whyNow!==void 0),mark("author",options.author!==void 0),mark("message",options.message!==void 0),mark("assignee",options.assignee!==void 0),mark("parent",options.parent!==void 0),mark("reviewer",options.reviewer!==void 0),mark("risk",options.risk!==void 0),mark("confidence",options.confidence!==void 0),mark("sprint",options.sprint!==void 0),mark("release",options.release!==void 0),mark("blockedBy",options.blockedBy!==void 0),mark("blockedReason",options.blockedReason!==void 0),mark("unblockNote",options.unblockNote!==void 0),mark("reporter",options.reporter!==void 0),mark("severity",options.severity!==void 0),mark("environment",options.environment!==void 0),mark("reproSteps",options.reproSteps!==void 0),mark("resolution",options.resolution!==void 0),mark("expectedResult",options.expectedResult!==void 0),mark("actualResult",options.actualResult!==void 0),mark("affectedVersion",options.affectedVersion!==void 0),mark("fixedVersion",options.fixedVersion!==void 0),mark("component",options.component!==void 0),mark("regression",options.regression!==void 0),mark("customerImpact",options.customerImpact!==void 0),mark("dep",options.dep!==void 0),mark("depRemove",options.depRemove!==void 0),mark("dep",options.replaceDeps===!0),mark("comment",options.comment!==void 0),mark("note",options.note!==void 0),mark("learning",options.learning!==void 0),mark("file",options.file!==void 0),mark("test",options.test!==void 0),mark("test",options.replaceTests===!0),mark("file",options.replaceFiles===!0),mark("doc",options.replaceDocs===!0),mark("doc",options.doc!==void 0),mark("reminder",options.reminder!==void 0),mark("event",options.event!==void 0),mark("typeOption",options.typeOption!==void 0),mark("field",options.field!==void 0),mark("force",options.force===!0),mark("ownershipMetadataBypass",options.ownershipMetadataBypass===!0),mark("ownershipDependencyBypass",options.ownershipDependencyBypass===!0),mark("dep",options.clearDeps===!0),mark("comment",options.clearComments===!0),mark("note",options.clearNotes===!0),mark("learning",options.clearLearnings===!0),mark("file",options.clearFiles===!0),mark("test",options.clearTests===!0),mark("doc",options.clearDocs===!0),mark("reminder",options.clearReminders===!0),mark("event",options.clearEvents===!0),mark("typeOption",options.clearTypeOptions===!0),options.unset&&options.unset.length>0){const unsetTargets=parseUpdateUnsetTargets(options.unset,runtimeFieldRegistry,extensionFieldNames);for(const optionKey of unsetTargets.optionKeys)mark(optionKey,!0)}return provided}function enforceUpdateOptionsByType(typeName,options,typeRegistry,runtimeFieldRegistry,extensionFieldNames){const typeDefinition=resolveTypeDefinition(typeName,typeRegistry);if(!typeDefinition)throw new PmCliError(`Invalid type value "${typeName}"`,EXIT_CODE.USAGE);const policyState=resolveCommandOptionPolicyState(typeDefinition,"update",[]);if(policyState.errors.length>0)throw new PmCliError(policyState.errors.join("; "),EXIT_CODE.CONFLICT);const provided=collectProvidedUpdatePolicyOptions(options,runtimeFieldRegistry,extensionFieldNames);for(const disabled of policyState.disabled)if(provided.has(normalizeUpdatePolicyOptionKey(disabled,typeName)))throw new PmCliError(`Option ${commandOptionFlagLabel("update",disabled)} is disabled for type "${typeName}" by command_option_policies`,EXIT_CODE.USAGE);for(const required of policyState.required)if(!provided.has(normalizeUpdatePolicyOptionKey(required,typeName)))throw new PmCliError(`Missing required option ${commandOptionFlagLabel("update",required)} for type "${typeName}"`,EXIT_CODE.USAGE)}const UPDATE_LEGACY_COMMON_SCALAR_OPTION_EXCLUSIONS=new Set(["order","rank"]),UPDATE_LEGACY_COMMON_SCALAR_OPTION_KEYS=COMMON_MUTATION_COMMAND_OPTION_KEYS.filter(key=>!UPDATE_LEGACY_COMMON_SCALAR_OPTION_EXCLUSIONS.has(key)),UPDATE_LEGACY_SCALAR_OPTION_KEYS=["tags","closeReason",...UPDATE_LEGACY_COMMON_SCALAR_OPTION_KEYS],UPDATE_SIMPLE_FIELD_FLAG_KEYS=["title","description","body","status","closeReason","completedAt","priority","type",...COMMON_MUTATION_COMMAND_OPTION_KEYS,"dep","depRemove","comment","note","learning","file","test","doc","reminder","event","typeOption","field"],UPDATE_POST_TAG_SCALAR_MUTATIONS=[{optionKey:"deadline",metadataKey:"deadline",transform:(value,context)=>resolveIsoOrRelative(value,context.nowValue,"deadline")},{optionKey:"estimatedMinutes",metadataKey:"estimated_minutes",transform:value=>parseOptionalNonNegativeInteger(value,"estimated-minutes")},{optionKey:"acceptanceCriteria",metadataKey:"acceptance_criteria",transform:value=>value},{optionKey:"definitionOfReady",metadataKey:"definition_of_ready"},{optionKey:"goal",metadataKey:"goal"},{optionKey:"objective",metadataKey:"objective"},{optionKey:"value",metadataKey:"value"},{optionKey:"impact",metadataKey:"impact"},{optionKey:"outcome",metadataKey:"outcome"},{optionKey:"whyNow",metadataKey:"why_now"}],UPDATE_STAKEHOLDER_SCALAR_MUTATIONS=[{optionKey:"reviewer",metadataKey:"reviewer"},{optionKey:"risk",metadataKey:"risk",transform:value=>ensureEnum(normalizeRiskInput(value),RISK_VALUES,"risk")},{optionKey:"confidence",metadataKey:"confidence",transform:value=>parseConfidenceInput(value)}],UPDATE_ISSUE_SCALAR_MUTATIONS=[{optionKey:"blockedReason",metadataKey:"blocked_reason"},{optionKey:"unblockNote",metadataKey:"unblock_note"},{optionKey:"reporter",metadataKey:"reporter"},{optionKey:"severity",metadataKey:"severity",transform:value=>ensureEnum(normalizeSeverityInput(value),ISSUE_SEVERITY_VALUES,"severity")},{optionKey:"environment",metadataKey:"environment"},{optionKey:"reproSteps",metadataKey:"repro_steps"},{optionKey:"resolution",metadataKey:"resolution"},{optionKey:"expectedResult",metadataKey:"expected_result"},{optionKey:"actualResult",metadataKey:"actual_result"},{optionKey:"affectedVersion",metadataKey:"affected_version"},{optionKey:"fixedVersion",metadataKey:"fixed_version"},{optionKey:"component",metadataKey:"component"},{optionKey:"regression",metadataKey:"regression",transform:value=>parseRegressionInput(value)},{optionKey:"customerImpact",metadataKey:"customer_impact"}];function applyUpdateScalarMutations(definitions,options,context){for(const definition of definitions){const optionValue=options[definition.optionKey],shouldClear=context.clearItemMetadataKeys.has(definition.metadataKey);if(!(optionValue===void 0&&!shouldClear)){if(shouldClear){delete context.metadataRecord[definition.metadataKey],context.changedFields.push(definition.metadataKey);continue}if(typeof optionValue!="string")throw new PmCliError(`${commandOptionFlagLabel("update",String(definition.optionKey))} must be a string value`,EXIT_CODE.USAGE);context.metadataRecord[definition.metadataKey]=definition.transform?definition.transform(optionValue,context):optionValue.trim(),context.changedFields.push(definition.metadataKey)}}}async function resolveStdinUpdateOptions(options){return normalizeLegacyNoneUpdateOptions(await resolveMutationStdinTokenFields(options,[["body","--body"],["description","--description"]],[["dep","--dep"],["depRemove","--dep-remove"],["comment","--comment"],["note","--note"],["learning","--learning"],["file","--file"],["test","--test"],["doc","--doc"],["reminder","--reminder"],["event","--event"],["typeOption","--type-option"],["field","--field"]]))}async function resolveUpdateTransportOptions(options){return shouldResolveMutationStdinTokens(options)?await resolveStdinUpdateOptions(options):normalizeLegacyNoneUpdateOptions(options)}function buildClearCollectionDefinitions(options){return[{enabled:options.clearDeps||options.replaceDeps,optionKey:"dep",clearFlag:"--clear-deps",valueFlag:"--dep",values:options.dep,metadataKey:"dependencies"},{enabled:options.clearComments,optionKey:"comment",clearFlag:"--clear-comments",valueFlag:"--comment",values:options.comment,metadataKey:"comments"},{enabled:options.clearNotes,optionKey:"note",clearFlag:"--clear-notes",valueFlag:"--note",values:options.note,metadataKey:"notes"},{enabled:options.clearLearnings,optionKey:"learning",clearFlag:"--clear-learnings",valueFlag:"--learning",values:options.learning,metadataKey:"learnings"},{enabled:options.clearFiles||options.replaceFiles,optionKey:"file",clearFlag:"--clear-files",valueFlag:"--file",values:options.file,metadataKey:"files"},{enabled:options.clearTests||options.replaceTests,optionKey:"test",clearFlag:"--clear-tests",valueFlag:"--test",values:options.test,metadataKey:"tests"},{enabled:options.clearDocs||options.replaceDocs,optionKey:"doc",clearFlag:"--clear-docs",valueFlag:"--doc",values:options.doc,metadataKey:"docs"},{enabled:options.clearReminders,optionKey:"reminder",clearFlag:"--clear-reminders",valueFlag:"--reminder",values:options.reminder,metadataKey:"reminders"},{enabled:options.clearEvents,optionKey:"event",clearFlag:"--clear-events",valueFlag:"--event",values:options.event,metadataKey:"events"},{enabled:options.clearTypeOptions,optionKey:"typeOption",clearFlag:"--clear-type-options",valueFlag:"--type-option",values:options.typeOption,metadataKey:"type_options"}]}function validateLinkedArtifactReplacement(params){if(params.enabled&&(!params.values||params.values.length===0))throw new PmCliError(`${params.replaceFlag} requires at least one ${params.valueFlag} entry`,EXIT_CODE.USAGE);if(params.enabled&&params.clearEnabled)throw new PmCliError(`${params.replaceFlag} cannot be combined with ${params.clearFlag}`,EXIT_CODE.USAGE)}function assertUpdateMutationOptionCombinations(options){const hasAdditiveAcceptanceCriteriaMutation=(options.addAc?.length??0)>0||(options.removeAc?.length??0)>0;if(options.acceptanceCriteria!==void 0&&hasAdditiveAcceptanceCriteriaMutation)throw new PmCliError("Cannot combine --acceptance-criteria replacement with --add-ac or --remove-ac. Use --remove-ac and --add-ac together for an atomic one-entry repair.",EXIT_CODE.USAGE,{code:"acceptance_criteria_mutation_conflict",reason:"replacement_and_additive_mutation_combined",nextSteps:["Use --acceptance-criteria alone to replace the complete list.","Use --remove-ac <old> --add-ac <new> to repair one criterion without replacing unrelated entries."]});if(options.replaceDeps===!0&&(options.dep===void 0||options.dep.length===0))throw new PmCliError("--replace-deps requires at least one --dep entry",EXIT_CODE.USAGE);if(options.replaceDeps===!0&&options.depRemove!==void 0&&options.depRemove.length>0)throw new PmCliError("--replace-deps cannot be combined with --dep-remove",EXIT_CODE.USAGE);validateLinkedArtifactReplacement({enabled:options.replaceTests===!0,values:options.test,replaceFlag:"--replace-tests",clearEnabled:options.clearTests===!0,clearFlag:"--clear-tests",valueFlag:"--test"}),validateLinkedArtifactReplacement({enabled:options.replaceFiles===!0,values:options.file,replaceFlag:"--replace-files",clearEnabled:options.clearFiles===!0,clearFlag:"--clear-files",valueFlag:"--file"}),validateLinkedArtifactReplacement({enabled:options.replaceDocs===!0,values:options.doc,replaceFlag:"--replace-docs",clearEnabled:options.clearDocs===!0,clearFlag:"--clear-docs",valueFlag:"--doc"})}function applyClearCollectionDefinitions(params){for(const definition of params.definitions){if(!definition.enabled)continue;const isReplacement=definition.optionKey==="dep"&&params.options.replaceDeps===!0||definition.optionKey==="test"&&params.options.replaceTests===!0||definition.optionKey==="file"&&params.options.replaceFiles===!0||definition.optionKey==="doc"&&params.options.replaceDocs===!0;if(definition.values&&definition.values.length>0&&!isReplacement)throw new PmCliError(`Cannot combine ${definition.clearFlag} with ${definition.valueFlag}`,EXIT_CODE.USAGE);params.clearOptionKeys.add(definition.optionKey),params.clearItemMetadataKeys.add(definition.metadataKey)}}function buildScalarOptionPresence(options){const presence={};for(const key of UPDATE_LEGACY_SCALAR_OPTION_KEYS)presence[String(key)]=options[key]!==void 0;return presence.order=options.order!==void 0||options.rank!==void 0,presence}function rejectUnsetScalarConflicts(options,unsetTargets){const scalarOptionPresence=buildScalarOptionPresence(options);for(const[optionKey,hasValue]of Object.entries(scalarOptionPresence)){if(!hasValue||!unsetTargets.optionKeys.has(optionKey))continue;const unsetField=UPDATE_OPTION_KEY_TO_UNSET_CANONICAL.get(optionKey)??optionKey;throw new PmCliError(`Cannot combine --unset ${unsetField} with ${commandOptionFlagLabel("update",optionKey)}`,EXIT_CODE.USAGE)}if(unsetTargets.metadataKeys.has("acceptance_criteria")){if(Array.isArray(options.addAc)&&options.addAc.length>0)throw new PmCliError("Cannot combine --unset acceptance-criteria with --add-ac",EXIT_CODE.USAGE);if(Array.isArray(options.removeAc)&&options.removeAc.length>0)throw new PmCliError("Cannot combine --unset acceptance-criteria with --remove-ac",EXIT_CODE.USAGE)}if(unsetTargets.metadataKeys.has("tags")){if(Array.isArray(options.addTags)&&options.addTags.length>0)throw new PmCliError("Cannot combine --unset tags with --add-tags",EXIT_CODE.USAGE);if(Array.isArray(options.removeTags)&&options.removeTags.length>0)throw new PmCliError("Cannot combine --unset tags with --remove-tags",EXIT_CODE.USAGE)}}function rejectLegacyScalarTokens(options){const assertNoLegacyScalarToken=(value,optionKey)=>{const unsetField=UPDATE_OPTION_KEY_TO_UNSET_CANONICAL.get(optionKey),hint=unsetField?`Use --unset ${unsetField} to clear this field.`:void 0;assertNoLegacyNoneToken(value,commandOptionFlagLabel("update",optionKey),hint)};for(const key of UPDATE_LEGACY_SCALAR_OPTION_KEYS)assertNoLegacyScalarToken(options[key],String(key));assertNoLegacyScalarToken(options.order??options.rank,"order"),assertNoLegacyNoneTokens(options.reminder,"--reminder","Use --clear-reminders to clear reminders."),assertNoLegacyNoneTokens(options.event,"--event","Use --clear-events to clear linked events.")}function buildUpdateFieldFlags(options,runtimeFieldUpdates){const flags={};for(const key of UPDATE_SIMPLE_FIELD_FLAG_KEYS)flags[String(key)]=options[key]!==void 0;return flags.tags=options.tags!==void 0,flags.addTags=Array.isArray(options.addTags)&&options.addTags.length>0,flags.removeTags=Array.isArray(options.removeTags)&&options.removeTags.length>0,flags.addAc=Array.isArray(options.addAc)&&options.addAc.length>0,flags.removeAc=Array.isArray(options.removeAc)&&options.removeAc.length>0,flags.order=options.order!==void 0,flags.rank=options.rank!==void 0,flags.replaceDeps=options.replaceDeps===!0,flags.replaceTests=options.replaceTests===!0,flags.replaceFiles=options.replaceFiles===!0,flags.replaceDocs=options.replaceDocs===!0,flags.unset=options.unset!==void 0&&options.unset.length>0,flags.clearDeps=options.clearDeps===!0,flags.clearComments=options.clearComments===!0,flags.clearNotes=options.clearNotes===!0,flags.clearLearnings=options.clearLearnings===!0,flags.clearFiles=options.clearFiles===!0,flags.clearTests=options.clearTests===!0,flags.clearDocs=options.clearDocs===!0,flags.clearReminders=options.clearReminders===!0,flags.clearEvents=options.clearEvents===!0,flags.clearTypeOptions=options.clearTypeOptions===!0,flags.documentAnnotationSnapshot=options.documentAnnotationSnapshot!==void 0,flags.runtimeFields=Object.keys(runtimeFieldUpdates).length>0,flags}async function buildNoopUpdateResult(params){const located=await locateItem(params.pmRoot,params.id,params.settings.id_prefix,params.settings.item_format,params.typeRegistry.type_to_folder);if(!located)throw await buildItemNotFoundError(params.pmRoot,params.id,params.settings.id_prefix,params.typeRegistry.type_to_folder);const{document}=await readLocatedItem(located,{schema:params.settings.schema});return{item:toItemRecord(document.metadata),changed_fields:[],warnings:["noop_no_update_fields"]}}async function loadUpdateRelationshipGraph(params){if(!(!params.fieldFlags.dep&&!params.fieldFlags.blockedBy&&!params.fieldFlags.parent&&!params.clearedMetadataKeys.has("parent")))return listAllItemMetadataLight(params.pmRoot,params.settings.item_format,params.typeToFolder,void 0,params.settings.schema)}function assertUpdateHierarchyIntegrity(params){params.before&&(assertNonHierarchyCardinalityMutationAllowed(params.before,params.before.map(item=>item.id===params.document.metadata.id?params.document.metadata:item)),assertHierarchyMutationAllowed(params.before,params.before.map(item=>item.id===params.document.metadata.id?params.document.metadata:item),params.document.metadata.id,status=>isTerminalStatus(status,params.statusRegistry),resolveWorkspaceRelationshipKindRegistry()))}function assertMatchingOrderRank(options){if(options.order!==void 0&&options.rank!==void 0&&options.order!==options.rank)throw new PmCliError("--order and --rank must match when both are provided",EXIT_CODE.USAGE)}async function resolveParentReferenceForUpdate(params){if(params.options.parent===void 0||params.unsetTargets.metadataKeys.has("parent"))return{resolvedParentValue:void 0,warnings:[]};const resolvedParentValue=normalizeItemReference(normalizeParentReferenceValue(params.options.parent),params.settings.id_prefix);if(isExternalDependencyReference(resolvedParentValue))return{resolvedParentValue,warnings:[]};if(assertParentReferenceIsNotSelf(params.id,resolvedParentValue,params.settings.id_prefix),await locateItem(params.pmRoot,resolvedParentValue,params.settings.id_prefix,params.settings.item_format,params.typeRegistry.type_to_folder))return{resolvedParentValue,warnings:[]};const normalizedParentId=normalizeItemId(resolvedParentValue,params.settings.id_prefix);return{resolvedParentValue,warnings:validateMissingParentReference(normalizedParentId,params.parentReferencePolicy).warnings}}function blockedByResolutionWarnings(resolution){return resolution.unresolved===void 0?[]:[`blocked_by_unresolved:${resolution.unresolved}`]}async function collectWorkflowTransitionWarnings(params){if(params.workflowEnforcement==="off"||params.typeWorkflows.length===0||!params.fieldFlags.status||params.options.status===void 0)return[];const located=await locateItem(params.pmRoot,params.id,params.settings.id_prefix,params.settings.item_format,params.typeRegistry.type_to_folder);if(!located)throw await buildItemNotFoundError(params.pmRoot,params.id,params.settings.id_prefix,params.typeRegistry.type_to_folder);const{document}=await readLocatedItem(located,{schema:params.settings.schema}),effectiveType=params.options.type!==void 0?resolveTypeName(params.options.type,params.typeRegistry)??params.options.type:document.metadata?.type??"",warning=enforceTypeWorkflowTransition({enforcement:params.workflowEnforcement,typeWorkflows:params.typeWorkflows,statusRegistry:params.statusRegistry,typeName:effectiveType,fromStatus:document.metadata?.status??"",toStatus:params.options.status});return warning?[warning]:[]}async function routeCloseStatusUpdate(context){if(!context.fieldFlags.status||normalizeStatusInput(context.options.status,context.statusRegistry)!==context.statusRegistry.close_status)return;const otherFieldKeys=Object.entries(context.fieldFlags).filter(([key,value])=>value&&key!=="status"&&key!=="closeReason"&&key!=="completedAt").map(([key])=>key),routeWarnings=[];let preChangedFields=[];if(otherFieldKeys.length>0){const preUpdateOptions=transferMutationStdinTokenPolicy(context.options,{...context.options,status:void 0,closeReason:void 0,message:void 0}),preUpdate=await runUpdate(context.id,preUpdateOptions,context.global);preChangedFields=preUpdate.changed_fields,routeWarnings.push(...preUpdate.warnings)}const closeResult=await runClose(context.id,context.options.closeReason,{author:context.options.author,message:context.options.message,force:context.options.force,completedAt:context.options.completedAt},context.global),warnings=[...context.workflowTransitionWarnings,...routeWarnings,...closeResult.warnings,"auto_routed_from_update_to_close"];return{item:closeResult.item,changed_fields:[...preChangedFields,...closeResult.changed_fields],warnings}}function applySimpleItemMutations(document,options,statusRegistry,changedFields){return options.title!==void 0&&(document.metadata.title=requireStringOption(options.title,"--title"),changedFields.push("title")),options.description!==void 0&&(document.metadata.description=options.description,changedFields.push("description")),options.body!==void 0&&(document.body=options.body,changedFields.push("body")),normalizeStatusInput(document.metadata.status,statusRegistry)??document.metadata.status}const TERMINAL_EVIDENCE_METADATA_KEYS=["closed_at","completed_at","close_reason","resolution","expected_result","actual_result","fixed_version"];function clearTerminalEvidence(metadata,changedFields){for(const key of TERMINAL_EVIDENCE_METADATA_KEYS)metadata[key]!==void 0&&(delete metadata[key],changedFields.push(key))}function applyStatusMutation(document,context,statusInput,previousStatusNormalized,changedFields){const status=parseStatus(statusInput,context.statusRegistry);if(document.metadata.status=status,changedFields.push("status"),status===context.statusRegistry.close_status&&(document.metadata.closed_at===void 0||document.metadata.closed_at===null)){document.metadata.closed_at=context.nowIso,document.metadata.completed_at=context.nowIso,changedFields.push("closed_at","completed_at");return}!isTerminalStatus(status,context.statusRegistry)&&isTerminalStatus(previousStatusNormalized,context.statusRegistry)&&clearTerminalEvidence(document.metadata,changedFields)}function applyStatusAndCompletionMutations(document,context,previousStatusNormalized,changedFields){if(context.options.status!==void 0&&applyStatusMutation(document,context,context.options.status,previousStatusNormalized,changedFields),context.options.completedAt!==void 0){if(!isTerminalStatus(document.metadata.status,context.statusRegistry))throw new PmCliError("--completed-at can only be set on a terminal item",EXIT_CODE.USAGE);document.metadata.completed_at=resolveIsoOrRelative(context.options.completedAt,new Date(context.nowIso),"completed-at"),changedFields.push("completed_at")}}function applyCloseReasonMutations(document,context,previousStatusNormalized,changedFields){if(context.options.closeReason!==void 0||context.clearItemMetadataKeys.has("close_reason")){if(context.clearItemMetadataKeys.has("close_reason"))delete document.metadata.close_reason;else{const closeReason=context.options.closeReason?.trim()??"";if(closeReason.length===0)throw new PmCliError("--close-reason must not be empty",EXIT_CODE.USAGE);document.metadata.close_reason=closeReason}changedFields.push("close_reason");return}context.options.status!==void 0&&isTerminalStatus(previousStatusNormalized,context.statusRegistry)&&!isTerminalStatus(document.metadata.status,context.statusRegistry)&&document.metadata.close_reason!==void 0&&(delete document.metadata.close_reason,changedFields.push("close_reason"))}function applyStatusAndCloseReasonMutations(document,context,previousStatusNormalized,changedFields){applyStatusAndCompletionMutations(document,context,previousStatusNormalized,changedFields),applyCloseReasonMutations(document,context,previousStatusNormalized,changedFields)}function applyPriorityTypeAndOptions(document,context,changedFields){let activeTypeName=resolveTypeName(document.metadata.type,context.typeRegistry)??document.metadata.type;if(context.options.priority!==void 0&&(document.metadata.priority=resolvePriority(context.options.priority),changedFields.push("priority")),context.options.type!==void 0){const resolvedTypeName=resolveTypeName(context.options.type,context.typeRegistry);if(!resolvedTypeName)throw new PmCliError(buildInvalidTypeError(context.options.type,context.typeRegistry.types,resolveItemTypesFilePath(context.pmRoot,context.settings.schema)),EXIT_CODE.USAGE);document.metadata.type=resolvedTypeName,activeTypeName=resolvedTypeName,changedFields.push("type")}return enforceUpdateOptionsByType(activeTypeName,context.options,context.typeRegistry,context.runtimeFieldRegistry,context.extensionFieldNames),applyTypeOptionMutation(document,context,activeTypeName,changedFields),activeTypeName}function applyTypeOptionMutation(document,context,activeTypeName,changedFields){if(context.options.typeOption!==void 0||context.clearItemMetadataKeys.has("type_options")){if(context.clearItemMetadataKeys.has("type_options"))delete document.metadata.type_options;else{const parsedTypeOptions=parseTypeOptionEntries(context.options.typeOption??[]),validation2=validateTypeOptions(activeTypeName,parsedTypeOptions,context.typeRegistry);if(validation2.errors.length>0)throw new PmCliError(validation2.errors.join("; "),EXIT_CODE.USAGE);document.metadata.type_options=validation2.normalized}changedFields.push("type_options");return}if(context.options.type===void 0||document.metadata.type_options===void 0)return;const validation=validateTypeOptions(activeTypeName,document.metadata.type_options,context.typeRegistry);if(validation.errors.length>0)throw new PmCliError(`Current type options are incompatible with type "${activeTypeName}". ${validation.errors.join("; ")}. Use --clear-type-options to clear them.`,EXIT_CODE.USAGE);document.metadata.type_options=validation.normalized}function normalizeTouchedDependencyIdentities(current,additions){const touchedKeys=new Set(additions.map(entry=>dependencyKey(entry))),retainedStoredIdentities=new Set;return current.filter(entry=>{if(!touchedKeys.has(dependencyKey(entry)))return!0;const storedIdentity=storedDependencyIdentityKey(entry);return retainedStoredIdentities.has(storedIdentity)?!1:(retainedStoredIdentities.add(storedIdentity),!0)})}function assertDependencyRemovalSelectorsMatch(current,selectors,itemId){const unmatchedSelectors=selectors.filter(selector=>!current.some(entry=>matchesDependencySelector(entry,selector)));if(unmatchedSelectors.length!==0)throw new PmCliError(`Dependency removal did not match ${unmatchedSelectors.length===1?"a stored edge":"stored edges"}.`,EXIT_CODE.NOT_FOUND,{code:"dependency_remove_no_match",reason:"selector_not_found",unmatched_selectors:unmatchedSelectors,available_dependencies:current.map(entry=>({id:entry.id,kind:entry.kind,source_kind:entry.source_kind,author:entry.author,created_at:entry.created_at})),why:"Failing on a zero-match selector prevents a mistyped dependency removal from being reported as successful.",nextSteps:[`Inspect the current item with: pm get ${itemId} --full`,"Retry --dep-remove with the exact id plus any kind, source_kind, author, or created_at selectors needed to identify one stored row."]})}function applyDependencyMutations(document,context,changedFields){if(context.options.dep===void 0&&context.options.depRemove===void 0&&!context.clearItemMetadataKeys.has("dependencies"))return;let nextDependencies=context.clearItemMetadataKeys.has("dependencies")?[]:[...document.metadata.dependencies??[]];if(context.dependencyUpdates.additions.length>0){nextDependencies=normalizeTouchedDependencyIdentities(nextDependencies,context.dependencyUpdates.additions);const seen=new Set(nextDependencies.map(entry=>dependencyKey(entry)));for(const addition of context.dependencyUpdates.additions){const key=dependencyKey(addition);seen.has(key)||(nextDependencies.push(addition),seen.add(key))}}context.dependencyRemovals.length>0&&(assertDependencyRemovalSelectorsMatch(nextDependencies,context.dependencyRemovals,document.metadata.id),nextDependencies=nextDependencies.filter(entry=>!context.dependencyRemovals.some(selector=>matchesDependencySelector(entry,selector)))),nextDependencies.length===0?delete document.metadata.dependencies:document.metadata.dependencies=nextDependencies,changedFields.push("dependencies")}function applyLogCollectionMutations(document,context,changedFields){applyLogCollectionMutation(document,"comments",context.options.comment,context.commentUpdates.values,context.clearItemMetadataKeys,changedFields),applyLogCollectionMutation(document,"notes",context.options.note,context.noteUpdates.values,context.clearItemMetadataKeys,changedFields),applyLogCollectionMutation(document,"learnings",context.options.learning,context.learningUpdates.values,context.clearItemMetadataKeys,changedFields)}function applyLogCollectionMutation(document,key,optionValue,values,clearItemMetadataKeys,changedFields){optionValue===void 0&&!clearItemMetadataKeys.has(key)||(clearItemMetadataKeys.has(key)||!values||values.length===0?delete document.metadata[key]:document.metadata[key]=[...document.metadata[key]??[],...values],changedFields.push(key))}function applyEvidenceCollectionMutations(document,context,changedFields){applyUniqueLinkedCollectionMutation(document,"files",context.options.file,context.fileUpdates.values,fileKey,context.options.replaceFiles===!0,context.clearItemMetadataKeys,changedFields),applyTestCollectionMutation(document,context,changedFields),applyUniqueLinkedCollectionMutation(document,"docs",context.options.doc,context.docUpdates.values,docKey,context.options.replaceDocs===!0,context.clearItemMetadataKeys,changedFields)}function applyUniqueLinkedCollectionMutation(document,key,optionValue,values,keyOf,replace,clearItemMetadataKeys,changedFields){if(!(optionValue===void 0&&!clearItemMetadataKeys.has(key))){if(replace)document.metadata[key]=values;else if(clearItemMetadataKeys.has(key)||!values||values.length===0)delete document.metadata[key];else{const next=[...document.metadata[key]??[]],seen=new Set(next.map(entry=>keyOf(entry)));for(const entry of values){const keyValue=keyOf(entry);seen.has(keyValue)||(next.push(entry),seen.add(keyValue))}document.metadata[key]=next}changedFields.push(key)}}function applyTestCollectionMutation(document,context,changedFields){context.options.test===void 0&&!context.clearItemMetadataKeys.has("tests")||(context.clearItemMetadataKeys.has("tests")&&context.options.replaceTests===!0?document.metadata.tests=dedupeLinkedTests(context.testUpdates.values)??[]:context.clearItemMetadataKeys.has("tests")||!context.testUpdates.values||context.testUpdates.values.length===0?delete document.metadata.tests:document.metadata.tests=dedupeLinkedTests([...document.metadata.tests??[],...context.testUpdates.values]),document.metadata.tests!==void 0&&document.metadata.tests.length===0&&delete document.metadata.tests,changedFields.push("tests"))}function dedupeLinkedTests(values){if(!values||values.length===0)return;const next=[],seen=new Set;for(const entry of values){const key=testKey(entry);seen.has(key)||(next.push(entry),seen.add(key))}return next}function applyTagsAndPlanningMutations(document,context,scalarMutationContext){const addTagsValues=context.options.addTags,removeTagsValues=context.options.removeTags,hasAdditiveTagMutation=Array.isArray(addTagsValues)&&addTagsValues.length>0||Array.isArray(removeTagsValues)&&removeTagsValues.length>0;if(context.options.tags!==void 0||context.clearItemMetadataKeys.has("tags")||hasAdditiveTagMutation){const baseTags=context.clearItemMetadataKeys.has("tags")?[]:context.options.tags!==void 0?parseTags(context.options.tags):Array.isArray(document.metadata.tags)?[...document.metadata.tags]:[];document.metadata.tags=applyTagRemovals(mergeAdditiveTags(baseTags,addTagsValues),removeTagsValues),scalarMutationContext.changedFields.push("tags")}applyUpdateScalarMutations(UPDATE_POST_TAG_SCALAR_MUTATIONS,context.options,scalarMutationContext),applyOrderMutation(document,context,scalarMutationContext.changedFields)}function applyAcceptanceCriteriaAdditiveMutation(document,context,scalarMutationContext){const addValues=context.options.addAc,removeValues=context.options.removeAc;if(!(Array.isArray(addValues)&&addValues.length>0)&&!(Array.isArray(removeValues)&&removeValues.length>0))return;const mutation=applyAcceptanceCriteriaMutations(splitAcceptanceCriteria(document.metadata.acceptance_criteria),addValues,removeValues);if(mutation.unmatchedRemovals.length>0)throw new PmCliError(`Acceptance criteria removal did not match: ${mutation.unmatchedRemovals.join(", ")}`,EXIT_CODE.NOT_FOUND,{code:"acceptance_criteria_remove_unmatched",reason:"exact_match_not_found",field:"acceptance_criteria",unmatched:mutation.unmatchedRemovals,why:"Lossless removal fails instead of silently applying the remaining mutations when an exact selector is wrong.",nextSteps:["Read the current acceptance_criteria value and retry with the exact criterion text.","Use --acceptance-criteria alone only when replacing the complete list is intentional."]});const nextValue=mutation.criteria.join("; ");document.metadata.acceptance_criteria!==nextValue&&(nextValue===""&&document.metadata.acceptance_criteria===void 0||(document.metadata.acceptance_criteria=nextValue,scalarMutationContext.changedFields.includes("acceptance_criteria")||scalarMutationContext.changedFields.push("acceptance_criteria")))}function applyOrderMutation(document,context,changedFields){const orderRaw=context.options.order??context.options.rank;if(!(orderRaw===void 0&&!context.clearItemMetadataKeys.has("order"))){if(context.clearItemMetadataKeys.has("order"))delete document.metadata.order;else{const parsedOrder=parseOptionalNumber(orderRaw??"","order");if(!Number.isInteger(parsedOrder))throw new PmCliError("Order must be an integer",EXIT_CODE.USAGE);document.metadata.order=parsedOrder}changedFields.push("order")}}function applyOwnershipAndIssueMutations(document,context,scalarMutationContext,warnings){applyAssigneeMutation(document,context,scalarMutationContext.changedFields),applyParentMutation(document,context,scalarMutationContext.changedFields),applyUpdateScalarMutations(UPDATE_STAKEHOLDER_SCALAR_MUTATIONS,context.options,scalarMutationContext),applySprintReleaseMutation(document,context,"sprint",warnings,scalarMutationContext.changedFields),applySprintReleaseMutation(document,context,"release",warnings,scalarMutationContext.changedFields),applyBlockedByMutation(document,context,scalarMutationContext.changedFields),applyUpdateScalarMutations(UPDATE_ISSUE_SCALAR_MUTATIONS,context.options,scalarMutationContext)}function applyAssigneeMutation(document,context,changedFields){if(!(context.options.assignee===void 0&&!context.clearItemMetadataKeys.has("assignee"))){if(context.clearItemMetadataKeys.has("assignee"))delete document.metadata.assignee;else{const assignee=context.options.assignee?.trim()??"";if(assignee==="")throw new PmCliError("--assignee must not be empty. Use --unset assignee to clear it.",EXIT_CODE.USAGE);document.metadata.assignee=assignee}changedFields.push("assignee")}}function applyParentMutation(document,context,changedFields){context.options.parent===void 0&&!context.clearItemMetadataKeys.has("parent")||(context.clearItemMetadataKeys.has("parent")?delete document.metadata.parent:document.metadata.parent=context.resolvedParentValue??"",changedFields.push("parent"))}function applySprintReleaseMutation(document,context,key,warnings,changedFields){if(!(context.options[key]===void 0&&!context.clearItemMetadataKeys.has(key))){if(context.clearItemMetadataKeys.has(key))delete document.metadata[key];else{const validation=validateSprintOrReleaseValue(key,context.options[key]??"",context.settings.validation.sprint_release_format);document.metadata[key]=validation.value,warnings.push(...validation.warnings)}changedFields.push(key)}}function applyBlockedByMutation(document,context,changedFields){context.options.blockedBy===void 0&&!context.clearItemMetadataKeys.has("blocked_by")||(context.clearItemMetadataKeys.has("blocked_by")?delete document.metadata.blocked_by:document.metadata.blocked_by=context.options.blockedBy?.trim()??"",changedFields.push("blocked_by"),(context.clearItemMetadataKeys.has("blocked_by")||context.resolvedBlockedByDependencyId!==void 0)&&applyBlockedByDependencyEdge(document.metadata,context.resolvedBlockedByDependencyId,context.nowIso,context.author,changedFields))}function applyScheduleMutations(document,context,changedFields){(context.options.reminder!==void 0||context.clearItemMetadataKeys.has("reminders"))&&(context.clearItemMetadataKeys.has("reminders")?delete document.metadata.reminders:document.metadata.reminders=parseReminderEntries(context.options.reminder??[],context.nowValue,{valueMode:"trimmed"}),changedFields.push("reminders")),(context.options.event!==void 0||context.clearItemMetadataKeys.has("events"))&&(context.clearItemMetadataKeys.has("events")?delete document.metadata.events:document.metadata.events=parseEventEntries(context.options.event??[],context.nowValue,{allDayEmptyGuard:"truthy",recurrenceEmptyNumericGuard:"truthy"}),changedFields.push("events"))}function applyRuntimeAndRegisteredFieldMutations(metadataRecord,context,changedFields){clearDynamicFields(metadataRecord,context.runtimeFieldRegistry.definitions.map(definition=>definition.metadata_key),context.clearItemMetadataKeys,changedFields),clearDynamicFields(metadataRecord,context.extensionFieldNames,context.clearItemMetadataKeys,changedFields);for(const[fieldKey,fieldValue]of Object.entries(context.runtimeFieldUpdates)){if(context.clearItemMetadataKeys.has(fieldKey)){const fieldFlag=fieldKey.replaceAll("_","-"),updateFlag=context.runtimeFieldRegistry.definitions.find(candidate=>candidate.metadata_key===fieldKey)?.cli_flag??fieldFlag;throw new PmCliError(`Cannot combine --unset ${fieldFlag} with --${updateFlag}`,EXIT_CODE.USAGE)}stableValueEquals(metadataRecord[fieldKey],fieldValue)||(metadataRecord[fieldKey]=fieldValue,changedFields.push(fieldKey))}const registeredItemFieldUpdates=parseRegisteredItemFieldAssignments(context.options.field,context.extensionRegistrations,resolveCoreFieldRecovery);for(const fieldKey of Object.keys(registeredItemFieldUpdates))if(context.clearItemMetadataKeys.has(fieldKey))throw new PmCliError(`Cannot combine --unset ${fieldKey.replaceAll("_","-")} with --field ${fieldKey}=...`,EXIT_CODE.USAGE);for(const[fieldKey,fieldValue]of Object.entries(registeredItemFieldUpdates))stableValueEquals(metadataRecord[fieldKey],fieldValue)||(metadataRecord[fieldKey]=fieldValue,changedFields.push(fieldKey))}function clearDynamicFields(metadataRecord,fieldKeys,clearItemMetadataKeys,changedFields){for(const fieldKey of fieldKeys)!clearItemMetadataKeys.has(fieldKey)||metadataRecord[fieldKey]===void 0||(delete metadataRecord[fieldKey],changedFields.push(fieldKey))}function assertPersistedAnnotationSnapshot(document,snapshot){if(snapshot===void 0)return;const current=toItemRecord(document.metadata),key=["comments","notes","learnings"].find(field=>{const submitted=snapshot[field];return submitted!==void 0&&(!Array.isArray(submitted)||!stableValueEquals(submitted,current[field]??[]))});if(key!==void 0)throw new PmCliError(`Full-item --stdin-json update changed persisted ${key}; no item fields were written.`,EXIT_CODE.USAGE,{code:"stdin_json_persisted_annotation_changed",reason:`${key}_requires_annotation_command`,required:`Use pm ${key} ${document.metadata.id} --edit <index> --add <text> to correct an existing entry.`,why:"Full-item update appends new annotations but cannot replace or remove existing audit entries.",nextSteps:[`Inspect the current ${key} with pm ${key} ${document.metadata.id}.`,`Apply the correction with pm ${key} ${document.metadata.id} --edit <index> --add <text>.`]})}function mutateUpdateDocument(document,context){assertPersistedAnnotationSnapshot(document,context.options.documentAnnotationSnapshot);const beforeMetadata=structuredClone(toItemRecord(document.metadata)),beforeBody=document.body,changedFields=[],warnings=[],previousStatusNormalized=applySimpleItemMutations(document,context.options,context.statusRegistry,changedFields),metadataRecord=toItemRecord(document.metadata),scalarMutationContext={metadataRecord,clearItemMetadataKeys:context.clearItemMetadataKeys,changedFields,nowValue:context.nowValue};applyStatusAndCloseReasonMutations(document,context,previousStatusNormalized,changedFields),applyPriorityTypeAndOptions(document,context,changedFields),applyDependencyMutations(document,context,changedFields),applyLogCollectionMutations(document,context,changedFields),applyEvidenceCollectionMutations(document,context,changedFields),applyTagsAndPlanningMutations(document,context,scalarMutationContext),applyAcceptanceCriteriaAdditiveMutation(document,context,scalarMutationContext),applyOwnershipAndIssueMutations(document,context,scalarMutationContext,warnings),(context.options.dep!==void 0||context.options.depRemove!==void 0||context.options.blockedBy!==void 0||context.clearItemMetadataKeys.has("dependencies")||context.clearItemMetadataKeys.has("blocked_by"))&&assertDependencyEdgesAllowed(document.metadata.id,document.metadata.dependencies),normalizeStatusInput(document.metadata.status,context.statusRegistry)===context.statusRegistry.canceled_status&&document.metadata.assignee!==void 0&&(delete document.metadata.assignee,changedFields.includes("assignee")||changedFields.push("assignee")),applyScheduleMutations(document,context,changedFields),applyRuntimeAndRegisteredFieldMutations(metadataRecord,context,changedFields);try{applyRegisteredItemFieldDefaultsAndValidation(metadataRecord,context.extensionRegistrations,{skipDefaultFields:context.clearItemMetadataKeys})}catch(error){throw new PmCliError(error instanceof Error?error.message:"Invalid extension item field values",EXIT_CODE.USAGE)}const afterMetadata=toItemRecord(document.metadata),actualChangedFields=[...new Set(changedFields)].filter(field=>field==="body"?document.body!==beforeBody:!stableValueEquals(beforeMetadata[field],afterMetadata[field]));return context.options.acceptanceCriteria!==void 0&&actualChangedFields.includes("acceptance_criteria")&&warnings.push(`acceptance_criteria_replaced:${splitAcceptanceCriteria(beforeMetadata.acceptance_criteria).length}:${splitAcceptanceCriteria(afterMetadata.acceptance_criteria).length}`),{changedFields:actualChangedFields,warnings}}async function runUpdateWithContext(id,options,global2,execution={}){options=await resolveUpdateTransportOptions(options);const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot),statusRegistry=resolveRuntimeStatusRegistry(settings.schema),runtimeFieldRegistry=resolveRuntimeFieldRegistry(settings.schema),extensionRegistrations=getActiveExtensionRegistrations(),extensionFieldNames=collectRegisteredItemFieldNames(extensionRegistrations),typeRegistry=resolveItemTypeRegistry(settings,extensionRegistrations),workflowEnforcement=settings.governance.workflow_enforcement??"off",typeWorkflows=workflowEnforcement==="off"?[]:resolveTypeWorkflows(settings.schema),parentReferencePolicy=[{strict_error:"strict_error",warn:"warn",off:"off"},{strict_error:"warn",warn:"warn",off:"off"}][+(options.allowMissingParent===!0)][settings.validation.parent_reference],unsetTargets=parseUpdateUnsetTargets(options.unset,runtimeFieldRegistry,extensionFieldNames),clearOptionKeys=new Set(unsetTargets.optionKeys),clearItemMetadataKeys=new Set(unsetTargets.metadataKeys);assertUpdateMutationOptionCombinations(options),applyClearCollectionDefinitions({definitions:buildClearCollectionDefinitions(options),options,clearOptionKeys,clearItemMetadataKeys}),enforceOwnershipBypassScope(id,options,clearItemMetadataKeys),rejectUnsetScalarConflicts(options,unsetTargets),rejectLegacyScalarTokens(options);const author=resolveAuthor(options.author,settings.author_default),nowValue=new Date,nowIso=nowValue.toISOString(),dependencyUpdates=parseDependencyAdditions(options.dep,settings.id_prefix,nowIso,author);assertDependencyEdgesAllowed(id,dependencyUpdates.additions);const dependencyTargetWarnings=await assertDependencyTargetsResolvable({pmRoot,dependencies:dependencyUpdates.additions,idPrefix:settings.id_prefix,itemFormat:settings.item_format,typeToFolder:typeRegistry.type_to_folder,allowUnresolved:options.allowUnresolvedDeps,holders:[{id}],schema:settings.schema}),dependencyRemovals=parseDependencyRemovals(options.depRemove,settings.id_prefix),parsedCommentUpdates=parseLogSeed("--comment",options.comment,nowIso,author),commentUpdates=options.ownershipMetadataBypass===!0&&parsedCommentUpdates.values?{...parsedCommentUpdates,values:parsedCommentUpdates.values.map(entry=>({...entry,author}))}:parsedCommentUpdates,noteUpdates=parseLogSeed("--note",options.note,nowIso,author),learningUpdates=parseLogSeed("--learning",options.learning,nowIso,author),fileUpdates=parseFiles(options.file),testUpdates=parseTests(options.test);testUpdates.values=await attachLinkedTestMutationProvenance(testUpdates.values,author,nowIso);const docUpdates=parseDocs(options.doc),workflowTransitionWarnings=[],parentReference=await resolveParentReferenceForUpdate({id,options,unsetTargets,pmRoot,settings,typeRegistry,parentReferencePolicy}),blockedByResolution=await resolveBlockedByDependencyTarget(options.blockedBy,clearItemMetadataKeys.has("blocked_by"),pmRoot,settings.id_prefix,settings.item_format,typeRegistry.type_to_folder),resolvedBlockedByDependencyId=blockedByResolution.id,parentReferenceWarnings=[...parentReference.warnings,...blockedByResolutionWarnings(blockedByResolution)],runtimeFieldUpdates=collectRuntimeUpdateFieldValues(options,runtimeFieldRegistry,options.runtimeFieldCommands),fieldFlags=buildUpdateFieldFlags(options,runtimeFieldUpdates);if(!Object.values(fieldFlags).some(Boolean))return buildNoopUpdateResult({pmRoot,id,settings,typeRegistry});workflowTransitionWarnings.push(...await collectWorkflowTransitionWarnings({options,fieldFlags,workflowEnforcement,typeWorkflows,statusRegistry,typeRegistry,pmRoot,id,settings}));const routedClose=await routeCloseStatusUpdate({options,fieldFlags,statusRegistry,workflowTransitionWarnings,global:global2,id});if(routedClose)return routedClose;assertMatchingOrderRank(options);const relationshipRegistry=resolveWorkspaceRelationshipKindRegistry(),hierarchyMutationRequired=fieldFlags.parent&&!clearItemMetadataKeys.has("parent")||dependencyUpdates.additions.some(dependency=>relationshipKindNeedsIntegrityLock(dependency.kind,relationshipRegistry)),releaseHierarchyMutationLock=await acquireHierarchyMutationLock({pmRoot,author,ttlSeconds:settings.locks.ttl_seconds,waitMs:settings.locks.wait_ms,required:hierarchyMutationRequired});try{let graphBeforeUpdate=await loadUpdateRelationshipGraph({fieldFlags,clearedMetadataKeys:clearItemMetadataKeys,pmRoot,settings,typeToFolder:typeRegistry.type_to_folder}),lifecycleTransition,recurrenceHistoryContext;const result=await mutateItemWithHistoryContextResolver({pmRoot,settings,typeToFolder:typeRegistry.type_to_folder,id,op:resolveUpdateHistoryOperation(options,execution),author,message:options.message,resolveHistoryContext:()=>recurrenceHistoryContext,force:options.force,bypassAssigneeConflict:options.ownershipMetadataBypass===!0||options.ownershipDependencyBypass===!0,extensionFieldNames,skipNoop:!0,mutate(document){lifecycleTransition=prepareRecurrenceTransition({document,recurrenceReason:execution.recurrenceReason,requestedStatus:options.status,statusRegistry}),recurrenceHistoryContext=lifecycleTransition?{recurrence:lifecycleTransition}:void 0,graphBeforeUpdate=graphBeforeUpdate?.map(item=>item.id===document.metadata.id?structuredClone(document.metadata):item);const mutation=mutateUpdateDocument(document,{options,settings,typeRegistry,statusRegistry,runtimeFieldRegistry,extensionRegistrations,extensionFieldNames,clearItemMetadataKeys,dependencyUpdates,dependencyRemovals,commentUpdates,noteUpdates,learningUpdates,fileUpdates,testUpdates,docUpdates,resolvedParentValue:parentReference.resolvedParentValue,resolvedBlockedByDependencyId,runtimeFieldUpdates,nowValue,nowIso,author,pmRoot});return assertUpdateHierarchyIntegrity({before:graphBeforeUpdate,document,statusRegistry}),mutation}});await releaseHierarchyMutationLock();const orderingCycleWarnings=graphBeforeUpdate?collectNewOrderingCycleWarnings(graphBeforeUpdate,graphBeforeUpdate.map(item=>item.id===result.item.id?result.item:item),result.item.id):[];return{item:toItemRecord(result.item),changed_fields:result.changedFields,warnings:[...workflowTransitionWarnings,...parentReferenceWarnings,...dependencyTargetWarnings,...orderingCycleWarnings,...result.warnings],...lifecycleTransition===void 0?{}:{lifecycle_transition:lifecycleTransition}}}finally{await releaseHierarchyMutationLock()}}function resolveUpdateHistoryOperation(options,execution){return options.ownershipMetadataBypass===!0||options.ownershipDependencyBypass===!0?"update_ownership_bypass":execution.recurrenceReason===void 0?"update":"reopen"}function prepareRecurrenceTransition(params){if(params.recurrenceReason===void 0)return;const fromStatus=normalizeStatusInput(params.document.metadata.status,params.statusRegistry)??params.document.metadata.status;if(!isTerminalStatus(fromStatus,params.statusRegistry))throw new PmCliError(`Item ${params.document.metadata.id} is already active with status ${fromStatus}; recurrence transitions require a terminal item.`,EXIT_CODE.CONFLICT,{code:"item_already_active",reason:"recurrence_requires_terminal_item",required:"Use item reopen only for a terminal item whose work has recurred.",why:"Appending a recurrence event to active work would corrupt lifecycle history.",recovery:{suggested_retry:`pm get ${params.document.metadata.id} --full`,suggested_retry_args:["get",params.document.metadata.id,"--full"]},nextSteps:[`Inspect the active item with: pm get ${params.document.metadata.id} --full`,`Continue the existing work with: pm update ${params.document.metadata.id} ...`]});const requestedStatus=params.requestedStatus??params.statusRegistry.open_status,toStatus=normalizeStatusInput(requestedStatus,params.statusRegistry)??requestedStatus,metadata=toItemRecord(params.document.metadata),previousTerminal=Object.fromEntries(["close_reason","resolution","expected_result","actual_result","fixed_version"].flatMap(key=>{const value=metadata[key];return typeof value=="string"?[[key,value]]:[]}));return{reason:params.recurrenceReason,from_status:fromStatus,to_status:toStatus,previous_terminal:previousTerminal}}async function runUpdate(id,options,global2){return runUpdateWithContext(id,options,global2)}async function runReopenUpdate(id,options,global2,recurrenceReason){const result=await runUpdateWithContext(id,options,global2,{recurrenceReason});if(result.lifecycle_transition===void 0)throw new PmCliError(`Item ${id} did not produce the required recurrence receipt.`,EXIT_CODE.GENERIC_FAILURE,{code:"reopen_receipt_missing",reason:"recurrence_transition_not_recorded",required:"A successful reopen must return the terminal-to-active lifecycle transition recorded in immutable history."});return{...result,lifecycle_transition:result.lifecycle_transition}}const _testOnlyUpdateCommand={applyStatusAndCloseReasonMutations,collectProvidedUpdatePolicyOptions,buildOwnershipBypassRestrictedOptionsError,enforceOwnershipBypassScope,enforceTypeWorkflowTransition,matchesDependencySelector,normalizeLegacyNoneUpdateOptions,normalizeUpdatePolicyOptionKey,parseDependencyAdditions,parseDependencyRemovals,parseUpdateUnsetTargets,reconcileBlockedByDependency,resolveRuntimeUnsetDefinition:(token,registry)=>resolveRuntimeUnsetFieldDefinition(token,"update",registry)};export{_testOnlyUpdateCommand,assertUpdateMutationOptionCombinations,parseDependencyAdditions,resolveUpdateTransportOptions,runReopenUpdate,runUpdate};
 //# sourceMappingURL=update.js.map

package/dist/sdk/lifecycle-completion.d.ts

@@ -8,36 +8,36 @@ import type { HistoryEntry, ItemMetadata } from "../types/index.js";
 export type CompletionTimestampSource = "completed_at" | "closed_at" | "updated_at";
 /** A resolved completion timestamp together with its explicit compatibility source. */
 export interface ResolvedCompletionTimestamp {
-    /** Discriminator proving that timestamp and source are present. */
-    resolved: true;
-    /** ISO timestamp selected for reporting. */
-    timestamp: string;
-    /** Metadata field that supplied the timestamp. */
-    source: CompletionTimestampSource;
-    /** Whether a legacy fallback was required. */
-    fallback: boolean;
+/** Discriminator proving that timestamp and source are present. */
+resolved: true;
+/** ISO timestamp selected for reporting. */
+timestamp: string;
+/** Metadata field that supplied the timestamp. */
+source: CompletionTimestampSource;
+/** Whether a legacy fallback was required. */
+fallback: boolean;
 }
 /** Explicit outcome when legacy metadata contains no completion timestamp. */
 export interface UnresolvedCompletionTimestamp {
-    /** Discriminator proving that no metadata field supplied a timestamp. */
-    resolved: false;
-    /** Resolved-only timestamp is impossible on this branch. */
-    timestamp?: never;
-    /** Resolved-only provenance is impossible on this branch. */
-    source?: never;
-    /** Fallback disclosure is meaningful only after a field supplied a value. */
-    fallback?: never;
+/** Discriminator proving that no metadata field supplied a timestamp. */
+resolved: false;
+/** Resolved-only timestamp is impossible on this branch. */
+timestamp?: never;
+/** Resolved-only provenance is impossible on this branch. */
+source?: never;
+/** Fallback disclosure is meaningful only after a field supplied a value. */
+fallback?: never;
 }
 /** Exhaustive completion-time resolution result. */
 export type CompletionTimestampResolution = ResolvedCompletionTimestamp | UnresolvedCompletionTimestamp;
 /** One lossless backfill supported by terminal-transition history evidence. */
 export interface CompletedAtBackfillCandidate {
-    /** Item whose missing completed_at can be corrected. */
-    id: string;
-    /** Evidence-backed timestamp proposed for completed_at. */
-    completed_at: string;
-    /** History operation that recorded the terminal transition. */
-    history_op: string;
+/** Item whose missing completed_at can be corrected. */
+id: string;
+/** Evidence-backed timestamp proposed for completed_at. */
+completed_at: string;
+/** History operation that recorded the terminal transition. */
+history_op: string;
 }
 /** Resolve reporting time while disclosing every legacy fallback. */
 export declare function resolveCompletionTimestamp(item: Partial<Pick<ItemMetadata, "completed_at" | "closed_at" | "updated_at">>): CompletionTimestampResolution;

package/dist/sdk/lifecycle-policy.d.ts

@@ -4,76 +4,76 @@ import type { ItemMetadata } from "../types/index.js";
 export type TerminalReasonSource = "explicit" | "duplicate" | "resolution" | "message" | "none";
 /** Controls lifecycle semantics independently of CLI flag parsing. */
 export interface TerminalTransitionPolicy {
-    /** Refuse terminal transitions that do not carry an author-controlled reason. */
-    requireCloseReason: boolean;
-    /** Decide whether predecessor edges remain queryable after terminal transition. */
-    orderingEdges: "preserve" | "remove";
+/** Refuse terminal transitions that do not carry an author-controlled reason. */
+requireCloseReason: boolean;
+/** Decide whether predecessor edges remain queryable after terminal transition. */
+orderingEdges: "preserve" | "remove";
 }
 /** Presentation-independent options for the public close-item operation. */
 export interface CloseOperationOptions {
-    /** Author recorded in immutable history. */
-    author?: string;
-    /** Human-readable history message. */
-    message?: string;
-    /** Closure validation mode. */
-    validateClose?: string;
-    /** Permit an intentional repeat terminal transition. */
-    force?: boolean;
-    /** Structured resolution evidence. */
-    resolution?: string;
-    /** Expected outcome evidence. */
-    expectedResult?: string;
-    /** Actual outcome evidence. */
-    actualResult?: string;
-    /** Canonical item when closing a duplicate. */
-    duplicateOf?: string;
-    /** Actual completion time, distinct from tracker mutation time. */
-    completedAt?: string;
-    /** SDK-only lifecycle overrides; CLI and MCP use workspace defaults. */
-    lifecyclePolicy?: Partial<TerminalTransitionPolicy>;
+/** Author recorded in immutable history. */
+author?: string;
+/** Human-readable history message. */
+message?: string;
+/** Closure validation mode. */
+validateClose?: string;
+/** Permit an intentional repeat terminal transition. */
+force?: boolean;
+/** Structured resolution evidence. */
+resolution?: string;
+/** Expected outcome evidence. */
+expectedResult?: string;
+/** Actual outcome evidence. */
+actualResult?: string;
+/** Canonical item when closing a duplicate. */
+duplicateOf?: string;
+/** Actual completion time, distinct from tracker mutation time. */
+completedAt?: string;
+/** SDK-only lifecycle overrides; CLI and MCP use workspace defaults. */
+lifecyclePolicy?: Partial<TerminalTransitionPolicy>;
 }
 /** Result returned by the public close-item operation. */
 export interface CloseOperationResult {
-    /** Closed item projected as a stable record. */
-    item: Record<string, unknown>;
-    /** Metadata fields changed by the transition. */
-    changed_fields: string[];
-    /** Evidence-only update guidance when a successful warning close leaves acceptance fields missing. */
-    recovery?: PmCliErrorRecoveryPayload;
-    /** Validation and lifecycle policy receipts. */
-    warnings: string[];
+/** Closed item projected as a stable record. */
+item: Record<string, unknown>;
+/** Metadata fields changed by the transition. */
+changed_fields: string[];
+/** Evidence-only update guidance when a successful warning close leaves acceptance fields missing. */
+recovery?: PmCliErrorRecoveryPayload;
+/** Validation and lifecycle policy receipts. */
+warnings: string[];
 }
 /** Candidate author-controlled sources for one terminal transition reason. */
 export interface TerminalReasonInput {
-    /** Explicit reason supplied by the operation caller. */
-    explicit?: string;
-    /** Canonical item id when this transition closes a duplicate. */
-    duplicateOf?: string;
-    /** Structured resolution supplied by the caller. */
-    resolution?: string;
-    /** History message supplied by the caller. */
-    message?: string;
+/** Explicit reason supplied by the operation caller. */
+explicit?: string;
+/** Canonical item id when this transition closes a duplicate. */
+duplicateOf?: string;
+/** Structured resolution supplied by the caller. */
+resolution?: string;
+/** History message supplied by the caller. */
+message?: string;
 }
 /** Resolved terminal reason together with durable source provenance. */
 export interface TerminalReasonResolution {
-    /** Normalized author-controlled reason, if one was supplied. */
-    closeReason?: string;
-    /** Field that supplied the resolved reason. */
-    source: TerminalReasonSource;
+/** Normalized author-controlled reason, if one was supplied. */
+closeReason?: string;
+/** Field that supplied the resolved reason. */
+source: TerminalReasonSource;
 }
 /** Presentation context used to make terminal-policy recovery actionable. */
 export interface TerminalReasonRecoveryContext {
-    /** Operation whose input failed terminal-reason governance. */
-    operation: "close" | "create";
-    /** Terminal status requested by a create operation. */
-    status?: string;
+/** Operation whose input failed terminal-reason governance. */
+operation: "close" | "create";
+/** Terminal status requested by a create operation. */
+status?: string;
 }
 /** Result of applying ordering-edge lifecycle policy to mutable item metadata. */
 export interface TerminalOrderingMutation {
-    /** Metadata fields changed by the policy. */
-    changedFields: string[];
-    /** Agent-readable policy receipts emitted by the operation. */
-    warnings: string[];
+/** Metadata fields changed by the policy. */
+changedFields: string[];
+/** Agent-readable policy receipts emitted by the operation. */
+warnings: string[];
 }
 /** Default terminal policy shared by CLI, SDK, and MCP operations. */
 export declare const DEFAULT_TERMINAL_TRANSITION_POLICY: Readonly<TerminalTransitionPolicy>;