@pipelab/core-node 1.0.0-beta.31 → 1.0.0-beta.34

package/dist/index.cjs

@@ -9001,7 +9001,6 @@ var require_src = /* @__PURE__ */ require_config.__commonJSMin(((exports, module
 //#region src/server.ts
 var import_src = /* @__PURE__ */ require_config.__toESM(require_src(), 1);
 const sendStartupProgress = (message) => {
-	console.log(`[Startup Progress] ${message}`);
 	webSocketServer.broadcast("startup:progress", {
 		type: "progress",
 		data: { message }
@@ -9168,7 +9167,7 @@ async function fetchPackage(packageName, versionOrRange, options) {
 			const localStart = Date.now();
 			const local = await tryResolveMonorepoPackage(packageName);
 			if (local) {
-				console.log(`[Fetcher] ${packageName}: Resolved to local source at ${local.packageDir} (${Date.now() - localStart}ms)`);
+				console.debug(`[Fetcher] ${packageName}: Resolved to local source at ${local.packageDir} (${Date.now() - localStart}ms)`);
 				return {
 					...local,
 					resolvedVersion: "workspace"
@@ -9182,7 +9181,7 @@ async function fetchPackage(packageName, versionOrRange, options) {
 	const includePrerelease = !!(ctx.releaseTag && ctx.releaseTag !== "latest");
 	let resolvedVersionOrRange = versionOrRange;
 	if (resolvedVersionOrRange === "local") resolvedVersionOrRange = "latest";
-	console.log(`[Fetcher] Resolving ${packageName}@${resolvedVersionOrRange || "latest"}...`);
+	console.debug(`[Fetcher] Resolving ${packageName}@${resolvedVersionOrRange || "latest"}...`);
 	const resolveStart = Date.now();
 	if (!await isOnline()) {
 		console.warn(`[Fetcher] ${packageName}: offline mode detected (${Date.now() - resolveStart}ms), trying local fallback...`);
@@ -9190,7 +9189,7 @@ async function fetchPackage(packageName, versionOrRange, options) {
 		const fallbackVersion = await tryLocalFallback(resolvedVersionOrRange, /* @__PURE__ */ new Error("Offline"), baseDir, packageName, includePrerelease);
 		if (fallbackVersion) {
 			resolvedVersion = fallbackVersion;
-			console.log(`[Fetcher] ${packageName}: Resolved to local fallback ${resolvedVersion} (${Date.now() - fallbackStart}ms)`);
+			console.debug(`[Fetcher] ${packageName}: Resolved to local fallback ${resolvedVersion} (${Date.now() - fallbackStart}ms)`);
 		} else throw new Error(`Offline and no local fallback version available for ${packageName}`);
 	} else try {
 		const cachePath = ctx.getCachePath(CacheFolder.Pacote);
@@ -9208,7 +9207,7 @@ async function fetchPackage(packageName, versionOrRange, options) {
 			if (releaseTagVersion && semver.default.valid(releaseTagVersion)) {
 				const rewrittenRangeForCheck = allowPrereleaseInRange(range);
 				if (semver.default.satisfies(releaseTagVersion, rewrittenRangeForCheck, { includePrerelease: true })) {
-					console.log(`[Fetcher] Using release tag "${ctx.releaseTag}" (${releaseTagVersion}) for ${packageName}@${range} because it satisfies the range`);
+					console.debug(`[Fetcher] Using release tag "${ctx.releaseTag}" (${releaseTagVersion}) for ${packageName}@${range} because it satisfies the range`);
 					foundVersion = releaseTagVersion;
 				}
 			}
@@ -9218,7 +9217,7 @@ async function fetchPackage(packageName, versionOrRange, options) {
 			if (rewrittenRange !== range) {
 				const matched = semver.default.maxSatisfying(versions, rewrittenRange, { includePrerelease });
 				if (matched) {
-					console.log(`[Fetcher] Resolved ${packageName}@${range} to ${matched} via rewritten range ${rewrittenRange}`);
+					console.debug(`[Fetcher] Resolved ${packageName}@${range} to ${matched} via rewritten range ${rewrittenRange}`);
 					foundVersion = matched;
 				}
 			}
@@ -9227,21 +9226,21 @@ async function fetchPackage(packageName, versionOrRange, options) {
 			const releaseTagVersion = packument["dist-tags"]?.[ctx.releaseTag];
 			if (releaseTagVersion && semver.default.valid(releaseTagVersion)) {
 				if (!foundVersion || semver.default.valid(foundVersion) && semver.default.gte(releaseTagVersion, foundVersion)) {
-					console.log(`[Fetcher] Using release tag "${ctx.releaseTag}" (${releaseTagVersion}) instead of "latest" (${foundVersion || "none"}) for ${packageName}`);
+					console.debug(`[Fetcher] Using release tag "${ctx.releaseTag}" (${releaseTagVersion}) instead of "latest" (${foundVersion || "none"}) for ${packageName}`);
 					foundVersion = releaseTagVersion;
 				} else if (foundVersion) console.warn(`[Fetcher] Tag "${ctx.releaseTag}" (${releaseTagVersion}) is older than "latest" (${foundVersion}) for ${packageName}, keeping "latest"`);
 			}
 		}
 		if (!foundVersion) throw new Error(`Package ${packageName}@${range} not found on npm (available tags: ${Object.keys(packument["dist-tags"] || {}).join(", ")})`);
 		resolvedVersion = foundVersion;
-		console.log(`[Fetcher] ${packageName}: Resolved to v${resolvedVersion} via npm (${Date.now() - resolveStart}ms)`);
+		console.debug(`[Fetcher] ${packageName}: Resolved to v${resolvedVersion} via npm (${Date.now() - resolveStart}ms)`);
 	} catch (error) {
 		console.warn(`[Fetcher] ${packageName}: remote resolution failed (${Date.now() - resolveStart}ms), trying local fallback...`);
 		const fallbackStart = Date.now();
 		const fallbackVersion = await tryLocalFallback(resolvedVersionOrRange, error, baseDir, packageName, includePrerelease);
 		if (fallbackVersion) {
 			resolvedVersion = fallbackVersion;
-			console.log(`[Fetcher] ${packageName}: Resolved to local fallback ${resolvedVersion} (${Date.now() - fallbackStart}ms)`);
+			console.debug(`[Fetcher] ${packageName}: Resolved to local fallback ${resolvedVersion} (${Date.now() - fallbackStart}ms)`);
 		} else throw error;
 	}
 	const cachePath = ctx.getCachePath(CacheFolder.Pacote);
@@ -9250,7 +9249,7 @@ async function fetchPackage(packageName, versionOrRange, options) {
 	const isInstalled = options?.installDeps ? isPackageComplete(packageDir) && isDependenciesInstalledSync(packageDir) : isPackageComplete(packageDir);
 	const checkDuration = Date.now() - checkStart;
 	if (isInstalled) {
-		console.log(`[Fetcher] ${packageName}@${resolvedVersion}: Already installed (check took ${checkDuration}ms, fetchPackage took ${Date.now() - start}ms)`);
+		console.debug(`[Fetcher] ${packageName}@${resolvedVersion}: Already installed (check took ${checkDuration}ms, fetchPackage took ${Date.now() - start}ms)`);
 		return {
 			packageDir,
 			resolvedVersion
@@ -9258,7 +9257,7 @@ async function fetchPackage(packageName, versionOrRange, options) {
 	}
 	return withLock(`package:${packageName}:${resolvedVersion}`, async () => {
 		if (!isPackageComplete(packageDir)) {
-			console.log(`[Fetcher] ${packageName}@${resolvedVersion}: Downloading to ${packageDir}...`);
+			console.debug(`[Fetcher] ${packageName}@${resolvedVersion}: Downloading to ${packageDir}...`);
 			const downloadStart = Date.now();
 			const tempDir = (0, node_path.join)(baseDir, `.tmp-${resolvedVersion}-${Math.random().toString(36).slice(2)}`);
 			await (0, node_fs_promises.mkdir)(tempDir, { recursive: true });
@@ -9272,10 +9271,10 @@ async function fetchPackage(packageName, versionOrRange, options) {
 				try {
 					await (0, node_fs_promises.rename)(tempDir, packageDir);
 				} catch (err) {
-					if (isPackageComplete(packageDir)) console.log(`[Fetcher] Destination ${packageDir} already exists and is valid.`);
+					if (isPackageComplete(packageDir)) console.debug(`[Fetcher] Destination ${packageDir} already exists and is valid.`);
 					else throw err;
 				}
-				console.log(`[Fetcher] ${packageName}@${resolvedVersion}: Downloaded and extracted in ${Date.now() - downloadStart}ms`);
+				console.debug(`[Fetcher] ${packageName}@${resolvedVersion}: Downloaded and extracted in ${Date.now() - downloadStart}ms`);
 			} catch (err) {
 				await (0, node_fs_promises.rm)(tempDir, {
 					recursive: true,
@@ -9286,13 +9285,13 @@ async function fetchPackage(packageName, versionOrRange, options) {
 		}
 		const entryStart = Date.now();
 		const entryPoint = await resolveEntryPoint(packageDir, packageName);
-		console.log(`[Fetcher] ${packageName}@${resolvedVersion}: Resolved entry point in ${Date.now() - entryStart}ms`);
+		console.debug(`[Fetcher] ${packageName}@${resolvedVersion}: Resolved entry point in ${Date.now() - entryStart}ms`);
 		if (options?.installDeps) {
 			const depsStart = Date.now();
 			await installDependencies(packageDir, packageName, options);
-			console.log(`[Fetcher] ${packageName}@${resolvedVersion}: Installed dependencies in ${Date.now() - depsStart}ms`);
+			console.debug(`[Fetcher] ${packageName}@${resolvedVersion}: Installed dependencies in ${Date.now() - depsStart}ms`);
 		}
-		console.log(`[Fetcher] ${packageName}@${resolvedVersion}: FetchPackage complete in ${Date.now() - start}ms`);
+		console.debug(`[Fetcher] ${packageName}@${resolvedVersion}: FetchPackage complete in ${Date.now() - start}ms`);
 		return {
 			packageDir,
 			resolvedVersion,
@@ -9336,7 +9335,7 @@ async function ensureNodeJS(context, version = _pipelab_constants.DEFAULT_NODE_V
 	const nodeDir = context.getThirdPartyPath("node", version);
 	const finalNodePath = (0, node_path.join)(nodeDir, isWindows ? "node.exe" : "bin/node");
 	if (isNodeJSComplete(finalNodePath)) {
-		console.log(`[Environment] Node.js check took ${Date.now() - checkStart}ms (found at ${finalNodePath})`);
+		console.debug(`[Environment] Node.js check took ${Date.now() - checkStart}ms (found at ${finalNodePath})`);
 		return finalNodePath;
 	}
 	return withLock(`node:${version}`, async () => {
@@ -9352,7 +9351,7 @@ async function ensureNodeJS(context, version = _pipelab_constants.DEFAULT_NODE_V
 		console.log(`Downloading Node.js from ${downloadUrl}...`);
 		const dlStart = Date.now();
 		await require_config.downloadFile(downloadUrl, archivePath);
-		console.log(`[Environment] Node.js download took ${Date.now() - dlStart}ms`);
+		console.debug(`[Environment] Node.js download took ${Date.now() - dlStart}ms`);
 		sendStartupProgress(`Extracting Node.js v${version}...`);
 		console.log(`Extracting Node.js to ${tempDir}...`);
 		const extStart = Date.now();
@@ -9377,10 +9376,10 @@ async function ensureNodeJS(context, version = _pipelab_constants.DEFAULT_NODE_V
 			try {
 				await (0, node_fs_promises.rename)(tempNodeDir, nodeDir);
 			} catch (err) {
-				if (isNodeJSComplete(finalNodePath)) console.log(`[Fetcher] Node.js directory already exists and is valid.`);
+				if (isNodeJSComplete(finalNodePath)) console.debug(`[Fetcher] Node.js directory already exists and is valid.`);
 				else throw err;
 			}
-			console.log(`[Environment] Node.js extraction took ${Date.now() - extStart}ms`);
+			console.debug(`[Environment] Node.js extraction took ${Date.now() - extStart}ms`);
 		} finally {
 			await (0, node_fs_promises.rm)(tempNodeDir, {
 				recursive: true,
@@ -9391,7 +9390,7 @@ async function ensureNodeJS(context, version = _pipelab_constants.DEFAULT_NODE_V
 				force: true
 			}).catch(() => {});
 		}
-		console.log(`[Environment] Node.js set up complete in ${Date.now() - checkStart}ms`);
+		console.debug(`[Environment] Node.js set up complete in ${Date.now() - checkStart}ms`);
 		return finalNodePath;
 	});
 }
@@ -9402,14 +9401,14 @@ async function ensurePNPM(context, version = _pipelab_constants.DEFAULT_PNPM_VER
 	const checkStart = Date.now();
 	const pnpmPath = (0, node_path.join)(context.getPackagesPath("pnpm", version), "bin", "pnpm.cjs");
 	if ((0, node_fs.existsSync)(pnpmPath)) {
-		console.log(`[Environment] PNPM check took ${Date.now() - checkStart}ms (found at ${pnpmPath})`);
+		console.debug(`[Environment] PNPM check took ${Date.now() - checkStart}ms (found at ${pnpmPath})`);
 		return pnpmPath;
 	}
 	return withLock(`pnpm:${version}`, async () => {
 		if ((0, node_fs.existsSync)(pnpmPath)) return pnpmPath;
 		sendStartupProgress(`Checking PNPM v${version}...`);
 		const { packageDir } = await fetchPackage("pnpm", version, { context });
-		console.log(`[Environment] PNPM set up complete in ${Date.now() - checkStart}ms`);
+		console.debug(`[Environment] PNPM set up complete in ${Date.now() - checkStart}ms`);
 		return (0, node_path.join)(packageDir, "bin", "pnpm.cjs");
 	});
 }
@@ -9417,19 +9416,19 @@ async function installDependencies(packageDir, packageName, options) {
 	const start = Date.now();
 	const nodeModulesPath = (0, node_path.join)(packageDir, "node_modules");
 	if (isDependenciesInstalledSync(packageDir)) {
-		console.log(`[Fetcher] ${packageName}: Dependencies already installed, skipping.`);
+		console.debug(`[Fetcher] ${packageName}: Dependencies already installed, skipping.`);
 		return;
 	}
 	try {
-		console.log(`[Fetcher] ${packageName}: Ensuring dependencies are installed...`);
+		console.debug(`[Fetcher] ${packageName}: Ensuring dependencies are installed...`);
 		const pnpmStart = Date.now();
 		const { all } = await runPnpm(packageDir, {
 			signal: options.signal,
 			context: options.context
 		});
-		console.log(`[Fetcher] ${packageName}: pnpm install command took ${Date.now() - pnpmStart}ms`);
-		if (all) console.log(`[Fetcher] ${packageName}: Installation trace:\n${all}`);
-		console.log(`[Fetcher] ${packageName}: Dependencies installed successfully (total installDependencies took ${Date.now() - start}ms).`);
+		console.debug(`[Fetcher] ${packageName}: pnpm install command took ${Date.now() - pnpmStart}ms`);
+		if (all) console.debug(`[Fetcher] ${packageName}: Installation trace:\n${all}`);
+		console.debug(`[Fetcher] ${packageName}: Dependencies installed successfully (total installDependencies took ${Date.now() - start}ms).`);
 	} catch (err) {
 		console.error(`[Fetcher] ${packageName}: CRITICAL ERROR during dependency installation: ${err.message}`);
 		if (err.all) console.error(`[Fetcher] ${packageName}: Error details:\n${err.all}`);
@@ -9677,209 +9676,6 @@ const handleActionExecute = async (nodeId, pluginId, params, mainWindow, send, a
 	}
 };
 //#endregion
-//#region src/plugins-registry.ts
-const enhancePluginDefinition = async (plugin, packageDir, fallbackName, fallbackVersion) => {
-	if (!plugin) return plugin;
-	let packageName = fallbackName;
-	let version = fallbackVersion;
-	let pipelabMeta = null;
-	let pkgDescription = "";
-	try {
-		const pkgJsonPath = (0, node_path.join)(packageDir, "package.json");
-		if ((0, node_fs.existsSync)(pkgJsonPath)) {
-			const pkgContent = await (0, node_fs_promises.readFile)(pkgJsonPath, "utf8");
-			const pkg = JSON.parse(pkgContent);
-			if (pkg.name) packageName = pkg.name;
-			if (pkg.version) version = pkg.version;
-			if (pkg.description) pkgDescription = pkg.description;
-			if (pkg.pipelab) pipelabMeta = pkg.pipelab;
-		}
-	} catch (e) {
-		console.error(`[Plugins] Failed to read package.json in ${packageDir}:`, e);
-	}
-	plugin.packageName = packageName;
-	plugin.id = packageName;
-	plugin.version = fallbackVersion === "local" ? "local" : version;
-	plugin.isOfficial = packageName.startsWith("@pipelab/");
-	plugin.name = pipelabMeta?.name || packageName;
-	plugin.description = pipelabMeta?.description || pkgDescription || "";
-	if (pipelabMeta?.icon) if (typeof pipelabMeta.icon === "string") {
-		let iconPath = pipelabMeta.icon;
-		if (iconPath.startsWith(".")) iconPath = (0, node_url.pathToFileURL)((0, node_path.join)(packageDir, iconPath)).href;
-		plugin.icon = {
-			type: "image",
-			image: iconPath
-		};
-	} else plugin.icon = pipelabMeta.icon;
-	else plugin.icon = {
-		type: "icon",
-		icon: "pi pi-box"
-	};
-	return plugin;
-};
-const loadPipelabPlugin = async (id, options) => {
-	const start = Date.now();
-	try {
-		const packageName = id;
-		const fetchStart = Date.now();
-		const { packageDir, entryPoint } = await fetchPipelabPlugin(packageName, options.context.releaseTag, {
-			context: options.context,
-			installDeps: false
-		});
-		const fetchDuration = Date.now() - fetchStart;
-		console.log(`[Plugins] [${id}] Attempting to import from: ${entryPoint}`);
-		if (!(0, node_fs.existsSync)(entryPoint)) {
-			console.error(`[Plugins] [${id}] CRITICAL: Plugin entry point not found at ${entryPoint}`);
-			try {
-				const files = await (0, node_fs_promises.readdir)(packageDir, { recursive: true });
-				console.log(`[Plugins] [${id}] Directory contents:`, files);
-			} catch (e) {}
-		}
-		const importStart = Date.now();
-		const pluginModule = await import((0, node_url.pathToFileURL)(entryPoint).href);
-		const importDuration = Date.now() - importStart;
-		const totalDuration = Date.now() - start;
-		console.log(`[Plugins] [${id}] Successfully loaded from: ${packageDir} (fetch: ${fetchDuration}ms, import: ${importDuration}ms, total: ${totalDuration}ms)`);
-		const plugin = pluginModule.default;
-		await enhancePluginDefinition(plugin, packageDir, packageName, options.context.releaseTag);
-		return plugin;
-	} catch (e) {
-		console.error(`[Plugins] [${id}] CRITICAL: Failed to load after ${Date.now() - start}ms:`, e);
-		if (e.code === "ERR_MODULE_NOT_FOUND") console.error(`[Plugins] [${id}] This usually means a dependency is missing in the plugin's node_modules.`);
-		return null;
-	}
-};
-const loadCustomPlugin = async (packageName, version, options) => {
-	const start = Date.now();
-	try {
-		const fetchStart = Date.now();
-		const { packageDir, entryPoint } = await fetchPipelabPlugin(packageName, version, {
-			context: options.context,
-			installDeps: false
-		});
-		const fetchDuration = Date.now() - fetchStart;
-		console.log(`[Plugins] [${packageName}] Attempting to import custom plugin from: ${entryPoint}`);
-		if (!(0, node_fs.existsSync)(entryPoint)) {
-			console.error(`[Plugins] [${packageName}] CRITICAL: Plugin entry point not found at ${entryPoint}`);
-			return null;
-		}
-		const importStart = Date.now();
-		const pluginModule = await import((0, node_url.pathToFileURL)(entryPoint).href);
-		const importDuration = Date.now() - importStart;
-		const totalDuration = Date.now() - start;
-		console.log(`[Plugins] [${packageName}] Successfully loaded custom plugin from: ${packageDir} (fetch: ${fetchDuration}ms, import: ${importDuration}ms, total: ${totalDuration}ms)`);
-		const plugin = pluginModule.default;
-		await enhancePluginDefinition(plugin, packageDir, packageName, version);
-		return plugin;
-	} catch (e) {
-		console.error(`[Plugins] [${packageName}] CRITICAL: Failed to load after ${Date.now() - start}ms:`, e);
-		return null;
-	}
-};
-async function findInstalledPlugins(packagesDir) {
-	const installed = [];
-	if (!(0, node_fs.existsSync)(packagesDir)) return installed;
-	async function scan(dir, depth = 0) {
-		if (depth > 4) return;
-		try {
-			const entries = await (0, node_fs_promises.readdir)(dir, { withFileTypes: true });
-			if (entries.some((e) => e.isFile() && e.name === "package.json")) {
-				try {
-					const content = await (0, node_fs_promises.readFile)((0, node_path.join)(dir, "package.json"), "utf8");
-					const pkg = JSON.parse(content);
-					if (pkg.name && pkg.name !== "pnpm") installed.push({
-						name: pkg.name,
-						version: pkg.version || "0.0.0",
-						packageDir: dir,
-						description: pkg.description || ""
-					});
-				} catch (e) {}
-				return;
-			}
-			for (const entry of entries) if (entry.isDirectory() && entry.name !== "node_modules" && !entry.name.startsWith(".")) await scan((0, node_path.join)(dir, entry.name), depth + 1);
-		} catch (e) {}
-	}
-	await scan(packagesDir);
-	return installed;
-}
-const builtInPlugins = async (options) => {
-	console.log("[Plugins] Starting background plugin loading...");
-	sendStartupProgress("Preparing environment...");
-	const envStart = Date.now();
-	await Promise.all([ensureNodeJS(options.context), ensurePNPM(options.context)]);
-	console.log(`[Plugins] Environment preparation took ${Date.now() - envStart}ms`);
-	const { usePlugins } = await import("@pipelab/shared");
-	const { registerPlugins } = usePlugins();
-	const { webSocketServer } = await Promise.resolve().then(() => require("./index.cjs"));
-	webSocketServer.broadcast("startup:progress", { type: "ready" });
-	(async () => {
-		const totalStart = Date.now();
-		const pluginsToLoad = /* @__PURE__ */ new Map();
-		for (const name of [
-			"@pipelab/plugin-construct",
-			"@pipelab/plugin-filesystem",
-			"@pipelab/plugin-system",
-			"@pipelab/plugin-steam",
-			"@pipelab/plugin-itch",
-			"@pipelab/plugin-electron",
-			"@pipelab/plugin-discord",
-			"@pipelab/plugin-poki",
-			"@pipelab/plugin-nvpatch",
-			"@pipelab/plugin-tauri",
-			"@pipelab/plugin-minify",
-			"@pipelab/plugin-netlify"
-		]) pluginsToLoad.set(name, "latest");
-		if (isDev && projectRoot) {
-			const pluginsDir = (0, node_path.join)(projectRoot, "plugins");
-			if ((0, node_fs.existsSync)(pluginsDir)) try {
-				const entries = await (0, node_fs_promises.readdir)(pluginsDir, { withFileTypes: true });
-				for (const entry of entries) if (entry.isDirectory()) {
-					const pkgPath = (0, node_path.join)(pluginsDir, entry.name, "package.json");
-					if ((0, node_fs.existsSync)(pkgPath)) try {
-						const pkgContent = await (0, node_fs_promises.readFile)(pkgPath, "utf-8");
-						const pkg = JSON.parse(pkgContent);
-						if (pkg.name && pkg.name.startsWith("@pipelab/plugin-") && pkg.name !== "@pipelab/plugin-core") pluginsToLoad.set(pkg.name, "local");
-					} catch (e) {
-						console.error(`[Plugins] Failed to parse package.json for ${entry.name}:`, e);
-					}
-				}
-			} catch (e) {
-				console.error(`[Plugins] Failed to scan local workspace plugins directory:`, e);
-			}
-		}
-		try {
-			const { setupSettingsConfigFile } = await Promise.resolve().then(() => require("./config-CAz_XbPS.cjs")).then((n) => n.config_exports);
-			const settingsPlugins = (await (await setupSettingsConfigFile(options.context)).getConfig())?.plugins || [];
-			for (const plugin of settingsPlugins) if (plugin.name) if (plugin.enabled) {
-				if (!pluginsToLoad.has(plugin.name)) pluginsToLoad.set(plugin.name, "latest");
-			} else pluginsToLoad.delete(plugin.name);
-		} catch (e) {
-			console.error(`[Plugins] Failed to load settings config on startup:`, e);
-		}
-		console.log(`[Plugins] Total plugins to load on startup:`, Array.from(pluginsToLoad.entries()));
-		const loadPromises = Array.from(pluginsToLoad.entries()).map(async ([packageName, version]) => {
-			sendStartupProgress(`Loading plugin: ${packageName}`);
-			const pluginStart = Date.now();
-			try {
-				const plugin = await loadCustomPlugin(packageName, version, options);
-				if (plugin) {
-					registerPlugins([plugin]);
-					webSocketServer.broadcast("plugin:loaded", { plugin });
-					console.log(`[Plugins] Loaded ${packageName}@${version} in ${Date.now() - pluginStart}ms`);
-				}
-			} catch (err) {
-				console.error(`[Plugins] Failed to load plugin ${packageName} at startup:`, err);
-			}
-		});
-		await Promise.all(loadPromises);
-		console.log(`[Plugins] All startup plugins loaded in ${Date.now() - totalStart}ms.`);
-		sendStartupProgress("All plugins loaded.");
-		setTimeout(() => {
-			webSocketServer.broadcast("startup:progress", { type: "done" });
-		}, 2e3);
-	})();
-};
-//#endregion
 //#region src/utils.ts
 const getFinalPlugins = () => {
 	const { plugins } = (0, _pipelab_shared.usePlugins)();
@@ -9939,13 +9735,12 @@ const executeGraphWithHistory = async ({ graph, variables, projectName, projectP
 	let completedSteps = 0;
 	const { registerPlugins, plugins: registeredPlugins } = (0, _pipelab_shared.usePlugins)();
 	const pluginIds = new Set(graph.map((node) => node.origin?.pluginId).filter(Boolean));
-	for (const pluginId of pluginIds) if (!registeredPlugins.value.some((p) => p.id === pluginId)) {
-		logger().info(`[Runner] Plugin "${pluginId}" not found, attempting to load...`);
-		const pluginDefinition = await loadPipelabPlugin(pluginId, { context: ctx });
-		if (pluginDefinition) {
-			registerPlugins([pluginDefinition]);
-			logger().info(`[Runner] Plugin "${pluginId}" loaded and registered successfully`);
-		} else logger().error(`[Runner] Failed to load or register plugin "${pluginId}"`);
+	const missingPlugins = [];
+	for (const pluginId of pluginIds) if (!registeredPlugins.value.some((p) => p.id === pluginId)) missingPlugins.push(pluginId);
+	if (missingPlugins.length > 0) {
+		const errorMsg = `Fail-fast: The following required plugins are not loaded: ${missingPlugins.join(", ")}. Please ensure they are installed and enabled in settings.`;
+		logger().error(`[Runner] ${errorMsg}`);
+		throw new Error(errorMsg);
 	}
 	logger().info(`[Sandbox] Execution sandbox created at: ${sandboxPath}`);
 	await (await require_config.setupSettingsConfigFile(ctx)).getConfig();
@@ -10807,6 +10602,210 @@ const registerSystemHandlers = (options) => {
 	});
 };
 //#endregion
+//#region src/plugins-registry.ts
+const enhancePluginDefinition = async (plugin, packageDir, fallbackName, fallbackVersion) => {
+	if (!plugin) return plugin;
+	let packageName = fallbackName;
+	let version = fallbackVersion;
+	let pipelabMeta = null;
+	let pkgDescription = "";
+	try {
+		const pkgJsonPath = (0, node_path.join)(packageDir, "package.json");
+		if ((0, node_fs.existsSync)(pkgJsonPath)) {
+			const pkgContent = await (0, node_fs_promises.readFile)(pkgJsonPath, "utf8");
+			const pkg = JSON.parse(pkgContent);
+			if (pkg.name) packageName = pkg.name;
+			if (pkg.version) version = pkg.version;
+			if (pkg.description) pkgDescription = pkg.description;
+			if (pkg.pipelab) pipelabMeta = pkg.pipelab;
+		}
+	} catch (e) {
+		console.error(`[Plugins] Failed to read package.json in ${packageDir}:`, e);
+	}
+	plugin.packageName = packageName;
+	plugin.id = packageName;
+	plugin.version = fallbackVersion === "local" ? "local" : version;
+	plugin.isOfficial = packageName.startsWith("@pipelab/");
+	plugin.name = pipelabMeta?.name || packageName;
+	plugin.description = pipelabMeta?.description || pkgDescription || "";
+	if (pipelabMeta?.icon) if (typeof pipelabMeta.icon === "string") {
+		let iconPath = pipelabMeta.icon;
+		if (iconPath.startsWith(".")) iconPath = (0, node_url.pathToFileURL)((0, node_path.join)(packageDir, iconPath)).href;
+		plugin.icon = {
+			type: "image",
+			image: iconPath
+		};
+	} else plugin.icon = pipelabMeta.icon;
+	else plugin.icon = {
+		type: "icon",
+		icon: "pi pi-box"
+	};
+	return plugin;
+};
+const loadPipelabPlugin = async (id, options) => {
+	const start = Date.now();
+	try {
+		const packageName = id;
+		const fetchStart = Date.now();
+		const { packageDir, entryPoint } = await fetchPipelabPlugin(packageName, options.context.releaseTag, {
+			context: options.context,
+			installDeps: false
+		});
+		const fetchDuration = Date.now() - fetchStart;
+		console.debug(`[Plugins] [${id}] Attempting to import from: ${entryPoint}`);
+		if (!(0, node_fs.existsSync)(entryPoint)) {
+			console.error(`[Plugins] [${id}] CRITICAL: Plugin entry point not found at ${entryPoint}`);
+			try {
+				const files = await (0, node_fs_promises.readdir)(packageDir, { recursive: true });
+				console.debug(`[Plugins] [${id}] Directory contents:`, files);
+			} catch (e) {}
+		}
+		const importStart = Date.now();
+		const pluginModule = await import((0, node_url.pathToFileURL)(entryPoint).href);
+		const importDuration = Date.now() - importStart;
+		const totalDuration = Date.now() - start;
+		console.debug(`[Plugins] [${id}] Successfully loaded from: ${packageDir} (fetch: ${fetchDuration}ms, import: ${importDuration}ms, total: ${totalDuration}ms)`);
+		const plugin = pluginModule.default;
+		await enhancePluginDefinition(plugin, packageDir, packageName, options.context.releaseTag);
+		return plugin;
+	} catch (e) {
+		console.error(`[Plugins] [${id}] CRITICAL: Failed to load after ${Date.now() - start}ms:`, e);
+		if (e.code === "ERR_MODULE_NOT_FOUND") console.error(`[Plugins] [${id}] This usually means a dependency is missing in the plugin's node_modules.`);
+		return null;
+	}
+};
+const loadCustomPlugin = async (packageName, version, options) => {
+	const start = Date.now();
+	try {
+		const fetchStart = Date.now();
+		const { packageDir, entryPoint } = await fetchPipelabPlugin(packageName, version, {
+			context: options.context,
+			installDeps: false
+		});
+		const fetchDuration = Date.now() - fetchStart;
+		console.debug(`[Plugins] [${packageName}] Attempting to import custom plugin from: ${entryPoint}`);
+		if (!(0, node_fs.existsSync)(entryPoint)) {
+			console.error(`[Plugins] [${packageName}] CRITICAL: Plugin entry point not found at ${entryPoint}`);
+			return null;
+		}
+		const importStart = Date.now();
+		const pluginModule = await import((0, node_url.pathToFileURL)(entryPoint).href);
+		const importDuration = Date.now() - importStart;
+		const totalDuration = Date.now() - start;
+		console.debug(`[Plugins] [${packageName}] Successfully loaded custom plugin from: ${packageDir} (fetch: ${fetchDuration}ms, import: ${importDuration}ms, total: ${totalDuration}ms)`);
+		const plugin = pluginModule.default;
+		await enhancePluginDefinition(plugin, packageDir, packageName, version);
+		return plugin;
+	} catch (e) {
+		console.error(`[Plugins] [${packageName}] CRITICAL: Failed to load after ${Date.now() - start}ms:`, e);
+		return null;
+	}
+};
+async function findInstalledPlugins(packagesDir) {
+	const installed = [];
+	if (!(0, node_fs.existsSync)(packagesDir)) return installed;
+	async function scan(dir, depth = 0) {
+		if (depth > 4) return;
+		try {
+			const entries = await (0, node_fs_promises.readdir)(dir, { withFileTypes: true });
+			if (entries.some((e) => e.isFile() && e.name === "package.json")) {
+				try {
+					const content = await (0, node_fs_promises.readFile)((0, node_path.join)(dir, "package.json"), "utf8");
+					const pkg = JSON.parse(content);
+					if (pkg.name && pkg.name !== "pnpm") installed.push({
+						name: pkg.name,
+						version: pkg.version || "0.0.0",
+						packageDir: dir,
+						description: pkg.description || ""
+					});
+				} catch (e) {}
+				return;
+			}
+			for (const entry of entries) if (entry.isDirectory() && entry.name !== "node_modules" && !entry.name.startsWith(".")) await scan((0, node_path.join)(dir, entry.name), depth + 1);
+		} catch (e) {}
+	}
+	await scan(packagesDir);
+	return installed;
+}
+const builtInPlugins = async (options) => {
+	console.debug("[Plugins] Starting background plugin loading...");
+	sendStartupProgress("Preparing environment...");
+	const envStart = Date.now();
+	await Promise.all([ensureNodeJS(options.context), ensurePNPM(options.context)]);
+	console.debug(`[Plugins] Environment preparation took ${Date.now() - envStart}ms`);
+	const { usePlugins } = await import("@pipelab/shared");
+	const { registerPlugins } = usePlugins();
+	const { webSocketServer } = await Promise.resolve().then(() => require("./index.cjs"));
+	webSocketServer.broadcast("startup:progress", { type: "ready" });
+	return (async () => {
+		const totalStart = Date.now();
+		const pluginsToLoad = /* @__PURE__ */ new Map();
+		for (const name of [
+			"@pipelab/plugin-construct",
+			"@pipelab/plugin-filesystem",
+			"@pipelab/plugin-system",
+			"@pipelab/plugin-steam",
+			"@pipelab/plugin-itch",
+			"@pipelab/plugin-electron",
+			"@pipelab/plugin-discord",
+			"@pipelab/plugin-poki",
+			"@pipelab/plugin-nvpatch",
+			"@pipelab/plugin-tauri",
+			"@pipelab/plugin-minify",
+			"@pipelab/plugin-netlify"
+		]) pluginsToLoad.set(name, "latest");
+		if (isDev && projectRoot) {
+			const pluginsDir = (0, node_path.join)(projectRoot, "plugins");
+			if ((0, node_fs.existsSync)(pluginsDir)) try {
+				const entries = await (0, node_fs_promises.readdir)(pluginsDir, { withFileTypes: true });
+				for (const entry of entries) if (entry.isDirectory()) {
+					const pkgPath = (0, node_path.join)(pluginsDir, entry.name, "package.json");
+					if ((0, node_fs.existsSync)(pkgPath)) try {
+						const pkgContent = await (0, node_fs_promises.readFile)(pkgPath, "utf-8");
+						const pkg = JSON.parse(pkgContent);
+						if (pkg.name && pkg.name.startsWith("@pipelab/plugin-") && pkg.name !== "@pipelab/plugin-core") pluginsToLoad.set(pkg.name, "local");
+					} catch (e) {
+						console.error(`[Plugins] Failed to parse package.json for ${entry.name}:`, e);
+					}
+				}
+			} catch (e) {
+				console.error(`[Plugins] Failed to scan local workspace plugins directory:`, e);
+			}
+		}
+		try {
+			const { setupSettingsConfigFile } = await Promise.resolve().then(() => require("./config-CAz_XbPS.cjs")).then((n) => n.config_exports);
+			const settingsPlugins = (await (await setupSettingsConfigFile(options.context)).getConfig())?.plugins || [];
+			for (const plugin of settingsPlugins) if (plugin.name) if (plugin.enabled) {
+				if (!pluginsToLoad.has(plugin.name)) pluginsToLoad.set(plugin.name, "latest");
+			} else pluginsToLoad.delete(plugin.name);
+		} catch (e) {
+			console.error(`[Plugins] Failed to load settings config on startup:`, e);
+		}
+		const pluginList = Array.from(pluginsToLoad.keys()).map((p) => `  - ${p}`).join("\n");
+		console.log(`\n[Plugins] Loading plugins in background:\n${pluginList}\n`);
+		const loadPromises = Array.from(pluginsToLoad.entries()).map(async ([packageName, version]) => {
+			sendStartupProgress(`Loading plugin: ${packageName}`);
+			const pluginStart = Date.now();
+			try {
+				const plugin = await loadCustomPlugin(packageName, version, options);
+				if (plugin) {
+					registerPlugins([plugin]);
+					webSocketServer.broadcast("plugin:loaded", { plugin });
+					console.debug(`[Plugins] Loaded ${packageName}@${version} in ${Date.now() - pluginStart}ms`);
+				}
+			} catch (err) {
+				console.error(`[Plugins] Failed to load plugin ${packageName} at startup:`, err);
+			}
+		});
+		await Promise.all(loadPromises);
+		console.log(`\n[Plugins] All startup plugins loaded in ${Date.now() - totalStart}ms.\n`);
+		sendStartupProgress("All plugins loaded.");
+		setTimeout(() => {
+			webSocketServer.broadcast("startup:progress", { type: "done" });
+		}, 2e3);
+	})();
+};
+//#endregion
 //#region src/handlers/plugins.ts
 const localPluginsMap = /* @__PURE__ */ new Map();
 if (isDev && projectRoot) {
@@ -11008,23 +11007,12 @@ const registerPluginsHandlers = (context) => {
 				if (p.packageName !== packageName) return false;
 				if (mappedVersion === "latest") return true;
 				return p.version === mappedVersion;
-			})) continue;
-			try {
-				console.log(`[Plugins] JIT loading plugin "${packageName}@${mappedVersion}" for pipeline...`);
-				const plugin = await loadCustomPlugin(packageName, mappedVersion, { context });
-				if (plugin) {
-					registerPlugins([plugin]);
-					webSocketServer.broadcast("plugin:loaded", { plugin });
-					loaded.push(packageName);
-					console.log(`[Plugins] JIT loaded "${packageName}" successfully.`);
-				} else {
-					console.warn(`[Plugins] JIT load for "${packageName}" returned no plugin.`);
-					failed.push(packageName);
-				}
-			} catch (e) {
-				console.error(`[Plugins] JIT load failed for "${packageName}":`, e);
-				failed.push(packageName);
+			})) {
+				loaded.push(packageName);
+				continue;
 			}
+			console.warn(`[Plugins] Plugin "${packageName}" is required but not loaded at startup.`);
+			failed.push(packageName);
 		}
 		send({
 			type: "end",
@@ -11531,7 +11519,8 @@ const registerAllHandlers = async (options) => {
 	registerPluginsHandlers(context);
 	registerMigrationHandlers(context);
 	const { registerPlugins } = (0, _pipelab_shared.usePlugins)();
-	builtInPlugins({ context });
+	const pluginsPromise = builtInPlugins({ context });
+	if (options.waitForPlugins) await pluginsPromise;
 };
 //#endregion
 //#region ../../node_modules/klona/dist/index.mjs
@@ -53804,7 +53793,8 @@ async function runPipelineCommand(file, options, version) {
 	});
 	await registerAllHandlers({
 		version,
-		context
+		context,
+		waitForPlugins: true
 	});
 	const cachePath = context.getCachePath(CacheFolder.Pipelines, effectivePipelineId);
 	await (0, node_fs_promises.mkdir)(cachePath, { recursive: true });