@unbrained/pm-cli 2026.5.31 → 2026.6.6

package/dist/cli-bundle/chunks/upgrade-LXPOQKFV.js

@@ -0,0 +1,266 @@
+
+!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]="3018215e-a9aa-5978-8f18-8beac74746e8")}catch(e){}}();
+import {
+  readManagedExtensionState,
+  runExtension
+} from "./chunk-TPH5XEVD.js";
+import "./chunk-LXYVKYMQ.js";
+import "./chunk-TCD3R2PF.js";
+import {
+  EXIT_CODE,
+  PmCliError,
+  pathExists,
+  resolveExtensionRoots,
+  resolvePmPackageRootFromModule,
+  resolvePmRoot
+} from "./chunk-5SFCOO6B.js";
+
+// dist/cli/commands/upgrade.js
+import { execFile } from "node:child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+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 global = options.global === true;
+  if (projectLike && global) {
+    throw new PmCliError('Options "--project/--local" and "--global" are mutually exclusive.', EXIT_CODE.USAGE);
+  }
+  return global ? "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, global) {
+  const pmRoot = resolvePmRoot(process.cwd(), global.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() {
+  const packageJsonPath = path.join(resolvePmPackageRootFromModule(import.meta.url, ["../../.."]), "package.json");
+  try {
+    const parsed = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+    return typeof parsed.version === "string" ? parsed.version : void 0;
+  } catch {
+    return void 0;
+  }
+}
+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, global) {
+  const roots = resolveRoots(scope, global);
+  const managedState = await readManagedExtensionState(roots.selected_root);
+  return managedState.state.entries.filter((entry) => entry.scope === scope);
+}
+async function refreshManagedRecord(scope, global, record) {
+  const records = await readManagedRecords(scope, global);
+  return records.find((candidate) => packageRecordMatchesTarget(candidate, record.name)) ?? records.find((candidate) => normalizeTarget(candidate.directory) === normalizeTarget(record.directory));
+}
+async function upgradePackageRecord(record, options, global, 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
+    }, global);
+    const refreshed = await refreshManagedRecord(scope, global, 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, global) {
+  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, global) : [];
+  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, global, 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 {
+  runUpgrade
+};
+//# sourceMappingURL=upgrade-LXPOQKFV.js.map
+
+//# debugId=3018215e-a9aa-5978-8f18-8beac74746e8

package/dist/cli-bundle/chunks/upgrade-LXPOQKFV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/upgrade.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport fs from \"node:fs/promises\";\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 { resolvePmPackageRootFromModule } 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  const packageJsonPath = path.join(resolvePmPackageRootFromModule(import.meta.url, [\"../../..\"]), \"package.json\");\n  try {\n    const parsed = JSON.parse(await fs.readFile(packageJsonPath, \"utf8\")) as { version?: unknown };\n    return typeof parsed.version === \"string\" ? parsed.version : undefined;\n  } catch {\n    return undefined;\n  }\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":"3018215e-a9aa-5978-8f18-8beac74746e8"}

package/dist/cli-bundle/chunks/{validate-TMCVKIGZ.js → validate-AGOAUOVW.js}

@@ -1,30 +1,30 @@
 import {
   extractReferencedPmItemIdsFromCommand
-} from "./chunk-PXUAZUUY.js";
+} from "./chunk-OZ7NSQHL.js";
 import {
+  buildRemediationCommands,
   scanHistoryDrift
-} from "./chunk-VGICHR7D.js";
-import "./chunk-JFWUHHS2.js";
-import "./chunk-WJ2NAC37.js";
-import "./chunk-NGN7UV5K.js";
-import "./chunk-JULRTHJQ.js";
-import "./chunk-OGZEG5TT.js";
-import "./chunk-EGUGFSNX.js";
+} from "./chunk-52MAOQ6J.js";
+import "./chunk-UM2GBHS4.js";
+import "./chunk-N7ACFE26.js";
+import "./chunk-XLTD2HN3.js";
+import "./chunk-3LB74A67.js";
+import "./chunk-OVQCEJPG.js";
+import "./chunk-ECCMVXGM.js";
 import "./chunk-3HUE7XOF.js";
 import {
   listAllFrontMatterWithBody
-} from "./chunk-BUPWJ3IJ.js";
-import "./chunk-4AEZR5EJ.js";
-import "./chunk-CEFIVZPG.js";
+} from "./chunk-XTGLRY2Y.js";
+import "./chunk-T3LC5LKB.js";
 import {
   normalizeStatusInput
-} from "./chunk-MD7K4JYF.js";
+} from "./chunk-AO442XLN.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-WDPXDQFG.js";
+} from "./chunk-KJE2FOS4.js";
 import {
   nowIso
-} from "./chunk-PVNQLCIS.js";
+} from "./chunk-QO7EBBOM.js";
 import {
   DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS,
   DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS,
@@ -38,7 +38,7 @@ import {
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   toNonEmptyStringOrUndefined
-} from "./chunk-LSXGH6NE.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/cli/commands/validate.js
 import fs from "node:fs/promises";
@@ -49,7 +49,7 @@ 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] = "07339f90-f764-5ffb-b4c7-f0bf9a410f89");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "776e2ca9-52d6-5274-9230-4d9b961456e5");
   } catch (e2) {
   }
 })();
@@ -142,7 +142,7 @@ var METADATA_TRUNCATED_KEY_BY_FIELD = {
 };
 var GIT_LS_FILES_MAX_BUFFER = 32 * 1024 * 1024;
 var FILE_LIST_SUMMARY_LIMIT = 40;
-var DIAGNOSTIC_LIST_SUMMARY_LIMIT = 40;
+var DIAGNOSTIC_LIST_SUMMARY_LIMIT = 5;
 var execFileAsync = promisify(execFile);
 function normalizeRelativePath(value) {
   return value.replaceAll("\\", "/").replace(/^\.\/+/, "").replace(/^\/+/, "");
@@ -489,6 +489,20 @@ function buildResolutionRemediationCommand(row) {
   const fieldArguments = row.missing_fields.map((field) => `${RESOLUTION_REMEDIATION_FLAG_BY_FIELD[field]} "${RESOLUTION_REMEDIATION_PLACEHOLDER_BY_FIELD[field]}"`).join(" ");
   return `pm update ${row.id} ${fieldArguments} --message "Backfill resolution metadata"`;
 }
+function attachValidateFixHints(check, checkWarnings) {
+  const existingResolutionHints = check.details?.missing_resolution_remediation_hints;
+  const aliasedResolution = Array.isArray(existingResolutionHints) && existingResolutionHints.length > 0;
+  const fixHints = aliasedResolution ? existingResolutionHints.filter((hint) => typeof hint === "string") : buildRemediationCommands(checkWarnings);
+  if (fixHints.length === 0) {
+    return;
+  }
+  const truncated = aliasedResolution && check.details?.missing_resolution_remediation_hints_truncated === true;
+  check.details = {
+    ...check.details,
+    fix_hints: fixHints,
+    ...truncated ? { fix_hints_truncated: true } : {}
+  };
+}
 function resolveRequestedChecks(options) {
   const requested = /* @__PURE__ */ new Set();
   if (options.checkMetadata) {
@@ -728,7 +742,7 @@ function detectLifecycleDependencyCycles(activeItems) {
     cycle_sample_paths: cycleSamplePaths
   };
 }
-function buildLifecycleCheck(items, includeStaleBlockers, dependencyCycleSeverity, statusRegistry, lifecyclePatternPolicy) {
+function buildLifecycleCheck(items, includeStaleBlockers, dependencyCycleSeverity, statusRegistry, lifecyclePatternPolicy, verboseDiagnostics) {
   const itemsById = new Map(items.map((item) => [item.id, item]));
   const blockedStatuses = statusRegistry.blocked_statuses.size > 0 ? statusRegistry.blocked_statuses : /* @__PURE__ */ new Set(["blocked"]);
   const activeItems = items.filter((item) => !isTerminalStatus(item.status, statusRegistry));
@@ -811,11 +825,12 @@ function buildLifecycleCheck(items, includeStaleBlockers, dependencyCycleSeverit
   if (dependencyCycleDiagnostics.cycle_count > 0 && dependencyCycleSeverity !== "off") {
     warnings.push(`${dependencyCycleSeverity === "error" ? "validate_lifecycle_dependency_cycles_error" : "validate_lifecycle_dependency_cycles"}:${dependencyCycleDiagnostics.cycle_count}`);
   }
-  const summarizedClosureLikeRows = summarizeList(closureLikeRows.map((row) => `${row.id}:${row.fields.join(",")}`));
-  const summarizedTerminalParentRows = summarizeList(terminalParentRows.map((row) => `${row.id}:${row.parent_id}:${row.parent_status}`));
-  const summarizedStaleBlockerRows = summarizeList(staleBlockerRows.map((row) => `${row.id}:${row.status}:${row.reasons.join(",")}`));
-  const summarizedDependencyCycleItemIds = summarizeList(dependencyCycleDiagnostics.cycle_item_ids);
-  const summarizedDependencyCycleSamplePaths = summarizeList(dependencyCycleDiagnostics.cycle_sample_paths);
+  const diagnosticLimit = verboseDiagnostics ? Number.POSITIVE_INFINITY : DIAGNOSTIC_LIST_SUMMARY_LIMIT;
+  const summarizedClosureLikeRows = summarizeList(closureLikeRows.map((row) => `${row.id}:${row.fields.join(",")}`), diagnosticLimit);
+  const summarizedTerminalParentRows = summarizeList(terminalParentRows.map((row) => `${row.id}:${row.parent_id}:${row.parent_status}`), diagnosticLimit);
+  const summarizedStaleBlockerRows = summarizeList(staleBlockerRows.map((row) => `${row.id}:${row.status}:${row.reasons.join(",")}`), diagnosticLimit);
+  const summarizedDependencyCycleItemIds = summarizeList(dependencyCycleDiagnostics.cycle_item_ids, diagnosticLimit);
+  const summarizedDependencyCycleSamplePaths = summarizeList(dependencyCycleDiagnostics.cycle_sample_paths, diagnosticLimit);
   return {
     check: {
       name: "lifecycle",
@@ -950,7 +965,7 @@ async function buildFilesCheck(items, workspaceRoot, pmRoot, fileScanMode, inclu
     warnings
   };
 }
-async function buildHistoryDriftCheck(pmRoot, items) {
+async function buildHistoryDriftCheck(pmRoot, items, verboseDiagnostics) {
   const { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems } = await scanHistoryDrift(pmRoot, items);
   const warnings = [];
   if (missingStreams.length > 0) {
@@ -965,7 +980,8 @@ async function buildHistoryDriftCheck(pmRoot, items) {
   if (chainMismatches.length > 0) {
     warnings.push(`validate_history_drift_chain_mismatches:${chainMismatches.length}`);
   }
-  const summarizedDrifted = summarizeList(driftedItems);
+  const diagnosticLimit = verboseDiagnostics ? Number.POSITIVE_INFINITY : DIAGNOSTIC_LIST_SUMMARY_LIMIT;
+  const summarizedDrifted = summarizeList(driftedItems, diagnosticLimit);
   return {
     check: {
       name: "history_drift",
@@ -991,7 +1007,7 @@ function summarizeCommandReferenceRow(ownerId, referencedId, command) {
   const commandPreview = normalizedCommand.length > 120 ? `${normalizedCommand.slice(0, 117)}...` : normalizedCommand;
   return `${ownerId}:${referencedId}:${commandPreview}`;
 }
-function buildCommandReferencesCheck(items, idPrefix) {
+function buildCommandReferencesCheck(items, idPrefix, verboseDiagnostics) {
   const knownIds = new Set(items.map((item) => item.id.toLowerCase()));
   let linkedCommandsScanned = 0;
   let referencedPmIdCount = 0;
@@ -1019,9 +1035,10 @@ function buildCommandReferencesCheck(items, idPrefix) {
   const uniqueStaleReferenceRows = [...new Set(staleReferenceRows)].sort((left, right) => left.localeCompare(right));
   const stalePmIds = [...new Set(uniqueStaleReferenceRows.map((row) => row.split(":")[1] ?? ""))].filter((value) => value.length > 0).sort((left, right) => left.localeCompare(right));
   const warnings = uniqueStaleReferenceRows.length > 0 ? [`validate_command_references_stale_pm_ids:${uniqueStaleReferenceRows.length}`] : [];
-  const summarizedRows = summarizeList(uniqueStaleReferenceRows);
-  const summarizedStalePmIds = summarizeList(stalePmIds);
-  const summarizedReferencedPmIds = summarizeList([...referencedPmIds].sort((left, right) => left.localeCompare(right)));
+  const diagnosticLimit = verboseDiagnostics ? Number.POSITIVE_INFINITY : DIAGNOSTIC_LIST_SUMMARY_LIMIT;
+  const summarizedRows = summarizeList(uniqueStaleReferenceRows, diagnosticLimit);
+  const summarizedStalePmIds = summarizeList(stalePmIds, diagnosticLimit);
+  const summarizedReferencedPmIds = summarizeList([...referencedPmIds].sort((left, right) => left.localeCompare(right)), diagnosticLimit);
   return {
     check: {
       name: "command_references",
@@ -1064,35 +1081,31 @@ async function runValidate(options, global2) {
   const workspaceRoot = resolveWorkspaceRoot(pmRoot);
   const checks = [];
   const warnings = [...new Set(itemReadWarnings)];
+  const fixHintsEnabled = options.fixHints === true;
+  const record = (built) => {
+    if (fixHintsEnabled) {
+      attachValidateFixHints(built.check, built.warnings);
+    }
+    checks.push(built.check);
+    warnings.push(...built.warnings);
+  };
   if (requestedChecks.has("metadata")) {
-    const metadataCheck = buildMetadataCheck(items, metadataPolicy, statusRegistry, Boolean(options.verboseDiagnostics));
-    checks.push(metadataCheck.check);
-    warnings.push(...metadataCheck.warnings);
+    record(buildMetadataCheck(items, metadataPolicy, statusRegistry, Boolean(options.verboseDiagnostics)));
   }
   if (requestedChecks.has("resolution")) {
-    const resolutionCheck = buildResolutionCheck(items, statusRegistry, Boolean(options.verboseDiagnostics));
-    checks.push(resolutionCheck.check);
-    warnings.push(...resolutionCheck.warnings);
+    record(buildResolutionCheck(items, statusRegistry, Boolean(options.verboseDiagnostics)));
   }
   if (requestedChecks.has("lifecycle")) {
-    const lifecycleCheck = buildLifecycleCheck(items, Boolean(options.checkStaleBlockers), dependencyCycleSeverity, statusRegistry, lifecyclePatternPolicy);
-    checks.push(lifecycleCheck.check);
-    warnings.push(...lifecycleCheck.warnings);
+    record(buildLifecycleCheck(items, Boolean(options.checkStaleBlockers), dependencyCycleSeverity, statusRegistry, lifecyclePatternPolicy, Boolean(options.verboseDiagnostics)));
   }
   if (requestedChecks.has("files")) {
-    const filesCheck = await buildFilesCheck(items, workspaceRoot, pmRoot, fileScanMode, Boolean(options.includePmInternals), Boolean(options.verboseFileLists));
-    checks.push(filesCheck.check);
-    warnings.push(...filesCheck.warnings);
+    record(await buildFilesCheck(items, workspaceRoot, pmRoot, fileScanMode, Boolean(options.includePmInternals), Boolean(options.verboseFileLists)));
   }
   if (requestedChecks.has("command_references")) {
-    const commandReferencesCheck = buildCommandReferencesCheck(items, settings.id_prefix);
-    checks.push(commandReferencesCheck.check);
-    warnings.push(...commandReferencesCheck.warnings);
+    record(buildCommandReferencesCheck(items, settings.id_prefix, Boolean(options.verboseDiagnostics)));
   }
   if (requestedChecks.has("history_drift")) {
-    const historyDriftCheck = await buildHistoryDriftCheck(pmRoot, items);
-    checks.push(historyDriftCheck.check);
-    warnings.push(...historyDriftCheck.warnings);
+    record(await buildHistoryDriftCheck(pmRoot, items, Boolean(options.verboseDiagnostics)));
   }
   const normalizedWarnings = [...new Set(warnings)].sort((left, right) => left.localeCompare(right));
   const hasErrors = checks.some((check) => check.status === "error");
@@ -1107,4 +1120,4 @@ async function runValidate(options, global2) {
 export {
   runValidate
 };
-//# sourceMappingURL=validate-TMCVKIGZ.js.map
+//# sourceMappingURL=validate-AGOAUOVW.js.map