@unbrained/pm-cli 2026.9.8 → 2026.9.9

package/dist/sdk/lifecycle/restore.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0f22715f-cfb9-5c75-b4c5-e9719416c2b9")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import jsonPatch from"fast-json-patch";import fs from"node:fs/promises";import{readLocatedItemSnapshot}from"../../core/store/item-store.js";import{readHistorySnapshot}from"../../core/history/read.js";import{verifyHistoryRewriteNoDrift}from"../../core/history/history-rewrite.js";import{resolveHistorySubject}from"../history/subject.js";import{historyVersionOffset}from"../../core/history/version-address.js";import{writeFileAtomic,appendHistoryEntry,createHistoryEntry,replayToCanonicalItemDocument,replayToItemDocument,toReplayDocument,enforceHistoryStreamPolicyForItem,canonicalDocument,serializeItemDocument,resolveItemTypeRegistry,acquireLock,EXIT_CODE,PmCliError,nowIso,getActiveExtensionRegistrations,projectAfterCommandItemSnapshot,recordAfterCommandAffectedItem,runActiveOnWriteHooks,runActiveBeforeMutationHooks,createMutationGuardSdk,getItemPath,resolvePmRoot,readSettings,resolveAuthor}from"../runtime-primitives.js";import{applyHistoryPatch,ensureMaterializedHistoryTarget as ensureMaterializedRestoreTarget,extractPatchFailureContext,replayHistoryToTarget as replayToTarget,resolveHistoryTarget}from"../history-read.js";import{acquireItemMetadataDerivedIndexLock,refreshItemMetadataDerivedIndex}from"../item-metadata-index.js";async function readRestoreItem(located,settings,history){const snapshot=await readLocatedItemSnapshot(located,{schema:settings.schema});return snapshot.error===null?{raw:snapshot.raw,document:snapshot.document}:{raw:snapshot.raw,document:replayCurrentDocument(history),recovered:true}}function ensureReplayTarget(target,history){return resolveHistoryTarget(target,history,{errorSubject:"restore",allowFutureTimestamp:true})}function replayCurrentDocument(history){const currentReplay=replayToTarget(history,history.length-1);if(Object.keys(currentReplay.metadata).length===0){return{metadata:{},body:currentReplay.body}}return canonicalDocument(replayToItemDocument(currentReplay))}async function resolveRestoreSubject(pmRoot,id,settings,typeToFolder){const subject=await resolveHistorySubject(pmRoot,id,settings,typeToFolder);const historyPolicy=subject.located?await enforceHistoryStreamPolicyForItem({pmRoot,settings,itemId:subject.id,commandLabel:"restore"}):{warnings:[]};return{...subject,historyPolicyWarnings:historyPolicy.warnings}}function changedFields(beforeDocument,afterDocument){const beforeReplay=toReplayDocument(beforeDocument);const afterReplay=toReplayDocument(afterDocument);const patch=jsonPatch.compare(beforeReplay,afterReplay);const fields=new Set;for(const op of patch){if(op.path==="/body"||op.path.startsWith("/body/")){fields.add("body");continue}const segment=op.path.replace(/^\/(?:metadata|front_matter)\/?/,"").split("/")[0];fields.add(segment.replaceAll("~1","/").replaceAll("~0","~"))}return Array.from(fields).sort((a,b)=>a.localeCompare(b))}async function loadRestoreStateUnderLock(params){const verified=await verifyHistoryRewriteNoDrift({pmRoot:params.pmRoot,subject:params.subject,settings:params.settings,typeRegistry:params.typeRegistry,historyRawBeforeLock:params.historyRawBeforeLock,currentItemRawBeforeLock:params.currentItemRawBeforeLock,operation:"restore",readItem:located=>readRestoreItem(located,params.settings,params.history)});return{loadedItemUnderLock:verified.loadedItemUnderLock,existingItemPath:verified.locatedUnderLock?.itemPath??null}}function resolveRestoreCurrentState(loadedItemUnderLock,history){if(loadedItemUnderLock){return{document:loadedItemUnderLock.document,originalRaw:loadedItemUnderLock.raw}}return{document:replayCurrentDocument(history),originalRaw:null}}function collectRestoreOwnershipWarnings(params){const assigned=params.document.metadata.assignee?.trim();const hasOwnershipConflict=assigned&&assigned!==params.author&&!params.force;if(!hasOwnershipConflict){return[]}if(params.enforcement==="strict"){throw new PmCliError(`Item ${params.resolvedId} is assigned to ${assigned}. Use --force to override.`,EXIT_CODE.CONFLICT)}return params.enforcement==="warn"?[`ownership_warning:assignee_conflict:${params.resolvedId}:${assigned}`]:[]}async function restorePreviousItemAfterHistoryFailure(params){if(params.existingItemPath&&params.resolvedOriginalRaw!==null&&params.restoredItemPath!==params.existingItemPath){await writeFileAtomic(params.existingItemPath,params.resolvedOriginalRaw);await fs.rm(params.restoredItemPath,{force:true});return}if(params.existingItemPath&&params.resolvedOriginalRaw!==null){await writeFileAtomic(params.existingItemPath,params.resolvedOriginalRaw);return}await fs.rm(params.restoredItemPath,{force:true})}async function runRestoreWriteHooks(params){return[...await runActiveOnWriteHooks({path:params.restoredItemPath,scope:"project",op:"restore",item_id:params.after.metadata.id,item_type:params.after.metadata.type,before:params.before,after:params.after,changed_fields:["restored"]}),...await runActiveOnWriteHooks({path:params.historyPath,scope:"project",op:"restore:history",item_id:params.after.metadata.id,item_type:params.after.metadata.type,before:params.before,after:params.after,changed_fields:["restored"]})]}async function runRestore(id,target,options,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const subject=await resolveRestoreSubject(pmRoot,id,settings,typeRegistry.type_to_folder);const resolvedId=subject.id;const{raw:historyRawBeforeLock,entries:history}=await readHistorySnapshot(subject.historyPath,resolvedId);if(history.length===0){throw new PmCliError(`No history exists for ${resolvedId}; restore is unavailable.`,EXIT_CODE.NOT_FOUND)}const resolvedTarget=ensureReplayTarget(target,history);const replayDocument=ensureMaterializedRestoreTarget(replayToTarget(history,resolvedTarget.historyIndex),resolvedTarget);const restoredDocument=replayToCanonicalItemDocument(replayDocument,{schema:settings.schema});if(restoredDocument.metadata.id!==resolvedId){throw new PmCliError(`Restore target resolved to item ${restoredDocument.metadata.id}, expected ${resolvedId}.`,EXIT_CODE.GENERIC_FAILURE)}const loadedItemBeforeLock=subject.located?await readRestoreItem(subject.located,settings,history):null;const currentItemRawBeforeLock=loadedItemBeforeLock?.raw??null;const author=resolveAuthor(options.author,settings.author_default);const releaseLock=await acquireLock(pmRoot,resolvedId,settings.locks.ttl_seconds,author,Boolean(options.force),settings.governance.force_required_for_stale_lock,settings.locks.wait_ms);try{const{loadedItemUnderLock,existingItemPath}=await loadRestoreStateUnderLock({pmRoot,subject,settings,typeRegistry,historyRawBeforeLock,currentItemRawBeforeLock,history});const itemFormat="toon";const currentState=resolveRestoreCurrentState(loadedItemUnderLock,history);const ownershipWarnings=collectRestoreOwnershipWarnings({document:currentState.document,author,force:options.force,enforcement:settings.governance.ownership_enforcement,resolvedId});const restoreChangedFields=changedFields(currentState.document,restoredDocument);await runActiveBeforeMutationHooks({pm_root:pmRoot,operation:"restore",before:currentState.document,after:restoredDocument,changed_fields:restoreChangedFields,sdk:createMutationGuardSdk({pmRoot,settings,typeToFolder:typeRegistry.type_to_folder})});const serializedRestore=serializeItemDocument(restoredDocument,{format:itemFormat,schema:settings.schema});const restoredItemPath=getItemPath(pmRoot,restoredDocument.metadata.type,resolvedId,itemFormat,typeRegistry.type_to_folder);const releaseDerivedIndexLock=await acquireItemMetadataDerivedIndexLock(pmRoot,author);let derivedIndexWarnings=[];try{await writeFileAtomic(restoredItemPath,serializedRestore);if(existingItemPath&&restoredItemPath!==existingItemPath){await fs.rm(existingItemPath)}const historyEntry=createHistoryEntry({nowIso:nowIso(),author,op:"restore",before:currentState.document,after:restoredDocument,message:options.message});try{await appendHistoryEntry(subject.historyPath,historyEntry)}catch(error){await restorePreviousItemAfterHistoryFailure({existingItemPath,resolvedOriginalRaw:currentState.originalRaw,restoredItemPath});throw error}derivedIndexWarnings=await refreshItemMetadataDerivedIndex({pmRoot,preferredFormat:settings.item_format,typeToFolder:typeRegistry.type_to_folder,schema:settings.schema,itemPath:restoredItemPath,previousItemPath:existingItemPath??void 0,document:restoredDocument})}finally{await releaseDerivedIndexLock()}const hookWarnings=await runRestoreWriteHooks({restoredItemPath,historyPath:subject.historyPath,before:currentState.document,after:restoredDocument});recordAfterCommandAffectedItem({id:restoredDocument.metadata.id,op:"restore",item_type:restoredDocument.metadata.type,previous_status:currentState.document.metadata.status,status:restoredDocument.metadata.status,previous:projectAfterCommandItemSnapshot(currentState.document.metadata,restoreChangedFields),current:projectAfterCommandItemSnapshot(restoredDocument.metadata,restoreChangedFields),changed_fields:restoreChangedFields});const targetEntry=history[resolvedTarget.historyIndex];const offset=historyVersionOffset(history,true);return{item:restoredDocument.metadata,restored_from:{kind:resolvedTarget.kind,target:resolvedTarget.raw,history_index:resolvedTarget.historyIndex+1,version:offset===null?null:offset+resolvedTarget.historyIndex+1,entry_ts:targetEntry.ts,entry_op:targetEntry.op},changed_fields:restoreChangedFields,warnings:[...loadedItemUnderLock?.recovered?["restore_unreadable_item_recovered"]:[],...subject.historyPolicyWarnings,...ownershipWarnings,...derivedIndexWarnings,...hookWarnings]}}finally{await releaseLock()}}const _testOnlyRestoreCommand={applyHistoryPatch,changedFields,ensureMaterializedRestoreTarget,ensureReplayTarget,extractPatchFailureContext,replayCurrentDocument,replayToTarget,resolveRestoreSubject};export{_testOnlyRestoreCommand,runRestore};
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="85aa928d-92b8-5f67-8482-0fe5715fef45")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{enforceWorkflowMutation}from"../../core/policy/workflow-policy-store.js";import jsonPatch from"fast-json-patch";import fs from"node:fs/promises";import{readLocatedItemSnapshot}from"../../core/store/item-store.js";import{readHistorySnapshot}from"../../core/history/read.js";import{verifyHistoryRewriteNoDrift}from"../../core/history/history-rewrite.js";import{resolveHistorySubject}from"../history/subject.js";import{historyVersionOffset}from"../../core/history/version-address.js";import{writeFileAtomic,appendHistoryEntry,createHistoryEntry,replayToCanonicalItemDocument,replayToItemDocument,toReplayDocument,enforceHistoryStreamPolicyForItem,canonicalDocument,serializeItemDocument,resolveItemTypeRegistry,acquireLock,EXIT_CODE,PmCliError,nowIso,getActiveExtensionRegistrations,projectAfterCommandItemSnapshot,recordAfterCommandAffectedItem,runActiveOnWriteHooks,runActiveBeforeMutationHooks,createMutationGuardSdk,getItemPath,resolvePmRoot,readSettings,resolveAuthor}from"../runtime-primitives.js";import{applyHistoryPatch,ensureMaterializedHistoryTarget as ensureMaterializedRestoreTarget,extractPatchFailureContext,replayHistoryToTarget as replayToTarget,resolveHistoryTarget}from"../history-read.js";import{acquireItemMetadataDerivedIndexLock,refreshItemMetadataDerivedIndex}from"../item-metadata-index.js";async function readRestoreItem(located,settings,history){const snapshot=await readLocatedItemSnapshot(located,{schema:settings.schema});return snapshot.error===null?{raw:snapshot.raw,document:snapshot.document}:{raw:snapshot.raw,document:replayCurrentDocument(history),recovered:true}}function ensureReplayTarget(target,history){return resolveHistoryTarget(target,history,{errorSubject:"restore",allowFutureTimestamp:true})}function replayCurrentDocument(history){const currentReplay=replayToTarget(history,history.length-1);if(Object.keys(currentReplay.metadata).length===0){return{metadata:{},body:currentReplay.body}}return canonicalDocument(replayToItemDocument(currentReplay))}async function resolveRestoreSubject(pmRoot,id,settings,typeToFolder){const subject=await resolveHistorySubject(pmRoot,id,settings,typeToFolder);const historyPolicy=subject.located?await enforceHistoryStreamPolicyForItem({pmRoot,settings,itemId:subject.id,commandLabel:"restore"}):{warnings:[]};return{...subject,historyPolicyWarnings:historyPolicy.warnings}}function changedFields(beforeDocument,afterDocument){const beforeReplay=toReplayDocument(beforeDocument);const afterReplay=toReplayDocument(afterDocument);const patch=jsonPatch.compare(beforeReplay,afterReplay);const fields=new Set;for(const op of patch){if(op.path==="/body"||op.path.startsWith("/body/")){fields.add("body");continue}const segment=op.path.replace(/^\/(?:metadata|front_matter)\/?/,"").split("/")[0];fields.add(segment.replaceAll("~1","/").replaceAll("~0","~"))}return Array.from(fields).sort((a,b)=>a.localeCompare(b))}async function loadRestoreStateUnderLock(params){const verified=await verifyHistoryRewriteNoDrift({pmRoot:params.pmRoot,subject:params.subject,settings:params.settings,typeRegistry:params.typeRegistry,historyRawBeforeLock:params.historyRawBeforeLock,currentItemRawBeforeLock:params.currentItemRawBeforeLock,operation:"restore",readItem:located=>readRestoreItem(located,params.settings,params.history)});return{loadedItemUnderLock:verified.loadedItemUnderLock,existingItemPath:verified.locatedUnderLock?.itemPath??null}}function resolveRestoreCurrentState(loadedItemUnderLock,history){if(loadedItemUnderLock){return{document:loadedItemUnderLock.document,originalRaw:loadedItemUnderLock.raw}}return{document:replayCurrentDocument(history),originalRaw:null}}function collectRestoreOwnershipWarnings(params){const assigned=params.document.metadata.assignee?.trim();const hasOwnershipConflict=assigned&&assigned!==params.author&&!params.force;if(!hasOwnershipConflict){return[]}if(params.enforcement==="strict"){throw new PmCliError(`Item ${params.resolvedId} is assigned to ${assigned}. Use --force to override.`,EXIT_CODE.CONFLICT)}return params.enforcement==="warn"?[`ownership_warning:assignee_conflict:${params.resolvedId}:${assigned}`]:[]}async function restorePreviousItemAfterHistoryFailure(params){if(params.existingItemPath&&params.resolvedOriginalRaw!==null&&params.restoredItemPath!==params.existingItemPath){await writeFileAtomic(params.existingItemPath,params.resolvedOriginalRaw);await fs.rm(params.restoredItemPath,{force:true});return}if(params.existingItemPath&&params.resolvedOriginalRaw!==null){await writeFileAtomic(params.existingItemPath,params.resolvedOriginalRaw);return}await fs.rm(params.restoredItemPath,{force:true})}async function runRestoreWriteHooks(params){return[...await runActiveOnWriteHooks({path:params.restoredItemPath,scope:"project",op:"restore",item_id:params.after.metadata.id,item_type:params.after.metadata.type,before:params.before,after:params.after,changed_fields:["restored"]}),...await runActiveOnWriteHooks({path:params.historyPath,scope:"project",op:"restore:history",item_id:params.after.metadata.id,item_type:params.after.metadata.type,before:params.before,after:params.after,changed_fields:["restored"]})]}async function runRestore(id,target,options,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const subject=await resolveRestoreSubject(pmRoot,id,settings,typeRegistry.type_to_folder);const resolvedId=subject.id;const{raw:historyRawBeforeLock,entries:history}=await readHistorySnapshot(subject.historyPath,resolvedId);if(history.length===0){throw new PmCliError(`No history exists for ${resolvedId}; restore is unavailable.`,EXIT_CODE.NOT_FOUND)}const resolvedTarget=ensureReplayTarget(target,history);const replayDocument=ensureMaterializedRestoreTarget(replayToTarget(history,resolvedTarget.historyIndex),resolvedTarget);const restoredDocument=replayToCanonicalItemDocument(replayDocument,{schema:settings.schema});if(restoredDocument.metadata.id!==resolvedId){throw new PmCliError(`Restore target resolved to item ${restoredDocument.metadata.id}, expected ${resolvedId}.`,EXIT_CODE.GENERIC_FAILURE)}const loadedItemBeforeLock=subject.located?await readRestoreItem(subject.located,settings,history):null;const currentItemRawBeforeLock=loadedItemBeforeLock?.raw??null;const author=resolveAuthor(options.author,settings.author_default);const releaseLock=await acquireLock(pmRoot,resolvedId,settings.locks.ttl_seconds,author,Boolean(options.force),settings.governance.force_required_for_stale_lock,settings.locks.wait_ms);try{const{loadedItemUnderLock,existingItemPath}=await loadRestoreStateUnderLock({pmRoot,subject,settings,typeRegistry,historyRawBeforeLock,currentItemRawBeforeLock,history});const itemFormat="toon";const currentState=resolveRestoreCurrentState(loadedItemUnderLock,history);const ownershipWarnings=collectRestoreOwnershipWarnings({document:currentState.document,author,force:options.force,enforcement:settings.governance.ownership_enforcement,resolvedId});const restoreChangedFields=changedFields(currentState.document,restoredDocument);const workflowPolicy=await enforceWorkflowMutation({pmRoot,settings,operation:"restore",author,before:currentState.document,after:restoredDocument});await runActiveBeforeMutationHooks({pm_root:pmRoot,operation:"restore",before:currentState.document,after:restoredDocument,changed_fields:restoreChangedFields,sdk:createMutationGuardSdk({pmRoot,settings,typeToFolder:typeRegistry.type_to_folder})});const serializedRestore=serializeItemDocument(restoredDocument,{format:itemFormat,schema:settings.schema});const restoredItemPath=getItemPath(pmRoot,restoredDocument.metadata.type,resolvedId,itemFormat,typeRegistry.type_to_folder);const releaseDerivedIndexLock=await acquireItemMetadataDerivedIndexLock(pmRoot,author);let derivedIndexWarnings=[];try{await writeFileAtomic(restoredItemPath,serializedRestore);if(existingItemPath&&restoredItemPath!==existingItemPath){await fs.rm(existingItemPath)}const historyEntry=createHistoryEntry({nowIso:nowIso(),author,op:"restore",before:currentState.document,after:restoredDocument,message:options.message,context:workflowPolicy.decisions.length===0?void 0:{workflow_policies:workflowPolicy.decisions}});try{await appendHistoryEntry(subject.historyPath,historyEntry)}catch(error){await restorePreviousItemAfterHistoryFailure({existingItemPath,resolvedOriginalRaw:currentState.originalRaw,restoredItemPath});throw error}derivedIndexWarnings=await refreshItemMetadataDerivedIndex({pmRoot,preferredFormat:settings.item_format,typeToFolder:typeRegistry.type_to_folder,schema:settings.schema,itemPath:restoredItemPath,previousItemPath:existingItemPath??void 0,document:restoredDocument})}finally{await releaseDerivedIndexLock()}const hookWarnings=await runRestoreWriteHooks({restoredItemPath,historyPath:subject.historyPath,before:currentState.document,after:restoredDocument});recordAfterCommandAffectedItem({id:restoredDocument.metadata.id,op:"restore",item_type:restoredDocument.metadata.type,previous_status:currentState.document.metadata.status,status:restoredDocument.metadata.status,previous:projectAfterCommandItemSnapshot(currentState.document.metadata,restoreChangedFields),current:projectAfterCommandItemSnapshot(restoredDocument.metadata,restoreChangedFields),changed_fields:restoreChangedFields});const targetEntry=history[resolvedTarget.historyIndex];const offset=historyVersionOffset(history,true);return{item:restoredDocument.metadata,restored_from:{kind:resolvedTarget.kind,target:resolvedTarget.raw,history_index:resolvedTarget.historyIndex+1,version:offset===null?null:offset+resolvedTarget.historyIndex+1,entry_ts:targetEntry.ts,entry_op:targetEntry.op},changed_fields:restoreChangedFields,warnings:[...workflowPolicy.warnings,...loadedItemUnderLock?.recovered?["restore_unreadable_item_recovered"]:[],...subject.historyPolicyWarnings,...ownershipWarnings,...derivedIndexWarnings,...hookWarnings]}}finally{await releaseLock()}}const _testOnlyRestoreCommand={applyHistoryPatch,changedFields,ensureMaterializedRestoreTarget,ensureReplayTarget,extractPatchFailureContext,replayCurrentDocument,replayToTarget,resolveRestoreSubject};export{_testOnlyRestoreCommand,runRestore};
 //# sourceMappingURL=restore.js.map

package/dist/sdk/lifecycle/update.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="72049bed-5c91-5582-916d-8b530d124b8a")}catch(e2){}})();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];const 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})();const UPDATE_OPTION_KEY_TO_UNSET_CANONICAL=new Map(UPDATE_UNSET_FIELD_DEFINITIONS.map(definition=>[definition.optionKey,definition.canonical]));const UPDATE_UNSET_SUPPORTED_CANONICAL_FIELDS=UPDATE_UNSET_FIELD_DEFINITIONS.map(definition=>definition.canonical).sort((left,right)=>left.localeCompare(right)).join(", ");const 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"]);const 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};const appendUnsetTarget=value=>{const current=normalized.unset?[...normalized.unset]:[];if(!current.includes(value)){current.push(value)}normalized.unset=current};const 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});const definition=UPDATE_UNSET_ALIAS_MAP.get(trimmed)??resolveRuntimeUnsetFieldDefinition(trimmed,"update",runtimeFieldRegistry)??(extensionFieldName?{optionKey:"field",metadataKey:extensionFieldName}:void 0);return definition}})}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)]:[]});const 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===true;const ownershipDependencyBypass=options.ownershipDependencyBypass===true;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)=>{if(condition){list.push(flag)}};if(ownershipDependencyBypass){const disallowedFlags2=[];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===true,"--replace-deps",disallowedFlags2);pushIf(options.replaceTests===true,"--replace-tests",disallowedFlags2);pushIf(options.replaceFiles===true,"--replace-files",disallowedFlags2);pushIf(options.replaceDocs===true,"--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===true,"--clear-deps",disallowedFlags2);pushIf(options.clearComments===true,"--clear-comments",disallowedFlags2);pushIf(options.clearNotes===true,"--clear-notes",disallowedFlags2);pushIf(options.clearLearnings===true,"--clear-learnings",disallowedFlags2);pushIf(options.clearFiles===true,"--clear-files",disallowedFlags2);pushIf(options.clearTests===true,"--clear-tests",disallowedFlags2);pushIf(options.clearDocs===true,"--clear-docs",disallowedFlags2);pushIf(options.clearReminders===true,"--clear-reminders",disallowedFlags2);pushIf(options.clearEvents===true,"--clear-events",disallowedFlags2);pushIf(options.clearTypeOptions===true,"--clear-type-options",disallowedFlags2);pushIf(options.force===true,"--force",disallowedFlags2);pushIf(clearItemMetadataKeys.size>0,"--unset",disallowedFlags2);if(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===true,"--replace-deps",disallowedFlags);pushIf(options.replaceTests===true,"--replace-tests",disallowedFlags);pushIf(options.replaceFiles===true,"--replace-files",disallowedFlags);pushIf(options.replaceDocs===true,"--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===true,"--clear-deps",disallowedFlags);pushIf(options.clearComments===true,"--clear-comments",disallowedFlags);pushIf(options.clearNotes===true,"--clear-notes",disallowedFlags);pushIf(options.clearLearnings===true,"--clear-learnings",disallowedFlags);pushIf(options.clearFiles===true,"--clear-files",disallowedFlags);pushIf(options.clearTests===true,"--clear-tests",disallowedFlags);pushIf(options.clearDocs===true,"--clear-docs",disallowedFlags);pushIf(options.clearReminders===true,"--clear-reminders",disallowedFlags);pushIf(options.clearEvents===true,"--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("_","-")}`);disallowedFlags.push(...disallowedUnset);if(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 void 0}const result=evaluateTransition({typeName:params.typeName,fromStatus:params.fromStatus,toStatus:params.toStatus,typeWorkflows:params.typeWorkflows,statusRegistry:params.statusRegistry});if(!result.hasRule||result.allowed){return void 0}const normalizedFrom=normalizeStatusInput(params.fromStatus,params.statusRegistry)??params.fromStatus;const normalizedTo=normalizeStatusInput(params.toStatus,params.statusRegistry)??params.toStatus;const 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){if(!value||value.trim()===""||value.trim().toLowerCase()==="now"){return currentIso}return 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 void 0;const trimmed=value.trim();return trimmed.length>0?trimmed:void 0}const DEP_ADDITION_KEYS=["id","kind","type","author","created_at","source_kind"];const DEP_REMOVE_KEYS=["id","kind","type","author","created_at","source_kind"];function looksLikeStructuredDependencyEntry(raw){if(raw.startsWith("```")||raw.includes("\n")){return true}if(/^(?:[-*+]\s+)?(?:id|kind|type|author|created_at|source_kind)\s*[:=]/i.test(raw)){return true}return looksLikeGenericKeyValueEntry(raw)}function normalizeDependencyKindInput(raw){return typeof raw==="string"?resolveCanonicalRelationshipKind(raw)??raw.trim():raw}function parseDependencyAdditions(raw,prefix,nowIso,fallbackAuthor){if(!raw){return{additions:[]}}assertNoLegacyNoneTokens(raw,"--dep","Use --clear-deps to clear dependencies.");const additions=raw.map(entry=>{const trimmedEntry=entry.trim();const isStructured=looksLikeStructuredDependencyEntry(trimmedEntry);assertValidBareDependencyFlagValue(trimmedEntry,isStructured);const kv=isStructured?parseCsvKv(entry,"--dep"):{id:trimmedEntry,kind:"related"};if(isStructured){assertNoUnknownCsvKeys(kv,"--dep",DEP_ADDITION_KEYS)}const id=kv.id?.trim();const 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));const explicitAuthor=parseOptionalDependencyString(kv.author);return{id:normalizeDependencySeedId(id,prefix,sourceKind),kind:ensureEnum(kind,DEPENDENCY_KIND_VALUES,"dependency kind"),created_at:parseDependencyCreatedAt(kv.created_at,nowIso),author:explicitAuthor??fallbackAuthor,source_kind:sourceKind??"cli:update:dep",author_source:explicitAuthor?"asserted":"detected"}});return{additions}}function parseDependencyRemovals(raw,prefix){if(!raw){return[]}assertNoLegacyNoneTokens(raw,"--dep-remove");return 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);assertValidBareDependencyFlagValue(trimmed,isStructured,"--dep-remove");if(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));const sourceKind=normalizeDependencySourceKind(parseOptionalDependencyString(kv.source_kind));const author=parseOptionalDependencyString(kv.author);const createdAt=parseOptionalDependencyString(kv.created_at);return{id:normalizeDependencySeedId(idRaw,prefix,sourceKind),kind:kindRaw?ensureEnum(kindRaw,DEPENDENCY_KIND_VALUES,"dependency 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()??"";const author=value.author?.trim().toLowerCase()??"";const rawCreatedAt=value.created_at?.trim()??"";const parsedCreatedAt=Date.parse(rawCreatedAt);const 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??[]];let changed=false;if(nextBlockedById===void 0){const filtered=next.filter(dep=>dep.kind!=="blocked_by");if(filtered.length!==next.length){next=filtered;changed=true}if(!changed){return{dependencies:current,changed:false}}return{dependencies:next.length>0?next:void 0,changed:true}}if(!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=true}if(!changed){return{dependencies:current,changed:false}}return{dependencies:next.length>0?next:void 0,changed:true}}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);if(!reconciled.changed){return}if(reconciled.dependencies===void 0){delete metadata.dependencies}else{metadata.dependencies=reconciled.dependencies}if(!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){if(value.id.trim().toLowerCase()!==selector.id.trim().toLowerCase()){return false}if(selector.kind&&value.kind!==selector.kind){return false}if(selector.source_kind!==void 0&&value.source_kind?.trim().toLowerCase()!==selector.source_kind.trim().toLowerCase()){return false}if(selector.author!==void 0&&value.author?.trim().toLowerCase()!==selector.author.trim().toLowerCase()){return false}if(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)){return false}return true}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;const mark=(optionKey,isProvided)=>{if(isProvided){provided.add(optionKey)}};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===true);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===true);mark("file",options.replaceFiles===true);mark("doc",options.replaceDocs===true);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===true);mark("ownershipMetadataBypass",options.ownershipMetadataBypass===true);mark("ownershipDependencyBypass",options.ownershipDependencyBypass===true);mark("dep",options.clearDeps===true);mark("comment",options.clearComments===true);mark("note",options.clearNotes===true);mark("learning",options.clearLearnings===true);mark("file",options.clearFiles===true);mark("test",options.clearTests===true);mark("doc",options.clearDocs===true);mark("reminder",options.clearReminders===true);mark("event",options.clearEvents===true);mark("typeOption",options.clearTypeOptions===true);if(options.unset&&options.unset.length>0){const unsetTargets=parseUpdateUnsetTargets(options.unset,runtimeFieldRegistry,extensionFieldNames);for(const optionKey of unsetTargets.optionKeys){mark(optionKey,true)}}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"]);const UPDATE_LEGACY_COMMON_SCALAR_OPTION_KEYS=COMMON_MUTATION_COMMAND_OPTION_KEYS.filter(key=>!UPDATE_LEGACY_COMMON_SCALAR_OPTION_EXCLUSIONS.has(key));const UPDATE_LEGACY_SCALAR_OPTION_KEYS=["tags","closeReason",...UPDATE_LEGACY_COMMON_SCALAR_OPTION_KEYS];const 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"];const 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"}];const 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)}];const 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];const shouldClear=context.clearItemMetadataKeys.has(definition.metadataKey);if(optionValue===void 0&&!shouldClear){continue}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){const scalarFields=[["body","--body"],["description","--description"]];const listFields=[["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"]];return normalizeLegacyNoneUpdateOptions(await resolveMutationStdinTokenFields(options,scalarFields,listFields))}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===true&&(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===true&&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===true,values:options.test,replaceFlag:"--replace-tests",clearEnabled:options.clearTests===true,clearFlag:"--clear-tests",valueFlag:"--test"});validateLinkedArtifactReplacement({enabled:options.replaceFiles===true,values:options.file,replaceFlag:"--replace-files",clearEnabled:options.clearFiles===true,clearFlag:"--clear-files",valueFlag:"--file"});validateLinkedArtifactReplacement({enabled:options.replaceDocs===true,values:options.doc,replaceFlag:"--replace-docs",clearEnabled:options.clearDocs===true,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===true||definition.optionKey==="test"&&params.options.replaceTests===true||definition.optionKey==="file"&&params.options.replaceFiles===true||definition.optionKey==="doc"&&params.options.replaceDocs===true;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}presence.order=options.order!==void 0||options.rank!==void 0;return 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")){return}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);const 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}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===true;flags.replaceTests=options.replaceTests===true;flags.replaceFiles=options.replaceFiles===true;flags.replaceDocs=options.replaceDocs===true;flags.unset=options.unset!==void 0&&options.unset.length>0;flags.clearDeps=options.clearDeps===true;flags.clearComments=options.clearComments===true;flags.clearNotes=options.clearNotes===true;flags.clearLearnings=options.clearLearnings===true;flags.clearFiles=options.clearFiles===true;flags.clearTests=options.clearTests===true;flags.clearDocs=options.clearDocs===true;flags.clearReminders=options.clearReminders===true;flags.clearEvents=options.clearEvents===true;flags.clearTypeOptions=options.clearTypeOptions===true;flags.runtimeFields=Object.keys(runtimeFieldUpdates).length>0;return 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 void 0;return listAllItemMetadataLight(params.pmRoot,params.settings.item_format,params.typeToFolder,void 0,params.settings.schema)}function assertUpdateHierarchyIntegrity(params){if(!params.before)return;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:[]}}assertParentReferenceIsNotSelf(params.id,resolvedParentValue,params.settings.id_prefix);const parentLocated=await locateItem(params.pmRoot,resolvedParentValue,params.settings.id_prefix,params.settings.item_format,params.typeRegistry.type_to_folder);if(parentLocated){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});const effectiveType=params.options.type!==void 0?resolveTypeName(params.options.type,params.typeRegistry)??params.options.type:document.metadata?.type??"";const 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){return void 0}const targetStatus=normalizeStatusInput(context.options.status,context.statusRegistry);if(targetStatus!==context.statusRegistry.close_status){return void 0}const otherFieldKeys=Object.entries(context.fieldFlags).filter(([key,value])=>value&&key!=="status"&&key!=="closeReason"&&key!=="completedAt").map(([key])=>key);const routeWarnings=[];let preChangedFields=[];if(otherFieldKeys.length>0){const preUpdateOptions=transferMutationStdinTokenPolicy(context.options,{...context.options,status:void 0,closeReason:void 0,message:void 0});const 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);const 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){if(options.title!==void 0){document.metadata.title=requireStringOption(options.title,"--title");changedFields.push("title")}if(options.description!==void 0){document.metadata.description=options.description;changedFields.push("description")}if(options.body!==void 0){document.body=options.body;changedFields.push("body")}return 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){if(metadata[key]===void 0){continue}delete metadata[key];changedFields.push(key)}}function applyStatusMutation(document,context,statusInput,previousStatusNormalized,changedFields){const status=parseStatus(statusInput,context.statusRegistry);document.metadata.status=status;changedFields.push("status");if(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}if(!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)}if(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}if(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")}if(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")}enforceUpdateOptionsByType(activeTypeName,context.options,context.typeRegistry,context.runtimeFieldRegistry,context.extensionFieldNames);applyTypeOptionMutation(document,context,activeTypeName,changedFields);return 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??[]);const 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)));const retainedStoredIdentities=new Set;return current.filter(entry=>{if(!touchedKeys.has(dependencyKey(entry))){return true}const storedIdentity=storedDependencyIdentityKey(entry);if(retainedStoredIdentities.has(storedIdentity)){return false}retainedStoredIdentities.add(storedIdentity);return true})}function assertDependencyRemovalSelectorsMatch(current,selectors,itemId){const unmatchedSelectors=selectors.filter(selector=>!current.some(entry=>matchesDependencySelector(entry,selector)));if(unmatchedSelectors.length===0){return}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);if(!seen.has(key)){nextDependencies.push(addition);seen.add(key)}}}if(context.dependencyRemovals.length>0){assertDependencyRemovalSelectorsMatch(nextDependencies,context.dependencyRemovals,document.metadata.id);nextDependencies=nextDependencies.filter(entry=>!context.dependencyRemovals.some(selector=>matchesDependencySelector(entry,selector)))}if(nextDependencies.length===0){delete document.metadata.dependencies}else{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){if(optionValue===void 0&&!clearItemMetadataKeys.has(key)){return}if(clearItemMetadataKeys.has(key)||!values||values.length===0){delete document.metadata[key]}else{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===true,context.clearItemMetadataKeys,changedFields);applyTestCollectionMutation(document,context,changedFields);applyUniqueLinkedCollectionMutation(document,"docs",context.options.doc,context.docUpdates.values,docKey,context.options.replaceDocs===true,context.clearItemMetadataKeys,changedFields)}function applyUniqueLinkedCollectionMutation(document,key,optionValue,values,keyOf,replace,clearItemMetadataKeys,changedFields){if(optionValue===void 0&&!clearItemMetadataKeys.has(key)){return}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]??[]];const seen=new Set(next.map(entry=>keyOf(entry)));for(const entry of values){const keyValue=keyOf(entry);if(!seen.has(keyValue)){next.push(entry);seen.add(keyValue)}}document.metadata[key]=next}changedFields.push(key)}function applyTestCollectionMutation(document,context,changedFields){if(context.options.test===void 0&&!context.clearItemMetadataKeys.has("tests")){return}if(context.clearItemMetadataKeys.has("tests")&&context.options.replaceTests===true){document.metadata.tests=dedupeLinkedTests(context.testUpdates.values)??[]}else if(context.clearItemMetadataKeys.has("tests")||!context.testUpdates.values||context.testUpdates.values.length===0){delete document.metadata.tests}else{document.metadata.tests=dedupeLinkedTests([...document.metadata.tests??[],...context.testUpdates.values])}if(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 void 0}const next=[];const seen=new Set;for(const entry of values){const key=testKey(entry);if(!seen.has(key)){next.push(entry);seen.add(key)}}return next}function applyTagsAndPlanningMutations(document,context,scalarMutationContext){const addTagsValues=context.options.addTags;const removeTagsValues=context.options.removeTags;const 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;const 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("; ");if(document.metadata.acceptance_criteria===nextValue){return}if(nextValue===""&&document.metadata.acceptance_criteria===void 0){return}document.metadata.acceptance_criteria=nextValue;if(!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")){return}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")){return}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){if(context.options.parent===void 0&&!context.clearItemMetadataKeys.has("parent")){return}if(context.clearItemMetadataKeys.has("parent")){delete document.metadata.parent}else{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)){return}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){if(context.options.blockedBy===void 0&&!context.clearItemMetadataKeys.has("blocked_by")){return}if(context.clearItemMetadataKeys.has("blocked_by")){delete document.metadata.blocked_by}else{document.metadata.blocked_by=context.options.blockedBy?.trim()??""}changedFields.push("blocked_by");if(context.clearItemMetadataKeys.has("blocked_by")||context.resolvedBlockedByDependencyId!==void 0){applyBlockedByDependencyEdge(document.metadata,context.resolvedBlockedByDependencyId,context.nowIso,context.author,changedFields)}}function applyScheduleMutations(document,context,changedFields){if(context.options.reminder!==void 0||context.clearItemMetadataKeys.has("reminders")){if(context.clearItemMetadataKeys.has("reminders")){delete document.metadata.reminders}else{document.metadata.reminders=parseReminderEntries(context.options.reminder??[],context.nowValue,{valueMode:"trimmed"})}changedFields.push("reminders")}if(context.options.event!==void 0||context.clearItemMetadataKeys.has("events")){if(context.clearItemMetadataKeys.has("events")){delete document.metadata.events}else{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("_","-");const definition=context.runtimeFieldRegistry.definitions.find(candidate=>candidate.metadata_key===fieldKey);const updateFlag=definition?.cli_flag??fieldFlag;throw new PmCliError(`Cannot combine --unset ${fieldFlag} with --${updateFlag}`,EXIT_CODE.USAGE)}if(stableValueEquals(metadataRecord[fieldKey],fieldValue)){continue}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)){if(!stableValueEquals(metadataRecord[fieldKey],fieldValue)){metadataRecord[fieldKey]=fieldValue;changedFields.push(fieldKey)}}}function clearDynamicFields(metadataRecord,fieldKeys,clearItemMetadataKeys,changedFields){for(const fieldKey of fieldKeys){if(!clearItemMetadataKeys.has(fieldKey)||metadataRecord[fieldKey]===void 0){continue}delete metadataRecord[fieldKey];changedFields.push(fieldKey)}}function mutateUpdateDocument(document,context){const beforeMetadata=structuredClone(toItemRecord(document.metadata));const beforeBody=document.body;const changedFields=[];const warnings=[];const previousStatusNormalized=applySimpleItemMutations(document,context.options,context.statusRegistry,changedFields);const metadataRecord=toItemRecord(document.metadata);const 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);if(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)}if(normalizeStatusInput(document.metadata.status,context.statusRegistry)===context.statusRegistry.canceled_status&&document.metadata.assignee!==void 0){delete document.metadata.assignee;if(!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);const actualChangedFields=[...new Set(changedFields)].filter(field=>field==="body"?document.body!==beforeBody:!stableValueEquals(beforeMetadata[field],afterMetadata[field]));if(context.options.acceptanceCriteria!==void 0&&actualChangedFields.includes("acceptance_criteria")){warnings.push(`acceptance_criteria_replaced:${splitAcceptanceCriteria(beforeMetadata.acceptance_criteria).length}:${splitAcceptanceCriteria(afterMetadata.acceptance_criteria).length}`)}return{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);const statusRegistry=resolveRuntimeStatusRegistry(settings.schema);const runtimeFieldRegistry=resolveRuntimeFieldRegistry(settings.schema);const extensionRegistrations=getActiveExtensionRegistrations();const extensionFieldNames=collectRegisteredItemFieldNames(extensionRegistrations);const typeRegistry=resolveItemTypeRegistry(settings,extensionRegistrations);const workflowEnforcement=settings.governance.workflow_enforcement??"off";const typeWorkflows=workflowEnforcement==="off"?[]:resolveTypeWorkflows(settings.schema);const parentReferencePolicy=[{strict_error:"strict_error",warn:"warn",off:"off"},{strict_error:"warn",warn:"warn",off:"off"}][Number(options.allowMissingParent===true)][settings.validation.parent_reference];const unsetTargets=parseUpdateUnsetTargets(options.unset,runtimeFieldRegistry,extensionFieldNames);const clearOptionKeys=new Set(unsetTargets.optionKeys);const 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);const nowValue=new Date;const nowIso=nowValue.toISOString();const 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});const dependencyRemovals=parseDependencyRemovals(options.depRemove,settings.id_prefix);const parsedCommentUpdates=parseLogSeed("--comment",options.comment,nowIso,author);const commentUpdates=options.ownershipMetadataBypass===true&&parsedCommentUpdates.values?{...parsedCommentUpdates,values:parsedCommentUpdates.values.map(entry=>({...entry,author}))}:parsedCommentUpdates;const noteUpdates=parseLogSeed("--note",options.note,nowIso,author);const learningUpdates=parseLogSeed("--learning",options.learning,nowIso,author);const fileUpdates=parseFiles(options.file);const testUpdates=parseTests(options.test);testUpdates.values=await attachLinkedTestMutationProvenance(testUpdates.values,author,nowIso);const docUpdates=parseDocs(options.doc);const workflowTransitionWarnings=[];const parentReference=await resolveParentReferenceForUpdate({id,options,unsetTargets,pmRoot,settings,typeRegistry,parentReferencePolicy});const blockedByResolution=await resolveBlockedByDependencyTarget(options.blockedBy,clearItemMetadataKeys.has("blocked_by"),pmRoot,settings.id_prefix,settings.item_format,typeRegistry.type_to_folder);const resolvedBlockedByDependencyId=blockedByResolution.id;const parentReferenceWarnings=[...parentReference.warnings,...blockedByResolutionWarnings(blockedByResolution)];const runtimeFieldUpdates=collectRuntimeUpdateFieldValues(options,runtimeFieldRegistry,options.runtimeFieldCommands);const fieldFlags=buildUpdateFieldFlags(options,runtimeFieldUpdates);const changedFlags=Object.values(fieldFlags).some(Boolean);if(!changedFlags){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();const hierarchyMutationRequired=fieldFlags.parent&&!clearItemMetadataKeys.has("parent")||dependencyUpdates.additions.some(dependency=>relationshipRegistry.resolve(dependency.kind)?.hierarchy);const 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});let lifecycleTransition;let 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===true||options.ownershipDependencyBypass===true,extensionFieldNames,skipNoop:true,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});assertUpdateHierarchyIntegrity({before:graphBeforeUpdate,document,statusRegistry});return 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){if(options.ownershipMetadataBypass===true||options.ownershipDependencyBypass===true){return"update_ownership_bypass"}return execution.recurrenceReason===void 0?"update":"reopen"}function prepareRecurrenceTransition(params){if(params.recurrenceReason===void 0){return void 0}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;const toStatus=normalizeStatusInput(requestedStatus,params.statusRegistry)??requestedStatus;const metadata=toItemRecord(params.document.metadata);const 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="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="80ec599f-7198-5b07-bca2-253f85c137b7")}catch(e2){}})();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];const 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})();const UPDATE_OPTION_KEY_TO_UNSET_CANONICAL=new Map(UPDATE_UNSET_FIELD_DEFINITIONS.map(definition=>[definition.optionKey,definition.canonical]));const UPDATE_UNSET_SUPPORTED_CANONICAL_FIELDS=UPDATE_UNSET_FIELD_DEFINITIONS.map(definition=>definition.canonical).sort((left,right)=>left.localeCompare(right)).join(", ");const 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"]);const 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};const appendUnsetTarget=value=>{const current=normalized.unset?[...normalized.unset]:[];if(!current.includes(value)){current.push(value)}normalized.unset=current};const 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});const definition=UPDATE_UNSET_ALIAS_MAP.get(trimmed)??resolveRuntimeUnsetFieldDefinition(trimmed,"update",runtimeFieldRegistry)??(extensionFieldName?{optionKey:"field",metadataKey:extensionFieldName}:void 0);return definition}})}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)]:[]});const 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===true;const ownershipDependencyBypass=options.ownershipDependencyBypass===true;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)=>{if(condition){list.push(flag)}};if(ownershipDependencyBypass){const disallowedFlags2=[];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===true,"--replace-deps",disallowedFlags2);pushIf(options.replaceTests===true,"--replace-tests",disallowedFlags2);pushIf(options.replaceFiles===true,"--replace-files",disallowedFlags2);pushIf(options.replaceDocs===true,"--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===true,"--clear-deps",disallowedFlags2);pushIf(options.clearComments===true,"--clear-comments",disallowedFlags2);pushIf(options.clearNotes===true,"--clear-notes",disallowedFlags2);pushIf(options.clearLearnings===true,"--clear-learnings",disallowedFlags2);pushIf(options.clearFiles===true,"--clear-files",disallowedFlags2);pushIf(options.clearTests===true,"--clear-tests",disallowedFlags2);pushIf(options.clearDocs===true,"--clear-docs",disallowedFlags2);pushIf(options.clearReminders===true,"--clear-reminders",disallowedFlags2);pushIf(options.clearEvents===true,"--clear-events",disallowedFlags2);pushIf(options.clearTypeOptions===true,"--clear-type-options",disallowedFlags2);pushIf(options.force===true,"--force",disallowedFlags2);pushIf(clearItemMetadataKeys.size>0,"--unset",disallowedFlags2);if(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===true,"--replace-deps",disallowedFlags);pushIf(options.replaceTests===true,"--replace-tests",disallowedFlags);pushIf(options.replaceFiles===true,"--replace-files",disallowedFlags);pushIf(options.replaceDocs===true,"--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===true,"--clear-deps",disallowedFlags);pushIf(options.clearComments===true,"--clear-comments",disallowedFlags);pushIf(options.clearNotes===true,"--clear-notes",disallowedFlags);pushIf(options.clearLearnings===true,"--clear-learnings",disallowedFlags);pushIf(options.clearFiles===true,"--clear-files",disallowedFlags);pushIf(options.clearTests===true,"--clear-tests",disallowedFlags);pushIf(options.clearDocs===true,"--clear-docs",disallowedFlags);pushIf(options.clearReminders===true,"--clear-reminders",disallowedFlags);pushIf(options.clearEvents===true,"--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("_","-")}`);disallowedFlags.push(...disallowedUnset);if(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 void 0}const result=evaluateTransition({typeName:params.typeName,fromStatus:params.fromStatus,toStatus:params.toStatus,typeWorkflows:params.typeWorkflows,statusRegistry:params.statusRegistry});if(!result.hasRule||result.allowed){return void 0}const normalizedFrom=normalizeStatusInput(params.fromStatus,params.statusRegistry)??params.fromStatus;const normalizedTo=normalizeStatusInput(params.toStatus,params.statusRegistry)??params.toStatus;const 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){if(!value||value.trim()===""||value.trim().toLowerCase()==="now"){return currentIso}return 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 void 0;const trimmed=value.trim();return trimmed.length>0?trimmed:void 0}const DEP_ADDITION_KEYS=["id","kind","type","author","created_at","source_kind"];const DEP_REMOVE_KEYS=["id","kind","type","author","created_at","source_kind"];function looksLikeStructuredDependencyEntry(raw){if(raw.startsWith("```")||raw.includes("\n")){return true}if(/^(?:[-*+]\s+)?(?:id|kind|type|author|created_at|source_kind)\s*[:=]/i.test(raw)){return true}return looksLikeGenericKeyValueEntry(raw)}function normalizeDependencyKindInput(raw){return typeof raw==="string"?resolveCanonicalRelationshipKind(raw)??raw.trim():raw}function parseDependencyAdditions(raw,prefix,nowIso,fallbackAuthor){if(!raw){return{additions:[]}}assertNoLegacyNoneTokens(raw,"--dep","Use --clear-deps to clear dependencies.");const additions=raw.map(entry=>{const trimmedEntry=entry.trim();const isStructured=looksLikeStructuredDependencyEntry(trimmedEntry);assertValidBareDependencyFlagValue(trimmedEntry,isStructured);const kv=isStructured?parseCsvKv(entry,"--dep"):{id:trimmedEntry,kind:"related"};if(isStructured){assertNoUnknownCsvKeys(kv,"--dep",DEP_ADDITION_KEYS)}const id=kv.id?.trim();const 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));const 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"}});return{additions}}function parseDependencyRemovals(raw,prefix){if(!raw){return[]}assertNoLegacyNoneTokens(raw,"--dep-remove");return 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);assertValidBareDependencyFlagValue(trimmed,isStructured,"--dep-remove");if(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));const sourceKind=normalizeDependencySourceKind(parseOptionalDependencyString(kv.source_kind));const author=parseOptionalDependencyString(kv.author);const 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()??"";const author=value.author?.trim().toLowerCase()??"";const rawCreatedAt=value.created_at?.trim()??"";const parsedCreatedAt=Date.parse(rawCreatedAt);const 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??[]];let changed=false;if(nextBlockedById===void 0){const filtered=next.filter(dep=>dep.kind!=="blocked_by");if(filtered.length!==next.length){next=filtered;changed=true}if(!changed){return{dependencies:current,changed:false}}return{dependencies:next.length>0?next:void 0,changed:true}}if(!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=true}if(!changed){return{dependencies:current,changed:false}}return{dependencies:next.length>0?next:void 0,changed:true}}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);if(!reconciled.changed){return}if(reconciled.dependencies===void 0){delete metadata.dependencies}else{metadata.dependencies=reconciled.dependencies}if(!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){if(value.id.trim().toLowerCase()!==selector.id.trim().toLowerCase()){return false}if(selector.kind&&value.kind!==selector.kind){return false}if(selector.source_kind!==void 0&&value.source_kind?.trim().toLowerCase()!==selector.source_kind.trim().toLowerCase()){return false}if(selector.author!==void 0&&value.author?.trim().toLowerCase()!==selector.author.trim().toLowerCase()){return false}if(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)){return false}return true}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;const mark=(optionKey,isProvided)=>{if(isProvided){provided.add(optionKey)}};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===true);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===true);mark("file",options.replaceFiles===true);mark("doc",options.replaceDocs===true);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===true);mark("ownershipMetadataBypass",options.ownershipMetadataBypass===true);mark("ownershipDependencyBypass",options.ownershipDependencyBypass===true);mark("dep",options.clearDeps===true);mark("comment",options.clearComments===true);mark("note",options.clearNotes===true);mark("learning",options.clearLearnings===true);mark("file",options.clearFiles===true);mark("test",options.clearTests===true);mark("doc",options.clearDocs===true);mark("reminder",options.clearReminders===true);mark("event",options.clearEvents===true);mark("typeOption",options.clearTypeOptions===true);if(options.unset&&options.unset.length>0){const unsetTargets=parseUpdateUnsetTargets(options.unset,runtimeFieldRegistry,extensionFieldNames);for(const optionKey of unsetTargets.optionKeys){mark(optionKey,true)}}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"]);const UPDATE_LEGACY_COMMON_SCALAR_OPTION_KEYS=COMMON_MUTATION_COMMAND_OPTION_KEYS.filter(key=>!UPDATE_LEGACY_COMMON_SCALAR_OPTION_EXCLUSIONS.has(key));const UPDATE_LEGACY_SCALAR_OPTION_KEYS=["tags","closeReason",...UPDATE_LEGACY_COMMON_SCALAR_OPTION_KEYS];const 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"];const 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"}];const 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)}];const 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];const shouldClear=context.clearItemMetadataKeys.has(definition.metadataKey);if(optionValue===void 0&&!shouldClear){continue}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){const scalarFields=[["body","--body"],["description","--description"]];const listFields=[["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"]];return normalizeLegacyNoneUpdateOptions(await resolveMutationStdinTokenFields(options,scalarFields,listFields))}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===true&&(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===true&&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===true,values:options.test,replaceFlag:"--replace-tests",clearEnabled:options.clearTests===true,clearFlag:"--clear-tests",valueFlag:"--test"});validateLinkedArtifactReplacement({enabled:options.replaceFiles===true,values:options.file,replaceFlag:"--replace-files",clearEnabled:options.clearFiles===true,clearFlag:"--clear-files",valueFlag:"--file"});validateLinkedArtifactReplacement({enabled:options.replaceDocs===true,values:options.doc,replaceFlag:"--replace-docs",clearEnabled:options.clearDocs===true,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===true||definition.optionKey==="test"&&params.options.replaceTests===true||definition.optionKey==="file"&&params.options.replaceFiles===true||definition.optionKey==="doc"&&params.options.replaceDocs===true;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}presence.order=options.order!==void 0||options.rank!==void 0;return 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")){return}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);const 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}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===true;flags.replaceTests=options.replaceTests===true;flags.replaceFiles=options.replaceFiles===true;flags.replaceDocs=options.replaceDocs===true;flags.unset=options.unset!==void 0&&options.unset.length>0;flags.clearDeps=options.clearDeps===true;flags.clearComments=options.clearComments===true;flags.clearNotes=options.clearNotes===true;flags.clearLearnings=options.clearLearnings===true;flags.clearFiles=options.clearFiles===true;flags.clearTests=options.clearTests===true;flags.clearDocs=options.clearDocs===true;flags.clearReminders=options.clearReminders===true;flags.clearEvents=options.clearEvents===true;flags.clearTypeOptions=options.clearTypeOptions===true;flags.runtimeFields=Object.keys(runtimeFieldUpdates).length>0;return 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 void 0;return listAllItemMetadataLight(params.pmRoot,params.settings.item_format,params.typeToFolder,void 0,params.settings.schema)}function assertUpdateHierarchyIntegrity(params){if(!params.before)return;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:[]}}assertParentReferenceIsNotSelf(params.id,resolvedParentValue,params.settings.id_prefix);const parentLocated=await locateItem(params.pmRoot,resolvedParentValue,params.settings.id_prefix,params.settings.item_format,params.typeRegistry.type_to_folder);if(parentLocated){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});const effectiveType=params.options.type!==void 0?resolveTypeName(params.options.type,params.typeRegistry)??params.options.type:document.metadata?.type??"";const 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){return void 0}const targetStatus=normalizeStatusInput(context.options.status,context.statusRegistry);if(targetStatus!==context.statusRegistry.close_status){return void 0}const otherFieldKeys=Object.entries(context.fieldFlags).filter(([key,value])=>value&&key!=="status"&&key!=="closeReason"&&key!=="completedAt").map(([key])=>key);const routeWarnings=[];let preChangedFields=[];if(otherFieldKeys.length>0){const preUpdateOptions=transferMutationStdinTokenPolicy(context.options,{...context.options,status:void 0,closeReason:void 0,message:void 0});const 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);const 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){if(options.title!==void 0){document.metadata.title=requireStringOption(options.title,"--title");changedFields.push("title")}if(options.description!==void 0){document.metadata.description=options.description;changedFields.push("description")}if(options.body!==void 0){document.body=options.body;changedFields.push("body")}return 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){if(metadata[key]===void 0){continue}delete metadata[key];changedFields.push(key)}}function applyStatusMutation(document,context,statusInput,previousStatusNormalized,changedFields){const status=parseStatus(statusInput,context.statusRegistry);document.metadata.status=status;changedFields.push("status");if(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}if(!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)}if(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}if(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")}if(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")}enforceUpdateOptionsByType(activeTypeName,context.options,context.typeRegistry,context.runtimeFieldRegistry,context.extensionFieldNames);applyTypeOptionMutation(document,context,activeTypeName,changedFields);return 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??[]);const 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)));const retainedStoredIdentities=new Set;return current.filter(entry=>{if(!touchedKeys.has(dependencyKey(entry))){return true}const storedIdentity=storedDependencyIdentityKey(entry);if(retainedStoredIdentities.has(storedIdentity)){return false}retainedStoredIdentities.add(storedIdentity);return true})}function assertDependencyRemovalSelectorsMatch(current,selectors,itemId){const unmatchedSelectors=selectors.filter(selector=>!current.some(entry=>matchesDependencySelector(entry,selector)));if(unmatchedSelectors.length===0){return}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);if(!seen.has(key)){nextDependencies.push(addition);seen.add(key)}}}if(context.dependencyRemovals.length>0){assertDependencyRemovalSelectorsMatch(nextDependencies,context.dependencyRemovals,document.metadata.id);nextDependencies=nextDependencies.filter(entry=>!context.dependencyRemovals.some(selector=>matchesDependencySelector(entry,selector)))}if(nextDependencies.length===0){delete document.metadata.dependencies}else{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){if(optionValue===void 0&&!clearItemMetadataKeys.has(key)){return}if(clearItemMetadataKeys.has(key)||!values||values.length===0){delete document.metadata[key]}else{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===true,context.clearItemMetadataKeys,changedFields);applyTestCollectionMutation(document,context,changedFields);applyUniqueLinkedCollectionMutation(document,"docs",context.options.doc,context.docUpdates.values,docKey,context.options.replaceDocs===true,context.clearItemMetadataKeys,changedFields)}function applyUniqueLinkedCollectionMutation(document,key,optionValue,values,keyOf,replace,clearItemMetadataKeys,changedFields){if(optionValue===void 0&&!clearItemMetadataKeys.has(key)){return}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]??[]];const seen=new Set(next.map(entry=>keyOf(entry)));for(const entry of values){const keyValue=keyOf(entry);if(!seen.has(keyValue)){next.push(entry);seen.add(keyValue)}}document.metadata[key]=next}changedFields.push(key)}function applyTestCollectionMutation(document,context,changedFields){if(context.options.test===void 0&&!context.clearItemMetadataKeys.has("tests")){return}if(context.clearItemMetadataKeys.has("tests")&&context.options.replaceTests===true){document.metadata.tests=dedupeLinkedTests(context.testUpdates.values)??[]}else if(context.clearItemMetadataKeys.has("tests")||!context.testUpdates.values||context.testUpdates.values.length===0){delete document.metadata.tests}else{document.metadata.tests=dedupeLinkedTests([...document.metadata.tests??[],...context.testUpdates.values])}if(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 void 0}const next=[];const seen=new Set;for(const entry of values){const key=testKey(entry);if(!seen.has(key)){next.push(entry);seen.add(key)}}return next}function applyTagsAndPlanningMutations(document,context,scalarMutationContext){const addTagsValues=context.options.addTags;const removeTagsValues=context.options.removeTags;const 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;const 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("; ");if(document.metadata.acceptance_criteria===nextValue){return}if(nextValue===""&&document.metadata.acceptance_criteria===void 0){return}document.metadata.acceptance_criteria=nextValue;if(!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")){return}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")){return}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){if(context.options.parent===void 0&&!context.clearItemMetadataKeys.has("parent")){return}if(context.clearItemMetadataKeys.has("parent")){delete document.metadata.parent}else{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)){return}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){if(context.options.blockedBy===void 0&&!context.clearItemMetadataKeys.has("blocked_by")){return}if(context.clearItemMetadataKeys.has("blocked_by")){delete document.metadata.blocked_by}else{document.metadata.blocked_by=context.options.blockedBy?.trim()??""}changedFields.push("blocked_by");if(context.clearItemMetadataKeys.has("blocked_by")||context.resolvedBlockedByDependencyId!==void 0){applyBlockedByDependencyEdge(document.metadata,context.resolvedBlockedByDependencyId,context.nowIso,context.author,changedFields)}}function applyScheduleMutations(document,context,changedFields){if(context.options.reminder!==void 0||context.clearItemMetadataKeys.has("reminders")){if(context.clearItemMetadataKeys.has("reminders")){delete document.metadata.reminders}else{document.metadata.reminders=parseReminderEntries(context.options.reminder??[],context.nowValue,{valueMode:"trimmed"})}changedFields.push("reminders")}if(context.options.event!==void 0||context.clearItemMetadataKeys.has("events")){if(context.clearItemMetadataKeys.has("events")){delete document.metadata.events}else{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("_","-");const definition=context.runtimeFieldRegistry.definitions.find(candidate=>candidate.metadata_key===fieldKey);const updateFlag=definition?.cli_flag??fieldFlag;throw new PmCliError(`Cannot combine --unset ${fieldFlag} with --${updateFlag}`,EXIT_CODE.USAGE)}if(stableValueEquals(metadataRecord[fieldKey],fieldValue)){continue}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)){if(!stableValueEquals(metadataRecord[fieldKey],fieldValue)){metadataRecord[fieldKey]=fieldValue;changedFields.push(fieldKey)}}}function clearDynamicFields(metadataRecord,fieldKeys,clearItemMetadataKeys,changedFields){for(const fieldKey of fieldKeys){if(!clearItemMetadataKeys.has(fieldKey)||metadataRecord[fieldKey]===void 0){continue}delete metadataRecord[fieldKey];changedFields.push(fieldKey)}}function mutateUpdateDocument(document,context){const beforeMetadata=structuredClone(toItemRecord(document.metadata));const beforeBody=document.body;const changedFields=[];const warnings=[];const previousStatusNormalized=applySimpleItemMutations(document,context.options,context.statusRegistry,changedFields);const metadataRecord=toItemRecord(document.metadata);const 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);if(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)}if(normalizeStatusInput(document.metadata.status,context.statusRegistry)===context.statusRegistry.canceled_status&&document.metadata.assignee!==void 0){delete document.metadata.assignee;if(!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);const actualChangedFields=[...new Set(changedFields)].filter(field=>field==="body"?document.body!==beforeBody:!stableValueEquals(beforeMetadata[field],afterMetadata[field]));if(context.options.acceptanceCriteria!==void 0&&actualChangedFields.includes("acceptance_criteria")){warnings.push(`acceptance_criteria_replaced:${splitAcceptanceCriteria(beforeMetadata.acceptance_criteria).length}:${splitAcceptanceCriteria(afterMetadata.acceptance_criteria).length}`)}return{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);const statusRegistry=resolveRuntimeStatusRegistry(settings.schema);const runtimeFieldRegistry=resolveRuntimeFieldRegistry(settings.schema);const extensionRegistrations=getActiveExtensionRegistrations();const extensionFieldNames=collectRegisteredItemFieldNames(extensionRegistrations);const typeRegistry=resolveItemTypeRegistry(settings,extensionRegistrations);const workflowEnforcement=settings.governance.workflow_enforcement??"off";const typeWorkflows=workflowEnforcement==="off"?[]:resolveTypeWorkflows(settings.schema);const parentReferencePolicy=[{strict_error:"strict_error",warn:"warn",off:"off"},{strict_error:"warn",warn:"warn",off:"off"}][Number(options.allowMissingParent===true)][settings.validation.parent_reference];const unsetTargets=parseUpdateUnsetTargets(options.unset,runtimeFieldRegistry,extensionFieldNames);const clearOptionKeys=new Set(unsetTargets.optionKeys);const 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);const nowValue=new Date;const nowIso=nowValue.toISOString();const 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});const dependencyRemovals=parseDependencyRemovals(options.depRemove,settings.id_prefix);const parsedCommentUpdates=parseLogSeed("--comment",options.comment,nowIso,author);const commentUpdates=options.ownershipMetadataBypass===true&&parsedCommentUpdates.values?{...parsedCommentUpdates,values:parsedCommentUpdates.values.map(entry=>({...entry,author}))}:parsedCommentUpdates;const noteUpdates=parseLogSeed("--note",options.note,nowIso,author);const learningUpdates=parseLogSeed("--learning",options.learning,nowIso,author);const fileUpdates=parseFiles(options.file);const testUpdates=parseTests(options.test);testUpdates.values=await attachLinkedTestMutationProvenance(testUpdates.values,author,nowIso);const docUpdates=parseDocs(options.doc);const workflowTransitionWarnings=[];const parentReference=await resolveParentReferenceForUpdate({id,options,unsetTargets,pmRoot,settings,typeRegistry,parentReferencePolicy});const blockedByResolution=await resolveBlockedByDependencyTarget(options.blockedBy,clearItemMetadataKeys.has("blocked_by"),pmRoot,settings.id_prefix,settings.item_format,typeRegistry.type_to_folder);const resolvedBlockedByDependencyId=blockedByResolution.id;const parentReferenceWarnings=[...parentReference.warnings,...blockedByResolutionWarnings(blockedByResolution)];const runtimeFieldUpdates=collectRuntimeUpdateFieldValues(options,runtimeFieldRegistry,options.runtimeFieldCommands);const fieldFlags=buildUpdateFieldFlags(options,runtimeFieldUpdates);const changedFlags=Object.values(fieldFlags).some(Boolean);if(!changedFlags){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();const hierarchyMutationRequired=fieldFlags.parent&&!clearItemMetadataKeys.has("parent")||dependencyUpdates.additions.some(dependency=>relationshipRegistry.resolve(dependency.kind)?.hierarchy);const 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});let lifecycleTransition;let 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===true||options.ownershipDependencyBypass===true,extensionFieldNames,skipNoop:true,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});assertUpdateHierarchyIntegrity({before:graphBeforeUpdate,document,statusRegistry});return 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){if(options.ownershipMetadataBypass===true||options.ownershipDependencyBypass===true){return"update_ownership_bypass"}return execution.recurrenceReason===void 0?"update":"reopen"}function prepareRecurrenceTransition(params){if(params.recurrenceReason===void 0){return void 0}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;const toStatus=normalizeStatusInput(requestedStatus,params.statusRegistry)??requestedStatus;const metadata=toItemRecord(params.document.metadata);const 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/package-import-adapters.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="f248824b-d56a-52ec-ac50-8b69b5ab1c99")}catch(e2){}})();import{appendHistoryEntry,createHistoryEntry}from"../core/history/history.js";import{acquireLock}from"../core/lock/lock.js";import{parseTags}from"../core/item/parse.js";import{normalizeStatusInput}from"../core/item/status.js";import{serializeItemDocument}from"../core/item/item-format.js";import{getHistoryPath}from"../core/store/paths.js";import{removeFileIfExists,writeFileAtomic}from"../core/fs/fs-utils.js";import{runActiveOnWriteHooks}from"../core/extensions/index.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{resolveAuthor}from"../core/shared/author.js";import{nowIso}from"../core/shared/time.js";import{assertInitializedTracker}from"./environment/tracker-preflight.js";function toNonEmptyImportString(value){if(typeof value!=="string"){return void 0}const trimmed=value.trim();return trimmed.length>0?trimmed:void 0}function toEstimatedMinutesValue(value){if(typeof value==="number"&&Number.isFinite(value)&&value>=0){return value}if(typeof value==="string"&&value.trim().length>0){const parsed=Number(value);if(Number.isFinite(parsed)&&parsed>=0){return parsed}}return void 0}function toImportPriority(value){if(typeof value==="number"&&Number.isInteger(value)&&value>=0&&value<=4){return value}if(typeof value==="string"&&value.trim().length>0){const parsed=Number(value);if(Number.isInteger(parsed)&&parsed>=0&&parsed<=4){return parsed}}return 2}function toImportTags(value){if(Array.isArray(value)){const tags=value.filter(entry=>typeof entry==="string").map(entry=>entry.trim().toLowerCase()).filter(entry=>entry.length>0);return Array.from(new Set(tags)).sort((left,right)=>left.localeCompare(right))}if(typeof value==="string"){return parseTags(value)}return[]}function toImportStatus(value){const normalized=toNonEmptyImportString(value);if(normalized){const canonical=normalizeStatusInput(normalized);if(canonical){return canonical}}return"open"}function toImportInteger(value){if(typeof value==="number"&&Number.isInteger(value)){return value}if(typeof value!=="string"||value.trim().length===0){return void 0}const parsed=Number(value);return Number.isInteger(parsed)?parsed:void 0}function toImportBoolean(value){if(typeof value==="boolean"){return value}if(typeof value==="number"){return value===1?true:value===0?false:void 0}if(typeof value!=="string"){return void 0}const normalized=value.trim().toLowerCase();if(normalized==="true"||normalized==="1"){return true}return normalized==="false"||normalized==="0"?false:void 0}function toImportStringList(value){if(!Array.isArray(value)){return void 0}const entries=value.map(entry=>toNonEmptyImportString(entry)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function toImportStringMap(value){return toImportValueMap(value,toNonEmptyImportString)}function toImportNumberMap(value){return toImportValueMap(value,toImportFiniteNumber)}function toImportConfidence(value,allowedTextValues){if(typeof value==="number"&&Number.isInteger(value)&&value>=0&&value<=100){return value}const normalized=toNonEmptyImportString(value)?.toLowerCase();if(!normalized){return void 0}const candidate=normalized==="med"?"medium":normalized;if(allowedTextValues.some(entry=>entry===candidate)){return candidate}const parsed=Number(candidate);return Number.isInteger(parsed)&&parsed>=0&&parsed<=100?parsed:void 0}function toImportNormalizedEnum(value,allowed){const normalized=toNonEmptyImportString(value)?.toLowerCase();if(!normalized){return void 0}const candidate=normalized==="med"?"medium":normalized;return allowed.includes(candidate)?candidate:void 0}function toImportLinkScope(value){return toNonEmptyImportString(value)?.toLowerCase()==="global"?"global":"project"}function toImportLogEntries(value,options){const values=normalizeImportCollection(value,options.allowScalar===true);if(!values){return void 0}const entries=values.map(entry=>toImportLogEntry(entry,options)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function toImportLinkedFiles(value,options={}){return toImportLinkedArtifacts(value,options,(pathValue,record)=>({path:pathValue,scope:toImportLinkScope(record?.scope),note:toNonEmptyImportString(record?.note)}))}function toImportLinkedDocs(value,options={}){return toImportLinkedArtifacts(value,options,(pathValue,record)=>({path:pathValue,scope:toImportLinkScope(record?.scope),note:toNonEmptyImportString(record?.note)}))}function toImportLinkedTests(value,options={}){const values=normalizeImportCollection(value,options.allowScalar===true);if(!values){return void 0}const entries=values.map(entry=>toImportLinkedTest(entry,options)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function selectImportAuthor(explicitAuthor,settingsAuthor){return resolveAuthor(explicitAuthor,settingsAuthor)}function isImportRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}function normalizeImportCollection(value,allowScalar){if(Array.isArray(value)){return value}return allowScalar?[value]:void 0}function firstNonEmptyImportString(record,keys){for(const key of keys){const value=toNonEmptyImportString(record[key]);if(value){return value}}return void 0}function toImportValueMap(value,coerce){if(!isImportRecord(value)){return void 0}const entries=Object.entries(value).map(([key,entryValue])=>[key.trim(),coerce(entryValue)]).filter(entry=>entry[0].length>0&&entry[1]!==void 0);return entries.length>0?Object.fromEntries(entries):void 0}function toImportLogEntry(entry,options){if(typeof entry==="string"){return toImportLogEntryFromText(entry,options)}if(!isImportRecord(entry)){return void 0}const text=firstNonEmptyImportString(entry,options.textKeys??["text"]);if(!text){return void 0}const createdAtKey=options.createdAtKey??"created_at";const authorKey=options.authorKey??"author";const createdAt=(options.toIsoString?options.toIsoString(entry[createdAtKey]):toNonEmptyImportString(entry[createdAtKey]))??options.fallbackCreatedAt;return{created_at:createdAt,author:toNonEmptyImportString(entry[authorKey])??options.fallbackAuthor,text}}function toImportLogEntryFromText(entry,options){const text=toNonEmptyImportString(entry);return text?{created_at:options.fallbackCreatedAt,author:options.fallbackAuthor,text}:void 0}function toImportLinkedArtifacts(value,options,build){const values=normalizeImportCollection(value,options.allowScalar===true);if(!values){return void 0}const pathKeys=options.pathKeys??["path"];const entries=values.map(entry=>toImportLinkedArtifact(entry,pathKeys,build)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function toImportLinkedArtifact(entry,pathKeys,build){if(typeof entry==="string"){const pathValue2=toNonEmptyImportString(entry);return pathValue2?build(pathValue2):void 0}if(!isImportRecord(entry)){return void 0}const pathValue=firstNonEmptyImportString(entry,pathKeys);return pathValue?build(pathValue,entry):void 0}function toImportLinkedTest(entry,options){if(typeof entry==="string"){const command2=toNonEmptyImportString(entry);return command2?{command:command2,scope:"project"}:void 0}if(!isImportRecord(entry)){return void 0}const command=firstNonEmptyImportString(entry,options.commandKeys??["command"]);const testPath=firstNonEmptyImportString(entry,options.pathKeys??["path"]);if(!command&&(options.requireCommand===true||!testPath)){return void 0}return{...command?{command}:{},...testPath?{path:testPath}:{},scope:toImportLinkScope(entry.scope),timeout_seconds:toImportLinkedTestTimeout(entry.timeout_seconds,options),note:toNonEmptyImportString(entry.note),...options.includeExtendedAssertions===true?toImportLinkedTestAssertions(entry):{}}}function toImportLinkedTestTimeout(value,options){const parsed=options.integerTimeout===true?toImportInteger(value):toImportFiniteNumber(value);if(parsed===void 0){return void 0}const minimum=options.timeoutMinimum??0;return options.timeoutExclusiveMinimum===true?parsed>minimum?parsed:void 0:parsed>=minimum?parsed:void 0}function toImportFiniteNumber(value){if(typeof value==="number"&&Number.isFinite(value)){return value}if(typeof value!=="string"||value.trim().length===0){return void 0}const parsed=Number(value);return Number.isFinite(parsed)?parsed:void 0}function toImportLinkedTestAssertions(entry){return{pm_context_mode:toImportNormalizedEnum(entry.pm_context_mode,["schema","tracker","auto"]),env_set:toImportStringMap(entry.env_set),env_clear:toImportStringList(entry.env_clear),shared_host_safe:toImportBoolean(entry.shared_host_safe),assert_stdout_contains:toImportStringList(entry.assert_stdout_contains),assert_stdout_regex:toImportStringList(entry.assert_stdout_regex),assert_stderr_contains:toImportStringList(entry.assert_stderr_contains),assert_stderr_regex:toImportStringList(entry.assert_stderr_regex),assert_stdout_min_lines:toImportInteger(entry.assert_stdout_min_lines),assert_json_field_equals:toImportStringMap(entry.assert_json_field_equals),assert_json_field_gte:toImportNumberMap(entry.assert_json_field_gte)}}async function ensureTrackerInitialized(pmRoot){await assertInitializedTracker(pmRoot)}function emptyImportedDocument(){return{metadata:{},body:""}}async function commitImportedItem(params){const{pmRoot,id,itemPath,document,author,message,settings,conflictWarningPrefix}=params;const historyPath=getHistoryPath(pmRoot,id);const beforeDocument=emptyImportedDocument();try{const releaseLock=await acquireLock(pmRoot,id,settings.locks.ttl_seconds,author,false,settings.governance.force_required_for_stale_lock,settings.locks.wait_ms);try{await writeFileAtomic(itemPath,serializeItemDocument(document,{format:"toon"}));try{const entry=createHistoryEntry({nowIso:nowIso(),author,op:"import",before:beforeDocument,after:document,message});await appendHistoryEntry(historyPath,entry);const writeWarnings=[...await runActiveOnWriteHooks({path:itemPath,scope:"project",op:"import",item_id:document.metadata.id,item_type:document.metadata.type,before:beforeDocument,after:document,changed_fields:["imported"]}),...await runActiveOnWriteHooks({path:historyPath,scope:"project",op:"import:history",item_id:document.metadata.id,item_type:document.metadata.type,before:beforeDocument,after:document,changed_fields:["imported"]})];return{committed:true,writeWarnings}}catch(error){await removeFileIfExists(itemPath);throw error}}finally{await releaseLock()}}catch(error){if(error instanceof PmCliError&&error.exitCode===EXIT_CODE.CONFLICT){return{committed:false,conflictWarning:`${conflictWarningPrefix}:${id}`}}throw error}}export{commitImportedItem,emptyImportedDocument,ensureTrackerInitialized,selectImportAuthor,toEstimatedMinutesValue,toImportBoolean,toImportConfidence,toImportInteger,toImportLinkScope,toImportLinkedDocs,toImportLinkedFiles,toImportLinkedTests,toImportLogEntries,toImportNormalizedEnum,toImportNumberMap,toImportPriority,toImportStatus,toImportStringList,toImportStringMap,toImportTags,toNonEmptyImportString};
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="aba4af26-98d3-53aa-8b23-1be7c90a38d1")}catch(e2){}})();import{appendHistoryEntry,createHistoryEntry}from"../core/history/history.js";import{acquireLock}from"../core/lock/lock.js";import{enforceWorkflowMutation}from"../core/policy/workflow-policy-store.js";import{parseTags}from"../core/item/parse.js";import{normalizeStatusInput}from"../core/item/status.js";import{serializeItemDocument}from"../core/item/item-format.js";import{getHistoryPath}from"../core/store/paths.js";import{removeFileIfExists,writeFileAtomic}from"../core/fs/fs-utils.js";import{runActiveOnWriteHooks}from"../core/extensions/index.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{resolveAuthor}from"../core/shared/author.js";import{nowIso}from"../core/shared/time.js";import{assertInitializedTracker}from"./environment/tracker-preflight.js";function toNonEmptyImportString(value){if(typeof value!=="string"){return void 0}const trimmed=value.trim();return trimmed.length>0?trimmed:void 0}function toEstimatedMinutesValue(value){if(typeof value==="number"&&Number.isFinite(value)&&value>=0){return value}if(typeof value==="string"&&value.trim().length>0){const parsed=Number(value);if(Number.isFinite(parsed)&&parsed>=0){return parsed}}return void 0}function toImportPriority(value){if(typeof value==="number"&&Number.isInteger(value)&&value>=0&&value<=4){return value}if(typeof value==="string"&&value.trim().length>0){const parsed=Number(value);if(Number.isInteger(parsed)&&parsed>=0&&parsed<=4){return parsed}}return 2}function toImportTags(value){if(Array.isArray(value)){const tags=value.filter(entry=>typeof entry==="string").map(entry=>entry.trim().toLowerCase()).filter(entry=>entry.length>0);return Array.from(new Set(tags)).sort((left,right)=>left.localeCompare(right))}if(typeof value==="string"){return parseTags(value)}return[]}function toImportStatus(value){const normalized=toNonEmptyImportString(value);if(normalized){const canonical=normalizeStatusInput(normalized);if(canonical){return canonical}}return"open"}function toImportInteger(value){if(typeof value==="number"&&Number.isInteger(value)){return value}if(typeof value!=="string"||value.trim().length===0){return void 0}const parsed=Number(value);return Number.isInteger(parsed)?parsed:void 0}function toImportBoolean(value){if(typeof value==="boolean"){return value}if(typeof value==="number"){return value===1?true:value===0?false:void 0}if(typeof value!=="string"){return void 0}const normalized=value.trim().toLowerCase();if(normalized==="true"||normalized==="1"){return true}return normalized==="false"||normalized==="0"?false:void 0}function toImportStringList(value){if(!Array.isArray(value)){return void 0}const entries=value.map(entry=>toNonEmptyImportString(entry)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function toImportStringMap(value){return toImportValueMap(value,toNonEmptyImportString)}function toImportNumberMap(value){return toImportValueMap(value,toImportFiniteNumber)}function toImportConfidence(value,allowedTextValues){if(typeof value==="number"&&Number.isInteger(value)&&value>=0&&value<=100){return value}const normalized=toNonEmptyImportString(value)?.toLowerCase();if(!normalized){return void 0}const candidate=normalized==="med"?"medium":normalized;if(allowedTextValues.some(entry=>entry===candidate)){return candidate}const parsed=Number(candidate);return Number.isInteger(parsed)&&parsed>=0&&parsed<=100?parsed:void 0}function toImportNormalizedEnum(value,allowed){const normalized=toNonEmptyImportString(value)?.toLowerCase();if(!normalized){return void 0}const candidate=normalized==="med"?"medium":normalized;return allowed.includes(candidate)?candidate:void 0}function toImportLinkScope(value){return toNonEmptyImportString(value)?.toLowerCase()==="global"?"global":"project"}function toImportLogEntries(value,options){const values=normalizeImportCollection(value,options.allowScalar===true);if(!values){return void 0}const entries=values.map(entry=>toImportLogEntry(entry,options)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function toImportLinkedFiles(value,options={}){return toImportLinkedArtifacts(value,options,(pathValue,record)=>({path:pathValue,scope:toImportLinkScope(record?.scope),note:toNonEmptyImportString(record?.note)}))}function toImportLinkedDocs(value,options={}){return toImportLinkedArtifacts(value,options,(pathValue,record)=>({path:pathValue,scope:toImportLinkScope(record?.scope),note:toNonEmptyImportString(record?.note)}))}function toImportLinkedTests(value,options={}){const values=normalizeImportCollection(value,options.allowScalar===true);if(!values){return void 0}const entries=values.map(entry=>toImportLinkedTest(entry,options)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function selectImportAuthor(explicitAuthor,settingsAuthor){return resolveAuthor(explicitAuthor,settingsAuthor)}function isImportRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}function normalizeImportCollection(value,allowScalar){if(Array.isArray(value)){return value}return allowScalar?[value]:void 0}function firstNonEmptyImportString(record,keys){for(const key of keys){const value=toNonEmptyImportString(record[key]);if(value){return value}}return void 0}function toImportValueMap(value,coerce){if(!isImportRecord(value)){return void 0}const entries=Object.entries(value).map(([key,entryValue])=>[key.trim(),coerce(entryValue)]).filter(entry=>entry[0].length>0&&entry[1]!==void 0);return entries.length>0?Object.fromEntries(entries):void 0}function toImportLogEntry(entry,options){if(typeof entry==="string"){return toImportLogEntryFromText(entry,options)}if(!isImportRecord(entry)){return void 0}const text=firstNonEmptyImportString(entry,options.textKeys??["text"]);if(!text){return void 0}const createdAtKey=options.createdAtKey??"created_at";const authorKey=options.authorKey??"author";const createdAt=(options.toIsoString?options.toIsoString(entry[createdAtKey]):toNonEmptyImportString(entry[createdAtKey]))??options.fallbackCreatedAt;return{created_at:createdAt,author:toNonEmptyImportString(entry[authorKey])??options.fallbackAuthor,text}}function toImportLogEntryFromText(entry,options){const text=toNonEmptyImportString(entry);return text?{created_at:options.fallbackCreatedAt,author:options.fallbackAuthor,text}:void 0}function toImportLinkedArtifacts(value,options,build){const values=normalizeImportCollection(value,options.allowScalar===true);if(!values){return void 0}const pathKeys=options.pathKeys??["path"];const entries=values.map(entry=>toImportLinkedArtifact(entry,pathKeys,build)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function toImportLinkedArtifact(entry,pathKeys,build){if(typeof entry==="string"){const pathValue2=toNonEmptyImportString(entry);return pathValue2?build(pathValue2):void 0}if(!isImportRecord(entry)){return void 0}const pathValue=firstNonEmptyImportString(entry,pathKeys);return pathValue?build(pathValue,entry):void 0}function toImportLinkedTest(entry,options){if(typeof entry==="string"){const command2=toNonEmptyImportString(entry);return command2?{command:command2,scope:"project"}:void 0}if(!isImportRecord(entry)){return void 0}const command=firstNonEmptyImportString(entry,options.commandKeys??["command"]);const testPath=firstNonEmptyImportString(entry,options.pathKeys??["path"]);if(!command&&(options.requireCommand===true||!testPath)){return void 0}return{...command?{command}:{},...testPath?{path:testPath}:{},scope:toImportLinkScope(entry.scope),timeout_seconds:toImportLinkedTestTimeout(entry.timeout_seconds,options),note:toNonEmptyImportString(entry.note),...options.includeExtendedAssertions===true?toImportLinkedTestAssertions(entry):{}}}function toImportLinkedTestTimeout(value,options){const parsed=options.integerTimeout===true?toImportInteger(value):toImportFiniteNumber(value);if(parsed===void 0){return void 0}const minimum=options.timeoutMinimum??0;return options.timeoutExclusiveMinimum===true?parsed>minimum?parsed:void 0:parsed>=minimum?parsed:void 0}function toImportFiniteNumber(value){if(typeof value==="number"&&Number.isFinite(value)){return value}if(typeof value!=="string"||value.trim().length===0){return void 0}const parsed=Number(value);return Number.isFinite(parsed)?parsed:void 0}function toImportLinkedTestAssertions(entry){return{pm_context_mode:toImportNormalizedEnum(entry.pm_context_mode,["schema","tracker","auto"]),env_set:toImportStringMap(entry.env_set),env_clear:toImportStringList(entry.env_clear),shared_host_safe:toImportBoolean(entry.shared_host_safe),assert_stdout_contains:toImportStringList(entry.assert_stdout_contains),assert_stdout_regex:toImportStringList(entry.assert_stdout_regex),assert_stderr_contains:toImportStringList(entry.assert_stderr_contains),assert_stderr_regex:toImportStringList(entry.assert_stderr_regex),assert_stdout_min_lines:toImportInteger(entry.assert_stdout_min_lines),assert_json_field_equals:toImportStringMap(entry.assert_json_field_equals),assert_json_field_gte:toImportNumberMap(entry.assert_json_field_gte)}}async function ensureTrackerInitialized(pmRoot){await assertInitializedTracker(pmRoot)}function emptyImportedDocument(){return{metadata:{},body:""}}async function commitImportedItem(params){const{pmRoot,id,itemPath,document,author,message,settings,conflictWarningPrefix}=params;const historyPath=getHistoryPath(pmRoot,id);const beforeDocument=emptyImportedDocument();try{const releaseLock=await acquireLock(pmRoot,id,settings.locks.ttl_seconds,author,false,settings.governance.force_required_for_stale_lock,settings.locks.wait_ms);try{const workflowPolicy=await enforceWorkflowMutation({pmRoot,settings,operation:"import",author,before:null,after:document});await writeFileAtomic(itemPath,serializeItemDocument(document,{format:"toon"}));try{const entry=createHistoryEntry({nowIso:nowIso(),author,op:"import",before:beforeDocument,after:document,message,context:workflowPolicy.decisions.length===0?void 0:{workflow_policies:workflowPolicy.decisions}});await appendHistoryEntry(historyPath,entry);const writeWarnings=[...workflowPolicy.warnings,...await runActiveOnWriteHooks({path:itemPath,scope:"project",op:"import",item_id:document.metadata.id,item_type:document.metadata.type,before:beforeDocument,after:document,changed_fields:["imported"]}),...await runActiveOnWriteHooks({path:historyPath,scope:"project",op:"import:history",item_id:document.metadata.id,item_type:document.metadata.type,before:beforeDocument,after:document,changed_fields:["imported"]})];return{committed:true,writeWarnings}}catch(error){await removeFileIfExists(itemPath);throw error}}finally{await releaseLock()}}catch(error){if(error instanceof PmCliError&&error.exitCode===EXIT_CODE.CONFLICT&&!error.code?.startsWith("workflow_policy_")){return{committed:false,conflictWarning:`${conflictWarningPrefix}:${id}`}}throw error}}export{commitImportedItem,emptyImportedDocument,ensureTrackerInitialized,selectImportAuthor,toEstimatedMinutesValue,toImportBoolean,toImportConfidence,toImportInteger,toImportLinkScope,toImportLinkedDocs,toImportLinkedFiles,toImportLinkedTests,toImportLogEntries,toImportNormalizedEnum,toImportNumberMap,toImportPriority,toImportStatus,toImportStringList,toImportStringMap,toImportTags,toNonEmptyImportString};
 //# sourceMappingURL=package-import-adapters.js.map