@unbrained/pm-cli 2026.6.19 → 2026.6.20

package/dist/cli-bundle/main.js

@@ -5,13 +5,13 @@ import {
   emitTelemetryErrorEvent,
   finishTelemetryCommand,
   startTelemetryCommand
-} from "./chunks/chunk-QG6M6XQE.js";
+} from "./chunks/chunk-J7VSEFWB.js";
 import {
   migrateItemFilesToFormat
-} from "./chunks/chunk-II3WDRCM.js";
+} from "./chunks/chunk-HWHZ7EY7.js";
 import {
   normalizeExtensionNameForMatch
-} from "./chunks/chunk-TYQBGXH2.js";
+} from "./chunks/chunk-DKWIPIJY.js";
 import {
   applyDefaultOutputFormat,
   clearResolvedGlobalOptions,
@@ -21,27 +21,27 @@ import {
   getGlobalOptions,
   invalidateSearchCachesForMutation,
   setResolvedGlobalOptions
-} from "./chunks/chunk-5LZPDRFW.js";
+} from "./chunks/chunk-NMQNXH4U.js";
 import {
   PM_CORE_COMMAND_NAMES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunks/chunk-FPQA4ZMA.js";
-import "./chunks/chunk-NNMBNN6Q.js";
+} from "./chunks/chunk-VONJSFUW.js";
+import "./chunks/chunk-ETJKPURB.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunks/chunk-AVMSP2HH.js";
-import "./chunks/chunk-X7RKOJXL.js";
-import "./chunks/chunk-5NS6TJ2F.js";
-import "./chunks/chunk-QSH34DSQ.js";
+} from "./chunks/chunk-3KVCMB2M.js";
+import "./chunks/chunk-SL233DQD.js";
+import "./chunks/chunk-ZHCSGIUX.js";
+import "./chunks/chunk-5MWA46UN.js";
 import {
   commandOptionFlagLabel,
   resolveCommandOptionPolicyState,
   resolveItemTypeRegistry,
   resolveTypeDefinition
-} from "./chunks/chunk-SO2IOH37.js";
-import "./chunks/chunk-MTGMNUMJ.js";
+} from "./chunks/chunk-XNQ3YH6N.js";
+import "./chunks/chunk-B3LROPTV.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -85,7 +85,7 @@ import {
   setActiveExtensionServices,
   toNonEmptyStringOrUndefined,
   writeSettings
-} from "./chunks/chunk-5QLHQK7V.js";
+} from "./chunks/chunk-QWAJPGEI.js";
 
 // dist/cli/main.js
 import { Command } from "commander";
@@ -186,7 +186,7 @@ async function maybeRunFirstUseTelemetryPrompt(commandPath, globalOptions) {
 !(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] = "13959131-284f-5362-a0f7-a641171d6157");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "1e5dec43-11a5-5a85-b2ab-e9a7d10fa478");
   } catch (e2) {
   }
 })();
@@ -340,6 +340,17 @@ function resolveEnvironment() {
     return "ci";
   return "production";
 }
+var DEFAULT_TRACES_SAMPLE_RATE = 0.2;
+function resolveTracesSampleRate() {
+  const raw = process.env.SENTRY_TRACES_SAMPLE_RATE?.trim();
+  if (!raw)
+    return DEFAULT_TRACES_SAMPLE_RATE;
+  const parsed = Number(raw);
+  if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
+    return DEFAULT_TRACES_SAMPLE_RATE;
+  }
+  return parsed;
+}
 async function ensureSentryInit() {
   if (_initDone)
     return _sentry;
@@ -354,7 +365,7 @@ async function ensureSentryInit() {
     dsn,
     release: `pm-cli@${release}`,
     environment: resolveEnvironment(),
-    tracesSampleRate: 0.2,
+    tracesSampleRate: resolveTracesSampleRate(),
     enableLogs: true,
     attachStacktrace: true,
     normalizeDepth: 6,
@@ -655,7 +666,7 @@ async function sentryFlush(timeoutMs = 3e3) {
 !(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] = "c4ce211f-4bb8-5139-be69-6d8eb9dbdbff");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "006c671c-d2fc-5908-8431-08bc7e418184");
   } catch (e2) {
   }
 })();
@@ -941,6 +952,24 @@ function parseLooseCommandOptions(args) {
   }
   return options;
 }
+function collectLoosePositionalArgs(args) {
+  const positionals = [];
+  let index = 0;
+  while (index < args.length) {
+    if (args[index] === "--") {
+      positionals.push(...args.slice(index + 1));
+      break;
+    }
+    const parsed = parseLooseOptionToken(args, index);
+    if (parsed) {
+      index += Math.max(1, parsed.consumed);
+      continue;
+    }
+    positionals.push(args[index]);
+    index += 1;
+  }
+  return positionals;
+}
 function stripLooseCommandOptionTokens(args, definitions) {
   if (definitions.length === 0) {
     return [...args];
@@ -986,7 +1015,7 @@ function stripLooseCommandOptionTokens(args, definitions) {
 !(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] = "6d5d5ea9-2621-585b-8444-df5d061ee2ae");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "7cb003ad-0fb8-5d62-a218-0635cd48e994");
   } catch (e2) {
   }
 })();
@@ -1440,6 +1469,19 @@ var HELP_BY_COMMAND_PATH = {
       "Use --include-linked when linked docs/files/tests should influence scoring."
     ]
   },
+  eval: {
+    why: "Measures search relevance against a curated golden-query set so retrieval regressions are caught, not guessed.",
+    examples: [
+      "pm eval --json",
+      "pm eval --mode hybrid --k 10",
+      "pm eval --fail-under 0.6 --json",
+      "pm eval --queries ./my-eval.json --mode semantic"
+    ],
+    tips: [
+      "Curate ground truth in <pmRoot>/search/eval-queries.json as an array of {query, relevant_ids, mode?} objects.",
+      "Wire --fail-under into CI to fail the build when aggregate nDCG@k drops below your baseline."
+    ]
+  },
   reindex: {
     why: "Rebuilds search artifacts after large changes to item corpus or provider/vector config.",
     examples: ["pm reindex --mode keyword", "pm reindex --mode hybrid --progress --json"],
@@ -2600,7 +2642,7 @@ function createLazyModule(importer) {
 !(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] = "ccef5107-28ce-5031-9161-ad877dd968c2");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c2d84713-bde8-5ed0-9975-41d50fb0be76");
   } catch (e2) {
   }
 })();
@@ -2870,6 +2912,9 @@ function applyDynamicExtensionFlagOptions(command, definitions) {
     command.option(flags, formatDynamicExtensionOptionDescription(definition));
   }
 }
+function buildResidualDynamicExtensionFlagHelp(command, definitions) {
+  return buildDynamicExtensionFlagHelp(definitions.filter((definition) => !commandAlreadyHasOption(command, definition)));
+}
 function buildDynamicExtensionHelpOptionSummary(definition) {
   const flags = formatDynamicExtensionOptionFlags(definition);
   if (!flags) {
@@ -3016,7 +3061,7 @@ function ensureCommandPath(root, pathParts) {
 !(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] = "b2f8851d-7245-57db-8db6-100f7da7697e");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "df81f91f-ed92-5511-b34c-ea7c1b81230b");
   } catch (e2) {
   }
 })();
@@ -3439,7 +3484,7 @@ function splitCanonicalListToken(token) {
     inlineValue: token.slice(equalsIndex + 1)
   };
 }
-function coalesceRepeatedListFlags(argv, listFlags, valueConsumingFlags = /* @__PURE__ */ new Set()) {
+function coalesceRepeatedListFlags(argv, listFlags, valueConsumingFlags = /* @__PURE__ */ new Set(), multiValueListFlags = /* @__PURE__ */ new Set()) {
   if (listFlags.size === 0) {
     return { argv: [...argv], events: [] };
   }
@@ -3476,8 +3521,16 @@ function coalesceRepeatedListFlags(argv, listFlags, valueConsumingFlags = /* @__
     } else {
       const next = argv[index + 1];
       if (typeof next === "string" && next !== "--" && !next.startsWith("-")) {
-        value = next;
-        consumed = 2;
+        const values = [next];
+        if (multiValueListFlags.has(parsed.flag)) {
+          let valueIndex = index + 2;
+          while (valueIndex < argv.length && argv[valueIndex] !== "--" && !argv[valueIndex].startsWith("-")) {
+            values.push(argv[valueIndex]);
+            valueIndex += 1;
+          }
+        }
+        value = values.join(",");
+        consumed = 1 + values.length;
       }
     }
     if (value === void 0) {
@@ -3505,7 +3558,8 @@ function coalesceRepeatedListFlags(argv, listFlags, valueConsumingFlags = /* @__
   const events = [];
   const splices = [];
   for (const [flag, slot] of slots) {
-    if (slot.occurrences >= 2) {
+    const shouldMerge = slot.occurrences >= 2 || multiValueListFlags.has(flag) && slot.originalTokens.length > 2;
+    if (shouldMerge) {
       const mergedToken = `${flag}=${slot.values.join(",")}`;
       splices.push({ outputIndex: slot.outputIndex, tokens: [mergedToken] });
       events.push({
@@ -3627,7 +3681,7 @@ function normalizeBootstrapInvocation(argv) {
     normalizedArgv.push(token);
   }
   const linkedTestNormalized = mergeLinkedTestTwoTokenEntries(normalizedArgv, commandName, trace);
-  const coalesced = coalesceRepeatedListFlags(linkedTestNormalized, lookup.listCanonicalFlags, GLOBAL_VALUE_CONSUMING_FLAGS);
+  const coalesced = coalesceRepeatedListFlags(linkedTestNormalized, lookup.listCanonicalFlags, GLOBAL_VALUE_CONSUMING_FLAGS, commandName === "create" ? /* @__PURE__ */ new Set(["--tags"]) : /* @__PURE__ */ new Set());
   for (const event of coalesced.events) {
     trace.push(event);
   }
@@ -3812,7 +3866,7 @@ async function enforceItemFormatWriteGateAndPreflightMigration(commandPath, opti
 !(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] = "59e971b3-127d-56d1-a589-a264e834d083");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "f4d1afdd-4dd2-5c8d-8948-0d2de94744f9");
   } catch (e2) {
   }
 })();
@@ -3833,12 +3887,6 @@ var OPTIONAL_PACKAGE_INSTALL_HINTS = {
   beads: "beads",
   todos: "todos"
 };
-var COMMON_COMMAND_ALIASES = {
-  comment: ["comments"],
-  note: ["notes"],
-  learning: ["learnings"],
-  show: ["get"]
-};
 var SEMANTIC_UNKNOWN_OPTION_SUGGESTIONS = {
   comments: {
     "--body": ["--add"],
@@ -4115,20 +4163,27 @@ function buildUnknownCommandGuidanceFromRuntime(rawMessage, root, extensionDescr
     return void 0;
   }
   const primaryToken = normalizedUnknown.split(" ")[0];
-  const rankedCandidates = commandPaths.map((commandPath) => {
-    const directScore = scoreCommandPathMatch(commandPath, normalizedUnknown);
-    const fallbackScore = primaryToken !== normalizedUnknown ? scoreCommandPathMatch(commandPath, primaryToken) : Number.POSITIVE_INFINITY;
-    const score = Math.min(directScore, fallbackScore);
-    return { commandPath, score };
-  }).filter((entry) => Number.isFinite(entry.score)).sort((left, right) => {
-    if (left.score !== right.score) {
-      return left.score - right.score;
-    }
-    return left.commandPath.localeCompare(right.commandPath);
-  }).map((entry) => entry.commandPath);
-  const aliasCandidates = (COMMON_COMMAND_ALIASES[primaryToken] ?? []).filter((aliasPath) => commandPaths.includes(aliasPath));
+  const commandPathSet = new Set(commandPaths);
+  const scoreAgainstUnknown = (candidatePath) => Math.min(scoreCommandPathMatch(candidatePath, normalizedUnknown), primaryToken !== normalizedUnknown ? scoreCommandPathMatch(candidatePath, primaryToken) : Number.POSITIVE_INFINITY);
+  const scoresByCommandPath = /* @__PURE__ */ new Map();
+  const recordCandidateScore = (commandPath, score) => {
+    if (!Number.isFinite(score) || !commandPathSet.has(commandPath)) {
+      return;
+    }
+    const existing = scoresByCommandPath.get(commandPath);
+    if (existing === void 0 || score < existing) {
+      scoresByCommandPath.set(commandPath, score);
+    }
+  };
+  for (const commandPath of commandPaths) {
+    recordCandidateScore(commandPath, scoreAgainstUnknown(commandPath));
+  }
+  for (const [aliasToken, canonicalPath] of Object.entries(EXECUTABLE_COMMAND_ALIASES)) {
+    recordCandidateScore(canonicalPath, scoreAgainstUnknown(aliasToken));
+  }
+  const rankedCandidates = [...scoresByCommandPath.entries()].sort(([leftPath, leftScore], [rightPath, rightScore]) => leftScore !== rightScore ? leftScore - rightScore : leftPath.localeCompare(rightPath)).map(([commandPath]) => commandPath);
   const installedPackageCandidates = collectInstalledPackageCommandPathHints(primaryToken, extensionDescriptors).filter((commandPath) => commandPaths.includes(commandPath));
-  const combinedCandidates = dedupeStrings2([...aliasCandidates, ...rankedCandidates, ...installedPackageCandidates]);
+  const combinedCandidates = dedupeStrings2([...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);
@@ -4568,7 +4623,7 @@ function attachCreateUpdatePolicyHelpText(rootProgram, typeRegistry, argv) {
 !(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] = "19c48e71-e3b3-514d-99d4-b38e2aed8c3b");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "654b0978-c0af-571f-9c8b-cb35a64c8d01");
   } catch (e2) {
   }
 })();
@@ -4584,6 +4639,9 @@ var activeTelemetryCommandContext = null;
 function setActiveExtensionHookContextForTest(context) {
   activeExtensionHookContext = context;
 }
+function setActiveRuntimeExtensionCommandDescriptorsForTest(descriptors) {
+  activeRuntimeExtensionCommandDescriptors = descriptors;
+}
 var TELEMETRY_COMMAND_RESOLUTION_SET = /* @__PURE__ */ new Set([
   "success",
   "nonexistent_command",
@@ -4610,10 +4668,10 @@ var EXPECTED_HANDLED_ERROR_EXIT_CODES = /* @__PURE__ */ new Set([
   EXIT_CODE.CONFLICT
 ]);
 var TRUE_LIKE_ENV_VALUES = /* @__PURE__ */ new Set(["1", "true", "yes", "on"]);
-var loadSetupRegistrationModule = createLazyModule(() => import("./chunks/register-setup-2FEGSFLM.js"));
-var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-FUMXPWZ4.js"));
-var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-RXRX4P7D.js"));
-var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-6UURPZN5.js"));
+var loadSetupRegistrationModule = createLazyModule(() => import("./chunks/register-setup-KPTZ36D4.js"));
+var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-7BD6ZHU5.js"));
+var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-PLFHAS4N.js"));
+var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-VLGCAWIW.js"));
 function describeUnknownError(error) {
   if (error instanceof PmCliError) {
     return error.message;
@@ -5039,16 +5097,24 @@ function formatDynamicCommandUsage(descriptor) {
   }).join(" ");
   return `pm ${descriptor.command}${argumentSuffix ? ` ${argumentSuffix}` : ""}`;
 }
+function isImporterOrExporterCommandPath(registrations, commandPath) {
+  if (!registrations) {
+    return false;
+  }
+  const normalized = normalizeExtensionCommandPath(commandPath);
+  return registrations.importers.some((entry) => normalizeExtensionCommandPath(`${entry.importer} import`) === normalized) || registrations.exporters.some((entry) => normalizeExtensionCommandPath(`${entry.exporter} export`) === normalized);
+}
 function validateDynamicExtensionCommandArgs(descriptor, args) {
   const requiredCount = descriptor.arguments.filter((argument) => argument.required).length;
   const variadic = descriptor.arguments.some((argument) => argument.variadic);
   const maxCount = variadic ? Number.POSITIVE_INFINITY : descriptor.arguments.length;
+  const hintSuffix = descriptor.failure_hints.length > 0 ? ` ${descriptor.failure_hints.join(" ")}` : "";
   if (args.length < requiredCount) {
-    throw new PmCliError(`Missing required argument for extension command '${descriptor.command}'. Usage: ${formatDynamicCommandUsage(descriptor)}`, EXIT_CODE.USAGE);
+    throw new PmCliError(`Missing required argument for extension command '${descriptor.command}'. Usage: ${formatDynamicCommandUsage(descriptor)}${hintSuffix}`, EXIT_CODE.USAGE);
   }
   if (args.length > maxCount) {
     const extra = args.slice(maxCount).join(" ");
-    throw new PmCliError(`Too many arguments for extension command '${descriptor.command}': ${extra}. Usage: ${formatDynamicCommandUsage(descriptor)}`, EXIT_CODE.USAGE);
+    throw new PmCliError(`Too many arguments for extension command '${descriptor.command}': ${extra}. Usage: ${formatDynamicCommandUsage(descriptor)}${hintSuffix}`, EXIT_CODE.USAGE);
   }
 }
 function formatDynamicOptionFlag(optionKey) {
@@ -5660,6 +5726,11 @@ function wrapProgramActionsForExtensionHandlers(rootProgram) {
         commandArgs = parserOverride.context.args;
         commandOptions = parserOverride.context.options;
         globalOptions = parserOverride.context.global;
+        const dynamicDescriptor = activeRuntimeExtensionCommandDescriptors.get(normalizeExtensionCommandPath(commandPath));
+        if (dynamicDescriptor && isImporterOrExporterCommandPath(activeRegistrations, commandPath)) {
+          const positionalArgs = dynamicDescriptor.arguments.length === 0 ? collectLoosePositionalArgs(commandArgs) : stripLooseCommandOptionTokens(commandArgs, extensionFlagDefinitions);
+          validateDynamicExtensionCommandArgs(dynamicDescriptor, positionalArgs);
+        }
         globalOptions = await applyDefaultOutputFormat(globalOptions);
         setResolvedGlobalOptions(actionCommand, globalOptions);
         actionCommand.args = [...commandArgs];
@@ -5760,8 +5831,11 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
     if (existingCommand) {
       if (descriptor?.flags && descriptor.flags.length > 0) {
         applyDynamicExtensionFlagOptions(existingCommand, descriptor.flags);
-      }
-      if (flagHelp) {
+        const residualFlagHelp = buildResidualDynamicExtensionFlagHelp(existingCommand, descriptor.flags);
+        if (residualFlagHelp) {
+          existingCommand.addHelpText("after", residualFlagHelp);
+        }
+      } else if (flagHelp) {
         existingCommand.addHelpText("after", flagHelp);
       }
       if (metadataHelp) {
@@ -5776,14 +5850,16 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
     if (descriptor?.description) {
       dynamicCommand.description(descriptor.description);
     }
+    let residualDynamicFlagHelp = flagHelp;
     if (descriptor) {
       applyDynamicExtensionArguments(dynamicCommand, descriptor);
       if (descriptor.flags.length > 0) {
         applyDynamicExtensionFlagOptions(dynamicCommand, descriptor.flags);
+        residualDynamicFlagHelp = buildResidualDynamicExtensionFlagHelp(dynamicCommand, descriptor.flags) ?? void 0;
       }
     }
-    if (flagHelp) {
-      dynamicCommand.addHelpText("after", flagHelp);
+    if (residualDynamicFlagHelp) {
+      dynamicCommand.addHelpText("after", residualDynamicFlagHelp);
     }
     if (metadataHelp) {
       dynamicCommand.addHelpText("after", metadataHelp);
@@ -6551,7 +6627,9 @@ var _testOnly = {
   shouldRegisterDynamicExtensionPaths,
   shouldRegisterRuntimeSchemaFlags,
   setActiveExtensionHookContextForTest,
+  setActiveRuntimeExtensionCommandDescriptorsForTest,
   toLooseFieldDefinitionType,
+  isImporterOrExporterCommandPath,
   validateDynamicExtensionCommandInvocation,
   wrapProgramActionsForExtensionHandlers,
   wrapThrownErrorForSentry