@unbrained/pm-cli 2026.6.12 → 2026.6.16

package/dist/cli/commands/upgrade.d.ts

@@ -1,4 +1,4 @@
-import { type ExtensionScope, type ManagedExtensionSource } from "./extension.js";
+import { type ExtensionScope, type ManagedExtensionRecord, type ManagedExtensionSource } from "./extension.js";
 import type { GlobalOptions } from "../../core/shared/command-types.js";
 export interface UpgradeCommandOptions {
     dryRun?: boolean;
@@ -12,6 +12,19 @@ export interface UpgradeCommandOptions {
     packageName?: string;
     commandRunner?: UpgradeCommandRunner;
 }
+export declare const _testOnly: {
+    defaultCommandRunner: typeof defaultCommandRunner;
+    isLocalNpmSpec: typeof isLocalNpmSpec;
+    normalizeTarget: typeof normalizeTarget;
+    packageRecordMatchesTarget: typeof packageRecordMatchesTarget;
+    resolveCliPackage: typeof resolveCliPackage;
+    resolvePackageInstallSource: typeof resolvePackageInstallSource;
+    resolveRunnablePackageSource: typeof resolveRunnablePackageSource;
+    resolveScope: typeof resolveScope;
+    resolveTag: typeof resolveTag;
+    packageCommandFor: typeof packageCommandFor;
+    summarize: typeof summarize;
+};
 export interface UpgradeCommandRunnerResult {
     stdout: string;
     stderr: string;
@@ -60,4 +73,18 @@ export interface UpgradeResult {
         failed: number;
     };
 }
+declare function resolveScope(options: UpgradeCommandOptions): ExtensionScope;
+declare function normalizeTarget(value: string): string;
+declare function packageRecordMatchesTarget(record: ManagedExtensionRecord, target: string): boolean;
+declare function defaultCommandRunner(command: string, args: string[], options?: {
+    cwd?: string;
+}): Promise<UpgradeCommandRunnerResult>;
+declare function resolveTag(options: UpgradeCommandOptions): string;
+declare function resolveCliPackage(options: UpgradeCommandOptions): string;
+declare function isLocalNpmSpec(spec: string): boolean;
+declare function resolvePackageInstallSource(source: ManagedExtensionSource, tag: string): string;
+declare function resolveRunnablePackageSource(source: ManagedExtensionSource, tag: string): Promise<string>;
+declare function packageCommandFor(source: ManagedExtensionSource, installSource: string, scope: ExtensionScope, ref?: string): string[];
+declare function summarize(cli: UpgradeCliResult, packages: UpgradePackageResult[], includeCli: boolean, includePackages: boolean): UpgradeResult["summary"];
 export declare function runUpgrade(target: string | undefined, options: UpgradeCommandOptions, global: GlobalOptions): Promise<UpgradeResult>;
+export {};

package/dist/cli/commands/upgrade.js

@@ -1,5 +1,5 @@
 
-!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]="75ce1812-4133-528d-8ef4-42a7f5a81eb3")}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]="734ddb9b-8a2a-5510-9fe7-084f08b7f7a4")}catch(e){}}();
 import { execFile } from "node:child_process";
 import path from "node:path";
 import { promisify } from "node:util";
@@ -13,6 +13,19 @@ import { resolvePmCliVersion } from "../../core/packages/root.js";
 const execFileAsync = promisify(execFile);
 const DEFAULT_CLI_PACKAGE = "@unbrained/pm-cli";
 const DEFAULT_TAG = "latest";
+export const _testOnly = {
+    defaultCommandRunner,
+    isLocalNpmSpec,
+    normalizeTarget,
+    packageRecordMatchesTarget,
+    resolveCliPackage,
+    resolvePackageInstallSource,
+    resolveRunnablePackageSource,
+    resolveScope,
+    resolveTag,
+    packageCommandFor,
+    summarize,
+};
 function resolveScope(options) {
     const projectLike = options.project === true || options.local === true;
     const global = options.global === true;
@@ -51,8 +64,8 @@ async function defaultCommandRunner(command, args, options) {
             encoding: "utf8",
         });
         return {
-            stdout: result.stdout ?? "",
-            stderr: result.stderr ?? "",
+            stdout: result.stdout,
+            stderr: result.stderr,
         };
     }
     catch (error) {
@@ -252,4 +265,4 @@ export async function runUpgrade(target, options, global) {
     };
 }
 //# sourceMappingURL=upgrade.js.map
-//# debugId=75ce1812-4133-528d-8ef4-42a7f5a81eb3
+//# debugId=734ddb9b-8a2a-5510-9fe7-084f08b7f7a4

package/dist/cli/commands/upgrade.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.js","sources":["cli/commands/upgrade.ts"],"sourceRoot":"/","sourcesContent":["import { execFile } from \"node:child_process\";\nimport path from \"node:path\";\nimport { promisify } from \"node:util\";\nimport {\n  readManagedExtensionState,\n  runExtension,\n  type ExtensionScope,\n  type ManagedExtensionRecord,\n  type ManagedExtensionSource,\n} from \"./extension.js\";\nimport { resolveExtensionRoots } from \"../../core/extensions/loader.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolvePmRoot } from \"../../core/store/paths.js\";\nimport { resolvePmCliVersion } from \"../../core/packages/root.js\";\n\nconst execFileAsync = promisify(execFile);\nconst DEFAULT_CLI_PACKAGE = \"@unbrained/pm-cli\";\nconst DEFAULT_TAG = \"latest\";\n\nexport interface UpgradeCommandOptions {\n  dryRun?: boolean;\n  cliOnly?: boolean;\n  packagesOnly?: boolean;\n  project?: boolean;\n  local?: boolean;\n  global?: boolean;\n  repair?: boolean;\n  tag?: string;\n  packageName?: string;\n  commandRunner?: UpgradeCommandRunner;\n}\n\nexport interface UpgradeCommandRunnerResult {\n  stdout: string;\n  stderr: string;\n}\n\nexport type UpgradeCommandRunner = (\n  command: string,\n  args: string[],\n  options?: { cwd?: string },\n) => Promise<UpgradeCommandRunnerResult>;\n\nexport interface UpgradeCliResult {\n  requested: boolean;\n  status: \"planned\" | \"updated\" | \"failed\" | \"skipped\";\n  package: string;\n  target: string;\n  command: string[];\n  before_version?: string;\n  after_version?: string;\n  repair: boolean;\n  reason?: string;\n  error?: string;\n}\n\nexport interface UpgradePackageResult {\n  name: string;\n  directory: string;\n  scope: ExtensionScope;\n  source: ManagedExtensionSource;\n  status: \"planned\" | \"updated\" | \"failed\" | \"skipped\";\n  command: string[];\n  previous_version: string;\n  installed_version?: string;\n  reason?: string;\n  error?: string;\n}\n\nexport interface UpgradeResult {\n  ok: boolean;\n  action: \"upgrade\";\n  dry_run: boolean;\n  scope: ExtensionScope;\n  target?: string;\n  cli: UpgradeCliResult;\n  packages: UpgradePackageResult[];\n  summary: {\n    requested_cli: boolean;\n    requested_packages: boolean;\n    planned: number;\n    updated: number;\n    skipped: number;\n    failed: number;\n  };\n}\n\nfunction resolveScope(options: UpgradeCommandOptions): ExtensionScope {\n  const projectLike = options.project === true || options.local === true;\n  const global = options.global === true;\n  if (projectLike && global) {\n    throw new PmCliError('Options \"--project/--local\" and \"--global\" are mutually exclusive.', EXIT_CODE.USAGE);\n  }\n  return global ? \"global\" : \"project\";\n}\n\nfunction normalizeTarget(value: string): string {\n  return value.trim().toLowerCase();\n}\n\nfunction packageRecordMatchesTarget(record: ManagedExtensionRecord, target: string): boolean {\n  const normalizedTarget = normalizeTarget(target);\n  const values = [\n    record.name,\n    record.directory,\n    record.source.input,\n    record.source.location,\n    record.source.package,\n    record.source.repository,\n    record.source.owner && record.source.repo ? `${record.source.owner}/${record.source.repo}` : undefined,\n  ];\n  return values.some((value) => typeof value === \"string\" && normalizeTarget(value) === normalizedTarget);\n}\n\nfunction resolveRoots(scope: ExtensionScope, global: GlobalOptions): {\n  selected_root: string;\n} {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const roots = resolveExtensionRoots(pmRoot, process.cwd());\n  return {\n    selected_root: scope === \"global\" ? roots.global : roots.project,\n  };\n}\n\nasync function defaultCommandRunner(\n  command: string,\n  args: string[],\n  options?: { cwd?: string },\n): Promise<UpgradeCommandRunnerResult> {\n  try {\n    const result = await execFileAsync(command, args, {\n      cwd: options?.cwd,\n      encoding: \"utf8\",\n    });\n    return {\n      stdout: result.stdout ?? \"\",\n      stderr: result.stderr ?? \"\",\n    };\n  } catch (error: unknown) {\n    const stderr = typeof error === \"object\" && error !== null && \"stderr\" in error\n      ? String((error as { stderr?: unknown }).stderr ?? \"\")\n      : \"\";\n    const message = stderr.trim().length > 0 ? stderr.trim() : error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`Command failed: ${command} ${args.join(\" \")}\\n${message}`, EXIT_CODE.GENERIC_FAILURE);\n  }\n}\n\nasync function readCurrentVersion(): Promise<string | undefined> {\n  return resolvePmCliVersion(import.meta.url, [\"../../..\"]);\n}\n\nfunction resolveTag(options: UpgradeCommandOptions): string {\n  return typeof options.tag === \"string\" && options.tag.trim().length > 0 ? options.tag.trim() : DEFAULT_TAG;\n}\n\nfunction resolveCliPackage(options: UpgradeCommandOptions): string {\n  return typeof options.packageName === \"string\" && options.packageName.trim().length > 0\n    ? options.packageName.trim()\n    : DEFAULT_CLI_PACKAGE;\n}\n\nasync function upgradeCli(options: UpgradeCommandOptions, dryRun: boolean): Promise<UpgradeCliResult> {\n  const runner = options.commandRunner ?? defaultCommandRunner;\n  const packageName = resolveCliPackage(options);\n  const tag = resolveTag(options);\n  const target = `${packageName}@${tag}`;\n  const command = [\"npm\", \"install\", \"-g\", target];\n  if (options.repair === true) {\n    command.push(\"--force\");\n  }\n  const beforeVersion = await readCurrentVersion();\n  const planned: UpgradeCliResult = {\n    requested: true,\n    status: \"planned\",\n    package: packageName,\n    target,\n    command,\n    before_version: beforeVersion,\n    repair: options.repair === true,\n  };\n  if (dryRun) {\n    return planned;\n  }\n  try {\n    await runner(command[0]!, command.slice(1));\n    const verified = await runner(\"pm\", [\"--version\"]);\n    return {\n      ...planned,\n      status: \"updated\",\n      after_version: verified.stdout.trim() || undefined,\n    };\n  } catch (error: unknown) {\n    return {\n      ...planned,\n      status: \"failed\",\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\nfunction isLocalNpmSpec(spec: string): boolean {\n  return path.isAbsolute(spec) || spec.startsWith(\".\") || spec.startsWith(\"..\") || spec.startsWith(\"file:\");\n}\n\nfunction resolvePackageInstallSource(source: ManagedExtensionSource, tag: string): string {\n  if (source.kind === \"npm\") {\n    const rawSpec = source.input.startsWith(\"npm:\") ? source.input.slice(\"npm:\".length).trim() : source.input.trim();\n    if (!isLocalNpmSpec(rawSpec) && source.package && source.package.trim().length > 0) {\n      return `npm:${source.package.trim()}@${tag}`;\n    }\n    return source.input.startsWith(\"npm:\") ? source.input : `npm:${source.input}`;\n  }\n  return source.input;\n}\n\nasync function resolveRunnablePackageSource(source: ManagedExtensionSource, tag: string): Promise<string> {\n  const installSource = resolvePackageInstallSource(source, tag);\n  if (source.kind !== \"local\") {\n    return installSource;\n  }\n  if (await pathExists(installSource)) {\n    return installSource;\n  }\n  if (await pathExists(source.location)) {\n    return source.location;\n  }\n  return installSource;\n}\n\nfunction packageCommandFor(source: ManagedExtensionSource, installSource: string, scope: ExtensionScope, ref?: string): string[] {\n  const command = [\"pm\", \"install\", installSource, scope === \"global\" ? \"--global\" : \"--project\"];\n  if (source.kind === \"github\" && ref && ref.trim().length > 0) {\n    command.push(\"--ref\", ref.trim());\n  }\n  return command;\n}\n\nasync function readManagedRecords(scope: ExtensionScope, global: GlobalOptions): Promise<ManagedExtensionRecord[]> {\n  const roots = resolveRoots(scope, global);\n  const managedState = await readManagedExtensionState(roots.selected_root);\n  return managedState.state.entries.filter((entry) => entry.scope === scope);\n}\n\nasync function refreshManagedRecord(\n  scope: ExtensionScope,\n  global: GlobalOptions,\n  record: ManagedExtensionRecord,\n): Promise<ManagedExtensionRecord | undefined> {\n  const records = await readManagedRecords(scope, global);\n  return records.find((candidate) => packageRecordMatchesTarget(candidate, record.name)) ??\n    records.find((candidate) => normalizeTarget(candidate.directory) === normalizeTarget(record.directory));\n}\n\nasync function upgradePackageRecord(\n  record: ManagedExtensionRecord,\n  options: UpgradeCommandOptions,\n  global: GlobalOptions,\n  scope: ExtensionScope,\n  dryRun: boolean,\n): Promise<UpgradePackageResult> {\n  const tag = resolveTag(options);\n  const installSource = await resolveRunnablePackageSource(record.source, tag);\n  const command = packageCommandFor(record.source, installSource, scope, record.source.ref);\n  const planned: UpgradePackageResult = {\n    name: record.name,\n    directory: record.directory,\n    scope,\n    source: record.source,\n    status: \"planned\",\n    command,\n    previous_version: record.manifest_version,\n  };\n  if (dryRun) {\n    return planned;\n  }\n  try {\n    await runExtension(\n      installSource,\n      {\n        install: true,\n        project: scope === \"project\",\n        global: scope === \"global\",\n        ref: record.source.kind === \"github\" ? record.source.ref : undefined,\n      },\n      global,\n    );\n    const refreshed = await refreshManagedRecord(scope, global, record);\n    return {\n      ...planned,\n      status: \"updated\",\n      installed_version: refreshed?.manifest_version,\n    };\n  } catch (error: unknown) {\n    return {\n      ...planned,\n      status: \"failed\",\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\nfunction summarize(\n  cli: UpgradeCliResult,\n  packages: UpgradePackageResult[],\n  includeCli: boolean,\n  includePackages: boolean,\n): UpgradeResult[\"summary\"] {\n  const statuses = [includeCli ? cli.status : undefined, ...packages.map((entry) => entry.status)].filter(\n    (value): value is UpgradeCliResult[\"status\"] => typeof value === \"string\",\n  );\n  return {\n    requested_cli: includeCli,\n    requested_packages: includePackages,\n    planned: statuses.filter((status) => status === \"planned\").length,\n    updated: statuses.filter((status) => status === \"updated\").length,\n    skipped: statuses.filter((status) => status === \"skipped\").length,\n    failed: statuses.filter((status) => status === \"failed\").length,\n  };\n}\n\nexport async function runUpgrade(\n  target: string | undefined,\n  options: UpgradeCommandOptions,\n  global: GlobalOptions,\n): Promise<UpgradeResult> {\n  if (options.cliOnly === true && options.packagesOnly === true) {\n    throw new PmCliError('Options \"--cli-only\" and \"--packages-only\" are mutually exclusive.', EXIT_CODE.USAGE);\n  }\n\n  const scope = resolveScope(options);\n  const dryRun = options.dryRun === true;\n  const normalizedTarget = typeof target === \"string\" && target.trim().length > 0 ? target.trim() : undefined;\n  if (options.cliOnly === true && normalizedTarget) {\n    throw new PmCliError('A package target cannot be used with \"--cli-only\".', EXIT_CODE.USAGE);\n  }\n  const includeCli = options.packagesOnly === true || normalizedTarget ? false : true;\n  const includePackages = options.cliOnly === true ? false : true;\n  const cli = includeCli\n    ? await upgradeCli(options, dryRun)\n    : {\n        requested: false,\n        status: \"skipped\",\n        package: resolveCliPackage(options),\n        target: `${resolveCliPackage(options)}@${resolveTag(options)}`,\n        command: [\"npm\", \"install\", \"-g\", `${resolveCliPackage(options)}@${resolveTag(options)}`],\n        repair: options.repair === true,\n        reason: \"not_requested\",\n      } as UpgradeCliResult;\n\n  let packageRecords = includePackages ? await readManagedRecords(scope, global) : [];\n  if (normalizedTarget) {\n    packageRecords = packageRecords.filter((entry) => packageRecordMatchesTarget(entry, normalizedTarget));\n    if (packageRecords.length === 0) {\n      throw new PmCliError(`Managed package \"${normalizedTarget}\" was not found in ${scope} scope.`, EXIT_CODE.NOT_FOUND);\n    }\n  }\n\n  const packages: UpgradePackageResult[] = [];\n  for (const record of packageRecords) {\n    packages.push(await upgradePackageRecord(record, options, global, scope, dryRun));\n  }\n\n  const summary = summarize(cli, packages, includeCli, includePackages);\n  return {\n    ok: summary.failed === 0,\n    action: \"upgrade\",\n    dry_run: dryRun,\n    scope,\n    target: normalizedTarget,\n    cli,\n    packages,\n    summary,\n  };\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,yBAAyB,EACzB,YAAY,GAIb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAChD,MAAM,WAAW,GAAG,QAAQ,CAAC;AAsE7B,SAAS,YAAY,CAAC,OAA8B;IAClD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC;IACvC,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,UAAU,CAAC,oEAAoE,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACvC,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,0BAA0B,CAAC,MAA8B,EAAE,MAAc;IAChF,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG;QACb,MAAM,CAAC,IAAI;QACX,MAAM,CAAC,SAAS;QAChB,MAAM,CAAC,MAAM,CAAC,KAAK;QACnB,MAAM,CAAC,MAAM,CAAC,QAAQ;QACtB,MAAM,CAAC,MAAM,CAAC,OAAO;QACrB,MAAM,CAAC,MAAM,CAAC,UAAU;QACxB,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;KACvG,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,gBAAgB,CAAC,CAAC;AAC1G,CAAC;AAED,SAAS,YAAY,CAAC,KAAqB,EAAE,MAAqB;IAGhE,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3D,OAAO;QACL,aAAa,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;KACjE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,OAAe,EACf,IAAc,EACd,OAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE;YAChD,GAAG,EAAE,OAAO,EAAE,GAAG;YACjB,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;QACH,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;SAC5B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,IAAI,KAAK;YAC7E,CAAC,CAAC,MAAM,CAAE,KAA8B,CAAC,MAAM,IAAI,EAAE,CAAC;YACtD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClH,MAAM,IAAI,UAAU,CAAC,mBAAmB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IAC9G,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB;IAC/B,OAAO,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,UAAU,CAAC,OAA8B;IAChD,OAAO,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;AAC7G,CAAC;AAED,SAAS,iBAAiB,CAAC,OAA8B;IACvD,OAAO,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACrF,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE;QAC5B,CAAC,CAAC,mBAAmB,CAAC;AAC1B,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAA8B,EAAE,MAAe;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,IAAI,oBAAoB,CAAC;IAC7D,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,GAAG,WAAW,IAAI,GAAG,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,kBAAkB,EAAE,CAAC;IACjD,MAAM,OAAO,GAAqB;QAChC,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,WAAW;QACpB,MAAM;QACN,OAAO;QACP,cAAc,EAAE,aAAa;QAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI;KAChC,CAAC;IACF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QACnD,OAAO;YACL,GAAG,OAAO;YACV,MAAM,EAAE,SAAS;YACjB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,SAAS;SACnD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO;YACL,GAAG,OAAO;YACV,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAC5G,CAAC;AAED,SAAS,2BAA2B,CAAC,MAA8B,EAAE,GAAW;IAC9E,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACjH,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnF,OAAO,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,4BAA4B,CAAC,MAA8B,EAAE,GAAW;IACrF,MAAM,aAAa,GAAG,2BAA2B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,MAAM,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACpC,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA8B,EAAE,aAAqB,EAAE,KAAqB,EAAE,GAAY;IACnH,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAChG,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,KAAqB,EAAE,MAAqB;IAC5E,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,MAAM,yBAAyB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC1E,OAAO,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,KAAqB,EACrB,MAAqB,EACrB,MAA8B;IAE9B,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,0BAA0B,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5G,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,MAA8B,EAC9B,OAA8B,EAC9B,MAAqB,EACrB,KAAqB,EACrB,MAAe;IAEf,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,aAAa,GAAG,MAAM,4BAA4B,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1F,MAAM,OAAO,GAAyB;QACpC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,SAAS;QACjB,OAAO;QACP,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;KAC1C,CAAC;IACF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,YAAY,CAChB,aAAa,EACb;YACE,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,KAAK,KAAK,SAAS;YAC5B,MAAM,EAAE,KAAK,KAAK,QAAQ;YAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;SACrE,EACD,MAAM,CACP,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACpE,OAAO;YACL,GAAG,OAAO;YACV,MAAM,EAAE,SAAS;YACjB,iBAAiB,EAAE,SAAS,EAAE,gBAAgB;SAC/C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO;YACL,GAAG,OAAO;YACV,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAChB,GAAqB,EACrB,QAAgC,EAChC,UAAmB,EACnB,eAAwB;IAExB,MAAM,QAAQ,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CACrG,CAAC,KAAK,EAAuC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAC1E,CAAC;IACF,OAAO;QACL,aAAa,EAAE,UAAU;QACzB,kBAAkB,EAAE,eAAe;QACnC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;QACjE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;QACjE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;QACjE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAA0B,EAC1B,OAA8B,EAC9B,MAAqB;IAErB,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;QAC9D,MAAM,IAAI,UAAU,CAAC,oEAAoE,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9G,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC;IACvC,MAAM,gBAAgB,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5G,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,oDAAoD,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,KAAK,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,MAAM,GAAG,GAAG,UAAU;QACpB,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;QACnC,CAAC,CAAC;YACE,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC;YACnC,MAAM,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE;YAC9D,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzF,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI;YAC/B,MAAM,EAAE,eAAe;SACJ,CAAC;IAE1B,IAAI,cAAc,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,IAAI,gBAAgB,EAAE,CAAC;QACrB,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,0BAA0B,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACvG,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,UAAU,CAAC,oBAAoB,gBAAgB,sBAAsB,KAAK,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QACtH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,MAAM,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IACtE,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QACxB,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,MAAM;QACf,KAAK;QACL,MAAM,EAAE,gBAAgB;QACxB,GAAG;QACH,QAAQ;QACR,OAAO;KACR,CAAC;AACJ,CAAC","debugId":"75ce1812-4133-528d-8ef4-42a7f5a81eb3"}
+{"version":3,"file":"upgrade.js","sources":["cli/commands/upgrade.ts"],"sourceRoot":"/","sourcesContent":["import { execFile } from \"node:child_process\";\nimport path from \"node:path\";\nimport { promisify } from \"node:util\";\nimport {\n  readManagedExtensionState,\n  runExtension,\n  type ExtensionScope,\n  type ManagedExtensionRecord,\n  type ManagedExtensionSource,\n} from \"./extension.js\";\nimport { resolveExtensionRoots } from \"../../core/extensions/loader.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolvePmRoot } from \"../../core/store/paths.js\";\nimport { resolvePmCliVersion } from \"../../core/packages/root.js\";\n\nconst execFileAsync = promisify(execFile);\nconst DEFAULT_CLI_PACKAGE = \"@unbrained/pm-cli\";\nconst DEFAULT_TAG = \"latest\";\n\nexport interface UpgradeCommandOptions {\n  dryRun?: boolean;\n  cliOnly?: boolean;\n  packagesOnly?: boolean;\n  project?: boolean;\n  local?: boolean;\n  global?: boolean;\n  repair?: boolean;\n  tag?: string;\n  packageName?: string;\n  commandRunner?: UpgradeCommandRunner;\n}\n\nexport const _testOnly = {\n  defaultCommandRunner,\n  isLocalNpmSpec,\n  normalizeTarget,\n  packageRecordMatchesTarget,\n  resolveCliPackage,\n  resolvePackageInstallSource,\n  resolveRunnablePackageSource,\n  resolveScope,\n  resolveTag,\n  packageCommandFor,\n  summarize,\n};\n\nexport interface UpgradeCommandRunnerResult {\n  stdout: string;\n  stderr: string;\n}\n\nexport type UpgradeCommandRunner = (\n  command: string,\n  args: string[],\n  options?: { cwd?: string },\n) => Promise<UpgradeCommandRunnerResult>;\n\nexport interface UpgradeCliResult {\n  requested: boolean;\n  status: \"planned\" | \"updated\" | \"failed\" | \"skipped\";\n  package: string;\n  target: string;\n  command: string[];\n  before_version?: string;\n  after_version?: string;\n  repair: boolean;\n  reason?: string;\n  error?: string;\n}\n\nexport interface UpgradePackageResult {\n  name: string;\n  directory: string;\n  scope: ExtensionScope;\n  source: ManagedExtensionSource;\n  status: \"planned\" | \"updated\" | \"failed\" | \"skipped\";\n  command: string[];\n  previous_version: string;\n  installed_version?: string;\n  reason?: string;\n  error?: string;\n}\n\nexport interface UpgradeResult {\n  ok: boolean;\n  action: \"upgrade\";\n  dry_run: boolean;\n  scope: ExtensionScope;\n  target?: string;\n  cli: UpgradeCliResult;\n  packages: UpgradePackageResult[];\n  summary: {\n    requested_cli: boolean;\n    requested_packages: boolean;\n    planned: number;\n    updated: number;\n    skipped: number;\n    failed: number;\n  };\n}\n\nfunction resolveScope(options: UpgradeCommandOptions): ExtensionScope {\n  const projectLike = options.project === true || options.local === true;\n  const global = options.global === true;\n  if (projectLike && global) {\n    throw new PmCliError('Options \"--project/--local\" and \"--global\" are mutually exclusive.', EXIT_CODE.USAGE);\n  }\n  return global ? \"global\" : \"project\";\n}\n\nfunction normalizeTarget(value: string): string {\n  return value.trim().toLowerCase();\n}\n\nfunction packageRecordMatchesTarget(record: ManagedExtensionRecord, target: string): boolean {\n  const normalizedTarget = normalizeTarget(target);\n  const values = [\n    record.name,\n    record.directory,\n    record.source.input,\n    record.source.location,\n    record.source.package,\n    record.source.repository,\n    record.source.owner && record.source.repo ? `${record.source.owner}/${record.source.repo}` : undefined,\n  ];\n  return values.some((value) => typeof value === \"string\" && normalizeTarget(value) === normalizedTarget);\n}\n\nfunction resolveRoots(scope: ExtensionScope, global: GlobalOptions): {\n  selected_root: string;\n} {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const roots = resolveExtensionRoots(pmRoot, process.cwd());\n  return {\n    selected_root: scope === \"global\" ? roots.global : roots.project,\n  };\n}\n\nasync function defaultCommandRunner(\n  command: string,\n  args: string[],\n  options?: { cwd?: string },\n): Promise<UpgradeCommandRunnerResult> {\n  try {\n    const result = await execFileAsync(command, args, {\n      cwd: options?.cwd,\n      encoding: \"utf8\",\n    });\n    return {\n      stdout: result.stdout,\n      stderr: result.stderr,\n    };\n  } catch (error: unknown) {\n    const stderr = typeof error === \"object\" && error !== null && \"stderr\" in error\n      ? String((error as { stderr?: unknown }).stderr ?? \"\")\n      : \"\";\n    const message = stderr.trim().length > 0 ? stderr.trim() : error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`Command failed: ${command} ${args.join(\" \")}\\n${message}`, EXIT_CODE.GENERIC_FAILURE);\n  }\n}\n\nasync function readCurrentVersion(): Promise<string | undefined> {\n  return resolvePmCliVersion(import.meta.url, [\"../../..\"]);\n}\n\nfunction resolveTag(options: UpgradeCommandOptions): string {\n  return typeof options.tag === \"string\" && options.tag.trim().length > 0 ? options.tag.trim() : DEFAULT_TAG;\n}\n\nfunction resolveCliPackage(options: UpgradeCommandOptions): string {\n  return typeof options.packageName === \"string\" && options.packageName.trim().length > 0\n    ? options.packageName.trim()\n    : DEFAULT_CLI_PACKAGE;\n}\n\nasync function upgradeCli(options: UpgradeCommandOptions, dryRun: boolean): Promise<UpgradeCliResult> {\n  const runner = options.commandRunner ?? defaultCommandRunner;\n  const packageName = resolveCliPackage(options);\n  const tag = resolveTag(options);\n  const target = `${packageName}@${tag}`;\n  const command = [\"npm\", \"install\", \"-g\", target];\n  if (options.repair === true) {\n    command.push(\"--force\");\n  }\n  const beforeVersion = await readCurrentVersion();\n  const planned: UpgradeCliResult = {\n    requested: true,\n    status: \"planned\",\n    package: packageName,\n    target,\n    command,\n    before_version: beforeVersion,\n    repair: options.repair === true,\n  };\n  if (dryRun) {\n    return planned;\n  }\n  try {\n    await runner(command[0]!, command.slice(1));\n    const verified = await runner(\"pm\", [\"--version\"]);\n    return {\n      ...planned,\n      status: \"updated\",\n      after_version: verified.stdout.trim() || undefined,\n    };\n  } catch (error: unknown) {\n    return {\n      ...planned,\n      status: \"failed\",\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\nfunction isLocalNpmSpec(spec: string): boolean {\n  return path.isAbsolute(spec) || spec.startsWith(\".\") || spec.startsWith(\"..\") || spec.startsWith(\"file:\");\n}\n\nfunction resolvePackageInstallSource(source: ManagedExtensionSource, tag: string): string {\n  if (source.kind === \"npm\") {\n    const rawSpec = source.input.startsWith(\"npm:\") ? source.input.slice(\"npm:\".length).trim() : source.input.trim();\n    if (!isLocalNpmSpec(rawSpec) && source.package && source.package.trim().length > 0) {\n      return `npm:${source.package.trim()}@${tag}`;\n    }\n    return source.input.startsWith(\"npm:\") ? source.input : `npm:${source.input}`;\n  }\n  return source.input;\n}\n\nasync function resolveRunnablePackageSource(source: ManagedExtensionSource, tag: string): Promise<string> {\n  const installSource = resolvePackageInstallSource(source, tag);\n  if (source.kind !== \"local\") {\n    return installSource;\n  }\n  if (await pathExists(installSource)) {\n    return installSource;\n  }\n  if (await pathExists(source.location)) {\n    return source.location;\n  }\n  return installSource;\n}\n\nfunction packageCommandFor(source: ManagedExtensionSource, installSource: string, scope: ExtensionScope, ref?: string): string[] {\n  const command = [\"pm\", \"install\", installSource, scope === \"global\" ? \"--global\" : \"--project\"];\n  if (source.kind === \"github\" && ref && ref.trim().length > 0) {\n    command.push(\"--ref\", ref.trim());\n  }\n  return command;\n}\n\nasync function readManagedRecords(scope: ExtensionScope, global: GlobalOptions): Promise<ManagedExtensionRecord[]> {\n  const roots = resolveRoots(scope, global);\n  const managedState = await readManagedExtensionState(roots.selected_root);\n  return managedState.state.entries.filter((entry) => entry.scope === scope);\n}\n\nasync function refreshManagedRecord(\n  scope: ExtensionScope,\n  global: GlobalOptions,\n  record: ManagedExtensionRecord,\n): Promise<ManagedExtensionRecord | undefined> {\n  const records = await readManagedRecords(scope, global);\n  return records.find((candidate) => packageRecordMatchesTarget(candidate, record.name)) ??\n    records.find((candidate) => normalizeTarget(candidate.directory) === normalizeTarget(record.directory));\n}\n\nasync function upgradePackageRecord(\n  record: ManagedExtensionRecord,\n  options: UpgradeCommandOptions,\n  global: GlobalOptions,\n  scope: ExtensionScope,\n  dryRun: boolean,\n): Promise<UpgradePackageResult> {\n  const tag = resolveTag(options);\n  const installSource = await resolveRunnablePackageSource(record.source, tag);\n  const command = packageCommandFor(record.source, installSource, scope, record.source.ref);\n  const planned: UpgradePackageResult = {\n    name: record.name,\n    directory: record.directory,\n    scope,\n    source: record.source,\n    status: \"planned\",\n    command,\n    previous_version: record.manifest_version,\n  };\n  if (dryRun) {\n    return planned;\n  }\n  try {\n    await runExtension(\n      installSource,\n      {\n        install: true,\n        project: scope === \"project\",\n        global: scope === \"global\",\n        ref: record.source.kind === \"github\" ? record.source.ref : undefined,\n      },\n      global,\n    );\n    const refreshed = await refreshManagedRecord(scope, global, record);\n    return {\n      ...planned,\n      status: \"updated\",\n      installed_version: refreshed?.manifest_version,\n    };\n  } catch (error: unknown) {\n    return {\n      ...planned,\n      status: \"failed\",\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\nfunction summarize(\n  cli: UpgradeCliResult,\n  packages: UpgradePackageResult[],\n  includeCli: boolean,\n  includePackages: boolean,\n): UpgradeResult[\"summary\"] {\n  const statuses = [includeCli ? cli.status : undefined, ...packages.map((entry) => entry.status)].filter(\n    (value): value is UpgradeCliResult[\"status\"] => typeof value === \"string\",\n  );\n  return {\n    requested_cli: includeCli,\n    requested_packages: includePackages,\n    planned: statuses.filter((status) => status === \"planned\").length,\n    updated: statuses.filter((status) => status === \"updated\").length,\n    skipped: statuses.filter((status) => status === \"skipped\").length,\n    failed: statuses.filter((status) => status === \"failed\").length,\n  };\n}\n\nexport async function runUpgrade(\n  target: string | undefined,\n  options: UpgradeCommandOptions,\n  global: GlobalOptions,\n): Promise<UpgradeResult> {\n  if (options.cliOnly === true && options.packagesOnly === true) {\n    throw new PmCliError('Options \"--cli-only\" and \"--packages-only\" are mutually exclusive.', EXIT_CODE.USAGE);\n  }\n\n  const scope = resolveScope(options);\n  const dryRun = options.dryRun === true;\n  const normalizedTarget = typeof target === \"string\" && target.trim().length > 0 ? target.trim() : undefined;\n  if (options.cliOnly === true && normalizedTarget) {\n    throw new PmCliError('A package target cannot be used with \"--cli-only\".', EXIT_CODE.USAGE);\n  }\n  const includeCli = options.packagesOnly === true || normalizedTarget ? false : true;\n  const includePackages = options.cliOnly === true ? false : true;\n  const cli = includeCli\n    ? await upgradeCli(options, dryRun)\n    : {\n        requested: false,\n        status: \"skipped\",\n        package: resolveCliPackage(options),\n        target: `${resolveCliPackage(options)}@${resolveTag(options)}`,\n        command: [\"npm\", \"install\", \"-g\", `${resolveCliPackage(options)}@${resolveTag(options)}`],\n        repair: options.repair === true,\n        reason: \"not_requested\",\n      } as UpgradeCliResult;\n\n  let packageRecords = includePackages ? await readManagedRecords(scope, global) : [];\n  if (normalizedTarget) {\n    packageRecords = packageRecords.filter((entry) => packageRecordMatchesTarget(entry, normalizedTarget));\n    if (packageRecords.length === 0) {\n      throw new PmCliError(`Managed package \"${normalizedTarget}\" was not found in ${scope} scope.`, EXIT_CODE.NOT_FOUND);\n    }\n  }\n\n  const packages: UpgradePackageResult[] = [];\n  for (const record of packageRecords) {\n    packages.push(await upgradePackageRecord(record, options, global, scope, dryRun));\n  }\n\n  const summary = summarize(cli, packages, includeCli, includePackages);\n  return {\n    ok: summary.failed === 0,\n    action: \"upgrade\",\n    dry_run: dryRun,\n    scope,\n    target: normalizedTarget,\n    cli,\n    packages,\n    summary,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"734ddb9b-8a2a-5510-9fe7-084f08b7f7a4"}

package/dist/cli/commands/validate.d.ts

@@ -1,6 +1,16 @@
+import { type RuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
 import type { GlobalOptions } from "../../core/shared/command-types.js";
+import { listAllFrontMatterWithBody } from "../../core/store/item-store.js";
+import { type StaleLinkPruneRow, type TerminalParentFixRow, type ValidateFixRecord } from "../../core/validate/fix-planning.js";
+import { type DuplicateIssueCode } from "../../core/governance/issue-codes.js";
+import type { ValidateMetadataProfile, ValidateMetadataRequiredField } from "../../types/index.js";
 type ValidateCheckName = "metadata" | "resolution" | "lifecycle" | "files" | "command_references" | "history_drift";
 type ValidateStatus = "ok" | "warn" | "error";
+type ValidateDependencyCycleSeverity = "off" | "warn" | "error";
+type ValidateFileScanMode = "default" | "tracked-all" | "tracked-all-strict";
+type ItemWithBody = Awaited<ReturnType<typeof listAllFrontMatterWithBody>>[number];
+declare const LIFECYCLE_PATTERN_FIELD_KEYS: readonly ["blocked_reason", "resolution", "actual_result"];
+type LifecyclePatternFieldKey = (typeof LIFECYCLE_PATTERN_FIELD_KEYS)[number];
 export interface ValidateCommandOptions {
     checkMetadata?: boolean;
     checkResolution?: boolean;
@@ -11,6 +21,8 @@ export interface ValidateCommandOptions {
     includePmInternals?: boolean;
     verboseFileLists?: boolean;
     verboseDiagnostics?: boolean;
+    /** Emit complete *_item_ids diagnostic lists (no 5-item cap); implied by --json. */
+    allAffectedIds?: boolean;
     checkHistoryDrift?: boolean;
     checkCommandReferences?: boolean;
     scanMode?: string;
@@ -49,5 +61,107 @@ export interface ValidateResult {
     fixes?: ValidateFixesSummary;
     generated_at: string;
 }
+declare function toMeaningfulString(value: unknown): string | undefined;
+type LifecyclePatternSource = "default" | "settings";
+interface LifecyclePatternPolicy {
+    stale_blocker_reason_patterns: string[];
+    stale_blocker_reason_pattern_source: LifecyclePatternSource;
+    closure_like_metadata_field_patterns: Record<LifecyclePatternFieldKey, string[]>;
+    closure_like_metadata_field_pattern_sources: Record<LifecyclePatternFieldKey, LifecyclePatternSource>;
+}
+declare function resolveValidateMetadataProfile(value: string | undefined): ValidateMetadataProfile;
+declare function resolveDependencyCycleSeverity(value: string | undefined): ValidateDependencyCycleSeverity;
+declare function isMetadataFieldMissing(item: ItemWithBody, field: ValidateMetadataRequiredField, statusRegistry: RuntimeStatusRegistry): boolean;
+declare function resolveFileScanMode(scanMode: string | undefined): ValidateFileScanMode;
+declare function resolveWorkspaceRoot(pmRoot: string): string;
+declare function listFilesRecursive(basePath: string, relativePath: string, output: string[]): Promise<void>;
+declare function collectDefaultProjectFileCandidates(workspaceRoot: string): Promise<string[]>;
+declare function collectTrackedGitFileCandidates(workspaceRoot: string): Promise<string[] | null>;
+/**
+ * Attach a uniform, machine-executable `fix_hints` array to a validate check's
+ * details when `--fix-hints` is requested. The resolution check's existing
+ * per-row remediation commands (which already carry concrete item ids) are
+ * aliased in so agents read one uniform field across every check; all other
+ * checks derive one generic command per distinct warning code from the shared
+ * remediation registry. Generic hints may contain `<id>`/`<field>`/`<path>`
+ * placeholders the caller substitutes before running — they are templates, not
+ * always directly executable as-is. Read-only: this only enriches the diagnostic
+ * output, never mutates any item.
+ */
+declare function attachValidateFixHints(check: ValidateCheck, checkWarnings: string[]): void;
+declare function resolveRequestedChecks(options: ValidateCommandOptions): Set<ValidateCheckName>;
+/**
+ * Project the duplicate logical issue-code findings (GH-235) into the
+ * metadata-check `details` shape plus an advisory warning token. Duplicate
+ * codes are advisory (warn), never an error — matching every other metadata
+ * finding — so an otherwise clean tracker that simply reuses a title prefix is
+ * not failed by `pm validate`. Kept outside the c8-ignored builder block so the
+ * projection/remediation logic is fully covered by unit tests.
+ */
+declare function summarizeDuplicateIssueCodes(duplicates: DuplicateIssueCode[], verboseDiagnostics: boolean): {
+    rows: Array<Record<string, unknown>>;
+    truncated: boolean;
+    warnings: string[];
+};
+declare function buildLifecycleDependencyGraph(activeItems: ItemWithBody[]): Map<string, string[]>;
+declare function findLifecycleDependencyCycleComponents(graph: Map<string, string[]>): string[][];
+declare function resolveLifecycleDependencyCycleSamplePath(component: string[], graph: Map<string, string[]>): string[];
+declare function detectLifecycleDependencyCycles(activeItems: ItemWithBody[]): {
+    cycle_count: number;
+    cycle_item_ids: string[];
+    cycle_sample_paths: string[];
+};
+declare function buildLifecycleCheck(items: ItemWithBody[], includeStaleBlockers: boolean, dependencyCycleSeverity: ValidateDependencyCycleSeverity, statusRegistry: RuntimeStatusRegistry, lifecyclePatternPolicy: LifecyclePatternPolicy, verboseDiagnostics: boolean): {
+    check: ValidateCheck;
+    warnings: string[];
+    terminalParentFixRows: TerminalParentFixRow[];
+};
+declare function buildFilesCheck(items: ItemWithBody[], workspaceRoot: string, pmRoot: string, fileScanMode: ValidateFileScanMode, includePmInternals: boolean, verboseFileLists: boolean): Promise<{
+    check: ValidateCheck;
+    warnings: string[];
+    staleLinkPruneRows: StaleLinkPruneRow[];
+}>;
+declare function buildCommandReferencesCheck(items: ItemWithBody[], idPrefix: string, verboseDiagnostics: boolean): {
+    check: ValidateCheck;
+    warnings: string[];
+};
+/**
+ * Apply one planned fix through the SAME audited command paths an operator
+ * would use by hand (`pm update` / `pm files --remove` / `pm docs --remove`),
+ * so every applied fix carries normal history, locking, and hook behavior.
+ * Command modules are imported lazily: plain validate runs stay read-only and
+ * never pay the mutation-stack import cost.
+ */
+declare function applyValidateFix(fix: ValidateFixRecord, global: GlobalOptions): Promise<void>;
+declare function applyValidateFixes(applicable: ValidateFixRecord[], global: GlobalOptions): Promise<{
+    applied: ValidateFixRecord[];
+    failed: Array<{
+        fix: ValidateFixRecord;
+        error: unknown;
+    }>;
+}>;
+export declare const _testOnlyValidateCommand: {
+    applyValidateFix: typeof applyValidateFix;
+    applyValidateFixes: typeof applyValidateFixes;
+    attachValidateFixHints: typeof attachValidateFixHints;
+    buildCommandReferencesCheck: typeof buildCommandReferencesCheck;
+    buildFilesCheck: typeof buildFilesCheck;
+    buildLifecycleCheck: typeof buildLifecycleCheck;
+    buildLifecycleDependencyGraph: typeof buildLifecycleDependencyGraph;
+    collectDefaultProjectFileCandidates: typeof collectDefaultProjectFileCandidates;
+    collectTrackedGitFileCandidates: typeof collectTrackedGitFileCandidates;
+    detectLifecycleDependencyCycles: typeof detectLifecycleDependencyCycles;
+    findLifecycleDependencyCycleComponents: typeof findLifecycleDependencyCycleComponents;
+    isMetadataFieldMissing: typeof isMetadataFieldMissing;
+    listFilesRecursive: typeof listFilesRecursive;
+    resolveDependencyCycleSeverity: typeof resolveDependencyCycleSeverity;
+    resolveFileScanMode: typeof resolveFileScanMode;
+    resolveLifecycleDependencyCycleSamplePath: typeof resolveLifecycleDependencyCycleSamplePath;
+    resolveRequestedChecks: typeof resolveRequestedChecks;
+    resolveValidateMetadataProfile: typeof resolveValidateMetadataProfile;
+    resolveWorkspaceRoot: typeof resolveWorkspaceRoot;
+    summarizeDuplicateIssueCodes: typeof summarizeDuplicateIssueCodes;
+    toMeaningfulString: typeof toMeaningfulString;
+};
 export declare function runValidate(options: ValidateCommandOptions, global: GlobalOptions): Promise<ValidateResult>;
 export {};