@unbrained/pm-cli 2026.6.6 → 2026.6.7

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 2026.6.7 - 2026-06-07
+
+### Added
+
+- pm-governance-audit: onWrite/onRead hooks exemplar \(hooks capability\) ([pm-7m8p](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-7m8p.toon))
+- pm history-compact: checkpoint-based history stream compaction ([pm-3pbq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-3pbq.toon))
+- Advanced relevance tuning \(post-v0.1\): cross-encoder reranking + query expansion ([pm-7tsx](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-7tsx.toon))
+- Configurable vector store collection name \(post-v0.1 adapter optimization\) ([pm-usw2](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-usw2.toon))
+- pm copy <id\>: clone an item to a new ID with optional title override ([pm-m4nn](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-m4nn.toon))
+- pm aggregate --sum/--avg: numeric aggregation over filtered items ([pm-bvns](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-bvns.toon))
+- pm list --tree: recursive subtree rendering with indented hierarchy ([pm-vbzc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-vbzc.toon))
+- Configurable semantic corpus character limit \(search.embedding\_corpus\_max\_characters\) ([pm-cxdg](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-cxdg.toon))
+- Per-query hybrid weight override: pm search --semantic-weight \(post-v0.1\) ([pm-cy8i](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-cy8i.toon))
+
+### Fixed
+
+- Track removal of TOON upstream bracket-bug workaround when upstream fix ships ([pm-idnz](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-idnz.toon))
+- Drift-scan cache can false-hit on mtime-preserving file copies ([pm-up22](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-up22.toon))
+- Search relevance evaluation harness \(golden queries, nDCG\) for regression detection ([pm-22x2](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-22x2.toon))
+
+### Security
+
+- Harden afterCommand coverage and GitHub code-scanning visibility ([pm-izid](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-izid.toon))
+
+### Other
+
+- Agent command compatibility and package command discovery ([pm-7etc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-7etc.toon))
+- Package install fallback hints and extension collision plans ([pm-e48i](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-e48i.toon))
+- Stabilize npx onboarding path for scoped pm package ([pm-pgew](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-pgew.toon))
+- Publish pm-github starter package as a community reference \(credential-requiring pattern\) ([pm-zw0n](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-zw0n.toon))
+- Make list --ids repeatable for focused agent working-set refresh ([pm-42tb](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-42tb.toon))
+- SDK testing helper for vector store adapter registrations ([pm-475h](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-475h.toon))
+- SDK testing helper for package manifest resource assertions ([pm-xevy](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-xevy.toon))
+- SDK testing helpers for schema package registrations ([pm-01bm](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-01bm.toon))
+- PR \#123 review: make governance hook sidecar logging fail-open ([pm-mzlu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-mzlu.toon))
+- Config-driven optional close reason via governance.require\_close\_reason ([pm-peyv](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-peyv.toon))
+
 ## 2026.6.6 - 2026-06-06
 
 ### Added

package/README.md

@@ -42,7 +42,7 @@ Use the npm registry package for global installs and updates. Avoid `npm install
 Project-local invocation also works:
 
 ```bash
-npx @unbrained/pm-cli --help
+npx --yes @unbrained/pm-cli@latest --help
 ```
 
 For Claude Code, install the native plugin (no `pm` CLI required):
@@ -126,6 +126,10 @@ For token-aware local routing, install `guide-shell` with `pm install guide-shel
 
 `search.tuning` lexical defaults include `reminders_weight=2` and `events_weight=2` in addition to title/description/tag/status/body/comment/note/learning/dependency/linked-content weights. Keep docs and contracts aligned with runtime defaults when tuning behavior changes.
 
+Hybrid queries can override blend weight per call via `pm search --mode hybrid --semantic-weight <0..1>`, and semantic corpus truncation can be tuned via `pm config project set search_embedding_corpus_max_characters <positive-int>` (provider defaults still apply when unset).
+
+Advanced semantic tuning is opt-in: `search.query_expansion` can expand semantic/hybrid queries before embedding, and `search.rerank` can rerank hybrid top-k candidates (with graceful fallback warnings when providers are unavailable). Vector backends now also support `vector_store.collection_name` for multi-workspace/shared-store isolation.
+
 ## Tracker References
 
 Current documentation work is tracked through:

package/dist/cli/commander-usage.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b54efed6-c3b0-5b4d-9912-588c58198fba")}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]="591ae949-391a-5ede-8e92-15df7e3264df")}catch(e){}}();
 import { pathExists } from "../core/fs/fs-utils.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
@@ -14,6 +14,7 @@ import { getCommandPath } from "./registration-helpers.js";
 import { normalizeBootstrapInvocation, parseBootstrapGlobalOptions, parseBootstrapCommandName, } from "./bootstrap-args.js";
 import { extractProvidedOptionFlags, normalizeLongFlag, renderPmCommand, } from "./argv-utils.js";
 import { levenshteinDistanceWithinLimit } from "../core/shared/levenshtein.js";
+import { normalizeExtensionNameForMatch } from "./commands/extension/shared.js";
 export const BUILTIN_TYPE_HELP_VALUES = BUILTIN_ITEM_TYPE_VALUES.join("|");
 const OPTIONAL_PACKAGE_INSTALL_HINTS = {
     calendar: "calendar",
@@ -152,6 +153,46 @@ function resolveOptionalPackageInstallHint(commandPath) {
     }
     return `If this command comes from an optional package, install it with: pm install ${packageAlias}`;
 }
+function normalizePackageCommandAliasToken(value) {
+    let normalized = normalizeExtensionNameForMatch(value);
+    // Strip outer package/source prefixes and then the pm- package stem so scoped
+    // and builtin package guesses converge on the exported command alias.
+    for (const prefix of ["@unbraind/", "@unbrained/", "builtin-", "pm-"]) {
+        if (normalized.startsWith(prefix)) {
+            normalized = normalized.slice(prefix.length);
+        }
+    }
+    return normalized;
+}
+function collectInstalledPackageCommandPathHints(unknownToken, extensionDescriptors) {
+    const normalizedUnknown = normalizePackageCommandAliasToken(unknownToken);
+    if (normalizedUnknown.length === 0) {
+        return [];
+    }
+    const hints = [];
+    for (const descriptor of extensionDescriptors.values()) {
+        const identifiers = new Set();
+        const source = descriptor.source;
+        if (source) {
+            for (const identifier of [source.name, source.package]) {
+                const normalizedIdentifier = normalizePackageCommandAliasToken(identifier ?? "");
+                if (normalizedIdentifier.length > 0) {
+                    identifiers.add(normalizedIdentifier);
+                }
+            }
+        }
+        if (identifiers.size === 0) {
+            continue;
+        }
+        const matches = [...identifiers].some((identifier) => identifier === normalizedUnknown ||
+            identifier.includes(normalizedUnknown) ||
+            normalizedUnknown.includes(identifier));
+        if (matches) {
+            hints.push(descriptor.command);
+        }
+    }
+    return [...new Set(hints)].sort((left, right) => left.localeCompare(right));
+}
 function collectKnownLongFlags(commandName) {
     const flags = new Set();
     const contracts = resolveSubcommandFlagContractsForCommand(commandName);
@@ -302,7 +343,8 @@ export function buildUnknownCommandGuidanceFromRuntime(rawMessage, root, extensi
     })
         .map((entry) => entry.commandPath);
     const aliasCandidates = (COMMON_COMMAND_ALIASES[primaryToken] ?? []).filter((aliasPath) => commandPaths.includes(aliasPath));
-    const combinedCandidates = dedupeStrings([...aliasCandidates, ...rankedCandidates]);
+    const installedPackageCandidates = collectInstalledPackageCommandPathHints(primaryToken, extensionDescriptors).filter((commandPath) => commandPaths.includes(commandPath));
+    const combinedCandidates = dedupeStrings([...aliasCandidates, ...rankedCandidates, ...installedPackageCandidates]);
     const fallbackTopLevel = [...new Set(commandPaths.map((commandPath) => commandPath.split(" ")[0]).filter((segment) => segment.length > 0))];
     fallbackTopLevel.sort((left, right) => left.localeCompare(right));
     const suggestedPaths = (combinedCandidates.length > 0 ? combinedCandidates : fallbackTopLevel).slice(0, 3);
@@ -322,6 +364,32 @@ export function buildUnknownCommandGuidanceFromRuntime(rawMessage, root, extensi
 function dedupeStrings(values) {
     return Array.from(new Set(values));
 }
+function firstWhitespaceSeparatedToken(input) {
+    let token = "";
+    for (const character of input) {
+        if (character === " " ||
+            character === "\t" ||
+            character === "\n" ||
+            character === "\r" ||
+            character === "\f" ||
+            character === "\v") {
+            break;
+        }
+        token += character;
+    }
+    return token;
+}
+function trimTrailingPunctuationToken(token) {
+    let end = token.length;
+    while (end > 0) {
+        const character = token[end - 1];
+        if (character !== "," && character !== ":" && character !== ";") {
+            break;
+        }
+        end -= 1;
+    }
+    return token.slice(0, end);
+}
 export function resolveChildCommandByToken(parent, token) {
     const normalizedToken = token.trim().toLowerCase();
     return parent.commands.find((candidate) => {
@@ -390,7 +458,9 @@ export async function resolveCommanderUsageContext(error, rootProgram, extension
     }
     if (!suggestedRetryCommand) {
         const missingRequiredOption = message.match(/required option '([^']+)' not specified/i);
-        const requiredOptionToken = missingRequiredOption?.[1]?.trim().split(/\s+/)[0]?.replace(/[,:;]+$/g, "");
+        const requiredOptionToken = missingRequiredOption?.[1]
+            ? trimTrailingPunctuationToken(firstWhitespaceSeparatedToken(missingRequiredOption[1].trim()))
+            : undefined;
         if (requiredOptionToken?.startsWith("--")) {
             const hasFlag = invocationArgv.some((token) => token.startsWith(requiredOptionToken));
             if (!hasFlag) {
@@ -449,4 +519,4 @@ export async function formatCommanderUsageJson(error, rootProgram, extensionDesc
     return JSON.stringify(envelope, null, 2);
 }
 //# sourceMappingURL=commander-usage.js.map
-//# debugId=b54efed6-c3b0-5b4d-9912-588c58198fba
+//# debugId=591ae949-391a-5ede-8e92-15df7e3264df

package/dist/cli/commander-usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"commander-usage.js","sources":["cli/commander-usage.ts"],"sourceRoot":"/","sourcesContent":["import { Command } from \"commander\";\nimport { pathExists } from \"../core/fs/fs-utils.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport { BUILTIN_ITEM_TYPE_VALUES } from \"../types/index.js\";\nimport {\n  getActiveExtensionRegistrations,\n  runActiveServiceOverride,\n} from \"../core/extensions/index.js\";\nimport { PM_CORE_COMMAND_NAMES, resolveSubcommandFlagContractsForCommand } from \"../sdk/cli-contracts.js\";\nimport {\n  type CommanderGuidanceContext,\n  formatCommanderErrorForDisplay,\n  formatCommanderErrorForJson,\n} from \"./error-guidance.js\";\nimport { normalizeHelpCommandPath } from \"./help-content.js\";\nimport { getCommandPath } from \"./registration-helpers.js\";\nimport {\n  normalizeBootstrapInvocation,\n  parseBootstrapGlobalOptions,\n  parseBootstrapCommandName,\n} from \"./bootstrap-args.js\";\nimport {\n  extractProvidedOptionFlags,\n  normalizeLongFlag,\n  renderPmCommand,\n} from \"./argv-utils.js\";\nimport { levenshteinDistanceWithinLimit } from \"../core/shared/levenshtein.js\";\nimport type { ExtensionCommandHelpDescriptor } from \"./extension-command-help.js\";\n\nexport const BUILTIN_TYPE_HELP_VALUES = BUILTIN_ITEM_TYPE_VALUES.join(\"|\");\n\nconst OPTIONAL_PACKAGE_INSTALL_HINTS: Record<string, string> = {\n  calendar: \"calendar\",\n  cal: \"calendar\",\n  reindex: \"search-advanced\",\n  \"search-advanced\": \"search-advanced\",\n  \"dedupe-audit\": \"governance-audit\",\n  \"comments-audit\": \"governance-audit\",\n  normalize: \"governance-audit\",\n  guide: \"guide-shell\",\n  completion: \"guide-shell\",\n  templates: \"templates\",\n  \"test-runs\": \"linked-test-adapters\",\n  beads: \"beads\",\n  todos: \"todos\",\n};\n\nconst COMMON_COMMAND_ALIASES: Record<string, string[]> = {\n  comment: [\"comments\"],\n  note: [\"notes\"],\n  learning: [\"learnings\"],\n  show: [\"get\"],\n};\n\nconst SEMANTIC_UNKNOWN_OPTION_SUGGESTIONS: Record<string, Record<string, string[]>> = {\n  comments: {\n    \"--body\": [\"--add\"],\n    \"--text\": [\"--add\"],\n    \"--comment\": [\"--add\"],\n  },\n  notes: {\n    \"--body\": [\"--add\"],\n    \"--text\": [\"--add\"],\n    \"--note\": [\"--add\"],\n  },\n  learnings: {\n    \"--body\": [\"--add\"],\n    \"--text\": [\"--add\"],\n    \"--learning\": [\"--add\"],\n  },\n  // pm update / pm create now accept --add-tags natively, so the singular\n  // --add-tag and the old \"--tag\" mistype still need to be redirected at the\n  // canonical additive flag (not at --tags, which would silently replace).\n  update: {\n    \"--add-tag\": [\"--add-tags\"],\n    \"--remove-tag\": [\"--remove-tags\"],\n    \"--tag\": [\"--tags\"],\n  },\n  create: {\n    \"--add-tag\": [\"--add-tags\"],\n    \"--tag\": [\"--tags\"],\n  },\n};\n\nfunction getSemanticUnknownOptionSuggestions(commandName: string, unknownOption: string): string[] {\n  const commandSuggestions = SEMANTIC_UNKNOWN_OPTION_SUGGESTIONS[commandName];\n  if (!commandSuggestions) {\n    return [];\n  }\n  const normalizedUnknown = normalizeLongFlag(unknownOption);\n  for (const [flag, suggestions] of Object.entries(commandSuggestions)) {\n    if (normalizeLongFlag(flag) === normalizedUnknown) {\n      return suggestions;\n    }\n  }\n  return [];\n}\n\nexport interface CommanderUsageContext extends CommanderGuidanceContext {\n  message: string;\n  commandName: string | undefined;\n  allowedTypes: string;\n}\n\nexport function collectRuntimeCommandPaths(\n  root: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): string[] {\n  const commandPaths = new Set<string>();\n  const queue: Command[] = [...root.commands];\n  while (queue.length > 0) {\n    const current = queue.shift();\n    if (!current) {\n      continue;\n    }\n    const normalizedPath = normalizeHelpCommandPath(getCommandPath(current));\n    const hasInternalSegment = normalizedPath.split(\" \").some((segment) => segment.startsWith(\"_\"));\n    if (normalizedPath.length > 0 && !hasInternalSegment) {\n      commandPaths.add(normalizedPath);\n    }\n    queue.push(...current.commands);\n  }\n  for (const descriptorPath of extensionDescriptors.keys()) {\n    const normalizedPath = normalizeHelpCommandPath(descriptorPath);\n    const hasInternalSegment = normalizedPath.split(\" \").some((segment) => segment.startsWith(\"_\"));\n    if (normalizedPath.length > 0 && !hasInternalSegment) {\n      commandPaths.add(normalizedPath);\n    }\n  }\n  return [...commandPaths].sort((left, right) => left.localeCompare(right));\n}\n\nexport function scoreCommandPathMatch(commandPath: string, queryToken: string): number {\n  const normalizedPath = commandPath.trim().toLowerCase();\n  const normalizedToken = queryToken.trim().toLowerCase();\n  if (normalizedToken.length === 0) {\n    return Number.POSITIVE_INFINITY;\n  }\n  const pathSegments = normalizedPath.split(\" \");\n  if (normalizedPath === normalizedToken) {\n    return 0;\n  }\n  if (pathSegments.includes(normalizedToken)) {\n    return 1;\n  }\n  if (pathSegments.some((segment) => segment.startsWith(normalizedToken))) {\n    return 2;\n  }\n  if (normalizedPath.includes(normalizedToken)) {\n    return 3;\n  }\n  // Fall back to edit distance so transposition/typo cases (e.g. \"lst\" -> \"list\") still rank.\n  const maxDistance = normalizedToken.length >= 5 ? 2 : 1;\n  let bestDistance = Number.POSITIVE_INFINITY;\n  for (const segment of pathSegments) {\n    const distance = levenshteinDistanceWithinLimit(segment, normalizedToken, maxDistance);\n    if (distance !== null) {\n      bestDistance = Math.min(bestDistance, distance);\n    }\n  }\n  if (Number.isFinite(bestDistance)) {\n    return 4 + bestDistance;\n  }\n  return Number.POSITIVE_INFINITY;\n}\n\nfunction toComparableFlag(flag: string): string {\n  return normalizeLongFlag(flag).slice(2).replace(/-/g, \"\");\n}\n\nfunction renderAttemptedCommand(argv: string[]): string {\n  return renderPmCommand(argv);\n}\n\nfunction resolveOptionalPackageInstallHint(commandPath: string): string | null {\n  const topLevel = commandPath.split(\" \")[0]?.trim().toLowerCase();\n  if (!topLevel) {\n    return null;\n  }\n  const packageAlias = OPTIONAL_PACKAGE_INSTALL_HINTS[topLevel];\n  if (!packageAlias) {\n    return null;\n  }\n  return `If this command comes from an optional package, install it with: pm install ${packageAlias}`;\n}\n\nfunction collectKnownLongFlags(commandName: string | undefined): string[] {\n  const flags = new Set<string>();\n  const contracts = resolveSubcommandFlagContractsForCommand(commandName);\n  for (const contract of contracts) {\n    if (contract.flag.startsWith(\"--\")) {\n      flags.add(normalizeLongFlag(contract.flag));\n    }\n    for (const alias of contract.aliases ?? []) {\n      if (alias.startsWith(\"--\")) {\n        flags.add(normalizeLongFlag(alias));\n      }\n    }\n  }\n  return [...flags].sort((left, right) => left.localeCompare(right));\n}\n\nfunction suggestNearestLongFlags(unknownOption: string, knownFlags: string[]): string[] {\n  if (!unknownOption.startsWith(\"--\")) {\n    return [];\n  }\n  const unknownComparable = toComparableFlag(unknownOption);\n  if (unknownComparable.length === 0) {\n    return [];\n  }\n  const maxDistance = unknownComparable.length >= 8 ? 2 : 1;\n  // rank 0 = abbreviation/prefix match (e.g. --desc -> --description), rank 1 = edit-distance typo.\n  const candidates: Array<{ flag: string; rank: number; distance: number }> = [];\n  for (const flag of knownFlags) {\n    const flagComparable = toComparableFlag(flag);\n    if (flagComparable === unknownComparable) {\n      continue;\n    }\n    if (unknownComparable.length >= 3 && flagComparable.startsWith(unknownComparable)) {\n      candidates.push({ flag, rank: 0, distance: flagComparable.length - unknownComparable.length });\n      continue;\n    }\n    const distance = levenshteinDistanceWithinLimit(unknownComparable, flagComparable, maxDistance);\n    if (distance === null || distance <= 0) {\n      continue;\n    }\n    candidates.push({ flag, rank: 1, distance });\n  }\n  return candidates\n    .sort((left, right) => {\n      if (left.rank !== right.rank) {\n        return left.rank - right.rank;\n      }\n      if (left.distance !== right.distance) {\n        return left.distance - right.distance;\n      }\n      return left.flag.localeCompare(right.flag);\n    })\n    .map((entry) => entry.flag)\n    .slice(0, 3);\n}\n\nlet crossCommandFlagIndexCache: Map<string, string[]> | undefined;\n\n// Alias/shortcut command names that duplicate a canonical command. Excluding them\n// keeps cross-command flag hints focused on the primary commands an agent should use.\nconst CROSS_COMMAND_FLAG_EXCLUSIONS = new Set<string>([\n  \"ctx\",\n  \"packages\",\n  \"list-draft\",\n  \"list-open\",\n  \"list-in-progress\",\n  \"list-blocked\",\n  \"list-closed\",\n  \"list-canceled\",\n  \"start-task\",\n  \"pause-task\",\n  \"close-task\",\n  \"help\",\n]);\n\n// Index of long flag -> command names that accept it (in declaration order), so an\n// unknown flag on one command can be recognised as valid elsewhere (e.g. --type is\n// rejected on test-all but valid on create/list). Built once from core command contracts.\nfunction getCrossCommandFlagIndex(): Map<string, string[]> {\n  if (crossCommandFlagIndexCache) {\n    return crossCommandFlagIndexCache;\n  }\n  const index = new Map<string, string[]>();\n  for (const command of PM_CORE_COMMAND_NAMES) {\n    if (CROSS_COMMAND_FLAG_EXCLUSIONS.has(command)) {\n      continue;\n    }\n    for (const flag of collectKnownLongFlags(command)) {\n      const commands = index.get(flag) ?? [];\n      commands.push(command);\n      index.set(flag, commands);\n    }\n  }\n  crossCommandFlagIndexCache = index;\n  return crossCommandFlagIndexCache;\n}\n\nfunction findOtherCommandsForFlag(unknownOption: string, currentCommand: string | undefined): string[] {\n  if (!unknownOption.startsWith(\"--\")) {\n    return [];\n  }\n  const commands = getCrossCommandFlagIndex().get(normalizeLongFlag(unknownOption));\n  if (!commands) {\n    return [];\n  }\n  const normalizedCurrent = currentCommand?.trim().toLowerCase();\n  return commands.filter((command) => command !== normalizedCurrent).slice(0, 3);\n}\n\nfunction rewriteUnknownOptionArgv(argv: string[], unknownOption: string, replacementFlag: string): string[] | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (!token.startsWith(\"--\")) {\n      continue;\n    }\n    const equalsIndex = token.indexOf(\"=\");\n    const key = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;\n    if (normalizeLongFlag(key) !== normalizeLongFlag(unknownOption)) {\n      continue;\n    }\n    const next = [...argv];\n    next[index] = equalsIndex >= 0 ? `${replacementFlag}${token.slice(equalsIndex)}` : replacementFlag;\n    return next;\n  }\n  return undefined;\n}\n\nexport function buildUnknownCommandGuidanceFromRuntime(\n  rawMessage: string,\n  root: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): CommanderGuidanceContext | undefined {\n  const unknownCommandMatch = rawMessage.match(/unknown command '([^']+)'/i);\n  if (!unknownCommandMatch || typeof unknownCommandMatch[1] !== \"string\") {\n    return undefined;\n  }\n  const normalizedUnknown = normalizeHelpCommandPath(unknownCommandMatch[1]);\n  if (normalizedUnknown.length === 0) {\n    return undefined;\n  }\n  const commandPaths = collectRuntimeCommandPaths(root, extensionDescriptors);\n  if (commandPaths.length === 0) {\n    return undefined;\n  }\n\n  const primaryToken = normalizedUnknown.split(\" \")[0] ?? normalizedUnknown;\n  const rankedCandidates = commandPaths\n    .map((commandPath) => {\n      const directScore = scoreCommandPathMatch(commandPath, normalizedUnknown);\n      const fallbackScore =\n        primaryToken !== normalizedUnknown ? scoreCommandPathMatch(commandPath, primaryToken) : Number.POSITIVE_INFINITY;\n      const score = Math.min(directScore, fallbackScore);\n      return { commandPath, score };\n    })\n    .filter((entry) => Number.isFinite(entry.score))\n    .sort((left, right) => {\n      if (left.score !== right.score) {\n        return left.score - right.score;\n      }\n      return left.commandPath.localeCompare(right.commandPath);\n    })\n    .map((entry) => entry.commandPath);\n\n  const aliasCandidates = (COMMON_COMMAND_ALIASES[primaryToken] ?? []).filter((aliasPath) =>\n    commandPaths.includes(aliasPath),\n  );\n  const combinedCandidates = dedupeStrings([...aliasCandidates, ...rankedCandidates]);\n\n  const fallbackTopLevel = [...new Set(commandPaths.map((commandPath) => commandPath.split(\" \")[0]).filter((segment) => segment.length > 0))];\n  fallbackTopLevel.sort((left, right) => left.localeCompare(right));\n  const suggestedPaths = (combinedCandidates.length > 0 ? combinedCandidates : fallbackTopLevel).slice(0, 3);\n  const examples = [...new Set([\"pm --help\", ...suggestedPaths.map((path) => `pm ${path} --help`)])];\n  const optionalPackageHint = resolveOptionalPackageInstallHint(normalizedUnknown);\n  const didYouMean = combinedCandidates.length > 0 ? `Did you mean: ${combinedCandidates.slice(0, 3).join(\", \")}?` : null;\n\n  return {\n    unknownCommandExamples: examples,\n    unknownCommandNextSteps: [\n      ...(didYouMean ? [didYouMean] : []),\n      'Run \"pm --help\" to list commands available in this runtime, including active extensions.',\n      \"Use one of the suggested command paths above with --help to inspect valid flags and usage.\",\n      ...(optionalPackageHint ? [optionalPackageHint] : []),\n    ],\n  };\n}\n\nfunction dedupeStrings(values: string[]): string[] {\n  return Array.from(new Set(values));\n}\n\nexport function resolveChildCommandByToken(parent: Command, token: string): Command | undefined {\n  const normalizedToken = token.trim().toLowerCase();\n  return parent.commands.find((candidate) => {\n    if (candidate.name().trim().toLowerCase() === normalizedToken) {\n      return true;\n    }\n    const aliases = typeof candidate.aliases === \"function\" ? candidate.aliases() : [];\n    return aliases.some((alias) => alias.trim().toLowerCase() === normalizedToken);\n  });\n}\n\nexport function isKnownHelpCommandPath(root: Command, commandPathTokens: string[]): boolean {\n  if (commandPathTokens.length === 0) {\n    return true;\n  }\n  let current = root;\n  let matchedAny = false;\n  for (const token of commandPathTokens) {\n    const next = resolveChildCommandByToken(current, token);\n    if (!next) {\n      return matchedAny;\n    }\n    matchedAny = true;\n    current = next;\n  }\n  return matchedAny;\n}\n\nexport async function resolveCommanderUsageContext(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<CommanderUsageContext> {\n  const rawMessage = typeof error === \"object\" && error !== null ? (error as { message?: string }).message : undefined;\n  const message = rawMessage ?? \"Invalid command usage\";\n  const invocationArgv = normalizeBootstrapInvocation(process.argv.slice(2)).argv;\n  const bootstrapGlobal = parseBootstrapGlobalOptions(invocationArgv);\n  const commandName = parseBootstrapCommandName(invocationArgv);\n  const attemptedCommand = renderAttemptedCommand(invocationArgv);\n  const providedOptionFlags = extractProvidedOptionFlags(invocationArgv);\n  let allowedTypes = BUILTIN_TYPE_HELP_VALUES;\n  try {\n    const pmRoot = resolvePmRoot(process.cwd(), bootstrapGlobal.path);\n    if (await pathExists(getSettingsPath(pmRoot))) {\n      const settings = await readSettings(pmRoot);\n      const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n      if (typeRegistry.types.length > 0) {\n        allowedTypes = typeRegistry.types.join(\"|\");\n      }\n    }\n  } catch {\n    // Fall back to built-in type guidance when settings cannot be read.\n  }\n  const unknownCommandGuidance = buildUnknownCommandGuidanceFromRuntime(message, rootProgram, extensionDescriptors);\n  const unknownOptionMatch = message.match(/unknown option '([^']+)'/i);\n  const unknownOptionSuggestions =\n    unknownOptionMatch && commandName\n      ? dedupeStrings([\n          ...getSemanticUnknownOptionSuggestions(commandName, unknownOptionMatch[1]),\n          ...suggestNearestLongFlags(unknownOptionMatch[1], collectKnownLongFlags(commandName)),\n        ])\n      : undefined;\n  const unknownOptionOtherCommands = unknownOptionMatch\n    ? findOtherCommandsForFlag(unknownOptionMatch[1], commandName)\n    : [];\n  let suggestedRetryCommand: string | undefined;\n  if (unknownOptionMatch && unknownOptionSuggestions && unknownOptionSuggestions.length > 0) {\n    const rewritten = rewriteUnknownOptionArgv(invocationArgv, unknownOptionMatch[1], unknownOptionSuggestions[0]);\n    if (rewritten) {\n      suggestedRetryCommand = renderAttemptedCommand(rewritten);\n    }\n  }\n  if (!suggestedRetryCommand) {\n    const missingRequiredOption = message.match(/required option '([^']+)' not specified/i);\n    const requiredOptionToken = missingRequiredOption?.[1]?.trim().split(/\\s+/)[0]?.replace(/[,:;]+$/g, \"\");\n    if (requiredOptionToken?.startsWith(\"--\")) {\n      const hasFlag = invocationArgv.some((token) => token.startsWith(requiredOptionToken));\n      if (!hasFlag) {\n        suggestedRetryCommand = renderAttemptedCommand([...invocationArgv, requiredOptionToken, \"<value>\"]);\n      }\n    }\n  }\n  return {\n    message,\n    commandName,\n    allowedTypes,\n    attemptedCommand,\n    normalizedInvocationArgs: [...invocationArgv],\n    providedOptionFlags,\n    unknownOptionSuggestions,\n    unknownOptionOtherCommands: unknownOptionOtherCommands.length > 0 ? unknownOptionOtherCommands : undefined,\n    suggestedRetryCommand,\n    ...(unknownCommandGuidance ?? {}),\n  };\n}\n\nexport async function formatCommanderUsageMessage(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<string> {\n  const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors);\n  const {\n    message,\n    commandName,\n    allowedTypes,\n    unknownCommandExamples,\n    unknownCommandNextSteps,\n    attemptedCommand,\n    normalizedInvocationArgs,\n    providedOptionFlags,\n    unknownOptionSuggestions,\n    unknownOptionOtherCommands,\n    suggestedRetryCommand,\n  } = usageContext;\n  const formatted = formatCommanderErrorForDisplay(message, commandName, allowedTypes, {\n    unknownCommandExamples,\n    unknownCommandNextSteps,\n    attemptedCommand,\n    normalizedInvocationArgs,\n    providedOptionFlags,\n    unknownOptionSuggestions,\n    unknownOptionOtherCommands,\n    suggestedRetryCommand,\n  });\n  const serviceOverride = await runActiveServiceOverride(\"help_format\", {\n    message: formatted,\n    command: commandName,\n    allowed_types: allowedTypes,\n  });\n  if (serviceOverride.handled && typeof serviceOverride.result === \"string\") {\n    return serviceOverride.result;\n  }\n  return formatted;\n}\n\nexport async function formatCommanderUsageJson(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<string> {\n  const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors);\n  const envelope = formatCommanderErrorForJson(\n    usageContext.message,\n    usageContext.commandName,\n    usageContext.allowedTypes,\n    EXIT_CODE.USAGE,\n    {\n      unknownCommandExamples: usageContext.unknownCommandExamples,\n      unknownCommandNextSteps: usageContext.unknownCommandNextSteps,\n      attemptedCommand: usageContext.attemptedCommand,\n      normalizedInvocationArgs: usageContext.normalizedInvocationArgs,\n      providedOptionFlags: usageContext.providedOptionFlags,\n      unknownOptionSuggestions: usageContext.unknownOptionSuggestions,\n      unknownOptionOtherCommands: usageContext.unknownOptionOtherCommands,\n      suggestedRetryCommand: usageContext.suggestedRetryCommand,\n    },\n  );\n  return JSON.stringify(envelope, null, 2);\n}\n"],"names":[],"mappings":"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","debugId":"b54efed6-c3b0-5b4d-9912-588c58198fba"}
+{"version":3,"file":"commander-usage.js","sources":["cli/commander-usage.ts"],"sourceRoot":"/","sourcesContent":["import { Command } from \"commander\";\nimport { pathExists } from \"../core/fs/fs-utils.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport { BUILTIN_ITEM_TYPE_VALUES } from \"../types/index.js\";\nimport {\n  getActiveExtensionRegistrations,\n  runActiveServiceOverride,\n} from \"../core/extensions/index.js\";\nimport { PM_CORE_COMMAND_NAMES, resolveSubcommandFlagContractsForCommand } from \"../sdk/cli-contracts.js\";\nimport {\n  type CommanderGuidanceContext,\n  formatCommanderErrorForDisplay,\n  formatCommanderErrorForJson,\n} from \"./error-guidance.js\";\nimport { normalizeHelpCommandPath } from \"./help-content.js\";\nimport { getCommandPath } from \"./registration-helpers.js\";\nimport {\n  normalizeBootstrapInvocation,\n  parseBootstrapGlobalOptions,\n  parseBootstrapCommandName,\n} from \"./bootstrap-args.js\";\nimport {\n  extractProvidedOptionFlags,\n  normalizeLongFlag,\n  renderPmCommand,\n} from \"./argv-utils.js\";\nimport { levenshteinDistanceWithinLimit } from \"../core/shared/levenshtein.js\";\nimport type { ExtensionCommandHelpDescriptor } from \"./extension-command-help.js\";\nimport { normalizeExtensionNameForMatch } from \"./commands/extension/shared.js\";\n\nexport const BUILTIN_TYPE_HELP_VALUES = BUILTIN_ITEM_TYPE_VALUES.join(\"|\");\n\nconst OPTIONAL_PACKAGE_INSTALL_HINTS: Record<string, string> = {\n  calendar: \"calendar\",\n  cal: \"calendar\",\n  reindex: \"search-advanced\",\n  \"search-advanced\": \"search-advanced\",\n  \"dedupe-audit\": \"governance-audit\",\n  \"comments-audit\": \"governance-audit\",\n  normalize: \"governance-audit\",\n  guide: \"guide-shell\",\n  completion: \"guide-shell\",\n  templates: \"templates\",\n  \"test-runs\": \"linked-test-adapters\",\n  beads: \"beads\",\n  todos: \"todos\",\n};\n\nconst COMMON_COMMAND_ALIASES: Record<string, string[]> = {\n  comment: [\"comments\"],\n  note: [\"notes\"],\n  learning: [\"learnings\"],\n  show: [\"get\"],\n};\n\nconst SEMANTIC_UNKNOWN_OPTION_SUGGESTIONS: Record<string, Record<string, string[]>> = {\n  comments: {\n    \"--body\": [\"--add\"],\n    \"--text\": [\"--add\"],\n    \"--comment\": [\"--add\"],\n  },\n  notes: {\n    \"--body\": [\"--add\"],\n    \"--text\": [\"--add\"],\n    \"--note\": [\"--add\"],\n  },\n  learnings: {\n    \"--body\": [\"--add\"],\n    \"--text\": [\"--add\"],\n    \"--learning\": [\"--add\"],\n  },\n  // pm update / pm create now accept --add-tags natively, so the singular\n  // --add-tag and the old \"--tag\" mistype still need to be redirected at the\n  // canonical additive flag (not at --tags, which would silently replace).\n  update: {\n    \"--add-tag\": [\"--add-tags\"],\n    \"--remove-tag\": [\"--remove-tags\"],\n    \"--tag\": [\"--tags\"],\n  },\n  create: {\n    \"--add-tag\": [\"--add-tags\"],\n    \"--tag\": [\"--tags\"],\n  },\n};\n\nfunction getSemanticUnknownOptionSuggestions(commandName: string, unknownOption: string): string[] {\n  const commandSuggestions = SEMANTIC_UNKNOWN_OPTION_SUGGESTIONS[commandName];\n  if (!commandSuggestions) {\n    return [];\n  }\n  const normalizedUnknown = normalizeLongFlag(unknownOption);\n  for (const [flag, suggestions] of Object.entries(commandSuggestions)) {\n    if (normalizeLongFlag(flag) === normalizedUnknown) {\n      return suggestions;\n    }\n  }\n  return [];\n}\n\nexport interface CommanderUsageContext extends CommanderGuidanceContext {\n  message: string;\n  commandName: string | undefined;\n  allowedTypes: string;\n}\n\nexport function collectRuntimeCommandPaths(\n  root: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): string[] {\n  const commandPaths = new Set<string>();\n  const queue: Command[] = [...root.commands];\n  while (queue.length > 0) {\n    const current = queue.shift();\n    if (!current) {\n      continue;\n    }\n    const normalizedPath = normalizeHelpCommandPath(getCommandPath(current));\n    const hasInternalSegment = normalizedPath.split(\" \").some((segment) => segment.startsWith(\"_\"));\n    if (normalizedPath.length > 0 && !hasInternalSegment) {\n      commandPaths.add(normalizedPath);\n    }\n    queue.push(...current.commands);\n  }\n  for (const descriptorPath of extensionDescriptors.keys()) {\n    const normalizedPath = normalizeHelpCommandPath(descriptorPath);\n    const hasInternalSegment = normalizedPath.split(\" \").some((segment) => segment.startsWith(\"_\"));\n    if (normalizedPath.length > 0 && !hasInternalSegment) {\n      commandPaths.add(normalizedPath);\n    }\n  }\n  return [...commandPaths].sort((left, right) => left.localeCompare(right));\n}\n\nexport function scoreCommandPathMatch(commandPath: string, queryToken: string): number {\n  const normalizedPath = commandPath.trim().toLowerCase();\n  const normalizedToken = queryToken.trim().toLowerCase();\n  if (normalizedToken.length === 0) {\n    return Number.POSITIVE_INFINITY;\n  }\n  const pathSegments = normalizedPath.split(\" \");\n  if (normalizedPath === normalizedToken) {\n    return 0;\n  }\n  if (pathSegments.includes(normalizedToken)) {\n    return 1;\n  }\n  if (pathSegments.some((segment) => segment.startsWith(normalizedToken))) {\n    return 2;\n  }\n  if (normalizedPath.includes(normalizedToken)) {\n    return 3;\n  }\n  // Fall back to edit distance so transposition/typo cases (e.g. \"lst\" -> \"list\") still rank.\n  const maxDistance = normalizedToken.length >= 5 ? 2 : 1;\n  let bestDistance = Number.POSITIVE_INFINITY;\n  for (const segment of pathSegments) {\n    const distance = levenshteinDistanceWithinLimit(segment, normalizedToken, maxDistance);\n    if (distance !== null) {\n      bestDistance = Math.min(bestDistance, distance);\n    }\n  }\n  if (Number.isFinite(bestDistance)) {\n    return 4 + bestDistance;\n  }\n  return Number.POSITIVE_INFINITY;\n}\n\nfunction toComparableFlag(flag: string): string {\n  return normalizeLongFlag(flag).slice(2).replace(/-/g, \"\");\n}\n\nfunction renderAttemptedCommand(argv: string[]): string {\n  return renderPmCommand(argv);\n}\n\nfunction resolveOptionalPackageInstallHint(commandPath: string): string | null {\n  const topLevel = commandPath.split(\" \")[0]?.trim().toLowerCase();\n  if (!topLevel) {\n    return null;\n  }\n  const packageAlias = OPTIONAL_PACKAGE_INSTALL_HINTS[topLevel];\n  if (!packageAlias) {\n    return null;\n  }\n  return `If this command comes from an optional package, install it with: pm install ${packageAlias}`;\n}\n\nfunction normalizePackageCommandAliasToken(value: string): string {\n  let normalized = normalizeExtensionNameForMatch(value);\n  // Strip outer package/source prefixes and then the pm- package stem so scoped\n  // and builtin package guesses converge on the exported command alias.\n  for (const prefix of [\"@unbraind/\", \"@unbrained/\", \"builtin-\", \"pm-\"]) {\n    if (normalized.startsWith(prefix)) {\n      normalized = normalized.slice(prefix.length);\n    }\n  }\n  return normalized;\n}\n\nfunction collectInstalledPackageCommandPathHints(\n  unknownToken: string,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): string[] {\n  const normalizedUnknown = normalizePackageCommandAliasToken(unknownToken);\n  if (normalizedUnknown.length === 0) {\n    return [];\n  }\n  const hints: string[] = [];\n  for (const descriptor of extensionDescriptors.values()) {\n    const identifiers = new Set<string>();\n    const source = descriptor.source;\n    if (source) {\n      for (const identifier of [source.name, source.package]) {\n        const normalizedIdentifier = normalizePackageCommandAliasToken(identifier ?? \"\");\n        if (normalizedIdentifier.length > 0) {\n          identifiers.add(normalizedIdentifier);\n        }\n      }\n    }\n    if (identifiers.size === 0) {\n      continue;\n    }\n    const matches = [...identifiers].some(\n      (identifier) =>\n        identifier === normalizedUnknown ||\n        identifier.includes(normalizedUnknown) ||\n        normalizedUnknown.includes(identifier),\n    );\n    if (matches) {\n      hints.push(descriptor.command);\n    }\n  }\n  return [...new Set(hints)].sort((left, right) => left.localeCompare(right));\n}\n\nfunction collectKnownLongFlags(commandName: string | undefined): string[] {\n  const flags = new Set<string>();\n  const contracts = resolveSubcommandFlagContractsForCommand(commandName);\n  for (const contract of contracts) {\n    if (contract.flag.startsWith(\"--\")) {\n      flags.add(normalizeLongFlag(contract.flag));\n    }\n    for (const alias of contract.aliases ?? []) {\n      if (alias.startsWith(\"--\")) {\n        flags.add(normalizeLongFlag(alias));\n      }\n    }\n  }\n  return [...flags].sort((left, right) => left.localeCompare(right));\n}\n\nfunction suggestNearestLongFlags(unknownOption: string, knownFlags: string[]): string[] {\n  if (!unknownOption.startsWith(\"--\")) {\n    return [];\n  }\n  const unknownComparable = toComparableFlag(unknownOption);\n  if (unknownComparable.length === 0) {\n    return [];\n  }\n  const maxDistance = unknownComparable.length >= 8 ? 2 : 1;\n  // rank 0 = abbreviation/prefix match (e.g. --desc -> --description), rank 1 = edit-distance typo.\n  const candidates: Array<{ flag: string; rank: number; distance: number }> = [];\n  for (const flag of knownFlags) {\n    const flagComparable = toComparableFlag(flag);\n    if (flagComparable === unknownComparable) {\n      continue;\n    }\n    if (unknownComparable.length >= 3 && flagComparable.startsWith(unknownComparable)) {\n      candidates.push({ flag, rank: 0, distance: flagComparable.length - unknownComparable.length });\n      continue;\n    }\n    const distance = levenshteinDistanceWithinLimit(unknownComparable, flagComparable, maxDistance);\n    if (distance === null || distance <= 0) {\n      continue;\n    }\n    candidates.push({ flag, rank: 1, distance });\n  }\n  return candidates\n    .sort((left, right) => {\n      if (left.rank !== right.rank) {\n        return left.rank - right.rank;\n      }\n      if (left.distance !== right.distance) {\n        return left.distance - right.distance;\n      }\n      return left.flag.localeCompare(right.flag);\n    })\n    .map((entry) => entry.flag)\n    .slice(0, 3);\n}\n\nlet crossCommandFlagIndexCache: Map<string, string[]> | undefined;\n\n// Alias/shortcut command names that duplicate a canonical command. Excluding them\n// keeps cross-command flag hints focused on the primary commands an agent should use.\nconst CROSS_COMMAND_FLAG_EXCLUSIONS = new Set<string>([\n  \"ctx\",\n  \"packages\",\n  \"list-draft\",\n  \"list-open\",\n  \"list-in-progress\",\n  \"list-blocked\",\n  \"list-closed\",\n  \"list-canceled\",\n  \"start-task\",\n  \"pause-task\",\n  \"close-task\",\n  \"help\",\n]);\n\n// Index of long flag -> command names that accept it (in declaration order), so an\n// unknown flag on one command can be recognised as valid elsewhere (e.g. --type is\n// rejected on test-all but valid on create/list). Built once from core command contracts.\nfunction getCrossCommandFlagIndex(): Map<string, string[]> {\n  if (crossCommandFlagIndexCache) {\n    return crossCommandFlagIndexCache;\n  }\n  const index = new Map<string, string[]>();\n  for (const command of PM_CORE_COMMAND_NAMES) {\n    if (CROSS_COMMAND_FLAG_EXCLUSIONS.has(command)) {\n      continue;\n    }\n    for (const flag of collectKnownLongFlags(command)) {\n      const commands = index.get(flag) ?? [];\n      commands.push(command);\n      index.set(flag, commands);\n    }\n  }\n  crossCommandFlagIndexCache = index;\n  return crossCommandFlagIndexCache;\n}\n\nfunction findOtherCommandsForFlag(unknownOption: string, currentCommand: string | undefined): string[] {\n  if (!unknownOption.startsWith(\"--\")) {\n    return [];\n  }\n  const commands = getCrossCommandFlagIndex().get(normalizeLongFlag(unknownOption));\n  if (!commands) {\n    return [];\n  }\n  const normalizedCurrent = currentCommand?.trim().toLowerCase();\n  return commands.filter((command) => command !== normalizedCurrent).slice(0, 3);\n}\n\nfunction rewriteUnknownOptionArgv(argv: string[], unknownOption: string, replacementFlag: string): string[] | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (!token.startsWith(\"--\")) {\n      continue;\n    }\n    const equalsIndex = token.indexOf(\"=\");\n    const key = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;\n    if (normalizeLongFlag(key) !== normalizeLongFlag(unknownOption)) {\n      continue;\n    }\n    const next = [...argv];\n    next[index] = equalsIndex >= 0 ? `${replacementFlag}${token.slice(equalsIndex)}` : replacementFlag;\n    return next;\n  }\n  return undefined;\n}\n\nexport function buildUnknownCommandGuidanceFromRuntime(\n  rawMessage: string,\n  root: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): CommanderGuidanceContext | undefined {\n  const unknownCommandMatch = rawMessage.match(/unknown command '([^']+)'/i);\n  if (!unknownCommandMatch || typeof unknownCommandMatch[1] !== \"string\") {\n    return undefined;\n  }\n  const normalizedUnknown = normalizeHelpCommandPath(unknownCommandMatch[1]);\n  if (normalizedUnknown.length === 0) {\n    return undefined;\n  }\n  const commandPaths = collectRuntimeCommandPaths(root, extensionDescriptors);\n  if (commandPaths.length === 0) {\n    return undefined;\n  }\n\n  const primaryToken = normalizedUnknown.split(\" \")[0] ?? normalizedUnknown;\n  const rankedCandidates = commandPaths\n    .map((commandPath) => {\n      const directScore = scoreCommandPathMatch(commandPath, normalizedUnknown);\n      const fallbackScore =\n        primaryToken !== normalizedUnknown ? scoreCommandPathMatch(commandPath, primaryToken) : Number.POSITIVE_INFINITY;\n      const score = Math.min(directScore, fallbackScore);\n      return { commandPath, score };\n    })\n    .filter((entry) => Number.isFinite(entry.score))\n    .sort((left, right) => {\n      if (left.score !== right.score) {\n        return left.score - right.score;\n      }\n      return left.commandPath.localeCompare(right.commandPath);\n    })\n    .map((entry) => entry.commandPath);\n\n  const aliasCandidates = (COMMON_COMMAND_ALIASES[primaryToken] ?? []).filter((aliasPath) =>\n    commandPaths.includes(aliasPath),\n  );\n  const installedPackageCandidates = collectInstalledPackageCommandPathHints(primaryToken, extensionDescriptors).filter((commandPath) =>\n    commandPaths.includes(commandPath),\n  );\n  const combinedCandidates = dedupeStrings([...aliasCandidates, ...rankedCandidates, ...installedPackageCandidates]);\n\n  const fallbackTopLevel = [...new Set(commandPaths.map((commandPath) => commandPath.split(\" \")[0]).filter((segment) => segment.length > 0))];\n  fallbackTopLevel.sort((left, right) => left.localeCompare(right));\n  const suggestedPaths = (combinedCandidates.length > 0 ? combinedCandidates : fallbackTopLevel).slice(0, 3);\n  const examples = [...new Set([\"pm --help\", ...suggestedPaths.map((path) => `pm ${path} --help`)])];\n  const optionalPackageHint = resolveOptionalPackageInstallHint(normalizedUnknown);\n  const didYouMean = combinedCandidates.length > 0 ? `Did you mean: ${combinedCandidates.slice(0, 3).join(\", \")}?` : null;\n\n  return {\n    unknownCommandExamples: examples,\n    unknownCommandNextSteps: [\n      ...(didYouMean ? [didYouMean] : []),\n      'Run \"pm --help\" to list commands available in this runtime, including active extensions.',\n      \"Use one of the suggested command paths above with --help to inspect valid flags and usage.\",\n      ...(optionalPackageHint ? [optionalPackageHint] : []),\n    ],\n  };\n}\n\nfunction dedupeStrings(values: string[]): string[] {\n  return Array.from(new Set(values));\n}\n\nfunction firstWhitespaceSeparatedToken(input: string): string {\n  let token = \"\";\n  for (const character of input) {\n    if (\n      character === \" \" ||\n      character === \"\\t\" ||\n      character === \"\\n\" ||\n      character === \"\\r\" ||\n      character === \"\\f\" ||\n      character === \"\\v\"\n    ) {\n      break;\n    }\n    token += character;\n  }\n  return token;\n}\n\nfunction trimTrailingPunctuationToken(token: string): string {\n  let end = token.length;\n  while (end > 0) {\n    const character = token[end - 1];\n    if (character !== \",\" && character !== \":\" && character !== \";\") {\n      break;\n    }\n    end -= 1;\n  }\n  return token.slice(0, end);\n}\n\nexport function resolveChildCommandByToken(parent: Command, token: string): Command | undefined {\n  const normalizedToken = token.trim().toLowerCase();\n  return parent.commands.find((candidate) => {\n    if (candidate.name().trim().toLowerCase() === normalizedToken) {\n      return true;\n    }\n    const aliases = typeof candidate.aliases === \"function\" ? candidate.aliases() : [];\n    return aliases.some((alias) => alias.trim().toLowerCase() === normalizedToken);\n  });\n}\n\nexport function isKnownHelpCommandPath(root: Command, commandPathTokens: string[]): boolean {\n  if (commandPathTokens.length === 0) {\n    return true;\n  }\n  let current = root;\n  let matchedAny = false;\n  for (const token of commandPathTokens) {\n    const next = resolveChildCommandByToken(current, token);\n    if (!next) {\n      return matchedAny;\n    }\n    matchedAny = true;\n    current = next;\n  }\n  return matchedAny;\n}\n\nexport async function resolveCommanderUsageContext(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<CommanderUsageContext> {\n  const rawMessage = typeof error === \"object\" && error !== null ? (error as { message?: string }).message : undefined;\n  const message = rawMessage ?? \"Invalid command usage\";\n  const invocationArgv = normalizeBootstrapInvocation(process.argv.slice(2)).argv;\n  const bootstrapGlobal = parseBootstrapGlobalOptions(invocationArgv);\n  const commandName = parseBootstrapCommandName(invocationArgv);\n  const attemptedCommand = renderAttemptedCommand(invocationArgv);\n  const providedOptionFlags = extractProvidedOptionFlags(invocationArgv);\n  let allowedTypes = BUILTIN_TYPE_HELP_VALUES;\n  try {\n    const pmRoot = resolvePmRoot(process.cwd(), bootstrapGlobal.path);\n    if (await pathExists(getSettingsPath(pmRoot))) {\n      const settings = await readSettings(pmRoot);\n      const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n      if (typeRegistry.types.length > 0) {\n        allowedTypes = typeRegistry.types.join(\"|\");\n      }\n    }\n  } catch {\n    // Fall back to built-in type guidance when settings cannot be read.\n  }\n  const unknownCommandGuidance = buildUnknownCommandGuidanceFromRuntime(message, rootProgram, extensionDescriptors);\n  const unknownOptionMatch = message.match(/unknown option '([^']+)'/i);\n  const unknownOptionSuggestions =\n    unknownOptionMatch && commandName\n      ? dedupeStrings([\n          ...getSemanticUnknownOptionSuggestions(commandName, unknownOptionMatch[1]),\n          ...suggestNearestLongFlags(unknownOptionMatch[1], collectKnownLongFlags(commandName)),\n        ])\n      : undefined;\n  const unknownOptionOtherCommands = unknownOptionMatch\n    ? findOtherCommandsForFlag(unknownOptionMatch[1], commandName)\n    : [];\n  let suggestedRetryCommand: string | undefined;\n  if (unknownOptionMatch && unknownOptionSuggestions && unknownOptionSuggestions.length > 0) {\n    const rewritten = rewriteUnknownOptionArgv(invocationArgv, unknownOptionMatch[1], unknownOptionSuggestions[0]);\n    if (rewritten) {\n      suggestedRetryCommand = renderAttemptedCommand(rewritten);\n    }\n  }\n  if (!suggestedRetryCommand) {\n    const missingRequiredOption = message.match(/required option '([^']+)' not specified/i);\n    const requiredOptionToken = missingRequiredOption?.[1]\n      ? trimTrailingPunctuationToken(firstWhitespaceSeparatedToken(missingRequiredOption[1].trim()))\n      : undefined;\n    if (requiredOptionToken?.startsWith(\"--\")) {\n      const hasFlag = invocationArgv.some((token) => token.startsWith(requiredOptionToken));\n      if (!hasFlag) {\n        suggestedRetryCommand = renderAttemptedCommand([...invocationArgv, requiredOptionToken, \"<value>\"]);\n      }\n    }\n  }\n  return {\n    message,\n    commandName,\n    allowedTypes,\n    attemptedCommand,\n    normalizedInvocationArgs: [...invocationArgv],\n    providedOptionFlags,\n    unknownOptionSuggestions,\n    unknownOptionOtherCommands: unknownOptionOtherCommands.length > 0 ? unknownOptionOtherCommands : undefined,\n    suggestedRetryCommand,\n    ...(unknownCommandGuidance ?? {}),\n  };\n}\n\nexport async function formatCommanderUsageMessage(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<string> {\n  const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors);\n  const {\n    message,\n    commandName,\n    allowedTypes,\n    unknownCommandExamples,\n    unknownCommandNextSteps,\n    attemptedCommand,\n    normalizedInvocationArgs,\n    providedOptionFlags,\n    unknownOptionSuggestions,\n    unknownOptionOtherCommands,\n    suggestedRetryCommand,\n  } = usageContext;\n  const formatted = formatCommanderErrorForDisplay(message, commandName, allowedTypes, {\n    unknownCommandExamples,\n    unknownCommandNextSteps,\n    attemptedCommand,\n    normalizedInvocationArgs,\n    providedOptionFlags,\n    unknownOptionSuggestions,\n    unknownOptionOtherCommands,\n    suggestedRetryCommand,\n  });\n  const serviceOverride = await runActiveServiceOverride(\"help_format\", {\n    message: formatted,\n    command: commandName,\n    allowed_types: allowedTypes,\n  });\n  if (serviceOverride.handled && typeof serviceOverride.result === \"string\") {\n    return serviceOverride.result;\n  }\n  return formatted;\n}\n\nexport async function formatCommanderUsageJson(\n  error: unknown,\n  rootProgram: Command,\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<string> {\n  const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors);\n  const envelope = formatCommanderErrorForJson(\n    usageContext.message,\n    usageContext.commandName,\n    usageContext.allowedTypes,\n    EXIT_CODE.USAGE,\n    {\n      unknownCommandExamples: usageContext.unknownCommandExamples,\n      unknownCommandNextSteps: usageContext.unknownCommandNextSteps,\n      attemptedCommand: usageContext.attemptedCommand,\n      normalizedInvocationArgs: usageContext.normalizedInvocationArgs,\n      providedOptionFlags: usageContext.providedOptionFlags,\n      unknownOptionSuggestions: usageContext.unknownOptionSuggestions,\n      unknownOptionOtherCommands: usageContext.unknownOptionOtherCommands,\n      suggestedRetryCommand: usageContext.suggestedRetryCommand,\n    },\n  );\n  return JSON.stringify(envelope, null, 2);\n}\n"],"names":[],"mappings":"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","debugId":"591ae949-391a-5ede-8e92-15df7e3264df"}

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

@@ -6,6 +6,8 @@ type AggregateGroupRecord = Partial<Record<AggregateGroupField, AggregateGroupVa
 export interface AggregateOptions {
     groupBy?: string;
     count?: boolean;
+    sum?: string;
+    avg?: string;
     includeUnparented?: boolean;
     status?: string;
     type?: string;
@@ -22,6 +24,9 @@ export interface AggregateOptions {
 export interface AggregateRow {
     group: AggregateGroupRecord;
     count: number;
+    null_count?: number;
+    sum?: number | null;
+    avg?: number | null;
 }
 export interface AggregateResult {
     groups: AggregateRow[];
@@ -34,6 +39,9 @@ export interface AggregateResult {
     filters: {
         group_by: AggregateGroupField[];
         count: boolean;
+        sum?: string | null;
+        avg?: string | null;
+        numeric_field?: string | null;
         include_unparented: boolean;
         status: ItemStatus | null;
         type: string | null;

package/dist/cli/commands/aggregate.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0c8f06f7-0f97-5ae3-ab61-12c1a053d751")}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]="5718f2e5-0007-5359-81bd-71998b031aa5")}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";
@@ -29,6 +29,23 @@ function parseStatus(raw, statusRegistry) {
     }
     return normalized;
 }
+function parseNumericAggregation(options) {
+    const sumField = options.sum?.trim();
+    const avgField = options.avg?.trim();
+    const normalizedSum = sumField && sumField.length > 0 ? sumField : undefined;
+    const normalizedAvg = avgField && avgField.length > 0 ? avgField : undefined;
+    if (!normalizedSum && !normalizedAvg) {
+        return null;
+    }
+    if (normalizedSum && normalizedAvg && normalizedSum !== normalizedAvg) {
+        throw new PmCliError("Aggregate --sum and --avg must target the same numeric field", EXIT_CODE.USAGE);
+    }
+    return {
+        field: normalizedSum ?? normalizedAvg ?? "",
+        sum: normalizedSum !== undefined,
+        avg: normalizedAvg !== undefined,
+    };
+}
 function parseGroupBy(raw) {
     const value = raw?.trim() ?? "status";
     if (value.length === 0) {
@@ -103,15 +120,34 @@ function compareAggregateRows(left, right, groupBy) {
     }
     return 0;
 }
+function readNumericAggregateValue(item, field) {
+    const source = item;
+    const raw = source[field];
+    if (typeof raw === "number" && Number.isFinite(raw)) {
+        return raw;
+    }
+    if (typeof raw === "string") {
+        const trimmed = raw.trim();
+        if (trimmed.length === 0) {
+            return null;
+        }
+        const parsed = Number(trimmed);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return null;
+}
 export async function runAggregate(options, global) {
     if (options.count === false) {
-        throw new PmCliError("Aggregate currently supports grouped counts only. Pass --count.", EXIT_CODE.USAGE);
+        throw new PmCliError("Aggregate grouped counts are always enabled; omit count=false.", EXIT_CODE.USAGE);
     }
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     const settings = await readSettings(pmRoot);
     const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
     const groupBy = parseGroupBy(options.groupBy);
     const status = parseStatus(options.status, statusRegistry);
+    const numericAggregation = parseNumericAggregation(options);
     const includeUnparented = options.includeUnparented === true;
     const listed = await runList(status, {
         type: options.type,
@@ -140,18 +176,52 @@ export async function runAggregate(options, global) {
         }
         const key = buildGroupKey(groupBy, group);
         const existing = grouped.get(key);
+        const numericValue = numericAggregation === null
+            ? null
+            : readNumericAggregateValue(item, numericAggregation.field);
         if (existing) {
-            existing.count += 1;
+            existing.row.count += 1;
+            if (numericAggregation !== null) {
+                if (numericValue === null) {
+                    existing.null_count += 1;
+                }
+                else {
+                    existing.numeric_count += 1;
+                    existing.numeric_sum += numericValue;
+                }
+            }
         }
         else {
             grouped.set(key, {
-                group,
-                count: 1,
+                row: {
+                    group,
+                    count: 1,
+                },
+                numeric_count: numericValue === null ? 0 : 1,
+                numeric_sum: numericValue ?? 0,
+                null_count: numericValue === null ? 1 : 0,
             });
         }
         groupedItemCount += 1;
     }
-    const groups = [...grouped.values()].sort((left, right) => compareAggregateRows(left, right, groupBy));
+    const groups = [...grouped.values()]
+        .map((entry) => {
+        if (numericAggregation === null) {
+            return entry.row;
+        }
+        const withNumeric = {
+            ...entry.row,
+            null_count: entry.null_count,
+        };
+        if (numericAggregation.sum) {
+            withNumeric.sum = entry.numeric_sum;
+        }
+        if (numericAggregation.avg) {
+            withNumeric.avg = entry.numeric_count === 0 ? null : entry.numeric_sum / entry.numeric_count;
+        }
+        return withNumeric;
+    })
+        .sort((left, right) => compareAggregateRows(left, right, groupBy));
     const warnings = listed.warnings && listed.warnings.length > 0 ? listed.warnings : undefined;
     return {
         groups,
@@ -176,10 +246,17 @@ export async function runAggregate(options, global) {
             parent: options.parent ?? null,
             sprint: options.sprint ?? null,
             release: options.release ?? null,
+            ...(numericAggregation !== null
+                ? {
+                    sum: options.sum ?? null,
+                    avg: options.avg ?? null,
+                    numeric_field: numericAggregation.field,
+                }
+                : {}),
         },
         now: nowIso(),
         ...(warnings ? { warnings } : {}),
     };
 }
 //# sourceMappingURL=aggregate.js.map
-//# debugId=0c8f06f7-0f97-5ae3-ab61-12c1a053d751
+//# debugId=5718f2e5-0007-5359-81bd-71998b031aa5