@unbrained/pm-cli 2026.6.8 → 2026.6.10

package/dist/cli-bundle/main.js

@@ -5,13 +5,13 @@ import {
   emitTelemetryErrorEvent,
   finishTelemetryCommand,
   startTelemetryCommand
-} from "./chunks/chunk-TXKENAQP.js";
+} from "./chunks/chunk-TZLGCTA5.js";
 import {
   migrateItemFilesToFormat
-} from "./chunks/chunk-J4DKAGTM.js";
+} from "./chunks/chunk-7DUVDW7C.js";
 import {
   normalizeExtensionNameForMatch
-} from "./chunks/chunk-URJEZOLB.js";
+} from "./chunks/chunk-GRHPU6EM.js";
 import {
   applyDefaultOutputFormat,
   clearResolvedGlobalOptions,
@@ -21,30 +21,27 @@ import {
   getGlobalOptions,
   invalidateSearchCachesForMutation,
   setResolvedGlobalOptions
-} from "./chunks/chunk-VXBUXLVD.js";
+} from "./chunks/chunk-A6XVYNQJ.js";
 import {
   PM_CORE_COMMAND_NAMES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunks/chunk-DV27WDA7.js";
-import "./chunks/chunk-3E3MDBTB.js";
+} from "./chunks/chunk-GF5XIBUH.js";
+import "./chunks/chunk-OSGWBWLK.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunks/chunk-N4SQZ7L3.js";
-import {
-  levenshteinDistanceWithinLimit
-} from "./chunks/chunk-EAOG77HM.js";
-import "./chunks/chunk-2HMD3JM2.js";
-import "./chunks/chunk-K62SNVVE.js";
-import "./chunks/chunk-M7UBTVFT.js";
+} from "./chunks/chunk-UMWF6ZAS.js";
+import "./chunks/chunk-XRE4CTNP.js";
+import "./chunks/chunk-I2FM2SMO.js";
+import "./chunks/chunk-Q6PSD5DZ.js";
 import {
   commandOptionFlagLabel,
   resolveCommandOptionPolicyState,
   resolveItemTypeRegistry,
   resolveTypeDefinition
-} from "./chunks/chunk-2BYKYPWY.js";
-import "./chunks/chunk-QFVASU44.js";
+} from "./chunks/chunk-7GYMMDDW.js";
+import "./chunks/chunk-7TW64BS5.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -55,13 +52,16 @@ import {
   consumeAfterCommandAffectedItems,
   createEmptyExtensionRegistrationRegistry,
   discoverExtensions,
+  flattenFlagListValue,
   getActiveCommandResult,
   getActiveExtensionRegistrations,
   getSettingsPath,
+  levenshteinDistanceWithinLimit,
   loadExtensions,
   pathExists,
   readSettings,
   readSettingsWithMetadata,
+  resolveFlagValueKind,
   resolveGlobalPmRoot,
   resolvePmCliVersion,
   resolvePmPackageRootFromModule,
@@ -85,7 +85,7 @@ import {
   setActiveExtensionServices,
   toNonEmptyStringOrUndefined,
   writeSettings
-} from "./chunks/chunk-3TXWDGPU.js";
+} from "./chunks/chunk-OQGJSCZZ.js";
 
 // dist/cli/main.js
 import { Command } from "commander";
@@ -645,7 +645,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] = "d166f748-b8c5-5837-a22e-8a0e34b28c72");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b2a33807-c231-539d-ba55-045ba504f088");
   } catch (e2) {
   }
 })();
@@ -730,19 +730,8 @@ function isUnsafeLooseOptionKey(key) {
   return UNSAFE_LOOSE_OPTION_KEYS.has(key);
 }
 function resolveLooseOptionCoercionKind(definition) {
-  const explicitType = typeof definition.type === "string" ? definition.type.trim().toLowerCase() : void 0;
-  const valueType = typeof definition.value_type === "string" ? definition.value_type.trim().toLowerCase() : void 0;
-  const kind = explicitType ?? valueType;
-  if (kind === "string") {
-    return "string";
-  }
-  if (kind === "number" || kind === "int" || kind === "integer" || kind === "float") {
-    return "number";
-  }
-  if (kind === "boolean" || kind === "bool") {
-    return "boolean";
-  }
-  return null;
+  const raw = (typeof definition.value_type === "string" ? definition.value_type : void 0) ?? (typeof definition.type === "string" ? definition.type : void 0);
+  return resolveFlagValueKind(raw);
 }
 function collectLooseOptionKeys(definition) {
   const keys = [];
@@ -762,6 +751,15 @@ function collectLooseOptionKeys(definition) {
   }
   return [...new Set(keys)];
 }
+function collectLooseCommandOptionKeysForDefinitions(definitions) {
+  const keys = /* @__PURE__ */ new Set();
+  for (const definition of definitions) {
+    for (const key of collectLooseOptionKeys(definition)) {
+      keys.add(key);
+    }
+  }
+  return keys;
+}
 function resolveCanonicalLooseOptionKey(definition) {
   const long = typeof definition.long === "string" ? definition.long.trim() : "";
   if (long.startsWith("--")) {
@@ -860,6 +858,16 @@ function coerceLooseOptionValue(value, kind) {
   }
   return value;
 }
+function splitCommaListValue(value, kind) {
+  const entries = flattenFlagListValue(value);
+  return kind ? entries.map((entry) => coerceLooseOptionValue(entry, kind)) : entries;
+}
+function applyFlagDefault(defaultValue, kind, isListFlag) {
+  if (isListFlag) {
+    return splitCommaListValue(defaultValue, kind);
+  }
+  return kind ? coerceLooseOptionValue(defaultValue, kind) : defaultValue;
+}
 function coerceLooseCommandOptionsWithFlagDefinitions(options, definitions) {
   if (definitions.length === 0) {
     return options;
@@ -884,10 +892,18 @@ function coerceLooseCommandOptionsWithFlagDefinitions(options, definitions) {
       delete coerced[key];
     }
     const kind = resolveLooseOptionCoercionKind(definition);
-    if (!kind) {
+    const isListFlag = definition.list === true;
+    if (!Object.hasOwn(coerced, canonical)) {
+      if (definition.default !== void 0) {
+        coerced[canonical] = applyFlagDefault(definition.default, kind, isListFlag);
+      }
       continue;
     }
-    if (!Object.hasOwn(coerced, canonical)) {
+    if (isListFlag) {
+      coerced[canonical] = splitCommaListValue(coerced[canonical], kind);
+      continue;
+    }
+    if (!kind) {
       continue;
     }
     coerced[canonical] = coerceLooseOptionValue(coerced[canonical], kind);
@@ -913,6 +929,46 @@ function parseLooseCommandOptions(args) {
   }
   return options;
 }
+function stripLooseCommandOptionTokens(args, definitions) {
+  if (definitions.length === 0) {
+    return [...args];
+  }
+  const knownKeys = /* @__PURE__ */ new Set();
+  const booleanKeys = /* @__PURE__ */ new Set();
+  for (const definition of definitions) {
+    const valueKind = resolveLooseOptionCoercionKind(definition);
+    for (const key of collectLooseOptionKeys(definition)) {
+      knownKeys.add(key);
+      if (valueKind === "boolean") {
+        booleanKeys.add(key);
+      }
+    }
+  }
+  if (knownKeys.size === 0) {
+    return [...args];
+  }
+  const stripped = [];
+  let index = 0;
+  while (index < args.length) {
+    if (args[index] === "--") {
+      stripped.push(...args.slice(index + 1));
+      break;
+    }
+    const parsed = parseLooseOptionToken(args, index);
+    if (parsed) {
+      const normalizedKey = toLooseOptionKey(parsed.key);
+      if (knownKeys.has(normalizedKey)) {
+        const token = args[index] ?? "";
+        const consumed = booleanKeys.has(normalizedKey) && !token.includes("=") ? 1 : parsed.consumed;
+        index += consumed;
+        continue;
+      }
+    }
+    stripped.push(args[index]);
+    index += 1;
+  }
+  return stripped;
+}
 
 // dist/cli/help-content.js
 !(function() {
@@ -2349,7 +2405,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] = "b2d550e5-da06-5832-85f4-a3c40208d78d");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "2afbf21c-b26d-53d0-bd93-762ebd9e366a");
   } catch (e2) {
   }
 })();
@@ -2568,6 +2624,25 @@ function formatDynamicExtensionOptionFlags(definition) {
   const optionNames = [normalizedShort, normalizedLong].filter((entry) => entry !== null);
   return `${optionNames.join(", ")}${optionValueSuffix}`;
 }
+function formatDynamicExtensionParseOptionFlags(definition) {
+  const visible = toOptionalBoolean(definition.visible);
+  if (visible === false) {
+    return null;
+  }
+  const longName = toNonEmptyFlagString(definition.long);
+  const shortName = toNonEmptyFlagString(definition.short);
+  const normalizedShort = shortName && shortName.startsWith("-") && !shortName.startsWith("--") ? shortName : null;
+  const normalizedLong = longName && longName.startsWith("--") && longName.length > 2 ? longName : null;
+  if (!normalizedLong && !normalizedShort) {
+    return null;
+  }
+  const valueType = toNonEmptyFlagString(definition.value_type) ?? toNonEmptyFlagString(definition.type);
+  const valueName = toNonEmptyFlagString(definition.value_name);
+  const requiresValue = valueType !== "boolean" && (valueName !== null || valueType !== null || toOptionalBoolean(definition.required) === true);
+  const valueSuffix = requiresValue ? ` <${valueName ?? "value"}>` : "";
+  const optionNames = [normalizedShort, normalizedLong].filter((entry) => entry !== null);
+  return `${optionNames.join(", ")}${valueSuffix}`;
+}
 function formatDynamicExtensionOptionDescription(definition) {
   const description = toNonEmptyFlagString(definition.description) ?? "Extension-provided option.";
   const markers = [];
@@ -2580,6 +2655,26 @@ function formatDynamicExtensionOptionDescription(definition) {
   const markerSuffix = markers.length > 0 ? ` [${markers.join(", ")}]` : "";
   return `${description}${markerSuffix}`;
 }
+function commandAlreadyHasOption(command, definition) {
+  const longName = toNonEmptyFlagString(definition.long);
+  const shortName = toNonEmptyFlagString(definition.short);
+  return command.options.some((option) => {
+    const optionWithNames = option;
+    return longName !== null && optionWithNames.long === longName || shortName !== null && optionWithNames.short === shortName;
+  });
+}
+function applyDynamicExtensionFlagOptions(command, definitions) {
+  for (const definition of definitions) {
+    if (commandAlreadyHasOption(command, definition)) {
+      continue;
+    }
+    const flags = formatDynamicExtensionParseOptionFlags(definition);
+    if (!flags) {
+      continue;
+    }
+    command.option(flags, formatDynamicExtensionOptionDescription(definition));
+  }
+}
 function buildDynamicExtensionHelpOptionSummary(definition) {
   const flags = formatDynamicExtensionOptionFlags(definition);
   if (!flags) {
@@ -2726,7 +2821,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] = "15cb1a26-7d5f-525a-8cab-abc50e0f17c0");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "775395d8-a1d9-5ed6-af75-160c750c0955");
   } catch (e2) {
   }
 })();
@@ -2824,7 +2919,7 @@ function stripGlobalBootstrapTokens(argv) {
     if (token === "--") {
       break;
     }
-    if (token === "--json" || token === "--quiet" || token === "--no-extensions" || token === "--no-pager" || token === "--profile" || token === "--explain") {
+    if (token === "--json" || token === "--quiet" || token === "--no-extensions" || token === "--no-pager" || token === "--profile" || token === "--id-only" || token === "--explain") {
       index += 1;
       continue;
     }
@@ -2887,7 +2982,7 @@ function findCommandTokenIndex(argv) {
       index += 1;
       continue;
     }
-    if (token.startsWith("--path=") || token.startsWith("--pm-path=") || token === "--json" || token === "--quiet" || token === "--no-extensions" || token === "--no-pager" || token === "--profile" || token === "--explain") {
+    if (token.startsWith("--path=") || token.startsWith("--pm-path=") || token === "--json" || token === "--quiet" || token === "--no-extensions" || token === "--no-pager" || token === "--profile" || token === "--id-only" || token === "--explain") {
       continue;
     }
     if (token.startsWith("-")) {
@@ -4222,7 +4317,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] = "aead80b1-f418-5252-a0b9-6ab1ea18d330");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "5b1ed048-2b19-58fc-8c2b-10036fb6c237");
   } catch (e2) {
   }
 })();
@@ -4261,10 +4356,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-ABA2JPWO.js"));
-var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-GQAEIG4K.js"));
-var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-YZCUILGO.js"));
-var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-IBYWNJN5.js"));
+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"));
 function describeUnknownError(error) {
   if (error instanceof PmCliError) {
     return error.message;
@@ -4567,16 +4662,22 @@ function extractCommandScopedOptions(command, commandArgs, extensionFlagDefiniti
   delete scoped.profile;
   delete scoped.pager;
   delete scoped.changedFields;
+  delete scoped.idOnly;
   const looseOptions = parseLooseCommandOptions(commandArgs);
-  if (extensionFlagDefinitions.length > 0) {
-    validateLooseCommandOptionsWithFlagDefinitions(looseOptions, extensionFlagDefinitions, getCommandPath(command));
-  }
   for (const [key, value] of Object.entries(looseOptions)) {
     if (scoped[key] === void 0) {
       scoped[key] = value;
     }
   }
   if (extensionFlagDefinitions.length > 0) {
+    const extensionOptionKeys = collectLooseCommandOptionKeysForDefinitions(extensionFlagDefinitions);
+    const optionsToValidate = { ...looseOptions };
+    for (const key of extensionOptionKeys) {
+      if (scoped[key] !== void 0) {
+        optionsToValidate[key] = scoped[key];
+      }
+    }
+    validateLooseCommandOptionsWithFlagDefinitions(optionsToValidate, extensionFlagDefinitions, getCommandPath(command));
     return coerceLooseCommandOptionsWithFlagDefinitions(scoped, extensionFlagDefinitions);
   }
   return scoped;
@@ -5107,9 +5208,9 @@ async function executeRegisteredRuntimeMigrations(migrations, pmRoot) {
   }
   return warnings;
 }
-async function runRequiredExtensionCommand(command, options, globalOptions) {
+async function runRequiredExtensionCommand(command, options, globalOptions, extensionFlagDefinitions = []) {
   const commandPath = getCommandPath(command);
-  let commandArgs = command.args.map(String);
+  let commandArgs = stripLooseCommandOptionTokens(command.args.map(String), extensionFlagDefinitions);
   let commandOptions = { ...options };
   let resolvedGlobalOptions = { ...globalOptions };
   const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
@@ -5289,6 +5390,9 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
     const flagHelp = snapshot.commandFlagHelp.get(commandPath);
     const metadataHelp = descriptor ? buildDynamicExtensionCommandMetadataHelp(descriptor) : null;
     if (existingCommand) {
+      if (descriptor?.flags && descriptor.flags.length > 0) {
+        applyDynamicExtensionFlagOptions(existingCommand, descriptor.flags);
+      }
       if (flagHelp) {
         existingCommand.addHelpText("after", flagHelp);
       }
@@ -5306,6 +5410,9 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
     }
     if (descriptor) {
       applyDynamicExtensionArguments(dynamicCommand, descriptor);
+      if (descriptor.flags.length > 0) {
+        applyDynamicExtensionFlagOptions(dynamicCommand, descriptor.flags);
+      }
     }
     if (flagHelp) {
       dynamicCommand.addHelpText("after", flagHelp);
@@ -5320,7 +5427,7 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
       const startedAt = Date.now();
       const extensionFlagDefinitions = collectExtensionFlagDefinitionsForInvocation(snapshot.registrations, commandPath, command.args.map(String));
       const scopedOptions = extractCommandScopedOptions(command, command.args.map(String), extensionFlagDefinitions);
-      const result = await runRequiredExtensionCommand(command, scopedOptions, globalOptions);
+      const result = await runRequiredExtensionCommand(command, scopedOptions, globalOptions, extensionFlagDefinitions);
       await invalidateSearchCachesForMutation(globalOptions, result);
       printResult(result, {
         ...globalOptions,
@@ -5344,7 +5451,7 @@ program.name("pm").description("Universal, flexible, extensible, agent-optimized
   // Commander errors are rendered in our own catch path.
   writeErr: () => {
   }
-}).option("--json", "Output JSON instead of TOON").option("--quiet", "Suppress stdout output").option("--no-changed-fields", "Omit the changed_fields array from mutation output (keeps changed_field_count)").option("--pm-path <dir>", "Explicit tracker storage path for this command (preferred over --path)").option("--path <dir>", "Backward-compatible alias for --pm-path; this is the tracker storage path, not a workspace cwd").option("--no-extensions", "Disable extension loading").option("--no-pager", "Disable pager integration for help and long output").option("--explain", "Render extended rationale and examples in help output").option("--profile", "Print deterministic timing diagnostics").exitOverride();
+}).option("--json", "Output JSON instead of TOON").option("--quiet", "Suppress stdout output").option("--no-changed-fields", "Omit the changed_fields array from mutation output (keeps changed_field_count)").option("--id-only", "Print only id and status for single-item mutation output").option("--pm-path <dir>", "Explicit tracker storage path for this command (preferred over --path)").option("--path <dir>", "Backward-compatible alias for --pm-path; this is the tracker storage path, not a workspace cwd").option("--no-extensions", "Disable extension loading").option("--no-pager", "Disable pager integration for help and long output").option("--explain", "Render extended rationale and examples in help output").option("--profile", "Print deterministic timing diagnostics").exitOverride();
 program.hook("preAction", async (_thisCommand, actionCommand) => {
   activeExtensionHookContext = null;
   activeTelemetryCommandContext = null;
@@ -5647,19 +5754,7 @@ async function registerCoreCommandFamilies(rootProgram, selection) {
     registerOperationCommands(rootProgram);
   }
 }
-function isKnownTopLevelCommandOrAlias(rootProgram, commandName) {
-  const normalized = commandName.trim().toLowerCase();
-  for (const command of rootProgram.commands) {
-    if (command.name().trim().toLowerCase() === normalized) {
-      return true;
-    }
-    if (command.aliases().some((alias) => alias.trim().toLowerCase() === normalized)) {
-      return true;
-    }
-  }
-  return false;
-}
-function shouldRegisterDynamicExtensionPaths(rootProgram, invocationArgv) {
+function shouldRegisterDynamicExtensionPaths(_rootProgram, invocationArgv) {
   if (invocationRequestsVersion(invocationArgv)) {
     return false;
   }
@@ -5671,7 +5766,7 @@ function shouldRegisterDynamicExtensionPaths(rootProgram, invocationArgv) {
   if (!commandName) {
     return false;
   }
-  return !isKnownTopLevelCommandOrAlias(rootProgram, commandName);
+  return true;
 }
 function shouldRegisterRuntimeSchemaFlags(invocationArgv) {
   if (invocationRequestsVersion(invocationArgv)) {