feat: Week 1 complete - Linux support + IPC API prep

🎉 Major v2.0 rebuild kickoff - Week 1 accomplished! ## Highlights ### Cross-Platform Support 🌍 - ✅ Linux primary platform (Ubuntu/Debian tested) - ✅ Windows fully supported - ✅ macOS experimental support - ✅ Platform-agnostic path handling (XDG spec) - ✅ Auto-detection of KiCAD installation ### Infrastructure 🏗️ - ✅ GitHub Actions CI/CD pipeline - ✅ Pytest framework with 20+ tests - ✅ Pre-commit hooks (Black, MyPy, ESLint) - ✅ Automated Linux installation script - ✅ Enhanced npm scripts ### IPC API Migration Prep 🚀 - ✅ Comprehensive migration plan (30 pages) - ✅ Backend abstraction layer (800+ lines) - ✅ Factory pattern with auto-detection - ✅ SWIG backward compatibility wrapper - ✅ IPC backend skeleton ready ### Documentation 📚 - ✅ Updated README (Linux installation) - ✅ CONTRIBUTING.md guide - ✅ Linux compatibility audit - ✅ IPC API migration plan - ✅ Session summaries - ✅ Platform-specific config templates ## Files Changed - 27 files created - ~3,000 lines of code/docs - 8 comprehensive documentation pages - 20+ unit tests - 5 abstraction layer modules ## Next Steps - Week 2: IPC API migration (project.py → component.py → routing.py) - Migrate from deprecated SWIG to official IPC API - JLCPCB/Digikey integration prep 🤖 Generated with Claude Code https://claude.com/claude-code Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-25 20:48:00 -04:00
commit e4c7119c51
81 changed files with 16003 additions and 0 deletions
--- a/src/logger.ts
+++ b/src/logger.ts
@@ -0,0 +1,121 @@
+/**
+ * Logger for KiCAD MCP server
+ */
+
+import { existsSync, mkdirSync, appendFileSync } from 'fs';
+import { join } from 'path';
+import * as os from 'os';
+
+// Log levels
+type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+
+// Default log directory
+const DEFAULT_LOG_DIR = join(os.homedir(), '.kicad-mcp', 'logs');
+
+/**
+ * Logger class for KiCAD MCP server
+ */
+class Logger {
+  private logLevel: LogLevel = 'info';
+  private logDir: string = DEFAULT_LOG_DIR;
+  
+  /**
+   * Set the log level
+   * @param level Log level to set
+   */
+  setLogLevel(level: LogLevel): void {
+    this.logLevel = level;
+  }
+  
+  /**
+   * Set the log directory
+   * @param dir Directory to store log files
+   */
+  setLogDir(dir: string): void {
+    this.logDir = dir;
+    
+    // Ensure log directory exists
+    if (!existsSync(this.logDir)) {
+      mkdirSync(this.logDir, { recursive: true });
+    }
+  }
+  
+  /**
+   * Log an error message
+   * @param message Message to log
+   */
+  error(message: string): void {
+    this.log('error', message);
+  }
+  
+  /**
+   * Log a warning message
+   * @param message Message to log
+   */
+  warn(message: string): void {
+    if (['error', 'warn', 'info', 'debug'].includes(this.logLevel)) {
+      this.log('warn', message);
+    }
+  }
+  
+  /**
+   * Log an info message
+   * @param message Message to log
+   */
+  info(message: string): void {
+    if (['info', 'debug'].includes(this.logLevel)) {
+      this.log('info', message);
+    }
+  }
+  
+  /**
+   * Log a debug message
+   * @param message Message to log
+   */
+  debug(message: string): void {
+    if (this.logLevel === 'debug') {
+      this.log('debug', message);
+    }
+  }
+  
+  /**
+   * Log a message with the specified level
+   * @param level Log level
+   * @param message Message to log
+   */
+  private log(level: LogLevel, message: string): void {
+    const timestamp = new Date().toISOString();
+    const formattedMessage = `[${timestamp}] [${level.toUpperCase()}] ${message}`;
+    
+    // Log to console
+    switch (level) {
+      case 'error':
+        console.error(formattedMessage);
+        break;
+      case 'warn':
+        console.warn(formattedMessage);
+        break;
+      case 'info':
+      case 'debug':
+      default:
+        console.log(formattedMessage);
+        break;
+    }
+    
+    // Log to file
+    try {
+      // Ensure log directory exists
+      if (!existsSync(this.logDir)) {
+        mkdirSync(this.logDir, { recursive: true });
+      }
+      
+      const logFile = join(this.logDir, `kicad-mcp-${new Date().toISOString().split('T')[0]}.log`);
+      appendFileSync(logFile, formattedMessage + '\n');
+    } catch (error) {
+      console.error(`Failed to write to log file: ${error}`);
+    }
+  }
+}
+
+// Create and export logger instance
+export const logger = new Logger();