@maestro-ai/mcp-server 5.0.0 → 5.2.0

package/dist/tests/v52-integration.test.js

@@ -0,0 +1,223 @@
+/**
+ * Testes unitários para módulos integrados na v5.2
+ *
+ * Cobre:
+ * - skill-cache.service (A.3)
+ * - structured-content.service (A.8)
+ * - annotations-fallback.service (A.7)
+ * - response-formatter (A.6)
+ * - client-capabilities.service (A.5)
+ * - elicitation-fallback.service (A.7)
+ * - sampling-fallback.service (A.7)
+ */
+import { describe, it, expect, beforeEach } from "vitest";
+// === skill-cache.service ===
+import { getCached, setCache, invalidateCache, getCacheStats, } from "../services/skill-cache.service.js";
+describe("skill-cache.service", () => {
+    beforeEach(() => {
+        invalidateCache();
+    });
+    it("retorna null para chave inexistente", () => {
+        expect(getCached("nao-existe")).toBeNull();
+    });
+    it("armazena e recupera valor", () => {
+        setCache("key1", "valor1");
+        expect(getCached("key1")).toBe("valor1");
+    });
+    it("invalida cache específico", () => {
+        setCache("key1", "valor1");
+        setCache("key2", "valor2");
+        invalidateCache("key1");
+        expect(getCached("key1")).toBeNull();
+        expect(getCached("key2")).toBe("valor2");
+    });
+    it("invalida todo o cache", () => {
+        setCache("key1", "valor1");
+        setCache("key2", "valor2");
+        invalidateCache();
+        expect(getCached("key1")).toBeNull();
+        expect(getCached("key2")).toBeNull();
+    });
+    it("retorna stats corretas", () => {
+        setCache("a", "1");
+        setCache("b", "2");
+        const stats = getCacheStats();
+        expect(stats.size).toBe(2);
+        expect(stats.keys).toContain("a");
+        expect(stats.keys).toContain("b");
+    });
+});
+// === structured-content.service ===
+import { withStructuredContent, extractStructuredData, } from "../services/structured-content.service.js";
+describe("structured-content.service", () => {
+    it("embute JSON como bloco markdown quando client não suporta", () => {
+        const text = [{ type: "text", text: "# Teste" }];
+        const data = { fase: 1, nome: "Produto" };
+        const result = withStructuredContent(text, data, "Dados");
+        // Sem suporte nativo, deve ter 2 blocos (original + JSON)
+        expect(result.content.length).toBe(2);
+        expect(result.content[1].text).toContain("```json");
+        expect(result.content[1].text).toContain('"fase": 1');
+        expect(result.structuredContent).toBeUndefined();
+    });
+    it("extractStructuredData retorna null sem structuredContent", () => {
+        expect(extractStructuredData({})).toBeNull();
+    });
+    it("extractStructuredData retorna dados quando presente", () => {
+        const data = { x: 1 };
+        const result = extractStructuredData({
+            structuredContent: { type: "json", json: data },
+        });
+        expect(result).toEqual(data);
+    });
+});
+// === annotations-fallback.service ===
+import { annotateContent, forAssistantOnly, forUserOnly, } from "../services/annotations-fallback.service.js";
+describe("annotations-fallback.service", () => {
+    it("forAssistantOnly adiciona annotation ou prefixo inline", () => {
+        const block = { type: "text", text: "Instruções secretas" };
+        const result = forAssistantOnly(block);
+        // Deve ter o texto original (possivelmente com prefixo)
+        expect(result.text).toContain("Instruções secretas");
+        expect(result.type).toBe("text");
+    });
+    it("forUserOnly adiciona annotation ou prefixo inline", () => {
+        const block = { type: "text", text: "Para o usuário" };
+        const result = forUserOnly(block);
+        expect(result.text).toContain("Para o usuário");
+        expect(result.type).toBe("text");
+    });
+    it("annotateContent processa bloco individual", () => {
+        const block = { type: "text", text: "Bloco 1" };
+        const result = annotateContent(block, { audience: ["user"], priority: 0.5 });
+        expect(result.type).toBe("text");
+        expect(result.text).toContain("Bloco 1");
+    });
+});
+// === response-formatter ===
+import { formatResponse, formatError, embedAllMetadata, } from "../utils/response-formatter.js";
+describe("response-formatter", () => {
+    it("formatResponse gera bloco com título e resumo", () => {
+        const blocks = formatResponse({
+            titulo: "Teste",
+            resumo: "Resumo do teste",
+        });
+        expect(blocks.length).toBeGreaterThanOrEqual(1);
+        expect(blocks[0].text).toContain("# Teste");
+        expect(blocks[0].text).toContain("Resumo do teste");
+    });
+    it("formatResponse inclui dados como tabela", () => {
+        const blocks = formatResponse({
+            titulo: "T",
+            resumo: "R",
+            dados: { Projeto: "Meu App", Fase: 3 },
+        });
+        const text = blocks.map(b => b.text).join("\n");
+        expect(text).toContain("Meu App");
+        expect(text).toContain("3");
+    });
+    it("formatResponse inclui alertas", () => {
+        const blocks = formatResponse({
+            titulo: "T",
+            resumo: "R",
+            alertas: ["Atenção!"],
+        });
+        const text = blocks.map(b => b.text).join("\n");
+        expect(text).toContain("⚠️ Atenção!");
+    });
+    it("formatResponse inclui próximo passo", () => {
+        const blocks = formatResponse({
+            titulo: "T",
+            resumo: "R",
+            proximo_passo: {
+                tool: "avancar",
+                descricao: "Avançar fase",
+            },
+        });
+        const text = blocks.map(b => b.text).join("\n");
+        expect(text).toContain("avancar");
+        expect(text).toContain("Avançar fase");
+    });
+    it("formatError gera bloco de erro", () => {
+        const blocks = formatError("status", "Algo deu errado", "Tente novamente");
+        expect(blocks.length).toBe(1);
+        expect(blocks[0].text).toContain("❌ Erro");
+        expect(blocks[0].text).toContain("status");
+        expect(blocks[0].text).toContain("Algo deu errado");
+        expect(blocks[0].text).toContain("Tente novamente");
+    });
+    it("embedAllMetadata embute specialist, progress e next_action", () => {
+        const base = [{ type: "text", text: "Base" }];
+        const result = embedAllMetadata(base, {
+            specialist: {
+                name: "Arquiteto",
+                tone: "Técnico",
+                expertise: ["Backend"],
+                instructions: "Foque em APIs",
+            },
+            progress: {
+                current_phase: "Arquitetura",
+                total_phases: 5,
+                completed_phases: 2,
+                percentage: 40,
+            },
+            next_action: {
+                tool: "avancar",
+                description: "Próxima fase",
+                args_template: {},
+                requires_user_input: false,
+            },
+        });
+        const text = result.map(b => b.text).join("\n");
+        expect(text).toContain("Arquiteto");
+        expect(text).toContain("40%");
+        expect(text).toContain("avancar");
+    });
+});
+// === client-capabilities.service ===
+import { captureClientCapabilities, getClientCapabilities, clientSupports, } from "../services/client-capabilities.service.js";
+describe("client-capabilities.service", () => {
+    it("captura e retorna capabilities", () => {
+        captureClientCapabilities({
+            capabilities: { sampling: {} },
+            clientInfo: { name: "windsurf", version: "1.0" },
+            protocolVersion: "2025-03-26",
+        });
+        const caps = getClientCapabilities();
+        expect(caps).toBeDefined();
+        expect(caps.clientName).toBe("windsurf");
+        expect(caps.hasSampling).toBe(true);
+        expect(caps.hasElicitation).toBe(false);
+    });
+    it("clientSupports retorna boolean", () => {
+        const result = clientSupports("hasSampling");
+        expect(typeof result).toBe("boolean");
+    });
+});
+// === elicitation-fallback.service ===
+import { buildElicitation } from "../services/elicitation-fallback.service.js";
+describe("elicitation-fallback.service", () => {
+    it("gera markdown fallback para questionário", () => {
+        const result = buildElicitation({
+            title: "Discovery",
+            description: "Coleta de dados",
+            fields: [
+                { name: "nome", label: "Nome do projeto", type: "text", required: true },
+                { name: "tipo", label: "Tipo", type: "select", options: ["web", "mobile"], required: false },
+            ],
+        });
+        expect(result.markdownFallback).toContain("Discovery");
+        expect(result.markdownFallback).toContain("Nome do projeto");
+        expect(typeof result.useNative).toBe("boolean");
+    });
+});
+// === sampling-fallback.service ===
+import { buildCodeAnalysisFallback } from "../services/sampling-fallback.service.js";
+describe("sampling-fallback.service", () => {
+    it("gera checklist de análise para código", () => {
+        const result = buildCodeAnalysisFallback("function hello() { return 'world'; }", "completo");
+        expect(typeof result).toBe("string");
+        expect(result.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=v52-integration.test.js.map

package/dist/tests/v52-integration.test.js.map

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

package/dist/tools/consolidated/analisar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analisar.d.ts","sourceRoot":"","sources":["../../../src/tools/consolidated/analisar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAOvD,UAAU,YAAY;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,CAAC;IAC/E,QAAQ,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;CACrD;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAkDtE;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B1B,CAAC"}
+{"version":3,"file":"analisar.d.ts","sourceRoot":"","sources":["../../../src/tools/consolidated/analisar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AASvD,UAAU,YAAY;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,CAAC;IAC/E,QAAQ,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;CACrD;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAgEtE;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B1B,CAAC"}

package/dist/tools/consolidated/analisar.js

@@ -11,11 +11,13 @@
  *
  * Aceita parâmetro 'tipo' para determinar análise.
  */
+import { formatError } from "../../utils/response-formatter.js";
 import { analisarSeguranca } from "../analise/seguranca.js";
 import { analisarQualidade } from "../analise/qualidade.js";
 import { analisarPerformance } from "../analise/performance.js";
 import { gerarRelatorio } from "../analise/relatorio.js";
 import { validateDependencies } from "../fase1/validation.tools.js";
+import { buildCodeAnalysisFallback } from "../../services/sampling-fallback.service.js";
 /**
  * Tool: analisar
  * Entry point unificado para análises de código.
@@ -23,10 +25,7 @@ import { validateDependencies } from "../fase1/validation.tools.js";
 export async function analisar(args) {
     if (!args.diretorio) {
         return {
-            content: [{
-                    type: "text",
-                    text: "❌ **Erro**: Parâmetro `diretorio` é obrigatório.",
-                }],
+            content: formatError("analisar", "Parâmetro `diretorio` é obrigatório."),
             isError: true,
         };
     }
@@ -58,11 +57,28 @@ export async function analisar(args) {
                 language: args.language,
             });
         case "completo":
-        default:
+        default: {
+            // v5.2: Se código fornecido sem sampling, gerar checklist de self-analysis
+            if (args.code && args.code.trim().length > 0) {
+                const fallbackContent = buildCodeAnalysisFallback(args.code, "completo");
+                const subResult = await gerarRelatorio({
+                    diretorio: args.diretorio,
+                    estado_json: args.estado_json || "",
+                });
+                // Append sampling fallback checklist to the result
+                return {
+                    ...subResult,
+                    content: [
+                        ...subResult.content,
+                        { type: "text", text: fallbackContent },
+                    ],
+                };
+            }
             return gerarRelatorio({
                 diretorio: args.diretorio,
                 estado_json: args.estado_json || "",
             });
+        }
     }
 }
 export const analisarSchema = {

package/dist/tools/consolidated/analisar.js.map

@@ -1 +1 @@
-{"version":3,"file":"analisar.js","sourceRoot":"","sources":["../../../src/tools/consolidated/analisar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAoB,MAAM,8BAA8B,CAAC;AAUtF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAkB;IAC7C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kDAAkD;iBAC3D,CAAC;YACF,OAAO,EAAE,IAAI;SAChB,CAAC;IACN,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC;IAErC,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,WAAW;YACZ,OAAO,iBAAiB,CAAC;gBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;aACjB,CAAC,CAAC;QAEd,KAAK,WAAW;YACZ,OAAO,iBAAiB,CAAC;gBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;aACjB,CAAC,CAAC;QAEd,KAAK,aAAa;YACd,OAAO,mBAAmB,CAAC;gBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;aACjB,CAAC,CAAC;QAEd,KAAK,cAAc;YACf,OAAO,oBAAoB,CAAC;gBACxB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;gBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACnB,CAAC,CAAC;QAEd,KAAK,UAAU,CAAC;QAChB;YACI,OAAO,cAAc,CAAC;gBAClB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;aAC/B,CAAC,CAAC;IAClB,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,SAAS,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+BAA+B;SAC/C;QACD,WAAW,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wDAAwD;SACxE;QACD,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sBAAsB;SACtC;QACD,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,CAAC;YAC3E,WAAW,EAAE,oCAAoC;SACpD;QACD,QAAQ,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC;YAC5C,WAAW,EAAE,8CAA8C;SAC9D;KACJ;IACD,QAAQ,EAAE,CAAC,WAAW,CAAC;CAC1B,CAAC"}
+{"version":3,"file":"analisar.js","sourceRoot":"","sources":["../../../src/tools/consolidated/analisar.ts"],"names":[],"mappings":"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"}

package/dist/tools/consolidated/avancar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avancar.d.ts","sourceRoot":"","sources":["../../../src/tools/consolidated/avancar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,sBAAsB,CAAC;AAOtE,UAAU,WAAW;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA+EpE;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCzB,CAAC"}
+{"version":3,"file":"avancar.d.ts","sourceRoot":"","sources":["../../../src/tools/consolidated/avancar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,sBAAsB,CAAC;AAQtE,UAAU,WAAW;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAyEpE;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCzB,CAAC"}

package/dist/tools/consolidated/avancar.js

@@ -8,6 +8,7 @@
  *
  * Detecta contexto automaticamente e delega para o handler correto.
  */
+import { formatResponse, formatError } from "../../utils/response-formatter.js";
 import { parsearEstado } from "../../state/storage.js";
 import { isInOnboarding } from "../../services/flow-engine.js";
 import { proximo } from "../proximo.js";
@@ -21,10 +22,7 @@ import { brainstorm } from "../brainstorm.js";
 export async function avancar(args) {
     if (!args.diretorio) {
         return {
-            content: [{
-                    type: "text",
-                    text: "❌ **Erro**: Parâmetro `diretorio` é obrigatório.",
-                }],
+            content: formatError("avancar", "Parâmetro `diretorio` é obrigatório."),
             isError: true,
         };
     }
@@ -66,20 +64,17 @@ export async function avancar(args) {
     // Desenvolvimento: delegar para proximo
     if (!args.entregavel) {
         return {
-            content: [{
-                    type: "text",
-                    text: `# ⚠️ Entregável Necessário
-
-Para avançar na fase de desenvolvimento, forneça o entregável:
-
-\`\`\`
-avancar(
-    diretorio: "${args.diretorio}",
-    entregavel: "conteúdo do entregável...",
-    estado_json: "..."
-)
-\`\`\``,
-                }],
+            content: formatResponse({
+                titulo: "⚠️ Entregável Necessário",
+                resumo: "Para avançar na fase de desenvolvimento, forneça o entregável.",
+                proximo_passo: {
+                    tool: "avancar",
+                    descricao: "Avançar fase com entregável",
+                    args: `diretorio: "${args.diretorio}", entregavel: "conteúdo do entregável..."`,
+                    requer_input_usuario: true,
+                    prompt_usuario: "Forneça o conteúdo do entregável da fase atual.",
+                },
+            }),
         };
     }
     return proximo({

package/dist/tools/consolidated/avancar.js.map

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

package/dist/tools/consolidated/checkpoint-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/consolidated/checkpoint-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAQvD,UAAU,cAAc;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,kBAAkB,GAAG,QAAQ,CAAC;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA8D1E;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmC5B,CAAC"}
+{"version":3,"file":"checkpoint-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/consolidated/checkpoint-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AASvD,UAAU,cAAc;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,kBAAkB,GAAG,QAAQ,CAAC;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAqD1E;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmC5B,CAAC"}

package/dist/tools/consolidated/checkpoint-tool.js

@@ -9,6 +9,7 @@
  *
  * Aceita parâmetro 'acao' para determinar a operação.
  */
+import { formatError } from "../../utils/response-formatter.js";
 import { createCheckpoint, rollbackTotal, rollbackPartial, listCheckpoints, } from "../fase1/checkpoint.tools.js";
 /**
  * Tool: checkpoint
@@ -17,10 +18,7 @@ import { createCheckpoint, rollbackTotal, rollbackPartial, listCheckpoints, } fr
 export async function checkpoint(args) {
     if (!args.diretorio) {
         return {
-            content: [{
-                    type: "text",
-                    text: "❌ **Erro**: Parâmetro `diretorio` é obrigatório.",
-                }],
+            content: formatError("checkpoint", "Parâmetro `diretorio` é obrigatório."),
             isError: true,
         };
     }
@@ -36,10 +34,7 @@ export async function checkpoint(args) {
         case "rollback":
             if (!args.checkpointId) {
                 return {
-                    content: [{
-                            type: "text",
-                            text: "❌ **Erro**: `checkpointId` é obrigatório para rollback.",
-                        }],
+                    content: formatError("checkpoint", "`checkpointId` é obrigatório para rollback."),
                     isError: true,
                 };
             }
@@ -51,10 +46,7 @@ export async function checkpoint(args) {
         case "rollback_parcial":
             if (!args.checkpointId || !args.modules?.length) {
                 return {
-                    content: [{
-                            type: "text",
-                            text: "❌ **Erro**: `checkpointId` e `modules` são obrigatórios para rollback parcial.",
-                        }],
+                    content: formatError("checkpoint", "`checkpointId` e `modules` são obrigatórios para rollback parcial."),
                     isError: true,
                 };
             }

package/dist/tools/consolidated/checkpoint-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint-tool.js","sourceRoot":"","sources":["../../../src/tools/consolidated/checkpoint-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACH,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,eAAe,GAClB,MAAM,8BAA8B,CAAC;AAYtC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAoB;IACjD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kDAAkD;iBAC3D,CAAC;YACF,OAAO,EAAE,IAAI;SAChB,CAAC;IACN,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC;IAEnC,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,OAAO;YACR,OAAO,gBAAgB,CAAC;gBACpB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;gBACnC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,mBAAmB;gBAC1C,IAAI,EAAE,IAAI,CAAC,IAAI;aACX,CAAC,CAAC;QAEd,KAAK,UAAU;YACX,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACrB,OAAO;oBACH,OAAO,EAAE,CAAC;4BACN,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,yDAAyD;yBAClE,CAAC;oBACF,OAAO,EAAE,IAAI;iBAChB,CAAC;YACN,CAAC;YACD,OAAO,aAAa,CAAC;gBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;gBACnC,YAAY,EAAE,IAAI,CAAC,YAAY;aAC3B,CAAC,CAAC;QAEd,KAAK,kBAAkB;YACnB,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC9C,OAAO;oBACH,OAAO,EAAE,CAAC;4BACN,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,gFAAgF;yBACzF,CAAC;oBACF,OAAO,EAAE,IAAI;iBAChB,CAAC;YACN,CAAC;YACD,OAAO,eAAe,CAAC;gBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;gBACnC,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;aACjB,CAAC,CAAC;QAEd,KAAK,QAAQ,CAAC;QACd;YACI,OAAO,eAAe,CAAC;gBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;aAC/B,CAAC,CAAC;IAClB,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,SAAS,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+BAA+B;SAC/C;QACD,WAAW,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wDAAwD;SACxE;QACD,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,QAAQ,CAAC;YACzD,WAAW,EAAE,kCAAkC;SAClD;QACD,MAAM,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wCAAwC;SACxD;QACD,YAAY,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,kCAAkC;SAClD;QACD,OAAO,EAAE;YACL,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EAAE,+BAA+B;SAC/C;QACD,IAAI,EAAE;YACF,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uCAAuC;SACvD;KACJ;IACD,QAAQ,EAAE,CAAC,WAAW,CAAC;CAC1B,CAAC"}
+{"version":3,"file":"checkpoint-tool.js","sourceRoot":"","sources":["../../../src/tools/consolidated/checkpoint-tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/consolidated/executar.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Tool Consolidada: executar
+ *
+ * Unifica:
+ * - avancar (avançar fase / onboarding)
+ * - salvar (salvar conteúdo sem avançar)
+ * - checkpoint (criar, rollback, listar)
+ *
+ * Aceita parâmetro 'acao' para determinar a operação.
+ * Padrão: "avancar" (comportamento mais comum).
+ *
+ * @since v5.2.0 — Task C.1 do Roadmap v5.2
+ */
+import type { ToolResult } from "../../types/index.js";
+type ExecutarAcao = "avancar" | "salvar" | "checkpoint";
+interface ExecutarArgs {
+    diretorio: string;
+    estado_json?: string;
+    /** Ação principal: avancar (padrão), salvar, checkpoint */
+    acao?: ExecutarAcao;
+    entregavel?: string;
+    respostas?: Record<string, unknown>;
+    resumo_json?: string;
+    nome_arquivo?: string;
+    auto_flow?: boolean;
+    /** Sub-ação para avancar (ex: 'proximo_bloco') ou checkpoint (ex: 'criar') */
+    sub_acao?: string;
+    conteudo?: string;
+    tipo?: "rascunho" | "anexo" | "entregavel";
+    /** Ação de checkpoint: criar, rollback, rollback_parcial, listar */
+    checkpoint_acao?: "criar" | "rollback" | "rollback_parcial" | "listar";
+    reason?: string;
+    checkpointId?: string;
+    modules?: string[];
+    auto?: boolean;
+}
+/**
+ * Tool: executar
+ * Entry point unificado para ações de execução no projeto.
+ */
+export declare function executar(args: ExecutarArgs): Promise<ToolResult>;
+export declare const executarSchema: {
+    type: string;
+    properties: {
+        diretorio: {
+            type: string;
+            description: string;
+        };
+        estado_json: {
+            type: string;
+            description: string;
+        };
+        acao: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        entregavel: {
+            type: string;
+            description: string;
+        };
+        respostas: {
+            type: string;
+            description: string;
+        };
+        resumo_json: {
+            type: string;
+            description: string;
+        };
+        nome_arquivo: {
+            type: string;
+            description: string;
+        };
+        auto_flow: {
+            type: string;
+            description: string;
+        };
+        sub_acao: {
+            type: string;
+            description: string;
+        };
+        conteudo: {
+            type: string;
+            description: string;
+        };
+        tipo: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        checkpoint_acao: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        reason: {
+            type: string;
+            description: string;
+        };
+        checkpointId: {
+            type: string;
+            description: string;
+        };
+        modules: {
+            type: string;
+            items: {
+                type: string;
+            };
+            description: string;
+        };
+        auto: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+};
+export {};
+//# sourceMappingURL=executar.d.ts.map

package/dist/tools/consolidated/executar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executar.d.ts","sourceRoot":"","sources":["../../../src/tools/consolidated/executar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMvD,KAAK,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;AAExD,UAAU,YAAY;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,YAAY,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;IAG3C,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,kBAAkB,GAAG,QAAQ,CAAC;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CA+DtE;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyE1B,CAAC"}