@justmpm/ai-tool 0.4.2 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -21,18 +21,34 @@ npm install -D @justmpm/ai-tool
21
21
 
22
22
  ### `map` - Mapa do Projeto
23
23
 
24
- Gera um mapa completo do projeto com categorizacao de arquivos.
24
+ Gera um resumo compacto do projeto com contagens, areas e alertas.
25
25
 
26
26
  ```bash
27
- ai-tool map
27
+ ai-tool map # Resumo compacto (otimizado para tokens)
28
+ ai-tool map --full # Lista completa de arquivos e pastas
28
29
  ai-tool map --format=json
29
30
  ```
30
31
 
31
- **Output:**
32
- - Total de arquivos e pastas
33
- - Categorizacao automatica (component, hook, service, util, etc.)
34
- - Estrutura de pastas
35
- - Dependencias circulares detectadas
32
+ **Output (resumo):**
33
+ ```
34
+ 📊 486 arquivos | 97 pastas
35
+ 55 components, 40 hooks, 187 pages, 31 services, 95 utils...
36
+
37
+ 🗂️ Áreas: Admin, Auth, Checkout, Dashboard, Stripe...
38
+
39
+ ⚠️ 4 dependência(s) circular(es) detectada(s)
40
+ → Use impact <arquivo> para investigar
41
+
42
+ 📖 Próximos passos:
43
+ → area <nome> - ver arquivos de uma área
44
+ → suggest <arquivo> - o que ler antes de editar
45
+ → context <arquivo> - ver API de um arquivo
46
+ ```
47
+
48
+ **Output (--full):**
49
+ - Lista completa de arquivos por pasta
50
+ - Estrutura detalhada de pastas
51
+ - Dependencias circulares listadas
36
52
 
37
53
  ### `dead` - Codigo Morto
38
54
 
@@ -196,8 +212,9 @@ Adicione ao `claude_desktop_config.json`:
196
212
  ```typescript
197
213
  import { map, dead, impact, suggest, context, areas, area, areasInit } from "@justmpm/ai-tool";
198
214
 
199
- // Mapa do projeto
215
+ // Mapa do projeto (resumo por padrao, full: true para lista completa)
200
216
  const projectMap = await map({ format: "json" });
217
+ const fullMap = await map({ format: "json", full: true });
201
218
 
202
219
  // Codigo morto
203
220
  const deadCode = await dead({ format: "json" });
@@ -228,8 +245,10 @@ await areasInit({ force: false });
228
245
  | `--format=text\|json` | Formato de saida | `text` |
229
246
  | `--cwd=<path>` | Diretorio do projeto | `process.cwd()` |
230
247
  | `--no-cache` | Ignora cache | `false` |
248
+ | `--full` | Lista completa (`map`: arquivos, `area`: todos) | `false` |
231
249
  | `--fix` | Remove codigo morto (so `dead`) | `false` |
232
250
  | `--limit=<n>` | Limite de sugestoes (so `suggest`) | `10` |
251
+ | `--type=<cat>` | Filtra por categoria (so `area`) | - |
233
252
  | `--mcp` | Inicia servidor MCP | - |
234
253
 
235
254
  ## Categorias de Arquivos