@unbrained/pm-cli 2026.7.6 → 2026.7.7

package/dist/cli-bundle/chunks/{chunk-NC33K5ZS.js → chunk-YPD7SQ5P.js}

@@ -1,23 +1,23 @@
 import {
   parseAnnotationTextInput,
   runAnnotationCommand
-} from "./chunk-CL36D4PC.js";
+} from "./chunk-43SIHQND.js";
 import {
   createStdinTokenResolver
-} from "./chunk-AZYGZGGI.js";
+} from "./chunk-2TILG6F2.js";
 import {
   PmCliError
-} from "./chunk-SHQY2IDC.js";
+} from "./chunk-YNCFP5AR.js";
 import {
   EXIT_CODE
-} from "./chunk-LK6XLOGP.js";
+} from "./chunk-LCFJ7XAM.js";
 
 // dist/cli/commands/comments.js
 import { readFile } from "node:fs/promises";
 !(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] = "6a6f6522-973f-5abd-a34d-7770ef5a367b");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "76f33725-4d43-5197-98c4-d7c8431df92b");
   } catch (e2) {
   }
 })();
@@ -98,6 +98,7 @@ async function runComments(id, options, global2) {
   return runAnnotationCommand(id, options, global2, {
     input: {
       ...commentInput,
+      rawValue: options.add ?? rawValue,
       value: shouldParseText ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true }) : rawValue
     },
     collectionKey: "comments",
@@ -120,4 +121,4 @@ async function runComments(id, options, global2) {
 export {
   runComments
 };
-//# sourceMappingURL=chunk-NC33K5ZS.js.map
+//# sourceMappingURL=chunk-YPD7SQ5P.js.map

package/dist/cli-bundle/chunks/{chunk-NC33K5ZS.js.map → chunk-YPD7SQ5P.js.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/comments.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/comments\n *\n * Implements the pm comments command surface and its agent-facing runtime behavior.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { Comment } from \"../../types/index.js\";\nimport { parseAnnotationTextInput, runAnnotationCommand } from \"./annotation-command.js\";\n\n/**\n * Documents the comments command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsCommandOptions {\n  add?: string;\n  stdin?: boolean;\n  file?: string;\n  edit?: number;\n  delete?: number;\n  limit?: string;\n  includeMeta?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  allowAuditComment?: boolean;\n}\n\n/**\n * Documents the comments result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsResult {\n  id: string;\n  comments: Comment[];\n  count: number;\n  total_count?: number;\n  returned_count?: number;\n  has_more?: boolean;\n  limit?: number;\n}\n\ninterface ResolvedCommentInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\nfunction isErrnoError(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveCommentTextSource(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<{ value: string; emptyFlag: string } | undefined> {\n  const hasAdd = options.add !== undefined;\n  const hasStdin = options.stdin === true;\n  const hasFile = typeof options.file === \"string\";\n  const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);\n  if (sourceCount === 0) {\n    return undefined;\n  }\n  if (sourceCount > 1) {\n    throw new PmCliError(\"Specify comment text using only one input source: --add, --stdin, or --file\", EXIT_CODE.USAGE);\n  }\n  if (hasAdd) {\n    const addInput = await stdinResolver.resolveValue(options.add, \"--add\");\n    return { value: addInput ?? \"\", emptyFlag: \"--add\" };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return { value: stdinInput ?? \"\", emptyFlag: \"--stdin\" };\n  }\n  const filePath = (options.file as string).trim();\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    const fileInput = await readFile(filePath, \"utf8\");\n    return { value: fileInput, emptyFlag: \"--file\" };\n  } catch (error: unknown) {\n    if (isErrnoError(error) && error.code === \"ENOENT\") {\n      throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);\n    }\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`Failed to read --file path \"${filePath}\": ${detail}`, EXIT_CODE.USAGE);\n  }\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\n  const hasEdit = options.edit !== undefined;\n  const hasDelete = options.delete !== undefined;\n  if (hasEdit && hasDelete) {\n    throw new PmCliError(\"Specify only one of --edit or --delete\", EXIT_CODE.USAGE);\n  }\n\n  if (hasDelete) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource !== undefined) {\n      throw new PmCliError(\"--delete does not take comment text\", EXIT_CODE.USAGE);\n    }\n    return { mode: \"delete\", index: options.delete };\n  }\n\n  if (hasEdit) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource === undefined) {\n      throw new PmCliError(\n        \"--edit requires replacement text via positional [text], --add, --stdin, or --file\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      mode: \"edit\",\n      index: options.edit,\n      value: textSource.value,\n      emptyFlag: textSource.emptyFlag,\n    };\n  }\n\n  const textSource = await resolveCommentTextSource(options, stdinResolver);\n  if (textSource === undefined) {\n    return { mode: \"list\" };\n  }\n  // Map the single resolved input source back to its add/stdin/file mode so the\n  // caller still knows whether to run plain-text markdown parsing (add-only).\n  const mode = textSource.emptyFlag === \"--add\" ? \"add\" : textSource.emptyFlag === \"--stdin\" ? \"stdin\" : \"file\";\n  return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };\n}\n\n/**\n * Implements run comments for the public runtime surface of this module.\n */\nexport async function runComments(id: string, options: CommentsCommandOptions, global: GlobalOptions): Promise<CommentsResult> {\n  const stdinResolver = createStdinTokenResolver();\n  const commentInput = await resolveCommentInput(options, stdinResolver);\n\n  const shouldParseText = commentInput.mode === \"add\" || commentInput.mode === \"edit\";\n  // list/delete carry no text (value undefined → \"\"); add/edit/stdin/file always\n  // resolve to a string. Normalize once so neither branch below is unreachable.\n  const rawValue = commentInput.value ?? \"\";\n  return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n    input: {\n      ...commentInput,\n      value: shouldParseText ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true }) : rawValue,\n    },\n    collectionKey: \"comments\",\n    op: \"comment_add\",\n    editOp: \"comment_edit\",\n    deleteOp: \"comment_delete\",\n    parseText: (raw) => raw,\n    allowAuditBypass: Boolean(options.allowAuditComment),\n    conflictGuidance: {\n      required:\n        \"For append-only comment audits on another owner's item, prefer --allow-audit-comment before considering --force.\",\n      examples: ['pm comments pm-a1b2 --add \"audit note\" --author \"reviewer\" --allow-audit-comment'],\n      nextSteps: [\n        \"Retry with --allow-audit-comment for append-only audits that do not mutate item metadata beyond comments.\",\n        \"Use --force only when an ownership override is explicitly approved.\",\n      ],\n    },\n  });\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @module cli/commands/comments\n *\n * Implements the pm comments command surface and its agent-facing runtime behavior.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { Comment } from \"../../types/index.js\";\nimport { parseAnnotationTextInput, runAnnotationCommand } from \"./annotation-command.js\";\n\n/**\n * Documents the comments command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsCommandOptions {\n  add?: string;\n  stdin?: boolean;\n  file?: string;\n  edit?: number;\n  delete?: number;\n  limit?: string;\n  includeMeta?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  allowAuditComment?: boolean;\n}\n\n/**\n * Documents the comments result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsResult {\n  id: string;\n  comments: Comment[];\n  count: number;\n  total_count?: number;\n  returned_count?: number;\n  has_more?: boolean;\n  limit?: number;\n}\n\ninterface ResolvedCommentInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\nfunction isErrnoError(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveCommentTextSource(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<{ value: string; emptyFlag: string } | undefined> {\n  const hasAdd = options.add !== undefined;\n  const hasStdin = options.stdin === true;\n  const hasFile = typeof options.file === \"string\";\n  const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);\n  if (sourceCount === 0) {\n    return undefined;\n  }\n  if (sourceCount > 1) {\n    throw new PmCliError(\"Specify comment text using only one input source: --add, --stdin, or --file\", EXIT_CODE.USAGE);\n  }\n  if (hasAdd) {\n    const addInput = await stdinResolver.resolveValue(options.add, \"--add\");\n    return { value: addInput ?? \"\", emptyFlag: \"--add\" };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return { value: stdinInput ?? \"\", emptyFlag: \"--stdin\" };\n  }\n  const filePath = (options.file as string).trim();\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    const fileInput = await readFile(filePath, \"utf8\");\n    return { value: fileInput, emptyFlag: \"--file\" };\n  } catch (error: unknown) {\n    if (isErrnoError(error) && error.code === \"ENOENT\") {\n      throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);\n    }\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`Failed to read --file path \"${filePath}\": ${detail}`, EXIT_CODE.USAGE);\n  }\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\n  const hasEdit = options.edit !== undefined;\n  const hasDelete = options.delete !== undefined;\n  if (hasEdit && hasDelete) {\n    throw new PmCliError(\"Specify only one of --edit or --delete\", EXIT_CODE.USAGE);\n  }\n\n  if (hasDelete) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource !== undefined) {\n      throw new PmCliError(\"--delete does not take comment text\", EXIT_CODE.USAGE);\n    }\n    return { mode: \"delete\", index: options.delete };\n  }\n\n  if (hasEdit) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource === undefined) {\n      throw new PmCliError(\n        \"--edit requires replacement text via positional [text], --add, --stdin, or --file\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      mode: \"edit\",\n      index: options.edit,\n      value: textSource.value,\n      emptyFlag: textSource.emptyFlag,\n    };\n  }\n\n  const textSource = await resolveCommentTextSource(options, stdinResolver);\n  if (textSource === undefined) {\n    return { mode: \"list\" };\n  }\n  // Map the single resolved input source back to its add/stdin/file mode so the\n  // caller still knows whether to run plain-text markdown parsing (add-only).\n  const mode = textSource.emptyFlag === \"--add\" ? \"add\" : textSource.emptyFlag === \"--stdin\" ? \"stdin\" : \"file\";\n  return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };\n}\n\n/**\n * Implements run comments for the public runtime surface of this module.\n */\nexport async function runComments(id: string, options: CommentsCommandOptions, global: GlobalOptions): Promise<CommentsResult> {\n  const stdinResolver = createStdinTokenResolver();\n  const commentInput = await resolveCommentInput(options, stdinResolver);\n\n  const shouldParseText = commentInput.mode === \"add\" || commentInput.mode === \"edit\";\n  const rawValue = commentInput.value ?? \"\";\n  return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n    input: {\n      ...commentInput,\n      rawValue: options.add ?? rawValue,\n      value: shouldParseText ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true }) : rawValue,\n    },\n    collectionKey: \"comments\",\n    op: \"comment_add\",\n    editOp: \"comment_edit\",\n    deleteOp: \"comment_delete\",\n    parseText: (raw) => raw,\n    allowAuditBypass: Boolean(options.allowAuditComment),\n    conflictGuidance: {\n      required:\n        \"For append-only comment audits on another owner's item, prefer --allow-audit-comment before considering --force.\",\n      examples: ['pm comments pm-a1b2 --add \"audit note\" --author \"reviewer\" --allow-audit-comment'],\n      nextSteps: [\n        \"Retry with --allow-audit-comment for append-only audits that do not mutate item metadata beyond comments.\",\n        \"Use --force only when an ownership override is explicitly approved.\",\n      ],\n    },\n  });\n}\n"],
+  "mappings": "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",
   "names": ["textSource", "global"]
 }

package/dist/cli-bundle/chunks/{chunk-NGXQ3PFT.js → chunk-YPMZMKN7.js}

@@ -1,7 +1,7 @@
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   toDefaultFolder
-} from "./chunk-LK6XLOGP.js";
+} from "./chunk-LCFJ7XAM.js";
 
 // dist/core/schema/item-types-file.js
 !(function() {
@@ -260,4 +260,4 @@ export {
   buildInvalidTypeHint,
   buildInvalidTypeError
 };
-//# sourceMappingURL=chunk-NGXQ3PFT.js.map
+//# sourceMappingURL=chunk-YPMZMKN7.js.map

package/dist/cli-bundle/chunks/{chunk-KGFUY7WN.js → chunk-YTD5GICJ.js}

@@ -1,9 +1,9 @@
 import {
   resolveSubcommandFlagContractsForCommand
-} from "./chunk-VIIUS6N6.js";
+} from "./chunk-YCVWWIKY.js";
 import {
   PmCliError
-} from "./chunk-SHQY2IDC.js";
+} from "./chunk-YNCFP5AR.js";
 import {
   DEFAULT_EXTENSION_PRIORITY,
   EXIT_CODE,
@@ -11,7 +11,7 @@ import {
   isPathWithinDirectory,
   levenshteinDistanceWithinLimit,
   pathExists
-} from "./chunk-LK6XLOGP.js";
+} from "./chunk-LCFJ7XAM.js";
 
 // dist/cli/bootstrap-args.js
 !(function() {
@@ -811,4 +811,4 @@ export {
   parseExtensionManifest,
   validateExtensionDirectory
 };
-//# sourceMappingURL=chunk-KGFUY7WN.js.map
+//# sourceMappingURL=chunk-YTD5GICJ.js.map

package/dist/cli-bundle/chunks/{chunk-W6DYWXPQ.js → chunk-ZNEG2UDO.js}

@@ -1,10 +1,10 @@
 import {
-  normalizeParentReferencePolicy,
-  normalizeSprintReleaseFormatPolicy
-} from "./chunk-ALFPSEWO.js";
+  readManagedExtensionState,
+  runExtension
+} from "./chunk-X47MKQXU.js";
 import {
   migrateItemFilesToFormat
-} from "./chunk-O6AWCQRQ.js";
+} from "./chunk-MRFWUSVA.js";
 import {
   NESTED_SETTING_DESCRIPTORS,
   parseNestedSettingValue,
@@ -12,26 +12,32 @@ import {
   resolveNestedSettingDescriptor,
   writeNestedSettingValue
 } from "./chunk-VUHVWI4C.js";
+import {
+  normalizeParentReferencePolicy,
+  normalizeSprintReleaseFormatPolicy
+} from "./chunk-43YSKY75.js";
+import {
+  buildInvalidTypeError
+} from "./chunk-YPMZMKN7.js";
 import {
   PmCliError,
   getActiveExtensionRegistrations,
   readSettingsWithMetadata,
   writeSettings
-} from "./chunk-SHQY2IDC.js";
-import {
-  buildInvalidTypeError
-} from "./chunk-NGXQ3PFT.js";
+} from "./chunk-YNCFP5AR.js";
 import {
   CONTEXT_DEPTH_VALUES,
   EXIT_CODE,
   getSettingsPath,
   pathExists,
+  resolveExtensionRoots,
   resolveGlobalPmRoot,
   resolveItemTypeRegistry,
   resolveItemTypesFilePath,
+  resolvePmCliVersion,
   resolvePmRoot,
   resolveTypeName
-} from "./chunk-LK6XLOGP.js";
+} from "./chunk-LCFJ7XAM.js";
 
 // dist/core/config/positional-value.js
 !(function() {
@@ -1042,32 +1048,253 @@ async function runConfig(scopeValue, actionValue, keyValue, options, global2, va
   assertConfigKeyDefined(key);
   return action === "get" ? buildConfigGetResult(context, key) : setConfigValue(context, key, routedOptions);
 }
-var _testOnlyConfigCommand = {
-  hasGovernanceValidationMirrorChange,
-  applyPositionalValue,
-  normalizeAction,
-  normalizeCriteria,
-  normalizeGovernanceCloseValidationDefault,
-  normalizeGovernanceCreateModeDefault,
-  normalizeGovernanceForceRequiredForStaleLockPolicy,
-  normalizeGovernanceOwnershipEnforcement,
-  normalizeGovernancePreset,
-  normalizeGovernanceRequireCloseReasonPolicy,
-  normalizeGovernanceWorkflowEnforcement,
-  normalizeHistoryMissingStreamPolicy,
-  normalizeItemFormat,
-  normalizeKey,
-  normalizeMetadataRequiredFields,
-  normalizePolicyForConflict,
-  normalizeScope,
-  normalizeTelemetryTrackingPolicy,
-  normalizeTestResultTrackingPolicy,
-  normalizeValidateMetadataProfile,
-  normalizeWarnings
-};
+
+// dist/cli/commands/upgrade.js
+import { execFile } from "node:child_process";
+import path from "node:path";
+import { promisify } from "node:util";
+!(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] = "23e180a8-5d22-5a29-9970-219fbdc3d967");
+  } catch (e2) {
+  }
+})();
+var execFileAsync = promisify(execFile);
+var DEFAULT_CLI_PACKAGE = "@unbrained/pm-cli";
+var DEFAULT_TAG = "latest";
+function resolveScope(options) {
+  const projectLike = options.project === true || options.local === true;
+  const global2 = options.global === true;
+  if (projectLike && global2) {
+    throw new PmCliError('Options "--project/--local" and "--global" are mutually exclusive.', EXIT_CODE.USAGE);
+  }
+  return global2 ? "global" : "project";
+}
+function normalizeTarget(value) {
+  return value.trim().toLowerCase();
+}
+function packageRecordMatchesTarget(record, target) {
+  const normalizedTarget = normalizeTarget(target);
+  const values = [
+    record.name,
+    record.directory,
+    record.source.input,
+    record.source.location,
+    record.source.package,
+    record.source.repository,
+    record.source.owner && record.source.repo ? `${record.source.owner}/${record.source.repo}` : void 0
+  ];
+  return values.some((value) => typeof value === "string" && normalizeTarget(value) === normalizedTarget);
+}
+function resolveRoots(scope, global2) {
+  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
+  const roots = resolveExtensionRoots(pmRoot, process.cwd());
+  return {
+    selected_root: scope === "global" ? roots.global : roots.project
+  };
+}
+async function defaultCommandRunner(command, args, options) {
+  try {
+    const result = await execFileAsync(command, args, {
+      cwd: options?.cwd,
+      encoding: "utf8"
+    });
+    return {
+      stdout: result.stdout,
+      stderr: result.stderr
+    };
+  } catch (error) {
+    const stderr = typeof error === "object" && error !== null && "stderr" in error ? String(error.stderr ?? "") : "";
+    const message = stderr.trim().length > 0 ? stderr.trim() : error instanceof Error ? error.message : String(error);
+    throw new PmCliError(`Command failed: ${command} ${args.join(" ")}
+${message}`, EXIT_CODE.GENERIC_FAILURE);
+  }
+}
+async function readCurrentVersion() {
+  return resolvePmCliVersion(import.meta.url, ["../../.."]);
+}
+function resolveTag(options) {
+  return typeof options.tag === "string" && options.tag.trim().length > 0 ? options.tag.trim() : DEFAULT_TAG;
+}
+function resolveCliPackage(options) {
+  return typeof options.packageName === "string" && options.packageName.trim().length > 0 ? options.packageName.trim() : DEFAULT_CLI_PACKAGE;
+}
+async function upgradeCli(options, dryRun) {
+  const runner = options.commandRunner ?? defaultCommandRunner;
+  const packageName = resolveCliPackage(options);
+  const tag = resolveTag(options);
+  const target = `${packageName}@${tag}`;
+  const command = ["npm", "install", "-g", target];
+  if (options.repair === true) {
+    command.push("--force");
+  }
+  const beforeVersion = await readCurrentVersion();
+  const planned = {
+    requested: true,
+    status: "planned",
+    package: packageName,
+    target,
+    command,
+    before_version: beforeVersion,
+    repair: options.repair === true
+  };
+  if (dryRun) {
+    return planned;
+  }
+  try {
+    await runner(command[0], command.slice(1));
+    const verified = await runner("pm", ["--version"]);
+    return {
+      ...planned,
+      status: "updated",
+      after_version: verified.stdout.trim() || void 0
+    };
+  } catch (error) {
+    return {
+      ...planned,
+      status: "failed",
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+function isLocalNpmSpec(spec) {
+  return path.isAbsolute(spec) || spec.startsWith(".") || spec.startsWith("..") || spec.startsWith("file:");
+}
+function resolvePackageInstallSource(source, tag) {
+  if (source.kind === "npm") {
+    const rawSpec = source.input.startsWith("npm:") ? source.input.slice("npm:".length).trim() : source.input.trim();
+    if (!isLocalNpmSpec(rawSpec) && source.package && source.package.trim().length > 0) {
+      return `npm:${source.package.trim()}@${tag}`;
+    }
+    return source.input.startsWith("npm:") ? source.input : `npm:${source.input}`;
+  }
+  return source.input;
+}
+async function resolveRunnablePackageSource(source, tag) {
+  const installSource = resolvePackageInstallSource(source, tag);
+  if (source.kind !== "local") {
+    return installSource;
+  }
+  if (await pathExists(installSource)) {
+    return installSource;
+  }
+  if (await pathExists(source.location)) {
+    return source.location;
+  }
+  return installSource;
+}
+function packageCommandFor(source, installSource, scope, ref) {
+  const command = ["pm", "install", installSource, scope === "global" ? "--global" : "--project"];
+  if (source.kind === "github" && ref && ref.trim().length > 0) {
+    command.push("--ref", ref.trim());
+  }
+  return command;
+}
+async function readManagedRecords(scope, global2) {
+  const roots = resolveRoots(scope, global2);
+  const managedState = await readManagedExtensionState(roots.selected_root);
+  return managedState.state.entries.filter((entry) => entry.scope === scope);
+}
+async function refreshManagedRecord(scope, global2, record) {
+  const records = await readManagedRecords(scope, global2);
+  return records.find((candidate) => packageRecordMatchesTarget(candidate, record.name)) ?? records.find((candidate) => normalizeTarget(candidate.directory) === normalizeTarget(record.directory));
+}
+async function upgradePackageRecord(record, options, global2, scope, dryRun) {
+  const tag = resolveTag(options);
+  const installSource = await resolveRunnablePackageSource(record.source, tag);
+  const command = packageCommandFor(record.source, installSource, scope, record.source.ref);
+  const planned = {
+    name: record.name,
+    directory: record.directory,
+    scope,
+    source: record.source,
+    status: "planned",
+    command,
+    previous_version: record.manifest_version
+  };
+  if (dryRun) {
+    return planned;
+  }
+  try {
+    await runExtension(installSource, {
+      install: true,
+      project: scope === "project",
+      global: scope === "global",
+      ref: record.source.kind === "github" ? record.source.ref : void 0
+    }, global2);
+    const refreshed = await refreshManagedRecord(scope, global2, record);
+    return {
+      ...planned,
+      status: "updated",
+      installed_version: refreshed?.manifest_version
+    };
+  } catch (error) {
+    return {
+      ...planned,
+      status: "failed",
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+function summarize(cli, packages, includeCli, includePackages) {
+  const statuses = [includeCli ? cli.status : void 0, ...packages.map((entry) => entry.status)].filter((value) => typeof value === "string");
+  return {
+    requested_cli: includeCli,
+    requested_packages: includePackages,
+    planned: statuses.filter((status) => status === "planned").length,
+    updated: statuses.filter((status) => status === "updated").length,
+    skipped: statuses.filter((status) => status === "skipped").length,
+    failed: statuses.filter((status) => status === "failed").length
+  };
+}
+async function runUpgrade(target, options, global2) {
+  if (options.cliOnly === true && options.packagesOnly === true) {
+    throw new PmCliError('Options "--cli-only" and "--packages-only" are mutually exclusive.', EXIT_CODE.USAGE);
+  }
+  const scope = resolveScope(options);
+  const dryRun = options.dryRun === true;
+  const normalizedTarget = typeof target === "string" && target.trim().length > 0 ? target.trim() : void 0;
+  if (options.cliOnly === true && normalizedTarget) {
+    throw new PmCliError('A package target cannot be used with "--cli-only".', EXIT_CODE.USAGE);
+  }
+  const includeCli = options.packagesOnly === true || normalizedTarget ? false : true;
+  const includePackages = options.cliOnly === true ? false : true;
+  const cli = includeCli ? await upgradeCli(options, dryRun) : {
+    requested: false,
+    status: "skipped",
+    package: resolveCliPackage(options),
+    target: `${resolveCliPackage(options)}@${resolveTag(options)}`,
+    command: ["npm", "install", "-g", `${resolveCliPackage(options)}@${resolveTag(options)}`],
+    repair: options.repair === true,
+    reason: "not_requested"
+  };
+  let packageRecords = includePackages ? await readManagedRecords(scope, global2) : [];
+  if (normalizedTarget) {
+    packageRecords = packageRecords.filter((entry) => packageRecordMatchesTarget(entry, normalizedTarget));
+    if (packageRecords.length === 0) {
+      throw new PmCliError(`Managed package "${normalizedTarget}" was not found in ${scope} scope.`, EXIT_CODE.NOT_FOUND);
+    }
+  }
+  const packages = [];
+  for (const record of packageRecords) {
+    packages.push(await upgradePackageRecord(record, options, global2, scope, dryRun));
+  }
+  const summary = summarize(cli, packages, includeCli, includePackages);
+  return {
+    ok: summary.failed === 0,
+    action: "upgrade",
+    dry_run: dryRun,
+    scope,
+    target: normalizedTarget,
+    cli,
+    packages,
+    summary
+  };
+}
 
 export {
   runConfig,
-  _testOnlyConfigCommand
+  runUpgrade
 };
-//# sourceMappingURL=chunk-W6DYWXPQ.js.map
+//# sourceMappingURL=chunk-ZNEG2UDO.js.map