feat(auto-mode): enhance error handling and feature status updates

- Improved error handling in AutoModeService to log errors and update feature status to "waiting_approval" when an error occurs during feature execution.
- Added error message writing to the context file for better debugging.
- Updated FeatureLoader to include an optional error message parameter when updating feature status.
- Enhanced prompt generation to include detailed context about attached images for better user guidance during feature implementation.
- Modified KanbanCard component to visually indicate features with errors, improving user awareness of issues.

These changes significantly enhance the robustness of the auto mode feature and improve the user experience by providing clearer feedback on feature execution status.

app/electron/auto-mode-service.js

@@ -181,6 +181,31 @@ class AutoModeService {
       return { success: true, passes: result.passes };
     } catch (error) {
       console.error("[AutoMode] Error running feature:", error);
+
+      // Write error to context file
+      try {
+        await contextManager.writeToContextFile(
+          projectPath,
+          featureId,
+          `\n\n❌ ERROR: ${error.message}\n\n${error.stack || ''}\n`
+        );
+      } catch (contextError) {
+        console.error("[AutoMode] Failed to write error to context:", contextError);
+      }
+
+      // Update feature status to waiting_approval so user can review the error
+      try {
+        await featureLoader.updateFeatureStatus(
+          featureId,
+          "waiting_approval",
+          projectPath,
+          null, // no summary
+          error.message // pass error message
+        );
+      } catch (statusError) {
+        console.error("[AutoMode] Failed to update feature status after error:", statusError);
+      }
+
       sendToRenderer({
         type: "auto_mode_error",
         error: error.message,
@@ -260,6 +285,31 @@ class AutoModeService {
       return { success: true, passes: result.passes };
     } catch (error) {
       console.error("[AutoMode] Error verifying feature:", error);
+
+      // Write error to context file
+      try {
+        await contextManager.writeToContextFile(
+          projectPath,
+          featureId,
+          `\n\n❌ ERROR: ${error.message}\n\n${error.stack || ''}\n`
+        );
+      } catch (contextError) {
+        console.error("[AutoMode] Failed to write error to context:", contextError);
+      }
+
+      // Update feature status to waiting_approval so user can review the error
+      try {
+        await featureLoader.updateFeatureStatus(
+          featureId,
+          "waiting_approval",
+          projectPath,
+          null, // no summary
+          error.message // pass error message
+        );
+      } catch (statusError) {
+        console.error("[AutoMode] Failed to update feature status after error:", statusError);
+      }
+
       sendToRenderer({
         type: "auto_mode_error",
         error: error.message,
@@ -400,6 +450,31 @@ class AutoModeService {
       return { success: true, passes: finalResult.passes };
     } catch (error) {
       console.error("[AutoMode] Error resuming feature:", error);
+
+      // Write error to context file
+      try {
+        await contextManager.writeToContextFile(
+          projectPath,
+          featureId,
+          `\n\n❌ ERROR: ${error.message}\n\n${error.stack || ''}\n`
+        );
+      } catch (contextError) {
+        console.error("[AutoMode] Failed to write error to context:", contextError);
+      }
+
+      // Update feature status to waiting_approval so user can review the error
+      try {
+        await featureLoader.updateFeatureStatus(
+          featureId,
+          "waiting_approval",
+          projectPath,
+          null, // no summary
+          error.message // pass error message
+        );
+      } catch (statusError) {
+        console.error("[AutoMode] Failed to update feature status after error:", statusError);
+      }
+
       sendToRenderer({
         type: "auto_mode_error",
         error: error.message,
@@ -544,6 +619,31 @@ class AutoModeService {
       });
     } catch (error) {
       console.error(`[AutoMode] Error running feature ${featureId}:`, error);
+
+      // Write error to context file
+      try {
+        await contextManager.writeToContextFile(
+          projectPath,
+          featureId,
+          `\n\n❌ ERROR: ${error.message}\n\n${error.stack || ''}\n`
+        );
+      } catch (contextError) {
+        console.error("[AutoMode] Failed to write error to context:", contextError);
+      }
+
+      // Update feature status to waiting_approval so user can review the error
+      try {
+        await featureLoader.updateFeatureStatus(
+          featureId,
+          "waiting_approval",
+          projectPath,
+          null, // no summary
+          error.message // pass error message
+        );
+      } catch (statusError) {
+        console.error("[AutoMode] Failed to update feature status after error:", statusError);
+      }
+
       sendToRenderer({
         type: "auto_mode_error",
         error: error.message,
@@ -761,6 +861,31 @@ class AutoModeService {
       });
     } catch (error) {
       console.error("[AutoMode] Error in follow-up:", error);
+
+      // Write error to context file
+      try {
+        await contextManager.writeToContextFile(
+          projectPath,
+          featureId,
+          `\n\n❌ ERROR: ${error.message}\n\n${error.stack || ''}\n`
+        );
+      } catch (contextError) {
+        console.error("[AutoMode] Failed to write error to context:", contextError);
+      }
+
+      // Update feature status to waiting_approval so user can review the error
+      try {
+        await featureLoader.updateFeatureStatus(
+          featureId,
+          "waiting_approval",
+          projectPath,
+          null, // no summary
+          error.message // pass error message
+        );
+      } catch (statusError) {
+        console.error("[AutoMode] Failed to update feature status after error:", statusError);
+      }
+
       sendToRenderer({
         type: "auto_mode_error",
         error: error.message,

app/electron/services/feature-executor.js

@@ -342,7 +342,8 @@ class FeatureExecutor {
         const path = require("path");
         for (const imagePathObj of imagePaths) {
           try {
-            const imagePath = imagePathObj.path;
+            // Handle both string paths and FeatureImagePath objects
+            const imagePath = typeof imagePathObj === 'string' ? imagePathObj : imagePathObj.path;
             const imageBuffer = fs.readFileSync(imagePath);
             const base64Data = imageBuffer.toString("base64");
             const ext = path.extname(imagePath).toLowerCase();
@@ -353,7 +354,9 @@ class FeatureExecutor {
               ".gif": "image/gif",
               ".webp": "image/webp",
             };
-            const mediaType = mimeTypeMap[ext] || imagePathObj.mimeType || "image/png";
+            const mediaType = typeof imagePathObj === 'string'
+              ? (mimeTypeMap[ext] || "image/png")
+              : (mimeTypeMap[ext] || imagePathObj.mimeType || "image/png");
 
             contentBlocks.push({
               type: "image",
@@ -366,8 +369,9 @@ class FeatureExecutor {
 
             console.log(`[FeatureExecutor] Added image to resume prompt: ${imagePath}`);
           } catch (error) {
+            const errorPath = typeof imagePathObj === 'string' ? imagePathObj : imagePathObj.path;
             console.error(
-              `[FeatureExecutor] Failed to load image ${imagePathObj.path}:`,
+              `[FeatureExecutor] Failed to load image ${errorPath}:`,
               error
             );
           }

app/electron/services/feature-loader.js

@@ -36,8 +36,9 @@ class FeatureLoader {
    * @param {string} status - The new status
    * @param {string} projectPath - Path to the project
    * @param {string} [summary] - Optional summary of what was done
+   * @param {string} [error] - Optional error message if feature errored
    */
-  async updateFeatureStatus(featureId, status, projectPath, summary) {
+  async updateFeatureStatus(featureId, status, projectPath, summary, error) {
     const featuresPath = path.join(
       projectPath,
       ".automaker",
@@ -98,6 +99,14 @@ class FeatureLoader {
       feature.summary = summary;
     }
 
+    // Update the error field (set or clear)
+    if (error) {
+      feature.error = error;
+    } else {
+      // Clear any previous error when status changes without error
+      delete feature.error;
+    }
+
     // Save back to file
     const toSave = features.map((f) => {
       const featureData = {
@@ -123,6 +132,9 @@ class FeatureLoader {
       if (f.summary !== undefined) {
         featureData.summary = f.summary;
       }
+      if (f.error !== undefined) {
+        featureData.error = f.error;
+      }
       return featureData;
     });
 

app/electron/services/prompt-builder.js

@@ -10,9 +10,18 @@ class PromptBuilder {
       ? `\n**⚠️ IMPORTANT - Manual Testing Mode:**\nThis feature has skipTests=true, which means:\n- DO NOT commit changes automatically\n- DO NOT mark as verified - it will automatically go to "waiting_approval" status\n- The user will manually review and commit the changes\n- Just implement the feature and mark it as verified (it will be converted to waiting_approval)\n`
       : "";
 
-    const imagesNote = feature.imagePaths && feature.imagePaths.length > 0
-      ? `\n**📎 Context Images Attached:**\nThe user has attached ${feature.imagePaths.length} image(s) for context. These images will be provided to you visually to help understand the requirements. Review them carefully before implementing.\n`
-      : "";
+    let imagesNote = "";
+    if (feature.imagePaths && feature.imagePaths.length > 0) {
+      const imagesList = feature.imagePaths.map((img, idx) =>
+        `   ${idx + 1}. ${img.filename} (${img.mimeType})\n      Path: ${img.path}`
+      ).join("\n");
+
+      imagesNote = `\n**📎 Context Images Attached:**\nThe user has attached ${feature.imagePaths.length} image(s) for context. These images are provided both visually (in the initial message) and as files you can read:
+
+${imagesList}
+
+You can use the Read tool to view these images at any time during implementation. Review them carefully before implementing.\n`;
+    }
 
     return `You are working on a feature implementation task.
 
@@ -121,9 +130,18 @@ Begin by reading the project structure and then implementing the feature.`;
       ? `\n**⚠️ IMPORTANT - Manual Testing Mode:**\nThis feature has skipTests=true, which means:\n- DO NOT commit changes automatically\n- DO NOT mark as verified - it will automatically go to "waiting_approval" status\n- The user will manually review and commit the changes\n- Just implement the feature and mark it as verified (it will be converted to waiting_approval)\n`
       : "";
 
-    const imagesNote = feature.imagePaths && feature.imagePaths.length > 0
-      ? `\n**📎 Context Images Attached:**\nThe user has attached ${feature.imagePaths.length} image(s) for context. These images will be provided to you visually to help understand the requirements. Review them carefully before implementing.\n`
-      : "";
+    let imagesNote = "";
+    if (feature.imagePaths && feature.imagePaths.length > 0) {
+      const imagesList = feature.imagePaths.map((img, idx) =>
+        `   ${idx + 1}. ${img.filename} (${img.mimeType})\n      Path: ${img.path}`
+      ).join("\n");
+
+      imagesNote = `\n**📎 Context Images Attached:**\nThe user has attached ${feature.imagePaths.length} image(s) for context. These images are provided both visually (in the initial message) and as files you can read:
+
+${imagesList}
+
+You can use the Read tool to view these images at any time during implementation. Review them carefully before implementing.\n`;
+    }
 
     return `You are implementing and verifying a feature until it is complete and working correctly.
 
@@ -224,9 +242,24 @@ Begin by reading the project structure and understanding what needs to be implem
       ? `\n**⚠️ IMPORTANT - Manual Testing Mode:**\nThis feature has skipTests=true, which means:\n- DO NOT commit changes automatically\n- DO NOT mark as verified - it will automatically go to "waiting_approval" status\n- The user will manually review and commit the changes\n- Just implement the feature and mark it as verified (it will be converted to waiting_approval)\n`
       : "";
 
-    const imagesNote = feature.imagePaths && feature.imagePaths.length > 0
-      ? `\n**📎 Context Images Attached:**\nThe user has attached ${feature.imagePaths.length} image(s) for context. These images will be provided to you visually to help understand the requirements. Review them carefully.\n`
-      : "";
+    // For resume, check both followUpImages and imagePaths
+    const imagePaths = feature.followUpImages || feature.imagePaths;
+    let imagesNote = "";
+    if (imagePaths && imagePaths.length > 0) {
+      const imagesList = imagePaths.map((img, idx) => {
+        // Handle both FeatureImagePath objects and simple path strings
+        const path = typeof img === 'string' ? img : img.path;
+        const filename = typeof img === 'string' ? path.split('/').pop() : img.filename;
+        const mimeType = typeof img === 'string' ? 'image/*' : img.mimeType;
+        return `   ${idx + 1}. ${filename} (${mimeType})\n      Path: ${path}`;
+      }).join("\n");
+
+      imagesNote = `\n**📎 Context Images Attached:**\nThe user has attached ${imagePaths.length} image(s) for context. These images are provided both visually (in the initial message) and as files you can read:
+
+${imagesList}
+
+You can use the Read tool to view these images at any time. Review them carefully.\n`;
+    }
 
     return `You are resuming work on a feature implementation that was previously started.