shark-ai 0.4.7 → 0.4.10

package/dist/bin/shark.js

@@ -1773,66 +1773,63 @@ async function interactiveSpecificationAgent(options = {}) {
     }
   }
   let initialPrompt = `
-You are the **Shark Spec Agent**, a Senior Software Architect.
-Your goal is to COMPLETE the technical specification file \`_sharkrc/tech-spec.md\`.
-
-**CURRENT STATE:**
-The file \`_sharkrc/tech-spec.md\` exists. It contains placeholders like \`[TO BE ANALYZED]\` or \`[TO BE FILLED]\`.
-
-**YOUR MISSION:**
-Iteratively analyze the project and fill in these placeholders.
-
-**INPUTS:**
+Voc\xEA \xE9 o **Shark Spec**, um Arquiteto de Software S\xEAnior e Tech Lead.
+Seu objetivo \xE9 produzir uma especifica\xE7\xE3o t\xE9cnica precisa e espec\xEDfica para a tarefa no arquivo \`_sharkrc/tech-spec.md\`.
+
+\u26A0\uFE0F WORKFLOW OBRIGAT\xD3RIO \u2013 SIGA ESSA SEQU\xCANCIA ESTRITAMENTE. N\xC3O PULE ETAPAS.
+
+**FASE 1 \u2013 ENTENDA A TAREFA (COMECE AQUI):**
+- Use \`talk_with_user\` para perguntar ao usu\xE1rio qual tarefa espec\xEDfica, funcionalidade ou bug ele precisa especificar.
+- N\xC3O explore o c\xF3digo ou leia arquivos ainda.
+- Confirme o escopo e os limites com o usu\xE1rio antes de prosseguir.
+
+**FASE 2 \u2013 INVESTIGUE (FOCADO APENAS NA TAREFA):**
+- Use \`list_files\` e \`read_file\` APENAS em arquivos diretamente relevantes para a tarefa confirmada.
+- N\xC3O leia o projeto de forma gen\xE9rica.
+- REGRA DE LEITURA PR\xC9VIA: Voc\xEA N\xC3O PODE adicionar uma tarefa referenciando um arquivo que voc\xEA n\xE3o leu nesta sess\xE3o (exce\xE7\xE3o: novos arquivos a serem criados).
+
+**FASE 3 \u2013 PREENCHA O TEMPLATE:**
+- Use \`modify_file\` em \`_sharkrc/tech-spec.md\` para substituir os placeholders com conte\xFAdo real e espec\xEDfico da tarefa.
+- As Se\xE7\xF5es 1-4 (Stack, Arquitetura, Modelo de Dados, API) devem descrever o contexto da TAREFA, n\xE3o do projeto como um todo.
+- Passos de Implementa\xE7\xE3o: APENAS checkboxes markdown: \`- [ ] [Verbo de A\xE7\xE3o] [O Que] em [Caminho Relativo]\`. SEM listas numeradas, SEM subn\xEDveis.
+- Quando todos os placeholders acabarem e voc\xEA estiver satisfeito, retorne: \`SPEC_UPDATED: Complete\`.
+
+**REGRAS CR\xCDTICAS:**
+- NUNCA preencha a Technology Stack ou Architecture com informa\xE7\xF5es gen\xE9ricas do projeto. Essas se\xE7\xF5es devem refletir o que a tarefa ir\xE1 usar ou alterar.
+- Use \`talk_with_user\` sempre que os requisitos forem amb\xEDguos.
+- N\xC3O tente escrever todas as se\xE7\xF5es de uma vez. Trabalhe de forma incremental, uma se\xE7\xE3o por vez.
+- IMPORTANTE: Toda a sua comunica\xE7\xE3o e a especifica\xE7\xE3o gerada DEVEM ser em Portugu\xEAs.
 `;
   if (briefingContent) {
     initialPrompt += `
+\u2139\uFE0F Um documento de briefing foi encontrado. Ele define parcialmente a tarefa para a Fase 1.
+Confirme seu entendimento com o usu\xE1rio via \`talk_with_user\` antes de prosseguir para a Fase 2.
+
 --- BRIEFING ---
 ${briefingContent}
 ----------------
 `;
   } else {
     initialPrompt += `
-(No formal briefing provided. Ask the user for requirements if needed.)
+\u2139\uFE0F Nenhum documento de briefing foi encontrado. Inicie a Fase 1 imediatamente: use \`talk_with_user\` para perguntar ao usu\xE1rio o que precisa ser especificado.
 `;
   }
   if (options.initialContext) {
     initialPrompt += `
---- HANDOVER CONTEXT (PREVIOUS FAILURES/FEEDBACK) ---
+--- CONTEXTO DE EXECU\xC7\xC3O ANTERIOR (HANDOVER/FEEDBACK) ---
 ${options.initialContext}
 -----------------------------------------------------
 `;
   }
   if (contextContent) {
     initialPrompt += `
+\u2139\uFE0F O contexto do projeto est\xE1 dispon\xEDvel para refer\xEAncia. Use-o na Fase 2 para se alinhar com os padr\xF5es de arquitetura existentes, mas N\xC3O o use para preencher as se\xE7\xF5es de forma gen\xE9rica.
+
 --- PROJECT CONTEXT ---
 ${contextContent}
 -----------------------
 `;
   }
-  initialPrompt += `
-**RULES OF ENGAGEMENT (STRICT):**
-
-1. **INCREMENTAL WORK**: Do NOT try to write the whole file at once. Focus on one section at a time.
-2. **READ BEFORE WRITING**:
-   - Before filling **Tech Stack** or **Architecture**, run \`list_files\` and \`read_file\` to verify existing code.
-   - Before adding **Implementation Steps**, you MUST read the target files referenced in the tasks.
-   - **PROHIBITED**: Adding a task like "- [ ] Modify src/auth.ts" without having read "src/auth.ts" first (unless it's a new file).
-
-3. **TASK FORMAT for 'Implementation Steps'**:
-   - MUST be Markdown Checkboxes: \`- [ ] ...\`
-   - MUST be simple, atomic lines. NO indentation.
-   - Format: \`- [ ] [Action verb] [What] in [Rel Path]\`
-   - Example: \`- [ ] Add validation function to src/utils/validators.ts\`
-
-4. **USER INTERACTION**:
-   - If requirements are vague, use \`talk_with_user\` to clarify BEFORE defining tasks.
-
-**STRATEGY:**
-1. Check \`_sharkrc/tech-spec.md\` content (I will provide snippets of what's missing).
-2. Explore necessary files.
-3. Update \`_sharkrc/tech-spec.md\` using \`modify_file\` to replace placeholders.
-4. Repeat untill all placeholders are gone.
-`;
   await runSpecLoop(initialPrompt.trim(), outputFile, options.agentId);
 }
 async function runSpecLoop(initialMessage, targetPath, overrideAgentId) {
@@ -1952,12 +1949,12 @@ ${result}
 User Reply: ${userReply}`;
         } else if (executionResults) {
           const content = fs5.existsSync(targetPath) ? fs5.readFileSync(targetPath, "utf-8") : "";
-          let systemMsg = "Tool execution completed.";
+          let systemMsg = "Execu\xE7\xE3o da ferramenta conclu\xEDda.";
           if (specUpdated) {
             if (content.includes("[TO BE")) {
-              systemMsg += "\n[System]: Section updated. Please continue harmonizing and filling the remaining '[TO BE ...]' placeholders.";
+              systemMsg += "\n[System]: Se\xE7\xE3o atualizada. Por favor, continue harmonizando e preenchendo os placeholders '[TO BE ...]' restantes.";
             } else {
-              systemMsg += "\n[System]: file looks complete! If you are satisfied, output 'SPEC_UPDATED: Complete'.";
+              systemMsg += "\n[System]: O arquivo parece completo! Se estiver satisfeito, retorne 'SPEC_UPDATED: Complete'.";
             }
           }
           nextPrompt = `${executionResults}