@maestro-ai/mcp-server 1.0.0

package/dist/gates/validator.js

@@ -0,0 +1,171 @@
+import { getChecklistPorTier } from "./tiers.js";
+/**
+ * Checklists de validação por fase (legado - mantido para compatibilidade)
+ * @deprecated Use getChecklistPorTier() para validação adaptativa
+ */
+export const GATE_CHECKLISTS = {
+    1: [
+        "Problema claramente definido",
+        "Personas ou usuários identificados",
+        "Funcionalidades MVP listadas",
+        "Métricas de sucesso definidas",
+    ],
+    2: [
+        "Requisitos funcionais com IDs únicos",
+        "Requisitos não-funcionais especificados",
+        "Critérios de aceite definidos",
+    ],
+    3: [
+        "Jornadas do usuário mapeadas",
+        "Wireframes ou protótipos criados",
+        "Acessibilidade considerada",
+    ],
+    4: [
+        "Entidades do domínio identificadas",
+        "Relacionamentos entre entidades definidos",
+        "Regras de negócio documentadas",
+    ],
+    5: [
+        "Modelo de dados definido",
+        "Índices planejados",
+        "Migrations ou scripts criados",
+    ],
+    6: [
+        "Diagrama C4 criado",
+        "Stack tecnológica justificada",
+        "ADRs documentados",
+    ],
+    7: [
+        "OWASP Top 10 avaliado",
+        "Autenticação definida",
+        "Dados sensíveis mapeados",
+    ],
+    8: [
+        "Estratégia de testes definida",
+        "Casos de teste mapeados",
+        "Ferramentas selecionadas",
+    ],
+    9: [
+        "Épicos definidos",
+        "Histórias de usuário criadas",
+        "Priorização realizada",
+        "Definition of Done estabelecido",
+    ],
+    10: [
+        "Esquema OpenAPI definido",
+        "Tipos gerados",
+        "Mocks disponíveis",
+    ],
+    11: [
+        "Código implementado",
+        "Testes passando",
+        "Code review realizado",
+    ],
+};
+/**
+ * Valida gate de uma fase com suporte a tier
+ * @param fase - Fase a validar
+ * @param entregavel - Conteúdo do entregável
+ * @param tier - Tier de validação (default: usa checklist da fase, que é tier 'base')
+ */
+export function validarGate(fase, entregavel, tier) {
+    const validados = [];
+    const pendentes = [];
+    const sugestoes = [];
+    // Usa checklist do tier se especificado, senão usa o da fase (legado)
+    const checklist = tier
+        ? getChecklistPorTier(fase.numero, tier)
+        : fase.gate_checklist;
+    for (const item of checklist) {
+        if (verificarItem(item, entregavel)) {
+            validados.push(item);
+        }
+        else {
+            pendentes.push(item);
+            sugestoes.push(gerarSugestao(item));
+        }
+    }
+    return {
+        valido: pendentes.length === 0,
+        itens_validados: validados,
+        itens_pendentes: pendentes,
+        sugestoes,
+    };
+}
+/**
+ * Verifica se um item do checklist está presente no entregável
+ */
+function verificarItem(item, entregavel) {
+    // Extrai palavras-chave do item
+    const keywords = item
+        .toLowerCase()
+        .replace(/[^a-záéíóúàãõç\s]/g, "")
+        .split(/\s+/)
+        .filter((word) => word.length > 3);
+    const conteudoLower = entregavel.toLowerCase();
+    // Verifica se pelo menos 70% das keywords estão presentes (mais rigoroso)
+    const encontradas = keywords.filter((kw) => conteudoLower.includes(kw));
+    return encontradas.length >= Math.ceil(keywords.length * 0.7);
+}
+/**
+ * Gera sugestão para item pendente
+ */
+function gerarSugestao(item) {
+    const sugestoes = {
+        problema: "Descreva claramente qual problema está sendo resolvido",
+        personas: "Identifique quem são os usuários do sistema",
+        funcionalidades: "Liste as funcionalidades principais do MVP",
+        requisitos: "Adicione requisitos funcionais com IDs (RF001, RF002...)",
+        "não-funcionais": "Especifique requisitos de performance, segurança, etc.",
+        critérios: "Defina critérios de aceite claros e testáveis",
+        jornadas: "Mapeie as jornadas completas dos usuários",
+        wireframes: "Crie wireframes ou protótipos das telas",
+        entidades: "Identifique as entidades principais do domínio",
+        relacionamentos: "Defina como as entidades se relacionam",
+        diagrama: "Crie diagrama C4 (Context, Container, Component)",
+        stack: "Justifique a escolha da stack tecnológica",
+        owasp: "Avalie os riscos do OWASP Top 10",
+        autenticação: "Defina estratégia de autenticação",
+        épicos: "Organize funcionalidades em épicos",
+        histórias: "Crie histórias de usuário detalhadas",
+        openapi: "Defina schema OpenAPI para os endpoints",
+        testes: "Garanta que os testes estejam passando",
+    };
+    // Busca sugestão correspondente
+    for (const [keyword, sugestao] of Object.entries(sugestoes)) {
+        if (item.toLowerCase().includes(keyword)) {
+            return sugestao;
+        }
+    }
+    return `Adicione: ${item}`;
+}
+/**
+ * Formata resultado do gate para exibição
+ */
+export function formatarResultadoGate(resultado) {
+    const lines = [];
+    lines.push("## 📋 Validação de Gate\n");
+    if (resultado.valido) {
+        lines.push("✅ **Gate aprovado!** Todos os itens validados.\n");
+    }
+    else {
+        lines.push("⚠️ **Gate pendente** - Itens faltando:\n");
+    }
+    if (resultado.itens_validados.length > 0) {
+        lines.push("### ✅ Validados:");
+        resultado.itens_validados.forEach((item) => {
+            lines.push(`- ${item}`);
+        });
+        lines.push("");
+    }
+    if (resultado.itens_pendentes.length > 0) {
+        lines.push("### ❌ Pendentes:");
+        resultado.itens_pendentes.forEach((item, i) => {
+            lines.push(`- ${item}`);
+            lines.push(`  💡 ${resultado.sugestoes[i]}`);
+        });
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=validator.js.map

package/dist/gates/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/gates/validator.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}