@unbrained/pm-cli 2026.6.22 → 2026.6.23

package/dist/cli-bundle/chunks/{chunk-C5SWTISA.js → chunk-GAJVRGGA.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]="8a654bfc-1cd8-530f-9195-0e10479a4c7c")}catch(e){}}();
 import {
   runClose
-} from "./chunk-JY25IOEZ.js";
+} from "./chunk-KFWBJPSG.js";
 import {
   assertNoLegacyNoneToken,
   assertNoLegacyNoneTokens,
@@ -20,7 +20,7 @@ import {
   parseTests,
   parseTypeOptionEntries,
   resolvePriority
-} from "./chunk-44O4JIN6.js";
+} from "./chunk-ZRK4O56R.js";
 import {
   applyTagRemovals,
   assertNoUnknownCsvKeys,
@@ -30,15 +30,15 @@ import {
   parseCsvKv,
   parseOptionalNumber,
   parseTags
-} from "./chunk-K25UDYJ4.js";
+} from "./chunk-ZQ3ZVXX2.js";
 import {
   normalizeParentReferenceValue,
   validateMissingParentReference,
   validateSprintOrReleaseValue
-} from "./chunk-DU64SZUQ.js";
+} from "./chunk-3VY3YQO6.js";
 import {
   buildInvalidTypeError
-} from "./chunk-6FQHNHQQ.js";
+} from "./chunk-T72AZDBA.js";
 import {
   applyRegisteredItemFieldDefaultsAndValidation,
   buildItemNotFoundError,
@@ -48,14 +48,14 @@ import {
   parseRegisteredItemFieldAssignments,
   readLocatedItem,
   toItemRecord
-} from "./chunk-GGAXE22C.js";
+} from "./chunk-5UVVASSA.js";
 import {
   normalizeItemId
-} from "./chunk-Y4BZEND6.js";
+} from "./chunk-S2RUQSX2.js";
 import {
   collectRuntimeUpdateFieldValues,
   normalizeStatusInput
-} from "./chunk-P7ZU73BO.js";
+} from "./chunk-VAYA4XFX.js";
 import {
   canonicalizeCommandOptionKey,
   commandOptionFlagLabel,
@@ -64,10 +64,10 @@ import {
   resolveTypeDefinition,
   resolveTypeName,
   validateTypeOptions
-} from "./chunk-KK4TQ3ZP.js";
+} from "./chunk-YDEXO24S.js";
 import {
   resolveIsoOrRelative
-} from "./chunk-PCH2JTEO.js";
+} from "./chunk-2T3JG6V4.js";
 import {
   DEPENDENCY_KIND_VALUES,
   EXIT_CODE,
@@ -83,7 +83,7 @@ import {
   resolveRuntimeFieldRegistry,
   resolveRuntimeStatusRegistry,
   stableValueEquals
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/core/schema/type-workflows.js
 function normalizeStatusToken(value) {
@@ -1794,6 +1794,6 @@ export {
   runUpdate,
   _testOnlyUpdateCommand
 };
-//# sourceMappingURL=chunk-C5SWTISA.js.map
+//# sourceMappingURL=chunk-GAJVRGGA.js.map
 
 //# debugId=8a654bfc-1cd8-530f-9195-0e10479a4c7c

package/dist/cli-bundle/chunks/{chunk-B2KR24R4.js → chunk-H2IP4QLJ.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-T5RRNDA7.js";
 import {
   readHistoryEntries
-} from "./chunk-YJICYNAV.js";
+} from "./chunk-AD3A7ZD6.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   historyEntriesToRaw,
@@ -13,27 +13,27 @@ import {
   replayToItemDocument,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-YQSWTVZF.js";
+} from "./chunk-WM5ZVBPE.js";
 import {
   acquireLock,
   createHistoryEntry,
   locateItem,
   readLocatedItem
-} from "./chunk-GGAXE22C.js";
+} from "./chunk-5UVVASSA.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-Y4BZEND6.js";
+} from "./chunk-S2RUQSX2.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-P7ZU73BO.js";
+} from "./chunk-VAYA4XFX.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KK4TQ3ZP.js";
+} from "./chunk-YDEXO24S.js";
 import {
   nowIso
-} from "./chunk-PCH2JTEO.js";
+} from "./chunk-2T3JG6V4.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -48,7 +48,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/cli/commands/history-redact.js
 import fs from "node:fs/promises";
@@ -579,6 +579,6 @@ export {
   runHistoryRedact,
   _testOnly
 };
-//# sourceMappingURL=chunk-B2KR24R4.js.map
+//# sourceMappingURL=chunk-H2IP4QLJ.js.map
 
 //# debugId=148a8af9-cf71-5fc9-b14d-c307d87acbe2

package/dist/cli-bundle/chunks/{chunk-VB54F347.js → chunk-H4IIJDE4.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]="b4e4ec6f-75b8-5083-b9b2-aab7e7028e85")}catch(e){}}();
 import {
   toNonEmptyStringOrUndefined
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/core/governance/metadata-coverage.js
 function normalizeStatus(status, registry) {
@@ -265,6 +265,6 @@ export {
   computeMetadataCoverage,
   groupItemsByDimension
 };
-//# sourceMappingURL=chunk-VB54F347.js.map
+//# sourceMappingURL=chunk-H4IIJDE4.js.map
 
 //# debugId=b4e4ec6f-75b8-5083-b9b2-aab7e7028e85

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

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

package/dist/cli-bundle/chunks/{chunk-RPRFBXND.js → chunk-IB3GYLQE.js}

@@ -1,13 +1,13 @@
 import {
   nowIso
-} from "./chunk-4JXWVHMN.js";
+} from "./chunk-P77P2ILI.js";
 import {
   EXIT_CODE,
   PmCliError,
   pathExists,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/core/checkpoint/mutation-checkpoint.js
 import { mkdir, readFile } from "node:fs/promises";
@@ -128,4 +128,4 @@ export {
   loadMutationCheckpoint,
   restoreCheckpointItems
 };
-//# sourceMappingURL=chunk-RPRFBXND.js.map
+//# sourceMappingURL=chunk-IB3GYLQE.js.map

package/dist/cli-bundle/chunks/{chunk-GNDHOR64.js → chunk-IPKJ6B36.js}

@@ -1,18 +1,18 @@
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-AJXYOYJV.js";
+} from "./chunk-7MRQ4HMK.js";
 import {
   canonicalDocument,
   parseItemDocument,
   serializeItemDocument
-} from "./chunk-CR7KFPAQ.js";
+} from "./chunk-NCVCO3NZ.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-3VLPDG3J.js";
+} from "./chunk-YJ3SUEPD.js";
 import {
   nowIso
-} from "./chunk-4JXWVHMN.js";
+} from "./chunk-P77P2ILI.js";
 import {
   EMPTY_CANONICAL_DOCUMENT,
   EXIT_CODE,
@@ -42,7 +42,7 @@ import {
   stableStringify,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/core/extensions/item-fields.js
 !(function() {
@@ -1392,4 +1392,4 @@ export {
   mutateItem,
   deleteItem
 };
-//# sourceMappingURL=chunk-GNDHOR64.js.map
+//# sourceMappingURL=chunk-IPKJ6B36.js.map

package/dist/cli-bundle/chunks/{chunk-V4SM4UAL.js → chunk-JR2LV3M4.js}

@@ -10,7 +10,7 @@ import {
   parseLinkedTestMinLines,
   parseLinkedTestRegexList,
   parseLinkedTestStringList
-} from "./chunk-NVUATMTC.js";
+} from "./chunk-SBQTAVJZ.js";
 import {
   assertNoUnknownCsvKeys,
   createStdinTokenResolver,
@@ -19,21 +19,21 @@ import {
   parseCsvKv,
   parseOptionalNumber,
   parseTags
-} from "./chunk-CWPBGUC7.js";
+} from "./chunk-FXR67XVQ.js";
 import {
   getFocusedItem
-} from "./chunk-GU7YHKYP.js";
+} from "./chunk-2A34E3BA.js";
 import {
   normalizeParentReferenceValue,
   validateMissingParentReference,
   validateSprintOrReleaseValue
-} from "./chunk-TZQKEBKF.js";
+} from "./chunk-34EONI5F.js";
 import {
   buildInvalidTypeError
-} from "./chunk-75VEYQJS.js";
+} from "./chunk-XVF4YARA.js";
 import {
   printError
-} from "./chunk-A25LOPRG.js";
+} from "./chunk-O6LLO73I.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -42,18 +42,18 @@ import {
   createHistoryEntry,
   locateItem,
   parseRegisteredItemFieldAssignments
-} from "./chunk-GNDHOR64.js";
+} from "./chunk-IPKJ6B36.js";
 import {
   generateItemId,
   normalizeItemId
-} from "./chunk-AJXYOYJV.js";
+} from "./chunk-7MRQ4HMK.js";
 import {
   canonicalDocument,
   collectRuntimeCreateFieldValues,
   normalizeFrontMatter,
   normalizeStatusInput,
   serializeItemDocument
-} from "./chunk-CR7KFPAQ.js";
+} from "./chunk-NCVCO3NZ.js";
 import {
   canonicalizeCommandOptionKey,
   commandOptionFlagLabel,
@@ -62,11 +62,11 @@ import {
   resolveTypeDefinition,
   resolveTypeName,
   validateTypeOptions
-} from "./chunk-3VLPDG3J.js";
+} from "./chunk-YJ3SUEPD.js";
 import {
   nowIso,
   resolveIsoOrRelative
-} from "./chunk-4JXWVHMN.js";
+} from "./chunk-P77P2ILI.js";
 import {
   CONFIDENCE_TEXT_VALUES,
   CREATE_DIRECT_CLOSE_REASON_DEFAULT,
@@ -97,7 +97,7 @@ import {
   runActiveOnWriteHooks,
   weekdayOrderIndex,
   writeFileAtomic
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/core/item/priority.js
 !(function() {
@@ -2038,4 +2038,4 @@ export {
   runCreate,
   _testOnlyCreateCommand
 };
-//# sourceMappingURL=chunk-V4SM4UAL.js.map
+//# sourceMappingURL=chunk-JR2LV3M4.js.map

package/dist/cli-bundle/chunks/{chunk-JY25IOEZ.js → chunk-KFWBJPSG.js}

@@ -7,13 +7,13 @@ import {
   mutateItem,
   readLocatedItem,
   toItemRecord
-} from "./chunk-GGAXE22C.js";
+} from "./chunk-5UVVASSA.js";
 import {
   isTerminalStatus
-} from "./chunk-P7ZU73BO.js";
+} from "./chunk-VAYA4XFX.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KK4TQ3ZP.js";
+} from "./chunk-YDEXO24S.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -22,7 +22,7 @@ import {
   readSettings,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/cli/commands/close.js
 function toAuthor(candidate, defaultAuthor) {
@@ -388,6 +388,6 @@ export {
   _testOnlyCloseCommand,
   runClose
 };
-//# sourceMappingURL=chunk-JY25IOEZ.js.map
+//# sourceMappingURL=chunk-KFWBJPSG.js.map
 
 //# debugId=847742a0-59c5-54d8-a607-7ee2d435b0a6

package/dist/cli-bundle/chunks/{chunk-D35LTIFR.js → chunk-KQMUV6LX.js}

@@ -1,30 +1,32 @@
 
-!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]="5b87215b-bb14-5510-af50-0d572df794ca")}catch(e){}}();
+!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]="db37d572-333e-53e5-a56d-c59f51332387")}catch(e){}}();
 import {
   scaffoldExtensionProject
-} from "./chunk-3GL6LTUL.js";
+} from "./chunk-C5AOG6D2.js";
 import {
   normalizeExtensionNameForMatch,
   normalizeManagedDirectoryName,
   normalizeStringList,
   parseExtensionManifest,
   validateExtensionDirectory
-} from "./chunk-DMT4ODVN.js";
+} from "./chunk-4BHT5VDC.js";
 import {
   splitCommaList
 } from "./chunk-P4SESZGT.js";
 import {
   nowIso
-} from "./chunk-PCH2JTEO.js";
+} from "./chunk-2T3JG6V4.js";
 import {
   EXIT_CODE,
   EXTENSION_CAPABILITY_CONTRACT,
   KNOWN_EXTENSION_CAPABILITIES,
   PmCliError,
   activateExtensions,
+  collectUsedExtensionCapabilities,
   isPathWithinDirectory,
   loadExtensions,
   nextExtensionReloadToken,
+  normalizeExtensionName,
   parseLegacyExtensionCapabilityAliasWarning,
   parseUnknownExtensionCapabilityWarning,
   pathExists,
@@ -35,7 +37,7 @@ import {
   resolvePmPackageRootFromModule,
   resolvePmRoot,
   writeSettings
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/cli/commands/extension.js
 import { execFile as execFile2 } from "node:child_process";
@@ -1156,6 +1158,76 @@ function projectPackageCatalogEntry(entry, fields) {
   return projected;
 }
 
+// dist/core/extensions/activation-summary.js
+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 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 applyDoctorRuntimeActivationState(extensions, loadResult, activationResult) {
   const loadedNames = new Set(loadResult.loaded.map((entry) => normalizeExtensionNameForMatch(entry.name)));
@@ -1847,6 +1919,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,
@@ -1882,7 +1955,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);
@@ -2922,6 +2995,29 @@ async function runExtension(target, options, global) {
     }
     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: global.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);
@@ -3070,6 +3166,6 @@ export {
   runExtension,
   _testOnly
 };
-//# sourceMappingURL=chunk-D35LTIFR.js.map
+//# sourceMappingURL=chunk-KQMUV6LX.js.map
 
-//# debugId=5b87215b-bb14-5510-af50-0d572df794ca
+//# debugId=db37d572-333e-53e5-a56d-c59f51332387