@justmpm/ai-tool 0.5.4 → 0.6.0

package/dist/cli.js

@@ -1,7 +1,11 @@
 #!/usr/bin/env node
+import {
+  find
+} from "./chunk-M7JM3XRW.js";
 import {
   VERSION,
   area,
+  areaContext,
   areas,
   areasInit,
   context,
@@ -10,7 +14,7 @@ import {
   impact,
   map,
   suggest
-} from "./chunk-PHTWZ2JT.js";
+} from "./chunk-UDT7TLSN.js";
 
 // src/cli.ts
 var HELP = `
@@ -24,6 +28,8 @@ COMANDOS:
   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)
+  context --area=<nome>  Contexto consolidado de toda uma area
+  find <termo>           Busca simbolos no codigo (funcoes, tipos, etc)
 
 AREAS:
   areas                  Lista todas as areas/dominios do projeto
@@ -33,6 +39,13 @@ AREAS:
   area <nome> --type=hook   Filtra por categoria
   area <nome> --full     Mostra todos os arquivos
 
+BUSCA (find):
+  find <termo>           Busca definicao + usos de um simbolo
+  find <termo> --type=function|type|const|component|hook
+  find <termo> --area=auth   Busca apenas em uma area
+  find <termo> --def     Mostra apenas definicoes
+  find <termo> --refs    Mostra apenas referencias/usos
+
 MODOS:
   --mcp                  Inicia servidor MCP para integracao com Claude Desktop
 
@@ -41,8 +54,11 @@ OPCOES:
   --cwd=<path>           Diretorio do projeto (default: cwd)
   --no-cache             Ignora cache e forca regeneracao
   --limit=<n>            Limite de sugestoes (default: 10, apenas suggest)
-  --type=<categoria>     Filtra por categoria (apenas area)
+  --type=<categoria>     Filtra por categoria (area) ou tipo de simbolo (find)
   --full                 Lista completa (map: lista arquivos, area: todos arquivos)
+  --area=<nome>          Filtra por area (find, context)
+  --def                  Apenas definicoes (find)
+  --refs                 Apenas referencias (find)
   --help, -h             Mostra esta ajuda
   --version, -v          Mostra versao
 
@@ -54,17 +70,18 @@ CACHE:
 EXEMPLOS:
   ai-tool map                      # Resumo compacto
   ai-tool map --full               # Lista completa de arquivos
-  ai-tool map --format=json
   ai-tool dead
   ai-tool dead --fix
   ai-tool impact Button
   ai-tool suggest Button --limit=5
   ai-tool context Button
+  ai-tool context --area=auth      # Contexto de toda a area auth
+  ai-tool find useAuth             # Busca definicao e usos
+  ai-tool find User --type=type    # Busca apenas tipos
+  ai-tool find login --area=auth   # Busca na area auth
   ai-tool areas
-  ai-tool areas init
   ai-tool area auth
   ai-tool area auth --type=hook
-  ai-tool area dashboard --full
   ai-tool --mcp
 
 SOBRE:
@@ -87,7 +104,7 @@ async function main() {
     }
   }
   if (flags.mcp) {
-    const { startMcpServer } = await import("./server-NIEAOPLJ.js");
+    const { startMcpServer } = await import("./server-VKLU25E2.js");
     await startMcpServer();
     return;
   }
@@ -141,14 +158,37 @@ async function main() {
         });
         break;
       case "context":
+        if (flags.area) {
+          result = await areaContext(flags.area, { format, cwd, cache });
+          break;
+        }
         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");
+          console.error("   Exemplo: ai-tool context --area=auth");
           process.exit(1);
         }
         result = await context(target, { format, cwd });
         break;
+      case "find":
+        if (!target) {
+          console.error("\u274C Erro: termo de busca \xE9 obrigat\xF3rio para o comando find");
+          console.error("   Exemplo: ai-tool find useAuth");
+          console.error("   Exemplo: ai-tool find User --type=type");
+          console.error("   Exemplo: ai-tool find login --area=auth");
+          process.exit(1);
+        }
+        result = await find(target, {
+          format,
+          cwd,
+          cache,
+          type: flags.type,
+          area: flags.area,
+          def: !!flags.def,
+          refs: !!flags.refs
+        });
+        break;
       case "areas":
         if (target === "init") {
           result = await areasInit({ cwd, force: !!flags.force });

package/dist/index.d.ts

@@ -264,6 +264,7 @@ declare function suggest(target: string, options?: SuggestOptions): Promise<stri
 
 /**
  * Comando CONTEXT - Extrai assinaturas de funcoes e tipos de um arquivo
+ * Também suporta --area para contexto consolidado de toda uma área
  */
 
 /**

package/dist/index.js

@@ -45,7 +45,7 @@ import {
   setFileDescription,
   suggest,
   writeConfig
-} from "./chunk-PHTWZ2JT.js";
+} from "./chunk-UDT7TLSN.js";
 export {
   AREA_DESCRIPTIONS,
   AREA_NAMES,

package/dist/{server-NIEAOPLJ.js → server-VKLU25E2.js}

@@ -1,6 +1,10 @@
+import {
+  find
+} from "./chunk-M7JM3XRW.js";
 import {
   VERSION,
   area,
+  areaContext,
   areas,
   areasInit,
   context,
@@ -8,7 +12,7 @@ import {
   impact,
   map,
   suggest
-} from "./chunk-PHTWZ2JT.js";
+} from "./chunk-UDT7TLSN.js";
 
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -349,6 +353,90 @@ Use quando houver arquivos sem area ou precisar ajustar deteccao.`,
     }
   }
 );
+server.registerTool(
+  "aitool_find",
+  {
+    title: "Find Symbol",
+    description: `Busca simbolos no codigo: funcoes, tipos, componentes, hooks, constantes.
+Retorna definicao + referencias/usos. Diferente de grep, entende o AST do TypeScript.`,
+    inputSchema: {
+      query: z.string().min(1).describe("Termo a buscar (nome de funcao, tipo, componente, etc)"),
+      type: z.enum(["function", "type", "const", "component", "hook", "all"]).default("all").describe("Filtrar por tipo de simbolo"),
+      area: z.string().optional().describe("Filtrar busca por area especifica"),
+      def: z.boolean().default(false).describe("Mostrar apenas definicoes (onde e declarado)"),
+      refs: z.boolean().default(false).describe("Mostrar apenas referencias (onde e usado)"),
+      cwd: z.string().optional().describe("Diretorio do projeto a analisar")
+    },
+    annotations: {
+      title: "Find Symbol",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
+  async (params) => {
+    try {
+      const result = await find(params.query, {
+        type: params.type,
+        area: params.area,
+        def: params.def,
+        refs: params.refs,
+        cwd: params.cwd,
+        format: "text"
+      });
+      return { content: [{ type: "text", text: result }] };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Erro ao executar find: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+);
+server.registerTool(
+  "aitool_area_context",
+  {
+    title: "Area Context",
+    description: `Contexto consolidado de toda uma area: tipos, hooks, funcoes, componentes, services, stores.
+Uma chamada = entender toda a feature. Muito mais eficiente que chamar context em cada arquivo.`,
+    inputSchema: {
+      area: z.string().min(1).describe("Nome da area: auth, dashboard, payments, etc"),
+      cwd: z.string().optional().describe("Diretorio do projeto a analisar")
+    },
+    annotations: {
+      title: "Area Context",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
+  async (params) => {
+    try {
+      const result = await areaContext(params.area, {
+        cwd: params.cwd,
+        format: "text"
+      });
+      return { content: [{ type: "text", text: result }] };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Erro ao executar area context: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+);
 async function startMcpServer() {
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justmpm/ai-tool",
-  "version": "0.5.4",
+  "version": "0.6.0",
   "description": "Ferramenta de análise de dependências e impacto para projetos TypeScript/JavaScript. Usa Skott + Knip internamente.",
   "keywords": [
     "dependency-analysis",