@unbrained/pm-cli 2026.7.3 → 2026.7.5

package/dist/cli-bundle/main.js

@@ -5,10 +5,7 @@ import {
   emitTelemetryErrorEvent,
   finishTelemetryCommand,
   startTelemetryCommand
-} from "./chunks/chunk-ER4ME5U2.js";
-import {
-  migrateItemFilesToFormat
-} from "./chunks/chunk-5IZUBZBR.js";
+} from "./chunks/chunk-QHZO65XW.js";
 import {
   applyDefaultOutputFormat,
   clearResolvedGlobalOptions,
@@ -18,13 +15,13 @@ import {
   getGlobalOptions,
   invalidateSearchCachesForMutation,
   setResolvedGlobalOptions
-} from "./chunks/chunk-HB4FAT3O.js";
+} from "./chunks/chunk-4LRVSBO6.js";
+import "./chunks/chunk-LEKT4K7I.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunks/chunk-EQURFOMH.js";
-import "./chunks/chunk-XRYSCRZR.js";
+} from "./chunks/chunk-ZD34OFFQ.js";
 import {
   EXECUTABLE_COMMAND_ALIASES,
   applyBootstrapPagerPolicy,
@@ -35,34 +32,54 @@ import {
   parseBootstrapHelpRequest,
   parseBootstrapTypeValue,
   stripGlobalBootstrapTokens
-} from "./chunks/chunk-T6AXEBOP.js";
+} from "./chunks/chunk-R3ZBLGTC.js";
 import {
   PM_CORE_COMMAND_NAMES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunks/chunk-RAHINBVP.js";
-import "./chunks/chunk-6KRFL33E.js";
-import "./chunks/chunk-3W2HJKJX.js";
-import "./chunks/chunk-AJHYQCBJ.js";
+} from "./chunks/chunk-UI5BJ6DO.js";
+import "./chunks/chunk-3U3VEWK6.js";
+import {
+  migrateItemFilesToFormat
+} from "./chunks/chunk-HJE4JTKQ.js";
+import "./chunks/chunk-EZFKWSC7.js";
+import "./chunks/chunk-DRBV5UC2.js";
+import {
+  PmCliError,
+  clearActiveExtensionHooks,
+  consumeAfterCommandAffectedItems,
+  getActiveCommandResult,
+  getActiveExtensionRegistrations,
+  readSettings,
+  readSettingsWithMetadata,
+  runActiveCommandHandler,
+  runActiveParserOverride,
+  runActivePreflightOverride,
+  runActiveServiceOverride,
+  setActiveCommandContext,
+  setActiveCommandResult,
+  setActiveExtensionCommands,
+  setActiveExtensionHooks,
+  setActiveExtensionParsers,
+  setActiveExtensionPreflight,
+  setActiveExtensionRegistrations,
+  setActiveExtensionRenderers,
+  setActiveExtensionServices,
+  writeSettings
+} from "./chunks/chunk-P5YORJRH.js";
+import "./chunks/chunk-7C2O74AE.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
-  PmCliError,
   activateExtensions,
   asRecordOrNull,
-  clearActiveExtensionHooks,
   commandOptionFlagLabel,
-  consumeAfterCommandAffectedItems,
   createEmptyExtensionRegistrationRegistry,
   discoverExtensions,
   flattenFlagListValue,
-  getActiveCommandResult,
-  getActiveExtensionRegistrations,
   getSettingsPath,
   levenshteinDistanceWithinLimit,
   loadExtensions,
   pathExists,
-  readSettings,
-  readSettingsWithMetadata,
   resolveCommandOptionPolicyState,
   resolveFlagValueKind,
   resolveGlobalPmRoot,
@@ -73,24 +90,10 @@ import {
   resolveRuntimeFieldRegistry,
   resolveTelemetryErrorCategory,
   resolveTypeDefinition,
-  runActiveCommandHandler,
-  runActiveParserOverride,
-  runActivePreflightOverride,
-  runActiveServiceOverride,
   runAfterCommandHooks,
   runBeforeCommandHooks,
-  setActiveCommandContext,
-  setActiveCommandResult,
-  setActiveExtensionCommands,
-  setActiveExtensionHooks,
-  setActiveExtensionParsers,
-  setActiveExtensionPreflight,
-  setActiveExtensionRegistrations,
-  setActiveExtensionRenderers,
-  setActiveExtensionServices,
-  toNonEmptyStringOrUndefined,
-  writeSettings
-} from "./chunks/chunk-KHVGM5CS.js";
+  toNonEmptyStringOrUndefined
+} from "./chunks/chunk-5VVUKE3U.js";
 
 // dist/cli/main.js
 import { Command } from "commander";
@@ -1923,7 +1926,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] = "8fc55c5b-a16f-5087-814e-4c58f90d7f1a");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "dafcc170-702f-518f-9f33-985aabc58b54");
   } catch (e2) {
   }
 })();
@@ -1954,11 +1957,36 @@ function makeGuidanceMessage(params) {
     type: errorType(params.code)
   };
 }
+var GUIDE_SHELL_HINT = {
+  packageName: "@unbrained/pm-guide-shell",
+  installCommand: "pm install guide-shell"
+};
+var CALENDAR_HINT = { packageName: "@unbrained/pm-calendar", installCommand: "pm install calendar" };
+var GOVERNANCE_AUDIT_HINT = {
+  packageName: "@unbrained/pm-governance-audit",
+  installCommand: "pm install governance-audit"
+};
+var SEARCH_ADVANCED_HINT = {
+  packageName: "@unbrained/pm-search-advanced",
+  installCommand: "pm install search-advanced"
+};
 var KNOWN_PACKAGE_COMMAND_HINTS = {
-  guide: { packageName: "@unbrained/pm-guide-shell", installCommand: "pm install guide-shell" },
+  guide: GUIDE_SHELL_HINT,
+  shell: GUIDE_SHELL_HINT,
+  completion: GUIDE_SHELL_HINT,
+  "completion-statuses": GUIDE_SHELL_HINT,
+  "completion-tags": GUIDE_SHELL_HINT,
+  "completion-types": GUIDE_SHELL_HINT,
   templates: { packageName: "@unbrained/pm-templates", installCommand: "pm install templates" },
-  calendar: { packageName: "@unbrained/pm-calendar", installCommand: "pm install calendar" },
-  cal: { packageName: "@unbrained/pm-calendar", installCommand: "pm install calendar" }
+  calendar: CALENDAR_HINT,
+  cal: CALENDAR_HINT,
+  "comments-audit": GOVERNANCE_AUDIT_HINT,
+  "dedupe-audit": GOVERNANCE_AUDIT_HINT,
+  "dedupe-merge": GOVERNANCE_AUDIT_HINT,
+  normalize: GOVERNANCE_AUDIT_HINT,
+  reindex: SEARCH_ADVANCED_HINT,
+  "search-advanced": SEARCH_ADVANCED_HINT,
+  "test-runs": { packageName: "@unbrained/pm-linked-test-adapters", installCommand: "pm install linked-test-adapters" }
 };
 function resolveKnownPackageCommandHint(commandToken) {
   const primary = commandToken.trim().split(/\s+/)[0]?.toLowerCase();
@@ -2017,6 +2045,9 @@ function normalizeRecoveryPayload(payload) {
   assignRecoveryStringArray(normalized, "missing_required_fields", payload.missing_required_fields);
   assignRecoveryStringArray(normalized, "suggested_flags", payload.suggested_flags);
   assignRecoveryString(normalized, "suggested_retry", payload.suggested_retry);
+  if (typeof payload.retry_after_ms === "number" && Number.isSafeInteger(payload.retry_after_ms) && payload.retry_after_ms >= 0) {
+    normalized.retry_after_ms = payload.retry_after_ms;
+  }
   const fallbackCandidates = normalizeRecoveryCandidates(payload.fallback_candidates);
   if (fallbackCandidates) {
     normalized.fallback_candidates = fallbackCandidates;
@@ -2047,6 +2078,9 @@ function renderRecoveryBundle(recovery) {
   appendRecoveryListLine(lines, "missing_required_fields", normalized.missing_required_fields, ", ");
   appendRecoveryListLine(lines, "suggested_flags", normalized.suggested_flags, ", ");
   appendRecoveryTextLine(lines, "suggested_retry", normalized.suggested_retry);
+  if (typeof normalized.retry_after_ms === "number") {
+    lines.push(`  retry_after_ms: ${normalized.retry_after_ms}`);
+  }
   appendRecoveryTextLine(lines, "next_best_command", normalized.next_best_command);
   if (normalized.fallback_candidates && normalized.fallback_candidates.length > 0) {
     lines.push("  fallback_candidates:");
@@ -2592,6 +2626,7 @@ function buildUnknownOptionGuidance(message, commandName, context) {
 }
 function buildKnownPackageCommandGuidance(commandToken, packageHint, baseExamples, baseNextSteps, context) {
   const installStep = `"${commandToken}" is provided by the ${packageHint.packageName} package. Install it with: ${packageHint.installCommand}`;
+  const nextSteps = baseNextSteps.filter((step) => !step.endsWith(`: ${packageHint.installCommand}`));
   return makeGuidanceMessage({
     code: "unknown_command",
     title: `Unknown command ${commandToken}`,
@@ -2599,7 +2634,7 @@ function buildKnownPackageCommandGuidance(commandToken, packageHint, baseExample
     required: `Install the ${packageHint.packageName} package, or use a valid command name or subcommand path.`,
     why: "Command registry includes core commands plus active extension command handlers; package-provided commands appear only after the package is installed.",
     examples: dedupeStrings([packageHint.installCommand, ...baseExamples]),
-    nextSteps: dedupeStrings([installStep, ...baseNextSteps]),
+    nextSteps: dedupeStrings([installStep, ...nextSteps]),
     recovery: buildCommanderRecoveryPayload(context)
   });
 }
@@ -2658,9 +2693,74 @@ function buildLinkedTestValueNotQuotedGuidance(message, commandName, allowedType
     recovery: buildCommanderRecoveryPayload(context, retryCommand ? { suggested_retry: retryCommand } : {})
   });
 }
+var CONTEXT_GUIDANCE_VALUE_FLAGS = /* @__PURE__ */ new Set([
+  "--activity-limit",
+  "--assignee",
+  "--assignee-filter",
+  "--date",
+  "--depth",
+  "--fields",
+  "--format",
+  "--from",
+  "--limit",
+  "--parent",
+  "--path",
+  "--pm-path",
+  "--priority",
+  "--release",
+  "--section",
+  "--sprint",
+  "--stale-threshold",
+  "--tag",
+  "--to",
+  "--type"
+]);
+var CONTEXT_GUIDANCE_COMMAND_NAMES = /* @__PURE__ */ new Set(["context", "ctx"]);
+function buildContextItemArgumentGuidance(message, commandName, context) {
+  if (!/too many arguments/i.test(message) || !CONTEXT_GUIDANCE_COMMAND_NAMES.has(commandName ?? "")) {
+    return null;
+  }
+  const argv = context?.normalizedInvocationArgs ?? [];
+  const commandIndex = argv.findIndex((token) => CONTEXT_GUIDANCE_COMMAND_NAMES.has(token));
+  const searchIndex = commandIndex === -1 ? 1 : commandIndex + 1;
+  const match = message.match(/got \d+:\s*(\S+)/i);
+  let positional = match ? match[1].replace(/\.$/, "") : void 0;
+  if (positional === void 0) {
+    let skipFlagValue = false;
+    for (const token of argv.slice(searchIndex)) {
+      if (skipFlagValue) {
+        skipFlagValue = false;
+        continue;
+      }
+      const flagName = token.split("=")[0];
+      if (CONTEXT_GUIDANCE_VALUE_FLAGS.has(flagName)) {
+        skipFlagValue = !token.includes("=");
+        continue;
+      }
+      if (token.startsWith("-")) {
+        continue;
+      }
+      positional = token;
+      break;
+    }
+  }
+  if (!positional) {
+    return null;
+  }
+  const getCommand = `pm get ${positional}`;
+  return makeGuidanceMessage({
+    code: "context_takes_no_item_argument",
+    title: "pm context takes no item argument",
+    happened: `pm context renders a workspace-level snapshot and received the positional argument "${positional}".`,
+    required: `Use ${getCommand} for one item's full details, or pm context --parent ${positional} to scope the snapshot to that item's subtree.`,
+    why: "Item-level detail (pm get) and workspace-level context (pm context) are separate projections.",
+    examples: [getCommand, `pm context --parent ${positional}`],
+    recovery: buildCommanderRecoveryPayload(context, { suggested_retry: getCommand })
+  });
+}
 function buildCommanderErrorGuidance(rawMessage, commandName, allowedTypes, context) {
   const message = normalizeMessage(rawMessage);
-  const guidance = buildMissingRequiredOptionGuidance(message, commandName, allowedTypes, context) ?? buildMissingRequiredArgumentGuidance(message, commandName, context) ?? buildUnknownOptionGuidance(message, commandName, context) ?? buildUnknownCommandGuidance(message, context) ?? buildLinkedTestValueNotQuotedGuidance(message, commandName, allowedTypes, context);
+  const guidance = buildMissingRequiredOptionGuidance(message, commandName, allowedTypes, context) ?? buildMissingRequiredArgumentGuidance(message, commandName, context) ?? buildUnknownOptionGuidance(message, commandName, context) ?? buildUnknownCommandGuidance(message, context) ?? buildLinkedTestValueNotQuotedGuidance(message, commandName, allowedTypes, context) ?? buildContextItemArgumentGuidance(message, commandName, context);
   if (guidance) {
     return guidance;
   }
@@ -4090,7 +4190,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] = "aa682568-77f6-5659-a6dd-3a69dd4e1fc0");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "00190dcf-504a-528b-906c-5eeb9a11ce9c");
   } catch (e2) {
   }
 })();
@@ -4135,10 +4235,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-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"));
+var loadSetupRegistrationModule = createLazyModule(() => import("./chunks/register-setup-K6U3NVY5.js"));
+var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-5H66WFYF.js"));
+var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-Z2ETYHKS.js"));
+var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-SG7HBSUP.js"));
 function describeUnknownError(error) {
   if (error instanceof PmCliError) {
     return error.message;
@@ -4786,8 +4886,8 @@ function defaultPreflightDecision() {
     enforce_mandatory_migration_gate: true
   };
 }
-function buildRuntimeExtensionSnapshotCacheKey(pmRoot) {
-  return `pm-root:${pmRoot}`;
+function buildRuntimeExtensionSnapshotCacheKey(pmRoot, activationScope = "all") {
+  return activationScope === "all" ? `pm-root:${pmRoot}` : `pm-root:${pmRoot}:activation:${activationScope}`;
 }
 function bootstrapProfileEnabled(invocationArgv) {
   return invocationArgv.some((token) => token === "--profile");
@@ -4891,15 +4991,15 @@ function extensionNeedsActivationForProbe(extension, probe) {
   if (commands.some((command) => activationCommandMatchesProbe(command, probe))) {
     return true;
   }
-  if (hasAnyCapability(capabilities, GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES)) {
-    return true;
-  }
   if (commandPathNeedsTemplateExtensions(probe) && extensionProvidesTemplatesRuntime(commands)) {
     return true;
   }
   if (capabilities.has("search") && commandPathNeedsSearchExtensions(probe.commandPath)) {
     return true;
   }
+  if (hasAnyCapability(capabilities, GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES)) {
+    return true;
+  }
   if (commands.length > 0) {
     return false;
   }
@@ -4921,6 +5021,18 @@ function discoveryNeedsActivationForProbe(discovery, probe) {
   }
   return discovery.effective.some((extension) => extensionNeedsActivationForProbe(extension, probe));
 }
+function buildRuntimeExtensionActivationScope(probe) {
+  const commandPath = collectActivationCommandCandidates(probe).filter((candidate) => candidate.split(" ").every((part) => !part.startsWith("-"))).sort((left, right) => right.length - left.length)[0] ?? normalizeExtensionCommandPath(probe.commandPath ?? "");
+  if (commandPath.length === 0) {
+    return "all";
+  }
+  const args = commandPathNeedsTemplateExtensions(probe) ? "--template" : "";
+  const prefix = probe.allowCommandPrefixMatch === true ? "prefix" : "exact";
+  return `${prefix}:${commandPath}:${args}`;
+}
+function buildRuntimeExtensionFilterForProbe(probe) {
+  return buildRuntimeExtensionActivationScope(probe) === "all" ? void 0 : (extension) => extensionNeedsActivationForProbe(extension, probe);
+}
 function buildBootstrapActivationProbe(invocationArgv) {
   const helpRequest = parseBootstrapHelpRequest(invocationArgv);
   if (helpRequest.requested && helpRequest.commandPathTokens.length > 0) {
@@ -5010,8 +5122,9 @@ async function loadRuntimeExtensionDiscoverySnapshot(pmRoot) {
     return null;
   }
 }
-async function loadRuntimeExtensionSnapshot(pmRoot) {
-  const cacheKey = buildRuntimeExtensionSnapshotCacheKey(pmRoot);
+async function loadRuntimeExtensionSnapshot(pmRoot, probe) {
+  const activationScope = probe ? buildRuntimeExtensionActivationScope(probe) : "all";
+  const cacheKey = buildRuntimeExtensionSnapshotCacheKey(pmRoot, activationScope);
   if (runtimeExtensionSnapshotCache?.key === cacheKey) {
     return runtimeExtensionSnapshotCache.snapshot;
   }
@@ -5021,7 +5134,8 @@ async function loadRuntimeExtensionSnapshot(pmRoot) {
       pmRoot,
       settings,
       cwd: process.cwd(),
-      noExtensions: false
+      noExtensions: false,
+      extensionFilter: probe ? buildRuntimeExtensionFilterForProbe(probe) : void 0
     });
     const activationResult = await activateExtensions({
       ...loadResult,
@@ -5085,7 +5199,7 @@ async function maybeLoadRuntimeExtensions(command) {
     emitExtensionSkippedProfile(globalOptions.profile, discoverySnapshot, probe);
     return null;
   }
-  const snapshot = await loadRuntimeExtensionSnapshot(pmRoot);
+  const snapshot = await loadRuntimeExtensionSnapshot(pmRoot, probe);
   if (!snapshot) {
     return null;
   }
@@ -5343,7 +5457,7 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
     emitExtensionSkippedProfile(bootstrapProfileEnabled(invocationArgv), discoverySnapshot, probe);
     return;
   }
-  const snapshot = await loadRuntimeExtensionSnapshot(pmRoot);
+  const snapshot = await loadRuntimeExtensionSnapshot(pmRoot, probe);
   if (!snapshot) {
     await clearDynamicExtensionCommandState({
       rootProgram,
@@ -5825,7 +5939,7 @@ async function prepareExtensionServicesForRunPmCliError(params) {
   const bootstrapProbe = buildBootstrapActivationProbe(params.invocationArgv);
   const discoverySnapshot = await loadRuntimeExtensionDiscoverySnapshot(params.bootstrapPmRoot);
   if (discoverySnapshot && discoveryNeedsActivationForProbe(discoverySnapshot.discovery, bootstrapProbe)) {
-    const bootstrapSnapshot = await loadRuntimeExtensionSnapshot(params.bootstrapPmRoot);
+    const bootstrapSnapshot = await loadRuntimeExtensionSnapshot(params.bootstrapPmRoot, bootstrapProbe);
     setRecoveredExtensionServices(bootstrapSnapshot);
     return;
   }
@@ -6136,7 +6250,9 @@ var _testOnly = {
   buildPostActionTelemetryOutcome,
   buildPmCliRecoveryContext,
   buildRuntimeExtensionDiscoverySnapshotCacheKey,
+  buildRuntimeExtensionActivationScope,
   buildRuntimeExtensionSnapshotCacheKey,
+  buildRuntimeExtensionFilterForProbe,
   addRuntimeFieldOption,
   collectActivationCommandCandidates,
   collectExtensionFlagDefinitionsForCommand,