@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/tools/discovery.js

@@ -0,0 +1,344 @@
+import { parsearEstado, serializarEstado } from "../state/storage.js";
+import { setCurrentDirectory } from "../state/context.js";
+import { resolveProjectPath } from "../utils/files.js";
+/**
+ * Tool: discovery
+ * Coleta informações iniciais agrupadas para reduzir prompts posteriores
+ */
+export async function discovery(args) {
+    if (!args.estado_json) {
+        return {
+            content: [{
+                    type: "text",
+                    text: "❌ **Erro**: Parâmetro `estado_json` é obrigatório.",
+                }],
+            isError: true,
+        };
+    }
+    if (!args.diretorio) {
+        return {
+            content: [{
+                    type: "text",
+                    text: "❌ **Erro**: Parâmetro `diretorio` é obrigatório.",
+                }],
+            isError: true,
+        };
+    }
+    const estado = parsearEstado(args.estado_json);
+    if (!estado) {
+        return {
+            content: [{
+                    type: "text",
+                    text: "❌ **Erro**: Não foi possível parsear o estado JSON.",
+                }],
+            isError: true,
+        };
+    }
+    const diretorio = resolveProjectPath(args.diretorio);
+    setCurrentDirectory(diretorio);
+    // Se não tem respostas, retorna questionário
+    if (!args.respostas) {
+        const modo = estado.config?.mode || 'balanced';
+        const questionario = gerarQuestionario(modo);
+        return {
+            content: [{
+                    type: "text",
+                    text: questionario,
+                }],
+        };
+    }
+    // Salvar respostas no estado
+    const estadoAtualizado = {
+        ...estado,
+        discovery: args.respostas,
+    };
+    const estadoFile = serializarEstado(estadoAtualizado);
+    const resposta = `# ✅ Discovery Concluído
+
+Informações coletadas e salvas com sucesso!
+
+## Resumo Capturado
+
+**Projeto:** ${args.respostas.nome_projeto || estado.nome}
+**Problema:** ${args.respostas.problema || 'A definir'}
+**Plataformas:** ${args.respostas.plataformas?.join(', ') || 'A definir'}
+**Stack:** ${args.respostas.stack_preferida || 'A sugerir'}
+
+---
+
+## 📁 Próximos Passos
+
+Todas as informações foram salvas em \`.maestro/estado.json\` no campo \`discovery\`.
+
+Os especialistas agora têm acesso a este contexto e farão apenas perguntas de refinamento específicas.
+
+**Pronto para iniciar a Fase 1 (Produto)!**
+
+Use: \`status(estado_json: "...", diretorio: "${diretorio}")\` para ver o progresso.
+
+---
+
+## ⚡ AÇÃO OBRIGATÓRIA - Atualizar Estado
+
+**Caminho:** \`${diretorio}/.maestro/estado.json\`
+
+\`\`\`json
+${estadoFile.content}
+\`\`\`
+`;
+    return {
+        content: [{ type: "text", text: resposta }],
+        files: [{
+                path: `${diretorio}/${estadoFile.path}`,
+                content: estadoFile.content
+            }],
+        estado_atualizado: estadoFile.content,
+    };
+}
+/**
+ * Gera questionário adaptado ao modo selecionado
+ */
+function gerarQuestionario(modo) {
+    const base = `# 🎯 Discovery Inicial - Maestro
+
+Para otimizar o desenvolvimento e reduzir a quantidade de perguntas durante o projeto, vou coletar informações iniciais agrupadas.
+
+**Modo selecionado:** ${modo.toUpperCase()}
+
+---
+
+## 1. Sobre o Projeto
+
+**Nome do projeto:** ___
+
+**Problema que resolve:**
+(Descreva o problema principal que o projeto resolve)
+___
+
+**Público-alvo principal:**
+(Quem são os usuários? Personas principais)
+___
+
+---
+
+## 2. Escopo e MVP
+
+**3-5 funcionalidades principais do MVP:**
+1. ___
+2. ___
+3. ___
+
+**O que NÃO faz parte do MVP:**
+(Liste funcionalidades que ficam para versões futuras)
+___
+
+**Cronograma desejado:**
+(Ex: 3 meses, 6 meses, 1 ano)
+___
+
+---
+
+## 3. Técnico
+
+**Stack preferida:**
+(Ex: React + Node.js, Laravel + Vue, ou "sugerir baseado em requisitos")
+___
+
+**Plataformas alvo:**
+- [ ] Web
+- [ ] Mobile (iOS/Android)
+- [ ] Desktop
+
+**Integrações externas necessárias:**
+(Ex: APIs de pagamento, autenticação social, serviços de email)
+___
+
+---
+
+## 4. Time e Infraestrutura
+
+**Tamanho do time:**
+(Ex: solo, 2-5 pessoas, 6-10 pessoas, 10+)
+___
+
+**Experiência predominante do time:**
+(Ex: júnior, pleno, sênior, misto)
+___
+
+**Infraestrutura disponível:**
+- [ ] Cloud (AWS, GCP, Azure)
+- [ ] On-premise
+- [ ] Híbrido
+___
+
+---
+
+## 5. Requisitos Críticos
+
+**Performance esperada:**
+(Ex: < 2s de resposta, suporta 1000 usuários simultâneos)
+___
+
+**Segurança/Compliance:**
+- [ ] LGPD
+- [ ] PCI-DSS
+- [ ] HIPAA
+- [ ] Outro: ___
+
+**Escalabilidade:**
+(Ex: crescimento esperado, picos de uso)
+___
+
+`;
+    // Perguntas adicionais para modo balanced e quality
+    if (modo === 'balanced' || modo === 'quality') {
+        return base + `
+---
+
+## 6. Dados e Analytics
+
+**Tipo de dados predominante:**
+- [ ] Relacional (SQL)
+- [ ] NoSQL (MongoDB, etc)
+- [ ] Híbrido
+
+**Volume estimado de dados:**
+(Ex: milhares, milhões, bilhões de registros)
+___
+
+**Necessita analytics/BI?**
+- [ ] Sim
+- [ ] Não
+___
+
+---
+
+## 7. UX e Design
+
+**Referências visuais ou estilo desejado:**
+(Links, descrição, ou "sugerir baseado no público")
+___
+
+**Acessibilidade requerida:**
+- [ ] Sim (WCAG 2.1 AA)
+- [ ] Não
+___
+
+` + (modo === 'quality' ? `
+---
+
+## 8. Orçamento e Restrições
+
+**Budget estimado:**
+(Para infraestrutura, ferramentas, etc)
+___
+
+**Restrições técnicas:**
+(Ex: deve usar tecnologia X, não pode usar Y)
+___
+
+**Restrições de negócio:**
+(Ex: prazo fixo, regulamentações específicas)
+___
+
+` : '') + `
+---
+
+## 📝 Como Responder
+
+Copie este questionário, preencha as respostas e envie de volta.
+
+Ou use a tool:
+\`\`\`
+discovery(
+    estado_json: "...",
+    diretorio: "...",
+    respostas: {
+        nome_projeto: "...",
+        problema: "...",
+        // ... demais campos
+    }
+)
+\`\`\`
+
+> 💡 **Dica:** Quanto mais detalhes você fornecer agora, menos perguntas serão feitas depois!
+`;
+    }
+    // Modo economy: apenas essencial
+    return base + `
+---
+
+## 📝 Como Responder
+
+Copie este questionário, preencha as respostas essenciais e envie de volta.
+
+Ou use a tool:
+\`\`\`
+discovery(
+    estado_json: "...",
+    diretorio: "...",
+    respostas: {
+        nome_projeto: "...",
+        problema: "...",
+        publico_alvo: "...",
+        funcionalidades_principais: ["...", "...", "..."],
+        plataformas: ["web"],
+        // ... demais campos essenciais
+    }
+)
+\`\`\`
+
+> ⚡ **Modo Economy:** Perguntas mínimas para início rápido!
+`;
+}
+export const discoverySchema = {
+    type: "object",
+    properties: {
+        estado_json: {
+            type: "string",
+            description: "Conteúdo do arquivo .maestro/estado.json",
+        },
+        diretorio: {
+            type: "string",
+            description: "Diretório absoluto do projeto",
+        },
+        respostas: {
+            type: "object",
+            description: "Respostas do questionário de discovery",
+            properties: {
+                nome_projeto: { type: "string" },
+                problema: { type: "string" },
+                publico_alvo: { type: "string" },
+                funcionalidades_principais: {
+                    type: "array",
+                    items: { type: "string" }
+                },
+                fora_escopo: {
+                    type: "array",
+                    items: { type: "string" }
+                },
+                cronograma: { type: "string" },
+                stack_preferida: { type: "string" },
+                plataformas: {
+                    type: "array",
+                    items: { type: "string" }
+                },
+                integracoes_externas: {
+                    type: "array",
+                    items: { type: "string" }
+                },
+                tamanho_time: { type: "string" },
+                experiencia_time: { type: "string" },
+                infraestrutura: { type: "string" },
+                performance_esperada: { type: "string" },
+                seguranca_compliance: {
+                    type: "array",
+                    items: { type: "string" }
+                },
+                escalabilidade: { type: "string" },
+            },
+        },
+    },
+    required: ["estado_json", "diretorio"],
+};
+//# sourceMappingURL=discovery.js.map

package/dist/tools/discovery.js.map

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

package/dist/tools/fase1/checkpoint.tools.d.ts

@@ -0,0 +1,150 @@
+export interface CreateCheckpointParams {
+    reason: string;
+    auto?: boolean;
+    estado_json: string;
+    diretorio: string;
+}
+export declare function createCheckpoint(params: CreateCheckpointParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const createCheckpointSchema: {
+    type: "object";
+    properties: {
+        reason: {
+            type: string;
+            description: string;
+        };
+        auto: {
+            type: string;
+            description: string;
+        };
+        estado_json: {
+            type: string;
+        };
+        diretorio: {
+            type: string;
+        };
+    };
+    required: string[];
+};
+export interface RollbackTotalParams {
+    checkpointId: string;
+    estado_json: string;
+    diretorio: string;
+}
+export declare function rollbackTotal(params: RollbackTotalParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+    files?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    files: {
+        path: string;
+        content: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare const rollbackTotalSchema: {
+    type: "object";
+    properties: {
+        checkpointId: {
+            type: string;
+            description: string;
+        };
+        estado_json: {
+            type: string;
+        };
+        diretorio: {
+            type: string;
+        };
+    };
+    required: string[];
+};
+export interface RollbackPartialParams {
+    checkpointId: string;
+    modules: string[];
+    estado_json: string;
+    diretorio: string;
+}
+export declare function rollbackPartial(params: RollbackPartialParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare const rollbackPartialSchema: {
+    type: "object";
+    properties: {
+        checkpointId: {
+            type: string;
+            description: string;
+        };
+        modules: {
+            type: string;
+            items: {
+                type: string;
+            };
+            description: string;
+        };
+        estado_json: {
+            type: string;
+        };
+        diretorio: {
+            type: string;
+        };
+    };
+    required: string[];
+};
+export interface ListCheckpointsParams {
+    estado_json: string;
+    diretorio: string;
+}
+export declare function listCheckpoints(params: ListCheckpointsParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const listCheckpointsSchema: {
+    type: "object";
+    properties: {
+        estado_json: {
+            type: string;
+        };
+        diretorio: {
+            type: string;
+        };
+    };
+    required: string[];
+};
+//# sourceMappingURL=checkpoint.tools.d.ts.map

package/dist/tools/fase1/checkpoint.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.tools.d.ts","sourceRoot":"","sources":["../../../src/tools/fase1/checkpoint.tools.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB;;;;;;;;;;;;GA4BpE;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;CASlC,CAAC;AAIF,MAAM,WAAW,mBAAmB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB;;;;;;;;;;;;;;;;;GAqC9D;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;CAQ/B,CAAC;AAIF,MAAM,WAAW,qBAAqB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,qBAAqB;;;;;;;;;;;;GAiClE;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;CAajC,CAAC;AAIF,MAAM,WAAW,qBAAqB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,qBAAqB;;;;;;;;;;;;GAgClE;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;CAOjC,CAAC"}

package/dist/tools/fase1/checkpoint.tools.js

@@ -0,0 +1,165 @@
+import { CheckpointManager } from '../../core/checkpoint/CheckpointManager.js';
+import { RollbackEngine } from '../../core/checkpoint/RollbackEngine.js';
+export async function createCheckpoint(params) {
+    try {
+        const estado = JSON.parse(params.estado_json);
+        const cpManager = new CheckpointManager(params.diretorio);
+        const id = await cpManager.create(params.reason, params.auto || false, estado);
+        const checkpoint = await cpManager.get(id);
+        return {
+            content: [{
+                    type: "text",
+                    text: `✅ **Checkpoint Criado: ${id}**\n\nMotivo: ${params.reason}\nFase: ${estado.fase_atual}\nArquivos: ${checkpoint?.metadata.filesCount || 0}\nTamanho: ${Math.round((checkpoint?.metadata.totalSize || 0) / 1024)} KB\n\nO checkpoint foi salvo em \`.maestro/checkpoints/${id}.json\``
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ Erro ao criar checkpoint: ${String(error)}`
+                }],
+            isError: true
+        };
+    }
+}
+export const createCheckpointSchema = {
+    type: "object",
+    properties: {
+        reason: { type: "string", description: "Motivo do checkpoint" },
+        auto: { type: "boolean", description: "Checkpoint automático (padrão: false)" },
+        estado_json: { type: "string" },
+        diretorio: { type: "string" },
+    },
+    required: ["reason", "estado_json", "diretorio"],
+};
+export async function rollbackTotal(params) {
+    try {
+        const rollbackEngine = new RollbackEngine(params.diretorio);
+        const result = await rollbackEngine.rollbackTotal(params.checkpointId);
+        if (!result.success) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Rollback Falhou**\n\nErros:\n${result.errors.map(e => `- ${e}`).join('\n')}`
+                    }],
+                isError: true
+            };
+        }
+        // Retornar novo estado
+        return {
+            content: [{
+                    type: "text",
+                    text: `✅ **Rollback Total Concluído**\n\nCheckpoint: ${params.checkpointId}\nArquivos restaurados: ${result.filesRestored}\nFase restaurada: ${result.checkpoint.fase}`
+                }],
+            files: [
+                {
+                    path: '.maestro/estado.json',
+                    content: JSON.stringify(result.checkpoint.snapshot.estado, null, 2)
+                }
+            ]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ Erro no rollback: ${String(error)}`
+                }],
+            isError: true
+        };
+    }
+}
+export const rollbackTotalSchema = {
+    type: "object",
+    properties: {
+        checkpointId: { type: "string", description: "ID do checkpoint" },
+        estado_json: { type: "string" },
+        diretorio: { type: "string" },
+    },
+    required: ["checkpointId", "estado_json", "diretorio"],
+};
+export async function rollbackPartial(params) {
+    try {
+        const rollbackEngine = new RollbackEngine(params.diretorio);
+        const result = await rollbackEngine.rollbackPartial(params.checkpointId, params.modules);
+        if (!result.success) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Rollback Parcial Falhou**\n\nErros:\n${result.errors.map(e => `- ${e}`).join('\n')}`
+                    }],
+                isError: true
+            };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: `✅ **Rollback Parcial Concluído**\n\nCheckpoint: ${params.checkpointId}\nMódulos: ${params.modules.join(', ')}\nArquivos restaurados: ${result.filesRestored}`
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ Erro no rollback parcial: ${String(error)}`
+                }],
+            isError: true
+        };
+    }
+}
+export const rollbackPartialSchema = {
+    type: "object",
+    properties: {
+        checkpointId: { type: "string", description: "ID do checkpoint" },
+        modules: {
+            type: "array",
+            items: { type: "string" },
+            description: "Módulos para restaurar"
+        },
+        estado_json: { type: "string" },
+        diretorio: { type: "string" },
+    },
+    required: ["checkpointId", "modules", "estado_json", "diretorio"],
+};
+export async function listCheckpoints(params) {
+    try {
+        const cpManager = new CheckpointManager(params.diretorio);
+        const checkpoints = await cpManager.list();
+        let text = `📋 **Checkpoints Disponíveis**\n\n`;
+        text += `Total: ${checkpoints.length}\n\n`;
+        checkpoints.slice(0, 10).forEach(cp => {
+            const date = new Date(cp.timestamp).toLocaleString('pt-BR');
+            text += `**${cp.id}**\n`;
+            text += `Data: ${date}\n`;
+            text += `Motivo: ${cp.reason}\n`;
+            text += `Fase: ${cp.fase} | Arquivos: ${cp.metadata.filesCount}\n`;
+            text += `Auto: ${cp.auto ? 'Sim' : 'Não'}\n\n`;
+        });
+        return {
+            content: [{
+                    type: "text",
+                    text
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ Erro ao listar checkpoints: ${String(error)}`
+                }],
+            isError: true
+        };
+    }
+}
+export const listCheckpointsSchema = {
+    type: "object",
+    properties: {
+        estado_json: { type: "string" },
+        diretorio: { type: "string" },
+    },
+    required: ["estado_json", "diretorio"],
+};
+//# sourceMappingURL=checkpoint.tools.js.map

package/dist/tools/fase1/checkpoint.tools.js.map

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