@justmpm/ai-tool 1.0.0 → 1.0.1

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

@@ -297,6 +297,29 @@ function recoveryHint(errorType, ctx, _extra) {
    \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 `
@@ -373,6 +396,10 @@ function extractFileName(filePath) {
 // src/formatters/text.ts
 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 = [
@@ -399,11 +426,23 @@ function formatMapSummary(result, areasInfo, ctx = "cli") {
   }
   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(", ")}
+  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 += `
@@ -1020,7 +1059,36 @@ function formatContextText(result, ctx = "cli") {
     out += `   Constants: ${result.constants.length}
 `;
   }
-  out += nextSteps("context", ctx);
+  out += `
+\u{1F4D6} Proximos passos:
+`;
+  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
+`;
+  }
+  if (result.category === "service") {
+    out += `   \u2192 ${hint("impact", ctx, { "<arquivo>": result.file })} - ver quem usa este service
+`;
+  }
+  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") {
@@ -1995,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) {
@@ -2007,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 {
@@ -2064,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,
@@ -2085,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}`);
@@ -2126,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) {
@@ -2137,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;
 }
@@ -2175,7 +2272,7 @@ async function dead(options = {}) {
         knipOutput = {};
       }
     } finally {
-      if (knipConfigPath && existsSync4(knipConfigPath)) {
+      if (knipConfigPath && existsSync5(knipConfigPath)) {
         try {
           unlinkSync(knipConfigPath);
         } catch {
@@ -2258,29 +2355,33 @@ ${output}`;
 import skott2 from "skott";
 
 // 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,
@@ -2288,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}
 
@@ -2318,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, {
@@ -2334,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) {
@@ -2374,67 +2481,57 @@ function formatAreaNotFound(options) {
   }
   out += `\u{1F4D6} Dicas:
 `;
-  out += `   \u2022 Use o ID exato da \xE1rea (ex: ai-tool area auth)
+  out += `   \u2192 ${hint("areas", ctx)} - listar todas as areas
 `;
-  out += `   \u2022 Use 'ai-tool areas' para listar todas as \xE1reas
+  out += `   \u2192 ${hint("describe", ctx)} - buscar areas por descricao
 `;
-  out += `   \u2022 IDs s\xE3o case-sensitive (Auth \u2260 auth)
-`;
-  out += `
-\u{1F4CC} Comandos relacionados:
-`;
-  out += `   ai-tool areas      Listar todas as \xE1reas
-`;
-  out += `   ai-tool map        Ver estrutura do projeto
+  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;
@@ -2490,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)) {
@@ -2532,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");
   }
@@ -2577,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];
@@ -2610,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}`);
@@ -2772,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");
   }
@@ -2813,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);
@@ -2825,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}`);
@@ -3020,8 +3119,8 @@ 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
@@ -3257,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
@@ -3372,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;
       }
@@ -3888,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");
   }
@@ -3895,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);
@@ -3933,7 +4033,7 @@ async function context(target, options = {}) {
       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}`);
@@ -3943,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;
     }
   }
@@ -3978,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;
       }
@@ -4015,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)) {
@@ -4062,7 +4184,7 @@ async function areaContext(areaName, options = {}) {
       if (format === "json") {
         return JSON.stringify({ error: `Area nao encontrada: "${areaName}"`, availableAreas: areaList });
       }
-      return formatAreaNotFound({ target: areaName, availableAreas: areaList });
+      return formatAreaNotFound({ target: areaName, availableAreas: areaList, ctx });
     }
     const types = [];
     const hooks = [];
@@ -4168,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}`);
@@ -4195,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",
@@ -4212,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);
@@ -4273,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}`);
@@ -4283,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;
       }
@@ -4308,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",
@@ -4357,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);
@@ -4390,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 = {};
@@ -4427,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);
@@ -4462,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;
       }
@@ -4494,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",
@@ -4510,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",
@@ -4524,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/"));
@@ -4679,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)",
@@ -4783,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;
       }
@@ -4814,6 +4959,7 @@ 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 nao e um projeto Firebase (nao encontrou .firebaserc ou firebase.json)";
     if (format === "json") {
@@ -4824,11 +4970,11 @@ async function functions(options = {}) {
     out += `
 \u{1F4A1} Comandos disponiveis para este projeto:
 `;
-    out += `   \u2192 ai-tool map - ver estrutura do projeto
+    out += `   \u2192 ${hint("map", ctx)} - ver estrutura do projeto
 `;
-    out += `   \u2192 ai-tool find <termo> - buscar simbolos no codigo
+    out += `   \u2192 ${hint("find", ctx)} - buscar simbolos no codigo
 `;
-    out += `   \u2192 ai-tool areas - listar areas funcionais
+    out += `   \u2192 ${hint("areas", ctx)} - listar areas funcionais
 `;
     return out;
   }
@@ -4915,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 += `
 `;
@@ -4938,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 += `   Possiveis causas:
 `;
-    out += `      1. O projeto n\xE3o \xE9 Firebase (n\xE3o encontrou .firebaserc ou firebase.json)
+    out += `      1. O projeto nao e Firebase (nao encontrou .firebaserc ou firebase.json)
 `;
-    out += `      2. N\xE3o h\xE1 arquivo functions/src/index.ts
+    out += `      2. Nao ha arquivo functions/src/index.ts
 `;
-    out += `      3. Os triggers n\xE3o usam padr\xF5es v2 (onCall, onDocumentCreated, etc)
+    out += `      3. Os triggers nao usam padroes v2 (onCall, onDocumentCreated, etc)
 `;
-    out += `      4. O cache est\xE1 desatualizado (ex: atualizou o ai-tool recentemente)
-`;
-    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;
   }
@@ -5043,6 +5182,7 @@ function formatFunctionsText(result) {
     out += `
 `;
   }
+  out += nextSteps("functions", ctx);
   return out;
 }
 function getTriggerIcon(trigger) {
@@ -5060,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";
@@ -5067,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");
@@ -5119,10 +5262,10 @@ async function find(query, options = {}) {
         if (format === "json") {
           return JSON.stringify({ error: `Nenhum arquivo encontrado na area "${filterArea}"`, availableAreas: areaList });
         }
-        return formatAreaNotFound({ target: 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) {
@@ -5165,13 +5308,13 @@ async function find(query, options = {}) {
       fromCache
     };
     const allSymbolNames = Object.keys(index.symbolsByName);
-    return formatOutput(result, format, (r) => formatFindText(r, "cli", allSymbolNames), fromCache);
+    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();
@@ -5224,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];
@@ -5232,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) {
@@ -5327,7 +5512,6 @@ export {
   map,
   dead,
   deadFix,
-  COMMAND_REFERENCE,
   formatFileNotFound,
   formatAreaNotFound,
   formatMissingTarget,