@justmpm/ai-tool 0.4.0 → 0.5.0

package/README.md

@@ -21,18 +21,34 @@ npm install -D @justmpm/ai-tool
 
 ### `map` - Mapa do Projeto
 
-Gera um mapa completo do projeto com categorizacao de arquivos.
+Gera um resumo compacto do projeto com contagens, areas e alertas.
 
 ```bash
-ai-tool map
+ai-tool map           # Resumo compacto (otimizado para tokens)
+ai-tool map --full    # Lista completa de arquivos e pastas
 ai-tool map --format=json
 ```
 
-**Output:**
-- Total de arquivos e pastas
-- Categorizacao automatica (component, hook, service, util, etc.)
-- Estrutura de pastas
-- Dependencias circulares detectadas
+**Output (resumo):**
+```
+📊 486 arquivos | 97 pastas
+   55 components, 40 hooks, 187 pages, 31 services, 95 utils...
+
+🗂️ Áreas: Admin, Auth, Checkout, Dashboard, Stripe...
+
+⚠️ 4 dependência(s) circular(es) detectada(s)
+   → Use impact <arquivo> para investigar
+
+📖 Próximos passos:
+   → area <nome> - ver arquivos de uma área
+   → suggest <arquivo> - o que ler antes de editar
+   → context <arquivo> - ver API de um arquivo
+```
+
+**Output (--full):**
+- Lista completa de arquivos por pasta
+- Estrutura detalhada de pastas
+- Dependencias circulares listadas
 
 ### `dead` - Codigo Morto
 
@@ -97,6 +113,49 @@ ai-tool context src/hooks/useAuth.ts --format=json
 
 Ideal para entender rapidamente a API publica de um arquivo.
 
+### `areas` - Areas/Dominios Funcionais
+
+Lista todas as areas funcionais do projeto (auth, dashboard, stripe, etc).
+
+```bash
+ai-tool areas
+ai-tool areas --format=json
+```
+
+**Output:**
+- Lista de areas detectadas automaticamente
+- Contagem de arquivos por area
+- Distribuicao de categorias por area
+
+### `area` - Detalhe de uma Area
+
+Mostra todos os arquivos de uma area especifica.
+
+```bash
+ai-tool area auth
+ai-tool area meus-pets --type=hook  # Filtra por categoria
+ai-tool area stripe --full          # Mostra todos os arquivos
+```
+
+**Output:**
+- Arquivos agrupados por categoria
+- Descricao inferida de cada arquivo
+
+### `areas init` - Configuracao de Areas
+
+Gera arquivo de configuracao editavel para areas.
+
+```bash
+ai-tool areas init
+ai-tool areas init --force  # Sobrescreve config existente
+```
+
+Cria `.analyze/areas.config.json` com:
+- Areas detectadas automaticamente
+- Patterns glob para cada area
+- Keywords de deteccao
+- Descricoes manuais de arquivos
+
 ## Servidor MCP
 
 Integra com Claude Desktop e outras ferramentas MCP.
@@ -111,6 +170,9 @@ ai-tool --mcp
 - `aitool_impact_analysis` - Analise de impacto
 - `aitool_suggest_reads` - Sugestao de leitura
 - `aitool_file_context` - Contexto do arquivo
+- `aitool_list_areas` - Lista areas funcionais
+- `aitool_area_detail` - Detalhe de uma area
+- `aitool_areas_init` - Gera config de areas
 
 ### Configuracao Claude Code
 
@@ -148,10 +210,11 @@ Adicione ao `claude_desktop_config.json`:
 ## Uso Programatico
 
 ```typescript
-import { map, dead, impact, suggest, context } from "@justmpm/ai-tool";
+import { map, dead, impact, suggest, context, areas, area, areasInit } from "@justmpm/ai-tool";
 
-// Mapa do projeto
+// Mapa do projeto (resumo por padrao, full: true para lista completa)
 const projectMap = await map({ format: "json" });
+const fullMap = await map({ format: "json", full: true });
 
 // Codigo morto
 const deadCode = await dead({ format: "json" });
@@ -164,6 +227,15 @@ const suggestions = await suggest("Button", { limit: 5 });
 
 // Contexto do arquivo
 const fileContext = await context("Button", { format: "json" });
+
+// Areas funcionais
+const projectAreas = await areas({ format: "json" });
+
+// Detalhe de uma area
+const authArea = await area("auth", { type: "hook" });
+
+// Gerar config de areas
+await areasInit({ force: false });
 ```
 
 ## Opcoes
@@ -173,8 +245,10 @@ const fileContext = await context("Button", { format: "json" });
 | `--format=text\|json` | Formato de saida | `text` |
 | `--cwd=<path>` | Diretorio do projeto | `process.cwd()` |
 | `--no-cache` | Ignora cache | `false` |
+| `--full` | Lista completa (`map`: arquivos, `area`: todos) | `false` |
 | `--fix` | Remove codigo morto (so `dead`) | `false` |
 | `--limit=<n>` | Limite de sugestoes (so `suggest`) | `10` |
+| `--type=<cat>` | Filtra por categoria (so `area`) | - |
 | `--mcp` | Inicia servidor MCP | - |
 
 ## Categorias de Arquivos