@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/sdk/lifecycle/update-many.js

@@ -1,862 +1,2 @@
-/**
- * @module cli/commands/update-many
- *
- * Implements the pm update many 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]="fada7a33-ad1d-54f1-ae03-c5f8e4568d75")}catch(e){}}();
-import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { createCheckpointId, loadMutationCheckpoint, restoreCheckpointItems, writeMutationCheckpoint, toItemRecord, applyAcceptanceCriteriaMutations, applyTagRemovals, mergeAdditiveTags, parseOptionalNonNegativeInteger, parseTags, splitAcceptanceCriteria, resolvePriority, normalizeStatusInput, resolveItemTypeRegistry, resolveTypeName, collectRuntimeUpdateFieldValues, buildInvalidTypeError, resolveItemTypesFilePath, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, toErrorMessage, stableValueEquals, nowIso, preserveMutationStdinTokenLiterals, resolveIsoOrRelative, getActiveExtensionRegistrations, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
-import { assertDependencyTargetsResolvable } from "../dependency-flag-validation.js";
-import { parseStatusFilterCsv } from "../../core/item/status-filter.js";
-import { hasListFilters } from "../query/list-filter-shared.js";
-import { runList, } from "../query/list.js";
-import { runRestore } from "./restore.js";
-import { assertUpdateMutationOptionCombinations, parseDependencyAdditions, resolveUpdateTransportOptions, runUpdate, } from "./update.js";
-import { derivePmBulkMutationEffect, } from "../cli-contracts/command-exit-contracts.js";
-const UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;
-const UPDATE_MANY_CHECKPOINT_SUBDIR = "update-many";
-const NON_MUTATION_UPDATE_OPTION_KEYS = new Set([
-    "author",
-    "message",
-    "force",
-    "ownershipMetadataBypass",
-    "ownershipDependencyBypass",
-    "allowUnresolvedDeps",
-]);
-const UPDATE_MANY_MUTATION_FLAG_GUIDANCE = [
-    "--status",
-    "--priority",
-    "--type",
-    "--tags",
-    "--description",
-    "--body",
-    "--deadline",
-    "--estimate",
-    "--assignee",
-    "--dep",
-    "--dep-remove",
-    "--comment",
-    "--note",
-    "--learning",
-    "--file",
-    "--test",
-    "--doc",
-    "--replace-deps",
-    "--replace-tests",
-    "--replace-files",
-    "--replace-docs",
-    "--unset",
-    "--clear-*",
-].join(", ");
-const UPDATE_OPTION_TO_ITEM_KEY = {
-    title: "title",
-    description: "description",
-    body: "body",
-    status: "status",
-    closeReason: "close_reason",
-    priority: "priority",
-    type: "type",
-    deadline: "deadline",
-    estimatedMinutes: "estimated_minutes",
-    acceptanceCriteria: "acceptance_criteria",
-    definitionOfReady: "definition_of_ready",
-    order: "order",
-    goal: "goal",
-    objective: "objective",
-    value: "value",
-    impact: "impact",
-    outcome: "outcome",
-    whyNow: "why_now",
-    assignee: "assignee",
-    parent: "parent",
-    reviewer: "reviewer",
-    risk: "risk",
-    confidence: "confidence",
-    sprint: "sprint",
-    release: "release",
-    blockedBy: "blocked_by",
-    blockedReason: "blocked_reason",
-    unblockNote: "unblock_note",
-    reporter: "reporter",
-    severity: "severity",
-    environment: "environment",
-    reproSteps: "repro_steps",
-    resolution: "resolution",
-    expectedResult: "expected_result",
-    actualResult: "actual_result",
-    affectedVersion: "affected_version",
-    fixedVersion: "fixed_version",
-    component: "component",
-    regression: "regression",
-    customerImpact: "customer_impact",
-};
-const COLLECTION_MUTATION_PLAN_DEFINITIONS = [
-    {
-        field: "dependencies",
-        addKey: "dep",
-        removeKey: "depRemove",
-        clearKey: "clearDeps",
-        replaceKey: "replaceDeps",
-    },
-    {
-        field: "comments",
-        addKey: "comment",
-        clearKey: "clearComments",
-    },
-    {
-        field: "notes",
-        addKey: "note",
-        clearKey: "clearNotes",
-    },
-    {
-        field: "learnings",
-        addKey: "learning",
-        clearKey: "clearLearnings",
-    },
-    {
-        field: "files",
-        addKey: "file",
-        clearKey: "clearFiles",
-        replaceKey: "replaceFiles",
-    },
-    {
-        field: "tests",
-        addKey: "test",
-        clearKey: "clearTests",
-        replaceKey: "replaceTests",
-    },
-    {
-        field: "docs",
-        addKey: "doc",
-        clearKey: "clearDocs",
-        replaceKey: "replaceDocs",
-    },
-    {
-        field: "reminders",
-        addKey: "reminder",
-        clearKey: "clearReminders",
-    },
-    {
-        field: "events",
-        addKey: "event",
-        clearKey: "clearEvents",
-    },
-    {
-        field: "type_options",
-        addKey: "typeOption",
-        clearKey: "clearTypeOptions",
-    },
-];
-const UNSET_FIELD_ALIASES = {
-    close_reason: "close_reason",
-    "close-reason": "close_reason",
-    deadline: "deadline",
-    estimate: "estimated_minutes",
-    estimated_minutes: "estimated_minutes",
-    "estimated-minutes": "estimated_minutes",
-    acceptance_criteria: "acceptance_criteria",
-    "acceptance-criteria": "acceptance_criteria",
-    ac: "acceptance_criteria",
-    definition_of_ready: "definition_of_ready",
-    "definition-of-ready": "definition_of_ready",
-    order: "order",
-    rank: "order",
-    goal: "goal",
-    objective: "objective",
-    value: "value",
-    impact: "impact",
-    outcome: "outcome",
-    why_now: "why_now",
-    "why-now": "why_now",
-    assignee: "assignee",
-    parent: "parent",
-    reviewer: "reviewer",
-    risk: "risk",
-    confidence: "confidence",
-    sprint: "sprint",
-    release: "release",
-    blocked_by: "blocked_by",
-    "blocked-by": "blocked_by",
-    blocked_reason: "blocked_reason",
-    "blocked-reason": "blocked_reason",
-    unblock_note: "unblock_note",
-    "unblock-note": "unblock_note",
-    reporter: "reporter",
-    severity: "severity",
-    environment: "environment",
-    repro_steps: "repro_steps",
-    "repro-steps": "repro_steps",
-    resolution: "resolution",
-    expected_result: "expected_result",
-    "expected-result": "expected_result",
-    actual_result: "actual_result",
-    "actual-result": "actual_result",
-    affected_version: "affected_version",
-    "affected-version": "affected_version",
-    fixed_version: "fixed_version",
-    "fixed-version": "fixed_version",
-    component: "component",
-    regression: "regression",
-    customer_impact: "customer_impact",
-    "customer-impact": "customer_impact",
-    type_options: "type_options",
-    "type-options": "type_options",
-    tags: "tags",
-};
-/** Removes execution-only options from the mutation summary persisted in checkpoints. */
-const sanitizeUpdateOptionsForSummary = (options) => {
-    const summary = {};
-    for (const [key, value] of Object.entries(options)) {
-        if (NON_MUTATION_UPDATE_OPTION_KEYS.has(key)) {
-            continue;
-        }
-        if (value === undefined) {
-            continue;
-        }
-        summary[key] = value;
-    }
-    return summary;
-};
-/** Reports whether an update-many request contains at least one mutation input. */
-const hasAnyUpdateMutationInput = (options) => {
-    return Object.keys(sanitizeUpdateOptionsForSummary(options)).length > 0;
-};
-/** Trims string preview values while preserving non-string inputs. */
-const trimPreviewValue = (value) => typeof value === "string" ? value.trim() : value;
-/** Converts integer-like preview values to their storage representation. */
-const normalizeIntegerPreviewValue = (value) => {
-    const trimmed = String(value).trim();
-    const parsed = Number(trimmed);
-    return Number.isInteger(parsed) ? parsed : trimmed;
-};
-/** Converts finite numeric preview values to their storage representation. */
-const normalizeNumericPreviewValue = (value) => {
-    const trimmed = String(value).trim();
-    const parsed = Number(trimmed);
-    return Number.isFinite(parsed) ? parsed : trimmed;
-};
-/** Converts supported regression tokens to their boolean storage representation. */
-const normalizeRegressionPreviewValue = (value) => {
-    const normalized = String(value).trim().toLowerCase();
-    const parsed = new Map([
-        ["true", true],
-        ["1", true],
-        ["false", false],
-        ["0", false],
-    ]).get(normalized);
-    return parsed ?? trimPreviewValue(value);
-};
-const PREVIEW_VALUE_NORMALIZERS = {
-    priority: normalizeIntegerPreviewValue,
-    estimatedMinutes: normalizeNumericPreviewValue,
-    order: normalizeNumericPreviewValue,
-    rank: normalizeNumericPreviewValue,
-    regression: normalizeRegressionPreviewValue,
-};
-/** Normalizes a CLI mutation value to the storage-shaped value used by previews. */
-const toComparablePreviewValue = (optionKey, value) => {
-    if (value === undefined) {
-        return undefined;
-    }
-    return (PREVIEW_VALUE_NORMALIZERS[optionKey] ?? trimPreviewValue)(value);
-};
-/** Resolves user-facing unset aliases to stored metadata keys. */
-const normalizeUnsetField = (rawField) => {
-    const normalized = rawField.trim().toLowerCase().replaceAll("-", "_");
-    return UNSET_FIELD_ALIASES[normalized] ?? normalized;
-};
-/** Compares preview values using the canonical stable serialization contract. */
-const areValuesEqual = (left, right) => {
-    return stableValueEquals(left, right);
-};
-/** Supplies the storage-shaped empty value for an absent collection field. */
-const normalizeCollectionBeforeValue = (field, value) => {
-    if (value !== undefined) {
-        return value;
-    }
-    if (field === "type_options") {
-        return {};
-    }
-    return [];
-};
-/** Counts entries in list and type-option collection values. */
-const collectionValueCount = (field, value) => {
-    if (Array.isArray(value)) {
-        return value.length;
-    }
-    if (field === "type_options" && value && typeof value === "object") {
-        return Object.keys(value).length;
-    }
-    return 0;
-};
-/** Resolves the dominant collection mutation using apply-path precedence. */
-const resolveCollectionMutationOperation = (params) => {
-    if (params.replace) {
-        return "replace";
-    }
-    if (params.clear) {
-        return "clear_or_reset";
-    }
-    return params.removeCount > 0 ? "merge_remove" : "append";
-};
-/** Reads an optional definition key without indexing through undefined. */
-const readOptionalUpdateValue = (update, key) => (key === undefined ? undefined : update[key]);
-/** Counts array-shaped mutation inputs while treating other shapes as empty. */
-const updateArrayValueCount = (value) => Array.isArray(value) ? value.length : 0;
-/** Builds one collection plan when its definition has an active mutation. */
-const buildCollectionMutationPlan = (definition, row, update) => {
-    const addValues = update[definition.addKey];
-    const removeValues = readOptionalUpdateValue(update, definition.removeKey);
-    const addCount = updateArrayValueCount(addValues);
-    const removeCount = updateArrayValueCount(removeValues);
-    const clear = update[definition.clearKey] === true;
-    const replace = readOptionalUpdateValue(update, definition.replaceKey) === true;
-    if (![clear, replace, addCount > 0, removeCount > 0].includes(true)) {
-        return undefined;
-    }
-    const before = normalizeCollectionBeforeValue(definition.field, row[definition.field]);
-    return {
-        field: definition.field,
-        before,
-        after: {
-            operation: resolveCollectionMutationOperation({
-                replace,
-                clear,
-                removeCount,
-            }),
-            clear,
-            replace,
-            add_count: addCount,
-            remove_count: removeCount,
-            before_count: collectionValueCount(definition.field, before),
-        },
-    };
-};
-/** Builds collection mutation previews for every active collection option. */
-const buildCollectionMutationPlans = (row, update) => {
-    const changes = [];
-    for (const definition of COLLECTION_MUTATION_PLAN_DEFINITIONS) {
-        const plan = buildCollectionMutationPlan(definition, row, update);
-        if (plan !== undefined) {
-            changes.push(plan);
-        }
-    }
-    return changes;
-};
-/** Keeps only string tags from an existing storage value. */
-const normalizeExistingTags = (value) => {
-    if (!Array.isArray(value)) {
-        return [];
-    }
-    return value.filter((tag) => typeof tag === "string");
-};
-// Tags support three mutation modes that compose: --tags replaces, --add-tags
-// extends, --remove-tags prunes. Replicate runUpdate's resolution order so the
-// dry-run preview and the apply-mode actionable detection both account for
-// additive/subtractive tag mutations (a --add-tags-only update must NOT be
-// treated as a no-op skip).
-const buildTagMutationPlan = (row, update) => {
-    if (![
-        update.tags !== undefined,
-        updateArrayValueCount(update.addTags) > 0,
-        updateArrayValueCount(update.removeTags) > 0,
-    ].includes(true)) {
-        return undefined;
-    }
-    const existing = normalizeExistingTags(row.tags);
-    const baseTags = update.tags === undefined ? existing : parseTags(update.tags);
-    const withAdditions = mergeAdditiveTags(baseTags, update.addTags);
-    const after = applyTagRemovals(withAdditions, update.removeTags)
-        .slice()
-        .sort((a, b) => a.localeCompare(b));
-    const before = existing.slice().sort((a, b) => a.localeCompare(b));
-    if (areValuesEqual(before, after)) {
-        return undefined;
-    }
-    return { field: "tags", before: existing, after };
-};
-// Acceptance criteria support replace (--ac) plus additive --add-ac/--remove-ac
-// (GH-612). Replicate runUpdate's resolution order so dry-run previews and
-// apply-mode actionable detection account for additive criterion mutations (an
-// --add-ac-only bulk update must NOT be treated as a no-op skip).
-const buildAcceptanceCriteriaMutationPlan = (row, update) => {
-    const before = row.acceptance_criteria;
-    const mutation = applyAcceptanceCriteriaMutations(splitAcceptanceCriteria(before), update.addAc, update.removeAc);
-    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,
-        });
-    }
-    const after = mutation.criteria.join("; ");
-    if (areValuesEqual(typeof before === "string" ? before : "", after)) {
-        return undefined;
-    }
-    return { field: "acceptance_criteria", before, after };
-};
-/** Adds changed scalar options to a planned item diff. */
-const appendScalarMutationPlans = (changes, row, update) => {
-    for (const [optionKey, itemKey] of Object.entries(UPDATE_OPTION_TO_ITEM_KEY)) {
-        const candidate = update[optionKey];
-        if (candidate === undefined) {
-            continue;
-        }
-        const before = row[itemKey];
-        const after = toComparablePreviewValue(optionKey, candidate);
-        if (!areValuesEqual(before, after)) {
-            changes.push({ field: itemKey, before, after });
-        }
-    }
-};
-/** Adds changed runtime-schema fields to a planned item diff. */
-const appendRuntimeFieldMutationPlans = (changes, row, update, runtimeFieldRegistry) => {
-    const runtimeFieldUpdates = collectRuntimeUpdateFieldValues(update, runtimeFieldRegistry, ["update_many"]);
-    for (const [field, after] of Object.entries(runtimeFieldUpdates)) {
-        const before = row[field];
-        if (!areValuesEqual(before, after)) {
-            changes.push({ field, before, after });
-        }
-    }
-};
-/** Adds present fields requested through unset options to a planned item diff. */
-const appendUnsetMutationPlans = (changes, row, unset) => {
-    for (const rawUnsetField of unset ?? []) {
-        const field = normalizeUnsetField(rawUnsetField);
-        const before = row[field];
-        if (before !== undefined) {
-            changes.push({ field, before, after: null });
-        }
-    }
-};
-/** Builds the complete storage-shaped mutation preview for one item. */
-const buildPlannedItemDiff = (item, runtimeFieldRegistry, update = {}) => {
-    const row = toItemRecord(item);
-    const changes = [];
-    const tagPlan = buildTagMutationPlan(row, update);
-    if (tagPlan) {
-        changes.push(tagPlan);
-    }
-    appendScalarMutationPlans(changes, row, update);
-    if (updateArrayValueCount(update.addAc) > 0 ||
-        updateArrayValueCount(update.removeAc) > 0) {
-        const acceptanceCriteriaChange = buildAcceptanceCriteriaMutationPlan(row, update);
-        if (acceptanceCriteriaChange !== undefined) {
-            changes.push(acceptanceCriteriaChange);
-        }
-    }
-    changes.push(...buildCollectionMutationPlans(row, update));
-    appendRuntimeFieldMutationPlans(changes, row, update, runtimeFieldRegistry);
-    appendUnsetMutationPlans(changes, row, update.unset);
-    return {
-        id: item.id,
-        changes,
-    };
-};
-/** Normalizes an optional list status against the runtime schema. */
-const normalizeStatusFilter = (value, statusRegistry) => {
-    return parseStatusFilterCsv(value, statusRegistry, {
-        strict: true,
-        flagLabel: "--filter-status",
-    });
-};
-/** Rejects an explicitly blank bulk ID filter before loading the corpus. */
-const rejectBlankIdsFilter = (list) => {
-    if (list?.ids != null && String(list.ids).trim().length === 0) {
-        throw new PmCliError("--ids requires at least one non-empty item ID", EXIT_CODE.USAGE);
-    }
-};
-const PLANNED_UPDATE_VALIDATORS = [
-    ({ update }) => {
-        if (update.priority !== undefined) {
-            resolvePriority(update.priority);
-        }
-    },
-    ({ update, settings, pmRoot }) => {
-        if (update.type === undefined) {
-            return;
-        }
-        const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-        if (!resolveTypeName(update.type, typeRegistry)) {
-            throw new PmCliError(buildInvalidTypeError(update.type, typeRegistry.types, resolveItemTypesFilePath(pmRoot, settings.schema)), EXIT_CODE.USAGE);
-        }
-    },
-    ({ update, statusRegistry }) => {
-        if (update.status !== undefined &&
-            !normalizeStatusInput(update.status, statusRegistry)) {
-            const allowedStatuses = statusRegistry.definitions.map((definition) => definition.id);
-            throw new PmCliError(`Invalid --status value "${update.status}". Allowed: ${allowedStatuses.join(", ")}`, EXIT_CODE.USAGE);
-        }
-    },
-    ({ update }) => {
-        if (update.deadline !== undefined) {
-            resolveIsoOrRelative(update.deadline, new Date(), "deadline");
-        }
-    },
-    ({ update }) => {
-        if (update.estimatedMinutes !== undefined) {
-            parseOptionalNonNegativeInteger(update.estimatedMinutes, "estimated-minutes");
-        }
-    },
-];
-/** Validates globally invalid mutation values before preview or checkpoint work. */
-const assertPlannedUpdateValuesValid = (update, settings, statusRegistry, pmRoot) => {
-    const context = { update, settings, statusRegistry, pmRoot };
-    for (const validate of PLANNED_UPDATE_VALIDATORS) {
-        validate(context);
-    }
-};
-/** Restores every item captured by an update-many checkpoint. */
-const runUpdateManyRollback = async (params) => {
-    const checkpoint = await loadMutationCheckpoint(params.pmRoot, UPDATE_MANY_CHECKPOINT_SUBDIR, params.rollbackId, UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION);
-    const restoreMessage = params.options.update?.message ??
-        `Rollback update-many checkpoint ${checkpoint.id}`;
-    const rollback = await restoreCheckpointItems(checkpoint.items, (id, targetUpdatedAt) => runRestore(id, targetUpdatedAt, {
-        author: params.options.update?.author,
-        message: restoreMessage,
-        force: params.options.update?.force ?? true,
-    }, params.global));
-    return {
-        ...derivePmBulkMutationEffect({
-            applied: rollback.restored_ids.length,
-            skipped: 0,
-            failed: rollback.failed_count,
-            unmatched: 0,
-        }),
-        mode: "rollback",
-        matched_count: checkpoint.items.length,
-        dry_run: false,
-        rollback_checkpoint_id: checkpoint.id,
-        checkpoint: {
-            id: checkpoint.id,
-            created_at: checkpoint.created_at,
-            path: checkpoint.path,
-            rollback_command: `pm update-many --rollback ${checkpoint.id}`,
-        },
-        restored_count: rollback.restored_ids.length,
-        failed_count: rollback.failed_count,
-        rows: rollback.rows,
-        ids: rollback.restored_ids,
-    };
-};
-/** Persists an apply checkpoint and returns its user-facing descriptor. */
-const writeUpdateManyCheckpoint = async (params) => {
-    const checkpointPayload = {
-        schema_version: UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION,
-        id: params.checkpointId,
-        created_at: params.nowValue,
-        author: resolveAuthor(params.options.update?.author, "unknown"),
-        status_filter: params.statusFilter ?? null,
-        list_filters: params.filters,
-        update_options: params.updateSummary,
-        items: params.checkpointItems,
-    };
-    const checkpointPath = await writeMutationCheckpoint(params.pmRoot, UPDATE_MANY_CHECKPOINT_SUBDIR, params.checkpointId, checkpointPayload);
-    return {
-        id: params.checkpointId,
-        created_at: params.nowValue,
-        path: checkpointPath,
-        rollback_command: `pm update-many --rollback ${params.checkpointId}`,
-    };
-};
-// GH-596: an explicit --ids request naming IDs that do not exist must stay
-// machine-detectable without client-side set differencing. The requested list
-// is re-derived here (same CSV split as the list filter) and compared against
-// the unfiltered storage corpus so pagination and additional query filters do
-// not misclassify existing items as nonexistent.
-const collectUnmatchedRequestedIds = (rawIds, existingItems) => {
-    if (rawIds == null) {
-        return undefined;
-    }
-    const requested = [
-        ...new Set(String(rawIds)
-            .split(",")
-            .map((entry) => entry.trim())
-            .filter((entry) => entry.length > 0)),
-    ];
-    const existing = new Set(existingItems.map((item) => item.id));
-    return requested.filter((id) => !existing.has(id));
-};
-/** Builds the shared unmatched-id envelope fields for one prepared plan. */
-const buildUnmatchedIdFields = (plan) => plan.unmatchedIds === undefined
-    ? {}
-    : {
-        unmatched_ids: plan.unmatchedIds,
-        unmatched_count: plan.unmatchedIds.length,
-    };
-/** Loads tracker settings and runtime registries for update-many execution. */
-const loadUpdateManyRuntimeContext = async (global) => {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    await assertInitializedTracker(pmRoot);
-    const settings = await readSettings(pmRoot);
-    return {
-        pmRoot,
-        settings,
-        statusRegistry: resolveRuntimeStatusRegistry(settings.schema),
-        runtimeFieldRegistry: resolveRuntimeFieldRegistry(settings.schema),
-    };
-};
-/** Validates rollback exclusivity before restoring a checkpoint. */
-const runRequestedUpdateManyRollback = (params) => {
-    if (params.options.dryRun === true) {
-        throw new PmCliError("--dry-run cannot be combined with --rollback", EXIT_CODE.USAGE);
-    }
-    if (hasListFilters(params.options.list, params.options.status)) {
-        throw new PmCliError("Rollback mode does not accept filter options", EXIT_CODE.USAGE);
-    }
-    if (Object.keys(params.updateSummary).length > 0) {
-        throw new PmCliError("Rollback mode does not accept update mutation flags", EXIT_CODE.USAGE);
-    }
-    return runUpdateManyRollback({
-        pmRoot: params.runtime.pmRoot,
-        rollbackId: params.rollbackId,
-        options: params.options,
-        global: params.global,
-    });
-};
-/** Loads complete matching rows and derives their mutation previews. */
-const buildUpdateManyPlan = async (params) => {
-    normalizeStatusFilter(params.options.status, params.runtime.statusRegistry);
-    const listed = await runList(undefined, {
-        ...params.options.list,
-        status: params.options.status,
-        compact: undefined,
-        brief: undefined,
-        fields: undefined,
-        includeBody: true,
-        full: true,
-    }, params.global);
-    const planned = listed.items.map((item) => {
-        const diff = buildPlannedItemDiff(item, params.runtime.runtimeFieldRegistry, params.options.update);
-        return params.dependencyWarnings.length === 0
-            ? diff
-            : {
-                ...diff,
-                warnings: [...params.dependencyWarnings],
-            };
-    });
-    const existenceItems = params.options.list?.ids == null
-        ? []
-        : (await runList(undefined, {
-            ids: params.options.list.ids,
-            noTruncate: true,
-            full: true,
-        }, params.global)).items;
-    return {
-        listed,
-        planned,
-        actionable: planned.filter((row) => row.changes.length > 0),
-        updateSummary: params.updateSummary,
-        unmatchedIds: collectUnmatchedRequestedIds(params.options.list?.ids, existenceItems),
-    };
-};
-/** Builds the non-mutating preview response for a prepared update-many plan. */
-const buildUpdateManyDryRunResult = (plan) => ({
-    outcome: "effect",
-    exit_code: EXIT_CODE.SUCCESS,
-    mode: "dry_run",
-    matched_count: plan.listed.items.length,
-    dry_run: true,
-    filters: plan.listed.filters,
-    planned_update_options: plan.updateSummary,
-    item_plans: plan.planned,
-    ids: [],
-    ...buildUnmatchedIdFields(plan),
-});
-/** Builds the apply response for a plan whose rows are all already current. */
-const buildUpdateManyNoopResult = (plan) => ({
-    ...derivePmBulkMutationEffect({
-        applied: 0,
-        skipped: plan.listed.items.length,
-        failed: 0,
-        unmatched: plan.unmatchedIds?.length ?? 0,
-    }),
-    mode: "apply",
-    matched_count: plan.listed.items.length,
-    dry_run: false,
-    filters: plan.listed.filters,
-    planned_update_options: plan.updateSummary,
-    updated_count: 0,
-    skipped_count: plan.listed.items.length,
-    failed_count: 0,
-    rows: plan.planned.map((row) => ({
-        id: row.id,
-        status: "skipped",
-    })),
-    ids: [],
-    ...buildUnmatchedIdFields(plan),
-});
-/** Applies planned item updates independently while preserving per-row failures. */
-const applyUpdateManyRows = async (params) => {
-    const rows = [];
-    const updatedIds = [];
-    const updateMessage = params.options.update.message ?? `update-many apply ${params.checkpointId}`;
-    const actionableById = new Set(params.plans.filter((row) => row.changes.length > 0).map((row) => row.id));
-    for (const item of params.items) {
-        if (!actionableById.has(item.id)) {
-            rows.push({
-                id: item.id,
-                status: "skipped",
-            });
-            continue;
-        }
-        try {
-            const rowUpdateOptions = preserveMutationStdinTokenLiterals({
-                ...params.options.update,
-                message: updateMessage,
-                runtimeFieldCommands: ["update_many"],
-            });
-            const result = await runUpdate(item.id, rowUpdateOptions, params.global);
-            rows.push({
-                id: item.id,
-                status: "updated",
-                changed_fields: result.changed_fields,
-                warnings: result.warnings,
-            });
-            updatedIds.push(item.id);
-        }
-        catch (error) {
-            rows.push({
-                id: item.id,
-                status: "failed",
-                error: toErrorMessage(error),
-            });
-        }
-    }
-    return { rows, updatedIds };
-};
-/** Applies a prepared plan, checkpointing actionable rows when requested. */
-const applyUpdateManyPlan = async (params) => {
-    if (params.plan.actionable.length === 0) {
-        return buildUpdateManyNoopResult(params.plan);
-    }
-    const nowValue = nowIso();
-    const checkpointId = createCheckpointId(UPDATE_MANY_CHECKPOINT_SUBDIR, nowValue);
-    const actionableById = new Set(params.plan.actionable.map((row) => row.id));
-    const checkpointItems = params.plan.listed.items
-        .filter((item) => actionableById.has(item.id))
-        .map((item) => ({ id: item.id, target_updated_at: item.updated_at }));
-    const checkpointInfo = params.options.checkpoint === false
-        ? undefined
-        : await writeUpdateManyCheckpoint({
-            pmRoot: params.runtime.pmRoot,
-            checkpointId,
-            nowValue,
-            options: params.options,
-            statusFilter: params.options.status,
-            filters: params.plan.listed.filters,
-            updateSummary: params.plan.updateSummary,
-            checkpointItems,
-        });
-    const applied = await applyUpdateManyRows({
-        items: params.plan.listed.items,
-        plans: params.plan.planned,
-        options: params.options,
-        global: params.global,
-        checkpointId,
-    });
-    /** Counts apply rows with one terminal status. */
-    const countStatus = (status) => applied.rows.filter((row) => row.status === status).length;
-    const updatedCount = countStatus("updated");
-    const skippedCount = countStatus("skipped");
-    const failedCount = countStatus("failed");
-    return {
-        ...derivePmBulkMutationEffect({
-            applied: updatedCount,
-            skipped: skippedCount,
-            failed: failedCount,
-            unmatched: params.plan.unmatchedIds?.length ?? 0,
-        }),
-        mode: "apply",
-        matched_count: params.plan.listed.items.length,
-        dry_run: false,
-        filters: params.plan.listed.filters,
-        planned_update_options: params.plan.updateSummary,
-        ...(checkpointInfo ? { checkpoint: checkpointInfo } : {}),
-        updated_count: updatedCount,
-        skipped_count: skippedCount,
-        failed_count: failedCount,
-        rows: applied.rows,
-        ids: applied.updatedIds,
-        ...buildUnmatchedIdFields(params.plan),
-    };
-};
-/** Implements run update many for the public runtime surface of this module. */
-export const runUpdateMany = async (options, global) => {
-    const runtime = await loadUpdateManyRuntimeContext(global);
-    const rollbackId = typeof options.rollback === "string" ? options.rollback : undefined;
-    if (rollbackId === undefined) {
-        options = {
-            ...options,
-            update: preserveMutationStdinTokenLiterals(await resolveUpdateTransportOptions(options.update)),
-        };
-    }
-    const updateSummary = sanitizeUpdateOptionsForSummary(options.update);
-    rejectBlankIdsFilter(options.list);
-    if (rollbackId !== undefined) {
-        return runRequestedUpdateManyRollback({
-            runtime,
-            rollbackId,
-            options,
-            global,
-            updateSummary,
-        });
-    }
-    if (!hasAnyUpdateMutationInput(options.update) && options.dryRun !== true) {
-        throw new PmCliError(`No update-many mutation flags provided. Add at least one mutation flag (for example: ${UPDATE_MANY_MUTATION_FLAG_GUIDANCE}), or pass --dry-run for a filter-only preview.`, EXIT_CODE.USAGE);
-    }
-    assertPlannedUpdateValuesValid(options.update, runtime.settings, runtime.statusRegistry, runtime.pmRoot);
-    assertUpdateMutationOptionCombinations(options.update);
-    const dependencyWarnings = await assertDependencyTargetsResolvable({
-        pmRoot: runtime.pmRoot,
-        dependencies: parseDependencyAdditions(options.update.dep, runtime.settings.id_prefix, nowIso(), resolveAuthor(options.update.author, runtime.settings.author_default)).additions,
-        idPrefix: runtime.settings.id_prefix,
-        itemFormat: runtime.settings.item_format,
-        typeToFolder: resolveItemTypeRegistry(runtime.settings, getActiveExtensionRegistrations()).type_to_folder,
-        allowUnresolved: options.update.allowUnresolvedDeps,
-    });
-    const plan = await buildUpdateManyPlan({
-        options,
-        global,
-        runtime,
-        updateSummary,
-        dependencyWarnings,
-    });
-    await assertDependencyTargetsResolvable({
-        pmRoot: runtime.pmRoot,
-        dependencies: parseDependencyAdditions(options.update.dep, runtime.settings.id_prefix, nowIso(), resolveAuthor(options.update.author, runtime.settings.author_default)).additions,
-        idPrefix: runtime.settings.id_prefix,
-        itemFormat: runtime.settings.item_format,
-        typeToFolder: resolveItemTypeRegistry(runtime.settings, getActiveExtensionRegistrations()).type_to_folder,
-        allowUnresolved: options.update.allowUnresolvedDeps,
-        holders: plan.listed.items.map((item) => ({
-            id: item.id,
-            createdAt: item.created_at,
-        })),
-        schema: runtime.settings.schema,
-    });
-    return options.dryRun === true
-        ? buildUpdateManyDryRunResult(plan)
-        : applyUpdateManyPlan({ runtime, options, global, plan });
-};
-/** Public contract for test only update many command, shared by SDK and presentation-layer consumers. */
-export const _testOnlyUpdateManyCommand = {
-    assertPlannedUpdateValuesValid,
-    buildCollectionMutationPlans,
-    buildPlannedItemDiff,
-    buildTagMutationPlan,
-    collectionValueCount,
-    hasAnyUpdateMutationInput,
-    hasListFilters,
-    normalizeStatusFilter,
-    normalizeCollectionBeforeValue,
-    normalizeExistingTags,
-    normalizeUnsetField,
-    rejectBlankIdsFilter,
-    sanitizeUpdateOptionsForSummary,
-    toComparablePreviewValue,
-};
+!(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]="3ef785ae-bb1e-59dd-993c-3be56ddc26c2")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{createCheckpointId,loadMutationCheckpoint,restoreCheckpointItems,writeMutationCheckpoint,toItemRecord,applyAcceptanceCriteriaMutations,applyTagRemovals,mergeAdditiveTags,parseOptionalNonNegativeInteger,parseTags,splitAcceptanceCriteria,resolvePriority,normalizeStatusInput,resolveItemTypeRegistry,resolveTypeName,collectRuntimeUpdateFieldValues,buildInvalidTypeError,resolveItemTypesFilePath,resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry,EXIT_CODE,PmCliError,toErrorMessage,stableValueEquals,nowIso,preserveMutationStdinTokenLiterals,resolveIsoOrRelative,getActiveExtensionRegistrations,resolvePmRoot,readSettings,resolveAuthor}from"../runtime-primitives.js";import{assertDependencyTargetsResolvable}from"../dependency-flag-validation.js";import{parseStatusFilterCsv}from"../../core/item/status-filter.js";import{hasListFilters}from"../query/list-filter-shared.js";import{runList}from"../query/list.js";import{runRestore}from"./restore.js";import{assertUpdateMutationOptionCombinations,parseDependencyAdditions,resolveUpdateTransportOptions,runUpdate}from"./update.js";import{derivePmBulkMutationEffect}from"../cli-contracts/command-exit-contracts.js";const UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION=1;const UPDATE_MANY_CHECKPOINT_SUBDIR="update-many";const NON_MUTATION_UPDATE_OPTION_KEYS=new Set(["author","message","force","ownershipMetadataBypass","ownershipDependencyBypass","allowUnresolvedDeps"]);const UPDATE_MANY_MUTATION_FLAG_GUIDANCE=["--status","--priority","--type","--tags","--description","--body","--deadline","--estimate","--assignee","--dep","--dep-remove","--comment","--note","--learning","--file","--test","--doc","--replace-deps","--replace-tests","--replace-files","--replace-docs","--unset","--clear-*"].join(", ");const UPDATE_OPTION_TO_ITEM_KEY={title:"title",description:"description",body:"body",status:"status",closeReason:"close_reason",priority:"priority",type:"type",deadline:"deadline",estimatedMinutes:"estimated_minutes",acceptanceCriteria:"acceptance_criteria",definitionOfReady:"definition_of_ready",order:"order",goal:"goal",objective:"objective",value:"value",impact:"impact",outcome:"outcome",whyNow:"why_now",assignee:"assignee",parent:"parent",reviewer:"reviewer",risk:"risk",confidence:"confidence",sprint:"sprint",release:"release",blockedBy:"blocked_by",blockedReason:"blocked_reason",unblockNote:"unblock_note",reporter:"reporter",severity:"severity",environment:"environment",reproSteps:"repro_steps",resolution:"resolution",expectedResult:"expected_result",actualResult:"actual_result",affectedVersion:"affected_version",fixedVersion:"fixed_version",component:"component",regression:"regression",customerImpact:"customer_impact"};const COLLECTION_MUTATION_PLAN_DEFINITIONS=[{field:"dependencies",addKey:"dep",removeKey:"depRemove",clearKey:"clearDeps",replaceKey:"replaceDeps"},{field:"comments",addKey:"comment",clearKey:"clearComments"},{field:"notes",addKey:"note",clearKey:"clearNotes"},{field:"learnings",addKey:"learning",clearKey:"clearLearnings"},{field:"files",addKey:"file",clearKey:"clearFiles",replaceKey:"replaceFiles"},{field:"tests",addKey:"test",clearKey:"clearTests",replaceKey:"replaceTests"},{field:"docs",addKey:"doc",clearKey:"clearDocs",replaceKey:"replaceDocs"},{field:"reminders",addKey:"reminder",clearKey:"clearReminders"},{field:"events",addKey:"event",clearKey:"clearEvents"},{field:"type_options",addKey:"typeOption",clearKey:"clearTypeOptions"}];const UNSET_FIELD_ALIASES={close_reason:"close_reason","close-reason":"close_reason",deadline:"deadline",estimate:"estimated_minutes",estimated_minutes:"estimated_minutes","estimated-minutes":"estimated_minutes",acceptance_criteria:"acceptance_criteria","acceptance-criteria":"acceptance_criteria",ac:"acceptance_criteria",definition_of_ready:"definition_of_ready","definition-of-ready":"definition_of_ready",order:"order",rank:"order",goal:"goal",objective:"objective",value:"value",impact:"impact",outcome:"outcome",why_now:"why_now","why-now":"why_now",assignee:"assignee",parent:"parent",reviewer:"reviewer",risk:"risk",confidence:"confidence",sprint:"sprint",release:"release",blocked_by:"blocked_by","blocked-by":"blocked_by",blocked_reason:"blocked_reason","blocked-reason":"blocked_reason",unblock_note:"unblock_note","unblock-note":"unblock_note",reporter:"reporter",severity:"severity",environment:"environment",repro_steps:"repro_steps","repro-steps":"repro_steps",resolution:"resolution",expected_result:"expected_result","expected-result":"expected_result",actual_result:"actual_result","actual-result":"actual_result",affected_version:"affected_version","affected-version":"affected_version",fixed_version:"fixed_version","fixed-version":"fixed_version",component:"component",regression:"regression",customer_impact:"customer_impact","customer-impact":"customer_impact",type_options:"type_options","type-options":"type_options",tags:"tags"};const sanitizeUpdateOptionsForSummary=options=>{const summary={};for(const[key,value]of Object.entries(options)){if(NON_MUTATION_UPDATE_OPTION_KEYS.has(key)){continue}if(value===void 0){continue}summary[key]=value}return summary};const hasAnyUpdateMutationInput=options=>{return Object.keys(sanitizeUpdateOptionsForSummary(options)).length>0};const trimPreviewValue=value=>typeof value==="string"?value.trim():value;const normalizeIntegerPreviewValue=value=>{const trimmed=String(value).trim();const parsed=Number(trimmed);return Number.isInteger(parsed)?parsed:trimmed};const normalizeNumericPreviewValue=value=>{const trimmed=String(value).trim();const parsed=Number(trimmed);return Number.isFinite(parsed)?parsed:trimmed};const normalizeRegressionPreviewValue=value=>{const normalized=String(value).trim().toLowerCase();const parsed=new Map([["true",true],["1",true],["false",false],["0",false]]).get(normalized);return parsed??trimPreviewValue(value)};const PREVIEW_VALUE_NORMALIZERS={priority:normalizeIntegerPreviewValue,estimatedMinutes:normalizeNumericPreviewValue,order:normalizeNumericPreviewValue,rank:normalizeNumericPreviewValue,regression:normalizeRegressionPreviewValue};const toComparablePreviewValue=(optionKey,value)=>{if(value===void 0){return void 0}return(PREVIEW_VALUE_NORMALIZERS[optionKey]??trimPreviewValue)(value)};const normalizeUnsetField=rawField=>{const normalized=rawField.trim().toLowerCase().replaceAll("-","_");return UNSET_FIELD_ALIASES[normalized]??normalized};const areValuesEqual=(left,right)=>{return stableValueEquals(left,right)};const normalizeCollectionBeforeValue=(field,value)=>{if(value!==void 0){return value}if(field==="type_options"){return{}}return[]};const collectionValueCount=(field,value)=>{if(Array.isArray(value)){return value.length}if(field==="type_options"&&value&&typeof value==="object"){return Object.keys(value).length}return 0};const resolveCollectionMutationOperation=params=>{if(params.replace){return"replace"}if(params.clear){return"clear_or_reset"}return params.removeCount>0?"merge_remove":"append"};const readOptionalUpdateValue=(update,key)=>key===void 0?void 0:update[key];const updateArrayValueCount=value=>Array.isArray(value)?value.length:0;const buildCollectionMutationPlan=(definition,row,update)=>{const addValues=update[definition.addKey];const removeValues=readOptionalUpdateValue(update,definition.removeKey);const addCount=updateArrayValueCount(addValues);const removeCount=updateArrayValueCount(removeValues);const clear=update[definition.clearKey]===true;const replace=readOptionalUpdateValue(update,definition.replaceKey)===true;if(![clear,replace,addCount>0,removeCount>0].includes(true)){return void 0}const before=normalizeCollectionBeforeValue(definition.field,row[definition.field]);return{field:definition.field,before,after:{operation:resolveCollectionMutationOperation({replace,clear,removeCount}),clear,replace,add_count:addCount,remove_count:removeCount,before_count:collectionValueCount(definition.field,before)}}};const buildCollectionMutationPlans=(row,update)=>{const changes=[];for(const definition of COLLECTION_MUTATION_PLAN_DEFINITIONS){const plan=buildCollectionMutationPlan(definition,row,update);if(plan!==void 0){changes.push(plan)}}return changes};const normalizeExistingTags=value=>{if(!Array.isArray(value)){return[]}return value.filter(tag=>typeof tag==="string")};const buildTagMutationPlan=(row,update)=>{if(![update.tags!==void 0,updateArrayValueCount(update.addTags)>0,updateArrayValueCount(update.removeTags)>0].includes(true)){return void 0}const existing=normalizeExistingTags(row.tags);const baseTags=update.tags===void 0?existing:parseTags(update.tags);const withAdditions=mergeAdditiveTags(baseTags,update.addTags);const after=applyTagRemovals(withAdditions,update.removeTags).slice().sort((a,b)=>a.localeCompare(b));const before=existing.slice().sort((a,b)=>a.localeCompare(b));if(areValuesEqual(before,after)){return void 0}return{field:"tags",before:existing,after}};const buildAcceptanceCriteriaMutationPlan=(row,update)=>{const before=row.acceptance_criteria;const mutation=applyAcceptanceCriteriaMutations(splitAcceptanceCriteria(before),update.addAc,update.removeAc);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})}const after=mutation.criteria.join("; ");if(areValuesEqual(typeof before==="string"?before:"",after)){return void 0}return{field:"acceptance_criteria",before,after}};const appendScalarMutationPlans=(changes,row,update)=>{for(const[optionKey,itemKey]of Object.entries(UPDATE_OPTION_TO_ITEM_KEY)){const candidate=update[optionKey];if(candidate===void 0){continue}const before=row[itemKey];const after=toComparablePreviewValue(optionKey,candidate);if(!areValuesEqual(before,after)){changes.push({field:itemKey,before,after})}}};const appendRuntimeFieldMutationPlans=(changes,row,update,runtimeFieldRegistry)=>{const runtimeFieldUpdates=collectRuntimeUpdateFieldValues(update,runtimeFieldRegistry,["update_many"]);for(const[field,after]of Object.entries(runtimeFieldUpdates)){const before=row[field];if(!areValuesEqual(before,after)){changes.push({field,before,after})}}};const appendUnsetMutationPlans=(changes,row,unset)=>{for(const rawUnsetField of unset??[]){const field=normalizeUnsetField(rawUnsetField);const before=row[field];if(before!==void 0){changes.push({field,before,after:null})}}};const buildPlannedItemDiff=(item,runtimeFieldRegistry,update={})=>{const row=toItemRecord(item);const changes=[];const tagPlan=buildTagMutationPlan(row,update);if(tagPlan){changes.push(tagPlan)}appendScalarMutationPlans(changes,row,update);if(updateArrayValueCount(update.addAc)>0||updateArrayValueCount(update.removeAc)>0){const acceptanceCriteriaChange=buildAcceptanceCriteriaMutationPlan(row,update);if(acceptanceCriteriaChange!==void 0){changes.push(acceptanceCriteriaChange)}}changes.push(...buildCollectionMutationPlans(row,update));appendRuntimeFieldMutationPlans(changes,row,update,runtimeFieldRegistry);appendUnsetMutationPlans(changes,row,update.unset);return{id:item.id,changes}};const normalizeStatusFilter=(value,statusRegistry)=>{return parseStatusFilterCsv(value,statusRegistry,{strict:true,flagLabel:"--filter-status"})};const rejectBlankIdsFilter=list=>{if(list?.ids!=null&&String(list.ids).trim().length===0){throw new PmCliError("--ids requires at least one non-empty item ID",EXIT_CODE.USAGE)}};const PLANNED_UPDATE_VALIDATORS=[({update})=>{if(update.priority!==void 0){resolvePriority(update.priority)}},({update,settings,pmRoot})=>{if(update.type===void 0){return}const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());if(!resolveTypeName(update.type,typeRegistry)){throw new PmCliError(buildInvalidTypeError(update.type,typeRegistry.types,resolveItemTypesFilePath(pmRoot,settings.schema)),EXIT_CODE.USAGE)}},({update,statusRegistry})=>{if(update.status!==void 0&&!normalizeStatusInput(update.status,statusRegistry)){const allowedStatuses=statusRegistry.definitions.map(definition=>definition.id);throw new PmCliError(`Invalid --status value "${update.status}". Allowed: ${allowedStatuses.join(", ")}`,EXIT_CODE.USAGE)}},({update})=>{if(update.deadline!==void 0){resolveIsoOrRelative(update.deadline,new Date,"deadline")}},({update})=>{if(update.estimatedMinutes!==void 0){parseOptionalNonNegativeInteger(update.estimatedMinutes,"estimated-minutes")}}];const assertPlannedUpdateValuesValid=(update,settings,statusRegistry,pmRoot)=>{const context={update,settings,statusRegistry,pmRoot};for(const validate of PLANNED_UPDATE_VALIDATORS){validate(context)}};const runUpdateManyRollback=async params=>{const checkpoint=await loadMutationCheckpoint(params.pmRoot,UPDATE_MANY_CHECKPOINT_SUBDIR,params.rollbackId,UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION);const restoreMessage=params.options.update?.message??`Rollback update-many checkpoint ${checkpoint.id}`;const rollback=await restoreCheckpointItems(checkpoint.items,(id,targetUpdatedAt)=>runRestore(id,targetUpdatedAt,{author:params.options.update?.author,message:restoreMessage,force:params.options.update?.force??true},params.global));return{...derivePmBulkMutationEffect({applied:rollback.restored_ids.length,skipped:0,failed:rollback.failed_count,unmatched:0}),mode:"rollback",matched_count:checkpoint.items.length,dry_run:false,rollback_checkpoint_id:checkpoint.id,checkpoint:{id:checkpoint.id,created_at:checkpoint.created_at,path:checkpoint.path,rollback_command:`pm update-many --rollback ${checkpoint.id}`},restored_count:rollback.restored_ids.length,failed_count:rollback.failed_count,rows:rollback.rows,ids:rollback.restored_ids}};const writeUpdateManyCheckpoint=async params=>{const checkpointPayload={schema_version:UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION,id:params.checkpointId,created_at:params.nowValue,author:resolveAuthor(params.options.update?.author,"unknown"),status_filter:params.statusFilter??null,list_filters:params.filters,update_options:params.updateSummary,items:params.checkpointItems};const checkpointPath=await writeMutationCheckpoint(params.pmRoot,UPDATE_MANY_CHECKPOINT_SUBDIR,params.checkpointId,checkpointPayload);return{id:params.checkpointId,created_at:params.nowValue,path:checkpointPath,rollback_command:`pm update-many --rollback ${params.checkpointId}`}};const collectUnmatchedRequestedIds=(rawIds,existingItems)=>{if(rawIds==null){return void 0}const requested=[...new Set(String(rawIds).split(",").map(entry=>entry.trim()).filter(entry=>entry.length>0))];const existing=new Set(existingItems.map(item=>item.id));return requested.filter(id=>!existing.has(id))};const buildUnmatchedIdFields=plan=>plan.unmatchedIds===void 0?{}:{unmatched_ids:plan.unmatchedIds,unmatched_count:plan.unmatchedIds.length};const loadUpdateManyRuntimeContext=async global2=>{const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);return{pmRoot,settings,statusRegistry:resolveRuntimeStatusRegistry(settings.schema),runtimeFieldRegistry:resolveRuntimeFieldRegistry(settings.schema)}};const runRequestedUpdateManyRollback=params=>{if(params.options.dryRun===true){throw new PmCliError("--dry-run cannot be combined with --rollback",EXIT_CODE.USAGE)}if(hasListFilters(params.options.list,params.options.status)){throw new PmCliError("Rollback mode does not accept filter options",EXIT_CODE.USAGE)}if(Object.keys(params.updateSummary).length>0){throw new PmCliError("Rollback mode does not accept update mutation flags",EXIT_CODE.USAGE)}return runUpdateManyRollback({pmRoot:params.runtime.pmRoot,rollbackId:params.rollbackId,options:params.options,global:params.global})};const buildUpdateManyPlan=async params=>{normalizeStatusFilter(params.options.status,params.runtime.statusRegistry);const listed=await runList(void 0,{...params.options.list,status:params.options.status,compact:void 0,brief:void 0,fields:void 0,includeBody:true,full:true},params.global);const planned=listed.items.map(item=>{const diff=buildPlannedItemDiff(item,params.runtime.runtimeFieldRegistry,params.options.update);return params.dependencyWarnings.length===0?diff:{...diff,warnings:[...params.dependencyWarnings]}});const existenceItems=params.options.list?.ids==null?[]:(await runList(void 0,{ids:params.options.list.ids,noTruncate:true,full:true},params.global)).items;return{listed,planned,actionable:planned.filter(row=>row.changes.length>0),updateSummary:params.updateSummary,unmatchedIds:collectUnmatchedRequestedIds(params.options.list?.ids,existenceItems)}};const buildUpdateManyDryRunResult=plan=>({outcome:"effect",exit_code:EXIT_CODE.SUCCESS,mode:"dry_run",matched_count:plan.listed.items.length,dry_run:true,filters:plan.listed.filters,planned_update_options:plan.updateSummary,item_plans:plan.planned,ids:[],...buildUnmatchedIdFields(plan)});const buildUpdateManyNoopResult=plan=>({...derivePmBulkMutationEffect({applied:0,skipped:plan.listed.items.length,failed:0,unmatched:plan.unmatchedIds?.length??0}),mode:"apply",matched_count:plan.listed.items.length,dry_run:false,filters:plan.listed.filters,planned_update_options:plan.updateSummary,updated_count:0,skipped_count:plan.listed.items.length,failed_count:0,rows:plan.planned.map(row=>({id:row.id,status:"skipped"})),ids:[],...buildUnmatchedIdFields(plan)});const applyUpdateManyRows=async params=>{const rows=[];const updatedIds=[];const updateMessage=params.options.update.message??`update-many apply ${params.checkpointId}`;const actionableById=new Set(params.plans.filter(row=>row.changes.length>0).map(row=>row.id));for(const item of params.items){if(!actionableById.has(item.id)){rows.push({id:item.id,status:"skipped"});continue}try{const rowUpdateOptions=preserveMutationStdinTokenLiterals({...params.options.update,message:updateMessage,runtimeFieldCommands:["update_many"]});const result=await runUpdate(item.id,rowUpdateOptions,params.global);rows.push({id:item.id,status:"updated",changed_fields:result.changed_fields,warnings:result.warnings});updatedIds.push(item.id)}catch(error){rows.push({id:item.id,status:"failed",error:toErrorMessage(error)})}}return{rows,updatedIds}};const applyUpdateManyPlan=async params=>{if(params.plan.actionable.length===0){return buildUpdateManyNoopResult(params.plan)}const nowValue=nowIso();const checkpointId=createCheckpointId(UPDATE_MANY_CHECKPOINT_SUBDIR,nowValue);const actionableById=new Set(params.plan.actionable.map(row=>row.id));const checkpointItems=params.plan.listed.items.filter(item=>actionableById.has(item.id)).map(item=>({id:item.id,target_updated_at:item.updated_at}));const checkpointInfo=params.options.checkpoint===false?void 0:await writeUpdateManyCheckpoint({pmRoot:params.runtime.pmRoot,checkpointId,nowValue,options:params.options,statusFilter:params.options.status,filters:params.plan.listed.filters,updateSummary:params.plan.updateSummary,checkpointItems});const applied=await applyUpdateManyRows({items:params.plan.listed.items,plans:params.plan.planned,options:params.options,global:params.global,checkpointId});const countStatus=status=>applied.rows.filter(row=>row.status===status).length;const updatedCount=countStatus("updated");const skippedCount=countStatus("skipped");const failedCount=countStatus("failed");return{...derivePmBulkMutationEffect({applied:updatedCount,skipped:skippedCount,failed:failedCount,unmatched:params.plan.unmatchedIds?.length??0}),mode:"apply",matched_count:params.plan.listed.items.length,dry_run:false,filters:params.plan.listed.filters,planned_update_options:params.plan.updateSummary,...checkpointInfo?{checkpoint:checkpointInfo}:{},updated_count:updatedCount,skipped_count:skippedCount,failed_count:failedCount,rows:applied.rows,ids:applied.updatedIds,...buildUnmatchedIdFields(params.plan)}};const runUpdateMany=async(options,global2)=>{const runtime=await loadUpdateManyRuntimeContext(global2);const rollbackId=typeof options.rollback==="string"?options.rollback:void 0;if(rollbackId===void 0){options={...options,update:preserveMutationStdinTokenLiterals(await resolveUpdateTransportOptions(options.update))}}const updateSummary=sanitizeUpdateOptionsForSummary(options.update);rejectBlankIdsFilter(options.list);if(rollbackId!==void 0){return runRequestedUpdateManyRollback({runtime,rollbackId,options,global:global2,updateSummary})}if(!hasAnyUpdateMutationInput(options.update)&&options.dryRun!==true){throw new PmCliError(`No update-many mutation flags provided. Add at least one mutation flag (for example: ${UPDATE_MANY_MUTATION_FLAG_GUIDANCE}), or pass --dry-run for a filter-only preview.`,EXIT_CODE.USAGE)}assertPlannedUpdateValuesValid(options.update,runtime.settings,runtime.statusRegistry,runtime.pmRoot);assertUpdateMutationOptionCombinations(options.update);const dependencyWarnings=await assertDependencyTargetsResolvable({pmRoot:runtime.pmRoot,dependencies:parseDependencyAdditions(options.update.dep,runtime.settings.id_prefix,nowIso(),resolveAuthor(options.update.author,runtime.settings.author_default)).additions,idPrefix:runtime.settings.id_prefix,itemFormat:runtime.settings.item_format,typeToFolder:resolveItemTypeRegistry(runtime.settings,getActiveExtensionRegistrations()).type_to_folder,allowUnresolved:options.update.allowUnresolvedDeps});const plan=await buildUpdateManyPlan({options,global:global2,runtime,updateSummary,dependencyWarnings});await assertDependencyTargetsResolvable({pmRoot:runtime.pmRoot,dependencies:parseDependencyAdditions(options.update.dep,runtime.settings.id_prefix,nowIso(),resolveAuthor(options.update.author,runtime.settings.author_default)).additions,idPrefix:runtime.settings.id_prefix,itemFormat:runtime.settings.item_format,typeToFolder:resolveItemTypeRegistry(runtime.settings,getActiveExtensionRegistrations()).type_to_folder,allowUnresolved:options.update.allowUnresolvedDeps,holders:plan.listed.items.map(item=>({id:item.id,createdAt:item.created_at})),schema:runtime.settings.schema});return options.dryRun===true?buildUpdateManyDryRunResult(plan):applyUpdateManyPlan({runtime,options,global:global2,plan})};const _testOnlyUpdateManyCommand={assertPlannedUpdateValuesValid,buildCollectionMutationPlans,buildPlannedItemDiff,buildTagMutationPlan,collectionValueCount,hasAnyUpdateMutationInput,hasListFilters,normalizeStatusFilter,normalizeCollectionBeforeValue,normalizeExistingTags,normalizeUnsetField,rejectBlankIdsFilter,sanitizeUpdateOptionsForSummary,toComparablePreviewValue};export{_testOnlyUpdateManyCommand,runUpdateMany};
 //# sourceMappingURL=update-many.js.map
-//# debugId=fada7a33-ad1d-54f1-ae03-c5f8e4568d75