@unbrained/pm-cli 2026.6.22 → 2026.6.24

package/dist/cli-bundle/chunks/{chunk-7PBGTIN3.js → chunk-J7I4C5ZB.js}

@@ -10,15 +10,15 @@ import {
   readFirstStringFromCommanderOptions,
   readFirstValueFromCommanderOptions,
   readStringArrayFromCommanderOptions
-} from "./chunk-TRUFOER3.js";
+} from "./chunk-SMXSDY7J.js";
 import {
   refreshSearchArtifactsForMutation,
   shouldRunSearchRefreshInForeground
-} from "./chunk-XKNF3VRJ.js";
+} from "./chunk-HZF5RLKX.js";
 import {
   printError,
   writeStdout
-} from "./chunk-A25LOPRG.js";
+} from "./chunk-TIM4OD74.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -27,7 +27,7 @@ import {
   readSettings,
   resolvePmRoot,
   setActiveCommandResult
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-EYPINTFR.js";
 
 // dist/cli/registration-helpers.js
 !(function() {
@@ -803,4 +803,4 @@ export {
   normalizeContextOptions,
   invalidateSearchCachesForMutation
 };
-//# sourceMappingURL=chunk-7PBGTIN3.js.map
+//# sourceMappingURL=chunk-J7I4C5ZB.js.map

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

@@ -1,28 +1,30 @@
 import {
   scaffoldExtensionProject
-} from "./chunk-4YJA4LGU.js";
+} from "./chunk-INPHFO33.js";
 import {
   normalizeExtensionNameForMatch,
   normalizeManagedDirectoryName,
   normalizeStringList,
   parseExtensionManifest,
   validateExtensionDirectory
-} from "./chunk-25XZN3JD.js";
+} from "./chunk-PEL2NLQE.js";
 import {
   splitCommaList
 } from "./chunk-5HIZDR5A.js";
 import {
   nowIso
-} from "./chunk-4JXWVHMN.js";
+} from "./chunk-I6QMJ2XT.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-EYPINTFR.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] = "68131f37-e747-546c-ab4d-f986cdd37b76");
   } 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);
@@ -2378,9 +2465,14 @@ async function runExtension(target, options, global2) {
       created_directory: scaffold.created_directory,
       files: scaffold.files,
       next_steps: [
+        // The scaffold is authored in TypeScript (ADR pm-2c28); the manifest's
+        // ./index.js entry only exists after a compile, so building comes first.
+        ...options.vocabulary === "package" ? [`Build the package: cd ${quotedShellTargetPath}, then run "npm install" and "npm run build"`] : [
+          `Build the extension: cd ${quotedShellTargetPath}, then run "npm install -D typescript @types/node @unbrained/pm-cli" and "npx tsc"`
+        ],
         `Install the scaffold: ${options.vocabulary === "package" ? "pm install --project" : "pm extension --install --project"} ${quotedTargetPath}`,
         `Smoke-test command path: pm ${scaffold.command_name}`,
-        ...options.vocabulary === "package" ? [`Validate the sample test: cd ${quotedShellTargetPath}, then run "npm install" and "npm test"`] : [],
+        ...options.vocabulary === "package" ? [`Validate the sample test: cd ${quotedShellTargetPath}, then run "npm test"`] : [],
         `Run diagnostics: ${options.vocabulary === "package" ? "pm package doctor" : "pm extension --doctor"} --project --detail summary`
       ]
     });
@@ -2962,6 +3054,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 +3225,4 @@ export {
   runExtension,
   _testOnly
 };
-//# sourceMappingURL=chunk-7GCCDXXN.js.map
+//# sourceMappingURL=chunk-JKL6HRMV.js.map