@unbrained/pm-cli 2026.7.18 → 2026.7.19

package/dist/cli-bundle/main.js

@@ -9,24 +9,31 @@ import {
   parseBootstrapHelpRequest,
   parseBootstrapTypeValue,
   stripGlobalBootstrapTokens
-} from "./chunks/chunk-TGBTLGPX.js";
+} from "./chunks/chunk-Q4PSG2GV.js";
+import {
+  PmClient,
+  createExtensionCommandSdk
+} from "./chunks/chunk-3EZZTFL2.js";
+import "./chunks/chunk-3KPNOZOH.js";
+import {
+  migrateItemFilesToFormat
+} from "./chunks/chunk-5S6IZXK7.js";
+import "./chunks/chunk-NTS2RKHN.js";
 import {
   deriveTelemetryCommandResolution,
   deriveTelemetryCommandTaxonomy,
   emitTelemetryErrorEvent,
   finishTelemetryCommand,
   startTelemetryCommand
-} from "./chunks/chunk-RTBX3C4C.js";
-import {
-  migrateItemFilesToFormat
-} from "./chunks/chunk-2BX74BAS.js";
+} from "./chunks/chunk-JBW2S2C6.js";
+import "./chunks/chunk-P24ZU5QV.js";
 import {
   normalizeExtensionNameForMatch,
   renderPmCommand
-} from "./chunks/chunk-74FKFFXO.js";
+} from "./chunks/chunk-ZF52NVRT.js";
 import {
   recordContextUsageTouches
-} from "./chunks/chunk-BAP7G3N2.js";
+} from "./chunks/chunk-AR24KW26.js";
 import {
   applyDefaultOutputFormat,
   clearResolvedGlobalOptions,
@@ -37,17 +44,67 @@ import {
   invalidateSearchCachesForMutation,
   setResolvedGlobalOptions,
   syncCommanderActionOptions
-} from "./chunks/chunk-7R6UIHYY.js";
+} from "./chunks/chunk-N2TEEOXJ.js";
+import "./chunks/chunk-NPEYH6CE.js";
+import "./chunks/chunk-PNTULOGU.js";
+import "./chunks/chunk-A3GAQLBH.js";
+import "./chunks/chunk-BFJP4VYC.js";
+import "./chunks/chunk-FQO5THHM.js";
+import "./chunks/chunk-UU6EP25G.js";
+import "./chunks/chunk-ZUCBPXNA.js";
+import "./chunks/chunk-YUSOJDWM.js";
+import "./chunks/chunk-AGEBQRBG.js";
 import {
   EXECUTABLE_COMMAND_ALIASES,
   PM_CORE_COMMAND_NAMES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunks/chunk-WQXRZMFN.js";
+} from "./chunks/chunk-EEECAV5M.js";
+import "./chunks/chunk-MQOSMBWV.js";
+import "./chunks/chunk-EVAN5VJA.js";
+import "./chunks/chunk-GKCEEXMA.js";
+import "./chunks/chunk-3QNUDDY2.js";
+import "./chunks/chunk-SGJB6PXA.js";
+import "./chunks/chunk-DOASIOQR.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunks/chunk-EHJFUOXL.js";
+} from "./chunks/chunk-7B7IHMLH.js";
+import "./chunks/chunk-OKPZDH43.js";
+import "./chunks/chunk-XDWXPG2E.js";
+import "./chunks/chunk-E7KBMWEF.js";
+import "./chunks/chunk-RX53WHFI.js";
+import "./chunks/chunk-3HKUXVKV.js";
+import "./chunks/chunk-EAV3P54W.js";
+import "./chunks/chunk-66SRNEBK.js";
+import "./chunks/chunk-6X5MZ5R2.js";
+import "./chunks/chunk-Q6JPYR7I.js";
+import "./chunks/chunk-ZHBI2AP7.js";
+import "./chunks/chunk-IXG5CMBR.js";
+import "./chunks/chunk-K2L6FZBX.js";
+import "./chunks/chunk-D6HZN36B.js";
+import "./chunks/chunk-CYCJBU3I.js";
+import "./chunks/chunk-KZ5AC6B5.js";
+import "./chunks/chunk-STBCBDKF.js";
+import "./chunks/chunk-Q3K5XPAQ.js";
+import "./chunks/chunk-KAE727L2.js";
+import "./chunks/chunk-OK7VSX3N.js";
+import "./chunks/chunk-4M6RZJXF.js";
+import "./chunks/chunk-OKWJUL6F.js";
+import "./chunks/chunk-A5EQPNV7.js";
+import "./chunks/chunk-4PSJVGRE.js";
+import "./chunks/chunk-XVB6BATY.js";
+import "./chunks/chunk-KWYX6ZIR.js";
+import "./chunks/chunk-YIC5NGXF.js";
+import "./chunks/chunk-N7FCFJ76.js";
+import "./chunks/chunk-7CHWLT2J.js";
+import "./chunks/chunk-QYGK2XQ3.js";
+import "./chunks/chunk-VQOG2ETB.js";
+import "./chunks/chunk-W6IEJXNC.js";
+import "./chunks/chunk-FQODDTE7.js";
+import "./chunks/chunk-A4FVWFZY.js";
+import "./chunks/chunk-RWAIRGBC.js";
+import "./chunks/chunk-YRYYFGV3.js";
 import {
   clearActiveExtensionHooks,
   consumeAfterCommandAffectedItems,
@@ -71,7 +128,7 @@ import {
   setActiveExtensionRenderers,
   setActiveExtensionServices,
   writeSettings
-} from "./chunks/chunk-646MQXFW.js";
+} from "./chunks/chunk-RLLOZAM2.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -81,6 +138,7 @@ import {
   commandOptionFlagLabel,
   createEmptyExtensionRegistrationRegistry,
   discoverExtensions,
+  discoverNearbyPmRoot,
   flattenFlagListValue,
   getSettingsPath,
   levenshteinDistanceWithinLimit,
@@ -99,7 +157,7 @@ import {
   runAfterCommandHooks,
   runBeforeCommandHooks,
   toNonEmptyStringOrUndefined
-} from "./chunks/chunk-WACRQ26A.js";
+} from "./chunks/chunk-WCBB6VI3.js";
 
 // dist/cli/main.js
 import { Command } from "commander";
@@ -2002,7 +2060,7 @@ function extractProvidedOptionFlags(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] = "41381b79-a859-5d27-84ba-6341f5d0b817");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "2c8d5d5f-89fe-586d-a7ae-8008988dd313");
   } catch (e2) {
   }
 })();
@@ -2349,12 +2407,30 @@ function buildTrackerNotInitializedGuidance(rawMessage, message, context) {
   if (!trackerNotInitialized) {
     return null;
   }
+  const attemptedRoot = trackerNotInitialized[1];
+  const nearbyRoot = discoverNearbyPmRoot(process.cwd(), attemptedRoot);
+  if (nearbyRoot) {
+    return applyPmCliErrorContext(makeGuidanceMessage({
+      code: "tracker_not_initialized",
+      title: "Tracker exists at a custom path",
+      happened: `pm did not find initialized metadata at ${attemptedRoot}, but found a tracker at ${nearbyRoot}.`,
+      required: "Select the existing tracker root explicitly.",
+      why: "Implicit discovery checks the default .agents/pm layout and ancestor root-layout trackers, while custom nested roots require an explicit path.",
+      examples: [
+        `pm --pm-path ${nearbyRoot} <command>`,
+        `PM_PATH=${nearbyRoot} pm <command>`
+      ],
+      nextSteps: [
+        `Re-run with "--pm-path ${nearbyRoot}" or export PM_PATH=${nearbyRoot}.`
+      ]
+    }), rawMessage, context);
+  }
   return applyPmCliErrorContext(makeGuidanceMessage({
     code: "tracker_not_initialized",
     title: "Tracker is not initialized",
     happened: `pm data path does not contain initialized tracker metadata (${trackerNotInitialized[1]}).`,
-    required: "Initialize tracker storage before running this command.",
-    why: "Most commands require settings and tracker directories created by pm init.",
+    required: "Select an existing tracker with --pm-path/PM_PATH, or initialize the default .agents/pm storage.",
+    why: "Most commands require settings in an explicitly selected root, an ancestor root-layout tracker, or the default .agents/pm directory.",
     examples: ["pm init", "pm init acme"],
     nextSteps: ['Run "pm init", then rerun your original command.']
   }), rawMessage, context);
@@ -2952,7 +3028,7 @@ import { Option } from "commander";
 !(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] = "ea4608a9-3e2f-55a8-a01b-a3c53ade6c3c");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "3fdce775-7d04-5a37-adf6-95d8be636097");
   } catch (e2) {
   }
 })();
@@ -3413,6 +3489,7 @@ function findCommandByPath2(root, pathParts) {
   }
   return current;
 }
+var extensionCreatedCommands = /* @__PURE__ */ new WeakSet();
 function ensureCommandPath(root, pathParts) {
   if (pathParts.length === 0) {
     return null;
@@ -3426,6 +3503,7 @@ function ensureCommandPath(root, pathParts) {
       continue;
     }
     const created = current.command(part);
+    extensionCreatedCommands.add(created);
     if (index < pathParts.length - 1) {
       created.description("Extension-provided command group.");
       created.action(() => {
@@ -3438,6 +3516,49 @@ function ensureCommandPath(root, pathParts) {
   }
   return current;
 }
+function findExtensionCommandPathCollision(root, pathParts) {
+  let current = root;
+  const traversed = [];
+  for (const part of pathParts) {
+    const existing = findDirectChildCommand2(current, part);
+    if (!existing) {
+      return null;
+    }
+    traversed.push(part);
+    if (!extensionCreatedCommands.has(existing)) {
+      return {
+        core_path: traversed.join(" "),
+        extension_path: pathParts.join(" ")
+      };
+    }
+    current = existing;
+  }
+  return null;
+}
+function buildExtensionCommandCollisionWarning(root, commandPath, aliases, descriptor) {
+  const pathParts = commandPath.split(" ").filter((part) => part.length > 0);
+  const collision = findExtensionCommandPathCollision(root, pathParts);
+  if (!collision || collision.core_path === commandPath && !aliases.has(commandPath)) {
+    return null;
+  }
+  const extensionOwner = descriptor?.source?.package ?? descriptor?.source?.name ?? "unknown-extension";
+  return `extension_command_collision:${collision.extension_path}:core_owner=pm-cli:${collision.core_path}:extension_owner=${extensionOwner}`;
+}
+function collectSafeExtensionCommandPaths(root, commandHandlers, descriptors, aliases, onCollision) {
+  return [
+    .../* @__PURE__ */ new Set([...commandHandlers, ...descriptors.keys()])
+  ].filter((commandPath) => commandPath.trim().length > 0).sort((left, right) => left.localeCompare(right)).filter((commandPath) => {
+    const warning = buildExtensionCommandCollisionWarning(root, commandPath, aliases, descriptors.get(commandPath));
+    if (!warning)
+      return true;
+    onCollision(warning);
+    return false;
+  });
+}
+function reportExtensionCommandCollision(activationWarnings, report, warning) {
+  activationWarnings.push(warning);
+  report(`[pm] warning: ${warning}; core command preserved. Rename or namespace the extension command alias.`);
+}
 
 // dist/cli/bootstrap-args.js
 !(function() {
@@ -4408,7 +4529,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] = "4a6c48de-9a99-5689-b263-cda3926a10af");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "611be227-4ef4-520e-994c-08e6eefb0f34");
   } catch (e2) {
   }
 })();
@@ -4464,10 +4585,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-PGDNOXDQ.js"));
-var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-UKMF55FT.js"));
-var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-T6RVNJC4.js"));
-var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-WPQ2LWZJ.js"));
+var loadSetupRegistrationModule = createLazyModule(() => import("./chunks/register-setup-N2FOSWAG.js"));
+var loadListQueryRegistrationModule = createLazyModule(() => import("./chunks/register-list-query-HTDQE6VI.js"));
+var loadMutationRegistrationModule = createLazyModule(() => import("./chunks/register-mutation-BLEWM5I6.js"));
+var loadOperationRegistrationModule = createLazyModule(() => import("./chunks/register-operations-MRLHOZYR.js"));
 function describeUnknownError(error) {
   if (error instanceof PmCliError) {
     return error.message;
@@ -5429,6 +5550,7 @@ async function loadRuntimeExtensionSnapshot(pmRoot, probe) {
       commandHandlers,
       commandFlagHelp,
       commandDescriptors,
+      commandAliases: canonicalAliases,
       loadWarnings: [...loadResult.warnings],
       activationWarnings: [...activationResult.warnings],
       loadedCount: loadResult.loaded.length,
@@ -5526,6 +5648,10 @@ async function executeRegisteredRuntimeMigrations(migrations, pmRoot) {
   }
   return warnings;
 }
+function buildExtensionCommandSdk(pmRoot, global2) {
+  const author = typeof global2.author === "string" && global2.author.trim() ? global2.author.trim() : "pm-extension";
+  return createExtensionCommandSdk(pmRoot, PmClient.forActiveExtensionHost({ pmRoot, author }));
+}
 async function runRequiredExtensionCommand(command, options, globalOptions, extensionFlagDefinitions = []) {
   const commandPath = getCommandPath(command);
   let commandArgs = stripLooseCommandOptionTokens(command.args.map(String), extensionFlagDefinitions);
@@ -5559,7 +5685,8 @@ async function runRequiredExtensionCommand(command, options, globalOptions, exte
     args: commandArgs,
     options: commandOptions,
     global: resolvedGlobalOptions,
-    pm_root: pmRoot
+    pm_root: pmRoot,
+    sdk: buildExtensionCommandSdk(pmRoot, resolvedGlobalOptions)
   });
   if (resolvedGlobalOptions.profile && extensionCommandResult.warnings.length > 0) {
     printError(`profile:extensions command_handler_warnings=${formatHookWarnings(extensionCommandResult.warnings)}`);
@@ -5654,7 +5781,8 @@ function wrapProgramActionsForExtensionHandlers(rootProgram) {
           args: commandArgs,
           options: commandOptions,
           global: globalOptions,
-          pm_root: pmRoot
+          pm_root: pmRoot,
+          sdk: buildExtensionCommandSdk(pmRoot, globalOptions)
         });
         maybePrintExtensionProfileWarnings(globalOptions.profile, "command_handler_warnings", extensionCommandResult.warnings);
         if (extensionCommandResult.handled) {
@@ -5742,12 +5870,7 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
   setActiveExtensionServices(snapshot.services);
   activeRuntimeExtensionCommandDescriptors = new Map(snapshot.commandDescriptors);
   await maybeAttachCreateUpdatePolicyHelpText(rootProgram, pmRoot, invocationArgv, snapshot.registrations, snapshot.settings);
-  const commandPaths = [
-    .../* @__PURE__ */ new Set([
-      ...snapshot.commandHandlers,
-      ...snapshot.commandDescriptors.keys()
-    ])
-  ].filter((commandPath) => commandPath.trim().length > 0).sort((left, right) => left.localeCompare(right));
+  const commandPaths = collectSafeExtensionCommandPaths(rootProgram, snapshot.commandHandlers, snapshot.commandDescriptors, snapshot.commandAliases, (warning) => reportExtensionCommandCollision(snapshot.activationWarnings, printError, warning));
   const registerCommandPath = (commandPath) => {
     const pathParts = commandPath.split(" ").filter((part) => part.length > 0);
     const descriptor = snapshot.commandDescriptors.get(commandPath);