type LogLevel = "debug" | "info" | "warn" | "error"; function enabled(): boolean { const flag = process.env.PI_GUI_DEBUG; return flag === "1" || flag === "true"; } function write(level: LogLevel, message: string, context?: Record): void { if (!enabled()) return; const suffix = context ? ` ${JSON.stringify(context)}` : ""; process.stderr.write(`[GUI:${level.toUpperCase()}] ${message}${suffix}\n`); } export const guiLogger = { debug: (message: string, context?: Record) => write("debug", message, context), info: (message: string, context?: Record) => write("info", message, context), warn: (message: string, context?: Record) => write("warn", message, context), error: (message: string, context?: Record) => write("error", message, context), };