@unbrained/pm-cli 2026.7.5 → 2026.7.6

package/dist/cli-bundle/chunks/chunk-NZEHECMW.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 { 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"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/chunk-O6AWCQRQ.js

@@ -0,0 +1,124 @@
+import {
+  parseItemDocument,
+  serializeItemDocument
+} from "./chunk-NMP5I3I5.js";
+import {
+  runActiveOnWriteHooks
+} from "./chunk-SHQY2IDC.js";
+import {
+  TYPE_TO_FOLDER,
+  getItemFormatFromPath,
+  getItemPath,
+  readFileIfExists,
+  removeFileIfExists,
+  writeFileAtomic
+} from "./chunk-LK6XLOGP.js";
+
+// dist/core/store/item-format-migration.js
+import fs from "node:fs/promises";
+import path from "node:path";
+!(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] = "5127412e-5f1a-5e21-989f-860a1d15c6cc");
+  } catch (e2) {
+  }
+})();
+function alternateItemFormat(_targetFormat) {
+  return "json_markdown";
+}
+function normalizeRelativePath(pmRoot, absolutePath) {
+  return path.relative(pmRoot, absolutePath).replaceAll("\\", "/");
+}
+function errorSummary(error) {
+  return String(error).replaceAll(/[^a-zA-Z0-9._-]+/g, "_").slice(0, 120);
+}
+async function migrateItemFilesToFormat(pmRoot, targetFormat, op = "item_format:migrate", typeToFolder = TYPE_TO_FOLDER, schema) {
+  if (targetFormat !== "toon") {
+    throw new Error("Only toon item-format migration targets are supported. Markdown item files are legacy read-only input.");
+  }
+  const migratedIds = /* @__PURE__ */ new Set();
+  const removedPaths = /* @__PURE__ */ new Set();
+  const warnings = [];
+  let scanned = 0;
+  const alternateFormat = alternateItemFormat(targetFormat);
+  const typeEntries = Object.entries(typeToFolder);
+  for (const [itemType, folder] of typeEntries) {
+    const directoryPath = path.join(pmRoot, folder);
+    let files = [];
+    try {
+      files = await fs.readdir(directoryPath);
+    } catch {
+      continue;
+    }
+    const variantsById = /* @__PURE__ */ new Map();
+    for (const file of files) {
+      const absolutePath = path.join(directoryPath, file);
+      const itemFormat = getItemFormatFromPath(absolutePath);
+      if (!itemFormat) {
+        continue;
+      }
+      const extension = path.extname(file);
+      const itemId = file.slice(0, file.length - extension.length).trim();
+      if (itemId.length === 0) {
+        continue;
+      }
+      const entry = variantsById.get(itemId) ?? {};
+      entry[itemFormat] = absolutePath;
+      variantsById.set(itemId, entry);
+    }
+    const itemIds = [...variantsById.keys()].sort((left, right) => left.localeCompare(right));
+    for (const itemId of itemIds) {
+      const variants = variantsById.get(itemId);
+      scanned += 1;
+      const alternatePath = variants[alternateFormat];
+      if (!alternatePath) {
+        continue;
+      }
+      const sourcePath = variants[targetFormat] ?? alternatePath;
+      const sourceFormat = sourcePath === variants[targetFormat] ? targetFormat : alternateFormat;
+      try {
+        const sourceRaw = await fs.readFile(sourcePath, "utf8");
+        const parsedDocument = parseItemDocument(sourceRaw, {
+          format: sourceFormat,
+          schema,
+          onWarning: (warning) => warnings.push(`item_format_migration_parse_warning:${itemId}:${warning}`)
+        });
+        const targetPath = getItemPath(pmRoot, itemType, itemId, targetFormat, typeToFolder);
+        const serializedTarget = serializeItemDocument(parsedDocument, { format: targetFormat, schema });
+        const existingTargetRaw = await readFileIfExists(targetPath);
+        if (existingTargetRaw !== serializedTarget) {
+          await writeFileAtomic(targetPath, serializedTarget);
+          warnings.push(...await runActiveOnWriteHooks({
+            path: targetPath,
+            scope: "project",
+            op
+          }));
+          migratedIds.add(itemId);
+        }
+        await removeFileIfExists(alternatePath);
+        removedPaths.add(normalizeRelativePath(pmRoot, alternatePath));
+        warnings.push(...await runActiveOnWriteHooks({
+          path: alternatePath,
+          scope: "project",
+          op: `${op}:remove`
+        }));
+        migratedIds.add(itemId);
+      } catch (error) {
+        warnings.push(`item_format_migration_skipped:${normalizeRelativePath(pmRoot, sourcePath)}:${errorSummary(error)}`);
+      }
+    }
+  }
+  return {
+    target_format: targetFormat,
+    scanned,
+    migrated: [...migratedIds].sort((left, right) => left.localeCompare(right)),
+    removed: [...removedPaths].sort((left, right) => left.localeCompare(right)),
+    warnings
+  };
+}
+
+export {
+  migrateItemFilesToFormat
+};
+//# sourceMappingURL=chunk-O6AWCQRQ.js.map

package/dist/cli-bundle/chunks/chunk-OGWQ2IEP.js

@@ -0,0 +1,240 @@
+
+!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]="60ce5760-cb2c-5450-b92b-48275942b6ad")}catch(e){}}();
+import {
+  hashDocument,
+  toItemRecord
+} from "./chunk-ENGQOEUY.js";
+import {
+  canonicalDocument
+} from "./chunk-G24G7ZAV.js";
+import {
+  orderObject,
+  sha256Hex,
+  stableStringify
+} from "./chunk-E3SZTQ4K.js";
+import {
+  FRONT_MATTER_KEY_ORDER
+} from "./chunk-57NWPFF2.js";
+
+// dist/core/history/replay.js
+import jsonPatch from "fast-json-patch";
+var EMPTY_REPLAY_DOCUMENT = {
+  metadata: {},
+  body: ""
+};
+function cloneEmptyReplayDocument() {
+  return structuredClone(EMPTY_REPLAY_DOCUMENT);
+}
+function replayHash(document) {
+  try {
+    return hashDocument(replayToItemDocument(document));
+  } catch {
+    return sha256Hex(stableStringify({ replay_fallback: true, metadata: document.metadata, body: document.body }));
+  }
+}
+function replayToItemDocument(document) {
+  return {
+    metadata: document.metadata,
+    body: document.body
+  };
+}
+function replayToCanonicalItemDocument(document, options = {}) {
+  return canonicalDocument(replayToItemDocument(document), options);
+}
+function toReplayDocument(document) {
+  if (!document.metadata || Object.keys(document.metadata).length === 0) {
+    return {
+      metadata: {},
+      body: document.body ?? ""
+    };
+  }
+  const canonical = canonicalDocument(document);
+  return {
+    metadata: orderObject(toItemRecord(canonical.metadata), FRONT_MATTER_KEY_ORDER),
+    body: canonical.body
+  };
+}
+function normalizeReplayPatchPath(path) {
+  if (path === "/front_matter") {
+    return "/metadata";
+  }
+  if (path.startsWith("/front_matter/")) {
+    return `/metadata/${path.slice("/front_matter/".length)}`;
+  }
+  return path;
+}
+function isHistoryPatchOp(value) {
+  return typeof value === "object" && value !== null && typeof value.op === "string" && typeof value.path === "string";
+}
+function normalizeReplayPatchOps(patch) {
+  if (!Array.isArray(patch)) {
+    return [];
+  }
+  return patch.filter(isHistoryPatchOp).map((operation) => ({
+    ...operation,
+    path: normalizeReplayPatchPath(operation.path),
+    from: typeof operation.from === "string" ? normalizeReplayPatchPath(operation.from) : void 0
+  }));
+}
+function isReplayDocumentShape(value) {
+  return typeof value === "object" && value !== null && "metadata" in value && "body" in value && typeof value.body === "string" && typeof value.metadata === "object" && value.metadata !== null;
+}
+function tryApplyReplayPatch(current, patch) {
+  try {
+    const normalizedPatch = normalizeReplayPatchOps(patch);
+    const applied = jsonPatch.applyPatch(structuredClone(current), normalizedPatch, true, false).newDocument;
+    if (!isReplayDocumentShape(applied)) {
+      return { ok: false, error: new Error("history_replay_invalid_document_shape") };
+    }
+    return { ok: true, document: { metadata: applied.metadata, body: applied.body } };
+  } catch (error) {
+    return { ok: false, error };
+  }
+}
+function verifyHistoryChain(entries) {
+  let replay = cloneEmptyReplayDocument();
+  for (let index = 0; index < entries.length; index += 1) {
+    const entry = entries[index];
+    if (replayHash(replay) !== entry.before_hash) {
+      return {
+        ok: false,
+        errors: [`verify_failed:before_hash_mismatch:entry_${index + 1}`]
+      };
+    }
+    const applied = tryApplyReplayPatch(replay, entry.patch);
+    if (!applied.ok) {
+      return {
+        ok: false,
+        errors: [`verify_failed:patch_apply_failed:entry_${index + 1}`]
+      };
+    }
+    replay = applied.document;
+    if (replayHash(replay) !== entry.after_hash) {
+      return {
+        ok: false,
+        errors: [`verify_failed:after_hash_mismatch:entry_${index + 1}`]
+      };
+    }
+  }
+  return { ok: true, errors: [] };
+}
+function tryApplySingleOp(document, op) {
+  try {
+    const applied = jsonPatch.applyPatch(structuredClone(document), [op], true, false).newDocument;
+    return { ok: true, document: applied };
+  } catch {
+    return { ok: false };
+  }
+}
+function lenientApplyReplayPatch(current, patch) {
+  let working = structuredClone(current);
+  let convertedReplaceToAdd = 0;
+  let skippedOps = 0;
+  for (const op of normalizeReplayPatchOps(patch)) {
+    const direct = tryApplySingleOp(working, op);
+    if (direct.ok) {
+      working = direct.document;
+      continue;
+    }
+    if (op.op === "replace") {
+      const asAdd = tryApplySingleOp(working, { ...op, op: "add" });
+      if (asAdd.ok) {
+        working = asAdd.document;
+        convertedReplaceToAdd += 1;
+        continue;
+      }
+    }
+    skippedOps += 1;
+  }
+  const candidate = working;
+  const document = {
+    metadata: typeof candidate.metadata === "object" && candidate.metadata !== null ? candidate.metadata : {},
+    body: typeof candidate.body === "string" ? candidate.body : current.body
+  };
+  return { document, convertedReplaceToAdd, skippedOps };
+}
+function reanchorHistoryEntries(entries) {
+  let replay = cloneEmptyReplayDocument();
+  const rewritten = [];
+  const details = [];
+  let entriesRehashed = 0;
+  let entriesPatchRepaired = 0;
+  let convertedReplaceToAdd = 0;
+  let skippedOps = 0;
+  for (let index = 0; index < entries.length; index += 1) {
+    const entry = entries[index];
+    const beforeHash = replayHash(replay);
+    const strict = tryApplyReplayPatch(replay, entry.patch);
+    let next;
+    let outPatch;
+    let patchRepaired = false;
+    let entryConverted = 0;
+    let entrySkipped = 0;
+    if (strict.ok) {
+      next = strict.document;
+      outPatch = entry.patch;
+    } else {
+      const lenient = lenientApplyReplayPatch(replay, entry.patch);
+      next = lenient.document;
+      outPatch = jsonPatch.compare(replay, next);
+      patchRepaired = true;
+      entryConverted = lenient.convertedReplaceToAdd;
+      entrySkipped = lenient.skippedOps;
+      convertedReplaceToAdd += entryConverted;
+      skippedOps += entrySkipped;
+      entriesPatchRepaired += 1;
+    }
+    const afterHash = replayHash(next);
+    const rehashed = beforeHash !== entry.before_hash || afterHash !== entry.after_hash;
+    if (rehashed) {
+      entriesRehashed += 1;
+    }
+    rewritten.push({
+      ...entry,
+      patch: outPatch,
+      before_hash: beforeHash,
+      after_hash: afterHash
+    });
+    details.push({
+      index: index + 1,
+      rehashed,
+      patch_repaired: patchRepaired,
+      converted_replace_to_add: entryConverted,
+      skipped_ops: entrySkipped
+    });
+    replay = next;
+  }
+  return {
+    entries: rewritten,
+    finalDocument: replay,
+    entriesRehashed,
+    entriesPatchRepaired,
+    convertedReplaceToAdd,
+    skippedOps,
+    details
+  };
+}
+function historyEntriesToRaw(entries) {
+  if (entries.length === 0) {
+    return "";
+  }
+  return `${entries.map((entry) => JSON.stringify(entry)).join("\n")}
+`;
+}
+
+export {
+  EMPTY_REPLAY_DOCUMENT,
+  cloneEmptyReplayDocument,
+  replayHash,
+  replayToItemDocument,
+  replayToCanonicalItemDocument,
+  toReplayDocument,
+  normalizeReplayPatchOps,
+  tryApplyReplayPatch,
+  verifyHistoryChain,
+  reanchorHistoryEntries,
+  historyEntriesToRaw
+};
+//# sourceMappingURL=chunk-OGWQ2IEP.js.map
+
+//# debugId=60ce5760-cb2c-5450-b92b-48275942b6ad

package/dist/cli-bundle/chunks/chunk-PZUGEOPS.js

@@ -0,0 +1,143 @@
+import {
+  wrapOwnershipConflict
+} from "./chunk-CL36D4PC.js";
+import {
+  resolveAuthor
+} from "./chunk-WW4E2DC3.js";
+import {
+  mutateItem,
+  toItemRecord
+} from "./chunk-5VAA4YHR.js";
+import {
+  PmCliError,
+  readSettings
+} from "./chunk-SHQY2IDC.js";
+import {
+  EXIT_CODE,
+  getSettingsPath,
+  pathExists,
+  resolvePmRoot,
+  resolveRuntimeStatusRegistry,
+  statusIsTerminal
+} from "./chunk-LK6XLOGP.js";
+
+// dist/cli/commands/claim.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] = "a652eb69-9925-57a5-9c26-602cfb588a03");
+  } catch (e2) {
+  }
+})();
+async function runClaim(id, force, global2, options = {}) {
+  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
+  if (!await pathExists(getSettingsPath(pmRoot))) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const settings = await readSettings(pmRoot);
+  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+  const author = resolveAuthor(options.author, settings.author_default);
+  let previousAssignee = null;
+  let skipped = false;
+  const mutationWarnings = [];
+  const result = await mutateItem({
+    pmRoot,
+    settings,
+    id,
+    op: "claim",
+    author,
+    message: options.message,
+    force,
+    skipNoop: true,
+    mutate(document) {
+      const currentAssignee = document.metadata.assignee;
+      const currentAssigneeText = typeof currentAssignee === "string" ? currentAssignee : "";
+      previousAssignee = currentAssigneeText.trim().length > 0 ? currentAssigneeText : null;
+      if (statusIsTerminal(document.metadata.status, statusRegistry) && !force) {
+        throw new PmCliError(`Cannot claim terminal item ${document.metadata.id} without --force`, EXIT_CODE.CONFLICT);
+      }
+      const heldByOther = previousAssignee !== null && previousAssignee !== author;
+      if (heldByOther && options.ifAvailable === true) {
+        skipped = true;
+        mutationWarnings.push(`claim_skipped_held_by:${previousAssignee}`);
+        return { changedFields: [] };
+      }
+      if (heldByOther && !force) {
+        throw new PmCliError(`Item ${document.metadata.id} is already claimed by ${previousAssignee}. Use --force to take over, or --if-available to skip without failing.`, EXIT_CODE.CONFLICT, {
+          code: "already_claimed_by",
+          why: "Claim is an atomic test-and-set so parallel agents never proceed believing they own the same item.",
+          nextSteps: [
+            "Run pm next to pick a different unclaimed item.",
+            "Re-run with --if-available to treat a held item as a no-op skip.",
+            "Re-run with --force only when taking over the item is coordinated."
+          ]
+        });
+      }
+      if (heldByOther) {
+        mutationWarnings.push(`claim_takeover:${previousAssignee}->${author}`);
+      }
+      document.metadata.assignee = author;
+      return { changedFields: ["assignee"], warnings: mutationWarnings };
+    }
+  });
+  return {
+    item: toItemRecord(result.item),
+    claimed_by: skipped && previousAssignee !== null ? previousAssignee : author,
+    previous_assignee: previousAssignee,
+    forced: force,
+    ...skipped ? { skipped: true } : {},
+    ...mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}
+  };
+}
+async function runRelease(id, force, global2, options = {}) {
+  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
+  if (!await pathExists(getSettingsPath(pmRoot))) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const settings = await readSettings(pmRoot);
+  const author = resolveAuthor(options.author, settings.author_default);
+  let previousAssignee = null;
+  let result;
+  try {
+    result = await mutateItem({
+      pmRoot,
+      settings,
+      id,
+      op: "release",
+      author,
+      message: options.message,
+      force,
+      bypassAssigneeConflict: Boolean(options.allowAuditRelease),
+      mutate(document) {
+        previousAssignee = document.metadata.assignee ?? null;
+        if (!previousAssignee) {
+          return { changedFields: [] };
+        }
+        delete document.metadata.assignee;
+        return { changedFields: ["assignee"] };
+      }
+    });
+  } catch (error) {
+    wrapOwnershipConflict(error, {
+      required: "For audited non-owner handoffs, prefer --allow-audit-release before considering --force.",
+      examples: ['pm release pm-a1b2 --author "reviewer" --allow-audit-release'],
+      nextSteps: [
+        "Use --allow-audit-release for append-only release handoffs that only clear assignee metadata.",
+        "Use --force only when an explicit override is approved for broader ownership conflicts."
+      ]
+    });
+  }
+  return {
+    item: toItemRecord(result.item),
+    released_by: author,
+    previous_assignee: previousAssignee,
+    audit_release: options.allowAuditRelease === true,
+    forced: force
+  };
+}
+
+export {
+  runClaim,
+  runRelease
+};
+//# sourceMappingURL=chunk-PZUGEOPS.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/claim.ts"],
+  "sourcesContent": ["/**\n * @module cli/commands/claim\n *\n * Implements the pm claim command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { resolveRuntimeStatusRegistry, statusIsTerminal } 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 { toItemRecord } from \"../../core/item/item-record.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { wrapOwnershipConflict } from \"./annotation-command.js\";\n\n/**\n * Documents the claim result payload exchanged by command, SDK, and package integrations.\n */\nexport interface ClaimResult {\n  item: Record<string, unknown>;\n  claimed_by: string;\n  previous_assignee: string | null;\n  forced: boolean;\n  skipped?: boolean;\n  warnings?: string[];\n}\n\n/**\n * Documents the release result payload exchanged by command, SDK, and package integrations.\n */\nexport interface ReleaseResult {\n  item: Record<string, unknown>;\n  released_by: string;\n  previous_assignee: string | null;\n  audit_release: boolean;\n  forced: boolean;\n}\n\n/**\n * Documents the claim mutation options payload exchanged by command, SDK, and package integrations.\n */\nexport interface ClaimMutationOptions {\n  author?: string;\n  message?: string;\n  ifAvailable?: boolean;\n}\n\n/**\n * Documents the release mutation options payload exchanged by command, SDK, and package integrations.\n */\nexport interface ReleaseMutationOptions extends ClaimMutationOptions {\n  allowAuditRelease?: boolean;\n}\n\n/**\n * Implements run claim for the public runtime surface of this module.\n */\nexport async function runClaim(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions = {},\n): Promise<ClaimResult> {\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 author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n  let skipped = false;\n  const mutationWarnings: string[] = [];\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"claim\",\n    author,\n    message: options.message,\n    force,\n    skipNoop: true,\n    mutate(document) {\n      const currentAssignee = document.metadata.assignee;\n      const currentAssigneeText = typeof currentAssignee === \"string\" ? currentAssignee : \"\";\n      previousAssignee = currentAssigneeText.trim().length > 0 ? currentAssigneeText : null;\n      if (statusIsTerminal(document.metadata.status, statusRegistry) && !force) {\n        throw new PmCliError(`Cannot claim terminal item ${document.metadata.id} without --force`, EXIT_CODE.CONFLICT);\n      }\n      const heldByOther = previousAssignee !== null && previousAssignee !== author;\n      if (heldByOther && options.ifAvailable === true) {\n        skipped = true;\n        mutationWarnings.push(`claim_skipped_held_by:${previousAssignee}`);\n        return { changedFields: [] };\n      }\n      if (heldByOther && !force) {\n        throw new PmCliError(\n          `Item ${document.metadata.id} is already claimed by ${previousAssignee}. Use --force to take over, or --if-available to skip without failing.`,\n          EXIT_CODE.CONFLICT,\n          {\n            code: \"already_claimed_by\",\n            why: \"Claim is an atomic test-and-set so parallel agents never proceed believing they own the same item.\",\n            nextSteps: [\n              \"Run pm next to pick a different unclaimed item.\",\n              \"Re-run with --if-available to treat a held item as a no-op skip.\",\n              \"Re-run with --force only when taking over the item is coordinated.\",\n            ],\n          },\n        );\n      }\n      if (heldByOther) {\n        mutationWarnings.push(`claim_takeover:${previousAssignee}->${author}`);\n      }\n      document.metadata.assignee = author;\n      return { changedFields: [\"assignee\"], warnings: mutationWarnings };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    claimed_by: skipped && previousAssignee !== null ? previousAssignee : author,\n    previous_assignee: previousAssignee,\n    forced: force,\n    ...(skipped ? { skipped: true } : {}),\n    ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n  };\n}\n\n/**\n * Implements run release for the public runtime surface of this module.\n */\nexport async function runRelease(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ReleaseMutationOptions = {},\n): Promise<ReleaseResult> {\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 author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: \"release\",\n      author,\n      message: options.message,\n      force,\n      bypassAssigneeConflict: Boolean(options.allowAuditRelease),\n      mutate(document) {\n        previousAssignee = document.metadata.assignee ?? null;\n        if (!previousAssignee) {\n          return { changedFields: [] };\n        }\n        delete document.metadata.assignee;\n        return { changedFields: [\"assignee\"] };\n      },\n    });\n  } catch (error: unknown) {\n    wrapOwnershipConflict(error, {\n      required: \"For audited non-owner handoffs, prefer --allow-audit-release before considering --force.\",\n      examples: ['pm release pm-a1b2 --author \"reviewer\" --allow-audit-release'],\n      nextSteps: [\n        \"Use --allow-audit-release for append-only release handoffs that only clear assignee metadata.\",\n        \"Use --force only when an explicit override is approved for broader ownership conflicts.\",\n      ],\n    });\n  }\n\n  return {\n    item: toItemRecord(result.item),\n    released_by: author,\n    previous_assignee: previousAssignee,\n    audit_release: options.allowAuditRelease === true,\n    forced: force,\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["global"]
+}