@justmpm/ai-tool 3.23.0 → 3.24.0

package/dist/{chunk-4Z6PUAFR.js → chunk-ERMF7MJF.js}

@@ -20,7 +20,7 @@ import {
   readConfig,
   recoveryHint,
   simplifyType
-} from "./chunk-WTRV35AO.js";
+} from "./chunk-LKP6Z3JC.js";
 
 // src/commands/describe.ts
 var STOPWORDS = /* @__PURE__ */ new Set([
@@ -1625,25 +1625,29 @@ function isConceptualQuery(query, packageName) {
 }
 
 // src/commands/deps.ts
+function normalizeKind(kind) {
+  if (kind === "interface" || kind === "enum") return "type";
+  return kind;
+}
 function normalizePath(p) {
   return p.replace(/\\/g, "/");
 }
 function computeAvailableKinds(extracted, requestedKind) {
   const kindCounts = /* @__PURE__ */ new Map();
   for (const fn of extracted.functions) {
-    const kind = classifySymbol("function", fn.name, fn.returnType);
+    const kind = normalizeKind(classifySymbol("function", fn.name, fn.returnType));
     if (isSemanticKindMatch(kind, requestedKind)) {
       kindCounts.set(kind, (kindCounts.get(kind) ?? 0) + 1);
     }
   }
   for (const t of extracted.types) {
-    const kind = classifySymbol("type", t.name);
+    const kind = normalizeKind(classifySymbol("type", t.name));
     if (isSemanticKindMatch(kind, requestedKind)) {
       kindCounts.set(kind, (kindCounts.get(kind) ?? 0) + 1);
     }
   }
   for (const c of extracted.constants) {
-    const kind = classifySymbol("const", c.name);
+    const kind = normalizeKind(classifySymbol("const", c.name));
     if (isSemanticKindMatch(kind, requestedKind)) {
       kindCounts.set(kind, (kindCounts.get(kind) ?? 0) + 1);
     }

package/dist/{chunk-WTRV35AO.js → chunk-LKP6Z3JC.js}

@@ -340,8 +340,16 @@ function recoveryHint(errorType, ctx, _extra) {
       return `
 \u{1F4A1} Nenhuma area configurada neste projeto.
    \u2192 ${hint("areas_init", ctx)} - gerar arquivo de configuracao
-   \u2192 Depois edite .analyze/areas.config.json com as areas do projeto
    \u2192 ${hint("map", ctx)} - ver estrutura do projeto sem areas
+
+   Como configurar o areas.config.json:
+   - patterns: glob para pastas (ex: "app/dashboard/**", "hooks/usePets.*")
+   - keywords: substring no path, case-insensitive (ex: ["pet", "animal"])
+   - exclude: remove falsos positivos de uma area (ex: "components/pets/shared/**")
+   - descriptions: contexto manual para arquivos importantes (aparece no suggest, context, changes)
+   - settings.inferDescriptions: true para inferir descricoes automaticamente pelo nome do arquivo
+   - Um arquivo pode pertencer a multiplas areas
+   - Ideal: 5 a 15 areas (muitas = dificil de navegar)
 `;
     case "symbol_not_found":
       return `
@@ -626,6 +634,8 @@ function formatMapSummary(result, areasInfo, ctx = "cli") {
     out += `   \u2192 ${hint("areas_missing", ctx)} para ver quais arquivos estao sem area
 `;
     out += `   \u2192 ${hint("areas_init", ctx)} para criar/editar areas.config
+`;
+    out += `   Boas praticas: patterns (glob exato) para pastas, keywords (case-insensitive) para arquivos espalhados, exclude para falsos positivos
 
 `;
   }
@@ -1895,65 +1905,6 @@ AFFECTED AREAS:
   const semanticFiles = result.files.filter((f) => f.changes.length > 0 && !f.newFile);
   const newFiles = result.files.filter((f) => f.newFile);
   const otherFiles = result.files.filter((f) => f.changes.length === 0 && !f.newFile);
-  const COMPACT_THRESHOLD = 10;
-  const filesExceedThreshold = semanticFiles.length + newFiles.length > COMPACT_THRESHOLD;
-  if (filesExceedThreshold) {
-    out += `
-COMPACT MODE: Too many files. Use --file=<path> for details.
-
-`;
-    const modifiedCompact = result.files.filter((f) => !f.newFile);
-    const renamedCompact = modifiedCompact.filter((f) => f.renamed);
-    const otherModifiedCompact = modifiedCompact.filter((f) => !f.renamed);
-    if (otherModifiedCompact.length > 0) {
-      out += `Modified files:
-`;
-      for (const file of otherModifiedCompact) {
-        const changeCount = file.changes.length;
-        out += `  ${file.path} (+${file.stats.added} -${file.stats.removed})`;
-        if (changeCount > 0) {
-          out += ` - ${changeCount} changes`;
-        } else {
-          out += ` - (no semantic changes)`;
-        }
-        out += `
-`;
-      }
-    }
-    if (renamedCompact.length > 0) {
-      out += `
-Renamed files:
-`;
-      for (const file of renamedCompact) {
-        out += `  ${file.renamedFrom} -> ${file.path} (+${file.stats.added} -${file.stats.removed})`;
-        const changeCount = file.changes.length;
-        if (changeCount > 0) {
-          out += ` - ${changeCount} changes`;
-        }
-        out += `
-`;
-      }
-    }
-    if (newFiles.length > 0) {
-      out += `
-New files (untracked):
-`;
-      for (const file of newFiles) {
-        const changeCount = file.changes.length;
-        out += `  ${file.path} (+${file.stats.added} new)`;
-        if (changeCount > 0) {
-          out += ` - ${changeCount} symbols`;
-        }
-        out += `
-`;
-      }
-    }
-    out += `
-Use: ${hint("changes", ctx)} --file=<arquivo>
-`;
-    out += nextSteps("changes", ctx);
-    return out;
-  }
   for (const file of semanticFiles) {
     out += `
 --- ${file.path} (+${file.stats.added} -${file.stats.removed}) ---
@@ -7005,14 +6956,20 @@ Ou edite manualmente o arquivo existente.
    ai-tool area auth          # Ver arquivos de uma \xE1rea
    ai-tool map                # Ver resumo do projeto
 
-\u{1F4A1} Dicas:
+ \u{1F4A1} Dicas:
 
-\u2022 Use patterns para pastas: "app/dashboard/**"
-\u2022 Use keywords para arquivos espalhados: ["auth", "login"]
-\u2022 Um arquivo pode pertencer a m\xFAltiplas \xE1reas
-\u2022 Use "exclude" para remover arquivos espec\xEDficos de uma \xE1rea
+ \u2022 patterns: glob para pastas (ex: "app/dashboard/**", "hooks/usePets.*")
+ \u2022 keywords: substring no path inteiro, case-insensitive (ex: ["pet", "animal"])
+ \u2022 Um arquivo pode pertencer a m\xFAltiplas \xE1reas
+ \u2022 exclude: remove falsos positivos de uma \xE1rea (glob patterns)
+ \u2022 descriptions (campo raiz): contexto manual para arquivos importantes
+   Aparece nos comandos suggest, context e changes
+   Ex: "src/hooks/useAuth.ts": "Hook principal de autentica\xE7\xE3o"
+ \u2022 settings.inferDescriptions: true j\xE1 infere descri\xE7\xF5es automaticamente
+   pelo nome do arquivo (ex: useAuth.ts \u2192 "Hook de auth", petService.ts \u2192 "Service de pet")
+   Ativado por padr\xE3o no template gerado
 
-\u{1F4D6} Exemplo completo:
+ \u{1F4D6} Exemplo completo:
 
 {
   "areas": {

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   depsInfo,
   depsSearch,
   describe
-} from "./chunk-4Z6PUAFR.js";
+} from "./chunk-ERMF7MJF.js";
 import {
   VERSION,
   area,
@@ -20,7 +20,7 @@ import {
   impact,
   map,
   suggest
-} from "./chunk-WTRV35AO.js";
+} from "./chunk-LKP6Z3JC.js";
 
 // src/cli.ts
 import { resolve } from "path";
@@ -131,7 +131,7 @@ async function main() {
     }
   }
   if (flags.mcp) {
-    const { startMcpServer } = await import("./server-3HLEATUD.js");
+    const { startMcpServer } = await import("./server-T6IW5ZR7.js");
     await startMcpServer();
     return;
   }

package/dist/index.js

@@ -47,7 +47,7 @@ import {
   setFileDescription,
   suggest,
   writeConfig
-} from "./chunk-WTRV35AO.js";
+} from "./chunk-LKP6Z3JC.js";
 export {
   VERSION,
   area,

package/dist/{server-3HLEATUD.js → server-T6IW5ZR7.js}

@@ -3,7 +3,7 @@ import {
   depsInfo,
   depsSearch,
   describe
-} from "./chunk-4Z6PUAFR.js";
+} from "./chunk-ERMF7MJF.js";
 import {
   VERSION,
   area,
@@ -19,7 +19,7 @@ import {
   map,
   recoveryHint,
   suggest
-} from "./chunk-WTRV35AO.js";
+} from "./chunk-LKP6Z3JC.js";
 
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justmpm/ai-tool",
-  "version": "3.23.0",
+  "version": "3.24.0",
   "description": "Ferramenta de análise de dependências e impacto para projetos TypeScript/JavaScript. Usa Skott + Knip internamente. Inclui busca por descrição, integração Git e testes inteligentes.",
   "keywords": [
     "dependency-analysis",