@unbrained/pm-cli 2026.6.6 → 2026.6.7

package/dist/cli-bundle/main.js

@@ -5,10 +5,13 @@ import {
   emitTelemetryErrorEvent,
   finishTelemetryCommand,
   startTelemetryCommand
-} from "./chunks/chunk-SKJWX3QB.js";
+} from "./chunks/chunk-WR5567FH.js";
 import {
   migrateItemFilesToFormat
-} from "./chunks/chunk-KJ33AOCY.js";
+} from "./chunks/chunk-AVJD6VTA.js";
+import {
+  normalizeExtensionNameForMatch
+} from "./chunks/chunk-THDEID2Z.js";
 import {
   applyDefaultOutputFormat,
   clearResolvedGlobalOptions,
@@ -18,30 +21,30 @@ import {
   getGlobalOptions,
   invalidateSearchCachesForMutation,
   setResolvedGlobalOptions
-} from "./chunks/chunk-PDDFYW4X.js";
+} from "./chunks/chunk-M2PW7EZU.js";
 import {
   PM_CORE_COMMAND_NAMES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunks/chunk-PROOHX4K.js";
-import "./chunks/chunk-3FI4SEFT.js";
+} from "./chunks/chunk-MWRS7Z4P.js";
+import "./chunks/chunk-WAA7UI6M.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunks/chunk-LCM63IXU.js";
+} from "./chunks/chunk-UAQOQ7IE.js";
 import {
   levenshteinDistanceWithinLimit
 } from "./chunks/chunk-EAOG77HM.js";
-import "./chunks/chunk-XTGLRY2Y.js";
-import "./chunks/chunk-T3LC5LKB.js";
-import "./chunks/chunk-AO442XLN.js";
+import "./chunks/chunk-TP4DDY27.js";
+import "./chunks/chunk-2IXCHCLM.js";
+import "./chunks/chunk-WCQZBDDH.js";
 import {
   commandOptionFlagLabel,
   resolveCommandOptionPolicyState,
   resolveItemTypeRegistry,
   resolveTypeDefinition
-} from "./chunks/chunk-KJE2FOS4.js";
-import "./chunks/chunk-QO7EBBOM.js";
+} from "./chunks/chunk-HRMHZ4RV.js";
+import "./chunks/chunk-FHHBD7PN.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -81,7 +84,7 @@ import {
   setActiveExtensionServices,
   toNonEmptyStringOrUndefined,
   writeSettings
-} from "./chunks/chunk-U5SXYXSY.js";
+} from "./chunks/chunk-UJUT6AHZ.js";
 
 // dist/cli/main.js
 import fs2 from "node:fs";
@@ -927,7 +930,7 @@ function parseLooseCommandOptions(args) {
 !(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] = "74a0432a-8374-53db-8e95-5ebd38cf8557");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "ad4ec245-86cd-551a-814a-482b7a2442b8");
   } catch (e2) {
   }
 })();
@@ -1386,6 +1389,14 @@ var HELP_BY_COMMAND_PATH = {
     why: "Inspects item mutation timeline and audit trail.",
     examples: ["pm history pm-a1b2 --limit 20", "pm history pm-a1b2 --full --verify"]
   },
+  "history-compact": {
+    why: "Compacts long history streams into a synthetic checkpoint while preserving replay integrity.",
+    examples: [
+      "pm history-compact pm-a1b2 --dry-run",
+      'pm history-compact pm-a1b2 --before 25 --author codex-agent --message "Compact early history"',
+      "pm history-compact pm-a1b2 --before 2026-06-01T00:00:00.000Z"
+    ]
+  },
   activity: {
     why: "Reviews recent tracker-wide activity across items.",
     examples: [
@@ -1693,7 +1704,7 @@ function renderPmCommand(argv) {
 !(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] = "883618a4-a53f-5506-ab97-d734647806e7");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "004f0f48-f016-51b6-b587-30101f5bb77f");
   } catch (e2) {
   }
 })();
@@ -1754,6 +1765,19 @@ function normalizeRecoveryPayload(payload) {
   if (typeof payload.suggested_retry === "string" && payload.suggested_retry.trim().length > 0) {
     normalized.suggested_retry = payload.suggested_retry.trim();
   }
+  if (Array.isArray(payload.fallback_candidates)) {
+    const fallbackCandidates = payload.fallback_candidates.map((entry) => ({
+      source: typeof entry?.source === "string" ? entry.source.trim() : "",
+      command: typeof entry?.command === "string" ? entry.command.trim() : "",
+      reason: typeof entry?.reason === "string" ? entry.reason.trim() : ""
+    })).filter((entry) => entry.source.length > 0 && entry.command.length > 0 && entry.reason.length > 0);
+    if (fallbackCandidates.length > 0) {
+      normalized.fallback_candidates = fallbackCandidates;
+    }
+  }
+  if (typeof payload.next_best_command === "string" && payload.next_best_command.trim().length > 0) {
+    normalized.next_best_command = payload.next_best_command.trim();
+  }
   return Object.keys(normalized).length > 0 ? normalized : void 0;
 }
 function renderRecoveryBundle(recovery) {
@@ -1777,6 +1801,15 @@ function renderRecoveryBundle(recovery) {
   if (normalized.suggested_retry) {
     lines.push(`  suggested_retry: ${normalized.suggested_retry}`);
   }
+  if (normalized.next_best_command) {
+    lines.push(`  next_best_command: ${normalized.next_best_command}`);
+  }
+  if (normalized.fallback_candidates && normalized.fallback_candidates.length > 0) {
+    lines.push("  fallback_candidates:");
+    for (const candidate of normalized.fallback_candidates) {
+      lines.push(`    - ${candidate.source}: ${candidate.command} (${candidate.reason})`);
+    }
+  }
   return lines;
 }
 function renderGuidanceMessage(message) {
@@ -2328,7 +2361,7 @@ function createLazyModule(importer) {
 !(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] = "f118ae9c-7572-5edd-9647-3be1fe888f91");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b2d550e5-da06-5832-85f4-a3c40208d78d");
   } catch (e2) {
   }
 })();
@@ -2467,7 +2500,8 @@ function collectExtensionCommandHelpDescriptors(commandHandlers, commandDefiniti
       flags: [],
       source: {
         layer: definition.layer,
-        name: definition.name
+        name: definition.name,
+        package: definition.source_package
       }
     });
   }
@@ -3435,7 +3469,7 @@ async function enforceItemFormatWriteGateAndPreflightMigration(commandPath, opti
 !(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] = "b54efed6-c3b0-5b4d-9912-588c58198fba");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "591ae949-391a-5ede-8e92-15df7e3264df");
   } catch (e2) {
   }
 })();
@@ -3576,6 +3610,42 @@ function resolveOptionalPackageInstallHint(commandPath) {
   }
   return `If this command comes from an optional package, install it with: pm install ${packageAlias}`;
 }
+function normalizePackageCommandAliasToken(value) {
+  let normalized = normalizeExtensionNameForMatch(value);
+  for (const prefix of ["@unbraind/", "@unbrained/", "builtin-", "pm-"]) {
+    if (normalized.startsWith(prefix)) {
+      normalized = normalized.slice(prefix.length);
+    }
+  }
+  return normalized;
+}
+function collectInstalledPackageCommandPathHints(unknownToken, extensionDescriptors) {
+  const normalizedUnknown = normalizePackageCommandAliasToken(unknownToken);
+  if (normalizedUnknown.length === 0) {
+    return [];
+  }
+  const hints = [];
+  for (const descriptor of extensionDescriptors.values()) {
+    const identifiers = /* @__PURE__ */ new Set();
+    const source = descriptor.source;
+    if (source) {
+      for (const identifier of [source.name, source.package]) {
+        const normalizedIdentifier = normalizePackageCommandAliasToken(identifier ?? "");
+        if (normalizedIdentifier.length > 0) {
+          identifiers.add(normalizedIdentifier);
+        }
+      }
+    }
+    if (identifiers.size === 0) {
+      continue;
+    }
+    const matches = [...identifiers].some((identifier) => identifier === normalizedUnknown || identifier.includes(normalizedUnknown) || normalizedUnknown.includes(identifier));
+    if (matches) {
+      hints.push(descriptor.command);
+    }
+  }
+  return [...new Set(hints)].sort((left, right) => left.localeCompare(right));
+}
 function collectKnownLongFlags(commandName) {
   const flags = /* @__PURE__ */ new Set();
   const contracts = resolveSubcommandFlagContractsForCommand(commandName);
@@ -3713,7 +3783,8 @@ function buildUnknownCommandGuidanceFromRuntime(rawMessage, root, extensionDescr
     return left.commandPath.localeCompare(right.commandPath);
   }).map((entry) => entry.commandPath);
   const aliasCandidates = (COMMON_COMMAND_ALIASES[primaryToken] ?? []).filter((aliasPath) => commandPaths.includes(aliasPath));
-  const combinedCandidates = dedupeStrings2([...aliasCandidates, ...rankedCandidates]);
+  const installedPackageCandidates = collectInstalledPackageCommandPathHints(primaryToken, extensionDescriptors).filter((commandPath) => commandPaths.includes(commandPath));
+  const combinedCandidates = dedupeStrings2([...aliasCandidates, ...rankedCandidates, ...installedPackageCandidates]);
   const fallbackTopLevel = [...new Set(commandPaths.map((commandPath) => commandPath.split(" ")[0]).filter((segment) => segment.length > 0))];
   fallbackTopLevel.sort((left, right) => left.localeCompare(right));
   const suggestedPaths = (combinedCandidates.length > 0 ? combinedCandidates : fallbackTopLevel).slice(0, 3);
@@ -3733,6 +3804,27 @@ function buildUnknownCommandGuidanceFromRuntime(rawMessage, root, extensionDescr
 function dedupeStrings2(values) {
   return Array.from(new Set(values));
 }
+function firstWhitespaceSeparatedToken(input2) {
+  let token = "";
+  for (const character of input2) {
+    if (character === " " || character === "	" || character === "\n" || character === "\r" || character === "\f" || character === "\v") {
+      break;
+    }
+    token += character;
+  }
+  return token;
+}
+function trimTrailingPunctuationToken(token) {
+  let end = token.length;
+  while (end > 0) {
+    const character = token[end - 1];
+    if (character !== "," && character !== ":" && character !== ";") {
+      break;
+    }
+    end -= 1;
+  }
+  return token.slice(0, end);
+}
 function resolveChildCommandByToken(parent, token) {
   const normalizedToken = token.trim().toLowerCase();
   return parent.commands.find((candidate) => {
@@ -3795,7 +3887,7 @@ async function resolveCommanderUsageContext(error, rootProgram, extensionDescrip
   }
   if (!suggestedRetryCommand) {
     const missingRequiredOption = message.match(/required option '([^']+)' not specified/i);
-    const requiredOptionToken = missingRequiredOption?.[1]?.trim().split(/\s+/)[0]?.replace(/[,:;]+$/g, "");
+    const requiredOptionToken = missingRequiredOption?.[1] ? trimTrailingPunctuationToken(firstWhitespaceSeparatedToken(missingRequiredOption[1].trim())) : void 0;
     if (requiredOptionToken?.startsWith("--")) {
       const hasFlag = invocationArgv.some((token) => token.startsWith(requiredOptionToken));
       if (!hasFlag) {
@@ -4132,7 +4224,7 @@ function attachCreateUpdatePolicyHelpText(rootProgram, typeRegistry, argv) {
 !(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] = "85d31f87-d392-5da2-9d53-1525fb938ff2");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "2b36a331-5896-50c4-a43a-b885bd2ad354");
   } catch (e2) {
   }
 })();
@@ -4171,10 +4263,10 @@ var EXPECTED_HANDLED_ERROR_EXIT_CODES = /* @__PURE__ */ new Set([
   EXIT_CODE.CONFLICT
 ]);
 var TRUE_LIKE_ENV_VALUES = /* @__PURE__ */ new Set(["1", "true", "yes", "on"]);
-var loadSetupRegistrationModule = createLazyModule(() => import("./chunks/register-setup-ZHJI2DI3.js"));
-var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-WST76HSQ.js"));
-var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-OA675SOU.js"));
-var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-N3PMHXH5.js"));
+var loadSetupRegistrationModule = createLazyModule(() => import("./chunks/register-setup-EJY44FPH.js"));
+var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-OECMHO4G.js"));
+var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-5GPDEKHR.js"));
+var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-GQKT35H5.js"));
 function describeUnknownError(error) {
   if (error instanceof PmCliError) {
     return error.message;
@@ -4247,7 +4339,9 @@ function buildPmCliRecoveryContext(context, invocationArgv, rawMessage) {
     normalized_args: existingRecovery?.normalized_args ?? [...invocationArgv],
     provided_fields: existingRecovery?.provided_fields ?? (providedFields.length > 0 ? providedFields : void 0),
     missing: existingRecovery?.missing ?? inferredMissing,
-    ...suggestedRetry ? { suggested_retry: suggestedRetry } : {}
+    ...suggestedRetry ? { suggested_retry: suggestedRetry } : {},
+    ...existingRecovery?.fallback_candidates ? { fallback_candidates: existingRecovery.fallback_candidates } : {},
+    ...existingRecovery?.next_best_command ? { next_best_command: existingRecovery.next_best_command } : {}
   };
   return {
     ...context ?? {},
@@ -4855,14 +4949,6 @@ async function loadRuntimeExtensionDiscoverySnapshot(pmRoot) {
   if (runtimeExtensionDiscoverySnapshotCache?.key === cacheKey) {
     return runtimeExtensionDiscoverySnapshotCache.snapshot;
   }
-  const settingsPath = getSettingsPath(pmRoot);
-  if (!await pathExists(settingsPath)) {
-    runtimeExtensionDiscoverySnapshotCache = {
-      key: cacheKey,
-      snapshot: null
-    };
-    return null;
-  }
   try {
     const startedAt = Date.now();
     const { settings, warnings: settingsReadWarnings } = await readSettingsWithMetadata(pmRoot);
@@ -4897,14 +4983,6 @@ async function loadRuntimeExtensionSnapshot(pmRoot) {
   if (runtimeExtensionSnapshotCache?.key === cacheKey) {
     return runtimeExtensionSnapshotCache.snapshot;
   }
-  const settingsPath = getSettingsPath(pmRoot);
-  if (!await pathExists(settingsPath)) {
-    runtimeExtensionSnapshotCache = {
-      key: cacheKey,
-      snapshot: null
-    };
-    return null;
-  }
   try {
     const settings = await readSettings(pmRoot);
     const loadResult = await loadExtensions({
@@ -4991,6 +5069,10 @@ async function maybeLoadRuntimeExtensions(command) {
     pmRoot
   };
 }
+async function loadRuntimeExtensionCommandDescriptorsForRecovery(pmRoot) {
+  const snapshot = await loadRuntimeExtensionSnapshot(pmRoot);
+  return snapshot ? new Map(snapshot.commandDescriptors) : activeRuntimeExtensionCommandDescriptors;
+}
 async function executeRegisteredRuntimeMigrations(migrations, pmRoot) {
   const warnings = [];
   for (let index = 0; index < migrations.length; index += 1) {
@@ -5779,7 +5861,8 @@ async function runPmCli(rawArgv = process.argv.slice(2)) {
         if (helpRequest.requested && !isKnownHelpCommandPath(program, helpRequest.commandPathTokens)) {
           const unknownToken = helpRequest.commandPathTokens[0] ?? parseBootstrapCommandName(invocationArgv) ?? "<command>";
           const unknownMessage = `unknown command '${unknownToken}'`;
-          const usageContext = await resolveCommanderUsageContext({ message: unknownMessage }, program, activeRuntimeExtensionCommandDescriptors);
+          const recoveryCommandDescriptors = await loadRuntimeExtensionCommandDescriptorsForRecovery(resolvePmRoot(process.cwd(), bootstrapGlobal.path));
+          const usageContext = await resolveCommanderUsageContext({ message: unknownMessage }, program, recoveryCommandDescriptors);
           const classification2 = classifyCommanderError(usageContext.message, usageContext.commandName, usageContext.allowedTypes, {
             unknownCommandExamples: usageContext.unknownCommandExamples,
             unknownCommandNextSteps: usageContext.unknownCommandNextSteps,
@@ -5810,7 +5893,7 @@ async function runPmCli(rawArgv = process.argv.slice(2)) {
             resolution_stage: "parse",
             source_context: activeTelemetryCommandContext?.source_context
           });
-          const renderedUsage = jsonErrors ? await formatCommanderUsageJson({ message: unknownMessage }, program, activeRuntimeExtensionCommandDescriptors) : await formatCommanderUsageMessage({ message: unknownMessage }, program, activeRuntimeExtensionCommandDescriptors);
+          const renderedUsage = jsonErrors ? await formatCommanderUsageJson({ message: unknownMessage }, program, recoveryCommandDescriptors) : await formatCommanderUsageMessage({ message: unknownMessage }, program, recoveryCommandDescriptors);
           sentryFinishCommandSpan(false, unknownMessage, {
             error_code: classification2.code,
             error_category: errorCategory2,
@@ -5968,6 +6051,7 @@ async function runPmCli(rawArgv = process.argv.slice(2)) {
   }
 }
 var _testOnly = {
+  buildPmCliRecoveryContext,
   isCommanderError,
   normalizeThrownExitCode,
   readThrownExitCode,