@unbrained/pm-cli 2026.7.8 → 2026.7.9

package/dist/cli-bundle/chunks/{chunk-KMXVZ2P7.js → chunk-BPYVKTZE.js}

@@ -1,5 +1,5 @@
 
-!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]="df88cd5a-9d83-5cae-849e-f4d9082219a9")}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]="e4bc1071-3165-522e-b81f-8e280a88d93d")}catch(e){}}();
 import {
   isRemoteLinkedArtifactReference
 } from "./chunk-IBMFIKVS.js";
@@ -24,7 +24,7 @@ import {
   collectUnknownCapabilityGuidance,
   readManagedExtensionState,
   runInit
-} from "./chunk-GE44TQMC.js";
+} from "./chunk-P5SUMCU5.js";
 import {
   collectStaleVectorizationIds
 } from "./chunk-ROGZTCCB.js";
@@ -48,7 +48,7 @@ import {
   resolveProviderConfigSource,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-G4FKP4ID.js";
+} from "./chunk-DBV5A7FT.js";
 import {
   ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,
   ACTIVITY_FLAG_CONTRACTS,
@@ -141,7 +141,7 @@ import {
   UPGRADE_FLAG_CONTRACTS,
   VALIDATE_FLAG_CONTRACTS,
   compactFlagAliasContracts
-} from "./chunk-ML27MHNM.js";
+} from "./chunk-NBJCIAVV.js";
 import {
   LINKED_TEST_PM_CONTEXT_MODE_VALUES,
   LINKED_TEST_PROTECTED_ENV_KEYS,
@@ -158,7 +158,7 @@ import {
   parseLinkedTestRegexList,
   parseLinkedTestStringList,
   runCreate
-} from "./chunk-TUDAYIO7.js";
+} from "./chunk-ASSVI7FP.js";
 import {
   createStdinTokenResolver,
   parseCsvKv,
@@ -828,6 +828,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],
@@ -1072,11 +1118,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;
@@ -1702,6 +1762,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;
@@ -1709,10 +1770,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,
@@ -1725,12 +1787,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) {
@@ -1934,6 +1997,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));
@@ -1957,14 +2047,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
     } : {}
@@ -2041,9 +2132,13 @@ async function runContracts(options, global) {
   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);
   }
@@ -10064,7 +10159,7 @@ async function applyValidateFix(fix, global) {
     case "set_estimate":
     case "reparent":
     case "unset_parent": {
-      const { runUpdate } = await import("./update-MP4XLU56.js");
+      const { runUpdate } = await import("./update-ZMYVXM77.js");
       const updateOptions = { message: VALIDATE_AUTO_FIX_MESSAGE };
       if (fix.kind === "set_resolution") {
         updateOptions.resolution = fix.value;
@@ -10315,6 +10410,6 @@ export {
   runTestRunsWorker,
   runValidate
 };
-//# sourceMappingURL=chunk-KMXVZ2P7.js.map
+//# sourceMappingURL=chunk-BPYVKTZE.js.map
 
-//# debugId=df88cd5a-9d83-5cae-849e-f4d9082219a9
+//# debugId=e4bc1071-3165-522e-b81f-8e280a88d93d