@unbrained/pm-cli 2026.5.24 → 2026.5.28

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]="c8215895-2ec4-5d78-97b1-42fc20757af7")}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]="afd2b2c1-6cc9-56db-974f-643acbaf2784")}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";
@@ -7,7 +7,7 @@ import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
 import { BUILTIN_ITEM_TYPE_VALUES } from "../types/index.js";
 import { getActiveExtensionRegistrations, runActiveServiceOverride, } from "../core/extensions/index.js";
-import { resolveSubcommandFlagContractsForCommand } from "../sdk/cli-contracts.js";
+import { PM_CORE_COMMAND_NAMES, resolveSubcommandFlagContractsForCommand } from "../sdk/cli-contracts.js";
 import { formatCommanderErrorForDisplay, formatCommanderErrorForJson, } from "./error-guidance.js";
 import { normalizeHelpCommandPath } from "./help-content.js";
 import { getCommandPath } from "./registration-helpers.js";
@@ -30,6 +30,54 @@ const OPTIONAL_PACKAGE_INSTALL_HINTS = {
     beads: "beads",
     todos: "todos",
 };
+const COMMON_COMMAND_ALIASES = {
+    comment: ["comments"],
+    note: ["notes"],
+    learning: ["learnings"],
+    show: ["get"],
+};
+const SEMANTIC_UNKNOWN_OPTION_SUGGESTIONS = {
+    comments: {
+        "--body": ["--add"],
+        "--text": ["--add"],
+        "--comment": ["--add"],
+    },
+    notes: {
+        "--body": ["--add"],
+        "--text": ["--add"],
+        "--note": ["--add"],
+    },
+    learnings: {
+        "--body": ["--add"],
+        "--text": ["--add"],
+        "--learning": ["--add"],
+    },
+    // Tag mutations are single --tags flags; agents transferring additive tag verbs
+    // ("--add-tag(s)") from other tools should be pointed at the canonical flag.
+    update: {
+        "--add-tags": ["--tags"],
+        "--add-tag": ["--tags"],
+        "--tag": ["--tags"],
+    },
+    create: {
+        "--add-tags": ["--tags"],
+        "--add-tag": ["--tags"],
+        "--tag": ["--tags"],
+    },
+};
+function getSemanticUnknownOptionSuggestions(commandName, unknownOption) {
+    const commandSuggestions = SEMANTIC_UNKNOWN_OPTION_SUGGESTIONS[commandName];
+    if (!commandSuggestions) {
+        return [];
+    }
+    const normalizedUnknown = normalizeLongFlag(unknownOption);
+    for (const [flag, suggestions] of Object.entries(commandSuggestions)) {
+        if (normalizeLongFlag(flag) === normalizedUnknown) {
+            return suggestions;
+        }
+    }
+    return [];
+}
 export function collectRuntimeCommandPaths(root, extensionDescriptors) {
     const commandPaths = new Set();
     const queue = [...root.commands];
@@ -124,20 +172,32 @@ function suggestNearestLongFlags(unknownOption, knownFlags) {
         return [];
     }
     const unknownComparable = toComparableFlag(unknownOption);
+    if (unknownComparable.length === 0) {
+        return [];
+    }
     const maxDistance = unknownComparable.length >= 8 ? 2 : 1;
+    // rank 0 = abbreviation/prefix match (e.g. --desc -> --description), rank 1 = edit-distance typo.
     const candidates = [];
     for (const flag of knownFlags) {
-        const distance = levenshteinDistanceWithinLimit(unknownComparable, toComparableFlag(flag), maxDistance);
-        if (distance === null) {
+        const flagComparable = toComparableFlag(flag);
+        if (flagComparable === unknownComparable) {
+            continue;
+        }
+        if (unknownComparable.length >= 3 && flagComparable.startsWith(unknownComparable)) {
+            candidates.push({ flag, rank: 0, distance: flagComparable.length - unknownComparable.length });
             continue;
         }
-        if (distance <= 0) {
+        const distance = levenshteinDistanceWithinLimit(unknownComparable, flagComparable, maxDistance);
+        if (distance === null || distance <= 0) {
             continue;
         }
-        candidates.push({ flag, distance });
+        candidates.push({ flag, rank: 1, distance });
     }
     return candidates
         .sort((left, right) => {
+        if (left.rank !== right.rank) {
+            return left.rank - right.rank;
+        }
         if (left.distance !== right.distance) {
             return left.distance - right.distance;
         }
@@ -146,6 +206,55 @@ function suggestNearestLongFlags(unknownOption, knownFlags) {
         .map((entry) => entry.flag)
         .slice(0, 3);
 }
+let crossCommandFlagIndexCache;
+// Alias/shortcut command names that duplicate a canonical command. Excluding them
+// keeps cross-command flag hints focused on the primary commands an agent should use.
+const CROSS_COMMAND_FLAG_EXCLUSIONS = new Set([
+    "ctx",
+    "packages",
+    "list-draft",
+    "list-open",
+    "list-in-progress",
+    "list-blocked",
+    "list-closed",
+    "list-canceled",
+    "start-task",
+    "pause-task",
+    "close-task",
+    "help",
+]);
+// Index of long flag -> command names that accept it (in declaration order), so an
+// unknown flag on one command can be recognised as valid elsewhere (e.g. --type is
+// rejected on test-all but valid on create/list). Built once from core command contracts.
+function getCrossCommandFlagIndex() {
+    if (crossCommandFlagIndexCache) {
+        return crossCommandFlagIndexCache;
+    }
+    const index = new Map();
+    for (const command of PM_CORE_COMMAND_NAMES) {
+        if (CROSS_COMMAND_FLAG_EXCLUSIONS.has(command)) {
+            continue;
+        }
+        for (const flag of collectKnownLongFlags(command)) {
+            const commands = index.get(flag) ?? [];
+            commands.push(command);
+            index.set(flag, commands);
+        }
+    }
+    crossCommandFlagIndexCache = index;
+    return crossCommandFlagIndexCache;
+}
+function findOtherCommandsForFlag(unknownOption, currentCommand) {
+    if (!unknownOption.startsWith("--")) {
+        return [];
+    }
+    const commands = getCrossCommandFlagIndex().get(normalizeLongFlag(unknownOption));
+    if (!commands) {
+        return [];
+    }
+    const normalizedCurrent = currentCommand?.trim().toLowerCase();
+    return commands.filter((command) => command !== normalizedCurrent).slice(0, 3);
+}
 function rewriteUnknownOptionArgv(argv, unknownOption, replacementFlag) {
     for (let index = 0; index < argv.length; index += 1) {
         const token = argv[index];
@@ -192,12 +301,14 @@ export function buildUnknownCommandGuidanceFromRuntime(rawMessage, root, extensi
         return left.commandPath.localeCompare(right.commandPath);
     })
         .map((entry) => entry.commandPath);
+    const aliasCandidates = (COMMON_COMMAND_ALIASES[primaryToken] ?? []).filter((aliasPath) => commandPaths.includes(aliasPath));
+    const combinedCandidates = dedupeStrings([...aliasCandidates, ...rankedCandidates]);
     const fallbackTopLevel = [...new Set(commandPaths.map((commandPath) => commandPath.split(" ")[0]).filter((segment) => segment.length > 0))];
     fallbackTopLevel.sort((left, right) => left.localeCompare(right));
-    const suggestedPaths = (rankedCandidates.length > 0 ? rankedCandidates : fallbackTopLevel).slice(0, 3);
+    const suggestedPaths = (combinedCandidates.length > 0 ? combinedCandidates : fallbackTopLevel).slice(0, 3);
     const examples = [...new Set(["pm --help", ...suggestedPaths.map((path) => `pm ${path} --help`)])];
     const optionalPackageHint = resolveOptionalPackageInstallHint(normalizedUnknown);
-    const didYouMean = rankedCandidates.length > 0 ? `Did you mean: ${rankedCandidates.slice(0, 3).join(", ")}?` : null;
+    const didYouMean = combinedCandidates.length > 0 ? `Did you mean: ${combinedCandidates.slice(0, 3).join(", ")}?` : null;
     return {
         unknownCommandExamples: examples,
         unknownCommandNextSteps: [
@@ -208,6 +319,9 @@ export function buildUnknownCommandGuidanceFromRuntime(rawMessage, root, extensi
         ],
     };
 }
+function dedupeStrings(values) {
+    return Array.from(new Set(values));
+}
 export function resolveChildCommandByToken(parent, token) {
     const normalizedToken = token.trim().toLowerCase();
     return parent.commands.find((candidate) => {
@@ -259,8 +373,14 @@ export async function resolveCommanderUsageContext(error, rootProgram, extension
     const unknownCommandGuidance = buildUnknownCommandGuidanceFromRuntime(message, rootProgram, extensionDescriptors);
     const unknownOptionMatch = message.match(/unknown option '([^']+)'/i);
     const unknownOptionSuggestions = unknownOptionMatch && commandName
-        ? suggestNearestLongFlags(unknownOptionMatch[1], collectKnownLongFlags(commandName))
+        ? dedupeStrings([
+            ...getSemanticUnknownOptionSuggestions(commandName, unknownOptionMatch[1]),
+            ...suggestNearestLongFlags(unknownOptionMatch[1], collectKnownLongFlags(commandName)),
+        ])
         : undefined;
+    const unknownOptionOtherCommands = unknownOptionMatch
+        ? findOtherCommandsForFlag(unknownOptionMatch[1], commandName)
+        : [];
     let suggestedRetryCommand;
     if (unknownOptionMatch && unknownOptionSuggestions && unknownOptionSuggestions.length > 0) {
         const rewritten = rewriteUnknownOptionArgv(invocationArgv, unknownOptionMatch[1], unknownOptionSuggestions[0]);
@@ -286,13 +406,14 @@ export async function resolveCommanderUsageContext(error, rootProgram, extension
         normalizedInvocationArgs: [...invocationArgv],
         providedOptionFlags,
         unknownOptionSuggestions,
+        unknownOptionOtherCommands: unknownOptionOtherCommands.length > 0 ? unknownOptionOtherCommands : undefined,
         suggestedRetryCommand,
         ...(unknownCommandGuidance ?? {}),
     };
 }
 export async function formatCommanderUsageMessage(error, rootProgram, extensionDescriptors) {
     const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors);
-    const { message, commandName, allowedTypes, unknownCommandExamples, unknownCommandNextSteps, attemptedCommand, normalizedInvocationArgs, providedOptionFlags, unknownOptionSuggestions, suggestedRetryCommand, } = usageContext;
+    const { message, commandName, allowedTypes, unknownCommandExamples, unknownCommandNextSteps, attemptedCommand, normalizedInvocationArgs, providedOptionFlags, unknownOptionSuggestions, unknownOptionOtherCommands, suggestedRetryCommand, } = usageContext;
     const formatted = formatCommanderErrorForDisplay(message, commandName, allowedTypes, {
         unknownCommandExamples,
         unknownCommandNextSteps,
@@ -300,6 +421,7 @@ export async function formatCommanderUsageMessage(error, rootProgram, extensionD
         normalizedInvocationArgs,
         providedOptionFlags,
         unknownOptionSuggestions,
+        unknownOptionOtherCommands,
         suggestedRetryCommand,
     });
     const serviceOverride = await runActiveServiceOverride("help_format", {
@@ -321,9 +443,10 @@ export async function formatCommanderUsageJson(error, rootProgram, extensionDesc
         normalizedInvocationArgs: usageContext.normalizedInvocationArgs,
         providedOptionFlags: usageContext.providedOptionFlags,
         unknownOptionSuggestions: usageContext.unknownOptionSuggestions,
+        unknownOptionOtherCommands: usageContext.unknownOptionOtherCommands,
         suggestedRetryCommand: usageContext.suggestedRetryCommand,
     });
     return JSON.stringify(envelope, null, 2);
 }
 //# sourceMappingURL=commander-usage.js.map
-//# debugId=c8215895-2ec4-5d78-97b1-42fc20757af7
+//# debugId=afd2b2c1-6cc9-56db-974f-643acbaf2784

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 { 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\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  const maxDistance = unknownComparable.length >= 8 ? 2 : 1;\n  const candidates: Array<{ flag: string; distance: number }> = [];\n  for (const flag of knownFlags) {\n    const distance = levenshteinDistanceWithinLimit(unknownComparable, toComparableFlag(flag), maxDistance);\n    if (distance === null) {\n      continue;\n    }\n    if (distance <= 0) {\n      continue;\n    }\n    candidates.push({ flag, distance });\n  }\n  return candidates\n    .sort((left, right) => {\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\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 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 = (rankedCandidates.length > 0 ? rankedCandidates : 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 = rankedCandidates.length > 0 ? `Did you mean: ${rankedCandidates.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\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      ? suggestNearestLongFlags(unknownOptionMatch[1], collectKnownLongFlags(commandName))\n      : undefined;\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    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    suggestedRetryCommand,\n  } = usageContext;\n  const formatted = formatCommanderErrorForDisplay(message, commandName, allowedTypes, {\n    unknownCommandExamples,\n    unknownCommandNextSteps,\n    attemptedCommand,\n    normalizedInvocationArgs,\n    providedOptionFlags,\n    unknownOptionSuggestions,\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      suggestedRetryCommand: usageContext.suggestedRetryCommand,\n    },\n  );\n  return JSON.stringify(envelope, null, 2);\n}\n"],"names":[],"mappings":"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","debugId":"c8215895-2ec4-5d78-97b1-42fc20757af7"}
+{"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  // Tag mutations are single --tags flags; agents transferring additive tag verbs\n  // (\"--add-tag(s)\") from other tools should be pointed at the canonical flag.\n  update: {\n    \"--add-tags\": [\"--tags\"],\n    \"--add-tag\": [\"--tags\"],\n    \"--tag\": [\"--tags\"],\n  },\n  create: {\n    \"--add-tags\": [\"--tags\"],\n    \"--add-tag\": [\"--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":"afd2b2c1-6cc9-56db-974f-643acbaf2784"}

package/dist/cli/commands/append.js

@@ -1,9 +1,10 @@
 
-!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]="1320d28a-e9cf-584d-95d1-640b1c128e60")}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]="14238d29-d4c8-5988-afde-c4d3b52c450d")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { resolveAuthor } from "../../core/shared/author.js";
+import { toItemRecord } from "../../core/item/item-record.js";
 import { createStdinTokenResolver } from "../../core/item/parse.js";
 import { mutateItem } from "../../core/store/item-store.js";
 import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
@@ -39,10 +40,10 @@ export async function runAppend(id, options, global) {
         },
     });
     return {
-        item: result.item,
+        item: toItemRecord(result.item),
         appended: appended.length > 0 ? appended : "",
         changed_fields: result.changedFields,
     };
 }
 //# sourceMappingURL=append.js.map
-//# debugId=1320d28a-e9cf-584d-95d1-640b1c128e60
+//# debugId=14238d29-d4c8-5988-afde-c4d3b52c450d

package/dist/cli/commands/append.js.map

@@ -1 +1 @@
-{"version":3,"file":"append.js","sources":["cli/commands/append.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.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 { resolveAuthor } from \"../../core/shared/author.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nexport interface AppendCommandOptions {\n  body: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\nexport interface AppendResult {\n  item: Record<string, unknown>;\n  appended: string;\n  changed_fields: string[];\n}\n\n\nexport async function runAppend(id: string, options: AppendCommandOptions, global: GlobalOptions): Promise<AppendResult> {\n  if (options.body === undefined) {\n    throw new PmCliError(\"Missing required --body text\", EXIT_CODE.USAGE);\n  }\n  const stdinResolver = createStdinTokenResolver();\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  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  const bodyInput = await stdinResolver.resolveValue(options.body, \"--body\");\n  const appended = (bodyInput ?? \"\").trim();\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"append\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      if (appended.length === 0) {\n        return { changedFields: [] };\n      }\n      const spacer = document.body.trim().length > 0 ? \"\\n\\n\" : \"\";\n      document.body = `${document.body.replace(/\\s+$/, \"\")}${spacer}${appended}\\n`;\n      return { changedFields: [\"body\"] };\n    },\n  });\n\n  return {\n    item: result.item as unknown as Record<string, unknown>,\n    appended: appended.length > 0 ? appended : \"\",\n    changed_fields: result.changedFields,\n  };\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAgB5D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAU,EAAE,OAA6B,EAAE,MAAqB;IAC9F,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,UAAU,CAAC,8BAA8B,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,aAAa,GAAG,wBAAwB,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,iCAAiC,MAAM,sBAAsB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,MAAM;QACN,QAAQ;QACR,EAAE;QACF,EAAE,EAAE,QAAQ;QACZ,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,CAAC,QAAQ;YACb,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;YAC/B,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ,IAAI,CAAC;YAC7E,OAAO,EAAE,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAA0C;QACvD,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC7C,cAAc,EAAE,MAAM,CAAC,aAAa;KACrC,CAAC;AACJ,CAAC","debugId":"1320d28a-e9cf-584d-95d1-640b1c128e60"}
+{"version":3,"file":"append.js","sources":["cli/commands/append.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.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 { resolveAuthor } from \"../../core/shared/author.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nexport interface AppendCommandOptions {\n  body: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\nexport interface AppendResult {\n  item: Record<string, unknown>;\n  appended: string;\n  changed_fields: string[];\n}\n\n\nexport async function runAppend(id: string, options: AppendCommandOptions, global: GlobalOptions): Promise<AppendResult> {\n  if (options.body === undefined) {\n    throw new PmCliError(\"Missing required --body text\", EXIT_CODE.USAGE);\n  }\n  const stdinResolver = createStdinTokenResolver();\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  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  const bodyInput = await stdinResolver.resolveValue(options.body, \"--body\");\n  const appended = (bodyInput ?? \"\").trim();\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"append\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      if (appended.length === 0) {\n        return { changedFields: [] };\n      }\n      const spacer = document.body.trim().length > 0 ? \"\\n\\n\" : \"\";\n      document.body = `${document.body.replace(/\\s+$/, \"\")}${spacer}${appended}\\n`;\n      return { changedFields: [\"body\"] };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    appended: appended.length > 0 ? appended : \"\",\n    changed_fields: result.changedFields,\n  };\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAgB5D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAU,EAAE,OAA6B,EAAE,MAAqB;IAC9F,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,UAAU,CAAC,8BAA8B,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,aAAa,GAAG,wBAAwB,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,iCAAiC,MAAM,sBAAsB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,MAAM;QACN,QAAQ;QACR,EAAE;QACF,EAAE,EAAE,QAAQ;QACZ,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,CAAC,QAAQ;YACb,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;YAC/B,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ,IAAI,CAAC;YAC7E,OAAO,EAAE,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC7C,cAAc,EAAE,MAAM,CAAC,aAAa;KACrC,CAAC;AACJ,CAAC","debugId":"14238d29-d4c8-5988-afde-c4d3b52c450d"}

package/dist/cli/commands/claim.js

@@ -1,9 +1,10 @@
 
-!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]="bd1366d9-d8b2-5ddf-baa5-65bc25210b91")}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]="c54bf8e8-7777-5980-8f16-e6df0c5bb53f")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { resolveRuntimeStatusRegistry, statusIsTerminal } from "../../core/schema/runtime-schema.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
+import { toItemRecord } from "../../core/item/item-record.js";
 import { mutateItem } from "../../core/store/item-store.js";
 import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
@@ -47,7 +48,7 @@ export async function runClaim(id, force, global, options = {}) {
         },
     });
     return {
-        item: result.item,
+        item: toItemRecord(result.item),
         claimed_by: skipped && previousAssignee !== null ? previousAssignee : author,
         previous_assignee: previousAssignee,
         forced: force,
@@ -95,7 +96,7 @@ export async function runRelease(id, force, global, options = {}) {
         });
     }
     return {
-        item: result.item,
+        item: toItemRecord(result.item),
         released_by: author,
         previous_assignee: previousAssignee,
         audit_release: options.allowAuditRelease === true,
@@ -103,4 +104,4 @@ export async function runRelease(id, force, global, options = {}) {
     };
 }
 //# sourceMappingURL=claim.js.map
-//# debugId=bd1366d9-d8b2-5ddf-baa5-65bc25210b91
+//# debugId=c54bf8e8-7777-5980-8f16-e6df0c5bb53f

package/dist/cli/commands/claim.js.map

@@ -1 +1 @@
-{"version":3,"file":"claim.js","sources":["cli/commands/claim.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { resolveRuntimeStatusRegistry, statusIsTerminal } from \"../../core/schema/runtime-schema.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 { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { wrapOwnershipConflict } from \"./annotation-command.js\";\n\nexport interface ClaimResult {\n  item: Record<string, unknown>;\n  claimed_by: string;\n  previous_assignee: string | null;\n  forced: boolean;\n  skipped?: boolean;\n  warnings?: string[];\n}\n\nexport interface ReleaseResult {\n  item: Record<string, unknown>;\n  released_by: string;\n  previous_assignee: string | null;\n  audit_release: boolean;\n  forced: boolean;\n}\n\nexport interface ClaimMutationOptions {\n  author?: string;\n  message?: string;\n  ifAvailable?: boolean;\n}\n\nexport interface ReleaseMutationOptions extends ClaimMutationOptions {\n  allowAuditRelease?: boolean;\n}\n\nexport async function runClaim(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions = {},\n): Promise<ClaimResult> {\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  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n  let skipped = false;\n  const mutationWarnings: string[] = [];\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"claim\",\n    author,\n    message: options.message,\n    force,\n    mutate(document) {\n      previousAssignee = document.metadata.assignee ?? null;\n      if (statusIsTerminal(document.metadata.status, statusRegistry) && !force) {\n        throw new PmCliError(`Cannot claim terminal item ${document.metadata.id} without --force`, EXIT_CODE.CONFLICT);\n      }\n      const heldByOther = previousAssignee !== null && previousAssignee !== author;\n      if (heldByOther && options.ifAvailable === true) {\n        skipped = true;\n        mutationWarnings.push(`claim_skipped_held_by:${previousAssignee}`);\n        return { changedFields: [] };\n      }\n      if (heldByOther) {\n        mutationWarnings.push(`claim_takeover:${previousAssignee}->${author}`);\n      }\n      document.metadata.assignee = author;\n      return { changedFields: [\"assignee\"], warnings: mutationWarnings };\n    },\n  });\n\n  return {\n    item: result.item as unknown as Record<string, unknown>,\n    claimed_by: skipped && previousAssignee !== null ? previousAssignee : author,\n    previous_assignee: previousAssignee,\n    forced: force,\n    ...(skipped ? { skipped: true } : {}),\n    ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n  };\n}\n\nexport async function runRelease(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ReleaseMutationOptions = {},\n): Promise<ReleaseResult> {\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  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: \"release\",\n      author,\n      message: options.message,\n      force,\n      bypassAssigneeConflict: Boolean(options.allowAuditRelease),\n      mutate(document) {\n        previousAssignee = document.metadata.assignee ?? null;\n        if (!previousAssignee) {\n          return { changedFields: [] };\n        }\n        delete document.metadata.assignee;\n        return { changedFields: [\"assignee\"] };\n      },\n    });\n  } catch (error: unknown) {\n    wrapOwnershipConflict(error, {\n      required: \"For audited non-owner handoffs, prefer --allow-audit-release before considering --force.\",\n      examples: ['pm release pm-a1b2 --author \"reviewer\" --allow-audit-release'],\n      nextSteps: [\n        \"Use --allow-audit-release for append-only release handoffs that only clear assignee metadata.\",\n        \"Use --force only when an explicit override is approved for broader ownership conflicts.\",\n      ],\n    });\n  }\n\n  return {\n    item: result.item as unknown as Record<string, unknown>,\n    released_by: author,\n    previous_assignee: previousAssignee,\n    audit_release: options.allowAuditRelease === true,\n    forced: force,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"bd1366d9-d8b2-5ddf-baa5-65bc25210b91"}
+{"version":3,"file":"claim.js","sources":["cli/commands/claim.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { resolveRuntimeStatusRegistry, statusIsTerminal } from \"../../core/schema/runtime-schema.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 { toItemRecord } from \"../../core/item/item-record.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { wrapOwnershipConflict } from \"./annotation-command.js\";\n\nexport interface ClaimResult {\n  item: Record<string, unknown>;\n  claimed_by: string;\n  previous_assignee: string | null;\n  forced: boolean;\n  skipped?: boolean;\n  warnings?: string[];\n}\n\nexport interface ReleaseResult {\n  item: Record<string, unknown>;\n  released_by: string;\n  previous_assignee: string | null;\n  audit_release: boolean;\n  forced: boolean;\n}\n\nexport interface ClaimMutationOptions {\n  author?: string;\n  message?: string;\n  ifAvailable?: boolean;\n}\n\nexport interface ReleaseMutationOptions extends ClaimMutationOptions {\n  allowAuditRelease?: boolean;\n}\n\nexport async function runClaim(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions = {},\n): Promise<ClaimResult> {\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  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n  let skipped = false;\n  const mutationWarnings: string[] = [];\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"claim\",\n    author,\n    message: options.message,\n    force,\n    mutate(document) {\n      previousAssignee = document.metadata.assignee ?? null;\n      if (statusIsTerminal(document.metadata.status, statusRegistry) && !force) {\n        throw new PmCliError(`Cannot claim terminal item ${document.metadata.id} without --force`, EXIT_CODE.CONFLICT);\n      }\n      const heldByOther = previousAssignee !== null && previousAssignee !== author;\n      if (heldByOther && options.ifAvailable === true) {\n        skipped = true;\n        mutationWarnings.push(`claim_skipped_held_by:${previousAssignee}`);\n        return { changedFields: [] };\n      }\n      if (heldByOther) {\n        mutationWarnings.push(`claim_takeover:${previousAssignee}->${author}`);\n      }\n      document.metadata.assignee = author;\n      return { changedFields: [\"assignee\"], warnings: mutationWarnings };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    claimed_by: skipped && previousAssignee !== null ? previousAssignee : author,\n    previous_assignee: previousAssignee,\n    forced: force,\n    ...(skipped ? { skipped: true } : {}),\n    ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n  };\n}\n\nexport async function runRelease(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ReleaseMutationOptions = {},\n): Promise<ReleaseResult> {\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  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: \"release\",\n      author,\n      message: options.message,\n      force,\n      bypassAssigneeConflict: Boolean(options.allowAuditRelease),\n      mutate(document) {\n        previousAssignee = document.metadata.assignee ?? null;\n        if (!previousAssignee) {\n          return { changedFields: [] };\n        }\n        delete document.metadata.assignee;\n        return { changedFields: [\"assignee\"] };\n      },\n    });\n  } catch (error: unknown) {\n    wrapOwnershipConflict(error, {\n      required: \"For audited non-owner handoffs, prefer --allow-audit-release before considering --force.\",\n      examples: ['pm release pm-a1b2 --author \"reviewer\" --allow-audit-release'],\n      nextSteps: [\n        \"Use --allow-audit-release for append-only release handoffs that only clear assignee metadata.\",\n        \"Use --force only when an explicit override is approved for broader ownership conflicts.\",\n      ],\n    });\n  }\n\n  return {\n    item: toItemRecord(result.item),\n    released_by: author,\n    previous_assignee: previousAssignee,\n    audit_release: options.allowAuditRelease === true,\n    forced: force,\n  };\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACrG,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AA6BhE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,EAAU,EACV,KAAc,EACd,MAAqB,EACrB,UAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,iCAAiC,MAAM,sBAAsB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,4BAA4B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtE,IAAI,gBAAgB,GAAkB,IAAI,CAAC;IAC3C,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,gBAAgB,GAAa,EAAE,CAAC;IAEtC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,MAAM;QACN,QAAQ;QACR,EAAE;QACF,EAAE,EAAE,OAAO;QACX,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK;QACL,MAAM,CAAC,QAAQ;YACb,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC;YACtD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACzE,MAAM,IAAI,UAAU,CAAC,8BAA8B,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;YACjH,CAAC;YACD,MAAM,WAAW,GAAG,gBAAgB,KAAK,IAAI,IAAI,gBAAgB,KAAK,MAAM,CAAC;YAC7E,IAAI,WAAW,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBAChD,OAAO,GAAG,IAAI,CAAC;gBACf,gBAAgB,CAAC,IAAI,CAAC,yBAAyB,gBAAgB,EAAE,CAAC,CAAC;gBACnE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;YAC/B,CAAC;YACD,IAAI,WAAW,EAAE,CAAC;gBAChB,gBAAgB,CAAC,IAAI,CAAC,kBAAkB,gBAAgB,KAAK,MAAM,EAAE,CAAC,CAAC;YACzE,CAAC;YACD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAAC;YACpC,OAAO,EAAE,aAAa,EAAE,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;QACrE,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,UAAU,EAAE,OAAO,IAAI,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM;QAC5E,iBAAiB,EAAE,gBAAgB;QACnC,MAAM,EAAE,KAAK;QACb,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAU,EACV,KAAc,EACd,MAAqB,EACrB,UAAkC,EAAE;IAEpC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,iCAAiC,MAAM,sBAAsB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtE,IAAI,gBAAgB,GAAkB,IAAI,CAAC;IAE3C,IAAI,MAA8C,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,UAAU,CAAC;YACxB,MAAM;YACN,QAAQ;YACR,EAAE;YACF,EAAE,EAAE,SAAS;YACb,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK;YACL,sBAAsB,EAAE,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC;YAC1D,MAAM,CAAC,QAAQ;gBACb,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC;gBACtD,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACtB,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;gBAC/B,CAAC;gBACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAClC,OAAO,EAAE,aAAa,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;YACzC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,qBAAqB,CAAC,KAAK,EAAE;YAC3B,QAAQ,EAAE,0FAA0F;YACpG,QAAQ,EAAE,CAAC,8DAA8D,CAAC;YAC1E,SAAS,EAAE;gBACT,+FAA+F;gBAC/F,yFAAyF;aAC1F;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,WAAW,EAAE,MAAM;QACnB,iBAAiB,EAAE,gBAAgB;QACnC,aAAa,EAAE,OAAO,CAAC,iBAAiB,KAAK,IAAI;QACjD,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC","debugId":"c54bf8e8-7777-5980-8f16-e6df0c5bb53f"}

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

@@ -4,6 +4,9 @@ export interface CloseCommandOptions {
     message?: string;
     validateClose?: string;
     force?: boolean;
+    resolution?: string;
+    expectedResult?: string;
+    actualResult?: string;
 }
 export interface CloseResult {
     item: Record<string, unknown>;

package/dist/cli/commands/close.js

@@ -1,6 +1,7 @@
 
-!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]="d8ef4de6-1572-562a-90e1-421793927d09")}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]="610305d5-0069-57e6-aea6-0e9973eac456")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
+import { toItemRecord } from "../../core/item/item-record.js";
 import { isTerminalStatus } from "../../core/item/status.js";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
 import { resolveRuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
@@ -87,6 +88,23 @@ export async function runClose(id, closeReasonText, options, global) {
                 throw new PmCliError(`Item ${document.metadata.id} is already terminal; use --force to close again.`, EXIT_CODE.CONFLICT);
             }
             const mutationWarnings = [];
+            // pm-fl0c #11: apply inline closure fields BEFORE the validation pass so
+            // a single `pm close <id> "reason" --resolution "..."` call satisfies
+            // strict validation without a prior pm update. Only meaningful trimmed
+            // text writes; an empty/whitespace value is a no-op rather than a clear.
+            const inlineCloseFields = [
+                { option: options.resolution, key: "resolution" },
+                { option: options.expectedResult, key: "expected_result" },
+                { option: options.actualResult, key: "actual_result" },
+            ];
+            for (const { option, key } of inlineCloseFields) {
+                if (typeof option !== "string")
+                    continue;
+                const trimmed = option.trim();
+                if (trimmed.length === 0)
+                    continue;
+                document.metadata[key] = trimmed;
+            }
             if (validateCloseMode !== "off") {
                 const missingFields = findMissingCloseValidationFields(document.metadata);
                 if (missingFields.length > 0) {
@@ -110,6 +128,11 @@ export async function runClose(id, closeReasonText, options, global) {
             document.metadata.status = statusRegistry.close_status;
             document.metadata.close_reason = closeReason;
             const changedFields = ["status", "close_reason"];
+            for (const { option, key } of inlineCloseFields) {
+                if (typeof option === "string" && option.trim().length > 0) {
+                    changedFields.push(key);
+                }
+            }
             if (document.metadata.assignee !== undefined) {
                 delete document.metadata.assignee;
                 changedFields.push("assignee");
@@ -153,10 +176,10 @@ export async function runClose(id, closeReasonText, options, global) {
         },
     });
     return {
-        item: result.item,
+        item: toItemRecord(result.item),
         changed_fields: result.changedFields,
         warnings: result.warnings,
     };
 }
 //# sourceMappingURL=close.js.map
-//# debugId=d8ef4de6-1572-562a-90e1-421793927d09
+//# debugId=610305d5-0069-57e6-aea6-0e9973eac456