agent-master-devsecops 0.0.0-stage → 5.1.0

package/scripts/mcp/tools_registry.js

@@ -0,0 +1,1123 @@
+/**
+ * Tools Registry — Catálogo e Perfis de Ferramentas MCP
+ * Define o esquema JSON-RPC 2.0 e os perfis de late-binding (Regra 18).
+ * Versão: 5.1.0 Enterprise
+ */
+
+'use strict';
+
+const { createSarifReport } = require('../core/sarif_engine.js');
+
+const TOOLS = [
+  {
+    name: 'agent_get_rule',
+    description: 'Consulta um dos 10 Princípios Canônicos de Engenharia de Software & Governança (v5.0 Enterprise) ou mapeia regras legadas do ecossistema Agent Master.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ruleNumber: {
+          type: 'integer',
+          description: 'Número do princípio canônico (1 a 10) ou regra legada (1 a 27)'
+        }
+      },
+      required: ['ruleNumber']
+    }
+  },
+  {
+    name: 'agent_validate_idea',
+    description: 'Aplica a Regra 14 (Ideation Sanity Filter): avalia criticamente uma ideia contra a stack, arquitetura e restrições reais do projeto.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ideaTitle: { type: 'string', description: 'Título da ideia' },
+        ideaDescription: { type: 'string', description: 'Descrição da proposta' },
+        projectStack: { type: 'string', description: 'Stack tecnológica do projeto real' },
+        projectDomain: { type: 'string', description: 'Propósito/domínio do projeto' }
+      },
+      required: ['ideaTitle', 'ideaDescription', 'projectStack', 'projectDomain']
+    }
+  },
+  {
+    name: 'agent_recommend_architecture',
+    description: 'Atua como Principal Software Architect agnóstico: analisa requisitos e recomenda a melhor arquitetura e stack com análise imparcial de trade-offs e alerta de overengineering.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        description: { type: 'string', description: 'Descrição da necessidade ou problema de negócio' },
+        domain: { type: 'string', description: 'Domínio funcional (ex: pagamentos, iot, calculadora, dashboard, analytics)' },
+        scale: { type: 'string', description: 'Escala prevista: prototype, low, medium, high, extreme' },
+        criticality: { type: 'string', description: 'Criticidade: low, medium, high, critical' },
+        teamSize: { type: 'string', description: 'Contexto de equipe: solo, small, enterprise' },
+        userPreference: {
+          type: 'object',
+          properties: {
+            stack: { type: 'string', description: 'Stack pretendida pelo usuário (opcional)' },
+            architecture: { type: 'string', description: 'Arquitetura pretendida pelo usuário (opcional)' }
+          }
+        }
+      },
+      required: ['description']
+    }
+  },
+  {
+    name: 'agent_ground_knowledge',
+    description: 'Consulta o Dynamic Knowledge Gateway (v5.0 Enterprise) com grounding vivo em documentações e APIs oficiais (W3C WCAG/WAI-ARIA, CVEs OSV.dev, Spring Initializr Java 21 LTS e lifecycles de runtimes).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          enum: [
+            'query_osv',
+            'get_wcag_spec',
+            'get_spring_blueprint',
+            'get_runtime_lts',
+            'lookup_doc',
+            'get_cache_stats',
+            'clear_cache'
+          ],
+          description: 'Ação de consulta ou gestão de conhecimento oficial'
+        },
+        package: { type: 'string', description: 'Nome do pacote/dependência para auditoria OSV' },
+        version: { type: 'string', description: 'Versão do pacote para auditoria OSV' },
+        ecosystem: { type: 'string', description: 'Ecossistema (npm, Maven, PyPI, Go)' },
+        criterion: { type: 'string', description: 'Critério ou regra WCAG (ex: WCAG-1.1.1, alt, contraste)' },
+        tech: { type: 'string', description: 'Tecnologia ou runtime (java, node, go, python, spring)' },
+        topic: { type: 'string', description: 'Tópico de documentação arquitetural' },
+        bootVersion: { type: 'string', description: 'Versão do Spring Boot para blueprint' },
+        javaVersion: { type: 'string', description: 'Versão do Java LTS para blueprint' }
+      }
+    }
+  },
+  {
+    name: 'agent_audit_code',
+    description: 'Aciona o Revisor Crítico Adversário (AGENT_QA.md) para analisar um diff de código contra vulnerabilidades OWASP, ReDoS e integridade de testes.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        codeDiff: { type: 'string', description: 'Diff ou código a ser auditado friamente' },
+        context: { type: 'string', description: 'Contexto da funcionalidade ou card' }
+      },
+      required: ['codeDiff']
+    }
+  },
+  {
+    name: 'agent_full_dev_status',
+    description: 'Consulta o status atual do Modo Full Developer e a próxima ideia priorizada do backlog.',
+    inputSchema: {
+      type: 'object',
+      properties: {}
+    }
+  },
+  {
+    name: 'agent_eval_harness',
+    description: 'Executa avaliação empírica de conformidade da resposta de uma LLM contra os 10 Princípios Canônicos de Engenharia de Software & Governança (v5.0 Enterprise).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        modelName: { type: 'string', description: 'Nome do modelo avaliado (ex: Claude 3.5, GPT-4o, Gemini Pro, DeepSeek-R1)' },
+        promptSent: { type: 'string', description: 'Prompt de instrução enviado à LLM' },
+        responseReceived: { type: 'string', description: 'Resposta bruta recebida da LLM' }
+      },
+      required: ['modelName', 'responseReceived']
+    }
+  },
+  {
+    name: 'agent_generate_ide_plugins',
+    description: 'Gera arquivos de configuração e manifestos nativos para IDEs (.vscode e .idea) integrando o servidor MCP e atalhos de prompts.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        target: { type: 'string', enum: ['all', 'vscode', 'jetbrains'], description: 'IDE alvo da geração' },
+        targetDir: { type: 'string', description: 'Diretório raiz do projeto' }
+      }
+    }
+  },
+  {
+    name: 'agent_review_pr',
+    description: 'Executa a auditoria autônoma do Revisor Independente (AGENT_QA.md) contra um diff de código ou número de PR, emitindo veredito canônico e testes de quebra.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        diff: { type: 'string', description: 'Diff de código a ser auditado' },
+        files: { type: 'array', items: { type: 'string' }, description: 'Lista de caminhos de arquivos modificados' }
+      },
+      required: ['diff']
+    }
+  },
+  {
+    name: 'agent_compress_context',
+    description: 'Destila as instruções e regras do Agent Master em uma versão compacta de alta densidade semântica para modelos locais (Ollama 8B/14B) sob orçamento de 1.500 tokens.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        text: { type: 'string', description: 'Texto opcional customizado a ser compactado' },
+        maxTokens: { type: 'number', description: 'Orçamento máximo de tokens (padrão: 1500)' }
+      }
+    }
+  },
+  {
+    name: 'agent_sync_atlassian',
+    description: 'Registra um Remote Link de commit, branch ou Pull Request do GitHub diretamente em um card do Jira (ex: AGDEV-23).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        issueKey: { type: 'string', description: 'Chave do ticket Jira (ex: AGDEV-23, PROJ-53)' },
+        url: { type: 'string', description: 'URL no GitHub (commit, branch ou PR)' },
+        title: { type: 'string', description: 'Título descritivo do link' },
+        type: { type: 'string', enum: ['commit', 'branch', 'pr'], description: 'Tipo do vínculo remoto' }
+      },
+      required: ['issueKey', 'url', 'title']
+    }
+  },
+  {
+    name: 'agent_otel_trace',
+    description: 'Executa instrumentação de tracing distribuído compatível com OpenTelemetry e W3C TraceContext, gerando flamegraph ASCII e análise de gargalos.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        serviceName: { type: 'string', description: 'Nome do serviço instrumentado' },
+        spans: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              name: { type: 'string' },
+              durationMs: { type: 'number' },
+              attributes: { type: 'object' }
+            },
+            required: ['name', 'durationMs']
+          },
+          description: 'Lista de spans a serem traçados'
+        },
+        thresholdMs: { type: 'number', description: 'Limiar em milissegundos para alertar gargalos de latência' }
+      }
+    }
+  },
+  {
+    name: 'agent_perf_benchmark',
+    description: 'Executa micro-benchmark de CPU/Throughput e memória Heap, comparando contra o baseline para detecção de regressões de performance (> 10%).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        iterations: { type: 'number', description: 'Número de repetições do benchmark (padrão: 100)' },
+        maxDegradationPct: { type: 'number', description: 'Porcentagem máxima tolerada de degradação (padrão: 10)' }
+      }
+    }
+  },
+  {
+    name: 'agent_circuit_breaker',
+    description: 'Gerencia o Circuit Breaker inteligente e comutação automática de provedores de IA (Anthropic, OpenAI, Groq, Ollama) com auto-cura e mitigação de HTTP 429/5xx.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: { type: 'string', enum: ['status', 'simulate_failover', 'reset'], description: 'Ação a ser executada' },
+        failureThreshold: { type: 'number', description: 'Limiar de falhas para rompimento do circuito (padrão: 3)' }
+      }
+    }
+  },
+  {
+    name: 'agent_orchestrate_event',
+    description: 'Despacha um evento no barramento multi-agente determinístico (EVENT_CODE_COMPLETE, EVENT_REVIEW_FAILED, EVENT_METRIC_ANOMALY, EVENT_REFACTOR_PROPOSAL, EVENT_AGENT_SELF_IMPROVE).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        eventType: {
+          type: 'string',
+          enum: [
+            'EVENT_CODE_COMPLETE',
+            'EVENT_REVIEW_FAILED',
+            'EVENT_REVIEW_PASSED',
+            'EVENT_METRIC_ANOMALY',
+            'EVENT_REFACTOR_PROPOSAL',
+            'EVENT_AGENT_SELF_IMPROVE'
+          ],
+          description: 'Tipo do evento canônico'
+        },
+        payload: {
+          type: 'object',
+          description: 'Dados contextuais do evento (diff, code, metric, finding, etc.)'
+        }
+      },
+      required: ['eventType']
+    }
+  },
+  {
+    name: 'agent_sast_scan',
+    description: 'Executa scanner estático SAST e detecção profunda de segredos (CWE-78, CWE-89, CWE-79, CWE-116, CWE-1333 ReDoS, CWE-798 Hardcoded Secrets). Suporta formato SARIF v2.1.0 e Semgrep CLI.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        code: { type: 'string', description: 'Código fonte ou diff para auditoria de segurança' },
+        filename: { type: 'string', description: 'Nome do arquivo analisado (opcional)' },
+        format: { type: 'string', enum: ['json', 'sarif'], description: 'Formato do relatório (json ou sarif v2.1.0)' }
+      },
+      required: ['code']
+    }
+  },
+  {
+    name: 'agent_remediate_code',
+    description: 'Motor Autônomo de Autocura DevSecOps em ciclo OODA: analisa vulnerabilidade SARIF, formula e aplica patch cirúrgico, valida suíte de testes do host e executa rollback automático se houver regressão.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        targetFile: { type: 'string', description: 'Caminho do arquivo a ser remediado' },
+        testCommand: { type: 'string', description: 'Comando de teste do host para verificação de não-regressão (ex: node --test, npm test)' },
+        projectRoot: { type: 'string', description: 'Diretório raiz do projeto alvo (opcional)' }
+      },
+      required: ['targetFile']
+    }
+  },
+  {
+    name: 'agent_audit_quality',
+    description: 'Audita a qualidade de código, complexidade ciclomática, profundidade de aninhamento e detecta anti-patterns como catch vazio e TODOs pendentes.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        code: { type: 'string', description: 'Código fonte para auditoria de qualidade' },
+        filename: { type: 'string', description: 'Nome do arquivo analisado (opcional)' },
+        maxComplexity: { type: 'number', description: 'Complexidade ciclomática máxima tolerada (padrão: 15)' }
+      },
+      required: ['code']
+    }
+  },
+  {
+    name: 'agent_sre_telemetry',
+    description: 'Coleta métricas canônicas de saúde e runtime no padrão Prometheus 0.0.4 (CPU, RSS, Heap V8) e avalia limiares de saturação.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        format: { type: 'string', enum: ['prometheus', 'json'], description: 'Formato da saída de métricas (padrão: json)' },
+        evaluateAlerts: { type: 'boolean', description: 'Se verdadeiro, executa avaliação de limiares de alerta' }
+      }
+    }
+  },
+  {
+    name: 'agent_sre_remediate',
+    description: 'Executa playbook de auto-remediação operacional SRE (purge_buffers, trigger_gc, reset_circuits, prune_cache) para mitigar saturação.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          enum: ['purge_buffers', 'trigger_gc', 'reset_circuits', 'prune_cache'],
+          description: 'Ação de auto-cura a ser executada'
+        },
+        context: { type: 'object', description: 'Metadados contextuais do incidente' }
+      },
+      required: ['action']
+    }
+  },
+  {
+    name: 'agent_export_universal_bundle',
+    description: 'Exporta perfis, regras e configurações pré-moldadas do Agent Master para Cursor (.cursorrules), Windsurf (.windsurfrules), Claude Desktop, ChatGPT Custom GPTs ou Ollama local.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        platform: {
+          type: 'string',
+          enum: ['cursor', 'windsurf', 'claude_desktop', 'chatgpt', 'ollama', 'all'],
+          description: 'Plataforma alvo para exportação (ou "all" para todas)'
+        },
+        targetDir: { type: 'string', description: 'Diretório de destino para exportação' },
+        dryRun: { type: 'boolean', description: 'Simula a geração sem gravar arquivos físicos no disco' }
+      },
+      required: ['platform']
+    }
+  },
+  {
+    name: 'agent_bootstrap_environment',
+    description: 'Executa o auto-bootstrap do Agent Master DevSecOps: detecta IDEs e ferramentas instaladas (Cursor, Windsurf, VS Code, Claude Desktop, Ollama) e injeta regras e manifestos MCP com zero configuração em < 2 segundos.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        targetDir: { type: 'string', description: 'Diretório alvo do projeto (padrão: raiz do projeto)' },
+        dryRun: { type: 'boolean', description: 'Simula a detecção e geração sem escrever em disco' },
+        platforms: {
+          type: 'array',
+          items: { type: 'string' },
+          description: 'Lista explícita opcional de plataformas a configurar (caso queira forçar em vez de auto-detectar)'
+        }
+      }
+    }
+  },
+  {
+    name: 'agent_generate_magic_prompt',
+    description: 'Gera o Magic Prompt autocontido (< 900 tokens) e o Web Bookmarklet para ativação instantânea em 1 clique em interfaces web de LLMs (ChatGPT, Claude.ai, Gemini, DeepSeek).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        targetDir: { type: 'string', description: 'Diretório de exportação dos arquivos HTML e Markdown' },
+        dryRun: { type: 'boolean', description: 'Simula a geração sem gravar arquivos físicos no disco' }
+      }
+    }
+  },
+  {
+    name: 'agent_inspector_info',
+    description: 'Consulta informações, rotas de API e telemetria do Web Dashboard & Playground do Agent Master (servido via scripts/web_inspector.js na porta 4040).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        port: { type: 'number', description: 'Porta HTTP configurada (padrão: 4040)' }
+      }
+    }
+  },
+  {
+    name: 'agent_check_credentials',
+    description: 'Audita e executa healthcheck de autenticação no GitHub CLI e Atlassian (Jira e Confluence), orientando o setup de credenciais para garantir o Tríplice Registro contínuo.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        targetDir: { type: 'string', description: 'Diretório raiz do projeto (opcional)' }
+      }
+    }
+  },
+  {
+    name: 'agent_configure_credentials',
+    description: 'Configura credenciais de autenticação da Atlassian no arquivo .env local com garantia de proteção estrita no .gitignore.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        domain: { type: 'string', description: 'Domínio Atlassian (ex: sua-empresa.atlassian.net)' },
+        email: { type: 'string', description: 'Email da conta Atlassian' },
+        token: { type: 'string', description: 'API Token da Atlassian' },
+        jiraKey: { type: 'string', description: 'Chave do projeto Jira (ex: PROJ)' },
+        confluenceSpace: { type: 'string', description: 'Espaço do Confluence (ex: DOC)' },
+        targetDir: { type: 'string', description: 'Diretório raiz do projeto (opcional)' }
+      },
+      required: ['domain', 'email', 'token']
+    }
+  },
+  {
+    name: 'agent_standardize_kanban',
+    description: 'Padroniza qualquer quadro Jira para as 3 colunas canônicas ("A fazer", "Em andamento", "Concluído") e gera as consultas JQL e mapeamento unificado.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectKey: { type: 'string', description: 'Chave do projeto Jira (ex: AGDEV)' },
+        boardConfig: { type: 'object', description: 'Configuração opcional do quadro retornada pela API do Jira' }
+      },
+      required: ['projectKey']
+    }
+  },
+  {
+    name: 'agent_full_dev_pipeline',
+    description: 'Orquestra o ciclo do Modo Full Developer: lê "A fazer", aplica filtro de sanidade (Regra 14), planeja transição para "Em andamento", homologa e move para "Concluído" em loop recursivo.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        tasks: {
+          type: 'array',
+          items: { type: 'object' },
+          description: 'Lista de tarefas obtidas do Jira'
+        },
+        projectContext: {
+          type: 'object',
+          description: 'Contexto real do projeto (stack, domain, architecture)'
+        }
+      },
+      required: ['tasks']
+    }
+  },
+  {
+    name: 'agent_validate_rule15',
+    description: 'Valida compulsória e ativamente o cumprimento da Regra 15 (Imutabilidade de Requisitos e Pré-Validação de Segredos Atlassian e GitHub). Bloqueia falhas silenciosas.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        failFast: { type: 'boolean', description: 'Se true, levanta erro impeditivo caso faltem requisitos. Padrão: false' },
+        requireGitHub: { type: 'boolean', description: 'Exige autenticação válida do GitHub CLI. Padrão: true' },
+        requireAtlassian: { type: 'boolean', description: 'Exige credenciais válidas do ecossistema Atlassian. Padrão: true' }
+      }
+    }
+  },
+  {
+    name: 'agent_audit_a11y',
+    description: 'Audita código HTML, JSX e TSX contra diretrizes de acessibilidade WCAG 2.1 AA (AGENT_UIUX & AGENT_QA), verificando contraste, semântica ARIA, imagens sem alt e foco visível.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        code: { type: 'string', description: 'Código-fonte HTML, JSX ou TSX a ser auditado.' },
+        filename: { type: 'string', description: 'Nome do arquivo de origem (ex: Header.tsx).' }
+      },
+      required: ['code']
+    }
+  },
+  {
+    name: 'agent_lint_git_hygiene',
+    description: 'Audita mensagens de commit e nomes de branch contra a Regra 11 de Engenharia ([<TICKET>] - <Ação em português> e veto a Conventional Commits e prefixos legados).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        commitMessage: { type: 'string', description: 'Mensagem do commit a ser auditada' },
+        branchName: { type: 'string', description: 'Nome da branch a ser auditada' },
+        auditState: { type: 'boolean', description: 'Se true, audita o repositório Git local ativo' }
+      }
+    }
+  },
+  {
+    name: 'agent_audit_dependencies_sca',
+    description: 'Executa Software Composition Analysis (SCA) offline no manifesto package.json, detectando CVEs conhecidas e licenças restritivas (GPL/AGPL).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        packageJson: { type: 'string', description: 'Conteúdo JSON ou caminho do package.json a auditar' }
+      }
+    }
+  },
+  {
+    name: 'agent_validate_api_contract',
+    description: 'Valida contratos OpenAPI 3.x / Swagger 2.0 (Loop 2) e detecta Drifts arquiteturais entre contrato e rotas implementadas no código (Shadow APIs e rotas ausentes).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        spec: { type: 'string', description: 'Conteúdo JSON ou caminho do arquivo OpenAPI/Swagger' },
+        implementedRoutes: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              method: { type: 'string' },
+              path: { type: 'string' }
+            },
+            required: ['method', 'path']
+          },
+          description: 'Lista de rotas implementadas no código para detecção de Drift'
+        }
+      },
+      required: ['spec']
+    }
+  },
+  {
+    name: 'agent_smart_onboarding',
+    description: 'Executa a Regra 16: detecta modo Greenfield vs Brownfield, mapeia a stack via engenharia reversa e orquestra o auto-provisionamento de Jira e Confluence sem páginas vazias.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        targetDir: {
+          type: 'string',
+          description: 'Caminho do projeto para auditoria/onboarding'
+        }
+      }
+    }
+  },
+  {
+    name: 'agent_verify_triad_gate',
+    description: 'Valida o Gate de Governança da Regra 16: bloqueia prompts de desenvolvimento de software caso a Tríade (Git + Jira + Confluence) não esteja 100% configurada, verificada e operacional.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        targetDir: {
+          type: 'string',
+          description: 'Caminho raiz do projeto a ser validado pelo Gate'
+        }
+      }
+    }
+  },
+  {
+    name: 'agent_extract_code_skeleton',
+    description: 'Extrai o esqueleto semântico de código (Rule 9), eliminando corpos de métodos para reduzir em até 90% o consumo de tokens de contexto entre módulos.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        code: { type: 'string', description: 'Código fonte a ser esqueletizado' },
+        language: { type: 'string', description: 'Linguagem do código (javascript, typescript, java, python)' }
+      },
+      required: ['code']
+    }
+  },
+  {
+    name: 'agent_scaffold_feature',
+    description: 'Gera atomicamente em 1 único turno (< 25ms) todos os arquivos de uma funcionalidade completa (Model, Repository, Service, Controller REST e Teste TDD), eliminando múltiplos roundtrips.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Nome da entidade/funcionalidade (ex: Filme)' },
+        domain: { type: 'string', description: 'Domínio funcional (ex: filmes)' },
+        package: { type: 'string', description: 'Pacote base (ex: br.com.empresa.filmes)' },
+        stack: { type: 'string', description: 'Stack ou linguagem tecnológica desejada (ex: typescript, nodejs, python, spring-boot, go, rust, html, csharp, elixir, etc.). Agnóstico e universal.' },
+        profile: { type: 'string', description: 'Intenção ou perfil arquitetural (ex: lightweight/educational, standard/clean-ddd, enterprise/banking, cli, microservice, prototype). Aberto e adaptativo.' },
+        persona: { type: 'string', description: 'Alias flexível para o perfil arquitetural/cognitivo' },
+        riskLevel: { type: 'string', enum: ['low', 'medium', 'high', 'critical'], description: 'Nível de risco regulatório e auditoria contábil' },
+        fields: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              name: { type: 'string' },
+              type: { type: 'string' },
+              required: { type: 'boolean' },
+              isId: { type: 'boolean' }
+            },
+            required: ['name', 'type']
+          },
+          description: 'Lista de atributos da entidade'
+        },
+        writeToDisk: { type: 'boolean', description: 'Se true, grava os arquivos diretamente nas pastas' }
+      },
+      required: ['name']
+    }
+  },
+  {
+    name: 'agent_set_mcp_profile',
+    description: 'Altera o perfil de ferramentas ativas do MCP (Late-Binding de Ferramentas) para economizar tokens de contexto: "all", "fast_dev", "core", "qa_devsecops", "atlassian", "sre".',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        profile: {
+          type: 'string',
+          enum: ['all', 'fast_dev', 'core', 'qa_devsecops', 'atlassian', 'sre'],
+          description: 'Perfil de ferramentas desejado'
+        }
+      },
+      required: ['profile']
+    }
+  },
+  {
+    name: 'agent_mine_domain_ideas',
+    description: 'Varredura inteligente de código-fonte de aplicação para identificar oportunidades reais de performance, resiliência, arquitetura e contratos, adicionando ao IDEAS.md.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        targetDir: {
+          type: 'string',
+          description: 'Diretório raiz do projeto para varredura (opcional, padrão: diretório atual).'
+        },
+        autoApply: {
+          type: 'boolean',
+          description: 'Se true, sincroniza as oportunidades descobertas diretamente em docs/IDEAS.md.'
+        },
+        dryRun: {
+          type: 'boolean',
+          description: 'Se true, apenas simula a sincronização sem alterar arquivos em disco.'
+        }
+      }
+    }
+  }
+];
+
+const META_TOOLS = [
+  {
+    name: 'agent_governance',
+    description: 'Meta-ferramenta canônica de governança arquitetural, regras de engenharia, credenciais e validação da tríade (sub-ações: get_rule, validate_idea, validate_rule15, smart_onboarding, verify_triad_gate, check_credentials, configure_credentials, set_profile, eval_harness, mine_domain_ideas, recommend_architecture). Economiza tokens de schema ao consolidar o ciclo de governança.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          description: 'Sub-ação de governança a executar',
+          enum: [
+            'get_rule',
+            'validate_idea',
+            'validate_rule15',
+            'smart_onboarding',
+            'verify_triad_gate',
+            'check_credentials',
+            'configure_credentials',
+            'set_profile',
+            'eval_harness',
+            'mine_domain_ideas',
+            'recommend_architecture',
+            'ground_knowledge'
+          ]
+        },
+        ruleNumber: { type: 'integer', description: 'Número do princípio canônico (1 a 10) ou regra legada (1 a 27)' },
+        ideaTitle: { type: 'string', description: 'Título da ideia' },
+        ideaDescription: { type: 'string', description: 'Descrição da proposta' },
+        projectStack: { type: 'string', description: 'Stack tecnológica do projeto real' },
+        projectDomain: { type: 'string', description: 'Propósito/domínio do projeto' },
+        targetDir: { type: 'string', description: 'Diretório alvo do onboarding ou mineração' },
+        mode: { type: 'string', description: 'Modo de onboarding (greenfield, brownfield)' },
+        dryRun: { type: 'boolean', description: 'Execução simulada sem escrita em disco' },
+        strict: { type: 'boolean', description: 'Modo estrito para verificação de tríade' },
+        bypassOffline: { type: 'boolean', description: 'Permitir prosseguir offline' },
+        credentials: { type: 'object', description: 'Objeto com credenciais a configurar' },
+        profile: { type: 'string', description: 'Perfil MCP a ativar' },
+        modelName: { type: 'string', description: 'Nome do modelo avaliado no eval harness' },
+        promptSent: { type: 'string', description: 'Prompt de instrução enviado à LLM' },
+        responseReceived: { type: 'string', description: 'Resposta bruta recebida da LLM' },
+        payload: { type: 'object', description: 'Payload genérico opcional com argumentos da sub-ação' }
+      },
+      required: ['action']
+    }
+  },
+  {
+    name: 'agent_audit',
+    description: 'Meta-ferramenta canônica de auditoria técnica de segurança, qualidade, contratos, conformidade e autocura autônoma (sub-ações: audit_code, sast_scan, audit_quality, audit_dependencies_sca, validate_api_contract, lint_git_hygiene, audit_a11y, remediate_code).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          description: 'Sub-ação de auditoria a executar',
+          enum: [
+            'audit_code',
+            'sast_scan',
+            'audit_quality',
+            'audit_dependencies_sca',
+            'validate_api_contract',
+            'lint_git_hygiene',
+            'audit_a11y',
+            'remediate_code'
+          ]
+        },
+        targetFile: { type: 'string', description: 'Caminho do arquivo a ser remediado na sub-ação remediate_code' },
+        testCommand: { type: 'string', description: 'Comando de teste do host para validação na sub-ação remediate_code' },
+        format: { type: 'string', enum: ['json', 'sarif'], description: 'Formato de relatório para sast_scan e audit_dependencies_sca' },
+        codeDiff: { type: 'string', description: 'Diff ou código a ser auditado' },
+        filePath: { type: 'string', description: 'Caminho do arquivo a ser auditado' },
+        codeContent: { type: 'string', description: 'Conteúdo textual do código a analisar' },
+        packageJsonPath: { type: 'string', description: 'Caminho do package.json para SCA' },
+        dependencies: { type: 'object', description: 'Dicionário de dependências para SCA' },
+        specPath: { type: 'string', description: 'Caminho do manifesto OpenAPI/Swagger' },
+        specContent: { type: 'string', description: 'Conteúdo da especificação OpenAPI' },
+        branchName: { type: 'string', description: 'Nome da branch para validação de higiene git' },
+        commitMessage: { type: 'string', description: 'Mensagem de commit para validação' },
+        htmlContent: { type: 'string', description: 'Markup HTML ou JSX para auditoria a11y' },
+        context: { type: 'string', description: 'Contexto técnico adicional' },
+        payload: { type: 'object', description: 'Payload genérico opcional com argumentos da sub-ação' }
+      },
+      required: ['action']
+    }
+  },
+  {
+    name: 'agent_review',
+    description: 'Meta-ferramenta canônica de revisão adversarial e governança de Pull Requests com cálculo de Blast Radius (sub-ações: review_pr, qa_gate).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          description: 'Sub-ação de revisão (padrão: review_pr)',
+          enum: ['review_pr', 'qa_gate']
+        },
+        prNumber: { type: 'integer', description: 'Número do Pull Request no GitHub' },
+        targetRepo: { type: 'string', description: 'Repositório GitHub (ex: owner/repo)' },
+        token: { type: 'string', description: 'Token de autenticação do GitHub' },
+        codeDiff: { type: 'string', description: 'Diff estático do PR quando avaliado offline' },
+        context: { type: 'string', description: 'Contexto técnico do PR ou ticket' },
+        payload: { type: 'object', description: 'Payload genérico opcional com argumentos da sub-ação' }
+      },
+      required: ['action']
+    }
+  },
+  {
+    name: 'agent_pipeline',
+    description: 'Meta-ferramenta canônica de automação de esteiras, ciclo de vida Full-Dev, integrações Atlassian/Git e scaffolding (sub-ações: sync_atlassian, standardize_kanban, full_dev_pipeline, full_dev_status, scaffold_feature, extract_code_skeleton, export_universal_bundle, compress_context, generate_ide_plugins, bootstrap_environment, generate_magic_prompt).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          description: 'Sub-ação da pipeline a executar',
+          enum: [
+            'sync_atlassian',
+            'standardize_kanban',
+            'full_dev_pipeline',
+            'full_dev_status',
+            'scaffold_feature',
+            'extract_code_skeleton',
+            'export_universal_bundle',
+            'compress_context',
+            'generate_ide_plugins',
+            'bootstrap_environment',
+            'generate_magic_prompt'
+          ]
+        },
+        issueKey: { type: 'string', description: 'Chave da issue Jira (ex: AGDEV-23)' },
+        url: { type: 'string', description: 'URL do commit ou PR para vinculação remota' },
+        title: { type: 'string', description: 'Título do link ou da funcionalidade' },
+        type: { type: 'string', description: 'Tipo do artefato (commit, pr, adr)' },
+        projectKey: { type: 'string', description: 'Chave do projeto Jira' },
+        featureName: { type: 'string', description: 'Nome da feature para scaffolding' },
+        platform: { type: 'string', description: 'Plataforma alvo para exportação (cursor, ollama, etc.)' },
+        targetDir: { type: 'string', description: 'Diretório raiz do projeto' },
+        maxTokens: { type: 'integer', description: 'Orçamento máximo de tokens para compressão' },
+        dryRun: { type: 'boolean', description: 'Modo de simulação sem alteração em disco' },
+        payload: { type: 'object', description: 'Payload genérico opcional com argumentos da sub-ação' }
+      },
+      required: ['action']
+    }
+  },
+  {
+    name: 'agent_telemetry',
+    description: 'Meta-ferramenta canônica de observabilidade, telemetria Prometheus/OTLP, circuit breaker e resiliência SRE (sub-ações: sre_telemetry, sre_remediate, otel_trace, perf_benchmark, circuit_breaker, orchestrate_event, inspector_info).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          description: 'Sub-ação de telemetria a executar',
+          enum: [
+            'sre_telemetry',
+            'sre_remediate',
+            'otel_trace',
+            'perf_benchmark',
+            'circuit_breaker',
+            'orchestrate_event',
+            'inspector_info'
+          ]
+        },
+        operation: { type: 'string', description: 'Operação de telemetria ou benchmark' },
+        serviceName: { type: 'string', description: 'Nome do serviço rastreado' },
+        traceId: { type: 'string', description: 'ID de rastreio W3C' },
+        scenario: { type: 'string', description: 'Cenário de teste de benchmark' },
+        iterations: { type: 'integer', description: 'Número de iterações do benchmark' },
+        state: { type: 'string', description: 'Estado do circuit breaker ou filtro' },
+        eventName: { type: 'string', description: 'Nome do evento no barramento' },
+        eventPayload: { type: 'object', description: 'Dados do evento a ser despachado' },
+        simulate: { type: 'string', description: 'Simulação de falha ou failover' },
+        payload: { type: 'object', description: 'Payload genérico opcional com argumentos da sub-ação' }
+      },
+      required: ['action']
+    }
+  }
+];
+
+const ALL_TOOLS = Object.freeze([...TOOLS, ...META_TOOLS]);
+
+const CONSOLIDATED_TOOLS = Object.freeze([
+  'agent_governance',
+  'agent_audit',
+  'agent_review',
+  'agent_pipeline',
+  'agent_telemetry'
+]);
+
+const TOOL_PROFILES = Object.freeze({
+  all: TOOLS.map(t => t.name),
+  consolidated: CONSOLIDATED_TOOLS,
+  lean: CONSOLIDATED_TOOLS,
+  fast_dev: Object.freeze([
+    'agent_recommend_architecture',
+    'agent_scaffold_feature',
+    'agent_audit_code',
+    'agent_verify_triad_gate',
+    'agent_set_mcp_profile'
+  ]),
+  core: Object.freeze([
+    'agent_get_rule',
+    'agent_recommend_architecture',
+    'agent_validate_idea',
+    'agent_orchestrate_event',
+    'agent_check_credentials',
+    'agent_bootstrap_environment',
+    'agent_compress_context',
+    'agent_full_dev_status',
+    'agent_set_mcp_profile',
+    'agent_smart_onboarding',
+    'agent_verify_triad_gate',
+    'agent_extract_code_skeleton',
+    'agent_scaffold_feature'
+  ]),
+  qa_devsecops: Object.freeze([
+    'agent_audit_code',
+    'agent_review_pr',
+    'agent_sast_scan',
+    'agent_audit_quality',
+    'agent_audit_dependencies_sca',
+    'agent_validate_api_contract',
+    'agent_lint_git_hygiene',
+    'agent_audit_a11y',
+    'agent_remediate_code',
+    'agent_set_mcp_profile'
+  ]),
+  atlassian: Object.freeze([
+    'agent_sync_atlassian',
+    'agent_standardize_kanban',
+    'agent_full_dev_pipeline',
+    'agent_validate_rule15',
+    'agent_configure_credentials',
+    'agent_check_credentials',
+    'agent_set_mcp_profile'
+  ]),
+  sre: Object.freeze([
+    'agent_sre_telemetry',
+    'agent_sre_remediate',
+    'agent_otel_trace',
+    'agent_perf_benchmark',
+    'agent_circuit_breaker',
+    'agent_set_mcp_profile'
+  ]),
+  infra: Object.freeze([
+    'agent_otel_trace',
+    'agent_perf_benchmark',
+    'agent_circuit_breaker',
+    'agent_inspector_info',
+    'agent_check_credentials',
+    'agent_set_mcp_profile'
+  ])
+});
+
+/**
+ * Classe Canônica ToolsRegistry — Catálogo, Validação de Schemas e Gestor de Perfis MCP
+ */
+class ToolsRegistry {
+  constructor(initialProfile = null) {
+    this.activeProfile = initialProfile || process.env.MCP_PROFILE || 'consolidated';
+    this.customTools = new Map();
+    this.customProfiles = new Map();
+  }
+
+  static get TOOLS() {
+    return TOOLS;
+  }
+
+  static get META_TOOLS() {
+    return META_TOOLS;
+  }
+
+  static get ALL_TOOLS() {
+    return ALL_TOOLS;
+  }
+
+  static get TOOL_PROFILES() {
+    return TOOL_PROFILES;
+  }
+
+  static get CONSOLIDATED_TOOLS() {
+    return CONSOLIDATED_TOOLS;
+  }
+
+  getActiveProfile() {
+    return this.activeProfile;
+  }
+
+  getActiveTools() {
+    const profileName = String(this.activeProfile).toLowerCase();
+
+    // 1. Perfis customizados registrados dinamicamente
+    if (this.customProfiles.has(profileName)) {
+      const allowed = this.customProfiles.get(profileName);
+      return this.getAllTools().filter(t => allowed.includes(t.name));
+    }
+
+    // 2. Proteção contra prototype pollution
+    if (!Object.prototype.hasOwnProperty.call(TOOL_PROFILES, profileName)) {
+      return TOOLS;
+    }
+
+    const allowed = TOOL_PROFILES[profileName];
+    return this.getAllTools().filter(t => allowed.includes(t.name));
+  }
+
+  getAllTools() {
+    if (this.customTools.size === 0) {
+      return ALL_TOOLS;
+    }
+    return [...ALL_TOOLS, ...Array.from(this.customTools.values())];
+  }
+
+  setMcpProfile(profile) {
+    if (typeof profile !== 'string' || !profile.trim()) {
+      return {
+        success: false,
+        error: `Perfil inválido: ${profile}. Opções válidas: ${this.listAvailableProfiles().join(', ')}`
+      };
+    }
+
+    const target = profile.trim().toLowerCase();
+    const hasBuiltin = Object.prototype.hasOwnProperty.call(TOOL_PROFILES, target);
+    const hasCustom = this.customProfiles.has(target);
+
+    if (hasBuiltin || hasCustom) {
+      this.activeProfile = target;
+      return {
+        success: true,
+        profile: target,
+        activeToolsCount: this.getActiveTools().length
+      };
+    }
+
+    return {
+      success: false,
+      error: `Perfil inválido: ${profile}. Opções válidas: ${this.listAvailableProfiles().join(', ')}`
+    };
+  }
+
+  listAvailableProfiles() {
+    return [...Object.keys(TOOL_PROFILES), ...Array.from(this.customProfiles.keys())];
+  }
+
+  registerTool(toolDefinition, { profile = null } = {}) {
+    if (!toolDefinition || typeof toolDefinition !== 'object') {
+      throw new Error('Definição da ferramenta deve ser um objeto válido');
+    }
+    if (!toolDefinition.name || typeof toolDefinition.name !== 'string') {
+      throw new Error('A ferramenta deve conter a propriedade "name"');
+    }
+    this.customTools.set(toolDefinition.name, Object.freeze({ ...toolDefinition }));
+    if (profile) {
+      const target = String(profile).toLowerCase();
+      const currentList = this.customProfiles.get(target) || [];
+      if (!currentList.includes(toolDefinition.name)) {
+        this.customProfiles.set(target, [...currentList, toolDefinition.name]);
+      }
+    }
+  }
+
+  registerProfile(profileName, toolNames) {
+    if (!profileName || typeof profileName !== 'string') {
+      throw new Error('Nome do perfil deve ser uma string válida');
+    }
+    if (!Array.isArray(toolNames)) {
+      throw new Error('A lista de ferramentas do perfil deve ser um array');
+    }
+    this.customProfiles.set(profileName.toLowerCase(), [...toolNames]);
+  }
+
+  getTool(name) {
+    if (!name || typeof name !== 'string') return null;
+    if (this.customTools.has(name)) {
+      return this.customTools.get(name);
+    }
+    return ALL_TOOLS.find(t => t.name === name) || null;
+  }
+
+  hasTool(name) {
+    return this.getTool(name) !== null;
+  }
+
+  auditToSarif() {
+    const findings = [];
+    const allTools = this.getAllTools();
+
+    for (const tool of allTools) {
+      if (!tool.name || typeof tool.name !== 'string') {
+        findings.push({
+          ruleId: 'RULE-TOOL-001',
+          severity: 'CRITICAL',
+          filename: 'scripts/mcp/tools_registry.js',
+          line: 1,
+          column: 1,
+          snippet: JSON.stringify(tool).slice(0, 80),
+          message: 'Ferramenta MCP sem propriedade "name" obrigatória.',
+          remediation: 'Definir nome canônico da ferramenta conforme convenção MCP.'
+        });
+      }
+      if (!tool.inputSchema || typeof tool.inputSchema !== 'object' || tool.inputSchema.type !== 'object') {
+        findings.push({
+          ruleId: 'RULE-TOOL-002',
+          severity: 'HIGH',
+          filename: 'scripts/mcp/tools_registry.js',
+          line: 1,
+          column: 1,
+          snippet: `tool: ${tool.name}`,
+          message: `Ferramenta MCP '${tool.name}' possui inputSchema inválido (deve ser type: 'object').`,
+          remediation: 'Corrigir inputSchema para conformidade com JSON Schema.'
+        });
+      }
+    }
+
+    // Validação de integridade dos perfis
+    for (const [pName, pTools] of Object.entries(TOOL_PROFILES)) {
+      for (const tName of pTools) {
+        if (!allTools.some(t => t.name === tName)) {
+          findings.push({
+            ruleId: 'RULE-REG-001',
+            severity: 'HIGH',
+            filename: 'scripts/mcp/tools_registry.js',
+            line: 1,
+            column: 1,
+            snippet: `profile: ${pName} -> ${tName}`,
+            message: `Perfil '${pName}' referencia ferramenta '${tName}' inexistente em ALL_TOOLS.`,
+            remediation: 'Remover a referência órfã ou registrar a ferramenta no catálogo.'
+          });
+        }
+      }
+    }
+
+    return createSarifReport({
+      toolName: 'agent-master-tools-registry',
+      toolVersion: '5.1.0',
+      findings,
+      properties: {
+        activeProfile: this.activeProfile,
+        totalTools: allTools.length,
+        canonicalToolsCount: TOOLS.length,
+        metaToolsCount: META_TOOLS.length,
+        profilesCount: Object.keys(TOOL_PROFILES).length
+      }
+    });
+  }
+
+  formatReport() {
+    const activeTools = this.getActiveTools();
+    const profiles = this.listAvailableProfiles();
+
+    const lines = [
+      '# Relatório Executivo: Catálogo de Ferramentas MCP (tools_registry.js)',
+      '',
+      `- **Perfil Ativo:** \`${this.activeProfile}\``,
+      `- **Ferramentas Ativas no Perfil:** ${activeTools.length}`,
+      `- **Total de Ferramentas Canônicas:** ${TOOLS.length}`,
+      `- **Total de Meta-Ferramentas:** ${META_TOOLS.length}`,
+      `- **Perfis Disponíveis:** ${profiles.join(', ')}`,
+      '',
+      '| Perfil | Quantidade de Ferramentas | Descrição |',
+      '|---|---|---|',
+      `| \`all\` | ${TOOL_PROFILES.all.length} | Todas as ferramentas individuais |`,
+      `| \`consolidated\` | ${TOOL_PROFILES.consolidated.length} | 5 Meta-Ferramentas para economia de tokens |`,
+      `| \`lean\` | ${TOOL_PROFILES.lean.length} | Modo enxuto idêntico a consolidated |`,
+      `| \`fast_dev\` | ${TOOL_PROFILES.fast_dev.length} | Fast-path Dev (arquitetura, scaffold, audit, triad) |`,
+      `| \`core\` | ${TOOL_PROFILES.core.length} | Ferramentas essenciais de arquitetura e governança |`,
+      `| \`qa_devsecops\` | ${TOOL_PROFILES.qa_devsecops.length} | Foco em QA, SAST, SCA e Git Hygiene |`,
+      `| \`atlassian\` | ${TOOL_PROFILES.atlassian.length} | Tríade Jira e Confluence |`,
+      `| \`sre\` | ${TOOL_PROFILES.sre.length} | Telemetria, OTLP e Circuit Breaker |`,
+      `| \`infra\` | ${TOOL_PROFILES.infra.length} | Infraestrutura e networking |`,
+      ''
+    ];
+
+    return lines.join('\n');
+  }
+
+  static getActiveTools() {
+    return defaultToolsRegistryInstance.getActiveTools();
+  }
+
+  static setMcpProfile(profile) {
+    return defaultToolsRegistryInstance.setMcpProfile(profile);
+  }
+
+  static getActiveProfile() {
+    return defaultToolsRegistryInstance.getActiveProfile();
+  }
+
+  static auditToSarif() {
+    return defaultToolsRegistryInstance.auditToSarif();
+  }
+
+  static formatReport() {
+    return defaultToolsRegistryInstance.formatReport();
+  }
+}
+
+// Instância singleton padrão para retrocompatibilidade
+const defaultToolsRegistryInstance = new ToolsRegistry();
+
+function getActiveTools() {
+  return defaultToolsRegistryInstance.getActiveTools();
+}
+
+function setMcpProfile(profile) {
+  return defaultToolsRegistryInstance.setMcpProfile(profile);
+}
+
+function getActiveProfile() {
+  return defaultToolsRegistryInstance.getActiveProfile();
+}
+
+module.exports = {
+  ToolsRegistry,
+  defaultToolsRegistryInstance,
+  TOOLS,
+  META_TOOLS,
+  ALL_TOOLS,
+  TOOL_PROFILES,
+  CONSOLIDATED_TOOLS,
+  getActiveTools,
+  setMcpProfile,
+  getActiveProfile,
+  auditToSarif: () => defaultToolsRegistryInstance.auditToSarif(),
+  formatReport: () => defaultToolsRegistryInstance.formatReport()
+};