@maestro-ai/mcp-server 5.6.5 → 6.0.0

package/dist/gates/readiness-gate.js

@@ -0,0 +1,301 @@
+/**
+ * Readiness Gate — Checkpoint consolidado pré-código (v10.0)
+ *
+ * Verifica se o CONJUNTO de artefatos de engenharia está coerente
+ * antes de permitir entrada nas fases de código (Frontend, Backend, etc.).
+ *
+ * Cada fase anterior teve seu gate individual, mas o Readiness Gate
+ * verifica a coerência do conjunto: PRD existe? Arquitetura definida?
+ * Backlog com user stories?
+ *
+ * Thresholds:
+ * - >= 80: auto-approve (prossegue para código)
+ * - 60-79: aprovação manual necessária
+ * - < 60: bloqueio total — artefatos críticos faltando
+ *
+ * @since v10.0
+ */
+import { existsSync } from "fs";
+import { readFile } from "fs/promises";
+import { join } from "path";
+/**
+ * Definição dos artefatos verificados pelo Readiness Gate.
+ * Pesos somam 100 para cada nível de complexidade.
+ */
+const ARTIFACT_DEFS = [
+    {
+        name: "PRD / Discovery",
+        weight: 25,
+        minChars: 600,
+        patterns: [
+            "docs/fase-01-*/discovery.md",
+            "docs/fase-01-*/PRD.md",
+            "docs/01-*/PRD.md",
+            "docs/01-*/discovery.md",
+        ],
+    },
+    {
+        name: "Requisitos",
+        weight: 15,
+        minChars: 400,
+        patterns: [
+            "docs/fase-02-*/requisitos.md",
+            "docs/02-*/requisitos.md",
+        ],
+        requiredFor: ["medio", "complexo"],
+    },
+    {
+        name: "Design",
+        weight: 15,
+        minChars: 400,
+        patterns: [
+            "docs/fase-*-design/design-doc.md",
+            "docs/fase-02-design/design-doc.md",
+            "docs/fase-03-design/design-doc.md",
+            "docs/*-design/design-doc.md",
+            "docs/*-ux-design/design-doc.md",
+        ],
+    },
+    {
+        name: "Arquitetura / Design Técnico",
+        weight: 25,
+        minChars: 600,
+        patterns: [
+            "docs/fase-*-arquitetura/arquitetura.md",
+            "docs/fase-*-technical-design/technical-design.md",
+            "docs/fase-03-arquitetura/arquitetura.md",
+            "docs/fase-04-*/technical-design.md",
+            "docs/fase-05-*/technical-design.md",
+            "docs/*-arquitetura/arquitetura.md",
+        ],
+        keywords: ["stack", "ADR"],
+    },
+    {
+        name: "Backlog / Planejamento",
+        weight: 15,
+        minChars: 300,
+        patterns: [
+            "docs/fase-*-planejamento/backlog.md",
+            "docs/fase-*-backlog/backlog.md",
+            "docs/fase-05-*/backlog.md",
+            "docs/fase-07-*/backlog.md",
+            "docs/*-backlog/backlog.md",
+        ],
+        keywords: ["US-"],
+        requiredFor: ["medio", "complexo"],
+    },
+    {
+        name: "Contrato API",
+        weight: 5,
+        minChars: 200,
+        patterns: [
+            "docs/fase-*-contrato-api/openapi.yaml",
+            "docs/fase-*-api/openapi.yaml",
+            "docs/*-api/openapi.yaml",
+        ],
+        requiredFor: ["complexo"],
+    },
+];
+// ============================================================
+// MAIN FUNCTION
+// ============================================================
+/**
+ * Executa o Readiness Check — verifica existência real de artefatos no disco.
+ *
+ * @param estado Estado atual do projeto
+ * @param diretorio Diretório raiz do projeto
+ * @returns ReadinessResult com score, breakdown e recomendações
+ */
+export async function readinessCheck(estado, diretorio) {
+    const nivel = estado.nivel;
+    const artifacts = [];
+    const gaps = [];
+    // Filtrar artefatos relevantes para o nível de complexidade
+    const relevantDefs = ARTIFACT_DEFS.filter(def => {
+        if (!def.requiredFor)
+            return true;
+        return def.requiredFor.includes(nivel);
+    });
+    // Normalizar pesos para somar 100
+    const totalWeight = relevantDefs.reduce((sum, d) => sum + d.weight, 0);
+    const weightMultiplier = totalWeight > 0 ? 100 / totalWeight : 1;
+    for (const def of relevantDefs) {
+        const normalizedWeight = Math.round(def.weight * weightMultiplier);
+        const result = await checkArtifact(diretorio, def, estado);
+        artifacts.push({
+            name: def.name,
+            exists: result.exists,
+            score: result.exists ? normalizedWeight : 0,
+            weight: normalizedWeight,
+            path: result.path,
+            charCount: result.charCount,
+            minChars: def.minChars,
+        });
+        if (!result.exists) {
+            gaps.push(def.name);
+        }
+    }
+    const score = artifacts.reduce((sum, a) => sum + a.score, 0);
+    const approved = score >= 80;
+    const requiresManualApproval = score >= 60 && score < 80;
+    const recommendation = generateRecommendation(score, gaps, nivel);
+    return {
+        score,
+        approved,
+        requiresManualApproval,
+        artifacts,
+        gaps,
+        recommendation,
+    };
+}
+// ============================================================
+// HELPERS
+// ============================================================
+/**
+ * Verifica se um artefato existe no disco e tem conteúdo mínimo.
+ * Tenta múltiplos patterns e também busca no estado.entregaveis.
+ */
+async function checkArtifact(diretorio, def, estado) {
+    // 1. Buscar nos entregáveis registrados no estado
+    for (const [_key, absPath] of Object.entries(estado.entregaveis || {})) {
+        const pathLower = absPath.toLowerCase();
+        const nameKeywords = def.name.toLowerCase().split(/[\s\/]+/);
+        const matches = nameKeywords.some(kw => kw.length > 3 && pathLower.includes(kw));
+        if (matches) {
+            try {
+                const content = await readFile(absPath, "utf-8");
+                if (content && content.trim().length >= def.minChars) {
+                    const keywordsOk = checkKeywords(content, def.keywords);
+                    if (keywordsOk) {
+                        return { exists: true, path: absPath, charCount: content.length };
+                    }
+                }
+            }
+            catch { /* file not found */ }
+        }
+    }
+    // 2. Tentar patterns no filesystem
+    const { readdirSync } = await import("fs");
+    for (const pattern of def.patterns) {
+        const resolved = resolveGlobPattern(diretorio, pattern);
+        for (const candidate of resolved) {
+            if (existsSync(candidate)) {
+                try {
+                    const content = await readFile(candidate, "utf-8");
+                    if (content && content.trim().length >= def.minChars) {
+                        const keywordsOk = checkKeywords(content, def.keywords);
+                        if (keywordsOk) {
+                            return { exists: true, path: candidate, charCount: content.length };
+                        }
+                    }
+                }
+                catch { /* read error */ }
+            }
+        }
+    }
+    return { exists: false, path: null, charCount: 0 };
+}
+/**
+ * Verifica se o conteúdo contém as keywords obrigatórias.
+ */
+function checkKeywords(content, keywords) {
+    if (!keywords || keywords.length === 0)
+        return true;
+    const lower = content.toLowerCase();
+    return keywords.some(kw => lower.includes(kw.toLowerCase()));
+}
+/**
+ * Resolve padrões glob simples (* only) em caminhos reais.
+ * Suporta apenas * em nomes de diretório — não é um glob engine completo.
+ */
+function resolveGlobPattern(diretorio, pattern) {
+    const parts = pattern.split("/");
+    let candidates = [diretorio];
+    for (const part of parts) {
+        const nextCandidates = [];
+        for (const dir of candidates) {
+            if (part.includes("*")) {
+                // Wildcard: listar diretórios e filtrar
+                try {
+                    const { readdirSync } = require("fs");
+                    const entries = readdirSync(dir, { withFileTypes: true });
+                    const regex = new RegExp("^" + part.replace(/\*/g, ".*") + "$", "i");
+                    for (const entry of entries) {
+                        if (regex.test(entry.name)) {
+                            nextCandidates.push(join(dir, entry.name));
+                        }
+                    }
+                }
+                catch { /* dir doesn't exist */ }
+            }
+            else {
+                nextCandidates.push(join(dir, part));
+            }
+        }
+        candidates = nextCandidates;
+    }
+    return candidates;
+}
+/**
+ * Gera recomendação textual baseada no score e nos gaps.
+ */
+function generateRecommendation(score, gaps, nivel) {
+    if (score >= 80) {
+        return "✅ Todos os artefatos de engenharia estão prontos. Pode prosseguir para código.";
+    }
+    if (score >= 60) {
+        return [
+            `⚠️ Score ${score}/100 — aprovação manual necessária.`,
+            `Artefatos faltando: ${gaps.join(", ")}.`,
+            `Opções: (1) Gerar os artefatos faltantes. (2) Aprovar manualmente para prosseguir.`,
+        ].join("\n");
+    }
+    return [
+        `❌ Score ${score}/100 — bloqueado. Artefatos críticos faltando.`,
+        `Faltam: ${gaps.join(", ")}.`,
+        `Complete as fases de engenharia antes de iniciar o código.`,
+    ].join("\n");
+}
+/**
+ * Formata o resultado do Readiness Gate como markdown para exibição.
+ */
+export function formatReadinessResult(result) {
+    const lines = [];
+    lines.push(`# 🔒 Readiness Gate — Checkpoint Pré-Código\n`);
+    lines.push(`## Score: ${result.score}/100\n`);
+    // Tabela de artefatos
+    lines.push(`| Artefato | Status | Chars | Mínimo | Score |`);
+    lines.push(`|----------|--------|-------|--------|-------|`);
+    for (const a of result.artifacts) {
+        const status = a.exists ? "✅" : "❌";
+        const chars = a.exists ? String(a.charCount) : "—";
+        lines.push(`| ${a.name} | ${status} | ${chars} | ${a.minChars} | ${a.score}/${a.weight} |`);
+    }
+    lines.push("");
+    // Gaps
+    if (result.gaps.length > 0) {
+        lines.push(`## ❌ Artefatos Faltando\n`);
+        for (const gap of result.gaps) {
+            lines.push(`- **${gap}** — gere este documento antes de iniciar o código`);
+        }
+        lines.push("");
+    }
+    // Recomendação
+    lines.push(`## Recomendação\n`);
+    lines.push(result.recommendation);
+    lines.push("");
+    // Ações
+    if (result.requiresManualApproval) {
+        lines.push(`## 🔐 Ação Necessária\n`);
+        lines.push(`- **Para corrigir** (recomendado): Complete os artefatos faltantes e re-submeta`);
+        lines.push(`- **Para aprovar mesmo assim**: Diga "aprovar readiness gate"`);
+        lines.push(`\n> ⚠️ A IA NÃO pode aprovar automaticamente. Aguarde decisão do usuário.`);
+    }
+    else if (!result.approved) {
+        lines.push(`## ⛔ Bloqueado\n`);
+        lines.push(`Complete as fases de engenharia antes de iniciar o código.`);
+        lines.push(`Use \`executar({ acao: "avancar" })\` em cada fase pendente.`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=readiness-gate.js.map

package/dist/gates/readiness-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-gate.js","sourceRoot":"","sources":["../../src/gates/readiness-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AA2C5B;;;GAGG;AACH,MAAM,aAAa,GAAkB;IACjC;QACI,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE;YACN,6BAA6B;YAC7B,uBAAuB;YACvB,kBAAkB;YAClB,wBAAwB;SAC3B;KACJ;IACD;QACI,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE;YACN,8BAA8B;YAC9B,yBAAyB;SAC5B;QACD,WAAW,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC;KACrC;IACD;QACI,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE;YACN,kCAAkC;YAClC,mCAAmC;YACnC,mCAAmC;YACnC,6BAA6B;YAC7B,gCAAgC;SACnC;KACJ;IACD;QACI,IAAI,EAAE,8BAA8B;QACpC,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE;YACN,wCAAwC;YACxC,kDAAkD;YAClD,yCAAyC;YACzC,oCAAoC;YACpC,oCAAoC;YACpC,mCAAmC;SACtC;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC;KAC7B;IACD;QACI,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE;YACN,qCAAqC;YACrC,gCAAgC;YAChC,2BAA2B;YAC3B,2BAA2B;YAC3B,2BAA2B;SAC9B;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,WAAW,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC;KACrC;IACD;QACI,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE;YACN,uCAAuC;YACvC,8BAA8B;YAC9B,yBAAyB;SAC5B;QACD,WAAW,EAAE,CAAC,UAAU,CAAC;KAC5B;CACJ,CAAC;AAEF,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,MAAqB,EACrB,SAAiB;IAEjB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,MAAM,SAAS,GAAwB,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,4DAA4D;IAC5D,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;QAC5C,IAAI,CAAC,GAAG,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,kCAAkC;IAClC,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,gBAAgB,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjE,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC7B,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAE3D,SAAS,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;YAC3C,MAAM,EAAE,gBAAgB;YACxB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACzB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE,CAAC;IAC7B,MAAM,sBAAsB,GAAG,KAAK,IAAI,EAAE,IAAI,KAAK,GAAG,EAAE,CAAC;IAEzD,MAAM,cAAc,GAAG,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAElE,OAAO;QACH,KAAK;QACL,QAAQ;QACR,sBAAsB;QACtB,SAAS;QACT,IAAI;QACJ,cAAc;KACjB,CAAC;AACN,CAAC;AAED,+DAA+D;AAC/D,UAAU;AACV,+DAA+D;AAE/D;;;GAGG;AACH,KAAK,UAAU,aAAa,CACxB,SAAiB,EACjB,GAAgB,EAChB,MAAqB;IAErB,kDAAkD;IAClD,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,MAAM,SAAS,GAAI,OAAkB,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAE7D,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CACnC,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAC1C,CAAC;QAEF,IAAI,OAAO,EAAE,CAAC;YACV,IAAI,CAAC;gBACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAiB,EAAE,OAAO,CAAC,CAAC;gBAC3D,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;oBACnD,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACxD,IAAI,UAAU,EAAE,CAAC;wBACb,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAiB,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;oBAChF,CAAC;gBACL,CAAC;YACL,CAAC;YAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACxD,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBACxB,IAAI,CAAC;oBACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;oBACnD,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;wBACnD,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;wBACxD,IAAI,UAAU,EAAE,CAAC;4BACb,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;wBACxE,CAAC;oBACL,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;YAChC,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,OAAe,EAAE,QAAmB;IACvD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,SAAiB,EAAE,OAAe;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,UAAU,GAAG,CAAC,SAAS,CAAC,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,cAAc,GAAa,EAAE,CAAC;QAEpC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,wCAAwC;gBACxC,IAAI,CAAC;oBACD,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;oBACtC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC1D,MAAM,KAAK,GAAG,IAAI,MAAM,CACpB,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,GAAG,EACrC,GAAG,CACN,CAAC;oBACF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;wBAC1B,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;4BACzB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;wBAC/C,CAAC;oBACL,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACJ,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;YACzC,CAAC;QACL,CAAC;QAED,UAAU,GAAG,cAAc,CAAC;IAChC,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAC3B,KAAa,EACb,IAAc,EACd,KAAwB;IAExB,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QACd,OAAO,gFAAgF,CAAC;IAC5F,CAAC;IAED,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QACd,OAAO;YACH,YAAY,KAAK,qCAAqC;YACtD,uBAAuB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACzC,oFAAoF;SACvF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,OAAO;QACH,WAAW,KAAK,gDAAgD;QAChE,WAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC7B,4DAA4D;KAC/D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC;IAE9C,sBAAsB;IACtB,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACpC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,MAAM,MAAM,KAAK,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IAChG,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO;IACP,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,oDAAoD,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,eAAe;IACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,QAAQ;IACR,IAAI,MAAM,CAAC,sBAAsB,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;QAC9F,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IAC5F,CAAC;SAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/handlers/code-phase-handler.d.ts

@@ -24,6 +24,7 @@ interface CodePhaseArgs {
 }
 /**
  * Verifica se uma fase é de código.
+ * v9.0: Delega para isCodePhaseName de flows/types.ts (fonte única de verdade).
  */
 export declare function isCodePhase(faseNome: string | undefined): boolean;
 /**

package/dist/handlers/code-phase-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-phase-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/code-phase-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAUnE,UAAU,aAAa;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAKD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGjE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CA4B9E"}
+{"version":3,"file":"code-phase-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/code-phase-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAWnE,UAAU,aAAa;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEjE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CA4B9E"}

package/dist/handlers/code-phase-handler.js

@@ -20,19 +20,17 @@ import { readFile } from "fs/promises";
 import { join } from "path";
 import { serializarEstado } from "../state/storage.js";
 import { saveFile } from "../utils/persistence.js";
-import { getFaseComStitch } from "../flows/types.js";
+import { getFaseComStitch, isCodePhaseName } from "../flows/types.js";
+import { validateCodePhase, formatCodeValidationResult } from "../gates/code-validator.js";
 import { decomposeBacklogToTasks, getNextTask, getTaskProgress } from "../services/task-decomposer.service.js";
 import { formatMention, detectIDE } from "../utils/ide-paths.js";
 import { getFaseDirName } from "../utils/entregavel-path.js";
-/** Nomes de fases que são de código */
-const CODE_PHASE_NAMES = ['Frontend', 'Backend', 'Integração', 'Deploy Final'];
 /**
  * Verifica se uma fase é de código.
+ * v9.0: Delega para isCodePhaseName de flows/types.ts (fonte única de verdade).
  */
 export function isCodePhase(faseNome) {
-    if (!faseNome)
-        return false;
-    return CODE_PHASE_NAMES.some(k => faseNome.includes(k));
+    return isCodePhaseName(faseNome);
 }
 /**
  * Entry point do Code Phase Handler.
@@ -98,6 +96,11 @@ async function handleSetup(args, codeState, faseInfo) {
     const nextTask = getNextTask((estado.tasks || []).filter(t => t.phase === estado.fase_atual));
     // Extrair stack da arquitetura (parsing simplificado)
     const stackInfo = extractStackInfo(arquiteturaContent, faseInfo.nome);
+    // v9.0 Sprint 4: Inicializar manifest com stack da arquitetura
+    if (!codeState.manifest) {
+        codeState.manifest = createEmptyManifest(estado.fase_atual, faseInfo.nome);
+    }
+    codeState.manifest.stack = extractStackForManifest(arquiteturaContent, faseInfo.nome);
     // Extrair user stories relevantes do backlog
     const relevantStories = extractRelevantStoriesSummary(backlogContent, faseInfo.nome);
     // Extrair endpoints do OpenAPI
@@ -268,6 +271,10 @@ executar({
 }
 /**
  * Handler: GATE — Todas tasks done. Gerar manifest e validar.
+ * v9.0: Usa CodeValidator (validação por artefatos) em vez de delegar para proximo.ts textual.
+ * Se score >= 70, avança automaticamente via proximo.ts.
+ * Se score 50-69, aguarda aprovação manual.
+ * Se score < 50, bloqueia com instruções.
  */
 async function handleGate(args, codeState, faseInfo) {
     const { estado, diretorio } = args;
@@ -280,6 +287,8 @@ async function handleGate(args, codeState, faseInfo) {
     // Escanear arquivos criados no diretório do projeto
     const scannedFiles = scanProjectFiles(diretorio, faseInfo.nome);
     manifest.arquivos_criados = [...new Set([...manifest.arquivos_criados, ...scannedFiles])];
+    // v9.0 Sprint 4: Popular user_stories a partir das tasks do estado
+    populateManifestUserStories(manifest, estado.tasks || [], estado.fase_atual);
     // Salvar manifest
     const faseDirName = getFaseDirName(estado.fase_atual, faseInfo.nome);
     const manifestPath = join(diretorio, 'docs', faseDirName, 'manifest.json');
@@ -295,12 +304,42 @@ async function handleGate(args, codeState, faseInfo) {
     catch (err) {
         console.warn('[code-phase] Falha ao salvar manifest:', err);
     }
-    // Marcar como completed
+    // v9.0: Validação orientada a artefatos (em vez de keywords textuais)
+    const validationResult = validateCodePhase(manifest, diretorio, estado.tasks || [], estado.fase_atual);
+    console.log(`[code-phase] v9.0: CodeValidator score=${validationResult.score}/100 approved=${validationResult.approved} (arquivos=${validationResult.breakdown.arquivos}, tasks=${validationResult.breakdown.tasks}, manifest=${validationResult.breakdown.manifest})`);
+    // Score < 50: BLOQUEAR
+    if (validationResult.score < 50) {
+        const feedbackMd = formatCodeValidationResult(validationResult, faseInfo.nome);
+        return {
+            content: [{
+                    type: "text",
+                    text: `# ❌ Gate de Código Bloqueado — ${faseInfo.nome}\n\n${feedbackMd}\n\n---\n\n**Não é possível avançar.** Complete as tasks pendentes, gere os arquivos e tente novamente com \`executar({ acao: "avancar" })\`.`,
+                }],
+            estado_atualizado: serializarEstado(estado).content,
+        };
+    }
+    // Score 50-69: Aguardar aprovação manual
+    if (validationResult.score < 70) {
+        estado.aguardando_aprovacao = true;
+        estado.motivo_bloqueio = `Gate de código: score ${validationResult.score}/100`;
+        estado.score_bloqueado = validationResult.score;
+        saveCodePhaseState(estado, codeState);
+        await persistState(estado, diretorio);
+        const feedbackMd = formatCodeValidationResult(validationResult, faseInfo.nome);
+        return {
+            content: [{
+                    type: "text",
+                    text: `# ⚠️ Aprovação Manual Necessária — ${faseInfo.nome}\n\n${feedbackMd}\n\n---\n\n## 🔐 Ação do Usuário\n\n- **Para corrigir** (recomendado): Complete as tasks pendentes e re-submeta\n- **Para aprovar mesmo assim**: Diga "aprovar o gate"\n\n> ⚠️ A IA NÃO pode aprovar automaticamente.`,
+                }],
+            estado_atualizado: serializarEstado(estado).content,
+        };
+    }
+    // Score >= 70: Aprovado — marcar como completed e delegar para proximo.ts para avançar fase
     codeState.status = 'completed';
     codeState.manifest = manifest;
     saveCodePhaseState(estado, codeState);
     await persistState(estado, diretorio);
-    // Delegar para proximo.ts para validar gate e avançar
+    // Delegar para proximo.ts para avançar fase (com summary como entregável textual)
     return delegateToProximo(args);
 }
 // === HELPER FUNCTIONS ===
@@ -529,22 +568,125 @@ function createEmptyManifest(fase, nome) {
         timestamp: new Date().toISOString(),
     };
 }
+/**
+ * v9.0 Sprint 4: Extrai stack estruturada da arquitetura para o manifest.
+ */
+function extractStackForManifest(arquiteturaContent, faseNome) {
+    if (!arquiteturaContent)
+        return { framework: '', language: 'TypeScript' };
+    const fase = faseNome.toLowerCase();
+    const content = arquiteturaContent.toLowerCase();
+    const extras = [];
+    let framework = '';
+    let language = 'TypeScript';
+    if (fase.includes('frontend')) {
+        if (content.includes('next.js') || content.includes('nextjs'))
+            framework = 'Next.js';
+        else if (content.includes('react'))
+            framework = 'React';
+        else if (content.includes('vue'))
+            framework = 'Vue.js';
+        else if (content.includes('angular'))
+            framework = 'Angular';
+        if (content.includes('tailwind'))
+            extras.push('Tailwind');
+        if (content.includes('shadcn'))
+            extras.push('shadcn/ui');
+        if (content.includes('zustand'))
+            extras.push('Zustand');
+        if (content.includes('react query') || content.includes('tanstack'))
+            extras.push('React Query');
+    }
+    else if (fase.includes('backend')) {
+        if (content.includes('express'))
+            framework = 'Express';
+        else if (content.includes('fastify'))
+            framework = 'Fastify';
+        else if (content.includes('nestjs') || content.includes('nest.js'))
+            framework = 'NestJS';
+        if (content.includes('prisma'))
+            extras.push('Prisma');
+        if (content.includes('postgresql') || content.includes('postgres'))
+            extras.push('PostgreSQL');
+        if (content.includes('redis'))
+            extras.push('Redis');
+        if (content.includes('jwt'))
+            extras.push('JWT');
+    }
+    else if (fase.includes('integra')) {
+        if (content.includes('playwright'))
+            framework = 'Playwright';
+        else if (content.includes('cypress'))
+            framework = 'Cypress';
+        if (content.includes('docker'))
+            extras.push('Docker');
+    }
+    else if (fase.includes('deploy')) {
+        if (content.includes('docker'))
+            framework = 'Docker';
+        if (content.includes('github actions'))
+            extras.push('GitHub Actions');
+        if (content.includes('aws'))
+            extras.push('AWS');
+    }
+    if (content.includes('javascript') && !content.includes('typescript'))
+        language = 'JavaScript';
+    if (content.includes('python'))
+        language = 'Python';
+    if (content.includes('java') && !content.includes('javascript'))
+        language = 'Java';
+    return { framework, language, extras: extras.length > 0 ? extras : undefined };
+}
+/**
+ * v9.0 Sprint 4: Popula manifest.user_stories a partir das tasks do estado.
+ * Mapeia tasks com parent_id (stories) para CodeManifestStory.
+ */
+function populateManifestUserStories(manifest, tasks, faseNumero) {
+    const phaseTasks = tasks.filter(t => t.phase === faseNumero);
+    const stories = phaseTasks.filter(t => t.type === 'story');
+    manifest.user_stories = stories.map(story => {
+        // Extrair ID da US do título (ex: "US-020: CRUD Produtos")
+        const idMatch = story.title.match(/US-\d+/i);
+        const id = idMatch ? idMatch[0] : story.id;
+        // Verificar status das sub-tasks
+        const childTasks = phaseTasks.filter(t => t.parent_id === story.id);
+        const allDone = childTasks.length > 0 && childTasks.every(t => t.status === 'done');
+        const anyInProgress = childTasks.some(t => t.status === 'in_progress');
+        // Coletar arquivos das sub-tasks
+        const arquivos = childTasks
+            .flatMap(t => t.metadata?.files || [])
+            .filter(Boolean);
+        return {
+            id,
+            titulo: story.title.replace(/^US-\d+:\s*/i, ''),
+            status: allDone ? 'done' : anyInProgress ? 'in_progress' : 'todo',
+            arquivos,
+        };
+    });
+}
 function generateSummaryMarkdown(manifest, faseInfo, progress) {
-    return `# ${faseInfo.nome} — Resumo de Implementação
-
-## Progresso
-- **Tasks:** ${progress.done}/${progress.total} (${progress.percentage}%)
-- **Arquivos criados:** ${manifest.arquivos_criados.length}
-
-## User Stories
-${manifest.user_stories.map(s => `- ${s.status === 'done' ? '✅' : '⏳'} **${s.id}**: ${s.titulo}`).join('\n') || '(geradas via TaskDecomposer)'}
-
-## Arquivos Criados
-${manifest.arquivos_criados.map(f => `- \`${f}\``).join('\n') || '(nenhum registrado)'}
-
-## Timestamp
-${manifest.timestamp}
-`;
+    // v9.0 Sprint 4: Stack info
+    const stackMd = manifest.stack?.framework
+        ? `## Stack\n- **Framework:** ${manifest.stack.framework}\n- **Language:** ${manifest.stack.language}${manifest.stack.extras ? `\n- **Extras:** ${manifest.stack.extras.join(', ')}` : ''}\n`
+        : '';
+    // v9.0 Sprint 4: Tabela rastreável US → arquivos → status
+    let traceabilityMd = '';
+    if (manifest.user_stories.length > 0) {
+        traceabilityMd = `## Rastreabilidade US → Código\n\n| US | Título | Status | Arquivos |\n|----|--------|--------|----------|\n`;
+        for (const story of manifest.user_stories) {
+            const icon = story.status === 'done' ? '✅' : story.status === 'in_progress' ? '🔄' : '⏳';
+            const arquivos = story.arquivos.length > 0
+                ? story.arquivos.slice(0, 3).map(f => `\`${f}\``).join(', ') + (story.arquivos.length > 3 ? ` (+${story.arquivos.length - 3})` : '')
+                : '—';
+            traceabilityMd += `| ${story.id} | ${story.titulo.substring(0, 50)} | ${icon} ${story.status} | ${arquivos} |\n`;
+        }
+        const doneCount = manifest.user_stories.filter(s => s.status === 'done').length;
+        traceabilityMd += `\n> **US Concluídas:** ${doneCount}/${manifest.user_stories.length}\n`;
+    }
+    else {
+        traceabilityMd = `## User Stories\n(geradas via TaskDecomposer)\n`;
+    }
+    return `# ${faseInfo.nome} — Resumo de Implementação\n\n## Progresso\n- **Tasks:** ${progress.done}/${progress.total} (${progress.percentage}%)\n- **Arquivos criados:** ${manifest.arquivos_criados.length}\n\n${stackMd}\n${traceabilityMd}\n## Arquivos Criados\n${manifest.arquivos_criados.map(f => `- \`${f}\``).join('\n') || '(nenhum registrado)'}\n\n## Timestamp\n${manifest.timestamp}\n`;
 }
 function getExpertiseForPhase(faseNome) {
     const fase = faseNome.toLowerCase();
@@ -559,23 +701,30 @@ function getExpertiseForPhase(faseNome) {
     return ['desenvolvimento', 'arquitetura', 'testes'];
 }
 /**
- * Delega para proximo.ts para validar gate e avançar fase.
- * Gera um entregável textual resumido a partir do manifest.
+ * Delega para proximo.ts para avançar fase.
+ *
+ * v10.0 FIX: Quando code-validator já aprovou (codeState.status === 'completed'),
+ * passa skip_validation=true para pular a re-validação textual redundante
+ * em proximo.ts (validateDeliverableForGate). Antes, o code-validator fazia
+ * validação por artefatos reais e depois proximo.ts re-validava por keywords,
+ * potencialmente contradizendo o score.
  */
 async function delegateToProximo(args) {
     const { estado, diretorio } = args;
     const codeState = estado.codePhaseState;
     const manifest = codeState?.manifest;
-    // Gerar entregável textual a partir do manifest para o proximo.ts validar
+    // Gerar entregável textual a partir do manifest (usado para resumo, não validação)
     const entregavelTexto = manifest
         ? generateSummaryMarkdown(manifest, { nome: codeState?.faseNome || '' }, getTaskProgress(estado.tasks || [], estado.fase_atual))
         : 'Fase de código concluída. Manifest não gerado.';
-    // Importar proximo.ts e delegar
+    // v10.0: Se code-validator já aprovou, pular validação textual redundante
+    const skipValidation = codeState?.status === 'completed';
     const { proximo } = await import("../tools/proximo.js");
     return proximo({
         diretorio,
         estado_json: serializarEstado(estado).content,
         entregavel: entregavelTexto,
+        skip_validation: skipValidation,
     });
 }
 //# sourceMappingURL=code-phase-handler.js.map