@justmpm/ai-tool 0.2.0 → 0.3.1

package/dist/cli.js

@@ -1,33 +1,41 @@
 #!/usr/bin/env node
 import {
   VERSION,
+  context,
   dead,
   deadFix,
   impact,
-  map
-} from "./chunk-HOVHD2N4.js";
+  map,
+  suggest
+} from "./chunk-4HXWM7PK.js";
 
 // src/cli.ts
 var HELP = `
-ai-tool v${VERSION} - An\xE1lise de depend\xEAncias e impacto
+ai-tool v${VERSION} - Analise de dependencias e impacto
 
 COMANDOS:
   map                    Mapa completo do projeto (usa Skott)
-  dead                   Detecta c\xF3digo morto (usa Knip)
-  dead --fix             Remove c\xF3digo morto automaticamente
-  impact <arquivo>       An\xE1lise de impacto antes de modificar
+  dead                   Detecta codigo morto (usa Knip)
+  dead --fix             Remove codigo morto automaticamente
+  impact <arquivo>       Analise de impacto antes de modificar
+  suggest <arquivo>      Sugere arquivos para ler antes de modificar
+  context <arquivo>      Extrai assinaturas de um arquivo (funcoes, tipos)
 
-OP\xC7\xD5ES:
-  --format=text|json     Formato de sa\xEDda (default: text)
-  --cwd=<path>           Diret\xF3rio do projeto (default: cwd)
-  --no-cache             Ignora cache e for\xE7a regenera\xE7\xE3o
+MODOS:
+  --mcp                  Inicia servidor MCP para integracao com Claude Desktop
+
+OPCOES:
+  --format=text|json     Formato de saida (default: text)
+  --cwd=<path>           Diretorio do projeto (default: cwd)
+  --no-cache             Ignora cache e forca regeneracao
+  --limit=<n>            Limite de sugestoes (default: 10, apenas suggest)
   --help, -h             Mostra esta ajuda
-  --version, -v          Mostra vers\xE3o
+  --version, -v          Mostra versao
 
 CACHE:
-  Resultados s\xE3o salvos em .analyze/ para acelerar execu\xE7\xF5es futuras.
-  O cache \xE9 invalidado automaticamente quando arquivos mudam.
-  Use --no-cache para for\xE7ar regenera\xE7\xE3o.
+  Resultados sao salvos em .analyze/ para acelerar execucoes futuras.
+  O cache e invalidado automaticamente quando arquivos mudam.
+  Use --no-cache para forcar regeneracao.
 
 EXEMPLOS:
   ai-tool map
@@ -38,10 +46,15 @@ EXEMPLOS:
   ai-tool impact Button
   ai-tool impact src/hooks/useAuth.ts
   ai-tool impact src/components/Header.tsx --format=json
+  ai-tool suggest Button
+  ai-tool suggest src/hooks/useAuth.ts --limit=5
+  ai-tool context Button
+  ai-tool context src/hooks/useAuth.ts --format=json
+  ai-tool --mcp
 
 SOBRE:
   Criado por Koda AI Studio (kodaai.app)
-  Usa Skott para an\xE1lise de depend\xEAncias e Knip para dead code detection.
+  Usa Skott para analise de dependencias e Knip para dead code detection.
 `;
 async function main() {
   const args = process.argv.slice(2);
@@ -58,6 +71,11 @@ async function main() {
       positional.push(arg);
     }
   }
+  if (flags.mcp) {
+    const { startMcpServer } = await import("./server-YV4BWISA.js");
+    await startMcpServer();
+    return;
+  }
   if (flags.help || flags.h || positional.length === 0) {
     console.log(HELP);
     process.exit(0);
@@ -93,6 +111,29 @@ async function main() {
         }
         result = await impact(target, { format, cwd, cache });
         break;
+      case "suggest":
+        if (!target) {
+          console.error("\u274C Erro: arquivo alvo \xE9 obrigat\xF3rio para o comando suggest");
+          console.error("   Exemplo: ai-tool suggest src/components/Button.tsx");
+          console.error("   Exemplo: ai-tool suggest Button");
+          process.exit(1);
+        }
+        result = await suggest(target, {
+          format,
+          cwd,
+          cache,
+          limit: flags.limit ? Number(flags.limit) : void 0
+        });
+        break;
+      case "context":
+        if (!target) {
+          console.error("\u274C Erro: arquivo alvo \xE9 obrigat\xF3rio para o comando context");
+          console.error("   Exemplo: ai-tool context src/components/Button.tsx");
+          console.error("   Exemplo: ai-tool context Button");
+          process.exit(1);
+        }
+        result = await context(target, { format, cwd });
+        break;
       default:
         console.error(`\u274C Comando desconhecido: ${command}`);
         console.error("   Use 'ai-tool --help' para ver comandos dispon\xEDveis.");

package/dist/index.d.ts

@@ -95,6 +95,61 @@ interface ImpactResult {
     risks: RiskInfo[];
     suggestions: string[];
 }
+interface SuggestOptions extends CommandOptions {
+    limit?: number;
+}
+type SuggestionPriority = "critical" | "high" | "medium" | "low";
+interface Suggestion {
+    path: string;
+    category: FileCategory;
+    reason: string;
+    priority: SuggestionPriority;
+}
+interface SuggestResult {
+    version: string;
+    timestamp: string;
+    target: string;
+    category: FileCategory;
+    suggestions: Suggestion[];
+}
+interface ContextOptions extends CommandOptions {
+    depth?: number;
+}
+interface ImportInfo {
+    source: string;
+    specifiers: string[];
+    isTypeOnly: boolean;
+}
+type ParamInfo = {
+    name: string;
+    type: string;
+};
+interface FunctionInfo {
+    name: string;
+    params: ParamInfo[];
+    returnType: string;
+    isAsync: boolean;
+    isExported: boolean;
+    isArrowFunction: boolean;
+    jsdoc?: string;
+}
+type TypeKind = "interface" | "type" | "enum";
+interface TypeInfo {
+    name: string;
+    kind: TypeKind;
+    definition: string;
+    isExported: boolean;
+}
+interface ContextResult {
+    version: string;
+    timestamp: string;
+    file: string;
+    category: FileCategory;
+    imports: ImportInfo[];
+    exports: string[];
+    functions: FunctionInfo[];
+    types: TypeInfo[];
+}
 
 /**
  * Comando MAP - Mapa do projeto usando Skott
@@ -127,6 +182,24 @@ declare function deadFix(options?: DeadOptions): Promise<string>;
  */
 declare function impact(target: string, options?: ImpactOptions): Promise<string>;
 
+/**
+ * Comando SUGGEST - Sugere arquivos para ler antes de modificar um arquivo
+ */
+
+/**
+ * Executa o comando SUGGEST
+ */
+declare function suggest(target: string, options?: SuggestOptions): Promise<string>;
+
+/**
+ * Comando CONTEXT - Extrai assinaturas de funcoes e tipos de um arquivo
+ */
+
+/**
+ * Executa o comando CONTEXT
+ */
+declare function context(target: string, options?: ContextOptions): Promise<string>;
+
 /**
  * Utilitários para detecção e classificação de arquivos
  */
@@ -181,6 +254,6 @@ declare function invalidateCache(cwd: string): void;
  * ```
  */
 
-declare const VERSION = "0.2.0";
+declare const VERSION = "0.3.1";
 
-export { type CommandOptions, type DeadFile, type DeadOptions, type DeadResult, type FileCategory, type FileInfo, type FolderStats, type ImpactFile, type ImpactOptions, type ImpactResult, type MapOptions, type MapResult, type OutputFormat, type RiskInfo, VERSION, categoryIcons, dead, deadFix, detectCategory, getCacheDir, impact, invalidateCache, isCacheValid, isCodeFile, isEntryPoint, map };
+export { type CommandOptions, type ContextOptions, type ContextResult, type DeadFile, type DeadOptions, type DeadResult, type FileCategory, type FileInfo, type FolderStats, type FunctionInfo, type ImpactFile, type ImpactOptions, type ImpactResult, type ImportInfo, type MapOptions, type MapResult, type OutputFormat, type ParamInfo, type RiskInfo, type SuggestOptions, type SuggestResult, type Suggestion, type SuggestionPriority, type TypeInfo, type TypeKind, VERSION, categoryIcons, context, dead, deadFix, detectCategory, getCacheDir, impact, invalidateCache, isCacheValid, isCodeFile, isEntryPoint, map, suggest };

package/dist/index.js

@@ -1,6 +1,7 @@
 import {
   VERSION,
   categoryIcons,
+  context,
   dead,
   deadFix,
   detectCategory,
@@ -10,11 +11,13 @@ import {
   isCacheValid,
   isCodeFile,
   isEntryPoint,
-  map
-} from "./chunk-HOVHD2N4.js";
+  map,
+  suggest
+} from "./chunk-4HXWM7PK.js";
 export {
   VERSION,
   categoryIcons,
+  context,
   dead,
   deadFix,
   detectCategory,
@@ -24,5 +27,6 @@ export {
   isCacheValid,
   isCodeFile,
   isEntryPoint,
-  map
+  map,
+  suggest
 };

package/dist/server-YV4BWISA.js

@@ -0,0 +1,343 @@
+import {
+  VERSION,
+  context,
+  dead,
+  impact,
+  map,
+  suggest
+} from "./chunk-4HXWM7PK.js";
+
+// src/mcp/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+var server = new McpServer({
+  name: "ai-tool-mcp-server",
+  version: VERSION
+});
+server.registerTool(
+  "aitool_project_map",
+  {
+    title: "Project Map",
+    description: `Gera um mapa completo do projeto com categorias de arquivos e estrutura de pastas.
+
+FUNCIONALIDADES:
+- Lista todos os arquivos TypeScript/JavaScript do projeto
+- Categoriza automaticamente: page, layout, route, component, hook, service, store, util, type, config, test
+- Agrupa estatisticas por pasta
+- Detecta dependencias circulares
+
+PARAMETROS:
+- format: "text" (legivel) ou "json" (estruturado)
+- cwd: Diretorio do projeto (default: diretorio atual)
+
+RETORNA:
+- Sumario com total de arquivos e pastas
+- Distribuicao por categoria
+- Lista de pastas com contagem
+- Lista de arquivos com categoria
+- Dependencias circulares detectadas
+
+EXEMPLO DE USO:
+Chamar para entender a estrutura de um projeto antes de modificar.`,
+    inputSchema: {
+      format: z.enum(["text", "json"]).default("text").describe("Formato de saida: text (legivel) ou json (estruturado)"),
+      cwd: z.string().optional().describe("Diretorio do projeto a analisar")
+    },
+    annotations: {
+      title: "Project Map",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
+  async (params) => {
+    try {
+      const result = await map({
+        format: params.format,
+        cwd: params.cwd
+      });
+      return { content: [{ type: "text", text: result }] };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Erro ao executar map: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+);
+server.registerTool(
+  "aitool_dead_code",
+  {
+    title: "Dead Code Detector",
+    description: `Detecta codigo morto no projeto usando Knip.
+
+DETECTA:
+- Arquivos orfaos (nao importados por ninguem)
+- Exports nao utilizados
+- Dependencias npm nao usadas
+
+PARAMETROS:
+- format: "text" (legivel) ou "json" (estruturado)
+- cwd: Diretorio do projeto (default: diretorio atual)
+
+RETORNA:
+- Sumario com total de codigo morto por tipo
+- Lista de arquivos orfaos com categoria
+- Lista de exports nao usados (arquivo + nome)
+- Lista de dependencias npm nao usadas
+
+EXEMPLO DE USO:
+Chamar periodicamente para manter o projeto limpo.
+Chamar antes de refatoracoes para identificar codigo removivel.
+
+NOTA: Requer que o projeto tenha knip configurado ou use defaults.`,
+    inputSchema: {
+      format: z.enum(["text", "json"]).default("text").describe("Formato de saida: text (legivel) ou json (estruturado)"),
+      cwd: z.string().optional().describe("Diretorio do projeto a analisar")
+    },
+    annotations: {
+      title: "Dead Code Detector",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
+  async (params) => {
+    try {
+      const result = await dead({
+        format: params.format,
+        cwd: params.cwd
+      });
+      return { content: [{ type: "text", text: result }] };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Erro ao executar dead: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+);
+server.registerTool(
+  "aitool_impact_analysis",
+  {
+    title: "Impact Analysis",
+    description: `Analisa o impacto de modificar um arquivo especifico.
+
+ANALISA:
+- UPSTREAM: Quem importa este arquivo (direto e indireto)
+- DOWNSTREAM: O que este arquivo importa (direto e indireto)
+- RISCOS: Arquivo critico, dependencias circulares, cadeia profunda
+- SUGESTOES: O que verificar antes de modificar
+
+PARAMETROS:
+- target: Nome ou caminho do arquivo a analisar (obrigatorio)
+- format: "text" (legivel) ou "json" (estruturado)
+- cwd: Diretorio do projeto (default: diretorio atual)
+
+O TARGET pode ser:
+- Caminho completo: "src/components/Button.tsx"
+- Caminho parcial: "components/Button"
+- Nome do arquivo: "Button"
+
+RETORNA:
+- Categoria do arquivo target
+- Lista de arquivos upstream (quem importa)
+- Lista de arquivos downstream (o que importa)
+- Alertas de risco com severidade
+- Sugestoes de como proceder
+
+EXEMPLO DE USO:
+Chamar ANTES de modificar um arquivo para entender o impacto.
+Usar para planejar refatoracoes seguras.`,
+    inputSchema: {
+      target: z.string().min(1).describe(
+        "Arquivo a analisar: caminho completo, parcial ou nome do arquivo"
+      ),
+      format: z.enum(["text", "json"]).default("text").describe("Formato de saida: text (legivel) ou json (estruturado)"),
+      cwd: z.string().optional().describe("Diretorio do projeto a analisar")
+    },
+    annotations: {
+      title: "Impact Analysis",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
+  async (params) => {
+    try {
+      const result = await impact(params.target, {
+        format: params.format,
+        cwd: params.cwd
+      });
+      return { content: [{ type: "text", text: result }] };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Erro ao executar impact: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+);
+server.registerTool(
+  "aitool_suggest_reads",
+  {
+    title: "Suggest Files to Read",
+    description: `Sugere arquivos que devem ser lidos ANTES de modificar um arquivo especifico.
+
+PRIORIZA (nesta ordem):
+1. CRITICAL: Arquivos de tipos/interfaces usados pelo target
+2. HIGH: Dependencias diretas (arquivos importados pelo target)
+3. MEDIUM: Upstream (arquivos que importam o target)
+4. LOW: Testes relacionados
+
+PARAMETROS:
+- target: Nome ou caminho do arquivo que sera modificado (obrigatorio)
+- limit: Numero maximo de sugestoes (default: 10, max: 50)
+- cwd: Diretorio do projeto (default: diretorio atual)
+
+O TARGET pode ser:
+- Caminho completo: "src/components/Button.tsx"
+- Caminho parcial: "components/Button"
+- Nome do arquivo: "Button"
+
+RETORNA:
+- Lista ordenada de arquivos para ler
+- Cada sugestao tem: path, categoria, razao, prioridade
+
+EXEMPLO DE USO:
+Chamar ANTES de modificar um arquivo para saber o que ler primeiro.
+Util para entender o contexto completo antes de fazer mudancas.`,
+    inputSchema: {
+      target: z.string().min(1).describe(
+        "Arquivo que sera modificado: caminho completo, parcial ou nome"
+      ),
+      limit: z.number().int().min(1).max(50).default(10).describe("Numero maximo de sugestoes (default: 10)"),
+      cwd: z.string().optional().describe("Diretorio do projeto a analisar")
+    },
+    annotations: {
+      title: "Suggest Files to Read",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
+  async (params) => {
+    try {
+      const result = await suggest(params.target, {
+        limit: params.limit,
+        cwd: params.cwd,
+        format: "text"
+      });
+      return { content: [{ type: "text", text: result }] };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Erro ao executar suggest: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+);
+server.registerTool(
+  "aitool_file_context",
+  {
+    title: "Extract File Context",
+    description: `Extrai assinaturas de funcoes e tipos de um arquivo SEM a implementacao.
+
+EXTRAI:
+- IMPORTS: Todos os imports com specifiers e se sao type-only
+- EXPORTS: Lista de tudo que e exportado
+- FUNCOES: Nome, parametros (com tipos), retorno, async, arrow, JSDoc
+- TIPOS: Interfaces, types e enums com suas definicoes completas
+
+NAO INCLUI:
+- Corpo das funcoes (implementacao)
+- Logica interna
+- Comentarios inline
+
+PARAMETROS:
+- target: Nome ou caminho do arquivo (obrigatorio)
+- cwd: Diretorio do projeto (default: diretorio atual)
+
+O TARGET pode ser:
+- Caminho completo: "src/components/Button.tsx"
+- Caminho parcial: "components/Button"
+- Nome do arquivo: "Button"
+
+RETORNA:
+- Arquivo com categoria detectada
+- Lista de imports estruturada
+- Lista de exports
+- Lista de funcoes com assinaturas completas
+- Lista de tipos com definicoes
+
+EXEMPLO DE USO:
+Chamar para entender a API publica de um arquivo antes de usa-lo.
+Util para saber quais funcoes/tipos um arquivo exporta.
+Eficiente: retorna apenas assinaturas, nao o codigo completo.`,
+    inputSchema: {
+      target: z.string().min(1).describe(
+        "Arquivo para extrair contexto: caminho completo, parcial ou nome"
+      ),
+      cwd: z.string().optional().describe("Diretorio do projeto a analisar")
+    },
+    annotations: {
+      title: "Extract File Context",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
+  async (params) => {
+    try {
+      const result = await context(params.target, {
+        cwd: params.cwd,
+        format: "text"
+      });
+      return { content: [{ type: "text", text: result }] };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Erro ao executar context: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+);
+async function startMcpServer() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`[ai-tool] MCP server v${VERSION} running via stdio`);
+}
+export {
+  startMcpServer
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justmpm/ai-tool",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Ferramenta de análise de dependências e impacto para projetos TypeScript/JavaScript. Usa Skott + Knip internamente.",
   "keywords": [
     "dependency-analysis",
@@ -43,8 +43,11 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
     "knip": "^5.44.0",
-    "skott": "^0.35.2"
+    "skott": "^0.35.2",
+    "ts-morph": "^27.0.2",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "^22.15.21",