@justmpm/ai-tool 0.9.2 → 1.0.0

package/dist/chunk-35SMNOXI.js

@@ -0,0 +1,252 @@
+import {
+  cacheSymbolsIndex,
+  detectFileAreas,
+  findSimilar,
+  formatOutput,
+  getAllCodeFiles,
+  getCachedSymbolsIndex,
+  indexProject,
+  isCacheValid,
+  isFileIgnored,
+  parseCommandOptions,
+  readConfig,
+  updateCacheMeta
+} from "./chunk-LC7H7LGY.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;
+}
+function buildSearchableText(candidate, config, areaFileMap, index) {
+  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 = [];
+  for (const filePath of areaFiles) {
+    const fileData = index.files[filePath];
+    if (fileData?.symbols) {
+      for (const symbol of fileData.symbols) {
+        if (symbol.isExported) {
+          symbolNames.push(symbol.name);
+        }
+      }
+    }
+  }
+  return `${metadata} ${keywords} ${fileNames} ${symbolNames.join(" ")}`.toLowerCase();
+}
+function findAreaMatches(normalizedQuery, candidates, config, cwd) {
+  const allFiles = getAllCodeFiles(cwd);
+  let index;
+  if (isCacheValid(cwd)) {
+    const cached = getCachedSymbolsIndex(cwd);
+    if (cached?.files) {
+      index = cached;
+    } else {
+      index = indexProject(cwd);
+      cacheSymbolsIndex(cwd, index);
+      updateCacheMeta(cwd);
+    }
+  } else {
+    index = indexProject(cwd);
+    cacheSymbolsIndex(cwd, index);
+    updateCacheMeta(cwd);
+  }
+  const areaFileMap = buildAreaFileMap(allFiles, config);
+  const queryWords = removeStopwords(normalizedQuery.split(/\s+/));
+  const matches = [];
+  for (const candidate of candidates) {
+    const searchableText = buildSearchableText(candidate, config, areaFileMap, index);
+    const score = calculatePartialScore(queryWords, searchableText);
+    if (score < 0.6) {
+      const areaFiles = areaFileMap.get(candidate.id) ?? [];
+      matches.push({
+        id: candidate.id,
+        name: candidate.name,
+        description: candidate.description || "Sem descricao",
+        files: areaFiles,
+        fileCount: areaFiles.length,
+        score
+      });
+    }
+  }
+  return matches.sort((a, b) => a.score - b.score);
+}
+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, 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 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 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) {
+      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 Use 'ai-tool area ${area.id}' para ver todos
+`;
+      }
+      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
+};