@unbrained/pm-cli 2026.6.12 → 2026.6.16

package/dist/cli/commands/aggregate.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate.js","sources":["cli/commands/aggregate.ts"],"sourceRoot":"/","sourcesContent":["import { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { splitCommaList } from \"../../core/shared/split-comma-list.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport { resolveRuntimeStatusRegistry, type RuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { type ItemStatus } from \"../../types/index.js\";\nimport { runList } from \"./list.js\";\n\ntype AggregateGroupField = \"parent\" | \"type\" | \"priority\" | \"status\" | \"assignee\" | \"tags\" | \"sprint\" | \"release\";\ntype AggregateGroupValue = string | number | null;\ntype AggregateGroupRecord = Partial<Record<AggregateGroupField, AggregateGroupValue>>;\ntype AggregateListedItem = {\n  type: string;\n  status: ItemStatus;\n  priority: number;\n  parent?: string;\n  assignee?: string;\n  tags: string[];\n  sprint?: string;\n  release?: string;\n};\n\nconst AGGREGATE_GROUP_FIELDS: AggregateGroupField[] = [\n  \"parent\",\n  \"type\",\n  \"priority\",\n  \"status\",\n  \"assignee\",\n  \"tags\",\n  \"sprint\",\n  \"release\",\n];\n\nexport interface AggregateOptions {\n  groupBy?: string;\n  count?: boolean;\n  completion?: boolean;\n  sum?: string;\n  avg?: string;\n  includeUnparented?: boolean;\n  status?: string;\n  type?: string;\n  tag?: string;\n  priority?: string;\n  deadlineBefore?: string;\n  deadlineAfter?: string;\n  assignee?: string;\n  assigneeFilter?: string;\n  parent?: string;\n  sprint?: string;\n  release?: string;\n}\n\nexport interface AggregateRow {\n  group: AggregateGroupRecord;\n  count: number;\n  open?: number;\n  in_progress?: number;\n  closed?: number;\n  other?: number;\n  completion_pct?: number;\n  null_count?: number;\n  sum?: number | null;\n  avg?: number | null;\n}\n\nexport interface AggregateResult {\n  groups: AggregateRow[];\n  count: number;\n  totals: {\n    items_considered: number;\n    items_grouped: number;\n    items_skipped_unparented: number;\n  };\n  filters: {\n    group_by: AggregateGroupField[];\n    count: boolean;\n    completion: boolean;\n    sum?: string | null;\n    avg?: string | null;\n    numeric_field?: string | null;\n    include_unparented: boolean;\n    status: ItemStatus | null;\n    type: string | null;\n    tag: string | null;\n    priority: string | null;\n    deadline_before: string | null;\n    deadline_after: string | null;\n    assignee: string | null;\n    assignee_filter: string | null;\n    parent: string | null;\n    sprint: string | null;\n    release: string | null;\n  };\n  now: string;\n  warnings?: string[];\n}\n\nfunction parseStatus(raw: string | undefined, statusRegistry: RuntimeStatusRegistry): ItemStatus | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const normalized = normalizeStatusInput(raw, statusRegistry);\n  if (!normalized) {\n    throw new PmCliError(\n      `Status filter must be one of ${statusRegistry.definitions.map((definition) => definition.id).join(\"|\")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return normalized;\n}\n\ninterface NumericAggregation {\n  field: string;\n  sum: boolean;\n  avg: boolean;\n}\n\nfunction parseNumericAggregation(options: AggregateOptions): NumericAggregation | null {\n  const sumField = options.sum?.trim();\n  const avgField = options.avg?.trim();\n  const normalizedSum = sumField && sumField.length > 0 ? sumField : undefined;\n  const normalizedAvg = avgField && avgField.length > 0 ? avgField : undefined;\n  if (!normalizedSum && !normalizedAvg) {\n    return null;\n  }\n  if (normalizedSum && normalizedAvg && normalizedSum !== normalizedAvg) {\n    throw new PmCliError(\"Aggregate --sum and --avg must target the same numeric field\", EXIT_CODE.USAGE);\n  }\n  return {\n    field: normalizedSum ?? normalizedAvg ?? \"\",\n    sum: normalizedSum !== undefined,\n    avg: normalizedAvg !== undefined,\n  };\n}\n\nfunction parseGroupBy(raw: string | undefined): AggregateGroupField[] {\n  const value = raw?.trim() ?? \"status\";\n  if (value.length === 0) {\n    throw new PmCliError(\"--group-by requires at least one field name\", EXIT_CODE.USAGE);\n  }\n  const requested = splitCommaList(value);\n  if (requested.length === 0) {\n    throw new PmCliError(\"--group-by requires a comma-separated list of fields\", EXIT_CODE.USAGE);\n  }\n  for (const field of requested) {\n    if (!AGGREGATE_GROUP_FIELDS.includes(field as AggregateGroupField)) {\n      throw new PmCliError(\n        `Aggregate group fields must be one of ${AGGREGATE_GROUP_FIELDS.join(\"|\")}; received \"${field}\"`,\n        EXIT_CODE.USAGE,\n      );\n    }\n  }\n  return requested as AggregateGroupField[];\n}\n\nfunction normalizeTagGroupValue(tags: string[]): string | null {\n  const normalized = [...new Set(tags.map((tag) => tag.trim().toLowerCase()).filter((tag) => tag.length > 0))].sort((left, right) =>\n    left.localeCompare(right),\n  );\n  if (normalized.length === 0) {\n    return null;\n  }\n  return normalized.join(\",\");\n}\n\nfunction resolveGroupValue(field: AggregateGroupField, item: AggregateListedItem): AggregateGroupValue {\n  switch (field) {\n    case \"parent\":\n      return item.parent ?? null;\n    case \"type\":\n      return item.type;\n    case \"priority\":\n      return item.priority;\n    case \"status\":\n      return item.status;\n    case \"assignee\":\n      return item.assignee ?? null;\n    case \"tags\":\n      return normalizeTagGroupValue(item.tags);\n    case \"sprint\":\n      return item.sprint ?? null;\n    case \"release\":\n      return item.release ?? null;\n    default:\n      return null;\n  }\n}\n\nfunction compareNullableGroupValue(left: AggregateGroupValue | undefined, right: AggregateGroupValue | undefined): number {\n  const leftValue = left ?? null;\n  const rightValue = right ?? null;\n  if (leftValue === rightValue) {\n    return 0;\n  }\n  if (leftValue === null) {\n    return 1;\n  }\n  if (rightValue === null) {\n    return -1;\n  }\n  if (typeof leftValue === \"number\" && typeof rightValue === \"number\") {\n    return leftValue - rightValue;\n  }\n  return String(leftValue).localeCompare(String(rightValue));\n}\n\nfunction buildGroupKey(groupBy: AggregateGroupField[], group: AggregateGroupRecord): string {\n  return groupBy.map((field) => `${field}:${JSON.stringify(group[field] ?? null)}`).join(\"|\");\n}\n\nfunction compareAggregateRows(\n  left: AggregateRow,\n  right: AggregateRow,\n  groupBy: AggregateGroupField[],\n): number {\n  for (const field of groupBy) {\n    const byField = compareNullableGroupValue(left.group[field], right.group[field]);\n    if (byField !== 0) {\n      return byField;\n    }\n  }\n  return 0;\n}\n\nfunction readNumericAggregateValue(item: AggregateListedItem, field: string): number | null {\n  const source = item as unknown as Record<string, unknown>;\n  const raw = source[field];\n  if (typeof raw === \"number\" && Number.isFinite(raw)) {\n    return raw;\n  }\n  if (typeof raw === \"string\") {\n    const trimmed = raw.trim();\n    if (trimmed.length === 0) {\n      return null;\n    }\n    const parsed = Number(trimmed);\n    if (Number.isFinite(parsed)) {\n      return parsed;\n    }\n  }\n  return null;\n}\n\ninterface AggregateAccumulator {\n  row: AggregateRow;\n  numeric_count: number;\n  numeric_sum: number;\n  null_count: number;\n  open_count: number;\n  in_progress_count: number;\n  closed_count: number;\n  other_count: number;\n}\n\nfunction completionPct(closed: number, total: number): number {\n  if (total <= 0) {\n    return 0;\n  }\n  return Math.round((closed / total) * 10000) / 100;\n}\n\nfunction updateCompletionCounts(accumulator: AggregateAccumulator, status: ItemStatus, statusRegistry: RuntimeStatusRegistry): void {\n  const normalizedStatus = normalizeStatusInput(String(status), statusRegistry) ?? status;\n  if (normalizedStatus === statusRegistry.open_status) {\n    accumulator.open_count += 1;\n    return;\n  }\n  if (normalizedStatus === \"in_progress\" || (statusRegistry.active_statuses.has(normalizedStatus) && normalizedStatus !== statusRegistry.open_status)) {\n    accumulator.in_progress_count += 1;\n    return;\n  }\n  if (statusRegistry.terminal_done_statuses.has(normalizedStatus) || normalizedStatus === statusRegistry.close_status) {\n    accumulator.closed_count += 1;\n    return;\n  }\n  accumulator.other_count += 1;\n}\n\nexport async function runAggregate(options: AggregateOptions, global: GlobalOptions): Promise<AggregateResult> {\n  if (options.count === false) {\n    throw new PmCliError(\"Aggregate grouped counts are always enabled; omit count=false.\", EXIT_CODE.USAGE);\n  }\n\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const groupBy = parseGroupBy(options.groupBy);\n  const status = parseStatus(options.status, statusRegistry);\n  const numericAggregation = parseNumericAggregation(options);\n  const includeCompletion = options.completion === true;\n  const includeUnparented = options.includeUnparented === true;\n\n  const listed = await runList(\n    status,\n    {\n      type: options.type,\n      tag: options.tag,\n      priority: options.priority,\n      deadlineBefore: options.deadlineBefore,\n      deadlineAfter: options.deadlineAfter,\n      assignee: options.assignee,\n      assigneeFilter: options.assigneeFilter,\n      parent: options.parent,\n      sprint: options.sprint,\n      release: options.release,\n    },\n    global,\n  );\n\n  const grouped = new Map<string, AggregateAccumulator>();\n  let skippedUnparented = 0;\n  let groupedItemCount = 0;\n\n  for (const listedItem of listed.items) {\n    const item = listedItem as AggregateListedItem;\n    const group: AggregateGroupRecord = {};\n    for (const field of groupBy) {\n      group[field] = resolveGroupValue(field, item);\n    }\n    if (groupBy.includes(\"parent\") && group.parent === null && !includeUnparented) {\n      skippedUnparented += 1;\n      continue;\n    }\n    const key = buildGroupKey(groupBy, group);\n    const existing = grouped.get(key);\n    const numericValue =\n      numericAggregation === null\n        ? null\n        : readNumericAggregateValue(item, numericAggregation.field);\n    if (existing) {\n      existing.row.count += 1;\n      if (includeCompletion) {\n        updateCompletionCounts(existing, item.status, statusRegistry);\n      }\n      if (numericAggregation !== null) {\n        if (numericValue === null) {\n          existing.null_count += 1;\n        } else {\n          existing.numeric_count += 1;\n          existing.numeric_sum += numericValue;\n        }\n      }\n    } else {\n      const accumulator: AggregateAccumulator = {\n        row: {\n          group,\n          count: 1,\n        },\n        numeric_count: numericValue === null ? 0 : 1,\n        numeric_sum: numericValue ?? 0,\n        null_count: numericValue === null ? 1 : 0,\n        open_count: 0,\n        in_progress_count: 0,\n        closed_count: 0,\n        other_count: 0,\n      };\n      if (includeCompletion) {\n        updateCompletionCounts(accumulator, item.status, statusRegistry);\n      }\n      grouped.set(key, accumulator);\n    }\n    groupedItemCount += 1;\n  }\n\n  const groups = [...grouped.values()]\n    .map((entry) => {\n      const withNumeric: AggregateRow = {\n        ...entry.row,\n      };\n      if (includeCompletion) {\n        withNumeric.open = entry.open_count;\n        withNumeric.in_progress = entry.in_progress_count;\n        withNumeric.closed = entry.closed_count;\n        withNumeric.other = entry.other_count;\n        withNumeric.completion_pct = completionPct(entry.closed_count, entry.row.count);\n      }\n      if (numericAggregation !== null) {\n        withNumeric.null_count = entry.null_count;\n        if (numericAggregation.sum) {\n          withNumeric.sum = entry.numeric_sum;\n        }\n        if (numericAggregation.avg) {\n          withNumeric.avg = entry.numeric_count === 0 ? null : entry.numeric_sum / entry.numeric_count;\n        }\n      }\n      return withNumeric;\n    })\n    .sort((left, right) => compareAggregateRows(left, right, groupBy));\n  const warnings = listed.warnings && listed.warnings.length > 0 ? listed.warnings : undefined;\n\n  return {\n    groups,\n    count: groups.length,\n    totals: {\n      items_considered: listed.items.length,\n      items_grouped: groupedItemCount,\n      items_skipped_unparented: skippedUnparented,\n    },\n    filters: {\n      group_by: groupBy,\n      count: true,\n      completion: includeCompletion,\n      include_unparented: includeUnparented,\n      status: status ?? null,\n      type: options.type ?? null,\n      tag: options.tag ?? null,\n      priority: options.priority ?? null,\n      deadline_before: options.deadlineBefore ?? null,\n      deadline_after: options.deadlineAfter ?? null,\n      assignee: options.assignee ?? null,\n      assignee_filter: options.assigneeFilter ?? null,\n      parent: options.parent ?? null,\n      sprint: options.sprint ?? null,\n      release: options.release ?? null,\n      ...(numericAggregation !== null\n        ? {\n            sum: options.sum ?? null,\n            avg: options.avg ?? null,\n            numeric_field: numericAggregation.field,\n          }\n        : {}),\n    },\n    now: nowIso(),\n    ...(warnings ? { warnings } : {}),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"527ae92a-84d3-5ca0-98b0-198315116706"}
+{"version":3,"file":"aggregate.js","sources":["cli/commands/aggregate.ts"],"sourceRoot":"/","sourcesContent":["import { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { splitCommaList } from \"../../core/shared/split-comma-list.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport { resolveRuntimeStatusRegistry, type RuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { type ItemStatus } from \"../../types/index.js\";\nimport { buildListQueryFilters } from \"./list-filter-shared.js\";\nimport { runList } from \"./list.js\";\n\ntype AggregateGroupField = \"parent\" | \"type\" | \"priority\" | \"status\" | \"assignee\" | \"tags\" | \"sprint\" | \"release\";\ntype AggregateGroupValue = string | number | null;\ntype AggregateGroupRecord = Partial<Record<AggregateGroupField, AggregateGroupValue>>;\ntype AggregateListedItem = {\n  type: string;\n  status: ItemStatus;\n  priority: number;\n  parent?: string;\n  assignee?: string;\n  tags: string[];\n  sprint?: string;\n  release?: string;\n};\n\nconst AGGREGATE_GROUP_FIELDS: AggregateGroupField[] = [\n  \"parent\",\n  \"type\",\n  \"priority\",\n  \"status\",\n  \"assignee\",\n  \"tags\",\n  \"sprint\",\n  \"release\",\n];\n\nexport interface AggregateOptions {\n  groupBy?: string;\n  count?: boolean;\n  completion?: boolean;\n  sum?: string;\n  avg?: string;\n  includeUnparented?: boolean;\n  status?: string;\n  type?: string;\n  tag?: string;\n  priority?: string;\n  deadlineBefore?: string;\n  deadlineAfter?: string;\n  assignee?: string;\n  assigneeFilter?: string;\n  parent?: string;\n  sprint?: string;\n  release?: string;\n}\n\nexport interface AggregateRow {\n  group: AggregateGroupRecord;\n  /**\n   * Human-readable display label for this group. Blank/null group values render\n   * with an explicit \"(unassigned)\"-style label (per dimension) so terminal and\n   * grep-based consumers are never faced with an ambiguous empty key. The\n   * structured `group` record keeps the raw null for machine consumers.\n   */\n  group_label: string;\n  count: number;\n  open?: number;\n  in_progress?: number;\n  closed?: number;\n  other?: number;\n  completion_pct?: number;\n  null_count?: number;\n  sum?: number | null;\n  avg?: number | null;\n}\n\nexport interface AggregateResult {\n  groups: AggregateRow[];\n  count: number;\n  totals: {\n    items_considered: number;\n    items_grouped: number;\n    items_skipped_unparented: number;\n  };\n  filters: {\n    group_by: AggregateGroupField[];\n    count: boolean;\n    completion: boolean;\n    sum?: string | null;\n    avg?: string | null;\n    numeric_field?: string | null;\n    include_unparented: boolean;\n    status: ItemStatus | null;\n    type: string | null;\n    tag: string | null;\n    priority: string | null;\n    deadline_before: string | null;\n    deadline_after: string | null;\n    assignee: string | null;\n    assignee_filter: string | null;\n    parent: string | null;\n    sprint: string | null;\n    release: string | null;\n  };\n  now: string;\n  warnings?: string[];\n}\n\nfunction parseStatus(raw: string | undefined, statusRegistry: RuntimeStatusRegistry): ItemStatus | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const normalized = normalizeStatusInput(raw, statusRegistry);\n  if (!normalized) {\n    throw new PmCliError(\n      `Status filter must be one of ${statusRegistry.definitions.map((definition) => definition.id).join(\"|\")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return normalized;\n}\n\ninterface NumericAggregation {\n  field: string;\n  sum: boolean;\n  avg: boolean;\n}\n\nfunction parseNumericAggregation(options: AggregateOptions): NumericAggregation | null {\n  const sumField = options.sum?.trim();\n  const avgField = options.avg?.trim();\n  const normalizedSum = sumField && sumField.length > 0 ? sumField : undefined;\n  const normalizedAvg = avgField && avgField.length > 0 ? avgField : undefined;\n  if (!normalizedSum && !normalizedAvg) {\n    return null;\n  }\n  if (normalizedSum && normalizedAvg && normalizedSum !== normalizedAvg) {\n    throw new PmCliError(\"Aggregate --sum and --avg must target the same numeric field\", EXIT_CODE.USAGE);\n  }\n  return {\n    field: normalizedSum ?? normalizedAvg!,\n    sum: normalizedSum !== undefined,\n    avg: normalizedAvg !== undefined,\n  };\n}\n\nfunction parseGroupBy(raw: string | undefined): AggregateGroupField[] {\n  const value = raw?.trim() ?? \"status\";\n  if (value.length === 0) {\n    throw new PmCliError(\"--group-by requires at least one field name\", EXIT_CODE.USAGE);\n  }\n  const requested = splitCommaList(value);\n  if (requested.length === 0) {\n    throw new PmCliError(\"--group-by requires a comma-separated list of fields\", EXIT_CODE.USAGE);\n  }\n  for (const field of requested) {\n    if (!AGGREGATE_GROUP_FIELDS.includes(field as AggregateGroupField)) {\n      throw new PmCliError(\n        `Aggregate group fields must be one of ${AGGREGATE_GROUP_FIELDS.join(\"|\")}; received \"${field}\"`,\n        EXIT_CODE.USAGE,\n      );\n    }\n  }\n  return requested as AggregateGroupField[];\n}\n\nfunction normalizeTagGroupValue(tags: string[]): string | null {\n  const normalized = [...new Set(tags.map((tag) => tag.trim().toLowerCase()).filter((tag) => tag.length > 0))].sort((left, right) =>\n    left.localeCompare(right),\n  );\n  if (normalized.length === 0) {\n    return null;\n  }\n  return normalized.join(\",\");\n}\n\nfunction resolveGroupValue(field: AggregateGroupField, item: AggregateListedItem): AggregateGroupValue {\n  switch (field) {\n    case \"parent\":\n      return item.parent ?? null;\n    case \"type\":\n      return item.type;\n    case \"priority\":\n      return item.priority;\n    case \"status\":\n      return item.status;\n    case \"assignee\":\n      return item.assignee ?? null;\n    case \"tags\":\n      return normalizeTagGroupValue(item.tags);\n    case \"sprint\":\n      return item.sprint ?? null;\n    case \"release\":\n      return item.release ?? null;\n    default:\n      return null;\n  }\n}\n\nfunction compareNullableGroupValue(left: AggregateGroupValue | undefined, right: AggregateGroupValue | undefined): number {\n  const leftValue = left ?? null;\n  const rightValue = right ?? null;\n  if (leftValue === rightValue) {\n    return 0;\n  }\n  if (leftValue === null) {\n    return 1;\n  }\n  if (rightValue === null) {\n    return -1;\n  }\n  if (typeof leftValue === \"number\" && typeof rightValue === \"number\") {\n    return leftValue - rightValue;\n  }\n  return String(leftValue).localeCompare(String(rightValue));\n}\n\nfunction buildGroupKey(groupBy: AggregateGroupField[], group: AggregateGroupRecord): string {\n  return groupBy.map((field) => `${field}:${JSON.stringify(group[field] ?? null)}`).join(\"|\");\n}\n\n/** Explicit display label for an empty/blank group value, keyed by dimension. */\nconst EMPTY_AGGREGATE_GROUP_LABELS: Record<AggregateGroupField, string> = {\n  parent: \"(unparented)\",\n  type: \"(untyped)\",\n  priority: \"(no priority)\",\n  status: \"(no status)\",\n  assignee: \"(unassigned)\",\n  tags: \"(untagged)\",\n  sprint: \"(no sprint)\",\n  release: \"(no release)\",\n};\n\n/** Render a single group field's value, substituting an explicit label for null. */\nfunction formatGroupFieldLabel(field: AggregateGroupField, value: AggregateGroupValue | undefined): string {\n  if (value === null || value === undefined || value === \"\") {\n    return EMPTY_AGGREGATE_GROUP_LABELS[field];\n  }\n  return String(value);\n}\n\n/**\n * Build the human-readable label for an aggregate row. Single-field grouping\n * yields the bare (possibly substituted) value; multi-field grouping joins each\n * \"field=value\" pair so composite groups stay unambiguous.\n */\nfunction buildGroupLabel(groupBy: AggregateGroupField[], group: AggregateGroupRecord): string {\n  if (groupBy.length === 1) {\n    return formatGroupFieldLabel(groupBy[0], group[groupBy[0]]);\n  }\n  return groupBy.map((field) => `${field}=${formatGroupFieldLabel(field, group[field])}`).join(\" | \");\n}\n\nfunction compareAggregateRows(\n  left: AggregateRow,\n  right: AggregateRow,\n  groupBy: AggregateGroupField[],\n): number {\n  for (const field of groupBy) {\n    const byField = compareNullableGroupValue(left.group[field], right.group[field]);\n    if (byField !== 0) {\n      return byField;\n    }\n  }\n  return 0;\n}\n\nfunction readNumericAggregateValue(item: AggregateListedItem, field: string): number | null {\n  const source = item as unknown as Record<string, unknown>;\n  const raw = source[field];\n  if (typeof raw === \"number\" && Number.isFinite(raw)) {\n    return raw;\n  }\n  if (typeof raw === \"string\") {\n    const trimmed = raw.trim();\n    if (trimmed.length === 0) {\n      return null;\n    }\n    const parsed = Number(trimmed);\n    if (Number.isFinite(parsed)) {\n      return parsed;\n    }\n  }\n  return null;\n}\n\ninterface AggregateAccumulator {\n  /** group_label is derived once at finalization, so the accumulator omits it. */\n  row: Omit<AggregateRow, \"group_label\">;\n  numeric_count: number;\n  numeric_sum: number;\n  null_count: number;\n  open_count: number;\n  in_progress_count: number;\n  closed_count: number;\n  other_count: number;\n}\n\nfunction completionPct(closed: number, total: number): number {\n  if (total <= 0) {\n    return 0;\n  }\n  return Math.round((closed / total) * 10000) / 100;\n}\n\nfunction updateCompletionCounts(accumulator: AggregateAccumulator, status: ItemStatus, statusRegistry: RuntimeStatusRegistry): void {\n  const normalizedStatus = normalizeStatusInput(String(status), statusRegistry) ?? status;\n  if (normalizedStatus === statusRegistry.open_status) {\n    accumulator.open_count += 1;\n    return;\n  }\n  if (normalizedStatus === \"in_progress\" || (statusRegistry.active_statuses.has(normalizedStatus) && normalizedStatus !== statusRegistry.open_status)) {\n    accumulator.in_progress_count += 1;\n    return;\n  }\n  if (statusRegistry.terminal_done_statuses.has(normalizedStatus) || normalizedStatus === statusRegistry.close_status) {\n    accumulator.closed_count += 1;\n    return;\n  }\n  accumulator.other_count += 1;\n}\n\nexport async function runAggregate(options: AggregateOptions, global: GlobalOptions): Promise<AggregateResult> {\n  if (options.count === false) {\n    throw new PmCliError(\"Aggregate grouped counts are always enabled; omit count=false.\", EXIT_CODE.USAGE);\n  }\n\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const groupBy = parseGroupBy(options.groupBy);\n  const status = parseStatus(options.status, statusRegistry);\n  const numericAggregation = parseNumericAggregation(options);\n  const includeCompletion = options.completion === true;\n  const includeUnparented = options.includeUnparented === true;\n\n  const listed = await runList(\n    status,\n    buildListQueryFilters(options),\n    global,\n  );\n\n  const grouped = new Map<string, AggregateAccumulator>();\n  let skippedUnparented = 0;\n  let groupedItemCount = 0;\n\n  for (const listedItem of listed.items) {\n    const item = listedItem as AggregateListedItem;\n    const group: AggregateGroupRecord = {};\n    for (const field of groupBy) {\n      group[field] = resolveGroupValue(field, item);\n    }\n    if (groupBy.includes(\"parent\") && group.parent === null && !includeUnparented) {\n      skippedUnparented += 1;\n      continue;\n    }\n    const key = buildGroupKey(groupBy, group);\n    const existing = grouped.get(key);\n    const numericValue =\n      numericAggregation === null\n        ? null\n        : readNumericAggregateValue(item, numericAggregation.field);\n    if (existing) {\n      existing.row.count += 1;\n      if (includeCompletion) {\n        updateCompletionCounts(existing, item.status, statusRegistry);\n      }\n      if (numericAggregation !== null) {\n        if (numericValue === null) {\n          existing.null_count += 1;\n        } else {\n          existing.numeric_count += 1;\n          existing.numeric_sum += numericValue;\n        }\n      }\n    } else {\n      const accumulator: AggregateAccumulator = {\n        row: {\n          group,\n          count: 1,\n        },\n        numeric_count: numericValue === null ? 0 : 1,\n        numeric_sum: numericValue ?? 0,\n        null_count: numericValue === null ? 1 : 0,\n        open_count: 0,\n        in_progress_count: 0,\n        closed_count: 0,\n        other_count: 0,\n      };\n      if (includeCompletion) {\n        updateCompletionCounts(accumulator, item.status, statusRegistry);\n      }\n      grouped.set(key, accumulator);\n    }\n    groupedItemCount += 1;\n  }\n\n  const groups = [...grouped.values()]\n    .map((entry) => {\n      const withNumeric: AggregateRow = {\n        ...entry.row,\n        group_label: buildGroupLabel(groupBy, entry.row.group),\n      };\n      if (includeCompletion) {\n        withNumeric.open = entry.open_count;\n        withNumeric.in_progress = entry.in_progress_count;\n        withNumeric.closed = entry.closed_count;\n        withNumeric.other = entry.other_count;\n        withNumeric.completion_pct = completionPct(entry.closed_count, entry.row.count);\n      }\n      if (numericAggregation !== null) {\n        withNumeric.null_count = entry.null_count;\n        if (numericAggregation.sum) {\n          withNumeric.sum = entry.numeric_sum;\n        }\n        if (numericAggregation.avg) {\n          withNumeric.avg = entry.numeric_count === 0 ? null : entry.numeric_sum / entry.numeric_count;\n        }\n      }\n      return withNumeric;\n    })\n    .sort((left, right) => compareAggregateRows(left, right, groupBy));\n  const warnings = listed.warnings && listed.warnings.length > 0 ? listed.warnings : undefined;\n\n  return {\n    groups,\n    count: groups.length,\n    totals: {\n      items_considered: listed.items.length,\n      items_grouped: groupedItemCount,\n      items_skipped_unparented: skippedUnparented,\n    },\n    filters: {\n      group_by: groupBy,\n      count: true,\n      completion: includeCompletion,\n      include_unparented: includeUnparented,\n      status: status ?? null,\n      type: options.type ?? null,\n      tag: options.tag ?? null,\n      priority: options.priority ?? null,\n      deadline_before: options.deadlineBefore ?? null,\n      deadline_after: options.deadlineAfter ?? null,\n      assignee: options.assignee ?? null,\n      assignee_filter: options.assigneeFilter ?? null,\n      parent: options.parent ?? null,\n      sprint: options.sprint ?? null,\n      release: options.release ?? null,\n      ...(numericAggregation !== null\n        ? {\n            sum: options.sum ?? null,\n            avg: options.avg ?? null,\n            numeric_field: numericAggregation.field,\n          }\n        : {}),\n    },\n    now: nowIso(),\n    ...(warnings ? { warnings } : {}),\n  };\n}\n\nexport const _testOnlyAggregateCommand = {\n  buildGroupKey,\n  compareAggregateRows,\n  compareNullableGroupValue,\n  completionPct,\n  normalizeTagGroupValue,\n  parseGroupBy,\n  parseNumericAggregation,\n  parseStatus,\n  readNumericAggregateValue,\n  resolveGroupValue,\n  updateCompletionCounts,\n};\n"],"names":[],"mappings":"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","debugId":"d11bbd6e-51a3-50a0-ba43-98672fae6957"}

package/dist/cli/commands/annotation-command.d.ts

@@ -4,6 +4,7 @@ interface AnnotationEntry {
     created_at: string;
     author: string;
     text: string;
+    edited_at?: string;
 }
 interface AnnotationCommandOptions {
     limit?: string;
@@ -13,9 +14,10 @@ interface AnnotationCommandOptions {
     includeMeta?: boolean;
 }
 interface AnnotationInput {
-    mode: "list" | "add" | "stdin" | "file";
+    mode: "list" | "add" | "stdin" | "file" | "edit" | "delete";
     value?: string;
     emptyFlag?: string;
+    index?: number;
 }
 interface OwnershipConflictGuidance {
     required: string;
@@ -26,6 +28,8 @@ interface AnnotationCommandConfig<TKey extends string> {
     input: AnnotationInput;
     collectionKey: TKey;
     op: Parameters<typeof mutateItem>[0]["op"];
+    editOp?: Parameters<typeof mutateItem>[0]["op"];
+    deleteOp?: Parameters<typeof mutateItem>[0]["op"];
     parseText: (raw: string) => string;
     allowAuditBypass: boolean;
     conflictGuidance: OwnershipConflictGuidance;
@@ -46,4 +50,5 @@ export declare function parseAnnotationTextInput(raw: string, options?: {
 }): string;
 export declare function wrapOwnershipConflict(error: unknown, guidance: OwnershipConflictGuidance): never;
 export declare function runAnnotationCommand<TKey extends string, TEntry extends AnnotationEntry>(id: string, options: AnnotationCommandOptions, global: GlobalOptions, config: AnnotationCommandConfig<TKey>): Promise<AnnotationCommandResult<TKey, TEntry>>;
+export declare function resolveAnnotationIndex(oneBasedIndex: number | undefined, count: number, collectionKey: string): number;
 export {};

package/dist/cli/commands/annotation-command.js

@@ -1,5 +1,5 @@
 
-!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]="caaa2ed3-8a3b-566d-aa92-cfc6540d26c1")}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]="3439c425-b306-5312-b7c4-ed024c1d8b62")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
@@ -82,10 +82,71 @@ export async function runAnnotationCommand(id, options, global, config) {
         return renderAnnotationResult(located.id, config.collectionKey, allEntries, limit, options.includeMeta === true);
     }
     const author = resolveAuthor(options.author, settings.author_default);
+    if (config.input.mode === "delete") {
+        const op = config.deleteOp ?? config.op;
+        let result;
+        try {
+            result = await mutateItem({
+                pmRoot,
+                settings,
+                id,
+                op,
+                author,
+                message: options.message,
+                force: options.force,
+                bypassAssigneeConflict: config.allowAuditBypass,
+                mutate(document) {
+                    const entries = readAnnotationEntries(document.metadata, config.collectionKey);
+                    const arrayIndex = resolveAnnotationIndex(config.input.index, entries.length, config.collectionKey);
+                    entries.splice(arrayIndex, 1);
+                    document.metadata[config.collectionKey] = entries;
+                    return { changedFields: [config.collectionKey] };
+                },
+            });
+        }
+        catch (error) {
+            wrapOwnershipConflict(error, config.conflictGuidance);
+        }
+        const allEntries = readAnnotationEntries(result.item, config.collectionKey);
+        return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);
+    }
     const text = config.parseText(config.input.value ?? "");
     if (!text.trim()) {
         throw new PmCliError(`${config.input.emptyFlag ?? "--add"} text cannot be empty`, EXIT_CODE.USAGE);
     }
+    if (config.input.mode === "edit") {
+        const op = config.editOp ?? config.op;
+        let result;
+        try {
+            result = await mutateItem({
+                pmRoot,
+                settings,
+                id,
+                op,
+                author,
+                message: options.message,
+                force: options.force,
+                bypassAssigneeConflict: config.allowAuditBypass,
+                mutate(document) {
+                    const entries = readAnnotationEntries(document.metadata, config.collectionKey);
+                    const arrayIndex = resolveAnnotationIndex(config.input.index, entries.length, config.collectionKey);
+                    const existing = entries[arrayIndex];
+                    entries[arrayIndex] = {
+                        ...existing,
+                        text,
+                        edited_at: nowIso(),
+                    };
+                    document.metadata[config.collectionKey] = entries;
+                    return { changedFields: [config.collectionKey] };
+                },
+            });
+        }
+        catch (error) {
+            wrapOwnershipConflict(error, config.conflictGuidance);
+        }
+        const allEntries = readAnnotationEntries(result.item, config.collectionKey);
+        return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);
+    }
     let result;
     try {
         result = await mutateItem({
@@ -115,6 +176,15 @@ export async function runAnnotationCommand(id, options, global, config) {
     const allEntries = readAnnotationEntries(result.item, config.collectionKey);
     return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);
 }
+export function resolveAnnotationIndex(oneBasedIndex, count, collectionKey) {
+    if (oneBasedIndex === undefined || !Number.isInteger(oneBasedIndex) || oneBasedIndex < 1 || oneBasedIndex > count) {
+        const singular = collectionKey.replace(/s$/, "");
+        const label = `${singular.charAt(0).toUpperCase()}${singular.slice(1)}`;
+        const noun = count === 1 ? `1 ${singular}` : `${count} ${collectionKey}`;
+        throw new PmCliError(`${label} index ${oneBasedIndex ?? "(missing)"} out of range (item has ${noun})`, EXIT_CODE.USAGE);
+    }
+    return oneBasedIndex - 1;
+}
 function renderAnnotationResult(id, collectionKey, allEntries, limit, includeMeta) {
     const entries = limitAnnotationEntries(allEntries, limit);
     return {
@@ -132,4 +202,4 @@ function renderAnnotationResult(id, collectionKey, allEntries, limit, includeMet
     };
 }
 //# sourceMappingURL=annotation-command.js.map
-//# debugId=caaa2ed3-8a3b-566d-aa92-cfc6540d26c1
+//# debugId=3439c425-b306-5312-b7c4-ed024c1d8b62

package/dist/cli/commands/annotation-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotation-command.js","sources":["cli/commands/annotation-command.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { parseCsvKv } from \"../../core/item/parse.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 { nowIso } from \"../../core/shared/time.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { locateItem, mutateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseLimit } from \"../shared-parsers.js\";\n\ninterface AnnotationEntry {\n  created_at: string;\n  author: string;\n  text: string;\n}\n\ninterface AnnotationCommandOptions {\n  limit?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  includeMeta?: boolean;\n}\n\ninterface AnnotationInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\";\n  value?: string;\n  emptyFlag?: string;\n}\n\ninterface OwnershipConflictGuidance {\n  required: string;\n  examples: string[];\n  nextSteps: string[];\n}\n\ninterface AnnotationCommandConfig<TKey extends string> {\n  input: AnnotationInput;\n  collectionKey: TKey;\n  op: Parameters<typeof mutateItem>[0][\"op\"];\n  parseText: (raw: string) => string;\n  allowAuditBypass: boolean;\n  conflictGuidance: OwnershipConflictGuidance;\n}\n\ntype AnnotationCommandResult<TKey extends string, TEntry extends AnnotationEntry> = {\n  id: string;\n  count: number;\n} & Record<TKey, TEntry[]> & {\n    total_count?: number;\n    returned_count?: number;\n    has_more?: boolean;\n    limit?: number;\n  };\n\nexport function limitAnnotationEntries<TEntry>(values: TEntry[], limit: number | undefined): TEntry[] {\n  if (limit === undefined) return values;\n  if (limit === 0) return [];\n  return values.slice(Math.max(0, values.length - limit));\n}\n\nexport function readAnnotationEntries<TEntry>(source: Record<string, unknown>, collectionKey: string): TEntry[] {\n  const value = source[collectionKey];\n  return Array.isArray(value) ? (value as TEntry[]) : [];\n}\n\nexport function parseAnnotationTextInput(raw: string, options: { stripPlainTextPrefix?: boolean } = {}): string {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return \"\";\n  }\n  const textPrefixMatch = /^(?:[-*+]\\s*)?text\\s*[:=]/i.exec(trimmed);\n  if (options.stripPlainTextPrefix === true && textPrefixMatch && !trimmed.startsWith(\"```\")) {\n    const text = trimmed.slice(textPrefixMatch[0].length).trim();\n    return text || trimmed;\n  }\n  const looksStructured = /^(?:[-*+]\\s*)?text\\s*[:=]/im.test(trimmed) || trimmed.startsWith(\"```\");\n  if (!looksStructured) {\n    return trimmed;\n  }\n  try {\n    const kv = parseCsvKv(trimmed, \"--add\");\n    const keys = Object.keys(kv).map((key) => key.trim().toLowerCase());\n    if (keys.some((key) => key !== \"text\")) {\n      return trimmed;\n    }\n    const text = kv.text?.trim();\n    return text || trimmed;\n  } catch {\n    return trimmed;\n  }\n}\n\nexport function wrapOwnershipConflict(error: unknown, guidance: OwnershipConflictGuidance): never {\n  if (\n    error instanceof PmCliError &&\n    error.exitCode === EXIT_CODE.CONFLICT &&\n    error.message.includes(\"is assigned to\") &&\n    error.message.includes(\"Use --force to override\")\n  ) {\n    throw new PmCliError(error.message, error.exitCode, {\n      code: \"ownership_conflict\",\n      required: guidance.required,\n      examples: guidance.examples,\n      nextSteps: guidance.nextSteps,\n    });\n  }\n  throw error;\n}\n\nexport async function runAnnotationCommand<TKey extends string, TEntry extends AnnotationEntry>(\n  id: string,\n  options: AnnotationCommandOptions,\n  global: GlobalOptions,\n  config: AnnotationCommandConfig<TKey>,\n): Promise<AnnotationCommandResult<TKey, TEntry>> {\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 typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const limit = parseLimit(options.limit);\n\n  if (config.input.mode === \"list\") {\n    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n    if (!located) {\n      throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n    }\n    const loaded = await readLocatedItem(located, { schema: settings.schema });\n    const allEntries = readAnnotationEntries<TEntry>(loaded.document.metadata, config.collectionKey);\n    return renderAnnotationResult(located.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\n  }\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const text = config.parseText(config.input.value ?? \"\");\n  if (!text.trim()) {\n    throw new PmCliError(`${config.input.emptyFlag ?? \"--add\"} text cannot be empty`, EXIT_CODE.USAGE);\n  }\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: config.op,\n      author,\n      message: options.message,\n      force: options.force,\n      bypassAssigneeConflict: config.allowAuditBypass,\n      mutate(document) {\n        const entries = readAnnotationEntries<TEntry>(document.metadata, config.collectionKey);\n        entries.push({\n          created_at: nowIso(),\n          author,\n          text,\n        } as TEntry);\n        document.metadata[config.collectionKey] = entries as never;\n        return { changedFields: [config.collectionKey] };\n      },\n    });\n  } catch (error: unknown) {\n    wrapOwnershipConflict(error, config.conflictGuidance);\n  }\n\n  const allEntries = readAnnotationEntries<TEntry>(result.item, config.collectionKey);\n  return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\n}\n\nfunction renderAnnotationResult<TKey extends string, TEntry extends AnnotationEntry>(\n  id: string,\n  collectionKey: TKey,\n  allEntries: TEntry[],\n  limit: number | undefined,\n  includeMeta: boolean,\n): AnnotationCommandResult<TKey, TEntry> {\n  const entries = limitAnnotationEntries(allEntries, limit);\n  return {\n    id,\n    [collectionKey]: entries,\n    count: entries.length,\n    ...(includeMeta\n      ? {\n          total_count: allEntries.length,\n          returned_count: entries.length,\n          has_more: entries.length < allEntries.length,\n          ...(limit !== undefined ? { limit } : {}),\n        }\n      : {}),\n  } as AnnotationCommandResult<TKey, TEntry>;\n}\n"],"names":[],"mappings":"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","debugId":"caaa2ed3-8a3b-566d-aa92-cfc6540d26c1"}
+{"version":3,"file":"annotation-command.js","sources":["cli/commands/annotation-command.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { parseCsvKv } from \"../../core/item/parse.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 { nowIso } from \"../../core/shared/time.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { locateItem, mutateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseLimit } from \"../shared-parsers.js\";\n\ninterface AnnotationEntry {\n  created_at: string;\n  author: string;\n  text: string;\n  edited_at?: string;\n}\n\ninterface AnnotationCommandOptions {\n  limit?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  includeMeta?: boolean;\n}\n\ninterface AnnotationInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\ninterface OwnershipConflictGuidance {\n  required: string;\n  examples: string[];\n  nextSteps: string[];\n}\n\ninterface AnnotationCommandConfig<TKey extends string> {\n  input: AnnotationInput;\n  collectionKey: TKey;\n  op: Parameters<typeof mutateItem>[0][\"op\"];\n  editOp?: Parameters<typeof mutateItem>[0][\"op\"];\n  deleteOp?: Parameters<typeof mutateItem>[0][\"op\"];\n  parseText: (raw: string) => string;\n  allowAuditBypass: boolean;\n  conflictGuidance: OwnershipConflictGuidance;\n}\n\ntype AnnotationCommandResult<TKey extends string, TEntry extends AnnotationEntry> = {\n  id: string;\n  count: number;\n} & Record<TKey, TEntry[]> & {\n    total_count?: number;\n    returned_count?: number;\n    has_more?: boolean;\n    limit?: number;\n  };\n\nexport function limitAnnotationEntries<TEntry>(values: TEntry[], limit: number | undefined): TEntry[] {\n  if (limit === undefined) return values;\n  if (limit === 0) return [];\n  return values.slice(Math.max(0, values.length - limit));\n}\n\nexport function readAnnotationEntries<TEntry>(source: Record<string, unknown>, collectionKey: string): TEntry[] {\n  const value = source[collectionKey];\n  return Array.isArray(value) ? (value as TEntry[]) : [];\n}\n\nexport function parseAnnotationTextInput(raw: string, options: { stripPlainTextPrefix?: boolean } = {}): string {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return \"\";\n  }\n  const textPrefixMatch = /^(?:[-*+]\\s*)?text\\s*[:=]/i.exec(trimmed);\n  if (options.stripPlainTextPrefix === true && textPrefixMatch && !trimmed.startsWith(\"```\")) {\n    const text = trimmed.slice(textPrefixMatch[0].length).trim();\n    return text || trimmed;\n  }\n  const looksStructured = /^(?:[-*+]\\s*)?text\\s*[:=]/im.test(trimmed) || trimmed.startsWith(\"```\");\n  if (!looksStructured) {\n    return trimmed;\n  }\n  try {\n    const kv = parseCsvKv(trimmed, \"--add\");\n    const keys = Object.keys(kv).map((key) => key.trim().toLowerCase());\n    if (keys.some((key) => key !== \"text\")) {\n      return trimmed;\n    }\n    const text = kv.text?.trim();\n    return text || trimmed;\n  } catch {\n    return trimmed;\n  }\n}\n\nexport function wrapOwnershipConflict(error: unknown, guidance: OwnershipConflictGuidance): never {\n  if (\n    error instanceof PmCliError &&\n    error.exitCode === EXIT_CODE.CONFLICT &&\n    error.message.includes(\"is assigned to\") &&\n    error.message.includes(\"Use --force to override\")\n  ) {\n    throw new PmCliError(error.message, error.exitCode, {\n      code: \"ownership_conflict\",\n      required: guidance.required,\n      examples: guidance.examples,\n      nextSteps: guidance.nextSteps,\n    });\n  }\n  throw error;\n}\n\nexport async function runAnnotationCommand<TKey extends string, TEntry extends AnnotationEntry>(\n  id: string,\n  options: AnnotationCommandOptions,\n  global: GlobalOptions,\n  config: AnnotationCommandConfig<TKey>,\n): Promise<AnnotationCommandResult<TKey, TEntry>> {\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 typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const limit = parseLimit(options.limit);\n\n  if (config.input.mode === \"list\") {\n    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n    if (!located) {\n      throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n    }\n    const loaded = await readLocatedItem(located, { schema: settings.schema });\n    const allEntries = readAnnotationEntries<TEntry>(loaded.document.metadata, config.collectionKey);\n    return renderAnnotationResult(located.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\n  }\n\n  const author = resolveAuthor(options.author, settings.author_default);\n\n  if (config.input.mode === \"delete\") {\n    const op = config.deleteOp ?? config.op;\n    let result: Awaited<ReturnType<typeof mutateItem>>;\n    try {\n      result = await mutateItem({\n        pmRoot,\n        settings,\n        id,\n        op,\n        author,\n        message: options.message,\n        force: options.force,\n        bypassAssigneeConflict: config.allowAuditBypass,\n        mutate(document) {\n          const entries = readAnnotationEntries<TEntry>(document.metadata, config.collectionKey);\n          const arrayIndex = resolveAnnotationIndex(config.input.index, entries.length, config.collectionKey);\n          entries.splice(arrayIndex, 1);\n          document.metadata[config.collectionKey] = entries as never;\n          return { changedFields: [config.collectionKey] };\n        },\n      });\n    } catch (error: unknown) {\n      wrapOwnershipConflict(error, config.conflictGuidance);\n    }\n    const allEntries = readAnnotationEntries<TEntry>(result.item, config.collectionKey);\n    return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\n  }\n\n  const text = config.parseText(config.input.value ?? \"\");\n  if (!text.trim()) {\n    throw new PmCliError(`${config.input.emptyFlag ?? \"--add\"} text cannot be empty`, EXIT_CODE.USAGE);\n  }\n\n  if (config.input.mode === \"edit\") {\n    const op = config.editOp ?? config.op;\n    let result: Awaited<ReturnType<typeof mutateItem>>;\n    try {\n      result = await mutateItem({\n        pmRoot,\n        settings,\n        id,\n        op,\n        author,\n        message: options.message,\n        force: options.force,\n        bypassAssigneeConflict: config.allowAuditBypass,\n        mutate(document) {\n          const entries = readAnnotationEntries<TEntry>(document.metadata, config.collectionKey);\n          const arrayIndex = resolveAnnotationIndex(config.input.index, entries.length, config.collectionKey);\n          const existing = entries[arrayIndex];\n          entries[arrayIndex] = {\n            ...existing,\n            text,\n            edited_at: nowIso(),\n          } as TEntry;\n          document.metadata[config.collectionKey] = entries as never;\n          return { changedFields: [config.collectionKey] };\n        },\n      });\n    } catch (error: unknown) {\n      wrapOwnershipConflict(error, config.conflictGuidance);\n    }\n    const allEntries = readAnnotationEntries<TEntry>(result.item, config.collectionKey);\n    return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\n  }\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: config.op,\n      author,\n      message: options.message,\n      force: options.force,\n      bypassAssigneeConflict: config.allowAuditBypass,\n      mutate(document) {\n        const entries = readAnnotationEntries<TEntry>(document.metadata, config.collectionKey);\n        entries.push({\n          created_at: nowIso(),\n          author,\n          text,\n        } as TEntry);\n        document.metadata[config.collectionKey] = entries as never;\n        return { changedFields: [config.collectionKey] };\n      },\n    });\n  } catch (error: unknown) {\n    wrapOwnershipConflict(error, config.conflictGuidance);\n  }\n\n  const allEntries = readAnnotationEntries<TEntry>(result.item, config.collectionKey);\n  return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\n}\n\nexport function resolveAnnotationIndex(\n  oneBasedIndex: number | undefined,\n  count: number,\n  collectionKey: string,\n): number {\n  if (oneBasedIndex === undefined || !Number.isInteger(oneBasedIndex) || oneBasedIndex < 1 || oneBasedIndex > count) {\n    const singular = collectionKey.replace(/s$/, \"\");\n    const label = `${singular.charAt(0).toUpperCase()}${singular.slice(1)}`;\n    const noun = count === 1 ? `1 ${singular}` : `${count} ${collectionKey}`;\n    throw new PmCliError(\n      `${label} index ${oneBasedIndex ?? \"(missing)\"} out of range (item has ${noun})`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return oneBasedIndex - 1;\n}\n\nfunction renderAnnotationResult<TKey extends string, TEntry extends AnnotationEntry>(\n  id: string,\n  collectionKey: TKey,\n  allEntries: TEntry[],\n  limit: number | undefined,\n  includeMeta: boolean,\n): AnnotationCommandResult<TKey, TEntry> {\n  const entries = limitAnnotationEntries(allEntries, limit);\n  return {\n    id,\n    [collectionKey]: entries,\n    count: entries.length,\n    ...(includeMeta\n      ? {\n          total_count: allEntries.length,\n          returned_count: entries.length,\n          has_more: entries.length < allEntries.length,\n          ...(limit !== undefined ? { limit } : {}),\n        }\n      : {}),\n  } as AnnotationCommandResult<TKey, TEntry>;\n}\n"],"names":[],"mappings":"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","debugId":"3439c425-b306-5312-b7c4-ed024c1d8b62"}

package/dist/cli/commands/append.js

@@ -1,5 +1,5 @@
 
-!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]="14238d29-d4c8-5988-afde-c4d3b52c450d")}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]="a0d5a975-65e4-5ac7-bf69-eded8e42aea4")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
@@ -20,8 +20,9 @@ export async function runAppend(id, options, global) {
     }
     const settings = await readSettings(pmRoot);
     const author = resolveAuthor(options.author, settings.author_default);
+    // options.body is guaranteed defined by the guard above, so resolveValue returns a defined string.
     const bodyInput = await stdinResolver.resolveValue(options.body, "--body");
-    const appended = (bodyInput ?? "").trim();
+    const appended = bodyInput.trim();
     const result = await mutateItem({
         pmRoot,
         settings,
@@ -46,4 +47,4 @@ export async function runAppend(id, options, global) {
     };
 }
 //# sourceMappingURL=append.js.map
-//# debugId=14238d29-d4c8-5988-afde-c4d3b52c450d
+//# debugId=a0d5a975-65e4-5ac7-bf69-eded8e42aea4

package/dist/cli/commands/append.js.map

@@ -1 +1 @@
-{"version":3,"file":"append.js","sources":["cli/commands/append.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nexport interface AppendCommandOptions {\n  body: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\nexport interface AppendResult {\n  item: Record<string, unknown>;\n  appended: string;\n  changed_fields: string[];\n}\n\n\nexport async function runAppend(id: string, options: AppendCommandOptions, global: GlobalOptions): Promise<AppendResult> {\n  if (options.body === undefined) {\n    throw new PmCliError(\"Missing required --body text\", EXIT_CODE.USAGE);\n  }\n  const stdinResolver = createStdinTokenResolver();\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  const bodyInput = await stdinResolver.resolveValue(options.body, \"--body\");\n  const appended = (bodyInput ?? \"\").trim();\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"append\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      if (appended.length === 0) {\n        return { changedFields: [] };\n      }\n      const spacer = document.body.trim().length > 0 ? \"\\n\\n\" : \"\";\n      document.body = `${document.body.replace(/\\s+$/, \"\")}${spacer}${appended}\\n`;\n      return { changedFields: [\"body\"] };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    appended: appended.length > 0 ? appended : \"\",\n    changed_fields: result.changedFields,\n  };\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAgB5D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAU,EAAE,OAA6B,EAAE,MAAqB;IAC9F,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,UAAU,CAAC,8BAA8B,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,aAAa,GAAG,wBAAwB,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,iCAAiC,MAAM,sBAAsB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,MAAM;QACN,QAAQ;QACR,EAAE;QACF,EAAE,EAAE,QAAQ;QACZ,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,CAAC,QAAQ;YACb,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;YAC/B,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ,IAAI,CAAC;YAC7E,OAAO,EAAE,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC7C,cAAc,EAAE,MAAM,CAAC,aAAa;KACrC,CAAC;AACJ,CAAC","debugId":"14238d29-d4c8-5988-afde-c4d3b52c450d"}
+{"version":3,"file":"append.js","sources":["cli/commands/append.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nexport interface AppendCommandOptions {\n  body: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\nexport interface AppendResult {\n  item: Record<string, unknown>;\n  appended: string;\n  changed_fields: string[];\n}\n\n\nexport async function runAppend(id: string, options: AppendCommandOptions, global: GlobalOptions): Promise<AppendResult> {\n  if (options.body === undefined) {\n    throw new PmCliError(\"Missing required --body text\", EXIT_CODE.USAGE);\n  }\n  const stdinResolver = createStdinTokenResolver();\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  // options.body is guaranteed defined by the guard above, so resolveValue returns a defined string.\n  const bodyInput = await stdinResolver.resolveValue(options.body, \"--body\");\n  const appended = (bodyInput as string).trim();\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"append\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      if (appended.length === 0) {\n        return { changedFields: [] };\n      }\n      const spacer = document.body.trim().length > 0 ? \"\\n\\n\" : \"\";\n      document.body = `${document.body.replace(/\\s+$/, \"\")}${spacer}${appended}\\n`;\n      return { changedFields: [\"body\"] };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    appended: appended.length > 0 ? appended : \"\",\n    changed_fields: result.changedFields,\n  };\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAgB5D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAU,EAAE,OAA6B,EAAE,MAAqB;IAC9F,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,UAAU,CAAC,8BAA8B,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,aAAa,GAAG,wBAAwB,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,iCAAiC,MAAM,sBAAsB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtE,mGAAmG;IACnG,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAI,SAAoB,CAAC,IAAI,EAAE,CAAC;IAE9C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,MAAM;QACN,QAAQ;QACR,EAAE;QACF,EAAE,EAAE,QAAQ;QACZ,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,CAAC,QAAQ;YACb,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;YAC/B,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ,IAAI,CAAC;YAC7E,OAAO,EAAE,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC7C,cAAc,EAAE,MAAM,CAAC,aAAa;KACrC,CAAC;AACJ,CAAC","debugId":"a0d5a975-65e4-5ac7-bf69-eded8e42aea4"}

package/dist/cli/commands/close-many.d.ts

@@ -1,4 +1,5 @@
 import type { GlobalOptions } from "../../core/shared/command-types.js";
+import { readSettings } from "../../core/store/settings.js";
 import { type ListOptions } from "./list.js";
 export interface CloseManyCommandOptions {
     status?: string;
@@ -59,5 +60,24 @@ export interface CloseManyResult {
     }>;
     ids: string[];
 }
+declare function hasCloseManyFilters(list: ListOptions | undefined, status: string | undefined): boolean;
+declare function hasCloseManyRollbackConflicts(list: ListOptions | undefined, status: string | undefined): boolean;
+declare function rejectBlankIdsFilter(list: ListOptions | undefined): void;
+declare function activeListOptions(list: ListOptions | undefined): ListOptions;
+declare function resolveReason(reason: unknown, required: boolean): string | undefined;
+declare function buildActiveChildrenByParent(pmRoot: string, settings: Awaited<ReturnType<typeof readSettings>>): Promise<{
+    childrenByParent: Map<string, string[]>;
+    parentByChild: Map<string, string>;
+}>;
+declare function hierarchyDepth(id: string, parentByChild: Map<string, string>, cache?: Map<string, number>): number;
 export declare function runCloseMany(options: CloseManyCommandOptions, global: GlobalOptions): Promise<CloseManyResult>;
+export declare const _testOnly: {
+    activeListOptions: typeof activeListOptions;
+    buildActiveChildrenByParent: typeof buildActiveChildrenByParent;
+    hasCloseManyFilters: typeof hasCloseManyFilters;
+    hasCloseManyRollbackConflicts: typeof hasCloseManyRollbackConflicts;
+    hierarchyDepth: typeof hierarchyDepth;
+    rejectBlankIdsFilter: typeof rejectBlankIdsFilter;
+    resolveReason: typeof resolveReason;
+};
 export {};

package/dist/cli/commands/close-many.js

@@ -1,5 +1,5 @@
 
-!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]="4372c294-2c28-51d8-9a8a-6640d8188b5a")}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]="6666a3ef-d9aa-56b5-8574-e532ce119f37")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { createCheckpointId, loadMutationCheckpoint, restoreCheckpointItems, writeMutationCheckpoint, } from "../../core/checkpoint/mutation-checkpoint.js";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
@@ -15,6 +15,7 @@ import { listAllFrontMatterLight } from "../../core/store/item-store.js";
 import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
 import { runClose } from "./close.js";
+import { hasListFilters } from "./list-filter-shared.js";
 import { runList } from "./list.js";
 import { runRestore } from "./restore.js";
 const CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;
@@ -32,29 +33,10 @@ const CLOSE_MANY_FILTER_GUIDANCE = [
     "--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));
+    return hasListFilters(list, status, { includePagination: false });
 }
 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));
+    return hasListFilters(list, status);
 }
 function rejectBlankIdsFilter(list) {
     if (list?.ids != null && String(list.ids).trim().length === 0) {
@@ -307,5 +289,14 @@ export async function runCloseMany(options, global) {
         ids: closedIds,
     };
 }
+export const _testOnly = {
+    activeListOptions,
+    buildActiveChildrenByParent,
+    hasCloseManyFilters,
+    hasCloseManyRollbackConflicts,
+    hierarchyDepth,
+    rejectBlankIdsFilter,
+    resolveReason,
+};
 //# sourceMappingURL=close-many.js.map
-//# debugId=4372c294-2c28-51d8-9a8a-6640d8188b5a
+//# debugId=6666a3ef-d9aa-56b5-8574-e532ce119f37