@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/edicion/tipos.js

@@ -0,0 +1,160 @@
+/**
+ * ¿La edición ha introducido un error de TIPOS?
+ *
+ * `parseo.ts` responde si el fichero sigue siendo sintácticamente válido, que
+ * es el fallo más burdo. Este responde el siguiente: el fichero parsea, pero
+ * llamas a la función con un argumento de más, o le pasas una cadena donde
+ * esperaba un número. Hasta ahora eso solo salía al ejecutar `npm run check`,
+ * que el modelo no lanza solo.
+ *
+ * oh-my-pi lo resuelve con un cliente LSP (9.920 líneas) que necesita un
+ * servidor de lenguaje instalado. Aquí sale del compilador de TypeScript que ya
+ * está en el proyecto, con un `LanguageService` que mantiene el programa vivo
+ * entre ediciones. Medido sobre este repositorio (343 ficheros):
+ *
+ *     primera comprobación   2.500 ms   (una vez por proyecto, perezosa)
+ *     otro fichero              14 ms
+ *     tras cambiar el fichero  124-220 ms
+ *
+ * LA PRECONDICIÓN QUE LO HACE USABLE
+ *
+ * Solo se informa de lo que la edición ha INTRODUCIDO. Un repositorio a medio
+ * refactorizar tiene cientos de errores de tipos, y volcárselos al modelo en
+ * cada edición sería ruido puro: dejaría de leerlos el primer día y con ellos
+ * el que sí importaba. Se comparan los diagnósticos de antes y los de después,
+ * y solo viajan los nuevos.
+ *
+ * Y solo se paga cuando hace falta: si después de la edición no hay ningún
+ * diagnóstico, no se calcula el "antes". La mayoría de ediciones son correctas,
+ * así que el caso normal es una comprobación, no dos.
+ */
+import { dirname } from "node:path";
+import ts from "typescript";
+/** Extensiones que tiene sentido comprobar. */
+const COMPROBABLES = new Set([".ts", ".tsx", ".mts", ".cts"]);
+/**
+ * Tope de ficheros por proyecto.
+ *
+ * En un monorepo gigante la primera comprobación se va de las manos y el
+ * usuario nota un parón que no ha pedido. Por encima del tope se calla y lo
+ * dice — que es distinto de decir que está todo bien.
+ */
+const TOPE_FICHEROS = 5000;
+export class ComprobadorDeTipos {
+    /** Un servicio por `tsconfig`. Se reutiliza entre ediciones: es lo que hace que la segunda cueste 124 ms. */
+    proyectos = new Map();
+    descartados = new Map();
+    /** Por qué no se puede comprobar este fichero, o `null` si sí se puede. */
+    porQueNo(ruta) {
+        const punto = ruta.lastIndexOf(".");
+        if (punto === -1 || !COMPROBABLES.has(ruta.slice(punto).toLowerCase()))
+            return "extension-no-comprobable";
+        const cfg = this.buscarConfig(ruta);
+        if (!cfg)
+            return "sin-tsconfig";
+        return this.descartados.get(cfg) ?? null;
+    }
+    buscarConfig(ruta) {
+        return ts.findConfigFile(dirname(ruta), ts.sys.fileExists, "tsconfig.json");
+    }
+    proyectoDe(rutaConfig) {
+        const existente = this.proyectos.get(rutaConfig);
+        if (existente)
+            return existente;
+        if (this.descartados.has(rutaConfig))
+            return null;
+        const raiz = dirname(rutaConfig);
+        const cfg = ts.readConfigFile(rutaConfig, ts.sys.readFile);
+        if (cfg.error) {
+            this.descartados.set(rutaConfig, "sin-tsconfig");
+            return null;
+        }
+        const parsed = ts.parseJsonConfigFileContent(cfg.config, ts.sys, raiz);
+        if (parsed.fileNames.length > TOPE_FICHEROS) {
+            this.descartados.set(rutaConfig, "proyecto-demasiado-grande");
+            return null;
+        }
+        const overlay = new Map();
+        const versiones = new Map();
+        const host = {
+            getScriptFileNames: () => parsed.fileNames,
+            getScriptVersion: (f) => String(versiones.get(f) ?? 0),
+            getScriptSnapshot: (f) => {
+                const texto = overlay.get(f) ?? ts.sys.readFile(f);
+                return texto === undefined ? undefined : ts.ScriptSnapshot.fromString(texto);
+            },
+            getCurrentDirectory: () => raiz,
+            getCompilationSettings: () => parsed.options,
+            getDefaultLibFileName: (o) => ts.getDefaultLibFilePath(o),
+            fileExists: (f) => overlay.has(f) || ts.sys.fileExists(f),
+            readFile: (f) => overlay.get(f) ?? ts.sys.readFile(f),
+            readDirectory: ts.sys.readDirectory,
+            directoryExists: ts.sys.directoryExists,
+            getDirectories: ts.sys.getDirectories,
+        };
+        const proyecto = {
+            servicio: ts.createLanguageService(host, ts.createDocumentRegistry()),
+            overlay,
+            versiones,
+            raiz,
+        };
+        this.proyectos.set(rutaConfig, proyecto);
+        return proyecto;
+    }
+    /** Diagnósticos de un contenido concreto, sin tocar el disco. */
+    diagnosticar(proyecto, ruta, contenido) {
+        proyecto.overlay.set(ruta, contenido);
+        proyecto.versiones.set(ruta, (proyecto.versiones.get(ruta) ?? 0) + 1);
+        let brutos;
+        try {
+            brutos = proyecto.servicio.getSemanticDiagnostics(ruta);
+        }
+        catch {
+            // Un fallo del servicio degrada la señal, no la sesión.
+            return [];
+        }
+        const fuente = proyecto.servicio.getProgram()?.getSourceFile(ruta);
+        return brutos.map((d) => {
+            const pos = fuente && d.start !== undefined ? fuente.getLineAndCharacterOfPosition(d.start) : null;
+            return { linea: pos ? pos.line + 1 : 0, mensaje: ts.flattenDiagnosticMessageText(d.messageText, " ") };
+        });
+    }
+    /**
+     * Los errores de tipos que esta edición ha INTRODUCIDO.
+     *
+     * Devuelve lista vacía cuando no hay ninguno nuevo, y también cuando no se
+     * puede comprobar — para eso está `porQueNo()`, que quien llama debe mirar si
+     * quiere distinguir «no hay errores» de «no lo he mirado». Son cosas muy
+     * distintas y confundirlas es lo que convierte un aviso en una mentira.
+     */
+    introducidos(ruta, antes, despues) {
+        if (this.porQueNo(ruta))
+            return [];
+        const cfg = this.buscarConfig(ruta);
+        if (!cfg)
+            return [];
+        const proyecto = this.proyectoDe(cfg);
+        if (!proyecto)
+            return [];
+        const despuesDiag = this.diagnosticar(proyecto, ruta, despues);
+        if (despuesDiag.length === 0) {
+            proyecto.overlay.delete(ruta);
+            return [];
+        }
+        // Solo aquí se paga la segunda comprobación: la mayoría de ediciones son
+        // correctas y salen por el `return` de arriba con una sola.
+        const antesDiag = antes === null ? [] : this.diagnosticar(proyecto, ruta, antes);
+        proyecto.overlay.delete(ruta);
+        const yaEstaban = new Set(antesDiag.map((d) => d.mensaje));
+        return despuesDiag.filter((d) => !yaEstaban.has(d.mensaje));
+    }
+}
+/** El aviso para el modelo, o `null` si no hay nada que decir. */
+export function avisoDeTipos(ruta, errores) {
+    if (errores.length === 0)
+        return null;
+    const lineas = errores.slice(0, 3).map((e) => `  línea ${e.linea}: ${e.mensaje}`);
+    const resto = errores.length > 3 ? `\n  …y ${errores.length - 3} más` : "";
+    return `⚠ Esta edición introduce ${errores.length === 1 ? "un error" : `${errores.length} errores`} de tipos en \`${ruta}\`:\n${lineas.join("\n")}${resto}`;
+}
+//# sourceMappingURL=tipos.js.map

package/dist/core/edicion/tipos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tipos.js","sourceRoot":"","sources":["../../../src/core/edicion/tipos.ts"],"names":[],"mappings":"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"}

package/dist/core/engine-personality.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-personality.d.ts","sourceRoot":"","sources":["../../src/core/engine-personality.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iEAAiE;AACjE,wBAAgB,2BAA2B,IAAI,MAAM,CAyCpD","sourcesContent":["/**\n * Personalidad del Ada Intelligence Engine — bloque SIEMPRE presente en el\n * system prompt de la sesión principal.\n *\n * El modelo NO depende de leer la skill (puede ignorar available_skills):\n * este bloque le da el árbol de decisión, los procedimientos y los formatos\n * de respuesta directamente, en cada turno. La skill completa queda como\n * referencia opcional para detalles (budgets, builtins, etc.).\n */\n\n/** Bloque compacto de personalidad del engine (~1.4K tokens). */\nexport function buildEnginePersonalityBlock(): string {\n\treturn [\n\t\t\"═══ Ada Intelligence Engine — PERSONALIDAD (obligatorio) ═══\",\n\t\t\"\",\n\t\t\"Eres Ada, con un motor de inteligencia autónoma integrado. DECIDE TÚ qué mecanismo usar para cada petición — NUNCA preguntes al usuario '¿goal, workflow o normal?'. Evalúa la petición y ejecuta:\",\n\t\t\"\",\n\t\t\"ÁRBOL DE DECISIÓN (elige la PRIMERA que aplique):\",\n\t\t\"  1. ¿Objetivo de largo plazo, iterativo, con criterios de éxito? (ej: 'construye una landing y verifica que funciona', 'arregla el login', 'mejora X hasta que Y pase') → usa la tool goal_new.\",\n\t\t\"  2. ¿Investigación / revisión de código / auditoría / análisis multi-ángulo? (ej: 'investiga Z con fuentes', 'revisa este código', 'audita el repo', 'compara A y B') → usa la tool workflow (deep_research, code_review, codebase_audit, multi_perspective, product_build).\",\n\t\t\"  3. ¿Tarea concreta de una pasada? (ej: 'crea un script', 'corrige este bug', 'explica X') → usa las tools normales, sin el engine.\",\n\t\t\"  4. ¿El usuario menciona explícitamente 'goal' o 'workflow'? → respeta su elección aunque la tarea parezca simple.\",\n\t\t\"\",\n\t\t\"CUANDO USES GOAL (objetivo de largo plazo):\",\n\t\t\"  - Llama goal_new con: goal (verbatim), doneCriteria (2-5 criterios MEDIBLES — invéntalos si el usuario no los dio), verifyCommand (comando de verificación o '').\",\n\t\t\"  - El goal nace en 'setup'. NO empieces a trabajar: responde EXACTAMENTE así:\",\n\t\t\"      🎯 Goal creado: <id>\",\n\t\t\"      Criterios: <c1> · <c2>\",\n\t\t\"      Apruebalo con: /goal approve <id>  (o pulsa Approve en el panel Engine)\",\n\t\t\"  - Tras aprobarse, el engine lanza un workflow dinámico por sub-tarea automáticamente (uno a la vez). Los pasos viven en esos workflows, NO en el goal. Tú trabajas cuando el engine te da el turno: escribe código, corre tests, edita archivos.\",\n\t\t\"  - Cuando todas las sub-tareas estén done, el juez evalúa. Nunca declares completo sin evidencia (archivo:línea, URL o salida de comando).\",\n\t\t\"\",\n\t\t\"CUANDO USES WORKFLOW (investigación/revisión/auditoría):\",\n\t\t\"  - Llama workflow con command:'run' y el nombre + args (question=, brief=, problem=, verifyCommand=, k=v custom).\",\n\t\t\"  - La confirmación de coste es automática (fail-closed 15s). No la simules.\",\n\t\t\"  - Responde EXACTAMENTE así:\",\n\t\t\"      ⚡ Workflow lanzado: <name> (<runId>)\",\n\t\t\"      Fases: <f1> → <f2>\",\n\t\t\"      Sigue el progreso en el panel Engine o con /workflow status <runId>\",\n\t\t\"\",\n\t\t\"GRAFO DE TRABAJO: es AUTÓNOMO. Se registra solo cuando escribes archivos (ARTIFACT + implemented_by) y cuando un test pasa (verified_by). NO hagas nada manualmente para el grafo. Usa graph_add_nodes SOLO en auditorías para marcar QA_FINDING/RISK/DECISION.\",\n\t\t\"\",\n\t\t\"PROHIBIDO:\",\n\t\t\"  ✗ Responder '¿goal o workflow?' — decide tú.\",\n\t\t\"  ✗ Completar un goal sin evidencia citada.\",\n\t\t\"  ✗ Lanzar un workflow sin confirmación de coste.\",\n\t\t\"  ✗ Crear goals/workflows desde un subagente.\",\n\t\t\"  ✗ Inventar fuentes en deep_research (cada claim ≥2 fuentes reales).\",\n\t\t\"\",\n\t\t\"La skill 'ada-engine' (available_skills) tiene el detalle completo (budgets, builtins, frenos) — léela si necesitas esos detalles. El comportamiento esencial está ARRIBA.\",\n\t\t\"═══ fin de personalidad del engine ═══\",\n\t].join(\"\\n\");\n}\n"]}
+{"version":3,"file":"engine-personality.d.ts","sourceRoot":"","sources":["../../src/core/engine-personality.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iEAAiE;AACjE,wBAAgB,2BAA2B,IAAI,MAAM,CAyCpD"}

package/dist/core/engine-personality.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-personality.js","sourceRoot":"","sources":["../../src/core/engine-personality.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iEAAiE;AACjE,MAAM,UAAU,2BAA2B,GAAW;IACrD,OAAO;QACN,4EAA8D;QAC9D,EAAE;QACF,6MAAoM;QACpM,EAAE;QACF,qDAAmD;QACnD,sMAAkM;QAClM,yRAA+Q;QAC/Q,yIAAsI;QACtI,0HAAqH;QACrH,EAAE;QACF,6CAA6C;QAC7C,yKAAqK;QACrK,iFAAgF;QAChF,8BAA2B;QAC3B,+BAA8B;QAC9B,+EAA+E;QAC/E,wPAAoP;QACpP,gJAA6I;QAC7I,EAAE;QACF,6DAA0D;QAC1D,oHAAoH;QACpH,gFAA8E;QAC9E,gCAA+B;QAC/B,8CAA4C;QAC5C,4BAA0B;QAC1B,2EAA2E;QAC3E,EAAE;QACF,mQAAiQ;QACjQ,EAAE;QACF,YAAY;QACZ,sDAAgD;QAChD,+CAA6C;QAC7C,sDAAmD;QACnD,iDAA+C;QAC/C,2EAAuE;QACvE,EAAE;QACF,gLAA4K;QAC5K,oDAAwC;KACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CACb","sourcesContent":["/**\n * Personalidad del Ada Intelligence Engine — bloque SIEMPRE presente en el\n * system prompt de la sesión principal.\n *\n * El modelo NO depende de leer la skill (puede ignorar available_skills):\n * este bloque le da el árbol de decisión, los procedimientos y los formatos\n * de respuesta directamente, en cada turno. La skill completa queda como\n * referencia opcional para detalles (budgets, builtins, etc.).\n */\n\n/** Bloque compacto de personalidad del engine (~1.4K tokens). */\nexport function buildEnginePersonalityBlock(): string {\n\treturn [\n\t\t\"═══ Ada Intelligence Engine — PERSONALIDAD (obligatorio) ═══\",\n\t\t\"\",\n\t\t\"Eres Ada, con un motor de inteligencia autónoma integrado. DECIDE TÚ qué mecanismo usar para cada petición — NUNCA preguntes al usuario '¿goal, workflow o normal?'. Evalúa la petición y ejecuta:\",\n\t\t\"\",\n\t\t\"ÁRBOL DE DECISIÓN (elige la PRIMERA que aplique):\",\n\t\t\"  1. ¿Objetivo de largo plazo, iterativo, con criterios de éxito? (ej: 'construye una landing y verifica que funciona', 'arregla el login', 'mejora X hasta que Y pase') → usa la tool goal_new.\",\n\t\t\"  2. ¿Investigación / revisión de código / auditoría / análisis multi-ángulo? (ej: 'investiga Z con fuentes', 'revisa este código', 'audita el repo', 'compara A y B') → usa la tool workflow (deep_research, code_review, codebase_audit, multi_perspective, product_build).\",\n\t\t\"  3. ¿Tarea concreta de una pasada? (ej: 'crea un script', 'corrige este bug', 'explica X') → usa las tools normales, sin el engine.\",\n\t\t\"  4. ¿El usuario menciona explícitamente 'goal' o 'workflow'? → respeta su elección aunque la tarea parezca simple.\",\n\t\t\"\",\n\t\t\"CUANDO USES GOAL (objetivo de largo plazo):\",\n\t\t\"  - Llama goal_new con: goal (verbatim), doneCriteria (2-5 criterios MEDIBLES — invéntalos si el usuario no los dio), verifyCommand (comando de verificación o '').\",\n\t\t\"  - El goal nace en 'setup'. NO empieces a trabajar: responde EXACTAMENTE así:\",\n\t\t\"      🎯 Goal creado: <id>\",\n\t\t\"      Criterios: <c1> · <c2>\",\n\t\t\"      Apruebalo con: /goal approve <id>  (o pulsa Approve en el panel Engine)\",\n\t\t\"  - Tras aprobarse, el engine lanza un workflow dinámico por sub-tarea automáticamente (uno a la vez). Los pasos viven en esos workflows, NO en el goal. Tú trabajas cuando el engine te da el turno: escribe código, corre tests, edita archivos.\",\n\t\t\"  - Cuando todas las sub-tareas estén done, el juez evalúa. Nunca declares completo sin evidencia (archivo:línea, URL o salida de comando).\",\n\t\t\"\",\n\t\t\"CUANDO USES WORKFLOW (investigación/revisión/auditoría):\",\n\t\t\"  - Llama workflow con command:'run' y el nombre + args (question=, brief=, problem=, verifyCommand=, k=v custom).\",\n\t\t\"  - La confirmación de coste es automática (fail-closed 15s). No la simules.\",\n\t\t\"  - Responde EXACTAMENTE así:\",\n\t\t\"      ⚡ Workflow lanzado: <name> (<runId>)\",\n\t\t\"      Fases: <f1> → <f2>\",\n\t\t\"      Sigue el progreso en el panel Engine o con /workflow status <runId>\",\n\t\t\"\",\n\t\t\"GRAFO DE TRABAJO: es AUTÓNOMO. Se registra solo cuando escribes archivos (ARTIFACT + implemented_by) y cuando un test pasa (verified_by). NO hagas nada manualmente para el grafo. Usa graph_add_nodes SOLO en auditorías para marcar QA_FINDING/RISK/DECISION.\",\n\t\t\"\",\n\t\t\"PROHIBIDO:\",\n\t\t\"  ✗ Responder '¿goal o workflow?' — decide tú.\",\n\t\t\"  ✗ Completar un goal sin evidencia citada.\",\n\t\t\"  ✗ Lanzar un workflow sin confirmación de coste.\",\n\t\t\"  ✗ Crear goals/workflows desde un subagente.\",\n\t\t\"  ✗ Inventar fuentes en deep_research (cada claim ≥2 fuentes reales).\",\n\t\t\"\",\n\t\t\"La skill 'ada-engine' (available_skills) tiene el detalle completo (budgets, builtins, frenos) — léela si necesitas esos detalles. El comportamiento esencial está ARRIBA.\",\n\t\t\"═══ fin de personalidad del engine ═══\",\n\t].join(\"\\n\");\n}\n"]}
+{"version":3,"file":"engine-personality.js","sourceRoot":"","sources":["../../src/core/engine-personality.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iEAAiE;AACjE,MAAM,UAAU,2BAA2B;IAC1C,OAAO;QACN,8DAA8D;QAC9D,EAAE;QACF,oMAAoM;QACpM,EAAE;QACF,mDAAmD;QACnD,kMAAkM;QAClM,+QAA+Q;QAC/Q,sIAAsI;QACtI,qHAAqH;QACrH,EAAE;QACF,6CAA6C;QAC7C,qKAAqK;QACrK,gFAAgF;QAChF,4BAA4B;QAC5B,8BAA8B;QAC9B,+EAA+E;QAC/E,oPAAoP;QACpP,6IAA6I;QAC7I,EAAE;QACF,0DAA0D;QAC1D,oHAAoH;QACpH,8EAA8E;QAC9E,+BAA+B;QAC/B,4CAA4C;QAC5C,0BAA0B;QAC1B,2EAA2E;QAC3E,EAAE;QACF,iQAAiQ;QACjQ,EAAE;QACF,YAAY;QACZ,gDAAgD;QAChD,6CAA6C;QAC7C,mDAAmD;QACnD,+CAA+C;QAC/C,uEAAuE;QACvE,EAAE;QACF,4KAA4K;QAC5K,wCAAwC;KACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/core/errores/proveedor.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Qué ha pasado de verdad cuando el proveedor devuelve un error.
+ *
+ * Hoy se le enseña al usuario el error crudo. Esto es literal, capturado
+ * ejecutando `ada-cli review` durante el desarrollo:
+ *
+ *     El modelo no devolvió nada (error: 429: {"message":"Provider returned
+ *     error","code":429,"metadata":{"raw":"stealth/ox-alpha is temporarily
+ *     rate-limited upstream. Please retry shortly.","provider_name":"Stealth",
+ *     "is_byok":false,"limit_source":"upstream_provider_shared_pool",
+ *     "remedy_hint":"Retry shortly, add your own provider key (https://
+ *     openrouter.ai/settings/integrations), or route to another provider…"}}).
+ *
+ * Dentro de ese volcado hay tres cosas útiles —es un límite de tasa, es
+ * temporal, y hay tres salidas— y el usuario tiene que extraerlas a mano de un
+ * JSON de 400 caracteres. Peor: la mayoría no lo lee, y un error que no se lee
+ * es un error que se interpreta como «esto no funciona».
+ *
+ * Este módulo lo convierte en:
+ *
+ *     El proveedor está limitando la tasa (429). Es temporal.
+ *     Reintenta en unos segundos, cambia de modelo con /model, o configura tu
+ *     propia clave del proveedor.
+ *
+ * DOS DECISIONES QUE IMPORTAN
+ *
+ * - **`reintentable` es un dato, no una opinión.** Lo consume el código que
+ *   decide si volver a intentarlo; mezclarlo con el texto obligaría a leer
+ *   prosa para tomar una decisión de control.
+ * - **Lo desconocido se dice desconocido.** Una clasificación que inventa una
+ *   categoría plausible para todo es peor que ninguna: manda al usuario a
+ *   arreglar algo que no está roto. Cuando no se sabe, se devuelve el mensaje
+ *   original y se dice que no se ha podido clasificar.
+ */
+export type ClaseDeError = "limite-de-tasa" | "sin-credencial" | "credencial-invalida" | "cuota-agotada" | "modelo-no-disponible" | "contexto-excedido" | "contenido-rechazado" | "red" | "servidor" | "cancelado" | "desconocida";
+export interface ErrorClasificado {
+    clase: ClaseDeError;
+    /** ¿Tiene sentido volver a intentarlo tal cual? Dato de control, no prosa. */
+    reintentable: boolean;
+    /** Segundos que el proveedor pide esperar, cuando lo dice. */
+    esperarSegundos?: number;
+    /** Qué puede hacer el usuario, en una o dos líneas. */
+    queHacer: string;
+    /** El texto original, para quien necesite el detalle. */
+    original: string;
+}
+export declare function clasificarError(entrada: {
+    mensaje: string;
+    estado?: number;
+}): ErrorClasificado;
+/** El error, listo para enseñárselo a una persona. */
+export declare function explicarError(e: ErrorClasificado): string;
+//# sourceMappingURL=proveedor.d.ts.map

package/dist/core/errores/proveedor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proveedor.d.ts","sourceRoot":"","sources":["../../../src/core/errores/proveedor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,MAAM,YAAY,GACrB,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,GACrB,eAAe,GACf,sBAAsB,GACtB,mBAAmB,GACnB,qBAAqB,GACrB,KAAK,GACL,UAAU,GACV,WAAW,GACX,aAAa,CAAC;AAEjB,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,YAAY,CAAC;IACpB,8EAA8E;IAC9E,YAAY,EAAE,OAAO,CAAC;IACtB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;CACjB;AAoJD,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CA2B/F;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAIzD"}

package/dist/core/errores/proveedor.js

@@ -0,0 +1,191 @@
+/**
+ * Qué ha pasado de verdad cuando el proveedor devuelve un error.
+ *
+ * Hoy se le enseña al usuario el error crudo. Esto es literal, capturado
+ * ejecutando `ada-cli review` durante el desarrollo:
+ *
+ *     El modelo no devolvió nada (error: 429: {"message":"Provider returned
+ *     error","code":429,"metadata":{"raw":"stealth/ox-alpha is temporarily
+ *     rate-limited upstream. Please retry shortly.","provider_name":"Stealth",
+ *     "is_byok":false,"limit_source":"upstream_provider_shared_pool",
+ *     "remedy_hint":"Retry shortly, add your own provider key (https://
+ *     openrouter.ai/settings/integrations), or route to another provider…"}}).
+ *
+ * Dentro de ese volcado hay tres cosas útiles —es un límite de tasa, es
+ * temporal, y hay tres salidas— y el usuario tiene que extraerlas a mano de un
+ * JSON de 400 caracteres. Peor: la mayoría no lo lee, y un error que no se lee
+ * es un error que se interpreta como «esto no funciona».
+ *
+ * Este módulo lo convierte en:
+ *
+ *     El proveedor está limitando la tasa (429). Es temporal.
+ *     Reintenta en unos segundos, cambia de modelo con /model, o configura tu
+ *     propia clave del proveedor.
+ *
+ * DOS DECISIONES QUE IMPORTAN
+ *
+ * - **`reintentable` es un dato, no una opinión.** Lo consume el código que
+ *   decide si volver a intentarlo; mezclarlo con el texto obligaría a leer
+ *   prosa para tomar una decisión de control.
+ * - **Lo desconocido se dice desconocido.** Una clasificación que inventa una
+ *   categoría plausible para todo es peor que ninguna: manda al usuario a
+ *   arreglar algo que no está roto. Cuando no se sabe, se devuelve el mensaje
+ *   original y se dice que no se ha podido clasificar.
+ */
+/** Lo que el proveedor sugiere, cuando viene en el cuerpo. */
+function pistaDelProveedor(texto) {
+    const m = texto.match(/"remedy_hint"\s*:\s*"([^"]{1,300})"/);
+    return m ? m[1] : null;
+}
+/** `retry-after` en segundos, venga en cabecera o en el cuerpo. */
+function segundosDeEspera(texto) {
+    const m = texto.match(/retry[-_\s]?after["'\s:]*(\d{1,5})/i);
+    if (m)
+        return Number(m[1]);
+    const ms = texto.match(/"retryAfterMs"\s*:\s*(\d{1,8})/);
+    return ms ? Math.ceil(Number(ms[1]) / 1000) : undefined;
+}
+/**
+ * El orden importa: lo más específico primero.
+ *
+ * «Cuota agotada» y «límite de tasa» llegan los dos como 429 y se arreglan de
+ * formas opuestas —uno esperando, el otro cambiando de plan o de cuenta—, así
+ * que confundirlos manda al usuario a esperar indefinidamente algo que no va a
+ * pasar.
+ */
+const REGLAS = [
+    {
+        clase: "cancelado",
+        reintentable: false,
+        coincide: (t) => /\b(aborted|abortError|operation was aborted|cancell?ed)\b/i.test(t),
+        queHacer: "La operación se canceló. Si no fuiste tú, revisa si algo agotó el tiempo de espera.",
+    },
+    {
+        clase: "cuota-agotada",
+        reintentable: false,
+        coincide: (t) => /\b(usage limit|quota exceeded|credit balance|insufficient_quota|billing|out of credits|plan limit)\b/i.test(t),
+        queHacer: "Se ha agotado la cuota o el saldo de esta cuenta. Esperar no lo arregla: cambia de modelo con /model, usa otra credencial o amplía el plan.",
+    },
+    {
+        clase: "limite-de-tasa",
+        reintentable: true,
+        coincide: (t, estado) => estado === 429 || /\brate[- ]?limit(?:ed|ing|s)?\b|\btoo many requests\b/i.test(t),
+        queHacer: "El proveedor está limitando la tasa. Es temporal: reintenta en unos segundos, cambia de modelo con /model o configura tu propia clave del proveedor.",
+    },
+    {
+        clase: "contexto-excedido",
+        reintentable: false,
+        coincide: (t) => /\b(context[_\s]length|maximum context|too many tokens|prompt is too long|context_length_exceeded)\b/i.test(t),
+        queHacer: "La conversación no cabe en la ventana del modelo. Compacta con /compact, empieza una sesión nueva o usa un modelo con más contexto.",
+    },
+    {
+        clase: "credencial-invalida",
+        reintentable: false,
+        coincide: (t, estado) => (estado === 401 || estado === 403) &&
+            /\b(invalid|expired|revoked|invalidated|incorrect api key|unauthorized)\b/i.test(t),
+        queHacer: "La credencial no vale o ha caducado. Vuelve a autenticarte con /login.",
+    },
+    {
+        clase: "sin-credencial",
+        reintentable: false,
+        coincide: (t, estado) => estado === 401 || /\b(no api key|missing api key|not authenticated)\b/i.test(t),
+        queHacer: "No hay credencial para este proveedor. Configúrala con /login.",
+    },
+    {
+        clase: "modelo-no-disponible",
+        reintentable: false,
+        coincide: (t, estado) => (estado === 404 && /model/i.test(t)) ||
+            /\b(model_not_found|does not exist or you do not have access)\b/i.test(t),
+        queHacer: "Ese modelo no existe o tu cuenta no tiene acceso. Elige otro con /model.",
+    },
+    {
+        clase: "contenido-rechazado",
+        reintentable: false,
+        coincide: (t) => /\b(content[_\s]filter|safety|blocked by|refused to respond|policy violation)\b/i.test(t),
+        queHacer: "El proveedor ha rechazado el contenido por su política. Reformula la petición.",
+    },
+    {
+        clase: "red",
+        reintentable: true,
+        // `connection error` lo añadió `ada-cli commit`: con el proveedor apagado,
+        // el SDK de OpenAI devuelve literalmente «Connection error.» y ni una de
+        // las palabras de arriba. Salía como "no se ha podido clasificar", que es
+        // honesto pero deja al usuario sin saber que basta con mirar la red.
+        //
+        // `terminated` es el hermano del anterior y aparece cuando el proveedor NO
+        // estaba apagado sino que se murió a media respuesta: undici corta el
+        // socket y el SDK devuelve `{stopReason:"error", errorMessage:"terminated"}`.
+        // Capturado ejecutando `commit` contra un servidor que emite un trozo y
+        // destruye la conexión.
+        coincide: (t) => /\b(ECONNREFUSED|ENOTFOUND|ETIMEDOUT|ECONNRESET|EAI_AGAIN|socket hang up|network error|connection error|fetch failed|terminated)\b/i.test(t),
+        queHacer: "No se ha podido llegar al proveedor. Revisa la conexión o el proxy y reintenta.",
+    },
+    {
+        clase: "servidor",
+        reintentable: true,
+        coincide: (_t, estado) => estado !== undefined && estado >= 500 && estado < 600,
+        queHacer: "El proveedor ha fallado por su lado. Suele arreglarse solo: reintenta en un momento.",
+    },
+];
+/** Saca el código HTTP del texto cuando no viene aparte. */
+function estadoDelTexto(texto) {
+    // También un código a pelo al principio (`429 Too Many Requests`), que es
+    // como llega la mitad de los errores de proveedor. Exigir los dos puntos
+    // dejaba sin clasificar justo el caso más común: lo cazó la prueba.
+    //
+    // Y el código ENTRE PARÉNTESIS, que es la otra mitad. `formatProviderError`
+    // del SDK (packages/ai/src/utils/error-body.ts:128) arma el mensaje así:
+    //
+    //     `${prefix} (${status}): ${body}`     -> "OpenAI API error (401): {…}"
+    //     `${status}: ${body}`                 -> "429: {…}"          (sin prefix)
+    //
+    // Solo la segunda forma casaba. La primera la usan `openai-responses` y
+    // `azure-openai-responses`, o sea todo el que va por la Responses API de
+    // OpenAI o por Azure. Medido ejecutando el clasificador sobre los formatos
+    // reales del SDK: 4 de 6 salían "desconocida", entre ellos un 429 y un 401.
+    // El 429 con el que se dio esto por bueno venía de openrouter, que va por
+    // `openai-completions` y NO lleva prefijo — de ahí que pasara.
+    //
+    // Se exige el `):` pegado para no confundirlo con cualquier número de tres
+    // cifras entre paréntesis que aparezca en el cuerpo del error.
+    const m = texto.match(/\b(?:status|code)["'\s:]*(\d{3})\b/i) ??
+        texto.match(/\((\d{3})\)\s*:/) ??
+        texto.match(/^\s*(\d{3})\b/);
+    const n = m ? Number(m[1]) : Number.NaN;
+    return n >= 100 && n < 600 ? n : undefined;
+}
+export function clasificarError(entrada) {
+    const texto = entrada.mensaje ?? "";
+    const estado = entrada.estado ?? estadoDelTexto(texto);
+    for (const regla of REGLAS) {
+        if (!regla.coincide(texto, estado))
+            continue;
+        const pista = pistaDelProveedor(texto);
+        return {
+            clase: regla.clase,
+            reintentable: regla.reintentable,
+            esperarSegundos: segundosDeEspera(texto),
+            // La pista del proveedor va DETRÁS de la nuestra, no en su lugar: la
+            // nuestra está en el idioma del usuario y habla de nuestros comandos;
+            // la suya conoce su infraestructura. Las dos suman.
+            queHacer: pista ? `${regla.queHacer}\nEl proveedor añade: ${pista}` : regla.queHacer,
+            original: texto,
+        };
+    }
+    // Lo desconocido se dice desconocido. Inventar una categoría plausible manda
+    // al usuario a arreglar algo que no está roto.
+    return {
+        clase: "desconocida",
+        reintentable: false,
+        queHacer: "No se ha podido clasificar este error. El mensaje original está debajo.",
+        original: texto,
+    };
+}
+/** El error, listo para enseñárselo a una persona. */
+export function explicarError(e) {
+    const espera = e.esperarSegundos ? ` Pide esperar ${e.esperarSegundos} s.` : "";
+    if (e.clase === "desconocida")
+        return `${e.queHacer}\n${e.original}`;
+    return `${e.queHacer}${espera}`;
+}
+//# sourceMappingURL=proveedor.js.map

package/dist/core/errores/proveedor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proveedor.js","sourceRoot":"","sources":["../../../src/core/errores/proveedor.ts"],"names":[],"mappings":"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"}

package/dist/core/estructural/buscar.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Búsqueda por FORMA sintáctica, no por texto.
+ *
+ * `grep "function foo"` encuentra la declaración, el comentario que la
+ * menciona y la cadena que la nombra en un mensaje de error: para `grep`, las
+ * tres líneas son iguales, texto que casa con el patrón. Esto camina el AST
+ * real de TypeScript, así que un comentario (trivia, no nodo) o una cadena
+ * (`StringLiteral`, un tipo de nodo que ninguno de nuestros patrones pide)
+ * nunca pueden colar como si fueran la declaración.
+ *
+ * Mismo compilador que ya usa `edicion/parseo.ts`: sin dependencias nuevas, y
+ * ya sabemos que acierta en sintaxis (no en tipos, que es justo lo que no
+ * hace falta para esto). Cubre `.ts/.tsx/.js/.jsx` y sus variantes de módulo;
+ * el resto de lenguajes de programación conocidos se declaran SIN COBERTURA
+ * en vez de callarse y devolver cero resultados, que es indistinguible de "no
+ * hay nada que encontrar" y por eso miente.
+ */
+import ts from "typescript";
+export type TipoPatron = "funcion" | "clase" | "tipo" | "llamada" | "import" | "propiedad";
+export interface Patron {
+    tipo: TipoPatron;
+    nombre: string;
+}
+/**
+ * `null` = el patrón no tiene la forma `tipo:nombre` que entendemos.
+ *
+ * Se corta en el PRIMER `:` a propósito: `import:node:fs` tiene que dejar
+ * `nombre = "node:fs"` intacto, con su propio `:` de módulo interno de Node.
+ */
+export declare function parsearPatron(cadena: string): Patron | null;
+export declare function extensionCubierta(ruta: string): boolean;
+export declare function esOtroLenguajeConocido(ruta: string): boolean;
+/**
+ * Todos los ficheros bajo `raiz` (o `[raiz]` si ya es un fichero).
+ *
+ * Sin `fd` ni glob: un recorrido a mano basta para lo que pide esta tool, y
+ * evita depender de un binario externo para algo que `readdirSync` ya resuelve.
+ * Se saltan los directorios ocultos y los de artefactos de build, igual que
+ * haría cualquier búsqueda de código real.
+ */
+export declare function listarFicheros(raiz: string): string[];
+/** Todos los nodos de `fuente` que coinciden con `patron`, en orden de aparición. */
+export declare function nodosCoincidentes(fuente: ts.SourceFile, patron: Patron): ts.Node[];
+export interface Coincidencia {
+    ruta: string;
+    linea: number;
+    fragmento: string;
+}
+export interface ResultadoBusquedaEstructural {
+    coincidencias: Coincidencia[];
+    /** Ficheros de código en un lenguaje que este buscador no sabe leer. Nunca se disfraza de "sin resultados". */
+    noCubiertos: string[];
+}
+/**
+ * `null` = el patrón no se entendió (fallo de lectura, no "no hay nada").
+ *
+ * `raices` son rutas absolutas (ficheros o directorios); `cwd` solo se usa
+ * para dejar las rutas del resultado relativas y legibles.
+ */
+export declare function buscarEstructural(patronCadena: string, raices: string[], cwd: string): ResultadoBusquedaEstructural | null;
+//# sourceMappingURL=buscar.d.ts.map

package/dist/core/estructural/buscar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buscar.d.ts","sourceRoot":"","sources":["../../../src/core/estructural/buscar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAsB3F,MAAM,WAAW,MAAM;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO3D;AAqDD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAgCrD;AAkDD,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,IAAI,EAAE,CAQlF;AAQD,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC5C,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,+GAA+G;IAC/G,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,MAAM,GACT,4BAA4B,GAAG,IAAI,CA2BrC"}