npm - @maestro-ai/mcp-server - Versions diffs - 1.2.0 → 2.0.0 - Mend

@maestro-ai/mcp-server 1.2.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (803) hide show

package/dist/content/prompts/devops/docker-compose.md DELETED Viewed

@@ -1,336 +0,0 @@
-# Prompt: Configuração Docker Compose
-> **Quando usar**: Ao containerizar aplicação para desenvolvimento ou produção simples
-> **Especialista**: [DevOps e Infraestrutura](../../02-especialistas/Especialista%20em%20DevOps%20e%20Infraestrutura.md)
-> **Nível**: Simples a Médio
----
-## Fluxo de Contexto
-Antes de usar este prompt, tenha em mãos:
-- `docs/CONTEXTO.md` - Entendimento do projeto
-- `docs/05-arquitetura/arquitetura.md` - Stack e componentes
-Após gerar, salve o resultado em:
-- `docker-compose.yml` (raiz do projeto)
-- `docker-compose.dev.yml` (override de desenvolvimento)
-- `docker-compose.prod.yml` (override de produção)
----
-## Prompt Completo
-```text
-Atue como especialista em Docker e containerização.
-## Contexto do Projeto
-[COLE O CONTEÚDO DE docs/CONTEXTO.md]
-## Stack Tecnológica
-- Backend: [Framework/Linguagem]
-- Frontend: [Framework]
-- Banco de dados: [PostgreSQL/MySQL/MongoDB]
-- Cache: [Redis/Memcached/Nenhum]
-- Message broker: [RabbitMQ/Kafka/Nenhum]
-- Outros serviços: [ElasticSearch, MinIO, etc]
-## Ambientes Necessários
-- [ ] Desenvolvimento local
-- [ ] Staging
-- [ ] Produção
-## Requisitos Específicos
-- Hot reload em desenvolvimento: [Sim/Não]
-- Volumes persistentes: [quais dados]
-- Variáveis de ambiente: [como gerenciar]
-- Múltiplos serviços: [monolito/microsserviços]
----
-## Sua Missão
-Gere configuração Docker Compose completa:
-### 1. Dockerfiles
-#### Backend
-```dockerfile
-# Dockerfile para [linguagem]
-# Multi-stage build para produção
-# Stage 1: Build
-FROM [base-image] AS builder
-# ...
-# Stage 2: Production
-FROM [slim-image] AS production
-# ...
-# Stage 3: Development (opcional)
-FROM builder AS development
-# Hot reload setup
-```
-Inclua:
-- [ ] Multi-stage build
-- [ ] Non-root user
-- [ ] Healthcheck
-- [ ] Otimização de layers
-- [ ] .dockerignore
-#### Frontend (se aplicável)
-```dockerfile
-# Build estático ou SSR
-```
-### 2. Docker Compose Base
-```yaml
-# docker-compose.yml
-version: '3.8'
-services:
-  backend:
-    build:
-      context: .
-      dockerfile: Dockerfile
-      target: production
-    ports:
-      - "3000:3000"
-    environment:
-      - NODE_ENV=production
-    depends_on:
-      db:
-        condition: service_healthy
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-    restart: unless-stopped
-  db:
-    image: postgres:15-alpine
-    volumes:
-      - postgres_data:/var/lib/postgresql/data
-    environment:
-      POSTGRES_DB: ${DB_NAME}
-      POSTGRES_USER: ${DB_USER}
-      POSTGRES_PASSWORD: ${DB_PASSWORD}
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U ${DB_USER}"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-volumes:
-  postgres_data:
-networks:
-  default:
-    name: [project]-network
-```
-### 3. Override de Desenvolvimento
-```yaml
-# docker-compose.dev.yml
-version: '3.8'
-services:
-  backend:
-    build:
-      target: development
-    volumes:
-      - .:/app
-      - /app/node_modules  # Evita sobrescrever node_modules
-    environment:
-      - NODE_ENV=development
-      - DEBUG=*
-    ports:
-      - "9229:9229"  # Debug port
-    command: npm run dev
-  # Serviços extras de desenvolvimento
-  mailhog:
-    image: mailhog/mailhog
-    ports:
-      - "1025:1025"
-      - "8025:8025"
-```
-### 4. Override de Produção
-```yaml
-# docker-compose.prod.yml
-version: '3.8'
-services:
-  backend:
-    deploy:
-      replicas: 2
-      resources:
-        limits:
-          cpus: '0.5'
-          memory: 512M
-    logging:
-      driver: json-file
-      options:
-        max-size: "10m"
-        max-file: "3"
-  # Nginx como reverse proxy
-  nginx:
-    image: nginx:alpine
-    ports:
-      - "80:80"
-      - "443:443"
-    volumes:
-      - ./nginx.conf:/etc/nginx/nginx.conf:ro
-      - ./certs:/etc/nginx/certs:ro
-    depends_on:
-      - backend
-```
-### 5. Arquivo .env Template
-```env
-# .env.example
-# Copie para .env e preencha
-# Database
-DB_HOST=db
-DB_PORT=5432
-DB_NAME=myapp
-DB_USER=myuser
-DB_PASSWORD=changeme
-# Application
-APP_PORT=3000
-APP_SECRET=generate-a-secure-secret
-NODE_ENV=development
-# Redis (se aplicável)
-REDIS_URL=redis://redis:6379
-# External services
-SMTP_HOST=mailhog
-SMTP_PORT=1025
-```
-### 6. Scripts de Conveniência
-```makefile
-# Makefile
-.PHONY: dev prod build logs
-dev:
-	docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build
-prod:
-	docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d --build
-build:
-	docker-compose build --no-cache
-logs:
-	docker-compose logs -f
-shell:
-	docker-compose exec backend sh
-db-shell:
-	docker-compose exec db psql -U $${DB_USER} -d $${DB_NAME}
-clean:
-	docker-compose down -v --remove-orphans
-```
-### 7. .dockerignore
-```
-# .dockerignore
-node_modules
-npm-debug.log
-.git
-.env
-.env.*
-*.md
-.vscode
-.idea
-coverage
-dist
-.next
-```
-### 8. Comandos Úteis
-```bash
-# Desenvolvimento
-docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build
-# Produção
-docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d
-# Ver logs
-docker-compose logs -f [service]
-# Rebuild específico
-docker-compose build --no-cache [service]
-# Shell no container
-docker-compose exec [service] sh
-# Limpar tudo
-docker-compose down -v --remove-orphans
-```
-```
----
-## Exemplo de Uso
-```text
-Atue como especialista em Docker e containerização.
-## Contexto
-API de e-commerce com NestJS.
-## Stack
-- Backend: NestJS (Node 20)
-- Banco: PostgreSQL 15
-- Cache: Redis 7
-- Queue: Bull (Redis-based)
-## Ambientes
-- [x] Desenvolvimento local
-- [x] Produção
-## Requisitos
-- Hot reload com npm run start:dev
-- Prisma como ORM
-- Migrations automáticas em dev
-```
----
-## Checklist Pós-Geração
-- [ ] Dockerfile com multi-stage build
-- [ ] docker-compose.yml base criado
-- [ ] docker-compose.dev.yml com hot reload
-- [ ] docker-compose.prod.yml com limites de recursos
-- [ ] .env.example documentado
-- [ ] .dockerignore configurado
-- [ ] Healthchecks configurados
-- [ ] Volumes para persistência
-- [ ] Non-root user no container
-- [ ] Makefile ou scripts de conveniência

package/dist/content/prompts/devops/feature-flags.md DELETED Viewed

@@ -1,374 +0,0 @@
-# Prompt: Feature Flags
-> **Prioridade**: 🟡 MÉDIA
-> **Aplicável a**: Projetos com deploys frequentes, rollouts graduais, experimentação
----
-## O que são Feature Flags?
-Feature flags (ou feature toggles) permitem:
-- **Rollout gradual** de features (1% → 10% → 50% → 100%)
-- **Desligar features** rapidamente sem deploy
-- **A/B testing** em produção
-- **Trunk-based development** (merge código incompleto)
-- **Kill switch** para features problemáticas
----
-## Tipos de Feature Flags
-| Tipo | Duração | Uso |
-|------|---------|-----|
-| **Release Flag** | Dias/semanas | Rollout gradual de nova feature |
-| **Experiment Flag** | Semanas | A/B testing |
-| **Ops Flag** | Permanente | Kill switches, manutenção |
-| **Permission Flag** | Permanente | Features por tier/plano |
----
-## Prompt Base: Implementar Feature Flags
-```text
-Atue como engenheiro de software sênior.
-Preciso implementar feature flags para:
-- Stack: [ex. Node.js + React / Java + Spring]
-- Escala: [ex. 10k DAU, 100 req/s]
-- Use cases: [ex. rollout gradual, A/B testing, kill switches]
-Ferramenta escolhida: [LaunchDarkly / Unleash / Flagsmith / Caseiro com Redis]
-Gere uma implementação com:
-1. **Setup da Ferramenta**
-   - Instalação e configuração
-   - SDK client e server-side
-2. **Tipos de Flags**
-   - Boolean simples
-   - Percentage rollout
-   - User targeting (por ID, email, etc)
-   - Multivariate (A/B/C testing)
-3. **Código de Integração**
-   - Wrapper/service para acessar flags
-   - Uso em backend
-   - Uso em frontend
-   - Defaults seguros (fallback)
-4. **Boas Práticas**
-   - Naming convention
-   - Documentação de flags
-   - Lifecycle (criar → usar → remover)
-   - Limpeza de flags antigas
-5. **Observabilidade**
-   - Logs de qual variant foi servida
-   - Métricas por flag
-   - Alertas se flag falhar
-```
----
-## Prompt: Feature Flag Caseiro (Redis)
-```text
-Não quero usar uma ferramenta externa para feature flags.
-Preciso de uma solução simples com Redis.
-Requisitos:
-- Boolean flags
-- Percentage rollout (0-100%)
-- User targeting básico
-- Admin UI simples para gerenciar
-Stack: [DESCREVA]
-Gere:
-1. Schema Redis para flags
-2. Service para avaliar flags
-3. API para CRUD de flags
-4. Middleware/HOC para usar em código
-5. Exemplo de uso em feature real
-```
----
-## Prompt: Migrar para Feature Flags
-```text
-Tenho código com lógica condicional hardcoded:
-[COLE CÓDIGO COM IFs PARA FEATURES]
-Quero migrar para feature flags para:
-- Controlar remotamente
-- Fazer rollout gradual
-- Ter fallback rápido
-Refatore o código para:
-1. Usar feature flag service
-2. Manter defaults seguros
-3. Documentar a flag
-4. Incluir limpeza futura
-```
----
-## Exemplo: Feature Flag Service (TypeScript)
-```typescript
-// src/services/featureFlags.ts
-import Redis from 'ioredis';
-interface Flag {
-  name: string;
-  enabled: boolean;
-  percentage?: number;        // 0-100 para rollout
-  allowedUsers?: string[];    // targeting específico
-  allowedGroups?: string[];   // ex: 'beta-testers', 'employees'
-  variants?: Record<string, number>; // A/B testing: { 'control': 50, 'treatment': 50 }
-}
-interface EvaluationContext {
-  userId?: string;
-  email?: string;
-  groups?: string[];
-  attributes?: Record<string, any>;
-}
-class FeatureFlagService {
-  private redis: Redis;
-  private cache: Map<string, Flag> = new Map();
-  private cacheRefreshInterval = 30000; // 30 segundos
-  constructor(redis: Redis) {
-    this.redis = redis;
-    this.startCacheRefresh();
-  }
-  async isEnabled(flagName: string, context: EvaluationContext = {}): Promise<boolean> {
-    const flag = await this.getFlag(flagName);
-    if (!flag) return false; // Default: desligado se não existe
-    if (!flag.enabled) return false;
-    // User targeting
-    if (flag.allowedUsers?.includes(context.userId || '')) {
-      return true;
-    }
-    // Group targeting
-    if (flag.allowedGroups && context.groups) {
-      const hasGroup = flag.allowedGroups.some(g => context.groups!.includes(g));
-      if (hasGroup) return true;
-    }
-    // Percentage rollout
-    if (flag.percentage !== undefined) {
-      const hash = this.hashUser(context.userId || 'anonymous', flagName);
-      return hash < flag.percentage;
-    }
-    return true;
-  }
-  async getVariant(flagName: string, context: EvaluationContext = {}): Promise<string> {
-    const flag = await this.getFlag(flagName);
-    if (!flag || !flag.variants) return 'control';
-    if (!flag.enabled) return 'control';
-    const hash = this.hashUser(context.userId || 'anonymous', flagName);
-    let cumulative = 0;
-    for (const [variant, percentage] of Object.entries(flag.variants)) {
-      cumulative += percentage;
-      if (hash < cumulative) {
-        return variant;
-      }
-    }
-    return 'control';
-  }
-  private hashUser(userId: string, flagName: string): number {
-    // Hash determinístico para consistência
-    const str = `${userId}:${flagName}`;
-    let hash = 0;
-    for (let i = 0; i < str.length; i++) {
-      hash = ((hash << 5) - hash) + str.charCodeAt(i);
-      hash = hash & hash;
-    }
-    return Math.abs(hash) % 100;
-  }
-  private async getFlag(name: string): Promise<Flag | null> {
-    if (this.cache.has(name)) {
-      return this.cache.get(name)!;
-    }
-    const data = await this.redis.hget('feature_flags', name);
-    if (!data) return null;
-    const flag = JSON.parse(data) as Flag;
-    this.cache.set(name, flag);
-    return flag;
-  }
-  private startCacheRefresh() {
-    setInterval(async () => {
-      const flags = await this.redis.hgetall('feature_flags');
-      this.cache.clear();
-      for (const [name, data] of Object.entries(flags)) {
-        this.cache.set(name, JSON.parse(data));
-      }
-    }, this.cacheRefreshInterval);
-  }
-  // Admin methods
-  async createFlag(flag: Flag): Promise<void> {
-    await this.redis.hset('feature_flags', flag.name, JSON.stringify(flag));
-  }
-  async updateFlag(name: string, updates: Partial<Flag>): Promise<void> {
-    const existing = await this.getFlag(name);
-    if (!existing) throw new Error(`Flag ${name} not found`);
-    const updated = { ...existing, ...updates };
-    await this.redis.hset('feature_flags', name, JSON.stringify(updated));
-    this.cache.delete(name);
-  }
-  async deleteFlag(name: string): Promise<void> {
-    await this.redis.hdel('feature_flags', name);
-    this.cache.delete(name);
-  }
-  async listFlags(): Promise<Flag[]> {
-    const flags = await this.redis.hgetall('feature_flags');
-    return Object.values(flags).map(f => JSON.parse(f));
-  }
-}
-export const featureFlags = new FeatureFlagService(new Redis());
-```
----
-## Uso no Código
-### Backend
-```typescript
-// Em um controller
-app.get('/api/checkout', async (req, res) => {
-  const userId = req.user.id;
-  const useNewCheckout = await featureFlags.isEnabled('new_checkout_flow', {
-    userId,
-    groups: req.user.groups
-  });
-  if (useNewCheckout) {
-    return handleNewCheckout(req, res);
-  }
-  return handleLegacyCheckout(req, res);
-});
-```
-### Frontend (React)
-```typescript
-// hooks/useFeatureFlag.ts
-import { useEffect, useState } from 'react';
-export function useFeatureFlag(flagName: string) {
-  const [enabled, setEnabled] = useState(false);
-  const [loading, setLoading] = useState(true);
-  useEffect(() => {
-    fetch(`/api/feature-flags/${flagName}`)
-      .then(res => res.json())
-      .then(data => {
-        setEnabled(data.enabled);
-        setLoading(false);
-      });
-  }, [flagName]);
-  return { enabled, loading };
-}
-// Uso no componente
-function CheckoutButton() {
-  const { enabled: showNewButton, loading } = useFeatureFlag('new_checkout_button');
-  if (loading) return <Skeleton />;
-  return showNewButton ? <NewCheckoutButton /> : <LegacyCheckoutButton />;
-}
-```
----
-## Naming Convention
-```
-{scope}_{feature}_{detail}
-Exemplos:
-- checkout_new_flow
-- checkout_express_enabled
-- payment_pix_enabled
-- experiment_homepage_hero
-- ops_maintenance_mode
-- tier_premium_analytics
-```
----
-## Lifecycle de uma Flag
-```mermaid
-graph LR
-    A[Criar Flag] -->|disabled| B[Testar em Dev]
-    B -->|enabled + targeting| C[Beta Users]
-    C -->|percentage 10%| D[Rollout Gradual]
-    D -->|percentage 100%| E[GA]
-    E -->|remover condicionais| F[Cleanup]
-    F --> G[Deletar Flag]
-```
----
-## Checklist
-- [ ] Ferramenta/implementação escolhida
-- [ ] SDK integrado no backend e frontend
-- [ ] Defaults seguros (fallback se flag não existir)
-- [ ] Naming convention definida
-- [ ] Documentação de cada flag (propósito, owner, prazo)
-- [ ] Processo de limpeza de flags antigas
-- [ ] Logs de avaliação para debugging
-- [ ] Alertas se serviço de flags falhar
----
-## Ferramentas Populares
-| Ferramenta | Tipo | Prós | Contras |
-|------------|------|------|---------|
-| **LaunchDarkly** | SaaS | Completo, robusto | Custo |
-| **Unleash** | Open Source | Self-hosted, simples | Menos features |
-| **Flagsmith** | Híbrido | Open core, UI boa | Algumas features pagas |
-| **ConfigCat** | SaaS | Simples, barato | Menos targeting |
-| **Caseiro (Redis)** | DIY | Controle total | Manutenção |
----
-## Referências
-- [Feature Toggles (Martin Fowler)](https://martinfowler.com/articles/feature-toggles.html)
-- [LaunchDarkly Best Practices](https://launchdarkly.com/blog/best-practices-for-feature-flags/)
-- [Unleash Documentation](https://docs.getunleash.io/)