@unbrained/pm-cli 2026.6.5 → 2026.6.7

package/plugins/pm-claude/README.md

@@ -6,7 +6,7 @@ Native pm CLI integration for Claude Code. Use pm project management tools direc
 
 | Component | What it provides |
 |-----------|----------------|
-| **18 MCP tools** | Full pm surface: context, search, list, get, create, update, claim, release, close, comments, files, docs, test, validate, health, contracts, plan + `pm_run` for everything else |
+| **21 MCP tools** | Full pm surface: context, search, list, get, create, update, claim, release, close, comments, files, docs, notes, learnings, deps, test, validate, health, contracts, plan + `pm_run` for everything else |
 | **5 skills** | `pm-workflow`, `pm-developer`, `pm-release`, `pm-audit`, `pm-planner` — auto-loaded as Claude Code skills |
 | **14 slash commands** | Full lifecycle coverage — status, start, close, triage, audit, search, new, list, calendar, developer, planner, release, workflow, init |
 | **4 subagents** | `pm-coordinator` (batch/multi-item), `pm-triage-agent` (duplicate-safe item creation), `pm-verification-agent` (evidence + close readiness), and `pm-delivery-chain` (orchestrated delivery) |
@@ -29,7 +29,7 @@ claude plugin marketplace add /path/to/pm-cli
 # claude plugin marketplace add unbraind/pm-cli
 ```
 
-This installs all 18 MCP tools, 5 skills, 14 slash commands, 4 subagents, hybrid TUI tracking, and the session hook in one step.
+This installs all 21 MCP tools, 5 skills, 14 slash commands, 4 subagents, hybrid TUI tracking, and the session hook in one step.
 
 ### Option B: Legacy marketplace alias (also works)
 
@@ -42,10 +42,10 @@ Both `pm` and `pm-cli` marketplace IDs resolve to the same plugin.
 ### Option C: Global MCP server via Claude Code CLI (MCP tools only)
 
 ```bash
-claude mcp add --transport stdio pm-mcp -- npx -y @unbrained/pm-cli pm-mcp
+claude mcp add --transport stdio pm-mcp -- npx -y --package=@unbrained/pm-cli@latest pm-mcp
 ```
 
-This gives you the 18 MCP tools but not the skills, slash commands, or session hook.
+This gives you the 21 MCP tools but not the skills, slash commands, or session hook.
 
 ### Option D: Direct `.mcp.json` (project-scoped MCP only)
 
@@ -159,6 +159,9 @@ Spawn pm-triage-agent to set up the pm item for: add OAuth2 login support
 | `pm_comments` | List or add comments |
 | `pm_files` | Link/unlink files |
 | `pm_docs` | Link/unlink docs |
+| `pm_notes` | List or add notes |
+| `pm_learnings` | List or add learnings |
+| `pm_deps` | List/add/remove dependencies |
 | `pm_test` | Link or run tests |
 | `pm_validate` | Run validation checks |
 | `pm_health` | Run health diagnostics |
@@ -171,7 +174,7 @@ Spawn pm-triage-agent to set up the pm item for: add OAuth2 login support
 |------|---------|
 | `pm_run` | Any pm action not covered above — pass `action` field |
 
-**`pm_run` actions:** `init`, `calendar`, `activity`, `aggregate`, `dedupe-audit`, `normalize`, `reindex`, `extension`, `history`, `stats`, `append`, `notes`, `learnings`, `test-all`, `comments-audit`, `gc`, `templates-list`, `templates-save`, `templates-show`, `test-runs-list`, `test-runs-status`, `test-runs-logs`, `test-runs-stop`, `test-runs-resume`, `config`, `completion`
+**`pm_run` actions:** `init`, `calendar`, `activity`, `aggregate`, `dedupe-audit`, `normalize`, `reindex`, `extension`, `history`, `stats`, `append`, `test-all`, `comments-audit`, `gc`, `templates-list`, `templates-save`, `templates-show`, `test-runs-list`, `test-runs-status`, `test-runs-logs`, `test-runs-stop`, `test-runs-resume`, `config`, `completion`
 
 ## Hybrid TUI Sync Pattern
 
@@ -190,8 +193,8 @@ All skills and commands implement this pattern for every claimed item:
 
 ## Session Context Injection
 
-At session start, the hook runs natively (no `pm` CLI required):
-- Uses `npx @unbrained/pm-cli` without requiring a global install
+At session start, the hook runs the published `pm` CLI without requiring a global install:
+- Uses `npx --yes --package=@unbrained/pm-cli@latest pm context --limit 5 --json`
 - Injects a compact summary of in-progress/open/blocked items
 
 Example output:
@@ -213,7 +216,7 @@ Use pm_context tool or /pm-status for full details.
 ## Requirements
 
 - Node.js ≥ 20
-- pm CLI resolved automatically via local dist (in repo) or `npx @unbrained/pm-cli` (no global install needed)
+- pm CLI resolved automatically via local dist (in repo) or `npx --yes @unbrained/pm-cli@latest` (no global install needed)
 - Project initialized with `pm init` (or use `/pm-init`)
 
 ## Links

package/plugins/pm-claude/agents/pm-coordinator.md

@@ -29,7 +29,7 @@ For batch audits spanning many items, create one top-level `TaskCreate` for the
 
 ## Tools Available
 
-Use the `pm-mcp` MCP server tools: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `pm_update`, `pm_claim`, `pm_release`, `pm_close`, `pm_comments`, `pm_files`, `pm_docs`, `pm_test`, `pm_validate`, `pm_health`, `pm_contracts`, `pm_plan`, and `pm_run` for all other operations.
+Use the `pm-mcp` MCP server tools: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `pm_update`, `pm_claim`, `pm_release`, `pm_close`, `pm_comments`, `pm_files`, `pm_docs`, `pm_notes`, `pm_learnings`, `pm_deps`, `pm_test`, `pm_validate`, `pm_health`, `pm_contracts`, `pm_plan`, and `pm_run` for all other operations.
 
 Also use Claude Code's built-in `TaskCreate` and `TaskUpdate` tools for TUI panel display.
 

package/plugins/pm-claude/commands/pm-init.md

@@ -47,7 +47,7 @@ Initialize pm project tracking using native MCP tools. Argument: `$ARGUMENTS` (o
    - pm initialized at `.agents/pm/`
    - guidance mode defaults to `ask` (TTY prompt only); use `agentGuidance=add|skip|status` in `pm_run` options for deterministic behavior
    - Available slash commands: `/pm-status`, `/pm-new`, `/pm-start-task`, `/pm-close-task`, `/pm-list`, `/pm-search`, `/pm-triage`, `/pm-calendar`, `/pm-developer`, `/pm-planner`, `/pm-release`, `/pm-audit`, `/pm-workflow`
-   - All 18 MCP tools available: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `pm_update`, `pm_claim`, `pm_release`, `pm_close`, `pm_comments`, `pm_files`, `pm_docs`, `pm_test`, `pm_validate`, `pm_health`, `pm_contracts`, `pm_plan`, `pm_run`
+   - All 21 MCP tools available: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `pm_update`, `pm_claim`, `pm_release`, `pm_close`, `pm_comments`, `pm_files`, `pm_docs`, `pm_notes`, `pm_learnings`, `pm_deps`, `pm_test`, `pm_validate`, `pm_health`, `pm_contracts`, `pm_plan`, `pm_run`
    - Next: use `/pm-new <title>` to create your first item, or `/pm-status` to see the tracker state
 
 If initialization fails, report the error and suggest running `pm init` manually in the terminal.

package/plugins/pm-codex/README.md

@@ -17,7 +17,7 @@ codex plugin marketplace add .
 
 Restart Codex, then install **pm CLI** from the repo marketplace. The bundled MCP server starts through `plugins/pm-codex/scripts/pm-mcp-server.mjs`.
 
-For a published package install, keep `@unbrained/pm-cli` available through npm. The launcher uses the local repo build when present and falls back to `npx -y @unbrained/pm-cli@latest pm-mcp` when the plugin is cached outside the repository.
+For a published package install, keep `@unbrained/pm-cli` available through npm. The launcher uses the local repo build when present and falls back to `npx -y --package=@unbrained/pm-cli@latest pm-mcp` when the plugin is cached outside the repository.
 
 ## Native Tools
 

package/dist/cli-bundle/chunks/activity-P5BUMWP3.js

@@ -1,16 +0,0 @@
-import {
-  runActivity
-} from "./chunk-JB4RGL4V.js";
-import "./chunk-WIKR7KFL.js";
-import "./chunk-S3CV7JGJ.js";
-import "./chunk-K47WAYQV.js";
-import "./chunk-XG7RJYHV.js";
-import "./chunk-KA24HME7.js";
-import "./chunk-HPH6X4ZZ.js";
-import "./chunk-4PJQSECJ.js";
-import "./chunk-RANZIID5.js";
-import "./chunk-SRVKTWPR.js";
-export {
-  runActivity
-};
-//# sourceMappingURL=activity-P5BUMWP3.js.map

package/dist/cli-bundle/chunks/aggregate-J35K7WZB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/aggregate.ts"],"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  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}\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    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\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\nexport async function runAggregate(options: AggregateOptions, global: GlobalOptions): Promise<AggregateResult> {\n  if (options.count === false) {\n    throw new PmCliError(\"Aggregate currently supports grouped counts only. Pass --count.\", 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 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, AggregateRow>();\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    if (existing) {\n      existing.count += 1;\n    } else {\n      grouped.set(key, {\n        group,\n        count: 1,\n      });\n    }\n    groupedItemCount += 1;\n  }\n\n  const groups = [...grouped.values()].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      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    },\n    now: nowIso(),\n    ...(warnings ? { warnings } : {}),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"ee0c571c-dc7a-52dd-9d46-9c17bebcc3cb"}

package/dist/cli-bundle/chunks/aggregate-OOAGKWRG.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../../../../cli/commands/aggregate.ts"],
-  "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  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}\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    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\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\nexport async function runAggregate(options: AggregateOptions, global: GlobalOptions): Promise<AggregateResult> {\n  if (options.count === false) {\n    throw new PmCliError(\"Aggregate currently supports grouped counts only. Pass --count.\", 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 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, AggregateRow>();\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    if (existing) {\n      existing.count += 1;\n    } else {\n      grouped.set(key, {\n        group,\n        count: 1,\n      });\n    }\n    groupedItemCount += 1;\n  }\n\n  const groups = [...grouped.values()].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      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    },\n    now: nowIso(),\n    ...(warnings ? { warnings } : {}),\n  };\n}\n"],
-  "mappings": "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",
-  "names": ["global"]
-}