@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/cli/import-command.js

@@ -0,0 +1,164 @@
+/**
+ * `ada-cli import` — trae sesiones de Claude Code y de Codex.
+ *
+ * Es coste de cambio. Quien viene de otra herramienta tiene ahí meses de
+ * historial, y empezar de cero pesa más que cualquier comparativa de
+ * capacidades.
+ *
+ * Por defecto solo LISTA. Escribir sesiones en el directorio del agente sin que
+ * nadie lo haya pedido explícitamente es de las cosas que no se deshacen bien,
+ * y la lista es además lo que uno quiere ver primero.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { convertir, resumir } from "../core/importar/formatos.js";
+const AYUDA = `Uso:
+  ada-cli import [--from claude-code|codex] [--write] [--limit N]
+
+  --from <cual>   Solo una de las dos fuentes (por defecto, las dos)
+  --write         Escribe las sesiones. Sin esto solo se listan.
+  --limit N       Cuántas traer, de la más reciente hacia atrás (por defecto 20)
+
+Se importa la CONVERSACIÓN, no el estado: las llamadas a herramientas y sus
+resultados se aplanan a texto legible porque no se pueden reproducir —los
+ficheros han cambiado y los procesos murieron—. Una sesión importada sirve
+para leerla, buscarla y continuarla con contexto; no para rebobinarla.`;
+/** Dónde guarda cada herramienta sus transcripciones. */
+function origenes(cual) {
+    const todos = [
+        { formato: "claude-code", raiz: join(homedir(), ".claude", "projects") },
+        { formato: "codex", raiz: join(homedir(), ".codex", "sessions") },
+    ];
+    return cual ? todos.filter((o) => o.formato === cual) : todos;
+}
+/** Todos los .jsonl bajo un directorio, a cualquier profundidad. */
+function jsonls(dir, acumulado = []) {
+    let entradas;
+    try {
+        entradas = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return acumulado;
+    }
+    for (const e of entradas) {
+        const ruta = join(dir, e.name);
+        if (e.isDirectory())
+            jsonls(ruta, acumulado);
+        else if (e.name.endsWith(".jsonl"))
+            acumulado.push(ruta);
+    }
+    return acumulado;
+}
+/** El nombre de proyecto que usa Ada para agrupar sesiones. */
+function carpetaDeProyecto(cwd) {
+    return `-${(cwd || "desconocido").replace(/[/\\]/g, "-")}--`;
+}
+function marcaDeTiempo(ms) {
+    return new Date(ms || 0).toISOString().replace(/[:.]/g, "-");
+}
+/**
+ * Busca (y opcionalmente escribe) las sesiones importables.
+ *
+ * Separado del comando para poder probarlo con directorios de mentira, sin
+ * tocar el `$HOME` de quien ejecuta las pruebas.
+ */
+export function importar(opciones) {
+    const candidatos = [];
+    for (const { raiz } of opciones.fuentes) {
+        for (const ruta of jsonls(raiz)) {
+            try {
+                candidatos.push({ ruta, cuando: statSync(ruta).mtimeMs });
+            }
+            catch {
+                // Un fichero que desaparece a mitad no es un error de importación.
+            }
+        }
+    }
+    candidatos.sort((a, b) => b.cuando - a.cuando);
+    const encontradas = [];
+    const escritas = [];
+    for (const { ruta } of candidatos.slice(0, opciones.limite)) {
+        let lineas;
+        try {
+            lineas = readFileSync(ruta, "utf8").split("\n").filter(Boolean);
+        }
+        catch {
+            continue;
+        }
+        const id = opciones.nuevoId(encontradas.length);
+        const convertido = convertir(lineas, id);
+        if (!convertido)
+            continue; // sin conversación: no se importa una sesión vacía
+        const resumen = resumir(convertido.entradas, convertido.formato, ruta);
+        encontradas.push(resumen);
+        if (!opciones.escribir)
+            continue;
+        const carpeta = join(opciones.destino, carpetaDeProyecto(resumen.cwd));
+        mkdirSync(carpeta, { recursive: true });
+        const fichero = join(carpeta, `${marcaDeTiempo(resumen.cuando)}_${id}.jsonl`);
+        writeFileSync(fichero, `${convertido.entradas.map((e) => JSON.stringify(e)).join("\n")}\n`, "utf8");
+        escritas.push(fichero);
+    }
+    return { encontradas, escritas };
+}
+/** Devuelve true si consumió los argumentos. */
+export function runImportCommand(args, agentDir, nuevoId) {
+    if (args[0] !== "import")
+        return false;
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(AYUDA);
+        return true;
+    }
+    const iFrom = args.indexOf("--from");
+    const cual = iFrom >= 0 ? args[iFrom + 1] : undefined;
+    if (cual && cual !== "claude-code" && cual !== "codex") {
+        console.error(`--from solo admite 'claude-code' o 'codex' (recibido: ${cual}).`);
+        process.exitCode = 1;
+        return true;
+    }
+    const iLimit = args.indexOf("--limit");
+    const limite = iLimit >= 0 ? Number(args[iLimit + 1]) : 20;
+    if (!Number.isFinite(limite) || limite <= 0) {
+        console.error("--limit necesita un número positivo.");
+        process.exitCode = 1;
+        return true;
+    }
+    const fuentes = origenes(cual).filter((o) => existsSync(o.raiz));
+    if (fuentes.length === 0) {
+        // Se nombra lo que se ha mirado: "no hay nada" sin decir dónde se buscó
+        // deja al usuario sin forma de saber si es que no tiene sesiones o es que
+        // las tiene en otro sitio.
+        console.log(`No hay nada que importar. Se ha mirado en:\n${origenes(cual)
+            .map((o) => `  ${o.raiz}`)
+            .join("\n")}`);
+        return true;
+    }
+    const escribir = args.includes("--write");
+    const { encontradas, escritas } = importar({
+        fuentes,
+        destino: join(agentDir, "sessions"),
+        escribir,
+        limite,
+        nuevoId,
+    });
+    if (encontradas.length === 0) {
+        console.log("No se ha encontrado ninguna sesión con conversación en las fuentes revisadas.");
+        return true;
+    }
+    for (const s of encontradas) {
+        const fecha = new Date(s.cuando).toISOString().slice(0, 16).replace("T", " ");
+        console.log(`${s.formato.padEnd(12)} ${fecha}  ${String(s.mensajes).padStart(5)} msg  ${s.cwd}`);
+        if (s.primerPrompt)
+            console.log(`             ${s.primerPrompt}`);
+    }
+    console.log("");
+    if (escribir) {
+        console.log(`Importadas ${escritas.length} sesión(es). Aparecen en \`ada-cli sessions\`.`);
+    }
+    else {
+        console.log(`${encontradas.length} sesión(es) importable(s). Añade --write para traerlas.`);
+    }
+    return true;
+}
+//# sourceMappingURL=import-command.js.map

package/dist/cli/import-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-command.js","sourceRoot":"","sources":["../../src/cli/import-command.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `ada-cli import` — trae sesiones de Claude Code y de Codex.\n *\n * Es coste de cambio. Quien viene de otra herramienta tiene ahí meses de\n * historial, y empezar de cero pesa más que cualquier comparativa de\n * capacidades.\n *\n * Por defecto solo LISTA. Escribir sesiones en el directorio del agente sin que\n * nadie lo haya pedido explícitamente es de las cosas que no se deshacen bien,\n * y la lista es además lo que uno quiere ver primero.\n */\n\nimport type { Dirent } from \"node:fs\";\nimport { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { convertir, type Formato, type ResumenSesion, resumir } from \"../core/importar/formatos.ts\";\n\nconst AYUDA = `Uso:\n  ada-cli import [--from claude-code|codex] [--write] [--limit N]\n\n  --from <cual>   Solo una de las dos fuentes (por defecto, las dos)\n  --write         Escribe las sesiones. Sin esto solo se listan.\n  --limit N       Cuántas traer, de la más reciente hacia atrás (por defecto 20)\n\nSe importa la CONVERSACIÓN, no el estado: las llamadas a herramientas y sus\nresultados se aplanan a texto legible porque no se pueden reproducir —los\nficheros han cambiado y los procesos murieron—. Una sesión importada sirve\npara leerla, buscarla y continuarla con contexto; no para rebobinarla.`;\n\n/** Dónde guarda cada herramienta sus transcripciones. */\nfunction origenes(cual: Formato | undefined): Array<{ formato: Formato; raiz: string }> {\n\tconst todos: Array<{ formato: Formato; raiz: string }> = [\n\t\t{ formato: \"claude-code\", raiz: join(homedir(), \".claude\", \"projects\") },\n\t\t{ formato: \"codex\", raiz: join(homedir(), \".codex\", \"sessions\") },\n\t];\n\treturn cual ? todos.filter((o) => o.formato === cual) : todos;\n}\n\n/** Todos los .jsonl bajo un directorio, a cualquier profundidad. */\nfunction jsonls(dir: string, acumulado: string[] = []): string[] {\n\tlet entradas: Dirent[];\n\ttry {\n\t\tentradas = readdirSync(dir, { withFileTypes: true });\n\t} catch {\n\t\treturn acumulado;\n\t}\n\tfor (const e of entradas) {\n\t\tconst ruta = join(dir, e.name);\n\t\tif (e.isDirectory()) jsonls(ruta, acumulado);\n\t\telse if (e.name.endsWith(\".jsonl\")) acumulado.push(ruta);\n\t}\n\treturn acumulado;\n}\n\n/** El nombre de proyecto que usa Ada para agrupar sesiones. */\nfunction carpetaDeProyecto(cwd: string): string {\n\treturn `-${(cwd || \"desconocido\").replace(/[/\\\\]/g, \"-\")}--`;\n}\n\nfunction marcaDeTiempo(ms: number): string {\n\treturn new Date(ms || 0).toISOString().replace(/[:.]/g, \"-\");\n}\n\nexport interface ResultadoImportacion {\n\tencontradas: ResumenSesion[];\n\tescritas: string[];\n}\n\n/**\n * Busca (y opcionalmente escribe) las sesiones importables.\n *\n * Separado del comando para poder probarlo con directorios de mentira, sin\n * tocar el `$HOME` de quien ejecuta las pruebas.\n */\nexport function importar(opciones: {\n\tfuentes: Array<{ formato: Formato; raiz: string }>;\n\tdestino: string;\n\tescribir: boolean;\n\tlimite: number;\n\tnuevoId: (indice: number) => string;\n}): ResultadoImportacion {\n\tconst candidatos: Array<{ ruta: string; cuando: number }> = [];\n\tfor (const { raiz } of opciones.fuentes) {\n\t\tfor (const ruta of jsonls(raiz)) {\n\t\t\ttry {\n\t\t\t\tcandidatos.push({ ruta, cuando: statSync(ruta).mtimeMs });\n\t\t\t} catch {\n\t\t\t\t// Un fichero que desaparece a mitad no es un error de importación.\n\t\t\t}\n\t\t}\n\t}\n\tcandidatos.sort((a, b) => b.cuando - a.cuando);\n\n\tconst encontradas: ResumenSesion[] = [];\n\tconst escritas: string[] = [];\n\tfor (const { ruta } of candidatos.slice(0, opciones.limite)) {\n\t\tlet lineas: string[];\n\t\ttry {\n\t\t\tlineas = readFileSync(ruta, \"utf8\").split(\"\\n\").filter(Boolean);\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t\tconst id = opciones.nuevoId(encontradas.length);\n\t\tconst convertido = convertir(lineas, id);\n\t\tif (!convertido) continue; // sin conversación: no se importa una sesión vacía\n\t\tconst resumen = resumir(convertido.entradas, convertido.formato, ruta);\n\t\tencontradas.push(resumen);\n\n\t\tif (!opciones.escribir) continue;\n\t\tconst carpeta = join(opciones.destino, carpetaDeProyecto(resumen.cwd));\n\t\tmkdirSync(carpeta, { recursive: true });\n\t\tconst fichero = join(carpeta, `${marcaDeTiempo(resumen.cuando)}_${id}.jsonl`);\n\t\twriteFileSync(fichero, `${convertido.entradas.map((e) => JSON.stringify(e)).join(\"\\n\")}\\n`, \"utf8\");\n\t\tescritas.push(fichero);\n\t}\n\treturn { encontradas, escritas };\n}\n\n/** Devuelve true si consumió los argumentos. */\nexport function runImportCommand(args: string[], agentDir: string, nuevoId: () => string): boolean {\n\tif (args[0] !== \"import\") return false;\n\tif (args.includes(\"--help\") || args.includes(\"-h\")) {\n\t\tconsole.log(AYUDA);\n\t\treturn true;\n\t}\n\n\tconst iFrom = args.indexOf(\"--from\");\n\tconst cual = iFrom >= 0 ? (args[iFrom + 1] as Formato | undefined) : undefined;\n\tif (cual && cual !== \"claude-code\" && cual !== \"codex\") {\n\t\tconsole.error(`--from solo admite 'claude-code' o 'codex' (recibido: ${cual}).`);\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\tconst iLimit = args.indexOf(\"--limit\");\n\tconst limite = iLimit >= 0 ? Number(args[iLimit + 1]) : 20;\n\tif (!Number.isFinite(limite) || limite <= 0) {\n\t\tconsole.error(\"--limit necesita un número positivo.\");\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tconst fuentes = origenes(cual).filter((o) => existsSync(o.raiz));\n\tif (fuentes.length === 0) {\n\t\t// Se nombra lo que se ha mirado: \"no hay nada\" sin decir dónde se buscó\n\t\t// deja al usuario sin forma de saber si es que no tiene sesiones o es que\n\t\t// las tiene en otro sitio.\n\t\tconsole.log(\n\t\t\t`No hay nada que importar. Se ha mirado en:\\n${origenes(cual)\n\t\t\t\t.map((o) => `  ${o.raiz}`)\n\t\t\t\t.join(\"\\n\")}`,\n\t\t);\n\t\treturn true;\n\t}\n\n\tconst escribir = args.includes(\"--write\");\n\tconst { encontradas, escritas } = importar({\n\t\tfuentes,\n\t\tdestino: join(agentDir, \"sessions\"),\n\t\tescribir,\n\t\tlimite,\n\t\tnuevoId,\n\t});\n\n\tif (encontradas.length === 0) {\n\t\tconsole.log(\"No se ha encontrado ninguna sesión con conversación en las fuentes revisadas.\");\n\t\treturn true;\n\t}\n\n\tfor (const s of encontradas) {\n\t\tconst fecha = new Date(s.cuando).toISOString().slice(0, 16).replace(\"T\", \" \");\n\t\tconsole.log(`${s.formato.padEnd(12)} ${fecha}  ${String(s.mensajes).padStart(5)} msg  ${s.cwd}`);\n\t\tif (s.primerPrompt) console.log(`             ${s.primerPrompt}`);\n\t}\n\tconsole.log(\"\");\n\tif (escribir) {\n\t\tconsole.log(`Importadas ${escritas.length} sesión(es). Aparecen en \\`ada-cli sessions\\`.`);\n\t} else {\n\t\tconsole.log(`${encontradas.length} sesión(es) importable(s). Añade --write para traerlas.`);\n\t}\n\treturn true;\n}\n"]}

package/dist/cli/politica-command.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `ada-cli politica` — enseñar si la política del equipo está en vigor.
+ *
+ * Existe porque una política que nadie puede comprobar no sirve de nada. Un
+ * CISO que despliega `politica.json` por MDM a doscientos portátiles necesita
+ * poder contestar «sí, está puesta y muerde» sin abrir un editor de texto, y
+ * necesita que la respuesta distinga los tres estados que hay de verdad:
+ *
+ *   · no hay fichero            — no hay política. Es una respuesta.
+ *   · hay y está en vigor       — con qué techo y qué deniega.
+ *   · hay y no se entiende      — NO es «no hay»: se recorta a `manual` y se
+ *                                 dice, porque una errata suya no puede acabar
+ *                                 dando más permisos de los que quiso.
+ *
+ * Y dice aparte si el fichero lo puede editar el propio usuario, que es la
+ * diferencia entre una política y una sugerencia.
+ */
+export declare function esComandoPolitica(args: string[]): boolean;
+export declare function runPoliticaCommand(args: string[]): Promise<boolean>;
+//# sourceMappingURL=politica-command.d.ts.map

package/dist/cli/politica-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"politica-command.d.ts","sourceRoot":"","sources":["../../src/cli/politica-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA2BH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEzD;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA0DzE","sourcesContent":["/**\n * `ada-cli politica` — enseñar si la política del equipo está en vigor.\n *\n * Existe porque una política que nadie puede comprobar no sirve de nada. Un\n * CISO que despliega `politica.json` por MDM a doscientos portátiles necesita\n * poder contestar «sí, está puesta y muerde» sin abrir un editor de texto, y\n * necesita que la respuesta distinga los tres estados que hay de verdad:\n *\n *   · no hay fichero            — no hay política. Es una respuesta.\n *   · hay y está en vigor       — con qué techo y qué deniega.\n *   · hay y no se entiende      — NO es «no hay»: se recorta a `manual` y se\n *                                 dice, porque una errata suya no puede acabar\n *                                 dando más permisos de los que quiso.\n *\n * Y dice aparte si el fichero lo puede editar el propio usuario, que es la\n * diferencia entre una política y una sugerencia.\n */\n\nimport type { ModoPermiso } from \"../core/aprobacion/politica.ts\";\nimport { leerPoliticaDeMaquina, recortarModo, rutaDeLaPolitica } from \"../core/aprobacion/politica-de-maquina.ts\";\n\nconst MODOS: readonly ModoPermiso[] = [\"plan\", \"manual\", \"auto\", \"yolo\"];\n\nconst AYUDA = `Uso:\n  ada-cli politica            Enseña la política de este equipo y si está en vigor\n\nLa política de máquina es el único ámbito de configuración que el usuario no\npuede editar. Vive donde cada sistema exige administrador para escribir:\n\n  macOS    /Library/Application Support/Ada/politica.json\n  Linux    /etc/ada/politica.json\n  Windows  %ProgramData%\\\\Ada\\\\politica.json\n\nCampos:\n  modoMaximo   Techo del modo de permisos: plan | manual | auto | yolo.\n               SOLO baja el modo que pida el usuario; nunca lo sube.\n  denegadas    Tools desactivadas para todo el equipo. No las levanta yolo.\n  motivo       Qué contarle a quien se topa con el bloqueo.\n\nEjemplo:\n  {\"modoMaximo\":\"auto\",\"denegadas\":[\"bash\"],\"motivo\":\"norma interna SEC-4\"}\n`;\n\nexport function esComandoPolitica(args: string[]): boolean {\n\treturn args[0] === \"politica\" || args[0] === \"policy\";\n}\n\nexport async function runPoliticaCommand(args: string[]): Promise<boolean> {\n\tif (!esComandoPolitica(args)) return false;\n\tif (args.includes(\"--help\") || args.includes(\"-h\")) {\n\t\tconsole.log(AYUDA);\n\t\treturn true;\n\t}\n\n\tconst ruta = rutaDeLaPolitica();\n\tconst l = leerPoliticaDeMaquina(ruta);\n\tconsole.log(`Fichero: ${ruta}`);\n\n\tif (l.estado === \"ausente\") {\n\t\t// Ni bien ni mal: no hay política. Decirlo así evita el «todo correcto»\n\t\t// que tranquiliza sobre un equipo sin ninguna regla puesta.\n\t\tconsole.log(\"No hay política de máquina en este equipo: manda la configuración del usuario.\");\n\t\treturn true;\n\t}\n\n\tif (l.estado === \"ilegible\") {\n\t\tconsole.error(`NO SE ENTIENDE: ${l.aviso}.`);\n\t\tconsole.error(\n\t\t\t\"No se trata como si no hubiera política: el modo se recorta a «manual», porque\\n\" +\n\t\t\t\t\"una errata en el fichero no puede acabar dando más permisos de los que se quisieron.\",\n\t\t);\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tconst techo = l.politica?.modoMaximo;\n\tconsole.log(`Techo del modo: ${techo ?? \"ninguno (el usuario elige)\"}`);\n\tif (techo) {\n\t\t// Se enseña el efecto sobre CADA modo en vez de solo el nombre del techo:\n\t\t// «modoMaximo: auto» no le dice a nadie qué pasa si pide `yolo`.\n\t\tfor (const m of MODOS) {\n\t\t\tconst r = recortarModo(m, l);\n\t\t\tconsole.log(`  el usuario pide ${m.padEnd(6)} -> queda ${r}${r === m ? \"\" : \"  (recortado)\"}`);\n\t\t}\n\t}\n\tconst denegadas = l.politica?.denegadas ?? [];\n\tconsole.log(\n\t\tdenegadas.length\n\t\t\t? `Tools denegadas para el equipo: ${denegadas.join(\", \")} (no las levanta yolo)`\n\t\t\t: \"Tools denegadas para el equipo: ninguna\",\n\t);\n\tif (l.politica?.motivo) console.log(`Motivo que se le da al modelo: ${l.politica.motivo}`);\n\n\tif (l.editablePorElUsuario) {\n\t\t// La mitad que decide si esto es una política o una sugerencia.\n\t\tconsole.error(\n\t\t\t\"\\nAVISO: este usuario puede escribir el fichero, así que la política no garantiza\\n\" +\n\t\t\t\t\"nada — se aplica, porque aplicarla solo puede restringir, pero cualquiera con\\n\" +\n\t\t\t\t\"esta cuenta la borra. Colócala donde haga falta administrador para escribir.\",\n\t\t);\n\t\tprocess.exitCode = 1;\n\t} else {\n\t\tconsole.log(\"\\nEl usuario de esta cuenta NO puede editar el fichero: la política se sostiene.\");\n\t}\n\treturn true;\n}\n"]}

package/dist/cli/politica-command.js

@@ -0,0 +1,93 @@
+/**
+ * `ada-cli politica` — enseñar si la política del equipo está en vigor.
+ *
+ * Existe porque una política que nadie puede comprobar no sirve de nada. Un
+ * CISO que despliega `politica.json` por MDM a doscientos portátiles necesita
+ * poder contestar «sí, está puesta y muerde» sin abrir un editor de texto, y
+ * necesita que la respuesta distinga los tres estados que hay de verdad:
+ *
+ *   · no hay fichero            — no hay política. Es una respuesta.
+ *   · hay y está en vigor       — con qué techo y qué deniega.
+ *   · hay y no se entiende      — NO es «no hay»: se recorta a `manual` y se
+ *                                 dice, porque una errata suya no puede acabar
+ *                                 dando más permisos de los que quiso.
+ *
+ * Y dice aparte si el fichero lo puede editar el propio usuario, que es la
+ * diferencia entre una política y una sugerencia.
+ */
+import { leerPoliticaDeMaquina, recortarModo, rutaDeLaPolitica } from "../core/aprobacion/politica-de-maquina.js";
+const MODOS = ["plan", "manual", "auto", "yolo"];
+const AYUDA = `Uso:
+  ada-cli politica            Enseña la política de este equipo y si está en vigor
+
+La política de máquina es el único ámbito de configuración que el usuario no
+puede editar. Vive donde cada sistema exige administrador para escribir:
+
+  macOS    /Library/Application Support/Ada/politica.json
+  Linux    /etc/ada/politica.json
+  Windows  %ProgramData%\\Ada\\politica.json
+
+Campos:
+  modoMaximo   Techo del modo de permisos: plan | manual | auto | yolo.
+               SOLO baja el modo que pida el usuario; nunca lo sube.
+  denegadas    Tools desactivadas para todo el equipo. No las levanta yolo.
+  motivo       Qué contarle a quien se topa con el bloqueo.
+
+Ejemplo:
+  {"modoMaximo":"auto","denegadas":["bash"],"motivo":"norma interna SEC-4"}
+`;
+export function esComandoPolitica(args) {
+    return args[0] === "politica" || args[0] === "policy";
+}
+export async function runPoliticaCommand(args) {
+    if (!esComandoPolitica(args))
+        return false;
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(AYUDA);
+        return true;
+    }
+    const ruta = rutaDeLaPolitica();
+    const l = leerPoliticaDeMaquina(ruta);
+    console.log(`Fichero: ${ruta}`);
+    if (l.estado === "ausente") {
+        // Ni bien ni mal: no hay política. Decirlo así evita el «todo correcto»
+        // que tranquiliza sobre un equipo sin ninguna regla puesta.
+        console.log("No hay política de máquina en este equipo: manda la configuración del usuario.");
+        return true;
+    }
+    if (l.estado === "ilegible") {
+        console.error(`NO SE ENTIENDE: ${l.aviso}.`);
+        console.error("No se trata como si no hubiera política: el modo se recorta a «manual», porque\n" +
+            "una errata en el fichero no puede acabar dando más permisos de los que se quisieron.");
+        process.exitCode = 1;
+        return true;
+    }
+    const techo = l.politica?.modoMaximo;
+    console.log(`Techo del modo: ${techo ?? "ninguno (el usuario elige)"}`);
+    if (techo) {
+        // Se enseña el efecto sobre CADA modo en vez de solo el nombre del techo:
+        // «modoMaximo: auto» no le dice a nadie qué pasa si pide `yolo`.
+        for (const m of MODOS) {
+            const r = recortarModo(m, l);
+            console.log(`  el usuario pide ${m.padEnd(6)} -> queda ${r}${r === m ? "" : "  (recortado)"}`);
+        }
+    }
+    const denegadas = l.politica?.denegadas ?? [];
+    console.log(denegadas.length
+        ? `Tools denegadas para el equipo: ${denegadas.join(", ")} (no las levanta yolo)`
+        : "Tools denegadas para el equipo: ninguna");
+    if (l.politica?.motivo)
+        console.log(`Motivo que se le da al modelo: ${l.politica.motivo}`);
+    if (l.editablePorElUsuario) {
+        // La mitad que decide si esto es una política o una sugerencia.
+        console.error("\nAVISO: este usuario puede escribir el fichero, así que la política no garantiza\n" +
+            "nada — se aplica, porque aplicarla solo puede restringir, pero cualquiera con\n" +
+            "esta cuenta la borra. Colócala donde haga falta administrador para escribir.");
+        process.exitCode = 1;
+    }
+    else {
+        console.log("\nEl usuario de esta cuenta NO puede editar el fichero: la política se sostiene.");
+    }
+    return true;
+}
+//# sourceMappingURL=politica-command.js.map

package/dist/cli/politica-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"politica-command.js","sourceRoot":"","sources":["../../src/cli/politica-command.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `ada-cli politica` — enseñar si la política del equipo está en vigor.\n *\n * Existe porque una política que nadie puede comprobar no sirve de nada. Un\n * CISO que despliega `politica.json` por MDM a doscientos portátiles necesita\n * poder contestar «sí, está puesta y muerde» sin abrir un editor de texto, y\n * necesita que la respuesta distinga los tres estados que hay de verdad:\n *\n *   · no hay fichero            — no hay política. Es una respuesta.\n *   · hay y está en vigor       — con qué techo y qué deniega.\n *   · hay y no se entiende      — NO es «no hay»: se recorta a `manual` y se\n *                                 dice, porque una errata suya no puede acabar\n *                                 dando más permisos de los que quiso.\n *\n * Y dice aparte si el fichero lo puede editar el propio usuario, que es la\n * diferencia entre una política y una sugerencia.\n */\n\nimport type { ModoPermiso } from \"../core/aprobacion/politica.ts\";\nimport { leerPoliticaDeMaquina, recortarModo, rutaDeLaPolitica } from \"../core/aprobacion/politica-de-maquina.ts\";\n\nconst MODOS: readonly ModoPermiso[] = [\"plan\", \"manual\", \"auto\", \"yolo\"];\n\nconst AYUDA = `Uso:\n  ada-cli politica            Enseña la política de este equipo y si está en vigor\n\nLa política de máquina es el único ámbito de configuración que el usuario no\npuede editar. Vive donde cada sistema exige administrador para escribir:\n\n  macOS    /Library/Application Support/Ada/politica.json\n  Linux    /etc/ada/politica.json\n  Windows  %ProgramData%\\\\Ada\\\\politica.json\n\nCampos:\n  modoMaximo   Techo del modo de permisos: plan | manual | auto | yolo.\n               SOLO baja el modo que pida el usuario; nunca lo sube.\n  denegadas    Tools desactivadas para todo el equipo. No las levanta yolo.\n  motivo       Qué contarle a quien se topa con el bloqueo.\n\nEjemplo:\n  {\"modoMaximo\":\"auto\",\"denegadas\":[\"bash\"],\"motivo\":\"norma interna SEC-4\"}\n`;\n\nexport function esComandoPolitica(args: string[]): boolean {\n\treturn args[0] === \"politica\" || args[0] === \"policy\";\n}\n\nexport async function runPoliticaCommand(args: string[]): Promise<boolean> {\n\tif (!esComandoPolitica(args)) return false;\n\tif (args.includes(\"--help\") || args.includes(\"-h\")) {\n\t\tconsole.log(AYUDA);\n\t\treturn true;\n\t}\n\n\tconst ruta = rutaDeLaPolitica();\n\tconst l = leerPoliticaDeMaquina(ruta);\n\tconsole.log(`Fichero: ${ruta}`);\n\n\tif (l.estado === \"ausente\") {\n\t\t// Ni bien ni mal: no hay política. Decirlo así evita el «todo correcto»\n\t\t// que tranquiliza sobre un equipo sin ninguna regla puesta.\n\t\tconsole.log(\"No hay política de máquina en este equipo: manda la configuración del usuario.\");\n\t\treturn true;\n\t}\n\n\tif (l.estado === \"ilegible\") {\n\t\tconsole.error(`NO SE ENTIENDE: ${l.aviso}.`);\n\t\tconsole.error(\n\t\t\t\"No se trata como si no hubiera política: el modo se recorta a «manual», porque\\n\" +\n\t\t\t\t\"una errata en el fichero no puede acabar dando más permisos de los que se quisieron.\",\n\t\t);\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tconst techo = l.politica?.modoMaximo;\n\tconsole.log(`Techo del modo: ${techo ?? \"ninguno (el usuario elige)\"}`);\n\tif (techo) {\n\t\t// Se enseña el efecto sobre CADA modo en vez de solo el nombre del techo:\n\t\t// «modoMaximo: auto» no le dice a nadie qué pasa si pide `yolo`.\n\t\tfor (const m of MODOS) {\n\t\t\tconst r = recortarModo(m, l);\n\t\t\tconsole.log(`  el usuario pide ${m.padEnd(6)} -> queda ${r}${r === m ? \"\" : \"  (recortado)\"}`);\n\t\t}\n\t}\n\tconst denegadas = l.politica?.denegadas ?? [];\n\tconsole.log(\n\t\tdenegadas.length\n\t\t\t? `Tools denegadas para el equipo: ${denegadas.join(\", \")} (no las levanta yolo)`\n\t\t\t: \"Tools denegadas para el equipo: ninguna\",\n\t);\n\tif (l.politica?.motivo) console.log(`Motivo que se le da al modelo: ${l.politica.motivo}`);\n\n\tif (l.editablePorElUsuario) {\n\t\t// La mitad que decide si esto es una política o una sugerencia.\n\t\tconsole.error(\n\t\t\t\"\\nAVISO: este usuario puede escribir el fichero, así que la política no garantiza\\n\" +\n\t\t\t\t\"nada — se aplica, porque aplicarla solo puede restringir, pero cualquiera con\\n\" +\n\t\t\t\t\"esta cuenta la borra. Colócala donde haga falta administrador para escribir.\",\n\t\t);\n\t\tprocess.exitCode = 1;\n\t} else {\n\t\tconsole.log(\"\\nEl usuario de esta cuenta NO puede editar el fichero: la política se sostiene.\");\n\t}\n\treturn true;\n}\n"]}

package/dist/cli/refine-command.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `ada-cli refine [sessionId]` — convierte lo aprendido en una sesión en notas
+ * durables del harness.
+ *
+ * Va como subcomando del CLI, no como `/refine` dentro del TUI, por dos razones.
+ * La buena: refinar sobre una sesión TERMINADA da mejor material que hacerlo a
+ * mitad, cuando todavía no se sabe qué funcionó. La práctica: los manejadores
+ * de comandos slash viven en `interactive-mode.ts`, que es de upstream, y este
+ * fichero no cuesta nada contra el presupuesto de sync.
+ *
+ * El módulo `core/harness/refine.ts` existía completo y testeado desde hace
+ * varios commits, pero NADIE lo importaba: era código muerto, y la tabla
+ * comparativa lo daba por capacidad disponible. Esto es lo que faltaba para que
+ * la afirmación fuera cierta.
+ */
+export declare function isRefineCommand(args: string[]): boolean;
+export declare function runRefineCommand(args: string[]): Promise<boolean>;
+//# sourceMappingURL=refine-command.d.ts.map

package/dist/cli/refine-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refine-command.d.ts","sourceRoot":"","sources":["../../src/cli/refine-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEvD;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAyEvE","sourcesContent":["/**\n * `ada-cli refine [sessionId]` — convierte lo aprendido en una sesión en notas\n * durables del harness.\n *\n * Va como subcomando del CLI, no como `/refine` dentro del TUI, por dos razones.\n * La buena: refinar sobre una sesión TERMINADA da mejor material que hacerlo a\n * mitad, cuando todavía no se sabe qué funcionó. La práctica: los manejadores\n * de comandos slash viven en `interactive-mode.ts`, que es de upstream, y este\n * fichero no cuesta nada contra el presupuesto de sync.\n *\n * El módulo `core/harness/refine.ts` existía completo y testeado desde hace\n * varios commits, pero NADIE lo importaba: era código muerto, y la tabla\n * comparativa lo daba por capacidad disponible. Esto es lo que faltaba para que\n * la afirmación fuera cierta.\n */\n\nimport { join } from \"node:path\";\nimport { getAgentDir } from \"../config.ts\";\nimport { messageText } from \"../core/workflows/agent-runner.ts\";\n\n/** Texto que se le da al refinador: de qué va la sesión y qué pasó en ella. */\nfunction summarize(entries: Array<{ role?: string; content?: unknown }>, limit = 60): string {\n\t// Se toman los ÚLTIMOS turnos: el final de una sesión contiene las\n\t// conclusiones, mientras que el principio suele ser tanteo.\n\treturn entries\n\t\t.slice(-limit)\n\t\t.map((entry) => {\n\t\t\tconst text = messageText(entry.content).slice(0, 2000);\n\t\t\treturn text ? `[${entry.role ?? \"?\"}] ${text}` : \"\";\n\t\t})\n\t\t.filter(Boolean)\n\t\t.join(\"\\n\\n\");\n}\n\nexport function isRefineCommand(args: string[]): boolean {\n\treturn args[0] === \"refine\";\n}\n\nexport async function runRefineCommand(args: string[]): Promise<boolean> {\n\tif (!isRefineCommand(args)) return false;\n\tif (args.includes(\"--help\") || args.includes(\"-h\")) {\n\t\tconsole.log(`Uso:\n  ada-cli refine [sessionId] [--global]   Extrae lecciones durables de una sesión\n\nSin sessionId usa la sesión más reciente del proyecto. Por defecto las notas se\nguardan con alcance de proyecto; --global las hace válidas en todos.\n\nCada propuesta EXIGE evidencia citada (fichero:línea, un comando y su salida, o\nun mensaje tuyo). Las que no la traen se rechazan y se te dicen.`);\n\t\treturn true;\n\t}\n\n\tconst scope = args.includes(\"--global\") ? \"global\" : \"project\";\n\tconst wanted = args.slice(1).find((arg) => !arg.startsWith(\"--\"));\n\n\tconst { SessionManager } = await import(\"../core/session-manager.ts\");\n\tconst sessions = await SessionManager.list(process.cwd());\n\tif (sessions.length === 0) {\n\t\tconsole.error(\"No hay sesiones en este proyecto.\");\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\tconst found = wanted ? sessions.find((s) => s.id === wanted || s.id.startsWith(wanted)) : sessions[0];\n\tif (!found) {\n\t\tconsole.error(`Sesión no encontrada: ${wanted}. Usa 'ada-cli sessions' para verlas.`);\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tconst manager = SessionManager.open(found.path, undefined, found.cwd || process.cwd());\n\tconst context = manager.buildSessionContext();\n\tconst transcript = summarize(context.messages as Array<{ role?: string; content?: unknown }>);\n\tif (!transcript.trim()) {\n\t\tconsole.log(\"Esa sesión no tiene contenido del que aprender.\");\n\t\treturn true;\n\t}\n\n\tconst { REFINE_SYSTEM_PROMPT, applyProposals, parseProposals, renderRefineResult } = await import(\n\t\t\"../core/harness/refine.ts\"\n\t);\n\tconst { HarnessStore } = await import(\"../core/harness/store.ts\");\n\tconst { createAgentSession } = await import(\"../core/sdk.ts\");\n\n\tconst agentDir = getAgentDir();\n\tconst { session } = await createAgentSession({ cwd: found.cwd || process.cwd(), agentDir });\n\n\t// Se recoge la última respuesta del asistente y se espera a que el turno se\n\t// asiente; sin esperar, el JSON llegaría a medias.\n\tconst replies: string[] = [];\n\tconst settled = new Promise<void>((resolve) => {\n\t\tconst unsubscribe = session.subscribe((event) => {\n\t\t\tif (event.type === \"message_end\" && event.message.role === \"assistant\") {\n\t\t\t\tconst text = messageText(event.message.content);\n\t\t\t\tif (text) replies.push(text);\n\t\t\t}\n\t\t\tif (event.type === \"agent_settled\") {\n\t\t\t\tunsubscribe();\n\t\t\t\tresolve();\n\t\t\t}\n\t\t});\n\t});\n\n\tconsole.log(`Refinando sobre la sesión ${found.id.slice(0, 8)}…`);\n\tawait session.prompt(`${REFINE_SYSTEM_PROMPT}\\n\\n--- SESIÓN ---\\n${transcript}`);\n\tawait settled;\n\n\tconst proposals = parseProposals(replies.at(-1) ?? \"\");\n\tconst store = new HarnessStore(join(agentDir, \"memory-engine\"), scope);\n\tconst result = applyProposals(store, proposals, scope);\n\tconsole.log(renderRefineResult(result));\n\treturn true;\n}\n"]}

package/dist/cli/refine-command.js

@@ -0,0 +1,101 @@
+/**
+ * `ada-cli refine [sessionId]` — convierte lo aprendido en una sesión en notas
+ * durables del harness.
+ *
+ * Va como subcomando del CLI, no como `/refine` dentro del TUI, por dos razones.
+ * La buena: refinar sobre una sesión TERMINADA da mejor material que hacerlo a
+ * mitad, cuando todavía no se sabe qué funcionó. La práctica: los manejadores
+ * de comandos slash viven en `interactive-mode.ts`, que es de upstream, y este
+ * fichero no cuesta nada contra el presupuesto de sync.
+ *
+ * El módulo `core/harness/refine.ts` existía completo y testeado desde hace
+ * varios commits, pero NADIE lo importaba: era código muerto, y la tabla
+ * comparativa lo daba por capacidad disponible. Esto es lo que faltaba para que
+ * la afirmación fuera cierta.
+ */
+import { join } from "node:path";
+import { getAgentDir } from "../config.js";
+import { messageText } from "../core/workflows/agent-runner.js";
+/** Texto que se le da al refinador: de qué va la sesión y qué pasó en ella. */
+function summarize(entries, limit = 60) {
+    // Se toman los ÚLTIMOS turnos: el final de una sesión contiene las
+    // conclusiones, mientras que el principio suele ser tanteo.
+    return entries
+        .slice(-limit)
+        .map((entry) => {
+        const text = messageText(entry.content).slice(0, 2000);
+        return text ? `[${entry.role ?? "?"}] ${text}` : "";
+    })
+        .filter(Boolean)
+        .join("\n\n");
+}
+export function isRefineCommand(args) {
+    return args[0] === "refine";
+}
+export async function runRefineCommand(args) {
+    if (!isRefineCommand(args))
+        return false;
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(`Uso:
+  ada-cli refine [sessionId] [--global]   Extrae lecciones durables de una sesión
+
+Sin sessionId usa la sesión más reciente del proyecto. Por defecto las notas se
+guardan con alcance de proyecto; --global las hace válidas en todos.
+
+Cada propuesta EXIGE evidencia citada (fichero:línea, un comando y su salida, o
+un mensaje tuyo). Las que no la traen se rechazan y se te dicen.`);
+        return true;
+    }
+    const scope = args.includes("--global") ? "global" : "project";
+    const wanted = args.slice(1).find((arg) => !arg.startsWith("--"));
+    const { SessionManager } = await import("../core/session-manager.js");
+    const sessions = await SessionManager.list(process.cwd());
+    if (sessions.length === 0) {
+        console.error("No hay sesiones en este proyecto.");
+        process.exitCode = 1;
+        return true;
+    }
+    const found = wanted ? sessions.find((s) => s.id === wanted || s.id.startsWith(wanted)) : sessions[0];
+    if (!found) {
+        console.error(`Sesión no encontrada: ${wanted}. Usa 'ada-cli sessions' para verlas.`);
+        process.exitCode = 1;
+        return true;
+    }
+    const manager = SessionManager.open(found.path, undefined, found.cwd || process.cwd());
+    const context = manager.buildSessionContext();
+    const transcript = summarize(context.messages);
+    if (!transcript.trim()) {
+        console.log("Esa sesión no tiene contenido del que aprender.");
+        return true;
+    }
+    const { REFINE_SYSTEM_PROMPT, applyProposals, parseProposals, renderRefineResult } = await import("../core/harness/refine.js");
+    const { HarnessStore } = await import("../core/harness/store.js");
+    const { createAgentSession } = await import("../core/sdk.js");
+    const agentDir = getAgentDir();
+    const { session } = await createAgentSession({ cwd: found.cwd || process.cwd(), agentDir });
+    // Se recoge la última respuesta del asistente y se espera a que el turno se
+    // asiente; sin esperar, el JSON llegaría a medias.
+    const replies = [];
+    const settled = new Promise((resolve) => {
+        const unsubscribe = session.subscribe((event) => {
+            if (event.type === "message_end" && event.message.role === "assistant") {
+                const text = messageText(event.message.content);
+                if (text)
+                    replies.push(text);
+            }
+            if (event.type === "agent_settled") {
+                unsubscribe();
+                resolve();
+            }
+        });
+    });
+    console.log(`Refinando sobre la sesión ${found.id.slice(0, 8)}…`);
+    await session.prompt(`${REFINE_SYSTEM_PROMPT}\n\n--- SESIÓN ---\n${transcript}`);
+    await settled;
+    const proposals = parseProposals(replies.at(-1) ?? "");
+    const store = new HarnessStore(join(agentDir, "memory-engine"), scope);
+    const result = applyProposals(store, proposals, scope);
+    console.log(renderRefineResult(result));
+    return true;
+}
+//# sourceMappingURL=refine-command.js.map

package/dist/cli/refine-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refine-command.js","sourceRoot":"","sources":["../../src/cli/refine-command.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `ada-cli refine [sessionId]` — convierte lo aprendido en una sesión en notas\n * durables del harness.\n *\n * Va como subcomando del CLI, no como `/refine` dentro del TUI, por dos razones.\n * La buena: refinar sobre una sesión TERMINADA da mejor material que hacerlo a\n * mitad, cuando todavía no se sabe qué funcionó. La práctica: los manejadores\n * de comandos slash viven en `interactive-mode.ts`, que es de upstream, y este\n * fichero no cuesta nada contra el presupuesto de sync.\n *\n * El módulo `core/harness/refine.ts` existía completo y testeado desde hace\n * varios commits, pero NADIE lo importaba: era código muerto, y la tabla\n * comparativa lo daba por capacidad disponible. Esto es lo que faltaba para que\n * la afirmación fuera cierta.\n */\n\nimport { join } from \"node:path\";\nimport { getAgentDir } from \"../config.ts\";\nimport { messageText } from \"../core/workflows/agent-runner.ts\";\n\n/** Texto que se le da al refinador: de qué va la sesión y qué pasó en ella. */\nfunction summarize(entries: Array<{ role?: string; content?: unknown }>, limit = 60): string {\n\t// Se toman los ÚLTIMOS turnos: el final de una sesión contiene las\n\t// conclusiones, mientras que el principio suele ser tanteo.\n\treturn entries\n\t\t.slice(-limit)\n\t\t.map((entry) => {\n\t\t\tconst text = messageText(entry.content).slice(0, 2000);\n\t\t\treturn text ? `[${entry.role ?? \"?\"}] ${text}` : \"\";\n\t\t})\n\t\t.filter(Boolean)\n\t\t.join(\"\\n\\n\");\n}\n\nexport function isRefineCommand(args: string[]): boolean {\n\treturn args[0] === \"refine\";\n}\n\nexport async function runRefineCommand(args: string[]): Promise<boolean> {\n\tif (!isRefineCommand(args)) return false;\n\tif (args.includes(\"--help\") || args.includes(\"-h\")) {\n\t\tconsole.log(`Uso:\n  ada-cli refine [sessionId] [--global]   Extrae lecciones durables de una sesión\n\nSin sessionId usa la sesión más reciente del proyecto. Por defecto las notas se\nguardan con alcance de proyecto; --global las hace válidas en todos.\n\nCada propuesta EXIGE evidencia citada (fichero:línea, un comando y su salida, o\nun mensaje tuyo). Las que no la traen se rechazan y se te dicen.`);\n\t\treturn true;\n\t}\n\n\tconst scope = args.includes(\"--global\") ? \"global\" : \"project\";\n\tconst wanted = args.slice(1).find((arg) => !arg.startsWith(\"--\"));\n\n\tconst { SessionManager } = await import(\"../core/session-manager.ts\");\n\tconst sessions = await SessionManager.list(process.cwd());\n\tif (sessions.length === 0) {\n\t\tconsole.error(\"No hay sesiones en este proyecto.\");\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\tconst found = wanted ? sessions.find((s) => s.id === wanted || s.id.startsWith(wanted)) : sessions[0];\n\tif (!found) {\n\t\tconsole.error(`Sesión no encontrada: ${wanted}. Usa 'ada-cli sessions' para verlas.`);\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tconst manager = SessionManager.open(found.path, undefined, found.cwd || process.cwd());\n\tconst context = manager.buildSessionContext();\n\tconst transcript = summarize(context.messages as Array<{ role?: string; content?: unknown }>);\n\tif (!transcript.trim()) {\n\t\tconsole.log(\"Esa sesión no tiene contenido del que aprender.\");\n\t\treturn true;\n\t}\n\n\tconst { REFINE_SYSTEM_PROMPT, applyProposals, parseProposals, renderRefineResult } = await import(\n\t\t\"../core/harness/refine.ts\"\n\t);\n\tconst { HarnessStore } = await import(\"../core/harness/store.ts\");\n\tconst { createAgentSession } = await import(\"../core/sdk.ts\");\n\n\tconst agentDir = getAgentDir();\n\tconst { session } = await createAgentSession({ cwd: found.cwd || process.cwd(), agentDir });\n\n\t// Se recoge la última respuesta del asistente y se espera a que el turno se\n\t// asiente; sin esperar, el JSON llegaría a medias.\n\tconst replies: string[] = [];\n\tconst settled = new Promise<void>((resolve) => {\n\t\tconst unsubscribe = session.subscribe((event) => {\n\t\t\tif (event.type === \"message_end\" && event.message.role === \"assistant\") {\n\t\t\t\tconst text = messageText(event.message.content);\n\t\t\t\tif (text) replies.push(text);\n\t\t\t}\n\t\t\tif (event.type === \"agent_settled\") {\n\t\t\t\tunsubscribe();\n\t\t\t\tresolve();\n\t\t\t}\n\t\t});\n\t});\n\n\tconsole.log(`Refinando sobre la sesión ${found.id.slice(0, 8)}…`);\n\tawait session.prompt(`${REFINE_SYSTEM_PROMPT}\\n\\n--- SESIÓN ---\\n${transcript}`);\n\tawait settled;\n\n\tconst proposals = parseProposals(replies.at(-1) ?? \"\");\n\tconst store = new HarnessStore(join(agentDir, \"memory-engine\"), scope);\n\tconst result = applyProposals(store, proposals, scope);\n\tconsole.log(renderRefineResult(result));\n\treturn true;\n}\n"]}

package/dist/cli/review-command.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `ada-cli review` — revisa un diff y ancla cada hallazgo al código.
+ *
+ * La pantalla de bienvenida ya ofrecía «Revisa mis cambios sin commitear», pero
+ * eso era una frase que iba al modelo sin nada detrás: sin contrato de salida,
+ * sin criba y sin forma de sacar los hallazgos del terminal. Aquí hay las tres
+ * cosas.
+ *
+ * Lo que hace que sirva es el ANCLAJE: un hallazgo cuya evidencia no aparece en
+ * el diff se descarta. Un revisor que inventa una línea plausible es peor que
+ * no tener revisor, porque cuesta tiempo comprobar que no existe.
+ *
+ * Y lo que lo hace vendible es `--sarif`: sin él los hallazgos se quedan en la
+ * terminal de quien lanzó el comando y no entran en el proceso de seguridad de
+ * la empresa.
+ */
+export interface DependenciasRevision {
+    /** Pide la revisión al modelo. Se inyecta para poder probar sin red. */
+    revisar: (sistema: string, diff: string) => Promise<string>;
+    cwd?: string;
+}
+/** Devuelve true si consumió los argumentos. */
+export declare function runReviewCommand(args: string[], deps: DependenciasRevision): Promise<boolean>;
+//# sourceMappingURL=review-command.d.ts.map

package/dist/cli/review-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-command.d.ts","sourceRoot":"","sources":["../../src/cli/review-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA+DH,MAAM,WAAW,oBAAoB;IACpC,yEAAwE;IACxE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,iDAAgD;AAChD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CA2FnG","sourcesContent":["/**\n * `ada-cli review` — revisa un diff y ancla cada hallazgo al código.\n *\n * La pantalla de bienvenida ya ofrecía «Revisa mis cambios sin commitear», pero\n * eso era una frase que iba al modelo sin nada detrás: sin contrato de salida,\n * sin criba y sin forma de sacar los hallazgos del terminal. Aquí hay las tres\n * cosas.\n *\n * Lo que hace que sirva es el ANCLAJE: un hallazgo cuya evidencia no aparece en\n * el diff se descarta. Un revisor que inventa una línea plausible es peor que\n * no tener revisor, porque cuesta tiempo comprobar que no existe.\n *\n * Y lo que lo hace vendible es `--sarif`: sin él los hallazgos se quedan en la\n * terminal de quien lanzó el comando y no entran en el proceso de seguridad de\n * la empresa.\n */\n\nimport { execFileSync } from \"node:child_process\";\nimport { writeFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { type Hallazgo, puntuacionDe } from \"../core/revision/hallazgo.ts\";\nimport { cribar, extraerCandidatos, PROMPT_REVISION } from \"../core/revision/revisor.ts\";\nimport { aSarif } from \"../core/revision/sarif.ts\";\n\nconst AYUDA = `Uso:\n  ada-cli review [--staged] [--base <ref>] [--model <p/m>] [--sarif <f>] [--json]\n\n  --staged          Revisa lo que está en el índice (git diff --cached)\n  --base <ref>      Revisa contra una referencia (p. ej. main)\n  --sarif <fich>    Escribe los hallazgos en SARIF 2.1.0, para GitHub Code\n                    Scanning o Azure DevOps\n  --model <p/m>     Revisa con un modelo concreto (proveedor/modelo)\n  --json            Escribe los hallazgos en JSON por stdout\n\nSin opciones revisa los cambios sin commitear (git diff).\n\nCada hallazgo lleva la línea exacta que lo justifica, y los que no se pueden\nanclar en el diff se descartan: un revisor que inventa cuesta más tiempo del\nque ahorra.\n\nSale con código 1 si hay algún hallazgo crítico o alto, para que lo pueda\nmirar un CI.`;\n\n/** El diff que toca revisar, según las opciones. */\nfunction obtenerDiff(args: string[], cwd: string): string {\n\tconst base = args.indexOf(\"--base\");\n\tconst argumentos =\n\t\tbase >= 0 && args[base + 1]\n\t\t\t? [\"diff\", `${args[base + 1]}...HEAD`]\n\t\t\t: args.includes(\"--staged\")\n\t\t\t\t? [\"diff\", \"--cached\"]\n\t\t\t\t: [\"diff\"];\n\t// `-U5` da contexto suficiente para que el modelo entienda el cambio sin\n\t// mandarle el fichero entero, que es lo que dispara el coste.\n\treturn execFileSync(\"git\", [...argumentos, \"-U5\"], { cwd, encoding: \"utf8\", maxBuffer: 32 * 1024 * 1024 });\n}\n\nconst COLOR: Record<string, string> = {\n\tcritica: \"\\u001b[31m\",\n\talta: \"\\u001b[31m\",\n\tmedia: \"\\u001b[33m\",\n\tbaja: \"\\u001b[36m\",\n\tinformativa: \"\\u001b[90m\",\n};\nconst FIN = \"\\u001b[0m\";\n\nfunction imprimir(hallazgos: Hallazgo[]): void {\n\tfor (const h of hallazgos) {\n\t\tconst color = COLOR[h.severidad] ?? \"\";\n\t\tconsole.log(`${color}${h.severidad.toUpperCase()}${FIN}  ${h.titulo}`);\n\t\tconsole.log(`  ${h.ruta}:${h.lineaInicio}${h.lineaFin && h.lineaFin !== h.lineaInicio ? `-${h.lineaFin}` : \"\"}`);\n\t\tconsole.log(`  ${h.resumen}`);\n\t\tconsole.log(`  │ ${h.evidencia.split(\"\\n\").join(\"\\n  │ \")}`);\n\t\tif (h.remedio) console.log(`  → ${h.remedio}`);\n\t\tconsole.log(\"\");\n\t}\n}\n\nexport interface DependenciasRevision {\n\t/** Pide la revisión al modelo. Se inyecta para poder probar sin red. */\n\trevisar: (sistema: string, diff: string) => Promise<string>;\n\tcwd?: string;\n}\n\n/** Devuelve true si consumió los argumentos. */\nexport async function runReviewCommand(args: string[], deps: DependenciasRevision): Promise<boolean> {\n\tif (args[0] !== \"review\") return false;\n\tif (args.includes(\"--help\") || args.includes(\"-h\")) {\n\t\tconsole.log(AYUDA);\n\t\treturn true;\n\t}\n\n\tconst cwd = deps.cwd ?? process.cwd();\n\tlet diff: string;\n\ttry {\n\t\tdiff = obtenerDiff(args, cwd);\n\t} catch (error) {\n\t\tconsole.error(`No se pudo obtener el diff: ${error instanceof Error ? error.message : String(error)}`);\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (diff.trim() === \"\") {\n\t\t// Distinto de \"revisado y limpio\". Si no hay diff, no se ha revisado\n\t\t// nada, y decir \"sin hallazgos\" sería tranquilizar sobre algo que no ha\n\t\t// pasado.\n\t\tconsole.log(\"No hay cambios que revisar.\");\n\t\treturn true;\n\t}\n\n\tlet salida: string;\n\ttry {\n\t\tsalida = await deps.revisar(PROMPT_REVISION, diff);\n\t} catch (error) {\n\t\t// Un fallo del modelo tiene que verse como fallo, con código 1, y no como\n\t\t// una revisión limpia. Se midió: sobre un fallo sembrado, cuatro de cinco\n\t\t// ejecuciones decían \"no ha encontrado nada\" cuando lo que pasaba era un\n\t\t// 429 del proveedor. Y una traza de Node tampoco sirve: quien lanza esto\n\t\t// desde un CI necesita el motivo en una línea.\n\t\tconsole.error(`La revisión no se pudo completar.\\n${error instanceof Error ? error.message : String(error)}`);\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\tconst extraccion = extraerCandidatos(salida);\n\tif (!extraccion.ok) {\n\t\t// Una respuesta ilegible NO es un diff limpio. La guarda de arriba solo\n\t\t// mira si el proveedor falló o cortó; un modelo que contesta prosa\n\t\t// (\"No puedo ayudarte con eso.\") o un JSON roto pasaba entera y salía\n\t\t// como \"El revisor no ha encontrado nada en este diff.\" con código 0.\n\t\t// Se midió: las dos salidas eran idénticas byte a byte.\n\t\tconsole.error(`La revisión no se pudo completar.\\n${extraccion.motivo}`);\n\t\tconsole.error(\"NO se ha revisado el diff. Esto no significa que esté limpio.\");\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\tconst candidatos = extraccion.candidatos;\n\tconst { aceptados, descartados } = cribar(candidatos, diff);\n\n\tif (args.includes(\"--json\")) {\n\t\tconsole.log(JSON.stringify(aceptados, null, 2));\n\t} else if (aceptados.length > 0) {\n\t\timprimir(aceptados);\n\t} else if (candidatos.length === 0) {\n\t\t// El revisor miró y no vio nada. Distinto de lo de abajo, y distinto de\n\t\t// \"no había diff\": las tres se leen igual si se juntan en un mensaje.\n\t\tconsole.log(\"El revisor no ha encontrado nada en este diff.\");\n\t} else {\n\t\t// «Descartados», no «no se pudieron anclar»: el anclaje es solo uno de los\n\t\t// motivos. Un hallazgo sin `lineaInicio` se tiraba con este mismo mensaje,\n\t\t// que culpaba al anclaje de un fallo de forma y mandaba a mirar el sitio\n\t\t// equivocado. Comprobado ejecutando el comando con un hallazgo sin línea.\n\t\tconsole.log(`Ninguno de los ${candidatos.length} hallazgos pasó la criba; todos descartados.`);\n\t}\n\n\t// Los descartes se cuentan Y SE MOTIVAN, no se esconden: sin el motivo no hay\n\t// forma de saber si el revisor está afinado, si el modelo inventa evidencias\n\t// o si está devolviendo hallazgos mal formados. Agrupados por motivo para que\n\t// diez descartes no tapen la pantalla.\n\tif (descartados.length > 0) {\n\t\tconst porMotivo = new Map<string, number>();\n\t\tfor (const d of descartados) porMotivo.set(d.motivo, (porMotivo.get(d.motivo) ?? 0) + 1);\n\t\tconsole.error(`${descartados.length} hallazgo(s) descartado(s):`);\n\t\tfor (const [motivo, cuantos] of porMotivo) console.error(`  ${cuantos}x ${motivo}`);\n\t}\n\n\tconst indice = args.indexOf(\"--sarif\");\n\tif (indice >= 0 && args[indice + 1]) {\n\t\tconst destino = resolve(cwd, args[indice + 1]);\n\t\twriteFileSync(destino, `${JSON.stringify(aSarif(aceptados, { raizRepo: cwd }), null, 2)}\\n`, \"utf8\");\n\t\tconsole.log(`SARIF escrito en ${destino}`);\n\t}\n\n\t// Código 1 solo con lo grave: un CI que falle por un hallazgo informativo se\n\t// desactiva la primera semana.\n\tif (aceptados.some((h) => puntuacionDe(h.severidad) >= puntuacionDe(\"alta\"))) process.exitCode = 1;\n\treturn true;\n}\n"]}