@unbrained/pm-cli 2026.7.3 → 2026.7.5

package/dist/cli-bundle/chunks/{close-many-JKUJMHLG.js.map → close-many-AP4MWU36.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/close-many.ts"],"sourcesContent":["/**\n * @module cli/commands/close-many\n *\n * Implements the pm close 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 { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } 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 { resolveAuthor } from \"../../core/shared/author.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { listAllFrontMatterLight } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { runClose, type CloseCommandOptions } from \"./close.js\";\nimport { hasListFilters } from \"./list-filter-shared.js\";\nimport { runList, type ListOptions, type ListedItem } from \"./list.js\";\nimport { runRestore } from \"./restore.js\";\n\nconst CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;\nconst CLOSE_MANY_CHECKPOINT_SUBDIR = \"close-many\";\n\nconst CLOSE_MANY_FILTER_GUIDANCE = [\n  \"--filter-status\",\n  \"--filter-type\",\n  \"--filter-tag\",\n  \"--filter-priority\",\n  \"--filter-sprint\",\n  \"--filter-release\",\n  \"--filter-parent\",\n  \"--filter-assignee\",\n  \"--filter-updated-before\",\n  \"--ids\",\n].join(\", \");\n\n/**\n * Documents the close many command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseManyCommandOptions {\n  status?: string;\n  list?: ListOptions;\n  reason?: string;\n  resolution?: string;\n  expectedResult?: string;\n  actualResult?: string;\n  validateClose?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  dryRun?: boolean;\n  rollback?: string;\n  checkpoint?: boolean;\n}\n\ninterface CloseManyPlanRow {\n  id: string;\n  title: string;\n  status: string;\n  action: \"close\" | \"skip\";\n  skip_reason?: string;\n  active_child_ids?: string[];\n}\n\ninterface CloseManyApplyRow {\n  id: string;\n  status: \"closed\" | \"skipped\" | \"failed\";\n  skip_reason?: string;\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\ninterface CloseManyPlanContext {\n  pmRoot: string;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>;\n  reason: string | undefined;\n  validateCloseMode: string | undefined;\n  force: boolean;\n  listed: Awaited<ReturnType<typeof runList>>;\n  matched: ListedItem[];\n  planRows: CloseManyPlanRow[];\n}\n\n/**\n * Documents the close many result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseManyResult {\n  mode: \"dry_run\" | \"apply\" | \"rollback\";\n  matched_count: number;\n  dry_run: boolean;\n  reason?: string;\n  filters?: Record<string, unknown>;\n  validate_close?: string;\n  item_plans?: CloseManyPlanRow[];\n  checkpoint?: {\n    id: string;\n    created_at: string;\n    path: string;\n    rollback_command: string;\n  };\n  closed_count?: number;\n  skipped_count?: number;\n  failed_count?: number;\n  restored_count?: number;\n  rollback_checkpoint_id?: string;\n  rows?: CloseManyApplyRow[] | Array<{ id: string; status: \"restored\" | \"failed\"; changed_fields?: string[]; warnings?: string[]; error?: string }>;\n  ids: string[];\n}\n\nfunction hasCloseManyFilters(list: ListOptions | undefined, status: string | undefined): boolean {\n  return hasListFilters(list, status, { includePagination: false });\n}\n\nfunction hasCloseManyRollbackConflicts(list: ListOptions | undefined, status: string | undefined): boolean {\n  return hasListFilters(list, status);\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\nfunction activeListOptions(list: ListOptions | undefined): ListOptions {\n  const active: ListOptions = {};\n  if (!list) {\n    return active;\n  }\n  for (const [key, value] of Object.entries(list) as Array<[keyof ListOptions, unknown]>) {\n    if (value == null || (typeof value === \"string\" && !value.split(\",\").some((entry) => entry.trim().length > 0))) {\n      continue;\n    }\n    (active as Record<string, unknown>)[key] = value;\n  }\n  return active;\n}\n\nfunction resolveReason(reason: unknown, required: boolean): string | undefined {\n  const trimmed = String(reason ?? \"\").trim();\n  if (trimmed.length > 0) {\n    return trimmed;\n  }\n  if (required) {\n    throw new PmCliError(\n      \"pm close-many requires a shared close reason via --reason because governance.require_close_reason is enabled.\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"close_reason_required\",\n        required: \"Provide a shared closing summary via --reason for the whole batch.\",\n        why: \"governance.require_close_reason is enabled, so every close must record why the items are done.\",\n        examples: [\n          'pm close-many --filter-sprint S-12 --reason \"Sprint S-12 acceptance criteria met\"',\n          'pm close-many --ids pm-a,pm-b --reason \"Superseded by redesign\"',\n        ],\n        nextSteps: [\n          \"Re-run with --reason describing the shared outcome.\",\n          \"To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled\",\n        ],\n      },\n    );\n  }\n  return undefined;\n}\n\n// Build a parent -> non-terminal child id map in a single light scan so each\n// matched parent can be annotated with the active children that closing it\n// would orphan (the same signal runClose surfaces per item on apply).\nasync function buildActiveChildrenByParent(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n): Promise<{ childrenByParent: Map<string, string[]>; parentByChild: Map<string, string> }> {\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const items = await listAllFrontMatterLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  const childrenByParent = new Map<string, string[]>();\n  const parentByChild = new Map<string, string>();\n  for (const item of items) {\n    if (typeof item.parent !== \"string\" || item.parent.length === 0) {\n      continue;\n    }\n    parentByChild.set(item.id, item.parent);\n    if (isTerminalStatus(item.status, statusRegistry)) {\n      continue;\n    }\n    const existing = childrenByParent.get(item.parent);\n    if (existing) {\n      existing.push(item.id);\n    } else {\n      childrenByParent.set(item.parent, [item.id]);\n    }\n  }\n  for (const ids of childrenByParent.values()) {\n    ids.sort((left, right) => left.localeCompare(right));\n  }\n  return { childrenByParent, parentByChild };\n}\n\nfunction hierarchyDepth(id: string, parentByChild: Map<string, string>, cache?: Map<string, number>): number {\n  const cached = cache?.get(id);\n  if (cached !== undefined) {\n    return cached;\n  }\n  let depth = 0;\n  let current = parentByChild.get(id);\n  const path: string[] = [];\n  const visited = new Set<string>();\n  let hasCycle = false;\n  while (current !== undefined && !visited.has(current)) {\n    const cachedCurrent = cache?.get(current);\n    if (cachedCurrent !== undefined) {\n      depth += cachedCurrent + 1;\n      break;\n    }\n    visited.add(current);\n    path.push(current);\n    depth += 1;\n    current = parentByChild.get(current);\n  }\n  if (current !== undefined && visited.has(current)) {\n    hasCycle = true;\n  }\n  if (!hasCycle) {\n    cache?.set(id, depth);\n    for (const [index, ancestorId] of path.entries()) {\n      cache?.set(ancestorId, depth - index - 1);\n    }\n  }\n  return depth;\n}\n\nasync function runCloseManyRollback(params: {\n  pmRoot: string;\n  rollbackId: string;\n  options: CloseManyCommandOptions;\n  global: GlobalOptions;\n}): Promise<CloseManyResult> {\n  const checkpoint = await loadMutationCheckpoint(\n    params.pmRoot,\n    CLOSE_MANY_CHECKPOINT_SUBDIR,\n    params.rollbackId,\n    CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,\n  );\n  const restoreMessage = params.options.message ?? `Rollback close-many checkpoint ${checkpoint.id}`;\n  const rollback = await restoreCheckpointItems(checkpoint.items, (id, targetUpdatedAt) =>\n    runRestore(id, targetUpdatedAt, { author: params.options.author, message: restoreMessage, force: true }, params.global),\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 close-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\nfunction planCloseManyRows(\n  matched: ListedItem[],\n  childrenByParent: Map<string, string[]>,\n  closePlannedIds: Set<string>,\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>,\n  force: boolean,\n): CloseManyPlanRow[] {\n  return matched.map((item) => {\n    const activeChildIds = (childrenByParent.get(item.id) ?? []).filter((childId) => !closePlannedIds.has(childId));\n    const willSkip = !canCloseManyItem(item, statusRegistry, force);\n    return {\n      id: item.id,\n      title: typeof item.title === \"string\" ? item.title : \"\",\n      status: item.status,\n      action: willSkip ? \"skip\" : \"close\",\n      ...(willSkip ? { skip_reason: \"already_terminal\" } : {}),\n      ...(activeChildIds.length > 0 ? { active_child_ids: activeChildIds } : {}),\n    };\n  });\n}\n\nasync function writeCloseManyCheckpoint(params: {\n  pmRoot: string;\n  checkpointId: string;\n  nowValue: string;\n  options: CloseManyCommandOptions;\n  reason: string | undefined;\n  filters: Record<string, unknown>;\n  checkpointItems: MutationCheckpointItem[];\n}): Promise<CloseManyResult[\"checkpoint\"]> {\n  const checkpointPath = await writeMutationCheckpoint(params.pmRoot, CLOSE_MANY_CHECKPOINT_SUBDIR, params.checkpointId, {\n    schema_version: CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    author: resolveAuthor(params.options.author, \"unknown\"),\n    ...(params.reason !== undefined ? { reason: params.reason } : {}),\n    filters: params.filters,\n    items: params.checkpointItems,\n  });\n  return {\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    path: checkpointPath,\n    rollback_command: `pm close-many --rollback ${params.checkpointId}`,\n  };\n}\n\nasync function applyCloseManyRows(params: {\n  matched: ListedItem[];\n  closableIds: Set<string>;\n  reason: string | undefined;\n  closeOptions: CloseCommandOptions;\n  global: GlobalOptions;\n}): Promise<{ rows: CloseManyApplyRow[]; closedIds: string[] }> {\n  const rows: CloseManyApplyRow[] = [];\n  const closedIds: string[] = [];\n  for (const item of params.matched) {\n    if (!params.closableIds.has(item.id)) {\n      rows.push({ id: item.id, status: \"skipped\", skip_reason: \"already_terminal\" });\n      continue;\n    }\n    try {\n      const result = await runClose(item.id, params.reason, params.closeOptions, params.global);\n      rows.push({\n        id: item.id,\n        status: \"closed\",\n        changed_fields: result.changed_fields,\n        ...(result.warnings && result.warnings.length > 0 ? { warnings: result.warnings } : {}),\n      });\n      closedIds.push(item.id);\n    } catch (error: unknown) {\n      rows.push({ id: item.id, status: \"failed\", error: toErrorMessage(error) });\n    }\n  }\n  return { rows, closedIds };\n}\n\nfunction resolveCloseManyRollbackId(options: CloseManyCommandOptions): string | undefined {\n  return typeof options.rollback === \"string\" ? options.rollback : undefined;\n}\n\nfunction validateCloseManyRollbackOptions(options: CloseManyCommandOptions, rollbackId: string): void {\n  if (rollbackId.trim().length === 0) {\n    throw new PmCliError(\"--rollback requires a checkpoint id\", EXIT_CODE.USAGE);\n  }\n  if (options.dryRun === true) {\n    throw new PmCliError(\"--dry-run cannot be combined with --rollback\", EXIT_CODE.USAGE);\n  }\n  if (hasCloseManyRollbackConflicts(options.list, options.status)) {\n    throw new PmCliError(\"Rollback mode does not accept filter options\", EXIT_CODE.USAGE);\n  }\n}\n\nfunction assertCloseManyHasFilters(options: CloseManyCommandOptions): void {\n  if (hasCloseManyFilters(options.list, options.status)) {\n    return;\n  }\n  throw new PmCliError(\n    `close-many requires at least one filter to scope the close (for example: ${CLOSE_MANY_FILTER_GUIDANCE}). Refusing to match every item.`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction sortCloseManyMatchedItems(matched: ListedItem[], parentByChild: Map<string, string>): ListedItem[] {\n  const depthCache = new Map<string, number>();\n  return [...matched].sort((left, right) => {\n    const depthDelta = hierarchyDepth(right.id, parentByChild, depthCache) - hierarchyDepth(left.id, parentByChild, depthCache);\n    return depthDelta !== 0 ? depthDelta : left.id.localeCompare(right.id);\n  });\n}\n\nfunction canCloseManyItem(\n  item: ListedItem,\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>,\n  force: boolean,\n): boolean {\n  return force || !isTerminalStatus(item.status, statusRegistry);\n}\n\nfunction resolveCloseManyPlannedIds(\n  matched: ListedItem[],\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>,\n  force: boolean,\n): Set<string> {\n  return new Set(matched.filter((item) => canCloseManyItem(item, statusRegistry, force)).map((item) => item.id));\n}\n\nasync function buildCloseManyPlanContext(params: {\n  pmRoot: string;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  options: CloseManyCommandOptions;\n  global: GlobalOptions;\n}): Promise<CloseManyPlanContext> {\n  assertCloseManyHasFilters(params.options);\n  const statusRegistry = resolveRuntimeStatusRegistry(params.settings.schema);\n  const reason = resolveReason(params.options.reason, params.settings.governance.require_close_reason);\n  const force = params.options.force === true;\n  const listed = await runList(params.options.status, activeListOptions(params.options.list), params.global);\n  const { childrenByParent, parentByChild } = await buildActiveChildrenByParent(params.pmRoot, params.settings);\n  const matched = sortCloseManyMatchedItems(listed.items as ListedItem[], parentByChild);\n  const closePlannedIds = resolveCloseManyPlannedIds(matched, statusRegistry, force);\n  return {\n    pmRoot: params.pmRoot,\n    settings: params.settings,\n    statusRegistry,\n    reason,\n    validateCloseMode: params.options.validateClose,\n    force,\n    listed,\n    matched,\n    planRows: planCloseManyRows(matched, childrenByParent, closePlannedIds, statusRegistry, force),\n  };\n}\n\nfunction buildCloseManyDryRunResult(context: CloseManyPlanContext): CloseManyResult {\n  return {\n    mode: \"dry_run\",\n    matched_count: context.matched.length,\n    dry_run: true,\n    ...(context.reason !== undefined ? { reason: context.reason } : {}),\n    filters: context.listed.filters,\n    ...(context.validateCloseMode ? { validate_close: context.validateCloseMode } : {}),\n    item_plans: context.planRows,\n    ids: [],\n  };\n}\n\nasync function resolveCloseManyCheckpointInfo(params: {\n  context: CloseManyPlanContext;\n  options: CloseManyCommandOptions;\n  closableIds: Set<string>;\n  checkpointId: string;\n  nowValue: string;\n}): Promise<CloseManyResult[\"checkpoint\"]> {\n  if (params.options.checkpoint === false || params.closableIds.size === 0) {\n    return undefined;\n  }\n  const checkpointItems: MutationCheckpointItem[] = params.context.matched\n    .filter((item) => params.closableIds.has(item.id))\n    .map((item) => ({ id: item.id, target_updated_at: item.updated_at }));\n  return writeCloseManyCheckpoint({\n    pmRoot: params.context.pmRoot,\n    checkpointId: params.checkpointId,\n    nowValue: params.nowValue,\n    options: params.options,\n    reason: params.context.reason,\n    filters: params.context.listed.filters,\n    checkpointItems,\n  });\n}\n\n/**\n * Implements run close many for the public runtime surface of this module.\n */\nexport async function runCloseMany(options: CloseManyCommandOptions, global: GlobalOptions): Promise<CloseManyResult> {\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\n  const dryRun = options.dryRun === true;\n  const rollbackId = resolveCloseManyRollbackId(options);\n  rejectBlankIdsFilter(options.list);\n\n  if (rollbackId !== undefined) {\n    validateCloseManyRollbackOptions(options, rollbackId);\n    return runCloseManyRollback({ pmRoot, rollbackId, options, global });\n  }\n\n  const context = await buildCloseManyPlanContext({ pmRoot, settings, options, global });\n\n  if (dryRun) {\n    return buildCloseManyDryRunResult(context);\n  }\n\n  const closableIds = new Set(context.planRows.filter((row) => row.action === \"close\").map((row) => row.id));\n  const nowValue = nowIso();\n  const checkpointId = createCheckpointId(CLOSE_MANY_CHECKPOINT_SUBDIR, nowValue);\n  const checkpointInfo = await resolveCloseManyCheckpointInfo({ context, options, closableIds, checkpointId, nowValue });\n\n  const closeOptions: CloseCommandOptions = {\n    author: options.author,\n    message: options.message ?? `close-many apply ${checkpointId}`,\n    validateClose: context.validateCloseMode,\n    force: context.force,\n    resolution: options.resolution,\n    expectedResult: options.expectedResult,\n    actualResult: options.actualResult,\n  };\n\n  const { rows, closedIds } = await applyCloseManyRows({\n    matched: context.matched,\n    closableIds,\n    reason: context.reason,\n    closeOptions,\n    global,\n  });\n\n  return {\n    mode: \"apply\",\n    matched_count: context.matched.length,\n    dry_run: false,\n    ...(context.reason !== undefined ? { reason: context.reason } : {}),\n    filters: context.listed.filters,\n    ...(context.validateCloseMode ? { validate_close: context.validateCloseMode } : {}),\n    ...(checkpointInfo ? { checkpoint: checkpointInfo } : {}),\n    closed_count: rows.filter((row) => row.status === \"closed\").length,\n    skipped_count: rows.filter((row) => row.status === \"skipped\").length,\n    failed_count: rows.filter((row) => row.status === \"failed\").length,\n    rows,\n    ids: closedIds,\n  };\n}\n\nexport const _testOnly = {\n  activeListOptions,\n  buildActiveChildrenByParent,\n  hasCloseManyFilters,\n  hasCloseManyRollbackConflicts,\n  hierarchyDepth,\n  rejectBlankIdsFilter,\n  resolveReason,\n};\n"],"names":[],"mappings":"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","debugId":"2a91a002-c3ac-5ecc-8196-c2070529b3e8"}
+{"version":3,"sources":["../../../../../../../../cli/commands/close-many.ts"],"sourcesContent":["/**\n * @module cli/commands/close-many\n *\n * Implements the pm close 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 { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } 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 { resolveAuthor } from \"../../core/shared/author.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { listAllFrontMatterLight } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { runClose, type CloseCommandOptions } from \"./close.js\";\nimport { hasListFilters } from \"./list-filter-shared.js\";\nimport { runList, type ListOptions, type ListedItem } from \"./list.js\";\nimport { runRestore } from \"./restore.js\";\n\nconst CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;\nconst CLOSE_MANY_CHECKPOINT_SUBDIR = \"close-many\";\n\nconst CLOSE_MANY_FILTER_GUIDANCE = [\n  \"--filter-status\",\n  \"--filter-type\",\n  \"--filter-tag\",\n  \"--filter-priority\",\n  \"--filter-sprint\",\n  \"--filter-release\",\n  \"--filter-parent\",\n  \"--filter-assignee\",\n  \"--filter-updated-before\",\n  \"--ids\",\n].join(\", \");\n\n/**\n * Documents the close many command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseManyCommandOptions {\n  status?: string;\n  list?: ListOptions;\n  reason?: string;\n  resolution?: string;\n  expectedResult?: string;\n  actualResult?: string;\n  validateClose?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  dryRun?: boolean;\n  rollback?: string;\n  checkpoint?: boolean;\n}\n\ninterface CloseManyPlanRow {\n  id: string;\n  title: string;\n  status: string;\n  action: \"close\" | \"skip\";\n  skip_reason?: string;\n  active_child_ids?: string[];\n}\n\ninterface CloseManyApplyRow {\n  id: string;\n  status: \"closed\" | \"skipped\" | \"failed\";\n  skip_reason?: string;\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\ninterface CloseManyPlanContext {\n  pmRoot: string;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>;\n  reason: string | undefined;\n  validateCloseMode: string | undefined;\n  force: boolean;\n  listed: Awaited<ReturnType<typeof runList>>;\n  matched: ListedItem[];\n  planRows: CloseManyPlanRow[];\n}\n\n/**\n * Documents the close many result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseManyResult {\n  mode: \"dry_run\" | \"apply\" | \"rollback\";\n  matched_count: number;\n  dry_run: boolean;\n  reason?: string;\n  filters?: Record<string, unknown>;\n  validate_close?: string;\n  item_plans?: CloseManyPlanRow[];\n  checkpoint?: {\n    id: string;\n    created_at: string;\n    path: string;\n    rollback_command: string;\n  };\n  closed_count?: number;\n  skipped_count?: number;\n  failed_count?: number;\n  restored_count?: number;\n  rollback_checkpoint_id?: string;\n  rows?: CloseManyApplyRow[] | Array<{ id: string; status: \"restored\" | \"failed\"; changed_fields?: string[]; warnings?: string[]; error?: string }>;\n  ids: string[];\n}\n\nfunction hasCloseManyFilters(list: ListOptions | undefined, status: string | undefined): boolean {\n  return hasListFilters(list, status, { includePagination: false });\n}\n\nfunction hasCloseManyRollbackConflicts(list: ListOptions | undefined, status: string | undefined): boolean {\n  return hasListFilters(list, status);\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\nfunction activeListOptions(list: ListOptions | undefined): ListOptions {\n  const active: ListOptions = {};\n  if (!list) {\n    return active;\n  }\n  for (const [key, value] of Object.entries(list) as Array<[keyof ListOptions, unknown]>) {\n    if (value == null || (typeof value === \"string\" && !value.split(\",\").some((entry) => entry.trim().length > 0))) {\n      continue;\n    }\n    (active as Record<string, unknown>)[key] = value;\n  }\n  return active;\n}\n\nfunction resolveReason(reason: unknown, required: boolean): string | undefined {\n  const trimmed = String(reason ?? \"\").trim();\n  if (trimmed.length > 0) {\n    return trimmed;\n  }\n  if (required) {\n    throw new PmCliError(\n      \"pm close-many requires a shared close reason via --reason because governance.require_close_reason is enabled.\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"close_reason_required\",\n        required: \"Provide a shared closing summary via --reason for the whole batch.\",\n        why: \"governance.require_close_reason is enabled, so every close must record why the items are done.\",\n        examples: [\n          'pm close-many --filter-sprint S-12 --reason \"Sprint S-12 acceptance criteria met\"',\n          'pm close-many --ids pm-a,pm-b --reason \"Superseded by redesign\"',\n        ],\n        nextSteps: [\n          \"Re-run with --reason describing the shared outcome.\",\n          \"To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled\",\n        ],\n      },\n    );\n  }\n  return undefined;\n}\n\n// Build a parent -> non-terminal child id map in a single light scan so each\n// matched parent can be annotated with the active children that closing it\n// would orphan (the same signal runClose surfaces per item on apply).\nasync function buildActiveChildrenByParent(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n): Promise<{ childrenByParent: Map<string, string[]>; parentByChild: Map<string, string> }> {\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const items = await listAllFrontMatterLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  const childrenByParent = new Map<string, string[]>();\n  const parentByChild = new Map<string, string>();\n  for (const item of items) {\n    if (typeof item.parent !== \"string\" || item.parent.length === 0) {\n      continue;\n    }\n    parentByChild.set(item.id, item.parent);\n    if (isTerminalStatus(item.status, statusRegistry)) {\n      continue;\n    }\n    const existing = childrenByParent.get(item.parent);\n    if (existing) {\n      existing.push(item.id);\n    } else {\n      childrenByParent.set(item.parent, [item.id]);\n    }\n  }\n  for (const ids of childrenByParent.values()) {\n    ids.sort((left, right) => left.localeCompare(right));\n  }\n  return { childrenByParent, parentByChild };\n}\n\nfunction hierarchyDepth(id: string, parentByChild: Map<string, string>, cache?: Map<string, number>): number {\n  const cached = cache?.get(id);\n  if (cached !== undefined) {\n    return cached;\n  }\n  let depth = 0;\n  let current = parentByChild.get(id);\n  const path: string[] = [];\n  const visited = new Set<string>();\n  let hasCycle = false;\n  while (current !== undefined && !visited.has(current)) {\n    const cachedCurrent = cache?.get(current);\n    if (cachedCurrent !== undefined) {\n      depth += cachedCurrent + 1;\n      break;\n    }\n    visited.add(current);\n    path.push(current);\n    depth += 1;\n    current = parentByChild.get(current);\n  }\n  if (current !== undefined && visited.has(current)) {\n    hasCycle = true;\n  }\n  if (!hasCycle) {\n    cache?.set(id, depth);\n    for (const [index, ancestorId] of path.entries()) {\n      cache?.set(ancestorId, depth - index - 1);\n    }\n  }\n  return depth;\n}\n\nasync function runCloseManyRollback(params: {\n  pmRoot: string;\n  rollbackId: string;\n  options: CloseManyCommandOptions;\n  global: GlobalOptions;\n}): Promise<CloseManyResult> {\n  const checkpoint = await loadMutationCheckpoint(\n    params.pmRoot,\n    CLOSE_MANY_CHECKPOINT_SUBDIR,\n    params.rollbackId,\n    CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,\n  );\n  const restoreMessage = params.options.message ?? `Rollback close-many checkpoint ${checkpoint.id}`;\n  const rollback = await restoreCheckpointItems(checkpoint.items, (id, targetUpdatedAt) =>\n    runRestore(id, targetUpdatedAt, { author: params.options.author, message: restoreMessage, force: true }, params.global),\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 close-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\nfunction planCloseManyRows(\n  matched: ListedItem[],\n  childrenByParent: Map<string, string[]>,\n  closePlannedIds: Set<string>,\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>,\n  force: boolean,\n): CloseManyPlanRow[] {\n  return matched.map((item) => {\n    const activeChildIds = (childrenByParent.get(item.id) ?? []).filter((childId) => !closePlannedIds.has(childId));\n    const willSkip = !canCloseManyItem(item, statusRegistry, force);\n    return {\n      id: item.id,\n      title: typeof item.title === \"string\" ? item.title : \"\",\n      status: item.status,\n      action: willSkip ? \"skip\" : \"close\",\n      ...(willSkip ? { skip_reason: \"already_terminal\" } : {}),\n      ...(activeChildIds.length > 0 ? { active_child_ids: activeChildIds } : {}),\n    };\n  });\n}\n\nasync function writeCloseManyCheckpoint(params: {\n  pmRoot: string;\n  checkpointId: string;\n  nowValue: string;\n  options: CloseManyCommandOptions;\n  reason: string | undefined;\n  filters: Record<string, unknown>;\n  checkpointItems: MutationCheckpointItem[];\n}): Promise<CloseManyResult[\"checkpoint\"]> {\n  const checkpointPath = await writeMutationCheckpoint(params.pmRoot, CLOSE_MANY_CHECKPOINT_SUBDIR, params.checkpointId, {\n    schema_version: CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    author: resolveAuthor(params.options.author, \"unknown\"),\n    ...(params.reason !== undefined ? { reason: params.reason } : {}),\n    filters: params.filters,\n    items: params.checkpointItems,\n  });\n  return {\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    path: checkpointPath,\n    rollback_command: `pm close-many --rollback ${params.checkpointId}`,\n  };\n}\n\nasync function applyCloseManyRows(params: {\n  matched: ListedItem[];\n  closableIds: Set<string>;\n  reason: string | undefined;\n  closeOptions: CloseCommandOptions;\n  global: GlobalOptions;\n}): Promise<{ rows: CloseManyApplyRow[]; closedIds: string[] }> {\n  const rows: CloseManyApplyRow[] = [];\n  const closedIds: string[] = [];\n  for (const item of params.matched) {\n    if (!params.closableIds.has(item.id)) {\n      rows.push({ id: item.id, status: \"skipped\", skip_reason: \"already_terminal\" });\n      continue;\n    }\n    try {\n      const result = await runClose(item.id, params.reason, params.closeOptions, params.global);\n      rows.push({\n        id: item.id,\n        status: \"closed\",\n        changed_fields: result.changed_fields,\n        ...(result.warnings && result.warnings.length > 0 ? { warnings: result.warnings } : {}),\n      });\n      closedIds.push(item.id);\n    } catch (error: unknown) {\n      rows.push({ id: item.id, status: \"failed\", error: toErrorMessage(error) });\n    }\n  }\n  return { rows, closedIds };\n}\n\nfunction resolveCloseManyRollbackId(options: CloseManyCommandOptions): string | undefined {\n  return typeof options.rollback === \"string\" ? options.rollback : undefined;\n}\n\nfunction validateCloseManyRollbackOptions(options: CloseManyCommandOptions, rollbackId: string): void {\n  if (rollbackId.trim().length === 0) {\n    throw new PmCliError(\"--rollback requires a checkpoint id\", EXIT_CODE.USAGE);\n  }\n  if (options.dryRun === true) {\n    throw new PmCliError(\"--dry-run cannot be combined with --rollback\", EXIT_CODE.USAGE);\n  }\n  if (hasCloseManyRollbackConflicts(options.list, options.status)) {\n    throw new PmCliError(\"Rollback mode does not accept filter options\", EXIT_CODE.USAGE);\n  }\n}\n\nfunction assertCloseManyHasFilters(options: CloseManyCommandOptions): void {\n  if (hasCloseManyFilters(options.list, options.status)) {\n    return;\n  }\n  throw new PmCliError(\n    `close-many requires at least one filter to scope the close (for example: ${CLOSE_MANY_FILTER_GUIDANCE}). Refusing to match every item.`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction sortCloseManyMatchedItems(matched: ListedItem[], parentByChild: Map<string, string>): ListedItem[] {\n  const depthCache = new Map<string, number>();\n  return [...matched].sort((left, right) => {\n    const depthDelta = hierarchyDepth(right.id, parentByChild, depthCache) - hierarchyDepth(left.id, parentByChild, depthCache);\n    return depthDelta !== 0 ? depthDelta : left.id.localeCompare(right.id);\n  });\n}\n\nfunction canCloseManyItem(\n  item: ListedItem,\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>,\n  force: boolean,\n): boolean {\n  return force || !isTerminalStatus(item.status, statusRegistry);\n}\n\nfunction resolveCloseManyPlannedIds(\n  matched: ListedItem[],\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>,\n  force: boolean,\n): Set<string> {\n  return new Set(matched.filter((item) => canCloseManyItem(item, statusRegistry, force)).map((item) => item.id));\n}\n\nasync function buildCloseManyPlanContext(params: {\n  pmRoot: string;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  options: CloseManyCommandOptions;\n  global: GlobalOptions;\n}): Promise<CloseManyPlanContext> {\n  assertCloseManyHasFilters(params.options);\n  const statusRegistry = resolveRuntimeStatusRegistry(params.settings.schema);\n  const reason = resolveReason(params.options.reason, params.settings.governance.require_close_reason);\n  const force = params.options.force === true;\n  const listed = await runList(params.options.status, activeListOptions(params.options.list), params.global);\n  const { childrenByParent, parentByChild } = await buildActiveChildrenByParent(params.pmRoot, params.settings);\n  const matched = sortCloseManyMatchedItems(listed.items as ListedItem[], parentByChild);\n  const closePlannedIds = resolveCloseManyPlannedIds(matched, statusRegistry, force);\n  return {\n    pmRoot: params.pmRoot,\n    settings: params.settings,\n    statusRegistry,\n    reason,\n    validateCloseMode: params.options.validateClose,\n    force,\n    listed,\n    matched,\n    planRows: planCloseManyRows(matched, childrenByParent, closePlannedIds, statusRegistry, force),\n  };\n}\n\nfunction buildCloseManyDryRunResult(context: CloseManyPlanContext): CloseManyResult {\n  return {\n    mode: \"dry_run\",\n    matched_count: context.matched.length,\n    dry_run: true,\n    ...(context.reason !== undefined ? { reason: context.reason } : {}),\n    filters: context.listed.filters,\n    ...(context.validateCloseMode ? { validate_close: context.validateCloseMode } : {}),\n    item_plans: context.planRows,\n    ids: [],\n  };\n}\n\nasync function resolveCloseManyCheckpointInfo(params: {\n  context: CloseManyPlanContext;\n  options: CloseManyCommandOptions;\n  closableIds: Set<string>;\n  checkpointId: string;\n  nowValue: string;\n}): Promise<CloseManyResult[\"checkpoint\"]> {\n  if (params.options.checkpoint === false || params.closableIds.size === 0) {\n    return undefined;\n  }\n  const checkpointItems: MutationCheckpointItem[] = params.context.matched\n    .filter((item) => params.closableIds.has(item.id))\n    .map((item) => ({ id: item.id, target_updated_at: item.updated_at }));\n  return writeCloseManyCheckpoint({\n    pmRoot: params.context.pmRoot,\n    checkpointId: params.checkpointId,\n    nowValue: params.nowValue,\n    options: params.options,\n    reason: params.context.reason,\n    filters: params.context.listed.filters,\n    checkpointItems,\n  });\n}\n\n/**\n * Implements run close many for the public runtime surface of this module.\n */\nexport async function runCloseMany(options: CloseManyCommandOptions, global: GlobalOptions): Promise<CloseManyResult> {\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\n  const dryRun = options.dryRun === true;\n  const rollbackId = resolveCloseManyRollbackId(options);\n  rejectBlankIdsFilter(options.list);\n\n  if (rollbackId !== undefined) {\n    validateCloseManyRollbackOptions(options, rollbackId);\n    return runCloseManyRollback({ pmRoot, rollbackId, options, global });\n  }\n\n  const context = await buildCloseManyPlanContext({ pmRoot, settings, options, global });\n\n  if (dryRun) {\n    return buildCloseManyDryRunResult(context);\n  }\n\n  const closableIds = new Set(context.planRows.filter((row) => row.action === \"close\").map((row) => row.id));\n  const nowValue = nowIso();\n  const checkpointId = createCheckpointId(CLOSE_MANY_CHECKPOINT_SUBDIR, nowValue);\n  const checkpointInfo = await resolveCloseManyCheckpointInfo({ context, options, closableIds, checkpointId, nowValue });\n\n  const closeOptions: CloseCommandOptions = {\n    author: options.author,\n    message: options.message ?? `close-many apply ${checkpointId}`,\n    validateClose: context.validateCloseMode,\n    force: context.force,\n    resolution: options.resolution,\n    expectedResult: options.expectedResult,\n    actualResult: options.actualResult,\n  };\n\n  const { rows, closedIds } = await applyCloseManyRows({\n    matched: context.matched,\n    closableIds,\n    reason: context.reason,\n    closeOptions,\n    global,\n  });\n\n  return {\n    mode: \"apply\",\n    matched_count: context.matched.length,\n    dry_run: false,\n    ...(context.reason !== undefined ? { reason: context.reason } : {}),\n    filters: context.listed.filters,\n    ...(context.validateCloseMode ? { validate_close: context.validateCloseMode } : {}),\n    ...(checkpointInfo ? { checkpoint: checkpointInfo } : {}),\n    closed_count: rows.filter((row) => row.status === \"closed\").length,\n    skipped_count: rows.filter((row) => row.status === \"skipped\").length,\n    failed_count: rows.filter((row) => row.status === \"failed\").length,\n    rows,\n    ids: closedIds,\n  };\n}\n\nexport const _testOnly = {\n  activeListOptions,\n  buildActiveChildrenByParent,\n  hasCloseManyFilters,\n  hasCloseManyRollbackConflicts,\n  hierarchyDepth,\n  rejectBlankIdsFilter,\n  resolveReason,\n};\n"],"names":[],"mappings":"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","debugId":"36947f0b-c1fc-5c0e-8d0e-bd968315cecc"}

package/dist/cli-bundle/chunks/{close-many-7KLOSYLP.js → close-many-OMZIGZB4.js}

@@ -3,49 +3,52 @@ import {
   loadMutationCheckpoint,
   restoreCheckpointItems,
   writeMutationCheckpoint
-} from "./chunk-GUYNUXQT.js";
+} from "./chunk-YQMMMONE.js";
 import {
   runRestore
-} from "./chunk-K5DT2YKM.js";
+} from "./chunk-ABRA3BHY.js";
 import {
   resolveAuthor
 } from "./chunk-WW4E2DC3.js";
+import "./chunk-3Y4OESPP.js";
+import "./chunk-D3UCE7RW.js";
 import {
   runClose
-} from "./chunk-WRYERRZX.js";
+} from "./chunk-FGQKEDE4.js";
 import {
   hasListFilters
 } from "./chunk-4BU75MF4.js";
-import "./chunk-SU3TB4NS.js";
-import "./chunk-Z5F6XZXE.js";
-import "./chunk-T4XBKJ3F.js";
+import "./chunk-YOF5VPKM.js";
 import {
   runList
-} from "./chunk-ZFTKYWIF.js";
+} from "./chunk-7EQNAZX2.js";
 import "./chunk-R23CSHGI.js";
-import "./chunk-YVKZ3ANP.js";
-import "./chunk-4PFVUUYV.js";
+import "./chunk-RX3HQSYG.js";
+import "./chunk-EEY54JMF.js";
 import {
   listAllFrontMatterLight
-} from "./chunk-6KRFL33E.js";
+} from "./chunk-3U3VEWK6.js";
 import {
   isTerminalStatus
-} from "./chunk-3W2HJKJX.js";
+} from "./chunk-EZFKWSC7.js";
 import {
   nowIso
-} from "./chunk-AJHYQCBJ.js";
+} from "./chunk-DRBV5UC2.js";
 import {
-  EXIT_CODE,
   PmCliError,
   getActiveExtensionRegistrations,
+  readSettings
+} from "./chunk-P5YORJRH.js";
+import "./chunk-7C2O74AE.js";
+import {
+  EXIT_CODE,
   getSettingsPath,
   pathExists,
-  readSettings,
   resolveItemTypeRegistry,
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   toErrorMessage
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-5VVUKE3U.js";
 
 // dist/cli/commands/close-many.js
 !(function() {
@@ -394,4 +397,4 @@ export {
   _testOnly,
   runCloseMany
 };
-//# sourceMappingURL=close-many-7KLOSYLP.js.map
+//# sourceMappingURL=close-many-OMZIGZB4.js.map

package/dist/cli-bundle/chunks/{close-many-7KLOSYLP.js.map → close-many-OMZIGZB4.js.map}

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/close-many.ts"],
   "sourcesContent": ["/**\n * @module cli/commands/close-many\n *\n * Implements the pm close 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 { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } 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 { resolveAuthor } from \"../../core/shared/author.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { listAllFrontMatterLight } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { runClose, type CloseCommandOptions } from \"./close.js\";\nimport { hasListFilters } from \"./list-filter-shared.js\";\nimport { runList, type ListOptions, type ListedItem } from \"./list.js\";\nimport { runRestore } from \"./restore.js\";\n\nconst CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;\nconst CLOSE_MANY_CHECKPOINT_SUBDIR = \"close-many\";\n\nconst CLOSE_MANY_FILTER_GUIDANCE = [\n  \"--filter-status\",\n  \"--filter-type\",\n  \"--filter-tag\",\n  \"--filter-priority\",\n  \"--filter-sprint\",\n  \"--filter-release\",\n  \"--filter-parent\",\n  \"--filter-assignee\",\n  \"--filter-updated-before\",\n  \"--ids\",\n].join(\", \");\n\n/**\n * Documents the close many command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseManyCommandOptions {\n  status?: string;\n  list?: ListOptions;\n  reason?: string;\n  resolution?: string;\n  expectedResult?: string;\n  actualResult?: string;\n  validateClose?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  dryRun?: boolean;\n  rollback?: string;\n  checkpoint?: boolean;\n}\n\ninterface CloseManyPlanRow {\n  id: string;\n  title: string;\n  status: string;\n  action: \"close\" | \"skip\";\n  skip_reason?: string;\n  active_child_ids?: string[];\n}\n\ninterface CloseManyApplyRow {\n  id: string;\n  status: \"closed\" | \"skipped\" | \"failed\";\n  skip_reason?: string;\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\ninterface CloseManyPlanContext {\n  pmRoot: string;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>;\n  reason: string | undefined;\n  validateCloseMode: string | undefined;\n  force: boolean;\n  listed: Awaited<ReturnType<typeof runList>>;\n  matched: ListedItem[];\n  planRows: CloseManyPlanRow[];\n}\n\n/**\n * Documents the close many result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseManyResult {\n  mode: \"dry_run\" | \"apply\" | \"rollback\";\n  matched_count: number;\n  dry_run: boolean;\n  reason?: string;\n  filters?: Record<string, unknown>;\n  validate_close?: string;\n  item_plans?: CloseManyPlanRow[];\n  checkpoint?: {\n    id: string;\n    created_at: string;\n    path: string;\n    rollback_command: string;\n  };\n  closed_count?: number;\n  skipped_count?: number;\n  failed_count?: number;\n  restored_count?: number;\n  rollback_checkpoint_id?: string;\n  rows?: CloseManyApplyRow[] | Array<{ id: string; status: \"restored\" | \"failed\"; changed_fields?: string[]; warnings?: string[]; error?: string }>;\n  ids: string[];\n}\n\nfunction hasCloseManyFilters(list: ListOptions | undefined, status: string | undefined): boolean {\n  return hasListFilters(list, status, { includePagination: false });\n}\n\nfunction hasCloseManyRollbackConflicts(list: ListOptions | undefined, status: string | undefined): boolean {\n  return hasListFilters(list, status);\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\nfunction activeListOptions(list: ListOptions | undefined): ListOptions {\n  const active: ListOptions = {};\n  if (!list) {\n    return active;\n  }\n  for (const [key, value] of Object.entries(list) as Array<[keyof ListOptions, unknown]>) {\n    if (value == null || (typeof value === \"string\" && !value.split(\",\").some((entry) => entry.trim().length > 0))) {\n      continue;\n    }\n    (active as Record<string, unknown>)[key] = value;\n  }\n  return active;\n}\n\nfunction resolveReason(reason: unknown, required: boolean): string | undefined {\n  const trimmed = String(reason ?? \"\").trim();\n  if (trimmed.length > 0) {\n    return trimmed;\n  }\n  if (required) {\n    throw new PmCliError(\n      \"pm close-many requires a shared close reason via --reason because governance.require_close_reason is enabled.\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"close_reason_required\",\n        required: \"Provide a shared closing summary via --reason for the whole batch.\",\n        why: \"governance.require_close_reason is enabled, so every close must record why the items are done.\",\n        examples: [\n          'pm close-many --filter-sprint S-12 --reason \"Sprint S-12 acceptance criteria met\"',\n          'pm close-many --ids pm-a,pm-b --reason \"Superseded by redesign\"',\n        ],\n        nextSteps: [\n          \"Re-run with --reason describing the shared outcome.\",\n          \"To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled\",\n        ],\n      },\n    );\n  }\n  return undefined;\n}\n\n// Build a parent -> non-terminal child id map in a single light scan so each\n// matched parent can be annotated with the active children that closing it\n// would orphan (the same signal runClose surfaces per item on apply).\nasync function buildActiveChildrenByParent(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n): Promise<{ childrenByParent: Map<string, string[]>; parentByChild: Map<string, string> }> {\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const items = await listAllFrontMatterLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  const childrenByParent = new Map<string, string[]>();\n  const parentByChild = new Map<string, string>();\n  for (const item of items) {\n    if (typeof item.parent !== \"string\" || item.parent.length === 0) {\n      continue;\n    }\n    parentByChild.set(item.id, item.parent);\n    if (isTerminalStatus(item.status, statusRegistry)) {\n      continue;\n    }\n    const existing = childrenByParent.get(item.parent);\n    if (existing) {\n      existing.push(item.id);\n    } else {\n      childrenByParent.set(item.parent, [item.id]);\n    }\n  }\n  for (const ids of childrenByParent.values()) {\n    ids.sort((left, right) => left.localeCompare(right));\n  }\n  return { childrenByParent, parentByChild };\n}\n\nfunction hierarchyDepth(id: string, parentByChild: Map<string, string>, cache?: Map<string, number>): number {\n  const cached = cache?.get(id);\n  if (cached !== undefined) {\n    return cached;\n  }\n  let depth = 0;\n  let current = parentByChild.get(id);\n  const path: string[] = [];\n  const visited = new Set<string>();\n  let hasCycle = false;\n  while (current !== undefined && !visited.has(current)) {\n    const cachedCurrent = cache?.get(current);\n    if (cachedCurrent !== undefined) {\n      depth += cachedCurrent + 1;\n      break;\n    }\n    visited.add(current);\n    path.push(current);\n    depth += 1;\n    current = parentByChild.get(current);\n  }\n  if (current !== undefined && visited.has(current)) {\n    hasCycle = true;\n  }\n  if (!hasCycle) {\n    cache?.set(id, depth);\n    for (const [index, ancestorId] of path.entries()) {\n      cache?.set(ancestorId, depth - index - 1);\n    }\n  }\n  return depth;\n}\n\nasync function runCloseManyRollback(params: {\n  pmRoot: string;\n  rollbackId: string;\n  options: CloseManyCommandOptions;\n  global: GlobalOptions;\n}): Promise<CloseManyResult> {\n  const checkpoint = await loadMutationCheckpoint(\n    params.pmRoot,\n    CLOSE_MANY_CHECKPOINT_SUBDIR,\n    params.rollbackId,\n    CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,\n  );\n  const restoreMessage = params.options.message ?? `Rollback close-many checkpoint ${checkpoint.id}`;\n  const rollback = await restoreCheckpointItems(checkpoint.items, (id, targetUpdatedAt) =>\n    runRestore(id, targetUpdatedAt, { author: params.options.author, message: restoreMessage, force: true }, params.global),\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 close-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\nfunction planCloseManyRows(\n  matched: ListedItem[],\n  childrenByParent: Map<string, string[]>,\n  closePlannedIds: Set<string>,\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>,\n  force: boolean,\n): CloseManyPlanRow[] {\n  return matched.map((item) => {\n    const activeChildIds = (childrenByParent.get(item.id) ?? []).filter((childId) => !closePlannedIds.has(childId));\n    const willSkip = !canCloseManyItem(item, statusRegistry, force);\n    return {\n      id: item.id,\n      title: typeof item.title === \"string\" ? item.title : \"\",\n      status: item.status,\n      action: willSkip ? \"skip\" : \"close\",\n      ...(willSkip ? { skip_reason: \"already_terminal\" } : {}),\n      ...(activeChildIds.length > 0 ? { active_child_ids: activeChildIds } : {}),\n    };\n  });\n}\n\nasync function writeCloseManyCheckpoint(params: {\n  pmRoot: string;\n  checkpointId: string;\n  nowValue: string;\n  options: CloseManyCommandOptions;\n  reason: string | undefined;\n  filters: Record<string, unknown>;\n  checkpointItems: MutationCheckpointItem[];\n}): Promise<CloseManyResult[\"checkpoint\"]> {\n  const checkpointPath = await writeMutationCheckpoint(params.pmRoot, CLOSE_MANY_CHECKPOINT_SUBDIR, params.checkpointId, {\n    schema_version: CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    author: resolveAuthor(params.options.author, \"unknown\"),\n    ...(params.reason !== undefined ? { reason: params.reason } : {}),\n    filters: params.filters,\n    items: params.checkpointItems,\n  });\n  return {\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    path: checkpointPath,\n    rollback_command: `pm close-many --rollback ${params.checkpointId}`,\n  };\n}\n\nasync function applyCloseManyRows(params: {\n  matched: ListedItem[];\n  closableIds: Set<string>;\n  reason: string | undefined;\n  closeOptions: CloseCommandOptions;\n  global: GlobalOptions;\n}): Promise<{ rows: CloseManyApplyRow[]; closedIds: string[] }> {\n  const rows: CloseManyApplyRow[] = [];\n  const closedIds: string[] = [];\n  for (const item of params.matched) {\n    if (!params.closableIds.has(item.id)) {\n      rows.push({ id: item.id, status: \"skipped\", skip_reason: \"already_terminal\" });\n      continue;\n    }\n    try {\n      const result = await runClose(item.id, params.reason, params.closeOptions, params.global);\n      rows.push({\n        id: item.id,\n        status: \"closed\",\n        changed_fields: result.changed_fields,\n        ...(result.warnings && result.warnings.length > 0 ? { warnings: result.warnings } : {}),\n      });\n      closedIds.push(item.id);\n    } catch (error: unknown) {\n      rows.push({ id: item.id, status: \"failed\", error: toErrorMessage(error) });\n    }\n  }\n  return { rows, closedIds };\n}\n\nfunction resolveCloseManyRollbackId(options: CloseManyCommandOptions): string | undefined {\n  return typeof options.rollback === \"string\" ? options.rollback : undefined;\n}\n\nfunction validateCloseManyRollbackOptions(options: CloseManyCommandOptions, rollbackId: string): void {\n  if (rollbackId.trim().length === 0) {\n    throw new PmCliError(\"--rollback requires a checkpoint id\", EXIT_CODE.USAGE);\n  }\n  if (options.dryRun === true) {\n    throw new PmCliError(\"--dry-run cannot be combined with --rollback\", EXIT_CODE.USAGE);\n  }\n  if (hasCloseManyRollbackConflicts(options.list, options.status)) {\n    throw new PmCliError(\"Rollback mode does not accept filter options\", EXIT_CODE.USAGE);\n  }\n}\n\nfunction assertCloseManyHasFilters(options: CloseManyCommandOptions): void {\n  if (hasCloseManyFilters(options.list, options.status)) {\n    return;\n  }\n  throw new PmCliError(\n    `close-many requires at least one filter to scope the close (for example: ${CLOSE_MANY_FILTER_GUIDANCE}). Refusing to match every item.`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction sortCloseManyMatchedItems(matched: ListedItem[], parentByChild: Map<string, string>): ListedItem[] {\n  const depthCache = new Map<string, number>();\n  return [...matched].sort((left, right) => {\n    const depthDelta = hierarchyDepth(right.id, parentByChild, depthCache) - hierarchyDepth(left.id, parentByChild, depthCache);\n    return depthDelta !== 0 ? depthDelta : left.id.localeCompare(right.id);\n  });\n}\n\nfunction canCloseManyItem(\n  item: ListedItem,\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>,\n  force: boolean,\n): boolean {\n  return force || !isTerminalStatus(item.status, statusRegistry);\n}\n\nfunction resolveCloseManyPlannedIds(\n  matched: ListedItem[],\n  statusRegistry: ReturnType<typeof resolveRuntimeStatusRegistry>,\n  force: boolean,\n): Set<string> {\n  return new Set(matched.filter((item) => canCloseManyItem(item, statusRegistry, force)).map((item) => item.id));\n}\n\nasync function buildCloseManyPlanContext(params: {\n  pmRoot: string;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  options: CloseManyCommandOptions;\n  global: GlobalOptions;\n}): Promise<CloseManyPlanContext> {\n  assertCloseManyHasFilters(params.options);\n  const statusRegistry = resolveRuntimeStatusRegistry(params.settings.schema);\n  const reason = resolveReason(params.options.reason, params.settings.governance.require_close_reason);\n  const force = params.options.force === true;\n  const listed = await runList(params.options.status, activeListOptions(params.options.list), params.global);\n  const { childrenByParent, parentByChild } = await buildActiveChildrenByParent(params.pmRoot, params.settings);\n  const matched = sortCloseManyMatchedItems(listed.items as ListedItem[], parentByChild);\n  const closePlannedIds = resolveCloseManyPlannedIds(matched, statusRegistry, force);\n  return {\n    pmRoot: params.pmRoot,\n    settings: params.settings,\n    statusRegistry,\n    reason,\n    validateCloseMode: params.options.validateClose,\n    force,\n    listed,\n    matched,\n    planRows: planCloseManyRows(matched, childrenByParent, closePlannedIds, statusRegistry, force),\n  };\n}\n\nfunction buildCloseManyDryRunResult(context: CloseManyPlanContext): CloseManyResult {\n  return {\n    mode: \"dry_run\",\n    matched_count: context.matched.length,\n    dry_run: true,\n    ...(context.reason !== undefined ? { reason: context.reason } : {}),\n    filters: context.listed.filters,\n    ...(context.validateCloseMode ? { validate_close: context.validateCloseMode } : {}),\n    item_plans: context.planRows,\n    ids: [],\n  };\n}\n\nasync function resolveCloseManyCheckpointInfo(params: {\n  context: CloseManyPlanContext;\n  options: CloseManyCommandOptions;\n  closableIds: Set<string>;\n  checkpointId: string;\n  nowValue: string;\n}): Promise<CloseManyResult[\"checkpoint\"]> {\n  if (params.options.checkpoint === false || params.closableIds.size === 0) {\n    return undefined;\n  }\n  const checkpointItems: MutationCheckpointItem[] = params.context.matched\n    .filter((item) => params.closableIds.has(item.id))\n    .map((item) => ({ id: item.id, target_updated_at: item.updated_at }));\n  return writeCloseManyCheckpoint({\n    pmRoot: params.context.pmRoot,\n    checkpointId: params.checkpointId,\n    nowValue: params.nowValue,\n    options: params.options,\n    reason: params.context.reason,\n    filters: params.context.listed.filters,\n    checkpointItems,\n  });\n}\n\n/**\n * Implements run close many for the public runtime surface of this module.\n */\nexport async function runCloseMany(options: CloseManyCommandOptions, global: GlobalOptions): Promise<CloseManyResult> {\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\n  const dryRun = options.dryRun === true;\n  const rollbackId = resolveCloseManyRollbackId(options);\n  rejectBlankIdsFilter(options.list);\n\n  if (rollbackId !== undefined) {\n    validateCloseManyRollbackOptions(options, rollbackId);\n    return runCloseManyRollback({ pmRoot, rollbackId, options, global });\n  }\n\n  const context = await buildCloseManyPlanContext({ pmRoot, settings, options, global });\n\n  if (dryRun) {\n    return buildCloseManyDryRunResult(context);\n  }\n\n  const closableIds = new Set(context.planRows.filter((row) => row.action === \"close\").map((row) => row.id));\n  const nowValue = nowIso();\n  const checkpointId = createCheckpointId(CLOSE_MANY_CHECKPOINT_SUBDIR, nowValue);\n  const checkpointInfo = await resolveCloseManyCheckpointInfo({ context, options, closableIds, checkpointId, nowValue });\n\n  const closeOptions: CloseCommandOptions = {\n    author: options.author,\n    message: options.message ?? `close-many apply ${checkpointId}`,\n    validateClose: context.validateCloseMode,\n    force: context.force,\n    resolution: options.resolution,\n    expectedResult: options.expectedResult,\n    actualResult: options.actualResult,\n  };\n\n  const { rows, closedIds } = await applyCloseManyRows({\n    matched: context.matched,\n    closableIds,\n    reason: context.reason,\n    closeOptions,\n    global,\n  });\n\n  return {\n    mode: \"apply\",\n    matched_count: context.matched.length,\n    dry_run: false,\n    ...(context.reason !== undefined ? { reason: context.reason } : {}),\n    filters: context.listed.filters,\n    ...(context.validateCloseMode ? { validate_close: context.validateCloseMode } : {}),\n    ...(checkpointInfo ? { checkpoint: checkpointInfo } : {}),\n    closed_count: rows.filter((row) => row.status === \"closed\").length,\n    skipped_count: rows.filter((row) => row.status === \"skipped\").length,\n    failed_count: rows.filter((row) => row.status === \"failed\").length,\n    rows,\n    ids: closedIds,\n  };\n}\n\nexport const _testOnly = {\n  activeListOptions,\n  buildActiveChildrenByParent,\n  hasCloseManyFilters,\n  hasCloseManyRollbackConflicts,\n  hierarchyDepth,\n  rejectBlankIdsFilter,\n  resolveReason,\n};\n"],
-  "mappings": "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",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,IAAM,uCAAuC;AAC7C,IAAM,+BAA+B;AAErC,IAAM,6BAA6B;EACjC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,KAAK,IAAI;AA6EX,SAAS,oBAAoB,MAA+B,QAA0B;AACpF,SAAO,eAAe,MAAM,QAAQ,EAAE,mBAAmB,MAAK,CAAE;AAClE;AAEA,SAAS,8BAA8B,MAA+B,QAA0B;AAC9F,SAAO,eAAe,MAAM,MAAM;AACpC;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;AAEA,SAAS,kBAAkB,MAA6B;AACtD,QAAM,SAAsB,CAAA;AAC5B,MAAI,CAAC,MAAM;AACT,WAAO;EACT;AACA,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAA0C;AACtF,QAAI,SAAS,QAAS,OAAO,UAAU,YAAY,CAAC,MAAM,MAAM,GAAG,EAAE,KAAK,CAAC,UAAU,MAAM,KAAI,EAAG,SAAS,CAAC,GAAI;AAC9G;IACF;AACC,WAAmC,GAAG,IAAI;EAC7C;AACA,SAAO;AACT;AAEA,SAAS,cAAc,QAAiB,UAAiB;AACvD,QAAM,UAAU,OAAO,UAAU,EAAE,EAAE,KAAI;AACzC,MAAI,QAAQ,SAAS,GAAG;AACtB,WAAO;EACT;AACA,MAAI,UAAU;AACZ,UAAM,IAAI,WACR,iHACA,UAAU,OACV;MACE,MAAM;MACN,UAAU;MACV,KAAK;MACL,UAAU;QACR;QACA;;MAEF,WAAW;QACT;QACA;;KAEH;EAEL;AACA,SAAO;AACT;AAKA,eAAe,4BACb,QACA,UAAkD;AAElD,QAAM,iBAAiB,6BAA6B,SAAS,MAAM;AACnE,QAAM,eAAe,wBAAwB,UAAU,gCAA+B,CAAE;AACxF,QAAM,QAAQ,MAAM,wBAClB,QACA,SAAS,aACT,aAAa,gBACb,QACA,SAAS,MAAM;AAEjB,QAAM,mBAAmB,oBAAI,IAAG;AAChC,QAAM,gBAAgB,oBAAI,IAAG;AAC7B,aAAW,QAAQ,OAAO;AACxB,QAAI,OAAO,KAAK,WAAW,YAAY,KAAK,OAAO,WAAW,GAAG;AAC/D;IACF;AACA,kBAAc,IAAI,KAAK,IAAI,KAAK,MAAM;AACtC,QAAI,iBAAiB,KAAK,QAAQ,cAAc,GAAG;AACjD;IACF;AACA,UAAM,WAAW,iBAAiB,IAAI,KAAK,MAAM;AACjD,QAAI,UAAU;AACZ,eAAS,KAAK,KAAK,EAAE;IACvB,OAAO;AACL,uBAAiB,IAAI,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC7C;EACF;AACA,aAAW,OAAO,iBAAiB,OAAM,GAAI;AAC3C,QAAI,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC;EACrD;AACA,SAAO,EAAE,kBAAkB,cAAa;AAC1C;AAEA,SAAS,eAAe,IAAY,eAAoC,OAA2B;AACjG,QAAM,SAAS,OAAO,IAAI,EAAE;AAC5B,MAAI,WAAW,QAAW;AACxB,WAAO;EACT;AACA,MAAI,QAAQ;AACZ,MAAI,UAAU,cAAc,IAAI,EAAE;AAClC,QAAM,OAAiB,CAAA;AACvB,QAAM,UAAU,oBAAI,IAAG;AACvB,MAAI,WAAW;AACf,SAAO,YAAY,UAAa,CAAC,QAAQ,IAAI,OAAO,GAAG;AACrD,UAAM,gBAAgB,OAAO,IAAI,OAAO;AACxC,QAAI,kBAAkB,QAAW;AAC/B,eAAS,gBAAgB;AACzB;IACF;AACA,YAAQ,IAAI,OAAO;AACnB,SAAK,KAAK,OAAO;AACjB,aAAS;AACT,cAAU,cAAc,IAAI,OAAO;EACrC;AACA,MAAI,YAAY,UAAa,QAAQ,IAAI,OAAO,GAAG;AACjD,eAAW;EACb;AACA,MAAI,CAAC,UAAU;AACb,WAAO,IAAI,IAAI,KAAK;AACpB,eAAW,CAAC,OAAO,UAAU,KAAK,KAAK,QAAO,GAAI;AAChD,aAAO,IAAI,YAAY,QAAQ,QAAQ,CAAC;IAC1C;EACF;AACA,SAAO;AACT;AAEA,eAAe,qBAAqB,QAKnC;AACC,QAAM,aAAa,MAAM,uBACvB,OAAO,QACP,8BACA,OAAO,YACP,oCAAoC;AAEtC,QAAM,iBAAiB,OAAO,QAAQ,WAAW,kCAAkC,WAAW,EAAE;AAChG,QAAM,WAAW,MAAM,uBAAuB,WAAW,OAAO,CAAC,IAAI,oBACnE,WAAW,IAAI,iBAAiB,EAAE,QAAQ,OAAO,QAAQ,QAAQ,SAAS,gBAAgB,OAAO,KAAI,GAAI,OAAO,MAAM,CAAC;AAEzH,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,4BAA4B,WAAW,EAAE;;IAE7D,gBAAgB,SAAS,aAAa;IACtC,cAAc,SAAS;IACvB,MAAM,SAAS;IACf,KAAK,SAAS;;AAElB;AAEA,SAAS,kBACP,SACA,kBACA,iBACA,gBACA,OAAc;AAEd,SAAO,QAAQ,IAAI,CAAC,SAAQ;AAC1B,UAAM,kBAAkB,iBAAiB,IAAI,KAAK,EAAE,KAAK,CAAA,GAAI,OAAO,CAAC,YAAY,CAAC,gBAAgB,IAAI,OAAO,CAAC;AAC9G,UAAM,WAAW,CAAC,iBAAiB,MAAM,gBAAgB,KAAK;AAC9D,WAAO;MACL,IAAI,KAAK;MACT,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ;MACrD,QAAQ,KAAK;MACb,QAAQ,WAAW,SAAS;MAC5B,GAAI,WAAW,EAAE,aAAa,mBAAkB,IAAK,CAAA;MACrD,GAAI,eAAe,SAAS,IAAI,EAAE,kBAAkB,eAAc,IAAK,CAAA;;EAE3E,CAAC;AACH;AAEA,eAAe,yBAAyB,QAQvC;AACC,QAAM,iBAAiB,MAAM,wBAAwB,OAAO,QAAQ,8BAA8B,OAAO,cAAc;IACrH,gBAAgB;IAChB,IAAI,OAAO;IACX,YAAY,OAAO;IACnB,QAAQ,cAAc,OAAO,QAAQ,QAAQ,SAAS;IACtD,GAAI,OAAO,WAAW,SAAY,EAAE,QAAQ,OAAO,OAAM,IAAK,CAAA;IAC9D,SAAS,OAAO;IAChB,OAAO,OAAO;GACf;AACD,SAAO;IACL,IAAI,OAAO;IACX,YAAY,OAAO;IACnB,MAAM;IACN,kBAAkB,4BAA4B,OAAO,YAAY;;AAErE;AAEA,eAAe,mBAAmB,QAMjC;AACC,QAAM,OAA4B,CAAA;AAClC,QAAM,YAAsB,CAAA;AAC5B,aAAW,QAAQ,OAAO,SAAS;AACjC,QAAI,CAAC,OAAO,YAAY,IAAI,KAAK,EAAE,GAAG;AACpC,WAAK,KAAK,EAAE,IAAI,KAAK,IAAI,QAAQ,WAAW,aAAa,mBAAkB,CAAE;AAC7E;IACF;AACA,QAAI;AACF,YAAM,SAAS,MAAM,SAAS,KAAK,IAAI,OAAO,QAAQ,OAAO,cAAc,OAAO,MAAM;AACxF,WAAK,KAAK;QACR,IAAI,KAAK;QACT,QAAQ;QACR,gBAAgB,OAAO;QACvB,GAAI,OAAO,YAAY,OAAO,SAAS,SAAS,IAAI,EAAE,UAAU,OAAO,SAAQ,IAAK,CAAA;OACrF;AACD,gBAAU,KAAK,KAAK,EAAE;IACxB,SAAS,OAAgB;AACvB,WAAK,KAAK,EAAE,IAAI,KAAK,IAAI,QAAQ,UAAU,OAAO,eAAe,KAAK,EAAC,CAAE;IAC3E;EACF;AACA,SAAO,EAAE,MAAM,UAAS;AAC1B;AAEA,SAAS,2BAA2B,SAAgC;AAClE,SAAO,OAAO,QAAQ,aAAa,WAAW,QAAQ,WAAW;AACnE;AAEA,SAAS,iCAAiC,SAAkC,YAAkB;AAC5F,MAAI,WAAW,KAAI,EAAG,WAAW,GAAG;AAClC,UAAM,IAAI,WAAW,uCAAuC,UAAU,KAAK;EAC7E;AACA,MAAI,QAAQ,WAAW,MAAM;AAC3B,UAAM,IAAI,WAAW,gDAAgD,UAAU,KAAK;EACtF;AACA,MAAI,8BAA8B,QAAQ,MAAM,QAAQ,MAAM,GAAG;AAC/D,UAAM,IAAI,WAAW,gDAAgD,UAAU,KAAK;EACtF;AACF;AAEA,SAAS,0BAA0B,SAAgC;AACjE,MAAI,oBAAoB,QAAQ,MAAM,QAAQ,MAAM,GAAG;AACrD;EACF;AACA,QAAM,IAAI,WACR,4EAA4E,0BAA0B,oCACtG,UAAU,KAAK;AAEnB;AAEA,SAAS,0BAA0B,SAAuB,eAAkC;AAC1F,QAAM,aAAa,oBAAI,IAAG;AAC1B,SAAO,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,UAAS;AACvC,UAAM,aAAa,eAAe,MAAM,IAAI,eAAe,UAAU,IAAI,eAAe,KAAK,IAAI,eAAe,UAAU;AAC1H,WAAO,eAAe,IAAI,aAAa,KAAK,GAAG,cAAc,MAAM,EAAE;EACvE,CAAC;AACH;AAEA,SAAS,iBACP,MACA,gBACA,OAAc;AAEd,SAAO,SAAS,CAAC,iBAAiB,KAAK,QAAQ,cAAc;AAC/D;AAEA,SAAS,2BACP,SACA,gBACA,OAAc;AAEd,SAAO,IAAI,IAAI,QAAQ,OAAO,CAAC,SAAS,iBAAiB,MAAM,gBAAgB,KAAK,CAAC,EAAE,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC;AAC/G;AAEA,eAAe,0BAA0B,QAKxC;AACC,4BAA0B,OAAO,OAAO;AACxC,QAAM,iBAAiB,6BAA6B,OAAO,SAAS,MAAM;AAC1E,QAAM,SAAS,cAAc,OAAO,QAAQ,QAAQ,OAAO,SAAS,WAAW,oBAAoB;AACnG,QAAM,QAAQ,OAAO,QAAQ,UAAU;AACvC,QAAM,SAAS,MAAM,QAAQ,OAAO,QAAQ,QAAQ,kBAAkB,OAAO,QAAQ,IAAI,GAAG,OAAO,MAAM;AACzG,QAAM,EAAE,kBAAkB,cAAa,IAAK,MAAM,4BAA4B,OAAO,QAAQ,OAAO,QAAQ;AAC5G,QAAM,UAAU,0BAA0B,OAAO,OAAuB,aAAa;AACrF,QAAM,kBAAkB,2BAA2B,SAAS,gBAAgB,KAAK;AACjF,SAAO;IACL,QAAQ,OAAO;IACf,UAAU,OAAO;IACjB;IACA;IACA,mBAAmB,OAAO,QAAQ;IAClC;IACA;IACA;IACA,UAAU,kBAAkB,SAAS,kBAAkB,iBAAiB,gBAAgB,KAAK;;AAEjG;AAEA,SAAS,2BAA2B,SAA6B;AAC/D,SAAO;IACL,MAAM;IACN,eAAe,QAAQ,QAAQ;IAC/B,SAAS;IACT,GAAI,QAAQ,WAAW,SAAY,EAAE,QAAQ,QAAQ,OAAM,IAAK,CAAA;IAChE,SAAS,QAAQ,OAAO;IACxB,GAAI,QAAQ,oBAAoB,EAAE,gBAAgB,QAAQ,kBAAiB,IAAK,CAAA;IAChF,YAAY,QAAQ;IACpB,KAAK,CAAA;;AAET;AAEA,eAAe,+BAA+B,QAM7C;AACC,MAAI,OAAO,QAAQ,eAAe,SAAS,OAAO,YAAY,SAAS,GAAG;AACxE,WAAO;EACT;AACA,QAAM,kBAA4C,OAAO,QAAQ,QAC9D,OAAO,CAAC,SAAS,OAAO,YAAY,IAAI,KAAK,EAAE,CAAC,EAChD,IAAI,CAAC,UAAU,EAAE,IAAI,KAAK,IAAI,mBAAmB,KAAK,WAAU,EAAG;AACtE,SAAO,yBAAyB;IAC9B,QAAQ,OAAO,QAAQ;IACvB,cAAc,OAAO;IACrB,UAAU,OAAO;IACjB,SAAS,OAAO;IAChB,QAAQ,OAAO,QAAQ;IACvB,SAAS,OAAO,QAAQ,OAAO;IAC/B;GACD;AACH;AAKA,eAAsB,aAAa,SAAkCA,SAAqB;AACxF,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAIA,QAAO,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;AAE1C,QAAM,SAAS,QAAQ,WAAW;AAClC,QAAM,aAAa,2BAA2B,OAAO;AACrD,uBAAqB,QAAQ,IAAI;AAEjC,MAAI,eAAe,QAAW;AAC5B,qCAAiC,SAAS,UAAU;AACpD,WAAO,qBAAqB,EAAE,QAAQ,YAAY,SAAS,QAAAA,QAAM,CAAE;EACrE;AAEA,QAAM,UAAU,MAAM,0BAA0B,EAAE,QAAQ,UAAU,SAAS,QAAAA,QAAM,CAAE;AAErF,MAAI,QAAQ;AACV,WAAO,2BAA2B,OAAO;EAC3C;AAEA,QAAM,cAAc,IAAI,IAAI,QAAQ,SAAS,OAAO,CAAC,QAAQ,IAAI,WAAW,OAAO,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;AACzG,QAAM,WAAW,OAAM;AACvB,QAAM,eAAe,mBAAmB,8BAA8B,QAAQ;AAC9E,QAAM,iBAAiB,MAAM,+BAA+B,EAAE,SAAS,SAAS,aAAa,cAAc,SAAQ,CAAE;AAErH,QAAM,eAAoC;IACxC,QAAQ,QAAQ;IAChB,SAAS,QAAQ,WAAW,oBAAoB,YAAY;IAC5D,eAAe,QAAQ;IACvB,OAAO,QAAQ;IACf,YAAY,QAAQ;IACpB,gBAAgB,QAAQ;IACxB,cAAc,QAAQ;;AAGxB,QAAM,EAAE,MAAM,UAAS,IAAK,MAAM,mBAAmB;IACnD,SAAS,QAAQ;IACjB;IACA,QAAQ,QAAQ;IAChB;IACA,QAAAA;GACD;AAED,SAAO;IACL,MAAM;IACN,eAAe,QAAQ,QAAQ;IAC/B,SAAS;IACT,GAAI,QAAQ,WAAW,SAAY,EAAE,QAAQ,QAAQ,OAAM,IAAK,CAAA;IAChE,SAAS,QAAQ,OAAO;IACxB,GAAI,QAAQ,oBAAoB,EAAE,gBAAgB,QAAQ,kBAAiB,IAAK,CAAA;IAChF,GAAI,iBAAiB,EAAE,YAAY,eAAc,IAAK,CAAA;IACtD,cAAc,KAAK,OAAO,CAAC,QAAQ,IAAI,WAAW,QAAQ,EAAE;IAC5D,eAAe,KAAK,OAAO,CAAC,QAAQ,IAAI,WAAW,SAAS,EAAE;IAC9D,cAAc,KAAK,OAAO,CAAC,QAAQ,IAAI,WAAW,QAAQ,EAAE;IAC5D;IACA,KAAK;;AAET;AAEO,IAAM,YAAY;EACvB;EACA;EACA;EACA;EACA;EACA;EACA;;",
   "names": ["global"]
 }

package/dist/cli-bundle/chunks/{comments-DNWHEBOS.js → comments-MIW5MZOX.js}

@@ -1,19 +1,22 @@
 import {
   parseAnnotationTextInput,
   runAnnotationCommand
-} from "./chunk-7LYO6S5A.js";
+} from "./chunk-5J2XPTAD.js";
 import "./chunk-WW4E2DC3.js";
 import {
   createStdinTokenResolver
-} from "./chunk-P5L7Z2O6.js";
-import "./chunk-4PFVUUYV.js";
-import "./chunk-6KRFL33E.js";
-import "./chunk-3W2HJKJX.js";
-import "./chunk-AJHYQCBJ.js";
+} from "./chunk-T3ABIMGW.js";
+import "./chunk-EEY54JMF.js";
+import "./chunk-3U3VEWK6.js";
+import "./chunk-EZFKWSC7.js";
+import "./chunk-DRBV5UC2.js";
 import {
-  EXIT_CODE,
   PmCliError
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-P5YORJRH.js";
+import "./chunk-7C2O74AE.js";
+import {
+  EXIT_CODE
+} from "./chunk-5VVUKE3U.js";
 
 // dist/cli/commands/comments.js
 import { readFile } from "node:fs/promises";
@@ -122,4 +125,4 @@ async function runComments(id, options, global2) {
 export {
   runComments
 };
-//# sourceMappingURL=comments-DNWHEBOS.js.map
+//# sourceMappingURL=comments-MIW5MZOX.js.map

package/dist/cli-bundle/chunks/{comments-DNWHEBOS.js.map → comments-MIW5MZOX.js.map}

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/comments.ts"],
   "sourcesContent": ["/**\n * @module cli/commands/comments\n *\n * Implements the pm comments command surface and its agent-facing runtime behavior.\n */\nimport { readFile } from \"node:fs/promises\";\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 { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { Comment } from \"../../types/index.js\";\nimport { parseAnnotationTextInput, runAnnotationCommand } from \"./annotation-command.js\";\n\n/**\n * Documents the comments command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsCommandOptions {\n  add?: string;\n  stdin?: boolean;\n  file?: string;\n  edit?: number;\n  delete?: number;\n  limit?: string;\n  includeMeta?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  allowAuditComment?: boolean;\n}\n\n/**\n * Documents the comments result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsResult {\n  id: string;\n  comments: Comment[];\n  count: number;\n  total_count?: number;\n  returned_count?: number;\n  has_more?: boolean;\n  limit?: number;\n}\n\ninterface ResolvedCommentInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\nfunction isErrnoError(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveCommentTextSource(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<{ value: string; emptyFlag: string } | undefined> {\n  const hasAdd = options.add !== undefined;\n  const hasStdin = options.stdin === true;\n  const hasFile = typeof options.file === \"string\";\n  const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);\n  if (sourceCount === 0) {\n    return undefined;\n  }\n  if (sourceCount > 1) {\n    throw new PmCliError(\"Specify comment text using only one input source: --add, --stdin, or --file\", EXIT_CODE.USAGE);\n  }\n  if (hasAdd) {\n    const addInput = await stdinResolver.resolveValue(options.add, \"--add\");\n    return { value: addInput ?? \"\", emptyFlag: \"--add\" };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return { value: stdinInput ?? \"\", emptyFlag: \"--stdin\" };\n  }\n  const filePath = (options.file as string).trim();\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    const fileInput = await readFile(filePath, \"utf8\");\n    return { value: fileInput, emptyFlag: \"--file\" };\n  } catch (error: unknown) {\n    if (isErrnoError(error) && error.code === \"ENOENT\") {\n      throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);\n    }\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`Failed to read --file path \"${filePath}\": ${detail}`, EXIT_CODE.USAGE);\n  }\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\n  const hasEdit = options.edit !== undefined;\n  const hasDelete = options.delete !== undefined;\n  if (hasEdit && hasDelete) {\n    throw new PmCliError(\"Specify only one of --edit or --delete\", EXIT_CODE.USAGE);\n  }\n\n  if (hasDelete) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource !== undefined) {\n      throw new PmCliError(\"--delete does not take comment text\", EXIT_CODE.USAGE);\n    }\n    return { mode: \"delete\", index: options.delete };\n  }\n\n  if (hasEdit) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource === undefined) {\n      throw new PmCliError(\n        \"--edit requires replacement text via positional [text], --add, --stdin, or --file\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      mode: \"edit\",\n      index: options.edit,\n      value: textSource.value,\n      emptyFlag: textSource.emptyFlag,\n    };\n  }\n\n  const textSource = await resolveCommentTextSource(options, stdinResolver);\n  if (textSource === undefined) {\n    return { mode: \"list\" };\n  }\n  // Map the single resolved input source back to its add/stdin/file mode so the\n  // caller still knows whether to run plain-text markdown parsing (add-only).\n  const mode = textSource.emptyFlag === \"--add\" ? \"add\" : textSource.emptyFlag === \"--stdin\" ? \"stdin\" : \"file\";\n  return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };\n}\n\n/**\n * Implements run comments for the public runtime surface of this module.\n */\nexport async function runComments(id: string, options: CommentsCommandOptions, global: GlobalOptions): Promise<CommentsResult> {\n  const stdinResolver = createStdinTokenResolver();\n  const commentInput = await resolveCommentInput(options, stdinResolver);\n\n  const shouldParseText = commentInput.mode === \"add\" || commentInput.mode === \"edit\";\n  // list/delete carry no text (value undefined → \"\"); add/edit/stdin/file always\n  // resolve to a string. Normalize once so neither branch below is unreachable.\n  const rawValue = commentInput.value ?? \"\";\n  return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n    input: {\n      ...commentInput,\n      value: shouldParseText ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true }) : rawValue,\n    },\n    collectionKey: \"comments\",\n    op: \"comment_add\",\n    editOp: \"comment_edit\",\n    deleteOp: \"comment_delete\",\n    parseText: (raw) => raw,\n    allowAuditBypass: Boolean(options.allowAuditComment),\n    conflictGuidance: {\n      required:\n        \"For append-only comment audits on another owner's item, prefer --allow-audit-comment before considering --force.\",\n      examples: ['pm comments pm-a1b2 --add \"audit note\" --author \"reviewer\" --allow-audit-comment'],\n      nextSteps: [\n        \"Retry with --allow-audit-comment for append-only audits that do not mutate item metadata beyond comments.\",\n        \"Use --force only when an ownership override is explicitly approved.\",\n      ],\n    },\n  });\n}\n"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["textSource", "global"]
 }

package/dist/cli-bundle/chunks/{comments-RW23R3VE.js → comments-SAG5LSKL.js}

@@ -1,21 +1,24 @@
 
-!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]="2b734356-43f8-55d2-af9c-ea78787f9965")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1e43a26a-213c-5b08-b9d0-20f63724f94a")}catch(e){}}();
 import {
   parseAnnotationTextInput,
   runAnnotationCommand
-} from "./chunk-A3OQ7TFW.js";
+} from "./chunk-JLA7EVYV.js";
 import "./chunk-T5RRNDA7.js";
 import {
   createStdinTokenResolver
-} from "./chunk-JBZ2NTKX.js";
-import "./chunk-YSGTMDWC.js";
-import "./chunk-4WB6S4YX.js";
-import "./chunk-YSDFIY7N.js";
-import "./chunk-CXR3CMBQ.js";
+} from "./chunk-7WYXBPYQ.js";
+import "./chunk-YFIE7YK6.js";
+import "./chunk-57C2RLW5.js";
+import "./chunk-HK72NWAD.js";
+import "./chunk-FJRKQREY.js";
 import {
-  EXIT_CODE,
   PmCliError
-} from "./chunk-L4SLHV6G.js";
+} from "./chunk-US3T3W5J.js";
+import "./chunk-NNHHXJB2.js";
+import {
+  EXIT_CODE
+} from "./chunk-YD5FML7K.js";
 
 // dist/cli/commands/comments.js
 import { readFile } from "node:fs/promises";
@@ -117,6 +120,6 @@ async function runComments(id, options, global) {
 export {
   runComments
 };
-//# sourceMappingURL=comments-RW23R3VE.js.map
+//# sourceMappingURL=comments-SAG5LSKL.js.map
 
-//# debugId=2b734356-43f8-55d2-af9c-ea78787f9965
+//# debugId=1e43a26a-213c-5b08-b9d0-20f63724f94a

package/dist/cli-bundle/chunks/{comments-RW23R3VE.js.map → comments-SAG5LSKL.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/comments.ts"],"sourcesContent":["/**\n * @module cli/commands/comments\n *\n * Implements the pm comments command surface and its agent-facing runtime behavior.\n */\nimport { readFile } from \"node:fs/promises\";\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 { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { Comment } from \"../../types/index.js\";\nimport { parseAnnotationTextInput, runAnnotationCommand } from \"./annotation-command.js\";\n\n/**\n * Documents the comments command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsCommandOptions {\n  add?: string;\n  stdin?: boolean;\n  file?: string;\n  edit?: number;\n  delete?: number;\n  limit?: string;\n  includeMeta?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  allowAuditComment?: boolean;\n}\n\n/**\n * Documents the comments result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsResult {\n  id: string;\n  comments: Comment[];\n  count: number;\n  total_count?: number;\n  returned_count?: number;\n  has_more?: boolean;\n  limit?: number;\n}\n\ninterface ResolvedCommentInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\nfunction isErrnoError(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveCommentTextSource(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<{ value: string; emptyFlag: string } | undefined> {\n  const hasAdd = options.add !== undefined;\n  const hasStdin = options.stdin === true;\n  const hasFile = typeof options.file === \"string\";\n  const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);\n  if (sourceCount === 0) {\n    return undefined;\n  }\n  if (sourceCount > 1) {\n    throw new PmCliError(\"Specify comment text using only one input source: --add, --stdin, or --file\", EXIT_CODE.USAGE);\n  }\n  if (hasAdd) {\n    const addInput = await stdinResolver.resolveValue(options.add, \"--add\");\n    return { value: addInput ?? \"\", emptyFlag: \"--add\" };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return { value: stdinInput ?? \"\", emptyFlag: \"--stdin\" };\n  }\n  const filePath = (options.file as string).trim();\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    const fileInput = await readFile(filePath, \"utf8\");\n    return { value: fileInput, emptyFlag: \"--file\" };\n  } catch (error: unknown) {\n    if (isErrnoError(error) && error.code === \"ENOENT\") {\n      throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);\n    }\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`Failed to read --file path \"${filePath}\": ${detail}`, EXIT_CODE.USAGE);\n  }\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\n  const hasEdit = options.edit !== undefined;\n  const hasDelete = options.delete !== undefined;\n  if (hasEdit && hasDelete) {\n    throw new PmCliError(\"Specify only one of --edit or --delete\", EXIT_CODE.USAGE);\n  }\n\n  if (hasDelete) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource !== undefined) {\n      throw new PmCliError(\"--delete does not take comment text\", EXIT_CODE.USAGE);\n    }\n    return { mode: \"delete\", index: options.delete };\n  }\n\n  if (hasEdit) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource === undefined) {\n      throw new PmCliError(\n        \"--edit requires replacement text via positional [text], --add, --stdin, or --file\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      mode: \"edit\",\n      index: options.edit,\n      value: textSource.value,\n      emptyFlag: textSource.emptyFlag,\n    };\n  }\n\n  const textSource = await resolveCommentTextSource(options, stdinResolver);\n  if (textSource === undefined) {\n    return { mode: \"list\" };\n  }\n  // Map the single resolved input source back to its add/stdin/file mode so the\n  // caller still knows whether to run plain-text markdown parsing (add-only).\n  const mode = textSource.emptyFlag === \"--add\" ? \"add\" : textSource.emptyFlag === \"--stdin\" ? \"stdin\" : \"file\";\n  return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };\n}\n\n/**\n * Implements run comments for the public runtime surface of this module.\n */\nexport async function runComments(id: string, options: CommentsCommandOptions, global: GlobalOptions): Promise<CommentsResult> {\n  const stdinResolver = createStdinTokenResolver();\n  const commentInput = await resolveCommentInput(options, stdinResolver);\n\n  const shouldParseText = commentInput.mode === \"add\" || commentInput.mode === \"edit\";\n  // list/delete carry no text (value undefined → \"\"); add/edit/stdin/file always\n  // resolve to a string. Normalize once so neither branch below is unreachable.\n  const rawValue = commentInput.value ?? \"\";\n  return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n    input: {\n      ...commentInput,\n      value: shouldParseText ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true }) : rawValue,\n    },\n    collectionKey: \"comments\",\n    op: \"comment_add\",\n    editOp: \"comment_edit\",\n    deleteOp: \"comment_delete\",\n    parseText: (raw) => raw,\n    allowAuditBypass: Boolean(options.allowAuditComment),\n    conflictGuidance: {\n      required:\n        \"For append-only comment audits on another owner's item, prefer --allow-audit-comment before considering --force.\",\n      examples: ['pm comments pm-a1b2 --add \"audit note\" --author \"reviewer\" --allow-audit-comment'],\n      nextSteps: [\n        \"Retry with --allow-audit-comment for append-only audits that do not mutate item metadata beyond comments.\",\n        \"Use --force only when an ownership override is explicitly approved.\",\n      ],\n    },\n  });\n}\n"],"names":["textSource"],"mappings":"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","debugId":"2b734356-43f8-55d2-af9c-ea78787f9965"}
+{"version":3,"sources":["../../../../../../../../cli/commands/comments.ts"],"sourcesContent":["/**\n * @module cli/commands/comments\n *\n * Implements the pm comments command surface and its agent-facing runtime behavior.\n */\nimport { readFile } from \"node:fs/promises\";\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 { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { Comment } from \"../../types/index.js\";\nimport { parseAnnotationTextInput, runAnnotationCommand } from \"./annotation-command.js\";\n\n/**\n * Documents the comments command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsCommandOptions {\n  add?: string;\n  stdin?: boolean;\n  file?: string;\n  edit?: number;\n  delete?: number;\n  limit?: string;\n  includeMeta?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  allowAuditComment?: boolean;\n}\n\n/**\n * Documents the comments result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsResult {\n  id: string;\n  comments: Comment[];\n  count: number;\n  total_count?: number;\n  returned_count?: number;\n  has_more?: boolean;\n  limit?: number;\n}\n\ninterface ResolvedCommentInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\nfunction isErrnoError(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveCommentTextSource(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<{ value: string; emptyFlag: string } | undefined> {\n  const hasAdd = options.add !== undefined;\n  const hasStdin = options.stdin === true;\n  const hasFile = typeof options.file === \"string\";\n  const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);\n  if (sourceCount === 0) {\n    return undefined;\n  }\n  if (sourceCount > 1) {\n    throw new PmCliError(\"Specify comment text using only one input source: --add, --stdin, or --file\", EXIT_CODE.USAGE);\n  }\n  if (hasAdd) {\n    const addInput = await stdinResolver.resolveValue(options.add, \"--add\");\n    return { value: addInput ?? \"\", emptyFlag: \"--add\" };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return { value: stdinInput ?? \"\", emptyFlag: \"--stdin\" };\n  }\n  const filePath = (options.file as string).trim();\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    const fileInput = await readFile(filePath, \"utf8\");\n    return { value: fileInput, emptyFlag: \"--file\" };\n  } catch (error: unknown) {\n    if (isErrnoError(error) && error.code === \"ENOENT\") {\n      throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);\n    }\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`Failed to read --file path \"${filePath}\": ${detail}`, EXIT_CODE.USAGE);\n  }\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\n  const hasEdit = options.edit !== undefined;\n  const hasDelete = options.delete !== undefined;\n  if (hasEdit && hasDelete) {\n    throw new PmCliError(\"Specify only one of --edit or --delete\", EXIT_CODE.USAGE);\n  }\n\n  if (hasDelete) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource !== undefined) {\n      throw new PmCliError(\"--delete does not take comment text\", EXIT_CODE.USAGE);\n    }\n    return { mode: \"delete\", index: options.delete };\n  }\n\n  if (hasEdit) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource === undefined) {\n      throw new PmCliError(\n        \"--edit requires replacement text via positional [text], --add, --stdin, or --file\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      mode: \"edit\",\n      index: options.edit,\n      value: textSource.value,\n      emptyFlag: textSource.emptyFlag,\n    };\n  }\n\n  const textSource = await resolveCommentTextSource(options, stdinResolver);\n  if (textSource === undefined) {\n    return { mode: \"list\" };\n  }\n  // Map the single resolved input source back to its add/stdin/file mode so the\n  // caller still knows whether to run plain-text markdown parsing (add-only).\n  const mode = textSource.emptyFlag === \"--add\" ? \"add\" : textSource.emptyFlag === \"--stdin\" ? \"stdin\" : \"file\";\n  return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };\n}\n\n/**\n * Implements run comments for the public runtime surface of this module.\n */\nexport async function runComments(id: string, options: CommentsCommandOptions, global: GlobalOptions): Promise<CommentsResult> {\n  const stdinResolver = createStdinTokenResolver();\n  const commentInput = await resolveCommentInput(options, stdinResolver);\n\n  const shouldParseText = commentInput.mode === \"add\" || commentInput.mode === \"edit\";\n  // list/delete carry no text (value undefined → \"\"); add/edit/stdin/file always\n  // resolve to a string. Normalize once so neither branch below is unreachable.\n  const rawValue = commentInput.value ?? \"\";\n  return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n    input: {\n      ...commentInput,\n      value: shouldParseText ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true }) : rawValue,\n    },\n    collectionKey: \"comments\",\n    op: \"comment_add\",\n    editOp: \"comment_edit\",\n    deleteOp: \"comment_delete\",\n    parseText: (raw) => raw,\n    allowAuditBypass: Boolean(options.allowAuditComment),\n    conflictGuidance: {\n      required:\n        \"For append-only comment audits on another owner's item, prefer --allow-audit-comment before considering --force.\",\n      examples: ['pm comments pm-a1b2 --add \"audit note\" --author \"reviewer\" --allow-audit-comment'],\n      nextSteps: [\n        \"Retry with --allow-audit-comment for append-only audits that do not mutate item metadata beyond comments.\",\n        \"Use --force only when an ownership override is explicitly approved.\",\n      ],\n    },\n  });\n}\n"],"names":["textSource"],"mappings":"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","debugId":"1e43a26a-213c-5b08-b9d0-20f63724f94a"}

package/dist/cli-bundle/chunks/{config-AUM5WBYA.js → config-DJJKZB5R.js}

@@ -1,37 +1,40 @@
+import {
+  migrateItemFilesToFormat
+} from "./chunk-HJE4JTKQ.js";
+import {
+  normalizeParentReferencePolicy,
+  normalizeSprintReleaseFormatPolicy
+} from "./chunk-OWTIRHX4.js";
 import {
   NESTED_SETTING_DESCRIPTORS,
   parseNestedSettingValue,
   readNestedSettingValue,
   resolveNestedSettingDescriptor,
   writeNestedSettingValue
-} from "./chunk-B4O5S7I3.js";
+} from "./chunk-VUHVWI4C.js";
+import "./chunk-EZFKWSC7.js";
+import "./chunk-DRBV5UC2.js";
 import {
-  normalizeParentReferencePolicy,
-  normalizeSprintReleaseFormatPolicy
-} from "./chunk-FUFFPIYA.js";
-import {
-  migrateItemFilesToFormat
-} from "./chunk-5IZUBZBR.js";
+  PmCliError,
+  getActiveExtensionRegistrations,
+  readSettingsWithMetadata,
+  writeSettings
+} from "./chunk-P5YORJRH.js";
 import {
   buildInvalidTypeError
-} from "./chunk-6NYJGMTY.js";
-import "./chunk-3W2HJKJX.js";
-import "./chunk-AJHYQCBJ.js";
+} from "./chunk-T35XLYZF.js";
+import "./chunk-7C2O74AE.js";
 import {
   CONTEXT_DEPTH_VALUES,
   EXIT_CODE,
-  PmCliError,
-  getActiveExtensionRegistrations,
   getSettingsPath,
   pathExists,
-  readSettingsWithMetadata,
   resolveGlobalPmRoot,
   resolveItemTypeRegistry,
   resolveItemTypesFilePath,
   resolvePmRoot,
-  resolveTypeName,
-  writeSettings
-} from "./chunk-KHVGM5CS.js";
+  resolveTypeName
+} from "./chunk-5VVUKE3U.js";
 
 // dist/core/config/positional-value.js
 !(function() {
@@ -1069,4 +1072,4 @@ export {
   _testOnlyConfigCommand,
   runConfig
 };
-//# sourceMappingURL=config-AUM5WBYA.js.map
+//# sourceMappingURL=config-DJJKZB5R.js.map