@unbrained/pm-cli 2026.6.10 → 2026.6.12

package/dist/cli-bundle/main.js

@@ -5,13 +5,13 @@ import {
   emitTelemetryErrorEvent,
   finishTelemetryCommand,
   startTelemetryCommand
-} from "./chunks/chunk-TZLGCTA5.js";
+} from "./chunks/chunk-GKIZW7SM.js";
 import {
   migrateItemFilesToFormat
-} from "./chunks/chunk-7DUVDW7C.js";
+} from "./chunks/chunk-VSRZRLG3.js";
 import {
   normalizeExtensionNameForMatch
-} from "./chunks/chunk-GRHPU6EM.js";
+} from "./chunks/chunk-ZLMIWZUG.js";
 import {
   applyDefaultOutputFormat,
   clearResolvedGlobalOptions,
@@ -21,27 +21,27 @@ import {
   getGlobalOptions,
   invalidateSearchCachesForMutation,
   setResolvedGlobalOptions
-} from "./chunks/chunk-A6XVYNQJ.js";
+} from "./chunks/chunk-37CYVF73.js";
 import {
   PM_CORE_COMMAND_NAMES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunks/chunk-GF5XIBUH.js";
-import "./chunks/chunk-OSGWBWLK.js";
+} from "./chunks/chunk-35P4GT6E.js";
+import "./chunks/chunk-7UGSRQCL.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunks/chunk-UMWF6ZAS.js";
-import "./chunks/chunk-XRE4CTNP.js";
-import "./chunks/chunk-I2FM2SMO.js";
-import "./chunks/chunk-Q6PSD5DZ.js";
+} from "./chunks/chunk-GWZSYR6X.js";
+import "./chunks/chunk-3KLPFWZ4.js";
+import "./chunks/chunk-VPEAS7PS.js";
+import "./chunks/chunk-73ZPG2I3.js";
 import {
   commandOptionFlagLabel,
   resolveCommandOptionPolicyState,
   resolveItemTypeRegistry,
   resolveTypeDefinition
-} from "./chunks/chunk-7GYMMDDW.js";
-import "./chunks/chunk-7TW64BS5.js";
+} from "./chunks/chunk-5SCT2JCT.js";
+import "./chunks/chunk-IUKD4W6Z.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -85,7 +85,7 @@ import {
   setActiveExtensionServices,
   toNonEmptyStringOrUndefined,
   writeSettings
-} from "./chunks/chunk-OQGJSCZZ.js";
+} from "./chunks/chunk-FY4SPXSC.js";
 
 // dist/cli/main.js
 import { Command } from "commander";
@@ -96,7 +96,7 @@ import { stdin as input, stdout as output } from "node:process";
 !(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] = "c965da5d-6609-5258-ba49-a57475f7f2ef");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "7804d4bf-ff46-50af-9af5-533f83c3d445");
   } catch (e2) {
   }
 })();
@@ -109,6 +109,16 @@ function parseBooleanLike(value) {
   }
   return TELEMETRY_PROMPT_DISABLE_VALUES.has(value.trim().toLowerCase());
 }
+function isTruthyEnvValue(value) {
+  if (typeof value !== "string") {
+    return false;
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized.length === 0) {
+    return false;
+  }
+  return !TELEMETRY_PROMPT_DISABLE_VALUES.has(normalized);
+}
 function shouldSkipTelemetryPrompt(commandPath, globalOptions) {
   if (globalOptions.json === true || globalOptions.quiet === true) {
     return true;
@@ -119,7 +129,7 @@ function shouldSkipTelemetryPrompt(commandPath, globalOptions) {
   if (parseBooleanLike(process.env[TELEMETRY_PROMPT_DISABLE_ENV])) {
     return true;
   }
-  if (parseBooleanLike(process.env.CI)) {
+  if (isTruthyEnvValue(process.env.CI)) {
     return true;
   }
   const normalizedCommandPath = commandPath.trim().toLowerCase();
@@ -974,7 +984,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] = "ad4ec245-86cd-551a-814a-482b7a2442b8");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "a1d00ac8-e750-598f-a4ec-20581735dc84");
   } catch (e2) {
   }
 })();
@@ -1531,13 +1541,17 @@ var HELP_BY_COMMAND_PATH = {
     why: "Associates changed source files with tracker items for reproducibility.",
     examples: [
       'pm files pm-a1b2 --add "path=src/cli/main.ts,note=help orchestration"',
+      'pm files pm-a1b2 --add src/cli/main.ts --note "help orchestration"',
       "pm files discover pm-a1b2",
       'pm files discover pm-a1b2 --apply --note "discovered from item text"'
     ]
   },
   docs: {
     why: "Associates relevant documentation paths with tracker items.",
-    examples: ['pm docs pm-a1b2 --add "path=README.md,note=user-facing command guidance"']
+    examples: [
+      'pm docs pm-a1b2 --add "path=README.md,note=user-facing command guidance"',
+      'pm docs pm-a1b2 --add README.md --note "user-facing command guidance"'
+    ]
   },
   test: {
     why: "Links test commands/paths and optionally executes them for one item.",
@@ -1748,7 +1762,7 @@ function renderPmCommand(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] = "004f0f48-f016-51b6-b587-30101f5bb77f");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "492e5d0f-cf1f-5e6e-a75e-b74944ffcb84");
   } catch (e2) {
   }
 })();
@@ -2207,6 +2221,66 @@ function appendIfMissing(entries, value) {
   }
   return [...entries, value];
 }
+var LINKED_TEST_MUTATION_FLAGS = /* @__PURE__ */ new Set(["--add", "--add-json", "--remove"]);
+var LINKED_TEST_RETRY_KEYS = /* @__PURE__ */ new Set(["command", "cmd", "path"]);
+function findLinkedTestMutationFlag(argv) {
+  if (!Array.isArray(argv)) {
+    return void 0;
+  }
+  for (const token of argv) {
+    if (!token.startsWith("--")) {
+      continue;
+    }
+    const equalsIndex = token.indexOf("=");
+    const flag = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;
+    if (LINKED_TEST_MUTATION_FLAGS.has(flag)) {
+      return flag;
+    }
+  }
+  return void 0;
+}
+function buildLinkedTestQuotedRetryCommand(argv) {
+  if (!Array.isArray(argv)) {
+    return void 0;
+  }
+  const commandIndex = argv.indexOf("test");
+  if (commandIndex < 0) {
+    return void 0;
+  }
+  const idToken = argv[commandIndex + 1];
+  if (typeof idToken !== "string" || idToken.startsWith("-")) {
+    return void 0;
+  }
+  for (let index = commandIndex + 2; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (token !== "--add" && token !== "--remove") {
+      continue;
+    }
+    const key = argv[index + 1];
+    if (typeof key !== "string" || !LINKED_TEST_RETRY_KEYS.has(key)) {
+      return void 0;
+    }
+    const valueTokens = [];
+    for (let cursor = index + 2; cursor < argv.length; cursor += 1) {
+      const candidate = argv[cursor];
+      if (candidate.startsWith("--") && candidate.length > 2) {
+        break;
+      }
+      valueTokens.push(candidate);
+    }
+    if (valueTokens.length < 2) {
+      return void 0;
+    }
+    const merged = `${key}=${valueTokens.join(" ")}`;
+    const rewritten = [
+      ...argv.slice(0, index + 1),
+      merged,
+      ...argv.slice(index + 2 + valueTokens.length)
+    ];
+    return renderPmCommand(rewritten);
+  }
+  return void 0;
+}
 function buildCommanderErrorGuidance(rawMessage, commandName, allowedTypes, context) {
   const message = normalizeMessage(rawMessage);
   const requiredOption = message.match(/required option '([^']+)' not specified/);
@@ -2323,6 +2397,32 @@ function buildCommanderErrorGuidance(rawMessage, commandName, allowedTypes, cont
       recovery: buildCommanderRecoveryPayload(context)
     });
   }
+  if (/too many arguments/i.test(message) && commandName === "test") {
+    const argv = context?.normalizedInvocationArgs;
+    const mutationFlag = findLinkedTestMutationFlag(argv);
+    if (mutationFlag) {
+      const retryCommand = buildLinkedTestQuotedRetryCommand(argv);
+      return makeGuidanceMessage({
+        code: "linked_test_value_not_quoted",
+        title: `Linked-test ${mutationFlag} value must be one argument`,
+        happened: `Commander saw extra positional tokens after the item id \u2014 usually a ${mutationFlag} value containing spaces (for example a command with " -- ") that the shell split into multiple tokens.`,
+        required: `Quote the whole ${mutationFlag} value as a single argument. Accepted forms: --add "command=npm test -- parser", --add command "npm test -- parser" (two-token form with the value quoted), or --add-json for complex commands.`,
+        why: "The shell splits unquoted values before pm can see them, so pm cannot reassemble the intended command unambiguously.",
+        examples: [
+          ...retryCommand ? [retryCommand] : [],
+          'pm test pm-a1b2 --add "command=npm test -- parser"',
+          'pm test pm-a1b2 --add command "npm test -- parser"',
+          `pm test pm-a1b2 --add-json '{"command":"npm test -- parser"}'`
+        ],
+        nextSteps: [
+          ...retryCommand ? [`Replay with the value re-joined into one argument: ${retryCommand}`] : [],
+          "Prefer --add-json for commands containing commas, equals signs, or quotes.",
+          'Run "pm test --help" for linked-test entry contracts.'
+        ],
+        recovery: buildCommanderRecoveryPayload(context, retryCommand ? { suggested_retry: retryCommand } : {})
+      });
+    }
+  }
   return makeGuidanceMessage({
     code: "invalid_command_usage",
     title: "Invalid command usage",
@@ -2821,7 +2921,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] = "775395d8-a1d9-5ed6-af75-160c750c0955");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b9a4b15e-8a4c-5a00-b42e-ff9a3cf88bf1");
   } catch (e2) {
   }
 })();
@@ -3329,6 +3429,60 @@ function coalesceRepeatedListFlags(argv, listFlags, valueConsumingFlags = /* @__
   }
   return { argv: result, events };
 }
+var LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG = /* @__PURE__ */ new Map([
+  ["--add", /* @__PURE__ */ new Set(["command", "cmd", "path"])],
+  ["--remove", /* @__PURE__ */ new Set(["command", "path"])]
+]);
+function isLinkedTestTwoTokenValuePosition(commandName, emittedTokens) {
+  if (commandName !== "test" || emittedTokens.length < 2) {
+    return false;
+  }
+  const key = emittedTokens[emittedTokens.length - 1];
+  const flag = emittedTokens[emittedTokens.length - 2];
+  const keys = LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(flag);
+  return keys !== void 0 && keys.has(key);
+}
+function mergeLinkedTestTwoTokenEntries(argv, commandName, trace) {
+  if (commandName !== "test") {
+    return argv;
+  }
+  const result = [];
+  let index = 0;
+  while (index < argv.length) {
+    const token = argv[index];
+    if (token === "--") {
+      result.push(...argv.slice(index));
+      return result;
+    }
+    const keys = LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(token);
+    const key = keys ? argv[index + 1] : void 0;
+    if (!keys || typeof key !== "string" || !keys.has(key)) {
+      result.push(token);
+      index += 1;
+      continue;
+    }
+    let runEnd = index + 2;
+    while (runEnd < argv.length && !argv[runEnd].startsWith("-")) {
+      runEnd += 1;
+    }
+    if (runEnd - (index + 2) !== 1) {
+      result.push(token);
+      index += 1;
+      continue;
+    }
+    const value = argv[index + 2];
+    const mergedValue = `${key}=${value}`;
+    result.push(token, mergedValue);
+    trace.push({
+      from: `${token} ${key} ${value}`,
+      to: [token, mergedValue],
+      reason: "bare_key_value",
+      confidence: "high"
+    });
+    index += 3;
+  }
+  return result;
+}
 function normalizeBootstrapInvocation(argv) {
   const trace = [];
   const legacyNormalized = normalizeLegacyExtensionActionSyntax(argv);
@@ -3361,7 +3515,7 @@ function normalizeBootstrapInvocation(argv) {
       continue;
     }
     const bareKeyValue = parseBareKeyValueToken(token);
-    if (bareKeyValue && !(typeof previous === "string" && previous.startsWith("-"))) {
+    if (bareKeyValue && !(typeof previous === "string" && previous.startsWith("-")) && !isLinkedTestTwoTokenValuePosition(commandName, normalizedArgv)) {
       const resolution = resolveCanonicalFlag(bareKeyValue.key, lookup);
       if (resolution) {
         const replacement = [resolution.flag, bareKeyValue.value];
@@ -3377,7 +3531,8 @@ function normalizeBootstrapInvocation(argv) {
     }
     normalizedArgv.push(token);
   }
-  const coalesced = coalesceRepeatedListFlags(normalizedArgv, lookup.listCanonicalFlags, GLOBAL_VALUE_CONSUMING_FLAGS);
+  const linkedTestNormalized = mergeLinkedTestTwoTokenEntries(normalizedArgv, commandName, trace);
+  const coalesced = coalesceRepeatedListFlags(linkedTestNormalized, lookup.listCanonicalFlags, GLOBAL_VALUE_CONSUMING_FLAGS);
   for (const event of coalesced.events) {
     trace.push(event);
   }
@@ -4356,10 +4511,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-WLFL3OUF.js"));
-var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-QGRFMDWA.js"));
-var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-ZPZNJXSA.js"));
-var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-YEN4YEZ2.js"));
+var loadSetupRegistrationModule = createLazyModule(() => import("./chunks/register-setup-KVNLO5OJ.js"));
+var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-4UPMHONX.js"));
+var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-FARSGYRD.js"));
+var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-HCJKDUA6.js"));
 function describeUnknownError(error) {
   if (error instanceof PmCliError) {
     return error.message;