alepha 0.22.0 → 0.24.0

package/dist/command/index.js

@@ -1,187 +1,24 @@
-import { $atom, $env, $hook, $inject, $module, $state, Alepha, AlephaError, KIND, Primitive, TypeBoxError, createPrimitive, t } from "alepha";
+import { $atom, $env, $hook, $inject, $module, $state, Alepha, AlephaError, KIND, Primitive, TypeBoxError, coerceScalar, createPrimitive, z } from "alepha";
 import { stdin, stdout } from "node:process";
 import { createInterface } from "node:readline/promises";
 import { $logger, ConsoleColorProvider } from "alepha/logger";
 import { FileSystemProvider, ShellProvider } from "alepha/system";
-import { DateTimeProvider } from "alepha/datetime";
 import * as fs from "node:fs/promises";
 import { cp, glob, rm } from "node:fs/promises";
-//#region ../../src/command/helpers/PrettyAsker.ts
+import { DateTimeProvider } from "alepha/datetime";
+//#region ../../src/command/helpers/Asker.ts
 /**
-* Clack-style interactive prompt renderer.
+* Reads interactive input from the terminal using plain readline prompts.
 *
-* Provides pretty enum selectors (arrow-key navigation),
-* text inputs, and confirm prompts with box-drawing framing.
+* One straightforward code path: questions are printed through the logger
+* and answers are read with Node's `readline`. No raw-mode cursor control,
+* no ANSI framing — output stays greppable and works the same in a TTY,
+* under CI, or when piped.
 */
-var PrettyAsker = class {
-	alepha = $inject(Alepha);
-	color = $inject(ConsoleColorProvider);
-	/**
-	* Whether to use pretty mode.
-	*
-	* Same conditions as Runner.useDynamicLogger.
-	*/
-	get enabled() {
-		if (this.alepha.isCI() || this.alepha.env.CLAUDECODE) return false;
-		const logLevel = String(this.alepha.env.LOG_LEVEL || "").toLowerCase();
-		if (logLevel === "debug" || logLevel === "trace") return false;
-		return true;
-	}
-	/**
-	* Print the opening frame with a title.
-	*/
-	intro(title) {
-		const c = this.color;
-		this.write(`\n${c.set("DIM", "┌")}  ${c.set("BOLD", title)}\n`);
-		this.write(`${c.set("DIM", "│")}\n`);
-	}
-	/**
-	* Print the closing frame with a message.
-	*/
-	outro(message) {
-		const c = this.color;
-		this.write(`${c.set("DIM", "│")}\n`);
-		this.write(`${c.set("DIM", "└")}  ${message}\n\n`);
-	}
-	/**
-	* Arrow-key select prompt for enum schemas.
-	*/
-	async select(question, options) {
-		let selectedIndex = 0;
-		this.write(`${this.color.set("DIM", "│")}\n`);
-		this.writeActiveMarker(question);
-		this.renderOptions(options, selectedIndex);
-		return new Promise((resolve, reject) => {
-			if (!(typeof stdin.setRawMode === "function")) {
-				this.clearOptions(options.length);
-				this.writeCompletedMarker(question);
-				this.writeAnswer(options[0]);
-				resolve(options[0]);
-				return;
-			}
-			stdin.setRawMode(true);
-			stdin.resume();
-			const onKeypress = (data) => {
-				const key = data.toString();
-				if (key === "") {
-					cleanup();
-					stdin.setRawMode(false);
-					stdin.pause();
-					reject(new AlephaError("Aborted."));
-					return;
-				}
-				if (key === "\x1B[A" || key === "k") {
-					selectedIndex = (selectedIndex - 1 + options.length) % options.length;
-					this.clearOptions(options.length);
-					this.renderOptions(options, selectedIndex);
-					return;
-				}
-				if (key === "\x1B[B" || key === "j") {
-					selectedIndex = (selectedIndex + 1) % options.length;
-					this.clearOptions(options.length);
-					this.renderOptions(options, selectedIndex);
-					return;
-				}
-				if (key === "\r" || key === "\n") {
-					cleanup();
-					stdin.setRawMode(false);
-					stdin.pause();
-					this.clearOptions(options.length);
-					this.clearActiveMarker();
-					this.writeCompletedMarker(question);
-					this.writeAnswer(options[selectedIndex]);
-					resolve(options[selectedIndex]);
-				}
-			};
-			const cleanup = () => {
-				stdin.removeListener("data", onKeypress);
-			};
-			stdin.on("data", onKeypress);
-		});
-	}
-	/**
-	* Text input prompt with clack framing.
-	*/
-	async text(question, schema) {
-		const c = this.color;
-		const defaultValue = schema && "default" in schema ? String(schema.default) : void 0;
-		this.write(`${c.set("DIM", "│")}\n`);
-		this.writeActiveMarker(question);
-		const defaultHint = defaultValue ? ` ${c.set("DIM", `(${defaultValue})`)}` : "";
-		this.write(`${c.set("DIM", "│")}  ${c.set("DIM", ">")}${defaultHint} `);
-		const rl = this.createPromptInterface();
-		try {
-			const value = (await rl.question("")).trim() || defaultValue || "";
-			this.write("\x1B[1A\x1B[2K");
-			this.clearActiveMarker();
-			this.writeCompletedMarker(question);
-			this.writeAnswer(value);
-			if (schema) return this.alepha.codec.decode(schema, value || void 0);
-			return value;
-		} finally {
-			rl.close();
-		}
-	}
-	/**
-	* Yes/No confirm prompt with clack framing.
-	*/
-	async confirm(question) {
-		const c = this.color;
-		this.write(`${c.set("DIM", "│")}\n`);
-		this.writeActiveMarker(`${question} ${c.set("DIM", "(Y/n)")}`);
-		this.write(`${c.set("DIM", "│")}  ${c.set("DIM", ">")} `);
-		const rl = this.createPromptInterface();
-		try {
-			const value = (await rl.question("")).trim().toLowerCase();
-			const result = value !== "n" && value !== "no";
-			this.write("\x1B[1A\x1B[2K");
-			this.clearActiveMarker();
-			this.writeCompletedMarker(question);
-			this.writeAnswer(result ? "Yes" : "No");
-			return result;
-		} finally {
-			rl.close();
-		}
-	}
-	renderOptions(options, selectedIndex) {
-		const c = this.color;
-		for (let i = 0; i < options.length; i++) {
-			const marker = i === selectedIndex ? `${c.set("CYAN", "❯")} ${c.set("CYAN", options[i])}` : `  ${c.set("DIM", options[i])}`;
-			this.write(`${c.set("DIM", "│")}  ${marker}\n`);
-		}
-	}
-	clearOptions(count) {
-		for (let i = 0; i < count; i++) this.write("\x1B[1A\x1B[2K");
-	}
-	writeActiveMarker(question) {
-		this.write(`${this.color.set("CYAN", "◆")}  ${question}\n`);
-	}
-	clearActiveMarker() {
-		this.write("\x1B[1A\x1B[2K");
-	}
-	writeCompletedMarker(question) {
-		this.write(`${this.color.set("DIM", "◇")}  ${question}\n`);
-	}
-	writeAnswer(value) {
-		this.write(`${this.color.set("DIM", "│")}  ${this.color.set("DIM", value)}\n`);
-	}
-	write(str) {
-		stdout.write(str);
-	}
-	createPromptInterface() {
-		return createInterface({
-			input: stdin,
-			output: stdout
-		});
-	}
-};
-//#endregion
-//#region ../../src/command/helpers/Asker.ts
 var Asker = class {
 	log = $logger();
 	ask;
 	alepha = $inject(Alepha);
-	pretty = $inject(PrettyAsker);
 	constructor() {
 		this.ask = this.createAskMethod();
 	}
@@ -190,45 +27,23 @@ var Asker = class {
 			return await this.prompt(question, options);
 		};
 		askFn.permission = async (question) => {
-			if (this.pretty.enabled) return this.pretty.confirm(question);
-			return (await this.prompt(`${question} [Y/n]`, { schema: t.enum([
+			return (await this.prompt(`${question} [Y/n]`, { schema: z.enum([
 				"Y",
 				"y",
 				"n",
 				"no",
 				"yes"
-			], { default: "Y" }) })).charAt(0).toLowerCase() === "y";
+			]).default("Y") })).charAt(0).toLowerCase() === "y";
 		};
 		askFn.intro = (title) => {
-			if (this.pretty.enabled) this.pretty.intro(title);
+			this.log.info(title);
 		};
 		askFn.outro = (message) => {
-			if (this.pretty.enabled) this.pretty.outro(message);
+			if (message) this.log.info(message);
 		};
 		return askFn;
 	}
 	async prompt(question, options) {
-		if (this.pretty.enabled) return this.prettyPrompt(question, options);
-		return this.plainPrompt(question, options);
-	}
-	/**
-	* Pretty mode: delegate to PrettyAsker based on schema type.
-	*/
-	async prettyPrompt(question, options) {
-		const schema = options.schema;
-		if (schema?.enum && Array.isArray(schema.enum)) {
-			const value = await this.pretty.select(question, schema.enum);
-			if (options.validate) options.validate(value);
-			return value;
-		}
-		const value = await this.pretty.text(question, schema);
-		if (options.validate) options.validate(value);
-		return value;
-	}
-	/**
-	* Plain mode: readline-based prompts (CI, Claude Code, debug).
-	*/
-	async plainPrompt(question, options) {
 		const rl = this.createPromptInterface();
 		let value;
 		try {
@@ -236,8 +51,10 @@ var Asker = class {
 				try {
 					this.log.info(question);
 					const answer = await rl.question("> ");
-					if (options.schema) value = this.alepha.codec.decode(options.schema, answer ? answer.trim() : void 0);
-					else value = String(answer.trim());
+					if (options.schema) {
+						const raw = answer ? answer.trim() : void 0;
+						value = this.alepha.codec.decode(options.schema, raw === void 0 ? void 0 : coerceScalar(options.schema, raw));
+					} else value = String(answer.trim());
 					if (options.validate) options.validate(value);
 				} catch (error) {
 					if (error instanceof AlephaError) {
@@ -315,259 +132,41 @@ var EnvUtils = class {
 	}
 };
 //#endregion
-//#region ../../src/command/helpers/PrettyPrint.ts
-var PrettyPrint = class {
-	dateTimeProvider = $inject(DateTimeProvider);
-	spinnerInterval;
-	frames = [
-		"⠋",
-		"⠙",
-		"⠹",
-		"⠸",
-		"⠼",
-		"⠴",
-		"⠦",
-		"⠧",
-		"⠇",
-		"⠏"
-	];
-	tasks = /* @__PURE__ */ new Map();
-	lastLineCount = 0;
-	header;
-	commandStartTime;
-	paused = false;
-	originalStdoutWrite;
-	bufferedOutput = [];
-	isOwnWrite = false;
-	colors = {
-		reset: "\x1B[0m",
-		cyan: "\x1B[36m",
-		green: "\x1B[32m",
-		red: "\x1B[31m",
-		dim: "\x1B[2m"
-	};
-	/**
-	* Start a new command session with header
-	*/
-	startCommand(cliName, commandName) {
-		this.header = commandName ? `${cliName} ${commandName}` : cliName;
-		this.commandStartTime = this.dateTimeProvider.nowMillis();
-		this.tasks.clear();
-		this.lastLineCount = 0;
-		this.write(`┌─ ${this.header}\n`);
-	}
-	/**
-	* End the command session with footer
-	*/
-	endCommand() {
-		this.restoreStdout();
-		if (this.commandStartTime) {
-			const totalDuration = ((this.dateTimeProvider.nowMillis() - this.commandStartTime) / 1e3).toFixed(1);
-			this.write(`└─ Done in ${totalDuration}s\n`);
-		}
-		this.header = void 0;
-		this.commandStartTime = void 0;
-	}
-	/**
-	* Start an animated spinner with a task name
-	*/
-	startSpinner(id, taskName) {
-		this.tasks.set(id, {
-			taskName,
-			frameIndex: 0,
-			status: "running",
-			startTime: this.dateTimeProvider.nowMillis()
-		});
-		this.interceptStdout();
-		if (!this.spinnerInterval) this.spinnerInterval = this.dateTimeProvider.createInterval(() => this.updateDisplay(), 80, true);
-		this.updateDisplay();
-	}
-	/**
-	* Stop the spinner and show success with a tick
-	*/
-	success(id, taskName, duration, message) {
-		const task = this.tasks.get(id);
-		if (task) {
-			task.status = "success";
-			if (taskName) task.taskName = taskName;
-			if (duration) task.duration = duration;
-			if (message) task.message = message;
-			this.updateDisplay();
-		}
-		this.checkIfAllDone();
-	}
-	/**
-	* Stop the spinner and show error with a cross
-	*/
-	error(id, taskName) {
-		const task = this.tasks.get(id);
-		if (task) {
-			task.status = "error";
-			if (taskName) task.taskName = taskName;
-			this.updateDisplay();
-		}
-		this.checkIfAllDone();
-		this.restoreStdout();
-	}
-	/**
-	* Update the display for all tasks
-	*/
-	updateDisplay() {
-		if (this.lastLineCount > 0) for (let i = 0; i < this.lastLineCount; i++) this.write("\x1B[1A\x1B[2K");
-		if (this.bufferedOutput.length > 0) {
-			for (const chunk of this.bufferedOutput) this.write(chunk);
-			this.bufferedOutput = [];
-		}
-		const taskArray = Array.from(this.tasks.values());
-		const prefix = this.header ? "│  " : "";
-		for (const task of taskArray) {
-			let line = prefix;
-			if (task.status === "running") {
-				const frame = this.frames[task.frameIndex];
-				const elapsed = String(Math.floor((this.dateTimeProvider.nowMillis() - task.startTime) / 100) / 10).padEnd(3, ".0");
-				line += `${this.colors.cyan}${frame}${this.colors.reset} ${this.colors.dim}${task.taskName}${this.colors.reset}  ${this.colors.dim}${elapsed}s${this.colors.reset}`;
-				task.frameIndex = (task.frameIndex + 1) % this.frames.length;
-			} else if (task.status === "success") {
-				const durationStr = task.duration ? `  ${this.colors.dim}${task.duration}${this.colors.reset}` : "";
-				const messageStr = task.message ? ` - ${task.message}` : "";
-				line += `${this.colors.green}✓${this.colors.reset} ${task.taskName}${durationStr}${messageStr}`;
-			} else if (task.status === "error") line += `${this.colors.red}✗${this.colors.reset} ${task.taskName}`;
-			this.write(`${line}\n`);
-		}
-		this.lastLineCount = taskArray.length;
-	}
-	/**
-	* Check if all tasks are done and stop the interval
-	*/
-	checkIfAllDone() {
-		if (!Array.from(this.tasks.values()).some((task) => task.status === "running") && this.spinnerInterval) {
-			this.dateTimeProvider.clearInterval(this.spinnerInterval);
-			this.spinnerInterval = void 0;
-		}
-	}
-	/**
-	* Pause the spinner animation and restore stdout so external processes
-	* (e.g. interactive login) can write to the terminal directly.
-	*/
-	pause() {
-		if (this.paused) return;
-		this.paused = true;
-		this.stopSpinner();
-		if (this.lastLineCount > 0) {
-			for (let i = 0; i < this.lastLineCount; i++) this.write("\x1B[1A\x1B[2K");
-			this.lastLineCount = 0;
-		}
-		if (this.header) this.write("└───\n\n");
-		this.restoreStdout();
-	}
-	/**
-	* Resume the spinner animation after a pause.
-	*/
-	resume() {
-		if (!this.paused) return;
-		this.paused = false;
-		if (this.header) this.write("\n┌───\n");
-		this.interceptStdout();
-		if (Array.from(this.tasks.values()).some((task) => task.status === "running")) {
-			this.updateDisplay();
-			if (!this.spinnerInterval) this.spinnerInterval = this.dateTimeProvider.createInterval(() => this.updateDisplay(), 80, true);
-		}
-	}
-	/**
-	* Stop the spinner without showing any symbol
-	*/
-	stopSpinner() {
-		if (this.spinnerInterval) {
-			this.dateTimeProvider.clearInterval(this.spinnerInterval);
-			this.spinnerInterval = void 0;
-		}
-	}
-	/**
-	* Clear all tasks
-	*/
-	clear() {
-		this.tasks.clear();
-		this.stopSpinner();
-		this.restoreStdout();
-		this.lastLineCount = 0;
-	}
-	/**
-	* Intercept process.stdout.write so external writes (logs, wrangler output)
-	* are buffered instead of breaking the spinner animation. Buffered output is
-	* flushed above the spinner area on each redraw.
-	*/
-	interceptStdout() {
-		if (this.originalStdoutWrite) return;
-		const original = process.stdout.write.bind(process.stdout);
-		this.originalStdoutWrite = original;
-		process.stdout.write = ((chunk, encodingOrCb, cb) => {
-			if (this.isOwnWrite) return original(chunk, encodingOrCb, cb);
-			this.bufferedOutput.push(String(chunk));
-			return true;
-		});
-	}
-	/**
-	* Restore the original process.stdout.write and flush remaining buffer.
-	*/
-	restoreStdout() {
-		if (!this.originalStdoutWrite) return;
-		const original = this.originalStdoutWrite;
-		this.originalStdoutWrite = void 0;
-		process.stdout.write = original;
-		for (const chunk of this.bufferedOutput) original(chunk);
-		this.bufferedOutput = [];
-	}
-	/**
-	* Write to stdout bypassing the intercept.
-	*/
-	write(str) {
-		this.isOwnWrite = true;
-		process.stdout.write(str);
-		this.isOwnWrite = false;
-	}
-};
-//#endregion
 //#region ../../src/command/errors/CommandError.ts
 var CommandError = class extends AlephaError {
 	name = "CommandError";
 };
 //#endregion
 //#region ../../src/command/helpers/Runner.ts
+/**
+* Runs CLI tasks (shell commands or functions) and logs their lifecycle.
+*
+* Output is intentionally plain and verbose: every task logs a
+* `Starting …` / `Finished … after Ns` line through the standard logger,
+* and shelled commands **stream** their stdout/stderr straight to the
+* terminal (`capture: false`) so tool output — `vite build` warnings,
+* Biome diagnostics, nested `alepha` subcommands — is visible live.
+*/
 var Runner = class {
 	log = $logger();
 	dateTime = $inject(DateTimeProvider);
 	timers = [];
 	startTime = this.dateTime.nowMillis();
-	prettyPrint = $inject(PrettyPrint);
 	alepha = $inject(Alepha);
 	shell = $inject(ShellProvider);
 	run;
-	cliName = "";
-	commandName = "";
-	firstTaskStarted = false;
-	taskCounter = 0;
 	constructor() {
 		this.run = this.createRunMethod();
 	}
-	get useDynamicLogger() {
-		if (this.alepha.isCI() || this.alepha.env.CLAUDECODE) return false;
-		const logLevel = String(this.alepha.store.get("alepha.logger.level") ?? this.alepha.env.LOG_LEVEL ?? "").toLowerCase();
-		if (logLevel === "debug" || logLevel === "trace") return false;
-		return (this.alepha.store.get("alepha.logger.format") ?? this.alepha.env.LOG_FORMAT) === "raw";
-	}
 	/**
-	* Start a new command session with header (for pretty print mode)
+	* Start a new command session.
+	*
+	* Retained for API compatibility (the CLI calls it before each command);
+	* task lifecycle is now logged statelessly, so there is nothing to reset.
 	*/
-	startCommand(cliName, commandName) {
-		this.cliName = cliName;
-		this.commandName = commandName;
-		this.firstTaskStarted = false;
-		this.taskCounter = 0;
-	}
+	startCommand(_cliName, _commandName) {}
 	createRunMethod() {
 		const runFn = async (cmd, options) => {
-			if (this.useDynamicLogger && !this.firstTaskStarted) this.prettyPrint.startCommand(this.cliName, this.commandName);
-			this.firstTaskStarted = true;
 			const root = typeof options === "object" && options.root ? options.root : void 0;
 			if (Array.isArray(cmd)) return await this.execute(cmd.map((it) => typeof it === "string" ? {
 				name: it,
@@ -610,18 +209,13 @@ var Runner = class {
 			}, options);
 		};
 		runFn.end = () => this.end();
-		runFn.pause = () => {
-			if (this.useDynamicLogger) this.prettyPrint.pause();
-		};
-		runFn.resume = () => {
-			if (this.useDynamicLogger) this.prettyPrint.resume();
-		};
 		return runFn;
 	}
 	async exec(cmd, opts = {}) {
+		const stream = this.log.isLevelEnabled("DEBUG");
 		return this.shell.run(cmd, {
 			root: opts.root,
-			capture: true
+			capture: !stream
 		});
 	}
 	/**
@@ -639,55 +233,34 @@ var Runner = class {
 	* Prints a summary of all executed tasks and their durations.
 	*/
 	end() {
-		if (this.useDynamicLogger && this.firstTaskStarted) {
-			this.prettyPrint.endCommand();
-			return;
-		}
 		if (this.timers.length === 0) return;
-		this.log.info("");
 		const totalTime = ((this.dateTime.nowMillis() - this.startTime) / 1e3).toFixed(1);
 		this.log.info(`Total time: ${totalTime}s`);
-		this.log.info(``);
 		this.timers = [];
 	}
 	async executeTask(task) {
 		const now = this.dateTime.nowMillis();
-		const taskId = `task-${++this.taskCounter}`;
-		if (this.useDynamicLogger) this.prettyPrint.startSpinner(taskId, task.name);
-		else this.log.info(`Starting '${task.name}' ...`);
+		this.log.info(`Starting '${task.name}' ...`);
 		let stdout = "";
 		try {
 			stdout = String(await task.handler() ?? "");
 		} catch (error) {
-			if (this.useDynamicLogger) this.prettyPrint.error(taskId, task.name);
-			if (error instanceof Error && "stdout" in error) this.log.info(`\n\n${error.stdout}`);
+			const err = error;
+			const captured = [err?.stdout, err?.stderr].filter(Boolean).join("\n").trim();
+			if (captured) this.log.info(`\n\n${captured}`);
 			throw new CommandError(`Task '${task.name}' failed`, { cause: error });
 		}
 		if (stdout) this.log.trace(stdout);
 		const duration = ((this.dateTime.nowMillis() - now) / 1e3).toFixed(1);
 		const message = stdout && !stdout.includes("\n") ? stdout.trim() : void 0;
-		if (this.useDynamicLogger) this.prettyPrint.success(taskId, task.name, `${duration}s`, message);
-		else {
-			const suffix = message ? ` - ${message}` : "";
-			this.log.info(`Finished '${task.name}' after ${duration}s${suffix}`);
-		}
+		const suffix = message ? ` - ${message}` : "";
+		this.log.info(`Finished '${task.name}' after ${duration}s${suffix}`);
 		this.timers.push({
 			name: task.name,
 			duration: `${duration}s`
 		});
 		return stdout;
 	}
-	renderTable(data) {
-		if (data.length === 0) return;
-		const col1Width = Math.max(...data.map(([col1]) => col1.length), 7);
-		const col2Width = Math.max(...data.map(([, col2]) => col2.length), 8);
-		const divider = `+${"-".repeat(col1Width + 2)}+${"-".repeat(col2Width + 2)}+`;
-		this.log.info(divider);
-		this.log.info(`| ${"Command".padEnd(col1Width)} | ${"Duration".padEnd(col2Width)} |`);
-		this.log.info(divider);
-		for (const [col1, col2] of data) this.log.info(`| ${col1.padEnd(col1Width)} | ${col2.padEnd(col2Width)} |`);
-		this.log.info(divider);
-	}
 };
 //#endregion
 //#region ../../src/command/primitives/$command.ts
@@ -699,8 +272,8 @@ var Runner = class {
 */
 const $command = (options) => createPrimitive(CommandPrimitive, options);
 var CommandPrimitive = class extends Primitive {
-	flags = this.options.flags ?? t.object({});
-	env = this.options.env ?? t.object({});
+	flags = this.options.flags ?? z.object({});
+	env = this.options.env ?? z.object({});
 	aliases = this.options.aliases ?? [];
 	onInit() {
 		if (this.options.pre || this.options.post) this.options.hide ??= true;
@@ -733,12 +306,12 @@ var CommandPrimitive = class extends Primitive {
 $command[KIND] = CommandPrimitive;
 //#endregion
 //#region ../../src/command/providers/CliProvider.ts
-const envSchema = t.object({
-	CLI_NAME: t.text({
+const envSchema = z.object({
+	CLI_NAME: z.text({
 		default: "cli",
 		description: "Name of the CLI application."
 	}),
-	CLI_DESCRIPTION: t.text({
+	CLI_DESCRIPTION: z.text({
 		default: "",
 		description: "Description of the CLI application."
 	})
@@ -748,10 +321,10 @@ const envSchema = t.object({
 */
 const cliOptions = $atom({
 	name: "alepha.command.cli.options",
-	schema: t.object({
-		name: t.optional(t.string({ description: "Name of the CLI application." })),
-		description: t.optional(t.string({ description: "Description of the CLI application." })),
-		argv: t.optional(t.array(t.string(), { description: "Command line arguments to parse." }))
+	schema: z.object({
+		name: z.string().describe("Name of the CLI application.").optional(),
+		description: z.string().describe("Description of the CLI application.").optional(),
+		argv: z.array(z.string()).describe("Command line arguments to parse.").optional()
 	}),
 	default: {}
 });
@@ -772,7 +345,7 @@ const cliOptions = $atom({
 *   build = $command({
 *     name: "build",
 *     description: "Build the project",
-*     flags: t.object({ watch: t.optional(t.boolean()) }),
+*     flags: z.object({ watch: z.boolean().optional() }),
 *     handler: async ({ flags }) => { ... }
 *   });
 * }
@@ -806,12 +379,12 @@ var CliProvider = class {
 		help: {
 			aliases: ["h", "help"],
 			description: "Show this help message",
-			schema: t.boolean()
+			schema: z.boolean()
 		},
 		verbose: {
 			aliases: ["verbose"],
-			description: "Verbose output: debug logs in plain pretty format (turns off the dynamic CLI UI).",
-			schema: t.boolean()
+			description: "Verbose output: trace-level logs (framework internals) in pretty format. Task output already streams by default.",
+			schema: z.boolean()
 		}
 	};
 	/**
@@ -828,8 +401,8 @@ var CliProvider = class {
 				key,
 				...value
 			})), { strict: false });
-			if (globalFlags.verbose) {
-				this.alepha.store.set("alepha.logger.level", "debug");
+			if (globalFlags.verbose || !!this.alepha.env.CLAUDECODE) {
+				this.alepha.store.set("alepha.logger.level", "trace");
 				this.alepha.store.set("alepha.logger.format", "pretty");
 			}
 			if (globalFlags.help) {
@@ -1050,21 +623,44 @@ var CliProvider = class {
 		return { ...this.globalFlags };
 	}
 	/**
+	* Read a schema's metadata (`title`, `description`, `aliases`, `alias`, …).
+	*
+	* Under zod these options live on the schema's `.meta()` registry rather than
+	* as direct properties (typebox), and they sit on the INNER schema — so any
+	* optional / nullable / default wrappers are peeled first.
+	*/
+	schemaMeta(schema) {
+		if (!schema) return {};
+		const base = z.schema.unwrap(schema);
+		return (typeof base?.meta === "function" ? base.meta() : void 0) ?? {};
+	}
+	/**
+	* Build flag definitions (key, aliases, description, schema) from a flags
+	* object schema. Centralises the metadata reading so every call-site (parsing,
+	* arg-splitting, help) extracts aliases/descriptions the same way.
+	*/
+	extractFlagDefs(schema) {
+		return Object.entries(schema.properties).map(([key, value]) => {
+			const meta = this.schemaMeta(value);
+			return {
+				key,
+				aliases: [key, ...meta.aliases ?? (meta.alias ? [meta.alias] : [])],
+				description: meta.description,
+				schema: value
+			};
+		});
+	}
+	/**
 	* Parse command flags from argv using the command's flag schema
 	*/
 	parseCommandFlags(argv, schema, options = {}) {
 		const { modeEnabled = false } = options;
-		const flagDefs = Object.entries(schema.properties).map(([key, value]) => ({
-			key,
-			aliases: [key, ...value.aliases ?? (value.alias ? [value.alias] : void 0) ?? []],
-			description: value.description,
-			schema: value
-		}));
+		const flagDefs = this.extractFlagDefs(schema);
 		if (modeEnabled) flagDefs.push({
 			key: "__mode__",
 			aliases: ["mode", "m"],
 			description: void 0,
-			schema: t.string()
+			schema: z.string()
 		});
 		const claimed = new Set(flagDefs.flatMap((d) => d.aliases));
 		for (const [key, value] of Object.entries(this.getAllGlobalFlags())) {
@@ -1079,9 +675,9 @@ var CliProvider = class {
 		const parsed = this.parseFlags(argv, flagDefs);
 		parsed.__mode__ = void 0;
 		for (const key of Object.keys(parsed)) if (key.startsWith("__global_")) delete parsed[key];
-		for (const [key, value] of Object.entries(schema.properties)) if (!(key in parsed) && t.schema.isOptional(value)) {
-			const innerSchema = value;
-			if (innerSchema && "default" in innerSchema) parsed[key] = innerSchema.default;
+		for (const [key, value] of Object.entries(schema.properties)) if (!(key in parsed)) {
+			const def = z.schema.getDefault(value);
+			if (def !== void 0) parsed[key] = def;
 		}
 		try {
 			return this.alepha.codec.decode(schema, parsed);
@@ -1099,8 +695,11 @@ var CliProvider = class {
 		for (const [key, propSchema] of Object.entries(schema.properties)) {
 			const value = process.env[key];
 			if (value !== void 0) result[key] = value;
-			else if ("default" in propSchema) result[key] = propSchema.default;
-			else if (t.schema.isOptional(propSchema)) {} else missing.push(key);
+			else {
+				const def = z.schema.getDefault(propSchema);
+				if (def !== void 0) result[key] = def;
+				else if (z.schema.isOptional(propSchema)) {} else missing.push(key);
+			}
 		}
 		if (missing.length > 0) {
 			const vars = missing.join(", ");
@@ -1146,42 +745,47 @@ var CliProvider = class {
 			const arg = argv[i];
 			if (!arg.startsWith("-")) continue;
 			const [rawKey, ...valueParts] = arg.replace(/^-{1,2}/, "").split("=");
-			let value = valueParts.join("=");
+			const value = valueParts.join("=");
 			const def = flagDefs.find((d) => d.aliases.includes(rawKey));
 			if (!def) {
 				if (strict) throw new CommandError(`Unknown flag: --${rawKey}`);
 				continue;
 			}
-			const isUnionWithBoolean = t.schema.isUnion(def.schema) && def.schema.anyOf.some((s) => t.schema.isBoolean(s));
-			if (t.schema.isBoolean(def.schema)) result[def.key] = true;
+			const base = z.schema.unwrap(def.schema);
+			const isUnionWithBoolean = z.schema.isUnion(base) && base.anyOf.some((s) => z.schema.isBoolean(s));
+			if (z.schema.isBoolean(base)) result[def.key] = true;
 			else if (isUnionWithBoolean && !value) {
 				const nextArg = argv[i + 1];
 				if (nextArg && !nextArg.startsWith("-")) {
 					result[def.key] = nextArg;
 					i++;
 				} else result[def.key] = true;
-			} else if (value) try {
-				if (t.schema.isObject(def.schema) || t.schema.isArray(def.schema)) result[def.key] = JSON.parse(value);
-				else result[def.key] = value;
-			} catch {
-				throw new CommandError(`Invalid JSON value for flag --${rawKey}`);
-			}
+			} else if (value) result[def.key] = this.castFlagValue(value, base, rawKey);
 			else {
 				const nextArg = argv[i + 1];
-				if (nextArg && !nextArg.startsWith("-")) {
-					value = nextArg;
-					try {
-						if (t.schema.isObject(def.schema) || t.schema.isArray(def.schema)) result[def.key] = JSON.parse(value);
-						else result[def.key] = value;
-					} catch {
-						throw new CommandError(`Invalid JSON value for flag --${rawKey}`);
-					}
-				} else throw new CommandError(`Flag --${rawKey} requires a value.`);
+				if (nextArg && !nextArg.startsWith("-")) result[def.key] = this.castFlagValue(nextArg, base, rawKey);
+				else throw new CommandError(`Flag --${rawKey} requires a value.`);
 			}
 		}
 		return result;
 	}
 	/**
+	* Convert a raw flag value string into the value its schema expects.
+	*
+	* zod no longer coerces, so scalar values (number / integer / boolean) are
+	* cast + validated via {@link parseArgumentValue} (same path as positional
+	* args); object / array / record values are JSON-parsed. `schema` is expected
+	* to already be unwrapped of optional/nullable/default.
+	*/
+	castFlagValue(value, schema, rawKey) {
+		if (z.schema.isObject(schema) || z.schema.isArray(schema) || z.schema.isRecord(schema)) try {
+			return JSON.parse(value);
+		} catch {
+			throw new CommandError(`Invalid JSON value for flag --${rawKey}`);
+		}
+		return this.parseArgumentValue(value, schema);
+	}
+	/**
 	* Get indices of argv elements consumed by flags (for separating args from flags)
 	*/
 	getFlagConsumedIndices(argv, flagDefs) {
@@ -1194,8 +798,9 @@ var CliProvider = class {
 			const hasEqualValue = valueParts.length > 0;
 			const def = flagDefs.find((d) => d.aliases.includes(rawKey));
 			if (!def) continue;
-			const isUnionWithBoolean = t.schema.isUnion(def.schema) && def.schema.anyOf.some((s) => t.schema.isBoolean(s));
-			if (!t.schema.isBoolean(def.schema) && !isUnionWithBoolean && !hasEqualValue) {
+			const base = z.schema.unwrap(def.schema);
+			const isUnionWithBoolean = z.schema.isUnion(base) && base.anyOf.some((s) => z.schema.isBoolean(s));
+			if (!z.schema.isBoolean(base) && !isUnionWithBoolean && !hasEqualValue) {
 				const nextArg = argv[i + 1];
 				if (nextArg && !nextArg.startsWith("-")) consumed.add(i + 1);
 			} else if (isUnionWithBoolean && !hasEqualValue) {
@@ -1207,25 +812,21 @@ var CliProvider = class {
 	}
 	parseCommandArgs(argv, schema, isRootCommand = false, flagSchema) {
 		if (!schema) return;
-		const flagDefs = flagSchema ? Object.entries(flagSchema.properties).map(([key, value]) => ({
-			key,
-			aliases: [key, ...value.aliases ?? (value.alias ? [value.alias] : void 0) ?? []],
-			schema: value
-		})) : [];
+		const flagDefs = flagSchema ? this.extractFlagDefs(flagSchema) : [];
 		const consumedIndices = this.getFlagConsumedIndices(argv, flagDefs);
 		const positionalArgs = argv.filter((arg, idx) => !arg.startsWith("-") && !consumedIndices.has(idx));
 		const argsOnly = isRootCommand ? positionalArgs : positionalArgs.slice(1);
 		try {
-			if (t.schema.isOptional(schema)) {
+			if (z.schema.isOptional(schema)) {
 				if (argsOnly.length === 0) return;
 				return this.parseArgumentValue(argsOnly[0], schema);
-			} else if (t.schema.isTuple(schema) && schema.items) {
+			} else if (z.schema.isTuple(schema) && schema.items) {
 				const result = [];
 				const items = schema.items;
 				for (let i = 0; i < items.length; i++) {
 					const itemSchema = items[i];
 					if (i < argsOnly.length) result.push(this.parseArgumentValue(argsOnly[i], itemSchema));
-					else if (t.schema.isOptional(itemSchema)) result.push(void 0);
+					else if (z.schema.isOptional(itemSchema)) result.push(void 0);
 					else throw new CommandError(`Missing required argument at position ${i + 1}`);
 				}
 				return result;
@@ -1242,14 +843,14 @@ var CliProvider = class {
 	* Convert a string argument value to the appropriate type based on schema
 	*/
 	parseArgumentValue(value, schema) {
-		if (t.schema.isString(schema)) return value;
-		if (t.schema.isNumber(schema) || t.schema.isInteger(schema)) {
+		if (z.schema.isString(schema)) return value;
+		if (z.schema.isNumber(schema) || z.schema.isInteger(schema)) {
 			const num = Number(value);
 			if (Number.isNaN(num)) throw new CommandError(`Expected number, got "${value}"`);
-			if (t.schema.isInteger(schema) && !Number.isInteger(num)) throw new CommandError(`Expected integer, got "${value}"`);
+			if (z.schema.isInteger(schema) && !Number.isInteger(num)) throw new CommandError(`Expected integer, got "${value}"`);
 			return num;
 		}
-		if (t.schema.isBoolean(schema)) {
+		if (z.schema.isBoolean(schema)) {
 			const lower = value.toLowerCase();
 			if (lower === "true" || lower === "1") return true;
 			if (lower === "false" || lower === "0") return false;
@@ -1262,28 +863,29 @@ var CliProvider = class {
 	*/
 	generateArgsUsage(schema) {
 		if (!schema) return "";
-		if (t.schema.isOptional(schema)) {
+		if (z.schema.isOptional(schema)) {
 			const typeName = this.getTypeName(schema);
-			return ` [${"title" in schema ? schema.title : "arg1"}${typeName}]`;
+			return ` [${this.schemaMeta(schema).title ?? "arg1"}${typeName}]`;
 		}
-		if (t.schema.isTuple(schema) && schema.items) return ` ${schema.items.map((item, index) => {
+		if (z.schema.isTuple(schema) && schema.items) return ` ${schema.items.map((item, index) => {
 			const argName = `arg${index + 1}`;
 			const typeName = this.getTypeName(item);
-			if (t.schema.isOptional(item)) return `[${argName}${typeName}]`;
+			if (z.schema.isOptional(item)) return `[${argName}${typeName}]`;
 			return `<${argName}${typeName}>`;
 		}).join(" ")}`;
 		const typeName = this.getTypeName(schema);
-		return ` <${"title" in schema ? schema.title : "arg1"}${typeName}>`;
+		return ` <${this.schemaMeta(schema).title ?? "arg1"}${typeName}>`;
 	}
 	/**
 	* Get display type name for a schema (e.g., ": number", ": boolean")
 	*/
 	getTypeName(schema) {
 		if (!schema) return "";
-		if (t.schema.isString(schema)) return "";
-		if (t.schema.isNumber(schema)) return ": number";
-		if (t.schema.isInteger(schema)) return ": integer";
-		if (t.schema.isBoolean(schema)) return ": boolean";
+		const base = z.schema.unwrap(schema);
+		if (z.schema.isString(base)) return "";
+		if (z.schema.isInteger(base)) return ": integer";
+		if (z.schema.isNumber(base)) return ": number";
+		if (z.schema.isBoolean(base)) return ": boolean";
 		return "";
 	}
 	/**
@@ -1293,6 +895,7 @@ var CliProvider = class {
 	*                  If omitted, shows general CLI help with all commands.
 	*/
 	printHelp(command) {
+		this.alepha.store.set("alepha.logger.format", "raw");
 		const cliName = this.name || "cli";
 		const c = this.color;
 		this.log.info("");
@@ -1322,17 +925,12 @@ var CliProvider = class {
 			this.log.info("");
 			this.log.info(c.set("WHITE_BOLD", "Flags:"));
 			const flags = [
-				...Object.entries(command.flags.properties).map(([key, value]) => ({
-					key,
-					schema: value,
-					aliases: [key, ...value.aliases ?? (value.alias ? [value.alias] : [])],
-					description: value.description
-				})),
+				...this.extractFlagDefs(command.flags),
 				...command.options.mode ? [{
 					key: "mode",
 					aliases: ["m", "mode"],
 					description: typeof command.options.mode === "string" ? `Environment mode - loads .env.{mode} (default: ${command.options.mode})` : "Environment mode (e.g., production, staging) - loads .env.{mode}",
-					schema: t.string()
+					schema: z.string()
 				}] : [],
 				...Object.entries(this.getAllGlobalFlags()).map(([key, value]) => ({
 					key,
@@ -1355,7 +953,7 @@ var CliProvider = class {
 				this.log.info(c.set("WHITE_BOLD", "Env:"));
 				const maxEnvLength = Math.max(...envVars.map(([key]) => key.length));
 				for (const [key, schema] of envVars) {
-					const isOptional = t.schema.isOptional(schema);
+					const isOptional = z.schema.isOptional(schema);
 					const description = schema.description ?? "";
 					const optionalStr = isOptional ? c.set("GREY_DARK", " (optional)") : c.set("RED", " (required)");
 					const coloredKey = c.set("CYAN", key);
@@ -1379,12 +977,7 @@ var CliProvider = class {
 			this.log.info("");
 			this.log.info(c.set("WHITE_BOLD", "Flags:"));
 			const rootCommand = this.commands.find((cmd) => cmd.name === "");
-			const globalFlags = [...rootCommand ? Object.entries(rootCommand.flags.properties).map(([key, value]) => ({
-				key,
-				aliases: [key, ...value.aliases ?? (value.alias ? [value.alias] : void 0) ?? []],
-				description: value.description,
-				schema: value
-			})) : [], ...Object.values(this.getAllGlobalFlags())];
+			const globalFlags = [...rootCommand ? this.extractFlagDefs(rootCommand.flags) : [], ...Object.values(this.getAllGlobalFlags())];
 			const maxFlagLength = this.getMaxFlagLength(globalFlags);
 			for (const { aliases, description, schema } of globalFlags) {
 				const flagStr = aliases.map((a) => a.length === 1 ? `-${a}` : `--${a}`).join(", ");
@@ -1402,19 +995,19 @@ var CliProvider = class {
 	generateColoredArgsUsage(schema) {
 		if (!schema) return "";
 		const c = this.color;
-		if (t.schema.isOptional(schema)) {
+		if (z.schema.isOptional(schema)) {
 			const typeName = this.getTypeName(schema);
-			const key = "title" in schema ? schema.title : "arg1";
+			const key = this.schemaMeta(schema).title ?? "arg1";
 			return ` ${c.set("GREY_DARK", `[${key}${typeName}]`)}`;
 		}
-		if (t.schema.isTuple(schema) && schema.items) return ` ${schema.items.map((item, index) => {
+		if (z.schema.isTuple(schema) && schema.items) return ` ${schema.items.map((item, index) => {
 			const argName = `arg${index + 1}`;
 			const typeName = this.getTypeName(item);
-			if (t.schema.isOptional(item)) return c.set("GREY_DARK", `[${argName}${typeName}]`);
+			if (z.schema.isOptional(item)) return c.set("GREY_DARK", `[${argName}${typeName}]`);
 			return c.set("CYAN", `<${argName}${typeName}>`);
 		}).join(" ")}`;
 		const typeName = this.getTypeName(schema);
-		const key = "title" in schema ? schema.title : "arg1";
+		const key = this.schemaMeta(schema).title ?? "arg1";
 		return ` ${c.set("CYAN", `<${key}${typeName}>`)}`;
 	}
 	/**
@@ -1475,12 +1068,19 @@ var CliProvider = class {
 	*/
 	getEnumValues(schema) {
 		if (!schema) return void 0;
-		if ("enum" in schema && Array.isArray(schema.enum) && schema.enum.every((v) => typeof v === "string")) return schema.enum;
-		if (t.schema.isUnion(schema)) {
-			const union = schema;
+		const base = z.schema.unwrap(schema);
+		if (z.schema.isEnum(base)) {
+			const values = z.schema.enumValues(base);
+			return values.length > 0 && values.every((v) => typeof v === "string") ? values : void 0;
+		}
+		if (z.schema.isUnion(base)) {
+			const variants = base.anyOf ?? [];
 			const values = [];
-			for (const variant of union.anyOf) if (t.schema.isString(variant) && "const" in variant && typeof variant.const === "string") values.push(variant.const);
-			else return;
+			for (const variant of variants) {
+				const value = variant.value;
+				if (z.schema.isLiteral(variant) && typeof value === "string") values.push(value);
+				else return;
+			}
 			return values.length > 0 ? values : void 0;
 		}
 	}
@@ -1506,9 +1106,8 @@ var CliProvider = class {
 *
 * **Features:**
 * - CLI command definitions
-* - Interactive CLI prompts
-* - Command execution
-* - Formatted colored output
+* - Interactive CLI prompts (plain readline)
+* - Command execution with streamed, verbose output
 * - Environment variable utilities
 * - Schema validation for CLI arguments
 *
@@ -1521,12 +1120,10 @@ const AlephaCommand = $module({
 		CliProvider,
 		Runner,
 		Asker,
-		PrettyAsker,
-		PrettyPrint,
 		EnvUtils
 	]
 });
 //#endregion
-export { $command, AlephaCommand, Asker, CliProvider, CommandError, CommandPrimitive, EnvUtils, PrettyAsker, PrettyPrint, Runner, cliOptions };
+export { $command, AlephaCommand, Asker, CliProvider, CommandError, CommandPrimitive, EnvUtils, Runner, cliOptions };
 
 //# sourceMappingURL=index.js.map