@unbrained/pm-cli 2026.6.21 → 2026.6.23

package/dist/cli-bundle/main.js

@@ -5,13 +5,10 @@ import {
   emitTelemetryErrorEvent,
   finishTelemetryCommand,
   startTelemetryCommand
-} from "./chunks/chunk-QQHISQBJ.js";
+} from "./chunks/chunk-55ISXAQH.js";
 import {
   migrateItemFilesToFormat
-} from "./chunks/chunk-37QXHBIB.js";
-import {
-  normalizeExtensionNameForMatch
-} from "./chunks/chunk-CF55WVVS.js";
+} from "./chunks/chunk-FIGAZ4Y7.js";
 import {
   applyDefaultOutputFormat,
   clearResolvedGlobalOptions,
@@ -21,27 +18,30 @@ import {
   getGlobalOptions,
   invalidateSearchCachesForMutation,
   setResolvedGlobalOptions
-} from "./chunks/chunk-RLK7P77C.js";
+} from "./chunks/chunk-HFFUQR73.js";
 import {
   PM_CORE_COMMAND_NAMES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunks/chunk-HC4AWIKT.js";
-import "./chunks/chunk-NB3PYLQ6.js";
+} from "./chunks/chunk-CKGNPJAG.js";
+import "./chunks/chunk-DT5LPYOD.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunks/chunk-6H4LF7AO.js";
-import "./chunks/chunk-SX75ADBK.js";
-import "./chunks/chunk-7D3SAQXM.js";
-import "./chunks/chunk-QGG32QHW.js";
+} from "./chunks/chunk-O6LLO73I.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-FRUFKWNK.js";
-import "./chunks/chunk-YCJX76PW.js";
+} from "./chunks/chunk-YJ3SUEPD.js";
+import "./chunks/chunk-P77P2ILI.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -85,7 +85,7 @@ import {
   setActiveExtensionServices,
   toNonEmptyStringOrUndefined,
   writeSettings
-} from "./chunks/chunk-HMOADQVT.js";
+} from "./chunks/chunk-MJTSZKK5.js";
 
 // dist/cli/main.js
 import { Command } from "commander";
@@ -1015,7 +1015,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] = "7cb003ad-0fb8-5d62-a218-0635cd48e994");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "1a2a7293-fe21-5cea-9b44-64f8f159a18c");
   } catch (e2) {
   }
 })();
@@ -1137,6 +1137,7 @@ var HELP_BY_COMMAND_PATH = {
       "pm package uninstall sample-ext --global",
       "pm extension explore --project",
       "pm extension manage --global",
+      "pm extension describe sample-ext --project",
       "pm extension doctor --detail deep"
     ],
     tips: [
@@ -1147,6 +1148,7 @@ var HELP_BY_COMMAND_PATH = {
       "Install updates settings activation state automatically unless extension allowlist mode is unchanged.",
       "Use --adopt for single-extension adoption and --adopt-all to bulk-register unmanaged installs as managed without reinstalling.",
       "Use --manage for concise triage summaries and remediation-oriented diagnostics alongside full extension details.",
+      "Use --describe to map exactly what each loaded extension registers (commands, hooks, item types, providers, overrides) in one call.",
       "Use --doctor for consolidated diagnostics with warning codes, remediation hints, and optional deep detail payloads."
     ]
   },
@@ -1157,11 +1159,13 @@ var HELP_BY_COMMAND_PATH = {
       "pm package install ./my-package --project",
       "pm package doctor --project --detail deep",
       "pm package manage --project --runtime-probe",
+      "pm package describe --project",
       "pm package activate sample-ext --project",
       "pm upgrade --packages-only --dry-run"
     ],
     tips: [
       "Prefer package vocabulary for user-facing workflows; extension vocabulary remains available for compatibility.",
+      "Use pm package describe [name] to map every surface a package registers without reading its manifest or running diagnostics.",
       "Use pm upgrade to refresh the CLI/SDK and managed packages from their recorded sources.",
       "Use --dry-run before upgrade when automation needs a deterministic plan."
     ]
@@ -1170,10 +1174,16 @@ var HELP_BY_COMMAND_PATH = {
     why: "Generates an installable starter pm package with package metadata and a root extension entrypoint.",
     examples: [
       "pm package init ./my-package",
-      "pm install ./my-package --project",
+      "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 install ./my-sync-package --project",
       "pm package doctor --project --detail summary"
     ],
     tips: [
+      "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.",
       "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."
     ]
@@ -1206,10 +1216,16 @@ var HELP_BY_COMMAND_PATH = {
     why: "Generates an installable starter runtime extension with manifest and entrypoint files.",
     examples: [
       "pm extension init ./my-extension",
-      "pm extension --install --project ./my-extension",
+      "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 --install --project ./my-sync-extension",
       "pm extension --doctor --project --detail summary"
     ],
     tips: [
+      "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 package init for new distributable package workflows; extension init is the compatibility-level runtime scaffold."
     ]
   },
@@ -4668,10 +4684,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-EG2U6CEU.js"));
-var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-QI45RMKN.js"));
-var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-X3BUOQEL.js"));
-var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-MIDTRW7S.js"));
+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"));
 function describeUnknownError(error) {
   if (error instanceof PmCliError) {
     return error.message;