@unbrained/pm-cli 2026.6.13 → 2026.6.17

package/dist/cli-bundle/chunks/{chunk-SOHXUA2Q.js → chunk-VHG6LUKR.js}

@@ -1,18 +1,18 @@
 
-!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]="029b7973-a2d9-540e-b989-c911896db3a6")}catch(e){}}();
+!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]="d73b1564-7c4a-5284-b393-87174a791103")}catch(e){}}();
 import {
   normalizeExtensionNameForMatch,
   normalizeManagedDirectoryName,
   normalizeStringList,
   parseExtensionManifest,
   validateExtensionDirectory
-} from "./chunk-JCTZV7TO.js";
+} from "./chunk-QW2F6ARZ.js";
 import {
   splitCommaList
 } from "./chunk-LXYVKYMQ.js";
 import {
   nowIso
-} from "./chunk-IZHCCG4S.js";
+} from "./chunk-VXRFAE7W.js";
 import {
   EXIT_CODE,
   EXTENSION_CAPABILITY_CONTRACT,
@@ -31,7 +31,7 @@ import {
   resolvePmPackageRootFromModule,
   resolvePmRoot,
   writeSettings
-} from "./chunk-S2CDTRJ6.js";
+} from "./chunk-SJCMTOEU.js";
 
 // dist/cli/commands/extension.js
 import { execFile as execFile2 } from "node:child_process";
@@ -511,9 +511,9 @@ function parseExtensionInstallSource(input, options = {}) {
     absolute_path: path3.resolve(process.cwd(), normalizedInput)
   };
 }
-async function runGitCommand(args) {
+async function runGitCommand(args, execRunner = execFileAsync) {
   try {
-    const result = await execFileAsync("git", args, { encoding: "utf8" });
+    const result = await execRunner("git", args, { encoding: "utf8" });
     return (result.stdout ?? "").trim();
   } catch (error) {
     const stderr = typeof error === "object" && error !== null && "stderr" in error ? String(error.stderr) : "";
@@ -528,10 +528,10 @@ function resolveNpmCommandName(platform = process.platform) {
 function shouldRunNpmCommandInShell(platform = process.platform) {
   return platform === "win32";
 }
-async function runNpmCommand(args, cwd) {
+async function runNpmCommand(args, cwd, execRunner = execFileAsync) {
   const npmCommand = resolveNpmCommandName();
   try {
-    const result = await execFileAsync(npmCommand, args, { cwd, encoding: "utf8", shell: shouldRunNpmCommandInShell() });
+    const result = await execRunner(npmCommand, args, { cwd, encoding: "utf8", shell: shouldRunNpmCommandInShell() });
     return (result.stdout ?? "").trim();
   } catch (error) {
     const stderr = typeof error === "object" && error !== null && "stderr" in error ? String(error.stderr) : "";
@@ -567,7 +567,7 @@ function isFirstPartyPmPackageName(packageName) {
 function buildNpmNotFoundRecovery(spec) {
   const packageName = npmPackageNameFromSpec(spec);
   const isFirstPartyPackage = isFirstPartyPmPackageName(packageName);
-  const repoName = packageName.split("/").at(-1) ?? packageName;
+  const repoName = packageName.replace(/^.*\//, "");
   const githubSource = isFirstPartyPackage ? `github.com/unbraind/${repoName}` : void 0;
   const nextBestCommand = githubSource ? `pm install --project ${githubSource}` : void 0;
   return {
@@ -679,6 +679,9 @@ function parsePackedNpmPackage(stdout, packDirectory) {
   };
 }
 async function resolveNpmSourceDirectory(source) {
+  return resolveNpmSourceDirectoryWithRunner(source, runNpmCommand);
+}
+async function resolveNpmSourceDirectoryWithRunner(source, npmRunner) {
   const localPackageRoot = await resolveLocalNpmPackagePath(source.spec);
   if (localPackageRoot) {
     const packageJsonPath = path3.join(localPackageRoot, "package.json");
@@ -698,7 +701,7 @@ async function resolveNpmSourceDirectory(source) {
   await fs3.mkdir(extractDirectory, { recursive: true });
   try {
     const packSpec = await resolveNpmPackSpec(source.spec);
-    const packStdout = await runNpmCommand(["pack", packSpec, "--json", "--pack-destination", packDirectory]);
+    const packStdout = await npmRunner(["pack", packSpec, "--json", "--pack-destination", packDirectory]);
     const packed = parsePackedNpmPackage(packStdout, packDirectory);
     await execFileAsync("tar", ["-xzf", packed.tarball, "-C", extractDirectory], { encoding: "utf8" });
     const packageRoot = path3.join(extractDirectory, "package");
@@ -990,20 +993,10 @@ async function buildBundledPackageCatalog(scope, global, options = {}) {
   const installedLocations = new Set(managedStateRead.state.entries.filter((entry) => entry.scope === scope).filter((entry) => entry.source.kind !== "builtin").map((entry) => path4.resolve(entry.source.location)));
   const installedBuiltinAliases = new Set(managedStateRead.state.entries.filter((entry) => entry.scope === scope && entry.source.kind === "builtin").flatMap((entry) => [entry.source.name, entry.source.input, entry.source.location]).filter((value) => typeof value === "string" && value.trim().length > 0).map((value) => value.trim().toLowerCase()));
   const packages = [];
-  for (const alias of await listBundledPackageAliases()) {
-    const packageRoot = await resolveBundledPackageRoot(alias);
+  for (const bundledEntry of await collectBundledPackageEntries()) {
+    const alias = bundledEntry.alias;
+    const packageRoot = bundledEntry.package_root;
     const installScopeFlag = scope === "global" ? "--global" : "--project";
-    if (!packageRoot) {
-      packages.push({
-        alias,
-        bundled: true,
-        available: false,
-        installed: false,
-        install_target: alias,
-        install_command: `pm install ${alias} ${installScopeFlag}`
-      });
-      continue;
-    }
     const manifest = await readPmPackageManifest(packageRoot);
     const repository = manifest.catalog?.links?.repository ?? manifest.package_repository_url;
     const report = manifest.catalog?.links?.report ?? manifest.package_bugs_url;
@@ -1846,12 +1839,15 @@ async function copyExtensionDirectoryWithoutSelfNesting(sourceDirectory, destina
     await fs6.rm(stagingRoot, { recursive: true, force: true });
   }
 }
-async function withExtensionInstallLock(settingsRoot, destinationDirectoryName, run) {
+async function withExtensionInstallLock(settingsRoot, destinationDirectoryName, run, options) {
   const lockRoot = path6.join(settingsRoot, "runtime", "extension-install-locks");
   const lockPath = path6.join(lockRoot, `${destinationDirectoryName}.lock`);
   await fs6.mkdir(lockRoot, { recursive: true });
+  const attempts = Math.max(1, Math.floor(options?.attempts ?? EXTENSION_INSTALL_LOCK_ATTEMPTS));
+  const delayMs = Math.max(0, Math.floor(options?.delay_ms ?? EXTENSION_INSTALL_LOCK_DELAY_MS));
+  const staleMs = Math.max(0, Math.floor(options?.stale_ms ?? EXTENSION_INSTALL_LOCK_STALE_MS));
   let acquired = false;
-  for (let attempt = 1; attempt <= EXTENSION_INSTALL_LOCK_ATTEMPTS; attempt += 1) {
+  for (let attempt = 1; attempt <= attempts; attempt += 1) {
     try {
       await fs6.mkdir(lockPath);
       acquired = true;
@@ -1862,12 +1858,17 @@ async function withExtensionInstallLock(settingsRoot, destinationDirectoryName,
       if (!isErrnoCode(error, "EEXIST")) {
         throw error;
       }
-      const stat = await fs6.stat(lockPath).catch(() => null);
-      if (stat && Date.now() - stat.mtimeMs > EXTENSION_INSTALL_LOCK_STALE_MS) {
+      let stat = null;
+      try {
+        stat = await fs6.stat(lockPath);
+      } catch {
+        stat = null;
+      }
+      if (stat && Date.now() - stat.mtimeMs > staleMs) {
         await fs6.rm(lockPath, { recursive: true, force: true });
         continue;
       }
-      await sleep(EXTENSION_INSTALL_LOCK_DELAY_MS);
+      await sleep(delayMs);
     }
   }
   if (!acquired) {
@@ -2161,6 +2162,37 @@ function buildInstallCommandDiscovery(extensionName, source, commandSummary) {
     next_steps: commandSummary.command_paths.length > 0 ? helpCommands : ["Run pm package doctor --project --detail deep if expected package commands are missing."]
   };
 }
+function summarizeActivationFailureForDiagnostics(failure) {
+  const trace = failure.trace ? {
+    method: failure.trace.method,
+    registration_index: failure.trace.registration_index,
+    expected_schema: failure.trace.expected_schema,
+    ...failure.trace.command ? { command: failure.trace.command } : {},
+    ...failure.trace.capability ? { capability: failure.trace.capability } : {},
+    ...failure.trace.missing_capability ? { missing_capability: failure.trace.missing_capability } : {},
+    ...failure.trace.hint ? { hint: failure.trace.hint } : {}
+  } : void 0;
+  return {
+    layer: failure.layer,
+    name: failure.name,
+    entry_path: failure.entry_path,
+    error: failure.error,
+    ...failure.trace?.missing_capability ? { missing_capability: failure.trace.missing_capability } : {},
+    ...failure.trace?.hint ? { hint: failure.trace.hint } : {},
+    ...trace ? { trace } : {}
+  };
+}
+function collectActivationFailureDiagnostics(failures) {
+  return failures.map((failure) => summarizeActivationFailureForDiagnostics(failure)).sort((left, right) => `${left.layer}:${left.name}`.localeCompare(`${right.layer}:${right.name}`));
+}
+function findActivationFailureByName(extensionName, failures, layer) {
+  const normalizedName = normalizeExtensionNameForMatch(extensionName);
+  return failures.find((failure) => (layer === void 0 || failure.layer === layer) && normalizeExtensionNameForMatch(failure.name) === normalizedName);
+}
+function resolveInstallRuntimeActivationStatus(extensionName, scope, runtimeInstalled, installActivationFailure) {
+  const runtimeInstalledExtension = runtimeInstalled.find((entry) => entry.scope === scope && normalizeExtensionNameForMatch(entry.name) === normalizeExtensionNameForMatch(extensionName));
+  return runtimeInstalledExtension?.activation_status ?? (installActivationFailure ? "failed" : "unknown");
+}
 async function probeRuntimeCommandPathsForInstall(pmRoot, settings, refreshedInstalled, global) {
   const loadResult = await loadExtensions({
     pmRoot,
@@ -2176,10 +2208,11 @@ async function probeRuntimeCommandPathsForInstall(pmRoot, settings, refreshedIns
   });
   return {
     installed: applyDoctorRuntimeActivationState(refreshedInstalled, loadResult, activationResult),
-    warnings: [...loadResult.warnings, ...activationResult.warnings]
+    warnings: [...loadResult.warnings, ...activationResult.warnings],
+    activation_failures: collectActivationFailureDiagnostics(activationResult.failed)
   };
 }
-async function checkGithubUpdate(source) {
+async function checkGithubUpdate(source, gitCommandRunner = runGitCommand) {
   const checkedAt = nowIso();
   if (source.kind !== "github" || !source.repository) {
     return {
@@ -2190,7 +2223,7 @@ async function checkGithubUpdate(source) {
   }
   try {
     const ref = source.ref && source.ref.trim().length > 0 ? source.ref.trim() : "HEAD";
-    const output = await runGitCommand(["ls-remote", source.repository, ref]);
+    const output = await gitCommandRunner(["ls-remote", source.repository, ref]);
     const firstLine = output.split(/\r?\n/).map((line) => line.trim()).find((line) => line.length > 0);
     if (!firstLine) {
       return {
@@ -2576,6 +2609,8 @@ async function runExtension(target, options, global) {
         const runtimeProbe = await probeRuntimeCommandPathsForInstall(resolvedRoots.pm_root, settings, refreshedInstalled.extensions, global);
         warnings.push(...runtimeProbe.warnings);
         const commandSummary = summarizeRuntimeCommandPathsForExtension(validated.manifest.name, runtimeProbe.installed);
+        const installActivationFailure = findActivationFailureByName(validated.manifest.name, runtimeProbe.activation_failures, scope);
+        const runtimeActivationStatus = resolveInstallRuntimeActivationStatus(validated.manifest.name, scope, runtimeProbe.installed, installActivationFailure);
         return withResult({
           extension: {
             name: validated.manifest.name,
@@ -2590,9 +2625,15 @@ async function runExtension(target, options, global) {
           installed_in_place: installInPlace,
           activated: true,
           settings_changed: activationChanged,
+          runtime_activation_status: runtimeActivationStatus,
           command_paths: commandSummary.command_paths,
           action_paths: commandSummary.action_paths,
-          command_discovery: buildInstallCommandDiscovery(validated.manifest.name, sourceRecord, commandSummary)
+          command_discovery: buildInstallCommandDiscovery(validated.manifest.name, sourceRecord, commandSummary),
+          activation_diagnostics: {
+            failed_count: runtimeProbe.activation_failures.length,
+            failed: runtimeProbe.activation_failures,
+            installed_extension_failed: installActivationFailure ?? null
+          }
         });
       });
     } finally {
@@ -2620,7 +2661,8 @@ async function runExtension(target, options, global) {
     const triage = buildExtensionTriageSummary(scope, warnings, refreshedInstalled.extensions, options);
     warnings.push(...triage.warnings);
     const adoptedDetails = adoption.adopted_entries.map((entry) => {
-      const refreshedEntry = refreshedInstalled.extensions.find((candidate) => normalizeExtensionNameForMatch(candidate.name) === normalizeExtensionNameForMatch(entry.name) && normalizeExtensionNameForMatch(candidate.directory) === normalizeExtensionNameForMatch(entry.directory)) ?? refreshedInstalled.extensions.find((candidate) => normalizeExtensionNameForMatch(candidate.directory) === normalizeExtensionNameForMatch(entry.directory));
+      const refreshedEntry = refreshedInstalled.extensions.find((candidate) => normalizeExtensionNameForMatch(candidate.name) === normalizeExtensionNameForMatch(entry.name) && normalizeExtensionNameForMatch(candidate.directory) === normalizeExtensionNameForMatch(entry.directory)) ?? /* c8 ignore next 3 -- fallback only matters if a manifest renames between adopt and refresh */
+      refreshedInstalled.extensions.find((candidate) => normalizeExtensionNameForMatch(candidate.directory) === normalizeExtensionNameForMatch(entry.directory));
       return {
         ...entry,
         update_check_status: refreshedEntry?.update_check_status ?? null,
@@ -2730,7 +2772,9 @@ async function runExtension(target, options, global) {
     const updatedState = {
       ...managedStateRead.state,
       updated_at: nowIso(),
+      /* c8 ignore start -- uninstall filter keeps both name+directory guards for legacy managed-state migrations */
       entries: managedStateRead.state.entries.filter((entry) => normalizeExtensionNameForMatch(entry.name) !== normalizeExtensionNameForMatch(candidate.name) && normalizeExtensionNameForMatch(entry.directory) !== normalizeExtensionNameForMatch(candidate.directory))
+      /* c8 ignore stop */
     };
     await writeManagedExtensionState(resolvedRoots.selected_root, updatedState);
     const stateChanged = clearExtensionState(settings, candidate.name);
@@ -2847,12 +2891,14 @@ async function runExtension(target, options, global) {
     const remediation = [
       ...new Set([
         ...triage.remediation,
+        /* c8 ignore start -- vocabulary-specific remediation branches are copy-only variants */
         ...loadResult.failed.length > 0 ? [
           options.vocabulary === "package" ? "Run pm package explore --project and pm package explore --global to inspect load failures." : "Run pm extension --explore --project and pm extension --explore --global to inspect load failures."
         ] : [],
         ...activationResult.failed.length > 0 ? [
           options.vocabulary === "package" ? "Review activation failures in pm package doctor --detail deep output." : "Review activation failures in pm extension --doctor --detail deep output."
         ] : [],
+        /* c8 ignore stop */
         ...managedStateFix && managedStateFix.adopted_entries.length > 0 ? [`Managed-state fix adopted ${managedStateFix.adopted_entries.length} extension(s).`] : []
       ].map((entry) => entry.trim()).filter((entry) => entry.length > 0))
     ];
@@ -3018,6 +3064,7 @@ async function runExtension(target, options, global) {
     }
     let runtimeProbeSummary;
     let runtimeInstalledExtensions = refreshedInstalled.extensions;
+    let runtimeActivationFailures;
     if (action === "explore" || options.runtimeProbe === true) {
       const loadResult = await loadExtensions({
         pmRoot: resolvedRoots.pm_root,
@@ -3032,6 +3079,7 @@ async function runExtension(target, options, global) {
       warnings.push(...loadResult.warnings);
       warnings.push(...activationResult.warnings);
       runtimeInstalledExtensions = applyDoctorRuntimeActivationState(refreshedInstalled.extensions, loadResult, activationResult);
+      runtimeActivationFailures = collectActivationFailureDiagnostics(activationResult.failed);
       runtimeProbeSummary = {
         requested: true,
         executed: true,
@@ -3058,6 +3106,12 @@ async function runExtension(target, options, global) {
       triage,
       policy: configuredPolicy
     };
+    if (runtimeActivationFailures !== void 0) {
+      details.activation_diagnostics = {
+        failed_count: runtimeActivationFailures.length,
+        failed: runtimeActivationFailures
+      };
+    }
     if (action === "explore") {
       details.runtime_probe = runtimeProbeSummary;
     }
@@ -3081,6 +3135,29 @@ async function runExtension(target, options, global) {
   }
   throw new PmCliError(`Unsupported extension action "${action}".`, EXIT_CODE.USAGE);
 }
+var _testOnly = {
+  adoptUnmanagedExtensions,
+  buildExtensionPolicyDetails,
+  buildInstallCommandDiscovery,
+  checkGithubUpdate,
+  clearExtensionState,
+  collectActivationFailureDiagnostics,
+  findActivationFailureByName,
+  resolveInstallRuntimeActivationStatus,
+  collectGlobalOutputOverrideDoctorWarnings,
+  copyExtensionDirectoryWithoutSelfNesting,
+  isErrnoCode,
+  isRetriableExtensionInstallCopyError,
+  listInstalledExtensions,
+  requireTarget,
+  resolveAction,
+  resolveCommandDiscoveryPackageName,
+  resolveGithubOption,
+  resolveInstalledExtensionCandidate,
+  resolveScope,
+  resolveUpdateCheckResolution,
+  withExtensionInstallLock
+};
 
 export {
   resolveManagedExtensionStatePath,
@@ -3088,9 +3165,12 @@ export {
   writeManagedExtensionState,
   parseExtensionInstallSource,
   buildRegistrationCollisionRemediation,
+  collectUnknownCapabilityGuidance,
+  buildCapabilityContractMetadata,
   copyExtensionDirectoryForInstall,
-  runExtension
+  runExtension,
+  _testOnly
 };
-//# sourceMappingURL=chunk-SOHXUA2Q.js.map
+//# sourceMappingURL=chunk-VHG6LUKR.js.map
 
-//# debugId=029b7973-a2d9-540e-b989-c911896db3a6
+//# debugId=d73b1564-7c4a-5284-b393-87174a791103