shark-ai 0.4.15 → 0.4.16

package/dist/bin/shark.js

@@ -1790,22 +1790,22 @@ async function interactiveSpecificationAgent(options = {}) {
     let initialContent = `# Technical Specification: {{PROJECT_NAME}}
 
 ## 1. Technology Stack
-[TO BE ANALYZED]
+[TO BE ANALYZED - STACK]
 - Language: [e.g. TypeScript]
 - Framework: [e.g. Node.js / React]
 - Database: [e.g. SQLite / PostgreSQL]
 - Key Libraries: [Top 5 dependencies]
 
 ## 2. Architecture Overview
-[TO BE ANALYZED]
+[TO BE ANALYZED - ARCHITECTURE]
 [Brief description of architectural pattern]
 
 ## 3. Data Model
-[TO BE ANALYZED]
+[TO BE ANALYZED - DATA MODEL]
 [Schema/ERD definitions]
 
 ## 4. API / Interface Contracts
-[TO BE ANALYZED]
+[TO BE ANALYZED - API]
 [Main endpoints or CLI commands]
 
 ## 5. Implementation Steps
@@ -1911,58 +1911,6 @@ async function runSpecLoop(initialMessage, targetPath, overrideAgentId) {
         let executionResults = "";
         let waitingForUser = false;
         let specUpdated = false;
-        if (lastResponse.message && lastResponse.message.includes("PHASE_COMPLETED")) {
-          if (currentPhase === 1) {
-            currentPhase = 2;
-            tui.log.success(`\u2705 Fase 1 Conclu\xEDda. Iniciando Fase 2 (Investiga\xE7\xE3o).`);
-            nextPrompt = `[System Message]
-Voc\xEA completou a FASE 1 com sucesso.
-
-**VOC\xCA AGORA EST\xC1 NA FASE 2: INVESTIGA\xC7\xC3O**
-- Use \`search_code\` e \`list_files\` para explorar os arquivos relevantes \xE0 tarefa.
-- Prefira \`search_code\` em vez de \`read_file\` para buscar c\xF3digo sem inflar o contexto.
-- N\xC3O leia o projeto inteiro de forma gen\xE9rica.
-- REGRA DE OURO (READ-FIRST): Voc\xEA N\xC3O PODE referenciar um arquivo na especifica\xE7\xE3o t\xE9cnica que n\xE3o tenha investigado nesta fase.
-- Quando achar que possui toda a clareza t\xE9cnica sobre onde e o que deve ser feito no c\xF3digo, emita "PHASE_COMPLETED" no summary.`;
-            continue;
-          } else if (currentPhase === 2) {
-            currentPhase = 3;
-            tui.log.success(`\u2705 Fase 2 Conclu\xEDda. Iniciando Fase 3 (Preenchimento).`);
-            nextPrompt = `[System Message]
-Voc\xEA completou a FASE 2 com sucesso.
-
-**VOC\xCA AGORA EST\xC1 NA FASE 3: PREENCHIMENTO DO TEMPLATE**
-- Use \`modify_file\` no arquivo \`${targetPath}\` para substituir os placeholders pelo conte\xFAdo real levantado na fase de investiga\xE7\xE3o.
-- As se\xE7\xF5es 1-4 devem descrever o contexto da TAREFA, e n\xE3o o projeto como um todo.
-- Passos de Implementa\xE7\xE3o (Implementation Steps): APENAS checkboxes markdown: \`- [ ] [Verbo de A\xE7\xE3o] [O Que] em [Caminho Relativo]\`.
-- Quando TODOS os placeholders ([TO BE ANALYZED] ou [TO BE FILLED]) forem substitu\xEDdos e o trabalho conclu\xEDdo, emita "SPEC_UPDATED: Complete" no summary para finalizar.`;
-            continue;
-          }
-        }
-        if (lastResponse.message && lastResponse.message.includes("SPEC_UPDATED:")) {
-          if (currentPhase < 3) {
-            tui.log.warning(`O agente tentou finalizar prematuramente. For\xE7ando retorno para a fase atual...`);
-            nextPrompt = `[System Error]: Voc\xEA tentou finalizar a especifica\xE7\xE3o prematuramente emitindo SPEC_UPDATED, mas ainda est\xE1 na Fase ${currentPhase}. Voc\xEA s\xF3 pode finalizar quando estiver na Fase 3.
-
-Continue seu trabalho na Fase ${currentPhase} ou emita "PHASE_COMPLETED" se terminou esta etapa atual.`;
-            continue;
-          }
-          const content = fs5.existsSync(targetPath) ? fs5.readFileSync(targetPath, "utf-8") : "";
-          if (content.includes("[TO BE")) {
-            const pendingMatches = [...content.matchAll(/## ([^\n]+)[\s\S]*?\[TO BE/g)].map((m) => m[1]);
-            let missing = pendingMatches.length > 0 ? pendingMatches.join(", ") : "algumas se\xE7\xF5es";
-            tui.log.warning(`O agente tentou concluir prematuramente, mas h\xE1 placeholders pendentes. For\xE7ando retorno...`);
-            nextPrompt = `[System Error]: A valida\xE7\xE3o falhou e o bloqueio autom\xE1tico foi acionado.
-Voc\xEA tentou concluir a tarefa, mas o arquivo AINDA possui placeholders '[TO BE ANALYZED]' ou '[TO BE FILLED]'.
-As seguintes se\xE7\xF5es ainda cont\xEAm estes placeholders: ${missing}.
-Voc\xEA \xE9 OBRIGADO a usar a action \`modify_file\` para preencher o conte\xFAdo de cada uma dessas se\xE7\xF5es. Use o placeholder exato no campo \`target_content\`. N\xC3O repita a conclus\xE3o da tarefa at\xE9 corrigir todas as pend\xEAncias.`;
-            continue;
-          } else {
-            const updateSummary = lastResponse.message.split("SPEC_UPDATED:")[1].trim();
-            tui.log.success(`\u2705 Spec Finalized: ${updateSummary}`);
-            return;
-          }
-        }
         for (const action of lastResponse.actions) {
           if (action.type === "talk_with_user") {
             tui.log.info(colors.primary("\u{1F916} Architect:"));
@@ -2032,7 +1980,7 @@ ${result}
 `;
                     specUpdated = true;
                   } else {
-                    executionResults += `[Action modify_file]: Failed. Target content not found.
+                    executionResults += `[Action modify_file]: Failed. Target content not found or ambiguous.
 `;
                   }
                 } else {
@@ -2046,6 +1994,62 @@ ${result}
             }
           }
         }
+        if (lastResponse.message && lastResponse.message.includes("PHASE_COMPLETED")) {
+          const extraContext = executionResults ? `
+
+Resultados das \xFAltimas a\xE7\xF5es executadas antes da conclus\xE3o:
+${executionResults}` : "";
+          if (currentPhase === 1) {
+            currentPhase = 2;
+            tui.log.success(`\u2705 Fase 1 Conclu\xEDda. Iniciando Fase 2 (Investiga\xE7\xE3o).`);
+            nextPrompt = `[System Message]
+Voc\xEA completou a FASE 1 com sucesso.
+
+**VOC\xCA AGORA EST\xC1 NA FASE 2: INVESTIGA\xC7\xC3O**
+- Use \`search_code\` e \`list_files\` para explorar os arquivos relevantes \xE0 tarefa.
+- Prefira \`search_code\` em vez de \`read_file\` para buscar c\xF3digo sem inflar o contexto.
+- N\xC3O leia o projeto inteiro de forma gen\xE9rica.
+- REGRA DE OURO (READ-FIRST): Voc\xEA N\xC3O PODE referenciar um arquivo na especifica\xE7\xE3o t\xE9cnica que n\xE3o tenha investigado nesta fase.
+- Quando achar que possui toda a clareza t\xE9cnica sobre onde e o que deve ser feito no c\xF3digo, emita "PHASE_COMPLETED" no summary.${extraContext}`;
+            continue;
+          } else if (currentPhase === 2) {
+            currentPhase = 3;
+            tui.log.success(`\u2705 Fase 2 Conclu\xEDda. Iniciando Fase 3 (Preenchimento).`);
+            nextPrompt = `[System Message]
+Voc\xEA completou a FASE 2 com sucesso.
+
+**VOC\xCA AGORA EST\xC1 NA FASE 3: PREENCHIMENTO DO TEMPLATE**
+- Use \`modify_file\` no arquivo \`${targetPath}\` para substituir os placeholders pelo conte\xFAdo real levantado na fase de investiga\xE7\xE3o.
+- As se\xE7\xF5es 1-4 devem descrever o contexto da TAREFA, e n\xE3o o projeto como um todo.
+- Passos de Implementa\xE7\xE3o (Implementation Steps): APENAS checkboxes markdown: \`- [ ] [Verbo de A\xE7\xE3o] [O Que] em [Caminho Relativo]\`.
+- Quando TODOS os placeholders ([TO BE ANALYZED...] ou [TO BE FILLED]) forem substitu\xEDdos e o trabalho conclu\xEDdo, emita "SPEC_UPDATED: Complete" no summary para finalizar.${extraContext}`;
+            continue;
+          }
+        }
+        if (lastResponse.message && lastResponse.message.includes("SPEC_UPDATED:")) {
+          if (currentPhase < 3) {
+            tui.log.warning(`O agente tentou finalizar prematuramente. For\xE7ando retorno para a fase atual...`);
+            nextPrompt = `[System Error]: Voc\xEA tentou finalizar a especifica\xE7\xE3o prematuramente emitindo SPEC_UPDATED, mas ainda est\xE1 na Fase ${currentPhase}. Voc\xEA s\xF3 pode finalizar quando estiver na Fase 3.
+
+Continue seu trabalho na Fase ${currentPhase} ou emita "PHASE_COMPLETED" se terminou esta etapa atual.`;
+            continue;
+          }
+          const content = fs5.existsSync(targetPath) ? fs5.readFileSync(targetPath, "utf-8") : "";
+          if (content.includes("[TO BE")) {
+            const pendingMatches = [...content.matchAll(/## ([^\n]+)[\s\S]*?\[TO BE/g)].map((m) => m[1]);
+            let missing = pendingMatches.length > 0 ? pendingMatches.join(", ") : "algumas se\xE7\xF5es";
+            tui.log.warning(`O agente tentou concluir prematuramente, mas h\xE1 placeholders pendentes. For\xE7ando retorno...`);
+            nextPrompt = `[System Error]: A valida\xE7\xE3o falhou e o bloqueio autom\xE1tico foi acionado.
+Voc\xEA tentou concluir a tarefa, mas o arquivo AINDA possui placeholders '[TO BE ANALYZED...]' ou '[TO BE FILLED]'.
+As seguintes se\xE7\xF5es ainda cont\xEAm estes placeholders: ${missing}.
+Voc\xEA \xE9 OBRIGADO a usar a action \`modify_file\` para preencher o conte\xFAdo de cada uma dessas se\xE7\xF5es. Use o placeholder exato no campo \`target_content\`. N\xC3O repita a conclus\xE3o da tarefa at\xE9 corrigir todas as pend\xEAncias.`;
+            continue;
+          } else {
+            const updateSummary = lastResponse.message.split("SPEC_UPDATED:")[1].trim();
+            tui.log.success(`\u2705 Spec Finalized: ${updateSummary}`);
+            return;
+          }
+        }
         if (waitingForUser) {
           const userReply = await tui.text({ message: "Your answer", placeholder: "Type your answer..." });
           if (tui.isCancel(userReply)) {
@@ -2068,6 +2072,8 @@ Por favor, envie uma nova action \`modify_file\` focada em uma destas se\xE7\xF5
             } else {
               systemMsg += "\n[System]: O arquivo parece completo! Se estiver satisfeito e possuir TODAS as implementa\xE7\xF5es descritas, retorne 'SPEC_UPDATED: Complete'.";
             }
+          } else {
+            systemMsg += "\n[System]: A modifica\xE7\xE3o do arquivo falhou. Verifique se o `target_content` que voc\xEA usou existe EXATAMENTE como no arquivo e se ele \xE9 \xDANICO na hora de usar a action `modify_file`.";
           }
           nextPrompt = `${executionResults}