@unbrained/pm-cli 2026.7.8 → 2026.7.10

package/dist/cli-bundle/chunks/{chunk-SIQGG335.js → chunk-GMNCW27N.js}

@@ -2,22 +2,22 @@
 !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]="82206098-4fb2-5ba8-9c57-4eb1ac8e1688")}catch(e){}}();
 import {
   scanHistoryDrift
-} from "./chunk-6TD5QGIB.js";
+} from "./chunk-77CWXIAC.js";
 import {
   executeHistoryRewrite,
   resolveHistorySubject,
   writeHistoryRawWithRollback
-} from "./chunk-JH5XDDYS.js";
+} from "./chunk-TM5E2IED.js";
 import {
   readHistoryEntries
-} from "./chunk-6WCXSC5V.js";
+} from "./chunk-ZGDJA6WI.js";
 import {
   historyEntriesToRaw,
   reanchorHistoryEntries,
   replayHash,
   toReplayDocument,
   verifyHistoryChain
-} from "./chunk-IINCZYM3.js";
+} from "./chunk-62ECRG6J.js";
 import {
   PmCliError,
   getActiveExtensionRegistrations,
@@ -26,7 +26,7 @@ import {
   readLocatedItem,
   readSettings,
   runActiveOnWriteHooks
-} from "./chunk-NTOOEVJ4.js";
+} from "./chunk-Y5Q4FEE4.js";
 import {
   EXIT_CODE,
   getSettingsPath,
@@ -34,7 +34,7 @@ import {
   readFileIfExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-MFLLULHU.js";
+} from "./chunk-TB2CZJAQ.js";
 
 // dist/cli/commands/history-repair.js
 import jsonPatch from "fast-json-patch";
@@ -266,6 +266,6 @@ export {
   assertHistoryRepairTarget,
   runHistoryRepairAll
 };
-//# sourceMappingURL=chunk-SIQGG335.js.map
+//# sourceMappingURL=chunk-GMNCW27N.js.map
 
 //# debugId=82206098-4fb2-5ba8-9c57-4eb1ac8e1688

package/dist/cli-bundle/chunks/{chunk-3SHDAKMF.js → chunk-GPPWUJMR.js}

@@ -2,10 +2,10 @@
 !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]="cd15293c-3e04-5469-83ba-98eb60bd6b28")}catch(e){}}();
 import {
   PmCliError
-} from "./chunk-NTOOEVJ4.js";
+} from "./chunk-Y5Q4FEE4.js";
 import {
   EXIT_CODE
-} from "./chunk-MFLLULHU.js";
+} from "./chunk-TB2CZJAQ.js";
 
 // dist/core/item/parse.js
 var STDIN_TOKEN = "-";
@@ -353,6 +353,6 @@ export {
   createStdinTokenResolver,
   parseOptionalNumber
 };
-//# sourceMappingURL=chunk-3SHDAKMF.js.map
+//# sourceMappingURL=chunk-GPPWUJMR.js.map
 
 //# debugId=cd15293c-3e04-5469-83ba-98eb60bd6b28

package/dist/cli-bundle/chunks/{chunk-W2VFNVSJ.js → chunk-H3HKQXQJ.js}

@@ -3,13 +3,13 @@
 import {
   PmCliError,
   nowIso
-} from "./chunk-NTOOEVJ4.js";
+} from "./chunk-Y5Q4FEE4.js";
 import {
   EXIT_CODE,
   pathExists,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-MFLLULHU.js";
+} from "./chunk-TB2CZJAQ.js";
 
 // dist/core/checkpoint/mutation-checkpoint.js
 import { mkdir, readFile } from "node:fs/promises";
@@ -123,6 +123,6 @@ export {
   loadMutationCheckpoint,
   restoreCheckpointItems
 };
-//# sourceMappingURL=chunk-W2VFNVSJ.js.map
+//# sourceMappingURL=chunk-H3HKQXQJ.js.map
 
 //# debugId=2da7a3ac-115d-58d6-936c-0d0a1a8a57c8

package/dist/cli-bundle/chunks/{chunk-UIHDZS6X.js → chunk-HFQ7QQZL.js}

@@ -2,16 +2,16 @@ import {
   executeHistoryRewrite,
   resolveHistorySubject,
   writeHistoryRawWithRollback
-} from "./chunk-K52C6YPA.js";
+} from "./chunk-QTJCMK2S.js";
 import {
   resolveAuthor
 } from "./chunk-WW4E2DC3.js";
 import {
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-UEATYUZW.js";
+} from "./chunk-M7JYEBPT.js";
 import {
   readHistoryEntries
-} from "./chunk-LHDHS4Z6.js";
+} from "./chunk-4QE5HOJY.js";
 import {
   cloneEmptyReplayDocument,
   historyEntriesToRaw,
@@ -20,7 +20,7 @@ import {
   toReplayDocument,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-GLMJLBLR.js";
+} from "./chunk-75NAGPEL.js";
 import {
   PmCliError,
   createHistoryEntry,
@@ -31,7 +31,7 @@ import {
   readSettings,
   runActiveOnReadHooks,
   runActiveOnWriteHooks
-} from "./chunk-BPJ5NYSJ.js";
+} from "./chunk-F7UA74OZ.js";
 import {
   EXIT_CODE,
   getSettingsPath,
@@ -40,7 +40,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-2BVD4ZD2.js";
+} from "./chunk-J3FDNQWM.js";
 
 // dist/cli/commands/history-compact.js
 import fs from "node:fs/promises";
@@ -556,4 +556,4 @@ export {
   assertHistoryCompactTarget,
   runHistoryCompactBulk
 };
-//# sourceMappingURL=chunk-UIHDZS6X.js.map
+//# sourceMappingURL=chunk-HFQ7QQZL.js.map

package/dist/cli-bundle/chunks/{chunk-Z6RLSNUX.js → chunk-HLUB7G6J.js}

@@ -1,13 +1,13 @@
 import {
   PmCliError,
   nowIso
-} from "./chunk-BPJ5NYSJ.js";
+} from "./chunk-F7UA74OZ.js";
 import {
   EXIT_CODE,
   pathExists,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-2BVD4ZD2.js";
+} from "./chunk-J3FDNQWM.js";
 
 // dist/core/checkpoint/mutation-checkpoint.js
 import { mkdir, readFile } from "node:fs/promises";
@@ -128,4 +128,4 @@ export {
   loadMutationCheckpoint,
   restoreCheckpointItems
 };
-//# sourceMappingURL=chunk-Z6RLSNUX.js.map
+//# sourceMappingURL=chunk-HLUB7G6J.js.map

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

@@ -3,10 +3,10 @@ import {
 } from "./chunk-7M2HAZEB.js";
 import {
   scanHistoryDrift
-} from "./chunk-QLEH6FTQ.js";
+} from "./chunk-LVVZLEW5.js";
 import {
   wrapOwnershipConflict
-} from "./chunk-TKWTJGD6.js";
+} from "./chunk-ZIU35KME.js";
 import {
   resolveAuthor
 } from "./chunk-WW4E2DC3.js";
@@ -15,14 +15,14 @@ import {
   TELEMETRY_MAX_QUEUE_ENTRY_ATTEMPTS,
   TELEMETRY_SCHEMA_VERSION,
   flushTelemetryQueueNow
-} from "./chunk-GO2X6ZRB.js";
+} from "./chunk-35U3AVRY.js";
 import {
   buildCapabilityContractMetadata,
   buildRegistrationCollisionRemediation,
   collectUnknownCapabilityGuidance,
   readManagedExtensionState,
   runInit
-} from "./chunk-FL625JJM.js";
+} from "./chunk-Z3R2Z5KW.js";
 import {
   collectStaleVectorizationIds
 } from "./chunk-VPLDQMW2.js";
@@ -33,10 +33,10 @@ import {
   computeMetadataCoverage,
   groupItemsByDimension,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-UEATYUZW.js";
+} from "./chunk-M7JYEBPT.js";
 import {
   parseLimit
-} from "./chunk-BFNFTHWQ.js";
+} from "./chunk-O67XP4FD.js";
 import {
   buildVectorizationEmbeddingIdentity,
   hasVectorizationEmbeddingIdentityChanged,
@@ -46,7 +46,7 @@ import {
   resolveProviderConfigSource,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-PJPZTE7P.js";
+} from "./chunk-A62N3BM3.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-EXG6XTJC.js";
 import {
   LINKED_TEST_PM_CONTEXT_MODE_VALUES,
   LINKED_TEST_PROTECTED_ENV_KEYS,
@@ -156,12 +156,12 @@ import {
   parseLinkedTestRegexList,
   parseLinkedTestStringList,
   runCreate
-} from "./chunk-XPSGJ4IV.js";
+} from "./chunk-OVYXSZOQ.js";
 import {
   createStdinTokenResolver,
   parseCsvKv,
   parseOptionalNumber
-} from "./chunk-CGDUIPJL.js";
+} from "./chunk-22PW73KV.js";
 import {
   CURRENT_ITEM_FORMAT_VERSION,
   PmCliError,
@@ -190,7 +190,7 @@ import {
   stableValueEquals,
   toItemRecord,
   writeSettings
-} from "./chunk-BPJ5NYSJ.js";
+} from "./chunk-F7UA74OZ.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-2BVD4ZD2.js";
+} from "./chunk-J3FDNQWM.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-SDIRJGSY.js");
+      const { runUpdate } = await import("./update-OIMRKTX6.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-H5YCA74Z.js");
+        const { runFiles } = await import("./files-5KNAFW67.js");
         await runFiles(first.item_id, { remove, message: VALIDATE_AUTO_FIX_MESSAGE }, global2);
       } else {
-        const { runDocs } = await import("./docs-WCVYY6I7.js");
+        const { runDocs } = await import("./docs-SOY2CMH3.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-ASMRSIDX.js.map
+//# sourceMappingURL=chunk-HWUIK7YL.js.map