@justmpm/ai-tool 0.2.0 → 0.3.1

package/dist/{chunk-HOVHD2N4.js → chunk-4HXWM7PK.js}

@@ -373,6 +373,218 @@ function formatImpactText(result) {
   }
   return out;
 }
+function formatSuggestText(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{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
+
+`;
+  const icon = categoryIcons[result.category];
+  out += `\u{1F4CD} Antes de modificar: ${result.target}
+`;
+  out += `   ${icon} ${result.category}
+
+`;
+  if (result.suggestions.length === 0) {
+    out += `\u2705 Nenhuma sugestao de leitura.
+`;
+    out += `   Este arquivo nao tem dependencias ou arquivos relacionados.
+`;
+    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"),
+    medium: result.suggestions.filter((s) => s.priority === "medium"),
+    low: result.suggestions.filter((s) => s.priority === "low")
+  };
+  if (byPriority.critical.length > 0) {
+    out += `\u{1F534} LEITURA CRITICA (${byPriority.critical.length})
+`;
+    out += `   Tipos e interfaces que voce DEVE entender:
+
+`;
+    for (const s of byPriority.critical) {
+      const sIcon = categoryIcons[s.category];
+      out += `   ${sIcon} ${s.path}
+`;
+      out += `      ${s.reason}
+`;
+    }
+    out += `
+`;
+  }
+  if (byPriority.high.length > 0) {
+    out += `\u{1F7E0} LEITURA IMPORTANTE (${byPriority.high.length})
+`;
+    out += `   Arquivos importados diretamente:
+
+`;
+    for (const s of byPriority.high) {
+      const sIcon = categoryIcons[s.category];
+      out += `   ${sIcon} ${s.path}
+`;
+      out += `      ${s.reason}
+`;
+    }
+    out += `
+`;
+  }
+  if (byPriority.medium.length > 0) {
+    out += `\u{1F7E1} LEITURA RECOMENDADA (${byPriority.medium.length})
+`;
+    out += `   Arquivos que usam este arquivo:
+
+`;
+    for (const s of byPriority.medium) {
+      const sIcon = categoryIcons[s.category];
+      out += `   ${sIcon} ${s.path}
+`;
+      out += `      ${s.reason}
+`;
+    }
+    out += `
+`;
+  }
+  if (byPriority.low.length > 0) {
+    out += `\u{1F7E2} LEITURA OPCIONAL (${byPriority.low.length})
+`;
+    out += `   Testes relacionados:
+
+`;
+    for (const s of byPriority.low) {
+      const sIcon = categoryIcons[s.category];
+      out += `   ${sIcon} ${s.path}
+`;
+      out += `      ${s.reason}
+`;
+    }
+    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}
+`;
+  if (byPriority.critical.length > 0) {
+    out += `   \u{1F534} Criticos: ${byPriority.critical.length}
+`;
+  }
+  if (byPriority.high.length > 0) {
+    out += `   \u{1F7E0} Importantes: ${byPriority.high.length}
+`;
+  }
+  if (byPriority.medium.length > 0) {
+    out += `   \u{1F7E1} Recomendados: ${byPriority.medium.length}
+`;
+  }
+  if (byPriority.low.length > 0) {
+    out += `   \u{1F7E2} Opcionais: ${byPriority.low.length}
+`;
+  }
+  return out;
+}
+function formatContextText(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{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
+
+`;
+  const icon = categoryIcons[result.category];
+  out += `\u{1F4CD} ARQUIVO: ${result.file}
+`;
+  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})
+
+`;
+    for (const imp of result.imports) {
+      const typeLabel = imp.isTypeOnly ? " [type]" : "";
+      out += `   ${imp.source}${typeLabel}
+`;
+      if (imp.specifiers.length > 0) {
+        out += `      { ${imp.specifiers.join(", ")} }
+`;
+      }
+    }
+    out += `
+`;
+  }
+  if (result.exports.length > 0) {
+    out += `\u{1F4E4} EXPORTS (${result.exports.length})
+`;
+    out += `   ${result.exports.join(", ")}
+
+`;
+  }
+  if (result.types.length > 0) {
+    out += `\u{1F3F7}\uFE0F TYPES (${result.types.length})
+
+`;
+    for (const t of result.types) {
+      const exported = t.isExported ? "export " : "";
+      out += `   ${exported}${t.kind} ${t.name}
+`;
+      out += `      ${t.definition}
+
+`;
+    }
+  }
+  if (result.functions.length > 0) {
+    out += `\u26A1 FUNCTIONS (${result.functions.length})
+
+`;
+    for (const fn of result.functions) {
+      const exported = fn.isExported ? "export " : "";
+      const async = 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}
+`;
+      if (fn.jsdoc) {
+        out += `      /** ${fn.jsdoc} */
+`;
+      }
+      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 += `   Imports: ${result.imports.length}
+`;
+  out += `   Exports: ${result.exports.length}
+`;
+  out += `   Types: ${result.types.length}
+`;
+  out += `   Functions: ${result.functions.length}
+`;
+  return out;
+}
 
 // src/cache/index.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync, statSync, readdirSync } from "fs";
@@ -1010,8 +1222,617 @@ function levenshteinDistance(a, b) {
   return matrix[b.length][a.length];
 }
 
+// src/commands/suggest.ts
+import skott3 from "skott";
+async function suggest(target, options = {}) {
+  const cwd = options.cwd || process.cwd();
+  const format = options.format || "text";
+  const useCache = options.cache !== false;
+  const limit = options.limit || 10;
+  if (!target) {
+    throw new Error("Target e obrigatorio. Exemplo: ai-tool suggest src/components/Button.tsx");
+  }
+  try {
+    let graph;
+    let allFiles = [];
+    let fromCache = false;
+    if (useCache && isCacheValid(cwd)) {
+      const cached = getCachedGraph(cwd);
+      if (cached) {
+        graph = cached.graph;
+        allFiles = cached.files;
+        fromCache = true;
+      }
+    }
+    if (!graph) {
+      const { getStructure } = await skott3({
+        cwd,
+        includeBaseDir: false,
+        dependencyTracking: {
+          thirdParty: false,
+          builtin: false,
+          typeOnly: false
+        },
+        fileExtensions: [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"],
+        tsConfigPath: "tsconfig.json"
+      });
+      const structure = getStructure();
+      graph = structure.graph;
+      allFiles = Object.keys(graph);
+      if (useCache) {
+        cacheGraph(cwd, {
+          graph,
+          files: allFiles,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        updateCacheMeta(cwd);
+      }
+    }
+    const targetPath = findTargetFile2(target, allFiles);
+    if (!targetPath) {
+      return formatNotFound2(target, allFiles);
+    }
+    const suggestions = collectSuggestions(targetPath, graph, allFiles, limit);
+    const result = {
+      version: "1.0.0",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      target: targetPath,
+      category: detectCategory(targetPath),
+      suggestions
+    };
+    if (format === "json") {
+      return JSON.stringify(result, null, 2);
+    }
+    const output = formatSuggestText(result);
+    return fromCache ? output + "\n\n(grafo do cache)" : output;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Erro ao executar suggest: ${message}`);
+  }
+}
+function collectSuggestions(targetPath, graph, allFiles, limit) {
+  const suggestions = [];
+  const addedPaths = /* @__PURE__ */ new Set();
+  const targetNode = graph[targetPath];
+  if (!targetNode) {
+    return suggestions;
+  }
+  for (const dep of targetNode.adjacentTo) {
+    if (addedPaths.has(dep)) continue;
+    addedPaths.add(dep);
+    const category = detectCategory(dep);
+    if (category === "type") {
+      suggestions.push({
+        path: dep,
+        category,
+        reason: "Define tipos usados",
+        priority: "critical"
+      });
+    } else {
+      suggestions.push({
+        path: dep,
+        category,
+        reason: "Importado diretamente",
+        priority: "high"
+      });
+    }
+  }
+  const upstream = findUpstream(targetPath, graph);
+  const upstreamLimited = upstream.slice(0, 5);
+  for (const file of upstreamLimited) {
+    if (addedPaths.has(file)) continue;
+    addedPaths.add(file);
+    suggestions.push({
+      path: file,
+      category: detectCategory(file),
+      reason: "Usa este arquivo",
+      priority: "medium"
+    });
+  }
+  const relatedTests = findRelatedTests(targetPath, allFiles);
+  for (const testFile of relatedTests) {
+    if (addedPaths.has(testFile)) continue;
+    addedPaths.add(testFile);
+    suggestions.push({
+      path: testFile,
+      category: "test",
+      reason: "Testa este arquivo",
+      priority: "low"
+    });
+  }
+  const priorityOrder = {
+    critical: 0,
+    high: 1,
+    medium: 2,
+    low: 3
+  };
+  suggestions.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority]);
+  return suggestions.slice(0, limit);
+}
+function findUpstream(targetPath, graph) {
+  const upstream = [];
+  for (const [file, node] of Object.entries(graph)) {
+    if (node.adjacentTo.includes(targetPath)) {
+      upstream.push(file);
+    }
+  }
+  return upstream;
+}
+function findRelatedTests(targetPath, allFiles) {
+  const targetName = targetPath.split("/").pop() || "";
+  const targetNameNoExt = targetName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+  const tests = [];
+  for (const file of allFiles) {
+    const fileName = file.split("/").pop() || "";
+    if (fileName.includes(".test.") || fileName.includes(".spec.") || file.includes("/__tests__/")) {
+      const testNameNoExt = fileName.replace(/\.(test|spec)\..*$/, "").replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+      if (testNameNoExt.toLowerCase() === targetNameNoExt.toLowerCase()) {
+        tests.push(file);
+      }
+    }
+  }
+  return tests;
+}
+function findTargetFile2(target, allFiles) {
+  const normalizedTarget = target.replace(/\\/g, "/");
+  if (allFiles.includes(normalizedTarget)) {
+    return normalizedTarget;
+  }
+  const targetName = normalizedTarget.split("/").pop()?.toLowerCase() || "";
+  const targetNameNoExt = targetName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+  const matches = [];
+  for (const file of allFiles) {
+    const fileName = file.split("/").pop()?.toLowerCase() || "";
+    const fileNameNoExt = fileName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+    if (fileNameNoExt === targetNameNoExt) {
+      matches.unshift(file);
+    } else if (file.toLowerCase().includes(normalizedTarget.toLowerCase())) {
+      matches.push(file);
+    }
+  }
+  if (matches.length === 1) {
+    return matches[0];
+  }
+  if (matches.length > 1) {
+    return matches[0];
+  }
+  return null;
+}
+function formatNotFound2(target, allFiles) {
+  const normalizedTarget = target.toLowerCase();
+  const similar = allFiles.filter((f) => {
+    const fileName = f.split("/").pop()?.toLowerCase() || "";
+    const fileNameNoExt = fileName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+    return fileName.includes(normalizedTarget) || fileNameNoExt.includes(normalizedTarget) || levenshteinDistance2(fileNameNoExt, normalizedTarget) <= 3;
+  }).slice(0, 5);
+  let out = `Arquivo nao encontrado no indice: "${target}"
+
+`;
+  out += `Total de arquivos indexados: ${allFiles.length}
+
+`;
+  if (similar.length > 0) {
+    out += `Arquivos com nome similar:
+`;
+    for (const s of similar) {
+      out += `   - ${s}
+`;
+    }
+    out += `
+`;
+  }
+  out += `Dicas:
+`;
+  out += `   - Use o caminho relativo: src/components/Header.tsx
+`;
+  out += `   - Ou apenas o nome do arquivo: Header
+`;
+  out += `   - Verifique se o arquivo esta em uma pasta incluida no scan
+`;
+  return out;
+}
+function levenshteinDistance2(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,
+          matrix[i][j - 1] + 1,
+          matrix[i - 1][j] + 1
+        );
+      }
+    }
+  }
+  return matrix[b.length][a.length];
+}
+
+// src/commands/context.ts
+import { existsSync as existsSync2, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import { join as join2, resolve, basename, extname as extname2 } from "path";
+
+// src/ts/extractor.ts
+import { Project, SyntaxKind } from "ts-morph";
+function createProject(cwd) {
+  return new Project({
+    tsConfigFilePath: `${cwd}/tsconfig.json`,
+    skipAddingFilesFromTsConfig: true
+  });
+}
+function addSourceFile(project, filePath) {
+  return project.addSourceFileAtPath(filePath);
+}
+function extractImports(sourceFile) {
+  const imports = [];
+  for (const importDecl of sourceFile.getImportDeclarations()) {
+    const specifiers = [];
+    const defaultImport = importDecl.getDefaultImport();
+    if (defaultImport) {
+      specifiers.push(defaultImport.getText());
+    }
+    for (const namedImport of importDecl.getNamedImports()) {
+      const alias = namedImport.getAliasNode();
+      if (alias) {
+        specifiers.push(`${namedImport.getName()} as ${alias.getText()}`);
+      } else {
+        specifiers.push(namedImport.getName());
+      }
+    }
+    const namespaceImport = importDecl.getNamespaceImport();
+    if (namespaceImport) {
+      specifiers.push(`* as ${namespaceImport.getText()}`);
+    }
+    imports.push({
+      source: importDecl.getModuleSpecifierValue(),
+      specifiers,
+      isTypeOnly: importDecl.isTypeOnly()
+    });
+  }
+  return imports;
+}
+function getJsDocDescription(node) {
+  const jsDocs = node.getChildrenOfKind(SyntaxKind.JSDoc);
+  if (jsDocs.length === 0) return void 0;
+  const firstJsDoc = jsDocs[0];
+  const comment = firstJsDoc.getComment();
+  if (typeof comment === "string") {
+    return comment.trim() || void 0;
+  }
+  if (Array.isArray(comment)) {
+    const text = comment.filter((c) => c !== void 0).map((c) => c.getText()).join("").trim();
+    return text || void 0;
+  }
+  return void 0;
+}
+function extractParams(params) {
+  return params.map((p) => ({
+    name: p.getName(),
+    type: simplifyType(p.getType().getText())
+  }));
+}
+function simplifyType(typeText) {
+  let simplified = typeText.replace(/import\([^)]+\)\./g, "");
+  if (simplified.length > 80) {
+    simplified = simplified.slice(0, 77) + "...";
+  }
+  return simplified;
+}
+function extractFunctions(sourceFile) {
+  const functions = [];
+  for (const func of sourceFile.getFunctions()) {
+    const name = func.getName();
+    if (!name) continue;
+    functions.push({
+      name,
+      params: extractParams(func.getParameters()),
+      returnType: simplifyType(func.getReturnType().getText()),
+      isAsync: func.isAsync(),
+      isExported: func.isExported(),
+      isArrowFunction: false,
+      jsdoc: getJsDocDescription(func)
+    });
+  }
+  for (const varStatement of sourceFile.getVariableStatements()) {
+    const isExported = varStatement.isExported();
+    for (const varDecl of varStatement.getDeclarations()) {
+      const init = varDecl.getInitializer();
+      if (!init) continue;
+      if (init.getKind() === SyntaxKind.ArrowFunction) {
+        const arrowFunc = init.asKind(SyntaxKind.ArrowFunction);
+        if (!arrowFunc) continue;
+        functions.push({
+          name: varDecl.getName(),
+          params: extractParams(arrowFunc.getParameters()),
+          returnType: simplifyType(arrowFunc.getReturnType().getText()),
+          isAsync: arrowFunc.isAsync(),
+          isExported,
+          isArrowFunction: true,
+          jsdoc: getJsDocDescription(varStatement)
+        });
+      }
+      if (init.getKind() === SyntaxKind.FunctionExpression) {
+        const funcExpr = init.asKind(SyntaxKind.FunctionExpression);
+        if (!funcExpr) continue;
+        functions.push({
+          name: varDecl.getName(),
+          params: extractParams(funcExpr.getParameters()),
+          returnType: simplifyType(funcExpr.getReturnType().getText()),
+          isAsync: funcExpr.isAsync(),
+          isExported,
+          isArrowFunction: false,
+          jsdoc: getJsDocDescription(varStatement)
+        });
+      }
+    }
+  }
+  return functions;
+}
+function extractTypes(sourceFile) {
+  const types = [];
+  for (const iface of sourceFile.getInterfaces()) {
+    types.push({
+      name: iface.getName(),
+      kind: "interface",
+      definition: formatInterfaceDefinition(iface),
+      isExported: iface.isExported()
+    });
+  }
+  for (const typeAlias of sourceFile.getTypeAliases()) {
+    types.push({
+      name: typeAlias.getName(),
+      kind: "type",
+      definition: simplifyType(typeAlias.getType().getText()),
+      isExported: typeAlias.isExported()
+    });
+  }
+  for (const enumDecl of sourceFile.getEnums()) {
+    types.push({
+      name: enumDecl.getName(),
+      kind: "enum",
+      definition: enumDecl.getMembers().map((m) => m.getName()).join(" | "),
+      isExported: enumDecl.isExported()
+    });
+  }
+  return types;
+}
+function formatInterfaceDefinition(iface) {
+  const parts = [];
+  const extendsClauses = iface.getExtends();
+  if (extendsClauses.length > 0) {
+    parts.push(`extends ${extendsClauses.map((e) => e.getText()).join(", ")}`);
+  }
+  const props = iface.getProperties();
+  for (const prop of props) {
+    const propType = simplifyType(prop.getType().getText());
+    parts.push(`${prop.getName()}: ${propType}`);
+  }
+  const methods = iface.getMethods();
+  for (const method of methods) {
+    const returnType = simplifyType(method.getReturnType().getText());
+    parts.push(`${method.getName()}(): ${returnType}`);
+  }
+  return parts.length > 0 ? `{ ${parts.join("; ")} }` : "{}";
+}
+function extractExports(sourceFile) {
+  const exports = [];
+  for (const exportDecl of sourceFile.getExportDeclarations()) {
+    for (const namedExport of exportDecl.getNamedExports()) {
+      exports.push(namedExport.getName());
+    }
+  }
+  for (const func of sourceFile.getFunctions()) {
+    if (func.isExported() && func.getName()) {
+      exports.push(func.getName());
+    }
+  }
+  for (const varStatement of sourceFile.getVariableStatements()) {
+    if (varStatement.isExported()) {
+      for (const decl of varStatement.getDeclarations()) {
+        exports.push(decl.getName());
+      }
+    }
+  }
+  for (const iface of sourceFile.getInterfaces()) {
+    if (iface.isExported()) {
+      exports.push(iface.getName());
+    }
+  }
+  for (const typeAlias of sourceFile.getTypeAliases()) {
+    if (typeAlias.isExported()) {
+      exports.push(typeAlias.getName());
+    }
+  }
+  for (const enumDecl of sourceFile.getEnums()) {
+    if (enumDecl.isExported()) {
+      exports.push(enumDecl.getName());
+    }
+  }
+  for (const classDecl of sourceFile.getClasses()) {
+    if (classDecl.isExported() && classDecl.getName()) {
+      exports.push(classDecl.getName());
+    }
+  }
+  return [...new Set(exports)];
+}
+
+// src/commands/context.ts
+async function context(target, options = {}) {
+  const cwd = options.cwd || process.cwd();
+  const format = options.format || "text";
+  if (!target) {
+    throw new Error("Target e obrigatorio. Exemplo: ai-tool context src/components/Button.tsx");
+  }
+  try {
+    const targetPath = findTargetFile3(target, cwd);
+    if (!targetPath) {
+      return formatNotFound3(target, cwd);
+    }
+    const project = createProject(cwd);
+    const absolutePath = resolve(cwd, targetPath);
+    const sourceFile = addSourceFile(project, absolutePath);
+    const imports = extractImports(sourceFile);
+    const functions = extractFunctions(sourceFile);
+    const types = extractTypes(sourceFile);
+    const exports = extractExports(sourceFile);
+    const result = {
+      version: "1.0.0",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      file: targetPath,
+      category: detectCategory(targetPath),
+      imports,
+      exports,
+      functions,
+      types
+    };
+    if (format === "json") {
+      return JSON.stringify(result, null, 2);
+    }
+    return formatContextText(result);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Erro ao executar context: ${message}`);
+  }
+}
+var CODE_EXTENSIONS2 = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
+function findTargetFile3(target, cwd) {
+  const normalizedTarget = target.replace(/\\/g, "/");
+  const directPath = resolve(cwd, normalizedTarget);
+  if (existsSync2(directPath) && isCodeFile2(directPath)) {
+    return normalizedTarget;
+  }
+  for (const ext of CODE_EXTENSIONS2) {
+    const withExt = directPath + ext;
+    if (existsSync2(withExt)) {
+      return normalizedTarget + ext;
+    }
+  }
+  const targetName = basename(normalizedTarget).toLowerCase();
+  const targetNameNoExt = targetName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+  const allFiles = getAllCodeFiles(cwd);
+  const matches = [];
+  for (const file of allFiles) {
+    const fileName = basename(file).toLowerCase();
+    const fileNameNoExt = fileName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+    if (fileNameNoExt === targetNameNoExt) {
+      matches.unshift(file);
+    } else if (file.toLowerCase().includes(normalizedTarget.toLowerCase())) {
+      matches.push(file);
+    }
+  }
+  if (matches.length > 0) {
+    return matches[0];
+  }
+  return null;
+}
+function isCodeFile2(filePath) {
+  const ext = extname2(filePath);
+  return CODE_EXTENSIONS2.has(ext);
+}
+function getAllCodeFiles(dir, files = [], baseDir = dir) {
+  try {
+    const entries = readdirSync2(dir);
+    for (const entry of entries) {
+      const fullPath = join2(dir, entry);
+      if (shouldIgnore(entry)) {
+        continue;
+      }
+      try {
+        const stat = statSync2(fullPath);
+        if (stat.isDirectory()) {
+          getAllCodeFiles(fullPath, files, baseDir);
+        } else if (isCodeFile2(entry)) {
+          const relativePath = fullPath.slice(baseDir.length + 1).replace(/\\/g, "/");
+          files.push(relativePath);
+        }
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return files;
+}
+function shouldIgnore(name) {
+  const ignoredDirs = [
+    "node_modules",
+    "dist",
+    "build",
+    ".git",
+    ".next",
+    ".cache",
+    "coverage",
+    ".turbo",
+    ".vercel"
+  ];
+  return ignoredDirs.includes(name) || name.startsWith(".");
+}
+function formatNotFound3(target, cwd) {
+  const normalizedTarget = target.toLowerCase();
+  const allFiles = getAllCodeFiles(cwd);
+  const similar = allFiles.filter((f) => {
+    const fileName = basename(f).toLowerCase();
+    const fileNameNoExt = fileName.replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
+    return fileName.includes(normalizedTarget) || fileNameNoExt.includes(normalizedTarget) || levenshteinDistance3(fileNameNoExt, normalizedTarget) <= 3;
+  }).slice(0, 5);
+  let out = `Arquivo nao encontrado: "${target}"
+
+`;
+  out += `Total de arquivos no projeto: ${allFiles.length}
+
+`;
+  if (similar.length > 0) {
+    out += `Arquivos com nome similar:
+`;
+    for (const s of similar) {
+      out += `   - ${s}
+`;
+    }
+    out += `
+`;
+  }
+  out += `Dicas:
+`;
+  out += `   - Use o caminho relativo: src/components/Header.tsx
+`;
+  out += `   - Ou apenas o nome do arquivo: Header
+`;
+  out += `   - Verifique se o arquivo existe e e um arquivo .ts/.tsx/.js/.jsx
+`;
+  return out;
+}
+function levenshteinDistance3(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,
+          matrix[i][j - 1] + 1,
+          matrix[i - 1][j] + 1
+        );
+      }
+    }
+  }
+  return matrix[b.length][a.length];
+}
+
 // src/index.ts
-var VERSION = "0.2.0";
+var VERSION = "0.3.1";
 
 export {
   detectCategory,
@@ -1025,5 +1846,7 @@ export {
   dead,
   deadFix,
   impact,
+  suggest,
+  context,
   VERSION
 };