@unbrained/pm-cli 2026.6.6 → 2026.6.8

package/dist/cli-bundle/main.js

@@ -5,10 +5,13 @@ import {
   emitTelemetryErrorEvent,
   finishTelemetryCommand,
   startTelemetryCommand
-} from "./chunks/chunk-SKJWX3QB.js";
+} from "./chunks/chunk-TXKENAQP.js";
 import {
   migrateItemFilesToFormat
-} from "./chunks/chunk-KJ33AOCY.js";
+} from "./chunks/chunk-J4DKAGTM.js";
+import {
+  normalizeExtensionNameForMatch
+} from "./chunks/chunk-URJEZOLB.js";
 import {
   applyDefaultOutputFormat,
   clearResolvedGlobalOptions,
@@ -18,30 +21,30 @@ import {
   getGlobalOptions,
   invalidateSearchCachesForMutation,
   setResolvedGlobalOptions
-} from "./chunks/chunk-PDDFYW4X.js";
+} from "./chunks/chunk-VXBUXLVD.js";
 import {
   PM_CORE_COMMAND_NAMES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunks/chunk-PROOHX4K.js";
-import "./chunks/chunk-3FI4SEFT.js";
+} from "./chunks/chunk-DV27WDA7.js";
+import "./chunks/chunk-3E3MDBTB.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunks/chunk-LCM63IXU.js";
+} from "./chunks/chunk-N4SQZ7L3.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-2HMD3JM2.js";
+import "./chunks/chunk-K62SNVVE.js";
+import "./chunks/chunk-M7UBTVFT.js";
 import {
   commandOptionFlagLabel,
   resolveCommandOptionPolicyState,
   resolveItemTypeRegistry,
   resolveTypeDefinition
-} from "./chunks/chunk-KJE2FOS4.js";
-import "./chunks/chunk-QO7EBBOM.js";
+} from "./chunks/chunk-2BYKYPWY.js";
+import "./chunks/chunk-QFVASU44.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -60,6 +63,7 @@ import {
   readSettings,
   readSettingsWithMetadata,
   resolveGlobalPmRoot,
+  resolvePmCliVersion,
   resolvePmPackageRootFromModule,
   resolvePmRoot,
   resolveRuntimeFieldRegistry,
@@ -81,11 +85,9 @@ import {
   setActiveExtensionServices,
   toNonEmptyStringOrUndefined,
   writeSettings
-} from "./chunks/chunk-U5SXYXSY.js";
+} from "./chunks/chunk-3TXWDGPU.js";
 
 // dist/cli/main.js
-import fs2 from "node:fs";
-import path2 from "node:path";
 import { Command } from "commander";
 
 // dist/core/telemetry/consent.js
@@ -171,12 +173,10 @@ async function maybeRunFirstUseTelemetryPrompt(commandPath, globalOptions) {
 }
 
 // dist/core/sentry/instrument.js
-import fs from "node:fs";
-import path from "node:path";
 !(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] = "ae9dde85-c598-5ac8-9e1e-eb5df1a52ca1");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "8db03e6a-d066-501e-98ea-09a81ba11273");
   } catch (e2) {
   }
 })();
@@ -318,16 +318,7 @@ function isKnownNoisyConsoleBreadcrumb(breadcrumb) {
   return breadcrumb.category === "console" && typeof breadcrumb.message === "string" && isKnownNoisyConsoleMessage(breadcrumb.message);
 }
 function resolveCliVersion() {
-  try {
-    const candidate = path.join(resolvePmPackageRootFromModule(import.meta.url, ["../../.."]), "package.json");
-    if (fs.existsSync(candidate)) {
-      const parsed = JSON.parse(fs.readFileSync(candidate, "utf8"));
-      if (typeof parsed.version === "string")
-        return parsed.version;
-    }
-  } catch {
-  }
-  return "0.0.0";
+  return resolvePmCliVersion(import.meta.url, ["../../.."]) ?? "0.0.0";
 }
 function resolveEnvironment() {
   const explicit = process.env.SENTRY_ENVIRONMENT?.trim();
@@ -927,7 +918,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 +1377,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 +1692,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 +1753,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 +1789,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 +2349,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 +2488,8 @@ function collectExtensionCommandHelpDescriptors(commandHandlers, commandDefiniti
       flags: [],
       source: {
         layer: definition.layer,
-        name: definition.name
+        name: definition.name,
+        package: definition.source_package
       }
     });
   }
@@ -2704,38 +2726,44 @@ function ensureCommandPath(root, pathParts) {
 !(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] = "abcf109c-c846-5b61-b510-f1ad6ff4f3aa");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "15cb1a26-7d5f-525a-8cab-abc50e0f17c0");
   } catch (e2) {
   }
 })();
 function parseBootstrapPathToken(token, next) {
-  if (token === "--path") {
+  if (token === "--path" || token === "--pm-path") {
     if (typeof next === "string" && next.length > 0) {
       return {
         consumed: 2,
-        pathValue: next
+        pathValue: next,
+        preferred: token === "--pm-path"
       };
     }
     return {
-      consumed: 1
+      consumed: 1,
+      preferred: token === "--pm-path"
     };
   }
-  if (!token.startsWith("--path=")) {
+  const inlinePrefix = token.startsWith("--path=") ? "--path=" : token.startsWith("--pm-path=") ? "--pm-path=" : void 0;
+  if (!inlinePrefix) {
     return null;
   }
-  const value = token.slice("--path=".length);
+  const value = token.slice(inlinePrefix.length);
   if (value.length > 0) {
     return {
       consumed: 1,
-      pathValue: value
+      pathValue: value,
+      preferred: inlinePrefix === "--pm-path="
     };
   }
   return {
-    consumed: 1
+    consumed: 1,
+    preferred: inlinePrefix === "--pm-path="
   };
 }
 function parseBootstrapGlobalOptions(argv) {
-  let pathValue;
+  let legacyPathValue;
+  let pmPathValue;
   let noExtensions = false;
   let noPager = false;
   let json = false;
@@ -2769,7 +2797,11 @@ function parseBootstrapGlobalOptions(argv) {
     const parsedPath = parseBootstrapPathToken(token, argv[index + 1]);
     if (parsedPath) {
       if (parsedPath.pathValue !== void 0) {
-        pathValue = parsedPath.pathValue;
+        if (parsedPath.preferred) {
+          pmPathValue = parsedPath.pathValue;
+        } else {
+          legacyPathValue = parsedPath.pathValue;
+        }
       }
       index += parsedPath.consumed;
       continue;
@@ -2777,7 +2809,7 @@ function parseBootstrapGlobalOptions(argv) {
     index += 1;
   }
   return {
-    path: pathValue,
+    path: pmPathValue ?? legacyPathValue,
     noExtensions,
     noPager,
     json,
@@ -2796,11 +2828,11 @@ function stripGlobalBootstrapTokens(argv) {
       index += 1;
       continue;
     }
-    if (token === "--path") {
+    if (token === "--path" || token === "--pm-path") {
       index += 2;
       continue;
     }
-    if (token.startsWith("--path=")) {
+    if (token.startsWith("--path=") || token.startsWith("--pm-path=")) {
       index += 1;
       continue;
     }
@@ -2851,11 +2883,11 @@ function findCommandTokenIndex(argv) {
     if (token === "--") {
       return void 0;
     }
-    if (token === "--path") {
+    if (token === "--path" || token === "--pm-path") {
       index += 1;
       continue;
     }
-    if (token.startsWith("--path=") || token === "--json" || token === "--quiet" || token === "--no-extensions" || token === "--no-pager" || token === "--profile" || token === "--explain") {
+    if (token.startsWith("--path=") || token.startsWith("--pm-path=") || token === "--json" || token === "--quiet" || token === "--no-extensions" || token === "--no-pager" || token === "--profile" || token === "--explain") {
       continue;
     }
     if (token.startsWith("-")) {
@@ -3103,7 +3135,7 @@ function normalizeLongOptionToken(token, lookup) {
     }
   };
 }
-var GLOBAL_VALUE_CONSUMING_FLAGS = /* @__PURE__ */ new Set(["--path"]);
+var GLOBAL_VALUE_CONSUMING_FLAGS = /* @__PURE__ */ new Set(["--pm-path", "--path"]);
 function splitCanonicalListToken(token) {
   if (!token.startsWith("--")) {
     return null;
@@ -3435,7 +3467,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 +3608,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,11 +3781,12 @@ 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);
-  const examples = [.../* @__PURE__ */ new Set(["pm --help", ...suggestedPaths.map((path3) => `pm ${path3} --help`)])];
+  const examples = [.../* @__PURE__ */ new Set(["pm --help", ...suggestedPaths.map((path) => `pm ${path} --help`)])];
   const optionalPackageHint = resolveOptionalPackageInstallHint(normalizedUnknown);
   const didYouMean = combinedCandidates.length > 0 ? `Did you mean: ${combinedCandidates.slice(0, 3).join(", ")}?` : null;
   return {
@@ -3733,6 +3802,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 +3885,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 +4222,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] = "aead80b1-f418-5252-a0b9-6ab1ea18d330");
   } catch (e2) {
   }
 })();
@@ -4171,10 +4261,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-ABA2JPWO.js"));
+var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-GQAEIG4K.js"));
+var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-YZCUILGO.js"));
+var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-IBYWNJN5.js"));
 function describeUnknownError(error) {
   if (error instanceof PmCliError) {
     return error.message;
@@ -4247,7 +4337,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 ?? {},
@@ -4469,6 +4561,7 @@ function extractCommandScopedOptions(command, commandArgs, extensionFlagDefiniti
   delete scoped.json;
   delete scoped.quiet;
   delete scoped.path;
+  delete scoped.pmPath;
   delete scoped.noExtensions;
   delete scoped.extensions;
   delete scoped.profile;
@@ -4855,14 +4948,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 +4982,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 +5068,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) {
@@ -5254,17 +5335,7 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
     });
   }
 }
-function resolveCliVersion2() {
-  try {
-    const packageJsonPath = path2.join(resolvePmPackageRoot(), "package.json");
-    const raw = fs2.readFileSync(packageJsonPath, "utf8");
-    const parsed = JSON.parse(raw);
-    return typeof parsed.version === "string" ? parsed.version : "0.0.0";
-  } catch {
-    return "0.0.0";
-  }
-}
-var CLI_VERSION = resolveCliVersion2();
+var CLI_VERSION = resolvePmCliVersion(import.meta.url, ["../.."]) ?? "0.0.0";
 var program = new Command();
 program.name("pm").description("Universal, flexible, extensible, agent-optimized project management CLI for any project or programming language.").version(CLI_VERSION).showHelpAfterError(false).allowExcessArguments(false).allowUnknownOption(false).configureOutput({
   writeOut: (str) => {
@@ -5273,7 +5344,7 @@ program.name("pm").description("Universal, flexible, extensible, agent-optimized
   // Commander errors are rendered in our own catch path.
   writeErr: () => {
   }
-}).option("--json", "Output JSON instead of TOON").option("--quiet", "Suppress stdout output").option("--no-changed-fields", "Omit the changed_fields array from mutation output (keeps changed_field_count)").option("--path <dir>", "Override PM path for this command").option("--no-extensions", "Disable extension loading").option("--no-pager", "Disable pager integration for help and long output").option("--explain", "Render extended rationale and examples in help output").option("--profile", "Print deterministic timing diagnostics").exitOverride();
+}).option("--json", "Output JSON instead of TOON").option("--quiet", "Suppress stdout output").option("--no-changed-fields", "Omit the changed_fields array from mutation output (keeps changed_field_count)").option("--pm-path <dir>", "Explicit tracker storage path for this command (preferred over --path)").option("--path <dir>", "Backward-compatible alias for --pm-path; this is the tracker storage path, not a workspace cwd").option("--no-extensions", "Disable extension loading").option("--no-pager", "Disable pager integration for help and long output").option("--explain", "Render extended rationale and examples in help output").option("--profile", "Print deterministic timing diagnostics").exitOverride();
 program.hook("preAction", async (_thisCommand, actionCommand) => {
   activeExtensionHookContext = null;
   activeTelemetryCommandContext = null;
@@ -5779,7 +5850,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 +5882,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 +6040,7 @@ async function runPmCli(rawArgv = process.argv.slice(2)) {
   }
 }
 var _testOnly = {
+  buildPmCliRecoveryContext,
   isCommanderError,
   normalizeThrownExitCode,
   readThrownExitCode,