@unbrained/pm-cli 2026.9.20 → 2026.9.22

package/dist/sdk/extension/shared.js

@@ -1,2 +1,2 @@
-!(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]="209566d6-107e-5c01-995a-96a6dc0e40ed")}catch(e2){}})();import fs from"node:fs/promises";import path from"node:path";import{pathExists}from"../../core/fs/fs-utils.js";import{isPathWithinDirectory}from"../../core/fs/path-utils.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{DEFAULT_EXTENSION_PRIORITY,isCanonicalPathWithinDirectory,parseExtensionManifestDocument}from"../../core/extensions/loader.js";function normalizeStringList(values){return[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right))}function normalizeExtensionNameForMatch(value){return value.trim().toLowerCase()}function normalizeManagedDirectoryName(name){const normalized=name.trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-");let start=0;while(normalized[start]==="-"){start+=1}let end=normalized.length;while(end>start&&normalized[end-1]==="-"){end-=1}const directoryName=normalized.slice(start,end);if(directoryName.length===0){throw new PmCliError("Extension manifest name must resolve to a non-empty directory name.",EXIT_CODE.USAGE)}if(directoryName==="."||directoryName===".."){throw new PmCliError('Extension manifest name must not resolve to "." or "..".',EXIT_CODE.USAGE)}return directoryName}function parseExtensionManifest(raw){return parseExtensionManifestDocument(raw)}async function readGithubSourcePackageMetadata(sourceRoot){try{const packageJson=JSON.parse(await fs.readFile(path.join(sourceRoot,"package.json"),"utf8"));const packageName=typeof packageJson.name==="string"&&/^(?:@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/iu.test(packageJson.name)?packageJson.name:void 0;return{...packageName?{package_name:packageName}:{},has_build_script:["build","prepare","prepack"].some(key=>typeof packageJson.scripts?.[key]==="string")}}catch{return{has_build_script:false}}}async function missingExtensionEntryError(manifest,entryPath,context){if(context.source_kind!=="github"||typeof context.source_root!=="string"){return new PmCliError(`Extension entry file is missing at "${entryPath}".`,EXIT_CODE.USAGE)}const packageMetadata=await readGithubSourcePackageMetadata(context.source_root);const npmCommand=packageMetadata.package_name?`pm install npm:${packageMetadata.package_name}`:void 0;const source=context.source_input??context.source_root;return new PmCliError(`Extension entry "${manifest.entry}" is absent from GitHub source "${source}". pm install copies GitHub repositories without running package scripts${packageMetadata.has_build_script?", and this package declares a build or publish script":""}. ${npmCommand?`Try "${npmCommand}" if the package is published, or install a locally built directory.`:"Build the source locally and install that directory, or use its published npm: package."}`,EXIT_CODE.USAGE,{code:"github_source_entry_unbuilt",required:"Use a GitHub tree with committed runtime output, a published npm artifact, or a locally built source directory.",why:"GitHub installation is a source copy and never executes untrusted package build scripts.",examples:npmCommand?[npmCommand,`pm install ${context.source_root}`]:[`pm install ${context.source_root}`],nextSteps:npmCommand?[`Retry with ${npmCommand}.`,"Or build the repository locally, then install its directory."]:["Build the repository locally, then install its directory.","If it is published, retry with pm install npm:<package-name>."],recovery:{attempted_command:`pm install ${source}`,normalized_args:["install",source],...npmCommand?{next_best_command:npmCommand}:{}}})}async function validateExtensionDirectory(directory,context={}){const manifestPath=path.join(directory,"manifest.json");if(!await pathExists(manifestPath)){throw new PmCliError(`Extension manifest is missing at "${manifestPath}".`,EXIT_CODE.USAGE)}let parsedManifest;try{parsedManifest=JSON.parse(await fs.readFile(manifestPath,"utf8"))}catch(error){throw new PmCliError(`Failed to parse extension manifest at "${manifestPath}": ${formatManifestReadError(error)}`,EXIT_CODE.USAGE)}const manifest=parseExtensionManifest(parsedManifest);if(!manifest){throw new PmCliError(`Extension manifest at "${manifestPath}" is invalid.`,EXIT_CODE.USAGE)}const entryPath=path.resolve(directory,manifest.entry);if(!isPathWithinDirectory(directory,entryPath)){throw new PmCliError(`Extension entry "${manifest.entry}" resolves outside extension directory "${directory}".`,EXIT_CODE.USAGE)}if(!await pathExists(entryPath)){throw await missingExtensionEntryError(manifest,entryPath,context)}if(!await isCanonicalPathWithinDirectory(directory,entryPath)){throw new PmCliError(`Extension entry "${manifest.entry}" resolves outside extension directory after symlink resolution.`,EXIT_CODE.USAGE)}return{directory,manifest_path:manifestPath,entry_path:entryPath,manifest}}function formatManifestReadError(error){return error instanceof Error?error.message:String(error)}const _testOnlyExtensionShared={formatManifestReadError};export{DEFAULT_EXTENSION_PRIORITY,_testOnlyExtensionShared,isCanonicalPathWithinDirectory,normalizeExtensionNameForMatch,normalizeManagedDirectoryName,normalizeStringList,parseExtensionManifest,validateExtensionDirectory};
+!(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]="decec6f3-3795-5353-bf48-75aa61dd79d4")}catch(e2){}})();import fs from"node:fs/promises";import path from"node:path";import{pathExists}from"../../core/fs/fs-utils.js";import{isPathWithinDirectory}from"../../core/fs/path-utils.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{isCanonicalPathWithinDirectory,parseExtensionManifestDocument}from"../../core/extensions/loader.js";function normalizeStringList(values){return[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right))}function normalizeExtensionNameForMatch(value){return value.trim().toLowerCase()}function normalizeManagedDirectoryName(name){const normalized=name.trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-");let start=0;while(normalized[start]==="-"){start+=1}let end=normalized.length;while(end>start&&normalized[end-1]==="-"){end-=1}const directoryName=normalized.slice(start,end);if(directoryName.length===0){throw new PmCliError("Extension manifest name must resolve to a non-empty directory name.",EXIT_CODE.USAGE)}if(directoryName==="."||directoryName===".."){throw new PmCliError('Extension manifest name must not resolve to "." or "..".',EXIT_CODE.USAGE)}return directoryName}function parseExtensionManifest(raw){return parseExtensionManifestDocument(raw)}async function readGithubSourcePackageMetadata(sourceRoot){try{const packageJson=JSON.parse(await fs.readFile(path.join(sourceRoot,"package.json"),"utf8"));const packageName=typeof packageJson.name==="string"&&/^(?:@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/iu.test(packageJson.name)?packageJson.name:void 0;return{...packageName?{package_name:packageName}:{},has_build_script:["build","prepare","prepack"].some(key=>typeof packageJson.scripts?.[key]==="string")}}catch{return{has_build_script:false}}}async function missingExtensionEntryError(manifest,entryPath,context){if(context.source_kind!=="github"||typeof context.source_root!=="string"){return new PmCliError(`Extension entry file is missing at "${entryPath}".`,EXIT_CODE.USAGE)}const packageMetadata=await readGithubSourcePackageMetadata(context.source_root);const npmCommand=packageMetadata.package_name?`pm install npm:${packageMetadata.package_name}`:void 0;const source=context.source_input??context.source_root;return new PmCliError(`Extension entry "${manifest.entry}" is absent from GitHub source "${source}". pm install copies GitHub repositories without running package scripts${packageMetadata.has_build_script?", and this package declares a build or publish script":""}. ${npmCommand?`Try "${npmCommand}" if the package is published, or install a locally built directory.`:"Build the source locally and install that directory, or use its published npm: package."}`,EXIT_CODE.USAGE,{code:"github_source_entry_unbuilt",required:"Use a GitHub tree with committed runtime output, a published npm artifact, or a locally built source directory.",why:"GitHub installation is a source copy and never executes untrusted package build scripts.",examples:npmCommand?[npmCommand,`pm install ${context.source_root}`]:[`pm install ${context.source_root}`],nextSteps:npmCommand?[`Retry with ${npmCommand}.`,"Or build the repository locally, then install its directory."]:["Build the repository locally, then install its directory.","If it is published, retry with pm install npm:<package-name>."],recovery:{attempted_command:`pm install ${source}`,normalized_args:["install",source],...npmCommand?{next_best_command:npmCommand}:{}}})}async function validateExtensionDirectory(directory,context={}){const manifestPath=path.join(directory,"manifest.json");if(!await pathExists(manifestPath)){throw new PmCliError(`Extension manifest is missing at "${manifestPath}".`,EXIT_CODE.USAGE)}let parsedManifest;try{parsedManifest=JSON.parse(await fs.readFile(manifestPath,"utf8"))}catch(error){throw new PmCliError(`Failed to parse extension manifest at "${manifestPath}": ${formatManifestReadError(error)}`,EXIT_CODE.USAGE)}const manifest=parseExtensionManifest(parsedManifest);if(!manifest){throw new PmCliError(`Extension manifest at "${manifestPath}" is invalid.`,EXIT_CODE.USAGE)}const entryPath=path.resolve(directory,manifest.entry);if(!isPathWithinDirectory(directory,entryPath)){throw new PmCliError(`Extension entry "${manifest.entry}" resolves outside extension directory "${directory}".`,EXIT_CODE.USAGE)}if(!await pathExists(entryPath)){throw await missingExtensionEntryError(manifest,entryPath,context)}if(!await isCanonicalPathWithinDirectory(directory,entryPath)){throw new PmCliError(`Extension entry "${manifest.entry}" resolves outside extension directory after symlink resolution.`,EXIT_CODE.USAGE)}return{directory,manifest_path:manifestPath,entry_path:entryPath,manifest}}function formatManifestReadError(error){return error instanceof Error?error.message:String(error)}const _testOnlyExtensionShared={formatManifestReadError};export{_testOnlyExtensionShared,isCanonicalPathWithinDirectory,normalizeExtensionNameForMatch,normalizeManagedDirectoryName,normalizeStringList,parseExtensionManifest,validateExtensionDirectory};
 //# sourceMappingURL=shared.js.map

package/dist/sdk/governance/upgrade.d.ts

@@ -62,6 +62,8 @@ export interface UpgradeCliResult {
     target: string;
     /** Value that configures or reports command for this contract. */
     command: string[];
+    /** Package-owned command migrations relevant to this CLI upgrade plan or outcome. */
+    migration_guidance?: string[];
     /** Value that configures or reports before version for this contract. */
     before_version?: string;
     /** Value that configures or reports after version for this contract. */

package/dist/sdk/governance/upgrade.js

@@ -1,3 +1,3 @@
-!(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]="b2b646c0-92fb-5bf6-998f-37d83428335d")}catch(e2){}})();import{execFile}from"node:child_process";import path from"node:path";import{promisify}from"node:util";import{renderPmCommand}from"../command-line.js";import{readManagedExtensionState,runExtension}from"../extension.js";import{resolveExtensionRoots,pathExists,EXIT_CODE,PmCliError,resolvePmRoot,resolvePmCliVersion}from"../runtime-primitives.js";const execFileAsync=promisify(execFile);const DEFAULT_CLI_PACKAGE="@unbrained/pm-cli";const DEFAULT_TAG="latest";const PACKAGE_UPGRADE_RETRY_SCOPE_FLAGS={global:["--global"],project:[]};const _testOnly={defaultCommandRunner,isLocalNpmSpec,normalizeTarget,packageRecordMatchesTarget,resolveCliPackage,resolvePackageInstallSource,resolveRunnablePackageSource,resolveScope,resolveTag,packageCommandFor,summarize};function resolveScope(options){const projectLike=options.project===true||options.local===true||options.scope==="project";const global2=options.global===true||options.scope==="global";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","package","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){const normalizedTarget=typeof target==="string"&&target.trim().length>0?target.trim():void 0;if(options.cliOnly===true&&options.packagesOnly===true){const suggestedRetryArguments=["package","upgrade",...normalizedTarget?[normalizedTarget]:[],"--packages-only","--dry-run",...PACKAGE_UPGRADE_RETRY_SCOPE_FLAGS[resolveScope(options)]];throw new PmCliError('Options "--cli-only" and "--packages-only" are mutually exclusive.',EXIT_CODE.USAGE,{code:"package_upgrade_modes_mutually_exclusive",recovery:{suggested_retry:renderPmCommand(suggestedRetryArguments),suggested_retry_args:suggestedRetryArguments}})}const scope=resolveScope(options);const dryRun=options.dryRun===true;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{_testOnly,runUpgrade};
+!(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]="4bc28901-e70b-5a76-80bb-762ed8227e5f")}catch(e2){}})();import{execFile}from"node:child_process";import path from"node:path";import{promisify}from"node:util";import{renderPmCommand}from"../command-line.js";import{readManagedExtensionState,runExtension}from"../extension.js";import{resolveExtensionRoots,pathExists,EXIT_CODE,PmCliError,resolvePmRoot,resolvePmCliVersion}from"../runtime-primitives.js";const execFileAsync=promisify(execFile);const DEFAULT_CLI_PACKAGE="@unbrained/pm-cli";const DEFAULT_TAG="latest";const PACKAGE_UPGRADE_RETRY_SCOPE_FLAGS={global:["--global"],project:[]};const _testOnly={defaultCommandRunner,isLocalNpmSpec,normalizeTarget,packageRecordMatchesTarget,resolveCliPackage,resolvePackageInstallSource,resolveRunnablePackageSource,resolveScope,resolveTag,packageCommandFor,summarize};function resolveScope(options){const projectLike=options.project===true||options.local===true||options.scope==="project";const global2=options.global===true||options.scope==="global";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)}}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=resolvePmCliVersion(import.meta.url,["../../.."]);const planned={requested:true,status:"planned",package:packageName,target,command,before_version:beforeVersion,...packageName===DEFAULT_CLI_PACKAGE?{migration_guidance:["Calendar scheduling commands are package-owned. If calendar is absent, run pm package install calendar --project; use pm calendar meet, pm calendar event, or pm calendar remind."]}:{},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","package","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){const normalizedTarget=typeof target==="string"&&target.trim().length>0?target.trim():void 0;if(options.cliOnly===true&&options.packagesOnly===true){const suggestedRetryArguments=["package","upgrade",...normalizedTarget?[normalizedTarget]:[],"--packages-only","--dry-run",...PACKAGE_UPGRADE_RETRY_SCOPE_FLAGS[resolveScope(options)]];throw new PmCliError('Options "--cli-only" and "--packages-only" are mutually exclusive.',EXIT_CODE.USAGE,{code:"package_upgrade_modes_mutually_exclusive",recovery:{suggested_retry:renderPmCommand(suggestedRetryArguments),suggested_retry_args:suggestedRetryArguments}})}const scope=resolveScope(options);const dryRun=options.dryRun===true;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{_testOnly,runUpgrade};
 //# sourceMappingURL=upgrade.js.map