@unbrained/pm-cli 2026.7.1 → 2026.7.3

package/packages/pm-guide-shell/extensions/guide-shell/runtime.ts

@@ -58,6 +58,24 @@ interface RuntimeBundle {
 
 let runtimeBundle: RuntimeBundle | null = null;
 let runtimeBundlePromise: Promise<RuntimeBundle> | null = null;
+const REQUIRED_RUNTIME_SDK_EXPORTS = [
+  "runGuide",
+  "resolveGuideOutputFormat",
+  "renderGuideMarkdown",
+  "runCompletion",
+  "pathExists",
+  "getSettingsPath",
+  "resolvePmRoot",
+  "readSettings",
+  "resolveItemTypeRegistry",
+  "resolveRuntimeStatusRegistry",
+  "resolveRuntimeFieldRegistry",
+  "listAllFrontMatter",
+  "getActiveExtensionRegistrations",
+  "readStringOption",
+  "readBooleanOption",
+  "readCsvListOption",
+] as const satisfies ReadonlyArray<keyof RuntimeSdkModule>;
 
 async function ensureRuntimeBundle(): Promise<RuntimeBundle> {
   if (runtimeBundle) {
@@ -80,24 +98,7 @@ async function loadRuntimeBundle(): Promise<RuntimeBundle> {
   const modulePath = path.join(path.resolve(envRoot.trim()), "dist", "sdk", "runtime.js");
   try {
     const sdkLoaded = (await import(pathToFileURL(modulePath).href)) as Partial<RuntimeSdkModule>;
-    if (
-      typeof sdkLoaded.runGuide === "function" &&
-      typeof sdkLoaded.resolveGuideOutputFormat === "function" &&
-      typeof sdkLoaded.renderGuideMarkdown === "function" &&
-      typeof sdkLoaded.runCompletion === "function" &&
-      typeof sdkLoaded.pathExists === "function" &&
-      typeof sdkLoaded.getSettingsPath === "function" &&
-      typeof sdkLoaded.resolvePmRoot === "function" &&
-      typeof sdkLoaded.readSettings === "function" &&
-      typeof sdkLoaded.resolveItemTypeRegistry === "function" &&
-      typeof sdkLoaded.resolveRuntimeStatusRegistry === "function" &&
-      typeof sdkLoaded.resolveRuntimeFieldRegistry === "function" &&
-      typeof sdkLoaded.listAllFrontMatter === "function" &&
-      typeof sdkLoaded.getActiveExtensionRegistrations === "function" &&
-      typeof sdkLoaded.readStringOption === "function" &&
-      typeof sdkLoaded.readBooleanOption === "function" &&
-      typeof sdkLoaded.readCsvListOption === "function"
-    ) {
+    if (REQUIRED_RUNTIME_SDK_EXPORTS.every((key) => typeof sdkLoaded[key] === "function")) {
       return {
         sdk: sdkLoaded as RuntimeSdkModule,
       };
@@ -240,6 +241,45 @@ function collectTagsFromItems(items: Array<{ metadata: { tags?: string[] } }>):
   return [...tagSet].sort((left, right) => left.localeCompare(right));
 }
 
+function readStringArrayResult(result: unknown, key: "tags" | "statuses" | "types"): string[] {
+  if (typeof result !== "object" || result === null) {
+    return [];
+  }
+  const value = (result as Record<string, unknown>)[key];
+  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === "string") : [];
+}
+
+function renderJsonOrWords(payload: unknown, result: unknown, key: "tags" | "statuses" | "types"): string {
+  if (readPayloadFormat(payload) === "json") {
+    return `${JSON.stringify(result, null, 2)}\n`;
+  }
+  return `${readStringArrayResult(result, key).join(" ")}\n`;
+}
+
+function renderCompletionPackageOutput(payload: unknown, result: unknown): string | null {
+  if (readPayloadFormat(payload) === "json") {
+    return `${JSON.stringify(result, null, 2)}\n`;
+  }
+  if (typeof result === "object" && result !== null && typeof (result as { script?: unknown }).script === "string") {
+    const script = (result as { script: string }).script;
+    return script.endsWith("\n") ? script : `${script}\n`;
+  }
+  return null;
+}
+
+function renderGuidePackageOutput(bundle: RuntimeBundle, context: ServiceOverrideContext, result: unknown): string | null {
+  const options = (context.options ?? {}) as Record<string, unknown>;
+  const global = (context.global ?? {}) as GlobalOptions;
+  const outputFormat = bundle.sdk.resolveGuideOutputFormat(options, global);
+  if (outputFormat === "markdown") {
+    return `${bundle.sdk.renderGuideMarkdown(result)}\n`;
+  }
+  if (outputFormat === "json" || readPayloadFormat(context.payload) === "json") {
+    return `${JSON.stringify(result, null, 2)}\n`;
+  }
+  return null;
+}
+
 export async function runGuidePackage(
   args: string[],
   options: Record<string, unknown>,
@@ -317,58 +357,25 @@ export async function runCompletionTypesPackage(global: GlobalOptions): Promise<
 }
 
 export function renderGuideShellPackageOutput(context: ServiceOverrideContext): string | null {
-  if (!runtimeBundle) {
+  const bundle = runtimeBundle;
+  if (!bundle) {
     return null;
   }
   const result = readPayloadResult(context.payload);
   if (context.command === "guide") {
-    const options = (context.options ?? {}) as Record<string, unknown>;
-    const global = (context.global ?? {}) as GlobalOptions;
-    const outputFormat = runtimeBundle.sdk.resolveGuideOutputFormat(options, global);
-    if (outputFormat === "markdown") {
-      return `${runtimeBundle.sdk.renderGuideMarkdown(result)}\n`;
-    }
-    if (outputFormat === "json" || readPayloadFormat(context.payload) === "json") {
-      return `${JSON.stringify(result, null, 2)}\n`;
-    }
-    return null;
+    return renderGuidePackageOutput(bundle, context, result);
   }
   if (context.command === "completion") {
-    if (readPayloadFormat(context.payload) === "json") {
-      return `${JSON.stringify(result, null, 2)}\n`;
-    }
-    if (typeof result === "object" && result !== null && typeof (result as { script?: unknown }).script === "string") {
-      const script = (result as { script: string }).script;
-      return script.endsWith("\n") ? script : `${script}\n`;
-    }
-    return null;
+    return renderCompletionPackageOutput(context.payload, result);
   }
   if (context.command === "completion-tags") {
-    if (readPayloadFormat(context.payload) === "json") {
-      return `${JSON.stringify(result, null, 2)}\n`;
-    }
-    const tags = typeof result === "object" && result !== null && Array.isArray((result as { tags?: unknown }).tags)
-      ? ((result as { tags: unknown[] }).tags.filter((entry): entry is string => typeof entry === "string"))
-      : [];
-    return `${tags.join(" ")}\n`;
+    return renderJsonOrWords(context.payload, result, "tags");
   }
   if (context.command === "completion-statuses") {
-    if (readPayloadFormat(context.payload) === "json") {
-      return `${JSON.stringify(result, null, 2)}\n`;
-    }
-    const statuses = typeof result === "object" && result !== null && Array.isArray((result as { statuses?: unknown }).statuses)
-      ? ((result as { statuses: unknown[] }).statuses.filter((entry): entry is string => typeof entry === "string"))
-      : [];
-    return `${statuses.join(" ")}\n`;
+    return renderJsonOrWords(context.payload, result, "statuses");
   }
   if (context.command === "completion-types") {
-    if (readPayloadFormat(context.payload) === "json") {
-      return `${JSON.stringify(result, null, 2)}\n`;
-    }
-    const types = typeof result === "object" && result !== null && Array.isArray((result as { types?: unknown }).types)
-      ? ((result as { types: unknown[] }).types.filter((entry): entry is string => typeof entry === "string"))
-      : [];
-    return `${types.join(" ")}\n`;
+    return renderJsonOrWords(context.payload, result, "types");
   }
   return null;
 }

package/packages/pm-todos/extensions/todos/runtime.ts

@@ -139,54 +139,77 @@ interface TodosSdkModule {
   writeFileAtomic: (targetPath: string, content: string) => Promise<void>;
 }
 
-async function loadTodosSdkModule(): Promise<TodosSdkModule> {
+const TODOS_SDK_ARRAY_EXPORTS = [
+  "CONFIDENCE_TEXT_VALUES",
+  "DEPENDENCY_KIND_VALUES",
+  "ISSUE_SEVERITY_VALUES",
+  "RISK_VALUES",
+] as const satisfies readonly (keyof TodosSdkModule)[];
+
+const TODOS_SDK_FUNCTION_EXPORTS = [
+  "PmCliError",
+  "canonicalDocument",
+  "commitImportedItem",
+  "ensureTrackerInitialized",
+  "generateItemId",
+  "getActiveExtensionRegistrations",
+  "getItemPath",
+  "listAllFrontMatter",
+  "locateItem",
+  "normalizeFrontMatter",
+  "normalizeItemId",
+  "nowIso",
+  "readLocatedItem",
+  "readSettings",
+  "resolveItemTypeRegistry",
+  "resolvePmRoot",
+  "runActiveOnReadHooks",
+  "runActiveOnWriteHooks",
+  "selectImportAuthor",
+  "splitFrontMatter",
+  "toEstimatedMinutesValue",
+  "toImportPriority",
+  "toImportStatus",
+  "toImportTags",
+  "toNonEmptyImportString",
+  "writeFileAtomic",
+] as const satisfies readonly (keyof TodosSdkModule)[];
+
+function resolveTodosSdkModulePath(): string {
   const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
   const hasConfiguredPackageRoot = typeof envRoot === "string" && envRoot.trim().length > 0;
-  const packageRoot =
-    hasConfiguredPackageRoot
-      ? path.resolve(envRoot.trim())
-      : path.resolve(CURRENT_RUNTIME_ROOT, "../../../..");
-  const modulePath = hasConfiguredPackageRoot
+  const packageRoot = hasConfiguredPackageRoot ? path.resolve(envRoot.trim()) : path.resolve(CURRENT_RUNTIME_ROOT, "../../../..");
+  return hasConfiguredPackageRoot
     ? path.join(packageRoot, "dist", "sdk", "index.js")
     : path.join(packageRoot, "src", "sdk", "index.ts");
+}
+
+function hasTodosSdkArrayExports(loaded: Partial<TodosSdkModule>): boolean {
+  return TODOS_SDK_ARRAY_EXPORTS.every((key) => Array.isArray(loaded[key]));
+}
+
+function hasTodosSdkFunctionExports(loaded: Partial<TodosSdkModule>): boolean {
+  return TODOS_SDK_FUNCTION_EXPORTS.every((key) => typeof loaded[key] === "function");
+}
+
+function hasTodosSdkExitCodeExports(loaded: Partial<TodosSdkModule>): boolean {
+  return (
+    typeof loaded.EXIT_CODE === "object" &&
+    loaded.EXIT_CODE !== null &&
+    typeof loaded.EXIT_CODE.NOT_FOUND === "number"
+  );
+}
+
+function isTodosSdkModule(loaded: Partial<TodosSdkModule>): loaded is TodosSdkModule {
+  return hasTodosSdkArrayExports(loaded) && hasTodosSdkFunctionExports(loaded) && hasTodosSdkExitCodeExports(loaded);
+}
+
+async function loadTodosSdkModule(): Promise<TodosSdkModule> {
+  const modulePath = resolveTodosSdkModulePath();
   try {
     const loaded = (await import(pathToFileURL(modulePath).href)) as Partial<TodosSdkModule>;
-    if (
-      Array.isArray(loaded.CONFIDENCE_TEXT_VALUES) &&
-      Array.isArray(loaded.DEPENDENCY_KIND_VALUES) &&
-      typeof loaded.EXIT_CODE === "object" &&
-      loaded.EXIT_CODE !== null &&
-      typeof loaded.EXIT_CODE.NOT_FOUND === "number" &&
-      Array.isArray(loaded.ISSUE_SEVERITY_VALUES) &&
-      typeof loaded.PmCliError === "function" &&
-      Array.isArray(loaded.RISK_VALUES) &&
-      typeof loaded.canonicalDocument === "function" &&
-      typeof loaded.commitImportedItem === "function" &&
-      typeof loaded.ensureTrackerInitialized === "function" &&
-      typeof loaded.generateItemId === "function" &&
-      typeof loaded.getActiveExtensionRegistrations === "function" &&
-      typeof loaded.getItemPath === "function" &&
-      typeof loaded.listAllFrontMatter === "function" &&
-      typeof loaded.locateItem === "function" &&
-      typeof loaded.normalizeFrontMatter === "function" &&
-      typeof loaded.normalizeItemId === "function" &&
-      typeof loaded.nowIso === "function" &&
-      typeof loaded.readLocatedItem === "function" &&
-      typeof loaded.readSettings === "function" &&
-      typeof loaded.resolveItemTypeRegistry === "function" &&
-      typeof loaded.resolvePmRoot === "function" &&
-      typeof loaded.runActiveOnReadHooks === "function" &&
-      typeof loaded.runActiveOnWriteHooks === "function" &&
-      typeof loaded.selectImportAuthor === "function" &&
-      typeof loaded.splitFrontMatter === "function" &&
-      typeof loaded.toEstimatedMinutesValue === "function" &&
-      typeof loaded.toImportPriority === "function" &&
-      typeof loaded.toImportStatus === "function" &&
-      typeof loaded.toImportTags === "function" &&
-      typeof loaded.toNonEmptyImportString === "function" &&
-      typeof loaded.writeFileAtomic === "function"
-    ) {
-      return loaded as TodosSdkModule;
+    if (isTodosSdkModule(loaded)) {
+      return loaded;
     }
   } catch (error: unknown) {
     throw new Error(`builtin-todos failed to load SDK exports from ${modulePath}.`, { cause: error });

package/plugins/pm-claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pm-claude",
-  "description": "Native pm CLI integration for Claude Code — 26 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents (coordinator, delivery-chain, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.",
-  "version": "1.4.0",
+  "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents (coordinator, delivery-chain, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.",
+  "version": "1.4.1",
   "author": {
     "name": "unbrained",
     "url": "https://github.com/unbraind/pm-cli"

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 |
 |-----------|----------------|
-| **26 MCP tools** | Full pm surface: context, search, list, get, create, copy, focus, update, claim, release, close, comments, files, docs, notes, learnings, deps, test, validate, health, contracts, plan, append, schema, config + `pm_run` for everything else |
+| **28 MCP tools** | Full pm surface: next, context, search, list, get, create, copy, focus, update, claim, release, close, comments, files, docs, notes, learnings, deps, test, validate, health, contracts, plan, append, schema, config, profile + `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 26 MCP tools, 5 skills, 14 slash commands, 4 subagents, hybrid TUI tracking, and the session hook in one step. (`pm-claude` is the plugin name; `pm` is the marketplace name from `marketplace.json`.)
+This installs all 28 MCP tools, 5 skills, 14 slash commands, 4 subagents, hybrid TUI tracking, and the session hook in one step. (`pm-claude` is the plugin name; `pm` is the marketplace name from `marketplace.json`.)
 
 ### Option B: Global MCP server via Claude Code CLI (MCP tools only)
 
@@ -37,7 +37,7 @@ This installs all 26 MCP tools, 5 skills, 14 slash commands, 4 subagents, hybrid
 claude mcp add --transport stdio pm-mcp -- npx -y --package=@unbrained/pm-cli@latest pm-mcp
 ```
 
-This gives you the 26 MCP tools but not the skills, slash commands, or session hook.
+This gives you the 28 MCP tools but not the skills, slash commands, or session hook.
 
 ### Option C: Direct `.mcp.json` (project-scoped MCP only)
 
@@ -139,12 +139,14 @@ Spawn pm-triage-agent to set up the pm item for: add OAuth2 login support
 
 | Tool | Purpose |
 |------|---------|
+| `pm_next` | Pick the next actionable item |
 | `pm_context` | Active work snapshot |
 | `pm_search` | Keyword/semantic/hybrid search |
 | `pm_list` | Filtered item list |
 | `pm_get` | Single item detail |
 | `pm_create` | Create new item |
 | `pm_copy` | Copy item into a new id |
+| `pm_focus` | Set or clear the focused item |
 | `pm_update` | Update metadata |
 | `pm_append` | Append text to item body |
 | `pm_claim` | Claim for active work |
@@ -162,6 +164,7 @@ Spawn pm-triage-agent to set up the pm item for: add OAuth2 login support
 | `pm_contracts` | Inspect command contracts |
 | `pm_schema` | Manage custom item types/statuses |
 | `pm_config` | Read or write settings keys |
+| `pm_profile` | List/show/apply project profiles |
 | `pm_plan` | Manage durable Plan workflows |
 
 ### General tool

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 26 MCP tools available: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `pm_copy`, `pm_focus`, `pm_update`, `pm_append`, `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_schema`, `pm_config`, `pm_plan`, `pm_run`
+   - All 28 MCP tools available: `pm_next`, `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `pm_copy`, `pm_focus`, `pm_update`, `pm_append`, `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_schema`, `pm_config`, `pm_profile`, `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/dist/cli-bundle/chunks/activity-AW6XVFH6.js

@@ -1,16 +0,0 @@
-import {
-  _testOnly,
-  runActivity
-} from "./chunk-JLM7BHI7.js";
-import "./chunk-64HNBBFQ.js";
-import "./chunk-G7I7DEZA.js";
-import "./chunk-4DUVCVLZ.js";
-import "./chunk-3K2M5OYU.js";
-import "./chunk-BHO33VBQ.js";
-import "./chunk-WYDHYJPO.js";
-import "./chunk-RVUALSJF.js";
-export {
-  _testOnly,
-  runActivity
-};
-//# sourceMappingURL=activity-AW6XVFH6.js.map

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

@@ -1 +0,0 @@
-{"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"],"names":[],"mappings":"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","debugId":"f142f3dc-02b5-5d0f-9360-cdbd397f5cf2"}

package/dist/cli-bundle/chunks/chunk-22WKIL3H.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/activity.ts"],"sourcesContent":["/**\n * @module cli/commands/activity\n *\n * Implements the pm activity command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getActiveExtensionRegistrations, runActiveOnReadHooks } from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { enforceHistoryStreamPolicyForItems } from \"../../core/history/history-stream-policy.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { compareTimestampStrings, nowIso, resolveIsoOrRelative } from \"../../core/shared/time.js\";\nimport { listAllFrontMatterLight } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { readHistoryEntries } from \"./history.js\";\nimport { parseLimit } from \"../shared-parsers.js\";\nimport type { HistoryEntry } from \"../../types/index.js\";\n\n/**\n * Documents the activity command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface ActivityCommandOptions {\n  id?: string;\n  op?: string;\n  author?: string;\n  from?: string;\n  to?: string;\n  limit?: string;\n  compact?: boolean;\n}\n\n/**\n * Documents the activity entry payload exchanged by command, SDK, and package integrations.\n */\nexport interface ActivityEntry extends HistoryEntry {\n  id: string;\n}\n\n/**\n * Documents the compact activity entry payload exchanged by command, SDK, and package integrations.\n */\nexport interface CompactActivityEntry {\n  id: string;\n  op: string;\n  ts: string;\n  author: string;\n  msg?: string;\n}\n\n/**\n * Documents the activity result payload exchanged by command, SDK, and package integrations.\n */\nexport interface ActivityResult {\n  activity: ActivityEntry[];\n  compact_activity?: CompactActivityEntry[];\n  compact: boolean;\n  count: number;\n  limit: number | null;\n}\n\nfunction parseNonEmptyFilter(raw: string | undefined, flagLabel: string): string | undefined {\n  if (raw === undefined) return undefined;\n  const normalized = raw.trim();\n  if (normalized.length === 0) {\n    throw new PmCliError(`${flagLabel} must not be empty`, EXIT_CODE.USAGE);\n  }\n  return normalized;\n}\n\nfunction parseRangeBound(raw: string | undefined, nowValue: string, fieldLabel: string): string | undefined {\n  if (raw === undefined) return undefined;\n  const normalized = raw.trim();\n  if (normalized.length === 0) {\n    throw new PmCliError(\"Activity time bounds must not be empty\", EXIT_CODE.USAGE);\n  }\n  return resolveIsoOrRelative(normalized, new Date(nowValue), fieldLabel);\n}\n\nfunction includeByTimeWindow(entry: ActivityEntry, from: string | undefined, to: string | undefined): boolean {\n  if (entry.ts.length === 0 && (from || to)) {\n    return false;\n  }\n  if (from && compareTimestampStrings(entry.ts, from) < 0) {\n    return false;\n  }\n  if (to && compareTimestampStrings(entry.ts, to) >= 0) {\n    return false;\n  }\n  return true;\n}\n\nfunction limitEntries<T>(values: T[], limit: number | undefined): T[] {\n  if (limit === undefined) return values;\n  return values.slice(0, limit);\n}\n\nfunction readActivityString(value: unknown, fallback = \"\"): string {\n  return typeof value === \"string\" ? value : fallback;\n}\n\nfunction normalizeActivityEntry(id: string, entry: HistoryEntry): ActivityEntry {\n  return {\n    ...entry,\n    id,\n    ts: readActivityString(entry.ts),\n    author: readActivityString(entry.author, \"unknown\"),\n    op: readActivityString(entry.op, \"unknown\"),\n    patch: Array.isArray(entry.patch) ? entry.patch : [],\n    before_hash: readActivityString(entry.before_hash),\n    after_hash: readActivityString(entry.after_hash),\n  };\n}\n\nfunction sortActivity(entries: ActivityEntry[]): ActivityEntry[] {\n  return [...entries].sort((a, b) => {\n    const byTimestamp = b.ts.localeCompare(a.ts);\n    if (byTimestamp !== 0) return byTimestamp;\n    const byId = a.id.localeCompare(b.id);\n    if (byId !== 0) return byId;\n    return a.op.localeCompare(b.op);\n  });\n}\n\nasync function listHistoryFiles(historyDir: string): Promise<string[]> {\n  try {\n    return (await fs.readdir(historyDir))\n      .filter((entry) => entry.endsWith(\".jsonl\"))\n      .sort((a, b) => a.localeCompare(b));\n  } catch (error: unknown) {\n    // Activity should degrade gracefully when optional history storage is absent.\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      return [];\n    }\n    throw error;\n  }\n}\n\nexport const _testOnly = {\n  parseNonEmptyFilter,\n  parseRangeBound,\n  includeByTimeWindow,\n  limitEntries,\n  readActivityString,\n  normalizeActivityEntry,\n  sortActivity,\n  listHistoryFiles,\n};\n\n/**\n * Implements run activity for the public runtime surface of this module.\n */\nexport async function runActivity(options: ActivityCommandOptions, global: GlobalOptions): Promise<ActivityResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const nowValue = nowIso();\n  const idFilter = parseNonEmptyFilter(options.id, \"Activity --id\");\n  const opFilter = parseNonEmptyFilter(options.op, \"Activity --op\");\n  const authorFilter = parseNonEmptyFilter(options.author, \"Activity --author\");\n  const fromBound = parseRangeBound(options.from, nowValue, \"--from\");\n  const toBound = parseRangeBound(options.to, nowValue, \"--to\");\n  if (fromBound && toBound && compareTimestampStrings(fromBound, toBound) >= 0) {\n    throw new PmCliError(\"Activity --from must be before --to\", EXIT_CODE.USAGE);\n  }\n  const limit = parseLimit(options.limit);\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);\n  await enforceHistoryStreamPolicyForItems({\n    pmRoot,\n    settings,\n    itemIds: items.map((item) => item.id),\n    commandLabel: \"activity\",\n  });\n  const historyDir = path.join(pmRoot, \"history\");\n  await runActiveOnReadHooks({\n    path: historyDir,\n    scope: \"project\",\n  });\n  const historyFiles = await listHistoryFiles(historyDir);\n\n  const combined: ActivityEntry[] = [];\n  for (const file of historyFiles) {\n    const id = file.slice(0, -\".jsonl\".length);\n    if (idFilter && id !== idFilter) {\n      continue;\n    }\n    const entries = await readHistoryEntries(path.join(historyDir, file), id);\n    for (const entry of entries) {\n      if (opFilter && entry.op !== opFilter) {\n        continue;\n      }\n      if (authorFilter && entry.author !== authorFilter) {\n        continue;\n      }\n      const candidate = normalizeActivityEntry(id, entry);\n      if (!includeByTimeWindow(candidate, fromBound, toBound)) {\n        continue;\n      }\n      combined.push({\n        ...candidate,\n      });\n    }\n  }\n\n  const activity = limitEntries(sortActivity(combined), limit);\n  const compact = options.compact === true;\n  const compactActivity = compact\n    ? activity.map((entry): CompactActivityEntry => ({\n        id: entry.id,\n        op: entry.op,\n        ts: entry.ts,\n        author: entry.author,\n        ...(entry.message ? { msg: entry.message } : {}),\n      }))\n    : undefined;\n  return {\n    activity: compact ? [] : activity,\n    compact_activity: compactActivity,\n    compact,\n    count: activity.length,\n    limit: limit ?? null,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"97751191-5385-5273-bab1-76cf3bd7e444"}