@unbrained/pm-cli 2026.6.23 → 2026.6.30

package/dist/cli-bundle/main.js

@@ -5,10 +5,10 @@ import {
   emitTelemetryErrorEvent,
   finishTelemetryCommand,
   startTelemetryCommand
-} from "./chunks/chunk-55ISXAQH.js";
+} from "./chunks/chunk-IDYCAK35.js";
 import {
   migrateItemFilesToFormat
-} from "./chunks/chunk-FIGAZ4Y7.js";
+} from "./chunks/chunk-OUQ5JEFM.js";
 import {
   applyDefaultOutputFormat,
   clearResolvedGlobalOptions,
@@ -18,30 +18,23 @@ import {
   getGlobalOptions,
   invalidateSearchCachesForMutation,
   setResolvedGlobalOptions
-} from "./chunks/chunk-HFFUQR73.js";
+} from "./chunks/chunk-DORJSBGJ.js";
 import {
   PM_CORE_COMMAND_NAMES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunks/chunk-CKGNPJAG.js";
-import "./chunks/chunk-DT5LPYOD.js";
+} from "./chunks/chunk-6T5ZIWBS.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunks/chunk-O6LLO73I.js";
+} from "./chunks/chunk-CHRNYKNI.js";
+import "./chunks/chunk-KYDYQMNW.js";
 import {
   normalizeExtensionNameForMatch
-} from "./chunks/chunk-5VOINNKT.js";
-import "./chunks/chunk-IPKJ6B36.js";
-import "./chunks/chunk-7MRQ4HMK.js";
-import "./chunks/chunk-NCVCO3NZ.js";
-import {
-  commandOptionFlagLabel,
-  resolveCommandOptionPolicyState,
-  resolveItemTypeRegistry,
-  resolveTypeDefinition
-} from "./chunks/chunk-YJ3SUEPD.js";
-import "./chunks/chunk-P77P2ILI.js";
+} from "./chunks/chunk-F6VH3LFC.js";
+import "./chunks/chunk-LBH7UYKY.js";
+import "./chunks/chunk-ZFIEEDTJ.js";
+import "./chunks/chunk-MLHX6DN5.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -49,6 +42,7 @@ import {
   activateExtensions,
   asRecordOrNull,
   clearActiveExtensionHooks,
+  commandOptionFlagLabel,
   consumeAfterCommandAffectedItems,
   createEmptyExtensionRegistrationRegistry,
   discoverExtensions,
@@ -61,13 +55,16 @@ import {
   pathExists,
   readSettings,
   readSettingsWithMetadata,
+  resolveCommandOptionPolicyState,
   resolveFlagValueKind,
   resolveGlobalPmRoot,
+  resolveItemTypeRegistry,
   resolvePmCliVersion,
   resolvePmPackageRootFromModule,
   resolvePmRoot,
   resolveRuntimeFieldRegistry,
   resolveTelemetryErrorCategory,
+  resolveTypeDefinition,
   runActiveCommandHandler,
   runActiveParserOverride,
   runActivePreflightOverride,
@@ -85,7 +82,7 @@ import {
   setActiveExtensionServices,
   toNonEmptyStringOrUndefined,
   writeSettings
-} from "./chunks/chunk-MJTSZKK5.js";
+} from "./chunks/chunk-SNUK7H5J.js";
 
 // dist/cli/main.js
 import { Command } from "commander";
@@ -1015,7 +1012,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 +1174,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 +1183,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 +1220,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 +1229,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 +1478,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: [
@@ -3882,7 +3903,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 +4342,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 +4387,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 +4568,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 +4660,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 +4705,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-KBXQDCXE.js"));
-var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-DDCHPONM.js"));
-var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-LAVKYY63.js"));
-var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-U5JAW3WE.js"));
+var loadSetupRegistrationModule = createLazyModule(() => import("./chunks/register-setup-MPANILQF.js"));
+var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-KY6Z6WV7.js"));
+var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-N6AYSKPM.js"));
+var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-L6CYTOIH.js"));
 function describeUnknownError(error) {
   if (error instanceof PmCliError) {
     return error.message;
@@ -4739,7 +4760,7 @@ function buildPmCliRecoveryContext(context, invocationArgv, rawMessage) {
   if (existingRecovery?.recovery_mode === "compact" && !explainRequested) {
     return {
       /* c8 ignore next */
-      ...context ?? {},
+      ...context,
       recovery: existingRecovery
     };
   }
@@ -4777,7 +4798,7 @@ function buildPmCliRecoveryContext(context, invocationArgv, rawMessage) {
     ...existingRecovery?.next_best_command ? { next_best_command: existingRecovery.next_best_command } : {}
   };
   return {
-    ...context ?? {},
+    ...context,
     recovery
   };
 }
@@ -5359,7 +5380,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 +5423,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 +5432,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 +5441,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 +5451,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));