@unbrained/pm-cli 2026.6.30 → 2026.7.2

package/dist/cli-bundle/chunks/{aggregate-XJHLZQ5X.js.map → aggregate-SW5PNGCS.js.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/aggregate.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/aggregate\n *\n * Implements the pm aggregate command surface and its agent-facing runtime behavior.\n */\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 { splitCommaList } from \"../../core/shared/split-comma-list.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport { parseStatusFilterCsv } from \"../../core/item/status-filter.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\n/**\n * Documents the aggregate options payload exchanged by command, SDK, and package integrations.\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\n/**\n * Documents the aggregate row payload exchanged by command, SDK, and package integrations.\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\n/**\n * Documents the aggregate result payload exchanged by command, SDK, and package integrations.\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  const statuses = parseStatusFilterCsv(raw, statusRegistry, { strict: true, flagLabel: \"--status\" });\n  if (!statuses || statuses.length === 0) {\n    return undefined;\n  }\n  if (statuses.length > 1) {\n    throw new PmCliError(\n      'Aggregate --status accepts one status, or the standalone \"all\" sentinel.',\n      EXIT_CODE.USAGE,\n    );\n  }\n  return statuses[0];\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\n/**\n * Implements run aggregate for the public runtime surface of this module.\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"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @module cli/commands/aggregate\n *\n * Implements the pm aggregate command surface and its agent-facing runtime behavior.\n */\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 { splitCommaList } from \"../../core/shared/split-comma-list.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport { parseStatusFilterCsv } from \"../../core/item/status-filter.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\n/**\n * Documents the aggregate options payload exchanged by command, SDK, and package integrations.\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\n/**\n * Documents the aggregate row payload exchanged by command, SDK, and package integrations.\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\n/**\n * Documents the aggregate result payload exchanged by command, SDK, and package integrations.\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  const statuses = parseStatusFilterCsv(raw, statusRegistry, { strict: true, flagLabel: \"--status\" });\n  if (!statuses || statuses.length === 0) {\n    return undefined;\n  }\n  if (statuses.length > 1) {\n    throw new PmCliError(\n      'Aggregate --status accepts one status, or the standalone \"all\" sentinel.',\n      EXIT_CODE.USAGE,\n    );\n  }\n  return statuses[0];\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\nfunction createAggregateAccumulator(\n  group: AggregateGroupRecord,\n  numericValue: number | null,\n): AggregateAccumulator {\n  return {\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}\n\nfunction updateNumericAggregation(accumulator: AggregateAccumulator, numericValue: number | null): void {\n  if (numericValue === null) {\n    accumulator.null_count += 1;\n    return;\n  }\n  accumulator.numeric_count += 1;\n  accumulator.numeric_sum += numericValue;\n}\n\nfunction updateAggregateAccumulator(params: {\n  accumulator: AggregateAccumulator;\n  item: AggregateListedItem;\n  statusRegistry: RuntimeStatusRegistry;\n  includeCompletion: boolean;\n  numericAggregation: NumericAggregation | null;\n  numericValue: number | null;\n}): void {\n  params.accumulator.row.count += 1;\n  if (params.includeCompletion) {\n    updateCompletionCounts(params.accumulator, params.item.status, params.statusRegistry);\n  }\n  if (params.numericAggregation !== null) {\n    updateNumericAggregation(params.accumulator, params.numericValue);\n  }\n}\n\nfunction buildAggregateGroup(groupBy: AggregateGroupField[], item: AggregateListedItem): AggregateGroupRecord {\n  const group: AggregateGroupRecord = {};\n  for (const field of groupBy) {\n    group[field] = resolveGroupValue(field, item);\n  }\n  return group;\n}\n\nfunction finalizeAggregateRow(\n  entry: AggregateAccumulator,\n  groupBy: AggregateGroupField[],\n  includeCompletion: boolean,\n  numericAggregation: NumericAggregation | null,\n): AggregateRow {\n  const row: AggregateRow = {\n    ...entry.row,\n    group_label: buildGroupLabel(groupBy, entry.row.group),\n  };\n  if (includeCompletion) {\n    row.open = entry.open_count;\n    row.in_progress = entry.in_progress_count;\n    row.closed = entry.closed_count;\n    row.other = entry.other_count;\n    row.completion_pct = completionPct(entry.closed_count, entry.row.count);\n  }\n  if (numericAggregation !== null) {\n    row.null_count = entry.null_count;\n    if (numericAggregation.sum) {\n      row.sum = entry.numeric_sum;\n    }\n    if (numericAggregation.avg) {\n      row.avg = entry.numeric_count === 0 ? null : entry.numeric_sum / entry.numeric_count;\n    }\n  }\n  return row;\n}\n\nfunction buildAggregateFilters(params: {\n  groupBy: AggregateGroupField[];\n  includeCompletion: boolean;\n  includeUnparented: boolean;\n  status: ItemStatus | undefined;\n  options: AggregateOptions;\n  numericAggregation: NumericAggregation | null;\n}): AggregateResult[\"filters\"] {\n  return {\n    group_by: params.groupBy,\n    count: true,\n    completion: params.includeCompletion,\n    include_unparented: params.includeUnparented,\n    status: params.status ?? null,\n    type: params.options.type ?? null,\n    tag: params.options.tag ?? null,\n    priority: params.options.priority ?? null,\n    deadline_before: params.options.deadlineBefore ?? null,\n    deadline_after: params.options.deadlineAfter ?? null,\n    assignee: params.options.assignee ?? null,\n    assignee_filter: params.options.assigneeFilter ?? null,\n    parent: params.options.parent ?? null,\n    sprint: params.options.sprint ?? null,\n    release: params.options.release ?? null,\n    ...(params.numericAggregation !== null\n      ? {\n          sum: params.options.sum ?? null,\n          avg: params.options.avg ?? null,\n          numeric_field: params.numericAggregation.field,\n        }\n      : {}),\n  };\n}\n\n/**\n * Implements run aggregate for the public runtime surface of this module.\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 = buildAggregateGroup(groupBy, item);\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      updateAggregateAccumulator({\n        accumulator: existing,\n        item,\n        statusRegistry,\n        includeCompletion,\n        numericAggregation,\n        numericValue,\n      });\n    } else {\n      const accumulator = createAggregateAccumulator(group, numericValue);\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) => finalizeAggregateRow(entry, groupBy, includeCompletion, numericAggregation))\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: buildAggregateFilters({ groupBy, includeCompletion, includeUnparented, status, options, numericAggregation }),\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"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,IAAM,yBAAgD;EACpD;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;AAoFF,SAAS,YAAY,KAAyB,gBAAqC;AACjF,QAAM,WAAW,qBAAqB,KAAK,gBAAgB,EAAE,QAAQ,MAAM,WAAW,WAAU,CAAE;AAClG,MAAI,CAAC,YAAY,SAAS,WAAW,GAAG;AACtC,WAAO;EACT;AACA,MAAI,SAAS,SAAS,GAAG;AACvB,UAAM,IAAI,WACR,4EACA,UAAU,KAAK;EAEnB;AACA,SAAO,SAAS,CAAC;AACnB;AAQA,SAAS,wBAAwB,SAAyB;AACxD,QAAM,WAAW,QAAQ,KAAK,KAAI;AAClC,QAAM,WAAW,QAAQ,KAAK,KAAI;AAClC,QAAM,gBAAgB,YAAY,SAAS,SAAS,IAAI,WAAW;AACnE,QAAM,gBAAgB,YAAY,SAAS,SAAS,IAAI,WAAW;AACnE,MAAI,CAAC,iBAAiB,CAAC,eAAe;AACpC,WAAO;EACT;AACA,MAAI,iBAAiB,iBAAiB,kBAAkB,eAAe;AACrE,UAAM,IAAI,WAAW,gEAAgE,UAAU,KAAK;EACtG;AACA,SAAO;IACL,OAAO,iBAAiB;IACxB,KAAK,kBAAkB;IACvB,KAAK,kBAAkB;;AAE3B;AAEA,SAAS,aAAa,KAAuB;AAC3C,QAAM,QAAQ,KAAK,KAAI,KAAM;AAC7B,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,WAAW,+CAA+C,UAAU,KAAK;EACrF;AACA,QAAM,YAAY,eAAe,KAAK;AACtC,MAAI,UAAU,WAAW,GAAG;AAC1B,UAAM,IAAI,WAAW,wDAAwD,UAAU,KAAK;EAC9F;AACA,aAAW,SAAS,WAAW;AAC7B,QAAI,CAAC,uBAAuB,SAAS,KAA4B,GAAG;AAClE,YAAM,IAAI,WACR,yCAAyC,uBAAuB,KAAK,GAAG,CAAC,eAAe,KAAK,KAC7F,UAAU,KAAK;IAEnB;EACF;AACA,SAAO;AACT;AAEA,SAAS,uBAAuB,MAAc;AAC5C,QAAM,aAAa,CAAC,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,QAAQ,IAAI,KAAI,EAAG,YAAW,CAAE,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,UACvH,KAAK,cAAc,KAAK,CAAC;AAE3B,MAAI,WAAW,WAAW,GAAG;AAC3B,WAAO;EACT;AACA,SAAO,WAAW,KAAK,GAAG;AAC5B;AAEA,SAAS,kBAAkB,OAA4B,MAAyB;AAC9E,UAAQ,OAAO;IACb,KAAK;AACH,aAAO,KAAK,UAAU;IACxB,KAAK;AACH,aAAO,KAAK;IACd,KAAK;AACH,aAAO,KAAK;IACd,KAAK;AACH,aAAO,KAAK;IACd,KAAK;AACH,aAAO,KAAK,YAAY;IAC1B,KAAK;AACH,aAAO,uBAAuB,KAAK,IAAI;IACzC,KAAK;AACH,aAAO,KAAK,UAAU;IACxB,KAAK;AACH,aAAO,KAAK,WAAW;IACzB;AACE,aAAO;EACX;AACF;AAEA,SAAS,0BAA0B,MAAuC,OAAsC;AAC9G,QAAM,YAAY,QAAQ;AAC1B,QAAM,aAAa,SAAS;AAC5B,MAAI,cAAc,YAAY;AAC5B,WAAO;EACT;AACA,MAAI,cAAc,MAAM;AACtB,WAAO;EACT;AACA,MAAI,eAAe,MAAM;AACvB,WAAO;EACT;AACA,MAAI,OAAO,cAAc,YAAY,OAAO,eAAe,UAAU;AACnE,WAAO,YAAY;EACrB;AACA,SAAO,OAAO,SAAS,EAAE,cAAc,OAAO,UAAU,CAAC;AAC3D;AAEA,SAAS,cAAc,SAAgC,OAA2B;AAChF,SAAO,QAAQ,IAAI,CAAC,UAAU,GAAG,KAAK,IAAI,KAAK,UAAU,MAAM,KAAK,KAAK,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG;AAC5F;AAGA,IAAM,+BAAoE;EACxE,QAAQ;EACR,MAAM;EACN,UAAU;EACV,QAAQ;EACR,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS;;AAIX,SAAS,sBAAsB,OAA4B,OAAsC;AAC/F,MAAI,UAAU,QAAQ,UAAU,UAAa,UAAU,IAAI;AACzD,WAAO,6BAA6B,KAAK;EAC3C;AACA,SAAO,OAAO,KAAK;AACrB;AAOA,SAAS,gBAAgB,SAAgC,OAA2B;AAClF,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO,sBAAsB,QAAQ,CAAC,GAAG,MAAM,QAAQ,CAAC,CAAC,CAAC;EAC5D;AACA,SAAO,QAAQ,IAAI,CAAC,UAAU,GAAG,KAAK,IAAI,sBAAsB,OAAO,MAAM,KAAK,CAAC,CAAC,EAAE,EAAE,KAAK,KAAK;AACpG;AAEA,SAAS,qBACP,MACA,OACA,SAA8B;AAE9B,aAAW,SAAS,SAAS;AAC3B,UAAM,UAAU,0BAA0B,KAAK,MAAM,KAAK,GAAG,MAAM,MAAM,KAAK,CAAC;AAC/E,QAAI,YAAY,GAAG;AACjB,aAAO;IACT;EACF;AACA,SAAO;AACT;AAEA,SAAS,0BAA0B,MAA2B,OAAa;AACzE,QAAM,SAAS;AACf,QAAM,MAAM,OAAO,KAAK;AACxB,MAAI,OAAO,QAAQ,YAAY,OAAO,SAAS,GAAG,GAAG;AACnD,WAAO;EACT;AACA,MAAI,OAAO,QAAQ,UAAU;AAC3B,UAAM,UAAU,IAAI,KAAI;AACxB,QAAI,QAAQ,WAAW,GAAG;AACxB,aAAO;IACT;AACA,UAAM,SAAS,OAAO,OAAO;AAC7B,QAAI,OAAO,SAAS,MAAM,GAAG;AAC3B,aAAO;IACT;EACF;AACA,SAAO;AACT;AAcA,SAAS,cAAc,QAAgB,OAAa;AAClD,MAAI,SAAS,GAAG;AACd,WAAO;EACT;AACA,SAAO,KAAK,MAAO,SAAS,QAAS,GAAK,IAAI;AAChD;AAEA,SAAS,uBAAuB,aAAmC,QAAoB,gBAAqC;AAC1H,QAAM,mBAAmB,qBAAqB,OAAO,MAAM,GAAG,cAAc,KAAK;AACjF,MAAI,qBAAqB,eAAe,aAAa;AACnD,gBAAY,cAAc;AAC1B;EACF;AACA,MAAI,qBAAqB,iBAAkB,eAAe,gBAAgB,IAAI,gBAAgB,KAAK,qBAAqB,eAAe,aAAc;AACnJ,gBAAY,qBAAqB;AACjC;EACF;AACA,MAAI,eAAe,uBAAuB,IAAI,gBAAgB,KAAK,qBAAqB,eAAe,cAAc;AACnH,gBAAY,gBAAgB;AAC5B;EACF;AACA,cAAY,eAAe;AAC7B;AAEA,SAAS,2BACP,OACA,cAA2B;AAE3B,SAAO;IACL,KAAK;MACH;MACA,OAAO;;IAET,eAAe,iBAAiB,OAAO,IAAI;IAC3C,aAAa,gBAAgB;IAC7B,YAAY,iBAAiB,OAAO,IAAI;IACxC,YAAY;IACZ,mBAAmB;IACnB,cAAc;IACd,aAAa;;AAEjB;AAEA,SAAS,yBAAyB,aAAmC,cAA2B;AAC9F,MAAI,iBAAiB,MAAM;AACzB,gBAAY,cAAc;AAC1B;EACF;AACA,cAAY,iBAAiB;AAC7B,cAAY,eAAe;AAC7B;AAEA,SAAS,2BAA2B,QAOnC;AACC,SAAO,YAAY,IAAI,SAAS;AAChC,MAAI,OAAO,mBAAmB;AAC5B,2BAAuB,OAAO,aAAa,OAAO,KAAK,QAAQ,OAAO,cAAc;EACtF;AACA,MAAI,OAAO,uBAAuB,MAAM;AACtC,6BAAyB,OAAO,aAAa,OAAO,YAAY;EAClE;AACF;AAEA,SAAS,oBAAoB,SAAgC,MAAyB;AACpF,QAAM,QAA8B,CAAA;AACpC,aAAW,SAAS,SAAS;AAC3B,UAAM,KAAK,IAAI,kBAAkB,OAAO,IAAI;EAC9C;AACA,SAAO;AACT;AAEA,SAAS,qBACP,OACA,SACA,mBACA,oBAA6C;AAE7C,QAAM,MAAoB;IACxB,GAAG,MAAM;IACT,aAAa,gBAAgB,SAAS,MAAM,IAAI,KAAK;;AAEvD,MAAI,mBAAmB;AACrB,QAAI,OAAO,MAAM;AACjB,QAAI,cAAc,MAAM;AACxB,QAAI,SAAS,MAAM;AACnB,QAAI,QAAQ,MAAM;AAClB,QAAI,iBAAiB,cAAc,MAAM,cAAc,MAAM,IAAI,KAAK;EACxE;AACA,MAAI,uBAAuB,MAAM;AAC/B,QAAI,aAAa,MAAM;AACvB,QAAI,mBAAmB,KAAK;AAC1B,UAAI,MAAM,MAAM;IAClB;AACA,QAAI,mBAAmB,KAAK;AAC1B,UAAI,MAAM,MAAM,kBAAkB,IAAI,OAAO,MAAM,cAAc,MAAM;IACzE;EACF;AACA,SAAO;AACT;AAEA,SAAS,sBAAsB,QAO9B;AACC,SAAO;IACL,UAAU,OAAO;IACjB,OAAO;IACP,YAAY,OAAO;IACnB,oBAAoB,OAAO;IAC3B,QAAQ,OAAO,UAAU;IACzB,MAAM,OAAO,QAAQ,QAAQ;IAC7B,KAAK,OAAO,QAAQ,OAAO;IAC3B,UAAU,OAAO,QAAQ,YAAY;IACrC,iBAAiB,OAAO,QAAQ,kBAAkB;IAClD,gBAAgB,OAAO,QAAQ,iBAAiB;IAChD,UAAU,OAAO,QAAQ,YAAY;IACrC,iBAAiB,OAAO,QAAQ,kBAAkB;IAClD,QAAQ,OAAO,QAAQ,UAAU;IACjC,QAAQ,OAAO,QAAQ,UAAU;IACjC,SAAS,OAAO,QAAQ,WAAW;IACnC,GAAI,OAAO,uBAAuB,OAC9B;MACE,KAAK,OAAO,QAAQ,OAAO;MAC3B,KAAK,OAAO,QAAQ,OAAO;MAC3B,eAAe,OAAO,mBAAmB;QAE3C,CAAA;;AAER;AAKA,eAAsB,aAAa,SAA2BA,SAAqB;AACjF,MAAI,QAAQ,UAAU,OAAO;AAC3B,UAAM,IAAI,WAAW,kEAAkE,UAAU,KAAK;EACxG;AAEA,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAIA,QAAO,IAAI;AACvD,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,iBAAiB,6BAA6B,SAAS,MAAM;AACnE,QAAM,UAAU,aAAa,QAAQ,OAAO;AAC5C,QAAM,SAAS,YAAY,QAAQ,QAAQ,cAAc;AACzD,QAAM,qBAAqB,wBAAwB,OAAO;AAC1D,QAAM,oBAAoB,QAAQ,eAAe;AACjD,QAAM,oBAAoB,QAAQ,sBAAsB;AAExD,QAAM,SAAS,MAAM,QACnB,QACA,sBAAsB,OAAO,GAC7BA,OAAM;AAGR,QAAM,UAAU,oBAAI,IAAG;AACvB,MAAI,oBAAoB;AACxB,MAAI,mBAAmB;AAEvB,aAAW,cAAc,OAAO,OAAO;AACrC,UAAM,OAAO;AACb,UAAM,QAAQ,oBAAoB,SAAS,IAAI;AAC/C,QAAI,QAAQ,SAAS,QAAQ,KAAK,MAAM,WAAW,QAAQ,CAAC,mBAAmB;AAC7E,2BAAqB;AACrB;IACF;AACA,UAAM,MAAM,cAAc,SAAS,KAAK;AACxC,UAAM,WAAW,QAAQ,IAAI,GAAG;AAChC,UAAM,eACJ,uBAAuB,OACnB,OACA,0BAA0B,MAAM,mBAAmB,KAAK;AAC9D,QAAI,UAAU;AACZ,iCAA2B;QACzB,aAAa;QACb;QACA;QACA;QACA;QACA;OACD;IACH,OAAO;AACL,YAAM,cAAc,2BAA2B,OAAO,YAAY;AAClE,UAAI,mBAAmB;AACrB,+BAAuB,aAAa,KAAK,QAAQ,cAAc;MACjE;AACA,cAAQ,IAAI,KAAK,WAAW;IAC9B;AACA,wBAAoB;EACtB;AAEA,QAAM,SAAS,CAAC,GAAG,QAAQ,OAAM,CAAE,EAChC,IAAI,CAAC,UAAU,qBAAqB,OAAO,SAAS,mBAAmB,kBAAkB,CAAC,EAC1F,KAAK,CAAC,MAAM,UAAU,qBAAqB,MAAM,OAAO,OAAO,CAAC;AACnE,QAAM,WAAW,OAAO,YAAY,OAAO,SAAS,SAAS,IAAI,OAAO,WAAW;AAEnF,SAAO;IACL;IACA,OAAO,OAAO;IACd,QAAQ;MACN,kBAAkB,OAAO,MAAM;MAC/B,eAAe;MACf,0BAA0B;;IAE5B,SAAS,sBAAsB,EAAE,SAAS,mBAAmB,mBAAmB,QAAQ,SAAS,mBAAkB,CAAE;IACrH,KAAK,OAAM;IACX,GAAI,WAAW,EAAE,SAAQ,IAAK,CAAA;;AAElC;AAEO,IAAM,4BAA4B;EACvC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;",
   "names": ["global"]
 }

package/dist/cli-bundle/chunks/{append-KDHT4GHI.js → append-H32VOR2Y.js}

@@ -2,16 +2,16 @@
 !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]="43ec7053-d00e-5785-bee5-b8f104fd7c09")}catch(e){}}();
 import {
   createStdinTokenResolver
-} from "./chunk-D6USKAMA.js";
+} from "./chunk-KLXF7NCC.js";
 import {
   resolveAuthor
 } from "./chunk-T5RRNDA7.js";
 import {
   mutateItem,
   toItemRecord
-} from "./chunk-KGQ3W65B.js";
-import "./chunk-V3KLX7U7.js";
-import "./chunk-KRASIL6M.js";
+} from "./chunk-NRZS637N.js";
+import "./chunk-KN3URLKS.js";
+import "./chunk-K2VYLVX4.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -19,7 +19,7 @@ import {
   pathExists,
   readSettings,
   resolvePmRoot
-} from "./chunk-CY5IJMUM.js";
+} from "./chunk-I66WE2HE.js";
 
 // dist/cli/commands/append.js
 async function runAppend(id, options, global) {
@@ -62,6 +62,6 @@ async function runAppend(id, options, global) {
 export {
   runAppend
 };
-//# sourceMappingURL=append-KDHT4GHI.js.map
+//# sourceMappingURL=append-H32VOR2Y.js.map
 
 //# debugId=43ec7053-d00e-5785-bee5-b8f104fd7c09

package/dist/cli-bundle/chunks/{append-LEDBAM3K.js → append-UBM632FK.js}

@@ -1,15 +1,15 @@
 import {
   createStdinTokenResolver
-} from "./chunk-BN3CWK6G.js";
+} from "./chunk-ZNHEYCDD.js";
 import {
   resolveAuthor
 } from "./chunk-WW4E2DC3.js";
 import {
   mutateItem,
   toItemRecord
-} from "./chunk-LBH7UYKY.js";
-import "./chunk-ZFIEEDTJ.js";
-import "./chunk-MLHX6DN5.js";
+} from "./chunk-JXAUVO6X.js";
+import "./chunk-IEEJQCZ4.js";
+import "./chunk-AIAIXG7I.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -17,7 +17,7 @@ import {
   pathExists,
   readSettings,
   resolvePmRoot
-} from "./chunk-SNUK7H5J.js";
+} from "./chunk-7NSPKJUS.js";
 
 // dist/cli/commands/append.js
 !(function() {
@@ -67,4 +67,4 @@ async function runAppend(id, options, global2) {
 export {
   runAppend
 };
-//# sourceMappingURL=append-LEDBAM3K.js.map
+//# sourceMappingURL=append-UBM632FK.js.map

package/dist/cli-bundle/chunks/{chunk-Z55WX4IQ.js → chunk-2227673O.js}

@@ -1,11 +1,11 @@
 
-!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]="0ae90423-f9b0-564b-9911-07266dbae788")}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]="c93111d6-70b7-5f76-bbd9-f0cb8697e61b")}catch(e){}}();
 import {
   resolveAuthor
 } from "./chunk-T5RRNDA7.js";
 import {
   readHistoryEntries
-} from "./chunk-VMY7MZEM.js";
+} from "./chunk-HQTPRV4D.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   historyEntriesToRaw,
@@ -13,7 +13,7 @@ import {
   replayToItemDocument,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-SJZTPVFT.js";
+} from "./chunk-2ASNV4DH.js";
 import {
   acquireLock,
   createHistoryEntry,
@@ -21,14 +21,14 @@ import {
   normalizeItemId,
   normalizeRawItemId,
   readLocatedItem
-} from "./chunk-KGQ3W65B.js";
+} from "./chunk-NRZS637N.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-V3KLX7U7.js";
+} from "./chunk-KN3URLKS.js";
 import {
   nowIso
-} from "./chunk-KRASIL6M.js";
+} from "./chunk-K2VYLVX4.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -44,7 +44,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-CY5IJMUM.js";
+} from "./chunk-I66WE2HE.js";
 
 // dist/cli/commands/history-redact.js
 import fs from "node:fs/promises";
@@ -351,6 +351,128 @@ function rewriteHistoryEntries(entries, rules, replacement) {
 function hasItemMetadata(replay) {
   return Object.keys(replay.metadata).length > 0;
 }
+async function loadHistoryRedactCurrentItem(subject, settings) {
+  const currentItemPath = subject.located?.itemPath ?? null;
+  if (!subject.located) {
+    return { raw: null, path: currentItemPath, document: null };
+  }
+  const loaded = await readLocatedItem(subject.located, { schema: settings.schema });
+  return { raw: loaded.raw, path: currentItemPath, document: loaded.document };
+}
+function resolveHistoryRedactNextItem(params) {
+  if (!hasItemMetadata(params.finalDocument)) {
+    return { raw: null, path: null, document: null };
+  }
+  const canonical = canonicalDocument(replayToItemDocument(params.finalDocument), { schema: params.settings.schema });
+  if (canonical.metadata.id !== params.subject.id) {
+    throw new PmCliError(`history-redact would change item id from ${params.subject.id} to ${canonical.metadata.id}; narrow your patterns.`, EXIT_CODE.USAGE);
+  }
+  return {
+    document: canonical,
+    path: getItemPath(params.pmRoot, canonical.metadata.type, params.subject.id, "toon", params.typeToFolder),
+    raw: serializeItemDocument(canonical, {
+      format: "toon",
+      schema: params.settings.schema
+    })
+  };
+}
+function buildHistoryRedactMessage(options, rewritten) {
+  if (typeof options.message === "string" && options.message.trim().length > 0) {
+    return options.message;
+  }
+  return `history-redact replaced ${rewritten.replacements} match(es) across ${rewritten.entriesChanged} entr${rewritten.entriesChanged === 1 ? "y" : "ies"}.`;
+}
+function buildHistoryRedactEntries(params) {
+  const rewrittenEntries = [...params.rewritten.entries];
+  if (params.dryRun || !params.changed) {
+    return { rewrittenEntries, auditEntryAdded: false };
+  }
+  const finalDocument = params.nextItemDocument ?? replayToItemDocument(params.rewritten.finalDocument);
+  rewrittenEntries.push(createHistoryEntry({
+    nowIso: nowIso(),
+    author: params.author,
+    op: "history_redact",
+    before: finalDocument,
+    after: finalDocument,
+    message: params.message
+  }));
+  return { rewrittenEntries, auditEntryAdded: true };
+}
+async function applyHistoryRedactRewrite(params) {
+  return executeHistoryRewrite({
+    pmRoot: params.pmRoot,
+    subject: params.subject,
+    settings: params.settings,
+    typeRegistry: params.typeRegistry,
+    historyRawBeforeLock: params.historyRawBeforeLock,
+    currentItemRawBeforeLock: params.currentItem.raw,
+    operation: "history-redact",
+    author: params.author,
+    force: params.force,
+    itemDocument: params.currentItem.document,
+    applyRewrite: async ({ historyRawUnderLock }) => {
+      const affectedItemPaths = /* @__PURE__ */ new Set();
+      if (params.currentItem.path) {
+        affectedItemPaths.add(params.currentItem.path);
+      }
+      if (params.nextItem.path) {
+        affectedItemPaths.add(params.nextItem.path);
+      }
+      const itemSnapshots = /* @__PURE__ */ new Map();
+      if (params.currentItem.path && params.currentItem.raw !== null) {
+        itemSnapshots.set(params.currentItem.path, params.currentItem.raw);
+      }
+      try {
+        if (params.nextItem.path && params.nextItem.raw !== null && params.nextItem.raw !== params.currentItem.raw) {
+          await writeFileAtomic(params.nextItem.path, params.nextItem.raw);
+        }
+        if (params.currentItem.path && (!params.nextItem.path || params.nextItem.path !== params.currentItem.path)) {
+          await fs.rm(params.currentItem.path, { force: true });
+        }
+        await writeFileAtomic(params.subject.historyPath, historyEntriesToRaw(params.rewrittenEntries));
+      } catch (error) {
+        await rollbackHistoryRedactRewrite(params.subject.historyPath, historyRawUnderLock, affectedItemPaths, itemSnapshots);
+        throw error;
+      }
+    },
+    applyPostRewrite: async () => runHistoryRedactWriteHooks(params.subject.historyPath, [
+      params.nextItem.path,
+      params.currentItem.path
+    ])
+  });
+}
+async function rollbackHistoryRedactRewrite(historyPath, historyRawUnderLock, affectedItemPaths, itemSnapshots) {
+  if (historyRawUnderLock === null) {
+    await fs.rm(historyPath, { force: true });
+  } else {
+    await writeFileAtomic(historyPath, historyRawUnderLock);
+  }
+  for (const itemPath of affectedItemPaths) {
+    const snapshot = itemSnapshots.get(itemPath);
+    if (snapshot === void 0) {
+      await fs.rm(itemPath, { force: true });
+    } else {
+      await writeFileAtomic(itemPath, snapshot);
+    }
+  }
+}
+async function runHistoryRedactWriteHooks(historyPath, itemHookPaths) {
+  const hookWarnings = [];
+  const uniqueItemHookPaths = new Set(itemHookPaths.filter((itemPath) => itemPath !== null));
+  for (const itemHookPath of uniqueItemHookPaths) {
+    hookWarnings.push(...await runActiveOnWriteHooks({
+      path: itemHookPath,
+      scope: "project",
+      op: "history_redact"
+    }));
+  }
+  hookWarnings.push(...await runActiveOnWriteHooks({
+    path: historyPath,
+    scope: "project",
+    op: "history_redact:history"
+  }));
+  return hookWarnings;
+}
 async function resolveHistorySubject(pmRoot, id, settings, typeToFolder) {
   const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);
   if (located) {
@@ -405,123 +527,45 @@ async function runHistoryRedact(id, options, global) {
   if (!changed) {
     warnings.push("history_redact_no_matches");
   }
-  let currentItemRaw = null;
-  let currentItemPath = subject.located?.itemPath ?? null;
-  let currentItemDocument = null;
-  if (subject.located) {
-    const loaded = await readLocatedItem(subject.located, { schema: settings.schema });
-    currentItemRaw = loaded.raw;
-    currentItemDocument = loaded.document;
-  }
-  let nextItemPath = null;
-  let nextItemRaw = null;
-  let nextItemDocument = null;
-  if (hasItemMetadata(rewritten.finalDocument)) {
-    const canonical = canonicalDocument(replayToItemDocument(rewritten.finalDocument), { schema: settings.schema });
-    if (canonical.metadata.id !== subject.id) {
-      throw new PmCliError(`history-redact would change item id from ${subject.id} to ${canonical.metadata.id}; narrow your patterns.`, EXIT_CODE.USAGE);
-    }
-    nextItemDocument = canonical;
-    nextItemPath = getItemPath(pmRoot, canonical.metadata.type, subject.id, "toon", typeRegistry.type_to_folder);
-    nextItemRaw = serializeItemDocument(canonical, {
-      format: "toon",
-      schema: settings.schema
-    });
-  }
+  const currentItem = await loadHistoryRedactCurrentItem(subject, settings);
+  const nextItem = resolveHistoryRedactNextItem({
+    pmRoot,
+    subject,
+    settings,
+    typeToFolder: typeRegistry.type_to_folder,
+    finalDocument: rewritten.finalDocument
+  });
   const itemChanged = (
     /* c8 ignore next -- null-coalescing item-path comparison branch is exercised in broader command integration coverage. */
-    (currentItemPath ?? null) !== (nextItemPath ?? null) || /* c8 ignore next -- null-coalescing item-content comparison branch is exercised in broader command integration coverage. */
-    (currentItemRaw ?? null) !== (nextItemRaw ?? null)
+    (currentItem.path ?? null) !== (nextItem.path ?? null) || /* c8 ignore next -- null-coalescing item-content comparison branch is exercised in broader command integration coverage. */
+    (currentItem.raw ?? null) !== (nextItem.raw ?? null)
   );
   const author = resolveAuthor(options.author, settings.author_default);
-  const redactionMessage = (
-    /* c8 ignore next -- custom-message branch is validated by command wrapper tests. */
-    typeof options.message === "string" && options.message.trim().length > 0 ? options.message : `history-redact replaced ${rewritten.replacements} match(es) across ${rewritten.entriesChanged} entr${rewritten.entriesChanged === 1 ? "y" : "ies"}.`
-  );
-  const rewrittenEntries = [...rewritten.entries];
-  let auditEntryAdded = false;
-  if (!dryRun && changed) {
-    const finalDocument = nextItemDocument ?? replayToItemDocument(rewritten.finalDocument);
-    rewrittenEntries.push(createHistoryEntry({
-      nowIso: nowIso(),
-      author,
-      op: "history_redact",
-      before: finalDocument,
-      after: finalDocument,
-      message: redactionMessage
-    }));
-    auditEntryAdded = true;
-  }
+  const redactionMessage = buildHistoryRedactMessage(options, rewritten);
+  const { rewrittenEntries, auditEntryAdded } = buildHistoryRedactEntries({
+    rewritten,
+    dryRun,
+    changed,
+    nextItemDocument: nextItem.document,
+    author,
+    message: redactionMessage
+  });
   const historyVerify = verifyHistoryChain(rewrittenEntries);
   if (!historyVerify.ok) {
     throw new PmCliError(`history-redact produced an invalid rewritten chain (${historyVerify.errors.join(", ")}).`, EXIT_CODE.GENERIC_FAILURE);
   }
   if (!dryRun && changed) {
-    warnings.push(...await executeHistoryRewrite({
+    warnings.push(...await applyHistoryRedactRewrite({
       pmRoot,
       subject,
       settings,
       typeRegistry,
       historyRawBeforeLock,
-      currentItemRawBeforeLock: currentItemRaw,
-      operation: "history-redact",
+      currentItem,
+      nextItem,
       author,
       force: options.force,
-      itemDocument: currentItemDocument,
-      applyRewrite: async ({ historyRawUnderLock }) => {
-        const affectedItemPaths = /* @__PURE__ */ new Set();
-        if (currentItemPath) {
-          affectedItemPaths.add(currentItemPath);
-        }
-        if (nextItemPath) {
-          affectedItemPaths.add(nextItemPath);
-        }
-        const itemSnapshots = /* @__PURE__ */ new Map();
-        if (currentItemPath && currentItemRaw !== null) {
-          itemSnapshots.set(currentItemPath, currentItemRaw);
-        }
-        try {
-          if (nextItemPath && nextItemRaw !== null && nextItemRaw !== currentItemRaw) {
-            await writeFileAtomic(nextItemPath, nextItemRaw);
-          }
-          if (currentItemPath && (!nextItemPath || nextItemPath !== currentItemPath)) {
-            await fs.rm(currentItemPath, { force: true });
-          }
-          await writeFileAtomic(subject.historyPath, historyEntriesToRaw(rewrittenEntries));
-        } catch (error) {
-          if (historyRawUnderLock === null) {
-            await fs.rm(subject.historyPath, { force: true });
-          } else {
-            await writeFileAtomic(subject.historyPath, historyRawUnderLock);
-          }
-          for (const itemPath of affectedItemPaths) {
-            const snapshot = itemSnapshots.get(itemPath);
-            if (snapshot === void 0) {
-              await fs.rm(itemPath, { force: true });
-            } else {
-              await writeFileAtomic(itemPath, snapshot);
-            }
-          }
-          throw error;
-        }
-      },
-      applyPostRewrite: async () => {
-        const hookWarnings = [];
-        const itemHookPath = nextItemPath ?? currentItemPath;
-        if (itemHookPath) {
-          hookWarnings.push(...await runActiveOnWriteHooks({
-            path: itemHookPath,
-            scope: "project",
-            op: "history_redact"
-          }));
-        }
-        hookWarnings.push(...await runActiveOnWriteHooks({
-          path: subject.historyPath,
-          scope: "project",
-          op: "history_redact:history"
-        }));
-        return hookWarnings;
-      }
+      rewrittenEntries
     }));
   }
   return {
@@ -546,10 +590,10 @@ async function runHistoryRedact(id, options, global) {
       verify_errors: historyVerify.errors
     },
     item: {
-      existed_before: currentItemPath !== null,
-      exists_after: nextItemPath !== null,
-      path_before: currentItemPath,
-      path_after: nextItemPath,
+      existed_before: currentItem.path !== null,
+      exists_after: nextItem.path !== null,
+      path_before: currentItem.path,
+      path_after: nextItem.path,
       changed: itemChanged
     },
     /* c8 ignore next -- warning dedupe ordering is covered indirectly by command-level smoke tests. */
@@ -575,6 +619,6 @@ export {
   runHistoryRedact,
   _testOnly
 };
-//# sourceMappingURL=chunk-Z55WX4IQ.js.map
+//# sourceMappingURL=chunk-2227673O.js.map
 
-//# debugId=0ae90423-f9b0-564b-9911-07266dbae788
+//# debugId=c93111d6-70b7-5f76-bbd9-f0cb8697e61b