@maestro-ai/mcp-server 1.1.0 → 2.0.0

package/dist/adapters/skill-adapter.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Adaptador de skills para diferentes IDEs
+ * Mantém estrutura master e gera versões otimizadas
+ * Versão portada para MCP (Native Node.js FS)
+ */
+export declare class SkillAdapter {
+    private readonly IDE_CONFIGS;
+    /**
+     * Verifica se arquivo/diretório existe
+     */
+    private exists;
+    /**
+     * Copia e adapta skills para a IDE específica
+     */
+    adaptSkills(skillsSource: string, targetDir: string, ide: 'windsurf' | 'cursor' | 'antigravity', force?: boolean): Promise<void>;
+    /**
+     * Lista todos os diretórios de skills
+     */
+    private getSkillDirectories;
+    /**
+     * Adaptador para Windsurf - cópia direta (100% compatível)
+     */
+    private adaptForWindsurf;
+    /**
+     * Adaptador para Cursor - simplificação com headers explícitos
+     */
+    private adaptForCursor;
+    /**
+     * Adaptador para Antigravity - formato .agent
+     */
+    private adaptForAntigravity;
+    /**
+     * Parse metadata do SKILL.md
+     */
+    private parseSkillMetadata;
+    /**
+     * Extrai lista de arquivos da tabela de content map
+     */
+    private extractFilesFromTable;
+    /**
+     * Gera conteúdo otimizado para Cursor
+     */
+    private generateCursorContent;
+    /**
+     * Gera conteúdo otimizado para Antigravity
+     */
+    private generateAntigravityContent;
+    /**
+     * Obtém descrição do arquivo baseada no nome
+     */
+    private getFileDescription;
+    /**
+     * Determina categoria baseada no nome da skill
+     */
+    private getCategoryFromName;
+}
+//# sourceMappingURL=skill-adapter.d.ts.map

package/dist/adapters/skill-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/skill-adapter.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAa1B;IAEF;;OAEG;YACW,MAAM;IASpB;;OAEG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,QAAQ,GAAG,aAAa,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BpI;;OAEG;YACW,mBAAmB;IAmBjC;;OAEG;YACW,gBAAgB;IAM9B;;OAEG;YACW,cAAc;IA0B5B;;OAEG;YACW,mBAAmB;IA8BjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAkClC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAc9B"}

package/dist/adapters/skill-adapter.js

@@ -0,0 +1,272 @@
+import { cp, mkdir, readdir, readFile, writeFile, stat, access } from "fs/promises";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { constants } from "fs";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Adaptador de skills para diferentes IDEs
+ * Mantém estrutura master e gera versões otimizadas
+ * Versão portada para MCP (Native Node.js FS)
+ */
+export class SkillAdapter {
+    IDE_CONFIGS = {
+        windsurf: {
+            skillsDir: '.windsurf/skills',
+            adapter: this.adaptForWindsurf.bind(this)
+        },
+        cursor: {
+            skillsDir: '.cursor/skills',
+            adapter: this.adaptForCursor.bind(this)
+        },
+        antigravity: {
+            skillsDir: '.agent/skills',
+            adapter: this.adaptForAntigravity.bind(this)
+        }
+    };
+    /**
+     * Verifica se arquivo/diretório existe
+     */
+    async exists(path) {
+        try {
+            await access(path, constants.F_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Copia e adapta skills para a IDE específica
+     */
+    async adaptSkills(skillsSource, targetDir, ide, force = false) {
+        // @ts-ignore
+        const config = this.IDE_CONFIGS[ide];
+        if (!await this.exists(skillsSource)) {
+            console.error(`⚠️  Skills source not found: ${skillsSource}`);
+            return;
+        }
+        // Garantir diretório de destino
+        await mkdir(targetDir, { recursive: true });
+        // Listar todas as skills
+        const skillDirs = await this.getSkillDirectories(skillsSource);
+        // Logs removidos para evitar poluição do stdio do MCP, ou usar console.error
+        // console.error(`🔄 Adapting ${skillDirs.length} skills for ${ide}...`);
+        for (const skillDir of skillDirs) {
+            const skillName = skillDir.split(/[\\/]/).pop();
+            const skillPath = join(skillsSource, skillDir);
+            const destPath = join(targetDir, skillName);
+            await config.adapter(skillPath, destPath, skillName, force);
+        }
+        // console.error(`✅ Skills adapted for ${ide}`);
+    }
+    /**
+     * Lista todos os diretórios de skills
+     */
+    async getSkillDirectories(skillsSource) {
+        const items = await readdir(skillsSource);
+        const dirs = [];
+        for (const item of items) {
+            const itemPath = join(skillsSource, item);
+            try {
+                const stats = await stat(itemPath);
+                if (stats.isDirectory() && await this.exists(join(itemPath, 'SKILL.md'))) {
+                    dirs.push(item);
+                }
+            }
+            catch (e) {
+                // Ignore errors
+            }
+        }
+        return dirs;
+    }
+    /**
+     * Adaptador para Windsurf - cópia direta (100% compatível)
+     */
+    async adaptForWindsurf(skillPath, destPath, skillName, force) {
+        // Windsurf usa formato nativo - apenas copiar
+        // recursive: true é necessário para cp copiar diretórios
+        await cp(skillPath, destPath, { recursive: true, force: force });
+    }
+    /**
+     * Adaptador para Cursor - simplificação com headers explícitos
+     */
+    async adaptForCursor(skillPath, destPath, skillName, force) {
+        await mkdir(destPath, { recursive: true });
+        // Ler SKILL.md original
+        const skillMdPath = join(skillPath, 'SKILL.md');
+        if (!await this.exists(skillMdPath))
+            return;
+        const content = await readFile(skillMdPath, 'utf-8');
+        const parsed = this.parseSkillMetadata(content);
+        // Gerar versão Cursor-friendly
+        const cursorContent = this.generateCursorContent(parsed, skillPath);
+        await writeFile(join(destPath, 'SKILL.md'), cursorContent);
+        // Copiar outros arquivos .md
+        const items = await readdir(skillPath);
+        for (const item of items) {
+            if (item.endsWith('.md') && item !== 'SKILL.md') {
+                const srcFile = join(skillPath, item);
+                const destFile = join(destPath, item);
+                await cp(srcFile, destFile, { force: force });
+            }
+        }
+    }
+    /**
+     * Adaptador para Antigravity - formato .agent
+     */
+    async adaptForAntigravity(skillPath, destPath, skillName, force) {
+        await mkdir(destPath, { recursive: true });
+        // Ler SKILL.md original
+        const skillMdPath = join(skillPath, 'SKILL.md');
+        if (!await this.exists(skillMdPath))
+            return;
+        const content = await readFile(skillMdPath, 'utf-8');
+        const parsed = this.parseSkillMetadata(content);
+        // Gerar versão Antigravity-friendly
+        const antigravityContent = this.generateAntigravityContent(parsed, skillPath);
+        // Antigravity espera skill.md (minúsculo)
+        await writeFile(join(destPath, 'skill.md'), antigravityContent);
+        // Copiar conteúdo para subdiretório content/
+        const contentDir = join(destPath, 'content');
+        await mkdir(contentDir, { recursive: true });
+        const items = await readdir(skillPath);
+        for (const item of items) {
+            if (item.endsWith('.md') && item !== 'SKILL.md') {
+                const srcFile = join(skillPath, item);
+                const destFile = join(contentDir, item);
+                await cp(srcFile, destFile, { force: force });
+            }
+        }
+    }
+    /**
+     * Parse metadata do SKILL.md
+     */
+    parseSkillMetadata(content) {
+        const yamlMatch = content.match(/^---\n(.*?)\n---/s);
+        const metadata = yamlMatch ? yamlMatch[1] : '';
+        const nameMatch = metadata.match(/name:\s*(.+)/);
+        const descMatch = metadata.match(/description:\s*(.+)/);
+        // Extrair content map
+        const contentMapMatch = content.match(/\| File.*?\n\|.*?\n([\s\S]*?)\n---/);
+        const files = contentMapMatch ? this.extractFilesFromTable(contentMapMatch[1]) : [];
+        return {
+            name: nameMatch ? nameMatch[1].trim() : 'unknown',
+            description: descMatch ? descMatch[1].trim() : '',
+            files,
+            metadata: metadata
+        };
+    }
+    /**
+     * Extrai lista de arquivos da tabela de content map
+     */
+    extractFilesFromTable(tableContent) {
+        const files = [];
+        const lines = tableContent.split('\n');
+        for (const line of lines) {
+            const match = line.match(/\|\s*`([^`]+)`\s*\|/);
+            if (match) {
+                files.push(match[1]);
+            }
+        }
+        return files;
+    }
+    /**
+     * Gera conteúdo otimizado para Cursor
+     */
+    generateCursorContent(skill, skillPath) {
+        return `# ${skill.name}
+
+## Description
+${skill.description}
+
+## Quick Access
+${skill.files.map((file) => {
+            // const fileName = file.replace(/\.md$/, '');
+            const description = this.getFileDescription(file);
+            const fileName = file.replace(/\.md$/, '');
+            return `- **${fileName}**: ${description}`;
+        }).join('\n')}
+
+## When to Use
+Use this skill when working with:
+- ${skill.name} related tasks
+- ${skill.description.toLowerCase()}
+
+## Files Available
+${skill.files.map((file) => `- ${file}`).join('\n')}
+
+---
+*This skill is part of the Maestro File System - adapted for Cursor*
+`;
+    }
+    /**
+     * Gera conteúdo otimizado para Antigravity
+     */
+    generateAntigravityContent(skill, skillPath) {
+        return `---
+name: ${skill.name}
+trigger: on_demand
+category: ${this.getCategoryFromName(skill.name)}
+version: 1.0.0
+---
+
+# ${skill.name}
+
+## Overview
+${skill.description}
+
+## Quick Start
+This skill provides expertise in ${skill.name}. Use it when you need help with:
+
+${skill.files.map((file) => {
+            const fileName = file.replace(/\.md$/, '');
+            const description = this.getFileDescription(file);
+            return `- **${fileName}**: ${description}`;
+        }).join('\n')}
+
+## Available Resources
+All detailed guides are available in the \`content/\` directory:
+${skill.files.map((file) => `- \`content/${file}\``).join('\n')}
+
+## Usage
+Simply reference this skill when working on ${skill.name} tasks, and the AI will automatically load the relevant expertise.
+
+---
+*Generated by Maestro CLI for Antigravity/Gemini*
+`;
+    }
+    /**
+     * Obtém descrição do arquivo baseada no nome
+     */
+    getFileDescription(fileName) {
+        const descriptions = {
+            'rest.md': 'REST API design principles',
+            'graphql.md': 'GraphQL schema design',
+            'auth.md': 'Authentication patterns',
+            'ux-psychology.md': 'User psychology principles',
+            'color-system.md': 'Color theory and selection',
+            'typography-system.md': 'Font pairing and scale',
+            'api-style.md': 'API style decision tree',
+            'response.md': 'Response format patterns',
+            'versioning.md': 'API versioning strategies'
+        };
+        return descriptions[fileName] || 'Detailed guide and reference';
+    }
+    /**
+     * Determina categoria baseada no nome da skill
+     */
+    getCategoryFromName(skillName) {
+        const categories = {
+            'api-patterns': 'backend',
+            'frontend-design': 'frontend',
+            'architecture': 'architecture',
+            'database-design': 'database',
+            'mobile-design': 'mobile',
+            'security': 'security',
+            'performance': 'performance',
+            'testing': 'testing'
+        };
+        return categories[skillName] || 'general';
+    }
+}
+//# sourceMappingURL=skill-adapter.js.map

package/dist/adapters/skill-adapter.js.map

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

package/dist/content/rules/GEMINI.md

@@ -1,7 +1,7 @@
 ---
 trigger: always_on
 system: maestro
-version: 1.0.0
+version: 2.0.0
 ---
 
 # GEMINI.md - MCP Maestro Development Kit
@@ -71,42 +71,67 @@ version: 1.0.0
 
 **SEMPRE ATIVO: Carregar especialista correto para cada fase**
 
-### Protocol de Carregamento
+### Protocol de Carregamento (ATUALIZADO - Skills Locais v2.0)
 
 ```
 1. Ler estado.json → obter fase_atual
-2. Mapear fase → especialista (via fluxo)
-3. Carregar via resource maestro://especialista/{nome}
-4. Aplicar persona e instruções do especialista
-5. Usar template correto para a fase
+2. Mapear fase → nome da skill (via FASE_SKILL_MAP)
+3. Skill está em `.agent/skills/{nome}/SKILL.md`
+4. Ativar skill via `@{nome}` ou ler SKILL.md diretamente
+5. Usar templates em `.agent/skills/{nome}/resources/templates/`
+6. Seguir checklist em `.agent/skills/{nome}/resources/checklists/`
 ```
 
-### Mapeamento Fase → Especialista
+**Exemplo de Uso:**
+
+```markdown
+// Estado atual
+fase_atual: 1
+nivel_complexidade: "medio"
+
+// Fase 1 = Produto → skill = specialist-gestao-produto
+skill_nome: "specialist-gestao-produto"
+skill_path: ".agent/skills/specialist-gestao-produto/"
+
+// Ativar skill
+@specialist-gestao-produto
+
+// Acessar resources
+- SKILL.md (descrição e persona)
+- README.md (documentação completa)
+- MCP_INTEGRATION.md (funções MCP disponíveis)
+- resources/templates/PRD.md
+- resources/checklists/prd-validation.md
+- resources/examples/prd-examples.md
+- resources/reference/product-guide.md
+```
+
+### Mapeamento Fase → Skill
 
 **Fluxo Simples (7 fases)**:
-1. Produto → `Gestão de Produto`
-2. Requisitos → `Engenharia de Requisitos`
-3. UX Design → `UX Design`
-4. Arquitetura → `Arquitetura de Software`
-5. Backlog → `Plano de Execução`
-6. Frontend → `Desenvolvimento Frontend`
-7. Backend → `Desenvolvimento`
+1. Produto → `specialist-gestao-produto`
+2. Requisitos → `specialist-engenharia-requisitos-ia`
+3. UX Design → `specialist-ux-design`
+4. Arquitetura → `specialist-arquitetura-software`
+5. Backlog → `specialist-plano-execucao-ia`
+6. Frontend → `specialist-desenvolvimento-frontend`
+7. Backend → `specialist-desenvolvimento-backend`
 
 **Fluxo Médio (13 fases)** adiciona:
-4. Modelo de Domínio → `Modelagem e Arquitetura de Domínio com IA`
-5. Banco de Dados → `Banco de Dados`
-7. Segurança → `Segurança da Informação`
-8. Testes → `Análise de Testes`
-10. Contrato API → `Contrato de API`
-13. Integração → `DevOps e Infraestrutura`
+4. Modelo de Domínio → `specialist-modelagem-dominio`
+5. Banco de Dados → `specialist-banco-dados`
+7. Segurança → `specialist-seguranca-informacao`
+8. Testes → `specialist-analise-testes`
+10. Contrato API → `specialist-contrato-api`
+13. Integração → `specialist-devops-infra`
 
 **Fluxo Complexo (17 fases)** adiciona:
-7. Arquitetura Avançada → `Arquitetura Avançada`
-9. Performance → `Performance e Escalabilidade`
-10. Observabilidade → `Observabilidade`
+7. Arquitetura Avançada → `specialist-arquitetura-avancada`
+9. Performance → `specialist-performance-escalabilidade`
+10. Observabilidade → `specialist-observabilidade`
 
 **Fase Stitch (Opcional)** - Inserida após UX Design:
-- Prototipagem → `Prototipagem Rápida com Google Stitch`
+- Prototipagem → `specialist-prototipagem-stitch`
 
 ### Response Format (MANDATORY)
 
@@ -114,9 +139,16 @@ Ao carregar especialista, informar:
 
 ```markdown
 🎯 **Fase {número}: {nome}**
-🤖 **Especialista**: `{nome_especialista}`
+🤖 **Skill**: `{nome_skill}`
+📁 **Localização**: `.agent/skills/{nome_skill}/SKILL.md`
 📋 **Entregável**: {entregavel_esperado}
 
+> 💡 **Como usar:**
+> 1. Ative: `@{nome_skill}`
+> 2. Leia SKILL.md para instruções
+> 3. Consulte templates em `resources/templates/`
+> 4. Valide com checklist em `resources/checklists/`
+
 [Continuar com instruções do especialista]
 ```
 
@@ -154,13 +186,27 @@ await mcp_maestro_proximo({
 
 ### 📁 File Structure Awareness
 
-**Estrutura Padrão MCP Maestro**:
+**Estrutura Padrão MCP Maestro (ATUALIZADO)**:
 
 ```
 projeto/
 ├── .maestro/
 │   ├── estado.json       # ⭐ FONTE DA VERDADE
-│   └── resumo.json       # Cache de contexto
+│   ├── resumo.json       # Cache de contexto
+│   └── content/          # Conteúdo interno MCP (templates, prompts, guias)
+├── .agent/
+│   └── skills/           # ⭐ SKILLS LOCAIS (v2.0)
+│       ├── specialist-gestao-produto/
+│       │   ├── SKILL.md
+│       │   ├── README.md
+│       │   ├── MCP_INTEGRATION.md
+│       │   └── resources/
+│       │       ├── templates/
+│       │       ├── examples/
+│       │       ├── checklists/
+│       │       └── reference/
+│       ├── specialist-engenharia-requisitos-ia/
+│       └── ... (outras skills)
 ├── docs/
 │   ├── 01-produto/
 │   │   └── PRD.md
@@ -284,6 +330,12 @@ Produto(1) → Requisitos(2) → UX Design(3) → Stitch(4) → Modelo(5) → ..
 
 **Para features que envolvem Frontend + Backend**:
 
+**Regra oficial (obrigatória):**
+- **NUNCA** iniciar FE/BE sem **Contrato API validado + Mock server ativo**
+- **Frontend** só pode consumir **mocks gerados do contrato**
+- **Backend** deve **implementar exatamente o contrato**, sem alterações fora do versionamento
+- **Integração** só inicia após FE + BE concluídos
+
 ```
 FEAT-001: Criar Pedido
 │

package/dist/content/rules/RULES.md

@@ -278,6 +278,12 @@ Produto(1) → Requisitos(2) → UX Design(3) → Stitch(4) → Modelo(5) → ..
 
 **Para features que envolvem Frontend + Backend**:
 
+**Regra oficial (obrigatória):**
+- **NUNCA** iniciar FE/BE sem **Contrato API validado + Mock server ativo**
+- **Frontend** só pode consumir **mocks gerados do contrato**
+- **Backend** deve **implementar exatamente o contrato**, sem alterações fora do versionamento
+- **Integração** só inicia após FE + BE concluídos
+
 ```
 FEAT-001: Criar Pedido
 │