@unbrained/pm-cli 2026.6.22 → 2026.6.23

package/dist/cli-bundle/chunks/{chunk-XKNF3VRJ.js → chunk-DT5LPYOD.js}

@@ -1,13 +1,13 @@
 import {
   locateItem,
   readLocatedItem
-} from "./chunk-GNDHOR64.js";
+} from "./chunk-IPKJ6B36.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-3VLPDG3J.js";
+} from "./chunk-YJ3SUEPD.js";
 import {
   nowIso
-} from "./chunk-4JXWVHMN.js";
+} from "./chunk-P77P2ILI.js";
 import {
   coercePositiveInteger,
   getActiveExtensionRegistrations,
@@ -22,7 +22,7 @@ import {
   toNonEmptyString,
   trimTrailingSlashes,
   writeFileAtomic
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/core/search/http-client.js
 !(function() {
@@ -1990,4 +1990,4 @@ export {
   refreshSemanticEmbeddingsForMutatedItems,
   refreshSearchArtifactsForMutation
 };
-//# sourceMappingURL=chunk-XKNF3VRJ.js.map
+//# sourceMappingURL=chunk-DT5LPYOD.js.map

package/dist/cli-bundle/chunks/{chunk-4SDKF5BG.js → chunk-FIGAZ4Y7.js}

@@ -1,7 +1,7 @@
 import {
   parseItemDocument,
   serializeItemDocument
-} from "./chunk-CR7KFPAQ.js";
+} from "./chunk-NCVCO3NZ.js";
 import {
   TYPE_TO_FOLDER,
   getItemFormatFromPath,
@@ -10,7 +10,7 @@ import {
   removeFileIfExists,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/core/store/item-format-migration.js
 import fs from "node:fs/promises";
@@ -119,4 +119,4 @@ async function migrateItemFilesToFormat(pmRoot, targetFormat, op = "item_format:
 export {
   migrateItemFilesToFormat
 };
-//# sourceMappingURL=chunk-4SDKF5BG.js.map
+//# sourceMappingURL=chunk-FIGAZ4Y7.js.map

package/dist/cli-bundle/chunks/{chunk-CWPBGUC7.js → chunk-FXR67XVQ.js}

@@ -1,7 +1,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/core/item/parse.js
 !(function() {
@@ -356,4 +356,4 @@ export {
   createStdinTokenResolver,
   parseOptionalNumber
 };
-//# sourceMappingURL=chunk-CWPBGUC7.js.map
+//# sourceMappingURL=chunk-FXR67XVQ.js.map

package/dist/cli-bundle/chunks/{chunk-NIWY4V4Z.js → chunk-G6N5VEOK.js}

@@ -2,7 +2,7 @@
 !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]="cc38118c-431e-5112-8201-cf5ec5a89ce6")}catch(e){}}();
 import {
   parseOptionalNumber
-} from "./chunk-K25UDYJ4.js";
+} from "./chunk-ZQ3ZVXX2.js";
 import {
   splitCommaList
 } from "./chunk-P4SESZGT.js";
@@ -10,7 +10,7 @@ import {
   EXIT_CODE,
   PmCliError,
   SCOPE_VALUES
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/cli/commands/linked-test-entry.js
 var STRUCTURED_LINKED_TEST_KEYS = [
@@ -513,6 +513,6 @@ export {
   parseLinkedTestAssertionGteMap,
   parseLinkedTestJsonEntries
 };
-//# sourceMappingURL=chunk-NIWY4V4Z.js.map
+//# sourceMappingURL=chunk-G6N5VEOK.js.map
 
 //# debugId=cc38118c-431e-5112-8201-cf5ec5a89ce6

package/dist/cli-bundle/chunks/{chunk-7GCCDXXN.js → chunk-G6PYHBBR.js}

@@ -1,28 +1,30 @@
 import {
   scaffoldExtensionProject
-} from "./chunk-4YJA4LGU.js";
+} from "./chunk-MVKFOLLM.js";
 import {
   normalizeExtensionNameForMatch,
   normalizeManagedDirectoryName,
   normalizeStringList,
   parseExtensionManifest,
   validateExtensionDirectory
-} from "./chunk-25XZN3JD.js";
+} from "./chunk-5VOINNKT.js";
 import {
   splitCommaList
 } from "./chunk-5HIZDR5A.js";
 import {
   nowIso
-} from "./chunk-4JXWVHMN.js";
+} from "./chunk-P77P2ILI.js";
 import {
   EXIT_CODE,
   EXTENSION_CAPABILITY_CONTRACT,
   KNOWN_EXTENSION_CAPABILITIES,
   PmCliError,
   activateExtensions,
+  collectUsedExtensionCapabilities,
   isPathWithinDirectory,
   loadExtensions,
   nextExtensionReloadToken,
+  normalizeExtensionName,
   parseLegacyExtensionCapabilityAliasWarning,
   parseUnknownExtensionCapabilityWarning,
   pathExists,
@@ -33,7 +35,7 @@ import {
   resolvePmPackageRootFromModule,
   resolvePmRoot,
   writeSettings
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/cli/commands/extension.js
 import { execFile as execFile2 } from "node:child_process";
@@ -1182,6 +1184,90 @@ function projectPackageCatalogEntry(entry, fields) {
   return projected;
 }
 
+// dist/core/extensions/activation-summary.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] = "13c88992-4da1-549d-8644-3ac448f6960e");
+  } catch (e2) {
+  }
+})();
+var HOOK_REGISTRY_FIELD_TO_KIND = [
+  ["beforeCommand", "before_command"],
+  ["afterCommand", "after_command"],
+  ["onWrite", "on_write"],
+  ["onRead", "on_read"],
+  ["onIndex", "on_index"]
+];
+function describeExtensionActivation(activation, options = {}) {
+  const filter = options.extensionName !== void 0 ? normalizeExtensionName(options.extensionName) : null;
+  const matches = (name) => filter === null || normalizeExtensionName(name) === filter;
+  const collect = (entries, identify) => sortUnique(entries.filter((entry) => matches(entry.name)).map(identify));
+  const collectFlat = (entries, expand) => sortUnique(entries.filter((entry) => matches(entry.name)).flatMap(expand));
+  const { registrations, commands, parsers, preflight, services, renderers, hooks } = activation;
+  return {
+    capabilities: collectUsedExtensionCapabilities(activation, options),
+    commands: collect(registrations.commands, (entry) => entry.command),
+    command_overrides: collect(commands.overrides, (entry) => entry.command),
+    command_handlers: collect(commands.handlers, (entry) => entry.command),
+    hooks: HOOK_REGISTRY_FIELD_TO_KIND.filter(([field]) => hooks[field].some((entry) => matches(entry.name))).map(([, kind]) => kind),
+    flag_commands: collect(registrations.flags, (entry) => entry.target_command),
+    item_types: collectFlat(registrations.item_types, (entry) => entry.types.map((type) => type.name)),
+    item_fields: collectFlat(registrations.item_fields, (entry) => entry.fields.map((field) => field.name)),
+    migrations: collectFlat(registrations.migrations, (entry) => typeof entry.definition.id === "string" ? [entry.definition.id] : []),
+    importers: collect(registrations.importers, (entry) => entry.importer),
+    exporters: collect(registrations.exporters, (entry) => entry.exporter),
+    search_providers: collect(registrations.search_providers, (entry) => entry.definition.name),
+    vector_store_adapters: collect(registrations.vector_store_adapters, (entry) => entry.definition.name),
+    parser_overrides: collect(parsers.overrides, (entry) => entry.command),
+    service_overrides: collect(services.overrides, (entry) => entry.service),
+    renderer_overrides: collect(renderers.overrides, (entry) => entry.format),
+    preflight_overrides: preflight.overrides.filter((entry) => matches(entry.name)).length
+  };
+}
+function sortUnique(values) {
+  return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+
+// dist/cli/commands/extension/describe.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] = "7a92163a-99b2-5969-acc2-e2b6b0336c2e");
+  } catch (e2) {
+  }
+})();
+function layerNameKey(layer, name) {
+  return `${layer}:${normalizeExtensionNameForMatch(name)}`;
+}
+function buildExtensionDescribeResult(target, loadResult, activationResult) {
+  const activationFailedKeys = new Set(activationResult.failed.map((entry) => layerNameKey(entry.layer, entry.name)));
+  const candidates = [
+    ...loadResult.loaded.map((entry) => ({
+      name: entry.name,
+      layer: entry.layer,
+      version: entry.version,
+      activation_status: activationFailedKeys.has(layerNameKey(entry.layer, entry.name)) ? "failed" : "ok",
+      surfaces: describeExtensionActivation(activationResult, { extensionName: entry.name })
+    })),
+    ...loadResult.failed.map((entry) => ({
+      name: entry.name,
+      layer: entry.layer,
+      version: "unknown",
+      activation_status: "not_loaded",
+      surfaces: describeExtensionActivation(activationResult, { extensionName: entry.name })
+    }))
+  ].sort((left, right) => left.name.localeCompare(right.name) || left.layer.localeCompare(right.layer));
+  const normalizedTarget = typeof target === "string" ? normalizeExtensionNameForMatch(target) : null;
+  const extensions = normalizedTarget === null ? candidates : candidates.filter((entry) => normalizeExtensionNameForMatch(entry.name) === normalizedTarget);
+  return {
+    target: typeof target === "string" ? target.trim() : null,
+    total: extensions.length,
+    extensions,
+    union: describeExtensionActivation(activationResult, normalizedTarget === null ? {} : { extensionName: target })
+  };
+}
+
 // dist/cli/commands/extension/doctor.js
 !(function() {
   try {
@@ -1656,7 +1742,7 @@ function buildDoctorConsistencySummary(scope, installedExtensions, loadedExtensi
 !(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] = "1402dcb1-4fe9-5ec7-a34f-990b54437d1e");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "bc327a80-93b0-5be9-9ebf-8864cf67d23d");
   } catch (e2) {
   }
 })();
@@ -1887,6 +1973,7 @@ function resolveAction(target, options) {
     options.uninstall ? "uninstall" : null,
     options.explore ? "explore" : null,
     options.manage ? "manage" : null,
+    options.describe ? "describe" : null,
     options.reload ? "reload" : null,
     options.doctor ? "doctor" : null,
     options.catalog ? "catalog" : null,
@@ -1922,7 +2009,7 @@ function resolveAction(target, options) {
     if (target === void 0) {
       return "explore";
     }
-    throw new PmCliError("One action flag is required. Use one of: --install, --uninstall, --explore, --manage, --reload, --doctor, --catalog, --init/--scaffold, --adopt, --adopt-all, --activate, --deactivate. Bare `pm package` and `pm extension` default to --explore.", EXIT_CODE.USAGE);
+    throw new PmCliError("One action flag is required. Use one of: --install, --uninstall, --explore, --manage, --describe, --reload, --doctor, --catalog, --init/--scaffold, --adopt, --adopt-all, --activate, --deactivate. Bare `pm package` and `pm extension` default to --explore.", EXIT_CODE.USAGE);
   }
   if (selected.length > 1) {
     throw new PmCliError("Extension action flags are mutually exclusive.", EXIT_CODE.USAGE);
@@ -2962,6 +3049,29 @@ async function runExtension(target, options, global2) {
     }
     return withResult(details);
   }
+  if (action === "describe") {
+    const settings = await readSettings(resolvedRoots.settings_root);
+    const loadResult = await loadExtensions({
+      pmRoot: resolvedRoots.pm_root,
+      settings,
+      cwd: process.cwd(),
+      noExtensions: global2.noExtensions === true
+    });
+    const activationResult = await activateExtensions(loadResult);
+    warnings.push(...loadResult.warnings);
+    warnings.push(...activationResult.warnings);
+    const describeResult = buildExtensionDescribeResult(normalizedTarget, loadResult, activationResult);
+    if (normalizedTarget !== void 0 && describeResult.extensions.length === 0) {
+      const noun = options.vocabulary === "package" ? "package" : "extension";
+      throw new PmCliError(`No loaded ${noun} named "${normalizedTarget}" was found in ${scope} scope. Run pm ${noun} explore to list discovered ${noun}s.`, EXIT_CODE.NOT_FOUND);
+    }
+    return withResult({
+      target: describeResult.target,
+      total: describeResult.total,
+      extensions: describeResult.extensions,
+      union: describeResult.union
+    });
+  }
   if (action === "explore" || action === "manage") {
     const settings = await readSettings(resolvedRoots.settings_root);
     const configuredPolicy = buildExtensionPolicyDetails(settings.extensions.policy);
@@ -3110,4 +3220,4 @@ export {
   runExtension,
   _testOnly
 };
-//# sourceMappingURL=chunk-7GCCDXXN.js.map
+//# sourceMappingURL=chunk-G6PYHBBR.js.map