@justmpm/ai-tool 0.9.2 → 1.0.0

package/dist/{chunk-6ZWPDZDS.js → chunk-LC7H7LGY.js}

@@ -143,8 +143,235 @@ function isCodeFile(filePath) {
   return CODE_EXTENSIONS.some((ext) => filePath.endsWith(ext));
 }
 
+// src/utils/hints.ts
+var COMMAND_MAP = {
+  map: {
+    cli: "ai-tool map",
+    mcp: "analyze__aitool_project_map"
+  },
+  dead: {
+    cli: "ai-tool dead",
+    mcp: "analyze__aitool_dead_code"
+  },
+  impact: {
+    cli: "ai-tool impact <arquivo>",
+    mcp: "analyze__aitool_impact_analysis { target: '<arquivo>' }"
+  },
+  suggest: {
+    cli: "ai-tool suggest <arquivo>",
+    mcp: "analyze__aitool_suggest_reads { target: '<arquivo>' }"
+  },
+  context: {
+    cli: "ai-tool context <arquivo>",
+    mcp: "analyze__aitool_file_context { target: '<arquivo>' }"
+  },
+  area_context: {
+    cli: "ai-tool context --area=<nome>",
+    mcp: "analyze__aitool_area_context { area: '<nome>' }"
+  },
+  areas: {
+    cli: "ai-tool areas",
+    mcp: "analyze__aitool_list_areas"
+  },
+  area: {
+    cli: "ai-tool area <nome>",
+    mcp: "analyze__aitool_area_detail { target: '<nome>' }"
+  },
+  areas_init: {
+    cli: "ai-tool areas init",
+    mcp: "analyze__aitool_areas_init"
+  },
+  find: {
+    cli: "ai-tool find <termo>",
+    mcp: "analyze__aitool_find { query: '<termo>' }"
+  },
+  describe: {
+    cli: "ai-tool describe <termo>",
+    mcp: "analyze__aitool_describe { query: '<termo>' }"
+  },
+  functions: {
+    cli: "ai-tool functions",
+    mcp: "analyze__aitool_list_functions"
+  }
+};
+function hint(command, ctx, params) {
+  const mapping = COMMAND_MAP[command];
+  if (!mapping) return command;
+  let instruction = mapping[ctx];
+  if (params) {
+    for (const [placeholder, value] of Object.entries(params)) {
+      instruction = instruction.replaceAll(placeholder, value);
+    }
+  }
+  return instruction;
+}
+var NEXT_STEPS = {
+  map: [
+    { command: "area", description: "ver arquivos de uma area" },
+    { command: "suggest", description: "o que ler antes de editar" },
+    { command: "context", description: "ver API de um arquivo" }
+  ],
+  impact: [
+    { command: "suggest", description: "o que ler antes de editar este arquivo" },
+    { command: "context", description: "ver assinaturas dos arquivos upstream" },
+    { command: "find", description: "localizar usos de exports especificos" }
+  ],
+  suggest: [
+    { command: "context", description: "ver assinaturas de cada arquivo sugerido" },
+    { command: "impact", description: "ver impacto completo da mudanca" }
+  ],
+  context: [
+    { command: "impact", description: "ver quem sera afetado por mudancas" },
+    { command: "find", description: "localizar usos de uma funcao ou tipo" },
+    { command: "suggest", description: "o que ler antes de editar" }
+  ],
+  area_context: [
+    { command: "find", description: "buscar usos de simbolos desta area" },
+    { command: "area", description: "ver lista de arquivos desta area" },
+    { command: "impact", description: "ver impacto de modificar um arquivo" }
+  ],
+  find: [
+    { command: "context", description: "ver assinaturas completas do arquivo" },
+    { command: "impact", description: "ver impacto de modificar o arquivo" },
+    { command: "describe", description: "buscar areas por descricao" }
+  ],
+  describe: [
+    { command: "area", description: "ver detalhes de uma area" },
+    { command: "area_context", description: "contexto completo de uma area" }
+  ],
+  areas: [
+    { command: "area", description: "ver arquivos de uma area especifica" },
+    { command: "describe", description: "buscar areas por descricao" }
+  ],
+  area: [
+    { command: "area_context", description: "contexto consolidado (tipos, hooks, funcoes)" },
+    { command: "context", description: "ver assinaturas de um arquivo especifico" },
+    { command: "find", description: "buscar simbolos dentro da area" }
+  ],
+  dead: [
+    { command: "impact", description: "verificar se um arquivo morto e realmente nao usado" },
+    { command: "map", description: "ver estrutura atualizada do projeto" }
+  ],
+  functions: [
+    { command: "find", description: "buscar uma Cloud Function especifica" },
+    { command: "impact", description: "ver impacto de modificar uma function" },
+    { command: "context", description: "ver assinaturas de uma function" }
+  ]
+};
+function nextSteps(command, ctx) {
+  const steps = NEXT_STEPS[command];
+  if (!steps || steps.length === 0) return "";
+  let out = "\n\u{1F4D6} Proximos passos:\n";
+  for (const step of steps) {
+    const instruction = hint(step.command, ctx);
+    out += `   \u2192 ${instruction} - ${step.description}
+`;
+  }
+  return out;
+}
+function recoveryHint(errorType, ctx, _extra) {
+  switch (errorType) {
+    case "file_not_found":
+      return `
+\u{1F4A1} Dicas:
+   \u2192 ${hint("map", ctx)} - ver arquivos disponiveis
+   \u2192 ${hint("find", ctx)} - buscar por nome de simbolo
+`;
+    case "area_not_found":
+      return `
+\u{1F4A1} Dicas:
+   \u2192 ${hint("areas", ctx)} - listar areas disponiveis
+   \u2192 ${hint("describe", ctx)} - buscar areas por descricao
+   \u2192 ${hint("areas_init", ctx)} - gerar configuracao de areas
+`;
+    case "no_results":
+      return `
+\u{1F4A1} Dicas:
+   \u2192 ${hint("find", ctx)} - buscar com outro termo
+   \u2192 ${hint("describe", ctx)} - buscar areas por descricao
+   \u2192 ${hint("map", ctx)} - ver estrutura do projeto
+`;
+    case "no_firebase":
+      return `
+\u{1F4A1} Este projeto nao usa Firebase. Comandos disponiveis:
+   \u2192 ${hint("map", ctx)} - ver estrutura do projeto
+   \u2192 ${hint("find", ctx)} - buscar simbolos no codigo
+   \u2192 ${hint("areas", ctx)} - listar areas funcionais
+`;
+    case "generic":
+      return `
+\u{1F4A1} Tente:
+   \u2192 ${hint("map", ctx)} - verificar estrutura do projeto
+   \u2192 Verifique se o caminho (cwd) esta correto
+`;
+  }
+}
+
+// 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/formatters/text.ts
-function formatMapSummary(result, areasInfo) {
+function formatMapSummary(result, areasInfo, ctx = "cli") {
   let out = "";
   out += `\u{1F4CA} ${result.summary.totalFiles} arquivos | ${result.summary.totalFolders} pastas
 `;
@@ -172,9 +399,15 @@ function formatMapSummary(result, areasInfo) {
   }
   out += `   ${catParts.join(", ")}
 `;
+  const topFolders = result.folders.sort((a, b) => b.fileCount - a.fileCount).slice(0, 5);
+  if (topFolders.length > 0) {
+    const folderParts = topFolders.map((f) => `${f.path}/ (${f.fileCount})`);
+    out += `\u{1F4C1} ${folderParts.join(", ")}
+`;
+  }
   if (areasInfo && areasInfo.total > 0) {
     out += `
-\u{1F5C2}\uFE0F \xC1reas: ${areasInfo.names.join(", ")}
+\u{1F5C2}\uFE0F Areas: ${areasInfo.names.join(", ")}
 `;
   }
   out += `
@@ -185,43 +418,30 @@ function formatMapSummary(result, areasInfo) {
 `;
     out += `   ${cloudFunctionCount} function(s) em functions/src/
 `;
-    out += `   \u2192 Use 'ai-tool functions' para listar triggers
+    out += `   \u2192 ${hint("functions", ctx)}
 
 `;
   }
   if (result.circularDependencies.length > 0) {
-    out += `\u26A0\uFE0F ${result.circularDependencies.length} depend\xEAncia(s) circular(es) detectada(s)
+    out += `\u26A0\uFE0F ${result.circularDependencies.length} dependencia(s) circular(es) detectada(s)
 `;
-    out += `   \u2192 Use impact <arquivo> para investigar
+    out += `   \u2192 ${hint("impact", ctx)} para investigar
 
 `;
   }
   if (areasInfo && areasInfo.unmappedCount > 0) {
-    out += `\u26A0\uFE0F ${areasInfo.unmappedCount} arquivo(s) sem \xE1rea definida
+    out += `\u26A0\uFE0F ${areasInfo.unmappedCount} arquivo(s) sem area definida
 `;
-    out += `   \u2192 Use areas init para configurar
+    out += `   \u2192 ${hint("areas_init", ctx)} para configurar
 
 `;
   }
-  out += `\u{1F4D6} Pr\xF3ximos passos:
-`;
-  out += `   \u2192 area <nome> - ver arquivos de uma \xE1rea
-`;
-  out += `   \u2192 suggest <arquivo> - o que ler antes de editar
-`;
-  out += `   \u2192 context <arquivo> - ver API de um arquivo
-`;
+  out += nextSteps("map", ctx);
   return out;
 }
-function formatMapText(result) {
+function formatMapText(result, ctx = "cli") {
   let out = "";
-  out += `
-`;
-  out += `\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
-`;
-  out += `\u2551                    \u{1F4C1} PROJECT MAP                           \u2551
-`;
-  out += `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+  out += `## \u{1F4C1} PROJECT MAP
 
 `;
   out += `\u{1F4CA} RESUMO
@@ -230,7 +450,7 @@ function formatMapText(result) {
 `;
   out += `   Pastas: ${result.summary.totalFolders}
 `;
-  out += `   Diret\xF3rio: ${result.cwd}
+  out += `   Diretorio: ${result.cwd}
 
 `;
   out += `\u{1F4C2} CATEGORIAS
@@ -272,7 +492,7 @@ function formatMapText(result) {
   }
   if (result.circularDependencies.length > 0) {
     out += `
-\u26A0\uFE0F DEPEND\xCANCIAS CIRCULARES (${result.circularDependencies.length})
+\u26A0\uFE0F DEPENDENCIAS CIRCULARES (${result.circularDependencies.length})
 `;
     for (const cycle of result.circularDependencies.slice(0, 5)) {
       out += `   ${cycle.join(" \u2192 ")}
@@ -283,41 +503,37 @@ function formatMapText(result) {
 `;
     }
   }
+  out += nextSteps("map", ctx);
   return out;
 }
-function formatDeadText(result) {
+function formatDeadText(result, ctx = "cli") {
   let out = "";
-  out += `
-`;
-  out += `\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
-`;
-  out += `\u2551                    \u{1F480} DEAD CODE                              \u2551
-`;
-  out += `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+  out += `## \u{1F480} DEAD CODE
 
 `;
   if (result.summary.totalDead === 0) {
-    out += `\u2705 Nenhum c\xF3digo morto encontrado!
+    out += `\u2705 Nenhum codigo morto encontrado!
 `;
-    out += `   Todos os arquivos e exports est\xE3o sendo utilizados.
+    out += `   Todos os arquivos e exports estao sendo utilizados.
 `;
+    out += nextSteps("dead", ctx);
     return out;
   }
   out += `\u{1F4CA} RESUMO
 `;
-  out += `   Total: ${result.summary.totalDead} itens n\xE3o utilizados
+  out += `   Total: ${result.summary.totalDead} itens nao utilizados
 `;
-  out += `   Arquivos \xF3rf\xE3os: ${result.summary.byType.files}
+  out += `   Arquivos orfaos: ${result.summary.byType.files}
 `;
-  out += `   Exports n\xE3o usados: ${result.summary.byType.exports}
+  out += `   Exports nao usados: ${result.summary.byType.exports}
 `;
-  out += `   Depend\xEAncias n\xE3o usadas: ${result.summary.byType.dependencies}
+  out += `   Dependencias nao usadas: ${result.summary.byType.dependencies}
 
 `;
   if (result.files.length > 0) {
-    out += `\u{1F5D1}\uFE0F ARQUIVOS \xD3RF\xC3OS (${result.files.length})
+    out += `\u{1F5D1}\uFE0F ARQUIVOS ORFAOS (${result.files.length})
 `;
-    out += `   Arquivos que ningu\xE9m importa:
+    out += `   Arquivos que ninguem importa:
 
 `;
     const byCategory = /* @__PURE__ */ new Map();
@@ -344,7 +560,7 @@ function formatDeadText(result) {
     }
   }
   if (result.exports.length > 0) {
-    out += `\u{1F4E4} EXPORTS N\xC3O USADOS (${result.exports.length})
+    out += `\u{1F4E4} EXPORTS NAO USADOS (${result.exports.length})
 `;
     for (const exp of result.exports.slice(0, 10)) {
       out += `   ${exp.file}: ${exp.export}
@@ -358,7 +574,7 @@ function formatDeadText(result) {
 `;
   }
   if (result.dependencies.length > 0) {
-    out += `\u{1F4E6} DEPEND\xCANCIAS N\xC3O USADAS (${result.dependencies.length})
+    out += `\u{1F4E6} DEPENDENCIAS NAO USADAS (${result.dependencies.length})
 `;
     for (const dep of result.dependencies) {
       out += `   ${dep}
@@ -394,12 +610,12 @@ function formatDeadText(result) {
 `;
   out += `   3. Ver detalhes em JSON:
 `;
-  out += `      ai-tool dead --format=json
+  out += `      ${hint("dead", ctx)} --format=json
 `;
   const suggestions = generateIgnoreSuggestions(result);
   if (suggestions.length > 0) {
     out += `
-\u{1F3AF} SUGEST\xD5ES INTELIGENTES
+\u{1F3AF} SUGESTOES INTELIGENTES
 
 `;
     for (const suggestion of suggestions) {
@@ -412,6 +628,7 @@ function formatDeadText(result) {
 `;
     }
   }
+  out += nextSteps("dead", ctx);
   return out;
 }
 function generateIgnoreSuggestions(result) {
@@ -431,7 +648,7 @@ function generateIgnoreSuggestions(result) {
     suggestions.push({
       icon: "\u{1F9EA}",
       pattern: "**/*.(test|spec).(ts|tsx|js|jsx)",
-      reason: "Arquivos de teste geralmente s\xE3o entry points pr\xF3prios",
+      reason: "Arquivos de teste geralmente sao entry points proprios",
       count: testFiles.length
     });
   }
@@ -442,7 +659,7 @@ function generateIgnoreSuggestions(result) {
     suggestions.push({
       icon: "\u2699\uFE0F",
       pattern: "**/*.config.(ts|js|mjs|cjs)",
-      reason: "Arquivos de configura\xE7\xE3o s\xE3o entry points",
+      reason: "Arquivos de configuracao sao entry points",
       count: configFiles.length
     });
   }
@@ -451,7 +668,7 @@ function generateIgnoreSuggestions(result) {
     suggestions.push({
       icon: "\u{1F4D8}",
       pattern: "**/*.d.ts",
-      reason: "Arquivos de defini\xE7\xE3o TypeScript",
+      reason: "Arquivos de definicao TypeScript",
       count: dtsFiles.length
     });
   }
@@ -460,21 +677,15 @@ function generateIgnoreSuggestions(result) {
     suggestions.push({
       icon: "\u{1F4DC}",
       pattern: "scripts/**",
-      reason: "Scripts de automa\xE7\xE3o s\xE3o entry points",
+      reason: "Scripts de automacao sao entry points",
       count: scriptFiles.length
     });
   }
   return suggestions;
 }
-function formatImpactText(result) {
+function formatImpactText(result, ctx = "cli") {
   let out = "";
-  out += `
-`;
-  out += `\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
-`;
-  out += `\u2551                    \u{1F3AF} IMPACT ANALYSIS                        \u2551
-`;
-  out += `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+  out += `## \u{1F3AF} IMPACT ANALYSIS
 
 `;
   const icon = categoryIcons[result.category];
@@ -483,10 +694,7 @@ function formatImpactText(result) {
   out += `   ${icon} ${result.category}
 
 `;
-  out += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
-`;
-  out += `\u2B06\uFE0F USADO POR (${result.upstream.total} arquivo${result.upstream.total !== 1 ? "s" : ""} \xFAnico${result.upstream.total !== 1 ? "s" : ""})
+  out += `\u2B06\uFE0F USADO POR (${result.upstream.total} arquivo${result.upstream.total !== 1 ? "s" : ""} unico${result.upstream.total !== 1 ? "s" : ""})
 `;
   if (result.upstream.direct.length > 0 || result.upstream.indirect.length > 0) {
     out += `   \u{1F4CD} ${result.upstream.direct.length} direto${result.upstream.direct.length !== 1 ? "s" : ""} + ${result.upstream.indirect.length} indireto${result.upstream.indirect.length !== 1 ? "s" : ""}
@@ -496,7 +704,7 @@ function formatImpactText(result) {
 
 `;
   if (result.upstream.total === 0) {
-    out += `   Ningu\xE9m importa este arquivo diretamente.
+    out += `   Ninguem importa este arquivo diretamente.
 `;
   } else {
     for (const file of result.upstream.direct.slice(0, 10)) {
@@ -519,10 +727,8 @@ function formatImpactText(result) {
     }
   }
   out += `
-\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
 `;
-  out += `\u2B07\uFE0F DEPEND\xCANCIAS (${result.downstream.total} arquivo${result.downstream.total !== 1 ? "s" : ""} \xFAnico${result.downstream.total !== 1 ? "s" : ""})
+  out += `\u2B07\uFE0F DEPENDENCIAS (${result.downstream.total} arquivo${result.downstream.total !== 1 ? "s" : ""} unico${result.downstream.total !== 1 ? "s" : ""})
 `;
   if (result.downstream.direct.length > 0 || result.downstream.indirect.length > 0) {
     out += `   \u{1F4CD} ${result.downstream.direct.length} direto${result.downstream.direct.length !== 1 ? "s" : ""} + ${result.downstream.indirect.length} indireto${result.downstream.indirect.length !== 1 ? "s" : ""}
@@ -532,7 +738,7 @@ function formatImpactText(result) {
 
 `;
   if (result.downstream.total === 0) {
-    out += `   Este arquivo n\xE3o importa nenhum arquivo local.
+    out += `   Este arquivo nao importa nenhum arquivo local.
 `;
   } else {
     for (const file of result.downstream.direct.slice(0, 10)) {
@@ -546,15 +752,13 @@ function formatImpactText(result) {
     }
   }
   out += `
-\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
 `;
-  out += `\u{1F4CA} M\xC9TRICAS DE IMPACTO
+  out += `\u{1F4CA} METRICAS DE IMPACTO
 
 `;
-  out += `   Arquivos que importam este (upstream):  ${result.upstream.total} \xFAnico${result.upstream.total !== 1 ? "s" : ""}
+  out += `   Arquivos que importam este (upstream):  ${result.upstream.total} unico${result.upstream.total !== 1 ? "s" : ""}
 `;
-  out += `   Arquivos que este importa (downstream): ${result.downstream.total} \xFAnico${result.downstream.total !== 1 ? "s" : ""}
+  out += `   Arquivos que este importa (downstream): ${result.downstream.total} unico${result.downstream.total !== 1 ? "s" : ""}
 `;
   if (result.risks.length > 0) {
     out += `
@@ -569,7 +773,7 @@ function formatImpactText(result) {
   }
   if (result.suggestions.length > 0) {
     out += `
-\u{1F4A1} SUGEST\xD5ES
+\u{1F4A1} SUGESTOES
 
 `;
     for (const suggestion of result.suggestions) {
@@ -579,11 +783,11 @@ function formatImpactText(result) {
   }
   if (result.gitHistory && result.gitHistory.hasGitRepo) {
     out += `
-\u{1F4DC} HIST\xD3RICO GIT (\xFAltimos ${result.gitHistory.recentCommits.length} commits)
+\u{1F4DC} HISTORICO GIT (ultimos ${result.gitHistory.recentCommits.length} commits)
 
 `;
     if (result.gitHistory.recentCommits.length === 0) {
-      out += `   Arquivo n\xE3o est\xE1 no reposit\xF3rio Git ou sem hist\xF3rico.
+      out += `   Arquivo nao esta no repositorio Git ou sem historico.
 `;
     } else {
       for (const commit of result.gitHistory.recentCommits) {
@@ -599,17 +803,12 @@ function formatImpactText(result) {
       }
     }
   }
+  out += nextSteps("impact", ctx);
   return out;
 }
-function formatSuggestText(result) {
+function formatSuggestText(result, ctx = "cli") {
   let out = "";
-  out += `
-`;
-  out += `\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
-`;
-  out += `\u2551                    \u{1F4DA} SUGGEST                                \u2551
-`;
-  out += `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+  out += `## \u{1F4DA} SUGGEST
 
 `;
   const icon = categoryIcons[result.category];
@@ -623,11 +822,9 @@ function formatSuggestText(result) {
 `;
     out += `   Este arquivo nao tem dependencias ou arquivos relacionados.
 `;
+    out += nextSteps("suggest", ctx);
     return out;
   }
-  out += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
-`;
   const byPriority = {
     critical: result.suggestions.filter((s) => s.priority === "critical"),
     high: result.suggestions.filter((s) => s.priority === "high"),
@@ -698,9 +895,6 @@ function formatSuggestText(result) {
     out += `
 `;
   }
-  out += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
-`;
   out += `\u{1F4CA} RESUMO
 `;
   out += `   Total de arquivos sugeridos: ${result.suggestions.length}
@@ -723,10 +917,7 @@ function formatSuggestText(result) {
   }
   if (result.testSuggestions.length > 0) {
     out += `
-\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
-`;
-    out += `\u{1F9EA} TESTES E VERIFICA\xC7\xD5ES
+\u{1F9EA} TESTES E VERIFICACOES
 
 `;
     for (const testSuggestion of result.testSuggestions) {
@@ -734,17 +925,12 @@ function formatSuggestText(result) {
 `;
     }
   }
+  out += nextSteps("suggest", ctx);
   return out;
 }
-function formatContextText(result) {
+function formatContextText(result, ctx = "cli") {
   let out = "";
-  out += `
-`;
-  out += `\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
-`;
-  out += `\u2551                    \u{1F4C4} CONTEXT                                \u2551
-`;
-  out += `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+  out += `## \u{1F4C4} CONTEXT
 
 `;
   const icon = categoryIcons[result.category];
@@ -752,9 +938,6 @@ function formatContextText(result) {
 `;
   out += `   ${icon} ${result.category}
 
-`;
-  out += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
 `;
   if (result.imports.length > 0) {
     out += `\u{1F4E5} IMPORTS (${result.imports.length})
@@ -798,10 +981,10 @@ function formatContextText(result) {
 `;
     for (const fn of result.functions) {
       const exported = fn.isExported ? "export " : "";
-      const async = fn.isAsync ? "async " : "";
+      const asyncLabel = fn.isAsync ? "async " : "";
       const arrow = fn.isArrowFunction ? " =>" : "";
       const params = fn.params.map((p) => `${p.name}: ${p.type}`).join(", ");
-      out += `   ${exported}${async}${fn.name}(${params})${arrow}: ${fn.returnType}
+      out += `   ${exported}${asyncLabel}${fn.name}(${params})${arrow}: ${fn.returnType}
 `;
       if (fn.jsdoc) {
         out += `      /** ${fn.jsdoc} */
@@ -811,9 +994,18 @@ function formatContextText(result) {
 `;
     }
   }
-  out += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+  if (result.constants && result.constants.length > 0) {
+    out += `\u{1F4CC} CONSTANTS (${result.constants.length})
 
 `;
+    for (const c of result.constants) {
+      const exported = c.isExported ? "export " : "";
+      out += `   ${exported}${c.name}: ${c.type}
+`;
+    }
+    out += `
+`;
+  }
   out += `\u{1F4CA} RESUMO
 `;
   out += `   Imports: ${result.imports.length}
@@ -824,35 +1016,31 @@ function formatContextText(result) {
 `;
   out += `   Functions: ${result.functions.length}
 `;
+  if (result.constants && result.constants.length > 0) {
+    out += `   Constants: ${result.constants.length}
+`;
+  }
+  out += nextSteps("context", ctx);
   return out;
 }
-function formatAreasText(result) {
+function formatAreasText(result, ctx = "cli") {
   let out = "";
-  out += `
-`;
-  out += `\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
-`;
-  out += `\u2551                    \u{1F4E6} PROJECT AREAS                         \u2551
-`;
-  out += `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+  out += `## \u{1F4E6} PROJECT AREAS
 
 `;
   out += `\u{1F4CA} RESUMO
 `;
-  out += `   \xC1reas: ${result.summary.totalAreas}
+  out += `   Areas: ${result.summary.totalAreas}
 `;
   out += `   Arquivos: ${result.summary.totalFiles}
 `;
   if (result.summary.unmappedCount > 0) {
-    out += `   \u26A0\uFE0F Sem \xE1rea: ${result.summary.unmappedCount}
+    out += `   \u26A0\uFE0F Sem area: ${result.summary.unmappedCount}
 `;
   }
   out += `
 `;
-  out += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
-`;
-  out += `\u{1F4E6} \xC1REAS DETECTADAS
+  out += `\u{1F4E6} AREAS DETECTADAS
 
 `;
   for (const area2 of result.areas) {
@@ -872,15 +1060,12 @@ function formatAreasText(result) {
 `;
   }
   if (result.unmapped.length > 0) {
-    out += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
-`;
-    out += `\u26A0\uFE0F ARQUIVOS SEM \xC1REA (${result.unmapped.length})
+    out += `\u26A0\uFE0F ARQUIVOS SEM AREA (${result.unmapped.length})
 
 `;
     for (const file of result.unmapped.slice(0, 10)) {
-      const icon = categoryIcons[file.category];
-      out += `   ${icon} ${file.path}
+      const fileIcon = categoryIcons[file.category];
+      out += `   ${fileIcon} ${file.path}
 `;
     }
     if (result.unmapped.length > 10) {
@@ -888,32 +1073,19 @@ function formatAreasText(result) {
 `;
     }
     out += `
-\u{1F4A1} Adicione padr\xF5es em .analyze/areas.config.json
+\u{1F4A1} Adicione padroes em .analyze/areas.config.json
 `;
-    out += `   ou execute 'ai-tool areas init' para gerar configura\xE7\xE3o
+    out += `   ou execute ${hint("areas_init", ctx)} para gerar configuracao
 `;
   }
-  out += `
-\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
-`;
-  out += `\u{1F4A1} Use 'ai-tool area <nome>' para ver detalhes de uma \xE1rea
-`;
-  out += `   Exemplo: ai-tool area auth
-`;
+  out += nextSteps("areas", ctx);
   return out;
 }
-function formatAreaDetailText(result, options = {}) {
+function formatAreaDetailText(result, options = {}, ctx = "cli") {
   const { full = false, filterType } = options;
   const { area: area2, byCategory } = result;
   let out = "";
-  out += `
-`;
-  out += `\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
-`;
-  out += `\u2551                    \u{1F4E6} AREA DETAIL                           \u2551
-`;
-  out += `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+  out += `## \u{1F4E6} AREA DETAIL
 
 `;
   out += `\u{1F4E6} ${area2.name}
@@ -951,9 +1123,6 @@ function formatAreaDetailText(result, options = {}) {
   out += catParts.join("  ");
   out += `
 
-`;
-  out += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
 `;
   if (filterType) {
     const files = byCategory[filterType] || [];
@@ -965,6 +1134,7 @@ function formatAreaDetailText(result, options = {}) {
       out += `   ${file.path}${desc}
 `;
     }
+    out += nextSteps("area", ctx);
     return out;
   }
   const maxFilesPerCategory = full ? 100 : 8;
@@ -996,17 +1166,12 @@ function formatAreaDetailText(result, options = {}) {
     out += `\u{1F4A1} Use --full para ver todos os arquivos
 `;
   }
+  out += nextSteps("area", ctx);
   return out;
 }
-function formatFindText(result) {
+function formatFindText(result, ctx = "cli", symbolNames) {
   let out = "";
-  out += `
-`;
-  out += `\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
-`;
-  out += `\u2551                    \u{1F50D} FIND                                   \u2551
-`;
-  out += `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+  out += `## \u{1F50D} FIND
 
 `;
   if (result.query) {
@@ -1021,7 +1186,7 @@ function formatFindText(result) {
 
 `;
   } else {
-    out += `\u{1F4CB} Listando todos os s\xEDmbolos do tipo: ${result.filters.type || "all"}
+    out += `\u{1F4CB} Listando todos os simbolos do tipo: ${result.filters.type || "all"}
 
 `;
   }
@@ -1031,33 +1196,45 @@ function formatFindText(result) {
 
 `;
     } else {
-      out += `\u274C Nenhum s\xEDmbolo do tipo "${result.filters.type}" encontrado
+      out += `\u274C Nenhum simbolo do tipo "${result.filters.type}" encontrado
 
 `;
     }
+    if (symbolNames && symbolNames.length > 0 && result.query) {
+      const similar = findSimilar(result.query, symbolNames, { maxDistance: 3, limit: 5 });
+      if (similar.length > 0) {
+        out += `\u{1F4A1} Voce quis dizer?
+`;
+        for (const name of similar) {
+          out += `   \u2192 ${hint("find", ctx, { "<termo>": name })}
+`;
+        }
+        out += `
+`;
+      }
+    }
     out += `\u{1F4A1} Dicas:
 `;
-    out += `   \u2022 Verifique a ortografia
+    out += `   \u2192 Verifique a ortografia
 `;
-    out += `   \u2022 Tente buscar parte do nome
+    out += `   \u2192 Tente buscar parte do nome
 `;
-    out += `   \u2022 Remova filtros de tipo ou \xE1rea
+    out += `   \u2192 Remova filtros de tipo ou area
+`;
+    out += `   \u2192 ${hint("describe", ctx)} - buscar areas por descricao
 `;
     return out;
   }
-  out += `\u{1F4CA} ${result.summary.definitions} defini\xE7\xE3o, ${result.summary.references} refer\xEAncias em ${result.summary.files} arquivos
-
-`;
-  out += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+  out += `\u{1F4CA} ${result.summary.definitions} definicao, ${result.summary.references} referencias em ${result.summary.files} arquivos
 
 `;
   if (result.definition) {
-    out += `\u{1F4CD} DEFINI\xC7\xC3O
+    out += `\u{1F4CD} DEFINICAO
 
 `;
     const def = result.definition;
-    const icon = categoryIcons[def.category];
-    out += `   ${icon} ${def.file}:${def.line}
+    const defIcon = categoryIcons[def.category];
+    out += `   ${defIcon} ${def.file}:${def.line}
 `;
     out += `      ${def.code}
 `;
@@ -1072,8 +1249,8 @@ function formatFindText(result) {
 
 `;
       for (const ref of imports.slice(0, 10)) {
-        const icon = categoryIcons[ref.category];
-        out += `   ${icon} ${ref.file}:${ref.line}
+        const refIcon = categoryIcons[ref.category];
+        out += `   ${refIcon} ${ref.file}:${ref.line}
 `;
         out += `      ${ref.code}
 `;
@@ -1090,8 +1267,8 @@ function formatFindText(result) {
 
 `;
       for (const ref of usages.slice(0, 15)) {
-        const icon = categoryIcons[ref.category];
-        out += `   ${icon} ${ref.file}:${ref.line}
+        const refIcon = categoryIcons[ref.category];
+        out += `   ${refIcon} ${ref.file}:${ref.line}
 `;
         out += `      ${ref.code}
 `;
@@ -1106,15 +1283,9 @@ function formatFindText(result) {
   }
   return out;
 }
-function formatAreaContextText(result) {
+function formatAreaContextText(result, ctx = "cli") {
   let out = "";
-  out += `
-`;
-  out += `\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
-`;
-  out += `\u2551                    \u{1F4E6} AREA CONTEXT                          \u2551
-`;
-  out += `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+  out += `## \u{1F4E6} AREA CONTEXT
 
 `;
   out += `\u{1F4E6} ${result.area.name} - Contexto Consolidado (${result.area.fileCount} arquivos)
@@ -1124,9 +1295,6 @@ function formatAreaContextText(result) {
 `;
   }
   out += `
-`;
-  out += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
 `;
   if (result.types.length > 0) {
     out += `\u{1F3F7}\uFE0F TYPES (${result.types.length})
@@ -1232,9 +1400,6 @@ function formatAreaContextText(result) {
 `;
     }
   }
-  out += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
-`;
   out += `\u{1F4CA} RESUMO
 `;
   out += `   Types: ${result.types.length}
@@ -1253,6 +1418,7 @@ function formatAreaContextText(result) {
     out += `   Triggers: ${result.triggers.length}
 `;
   }
+  out += nextSteps("area_context", ctx);
   return out;
 }
 
@@ -2091,69 +2257,6 @@ ${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)",
@@ -2919,6 +3022,7 @@ function generateTestSuggestions(suggestions, allFiles) {
 // src/commands/context.ts
 import { existsSync as existsSync6, readdirSync as readdirSync3, statSync as statSync3 } from "fs";
 import { join as join6, resolve as resolve2, basename, extname as extname3 } from "path";
+import { SyntaxKind as SyntaxKind3 } from "ts-morph";
 
 // src/ts/extractor.ts
 import { Project, SyntaxKind } from "ts-morph";
@@ -3800,6 +3904,24 @@ async function context(target, options = {}) {
     const functions2 = extractFunctions(sourceFile);
     const types = extractTypes(sourceFile);
     const exports = extractExports(sourceFile);
+    const constants = [];
+    for (const varStatement of sourceFile.getVariableStatements()) {
+      if (!varStatement.isExported()) continue;
+      for (const decl of varStatement.getDeclarations()) {
+        const init = decl.getInitializer();
+        if (init) {
+          const kind = init.getKind();
+          if (kind === SyntaxKind3.ArrowFunction || kind === SyntaxKind3.FunctionExpression) {
+            continue;
+          }
+        }
+        constants.push({
+          name: decl.getName(),
+          type: simplifyType(decl.getType().getText()),
+          isExported: true
+        });
+      }
+    }
     const result = {
       version: "1.0.0",
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -3808,7 +3930,8 @@ async function context(target, options = {}) {
       imports,
       exports,
       functions: functions2,
-      types
+      types,
+      constants: constants.length > 0 ? constants : void 0
     };
     return formatOutput(result, format, formatContextText);
   } catch (error) {
@@ -3927,9 +4050,19 @@ async function areaContext(areaName, options = {}) {
       }
     }
     if (areaFiles.length === 0) {
-      return format === "json" ? JSON.stringify({ error: `\xC1rea n\xE3o encontrada: "${areaName}"` }) : `\u274C \xC1rea n\xE3o encontrada: "${areaName}"
-
-\u{1F4A1} Use 'ai-tool areas' para listar \xE1reas dispon\xEDveis`;
+      const availableAreas = /* @__PURE__ */ new Map();
+      for (const filePath of Object.keys(index.files)) {
+        if (isFileIgnored(filePath, config)) continue;
+        const fileAreas = detectFileAreas(filePath, config);
+        for (const areaId of fileAreas) {
+          availableAreas.set(areaId, (availableAreas.get(areaId) || 0) + 1);
+        }
+      }
+      const areaList = [...availableAreas.entries()].map(([id, count]) => ({ id, count })).sort((a, b) => b.count - a.count);
+      if (format === "json") {
+        return JSON.stringify({ error: `Area nao encontrada: "${areaName}"`, availableAreas: areaList });
+      }
+      return formatAreaNotFound({ target: areaName, availableAreas: areaList });
     }
     const types = [];
     const hooks = [];
@@ -4682,12 +4815,40 @@ async function functions(options = {}) {
   const useCache = options.cache !== false;
   const filterTrigger = options.trigger;
   if (!isFirebaseProject(cwd)) {
-    const errorMsg = "Este n\xE3o \xE9 um projeto Firebase.\nN\xE3o foi encontrado .firebaserc ou firebase.json";
-    return format === "json" ? JSON.stringify({ error: errorMsg }) : `\u274C ${errorMsg}`;
+    const errorMsg = "Este nao e um projeto Firebase (nao encontrou .firebaserc ou firebase.json)";
+    if (format === "json") {
+      return JSON.stringify({ error: errorMsg });
+    }
+    let out = `\u274C ${errorMsg}
+`;
+    out += `
+\u{1F4A1} Comandos disponiveis para este projeto:
+`;
+    out += `   \u2192 ai-tool map - ver estrutura do projeto
+`;
+    out += `   \u2192 ai-tool find <termo> - buscar simbolos no codigo
+`;
+    out += `   \u2192 ai-tool areas - listar areas funcionais
+`;
+    return out;
   }
   if (!hasFirebaseFunctions(cwd)) {
-    const errorMsg = "Projeto Firebase sem Cloud Functions.\nN\xE3o foi encontrado functions/src/index.ts";
-    return format === "json" ? JSON.stringify({ error: errorMsg }) : `\u274C ${errorMsg}`;
+    const errorMsg = "Projeto Firebase detectado, mas sem Cloud Functions";
+    if (format === "json") {
+      return JSON.stringify({ error: errorMsg });
+    }
+    let out = `\u274C ${errorMsg}
+`;
+    out += `   Nao foi encontrado functions/src/index.ts
+
+`;
+    out += `\u{1F4A1} Para adicionar Cloud Functions:
+`;
+    out += `   \u2192 firebase init functions
+`;
+    out += `   \u2192 Documentacao: https://firebase.google.com/docs/functions
+`;
+    return out;
   }
   try {
     let index;
@@ -4946,7 +5107,19 @@ async function find(query, options = {}) {
         }
       }
       if (allowedFiles.size === 0) {
-        return format === "json" ? JSON.stringify({ error: `Nenhum arquivo encontrado na \xE1rea "${filterArea}"` }) : `\u274C Nenhum arquivo encontrado na \xE1rea "${filterArea}"`;
+        const availableAreas = /* @__PURE__ */ new Map();
+        for (const filePath of Object.keys(index.files)) {
+          if (isFileIgnored(filePath, config)) continue;
+          const fileAreas = detectFileAreas(filePath, config);
+          for (const areaId of fileAreas) {
+            availableAreas.set(areaId, (availableAreas.get(areaId) || 0) + 1);
+          }
+        }
+        const areaList = [...availableAreas.entries()].map(([id, count]) => ({ id, count })).sort((a, b) => b.count - a.count);
+        if (format === "json") {
+          return JSON.stringify({ error: `Nenhum arquivo encontrado na area "${filterArea}"`, availableAreas: areaList });
+        }
+        return formatAreaNotFound({ target: filterArea, availableAreas: areaList });
       }
     }
     const matches = searchInIndex(index, query, filterType, allowedFiles);
@@ -4991,7 +5164,8 @@ async function find(query, options = {}) {
       },
       fromCache
     };
-    return formatOutput(result, format, formatFindText, fromCache);
+    const allSymbolNames = Object.keys(index.symbolsByName);
+    return formatOutput(result, format, (r) => formatFindText(r, "cli", allSymbolNames), fromCache);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(`Erro ao executar find: ${message}`);
@@ -5118,6 +5292,13 @@ export {
   categoryIcons,
   isEntryPoint,
   isCodeFile,
+  hint,
+  nextSteps,
+  recoveryHint,
+  levenshteinDistance,
+  findSimilar,
+  findBestMatch,
+  extractFileName,
   isFirebaseProject,
   hasFirebaseFunctions,
   isExportedCloudFunction,
@@ -5125,7 +5306,10 @@ export {
   clearFirebaseCache,
   getCacheDir,
   isCacheValid,
+  updateCacheMeta,
   invalidateCache,
+  cacheSymbolsIndex,
+  getCachedSymbolsIndex,
   configExists,
   readConfig,
   writeConfig,
@@ -5143,10 +5327,6 @@ export {
   map,
   dead,
   deadFix,
-  levenshteinDistance,
-  findSimilar,
-  findBestMatch,
-  extractFileName,
   COMMAND_REFERENCE,
   formatFileNotFound,
   formatAreaNotFound,
@@ -5154,6 +5334,8 @@ export {
   formatInvalidCommand,
   impact,
   suggest,
+  getAllCodeFiles,
+  indexProject,
   context,
   areaContext,
   areas,