@powerlines/engine 0.43.30 → 0.44.0

package/dist/_internal/worker.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env -S NODE_OPTIONS=--enable-source-maps node
-import { colorText, createLog, extendLog } from "@powerlines/core/lib/logger";
+import { colorText, createLogFn, extendLogFn } from "@powerlines/core/lib/logger";
 import { getFileHeaderWarningText, getTypescriptFileHeader } from "@powerlines/core/lib/utilities/file-header";
 import { format, formatFolder } from "@powerlines/core/lib/utilities/format";
-import { addPluginHook, dedupeHooklist, findInvalidPluginConfig, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, mergeConfig, replacePathTokens } from "@powerlines/core/plugin-utils";
+import { addPluginHook, dedupeHooklist, findInvalidPluginConfig, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, mergeConfig, replacePathTokens, resolveLogLevel } from "@powerlines/core/plugin-utils";
 import { formatLogMessage } from "@storm-software/config-tools/logger/console";
 import { toArray } from "@stryke/convert/to-array";
 import { copyFiles } from "@stryke/fs/copy-file";
@@ -32,10 +32,12 @@ import { isString } from "@stryke/type-checks/is-string";
 import chalk from "chalk";
 import defu, { createDefu, defu as defu$1 } from "defu";
 import Handlebars from "handlebars";
-import { CACHE_HASH_LENGTH, DEFAULT_ENVIRONMENT, GLOBAL_ENVIRONMENT, PLUGIN_NON_HOOK_FIELDS, ROOT_HASH_LENGTH } from "@powerlines/core/constants";
+import { CACHE_HASH_LENGTH, DEFAULT_DEVELOPMENT_LOG_LEVEL, DEFAULT_ENVIRONMENT, DEFAULT_PRODUCTION_LOG_LEVEL, DEFAULT_TEST_LOG_LEVEL, GLOBAL_ENVIRONMENT, PLUGIN_NON_HOOK_FIELDS, ROOT_HASH_LENGTH } from "@powerlines/core/constants";
 import { readJsonFile, readJsonFileSync } from "@stryke/fs/json";
 import { deepClone } from "@stryke/helpers/deep-clone";
 import { joinPaths as joinPaths$1 } from "@stryke/path/join";
+import { uuid } from "@stryke/unique-id/uuid";
+import { createLogFn as createLogFn$1, extendLogFn as extendLogFn$1 } from "@powerlines/core";
 import { getUniqueInputs, isTypeDefinition, resolveInputsSync } from "@powerlines/core/lib/entry";
 import { relativeToWorkspaceRoot } from "@stryke/fs/get-workspace-root";
 import { murmurhash } from "@stryke/hash";
@@ -43,15 +45,12 @@ import { hashDirectory } from "@stryke/hash/node";
 import { fetchRequest } from "@stryke/http/fetch";
 import { isEqual } from "@stryke/path/is-equal";
 import { kebabCase } from "@stryke/string-format/kebab-case";
-import { isNull } from "@stryke/type-checks/is-null";
-import { uuid } from "@stryke/unique-id/uuid";
 import { match, tsconfigPathsToRegExp } from "bundle-require";
 import { resolveCompatibilityDates } from "compatx";
 import { create } from "flat-cache";
 import { parse } from "oxc-parser";
 import { Agent, Response, interceptors, setGlobalDispatcher } from "undici";
 import "@stryke/fs/remove-file";
-import { LogLevelLabel } from "@storm-software/config-tools/types";
 import * as $ from "@stryke/capnp";
 import { readFileBuffer, readFileBufferSync, writeFileBuffer } from "@stryke/fs/buffer";
 import { correctPath, stripStars } from "@stryke/path/correct-path";
@@ -82,6 +81,7 @@ import { getObjectDiff } from "@donedeal0/superdiff";
 //#region src/_internal/helpers/environment.ts
 function createEnvironment(name, config = {}) {
 	return defu(config.environments?.[name] ?? {}, {
+		environmentId: uuid(),
 		name,
 		title: config.title ?? titleCase(config.name),
 		ssr: false,
@@ -1199,7 +1199,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 				}
 			}));
 		} else result = new VirtualFileSystem(context, new $.Message().initRoot(FileSystem));
-		result.#log(LogLevelLabel.DEBUG, "Successfully completed virtual file system (VFS) initialization.");
+		result.#log("debug", "Successfully completed virtual file system (VFS) initialization.");
 		return result;
 	}
 	/**
@@ -1233,7 +1233,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 				}
 			});
 		} else result = new VirtualFileSystem(context, new $.Message().initRoot(FileSystem));
-		result.#log(LogLevelLabel.DEBUG, "Successfully completed virtual file system (VFS) initialization.");
+		result.#log("debug", "Successfully completed virtual file system (VFS) initialization.");
 		return result;
 	}
 	/**
@@ -1367,7 +1367,10 @@ var VirtualFileSystem = class VirtualFileSystem {
 				return ret;
 			}, {});
 		}
-		this.#log = extendLog(this.#context.log, "file-system");
+		this.#log = context.extendLog({
+			source: "VFS",
+			category: "fs"
+		});
 	}
 	/**
 	* Asynchronously checks if a file exists in the virtual file system (VFS).
@@ -1494,7 +1497,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	listSync(path) {
 		let resolvedPath = path;
 		if (resolvedPath.includes("*")) {
-			this.#log(LogLevelLabel.WARN, `Invoking "listSync" with a glob pattern is not supported. It is likely you meant to use "globSync". Path: ${path}`);
+			this.#log("warn", `Invoking "listSync" with a glob pattern is not supported. It is likely you meant to use "globSync". Path: ${path}`);
 			resolvedPath = stripStars(resolvedPath);
 		}
 		return getUnique(this.#getStorages(resolvedPath, true).map((storage) => storage.adapter.listSync(storage.relativeBase ? storage.base ? appendPath(storage.relativeBase, storage.base) : storage.relativeBase : storage.base)).flat().filter(Boolean));
@@ -1508,7 +1511,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	async list(path) {
 		let resolvedPath = path;
 		if (resolvedPath.includes("*")) {
-			this.#log(LogLevelLabel.WARN, `Invoking "list" with a glob pattern is not supported. It is likely you meant to use "glob". Path: ${path}`);
+			this.#log("warn", `Invoking "list" with a glob pattern is not supported. It is likely you meant to use "glob". Path: ${path}`);
 			resolvedPath = stripStars(resolvedPath);
 		}
 		return getUnique((await Promise.all(this.#getStorages(resolvedPath, true).map(async (storage) => storage.adapter.list(storage.relativeBase ? storage.base ? appendPath(storage.relativeBase, storage.base) : storage.relativeBase : storage.base)))).flat().filter(Boolean));
@@ -1520,7 +1523,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	*/
 	async remove(path) {
 		const normalizedPath = this.#normalizePath(path);
-		this.#log(LogLevelLabel.TRACE, `Removing file: ${normalizedPath}`);
+		this.#log("trace", `Removing file: ${normalizedPath}`);
 		const { relativeKey, adapter } = this.#getStorage(normalizedPath);
 		if (hasFileExtension(normalizedPath)) await adapter.remove(relativeKey);
 		else await adapter.clear(relativeKey);
@@ -1538,7 +1541,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	*/
 	removeSync(path) {
 		const normalizedPath = this.#normalizePath(path);
-		this.#log(LogLevelLabel.TRACE, `Removing file: ${normalizedPath}`);
+		this.#log("trace", `Removing file: ${normalizedPath}`);
 		const { relativeKey, adapter } = this.#getStorage(normalizedPath);
 		if (hasFileExtension(normalizedPath)) adapter.removeSync(relativeKey);
 		else adapter.clearSync(relativeKey);
@@ -1684,7 +1687,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const filePath = await this.resolve(path, void 0, { isFile: true });
 		if (!filePath || !this.existsSync(filePath)) return;
 		const { adapter } = this.#getStorage(filePath);
-		this.#log(LogLevelLabel.TRACE, `Reading ${adapter.name} file: ${filePath}`);
+		this.#log("trace", `Reading ${adapter.name} file: ${filePath}`);
 		return await adapter.get(filePath) ?? void 0;
 	}
 	/**
@@ -1697,7 +1700,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const filePath = this.resolveSync(path, void 0, { isFile: true });
 		if (!filePath || !this.existsSync(filePath)) return;
 		const { adapter } = this.#getStorage(filePath);
-		this.#log(LogLevelLabel.TRACE, `Reading ${adapter.name} file: ${filePath}`);
+		this.#log("trace", `Reading ${adapter.name} file: ${filePath}`);
 		return adapter.getSync(filePath) ?? void 0;
 	}
 	/**
@@ -1712,15 +1715,15 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const meta = options.meta ?? {};
 		const resolvedPath = await this.resolve(this.#normalizePath(path)) || path;
 		const { relativeKey, adapter } = this.#getStorage(resolvedPath, options.storage);
-		this.#log(LogLevelLabel.TRACE, `Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob$1(toArray(data)).size)})`);
+		this.#log("trace", `Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob$1(toArray(data)).size)})`);
 		let code = data;
 		try {
 			if (!options.skipFormat) code = await format(this.#context, resolvedPath, data);
 		} catch (err) {
-			if (DEFAULT_EXTENSIONS.includes(findFileExtensionSafe(resolvedPath, { fullExtension: true }))) this.#log(LogLevelLabel.WARN, `Failed to format file ${resolvedPath} before writing: ${err.message}`);
+			if (DEFAULT_EXTENSIONS.includes(findFileExtensionSafe(resolvedPath, { fullExtension: true }))) this.#log("warn", `Failed to format file ${resolvedPath} before writing: ${err.message}`);
 			code = data;
 		}
-		this.#log(LogLevelLabel.TRACE, `Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob$1(toArray(code)).size)})`);
+		this.#log("trace", `Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob$1(toArray(code)).size)})`);
 		const id = this.#normalizeId(meta.id || resolvedPath);
 		this.metadata[id] = {
 			type: "normal",
@@ -1743,7 +1746,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const meta = options.meta ?? {};
 		const resolvedPath = this.resolveSync(this.#normalizePath(path)) || path;
 		const { relativeKey, adapter } = this.#getStorage(resolvedPath, options.storage);
-		this.#log(LogLevelLabel.TRACE, `Writing ${resolvedPath} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob$1(toArray(data)).size)})`);
+		this.#log("trace", `Writing ${resolvedPath} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob$1(toArray(data)).size)})`);
 		const id = this.#normalizeId(meta.id || resolvedPath);
 		this.metadata[id] = {
 			type: "normal",
@@ -1907,7 +1910,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	async dispose() {
 		if (!this.#isDisposed) {
 			this.#isDisposed = true;
-			this.#log(LogLevelLabel.DEBUG, "Disposing virtual file system...");
+			this.#log("debug", "Disposing virtual file system...");
 			await this.remove(joinPaths$1(this.#context.dataPath, "fs.bin"));
 			const message = new $.Message();
 			const fs = message.initRoot(FileSystem);
@@ -1942,9 +1945,15 @@ var VirtualFileSystem = class VirtualFileSystem {
 			await writeFileBuffer(joinPaths$1(this.#context.dataPath, "fs.bin"), message.toArrayBuffer());
 			if (!this.#context.config.skipCache) this.resolverCache.save(true);
 			await Promise.all(this.#getStorages().map(async (storage) => storage.adapter.dispose()));
-			this.#log(LogLevelLabel.TRACE, "Virtual file system has been disposed.");
+			this.#log("trace", "Virtual file system has been disposed.");
 		}
 	}
+	/**
+	* Asynchronously disposes of the virtual file system (VFS) by saving its state to disk.
+	*
+	* @remarks
+	* This method is automatically called when the VFS instance is used within a `using` block, or can be manually invoked to ensure that the VFS state is saved and resources are cleaned up properly.
+	*/
 	async [Symbol.asyncDispose]() {
 		return this.dispose();
 	}
@@ -2117,7 +2126,6 @@ function createResolver(options) {
 //#region src/context/base-context.ts
 var PowerlinesBaseContext = class PowerlinesBaseContext {
 	#timestamp = Date.now();
-	#logLevel = "info";
 	/**
 	* The path to the Powerlines package
 	*/
@@ -2142,24 +2150,16 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* A timestamp representing when the context was initialized
 	*/
 	get timestamp() {
-		return new Date(this.#timestamp);
+		return this.#timestamp;
 	}
 	get logLevel() {
-		return this.#logLevel || "info";
-	}
-	set logLevel(level) {
-		this.#logLevel = level;
+		return resolveLogLevel(this.options.logLevel, this.options.mode);
 	}
 	/**
 	* The logger function
 	*/
 	get log() {
-		const level = this.logLevel || "info";
-		if (!this.logger || this.logger.level !== level) this.logger = {
-			log: this.createLog(),
-			level
-		};
-		return this.logger.log;
+		return this.createLog();
 	}
 	/**
 	* The environment paths for the project
@@ -2190,7 +2190,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	fatal(message) {
-		this.log(LogLevelLabel.FATAL, isString(message) ? message : StormJSON.stringify(message));
+		this.log("error", isString(message) ? message : StormJSON.stringify(message));
 	}
 	/**
 	* A logging function for error messages
@@ -2198,7 +2198,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	error(message) {
-		this.log(LogLevelLabel.ERROR, isString(message) ? message : StormJSON.stringify(message));
+		this.log("error", isString(message) ? message : StormJSON.stringify(message));
 	}
 	/**
 	* A logging function for warning messages
@@ -2206,7 +2206,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	warn(message) {
-		this.log(LogLevelLabel.WARN, isString(message) ? message : StormJSON.stringify(message));
+		this.log("warn", isString(message) ? message : StormJSON.stringify(message));
 	}
 	/**
 	* A logging function for informational messages
@@ -2214,7 +2214,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	info(message) {
-		this.log(LogLevelLabel.INFO, isString(message) ? message : StormJSON.stringify(message));
+		this.log("info", isString(message) ? message : StormJSON.stringify(message));
 	}
 	/**
 	* A logging function for debug messages
@@ -2222,7 +2222,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	debug(message) {
-		this.log(LogLevelLabel.DEBUG, isString(message) ? message : StormJSON.stringify(message));
+		this.log("debug", isString(message) ? message : StormJSON.stringify(message));
 	}
 	/**
 	* A logging function for trace messages
@@ -2230,7 +2230,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	trace(message) {
-		this.log(LogLevelLabel.TRACE, isString(message) ? message : StormJSON.stringify(message));
+		this.log("trace", isString(message) ? message : StormJSON.stringify(message));
 	}
 	/**
 	* A function to create a timer for measuring the duration of asynchronous operations
@@ -2250,29 +2250,32 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 		const startDuration = performance.now();
 		return () => {
 			const duration = performance.now() - startDuration;
-			this.log(LogLevelLabel.PERFORMANCE, `${chalk.bold.cyanBright(name)} completed in ${chalk.bold.cyanBright(duration < 1e3 ? `${duration.toFixed(2)} milliseconds` : formatDistanceToNowStrict(startDate))}`);
+			this.log({
+				level: "info",
+				category: "performance"
+			}, `${chalk.bold.cyanBright(name)} completed in ${chalk.bold.cyanBright(duration < 1e3 ? `${duration.toFixed(2)} milliseconds` : formatDistanceToNowStrict(startDate))}`);
 		};
 	}
 	/**
 	* Create a new logger instance
 	*
-	* @param name - The name to use for the logger instance
+	* @param config - The configuration options to use for the logger instance, which can be used to customize the appearance and behavior of the log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance.
 	* @returns A logger function
 	*/
-	createLog(name = null) {
-		return createLog(name, {
+	createLog(config) {
+		return createLogFn({
 			...this.options,
-			logLevel: isNull(this.logLevel) ? "silent" : this.logLevel
+			...config
 		});
 	}
 	/**
-	* Extend the current logger instance with a new name
+	* Extend the current logger instance with a new source
 	*
-	* @param name - The name to use for the extended logger instance
-	* @returns A logger function
+	* @param config - The overlay metadata to use for the badge in the log output, which can be used to customize the appearance and behavior of the log messages generated by the extended logger. This typically includes the name of the plugin or module that is creating the logger instance, and can also include other metadata such as the command or environment.
+	* @returns A new logger function that includes the badge in its output.
 	*/
-	extendLog(name) {
-		return extendLog(this.log, name);
+	extendLog(config) {
+		return extendLogFn(this.log, config);
 	}
 	/**
 	* A logger function specific to this context
@@ -2287,18 +2290,19 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param options - The configuration options to initialize the context with
 	*/
 	async init(options = {}) {
-		this.inputOptions = options;
+		this.inputOptions = { ...options };
 		if (!this.powerlinesPath) {
 			const powerlinesPath = await resolvePackage("powerlines");
 			if (!powerlinesPath) throw new Error("Could not resolve `powerlines` package location.");
 			this.powerlinesPath = powerlinesPath;
 		}
 		const cwd = options.cwd || this.options?.cwd || process.cwd();
-		const root = (options.root || this.options?.root) && (options.root || this.options.root).replace(/^\.\/?/, "") && !isEqual(options.root || this.options.root, cwd) ? options.root || this.options.root : ".";
+		const root = replacePath((options.root || this.options?.root) && (options.root || this.options.root).replace(/^\.\/?/, "") && !isEqual(options.root || this.options.root, cwd) ? options.root || this.options.root : ".", cwd);
 		this.options = defu({
 			root,
 			cwd,
 			mode: options.mode,
+			logLevel: options.logLevel,
 			framework: options.framework,
 			organization: options.organization,
 			configFile: options.configFile
@@ -2460,7 +2464,7 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 			buildId: this.#buildId,
 			releaseId: this.#releaseId,
 			checksum: this.#checksum,
-			timestamp: this.timestamp.getTime(),
+			timestamp: this.timestamp,
 			rootHash: murmurhash({
 				workspaceRoot: this.options?.cwd,
 				root: this.config?.root
@@ -2618,6 +2622,60 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		this.options = options;
 	}
 	/**
+	* Create a new log function with the specified configuration, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
+	*
+	* @param config - Optional configuration for the log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
+	* @returns A log function that can be used to log messages with the specified configuration.
+	*/
+	createLog(config) {
+		const log = createLogFn$1({
+			...config,
+			logLevel: this.logLevel
+		});
+		return (meta, ...args) => {
+			log(meta, ...args);
+			process.send?.({
+				id: uuid(),
+				type: "write-log",
+				executionId: config?.executionId ?? this.options.executionId,
+				executionIndex: config?.executionIndex ?? this.options.executionIndex,
+				timestamp: Date.now(),
+				payload: {
+					level: meta && isSetObject(meta) && isSetString(meta.level) ? meta.level : isSetString(meta) ? meta : "info",
+					...config,
+					args
+				}
+			});
+		};
+	}
+	/**
+	* Extend the current log function instance with a new name
+	*
+	* @param config - The configuration for the extended log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the log function instance according to your needs.
+	* @returns A log function
+	*/
+	extendLog(config) {
+		const log = extendLogFn$1(this.log, {
+			...config,
+			logLevel: this.logLevel
+		});
+		return (meta, ...args) => {
+			log(meta, ...args);
+			process.send?.({
+				id: uuid(),
+				type: "write-log",
+				executionId: config.executionId ?? this.options.executionId,
+				executionIndex: config.executionIndex ?? this.options.executionIndex,
+				timestamp: Date.now(),
+				payload: {
+					level: meta && isSetObject(meta) && isSetString(meta.level) ? meta.level : isSetString(meta) ? meta : "info",
+					...config,
+					args
+				}
+			});
+		};
+	}
+	/**
 	* Creates a clone of the current context with the same configuration and workspace settings. This can be useful for running multiple builds in parallel or for creating isolated contexts for different parts of the build process.
 	*
 	* @remarks
@@ -2626,22 +2684,10 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 	* @returns A promise that resolves to the cloned context.
 	*/
 	async clone() {
-		const clone = await PowerlinesContext.fromOptions(this.config);
+		const clone = await PowerlinesContext.fromOptions(this.options);
 		return this.copyTo(clone);
 	}
 	/**
-	* Create a new logger instance
-	*
-	* @param name - The name to use for the logger instance
-	* @returns A logger function
-	*/
-	createLog(name = null) {
-		return createLog(name, {
-			...this.config,
-			logLevel: isNull(this.logLevel) ? "silent" : this.logLevel
-		});
-	}
-	/**
 	* A function to perform HTTP fetch requests
 	*
 	* @remarks
@@ -3017,6 +3063,7 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		for (const [key, value] of Object.entries(this)) if (!SKIP_CLONING_PROPS.includes(key)) if (isObject(value) || Array.isArray(value)) context[key] = deepClone(value);
 		else context[key] = value;
 		context.inputOptions = deepClone(this.inputOptions);
+		context.options = deepClone(this.options);
 		context.dependencies = deepClone(this.dependencies);
 		context.devDependencies = deepClone(this.devDependencies);
 		context.persistedMeta = this.persistedMeta ? deepClone(this.persistedMeta) : void 0;
@@ -3038,7 +3085,8 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 	*/
 	async init(options = {}) {
 		await super.init(options);
-		this.options.configIndex = options.configIndex ?? this.options.configIndex ?? 0;
+		this.options.executionId = options.executionId ?? this.options.executionId;
+		this.options.executionIndex = options.executionIndex ?? this.options.executionIndex ?? 0;
 		const projectJsonPath = joinPaths$1(this.options.cwd, this.options.root, "project.json");
 		if (existsSync(projectJsonPath)) this.projectJson = await readJsonFile(projectJsonPath);
 		const packageJsonPath = joinPaths$1(this.options.cwd, this.options.root, "package.json");
@@ -3047,7 +3095,7 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 			this.options.organization ??= isSetObject(this.packageJson?.author) ? kebabCase(this.packageJson?.author?.name) : kebabCase(this.packageJson?.author);
 		}
 		this.#checksum = await this.generateChecksum(joinPaths$1(this.options.cwd, this.options.root));
-		const userConfig = this.configFile.config ? Array.isArray(this.configFile.config) && this.configFile.config.length > this.options.configIndex ? this.configFile.config[this.options.configIndex] : this.configFile.config : {};
+		const userConfig = this.configFile.config ? Array.isArray(this.configFile.config) && this.configFile.config.length > this.options.executionIndex ? this.configFile.config[this.options.executionIndex] : this.configFile.config : {};
 		this.resolvedConfig = {
 			...this.options,
 			...userConfig,
@@ -3067,10 +3115,6 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 			this.config.framework = "powerlines";
 		}
 		this.resolvedConfig.compatibilityDate = resolveCompatibilityDates(this.config.inlineConfig.compatibilityDate ?? this.config.userConfig.compatibilityDate ?? this.config.pluginConfig.compatibilityDate, "latest");
-		this.logger = {
-			log: this.createLog(this.config.name),
-			level: isNull(this.logLevel) ? "silent" : this.logLevel
-		};
 		this.config.input = getUniqueInputs(this.config.input);
 		if (this.config.name?.startsWith("@") && this.config.name.split("/").filter(Boolean).length > 1) this.config.name = this.config.name.split("/").filter(Boolean)[1];
 		this.config.title ??= titleCase(this.config.name);
@@ -3078,16 +3122,17 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		if (this.config.userConfig.resolve?.noExternal) this.config.userConfig.resolve.noExternal = getUnique(this.config.userConfig.resolve.noExternal);
 		if (this.config.resolve.external) this.config.resolve.external = getUnique(this.config.resolve.external);
 		if (this.config.resolve.noExternal) this.config.resolve.noExternal = getUnique(this.config.resolve.noExternal);
-		this.config.plugins = (this.config.plugins ?? []).filter(Boolean).reduce((ret, plugin) => {
+		this.config.plugins = (this.config.plugins ?? []).flatMap((plugin) => toArray(plugin)).filter(Boolean).reduce((ret, plugin) => {
 			if (isPlugin(plugin) && isDuplicate(plugin, ret.filter((p) => isPlugin(p)))) return ret;
 			ret.push(plugin);
 			return ret;
 		}, []);
-		if (!this.config.userConfig?.logLevel && !this.config.inlineConfig?.logLevel) if (this.config.mode === "development") this.config.logLevel = "debug";
-		else this.config.logLevel = "info";
-		if (!this.config.userConfig?.tsconfig && !this.config.inlineConfig?.tsconfig) this.config.tsconfig = getTsconfigFilePath(this.options.cwd, this.options.root);
+		if (!this.config.userConfig?.logLevel && !this.config.inlineConfig?.logLevel) if (this.config.mode === "development") this.config.logLevel = DEFAULT_DEVELOPMENT_LOG_LEVEL;
+		else if (this.config.mode === "test") this.config.logLevel = DEFAULT_TEST_LOG_LEVEL;
+		else this.config.logLevel = DEFAULT_PRODUCTION_LOG_LEVEL;
+		if (!this.config.userConfig?.tsconfig && !this.config.inlineConfig?.tsconfig) this.config.tsconfig = getTsconfigFilePath(this.config.cwd, this.config.root);
 		else if (this.config.tsconfig) this.config.tsconfig = replacePath(replacePathTokens(this, this.config.tsconfig), this.config.cwd);
-		this.resolvedConfig.output = defu(this.resolvedConfig.output ?? {}, {
+		this.resolvedConfig.output = defu(this.config.output ?? {}, {
 			path: joinPaths$1(this.config.root, "dist"),
 			copy: { assets: [
 				{ glob: "LICENSE" },
@@ -3110,7 +3155,7 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 			if (!this.config.root.replace(/^\.\/?/, "")) this.config.output.copy.path = this.config.output.copy.path ? appendPath(replacePathTokens(this, this.config.output.copy.path), this.config.cwd) : this.config.output.path;
 			else this.config.output.copy.path = appendPath(replacePathTokens(this, this.config.output.copy.path || joinPaths$1("dist", this.config.root)), this.config.cwd);
 		}
-		if (this.config.output.dts !== false && this.config.output.types !== false) this.config.output.types = appendPath(replacePathTokens(this, this.config.output.types || joinPaths$1(this.config.root, `${this.config.framework ?? "powerlines"}.d.ts`)), this.config.cwd);
+		if (this.config.output.dts !== false && this.config.output.types !== false) this.config.output.types = appendPath(replacePathTokens(this, this.config.userConfig?.output?.types || this.config.inlineConfig?.output?.types || this.config.pluginConfig?.output?.types || joinPaths$1(this.config.root, `${this.config.framework ?? "powerlines"}.d.ts`)), this.config.cwd);
 		if (this.config.output.copy && this.config.output.copy.path && this.config.output.copy.assets && Array.isArray(this.config.output.copy.assets)) this.config.output.copy.assets = getUniqueBy(this.config.output.copy.assets.map((asset) => {
 			return {
 				glob: isSetObject(asset) ? asset.glob : asset,
@@ -3132,6 +3177,7 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		}));
 		if (isSetString(this.config.output?.storage) && this.config.output.storage === "virtual" || isSetObject(this.config.output?.storage) && Object.values(this.config.output.storage).every((adapter) => adapter.preset === "virtual")) this.config.output.overwrite = true;
 		this.#fs ??= await VirtualFileSystem.create(this);
+		this.extendLog({ category: "config" })("debug", `Resolved Powerlines configuration object: \n${JSON.stringify(this.resolvedConfig, null, 2)}`);
 	}
 };
 
@@ -3272,15 +3318,16 @@ function extractHooks(context, hooks, plugin, key, parentKey) {
 /**
 * Create a Proxy-based PluginContext
 *
+* @param pluginId - The unique identifier of the plugin
 * @param plugin - The plugin instance
 * @param environment - The environment context
 * @returns The proxied plugin context
 */
-function createPluginContext(plugin, environment) {
+function createPluginContext(pluginId, plugin, environment) {
 	const normalizeMessage = (message) => {
 		return isString(message) ? message : message.message;
 	};
-	const log = environment.extendLog(plugin.name.replaceAll(":", " - "));
+	const log = environment.extendLog({ plugin: plugin.name.replaceAll(":", " - ") });
 	const callHookFn = async (hook, options, ...args) => {
 		return environment.$$internal.api.callHook(hook, {
 			sequential: true,
@@ -3298,30 +3345,32 @@ function createPluginContext(plugin, environment) {
 				callHook: callHookFn,
 				meta
 			};
+			if (prop === "id") return pluginId;
 			if (prop === "log" || prop === "logger") return log;
 			if (prop === "fatal") return (message) => {
-				log(LogLevelLabel.FATAL, normalizeMessage(message));
+				log("error", normalizeMessage(message));
 			};
 			if (prop === "error") return (message) => {
-				log(LogLevelLabel.ERROR, normalizeMessage(message));
+				log("error", normalizeMessage(message));
 			};
 			if (prop === "warn") return (message) => {
-				log(LogLevelLabel.WARN, normalizeMessage(message));
+				log("warn", normalizeMessage(message));
 			};
 			if (prop === "info") return (message) => {
-				log(LogLevelLabel.INFO, normalizeMessage(message));
+				log("info", normalizeMessage(message));
 			};
 			if (prop === "debug") return (message) => {
-				log(LogLevelLabel.DEBUG, normalizeMessage(message));
+				log("debug", normalizeMessage(message));
 			};
 			if (prop === "trace") return (message) => {
-				log(LogLevelLabel.TRACE, normalizeMessage(message));
+				log("trace", normalizeMessage(message));
 			};
 			return environment[prop];
 		},
 		set(_, prop, value) {
 			if ([
 				"$$internal",
+				"id",
 				"environment",
 				"config",
 				"log",
@@ -3333,7 +3382,7 @@ function createPluginContext(plugin, environment) {
 				"addPlugin",
 				"selectHooks"
 			].includes(prop)) {
-				log(LogLevelLabel.WARN, `Cannot set read-only property "${String(prop)}"`);
+				log("warn", `Cannot set read-only property "${String(prop)}"`);
 				return false;
 			}
 			environment[prop] = value;
@@ -3373,17 +3422,10 @@ var PowerlinesEnvironmentContext = class PowerlinesEnvironmentContext extends Po
 	*/
 	plugins = [];
 	/**
-	* Create a new logger instance
-	*
-	* @param name - The name to use for the logger instance
-	* @returns A logger function
+	* The unique identifier of the environment associated with this context, which can be used for logging and other purposes to distinguish between different environments in the same process.
 	*/
-	createLog(name = null) {
-		return createLog(name, {
-			...this.config,
-			logLevel: isNull(this.config.logLevel) ? "silent" : this.config.logLevel,
-			environment: this.environment?.name
-		});
+	get id() {
+		return this.environment.environmentId;
 	}
 	/**
 	* The hooks registered by plugins in this environment
@@ -3392,6 +3434,30 @@ var PowerlinesEnvironmentContext = class PowerlinesEnvironmentContext extends Po
 		return this.#hooks;
 	}
 	/**
+	* Create a new log function with the specified configuration, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
+	*
+	* @param config - Optional configuration for the log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
+	* @returns A log function that can be used to log messages with the specified configuration.
+	*/
+	createLog(config) {
+		return super.createLog({
+			...config,
+			environment: this.environment?.name
+		});
+	}
+	/**
+	* Extend the current log function instance with a new name
+	*
+	* @param config - The configuration for the extended log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the log function instance according to your needs.
+	* @returns A log function
+	*/
+	extendLog(config) {
+		return super.extendLog({
+			...config,
+			environment: this.environment?.name
+		});
+	}
+	/**
 	* Creates a clone of the current context with the same configuration and workspace settings. This can be useful for running multiple builds in parallel or for creating isolated contexts for different parts of the build process.
 	*
 	* @remarks
@@ -3421,8 +3487,10 @@ var PowerlinesEnvironmentContext = class PowerlinesEnvironmentContext extends Po
 			if (isPluginConfig(result)) return this.$$internal.addPlugin(result);
 			resolvedPlugin = isPlugin(result) ? result : plugin;
 		}
-		const context = createPluginContext(resolvedPlugin, this);
+		const pluginId = uuid();
+		const context = createPluginContext(pluginId, resolvedPlugin, this);
 		this.plugins.push({
+			pluginId,
 			plugin: resolvedPlugin,
 			context
 		});
@@ -3548,6 +3616,12 @@ var PowerlinesExecutionContext = class PowerlinesExecutionContext extends Powerl
 		for (const environment of Object.values(this.environments)) environment.$$internal = super.$$internal;
 	}
 	/**
+	* The unique identifier of the execution context, which can be used for logging and other purposes to distinguish between different executions in the same process.
+	*/
+	get id() {
+		return this.options.executionId;
+	}
+	/**
 	* A record of all environments by name
 	*/
 	get environments() {
@@ -3565,6 +3639,32 @@ var PowerlinesExecutionContext = class PowerlinesExecutionContext extends Powerl
 		super(options);
 	}
 	/**
+	* Create a new log function with the specified configuration, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
+	*
+	* @param config - Optional configuration for the log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
+	* @returns A log function that can be used to log messages with the specified configuration.
+	*/
+	createLog(config) {
+		return super.createLog({
+			...config,
+			executionId: this.id,
+			executionIndex: this.options.executionIndex
+		});
+	}
+	/**
+	* Extend the current log function instance with a new name
+	*
+	* @param config - The configuration for the extended log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the log function instance according to your needs.
+	* @returns A log function
+	*/
+	extendLog(config) {
+		return super.extendLog({
+			...config,
+			executionId: this.id,
+			executionIndex: this.options.executionIndex
+		});
+	}
+	/**
 	* Creates a clone of the current context with the same configuration and workspace settings. This can be useful for running multiple builds in parallel or for creating isolated contexts for different parts of the build process.
 	*
 	* @remarks
@@ -4426,7 +4526,7 @@ ${formatTypes(code)}
 			addPlugin: api.addPlugin.bind(api)
 		};
 		const timer = api.context.timer("Initialization");
-		for (const plugin of api.context.config.plugins.flat(10) ?? []) await api.addPlugin(plugin);
+		for (const plugin of api.context.config.plugins.flatMap((p) => toArray(p)) ?? []) await api.addPlugin(plugin);
 		if (api.context.plugins.length === 0) api.context.warn("No Powerlines plugins were specified in the options. Please ensure this is correct, as it is generally not recommended.");
 		else api.context.info(`Loaded ${api.context.plugins.length} ${titleCase(api.context.config.framework)} plugin${api.context.plugins.length > 1 ? "s" : ""}: \n${api.context.plugins.map((plugin, index) => ` ${index + 1}. ${colorText(plugin.name)}`).join("\n")}`);
 		const pluginConfig = await api.callHook("config", {