@unbrained/pm-cli 2026.7.8 → 2026.7.10

package/dist/cli-bundle/chunks/{chunk-GSQVQINP.js → chunk-FBD2WUNS.js}

@@ -3,19 +3,19 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   createStdinTokenResolver
-} from "./chunk-CGDUIPJL.js";
+} from "./chunk-22PW73KV.js";
 import {
   PmCliError,
   mutateItem,
   readSettings,
   toItemRecord
-} from "./chunk-BPJ5NYSJ.js";
+} from "./chunk-F7UA74OZ.js";
 import {
   EXIT_CODE,
   getSettingsPath,
   pathExists,
   resolvePmRoot
-} from "./chunk-2BVD4ZD2.js";
+} from "./chunk-J3FDNQWM.js";
 
 // dist/cli/commands/append.js
 !(function() {
@@ -66,4 +66,4 @@ async function runAppend(id, options, global2) {
 export {
   runAppend
 };
-//# sourceMappingURL=chunk-GSQVQINP.js.map
+//# sourceMappingURL=chunk-FBD2WUNS.js.map

package/dist/cli-bundle/chunks/{chunk-YSRXFGNV.js → chunk-FSD7W7Y2.js}

@@ -2,14 +2,14 @@
 !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]="15c384ad-9069-5ef0-bf3d-94b32fd19a03")}catch(e){}}();
 import {
   normalizeAddTypeInput
-} from "./chunk-7QKSLAHB.js";
+} from "./chunk-AIWGQK6K.js";
 import {
   DEFAULT_RUNTIME_STATUS_DEFINITIONS,
   RUNTIME_FIELD_COMMAND_VALUES,
   RUNTIME_FIELD_TYPE_VALUES,
   RUNTIME_STATUS_ROLE_VALUES,
   evictOldestMemoEntries
-} from "./chunk-MFLLULHU.js";
+} from "./chunk-TB2CZJAQ.js";
 
 // dist/core/schema/status-defs-file.js
 var RUNTIME_STATUS_ROLE_SET = new Set(RUNTIME_STATUS_ROLE_VALUES);
@@ -526,6 +526,6 @@ export {
   normalizeTypePresetName,
   resolveTypePresetDefinitions
 };
-//# sourceMappingURL=chunk-YSRXFGNV.js.map
+//# sourceMappingURL=chunk-FSD7W7Y2.js.map
 
 //# debugId=15c384ad-9069-5ef0-bf3d-94b32fd19a03

package/dist/cli-bundle/chunks/{chunk-JYVPLGOW.js → chunk-FWL5XVYI.js}

@@ -6,7 +6,7 @@ import {
   renameArtifactsResultKey,
   runLinkedArtifacts,
   sortLinkedArtifacts
-} from "./chunk-6FU5BVRB.js";
+} from "./chunk-RAE2SLNO.js";
 import {
   resolveAuthor
 } from "./chunk-T5RRNDA7.js";
@@ -17,7 +17,7 @@ import {
   mutateItem,
   readLocatedItem,
   readSettings
-} from "./chunk-NTOOEVJ4.js";
+} from "./chunk-Y5Q4FEE4.js";
 import {
   EXIT_CODE,
   getSettingsPath,
@@ -25,7 +25,7 @@ import {
   pathExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-MFLLULHU.js";
+} from "./chunk-TB2CZJAQ.js";
 
 // dist/cli/commands/files.js
 import fs from "node:fs/promises";
@@ -286,6 +286,6 @@ export {
   runFiles,
   runFilesDiscover
 };
-//# sourceMappingURL=chunk-JYVPLGOW.js.map
+//# sourceMappingURL=chunk-FWL5XVYI.js.map
 
 //# debugId=e9df2560-179f-5612-abb9-6b4a3417a34f

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

@@ -1,14 +1,14 @@
 
-!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";
 import {
   scanHistoryDrift
-} from "./chunk-6TD5QGIB.js";
+} from "./chunk-77CWXIAC.js";
 import {
   wrapOwnershipConflict
-} from "./chunk-INOWVPUD.js";
+} from "./chunk-J3ELHLOJ.js";
 import {
   resolveAuthor
 } from "./chunk-T5RRNDA7.js";
@@ -17,14 +17,14 @@ import {
   TELEMETRY_MAX_QUEUE_ENTRY_ATTEMPTS,
   TELEMETRY_SCHEMA_VERSION,
   flushTelemetryQueueNow
-} from "./chunk-YUMNZS3X.js";
+} from "./chunk-ZQ2KEWE7.js";
 import {
   buildCapabilityContractMetadata,
   buildRegistrationCollisionRemediation,
   collectUnknownCapabilityGuidance,
   readManagedExtensionState,
   runInit
-} from "./chunk-GE44TQMC.js";
+} from "./chunk-CUBPPDDF.js";
 import {
   collectStaleVectorizationIds
 } from "./chunk-ROGZTCCB.js";
@@ -35,10 +35,10 @@ import {
   computeMetadataCoverage,
   groupItemsByDimension,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-J6AD3GWC.js";
+} from "./chunk-JNELC5UO.js";
 import {
   parseLimit
-} from "./chunk-6RR4XM5H.js";
+} from "./chunk-UYK26VRP.js";
 import {
   buildVectorizationEmbeddingIdentity,
   hasVectorizationEmbeddingIdentityChanged,
@@ -48,7 +48,7 @@ import {
   resolveProviderConfigSource,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-G4FKP4ID.js";
+} from "./chunk-DWGHHSDC.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-2RW5DWHQ.js";
 import {
   LINKED_TEST_PM_CONTEXT_MODE_VALUES,
   LINKED_TEST_PROTECTED_ENV_KEYS,
@@ -158,12 +158,12 @@ import {
   parseLinkedTestRegexList,
   parseLinkedTestStringList,
   runCreate
-} from "./chunk-TUDAYIO7.js";
+} from "./chunk-NQTIOKHL.js";
 import {
   createStdinTokenResolver,
   parseCsvKv,
   parseOptionalNumber
-} from "./chunk-3SHDAKMF.js";
+} from "./chunk-GPPWUJMR.js";
 import {
   CURRENT_ITEM_FORMAT_VERSION,
   PmCliError,
@@ -192,7 +192,7 @@ import {
   stableValueEquals,
   toItemRecord,
   writeSettings
-} from "./chunk-NTOOEVJ4.js";
+} from "./chunk-Y5Q4FEE4.js";
 import {
   DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS,
   DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS,
@@ -232,7 +232,7 @@ import {
   statusIsTerminal,
   toNonEmptyStringOrUndefined,
   writeFileAtomic
-} from "./chunk-MFLLULHU.js";
+} from "./chunk-TB2CZJAQ.js";
 
 // dist/sdk/start-task-status.js
 function resolveStartTaskInProgressStatus(statusRegistry) {
@@ -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-DK3GAY5D.js");
       const updateOptions = { message: VALIDATE_AUTO_FIX_MESSAGE };
       if (fix.kind === "set_resolution") {
         updateOptions.resolution = fix.value;
@@ -10124,10 +10219,10 @@ async function applyValidateFixes(applicable, global) {
     const remove = batch.map((fix) => fix.path).filter((value) => typeof value === "string" && value.length > 0);
     try {
       if (first.kind === "prune_file_link") {
-        const { runFiles } = await import("./files-QEFQ2M3H.js");
+        const { runFiles } = await import("./files-4OH2I663.js");
         await runFiles(first.item_id, { remove, message: VALIDATE_AUTO_FIX_MESSAGE }, global);
       } else {
-        const { runDocs } = await import("./docs-DR74ITCD.js");
+        const { runDocs } = await import("./docs-2NIRGHAN.js");
         await runDocs(first.item_id, { remove, message: VALIDATE_AUTO_FIX_MESSAGE }, global);
       }
       applied.push(...batch);
@@ -10315,6 +10410,6 @@ export {
   runTestRunsWorker,
   runValidate
 };
-//# sourceMappingURL=chunk-KMXVZ2P7.js.map
+//# sourceMappingURL=chunk-FYMHD6VX.js.map
 
-//# debugId=df88cd5a-9d83-5cae-849e-f4d9082219a9
+//# debugId=e4bc1071-3165-522e-b81f-8e280a88d93d