politty 0.4.11 → 0.4.13

package/dist/prompt-aXfSf27y.cjs

@@ -0,0 +1,196 @@
+
+//#region src/prompt/prompt-resolver.ts
+/**
+* Resolve prompt configuration for a field.
+*
+* Priority for prompt type:
+* 1. Explicit type from prompt.type
+* 2. Explicit choices from prompt.choices (forces "select")
+* 3. Inherited from completion metadata (file/directory -> "text")
+* 4. Auto-detected from Zod schema type:
+*    - enum (has enumValues) -> "select"
+*    - boolean -> "confirm"
+*    - string/number/unknown -> "text"
+*
+* Returns null if the field has no prompt metadata or prompting is disabled.
+*/
+function resolvePromptConfig(field) {
+	const promptMeta = field.prompt;
+	if (!promptMeta || promptMeta.enabled === false) return null;
+	const message = promptMeta.message ?? field.description ?? field.name;
+	const rawType = resolvePromptType(field, promptMeta);
+	const choices = resolveChoices(field, promptMeta, rawType);
+	return {
+		field,
+		type: rawType === "select" && !choices ? "text" : rawType,
+		message,
+		...choices && { choices }
+	};
+}
+function hasChoices(list) {
+	return list !== void 0 && list.length > 0;
+}
+function resolvePromptType(field, promptMeta) {
+	if (promptMeta.type) return promptMeta.type === "file" || promptMeta.type === "directory" ? "text" : promptMeta.type;
+	if (hasChoices(promptMeta.choices)) return "select";
+	if (field.completion?.type === "file" || field.completion?.type === "directory") return "text";
+	if (hasChoices(field.enumValues)) return "select";
+	if (field.type === "boolean") return "confirm";
+	return "text";
+}
+function resolveChoices(field, promptMeta, type) {
+	if (hasChoices(promptMeta.choices)) return promptMeta.choices.map((c) => typeof c === "string" ? {
+		label: c,
+		value: c
+	} : c);
+	if (type === "select" && hasChoices(field.enumValues)) return field.enumValues.map((v) => ({
+		label: v,
+		value: v
+	}));
+}
+/**
+* Filter fields that need prompting (missing value + prompt configured).
+*
+* For discriminatedUnion schemas, variant-aware narrowing is handled by the
+* caller (promptMissingArgs) which prompts the discriminator first and then
+* passes only the active variant's fields. For plain union schemas, this
+* iterates all fields across every variant without narrowing.
+*
+* Fields with Zod defaults that also have prompt metadata will be prompted
+* when the raw value is undefined. This is intentional: `prompt: {}` is an
+* explicit opt-in to interactive input. Omit prompt metadata to let the
+* default apply silently.
+*/
+function getFieldsToPrompt(fields, rawArgs) {
+	const configs = [];
+	for (const field of fields) {
+		if (rawArgs[field.name] !== void 0) continue;
+		if (field.type === "array") continue;
+		const config = resolvePromptConfig(field);
+		if (config) configs.push(config);
+	}
+	return configs;
+}
+
+//#endregion
+//#region src/prompt/tty-detector.ts
+/**
+* Detect whether the current environment supports interactive prompts.
+* Returns false in CI, piped input, or non-TTY environments.
+*/
+function isInteractive() {
+	if (!process.stdin.isTTY) return false;
+	if (!process.stdout.isTTY) return false;
+	if (process.env.CI) return false;
+	if (process.env.POLITTY_NO_PROMPT) return false;
+	return true;
+}
+
+//#endregion
+//#region src/prompt/index.ts
+/**
+* Prompt for missing argument values interactively.
+*
+* Only prompts for fields that have `prompt` metadata set via `arg()` and
+* whose values are still undefined after CLI and env resolution.
+* Returns rawArgs unchanged in non-interactive environments.
+*/
+async function promptMissingArgs(rawArgs, extracted, options) {
+	if (!(options.interactive ?? isInteractive())) return rawArgs;
+	const adapter = options.adapter;
+	const result = { ...rawArgs };
+	if (extracted.schemaType === "discriminatedUnion" && extracted.discriminator && extracted.variants) await promptDiscriminatedUnion(adapter, result, extracted);
+	else if (extracted.schemaType === "union" || extracted.schemaType === "xor") {} else await promptAllFields(adapter, result, extracted.fields);
+	return result;
+}
+async function promptDiscriminatedUnion(adapter, result, extracted) {
+	const { discriminator, variants } = extracted;
+	if (!discriminator || !variants) return;
+	if (result[discriminator] === void 0) {
+		const discField = findDiscriminatorField(extracted.fields, variants, discriminator);
+		const discConfig = discField ? resolvePromptConfig(discField) : null;
+		if (discConfig) {
+			const allValues = variants.map((v) => v.discriminatorValue).filter(Boolean);
+			if (allValues.length > 0) {
+				discConfig.type = "select";
+				discConfig.choices = allValues.map((v) => ({
+					label: v,
+					value: v
+				}));
+			}
+			await promptAndCollect(adapter, result, discConfig);
+		}
+	}
+	const discValue = String(result[discriminator] ?? "");
+	const activeVariant = variants.find((v) => v.discriminatorValue === discValue);
+	if (activeVariant) await promptAllFields(adapter, result, activeVariant.fields.filter((f) => f.name !== discriminator));
+}
+/**
+* Find the discriminator field with prompt metadata, checking the
+* deduplicated top-level fields first, then scanning per-variant fields.
+*/
+function findDiscriminatorField(fields, variants, discriminator) {
+	const topLevel = fields.find((f) => f.name === discriminator);
+	if (topLevel?.prompt) return topLevel;
+	for (const variant of variants) {
+		const field = variant.fields.find((f) => f.name === discriminator);
+		if (field?.prompt) return field;
+	}
+}
+async function promptAllFields(adapter, result, fields) {
+	const fieldsToPrompt = getFieldsToPrompt(fields, result);
+	for (const config of fieldsToPrompt) await promptAndCollect(adapter, result, config);
+}
+async function promptAndCollect(adapter, result, config) {
+	const { message } = config;
+	let value;
+	switch (config.type) {
+		case "text":
+			value = await adapter.text({
+				message,
+				placeholder: config.field.placeholder
+			});
+			break;
+		case "password":
+			value = await adapter.password({ message });
+			break;
+		case "confirm":
+			value = await adapter.confirm({ message });
+			break;
+		case "select":
+			value = await adapter.select({
+				message,
+				options: config.choices ?? []
+			});
+			break;
+	}
+	if (adapter.isCancelled(value)) throw new Error("Prompt cancelled by user");
+	result[config.field.name] = value;
+}
+
+//#endregion
+Object.defineProperty(exports, 'getFieldsToPrompt', {
+  enumerable: true,
+  get: function () {
+    return getFieldsToPrompt;
+  }
+});
+Object.defineProperty(exports, 'isInteractive', {
+  enumerable: true,
+  get: function () {
+    return isInteractive;
+  }
+});
+Object.defineProperty(exports, 'promptMissingArgs', {
+  enumerable: true,
+  get: function () {
+    return promptMissingArgs;
+  }
+});
+Object.defineProperty(exports, 'resolvePromptConfig', {
+  enumerable: true,
+  get: function () {
+    return resolvePromptConfig;
+  }
+});
+//# sourceMappingURL=prompt-aXfSf27y.cjs.map

package/dist/prompt-aXfSf27y.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-aXfSf27y.cjs","names":[],"sources":["../src/prompt/prompt-resolver.ts","../src/prompt/tty-detector.ts","../src/prompt/index.ts"],"sourcesContent":["import type { ResolvedFieldMeta } from \"../core/schema-extractor.js\";\nimport type { ResolvedPromptConfig } from \"./types.js\";\n\n/**\n * Resolve prompt configuration for a field.\n *\n * Priority for prompt type:\n * 1. Explicit type from prompt.type\n * 2. Explicit choices from prompt.choices (forces \"select\")\n * 3. Inherited from completion metadata (file/directory -> \"text\")\n * 4. Auto-detected from Zod schema type:\n *    - enum (has enumValues) -> \"select\"\n *    - boolean -> \"confirm\"\n *    - string/number/unknown -> \"text\"\n *\n * Returns null if the field has no prompt metadata or prompting is disabled.\n */\nexport function resolvePromptConfig(field: ResolvedFieldMeta): ResolvedPromptConfig | null {\n  const promptMeta = field.prompt;\n  if (!promptMeta || promptMeta.enabled === false) return null;\n\n  const message = promptMeta.message ?? field.description ?? field.name;\n  const rawType = resolvePromptType(field, promptMeta);\n  const choices = resolveChoices(field, promptMeta, rawType);\n  // Fall back to text when select has no choices to avoid adapter crash\n  const type = rawType === \"select\" && !choices ? \"text\" : rawType;\n\n  return { field, type, message, ...(choices && { choices }) };\n}\n\nfunction hasChoices(list: unknown[] | undefined): list is unknown[] {\n  return list !== undefined && list.length > 0;\n}\n\nfunction resolvePromptType(\n  field: ResolvedFieldMeta,\n  promptMeta: NonNullable<ResolvedFieldMeta[\"prompt\"]>,\n): ResolvedPromptConfig[\"type\"] {\n  // Priority 1: Explicit type\n  if (promptMeta.type) {\n    return promptMeta.type === \"file\" || promptMeta.type === \"directory\" ? \"text\" : promptMeta.type;\n  }\n  // Priority 2: Explicit choices\n  if (hasChoices(promptMeta.choices)) return \"select\";\n  // Priority 3: Inherited from completion type\n  if (field.completion?.type === \"file\" || field.completion?.type === \"directory\") {\n    return \"text\";\n  }\n  // Priority 4: Auto-detect from schema\n  if (hasChoices(field.enumValues)) return \"select\";\n  if (field.type === \"boolean\") return \"confirm\";\n  return \"text\";\n}\n\nfunction resolveChoices(\n  field: ResolvedFieldMeta,\n  promptMeta: NonNullable<ResolvedFieldMeta[\"prompt\"]>,\n  type: ResolvedPromptConfig[\"type\"],\n): ResolvedPromptConfig[\"choices\"] | undefined {\n  // Explicit choices always win\n  if (hasChoices(promptMeta.choices)) {\n    return promptMeta.choices.map((c) => (typeof c === \"string\" ? { label: c, value: c } : c));\n  }\n  // Auto-populate from enum values for select type\n  if (type === \"select\" && hasChoices(field.enumValues)) {\n    return field.enumValues.map((v) => ({ label: v, value: v }));\n  }\n  return undefined;\n}\n\n/**\n * Filter fields that need prompting (missing value + prompt configured).\n *\n * For discriminatedUnion schemas, variant-aware narrowing is handled by the\n * caller (promptMissingArgs) which prompts the discriminator first and then\n * passes only the active variant's fields. For plain union schemas, this\n * iterates all fields across every variant without narrowing.\n *\n * Fields with Zod defaults that also have prompt metadata will be prompted\n * when the raw value is undefined. This is intentional: `prompt: {}` is an\n * explicit opt-in to interactive input. Omit prompt metadata to let the\n * default apply silently.\n */\nexport function getFieldsToPrompt(\n  fields: ResolvedFieldMeta[],\n  rawArgs: Record<string, unknown>,\n): ResolvedPromptConfig[] {\n  const configs: ResolvedPromptConfig[] = [];\n  for (const field of fields) {\n    if (rawArgs[field.name] !== undefined) continue;\n    // Array fields are not supported for interactive prompting yet;\n    // a scalar text response would fail Zod array validation.\n    // Object-valued fields (detected as type \"unknown\") are also unsupported\n    // but share the \"unknown\" bucket with literals, so they are not filtered\n    // here. Putting prompt metadata on object fields yields a Zod validation\n    // error at parse time, which is an acceptable misconfiguration signal.\n    if (field.type === \"array\") continue;\n    const config = resolvePromptConfig(field);\n    if (config) configs.push(config);\n  }\n  return configs;\n}\n","/**\n * Detect whether the current environment supports interactive prompts.\n * Returns false in CI, piped input, or non-TTY environments.\n */\nexport function isInteractive(): boolean {\n  if (!process.stdin.isTTY) return false;\n  if (!process.stdout.isTTY) return false;\n  if (process.env.CI) return false;\n  if (process.env.POLITTY_NO_PROMPT) return false;\n  return true;\n}\n","import type { ExtractedFields, ResolvedFieldMeta } from \"../core/schema-extractor.js\";\nimport { getFieldsToPrompt, resolvePromptConfig } from \"./prompt-resolver.js\";\nimport { isInteractive } from \"./tty-detector.js\";\nimport type { PromptAdapter, ResolvedPromptConfig } from \"./types.js\";\n\nexport { getFieldsToPrompt, resolvePromptConfig } from \"./prompt-resolver.js\";\nexport { isInteractive } from \"./tty-detector.js\";\nexport type { PromptAdapter, ResolvedPromptConfig } from \"./types.js\";\n\n/**\n * Options for promptMissingArgs behavior\n */\nexport interface PromptOptions {\n  /** Prompt adapter to use for rendering prompts */\n  adapter: PromptAdapter;\n  /** Override interactive detection (force enable/disable prompts) */\n  interactive?: boolean;\n}\n\n/**\n * Prompt for missing argument values interactively.\n *\n * Only prompts for fields that have `prompt` metadata set via `arg()` and\n * whose values are still undefined after CLI and env resolution.\n * Returns rawArgs unchanged in non-interactive environments.\n */\nexport async function promptMissingArgs(\n  rawArgs: Record<string, unknown>,\n  extracted: ExtractedFields,\n  options: PromptOptions,\n): Promise<Record<string, unknown>> {\n  const interactive = options.interactive ?? isInteractive();\n  if (!interactive) return rawArgs;\n\n  const adapter = options.adapter;\n  const result = { ...rawArgs };\n\n  // For discriminatedUnion schemas, prompt the discriminator first then\n  // narrow to the active variant to avoid prompting irrelevant fields.\n  if (\n    extracted.schemaType === \"discriminatedUnion\" &&\n    extracted.discriminator &&\n    extracted.variants\n  ) {\n    await promptDiscriminatedUnion(adapter, result, extracted);\n  } else if (extracted.schemaType === \"union\" || extracted.schemaType === \"xor\") {\n    // Plain unions have no discriminator to narrow by. Prompting the merged\n    // field set would collect answers for incompatible branches, causing\n    // silent data loss (strip mode) or validation errors (strict mode).\n    // Skip prompting and let Zod validation handle it.\n  } else {\n    // For object and intersection schemas, prompt all fields as a flat list.\n    // Limitation: intersection schemas that compose a discriminatedUnion\n    // (e.g. sharedOptions.and(z.discriminatedUnion(...))) lose variant\n    // structure here because extractFields flattens both operands. Variant-\n    // aware prompting for intersections requires architectural changes to\n    // preserve sub-schema structure through extraction.\n    await promptAllFields(adapter, result, extracted.fields);\n  }\n\n  return result;\n}\n\nasync function promptDiscriminatedUnion(\n  adapter: PromptAdapter,\n  result: Record<string, unknown>,\n  extracted: ExtractedFields,\n): Promise<void> {\n  const { discriminator, variants } = extracted;\n  if (!discriminator || !variants) return;\n\n  // Prompt for discriminator if not already provided.\n  // The deduplicated extracted.fields only keeps the first variant's\n  // discriminator, so scan all variants for prompt metadata and build\n  // choices from every variant's discriminator value.\n  if (result[discriminator] === undefined) {\n    const discField = findDiscriminatorField(extracted.fields, variants, discriminator);\n    const discConfig = discField ? resolvePromptConfig(discField) : null;\n    if (discConfig) {\n      const allValues = variants.map((v) => v.discriminatorValue).filter(Boolean);\n      if (allValues.length > 0) {\n        discConfig.type = \"select\";\n        discConfig.choices = allValues.map((v) => ({ label: v, value: v }));\n      }\n      await promptAndCollect(adapter, result, discConfig);\n    }\n  }\n\n  // Find the active variant based on discriminator value\n  const discValue = String(result[discriminator] ?? \"\");\n  const activeVariant = variants.find((v) => v.discriminatorValue === discValue);\n\n  if (activeVariant) {\n    // Prompt only the active variant's fields (excluding discriminator)\n    const variantFields = activeVariant.fields.filter((f) => f.name !== discriminator);\n    await promptAllFields(adapter, result, variantFields);\n  }\n  // When no variant matches (invalid value or unextracted discriminator),\n  // skip prompting and let Zod validation surface the error.\n}\n\n/**\n * Find the discriminator field with prompt metadata, checking the\n * deduplicated top-level fields first, then scanning per-variant fields.\n */\nfunction findDiscriminatorField(\n  fields: ResolvedFieldMeta[],\n  variants: NonNullable<ExtractedFields[\"variants\"]>,\n  discriminator: string,\n): ResolvedFieldMeta | undefined {\n  const topLevel = fields.find((f) => f.name === discriminator);\n  if (topLevel?.prompt) return topLevel;\n  for (const variant of variants) {\n    const field = variant.fields.find((f) => f.name === discriminator);\n    if (field?.prompt) return field;\n  }\n  return undefined;\n}\n\nasync function promptAllFields(\n  adapter: PromptAdapter,\n  result: Record<string, unknown>,\n  fields: ResolvedFieldMeta[],\n): Promise<void> {\n  const fieldsToPrompt = getFieldsToPrompt(fields, result);\n  for (const config of fieldsToPrompt) {\n    await promptAndCollect(adapter, result, config);\n  }\n}\n\nasync function promptAndCollect(\n  adapter: PromptAdapter,\n  result: Record<string, unknown>,\n  config: ResolvedPromptConfig,\n): Promise<void> {\n  const { message } = config;\n  let value: unknown;\n  switch (config.type) {\n    case \"text\":\n      value = await adapter.text({ message, placeholder: config.field.placeholder });\n      break;\n    case \"password\":\n      value = await adapter.password({ message });\n      break;\n    case \"confirm\":\n      value = await adapter.confirm({ message });\n      break;\n    case \"select\":\n      value = await adapter.select({ message, options: config.choices ?? [] });\n      break;\n  }\n  if (adapter.isCancelled(value)) {\n    throw new Error(\"Prompt cancelled by user\");\n  }\n  result[config.field.name] = value;\n}\n"],"mappings":"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"}

package/dist/{runner-JZRo4pYu.js → runner-CnG-Ncz0.js}

@@ -1,6 +1,5 @@
-import { a as getExtractedFields, c as toKebabCase, i as extractFields, r as resolveSubCommandMeta, s as toCamelCase } from "./lazy-D6nL_iKJ.js";
-import { a as emptyLogs, i as createLogCollector, n as resolveLazyCommand, o as mergeLogs, r as resolveSubcommand, t as listSubCommands } from "./subcommand-router-Bu3YTw_f.js";
-import { z } from "zod";
+import { a as getExtractedFields, c as toKebabCase, i as extractFields, r as resolveSubCommandMeta, s as toCamelCase } from "./lazy-xrzxwnru.js";
+import { a as emptyLogs, i as createLogCollector, n as resolveLazyCommand, o as mergeLogs, r as resolveSubcommand, t as listSubCommands } from "./subcommand-router-BhYVuS83.js";
 import { styleText } from "node:util";
 import stringWidth from "string-width";
 
@@ -1771,37 +1770,6 @@ function findSimilar(target, candidates) {
 	})).filter(({ distance }) => distance <= threshold).sort((a, b) => a.distance - b.distance).map(({ candidate }) => candidate).slice(0, 3);
 }
 /**
-* Format validation errors into a human-readable message
-*
-* @param errors - Array of validation errors
-* @returns Formatted error message
-*/
-function formatValidationErrors$1(errors) {
-	if (errors.length === 0) return "";
-	const lines = [styles.error("Validation errors:")];
-	for (const error of errors) {
-		const path = error.path.join(".");
-		lines.push(`  ${symbols.bullet} ${styles.bold(path)}: ${error.message}`);
-	}
-	return lines.join("\n");
-}
-/**
-* Format unknown flag error with suggestions
-*
-* @param flag - The unknown flag (e.g., "--verbos")
-* @param knownFlags - List of known flag names
-* @returns Formatted error message with suggestions
-*/
-function formatUnknownFlag(flag, knownFlags) {
-	const similar = findSimilar(flag.replace(/^-{1,2}/, ""), knownFlags);
-	let message = `${styles.error("Unknown option:")} ${styles.bold(flag)}`;
-	if (similar.length > 0) {
-		message += `\n\n${styles.info("Did you mean?")}`;
-		for (const suggestion of similar) message += `\n  ${symbols.arrow} ${styles.option(`--${suggestion}`)}`;
-	}
-	return message;
-}
-/**
 * Format unknown flag warning with suggestions (for strip mode)
 *
 * @param flag - The unknown flag (e.g., "--verbos")
@@ -1828,22 +1796,6 @@ function formatRuntimeError(error, debug) {
 	if (debug && error.stack) return `${styles.error("Error:")} ${error.message}\n\n${styles.dim(error.stack)}`;
 	return `${styles.error("Error:")} ${error.message}`;
 }
-/**
-* Format unknown subcommand error with suggestions
-*
-* @param subcommand - The unknown subcommand name
-* @param knownSubcommands - List of known subcommand names
-* @returns Formatted error message with suggestions
-*/
-function formatUnknownSubcommand(subcommand, knownSubcommands) {
-	const similar = findSimilar(subcommand, knownSubcommands);
-	let message = `${styles.error("Unknown command:")} ${styles.bold(subcommand)}`;
-	if (similar.length > 0) {
-		message += `\n\n${styles.info("Did you mean?")}`;
-		for (const suggestion of similar) message += `\n  ${symbols.arrow} ${styles.command(suggestion)}`;
-	}
-	return message;
-}
 
 //#endregion
 //#region src/validator/zod-validator.ts
@@ -2046,6 +1998,7 @@ async function runMain(command, options = {}) {
 		handleSignals: true,
 		logger: options.logger,
 		globalArgs: options.globalArgs,
+		prompt: options.prompt,
 		_globalExtracted: globalExtracted,
 		_globalCleanup: options.cleanup,
 		_context: {
@@ -2055,6 +2008,7 @@ async function runMain(command, options = {}) {
 			globalExtracted
 		}
 	});
+	if ((options.displayErrors ?? true) && !result.success && result.error) (options.logger ?? defaultLogger).error(formatRuntimeError(result.error, options.debug ?? false));
 	if (options.cleanup) {
 		const cleanupCtx = { error: !result.success ? result.error : void 0 };
 		try {
@@ -2062,6 +2016,7 @@ async function runMain(command, options = {}) {
 		} catch {}
 	}
 	if (process.stdout.writableLength > 0) await new Promise((resolve) => process.stdout.once("drain", resolve));
+	if (process.stderr.writableLength > 0) await new Promise((resolve) => process.stderr.once("drain", resolve));
 	process.exit(result.exitCode);
 }
 /**
@@ -2093,11 +2048,7 @@ async function runCommandInternal(command, argv, options = {}) {
 			const subCmdNames = listSubCommands(command);
 			if (subCmdNames.length > 0) {
 				const potentialSubCmd = findFirstPositional(argv, context.globalExtracted);
-				if (potentialSubCmd && !subCmdNames.includes(potentialSubCmd)) {
-					logger.error(formatUnknownSubcommand(potentialSubCmd, subCmdNames));
-					logger.error("");
-					hasUnknownSubcommand = true;
-				}
+				if (potentialSubCmd && !subCmdNames.includes(potentialSubCmd)) hasUnknownSubcommand = true;
 			}
 			const help = generateHelp(command, {
 				showSubcommands: options.showSubcommands ?? true,
@@ -2106,12 +2057,17 @@ async function runCommandInternal(command, argv, options = {}) {
 			});
 			logger.log(help);
 			collector?.stop();
-			if (hasUnknownSubcommand) return {
-				success: false,
-				error: /* @__PURE__ */ new Error(`Unknown subcommand: ${argv.find((arg) => !arg.startsWith("-"))}`),
-				exitCode: 1,
-				logs: getCurrentLogs()
-			};
+			if (hasUnknownSubcommand) {
+				const unknownCmd = findFirstPositional(argv, context.globalExtracted) ?? "";
+				const similar = findSimilar(unknownCmd, subCmdNames);
+				const suggestion = similar.length > 0 ? ` Did you mean: ${similar.join(", ")}?` : "";
+				return {
+					success: false,
+					error: /* @__PURE__ */ new Error(`Unknown subcommand: ${unknownCmd}${suggestion ? `.${suggestion}` : ""}`),
+					exitCode: 1,
+					logs: getCurrentLogs()
+				};
+			}
 			return {
 				success: true,
 				result: void 0,
@@ -2166,7 +2122,6 @@ async function runCommandInternal(command, argv, options = {}) {
 			const unknownKeysMode = parseResult.extractedFields?.unknownKeysMode ?? "strip";
 			const knownFlags = parseResult.extractedFields?.fields.map((f) => f.name) ?? [];
 			if (unknownKeysMode === "strict") {
-				for (const flag of parseResult.unknownFlags) logger.error(formatUnknownFlag(flag, knownFlags));
 				collector?.stop();
 				return {
 					success: false,
@@ -2188,14 +2143,16 @@ async function runCommandInternal(command, argv, options = {}) {
 					}
 				}
 			}
+			if (options.prompt) {
+				const resolved = await options.prompt(accumulatedGlobalArgs, options._globalExtracted);
+				Object.assign(accumulatedGlobalArgs, resolved);
+			}
 			const globalValidation = validateArgs(accumulatedGlobalArgs, options.globalArgs);
 			if (!globalValidation.success) {
-				const errorMessage = formatValidationErrors$1(globalValidation.errors);
-				logger.error(errorMessage);
 				collector?.stop();
 				return {
 					success: false,
-					error: new Error(errorMessage),
+					error: new Error(formatValidationErrors(globalValidation.errors)),
 					exitCode: 1,
 					logs: getCurrentLogs()
 				};
@@ -2213,13 +2170,20 @@ async function runCommandInternal(command, argv, options = {}) {
 				globalCleanup: options._globalCleanup
 			});
 		}
-		const validationResult = validateArgs(parseResult.rawArgs, command.args);
+		let argsToValidate = parseResult.rawArgs;
+		if (options.prompt && parseResult.extractedFields) {
+			const resolved = await options.prompt(argsToValidate, parseResult.extractedFields);
+			argsToValidate = {
+				...argsToValidate,
+				...resolved
+			};
+		}
+		const validationResult = validateArgs(argsToValidate, command.args);
 		if (!validationResult.success) {
-			logger.error(formatValidationErrors$1(validationResult.errors));
 			collector?.stop();
 			return {
 				success: false,
-				error: new Error(formatValidationErrors$1(validationResult.errors)),
+				error: new Error(formatValidationErrors(validationResult.errors)),
 				exitCode: 1,
 				logs: getCurrentLogs()
 			};
@@ -2241,7 +2205,6 @@ async function runCommandInternal(command, argv, options = {}) {
 		});
 	} catch (error) {
 		const err = error instanceof Error ? error : new Error(String(error));
-		logger.error(formatRuntimeError(err, options.debug ?? false));
 		collector?.stop();
 		return {
 			success: false,
@@ -2272,4 +2235,4 @@ function extractAndValidateGlobal(options) {
 
 //#endregion
 export { logger as C, createDualCaseProxy as D, symbols as E, isColorEnabled as S, styles as T, PositionalConfigError as _, parseArgv as a, renderInline as b, validateCommand as c, validateDuplicateFields as d, validatePositionalConfig as f, DuplicateFieldError as g, DuplicateAliasError as h, formatValidationErrors as i, validateCrossSchemaCollisions as l, CaseVariantCollisionError as m, runMain as n, formatCommandValidationErrors as o, validateReservedAliases as p, runner_exports as r, validateCaseVariantCollisions as s, runCommand as t, validateDuplicateAliases as u, ReservedAliasError as v, setColorEnabled as w, renderMarkdown as x, generateHelp as y };
-//# sourceMappingURL=runner-JZRo4pYu.js.map
+//# sourceMappingURL=runner-CnG-Ncz0.js.map