@justmpm/ai-tool 0.4.0 → 0.5.0

package/dist/cli.js

@@ -10,21 +10,22 @@ import {
   impact,
   map,
   suggest
-} from "./chunk-33DHCY2H.js";
+} from "./chunk-IIUNJRGG.js";
 
 // src/cli.ts
 var HELP = `
 ai-tool v${VERSION} - Analise de dependencias e impacto
 
 COMANDOS:
-  map                    Mapa completo do projeto (usa Skott)
+  map                    Resumo do projeto: contagens e areas
+  map --full             Mapa completo com lista de arquivos
   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)
 
-AREAS (NOVO):
+AREAS:
   areas                  Lista todas as areas/dominios do projeto
   areas init             Gera arquivo de configuracao .analyze/areas.config.json
   areas init --force     Sobrescreve configuracao existente
@@ -41,7 +42,7 @@ OPCOES:
   --no-cache             Ignora cache e forca regeneracao
   --limit=<n>            Limite de sugestoes (default: 10, apenas suggest)
   --type=<categoria>     Filtra por categoria (apenas area)
-  --full                 Mostra todos os arquivos (apenas area)
+  --full                 Lista completa (map: lista arquivos, area: todos arquivos)
   --help, -h             Mostra esta ajuda
   --version, -v          Mostra versao
 
@@ -51,7 +52,8 @@ CACHE:
   Use --no-cache para forcar regeneracao.
 
 EXEMPLOS:
-  ai-tool map
+  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
@@ -85,7 +87,7 @@ async function main() {
     }
   }
   if (flags.mcp) {
-    const { startMcpServer } = await import("./server-62WVGNJD.js");
+    const { startMcpServer } = await import("./server-FG4LYSEG.js");
     await startMcpServer();
     return;
   }
@@ -106,7 +108,7 @@ async function main() {
     let result;
     switch (command) {
       case "map":
-        result = await map({ format, cwd, cache });
+        result = await map({ format, cwd, cache, full: !!flags.full });
         break;
       case "dead":
         if (flags.fix) {

package/dist/index.d.ts

@@ -11,6 +11,7 @@ interface CommandOptions {
 }
 interface MapOptions extends CommandOptions {
     trackDependencies?: boolean;
+    full?: boolean;
 }
 interface DeadOptions extends CommandOptions {
     include?: string[];
@@ -501,6 +502,6 @@ declare const AREA_DESCRIPTIONS: Record<string, string>;
  * ```
  */
 
-declare const VERSION = "0.4.0";
+declare const VERSION: string;
 
 export { AREA_DESCRIPTIONS, AREA_NAMES, type AreaConfig, type AreaDetailResult, type AreaFile, type AreaOptions, type AreasConfigFile, type AreasOptions, type AreasResult, type CommandOptions, type ContextOptions, type ContextResult, type DeadFile, type DeadOptions, type DeadResult, type DetectedArea, FOLDER_PATTERNS, type FileCategory, type FileInfo, type FolderStats, type FunctionInfo, type ImpactFile, type ImpactOptions, type ImpactResult, type ImportInfo, KEYWORD_PATTERNS, type MapOptions, type MapResult, type OutputFormat, type ParamInfo, type RiskInfo, type SuggestOptions, type SuggestResult, type Suggestion, type SuggestionPriority, type TypeInfo, type TypeKind, VERSION, area, areas, areasInit, categoryIcons, clearFirebaseCache, configExists, context, dead, deadFix, detectCategory, detectFileAreas, filterCloudFunctionsFalsePositives, getAreaDescription, getAreaName, getCacheDir, getFileDescription, hasFirebaseFunctions, impact, inferFileDescription, invalidateCache, isCacheValid, isCodeFile, isEntryPoint, isExportedCloudFunction, isFirebaseProject, map, readConfig, removeArea, setArea, setFileDescription, suggest, writeConfig };

package/dist/index.js

@@ -36,7 +36,7 @@ import {
   setFileDescription,
   suggest,
   writeConfig
-} from "./chunk-33DHCY2H.js";
+} from "./chunk-IIUNJRGG.js";
 export {
   AREA_DESCRIPTIONS,
   AREA_NAMES,

package/dist/{server-62WVGNJD.js → server-FG4LYSEG.js}

@@ -8,7 +8,7 @@ import {
   impact,
   map,
   suggest
-} from "./chunk-33DHCY2H.js";
+} from "./chunk-IIUNJRGG.js";
 
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -22,27 +22,8 @@ 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.`,
+    description: `Mapeia projeto e retorna resumo: contagens por categoria, areas detectadas, alertas.
+Use no inicio da sessao. Para detalhes: area_detail, file_context, suggest_reads.`,
     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")
@@ -59,7 +40,8 @@ Chamar para entender a estrutura de um projeto antes de modificar.`,
     try {
       const result = await map({
         format: params.format,
-        cwd: params.cwd
+        cwd: params.cwd,
+        full: false
       });
       return { content: [{ type: "text", text: result }] };
     } catch (error) {
@@ -79,28 +61,8 @@ 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.`,
+    description: `Detecta codigo morto: arquivos orfaos, exports nao usados, deps npm mortas.
+Use antes de refatoracoes ou periodicamente para limpeza.`,
     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")
@@ -137,34 +99,8 @@ 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.`,
+    description: `Analisa impacto de modificar um arquivo: upstream (quem importa), downstream (o que importa), riscos.
+Use ANTES de editar arquivos para planejar mudancas seguras.`,
     inputSchema: {
       target: z.string().min(1).describe(
         "Arquivo a analisar: caminho completo, parcial ou nome do arquivo"
@@ -204,31 +140,8 @@ 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.`,
+    description: `Sugere arquivos para ler ANTES de modificar um arquivo.
+Prioriza: tipos usados, dependencias diretas, upstream, testes.`,
     inputSchema: {
       target: z.string().min(1).describe(
         "Arquivo que sera modificado: caminho completo, parcial ou nome"
@@ -269,39 +182,8 @@ 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.`,
+    description: `Extrai assinaturas de funcoes e tipos de um arquivo (sem implementacao).
+Use para entender a API publica antes de usar ou modificar.`,
     inputSchema: {
       target: z.string().min(1).describe(
         "Arquivo para extrair contexto: caminho completo, parcial ou nome"
@@ -340,39 +222,8 @@ server.registerTool(
   "aitool_list_areas",
   {
     title: "List Project Areas",
-    description: `Lista todas as areas/dominios funcionais do projeto.
-
-IMPORTANTE - AREAS vs CATEGORIAS:
-- CATEGORIA = tipo tecnico (hook, component, page, service...)
-  \u2192 Use aitool_project_map para ver categorias
-- AREA = dominio funcional (auth, meus-pets, stripe, dashboard...)
-  \u2192 Use ESTA tool para ver areas
-  \u2192 Use aitool_area_detail para ver arquivos de uma area especifica
-
-Um arquivo pode pertencer a MULTIPLAS areas!
-
-FUNCIONALIDADES:
-- Detecta areas automaticamente baseado em padroes de pasta e keywords
-- Agrupa arquivos por dominio funcional
-- Mostra distribuicao de categorias por area
-- Identifica arquivos sem area definida
-
-PARAMETROS:
-- format: "text" (legivel) ou "json" (estruturado)
-- cwd: Diretorio do projeto (default: diretorio atual)
-
-RETORNA:
-- Lista de areas com nome, descricao e contagem
-- Distribuicao de categorias por area
-- Lista de arquivos sem area (para configurar manualmente)
-
-EXEMPLO DE USO:
-Chamar no inicio da sessao para entender os dominios do projeto.
-Usar antes de trabalhar em uma feature especifica.
-
-CONFIGURACAO MANUAL:
-Se houver arquivos sem area ou areas incorretas, use aitool_areas_init
-para gerar .analyze/areas.config.json e edite manualmente.`,
+    description: `Lista areas/dominios funcionais do projeto (auth, pets, stripe...).
+Diferente de categorias (hook, component). Use area_detail para ver arquivos.`,
     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")
@@ -409,36 +260,8 @@ server.registerTool(
   "aitool_area_detail",
   {
     title: "Area Detail",
-    description: `Mostra todos os arquivos de uma area/dominio especifica.
-
-USE ESTA TOOL QUANDO:
-- Usuario pedir para trabalhar em uma feature (ex: "vou mexer em auth")
-- Precisar listar todos os arquivos de um dominio
-- Quiser ver apenas hooks, components, etc de uma area especifica
-
-FUNCIONALIDADES:
-- Lista arquivos agrupados por categoria (page, component, hook...)
-- Mostra descricao de cada arquivo (inferida ou manual)
-- Permite filtrar por categoria especifica (type="hook")
-- Mostra resumo de distribuicao
-
-PARAMETROS:
-- target: Nome da area (OBRIGATORIO - ex: "meus-pets", "auth", "stripe")
-- type: Filtrar por categoria (opcional - ex: "hook", "component")
-- full: Mostrar todos os arquivos (default: false = resumido)
-- cwd: Diretorio do projeto
-
-RETORNA:
-- Nome e descricao da area
-- Lista de arquivos por categoria
-- Descricao de cada arquivo
-
-EXEMPLOS DE USO:
-- Ver tudo de auth: target="auth"
-- Ver apenas hooks de auth: target="auth", type="hook"
-- Ver todos os arquivos de stripe: target="stripe", full=true
-
-DICA: Use aitool_list_areas primeiro para ver quais areas existem.`,
+    description: `Mostra arquivos de uma area especifica, agrupados por categoria.
+Parametros: target (nome da area), type (filtrar categoria), full (todos arquivos).`,
     inputSchema: {
       target: z.string().min(1).describe("Nome da area: meus-pets, auth, stripe, etc"),
       type: z.enum([
@@ -492,60 +315,8 @@ server.registerTool(
   "aitool_areas_init",
   {
     title: "Initialize Areas Config",
-    description: `Gera arquivo de configuracao de areas (.analyze/areas.config.json).
-
-QUANDO USAR:
-- Quando aitool_list_areas mostrar arquivos sem area definida
-- Quando precisar personalizar deteccao de areas
-- Quando quiser adicionar areas que nao sao detectadas automaticamente
-
-O QUE FAZ:
-- Escaneia o projeto e detecta areas automaticamente
-- Infere patterns glob para cada area detectada
-- Gera arquivo editavel em .analyze/areas.config.json
-- NAO sobrescreve config existente (use force=true para sobrescrever)
-
-PARAMETROS:
-- force: Sobrescrever config existente (default: false)
-- cwd: Diretorio do projeto (default: diretorio atual)
-
-RETORNA:
-- Confirmacao do arquivo criado
-- Lista de areas detectadas com contagem
-- Arquivos sem area (para configurar manualmente)
-- Instrucoes de como editar o arquivo
-
-ESTRUTURA DO ARQUIVO GERADO:
-{
-  "areas": {
-    "auth": {
-      "name": "Autenticacao",
-      "description": "Sistema de login e sessao",
-      "patterns": ["components/auth/**", "hooks/useAuth.ts"],
-      "keywords": ["auth", "login", "session"]
-    }
-  },
-  "descriptions": {
-    "components/pets/PetForm.tsx": "Formulario multi-step de pets"
-  },
-  "settings": {
-    "autoDetect": true,
-    "inferDescriptions": true
-  }
-}
-
-COMO EDITAR MANUALMENTE:
-1. Adicionar areas nao detectadas: adicione entrada em "areas"
-2. Renomear areas: altere "name" da area
-3. Ajustar deteccao: modifique "patterns" e "keywords"
-4. Excluir arquivos: adicione "exclude" com patterns
-5. Descrever arquivos: adicione entrada em "descriptions"
-
-EXEMPLO DE USO:
-1. Rode aitool_list_areas para ver areas atuais
-2. Se houver arquivos sem area, rode aitool_areas_init
-3. Edite .analyze/areas.config.json conforme necessario
-4. Rode aitool_list_areas novamente para ver mudancas`,
+    description: `Gera .analyze/areas.config.json para customizar deteccao de areas.
+Use quando houver arquivos sem area ou precisar ajustar deteccao.`,
     inputSchema: {
       force: z.boolean().default(false).describe("Sobrescrever config existente"),
       cwd: z.string().optional().describe("Diretorio do projeto")

package/package.json

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