@cocaxcode/ai-context-inspector 0.1.0

package/dist/chunk-6HBCUZQJ.js

@@ -0,0 +1,1565 @@
+#!/usr/bin/env node
+
+// src/scanner/mcp-configs.ts
+import { readFile } from "fs/promises";
+import { join } from "path";
+import { homedir } from "os";
+import { platform } from "process";
+var ENV_VAR_REGEX = /\$\{[^}]+\}/;
+function parseServerEntry(name, entry, source) {
+  let transport = "stdio";
+  if (entry.type === "http" || entry.type === "sse") {
+    transport = entry.type;
+  } else if (entry.url && !entry.command) {
+    transport = "http";
+  }
+  const envStr = JSON.stringify(entry.env ?? {}) + JSON.stringify(entry.args ?? []);
+  const hasEnvVars = ENV_VAR_REGEX.test(envStr);
+  return {
+    name,
+    source,
+    config: {
+      transport,
+      command: entry.command,
+      args: entry.args,
+      env: entry.env,
+      url: entry.url,
+      hasEnvVars
+    },
+    introspection: null
+  };
+}
+async function readMcpFile(filePath, source) {
+  const servers = [];
+  const warnings = [];
+  try {
+    const content = await readFile(filePath, "utf-8");
+    const parsed = JSON.parse(content);
+    const mcpServers = parsed.mcpServers ?? {};
+    for (const [name, entry] of Object.entries(mcpServers)) {
+      servers.push(parseServerEntry(name, entry, source));
+    }
+  } catch (err) {
+    const code = err.code;
+    if (code !== "ENOENT") {
+      warnings.push({
+        scanner: "mcp-configs",
+        message: `Error leyendo ${filePath}: ${err.message}`,
+        path: filePath
+      });
+    }
+  }
+  return { servers, warnings };
+}
+function getDesktopConfigPath() {
+  if (platform === "win32") {
+    return join(
+      process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"),
+      "Claude",
+      "claude_desktop_config.json"
+    );
+  }
+  if (platform === "darwin") {
+    return join(
+      homedir(),
+      "Library",
+      "Application Support",
+      "Claude",
+      "claude_desktop_config.json"
+    );
+  }
+  return join(homedir(), ".config", "claude-desktop", "claude_desktop_config.json");
+}
+async function scanMcpConfigs(config) {
+  const allServers = [];
+  const allWarnings = [];
+  const project = await readMcpFile(join(config.dir, ".mcp.json"), "project");
+  allServers.push(...project.servers);
+  allWarnings.push(...project.warnings);
+  const vscode = await readMcpFile(join(config.dir, ".vscode", "mcp.json"), "vscode");
+  allServers.push(...vscode.servers);
+  allWarnings.push(...vscode.warnings);
+  if (config.includeUser) {
+    const user = await readMcpFile(join(homedir(), ".claude.json"), "user");
+    allServers.push(...user.servers);
+    allWarnings.push(...user.warnings);
+    const desktop = await readMcpFile(getDesktopConfigPath(), "desktop");
+    allServers.push(...desktop.servers);
+    allWarnings.push(...desktop.warnings);
+  }
+  return { servers: allServers, warnings: allWarnings };
+}
+
+// src/scanner/mcp-introspect.ts
+async function introspectOne(server, timeout) {
+  if (server.config.transport !== "stdio" || !server.config.command) {
+    return {
+      status: "error",
+      error: `Transport "${server.config.transport}" no soportado para introspecci\xF3n (solo stdio en MVP)`,
+      tools: [],
+      resources: [],
+      prompts: []
+    };
+  }
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout);
+  try {
+    const { Client } = await import("@modelcontextprotocol/sdk/client/index.js");
+    const { StdioClientTransport } = await import("@modelcontextprotocol/sdk/client/stdio.js");
+    const transport = new StdioClientTransport({
+      command: server.config.command,
+      args: server.config.args,
+      env: server.config.env ? { ...process.env, ...server.config.env } : void 0
+    });
+    const client = new Client(
+      { name: "ai-context-inspector", version: "0.1.0" }
+    );
+    controller.signal.addEventListener("abort", () => {
+      transport.close().catch(() => {
+      });
+    });
+    await client.connect(transport);
+    const serverInfo = client.getServerVersion();
+    const capabilities = client.getServerCapabilities();
+    const instructions = client.getInstructions();
+    const tools = [];
+    let toolsCursor;
+    do {
+      const result = await client.listTools(
+        toolsCursor ? { cursor: toolsCursor } : void 0
+      );
+      for (const t of result.tools) {
+        tools.push({
+          name: t.name,
+          description: t.description,
+          inputSchema: t.inputSchema
+        });
+      }
+      toolsCursor = result.nextCursor;
+    } while (toolsCursor);
+    const resources = [];
+    try {
+      let resCursor;
+      do {
+        const result = await client.listResources(
+          resCursor ? { cursor: resCursor } : void 0
+        );
+        for (const r of result.resources) {
+          resources.push({
+            name: r.name,
+            uri: r.uri,
+            description: r.description,
+            mimeType: r.mimeType
+          });
+        }
+        resCursor = result.nextCursor;
+      } while (resCursor);
+    } catch {
+    }
+    const prompts = [];
+    try {
+      let promptCursor;
+      do {
+        const result = await client.listPrompts(
+          promptCursor ? { cursor: promptCursor } : void 0
+        );
+        for (const p of result.prompts) {
+          prompts.push({
+            name: p.name,
+            description: p.description,
+            arguments: p.arguments?.map((a) => ({
+              name: a.name,
+              description: a.description,
+              required: a.required
+            }))
+          });
+        }
+        promptCursor = result.nextCursor;
+      } while (promptCursor);
+    } catch {
+    }
+    await transport.close();
+    return {
+      status: "ok",
+      serverInfo: serverInfo ? { name: serverInfo.name, version: serverInfo.version } : void 0,
+      capabilities,
+      instructions,
+      tools,
+      resources,
+      prompts
+    };
+  } catch (err) {
+    if (controller.signal.aborted) {
+      return {
+        status: "timeout",
+        error: `Timeout despu\xE9s de ${timeout}ms`,
+        tools: [],
+        resources: [],
+        prompts: []
+      };
+    }
+    return {
+      status: "error",
+      error: err.message,
+      tools: [],
+      resources: [],
+      prompts: []
+    };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function introspectServers(servers, timeout) {
+  const stidoServers = servers.filter(
+    (s) => s.config.transport === "stdio" && s.config.command
+  );
+  const results = await Promise.allSettled(
+    stidoServers.map((s) => introspectOne(s, timeout))
+  );
+  for (let i = 0; i < stidoServers.length; i++) {
+    const result = results[i];
+    stidoServers[i].introspection = result.status === "fulfilled" ? result.value : {
+      status: "error",
+      error: result.reason?.message ?? "Error desconocido",
+      tools: [],
+      resources: [],
+      prompts: []
+    };
+  }
+}
+
+// src/scanner/index.ts
+import { readFile as readFile4 } from "fs/promises";
+import { join as join5, basename } from "path";
+import { resolve } from "path";
+
+// src/scanner/context-files.ts
+import { readFile as readFile2, stat, readdir } from "fs/promises";
+import { join as join2, relative } from "path";
+import { homedir as homedir2 } from "os";
+
+// src/scanner/catalog.ts
+var AI_FILE_CATALOG = [
+  // ── Claude ──
+  {
+    path: "CLAUDE.md",
+    tool: "claude",
+    type: "file",
+    scope: "project",
+    description: "Instrucciones de proyecto para Claude Code"
+  },
+  {
+    path: ".claude",
+    tool: "claude",
+    type: "directory",
+    scope: "project",
+    description: "Directorio de configuraci\xF3n de Claude Code"
+  },
+  {
+    path: ".mcp.json",
+    tool: "claude",
+    type: "file",
+    scope: "project",
+    description: "Configuraci\xF3n de servidores MCP del proyecto"
+  },
+  // ── Cursor ──
+  {
+    path: ".cursorrules",
+    tool: "cursor",
+    type: "file",
+    scope: "project",
+    description: "Reglas AI de Cursor (legacy)"
+  },
+  {
+    path: ".cursor/rules",
+    tool: "cursor",
+    type: "directory",
+    scope: "project",
+    description: "Directorio de reglas de Cursor (.mdc)"
+  },
+  {
+    path: ".cursorignore",
+    tool: "cursor",
+    type: "file",
+    scope: "project",
+    description: "Archivos ignorados por Cursor AI"
+  },
+  {
+    path: ".cursorindexingignore",
+    tool: "cursor",
+    type: "file",
+    scope: "project",
+    description: "Archivos excluidos del indexado de Cursor"
+  },
+  // ── Windsurf / Codeium ──
+  {
+    path: ".windsurfrules",
+    tool: "windsurf",
+    type: "file",
+    scope: "project",
+    description: "Reglas AI de Windsurf"
+  },
+  {
+    path: ".windsurf/rules",
+    tool: "windsurf",
+    type: "directory",
+    scope: "project",
+    description: "Directorio de reglas de Windsurf"
+  },
+  // ── GitHub Copilot ──
+  {
+    path: ".github/copilot-instructions.md",
+    tool: "copilot",
+    type: "file",
+    scope: "project",
+    description: "Instrucciones personalizadas de GitHub Copilot"
+  },
+  {
+    path: ".github/instructions",
+    tool: "copilot",
+    type: "directory",
+    scope: "project",
+    description: "Instrucciones por ruta de Copilot"
+  },
+  {
+    path: ".github/agents",
+    tool: "copilot",
+    type: "directory",
+    scope: "project",
+    description: "Agentes personalizados de Copilot"
+  },
+  {
+    path: ".copilotignore",
+    tool: "copilot",
+    type: "file",
+    scope: "project",
+    description: "Archivos excluidos de Copilot"
+  },
+  // ── Gemini ──
+  {
+    path: "GEMINI.md",
+    tool: "gemini",
+    type: "file",
+    scope: "project",
+    description: "Instrucciones de proyecto para Gemini CLI"
+  },
+  {
+    path: ".gemini",
+    tool: "gemini",
+    type: "directory",
+    scope: "project",
+    description: "Directorio de configuraci\xF3n de Gemini"
+  },
+  {
+    path: ".geminiignore",
+    tool: "gemini",
+    type: "file",
+    scope: "project",
+    description: "Archivos excluidos de Gemini"
+  },
+  // ── OpenAI Codex ──
+  {
+    path: "AGENTS.md",
+    tool: "codex",
+    alsoUsedBy: ["copilot", "cursor", "gemini"],
+    type: "file",
+    scope: "project",
+    description: "Instrucciones universales de agentes (multi-tool)"
+  },
+  {
+    path: "AGENT.md",
+    tool: "codex",
+    alsoUsedBy: ["gemini"],
+    type: "file",
+    scope: "project",
+    description: "Instrucciones de agente (alias)"
+  },
+  {
+    path: ".codex",
+    tool: "codex",
+    type: "directory",
+    scope: "project",
+    description: "Directorio de configuraci\xF3n de Codex"
+  },
+  // ── Aider ──
+  {
+    path: ".aider.conf.yml",
+    tool: "aider",
+    type: "file",
+    scope: "project",
+    description: "Configuraci\xF3n YAML de Aider"
+  },
+  {
+    path: ".aiderignore",
+    tool: "aider",
+    type: "file",
+    scope: "project",
+    description: "Archivos ignorados por Aider"
+  },
+  {
+    path: ".aider.model.settings.yml",
+    tool: "aider",
+    type: "file",
+    scope: "project",
+    description: "Configuraci\xF3n de modelo de Aider"
+  },
+  {
+    path: ".aider.model.metadata.json",
+    tool: "aider",
+    type: "file",
+    scope: "project",
+    description: "Metadatos de modelo de Aider"
+  },
+  // ── Cline ──
+  {
+    path: ".clinerules",
+    tool: "cline",
+    type: "file",
+    scope: "project",
+    description: "Reglas de Cline (archivo \xFAnico)"
+  },
+  {
+    path: ".clinerules",
+    tool: "cline",
+    type: "directory",
+    scope: "project",
+    description: "Directorio de reglas de Cline"
+  },
+  {
+    path: ".clineignore",
+    tool: "cline",
+    type: "file",
+    scope: "project",
+    description: "Archivos excluidos de Cline"
+  },
+  // ── Amazon Q ──
+  {
+    path: ".amazonq/rules",
+    tool: "amazonq",
+    type: "directory",
+    scope: "project",
+    description: "Directorio de reglas de Amazon Q Developer"
+  },
+  // ── Augment ──
+  {
+    path: ".augment/rules",
+    tool: "augment",
+    type: "directory",
+    scope: "project",
+    description: "Directorio de reglas de Augment Code"
+  },
+  {
+    path: ".augment-guidelines",
+    tool: "augment",
+    type: "file",
+    scope: "project",
+    description: "Directrices de Augment (legacy)"
+  },
+  // ── Replit ──
+  {
+    path: ".replit.md",
+    tool: "replit",
+    type: "file",
+    scope: "project",
+    description: "Instrucciones de Replit Agent"
+  },
+  // ── Firebase Studio ──
+  {
+    path: ".idx/airules.md",
+    tool: "firebase",
+    type: "file",
+    scope: "project",
+    description: "Reglas AI de Firebase Studio"
+  },
+  // ── VS Code ──
+  {
+    path: ".vscode/mcp.json",
+    tool: "vscode",
+    type: "file",
+    scope: "project",
+    description: "Configuraci\xF3n MCP de VS Code"
+  },
+  // ── Universal ──
+  {
+    path: "CONVENTIONS.md",
+    tool: "universal",
+    type: "file",
+    scope: "project",
+    description: "Convenciones de c\xF3digo (multi-tool)"
+  },
+  // ── User-level entries ──
+  {
+    path: "~/.claude",
+    tool: "claude",
+    type: "directory",
+    scope: "user",
+    description: "Configuraci\xF3n global de Claude Code"
+  },
+  {
+    path: "~/.claude.json",
+    tool: "claude",
+    type: "file",
+    scope: "user",
+    description: "Servidores MCP a nivel de usuario"
+  },
+  {
+    path: "~/.claude/CLAUDE.md",
+    tool: "claude",
+    type: "file",
+    scope: "user",
+    description: "Instrucciones globales de Claude Code"
+  },
+  {
+    path: "~/.gemini",
+    tool: "gemini",
+    type: "directory",
+    scope: "user",
+    description: "Configuraci\xF3n global de Gemini CLI"
+  },
+  {
+    path: "~/.gemini/GEMINI.md",
+    tool: "gemini",
+    type: "file",
+    scope: "user",
+    description: "Instrucciones globales de Gemini CLI"
+  },
+  {
+    path: "~/.codex",
+    tool: "codex",
+    type: "directory",
+    scope: "user",
+    description: "Configuraci\xF3n global de Codex CLI"
+  },
+  {
+    path: "~/.continue",
+    tool: "continue",
+    type: "directory",
+    scope: "user",
+    description: "Configuraci\xF3n global de Continue.dev"
+  },
+  {
+    path: "~/.aider.conf.yml",
+    tool: "aider",
+    type: "file",
+    scope: "user",
+    description: "Configuraci\xF3n global de Aider"
+  },
+  {
+    path: "~/.augment/rules",
+    tool: "augment",
+    type: "directory",
+    scope: "user",
+    description: "Reglas globales de Augment"
+  },
+  {
+    path: "~/.github/agents",
+    tool: "copilot",
+    type: "directory",
+    scope: "user",
+    description: "Agentes globales de Copilot"
+  },
+  {
+    path: "~/.codeium",
+    tool: "windsurf",
+    type: "directory",
+    scope: "user",
+    description: "Configuraci\xF3n global de Codeium/Windsurf"
+  }
+];
+
+// src/scanner/context-files.ts
+var PREVIEW_MAX_CHARS = 500;
+function resolveHome(p) {
+  return p.startsWith("~/") ? join2(homedir2(), p.slice(2)) : p;
+}
+async function scanDirectory(dirPath, projectDir, scope) {
+  const children = [];
+  try {
+    const entries = await readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = join2(dirPath, entry.name);
+      try {
+        const s = await stat(fullPath);
+        let preview = null;
+        if (entry.isFile()) {
+          try {
+            const content = await readFile2(fullPath, "utf-8");
+            preview = content.slice(0, PREVIEW_MAX_CHARS);
+          } catch {
+            preview = null;
+          }
+        }
+        children.push({
+          path: relative(projectDir, fullPath),
+          absolutePath: fullPath,
+          tool: "claude",
+          alsoUsedBy: [],
+          type: entry.isDirectory() ? "directory" : "file",
+          scope,
+          size: s.size,
+          preview
+        });
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return children;
+}
+async function scanContextFiles(config) {
+  const files = [];
+  const warnings = [];
+  for (const entry of AI_FILE_CATALOG) {
+    if (entry.scope === "user" && !config.includeUser) continue;
+    const resolvedPath = entry.scope === "user" ? resolveHome(entry.path) : join2(config.dir, entry.path);
+    try {
+      const s = await stat(resolvedPath);
+      const isDir = s.isDirectory();
+      if (entry.tool === "cline" && entry.path === ".clinerules") {
+        if (entry.type === "file" && isDir || entry.type === "directory" && !isDir) {
+          continue;
+        }
+      } else if (entry.type === "file" && isDir) {
+        continue;
+      } else if (entry.type === "directory" && !isDir) {
+        continue;
+      }
+      let preview = null;
+      let children;
+      if (isDir) {
+        children = await scanDirectory(resolvedPath, config.dir, entry.scope);
+      } else {
+        try {
+          const content = await readFile2(resolvedPath, "utf-8");
+          preview = content.slice(0, PREVIEW_MAX_CHARS);
+        } catch {
+          preview = null;
+        }
+      }
+      const result = {
+        path: entry.scope === "user" ? entry.path : relative(config.dir, resolvedPath),
+        absolutePath: resolvedPath,
+        tool: entry.tool,
+        alsoUsedBy: entry.alsoUsedBy ?? [],
+        type: isDir ? "directory" : "file",
+        scope: entry.scope,
+        size: s.size,
+        preview,
+        children
+      };
+      files.push(result);
+    } catch (err) {
+      const code = err.code;
+      if (code === "EACCES") {
+        warnings.push({
+          scanner: "context-files",
+          message: `Permiso denegado: ${resolvedPath}`,
+          path: resolvedPath
+        });
+        files.push({
+          path: entry.scope === "user" ? entry.path : relative(config.dir, resolvedPath),
+          absolutePath: resolvedPath,
+          tool: entry.tool,
+          alsoUsedBy: entry.alsoUsedBy ?? [],
+          type: entry.type,
+          scope: entry.scope,
+          size: 0,
+          preview: null,
+          error: "EACCES"
+        });
+      }
+    }
+  }
+  return { files, warnings };
+}
+
+// src/scanner/skills.ts
+import { readFile as readFile3, readdir as readdir2, stat as stat2 } from "fs/promises";
+import { join as join3 } from "path";
+import { homedir as homedir3 } from "os";
+var SKILL_DIRS_PROJECT = [".claude/skills"];
+var SKILL_DIRS_USER = ["~/.claude/skills"];
+async function scanSkillDir(dirPath, scope) {
+  const skills = [];
+  try {
+    const entries = await readdir2(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (entry.name.startsWith("_") || entry.name.startsWith("sdd-")) continue;
+      const skillMdPath = join3(dirPath, entry.name, "SKILL.md");
+      try {
+        await stat2(skillMdPath);
+        const content = await readFile3(skillMdPath, "utf-8");
+        let description;
+        const purposeMatch = content.match(/##\s*Purpose\s*\n+(.+)/i);
+        if (purposeMatch) {
+          description = purposeMatch[1].trim().slice(0, 200);
+        }
+        const triggers = [];
+        const triggerMatch = content.match(
+          /(?:trigger|triggers?):\s*(.+)/gi
+        );
+        if (triggerMatch) {
+          for (const match of triggerMatch) {
+            const value = match.replace(/(?:trigger|triggers?):\s*/i, "").trim();
+            if (value) triggers.push(value);
+          }
+        }
+        skills.push({
+          name: entry.name,
+          path: skillMdPath,
+          scope,
+          description,
+          triggers: triggers.length > 0 ? triggers : void 0
+        });
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return skills;
+}
+async function parseSkillRegistry(registryPath) {
+  const skills = [];
+  try {
+    const content = await readFile3(registryPath, "utf-8");
+    const lines = content.split("\n");
+    let inTable = false;
+    for (const line of lines) {
+      if (line.includes("| Skill") && line.includes("Trigger")) {
+        inTable = true;
+        continue;
+      }
+      if (inTable && line.startsWith("|---")) continue;
+      if (inTable && line.startsWith("|")) {
+        const cells = line.split("|").map((c) => c.trim()).filter(Boolean);
+        if (cells.length >= 2) {
+          skills.push({
+            name: cells[0],
+            path: cells[2] ?? registryPath,
+            scope: "project",
+            triggers: cells[1] ? [cells[1]] : void 0
+          });
+        }
+      } else if (inTable) {
+        inTable = false;
+      }
+    }
+  } catch {
+  }
+  return skills;
+}
+async function scanSkills(config) {
+  const allSkills = [];
+  const warnings = [];
+  for (const dir of SKILL_DIRS_PROJECT) {
+    const fullPath = join3(config.dir, dir);
+    const found = await scanSkillDir(fullPath, "project");
+    allSkills.push(...found);
+  }
+  if (config.includeUser) {
+    for (const dir of SKILL_DIRS_USER) {
+      const fullPath = dir.startsWith("~/") ? join3(homedir3(), dir.slice(2)) : dir;
+      const found = await scanSkillDir(fullPath, "user");
+      allSkills.push(...found);
+    }
+  }
+  const registryPath = join3(config.dir, ".atl", "skill-registry.md");
+  const registrySkills = await parseSkillRegistry(registryPath);
+  const seen = new Set(allSkills.map((s) => s.name));
+  for (const rs of registrySkills) {
+    if (!seen.has(rs.name)) {
+      allSkills.push(rs);
+      seen.add(rs.name);
+    }
+  }
+  return { skills: allSkills, warnings };
+}
+
+// src/scanner/memories.ts
+import { readdir as readdir3, stat as stat3 } from "fs/promises";
+import { join as join4 } from "path";
+async function detectOpenspec(dir) {
+  const openspecDir = join4(dir, "openspec");
+  try {
+    const s = await stat3(openspecDir);
+    if (!s.isDirectory()) return null;
+    let specsCount = 0;
+    let changesCount = 0;
+    try {
+      const specsDir = join4(openspecDir, "specs");
+      const specs = await readdir3(specsDir);
+      specsCount = specs.filter((f) => !f.startsWith(".")).length;
+    } catch {
+    }
+    try {
+      const changesDir = join4(openspecDir, "changes");
+      const changes = await readdir3(changesDir);
+      changesCount = changes.filter(
+        (f) => !f.startsWith(".") && f !== "archive"
+      ).length;
+    } catch {
+    }
+    return {
+      type: "openspec",
+      path: "openspec/",
+      source: "filesystem",
+      status: "active",
+      details: { specs: specsCount, changes: changesCount }
+    };
+  } catch {
+    return null;
+  }
+}
+async function detectAtl(dir) {
+  const atlDir = join4(dir, ".atl");
+  try {
+    const s = await stat3(atlDir);
+    if (!s.isDirectory()) return null;
+    let files = [];
+    try {
+      files = await readdir3(atlDir);
+    } catch {
+    }
+    return {
+      type: "atl",
+      path: ".atl/",
+      source: "filesystem",
+      status: "active",
+      details: { files: files.length }
+    };
+  } catch {
+    return null;
+  }
+}
+function detectEngram(mcpServers) {
+  const engram = mcpServers.find(
+    (s) => s.name.toLowerCase().includes("engram") || s.config.command && s.config.command.includes("engram") || s.config.args && s.config.args.some((a) => a.toLowerCase().includes("engram"))
+  );
+  if (!engram) return null;
+  return {
+    type: "engram",
+    source: "mcp",
+    status: "configured",
+    details: { server: engram.name }
+  };
+}
+async function scanMemories(config, mcpServers) {
+  const memories = [];
+  const warnings = [];
+  const openspec = await detectOpenspec(config.dir);
+  if (openspec) memories.push(openspec);
+  const atl = await detectAtl(config.dir);
+  if (atl) memories.push(atl);
+  const engram = detectEngram(mcpServers);
+  if (engram) memories.push(engram);
+  return { memories, warnings };
+}
+
+// src/scanner/index.ts
+async function detectProjectName(dir) {
+  try {
+    const pkg = await readFile4(join5(dir, "package.json"), "utf-8");
+    const parsed = JSON.parse(pkg);
+    if (parsed.name) return parsed.name;
+  } catch {
+  }
+  return basename(dir);
+}
+async function runAllScanners(config) {
+  const start = performance.now();
+  const warnings = [];
+  const absDir = resolve(config.dir);
+  const name = await detectProjectName(absDir);
+  const project = {
+    name,
+    path: absDir,
+    scannedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const [contextResult, mcpResult, skillsResult] = await Promise.all([
+    scanContextFiles({ ...config, dir: absDir }),
+    scanMcpConfigs({ dir: absDir, includeUser: config.includeUser }),
+    scanSkills({ ...config, dir: absDir })
+  ]);
+  warnings.push(...contextResult.warnings);
+  warnings.push(...mcpResult.warnings);
+  warnings.push(...skillsResult.warnings);
+  if (config.introspect && mcpResult.servers.length > 0) {
+    await introspectServers(mcpResult.servers, config.timeout);
+  }
+  const memoriesResult = await scanMemories(
+    { ...config, dir: absDir },
+    mcpResult.servers
+  );
+  warnings.push(...memoriesResult.warnings);
+  const scanDuration = Math.round(performance.now() - start);
+  return {
+    project,
+    contextFiles: contextResult.files,
+    mcpServers: mcpResult.servers,
+    skills: skillsResult.skills,
+    memories: memoriesResult.memories,
+    warnings,
+    scanDuration
+  };
+}
+
+// src/report/styles.ts
+var CSS_STYLES = `
+:root {
+  --bg: #0a0a0f;
+  --bg-card: #12121a;
+  --bg-card-hover: #1a1a25;
+  --border: #2a2a3a;
+  --text: #e0e0e8;
+  --text-dim: #8888a0;
+  --text-bright: #ffffff;
+  --accent: #00d4ff;
+  --accent-dim: #0099bb;
+  --green: #00e676;
+  --red: #ff5252;
+  --orange: #ffab40;
+  --purple: #b388ff;
+  --font-mono: 'JetBrains Mono', 'Fira Code', 'Cascadia Code', 'Consolas', monospace;
+  --font-sans: system-ui, -apple-system, sans-serif;
+  --radius: 8px;
+}
+
+@media (prefers-color-scheme: light) {
+  :root {
+    --bg: #f5f5f8;
+    --bg-card: #ffffff;
+    --bg-card-hover: #f0f0f5;
+    --border: #d0d0dd;
+    --text: #2a2a3a;
+    --text-dim: #666680;
+    --text-bright: #000000;
+    --accent: #0088cc;
+    --accent-dim: #006699;
+  }
+}
+
+* { margin: 0; padding: 0; box-sizing: border-box; }
+
+body {
+  background: var(--bg);
+  color: var(--text);
+  font-family: var(--font-sans);
+  line-height: 1.6;
+  min-height: 100vh;
+}
+
+.container {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 2rem;
+}
+
+/* \u2500\u2500 Header \u2500\u2500 */
+.header {
+  text-align: center;
+  padding: 2rem 0 1.5rem;
+  border-bottom: 1px solid var(--border);
+  margin-bottom: 1.5rem;
+}
+
+.header h1 {
+  font-family: var(--font-mono);
+  font-size: 1.5rem;
+  color: var(--accent);
+  margin-bottom: 0.5rem;
+}
+
+.header .subtitle {
+  color: var(--text-dim);
+  font-size: 0.85rem;
+}
+
+.badges {
+  display: flex;
+  gap: 0.75rem;
+  justify-content: center;
+  flex-wrap: wrap;
+  margin-top: 1rem;
+}
+
+.badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4rem;
+  padding: 0.3rem 0.8rem;
+  border-radius: 20px;
+  font-size: 0.8rem;
+  font-weight: 600;
+  font-family: var(--font-mono);
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+}
+
+.badge--accent { border-color: var(--accent); color: var(--accent); }
+.badge--green { border-color: var(--green); color: var(--green); }
+.badge--purple { border-color: var(--purple); color: var(--purple); }
+.badge--orange { border-color: var(--orange); color: var(--orange); }
+
+/* \u2500\u2500 Search \u2500\u2500 */
+.search-bar {
+  position: sticky;
+  top: 0;
+  z-index: 10;
+  background: var(--bg);
+  padding: 0.75rem 0;
+  margin-bottom: 1rem;
+}
+
+.search-bar input {
+  width: 100%;
+  padding: 0.6rem 1rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--bg-card);
+  color: var(--text);
+  font-family: var(--font-mono);
+  font-size: 0.85rem;
+  outline: none;
+  transition: border-color 0.2s;
+}
+
+.search-bar input:focus {
+  border-color: var(--accent);
+}
+
+/* \u2500\u2500 Sections \u2500\u2500 */
+.section {
+  margin-bottom: 1.5rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  overflow: hidden;
+}
+
+.section-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.75rem 1rem;
+  background: var(--bg-card);
+  cursor: pointer;
+  user-select: none;
+  transition: background 0.2s;
+}
+
+.section-header:hover {
+  background: var(--bg-card-hover);
+}
+
+.section-header h2 {
+  font-size: 1rem;
+  font-family: var(--font-mono);
+  color: var(--text-bright);
+}
+
+.section-header .count {
+  font-size: 0.8rem;
+  color: var(--text-dim);
+  font-family: var(--font-mono);
+}
+
+.section-header .arrow {
+  transition: transform 0.2s;
+  color: var(--text-dim);
+}
+
+.section.collapsed .section-content {
+  display: none;
+}
+
+.section.collapsed .arrow {
+  transform: rotate(-90deg);
+}
+
+.section-content {
+  padding: 1rem;
+  border-top: 1px solid var(--border);
+}
+
+/* \u2500\u2500 Cards \u2500\u2500 */
+.card {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 1rem;
+  margin-bottom: 0.75rem;
+  transition: border-color 0.2s;
+}
+
+.card:hover {
+  border-color: var(--accent-dim);
+}
+
+.card:last-child {
+  margin-bottom: 0;
+}
+
+.card-title {
+  font-family: var(--font-mono);
+  font-size: 0.9rem;
+  color: var(--accent);
+  margin-bottom: 0.5rem;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.card-meta {
+  font-size: 0.75rem;
+  color: var(--text-dim);
+  margin-bottom: 0.5rem;
+}
+
+/* \u2500\u2500 Tool badges \u2500\u2500 */
+.tool-badge {
+  display: inline-block;
+  padding: 0.15rem 0.5rem;
+  border-radius: 4px;
+  font-size: 0.7rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.tool-badge--claude { background: #d4760020; color: #d47600; border: 1px solid #d4760040; }
+.tool-badge--cursor { background: #00a2ff20; color: #00a2ff; border: 1px solid #00a2ff40; }
+.tool-badge--windsurf { background: #00c48020; color: #00c480; border: 1px solid #00c48040; }
+.tool-badge--copilot { background: #8b5cf620; color: #8b5cf6; border: 1px solid #8b5cf640; }
+.tool-badge--gemini { background: #4285f420; color: #4285f4; border: 1px solid #4285f440; }
+.tool-badge--codex { background: #10a37f20; color: #10a37f; border: 1px solid #10a37f40; }
+.tool-badge--aider { background: #ff6b6b20; color: #ff6b6b; border: 1px solid #ff6b6b40; }
+.tool-badge--cline { background: #e91e6320; color: #e91e63; border: 1px solid #e91e6340; }
+.tool-badge--continue { background: #ff980020; color: #ff9800; border: 1px solid #ff980040; }
+.tool-badge--amazonq { background: #ff990020; color: #ff9900; border: 1px solid #ff990040; }
+.tool-badge--augment { background: #9c27b020; color: #9c27b0; border: 1px solid #9c27b040; }
+.tool-badge--replit { background: #f2620020; color: #f26200; border: 1px solid #f2620040; }
+.tool-badge--firebase { background: #ffca2820; color: #ffca28; border: 1px solid #ffca2840; }
+.tool-badge--vscode { background: #007acc20; color: #007acc; border: 1px solid #007acc40; }
+.tool-badge--universal { background: #78909c20; color: #78909c; border: 1px solid #78909c40; }
+
+/* \u2500\u2500 Status \u2500\u2500 */
+.status {
+  display: inline-block;
+  padding: 0.15rem 0.5rem;
+  border-radius: 4px;
+  font-size: 0.7rem;
+  font-weight: 600;
+}
+
+.status--ok { background: #00e67620; color: var(--green); }
+.status--timeout { background: #ffab4020; color: var(--orange); }
+.status--error { background: #ff525220; color: var(--red); }
+.status--active { background: #00e67620; color: var(--green); }
+.status--configured { background: #00d4ff20; color: var(--accent); }
+
+/* \u2500\u2500 Tool list \u2500\u2500 */
+.tool-list {
+  list-style: none;
+  margin-top: 0.5rem;
+}
+
+.tool-list li {
+  padding: 0.3rem 0;
+  font-size: 0.8rem;
+  border-bottom: 1px solid var(--border);
+  display: flex;
+  gap: 0.5rem;
+}
+
+.tool-list li:last-child {
+  border-bottom: none;
+}
+
+.tool-name {
+  font-family: var(--font-mono);
+  color: var(--accent);
+  white-space: nowrap;
+}
+
+.tool-desc {
+  color: var(--text-dim);
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+/* \u2500\u2500 Preview \u2500\u2500 */
+.preview {
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  padding: 0.5rem;
+  margin-top: 0.5rem;
+  font-family: var(--font-mono);
+  font-size: 0.75rem;
+  color: var(--text-dim);
+  white-space: pre-wrap;
+  word-break: break-all;
+  max-height: 150px;
+  overflow-y: auto;
+  display: none;
+}
+
+.preview.open {
+  display: block;
+}
+
+.preview-toggle {
+  background: none;
+  border: none;
+  color: var(--accent);
+  font-size: 0.75rem;
+  cursor: pointer;
+  font-family: var(--font-mono);
+  padding: 0;
+}
+
+.preview-toggle:hover {
+  text-decoration: underline;
+}
+
+/* \u2500\u2500 Groups \u2500\u2500 */
+.tool-group {
+  margin-bottom: 1rem;
+}
+
+.tool-group:last-child {
+  margin-bottom: 0;
+}
+
+.tool-group-header {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 0.5rem;
+  padding-bottom: 0.3rem;
+  border-bottom: 1px solid var(--border);
+}
+
+/* \u2500\u2500 Empty state \u2500\u2500 */
+.empty-state {
+  text-align: center;
+  padding: 3rem;
+  color: var(--text-dim);
+}
+
+.empty-state h3 {
+  font-size: 1.1rem;
+  margin-bottom: 0.5rem;
+  color: var(--text);
+}
+
+/* \u2500\u2500 Scope badge \u2500\u2500 */
+.scope-badge {
+  font-size: 0.65rem;
+  padding: 0.1rem 0.4rem;
+  border-radius: 3px;
+  font-weight: 600;
+  text-transform: uppercase;
+}
+
+.scope-badge--project { background: var(--accent); color: var(--bg); }
+.scope-badge--user { background: var(--purple); color: var(--bg); }
+
+/* \u2500\u2500 Footer \u2500\u2500 */
+.footer {
+  text-align: center;
+  padding: 1.5rem 0;
+  margin-top: 1rem;
+  border-top: 1px solid var(--border);
+  font-size: 0.75rem;
+  color: var(--text-dim);
+  font-family: var(--font-mono);
+}
+
+/* \u2500\u2500 Responsive \u2500\u2500 */
+@media (max-width: 768px) {
+  .container { padding: 1rem; }
+  .badges { gap: 0.5rem; }
+  .badge { font-size: 0.7rem; padding: 0.2rem 0.6rem; }
+}
+`;
+
+// src/report/scripts.ts
+var JS_SCRIPTS = `
+document.addEventListener('DOMContentLoaded', () => {
+  // Section collapse/expand
+  document.querySelectorAll('.section-header').forEach(header => {
+    header.addEventListener('click', () => {
+      header.closest('.section').classList.toggle('collapsed')
+    })
+  })
+
+  // Preview toggle
+  document.querySelectorAll('.preview-toggle').forEach(btn => {
+    btn.addEventListener('click', (e) => {
+      e.stopPropagation()
+      const preview = btn.nextElementSibling
+      if (preview && preview.classList.contains('preview')) {
+        preview.classList.toggle('open')
+        btn.textContent = preview.classList.contains('open') ? 'Ocultar' : 'Ver contenido'
+      }
+    })
+  })
+
+  // Global search
+  const searchInput = document.getElementById('search-input')
+  if (searchInput) {
+    searchInput.addEventListener('input', (e) => {
+      const query = e.target.value.toLowerCase().trim()
+      document.querySelectorAll('[data-searchable]').forEach(el => {
+        const text = el.getAttribute('data-searchable').toLowerCase()
+        el.style.display = (!query || text.includes(query)) ? '' : 'none'
+      })
+    })
+  }
+})
+`;
+
+// src/report/sections.ts
+function esc(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function renderHeader(project, summary, scanDuration) {
+  const date = new Date(project.scannedAt).toLocaleString();
+  return `
+    <header class="header">
+      <h1>&gt; ai-context-inspector</h1>
+      <div class="subtitle">${esc(project.name)} &mdash; ${date} &mdash; ${scanDuration}ms</div>
+      <div class="badges">
+        <span class="badge badge--accent">${summary.totalMcpServers} MCPs</span>
+        <span class="badge badge--green">${summary.totalTools} tools</span>
+        <span class="badge badge--purple">${summary.totalFiles} archivos</span>
+        <span class="badge badge--orange">${summary.totalSkills} skills</span>
+        <span class="badge badge--accent">${summary.totalMemories} memorias</span>
+      </div>
+    </header>`;
+}
+function renderMcpServers(servers) {
+  if (servers.length === 0) return "";
+  const cards = servers.map((s) => {
+    const intro = s.introspection;
+    const statusClass = intro ? `status--${intro.status}` : "status--configured";
+    const statusText = intro ? intro.status === "ok" ? "OK" : intro.status === "timeout" ? "Timeout" : "Error" : "No introspectado";
+    let toolsHtml = "";
+    if (intro && intro.tools.length > 0) {
+      const items = intro.tools.map(
+        (t) => `<li data-searchable="${esc(t.name + " " + (t.description ?? ""))}"><span class="tool-name">${esc(t.name)}</span><span class="tool-desc">${esc(t.description ?? "")}</span></li>`
+      ).join("");
+      toolsHtml = `<div class="card-meta">${intro.tools.length} tools</div><ul class="tool-list">${items}</ul>`;
+    }
+    let resourcesHtml = "";
+    if (intro && intro.resources.length > 0) {
+      resourcesHtml = `<div class="card-meta" style="margin-top:0.5rem">${intro.resources.length} resources</div>`;
+    }
+    let promptsHtml = "";
+    if (intro && intro.prompts.length > 0) {
+      promptsHtml = `<div class="card-meta" style="margin-top:0.5rem">${intro.prompts.length} prompts</div>`;
+    }
+    const serverVersion = intro?.serverInfo ? ` v${esc(intro.serverInfo.version)}` : "";
+    const errorHtml = intro?.error ? `<div class="card-meta" style="color:var(--red)">${esc(intro.error)}</div>` : "";
+    const configHtml = s.config.command ? `<div class="card-meta">${esc(s.config.command)} ${esc((s.config.args ?? []).join(" "))}</div>` : s.config.url ? `<div class="card-meta">${esc(s.config.url)}</div>` : "";
+    return `
+        <div class="card" data-searchable="${esc(s.name + " " + (intro?.serverInfo?.name ?? ""))}">
+          <div class="card-title">
+            <span>${esc(s.name)}${serverVersion}</span>
+            <span class="status ${statusClass}">${statusText}</span>
+            <span class="scope-badge scope-badge--${s.source}">${s.source}</span>
+          </div>
+          ${configHtml}
+          ${errorHtml}
+          ${toolsHtml}
+          ${resourcesHtml}
+          ${promptsHtml}
+        </div>`;
+  }).join("");
+  const totalTools = servers.reduce(
+    (sum, s) => sum + (s.introspection?.tools.length ?? 0),
+    0
+  );
+  return `
+    <div class="section">
+      <div class="section-header">
+        <h2>MCP Servers</h2>
+        <div>
+          <span class="count">${servers.length} servers &middot; ${totalTools} tools</span>
+          <span class="arrow">&#9660;</span>
+        </div>
+      </div>
+      <div class="section-content">${cards}</div>
+    </div>`;
+}
+function renderContextFiles(files) {
+  if (files.length === 0) return "";
+  const groups = /* @__PURE__ */ new Map();
+  for (const f of files) {
+    const existing = groups.get(f.tool) ?? [];
+    existing.push(f);
+    groups.set(f.tool, existing);
+  }
+  let groupsHtml = "";
+  for (const [tool, toolFiles] of groups) {
+    const items = toolFiles.map((f) => {
+      const previewHtml = f.preview ? `<button class="preview-toggle">Ver contenido</button><div class="preview">${esc(f.preview)}</div>` : "";
+      const errorHtml = f.error ? `<span class="status status--error">${f.error}</span>` : "";
+      const sizeStr = f.size > 0 ? formatBytes(f.size) : "";
+      const typeIcon = f.type === "directory" ? "&#128193;" : "&#128196;";
+      const childrenHtml = f.children && f.children.length > 0 ? `<div class="card-meta" style="margin-top:0.3rem">${f.children.length} archivos dentro</div>` : "";
+      return `
+          <div class="card" data-searchable="${esc(f.path + " " + tool)}">
+            <div class="card-title">${typeIcon} ${esc(f.path)} ${errorHtml}</div>
+            <div class="card-meta">${sizeStr} &middot; <span class="scope-badge scope-badge--${f.scope}">${f.scope}</span></div>
+            ${childrenHtml}
+            ${previewHtml}
+          </div>`;
+    }).join("");
+    groupsHtml += `
+      <div class="tool-group">
+        <div class="tool-group-header">
+          <span class="tool-badge tool-badge--${tool}">${tool}</span>
+          <span class="count">${toolFiles.length} archivos</span>
+        </div>
+        ${items}
+      </div>`;
+  }
+  return `
+    <div class="section">
+      <div class="section-header">
+        <h2>Archivos de Contexto</h2>
+        <div>
+          <span class="count">${files.length} archivos &middot; ${groups.size} herramientas</span>
+          <span class="arrow">&#9660;</span>
+        </div>
+      </div>
+      <div class="section-content">${groupsHtml}</div>
+    </div>`;
+}
+function renderSkills(skills) {
+  if (skills.length === 0) return "";
+  const items = skills.map((s) => {
+    const triggersHtml = s.triggers ? `<div class="card-meta">${s.triggers.map((t) => esc(t)).join(", ")}</div>` : "";
+    return `
+        <div class="card" data-searchable="${esc(s.name + " " + (s.description ?? ""))}">
+          <div class="card-title">
+            ${esc(s.name)}
+            <span class="scope-badge scope-badge--${s.scope}">${s.scope}</span>
+          </div>
+          ${s.description ? `<div class="card-meta">${esc(s.description)}</div>` : ""}
+          ${triggersHtml}
+        </div>`;
+  }).join("");
+  return `
+    <div class="section">
+      <div class="section-header">
+        <h2>Skills</h2>
+        <div>
+          <span class="count">${skills.length}</span>
+          <span class="arrow">&#9660;</span>
+        </div>
+      </div>
+      <div class="section-content">${items}</div>
+    </div>`;
+}
+function renderMemories(memories) {
+  if (memories.length === 0) return "";
+  const items = memories.map((m) => {
+    const detailsHtml = m.details ? `<div class="card-meta">${Object.entries(m.details).map(([k, v]) => `${esc(k)}: ${esc(String(v))}`).join(" &middot; ")}</div>` : "";
+    return `
+        <div class="card" data-searchable="${esc(m.type)}">
+          <div class="card-title">
+            ${esc(m.type)}
+            <span class="status status--${m.status}">${m.status}</span>
+          </div>
+          <div class="card-meta">${m.source}${m.path ? ` &middot; ${esc(m.path)}` : ""}</div>
+          ${detailsHtml}
+        </div>`;
+  }).join("");
+  return `
+    <div class="section">
+      <div class="section-header">
+        <h2>Memorias</h2>
+        <div>
+          <span class="count">${memories.length}</span>
+          <span class="arrow">&#9660;</span>
+        </div>
+      </div>
+      <div class="section-content">${items}</div>
+    </div>`;
+}
+function renderEmptyState() {
+  return `
+    <div class="empty-state">
+      <h3>No se encontr\xF3 configuraci\xF3n AI en este proyecto</h3>
+      <p>Este proyecto no tiene archivos de configuraci\xF3n de herramientas AI.</p>
+      <p style="margin-top:1rem;font-size:0.85rem">
+        Herramientas soportadas: Claude, Cursor, Windsurf, Copilot, Gemini,
+        Codex, Aider, Cline, Continue, Amazon Q, Augment, Replit, Firebase Studio
+      </p>
+    </div>`;
+}
+
+// src/report/generator.ts
+function computeSummary(result) {
+  return {
+    totalMcpServers: result.mcpServers.length,
+    totalTools: result.mcpServers.reduce(
+      (sum, s) => sum + (s.introspection?.tools.length ?? 0),
+      0
+    ),
+    totalFiles: result.contextFiles.length,
+    totalSkills: result.skills.length,
+    totalMemories: result.memories.length
+  };
+}
+function generateHtml(result) {
+  const summary = computeSummary(result);
+  const isEmpty = summary.totalMcpServers === 0 && summary.totalFiles === 0 && summary.totalSkills === 0 && summary.totalMemories === 0;
+  const header = renderHeader(result.project, summary, result.scanDuration);
+  const content = isEmpty ? renderEmptyState() : [
+    renderMcpServers(result.mcpServers),
+    renderContextFiles(result.contextFiles),
+    renderSkills(result.skills),
+    renderMemories(result.memories)
+  ].join("");
+  return `<!DOCTYPE html>
+<html lang="es">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>AI Context Inspector \u2014 ${escHtml(result.project.name)}</title>
+  <style>${CSS_STYLES}</style>
+</head>
+<body>
+  <div class="container">
+    ${header}
+    <div class="search-bar">
+      <input type="text" id="search-input" placeholder="Buscar tools, archivos, skills..." />
+    </div>
+    ${content}
+    <footer class="footer">
+      Generado por ai-context-inspector &mdash; ${new Date(result.project.scannedAt).toLocaleString()}
+    </footer>
+  </div>
+  <script>${JS_SCRIPTS}</script>
+</body>
+</html>`;
+}
+function escHtml(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+export {
+  scanMcpConfigs,
+  introspectServers,
+  runAllScanners,
+  generateHtml
+};