@unbrained/pm-cli 2026.6.24 → 2026.7.1

package/dist/cli-bundle/main.js

@@ -5,10 +5,10 @@ import {
   emitTelemetryErrorEvent,
   finishTelemetryCommand,
   startTelemetryCommand
-} from "./chunks/chunk-MEXZ5XUM.js";
+} from "./chunks/chunk-GJ326ZKX.js";
 import {
   migrateItemFilesToFormat
-} from "./chunks/chunk-SKC4UTRP.js";
+} from "./chunks/chunk-NKZAN7BD.js";
 import {
   applyDefaultOutputFormat,
   clearResolvedGlobalOptions,
@@ -18,30 +18,31 @@ import {
   getGlobalOptions,
   invalidateSearchCachesForMutation,
   setResolvedGlobalOptions
-} from "./chunks/chunk-J7I4C5ZB.js";
-import {
-  PM_CORE_COMMAND_NAMES,
-  resolveSubcommandFlagContractsForCommand
-} from "./chunks/chunk-SMXSDY7J.js";
-import "./chunks/chunk-HZF5RLKX.js";
+} from "./chunks/chunk-3J6JRJ3I.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunks/chunk-TIM4OD74.js";
+} from "./chunks/chunk-BDTISOSD.js";
+import "./chunks/chunk-4DSGXSBL.js";
 import {
-  normalizeExtensionNameForMatch
-} from "./chunks/chunk-PEL2NLQE.js";
-import "./chunks/chunk-OHDQNKJB.js";
-import "./chunks/chunk-B74BP6IS.js";
-import "./chunks/chunk-C4C3EJCJ.js";
+  EXECUTABLE_COMMAND_ALIASES,
+  applyBootstrapPagerPolicy,
+  normalizeBootstrapInvocation,
+  normalizeExtensionNameForMatch,
+  parseBootstrapCommandName,
+  parseBootstrapGlobalOptions,
+  parseBootstrapHelpRequest,
+  parseBootstrapTypeValue,
+  stripGlobalBootstrapTokens
+} from "./chunks/chunk-RH5ZBYFD.js";
 import {
-  commandOptionFlagLabel,
-  resolveCommandOptionPolicyState,
-  resolveItemTypeRegistry,
-  resolveTypeDefinition
-} from "./chunks/chunk-ZV7IQ23N.js";
-import "./chunks/chunk-I6QMJ2XT.js";
+  PM_CORE_COMMAND_NAMES,
+  resolveSubcommandFlagContractsForCommand
+} from "./chunks/chunk-MDPEOIGN.js";
+import "./chunks/chunk-3K2M5OYU.js";
+import "./chunks/chunk-BHO33VBQ.js";
+import "./chunks/chunk-WYDHYJPO.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -49,6 +50,7 @@ import {
   activateExtensions,
   asRecordOrNull,
   clearActiveExtensionHooks,
+  commandOptionFlagLabel,
   consumeAfterCommandAffectedItems,
   createEmptyExtensionRegistrationRegistry,
   discoverExtensions,
@@ -61,13 +63,16 @@ import {
   pathExists,
   readSettings,
   readSettingsWithMetadata,
+  resolveCommandOptionPolicyState,
   resolveFlagValueKind,
   resolveGlobalPmRoot,
+  resolveItemTypeRegistry,
   resolvePmCliVersion,
   resolvePmPackageRootFromModule,
   resolvePmRoot,
   resolveRuntimeFieldRegistry,
   resolveTelemetryErrorCategory,
+  resolveTypeDefinition,
   runActiveCommandHandler,
   runActiveParserOverride,
   runActivePreflightOverride,
@@ -85,7 +90,7 @@ import {
   setActiveExtensionServices,
   toNonEmptyStringOrUndefined,
   writeSettings
-} from "./chunks/chunk-EYPINTFR.js";
+} from "./chunks/chunk-RVUALSJF.js";
 
 // dist/cli/main.js
 import { Command } from "commander";
@@ -666,7 +671,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] = "006c671c-d2fc-5908-8431-08bc7e418184");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "23023585-f2dc-5ec7-a046-cc39355aaf59");
   } catch (e2) {
   }
 })();
@@ -844,29 +849,26 @@ function validateLooseCommandOptionsWithFlagDefinitions(options, definitions, co
     }
   }
 }
-function coerceLooseOptionValue(value, kind) {
-  if (Array.isArray(value)) {
-    return value.map((entry) => coerceLooseOptionValue(entry, kind));
+function coerceLooseStringOptionValue(value) {
+  if (typeof value === "string") {
+    return value;
   }
-  if (kind === "string") {
-    if (typeof value === "string") {
-      return value;
-    }
-    if (value === null || value === void 0) {
-      return value;
-    }
-    return String(value);
+  if (value === null || value === void 0) {
+    return value;
   }
-  if (kind === "number") {
-    if (typeof value === "number") {
-      return Number.isFinite(value) ? value : value;
-    }
-    if (typeof value === "string" && value.trim().length > 0) {
-      const parsed = Number(value);
-      return Number.isFinite(parsed) ? parsed : value;
-    }
+  return String(value);
+}
+function coerceLooseNumberOptionValue(value) {
+  if (typeof value === "number") {
     return value;
   }
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : value;
+  }
+  return value;
+}
+function coerceLooseBooleanOptionValue(value) {
   if (typeof value === "boolean") {
     return value;
   }
@@ -881,6 +883,17 @@ function coerceLooseOptionValue(value, kind) {
   }
   return value;
 }
+var LOOSE_OPTION_VALUE_COERCERS = {
+  string: coerceLooseStringOptionValue,
+  number: coerceLooseNumberOptionValue,
+  boolean: coerceLooseBooleanOptionValue
+};
+function coerceLooseOptionValue(value, kind) {
+  if (Array.isArray(value)) {
+    return value.map((entry) => coerceLooseOptionValue(entry, kind));
+  }
+  return LOOSE_OPTION_VALUE_COERCERS[kind](value);
+}
 function splitCommaListValue(value, kind) {
   const entries = flattenFlagListValue(value);
   return kind ? entries.map((entry) => coerceLooseOptionValue(entry, kind)) : entries;
@@ -1015,7 +1028,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] = "1a2a7293-fe21-5cea-9b44-64f8f159a18c");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "d7542ba0-4296-52db-a5c2-5cd68f5f3cf1");
   } catch (e2) {
   }
 })();
@@ -1177,6 +1190,8 @@ var HELP_BY_COMMAND_PATH = {
       "pm package init ./my-hook-package --capability hooks",
       "pm package init ./my-search-package --capability search",
       "pm package init ./my-sync-package --capability importers",
+      "pm package init ./my-domain-package --capability schema",
+      "pm package init ./my-output-package --capability renderers",
       "pm install ./my-sync-package --project",
       "pm package doctor --project --detail summary"
     ],
@@ -1184,6 +1199,8 @@ var HELP_BY_COMMAND_PATH = {
       "Use --capability hooks for a starter after_command lifecycle reactor with runnable SDK testing coverage.",
       "Use --capability search for a starter search provider/vector-store adapter with runnable SDK testing coverage.",
       "Use --capability importers for paired import/export commands that move project context across systems.",
+      "Use --capability schema for a starter custom item type, field, and migration so pm models your project domain.",
+      "Use --capability renderers/parser/preflight/services for starter override surfaces (output renderer, parsed-option rewrite, pre-run gate decision, built-in service) \u2014 one runnable starter per SDK capability.",
       "The generated package is local-install safe; add SDK runtime imports only after declaring dependencies and validating with package doctor.",
       "Use package doctor after changes to verify activation, policy, and collision diagnostics."
     ]
@@ -1219,6 +1236,8 @@ var HELP_BY_COMMAND_PATH = {
       "pm extension init ./my-hook-extension --capability hooks",
       "pm extension init ./my-search-extension --capability search",
       "pm extension init ./my-sync-extension --capability importers",
+      "pm extension init ./my-domain-extension --capability schema",
+      "pm extension init ./my-output-extension --capability renderers",
       "pm extension --install --project ./my-sync-extension",
       "pm extension --doctor --project --detail summary"
     ],
@@ -1226,6 +1245,8 @@ var HELP_BY_COMMAND_PATH = {
       "Use --capability hooks when the extension should react to command lifecycle events.",
       "Use --capability search when the extension should register retrieval primitives.",
       "Use --capability importers when the extension should register project-context import/export commands.",
+      "Use --capability schema when the extension should register custom item types, fields, and migrations.",
+      "Use --capability renderers/parser/preflight/services to override pm's output rendering, parsed options, pre-run gate, or a built-in service.",
       "Use package init for new distributable package workflows; extension init is the compatibility-level runtime scaffold."
     ]
   },
@@ -1473,6 +1494,22 @@ var HELP_BY_COMMAND_PATH = {
       "Configure defaults via pm config project set context --default-depth standard --activity-limit 15."
     ]
   },
+  next: {
+    why: "Answers 'what should I work on now?' in one read: the single highest-priority ready item with rationale, plus the ranked ready and blocked queues (project management = context management).",
+    examples: [
+      "pm next",
+      "pm next --json",
+      "pm next --limit 3 --ready-only",
+      "pm next --parent pm-mpbb",
+      "pm next --assignee codex-agent --format markdown"
+    ],
+    tips: [
+      "Ready = active status, no open blockers, and no open children (a concrete leaf); the recommendation resumes in-progress work before starting new work.",
+      "An item is blocked when its scalar blocked_by or a blocked_by dependency points at a non-terminal item; the blocked list names the blockers to clear.",
+      "Containers (Epics/Features with open children) are never recommended directly \u2014 the actionable leaf beneath them is.",
+      "Use --parent to scope to one epic's subtree, or --ready-only to drop the blocked companion list for the tightest output."
+    ]
+  },
   search: {
     why: "Finds relevant items by keyword, semantic, or hybrid retrieval modes.",
     examples: [
@@ -3073,669 +3110,6 @@ function ensureCommandPath(root, pathParts) {
   return current;
 }
 
-// dist/cli/bootstrap-args.js
-!(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] = "df81f91f-ed92-5511-b34c-ea7c1b81230b");
-  } catch (e2) {
-  }
-})();
-function parseBootstrapPathToken(token, next) {
-  if (token === "--path" || token === "--pm-path") {
-    if (typeof next === "string" && next.length > 0) {
-      return {
-        consumed: 2,
-        pathValue: next,
-        preferred: token === "--pm-path"
-      };
-    }
-    return {
-      consumed: 1,
-      preferred: token === "--pm-path"
-    };
-  }
-  const inlinePrefix = token.startsWith("--path=") ? "--path=" : token.startsWith("--pm-path=") ? "--pm-path=" : void 0;
-  if (!inlinePrefix) {
-    return null;
-  }
-  const value = token.slice(inlinePrefix.length);
-  if (value.length > 0) {
-    return {
-      consumed: 1,
-      pathValue: value,
-      preferred: inlinePrefix === "--pm-path="
-    };
-  }
-  return {
-    consumed: 1,
-    preferred: inlinePrefix === "--pm-path="
-  };
-}
-function parseBootstrapGlobalOptions(argv) {
-  let legacyPathValue;
-  let pmPathValue;
-  let noExtensions = false;
-  let noPager = false;
-  let json = false;
-  let quiet = false;
-  let index = 0;
-  while (index < argv.length) {
-    const token = argv[index];
-    if (token === "--") {
-      break;
-    }
-    if (token === "--no-extensions") {
-      noExtensions = true;
-      index += 1;
-      continue;
-    }
-    if (token === "--no-pager") {
-      noPager = true;
-      index += 1;
-      continue;
-    }
-    if (token === "--json") {
-      json = true;
-      index += 1;
-      continue;
-    }
-    if (token === "--quiet") {
-      quiet = true;
-      index += 1;
-      continue;
-    }
-    const parsedPath = parseBootstrapPathToken(token, argv[index + 1]);
-    if (parsedPath) {
-      if (parsedPath.pathValue !== void 0) {
-        if (parsedPath.preferred) {
-          pmPathValue = parsedPath.pathValue;
-        } else {
-          legacyPathValue = parsedPath.pathValue;
-        }
-      }
-      index += parsedPath.consumed;
-      continue;
-    }
-    index += 1;
-  }
-  return {
-    path: pmPathValue ?? legacyPathValue,
-    noExtensions,
-    noPager,
-    json,
-    quiet
-  };
-}
-function stripGlobalBootstrapTokens(argv) {
-  const remaining = [];
-  let index = 0;
-  while (index < argv.length) {
-    const token = argv[index];
-    if (token === "--") {
-      break;
-    }
-    if (token === "--json" || token === "--quiet" || token === "--no-extensions" || token === "--no-pager" || token === "--profile" || token === "--id-only" || token === "--explain") {
-      index += 1;
-      continue;
-    }
-    if (token === "--path" || token === "--pm-path") {
-      index += 2;
-      continue;
-    }
-    if (token.startsWith("--path=") || token.startsWith("--pm-path=")) {
-      index += 1;
-      continue;
-    }
-    remaining.push(token);
-    index += 1;
-  }
-  return remaining;
-}
-function parseBootstrapHelpRequest(argv) {
-  const stripped = stripGlobalBootstrapTokens(argv);
-  const first = stripped[0]?.trim().toLowerCase();
-  if (first === "help") {
-    const commandPathTokens2 = [];
-    for (let index = 1; index < stripped.length; index += 1) {
-      const token = stripped[index];
-      if (token.startsWith("-")) {
-        break;
-      }
-      commandPathTokens2.push(token.trim().toLowerCase());
-    }
-    return {
-      requested: true,
-      commandPathTokens: commandPathTokens2
-    };
-  }
-  const helpFlagIndex = stripped.findIndex((token) => token === "--help" || token === "-h");
-  if (helpFlagIndex < 0) {
-    return {
-      requested: false,
-      commandPathTokens: []
-    };
-  }
-  const commandPathTokens = [];
-  for (const token of stripped) {
-    if (token.startsWith("-")) {
-      break;
-    }
-    commandPathTokens.push(token.trim().toLowerCase());
-  }
-  return {
-    requested: true,
-    commandPathTokens
-  };
-}
-function findCommandTokenIndex(argv) {
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = argv[index];
-    if (token === "--") {
-      return void 0;
-    }
-    if (token === "--path" || token === "--pm-path") {
-      index += 1;
-      continue;
-    }
-    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("-")) {
-      continue;
-    }
-    return index;
-  }
-  return void 0;
-}
-function parseBootstrapCommandName(argv) {
-  const index = findCommandTokenIndex(argv);
-  return index === void 0 ? void 0 : argv[index].trim().toLowerCase();
-}
-function shouldDisablePagerForInvocation(argv, bootstrapGlobal) {
-  if (bootstrapGlobal.noPager) {
-    return true;
-  }
-  if (process.stdout.isTTY === true) {
-    return false;
-  }
-  const helpRequest = parseBootstrapHelpRequest(argv);
-  return helpRequest.requested;
-}
-function applyBootstrapPagerPolicy(argv) {
-  const bootstrapGlobal = parseBootstrapGlobalOptions(argv);
-  if (!shouldDisablePagerForInvocation(argv, bootstrapGlobal)) {
-    return;
-  }
-  process.env.PAGER = "cat";
-  process.env.MANPAGER = "cat";
-  process.env.GIT_PAGER = "cat";
-  if (typeof process.env.LESS !== "string" || process.env.LESS.trim().length === 0) {
-    process.env.LESS = "FRX";
-  }
-}
-var EXTENSION_ACTION_SYNTAX_TOKENS = /* @__PURE__ */ new Set([
-  "install",
-  "uninstall",
-  "explore",
-  "manage",
-  "doctor",
-  "adopt",
-  "adopt-all",
-  "activate",
-  "deactivate"
-]);
-function normalizeLegacyExtensionActionSyntax(argv) {
-  const extensionIndex = argv.findIndex((token) => token === "extension");
-  if (extensionIndex < 0) {
-    return [...argv];
-  }
-  const actionToken = argv[extensionIndex + 1];
-  if (!actionToken || actionToken.startsWith("-")) {
-    return [...argv];
-  }
-  if (!EXTENSION_ACTION_SYNTAX_TOKENS.has(actionToken)) {
-    return [...argv];
-  }
-  if (argv.includes("--help") || argv.includes("-h")) {
-    return [...argv];
-  }
-  const forcedActionFlag = `--${actionToken}`;
-  if (argv.includes(forcedActionFlag)) {
-    return [...argv];
-  }
-  return [...argv.slice(0, extensionIndex + 1), forcedActionFlag, ...argv.slice(extensionIndex + 2)];
-}
-var EXECUTABLE_COMMAND_ALIASES = {
-  show: "get",
-  view: "get",
-  comment: "comments",
-  note: "notes",
-  learning: "learnings"
-};
-function rewriteCommandAlias(argv, trace) {
-  const index = findCommandTokenIndex(argv);
-  if (index === void 0) {
-    return argv;
-  }
-  const token = argv[index];
-  const canonical = EXECUTABLE_COMMAND_ALIASES[token.trim().toLowerCase()];
-  if (!canonical) {
-    return argv;
-  }
-  const rewritten = [...argv];
-  rewritten[index] = canonical;
-  trace.push({ from: token, to: [canonical], reason: "command_alias", confidence: "high" });
-  return rewritten;
-}
-function normalizeFlagKeyToken(raw) {
-  const withoutPrefix = raw.replace(/^--?/, "");
-  return withoutPrefix.replace(/_/g, "-").replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
-}
-function toComparableFlagKey(raw) {
-  return normalizeFlagKeyToken(raw).replace(/-/g, "");
-}
-function markUnambiguousFlag(map, key, canonicalFlag) {
-  const existing = map.get(key);
-  if (existing === void 0) {
-    map.set(key, canonicalFlag);
-    return;
-  }
-  if (existing !== canonicalFlag) {
-    map.set(key, null);
-  }
-}
-function collectLongFlagCandidates(contract) {
-  const candidates = [];
-  const pushLongFlag = (value) => {
-    if (typeof value !== "string") {
-      return;
-    }
-    if (!value.startsWith("--")) {
-      return;
-    }
-    candidates.push(value);
-  };
-  pushLongFlag(contract.flag);
-  for (const alias of contract.aliases ?? []) {
-    pushLongFlag(alias);
-  }
-  return candidates;
-}
-function buildFlagLookup(commandName, contractsOverride) {
-  const contracts = contractsOverride ?? resolveSubcommandFlagContractsForCommand(commandName);
-  const canonicalByNormalized = /* @__PURE__ */ new Map();
-  const canonicalByCompact = /* @__PURE__ */ new Map();
-  const canonicalComparablesMap = /* @__PURE__ */ new Map();
-  const listCanonicalFlags = /* @__PURE__ */ new Set();
-  for (const contract of contracts) {
-    const longCandidates = collectLongFlagCandidates(contract);
-    if (longCandidates.length === 0) {
-      continue;
-    }
-    const canonicalFlag = `--${normalizeFlagKeyToken(longCandidates[0])}`;
-    for (const candidate of longCandidates) {
-      markUnambiguousFlag(canonicalByNormalized, normalizeFlagKeyToken(candidate), canonicalFlag);
-      markUnambiguousFlag(canonicalByCompact, toComparableFlagKey(candidate), canonicalFlag);
-    }
-    const comparable = toComparableFlagKey(canonicalFlag);
-    if (!canonicalComparablesMap.has(canonicalFlag)) {
-      canonicalComparablesMap.set(canonicalFlag, comparable);
-    }
-    if (contract.list === true) {
-      listCanonicalFlags.add(canonicalFlag);
-    }
-  }
-  return {
-    canonicalByNormalized,
-    canonicalByCompact,
-    canonicalComparables: [...canonicalComparablesMap.entries()].map(([canonicalFlag, comparable]) => ({
-      canonicalFlag,
-      comparable
-    })),
-    listCanonicalFlags
-  };
-}
-function resolveCanonicalFlag(rawKey, lookup) {
-  const normalizedKey = normalizeFlagKeyToken(rawKey);
-  const direct = lookup.canonicalByNormalized.get(normalizedKey);
-  if (typeof direct === "string") {
-    return {
-      flag: direct,
-      reason: "flag_alias",
-      confidence: "high"
-    };
-  }
-  const comparableKey = normalizedKey.replace(/-/g, "");
-  const compactMatch = lookup.canonicalByCompact.get(comparableKey);
-  if (typeof compactMatch === "string") {
-    return {
-      flag: compactMatch,
-      reason: "flag_alias",
-      confidence: "high"
-    };
-  }
-  const maxDistance = comparableKey.length >= 8 ? 2 : 1;
-  let bestDistance = Number.POSITIVE_INFINITY;
-  let bestFlag;
-  let tied = false;
-  for (const candidate of lookup.canonicalComparables) {
-    const distance = levenshteinDistanceWithinLimit(comparableKey, candidate.comparable, maxDistance);
-    if (distance === null) {
-      continue;
-    }
-    if (distance < bestDistance) {
-      bestDistance = distance;
-      bestFlag = candidate.canonicalFlag;
-      tied = false;
-      continue;
-    }
-    if (distance === bestDistance && bestFlag !== candidate.canonicalFlag) {
-      tied = true;
-    }
-  }
-  if (!bestFlag || tied || !Number.isFinite(bestDistance) || bestDistance <= 0) {
-    return null;
-  }
-  return {
-    flag: bestFlag,
-    reason: "flag_typo",
-    confidence: bestDistance >= 2 ? "medium" : "high"
-  };
-}
-function parseBareKeyValueToken(token) {
-  if (token.includes("://")) {
-    return null;
-  }
-  const match = token.match(/^([A-Za-z][A-Za-z0-9_-]{1,63})([:=])(.*)$/);
-  if (!match) {
-    return null;
-  }
-  const key = match[1];
-  const value = match[3];
-  if (value.length === 0) {
-    return null;
-  }
-  return {
-    key,
-    value
-  };
-}
-function normalizeLongOptionToken(token, lookup) {
-  if (!token.startsWith("--")) {
-    return { tokens: [token] };
-  }
-  const equalsIndex = token.indexOf("=");
-  const key = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;
-  const inlineValue = equalsIndex >= 0 ? token.slice(equalsIndex + 1) : void 0;
-  const resolution = resolveCanonicalFlag(key, lookup);
-  if (!resolution) {
-    return { tokens: [token] };
-  }
-  const normalizedToken = inlineValue === void 0 ? resolution.flag : `${resolution.flag}=${inlineValue}`;
-  if (normalizedToken === token) {
-    return { tokens: [token] };
-  }
-  return {
-    tokens: [normalizedToken],
-    event: {
-      from: token,
-      to: [normalizedToken],
-      reason: resolution.reason,
-      confidence: resolution.confidence
-    }
-  };
-}
-var GLOBAL_VALUE_CONSUMING_FLAGS = /* @__PURE__ */ new Set(["--pm-path", "--path"]);
-function splitCanonicalListToken(token) {
-  if (!token.startsWith("--")) {
-    return null;
-  }
-  const equalsIndex = token.indexOf("=");
-  if (equalsIndex < 0) {
-    return { flag: token };
-  }
-  return {
-    flag: token.slice(0, equalsIndex),
-    inlineValue: token.slice(equalsIndex + 1)
-  };
-}
-function coalesceRepeatedListFlags(argv, listFlags, valueConsumingFlags = /* @__PURE__ */ new Set(), multiValueListFlags = /* @__PURE__ */ new Set()) {
-  if (listFlags.size === 0) {
-    return { argv: [...argv], events: [] };
-  }
-  const result = [];
-  const slots = /* @__PURE__ */ new Map();
-  let index = 0;
-  while (index < argv.length) {
-    const token = argv[index];
-    if (token === "--") {
-      result.push(...argv.slice(index));
-      break;
-    }
-    if (valueConsumingFlags.has(token)) {
-      result.push(token);
-      const next = argv[index + 1];
-      if (typeof next === "string" && next !== "--") {
-        result.push(next);
-        index += 2;
-      } else {
-        index += 1;
-      }
-      continue;
-    }
-    const parsed = splitCanonicalListToken(token);
-    if (!parsed || !listFlags.has(parsed.flag)) {
-      result.push(token);
-      index += 1;
-      continue;
-    }
-    let value;
-    let consumed = 1;
-    if (parsed.inlineValue !== void 0) {
-      value = parsed.inlineValue;
-    } else {
-      const next = argv[index + 1];
-      if (typeof next === "string" && next !== "--" && !next.startsWith("-")) {
-        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) {
-      result.push(token);
-      index += consumed;
-      continue;
-    }
-    const originalTokens = argv.slice(index, index + consumed);
-    const existing = slots.get(parsed.flag);
-    if (existing) {
-      existing.values.push(value);
-      existing.occurrences += 1;
-    } else {
-      const slot = {
-        outputIndex: result.length,
-        originalTokens,
-        values: [value],
-        occurrences: 1
-      };
-      slots.set(parsed.flag, slot);
-      result.push(null);
-    }
-    index += consumed;
-  }
-  const events = [];
-  const splices = [];
-  for (const [flag, slot] of slots) {
-    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({
-        from: `${flag} (x${slot.occurrences})`,
-        to: [mergedToken],
-        reason: "list_merge",
-        confidence: "high"
-      });
-    } else {
-      splices.push({ outputIndex: slot.outputIndex, tokens: slot.originalTokens });
-    }
-  }
-  splices.sort((a, b) => b.outputIndex - a.outputIndex);
-  for (const splice of splices) {
-    result.splice(splice.outputIndex, 1, ...splice.tokens);
-  }
-  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);
-  if (legacyNormalized.length !== argv.length || legacyNormalized.some((token, index) => token !== argv[index])) {
-    trace.push({
-      from: argv.join(" "),
-      to: [...legacyNormalized],
-      reason: "legacy_extension_action",
-      confidence: "high"
-    });
-  }
-  const aliasNormalized = rewriteCommandAlias(legacyNormalized, trace);
-  const commandName = parseBootstrapCommandName(aliasNormalized);
-  const commandPathName = parseBootstrapCommandPathName(aliasNormalized);
-  const lookup = buildFlagLookup(commandPathName ?? commandName);
-  const normalizedArgv = [];
-  for (let index = 0; index < aliasNormalized.length; index += 1) {
-    const token = aliasNormalized[index];
-    if (token === "--") {
-      normalizedArgv.push(...aliasNormalized.slice(index));
-      break;
-    }
-    const previous = normalizedArgv[normalizedArgv.length - 1];
-    if (token.startsWith("--")) {
-      const normalizedToken = normalizeLongOptionToken(token, lookup);
-      normalizedArgv.push(...normalizedToken.tokens);
-      if (normalizedToken.event) {
-        trace.push(normalizedToken.event);
-      }
-      continue;
-    }
-    const bareKeyValue = parseBareKeyValueToken(token);
-    if (bareKeyValue && !(typeof previous === "string" && previous.startsWith("-")) && !isLinkedTestTwoTokenValuePosition(commandName, normalizedArgv)) {
-      const resolution = resolveCanonicalFlag(bareKeyValue.key, lookup);
-      if (resolution) {
-        const replacement = [resolution.flag, bareKeyValue.value];
-        normalizedArgv.push(...replacement);
-        trace.push({
-          from: token,
-          to: replacement,
-          reason: "bare_key_value",
-          confidence: resolution.confidence
-        });
-        continue;
-      }
-    }
-    normalizedArgv.push(token);
-  }
-  const linkedTestNormalized = mergeLinkedTestTwoTokenEntries(normalizedArgv, commandName, trace);
-  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);
-  }
-  return {
-    argv: coalesced.argv,
-    commandName,
-    trace
-  };
-}
-function parseBootstrapCommandPathName(argv) {
-  const stripped = stripGlobalBootstrapTokens(argv);
-  const first = stripped[0]?.trim().toLowerCase();
-  const second = stripped[1]?.trim().toLowerCase();
-  if ((first === "extension" || first === "package" || first === "packages") && typeof second === "string" && second.length > 0 && !second.startsWith("-")) {
-    return `${first} ${second}`;
-  }
-  return first;
-}
-function parseBootstrapTypeValue(argv) {
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = argv[index];
-    if (token === "--type") {
-      const candidate = argv[index + 1];
-      if (typeof candidate === "string" && candidate.trim().length > 0) {
-        return candidate.trim();
-      }
-      continue;
-    }
-    if (token.startsWith("--type=")) {
-      const candidate = token.slice("--type=".length).trim();
-      if (candidate.length > 0) {
-        return candidate;
-      }
-    }
-  }
-  return void 0;
-}
-
 // dist/cli/migration-gates.js
 !(function() {
   try {
@@ -3882,7 +3256,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] = "f4d1afdd-4dd2-5c8d-8948-0d2de94744f9");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c0b38b44-fdea-5d80-b2d4-361f2b07c8f1");
   } catch (e2) {
   }
 })();
@@ -4321,7 +3695,7 @@ async function resolveCommanderUsageContext(error, rootProgram, extensionDescrip
     unknownOptionSuggestions,
     unknownOptionOtherCommands: unknownOptionOtherCommands.length > 0 ? unknownOptionOtherCommands : void 0,
     suggestedRetryCommand,
-    ...unknownCommandGuidance ?? {}
+    ...unknownCommandGuidance
   };
 }
 async function formatCommanderUsageMessage(error, rootProgram, extensionDescriptors) {
@@ -4366,7 +3740,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] = "c5494fa8-5038-5b37-b511-887d9144262c");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "913c0a00-924f-520e-adb6-4073fdb73413");
   } catch (e2) {
   }
 })();
@@ -4547,7 +3921,7 @@ async function maybeRenderBootstrapJsonHelp(rootProgram, argv, extensionDescript
       const unknownMessage = `unknown command '${helpRequest.commandPathTokens.join(" ")}'`;
       const runtimeContext = buildUnknownCommandGuidanceFromRuntime(unknownMessage, rootProgram, extensionDescriptors);
       const envelope = formatCommanderErrorForJson(unknownMessage, "help", BUILTIN_TYPE_HELP_VALUES, EXIT_CODE.USAGE, {
-        ...runtimeContext ?? {},
+        ...runtimeContext,
         attemptedCommand: renderAttemptedCommand2(argv),
         normalizedInvocationArgs: [...argv],
         providedOptionFlags: extractProvidedOptionFlags(argv)
@@ -4639,7 +4013,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] = "654b0978-c0af-571f-9c8b-cb35a64c8d01");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "9f13a662-73c4-5ffa-99bc-4edee2b7a7fb");
   } catch (e2) {
   }
 })();
@@ -4684,10 +4058,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-TWHKICM2.js"));
-var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-CCMHGZTF.js"));
-var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-UXTTWL6N.js"));
-var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-R2FLOCRI.js"));
+var loadSetupRegistrationModule = createLazyModule(() => import("./chunks/register-setup-ZKJ53RS7.js"));
+var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-SNG5PGA4.js"));
+var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-KK7PHYYU.js"));
+var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-HZ6XERQG.js"));
 function describeUnknownError(error) {
   if (error instanceof PmCliError) {
     return error.message;
@@ -4739,7 +4113,7 @@ function buildPmCliRecoveryContext(context, invocationArgv, rawMessage) {
   if (existingRecovery?.recovery_mode === "compact" && !explainRequested) {
     return {
       /* c8 ignore next */
-      ...context ?? {},
+      ...context,
       recovery: existingRecovery
     };
   }
@@ -4777,7 +4151,7 @@ function buildPmCliRecoveryContext(context, invocationArgv, rawMessage) {
     ...existingRecovery?.next_best_command ? { next_best_command: existingRecovery.next_best_command } : {}
   };
   return {
-    ...context ?? {},
+    ...context,
     recovery
   };
 }
@@ -5359,7 +4733,7 @@ function extensionCapabilities(extension) {
   return new Set((extension.capabilities ?? []).map((capability) => capability.trim().toLowerCase()));
 }
 var GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES = /* @__PURE__ */ new Set(["hooks", "parser", "preflight", "renderers"]);
-var CONSERVATIVE_EXTENSION_ACTIVATION_CAPABILITIES = /* @__PURE__ */ new Set(["commands", "schema", "services"]);
+var CONSERVATIVE_EXTENSION_ACTIVATION_CAPABILITIES = /* @__PURE__ */ new Set(["commands", "schema", "services", "importers"]);
 var SEARCH_EXTENSION_ACTIVATION_COMMANDS = /* @__PURE__ */ new Set(["reindex", "search", "search-advanced"]);
 var CREATE_TEMPLATE_FLAGS = /* @__PURE__ */ new Set(["--template"]);
 function hasAnyCapability(capabilities, expected) {
@@ -5402,7 +4776,7 @@ function extensionProvidesTemplatesRuntime(commands) {
 function extensionNeedsActivationForProbe(extension, probe) {
   const capabilities = extensionCapabilities(extension);
   const commands = extensionActivationCommands(extension);
-  if (commands.length > 0 && commands.some((command) => activationCommandMatchesProbe(command, probe))) {
+  if (commands.some((command) => activationCommandMatchesProbe(command, probe))) {
     return true;
   }
   if (hasAnyCapability(capabilities, GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES)) {
@@ -5411,8 +4785,8 @@ function extensionNeedsActivationForProbe(extension, probe) {
   if (commandPathNeedsTemplateExtensions(probe) && extensionProvidesTemplatesRuntime(commands)) {
     return true;
   }
-  if (capabilities.has("search")) {
-    return commandPathNeedsSearchExtensions(probe.commandPath);
+  if (capabilities.has("search") && commandPathNeedsSearchExtensions(probe.commandPath)) {
+    return true;
   }
   if (commands.length > 0) {
     return false;
@@ -5420,9 +4794,6 @@ function extensionNeedsActivationForProbe(extension, probe) {
   if (hasAnyCapability(capabilities, CONSERVATIVE_EXTENSION_ACTIVATION_CAPABILITIES)) {
     return true;
   }
-  if (capabilities.has("importers")) {
-    return probe.allowCommandPrefixMatch === true;
-  }
   return false;
 }
 function discoveryNeedsActivationForProbe(discovery, probe) {
@@ -5433,7 +4804,7 @@ function discoveryNeedsActivationForProbe(discovery, probe) {
   if (!hasCommandProbe) {
     return discovery.effective.some((extension) => {
       const capabilities = extensionCapabilities(extension);
-      return extensionActivationCommands(extension).length > 0 || hasAnyCapability(capabilities, GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES) || hasAnyCapability(capabilities, CONSERVATIVE_EXTENSION_ACTIVATION_CAPABILITIES) || capabilities.has("importers") || capabilities.has("search");
+      return extensionActivationCommands(extension).length > 0 || hasAnyCapability(capabilities, GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES) || hasAnyCapability(capabilities, CONSERVATIVE_EXTENSION_ACTIVATION_CAPABILITIES) || capabilities.has("search");
     });
   }
   return discovery.effective.some((extension) => extensionNeedsActivationForProbe(extension, probe));