@unbrained/pm-cli 2026.7.7 → 2026.7.9

package/dist/cli-bundle/chunks/{chunk-Y7KYVCZM.js → chunk-NGBWEYNY.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   readHistoryEntries
-} from "./chunk-M62RO3XK.js";
+} from "./chunk-LHDHS4Z6.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   normalizeReplayPatchOps,
@@ -11,7 +11,7 @@ import {
   replayToCanonicalItemDocument,
   replayToItemDocument,
   toReplayDocument
-} from "./chunk-E3YQFSFE.js";
+} from "./chunk-GLMJLBLR.js";
 import {
   PmCliError,
   acquireLock,
@@ -30,7 +30,7 @@ import {
   recordAfterCommandAffectedItem,
   runActiveOnWriteHooks,
   serializeItemDocument
-} from "./chunk-YNCFP5AR.js";
+} from "./chunk-BPJ5NYSJ.js";
 import {
   EXIT_CODE,
   getHistoryPath,
@@ -41,7 +41,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   writeFileAtomic
-} from "./chunk-LCFJ7XAM.js";
+} from "./chunk-2BVD4ZD2.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -420,4 +420,4 @@ export {
   runRestore,
   _testOnlyRestoreCommand
 };
-//# sourceMappingURL=chunk-Y7KYVCZM.js.map
+//# sourceMappingURL=chunk-NGBWEYNY.js.map

package/dist/cli-bundle/chunks/{chunk-RB3KLPAH.js → chunk-NRMDT4OV.js}

@@ -4,7 +4,7 @@ import {
   clearFocusedItem,
   getFocusedItem,
   setFocusedItem
-} from "./chunk-EDO7VXSO.js";
+} from "./chunk-EP2CKDS7.js";
 import {
   PmCliError,
   buildItemNotFoundError,
@@ -13,14 +13,14 @@ import {
   normalizeItemId,
   readLocatedItem,
   readSettings
-} from "./chunk-GH73UOSJ.js";
+} from "./chunk-NTOOEVJ4.js";
 import {
   EXIT_CODE,
   getSettingsPath,
   pathExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-UO7XAZK6.js";
+} from "./chunk-MFLLULHU.js";
 
 // dist/cli/commands/focus.js
 async function ensureInitialized(pmRoot) {
@@ -96,6 +96,6 @@ function nonEmptyTitleOrNull(title) {
 export {
   runFocus
 };
-//# sourceMappingURL=chunk-RB3KLPAH.js.map
+//# sourceMappingURL=chunk-NRMDT4OV.js.map
 
 //# debugId=872399d7-7488-5dd9-8c55-4c1b3cd3eb99

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

@@ -3,10 +3,10 @@ import {
 } from "./chunk-7M2HAZEB.js";
 import {
   scanHistoryDrift
-} from "./chunk-HHEWQXPD.js";
+} from "./chunk-QLEH6FTQ.js";
 import {
   wrapOwnershipConflict
-} from "./chunk-43SIHQND.js";
+} from "./chunk-TKWTJGD6.js";
 import {
   resolveAuthor
 } from "./chunk-WW4E2DC3.js";
@@ -15,14 +15,14 @@ import {
   TELEMETRY_MAX_QUEUE_ENTRY_ATTEMPTS,
   TELEMETRY_SCHEMA_VERSION,
   flushTelemetryQueueNow
-} from "./chunk-KTGJ2CBU.js";
+} from "./chunk-GO2X6ZRB.js";
 import {
   buildCapabilityContractMetadata,
   buildRegistrationCollisionRemediation,
   collectUnknownCapabilityGuidance,
   readManagedExtensionState,
   runInit
-} from "./chunk-X47MKQXU.js";
+} from "./chunk-YHKXNGLA.js";
 import {
   collectStaleVectorizationIds
 } from "./chunk-VPLDQMW2.js";
@@ -33,10 +33,10 @@ import {
   computeMetadataCoverage,
   groupItemsByDimension,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-FN6SB4HU.js";
+} from "./chunk-UEATYUZW.js";
 import {
   parseLimit
-} from "./chunk-ZO7CLOY2.js";
+} from "./chunk-BFNFTHWQ.js";
 import {
   buildVectorizationEmbeddingIdentity,
   hasVectorizationEmbeddingIdentityChanged,
@@ -46,7 +46,7 @@ import {
   resolveProviderConfigSource,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-6XTSYPPO.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-YCVWWIKY.js";
+} from "./chunk-K4NMHZR3.js";
 import {
   LINKED_TEST_PM_CONTEXT_MODE_VALUES,
   LINKED_TEST_PROTECTED_ENV_KEYS,
@@ -156,12 +156,12 @@ import {
   parseLinkedTestRegexList,
   parseLinkedTestStringList,
   runCreate
-} from "./chunk-XC3X7BQR.js";
+} from "./chunk-K2OKKYSO.js";
 import {
   createStdinTokenResolver,
   parseCsvKv,
   parseOptionalNumber
-} from "./chunk-2TILG6F2.js";
+} from "./chunk-CGDUIPJL.js";
 import {
   CURRENT_ITEM_FORMAT_VERSION,
   PmCliError,
@@ -190,7 +190,7 @@ import {
   stableValueEquals,
   toItemRecord,
   writeSettings
-} from "./chunk-YNCFP5AR.js";
+} from "./chunk-BPJ5NYSJ.js";
 import {
   DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS,
   DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS,
@@ -230,7 +230,7 @@ import {
   statusIsTerminal,
   toNonEmptyStringOrUndefined,
   writeFileAtomic
-} from "./chunk-LCFJ7XAM.js";
+} from "./chunk-2BVD4ZD2.js";
 
 // dist/sdk/start-task-status.js
 !(function() {
@@ -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-CJGG5WMV.js");
+      const { runUpdate } = await import("./update-76CRUMC7.js");
       const updateOptions = { message: VALIDATE_AUTO_FIX_MESSAGE };
       if (fix.kind === "set_resolution") {
         updateOptions.resolution = fix.value;
@@ -10304,10 +10399,10 @@ async function applyValidateFixes(applicable, global2) {
     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-72HZEBOE.js");
+        const { runFiles } = await import("./files-H5YCA74Z.js");
         await runFiles(first.item_id, { remove, message: VALIDATE_AUTO_FIX_MESSAGE }, global2);
       } else {
-        const { runDocs } = await import("./docs-VNPBZXEL.js");
+        const { runDocs } = await import("./docs-WCVYY6I7.js");
         await runDocs(first.item_id, { remove, message: VALIDATE_AUTO_FIX_MESSAGE }, global2);
       }
       applied.push(...batch);
@@ -10495,4 +10590,4 @@ export {
   runTestRunsWorker,
   runValidate
 };
-//# sourceMappingURL=chunk-TZLYO4PP.js.map
+//# sourceMappingURL=chunk-NRYZ4QLH.js.map