@powerlines/engine 0.43.31 → 0.44.1

package/dist/_internal/worker.cjs

@@ -27,10 +27,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-let _powerlines_core_lib_logger = require("@powerlines/core/lib/logger");
 let _powerlines_core_lib_utilities_file_header = require("@powerlines/core/lib/utilities/file-header");
 let _powerlines_core_lib_utilities_format = require("@powerlines/core/lib/utilities/format");
 let _powerlines_core_plugin_utils = require("@powerlines/core/plugin-utils");
+let _powerlines_core_plugin_utils_logging = require("@powerlines/core/plugin-utils/logging");
 let _storm_software_config_tools_logger_console = require("@storm-software/config-tools/logger/console");
 let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_fs_copy_file = require("@stryke/fs/copy-file");
@@ -63,12 +63,10 @@ let defu = require("defu");
 defu = __toESM(defu, 1);
 let handlebars = require("handlebars");
 handlebars = __toESM(handlebars, 1);
-let _powerlines_core = require("@powerlines/core");
 let _powerlines_core_constants = require("@powerlines/core/constants");
 let _stryke_fs_json = require("@stryke/fs/json");
 let _stryke_helpers_deep_clone = require("@stryke/helpers/deep-clone");
 let _stryke_path_join = require("@stryke/path/join");
-let _stryke_type_checks_is_null = require("@stryke/type-checks/is-null");
 let _stryke_unique_id_uuid = require("@stryke/unique-id/uuid");
 let _powerlines_core_lib_entry = require("@powerlines/core/lib/entry");
 let _stryke_fs_get_workspace_root = require("@stryke/fs/get-workspace-root");
@@ -83,7 +81,7 @@ let flat_cache = require("flat-cache");
 let oxc_parser = require("oxc-parser");
 let undici = require("undici");
 require("@stryke/fs/remove-file");
-let _storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let _powerlines_core = require("@powerlines/core");
 let _stryke_capnp = require("@stryke/capnp");
 _stryke_capnp = __toESM(_stryke_capnp, 1);
 let _stryke_fs_buffer = require("@stryke/fs/buffer");
@@ -201,6 +199,40 @@ async function writeMetaFile(context) {
 	await context.fs.write(metaFilePath, JSON.stringify(context.meta, null, 2));
 }
 
+//#endregion
+//#region src/_internal/ipc/send.ts
+function sendWriteLogMessage(context, type, message) {
+	const meta = {
+		...(0, _stryke_type_checks_is_set_object.isSetObject)(message) && (0, _stryke_type_checks_is_set_object.isSetObject)(message.meta) ? message.meta : {},
+		...context.logger.options
+	};
+	process.send?.({
+		id: (0, _stryke_unique_id_uuid.uuid)(),
+		type: "write-log",
+		executionId: meta.executionId ?? context.config.executionId,
+		executionIndex: meta.executionIndex ?? context.config.executionIndex,
+		environment: meta.environment,
+		timestamp: Date.now(),
+		payload: {
+			meta: {
+				type,
+				category: meta.category ?? _powerlines_core.LogCategories.GENERAL,
+				logId: meta.logId ?? (0, _stryke_unique_id_uuid.uuid)(),
+				timestamp: meta.timestamp ?? Date.now(),
+				name: meta.name ?? context.config.name,
+				executionId: meta.executionId ?? context.config.executionId,
+				executionIndex: meta.executionIndex ?? context.config.executionIndex,
+				command: meta.command ?? context.config.command,
+				hook: meta.hook,
+				environment: meta.environment,
+				plugin: meta.plugin,
+				source: meta.source
+			},
+			message: (0, _stryke_type_checks_is_set_string.isSetString)(message) ? message : message.message
+		}
+	});
+}
+
 //#endregion
 //#region schemas/fs.ts
 var FileMetadata_KeyValuePair = class extends _stryke_capnp.Struct {
@@ -1018,9 +1050,9 @@ var VirtualFileSystem = class VirtualFileSystem {
 	*/
 	#context;
 	/**
-	* The file system's logging function.
+	* The file system's logger client utility.
 	*/
-	#log;
+	#logger;
 	/**
 	* Normalizes a given module id by resolving it against the built-ins path.
 	*
@@ -1234,7 +1266,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 				}
 			}));
 		} else result = new VirtualFileSystem(context, new _stryke_capnp.Message().initRoot(FileSystem));
-		result.#log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, "Successfully completed virtual file system (VFS) initialization.");
+		result.#logger.debug("Successfully completed virtual file system (VFS) initialization.");
 		return result;
 	}
 	/**
@@ -1268,7 +1300,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 				}
 			});
 		} else result = new VirtualFileSystem(context, new _stryke_capnp.Message().initRoot(FileSystem));
-		result.#log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, "Successfully completed virtual file system (VFS) initialization.");
+		result.#logger.debug("Successfully completed virtual file system (VFS) initialization.");
 		return result;
 	}
 	/**
@@ -1402,7 +1434,10 @@ var VirtualFileSystem = class VirtualFileSystem {
 				return ret;
 			}, {});
 		}
-		this.#log = context.extendLog("VFS");
+		this.#logger = context.extendLogger({
+			source: "VFS",
+			category: "fs"
+		});
 	}
 	/**
 	* Asynchronously checks if a file exists in the virtual file system (VFS).
@@ -1529,7 +1564,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	listSync(path) {
 		let resolvedPath = path;
 		if (resolvedPath.includes("*")) {
-			this.#log(_storm_software_config_tools_types.LogLevelLabel.WARN, `Invoking "listSync" with a glob pattern is not supported. It is likely you meant to use "globSync". Path: ${path}`);
+			this.#logger.warn(`Invoking "listSync" with a glob pattern is not supported. It is likely you meant to use "globSync". Path: ${path}`);
 			resolvedPath = (0, _stryke_path_correct_path.stripStars)(resolvedPath);
 		}
 		return (0, _stryke_helpers_get_unique.getUnique)(this.#getStorages(resolvedPath, true).map((storage) => storage.adapter.listSync(storage.relativeBase ? storage.base ? (0, _stryke_path_append.appendPath)(storage.relativeBase, storage.base) : storage.relativeBase : storage.base)).flat().filter(Boolean));
@@ -1543,7 +1578,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	async list(path) {
 		let resolvedPath = path;
 		if (resolvedPath.includes("*")) {
-			this.#log(_storm_software_config_tools_types.LogLevelLabel.WARN, `Invoking "list" with a glob pattern is not supported. It is likely you meant to use "glob". Path: ${path}`);
+			this.#logger.warn(`Invoking "list" with a glob pattern is not supported. It is likely you meant to use "glob". Path: ${path}`);
 			resolvedPath = (0, _stryke_path_correct_path.stripStars)(resolvedPath);
 		}
 		return (0, _stryke_helpers_get_unique.getUnique)((await Promise.all(this.#getStorages(resolvedPath, true).map(async (storage) => storage.adapter.list(storage.relativeBase ? storage.base ? (0, _stryke_path_append.appendPath)(storage.relativeBase, storage.base) : storage.relativeBase : storage.base)))).flat().filter(Boolean));
@@ -1555,7 +1590,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	*/
 	async remove(path) {
 		const normalizedPath = this.#normalizePath(path);
-		this.#log(_storm_software_config_tools_types.LogLevelLabel.TRACE, `Removing file: ${normalizedPath}`);
+		this.#logger.trace(`Removing file: ${normalizedPath}`);
 		const { relativeKey, adapter } = this.#getStorage(normalizedPath);
 		if ((0, _stryke_path_file_path_fns.hasFileExtension)(normalizedPath)) await adapter.remove(relativeKey);
 		else await adapter.clear(relativeKey);
@@ -1573,7 +1608,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	*/
 	removeSync(path) {
 		const normalizedPath = this.#normalizePath(path);
-		this.#log(_storm_software_config_tools_types.LogLevelLabel.TRACE, `Removing file: ${normalizedPath}`);
+		this.#logger.trace(`Removing file: ${normalizedPath}`);
 		const { relativeKey, adapter } = this.#getStorage(normalizedPath);
 		if ((0, _stryke_path_file_path_fns.hasFileExtension)(normalizedPath)) adapter.removeSync(relativeKey);
 		else adapter.clearSync(relativeKey);
@@ -1719,7 +1754,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(_storm_software_config_tools_types.LogLevelLabel.TRACE, `Reading ${adapter.name} file: ${filePath}`);
+		this.#logger.trace(`Reading ${adapter.name} file: ${filePath}`);
 		return await adapter.get(filePath) ?? void 0;
 	}
 	/**
@@ -1732,7 +1767,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(_storm_software_config_tools_types.LogLevelLabel.TRACE, `Reading ${adapter.name} file: ${filePath}`);
+		this.#logger.trace(`Reading ${adapter.name} file: ${filePath}`);
 		return adapter.getSync(filePath) ?? void 0;
 	}
 	/**
@@ -1747,15 +1782,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(_storm_software_config_tools_types.LogLevelLabel.TRACE, `Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)(new node_buffer.Blob((0, _stryke_convert_to_array.toArray)(data)).size)})`);
+		this.#logger.trace(`Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)(new node_buffer.Blob((0, _stryke_convert_to_array.toArray)(data)).size)})`);
 		let code = data;
 		try {
 			if (!options.skipFormat) code = await (0, _powerlines_core_lib_utilities_format.format)(this.#context, resolvedPath, data);
 		} catch (err) {
-			if (DEFAULT_EXTENSIONS.includes((0, _stryke_path_file_path_fns.findFileExtensionSafe)(resolvedPath, { fullExtension: true }))) this.#log(_storm_software_config_tools_types.LogLevelLabel.WARN, `Failed to format file ${resolvedPath} before writing: ${err.message}`);
+			if (DEFAULT_EXTENSIONS.includes((0, _stryke_path_file_path_fns.findFileExtensionSafe)(resolvedPath, { fullExtension: true }))) this.#logger.warn(`Failed to format file ${resolvedPath} before writing: ${err.message}`);
 			code = data;
 		}
-		this.#log(_storm_software_config_tools_types.LogLevelLabel.TRACE, `Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)(new node_buffer.Blob((0, _stryke_convert_to_array.toArray)(code)).size)})`);
+		this.#logger.trace(`Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)(new node_buffer.Blob((0, _stryke_convert_to_array.toArray)(code)).size)})`);
 		const id = this.#normalizeId(meta.id || resolvedPath);
 		this.metadata[id] = {
 			type: "normal",
@@ -1778,7 +1813,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(_storm_software_config_tools_types.LogLevelLabel.TRACE, `Writing ${resolvedPath} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)(new node_buffer.Blob((0, _stryke_convert_to_array.toArray)(data)).size)})`);
+		this.#logger.trace(`Writing ${resolvedPath} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)(new node_buffer.Blob((0, _stryke_convert_to_array.toArray)(data)).size)})`);
 		const id = this.#normalizeId(meta.id || resolvedPath);
 		this.metadata[id] = {
 			type: "normal",
@@ -1942,7 +1977,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	async dispose() {
 		if (!this.#isDisposed) {
 			this.#isDisposed = true;
-			this.#log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, "Disposing virtual file system...");
+			this.#logger.debug("Disposing virtual file system...");
 			await this.remove((0, _stryke_path_join.joinPaths)(this.#context.dataPath, "fs.bin"));
 			const message = new _stryke_capnp.Message();
 			const fs = message.initRoot(FileSystem);
@@ -1977,9 +2012,15 @@ var VirtualFileSystem = class VirtualFileSystem {
 			await (0, _stryke_fs_buffer.writeFileBuffer)((0, _stryke_path_join.joinPaths)(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(_storm_software_config_tools_types.LogLevelLabel.TRACE, "Virtual file system has been disposed.");
+			this.#logger.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();
 	}
@@ -2152,7 +2193,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
 	*/
@@ -2174,27 +2214,22 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	*/
 	configFile;
 	/**
+	* The logger instance for the context, which can be used to create log messages with consistent formatting and metadata. This logger is extended by plugin contexts to include additional metadata such as the plugin name and category, which can be used to filter and format log messages in a more granular way.
+	*/
+	get logger() {
+		return this.createLogger({
+			...this.configFile.config,
+			...this.options
+		});
+	}
+	/**
 	* 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;
-	}
-	/**
-	* 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 (0, _powerlines_core_plugin_utils.resolveLogLevel)(this.options.logLevel, this.options.mode);
 	}
 	/**
 	* The environment paths for the project
@@ -2225,7 +2260,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	fatal(message) {
-		this.log(_storm_software_config_tools_types.LogLevelLabel.FATAL, (0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
+		this.logger.error((0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
 	}
 	/**
 	* A logging function for error messages
@@ -2233,7 +2268,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	error(message) {
-		this.log(_storm_software_config_tools_types.LogLevelLabel.ERROR, (0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
+		this.logger.error((0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
 	}
 	/**
 	* A logging function for warning messages
@@ -2241,7 +2276,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	warn(message) {
-		this.log(_storm_software_config_tools_types.LogLevelLabel.WARN, (0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
+		this.logger.warn((0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
 	}
 	/**
 	* A logging function for informational messages
@@ -2249,7 +2284,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	info(message) {
-		this.log(_storm_software_config_tools_types.LogLevelLabel.INFO, (0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
+		this.logger.info((0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
 	}
 	/**
 	* A logging function for debug messages
@@ -2257,7 +2292,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	debug(message) {
-		this.log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, (0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
+		this.logger.debug((0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
 	}
 	/**
 	* A logging function for trace messages
@@ -2265,7 +2300,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 	* @param message - The message to log.
 	*/
 	trace(message) {
-		this.log(_storm_software_config_tools_types.LogLevelLabel.TRACE, (0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
+		this.logger.trace((0, _stryke_type_checks_is_string.isString)(message) ? message : _stryke_json_storm_json.StormJSON.stringify(message));
 	}
 	/**
 	* A function to create a timer for measuring the duration of asynchronous operations
@@ -2285,35 +2320,31 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 		const startDuration = performance.now();
 		return () => {
 			const duration = performance.now() - startDuration;
-			this.log(_storm_software_config_tools_types.LogLevelLabel.PERFORMANCE, `${chalk.default.bold.cyanBright(name)} completed in ${chalk.default.bold.cyanBright(duration < 1e3 ? `${duration.toFixed(2)} milliseconds` : (0, date_fns_formatDistanceToNowStrict.formatDistanceToNowStrict)(startDate))}`);
+			this.logger.info({
+				meta: { category: "performance" },
+				message: `${chalk.default.bold.cyanBright(name)} completed in ${chalk.default.bold.cyanBright(duration < 1e3 ? `${duration.toFixed(2)} milliseconds` : (0, date_fns_formatDistanceToNowStrict.formatDistanceToNowStrict)(startDate))}`
+			});
 		};
 	}
 	/**
 	* Create a new logger instance
 	*
-	* @param source - The source name to use for the logger instance, which can be used to identify the origin of log messages in the logs for better traceability. This is typically the name of the plugin or module that is creating the logger instance.
-	* @returns A logger function
+	* @param options - 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 client instance that can be used to generate log messages with consistent formatting and metadata.
 	*/
-	createLog(source = null) {
-		return (0, _powerlines_core_lib_logger.createLog)(source, {
-			...this.options,
-			logLevel: (0, _stryke_type_checks_is_null.isNull)(this.logLevel) ? "silent" : this.logLevel
-		});
+	createLogger(options, callback) {
+		return (0, _powerlines_core_plugin_utils_logging.createLogger)(this.options.name || this.options.framework || "powerlines", options, callback);
 	}
 	/**
-	* Extend the current logger instance with a new source
+	* Extend the base logger with additional configuration options
 	*
-	* @param source - The source name to use for the extended logger instance, which can be used to identify the origin of log messages in the logs for better traceability. This is typically the name of the plugin or module that is creating the logger instance.
-	* @returns A logger function
+	* @param options - The configuration options to extend the base logger with, which can be used to add additional metadata or customize the appearance of log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance, as well as any additional metadata such as the plugin category or environment.
+	* @returns A new logger client instance that extends the base logger with the provided configuration options.
 	*/
-	extendLog(source) {
-		return (0, _powerlines_core_lib_logger.extendLog)(this.log, source);
+	extendLogger(options) {
+		return (0, _powerlines_core_plugin_utils_logging.extendLogger)(this.logger, options);
 	}
 	/**
-	* A logger function specific to this context
-	*/
-	logger;
-	/**
 	* Initialize the context with the provided configuration options
 	*
 	* @remarks
@@ -2322,7 +2353,7 @@ 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 (0, _stryke_fs_resolve.resolvePackage)("powerlines");
 			if (!powerlinesPath) throw new Error("Could not resolve `powerlines` package location.");
@@ -2334,6 +2365,7 @@ var PowerlinesBaseContext = class PowerlinesBaseContext {
 			root,
 			cwd,
 			mode: options.mode,
+			logLevel: options.logLevel,
 			framework: options.framework,
 			organization: options.organization,
 			configFile: options.configFile
@@ -2495,7 +2527,7 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 			buildId: this.#buildId,
 			releaseId: this.#releaseId,
 			checksum: this.#checksum,
-			timestamp: this.timestamp.getTime(),
+			timestamp: this.timestamp,
 			rootHash: (0, _stryke_hash.murmurhash)({
 				workspaceRoot: this.options?.cwd,
 				root: this.config?.root
@@ -2599,6 +2631,18 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		}, {}) : this.config.resolve.alias : {});
 	}
 	/**
+	* The logger instance for the context, which can be used to create log messages with consistent formatting and metadata. This logger is extended by plugin contexts to include additional metadata such as the plugin name and category, which can be used to filter and format log messages in a more granular way.
+	*/
+	get logger() {
+		const options = {
+			...this.config,
+			...this.options
+		};
+		const logger = (0, _powerlines_core_plugin_utils.withLogger)((0, _powerlines_core_plugin_utils.createLogger)(this.config.name, options), (0, _powerlines_core_plugin_utils.createLogger)(this.config.name, options, (type, message) => sendWriteLogMessage(this, type, message)));
+		if (this.config.customLogger) return (0, _powerlines_core_plugin_utils.withCustomLogger)(logger, this.config.customLogger);
+		return logger;
+	}
+	/**
 	* Gets the parser cache.
 	*/
 	get parserCache() {
@@ -2695,6 +2739,9 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 				headers: cached.headers
 			});
 		}
+		const logger = this.extendLogger({ category: "network" });
+		const startTime = Date.now();
+		logger.trace(`Sending fetch request (${options.method?.toUpperCase() || "GET"}): ${input.toString()}`);
 		const response = await (0, _stryke_http_fetch.fetchRequest)(input, {
 			timeout: 12e3,
 			...options
@@ -2708,6 +2755,7 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		if (!this.config.skipCache && !options.skipCache) try {
 			this.requestCache.set(cacheKey, result);
 		} catch {}
+		logger.trace(`Fetch request (${options.method?.toUpperCase() || "GET"}) completed in ${Date.now() - startTime}ms: ${input.toString()} - ${response.status} / ${response.statusText} \n - Response Headers: ${JSON.stringify(result.headers)}\n - Response Body: ${typeof result.body === "string" ? result.body.length > 1e3 ? `${result.body.slice(0, 1e3)}... (truncated, total length: ${result.body.length})` : result.body : "[Non-string body]"}`);
 		return new undici.Response(result.body, {
 			status: result.status,
 			statusText: result.statusText,
@@ -3062,6 +3110,7 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 	*/
 	async init(options = {}) {
 		await super.init(options);
+		this.options.executionId = options.executionId ?? this.options.executionId;
 		this.options.executionIndex = options.executionIndex ?? this.options.executionIndex ?? 0;
 		const projectJsonPath = (0, _stryke_path_join.joinPaths)(this.options.cwd, this.options.root, "project.json");
 		if ((0, _stryke_fs_exists.existsSync)(projectJsonPath)) this.projectJson = await (0, _stryke_fs_json.readJsonFile)(projectJsonPath);
@@ -3082,6 +3131,13 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 	* Initialize the context with the provided configuration options
 	*/
 	async innerSetup() {
+		const logger = this.extendLogger({ category: "config" });
+		logger.debug(`Pre-setup Powerlines configuration object: \n${JSON.stringify({
+			...(0, _stryke_helpers_omit.omit)(this.config, ["plugins"]),
+			userConfig: this.config.userConfig ? (0, _stryke_helpers_omit.omit)(this.config.userConfig, ["plugins"]) : {},
+			inlineConfig: this.config.inlineConfig ? (0, _stryke_helpers_omit.omit)(this.config.inlineConfig, ["plugins"]) : {},
+			pluginConfig: this.config.pluginConfig ? (0, _stryke_helpers_omit.omit)(this.config.pluginConfig, ["plugins"]) : {}
+		}, null, 2)}`);
 		if (!this.inputOptions.mode && !this.config.userConfig?.mode && !this.config.inlineConfig?.mode && !this.config.pluginConfig?.mode) {
 			this.options.mode = "production";
 			this.config.mode = "production";
@@ -3091,10 +3147,6 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 			this.config.framework = "powerlines";
 		}
 		this.resolvedConfig.compatibilityDate = (0, compatx.resolveCompatibilityDates)(this.config.inlineConfig.compatibilityDate ?? this.config.userConfig.compatibilityDate ?? this.config.pluginConfig.compatibilityDate, "latest");
-		this.logger = {
-			log: this.createLog(this.config.name),
-			level: (0, _stryke_type_checks_is_null.isNull)(this.logLevel) ? "silent" : this.logLevel
-		};
 		this.config.input = (0, _powerlines_core_lib_entry.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 ??= (0, _stryke_string_format_title_case.titleCase)(this.config.name);
@@ -3107,11 +3159,12 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 			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 = _powerlines_core_constants.DEFAULT_DEVELOPMENT_LOG_LEVEL;
+		else if (this.config.mode === "test") this.config.logLevel = _powerlines_core_constants.DEFAULT_TEST_LOG_LEVEL;
+		else this.config.logLevel = _powerlines_core_constants.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 = (0, _stryke_path_replace.replacePath)((0, _powerlines_core_plugin_utils.replacePathTokens)(this, this.config.tsconfig), this.config.cwd);
-		this.resolvedConfig.output = (0, defu.default)(this.resolvedConfig.output ?? {}, {
+		this.resolvedConfig.output = (0, defu.default)(this.config.output ?? {}, {
 			path: (0, _stryke_path_join.joinPaths)(this.config.root, "dist"),
 			copy: { assets: [
 				{ glob: "LICENSE" },
@@ -3156,6 +3209,12 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		}));
 		if ((0, _stryke_type_checks_is_set_string.isSetString)(this.config.output?.storage) && this.config.output.storage === "virtual" || (0, _stryke_type_checks_is_set_object.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);
+		logger.debug(`Post-setup Powerlines configuration object: \n${JSON.stringify({
+			...(0, _stryke_helpers_omit.omit)(this.config, ["plugins"]),
+			userConfig: this.config.userConfig ? (0, _stryke_helpers_omit.omit)(this.config.userConfig, ["plugins"]) : {},
+			inlineConfig: this.config.inlineConfig ? (0, _stryke_helpers_omit.omit)(this.config.inlineConfig, ["plugins"]) : {},
+			pluginConfig: this.config.pluginConfig ? (0, _stryke_helpers_omit.omit)(this.config.pluginConfig, ["plugins"]) : {}
+		}, null, 2)}`);
 	}
 };
 
@@ -3205,7 +3264,7 @@ function mergeConfigs(currentResult, previousResults) {
 async function callHook(context, key, options, ...args) {
 	const hooks = context.selectHooks(key, options);
 	if (hooks.length > 0) {
-		context.debug(` 🧩 Calling ${hooks.length} ${chalk.default.bold.cyanBright(`${key}${options?.order ? ` (${options.order})` : ""}`)} plugin hook${hooks.length > 1 ? "s" : ""}:\n${hooks.map((hook, index) => ` ${index + 1}. ${(0, _powerlines_core_lib_logger.colorText)(hook.plugin.name)}`).join("\n")}`);
+		context.extendLogger({ category: "hooks" }).debug(` 🧩 Calling ${hooks.length} ${chalk.default.bold.cyanBright(`${key}${options?.order ? ` (${options.order})` : ""}`)} plugin hook${hooks.length > 1 ? "s" : ""}:\n${hooks.map((hook, index) => ` ${index + 1}. ${(0, _powerlines_core_plugin_utils_logging.colorText)(hook.plugin.name)}`).join("\n")}`);
 		const invokeHook = async (hook, hookArgs) => {
 			return Reflect.apply(hook.handler, hook.context, hookArgs);
 		};
@@ -3305,7 +3364,7 @@ function createPluginContext(pluginId, plugin, environment) {
 	const normalizeMessage = (message) => {
 		return (0, _stryke_type_checks_is_string.isString)(message) ? message : message.message;
 	};
-	const log = environment.extendLog(pluginId, plugin.name.replaceAll(":", " - "));
+	const logger = environment.extendLogger({ plugin: plugin.name.replaceAll(":", " - ") });
 	const callHookFn = async (hook, options, ...args) => {
 		return environment.$$internal.api.callHook(hook, {
 			sequential: true,
@@ -3324,24 +3383,24 @@ function createPluginContext(pluginId, plugin, environment) {
 				meta
 			};
 			if (prop === "id") return pluginId;
-			if (prop === "log" || prop === "logger") return log;
+			if (prop === "logger") return logger;
 			if (prop === "fatal") return (message) => {
-				log(_storm_software_config_tools_types.LogLevelLabel.FATAL, normalizeMessage(message));
+				logger.error(normalizeMessage(message));
 			};
 			if (prop === "error") return (message) => {
-				log(_storm_software_config_tools_types.LogLevelLabel.ERROR, normalizeMessage(message));
+				logger.error(normalizeMessage(message));
 			};
 			if (prop === "warn") return (message) => {
-				log(_storm_software_config_tools_types.LogLevelLabel.WARN, normalizeMessage(message));
+				logger.warn(normalizeMessage(message));
 			};
 			if (prop === "info") return (message) => {
-				log(_storm_software_config_tools_types.LogLevelLabel.INFO, normalizeMessage(message));
+				logger.info(normalizeMessage(message));
 			};
 			if (prop === "debug") return (message) => {
-				log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, normalizeMessage(message));
+				logger.debug(normalizeMessage(message));
 			};
 			if (prop === "trace") return (message) => {
-				log(_storm_software_config_tools_types.LogLevelLabel.TRACE, normalizeMessage(message));
+				logger.trace(normalizeMessage(message));
 			};
 			return environment[prop];
 		},
@@ -3360,7 +3419,7 @@ function createPluginContext(pluginId, plugin, environment) {
 				"addPlugin",
 				"selectHooks"
 			].includes(prop)) {
-				log(_storm_software_config_tools_types.LogLevelLabel.WARN, `Cannot set read-only property "${String(prop)}"`);
+				logger.warn(`Cannot set the read-only "${String(prop)}" property`);
 				return false;
 			}
 			environment[prop] = value;
@@ -3414,50 +3473,26 @@ var PowerlinesEnvironmentContext = class PowerlinesEnvironmentContext extends Po
 	/**
 	* Create a new logger instance
 	*
-	* @param source - The source name to use for the logger instance, which can be used to identify the origin of log messages in the logs for better traceability. This is typically the name of the plugin or module that is creating the logger instance.
-	* @returns A logger function
-	*/
-	createLog(source = null) {
-		return (level, ...args) => {
-			process.send?.({
-				id: (0, _stryke_unique_id_uuid.uuid)(),
-				type: "write-log",
-				executionId: this.options.executionId,
-				executionIndex: this.options.executionIndex,
-				timestamp: Date.now(),
-				payload: {
-					level,
-					source,
-					environment: this.environment?.name,
-					args
-				}
-			});
-		};
+	* @param options - 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 client instance that can be used to generate log messages with consistent formatting and metadata.
+	*/
+	createLogger(options, callback) {
+		return super.createLogger({
+			...options,
+			environment: this.environment?.name
+		}, callback);
 	}
 	/**
-	* Extend the current logger instance with a new name
-	*
-	* @param source - The name of the source to use for the extended logger instance
-	* @param plugin - An optional plugin name to use for the extended logger instance, which can be used to identify the origin of log messages in the logs for better traceability. This is typically the name of the plugin or module that is creating the logger instance.
-	* @returns A logger function
-	*/
-	extendLog(source, plugin) {
-		return (level, ...args) => {
-			process.send?.({
-				id: (0, _stryke_unique_id_uuid.uuid)(),
-				type: "write-log",
-				executionId: this.options.executionId,
-				executionIndex: this.options.executionIndex,
-				timestamp: Date.now(),
-				payload: {
-					level,
-					source,
-					plugin,
-					environment: this.environment?.name,
-					args
-				}
-			});
-		};
+	* Extend the base logger with additional configuration options
+	*
+	* @param options - The configuration options to extend the base logger with, which can be used to add additional metadata or customize the appearance of log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance, as well as any additional metadata such as the plugin category or environment.
+	* @returns A new logger client instance that extends the base logger with the provided configuration options.
+	*/
+	extendLogger(options) {
+		return super.extendLogger({
+			...options,
+			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.
@@ -3643,29 +3678,28 @@ var PowerlinesExecutionContext = class PowerlinesExecutionContext extends Powerl
 	/**
 	* Create a new logger instance
 	*
-	* @param source - The source name to use for the logger instance, which can be used to identify the origin of log messages in the logs for better traceability. This is typically the name of the plugin or module that is creating the logger instance.
-	* @returns A logger function
+	* @param options - 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 client instance that can be used to generate log messages with consistent formatting and metadata.
 	*/
-	createLog(source = null) {
-		const logger = (0, _powerlines_core.createLog)(source, {
-			...this.config,
-			logLevel: (0, _stryke_type_checks_is_null.isNull)(this.config.logLevel) ? "silent" : this.config.logLevel
+	createLogger(options, callback) {
+		return super.createLogger({
+			...options,
+			executionId: this.id,
+			executionIndex: this.options.executionIndex
+		}, callback);
+	}
+	/**
+	* Extend the base logger with additional configuration options
+	*
+	* @param options - The configuration options to extend the base logger with, which can be used to add additional metadata or customize the appearance of log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance, as well as any additional metadata such as the plugin category or environment.
+	* @returns A new logger client instance that extends the base logger with the provided configuration options.
+	*/
+	extendLogger(options) {
+		return super.extendLogger({
+			...options,
+			executionId: this.id,
+			executionIndex: this.options.executionIndex
 		});
-		return (level, ...args) => {
-			logger(level, ...args);
-			process.send?.({
-				id: (0, _stryke_unique_id_uuid.uuid)(),
-				type: "write-log",
-				executionId: this.id,
-				executionIndex: this.options.executionIndex,
-				timestamp: Date.now(),
-				payload: {
-					source,
-					level,
-					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.
@@ -4531,7 +4565,7 @@ ${formatTypes(code)}
 		const timer = api.context.timer("Initialization");
 		for (const plugin of api.context.config.plugins.flatMap((p) => (0, _stryke_convert_to_array.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} ${(0, _stryke_string_format_title_case.titleCase)(api.context.config.framework)} plugin${api.context.plugins.length > 1 ? "s" : ""}: \n${api.context.plugins.map((plugin, index) => ` ${index + 1}. ${(0, _powerlines_core_lib_logger.colorText)(plugin.name)}`).join("\n")}`);
+		else api.context.info(`Loaded ${api.context.plugins.length} ${(0, _stryke_string_format_title_case.titleCase)(api.context.config.framework)} plugin${api.context.plugins.length > 1 ? "s" : ""}: \n${api.context.plugins.map((plugin, index) => ` ${index + 1}. ${(0, _powerlines_core_plugin_utils_logging.colorText)(plugin.name)}`).join("\n")}`);
 		const pluginConfig = await api.callHook("config", {
 			environment: await api.context.getEnvironment(),
 			sequential: true,
@@ -4871,44 +4905,28 @@ ${formatTypes(code)}
 //#endregion
 //#region src/_internal/worker.ts
 async function clean({ options, config }) {
-	const execution = await PowerlinesExecution.fromConfig(options, config);
-	await execution.clean(config);
-	await execution.finalize();
+	await (await PowerlinesExecution.fromConfig(options, config)).clean(config);
 }
 async function prepare({ options, config }) {
-	const execution = await PowerlinesExecution.fromConfig(options, config);
-	await execution.prepare(config);
-	await execution.finalize();
+	await (await PowerlinesExecution.fromConfig(options, config)).prepare(config);
 }
 async function types({ options, config }) {
-	const execution = await PowerlinesExecution.fromConfig(options, config);
-	await execution.types(config);
-	await execution.finalize();
+	await (await PowerlinesExecution.fromConfig(options, config)).types(config);
 }
 async function lint({ options, config }) {
-	const execution = await PowerlinesExecution.fromConfig(options, config);
-	await execution.lint(config);
-	await execution.finalize();
+	await (await PowerlinesExecution.fromConfig(options, config)).lint(config);
 }
 async function test({ options, config }) {
-	const execution = await PowerlinesExecution.fromConfig(options, config);
-	await execution.test(config);
-	await execution.finalize();
+	await (await PowerlinesExecution.fromConfig(options, config)).test(config);
 }
 async function build({ options, config }) {
-	const execution = await PowerlinesExecution.fromConfig(options, config);
-	await execution.build(config);
-	await execution.finalize();
+	await (await PowerlinesExecution.fromConfig(options, config)).build(config);
 }
 async function docs({ options, config }) {
-	const execution = await PowerlinesExecution.fromConfig(options, config);
-	await execution.docs(config);
-	await execution.finalize();
+	await (await PowerlinesExecution.fromConfig(options, config)).docs(config);
 }
 async function deploy({ options, config }) {
-	const execution = await PowerlinesExecution.fromConfig(options, config);
-	await execution.deploy(config);
-	await execution.finalize();
+	await (await PowerlinesExecution.fromConfig(options, config)).deploy(config);
 }
 
 //#endregion