@unbrained/pm-cli 2026.7.5 → 2026.7.6

package/dist/cli-bundle/chunks/update-many-SLLAMHT7.js.map

@@ -1 +0,0 @@
-{"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 { applyTagRemovals, mergeAdditiveTags, parseTags } from \"../../core/item/parse.js\";\nimport { resolvePriority } from \"../../core/item/priority.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport { resolveItemTypeRegistry, resolveTypeName } 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 { 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 type { ItemStatus } from \"../../types/index.js\";\nimport { hasListFilters } from \"./list-filter-shared.js\";\nimport { runList, type ListOptions, type ListedItem } 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<keyof UpdateCommandOptions>([\n  \"author\",\n  \"message\",\n  \"force\",\n  \"allowAuditUpdate\",\n  \"allowAuditDepUpdate\",\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<Record<keyof UpdateCommandOptions, string>> = {\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    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/**\n * Documents the update many command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface UpdateManyCommandOptions {\n  status?: string;\n  list: ListOptions;\n  update: UpdateCommandOptions;\n  dryRun?: boolean;\n  rollback?: string;\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}\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/**\n * Documents the update many result payload exchanged by command, SDK, and package integrations.\n */\nexport interface UpdateManyResult {\n  mode: \"dry_run\" | \"apply\" | \"rollback\";\n  matched_count: number;\n  dry_run: boolean;\n  filters?: Record<string, unknown>;\n  planned_update_options?: Record<string, unknown>;\n  item_plans?: PlannedItemDiff[];\n  checkpoint?: {\n    id: string;\n    created_at: string;\n    path: string;\n    rollback_command: string;\n  };\n  updated_count?: number;\n  skipped_count?: number;\n  failed_count?: number;\n  restored_count?: number;\n  rollback_checkpoint_id?: string;\n  rows?: UpdateManyApplyResultRow[] | UpdateManyRollbackResultRow[];\n  ids: string[];\n}\n\nfunction sanitizeUpdateOptionsForSummary(options: UpdateCommandOptions): Record<string, unknown> {\n  const summary: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(options) as Array<[keyof UpdateCommandOptions, unknown]>) {\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\nfunction hasAnyUpdateMutationInput(options: UpdateCommandOptions): boolean {\n  return Object.keys(sanitizeUpdateOptionsForSummary(options)).length > 0;\n}\n\nfunction toComparablePreviewValue(optionKey: keyof UpdateCommandOptions, value: unknown): unknown {\n  if (value === undefined) {\n    return undefined;\n  }\n  if (optionKey === \"priority\") {\n    const parsed = Number(String(value).trim());\n    return Number.isInteger(parsed) ? parsed : String(value).trim();\n  }\n  if (optionKey === \"estimatedMinutes\" || optionKey === \"order\" || optionKey === \"rank\") {\n    const parsed = Number(String(value).trim());\n    return Number.isFinite(parsed) ? parsed : String(value).trim();\n  }\n  if (optionKey === \"regression\") {\n    const normalized = String(value).trim().toLowerCase();\n    if (normalized === \"true\" || normalized === \"1\") {\n      return true;\n    }\n    if (normalized === \"false\" || normalized === \"0\") {\n      return false;\n    }\n  }\n  if (typeof value === \"string\") {\n    return value.trim();\n  }\n  return value;\n}\n\nfunction normalizeUnsetField(rawField: string): string {\n  const normalized = rawField.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  return UNSET_FIELD_ALIASES[normalized] ?? normalized;\n}\n\nfunction areValuesEqual(left: unknown, right: unknown): boolean {\n  return stableValueEquals(left, right);\n}\n\nfunction normalizeCollectionBeforeValue(field: string, value: unknown): unknown {\n  if (value !== undefined) {\n    return value;\n  }\n  if (field === \"type_options\") {\n    return {};\n  }\n  return [];\n}\n\nfunction 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\nfunction buildCollectionMutationPlans(row: Record<string, unknown>, update: UpdateCommandOptions): PlannedChange[] {\n  const changes: PlannedChange[] = [];\n  for (const definition of COLLECTION_MUTATION_PLAN_DEFINITIONS) {\n    const addValues = update[definition.addKey];\n    const removeValues = definition.removeKey ? update[definition.removeKey] : undefined;\n    const addCount = Array.isArray(addValues) ? addValues.length : 0;\n    const removeCount = Array.isArray(removeValues) ? removeValues.length : 0;\n    const clear = update[definition.clearKey] === true;\n    const replace = definition.replaceKey ? update[definition.replaceKey] === true : false;\n    if (!clear && !replace && addCount === 0 && removeCount === 0) {\n      continue;\n    }\n\n    const before = normalizeCollectionBeforeValue(definition.field, row[definition.field]);\n    const beforeCount = collectionValueCount(definition.field, before);\n    const operation = replace ? \"replace\" : clear ? \"clear_or_reset\" : removeCount > 0 ? \"merge_remove\" : \"append\";\n    changes.push({\n      field: definition.field,\n      before,\n      after: {\n        operation,\n        clear,\n        replace,\n        add_count: addCount,\n        remove_count: removeCount,\n        before_count: beforeCount,\n      },\n    });\n  }\n  return changes;\n}\n\nfunction 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).\nfunction buildTagMutationPlan(row: Record<string, unknown>, update: UpdateCommandOptions): PlannedChange | undefined {\n  const hasReplace = update.tags !== undefined;\n  const hasAdd = Array.isArray(update.addTags) && update.addTags.length > 0;\n  const hasRemove = Array.isArray(update.removeTags) && update.removeTags.length > 0;\n  if (!hasReplace && !hasAdd && !hasRemove) {\n    return undefined;\n  }\n  const existing = normalizeExistingTags(row.tags);\n  const baseTags = hasReplace ? parseTags(update.tags as string) : existing;\n  const withAdditions = mergeAdditiveTags(baseTags, update.addTags);\n  const after = applyTagRemovals(withAdditions, update.removeTags).slice().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\nfunction buildPlannedItemDiff(\n  item: ListedItem,\n  update: UpdateCommandOptions = {},\n  runtimeFieldRegistry: RuntimeFieldRegistry,\n): PlannedItemDiff {\n  const safeUpdate = update;\n  const row = toItemRecord(item);\n  const changes: PlannedChange[] = [];\n  const tagPlan = buildTagMutationPlan(row, safeUpdate);\n  if (tagPlan) {\n    changes.push(tagPlan);\n  }\n  for (const [optionKey, itemKey] of Object.entries(UPDATE_OPTION_TO_ITEM_KEY) as Array<[keyof UpdateCommandOptions, string]>) {\n    const candidate = safeUpdate[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      continue;\n    }\n    changes.push({\n      field: itemKey,\n      before,\n      after,\n    });\n  }\n  changes.push(...buildCollectionMutationPlans(row, safeUpdate));\n\n  const runtimeFieldUpdates = collectRuntimeUpdateFieldValues(\n    safeUpdate as Record<string, unknown>,\n    runtimeFieldRegistry,\n    [\"update_many\"],\n  );\n  for (const [fieldKey, fieldValue] of Object.entries(runtimeFieldUpdates)) {\n    const before = row[fieldKey];\n    if (areValuesEqual(before, fieldValue)) {\n      continue;\n    }\n    changes.push({\n      field: fieldKey,\n      before,\n      after: fieldValue,\n    });\n  }\n\n  if (safeUpdate.unset && safeUpdate.unset.length > 0) {\n    for (const rawUnsetField of safeUpdate.unset) {\n      const field = normalizeUnsetField(rawUnsetField);\n      const before = row[field];\n      if (before === undefined) {\n        continue;\n      }\n      changes.push({\n        field,\n        before,\n        after: null,\n      });\n    }\n  }\n\n  return {\n    id: item.id,\n    changes,\n  };\n}\n\nfunction normalizeStatusFilter(value: string | undefined, statusRegistry: RuntimeStatusRegistry): 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((definition) => definition.id);\n    throw new PmCliError(\n      `Invalid --filter-status value \"${value}\". Allowed: ${allowedStatuses.join(\", \")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return normalized;\n}\n\nfunction rejectBlankIdsFilter(list: ListOptions | undefined): void {\n  if (list?.ids != null && String(list.ids).trim().length === 0) {\n    throw new PmCliError(\"--ids requires at least one non-empty item ID\", EXIT_CODE.USAGE);\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.\nfunction assertPlannedUpdateValuesValid(\n  update: UpdateCommandOptions,\n  settings: PmSettings,\n  statusRegistry: RuntimeStatusRegistry,\n  pmRoot: string,\n): void {\n  if (update.priority !== undefined) {\n    resolvePriority(update.priority);\n  }\n  if (update.type !== undefined) {\n    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n    if (!resolveTypeName(update.type, typeRegistry)) {\n      throw new PmCliError(\n        buildInvalidTypeError(update.type, typeRegistry.types, resolveItemTypesFilePath(pmRoot, settings.schema)),\n        EXIT_CODE.USAGE,\n      );\n    }\n  }\n  if (update.status !== undefined && !normalizeStatusInput(update.status, statusRegistry)) {\n    const allowedStatuses = statusRegistry.definitions.map((definition) => definition.id);\n    throw new PmCliError(\n      `Invalid --status value \"${update.status}\". Allowed: ${allowedStatuses.join(\", \")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (update.deadline !== undefined) {\n    resolveIsoOrRelative(update.deadline, new Date(), \"deadline\");\n  }\n}\n\nasync function runUpdateManyRollback(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 = params.options.update?.message ?? `Rollback update-many checkpoint ${checkpoint.id}`;\n  const rollback = await restoreCheckpointItems(checkpoint.items, (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\nasync function writeUpdateManyCheckpoint(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\n\n/**\n * Implements run update many for the public runtime surface of this module.\n */\nexport async function runUpdateMany(options: UpdateManyCommandOptions, global: GlobalOptions): Promise<UpdateManyResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const runtimeFieldRegistry = resolveRuntimeFieldRegistry(settings.schema);\n\n  const dryRun = options.dryRun === true;\n  const rollbackId = typeof options.rollback === \"string\" ? options.rollback : undefined;\n  const updateSummary = sanitizeUpdateOptionsForSummary(options.update);\n  rejectBlankIdsFilter(options.list);\n\n  if (rollbackId) {\n    if (dryRun) {\n      throw new PmCliError(\"--dry-run cannot be combined with --rollback\", EXIT_CODE.USAGE);\n    }\n    if (hasListFilters(options.list, options.status)) {\n      throw new PmCliError(\"Rollback mode does not accept filter options\", EXIT_CODE.USAGE);\n    }\n    if (Object.keys(updateSummary).length > 0) {\n      throw new PmCliError(\"Rollback mode does not accept update mutation flags\", EXIT_CODE.USAGE);\n    }\n    return runUpdateManyRollback({ pmRoot, rollbackId, options, global });\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\n  // GH-256: validate planned scalar values before listing/checkpointing so\n  // dry-run previews and apply both reject globally-invalid enum/format input.\n  assertPlannedUpdateValuesValid(options.update, settings, statusRegistry, pmRoot);\n\n  const statusFilter = normalizeStatusFilter(options.status, statusRegistry);\n  const listed = await runList(statusFilter, { ...options.list, includeBody: true }, global);\n  const planned = listed.items.map((item) => buildPlannedItemDiff(item, options.update, runtimeFieldRegistry));\n  const actionable = planned.filter((row) => row.changes.length > 0);\n  if (dryRun) {\n    return {\n      mode: \"dry_run\",\n      matched_count: listed.items.length,\n      dry_run: true,\n      filters: listed.filters,\n      planned_update_options: updateSummary,\n      item_plans: planned,\n      ids: [],\n    };\n  }\n\n  if (actionable.length === 0) {\n    return {\n      mode: \"apply\",\n      matched_count: listed.items.length,\n      dry_run: false,\n      filters: listed.filters,\n      planned_update_options: updateSummary,\n      updated_count: 0,\n      skipped_count: listed.items.length,\n      failed_count: 0,\n      rows: planned.map((row) => ({\n        id: row.id,\n        status: \"skipped\" as const,\n      })),\n      ids: [],\n    };\n  }\n\n  const nowValue = nowIso();\n  const checkpointId = createCheckpointId(UPDATE_MANY_CHECKPOINT_SUBDIR, nowValue);\n  const checkpointEnabled = options.checkpoint !== false;\n  const checkpointItems: MutationCheckpointItem[] = listed.items\n    .filter((item) => actionable.some((candidate) => candidate.id === item.id))\n    .map((item) => ({\n      id: item.id,\n      target_updated_at: item.updated_at,\n    }));\n\n  let checkpointInfo: UpdateManyResult[\"checkpoint\"] | undefined;\n  if (checkpointEnabled) {\n    checkpointInfo = await writeUpdateManyCheckpoint({\n      pmRoot,\n      checkpointId,\n      nowValue,\n      options,\n      statusFilter,\n      filters: listed.filters,\n      updateSummary,\n      checkpointItems,\n    });\n  }\n\n  const applyRows: UpdateManyApplyResultRow[] = [];\n  const updatedIds: string[] = [];\n  const updateMessage = options.update.message ?? `update-many apply ${checkpointId}`;\n  const actionableById = new Set(actionable.map((row) => row.id));\n  for (const item of listed.items) {\n    if (!actionableById.has(item.id)) {\n      applyRows.push({ id: item.id, status: \"skipped\" });\n      continue;\n    }\n    try {\n      const result = await runUpdate(\n        item.id,\n        {\n          ...options.update,\n          message: updateMessage,\n          runtimeFieldCommands: [\"update_many\"],\n        },\n        global,\n      );\n      applyRows.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      applyRows.push({\n        id: item.id,\n        status: \"failed\",\n        error: toErrorMessage(error),\n      });\n    }\n  }\n\n  const updatedCount = applyRows.filter((row) => row.status === \"updated\").length;\n  const skippedCount = applyRows.filter((row) => row.status === \"skipped\").length;\n  const failedCount = applyRows.filter((row) => row.status === \"failed\").length;\n\n  return {\n    mode: \"apply\",\n    matched_count: listed.items.length,\n    dry_run: false,\n    filters: listed.filters,\n    planned_update_options: updateSummary,\n    ...(checkpointInfo ? { checkpoint: checkpointInfo } : {}),\n    updated_count: updatedCount,\n    skipped_count: skippedCount,\n    failed_count: failedCount,\n    rows: applyRows,\n    ids: updatedIds,\n  };\n}\n\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"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,IAAM,wCAAwC;AAC9C,IAAM,gCAAgC;AAEtC,IAAM,kCAAkC,oBAAI,IAAgC;EAC1E;EACA;EACA;EACA;EACA;CACD;AAED,IAAM,qCAAqC;EACzC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,KAAK,IAAI;AAEX,IAAM,4BAAiF;EACrF,OAAO;EACP,aAAa;EACb,MAAM;EACN,QAAQ;EACR,aAAa;EACb,UAAU;EACV,MAAM;EACN,UAAU;EACV,kBAAkB;EAClB,oBAAoB;EACpB,mBAAmB;EACnB,OAAO;EACP,MAAM;EACN,WAAW;EACX,OAAO;EACP,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,UAAU;EACV,QAAQ;EACR,UAAU;EACV,MAAM;EACN,YAAY;EACZ,QAAQ;EACR,SAAS;EACT,WAAW;EACX,eAAe;EACf,aAAa;EACb,UAAU;EACV,UAAU;EACV,aAAa;EACb,YAAY;EACZ,YAAY;EACZ,gBAAgB;EAChB,cAAc;EACd,iBAAiB;EACjB,cAAc;EACd,WAAW;EACX,YAAY;EACZ,gBAAgB;;AAWlB,IAAM,uCAA2E;EAC/E;IACE,OAAO;IACP,QAAQ;IACR,WAAW;IACX,UAAU;IACV,YAAY;;EAEd;IACE,OAAO;IACP,QAAQ;IACR,UAAU;;EAEZ;IACE,OAAO;IACP,QAAQ;IACR,UAAU;;EAEZ;IACE,OAAO;IACP,QAAQ;IACR,UAAU;;EAEZ;IACE,OAAO;IACP,QAAQ;IACR,UAAU;;EAEZ;IACE,OAAO;IACP,QAAQ;IACR,UAAU;IACV,YAAY;;EAEd;IACE,OAAO;IACP,QAAQ;IACR,UAAU;;EAEZ;IACE,OAAO;IACP,QAAQ;IACR,UAAU;;EAEZ;IACE,OAAO;IACP,QAAQ;IACR,UAAU;;EAEZ;IACE,OAAO;IACP,QAAQ;IACR,UAAU;;;AAId,IAAM,sBAA8C;EAClD,cAAc;EACd,gBAAgB;EAChB,UAAU;EACV,UAAU;EACV,mBAAmB;EACnB,qBAAqB;EACrB,qBAAqB;EACrB,uBAAuB;EACvB,IAAI;EACJ,qBAAqB;EACrB,uBAAuB;EACvB,OAAO;EACP,MAAM;EACN,MAAM;EACN,WAAW;EACX,OAAO;EACP,QAAQ;EACR,SAAS;EACT,SAAS;EACT,WAAW;EACX,UAAU;EACV,QAAQ;EACR,UAAU;EACV,MAAM;EACN,YAAY;EACZ,QAAQ;EACR,SAAS;EACT,YAAY;EACZ,cAAc;EACd,gBAAgB;EAChB,kBAAkB;EAClB,cAAc;EACd,gBAAgB;EAChB,UAAU;EACV,UAAU;EACV,aAAa;EACb,aAAa;EACb,eAAe;EACf,YAAY;EACZ,iBAAiB;EACjB,mBAAmB;EACnB,eAAe;EACf,iBAAiB;EACjB,kBAAkB;EAClB,oBAAoB;EACpB,eAAe;EACf,iBAAiB;EACjB,WAAW;EACX,YAAY;EACZ,iBAAiB;EACjB,mBAAmB;EACnB,cAAc;EACd,gBAAgB;EAChB,MAAM;;AA8ER,SAAS,gCAAgC,SAA6B;AACpE,QAAM,UAAmC,CAAA;AACzC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,OAAO,GAAmD;AAClG,QAAI,gCAAgC,IAAI,GAAG,GAAG;AAC5C;IACF;AACA,QAAI,UAAU,QAAW;AACvB;IACF;AACA,YAAQ,GAAG,IAAI;EACjB;AACA,SAAO;AACT;AAEA,SAAS,0BAA0B,SAA6B;AAC9D,SAAO,OAAO,KAAK,gCAAgC,OAAO,CAAC,EAAE,SAAS;AACxE;AAEA,SAAS,yBAAyB,WAAuC,OAAc;AACrF,MAAI,UAAU,QAAW;AACvB,WAAO;EACT;AACA,MAAI,cAAc,YAAY;AAC5B,UAAM,SAAS,OAAO,OAAO,KAAK,EAAE,KAAI,CAAE;AAC1C,WAAO,OAAO,UAAU,MAAM,IAAI,SAAS,OAAO,KAAK,EAAE,KAAI;EAC/D;AACA,MAAI,cAAc,sBAAsB,cAAc,WAAW,cAAc,QAAQ;AACrF,UAAM,SAAS,OAAO,OAAO,KAAK,EAAE,KAAI,CAAE;AAC1C,WAAO,OAAO,SAAS,MAAM,IAAI,SAAS,OAAO,KAAK,EAAE,KAAI;EAC9D;AACA,MAAI,cAAc,cAAc;AAC9B,UAAM,aAAa,OAAO,KAAK,EAAE,KAAI,EAAG,YAAW;AACnD,QAAI,eAAe,UAAU,eAAe,KAAK;AAC/C,aAAO;IACT;AACA,QAAI,eAAe,WAAW,eAAe,KAAK;AAChD,aAAO;IACT;EACF;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,MAAM,KAAI;EACnB;AACA,SAAO;AACT;AAEA,SAAS,oBAAoB,UAAgB;AAC3C,QAAM,aAAa,SAAS,KAAI,EAAG,YAAW,EAAG,WAAW,KAAK,GAAG;AACpE,SAAO,oBAAoB,UAAU,KAAK;AAC5C;AAEA,SAAS,eAAe,MAAe,OAAc;AACnD,SAAO,kBAAkB,MAAM,KAAK;AACtC;AAEA,SAAS,+BAA+B,OAAe,OAAc;AACnE,MAAI,UAAU,QAAW;AACvB,WAAO;EACT;AACA,MAAI,UAAU,gBAAgB;AAC5B,WAAO,CAAA;EACT;AACA,SAAO,CAAA;AACT;AAEA,SAAS,qBAAqB,OAAe,OAAc;AACzD,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM;EACf;AACA,MAAI,UAAU,kBAAkB,SAAS,OAAO,UAAU,UAAU;AAClE,WAAO,OAAO,KAAK,KAAgC,EAAE;EACvD;AACA,SAAO;AACT;AAEA,SAAS,6BAA6B,KAA8B,QAA4B;AAC9F,QAAM,UAA2B,CAAA;AACjC,aAAW,cAAc,sCAAsC;AAC7D,UAAM,YAAY,OAAO,WAAW,MAAM;AAC1C,UAAM,eAAe,WAAW,YAAY,OAAO,WAAW,SAAS,IAAI;AAC3E,UAAM,WAAW,MAAM,QAAQ,SAAS,IAAI,UAAU,SAAS;AAC/D,UAAM,cAAc,MAAM,QAAQ,YAAY,IAAI,aAAa,SAAS;AACxE,UAAM,QAAQ,OAAO,WAAW,QAAQ,MAAM;AAC9C,UAAM,UAAU,WAAW,aAAa,OAAO,WAAW,UAAU,MAAM,OAAO;AACjF,QAAI,CAAC,SAAS,CAAC,WAAW,aAAa,KAAK,gBAAgB,GAAG;AAC7D;IACF;AAEA,UAAM,SAAS,+BAA+B,WAAW,OAAO,IAAI,WAAW,KAAK,CAAC;AACrF,UAAM,cAAc,qBAAqB,WAAW,OAAO,MAAM;AACjE,UAAM,YAAY,UAAU,YAAY,QAAQ,mBAAmB,cAAc,IAAI,iBAAiB;AACtG,YAAQ,KAAK;MACX,OAAO,WAAW;MAClB;MACA,OAAO;QACL;QACA;QACA;QACA,WAAW;QACX,cAAc;QACd,cAAc;;KAEjB;EACH;AACA,SAAO;AACT;AAEA,SAAS,sBAAsB,OAAc;AAC3C,MAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;AACzB,WAAO,CAAA;EACT;AACA,SAAO,MAAM,OAAO,CAAC,QAAuB,OAAO,QAAQ,QAAQ;AACrE;AAOA,SAAS,qBAAqB,KAA8B,QAA4B;AACtF,QAAM,aAAa,OAAO,SAAS;AACnC,QAAM,SAAS,MAAM,QAAQ,OAAO,OAAO,KAAK,OAAO,QAAQ,SAAS;AACxE,QAAM,YAAY,MAAM,QAAQ,OAAO,UAAU,KAAK,OAAO,WAAW,SAAS;AACjF,MAAI,CAAC,cAAc,CAAC,UAAU,CAAC,WAAW;AACxC,WAAO;EACT;AACA,QAAM,WAAW,sBAAsB,IAAI,IAAI;AAC/C,QAAM,WAAW,aAAa,UAAU,OAAO,IAAc,IAAI;AACjE,QAAM,gBAAgB,kBAAkB,UAAU,OAAO,OAAO;AAChE,QAAM,QAAQ,iBAAiB,eAAe,OAAO,UAAU,EAAE,MAAK,EAAG,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAC1G,QAAM,SAAS,SAAS,MAAK,EAAG,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AACjE,MAAI,eAAe,QAAQ,KAAK,GAAG;AACjC,WAAO;EACT;AACA,SAAO,EAAE,OAAO,QAAQ,QAAQ,UAAU,MAAK;AACjD;AAEA,SAAS,qBACP,MACA,SAA+B,CAAA,GAC/B,sBAA0C;AAE1C,QAAM,aAAa;AACnB,QAAM,MAAM,aAAa,IAAI;AAC7B,QAAM,UAA2B,CAAA;AACjC,QAAM,UAAU,qBAAqB,KAAK,UAAU;AACpD,MAAI,SAAS;AACX,YAAQ,KAAK,OAAO;EACtB;AACA,aAAW,CAAC,WAAW,OAAO,KAAK,OAAO,QAAQ,yBAAyB,GAAkD;AAC3H,UAAM,YAAY,WAAW,SAAS;AACtC,QAAI,cAAc,QAAW;AAC3B;IACF;AACA,UAAM,SAAS,IAAI,OAAO;AAC1B,UAAM,QAAQ,yBAAyB,WAAW,SAAS;AAC3D,QAAI,eAAe,QAAQ,KAAK,GAAG;AACjC;IACF;AACA,YAAQ,KAAK;MACX,OAAO;MACP;MACA;KACD;EACH;AACA,UAAQ,KAAK,GAAG,6BAA6B,KAAK,UAAU,CAAC;AAE7D,QAAM,sBAAsB,gCAC1B,YACA,sBACA,CAAC,aAAa,CAAC;AAEjB,aAAW,CAAC,UAAU,UAAU,KAAK,OAAO,QAAQ,mBAAmB,GAAG;AACxE,UAAM,SAAS,IAAI,QAAQ;AAC3B,QAAI,eAAe,QAAQ,UAAU,GAAG;AACtC;IACF;AACA,YAAQ,KAAK;MACX,OAAO;MACP;MACA,OAAO;KACR;EACH;AAEA,MAAI,WAAW,SAAS,WAAW,MAAM,SAAS,GAAG;AACnD,eAAW,iBAAiB,WAAW,OAAO;AAC5C,YAAM,QAAQ,oBAAoB,aAAa;AAC/C,YAAM,SAAS,IAAI,KAAK;AACxB,UAAI,WAAW,QAAW;AACxB;MACF;AACA,cAAQ,KAAK;QACX;QACA;QACA,OAAO;OACR;IACH;EACF;AAEA,SAAO;IACL,IAAI,KAAK;IACT;;AAEJ;AAEA,SAAS,sBAAsB,OAA2B,gBAAqC;AAC7F,MAAI,UAAU,QAAW;AACvB,WAAO;EACT;AACA,QAAM,aAAa,qBAAqB,OAAO,cAAc;AAC7D,MAAI,CAAC,YAAY;AACf,UAAM,kBAAkB,eAAe,YAAY,IAAI,CAAC,eAAe,WAAW,EAAE;AACpF,UAAM,IAAI,WACR,kCAAkC,KAAK,eAAe,gBAAgB,KAAK,IAAI,CAAC,IAChF,UAAU,KAAK;EAEnB;AACA,SAAO;AACT;AAEA,SAAS,qBAAqB,MAA6B;AACzD,MAAI,MAAM,OAAO,QAAQ,OAAO,KAAK,GAAG,EAAE,KAAI,EAAG,WAAW,GAAG;AAC7D,UAAM,IAAI,WAAW,iDAAiD,UAAU,KAAK;EACvF;AACF;AAWA,SAAS,+BACP,QACA,UACA,gBACA,QAAc;AAEd,MAAI,OAAO,aAAa,QAAW;AACjC,oBAAgB,OAAO,QAAQ;EACjC;AACA,MAAI,OAAO,SAAS,QAAW;AAC7B,UAAM,eAAe,wBAAwB,UAAU,gCAA+B,CAAE;AACxF,QAAI,CAAC,gBAAgB,OAAO,MAAM,YAAY,GAAG;AAC/C,YAAM,IAAI,WACR,sBAAsB,OAAO,MAAM,aAAa,OAAO,yBAAyB,QAAQ,SAAS,MAAM,CAAC,GACxG,UAAU,KAAK;IAEnB;EACF;AACA,MAAI,OAAO,WAAW,UAAa,CAAC,qBAAqB,OAAO,QAAQ,cAAc,GAAG;AACvF,UAAM,kBAAkB,eAAe,YAAY,IAAI,CAAC,eAAe,WAAW,EAAE;AACpF,UAAM,IAAI,WACR,2BAA2B,OAAO,MAAM,eAAe,gBAAgB,KAAK,IAAI,CAAC,IACjF,UAAU,KAAK;EAEnB;AACA,MAAI,OAAO,aAAa,QAAW;AACjC,yBAAqB,OAAO,UAAU,oBAAI,KAAI,GAAI,UAAU;EAC9D;AACF;AAEA,eAAe,sBAAsB,QAKpC;AACC,QAAM,aAAa,MAAM,uBACvB,OAAO,QACP,+BACA,OAAO,YACP,qCAAqC;AAEvC,QAAM,iBAAiB,OAAO,QAAQ,QAAQ,WAAW,mCAAmC,WAAW,EAAE;AACzG,QAAM,WAAW,MAAM,uBAAuB,WAAW,OAAO,CAAC,IAAI,oBACnE,WACE,IACA,iBACA;IACE,QAAQ,OAAO,QAAQ,QAAQ;IAC/B,SAAS;IACT,OAAO,OAAO,QAAQ,QAAQ,SAAS;KAEzC,OAAO,MAAM,CACd;AAEH,SAAO;IACL,MAAM;IACN,eAAe,WAAW,MAAM;IAChC,SAAS;IACT,wBAAwB,WAAW;IACnC,YAAY;MACV,IAAI,WAAW;MACf,YAAY,WAAW;MACvB,MAAM,WAAW;MACjB,kBAAkB,6BAA6B,WAAW,EAAE;;IAE9D,gBAAgB,SAAS,aAAa;IACtC,cAAc,SAAS;IACvB,MAAM,SAAS;IACf,KAAK,SAAS;;AAElB;AAEA,eAAe,0BAA0B,QASxC;AACC,QAAM,oBAA0C;IAC9C,gBAAgB;IAChB,IAAI,OAAO;IACX,YAAY,OAAO;IACnB,QAAQ,cAAc,OAAO,QAAQ,QAAQ,QAAQ,SAAS;IAC9D,eAAe,OAAO,gBAAgB;IACtC,cAAc,OAAO;IACrB,gBAAgB,OAAO;IACvB,OAAO,OAAO;;AAEhB,QAAM,iBAAiB,MAAM,wBAC3B,OAAO,QACP,+BACA,OAAO,cACP,iBAAiB;AAEnB,SAAO;IACL,IAAI,OAAO;IACX,YAAY,OAAO;IACnB,MAAM;IACN,kBAAkB,6BAA6B,OAAO,YAAY;;AAEtE;AAMA,eAAsB,cAAc,SAAmC,QAAqB;AAC1F,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAI,OAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WAAW,iCAAiC,MAAM,wBAAwB,UAAU,SAAS;EACzG;AACA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,iBAAiB,6BAA6B,SAAS,MAAM;AACnE,QAAM,uBAAuB,4BAA4B,SAAS,MAAM;AAExE,QAAM,SAAS,QAAQ,WAAW;AAClC,QAAM,aAAa,OAAO,QAAQ,aAAa,WAAW,QAAQ,WAAW;AAC7E,QAAM,gBAAgB,gCAAgC,QAAQ,MAAM;AACpE,uBAAqB,QAAQ,IAAI;AAEjC,MAAI,YAAY;AACd,QAAI,QAAQ;AACV,YAAM,IAAI,WAAW,gDAAgD,UAAU,KAAK;IACtF;AACA,QAAI,eAAe,QAAQ,MAAM,QAAQ,MAAM,GAAG;AAChD,YAAM,IAAI,WAAW,gDAAgD,UAAU,KAAK;IACtF;AACA,QAAI,OAAO,KAAK,aAAa,EAAE,SAAS,GAAG;AACzC,YAAM,IAAI,WAAW,uDAAuD,UAAU,KAAK;IAC7F;AACA,WAAO,sBAAsB,EAAE,QAAQ,YAAY,SAAS,OAAM,CAAE;EACtE;AAEA,MAAI,CAAC,0BAA0B,QAAQ,MAAM,GAAG;AAC9C,UAAM,IAAI,WACR,wFAAwF,kCAAkC,MAC1H,UAAU,KAAK;EAEnB;AAIA,iCAA+B,QAAQ,QAAQ,UAAU,gBAAgB,MAAM;AAE/E,QAAM,eAAe,sBAAsB,QAAQ,QAAQ,cAAc;AACzE,QAAM,SAAS,MAAM,QAAQ,cAAc,EAAE,GAAG,QAAQ,MAAM,aAAa,KAAI,GAAI,MAAM;AACzF,QAAM,UAAU,OAAO,MAAM,IAAI,CAAC,SAAS,qBAAqB,MAAM,QAAQ,QAAQ,oBAAoB,CAAC;AAC3G,QAAM,aAAa,QAAQ,OAAO,CAAC,QAAQ,IAAI,QAAQ,SAAS,CAAC;AACjE,MAAI,QAAQ;AACV,WAAO;MACL,MAAM;MACN,eAAe,OAAO,MAAM;MAC5B,SAAS;MACT,SAAS,OAAO;MAChB,wBAAwB;MACxB,YAAY;MACZ,KAAK,CAAA;;EAET;AAEA,MAAI,WAAW,WAAW,GAAG;AAC3B,WAAO;MACL,MAAM;MACN,eAAe,OAAO,MAAM;MAC5B,SAAS;MACT,SAAS,OAAO;MAChB,wBAAwB;MACxB,eAAe;MACf,eAAe,OAAO,MAAM;MAC5B,cAAc;MACd,MAAM,QAAQ,IAAI,CAAC,SAAS;QAC1B,IAAI,IAAI;QACR,QAAQ;QACR;MACF,KAAK,CAAA;;EAET;AAEA,QAAM,WAAW,OAAM;AACvB,QAAM,eAAe,mBAAmB,+BAA+B,QAAQ;AAC/E,QAAM,oBAAoB,QAAQ,eAAe;AACjD,QAAM,kBAA4C,OAAO,MACtD,OAAO,CAAC,SAAS,WAAW,KAAK,CAAC,cAAc,UAAU,OAAO,KAAK,EAAE,CAAC,EACzE,IAAI,CAAC,UAAU;IACd,IAAI,KAAK;IACT,mBAAmB,KAAK;IACxB;AAEJ,MAAI;AACJ,MAAI,mBAAmB;AACrB,qBAAiB,MAAM,0BAA0B;MAC/C;MACA;MACA;MACA;MACA;MACA,SAAS,OAAO;MAChB;MACA;KACD;EACH;AAEA,QAAM,YAAwC,CAAA;AAC9C,QAAM,aAAuB,CAAA;AAC7B,QAAM,gBAAgB,QAAQ,OAAO,WAAW,qBAAqB,YAAY;AACjF,QAAM,iBAAiB,IAAI,IAAI,WAAW,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;AAC9D,aAAW,QAAQ,OAAO,OAAO;AAC/B,QAAI,CAAC,eAAe,IAAI,KAAK,EAAE,GAAG;AAChC,gBAAU,KAAK,EAAE,IAAI,KAAK,IAAI,QAAQ,UAAS,CAAE;AACjD;IACF;AACA,QAAI;AACF,YAAM,SAAS,MAAM,UACnB,KAAK,IACL;QACE,GAAG,QAAQ;QACX,SAAS;QACT,sBAAsB,CAAC,aAAa;SAEtC,MAAM;AAER,gBAAU,KAAK;QACb,IAAI,KAAK;QACT,QAAQ;QACR,gBAAgB,OAAO;QACvB,UAAU,OAAO;OAClB;AACD,iBAAW,KAAK,KAAK,EAAE;IACzB,SAAS,OAAgB;AACvB,gBAAU,KAAK;QACb,IAAI,KAAK;QACT,QAAQ;QACR,OAAO,eAAe,KAAK;OAC5B;IACH;EACF;AAEA,QAAM,eAAe,UAAU,OAAO,CAAC,QAAQ,IAAI,WAAW,SAAS,EAAE;AACzE,QAAM,eAAe,UAAU,OAAO,CAAC,QAAQ,IAAI,WAAW,SAAS,EAAE;AACzE,QAAM,cAAc,UAAU,OAAO,CAAC,QAAQ,IAAI,WAAW,QAAQ,EAAE;AAEvE,SAAO;IACL,MAAM;IACN,eAAe,OAAO,MAAM;IAC5B,SAAS;IACT,SAAS,OAAO;IAChB,wBAAwB;IACxB,GAAI,iBAAiB,EAAE,YAAY,eAAc,IAAK,CAAA;IACtD,eAAe;IACf,eAAe;IACf,cAAc;IACd,MAAM;IACN,KAAK;;AAET;AAEO,IAAM,6BAA6B;EACxC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA","debugId":"8a0b9207-5e52-5d31-862d-6fdfe949505a"}

package/dist/cli-bundle/chunks/upgrade-HFFXLZJA.js

@@ -1,290 +0,0 @@
-import {
-  readManagedExtensionState,
-  runExtension
-} from "./chunk-GIWXVMZ3.js";
-import "./chunk-KDZ6K25I.js";
-import "./chunk-ZVDL32GJ.js";
-import "./chunk-E2FUG6GD.js";
-import "./chunk-5HIZDR5A.js";
-import "./chunk-R3ZBLGTC.js";
-import "./chunk-UI5BJ6DO.js";
-import "./chunk-C3PMDWGX.js";
-import "./chunk-4QQ6PM7M.js";
-import "./chunk-3U3VEWK6.js";
-import "./chunk-Y76TWC45.js";
-import "./chunk-EZFKWSC7.js";
-import "./chunk-DRBV5UC2.js";
-import {
-  PmCliError
-} from "./chunk-P5YORJRH.js";
-import "./chunk-T35XLYZF.js";
-import "./chunk-7C2O74AE.js";
-import {
-  EXIT_CODE,
-  pathExists,
-  resolveExtensionRoots,
-  resolvePmCliVersion,
-  resolvePmRoot
-} from "./chunk-5VVUKE3U.js";
-
-// dist/cli/commands/upgrade.js
-import { execFile } from "node:child_process";
-import path from "node:path";
-import { promisify } from "node:util";
-!(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] = "23e180a8-5d22-5a29-9970-219fbdc3d967");
-  } catch (e2) {
-  }
-})();
-var execFileAsync = promisify(execFile);
-var DEFAULT_CLI_PACKAGE = "@unbrained/pm-cli";
-var DEFAULT_TAG = "latest";
-var _testOnly = {
-  defaultCommandRunner,
-  isLocalNpmSpec,
-  normalizeTarget,
-  packageRecordMatchesTarget,
-  resolveCliPackage,
-  resolvePackageInstallSource,
-  resolveRunnablePackageSource,
-  resolveScope,
-  resolveTag,
-  packageCommandFor,
-  summarize
-};
-function resolveScope(options) {
-  const projectLike = options.project === true || options.local === true;
-  const global2 = options.global === true;
-  if (projectLike && global2) {
-    throw new PmCliError('Options "--project/--local" and "--global" are mutually exclusive.', EXIT_CODE.USAGE);
-  }
-  return global2 ? "global" : "project";
-}
-function normalizeTarget(value) {
-  return value.trim().toLowerCase();
-}
-function packageRecordMatchesTarget(record, target) {
-  const normalizedTarget = normalizeTarget(target);
-  const values = [
-    record.name,
-    record.directory,
-    record.source.input,
-    record.source.location,
-    record.source.package,
-    record.source.repository,
-    record.source.owner && record.source.repo ? `${record.source.owner}/${record.source.repo}` : void 0
-  ];
-  return values.some((value) => typeof value === "string" && normalizeTarget(value) === normalizedTarget);
-}
-function resolveRoots(scope, global2) {
-  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
-  const roots = resolveExtensionRoots(pmRoot, process.cwd());
-  return {
-    selected_root: scope === "global" ? roots.global : roots.project
-  };
-}
-async function defaultCommandRunner(command, args, options) {
-  try {
-    const result = await execFileAsync(command, args, {
-      cwd: options?.cwd,
-      encoding: "utf8"
-    });
-    return {
-      stdout: result.stdout,
-      stderr: result.stderr
-    };
-  } catch (error) {
-    const stderr = typeof error === "object" && error !== null && "stderr" in error ? String(error.stderr ?? "") : "";
-    const message = stderr.trim().length > 0 ? stderr.trim() : error instanceof Error ? error.message : String(error);
-    throw new PmCliError(`Command failed: ${command} ${args.join(" ")}
-${message}`, EXIT_CODE.GENERIC_FAILURE);
-  }
-}
-async function readCurrentVersion() {
-  return resolvePmCliVersion(import.meta.url, ["../../.."]);
-}
-function resolveTag(options) {
-  return typeof options.tag === "string" && options.tag.trim().length > 0 ? options.tag.trim() : DEFAULT_TAG;
-}
-function resolveCliPackage(options) {
-  return typeof options.packageName === "string" && options.packageName.trim().length > 0 ? options.packageName.trim() : DEFAULT_CLI_PACKAGE;
-}
-async function upgradeCli(options, dryRun) {
-  const runner = options.commandRunner ?? defaultCommandRunner;
-  const packageName = resolveCliPackage(options);
-  const tag = resolveTag(options);
-  const target = `${packageName}@${tag}`;
-  const command = ["npm", "install", "-g", target];
-  if (options.repair === true) {
-    command.push("--force");
-  }
-  const beforeVersion = await readCurrentVersion();
-  const planned = {
-    requested: true,
-    status: "planned",
-    package: packageName,
-    target,
-    command,
-    before_version: beforeVersion,
-    repair: options.repair === true
-  };
-  if (dryRun) {
-    return planned;
-  }
-  try {
-    await runner(command[0], command.slice(1));
-    const verified = await runner("pm", ["--version"]);
-    return {
-      ...planned,
-      status: "updated",
-      after_version: verified.stdout.trim() || void 0
-    };
-  } catch (error) {
-    return {
-      ...planned,
-      status: "failed",
-      error: error instanceof Error ? error.message : String(error)
-    };
-  }
-}
-function isLocalNpmSpec(spec) {
-  return path.isAbsolute(spec) || spec.startsWith(".") || spec.startsWith("..") || spec.startsWith("file:");
-}
-function resolvePackageInstallSource(source, tag) {
-  if (source.kind === "npm") {
-    const rawSpec = source.input.startsWith("npm:") ? source.input.slice("npm:".length).trim() : source.input.trim();
-    if (!isLocalNpmSpec(rawSpec) && source.package && source.package.trim().length > 0) {
-      return `npm:${source.package.trim()}@${tag}`;
-    }
-    return source.input.startsWith("npm:") ? source.input : `npm:${source.input}`;
-  }
-  return source.input;
-}
-async function resolveRunnablePackageSource(source, tag) {
-  const installSource = resolvePackageInstallSource(source, tag);
-  if (source.kind !== "local") {
-    return installSource;
-  }
-  if (await pathExists(installSource)) {
-    return installSource;
-  }
-  if (await pathExists(source.location)) {
-    return source.location;
-  }
-  return installSource;
-}
-function packageCommandFor(source, installSource, scope, ref) {
-  const command = ["pm", "install", installSource, scope === "global" ? "--global" : "--project"];
-  if (source.kind === "github" && ref && ref.trim().length > 0) {
-    command.push("--ref", ref.trim());
-  }
-  return command;
-}
-async function readManagedRecords(scope, global2) {
-  const roots = resolveRoots(scope, global2);
-  const managedState = await readManagedExtensionState(roots.selected_root);
-  return managedState.state.entries.filter((entry) => entry.scope === scope);
-}
-async function refreshManagedRecord(scope, global2, record) {
-  const records = await readManagedRecords(scope, global2);
-  return records.find((candidate) => packageRecordMatchesTarget(candidate, record.name)) ?? records.find((candidate) => normalizeTarget(candidate.directory) === normalizeTarget(record.directory));
-}
-async function upgradePackageRecord(record, options, global2, scope, dryRun) {
-  const tag = resolveTag(options);
-  const installSource = await resolveRunnablePackageSource(record.source, tag);
-  const command = packageCommandFor(record.source, installSource, scope, record.source.ref);
-  const planned = {
-    name: record.name,
-    directory: record.directory,
-    scope,
-    source: record.source,
-    status: "planned",
-    command,
-    previous_version: record.manifest_version
-  };
-  if (dryRun) {
-    return planned;
-  }
-  try {
-    await runExtension(installSource, {
-      install: true,
-      project: scope === "project",
-      global: scope === "global",
-      ref: record.source.kind === "github" ? record.source.ref : void 0
-    }, global2);
-    const refreshed = await refreshManagedRecord(scope, global2, record);
-    return {
-      ...planned,
-      status: "updated",
-      installed_version: refreshed?.manifest_version
-    };
-  } catch (error) {
-    return {
-      ...planned,
-      status: "failed",
-      error: error instanceof Error ? error.message : String(error)
-    };
-  }
-}
-function summarize(cli, packages, includeCli, includePackages) {
-  const statuses = [includeCli ? cli.status : void 0, ...packages.map((entry) => entry.status)].filter((value) => typeof value === "string");
-  return {
-    requested_cli: includeCli,
-    requested_packages: includePackages,
-    planned: statuses.filter((status) => status === "planned").length,
-    updated: statuses.filter((status) => status === "updated").length,
-    skipped: statuses.filter((status) => status === "skipped").length,
-    failed: statuses.filter((status) => status === "failed").length
-  };
-}
-async function runUpgrade(target, options, global2) {
-  if (options.cliOnly === true && options.packagesOnly === true) {
-    throw new PmCliError('Options "--cli-only" and "--packages-only" are mutually exclusive.', EXIT_CODE.USAGE);
-  }
-  const scope = resolveScope(options);
-  const dryRun = options.dryRun === true;
-  const normalizedTarget = typeof target === "string" && target.trim().length > 0 ? target.trim() : void 0;
-  if (options.cliOnly === true && normalizedTarget) {
-    throw new PmCliError('A package target cannot be used with "--cli-only".', EXIT_CODE.USAGE);
-  }
-  const includeCli = options.packagesOnly === true || normalizedTarget ? false : true;
-  const includePackages = options.cliOnly === true ? false : true;
-  const cli = includeCli ? await upgradeCli(options, dryRun) : {
-    requested: false,
-    status: "skipped",
-    package: resolveCliPackage(options),
-    target: `${resolveCliPackage(options)}@${resolveTag(options)}`,
-    command: ["npm", "install", "-g", `${resolveCliPackage(options)}@${resolveTag(options)}`],
-    repair: options.repair === true,
-    reason: "not_requested"
-  };
-  let packageRecords = includePackages ? await readManagedRecords(scope, global2) : [];
-  if (normalizedTarget) {
-    packageRecords = packageRecords.filter((entry) => packageRecordMatchesTarget(entry, normalizedTarget));
-    if (packageRecords.length === 0) {
-      throw new PmCliError(`Managed package "${normalizedTarget}" was not found in ${scope} scope.`, EXIT_CODE.NOT_FOUND);
-    }
-  }
-  const packages = [];
-  for (const record of packageRecords) {
-    packages.push(await upgradePackageRecord(record, options, global2, scope, dryRun));
-  }
-  const summary = summarize(cli, packages, includeCli, includePackages);
-  return {
-    ok: summary.failed === 0,
-    action: "upgrade",
-    dry_run: dryRun,
-    scope,
-    target: normalizedTarget,
-    cli,
-    packages,
-    summary
-  };
-}
-export {
-  _testOnly,
-  runUpgrade
-};
-//# sourceMappingURL=upgrade-HFFXLZJA.js.map

package/dist/cli-bundle/chunks/upgrade-HFFXLZJA.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../../../../cli/commands/upgrade.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/upgrade\n *\n * Implements the pm upgrade command surface and its agent-facing runtime behavior.\n */\nimport { execFile } from \"node:child_process\";\nimport path from \"node:path\";\nimport { promisify } from \"node:util\";\nimport {\n  readManagedExtensionState,\n  runExtension,\n  type ExtensionScope,\n  type ManagedExtensionRecord,\n  type ManagedExtensionSource,\n} from \"./extension.js\";\nimport { resolveExtensionRoots } from \"../../core/extensions/loader.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolvePmRoot } from \"../../core/store/paths.js\";\nimport { resolvePmCliVersion } from \"../../core/packages/root.js\";\n\nconst execFileAsync = promisify(execFile);\nconst DEFAULT_CLI_PACKAGE = \"@unbrained/pm-cli\";\nconst DEFAULT_TAG = \"latest\";\n\n/**\n * Documents the upgrade command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface UpgradeCommandOptions {\n  dryRun?: boolean;\n  cliOnly?: boolean;\n  packagesOnly?: boolean;\n  project?: boolean;\n  local?: boolean;\n  global?: boolean;\n  repair?: boolean;\n  tag?: string;\n  packageName?: string;\n  commandRunner?: UpgradeCommandRunner;\n}\n\nexport const _testOnly = {\n  defaultCommandRunner,\n  isLocalNpmSpec,\n  normalizeTarget,\n  packageRecordMatchesTarget,\n  resolveCliPackage,\n  resolvePackageInstallSource,\n  resolveRunnablePackageSource,\n  resolveScope,\n  resolveTag,\n  packageCommandFor,\n  summarize,\n};\n\n/**\n * Documents the upgrade command runner result payload exchanged by command, SDK, and package integrations.\n */\nexport interface UpgradeCommandRunnerResult {\n  stdout: string;\n  stderr: string;\n}\n\n/**\n * Restricts upgrade command runner values accepted by command, SDK, and storage contracts.\n */\nexport type UpgradeCommandRunner = (\n  command: string,\n  args: string[],\n  options?: { cwd?: string },\n) => Promise<UpgradeCommandRunnerResult>;\n\n/**\n * Documents the upgrade cli result payload exchanged by command, SDK, and package integrations.\n */\nexport interface UpgradeCliResult {\n  requested: boolean;\n  status: \"planned\" | \"updated\" | \"failed\" | \"skipped\";\n  package: string;\n  target: string;\n  command: string[];\n  before_version?: string;\n  after_version?: string;\n  repair: boolean;\n  reason?: string;\n  error?: string;\n}\n\n/**\n * Documents the upgrade package result payload exchanged by command, SDK, and package integrations.\n */\nexport interface UpgradePackageResult {\n  name: string;\n  directory: string;\n  scope: ExtensionScope;\n  source: ManagedExtensionSource;\n  status: \"planned\" | \"updated\" | \"failed\" | \"skipped\";\n  command: string[];\n  previous_version: string;\n  installed_version?: string;\n  reason?: string;\n  error?: string;\n}\n\n/**\n * Documents the upgrade result payload exchanged by command, SDK, and package integrations.\n */\nexport interface UpgradeResult {\n  ok: boolean;\n  action: \"upgrade\";\n  dry_run: boolean;\n  scope: ExtensionScope;\n  target?: string;\n  cli: UpgradeCliResult;\n  packages: UpgradePackageResult[];\n  summary: {\n    requested_cli: boolean;\n    requested_packages: boolean;\n    planned: number;\n    updated: number;\n    skipped: number;\n    failed: number;\n  };\n}\n\nfunction resolveScope(options: UpgradeCommandOptions): ExtensionScope {\n  const projectLike = options.project === true || options.local === true;\n  const global = options.global === true;\n  if (projectLike && global) {\n    throw new PmCliError('Options \"--project/--local\" and \"--global\" are mutually exclusive.', EXIT_CODE.USAGE);\n  }\n  return global ? \"global\" : \"project\";\n}\n\nfunction normalizeTarget(value: string): string {\n  return value.trim().toLowerCase();\n}\n\nfunction packageRecordMatchesTarget(record: ManagedExtensionRecord, target: string): boolean {\n  const normalizedTarget = normalizeTarget(target);\n  const values = [\n    record.name,\n    record.directory,\n    record.source.input,\n    record.source.location,\n    record.source.package,\n    record.source.repository,\n    record.source.owner && record.source.repo ? `${record.source.owner}/${record.source.repo}` : undefined,\n  ];\n  return values.some((value) => typeof value === \"string\" && normalizeTarget(value) === normalizedTarget);\n}\n\nfunction resolveRoots(scope: ExtensionScope, global: GlobalOptions): {\n  selected_root: string;\n} {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const roots = resolveExtensionRoots(pmRoot, process.cwd());\n  return {\n    selected_root: scope === \"global\" ? roots.global : roots.project,\n  };\n}\n\nasync function defaultCommandRunner(\n  command: string,\n  args: string[],\n  options?: { cwd?: string },\n): Promise<UpgradeCommandRunnerResult> {\n  try {\n    const result = await execFileAsync(command, args, {\n      cwd: options?.cwd,\n      encoding: \"utf8\",\n    });\n    return {\n      stdout: result.stdout,\n      stderr: result.stderr,\n    };\n  } catch (error: unknown) {\n    const stderr = typeof error === \"object\" && error !== null && \"stderr\" in error\n      ? String((error as { stderr?: unknown }).stderr ?? \"\")\n      : \"\";\n    const message = stderr.trim().length > 0 ? stderr.trim() : error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`Command failed: ${command} ${args.join(\" \")}\\n${message}`, EXIT_CODE.GENERIC_FAILURE);\n  }\n}\n\nasync function readCurrentVersion(): Promise<string | undefined> {\n  return resolvePmCliVersion(import.meta.url, [\"../../..\"]);\n}\n\nfunction resolveTag(options: UpgradeCommandOptions): string {\n  return typeof options.tag === \"string\" && options.tag.trim().length > 0 ? options.tag.trim() : DEFAULT_TAG;\n}\n\nfunction resolveCliPackage(options: UpgradeCommandOptions): string {\n  return typeof options.packageName === \"string\" && options.packageName.trim().length > 0\n    ? options.packageName.trim()\n    : DEFAULT_CLI_PACKAGE;\n}\n\nasync function upgradeCli(options: UpgradeCommandOptions, dryRun: boolean): Promise<UpgradeCliResult> {\n  const runner = options.commandRunner ?? defaultCommandRunner;\n  const packageName = resolveCliPackage(options);\n  const tag = resolveTag(options);\n  const target = `${packageName}@${tag}`;\n  const command = [\"npm\", \"install\", \"-g\", target];\n  if (options.repair === true) {\n    command.push(\"--force\");\n  }\n  const beforeVersion = await readCurrentVersion();\n  const planned: UpgradeCliResult = {\n    requested: true,\n    status: \"planned\",\n    package: packageName,\n    target,\n    command,\n    before_version: beforeVersion,\n    repair: options.repair === true,\n  };\n  if (dryRun) {\n    return planned;\n  }\n  try {\n    await runner(command[0]!, command.slice(1));\n    const verified = await runner(\"pm\", [\"--version\"]);\n    return {\n      ...planned,\n      status: \"updated\",\n      after_version: verified.stdout.trim() || undefined,\n    };\n  } catch (error: unknown) {\n    return {\n      ...planned,\n      status: \"failed\",\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\nfunction isLocalNpmSpec(spec: string): boolean {\n  return path.isAbsolute(spec) || spec.startsWith(\".\") || spec.startsWith(\"..\") || spec.startsWith(\"file:\");\n}\n\nfunction resolvePackageInstallSource(source: ManagedExtensionSource, tag: string): string {\n  if (source.kind === \"npm\") {\n    const rawSpec = source.input.startsWith(\"npm:\") ? source.input.slice(\"npm:\".length).trim() : source.input.trim();\n    if (!isLocalNpmSpec(rawSpec) && source.package && source.package.trim().length > 0) {\n      return `npm:${source.package.trim()}@${tag}`;\n    }\n    return source.input.startsWith(\"npm:\") ? source.input : `npm:${source.input}`;\n  }\n  return source.input;\n}\n\nasync function resolveRunnablePackageSource(source: ManagedExtensionSource, tag: string): Promise<string> {\n  const installSource = resolvePackageInstallSource(source, tag);\n  if (source.kind !== \"local\") {\n    return installSource;\n  }\n  if (await pathExists(installSource)) {\n    return installSource;\n  }\n  if (await pathExists(source.location)) {\n    return source.location;\n  }\n  return installSource;\n}\n\nfunction packageCommandFor(source: ManagedExtensionSource, installSource: string, scope: ExtensionScope, ref?: string): string[] {\n  const command = [\"pm\", \"install\", installSource, scope === \"global\" ? \"--global\" : \"--project\"];\n  if (source.kind === \"github\" && ref && ref.trim().length > 0) {\n    command.push(\"--ref\", ref.trim());\n  }\n  return command;\n}\n\nasync function readManagedRecords(scope: ExtensionScope, global: GlobalOptions): Promise<ManagedExtensionRecord[]> {\n  const roots = resolveRoots(scope, global);\n  const managedState = await readManagedExtensionState(roots.selected_root);\n  return managedState.state.entries.filter((entry) => entry.scope === scope);\n}\n\nasync function refreshManagedRecord(\n  scope: ExtensionScope,\n  global: GlobalOptions,\n  record: ManagedExtensionRecord,\n): Promise<ManagedExtensionRecord | undefined> {\n  const records = await readManagedRecords(scope, global);\n  return records.find((candidate) => packageRecordMatchesTarget(candidate, record.name)) ??\n    records.find((candidate) => normalizeTarget(candidate.directory) === normalizeTarget(record.directory));\n}\n\nasync function upgradePackageRecord(\n  record: ManagedExtensionRecord,\n  options: UpgradeCommandOptions,\n  global: GlobalOptions,\n  scope: ExtensionScope,\n  dryRun: boolean,\n): Promise<UpgradePackageResult> {\n  const tag = resolveTag(options);\n  const installSource = await resolveRunnablePackageSource(record.source, tag);\n  const command = packageCommandFor(record.source, installSource, scope, record.source.ref);\n  const planned: UpgradePackageResult = {\n    name: record.name,\n    directory: record.directory,\n    scope,\n    source: record.source,\n    status: \"planned\",\n    command,\n    previous_version: record.manifest_version,\n  };\n  if (dryRun) {\n    return planned;\n  }\n  try {\n    await runExtension(\n      installSource,\n      {\n        install: true,\n        project: scope === \"project\",\n        global: scope === \"global\",\n        ref: record.source.kind === \"github\" ? record.source.ref : undefined,\n      },\n      global,\n    );\n    const refreshed = await refreshManagedRecord(scope, global, record);\n    return {\n      ...planned,\n      status: \"updated\",\n      installed_version: refreshed?.manifest_version,\n    };\n  } catch (error: unknown) {\n    return {\n      ...planned,\n      status: \"failed\",\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\nfunction summarize(\n  cli: UpgradeCliResult,\n  packages: UpgradePackageResult[],\n  includeCli: boolean,\n  includePackages: boolean,\n): UpgradeResult[\"summary\"] {\n  const statuses = [includeCli ? cli.status : undefined, ...packages.map((entry) => entry.status)].filter(\n    (value): value is UpgradeCliResult[\"status\"] => typeof value === \"string\",\n  );\n  return {\n    requested_cli: includeCli,\n    requested_packages: includePackages,\n    planned: statuses.filter((status) => status === \"planned\").length,\n    updated: statuses.filter((status) => status === \"updated\").length,\n    skipped: statuses.filter((status) => status === \"skipped\").length,\n    failed: statuses.filter((status) => status === \"failed\").length,\n  };\n}\n\n/**\n * Implements run upgrade for the public runtime surface of this module.\n */\nexport async function runUpgrade(\n  target: string | undefined,\n  options: UpgradeCommandOptions,\n  global: GlobalOptions,\n): Promise<UpgradeResult> {\n  if (options.cliOnly === true && options.packagesOnly === true) {\n    throw new PmCliError('Options \"--cli-only\" and \"--packages-only\" are mutually exclusive.', EXIT_CODE.USAGE);\n  }\n\n  const scope = resolveScope(options);\n  const dryRun = options.dryRun === true;\n  const normalizedTarget = typeof target === \"string\" && target.trim().length > 0 ? target.trim() : undefined;\n  if (options.cliOnly === true && normalizedTarget) {\n    throw new PmCliError('A package target cannot be used with \"--cli-only\".', EXIT_CODE.USAGE);\n  }\n  const includeCli = options.packagesOnly === true || normalizedTarget ? false : true;\n  const includePackages = options.cliOnly === true ? false : true;\n  const cli = includeCli\n    ? await upgradeCli(options, dryRun)\n    : {\n        requested: false,\n        status: \"skipped\",\n        package: resolveCliPackage(options),\n        target: `${resolveCliPackage(options)}@${resolveTag(options)}`,\n        command: [\"npm\", \"install\", \"-g\", `${resolveCliPackage(options)}@${resolveTag(options)}`],\n        repair: options.repair === true,\n        reason: \"not_requested\",\n      } as UpgradeCliResult;\n\n  let packageRecords = includePackages ? await readManagedRecords(scope, global) : [];\n  if (normalizedTarget) {\n    packageRecords = packageRecords.filter((entry) => packageRecordMatchesTarget(entry, normalizedTarget));\n    if (packageRecords.length === 0) {\n      throw new PmCliError(`Managed package \"${normalizedTarget}\" was not found in ${scope} scope.`, EXIT_CODE.NOT_FOUND);\n    }\n  }\n\n  const packages: UpgradePackageResult[] = [];\n  for (const record of packageRecords) {\n    packages.push(await upgradePackageRecord(record, options, global, scope, dryRun));\n  }\n\n  const summary = summarize(cli, packages, includeCli, includePackages);\n  return {\n    ok: summary.failed === 0,\n    action: \"upgrade\",\n    dry_run: dryRun,\n    scope,\n    target: normalizedTarget,\n    cli,\n    packages,\n    summary,\n  };\n}\n"],
-  "mappings": "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",
-  "names": ["global"]
-}