@justmpm/ai-tool 0.5.1 → 0.5.4

package/README.md

@@ -155,6 +155,46 @@ Cria `.analyze/areas.config.json` com:
 - Patterns glob para cada area
 - Keywords de deteccao
 - Descricoes manuais de arquivos
+- Padroes de ignore global
+
+### Configuracao de Areas
+
+O arquivo `.analyze/areas.config.json` suporta:
+
+```json
+{
+  "$schema": "./areas.schema.json",
+  "version": "1.0.0",
+  "ignore": [
+    "docs/brainstorming/**",
+    "functions/lib/**",
+    "**/*.test.ts"
+  ],
+  "areas": {
+    "auth": {
+      "name": "Autenticacao",
+      "description": "Sistema de login e sessao",
+      "patterns": ["**/auth/**", "**/login/**"],
+      "keywords": ["auth", "login", "session"]
+    }
+  },
+  "descriptions": {
+    "src/hooks/useAuth.ts": "Hook principal de autenticacao"
+  },
+  "settings": {
+    "autoDetect": true,
+    "inferDescriptions": true
+  }
+}
+```
+
+| Campo | Descricao |
+|-------|-----------|
+| `ignore` | Padroes glob para ignorar arquivos/pastas globalmente |
+| `areas` | Definicao manual de areas com patterns e keywords |
+| `descriptions` | Descricoes manuais para arquivos especificos |
+| `settings.autoDetect` | Se `false`, usa apenas areas definidas manualmente |
+| `settings.inferDescriptions` | Infere descricoes automaticamente baseado no nome |
 
 ## Servidor MCP
 

package/dist/{chunk-A3QVUKVA.js → chunk-PHTWZ2JT.js}

@@ -1079,6 +1079,7 @@ var CONFIG_FILE = "areas.config.json";
 var DEFAULT_CONFIG = {
   $schema: "./areas.schema.json",
   version: "1.0.0",
+  ignore: [],
   areas: {},
   descriptions: {},
   settings: {
@@ -1475,6 +1476,17 @@ var AREA_DESCRIPTIONS = {
 };
 
 // src/areas/detector.ts
+function isFileIgnored(filePath, config) {
+  const ignorePatterns = config.ignore || [];
+  if (ignorePatterns.length === 0) return false;
+  const normalizedPath = filePath.replace(/\\/g, "/");
+  for (const pattern of ignorePatterns) {
+    if (minimatch(normalizedPath, pattern, { dot: true })) {
+      return true;
+    }
+  }
+  return false;
+}
 function detectFileAreas(filePath, config) {
   const normalizedPath = filePath.replace(/\\/g, "/");
   const matches = [];
@@ -1722,6 +1734,9 @@ function detectAreasInfo(cwd, filePaths) {
     const areaSet = /* @__PURE__ */ new Set();
     let unmappedCount = 0;
     for (const filePath of filePaths) {
+      if (isFileIgnored(filePath, config)) {
+        continue;
+      }
       const areas2 = detectFileAreas(filePath, config);
       if (areas2.length === 0) {
         unmappedCount++;
@@ -1858,6 +1873,254 @@ ${output}`;
 
 // src/commands/impact.ts
 import skott2 from "skott";
+
+// src/utils/similarity.ts
+function levenshteinDistance(a, b) {
+  const matrix = [];
+  for (let i = 0; i <= b.length; i++) {
+    matrix[i] = [i];
+  }
+  for (let j = 0; j <= a.length; j++) {
+    matrix[0][j] = j;
+  }
+  for (let i = 1; i <= b.length; i++) {
+    for (let j = 1; j <= a.length; j++) {
+      if (b.charAt(i - 1) === a.charAt(j - 1)) {
+        matrix[i][j] = matrix[i - 1][j - 1];
+      } else {
+        matrix[i][j] = Math.min(
+          matrix[i - 1][j - 1] + 1,
+          // substituição
+          matrix[i][j - 1] + 1,
+          // inserção
+          matrix[i - 1][j] + 1
+          // deleção
+        );
+      }
+    }
+  }
+  return matrix[b.length][a.length];
+}
+function findSimilar(target, candidates, options = {}) {
+  const {
+    maxDistance = 3,
+    limit = 5,
+    normalize: normalize2 = true,
+    extractKey = (item) => String(item)
+  } = options;
+  const normalizedTarget = normalize2 ? target.toLowerCase() : target;
+  const scored = candidates.map((item) => {
+    const key = extractKey(item);
+    const normalizedKey = normalize2 ? key.toLowerCase() : key;
+    const keyNoExt = normalizedKey.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+    let score = Infinity;
+    if (normalizedKey.includes(normalizedTarget) || keyNoExt.includes(normalizedTarget)) {
+      score = 0;
+    } else {
+      score = levenshteinDistance(keyNoExt, normalizedTarget);
+    }
+    return { item, score };
+  }).filter(({ score }) => score <= maxDistance).sort((a, b) => a.score - b.score).slice(0, limit);
+  return scored.map(({ item }) => item);
+}
+function findBestMatch(target, candidates, extractKey = (item) => String(item)) {
+  const similar = findSimilar(target, candidates, {
+    maxDistance: 2,
+    // Mais restritivo para "você quis dizer"
+    limit: 1,
+    extractKey
+  });
+  return similar.length > 0 ? similar[0] : null;
+}
+function extractFileName(filePath) {
+  const fileName = filePath.split("/").pop() || filePath;
+  return fileName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+}
+
+// src/utils/errors.ts
+var COMMAND_REFERENCE = {
+  map: "Resumo do projeto (sem target)",
+  areas: "Listar todas as \xE1reas (sem target)",
+  area: "Arquivos de uma \xE1rea espec\xEDfica",
+  suggest: "O que ler antes de editar",
+  context: "API/assinaturas de um arquivo",
+  impact: "Quem usa este arquivo",
+  dead: "C\xF3digo morto (sem target)"
+};
+function getCommandReferenceSection(excludeCommand) {
+  let out = `
+\u{1F4CC} Comandos \xFAteis:
+`;
+  for (const [cmd, desc] of Object.entries(COMMAND_REFERENCE)) {
+    if (cmd !== excludeCommand) {
+      out += `   ai-tool ${cmd.padEnd(10)} ${desc}
+`;
+    }
+  }
+  return out;
+}
+function formatFileNotFound(options) {
+  const { target, allFiles, command } = options;
+  const similarFiles = findSimilar(target, allFiles, {
+    maxDistance: 3,
+    limit: 5,
+    extractKey: extractFileName
+  });
+  const bestMatch = findBestMatch(target, allFiles, extractFileName);
+  let out = `
+\u274C Arquivo n\xE3o encontrado: "${target}"
+
+`;
+  out += `\u{1F4CA} Total de arquivos indexados: ${allFiles.length}
+
+`;
+  if (bestMatch) {
+    out += `\u{1F4A1} Voc\xEA quis dizer?
+`;
+    out += `   \u2192 ${bestMatch}
+
+`;
+  }
+  if (similarFiles.length > 1) {
+    out += `\u{1F4DD} Arquivos similares:
+`;
+    for (const f of similarFiles) {
+      if (f !== bestMatch) {
+        out += `   \u2022 ${f}
+`;
+      }
+    }
+    out += "\n";
+  }
+  out += `\u{1F4D6} Dicas:
+`;
+  out += `   \u2022 Use o caminho relativo: src/components/Header.tsx
+`;
+  out += `   \u2022 Ou apenas o nome do arquivo: Header
+`;
+  out += `   \u2022 Verifique se o arquivo est\xE1 em uma pasta inclu\xEDda no scan
+`;
+  if (command) {
+    out += getCommandReferenceSection(command);
+  }
+  return out;
+}
+function formatAreaNotFound(options) {
+  const { target, availableAreas } = options;
+  const areaIds = availableAreas.map((a) => a.id);
+  const bestMatchId = findBestMatch(target, areaIds);
+  const similarAreaIds = findSimilar(target, areaIds, {
+    maxDistance: 3,
+    limit: 5
+  });
+  let out = `
+\u274C \xC1rea n\xE3o encontrada: "${target}"
+
+`;
+  if (bestMatchId) {
+    out += `\u{1F4A1} Voc\xEA quis dizer?
+`;
+    out += `   \u2192 ai-tool area ${bestMatchId}
+
+`;
+  }
+  if (availableAreas.length > 0) {
+    out += `\u{1F4E6} \xC1reas dispon\xEDveis:
+
+`;
+    if (similarAreaIds.length > 0 && !bestMatchId) {
+      for (const id of similarAreaIds) {
+        const area2 = availableAreas.find((a) => a.id === id);
+        if (area2) {
+          out += `   ${area2.id.padEnd(25)} ${area2.count} arquivos
+`;
+        }
+      }
+      out += `   ---
+`;
+    }
+    const areasToShow = similarAreaIds.length > 0 && !bestMatchId ? availableAreas.filter((a) => !similarAreaIds.includes(a.id)).slice(0, 10) : availableAreas.slice(0, 15);
+    for (const { id, count } of areasToShow) {
+      out += `   ${id.padEnd(25)} ${count} arquivos
+`;
+    }
+    const totalShown = similarAreaIds.length > 0 && !bestMatchId ? similarAreaIds.length + areasToShow.length : areasToShow.length;
+    if (availableAreas.length > totalShown) {
+      out += `   ... e mais ${availableAreas.length - totalShown}
+`;
+    }
+    out += `
+`;
+  }
+  out += `\u{1F4D6} Dicas:
+`;
+  out += `   \u2022 Use o ID exato da \xE1rea (ex: ai-tool area auth)
+`;
+  out += `   \u2022 Use 'ai-tool areas' para listar todas as \xE1reas
+`;
+  out += `   \u2022 IDs s\xE3o case-sensitive (Auth \u2260 auth)
+`;
+  out += `
+\u{1F4CC} Comandos relacionados:
+`;
+  out += `   ai-tool areas      Listar todas as \xE1reas
+`;
+  out += `   ai-tool map        Ver estrutura do projeto
+`;
+  return out;
+}
+function formatMissingTarget(command) {
+  let out = `
+\u274C Erro: par\xE2metro "target" \xE9 OBRIGAT\xD3RIO para o comando "${command}".
+
+`;
+  out += `\u{1F4DD} Exemplos:
+`;
+  if (command === "area") {
+    out += `   ai-tool area auth
+`;
+    out += `   ai-tool area dashboard
+`;
+    out += `   ai-tool area billing --type=hook
+
+`;
+    out += `\u{1F4A1} Use 'ai-tool areas' para listar todas as \xE1reas dispon\xEDveis.
+`;
+  } else {
+    out += `   ai-tool ${command} useAuth
+`;
+    out += `   ai-tool ${command} Button.tsx
+`;
+    out += `   ai-tool ${command} src/hooks/useAuth.ts
+`;
+  }
+  out += getCommandReferenceSection(command);
+  return out;
+}
+function formatInvalidCommand(command) {
+  const validCommands = Object.keys(COMMAND_REFERENCE);
+  const bestMatch = findBestMatch(command, validCommands);
+  let out = `
+\u274C Comando inv\xE1lido: "${command}"
+
+`;
+  if (bestMatch) {
+    out += `\u{1F4A1} Voc\xEA quis dizer?
+`;
+    out += `   \u2192 ai-tool ${bestMatch}
+
+`;
+  }
+  out += `\u{1F4CC} Comandos dispon\xEDveis:
+`;
+  for (const [cmd, desc] of Object.entries(COMMAND_REFERENCE)) {
+    out += `   ai-tool ${cmd.padEnd(10)} ${desc}
+`;
+  }
+  return out;
+}
+
+// src/commands/impact.ts
 async function impact(target, options = {}) {
   const cwd = options.cwd || process.cwd();
   const format = options.format || "text";
@@ -2050,37 +2313,7 @@ function findTargetFile(target, allFiles) {
   return null;
 }
 function formatNotFound(target, allFiles) {
-  const normalizedTarget = target.toLowerCase();
-  const similar = allFiles.filter((f) => {
-    const fileName = f.split("/").pop()?.toLowerCase() || "";
-    const fileNameNoExt = fileName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
-    return fileName.includes(normalizedTarget) || fileNameNoExt.includes(normalizedTarget) || levenshteinDistance(fileNameNoExt, normalizedTarget) <= 3;
-  }).slice(0, 5);
-  let out = `\u274C Arquivo n\xE3o encontrado no \xEDndice: "${target}"
-
-`;
-  out += `\u{1F4CA} Total de arquivos indexados: ${allFiles.length}
-
-`;
-  if (similar.length > 0) {
-    out += `\u{1F4DD} Arquivos com nome similar:
-`;
-    for (const s of similar) {
-      out += `   \u2022 ${s}
-`;
-    }
-    out += `
-`;
-  }
-  out += `\u{1F4A1} Dicas:
-`;
-  out += `   \u2022 Use o caminho relativo: src/components/Header.tsx
-`;
-  out += `   \u2022 Ou apenas o nome do arquivo: Header
-`;
-  out += `   \u2022 Verifique se o arquivo est\xE1 em uma pasta inclu\xEDda no scan
-`;
-  return out;
+  return formatFileNotFound({ target, allFiles, command: "impact" });
 }
 function toImpactFile(isDirect) {
   return (path) => ({
@@ -2149,29 +2382,6 @@ function generateSuggestions(upstream, downstream, risks) {
   }
   return suggestions;
 }
-function levenshteinDistance(a, b) {
-  const matrix = [];
-  for (let i = 0; i <= b.length; i++) {
-    matrix[i] = [i];
-  }
-  for (let j = 0; j <= a.length; j++) {
-    matrix[0][j] = j;
-  }
-  for (let i = 1; i <= b.length; i++) {
-    for (let j = 1; j <= a.length; j++) {
-      if (b.charAt(i - 1) === a.charAt(j - 1)) {
-        matrix[i][j] = matrix[i - 1][j - 1];
-      } else {
-        matrix[i][j] = Math.min(
-          matrix[i - 1][j - 1] + 1,
-          matrix[i][j - 1] + 1,
-          matrix[i - 1][j] + 1
-        );
-      }
-    }
-  }
-  return matrix[b.length][a.length];
-}
 
 // src/commands/suggest.ts
 import skott3 from "skott";
@@ -2350,60 +2560,7 @@ function findTargetFile2(target, allFiles) {
   return null;
 }
 function formatNotFound2(target, allFiles) {
-  const normalizedTarget = target.toLowerCase();
-  const similar = allFiles.filter((f) => {
-    const fileName = f.split("/").pop()?.toLowerCase() || "";
-    const fileNameNoExt = fileName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
-    return fileName.includes(normalizedTarget) || fileNameNoExt.includes(normalizedTarget) || levenshteinDistance2(fileNameNoExt, normalizedTarget) <= 3;
-  }).slice(0, 5);
-  let out = `Arquivo nao encontrado no indice: "${target}"
-
-`;
-  out += `Total de arquivos indexados: ${allFiles.length}
-
-`;
-  if (similar.length > 0) {
-    out += `Arquivos com nome similar:
-`;
-    for (const s of similar) {
-      out += `   - ${s}
-`;
-    }
-    out += `
-`;
-  }
-  out += `Dicas:
-`;
-  out += `   - Use o caminho relativo: src/components/Header.tsx
-`;
-  out += `   - Ou apenas o nome do arquivo: Header
-`;
-  out += `   - Verifique se o arquivo esta em uma pasta incluida no scan
-`;
-  return out;
-}
-function levenshteinDistance2(a, b) {
-  const matrix = [];
-  for (let i = 0; i <= b.length; i++) {
-    matrix[i] = [i];
-  }
-  for (let j = 0; j <= a.length; j++) {
-    matrix[0][j] = j;
-  }
-  for (let i = 1; i <= b.length; i++) {
-    for (let j = 1; j <= a.length; j++) {
-      if (b.charAt(i - 1) === a.charAt(j - 1)) {
-        matrix[i][j] = matrix[i - 1][j - 1];
-      } else {
-        matrix[i][j] = Math.min(
-          matrix[i - 1][j - 1] + 1,
-          matrix[i][j - 1] + 1,
-          matrix[i - 1][j] + 1
-        );
-      }
-    }
-  }
-  return matrix[b.length][a.length];
+  return formatFileNotFound({ target, allFiles, command: "suggest" });
 }
 
 // src/commands/context.ts
@@ -2725,61 +2882,8 @@ function shouldIgnore(name) {
   return ignoredDirs.includes(name) || name.startsWith(".");
 }
 function formatNotFound3(target, cwd) {
-  const normalizedTarget = target.toLowerCase();
   const allFiles = getAllCodeFiles(cwd);
-  const similar = allFiles.filter((f) => {
-    const fileName = basename(f).toLowerCase();
-    const fileNameNoExt = fileName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
-    return fileName.includes(normalizedTarget) || fileNameNoExt.includes(normalizedTarget) || levenshteinDistance3(fileNameNoExt, normalizedTarget) <= 3;
-  }).slice(0, 5);
-  let out = `Arquivo nao encontrado: "${target}"
-
-`;
-  out += `Total de arquivos no projeto: ${allFiles.length}
-
-`;
-  if (similar.length > 0) {
-    out += `Arquivos com nome similar:
-`;
-    for (const s of similar) {
-      out += `   - ${s}
-`;
-    }
-    out += `
-`;
-  }
-  out += `Dicas:
-`;
-  out += `   - Use o caminho relativo: src/components/Header.tsx
-`;
-  out += `   - Ou apenas o nome do arquivo: Header
-`;
-  out += `   - Verifique se o arquivo existe e e um arquivo .ts/.tsx/.js/.jsx
-`;
-  return out;
-}
-function levenshteinDistance3(a, b) {
-  const matrix = [];
-  for (let i = 0; i <= b.length; i++) {
-    matrix[i] = [i];
-  }
-  for (let j = 0; j <= a.length; j++) {
-    matrix[0][j] = j;
-  }
-  for (let i = 1; i <= b.length; i++) {
-    for (let j = 1; j <= a.length; j++) {
-      if (b.charAt(i - 1) === a.charAt(j - 1)) {
-        matrix[i][j] = matrix[i - 1][j - 1];
-      } else {
-        matrix[i][j] = Math.min(
-          matrix[i - 1][j - 1] + 1,
-          matrix[i][j - 1] + 1,
-          matrix[i - 1][j] + 1
-        );
-      }
-    }
-  }
-  return matrix[b.length][a.length];
+  return formatFileNotFound({ target, allFiles, command: "context" });
 }
 
 // src/commands/areas.ts
@@ -2804,9 +2908,10 @@ async function areas(options = {}) {
   try {
     const config = readConfig(cwd);
     const allFiles = getAllCodeFiles2(cwd);
+    const filteredFiles = allFiles.filter((filePath) => !isFileIgnored(filePath, config));
     const areaMap = /* @__PURE__ */ new Map();
     const unmapped = [];
-    for (const filePath of allFiles) {
+    for (const filePath of filteredFiles) {
       const category = detectCategory(filePath);
       const areas2 = detectFileAreas(filePath, config);
       let description = getFileDescription(cwd, filePath);
@@ -2854,7 +2959,7 @@ async function areas(options = {}) {
       unmapped,
       summary: {
         totalAreas: detectedAreas.length,
-        totalFiles: allFiles.length,
+        totalFiles: filteredFiles.length,
         unmappedCount: unmapped.length
       }
     };
@@ -2921,9 +3026,10 @@ async function area(target, options = {}) {
   try {
     const config = readConfig(cwd);
     const allFiles = getAllCodeFiles3(cwd);
+    const filteredFiles = allFiles.filter((filePath) => !isFileIgnored(filePath, config));
     const areaFiles = [];
     const targetLower = target.toLowerCase();
-    for (const filePath of allFiles) {
+    for (const filePath of filteredFiles) {
       const fileAreas = detectFileAreas(filePath, config);
       const belongsToArea = fileAreas.some(
         (a) => a.toLowerCase() === targetLower || a.toLowerCase().includes(targetLower)
@@ -2945,8 +3051,8 @@ async function area(target, options = {}) {
       }
     }
     if (areaFiles.length === 0) {
-      const availableAreas = getAvailableAreas(allFiles, config);
-      return formatAreaNotFound(target, availableAreas);
+      const availableAreas = getAvailableAreas(filteredFiles, config);
+      return formatAreaNotFound2(target, availableAreas);
     }
     const byCategory = {};
     const categories = {};
@@ -2960,7 +3066,7 @@ async function area(target, options = {}) {
     for (const cat of Object.keys(byCategory)) {
       byCategory[cat].sort((a, b) => a.path.localeCompare(b.path));
     }
-    const realAreaId = findRealAreaId(target, allFiles, config);
+    const realAreaId = findRealAreaId(target, filteredFiles, config);
     const detectedArea = {
       id: realAreaId || target,
       name: getAreaName(realAreaId || target, config),
@@ -3013,33 +3119,8 @@ function getAvailableAreas(allFiles, config) {
   }
   return [...areaCounts.entries()].map(([id, count]) => ({ id, count })).sort((a, b) => b.count - a.count);
 }
-function formatAreaNotFound(target, availableAreas) {
-  let out = `
-\u274C \xC1rea n\xE3o encontrada: "${target}"
-
-`;
-  if (availableAreas.length > 0) {
-    out += `\u{1F4E6} \xC1reas dispon\xEDveis:
-
-`;
-    for (const { id, count } of availableAreas.slice(0, 15)) {
-      out += `   ${id.padEnd(25)} ${count} arquivos
-`;
-    }
-    if (availableAreas.length > 15) {
-      out += `   ... e mais ${availableAreas.length - 15}
-`;
-    }
-    out += `
-`;
-  }
-  out += `\u{1F4A1} Dicas:
-`;
-  out += `   - Use o ID exato da \xE1rea (ex: ai-tool area auth)
-`;
-  out += `   - Use 'ai-tool areas' para listar todas as \xE1reas
-`;
-  return out;
+function formatAreaNotFound2(target, availableAreas) {
+  return formatAreaNotFound({ target, availableAreas });
 }
 function getAllCodeFiles3(dir, files = [], baseDir = dir) {
   try {
@@ -3261,6 +3342,15 @@ export {
   map,
   dead,
   deadFix,
+  levenshteinDistance,
+  findSimilar,
+  findBestMatch,
+  extractFileName,
+  COMMAND_REFERENCE,
+  formatFileNotFound,
+  formatAreaNotFound,
+  formatMissingTarget,
+  formatInvalidCommand,
   impact,
   suggest,
   context,

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   impact,
   map,
   suggest
-} from "./chunk-A3QVUKVA.js";
+} from "./chunk-PHTWZ2JT.js";
 
 // src/cli.ts
 var HELP = `
@@ -87,7 +87,7 @@ async function main() {
     }
   }
   if (flags.mcp) {
-    const { startMcpServer } = await import("./server-DMLKPY45.js");
+    const { startMcpServer } = await import("./server-NIEAOPLJ.js");
     await startMcpServer();
     return;
   }

package/dist/index.d.ts

@@ -169,6 +169,7 @@ interface AreaConfig {
 interface AreasConfigFile {
     $schema?: string;
     version: string;
+    ignore?: string[];
     areas: Record<string, AreaConfig>;
     descriptions?: Record<string, string>;
     settings?: {
@@ -330,6 +331,139 @@ declare function isEntryPoint(filePath: string): boolean;
  */
 declare function isCodeFile(filePath: string): boolean;
 
+/**
+ * Funções de similaridade de strings
+ *
+ * Usa algoritmo de Levenshtein para calcular distância entre strings
+ * e encontrar candidatos similares para sugestões "você quis dizer?"
+ */
+/**
+ * Calcula a distância de Levenshtein entre duas strings
+ *
+ * A distância representa o número mínimo de operações (inserção, deleção, substituição)
+ * necessárias para transformar uma string na outra.
+ *
+ * @param a - Primeira string
+ * @param b - Segunda string
+ * @returns Número de edições necessárias
+ *
+ * @example
+ * levenshteinDistance('auth', 'auht') // 2 (troca de posição = 2 substituições)
+ * levenshteinDistance('auth', 'auth') // 0 (iguais)
+ * levenshteinDistance('auth', 'auths') // 1 (1 inserção)
+ */
+declare function levenshteinDistance(a: string, b: string): number;
+/**
+ * Opções para busca de itens similares
+ */
+interface FindSimilarOptions<T> {
+    /** Distância máxima de Levenshtein para considerar similar (default: 3) */
+    maxDistance?: number;
+    /** Número máximo de resultados (default: 5) */
+    limit?: number;
+    /** Normalizar para lowercase antes de comparar (default: true) */
+    normalize?: boolean;
+    /** Função para extrair a chave de comparação de cada item */
+    extractKey?: (item: T) => string;
+}
+/**
+ * Encontra itens similares a um target
+ *
+ * Usa Levenshtein distance e match de substring para encontrar candidatos.
+ * Substring match tem prioridade (score 0), seguido por Levenshtein.
+ *
+ * @param target - Termo buscado
+ * @param candidates - Lista de candidatos
+ * @param options - Configurações opcionais
+ * @returns Lista de candidatos similares, ordenados por relevância
+ *
+ * @example
+ * const areas = ['auth', 'dashboard', 'stripe'];
+ * findSimilar('auht', areas) // ['auth']
+ * findSimilar('dash', areas) // ['dashboard']
+ */
+declare function findSimilar<T>(target: string, candidates: T[], options?: FindSimilarOptions<T>): T[];
+/**
+ * Encontra o melhor match para sugestão "você quis dizer?"
+ *
+ * Mais restritivo que findSimilar (maxDistance: 2) para evitar
+ * sugestões incorretas.
+ *
+ * @param target - Termo buscado
+ * @param candidates - Lista de candidatos
+ * @param extractKey - Função para extrair chave de comparação
+ * @returns Melhor match ou null se não houver sugestão confiável
+ *
+ * @example
+ * findBestMatch('auht', ['auth', 'dashboard']) // 'auth'
+ * findBestMatch('xyz', ['auth', 'dashboard']) // null
+ */
+declare function findBestMatch<T>(target: string, candidates: T[], extractKey?: (item: T) => string): T | null;
+/**
+ * Extrai nome do arquivo de um caminho (sem extensão)
+ *
+ * Útil para comparar arquivos ignorando caminho e extensão.
+ *
+ * @param filePath - Caminho do arquivo
+ * @returns Nome do arquivo sem extensão
+ *
+ * @example
+ * extractFileName('src/hooks/useAuth.ts') // 'useAuth'
+ * extractFileName('Button.tsx') // 'Button'
+ */
+declare function extractFileName(filePath: string): string;
+
+/**
+ * Formatadores de mensagens de erro com sugestões inteligentes
+ *
+ * Todas as funções retornam strings formatadas para exibição,
+ * com sugestões "você quis dizer?" e referência de comandos.
+ */
+/**
+ * Referência rápida de comandos disponíveis
+ */
+declare const COMMAND_REFERENCE: Record<string, string>;
+interface FormatFileNotFoundOptions {
+    /** Termo buscado */
+    target: string;
+    /** Lista de todos os arquivos disponíveis */
+    allFiles: string[];
+    /** Comando que gerou o erro (para contexto) */
+    command?: string;
+}
+/**
+ * Formata mensagem de arquivo não encontrado
+ *
+ * Inclui sugestões de arquivos similares e referência de comandos.
+ */
+declare function formatFileNotFound(options: FormatFileNotFoundOptions): string;
+interface AreaInfo {
+    /** ID da área */
+    id: string;
+    /** Número de arquivos na área */
+    count: number;
+}
+interface FormatAreaNotFoundOptions {
+    /** Termo buscado */
+    target: string;
+    /** Lista de áreas disponíveis */
+    availableAreas: AreaInfo[];
+}
+/**
+ * Formata mensagem de área não encontrada
+ *
+ * Inclui sugestões de áreas similares usando Levenshtein.
+ */
+declare function formatAreaNotFound(options: FormatAreaNotFoundOptions): string;
+/**
+ * Formata mensagem de target obrigatório faltando
+ */
+declare function formatMissingTarget(command: string): string;
+/**
+ * Formata mensagem de comando inválido
+ */
+declare function formatInvalidCommand(command: string): string;
+
 /**
  * Utilitários para detecção de Firebase Cloud Functions
  *
@@ -516,4 +650,4 @@ declare const AREA_DESCRIPTIONS: Record<string, string>;
 
 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 };
+export { AREA_DESCRIPTIONS, AREA_NAMES, type AreaConfig, type AreaDetailResult, type AreaFile, type AreaInfo, type AreaOptions, type AreasConfigFile, type AreasOptions, type AreasResult, COMMAND_REFERENCE, type CommandOptions, type ContextOptions, type ContextResult, type DeadFile, type DeadOptions, type DeadResult, type DetectedArea, FOLDER_PATTERNS, type FileCategory, type FileInfo, type FindSimilarOptions, type FolderStats, type FormatAreaNotFoundOptions, type FormatFileNotFoundOptions, 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, extractFileName, filterCloudFunctionsFalsePositives, findBestMatch, findSimilar, formatAreaNotFound, formatFileNotFound, formatInvalidCommand, formatMissingTarget, getAreaDescription, getAreaName, getCacheDir, getFileDescription, hasFirebaseFunctions, impact, inferFileDescription, invalidateCache, isCacheValid, isCodeFile, isEntryPoint, isExportedCloudFunction, isFirebaseProject, levenshteinDistance, map, readConfig, removeArea, setArea, setFileDescription, suggest, writeConfig };

package/dist/index.js

@@ -1,6 +1,7 @@
 import {
   AREA_DESCRIPTIONS,
   AREA_NAMES,
+  COMMAND_REFERENCE,
   FOLDER_PATTERNS,
   KEYWORD_PATTERNS,
   VERSION,
@@ -15,7 +16,14 @@ import {
   deadFix,
   detectCategory,
   detectFileAreas,
+  extractFileName,
   filterCloudFunctionsFalsePositives,
+  findBestMatch,
+  findSimilar,
+  formatAreaNotFound,
+  formatFileNotFound,
+  formatInvalidCommand,
+  formatMissingTarget,
   getAreaDescription,
   getAreaName,
   getCacheDir,
@@ -29,6 +37,7 @@ import {
   isEntryPoint,
   isExportedCloudFunction,
   isFirebaseProject,
+  levenshteinDistance,
   map,
   readConfig,
   removeArea,
@@ -36,10 +45,11 @@ import {
   setFileDescription,
   suggest,
   writeConfig
-} from "./chunk-A3QVUKVA.js";
+} from "./chunk-PHTWZ2JT.js";
 export {
   AREA_DESCRIPTIONS,
   AREA_NAMES,
+  COMMAND_REFERENCE,
   FOLDER_PATTERNS,
   KEYWORD_PATTERNS,
   VERSION,
@@ -54,7 +64,14 @@ export {
   deadFix,
   detectCategory,
   detectFileAreas,
+  extractFileName,
   filterCloudFunctionsFalsePositives,
+  findBestMatch,
+  findSimilar,
+  formatAreaNotFound,
+  formatFileNotFound,
+  formatInvalidCommand,
+  formatMissingTarget,
   getAreaDescription,
   getAreaName,
   getCacheDir,
@@ -68,6 +85,7 @@ export {
   isEntryPoint,
   isExportedCloudFunction,
   isFirebaseProject,
+  levenshteinDistance,
   map,
   readConfig,
   removeArea,

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

@@ -8,7 +8,7 @@ import {
   impact,
   map,
   suggest
-} from "./chunk-A3QVUKVA.js";
+} from "./chunk-PHTWZ2JT.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": "0.5.1",
+  "version": "0.5.4",
   "description": "Ferramenta de análise de dependências e impacto para projetos TypeScript/JavaScript. Usa Skott + Knip internamente.",
   "keywords": [
     "dependency-analysis",