@pixelzx/genesis 2026.5.9-1 → 2026.5.9-2

package/dist/update-YjxOXm5D.js

@@ -1,1282 +0,0 @@
-import { i as formatErrorMessage } from "./errors-Jbvi20TW.js";
-import { c as normalizeOptionalString } from "./string-coerce-C1IzJjqi.js";
-import { a as resolveOsHomeRelativePath } from "./home-dir-CqG-85AQ.js";
-import { m as resolveUserPath } from "./utils-DaGfogP-.js";
-import { t as sanitizeForLog } from "./ansi-BZHMLcUk.js";
-import { r as runCommandWithTimeout } from "./exec-CKo0c2Rj.js";
-import { s as isPathInside } from "./boundary-path-C2iMx2xR.js";
-import { o as redactSensitiveUrlLikeString } from "./redact-sensitive-url-BH3nxS-g.js";
-import { n as fetchWithSsrFGuard } from "./fetch-guard-DKzLBD09.js";
-import { a as resolvePluginInstallDir, i as installPluginFromPath, r as installPluginFromNpmSpec, t as PLUGIN_INSTALL_ERROR_CODE } from "./install-BPmIu7Fr.js";
-import { l as resolveArchiveKind } from "./archive-CWXI-IfV.js";
-import { i as resolveBundledPluginSources } from "./bundled-sources-DnKq2Nl5.js";
-import { i as resolveNpmSpecMetadata } from "./install-source-utils-CdIVe4L_.js";
-import { r as installPluginFromClawHub } from "./clawhub-B8vQZp2O.js";
-import { n as recordPluginInstall, t as buildNpmResolutionInstallFields } from "./installs-CuGfn2rc.js";
-import { n as readInstalledPackageVersion, t as expectedIntegrityForUpdate } from "./package-update-utils-DE_n1gKX.js";
-import path from "node:path";
-import os from "node:os";
-import fs from "node:fs/promises";
-//#region src/plugins/marketplace.ts
-const DEFAULT_GIT_TIMEOUT_MS = 12e4;
-const DEFAULT_MARKETPLACE_DOWNLOAD_TIMEOUT_MS = 12e4;
-const MAX_MARKETPLACE_ARCHIVE_BYTES = 256 * 1024 * 1024;
-const MARKETPLACE_MANIFEST_CANDIDATES = [path.join(".claude-plugin", "marketplace.json"), "marketplace.json"];
-const CLAUDE_KNOWN_MARKETPLACES_PATH = path.join("~", ".claude", "plugins", "known_marketplaces.json");
-function isHttpUrl(value) {
-	return /^https?:\/\//i.test(value);
-}
-function isGitUrl(value) {
-	return /^git@/i.test(value) || /^ssh:\/\//i.test(value) || /^https?:\/\/.+\.git(?:#.*)?$/i.test(value);
-}
-function looksLikeGitHubRepoShorthand(value) {
-	return /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+(?:#.+)?$/.test(value.trim());
-}
-function splitRef(value) {
-	const trimmed = value.trim();
-	const hashIndex = trimmed.lastIndexOf("#");
-	if (hashIndex <= 0 || hashIndex >= trimmed.length - 1) return { base: trimmed };
-	return {
-		base: trimmed.slice(0, hashIndex),
-		ref: normalizeOptionalString(trimmed.slice(hashIndex + 1))
-	};
-}
-function toOptionalString(value) {
-	if (typeof value !== "string") return;
-	const trimmed = value.trim();
-	return trimmed.length > 0 ? trimmed : void 0;
-}
-function normalizeEntrySource(raw) {
-	if (typeof raw === "string") {
-		const trimmed = raw.trim();
-		if (!trimmed) return {
-			ok: false,
-			error: "empty plugin source"
-		};
-		if (isHttpUrl(trimmed)) return {
-			ok: true,
-			source: {
-				kind: "url",
-				url: trimmed
-			}
-		};
-		return {
-			ok: true,
-			source: {
-				kind: "path",
-				path: trimmed
-			}
-		};
-	}
-	if (!raw || typeof raw !== "object") return {
-		ok: false,
-		error: "plugin source must be a string or object"
-	};
-	const rec = raw;
-	const kind = toOptionalString(rec.type) ?? toOptionalString(rec.source);
-	if (!kind) return {
-		ok: false,
-		error: "plugin source object missing \"type\" or \"source\""
-	};
-	if (kind === "path") {
-		const sourcePath = toOptionalString(rec.path);
-		if (!sourcePath) return {
-			ok: false,
-			error: "path source missing \"path\""
-		};
-		return {
-			ok: true,
-			source: {
-				kind: "path",
-				path: sourcePath
-			}
-		};
-	}
-	if (kind === "github") {
-		const repo = toOptionalString(rec.repo) ?? toOptionalString(rec.url);
-		if (!repo) return {
-			ok: false,
-			error: "github source missing \"repo\""
-		};
-		return {
-			ok: true,
-			source: {
-				kind: "github",
-				repo,
-				path: toOptionalString(rec.path),
-				ref: toOptionalString(rec.ref) ?? toOptionalString(rec.branch) ?? toOptionalString(rec.tag)
-			}
-		};
-	}
-	if (kind === "git") {
-		const url = toOptionalString(rec.url) ?? toOptionalString(rec.repo);
-		if (!url) return {
-			ok: false,
-			error: "git source missing \"url\""
-		};
-		return {
-			ok: true,
-			source: {
-				kind: "git",
-				url,
-				path: toOptionalString(rec.path),
-				ref: toOptionalString(rec.ref) ?? toOptionalString(rec.branch) ?? toOptionalString(rec.tag)
-			}
-		};
-	}
-	if (kind === "git-subdir") {
-		const url = toOptionalString(rec.url) ?? toOptionalString(rec.repo);
-		const sourcePath = toOptionalString(rec.path) ?? toOptionalString(rec.subdir);
-		if (!url) return {
-			ok: false,
-			error: "git-subdir source missing \"url\""
-		};
-		if (!sourcePath) return {
-			ok: false,
-			error: "git-subdir source missing \"path\""
-		};
-		return {
-			ok: true,
-			source: {
-				kind: "git-subdir",
-				url,
-				path: sourcePath,
-				ref: toOptionalString(rec.ref) ?? toOptionalString(rec.branch) ?? toOptionalString(rec.tag)
-			}
-		};
-	}
-	if (kind === "url") {
-		const url = toOptionalString(rec.url);
-		if (!url) return {
-			ok: false,
-			error: "url source missing \"url\""
-		};
-		return {
-			ok: true,
-			source: {
-				kind: "url",
-				url
-			}
-		};
-	}
-	return {
-		ok: false,
-		error: `unsupported plugin source kind: ${kind}`
-	};
-}
-function marketplaceEntrySourceToInput(source) {
-	switch (source.kind) {
-		case "path": return source.path;
-		case "github": return `${source.repo}${source.ref ? `#${source.ref}` : ""}`;
-		case "git": return `${source.url}${source.ref ? `#${source.ref}` : ""}`;
-		case "git-subdir": return `${source.url}${source.ref ? `#${source.ref}` : ""}`;
-		case "url": return source.url;
-	}
-	throw new Error("Unsupported marketplace entry source");
-}
-function parseMarketplaceManifest(raw, sourceLabel) {
-	let parsed;
-	try {
-		parsed = JSON.parse(raw);
-	} catch (err) {
-		return {
-			ok: false,
-			error: `invalid marketplace JSON at ${sourceLabel}: ${String(err)}`
-		};
-	}
-	if (!parsed || typeof parsed !== "object") return {
-		ok: false,
-		error: `invalid marketplace JSON at ${sourceLabel}: expected object`
-	};
-	const rec = parsed;
-	if (!Array.isArray(rec.plugins)) return {
-		ok: false,
-		error: `invalid marketplace JSON at ${sourceLabel}: missing plugins[]`
-	};
-	const plugins = [];
-	for (const entry of rec.plugins) {
-		if (!entry || typeof entry !== "object") return {
-			ok: false,
-			error: `invalid marketplace entry in ${sourceLabel}: expected object`
-		};
-		const plugin = entry;
-		const name = toOptionalString(plugin.name);
-		if (!name) return {
-			ok: false,
-			error: `invalid marketplace entry in ${sourceLabel}: missing name`
-		};
-		const normalizedSource = normalizeEntrySource(plugin.source);
-		if (!normalizedSource.ok) return {
-			ok: false,
-			error: `invalid marketplace entry "${name}" in ${sourceLabel}: ${normalizedSource.error}`
-		};
-		plugins.push({
-			name,
-			version: toOptionalString(plugin.version),
-			description: toOptionalString(plugin.description),
-			source: normalizedSource.source
-		});
-	}
-	return {
-		ok: true,
-		manifest: {
-			name: toOptionalString(rec.name),
-			version: toOptionalString(rec.version),
-			plugins
-		}
-	};
-}
-async function pathExists(target) {
-	try {
-		await fs.access(target);
-		return true;
-	} catch {
-		return false;
-	}
-}
-async function readClaudeKnownMarketplaces() {
-	const knownPath = resolveOsHomeRelativePath(CLAUDE_KNOWN_MARKETPLACES_PATH);
-	if (!await pathExists(knownPath)) return {};
-	let parsed;
-	try {
-		parsed = JSON.parse(await fs.readFile(knownPath, "utf-8"));
-	} catch {
-		return {};
-	}
-	if (!parsed || typeof parsed !== "object") return {};
-	const entries = parsed;
-	const result = {};
-	for (const [name, value] of Object.entries(entries)) {
-		if (!value || typeof value !== "object") continue;
-		const record = value;
-		result[name] = {
-			installLocation: toOptionalString(record.installLocation),
-			source: record.source
-		};
-	}
-	return result;
-}
-function deriveMarketplaceRootFromManifestPath(manifestPath) {
-	const manifestDir = path.dirname(manifestPath);
-	return path.basename(manifestDir) === ".claude-plugin" ? path.dirname(manifestDir) : manifestDir;
-}
-async function resolveLocalMarketplaceSource(input) {
-	const resolved = resolveUserPath(input);
-	if (!await pathExists(resolved)) return null;
-	const stat = await fs.stat(resolved);
-	if (stat.isFile()) return {
-		ok: true,
-		rootDir: deriveMarketplaceRootFromManifestPath(resolved),
-		manifestPath: resolved
-	};
-	if (!stat.isDirectory()) return {
-		ok: false,
-		error: `unsupported marketplace source: ${resolved}`
-	};
-	const rootDir = path.basename(resolved) === ".claude-plugin" ? path.dirname(resolved) : resolved;
-	for (const candidate of MARKETPLACE_MANIFEST_CANDIDATES) {
-		const manifestPath = path.join(rootDir, candidate);
-		if (await pathExists(manifestPath)) return {
-			ok: true,
-			rootDir,
-			manifestPath
-		};
-	}
-	return {
-		ok: false,
-		error: `marketplace manifest not found under ${resolved}`
-	};
-}
-function normalizeGitCloneSource(source) {
-	const split = splitRef(source);
-	if (looksLikeGitHubRepoShorthand(split.base)) return {
-		url: `https://github.com/${split.base}.git`,
-		ref: split.ref,
-		label: split.base
-	};
-	if (isGitUrl(source)) return {
-		url: split.base,
-		ref: split.ref,
-		label: split.base
-	};
-	if (isHttpUrl(source)) try {
-		const url = new URL(split.base);
-		if (url.hostname !== "github.com") return null;
-		const parts = url.pathname.replace(/\/+$/, "").split("/").filter(Boolean);
-		if (parts.length < 2) return null;
-		const repo = `${parts[0]}/${parts[1]?.replace(/\.git$/i, "")}`;
-		return {
-			url: `https://github.com/${repo}.git`,
-			ref: split.ref,
-			label: repo
-		};
-	} catch {
-		return null;
-	}
-	return null;
-}
-async function cloneMarketplaceRepo(params) {
-	const normalized = normalizeGitCloneSource(params.source);
-	if (!normalized) return {
-		ok: false,
-		error: `unsupported marketplace source: ${params.source}`
-	};
-	const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "genesis-marketplace-"));
-	const repoDir = path.join(tmpDir, "repo");
-	const argv = [
-		"git",
-		"clone",
-		"--depth",
-		"1"
-	];
-	if (normalized.ref) argv.push("--branch", normalized.ref);
-	argv.push(normalized.url, repoDir);
-	params.logger?.info?.(`Cloning marketplace source ${normalized.label}...`);
-	const res = await runCommandWithTimeout(argv, { timeoutMs: params.timeoutMs ?? DEFAULT_GIT_TIMEOUT_MS });
-	if (res.code !== 0) {
-		await fs.rm(tmpDir, {
-			recursive: true,
-			force: true
-		}).catch(() => void 0);
-		const detail = res.stderr.trim() || res.stdout.trim() || "git clone failed";
-		return {
-			ok: false,
-			error: `failed to clone marketplace source ${normalized.label}: ${detail}`
-		};
-	}
-	return {
-		ok: true,
-		rootDir: repoDir,
-		label: normalized.label,
-		cleanup: async () => {
-			await fs.rm(tmpDir, {
-				recursive: true,
-				force: true
-			}).catch(() => void 0);
-		}
-	};
-}
-async function loadMarketplace(params) {
-	const loadMarketplaceFromManifestFile = async (params) => {
-		const parsed = parseMarketplaceManifest(await fs.readFile(params.manifestPath, "utf-8"), params.manifestPath);
-		if (!parsed.ok) {
-			await params.cleanup?.();
-			return parsed;
-		}
-		const validated = await validateMarketplaceManifest({
-			manifest: parsed.manifest,
-			sourceLabel: params.sourceLabel,
-			rootDir: params.rootDir,
-			origin: params.origin
-		});
-		if (!validated.ok) {
-			await params.cleanup?.();
-			return validated;
-		}
-		return {
-			ok: true,
-			marketplace: {
-				manifest: validated.manifest,
-				rootDir: params.rootDir,
-				sourceLabel: params.sourceLabel,
-				origin: params.origin,
-				cleanup: params.cleanup
-			}
-		};
-	};
-	const loadResolvedLocalMarketplace = async (local, sourceLabel) => loadMarketplaceFromManifestFile({
-		manifestPath: local.manifestPath,
-		sourceLabel,
-		rootDir: local.rootDir,
-		origin: "local"
-	});
-	const resolveClonedMarketplaceManifestPath = async (rootDir) => {
-		for (const candidate of MARKETPLACE_MANIFEST_CANDIDATES) {
-			const next = path.join(rootDir, candidate);
-			if (await pathExists(next)) return next;
-		}
-	};
-	const known = (await readClaudeKnownMarketplaces())[params.source];
-	if (known) {
-		if (known.installLocation) {
-			const local = await resolveLocalMarketplaceSource(known.installLocation);
-			if (local?.ok) return await loadResolvedLocalMarketplace(local, params.source);
-		}
-		const normalizedSource = normalizeEntrySource(known.source);
-		if (normalizedSource.ok) return await loadMarketplace({
-			source: marketplaceEntrySourceToInput(normalizedSource.source),
-			logger: params.logger,
-			timeoutMs: params.timeoutMs
-		});
-	}
-	const local = await resolveLocalMarketplaceSource(params.source);
-	if (local?.ok === false) return local;
-	if (local?.ok) return await loadResolvedLocalMarketplace(local, local.manifestPath);
-	const cloned = await cloneMarketplaceRepo({
-		source: params.source,
-		timeoutMs: params.timeoutMs,
-		logger: params.logger
-	});
-	if (!cloned.ok) return cloned;
-	const manifestPath = await resolveClonedMarketplaceManifestPath(cloned.rootDir);
-	if (!manifestPath) {
-		await cloned.cleanup();
-		return {
-			ok: false,
-			error: `marketplace manifest not found in ${cloned.label}`
-		};
-	}
-	return await loadMarketplaceFromManifestFile({
-		manifestPath,
-		sourceLabel: cloned.label,
-		rootDir: cloned.rootDir,
-		origin: "remote",
-		cleanup: cloned.cleanup
-	});
-}
-function resolveSafeMarketplaceDownloadFileName(url, fallback) {
-	const pathname = new URL(url).pathname;
-	const fileName = path.basename(pathname).trim() || fallback;
-	if (fileName === "." || fileName === ".." || /^[a-zA-Z]:/.test(fileName) || path.isAbsolute(fileName) || fileName.includes("/") || fileName.includes("\\")) throw new Error("invalid download filename");
-	return fileName;
-}
-function resolveMarketplaceDownloadTimeoutMs(timeoutMs) {
-	return Math.max(1e3, Math.floor(typeof timeoutMs === "number" && Number.isFinite(timeoutMs) ? timeoutMs : DEFAULT_MARKETPLACE_DOWNLOAD_TIMEOUT_MS));
-}
-function formatMarketplaceDownloadError(url, detail) {
-	return `failed to download ${sanitizeForLog(redactSensitiveUrlLikeString(url))}: ` + sanitizeForLog(detail);
-}
-function hasStreamingResponseBody(response) {
-	return Boolean(response.body && typeof response.body.getReader === "function");
-}
-async function readMarketplaceChunkWithTimeout(reader, chunkTimeoutMs) {
-	let timeoutId;
-	let timedOut = false;
-	return await new Promise((resolve, reject) => {
-		const clear = () => {
-			if (timeoutId !== void 0) {
-				clearTimeout(timeoutId);
-				timeoutId = void 0;
-			}
-		};
-		timeoutId = setTimeout(() => {
-			timedOut = true;
-			clear();
-			reader.cancel().catch(() => void 0);
-			reject(/* @__PURE__ */ new Error(`download timed out after ${chunkTimeoutMs}ms`));
-		}, chunkTimeoutMs);
-		reader.read().then((result) => {
-			clear();
-			if (!timedOut) resolve(result);
-		}, (err) => {
-			clear();
-			if (!timedOut) reject(err);
-		});
-	});
-}
-async function writeMarketplaceChunk(fileHandle, chunk) {
-	let offset = 0;
-	while (offset < chunk.length) {
-		const { bytesWritten } = await fileHandle.write(chunk, offset, chunk.length - offset);
-		if (bytesWritten <= 0) throw new Error("failed to write download chunk");
-		offset += bytesWritten;
-	}
-}
-async function streamMarketplaceResponseToFile(params) {
-	const reader = params.response.body.getReader();
-	const fileHandle = await fs.open(params.targetPath, "wx");
-	let total = 0;
-	try {
-		while (true) {
-			const { done, value } = await readMarketplaceChunkWithTimeout(reader, params.chunkTimeoutMs);
-			if (done) return;
-			if (!value?.length) continue;
-			const nextTotal = total + value.length;
-			if (nextTotal > params.maxBytes) throw new Error(`download too large: ${nextTotal} bytes (limit: ${params.maxBytes} bytes)`);
-			await writeMarketplaceChunk(fileHandle, value);
-			total = nextTotal;
-		}
-	} finally {
-		await fileHandle.close().catch(() => void 0);
-		try {
-			reader.releaseLock();
-		} catch {}
-	}
-}
-async function downloadUrlToTempFile(url, timeoutMs) {
-	let sourceFileName = "plugin.tgz";
-	let tmpDir;
-	try {
-		sourceFileName = resolveSafeMarketplaceDownloadFileName(url, sourceFileName);
-		const downloadTimeoutMs = resolveMarketplaceDownloadTimeoutMs(timeoutMs);
-		const { response, finalUrl, release } = await fetchWithSsrFGuard({
-			url,
-			timeoutMs: downloadTimeoutMs,
-			auditContext: "marketplace-plugin-download"
-		});
-		try {
-			if (!response.ok) return {
-				ok: false,
-				error: formatMarketplaceDownloadError(url, `HTTP ${response.status}`)
-			};
-			if (!response.body) return {
-				ok: false,
-				error: formatMarketplaceDownloadError(url, "empty response body")
-			};
-			if (!hasStreamingResponseBody(response)) return {
-				ok: false,
-				error: formatMarketplaceDownloadError(url, "streaming response body unavailable")
-			};
-			const contentLength = response.headers.get("content-length");
-			if (contentLength) {
-				const size = Number(contentLength);
-				if (Number.isFinite(size) && size > MAX_MARKETPLACE_ARCHIVE_BYTES) throw new Error(`download too large: ${size} bytes (limit: ${MAX_MARKETPLACE_ARCHIVE_BYTES} bytes)`);
-			}
-			const finalFileName = resolveSafeMarketplaceDownloadFileName(finalUrl, sourceFileName);
-			const fileName = resolveArchiveKind(finalFileName) ? finalFileName : sourceFileName;
-			tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "genesis-marketplace-download-"));
-			const createdTmpDir = tmpDir;
-			const targetPath = path.resolve(createdTmpDir, fileName);
-			const relativeTargetPath = path.relative(createdTmpDir, targetPath);
-			if (relativeTargetPath === ".." || relativeTargetPath.startsWith(`..${path.sep}`)) throw new Error("invalid download filename");
-			await streamMarketplaceResponseToFile({
-				response,
-				targetPath,
-				maxBytes: MAX_MARKETPLACE_ARCHIVE_BYTES,
-				chunkTimeoutMs: downloadTimeoutMs
-			});
-			return {
-				ok: true,
-				path: targetPath,
-				cleanup: async () => {
-					await fs.rm(createdTmpDir, {
-						recursive: true,
-						force: true
-					}).catch(() => void 0);
-				}
-			};
-		} finally {
-			await release().catch(() => void 0);
-		}
-	} catch (error) {
-		if (tmpDir) await fs.rm(tmpDir, {
-			recursive: true,
-			force: true
-		}).catch(() => void 0);
-		return {
-			ok: false,
-			error: formatMarketplaceDownloadError(url, formatErrorMessage(error))
-		};
-	}
-}
-async function ensureInsideMarketplaceRoot(rootDir, candidate, options) {
-	const resolved = path.resolve(rootDir, candidate);
-	const resolvedExists = await pathExists(resolved);
-	const relative = path.relative(rootDir, resolved);
-	if (relative === ".." || relative.startsWith(`..${path.sep}`)) return {
-		ok: false,
-		error: `plugin source escapes marketplace root: ${candidate}`
-	};
-	if (options?.canonicalRootDir) try {
-		if (!(await fs.lstat(options.canonicalRootDir)).isDirectory()) throw new Error("invalid marketplace root");
-		const rootRealPath = await fs.realpath(options.canonicalRootDir);
-		let existingPath = resolved;
-		while (!await pathExists(existingPath)) {
-			const parentPath = path.dirname(existingPath);
-			if (parentPath === existingPath) throw new Error("unreachable marketplace path");
-			existingPath = parentPath;
-		}
-		if (!isPathInside(rootRealPath, await fs.realpath(existingPath))) throw new Error("marketplace path escapes canonical root");
-	} catch (error) {
-		if (error instanceof Error && (error.message === "invalid marketplace root" || error.message === "unreachable marketplace path" || error.message === "marketplace path escapes canonical root")) return {
-			ok: false,
-			error: `plugin source escapes marketplace root: ${candidate}`
-		};
-		throw error;
-	}
-	if (!resolvedExists) return {
-		ok: false,
-		error: `plugin source not found in marketplace root: ${candidate}`
-	};
-	return {
-		ok: true,
-		path: resolved
-	};
-}
-async function validateMarketplaceManifest(params) {
-	if (params.origin === "local") return {
-		ok: true,
-		manifest: params.manifest
-	};
-	const canonicalRootDir = await fs.realpath(params.rootDir);
-	for (const plugin of params.manifest.plugins) {
-		const source = plugin.source;
-		if (source.kind === "path") {
-			if (isHttpUrl(source.path)) return {
-				ok: false,
-				error: `invalid marketplace entry "${plugin.name}" in ${params.sourceLabel}: remote marketplaces may not use HTTP(S) plugin paths`
-			};
-			if (path.isAbsolute(source.path)) return {
-				ok: false,
-				error: `invalid marketplace entry "${plugin.name}" in ${params.sourceLabel}: remote marketplaces may only use relative plugin paths`
-			};
-			const resolved = await ensureInsideMarketplaceRoot(params.rootDir, source.path, { canonicalRootDir });
-			if (!resolved.ok) return {
-				ok: false,
-				error: `invalid marketplace entry "${plugin.name}" in ${params.sourceLabel}: ${resolved.error}`
-			};
-			continue;
-		}
-		return {
-			ok: false,
-			error: `invalid marketplace entry "${plugin.name}" in ${params.sourceLabel}: remote marketplaces may not use ${source.kind} plugin sources`
-		};
-	}
-	return {
-		ok: true,
-		manifest: params.manifest
-	};
-}
-async function resolveMarketplaceEntryInstallPath(params) {
-	if (params.source.kind === "path") {
-		if (isHttpUrl(params.source.path)) {
-			if (resolveArchiveKind(params.source.path)) return await downloadUrlToTempFile(params.source.path, params.timeoutMs);
-			return {
-				ok: false,
-				error: `unsupported remote plugin path source: ${params.source.path}`
-			};
-		}
-		const canonicalRootDir = params.marketplaceOrigin === "remote" ? await fs.realpath(params.marketplaceRootDir) : void 0;
-		const resolved = path.isAbsolute(params.source.path) ? {
-			ok: true,
-			path: params.source.path
-		} : await ensureInsideMarketplaceRoot(params.marketplaceRootDir, params.source.path, { canonicalRootDir });
-		if (!resolved.ok) return resolved;
-		return {
-			ok: true,
-			path: resolved.path
-		};
-	}
-	if (params.source.kind === "github" || params.source.kind === "git" || params.source.kind === "git-subdir") {
-		const cloned = await cloneMarketplaceRepo({
-			source: params.source.kind === "github" ? `${params.source.repo}${params.source.ref ? `#${params.source.ref}` : ""}` : `${params.source.url}${params.source.ref ? `#${params.source.ref}` : ""}`,
-			timeoutMs: params.timeoutMs,
-			logger: params.logger
-		});
-		if (!cloned.ok) return cloned;
-		const subPath = params.source.kind === "github" || params.source.kind === "git" ? normalizeOptionalString(params.source.path) || "." : params.source.path.trim();
-		const canonicalRootDir = await fs.realpath(cloned.rootDir);
-		const target = await ensureInsideMarketplaceRoot(cloned.rootDir, subPath, { canonicalRootDir });
-		if (!target.ok) {
-			await cloned.cleanup();
-			return target;
-		}
-		return {
-			ok: true,
-			path: target.path,
-			cleanup: cloned.cleanup
-		};
-	}
-	if (resolveArchiveKind(params.source.url)) return await downloadUrlToTempFile(params.source.url, params.timeoutMs);
-	if (!normalizeGitCloneSource(params.source.url)) return {
-		ok: false,
-		error: `unsupported URL plugin source: ${params.source.url}`
-	};
-	const cloned = await cloneMarketplaceRepo({
-		source: params.source.url,
-		timeoutMs: params.timeoutMs,
-		logger: params.logger
-	});
-	if (!cloned.ok) return cloned;
-	return {
-		ok: true,
-		path: cloned.rootDir,
-		cleanup: cloned.cleanup
-	};
-}
-async function listMarketplacePlugins(params) {
-	const loaded = await loadMarketplace({
-		source: params.marketplace,
-		logger: params.logger,
-		timeoutMs: params.timeoutMs
-	});
-	if (!loaded.ok) return loaded;
-	try {
-		return {
-			ok: true,
-			manifest: loaded.marketplace.manifest,
-			sourceLabel: loaded.marketplace.sourceLabel
-		};
-	} finally {
-		await loaded.marketplace.cleanup?.();
-	}
-}
-async function resolveMarketplaceInstallShortcut(raw) {
-	const trimmed = raw.trim();
-	const atIndex = trimmed.lastIndexOf("@");
-	if (atIndex <= 0 || atIndex >= trimmed.length - 1) return null;
-	const plugin = trimmed.slice(0, atIndex).trim();
-	const marketplaceName = trimmed.slice(atIndex + 1).trim();
-	if (!plugin || !marketplaceName || plugin.includes("/")) return null;
-	const known = (await readClaudeKnownMarketplaces())[marketplaceName];
-	if (!known) return null;
-	if (known.installLocation) return {
-		ok: true,
-		plugin,
-		marketplaceName,
-		marketplaceSource: marketplaceName
-	};
-	const normalizedSource = normalizeEntrySource(known.source);
-	if (!normalizedSource.ok) return {
-		ok: false,
-		error: `known Claude marketplace "${marketplaceName}" has an invalid source: ${normalizedSource.error}`
-	};
-	return {
-		ok: true,
-		plugin,
-		marketplaceName,
-		marketplaceSource: marketplaceName
-	};
-}
-async function installPluginFromMarketplace(params) {
-	const loaded = await loadMarketplace({
-		source: params.marketplace,
-		logger: params.logger,
-		timeoutMs: params.timeoutMs
-	});
-	if (!loaded.ok) return loaded;
-	let installCleanup;
-	try {
-		const entry = loaded.marketplace.manifest.plugins.find((plugin) => plugin.name === params.plugin);
-		if (!entry) {
-			const known = loaded.marketplace.manifest.plugins.map((plugin) => plugin.name).toSorted();
-			return {
-				ok: false,
-				error: `plugin "${params.plugin}" not found in marketplace ${loaded.marketplace.sourceLabel}` + (known.length > 0 ? ` (available: ${known.join(", ")})` : "")
-			};
-		}
-		const resolved = await resolveMarketplaceEntryInstallPath({
-			source: entry.source,
-			marketplaceRootDir: loaded.marketplace.rootDir,
-			marketplaceOrigin: loaded.marketplace.origin,
-			logger: params.logger,
-			timeoutMs: params.timeoutMs
-		});
-		if (!resolved.ok) return resolved;
-		installCleanup = resolved.cleanup;
-		const result = await installPluginFromPath({
-			dangerouslyForceUnsafeInstall: params.dangerouslyForceUnsafeInstall,
-			path: resolved.path,
-			logger: params.logger,
-			mode: params.mode,
-			dryRun: params.dryRun,
-			expectedPluginId: params.expectedPluginId
-		});
-		if (!result.ok) return result;
-		return {
-			...result,
-			marketplaceName: loaded.marketplace.manifest.name,
-			marketplaceVersion: loaded.marketplace.manifest.version,
-			marketplacePlugin: entry.name,
-			marketplaceSource: params.marketplace,
-			marketplaceEntryVersion: entry.version
-		};
-	} finally {
-		await installCleanup?.();
-		await loaded.marketplace.cleanup?.();
-	}
-}
-//#endregion
-//#region src/plugins/update.ts
-function formatNpmInstallFailure(params) {
-	if (params.result.code === PLUGIN_INSTALL_ERROR_CODE.NPM_PACKAGE_NOT_FOUND) return `Failed to ${params.phase} ${params.pluginId}: npm package not found for ${params.spec}.`;
-	return `Failed to ${params.phase} ${params.pluginId}: ${params.result.error}`;
-}
-function formatMarketplaceInstallFailure(params) {
-	return `Failed to ${params.phase} ${params.pluginId}: ${params.error} (marketplace plugin ${params.marketplacePlugin} from ${params.marketplaceSource}).`;
-}
-function formatClawHubInstallFailure(params) {
-	return `Failed to ${params.phase} ${params.pluginId}: ${params.error} (ClawHub ${params.spec}).`;
-}
-function stringFieldMatches(recorded, resolved) {
-	return !recorded || resolved !== void 0 && recorded === resolved;
-}
-function shouldSkipUnchangedNpmInstall(params) {
-	if (!params.currentVersion || !params.metadata.version) return false;
-	if (params.currentVersion !== params.metadata.version) return false;
-	return stringFieldMatches(params.record.integrity, params.metadata.integrity) && stringFieldMatches(params.record.shasum, params.metadata.shasum) && stringFieldMatches(params.record.resolvedName, params.metadata.name) && stringFieldMatches(params.record.resolvedSpec, params.metadata.resolvedSpec) && stringFieldMatches(params.record.resolvedVersion, params.metadata.version);
-}
-function pathsEqual(left, right, env = process.env) {
-	if (!left || !right) return false;
-	return resolveUserPath(left, env) === resolveUserPath(right, env);
-}
-function buildLoadPathHelpers(existing, env = process.env) {
-	let paths = [...existing];
-	const resolveSet = () => new Set(paths.map((entry) => resolveUserPath(entry, env)));
-	let resolved = resolveSet();
-	let changed = false;
-	const addPath = (value) => {
-		const normalized = resolveUserPath(value, env);
-		if (resolved.has(normalized)) return;
-		paths.push(value);
-		resolved.add(normalized);
-		changed = true;
-	};
-	const removePath = (value) => {
-		const normalized = resolveUserPath(value, env);
-		if (!resolved.has(normalized)) return;
-		paths = paths.filter((entry) => resolveUserPath(entry, env) !== normalized);
-		resolved = resolveSet();
-		changed = true;
-	};
-	return {
-		addPath,
-		removePath,
-		get changed() {
-			return changed;
-		},
-		get paths() {
-			return paths;
-		}
-	};
-}
-function replacePluginIdInList(entries, fromId, toId) {
-	if (!entries || entries.length === 0 || fromId === toId) return entries;
-	const next = [];
-	for (const entry of entries) {
-		const value = entry === fromId ? toId : entry;
-		if (!next.includes(value)) next.push(value);
-	}
-	return next;
-}
-function migratePluginConfigId(cfg, fromId, toId) {
-	if (fromId === toId) return cfg;
-	const installs = cfg.plugins?.installs;
-	const entries = cfg.plugins?.entries;
-	const slots = cfg.plugins?.slots;
-	const allow = replacePluginIdInList(cfg.plugins?.allow, fromId, toId);
-	const deny = replacePluginIdInList(cfg.plugins?.deny, fromId, toId);
-	const nextInstalls = installs ? { ...installs } : void 0;
-	if (nextInstalls && fromId in nextInstalls) {
-		const record = nextInstalls[fromId];
-		if (record && !(toId in nextInstalls)) nextInstalls[toId] = record;
-		delete nextInstalls[fromId];
-	}
-	const nextEntries = entries ? { ...entries } : void 0;
-	if (nextEntries && fromId in nextEntries) {
-		const entry = nextEntries[fromId];
-		if (entry) nextEntries[toId] = nextEntries[toId] ? {
-			...entry,
-			...nextEntries[toId]
-		} : entry;
-		delete nextEntries[fromId];
-	}
-	const nextSlots = slots?.memory === fromId ? {
-		...slots,
-		memory: toId
-	} : slots;
-	return {
-		...cfg,
-		plugins: {
-			...cfg.plugins,
-			allow,
-			deny,
-			entries: nextEntries,
-			installs: nextInstalls,
-			slots: nextSlots
-		}
-	};
-}
-function createPluginUpdateIntegrityDriftHandler(params) {
-	return async (drift) => {
-		const payload = {
-			pluginId: params.pluginId,
-			spec: drift.spec,
-			expectedIntegrity: drift.expectedIntegrity,
-			actualIntegrity: drift.actualIntegrity,
-			resolvedSpec: drift.resolution.resolvedSpec,
-			resolvedVersion: drift.resolution.version,
-			dryRun: params.dryRun
-		};
-		if (params.onIntegrityDrift) return await params.onIntegrityDrift(payload);
-		params.logger.warn?.(`Integrity drift for "${params.pluginId}" (${payload.resolvedSpec ?? payload.spec}): expected ${payload.expectedIntegrity}, got ${payload.actualIntegrity}`);
-		return false;
-	};
-}
-async function updateNpmInstalledPlugins(params) {
-	const logger = params.logger ?? {};
-	const installs = params.config.plugins?.installs ?? {};
-	const targets = params.pluginIds?.length ? params.pluginIds : Object.keys(installs);
-	const outcomes = [];
-	let next = params.config;
-	let changed = false;
-	for (const pluginId of targets) {
-		if (params.skipIds?.has(pluginId)) {
-			outcomes.push({
-				pluginId,
-				status: "skipped",
-				message: `Skipping "${pluginId}" (already updated).`
-			});
-			continue;
-		}
-		const record = installs[pluginId];
-		if (!record) {
-			outcomes.push({
-				pluginId,
-				status: "skipped",
-				message: `No install record for "${pluginId}".`
-			});
-			continue;
-		}
-		if (record.source !== "npm" && record.source !== "marketplace" && record.source !== "clawhub") {
-			outcomes.push({
-				pluginId,
-				status: "skipped",
-				message: `Skipping "${pluginId}" (source: ${record.source}).`
-			});
-			continue;
-		}
-		const effectiveSpec = record.source === "npm" ? params.specOverrides?.[pluginId] ?? record.spec : record.spec;
-		const expectedIntegrity = record.source === "npm" && effectiveSpec === record.spec ? expectedIntegrityForUpdate(record.spec, record.integrity) : void 0;
-		if (record.source === "npm" && !effectiveSpec) {
-			outcomes.push({
-				pluginId,
-				status: "skipped",
-				message: `Skipping "${pluginId}" (missing npm spec).`
-			});
-			continue;
-		}
-		if (record.source === "clawhub" && !record.clawhubPackage) {
-			outcomes.push({
-				pluginId,
-				status: "skipped",
-				message: `Skipping "${pluginId}" (missing ClawHub package metadata).`
-			});
-			continue;
-		}
-		if (record.source === "marketplace" && (!record.marketplaceSource || !record.marketplacePlugin)) {
-			outcomes.push({
-				pluginId,
-				status: "skipped",
-				message: `Skipping "${pluginId}" (missing marketplace source metadata).`
-			});
-			continue;
-		}
-		let installPath;
-		try {
-			installPath = record.installPath ?? resolvePluginInstallDir(pluginId);
-		} catch (err) {
-			outcomes.push({
-				pluginId,
-				status: "error",
-				message: `Invalid install path for "${pluginId}": ${String(err)}`
-			});
-			continue;
-		}
-		const currentVersion = await readInstalledPackageVersion(installPath);
-		if (!params.dryRun && record.source === "npm" && currentVersion) {
-			const metadataResult = await resolveNpmSpecMetadata({ spec: effectiveSpec });
-			if (metadataResult.ok) {
-				if (shouldSkipUnchangedNpmInstall({
-					currentVersion,
-					record,
-					metadata: metadataResult.metadata
-				})) {
-					outcomes.push({
-						pluginId,
-						status: "unchanged",
-						currentVersion,
-						nextVersion: metadataResult.metadata.version,
-						message: `${pluginId} is up to date (${currentVersion}).`
-					});
-					continue;
-				}
-			} else logger.warn?.(`Could not check ${pluginId} before update; falling back to installer path: ${metadataResult.error}`);
-		}
-		if (params.dryRun) {
-			let probe;
-			try {
-				probe = record.source === "npm" ? await installPluginFromNpmSpec({
-					spec: effectiveSpec,
-					mode: "update",
-					dryRun: true,
-					dangerouslyForceUnsafeInstall: params.dangerouslyForceUnsafeInstall,
-					expectedPluginId: pluginId,
-					expectedIntegrity,
-					onIntegrityDrift: createPluginUpdateIntegrityDriftHandler({
-						pluginId,
-						dryRun: true,
-						logger,
-						onIntegrityDrift: params.onIntegrityDrift
-					}),
-					logger
-				}) : record.source === "clawhub" ? await installPluginFromClawHub({
-					spec: effectiveSpec ?? `clawhub:${record.clawhubPackage}`,
-					baseUrl: record.clawhubUrl,
-					mode: "update",
-					dryRun: true,
-					dangerouslyForceUnsafeInstall: params.dangerouslyForceUnsafeInstall,
-					expectedPluginId: pluginId,
-					logger
-				}) : await installPluginFromMarketplace({
-					marketplace: record.marketplaceSource,
-					plugin: record.marketplacePlugin,
-					mode: "update",
-					dryRun: true,
-					dangerouslyForceUnsafeInstall: params.dangerouslyForceUnsafeInstall,
-					expectedPluginId: pluginId,
-					logger
-				});
-			} catch (err) {
-				outcomes.push({
-					pluginId,
-					status: "error",
-					message: `Failed to check ${pluginId}: ${String(err)}`
-				});
-				continue;
-			}
-			if (!probe.ok) {
-				outcomes.push({
-					pluginId,
-					status: "error",
-					message: record.source === "npm" ? formatNpmInstallFailure({
-						pluginId,
-						spec: effectiveSpec,
-						phase: "check",
-						result: probe
-					}) : record.source === "clawhub" ? formatClawHubInstallFailure({
-						pluginId,
-						spec: effectiveSpec ?? `clawhub:${record.clawhubPackage}`,
-						phase: "check",
-						error: probe.error
-					}) : formatMarketplaceInstallFailure({
-						pluginId,
-						marketplaceSource: record.marketplaceSource,
-						marketplacePlugin: record.marketplacePlugin,
-						phase: "check",
-						error: probe.error
-					})
-				});
-				continue;
-			}
-			const nextVersion = probe.version ?? "unknown";
-			const currentLabel = currentVersion ?? "unknown";
-			if (currentVersion && probe.version && currentVersion === probe.version) outcomes.push({
-				pluginId,
-				status: "unchanged",
-				currentVersion: currentVersion ?? void 0,
-				nextVersion: probe.version ?? void 0,
-				message: `${pluginId} is up to date (${currentLabel}).`
-			});
-			else outcomes.push({
-				pluginId,
-				status: "updated",
-				currentVersion: currentVersion ?? void 0,
-				nextVersion: probe.version ?? void 0,
-				message: `Would update ${pluginId}: ${currentLabel} -> ${nextVersion}.`
-			});
-			continue;
-		}
-		let result;
-		try {
-			result = record.source === "npm" ? await installPluginFromNpmSpec({
-				spec: effectiveSpec,
-				mode: "update",
-				dangerouslyForceUnsafeInstall: params.dangerouslyForceUnsafeInstall,
-				expectedPluginId: pluginId,
-				expectedIntegrity,
-				onIntegrityDrift: createPluginUpdateIntegrityDriftHandler({
-					pluginId,
-					dryRun: false,
-					logger,
-					onIntegrityDrift: params.onIntegrityDrift
-				}),
-				logger
-			}) : record.source === "clawhub" ? await installPluginFromClawHub({
-				spec: effectiveSpec ?? `clawhub:${record.clawhubPackage}`,
-				baseUrl: record.clawhubUrl,
-				mode: "update",
-				dangerouslyForceUnsafeInstall: params.dangerouslyForceUnsafeInstall,
-				expectedPluginId: pluginId,
-				logger
-			}) : await installPluginFromMarketplace({
-				marketplace: record.marketplaceSource,
-				plugin: record.marketplacePlugin,
-				mode: "update",
-				dangerouslyForceUnsafeInstall: params.dangerouslyForceUnsafeInstall,
-				expectedPluginId: pluginId,
-				logger
-			});
-		} catch (err) {
-			outcomes.push({
-				pluginId,
-				status: "error",
-				message: `Failed to update ${pluginId}: ${String(err)}`
-			});
-			continue;
-		}
-		if (!result.ok) {
-			outcomes.push({
-				pluginId,
-				status: "error",
-				message: record.source === "npm" ? formatNpmInstallFailure({
-					pluginId,
-					spec: effectiveSpec,
-					phase: "update",
-					result
-				}) : record.source === "clawhub" ? formatClawHubInstallFailure({
-					pluginId,
-					spec: effectiveSpec ?? `clawhub:${record.clawhubPackage}`,
-					phase: "update",
-					error: result.error
-				}) : formatMarketplaceInstallFailure({
-					pluginId,
-					marketplaceSource: record.marketplaceSource,
-					marketplacePlugin: record.marketplacePlugin,
-					phase: "update",
-					error: result.error
-				})
-			});
-			continue;
-		}
-		const resolvedPluginId = result.pluginId;
-		if (resolvedPluginId !== pluginId) next = migratePluginConfigId(next, pluginId, resolvedPluginId);
-		const nextVersion = result.version ?? await readInstalledPackageVersion(result.targetDir);
-		if (record.source === "npm") next = recordPluginInstall(next, {
-			pluginId: resolvedPluginId,
-			source: "npm",
-			spec: effectiveSpec,
-			installPath: result.targetDir,
-			version: nextVersion,
-			...buildNpmResolutionInstallFields(result.npmResolution)
-		});
-		else if (record.source === "clawhub") {
-			const clawhubResult = result;
-			next = recordPluginInstall(next, {
-				pluginId: resolvedPluginId,
-				source: "clawhub",
-				spec: effectiveSpec ?? record.spec ?? `clawhub:${record.clawhubPackage}`,
-				installPath: result.targetDir,
-				version: nextVersion,
-				integrity: clawhubResult.clawhub.integrity,
-				resolvedAt: clawhubResult.clawhub.resolvedAt,
-				clawhubUrl: clawhubResult.clawhub.clawhubUrl,
-				clawhubPackage: clawhubResult.clawhub.clawhubPackage,
-				clawhubFamily: clawhubResult.clawhub.clawhubFamily,
-				clawhubChannel: clawhubResult.clawhub.clawhubChannel
-			});
-		} else {
-			const marketplaceResult = result;
-			next = recordPluginInstall(next, {
-				pluginId: resolvedPluginId,
-				source: "marketplace",
-				installPath: result.targetDir,
-				version: nextVersion,
-				marketplaceName: marketplaceResult.marketplaceName ?? record.marketplaceName,
-				marketplaceSource: record.marketplaceSource,
-				marketplacePlugin: record.marketplacePlugin
-			});
-		}
-		changed = true;
-		const currentLabel = currentVersion ?? "unknown";
-		const nextLabel = nextVersion ?? "unknown";
-		if (currentVersion && nextVersion && currentVersion === nextVersion) outcomes.push({
-			pluginId,
-			status: "unchanged",
-			currentVersion: currentVersion ?? void 0,
-			nextVersion: nextVersion ?? void 0,
-			message: `${pluginId} already at ${currentLabel}.`
-		});
-		else outcomes.push({
-			pluginId,
-			status: "updated",
-			currentVersion: currentVersion ?? void 0,
-			nextVersion: nextVersion ?? void 0,
-			message: `Updated ${pluginId}: ${currentLabel} -> ${nextLabel}.`
-		});
-	}
-	return {
-		config: next,
-		changed,
-		outcomes
-	};
-}
-async function syncPluginsForUpdateChannel(params) {
-	const env = params.env ?? process.env;
-	const summary = {
-		switchedToBundled: [],
-		switchedToNpm: [],
-		warnings: [],
-		errors: []
-	};
-	const bundled = resolveBundledPluginSources({
-		workspaceDir: params.workspaceDir,
-		env
-	});
-	if (bundled.size === 0) return {
-		config: params.config,
-		changed: false,
-		summary
-	};
-	let next = params.config;
-	const loadHelpers = buildLoadPathHelpers(next.plugins?.load?.paths ?? [], env);
-	const installs = next.plugins?.installs ?? {};
-	let changed = false;
-	if (params.channel === "dev") for (const [pluginId, record] of Object.entries(installs)) {
-		const bundledInfo = bundled.get(pluginId);
-		if (!bundledInfo) continue;
-		loadHelpers.addPath(bundledInfo.localPath);
-		if (record.source === "path" && pathsEqual(record.sourcePath, bundledInfo.localPath, env)) continue;
-		next = recordPluginInstall(next, {
-			pluginId,
-			source: "path",
-			sourcePath: bundledInfo.localPath,
-			installPath: bundledInfo.localPath,
-			spec: record.spec ?? bundledInfo.npmSpec,
-			version: record.version
-		});
-		summary.switchedToBundled.push(pluginId);
-		changed = true;
-	}
-	else for (const [pluginId, record] of Object.entries(installs)) {
-		const bundledInfo = bundled.get(pluginId);
-		if (!bundledInfo) continue;
-		if (record.source === "npm") {
-			loadHelpers.removePath(bundledInfo.localPath);
-			continue;
-		}
-		if (record.source !== "path") continue;
-		if (!pathsEqual(record.sourcePath, bundledInfo.localPath, env)) continue;
-		loadHelpers.addPath(bundledInfo.localPath);
-		if (record.source === "path" && pathsEqual(record.sourcePath, bundledInfo.localPath, env) && pathsEqual(record.installPath, bundledInfo.localPath, env)) continue;
-		next = recordPluginInstall(next, {
-			pluginId,
-			source: "path",
-			sourcePath: bundledInfo.localPath,
-			installPath: bundledInfo.localPath,
-			spec: record.spec ?? bundledInfo.npmSpec,
-			version: record.version
-		});
-		changed = true;
-	}
-	if (loadHelpers.changed) {
-		next = {
-			...next,
-			plugins: {
-				...next.plugins,
-				load: {
-					...next.plugins?.load,
-					paths: loadHelpers.paths
-				}
-			}
-		};
-		changed = true;
-	}
-	return {
-		config: next,
-		changed,
-		summary
-	};
-}
-//#endregion
-export { resolveMarketplaceInstallShortcut as a, listMarketplacePlugins as i, updateNpmInstalledPlugins as n, installPluginFromMarketplace as r, syncPluginsForUpdateChannel as t };