@unbrained/pm-cli 2026.5.24 → 2026.5.28

package/dist/cli/commands/extension/install-sources.js

@@ -0,0 +1,384 @@
+
+!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]="23a34bde-7fd3-5371-adc9-648198007ad7")}catch(e){}}();
+import { execFile } from "node:child_process";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { promisify } from "node:util";
+import { collectPackageExtensionDirectories } from "../../../core/packages/manifest.js";
+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";
+const execFileAsync = promisify(execFile);
+function parseGithubPathSpec(pathSpec, input, refOverride) {
+    const segments = pathSpec
+        .split("/")
+        .map((segment) => segment.trim())
+        .filter((segment) => segment.length > 0);
+    if (segments.length < 2) {
+        return null;
+    }
+    const owner = segments[0];
+    const repo = segments[1].replace(/\.git$/i, "");
+    if (owner.length === 0 || repo.length === 0) {
+        return null;
+    }
+    const tail = segments.slice(2);
+    let ref;
+    let subpath;
+    if (tail[0] === "tree" && tail.length >= 2) {
+        ref = tail[1];
+        subpath = tail.slice(2).join("/");
+    }
+    else if (tail.length > 0) {
+        subpath = tail.join("/");
+    }
+    if (typeof refOverride === "string" && refOverride.trim().length > 0) {
+        ref = refOverride.trim();
+    }
+    return {
+        kind: "github",
+        input,
+        owner,
+        repo,
+        repository: `https://github.com/${owner}/${repo}.git`,
+        ref,
+        subpath: subpath && subpath.length > 0 ? subpath : undefined,
+    };
+}
+export function parseExtensionInstallSource(input, options = {}) {
+    const normalizedInput = input.trim();
+    if (normalizedInput.length === 0) {
+        throw new PmCliError("Extension source is required for --install.", EXIT_CODE.USAGE);
+    }
+    const refOverride = typeof options.ref === "string" && options.ref.trim().length > 0 ? options.ref.trim() : undefined;
+    if (normalizedInput.startsWith("npm:")) {
+        const spec = normalizedInput.slice("npm:".length).trim();
+        if (spec.length === 0) {
+            throw new PmCliError('npm package source must include a package spec after "npm:".', EXIT_CODE.USAGE);
+        }
+        if (options.forceGithub) {
+            throw new PmCliError('Options "--gh/--github" cannot be combined with npm: package sources.', EXIT_CODE.USAGE);
+        }
+        if (refOverride) {
+            throw new PmCliError('Option "--ref" cannot be combined with npm: package sources.', EXIT_CODE.USAGE);
+        }
+        return {
+            kind: "npm",
+            input: normalizedInput,
+            spec,
+        };
+    }
+    const maybeGithubByUrl = (() => {
+        try {
+            const parsed = new URL(normalizedInput);
+            if (parsed.hostname !== "github.com") {
+                return null;
+            }
+            const pathSpec = parsed.pathname.replace(/^\/+/, "");
+            return parseGithubPathSpec(pathSpec, normalizedInput, refOverride);
+        }
+        catch {
+            return null;
+        }
+    })();
+    if (maybeGithubByUrl) {
+        return maybeGithubByUrl;
+    }
+    const strippedDomainInput = normalizedInput.startsWith("github.com/") ? normalizedInput.slice("github.com/".length) : null;
+    if (strippedDomainInput) {
+        const parsed = parseGithubPathSpec(strippedDomainInput, normalizedInput, refOverride);
+        if (!parsed) {
+            throw new PmCliError(`Invalid GitHub source "${normalizedInput}".`, EXIT_CODE.USAGE);
+        }
+        return parsed;
+    }
+    if (options.forceGithub) {
+        const parsed = parseGithubPathSpec(normalizedInput, normalizedInput, refOverride);
+        if (!parsed) {
+            throw new PmCliError(`Invalid GitHub shorthand "${normalizedInput}".`, EXIT_CODE.USAGE);
+        }
+        return parsed;
+    }
+    if (/^https?:\/\//i.test(normalizedInput)) {
+        throw new PmCliError(`Unsupported extension source URL "${normalizedInput}". Supported remote source host: github.com.`, EXIT_CODE.USAGE);
+    }
+    return {
+        kind: "local",
+        input: normalizedInput,
+        absolute_path: path.resolve(process.cwd(), normalizedInput),
+    };
+}
+export async function runGitCommand(args) {
+    try {
+        const result = await execFileAsync("git", args, { encoding: "utf8" });
+        return (result.stdout ?? "").trim();
+    }
+    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(`Git command failed: git ${args.join(" ")}\n${message}`, EXIT_CODE.GENERIC_FAILURE);
+    }
+}
+async function runNpmCommand(args, cwd) {
+    try {
+        const result = await execFileAsync("npm", args, { cwd, encoding: "utf8" });
+        return (result.stdout ?? "").trim();
+    }
+    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(`npm command failed: npm ${args.join(" ")}\n${message}`, EXIT_CODE.GENERIC_FAILURE);
+    }
+}
+async function resolveLocalNpmPackagePath(spec) {
+    if (path.isAbsolute(spec) || spec.startsWith(".") || spec.startsWith("..")) {
+        const absolutePath = path.resolve(process.cwd(), spec);
+        return (await pathExists(absolutePath)) ? absolutePath : null;
+    }
+    try {
+        const parsed = new URL(spec);
+        if (parsed.protocol === "file:") {
+            const absolutePath = fileURLToPath(parsed);
+            return (await pathExists(absolutePath)) ? absolutePath : null;
+        }
+    }
+    catch {
+        // Registry package specs are not URLs.
+    }
+    if (!/^[a-z][a-z0-9+.-]*:/i.test(spec)) {
+        const absolutePath = path.resolve(process.cwd(), spec);
+        if (await pathExists(absolutePath)) {
+            return absolutePath;
+        }
+    }
+    return null;
+}
+async function resolveNpmPackSpec(spec) {
+    const localPath = await resolveLocalNpmPackagePath(spec);
+    if (localPath) {
+        return pathToFileURL(localPath).href;
+    }
+    if (/^[a-z][a-z0-9+.-]*:/i.test(spec)) {
+        return spec;
+    }
+    return spec;
+}
+function parsePackedNpmPackage(stdout, packDirectory) {
+    try {
+        const parsed = JSON.parse(stdout);
+        const first = Array.isArray(parsed) ? parsed[0] : undefined;
+        if (first && typeof first.filename === "string" && first.filename.trim().length > 0) {
+            return {
+                tarball: path.resolve(packDirectory, first.filename),
+                package: typeof first.name === "string" ? first.name : undefined,
+                version: typeof first.version === "string" ? first.version : undefined,
+            };
+        }
+    }
+    catch {
+        // Fall back to the last stdout line for older npm output.
+    }
+    const lastLine = stdout
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .at(-1);
+    if (!lastLine) {
+        throw new PmCliError("npm pack did not report a tarball filename.", EXIT_CODE.GENERIC_FAILURE);
+    }
+    return {
+        tarball: path.resolve(packDirectory, lastLine),
+    };
+}
+async function resolveNpmSourceDirectory(source) {
+    const localPackageRoot = await resolveLocalNpmPackagePath(source.spec);
+    if (localPackageRoot) {
+        const packageJsonPath = path.join(localPackageRoot, "package.json");
+        const packageJson = (await pathExists(packageJsonPath))
+            ? JSON.parse(await fs.readFile(packageJsonPath, "utf8"))
+            : {};
+        return {
+            directory: await resolvePackageExtensionDirectory(localPackageRoot, source.input),
+            package: typeof packageJson.name === "string" ? packageJson.name : undefined,
+            version: typeof packageJson.version === "string" ? packageJson.version : undefined,
+            cleanup: async () => { },
+        };
+    }
+    const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), "pm-npm-package-source-"));
+    const packDirectory = path.join(tempRoot, "pack");
+    const extractDirectory = path.join(tempRoot, "extract");
+    await fs.mkdir(packDirectory, { recursive: true });
+    await fs.mkdir(extractDirectory, { recursive: true });
+    try {
+        const packSpec = await resolveNpmPackSpec(source.spec);
+        const packStdout = await runNpmCommand(["pack", packSpec, "--json", "--pack-destination", packDirectory]);
+        const packed = parsePackedNpmPackage(packStdout, packDirectory);
+        await execFileAsync("tar", ["-xzf", packed.tarball, "-C", extractDirectory], { encoding: "utf8" });
+        const packageRoot = path.join(extractDirectory, "package");
+        await installNpmPackageRuntimeDependencies(packageRoot);
+        const directory = await resolvePackageExtensionDirectory(packageRoot, source.input);
+        return {
+            directory,
+            package: packed.package,
+            version: packed.version,
+            cleanup: async () => {
+                await fs.rm(tempRoot, { recursive: true, force: true });
+            },
+        };
+    }
+    catch (error) {
+        await fs.rm(tempRoot, { recursive: true, force: true });
+        throw error;
+    }
+}
+async function installNpmPackageRuntimeDependencies(packageRoot) {
+    const packageJsonPath = path.join(packageRoot, "package.json");
+    if (!(await pathExists(packageJsonPath))) {
+        return;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+    }
+    catch {
+        return;
+    }
+    if (typeof parsed !== "object" || parsed === null) {
+        return;
+    }
+    const manifest = parsed;
+    const dependencySpecs = runtimeDependencyInstallSpecs(manifest);
+    if (dependencySpecs.length === 0) {
+        return;
+    }
+    const runtimeOnlyManifest = { ...parsed };
+    delete runtimeOnlyManifest.devDependencies;
+    await fs.writeFile(packageJsonPath, `${JSON.stringify(runtimeOnlyManifest, null, 2)}\n`, "utf8");
+    await Promise.all([
+        fs.rm(path.join(packageRoot, "package-lock.json"), { force: true }),
+        fs.rm(path.join(packageRoot, "npm-shrinkwrap.json"), { force: true }),
+    ]);
+    await runNpmCommand(["install", "--ignore-scripts", "--no-audit", "--fund=false", "--package-lock=false", "--no-save", ...dependencySpecs], packageRoot);
+}
+function runtimeDependencyInstallSpecs(manifest) {
+    const specs = new Map();
+    for (const dependencyMap of [manifest.dependencies, manifest.optionalDependencies, manifest.peerDependencies]) {
+        if (typeof dependencyMap !== "object" || dependencyMap === null) {
+            continue;
+        }
+        for (const [name, version] of Object.entries(dependencyMap)) {
+            if (typeof version !== "string" || version.trim().length === 0 || specs.has(name)) {
+                continue;
+            }
+            specs.set(name, `${name}@${version.trim()}`);
+        }
+    }
+    return [...specs.values()];
+}
+async function resolvePackageExtensionDirectory(packageRoot, sourceLabel) {
+    const discovered = await collectPackageExtensionDirectories(packageRoot);
+    if (discovered.length === 1) {
+        return discovered[0];
+    }
+    if (discovered.length > 1) {
+        const choices = discovered
+            .map((entry) => path.relative(packageRoot, entry).replaceAll(path.sep, "/"))
+            .sort((left, right) => left.localeCompare(right));
+        throw new PmCliError(`Package source "${sourceLabel}" contains multiple extension manifests. Provide an explicit extension path. Candidates: ${choices.join(", ")}`, EXIT_CODE.USAGE);
+    }
+    throw new PmCliError(`Unable to locate a pm extension manifest in package source "${sourceLabel}". Package installs currently activate only extension resources, so add package.json pm.extensions or an extensions/ directory. Metadata-only resources like pm.docs/pm.examples are catalog metadata and do not activate commands.`, EXIT_CODE.USAGE);
+}
+async function resolveGithubSourceDirectory(cloneDirectory, source) {
+    const candidatePaths = [];
+    if (source.subpath) {
+        candidatePaths.push(source.subpath);
+        candidatePaths.push(path.posix.join(".agents/pm/extensions", source.subpath));
+        candidatePaths.push(path.posix.join(".custom/pm-extensions", source.subpath));
+        candidatePaths.push(path.posix.join(".custom/pm-extension", source.subpath));
+    }
+    for (const candidate of candidatePaths) {
+        const absolute = path.resolve(cloneDirectory, candidate);
+        if (!isPathWithinDirectory(cloneDirectory, absolute)) {
+            // source.subpath is user-controlled; never resolve a manifest outside the
+            // cloned repository (path-traversal guard).
+            continue;
+        }
+        if (await pathExists(path.join(absolute, "manifest.json"))) {
+            return { directory: absolute, resolved_subpath: candidate };
+        }
+    }
+    if (await pathExists(path.join(cloneDirectory, "manifest.json"))) {
+        return { directory: cloneDirectory, resolved_subpath: "." };
+    }
+    const discoveredDirectory = await resolvePackageExtensionDirectory(cloneDirectory, source.input);
+    return {
+        directory: discoveredDirectory,
+        resolved_subpath: path.relative(cloneDirectory, discoveredDirectory).replaceAll(path.sep, "/"),
+    };
+}
+export async function resolveInstallSource(source) {
+    if (source.kind === "local") {
+        let localStats;
+        try {
+            localStats = await fs.stat(source.absolute_path);
+        }
+        catch {
+            throw new PmCliError(`Local extension source does not exist: "${source.absolute_path}".`, EXIT_CODE.NOT_FOUND);
+        }
+        if (!localStats.isDirectory()) {
+            throw new PmCliError(`Local extension source must be a directory: "${source.absolute_path}".`, EXIT_CODE.USAGE);
+        }
+        const directory = await resolvePackageExtensionDirectory(source.absolute_path, source.input);
+        return {
+            source,
+            directory,
+        };
+    }
+    if (source.kind === "npm") {
+        const resolved = await resolveNpmSourceDirectory(source);
+        return {
+            source,
+            directory: resolved.directory,
+            cleanup: resolved.cleanup,
+            resolved_subpath: path.relative(path.dirname(resolved.directory), resolved.directory).replaceAll(path.sep, "/"),
+            npm_package: resolved.package,
+            npm_version: resolved.version,
+        };
+    }
+    const cloneDirectory = await fs.mkdtemp(path.join(os.tmpdir(), "pm-extension-source-"));
+    const cloneArgs = ["clone", "--depth", "1"];
+    if (source.ref) {
+        cloneArgs.push("--branch", source.ref);
+    }
+    cloneArgs.push(source.repository, cloneDirectory);
+    try {
+        await runGitCommand(cloneArgs);
+        const commit = await runGitCommand(["-C", cloneDirectory, "rev-parse", "HEAD"]);
+        const resolved = await resolveGithubSourceDirectory(cloneDirectory, source);
+        return {
+            source,
+            directory: resolved.directory,
+            resolved_subpath: resolved.resolved_subpath,
+            commit,
+            cleanup: async () => {
+                await fs.rm(cloneDirectory, { recursive: true, force: true });
+            },
+        };
+    }
+    catch (error) {
+        await fs.rm(cloneDirectory, { recursive: true, force: true });
+        throw error;
+    }
+}
+export async function areDirectoriesEquivalent(left, right) {
+    if (!(await pathExists(left)) || !(await pathExists(right))) {
+        return false;
+    }
+    const [leftRealPath, rightRealPath] = await Promise.all([fs.realpath(left), fs.realpath(right)]);
+    return leftRealPath === rightRealPath;
+}
+//# sourceMappingURL=install-sources.js.map
+//# debugId=23a34bde-7fd3-5371-adc9-648198007ad7

package/dist/cli/commands/extension/install-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-sources.js","sources":["cli/commands/extension/install-sources.ts"],"sourceRoot":"/","sourcesContent":["import { execFile } from \"node:child_process\";\nimport fs from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { promisify } from \"node:util\";\nimport { collectPackageExtensionDirectories } from \"../../../core/packages/manifest.js\";\nimport { pathExists } from \"../../../core/fs/fs-utils.js\";\nimport { isPathWithinDirectory } from \"../../../core/fs/path-utils.js\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\n\nconst execFileAsync = promisify(execFile);\n\ninterface LocalInstallSource {\n  kind: \"local\";\n  input: string;\n  absolute_path: string;\n}\n\ninterface GithubInstallSource {\n  kind: \"github\";\n  input: string;\n  owner: string;\n  repo: string;\n  repository: string;\n  ref?: string;\n  subpath?: string;\n}\n\ninterface NpmInstallSource {\n  kind: \"npm\";\n  input: string;\n  spec: string;\n}\n\ntype InstallSource = LocalInstallSource | GithubInstallSource | NpmInstallSource;\n\ninterface ResolvedInstallSource {\n  source: InstallSource;\n  directory: string;\n  resolved_subpath?: string;\n  commit?: string;\n  npm_package?: string;\n  npm_version?: string;\n  cleanup?: () => Promise<void>;\n}\n\nfunction parseGithubPathSpec(pathSpec: string, input: string, refOverride?: string): GithubInstallSource | null {\n  const segments = pathSpec\n    .split(\"/\")\n    .map((segment) => segment.trim())\n    .filter((segment) => segment.length > 0);\n  if (segments.length < 2) {\n    return null;\n  }\n  const owner = segments[0];\n  const repo = segments[1].replace(/\\.git$/i, \"\");\n  if (owner.length === 0 || repo.length === 0) {\n    return null;\n  }\n  const tail = segments.slice(2);\n  let ref: string | undefined;\n  let subpath: string | undefined;\n  if (tail[0] === \"tree\" && tail.length >= 2) {\n    ref = tail[1];\n    subpath = tail.slice(2).join(\"/\");\n  } else if (tail.length > 0) {\n    subpath = tail.join(\"/\");\n  }\n  if (typeof refOverride === \"string\" && refOverride.trim().length > 0) {\n    ref = refOverride.trim();\n  }\n  return {\n    kind: \"github\",\n    input,\n    owner,\n    repo,\n    repository: `https://github.com/${owner}/${repo}.git`,\n    ref,\n    subpath: subpath && subpath.length > 0 ? subpath : undefined,\n  };\n}\n\nexport function parseExtensionInstallSource(input: string, options: { forceGithub?: boolean; ref?: string } = {}): InstallSource {\n  const normalizedInput = input.trim();\n  if (normalizedInput.length === 0) {\n    throw new PmCliError(\"Extension source is required for --install.\", EXIT_CODE.USAGE);\n  }\n  const refOverride = typeof options.ref === \"string\" && options.ref.trim().length > 0 ? options.ref.trim() : undefined;\n\n  if (normalizedInput.startsWith(\"npm:\")) {\n    const spec = normalizedInput.slice(\"npm:\".length).trim();\n    if (spec.length === 0) {\n      throw new PmCliError('npm package source must include a package spec after \"npm:\".', EXIT_CODE.USAGE);\n    }\n    if (options.forceGithub) {\n      throw new PmCliError('Options \"--gh/--github\" cannot be combined with npm: package sources.', EXIT_CODE.USAGE);\n    }\n    if (refOverride) {\n      throw new PmCliError('Option \"--ref\" cannot be combined with npm: package sources.', EXIT_CODE.USAGE);\n    }\n    return {\n      kind: \"npm\",\n      input: normalizedInput,\n      spec,\n    };\n  }\n\n  const maybeGithubByUrl = (() => {\n    try {\n      const parsed = new URL(normalizedInput);\n      if (parsed.hostname !== \"github.com\") {\n        return null;\n      }\n      const pathSpec = parsed.pathname.replace(/^\\/+/, \"\");\n      return parseGithubPathSpec(pathSpec, normalizedInput, refOverride);\n    } catch {\n      return null;\n    }\n  })();\n  if (maybeGithubByUrl) {\n    return maybeGithubByUrl;\n  }\n\n  const strippedDomainInput = normalizedInput.startsWith(\"github.com/\") ? normalizedInput.slice(\"github.com/\".length) : null;\n  if (strippedDomainInput) {\n    const parsed = parseGithubPathSpec(strippedDomainInput, normalizedInput, refOverride);\n    if (!parsed) {\n      throw new PmCliError(`Invalid GitHub source \"${normalizedInput}\".`, EXIT_CODE.USAGE);\n    }\n    return parsed;\n  }\n\n  if (options.forceGithub) {\n    const parsed = parseGithubPathSpec(normalizedInput, normalizedInput, refOverride);\n    if (!parsed) {\n      throw new PmCliError(`Invalid GitHub shorthand \"${normalizedInput}\".`, EXIT_CODE.USAGE);\n    }\n    return parsed;\n  }\n\n  if (/^https?:\\/\\//i.test(normalizedInput)) {\n    throw new PmCliError(\n      `Unsupported extension source URL \"${normalizedInput}\". Supported remote source host: github.com.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  return {\n    kind: \"local\",\n    input: normalizedInput,\n    absolute_path: path.resolve(process.cwd(), normalizedInput),\n  };\n}\n\nexport async function runGitCommand(args: string[]): Promise<string> {\n  try {\n    const result = await execFileAsync(\"git\", args, { encoding: \"utf8\" });\n    return (result.stdout ?? \"\").trim();\n  } catch (error: unknown) {\n    const stderr = typeof error === \"object\" && error !== null && \"stderr\" in error ? String((error as { stderr: unknown }).stderr) : \"\";\n    const message = stderr.trim().length > 0 ? stderr.trim() : error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`Git command failed: git ${args.join(\" \")}\\n${message}`, EXIT_CODE.GENERIC_FAILURE);\n  }\n}\n\nasync function runNpmCommand(args: string[], cwd?: string): Promise<string> {\n  try {\n    const result = await execFileAsync(\"npm\", args, { cwd, encoding: \"utf8\" });\n    return (result.stdout ?? \"\").trim();\n  } catch (error: unknown) {\n    const stderr = typeof error === \"object\" && error !== null && \"stderr\" in error ? String((error as { stderr: unknown }).stderr) : \"\";\n    const message = stderr.trim().length > 0 ? stderr.trim() : error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`npm command failed: npm ${args.join(\" \")}\\n${message}`, EXIT_CODE.GENERIC_FAILURE);\n  }\n}\n\nasync function resolveLocalNpmPackagePath(spec: string): Promise<string | null> {\n  if (path.isAbsolute(spec) || spec.startsWith(\".\") || spec.startsWith(\"..\")) {\n    const absolutePath = path.resolve(process.cwd(), spec);\n    return (await pathExists(absolutePath)) ? absolutePath : null;\n  }\n\n  try {\n    const parsed = new URL(spec);\n    if (parsed.protocol === \"file:\") {\n      const absolutePath = fileURLToPath(parsed);\n      return (await pathExists(absolutePath)) ? absolutePath : null;\n    }\n  } catch {\n    // Registry package specs are not URLs.\n  }\n\n  if (!/^[a-z][a-z0-9+.-]*:/i.test(spec)) {\n    const absolutePath = path.resolve(process.cwd(), spec);\n    if (await pathExists(absolutePath)) {\n      return absolutePath;\n    }\n  }\n\n  return null;\n}\n\nasync function resolveNpmPackSpec(spec: string): Promise<string> {\n  const localPath = await resolveLocalNpmPackagePath(spec);\n  if (localPath) {\n    return pathToFileURL(localPath).href;\n  }\n\n  if (/^[a-z][a-z0-9+.-]*:/i.test(spec)) {\n    return spec;\n  }\n\n  return spec;\n}\n\nfunction parsePackedNpmPackage(stdout: string, packDirectory: string): { tarball: string; package?: string; version?: string } {\n  try {\n    const parsed = JSON.parse(stdout) as Array<{ filename?: unknown; name?: unknown; version?: unknown }>;\n    const first = Array.isArray(parsed) ? parsed[0] : undefined;\n    if (first && typeof first.filename === \"string\" && first.filename.trim().length > 0) {\n      return {\n        tarball: path.resolve(packDirectory, first.filename),\n        package: typeof first.name === \"string\" ? first.name : undefined,\n        version: typeof first.version === \"string\" ? first.version : undefined,\n      };\n    }\n  } catch {\n    // Fall back to the last stdout line for older npm output.\n  }\n  const lastLine = stdout\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0)\n    .at(-1);\n  if (!lastLine) {\n    throw new PmCliError(\"npm pack did not report a tarball filename.\", EXIT_CODE.GENERIC_FAILURE);\n  }\n  return {\n    tarball: path.resolve(packDirectory, lastLine),\n  };\n}\n\nasync function resolveNpmSourceDirectory(source: NpmInstallSource): Promise<{\n  directory: string;\n  package?: string;\n  version?: string;\n  cleanup: () => Promise<void>;\n}> {\n  const localPackageRoot = await resolveLocalNpmPackagePath(source.spec);\n  if (localPackageRoot) {\n    const packageJsonPath = path.join(localPackageRoot, \"package.json\");\n    const packageJson = (await pathExists(packageJsonPath))\n      ? JSON.parse(await fs.readFile(packageJsonPath, \"utf8\")) as { name?: unknown; version?: unknown }\n      : {};\n    return {\n      directory: await resolvePackageExtensionDirectory(localPackageRoot, source.input),\n      package: typeof packageJson.name === \"string\" ? packageJson.name : undefined,\n      version: typeof packageJson.version === \"string\" ? packageJson.version : undefined,\n      cleanup: async () => {},\n    };\n  }\n\n  const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), \"pm-npm-package-source-\"));\n  const packDirectory = path.join(tempRoot, \"pack\");\n  const extractDirectory = path.join(tempRoot, \"extract\");\n  await fs.mkdir(packDirectory, { recursive: true });\n  await fs.mkdir(extractDirectory, { recursive: true });\n\n  try {\n    const packSpec = await resolveNpmPackSpec(source.spec);\n    const packStdout = await runNpmCommand([\"pack\", packSpec, \"--json\", \"--pack-destination\", packDirectory]);\n    const packed = parsePackedNpmPackage(packStdout, packDirectory);\n    await execFileAsync(\"tar\", [\"-xzf\", packed.tarball, \"-C\", extractDirectory], { encoding: \"utf8\" });\n    const packageRoot = path.join(extractDirectory, \"package\");\n    await installNpmPackageRuntimeDependencies(packageRoot);\n    const directory = await resolvePackageExtensionDirectory(packageRoot, source.input);\n    return {\n      directory,\n      package: packed.package,\n      version: packed.version,\n      cleanup: async () => {\n        await fs.rm(tempRoot, { recursive: true, force: true });\n      },\n    };\n  } catch (error: unknown) {\n    await fs.rm(tempRoot, { recursive: true, force: true });\n    throw error;\n  }\n}\n\nasync function installNpmPackageRuntimeDependencies(packageRoot: string): Promise<void> {\n  const packageJsonPath = path.join(packageRoot, \"package.json\");\n  if (!(await pathExists(packageJsonPath))) {\n    return;\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(await fs.readFile(packageJsonPath, \"utf8\")) as unknown;\n  } catch {\n    return;\n  }\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return;\n  }\n\n  const manifest = parsed as { dependencies?: unknown; optionalDependencies?: unknown; peerDependencies?: unknown };\n  const dependencySpecs = runtimeDependencyInstallSpecs(manifest);\n  if (dependencySpecs.length === 0) {\n    return;\n  }\n\n  const runtimeOnlyManifest = { ...(parsed as Record<string, unknown>) };\n  delete runtimeOnlyManifest.devDependencies;\n  await fs.writeFile(packageJsonPath, `${JSON.stringify(runtimeOnlyManifest, null, 2)}\\n`, \"utf8\");\n  await Promise.all([\n    fs.rm(path.join(packageRoot, \"package-lock.json\"), { force: true }),\n    fs.rm(path.join(packageRoot, \"npm-shrinkwrap.json\"), { force: true }),\n  ]);\n\n  await runNpmCommand(\n    [\"install\", \"--ignore-scripts\", \"--no-audit\", \"--fund=false\", \"--package-lock=false\", \"--no-save\", ...dependencySpecs],\n    packageRoot,\n  );\n}\n\nfunction runtimeDependencyInstallSpecs(manifest: {\n  dependencies?: unknown;\n  optionalDependencies?: unknown;\n  peerDependencies?: unknown;\n}): string[] {\n  const specs = new Map<string, string>();\n  for (const dependencyMap of [manifest.dependencies, manifest.optionalDependencies, manifest.peerDependencies]) {\n    if (typeof dependencyMap !== \"object\" || dependencyMap === null) {\n      continue;\n    }\n    for (const [name, version] of Object.entries(dependencyMap)) {\n      if (typeof version !== \"string\" || version.trim().length === 0 || specs.has(name)) {\n        continue;\n      }\n      specs.set(name, `${name}@${version.trim()}`);\n    }\n  }\n  return [...specs.values()];\n}\n\nasync function resolvePackageExtensionDirectory(packageRoot: string, sourceLabel: string): Promise<string> {\n  const discovered = await collectPackageExtensionDirectories(packageRoot);\n  if (discovered.length === 1) {\n    return discovered[0];\n  }\n  if (discovered.length > 1) {\n    const choices = discovered\n      .map((entry) => path.relative(packageRoot, entry).replaceAll(path.sep, \"/\"))\n      .sort((left, right) => left.localeCompare(right));\n    throw new PmCliError(\n      `Package source \"${sourceLabel}\" contains multiple extension manifests. Provide an explicit extension path. Candidates: ${choices.join(\", \")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  throw new PmCliError(\n    `Unable to locate a pm extension manifest in package source \"${sourceLabel}\". Package installs currently activate only extension resources, so add package.json pm.extensions or an extensions/ directory. Metadata-only resources like pm.docs/pm.examples are catalog metadata and do not activate commands.`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nasync function resolveGithubSourceDirectory(cloneDirectory: string, source: GithubInstallSource): Promise<{ directory: string; resolved_subpath?: string }> {\n  const candidatePaths: string[] = [];\n  if (source.subpath) {\n    candidatePaths.push(source.subpath);\n    candidatePaths.push(path.posix.join(\".agents/pm/extensions\", source.subpath));\n    candidatePaths.push(path.posix.join(\".custom/pm-extensions\", source.subpath));\n    candidatePaths.push(path.posix.join(\".custom/pm-extension\", source.subpath));\n  }\n\n  for (const candidate of candidatePaths) {\n    const absolute = path.resolve(cloneDirectory, candidate);\n    if (!isPathWithinDirectory(cloneDirectory, absolute)) {\n      // source.subpath is user-controlled; never resolve a manifest outside the\n      // cloned repository (path-traversal guard).\n      continue;\n    }\n    if (await pathExists(path.join(absolute, \"manifest.json\"))) {\n      return { directory: absolute, resolved_subpath: candidate };\n    }\n  }\n\n  if (await pathExists(path.join(cloneDirectory, \"manifest.json\"))) {\n    return { directory: cloneDirectory, resolved_subpath: \".\" };\n  }\n\n  const discoveredDirectory = await resolvePackageExtensionDirectory(cloneDirectory, source.input);\n  return {\n    directory: discoveredDirectory,\n    resolved_subpath: path.relative(cloneDirectory, discoveredDirectory).replaceAll(path.sep, \"/\"),\n  };\n}\n\nexport async function resolveInstallSource(source: InstallSource): Promise<ResolvedInstallSource> {\n  if (source.kind === \"local\") {\n    let localStats;\n    try {\n      localStats = await fs.stat(source.absolute_path);\n    } catch {\n      throw new PmCliError(`Local extension source does not exist: \"${source.absolute_path}\".`, EXIT_CODE.NOT_FOUND);\n    }\n    if (!localStats.isDirectory()) {\n      throw new PmCliError(`Local extension source must be a directory: \"${source.absolute_path}\".`, EXIT_CODE.USAGE);\n    }\n    const directory = await resolvePackageExtensionDirectory(source.absolute_path, source.input);\n    return {\n      source,\n      directory,\n    };\n  }\n\n  if (source.kind === \"npm\") {\n    const resolved = await resolveNpmSourceDirectory(source);\n    return {\n      source,\n      directory: resolved.directory,\n      cleanup: resolved.cleanup,\n      resolved_subpath: path.relative(path.dirname(resolved.directory), resolved.directory).replaceAll(path.sep, \"/\"),\n      npm_package: resolved.package,\n      npm_version: resolved.version,\n    };\n  }\n\n  const cloneDirectory = await fs.mkdtemp(path.join(os.tmpdir(), \"pm-extension-source-\"));\n  const cloneArgs = [\"clone\", \"--depth\", \"1\"];\n  if (source.ref) {\n    cloneArgs.push(\"--branch\", source.ref);\n  }\n  cloneArgs.push(source.repository, cloneDirectory);\n\n  try {\n    await runGitCommand(cloneArgs);\n    const commit = await runGitCommand([\"-C\", cloneDirectory, \"rev-parse\", \"HEAD\"]);\n    const resolved = await resolveGithubSourceDirectory(cloneDirectory, source);\n    return {\n      source,\n      directory: resolved.directory,\n      resolved_subpath: resolved.resolved_subpath,\n      commit,\n      cleanup: async () => {\n        await fs.rm(cloneDirectory, { recursive: true, force: true });\n      },\n    };\n  } catch (error: unknown) {\n    await fs.rm(cloneDirectory, { recursive: true, force: true });\n    throw error;\n  }\n}\n\nexport async function areDirectoriesEquivalent(left: string, right: string): Promise<boolean> {\n  if (!(await pathExists(left)) || !(await pathExists(right))) {\n    return false;\n  }\n  const [leftRealPath, rightRealPath] = await Promise.all([fs.realpath(left), fs.realpath(right)]);\n  return leftRealPath === rightRealPath;\n}\n"],"names":[],"mappings":"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","debugId":"23a34bde-7fd3-5371-adc9-648198007ad7"}

package/dist/cli/commands/extension/managed-state.d.ts

@@ -0,0 +1,48 @@
+import type { ExtensionScope } from "../extension.js";
+export interface ManagedExtensionSource {
+    kind: "local" | "github" | "npm" | "builtin";
+    input: string;
+    location: string;
+    name?: string;
+    package?: string;
+    version?: string;
+    repository?: string;
+    owner?: string;
+    repo?: string;
+    ref?: string;
+    subpath?: string;
+    commit?: string;
+}
+export interface ManagedExtensionRecord {
+    name: string;
+    directory: string;
+    scope: ExtensionScope;
+    manifest_version: string;
+    manifest_entry: string;
+    capabilities: string[];
+    installed_at: string;
+    updated_at: string;
+    source: ManagedExtensionSource;
+    last_update_check_at?: string;
+    last_update_remote_commit?: string;
+    update_available?: boolean | null;
+    update_error?: string;
+}
+export interface ManagedExtensionState {
+    version: number;
+    updated_at: string;
+    entries: ManagedExtensionRecord[];
+}
+export interface ManagedExtensionStateReadResult {
+    path: string;
+    state: ManagedExtensionState;
+    warnings: string[];
+}
+export declare function resolveManagedExtensionStatePath(extensionsRoot: string): string;
+export declare function createEmptyManagedExtensionState(): ManagedExtensionState;
+export declare function sortManagedEntries(entries: ManagedExtensionRecord[]): ManagedExtensionRecord[];
+export declare function managedExtensionSourcesEquivalent(left: ManagedExtensionSource, right: ManagedExtensionSource): boolean;
+export declare function normalizeManagedState(raw: unknown): ManagedExtensionState | null;
+export declare function readManagedExtensionState(extensionsRoot: string): Promise<ManagedExtensionStateReadResult>;
+export declare function writeManagedExtensionState(extensionsRoot: string, state: ManagedExtensionState): Promise<void>;
+export declare function upsertManagedEntry(state: ManagedExtensionState, entry: ManagedExtensionRecord): ManagedExtensionState;