@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/descubrimiento/mcp.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Servidores MCP que otras herramientas ya han configurado en este proyecto
+ * (o para este usuario), leídos de sus propios ficheros de config.
+ *
+ * La decisión que no es obvia: un servidor `stdio` se LISTA, nunca se lanza.
+ * `core/mcp/client.ts` solo habla Streamable HTTP a propósito — lanzar un
+ * proceso arbitrario que otra herramienta dejó apuntado en un JSON es
+ * superficie de ejecución que no se abre por defecto. Así que aquí no hay
+ * "activar": hay "encontrado y soportado" frente a "encontrado y no
+ * soportado, y por qué".
+ *
+ * Cada fichero mirado se anota exista o no: es lo único que permite decir
+ * DÓNDE se ha buscado en un proyecto vacío, en vez de un "nada" mudo.
+ */
+export type NivelConfigMcp = "usuario" | "proyecto";
+export interface ServidorMcpDescubierto {
+    /** De qué herramienta viene la config. */
+    origen: string;
+    /** Ruta absoluta al fichero de config. */
+    ruta: string;
+    nivel: NivelConfigMcp;
+    nombre: string;
+    transporte: "http" | "stdio";
+    url?: string;
+    comando?: string;
+    /** true solo si Ada puede hablar con él de verdad (HTTP y no desactivado). */
+    soportado: boolean;
+    /** Por qué no está soportado. Ausente cuando `soportado` es true. */
+    motivo?: string;
+}
+export interface ResultadoDescubrimientoMcp {
+    servidores: ServidorMcpDescubierto[];
+    /** Todos los ficheros mirados, existan o no. */
+    ficherosMirados: string[];
+    /** Ficheros o entradas que existían pero no se pudieron leer/interpretar. */
+    errores: Array<{
+        ruta: string;
+        motivo: string;
+    }>;
+}
+export declare function descubrirServidoresMcp(cwd: string, home?: string): ResultadoDescubrimientoMcp;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/core/descubrimiento/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/core/descubrimiento/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACtC,2CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,uEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IAC1C,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,gDAAgD;IAChD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,8EAA6E;IAC7E,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAqDD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,0BAA0B,CAiFxG","sourcesContent":["/**\n * Servidores MCP que otras herramientas ya han configurado en este proyecto\n * (o para este usuario), leídos de sus propios ficheros de config.\n *\n * La decisión que no es obvia: un servidor `stdio` se LISTA, nunca se lanza.\n * `core/mcp/client.ts` solo habla Streamable HTTP a propósito — lanzar un\n * proceso arbitrario que otra herramienta dejó apuntado en un JSON es\n * superficie de ejecución que no se abre por defecto. Así que aquí no hay\n * \"activar\": hay \"encontrado y soportado\" frente a \"encontrado y no\n * soportado, y por qué\".\n *\n * Cada fichero mirado se anota exista o no: es lo único que permite decir\n * DÓNDE se ha buscado en un proyecto vacío, en vez de un \"nada\" mudo.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join, resolve } from \"node:path\";\n\nexport type NivelConfigMcp = \"usuario\" | \"proyecto\";\n\nexport interface ServidorMcpDescubierto {\n\t/** De qué herramienta viene la config. */\n\torigen: string;\n\t/** Ruta absoluta al fichero de config. */\n\truta: string;\n\tnivel: NivelConfigMcp;\n\tnombre: string;\n\ttransporte: \"http\" | \"stdio\";\n\turl?: string;\n\tcomando?: string;\n\t/** true solo si Ada puede hablar con él de verdad (HTTP y no desactivado). */\n\tsoportado: boolean;\n\t/** Por qué no está soportado. Ausente cuando `soportado` es true. */\n\tmotivo?: string;\n}\n\nexport interface ResultadoDescubrimientoMcp {\n\tservidores: ServidorMcpDescubierto[];\n\t/** Todos los ficheros mirados, existan o no. */\n\tficherosMirados: string[];\n\t/** Ficheros o entradas que existían pero no se pudieron leer/interpretar. */\n\terrores: Array<{ ruta: string; motivo: string }>;\n}\n\ninterface FuenteMcp {\n\torigen: string;\n\trelativa: string;\n\tbase: \"proyecto\" | \"usuario\";\n\t/**\n\t * \"plano\": {mcpServers:{...}} en la raíz (Cursor, Claude Code, Gemini CLI,\n\t * .mcp.json). \"vscode\": {servers:{...}} en la raíz — VS Code NO anida bajo\n\t * \"mcp\" en `.vscode/mcp.json`; eso solo pasa en su settings.json de\n\t * usuario, que aquí no se lee. \"claude-proyecto\": servidores que Claude\n\t * Code guarda para ESTE proyecto dentro de `~/.claude.json`, en\n\t * `projects[cwd].mcpServers` — el caso más común en la práctica (MCP\n\t * añadido con `claude mcp add` sin `--scope user`), y el que un `mcpServers`\n\t * de nivel superior nunca ve.\n\t */\n\tformato: \"plano\" | \"vscode\" | \"claude-proyecto\";\n}\n\n/**\n * Dónde mira cada herramienta, tomado de sus propios adaptadores\n * (oh-my-pi: claude.ts, cursor.ts, vscode.ts, gemini.ts, mcp-json.ts).\n *\n * `.claude/mcp.json` NO es un fichero real de Claude Code (fue una feature\n * request rechazada, anthropics/claude-code#5350) — se quitó de aquí porque\n * \"mirado en\" no puede incluir un sitio que la herramienta real nunca escribe.\n */\nconst FUENTES: FuenteMcp[] = [\n\t{ origen: \"MCP (raíz del proyecto)\", relativa: \".mcp.json\", base: \"proyecto\", formato: \"plano\" },\n\t{ origen: \"Cursor\", relativa: \".cursor/mcp.json\", base: \"proyecto\", formato: \"plano\" },\n\t{ origen: \"VS Code\", relativa: \".vscode/mcp.json\", base: \"proyecto\", formato: \"vscode\" },\n\t{ origen: \"Gemini CLI\", relativa: \".gemini/settings.json\", base: \"proyecto\", formato: \"plano\" },\n\t{ origen: \"Claude Code\", relativa: \".claude.json\", base: \"usuario\", formato: \"plano\" },\n\t{ origen: \"Claude Code (proyecto)\", relativa: \".claude.json\", base: \"usuario\", formato: \"claude-proyecto\" },\n\t{ origen: \"Cursor\", relativa: \".cursor/mcp.json\", base: \"usuario\", formato: \"plano\" },\n];\n\nfunction serversDe(json: unknown, formato: FuenteMcp[\"formato\"], cwd: string): Record<string, unknown> | null {\n\tif (!json || typeof json !== \"object\") return null;\n\tif (formato === \"claude-proyecto\") {\n\t\tconst projects = (json as Record<string, unknown>).projects;\n\t\tif (!projects || typeof projects !== \"object\") return null;\n\t\tconst clave = resolve(cwd);\n\t\tconst proyecto = (projects as Record<string, unknown>)[clave] ?? (projects as Record<string, unknown>)[cwd];\n\t\tif (!proyecto || typeof proyecto !== \"object\") return null;\n\t\tconst servers = (proyecto as Record<string, unknown>).mcpServers;\n\t\treturn servers && typeof servers === \"object\" ? (servers as Record<string, unknown>) : null;\n\t}\n\tconst clave = formato === \"vscode\" ? \"servers\" : \"mcpServers\";\n\tconst servers = (json as Record<string, unknown>)[clave];\n\treturn servers && typeof servers === \"object\" ? (servers as Record<string, unknown>) : null;\n}\n\nexport function descubrirServidoresMcp(cwd: string, home: string = homedir()): ResultadoDescubrimientoMcp {\n\tconst servidores: ServidorMcpDescubierto[] = [];\n\tconst ficherosMirados: string[] = [];\n\tconst errores: Array<{ ruta: string; motivo: string }> = [];\n\n\tfor (const fuente of FUENTES) {\n\t\tconst absoluta = join(fuente.base === \"usuario\" ? home : cwd, fuente.relativa);\n\t\t// Un mismo fichero puede aparecer en dos fuentes (p.ej. `.claude.json`\n\t\t// para el scope de usuario y para el de proyecto): se mira una vez, se\n\t\t// anota una vez.\n\t\tif (!ficherosMirados.includes(absoluta)) ficherosMirados.push(absoluta);\n\t\tif (!existsSync(absoluta)) continue;\n\n\t\tlet contenido: string;\n\t\ttry {\n\t\t\tcontenido = readFileSync(absoluta, \"utf-8\");\n\t\t} catch (error) {\n\t\t\terrores.push({ ruta: absoluta, motivo: error instanceof Error ? error.message : \"no se pudo leer\" });\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet json: unknown;\n\t\ttry {\n\t\t\tjson = JSON.parse(contenido);\n\t\t} catch {\n\t\t\terrores.push({ ruta: absoluta, motivo: \"JSON inválido\" });\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst servers = serversDe(json, fuente.formato, cwd);\n\t\t// Fichero válido sin mcpServers: no hay nada que listar, no es un fallo.\n\t\tif (!servers) continue;\n\n\t\tfor (const [nombre, raw] of Object.entries(servers)) {\n\t\t\tif (!raw || typeof raw !== \"object\") {\n\t\t\t\terrores.push({ ruta: absoluta, motivo: `servidor '${nombre}': configuración inválida` });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst config = raw as Record<string, unknown>;\n\t\t\t// Gemini CLI usa `httpUrl` (no `url`) para transporte HTTP — ver\n\t\t\t// docs/tools/mcp-server.md de google-gemini/gemini-cli.\n\t\t\tconst url =\n\t\t\t\ttypeof config.url === \"string\"\n\t\t\t\t\t? config.url\n\t\t\t\t\t: typeof config.httpUrl === \"string\"\n\t\t\t\t\t\t? config.httpUrl\n\t\t\t\t\t\t: undefined;\n\t\t\tconst comando = typeof config.command === \"string\" ? config.command : undefined;\n\n\t\t\tif (!url && !comando) {\n\t\t\t\terrores.push({ ruta: absoluta, motivo: `servidor '${nombre}': sin 'url' ni 'command'` });\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst transporte: \"http\" | \"stdio\" = url ? \"http\" : \"stdio\";\n\t\t\tconst desactivado = config.enabled === false;\n\t\t\tconst soportado = transporte === \"http\" && !desactivado;\n\t\t\tconst motivo = desactivado\n\t\t\t\t? \"desactivado en su propia configuración (enabled: false)\"\n\t\t\t\t: transporte === \"stdio\"\n\t\t\t\t\t? \"servidor stdio: el cliente MCP de Ada solo habla HTTP a propósito (core/mcp/client.ts)\"\n\t\t\t\t\t: undefined;\n\n\t\t\tservidores.push({\n\t\t\t\torigen: fuente.origen,\n\t\t\t\truta: absoluta,\n\t\t\t\t// `claude-proyecto` vive físicamente en el fichero de usuario, pero\n\t\t\t\t// es config de ESTE proyecto — el nivel que importa para quien lee\n\t\t\t\t// la salida es el lógico, no dónde Claude Code decidió guardarlo.\n\t\t\t\tnivel: fuente.formato === \"claude-proyecto\" ? \"proyecto\" : fuente.base,\n\t\t\t\tnombre,\n\t\t\t\ttransporte,\n\t\t\t\turl,\n\t\t\t\tcomando,\n\t\t\t\tsoportado,\n\t\t\t\tmotivo,\n\t\t\t});\n\t\t}\n\t}\n\n\treturn { servidores, ficherosMirados, errores };\n}\n"]}

package/dist/core/descubrimiento/mcp.js

@@ -0,0 +1,130 @@
+/**
+ * Servidores MCP que otras herramientas ya han configurado en este proyecto
+ * (o para este usuario), leídos de sus propios ficheros de config.
+ *
+ * La decisión que no es obvia: un servidor `stdio` se LISTA, nunca se lanza.
+ * `core/mcp/client.ts` solo habla Streamable HTTP a propósito — lanzar un
+ * proceso arbitrario que otra herramienta dejó apuntado en un JSON es
+ * superficie de ejecución que no se abre por defecto. Así que aquí no hay
+ * "activar": hay "encontrado y soportado" frente a "encontrado y no
+ * soportado, y por qué".
+ *
+ * Cada fichero mirado se anota exista o no: es lo único que permite decir
+ * DÓNDE se ha buscado en un proyecto vacío, en vez de un "nada" mudo.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+/**
+ * Dónde mira cada herramienta, tomado de sus propios adaptadores
+ * (oh-my-pi: claude.ts, cursor.ts, vscode.ts, gemini.ts, mcp-json.ts).
+ *
+ * `.claude/mcp.json` NO es un fichero real de Claude Code (fue una feature
+ * request rechazada, anthropics/claude-code#5350) — se quitó de aquí porque
+ * "mirado en" no puede incluir un sitio que la herramienta real nunca escribe.
+ */
+const FUENTES = [
+    { origen: "MCP (raíz del proyecto)", relativa: ".mcp.json", base: "proyecto", formato: "plano" },
+    { origen: "Cursor", relativa: ".cursor/mcp.json", base: "proyecto", formato: "plano" },
+    { origen: "VS Code", relativa: ".vscode/mcp.json", base: "proyecto", formato: "vscode" },
+    { origen: "Gemini CLI", relativa: ".gemini/settings.json", base: "proyecto", formato: "plano" },
+    { origen: "Claude Code", relativa: ".claude.json", base: "usuario", formato: "plano" },
+    { origen: "Claude Code (proyecto)", relativa: ".claude.json", base: "usuario", formato: "claude-proyecto" },
+    { origen: "Cursor", relativa: ".cursor/mcp.json", base: "usuario", formato: "plano" },
+];
+function serversDe(json, formato, cwd) {
+    if (!json || typeof json !== "object")
+        return null;
+    if (formato === "claude-proyecto") {
+        const projects = json.projects;
+        if (!projects || typeof projects !== "object")
+            return null;
+        const clave = resolve(cwd);
+        const proyecto = projects[clave] ?? projects[cwd];
+        if (!proyecto || typeof proyecto !== "object")
+            return null;
+        const servers = proyecto.mcpServers;
+        return servers && typeof servers === "object" ? servers : null;
+    }
+    const clave = formato === "vscode" ? "servers" : "mcpServers";
+    const servers = json[clave];
+    return servers && typeof servers === "object" ? servers : null;
+}
+export function descubrirServidoresMcp(cwd, home = homedir()) {
+    const servidores = [];
+    const ficherosMirados = [];
+    const errores = [];
+    for (const fuente of FUENTES) {
+        const absoluta = join(fuente.base === "usuario" ? home : cwd, fuente.relativa);
+        // Un mismo fichero puede aparecer en dos fuentes (p.ej. `.claude.json`
+        // para el scope de usuario y para el de proyecto): se mira una vez, se
+        // anota una vez.
+        if (!ficherosMirados.includes(absoluta))
+            ficherosMirados.push(absoluta);
+        if (!existsSync(absoluta))
+            continue;
+        let contenido;
+        try {
+            contenido = readFileSync(absoluta, "utf-8");
+        }
+        catch (error) {
+            errores.push({ ruta: absoluta, motivo: error instanceof Error ? error.message : "no se pudo leer" });
+            continue;
+        }
+        let json;
+        try {
+            json = JSON.parse(contenido);
+        }
+        catch {
+            errores.push({ ruta: absoluta, motivo: "JSON inválido" });
+            continue;
+        }
+        const servers = serversDe(json, fuente.formato, cwd);
+        // Fichero válido sin mcpServers: no hay nada que listar, no es un fallo.
+        if (!servers)
+            continue;
+        for (const [nombre, raw] of Object.entries(servers)) {
+            if (!raw || typeof raw !== "object") {
+                errores.push({ ruta: absoluta, motivo: `servidor '${nombre}': configuración inválida` });
+                continue;
+            }
+            const config = raw;
+            // Gemini CLI usa `httpUrl` (no `url`) para transporte HTTP — ver
+            // docs/tools/mcp-server.md de google-gemini/gemini-cli.
+            const url = typeof config.url === "string"
+                ? config.url
+                : typeof config.httpUrl === "string"
+                    ? config.httpUrl
+                    : undefined;
+            const comando = typeof config.command === "string" ? config.command : undefined;
+            if (!url && !comando) {
+                errores.push({ ruta: absoluta, motivo: `servidor '${nombre}': sin 'url' ni 'command'` });
+                continue;
+            }
+            const transporte = url ? "http" : "stdio";
+            const desactivado = config.enabled === false;
+            const soportado = transporte === "http" && !desactivado;
+            const motivo = desactivado
+                ? "desactivado en su propia configuración (enabled: false)"
+                : transporte === "stdio"
+                    ? "servidor stdio: el cliente MCP de Ada solo habla HTTP a propósito (core/mcp/client.ts)"
+                    : undefined;
+            servidores.push({
+                origen: fuente.origen,
+                ruta: absoluta,
+                // `claude-proyecto` vive físicamente en el fichero de usuario, pero
+                // es config de ESTE proyecto — el nivel que importa para quien lee
+                // la salida es el lógico, no dónde Claude Code decidió guardarlo.
+                nivel: fuente.formato === "claude-proyecto" ? "proyecto" : fuente.base,
+                nombre,
+                transporte,
+                url,
+                comando,
+                soportado,
+                motivo,
+            });
+        }
+    }
+    return { servidores, ficherosMirados, errores };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/core/descubrimiento/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/core/descubrimiento/mcp.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Servidores MCP que otras herramientas ya han configurado en este proyecto\n * (o para este usuario), leídos de sus propios ficheros de config.\n *\n * La decisión que no es obvia: un servidor `stdio` se LISTA, nunca se lanza.\n * `core/mcp/client.ts` solo habla Streamable HTTP a propósito — lanzar un\n * proceso arbitrario que otra herramienta dejó apuntado en un JSON es\n * superficie de ejecución que no se abre por defecto. Así que aquí no hay\n * \"activar\": hay \"encontrado y soportado\" frente a \"encontrado y no\n * soportado, y por qué\".\n *\n * Cada fichero mirado se anota exista o no: es lo único que permite decir\n * DÓNDE se ha buscado en un proyecto vacío, en vez de un \"nada\" mudo.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join, resolve } from \"node:path\";\n\nexport type NivelConfigMcp = \"usuario\" | \"proyecto\";\n\nexport interface ServidorMcpDescubierto {\n\t/** De qué herramienta viene la config. */\n\torigen: string;\n\t/** Ruta absoluta al fichero de config. */\n\truta: string;\n\tnivel: NivelConfigMcp;\n\tnombre: string;\n\ttransporte: \"http\" | \"stdio\";\n\turl?: string;\n\tcomando?: string;\n\t/** true solo si Ada puede hablar con él de verdad (HTTP y no desactivado). */\n\tsoportado: boolean;\n\t/** Por qué no está soportado. Ausente cuando `soportado` es true. */\n\tmotivo?: string;\n}\n\nexport interface ResultadoDescubrimientoMcp {\n\tservidores: ServidorMcpDescubierto[];\n\t/** Todos los ficheros mirados, existan o no. */\n\tficherosMirados: string[];\n\t/** Ficheros o entradas que existían pero no se pudieron leer/interpretar. */\n\terrores: Array<{ ruta: string; motivo: string }>;\n}\n\ninterface FuenteMcp {\n\torigen: string;\n\trelativa: string;\n\tbase: \"proyecto\" | \"usuario\";\n\t/**\n\t * \"plano\": {mcpServers:{...}} en la raíz (Cursor, Claude Code, Gemini CLI,\n\t * .mcp.json). \"vscode\": {servers:{...}} en la raíz — VS Code NO anida bajo\n\t * \"mcp\" en `.vscode/mcp.json`; eso solo pasa en su settings.json de\n\t * usuario, que aquí no se lee. \"claude-proyecto\": servidores que Claude\n\t * Code guarda para ESTE proyecto dentro de `~/.claude.json`, en\n\t * `projects[cwd].mcpServers` — el caso más común en la práctica (MCP\n\t * añadido con `claude mcp add` sin `--scope user`), y el que un `mcpServers`\n\t * de nivel superior nunca ve.\n\t */\n\tformato: \"plano\" | \"vscode\" | \"claude-proyecto\";\n}\n\n/**\n * Dónde mira cada herramienta, tomado de sus propios adaptadores\n * (oh-my-pi: claude.ts, cursor.ts, vscode.ts, gemini.ts, mcp-json.ts).\n *\n * `.claude/mcp.json` NO es un fichero real de Claude Code (fue una feature\n * request rechazada, anthropics/claude-code#5350) — se quitó de aquí porque\n * \"mirado en\" no puede incluir un sitio que la herramienta real nunca escribe.\n */\nconst FUENTES: FuenteMcp[] = [\n\t{ origen: \"MCP (raíz del proyecto)\", relativa: \".mcp.json\", base: \"proyecto\", formato: \"plano\" },\n\t{ origen: \"Cursor\", relativa: \".cursor/mcp.json\", base: \"proyecto\", formato: \"plano\" },\n\t{ origen: \"VS Code\", relativa: \".vscode/mcp.json\", base: \"proyecto\", formato: \"vscode\" },\n\t{ origen: \"Gemini CLI\", relativa: \".gemini/settings.json\", base: \"proyecto\", formato: \"plano\" },\n\t{ origen: \"Claude Code\", relativa: \".claude.json\", base: \"usuario\", formato: \"plano\" },\n\t{ origen: \"Claude Code (proyecto)\", relativa: \".claude.json\", base: \"usuario\", formato: \"claude-proyecto\" },\n\t{ origen: \"Cursor\", relativa: \".cursor/mcp.json\", base: \"usuario\", formato: \"plano\" },\n];\n\nfunction serversDe(json: unknown, formato: FuenteMcp[\"formato\"], cwd: string): Record<string, unknown> | null {\n\tif (!json || typeof json !== \"object\") return null;\n\tif (formato === \"claude-proyecto\") {\n\t\tconst projects = (json as Record<string, unknown>).projects;\n\t\tif (!projects || typeof projects !== \"object\") return null;\n\t\tconst clave = resolve(cwd);\n\t\tconst proyecto = (projects as Record<string, unknown>)[clave] ?? (projects as Record<string, unknown>)[cwd];\n\t\tif (!proyecto || typeof proyecto !== \"object\") return null;\n\t\tconst servers = (proyecto as Record<string, unknown>).mcpServers;\n\t\treturn servers && typeof servers === \"object\" ? (servers as Record<string, unknown>) : null;\n\t}\n\tconst clave = formato === \"vscode\" ? \"servers\" : \"mcpServers\";\n\tconst servers = (json as Record<string, unknown>)[clave];\n\treturn servers && typeof servers === \"object\" ? (servers as Record<string, unknown>) : null;\n}\n\nexport function descubrirServidoresMcp(cwd: string, home: string = homedir()): ResultadoDescubrimientoMcp {\n\tconst servidores: ServidorMcpDescubierto[] = [];\n\tconst ficherosMirados: string[] = [];\n\tconst errores: Array<{ ruta: string; motivo: string }> = [];\n\n\tfor (const fuente of FUENTES) {\n\t\tconst absoluta = join(fuente.base === \"usuario\" ? home : cwd, fuente.relativa);\n\t\t// Un mismo fichero puede aparecer en dos fuentes (p.ej. `.claude.json`\n\t\t// para el scope de usuario y para el de proyecto): se mira una vez, se\n\t\t// anota una vez.\n\t\tif (!ficherosMirados.includes(absoluta)) ficherosMirados.push(absoluta);\n\t\tif (!existsSync(absoluta)) continue;\n\n\t\tlet contenido: string;\n\t\ttry {\n\t\t\tcontenido = readFileSync(absoluta, \"utf-8\");\n\t\t} catch (error) {\n\t\t\terrores.push({ ruta: absoluta, motivo: error instanceof Error ? error.message : \"no se pudo leer\" });\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet json: unknown;\n\t\ttry {\n\t\t\tjson = JSON.parse(contenido);\n\t\t} catch {\n\t\t\terrores.push({ ruta: absoluta, motivo: \"JSON inválido\" });\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst servers = serversDe(json, fuente.formato, cwd);\n\t\t// Fichero válido sin mcpServers: no hay nada que listar, no es un fallo.\n\t\tif (!servers) continue;\n\n\t\tfor (const [nombre, raw] of Object.entries(servers)) {\n\t\t\tif (!raw || typeof raw !== \"object\") {\n\t\t\t\terrores.push({ ruta: absoluta, motivo: `servidor '${nombre}': configuración inválida` });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst config = raw as Record<string, unknown>;\n\t\t\t// Gemini CLI usa `httpUrl` (no `url`) para transporte HTTP — ver\n\t\t\t// docs/tools/mcp-server.md de google-gemini/gemini-cli.\n\t\t\tconst url =\n\t\t\t\ttypeof config.url === \"string\"\n\t\t\t\t\t? config.url\n\t\t\t\t\t: typeof config.httpUrl === \"string\"\n\t\t\t\t\t\t? config.httpUrl\n\t\t\t\t\t\t: undefined;\n\t\t\tconst comando = typeof config.command === \"string\" ? config.command : undefined;\n\n\t\t\tif (!url && !comando) {\n\t\t\t\terrores.push({ ruta: absoluta, motivo: `servidor '${nombre}': sin 'url' ni 'command'` });\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst transporte: \"http\" | \"stdio\" = url ? \"http\" : \"stdio\";\n\t\t\tconst desactivado = config.enabled === false;\n\t\t\tconst soportado = transporte === \"http\" && !desactivado;\n\t\t\tconst motivo = desactivado\n\t\t\t\t? \"desactivado en su propia configuración (enabled: false)\"\n\t\t\t\t: transporte === \"stdio\"\n\t\t\t\t\t? \"servidor stdio: el cliente MCP de Ada solo habla HTTP a propósito (core/mcp/client.ts)\"\n\t\t\t\t\t: undefined;\n\n\t\t\tservidores.push({\n\t\t\t\torigen: fuente.origen,\n\t\t\t\truta: absoluta,\n\t\t\t\t// `claude-proyecto` vive físicamente en el fichero de usuario, pero\n\t\t\t\t// es config de ESTE proyecto — el nivel que importa para quien lee\n\t\t\t\t// la salida es el lógico, no dónde Claude Code decidió guardarlo.\n\t\t\t\tnivel: fuente.formato === \"claude-proyecto\" ? \"proyecto\" : fuente.base,\n\t\t\t\tnombre,\n\t\t\t\ttransporte,\n\t\t\t\turl,\n\t\t\t\tcomando,\n\t\t\t\tsoportado,\n\t\t\t\tmotivo,\n\t\t\t});\n\t\t}\n\t}\n\n\treturn { servidores, ficherosMirados, errores };\n}\n"]}

package/dist/core/descubrimiento/reglas.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Las reglas que el proyecto YA tiene escritas, vengan de la herramienta que
+ * vengan.
+ *
+ * Ada leía `AGENTS.md` y `CLAUDE.md`. Un repositorio real suele tener además
+ * `.cursor/rules/*.mdc`, `.clinerules`, `GEMINI.md` o
+ * `.github/copilot-instructions.md`, escritos con esfuerzo y que dicen cosas
+ * como «este proyecto usa pnpm, no npm» o «nunca toques `generated/`».
+ * Ignorarlas obliga a reescribirlas para que Ada sea útil, y esa media hora es
+ * exactamente donde se abandona una herramienta nueva.
+ *
+ * oh-my-pi tiene un `discovery/` de 8.773 líneas que lee la configuración de
+ * diez competidores: Claude, Cursor, Codex, Cline, Gemini, Windsurf, OpenCode,
+ * VS Code, GitHub Copilot y sus plugins. Esto cubre la parte que se nota el
+ * primer minuto: las REGLAS.
+ *
+ * Tres decisiones que no son obvias:
+ *
+ * - **`AGENTS.md` y `CLAUDE.md` no se tocan.** Los carga `resource-loader` con
+ *   su propia precedencia y su herencia por directorios. Duplicarlos aquí los
+ *   inyectaría dos veces.
+ * - **Se deduplica por CONTENIDO**, no por ruta. Es muy común tener el mismo
+ *   texto en `CLAUDE.md` y en `.cursorrules`: quien mantiene los dos los copia.
+ *   Inyectarlo dos veces gasta contexto y le dice al modelo, sin querer, que
+ *   esa regla importa el doble.
+ * - **Hay tope de tamaño y se dice cuando se corta.** Un `.cursor/rules/`
+ *   grande puede llevarse el contexto entero, y quedarse sin sitio para el
+ *   código es peor que perder una regla. Lo que no se hace es cortar en
+ *   silencio.
+ */
+export interface ReglaDescubierta {
+    /** De qué herramienta viene. Va en la etiqueta para que el modelo lo sepa. */
+    origen: string;
+    /** Ruta relativa al proyecto. */
+    ruta: string;
+    contenido: string;
+}
+export interface ResultadoDescubrimiento {
+    reglas: ReglaDescubierta[];
+    /** Rutas que existían y se dejaron fuera, con el motivo. Nunca se callan. */
+    omitidas: Array<{
+        ruta: string;
+        motivo: string;
+    }>;
+}
+export declare function descubrirReglas(cwd: string, opciones?: {
+    topeTotal?: number;
+}): ResultadoDescubrimiento;
+/**
+ * Las reglas en la forma que consume el prompt de sistema.
+ *
+ * La etiqueta lleva la herramienta de origen porque el modelo tiene que poder
+ * decidir cuánto pesa: una regla de `.cursor/rules` es contexto del proyecto,
+ * igual que `AGENTS.md`, pero saber de dónde sale ayuda cuando dos se
+ * contradicen — que pasa, porque cada equipo actualiza una y olvida la otra.
+ */
+export declare function comoFicherosDeContexto(cwd: string): Array<{
+    path: string;
+    content: string;
+}>;
+//# sourceMappingURL=reglas.d.ts.map

package/dist/core/descubrimiento/reglas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reglas.d.ts","sourceRoot":"","sources":["../../../src/core/descubrimiento/reglas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAMH,MAAM,WAAW,gBAAgB;IAChC,+EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CAClB;AAuDD,MAAM,WAAW,uBAAuB;IACvC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,8EAA6E;IAC7E,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,uBAAuB,CA4CvG;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAG5F","sourcesContent":["/**\n * Las reglas que el proyecto YA tiene escritas, vengan de la herramienta que\n * vengan.\n *\n * Ada leía `AGENTS.md` y `CLAUDE.md`. Un repositorio real suele tener además\n * `.cursor/rules/*.mdc`, `.clinerules`, `GEMINI.md` o\n * `.github/copilot-instructions.md`, escritos con esfuerzo y que dicen cosas\n * como «este proyecto usa pnpm, no npm» o «nunca toques `generated/`».\n * Ignorarlas obliga a reescribirlas para que Ada sea útil, y esa media hora es\n * exactamente donde se abandona una herramienta nueva.\n *\n * oh-my-pi tiene un `discovery/` de 8.773 líneas que lee la configuración de\n * diez competidores: Claude, Cursor, Codex, Cline, Gemini, Windsurf, OpenCode,\n * VS Code, GitHub Copilot y sus plugins. Esto cubre la parte que se nota el\n * primer minuto: las REGLAS.\n *\n * Tres decisiones que no son obvias:\n *\n * - **`AGENTS.md` y `CLAUDE.md` no se tocan.** Los carga `resource-loader` con\n *   su propia precedencia y su herencia por directorios. Duplicarlos aquí los\n *   inyectaría dos veces.\n * - **Se deduplica por CONTENIDO**, no por ruta. Es muy común tener el mismo\n *   texto en `CLAUDE.md` y en `.cursorrules`: quien mantiene los dos los copia.\n *   Inyectarlo dos veces gasta contexto y le dice al modelo, sin querer, que\n *   esa regla importa el doble.\n * - **Hay tope de tamaño y se dice cuando se corta.** Un `.cursor/rules/`\n *   grande puede llevarse el contexto entero, y quedarse sin sitio para el\n *   código es peor que perder una regla. Lo que no se hace es cortar en\n *   silencio.\n */\n\nimport { createHash } from \"node:crypto\";\nimport { existsSync, readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface ReglaDescubierta {\n\t/** De qué herramienta viene. Va en la etiqueta para que el modelo lo sepa. */\n\torigen: string;\n\t/** Ruta relativa al proyecto. */\n\truta: string;\n\tcontenido: string;\n}\n\n/** Presupuesto por defecto: suficiente para reglas, no para un manual. */\nconst TOPE_TOTAL = 64 * 1024;\nconst TOPE_FICHERO = 32 * 1024;\n\ninterface Fuente {\n\torigen: string;\n\t/** Fichero suelto. */\n\tfichero?: string;\n\t/** Directorio del que se leen todos los ficheros con estas extensiones. */\n\tdirectorio?: string;\n\textensiones?: string[];\n}\n\n/**\n * Dónde mira cada herramienta, tomado de sus propios adaptadores.\n *\n * No se incluyen `AGENTS.md` ni `CLAUDE.md`: de esos ya se encarga\n * `resource-loader`, con herencia por directorios.\n */\nconst FUENTES: Fuente[] = [\n\t{ origen: \"Gemini\", fichero: \"GEMINI.md\" },\n\t{ origen: \"Cursor\", fichero: \".cursorrules\" },\n\t{ origen: \"Cursor\", directorio: \".cursor/rules\", extensiones: [\".mdc\", \".md\"] },\n\t{ origen: \"Cline\", fichero: \".clinerules\" },\n\t{ origen: \"Cline\", directorio: \".clinerules\", extensiones: [\".md\"] },\n\t{ origen: \"Windsurf\", fichero: \".windsurfrules\" },\n\t{ origen: \"Windsurf\", directorio: \".windsurf/rules\", extensiones: [\".md\"] },\n\t{ origen: \"GitHub Copilot\", fichero: \".github/copilot-instructions.md\" },\n\t{ origen: \"GitHub Copilot\", directorio: \".github/instructions\", extensiones: [\".md\"] },\n];\n\nfunction leer(ruta: string): string | null {\n\ttry {\n\t\tif (!statSync(ruta).isFile()) return null;\n\t\tconst texto = readFileSync(ruta, \"utf-8\");\n\t\treturn texto.trim() === \"\" ? null : texto;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/** Los ficheros de un directorio de reglas, en orden estable. */\nfunction ficherosDe(dir: string, extensiones: string[]): string[] {\n\ttry {\n\t\tif (!statSync(dir).isDirectory()) return [];\n\t\treturn readdirSync(dir)\n\t\t\t.filter((n) => extensiones.some((e) => n.endsWith(e)))\n\t\t\t.sort();\n\t} catch {\n\t\treturn [];\n\t}\n}\n\nexport interface ResultadoDescubrimiento {\n\treglas: ReglaDescubierta[];\n\t/** Rutas que existían y se dejaron fuera, con el motivo. Nunca se callan. */\n\tomitidas: Array<{ ruta: string; motivo: string }>;\n}\n\nexport function descubrirReglas(cwd: string, opciones?: { topeTotal?: number }): ResultadoDescubrimiento {\n\tconst topeTotal = opciones?.topeTotal ?? TOPE_TOTAL;\n\tconst reglas: ReglaDescubierta[] = [];\n\tconst omitidas: Array<{ ruta: string; motivo: string }> = [];\n\tconst huellas = new Set<string>();\n\tlet gastado = 0;\n\n\tfor (const fuente of FUENTES) {\n\t\tconst rutas: string[] = [];\n\t\tif (fuente.fichero) rutas.push(fuente.fichero);\n\t\tif (fuente.directorio) {\n\t\t\tfor (const n of ficherosDe(join(cwd, fuente.directorio), fuente.extensiones ?? [\".md\"])) {\n\t\t\t\trutas.push(join(fuente.directorio, n));\n\t\t\t}\n\t\t}\n\n\t\tfor (const relativa of rutas) {\n\t\t\tconst absoluta = join(cwd, relativa);\n\t\t\tif (!existsSync(absoluta)) continue;\n\t\t\tconst contenido = leer(absoluta);\n\t\t\tif (contenido === null) continue;\n\n\t\t\tif (contenido.length > TOPE_FICHERO) {\n\t\t\t\tomitidas.push({ ruta: relativa, motivo: `pasa de ${Math.round(TOPE_FICHERO / 1024)} KB` });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\t// Por contenido, no por ruta: el mismo texto en CLAUDE.md y en\n\t\t\t// .cursorrules es lo normal cuando alguien mantiene las dos.\n\t\t\tconst huella = createHash(\"sha256\").update(contenido.trim()).digest(\"hex\");\n\t\t\tif (huellas.has(huella)) {\n\t\t\t\tomitidas.push({ ruta: relativa, motivo: \"mismo contenido que otra regla ya cargada\" });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (gastado + contenido.length > topeTotal) {\n\t\t\t\tomitidas.push({ ruta: relativa, motivo: \"no cabe en el presupuesto de contexto para reglas\" });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\thuellas.add(huella);\n\t\t\tgastado += contenido.length;\n\t\t\treglas.push({ origen: fuente.origen, ruta: relativa, contenido });\n\t\t}\n\t}\n\n\treturn { reglas, omitidas };\n}\n\n/**\n * Las reglas en la forma que consume el prompt de sistema.\n *\n * La etiqueta lleva la herramienta de origen porque el modelo tiene que poder\n * decidir cuánto pesa: una regla de `.cursor/rules` es contexto del proyecto,\n * igual que `AGENTS.md`, pero saber de dónde sale ayuda cuando dos se\n * contradicen — que pasa, porque cada equipo actualiza una y olvida la otra.\n */\nexport function comoFicherosDeContexto(cwd: string): Array<{ path: string; content: string }> {\n\tconst { reglas } = descubrirReglas(cwd);\n\treturn reglas.map((r) => ({ path: `${r.ruta} (regla de ${r.origen})`, content: r.contenido }));\n}\n"]}

package/dist/core/descubrimiento/reglas.js

@@ -0,0 +1,134 @@
+/**
+ * Las reglas que el proyecto YA tiene escritas, vengan de la herramienta que
+ * vengan.
+ *
+ * Ada leía `AGENTS.md` y `CLAUDE.md`. Un repositorio real suele tener además
+ * `.cursor/rules/*.mdc`, `.clinerules`, `GEMINI.md` o
+ * `.github/copilot-instructions.md`, escritos con esfuerzo y que dicen cosas
+ * como «este proyecto usa pnpm, no npm» o «nunca toques `generated/`».
+ * Ignorarlas obliga a reescribirlas para que Ada sea útil, y esa media hora es
+ * exactamente donde se abandona una herramienta nueva.
+ *
+ * oh-my-pi tiene un `discovery/` de 8.773 líneas que lee la configuración de
+ * diez competidores: Claude, Cursor, Codex, Cline, Gemini, Windsurf, OpenCode,
+ * VS Code, GitHub Copilot y sus plugins. Esto cubre la parte que se nota el
+ * primer minuto: las REGLAS.
+ *
+ * Tres decisiones que no son obvias:
+ *
+ * - **`AGENTS.md` y `CLAUDE.md` no se tocan.** Los carga `resource-loader` con
+ *   su propia precedencia y su herencia por directorios. Duplicarlos aquí los
+ *   inyectaría dos veces.
+ * - **Se deduplica por CONTENIDO**, no por ruta. Es muy común tener el mismo
+ *   texto en `CLAUDE.md` y en `.cursorrules`: quien mantiene los dos los copia.
+ *   Inyectarlo dos veces gasta contexto y le dice al modelo, sin querer, que
+ *   esa regla importa el doble.
+ * - **Hay tope de tamaño y se dice cuando se corta.** Un `.cursor/rules/`
+ *   grande puede llevarse el contexto entero, y quedarse sin sitio para el
+ *   código es peor que perder una regla. Lo que no se hace es cortar en
+ *   silencio.
+ */
+import { createHash } from "node:crypto";
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+/** Presupuesto por defecto: suficiente para reglas, no para un manual. */
+const TOPE_TOTAL = 64 * 1024;
+const TOPE_FICHERO = 32 * 1024;
+/**
+ * Dónde mira cada herramienta, tomado de sus propios adaptadores.
+ *
+ * No se incluyen `AGENTS.md` ni `CLAUDE.md`: de esos ya se encarga
+ * `resource-loader`, con herencia por directorios.
+ */
+const FUENTES = [
+    { origen: "Gemini", fichero: "GEMINI.md" },
+    { origen: "Cursor", fichero: ".cursorrules" },
+    { origen: "Cursor", directorio: ".cursor/rules", extensiones: [".mdc", ".md"] },
+    { origen: "Cline", fichero: ".clinerules" },
+    { origen: "Cline", directorio: ".clinerules", extensiones: [".md"] },
+    { origen: "Windsurf", fichero: ".windsurfrules" },
+    { origen: "Windsurf", directorio: ".windsurf/rules", extensiones: [".md"] },
+    { origen: "GitHub Copilot", fichero: ".github/copilot-instructions.md" },
+    { origen: "GitHub Copilot", directorio: ".github/instructions", extensiones: [".md"] },
+];
+function leer(ruta) {
+    try {
+        if (!statSync(ruta).isFile())
+            return null;
+        const texto = readFileSync(ruta, "utf-8");
+        return texto.trim() === "" ? null : texto;
+    }
+    catch {
+        return null;
+    }
+}
+/** Los ficheros de un directorio de reglas, en orden estable. */
+function ficherosDe(dir, extensiones) {
+    try {
+        if (!statSync(dir).isDirectory())
+            return [];
+        return readdirSync(dir)
+            .filter((n) => extensiones.some((e) => n.endsWith(e)))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+export function descubrirReglas(cwd, opciones) {
+    const topeTotal = opciones?.topeTotal ?? TOPE_TOTAL;
+    const reglas = [];
+    const omitidas = [];
+    const huellas = new Set();
+    let gastado = 0;
+    for (const fuente of FUENTES) {
+        const rutas = [];
+        if (fuente.fichero)
+            rutas.push(fuente.fichero);
+        if (fuente.directorio) {
+            for (const n of ficherosDe(join(cwd, fuente.directorio), fuente.extensiones ?? [".md"])) {
+                rutas.push(join(fuente.directorio, n));
+            }
+        }
+        for (const relativa of rutas) {
+            const absoluta = join(cwd, relativa);
+            if (!existsSync(absoluta))
+                continue;
+            const contenido = leer(absoluta);
+            if (contenido === null)
+                continue;
+            if (contenido.length > TOPE_FICHERO) {
+                omitidas.push({ ruta: relativa, motivo: `pasa de ${Math.round(TOPE_FICHERO / 1024)} KB` });
+                continue;
+            }
+            // Por contenido, no por ruta: el mismo texto en CLAUDE.md y en
+            // .cursorrules es lo normal cuando alguien mantiene las dos.
+            const huella = createHash("sha256").update(contenido.trim()).digest("hex");
+            if (huellas.has(huella)) {
+                omitidas.push({ ruta: relativa, motivo: "mismo contenido que otra regla ya cargada" });
+                continue;
+            }
+            if (gastado + contenido.length > topeTotal) {
+                omitidas.push({ ruta: relativa, motivo: "no cabe en el presupuesto de contexto para reglas" });
+                continue;
+            }
+            huellas.add(huella);
+            gastado += contenido.length;
+            reglas.push({ origen: fuente.origen, ruta: relativa, contenido });
+        }
+    }
+    return { reglas, omitidas };
+}
+/**
+ * Las reglas en la forma que consume el prompt de sistema.
+ *
+ * La etiqueta lleva la herramienta de origen porque el modelo tiene que poder
+ * decidir cuánto pesa: una regla de `.cursor/rules` es contexto del proyecto,
+ * igual que `AGENTS.md`, pero saber de dónde sale ayuda cuando dos se
+ * contradicen — que pasa, porque cada equipo actualiza una y olvida la otra.
+ */
+export function comoFicherosDeContexto(cwd) {
+    const { reglas } = descubrirReglas(cwd);
+    return reglas.map((r) => ({ path: `${r.ruta} (regla de ${r.origen})`, content: r.contenido }));
+}
+//# sourceMappingURL=reglas.js.map

package/dist/core/descubrimiento/reglas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reglas.js","sourceRoot":"","sources":["../../../src/core/descubrimiento/reglas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Las reglas que el proyecto YA tiene escritas, vengan de la herramienta que\n * vengan.\n *\n * Ada leía `AGENTS.md` y `CLAUDE.md`. Un repositorio real suele tener además\n * `.cursor/rules/*.mdc`, `.clinerules`, `GEMINI.md` o\n * `.github/copilot-instructions.md`, escritos con esfuerzo y que dicen cosas\n * como «este proyecto usa pnpm, no npm» o «nunca toques `generated/`».\n * Ignorarlas obliga a reescribirlas para que Ada sea útil, y esa media hora es\n * exactamente donde se abandona una herramienta nueva.\n *\n * oh-my-pi tiene un `discovery/` de 8.773 líneas que lee la configuración de\n * diez competidores: Claude, Cursor, Codex, Cline, Gemini, Windsurf, OpenCode,\n * VS Code, GitHub Copilot y sus plugins. Esto cubre la parte que se nota el\n * primer minuto: las REGLAS.\n *\n * Tres decisiones que no son obvias:\n *\n * - **`AGENTS.md` y `CLAUDE.md` no se tocan.** Los carga `resource-loader` con\n *   su propia precedencia y su herencia por directorios. Duplicarlos aquí los\n *   inyectaría dos veces.\n * - **Se deduplica por CONTENIDO**, no por ruta. Es muy común tener el mismo\n *   texto en `CLAUDE.md` y en `.cursorrules`: quien mantiene los dos los copia.\n *   Inyectarlo dos veces gasta contexto y le dice al modelo, sin querer, que\n *   esa regla importa el doble.\n * - **Hay tope de tamaño y se dice cuando se corta.** Un `.cursor/rules/`\n *   grande puede llevarse el contexto entero, y quedarse sin sitio para el\n *   código es peor que perder una regla. Lo que no se hace es cortar en\n *   silencio.\n */\n\nimport { createHash } from \"node:crypto\";\nimport { existsSync, readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface ReglaDescubierta {\n\t/** De qué herramienta viene. Va en la etiqueta para que el modelo lo sepa. */\n\torigen: string;\n\t/** Ruta relativa al proyecto. */\n\truta: string;\n\tcontenido: string;\n}\n\n/** Presupuesto por defecto: suficiente para reglas, no para un manual. */\nconst TOPE_TOTAL = 64 * 1024;\nconst TOPE_FICHERO = 32 * 1024;\n\ninterface Fuente {\n\torigen: string;\n\t/** Fichero suelto. */\n\tfichero?: string;\n\t/** Directorio del que se leen todos los ficheros con estas extensiones. */\n\tdirectorio?: string;\n\textensiones?: string[];\n}\n\n/**\n * Dónde mira cada herramienta, tomado de sus propios adaptadores.\n *\n * No se incluyen `AGENTS.md` ni `CLAUDE.md`: de esos ya se encarga\n * `resource-loader`, con herencia por directorios.\n */\nconst FUENTES: Fuente[] = [\n\t{ origen: \"Gemini\", fichero: \"GEMINI.md\" },\n\t{ origen: \"Cursor\", fichero: \".cursorrules\" },\n\t{ origen: \"Cursor\", directorio: \".cursor/rules\", extensiones: [\".mdc\", \".md\"] },\n\t{ origen: \"Cline\", fichero: \".clinerules\" },\n\t{ origen: \"Cline\", directorio: \".clinerules\", extensiones: [\".md\"] },\n\t{ origen: \"Windsurf\", fichero: \".windsurfrules\" },\n\t{ origen: \"Windsurf\", directorio: \".windsurf/rules\", extensiones: [\".md\"] },\n\t{ origen: \"GitHub Copilot\", fichero: \".github/copilot-instructions.md\" },\n\t{ origen: \"GitHub Copilot\", directorio: \".github/instructions\", extensiones: [\".md\"] },\n];\n\nfunction leer(ruta: string): string | null {\n\ttry {\n\t\tif (!statSync(ruta).isFile()) return null;\n\t\tconst texto = readFileSync(ruta, \"utf-8\");\n\t\treturn texto.trim() === \"\" ? null : texto;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/** Los ficheros de un directorio de reglas, en orden estable. */\nfunction ficherosDe(dir: string, extensiones: string[]): string[] {\n\ttry {\n\t\tif (!statSync(dir).isDirectory()) return [];\n\t\treturn readdirSync(dir)\n\t\t\t.filter((n) => extensiones.some((e) => n.endsWith(e)))\n\t\t\t.sort();\n\t} catch {\n\t\treturn [];\n\t}\n}\n\nexport interface ResultadoDescubrimiento {\n\treglas: ReglaDescubierta[];\n\t/** Rutas que existían y se dejaron fuera, con el motivo. Nunca se callan. */\n\tomitidas: Array<{ ruta: string; motivo: string }>;\n}\n\nexport function descubrirReglas(cwd: string, opciones?: { topeTotal?: number }): ResultadoDescubrimiento {\n\tconst topeTotal = opciones?.topeTotal ?? TOPE_TOTAL;\n\tconst reglas: ReglaDescubierta[] = [];\n\tconst omitidas: Array<{ ruta: string; motivo: string }> = [];\n\tconst huellas = new Set<string>();\n\tlet gastado = 0;\n\n\tfor (const fuente of FUENTES) {\n\t\tconst rutas: string[] = [];\n\t\tif (fuente.fichero) rutas.push(fuente.fichero);\n\t\tif (fuente.directorio) {\n\t\t\tfor (const n of ficherosDe(join(cwd, fuente.directorio), fuente.extensiones ?? [\".md\"])) {\n\t\t\t\trutas.push(join(fuente.directorio, n));\n\t\t\t}\n\t\t}\n\n\t\tfor (const relativa of rutas) {\n\t\t\tconst absoluta = join(cwd, relativa);\n\t\t\tif (!existsSync(absoluta)) continue;\n\t\t\tconst contenido = leer(absoluta);\n\t\t\tif (contenido === null) continue;\n\n\t\t\tif (contenido.length > TOPE_FICHERO) {\n\t\t\t\tomitidas.push({ ruta: relativa, motivo: `pasa de ${Math.round(TOPE_FICHERO / 1024)} KB` });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\t// Por contenido, no por ruta: el mismo texto en CLAUDE.md y en\n\t\t\t// .cursorrules es lo normal cuando alguien mantiene las dos.\n\t\t\tconst huella = createHash(\"sha256\").update(contenido.trim()).digest(\"hex\");\n\t\t\tif (huellas.has(huella)) {\n\t\t\t\tomitidas.push({ ruta: relativa, motivo: \"mismo contenido que otra regla ya cargada\" });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (gastado + contenido.length > topeTotal) {\n\t\t\t\tomitidas.push({ ruta: relativa, motivo: \"no cabe en el presupuesto de contexto para reglas\" });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\thuellas.add(huella);\n\t\t\tgastado += contenido.length;\n\t\t\treglas.push({ origen: fuente.origen, ruta: relativa, contenido });\n\t\t}\n\t}\n\n\treturn { reglas, omitidas };\n}\n\n/**\n * Las reglas en la forma que consume el prompt de sistema.\n *\n * La etiqueta lleva la herramienta de origen porque el modelo tiene que poder\n * decidir cuánto pesa: una regla de `.cursor/rules` es contexto del proyecto,\n * igual que `AGENTS.md`, pero saber de dónde sale ayuda cuando dos se\n * contradicen — que pasa, porque cada equipo actualiza una y olvida la otra.\n */\nexport function comoFicherosDeContexto(cwd: string): Array<{ path: string; content: string }> {\n\tconst { reglas } = descubrirReglas(cwd);\n\treturn reglas.map((r) => ({ path: `${r.ruta} (regla de ${r.origen})`, content: r.contenido }));\n}\n"]}

package/dist/core/descubrimiento/skills.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Skills que otras herramientas dejaron en el proyecto: `.claude/skills/<nombre>/SKILL.md`
+ * y `.github/skills/`.
+ *
+ * No se reimplementa el parseo de SKILL.md: `../skills.ts` ya sabe leer
+ * frontmatter, validar nombre/descripción y bajar por subdirectorios — es
+ * exactamente el mismo formato (Agent Skills).
+ *
+ * `instalarSkillsDescubiertas` es la parte que las hace disponibles DE
+ * VERDAD, no solo listadas: enlaza cada una dentro de `.ada/skills`, la
+ * carpeta de proyecto que `core/skills.ts` YA recorre sin que se le haya
+ * tocado ni una línea. Es la alternativa a pasar `additionalSkillPaths` por
+ * `agent-session-services.ts` — que también habría funcionado, pero ese
+ * fichero es de upstream y el presupuesto de sincronización ya estaba en
+ * 115/115 antes de este cambio (`./scripts/sync-ada.sh --check`). Un symlink
+ * en un directorio que Ada ya escanea consigue lo mismo por CERO hunks.
+ */
+export interface SkillDescubierta {
+    /** De qué herramienta viene. */
+    origen: string;
+    /** Ruta al SKILL.md (o al .md suelto). */
+    ruta: string;
+    /** Carpeta que contiene el SKILL.md. */
+    baseDir: string;
+    nombre: string;
+    descripcion: string;
+}
+export interface ResultadoDescubrimientoSkills {
+    skills: SkillDescubierta[];
+    /** Directorios mirados, existan o no. */
+    directoriosMirados: string[];
+    /** SKILL.md que existían pero no pasaron el parseo/validación. */
+    errores: Array<{
+        ruta: string;
+        motivo: string;
+    }>;
+}
+export declare function descubrirSkills(cwd: string): ResultadoDescubrimientoSkills;
+export interface SkillInstalada {
+    nombre: string;
+    origen: string;
+    /** El symlink creado (o ya existente) dentro de `.ada/skills`. */
+    enlace: string;
+}
+/**
+ * Enlaza cada skill descubierta dentro de `.ada/skills` para que la próxima
+ * sesión (interactiva, `serve`, `acp`...) la cargue de verdad, sin que nadie
+ * tenga que pasar `--skill` a mano.
+ *
+ * ponytail: no limpia symlinks de skills que dejaron de existir en origen.
+ * Un symlink roto no rompe nada — `core/skills.ts` ya lo salta en silencio —
+ * pero se queda ahí. Si el descuido empieza a notarse, un `discover --prune`
+ * que borre los symlinks propios (prefijo `descubierta-`) que ya no resuelven
+ * es la subida natural.
+ */
+export declare function instalarSkillsDescubiertas(cwd: string): SkillInstalada[];
+//# sourceMappingURL=skills.d.ts.map

package/dist/core/descubrimiento/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/core/descubrimiento/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,MAAM,WAAW,gBAAgB;IAChC,iCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC7C,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,yCAAyC;IACzC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,oEAAkE;IAClE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAYD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,6BAA6B,CA4B1E;AAED,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CACf;AAiCD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAiBxE","sourcesContent":["/**\n * Skills que otras herramientas dejaron en el proyecto: `.claude/skills/<nombre>/SKILL.md`\n * y `.github/skills/`.\n *\n * No se reimplementa el parseo de SKILL.md: `../skills.ts` ya sabe leer\n * frontmatter, validar nombre/descripción y bajar por subdirectorios — es\n * exactamente el mismo formato (Agent Skills).\n *\n * `instalarSkillsDescubiertas` es la parte que las hace disponibles DE\n * VERDAD, no solo listadas: enlaza cada una dentro de `.ada/skills`, la\n * carpeta de proyecto que `core/skills.ts` YA recorre sin que se le haya\n * tocado ni una línea. Es la alternativa a pasar `additionalSkillPaths` por\n * `agent-session-services.ts` — que también habría funcionado, pero ese\n * fichero es de upstream y el presupuesto de sincronización ya estaba en\n * 115/115 antes de este cambio (`./scripts/sync-ada.sh --check`). Un symlink\n * en un directorio que Ada ya escanea consigue lo mismo por CERO hunks.\n */\n\nimport { lstatSync, mkdirSync, readlinkSync, symlinkSync, unlinkSync } from \"node:fs\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { CONFIG_DIR_NAME } from \"../../config.ts\";\nimport { loadSkillsFromDir } from \"../skills.ts\";\n\nexport interface SkillDescubierta {\n\t/** De qué herramienta viene. */\n\torigen: string;\n\t/** Ruta al SKILL.md (o al .md suelto). */\n\truta: string;\n\t/** Carpeta que contiene el SKILL.md. */\n\tbaseDir: string;\n\tnombre: string;\n\tdescripcion: string;\n}\n\nexport interface ResultadoDescubrimientoSkills {\n\tskills: SkillDescubierta[];\n\t/** Directorios mirados, existan o no. */\n\tdirectoriosMirados: string[];\n\t/** SKILL.md que existían pero no pasaron el parseo/validación. */\n\terrores: Array<{ ruta: string; motivo: string }>;\n}\n\ninterface FuenteSkills {\n\torigen: string;\n\trelativa: string;\n}\n\nconst FUENTES: FuenteSkills[] = [\n\t{ origen: \"Claude Code\", relativa: \".claude/skills\" },\n\t{ origen: \"GitHub Copilot\", relativa: \".github/skills\" },\n];\n\nexport function descubrirSkills(cwd: string): ResultadoDescubrimientoSkills {\n\tconst skills: SkillDescubierta[] = [];\n\tconst directoriosMirados: string[] = [];\n\tconst errores: Array<{ ruta: string; motivo: string }> = [];\n\n\tfor (const fuente of FUENTES) {\n\t\tdirectoriosMirados.push(fuente.relativa);\n\t\tconst dir = join(cwd, fuente.relativa);\n\t\t// Directorio ausente: \"no hay\", `loadSkillsFromDir` devuelve vacío sin\n\t\t// diagnóstico. Un SKILL.md que existe pero no pasa el parseo SÍ genera uno:\n\t\t// esa es la diferencia entre \"no hay\" y \"no he podido\" que pide la regla 6.\n\t\tconst { skills: encontradas, diagnostics } = loadSkillsFromDir({ dir, source: `descubierta:${fuente.origen}` });\n\n\t\tfor (const skill of encontradas) {\n\t\t\tskills.push({\n\t\t\t\torigen: fuente.origen,\n\t\t\t\truta: skill.filePath,\n\t\t\t\tbaseDir: skill.baseDir,\n\t\t\t\tnombre: skill.name,\n\t\t\t\tdescripcion: skill.description,\n\t\t\t});\n\t\t}\n\t\tfor (const diagnostic of diagnostics) {\n\t\t\terrores.push({ ruta: diagnostic.path ?? dir, motivo: diagnostic.message });\n\t\t}\n\t}\n\n\treturn { skills, directoriosMirados, errores };\n}\n\nexport interface SkillInstalada {\n\tnombre: string;\n\torigen: string;\n\t/** El symlink creado (o ya existente) dentro de `.ada/skills`. */\n\tenlace: string;\n}\n\nfunction slugificar(texto: string): string {\n\treturn texto\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/(^-+|-+$)/g, \"\");\n}\n\n/**\n * Deja `enlace` como symlink a `destino`. Devuelve false sin tocar nada si\n * `enlace` ya existe y NO es un symlink nuestro — nunca se borra un fichero\n * real que el usuario pueda tener ahí con el mismo nombre.\n */\nfunction asegurarEnlace(destino: string, enlace: string): boolean {\n\ttry {\n\t\tconst info = lstatSync(enlace);\n\t\tif (!info.isSymbolicLink()) return false;\n\t\tif (resolve(dirname(enlace), readlinkSync(enlace)) === destino) return true; // ya estaba\n\t\tunlinkSync(enlace);\n\t} catch {\n\t\t// no existe todavía: se crea abajo\n\t}\n\ttry {\n\t\tsymlinkSync(destino, enlace, \"dir\");\n\t\treturn true;\n\t} catch {\n\t\t// sistema de ficheros sin symlinks (o sin permiso): se queda sin instalar,\n\t\t// pero sigue apareciendo en `descubrirSkills` — listada, no disponible.\n\t\treturn false;\n\t}\n}\n\n/**\n * Enlaza cada skill descubierta dentro de `.ada/skills` para que la próxima\n * sesión (interactiva, `serve`, `acp`...) la cargue de verdad, sin que nadie\n * tenga que pasar `--skill` a mano.\n *\n * ponytail: no limpia symlinks de skills que dejaron de existir en origen.\n * Un symlink roto no rompe nada — `core/skills.ts` ya lo salta en silencio —\n * pero se queda ahí. Si el descuido empieza a notarse, un `discover --prune`\n * que borre los symlinks propios (prefijo `descubierta-`) que ya no resuelven\n * es la subida natural.\n */\nexport function instalarSkillsDescubiertas(cwd: string): SkillInstalada[] {\n\tconst { skills } = descubrirSkills(cwd);\n\tif (skills.length === 0) return [];\n\n\tconst destinoBase = join(cwd, CONFIG_DIR_NAME, \"skills\");\n\tmkdirSync(destinoBase, { recursive: true });\n\n\tconst instaladas: SkillInstalada[] = [];\n\tfor (const skill of skills) {\n\t\tconst slug = `descubierta-${slugificar(skill.origen)}-${basename(skill.baseDir)}`;\n\t\tconst enlace = join(destinoBase, slug);\n\t\tconst destino = resolve(skill.baseDir);\n\t\tif (asegurarEnlace(destino, enlace)) {\n\t\t\tinstaladas.push({ nombre: skill.nombre, origen: skill.origen, enlace });\n\t\t}\n\t}\n\treturn instaladas;\n}\n"]}