@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/lifecycle/update.js

@@ -1,2137 +1,2 @@
-/**
- * @module sdk/lifecycle/update
- *
- * Implements the pm update command surface and its agent-facing runtime behavior.
- */
-
-!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]="5a6614ac-62fd-5680-9eed-447bfb7a167f")}catch(e){}}();
-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] : undefined,
-    };
-    /* c8 ignore start -- unset dedupe helper branch permutations are covered by legacy option compatibility suites. */
-    const appendUnsetTarget = (value) => {
-        const current = normalized.unset ? [...normalized.unset] : [];
-        if (!current.includes(value)) {
-            current.push(value);
-        }
-        normalized.unset = current;
-    };
-    /* c8 ignore stop */
-    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;
-        }
-        /* c8 ignore start -- rank alias canonicalization is exercised in legacy-option compatibility tests. */
-        const canonicalUnset = optionKey === "rank"
-            ? "order"
-            : (UPDATE_OPTION_KEY_TO_UNSET_CANONICAL.get(optionKey) ?? optionKey);
-        appendUnsetTarget(canonicalUnset);
-        normalized[optionKey] = undefined;
-        /* c8 ignore stop */
-    }
-    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 }
-                    : undefined);
-            return definition;
-        },
-    });
-}
-// Restricted append-style flags have dedicated commands with their own
-// ownership semantics; map each one to its exact replacement invocation so
-// scope errors tell the agent how to retry instead of dead-ending. The
-// evidence append flags are allowed by the metadata ownership bypass, but still used by
-// narrower scopes such as the dependency ownership bypass.
-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) {
-    // Only surface replacement commands for restricted flags the caller actually
-    // passed, so the guidance is an exact retry path.
-    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 disallowedFlags = [];
-        pushIf(options.title !== undefined, "--title", disallowedFlags);
-        pushIf(options.description !== undefined, "--description", disallowedFlags);
-        pushIf(options.body !== undefined, "--body", disallowedFlags);
-        pushIf(options.status !== undefined, "--status", disallowedFlags);
-        pushIf(options.closeReason !== undefined, "--close-reason", disallowedFlags);
-        pushIf(options.priority !== undefined, "--priority", disallowedFlags);
-        pushIf(options.type !== undefined, "--type", disallowedFlags);
-        pushIf(options.tags !== undefined, "--tags", disallowedFlags);
-        pushIf(Array.isArray(options.addTags) && options.addTags.length > 0, "--add-tags", disallowedFlags);
-        pushIf(Array.isArray(options.removeTags) && options.removeTags.length > 0, "--remove-tags", disallowedFlags);
-        pushIf(options.deadline !== undefined, "--deadline", disallowedFlags);
-        pushIf(options.estimatedMinutes !== undefined, "--estimate", disallowedFlags);
-        pushIf(options.acceptanceCriteria !== undefined, "--acceptance-criteria", disallowedFlags);
-        pushIf(Array.isArray(options.addAc) && options.addAc.length > 0, "--add-ac", disallowedFlags);
-        pushIf(Array.isArray(options.removeAc) && options.removeAc.length > 0, "--remove-ac", disallowedFlags);
-        pushIf(options.definitionOfReady !== undefined, "--definition-of-ready", disallowedFlags);
-        pushIf(options.order !== undefined || options.rank !== undefined, "--order/--rank", disallowedFlags);
-        pushIf(options.goal !== undefined, "--goal", disallowedFlags);
-        pushIf(options.objective !== undefined, "--objective", disallowedFlags);
-        pushIf(options.value !== undefined, "--value", disallowedFlags);
-        pushIf(options.impact !== undefined, "--impact", disallowedFlags);
-        pushIf(options.outcome !== undefined, "--outcome", disallowedFlags);
-        pushIf(options.whyNow !== undefined, "--why-now", disallowedFlags);
-        pushIf(options.assignee !== undefined, "--assignee", disallowedFlags);
-        pushIf(options.parent !== undefined, "--parent", disallowedFlags);
-        pushIf(options.reviewer !== undefined, "--reviewer", disallowedFlags);
-        pushIf(options.risk !== undefined, "--risk", disallowedFlags);
-        pushIf(options.confidence !== undefined, "--confidence", disallowedFlags);
-        pushIf(options.sprint !== undefined, "--sprint", disallowedFlags);
-        pushIf(options.release !== undefined, "--release", disallowedFlags);
-        pushIf(options.blockedBy !== undefined, "--blocked-by", disallowedFlags);
-        pushIf(options.blockedReason !== undefined, "--blocked-reason", disallowedFlags);
-        pushIf(options.unblockNote !== undefined, "--unblock-note", disallowedFlags);
-        pushIf(options.reporter !== undefined, "--reporter", disallowedFlags);
-        pushIf(options.severity !== undefined, "--severity", disallowedFlags);
-        pushIf(options.environment !== undefined, "--environment", disallowedFlags);
-        pushIf(options.reproSteps !== undefined, "--repro-steps", disallowedFlags);
-        pushIf(options.resolution !== undefined, "--resolution", disallowedFlags);
-        pushIf(options.expectedResult !== undefined, "--expected-result", disallowedFlags);
-        pushIf(options.actualResult !== undefined, "--actual-result", disallowedFlags);
-        pushIf(options.affectedVersion !== undefined, "--affected-version", disallowedFlags);
-        pushIf(options.fixedVersion !== undefined, "--fixed-version", disallowedFlags);
-        pushIf(options.component !== undefined, "--component", disallowedFlags);
-        pushIf(options.regression !== undefined, "--regression", disallowedFlags);
-        pushIf(options.customerImpact !== undefined, "--customer-impact", disallowedFlags);
-        pushIf(options.depRemove !== undefined, "--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.comment !== undefined, "--comment", disallowedFlags);
-        pushIf(options.note !== undefined, "--note", disallowedFlags);
-        pushIf(options.learning !== undefined, "--learning", disallowedFlags);
-        pushIf(options.file !== undefined, "--file", disallowedFlags);
-        pushIf(options.test !== undefined, "--test", disallowedFlags);
-        pushIf(options.doc !== undefined, "--doc", disallowedFlags);
-        pushIf(options.reminder !== undefined, "--reminder", disallowedFlags);
-        pushIf(options.event !== undefined, "--event", disallowedFlags);
-        pushIf(options.typeOption !== undefined, "--type-option", 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);
-        pushIf(options.clearTypeOptions === true, "--clear-type-options", disallowedFlags);
-        pushIf(options.force === true, "--force", disallowedFlags);
-        pushIf(clearItemMetadataKeys.size > 0, "--unset", disallowedFlags);
-        if (options.dep === undefined || options.dep.length === 0) {
-            throw new PmCliError("The dependency ownership bypass requires at least one --dep value", EXIT_CODE.USAGE);
-        }
-        if (disallowedFlags.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: ${disallowedFlags.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,
-            });
-        }
-        return;
-    }
-    const disallowedFlags = [];
-    pushIf(options.status !== undefined, "--status", disallowedFlags);
-    pushIf(options.closeReason !== undefined, "--close-reason", disallowedFlags);
-    pushIf(options.assignee !== undefined, "--assignee", disallowedFlags);
-    pushIf(options.parent !== undefined, "--parent", disallowedFlags);
-    pushIf(options.blockedBy !== undefined, "--blocked-by", disallowedFlags);
-    pushIf(options.blockedReason !== undefined, "--blocked-reason", disallowedFlags);
-    pushIf(options.unblockNote !== undefined, "--unblock-note", disallowedFlags);
-    pushIf(options.dep !== undefined, "--dep", disallowedFlags);
-    pushIf(options.depRemove !== undefined, "--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 !== undefined, "--note", disallowedFlags);
-    pushIf(options.learning !== undefined, "--learning", disallowedFlags);
-    pushIf(options.test !== undefined, "--test", disallowedFlags);
-    pushIf(options.reminder !== undefined, "--reminder", disallowedFlags);
-    pushIf(options.event !== undefined, "--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);
-    /* c8 ignore start -- unset ordering fallback is validated by package-governance integration coverage. */
-    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("_", "-")}`);
-    /* c8 ignore stop */
-    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,
-        });
-    }
-}
-/* c8 ignore start -- lifecycle/dependency edge branches are exercised by dedicated update workflow integration tests. */
-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;
-}
-/** Enforce per-type allowed-transition rules (governance.workflow_enforcement). `off` (default) or an unrestricted type is a no-op. `strict` throws on a disallowed transition; `warn` returns a warning string surfaced on the update result. The target status is the raw `--status` value (resolved case-insensitively through the registry inside evaluateTransition). */
-function enforceTypeWorkflowTransition(params) {
-    if (params.enforcement === "off" || params.typeWorkflows.length === 0) {
-        return undefined;
-    }
-    const result = evaluateTransition({
-        typeName: params.typeName,
-        fromStatus: params.fromStatus,
-        toStatus: params.toStatus,
-        typeWorkflows: params.typeWorkflows,
-        statusRegistry: params.statusRegistry,
-    });
-    if (!result.hasRule || result.allowed) {
-        return undefined;
-    }
-    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 === undefined)
-        return undefined;
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
-/** Allowed CSV/markdown keys for the update `--dep` addition seed (GH-258). */
-const DEP_ADDITION_KEYS = [
-    "id",
-    "kind",
-    "type",
-    "author",
-    "created_at",
-    "source_kind",
-];
-/** Allowed CSV/markdown keys for the `--dep-remove` selector (GH-258). */
-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;
-    }
-    // A first-key typo (e.g. `bogus=v,id=pm-2`) must still be parsed so the unknown
-    // key is rejected rather than swallowed as a bare item id (GH-258).
-    return looksLikeGenericKeyValueEntry(raw);
-}
-function normalizeDependencyKindInput(raw) {
-    return typeof raw === "string"
-        ? (resolveCanonicalRelationshipKind(raw) ?? raw.trim())
-        : raw;
-}
-/** Parse dependency additions into their canonical storage representation. */
-export 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")
-                    : undefined,
-                source_kind: sourceKind,
-                author,
-                created_at: createdAt
-                    ? normalizeDependencyTimestamp(createdAt)
-                    : undefined,
-            };
-        }
-        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("\u0000");
-}
-/** Return the complete normalized identity of one stored dependency row. */
-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("\u0000");
-}
-// pm-kyd6: `--blocked-by` writes the `blocked_by` scalar, but the dependency
-// graph (`pm deps`) is built only from the `dependencies` array. Mirror the
-// behaviour create.ts already has so the metadata and the graph agree: a
-// resolvable blocker also gets a `blocked_by` dependency edge. Repeated
-// `--blocked-by` updates preserve prior blocker edges because the graph is the
-// full dependency record; the scalar remains the latest primary blocker for
-// backward compatibility. Clearing the scalar removes all derived blocker edges.
-function reconcileBlockedByDependency(current, nextBlockedById, nowIsoValue, author) {
-    let next = [...(current ?? [])];
-    let changed = false;
-    if (nextBlockedById === undefined) {
-        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 : undefined, 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 : undefined, changed: true };
-}
-// pm-kyd6: resolve the --blocked-by target before the synchronous mutate
-// callback so a real blocker can also become a `blocked_by` dependency edge.
-// `id` is set when the target resolves; `unresolved` carries the raw value when
-// --blocked-by points at an item that does not exist (the scalar is still set,
-// mirroring create.ts and the never-block missing-parent behaviour, but the
-// caller surfaces a warning so the metadata/graph mismatch is visible).
-async function resolveBlockedByDependencyTarget(blockedByOption, blockedByCleared, pmRoot, idPrefix, itemFormat, typeToFolder) {
-    if (blockedByOption === undefined || 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 };
-}
-// pm-kyd6: apply the reconciled blocked_by dependency edge to the item metadata
-// and record the `dependencies` change. Kept out of the mutate callback so the
-// large runUpdate function stays under the static-quality complexity budget.
-function applyBlockedByDependencyEdge(metadata, resolvedBlockedById, nowIsoValue, author, changedFields) {
-    const reconciled = reconcileBlockedByDependency(metadata.dependencies, resolvedBlockedById, nowIsoValue, author);
-    if (!reconciled.changed) {
-        return;
-    }
-    if (reconciled.dependencies === undefined) {
-        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 !== undefined &&
-        value.source_kind?.trim().toLowerCase() !==
-            selector.source_kind.trim().toLowerCase()) {
-        return false;
-    }
-    if (selector.author !== undefined &&
-        value.author?.trim().toLowerCase() !== selector.author.trim().toLowerCase()) {
-        return false;
-    }
-    if (selector.created_at !== undefined &&
-        (value.created_at === undefined ||
-            !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 !== undefined);
-    mark("description", options.description !== undefined);
-    mark("body", options.body !== undefined);
-    mark("status", options.status !== undefined);
-    mark("closeReason", options.closeReason !== undefined);
-    mark("priority", options.priority !== undefined);
-    mark("type", options.type !== undefined);
-    // `--add-tags` / `--remove-tags` mutate the same `tags` field as `--tags`, so
-    // they count toward the `tags` command_option_policy (disabled + required).
-    mark("tags", options.tags !== undefined ||
-        (Array.isArray(options.addTags) && options.addTags.length > 0) ||
-        (Array.isArray(options.removeTags) && options.removeTags.length > 0));
-    mark("deadline", options.deadline !== undefined);
-    mark("estimatedMinutes", options.estimatedMinutes !== undefined);
-    // `--add-ac` / `--remove-ac` mutate the same `acceptance_criteria` field as
-    // `--acceptance-criteria`, so they count toward its command_option_policy.
-    mark("acceptanceCriteria", options.acceptanceCriteria !== undefined ||
-        (Array.isArray(options.addAc) && options.addAc.length > 0) ||
-        (Array.isArray(options.removeAc) && options.removeAc.length > 0));
-    mark("definitionOfReady", options.definitionOfReady !== undefined);
-    mark("order", options.order !== undefined || options.rank !== undefined);
-    mark("goal", options.goal !== undefined);
-    mark("objective", options.objective !== undefined);
-    mark("value", options.value !== undefined);
-    mark("impact", options.impact !== undefined);
-    mark("outcome", options.outcome !== undefined);
-    mark("whyNow", options.whyNow !== undefined);
-    mark("author", options.author !== undefined);
-    mark("message", options.message !== undefined);
-    mark("assignee", options.assignee !== undefined);
-    mark("parent", options.parent !== undefined);
-    mark("reviewer", options.reviewer !== undefined);
-    mark("risk", options.risk !== undefined);
-    mark("confidence", options.confidence !== undefined);
-    mark("sprint", options.sprint !== undefined);
-    mark("release", options.release !== undefined);
-    mark("blockedBy", options.blockedBy !== undefined);
-    mark("blockedReason", options.blockedReason !== undefined);
-    mark("unblockNote", options.unblockNote !== undefined);
-    mark("reporter", options.reporter !== undefined);
-    mark("severity", options.severity !== undefined);
-    mark("environment", options.environment !== undefined);
-    mark("reproSteps", options.reproSteps !== undefined);
-    mark("resolution", options.resolution !== undefined);
-    mark("expectedResult", options.expectedResult !== undefined);
-    mark("actualResult", options.actualResult !== undefined);
-    mark("affectedVersion", options.affectedVersion !== undefined);
-    mark("fixedVersion", options.fixedVersion !== undefined);
-    mark("component", options.component !== undefined);
-    mark("regression", options.regression !== undefined);
-    mark("customerImpact", options.customerImpact !== undefined);
-    mark("dep", options.dep !== undefined);
-    mark("depRemove", options.depRemove !== undefined);
-    mark("dep", options.replaceDeps === true);
-    mark("comment", options.comment !== undefined);
-    mark("note", options.note !== undefined);
-    mark("learning", options.learning !== undefined);
-    mark("file", options.file !== undefined);
-    mark("test", options.test !== undefined);
-    mark("test", options.replaceTests === true);
-    mark("file", options.replaceFiles === true);
-    mark("doc", options.replaceDocs === true);
-    mark("doc", options.doc !== undefined);
-    mark("reminder", options.reminder !== undefined);
-    mark("event", options.event !== undefined);
-    mark("typeOption", options.typeOption !== undefined);
-    mark("field", options.field !== undefined);
-    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);
-        }
-    }
-}
-// `rank` is a legacy alias for `order`; keep it out of the scalar loop if the
-// shared mutation key list ever grows to include that alias.
-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 === undefined && !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));
-}
-/** Resolve update stdin tokens once while preserving transport-marked literals. */
-export 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);
-    }
-}
-/** Validate mutually exclusive and required update mutation option combinations. */
-export function assertUpdateMutationOptionCombinations(options) {
-    const hasAdditiveAcceptanceCriteriaMutation = (options.addAc?.length ?? 0) > 0 || (options.removeAc?.length ?? 0) > 0;
-    if (options.acceptanceCriteria !== undefined &&
-        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 === undefined || options.dep.length === 0)) {
-        throw new PmCliError("--replace-deps requires at least one --dep entry", EXIT_CODE.USAGE);
-    }
-    if (options.replaceDeps === true &&
-        options.depRemove !== undefined &&
-        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] !== undefined;
-    }
-    presence.order = options.order !== undefined || options.rank !== undefined;
-    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.`
-            : undefined;
-        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] !== undefined;
-    }
-    flags.tags = options.tags !== undefined;
-    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 !== undefined;
-    flags.rank = options.rank !== undefined;
-    flags.replaceDeps = options.replaceDeps === true;
-    flags.replaceTests = options.replaceTests === true;
-    flags.replaceFiles = options.replaceFiles === true;
-    flags.replaceDocs = options.replaceDocs === true;
-    flags.unset = options.unset !== undefined && 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 undefined;
-    return listAllItemMetadataLight(params.pmRoot, params.settings.item_format, params.typeToFolder, undefined, 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 !== undefined &&
-        options.rank !== undefined &&
-        options.order !== options.rank) {
-        throw new PmCliError("--order and --rank must match when both are provided", EXIT_CODE.USAGE);
-    }
-}
-/** Canonicalize local parent input before self/existence checks; preserve explicit remote locators and explicit unsets. */
-async function resolveParentReferenceForUpdate(params) {
-    if (params.options.parent === undefined ||
-        params.unsetTargets.metadataKeys.has("parent")) {
-        return { resolvedParentValue: undefined, 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 === undefined
-        ? []
-        : [`blocked_by_unresolved:${resolution.unresolved}`];
-}
-async function collectWorkflowTransitionWarnings(params) {
-    if (params.workflowEnforcement === "off" ||
-        params.typeWorkflows.length === 0 ||
-        !params.fieldFlags.status ||
-        params.options.status === undefined) {
-        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 !== undefined
-        ? (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] : [];
-}
-/** Delegate the configured close transition to the closure writer, applying other requested fields first and retaining its evidence. */
-async function routeCloseStatusUpdate(context) {
-    if (!context.fieldFlags.status) {
-        return undefined;
-    }
-    const targetStatus = normalizeStatusInput(context.options.status, context.statusRegistry);
-    if (targetStatus !== context.statusRegistry.close_status) {
-        return undefined;
-    }
-    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: undefined,
-            closeReason: undefined,
-            message: undefined,
-        });
-        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 !== undefined) {
-        document.metadata.title = requireStringOption(options.title, "--title");
-        changedFields.push("title");
-    }
-    if (options.description !== undefined) {
-        document.metadata.description = options.description;
-        changedFields.push("description");
-    }
-    if (options.body !== undefined) {
-        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",
-];
-/** Remove stale terminal evidence when work returns to an active lifecycle. */
-function clearTerminalEvidence(metadata, changedFields) {
-    for (const key of TERMINAL_EVIDENCE_METADATA_KEYS) {
-        if (metadata[key] === undefined) {
-            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 === undefined ||
-            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 !== undefined) {
-        applyStatusMutation(document, context, context.options.status, previousStatusNormalized, changedFields);
-    }
-    if (context.options.completedAt !== undefined) {
-        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 !== undefined ||
-        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 !== undefined &&
-        isTerminalStatus(previousStatusNormalized, context.statusRegistry) &&
-        !isTerminalStatus(document.metadata.status, context.statusRegistry) &&
-        document.metadata.close_reason !== undefined) {
-        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);
-}
-/** Resolve priority and type changes against runtime registries before enforcing type-specific options and recording changed fields. */
-function applyPriorityTypeAndOptions(document, context, changedFields) {
-    let activeTypeName = resolveTypeName(document.metadata.type, context.typeRegistry) ??
-        document.metadata.type;
-    if (context.options.priority !== undefined) {
-        document.metadata.priority = resolvePriority(context.options.priority);
-        changedFields.push("priority");
-    }
-    if (context.options.type !== undefined) {
-        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 !== undefined ||
-        context.clearItemMetadataKeys.has("type_options")) {
-        if (context.clearItemMetadataKeys.has("type_options")) {
-            delete document.metadata.type_options;
-        }
-        else {
-            const parsedTypeOptions = parseTypeOptionEntries(context.options.typeOption ?? []);
-            const validation = validateTypeOptions(activeTypeName, parsedTypeOptions, context.typeRegistry);
-            if (validation.errors.length > 0) {
-                throw new PmCliError(validation.errors.join("; "), EXIT_CODE.USAGE);
-            }
-            document.metadata.type_options = validation.normalized;
-        }
-        changedFields.push("type_options");
-        return;
-    }
-    if (context.options.type === undefined ||
-        document.metadata.type_options === undefined) {
-        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;
-}
-/** Collapse duplicate rows only for identities explicitly touched by this mutation. */
-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;
-    });
-}
-/** Refuse lossless removals unless every selector resolves against stored edges. */
-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 === undefined &&
-        context.options.depRemove === undefined &&
-        !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 === undefined && !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 === undefined && !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 === undefined &&
-        !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 !== undefined &&
-        document.metadata.tests.length === 0) {
-        delete document.metadata.tests;
-    }
-    changedFields.push("tests");
-}
-function dedupeLinkedTests(values) {
-    if (!values || values.length === 0) {
-        return undefined;
-    }
-    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 !== undefined ||
-        context.clearItemMetadataKeys.has("tags") ||
-        hasAdditiveTagMutation) {
-        const baseTags = context.clearItemMetadataKeys.has("tags")
-            ? []
-            : context.options.tags !== undefined
-                ? 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);
-}
-// GH-612: `--add-ac` / `--remove-ac` edit individual "; "-separated criteria so
-// concurrent branch edits with disjoint additions merge instead of clobbering
-// the whole acceptance_criteria value (tag-API parity). Runs after the scalar
-// mutations so composition with a `--ac` replace uses the replaced base.
-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 === undefined) {
-        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 === undefined && !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 === undefined &&
-        !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 === undefined &&
-        !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] === undefined &&
-        !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 === undefined &&
-        !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 !== undefined) {
-        applyBlockedByDependencyEdge(document.metadata, context.resolvedBlockedByDependencyId, context.nowIso, context.author, changedFields);
-    }
-}
-function applyScheduleMutations(document, context, changedFields) {
-    if (context.options.reminder !== undefined ||
-        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 !== undefined ||
-        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] === undefined) {
-            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 !== undefined ||
-        context.options.depRemove !== undefined ||
-        context.options.blockedBy !== undefined ||
-        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 !== undefined) {
-        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 !== undefined &&
-        actualChangedFields.includes("acceptance_criteria")) {
-        warnings.push(`acceptance_criteria_replaced:${splitAcceptanceCriteria(beforeMetadata.acceptance_criteria).length}:${splitAcceptanceCriteria(afterMetadata.acceptance_criteria).length}`);
-    }
-    return { changedFields: actualChangedFields, warnings };
-}
-/** Implements run update for the public runtime surface of this module. */
-async function runUpdateWithContext(id, options, global, execution = {}) {
-    options = await resolveUpdateTransportOptions(options);
-    const pmRoot = resolvePmRoot(process.cwd(), global.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);
-    // Per-type allowed-transition enforcement is read RAW (not preset-derived) so
-    // existing projects are unaffected when unset; defaults to "off".
-    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,
-    });
-    // pm-kyd6: resolve the --blocked-by target up front (async) so the sync
-    // mutate callback can mirror create.ts and add a `blocked_by` dependency edge.
-    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,
-        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 }
-                    : undefined;
-                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 === undefined
-                ? {}
-                : { lifecycle_transition: lifecycleTransition }),
-        };
-    }
-    finally {
-        await releaseHierarchyMutationLock();
-    }
-}
-/** Resolve the immutable operation name for ordinary, bypass, and recurrence updates. */
-function resolveUpdateHistoryOperation(options, execution) {
-    if (options.ownershipMetadataBypass === true ||
-        options.ownershipDependencyBypass === true) {
-        return "update_ownership_bypass";
-    }
-    return execution.recurrenceReason === undefined ? "update" : "reopen";
-}
-/** Validate and capture a terminal-to-active recurrence while the item lock is held. */
-function prepareRecurrenceTransition(params) {
-    if (params.recurrenceReason === undefined) {
-        return undefined;
-    }
-    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,
-    };
-}
-/** Implements run update for the public runtime surface of this module. */
-export async function runUpdate(id, options, global) {
-    return runUpdateWithContext(id, options, global);
-}
-/** Execute a recurrence transition through the exact atomic update pipeline. */
-export async function runReopenUpdate(id, options, global, recurrenceReason) {
-    const result = await runUpdateWithContext(id, options, global, {
-        recurrenceReason,
-    });
-    if (result.lifecycle_transition === undefined) {
-        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 };
-}
-/* c8 ignore stop */
-/** Public contract for test only update command, shared by SDK and presentation-layer consumers. */
-export const _testOnlyUpdateCommand = {
-    applyStatusAndCloseReasonMutations,
-    collectProvidedUpdatePolicyOptions,
-    buildOwnershipBypassRestrictedOptionsError,
-    enforceOwnershipBypassScope,
-    enforceTypeWorkflowTransition,
-    matchesDependencySelector,
-    normalizeLegacyNoneUpdateOptions,
-    normalizeUpdatePolicyOptionKey,
-    parseDependencyAdditions,
-    parseDependencyRemovals,
-    parseUpdateUnsetTargets,
-    reconcileBlockedByDependency,
-    resolveRuntimeUnsetDefinition: (token, registry) => resolveRuntimeUnsetFieldDefinition(token, "update", registry),
-};
+!(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};
 //# sourceMappingURL=update.js.map
-//# debugId=5a6614ac-62fd-5680-9eed-447bfb7a167f