@justmpm/ai-tool 3.23.0 → 4.0.0

package/dist/chunk-OQSQWBJV.js

@@ -0,0 +1,387 @@
+import {
+  detectFileAreas,
+  findSimilar,
+  formatOutput,
+  getProjectIndexArtifact,
+  getWorkspaceFiles,
+  hint,
+  isFileIgnored,
+  nextSteps,
+  parseCommandOptions,
+  readConfig
+} from "./chunk-BFOWLQIL.js";
+
+// src/commands/describe.ts
+var STOPWORDS = /* @__PURE__ */ new Set([
+  // PT-BR
+  "de",
+  "da",
+  "do",
+  "das",
+  "dos",
+  "para",
+  "com",
+  "em",
+  "uma",
+  "um",
+  "o",
+  "a",
+  "os",
+  "as",
+  "no",
+  "na",
+  "nos",
+  "nas",
+  "pelo",
+  "pela",
+  "que",
+  "e",
+  "ou",
+  "se",
+  "ao",
+  "aos",
+  // EN
+  "the",
+  "of",
+  "in",
+  "for",
+  "with",
+  "on",
+  "at",
+  "to",
+  "and",
+  "or",
+  "is",
+  "are",
+  "was",
+  "by",
+  "an"
+]);
+function removeStopwords(words) {
+  const filtered = words.filter((w) => !STOPWORDS.has(w) && w.length > 1);
+  return filtered.length > 0 ? filtered : words;
+}
+function calculatePartialScore(queryWords, searchableText) {
+  if (queryWords.length === 0) return 1;
+  const fullQuery = queryWords.join(" ");
+  if (searchableText.includes(fullQuery)) return 0;
+  let found = 0;
+  for (const word of queryWords) {
+    if (searchableText.includes(word)) {
+      found++;
+    }
+  }
+  return 1 - found / queryWords.length;
+}
+function buildAreaFileMap(allFiles, config) {
+  const map = /* @__PURE__ */ new Map();
+  for (const filePath of allFiles) {
+    if (isFileIgnored(filePath, config)) continue;
+    const fileAreas = detectFileAreas(filePath, config);
+    for (const areaId of fileAreas) {
+      if (!map.has(areaId)) map.set(areaId, []);
+      map.get(areaId).push(filePath);
+    }
+  }
+  return map;
+}
+var GENERIC_PARAMS = /* @__PURE__ */ new Set([
+  "id",
+  "data",
+  "item",
+  "row",
+  "key",
+  "val",
+  "value",
+  "obj",
+  "obj",
+  "arr",
+  "list",
+  "map",
+  "set",
+  "x",
+  "y",
+  "z",
+  "a",
+  "b",
+  "c",
+  "n",
+  "i",
+  "j",
+  "k",
+  "err",
+  "e",
+  "res",
+  "req",
+  "next"
+]);
+function buildSearchableTextAndMatches(candidate, config, areaFileMap, index, queryWords) {
+  const symbolMatches = [];
+  const metadata = `${candidate.id} ${candidate.name} ${candidate.description}`;
+  const keywords = config.areas[candidate.id]?.keywords?.join(" ") ?? "";
+  const areaFiles = areaFileMap.get(candidate.id) ?? [];
+  const fileNames = areaFiles.map((f) => {
+    const name = f.split("/").pop() ?? "";
+    return name.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+  }).join(" ");
+  const symbolNames = [];
+  const symbolSignatures = [];
+  const symbolParams = [];
+  const symbolReturnTypes = [];
+  for (const filePath of areaFiles) {
+    const fileData = index.files[filePath];
+    if (fileData?.symbols) {
+      for (const symbol of fileData.symbols) {
+        if (!symbol.isExported) continue;
+        symbolNames.push(symbol.name);
+        const MAX_SIGNATURE_CHARS = 200;
+        const sig = symbol.signature.length > MAX_SIGNATURE_CHARS ? symbol.signature.slice(0, MAX_SIGNATURE_CHARS) + "..." : symbol.signature;
+        symbolSignatures.push(sig);
+        if (symbol.params && symbol.params.length > 0) {
+          const filteredParams = symbol.params.filter((p) => !GENERIC_PARAMS.has(p));
+          const paramsText = filteredParams.slice(0, 10).join(" ");
+          if (paramsText) {
+            symbolParams.push(paramsText);
+          }
+        }
+        if (symbol.returnType) {
+          symbolReturnTypes.push(symbol.returnType);
+        }
+        for (const word of queryWords) {
+          if (symbol.signature.toLowerCase().includes(word)) {
+            const cleanSig = symbol.signature.replace(/export\s+/g, "").replace(/\s+/g, " ");
+            symbolMatches.push({
+              name: symbol.name,
+              file: filePath,
+              signature: cleanSig,
+              matchType: "signature",
+              matchedText: word
+            });
+          } else if (symbol.params?.some((p) => p.toLowerCase().includes(word))) {
+            const cleanSig = symbol.signature.replace(/export\s+/g, "").replace(/\s+/g, " ");
+            symbolMatches.push({
+              name: symbol.name,
+              file: filePath,
+              signature: cleanSig,
+              matchType: "params",
+              matchedText: word
+            });
+          } else if (symbol.returnType?.toLowerCase().includes(word)) {
+            const cleanSig = symbol.signature.replace(/export\s+/g, "").replace(/\s+/g, " ");
+            symbolMatches.push({
+              name: symbol.name,
+              file: filePath,
+              signature: cleanSig,
+              matchType: "returnType",
+              matchedText: word
+            });
+          }
+        }
+      }
+    }
+  }
+  const searchableText = [
+    metadata,
+    keywords,
+    fileNames,
+    symbolNames.join(" "),
+    symbolSignatures.join(" "),
+    symbolParams.join(" "),
+    symbolReturnTypes.join(" ")
+  ].join(" ").toLowerCase();
+  return { searchableText, symbolMatches };
+}
+async function findAreaMatches(normalizedQuery, candidates, config, cwd) {
+  const allFiles = await getWorkspaceFiles(cwd);
+  const artifact = await getProjectIndexArtifact(cwd, { useCache: true });
+  const index = artifact.index;
+  const areaFileMap = buildAreaFileMap(allFiles, config);
+  const queryWords = removeStopwords(normalizedQuery.split(/\s+/));
+  const matches = [];
+  for (const candidate of candidates) {
+    const { searchableText, symbolMatches } = buildSearchableTextAndMatches(
+      candidate,
+      config,
+      areaFileMap,
+      index,
+      queryWords
+    );
+    const score = calculatePartialScore(queryWords, searchableText);
+    if (score < 0.6) {
+      const areaFiles = areaFileMap.get(candidate.id) ?? [];
+      const seen = /* @__PURE__ */ new Set();
+      const uniqueSymbolMatches = symbolMatches.filter((m) => {
+        const key = `${m.file}:${m.signature}`;
+        if (seen.has(key)) return false;
+        seen.add(key);
+        return true;
+      });
+      matches.push({
+        id: candidate.id,
+        name: candidate.name,
+        description: candidate.description || "Sem descricao",
+        files: areaFiles,
+        fileCount: areaFiles.length,
+        score,
+        symbolMatches: uniqueSymbolMatches.length > 0 ? uniqueSymbolMatches : void 0
+      });
+    }
+  }
+  return matches.sort((a, b) => a.score - b.score);
+}
+async function describe(query, options = {}) {
+  const { cwd, format } = parseCommandOptions(options);
+  const ctx = options.ctx || "cli";
+  if (!query || query.trim().length === 0) {
+    throw new Error("Query \xE9 obrigat\xF3ria. Exemplo: ai-tool describe 'autentica\xE7\xE3o'");
+  }
+  try {
+    const config = readConfig(cwd);
+    const hasAreas = Object.keys(config.areas).length > 0;
+    if (!hasAreas) {
+      let out = `\u26A0\uFE0F Nenhuma area configurada neste projeto.
+
+`;
+      out += `O comando describe busca em areas configuradas.
+`;
+      out += `Para configurar areas:
+`;
+      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("find", ctx)} - buscar simbolos no codigo
+`;
+      out += `   \u2192 ${hint("map", ctx)} - ver estrutura do projeto
+`;
+      return out;
+    }
+    const normalizedQuery = query.toLowerCase().trim();
+    const candidates = Object.entries(config.areas).map(([id, area]) => ({
+      id,
+      name: area.name,
+      description: area.description || ""
+    }));
+    const matches = await findAreaMatches(normalizedQuery, candidates, config, cwd);
+    const suggestions = [];
+    if (matches.length === 0) {
+      const similarAreaIds = findSimilar(
+        normalizedQuery,
+        candidates.map((c) => c.id),
+        { maxDistance: 2, limit: 3 }
+      );
+      const similarNames = findSimilar(
+        normalizedQuery,
+        candidates.map((c) => c.name),
+        { maxDistance: 2, limit: 3 }
+      );
+      suggestions.push(
+        ...similarAreaIds.map((id) => `\u2192 ${hint("describe", ctx, { "<termo>": id })}`),
+        ...similarNames.map((name) => `\u2192 ${hint("describe", ctx, { "<termo>": `"${name}"` })}`)
+      );
+    }
+    const result = {
+      version: "1.0.0",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      query,
+      areas: matches,
+      suggestions: suggestions.length > 0 ? suggestions : void 0
+    };
+    return formatOutput(result, format, (r) => formatDescribeText(r, ctx));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Erro ao executar describe: ${message}`);
+  }
+}
+function formatDescribeText(result, ctx = "cli") {
+  let out = "";
+  if (result.areas.length === 0) {
+    out += `\u274C Nenhuma area encontrada para: "${result.query}"
+
+`;
+    if (result.suggestions && result.suggestions.length > 0) {
+      out += `\u{1F4A1} Voce quis dizer?
+`;
+      for (const suggestion of result.suggestions) {
+        out += `   ${suggestion}
+`;
+      }
+      out += `
+`;
+    }
+    out += `\u{1F4D6} Dicas:
+`;
+    out += `   \u2192 ${hint("areas", ctx)} - listar todas as areas disponiveis
+`;
+    out += `   \u2192 ${hint("find", ctx)} - buscar simbolos por nome
+`;
+    return out;
+  }
+  out += `\u{1F50D} Busca: "${result.query}"
+
+`;
+  for (const area of result.areas) {
+    out += `## ${area.name} (${area.id})
+`;
+    out += `${area.description}
+`;
+    out += `\u{1F4C1} ${area.fileCount} arquivo(s)
+`;
+    if (area.symbolMatches && area.symbolMatches.length > 0) {
+      out += `
+\u{1F517} Simbolos que correspondem a busca:
+`;
+      const byFile = /* @__PURE__ */ new Map();
+      for (const match of area.symbolMatches) {
+        if (!byFile.has(match.file)) byFile.set(match.file, []);
+        byFile.get(match.file).push(match);
+      }
+      const MAX_SYMBOLS = 5;
+      let count = 0;
+      for (const [file, matches] of byFile) {
+        for (const match of matches) {
+          if (count >= MAX_SYMBOLS) break;
+          const matchLabel = match.matchType === "signature" ? "\u21B3" : match.matchType === "params" ? "\u2192 (param)" : "\u2192 (return)";
+          out += `   ${matchLabel} ${file}
+`;
+          out += `      ${match.signature}
+`;
+          count++;
+        }
+        if (count >= MAX_SYMBOLS) break;
+      }
+      if (area.symbolMatches.length > MAX_SYMBOLS) {
+        out += `   ... e mais ${area.symbolMatches.length - MAX_SYMBOLS} simbolo(s)
+`;
+      }
+    }
+    out += "\n";
+    if (area.files.length > 0) {
+      const MAX_FILES = 5;
+      const filesToShow = area.files.slice(0, MAX_FILES);
+      const remaining = area.files.length - filesToShow.length;
+      out += `Arquivos:
+`;
+      for (const file of filesToShow) {
+        out += `   \u2022 ${file}
+`;
+      }
+      if (remaining > 0) {
+        out += `   ... e mais ${remaining} arquivo(s)
+`;
+        out += `   \u2192 ${hint("area", ctx, { "<nome>": area.id })} - ver todos
+`;
+      }
+      out += "\n";
+    }
+  }
+  out += nextSteps("describe", ctx);
+  return out;
+}
+
+export {
+  describe
+};

package/dist/cli.js

@@ -1,10 +1,7 @@
 #!/usr/bin/env node
 import {
-  depsApi,
-  depsInfo,
-  depsSearch,
   describe
-} from "./chunk-4Z6PUAFR.js";
+} from "./chunk-OQSQWBJV.js";
 import {
   VERSION,
   area,
@@ -20,7 +17,7 @@ import {
   impact,
   map,
   suggest
-} from "./chunk-WTRV35AO.js";
+} from "./chunk-BFOWLQIL.js";
 
 // src/cli.ts
 import { resolve } from "path";
@@ -65,12 +62,7 @@ CHANGES:
   changes --unstaged     Mudancas no working directory
   changes --file=src/types/auth.ts  Detalhar um arquivo especifico
 
-DEPS:
-  deps info <pacote>      Informacoes gerais de um pacote instalado
-  deps api <pacote>       API publica (funcoes, tipos, interfaces)
-  deps search <pacote> <termo>  Busca simbolo especifico no pacote
-
-MODOS:
+  MODOS:
   --mcp                  Inicia servidor MCP para integracao com Claude Desktop
 
 OPCOES:
@@ -131,7 +123,7 @@ async function main() {
     }
   }
   if (flags.mcp) {
-    const { startMcpServer } = await import("./server-3HLEATUD.js");
+    const { startMcpServer } = await import("./server-QFWWHDJY.js");
     await startMcpServer();
     return;
   }
@@ -262,52 +254,6 @@ async function main() {
           file: flags.file
         });
         break;
-      case "deps":
-        if (!target) {
-          console.error("Erro: subcomando deps obrigatorio");
-          console.error("   Exemplo: ai-tool deps info @mui/material");
-          console.error("   Exemplo: ai-tool deps api zustand");
-          console.error("   Exemplo: ai-tool deps search @mui/material Button");
-          process.exit(1);
-        }
-        switch (target) {
-          case "info": {
-            const pkg = positional[2];
-            if (!pkg) {
-              console.error("Erro: nome do pacote obrigatorio para deps info");
-              console.error("   Exemplo: ai-tool deps info @mui/material");
-              process.exit(1);
-            }
-            result = await depsInfo(pkg, { format, cwd, ctx: "cli" });
-            break;
-          }
-          case "api": {
-            const pkg = positional[2];
-            if (!pkg) {
-              console.error("Erro: nome do pacote obrigatorio para deps api");
-              console.error("   Exemplo: ai-tool deps api zustand");
-              process.exit(1);
-            }
-            result = await depsApi(pkg, { format, cwd, limit: flags.limit ? Number(flags.limit) : void 0, kind: flags.kind, ctx: "cli" });
-            break;
-          }
-          case "search": {
-            const pkg = positional[2];
-            const query = positional[3];
-            if (!pkg || !query) {
-              console.error("Erro: pacote e termo de busca obrigatorios para deps search");
-              console.error("   Exemplo: ai-tool deps search @mui/material Button");
-              process.exit(1);
-            }
-            result = await depsSearch(pkg, query, { format, cwd, kind: flags.kind, ctx: "cli" });
-            break;
-          }
-          default:
-            console.error(`Subcomando deps desconhecido: ${target}`);
-            console.error("   Subcomandos disponiveis: info, api, search");
-            process.exit(1);
-        }
-        break;
       default:
         console.error(`\u274C Comando desconhecido: ${command}`);
         console.error("   Use 'ai-tool --help' para ver comandos dispon\xEDveis.");

package/dist/index.d.ts

@@ -568,7 +568,7 @@ declare function nextSteps(command: string, ctx: HintContext): string;
  * @param extra - Informação extra sobre o erro
  * @returns String formatada com dica de recuperação
  */
-type RecoveryErrorType = "file_not_found" | "area_not_found" | "no_results" | "no_firebase" | "no_areas_configured" | "symbol_not_found" | "package_not_found" | "index_failed" | "generic";
+type RecoveryErrorType = "file_not_found" | "area_not_found" | "no_results" | "no_firebase" | "no_areas_configured" | "symbol_not_found" | "index_failed" | "generic";
 declare function recoveryHint(errorType: RecoveryErrorType, ctx: HintContext, _extra?: {
     command?: string;
 }): string;

package/dist/index.js

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

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

@@ -1,9 +1,6 @@
 import {
-  depsApi,
-  depsInfo,
-  depsSearch,
   describe
-} from "./chunk-4Z6PUAFR.js";
+} from "./chunk-OQSQWBJV.js";
 import {
   VERSION,
   area,
@@ -19,7 +16,7 @@ import {
   map,
   recoveryHint,
   suggest
-} from "./chunk-WTRV35AO.js";
+} from "./chunk-BFOWLQIL.js";
 
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -626,158 +623,6 @@ Se os entries nao mostrarem descricoes, execute find { query: "<qualquer simbolo
         const hint = recoveryHint("generic", "mcp");
         return {
           content: [{ type: "text", text: `Erro ao executar changes: ${msg}
-${hint}` }],
-          isError: true
-        };
-      }
-    }
-  );
-  server2.registerTool(
-    "aitool_deps_info",
-    {
-      title: "Package Info",
-      description: `Informacoes de um pacote instalado no node_modules: versao, descricao, entry points, dependencias.
-Le o package.json REAL do node_modules (versao instalada, nao do registry).
-
-Quando usar: descobrir versao instalada de uma lib, encontrar entry points, ver dependencias peer, verificar se o pacote tem types.
-NAO use para: ver a API publica (use deps_api) ou buscar simbolo especifico (use deps_search).
-
-Workflow: deps_info (overview) -> deps_api (API completa) -> deps_search (simbolo especifico)
-Dica: Se o pacote nao estiver instalado, instale-o antes (npm/yarn/bun/pnpm).`,
-      inputSchema: {
-        package: z.string().min(1).describe("Nome do pacote (ex: @mui/material, zustand)"),
-        format: z.enum(["text", "json"]).default("text").describe("Formato de saida: text (legivel) ou json (estruturado)"),
-        cwd: z.string().optional().describe("Diretorio do projeto a analisar")
-      },
-      annotations: {
-        title: "Package Info",
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false
-      }
-    },
-    async (params) => {
-      try {
-        const result = await depsInfo(params.package, {
-          format: params.format,
-          cwd: params.cwd,
-          ctx: "mcp"
-        });
-        return { content: [{ type: "text", text: result }] };
-      } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        const hint = recoveryHint("package_not_found", "mcp");
-        return {
-          content: [{ type: "text", text: `Erro ao executar deps info: ${msg}
-${hint}` }],
-          isError: true
-        };
-      }
-    }
-  );
-  server2.registerTool(
-    "aitool_deps_api",
-    {
-      title: "Package API",
-      description: `API publica de um pacote instalado: funcoes, interfaces, tipos, enums exportados.
-Extrai assinaturas dos arquivos .d.ts do node_modules local (diferencial vs ferramentas online).
-
-Quando usar: aprender API de lib nova, ver tipos exportados, entender o que uma lib oferece.
-NAO use para: ver metadados (use deps_info) ou buscar simbolo especifico (use deps_search).
-
-Workflow: deps_info (overview) -> deps_api (API completa) -> deps_search (simbolo especifico)
-Dica: Se a API estiver truncada, use deps_search com wildcards: "Button" (exato), "Button*" (prefixo), "*Button*" (cont\xE9m).
-Dica: Para libs muito grandes (MUI, React), use --limit para controlar o output.`,
-      inputSchema: {
-        package: z.string().min(1).describe("Nome do pacote"),
-        limit: z.number().int().min(1).max(500).optional().describe("Limite de simbolos por tipo (default: 50)"),
-        offset: z.number().int().min(0).optional().describe("Offset para paginacao (default: 0)"),
-        entry: z.string().optional().describe("Sub-export especifico (ex: 'auth' para firebase/firestore)"),
-        kind: z.enum(["component", "hook", "function", "type", "interface", "enum", "const"]).optional().describe("Filtrar por tipo de simbolo (component|hook|function|type|interface|enum|const)"),
-        format: z.enum(["text", "json"]).default("text").describe("Formato de saida: text (legivel) ou json (estruturado)"),
-        cwd: z.string().optional().describe("Diretorio do projeto a analisar")
-      },
-      annotations: {
-        title: "Package API",
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false
-      }
-    },
-    async (params) => {
-      try {
-        const result = await depsApi(params.package, {
-          format: params.format,
-          cwd: params.cwd,
-          limit: params.limit,
-          offset: params.offset,
-          entry: params.entry,
-          kind: params.kind,
-          ctx: "mcp"
-        });
-        return { content: [{ type: "text", text: result }] };
-      } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        const hint = recoveryHint("package_not_found", "mcp");
-        return {
-          content: [{ type: "text", text: `Erro ao executar deps api: ${msg}
-${hint}` }],
-          isError: true
-        };
-      }
-    }
-  );
-  server2.registerTool(
-    "aitool_deps_search",
-    {
-      title: "Search Package Symbol",
-      description: `Busca simbolo especifico na API de um pacote instalado.
-Procura por nome em funcoes, tipos, interfaces, enums e constantes exportados.
-
-Suporta wildcards: "Button" (exato), "Button*" (prefixo), "*Button" (sufixo), "*Button*" (cont\xE9m/substring).
-
-Quando usar: verificar se uma lib exporta algo, encontrar um componente ou tipo especifico.
-NAO use para: ver toda a API (use deps_api) ou metadados (use deps_info).
-
-Dica: Sem wildcard = match exato. Use "*Button*" para buscar tudo que contem "Button".
-Dica: Use deps_search para verificar imports antes de usar um simbolo.
-
-Workflow: deps_info (overview) -> deps_api (API completa) -> deps_search (simbolo especifico)`,
-      inputSchema: {
-        package: z.string().min(1).describe("Nome do pacote"),
-        query: z.string().min(1).describe("Termo de busca (nome do simbolo)"),
-        kind: z.enum(["component", "hook", "function", "type", "interface", "enum", "const"]).optional().describe("Filtrar por tipo de simbolo (component|hook|function|type|interface|enum|const)"),
-        offset: z.number().int().min(0).optional().describe("Offset para paginacao (default: 0)"),
-        limit: z.number().int().min(1).max(200).optional().describe("Limite de resultados (default: 15)"),
-        format: z.enum(["text", "json"]).default("text").describe("Formato de saida: text (legivel) ou json (estruturado)"),
-        cwd: z.string().optional().describe("Diretorio do projeto a analisar")
-      },
-      annotations: {
-        title: "Search Package Symbol",
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false
-      }
-    },
-    async (params) => {
-      try {
-        const result = await depsSearch(params.package, params.query, {
-          format: params.format,
-          cwd: params.cwd,
-          kind: params.kind,
-          offset: params.offset,
-          limit: params.limit,
-          ctx: "mcp"
-        });
-        return { content: [{ type: "text", text: result }] };
-      } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        const hint = recoveryHint("package_not_found", "mcp");
-        return {
-          content: [{ type: "text", text: `Erro ao executar deps search: ${msg}
 ${hint}` }],
           isError: true
         };

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@justmpm/ai-tool",
-  "version": "3.23.0",
-  "description": "Ferramenta de análise de dependências e impacto para projetos TypeScript/JavaScript. Usa Skott + Knip internamente. Inclui busca por descrição, integração Git e testes inteligentes.",
+  "version": "4.0.0",
+  "description": "Ferramenta de análise de código para projetos TypeScript/JavaScript. Mapa do projeto, impacto de mudanças, código morto, Cloud Functions, busca de símbolos e áreas funcionais. Usa Skott + Knip + ts-morph internamente.",
   "keywords": [
     "dependency-analysis",
     "impact-analysis",
     "dead-code",
+    "code-analysis",
+    "symbol-search",
     "typescript",
     "javascript",
     "skott",