@justmpm/ai-tool 0.9.3 → 1.0.1

package/dist/{chunk-J3MX6NK3.js → chunk-4HAUIZQ7.js}

@@ -143,9 +143,263 @@ 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 "no_areas_configured":
+      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
+`;
+    case "symbol_not_found":
+      return `
+\u{1F4A1} Dicas:
+   \u2192 Verifique a ortografia do simbolo
+   \u2192 Tente buscar parte do nome
+   \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 "index_failed":
+      return `
+\u{1F4A1} Falha ao indexar o projeto:
+   \u2192 Verifique se tsconfig.json existe e esta valido
+   \u2192 Verifique se o projeto tem arquivos .ts ou .tsx
+   \u2192 ${hint("map", ctx)} - tente ver a estrutura basica primeiro
+`;
+    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 = "";
+  if (result.framework) {
+    out += `\u{1F3D7}\uFE0F Framework: ${result.framework}
+`;
+  }
   out += `\u{1F4CA} ${result.summary.totalFiles} arquivos | ${result.summary.totalFolders} pastas
 `;
   const catOrder = [
@@ -172,9 +426,27 @@ function formatMapSummary(result, areasInfo) {
   }
   out += `   ${catParts.join(", ")}
 `;
+  const SMALL_PROJECT_THRESHOLD = 25;
+  if (result.summary.totalFiles <= SMALL_PROJECT_THRESHOLD && result.files.length > 0) {
+    out += `
+\u{1F4C1} Arquivos:
+`;
+    for (const file of result.files) {
+      const icon = categoryIcons[file.category];
+      out += `   ${icon} ${file.path}
+`;
+    }
+  } else {
+    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 +457,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 +489,7 @@ function formatMapText(result) {
 `;
   out += `   Pastas: ${result.summary.totalFolders}
 `;
-  out += `   Diret\xF3rio: ${result.cwd}
+  out += `   Diretorio: ${result.cwd}
 
 `;
   out += `\u{1F4C2} CATEGORIAS
@@ -272,7 +531,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 +542,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 +599,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 +613,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 +649,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 +667,7 @@ function formatDeadText(result) {
 `;
     }
   }
+  out += nextSteps("dead", ctx);
   return out;
 }
 function generateIgnoreSuggestions(result) {
@@ -431,7 +687,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 +698,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 +707,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 +716,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 +733,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 +743,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 +766,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 +777,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 +791,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 +812,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 +822,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 +842,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 +861,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 +934,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 +956,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 +964,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 +977,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 +1020,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 +1033,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 +1055,60 @@ function formatContextText(result) {
 `;
   out += `   Functions: ${result.functions.length}
 `;
-  return out;
-}
-function formatAreasText(result) {
-  let out = "";
+  if (result.constants && result.constants.length > 0) {
+    out += `   Constants: ${result.constants.length}
+`;
+  }
   out += `
+\u{1F4D6} Proximos passos:
 `;
-  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
+  const exportedFns = result.functions.filter((f) => f.isExported);
+  const exportedTypes = result.types.filter((t) => t.isExported);
+  if (exportedFns.length > 0) {
+    const mainExport = exportedFns[0].name;
+    out += `   \u2192 ${hint("find", ctx, { "<termo>": mainExport })} - ver onde ${mainExport} e usado
+`;
+  }
+  const isHook = result.category === "hook" || result.functions.some((f) => f.name.startsWith("use"));
+  if (isHook) {
+    out += `   \u2192 ${hint("impact", ctx, { "<arquivo>": result.file })} - ver quem usa este hook
 `;
-  out += `\u2551                    \u{1F4E6} PROJECT AREAS                         \u2551
+  }
+  if (result.category === "service") {
+    out += `   \u2192 ${hint("impact", ctx, { "<arquivo>": result.file })} - ver quem usa este service
 `;
-  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
+  }
+  if (exportedTypes.length > 0) {
+    const mainType = exportedTypes[0].name;
+    out += `   \u2192 ${hint("find", ctx, { "<termo>": mainType })} - ver onde ${mainType} e usado
+`;
+  }
+  if (!isHook && result.category !== "service") {
+    out += `   \u2192 ${hint("impact", ctx, { "<arquivo>": result.file })} - ver quem sera afetado por mudancas
+`;
+  }
+  out += `   \u2192 ${hint("suggest", ctx, { "<arquivo>": result.file })} - o que ler antes de editar
+`;
+  return out;
+}
+function formatAreasText(result, ctx = "cli") {
+  let out = "";
+  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 +1128,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 +1141,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 +1191,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 +1202,7 @@ function formatAreaDetailText(result, options = {}) {
       out += `   ${file.path}${desc}
 `;
     }
+    out += nextSteps("area", ctx);
     return out;
   }
   const maxFilesPerCategory = full ? 100 : 8;
@@ -996,17 +1234,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 +1254,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 +1264,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 += `   \u2192 Tente buscar parte do nome
 `;
-    out += `   \u2022 Tente buscar parte do nome
+    out += `   \u2192 Remova filtros de tipo ou area
 `;
-    out += `   \u2022 Remova filtros de tipo ou \xE1rea
+    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 +1317,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 +1335,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 +1351,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 +1363,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 +1468,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 +1486,7 @@ function formatAreaContextText(result) {
     out += `   Triggers: ${result.triggers.length}
 `;
   }
+  out += nextSteps("area_context", ctx);
   return out;
 }
 
@@ -1829,10 +2063,37 @@ function formatOutput(result, format, textFormatter, cacheMarker) {
 }
 
 // src/commands/map.ts
+import { existsSync as existsSync4 } from "fs";
+import { join as join4 } from "path";
+function detectFramework(cwd) {
+  if (existsSync4(join4(cwd, "next.config.js")) || existsSync4(join4(cwd, "next.config.ts")) || existsSync4(join4(cwd, "next.config.mjs"))) {
+    return "Next.js";
+  }
+  if (existsSync4(join4(cwd, "vite.config.ts")) || existsSync4(join4(cwd, "vite.config.js"))) {
+    return "Vite";
+  }
+  if (existsSync4(join4(cwd, "remix.config.js")) || existsSync4(join4(cwd, "remix.config.ts"))) {
+    return "Remix";
+  }
+  if (existsSync4(join4(cwd, "astro.config.mjs")) || existsSync4(join4(cwd, "astro.config.ts"))) {
+    return "Astro";
+  }
+  if (existsSync4(join4(cwd, "nuxt.config.ts")) || existsSync4(join4(cwd, "nuxt.config.js"))) {
+    return "Nuxt";
+  }
+  if (existsSync4(join4(cwd, "svelte.config.js")) || existsSync4(join4(cwd, "svelte.config.ts"))) {
+    return "SvelteKit";
+  }
+  if (existsSync4(join4(cwd, ".firebaserc")) || existsSync4(join4(cwd, "firebase.json"))) {
+    return "Firebase";
+  }
+  return void 0;
+}
 async function map(options = {}) {
   const { cwd, format } = parseCommandOptions(options);
   const useCache = options.cache !== false;
   const full = options.full ?? false;
+  const ctx = options.ctx || "cli";
   if (useCache && isCacheValid(cwd)) {
     const cached = getCachedMapResult(cwd);
     if (cached) {
@@ -1841,10 +2102,10 @@ async function map(options = {}) {
         return JSON.stringify(result, null, 2);
       }
       if (full) {
-        return formatMapText(result) + "\n\n\u{1F4E6} (resultado do cache)";
+        return formatMapText(result, ctx) + "\n\n\u{1F4E6} (resultado do cache)";
       }
       const areasInfo = detectAreasInfo(cwd, result.files.map((f) => f.path));
-      return formatMapSummary(result, areasInfo) + "\n\u{1F4E6} (cache)";
+      return formatMapSummary(result, areasInfo, ctx) + "\n\u{1F4E6} (cache)";
     }
   }
   try {
@@ -1898,10 +2159,12 @@ async function map(options = {}) {
       categories[file.category] = (categories[file.category] || 0) + 1;
     }
     const circular = findCircularDependencies();
+    const framework = detectFramework(cwd);
     const result = {
       version: "1.0.0",
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       cwd,
+      framework,
       summary: {
         totalFiles: files.length,
         totalFolders: folderMap.size,
@@ -1919,10 +2182,10 @@ async function map(options = {}) {
       return JSON.stringify(result, null, 2);
     }
     if (full) {
-      return formatMapText(result);
+      return formatMapText(result, ctx);
     }
     const areasInfo = detectAreasInfo(cwd, files.map((f) => f.path));
-    return formatMapSummary(result, areasInfo);
+    return formatMapSummary(result, areasInfo, ctx);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(`Erro ao executar map: ${message}`);
@@ -1960,8 +2223,8 @@ function detectAreasInfo(cwd, filePaths) {
 
 // src/commands/dead.ts
 import { execSync } from "child_process";
-import { writeFileSync as writeFileSync3, unlinkSync, existsSync as existsSync4 } from "fs";
-import { join as join4 } from "path";
+import { writeFileSync as writeFileSync3, unlinkSync, existsSync as existsSync5 } from "fs";
+import { join as join5 } from "path";
 function generateKnipConfig(cwd) {
   const ignorePatterns = getIgnorePatterns(cwd);
   if (ignorePatterns.length === 0) {
@@ -1971,7 +2234,7 @@ function generateKnipConfig(cwd) {
     $schema: "https://unpkg.com/knip@5/schema.json",
     ignore: ignorePatterns
   };
-  const configPath = join4(cwd, ".knip.ai-tool.json");
+  const configPath = join5(cwd, ".knip.ai-tool.json");
   writeFileSync3(configPath, JSON.stringify(knipConfig, null, 2), "utf-8");
   return configPath;
 }
@@ -2009,7 +2272,7 @@ async function dead(options = {}) {
         knipOutput = {};
       }
     } finally {
-      if (knipConfigPath && existsSync4(knipConfigPath)) {
+      if (knipConfigPath && existsSync5(knipConfigPath)) {
         try {
           unlinkSync(knipConfigPath);
         } catch {
@@ -2091,93 +2354,34 @@ ${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",
+var COMMAND_REFERENCE_KEYS = ["map", "areas", "area", "suggest", "context", "impact", "dead", "find", "describe"];
+var COMMAND_DESCRIPTIONS = {
+  map: "Resumo do projeto",
+  areas: "Listar todas as areas",
+  area: "Arquivos de uma area especifica",
   suggest: "O que ler antes de editar",
   context: "API/assinaturas de um arquivo",
   impact: "Quem usa este arquivo",
-  dead: "C\xF3digo morto (sem target)"
+  dead: "Codigo morto",
+  find: "Buscar simbolos no codigo",
+  describe: "Buscar areas por descricao"
 };
-function getCommandReferenceSection(excludeCommand) {
+function getCommandReferenceSection(ctx, excludeCommand) {
   let out = `
-\u{1F4CC} Comandos \xFAteis:
+\u{1F4CC} Comandos uteis:
 `;
-  for (const [cmd, desc] of Object.entries(COMMAND_REFERENCE)) {
+  for (const cmd of COMMAND_REFERENCE_KEYS) {
     if (cmd !== excludeCommand) {
-      out += `   ai-tool ${cmd.padEnd(10)} ${desc}
+      const desc = COMMAND_DESCRIPTIONS[cmd];
+      out += `   \u2192 ${hint(cmd, ctx)} - ${desc}
 `;
     }
   }
   return out;
 }
 function formatFileNotFound(options) {
-  const { target, allFiles, command } = options;
+  const { target, allFiles, command, ctx = "cli" } = options;
   const similarFiles = findSimilar(target, allFiles, {
     maxDistance: 3,
     limit: 5,
@@ -2185,14 +2389,20 @@ function formatFileNotFound(options) {
   });
   const bestMatch = findBestMatch(target, allFiles, extractFileName);
   let out = `
-\u274C Arquivo n\xE3o encontrado: "${target}"
+\u274C Arquivo nao encontrado: "${target}"
 
 `;
   out += `\u{1F4CA} Total de arquivos indexados: ${allFiles.length}
 
 `;
-  if (bestMatch) {
-    out += `\u{1F4A1} Voc\xEA quis dizer?
+  if (bestMatch && command) {
+    out += `\u{1F4A1} Voce quis dizer?
+`;
+    out += `   \u2192 ${hint(command, ctx, { "<arquivo>": bestMatch, "<termo>": bestMatch })}
+
+`;
+  } else if (bestMatch) {
+    out += `\u{1F4A1} Voce quis dizer?
 `;
     out += `   \u2192 ${bestMatch}
 
@@ -2215,15 +2425,15 @@ function formatFileNotFound(options) {
 `;
   out += `   \u2022 Ou apenas o nome do arquivo: Header
 `;
-  out += `   \u2022 Verifique se o arquivo est\xE1 em uma pasta inclu\xEDda no scan
+  out += `   \u2022 Verifique se o arquivo esta em uma pasta incluida no scan
 `;
   if (command) {
-    out += getCommandReferenceSection(command);
+    out += getCommandReferenceSection(ctx, command);
   }
   return out;
 }
 function formatAreaNotFound(options) {
-  const { target, availableAreas } = options;
+  const { target, availableAreas, ctx = "cli" } = options;
   const areaIds = availableAreas.map((a) => a.id);
   const bestMatchId = findBestMatch(target, areaIds);
   const similarAreaIds = findSimilar(target, areaIds, {
@@ -2231,18 +2441,18 @@ function formatAreaNotFound(options) {
     limit: 5
   });
   let out = `
-\u274C \xC1rea n\xE3o encontrada: "${target}"
+\u274C Area nao encontrada: "${target}"
 
 `;
   if (bestMatchId) {
-    out += `\u{1F4A1} Voc\xEA quis dizer?
+    out += `\u{1F4A1} Voce quis dizer?
 `;
-    out += `   \u2192 ai-tool area ${bestMatchId}
+    out += `   \u2192 ${hint("area", ctx, { "<nome>": bestMatchId })}
 
 `;
   }
   if (availableAreas.length > 0) {
-    out += `\u{1F4E6} \xC1reas dispon\xEDveis:
+    out += `\u{1F4E6} Areas disponiveis:
 
 `;
     if (similarAreaIds.length > 0 && !bestMatchId) {
@@ -2271,67 +2481,57 @@ function formatAreaNotFound(options) {
   }
   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 += `   \u2192 ${hint("areas", ctx)} - listar todas as areas
 `;
-  out += `   \u2022 IDs s\xE3o case-sensitive (Auth \u2260 auth)
+  out += `   \u2192 ${hint("describe", ctx)} - buscar areas por descricao
 `;
-  out += `
-\u{1F4CC} Comandos relacionados:
-`;
-  out += `   ai-tool areas      Listar todas as \xE1reas
-`;
-  out += `   ai-tool map        Ver estrutura do projeto
+  out += `   \u2192 IDs sao case-sensitive (Auth \u2260 auth)
 `;
   return out;
 }
-function formatMissingTarget(command) {
+function formatMissingTarget(command, ctx = "cli") {
   let out = `
-\u274C Erro: par\xE2metro "target" \xE9 OBRIGAT\xD3RIO para o comando "${command}".
+\u274C Erro: parametro "target" e OBRIGATORIO para o comando "${command}".
 
 `;
   out += `\u{1F4DD} Exemplos:
 `;
   if (command === "area") {
-    out += `   ai-tool area auth
+    out += `   ${hint("area", ctx, { "<nome>": "auth" })}
 `;
-    out += `   ai-tool area dashboard
-`;
-    out += `   ai-tool area billing --type=hook
+    out += `   ${hint("area", ctx, { "<nome>": "dashboard" })}
 
 `;
-    out += `\u{1F4A1} Use 'ai-tool areas' para listar todas as \xE1reas dispon\xEDveis.
+    out += `\u{1F4A1} ${hint("areas", ctx)} - listar todas as areas disponiveis
 `;
   } else {
-    out += `   ai-tool ${command} useAuth
-`;
-    out += `   ai-tool ${command} Button.tsx
+    out += `   ${hint(command, ctx, { "<arquivo>": "useAuth", "<termo>": "useAuth" })}
 `;
-    out += `   ai-tool ${command} src/hooks/useAuth.ts
+    out += `   ${hint(command, ctx, { "<arquivo>": "Button.tsx", "<termo>": "Button" })}
 `;
   }
-  out += getCommandReferenceSection(command);
+  out += getCommandReferenceSection(ctx, command);
   return out;
 }
-function formatInvalidCommand(command) {
-  const validCommands = Object.keys(COMMAND_REFERENCE);
+function formatInvalidCommand(command, ctx = "cli") {
+  const validCommands = Object.keys(COMMAND_DESCRIPTIONS);
   const bestMatch = findBestMatch(command, validCommands);
   let out = `
-\u274C Comando inv\xE1lido: "${command}"
+\u274C Comando invalido: "${command}"
 
 `;
   if (bestMatch) {
-    out += `\u{1F4A1} Voc\xEA quis dizer?
+    out += `\u{1F4A1} Voce quis dizer?
 `;
-    out += `   \u2192 ai-tool ${bestMatch}
+    out += `   \u2192 ${hint(bestMatch, ctx)}
 
 `;
   }
-  out += `\u{1F4CC} Comandos dispon\xEDveis:
+  out += `\u{1F4CC} Comandos disponiveis:
 `;
-  for (const [cmd, desc] of Object.entries(COMMAND_REFERENCE)) {
-    out += `   ai-tool ${cmd.padEnd(10)} ${desc}
+  for (const cmd of COMMAND_REFERENCE_KEYS) {
+    const desc = COMMAND_DESCRIPTIONS[cmd];
+    out += `   \u2192 ${hint(cmd, ctx)} - ${desc}
 `;
   }
   return out;
@@ -2387,10 +2587,10 @@ function findTargetFile(target, allFiles) {
 }
 
 // src/integrations/git.ts
-import { existsSync as existsSync5 } from "fs";
+import { existsSync as existsSync6 } from "fs";
 import { execSync as execSync2 } from "child_process";
 function hasGitRepo(cwd) {
-  return existsSync5(cwd + "/.git");
+  return existsSync6(cwd + "/.git");
 }
 async function getCommitsForFile(filePath, cwd, limit = 10) {
   if (!hasGitRepo(cwd)) {
@@ -2429,6 +2629,7 @@ async function getCommitsForFile(filePath, cwd, limit = 10) {
 async function impact(target, options = {}) {
   const { cwd, format } = parseCommandOptions(options);
   const useCache = options.cache !== false;
+  const ctx = options.ctx || "cli";
   if (!target) {
     throw new Error("Target \xE9 obrigat\xF3rio. Exemplo: ai-tool impact src/components/Button.tsx");
   }
@@ -2474,7 +2675,7 @@ async function impact(target, options = {}) {
     }
     const targetPath = findTargetFile(target, allFiles);
     if (!targetPath) {
-      return formatFileNotFound({ target, allFiles, command: "impact" });
+      return formatFileNotFound({ target, allFiles, command: "impact", ctx });
     }
     const { directUpstream, indirectUpstream, directDownstream, indirectDownstream } = calculateDependencies(targetPath, graph);
     const dependingOn = [...directUpstream, ...indirectUpstream];
@@ -2507,7 +2708,7 @@ async function impact(target, options = {}) {
       suggestions,
       gitHistory
     };
-    return formatOutput(result, format, formatImpactText, fromCache);
+    return formatOutput(result, format, (r) => formatImpactText(r, ctx), fromCache);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(`Erro ao executar impact: ${message}`);
@@ -2669,6 +2870,7 @@ async function suggest(target, options = {}) {
   const { cwd, format } = parseCommandOptions(options);
   const useCache = options.cache !== false;
   const limit = options.limit || 10;
+  const ctx = options.ctx || "cli";
   if (!target) {
     throw new Error("Target e obrigatorio. Exemplo: ai-tool suggest src/components/Button.tsx");
   }
@@ -2710,7 +2912,7 @@ async function suggest(target, options = {}) {
     }
     const targetPath = findTargetFile(target, allFiles);
     if (!targetPath) {
-      return formatFileNotFound({ target, allFiles, command: "suggest" });
+      return formatFileNotFound({ target, allFiles, command: "suggest", ctx });
     }
     const suggestions = collectSuggestions(targetPath, graph, allFiles, limit);
     const testSuggestions = generateTestSuggestions(suggestions, allFiles);
@@ -2722,7 +2924,7 @@ async function suggest(target, options = {}) {
       suggestions,
       testSuggestions
     };
-    return formatOutput(result, format, formatSuggestText, fromCache);
+    return formatOutput(result, format, (r) => formatSuggestText(r, ctx), fromCache);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(`Erro ao executar suggest: ${message}`);
@@ -2917,8 +3119,9 @@ 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 { existsSync as existsSync7, readdirSync as readdirSync3, statSync as statSync3 } from "fs";
+import { join as join7, 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";
@@ -3153,7 +3356,7 @@ import { SyntaxKind as SyntaxKind2 } from "ts-morph";
 
 // src/ts/index.ts
 import { readdirSync as readdirSync2, statSync as statSync2 } from "fs";
-import { join as join5, extname as extname2 } from "path";
+import { join as join6, extname as extname2 } from "path";
 import { Project as Project2 } from "ts-morph";
 
 // src/utils/logger.ts
@@ -3268,7 +3471,7 @@ function getAllCodeFiles(dir, files = [], baseDir = dir) {
   try {
     const entries = readdirSync2(dir);
     for (const entry of entries) {
-      const fullPath = join5(dir, entry);
+      const fullPath = join6(dir, entry);
       if (IGNORED_DIRS.has(entry) || entry.startsWith(".")) {
         continue;
       }
@@ -3784,6 +3987,7 @@ function indexProject(cwd) {
 // src/commands/context.ts
 async function context(target, options = {}) {
   const { cwd, format } = parseCommandOptions(options);
+  const ctx = options.ctx || "cli";
   if (!target) {
     throw new Error("Target e obrigatorio. Exemplo: ai-tool context src/components/Button.tsx");
   }
@@ -3791,7 +3995,7 @@ async function context(target, options = {}) {
     const targetPath = findTargetFile2(target, cwd);
     if (!targetPath) {
       const allFiles = getAllCodeFiles2(cwd);
-      return formatFileNotFound({ target, allFiles, command: "context" });
+      return formatFileNotFound({ target, allFiles, command: "context", ctx });
     }
     const project = createProject(cwd);
     const absolutePath = resolve2(cwd, targetPath);
@@ -3800,6 +4004,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,9 +4030,10 @@ async function context(target, options = {}) {
       imports,
       exports,
       functions: functions2,
-      types
+      types,
+      constants: constants.length > 0 ? constants : void 0
     };
-    return formatOutput(result, format, formatContextText);
+    return formatOutput(result, format, (r) => formatContextText(r, ctx));
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(`Erro ao executar context: ${message}`);
@@ -3820,12 +4043,12 @@ var CODE_EXTENSIONS3 = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".
 function findTargetFile2(target, cwd) {
   const normalizedTarget = target.replace(/\\/g, "/");
   const directPath = resolve2(cwd, normalizedTarget);
-  if (existsSync6(directPath) && isCodeFile2(directPath)) {
+  if (existsSync7(directPath) && isCodeFile2(directPath)) {
     return normalizedTarget;
   }
   for (const ext of CODE_EXTENSIONS3) {
     const withExt = directPath + ext;
-    if (existsSync6(withExt)) {
+    if (existsSync7(withExt)) {
       return normalizedTarget + ext;
     }
   }
@@ -3855,7 +4078,7 @@ function getAllCodeFiles2(dir, files = [], baseDir = dir) {
   try {
     const entries = readdirSync3(dir);
     for (const entry of entries) {
-      const fullPath = join6(dir, entry);
+      const fullPath = join7(dir, entry);
       if (shouldIgnore(entry)) {
         continue;
       }
@@ -3892,10 +4115,32 @@ async function areaContext(areaName, options = {}) {
   const cwd = options.cwd || process.cwd();
   const format = options.format || "text";
   const useCache = options.cache !== false;
+  const ctx = options.ctx || "cli";
   if (!areaName) {
     throw new Error("Nome da \xE1rea \xE9 obrigat\xF3rio. Exemplo: ai-tool context --area=auth");
   }
   try {
+    if (!configExists(cwd) || Object.keys(readConfig(cwd).areas).length === 0) {
+      let out = `\u26A0\uFE0F Nenhuma area configurada neste projeto.
+
+`;
+      out += `O comando area_context requer areas configuradas em .analyze/areas.config.json
+`;
+      out += `Para configurar:
+`;
+      out += `   1. ${hint("areas_init", ctx)} - gerar arquivo de configuracao
+`;
+      out += `   2. Edite .analyze/areas.config.json com as areas do projeto
+
+`;
+      out += `Enquanto isso, use:
+`;
+      out += `   \u2192 ${hint("context", ctx)} - ver assinaturas de um arquivo especifico
+`;
+      out += `   \u2192 ${hint("find", ctx)} - buscar simbolos no codigo
+`;
+      return out;
+    }
     const config = readConfig(cwd);
     let index;
     if (useCache && isCacheValid(cwd)) {
@@ -3927,9 +4172,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, ctx });
     }
     const types = [];
     const hooks = [];
@@ -4035,7 +4290,7 @@ async function areaContext(areaName, options = {}) {
     if (format === "json") {
       return JSON.stringify(result, null, 2);
     }
-    return formatAreaContextText(result);
+    return formatAreaContextText(result, ctx);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(`Erro ao executar context --area: ${message}`);
@@ -4062,7 +4317,7 @@ function findRealAreaIdFromIndex(target, areaFiles, config) {
 
 // src/commands/areas.ts
 import { readdirSync as readdirSync4, statSync as statSync4 } from "fs";
-import { join as join7, extname as extname4 } from "path";
+import { join as join8, extname as extname4 } from "path";
 var CODE_EXTENSIONS4 = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
 var IGNORED_DIRS2 = /* @__PURE__ */ new Set([
   "node_modules",
@@ -4079,6 +4334,7 @@ var IGNORED_DIRS2 = /* @__PURE__ */ new Set([
 async function areas(options = {}) {
   const cwd = options.cwd || process.cwd();
   const format = options.format || "text";
+  const ctx = options.ctx || "cli";
   try {
     const config = readConfig(cwd);
     const allFiles = getAllCodeFiles3(cwd);
@@ -4140,7 +4396,7 @@ async function areas(options = {}) {
     if (format === "json") {
       return JSON.stringify(result, null, 2);
     }
-    return formatAreasText(result);
+    return formatAreasText(result, ctx);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(`Erro ao executar areas: ${message}`);
@@ -4150,7 +4406,7 @@ function getAllCodeFiles3(dir, files = [], baseDir = dir) {
   try {
     const entries = readdirSync4(dir);
     for (const entry of entries) {
-      const fullPath = join7(dir, entry);
+      const fullPath = join8(dir, entry);
       if (IGNORED_DIRS2.has(entry) || entry.startsWith(".")) {
         continue;
       }
@@ -4175,7 +4431,7 @@ function getAllCodeFiles3(dir, files = [], baseDir = dir) {
 
 // src/commands/area.ts
 import { readdirSync as readdirSync5, statSync as statSync5 } from "fs";
-import { join as join8, extname as extname5 } from "path";
+import { join as join9, extname as extname5 } from "path";
 var CODE_EXTENSIONS5 = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
 var IGNORED_DIRS3 = /* @__PURE__ */ new Set([
   "node_modules",
@@ -4224,10 +4480,32 @@ async function area(target, options = {}) {
   const format = options.format || "text";
   const filterType = options.type;
   const full = options.full ?? false;
+  const ctx = options.ctx || "cli";
   if (!target) {
     throw new Error("Nome da \xE1rea \xE9 obrigat\xF3rio. Exemplo: ai-tool area auth");
   }
   try {
+    if (!configExists(cwd) || Object.keys(readConfig(cwd).areas).length === 0) {
+      let out = `\u26A0\uFE0F Nenhuma area configurada neste projeto.
+
+`;
+      out += `O comando area requer areas configuradas em .analyze/areas.config.json
+`;
+      out += `Para configurar:
+`;
+      out += `   1. ${hint("areas_init", ctx)} - gerar arquivo de configuracao
+`;
+      out += `   2. Edite .analyze/areas.config.json com as areas do projeto
+
+`;
+      out += `Enquanto isso, use:
+`;
+      out += `   \u2192 ${hint("map", ctx)} - ver estrutura do projeto
+`;
+      out += `   \u2192 ${hint("find", ctx)} - buscar simbolos no codigo
+`;
+      return out;
+    }
     const config = readConfig(cwd);
     const allFiles = getAllCodeFiles4(cwd);
     const resolvedTarget = resolveAreaId(target, config, allFiles);
@@ -4257,7 +4535,7 @@ async function area(target, options = {}) {
     }
     if (areaFiles.length === 0) {
       const availableAreas = getAvailableAreas(filteredFiles, config);
-      return formatAreaNotFound2(target, availableAreas);
+      return formatAreaNotFound2(target, availableAreas, ctx);
     }
     const byCategory = {};
     const categories = {};
@@ -4294,7 +4572,7 @@ async function area(target, options = {}) {
     if (format === "json") {
       return JSON.stringify(result, null, 2);
     }
-    const output = formatAreaDetailText(result, { full, filterType });
+    const output = formatAreaDetailText(result, { full, filterType }, ctx);
     return nameConversionMsg + output;
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -4329,14 +4607,14 @@ function getAvailableAreas(allFiles, config) {
   }
   return [...areaCounts.entries()].map(([id, count]) => ({ id, count })).sort((a, b) => b.count - a.count);
 }
-function formatAreaNotFound2(target, availableAreas) {
-  return formatAreaNotFound({ target, availableAreas });
+function formatAreaNotFound2(target, availableAreas, ctx = "cli") {
+  return formatAreaNotFound({ target, availableAreas, ctx });
 }
 function getAllCodeFiles4(dir, files = [], baseDir = dir) {
   try {
     const entries = readdirSync5(dir);
     for (const entry of entries) {
-      const fullPath = join8(dir, entry);
+      const fullPath = join9(dir, entry);
       if (IGNORED_DIRS3.has(entry) || entry.startsWith(".")) {
         continue;
       }
@@ -4361,7 +4639,7 @@ function getAllCodeFiles4(dir, files = [], baseDir = dir) {
 
 // src/commands/areas-init.ts
 import { readdirSync as readdirSync6, statSync as statSync6 } from "fs";
-import { join as join9, extname as extname6 } from "path";
+import { join as join10, extname as extname6 } from "path";
 var CODE_EXTENSIONS6 = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
 var IGNORED_DIRS4 = /* @__PURE__ */ new Set([
   "node_modules",
@@ -4377,7 +4655,7 @@ var IGNORED_DIRS4 = /* @__PURE__ */ new Set([
 ]);
 function createInitialConfig(files) {
   const suggestedIgnore = detectSuggestedIgnorePatterns(files);
-  const framework = detectFramework(files);
+  const framework = detectFramework2(files);
   return {
     $schema: "./areas.schema.json",
     version: "1.0.0",
@@ -4391,7 +4669,7 @@ function createInitialConfig(files) {
     }
   };
 }
-function detectFramework(files) {
+function detectFramework2(files) {
   const hasAppDir = files.some((f) => f.startsWith("app/"));
   const hasPagesDir = files.some((f) => f.startsWith("pages/"));
   const hasSrcDir = files.some((f) => f.startsWith("src/"));
@@ -4546,7 +4824,7 @@ Ou edite manualmente o arquivo existente.
     const allFiles = getAllCodeFiles5(cwd);
     const newConfig = createInitialConfig(allFiles);
     writeConfig(cwd, newConfig);
-    const framework = detectFramework(allFiles);
+    const framework = detectFramework2(allFiles);
     const frameworkName = {
       "nextjs-app": "Next.js (App Router)",
       "nextjs-pages": "Next.js (Pages Router)",
@@ -4650,7 +4928,7 @@ function getAllCodeFiles5(dir, files = [], baseDir = dir) {
   try {
     const entries = readdirSync6(dir);
     for (const entry of entries) {
-      const fullPath = join9(dir, entry);
+      const fullPath = join10(dir, entry);
       if (IGNORED_DIRS4.has(entry) || entry.startsWith(".")) {
         continue;
       }
@@ -4681,13 +4959,42 @@ async function functions(options = {}) {
   const format = options.format || "text";
   const useCache = options.cache !== false;
   const filterTrigger = options.trigger;
+  const ctx = options.ctx || "cli";
   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 ${hint("map", ctx)} - ver estrutura do projeto
+`;
+    out += `   \u2192 ${hint("find", ctx)} - buscar simbolos no codigo
+`;
+    out += `   \u2192 ${hint("areas", ctx)} - 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;
@@ -4754,13 +5061,13 @@ async function functions(options = {}) {
     if (format === "json") {
       return JSON.stringify(result, null, 2);
     }
-    return formatFunctionsText(result);
+    return formatFunctionsText(result, ctx);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(`Erro ao executar functions: ${message}`);
   }
 }
-function formatFunctionsText(result) {
+function formatFunctionsText(result, ctx = "cli") {
   let out = "";
   out += `
 `;
@@ -4777,42 +5084,35 @@ function formatFunctionsText(result) {
 `;
   out += `   Exportadas: ${result.summary.exported}
 `;
-  if (result.summary.total > 0) {
-    out += `
-   \u{1F4A1} Filtros dispon\xEDveis:
-`;
-    out += `      ai-tool functions --trigger=onCall
-`;
-    out += `      ai-tool functions --trigger=onDocumentCreated
-`;
-  }
   out += `
 `;
   if (result.summary.total === 0) {
     out += `   \u26A0\uFE0F  NENHUMA CLOUD FUNCTION DETECTADA
 
 `;
-    out += `   Poss\xEDveis causas:
-`;
-    out += `      1. O projeto n\xE3o \xE9 Firebase (n\xE3o encontrou .firebaserc ou firebase.json)
+    out += `   Possiveis causas:
 `;
-    out += `      2. N\xE3o h\xE1 arquivo functions/src/index.ts
+    out += `      1. O projeto nao e Firebase (nao encontrou .firebaserc ou firebase.json)
 `;
-    out += `      3. Os triggers n\xE3o usam padr\xF5es v2 (onCall, onDocumentCreated, etc)
+    out += `      2. Nao ha arquivo functions/src/index.ts
 `;
-    out += `      4. O cache est\xE1 desatualizado (ex: atualizou o ai-tool recentemente)
+    out += `      3. Os triggers nao usam padroes v2 (onCall, onDocumentCreated, etc)
 `;
-    out += `         \u2192 Tente: ai-tool functions --no-cache
+    out += `      4. O cache esta desatualizado
 
 `;
-    out += `   Padr\xF5es suportados:
+    out += `   Padroes suportados:
 `;
     out += `      export const minhaFunc = onCall((request) => { ... })
 `;
     out += `      export const minhaFunc = onDocumentCreated("path", (event) => { ... })
 
 `;
-    out += `   Documenta\xE7\xE3o: https://firebase.google.com/docs/functions
+    out += `\u{1F4A1} Dicas:
+`;
+    out += `   \u2192 ${hint("map", ctx)} - ver estrutura do projeto
+`;
+    out += `   \u2192 ${hint("find", ctx)} - buscar simbolos no codigo
 `;
     return out;
   }
@@ -4882,6 +5182,7 @@ function formatFunctionsText(result) {
     out += `
 `;
   }
+  out += nextSteps("functions", ctx);
   return out;
 }
 function getTriggerIcon(trigger) {
@@ -4899,6 +5200,8 @@ function getTriggerIcon(trigger) {
 }
 
 // src/commands/find.ts
+import { readFileSync as readFileSync4 } from "fs";
+import { join as join11 } from "path";
 async function find(query, options = {}) {
   const { cwd, format } = parseCommandOptions(options);
   const filterType = options.type || "all";
@@ -4906,6 +5209,7 @@ async function find(query, options = {}) {
   const defOnly = options.def ?? false;
   const refsOnly = options.refs ?? false;
   const useCache = options.cache !== false;
+  const ctx = options.ctx || "cli";
   const listAllMode = !query && defOnly && filterType && filterType !== "all";
   if (!query && !listAllMode) {
     throw new Error("Query \xE9 obrigat\xF3ria. Exemplo: ai-tool find useAuth\n   Ou use --def para listar todos de um tipo: ai-tool find --type=trigger --def");
@@ -4946,10 +5250,22 @@ 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, ctx });
       }
     }
-    const matches = searchInIndex(index, query, filterType, allowedFiles);
+    const matches = searchInIndex(index, query, filterType, allowedFiles, cwd);
     let definition = null;
     let references = [];
     for (const match of matches) {
@@ -4991,13 +5307,14 @@ 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, ctx, allSymbolNames), fromCache);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(`Erro ao executar find: ${message}`);
   }
 }
-function searchInIndex(index, query, filterType, allowedFiles) {
+function searchInIndex(index, query, filterType, allowedFiles, cwd) {
   const matches = [];
   const queryLower = query?.toLowerCase() || "";
   const processedSymbols = /* @__PURE__ */ new Set();
@@ -5050,6 +5367,45 @@ function searchInIndex(index, query, filterType, allowedFiles) {
       }
     }
   }
+  if (!listAllMode && query) {
+    const importFiles = matches.filter((m) => m.matchType === "import").map((m) => m.file);
+    const baseCwd = cwd || "";
+    const MAX_USAGE_FILES = 10;
+    const MAX_USAGES_PER_FILE = 3;
+    for (const filePath of importFiles.slice(0, MAX_USAGE_FILES)) {
+      try {
+        const fullPath = baseCwd ? join11(baseCwd, filePath) : filePath;
+        const content = readFileSync4(fullPath, "utf-8");
+        const lines = content.split("\n");
+        const usageRegex = new RegExp(`\\b${escapeRegex(query)}\\b`);
+        let usagesFound = 0;
+        for (let i = 0; i < lines.length && usagesFound < MAX_USAGES_PER_FILE; i++) {
+          const line = lines[i].trim();
+          if (line.startsWith("import ") || line.startsWith("export ") || line.startsWith("//") || line.startsWith("*") || line.startsWith("/*")) {
+            continue;
+          }
+          if (usageRegex.test(line)) {
+            const key = `usage:${filePath}:${i + 1}:${query}`;
+            if (processedSymbols.has(key)) continue;
+            processedSymbols.add(key);
+            const fileData = index.files[filePath];
+            const codeLine = line.length > 100 ? line.substring(0, 100) + "..." : line;
+            matches.push({
+              file: filePath,
+              line: i + 1,
+              column: 0,
+              code: codeLine,
+              matchType: "usage",
+              symbolType: inferSymbolTypeFromName(query),
+              category: fileData?.category || "other"
+            });
+            usagesFound++;
+          }
+        }
+      } catch {
+      }
+    }
+  }
   matches.sort((a, b) => {
     const order = { definition: 0, import: 1, usage: 2 };
     const orderDiff = order[a.matchType] - order[b.matchType];
@@ -5058,6 +5414,9 @@ function searchInIndex(index, query, filterType, allowedFiles) {
   });
   return matches;
 }
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function matchesType(kind, filter) {
   if (filter === "all") return true;
   switch (filter) {
@@ -5118,6 +5477,13 @@ export {
   categoryIcons,
   isEntryPoint,
   isCodeFile,
+  hint,
+  nextSteps,
+  recoveryHint,
+  levenshteinDistance,
+  findSimilar,
+  findBestMatch,
+  extractFileName,
   isFirebaseProject,
   hasFirebaseFunctions,
   isExportedCloudFunction,
@@ -5146,11 +5512,6 @@ export {
   map,
   dead,
   deadFix,
-  levenshteinDistance,
-  findSimilar,
-  findBestMatch,
-  extractFileName,
-  COMMAND_REFERENCE,
   formatFileNotFound,
   formatAreaNotFound,
   formatMissingTarget,