@unbrained/pm-cli 2026.7.19 → 2026.7.20

package/dist/cli-bundle/chunks/{chunk-3KPNOZOH.js → chunk-X6K5XTTN.js}

@@ -1,33 +1,35 @@
 import {
   runUpdate
-} from "./chunk-P24ZU5QV.js";
+} from "./chunk-AOEOYL3S.js";
 import {
   resolvePriority
-} from "./chunk-3QNUDDY2.js";
+} from "./chunk-KZEANWJS.js";
 import {
   buildInvalidTypeError
-} from "./chunk-4M6RZJXF.js";
+} from "./chunk-WWNL6WMH.js";
 import {
+  applyAcceptanceCriteriaMutations,
   applyTagRemovals,
   mergeAdditiveTags,
   parseOptionalNonNegativeInteger,
-  parseTags
-} from "./chunk-A5EQPNV7.js";
+  parseTags,
+  splitAcceptanceCriteria
+} from "./chunk-GVT754PX.js";
 import {
   createCheckpointId,
   loadMutationCheckpoint,
   restoreCheckpointItems,
   writeMutationCheckpoint
-} from "./chunk-XVB6BATY.js";
+} from "./chunk-72LQ4TKV.js";
 import {
   hasListFilters
 } from "./chunk-KWYX6ZIR.js";
 import {
   runList
-} from "./chunk-YIC5NGXF.js";
+} from "./chunk-RMF7LMBS.js";
 import {
   runRestore
-} from "./chunk-FQODDTE7.js";
+} from "./chunk-WUVEBQW6.js";
 import {
   resolveAuthor
 } from "./chunk-YRYYFGV3.js";
@@ -40,7 +42,7 @@ import {
   resolveIsoOrRelative,
   stableValueEquals,
   toItemRecord
-} from "./chunk-RLLOZAM2.js";
+} from "./chunk-IY6VZ3IW.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -53,13 +55,13 @@ import {
   resolveRuntimeStatusRegistry,
   resolveTypeName,
   toErrorMessage
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.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] = "19acba6b-a459-52ce-b267-6f1d0db63265");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c71478fc-d38f-5d1b-b0de-632e04f83a80");
   } catch (e2) {
   }
 })();
@@ -396,6 +398,20 @@ var buildTagMutationPlan = (row, update) => {
   }
   return { field: "tags", before: existing, after };
 };
+var buildAcceptanceCriteriaMutationPlan = (row, update) => {
+  const before = row.acceptance_criteria;
+  const base = update.acceptanceCriteria === void 0 ? before : String(update.acceptanceCriteria).trim();
+  const mutation = applyAcceptanceCriteriaMutations(splitAcceptanceCriteria(base), update.addAc, update.removeAc);
+  const warnings = mutation.unmatchedRemovals.map((criterion) => `remove_ac_unmatched:${criterion}`);
+  const after = mutation.criteria.join("; ");
+  if (areValuesEqual(before, after) || before === void 0 && after === "") {
+    return { warnings };
+  }
+  return {
+    change: { field: "acceptance_criteria", before, after },
+    warnings
+  };
+};
 var appendScalarMutationPlans = (changes, row, update) => {
   for (const [optionKey, itemKey] of Object.entries(UPDATE_OPTION_TO_ITEM_KEY)) {
     const candidate = update[optionKey];
@@ -430,17 +446,28 @@ var appendUnsetMutationPlans = (changes, row, unset) => {
 var buildPlannedItemDiff = (item, runtimeFieldRegistry, update = {}) => {
   const row = toItemRecord(item);
   const changes = [];
+  const warnings = [];
   const tagPlan = buildTagMutationPlan(row, update);
   if (tagPlan) {
     changes.push(tagPlan);
   }
   appendScalarMutationPlans(changes, row, update);
+  if (updateArrayValueCount(update.addAc) > 0 || updateArrayValueCount(update.removeAc) > 0) {
+    const composed = buildAcceptanceCriteriaMutationPlan(row, update);
+    const withoutAc = changes.filter((change) => change.field !== "acceptance_criteria");
+    changes.splice(0, changes.length, ...withoutAc);
+    if (composed.change !== void 0) {
+      changes.push(composed.change);
+    }
+    warnings.push(...composed.warnings);
+  }
   changes.push(...buildCollectionMutationPlans(row, update));
   appendRuntimeFieldMutationPlans(changes, row, update, runtimeFieldRegistry);
   appendUnsetMutationPlans(changes, row, update.unset);
   return {
     id: item.id,
-    changes
+    changes,
+    ...warnings.length > 0 ? { warnings } : {}
   };
 };
 var normalizeStatusFilter = (value, statusRegistry) => {
@@ -541,6 +568,20 @@ var writeUpdateManyCheckpoint = async (params) => {
     rollback_command: `pm update-many --rollback ${params.checkpointId}`
   };
 };
+var 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));
+};
+var buildUnmatchedIdFields = (plan) => plan.unmatchedIds === void 0 ? {} : {
+  unmatched_ids: plan.unmatchedIds,
+  unmatched_count: plan.unmatchedIds.length
+};
 var loadUpdateManyRuntimeContext = async (global2) => {
   const pmRoot = resolvePmRoot(process.cwd(), global2.path);
   if (!await pathExists(getSettingsPath(pmRoot))) {
@@ -582,12 +623,18 @@ var buildUpdateManyPlan = async (params) => {
     full: true
   }, params.global);
   const planned = listed.items.map((item) => buildPlannedItemDiff(item, params.runtime.runtimeFieldRegistry, params.options.update));
+  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,
-    statusFilter
+    statusFilter,
+    unmatchedIds: collectUnmatchedRequestedIds(params.options.list?.ids, existenceItems)
   };
 };
 var buildUpdateManyDryRunResult = (plan) => ({
@@ -597,7 +644,8 @@ var buildUpdateManyDryRunResult = (plan) => ({
   filters: plan.listed.filters,
   planned_update_options: plan.updateSummary,
   item_plans: plan.planned,
-  ids: []
+  ids: [],
+  ...buildUnmatchedIdFields(plan)
 });
 var buildUpdateManyNoopResult = (plan) => ({
   mode: "apply",
@@ -610,18 +658,26 @@ var buildUpdateManyNoopResult = (plan) => ({
   failed_count: 0,
   rows: plan.planned.map((row) => ({
     id: row.id,
-    status: "skipped"
+    status: "skipped",
+    ...row.warnings ? { warnings: row.warnings } : {}
   })),
-  ids: []
+  ids: [],
+  ...buildUnmatchedIdFields(plan)
 });
 var applyUpdateManyRows = async (params) => {
   const rows = [];
   const updatedIds = [];
   const updateMessage = params.options.update.message ?? `update-many apply ${params.checkpointId}`;
-  const actionableById = new Set(params.actionable.map((row) => row.id));
+  const plannedById = new Map(params.plans.map((row) => [row.id, row]));
+  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" });
+      const warnings = plannedById.get(item.id)?.warnings;
+      rows.push({
+        id: item.id,
+        status: "skipped",
+        ...warnings ? { warnings } : {}
+      });
       continue;
     }
     try {
@@ -667,7 +723,7 @@ var applyUpdateManyPlan = async (params) => {
   });
   const applied = await applyUpdateManyRows({
     items: params.plan.listed.items,
-    actionable: params.plan.actionable,
+    plans: params.plan.planned,
     options: params.options,
     global: params.global,
     checkpointId
@@ -684,7 +740,8 @@ var applyUpdateManyPlan = async (params) => {
     skipped_count: countStatus("skipped"),
     failed_count: countStatus("failed"),
     rows: applied.rows,
-    ids: applied.updatedIds
+    ids: applied.updatedIds,
+    ...buildUnmatchedIdFields(params.plan)
   };
 };
 var runUpdateMany = async (options, global2) => {
@@ -734,4 +791,4 @@ export {
   runUpdateMany,
   _testOnlyUpdateManyCommand
 };
-//# sourceMappingURL=chunk-3KPNOZOH.js.map
+//# sourceMappingURL=chunk-X6K5XTTN.js.map

package/dist/cli-bundle/chunks/chunk-X6K5XTTN.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/update-many.ts"],
+  "sourcesContent": ["/**\n * @module cli/commands/update-many\n *\n * Implements the pm update many command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport {\n  createCheckpointId,\n  loadMutationCheckpoint,\n  restoreCheckpointItems,\n  writeMutationCheckpoint,\n  type MutationCheckpointItem,\n} from \"../../core/checkpoint/mutation-checkpoint.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport {\n  applyAcceptanceCriteriaMutations,\n  applyTagRemovals,\n  mergeAdditiveTags,\n  parseOptionalNonNegativeInteger,\n  parseTags,\n  splitAcceptanceCriteria,\n} from \"../../core/item/parse.js\";\nimport { resolvePriority } from \"../../core/item/priority.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport {\n  resolveItemTypeRegistry,\n  resolveTypeName,\n} from \"../../core/item/type-registry.js\";\nimport { collectRuntimeUpdateFieldValues } from \"../../core/schema/runtime-field-values.js\";\nimport { buildInvalidTypeError } from \"../../core/schema/item-types-file.js\";\nimport {\n  resolveItemTypesFilePath,\n  resolveRuntimeFieldRegistry,\n  resolveRuntimeStatusRegistry,\n  type RuntimeFieldRegistry,\n  type RuntimeStatusRegistry,\n} from \"../../core/schema/runtime-schema.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { toErrorMessage } from \"../../core/shared/primitives.js\";\nimport { stableValueEquals } from \"../../core/shared/serialization.js\";\nimport { nowIso, resolveIsoOrRelative } from \"../../core/shared/time.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport type { ItemStatus, PmSettings } from \"../../types/index.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { hasListFilters } from \"./list-filter-shared.js\";\nimport {\n  runList,\n  type ListFullResult,\n  type ListOptions,\n  type ListedItem,\n} from \"./list.js\";\nimport { runRestore } from \"./restore.js\";\nimport { runUpdate, type UpdateCommandOptions } from \"./update.js\";\n\nconst UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;\nconst UPDATE_MANY_CHECKPOINT_SUBDIR = \"update-many\";\n\nconst NON_MUTATION_UPDATE_OPTION_KEYS = new Set<PropertyKey>([\n  \"author\",\n  \"message\",\n  \"force\",\n  \"ownershipMetadataBypass\",\n  \"ownershipDependencyBypass\",\n]);\n\nconst UPDATE_MANY_MUTATION_FLAG_GUIDANCE = [\n  \"--status\",\n  \"--priority\",\n  \"--type\",\n  \"--tags\",\n  \"--description\",\n  \"--body\",\n  \"--deadline\",\n  \"--estimate\",\n  \"--assignee\",\n  \"--dep\",\n  \"--dep-remove\",\n  \"--comment\",\n  \"--note\",\n  \"--learning\",\n  \"--file\",\n  \"--test\",\n  \"--doc\",\n  \"--replace-deps\",\n  \"--replace-tests\",\n  \"--unset\",\n  \"--clear-*\",\n].join(\", \");\n\nconst UPDATE_OPTION_TO_ITEM_KEY: Partial<\n  Record<keyof UpdateCommandOptions, string>\n> = {\n  title: \"title\",\n  description: \"description\",\n  body: \"body\",\n  status: \"status\",\n  closeReason: \"close_reason\",\n  priority: \"priority\",\n  type: \"type\",\n  deadline: \"deadline\",\n  estimatedMinutes: \"estimated_minutes\",\n  acceptanceCriteria: \"acceptance_criteria\",\n  definitionOfReady: \"definition_of_ready\",\n  order: \"order\",\n  goal: \"goal\",\n  objective: \"objective\",\n  value: \"value\",\n  impact: \"impact\",\n  outcome: \"outcome\",\n  whyNow: \"why_now\",\n  assignee: \"assignee\",\n  parent: \"parent\",\n  reviewer: \"reviewer\",\n  risk: \"risk\",\n  confidence: \"confidence\",\n  sprint: \"sprint\",\n  release: \"release\",\n  blockedBy: \"blocked_by\",\n  blockedReason: \"blocked_reason\",\n  unblockNote: \"unblock_note\",\n  reporter: \"reporter\",\n  severity: \"severity\",\n  environment: \"environment\",\n  reproSteps: \"repro_steps\",\n  resolution: \"resolution\",\n  expectedResult: \"expected_result\",\n  actualResult: \"actual_result\",\n  affectedVersion: \"affected_version\",\n  fixedVersion: \"fixed_version\",\n  component: \"component\",\n  regression: \"regression\",\n  customerImpact: \"customer_impact\",\n};\n\ninterface CollectionMutationPlanDefinition {\n  field: string;\n  addKey: keyof UpdateCommandOptions;\n  removeKey?: keyof UpdateCommandOptions;\n  clearKey: keyof UpdateCommandOptions;\n  replaceKey?: keyof UpdateCommandOptions;\n}\n\nconst COLLECTION_MUTATION_PLAN_DEFINITIONS: CollectionMutationPlanDefinition[] =\n  [\n    {\n      field: \"dependencies\",\n      addKey: \"dep\",\n      removeKey: \"depRemove\",\n      clearKey: \"clearDeps\",\n      replaceKey: \"replaceDeps\",\n    },\n    {\n      field: \"comments\",\n      addKey: \"comment\",\n      clearKey: \"clearComments\",\n    },\n    {\n      field: \"notes\",\n      addKey: \"note\",\n      clearKey: \"clearNotes\",\n    },\n    {\n      field: \"learnings\",\n      addKey: \"learning\",\n      clearKey: \"clearLearnings\",\n    },\n    {\n      field: \"files\",\n      addKey: \"file\",\n      clearKey: \"clearFiles\",\n    },\n    {\n      field: \"tests\",\n      addKey: \"test\",\n      clearKey: \"clearTests\",\n      replaceKey: \"replaceTests\",\n    },\n    {\n      field: \"docs\",\n      addKey: \"doc\",\n      clearKey: \"clearDocs\",\n    },\n    {\n      field: \"reminders\",\n      addKey: \"reminder\",\n      clearKey: \"clearReminders\",\n    },\n    {\n      field: \"events\",\n      addKey: \"event\",\n      clearKey: \"clearEvents\",\n    },\n    {\n      field: \"type_options\",\n      addKey: \"typeOption\",\n      clearKey: \"clearTypeOptions\",\n    },\n  ];\n\nconst UNSET_FIELD_ALIASES: Record<string, string> = {\n  close_reason: \"close_reason\",\n  \"close-reason\": \"close_reason\",\n  deadline: \"deadline\",\n  estimate: \"estimated_minutes\",\n  estimated_minutes: \"estimated_minutes\",\n  \"estimated-minutes\": \"estimated_minutes\",\n  acceptance_criteria: \"acceptance_criteria\",\n  \"acceptance-criteria\": \"acceptance_criteria\",\n  ac: \"acceptance_criteria\",\n  definition_of_ready: \"definition_of_ready\",\n  \"definition-of-ready\": \"definition_of_ready\",\n  order: \"order\",\n  rank: \"order\",\n  goal: \"goal\",\n  objective: \"objective\",\n  value: \"value\",\n  impact: \"impact\",\n  outcome: \"outcome\",\n  why_now: \"why_now\",\n  \"why-now\": \"why_now\",\n  assignee: \"assignee\",\n  parent: \"parent\",\n  reviewer: \"reviewer\",\n  risk: \"risk\",\n  confidence: \"confidence\",\n  sprint: \"sprint\",\n  release: \"release\",\n  blocked_by: \"blocked_by\",\n  \"blocked-by\": \"blocked_by\",\n  blocked_reason: \"blocked_reason\",\n  \"blocked-reason\": \"blocked_reason\",\n  unblock_note: \"unblock_note\",\n  \"unblock-note\": \"unblock_note\",\n  reporter: \"reporter\",\n  severity: \"severity\",\n  environment: \"environment\",\n  repro_steps: \"repro_steps\",\n  \"repro-steps\": \"repro_steps\",\n  resolution: \"resolution\",\n  expected_result: \"expected_result\",\n  \"expected-result\": \"expected_result\",\n  actual_result: \"actual_result\",\n  \"actual-result\": \"actual_result\",\n  affected_version: \"affected_version\",\n  \"affected-version\": \"affected_version\",\n  fixed_version: \"fixed_version\",\n  \"fixed-version\": \"fixed_version\",\n  component: \"component\",\n  regression: \"regression\",\n  customer_impact: \"customer_impact\",\n  \"customer-impact\": \"customer_impact\",\n  type_options: \"type_options\",\n  \"type-options\": \"type_options\",\n  tags: \"tags\",\n};\n\ninterface UpdateManyCheckpoint {\n  schema_version: number;\n  id: string;\n  created_at: string;\n  author: string;\n  status_filter: string | null;\n  list_filters: Record<string, unknown>;\n  update_options: Record<string, unknown>;\n  items: MutationCheckpointItem[];\n}\n\n/** Documents the update many command options payload exchanged by command, SDK, and package integrations. */\nexport interface UpdateManyCommandOptions {\n  /** Lifecycle state reported for status. */\n  status?: string;\n  /** Value that configures or reports list for this contract. */\n  list: ListOptions;\n  /** Value that configures or reports update for this contract. */\n  update: UpdateCommandOptions;\n  /** Value that configures or reports dry run for this contract. */\n  dryRun?: boolean;\n  /** Value that configures or reports rollback for this contract. */\n  rollback?: string;\n  /** Value that configures or reports checkpoint for this contract. */\n  checkpoint?: boolean;\n}\n\ninterface PlannedChange {\n  field: string;\n  before: unknown;\n  after: unknown;\n}\n\ninterface PlannedItemDiff {\n  id: string;\n  changes: PlannedChange[];\n  warnings?: string[];\n}\n\ninterface UpdateManyApplyResultRow {\n  id: string;\n  status: \"updated\" | \"failed\" | \"skipped\";\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\ninterface UpdateManyRollbackResultRow {\n  id: string;\n  status: \"restored\" | \"failed\";\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\n/** Documents the update many result payload exchanged by command, SDK, and package integrations. */\nexport interface UpdateManyResult {\n  /** Value that configures or reports mode for this contract. */\n  mode: \"dry_run\" | \"apply\" | \"rollback\";\n  /** Number of matched entries represented by this result. */\n  matched_count: number;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports filters for this contract. */\n  filters?: Record<string, unknown>;\n  /** Inputs that customize the planned update operation. */\n  planned_update_options?: Record<string, unknown>;\n  /** Value that configures or reports item plans for this contract. */\n  item_plans?: PlannedItemDiff[];\n  /** Value that configures or reports checkpoint for this contract. */\n  checkpoint?: {\n    id: string;\n    created_at: string;\n    path: string;\n    rollback_command: string;\n  };\n  /** Number of updated entries represented by this result. */\n  updated_count?: number;\n  /** Number of skipped entries represented by this result. */\n  skipped_count?: number;\n  /** Number of failed entries represented by this result. */\n  failed_count?: number;\n  /** Number of restored entries represented by this result. */\n  restored_count?: number;\n  /** Value that configures or reports rollback checkpoint id for this contract. */\n  rollback_checkpoint_id?: string;\n  /** Value that configures or reports rows for this contract. */\n  rows?: UpdateManyApplyResultRow[] | UpdateManyRollbackResultRow[];\n  /** Value that configures or reports ids for this contract. */\n  ids: string[];\n  /** Explicitly requested --ids values that matched no tracked item. */\n  unmatched_ids?: string[];\n  /** Number of explicitly requested --ids values that matched no tracked item. */\n  unmatched_count?: number;\n}\n\n/** Removes execution-only options from the mutation summary persisted in checkpoints. */\nconst sanitizeUpdateOptionsForSummary = (\n  options: UpdateCommandOptions,\n): Record<string, unknown> => {\n  const summary: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(options) as Array<\n    [keyof UpdateCommandOptions, unknown]\n  >) {\n    if (NON_MUTATION_UPDATE_OPTION_KEYS.has(key)) {\n      continue;\n    }\n    if (value === undefined) {\n      continue;\n    }\n    summary[key] = value;\n  }\n  return summary;\n};\n\n/** Reports whether an update-many request contains at least one mutation input. */\nconst hasAnyUpdateMutationInput = (options: UpdateCommandOptions): boolean => {\n  return Object.keys(sanitizeUpdateOptionsForSummary(options)).length > 0;\n};\n\ntype PreviewValueNormalizer = (value: unknown) => unknown;\n\n/** Trims string preview values while preserving non-string inputs. */\nconst trimPreviewValue: PreviewValueNormalizer = (value) =>\n  typeof value === \"string\" ? value.trim() : value;\n/** Converts integer-like preview values to their storage representation. */\nconst normalizeIntegerPreviewValue: PreviewValueNormalizer = (value) => {\n  const trimmed = String(value).trim();\n  const parsed = Number(trimmed);\n  return Number.isInteger(parsed) ? parsed : trimmed;\n};\n/** Converts finite numeric preview values to their storage representation. */\nconst normalizeNumericPreviewValue: PreviewValueNormalizer = (value) => {\n  const trimmed = String(value).trim();\n  const parsed = Number(trimmed);\n  return Number.isFinite(parsed) ? parsed : trimmed;\n};\n/** Converts supported regression tokens to their boolean storage representation. */\nconst normalizeRegressionPreviewValue: PreviewValueNormalizer = (value) => {\n  const normalized = String(value).trim().toLowerCase();\n  const parsed = new Map<string, boolean>([\n    [\"true\", true],\n    [\"1\", true],\n    [\"false\", false],\n    [\"0\", false],\n  ]).get(normalized);\n  return parsed ?? trimPreviewValue(value);\n};\n\nconst PREVIEW_VALUE_NORMALIZERS: Partial<\n  Record<keyof UpdateCommandOptions, PreviewValueNormalizer>\n> = {\n  priority: normalizeIntegerPreviewValue,\n  estimatedMinutes: normalizeNumericPreviewValue,\n  order: normalizeNumericPreviewValue,\n  rank: normalizeNumericPreviewValue,\n  regression: normalizeRegressionPreviewValue,\n};\n\n/** Normalizes a CLI mutation value to the storage-shaped value used by previews. */\nconst toComparablePreviewValue = (\n  optionKey: keyof UpdateCommandOptions,\n  value: unknown,\n): unknown => {\n  if (value === undefined) {\n    return undefined;\n  }\n  return (PREVIEW_VALUE_NORMALIZERS[optionKey] ?? trimPreviewValue)(value);\n};\n\n/** Resolves user-facing unset aliases to stored metadata keys. */\nconst normalizeUnsetField = (rawField: string): string => {\n  const normalized = rawField.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  return UNSET_FIELD_ALIASES[normalized] ?? normalized;\n};\n\n/** Compares preview values using the canonical stable serialization contract. */\nconst areValuesEqual = (left: unknown, right: unknown): boolean => {\n  return stableValueEquals(left, right);\n};\n\n/** Supplies the storage-shaped empty value for an absent collection field. */\nconst normalizeCollectionBeforeValue = (\n  field: string,\n  value: unknown,\n): unknown => {\n  if (value !== undefined) {\n    return value;\n  }\n  if (field === \"type_options\") {\n    return {};\n  }\n  return [];\n};\n\n/** Counts entries in list and type-option collection values. */\nconst collectionValueCount = (field: string, value: unknown): number => {\n  if (Array.isArray(value)) {\n    return value.length;\n  }\n  if (field === \"type_options\" && value && typeof value === \"object\") {\n    return Object.keys(value as Record<string, unknown>).length;\n  }\n  return 0;\n};\n\n/** Resolves the dominant collection mutation using apply-path precedence. */\nconst resolveCollectionMutationOperation = (params: {\n  replace: boolean;\n  clear: boolean;\n  removeCount: number;\n}): string => {\n  if (params.replace) {\n    return \"replace\";\n  }\n  if (params.clear) {\n    return \"clear_or_reset\";\n  }\n  return params.removeCount > 0 ? \"merge_remove\" : \"append\";\n};\n\n/** Reads an optional definition key without indexing through undefined. */\nconst readOptionalUpdateValue = (\n  update: UpdateCommandOptions,\n  key: keyof UpdateCommandOptions | undefined,\n): unknown => (key === undefined ? undefined : update[key]);\n\n/** Counts array-shaped mutation inputs while treating other shapes as empty. */\nconst updateArrayValueCount = (value: unknown): number =>\n  Array.isArray(value) ? value.length : 0;\n\n/** Builds one collection plan when its definition has an active mutation. */\nconst buildCollectionMutationPlan = (\n  definition: CollectionMutationPlanDefinition,\n  row: Record<string, unknown>,\n  update: UpdateCommandOptions,\n): PlannedChange | undefined => {\n  const addValues = update[definition.addKey];\n  const removeValues = readOptionalUpdateValue(update, definition.removeKey);\n  const addCount = updateArrayValueCount(addValues);\n  const removeCount = updateArrayValueCount(removeValues);\n  const clear = update[definition.clearKey] === true;\n  const replace =\n    readOptionalUpdateValue(update, definition.replaceKey) === true;\n  if (![clear, replace, addCount > 0, removeCount > 0].includes(true)) {\n    return undefined;\n  }\n  const before = normalizeCollectionBeforeValue(\n    definition.field,\n    row[definition.field],\n  );\n  return {\n    field: definition.field,\n    before,\n    after: {\n      operation: resolveCollectionMutationOperation({\n        replace,\n        clear,\n        removeCount,\n      }),\n      clear,\n      replace,\n      add_count: addCount,\n      remove_count: removeCount,\n      before_count: collectionValueCount(definition.field, before),\n    },\n  };\n};\n\n/** Builds collection mutation previews for every active collection option. */\nconst buildCollectionMutationPlans = (\n  row: Record<string, unknown>,\n  update: UpdateCommandOptions,\n): PlannedChange[] => {\n  const changes: PlannedChange[] = [];\n  for (const definition of COLLECTION_MUTATION_PLAN_DEFINITIONS) {\n    const plan = buildCollectionMutationPlan(definition, row, update);\n    if (plan !== undefined) {\n      changes.push(plan);\n    }\n  }\n  return changes;\n};\n\n/** Keeps only string tags from an existing storage value. */\nconst normalizeExistingTags = (value: unknown): string[] => {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  return value.filter((tag): tag is string => typeof tag === \"string\");\n};\n\n// Tags support three mutation modes that compose: --tags replaces, --add-tags\n// extends, --remove-tags prunes. Replicate runUpdate's resolution order so the\n// dry-run preview and the apply-mode actionable detection both account for\n// additive/subtractive tag mutations (a --add-tags-only update must NOT be\n// treated as a no-op skip).\nconst buildTagMutationPlan = (\n  row: Record<string, unknown>,\n  update: UpdateCommandOptions,\n): PlannedChange | undefined => {\n  if (\n    ![\n      update.tags !== undefined,\n      updateArrayValueCount(update.addTags) > 0,\n      updateArrayValueCount(update.removeTags) > 0,\n    ].includes(true)\n  ) {\n    return undefined;\n  }\n  const existing = normalizeExistingTags(row.tags);\n  const baseTags =\n    update.tags === undefined ? existing : parseTags(update.tags);\n  const withAdditions = mergeAdditiveTags(baseTags, update.addTags);\n  const after = applyTagRemovals(withAdditions, update.removeTags)\n    .slice()\n    .sort((a, b) => a.localeCompare(b));\n  const before = existing.slice().sort((a, b) => a.localeCompare(b));\n  if (areValuesEqual(before, after)) {\n    return undefined;\n  }\n  return { field: \"tags\", before: existing, after };\n};\n\n// Acceptance criteria support replace (--ac) plus additive --add-ac/--remove-ac\n// (GH-612). Replicate runUpdate's resolution order so dry-run previews and\n// apply-mode actionable detection account for additive criterion mutations (an\n// --add-ac-only bulk update must NOT be treated as a no-op skip).\nconst buildAcceptanceCriteriaMutationPlan = (\n  row: Record<string, unknown>,\n  update: UpdateCommandOptions,\n): { change?: PlannedChange; warnings: string[] } => {\n  const before = row.acceptance_criteria;\n  const base =\n    update.acceptanceCriteria === undefined\n      ? before\n      : String(update.acceptanceCriteria).trim();\n  const mutation = applyAcceptanceCriteriaMutations(\n    splitAcceptanceCriteria(base),\n    update.addAc,\n    update.removeAc,\n  );\n  const warnings = mutation.unmatchedRemovals.map(\n    (criterion) => `remove_ac_unmatched:${criterion}`,\n  );\n  const after = mutation.criteria.join(\"; \");\n  if (areValuesEqual(before, after) || (before === undefined && after === \"\")) {\n    return { warnings };\n  }\n  return {\n    change: { field: \"acceptance_criteria\", before, after },\n    warnings,\n  };\n};\n\n/** Adds changed scalar options to a planned item diff. */\nconst appendScalarMutationPlans = (\n  changes: PlannedChange[],\n  row: Record<string, unknown>,\n  update: UpdateCommandOptions,\n): void => {\n  for (const [optionKey, itemKey] of Object.entries(\n    UPDATE_OPTION_TO_ITEM_KEY,\n  ) as Array<[keyof UpdateCommandOptions, string]>) {\n    const candidate = update[optionKey];\n    if (candidate === undefined) {\n      continue;\n    }\n    const before = row[itemKey];\n    const after = toComparablePreviewValue(optionKey, candidate);\n    if (!areValuesEqual(before, after)) {\n      changes.push({ field: itemKey, before, after });\n    }\n  }\n};\n\n/** Adds changed runtime-schema fields to a planned item diff. */\nconst appendRuntimeFieldMutationPlans = (\n  changes: PlannedChange[],\n  row: Record<string, unknown>,\n  update: UpdateCommandOptions,\n  runtimeFieldRegistry: RuntimeFieldRegistry,\n): void => {\n  const runtimeFieldUpdates = collectRuntimeUpdateFieldValues(\n    update as Record<string, unknown>,\n    runtimeFieldRegistry,\n    [\"update_many\"],\n  );\n  for (const [field, after] of Object.entries(runtimeFieldUpdates)) {\n    const before = row[field];\n    if (!areValuesEqual(before, after)) {\n      changes.push({ field, before, after });\n    }\n  }\n};\n\n/** Adds present fields requested through unset options to a planned item diff. */\nconst appendUnsetMutationPlans = (\n  changes: PlannedChange[],\n  row: Record<string, unknown>,\n  unset: string[] | undefined,\n): void => {\n  for (const rawUnsetField of unset ?? []) {\n    const field = normalizeUnsetField(rawUnsetField);\n    const before = row[field];\n    if (before !== undefined) {\n      changes.push({ field, before, after: null });\n    }\n  }\n};\n\n/** Builds the complete storage-shaped mutation preview for one item. */\nconst buildPlannedItemDiff = (\n  item: ListedItem,\n  runtimeFieldRegistry: RuntimeFieldRegistry,\n  update: UpdateCommandOptions = {},\n): PlannedItemDiff => {\n  const row = toItemRecord(item);\n  const changes: PlannedChange[] = [];\n  const warnings: string[] = [];\n  const tagPlan = buildTagMutationPlan(row, update);\n  if (tagPlan) {\n    changes.push(tagPlan);\n  }\n  appendScalarMutationPlans(changes, row, update);\n  if (\n    updateArrayValueCount(update.addAc) > 0 ||\n    updateArrayValueCount(update.removeAc) > 0\n  ) {\n    const composed = buildAcceptanceCriteriaMutationPlan(row, update);\n    const withoutAc = changes.filter(\n      (change) => change.field !== \"acceptance_criteria\",\n    );\n    changes.splice(0, changes.length, ...withoutAc);\n    if (composed.change !== undefined) {\n      changes.push(composed.change);\n    }\n    warnings.push(...composed.warnings);\n  }\n  changes.push(...buildCollectionMutationPlans(row, update));\n  appendRuntimeFieldMutationPlans(changes, row, update, runtimeFieldRegistry);\n  appendUnsetMutationPlans(changes, row, update.unset);\n\n  return {\n    id: item.id,\n    changes,\n    ...(warnings.length > 0 ? { warnings } : {}),\n  };\n};\n\n/** Normalizes an optional list status against the runtime schema. */\nconst normalizeStatusFilter = (\n  value: string | undefined,\n  statusRegistry: RuntimeStatusRegistry,\n): ItemStatus | undefined => {\n  if (value === undefined) {\n    return undefined;\n  }\n  const normalized = normalizeStatusInput(value, statusRegistry);\n  if (!normalized) {\n    const allowedStatuses = statusRegistry.definitions.map(\n      (definition) => definition.id,\n    );\n    throw new PmCliError(\n      `Invalid --filter-status value \"${value}\". Allowed: ${allowedStatuses.join(\", \")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return normalized;\n};\n\n/** Rejects an explicitly blank bulk ID filter before loading the corpus. */\nconst rejectBlankIdsFilter = (list: ListOptions | undefined): void => {\n  if (list?.ids != null && String(list.ids).trim().length === 0) {\n    throw new PmCliError(\n      \"--ids requires at least one non-empty item ID\",\n      EXIT_CODE.USAGE,\n    );\n  }\n};\n\n// GH-256: validate planned scalar enum/format fields up front so a `--dry-run`\n// preview rejects globally-invalid values exactly as apply would (true\n// preview==apply parity), and so apply itself fails fast before creating an\n// orphan checkpoint. Only VALUE/ENUM/FORMAT correctness is checked here — these\n// are invalid regardless of the matched item. Per-item governance and\n// workflow-transition rules stay in the apply path (runUpdate). Each field is\n// validated only when the caller actually provided it, reusing the exact same\n// resolvers and error messages runUpdate raises so single/bulk/dry-run stay\n// consistent.\ninterface PlannedUpdateValidationContext {\n  update: UpdateCommandOptions;\n  settings: PmSettings;\n  statusRegistry: RuntimeStatusRegistry;\n  pmRoot: string;\n}\n\ntype PlannedUpdateValidator = (context: PlannedUpdateValidationContext) => void;\n\nconst PLANNED_UPDATE_VALIDATORS: PlannedUpdateValidator[] = [\n  ({ update }) => {\n    if (update.priority !== undefined) {\n      resolvePriority(update.priority);\n    }\n  },\n  ({ update, settings, pmRoot }) => {\n    if (update.type === undefined) {\n      return;\n    }\n    const typeRegistry = resolveItemTypeRegistry(\n      settings,\n      getActiveExtensionRegistrations(),\n    );\n    if (!resolveTypeName(update.type, typeRegistry)) {\n      throw new PmCliError(\n        buildInvalidTypeError(\n          update.type,\n          typeRegistry.types,\n          resolveItemTypesFilePath(pmRoot, settings.schema),\n        ),\n        EXIT_CODE.USAGE,\n      );\n    }\n  },\n  ({ update, statusRegistry }) => {\n    if (\n      update.status !== undefined &&\n      !normalizeStatusInput(update.status, statusRegistry)\n    ) {\n      const allowedStatuses = statusRegistry.definitions.map(\n        (definition) => definition.id,\n      );\n      throw new PmCliError(\n        `Invalid --status value \"${update.status}\". Allowed: ${allowedStatuses.join(\", \")}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n  },\n  ({ update }) => {\n    if (update.deadline !== undefined) {\n      resolveIsoOrRelative(update.deadline, new Date(), \"deadline\");\n    }\n  },\n  ({ update }) => {\n    if (update.estimatedMinutes !== undefined) {\n      parseOptionalNonNegativeInteger(\n        update.estimatedMinutes,\n        \"estimated-minutes\",\n      );\n    }\n  },\n];\n\n/** Validates globally invalid mutation values before preview or checkpoint work. */\nconst assertPlannedUpdateValuesValid = (\n  update: UpdateCommandOptions,\n  settings: PmSettings,\n  statusRegistry: RuntimeStatusRegistry,\n  pmRoot: string,\n): void => {\n  const context = { update, settings, statusRegistry, pmRoot };\n  for (const validate of PLANNED_UPDATE_VALIDATORS) {\n    validate(context);\n  }\n};\n\n/** Restores every item captured by an update-many checkpoint. */\nconst runUpdateManyRollback = async (params: {\n  pmRoot: string;\n  rollbackId: string;\n  options: UpdateManyCommandOptions;\n  global: GlobalOptions;\n}): Promise<UpdateManyResult> => {\n  const checkpoint = await loadMutationCheckpoint(\n    params.pmRoot,\n    UPDATE_MANY_CHECKPOINT_SUBDIR,\n    params.rollbackId,\n    UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION,\n  );\n  const restoreMessage =\n    params.options.update?.message ??\n    `Rollback update-many checkpoint ${checkpoint.id}`;\n  const rollback = await restoreCheckpointItems(\n    checkpoint.items,\n    (id, targetUpdatedAt) =>\n      runRestore(\n        id,\n        targetUpdatedAt,\n        {\n          author: params.options.update?.author,\n          message: restoreMessage,\n          force: params.options.update?.force ?? true,\n        },\n        params.global,\n      ),\n  );\n  return {\n    mode: \"rollback\",\n    matched_count: checkpoint.items.length,\n    dry_run: false,\n    rollback_checkpoint_id: checkpoint.id,\n    checkpoint: {\n      id: checkpoint.id,\n      created_at: checkpoint.created_at,\n      path: checkpoint.path,\n      rollback_command: `pm update-many --rollback ${checkpoint.id}`,\n    },\n    restored_count: rollback.restored_ids.length,\n    failed_count: rollback.failed_count,\n    rows: rollback.rows,\n    ids: rollback.restored_ids,\n  };\n};\n\n/** Persists an apply checkpoint and returns its user-facing descriptor. */\nconst writeUpdateManyCheckpoint = async (params: {\n  pmRoot: string;\n  checkpointId: string;\n  nowValue: string;\n  options: UpdateManyCommandOptions;\n  statusFilter: string | undefined;\n  filters: Record<string, unknown>;\n  updateSummary: Record<string, unknown>;\n  checkpointItems: MutationCheckpointItem[];\n}): Promise<UpdateManyResult[\"checkpoint\"]> => {\n  const checkpointPayload: UpdateManyCheckpoint = {\n    schema_version: UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION,\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    author: resolveAuthor(params.options.update?.author, \"unknown\"),\n    status_filter: params.statusFilter ?? null,\n    list_filters: params.filters,\n    update_options: params.updateSummary,\n    items: params.checkpointItems,\n  };\n  const checkpointPath = await writeMutationCheckpoint(\n    params.pmRoot,\n    UPDATE_MANY_CHECKPOINT_SUBDIR,\n    params.checkpointId,\n    checkpointPayload,\n  );\n  return {\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    path: checkpointPath,\n    rollback_command: `pm update-many --rollback ${params.checkpointId}`,\n  };\n};\n\ninterface UpdateManyRuntimeContext {\n  pmRoot: string;\n  settings: PmSettings;\n  statusRegistry: RuntimeStatusRegistry;\n  runtimeFieldRegistry: RuntimeFieldRegistry;\n}\n\ninterface UpdateManyPlan {\n  listed: ListFullResult;\n  planned: PlannedItemDiff[];\n  actionable: PlannedItemDiff[];\n  updateSummary: Record<string, unknown>;\n  statusFilter: ItemStatus | undefined;\n  unmatchedIds: string[] | undefined;\n}\n\n// GH-596: an explicit --ids request naming IDs that do not exist must stay\n// machine-detectable without client-side set differencing. The requested list\n// is re-derived here (same CSV split as the list filter) and compared against\n// the unfiltered storage corpus so pagination and additional query filters do\n// not misclassify existing items as nonexistent.\nconst collectUnmatchedRequestedIds = (\n  rawIds: unknown,\n  existingItems: ReadonlyArray<{ id: string }>,\n): string[] | undefined => {\n  if (rawIds == null) {\n    return undefined;\n  }\n  const requested = [\n    ...new Set(\n      String(rawIds)\n        .split(\",\")\n        .map((entry) => entry.trim())\n        .filter((entry) => entry.length > 0),\n    ),\n  ];\n  const existing = new Set(existingItems.map((item) => item.id));\n  return requested.filter((id) => !existing.has(id));\n};\n\n/** Builds the shared unmatched-id envelope fields for one prepared plan. */\nconst buildUnmatchedIdFields = (\n  plan: UpdateManyPlan,\n): Pick<UpdateManyResult, \"unmatched_ids\" | \"unmatched_count\"> =>\n  plan.unmatchedIds === undefined\n    ? {}\n    : {\n        unmatched_ids: plan.unmatchedIds,\n        unmatched_count: plan.unmatchedIds.length,\n      };\n\n/** Loads tracker settings and runtime registries for update-many execution. */\nconst loadUpdateManyRuntimeContext = async (\n  global: GlobalOptions,\n): Promise<UpdateManyRuntimeContext> => {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  return {\n    pmRoot,\n    settings,\n    statusRegistry: resolveRuntimeStatusRegistry(settings.schema),\n    runtimeFieldRegistry: resolveRuntimeFieldRegistry(settings.schema),\n  };\n};\n\n/** Validates rollback exclusivity before restoring a checkpoint. */\nconst runRequestedUpdateManyRollback = (params: {\n  runtime: UpdateManyRuntimeContext;\n  rollbackId: string;\n  options: UpdateManyCommandOptions;\n  global: GlobalOptions;\n  updateSummary: Record<string, unknown>;\n}): Promise<UpdateManyResult> => {\n  if (params.options.dryRun === true) {\n    throw new PmCliError(\n      \"--dry-run cannot be combined with --rollback\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (hasListFilters(params.options.list, params.options.status)) {\n    throw new PmCliError(\n      \"Rollback mode does not accept filter options\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (Object.keys(params.updateSummary).length > 0) {\n    throw new PmCliError(\n      \"Rollback mode does not accept update mutation flags\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  return runUpdateManyRollback({\n    pmRoot: params.runtime.pmRoot,\n    rollbackId: params.rollbackId,\n    options: params.options,\n    global: params.global,\n  });\n};\n\n/** Loads complete matching rows and derives their mutation previews. */\nconst buildUpdateManyPlan = async (params: {\n  options: UpdateManyCommandOptions;\n  global: GlobalOptions;\n  runtime: UpdateManyRuntimeContext;\n  updateSummary: Record<string, unknown>;\n}): Promise<UpdateManyPlan> => {\n  const statusFilter = normalizeStatusFilter(\n    params.options.status,\n    params.runtime.statusRegistry,\n  );\n  const listed = await runList(\n    statusFilter,\n    {\n      ...params.options.list,\n      compact: undefined,\n      brief: undefined,\n      fields: undefined,\n      includeBody: true,\n      full: true,\n    },\n    params.global,\n  );\n  const planned = listed.items.map((item) =>\n    buildPlannedItemDiff(\n      item,\n      params.runtime.runtimeFieldRegistry,\n      params.options.update,\n    ),\n  );\n  const existenceItems =\n    params.options.list?.ids == null\n      ? []\n      : (\n          await runList(\n            undefined,\n            {\n              ids: params.options.list.ids,\n              noTruncate: true,\n              full: true,\n            },\n            params.global,\n          )\n        ).items;\n  return {\n    listed,\n    planned,\n    actionable: planned.filter((row) => row.changes.length > 0),\n    updateSummary: params.updateSummary,\n    statusFilter,\n    unmatchedIds: collectUnmatchedRequestedIds(\n      params.options.list?.ids,\n      existenceItems,\n    ),\n  };\n};\n\n/** Builds the non-mutating preview response for a prepared update-many plan. */\nconst buildUpdateManyDryRunResult = (\n  plan: UpdateManyPlan,\n): UpdateManyResult => ({\n  mode: \"dry_run\",\n  matched_count: plan.listed.items.length,\n  dry_run: true,\n  filters: plan.listed.filters,\n  planned_update_options: plan.updateSummary,\n  item_plans: plan.planned,\n  ids: [],\n  ...buildUnmatchedIdFields(plan),\n});\n\n/** Builds the apply response for a plan whose rows are all already current. */\nconst buildUpdateManyNoopResult = (plan: UpdateManyPlan): UpdateManyResult => ({\n  mode: \"apply\",\n  matched_count: plan.listed.items.length,\n  dry_run: false,\n  filters: plan.listed.filters,\n  planned_update_options: plan.updateSummary,\n  updated_count: 0,\n  skipped_count: plan.listed.items.length,\n  failed_count: 0,\n  rows: plan.planned.map((row) => ({\n    id: row.id,\n    status: \"skipped\" as const,\n    ...(row.warnings ? { warnings: row.warnings } : {}),\n  })),\n  ids: [],\n  ...buildUnmatchedIdFields(plan),\n});\n\n/** Applies planned item updates independently while preserving per-row failures. */\nconst applyUpdateManyRows = async (params: {\n  items: ListedItem[];\n  plans: PlannedItemDiff[];\n  options: UpdateManyCommandOptions;\n  global: GlobalOptions;\n  checkpointId: string;\n}): Promise<{ rows: UpdateManyApplyResultRow[]; updatedIds: string[] }> => {\n  const rows: UpdateManyApplyResultRow[] = [];\n  const updatedIds: string[] = [];\n  const updateMessage =\n    params.options.update.message ?? `update-many apply ${params.checkpointId}`;\n  const plannedById = new Map(params.plans.map((row) => [row.id, row]));\n  const actionableById = new Set(\n    params.plans.filter((row) => row.changes.length > 0).map((row) => row.id),\n  );\n  for (const item of params.items) {\n    if (!actionableById.has(item.id)) {\n      const warnings = plannedById.get(item.id)?.warnings;\n      rows.push({\n        id: item.id,\n        status: \"skipped\",\n        ...(warnings ? { warnings } : {}),\n      });\n      continue;\n    }\n    try {\n      const result = await runUpdate(\n        item.id,\n        {\n          ...params.options.update,\n          message: updateMessage,\n          runtimeFieldCommands: [\"update_many\"],\n        },\n        params.global,\n      );\n      rows.push({\n        id: item.id,\n        status: \"updated\",\n        changed_fields: result.changed_fields,\n        warnings: result.warnings,\n      });\n      updatedIds.push(item.id);\n    } catch (error: unknown) {\n      rows.push({\n        id: item.id,\n        status: \"failed\",\n        error: toErrorMessage(error),\n      });\n    }\n  }\n  return { rows, updatedIds };\n};\n\n/** Applies a prepared plan, checkpointing actionable rows when requested. */\nconst applyUpdateManyPlan = async (params: {\n  runtime: UpdateManyRuntimeContext;\n  options: UpdateManyCommandOptions;\n  global: GlobalOptions;\n  plan: UpdateManyPlan;\n}): Promise<UpdateManyResult> => {\n  if (params.plan.actionable.length === 0) {\n    return buildUpdateManyNoopResult(params.plan);\n  }\n  const nowValue = nowIso();\n  const checkpointId = createCheckpointId(\n    UPDATE_MANY_CHECKPOINT_SUBDIR,\n    nowValue,\n  );\n  const actionableById = new Set(params.plan.actionable.map((row) => row.id));\n  const checkpointItems = params.plan.listed.items\n    .filter((item) => actionableById.has(item.id))\n    .map((item) => ({ id: item.id, target_updated_at: item.updated_at }));\n  const checkpointInfo =\n    params.options.checkpoint === false\n      ? undefined\n      : await writeUpdateManyCheckpoint({\n          pmRoot: params.runtime.pmRoot,\n          checkpointId,\n          nowValue,\n          options: params.options,\n          statusFilter: params.plan.statusFilter,\n          filters: params.plan.listed.filters,\n          updateSummary: params.plan.updateSummary,\n          checkpointItems,\n        });\n  const applied = await applyUpdateManyRows({\n    items: params.plan.listed.items,\n    plans: params.plan.planned,\n    options: params.options,\n    global: params.global,\n    checkpointId,\n  });\n  /** Counts apply rows with one terminal status. */\n  const countStatus = (status: UpdateManyApplyResultRow[\"status\"]): number =>\n    applied.rows.filter((row) => row.status === status).length;\n  return {\n    mode: \"apply\",\n    matched_count: params.plan.listed.items.length,\n    dry_run: false,\n    filters: params.plan.listed.filters,\n    planned_update_options: params.plan.updateSummary,\n    ...(checkpointInfo ? { checkpoint: checkpointInfo } : {}),\n    updated_count: countStatus(\"updated\"),\n    skipped_count: countStatus(\"skipped\"),\n    failed_count: countStatus(\"failed\"),\n    rows: applied.rows,\n    ids: applied.updatedIds,\n    ...buildUnmatchedIdFields(params.plan),\n  };\n};\n\n/** Implements run update many for the public runtime surface of this module. */\nexport const runUpdateMany = async (\n  options: UpdateManyCommandOptions,\n  global: GlobalOptions,\n): Promise<UpdateManyResult> => {\n  const runtime = await loadUpdateManyRuntimeContext(global);\n  const rollbackId =\n    typeof options.rollback === \"string\" ? options.rollback : undefined;\n  const updateSummary = sanitizeUpdateOptionsForSummary(options.update);\n  rejectBlankIdsFilter(options.list);\n  if (rollbackId !== undefined) {\n    return runRequestedUpdateManyRollback({\n      runtime,\n      rollbackId,\n      options,\n      global,\n      updateSummary,\n    });\n  }\n  if (!hasAnyUpdateMutationInput(options.update)) {\n    throw new PmCliError(\n      `No update-many mutation flags provided. Add at least one mutation flag (for example: ${UPDATE_MANY_MUTATION_FLAG_GUIDANCE}).`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  assertPlannedUpdateValuesValid(\n    options.update,\n    runtime.settings,\n    runtime.statusRegistry,\n    runtime.pmRoot,\n  );\n  const plan = await buildUpdateManyPlan({\n    options,\n    global,\n    runtime,\n    updateSummary,\n  });\n  return options.dryRun === true\n    ? buildUpdateManyDryRunResult(plan)\n    : applyUpdateManyPlan({ runtime, options, global, plan });\n};\n\n/** Public contract for test only update many command, shared by SDK and presentation-layer consumers. */\nexport const _testOnlyUpdateManyCommand = {\n  assertPlannedUpdateValuesValid,\n  buildCollectionMutationPlans,\n  buildPlannedItemDiff,\n  buildTagMutationPlan,\n  collectionValueCount,\n  hasAnyUpdateMutationInput,\n  hasListFilters,\n  normalizeStatusFilter,\n  normalizeCollectionBeforeValue,\n  normalizeExistingTags,\n  normalizeUnsetField,\n  rejectBlankIdsFilter,\n  sanitizeUpdateOptionsForSummary,\n  toComparablePreviewValue,\n};\n"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/{chunk-G33XIMRT.js → chunk-XJF7CDNH.js}

@@ -1,8 +1,8 @@
 
-!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]="c1a718f6-bc42-53b0-a337-f777e26bd386")}catch(e){}}();
+!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]="7ea426c5-e4fc-52f3-bdd8-8e99c3e2a798")}catch(e){}}();
 import {
   createStdinTokenResolver
-} from "./chunk-SVAWG7EE.js";
+} from "./chunk-J4FBIFU6.js";
 import {
   resolveAuthor
 } from "./chunk-CUFW7ITY.js";
@@ -10,14 +10,14 @@ import {
   mutateItem,
   readSettings,
   toItemRecord
-} from "./chunk-QFG4MB7P.js";
+} from "./chunk-POG76WWZ.js";
 import {
   EXIT_CODE,
   PmCliError,
   getSettingsPath,
   pathExists,
   resolvePmRoot
-} from "./chunk-D35WYXWC.js";
+} from "./chunk-HYW67VJ5.js";
 
 // dist/cli/commands/append.js
 async function runAppend(id, options, global) {
@@ -33,6 +33,16 @@ async function runAppend(id, options, global) {
   const author = resolveAuthor(options.author, settings.author_default);
   const bodyInput = await stdinResolver.resolveValue(options.body, "--body");
   const appended = bodyInput.trim();
+  if (appended.length === 0) {
+    throw new PmCliError("--body text cannot be empty; append requires non-blank content and empty appends would only rewrite updated_at.", EXIT_CODE.USAGE, {
+      code: "append_empty_body",
+      required: "Provide non-empty body text positionally, via --body, or with - for stdin.",
+      examples: [
+        'pm append pm-a1b2 --body "Progress note"',
+        "pm append pm-a1b2 --body -"
+      ]
+    });
+  }
   const result = await mutateItem({
     pmRoot,
     settings,
@@ -42,9 +52,6 @@ async function runAppend(id, options, global) {
     message: options.message,
     force: options.force,
     mutate(document) {
-      if (appended.length === 0) {
-        return { changedFields: [] };
-      }
       const spacer = document.body.trim().length > 0 ? "\n\n" : "";
       document.body = `${document.body.replace(/\s+$/, "")}${spacer}${appended}
 `;
@@ -53,7 +60,7 @@ async function runAppend(id, options, global) {
   });
   return {
     item: toItemRecord(result.item),
-    appended: appended.length > 0 ? appended : "",
+    appended,
     changed_fields: result.changedFields
   };
 }
@@ -61,6 +68,6 @@ async function runAppend(id, options, global) {
 export {
   runAppend
 };
-//# sourceMappingURL=chunk-G33XIMRT.js.map
+//# sourceMappingURL=chunk-XJF7CDNH.js.map
 
-//# debugId=c1a718f6-bc42-53b0-a337-f777e26bd386
+//# debugId=7ea426c5-e4fc-52f3-bdd8-8e99c3e2a798

package/dist/cli-bundle/chunks/{chunk-G33XIMRT.js.map → chunk-XJF7CDNH.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/append.ts"],"sourcesContent":["/**\n * @module cli/commands/append\n *\n * Implements the pm append command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\n/** Documents the append command options payload exchanged by command, SDK, and package integrations. */\nexport interface AppendCommandOptions {\n  /** Value that configures or reports body for this contract. */\n  body: string;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the append result payload exchanged by command, SDK, and package integrations. */\nexport interface AppendResult {\n  /** Value that configures or reports item for this contract. */\n  item: Record<string, unknown>;\n  /** Value that configures or reports appended for this contract. */\n  appended: string;\n  /** Value that configures or reports changed fields for this contract. */\n  changed_fields: string[];\n}\n\n/** Implements run append for the public runtime surface of this module. */\nexport async function runAppend(\n  id: string,\n  options: AppendCommandOptions,\n  global: GlobalOptions,\n): Promise<AppendResult> {\n  if (options.body === undefined) {\n    throw new PmCliError(\"Missing required --body text\", EXIT_CODE.USAGE);\n  }\n  const stdinResolver = createStdinTokenResolver();\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  // options.body is guaranteed defined by the guard above, so resolveValue returns a defined string.\n  const bodyInput = await stdinResolver.resolveValue(options.body, \"--body\");\n  const appended = (bodyInput as string).trim();\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"append\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      if (appended.length === 0) {\n        return { changedFields: [] };\n      }\n      const spacer = document.body.trim().length > 0 ? \"\\n\\n\" : \"\";\n      document.body = `${document.body.replace(/\\s+$/, \"\")}${spacer}${appended}\\n`;\n      return { changedFields: [\"body\"] };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    appended: appended.length > 0 ? appended : \"\",\n    changed_fields: result.changedFields,\n  };\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuCA,eAAsB,UACpB,IACA,SACA,QAAqB;AAErB,MAAI,QAAQ,SAAS,QAAW;AAC9B,UAAM,IAAI,WAAW,gCAAgC,UAAU,KAAK;EACtE;AACA,QAAM,gBAAgB,yBAAwB;AAC9C,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAI,OAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WACR,iCAAiC,MAAM,wBACvC,UAAU,SAAS;EAEvB;AACA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,SAAS,cAAc,QAAQ,QAAQ,SAAS,cAAc;AAEpE,QAAM,YAAY,MAAM,cAAc,aAAa,QAAQ,MAAM,QAAQ;AACzE,QAAM,WAAY,UAAqB,KAAI;AAE3C,QAAM,SAAS,MAAM,WAAW;IAC9B;IACA;IACA;IACA,IAAI;IACJ;IACA,SAAS,QAAQ;IACjB,OAAO,QAAQ;IACf,OAAO,UAAQ;AACb,UAAI,SAAS,WAAW,GAAG;AACzB,eAAO,EAAE,eAAe,CAAA,EAAE;MAC5B;AACA,YAAM,SAAS,SAAS,KAAK,KAAI,EAAG,SAAS,IAAI,SAAS;AAC1D,eAAS,OAAO,GAAG,SAAS,KAAK,QAAQ,QAAQ,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ;;AACxE,aAAO,EAAE,eAAe,CAAC,MAAM,EAAC;IAClC;GACD;AAED,SAAO;IACL,MAAM,aAAa,OAAO,IAAI;IAC9B,UAAU,SAAS,SAAS,IAAI,WAAW;IAC3C,gBAAgB,OAAO;;AAE3B","debugId":"c1a718f6-bc42-53b0-a337-f777e26bd386"}
+{"version":3,"sources":["../../../../../../../../cli/commands/append.ts"],"sourcesContent":["/**\n * @module cli/commands/append\n *\n * Implements the pm append command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\n/** Documents the append command options payload exchanged by command, SDK, and package integrations. */\nexport interface AppendCommandOptions {\n  /** Value that configures or reports body for this contract. */\n  body: string;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the append result payload exchanged by command, SDK, and package integrations. */\nexport interface AppendResult {\n  /** Value that configures or reports item for this contract. */\n  item: Record<string, unknown>;\n  /** Value that configures or reports appended for this contract. */\n  appended: string;\n  /** Value that configures or reports changed fields for this contract. */\n  changed_fields: string[];\n}\n\n/** Implements run append for the public runtime surface of this module. */\nexport async function runAppend(\n  id: string,\n  options: AppendCommandOptions,\n  global: GlobalOptions,\n): Promise<AppendResult> {\n  if (options.body === undefined) {\n    throw new PmCliError(\"Missing required --body text\", EXIT_CODE.USAGE);\n  }\n  const stdinResolver = createStdinTokenResolver();\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  // options.body is guaranteed defined by the guard above, so resolveValue returns a defined string.\n  const bodyInput = await stdinResolver.resolveValue(options.body, \"--body\");\n  const appended = (bodyInput as string).trim();\n  if (appended.length === 0) {\n    throw new PmCliError(\n      \"--body text cannot be empty; append requires non-blank content and empty appends would only rewrite updated_at.\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"append_empty_body\",\n        required:\n          \"Provide non-empty body text positionally, via --body, or with - for stdin.\",\n        examples: [\n          'pm append pm-a1b2 --body \"Progress note\"',\n          \"pm append pm-a1b2 --body -\",\n        ],\n      },\n    );\n  }\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"append\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      const spacer = document.body.trim().length > 0 ? \"\\n\\n\" : \"\";\n      document.body = `${document.body.replace(/\\s+$/, \"\")}${spacer}${appended}\\n`;\n      return { changedFields: [\"body\"] };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    appended,\n    changed_fields: result.changedFields,\n  };\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuCA,eAAsB,UACpB,IACA,SACA,QAAqB;AAErB,MAAI,QAAQ,SAAS,QAAW;AAC9B,UAAM,IAAI,WAAW,gCAAgC,UAAU,KAAK;EACtE;AACA,QAAM,gBAAgB,yBAAwB;AAC9C,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAI,OAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WACR,iCAAiC,MAAM,wBACvC,UAAU,SAAS;EAEvB;AACA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,SAAS,cAAc,QAAQ,QAAQ,SAAS,cAAc;AAEpE,QAAM,YAAY,MAAM,cAAc,aAAa,QAAQ,MAAM,QAAQ;AACzE,QAAM,WAAY,UAAqB,KAAI;AAC3C,MAAI,SAAS,WAAW,GAAG;AACzB,UAAM,IAAI,WACR,mHACA,UAAU,OACV;MACE,MAAM;MACN,UACE;MACF,UAAU;QACR;QACA;;KAEH;EAEL;AAEA,QAAM,SAAS,MAAM,WAAW;IAC9B;IACA;IACA;IACA,IAAI;IACJ;IACA,SAAS,QAAQ;IACjB,OAAO,QAAQ;IACf,OAAO,UAAQ;AACb,YAAM,SAAS,SAAS,KAAK,KAAI,EAAG,SAAS,IAAI,SAAS;AAC1D,eAAS,OAAO,GAAG,SAAS,KAAK,QAAQ,QAAQ,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ;;AACxE,aAAO,EAAE,eAAe,CAAC,MAAM,EAAC;IAClC;GACD;AAED,SAAO;IACL,MAAM,aAAa,OAAO,IAAI;IAC9B;IACA,gBAAgB,OAAO;;AAE3B","debugId":"7ea426c5-e4fc-52f3-bdd8-8e99c3e2a798"}

package/dist/cli-bundle/chunks/{chunk-AR24KW26.js → chunk-YBT7O4KT.js}

@@ -1,3 +1,7 @@
+import {
+  computeHistoryDiff,
+  patchPathToChangedField
+} from "./chunk-TYHJDFYW.js";
 import {
   collectRuntimeFilterValues,
   matchesRuntimeFilters,
@@ -5,28 +9,28 @@ import {
   parsePriority,
   parseType,
   runList
-} from "./chunk-YIC5NGXF.js";
+} from "./chunk-RMF7LMBS.js";
 import {
   parseLimit
-} from "./chunk-7CHWLT2J.js";
+} from "./chunk-UVN66B3M.js";
 import {
   createQueryFingerprint,
   encodeQueryCursor,
   resolveQueryCursorStart
-} from "./chunk-QYGK2XQ3.js";
+} from "./chunk-GTLCVJOE.js";
 import {
   collectBlockedByIds,
   collectDependencyBlockedIds,
   computeActionabilityReport,
   resolveItemBlockers
-} from "./chunk-W6IEJXNC.js";
+} from "./chunk-TVYYO5A7.js";
+import {
+  readHistoryEntries
+} from "./chunk-C3KD7U3T.js";
 import {
-  cloneEmptyReplayDocument,
   normalizeReplayPatchOps,
-  readHistoryEntries,
-  tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-RWAIRGBC.js";
+} from "./chunk-E6LEMURX.js";
 import {
   acquireLock,
   compareTimestampStrings,
@@ -47,7 +51,7 @@ import {
   resolveIsoOrRelative,
   runActiveOnReadHooks,
   runActiveServiceOverride
-} from "./chunk-RLLOZAM2.js";
+} from "./chunk-IY6VZ3IW.js";
 import {
   CONTEXT_DEPTH_VALUES,
   CONTEXT_SECTION_VALUES,
@@ -63,7 +67,7 @@ import {
   resolveRuntimeFieldRegistry,
   resolveRuntimeStatusRegistry,
   weekdayOrderIndex
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.js";
 
 // dist/sdk/context-usage.js
 import { randomUUID } from "node:crypto";
@@ -232,105 +236,6 @@ async function readContextUsageAffinity(options) {
   };
 }
 
-// dist/core/history/history-diff.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] = "86354a77-3238-519c-818f-c2989d885298");
-  } catch (e2) {
-  }
-})();
-function decodeJsonPointerSegment(segment) {
-  return segment.replaceAll("~1", "/").replaceAll("~0", "~");
-}
-function patchPathToChangedField(path3) {
-  if (path3 === "/body" || path3.startsWith("/body/"))
-    return "body";
-  if (path3 === "/metadata" || path3.startsWith("/metadata/") || path3 === "/front_matter" || path3.startsWith("/front_matter/")) {
-    const segment2 = path3.replace(/^\/(?:metadata|front_matter)\/?/, "").split("/")[0];
-    if (!segment2)
-      return "metadata";
-    return decodeJsonPointerSegment(segment2);
-  }
-  const segment = path3.replace(/^\//, "").split("/")[0];
-  return segment ? decodeJsonPointerSegment(segment) : "root";
-}
-function readFieldValue(doc, field) {
-  if (field === "body")
-    return doc.body;
-  if (field === "metadata")
-    return doc.metadata;
-  if (field === "root")
-    return doc;
-  return doc.metadata[field];
-}
-function computeHistoryDiff(fullEntries, options) {
-  const windowStartIndex = options?.windowStartIndex ?? 0;
-  const fieldFilter = options?.field;
-  if (fullEntries.length === 0 || windowStartIndex >= fullEntries.length) {
-    return [];
-  }
-  let current = cloneEmptyReplayDocument();
-  const result = [];
-  for (let p = 0; p < fullEntries.length; p += 1) {
-    const entry = fullEntries[p];
-    const beforeDoc = current;
-    const applied = tryApplyReplayPatch(current, entry.patch);
-    let afterDoc;
-    if (applied.ok) {
-      afterDoc = applied.document;
-      current = afterDoc;
-    } else {
-      afterDoc = beforeDoc;
-    }
-    const changedFieldSet = /* @__PURE__ */ new Set();
-    for (const patchOp of entry.patch) {
-      changedFieldSet.add(patchPathToChangedField(patchOp.path));
-      if (patchOp.from !== void 0) {
-        changedFieldSet.add(patchPathToChangedField(patchOp.from));
-      }
-    }
-    const sortedFields = [...changedFieldSet].sort((a, b) => a.localeCompare(b));
-    if (p >= windowStartIndex) {
-      if (fieldFilter !== void 0) {
-        if (!changedFieldSet.has(fieldFilter)) {
-          continue;
-        }
-        const change = {
-          field: fieldFilter,
-          before: readFieldValue(beforeDoc, fieldFilter),
-          after: readFieldValue(afterDoc, fieldFilter)
-        };
-        result.push({
-          index: p + 1,
-          ts: entry.ts,
-          op: entry.op,
-          author: entry.author,
-          patch_ops: entry.patch.length,
-          changed_fields: [fieldFilter],
-          changes: [change]
-        });
-      } else {
-        const changes = sortedFields.map((field) => ({
-          field,
-          before: readFieldValue(beforeDoc, field),
-          after: readFieldValue(afterDoc, field)
-        }));
-        result.push({
-          index: p + 1,
-          ts: entry.ts,
-          op: entry.op,
-          author: entry.author,
-          patch_ops: entry.patch.length,
-          changed_fields: sortedFields,
-          changes
-        });
-      }
-    }
-  }
-  return result;
-}
-
 // dist/cli/shared-parsers.js
 !(function() {
   try {
@@ -622,7 +527,7 @@ import { encode as encodeToon } from "@toon-format/toon";
 !(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] = "b5e68203-be1d-5e70-b080-a4e2006b8ee1");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c7eb75b9-9734-508b-a672-6350e4f87f8c");
   } catch (e2) {
   }
 })();
@@ -2040,7 +1945,7 @@ function packContextCandidates(candidates, options) {
 !(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] = "73237ae4-dd9f-5a67-9053-b2ffed05b1cf");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "3c9a4dc5-c2a6-5f6c-9dcf-979aac771091");
   } catch (e2) {
   }
 })();
@@ -3724,4 +3629,4 @@ export {
   renderNextMarkdown,
   collectStaleVectorizationIds
 };
-//# sourceMappingURL=chunk-AR24KW26.js.map
+//# sourceMappingURL=chunk-YBT7O4KT.js.map