@justmpm/ai-tool 0.9.0 → 0.9.1

package/dist/chunk-CACALWH5.js

@@ -0,0 +1,145 @@
+import {
+  findSimilar,
+  formatOutput,
+  parseCommandOptions,
+  readConfig
+} from "./chunk-NVJXCSJF.js";
+
+// src/commands/describe.ts
+async function describe(query, options = {}) {
+  const { cwd, format } = parseCommandOptions(options);
+  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 normalizedQuery = query.toLowerCase().trim();
+    const candidates = Object.entries(config.areas).map(([id, area]) => ({
+      id,
+      name: area.name,
+      description: area.description || ""
+    }));
+    const matches = findAreaMatches(normalizedQuery, candidates, config);
+    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 ai-tool describe ${id}`),
+        ...similarNames.map((name) => `\u2192 ai-tool describe "${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, formatDescribeText);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Erro ao executar describe: ${message}`);
+  }
+}
+function findAreaMatches(normalizedQuery, candidates, config) {
+  const matches = [];
+  for (const candidate of candidates) {
+    const searchableText = `${candidate.id} ${candidate.name} ${candidate.description}`.toLowerCase();
+    const hasDirectMatch = searchableText.includes(normalizedQuery);
+    const queryWords = normalizedQuery.split(/\s+/);
+    const allWordsMatch = queryWords.every((word) => searchableText.includes(word));
+    if (hasDirectMatch || allWordsMatch) {
+      const areaFiles = getAreaFiles(candidate.id, config);
+      const score = calculateRelevanceScore(normalizedQuery, searchableText);
+      matches.push({
+        id: candidate.id,
+        name: candidate.name,
+        description: candidate.description || "Sem descri\xE7\xE3o",
+        files: areaFiles,
+        fileCount: areaFiles.length,
+        score
+      });
+    }
+  }
+  return matches.sort((a, b) => a.score - b.score);
+}
+function getAreaFiles(areaId, config) {
+  const files = [];
+  const areaConfig = config.areas[areaId];
+  if (areaConfig?.patterns) {
+    files.push(`[Use 'ai-tool area ${areaId}' para ver arquivos completos]`);
+  }
+  return files;
+}
+function calculateRelevanceScore(query, text) {
+  if (text.includes(query)) {
+    return 0;
+  }
+  const queryWords = query.split(/\s+/).filter(Boolean);
+  const allWordsPresent = queryWords.every((word) => text.includes(word));
+  if (allWordsPresent) {
+    return 1;
+  }
+  return 10;
+}
+function formatDescribeText(result) {
+  let out = "";
+  if (result.areas.length === 0) {
+    out += `\u274C Nenhuma \xE1rea encontrada para: "${result.query}"
+
+`;
+    if (result.suggestions && result.suggestions.length > 0) {
+      out += `\u{1F4A1} Voc\xEA quis dizer?
+`;
+      for (const suggestion of result.suggestions) {
+        out += `   ${suggestion}
+`;
+      }
+      out += `
+`;
+    }
+    out += `\u{1F4D6} Dica: Use 'ai-tool areas' para listar todas as \xE1reas dispon\xEDveis`;
+    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.files.length > 0) {
+      out += `Arquivos:
+`;
+      for (const file of area.files) {
+        out += `   \u2022 ${file}
+`;
+      }
+      out += "\n";
+    }
+  }
+  out += `\u{1F4D6} Pr\xF3ximos passos:
+`;
+  out += `   \u2192 ai-tool area <id> - ver detalhes de uma \xE1rea
+`;
+  out += `   \u2192 ai-tool context --area=<id> - contexto completo de uma \xE1rea
+`;
+  return out;
+}
+
+export {
+  describe
+};

package/dist/cli.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  describe
+} from "./chunk-CACALWH5.js";
 import {
   VERSION,
   area,
@@ -30,6 +33,7 @@ COMANDOS:
   context <arquivo>      Extrai assinaturas de um arquivo (funcoes, tipos)
   context --area=<nome>  Contexto consolidado de toda uma area
   find <termo>           Busca simbolos no codigo (funcoes, tipos, etc)
+  describe <termo>       Busca areas por descricao em linguagem natural
 
 AREAS:
   areas                  Lista todas as areas/dominios do projeto
@@ -83,6 +87,7 @@ EXEMPLOS:
   ai-tool find useAuth             # Busca definicao e usos
   ai-tool find User --type=type    # Busca apenas tipos
   ai-tool find login --area=auth   # Busca na area auth
+  ai-tool describe cache           # Busca areas por descricao
   ai-tool areas
   ai-tool area auth
   ai-tool area auth --type=hook
@@ -108,7 +113,7 @@ async function main() {
     }
   }
   if (flags.mcp) {
-    const { startMcpServer } = await import("./server-L24EN4AN.js");
+    const { startMcpServer } = await import("./server-OMKVOYK7.js");
     await startMcpServer();
     return;
   }
@@ -222,6 +227,15 @@ async function main() {
           trigger: flags.trigger
         });
         break;
+      case "describe":
+        if (!target) {
+          console.error("\u274C Erro: termo de busca \xE9 obrigat\xF3rio para o comando describe");
+          console.error("   Exemplo: ai-tool describe cache");
+          console.error("   Exemplo: ai-tool describe login");
+          process.exit(1);
+        }
+        result = await describe(target, { format, cwd });
+        break;
       default:
         console.error(`\u274C Comando desconhecido: ${command}`);
         console.error("   Use 'ai-tool --help' para ver comandos dispon\xEDveis.");

package/dist/{server-L24EN4AN.js → server-OMKVOYK7.js}

@@ -1,3 +1,6 @@
+import {
+  describe
+} from "./chunk-CACALWH5.js";
 import {
   VERSION,
   area,
@@ -7,13 +10,9 @@ import {
   context,
   dead,
   find,
-  findSimilar,
-  formatOutput,
   functions,
   impact,
   map,
-  parseCommandOptions,
-  readConfig,
   suggest
 } from "./chunk-NVJXCSJF.js";
 
@@ -23,143 +22,6 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 
 // src/mcp/tools.ts
 import { z } from "zod";
-
-// src/commands/describe.ts
-async function describe(query, options = {}) {
-  const { cwd, format } = parseCommandOptions(options);
-  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 normalizedQuery = query.toLowerCase().trim();
-    const candidates = Object.entries(config.areas).map(([id, area2]) => ({
-      id,
-      name: area2.name,
-      description: area2.description || ""
-    }));
-    const matches = findAreaMatches(normalizedQuery, candidates, config);
-    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 ai-tool describe ${id}`),
-        ...similarNames.map((name) => `\u2192 ai-tool describe "${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, formatDescribeText);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Erro ao executar describe: ${message}`);
-  }
-}
-function findAreaMatches(normalizedQuery, candidates, config) {
-  const matches = [];
-  for (const candidate of candidates) {
-    const searchableText = `${candidate.id} ${candidate.name} ${candidate.description}`.toLowerCase();
-    const hasDirectMatch = searchableText.includes(normalizedQuery);
-    const queryWords = normalizedQuery.split(/\s+/);
-    const allWordsMatch = queryWords.every((word) => searchableText.includes(word));
-    if (hasDirectMatch || allWordsMatch) {
-      const areaFiles = getAreaFiles(candidate.id, config);
-      const score = calculateRelevanceScore(normalizedQuery, searchableText);
-      matches.push({
-        id: candidate.id,
-        name: candidate.name,
-        description: candidate.description || "Sem descri\xE7\xE3o",
-        files: areaFiles,
-        fileCount: areaFiles.length,
-        score
-      });
-    }
-  }
-  return matches.sort((a, b) => a.score - b.score);
-}
-function getAreaFiles(areaId, config) {
-  const files = [];
-  const areaConfig = config.areas[areaId];
-  if (areaConfig?.patterns) {
-    files.push(`[Use 'ai-tool area ${areaId}' para ver arquivos completos]`);
-  }
-  return files;
-}
-function calculateRelevanceScore(query, text) {
-  if (text.includes(query)) {
-    return 0;
-  }
-  const queryWords = query.split(/\s+/).filter(Boolean);
-  const allWordsPresent = queryWords.every((word) => text.includes(word));
-  if (allWordsPresent) {
-    return 1;
-  }
-  return 10;
-}
-function formatDescribeText(result) {
-  let out = "";
-  if (result.areas.length === 0) {
-    out += `\u274C Nenhuma \xE1rea encontrada para: "${result.query}"
-
-`;
-    if (result.suggestions && result.suggestions.length > 0) {
-      out += `\u{1F4A1} Voc\xEA quis dizer?
-`;
-      for (const suggestion of result.suggestions) {
-        out += `   ${suggestion}
-`;
-      }
-      out += `
-`;
-    }
-    out += `\u{1F4D6} Dica: Use 'ai-tool areas' para listar todas as \xE1reas dispon\xEDveis`;
-    return out;
-  }
-  out += `\u{1F50D} Busca: "${result.query}"
-
-`;
-  for (const area2 of result.areas) {
-    out += `## ${area2.name} (${area2.id})
-`;
-    out += `${area2.description}
-`;
-    out += `\u{1F4C1} ${area2.fileCount} arquivo(s)
-
-`;
-    if (area2.files.length > 0) {
-      out += `Arquivos:
-`;
-      for (const file of area2.files) {
-        out += `   \u2022 ${file}
-`;
-      }
-      out += "\n";
-    }
-  }
-  out += `\u{1F4D6} Pr\xF3ximos passos:
-`;
-  out += `   \u2192 ai-tool area <id> - ver detalhes de uma \xE1rea
-`;
-  out += `   \u2192 ai-tool context --area=<id> - contexto completo de uma \xE1rea
-`;
-  return out;
-}
-
-// src/mcp/tools.ts
 function registerAllTools(server2) {
   server2.registerTool(
     "aitool_project_map",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justmpm/ai-tool",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "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.",
   "keywords": [
     "dependency-analysis",
@@ -39,7 +39,7 @@
     "build": "tsup src/index.ts src/cli.ts --format esm --dts --clean",
     "dev": "tsup src/index.ts src/cli.ts --format esm --dts --watch",
     "prepublishOnly": "npm run build",
-    "test": "node --test",
+    "test": "tsx --test",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
@@ -52,6 +52,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.15.21",
+    "tsx": "^4.19.0",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3"
   },