@unbrained/pm-cli 2026.7.2 → 2026.7.3

package/dist/cli-bundle/main.js

@@ -5,10 +5,10 @@ import {
   emitTelemetryErrorEvent,
   finishTelemetryCommand,
   startTelemetryCommand
-} from "./chunks/chunk-H4GRLYJS.js";
+} from "./chunks/chunk-ER4ME5U2.js";
 import {
   migrateItemFilesToFormat
-} from "./chunks/chunk-S62UANU7.js";
+} from "./chunks/chunk-5IZUBZBR.js";
 import {
   applyDefaultOutputFormat,
   clearResolvedGlobalOptions,
@@ -18,13 +18,13 @@ import {
   getGlobalOptions,
   invalidateSearchCachesForMutation,
   setResolvedGlobalOptions
-} from "./chunks/chunk-SYNKD3ZG.js";
+} from "./chunks/chunk-HB4FAT3O.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunks/chunk-5PGBHRY3.js";
-import "./chunks/chunk-7TH5NMVB.js";
+} from "./chunks/chunk-EQURFOMH.js";
+import "./chunks/chunk-XRYSCRZR.js";
 import {
   EXECUTABLE_COMMAND_ALIASES,
   applyBootstrapPagerPolicy,
@@ -35,14 +35,14 @@ import {
   parseBootstrapHelpRequest,
   parseBootstrapTypeValue,
   stripGlobalBootstrapTokens
-} from "./chunks/chunk-BVZZN2LH.js";
+} from "./chunks/chunk-T6AXEBOP.js";
 import {
   PM_CORE_COMMAND_NAMES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunks/chunk-XWGEMNBR.js";
-import "./chunks/chunk-JXAUVO6X.js";
-import "./chunks/chunk-IEEJQCZ4.js";
-import "./chunks/chunk-AIAIXG7I.js";
+} from "./chunks/chunk-RAHINBVP.js";
+import "./chunks/chunk-6KRFL33E.js";
+import "./chunks/chunk-3W2HJKJX.js";
+import "./chunks/chunk-AJHYQCBJ.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -90,7 +90,7 @@ import {
   setActiveExtensionServices,
   toNonEmptyStringOrUndefined,
   writeSettings
-} from "./chunks/chunk-7NSPKJUS.js";
+} from "./chunks/chunk-KHVGM5CS.js";
 
 // dist/cli/main.js
 import { Command } from "commander";
@@ -1923,7 +1923,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] = "594fd898-5ce1-5e77-8731-5bcd90c16f9a");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "8fc55c5b-a16f-5087-814e-4c58f90d7f1a");
   } catch (e2) {
   }
 })();
@@ -2198,13 +2198,16 @@ function buildFallbackTitleFromMessage(message) {
   }
   return `${firstLine.slice(0, 117)}...`;
 }
+function normalizeContextValue(value, fallback) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : fallback;
+}
 function applyPmCliErrorContext(guidance, rawMessage, context) {
   if (!context) {
     return guidance;
   }
   const normalizedRawMessage = normalizeMessage(rawMessage);
-  const code = typeof context.code === "string" && context.code.trim().length > 0 ? context.code.trim() : guidance.code;
-  const type = typeof context.type === "string" && context.type.trim().length > 0 ? context.type.trim() : errorType(code);
+  const code = normalizeContextValue(context.code, guidance.code);
+  const type = normalizeContextValue(context.type, errorType(code));
   const examples = normalizeContextList(context.examples) ?? guidance.examples;
   const nextSteps = normalizeContextList(context.nextSteps) ?? guidance.nextSteps;
   const fallbackTitle = guidance.code === "command_failed" && context.code ? buildFallbackTitleFromMessage(normalizedRawMessage) : void 0;
@@ -2215,8 +2218,8 @@ function applyPmCliErrorContext(guidance, rawMessage, context) {
     type,
     title: fallbackTitle ?? guidance.title,
     happened: normalizedRawMessage.length > 0 ? normalizedRawMessage : guidance.happened,
-    required: typeof context.required === "string" && context.required.trim().length > 0 ? context.required.trim() : guidance.required,
-    why: typeof context.why === "string" && context.why.trim().length > 0 ? context.why.trim() : guidance.why,
+    required: normalizeContextValue(context.required, guidance.required),
+    why: normalizeContextValue(context.why, guidance.why),
     examples,
     nextSteps,
     recovery
@@ -2743,7 +2746,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] = "c2d84713-bde8-5ed0-9975-41d50fb0be76");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "f4bd09b9-2429-5af4-9f71-f2a7fe58f0d1");
   } catch (e2) {
   }
 })();
@@ -2862,7 +2865,7 @@ function normalizeExtensionCommandArguments(values) {
     return normalized;
   }).filter((entry) => entry !== null);
 }
-function collectExtensionCommandHelpDescriptors(commandHandlers, commandDefinitions, flagRegistrations) {
+function collectExtensionDefinitionsByCommand(commandDefinitions) {
   const definitionsByCommand = /* @__PURE__ */ new Map();
   for (const definition of commandDefinitions) {
     const commandPath = normalizeExtensionCommandPath(definition.command);
@@ -2887,6 +2890,9 @@ function collectExtensionCommandHelpDescriptors(commandHandlers, commandDefiniti
       }
     });
   }
+  return definitionsByCommand;
+}
+function collectExtensionFlagsByCommand(flagRegistrations) {
   const flagsByCommand = /* @__PURE__ */ new Map();
   for (const registration of flagRegistrations) {
     const commandPath = normalizeExtensionCommandPath(registration.target_command);
@@ -2897,6 +2903,9 @@ function collectExtensionCommandHelpDescriptors(commandHandlers, commandDefiniti
     existing.push(...registration.flags);
     flagsByCommand.set(commandPath, existing);
   }
+  return flagsByCommand;
+}
+function collectExtensionHelpCommandSet(commandHandlers, definitionsByCommand, flagsByCommand) {
   const commandSet = /* @__PURE__ */ new Set();
   for (const commandPath of commandHandlers) {
     const normalized = normalizeExtensionCommandPath(commandPath);
@@ -2910,6 +2919,12 @@ function collectExtensionCommandHelpDescriptors(commandHandlers, commandDefiniti
   for (const commandPath of flagsByCommand.keys()) {
     commandSet.add(commandPath);
   }
+  return commandSet;
+}
+function collectExtensionCommandHelpDescriptors(commandHandlers, commandDefinitions, flagRegistrations) {
+  const definitionsByCommand = collectExtensionDefinitionsByCommand(commandDefinitions);
+  const flagsByCommand = collectExtensionFlagsByCommand(flagRegistrations);
+  const commandSet = collectExtensionHelpCommandSet(commandHandlers, definitionsByCommand, flagsByCommand);
   const descriptors = /* @__PURE__ */ new Map();
   const sortedCommands = [...commandSet].sort((left, right) => left.localeCompare(right));
   for (const commandPath of sortedCommands) {
@@ -2945,7 +2960,7 @@ function applyDynamicExtensionArguments(command, descriptor) {
     command.argument(buildExtensionArgumentToken(argument), argument.description ?? "Extension argument.");
   }
 }
-function formatDynamicExtensionOptionFlags(definition) {
+function normalizeDynamicExtensionOptionNames(definition) {
   const visible = toOptionalBoolean(definition.visible);
   if (visible === false) {
     return null;
@@ -2954,31 +2969,27 @@ function formatDynamicExtensionOptionFlags(definition) {
   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) {
+  const optionNames = [normalizedShort, normalizedLong].filter((entry) => entry !== null);
+  return optionNames.length > 0 ? optionNames : null;
+}
+function formatDynamicExtensionOptionFlags(definition) {
+  const optionNames = normalizeDynamicExtensionOptionNames(definition);
+  if (!optionNames) {
     return null;
   }
   const optionValueName = toNonEmptyFlagString(definition.value_name);
   const optionValueSuffix = optionValueName ? ` <${optionValueName}>` : "";
-  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) {
+  const optionNames = normalizeDynamicExtensionOptionNames(definition);
+  if (!optionNames) {
     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) {
@@ -3281,7 +3292,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] = "66620fd2-4f5f-5930-a9e1-0497672abda9");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "7d27d900-2792-5dba-95dc-262d72ce028e");
   } catch (e2) {
   }
 })();
@@ -3564,22 +3575,9 @@ function rewriteUnknownOptionArgv(argv, unknownOption, replacementFlag) {
   }
   return void 0;
 }
-function buildUnknownCommandGuidanceFromRuntime(rawMessage, root, extensionDescriptors) {
-  const unknownCommandMatch = rawMessage.match(/unknown command '([^']+)'/i);
-  if (!unknownCommandMatch || typeof unknownCommandMatch[1] !== "string") {
-    return void 0;
-  }
-  const normalizedUnknown = normalizeHelpCommandPath(unknownCommandMatch[1]);
-  if (normalizedUnknown.length === 0) {
-    return void 0;
-  }
-  const commandPaths = collectRuntimeCommandPaths(root, extensionDescriptors);
-  if (commandPaths.length === 0) {
-    return void 0;
-  }
-  const primaryToken = normalizedUnknown.split(" ")[0];
-  const commandPathSet = new Set(commandPaths);
-  const scoreAgainstUnknown = (candidatePath) => Math.min(scoreCommandPathMatch(candidatePath, normalizedUnknown), primaryToken !== normalizedUnknown ? scoreCommandPathMatch(candidatePath, primaryToken) : Number.POSITIVE_INFINITY);
+function scoreRuntimeCommandCandidates(params) {
+  const commandPathSet = new Set(params.commandPaths);
+  const scoreAgainstUnknown = (candidatePath) => Math.min(scoreCommandPathMatch(candidatePath, params.normalizedUnknown), params.primaryToken !== params.normalizedUnknown ? scoreCommandPathMatch(candidatePath, params.primaryToken) : Number.POSITIVE_INFINITY);
   const scoresByCommandPath = /* @__PURE__ */ new Map();
   const recordCandidateScore = (commandPath, score) => {
     if (!Number.isFinite(score) || !commandPathSet.has(commandPath)) {
@@ -3590,22 +3588,55 @@ function buildUnknownCommandGuidanceFromRuntime(rawMessage, root, extensionDescr
       scoresByCommandPath.set(commandPath, score);
     }
   };
-  for (const commandPath of commandPaths) {
+  for (const commandPath of params.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([...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);
+  return [...scoresByCommandPath.entries()].sort(([leftPath, leftScore], [rightPath, rightScore]) => leftScore !== rightScore ? leftScore - rightScore : leftPath.localeCompare(rightPath)).map(([commandPath]) => commandPath);
+}
+function resolveUnknownCommandCandidates(params) {
+  const rankedCandidates = scoreRuntimeCommandCandidates(params);
+  const installedPackageCandidates = collectInstalledPackageCommandPathHints(params.primaryToken, params.extensionDescriptors).filter((commandPath) => params.commandPaths.includes(commandPath));
+  return dedupeStrings2([...rankedCandidates, ...installedPackageCandidates]);
+}
+function resolveUnknownCommandFallbacks(commandPaths) {
+  const topLevel = [...new Set(commandPaths.map((commandPath) => commandPath.split(" ")[0]).filter((segment) => segment.length > 0))];
+  return topLevel.sort((left, right) => left.localeCompare(right));
+}
+function buildUnknownCommandExamples(suggestedPaths, hasConcreteCandidates) {
   const suggestedExamples = suggestedPaths.map((path) => `pm ${path} --help`);
-  const examples = combinedCandidates.length > 0 ? [.../* @__PURE__ */ new Set([...suggestedExamples, "pm --help"])] : [.../* @__PURE__ */ new Set(["pm --help", ...suggestedExamples])];
+  if (hasConcreteCandidates) {
+    return [.../* @__PURE__ */ new Set([...suggestedExamples, "pm --help"])];
+  }
+  return [.../* @__PURE__ */ new Set(["pm --help", ...suggestedExamples])];
+}
+function buildUnknownCommandGuidanceFromRuntime(rawMessage, root, extensionDescriptors) {
+  const unknownCommandMatch = rawMessage.match(/unknown command '([^']+)'/i);
+  if (!unknownCommandMatch || typeof unknownCommandMatch[1] !== "string") {
+    return void 0;
+  }
+  const normalizedUnknown = normalizeHelpCommandPath(unknownCommandMatch[1]);
+  if (normalizedUnknown.length === 0) {
+    return void 0;
+  }
+  const commandPaths = collectRuntimeCommandPaths(root, extensionDescriptors);
+  if (commandPaths.length === 0) {
+    return void 0;
+  }
+  const primaryToken = normalizedUnknown.split(" ")[0];
+  const combinedCandidates = resolveUnknownCommandCandidates({
+    commandPaths,
+    normalizedUnknown,
+    primaryToken,
+    extensionDescriptors
+  });
+  const fallbackTopLevel = resolveUnknownCommandFallbacks(commandPaths);
+  const suggestedPaths = (combinedCandidates.length > 0 ? combinedCandidates : fallbackTopLevel).slice(0, 3);
+  const examples = buildUnknownCommandExamples(suggestedPaths, combinedCandidates.length > 0);
   const optionalPackageHint = resolveOptionalPackageInstallHint(normalizedUnknown);
-  const didYouMean = combinedCandidates.length > 0 ? `Did you mean: ${combinedCandidates.slice(0, 3).join(", ")}?` : null;
+  const didYouMean = combinedCandidates.length > 0 ? `Did you mean: ${suggestedPaths.join(", ")}?` : null;
   return {
     unknownCommandExamples: examples,
     unknownCommandNextSteps: [
@@ -3775,7 +3806,7 @@ async function formatCommanderUsageJson(error, rootProgram, extensionDescriptors
 !(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] = "913c0a00-924f-520e-adb6-4073fdb73413");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "4daddb64-a9f8-5131-92be-05d37fd24cf8");
   } catch (e2) {
   }
 })();
@@ -3908,20 +3939,26 @@ function buildHelpSubcommandSummaries(command) {
     description: entry.description().trim()
   })).sort((left, right) => left.name.localeCompare(right.name));
 }
+function buildJsonHelpNarrative(detailMode, fallbackNarrative, extensionDescriptor) {
+  if (!extensionDescriptor) {
+    return fallbackNarrative;
+  }
+  const extensionExamples = extensionDescriptor.examples ?? [];
+  const extensionFailureHints = extensionDescriptor.failure_hints ?? [];
+  return {
+    intent: extensionDescriptor.intent ?? extensionDescriptor.description ?? fallbackNarrative.intent,
+    examples: detailMode === "detailed" ? extensionExamples.length > 0 ? [...extensionExamples] : [...fallbackNarrative.examples] : extensionExamples.length > 0 ? [extensionExamples[0]] : [...fallbackNarrative.examples],
+    tips: detailMode === "detailed" ? extensionFailureHints.length > 0 ? [...extensionFailureHints] : [...fallbackNarrative.tips] : [],
+    detail_mode: detailMode
+  };
+}
 function buildJsonHelpPayload(rootProgram, targetCommand, argv, requestedPath, extensionDescriptors) {
   const detailMode = resolveHelpDetailMode(argv);
   const resolvedPath = normalizeHelpCommandPath(getCommandPath(targetCommand));
   const commandPath = resolvedPath.length > 0 ? resolvedPath : void 0;
   const fallbackNarrative = resolveHelpNarrative(commandPath, detailMode);
   const extensionDescriptor = commandPath ? extensionDescriptors.get(commandPath) : void 0;
-  const extensionExamples = extensionDescriptor?.examples ?? [];
-  const extensionFailureHints = extensionDescriptor?.failure_hints ?? [];
-  const narrative = extensionDescriptor ? {
-    intent: extensionDescriptor.intent ?? extensionDescriptor.description ?? fallbackNarrative.intent,
-    examples: detailMode === "detailed" ? extensionExamples.length > 0 ? [...extensionExamples] : [...fallbackNarrative.examples] : extensionExamples.length > 0 ? [extensionExamples[0]] : [...fallbackNarrative.examples],
-    tips: detailMode === "detailed" ? extensionFailureHints.length > 0 ? [...extensionFailureHints] : [...fallbackNarrative.tips] : [],
-    detail_mode: detailMode
-  } : fallbackNarrative;
+  const narrative = buildJsonHelpNarrative(detailMode, fallbackNarrative, extensionDescriptor);
   const optionSummaries = compactHelpOptionAliases(mergeHelpOptionSummaries(buildHelpOptionSummaries(targetCommand), buildDynamicExtensionHelpOptionSummaries(extensionDescriptor)));
   const subcommands = buildHelpSubcommandSummaries(targetCommand);
   return {
@@ -3974,20 +4011,39 @@ async function maybeRenderBootstrapJsonHelp(rootProgram, argv, extensionDescript
   process.exitCode = EXIT_CODE.SUCCESS;
   return true;
 }
+function buildCreateUpdatePolicyIntro(commandName, typeRegistry) {
+  const lines = [
+    "",
+    "Type-aware option policies:",
+    "  pass --type <value> with --help to render required/disabled/hidden option policy details for that type.",
+    `  active type values: ${typeRegistry.types.join("|")}`
+  ];
+  if (commandName === "create") {
+    lines.push("  scheduling shortcut: use --schedule-preset lightweight for Reminder/Meeting/Event minimal create flows.");
+  }
+  return lines.join("\n");
+}
+function appendTypeOptionHelpLines(lines, typeDefinition) {
+  if (typeDefinition.options.length === 0) {
+    lines.push("  type options: none");
+    return;
+  }
+  lines.push("  type options:");
+  for (const option of typeDefinition.options) {
+    const requiredLabel = option.required ? " (required)" : "";
+    const aliases = option.aliases ?? [];
+    lines.push(`    - ${option.key}${requiredLabel}`);
+    lines.push(`      values: ${option.values.length > 0 ? option.values.join("|") : "any non-empty string"}`);
+    lines.push(`      aliases: ${aliases.length > 0 ? aliases.join("|") : "none"}`);
+    if (option.description && option.description.trim().length > 0) {
+      lines.push(`      description: ${option.description.trim()}`);
+    }
+  }
+}
 function buildCreateUpdatePolicyHelpText(commandName, typeRegistry, argv) {
   const selectedTypeRaw = parseBootstrapTypeValue(argv);
   if (!selectedTypeRaw) {
-    const allowed = typeRegistry.types.join("|");
-    const lines2 = [
-      "",
-      "Type-aware option policies:",
-      "  pass --type <value> with --help to render required/disabled/hidden option policy details for that type.",
-      `  active type values: ${allowed}`
-    ];
-    if (commandName === "create") {
-      lines2.push("  scheduling shortcut: use --schedule-preset lightweight for Reminder/Meeting/Event minimal create flows.");
-    }
-    return lines2.join("\n");
+    return buildCreateUpdatePolicyIntro(commandName, typeRegistry);
   }
   const typeDefinition = resolveTypeDefinition(selectedTypeRaw, typeRegistry);
   if (!typeDefinition) {
@@ -4012,21 +4068,7 @@ function buildCreateUpdatePolicyHelpText(commandName, typeRegistry, argv) {
     lines.push("  schedule preset: --schedule-preset lightweight switches schedule artifacts to progressive required-option policy.");
     lines.push("  strict parity remains available via --create-mode strict.");
   }
-  if (typeDefinition.options.length === 0) {
-    lines.push("  type options: none");
-  } else {
-    lines.push("  type options:");
-    for (const option of typeDefinition.options) {
-      const requiredLabel = option.required ? " (required)" : "";
-      const aliases = option.aliases ?? [];
-      lines.push(`    - ${option.key}${requiredLabel}`);
-      lines.push(`      values: ${option.values.length > 0 ? option.values.join("|") : "any non-empty string"}`);
-      lines.push(`      aliases: ${aliases.length > 0 ? aliases.join("|") : "none"}`);
-      if (option.description && option.description.trim().length > 0) {
-        lines.push(`      description: ${option.description.trim()}`);
-      }
-    }
-  }
+  appendTypeOptionHelpLines(lines, typeDefinition);
   if (policyState.errors.length > 0) {
     lines.push(`  config errors: ${policyState.errors.join("; ")}`);
   }
@@ -4048,7 +4090,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] = "a367900b-1ec4-5110-9997-7f0a02e315c0");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "aa682568-77f6-5659-a6dd-3a69dd4e1fc0");
   } catch (e2) {
   }
 })();
@@ -4093,10 +4135,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-ZCGKHDKL.js"));
-var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-XN4ZRHSV.js"));
-var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-KRLAHEL2.js"));
-var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-4PASGJDB.js"));
+var loadSetupRegistrationModule = createLazyModule(() => import("./chunks/register-setup-3QJY43CY.js"));
+var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-ELBHCCFI.js"));
+var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-ROFE2YPC.js"));
+var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-IADFVH53.js"));
 function describeUnknownError(error) {
   if (error instanceof PmCliError) {
     return error.message;
@@ -4545,8 +4587,11 @@ function collectExtensionFlagDefinitionsForInvocation(registrations, commandPath
   }
   return nestedMatch.length > 0 ? nestedMatch : exact;
 }
+function dynamicCommandArguments(descriptor) {
+  return descriptor.arguments ?? [];
+}
 function formatDynamicCommandUsage(descriptor) {
-  const argumentSuffix = descriptor.arguments.map((argument) => {
+  const argumentSuffix = dynamicCommandArguments(descriptor).map((argument) => {
     const label = argument.variadic ? `${argument.name}...` : argument.name;
     return argument.required ? `<${label}>` : `[${label}]`;
   }).join(" ");
@@ -4560,10 +4605,12 @@ function isImporterOrExporterCommandPath(registrations, 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(" ")}` : "";
+  const descriptorArguments = dynamicCommandArguments(descriptor);
+  const requiredCount = descriptorArguments.filter((argument) => argument.required).length;
+  const variadic = descriptorArguments.some((argument) => argument.variadic);
+  const maxCount = variadic ? Number.POSITIVE_INFINITY : descriptorArguments.length;
+  const failureHints = descriptor.failure_hints ?? [];
+  const hintSuffix = failureHints.length > 0 ? ` ${failureHints.join(" ")}` : "";
   if (args.length < requiredCount) {
     throw new PmCliError(`Missing required argument for extension command '${descriptor.command}'. Usage: ${formatDynamicCommandUsage(descriptor)}${hintSuffix}`, EXIT_CODE.USAGE);
   }
@@ -5144,14 +5191,39 @@ async function runRequiredExtensionCommand(command, options, globalOptions, exte
   return extensionCommandResult.result;
 }
 var WRAPPED_ACTION_HANDLER = /* @__PURE__ */ Symbol("pm.wrappedActionHandler");
+function resolveActionCommand(actionArgs, fallback) {
+  const possibleCommand = actionArgs[actionArgs.length - 1];
+  return possibleCommand instanceof Command ? possibleCommand : fallback;
+}
+function maybePrintExtensionProfileWarnings(enabled, label, warnings) {
+  if (enabled && warnings.length > 0) {
+    printError(`profile:extensions ${label}=${formatHookWarnings(warnings)}`);
+  }
+}
+function validateDynamicInvocationArgs(params) {
+  const dynamicDescriptor = activeRuntimeExtensionCommandDescriptors.get(normalizeExtensionCommandPath(params.commandPath));
+  if (!dynamicDescriptor || !isImporterOrExporterCommandPath(params.activeRegistrations, params.commandPath)) {
+    return;
+  }
+  const positionalArgs = dynamicCommandArguments(dynamicDescriptor).length === 0 ? collectLoosePositionalArgs(params.commandArgs) : stripLooseCommandOptionTokens(params.commandArgs, params.extensionFlagDefinitions);
+  validateDynamicExtensionCommandArgs(dynamicDescriptor, positionalArgs);
+}
+function syncCommanderActionArgs(actionCommand, actionArgs, commandArgs) {
+  actionCommand.args = [...commandArgs];
+  if ("_processArguments" in actionCommand && typeof actionCommand._processArguments === "function") {
+    actionCommand._processArguments();
+  }
+  if (actionArgs.length > 0 && Array.isArray(actionArgs[0])) {
+    actionArgs[0] = [...actionCommand.processedArgs];
+  }
+}
 function wrapProgramActionsForExtensionHandlers(rootProgram) {
   const visit = (entry) => {
     const actionEntry = entry;
     if (typeof actionEntry._actionHandler === "function" && actionEntry[WRAPPED_ACTION_HANDLER] !== true) {
       const originalAction = actionEntry._actionHandler;
       actionEntry._actionHandler = async function wrappedActionHandler(...actionArgs) {
-        const possibleCommand = actionArgs[actionArgs.length - 1];
-        const actionCommand = possibleCommand instanceof Command ? possibleCommand : entry;
+        const actionCommand = resolveActionCommand(actionArgs, entry);
         const startedAt = Date.now();
         clearResolvedGlobalOptions(actionCommand);
         let globalOptions = getGlobalOptions(actionCommand);
@@ -5172,26 +5244,14 @@ function wrapProgramActionsForExtensionHandlers(rootProgram) {
           global: globalOptions,
           pm_root: pmRoot
         });
-        if (globalOptions.profile && parserOverride.warnings.length > 0) {
-          printError(`profile:extensions parser_warnings=${formatHookWarnings(parserOverride.warnings)}`);
-        }
+        maybePrintExtensionProfileWarnings(globalOptions.profile, "parser_warnings", parserOverride.warnings);
         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);
-        }
+        validateDynamicInvocationArgs({ activeRegistrations, commandPath, commandArgs, extensionFlagDefinitions });
         globalOptions = await applyDefaultOutputFormat(globalOptions);
         setResolvedGlobalOptions(actionCommand, globalOptions);
-        actionCommand.args = [...commandArgs];
-        if ("_processArguments" in actionCommand && typeof actionCommand._processArguments === "function") {
-          actionCommand._processArguments();
-        }
-        if (actionArgs.length > 0 && Array.isArray(actionArgs[0])) {
-          actionArgs[0] = [...actionCommand.processedArgs];
-        }
+        syncCommanderActionArgs(actionCommand, actionArgs, commandArgs);
         for (const [key, value] of Object.entries(commandOptions)) {
           actionCommand.setOptionValueWithSource(key, value, "cli");
         }
@@ -5210,9 +5270,7 @@ function wrapProgramActionsForExtensionHandlers(rootProgram) {
           global: globalOptions,
           pm_root: pmRoot
         });
-        if (globalOptions.profile && extensionCommandResult.warnings.length > 0) {
-          printError(`profile:extensions command_handler_warnings=${formatHookWarnings(extensionCommandResult.warnings)}`);
-        }
+        maybePrintExtensionProfileWarnings(globalOptions.profile, "command_handler_warnings", extensionCommandResult.warnings);
         if (extensionCommandResult.handled) {
           setActiveCommandResult(extensionCommandResult.result);
           printResult(extensionCommandResult.result, {