@agentuity/cli 0.0.111 → 0.0.112

package/src/steps.ts

@@ -8,7 +8,8 @@
 import type { ColorScheme } from './terminal';
 import type { LogLevel } from './types';
 import { ValidationInputError, ValidationOutputError, type IssuesType } from '@agentuity/server';
-import { clearLastLines } from './tui';
+import { clearLastLines, isTTYLike } from './tui';
+import { appendLog, isLogCollectionEnabled } from './log-collector';
 
 // Spinner frames
 const FRAMES = ['◐', '◓', '◑', '◒'];
@@ -129,6 +130,38 @@ function renderStepLine(step: StepState, spinner?: string): string {
 	}
 }
 
+/**
+ * Generate a clean log line for a completed step (no ANSI, no animation)
+ */
+function getCleanStepLog(step: StepState): string {
+	if (step.status === 'success') {
+		return `${ICONS.success} ${step.label}`;
+	} else if (step.status === 'skipped') {
+		const reason = step.skipReason ? ` (${step.skipReason})` : '';
+		return `${ICONS.skipped} ${step.label}${reason}`;
+	} else if (step.status === 'error') {
+		const error = step.errorMessage ? `: ${step.errorMessage}` : '';
+		return `${ICONS.error} ${step.label}${error}`;
+	}
+	return `${ICONS.pending} ${step.label}`;
+}
+
+/**
+ * Emit clean log for a completed step if log collection is enabled
+ */
+function emitCleanStepLog(step: StepState): void {
+	if (!isLogCollectionEnabled()) return;
+
+	appendLog(getCleanStepLog(step));
+
+	// Also emit any output lines
+	if (step.output && step.output.length > 0) {
+		for (const line of step.output) {
+			appendLog(`  ${line}`);
+		}
+	}
+}
+
 /**
  * Render all steps from state, including output boxes
  * Returns the rendered output and total line count
@@ -212,7 +245,7 @@ function enablePauseResume(
  * Returns resume function
  */
 export function pauseStepUI(clear = false): () => void {
-	if (!process.stdout.isTTY || !getTotalLinesFn) {
+	if (!isTTYLike() || !getTotalLinesFn) {
 		return () => {}; // No-op if not TTY or not in step context
 	}
 
@@ -466,6 +499,9 @@ async function runStepsTUI(steps: Step[]): Promise<void> {
 				activeInterval = null;
 			}
 
+			// Emit clean log for this step (for external log collection)
+			emitCleanStepLog(stepState);
+
 			// Final render with outcome
 			stepState.progress = undefined;
 			const finalRender = renderAllSteps(state, -1);
@@ -529,6 +565,19 @@ async function runStepsPlain(steps: Step[]): Promise<void> {
 			};
 		}
 
+		// Build step state for clean log emission
+		const stepState: StepState = {
+			label: step.label,
+			status: outcome.status,
+			output: outcome.output,
+			skipReason: outcome.status === 'skipped' ? outcome.reason : undefined,
+			errorMessage: outcome.status === 'error' ? outcome.message : undefined,
+			errorCause: outcome.status === 'error' ? outcome.cause : undefined,
+		};
+
+		// Emit clean log for this step
+		emitCleanStepLog(stepState);
+
 		// Print final state
 		if (outcome.status === 'success') {
 			console.log(`${greenColor}${ICONS.success}${COLORS.reset} ${step.label}`);
@@ -579,8 +628,7 @@ async function runStepsPlain(steps: Step[]): Promise<void> {
  * Run a series of steps with animated progress
  */
 export async function runSteps(steps: Step[], logLevel?: LogLevel): Promise<void> {
-	const useTUI =
-		process.stdout.isTTY && (!logLevel || ['info', 'warn', 'error'].includes(logLevel));
+	const useTUI = isTTYLike() && (!logLevel || ['info', 'warn', 'error'].includes(logLevel));
 
 	if (useTUI) {
 		await runStepsTUI(steps);

package/src/tui/box.ts

@@ -3,13 +3,7 @@
  */
 import { symbols } from './symbols';
 import { colors } from './colors';
-
-/**
- * Get terminal width
- */
-function getTerminalWidth(): number {
-	return process.stdout.columns || 80;
-}
+import { getTerminalWidth } from '../tui';
 
 /**
  * Get string width (accounting for ANSI codes and OSC 8 hyperlinks)

package/src/tui/symbols.ts

@@ -5,6 +5,11 @@
 
 // Detect unicode support
 const isUnicodeSupported = (): boolean => {
+	// FORCE_UNICODE overrides detection (used by fork wrapper)
+	if (process.env.FORCE_UNICODE === '1') {
+		return true;
+	}
+
 	if (process.platform !== 'win32') {
 		return process.env.TERM !== 'linux'; // Linux console (kernel) doesn't support Unicode
 	}

package/src/tui.ts

@@ -24,6 +24,10 @@ function ensureCursorRestoration(): void {
 	exitHandlerInstalled = true;
 
 	const restoreCursor = () => {
+		// Skip cursor restoration in CI - terminals don't support these sequences
+		if (process.env.CI) {
+			return;
+		}
 		// Restore cursor visibility
 		process.stderr.write('\x1B[?25h');
 	};
@@ -62,7 +66,38 @@ export const ICONS = {
 	bullet: '•',
 } as const;
 
+/**
+ * Check if we should treat stdout as a TTY (real TTY or FORCE_COLOR set by fork wrapper)
+ * Returns false in CI environments since CI terminals don't support cursor control sequences
+ */
+export function isTTYLike(): boolean {
+	if (process.env.CI) {
+		return false;
+	}
+	return process.stdout.isTTY || process.env.FORCE_COLOR === '1';
+}
+
+/**
+ * Get terminal width, respecting COLUMNS env var for piped processes
+ */
+export function getTerminalWidth(defaultWidth = 80): number {
+	if (process.stdout.columns) {
+		return process.stdout.columns;
+	}
+	if (process.env.COLUMNS) {
+		const cols = parseInt(process.env.COLUMNS, 10);
+		if (!isNaN(cols) && cols > 0) {
+			return cols;
+		}
+	}
+	return defaultWidth;
+}
+
 export function shouldUseColors(): boolean {
+	// FORCE_COLOR overrides TTY detection (used by fork wrapper)
+	if (process.env.FORCE_COLOR === '1') {
+		return true;
+	}
 	return (
 		!process.env.NO_COLOR &&
 		!process.env.CI &&
@@ -71,7 +106,9 @@ export function shouldUseColors(): boolean {
 	);
 }
 
-// Color definitions (light/dark adaptive) using Bun.color
+// Color definitions (light/dark adaptive)
+// Note: We use direct ANSI codes instead of Bun.color() because Bun.color()
+// returns corrupted sequences when stdout is not a TTY (even with FORCE_COLOR=1)
 function getColors() {
 	const USE_COLORS = shouldUseColors();
 	if (!USE_COLORS) {
@@ -90,36 +127,36 @@ function getColors() {
 
 	return {
 		success: {
-			light: Bun.color('#008000', 'ansi') || '\x1b[32m', // green
-			dark: Bun.color('#00FF00', 'ansi') || '\x1b[92m', // bright green
+			light: '\x1b[32m', // green
+			dark: '\x1b[92m', // bright green
 		},
 		error: {
-			light: Bun.color('#CC0000', 'ansi') || '\x1b[31m', // red
-			dark: Bun.color('#FF5555', 'ansi') || '\x1b[91m', // bright red
+			light: '\x1b[31m', // red
+			dark: '\x1b[91m', // bright red
 		},
 		warning: {
-			light: Bun.color('#B58900', 'ansi') || '\x1b[33m', // yellow
-			dark: Bun.color('#FFFF55', 'ansi') || '\x1b[93m', // bright yellow
+			light: '\x1b[33m', // yellow
+			dark: '\x1b[93m', // bright yellow
 		},
 		info: {
-			light: Bun.color('#008B8B', 'ansi') || '\x1b[36m', // dark cyan
-			dark: Bun.color('#55FFFF', 'ansi') || '\x1b[96m', // bright cyan
+			light: '\x1b[36m', // dark cyan
+			dark: '\x1b[96m', // bright cyan
 		},
 		muted: {
-			light: Bun.color('#808080', 'ansi') || '\x1b[90m', // gray
-			dark: Bun.color('#888888', 'ansi') || '\x1b[90m', // darker gray
+			light: '\x1b[90m', // gray
+			dark: '\x1b[90m', // gray
 		},
 		bold: {
 			light: '\x1b[1m',
 			dark: '\x1b[1m',
 		},
 		link: {
-			light: '\x1b[34;4m', // blue underline (need ANSI for underline)
+			light: '\x1b[34;4m', // blue underline
 			dark: '\x1b[94;4m', // bright blue underline
 		},
 		primary: {
-			light: Bun.color('#000000', 'ansi') || '\x1b[30m', // black
-			dark: Bun.color('#FFFFFF', 'ansi') || '\x1b[97m', // white
+			light: '\x1b[30m', // black
+			dark: '\x1b[97m', // white
 		},
 		reset: '\x1b[0m',
 	} as const;
@@ -410,8 +447,12 @@ export function getDisplayWidth(str: string): number {
  * Strip all ANSI escape sequences from a string
  */
 export function stripAnsi(str: string): string {
-	// eslint-disable-next-line no-control-regex
-	return str.replace(/\u001b\[[0-9;]*m/g, '').replace(/\u001b\]8;;[^\u0007]*\u0007/g, '');
+	/* eslint-disable no-control-regex */
+	return str
+		.replace(/\u001b\[[0-9;]*m/g, '') // SGR sequences (colors, bold, etc.)
+		.replace(/\u001b\[\?[0-9;]*[a-zA-Z]/g, '') // DEC private mode (cursor show/hide, etc.)
+		.replace(/\u001b\]8;;[^\u0007]*\u0007/g, ''); // OSC 8 hyperlinks
+	/* eslint-enable no-control-regex */
 }
 
 /**
@@ -457,8 +498,8 @@ export function truncateToWidth(str: string, maxWidth: number, ellipsis = '...')
 	while (i < str.length && visibleIndex < cutIndex) {
 		// Check for ANSI escape sequence
 		if (str[i] === '\u001b') {
-			// Copy entire ANSI sequence
-			// eslint-disable-next-line no-control-regex
+			/* eslint-disable no-control-regex */
+			// Copy entire SGR sequence (colors, bold, etc.)
 			const match = str.slice(i).match(/^\u001b\[[0-9;]*m/);
 			if (match) {
 				result += match[0];
@@ -466,14 +507,22 @@ export function truncateToWidth(str: string, maxWidth: number, ellipsis = '...')
 				continue;
 			}
 
+			// Check for DEC private mode (cursor show/hide, etc.)
+			const decMatch = str.slice(i).match(/^\u001b\[\?[0-9;]*[a-zA-Z]/);
+			if (decMatch) {
+				result += decMatch[0];
+				i += decMatch[0].length;
+				continue;
+			}
+
 			// Check for OSC 8 hyperlink
-			// eslint-disable-next-line no-control-regex
 			const oscMatch = str.slice(i).match(/^\u001b\]8;;[^\u0007]*\u0007/);
 			if (oscMatch) {
 				result += oscMatch[0];
 				i += oscMatch[0].length;
 				continue;
 			}
+			/* eslint-enable no-control-regex */
 		}
 
 		// Copy visible character
@@ -525,7 +574,7 @@ interface BannerOptions {
  */
 export function banner(title: string, body: string, options?: BannerOptions): void {
 	// Get terminal width, default to 120 if not available
-	const termWidth = process.stdout.columns || 120;
+	const termWidth = getTerminalWidth(120);
 
 	const border = {
 		topLeft: '╭',
@@ -853,8 +902,11 @@ function extractLeadingAnsiCodes(str: string): string {
  */
 function stripAnsiCodes(str: string): string {
 	// Remove all ANSI escape sequences
-	// eslint-disable-next-line no-control-regex
-	return str.replace(/\x1b\[[0-9;]*m/g, '');
+	/* eslint-disable no-control-regex */
+	return str
+		.replace(/\x1b\[[0-9;]*m/g, '') // SGR sequences
+		.replace(/\x1b\[\?[0-9;]*[a-zA-Z]/g, ''); // DEC private mode
+	/* eslint-enable no-control-regex */
 }
 
 /**
@@ -1120,7 +1172,7 @@ export async function spinner<T>(
 	let linesRendered = 0;
 
 	// Get terminal width for truncation
-	const termWidth = process.stderr.columns || 80;
+	const termWidth = getTerminalWidth(80);
 	const maxLineWidth = Math.min(80, termWidth);
 
 	// Function to render spinner with optional log lines
@@ -1399,7 +1451,7 @@ export async function runCommand(options: CommandRunnerOptions): Promise<number>
 	const reset = getColor('reset');
 
 	// Get terminal width
-	const termWidth = process.stdout.columns || 80;
+	const termWidth = getTerminalWidth(80);
 	const maxCmdWidth = Math.min(40, termWidth);
 	const maxLineWidth = Math.min(80, termWidth);
 
@@ -1886,7 +1938,7 @@ export function table<T extends Record<string, unknown>>(
 
 	// Determine layout mode
 	const layout = options?.layout ?? 'auto';
-	const termWidth = process.stdout.columns || 80;
+	const termWidth = getTerminalWidth(80);
 	const tableWidth = calculateTableWidth(data, columnNames);
 	const useVertical = layout === 'vertical' || (layout === 'auto' && tableWidth > termWidth);
 

package/src/types.ts

@@ -128,6 +128,83 @@ export interface WorkbenchConfig {
 	headers?: Record<string, string>;
 }
 
+/**
+ * Web analytics configuration for SDK-created applications
+ */
+export interface AnalyticsConfig {
+	/**
+	 * Enable/disable analytics
+	 * @default true
+	 */
+	enabled?: boolean;
+
+	/**
+	 * Require explicit user consent before tracking
+	 * When true, analytics is no-op until optIn() is called
+	 * @default false
+	 */
+	requireConsent?: boolean;
+
+	/**
+	 * Track click events on elements with data-analytics attribute
+	 * @default true
+	 */
+	trackClicks?: boolean;
+
+	/**
+	 * Track scroll depth (25%, 50%, 75%, 100%)
+	 * @default true
+	 */
+	trackScroll?: boolean;
+
+	/**
+	 * Track outbound link clicks
+	 * @default true
+	 */
+	trackOutboundLinks?: boolean;
+
+	/**
+	 * Track form submissions
+	 * @default false
+	 */
+	trackForms?: boolean;
+
+	/**
+	 * Track Core Web Vitals
+	 * @default true
+	 */
+	trackWebVitals?: boolean;
+
+	/**
+	 * Track JavaScript errors
+	 * @default true
+	 */
+	trackErrors?: boolean;
+
+	/**
+	 * Track SPA navigation (popstate, pushState)
+	 * Automatically tracks virtual pageviews on client-side route changes
+	 * @default true
+	 */
+	trackSPANavigation?: boolean;
+
+	/**
+	 * Sample rate (0-1). 1 = 100% of events
+	 * @default 1
+	 */
+	sampleRate?: number;
+
+	/**
+	 * URL patterns to exclude from tracking (regex strings)
+	 */
+	excludePatterns?: string[];
+
+	/**
+	 * Custom data to include with every event
+	 */
+	globalProperties?: Record<string, unknown>;
+}
+
 /**
  * Agentuity project configuration (declarative)
  */
@@ -136,6 +213,14 @@ export interface AgentuityConfig {
 	 * Workbench configuration
 	 */
 	workbench?: WorkbenchConfig;
+
+	/**
+	 * Web analytics configuration
+	 * Set to false to disable, or provide options object
+	 * @default true (enabled with defaults)
+	 */
+	analytics?: boolean | AnalyticsConfig;
+
 	/**
 	 * Vite plugins to add to the client build
 	 * These are added AFTER Agentuity's built-in plugins

package/src/typescript-errors.ts

@@ -18,6 +18,7 @@ import {
 	getColor,
 	plural,
 	sourceLink,
+	getTerminalWidth,
 	truncateToWidth,
 } from './tui';
 import { symbols } from './tui/symbols';
@@ -318,7 +319,7 @@ export async function formatTypeScriptErrors(
 	}
 
 	// Calculate terminal constraints
-	const terminalWidth = process.stdout.columns || 80;
+	const terminalWidth = getTerminalWidth(80);
 	const boxChrome = 6;
 	const maxAvailableWidth = terminalWidth - boxChrome;