npm - @unbrained/pm-cli - Versions diffs - 2026.7.13 → 2026.7.14 - Mend

@unbrained/pm-cli 2026.7.13 → 2026.7.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (487) hide show

package/.claude-plugin/marketplace.json CHANGED Viewed

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
-    "version": "2026.7.13"
+    "version": "2026.7.14"
   },
   "plugins": [
     {
       "name": "pm-claude",
       "source": "./plugins/pm-claude",
       "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
-      "version": "2026.7.13",
+      "version": "2026.7.14",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,33 @@
 # Changelog
+## 2026.7.14 - 2026-07-14
+### Added
+- Context usage feedback signal: served-then-acted-on outcomes strengthen relevance scoring (retrieval-practice effect) ([pm-uwfs](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-uwfs.toon))
+- GH-544: linked-file path anchoring — files/docs add/glob/discover/validate-paths resolve at process.cwd() while validate --check-files anchors at the workspace root ([pm-chyh](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-chyh.toon))
+### Changed
+- Replace obsolete front-matter vocabulary with item metadata terminology ([pm-hq28](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-hq28.toon))
+### Fixed
+- GH-533: create/update accept empty --title — required-title contract inconsistent between omitted and empty string ([pm-7je0](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-7je0.toon))
+- GH-535: pm deps omits dangling parent references (missing_count:0, missing:false) contradicting validate's dangling_reference_count ([pm-p9sc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-p9sc.toon))
+- GH-542: MCP pm_copy nests title/message under options while sibling tools declare flat camelCase params — own suite triggers unexpected-arg warnings ([pm-hno5](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-hno5.toon))
+- GH-532: --estimated-minutes accepts negative numbers and floats — missing non-negative-integer range validation ([pm-jh9t](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-jh9t.toon))
+- GH-534: no-op update reports phantom changed_fields in --json while TOON reports empty, and changed_field_count is always null in JSON ([pm-45mb](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-45mb.toon))
+- GH-526: aggregate --sum/--avg accept unknown field names and silently report 0 ([pm-96vo](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-96vo.toon))
+- GH-530: list --status <invalid\> silently returns count 0 — validate against the status domain like --type and search status: ([pm-kj4k](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-kj4k.toon))
+- Separate active dangling dependency warnings from terminal historical reference diagnostics ([pm-2ler](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-2ler.toon))
+### Other
+- PR review helper: watch GitHub checks and enforce thread-scoped replies ([pm-0fxa](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-0fxa.toon))
+- Token-budget context packer: diversity-aware selection, projection degradation, and bounded output for pm context/next ([pm-55ra](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-55ra.toon))
+- Complete public linked-resource SDK primitives and actionable dependency governance ([pm-jcvg](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-jcvg.toon))
 ## 2026.7.13 - 2026-07-13
 ### Added

package/dist/cli/commands/aggregate.d.ts CHANGED Viewed

@@ -120,7 +120,7 @@ interface NumericAggregation {
     sum: boolean;
     avg: boolean;
 }
-declare function parseNumericAggregation(options: AggregateOptions): NumericAggregation | null;
+declare function parseNumericAggregation(options: AggregateOptions, allowedFields?: readonly string[]): NumericAggregation | null;
 declare function parseGroupBy(raw: string | undefined): AggregateGroupField[];
 declare function normalizeTagGroupValue(tags: string[]): string | null;
 declare function resolveGroupValue(field: AggregateGroupField, item: AggregateListedItem): AggregateGroupValue;

package/dist/cli/commands/aggregate.js CHANGED Viewed

@@ -4,14 +4,14 @@
  * Implements the pm aggregate command surface and its agent-facing runtime behavior.
  */
-!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]="91c3695d-ea52-548f-967f-491f656c3ec3")}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]="fce074e9-e105-530a-a070-9a99c71b043d")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { splitCommaList } from "../../core/shared/split-comma-list.js";
 import { nowIso } from "../../core/shared/time.js";
 import { normalizeStatusInput } from "../../core/item/status.js";
 import { parseStatusFilterCsv } from "../../core/item/status-filter.js";
-import { resolveRuntimeStatusRegistry, } from "../../core/schema/runtime-schema.js";
+import { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, } from "../../core/schema/runtime-schema.js";
 import { resolvePmRoot } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
 import { buildListQueryFilters } from "./list-filter-shared.js";
@@ -39,7 +39,7 @@ function parseStatus(raw, statusRegistry) {
     }
     return statuses[0];
 }
-function parseNumericAggregation(options) {
+function parseNumericAggregation(options, allowedFields = ["estimate", "estimated_minutes", "priority"]) {
     const sumField = options.sum?.trim();
     const avgField = options.avg?.trim();
     const normalizedSum = sumField && sumField.length > 0 ? sumField : undefined;
@@ -50,8 +50,12 @@ function parseNumericAggregation(options) {
     if (normalizedSum && normalizedAvg && normalizedSum !== normalizedAvg) {
         throw new PmCliError("Aggregate --sum and --avg must target the same numeric field", EXIT_CODE.USAGE);
     }
+    const field = normalizedSum ?? normalizedAvg;
+    if (!allowedFields.includes(field)) {
+        throw new PmCliError(`Aggregate numeric field "${field}" is not registered. Allowed: ${allowedFields.join(", ")}`, EXIT_CODE.USAGE);
+    }
     return {
-        field: normalizedSum ?? normalizedAvg,
+        field,
         sum: normalizedSum !== undefined,
         avg: normalizedAvg !== undefined,
     };
@@ -305,9 +309,17 @@ export async function runAggregate(options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     const settings = await readSettings(pmRoot);
     const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+    const numericFields = [
+        "estimate",
+        "estimated_minutes",
+        "priority",
+        ...resolveRuntimeFieldRegistry(settings.schema).definitions
+            .filter((definition) => definition.type === "number")
+            .map((definition) => definition.metadata_key),
+    ];
     const groupBy = parseGroupBy(options.groupBy);
     const status = parseStatus(options.status, statusRegistry);
-    const numericAggregation = parseNumericAggregation(options);
+    const numericAggregation = parseNumericAggregation(options, [...new Set(numericFields)].sort((left, right) => left.localeCompare(right)));
     const includeCompletion = options.completion === true;
     const includeUnparented = options.includeUnparented === true;
     const listed = await runList(status, buildListQueryFilters(options), global);
@@ -386,4 +398,4 @@ export const _testOnlyAggregateCommand = {
     updateCompletionCounts,
 };
 //# sourceMappingURL=aggregate.js.map
-//# debugId=91c3695d-ea52-548f-967f-491f656c3ec3
+//# debugId=fce074e9-e105-530a-a070-9a99c71b043d

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

	@@ -1 +1 @@
1	- {"version":3,"file":"aggregate.js","sources":["cli/commands/aggregate.ts"],"sourceRoot":"/","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 {\n resolveRuntimeStatusRegistry,\n type RuntimeStatusRegistry,\n} 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 =\n \| \"parent\"\n \| \"type\"\n \| \"priority\"\n \| \"status\"\n \| \"assignee\"\n \| \"tags\"\n \| \"sprint\"\n \| \"release\";\ntype AggregateGroupValue = string \| number \| null;\ntype AggregateGroupRecord = Partial<\n Record<AggregateGroupField, AggregateGroupValue>\n>;\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/* Documents the aggregate options payload exchanged by command, SDK, and package integrations. /\nexport interface AggregateOptions {\n /* Value that configures or reports group by for this contract. /\n groupBy?: string;\n /* Value that configures or reports count for this contract. /\n count?: boolean;\n /* Value that configures or reports completion for this contract. /\n completion?: boolean;\n /* Value that configures or reports sum for this contract. /\n sum?: string;\n /* Value that configures or reports avg for this contract. /\n avg?: string;\n /* Value that configures or reports include unparented for this contract. /\n includeUnparented?: boolean;\n /* Lifecycle state reported for status. /\n status?: string;\n /* Schema type that determines the shape and validation rules for this value. /\n type?: string;\n /* Value that configures or reports tag for this contract. /\n tag?: string;\n /* Value that configures or reports priority for this contract. /\n priority?: string;\n /* Value that configures or reports deadline before for this contract. /\n deadlineBefore?: string;\n /* Value that configures or reports deadline after for this contract. /\n deadlineAfter?: string;\n /* Value that configures or reports assignee for this contract. /\n assignee?: string;\n /* Value that configures or reports assignee filter for this contract. /\n assigneeFilter?: string;\n /* Value that configures or reports parent for this contract. /\n parent?: string;\n /* Value that configures or reports sprint for this contract. /\n sprint?: string;\n /* Value that configures or reports release for this contract. /\n release?: string;\n}\n\n/* Documents the aggregate row payload exchanged by command, SDK, and package integrations. /\nexport interface AggregateRow {\n /* Value that configures or reports group for this contract. /\n group: AggregateGroupRecord;\n /* Human-readable display label for this group. Blank/null group values render with an explicit \"(unassigned)\"-style label (per dimension) so terminal and grep-based consumers are never faced with an ambiguous empty key. The structured `group` record keeps the raw null for machine consumers. /\n group_label: string;\n /* Value that configures or reports count for this contract. /\n count: number;\n /* Value that configures or reports open for this contract. /\n open?: number;\n /* Value that configures or reports in progress for this contract. /\n in_progress?: number;\n /* Value that configures or reports closed for this contract. /\n closed?: number;\n /* Value that configures or reports other for this contract. /\n other?: number;\n /* Value that configures or reports completion pct for this contract. /\n completion_pct?: number;\n /* Number of null entries represented by this result. /\n null_count?: number;\n /* Value that configures or reports sum for this contract. /\n sum?: number \| null;\n /* Value that configures or reports avg for this contract. /\n avg?: number \| null;\n}\n\n/* Documents the aggregate result payload exchanged by command, SDK, and package integrations. /\nexport interface AggregateResult {\n /* Value that configures or reports groups for this contract. /\n groups: AggregateRow[];\n /* Value that configures or reports count for this contract. /\n count: number;\n /* Value that configures or reports totals for this contract. /\n totals: {\n items_considered: number;\n items_grouped: number;\n items_skipped_unparented: number;\n };\n /* Value that configures or reports filters for this contract. /\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 /* Value that configures or reports now for this contract. /\n now: string;\n /* Value that configures or reports warnings for this contract. /\n warnings?: string[];\n}\n\nfunction parseStatus(\n raw: string \| undefined,\n statusRegistry: RuntimeStatusRegistry,\n): ItemStatus \| undefined {\n const statuses = parseStatusFilterCsv(raw, statusRegistry, {\n strict: true,\n flagLabel: \"--status\",\n });\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(\n options: AggregateOptions,\n): 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(\n \"Aggregate --sum and --avg must target the same numeric field\",\n EXIT_CODE.USAGE,\n );\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(\n \"--group-by requires at least one field name\",\n EXIT_CODE.USAGE,\n );\n }\n const requested = splitCommaList(value);\n if (requested.length === 0) {\n throw new PmCliError(\n \"--group-by requires a comma-separated list of fields\",\n EXIT_CODE.USAGE,\n );\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 = [\n ...new Set(\n tags\n .map((tag) => tag.trim().toLowerCase())\n .filter((tag) => tag.length > 0),\n ),\n ].sort((left, right) => left.localeCompare(right));\n if (normalized.length === 0) {\n return null;\n }\n return normalized.join(\",\");\n}\n\nfunction resolveGroupValue(\n field: AggregateGroupField,\n item: AggregateListedItem,\n): 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(\n left: AggregateGroupValue \| undefined,\n right: AggregateGroupValue \| undefined,\n): 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(\n groupBy: AggregateGroupField[],\n group: AggregateGroupRecord,\n): string {\n return groupBy\n .map((field) => `${field}:${JSON.stringify(group[field] ?? null)}`)\n .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(\n field: AggregateGroupField,\n value: AggregateGroupValue \| undefined,\n): string {\n if (value === null \|\| value === undefined \|\| value === \"\") {\n return EMPTY_AGGREGATE_GROUP_LABELS[field];\n }\n return String(value);\n}\n\n/* Build the human-readable label for an aggregate row. Single-field grouping yields the bare (possibly substituted) value; multi-field grouping joins each \"field=value\" pair so composite groups stay unambiguous. /\nfunction buildGroupLabel(\n groupBy: AggregateGroupField[],\n group: AggregateGroupRecord,\n): string {\n if (groupBy.length === 1) {\n return formatGroupFieldLabel(groupBy[0], group[groupBy[0]]);\n }\n return groupBy\n .map((field) => `${field}=${formatGroupFieldLabel(field, group[field])}`)\n .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(\n left.group[field],\n right.group[field],\n );\n if (byField !== 0) {\n return byField;\n }\n }\n return 0;\n}\n\nfunction readNumericAggregateValue(\n item: AggregateListedItem,\n field: string,\n): 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(\n accumulator: AggregateAccumulator,\n status: ItemStatus,\n statusRegistry: RuntimeStatusRegistry,\n): void {\n const normalizedStatus =\n normalizeStatusInput(String(status), statusRegistry) ?? status;\n if (normalizedStatus === statusRegistry.open_status) {\n accumulator.open_count += 1;\n return;\n }\n if (\n normalizedStatus === \"in_progress\" \|\|\n (statusRegistry.active_statuses.has(normalizedStatus) &&\n normalizedStatus !== statusRegistry.open_status)\n ) {\n accumulator.in_progress_count += 1;\n return;\n }\n if (\n statusRegistry.terminal_done_statuses.has(normalizedStatus) \|\|\n normalizedStatus === statusRegistry.close_status\n ) {\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(\n accumulator: AggregateAccumulator,\n numericValue: number \| null,\n): 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(\n params.accumulator,\n params.item.status,\n params.statusRegistry,\n );\n }\n if (params.numericAggregation !== null) {\n updateNumericAggregation(params.accumulator, params.numericValue);\n }\n}\n\nfunction buildAggregateGroup(\n groupBy: AggregateGroupField[],\n item: AggregateListedItem,\n): 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 =\n entry.numeric_count === 0\n ? null\n : 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/** Implements run aggregate for the public runtime surface of this module. /\nexport async function runAggregate(\n options: AggregateOptions,\n global: GlobalOptions,\n): Promise<AggregateResult> {\n if (options.count === false) {\n throw new PmCliError(\n \"Aggregate grouped counts are always enabled; omit count=false.\",\n EXIT_CODE.USAGE,\n );\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(status, buildListQueryFilters(options), global);\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 (\n groupBy.includes(\"parent\") &&\n group.parent === null &&\n !includeUnparented\n ) {\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) =>\n finalizeAggregateRow(\n entry,\n groupBy,\n includeCompletion,\n numericAggregation,\n ),\n )\n .sort((left, right) => compareAggregateRows(left, right, groupBy));\n const warnings =\n 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({\n groupBy,\n includeCompletion,\n includeUnparented,\n status,\n options,\n numericAggregation,\n }),\n now: nowIso(),\n ...(warnings ? { warnings } : {}),\n };\n}\n\n/* Public contract for test only aggregate command, shared by SDK and presentation-layer consumers. */\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":"91c3695d-ea52-548f-967f-491f656c3ec3"}
1	+ {"version":3,"file":"aggregate.js","sources":["cli/commands/aggregate.ts"],"sourceRoot":"/","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 {\n resolveRuntimeFieldRegistry,\n resolveRuntimeStatusRegistry,\n type RuntimeStatusRegistry,\n} 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 =\n \| \"parent\"\n \| \"type\"\n \| \"priority\"\n \| \"status\"\n \| \"assignee\"\n \| \"tags\"\n \| \"sprint\"\n \| \"release\";\ntype AggregateGroupValue = string \| number \| null;\ntype AggregateGroupRecord = Partial<\n Record<AggregateGroupField, AggregateGroupValue>\n>;\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/* Documents the aggregate options payload exchanged by command, SDK, and package integrations. /\nexport interface AggregateOptions {\n /* Value that configures or reports group by for this contract. /\n groupBy?: string;\n /* Value that configures or reports count for this contract. /\n count?: boolean;\n /* Value that configures or reports completion for this contract. /\n completion?: boolean;\n /* Value that configures or reports sum for this contract. /\n sum?: string;\n /* Value that configures or reports avg for this contract. /\n avg?: string;\n /* Value that configures or reports include unparented for this contract. /\n includeUnparented?: boolean;\n /* Lifecycle state reported for status. /\n status?: string;\n /* Schema type that determines the shape and validation rules for this value. /\n type?: string;\n /* Value that configures or reports tag for this contract. /\n tag?: string;\n /* Value that configures or reports priority for this contract. /\n priority?: string;\n /* Value that configures or reports deadline before for this contract. /\n deadlineBefore?: string;\n /* Value that configures or reports deadline after for this contract. /\n deadlineAfter?: string;\n /* Value that configures or reports assignee for this contract. /\n assignee?: string;\n /* Value that configures or reports assignee filter for this contract. /\n assigneeFilter?: string;\n /* Value that configures or reports parent for this contract. /\n parent?: string;\n /* Value that configures or reports sprint for this contract. /\n sprint?: string;\n /* Value that configures or reports release for this contract. /\n release?: string;\n}\n\n/* Documents the aggregate row payload exchanged by command, SDK, and package integrations. /\nexport interface AggregateRow {\n /* Value that configures or reports group for this contract. /\n group: AggregateGroupRecord;\n /* Human-readable display label for this group. Blank/null group values render with an explicit \"(unassigned)\"-style label (per dimension) so terminal and grep-based consumers are never faced with an ambiguous empty key. The structured `group` record keeps the raw null for machine consumers. /\n group_label: string;\n /* Value that configures or reports count for this contract. /\n count: number;\n /* Value that configures or reports open for this contract. /\n open?: number;\n /* Value that configures or reports in progress for this contract. /\n in_progress?: number;\n /* Value that configures or reports closed for this contract. /\n closed?: number;\n /* Value that configures or reports other for this contract. /\n other?: number;\n /* Value that configures or reports completion pct for this contract. /\n completion_pct?: number;\n /* Number of null entries represented by this result. /\n null_count?: number;\n /* Value that configures or reports sum for this contract. /\n sum?: number \| null;\n /* Value that configures or reports avg for this contract. /\n avg?: number \| null;\n}\n\n/* Documents the aggregate result payload exchanged by command, SDK, and package integrations. /\nexport interface AggregateResult {\n /* Value that configures or reports groups for this contract. /\n groups: AggregateRow[];\n /* Value that configures or reports count for this contract. /\n count: number;\n /* Value that configures or reports totals for this contract. /\n totals: {\n items_considered: number;\n items_grouped: number;\n items_skipped_unparented: number;\n };\n /* Value that configures or reports filters for this contract. /\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 /* Value that configures or reports now for this contract. /\n now: string;\n /* Value that configures or reports warnings for this contract. /\n warnings?: string[];\n}\n\nfunction parseStatus(\n raw: string \| undefined,\n statusRegistry: RuntimeStatusRegistry,\n): ItemStatus \| undefined {\n const statuses = parseStatusFilterCsv(raw, statusRegistry, {\n strict: true,\n flagLabel: \"--status\",\n });\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(\n options: AggregateOptions,\n allowedFields: readonly string[] = [\"estimate\", \"estimated_minutes\", \"priority\"],\n): 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(\n \"Aggregate --sum and --avg must target the same numeric field\",\n EXIT_CODE.USAGE,\n );\n }\n const field = normalizedSum ?? normalizedAvg!;\n if (!allowedFields.includes(field)) {\n throw new PmCliError(\n `Aggregate numeric field \"${field}\" is not registered. Allowed: ${allowedFields.join(\", \")}`,\n EXIT_CODE.USAGE,\n );\n }\n return {\n field,\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(\n \"--group-by requires at least one field name\",\n EXIT_CODE.USAGE,\n );\n }\n const requested = splitCommaList(value);\n if (requested.length === 0) {\n throw new PmCliError(\n \"--group-by requires a comma-separated list of fields\",\n EXIT_CODE.USAGE,\n );\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 = [\n ...new Set(\n tags\n .map((tag) => tag.trim().toLowerCase())\n .filter((tag) => tag.length > 0),\n ),\n ].sort((left, right) => left.localeCompare(right));\n if (normalized.length === 0) {\n return null;\n }\n return normalized.join(\",\");\n}\n\nfunction resolveGroupValue(\n field: AggregateGroupField,\n item: AggregateListedItem,\n): 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(\n left: AggregateGroupValue \| undefined,\n right: AggregateGroupValue \| undefined,\n): 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(\n groupBy: AggregateGroupField[],\n group: AggregateGroupRecord,\n): string {\n return groupBy\n .map((field) => `${field}:${JSON.stringify(group[field] ?? null)}`)\n .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(\n field: AggregateGroupField,\n value: AggregateGroupValue \| undefined,\n): string {\n if (value === null \|\| value === undefined \|\| value === \"\") {\n return EMPTY_AGGREGATE_GROUP_LABELS[field];\n }\n return String(value);\n}\n\n/* Build the human-readable label for an aggregate row. Single-field grouping yields the bare (possibly substituted) value; multi-field grouping joins each \"field=value\" pair so composite groups stay unambiguous. /\nfunction buildGroupLabel(\n groupBy: AggregateGroupField[],\n group: AggregateGroupRecord,\n): string {\n if (groupBy.length === 1) {\n return formatGroupFieldLabel(groupBy[0], group[groupBy[0]]);\n }\n return groupBy\n .map((field) => `${field}=${formatGroupFieldLabel(field, group[field])}`)\n .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(\n left.group[field],\n right.group[field],\n );\n if (byField !== 0) {\n return byField;\n }\n }\n return 0;\n}\n\nfunction readNumericAggregateValue(\n item: AggregateListedItem,\n field: string,\n): 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(\n accumulator: AggregateAccumulator,\n status: ItemStatus,\n statusRegistry: RuntimeStatusRegistry,\n): void {\n const normalizedStatus =\n normalizeStatusInput(String(status), statusRegistry) ?? status;\n if (normalizedStatus === statusRegistry.open_status) {\n accumulator.open_count += 1;\n return;\n }\n if (\n normalizedStatus === \"in_progress\" \|\|\n (statusRegistry.active_statuses.has(normalizedStatus) &&\n normalizedStatus !== statusRegistry.open_status)\n ) {\n accumulator.in_progress_count += 1;\n return;\n }\n if (\n statusRegistry.terminal_done_statuses.has(normalizedStatus) \|\|\n normalizedStatus === statusRegistry.close_status\n ) {\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(\n accumulator: AggregateAccumulator,\n numericValue: number \| null,\n): 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(\n params.accumulator,\n params.item.status,\n params.statusRegistry,\n );\n }\n if (params.numericAggregation !== null) {\n updateNumericAggregation(params.accumulator, params.numericValue);\n }\n}\n\nfunction buildAggregateGroup(\n groupBy: AggregateGroupField[],\n item: AggregateListedItem,\n): 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 =\n entry.numeric_count === 0\n ? null\n : 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/** Implements run aggregate for the public runtime surface of this module. /\nexport async function runAggregate(\n options: AggregateOptions,\n global: GlobalOptions,\n): Promise<AggregateResult> {\n if (options.count === false) {\n throw new PmCliError(\n \"Aggregate grouped counts are always enabled; omit count=false.\",\n EXIT_CODE.USAGE,\n );\n }\n\n const pmRoot = resolvePmRoot(process.cwd(), global.path);\n const settings = await readSettings(pmRoot);\n const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n const numericFields = [\n \"estimate\",\n \"estimated_minutes\",\n \"priority\",\n ...resolveRuntimeFieldRegistry(settings.schema).definitions\n .filter((definition) => definition.type === \"number\")\n .map((definition) => definition.metadata_key),\n ];\n const groupBy = parseGroupBy(options.groupBy);\n const status = parseStatus(options.status, statusRegistry);\n const numericAggregation = parseNumericAggregation(\n options,\n [...new Set(numericFields)].sort((left, right) => left.localeCompare(right)),\n );\n const includeCompletion = options.completion === true;\n const includeUnparented = options.includeUnparented === true;\n\n const listed = await runList(status, buildListQueryFilters(options), global);\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 (\n groupBy.includes(\"parent\") &&\n group.parent === null &&\n !includeUnparented\n ) {\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) =>\n finalizeAggregateRow(\n entry,\n groupBy,\n includeCompletion,\n numericAggregation,\n ),\n )\n .sort((left, right) => compareAggregateRows(left, right, groupBy));\n const warnings =\n 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({\n groupBy,\n includeCompletion,\n includeUnparented,\n status,\n options,\n numericAggregation,\n }),\n now: nowIso(),\n ...(warnings ? { warnings } : {}),\n };\n}\n\n/* Public contract for test only aggregate command, shared by SDK and presentation-layer consumers. */\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":"fce074e9-e105-530a-a070-9a99c71b043d"}

package/dist/cli/commands/context.d.ts CHANGED Viewed

@@ -4,6 +4,7 @@ import type { ContextDepth, ContextSectionName, ContextSettings, ItemMetadata, I
 import { type CalendarRow } from "./calendar.js";
 import { type CompactActivityEntry } from "./activity.js";
 import { type ContextRelevanceCandidate, type ContextRelevanceContributions, type ContextRelevanceReport, type ContextRelevanceSignalName } from "../../sdk/context-relevance.js";
+import { type ContextPackingReport } from "../../sdk/context-packing.js";
 /** Supported values accepted by the context output contract. */
 export declare const CONTEXT_OUTPUT_VALUES: readonly ["markdown", "toon", "json"];
 /** Restricts context output format values accepted by command, SDK, and storage contracts. */
@@ -309,6 +310,8 @@ export interface ContextResult {
     warnings?: string[];
     /** Value that configures or reports ranking for this contract. */
     ranking?: ContextRankingSummary;
+    /** Token-budget selection and projection accounting for ranked focus rows. */
+    packing?: ContextPackingSummary;
     /** Whether additional ranked focus rows remain after this page. */
     has_more?: boolean;
     /** Opaque continuation cursor for the next ranked focus page. */
@@ -318,6 +321,14 @@ export interface ContextResult {
     /** Explicit marker that focus rows were bounded. */
     truncated?: true;
 }
+/** Compact token-budget accounting shared by context and next results. */
+export type ContextPackingSummary = Omit<ContextPackingReport<unknown>, "included"> & {
+    included: Array<{
+        id: string;
+        projection: string;
+        tokens: number;
+    }>;
+};
 /** Compact explainability envelope shared by context and next JSON results. */
 export interface ContextRankingSummary {
     /** Value that configures or reports model for this contract. */
@@ -382,7 +393,11 @@ declare function normalizedParentId(value: unknown): string | null;
  */
 export declare function compareCriticalItems(left: ItemMetadata, right: ItemMetadata, statusRegistry: RuntimeStatusRegistry): number;
 /** Derives the metadata signals currently available on compact item rows. More expensive history/index/semantic signals can be added by an extension scorer without changing the public candidate contract. */
-export declare function buildItemContextRelevanceCandidates(items: readonly ItemMetadata[], statusRegistry: RuntimeStatusRegistry, now: string, author: string | undefined): ContextRelevanceCandidate<ItemMetadata>[];
+export declare function buildItemContextRelevanceCandidates(items: readonly ItemMetadata[], statusRegistry: RuntimeStatusRegistry, now: string, author: string | undefined, usageAffinity?: Readonly<Record<string, number>>): ContextRelevanceCandidate<ItemMetadata>[];
+/** Packs a relevance report with monotone identity, summary, and full item projections. */
+export declare function packRankedContextItems(report: ContextRelevanceReport<ItemMetadata>, tokenBudget: number, requiredIds?: ReadonlySet<string>, profile?: "context" | "next"): ContextPackingReport<ItemMetadata>;
+/** Projects the SDK packer report onto the stable low-token command envelope. */
+export declare function toContextPackingSummary(report: ContextPackingReport<ItemMetadata>): ContextPackingSummary;
 /** Project a full scorer report onto the low-token command explanation shape. */
 export declare function toContextRankingSummary<TItem>(report: ContextRelevanceReport<TItem>): ContextRankingSummary;
 declare function completionPct(closed: number, total: number): number;

package/dist/cli/commands/context.js CHANGED Viewed

@@ -4,7 +4,7 @@
  * Implements the pm context command surface and its agent-facing runtime behavior.
  */
-!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]="a1564ad2-3e32-5b66-9327-7ff92b7aee37")}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]="7563a6df-9229-5af9-9849-85a058c01a46")}catch(e){}}();
 import { SETTINGS_DEFAULTS, EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { compareTimestampStrings, nowIso } from "../../core/shared/time.js";
@@ -19,6 +19,8 @@ import { runList } from "./list.js";
 import { runActivity } from "./activity.js";
 import { scoreContextCandidatesWithActiveExtensions, } from "../../sdk/context-relevance.js";
 import { createQueryFingerprint, encodeQueryCursor, resolveQueryCursorStart, } from "../../sdk/pagination.js";
+import { packContextCandidates, } from "../../sdk/context-packing.js";
+import { readContextUsageAffinity, recordContextUsageServing, } from "../../sdk/context-usage.js";
 // ---------------------------------------------------------------------------
 // Output format
 // ---------------------------------------------------------------------------
@@ -451,11 +453,12 @@ function buildItemContextRelevanceCandidate(item, params) {
             deadline_pressure: resolveDeadlinePressure(item.deadline, params.nowMs),
             knowledge_density: Math.min(knowledgeEntries / 5, 1),
             author_affinity: assignedToAuthor ? 1 : 0,
+            usage_affinity: params.usageAffinity?.[item.id],
         },
     };
 }
 /** Derives the metadata signals currently available on compact item rows. More expensive history/index/semantic signals can be added by an extension scorer without changing the public candidate contract. */
-export function buildItemContextRelevanceCandidates(items, statusRegistry, now, author) {
+export function buildItemContextRelevanceCandidates(items, statusRegistry, now, author, usageAffinity) {
     const recencyOrder = [...items].sort((left, right) => compareTimestampStrings(sortableTimestamp(right.updated_at), sortableTimestamp(left.updated_at)) || left.id.localeCompare(right.id));
     const recencyRank = new Map(recencyOrder.map((item, index) => [item.id, index]));
     const recencyDenominator = Math.max(items.length - 1, 1);
@@ -468,8 +471,46 @@ export function buildItemContextRelevanceCandidates(items, statusRegistry, now,
         recencyRank,
         recencyDenominator,
         itemCount: items.length,
+        usageAffinity,
     }));
 }
+function estimateJsonTokens(value) {
+    return Math.max(1, Math.ceil(Buffer.byteLength(JSON.stringify(value), "utf8") / 4));
+}
+/** Packs a relevance report with monotone identity, summary, and full item projections. */
+export function packRankedContextItems(report, tokenBudget, requiredIds = new Set(), profile = "context") {
+    return packContextCandidates(report.ranked.map((entry) => ({
+        id: entry.id,
+        item: entry.item,
+        rank: entry.rank,
+        score: entry.score,
+        required: requiredIds.has(entry.id),
+        cluster: entry.item.parent?.trim() || entry.item.type,
+        token_costs: {
+            identity: estimateJsonTokens({ id: entry.id, title: entry.item.title }),
+            summary: estimateJsonTokens({
+                id: entry.id,
+                title: entry.item.title,
+                type: entry.item.type,
+                status: entry.item.status,
+                priority: entry.item.priority,
+                parent: entry.item.parent,
+            }),
+            full: estimateJsonTokens(entry.item),
+        },
+    })), { tokenBudget, profile, latencyBudgetMs: 25 });
+}
+/** Projects the SDK packer report onto the stable low-token command envelope. */
+export function toContextPackingSummary(report) {
+    return {
+        ...report,
+        included: report.included.map((entry) => ({
+            id: entry.id,
+            projection: entry.projection,
+            tokens: entry.tokens,
+        })),
+    };
+}
 /** Project a full scorer report onto the low-token command explanation shape. */
 export function toContextRankingSummary(report) {
     return {
@@ -1195,38 +1236,51 @@ function resolveContextSubtreeIds(parentScope, fullCorpus) {
     }
     return subtree.ids;
 }
-async function resolveContextFocusGroups(listedItemMetadata, allItems, statusRegistry, sectionsIncluded, limit, now, author, cursor, cursorFingerprint, useBoundedPage) {
+async function resolveContextFocusGroups(listedItemMetadata, allItems, statusRegistry, sectionsIncluded, limit, now, author, cursor, cursorFingerprint, useBoundedPage, pmRoot) {
     const structural = [...listedItemMetadata].sort((left, right) => compareCriticalItems(left, right, statusRegistry));
-    const ranking = await scoreContextCandidatesWithActiveExtensions("context", buildItemContextRelevanceCandidates(structural, statusRegistry, now, author));
+    const usage = await readContextUsageAffinity({
+        pmRoot,
+        author,
+        enabled: process.env.PM_CONTEXT_USAGE_DISABLED !== "1",
+    });
+    const ranking = await scoreContextCandidatesWithActiveExtensions("context", buildItemContextRelevanceCandidates(structural, statusRegistry, now, author, usage.affinity));
     const ranked = ranking.ranked.map((entry) => entry.item);
     const activeStatuses = statusRegistry.active_statuses;
-    const activeItems = ranked.filter((item) => activeStatuses.has(normalizeStatusForRegistry(item.status, statusRegistry)));
+    const rankedActiveItems = ranked.filter((item) => activeStatuses.has(normalizeStatusForRegistry(item.status, statusRegistry)));
     const pageStart = useBoundedPage
-        ? resolveQueryCursorStart(activeItems, cursor, cursorFingerprint, (item) => item.id)
+        ? resolveQueryCursorStart(rankedActiveItems, cursor, cursorFingerprint, (item) => item.id)
         : 0;
     const focusPage = useBoundedPage
-        ? activeItems.slice(pageStart, pageStart + limit)
-        : activeItems;
+        ? rankedActiveItems.slice(pageStart, pageStart + limit)
+        : rankedActiveItems;
     const hasMore = useBoundedPage &&
         focusPage.length > 0 &&
-        pageStart + focusPage.length < activeItems.length;
+        pageStart + focusPage.length < rankedActiveItems.length;
     const nextCursor = hasMore && focusPage.length > 0
         ? encodeQueryCursor(cursorFingerprint, focusPage[focusPage.length - 1].id, pageStart + focusPage.length - 1)
         : undefined;
-    const blockedItems = ranked.filter((item) => statusRegistry.blocked_statuses.has(normalizeStatusForRegistry(item.status, statusRegistry)));
+    const rankedBlockedItems = ranked.filter((item) => statusRegistry.blocked_statuses.has(normalizeStatusForRegistry(item.status, statusRegistry)));
+    const packingIds = new Set([
+        ...focusPage.map((item) => item.id),
+        ...rankedBlockedItems.slice(0, limit).map((item) => item.id),
+    ]);
+    const packing = packRankedContextItems({ ...ranking, ranked: ranking.ranked.filter((entry) => packingIds.has(entry.id)) }, Math.max(256, limit * 160));
+    const packedItems = packing.included.map((entry) => entry.item);
+    const activeItems = packedItems.filter((item) => activeStatuses.has(normalizeStatusForRegistry(item.status, statusRegistry)));
+    const blockedItems = packedItems.filter((item) => statusRegistry.blocked_statuses.has(normalizeStatusForRegistry(item.status, statusRegistry)));
     const childrenByParent = buildChildrenByParent(allItems);
     const focusChildrenByParent = contextNeedsAllItems(sectionsIncluded)
         ? childrenByParent
         : undefined;
-    const highLevel = focusPage
+    const highLevel = activeItems
         .filter((item) => HIGH_LEVEL_TYPES.has(item.type))
         .slice(0, useBoundedPage ? focusPage.length : limit)
         .map((item) => toContextFocusItem(item, statusRegistry, focusChildrenByParent));
-    const lowLevel = focusPage
+    const lowLevel = activeItems
         .filter((item) => !HIGH_LEVEL_TYPES.has(item.type))
         .slice(0, useBoundedPage ? focusPage.length : limit)
         .map((item) => toContextFocusItem(item, statusRegistry, focusChildrenByParent));
-    const blockedFallbackUsed = activeItems.length === 0;
+    const blockedFallbackUsed = rankedActiveItems.length === 0;
     return {
         activeItems,
         blockedItems,
@@ -1239,6 +1293,7 @@ async function resolveContextFocusGroups(listedItemMetadata, allItems, statusReg
             : [],
         blockedFallbackUsed,
         ranking,
+        packing,
         pageExtras: {
             ...(useBoundedPage ? { applied_limit: limit } : {}),
             ...(hasMore ? { has_more: true, truncated: true } : {}),
@@ -1382,15 +1437,39 @@ function maybeAttachEmptyContextSuggestions(result, activeItems, blockedItems) {
         "pm aggregate for a full project status overview",
     ];
 }
+async function attachContextUsageFeedback(result, focusGroups, pmRoot, author) {
+    try {
+        const included = new Set(focusGroups.packing.included.map((entry) => entry.id));
+        await recordContextUsageServing({
+            pmRoot,
+            author,
+            surface: "context",
+            profile: focusGroups.packing.profile,
+            rows: focusGroups.ranking.ranked.map((entry) => ({
+                id: entry.id,
+                rank: entry.rank,
+                included: included.has(entry.id),
+            })),
+            enabled: process.env.PM_CONTEXT_USAGE_DISABLED !== "1",
+        });
+    }
+    catch {
+        result.warnings = mergeSortedWarnings(result.warnings, [
+            "context_usage_feedback_write_failed",
+        ]);
+    }
+}
 /** Implements run context for the public runtime surface of this module. */
 export async function runContext(options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
     const resolvedRuntime = await resolveContextRuntime(options, global);
     const corpus = await loadContextCorpus(options, global, resolvedRuntime);
     const runtime = {
         ...resolvedRuntime,
         limit: resolveContextLimitAtScale(resolvedRuntime.limit, corpus.fullCorpus.length),
     };
-    const focusGroups = await resolveContextFocusGroups(corpus.listedItemMetadata, corpus.allItems, runtime.statusRegistry, runtime.sectionsIncluded, runtime.limit, nowIso(), process.env.PM_AUTHOR, options.after, buildContextCursorFingerprint(options), shouldPageContextFocus(options, corpus.fullCorpus.length));
+    const author = process.env.PM_AUTHOR ?? runtime.settings.author_default;
+    const focusGroups = await resolveContextFocusGroups(corpus.listedItemMetadata, corpus.allItems, runtime.statusRegistry, runtime.sectionsIncluded, runtime.limit, nowIso(), author, options.after, buildContextCursorFingerprint(options), shouldPageContextFocus(options, corpus.fullCorpus.length), pmRoot);
     const agendaContext = await buildContextAgenda(options, global, runtime, corpus.subtreeIds);
     const warnings = mergeSortedWarnings(corpus.listed.warnings, agendaContext.agenda.warnings, focusGroups.ranking.warnings);
     const inProgressCount = countContextStatus(focusGroups.activeItems, normalizeStatusInput("in_progress", runtime.statusRegistry), runtime.statusRegistry);
@@ -1453,13 +1532,16 @@ export async function runContext(options, global) {
         ...focusGroups.pageExtras,
     };
     attachOptionalContextSections(result, sections);
-    if (options.explainRanking === true)
+    if (options.explainRanking === true) {
         result.ranking = toContextRankingSummary(focusGroups.ranking);
+        result.packing = toContextPackingSummary(focusGroups.packing);
+    }
     applyContextFocusProjection(result, runtime.focusFields);
     if (warnings.length > 0)
         result.warnings = warnings;
     maybeAttachEmptyContextSuggestions(result, focusGroups.activeItems, focusGroups.blockedItems);
+    await attachContextUsageFeedback(result, focusGroups, pmRoot, author);
     return result;
 }
 //# sourceMappingURL=context.js.map
-//# debugId=a1564ad2-3e32-5b66-9327-7ff92b7aee37
+//# debugId=7563a6df-9229-5af9-9849-85a058c01a46