@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/sdk/extension/shared.js

@@ -1,148 +1,2 @@
-/**
- * @module sdk/extension/shared
- *
- * Implements extension package-management support for Shared.
- */
-
-!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]="af718efb-d1cf-5adc-9518-c858627e1b54")}catch(e){}}();
-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";
-export { DEFAULT_EXTENSION_PRIORITY, isCanonicalPathWithinDirectory };
-/** Implements normalize string list for the public runtime surface of this module. */
-export function normalizeStringList(values) {
-    return [
-        ...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0)),
-    ].sort((left, right) => left.localeCompare(right));
-}
-/** Implements normalize extension name for match for the public runtime surface of this module. */
-export function normalizeExtensionNameForMatch(value) {
-    return value.trim().toLowerCase();
-}
-/** Implements normalize managed directory name for the public runtime surface of this module. */
-export 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 === "..") {
-        // Manifest-controlled input must resolve to a dedicated child directory, never
-        // the extensions root itself or its parent (path-traversal guard).
-        throw new PmCliError('Extension manifest name must not resolve to "." or "..".', EXIT_CODE.USAGE);
-    }
-    return directoryName;
-}
-/** Implements parse extension manifest for the public runtime surface of this module. */
-export function parseExtensionManifest(raw) {
-    return parseExtensionManifestDocument(raw);
-}
-/** Read advisory package metadata without replacing the primary validation error. */
-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
-            : undefined;
-        return {
-            ...(packageName ? { package_name: packageName } : {}),
-            has_build_script: ["build", "prepare", "prepack"].some((key) => typeof packageJson.scripts?.[key] === "string"),
-        };
-    }
-    catch {
-        return { has_build_script: false };
-    }
-}
-/** Build the source-aware error returned for a missing extension entry. */
-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}`
-        : undefined;
-    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 } : {}),
-        },
-    });
-}
-/** Implements validate extension directory for the public runtime surface of this module. */
-export 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);
-}
-/** Public contract for test only extension shared, shared by SDK and presentation-layer consumers. */
-export const _testOnlyExtensionShared = {
-    formatManifestReadError,
-};
+!(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};
 //# sourceMappingURL=shared.js.map
-//# debugId=af718efb-d1cf-5adc-9518-c858627e1b54

package/dist/sdk/extension/source-resolution.js

@@ -1,66 +1,2 @@
-/**
- * @module sdk/extension/source-resolution
- *
- * Resolves install-source identity without executing package code.
- */
-
-!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]="39bc7f14-2d32-5b58-97ab-647f9f238273")}catch(e){}}();
-import { findInstalledNpmPackageCandidate, parseExtensionInstallSource, } from "./install-sources.js";
-import { resolveBundledExtensionAliasSource, resolveBundledPackageNpmName, } from "./bundled-catalog.js";
-/** Resolve bundled-alias provenance and competing installed npm identity. */
-export async function resolveExtensionInstallSourceIdentity(explicitSourceInput, githubOption, ref) {
-    const bundledAliasSource = typeof githubOption === "string"
-        ? null
-        : await resolveBundledExtensionAliasSource(explicitSourceInput);
-    const bundledAliasName = bundledAliasSource === null
-        ? null
-        : explicitSourceInput.trim().toLowerCase();
-    const bundledPackageName = bundledAliasName === null
-        ? null
-        : await resolveBundledPackageNpmName(bundledAliasName);
-    const installSource = parseExtensionInstallSource(bundledAliasSource ?? explicitSourceInput, { forceGithub: typeof githubOption === "string", ref });
-    const installedNpmCandidate = bundledAliasName === null
-        ? null
-        : await findInstalledNpmPackageCandidate(explicitSourceInput);
-    return {
-        bundledAliasName,
-        bundledPackageName,
-        installSource,
-        sourceResolution: {
-            requested: explicitSourceInput,
-            selected: {
-                kind: bundledAliasName === null ? installSource.kind : "builtin",
-                input: bundledAliasName ?? installSource.input,
-                ...(bundledPackageName === null ? {} : { package: bundledPackageName }),
-            },
-            ambiguous: installedNpmCandidate !== null,
-            precedence: "bundled_alias_before_installed_npm",
-            candidates: [
-                ...(bundledAliasName === null
-                    ? []
-                    : [{
-                            kind: "builtin",
-                            input: bundledAliasName,
-                            ...(bundledPackageName === null
-                                ? {}
-                                : { package: bundledPackageName }),
-                            command: `pm install ${bundledAliasName}`,
-                        }]),
-                ...(installedNpmCandidate === null
-                    ? []
-                    : [{
-                            kind: "npm",
-                            input: `npm:${installedNpmCandidate.package}`,
-                            package: installedNpmCandidate.package,
-                            ...(installedNpmCandidate.version === undefined
-                                ? {}
-                                : { version: installedNpmCandidate.version }),
-                            directory: installedNpmCandidate.directory,
-                            command: `pm install npm:${installedNpmCandidate.package}`,
-                        }]),
-            ],
-        },
-    };
-}
+!(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]="dcdfdabd-8862-502f-8cd1-298c08825985")}catch(e2){}})();import{findInstalledNpmPackageCandidate,parseExtensionInstallSource}from"./install-sources.js";import{resolveBundledExtensionAliasSource,resolveBundledPackageNpmName}from"./bundled-catalog.js";async function resolveExtensionInstallSourceIdentity(explicitSourceInput,githubOption,ref){const bundledAliasSource=typeof githubOption==="string"?null:await resolveBundledExtensionAliasSource(explicitSourceInput);const bundledAliasName=bundledAliasSource===null?null:explicitSourceInput.trim().toLowerCase();const bundledPackageName=bundledAliasName===null?null:await resolveBundledPackageNpmName(bundledAliasName);const installSource=parseExtensionInstallSource(bundledAliasSource??explicitSourceInput,{forceGithub:typeof githubOption==="string",ref});const installedNpmCandidate=bundledAliasName===null?null:await findInstalledNpmPackageCandidate(explicitSourceInput);return{bundledAliasName,bundledPackageName,installSource,sourceResolution:{requested:explicitSourceInput,selected:{kind:bundledAliasName===null?installSource.kind:"builtin",input:bundledAliasName??installSource.input,...bundledPackageName===null?{}:{package:bundledPackageName}},ambiguous:installedNpmCandidate!==null,precedence:"bundled_alias_before_installed_npm",candidates:[...bundledAliasName===null?[]:[{kind:"builtin",input:bundledAliasName,...bundledPackageName===null?{}:{package:bundledPackageName},command:`pm install ${bundledAliasName}`}],...installedNpmCandidate===null?[]:[{kind:"npm",input:`npm:${installedNpmCandidate.package}`,package:installedNpmCandidate.package,...installedNpmCandidate.version===void 0?{}:{version:installedNpmCandidate.version},directory:installedNpmCandidate.directory,command:`pm install npm:${installedNpmCandidate.package}`}]]}}}export{resolveExtensionInstallSourceIdentity};
 //# sourceMappingURL=source-resolution.js.map
-//# debugId=39bc7f14-2d32-5b58-97ab-647f9f238273

package/dist/sdk/extension/update-check.js

@@ -1,68 +1,2 @@
-/**
- * @module sdk/extension/update-check
- *
- * Provides bounded and annotated-tag-aware update checks for managed extensions.
- */
-
-!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]="ccb857a5-045d-57a7-91d2-b761225fe53a")}catch(e){}}();
-import { nowIso } from "../../core/shared/time.js";
-import { runGitCommand } from "./install-sources.js";
-const GITHUB_UPDATE_CHECK_TIMEOUT_MS = 10_000;
-/** Compare ls-remote output with an optional installed revision baseline. */
-const resolveGithubUpdateOutput = (output, installedCommitInput, checkedAt) => {
-    const references = output
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .filter(Boolean)
-        .map((line) => {
-        const [commit, ref = ""] = line.split(/\s+/);
-        return { commit, ref };
-    });
-    const remoteReference = references.find((reference) => reference.ref.endsWith("^{}")) ??
-        references[0];
-    if (!remoteReference) {
-        return {
-            checked_at: checkedAt,
-            available: null,
-            error: "no_remote_reference_found",
-        };
-    }
-    const installedCommit = installedCommitInput?.trim();
-    return installedCommit
-        ? {
-            checked_at: checkedAt,
-            remote_commit: remoteReference.commit,
-            available: remoteReference.commit !== installedCommit,
-        }
-        : {
-            checked_at: checkedAt,
-            remote_commit: remoteReference.commit,
-            available: null,
-            error: "missing_installed_commit",
-        };
-};
-/** Compare one managed GitHub extension against its remote revision. */
-export const checkGithubUpdate = async (source, gitCommandRunner = runGitCommand) => {
-    const checkedAt = nowIso();
-    if (source.kind !== "github" || !source.repository) {
-        return {
-            checked_at: checkedAt,
-            available: null,
-            error: "not_a_github_managed_source",
-        };
-    }
-    try {
-        const ref = [source.ref?.trim(), "HEAD"].find(Boolean);
-        const output = await gitCommandRunner(["ls-remote", source.repository, ref, `${ref}^{}`], undefined, GITHUB_UPDATE_CHECK_TIMEOUT_MS);
-        return resolveGithubUpdateOutput(output, source.commit, checkedAt);
-    }
-    catch (error) {
-        return {
-            checked_at: checkedAt,
-            available: null,
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-};
+!(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]="8507f364-e079-5743-a54b-bb3a68ab66d0")}catch(e2){}})();import{nowIso}from"../../core/shared/time.js";import{runGitCommand}from"./install-sources.js";const GITHUB_UPDATE_CHECK_TIMEOUT_MS=1e4;const resolveGithubUpdateOutput=(output,installedCommitInput,checkedAt)=>{const references=output.split(/\r?\n/).map(line=>line.trim()).filter(Boolean).map(line=>{const[commit,ref=""]=line.split(/\s+/);return{commit,ref}});const remoteReference=references.find(reference=>reference.ref.endsWith("^{}"))??references[0];if(!remoteReference){return{checked_at:checkedAt,available:null,error:"no_remote_reference_found"}}const installedCommit=installedCommitInput?.trim();return installedCommit?{checked_at:checkedAt,remote_commit:remoteReference.commit,available:remoteReference.commit!==installedCommit}:{checked_at:checkedAt,remote_commit:remoteReference.commit,available:null,error:"missing_installed_commit"}};const checkGithubUpdate=async(source,gitCommandRunner=runGitCommand)=>{const checkedAt=nowIso();if(source.kind!=="github"||!source.repository){return{checked_at:checkedAt,available:null,error:"not_a_github_managed_source"}}try{const ref=[source.ref?.trim(),"HEAD"].find(Boolean);const output=await gitCommandRunner(["ls-remote",source.repository,ref,`${ref}^{}`],void 0,GITHUB_UPDATE_CHECK_TIMEOUT_MS);return resolveGithubUpdateOutput(output,source.commit,checkedAt)}catch(error){return{checked_at:checkedAt,available:null,error:error instanceof Error?error.message:String(error)}}};export{checkGithubUpdate};
 //# sourceMappingURL=update-check.js.map
-//# debugId=ccb857a5-045d-57a7-91d2-b761225fe53a

package/dist/sdk/extension-command-context.js

@@ -1,45 +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]="ff13ec2a-64a8-5512-973f-5447be945978")}catch(e){}}();
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { isPmCliExpectedError } from "./errors.js";
-import { getItemAt } from "./history-read.js";
-import { RelationshipEventLog, RelationshipEventStore, } from "./relationship-history.js";
-import { analyzeGraphImpact } from "./relationship-analytics.js";
-import { RelationshipGraph, createRelationshipKindRegistry, } from "./relationships.js";
-import { commitWorkspaceTransaction } from "./workspace-transaction.js";
-/** Build a relationship-kind registry from extension-owned definitions. */
-function buildRelationshipKindRegistry(definitions) {
-    const registry = createRelationshipKindRegistry();
-    for (const definition of definitions)
-        registry.register(definition);
-    return registry;
-}
-/** Bind public SDK services to one tracker and one caller-owned client. */
-export function createExtensionCommandSdk(pmRoot, client) {
-    return {
-        client,
-        isItemNotFoundError: (error) => isPmCliExpectedError(error) && error.exitCode === EXIT_CODE.NOT_FOUND,
-        getItemAt: (id, target) => getItemAt(id, target, { pmRoot }),
-        openRelationshipEventStore: (options) => {
-            return RelationshipEventStore.open({
-                pmRoot,
-                nodes: options.nodes,
-                registry: buildRelationshipKindRegistry(options.definitions),
-                ...(options.relativePath === undefined
-                    ? {}
-                    : { relativePath: options.relativePath }),
-            });
-        },
-        createRelationshipGraph: (options) => new RelationshipGraph(options.nodes, options.edges, buildRelationshipKindRegistry(options.definitions)),
-        analyzeRelationshipImpact: (graph, root, options) => analyzeGraphImpact(graph, root, options),
-        validateRelationshipEvents: (options) => {
-            const log = new RelationshipEventLog(options.nodes, {
-                registry: buildRelationshipKindRegistry(options.definitions),
-            });
-            return options.events.map((event) => log.append({ ...event, expectedVersion: log.version }));
-        },
-        commitWorkspaceTransaction: (options) => commitWorkspaceTransaction({ ...options, pmRoot }),
-    };
-}
+!(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]="3113ad4b-282a-50af-a836-8e9abfde7d7e")}catch(e2){}})();import{EXIT_CODE}from"../core/shared/constants.js";import{isPmCliExpectedError}from"./errors.js";import{getItemAt}from"./history-read.js";import{RelationshipEventLog,RelationshipEventStore}from"./relationship-history.js";import{analyzeGraphImpact}from"./relationship-analytics.js";import{RelationshipGraph,createRelationshipKindRegistry}from"./relationships.js";import{commitWorkspaceTransaction}from"./workspace-transaction.js";function buildRelationshipKindRegistry(definitions){const registry=createRelationshipKindRegistry();for(const definition of definitions)registry.register(definition);return registry}function createExtensionCommandSdk(pmRoot,client){return{client,isItemNotFoundError:error=>isPmCliExpectedError(error)&&error.exitCode===EXIT_CODE.NOT_FOUND,getItemAt:(id,target)=>getItemAt(id,target,{pmRoot}),openRelationshipEventStore:options=>{return RelationshipEventStore.open({pmRoot,nodes:options.nodes,registry:buildRelationshipKindRegistry(options.definitions),...options.relativePath===void 0?{}:{relativePath:options.relativePath}})},createRelationshipGraph:options=>new RelationshipGraph(options.nodes,options.edges,buildRelationshipKindRegistry(options.definitions)),analyzeRelationshipImpact:(graph,root,options)=>analyzeGraphImpact(graph,root,options),validateRelationshipEvents:options=>{const log=new RelationshipEventLog(options.nodes,{registry:buildRelationshipKindRegistry(options.definitions)});return options.events.map(event=>log.append({...event,expectedVersion:log.version}))},commitWorkspaceTransaction:options=>commitWorkspaceTransaction({...options,pmRoot})}}export{createExtensionCommandSdk};
 //# sourceMappingURL=extension-command-context.js.map
-//# debugId=ff13ec2a-64a8-5512-973f-5447be945978

package/dist/sdk/extension-contracts.js

@@ -1,74 +1,2 @@
-/**
- * @module sdk/extension-contracts
- *
- * Publishes the stable extension capability vocabulary without loading the
- * aggregate SDK entrypoint.
- */
-
-!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]="bb16b445-3bd4-520d-becf-c55621bfa186")}catch(e){}}();
-import { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES, KNOWN_EXTENSION_CAPABILITIES, KNOWN_EXTENSION_POLICY_MODES, KNOWN_EXTENSION_POLICY_SURFACES, KNOWN_EXTENSION_SANDBOX_PROFILES, KNOWN_EXTENSION_TRUST_MODES, } from "../core/extensions/loader.js";
-import { LIST_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, } from "./cli-contracts/commander-types.js";
-import { compactFlagAliasContracts, LIST_FILTER_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, } from "./cli-contracts/flag-contracts.js";
-/**
- * Canonical extension capability names accepted by pm.
- *
- * Extension manifests should declare one or more of these values in
- * `capabilities`.
- */
-export const EXTENSION_CAPABILITIES = KNOWN_EXTENSION_CAPABILITIES;
-/** Canonical extension governance policy modes. */
-export const EXTENSION_POLICY_MODES = KNOWN_EXTENSION_POLICY_MODES;
-/** Canonical extension registration surfaces governed by policy. */
-export const EXTENSION_POLICY_SURFACES = KNOWN_EXTENSION_POLICY_SURFACES;
-/** Canonical extension trust modes shared by authoring and runtime consumers. */
-export const EXTENSION_TRUST_MODES = KNOWN_EXTENSION_TRUST_MODES;
-/** Canonical extension sandbox profiles shared by authoring and runtime consumers. */
-export const EXTENSION_SANDBOX_PROFILES = KNOWN_EXTENSION_SANDBOX_PROFILES;
-/** Build one canonical or alias flag definition from a shared CLI contract. */
-function toExtensionFlagDefinition(contract, long, stringOptionKeys, short) {
-    const normalizedKey = contract.flag
-        .slice(2)
-        .replace(/[-_]([a-z])/gu, (_match, letter) => letter.toUpperCase());
-    const stringValued = stringOptionKeys.has(normalizedKey);
-    return {
-        long,
-        ...(short ? { short } : {}),
-        description: contract.description ?? `Standard pm ${contract.flag} option.`,
-        ...(contract.required === true ? { required: true } : {}),
-        ...(contract.list === true ? { list: true } : {}),
-        ...(contract.repeatable === true ? { repeatable: true } : {}),
-        value_type: stringValued ? "string" : "boolean",
-        ...(stringValued
-            ? { value_name: contract.value_name ?? "value" }
-            : {}),
-    };
-}
-/**
- * Convert canonical CLI flag contracts into extension command definitions.
- *
- * Alias rows are expanded because extension registration deliberately stores
- * one long spelling per definition. String-valued options come from the same
- * Commander option contracts the CLI parser consumes; every other contract is
- * boolean. This keeps aliases, list accumulation, requiredness, and value
- * behavior single-sourced while giving package authors the exact shape
- * accepted by `api.registerCommand` and `api.registerFlags`.
- */
-export function toExtensionFlagDefinitions(contracts, stringOptions = []) {
-    const stringOptionKeys = new Set(stringOptions.flatMap((contract) => contract.keys));
-    const definitions = [];
-    for (const contract of compactFlagAliasContracts(contracts.map((entry) => ({ ...entry })))) {
-        definitions.push(toExtensionFlagDefinition(contract, contract.flag, stringOptionKeys, contract.short));
-        for (const alias of contract.aliases ?? []) {
-            definitions.push(toExtensionFlagDefinition(contract, alias, stringOptionKeys));
-        }
-    }
-    return definitions;
-}
-/** Extension-ready form of the canonical list/filter flag baseline. */
-export const LIST_FILTER_EXTENSION_FLAG_DEFINITIONS = toExtensionFlagDefinitions(LIST_FILTER_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS);
-/** Extension-ready form of the canonical search flag baseline. */
-export const SEARCH_EXTENSION_FLAG_DEFINITIONS = toExtensionFlagDefinitions(SEARCH_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS);
-/** Versioned capability contract metadata emitted by runtime diagnostics. */
-export { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES, };
+!(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]="cde4f476-6821-53be-b70e-62794fa2ae52")}catch(e2){}})();import{EXTENSION_CAPABILITY_CONTRACT,EXTENSION_CAPABILITY_CONTRACT_VERSION,EXTENSION_CAPABILITY_LEGACY_ALIASES,KNOWN_EXTENSION_CAPABILITIES,KNOWN_EXTENSION_POLICY_MODES,KNOWN_EXTENSION_POLICY_SURFACES,KNOWN_EXTENSION_SANDBOX_PROFILES,KNOWN_EXTENSION_TRUST_MODES}from"../core/extensions/loader.js";import{LIST_COMMANDER_STRING_OPTION_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS}from"./cli-contracts/commander-types.js";import{compactFlagAliasContracts,LIST_FILTER_FLAG_CONTRACTS,SEARCH_FLAG_CONTRACTS}from"./cli-contracts/flag-contracts.js";const EXTENSION_CAPABILITIES=KNOWN_EXTENSION_CAPABILITIES;const EXTENSION_POLICY_MODES=KNOWN_EXTENSION_POLICY_MODES;const EXTENSION_POLICY_SURFACES=KNOWN_EXTENSION_POLICY_SURFACES;const EXTENSION_TRUST_MODES=KNOWN_EXTENSION_TRUST_MODES;const EXTENSION_SANDBOX_PROFILES=KNOWN_EXTENSION_SANDBOX_PROFILES;function toExtensionFlagDefinition(contract,long,stringOptionKeys,short){const normalizedKey=contract.flag.slice(2).replace(/[-_]([a-z])/gu,(_match,letter)=>letter.toUpperCase());const stringValued=stringOptionKeys.has(normalizedKey);return{long,...short?{short}:{},description:contract.description??`Standard pm ${contract.flag} option.`,...contract.required===true?{required:true}:{},...contract.list===true?{list:true}:{},...contract.repeatable===true?{repeatable:true}:{},value_type:stringValued?"string":"boolean",...stringValued?{value_name:contract.value_name??"value"}:{}}}function toExtensionFlagDefinitions(contracts,stringOptions=[]){const stringOptionKeys=new Set(stringOptions.flatMap(contract=>contract.keys));const definitions=[];for(const contract of compactFlagAliasContracts(contracts.map(entry=>({...entry})))){definitions.push(toExtensionFlagDefinition(contract,contract.flag,stringOptionKeys,contract.short));for(const alias of contract.aliases??[]){definitions.push(toExtensionFlagDefinition(contract,alias,stringOptionKeys))}}return definitions}const LIST_FILTER_EXTENSION_FLAG_DEFINITIONS=toExtensionFlagDefinitions(LIST_FILTER_FLAG_CONTRACTS,LIST_COMMANDER_STRING_OPTION_CONTRACTS);const SEARCH_EXTENSION_FLAG_DEFINITIONS=toExtensionFlagDefinitions(SEARCH_FLAG_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS);export{EXTENSION_CAPABILITIES,EXTENSION_CAPABILITY_CONTRACT,EXTENSION_CAPABILITY_CONTRACT_VERSION,EXTENSION_CAPABILITY_LEGACY_ALIASES,EXTENSION_POLICY_MODES,EXTENSION_POLICY_SURFACES,EXTENSION_SANDBOX_PROFILES,EXTENSION_TRUST_MODES,LIST_FILTER_EXTENSION_FLAG_DEFINITIONS,SEARCH_EXTENSION_FLAG_DEFINITIONS,toExtensionFlagDefinitions};
 //# sourceMappingURL=extension-contracts.js.map
-//# debugId=bb16b445-3bd4-520d-becf-c55621bfa186

package/dist/sdk/extension.d.ts

@@ -12,6 +12,7 @@ import { readManagedExtensionState, writeManagedExtensionState, resolveManagedEx
 import { parseExtensionInstallSource } from "./extension/install-sources.js";
 import { copyExtensionDirectoryForInstall, resolveCanonicalExtensionInstallDestination } from "./extension/install-runtime.js";
 import { collectGlobalOutputOverrideDoctorWarnings } from "./extension/output-ownership.js";
+import { type ExtensionInstallPlan, type ExtensionCopyPlanOptions } from "./extension/install-plan.js";
 export { parseExtensionManifest, validateExtensionDirectory, readManagedExtensionState, writeManagedExtensionState, resolveManagedExtensionStatePath, parseExtensionInstallSource, copyExtensionDirectoryForInstall, resolveCanonicalExtensionInstallDestination, };
 export type { ManagedExtensionSource, ManagedExtensionRecord, ManagedExtensionState, };
 export type { ManagedExtensionStateReadResult } from "./extension/managed-state.js";
@@ -95,8 +96,10 @@ export interface ExtensionCommandOptions {
     declarative?: boolean;
     /** Value that configures or reports vocabulary for this contract. */
     vocabulary?: "extension" | "package";
-    /** Plan migration work without invoking extension code. */
+    /** Plan migrations or resolve install sources and estimate copying without destination writes or activation. */
     dryRun?: boolean;
+    /** SDK limits and cancellation for install copy-cost enumeration. */
+    copyPlan?: ExtensionCopyPlanOptions;
 }
 /** Documents the managed extension summary payload exchanged by command, SDK, and package integrations. */
 export interface ManagedExtensionSummary {
@@ -159,7 +162,9 @@ export interface ExtensionCommandResult {
     /** Value that configures or reports warnings for this contract. */
     warnings: string[];
     /** Value that configures or reports details for this contract. */
-    details: Record<string, unknown>;
+    details: Record<string, unknown> & {
+        install_plan?: ExtensionInstallPlan;
+    };
 }
 /** Documents the extension triage summary payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionTriageSummary {