fireflyy 4.0.0-dev.df58d2b → 4.0.0-dev.fc28987

package/dist/{program-CW3hIbzh.js → program-d3d_c7Hx.js}

@@ -1,80 +1,19 @@
-import { n as RuntimeEnv, t as logger } from "./main.js";
-import { _ as notFoundError, a as conflictErrAsync, b as wrapErrorMessage, c as invalidErrAsync, d as validationErr, f as validationErrAsync, h as failedError, i as FireflyOkAsync, l as notFoundErrAsync, n as FireflyErrAsync, p as conflictError, r as FireflyOk, s as invalidErr, t as FireflyErr, u as timeoutErrAsync, y as validationError } from "./result.constructors-D9jmQ0uj.js";
-import { n as wrapPromise, r as zip3Async, t as ensureNotAsync } from "./result.utilities-CdBL5noX.js";
-import { n as parseSchema, t as formatZodErrors } from "./schema.utilities-BOJqWEey.js";
+import { t as RuntimeEnv } from "./main.js";
+import { t as DebugFlags } from "./debug-flags-K3yK5B6O.js";
+import { _ as notFoundError, a as conflictErrAsync, b as wrapErrorMessage, c as invalidErrAsync, d as validationErr, f as validationErrAsync, h as failedError, i as FireflyOkAsync, l as notFoundErrAsync, n as FireflyErrAsync, o as failedErrAsync, p as conflictError, r as FireflyOk, s as invalidErr, t as FireflyErr, u as timeoutErrAsync, y as validationError } from "./result.constructors-DoAoYdfF.js";
+import { n as wrapPromise, t as ensureNotAsync } from "./result.utilities-DXSJU70_.js";
+import { t as logger } from "./logging-Bpk2RzGc.js";
+import { t as Version } from "./version-DJuocyXy.js";
+import { t as formatZodErrors } from "./schema.utilities-C1yimTtB.js";
+import { Command, InvalidArgumentError } from "commander";
 import { LogLevels } from "consola";
 import { colors } from "consola/utils";
-import { Command } from "commander";
 import { loadConfig } from "c12";
 import { Result, ResultAsync, err, ok } from "neverthrow";
 import z$1 from "zod";
 import { parse } from "semver";
 import * as path from "path";
 
-//#region src/core/environment/debug-flags.ts
-/**
-* Debug flags are environment variables prefixed with `FIREFLY_DEBUG_` that
-* enable diagnostic features during development and troubleshooting.
-*
-* @example
-* ```typescript
-* if (DebugFlags.showRawError) {
-*     logger.error(parseResult.error);
-* }
-* ```
-*/
-var DebugFlags = class {
-	constructor() {}
-	/**
-	* When enabled, displays raw Zod validation errors for configuration parsing.
-	*
-	* Useful for debugging configuration schema issues and understanding
-	* why validation failed at a granular level.
-	*/
-	static get showRawError() {
-		return Boolean(process.env.FIREFLY_DEBUG_SHOW_RAW_ERROR);
-	}
-	/**
-	* When enabled, logs the loaded configuration file contents.
-	*
-	* Useful for debugging configuration loading and understanding
-	* what values are being read from config files.
-	*/
-	static get showFileConfig() {
-		return Boolean(process.env.FIREFLY_DEBUG_SHOW_FILE_CONFIG);
-	}
-	/**
-	* When enabled, displays task graph statistics during release execution.
-	*
-	* Shows information about task dependencies, execution order,
-	* and graph structure for debugging workflow issues.
-	*/
-	static get showTaskGraphStats() {
-		return Boolean(process.env.FIREFLY_DEBUG_SHOW_TASK_GRAPH_STATS);
-	}
-	/**
-	* When enabled, prevents truncation of release notes in GitHub CLI logs.
-	*
-	* By default, release notes are truncated in logs to avoid pollution.
-	* Enable this flag to see full release notes content during debugging.
-	*/
-	static get dontTruncateReleaseNotes() {
-		return Boolean(process.env.FIREFLY_DEBUG_DONT_TRUNCATE_RELEASE_NOTES?.trim());
-	}
-	/**
-	* When enabled, prevents redaction of sensitive GitHub CLI arguments in logs.
-	*
-	* By default, sensitive values (tokens, passwords, etc.) are redacted.
-	* Enable this flag to see full argument values during debugging.
-	*
-	* WARNING: Use with caution as this may expose sensitive information.
-	*/
-	static get dontRedactGithubCliArgs() {
-		return Boolean(process.env.FIREFLY_DEBUG_DONT_REDACT_GITHUB_CLI_ARGS?.trim());
-	}
-};
-
-//#endregion
 //#region src/cli/config/config.loader.ts
 /**
 * Loads and resolves Firefly configuration from files.
@@ -184,6 +123,223 @@ function camelToKebab(str) {
 	return result.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase().replace(/_/g, "-");
 }
 
+//#endregion
+//#region src/cli/options/options.validation.ts
+/**
+* Extracts enum values from a Zod schema (handles wrapped types like optional, default).
+*
+* @param schema - The Zod schema to extract enum values from
+* @returns Array of string values if it's an enum, or null if not
+*/
+function extractEnumValues(schema) {
+	const unwrapped = unwrapZodSchema(schema);
+	if (unwrapped instanceof z$1.ZodEnum) return getEnumValuesFromZodEnum(unwrapped);
+	if (unwrapped instanceof z$1.ZodUnion) {
+		const unionOptions = getZodDef(unwrapped).options;
+		if (!unionOptions) return null;
+		const values = [];
+		for (const option of unionOptions) {
+			if (typeof option === "string") continue;
+			const innerUnwrapped = unwrapZodSchema(option);
+			if (innerUnwrapped instanceof z$1.ZodEnum) {
+				const enumValues = getEnumValuesFromZodEnum(innerUnwrapped);
+				if (enumValues) values.push(...enumValues);
+			} else if (innerUnwrapped instanceof z$1.ZodLiteral) {
+				const literalValue = getZodDef(innerUnwrapped).value;
+				if (typeof literalValue === "string" && literalValue !== "") values.push(literalValue);
+			}
+		}
+		return values.length > 0 ? values : null;
+	}
+	return null;
+}
+/**
+* Extracts enum values from a ZodEnum type.
+* Handles both Zod v4 (options array or entries object) and legacy (values array) structures.
+*
+* @param enumSchema - The ZodEnum schema
+* @returns Array of string values, or null if not found
+*/
+function getEnumValuesFromZodEnum(enumSchema) {
+	const schemaAsAny = enumSchema;
+	if (Array.isArray(schemaAsAny.options)) return schemaAsAny.options;
+	const def = getZodDef(enumSchema);
+	if (def.entries && typeof def.entries === "object") return Object.values(def.entries);
+	if (def.values && Array.isArray(def.values)) return def.values;
+	return null;
+}
+/**
+* Extracts literal values from a Zod union schema (e.g., z.union([z.literal("0"), z.literal("1")])).
+*
+* @param schema - The Zod schema to extract literal values from
+* @returns Array of literal values if it's a union of literals, or null if not
+*/
+function extractLiteralValues(schema) {
+	const unwrapped = unwrapZodSchema(schema);
+	if (unwrapped instanceof z$1.ZodUnion) {
+		const options = getZodDef(unwrapped).options;
+		if (!options) return null;
+		const values = [];
+		for (const option of options) {
+			if (typeof option === "string" || typeof option === "number") continue;
+			const innerUnwrapped = unwrapZodSchema(option);
+			if (innerUnwrapped instanceof z$1.ZodLiteral) {
+				const value = getZodDef(innerUnwrapped).value;
+				if (typeof value === "string" || typeof value === "number") values.push(value);
+			}
+		}
+		return values.length > 0 ? values : null;
+	}
+	return null;
+}
+/**
+* Creates a CLI option validator for enum fields.
+*
+* Commander.js requires throwing InvalidArgumentError for validation errors.
+* This is a boundary where exceptions are appropriate for the CLI framework.
+*
+* @param schema - The Zod schema for validation
+* @param optionName - The CLI option name (for error messages)
+* @param choices - The valid enum choices
+* @returns A parser function that throws InvalidArgumentError on failure
+*/
+function createEnumValidator(schema, optionName, choices) {
+	return (input) => {
+		const result = schema.safeParse(input);
+		if (!result.success) throw new InvalidArgumentError(`Invalid value for --${optionName}: "${input}". Must be one of: ${choices.join(", ")}`);
+		return result.data;
+	};
+}
+/**
+* Creates a CLI option validator for number fields.
+*
+* Commander.js requires throwing InvalidArgumentError for validation errors.
+* This is a boundary where exceptions are appropriate for the CLI framework.
+*
+* @param schema - The Zod schema for validation
+* @param optionName - The CLI option name (for error messages)
+* @returns A parser function that throws InvalidArgumentError on failure
+*/
+function createNumberValidator(schema, optionName) {
+	return (input) => {
+		const num = Number(input);
+		if (Number.isNaN(num)) throw new InvalidArgumentError(`Invalid number for --${optionName}: "${input}". Expected a valid number.`);
+		const result = schema.safeParse(num);
+		if (!result.success) throw new InvalidArgumentError(`Invalid value for --${optionName}: "${input}". ${formatZodErrorMessage(result.error)}`);
+		return result.data;
+	};
+}
+/**
+* Creates a CLI option validator for string fields.
+*
+* Commander.js requires throwing InvalidArgumentError for validation errors.
+* This is a boundary where exceptions are appropriate for the CLI framework.
+*
+* @param schema - The Zod schema for validation
+* @param optionName - The CLI option name (for error messages)
+* @returns A parser function that throws InvalidArgumentError on failure
+*/
+function createStringValidator(schema, optionName) {
+	return (input) => {
+		const result = schema.safeParse(input);
+		if (!result.success) throw new InvalidArgumentError(`Invalid value for --${optionName}: "${input}". ${formatZodErrorMessage(result.error)}`);
+		return result.data;
+	};
+}
+/**
+* Creates a CLI option validator for union types with literal values.
+*
+* Commander.js requires throwing InvalidArgumentError for validation errors.
+* This is a boundary where exceptions are appropriate for the CLI framework.
+*
+* @param schema - The Zod schema for validation
+* @param optionName - The CLI option name (for error messages)
+* @param values - The valid literal values
+* @returns A parser function that throws InvalidArgumentError on failure
+*/
+function createLiteralUnionValidator(schema, optionName, values) {
+	return (input) => {
+		const numericValues = values.filter((v) => typeof v === "number");
+		let parsedInput = input;
+		if (numericValues.length > 0 && !Number.isNaN(Number(input))) parsedInput = Number(input);
+		const result = schema.safeParse(parsedInput);
+		if (!result.success) throw new InvalidArgumentError(`Invalid value for --${optionName}: "${input}". Must be one of: ${values.map((v) => typeof v === "string" ? `"${v}"` : String(v)).join(", ")}`);
+		return result.data;
+	};
+}
+/**
+* Creates a generic CLI option validator.
+*
+* Commander.js requires throwing InvalidArgumentError for validation errors.
+* This is a boundary where exceptions are appropriate for the CLI framework.
+*
+* @param schema - The Zod schema for validation
+* @param optionName - The CLI option name (for error messages)
+* @returns A parser function that throws InvalidArgumentError on failure
+*/
+function createGenericValidator(schema, optionName) {
+	return (input) => {
+		const result = schema.safeParse(input);
+		if (!result.success) throw new InvalidArgumentError(`Invalid value for --${optionName}: "${input}". ${formatZodErrorMessage(result.error)}`);
+		return result.data;
+	};
+}
+/**
+* Formats a Zod error into a user-friendly message.
+*
+* @param error - The Zod error object
+* @returns A formatted error message
+*/
+function formatZodErrorMessage(error) {
+	const firstIssue = error.issues[0];
+	if (!firstIssue) return "Validation failed.";
+	switch (firstIssue.code) {
+		case "invalid_value": {
+			const issue = firstIssue;
+			if (issue.values) return `Expected one of: ${issue.values.join(", ")}`;
+			return firstIssue.message;
+		}
+		case "invalid_type": return `Expected ${firstIssue.expected}`;
+		case "too_small":
+		case "too_big": return firstIssue.message;
+		default: return firstIssue.message;
+	}
+}
+/**
+* Gets the internal definition object from a Zod type.
+* Handles both modern Zod v4 (_zod.def) and legacy (_def) structures.
+*
+* @param field - The Zod type to get the definition from
+* @returns The internal definition object
+*/
+function getZodDef(field) {
+	const zodContainer = field._zod;
+	if (zodContainer?.def) return zodContainer.def;
+	return field._def ?? {};
+}
+/**
+* Unwraps Zod wrapper types (optional, default, etc.) to get the inner type.
+*
+* @param field - The Zod type to unwrap
+* @returns The unwrapped inner type
+*/
+function unwrapZodSchema(field) {
+	const def = getZodDef(field);
+	if (field instanceof z$1.ZodDefault) {
+		const inner = def.innerType;
+		return inner ? unwrapZodSchema(inner) : field;
+	}
+	if (field instanceof z$1.ZodOptional) {
+		const inner = def.innerType;
+		return inner ? unwrapZodSchema(inner) : field;
+	}
+	if (field instanceof z$1.ZodNullable) {
+		const inner = def.innerType;
+		return inner ? unwrapZodSchema(inner) : field;
+	}
+	return field;
+}
+
 //#endregion
 //#region src/cli/options/options.builder.ts
 /**
@@ -304,15 +460,14 @@ var OptionsBuilder = class {
 		this.registerGenericOption(ctx);
 	}
 	/**
-	* Registers a number option with numeric parsing.
+	* Registers a number option with numeric parsing and validation.
 	*
 	* @param ctx - The option context
 	*/
 	registerNumberOption(ctx) {
 		const { command, rawField, optionFlag, optionName, description, parsedDefault } = ctx;
-		const parser = this.createNumberParser(rawField, optionName);
-		const wrappedParser = this.wrapParser(parser);
-		command.option(`${optionFlag} <${optionName}>`, description, wrappedParser, parsedDefault);
+		const validator = createNumberValidator(rawField, optionName);
+		command.option(`${optionFlag} <${optionName}>`, description, validator, parsedDefault);
 	}
 	/**
 	* Registers an enum option with choice validation.
@@ -320,111 +475,46 @@ var OptionsBuilder = class {
 	* @param ctx - The option context
 	*/
 	registerEnumOption(ctx) {
-		const { command, rawField, field, optionFlag, optionName, description, parsedDefault } = ctx;
-		const choices = this.getEnumChoices(field);
-		const parser = this.createEnumParser(rawField, optionName, choices);
-		const wrappedParser = this.wrapParser(parser);
+		const { command, rawField, optionFlag, optionName, description, parsedDefault } = ctx;
+		const choices = extractEnumValues(rawField) ?? [];
+		const validator = createEnumValidator(rawField, optionName, choices);
 		const fullDescription = `${description}${choices.length ? ` (choices: ${choices.join(", ")})` : ""}`;
-		command.option(`${optionFlag} <${optionName}>`, fullDescription, wrappedParser, parsedDefault);
+		command.option(`${optionFlag} <${optionName}>`, fullDescription, validator, parsedDefault);
 	}
 	/**
-	*  Registers a string option with validation.
+	* Registers a string option with validation.
 	*
 	* @param ctx - The option context
 	*/
 	registerStringOption(ctx) {
 		const { command, rawField, optionFlag, optionName, description, parsedDefault } = ctx;
-		const parser = this.createStringParser(rawField);
-		const wrappedParser = this.wrapParser(parser);
-		command.option(`${optionFlag} <${optionName}>`, description, wrappedParser, parsedDefault);
+		const validator = createStringValidator(rawField, optionName);
+		command.option(`${optionFlag} <${optionName}>`, description, validator, parsedDefault);
 	}
 	/**
 	* Registers a generic option for other Zod types.
+	* Handles union types with literal values specially for better error messages.
 	*
 	* @param ctx - The option context
 	*/
 	registerGenericOption(ctx) {
 		const { command, rawField, optionFlag, optionName, description, parsedDefault } = ctx;
-		const parser = this.createGenericParser(rawField);
-		const wrappedParser = this.wrapParser(parser);
-		command.option(`${optionFlag} <${optionName}>`, description, wrappedParser, parsedDefault);
-	}
-	/**
-	* Wraps a Result-returning parser into a Commander-compatible parser.
-	*
-	* Commander expects parsers to return values directly or throw on error.
-	* This wrapper converts our Result-based parsers to that pattern.
-	*
-	* @param parser - The Result-based parser function
-	* @returns A Commander-compatible parser function
-	*/
-	wrapParser(parser) {
-		return (input) => {
-			const result = parser(input);
-			if (result.isErr()) throw new Error(result.error);
-			return result.value;
-		};
-	}
-	/**
-	* Creates a parser for number options.
-	*
-	* @template T - The expected return type
-	* @param rawField - The raw Zod field
-	* @param optionName - The option name for error messages
-	* @returns A parser function that converts strings to numbers with validation
-	*/
-	createNumberParser(rawField, optionName) {
-		return (input) => {
-			const num = Number(input);
-			if (Number.isNaN(num)) return err(`Invalid number for --${optionName}: ${input}`);
-			const result = parseSchema(rawField, num);
-			if (result.isErr()) return err(result.error.message);
-			return ok(result.value);
-		};
-	}
-	/**
-	* Creates a parser for enum options.
-	*
-	* @template T - The expected return type
-	* @param rawField - The raw Zod field
-	* @param optionName - The option name for error messages
-	* @param choices - The valid enum choices
-	* @returns A parser function that validates input against the enum choices
-	*/
-	createEnumParser(rawField, optionName, choices) {
-		return (input) => {
-			const result = parseSchema(rawField, input);
-			if (result.isErr()) return err(`Invalid value for --${optionName}: ${input}. Allowed: ${choices.join(", ")}`);
-			return ok(result.value);
-		};
-	}
-	/**
-	* Creates a parser for string options.
-	*
-	* @template T - The expected return type
-	* @param rawField - The raw Zod field
-	* @returns A parser function that validates input against the schema
-	*/
-	createStringParser(rawField) {
-		return (input) => {
-			const result = parseSchema(rawField, input);
-			if (result.isErr()) return err(result.error.message);
-			return ok(result.value);
-		};
-	}
-	/**
-	* Creates a generic parser using Zod validation.
-	*
-	* @template T - The expected return type
-	* @param rawField - The raw Zod field
-	* @returns A parser function that validates input against the schema
-	*/
-	createGenericParser(rawField) {
-		return (input) => {
-			const result = parseSchema(rawField, input);
-			if (result.isErr()) return err(result.error.message);
-			return ok(result.value);
-		};
+		const literalValues = extractLiteralValues(rawField);
+		if (literalValues) {
+			const validator$1 = createLiteralUnionValidator(rawField, optionName, literalValues);
+			const fullDescription = `${description} (choices: ${literalValues.map((v) => typeof v === "string" ? v : String(v)).join(", ")})`;
+			command.option(`${optionFlag} <${optionName}>`, fullDescription, validator$1, parsedDefault);
+			return;
+		}
+		const enumValues = extractEnumValues(rawField);
+		if (enumValues) {
+			const validator$1 = createEnumValidator(rawField, optionName, enumValues);
+			const fullDescription = `${description} (choices: ${enumValues.join(", ")})`;
+			command.option(`${optionFlag} <${optionName}>`, fullDescription, validator$1, parsedDefault);
+			return;
+		}
+		const validator = createGenericValidator(rawField, optionName);
+		command.option(`${optionFlag} <${optionName}>`, description, validator, parsedDefault);
 	}
 	/**
 	* Gets the internal definition object from a Zod type.
@@ -469,15 +559,6 @@ var OptionsBuilder = class {
 		const def = this.getInternalDef(rawField);
 		return (def.innerType ?? def.schema) instanceof z$1.ZodBoolean;
 	}
-	/**
-	* Extracts enum choices from a ZodEnum field.
-	*
-	* @param field - The ZodEnum field
-	* @returns The array of valid enum choices
-	*/
-	getEnumChoices(field) {
-		return this.getInternalDef(field).values ?? [];
-	}
 };
 
 //#endregion
@@ -806,7 +887,7 @@ var TaskBuilder = class TaskBuilder {
 //#region src/commands/release/tasks/bump-release-version.task.ts
 function createBumpReleaseVersion() {
 	return TaskBuilder.create("bump-release-version").description("Applies the new version bump to relevant files").dependsOnAll("straight-version-bump", "determine-automatic-bump", "prompt-manual-version", "prompt-bump-strategy").skipWhenWithReason((ctx) => ctx.config.skipBump, "Skipped: skipBump is enabled").execute((ctx) => {
-		logger.info("bump-release-version");
+		logger.info(`Next version to be released: ${colors.green(ctx.data.nextVersion)}`);
 		return FireflyOkAsync(ctx);
 	}).build();
 }
@@ -1028,22 +1109,60 @@ function createDelegateBumpStrategyTask() {
 			shouldSkip,
 			reason: shouldSkip ? getSkipReason(ctx) : void 0
 		});
-	}).execute((ctx) => {
-		logger.info("delegate-bump-strategy");
-		return FireflyOkAsync(ctx);
-	}).build();
+	}).execute((ctx) => FireflyOkAsync(ctx)).build();
 }
 
 //#endregion
 //#region src/commands/release/tasks/determine-automatic-bump.task.ts
+/**
+* Parses the current version from a raw string.
+*
+* @param currentVersionRaw - The raw string representing the current version
+* @returns A FireflyResult containing the parsed Version or a validation error
+*/
+function parseCurrentVersion$2(currentVersionRaw) {
+	if (!currentVersionRaw) return validationErr({ message: "Current version is undefined" });
+	return Version.from(currentVersionRaw);
+}
+/**
+* Logs the analysis recommendation with formatting.
+*
+* @param reason - The reason string from the recommendation
+*/
+function logRecommendation(reason) {
+	if (!reason) return;
+	if (reason.startsWith("Analysis found:")) {
+		const prefix = "Analysis found:";
+		const details = reason.slice(15).trim();
+		logger.info(`${prefix} ${colors.green(details)}`);
+	} else logger.info(reason);
+}
+/**
+* Performs the automatic bump by analyzing commits and resolving version strategy.
+*/
+function executeAutomaticBump(ctx) {
+	const currentVersionResult = parseCurrentVersion$2(ctx.data.currentVersion);
+	if (currentVersionResult.isErr()) return FireflyErrAsync(currentVersionResult.error);
+	const currentVersion = currentVersionResult.value;
+	return ctx.services.commitAnalysis.analyzeForVersion().andThen((recommendation) => {
+		logRecommendation(recommendation.reason);
+		const options = {
+			currentVersion,
+			preReleaseId: ctx.config.preReleaseId,
+			preReleaseBase: ctx.config.preReleaseBase
+		};
+		return ctx.services.versionStrategy.resolveVersion(options, recommendation);
+	}).andThen((newVersion) => {
+		const from = ctx.data.currentVersion || "unknown";
+		logger.info(`Determined version: ${colors.green(from)} -> ${colors.green(newVersion.raw)}`);
+		return FireflyOkAsync(ctx.fork("nextVersion", newVersion.toString()));
+	});
+}
 function createDetermineAutomaticBump() {
 	return TaskBuilder.create("determine-automatic-bump").description("Automatically determines the version bump from commit messages").dependsOn("delegate-bump-strategy").skipWhenWithReason((ctx) => {
 		const bumpStrategy = ctx.data.selectedBumpStrategy ?? ctx.config.bumpStrategy;
 		return ctx.config.skipBump || bumpStrategy !== BUMP_STRATEGY_AUTO;
-	}, "Skipped: skipBump enabled or bumpStrategy is not 'auto'").execute((ctx) => {
-		logger.info("determine-automatic-bump");
-		return FireflyOkAsync(ctx);
-	}).build();
+	}, "Skipped: skipBump enabled or bumpStrategy is not 'auto'").execute((ctx) => executeAutomaticBump(ctx)).build();
 }
 
 //#endregion
@@ -1075,46 +1194,123 @@ function promptBumpStrategy() {
 	const defaultStrategy = BUMP_STRATEGIES[0];
 	if (!defaultStrategy) return notFoundErrAsync({ message: "No default version bump strategy found" });
 	logger.verbose("PromptBumpStrategyTask: Prompting user for version bump strategy.");
-	const prompt = logger.prompt("Select version bump strategy", {
+	return wrapPromise(logger.prompt("Select version bump strategy", {
 		type: "select",
 		options: BUMP_STRATEGIES,
 		initial: defaultStrategy.value,
-		cancel: "reject"
-	});
-	if (logger.level !== LogLevels.verbose) logger.log("");
-	return wrapPromise(prompt).andTee(() => {
+		cancel: "undefined"
+	})).andThen((selected) => {
+		if (!selected || selected === "") return failedErrAsync({ message: "Operation cancelled by user" });
 		if (logger.level === LogLevels.verbose) logger.log("");
-	}).andThen((selected) => {
-		if (!selected || selected === "") return invalidErrAsync({ message: "No version bump strategy selected" });
+		if (logger.level !== LogLevels.verbose) logger.log("");
 		const validationResult = validateStrategy(selected);
 		if (validationResult.isErr()) return FireflyErrAsync(validationResult.error);
 		logger.verbose(`PromptBumpStrategyTask: Selected version bump strategy: '${selected}'`);
 		return FireflyOkAsync(selected);
 	});
 }
+/**
+* Creates the Prompt Bump Strategy Task.
+*
+* This task prompts the user to select a version bump strategy (automatic or manual) and
+* stores it in the release context. It depends on `initialize-release-version` and will be
+* skipped when `skipBump` is enabled or a `bumpStrategy`/`releaseType` is already provided.
+*
+* This task:
+* 1. Prompts the user to select a bump strategy
+*/
 function createPromptBumpStrategyTask() {
 	return TaskBuilder.create("prompt-bump-strategy").description("Prompts the user for a version bump strategy").dependsOn("initialize-release-version").skipWhenWithReason((ctx) => ctx.config.skipBump || Boolean(ctx.config.bumpStrategy) || Boolean(ctx.config.releaseType), "Skipped: skipBump enabled, or bumpStrategy/releaseType already specified").execute((ctx) => promptBumpStrategy().andThen((strategy) => FireflyOkAsync(ctx.fork("selectedBumpStrategy", strategy)))).build();
 }
 
 //#endregion
 //#region src/commands/release/tasks/prompt-manual-bump.task.ts
+/**
+* Parses the current version from a raw string.
+*
+* @param currentVersionRaw - The raw string representing the current version
+* @returns A FireflyResult containing the parsed Version or a validation error
+*/
+function parseCurrentVersion$1(currentVersionRaw) {
+	if (!currentVersionRaw) return validationErr({ message: "Current version is undefined" });
+	return Version.from(currentVersionRaw);
+}
+/**
+* Generates version choices and prompts the user to select one.
+*/
+function promptForManualVersion(ctx) {
+	const currentVersionResult = parseCurrentVersion$1(ctx.data.currentVersion);
+	if (currentVersionResult.isErr()) return FireflyErrAsync(currentVersionResult.error);
+	const currentVersion = currentVersionResult.value;
+	logger.verbose("PromptManualVersionTask: Generating version choices...");
+	return ctx.services.versionStrategy.generateChoices({
+		currentVersion,
+		preReleaseId: ctx.config.preReleaseId,
+		preReleaseBase: ctx.config.preReleaseBase
+	}).andThen((choices) => {
+		if (!choices || choices.length === 0) return validationErrAsync({ message: "No version choices available" });
+		logger.verbose(`PromptManualVersionTask: Generated ${choices.length} version choices.`);
+		const defaultChoice = choices[0];
+		return wrapPromise(logger.prompt("Select version to release", {
+			type: "select",
+			options: choices,
+			initial: defaultChoice?.value,
+			cancel: "undefined"
+		})).andThen((selected) => {
+			if (!selected || selected === "") return failedErrAsync({ message: "Operation cancelled by user" });
+			if (logger.level === LogLevels.verbose) logger.log("");
+			if (logger.level !== LogLevels.verbose) logger.log("");
+			logger.verbose(`PromptManualVersionTask: Selected version: '${selected}'`);
+			return FireflyOkAsync(selected);
+		});
+	});
+}
 function createPromptManualVersionTask() {
-	return TaskBuilder.create("prompt-manual-version").description("Prompts the user for a manual version bump selections").dependsOn("delegate-bump-strategy").skipWhenWithReason((ctx) => {
+	return TaskBuilder.create("prompt-manual-version").description("Prompts the user to manually select the next version").dependsOn("delegate-bump-strategy").skipWhenWithReason((ctx) => {
 		const bumpStrategy = ctx.data.selectedBumpStrategy ?? ctx.config.bumpStrategy;
 		return ctx.config.skipBump || bumpStrategy !== BUMP_STRATEGY_MANUAL;
-	}, "Skipped: skipBump enabled or bumpStrategy is not 'manual'").execute((ctx) => {
-		logger.info("prompt-manual-version");
-		return FireflyOkAsync(ctx);
-	}).build();
+	}, "Skipped: skipBump enabled or bumpStrategy is not 'manual'").execute((ctx) => promptForManualVersion(ctx).andThen((selectedVersion) => FireflyOkAsync(ctx.fork("nextVersion", selectedVersion)))).build();
 }
 
 //#endregion
 //#region src/commands/release/tasks/straight-version-bump.task.ts
+/**
+* Parses the current version from a raw string.
+*
+* @param currentVersionRaw - The raw string representing the current version
+* @returns A FireflyResult containing the parsed Version or a validation error
+*/
+function parseCurrentVersion(currentVersionRaw) {
+	if (!currentVersionRaw) return validationErr({ message: "Current version is undefined" });
+	return Version.from(currentVersionRaw);
+}
+/**
+* Builds the bump options from the release context.
+*/
+function buildBumpOptionsFromContext(ctx) {
+	const currentVersionResult = parseCurrentVersion(ctx.data.currentVersion);
+	if (currentVersionResult.isErr()) return FireflyErrAsync(currentVersionResult.error);
+	const releaseType = ctx.config.releaseType;
+	if (releaseType === void 0) return invalidErrAsync({ message: "Release type is required for straight bump" });
+	return FireflyOkAsync({
+		currentVersion: currentVersionResult.value,
+		releaseType,
+		preReleaseId: ctx.config.preReleaseId,
+		preReleaseBase: ctx.config.preReleaseBase
+	});
+}
+/**
+* Performs the straight bump by delegating to the version bumper service.
+*/
+function executeStraightVersionBump(ctx) {
+	return buildBumpOptionsFromContext(ctx).andThen((options) => ctx.services.versionBumper.bump(options)).andThen((newVersion) => {
+		const from = ctx.data.currentVersion || "unknown";
+		logger.info(`Bumped version: ${colors.green(from)} -> ${colors.green(newVersion.raw)}`);
+		return FireflyOkAsync(ctx.fork("nextVersion", newVersion.toString()));
+	});
+}
 function createStraightVersionBump() {
-	return TaskBuilder.create("straight-version-bump").description("Performs a direct version bump based on the configured release type").dependsOn("initialize-release-version").skipWhenWithReason((ctx) => ctx.config.skipBump || ctx.config.releaseType === void 0, "Skipped: skipBump is enabled or no release type specified").execute((ctx) => {
-		logger.info("straight-version-bump");
-		return FireflyOkAsync(ctx);
-	}).build();
+	return TaskBuilder.create("straight-version-bump").description("Performs a direct version bump based on the configured release type").dependsOn("initialize-release-version").skipWhenWithReason((ctx) => ctx.config.skipBump || ctx.config.releaseType === void 0, "Skipped: skipBump is enabled or no release type specified").execute((ctx) => executeStraightVersionBump(ctx)).build();
 }
 
 //#endregion
@@ -1168,7 +1364,7 @@ function getVersionFromPackageJson(ctx) {
 */
 function createInitializeReleaseVersion() {
 	return TaskBuilder.create("initialize-release-version").description("Initialize current release version from package.json").dependsOn("prepare-release-config").execute((ctx) => getVersionFromPackageJson(ctx).andThen((currentVersion) => {
-		logger.info(`Current version is ${currentVersion}`);
+		logger.info(`Current version is ${colors.green(currentVersion)}`);
 		return FireflyOkAsync(ctx.fork("currentVersion", currentVersion));
 	})).build();
 }
@@ -1180,6 +1376,12 @@ const SSH_REMOTE_REGEX = /git@[^:]+:([^/]+)\/([^/.]+)(?:\.git)?/;
 const SCOPED_PACKAGE_REGEX = /^@([^/]+)\/(.+)$/;
 const PRERELEASE_REGEX = /^\d+\.\d+\.\d+-([a-zA-Z]+)/;
 /**
+* Terminologies:
+*
+* Prepared: The value has been determined and set in the context.
+* Using: The value was explicitly provided in the config and is used as-is.
+*/
+/**
 * Parses a git remote URL to extract owner and repository name.
 * Supports both HTTPS and SSH formats.
 *
@@ -1226,46 +1428,6 @@ function extractPreReleaseId(version) {
 	return version.match(PRERELEASE_REGEX)?.[1];
 }
 /**
-* Hydrates the repository field from git remote URL.
-*
-* Behavior:
-* - If not inside a git repository, resolves to undefined.
-* - If inside a repository, detect the repository URL
-*   using a fall-through strategy (upstream remote → origin → first remote).
-* - Parses the URL and returns "owner/repo" when possible.
-*/
-function hydrateRepository(ctx) {
-	return ctx.services.git.inferRepositoryUrl().map((url) => {
-		if (!url) return null;
-		const parsed = parseGitRemoteUrl(url);
-		if (parsed) return `${parsed.owner}/${parsed.repo}`;
-		return null;
-	}).map((val) => val ?? void 0).andTee((repository) => logger.verbose(`PrepareReleaseConfigTask: Prepared repository: ${repository}`));
-}
-/**
-* Hydrates name, scope, and preReleaseId from package.json.
-*
-* Behavior:
-* - If package.json does not exist, returns all values as undefined.
-* - If it exists, reads package.json and returns parsed results for name, scope and preReleaseId.
-*/
-function hydrateFromPackageJson(ctx) {
-	return ctx.services.fs.exists("package.json").andThen((exists) => {
-		if (!exists) return FireflyOkAsync({
-			name: void 0,
-			scope: void 0,
-			preReleaseId: void 0
-		});
-		return ctx.services.packageJson.read("package.json").andThen((pkg) => zip3Async(hydrateNameFromPackageJson(ctx, pkg), hydrateScopeFromPackageJson(ctx, pkg), hydratePreReleaseIdFromPackageJson(ctx, pkg)).map(([name, scope, preReleaseId]) => {
-			const result = {};
-			if (name) result.name = name;
-			if (scope) result.scope = scope;
-			if (preReleaseId) result.preReleaseId = preReleaseId;
-			return result;
-		}));
-	});
-}
-/**
 * Hydrates the `name` field from package.json when not provided in config.
 *
 * Cases:
@@ -1315,7 +1477,7 @@ function hydrateScopeFromPackageJson(ctx, packageJson) {
 * 3. Otherwise the function defaults to "alpha".
 */
 function hydratePreReleaseIdFromPackageJson(ctx, packageJson) {
-	if (ctx.config.preReleaseId !== void 0 && ctx.config.preReleaseId.trim() !== "") {
+	if (Object.hasOwn(ctx.config, "preReleaseId") && ctx.config.preReleaseId !== void 0) {
 		logger.verbose(`PrepareReleaseConfigTask: Using provided preReleaseId: "${ctx.config.preReleaseId}" as it is explicitly set`);
 		return FireflyOkAsync(ctx.config.preReleaseId);
 	}
@@ -1332,6 +1494,67 @@ function hydratePreReleaseIdFromPackageJson(ctx, packageJson) {
 	return FireflyOkAsync("alpha");
 }
 /**
+* Hydrates the `preReleaseBase` field.
+*
+* Behavior:
+* - If explicitly provided in config (key exists and value is not undefined) use as-is.
+* - Otherwise default to 0.
+*
+* Note: we do NOT infer `preReleaseBase` from package.json anymore.
+*/
+function hydratePreReleaseBase(ctx) {
+	const baseMaybe = ctx.config.preReleaseBase;
+	if (Object.hasOwn(ctx.config, "preReleaseBase") && baseMaybe !== void 0) {
+		logger.verbose(`PrepareReleaseConfigTask: Using provided preReleaseBase: "${ctx.config.preReleaseBase}" as it is explicitly set`);
+		return FireflyOkAsync(baseMaybe);
+	}
+	logger.verbose("PrepareReleaseConfigTask: No preReleaseBase explicitly provided, defaulting to 0");
+	return FireflyOkAsync(0);
+}
+/**
+* Hydrates name, scope, and preReleaseId from package.json.
+*
+* Behavior:
+* - If package.json does not exist, returns all values as undefined.
+* - If it exists, reads package.json and returns parsed results for name, scope and preReleaseId.
+* - If preReleaseBase is explicitly provided in config, it is used as-is, if not, it defaults to 0.
+*/
+function hydrateFromPackageJson(ctx) {
+	return ctx.services.fs.exists("package.json").andThen((exists) => {
+		if (!exists) return FireflyOkAsync({
+			name: void 0,
+			scope: void 0,
+			preReleaseId: void 0,
+			preReleaseBase: void 0
+		});
+		return ctx.services.packageJson.read("package.json").andThen((pkg) => hydrateNameFromPackageJson(ctx, pkg).andThen((name) => hydrateScopeFromPackageJson(ctx, pkg).andThen((scope) => hydratePreReleaseIdFromPackageJson(ctx, pkg).andThen((preReleaseId) => hydratePreReleaseBase(ctx).map((preReleaseBase) => {
+			const result = {};
+			if (name) result.name = name;
+			if (scope) result.scope = scope;
+			if (preReleaseId) result.preReleaseId = preReleaseId;
+			if (preReleaseBase !== void 0) result.preReleaseBase = preReleaseBase;
+			return result;
+		})))));
+	});
+}
+/**
+* Hydrates the repository field from git remote URL.
+*
+* Behavior:
+* - If not inside a git repository, resolves to undefined.
+* - If inside a repository, detect the repository URL
+*   using a fall-through strategy (upstream remote → origin → first remote).
+* - Parses the URL and returns "owner/repo" when possible.
+*/
+function hydrateRepository(ctx) {
+	return ctx.services.git.inferRepositoryUrl().andThen((url) => {
+		if (!url) return validationErrAsync({ message: "Could not determine git remote URL to infer repository information" });
+		const parsed = parseGitRemoteUrl(url);
+		if (parsed) return FireflyOkAsync(`${parsed.owner}/${parsed.repo}`);
+		return validationErrAsync({ message: `Could not parse repository information from git remote URL: ${url}` });
+	}).andTee((repository) => logger.verbose(`PrepareReleaseConfigTask: Prepared repository: ${repository}`));
+}
+/**
 * Hydrates branch setting from git.
 *
 * Behavior:
@@ -1355,6 +1578,71 @@ function hydrateBranch(ctx) {
 	});
 }
 /**
+* Hydrates repository and branch information from git.
+*
+* Behavior:
+* - If not inside a git repository, resolves both values to undefined.
+* - Otherwise it composes `hydrateRepository` and `hydrateBranch` and returns both values.
+*/
+function hydrateFromGit(ctx) {
+	return ctx.services.git.isInsideRepository().andThen((isRepo) => {
+		if (!isRepo) return FireflyOkAsync({
+			repository: void 0,
+			branch: void 0
+		});
+		return hydrateRepository(ctx).andThen((repository) => hydrateBranch(ctx).map((branch) => {
+			const result = {};
+			if (repository) result.repository = repository;
+			if (branch) result.branch = branch;
+			return result;
+		}));
+	});
+}
+/**
+* Hydrates release flags (releaseLatest, releasePreRelease, releaseDraft).
+*
+* Behavior:
+* - If exactly one flag is explicitly set to true, use that and set others to false.
+* - If no flags are explicitly set, default to releaseLatest = true, others = false.
+* - Validation of exclusivity is handled by the schema, so we only need to determine defaults.
+*/
+function hydrateReleaseFlags(ctx) {
+	const { releaseLatest, releasePreRelease, releaseDraft } = ctx.config;
+	const latestExplicit = releaseLatest === true;
+	const preReleaseExplicit = releasePreRelease === true;
+	const draftExplicit = releaseDraft === true;
+	if (preReleaseExplicit) {
+		logger.verbose(`PrepareReleaseConfigTask: Using "releasePreRelease" as it is explicitly set`);
+		return FireflyOkAsync({
+			releaseLatest: false,
+			releasePreRelease: true,
+			releaseDraft: false
+		});
+	}
+	if (draftExplicit) {
+		logger.verbose(`PrepareReleaseConfigTask: Using "releaseDraft" as it is explicitly set`);
+		return FireflyOkAsync({
+			releaseLatest: false,
+			releasePreRelease: false,
+			releaseDraft: true
+		});
+	}
+	if (latestExplicit) {
+		logger.verbose(`PrepareReleaseConfigTask: Using "releaseLatest" as it is explicitly set`);
+		return FireflyOkAsync({
+			releaseLatest: true,
+			releasePreRelease: false,
+			releaseDraft: false
+		});
+	}
+	logger.verbose("PrepareReleaseConfigTask: Prepared releaseLatest as default since no flag was explicitly set");
+	return FireflyOkAsync({
+		releaseLatest: true,
+		releasePreRelease: false,
+		releaseDraft: false
+	});
+}
+/**
 * Creates the Prepare Release Config Task.
 *
 * This task determines and hydrates configuration settings, by inferring values from the environment.
@@ -1364,18 +1652,26 @@ function hydrateBranch(ctx) {
 * 2. Extracts name and scope from package.json
 * 3. Extracts preReleaseId from package.json version
 * 4. Detects current git branch if not provided
+* 5. Determines release flags (latest, preRelease, draft) with proper defaults
 */
 function createPrepareReleaseConfigTask() {
 	return TaskBuilder.create("prepare-release-config").description("Hydrate and prepare the release configuration").execute((ctx) => {
 		const hydrated = {};
-		return zip3Async(hydrateRepository(ctx), hydrateFromPackageJson(ctx), hydrateBranch(ctx)).map(([repository, pkgData, branch]) => {
-			if (repository) hydrated.repository = repository;
+		return hydrateFromGit(ctx).andThen((gitData) => {
+			if (gitData.repository) hydrated.repository = gitData.repository;
+			if (gitData.branch) hydrated.branch = gitData.branch;
+			return hydrateFromPackageJson(ctx);
+		}).andThen((pkgData) => {
 			if (pkgData.name) hydrated.name = pkgData.name;
 			if (pkgData.scope) hydrated.scope = pkgData.scope;
 			if (pkgData.preReleaseId) hydrated.preReleaseId = pkgData.preReleaseId;
-			if (branch) hydrated.branch = branch;
-			logger.verbose(`PrepareReleaseConfigTask: Hydrated config: ${JSON.stringify(hydrated)}`);
-			return ctx.fork("hydratedConfig", hydrated);
+			if (pkgData.preReleaseBase !== void 0) hydrated.preReleaseBase = pkgData.preReleaseBase;
+			return hydrateReleaseFlags(ctx);
+		}).map((releaseFlags) => {
+			hydrated.releaseLatest = releaseFlags.releaseLatest;
+			hydrated.releasePreRelease = releaseFlags.releasePreRelease;
+			hydrated.releaseDraft = releaseFlags.releaseDraft;
+			return ctx.forkConfig(hydrated);
 		});
 	}).build();
 }
@@ -1542,7 +1838,7 @@ function validateReleaseFlagExclusivity(ctx) {
 		"releasePreRelease",
 		"releaseDraft"
 	];
-	if (flagNames.filter((k) => ctx.value[k]).length > 1) ctx.issues.push({
+	if (flagNames.filter((k) => ctx.value[k] === true).length > 1) ctx.issues.push({
 		code: "custom",
 		message: `Only one of ${flagNames.join(", ")} can be set to true.`,
 		input: ctx.value,
@@ -1588,14 +1884,15 @@ function validateSkipFlagCombinations(ctx) {
 const ReleaseConfigSchema = z$1.object({
 	name: z$1.string().optional().describe("Unscoped project name. Auto-detected from package.json."),
 	scope: z$1.string().optional().describe("Org/user scope without '@'. Auto-detected from package.json."),
-	base: z$1.string().default("").describe("Relative path from repository root to project root."),
+	repository: z$1.string().optional().describe("GitHub repository in 'owner/repo' format."),
+	base: z$1.string().optional().describe("Relative path from repository root to project root."),
 	branch: z$1.string().optional().describe("Git branch to release from."),
 	changelogPath: z$1.string().default("CHANGELOG.md").describe("Changelog file path, relative to project root."),
 	bumpStrategy: BumpStrategySchema.describe("\"auto\" (from commits) or \"manual\" (user-specified)."),
 	releaseType: ReleaseTypeSchema.optional().describe("The release type to bump."),
 	preReleaseId: z$1.string().optional().describe("Pre-release ID (e.g., \"alpha\", \"beta\")."),
 	preReleaseBase: PreReleaseBaseSchema.describe("Starting version for pre-releases."),
-	releaseNotes: z$1.string().default("").describe("Custom release notes for changelog."),
+	releaseNotes: z$1.string().optional().describe("Custom release notes for changelog."),
 	commitMessage: z$1.string().default(COMMIT_MSG_TEMPLATE).describe("Commit message template with placeholders."),
 	tagName: z$1.string().default(TAG_NAME_TEMPLATE).describe("Tag name template with placeholders."),
 	skipBump: z$1.coerce.boolean().default(false).describe("Skip version bump step."),
@@ -1605,9 +1902,9 @@ const ReleaseConfigSchema = z$1.object({
 	skipGit: z$1.coerce.boolean().default(false).describe("Skip all git-related steps."),
 	skipPreflightCheck: z$1.coerce.boolean().default(false).describe("Skip preflight checks."),
 	releaseTitle: z$1.string().default(RELEASE_TITLE_TEMPLATE).describe("GitHub release title with placeholders."),
-	releaseLatest: z$1.coerce.boolean().default(true).describe("Mark as latest release."),
-	releasePreRelease: z$1.coerce.boolean().default(false).describe("Mark as pre-release."),
-	releaseDraft: z$1.coerce.boolean().default(false).describe("Release as draft version.")
+	releaseLatest: z$1.coerce.boolean().optional().describe("Mark as latest release."),
+	releasePreRelease: z$1.coerce.boolean().optional().describe("Mark as pre-release."),
+	releaseDraft: z$1.coerce.boolean().optional().describe("Release as draft version.")
 }).check((ctx) => {
 	validateReleaseFlagExclusivity(ctx);
 	validateSkipGitRedundancy(ctx);
@@ -1661,30 +1958,30 @@ function defineService(definition) {
 */
 const SERVICE_DEFINITIONS = {
 	fs: defineService({ factory: async ({ basePath }) => {
-		const { createFileSystemService } = await import("./filesystem.service-BcQtLzfl.js");
+		const { createFileSystemService } = await import("./filesystem.service-DS2AQGNq.js");
 		return createFileSystemService(basePath);
 	} }),
 	packageJson: defineService({
 		dependencies: ["fs"],
 		factory: async ({ getService }) => {
 			const fs = await getService("fs");
-			const { createPackageJsonService } = await import("./package-json.service-BKbXaHXQ.js");
+			const { createPackageJsonService } = await import("./package-json.service-BlMNgPGQ.js");
 			return createPackageJsonService(fs);
 		}
 	}),
 	git: defineService({ factory: async ({ basePath }) => {
-		const { createGitService } = await import("./git.service-D1Mf6LZ0.js");
+		const { createGitService } = await import("./git.service-B6RdTilO.js");
 		return createGitService(basePath);
 	} }),
 	versionBumper: defineService({ factory: async () => {
-		const { createVersionBumperService } = await import("./version-bumper.service-CvPx7EZx.js");
+		const { createVersionBumperService } = await import("./version-bumper.service-glxzf9Qm.js");
 		return createVersionBumperService();
 	} }),
 	versionStrategy: defineService({
 		dependencies: ["versionBumper"],
 		factory: async ({ getService }) => {
 			const versionBumper = await getService("versionBumper");
-			const { createVersionStrategyService } = await import("./version-strategy.service-BO_7MY5O.js");
+			const { createVersionStrategyService } = await import("./version-strategy.service-Dln42gxC.js");
 			return createVersionStrategyService(versionBumper);
 		}
 	}),
@@ -1692,7 +1989,7 @@ const SERVICE_DEFINITIONS = {
 		dependencies: ["git"],
 		factory: async ({ getService }) => {
 			const git = await getService("git");
-			const { createCommitAnalysisService } = await import("./commit-analysis.service-CtIh7eez.js");
+			const { createCommitAnalysisService } = await import("./commit-analysis.service-B2Z128t8.js");
 			return createCommitAnalysisService(git);
 		}
 	})
@@ -1956,7 +2253,7 @@ function logGraphStatistics(stats) {
 
 //#endregion
 //#region src/commands/release/release.command.ts
-const RELEASE_SERVICES = defineServiceKeys("fs", "packageJson", "git");
+const RELEASE_SERVICES = defineServiceKeys("fs", "packageJson", "git", "commitAnalysis", "versionBumper", "versionStrategy");
 const releaseCommand = createCommand({
 	meta: {
 		name: "release",
@@ -2276,6 +2573,30 @@ var ImmutableWorkflowContext = class ImmutableWorkflowContext {
 			services: this.services
 		});
 	}
+	/**
+	* @example Merging hydrated config values
+	* ```typescript
+	* const updatedCtx = ctx.forkConfig({
+	*   repository: "owner/repo",
+	*   branch: "main"
+	* });
+	* ```
+	*/
+	forkConfig(updates) {
+		if (Object.keys(updates).length === 0) return this;
+		const mergedConfig = {
+			...this.config,
+			...updates
+		};
+		const frozenConfig = Object.freeze(mergedConfig);
+		return new ImmutableWorkflowContext({
+			startTime: this.startTime,
+			workspace: this.workspace,
+			config: frozenConfig,
+			data: this.#data,
+			services: this.services
+		});
+	}
 	has(key) {
 		return key in this.#data;
 	}
@@ -2366,6 +2687,8 @@ var WorkflowExecutor = class {
 	handleExecutionFailure(args) {
 		const { error, startTime, executedTaskIds, skippedTaskIds, initialContext } = args;
 		const endTime = /* @__PURE__ */ new Date();
+		if (DebugFlags.showRawError) logger.error(error);
+		else logger.error(error.message);
 		if (this.options.enableRollback && this.executedTasks.length > 0) {
 			logger.verbose(`WorkflowExecutor: Attempting rollback of ${this.executedTasks.length} tasks`);
 			return this.rollback(initialContext).andThen((rollbackSuccess) => {
@@ -2441,9 +2764,6 @@ var WorkflowExecutor = class {
 			executionLists.executedTaskIds.push(currentTask.meta.id);
 			this.executedTasks.push(currentTask);
 			return this.executeTasksSequentially(remainingTasks, updatedContext, executionLists.executedTaskIds, executionLists.skippedTaskIds);
-		}).mapErr((error) => {
-			logger.error(error.message);
-			return error;
 		});
 	}
 	rollback(context) {
@@ -3115,6 +3435,18 @@ async function resolveServiceWithContext(key, context) {
 /**
 * Creates a lazy proxy that defers async service instantiation until first access.
 *
+* IMPORTANT:
+* This proxy always defers instantiation and wraps calls in a ResultAsync chain
+* in order to safely await the real service instance before invoking the method.
+*
+* At runtime the proxy therefore returns ResultAsync even if the concrete service
+* method returns a synchronous Result.
+*
+* Because of this behavior, service interfaces should return FireflyAsyncResult<T>
+* from their public methods to avoid type mismatches and confusion. Implementations
+* that have purely synchronous behavior should return FireflyOkAsync / FireflyErrAsync
+* so they still conform to the async contract expected by the proxy.
+*
 * @template T - The service interface type
 * @param factory - Async function that creates the actual service instance
 * @returns A proxy that behaves like the service but instantiates lazily