mcp-whaileys 1.0.1

package/README.md

@@ -0,0 +1,383 @@
+# MCP Whaileys Context
+
+Servidor MCP (Model Context Protocol) para fornecer contexto completo da biblioteca [Whaileys](https://github.com/canove/whaileys) (WhatsApp) ao assistente de IA.
+
+> O repositório whaileys é baixado automaticamente na primeira execução.
+
+## Funcionalidades
+
+Este servidor implementa análise de AST usando **ts-morph** para extrair declarações exportadas, incluindo:
+
+- **Interfaces** - com propriedades, métodos, call signatures e index signatures
+- **Type Aliases** - com type parameters e definições completas
+- **Enumerations** - com todos os valores
+- **Functions** - com parâmetros, tipos de retorno e documentação
+- **Classes** - com métodos públicos, propriedades e herança
+- **Variables/Constants** - configurações e defaults exportados
+- **Namespaces** - estrutura de namespaces exportados
+- **Re-exports** - análise de re-exportações entre módulos
+
+## Ferramentas Disponíveis
+
+### Ferramentas Básicas
+
+| Ferramenta | Descrição |
+|------------|-----------|
+| `whaileys_estrutura` | Lista a estrutura de arquivos do projeto |
+| `whaileys_ler_arquivo` | Lê conteúdo de arquivo específico |
+| `whaileys_extrair_tipos` | Extrai todas as declarações via AST |
+| `whaileys_buscar_tipo` | Busca definição de tipo por nome exato |
+| `whaileys_buscar_fuzzy` | Busca com correspondência aproximada |
+| `whaileys_listar_exports` | Lista todos os exports agrupados |
+
+### Ferramentas por Categoria
+
+| Ferramenta | Descrição |
+|------------|-----------|
+| `whaileys_categorias` | Lista declarações de categoria específica |
+| `whaileys_interfaces` | Lista todas as interfaces |
+| `whaileys_funcoes` | Lista todas as funções |
+| `whaileys_enums` | Lista todas as enumerações |
+| `whaileys_constantes` | Lista constantes e variáveis |
+
+### Ferramentas de Análise
+
+| Ferramenta | Descrição |
+|------------|-----------|
+| `whaileys_estatisticas` | Estatísticas detalhadas da biblioteca |
+| `whaileys_hierarquia` | Mostra herança (extends/implements) |
+| `whaileys_dependencias` | Analisa dependências entre módulos |
+
+### Ferramentas de Auto-Update
+
+| Ferramenta | Descrição |
+|------------|-----------|
+| `whaileys_check_updates` | Verifica se há atualizações disponíveis no GitHub |
+| `whaileys_update` | Atualiza o repositório local para a versão mais recente |
+| `whaileys_status` | Mostra status atual do repositório (commits, sincronização) |
+
+## Categorias Suportadas
+
+```
+interface   - Interfaces TypeScript
+type        - Type Aliases
+enum        - Enumerations
+function    - Funções exportadas
+class       - Classes exportadas
+variable    - Constantes e variáveis
+namespace   - Namespaces
+re-export   - Re-exportações
+```
+
+## Instalação
+
+### Opção 1: Via npx (recomendado)
+
+Sem instalação prévia, use diretamente no VSCode:
+
+```json
+{
+  "servers": {
+    "whaileys-context": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "mcp-whaileys"]
+    }
+  }
+}
+```
+
+### Opção 2: Instalação global
+
+```bash
+npm install -g mcp-whaileys
+```
+
+```json
+{
+  "servers": {
+    "whaileys-context": {
+      "type": "stdio",
+      "command": "mcp-whaileys"
+    }
+  }
+}
+```
+
+### Opção 3: Repositório local
+
+```bash
+git clone https://github.com/SEU_USUARIO/mcp-whaileys.git
+cd mcp-whaileys
+npm install
+npm run build
+```
+
+```json
+{
+  "servers": {
+    "whaileys-context": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["d:/caminho/para/mcp-whaileys/dist/index.js"]
+    }
+  }
+}
+```
+
+## Onde fica o repositório Whaileys?
+
+Na primeira execução, o MCP baixa automaticamente o repositório para:
+
+- **Windows:** `C:\Users\SEU_USUARIO\.mcp-whaileys\whaileys`
+- **Linux/Mac:** `~/.mcp-whaileys/whaileys`
+
+Para usar um caminho personalizado, defina `WHAILEYS_PATH`:
+
+```json
+{
+  "servers": {
+    "whaileys-context": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "mcp-whaileys"],
+      "env": {
+        "WHAILEYS_PATH": "d:/meu/caminho/whaileys/src"
+      }
+    }
+  }
+}
+```
+
+## Variáveis de Ambiente
+
+| Variável | Descrição | Default |
+|----------|-----------|---------|
+| `WHAILEYS_PATH` | Caminho para o diretório `src/` do Whaileys | Auto-download em `~/.mcp-whaileys/` |
+| `AUTO_UPDATE_ENABLED` | Habilita verificação automática de atualizações | `true` |
+| `AUTO_UPDATE_INTERVAL` | Intervalo de verificação em ms | `3600000` (1 hora) |
+| `GITHUB_TOKEN` | Token do GitHub para evitar rate limiting | - |
+
+## Exemplos de Configuração
+
+### Configuração mínima (usa auto-download)
+
+```json
+{
+  "whaileys-context": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "mcp-whaileys"]
+  }
+}
+```
+
+### Configuração com path local existente
+
+```json
+{
+  "whaileys-context": {
+    "type": "stdio",
+    "command": "node",
+    "args": ["/caminho/para/mcp-whaileys/dist/index.js"],
+    "env": {
+      "WHAILEYS_PATH": "/caminho/para/whaileys/src"
+    }
+  }
+}
+```
+
+### Configuração completa
+
+```json
+{
+  "whaileys-context": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "mcp-whaileys"],
+    "env": {
+      "AUTO_UPDATE_ENABLED": "true",
+        "AUTO_UPDATE_INTERVAL": "3600000"
+      }
+    }
+  }
+}
+```
+
+## Exemplos de Uso
+
+### Extrair todos os tipos do módulo Types
+
+```javascript
+whaileys_extrair_tipos({ modulo: "Types" })
+```
+
+### Filtrar apenas interfaces do módulo Types
+
+```javascript
+whaileys_extrair_tipos({ modulo: "Types", apenas_kind: "interface" })
+```
+
+### Buscar tipo específico
+
+```javascript
+whaileys_buscar_tipo({ nome: "WAMessage" })
+```
+
+### Busca fuzzy quando não sabe o nome exato
+
+```javascript
+whaileys_buscar_fuzzy({ query: "message send auth" })
+```
+
+### Ver todas as funções do módulo Utils
+
+```javascript
+whaileys_funcoes({ modulo: "Utils" })
+```
+
+### Listar constantes de configuração
+
+```javascript
+whaileys_constantes({ modulo: "Defaults" })
+```
+
+### Ver hierarquia de um tipo
+
+```javascript
+whaileys_hierarquia({ nome: "BaileysEventEmitter" })
+```
+
+### Estatísticas completas da biblioteca
+
+```javascript
+whaileys_estatisticas()
+```
+
+### Análise de dependências
+
+```javascript
+whaileys_dependencias()
+```
+
+## Estrutura de Dados
+
+### ExtractedType
+
+```typescript
+interface ExtractedType {
+  name: string              // Nome da declaração
+  kind: ExtractedKind       // Tipo (interface, type, enum, etc.)
+  exported: boolean         // Se é exportado
+  file: string              // Arquivo fonte
+  module: string            // Módulo (Types, Socket, Utils, etc.)
+  signature: string         // Assinatura TypeScript
+  fullSignature?: string    // Assinatura completa (para types)
+  properties?: PropertyInfo[] // Propriedades (interfaces/classes)
+  methods?: PropertyInfo[]  // Métodos (interfaces/classes)
+  members?: string[]        // Membros (enums/namespaces)
+  typeParameters?: TypeParameter[] // Generics
+  extends?: string[]        // Herança
+  implements?: string[]     // Implementações
+  docs?: string             // Documentação JSDoc
+  value?: string            // Valor (variáveis)
+  lineNumber?: number       // Linha no arquivo
+}
+```
+
+### PropertyInfo
+
+```typescript
+interface PropertyInfo {
+  name: string
+  type: string
+  optional: boolean
+  readonly: boolean
+  docs?: string
+  isMethod: boolean
+  isCallSignature: boolean
+  isIndexSignature: boolean
+  parameters?: string[]
+  returnType?: string
+}
+```
+
+## Estatísticas da Biblioteca
+
+O servidor pode gerar estatísticas detalhadas incluindo:
+
+- **Total de declarações** por categoria
+- **Contagem por módulo** (Types, Socket, Utils, etc.)
+- **Top interfaces, types e funções**
+- **Percentuais de distribuição**
+
+## Recursos Disponíveis
+
+O servidor também expõe recursos via MCP Resources:
+
+| URI | Descrição |
+|-----|-----------|
+| `whaileys://readme` | README da biblioteca |
+| `whaileys://types-index` | Index de tipos exportados |
+| `whaileys://statistics` | Estatísticas da biblioteca |
+
+## Tecnologias
+
+- **@modelcontextprotocol/sdk** v1.24.3 - SDK oficial do MCP
+- **ts-morph** v27.0.2 - Parser de AST para TypeScript
+- **zod** v4.1.13 - Validação de schemas
+
+## Sistema de Auto-Update
+
+O MCP Whaileys possui um sistema integrado de auto-atualização que monitora o repositório oficial `canove/whaileys` no GitHub.
+
+### Como funciona
+
+1. **Na inicialização**: O servidor verifica se há atualizações disponíveis
+2. **Periodicamente**: A cada intervalo configurado (default: 1 hora), verifica novos commits
+3. **Automaticamente**: Quando detecta uma atualização, executa `git pull` automaticamente
+4. **Cache de SHA**: Mantém um registro do último commit verificado para otimizar chamadas à API
+
+### Fluxo de atualização
+
+```mermaid
+flowchart TD
+    A[GitHub API<br>/repos/canove/whaileys/commits] --> B[Compara SHA<br>Local vs Remoto]
+    B --> C{SHA diferente?}
+    C -->|Sim| D[git pull]
+    C -->|Não| E[OK - Sem alterações]
+    D --> F[Atualiza contexto]
+    F --> G[Salva novo SHA no cache]
+```
+
+### Comandos manuais
+
+```javascript
+// Verificar se há atualizações (sem aplicar)
+whaileys_check_updates()
+
+// Aplicar atualizações disponíveis
+whaileys_update()
+
+// Ver status atual do repositório
+whaileys_status()
+```
+
+### Logs
+
+O servidor emite logs durante o processo de atualização:
+
+```
+[INFO] Auto-update habilitado (intervalo: 60 min)
+[INFO] Verificando atualizações...
+[OK] Atualizado para: ea7f714
+      Commit: Merge pull request #56 from canove/develop
+```
+
+### Rate Limiting do GitHub
+
+A API do GitHub possui limites de requisições:
+- **Sem token**: 60 requests/hora
+- **Com token**: 5000 requests/hora
+
+Para ambientes de produção, configure `GITHUB_TOKEN` para evitar rate limiting.

package/dist/ast-parser.d.ts

@@ -0,0 +1,106 @@
+export type ExtractedKind = 'interface' | 'type' | 'enum' | 'function' | 'class' | 'variable' | 'namespace' | 're-export';
+export interface PropertyInfo {
+    name: string;
+    type: string;
+    optional: boolean;
+    readonly: boolean;
+    docs?: string;
+    isMethod: boolean;
+    isCallSignature: boolean;
+    isIndexSignature: boolean;
+    parameters?: string[];
+    returnType?: string;
+}
+export interface TypeParameter {
+    name: string;
+    constraint?: string;
+    default?: string;
+}
+export interface ExtractedType {
+    name: string;
+    kind: ExtractedKind;
+    exported: boolean;
+    file: string;
+    module: string;
+    signature: string;
+    fullSignature?: string;
+    properties?: PropertyInfo[];
+    methods?: PropertyInfo[];
+    members?: string[];
+    typeParameters?: TypeParameter[];
+    extends?: string[];
+    implements?: string[];
+    docs?: string;
+    value?: string;
+    reExportSource?: string;
+    lineNumber?: number;
+}
+export interface ModuleStatistics {
+    module: string;
+    interfaces: number;
+    types: number;
+    enums: number;
+    functions: number;
+    classes: number;
+    variables: number;
+    namespaces: number;
+    reExports: number;
+    total: number;
+}
+export interface LibraryStatistics {
+    totalDeclarations: number;
+    byKind: Record<ExtractedKind, number>;
+    byModule: ModuleStatistics[];
+    topInterfaces: string[];
+    topTypes: string[];
+    topFunctions: string[];
+}
+export interface DependencyInfo {
+    module: string;
+    imports: string[];
+    exports: string[];
+    reExportsFrom: string[];
+}
+export declare class AstParser {
+    private project;
+    private whaileysSrcPath;
+    private cachedTypes;
+    constructor(whaileysSrcPath: string);
+    private getModuleName;
+    private getRelativePath;
+    addSourceFiles(patterns: string[]): void;
+    extractFromFile(filePath: string): ExtractedType[];
+    extractAllTypes(): ExtractedType[];
+    private extractTypes;
+    private extractTypeParameters;
+    private extractInterface;
+    private extractTypeAlias;
+    private extractEnum;
+    private extractFunction;
+    private extractClass;
+    private extractVariable;
+    private extractNamespace;
+    private extractReExport;
+    private simplifyType;
+    private getJsDocs;
+    searchType(typeName: string): ExtractedType | undefined;
+    fuzzySearch(query: string, maxResults?: number): ExtractedType[];
+    getTypesFromModule(moduleName: string): ExtractedType[];
+    getTypesByKind(kind: ExtractedKind): ExtractedType[];
+    getStatistics(): LibraryStatistics;
+    getTypeHierarchy(typeName: string): {
+        type: ExtractedType;
+        parents: string[];
+        children: string[];
+    } | null;
+    analyzeDependencies(): DependencyInfo[];
+    getVariables(): ExtractedType[];
+    getConstants(): ExtractedType[];
+    getNamespaces(): ExtractedType[];
+    getInterfaces(): ExtractedType[];
+    getEnums(): ExtractedType[];
+    getFunctions(): ExtractedType[];
+    getClasses(): ExtractedType[];
+    getTypes(): ExtractedType[];
+}
+//# sourceMappingURL=ast-parser.d.ts.map

package/dist/ast-parser.d.ts.map

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