sonance-brand-mcp 1.3.27 → 1.3.28

package/dist/assets/api/sonance-vision-apply/route.ts

@@ -58,6 +58,26 @@ interface BackupManifest {
 }
 
 const BACKUP_ROOT = ".sonance-backups";
+const DEBUG_LOG_FILE = "sonance-debug.log";
+
+/**
+ * Debug logging utility - writes to sonance-debug.log in project root
+ * This helps diagnose issues with file discovery, validation, and revert
+ */
+function debugLog(message: string, data?: unknown) {
+  const timestamp = new Date().toISOString();
+  const dataStr = data !== undefined ? `\n${JSON.stringify(data, null, 2)}` : "";
+  const logEntry = `[${timestamp}] [apply] ${message}${dataStr}\n`;
+  
+  try {
+    const logPath = path.join(process.cwd(), DEBUG_LOG_FILE);
+    fs.appendFileSync(logPath, logEntry);
+    // Also log to console for terminal visibility
+    console.log(`[Sonance] ${message}`, data !== undefined ? data : "");
+  } catch (e) {
+    console.error("[Sonance] Failed to write debug log:", e);
+  }
+}
 
 const VISION_SYSTEM_PROMPT = `You are an expert React/TypeScript developer with vision capabilities. You can see screenshots and modify code.
 
@@ -377,6 +397,12 @@ CRITICAL: Your modified file should have approximately the same number of lines
         validFilePaths.add(comp.path);
       }
       
+      debugLog("VALIDATION: Valid file paths from page context", { 
+        pageFile: pageContext.pageFile,
+        validFilePaths: Array.from(validFilePaths),
+        aiRequestedFiles: aiResponse.modifications.map(m => m.filePath)
+      });
+      
       // Process modifications - apply patches to get modified content
       const modifications: VisionFileModification[] = [];
       const patchErrors: string[] = [];
@@ -384,7 +410,15 @@ CRITICAL: Your modified file should have approximately the same number of lines
       for (const mod of aiResponse.modifications) {
         // Validate that the file path is in the page context
         // This prevents the AI from creating new files
-        if (!validFilePaths.has(mod.filePath)) {
+        const isValidPath = validFilePaths.has(mod.filePath);
+        debugLog(`VALIDATION CHECK: ${mod.filePath}`, { 
+          isValidPath, 
+          fileExists: fs.existsSync(path.join(projectRoot, mod.filePath)),
+          validPaths: Array.from(validFilePaths)
+        });
+        
+        if (!isValidPath) {
+          debugLog(`REJECTED: File not in page context`, { filePath: mod.filePath });
           console.warn(`[Apply-First] Rejected modification to unknown file: ${mod.filePath}`);
           console.warn(`[Apply-First] Valid files are: ${Array.from(validFilePaths).join(", ")}`);
           patchErrors.push(`${mod.filePath}: This file was not found in the page context. The AI can only modify existing files that are part of the current page.`);
@@ -603,9 +637,11 @@ async function revertFromBackups(
   sessionId: string,
   projectRoot: string
 ): Promise<{ success: boolean; message: string; filesReverted: number }> {
+  debugLog("revertFromBackups called", { sessionId, projectRoot });
   const backupDir = path.join(projectRoot, BACKUP_ROOT, sessionId);
 
   if (!fs.existsSync(backupDir)) {
+    debugLog("REVERT ERROR: Backup directory not found", { backupDir });
     return {
       success: false,
       message: "Backup session not found",
@@ -617,7 +653,7 @@ async function revertFromBackups(
     const manifestPath = path.join(backupDir, "manifest.json");
 
     if (!fs.existsSync(manifestPath)) {
-      // If no manifest, try to restore any backup files we find
+      debugLog("REVERT ERROR: Manifest not found", { manifestPath });
       return {
         success: false,
         message: "Backup manifest not found",
@@ -628,18 +664,31 @@ async function revertFromBackups(
     const manifest: BackupManifest = JSON.parse(
       fs.readFileSync(manifestPath, "utf-8")
     );
+    
+    debugLog("REVERT: Loaded manifest", { 
+      sessionId: manifest.sessionId,
+      fileCount: manifest.files.length,
+      files: manifest.files.map(f => ({ path: f.original, isNewFile: f.isNewFile }))
+    });
 
     let filesReverted = 0;
     let filesDeleted = 0;
 
     for (const file of manifest.files) {
       const originalPath = path.join(projectRoot, file.original);
+      debugLog(`REVERT: Processing file`, { 
+        filePath: file.original, 
+        isNewFile: file.isNewFile,
+        fileExists: fs.existsSync(originalPath)
+      });
 
       // Handle new files - delete them
       if (file.isNewFile) {
+        debugLog(`REVERT: Attempting to delete new file`, { originalPath });
         if (fs.existsSync(originalPath)) {
           fs.unlinkSync(originalPath);
           filesDeleted++;
+          debugLog(`REVERT: Successfully deleted new file`, { originalPath });
           console.log(`[Revert] Deleted new file: ${file.original}`);
           
           // Clean up empty parent directories
@@ -853,8 +902,11 @@ function gatherPageContext(
 }
 
 function discoverPageFile(route: string, projectRoot: string): string | null {
+  debugLog("discoverPageFile called", { route, projectRoot });
+  
   // Handle root route
   if (route === "/" || route === "") {
+    debugLog("Handling root route, checking patterns...");
     const rootPatterns = [
       // App Router patterns
       "src/app/page.tsx",
@@ -901,18 +953,26 @@ function discoverPageFile(route: string, projectRoot: string): string | null {
   ];
 
   for (const pattern of patterns) {
-    if (fs.existsSync(path.join(projectRoot, pattern))) {
+    const fullPath = path.join(projectRoot, pattern);
+    const exists = fs.existsSync(fullPath);
+    debugLog(`Checking exact pattern: ${pattern}`, { exists });
+    if (exists) {
+      debugLog("Found exact match!", { pattern });
       return pattern;
     }
   }
 
+  debugLog("No exact match found, trying dynamic route matching...");
+  
   // If exact match not found, try dynamic route matching
   // e.g., /processes/123 -> src/pages/processes/[id].tsx
   const dynamicResult = findDynamicRoute(cleanRoute, projectRoot);
   if (dynamicResult) {
+    debugLog("Found dynamic route match!", { dynamicResult });
     return dynamicResult;
   }
 
+  debugLog("discoverPageFile: NO FILE FOUND for route", { route });
   return null;
 }
 
@@ -922,6 +982,7 @@ function discoverPageFile(route: string, projectRoot: string): string | null {
  */
 function findDynamicRoute(cleanRoute: string, projectRoot: string): string | null {
   const segments = cleanRoute.split("/");
+  debugLog("findDynamicRoute called", { cleanRoute, segments });
   
   // Try replacing the last segment with dynamic patterns
   const baseDirs = [
@@ -936,7 +997,10 @@ function findDynamicRoute(cleanRoute: string, projectRoot: string): string | nul
   
   for (const baseDir of baseDirs) {
     const basePath = path.join(projectRoot, baseDir);
-    if (!fs.existsSync(basePath)) continue;
+    if (!fs.existsSync(basePath)) {
+      debugLog(`Base dir does not exist: ${baseDir}`);
+      continue;
+    }
     
     // Build path with all segments except the last one
     const parentSegments = segments.slice(0, -1);
@@ -944,6 +1008,8 @@ function findDynamicRoute(cleanRoute: string, projectRoot: string): string | nul
       ? path.join(basePath, ...parentSegments)
       : basePath;
     
+    debugLog(`Checking parent path for dynamic routes`, { baseDir, parentPath, exists: fs.existsSync(parentPath) });
+    
     if (!fs.existsSync(parentPath)) continue;
     
     // Check for dynamic route files
@@ -974,31 +1040,43 @@ function findDynamicRoute(cleanRoute: string, projectRoot: string): string | nul
     // Also scan directory for any dynamic segment pattern [...]
     try {
       const entries = fs.readdirSync(parentPath, { withFileTypes: true });
+      const dynamicEntries = entries.filter(e => e.name.startsWith("[") && e.name.includes("]"));
+      debugLog(`Scanning directory for dynamic segments`, { parentPath, dynamicEntries: dynamicEntries.map(e => e.name) });
+      
       for (const entry of entries) {
         if (entry.name.startsWith("[") && entry.name.includes("]")) {
+          debugLog(`Found dynamic segment: ${entry.name}`, { isDirectory: entry.isDirectory() });
           for (const ext of extensions) {
             if (entry.isDirectory()) {
               // App Router or Pages Router with folder
               const pagePath = path.join(parentPath, entry.name, `page${ext}`);
               const indexPath = path.join(parentPath, entry.name, `index${ext}`);
+              debugLog(`Checking dynamic folder paths`, { pagePath, indexPath, pageExists: fs.existsSync(pagePath), indexExists: fs.existsSync(indexPath) });
               if (fs.existsSync(pagePath)) {
-                return path.relative(projectRoot, pagePath);
+                const result = path.relative(projectRoot, pagePath);
+                debugLog(`Found dynamic route (folder/page)!`, { result });
+                return result;
               }
               if (fs.existsSync(indexPath)) {
-                return path.relative(projectRoot, indexPath);
+                const result = path.relative(projectRoot, indexPath);
+                debugLog(`Found dynamic route (folder/index)!`, { result });
+                return result;
               }
             } else if (entry.isFile() && entry.name.endsWith(ext)) {
               // Pages Router file-based
-              return path.relative(projectRoot, path.join(parentPath, entry.name));
+              const result = path.relative(projectRoot, path.join(parentPath, entry.name));
+              debugLog(`Found dynamic route (file)!`, { result });
+              return result;
             }
           }
         }
       }
-    } catch {
-      // Skip if directory can't be read
+    } catch (e) {
+      debugLog(`Error scanning directory: ${parentPath}`, { error: String(e) });
     }
   }
   
+  debugLog("findDynamicRoute: NO DYNAMIC ROUTE FOUND");
   return null;
 }
 

package/dist/assets/api/sonance-vision-edit/route.ts

@@ -56,6 +56,27 @@ interface VisionEditResponse {
   error?: string;
 }
 
+const DEBUG_LOG_FILE = "sonance-debug.log";
+
+/**
+ * Debug logging utility - writes to sonance-debug.log in project root
+ * This helps diagnose issues with file discovery, validation, and revert
+ */
+function debugLog(message: string, data?: unknown) {
+  const timestamp = new Date().toISOString();
+  const dataStr = data !== undefined ? `\n${JSON.stringify(data, null, 2)}` : "";
+  const logEntry = `[${timestamp}] [edit] ${message}${dataStr}\n`;
+  
+  try {
+    const logPath = path.join(process.cwd(), DEBUG_LOG_FILE);
+    fs.appendFileSync(logPath, logEntry);
+    // Also log to console for terminal visibility
+    console.log(`[Sonance] ${message}`, data !== undefined ? data : "");
+  } catch (e) {
+    console.error("[Sonance] Failed to write debug log:", e);
+  }
+}
+
 const VISION_SYSTEM_PROMPT = `You are an expert React/TypeScript developer with vision capabilities. You can see screenshots and modify code.
 
 ═══════════════════════════════════════════════════════════════════════════════
@@ -381,12 +402,19 @@ CRITICAL: Only use file paths from the VALID FILES list above. Do NOT create new
         validPaths.add(comp.path);
       }
 
+      debugLog("VALIDATION: Valid file paths from page context", { 
+        pageFile: pageContext.pageFile,
+        validPaths: Array.from(validPaths),
+        aiRequestedFiles: (aiResponse.modifications || []).map(m => m.filePath)
+      });
+
       // Validate AI response - reject any file paths not in our valid list
       const invalidMods = (aiResponse.modifications || []).filter(
         (mod) => !validPaths.has(mod.filePath)
       );
 
       if (invalidMods.length > 0) {
+        debugLog("REJECTED: AI attempted to create new files", { invalidMods: invalidMods.map(m => m.filePath) });
         console.error(
           "AI attempted to create new files:",
           invalidMods.map((m) => m.filePath)
@@ -761,8 +789,11 @@ function gatherPageContext(
  * Supports both App Router (src/app/) and Pages Router (src/pages/, pages/)
  */
 function discoverPageFile(route: string, projectRoot: string): string | null {
+  debugLog("discoverPageFile called", { route, projectRoot });
+  
   // Handle root route
   if (route === "/" || route === "") {
+    debugLog("Handling root route, checking patterns...");
     const rootPatterns = [
       // App Router patterns
       "src/app/page.tsx",
@@ -810,18 +841,26 @@ function discoverPageFile(route: string, projectRoot: string): string | null {
   ];
 
   for (const pattern of patterns) {
-    if (fs.existsSync(path.join(projectRoot, pattern))) {
+    const fullPath = path.join(projectRoot, pattern);
+    const exists = fs.existsSync(fullPath);
+    debugLog(`Checking exact pattern: ${pattern}`, { exists });
+    if (exists) {
+      debugLog("Found exact match!", { pattern });
       return pattern;
     }
   }
 
+  debugLog("No exact match found, trying dynamic route matching...");
+  
   // If exact match not found, try dynamic route matching
   // e.g., /processes/123 -> src/pages/processes/[id].tsx
   const dynamicResult = findDynamicRoute(cleanRoute, projectRoot);
   if (dynamicResult) {
+    debugLog("Found dynamic route match!", { dynamicResult });
     return dynamicResult;
   }
 
+  debugLog("discoverPageFile: NO FILE FOUND for route", { route });
   return null;
 }
 
@@ -831,6 +870,7 @@ function discoverPageFile(route: string, projectRoot: string): string | null {
  */
 function findDynamicRoute(cleanRoute: string, projectRoot: string): string | null {
   const segments = cleanRoute.split("/");
+  debugLog("findDynamicRoute called", { cleanRoute, segments });
   
   // Try replacing the last segment with dynamic patterns
   const baseDirs = [
@@ -845,7 +885,10 @@ function findDynamicRoute(cleanRoute: string, projectRoot: string): string | nul
   
   for (const baseDir of baseDirs) {
     const basePath = path.join(projectRoot, baseDir);
-    if (!fs.existsSync(basePath)) continue;
+    if (!fs.existsSync(basePath)) {
+      debugLog(`Base dir does not exist: ${baseDir}`);
+      continue;
+    }
     
     // Build path with all segments except the last one
     const parentSegments = segments.slice(0, -1);
@@ -853,6 +896,8 @@ function findDynamicRoute(cleanRoute: string, projectRoot: string): string | nul
       ? path.join(basePath, ...parentSegments)
       : basePath;
     
+    debugLog(`Checking parent path for dynamic routes`, { baseDir, parentPath, exists: fs.existsSync(parentPath) });
+    
     if (!fs.existsSync(parentPath)) continue;
     
     // Check for dynamic route files
@@ -883,31 +928,43 @@ function findDynamicRoute(cleanRoute: string, projectRoot: string): string | nul
     // Also scan directory for any dynamic segment pattern [...]
     try {
       const entries = fs.readdirSync(parentPath, { withFileTypes: true });
+      const dynamicEntries = entries.filter(e => e.name.startsWith("[") && e.name.includes("]"));
+      debugLog(`Scanning directory for dynamic segments`, { parentPath, dynamicEntries: dynamicEntries.map(e => e.name) });
+      
       for (const entry of entries) {
         if (entry.name.startsWith("[") && entry.name.includes("]")) {
+          debugLog(`Found dynamic segment: ${entry.name}`, { isDirectory: entry.isDirectory() });
           for (const ext of extensions) {
             if (entry.isDirectory()) {
               // App Router or Pages Router with folder
               const pagePath = path.join(parentPath, entry.name, `page${ext}`);
               const indexPath = path.join(parentPath, entry.name, `index${ext}`);
+              debugLog(`Checking dynamic folder paths`, { pagePath, indexPath, pageExists: fs.existsSync(pagePath), indexExists: fs.existsSync(indexPath) });
               if (fs.existsSync(pagePath)) {
-                return path.relative(projectRoot, pagePath);
+                const result = path.relative(projectRoot, pagePath);
+                debugLog(`Found dynamic route (folder/page)!`, { result });
+                return result;
               }
               if (fs.existsSync(indexPath)) {
-                return path.relative(projectRoot, indexPath);
+                const result = path.relative(projectRoot, indexPath);
+                debugLog(`Found dynamic route (folder/index)!`, { result });
+                return result;
               }
             } else if (entry.isFile() && entry.name.endsWith(ext)) {
               // Pages Router file-based
-              return path.relative(projectRoot, path.join(parentPath, entry.name));
+              const result = path.relative(projectRoot, path.join(parentPath, entry.name));
+              debugLog(`Found dynamic route (file)!`, { result });
+              return result;
             }
           }
         }
       }
-    } catch {
-      // Skip if directory can't be read
+    } catch (e) {
+      debugLog(`Error scanning directory: ${parentPath}`, { error: String(e) });
     }
   }
   
+  debugLog("findDynamicRoute: NO DYNAMIC ROUTE FOUND");
   return null;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sonance-brand-mcp",
-  "version": "1.3.27",
+  "version": "1.3.28",
   "description": "MCP Server for Sonance Brand Guidelines and Component Library - gives Claude instant access to brand colors, typography, and UI components.",
   "main": "dist/index.js",
   "type": "module",