@unbrained/pm-cli 2026.5.30 → 2026.6.5

package/dist/cli-bundle/chunks/close-many-UKZSQGM7.js

@@ -0,0 +1,314 @@
+import {
+  createCheckpointId,
+  loadMutationCheckpoint,
+  restoreCheckpointItems,
+  writeMutationCheckpoint
+} from "./chunk-TQ3ZK6VD.js";
+import {
+  runRestore
+} from "./chunk-GCAVRLGE.js";
+import {
+  resolveAuthor
+} from "./chunk-O7IWB35H.js";
+import "./chunk-WIKR7KFL.js";
+import "./chunk-S3CV7JGJ.js";
+import {
+  runClose
+} from "./chunk-ATBVS6WW.js";
+import {
+  runList
+} from "./chunk-N5YF3VFN.js";
+import "./chunk-RQAWLSUU.js";
+import "./chunk-K47WAYQV.js";
+import "./chunk-EAOG77HM.js";
+import {
+  listAllFrontMatterLight
+} from "./chunk-XG7RJYHV.js";
+import "./chunk-KA24HME7.js";
+import {
+  isTerminalStatus
+} from "./chunk-HPH6X4ZZ.js";
+import {
+  resolveItemTypeRegistry
+} from "./chunk-4PJQSECJ.js";
+import {
+  nowIso
+} from "./chunk-RANZIID5.js";
+import {
+  EXIT_CODE,
+  PmCliError,
+  getActiveExtensionRegistrations,
+  getSettingsPath,
+  pathExists,
+  readSettings,
+  resolvePmRoot,
+  resolveRuntimeStatusRegistry,
+  toErrorMessage
+} from "./chunk-SRVKTWPR.js";
+
+// dist/cli/commands/close-many.js
+!(function() {
+  try {
+    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "2fb69034-d900-5001-9f90-1b7f17b609bc");
+  } catch (e2) {
+  }
+})();
+var CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;
+var CLOSE_MANY_CHECKPOINT_SUBDIR = "close-many";
+var CLOSE_MANY_FILTER_GUIDANCE = [
+  "--filter-status",
+  "--filter-type",
+  "--filter-tag",
+  "--filter-priority",
+  "--filter-sprint",
+  "--filter-release",
+  "--filter-parent",
+  "--filter-assignee",
+  "--filter-updated-before",
+  "--ids"
+].join(", ");
+function hasCloseManyFilters(list, status) {
+  const isActive = (value) => value != null && (typeof value !== "string" || value.split(",").some((entry) => entry.trim().length > 0));
+  return isActive(status) || isActive(list?.status) || isActive(list?.type) || isActive(list?.tag) || isActive(list?.priority) || isActive(list?.deadlineBefore) || isActive(list?.deadlineAfter) || isActive(list?.updatedAfter) || isActive(list?.updatedBefore) || isActive(list?.createdAfter) || isActive(list?.createdBefore) || isActive(list?.ids) || isActive(list?.assignee) || isActive(list?.assigneeFilter) || isActive(list?.parent) || isActive(list?.sprint) || isActive(list?.release);
+}
+function hasCloseManyRollbackConflicts(list, status) {
+  return hasCloseManyFilters(list, status) || list?.limit != null && String(list.limit).trim().length > 0 || list?.offset != null && String(list.offset).trim().length > 0;
+}
+function rejectBlankIdsFilter(list) {
+  if (list?.ids != null && String(list.ids).trim().length === 0) {
+    throw new PmCliError("--ids requires at least one non-empty item ID", EXIT_CODE.USAGE);
+  }
+}
+function activeListOptions(list) {
+  const active = {};
+  if (!list) {
+    return active;
+  }
+  for (const [key, value] of Object.entries(list)) {
+    if (value == null || typeof value === "string" && !value.split(",").some((entry) => entry.trim().length > 0)) {
+      continue;
+    }
+    active[key] = value;
+  }
+  return active;
+}
+function ensureReason(reason) {
+  const trimmed = String(reason ?? "").trim();
+  if (trimmed.length === 0) {
+    throw new PmCliError("pm close-many requires a shared close reason via --reason. Close mutations are auditable.", EXIT_CODE.USAGE, {
+      code: "missing_required_argument",
+      examples: [
+        'pm close-many --filter-sprint S-12 --reason "Sprint S-12 acceptance criteria met"',
+        'pm close-many --ids pm-a,pm-b --reason "Superseded by redesign"'
+      ]
+    });
+  }
+  return trimmed;
+}
+async function buildActiveChildrenByParent(pmRoot, settings) {
+  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+  const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, void 0, settings.schema);
+  const childrenByParent = /* @__PURE__ */ new Map();
+  const parentByChild = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    if (typeof item.parent !== "string" || item.parent.length === 0) {
+      continue;
+    }
+    parentByChild.set(item.id, item.parent);
+    if (isTerminalStatus(item.status, statusRegistry)) {
+      continue;
+    }
+    const existing = childrenByParent.get(item.parent);
+    if (existing) {
+      existing.push(item.id);
+    } else {
+      childrenByParent.set(item.parent, [item.id]);
+    }
+  }
+  for (const ids of childrenByParent.values()) {
+    ids.sort((left, right) => left.localeCompare(right));
+  }
+  return { childrenByParent, parentByChild };
+}
+function hierarchyDepth(id, parentByChild, cache) {
+  const cached = cache?.get(id);
+  if (cached !== void 0) {
+    return cached;
+  }
+  let depth = 0;
+  let current = parentByChild.get(id);
+  const path = [];
+  const visited = /* @__PURE__ */ new Set();
+  let hasCycle = false;
+  while (current !== void 0 && !visited.has(current)) {
+    const cachedCurrent = cache?.get(current);
+    if (cachedCurrent !== void 0) {
+      depth += cachedCurrent + 1;
+      break;
+    }
+    visited.add(current);
+    path.push(current);
+    depth += 1;
+    current = parentByChild.get(current);
+  }
+  if (current !== void 0 && visited.has(current)) {
+    hasCycle = true;
+  }
+  if (!hasCycle) {
+    cache?.set(id, depth);
+    for (const [index, ancestorId] of path.entries()) {
+      cache?.set(ancestorId, depth - index - 1);
+    }
+  }
+  return depth;
+}
+async function runCloseMany(options, global2) {
+  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
+  if (!await pathExists(getSettingsPath(pmRoot))) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const settings = await readSettings(pmRoot);
+  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+  const dryRun = options.dryRun === true;
+  const rollbackId = typeof options.rollback === "string" ? options.rollback : void 0;
+  rejectBlankIdsFilter(options.list);
+  if (rollbackId) {
+    if (dryRun) {
+      throw new PmCliError("--dry-run cannot be combined with --rollback", EXIT_CODE.USAGE);
+    }
+    if (hasCloseManyRollbackConflicts(options.list, options.status)) {
+      throw new PmCliError("Rollback mode does not accept filter options", EXIT_CODE.USAGE);
+    }
+    const checkpoint = await loadMutationCheckpoint(pmRoot, CLOSE_MANY_CHECKPOINT_SUBDIR, rollbackId, CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION);
+    const restoreMessage = options.message ?? `Rollback close-many checkpoint ${checkpoint.id}`;
+    const rollback = await restoreCheckpointItems(checkpoint.items, (id, targetUpdatedAt) => runRestore(id, targetUpdatedAt, { author: options.author, message: restoreMessage, force: true }, global2));
+    return {
+      mode: "rollback",
+      matched_count: checkpoint.items.length,
+      dry_run: false,
+      rollback_checkpoint_id: checkpoint.id,
+      checkpoint: {
+        id: checkpoint.id,
+        created_at: checkpoint.created_at,
+        path: checkpoint.path,
+        rollback_command: `pm close-many --rollback ${checkpoint.id}`
+      },
+      restored_count: rollback.restored_ids.length,
+      failed_count: rollback.failed_count,
+      rows: rollback.rows,
+      ids: rollback.restored_ids
+    };
+  }
+  if (!hasCloseManyFilters(options.list, options.status)) {
+    throw new PmCliError(`close-many requires at least one filter to scope the close (for example: ${CLOSE_MANY_FILTER_GUIDANCE}). Refusing to match every item.`, EXIT_CODE.USAGE);
+  }
+  const reason = ensureReason(options.reason);
+  const validateCloseMode = options.validateClose;
+  const force = options.force === true;
+  const listOptions = activeListOptions(options.list);
+  const listed = await runList(options.status, listOptions, global2);
+  const { childrenByParent, parentByChild } = await buildActiveChildrenByParent(pmRoot, settings);
+  const depthCache = /* @__PURE__ */ new Map();
+  const matched = [...listed.items].sort((left, right) => {
+    const depthDelta = hierarchyDepth(right.id, parentByChild, depthCache) - hierarchyDepth(left.id, parentByChild, depthCache);
+    return depthDelta !== 0 ? depthDelta : left.id.localeCompare(right.id);
+  });
+  const closePlannedIds = new Set(matched.filter((item) => force || !isTerminalStatus(item.status, statusRegistry)).map((item) => item.id));
+  const planRows = matched.map((item) => {
+    const alreadyTerminal = isTerminalStatus(item.status, statusRegistry);
+    const activeChildIds = (childrenByParent.get(item.id) ?? []).filter((childId) => !closePlannedIds.has(childId));
+    const willSkip = alreadyTerminal && !force;
+    return {
+      id: item.id,
+      title: typeof item.title === "string" ? item.title : "",
+      status: item.status,
+      action: willSkip ? "skip" : "close",
+      ...willSkip ? { skip_reason: "already_terminal" } : {},
+      ...activeChildIds.length > 0 ? { active_child_ids: activeChildIds } : {}
+    };
+  });
+  if (dryRun) {
+    return {
+      mode: "dry_run",
+      matched_count: matched.length,
+      dry_run: true,
+      reason,
+      filters: listed.filters,
+      ...validateCloseMode ? { validate_close: validateCloseMode } : {},
+      item_plans: planRows,
+      ids: []
+    };
+  }
+  const closableIds = new Set(planRows.filter((row) => row.action === "close").map((row) => row.id));
+  const nowValue = nowIso();
+  const checkpointId = createCheckpointId(CLOSE_MANY_CHECKPOINT_SUBDIR, nowValue);
+  const checkpointEnabled = options.checkpoint !== false;
+  let checkpointInfo;
+  if (checkpointEnabled && closableIds.size > 0) {
+    const checkpointItems = matched.filter((item) => closableIds.has(item.id)).map((item) => ({ id: item.id, target_updated_at: item.updated_at }));
+    const checkpointPath = await writeMutationCheckpoint(pmRoot, CLOSE_MANY_CHECKPOINT_SUBDIR, checkpointId, {
+      schema_version: CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,
+      id: checkpointId,
+      created_at: nowValue,
+      author: resolveAuthor(options.author, "unknown"),
+      reason,
+      filters: listed.filters,
+      items: checkpointItems
+    });
+    checkpointInfo = {
+      id: checkpointId,
+      created_at: nowValue,
+      path: checkpointPath,
+      rollback_command: `pm close-many --rollback ${checkpointId}`
+    };
+  }
+  const closeOptions = {
+    author: options.author,
+    message: options.message ?? `close-many apply ${checkpointId}`,
+    validateClose: validateCloseMode,
+    force,
+    resolution: options.resolution,
+    expectedResult: options.expectedResult,
+    actualResult: options.actualResult
+  };
+  const rows = [];
+  const closedIds = [];
+  for (const item of matched) {
+    if (!closableIds.has(item.id)) {
+      rows.push({ id: item.id, status: "skipped", skip_reason: "already_terminal" });
+      continue;
+    }
+    try {
+      const result = await runClose(item.id, reason, closeOptions, global2);
+      rows.push({
+        id: item.id,
+        status: "closed",
+        changed_fields: result.changed_fields,
+        ...result.warnings && result.warnings.length > 0 ? { warnings: result.warnings } : {}
+      });
+      closedIds.push(item.id);
+    } catch (error) {
+      rows.push({ id: item.id, status: "failed", error: toErrorMessage(error) });
+    }
+  }
+  return {
+    mode: "apply",
+    matched_count: matched.length,
+    dry_run: false,
+    reason,
+    filters: listed.filters,
+    ...validateCloseMode ? { validate_close: validateCloseMode } : {},
+    ...checkpointInfo ? { checkpoint: checkpointInfo } : {},
+    closed_count: rows.filter((row) => row.status === "closed").length,
+    skipped_count: rows.filter((row) => row.status === "skipped").length,
+    failed_count: rows.filter((row) => row.status === "failed").length,
+    rows,
+    ids: closedIds
+  };
+}
+export {
+  runCloseMany
+};
+//# sourceMappingURL=close-many-UKZSQGM7.js.map

package/dist/cli-bundle/chunks/close-many-UKZSQGM7.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/close-many.ts"],
+  "sourcesContent": ["import { 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 { 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\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\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  const isActive = (value: unknown): boolean =>\n    value != null && (typeof value !== \"string\" || value.split(\",\").some((entry) => entry.trim().length > 0));\n  return (\n    isActive(status) ||\n    isActive(list?.status) ||\n    isActive(list?.type) ||\n    isActive(list?.tag) ||\n    isActive(list?.priority) ||\n    isActive(list?.deadlineBefore) ||\n    isActive(list?.deadlineAfter) ||\n    isActive(list?.updatedAfter) ||\n    isActive(list?.updatedBefore) ||\n    isActive(list?.createdAfter) ||\n    isActive(list?.createdBefore) ||\n    isActive(list?.ids) ||\n    isActive(list?.assignee) ||\n    isActive(list?.assigneeFilter) ||\n    isActive(list?.parent) ||\n    isActive(list?.sprint) ||\n    isActive(list?.release)\n  );\n}\n\nfunction hasCloseManyRollbackConflicts(list: ListOptions | undefined, status: string | undefined): boolean {\n  return (\n    hasCloseManyFilters(list, status) ||\n    (list?.limit != null && String(list.limit).trim().length > 0) ||\n    (list?.offset != null && String(list.offset).trim().length > 0)\n  );\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 ensureReason(reason: unknown): string {\n  const trimmed = String(reason ?? \"\").trim();\n  if (trimmed.length === 0) {\n    throw new PmCliError(\n      \"pm close-many requires a shared close reason via --reason. Close mutations are auditable.\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"missing_required_argument\",\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      },\n    );\n  }\n  return trimmed;\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\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  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n\n  const dryRun = options.dryRun === true;\n  const rollbackId = typeof options.rollback === \"string\" ? options.rollback : undefined;\n  rejectBlankIdsFilter(options.list);\n\n  if (rollbackId) {\n    if (dryRun) {\n      throw new PmCliError(\"--dry-run cannot be combined with --rollback\", EXIT_CODE.USAGE);\n    }\n    if (hasCloseManyRollbackConflicts(options.list, options.status)) {\n      throw new PmCliError(\"Rollback mode does not accept filter options\", EXIT_CODE.USAGE);\n    }\n    const checkpoint = await loadMutationCheckpoint(\n      pmRoot,\n      CLOSE_MANY_CHECKPOINT_SUBDIR,\n      rollbackId,\n      CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,\n    );\n    const restoreMessage = options.message ?? `Rollback close-many checkpoint ${checkpoint.id}`;\n    const rollback = await restoreCheckpointItems(checkpoint.items, (id, targetUpdatedAt) =>\n      runRestore(id, targetUpdatedAt, { author: options.author, message: restoreMessage, force: true }, 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\n  if (!hasCloseManyFilters(options.list, options.status)) {\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\n  const reason = ensureReason(options.reason);\n  const validateCloseMode = options.validateClose;\n  const force = options.force === true;\n\n  const listOptions = activeListOptions(options.list);\n  const listed = await runList(options.status, listOptions, global);\n  const { childrenByParent, parentByChild } = await buildActiveChildrenByParent(pmRoot, settings);\n  const depthCache = new Map<string, number>();\n  const matched = [...(listed.items as ListedItem[])].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  const closePlannedIds = new Set(\n    matched\n      .filter((item) => force || !isTerminalStatus(item.status, statusRegistry))\n      .map((item) => item.id),\n  );\n\n  const planRows: CloseManyPlanRow[] = matched.map((item) => {\n    const alreadyTerminal = isTerminalStatus(item.status, statusRegistry);\n    const activeChildIds = (childrenByParent.get(item.id) ?? []).filter((childId) => !closePlannedIds.has(childId));\n    const willSkip = alreadyTerminal && !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  if (dryRun) {\n    return {\n      mode: \"dry_run\",\n      matched_count: matched.length,\n      dry_run: true,\n      reason,\n      filters: listed.filters,\n      ...(validateCloseMode ? { validate_close: validateCloseMode } : {}),\n      item_plans: planRows,\n      ids: [],\n    };\n  }\n\n  const closableIds = new Set(planRows.filter((row) => row.action === \"close\").map((row) => row.id));\n\n  const nowValue = nowIso();\n  const checkpointId = createCheckpointId(CLOSE_MANY_CHECKPOINT_SUBDIR, nowValue);\n  const checkpointEnabled = options.checkpoint !== false;\n  let checkpointInfo: CloseManyResult[\"checkpoint\"] | undefined;\n  if (checkpointEnabled && closableIds.size > 0) {\n    const checkpointItems: MutationCheckpointItem[] = matched\n      .filter((item) => closableIds.has(item.id))\n      .map((item) => ({ id: item.id, target_updated_at: item.updated_at }));\n    const checkpointPath = await writeMutationCheckpoint(pmRoot, CLOSE_MANY_CHECKPOINT_SUBDIR, checkpointId, {\n      schema_version: CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,\n      id: checkpointId,\n      created_at: nowValue,\n      author: resolveAuthor(options.author, \"unknown\"),\n      reason,\n      filters: listed.filters,\n      items: checkpointItems,\n    });\n    checkpointInfo = {\n      id: checkpointId,\n      created_at: nowValue,\n      path: checkpointPath,\n      rollback_command: `pm close-many --rollback ${checkpointId}`,\n    };\n  }\n\n  const closeOptions: CloseCommandOptions = {\n    author: options.author,\n    message: options.message ?? `close-many apply ${checkpointId}`,\n    validateClose: validateCloseMode,\n    force,\n    resolution: options.resolution,\n    expectedResult: options.expectedResult,\n    actualResult: options.actualResult,\n  };\n\n  const rows: CloseManyApplyRow[] = [];\n  const closedIds: string[] = [];\n  for (const item of matched) {\n    if (!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, reason, closeOptions, 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\n  return {\n    mode: \"apply\",\n    matched_count: matched.length,\n    dry_run: false,\n    reason,\n    filters: listed.filters,\n    ...(validateCloseMode ? { validate_close: 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"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/comments-AGBNSJJH.js

@@ -0,0 +1,103 @@
+import {
+  parseAnnotationTextInput,
+  runAnnotationCommand
+} from "./chunk-LDJK7SHN.js";
+import "./chunk-O7IWB35H.js";
+import {
+  createStdinTokenResolver
+} from "./chunk-CJDQB2ED.js";
+import "./chunk-K47WAYQV.js";
+import "./chunk-XG7RJYHV.js";
+import "./chunk-KA24HME7.js";
+import "./chunk-HPH6X4ZZ.js";
+import "./chunk-4PJQSECJ.js";
+import "./chunk-RANZIID5.js";
+import {
+  EXIT_CODE,
+  PmCliError
+} from "./chunk-SRVKTWPR.js";
+
+// dist/cli/commands/comments.js
+import { readFile } from "node:fs/promises";
+!(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] = "284afe3d-5bbe-5018-9c93-77dba1832d16");
+  } catch (e2) {
+  }
+})();
+function isErrnoError(error) {
+  return typeof error === "object" && error !== null && "code" in error;
+}
+async function resolveCommentInput(options, stdinResolver) {
+  const hasAdd = options.add !== void 0;
+  const hasStdin = options.stdin === true;
+  const hasFile = typeof options.file === "string";
+  const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);
+  if (sourceCount === 0) {
+    return { mode: "list" };
+  }
+  if (sourceCount > 1) {
+    throw new PmCliError("Specify comment text using only one input source: --add, --stdin, or --file", EXIT_CODE.USAGE);
+  }
+  if (hasAdd) {
+    const addInput = await stdinResolver.resolveValue(options.add, "--add");
+    return {
+      mode: "add",
+      value: addInput ?? "",
+      emptyFlag: "--add"
+    };
+  }
+  if (hasStdin) {
+    const stdinInput = await stdinResolver.resolveValue("-", "--stdin");
+    return {
+      mode: "stdin",
+      value: stdinInput ?? "",
+      emptyFlag: "--stdin"
+    };
+  }
+  const filePath = options.file?.trim() ?? "";
+  if (!filePath) {
+    throw new PmCliError("--file path cannot be empty", EXIT_CODE.USAGE);
+  }
+  try {
+    const fileInput = await readFile(filePath, "utf8");
+    return {
+      mode: "file",
+      value: fileInput,
+      emptyFlag: "--file"
+    };
+  } catch (error) {
+    if (isErrnoError(error) && error.code === "ENOENT") {
+      throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);
+    }
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new PmCliError(`Failed to read --file path "${filePath}": ${detail}`, EXIT_CODE.USAGE);
+  }
+}
+async function runComments(id, options, global2) {
+  const stdinResolver = createStdinTokenResolver();
+  const commentInput = await resolveCommentInput(options, stdinResolver);
+  return runAnnotationCommand(id, options, global2, {
+    input: {
+      ...commentInput,
+      value: commentInput.mode === "add" ? parseAnnotationTextInput(commentInput.value ?? "", { stripPlainTextPrefix: true }) : commentInput.value ?? ""
+    },
+    collectionKey: "comments",
+    op: "comment_add",
+    parseText: (raw) => raw,
+    allowAuditBypass: Boolean(options.allowAuditComment),
+    conflictGuidance: {
+      required: "For append-only comment audits on another owner's item, prefer --allow-audit-comment before considering --force.",
+      examples: ['pm comments pm-a1b2 --add "audit note" --author "reviewer" --allow-audit-comment'],
+      nextSteps: [
+        "Retry with --allow-audit-comment for append-only audits that do not mutate item metadata beyond comments.",
+        "Use --force only when an ownership override is explicitly approved."
+      ]
+    }
+  });
+}
+export {
+  runComments
+};
+//# sourceMappingURL=comments-AGBNSJJH.js.map

package/dist/cli-bundle/chunks/comments-AGBNSJJH.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/comments.ts"],
+  "sourcesContent": ["import { 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\nexport interface CommentsCommandOptions {\n  add?: string;\n  stdin?: boolean;\n  file?: string;\n  limit?: string;\n  includeMeta?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  allowAuditComment?: boolean;\n}\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\";\n  value?: string;\n  emptyFlag?: string;\n}\n\nfunction isErrnoError(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\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 { mode: \"list\" };\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 {\n      mode: \"add\",\n      value: addInput ?? \"\",\n      emptyFlag: \"--add\",\n    };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return {\n      mode: \"stdin\",\n      value: stdinInput ?? \"\",\n      emptyFlag: \"--stdin\",\n    };\n  }\n  const filePath = options.file?.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 {\n      mode: \"file\",\n      value: fileInput,\n      emptyFlag: \"--file\",\n    };\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\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  return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n    input: {\n      ...commentInput,\n      value:\n        commentInput.mode === \"add\"\n          ? parseAnnotationTextInput(commentInput.value ?? \"\", { stripPlainTextPrefix: true })\n          : (commentInput.value ?? \"\"),\n    },\n    collectionKey: \"comments\",\n    op: \"comment_add\",\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": ";;;;;;;;;;;;;;;;;;;;AAAA,SAAS,gBAAgB;;;;;;;;AAoCzB,SAAS,aAAa,OAAc;AAClC,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU;AAClE;AAEA,eAAe,oBACb,SACA,eAA0D;AAE1D,QAAM,SAAS,QAAQ,QAAQ;AAC/B,QAAM,WAAW,QAAQ,UAAU;AACnC,QAAM,UAAU,OAAO,QAAQ,SAAS;AACxC,QAAM,cAAc,OAAO,MAAM,IAAI,OAAO,QAAQ,IAAI,OAAO,OAAO;AACtE,MAAI,gBAAgB,GAAG;AACrB,WAAO,EAAE,MAAM,OAAM;EACvB;AACA,MAAI,cAAc,GAAG;AACnB,UAAM,IAAI,WAAW,+EAA+E,UAAU,KAAK;EACrH;AACA,MAAI,QAAQ;AACV,UAAM,WAAW,MAAM,cAAc,aAAa,QAAQ,KAAK,OAAO;AACtE,WAAO;MACL,MAAM;MACN,OAAO,YAAY;MACnB,WAAW;;EAEf;AACA,MAAI,UAAU;AACZ,UAAM,aAAa,MAAM,cAAc,aAAa,KAAK,SAAS;AAClE,WAAO;MACL,MAAM;MACN,OAAO,cAAc;MACrB,WAAW;;EAEf;AACA,QAAM,WAAW,QAAQ,MAAM,KAAI,KAAM;AACzC,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,WAAW,+BAA+B,UAAU,KAAK;EACrE;AACA,MAAI;AACF,UAAM,YAAY,MAAM,SAAS,UAAU,MAAM;AACjD,WAAO;MACL,MAAM;MACN,OAAO;MACP,WAAW;;EAEf,SAAS,OAAgB;AACvB,QAAI,aAAa,KAAK,KAAK,MAAM,SAAS,UAAU;AAClD,YAAM,IAAI,WAAW,0BAA0B,QAAQ,IAAI,UAAU,KAAK;IAC5E;AACA,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,UAAM,IAAI,WAAW,+BAA+B,QAAQ,MAAM,MAAM,IAAI,UAAU,KAAK;EAC7F;AACF;AAEA,eAAsB,YAAY,IAAY,SAAiCA,SAAqB;AAClG,QAAM,gBAAgB,yBAAwB;AAC9C,QAAM,eAAe,MAAM,oBAAoB,SAAS,aAAa;AAErE,SAAO,qBAA0C,IAAI,SAASA,SAAQ;IACpE,OAAO;MACL,GAAG;MACH,OACE,aAAa,SAAS,QAClB,yBAAyB,aAAa,SAAS,IAAI,EAAE,sBAAsB,KAAI,CAAE,IAChF,aAAa,SAAS;;IAE/B,eAAe;IACf,IAAI;IACJ,WAAW,CAAC,QAAQ;IACpB,kBAAkB,QAAQ,QAAQ,iBAAiB;IACnD,kBAAkB;MAChB,UACE;MACF,UAAU,CAAC,kFAAkF;MAC7F,WAAW;QACT;QACA;;;GAGL;AACH;",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/comments-CJWXQI7X.js

@@ -0,0 +1,100 @@
+
+!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]="1e3f73a8-4331-568d-ab80-3e435948371c")}catch(e){}}();
+import {
+  parseAnnotationTextInput,
+  runAnnotationCommand
+} from "./chunk-CCUFLH4J.js";
+import "./chunk-J27KIHTG.js";
+import {
+  createStdinTokenResolver
+} from "./chunk-O5IBJE6S.js";
+import "./chunk-GFWHHMVV.js";
+import "./chunk-CWT53EYT.js";
+import "./chunk-SSFMJCPF.js";
+import "./chunk-KBG47ZOY.js";
+import "./chunk-SZQCER6S.js";
+import "./chunk-NQP3ECKF.js";
+import {
+  EXIT_CODE,
+  PmCliError
+} from "./chunk-4LTBNUYT.js";
+
+// dist/cli/commands/comments.js
+import { readFile } from "node:fs/promises";
+function isErrnoError(error) {
+  return typeof error === "object" && error !== null && "code" in error;
+}
+async function resolveCommentInput(options, stdinResolver) {
+  const hasAdd = options.add !== void 0;
+  const hasStdin = options.stdin === true;
+  const hasFile = typeof options.file === "string";
+  const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);
+  if (sourceCount === 0) {
+    return { mode: "list" };
+  }
+  if (sourceCount > 1) {
+    throw new PmCliError("Specify comment text using only one input source: --add, --stdin, or --file", EXIT_CODE.USAGE);
+  }
+  if (hasAdd) {
+    const addInput = await stdinResolver.resolveValue(options.add, "--add");
+    return {
+      mode: "add",
+      value: addInput ?? "",
+      emptyFlag: "--add"
+    };
+  }
+  if (hasStdin) {
+    const stdinInput = await stdinResolver.resolveValue("-", "--stdin");
+    return {
+      mode: "stdin",
+      value: stdinInput ?? "",
+      emptyFlag: "--stdin"
+    };
+  }
+  const filePath = options.file?.trim() ?? "";
+  if (!filePath) {
+    throw new PmCliError("--file path cannot be empty", EXIT_CODE.USAGE);
+  }
+  try {
+    const fileInput = await readFile(filePath, "utf8");
+    return {
+      mode: "file",
+      value: fileInput,
+      emptyFlag: "--file"
+    };
+  } catch (error) {
+    if (isErrnoError(error) && error.code === "ENOENT") {
+      throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);
+    }
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new PmCliError(`Failed to read --file path "${filePath}": ${detail}`, EXIT_CODE.USAGE);
+  }
+}
+async function runComments(id, options, global) {
+  const stdinResolver = createStdinTokenResolver();
+  const commentInput = await resolveCommentInput(options, stdinResolver);
+  return runAnnotationCommand(id, options, global, {
+    input: {
+      ...commentInput,
+      value: commentInput.mode === "add" ? parseAnnotationTextInput(commentInput.value ?? "", { stripPlainTextPrefix: true }) : commentInput.value ?? ""
+    },
+    collectionKey: "comments",
+    op: "comment_add",
+    parseText: (raw) => raw,
+    allowAuditBypass: Boolean(options.allowAuditComment),
+    conflictGuidance: {
+      required: "For append-only comment audits on another owner's item, prefer --allow-audit-comment before considering --force.",
+      examples: ['pm comments pm-a1b2 --add "audit note" --author "reviewer" --allow-audit-comment'],
+      nextSteps: [
+        "Retry with --allow-audit-comment for append-only audits that do not mutate item metadata beyond comments.",
+        "Use --force only when an ownership override is explicitly approved."
+      ]
+    }
+  });
+}
+export {
+  runComments
+};
+//# sourceMappingURL=comments-CJWXQI7X.js.map
+
+//# debugId=1e3f73a8-4331-568d-ab80-3e435948371c

package/dist/cli-bundle/chunks/comments-CJWXQI7X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/comments.ts"],"sourcesContent":["import { 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\nexport interface CommentsCommandOptions {\n  add?: string;\n  stdin?: boolean;\n  file?: string;\n  limit?: string;\n  includeMeta?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  allowAuditComment?: boolean;\n}\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\";\n  value?: string;\n  emptyFlag?: string;\n}\n\nfunction isErrnoError(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\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 { mode: \"list\" };\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 {\n      mode: \"add\",\n      value: addInput ?? \"\",\n      emptyFlag: \"--add\",\n    };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return {\n      mode: \"stdin\",\n      value: stdinInput ?? \"\",\n      emptyFlag: \"--stdin\",\n    };\n  }\n  const filePath = options.file?.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 {\n      mode: \"file\",\n      value: fileInput,\n      emptyFlag: \"--file\",\n    };\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\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  return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n    input: {\n      ...commentInput,\n      value:\n        commentInput.mode === \"add\"\n          ? parseAnnotationTextInput(commentInput.value ?? \"\", { stripPlainTextPrefix: true })\n          : (commentInput.value ?? \"\"),\n    },\n    collectionKey: \"comments\",\n    op: \"comment_add\",\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":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,gBAAgB;AAoCzB,SAAS,aAAa,OAAc;AAClC,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU;AAClE;AAEA,eAAe,oBACb,SACA,eAA0D;AAE1D,QAAM,SAAS,QAAQ,QAAQ;AAC/B,QAAM,WAAW,QAAQ,UAAU;AACnC,QAAM,UAAU,OAAO,QAAQ,SAAS;AACxC,QAAM,cAAc,OAAO,MAAM,IAAI,OAAO,QAAQ,IAAI,OAAO,OAAO;AACtE,MAAI,gBAAgB,GAAG;AACrB,WAAO,EAAE,MAAM,OAAM;EACvB;AACA,MAAI,cAAc,GAAG;AACnB,UAAM,IAAI,WAAW,+EAA+E,UAAU,KAAK;EACrH;AACA,MAAI,QAAQ;AACV,UAAM,WAAW,MAAM,cAAc,aAAa,QAAQ,KAAK,OAAO;AACtE,WAAO;MACL,MAAM;MACN,OAAO,YAAY;MACnB,WAAW;;EAEf;AACA,MAAI,UAAU;AACZ,UAAM,aAAa,MAAM,cAAc,aAAa,KAAK,SAAS;AAClE,WAAO;MACL,MAAM;MACN,OAAO,cAAc;MACrB,WAAW;;EAEf;AACA,QAAM,WAAW,QAAQ,MAAM,KAAI,KAAM;AACzC,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,WAAW,+BAA+B,UAAU,KAAK;EACrE;AACA,MAAI;AACF,UAAM,YAAY,MAAM,SAAS,UAAU,MAAM;AACjD,WAAO;MACL,MAAM;MACN,OAAO;MACP,WAAW;;EAEf,SAAS,OAAgB;AACvB,QAAI,aAAa,KAAK,KAAK,MAAM,SAAS,UAAU;AAClD,YAAM,IAAI,WAAW,0BAA0B,QAAQ,IAAI,UAAU,KAAK;IAC5E;AACA,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,UAAM,IAAI,WAAW,+BAA+B,QAAQ,MAAM,MAAM,IAAI,UAAU,KAAK;EAC7F;AACF;AAEA,eAAsB,YAAY,IAAY,SAAiC,QAAqB;AAClG,QAAM,gBAAgB,yBAAwB;AAC9C,QAAM,eAAe,MAAM,oBAAoB,SAAS,aAAa;AAErE,SAAO,qBAA0C,IAAI,SAAS,QAAQ;IACpE,OAAO;MACL,GAAG;MACH,OACE,aAAa,SAAS,QAClB,yBAAyB,aAAa,SAAS,IAAI,EAAE,sBAAsB,KAAI,CAAE,IAChF,aAAa,SAAS;;IAE/B,eAAe;IACf,IAAI;IACJ,WAAW,CAAC,QAAQ;IACpB,kBAAkB,QAAQ,QAAQ,iBAAiB;IACnD,kBAAkB;MAChB,UACE;MACF,UAAU,CAAC,kFAAkF;MAC7F,WAAW;QACT;QACA;;;GAGL;AACH","debugId":"1e3f73a8-4331-568d-ab80-3e435948371c"}