@maestro-ai/mcp-server 1.0.0 → 1.0.1

package/dist/tools/proximo.js

@@ -35,21 +35,21 @@ export async function proximo(args) {
         return {
             content: [{
                     type: "text",
-                    text: `# ❌ Erro: Estado Obrigatório
-
-O parâmetro \`estado_json\` é obrigatório no modo stateless.
-
-**Uso correto:**
-1. IA lê \`.maestro/estado.json\` do projeto
-2. Passa o conteúdo como parâmetro
-
-\`\`\`
-proximo(
-    entregavel: "conteúdo do PRD...",
-    estado_json: "...",
-    diretorio: "C:/projetos/meu-projeto"
-)
-\`\`\`
+                    text: `# ❌ Erro: Estado Obrigatório
+
+O parâmetro \`estado_json\` é obrigatório no modo stateless.
+
+**Uso correto:**
+1. IA lê \`.maestro/estado.json\` do projeto
+2. Passa o conteúdo como parâmetro
+
+\`\`\`
+proximo(
+    entregavel: "conteúdo do PRD...",
+    estado_json: "...",
+    diretorio: "C:/projetos/meu-projeto"
+)
+\`\`\`
 `,
                 }],
             isError: true,
@@ -83,23 +83,23 @@ proximo(
         return {
             content: [{
                     type: "text",
-                    text: `# ⚠️ Pré-requisito: CLI não inicializado
-
-O Maestro CLI precisa ser executado primeiro para configurar o projeto.
-
-## 📦 Execute o comando:
-
-\`\`\`bash
-cd ${diretorio}
-npx @maestro-ai/cli
-\`\`\`
-
----
-
-**Após executar o CLI, tente novamente:**
-\`\`\`
-proximo(...)
-\`\`\`
+                    text: `# ⚠️ Pré-requisito: CLI não inicializado
+
+O Maestro CLI precisa ser executado primeiro para configurar o projeto.
+
+## 📦 Execute o comando:
+
+\`\`\`bash
+cd ${diretorio}
+npx @maestro-ai/cli
+\`\`\`
+
+---
+
+**Após executar o CLI, tente novamente:**
+\`\`\`
+proximo(...)
+\`\`\`
 `
                 }],
             isError: true,
@@ -113,37 +113,37 @@ proximo(...)
         return {
             content: [{
                     type: "text",
-                    text: `# ❌ Entregável Inválido
-
-O entregável está vazio ou muito curto.
-
-| Métrica | Valor |
-|---------|-------|
-| **Tamanho recebido** | ${args.entregavel?.trim().length || 0} caracteres |
-| **Tamanho mínimo** | ${TAMANHO_MINIMO_ENTREGAVEL} caracteres |
-
----
-
-## ⚡ AÇÃO OBRIGATÓRIA
-
-Você **DEVE** desenvolver o entregável corretamente:
-
-1. **Ler especialista:**
-   \`\`\`
-   read_resource("maestro://especialista/${faseAtualInfo?.especialista || "..."}")
-   \`\`\`
-
-2. **Ler template:**
-   \`\`\`
-   read_resource("maestro://template/${faseAtualInfo?.template || "..."}")
-   \`\`\`
-
-3. Fazer as perguntas do especialista ao usuário
-4. Gerar entregável seguindo TODAS as seções do template
-5. Apresentar ao usuário para aprovação
-6. Só então chamar \`proximo()\`
-
-> ⛔ **NÃO TENTE AVANÇAR** com entregáveis vazios ou incompletos!
+                    text: `# ❌ Entregável Inválido
+
+O entregável está vazio ou muito curto.
+
+| Métrica | Valor |
+|---------|-------|
+| **Tamanho recebido** | ${args.entregavel?.trim().length || 0} caracteres |
+| **Tamanho mínimo** | ${TAMANHO_MINIMO_ENTREGAVEL} caracteres |
+
+---
+
+## ⚡ AÇÃO OBRIGATÓRIA
+
+Você **DEVE** desenvolver o entregável corretamente:
+
+1. **Ler especialista:**
+   \`\`\`
+   read_resource("maestro://especialista/${faseAtualInfo?.especialista || "..."}")
+   \`\`\`
+
+2. **Ler template:**
+   \`\`\`
+   read_resource("maestro://template/${faseAtualInfo?.template || "..."}")
+   \`\`\`
+
+3. Fazer as perguntas do especialista ao usuário
+4. Gerar entregável seguindo TODAS as seções do template
+5. Apresentar ao usuário para aprovação
+6. Só então chamar \`proximo()\`
+
+> ⛔ **NÃO TENTE AVANÇAR** com entregáveis vazios ou incompletos!
 `,
                 }],
             isError: true,
@@ -154,23 +154,23 @@ Você **DEVE** desenvolver o entregável corretamente:
         return {
             content: [{
                     type: "text",
-                    text: `# ⛔ Projeto Aguardando Aprovação
-
-O projeto está bloqueado aguardando aprovação do usuário.
-
-| Campo | Valor |
-|-------|-------|
-| **Motivo** | ${estado.motivo_bloqueio || "Score abaixo do ideal"} |
-| **Score** | ${estado.score_bloqueado}/100 |
-
-## 🔐 Ação Necessária
-
-O **usuário humano** deve decidir:
-
-- **Aprovar**: \`aprovar_gate(acao: "aprovar", ...)\`
-- **Rejeitar**: \`aprovar_gate(acao: "rejeitar", ...)\`
-
-> ⚠️ A IA NÃO pode aprovar automaticamente. Aguarde a decisão do usuário.
+                    text: `# ⛔ Projeto Aguardando Aprovação
+
+O projeto está bloqueado aguardando aprovação do usuário.
+
+| Campo | Valor |
+|-------|-------|
+| **Motivo** | ${estado.motivo_bloqueio || "Score abaixo do ideal"} |
+| **Score** | ${estado.score_bloqueado}/100 |
+
+## 🔐 Ação Necessária
+
+O **usuário humano** deve decidir:
+
+- **Aprovar**: \`aprovar_gate(acao: "aprovar", ...)\`
+- **Rejeitar**: \`aprovar_gate(acao: "rejeitar", ...)\`
+
+> ⚠️ A IA NÃO pode aprovar automaticamente. Aguarde a decisão do usuário.
 `,
                 }],
         };
@@ -179,35 +179,35 @@ O **usuário humano** deve decidir:
     if (estado.aguardando_classificacao) {
         let msgSugestao = "";
         if (estado.classificacao_sugerida) {
-            msgSugestao = `
-## Sugestão da IA
-| Campo | Valor |
-|-------|-------|
-| **Nível** | ${estado.classificacao_sugerida.nivel.toUpperCase()} |
-| **Pontuação** | ${estado.classificacao_sugerida.pontuacao} |
+            msgSugestao = `
+## Sugestão da IA
+| Campo | Valor |
+|-------|-------|
+| **Nível** | ${estado.classificacao_sugerida.nivel.toUpperCase()} |
+| **Pontuação** | ${estado.classificacao_sugerida.pontuacao} |
 `;
         }
         return {
             content: [{
                     type: "text",
-                    text: `# ⛔ Confirmação de Classificação Necessária
-
-Antes de prosseguir, você precisa confirmar a classificação do projeto.
-
-${msgSugestao}
-
-## 🔐 Ação Necessária
-
-Use a tool \`confirmar_classificacao\` para validar ou ajustar a complexidade.
-
-\`\`\`
-confirmar_classificacao(
-    estado_json: "...",
-    diretorio: "${diretorio}"
-)
-\`\`\`
-
-> ⚠️ **IMPORTANTE**: Você DEVE chamar esta tool antes de continuar.
+                    text: `# ⛔ Confirmação de Classificação Necessária
+
+Antes de prosseguir, você precisa confirmar a classificação do projeto.
+
+${msgSugestao}
+
+## 🔐 Ação Necessária
+
+Use a tool \`confirmar_classificacao\` para validar ou ajustar a complexidade.
+
+\`\`\`
+confirmar_classificacao(
+    estado_json: "...",
+    diretorio: "${diretorio}"
+)
+\`\`\`
+
+> ⚠️ **IMPORTANTE**: Você DEVE chamar esta tool antes de continuar.
 `,
                 }],
         };
@@ -233,21 +233,21 @@ confirmar_classificacao(
         return {
             content: [{
                     type: "text",
-                    text: `# ❌ Entregável Bloqueado
-
-## Score: ${qualityScore}/100 - Abaixo do mínimo (50)
-
-O entregável não atende aos requisitos mínimos de qualidade.
-
-### Problemas Encontrados
-
-${estruturaResult.feedback.join("\n")}
-
-### Checklist Pendente
-${gateResultado.itens_pendentes.map((item, i) => `- ${item}\n  💡 ${gateResultado.sugestoes[i]}`).join("\n")}
-
----
-
+                    text: `# ❌ Entregável Bloqueado
+
+## Score: ${qualityScore}/100 - Abaixo do mínimo (50)
+
+O entregável não atende aos requisitos mínimos de qualidade.
+
+### Problemas Encontrados
+
+${estruturaResult.feedback.join("\n")}
+
+### Checklist Pendente
+${gateResultado.itens_pendentes.map((item, i) => `- ${item}\n  💡 ${gateResultado.sugestoes[i]}`).join("\n")}
+
+---
+
 **Não é possível avançar.** Corrija os itens acima e tente novamente.`,
                 }],
         };
@@ -263,38 +263,38 @@ ${gateResultado.itens_pendentes.map((item, i) => `- ${item}\n  💡 ${gateResult
         return {
             content: [{
                     type: "text",
-                    text: `# ⚠️ Aprovação do Usuário Necessária
-
-## Score: ${qualityScore}/100 - Abaixo do mínimo recomendado (70)
-
-O entregável tem qualidade abaixo do ideal.
-
-### Itens Pendentes
-
-${estruturaResult.secoes_faltando.length > 0 ? `**Seções faltando:**\n${estruturaResult.secoes_faltando.map(s => `- ${s}`).join("\n")}\n` : ""}
-${gateResultado.itens_pendentes.length > 0 ? `**Checklist pendente:**\n${gateResultado.itens_pendentes.map(item => `- ${item}`).join("\n")}` : ""}
-
----
-
-## 🔐 Ação do Usuário Necessária
-
-O projeto foi **bloqueado** aguardando decisão do usuário:
-
-- **Para aprovar**: O usuário deve pedir para executar \`aprovar_gate(acao: "aprovar", ...)\`
-- **Para corrigir**: O usuário deve pedir para executar \`aprovar_gate(acao: "rejeitar", ...)\` e depois corrigir o entregável
-
-> ⚠️ **CRÍTICO**: A IA NÃO pode chamar \`aprovar_gate\` automaticamente.
-> Aguarde a decisão explícita do usuário humano.
-
----
-
-## 📁 Salvar Estado Bloqueado
-
-**Caminho:** \`${diretorio}/.maestro/estado.json\`
-
-\`\`\`json
-${estadoBloqueado.content}
-\`\`\`
+                    text: `# ⚠️ Aprovação do Usuário Necessária
+
+## Score: ${qualityScore}/100 - Abaixo do mínimo recomendado (70)
+
+O entregável tem qualidade abaixo do ideal.
+
+### Itens Pendentes
+
+${estruturaResult.secoes_faltando.length > 0 ? `**Seções faltando:**\n${estruturaResult.secoes_faltando.map(s => `- ${s}`).join("\n")}\n` : ""}
+${gateResultado.itens_pendentes.length > 0 ? `**Checklist pendente:**\n${gateResultado.itens_pendentes.map(item => `- ${item}`).join("\n")}` : ""}
+
+---
+
+## 🔐 Ação do Usuário Necessária
+
+O projeto foi **bloqueado** aguardando decisão do usuário:
+
+- **Para aprovar**: O usuário deve pedir para executar \`aprovar_gate(acao: "aprovar", ...)\`
+- **Para corrigir**: O usuário deve pedir para executar \`aprovar_gate(acao: "rejeitar", ...)\` e depois corrigir o entregável
+
+> ⚠️ **CRÍTICO**: A IA NÃO pode chamar \`aprovar_gate\` automaticamente.
+> Aguarde a decisão explícita do usuário humano.
+
+---
+
+## 📁 Salvar Estado Bloqueado
+
+**Caminho:** \`${diretorio}/.maestro/estado.json\`
+
+\`\`\`json
+${estadoBloqueado.content}
+\`\`\`
 `,
                 }],
             files: [{
@@ -350,19 +350,19 @@ ${estadoBloqueado.content}
         const classificacao = classificarPRD(args.entregavel);
         estado.nivel = classificacao.nivel;
         estado.total_fases = getFluxoComStitch(classificacao.nivel, estado.usar_stitch).total_fases;
-        classificacaoInfo = `
-## 🎯 Classificação do Projeto
-
-| Campo | Valor |
-|-------|-------|
-| **Nível** | ${classificacao.nivel.toUpperCase()} |
-| **Pontuação** | ${classificacao.pontuacao} pontos |
-| **Total de Fases** | ${estado.total_fases} |
-
-### Critérios detectados:
-${classificacao.criterios.map(c => `- ${c}`).join("\n")}
-
-> ${descreverNivel(classificacao.nivel)}
+        classificacaoInfo = `
+## 🎯 Classificação do Projeto
+
+| Campo | Valor |
+|-------|-------|
+| **Nível** | ${classificacao.nivel.toUpperCase()} |
+| **Pontuação** | ${classificacao.pontuacao} pontos |
+| **Total de Fases** | ${estado.total_fases} |
+
+### Critérios detectados:
+${classificacao.criterios.map(c => `- ${c}`).join("\n")}
+
+> ${descreverNivel(classificacao.nivel)}
 `;
     }
     // Avançar para próxima fase
@@ -441,37 +441,37 @@ ${classificacao.criterios.map(c => `- ${c}`).join("\n")}
         return {
             content: [{
                     type: "text",
-                    text: `# 🧐 Verificação de Complexidade Necessária
-
-Analisei o PRD e tenho uma sugestão de classificação.
-
-## Resultado da Análise
-| Campo | Valor |
-|-------|-------|
-| **Nível Sugerido** | **${classificacao.nivel.toUpperCase()}** |
-| **Pontuação** | ${classificacao.pontuacao} |
-
-### Critérios
-${classificacao.criterios.map(c => `- ${c}`).join("\n")}
-
----
-
-## 🔐 Próximo Passo: Confirmação
-
-O projeto foi **PAUSADO** para que você confirme essa classificação.
-A IA **NÃO** avançou para a próxima fase automaticamente.
-
-**Você deve chamar:**
-\`\`\`
-confirmar_classificacao(
-    estado_json: "...",
-    diretorio: "${diretorio}"
-)
-\`\`\`
-
-## 📁 Arquivos Salvos
-- O PRD foi salvo.
-- O estado foi atualizado marcando 'aguardando_classificacao'.
+                    text: `# 🧐 Verificação de Complexidade Necessária
+
+Analisei o PRD e tenho uma sugestão de classificação.
+
+## Resultado da Análise
+| Campo | Valor |
+|-------|-------|
+| **Nível Sugerido** | **${classificacao.nivel.toUpperCase()}** |
+| **Pontuação** | ${classificacao.pontuacao} |
+
+### Critérios
+${classificacao.criterios.map(c => `- ${c}`).join("\n")}
+
+---
+
+## 🔐 Próximo Passo: Confirmação
+
+O projeto foi **PAUSADO** para que você confirme essa classificação.
+A IA **NÃO** avançou para a próxima fase automaticamente.
+
+**Você deve chamar:**
+\`\`\`
+confirmar_classificacao(
+    estado_json: "...",
+    diretorio: "${diretorio}"
+)
+\`\`\`
+
+## 📁 Arquivos Salvos
+- O PRD foi salvo.
+- O estado foi atualizado marcando 'aguardando_classificacao'.
 `,
                 }],
             files: filesToSave,
@@ -488,50 +488,50 @@ confirmar_classificacao(
         // Aqui apenas registramos que passou.
     }
     // Não precisa mais carregar especialista/template - resposta compacta
-    const resposta = `# ✅ Fase ${faseAnterior} Concluída!
-
-## 📁 Entregável
-\`${caminhoArquivo}\`
-
-${gateResultado.valido ? "✅ Gate aprovado" : "⚠️ Gate forçado"}
-${classificacaoInfo}
-${classificacaoInfoAdicional}
-
----
-
-# 📍 Fase ${estado.fase_atual}/${estado.total_fases}: ${proximaFase?.nome || "Concluído"}
-
-| Campo | Valor |
-|-------|-------|
-| **Especialista** | ${proximaFase?.especialista || "-"} |
-| **Entregável** | ${proximaFase?.entregavel_esperado || "-"} |
-
-## Gate de Saída
-${proximaFase?.gate_checklist.map(item => `- [ ] ${item}`).join("\n") || "Nenhum"}
-${proximaFase ? gerarSecaoPrompts(proximaFase.nome) : ""}
----
-
-## ⚡ AÇÃO OBRIGATÓRIA - Salvar Arquivos
-
-### 1. Salvar entregável
-**Caminho:** \`${caminhoArquivo}\`
-(conteúdo no campo files)
-
-### 2. Atualizar estado
-**Caminho:** \`${diretorio}/.maestro/estado.json\`
-
-\`\`\`json
-${estadoFile.content}
-\`\`\`
-
-### 3. Atualizar resumo
-**Caminho:** \`${diretorio}/.maestro/resumo.json\`
-(conteúdo no campo files)
-
----
-
-> 💡 Use \`read_resource("maestro://especialista/${proximaFase?.especialista || "..."}")\` para ver o especialista.
-> 💡 Use \`read_resource("maestro://template/${proximaFase?.template || "..."}")\` para ver o template.
+    const resposta = `# ✅ Fase ${faseAnterior} Concluída!
+
+## 📁 Entregável
+\`${caminhoArquivo}\`
+
+${gateResultado.valido ? "✅ Gate aprovado" : "⚠️ Gate forçado"}
+${classificacaoInfo}
+${classificacaoInfoAdicional}
+
+---
+
+# 📍 Fase ${estado.fase_atual}/${estado.total_fases}: ${proximaFase?.nome || "Concluído"}
+
+| Campo | Valor |
+|-------|-------|
+| **Especialista** | ${proximaFase?.especialista || "-"} |
+| **Entregável** | ${proximaFase?.entregavel_esperado || "-"} |
+
+## Gate de Saída
+${proximaFase?.gate_checklist.map(item => `- [ ] ${item}`).join("\n") || "Nenhum"}
+${proximaFase ? gerarSecaoPrompts(proximaFase.nome) : ""}
+---
+
+## ⚡ AÇÃO OBRIGATÓRIA - Salvar Arquivos
+
+### 1. Salvar entregável
+**Caminho:** \`${caminhoArquivo}\`
+(conteúdo no campo files)
+
+### 2. Atualizar estado
+**Caminho:** \`${diretorio}/.maestro/estado.json\`
+
+\`\`\`json
+${estadoFile.content}
+\`\`\`
+
+### 3. Atualizar resumo
+**Caminho:** \`${diretorio}/.maestro/resumo.json\`
+(conteúdo no campo files)
+
+---
+
+> 💡 Use \`read_resource("maestro://especialista/${proximaFase?.especialista || "..."}")\` para ver o especialista.
+> 💡 Use \`read_resource("maestro://template/${proximaFase?.template || "..."}")\` para ver o template.
 `;
     return {
         content: [{ type: "text", text: resposta }],

package/dist/tools/salvar.js

@@ -31,19 +31,19 @@ export async function salvar(args) {
         return {
             content: [{
                     type: "text",
-                    text: `# ❌ Erro: Estado Obrigatório
-
-O parâmetro \`estado_json\` é obrigatório.
-
-**Uso:**
-\`\`\`
-salvar(
-    conteudo: "...",
-    tipo: "rascunho",
-    estado_json: "...",
-    diretorio: "C:/projetos/meu-projeto"
-)
-\`\`\`
+                    text: `# ❌ Erro: Estado Obrigatório
+
+O parâmetro \`estado_json\` é obrigatório.
+
+**Uso:**
+\`\`\`
+salvar(
+    conteudo: "...",
+    tipo: "rascunho",
+    estado_json: "...",
+    diretorio: "C:/projetos/meu-projeto"
+)
+\`\`\`
 `,
                 }],
             isError: true,
@@ -88,52 +88,52 @@ salvar(
             targetPath = `${diretorio}/docs/fase-${estado.fase_atual.toString().padStart(2, "0")}/${nomeArquivo}`;
             break;
     }
-    const resposta = `# 💾 Salvar Conteúdo
-
-## Detalhes
-
-| Campo | Valor |
-|-------|-------|
-| **Tipo** | ${args.tipo} |
-| **Arquivo** | \`${nomeArquivo}\` |
-| **Caminho** | \`${targetPath}\` |
-| **Tamanho** | ${args.conteudo.length} caracteres |
-
-${args.tipo === "rascunho" ? `
-> 💡 Rascunhos são salvos em \`.maestro/rascunhos/\` e não contam como entregáveis.
-` : ""}
-
-${args.tipo === "anexo" ? `
-> 💡 Anexos são salvos junto aos entregáveis da fase atual.
-` : ""}
-
-${args.tipo === "entregavel" ? `
-> ⚠️ Este entregável será salvo mas **não foi validado**. Use \`proximo()\` para validar e avançar.
-` : ""}
-
----
-
-## ⚡ AÇÃO OBRIGATÓRIA - Salvar Arquivo
-
-**A IA DEVE executar o comando abaixo para criar o arquivo.**
-
-### 1. Criar diretório (se necessário)
-\`\`\`
-mkdir -p "${targetPath.substring(0, targetPath.lastIndexOf("/"))}"
-\`\`\`
-
-### 2. Salvar arquivo
-**Caminho:** \`${targetPath}\`
-
-\`\`\`markdown
-${args.conteudo.slice(0, 500)}${args.conteudo.length > 500 ? "\n... [conteúdo completo no campo files]" : ""}
-\`\`\`
-
----
-
-**Próximas ações:**
-- Para avançar de fase: \`proximo(entregavel: "...", estado_json: "...")\`
-- Para verificar status: \`status(estado_json: "...")\`
+    const resposta = `# 💾 Salvar Conteúdo
+
+## Detalhes
+
+| Campo | Valor |
+|-------|-------|
+| **Tipo** | ${args.tipo} |
+| **Arquivo** | \`${nomeArquivo}\` |
+| **Caminho** | \`${targetPath}\` |
+| **Tamanho** | ${args.conteudo.length} caracteres |
+
+${args.tipo === "rascunho" ? `
+> 💡 Rascunhos são salvos em \`.maestro/rascunhos/\` e não contam como entregáveis.
+` : ""}
+
+${args.tipo === "anexo" ? `
+> 💡 Anexos são salvos junto aos entregáveis da fase atual.
+` : ""}
+
+${args.tipo === "entregavel" ? `
+> ⚠️ Este entregável será salvo mas **não foi validado**. Use \`proximo()\` para validar e avançar.
+` : ""}
+
+---
+
+## ⚡ AÇÃO OBRIGATÓRIA - Salvar Arquivo
+
+**A IA DEVE executar o comando abaixo para criar o arquivo.**
+
+### 1. Criar diretório (se necessário)
+\`\`\`
+mkdir -p "${targetPath.substring(0, targetPath.lastIndexOf("/"))}"
+\`\`\`
+
+### 2. Salvar arquivo
+**Caminho:** \`${targetPath}\`
+
+\`\`\`markdown
+${args.conteudo.slice(0, 500)}${args.conteudo.length > 500 ? "\n... [conteúdo completo no campo files]" : ""}
+\`\`\`
+
+---
+
+**Próximas ações:**
+- Para avançar de fase: \`proximo(entregavel: "...", estado_json: "...")\`
+- Para verificar status: \`status(estado_json: "...")\`
 `;
     return {
         content: [{ type: "text", text: resposta }],