@unbrained/pm-cli 2026.5.30 → 2026.6.5

package/dist/cli-bundle/chunks/update-many-322CCH2L.js

@@ -0,0 +1,608 @@
+import {
+  runUpdate
+} from "./chunk-D5X7N6FI.js";
+import {
+  createCheckpointId,
+  loadMutationCheckpoint,
+  restoreCheckpointItems,
+  writeMutationCheckpoint
+} from "./chunk-TQ3ZK6VD.js";
+import {
+  runRestore
+} from "./chunk-GCAVRLGE.js";
+import {
+  resolveAuthor
+} from "./chunk-O7IWB35H.js";
+import "./chunk-WIKR7KFL.js";
+import "./chunk-S3CV7JGJ.js";
+import "./chunk-OUF3ARDX.js";
+import "./chunk-Y2AKE2HS.js";
+import {
+  applyTagRemovals,
+  mergeAdditiveTags,
+  parseTags
+} from "./chunk-CJDQB2ED.js";
+import "./chunk-ATBVS6WW.js";
+import "./chunk-XX5LRINW.js";
+import "./chunk-KK6YPGH3.js";
+import "./chunk-HZOS2UG5.js";
+import "./chunk-3HUE7XOF.js";
+import {
+  runList
+} from "./chunk-N5YF3VFN.js";
+import "./chunk-RQAWLSUU.js";
+import "./chunk-K47WAYQV.js";
+import "./chunk-EAOG77HM.js";
+import {
+  toItemRecord
+} from "./chunk-XG7RJYHV.js";
+import "./chunk-KA24HME7.js";
+import {
+  collectRuntimeUpdateFieldValues,
+  normalizeStatusInput
+} from "./chunk-HPH6X4ZZ.js";
+import "./chunk-4PJQSECJ.js";
+import {
+  nowIso
+} from "./chunk-RANZIID5.js";
+import {
+  EXIT_CODE,
+  PmCliError,
+  getSettingsPath,
+  pathExists,
+  readSettings,
+  resolvePmRoot,
+  resolveRuntimeFieldRegistry,
+  resolveRuntimeStatusRegistry,
+  stableValueEquals,
+  toErrorMessage
+} from "./chunk-SRVKTWPR.js";
+
+// dist/cli/commands/update-many.js
+!(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] = "4ed301df-2e35-53f0-a282-798a18460142");
+  } catch (e2) {
+  }
+})();
+var UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;
+var UPDATE_MANY_CHECKPOINT_SUBDIR = "update-many";
+var NON_MUTATION_UPDATE_OPTION_KEYS = /* @__PURE__ */ new Set([
+  "author",
+  "message",
+  "force",
+  "allowAuditUpdate",
+  "allowAuditDepUpdate"
+]);
+var 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",
+  "--unset",
+  "--clear-*"
+].join(", ");
+var 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"
+};
+var 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"
+  },
+  {
+    field: "tests",
+    addKey: "test",
+    clearKey: "clearTests",
+    replaceKey: "replaceTests"
+  },
+  {
+    field: "docs",
+    addKey: "doc",
+    clearKey: "clearDocs"
+  },
+  {
+    field: "reminders",
+    addKey: "reminder",
+    clearKey: "clearReminders"
+  },
+  {
+    field: "events",
+    addKey: "event",
+    clearKey: "clearEvents"
+  },
+  {
+    field: "type_options",
+    addKey: "typeOption",
+    clearKey: "clearTypeOptions"
+  }
+];
+var 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"
+};
+function 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;
+}
+function hasAnyUpdateMutationInput(options) {
+  return Object.keys(sanitizeUpdateOptionsForSummary(options)).length > 0;
+}
+function toComparablePreviewValue(optionKey, value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (optionKey === "priority") {
+    const parsed = Number(String(value).trim());
+    return Number.isInteger(parsed) ? parsed : String(value).trim();
+  }
+  if (optionKey === "estimatedMinutes" || optionKey === "order" || optionKey === "rank") {
+    const parsed = Number(String(value).trim());
+    return Number.isFinite(parsed) ? parsed : String(value).trim();
+  }
+  if (optionKey === "regression") {
+    const normalized = String(value).trim().toLowerCase();
+    if (normalized === "true" || normalized === "1") {
+      return true;
+    }
+    if (normalized === "false" || normalized === "0") {
+      return false;
+    }
+  }
+  if (typeof value === "string") {
+    return value.trim();
+  }
+  return value;
+}
+function normalizeUnsetField(rawField) {
+  const normalized = rawField.trim().toLowerCase().replaceAll("-", "_");
+  return UNSET_FIELD_ALIASES[normalized] ?? normalized;
+}
+function areValuesEqual(left, right) {
+  return stableValueEquals(left, right);
+}
+function normalizeCollectionBeforeValue(field, value) {
+  if (value !== void 0) {
+    return value;
+  }
+  if (field === "type_options") {
+    return {};
+  }
+  return [];
+}
+function 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;
+}
+function buildCollectionMutationPlans(row, update) {
+  const changes = [];
+  for (const definition of COLLECTION_MUTATION_PLAN_DEFINITIONS) {
+    const addValues = definition.addKey ? update[definition.addKey] : void 0;
+    const removeValues = definition.removeKey ? update[definition.removeKey] : void 0;
+    const addCount = Array.isArray(addValues) ? addValues.length : 0;
+    const removeCount = Array.isArray(removeValues) ? removeValues.length : 0;
+    const clear = definition.clearKey ? update[definition.clearKey] === true : false;
+    const replace = definition.replaceKey ? update[definition.replaceKey] === true : false;
+    if (!clear && !replace && addCount === 0 && removeCount === 0) {
+      continue;
+    }
+    const before = normalizeCollectionBeforeValue(definition.field, row[definition.field]);
+    const beforeCount = collectionValueCount(definition.field, before);
+    const operation = replace ? "replace" : clear ? "clear_or_reset" : removeCount > 0 ? "merge_remove" : "append";
+    changes.push({
+      field: definition.field,
+      before,
+      after: {
+        operation,
+        clear,
+        replace,
+        add_count: addCount,
+        remove_count: removeCount,
+        before_count: beforeCount
+      }
+    });
+  }
+  return changes;
+}
+function normalizeExistingTags(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.filter((tag) => typeof tag === "string");
+}
+function buildTagMutationPlan(row, update) {
+  const hasReplace = update.tags !== void 0;
+  const hasAdd = Array.isArray(update.addTags) && update.addTags.length > 0;
+  const hasRemove = Array.isArray(update.removeTags) && update.removeTags.length > 0;
+  if (!hasReplace && !hasAdd && !hasRemove) {
+    return void 0;
+  }
+  const existing = normalizeExistingTags(row.tags);
+  const baseTags = hasReplace ? parseTags(update.tags ?? "") : existing;
+  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 };
+}
+function buildPlannedItemDiff(item, update, runtimeFieldRegistry) {
+  const safeUpdate = update ?? {};
+  const row = toItemRecord(item);
+  const changes = [];
+  const tagPlan = buildTagMutationPlan(row, safeUpdate);
+  if (tagPlan) {
+    changes.push(tagPlan);
+  }
+  for (const [optionKey, itemKey] of Object.entries(UPDATE_OPTION_TO_ITEM_KEY)) {
+    const candidate = safeUpdate[optionKey];
+    if (candidate === void 0) {
+      continue;
+    }
+    const before = row[itemKey];
+    const after = toComparablePreviewValue(optionKey, candidate);
+    if (areValuesEqual(before, after)) {
+      continue;
+    }
+    changes.push({
+      field: itemKey,
+      before,
+      after
+    });
+  }
+  changes.push(...buildCollectionMutationPlans(row, safeUpdate));
+  const runtimeFieldUpdates = collectRuntimeUpdateFieldValues(safeUpdate, runtimeFieldRegistry, ["update_many"]);
+  for (const [fieldKey, fieldValue] of Object.entries(runtimeFieldUpdates)) {
+    const before = row[fieldKey];
+    if (areValuesEqual(before, fieldValue)) {
+      continue;
+    }
+    changes.push({
+      field: fieldKey,
+      before,
+      after: fieldValue
+    });
+  }
+  if (safeUpdate.unset && safeUpdate.unset.length > 0) {
+    for (const rawUnsetField of safeUpdate.unset) {
+      const field = normalizeUnsetField(rawUnsetField);
+      const before = row[field];
+      if (before === void 0) {
+        continue;
+      }
+      changes.push({
+        field,
+        before,
+        after: null
+      });
+    }
+  }
+  return {
+    id: item.id,
+    changes
+  };
+}
+function normalizeStatusFilter(value, statusRegistry) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const normalized = normalizeStatusInput(value, statusRegistry);
+  if (!normalized) {
+    const allowedStatuses = statusRegistry.definitions.map((definition) => definition.id);
+    throw new PmCliError(`Invalid --filter-status value "${value}". Allowed: ${allowedStatuses.join(", ")}`, EXIT_CODE.USAGE);
+  }
+  return normalized;
+}
+function hasListFilters(list, status) {
+  const isActive = (value) => value != null && (typeof value !== "string" || value.split(",").some((entry) => entry.trim().length > 0));
+  return isActive(status) || isActive(list?.status) || isActive(list?.type) || isActive(list?.tag) || isActive(list?.priority) || isActive(list?.deadlineBefore) || isActive(list?.deadlineAfter) || isActive(list?.updatedAfter) || isActive(list?.updatedBefore) || isActive(list?.createdAfter) || isActive(list?.createdBefore) || isActive(list?.ids) || isActive(list?.assignee) || isActive(list?.assigneeFilter) || isActive(list?.parent) || isActive(list?.sprint) || isActive(list?.release) || isActive(list?.limit) || isActive(list?.offset);
+}
+function 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);
+  }
+}
+async function runUpdateMany(options, global2) {
+  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
+  if (!await pathExists(getSettingsPath(pmRoot))) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const settings = await readSettings(pmRoot);
+  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+  const runtimeFieldRegistry = resolveRuntimeFieldRegistry(settings.schema);
+  const dryRun = options.dryRun === true;
+  const rollbackId = typeof options.rollback === "string" ? options.rollback : void 0;
+  const updateSummary = sanitizeUpdateOptionsForSummary(options.update);
+  rejectBlankIdsFilter(options.list);
+  if (rollbackId) {
+    if (dryRun) {
+      throw new PmCliError("--dry-run cannot be combined with --rollback", EXIT_CODE.USAGE);
+    }
+    if (hasListFilters(options.list, options.status)) {
+      throw new PmCliError("Rollback mode does not accept filter options", EXIT_CODE.USAGE);
+    }
+    if (Object.keys(updateSummary).length > 0) {
+      throw new PmCliError("Rollback mode does not accept update mutation flags", EXIT_CODE.USAGE);
+    }
+    const checkpoint = await loadMutationCheckpoint(pmRoot, UPDATE_MANY_CHECKPOINT_SUBDIR, rollbackId, UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION);
+    const restoreMessage = options.update?.message ?? `Rollback update-many checkpoint ${checkpoint.id}`;
+    const rollback = await restoreCheckpointItems(checkpoint.items, (id, targetUpdatedAt) => runRestore(id, targetUpdatedAt, {
+      author: options.update?.author,
+      message: restoreMessage,
+      force: options.update?.force ?? true
+    }, global2));
+    return {
+      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
+    };
+  }
+  if (!hasAnyUpdateMutationInput(options.update)) {
+    throw new PmCliError(`No update-many mutation flags provided. Add at least one mutation flag (for example: ${UPDATE_MANY_MUTATION_FLAG_GUIDANCE}).`, EXIT_CODE.USAGE);
+  }
+  const statusFilter = normalizeStatusFilter(options.status, statusRegistry);
+  const listed = await runList(statusFilter, { ...options.list, includeBody: true }, global2);
+  const planned = listed.items.map((item) => buildPlannedItemDiff(item, options.update, runtimeFieldRegistry));
+  const actionable = planned.filter((row) => row.changes.length > 0);
+  if (dryRun) {
+    return {
+      mode: "dry_run",
+      matched_count: listed.items.length,
+      dry_run: true,
+      filters: listed.filters,
+      planned_update_options: updateSummary,
+      item_plans: planned,
+      ids: []
+    };
+  }
+  if (actionable.length === 0) {
+    return {
+      mode: "apply",
+      matched_count: listed.items.length,
+      dry_run: false,
+      filters: listed.filters,
+      planned_update_options: updateSummary,
+      updated_count: 0,
+      skipped_count: listed.items.length,
+      failed_count: 0,
+      rows: planned.map((row) => ({
+        id: row.id,
+        status: "skipped"
+      })),
+      ids: []
+    };
+  }
+  const nowValue = nowIso();
+  const checkpointId = createCheckpointId(UPDATE_MANY_CHECKPOINT_SUBDIR, nowValue);
+  const checkpointEnabled = options.checkpoint !== false;
+  const checkpointItems = listed.items.filter((item) => actionable.some((candidate) => candidate.id === item.id)).map((item) => ({
+    id: item.id,
+    target_updated_at: item.updated_at
+  }));
+  let checkpointInfo;
+  if (checkpointEnabled) {
+    const checkpointPayload = {
+      schema_version: UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION,
+      id: checkpointId,
+      created_at: nowValue,
+      author: resolveAuthor(options.update.author, "unknown"),
+      status_filter: statusFilter ?? null,
+      list_filters: listed.filters,
+      update_options: updateSummary,
+      items: checkpointItems
+    };
+    const checkpointPath = await writeMutationCheckpoint(pmRoot, UPDATE_MANY_CHECKPOINT_SUBDIR, checkpointId, checkpointPayload);
+    checkpointInfo = {
+      id: checkpointId,
+      created_at: nowValue,
+      path: checkpointPath,
+      rollback_command: `pm update-many --rollback ${checkpointId}`
+    };
+  }
+  const applyRows = [];
+  const updatedIds = [];
+  const updateMessage = options.update.message ?? `update-many apply ${checkpointId}`;
+  const actionableById = new Set(actionable.map((row) => row.id));
+  for (const item of listed.items) {
+    if (!actionableById.has(item.id)) {
+      applyRows.push({ id: item.id, status: "skipped" });
+      continue;
+    }
+    try {
+      const result = await runUpdate(item.id, {
+        ...options.update,
+        message: updateMessage,
+        runtimeFieldCommands: ["update_many"]
+      }, global2);
+      applyRows.push({
+        id: item.id,
+        status: "updated",
+        changed_fields: result.changed_fields,
+        warnings: result.warnings
+      });
+      updatedIds.push(item.id);
+    } catch (error) {
+      applyRows.push({
+        id: item.id,
+        status: "failed",
+        error: toErrorMessage(error)
+      });
+    }
+  }
+  const updatedCount = applyRows.filter((row) => row.status === "updated").length;
+  const skippedCount = applyRows.filter((row) => row.status === "skipped").length;
+  const failedCount = applyRows.filter((row) => row.status === "failed").length;
+  return {
+    mode: "apply",
+    matched_count: listed.items.length,
+    dry_run: false,
+    filters: listed.filters,
+    planned_update_options: updateSummary,
+    ...checkpointInfo ? { checkpoint: checkpointInfo } : {},
+    updated_count: updatedCount,
+    skipped_count: skippedCount,
+    failed_count: failedCount,
+    rows: applyRows,
+    ids: updatedIds
+  };
+}
+export {
+  runUpdateMany
+};
+//# sourceMappingURL=update-many-322CCH2L.js.map