Chore/build npm (#9)

Co-authored-by: DigHuang <114602213+DigHuang@users.noreply.github.com>
Co-authored-by: Felix <24791380+vcfgv@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>

electron/utils/logger.ts

@@ -1,10 +1,10 @@
 /**
  * Logger Utility
- * Centralized logging with levels and file output
+ * Centralized logging with levels, file output, and log retrieval for UI
  */
 import { app } from 'electron';
 import { join } from 'path';
-import { existsSync, mkdirSync, appendFileSync } from 'fs';
+import { existsSync, mkdirSync, appendFileSync, readFileSync, readdirSync, statSync } from 'fs';
 
 /**
  * Log levels
@@ -19,26 +19,37 @@ export enum LogLevel {
 /**
  * Current log level (can be changed at runtime)
  */
-let currentLevel = LogLevel.INFO;
+let currentLevel = LogLevel.DEBUG; // Default to DEBUG for better diagnostics
 
 /**
  * Log file path
  */
 let logFilePath: string | null = null;
+let logDir: string | null = null;
 
 /**
- * Initialize logger
+ * In-memory ring buffer for recent logs (useful for UI display)
+ */
+const RING_BUFFER_SIZE = 500;
+const recentLogs: string[] = [];
+
+/**
+ * Initialize logger — safe to call before app.isReady()
  */
 export function initLogger(): void {
   try {
-    const logDir = join(app.getPath('userData'), 'logs');
-    
+    logDir = join(app.getPath('userData'), 'logs');
+
     if (!existsSync(logDir)) {
       mkdirSync(logDir, { recursive: true });
     }
-    
+
     const timestamp = new Date().toISOString().split('T')[0];
     logFilePath = join(logDir, `clawx-${timestamp}.log`);
+
+    // Write a separator for new session
+    const sessionHeader = `\n${'='.repeat(80)}\n[${new Date().toISOString()}] === ClawX Session Start (v${app.getVersion()}) ===\n${'='.repeat(80)}\n`;
+    appendFileSync(logFilePath, sessionHeader);
   } catch (error) {
     console.error('Failed to initialize logger:', error);
   }
@@ -51,22 +62,53 @@ export function setLogLevel(level: LogLevel): void {
   currentLevel = level;
 }
 
+/**
+ * Get log file directory path
+ */
+export function getLogDir(): string | null {
+  return logDir;
+}
+
+/**
+ * Get current log file path
+ */
+export function getLogFilePath(): string | null {
+  return logFilePath;
+}
+
 /**
  * Format log message
  */
 function formatMessage(level: string, message: string, ...args: unknown[]): string {
   const timestamp = new Date().toISOString();
-  const formattedArgs = args.length > 0 ? ' ' + args.map(arg => 
-    typeof arg === 'object' ? JSON.stringify(arg) : String(arg)
-  ).join(' ') : '';
-  
-  return `[${timestamp}] [${level}] ${message}${formattedArgs}`;
+  const formattedArgs = args.length > 0 ? ' ' + args.map(arg => {
+    if (arg instanceof Error) {
+      return `${arg.message}\n${arg.stack || ''}`;
+    }
+    if (typeof arg === 'object') {
+      try {
+        return JSON.stringify(arg, null, 2);
+      } catch {
+        return String(arg);
+      }
+    }
+    return String(arg);
+  }).join(' ') : '';
+
+  return `[${timestamp}] [${level.padEnd(5)}] ${message}${formattedArgs}`;
 }
 
 /**
- * Write to log file
+ * Write to log file and ring buffer
  */
-function writeToFile(formatted: string): void {
+function writeLog(formatted: string): void {
+  // Ring buffer
+  recentLogs.push(formatted);
+  if (recentLogs.length > RING_BUFFER_SIZE) {
+    recentLogs.shift();
+  }
+
+  // File
   if (logFilePath) {
     try {
       appendFileSync(logFilePath, formatted + '\n');
@@ -83,7 +125,7 @@ export function debug(message: string, ...args: unknown[]): void {
   if (currentLevel <= LogLevel.DEBUG) {
     const formatted = formatMessage('DEBUG', message, ...args);
     console.debug(formatted);
-    writeToFile(formatted);
+    writeLog(formatted);
   }
 }
 
@@ -94,7 +136,7 @@ export function info(message: string, ...args: unknown[]): void {
   if (currentLevel <= LogLevel.INFO) {
     const formatted = formatMessage('INFO', message, ...args);
     console.info(formatted);
-    writeToFile(formatted);
+    writeLog(formatted);
   }
 }
 
@@ -105,7 +147,7 @@ export function warn(message: string, ...args: unknown[]): void {
   if (currentLevel <= LogLevel.WARN) {
     const formatted = formatMessage('WARN', message, ...args);
     console.warn(formatted);
-    writeToFile(formatted);
+    writeLog(formatted);
   }
 }
 
@@ -116,7 +158,66 @@ export function error(message: string, ...args: unknown[]): void {
   if (currentLevel <= LogLevel.ERROR) {
     const formatted = formatMessage('ERROR', message, ...args);
     console.error(formatted);
-    writeToFile(formatted);
+    writeLog(formatted);
+  }
+}
+
+/**
+ * Get recent logs from ring buffer (for UI display)
+ * @param count Number of recent log lines to return (default: all)
+ * @param minLevel Minimum log level to include (default: DEBUG)
+ */
+export function getRecentLogs(count?: number, minLevel?: LogLevel): string[] {
+  const filtered = minLevel != null
+    ? recentLogs.filter(line => {
+      if (minLevel <= LogLevel.DEBUG) return true;
+      if (minLevel === LogLevel.INFO) return !line.includes('] [DEBUG');
+      if (minLevel === LogLevel.WARN) return line.includes('] [WARN') || line.includes('] [ERROR');
+      return line.includes('] [ERROR');
+    })
+    : recentLogs;
+
+  return count ? filtered.slice(-count) : [...filtered];
+}
+
+/**
+ * Read the current day's log file content (last N lines)
+ */
+export function readLogFile(tailLines = 200): string {
+  if (!logFilePath || !existsSync(logFilePath)) {
+    return '(No log file found)';
+  }
+  try {
+    const content = readFileSync(logFilePath, 'utf-8');
+    const lines = content.split('\n');
+    if (lines.length <= tailLines) return content;
+    return lines.slice(-tailLines).join('\n');
+  } catch (err) {
+    return `(Failed to read log file: ${err})`;
+  }
+}
+
+/**
+ * List available log files
+ */
+export function listLogFiles(): Array<{ name: string; path: string; size: number; modified: string }> {
+  if (!logDir || !existsSync(logDir)) return [];
+  try {
+    return readdirSync(logDir)
+      .filter(f => f.endsWith('.log'))
+      .map(f => {
+        const fullPath = join(logDir!, f);
+        const stat = statSync(fullPath);
+        return {
+          name: f,
+          path: fullPath,
+          size: stat.size,
+          modified: stat.mtime.toISOString(),
+        };
+      })
+      .sort((a, b) => b.modified.localeCompare(a.modified));
+  } catch {
+    return [];
   }
 }
 
@@ -130,4 +231,9 @@ export const logger = {
   error,
   setLevel: setLogLevel,
   init: initLogger,
+  getLogDir,
+  getLogFilePath,
+  getRecentLogs,
+  readLogFile,
+  listLogFiles,
 };