deepdebug-local-agent 1.0.23 → 1.1.0

package/src/ai-engine.js

@@ -1,6 +1,6 @@
 // ============================================
 // 🧠 AI VIBE CODING ENGINE
-// Ficheiro: ai-engine.js
+// File: ai-engine.js
 // Coloca em: ~/deepdebug-local-agent/src/ai-engine.js
 // ============================================
 
@@ -15,15 +15,15 @@ const execAsync = promisify(exec);
 /**
  * AIVibeCodingEngine
  *
- * Sistema universal de auto-healing que usa AI para resolver
- * QUALQUER erro automaticamente - não apenas startup.
+ * Universal auto-healing system that uses AI to resolve
+ * ANY error automatically - not just startup.
  *
  * Features:
- * - Monitorização de erros em tempo real
- * - Classificação automática de erros
+ * - Real-time error monitoring
+ * - Automatic error classification
  * - Quick fixes locais (sem chamar AI)
- * - Escala para AI quando quick fixes falham
- * - Histórico de fixes para reutilização
+ * - Escalates to AI when quick fixes fail
+ * - Fix history for reuse
  */
 export class AIVibeCodingEngine extends EventEmitter {
     constructor(processManager, getWorkspaceRoot) {
@@ -34,12 +34,12 @@ export class AIVibeCodingEngine extends EventEmitter {
         this.maxRetries = 3;
         this.isActive = true;
 
-        // Histórico
+        // History
         this.errorHistory = [];
         this.fixHistory = [];
         this.pendingFixes = [];
 
-        // Estado
+        // State
         this.currentSession = null;
         this.lastSuccessfulConfig = null;
 
@@ -54,14 +54,14 @@ export class AIVibeCodingEngine extends EventEmitter {
     // ============================================
 
     setupErrorMonitoring() {
-        // Monitorar logs do ProcessManager
+        // Monitor ProcessManager logs
         this.processManager.on('log', async ({ serviceId, message, type }) => {
             if (this.isActive && message && this.isError(message)) {
                 await this.handleRuntimeError(serviceId, message, type);
             }
         });
 
-        // Monitorar crashes
+        // Monitor crashes
         this.processManager.on('stopped', async ({ serviceId, code, signal }) => {
             if (this.isActive && code !== 0 && code !== null) {
                 console.log(`🧠 [AI-Engine] Process ${serviceId} crashed (code: ${code})`);
@@ -69,7 +69,7 @@ export class AIVibeCodingEngine extends EventEmitter {
             }
         });
 
-        // Monitorar erros de processo
+        // Monitor process errors
         this.processManager.on('error', async ({ serviceId, error }) => {
             if (this.isActive) {
                 console.log(`🧠 [AI-Engine] Process error: ${error}`);
@@ -212,7 +212,7 @@ export class AIVibeCodingEngine extends EventEmitter {
     async handleRuntimeError(serviceId, errorMessage, type) {
         const classification = this.classifyError(errorMessage);
 
-        // Debounce: evitar duplicatas em 5 segundos
+        // Debounce: avoid duplicates within 5 seconds
         const recentSimilar = this.errorHistory.find(e =>
             e.classification.type === classification.type &&
             Date.now() - e.timestamp < 5000
@@ -235,10 +235,10 @@ export class AIVibeCodingEngine extends EventEmitter {
         console.log(`🧠 [AI-Engine] Error detected: ${classification.type} (${classification.severity})`);
         console.log(`   Message: ${errorMessage.substring(0, 150)}...`);
 
-        // Emitir evento
+        // Emit the event
         this.emit('error_detected', errorEntry);
 
-        // Se auto-fixável, preparar fix
+        // If auto-fixable, prepare a fix
         if (classification.autoFixable) {
             const quickFix = this.getQuickFix(classification.type, errorMessage);
             if (quickFix) {
@@ -357,14 +357,14 @@ export class AIVibeCodingEngine extends EventEmitter {
             attempts++;
             console.log(`\n🔄 [AI-Engine] Attempt ${attempts}/${this.maxRetries}`);
 
-            // Aplicar fixes pendentes
+            // Apply pending fixes
             if (attempts > 1 && this.pendingFixes.length > 0) {
                 const fix = this.pendingFixes.shift();
                 console.log(`💡 [AI-Engine] Applying fix: ${fix.fix.description}`);
                 currentConfig = await this.applyFix(currentConfig, fix.fix);
             }
 
-            // Recompilar se necessário
+            // Recompile if needed
             if (currentConfig.recompile) {
                 console.log('🔨 [AI-Engine] Recompiling...');
                 const compileResult = await this.recompile();
@@ -379,7 +379,7 @@ export class AIVibeCodingEngine extends EventEmitter {
                 delete currentConfig.recompile;
             }
 
-            // Tentar iniciar
+            // Try to start
             const result = await this.attemptStart(currentConfig);
 
             this.currentSession.attempts.push({
@@ -419,14 +419,14 @@ export class AIVibeCodingEngine extends EventEmitter {
             lastError = result.error;
             console.log(`❌ [AI-Engine] Attempt ${attempts} failed: ${lastError?.substring(0, 100)}...`);
 
-            // Obter fix
+            // Get a fix
             const fix = await this.getFix(result.error, result.logs, currentConfig);
 
             if (fix) {
                 console.log(`💡 [AI-Engine] Fix: ${fix.description}`);
                 currentConfig = await this.applyFix(currentConfig, fix);
             } else {
-                // Tentar AI
+                // Try AI
                 console.log(`🤖 [AI-Engine] Requesting AI analysis...`);
                 const aiAnalysis = await this.analyzeWithAI('startup', lastError, currentConfig);
                 if (aiAnalysis?.newConfig) {
@@ -536,7 +536,7 @@ export class AIVibeCodingEngine extends EventEmitter {
             return quickFix;
         }
 
-        // Verificar histórico
+        // Check the history
         const similarFix = this.findSimilarFix(classification.type);
         if (similarFix) {
             console.log(`📚 [AI-Engine] Found similar fix in history`);
@@ -707,7 +707,7 @@ export class AIVibeCodingEngine extends EventEmitter {
         }
 
         try {
-            // Importar detectProject dinamicamente para evitar dependência circular
+            // Import detectProject dynamically to avoid a circular dependency
             const { detectProject } = await import('./detectors.js');
             const meta = await detectProject(workspaceRoot);
 

package/src/config/trusted-signing-keys.json

@@ -0,0 +1,3 @@
+[
+  { "keyId": "vh-2026-09", "publicKey": "MCowBQYDK2VwAyEAp1QFJcXW1Xgz+B0Qppsgqc87rZmwrggKYC3dh4n7aBg=" }
+]

package/src/detectors/build-tool-detector.js

@@ -0,0 +1,50 @@
+/**
+ * build-tool-detector.js — PASSO 0 of the fix validation ladder.
+ *
+ * Thin facade over the battle-tested detectProject() (src/detectors.js) that
+ * normalizes its output into the {stack, tier} shape the auto-fix engine
+ * consumes. One source of truth: marker priority, multi-language and the
+ * "Swift wins" product rule all live in detectProject — this file only maps.
+ *
+ * Tiers (validation ladder):
+ *   A = C1 structural + C2 syntax + C3 build    (maven/gradle/node)
+ *   B = C1 + C2, build unsupported on this host (xcode/swift — needs macOS)
+ *   C = C1 only                                 (anything unrecognized)
+ */
+import { detectProject } from '../detectors.js';
+
+const STACK_BY_BUILD_TOOL = {
+    maven: 'maven',
+    gradle: 'gradle',
+    npm: 'node',
+    yarn: 'node',
+    pnpm: 'node',
+    xcodebuild: 'xcode',
+    swiftpm: 'xcode',
+    cocoapods: 'xcode',
+    go: 'go',
+    pip: 'python',
+    poetry: 'python',
+    bundler: 'ruby',
+    rake: 'ruby',
+};
+
+const TIER_BY_STACK = {
+    maven: 'A',
+    gradle: 'A',
+    node: 'A',
+    xcode: 'B',
+};
+
+export async function detectBuildTool(workspacePath) {
+    const meta = await detectProject(workspacePath);
+    const buildTool = meta?.buildTool || 'unknown';
+    const stack = STACK_BY_BUILD_TOOL[buildTool] || 'unknown';
+    return {
+        stack,
+        tier: TIER_BY_STACK[stack] || 'C',
+        language: meta?.language || 'unknown',
+        buildTool,
+        marker: meta?.marker || null,
+    };
+}

package/src/detectors/multi-project-detector.js

@@ -9,24 +9,24 @@ import { FileReader } from "../workspace/file-reader.js";
 /**
  * MultiProjectDetector
  *
- * Detecta múltiplos projetos dentro de um workspace
- * Escaneia subpastas em busca de projetos independentes (pom.xml, package.json, etc)
+ * Detects multiple projects within a workspace
+ * Scans subfolders looking for independent projects (pom.xml, package.json, etc)
  */
 export class MultiProjectDetector {
     constructor(workspaceRoot) {
         this.workspaceRoot = workspaceRoot;
-        this.maxDepth = 2; // Escanear até 2 níveis de profundidade
+        this.maxDepth = 2; // Scan up to 2 levels deep
     }
 
     /**
-     * Detecta todos os projetos no workspace
+     * Detects all projects in the workspace
      */
     async detectProjects() {
         console.log(`🔍 Scanning workspace for multiple projects: ${this.workspaceRoot}`);
 
         const projects = [];
 
-        // 1️⃣ Verificar se o próprio workspace root é um projeto
+        // 1️⃣ Check whether the workspace root itself is a project
         if (await this.isProject(this.workspaceRoot)) {
             console.log(`✅ Root is a project`);
             projects.push({
@@ -36,13 +36,13 @@ export class MultiProjectDetector {
             });
         }
 
-        // 2️⃣ Escanear subpastas em busca de projetos
+        // 2️⃣ Scan subfolders looking for projects
         const subProjects = await this.scanSubdirectories(this.workspaceRoot, 0);
         projects.push(...subProjects);
 
         console.log(`✅ Found ${projects.length} project(s) in workspace`);
 
-        // 3️⃣ Detectar serviços para cada projeto
+        // 3️⃣ Detect services for each project
         const allServices = [];
         for (const project of projects) {
             console.log(`🔎 Detecting services in: ${project.name}`);
@@ -55,7 +55,7 @@ export class MultiProjectDetector {
     }
 
     /**
-     * Verifica se um diretório é um projeto
+     * Checks whether a directory is a project
      */
     async isProject(dir) {
         const markers = [
@@ -67,12 +67,12 @@ export class MultiProjectDetector {
             'pyproject.toml',    // Python Poetry
             'go.mod',            // Go
             'Cargo.toml',        // Rust
-            '.csproj',           // .NET (qualquer arquivo .csproj)
+            '.csproj',           // .NET (any .csproj file)
             '.sln'               // .NET solution
         ];
 
         for (const marker of markers) {
-            // Para .csproj e .sln, procurar qualquer arquivo com extensão
+            // For .csproj and .sln, look for any file with that extension
             if (marker.startsWith('.')) {
                 try {
                     const files = await readdir(dir);
@@ -83,7 +83,7 @@ export class MultiProjectDetector {
                     continue;
                 }
             } else {
-                // Para markers específicos, verificar se existe
+                // For specific markers, check whether they exist
                 if (await exists(path.join(dir, marker))) {
                     return true;
                 }
@@ -94,7 +94,7 @@ export class MultiProjectDetector {
     }
 
     /**
-     * Escaneia subdiretórios recursivamente
+     * Scans subdirectories recursively
      */
     async scanSubdirectories(dir, depth) {
         if (depth >= this.maxDepth) {
@@ -109,7 +109,7 @@ export class MultiProjectDetector {
             for (const entry of entries) {
                 if (!entry.isDirectory()) continue;
 
-                // Ignorar pastas comuns que não são projetos
+                // Ignore common folders that are not projects
                 const ignoreDirs = [
                     'node_modules', 'target', 'build', 'dist', 'out',
                     '.git', '.idea', '.vscode', '__pycache__',
@@ -123,7 +123,7 @@ export class MultiProjectDetector {
 
                 const fullPath = path.join(dir, entry.name);
 
-                // Verificar se é um projeto
+                // Check whether it is a project
                 if (await this.isProject(fullPath)) {
                     console.log(`✅ Found project: ${entry.name}`);
                     projects.push({
@@ -131,11 +131,11 @@ export class MultiProjectDetector {
                         path: fullPath,
                         isRoot: false
                     });
-                    // Não escanear dentro de projetos encontrados
+                    // Do not scan inside projects that were found
                     continue;
                 }
 
-                // Continuar escaneando recursivamente
+                // Keep scanning recursively
                 const subProjects = await this.scanSubdirectories(fullPath, depth + 1);
                 projects.push(...subProjects);
             }
@@ -147,19 +147,19 @@ export class MultiProjectDetector {
     }
 
     /**
-     * Detecta serviços em um projeto específico
+     * Detects services in a specific project
      */
     async detectServicesInProject(project) {
         try {
-            // Usar o scanner para analisar o projeto
+            // Use the scanner to analyze the project
             const scanner = new WorkspaceScanner(project.path);
             const structure = await scanner.scan();
 
-            // Detectar linguagem
+            // Detect the language
             const languageDetector = new LanguageDetector(structure.files);
             const languageInfo = languageDetector.detect();
 
-            // Detectar framework
+            // Detect the framework
             const fileReader = new FileReader(project.path);
             const frameworkDetector = new FrameworkDetector(
                 languageInfo.primary,
@@ -168,7 +168,7 @@ export class MultiProjectDetector {
             );
             const frameworkInfo = await frameworkDetector.detect();
 
-            // Detectar serviços
+            // Detect the services
             const serviceDetector = new ServiceDetector(
                 project.path,
                 languageInfo,
@@ -177,7 +177,7 @@ export class MultiProjectDetector {
 
             const services = await serviceDetector.detect();
 
-            // Adicionar nome do workspace a cada serviço
+            // Add the workspace name to each service
             return services.map(service => ({
                 ...service,
                 workspaceName: project.name,

package/src/detectors/service-detector.js

@@ -4,8 +4,8 @@ import { exists, readFile } from "../fs-utils.js";
 /**
  * ServiceDetector
  *
- * Detecta serviços/microservices em um workspace
- * Identifica: nome, porta, tipo, comando de start
+ * Detects services/microservices in a workspace
+ * Identifies: name, port, type, start command
  */
 export class ServiceDetector {
     constructor(root, languageInfo, frameworkInfo) {
@@ -16,12 +16,12 @@ export class ServiceDetector {
     }
 
     /**
-     * Detecta todos os serviços no workspace
+     * Detects all services in the workspace
      */
     async detect() {
         const services = [];
 
-        // Detectar por tipo de projeto
+        // Detect by project type
         if (this.language === "java" && this.framework === "spring-boot") {
             const service = await this.detectSpringBootService();
             if (service) services.push(service);
@@ -41,20 +41,20 @@ export class ServiceDetector {
     }
 
     /**
-     * Detecta serviço Spring Boot
+     * Detects a Spring Boot service
      */
     async detectSpringBootService() {
         const pomPath = path.join(this.root, "pom.xml");
         const gradlePath = path.join(this.root, "build.gradle");
 
-        let serviceName = path.basename(this.root); // Fallback: nome da pasta
+        let serviceName = path.basename(this.root); // Fallback: folder name
         let port = 8080;
 
-        // Tentar extrair nome do pom.xml (ignorando o parent)
+        // Try to extract the name from pom.xml (ignoring the parent)
         if (await exists(pomPath)) {
             const content = await readFile(pomPath, "utf8");
 
-            // Remove o bloco <parent>...</parent> para não pegar o artifactId errado
+            // Remove the <parent>...</parent> block so we do not pick the wrong artifactId
             const contentWithoutParent = content.replace(/<parent>[\s\S]*?<\/parent>/gi, '');
             const artifactIdMatch = contentWithoutParent.match(/<artifactId>([^<]+)<\/artifactId>/);
 
@@ -63,7 +63,7 @@ export class ServiceDetector {
             }
         }
 
-        // Tentar extrair do build.gradle
+        // Try to extract it from build.gradle
         if (await exists(gradlePath)) {
             const content = await readFile(gradlePath, "utf8");
             const nameMatch = content.match(/rootProject\.name\s*=\s*['"]([^'"]+)['"]/);
@@ -72,7 +72,7 @@ export class ServiceDetector {
             }
         }
 
-        // Tentar detectar porta do application.yml/properties
+        // Try to detect the port from application.yml/properties
         port = await this.detectSpringBootPort();
 
         return {
@@ -89,7 +89,7 @@ export class ServiceDetector {
     }
 
     /**
-     * Detecta porta do Spring Boot
+     * Detects the Spring Boot port
      */
     async detectSpringBootPort() {
         const candidates = [
@@ -103,21 +103,21 @@ export class ServiceDetector {
             if (await exists(fullPath)) {
                 const content = await readFile(fullPath, "utf8");
 
-                // YAML - múltiplos padrões
+                // YAML - multiple patterns
                 if (rel.endsWith(".yml") || rel.endsWith(".yaml")) {
-                    // Padrão 1: server:\n  port: 8080
+                    // Pattern 1: server:\n  port: 8080
                     let match = content.match(/server:\s*\n\s*port:\s*(\d+)/);
                     if (match) return parseInt(match[1]);
 
-                    // Padrão 2: server.port: 8080
+                    // Pattern 2: server.port: 8080
                     match = content.match(/server\.port:\s*(\d+)/);
                     if (match) return parseInt(match[1]);
 
-                    // Padrão 3: port: ${PORT:8080}
+                    // Pattern 3: port: ${PORT:8080}
                     match = content.match(/port:\s*\$\{[^}]*:(\d+)\}/);
                     if (match) return parseInt(match[1]);
 
-                    // Padrão 4: server:\n    port: 8080 (com mais espaços)
+                    // Pattern 4: server:\n    port: 8080 (with more spaces)
                     match = content.match(/server:\s*[\r\n]+\s*port:\s*(\d+)/);
                     if (match) return parseInt(match[1]);
                 }
@@ -134,7 +134,7 @@ export class ServiceDetector {
     }
 
     /**
-     * Detecta serviço Node.js
+     * Detects a Node.js service
      */
     async detectNodeService() {
         const pkgPath = path.join(this.root, "package.json");
@@ -157,10 +157,10 @@ export class ServiceDetector {
     }
 
     /**
-     * Detecta porta do Node.js
+     * Detects the Node.js port
      */
     async detectNodePort() {
-        // Tentar .env
+        // Try .env
         const envPath = path.join(this.root, ".env");
         if (await exists(envPath)) {
             const content = await readFile(envPath, "utf8");
@@ -168,7 +168,7 @@ export class ServiceDetector {
             if (match) return parseInt(match[1]);
         }
 
-        // Defaults por framework
+        // Defaults per framework
         const defaults = {
             "next": 3000,
             "express": 3000,
@@ -179,7 +179,7 @@ export class ServiceDetector {
     }
 
     /**
-     * Detecta serviço Python
+     * Detects a Python service
      */
     async detectPythonService() {
         return {
@@ -196,7 +196,7 @@ export class ServiceDetector {
     }
 
     /**
-     * Detecta porta do Python
+     * Detects the Python port
      */
     async detectPythonPort() {
         const defaults = {
@@ -209,7 +209,7 @@ export class ServiceDetector {
     }
 
     /**
-     * Detecta serviço .NET
+     * Detects a .NET service
      */
     detectDotNetService() {
         return {
@@ -226,7 +226,7 @@ export class ServiceDetector {
     }
 
     /**
-     * Detecta serviço Go
+     * Detects a Go service
      */
     detectGoService() {
         return {

package/src/exec-utils.js

@@ -156,10 +156,27 @@ export async function compileAndTest({ language, buildTool, cwd, skipTests = fal
                 }
             }
 
-            // -e flag shows full error stack traces from Maven
+            // Speed flags — these stack:
+            //  -q                              quiet output (only ERROR-level)
+            //  --no-snapshot-updates           skip "checking for updates" of
+            //                                  SNAPSHOT deps that we already have
+            //                                  in ~/.m2 (saves seconds per run)
+            //  -T 1C                           one thread per CPU core (no-op on
+            //                                  single-module poms but harmless)
+            //  -Dmaven.compiler.useIncremental
+            //                          Compilation=true
+            //                                  default since Maven 3.9 — set
+            //                                  explicitly for older runners
+            //  -e                              show full stack on compile errors
+            const speedFlags = [
+                "-q",
+                "--no-snapshot-updates",
+                "-T", "1C",
+                "-Dmaven.compiler.useIncrementalCompilation=true"
+            ];
             const args = skipTests
-                ? ["compile", "-DskipTests", "-e", ...javaCompatFlags]
-                : ["test", "-e", ...javaCompatFlags];
+                ? ["compile", "-DskipTests", "-e", ...speedFlags, ...javaCompatFlags]
+                : ["test", "-e", ...speedFlags, ...javaCompatFlags];
 
             console.log(`[BUILD] [COMPILE] Running: ${mvnCmd} ${args.join(" ")}`);
             result = await run(mvnCmd, args, cwd, 10 * 60 * 1000, mavenEnv);
@@ -257,7 +274,12 @@ export async function compileAndTest({ language, buildTool, cwd, skipTests = fal
         else if (language === "swift" || language === "ios") {
             // SPM projects: try `swift build` if the Swift toolchain is available.
             // Xcode projects (xcodebuild) need macOS — not available on Linux Cloud Run.
-            if (buildTool === "spm" || buildTool === "swift") {
+            // Accept all three SPM marker values: "spm" (legacy), "swift" (generic),
+            // "swiftpm" (current detector output from detectors.js for Package.swift).
+            // Pre-Phase-11 bug: detectProject emits "swiftpm" but this branch only
+            // matched "spm"/"swift", so SwiftPM projects fell through to the Xcode
+            // branch (swiftc -typecheck) instead of using swift build.
+            if (buildTool === "spm" || buildTool === "swift" || buildTool === "swiftpm") {
                 console.log(`[BUILD] [COMPILE] Attempting: swift build`);
                 const swiftCheck = await run("which", ["swift"], cwd, 3000);
                 if (swiftCheck.code === 0) {