@unbrained/pm-cli 2026.7.8 → 2026.7.9

package/dist/cli-bundle/chunks/{chunk-ASMRSIDX.js → chunk-NRYZ4QLH.js}

@@ -22,7 +22,7 @@ import {
   collectUnknownCapabilityGuidance,
   readManagedExtensionState,
   runInit
-} from "./chunk-FL625JJM.js";
+} from "./chunk-YHKXNGLA.js";
 import {
   collectStaleVectorizationIds
 } from "./chunk-VPLDQMW2.js";
@@ -46,7 +46,7 @@ import {
   resolveProviderConfigSource,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-PJPZTE7P.js";
+} from "./chunk-ONADVBMD.js";
 import {
   ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,
   ACTIVITY_FLAG_CONTRACTS,
@@ -139,7 +139,7 @@ import {
   UPGRADE_FLAG_CONTRACTS,
   VALIDATE_FLAG_CONTRACTS,
   compactFlagAliasContracts
-} from "./chunk-TR2C6V5T.js";
+} from "./chunk-K4NMHZR3.js";
 import {
   LINKED_TEST_PM_CONTEXT_MODE_VALUES,
   LINKED_TEST_PROTECTED_ENV_KEYS,
@@ -156,7 +156,7 @@ import {
   parseLinkedTestRegexList,
   parseLinkedTestStringList,
   runCreate
-} from "./chunk-XPSGJ4IV.js";
+} from "./chunk-K2OKKYSO.js";
 import {
   createStdinTokenResolver,
   parseCsvKv,
@@ -742,7 +742,7 @@ function buildMcpToolContracts() {
 !(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] = "24d15738-45bd-5dd2-95e1-699f9c6061bd");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "1b0d78ea-6245-5c11-9a0a-2740289b0b1a");
   } catch (e2) {
   }
 })();
@@ -854,6 +854,52 @@ var CANONICAL_COMMAND_ALIASES = [
 var COMMAND_ALIAS_TO_CANONICAL = new Map(CANONICAL_COMMAND_ALIASES.flatMap((entry) => entry.aliases.map((alias) => [alias, entry.canonical])));
 var COMMAND_NAMESPACE_DISPLAY_LIMIT = 10;
 var COMMAND_NAMESPACE_FALLBACK_LIMIT = 20;
+var COMMAND_INTENTS = /* @__PURE__ */ new Map([
+  ["activity", "Read activity."],
+  ["aggregate", "Group counts."],
+  ["append", "Append body."],
+  ["claim", "Claim work."],
+  ["close", "Close work."],
+  ["comments", "Manage comments."],
+  ["completion", "Generate shell completions."],
+  ["config", "Manage settings."],
+  ["context", "Build context."],
+  ["contracts", "Inspect contracts."],
+  ["copy", "Copy work."],
+  ["create", "Create work."],
+  ["delete", "Delete work."],
+  ["deps", "Manage deps."],
+  ["docs", "Link docs."],
+  ["files", "Link files."],
+  ["focus", "Manage focus."],
+  ["gc", "Clean caches."],
+  ["get", "Read item."],
+  ["guide", "Show user guides."],
+  ["health", "Check health."],
+  ["help", "Show help."],
+  ["history", "Inspect history."],
+  ["init", "Initialize workspace."],
+  ["install", "Install packages."],
+  ["learnings", "Manage learnings."],
+  ["list", "List work."],
+  ["next", "Pick next work."],
+  ["notes", "Manage notes."],
+  ["ops", "Run operations."],
+  ["package", "Manage packages."],
+  ["plan", "Manage plans."],
+  ["profile", "Manage profiles."],
+  ["reindex", "Refresh search index."],
+  ["release", "Release claim."],
+  ["restore", "Restore history."],
+  ["schema", "Customize schema."],
+  ["search", "Search work."],
+  ["stats", "Show stats."],
+  ["telemetry", "Manage telemetry."],
+  ["test", "Run linked tests."],
+  ["update", "Update work."],
+  ["upgrade", "Upgrade packages."],
+  ["validate", "Validate data."]
+]);
 var EXTENSION_LIFECYCLE_FLAG_CONTRACTS = [
   ["init", EXTENSION_INIT_FLAG_CONTRACTS],
   ["install", EXTENSION_INSTALL_FLAG_CONTRACTS],
@@ -1098,11 +1144,25 @@ function assignExtensionFlagBoolean(contract, key, enabled) {
     contract[key] = true;
   }
 }
+function normalizeExtensionFlagName(value, kind) {
+  if (value == null) {
+    return null;
+  }
+  if (typeof value !== "string") {
+    throw new TypeError("Expected string for extension flag name.");
+  }
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return null;
+  }
+  if (kind === "long") {
+    return trimmed.startsWith("--") && trimmed.length > 2 ? trimmed : null;
+  }
+  return trimmed.startsWith("-") && !trimmed.startsWith("--") && trimmed.length > 1 ? trimmed : null;
+}
 function toExtensionFlagContract(definition) {
-  const longName = toOptionalTrimmedString(definition.long);
-  const shortName = toOptionalTrimmedString(definition.short);
-  const normalizedLong = longName && longName.startsWith("--") && longName.length > 2 ? longName : null;
-  const normalizedShort = shortName && shortName.startsWith("-") && !shortName.startsWith("--") ? shortName : null;
+  const normalizedLong = normalizeExtensionFlagName(definition.long, "long");
+  const normalizedShort = normalizeExtensionFlagName(definition.short, "short");
   const flag = normalizedLong ?? normalizedShort;
   if (!flag) {
     return null;
@@ -1728,6 +1788,7 @@ function attachCreateRequiredOptionContracts(schema, metadata) {
   };
 }
 function resolveContractsSelection(options) {
+  const summary = options.summary === true;
   const schemaOnly = options.schemaOnly === true;
   const flagsOnly = options.flagsOnly === true;
   const availabilityOnly = options.availabilityOnly === true;
@@ -1735,10 +1796,11 @@ function resolveContractsSelection(options) {
   const fullOutput = options.full === true;
   const selectedAction = normalizeToken(options.action);
   const selectedCommand = normalizeToken(options.command);
-  const unfilteredDefaultBriefMode = !fullOutput && !schemaOnly && !flagsOnly && !availabilityOnly && !selectedAction && !selectedCommand;
+  const unfilteredDefaultBriefMode = !summary && !fullOutput && !schemaOnly && !flagsOnly && !availabilityOnly && !selectedAction && !selectedCommand;
   return {
     selectedAction,
     selectedCommand,
+    summary,
     schemaOnly,
     flagsOnly,
     availabilityOnly,
@@ -1751,12 +1813,13 @@ function resolveContractsSelection(options) {
 }
 function assertSingleContractsProjection(selection) {
   const projectionFlagsEnabled = [
+    selection.summary,
     selection.schemaOnly,
     selection.flagsOnly,
     selection.availabilityOnly
   ].filter((value) => value).length;
   if (projectionFlagsEnabled > 1) {
-    throw new PmCliError("Choose only one projection flag: --schema-only, --flags-only, or --availability-only.", EXIT_CODE.USAGE);
+    throw new PmCliError("Choose only one projection flag: --summary, --schema-only, --flags-only, or --availability-only.", EXIT_CODE.USAGE);
   }
 }
 async function readContractsSettings(pmRoot) {
@@ -1960,6 +2023,33 @@ function resolveContractsCommands(selection, actionContext) {
 function resolveOutputCommands(selection, commands) {
   return selection.flagsOnly && selection.selectedCommand === void 0 && selection.selectedAction === void 0 ? compactCommandAliasSurface(commands) : commands;
 }
+function summarizeCommandIntent(command) {
+  const rootCommand = command.split(" ")[0];
+  return COMMAND_INTENTS.get(command) ?? COMMAND_INTENTS.get(rootCommand) ?? "Inspect flags.";
+}
+function canonicalSummaryCommand(command) {
+  const rootCommand = command.split(" ")[0];
+  if (rootCommand.startsWith("list-")) {
+    return "list";
+  }
+  if (rootCommand.startsWith("history-")) {
+    return "history";
+  }
+  if (rootCommand === "ctx") {
+    return "context";
+  }
+  if (rootCommand === "packages") {
+    return "package";
+  }
+  return COMMAND_ALIAS_TO_CANONICAL.get(rootCommand) ?? rootCommand;
+}
+function buildCommandSummarySurface(commands) {
+  const rootCommands = [...new Set(commands.map((command) => canonicalSummaryCommand(command)))].filter((command) => command.length > 0).sort((left, right) => left.localeCompare(right));
+  return rootCommands.map((command) => ({
+    command,
+    intent: summarizeCommandIntent(command)
+  }));
+}
 function resolveExtensionCommandContracts(selection, runtime, outputCommands) {
   if (selection.selectedCommand) {
     return runtime.extensionContracts.filter((entry) => splitCommandPathAliases(entry.command).includes(selection.selectedCommand));
@@ -1983,14 +2073,15 @@ function createContractsResult(selection, schemaContext, actionContext, outputCo
     selected: {
       action: selection.selectedAction ?? null,
       command: selection.selectedCommand ?? null,
+      summary: selection.summary,
       schema_only: selection.schemaOnly,
       flags_only: selection.flagsOnly,
       availability_only: selection.availabilityOnly,
       runtime_only: selection.runtimeOnly,
       command_scoped: selection.selectedCommand !== void 0
     },
-    commands: outputCommands,
-    ...!selection.flagsOnly ? {
+    commands: selection.summary ? [] : outputCommands,
+    ...!selection.summary && !selection.flagsOnly ? {
       actions: actionContext.actions,
       action_availability: actionContext.actionAvailability
     } : {}
@@ -2067,9 +2158,13 @@ async function runContracts(options, global2) {
   const schemaContext = resolveContractsSchemaContext(selection, runtime, actionContext);
   const commands = resolveContractsCommands(selection, actionContext);
   const outputCommands = resolveOutputCommands(selection, commands);
+  const result = createContractsResult(selection, schemaContext, actionContext, outputCommands);
+  if (selection.summary) {
+    result.command_summaries = buildCommandSummarySurface(outputCommands);
+    return result;
+  }
   const commandAliases = buildCommandAliasSurface(commands);
   const extensionCommandContracts = resolveExtensionCommandContracts(selection, runtime, outputCommands);
-  const result = createContractsResult(selection, schemaContext, actionContext, outputCommands);
   if (!(selection.flagsOnly && !selection.fullOutput)) {
     attachRuntimeContractsResult(result, runtime);
   }
@@ -10244,7 +10339,7 @@ async function applyValidateFix(fix, global2) {
     case "set_estimate":
     case "reparent":
     case "unset_parent": {
-      const { runUpdate } = await import("./update-SDIRJGSY.js");
+      const { runUpdate } = await import("./update-76CRUMC7.js");
       const updateOptions = { message: VALIDATE_AUTO_FIX_MESSAGE };
       if (fix.kind === "set_resolution") {
         updateOptions.resolution = fix.value;
@@ -10495,4 +10590,4 @@ export {
   runTestRunsWorker,
   runValidate
 };
-//# sourceMappingURL=chunk-ASMRSIDX.js.map
+//# sourceMappingURL=chunk-NRYZ4QLH.js.map