@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/cli/banco-command.js

@@ -0,0 +1,213 @@
+/**
+ * `ada-cli banco` — el banco de fiabilidad de edición.
+ *
+ * Sin esto no había forma de MEDIR si tocar el editor mejora o empeora la
+ * precisión del modelo aplicando parches; solo opiniones. Tres subcomandos:
+ *
+ *   generar   produce casos deterministas desde nuestro propio código fuente,
+ *             validando cada uno resolviéndolo antes de admitirlo.
+ *   run       los ejecuta contra un modelo de verdad — CUESTA DINERO, así que
+ *             exige `--si` o confirmación interactiva.
+ *   comparar  enseña si una ejecución mejoró o empeoró frente a otra.
+ */
+import { join } from "node:path";
+import { createInterface } from "node:readline";
+import { fileURLToPath } from "node:url";
+import { cargarCasos, cargarResultados, guardarCasos, guardarResultados, nombreResultadosPorDefecto, rutaCasosPorDefecto, } from "../core/banco/almacenamiento.js";
+import { compararEjecuciones, formatearComparacion } from "../core/banco/comparar.js";
+import { crearEjecutorReal, ejecutarCasos } from "../core/banco/ejecutar.js";
+import { generarCasos } from "../core/banco/generar.js";
+const AYUDA = `Uso:
+  ada-cli banco generar [--casos N] [--corpus <dir>] [--salida <fichero>]
+                         [--dificultad facil,medio,dificil,pesadilla] [--semilla N]
+  ada-cli banco run [--casos N] [--entrada <fichero>] [--salida <fichero>]
+                     [--modelo proveedor/modelo] [--timeout <ms>] --si
+  ada-cli banco comparar <resultadosA.json> <resultadosB.json>
+
+"generar" no llama a ningún proveedor: crea bugs deterministas a partir del
+código fuente propio y valida cada caso resolviéndolo antes de admitirlo.
+
+"run" SÍ llama a un proveedor de verdad y cuesta dinero. Sin "--si" pide
+confirmación interactiva enseñando cuántas llamadas va a hacer.`;
+function raizPaquete() {
+    return fileURLToPath(new URL("../..", import.meta.url));
+}
+function valorDeFlag(args, nombre) {
+    const i = args.indexOf(nombre);
+    return i >= 0 ? args[i + 1] : undefined;
+}
+async function confirmar(mensaje) {
+    if (!process.stdin.isTTY)
+        return false;
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const respuesta = await new Promise((res) => rl.question(`${mensaje} [y/N] `, res));
+    rl.close();
+    return respuesta.trim().toLowerCase() === "y" || respuesta.trim().toLowerCase() === "yes";
+}
+async function runGenerar(args) {
+    const raiz = raizPaquete();
+    const numCasos = Number(valorDeFlag(args, "--casos") ?? "20");
+    if (!Number.isFinite(numCasos) || numCasos <= 0) {
+        console.error("--casos necesita un número positivo.");
+        process.exitCode = 1;
+        return;
+    }
+    const corpus = valorDeFlag(args, "--corpus") ?? join(raiz, "src");
+    const salida = valorDeFlag(args, "--salida") ?? rutaCasosPorDefecto(raiz);
+    const semilla = Number(valorDeFlag(args, "--semilla") ?? "42");
+    const dificultadArg = valorDeFlag(args, "--dificultad");
+    const dificultades = dificultadArg ? dificultadArg.split(",") : undefined;
+    const conjunto = generarCasos({ corpus, numCasos, semilla, dificultades });
+    guardarCasos(salida, conjunto);
+    console.log(`Generados ${conjunto.casos.length}/${numCasos} casos desde ${corpus}`);
+    console.log(`  descartados por AMBIGUOS: ${conjunto.descartadosPorAmbiguos}`);
+    console.log(`  descartados por no aplicable: ${conjunto.descartadosPorNoAplicable}`);
+    console.log(`  intentos totales: ${conjunto.intentos}`);
+    if (conjunto.descartadosPorAmbiguos === 0 && conjunto.intentos > conjunto.casos.length) {
+        console.log("  (cero ambiguos con reintentos de por medio: revisa construirBloqueUnico si esto sorprende.)");
+    }
+    const porDificultad = new Map();
+    for (const c of conjunto.casos)
+        porDificultad.set(c.dificultad, (porDificultad.get(c.dificultad) ?? 0) + 1);
+    for (const [d, n] of porDificultad)
+        console.log(`  ${d}: ${n}`);
+    console.log(`Guardado en ${salida}`);
+}
+async function runRun(args) {
+    const raiz = raizPaquete();
+    const entrada = valorDeFlag(args, "--entrada") ?? rutaCasosPorDefecto(raiz);
+    const conjunto = cargarCasos(entrada);
+    const limite = valorDeFlag(args, "--casos");
+    const casos = limite ? conjunto.casos.slice(0, Number(limite)) : conjunto.casos;
+    if (casos.length === 0) {
+        console.error("No hay casos que ejecutar.");
+        process.exitCode = 1;
+        return;
+    }
+    const timeoutMs = Number(valorDeFlag(args, "--timeout") ?? "180000");
+    const { getAgentDir } = await import("../config.js");
+    const { ModelRuntime } = await import("../core/model-runtime.js");
+    const { resolveCliModel } = await import("../core/model-resolver.js");
+    const { SettingsManager } = await import("../core/settings-manager.js");
+    const agentDir = getAgentDir();
+    const modelRuntime = await ModelRuntime.create();
+    const ajustes = SettingsManager.create(process.cwd(), agentDir);
+    const spec = valorDeFlag(args, "--modelo");
+    const barra = spec?.indexOf("/") ?? -1;
+    const { model, error } = resolveCliModel({
+        modelRuntime,
+        cliProvider: barra > 0 ? spec?.slice(0, barra) : ajustes.getDefaultProvider(),
+        cliModel: barra > 0 ? spec?.slice(barra + 1) : ajustes.getDefaultModel(),
+    });
+    if (error || !model) {
+        console.error(error ?? "No hay modelo configurado. Abre `ada-cli` y elige uno con /login o /model, o pasa --modelo.");
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`Esto hará ${casos.length} llamada(s) real(es) a ${model.provider}/${model.id}.`);
+    const si = args.includes("--si");
+    if (!si) {
+        const ok = await confirmar("¿Continuar?");
+        if (!ok) {
+            console.log("Cancelado. Repite con --si para saltarte la confirmación.");
+            return;
+        }
+    }
+    const ejecutor = crearEjecutorReal({ agentDir, model, timeoutMs });
+    const resultados = await ejecutarCasos(casos, ejecutor, {
+        proveedor: model.provider,
+        modelo: model.id,
+        casosArchivo: entrada,
+        onProgreso: (i, total, r) => {
+            const estado = r.timeout
+                ? "TIMEOUT"
+                : r.vacio
+                    ? "VACIO"
+                    : r.fantasma
+                        ? "FANTASMA"
+                        : r.tareaOk
+                            ? "tarea-ok"
+                            : r.edicionOk
+                                ? "solo-edicion"
+                                : "fallo";
+            console.log(`  [${i}/${total}] ${r.casoId}  ${estado}`);
+        },
+    });
+    const salida = valorDeFlag(args, "--salida") ?? nombreResultadosPorDefecto(raiz, model.provider, model.id);
+    guardarResultados(salida, resultados);
+    console.log("");
+    console.log(`tarea:    ${resultados.resumen.tareaOkPct}%`);
+    console.log(`edición:  ${resultados.resumen.edicionOkPct}%`);
+    console.log(`fantasma: ${resultados.resumen.fantasmaPct}%`);
+    console.log(`timeout:  ${resultados.resumen.timeoutPct}%`);
+    if (resultados.resumen.vacioPct > 0) {
+        // Un turno vacío no es "el modelo decidió no editar": es que no
+        // contestó. Antes caía dentro de `fantasma` y convertía un proveedor
+        // roto (`x-preview-f-free`) en un dato sobre el criterio del modelo.
+        console.log(`vacío:    ${resultados.resumen.vacioPct}%  (el modelo no contestó; no cuentan como fantasma)`);
+    }
+    if (resultados.resumen.errorPct > 0) {
+        // Aparte de las cuatro métricas: un error (sin API key, red caída) no
+        // es "el modelo no editó", es "no lo sabemos". Mezclarlo con fantasma
+        // convertiría un fallo de autenticación en un dato sobre el modelo.
+        console.log(`error:    ${resultados.resumen.errorPct}%  (turnos que NO terminaron; no cuentan como fantasma)`);
+        // Y se dice POR QUÉ, aquí mismo. Antes el motivo solo estaba dentro del
+        // JSON de resultados: una ejecución con "error 100%" obligaba a abrir el
+        // fichero para descubrir que faltaba la credencial. Un medidor que dice
+        // que no midió tiene que decir qué se lo impidió, o el siguiente paso es
+        // adivinar. Se agrupan porque 40 casos dan 40 veces el mismo error.
+        const porMotivo = new Map();
+        for (const c of resultados.resultados) {
+            if (!c.error)
+                continue;
+            const primeraLinea = c.error.split("\n")[0].trim();
+            porMotivo.set(primeraLinea, (porMotivo.get(primeraLinea) ?? 0) + 1);
+        }
+        for (const [motivo, veces] of [...porMotivo].sort((a, b) => b[1] - a[1]).slice(0, 3)) {
+            console.log(`          ${veces}× ${motivo}`);
+        }
+    }
+    for (const [d, m] of Object.entries(resultados.resumen.porDificultad)) {
+        console.log(`  ${d}: tarea ${m.tareaOkPct}% / edición ${m.edicionOkPct}% (n=${m.total})`);
+    }
+    console.log(`Guardado en ${salida}`);
+}
+function runComparar(args) {
+    const [rutaA, rutaB] = args;
+    if (!rutaA || !rutaB) {
+        console.error("Uso: ada-cli banco comparar <resultadosA.json> <resultadosB.json>");
+        process.exitCode = 1;
+        return;
+    }
+    const a = cargarResultados(rutaA);
+    const b = cargarResultados(rutaB);
+    console.log(formatearComparacion(compararEjecuciones(a, b, rutaA, rutaB)));
+}
+/** Devuelve true si consumió los argumentos. */
+export async function runBancoCommand(args) {
+    if (args[0] !== "banco")
+        return false;
+    if (args.includes("--help") || args.includes("-h") || args.length === 1) {
+        console.log(AYUDA);
+        return true;
+    }
+    const sub = args[1];
+    const resto = args.slice(2);
+    if (sub === "generar") {
+        await runGenerar(resto);
+        return true;
+    }
+    if (sub === "run") {
+        await runRun(resto);
+        return true;
+    }
+    if (sub === "comparar") {
+        runComparar(resto);
+        return true;
+    }
+    console.error(`Subcomando desconocido: ${sub}\n`);
+    console.log(AYUDA);
+    process.exitCode = 1;
+    return true;
+}
+//# sourceMappingURL=banco-command.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * `ada-cli cleanse` — arregla en paralelo lo que ya reportan los
+ * comprobadores del proyecto (lint/typecheck/test), sin inventarse ninguno.
+ *
+ * La lógica vive en `core/limpieza/`: detección (comprobadores.ts), parseo
+ * (parseo.ts) y orquestación (reparacion.ts). Este fichero solo traduce
+ * argv ↔ texto, igual que `undo-command.ts` y `audit-command.ts`.
+ */
+/** Devuelve true si consumió los argumentos. */
+export declare function runCleanseCommand(args: string[], agentDir: string): Promise<boolean>;
+//# sourceMappingURL=cleanse-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanse-command.d.ts","sourceRoot":"","sources":["../../src/cli/cleanse-command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuBH,gDAAgD;AAChD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsF1F"}

package/dist/cli/cleanse-command.js

@@ -0,0 +1,104 @@
+/**
+ * `ada-cli cleanse` — arregla en paralelo lo que ya reportan los
+ * comprobadores del proyecto (lint/typecheck/test), sin inventarse ninguno.
+ *
+ * La lógica vive en `core/limpieza/`: detección (comprobadores.ts), parseo
+ * (parseo.ts) y orquestación (reparacion.ts). Este fichero solo traduce
+ * argv ↔ texto, igual que `undo-command.ts` y `audit-command.ts`.
+ */
+import { ejecutarCleanse } from "../core/limpieza/reparacion.js";
+const AYUDA = `Uso:
+  ada-cli cleanse [--dry-run] [--fix] [--concurrency N] [--model <provider/model>]
+
+Detecta los comprobadores YA configurados en el proyecto (scripts de
+package.json, tsconfig, biome/eslint, ruff, cargo clippy, go vet, gradle, maven) MIRANDO
+lo que hay — si no encuentra ninguno, lo dice con lo que ha mirado; no se
+inventa uno.
+
+Agrupa sus diagnósticos por fichero (diez problemas del mismo fichero son
+una lectura, no diez) y lanza un subagente por fichero en paralelo, bajo un
+tope de concurrencia. Cada arreglo se verifica RE-EJECUTANDO el comprobador
+que lo generó: se acepta solo si el diagnóstico desaparece y no aparece
+ninguno nuevo; si no, el fichero se revierte a como estaba.
+
+  --dry-run                   Enseña el plan (comprobadores, ficheros, conteos) sin tocar nada
+  --fix                       Permite que comprobadores mutadores reescriban ficheros (ej. cargo clippy --fix); por defecto NUNCA reescriben
+  --concurrency N              Tope de subagentes de reparación en paralelo (por defecto 4)
+  --model <provider/model>     Modelo de los subagentes; por defecto el más barato configurado`;
+/** Devuelve true si consumió los argumentos. */
+export async function runCleanseCommand(args, agentDir) {
+    if (args[0] !== "cleanse")
+        return false;
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(AYUDA);
+        return true;
+    }
+    const iConcurrencia = args.indexOf("--concurrency");
+    const concurrenciaTexto = iConcurrencia >= 0 ? args[iConcurrencia + 1] : undefined;
+    const concurrencia = concurrenciaTexto !== undefined ? Number(concurrenciaTexto) : undefined;
+    if (concurrencia !== undefined && (!Number.isInteger(concurrencia) || concurrencia <= 0)) {
+        console.error("--concurrency necesita un entero positivo.");
+        process.exitCode = 1;
+        return true;
+    }
+    const iModelo = args.indexOf("--model");
+    const modeloSpec = iModelo >= 0 ? args[iModelo + 1] : undefined;
+    const dryRun = args.includes("--dry-run");
+    const fix = args.includes("--fix");
+    const cwd = process.cwd();
+    // Carga perezosa: el subagente de producción trae el SDK entero, y
+    // `--dry-run`/`--help` no deberían pagar ese coste.
+    const { createSubagentSession } = await import("../core/workflows/subagent-host.js");
+    const resultado = await ejecutarCleanse(cwd, {
+        agentDir,
+        crearSesion: createSubagentSession,
+        modeloSpec,
+        concurrencia,
+        dryRun,
+        fix,
+        log: (linea) => console.log(linea),
+    });
+    if (resultado.estado === "sin_comprobadores") {
+        console.log("No se encontró ningún comprobador ejecutable. Se ha mirado en:");
+        for (const sitio of resultado.mirado)
+            console.log(`  - ${sitio}`);
+        process.exitCode = 1;
+        return true;
+    }
+    console.log(`Comprobadores: ${resultado.comprobadores.join(", ")}`);
+    for (const f of resultado.fallidos) {
+        console.log(`  aviso: ${f.etiqueta} no se pudo ejecutar (${f.motivo})`);
+    }
+    // Si TODOS los comprobadores detectados fallaron al ejecutarse, "0
+    // diagnósticos" no significa que el proyecto esté limpio — significa que
+    // no se pudo verificar nada. Decirlo como "Limpio" sería el fallo que se
+    // lee como éxito que este comando existe para evitar.
+    if (resultado.fallidos.length > 0 && resultado.fallidos.length === resultado.comprobadores.length) {
+        console.error("\nNingún comprobador pudo ejecutarse: no se ha verificado nada.");
+        process.exitCode = 1;
+        return true;
+    }
+    if (resultado.estado === "limpio" && resultado.grupos.length === 0) {
+        console.log("Limpio: ningún comprobador reportó diagnósticos.");
+        return true;
+    }
+    console.log(`${resultado.diagnosticosIniciales} diagnóstico${resultado.diagnosticosIniciales === 1 ? "" : "s"} en ${resultado.grupos.length} fichero(s):`);
+    for (const g of resultado.grupos) {
+        console.log(`  - ${g.ruta ?? "<proyecto>"}: ${g.diagnosticos.length}`);
+    }
+    if (dryRun) {
+        console.log("\n--dry-run: no se ha tocado nada.");
+        return true;
+    }
+    if (resultado.estado === "limpio") {
+        console.log("\nLimpio: todos los diagnósticos detectados se resolvieron y verificaron.");
+        return true;
+    }
+    console.error(`\nQuedan ${resultado.diagnosticosFinales} diagnóstico(s) sin resolver.`);
+    for (const r of resultado.reparaciones.filter((r) => !r.aceptado)) {
+        console.error(`  - ${r.ruta ?? "<proyecto>"}: ${r.motivo}`);
+    }
+    process.exitCode = 1;
+    return true;
+}
+//# sourceMappingURL=cleanse-command.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * `ada-cli commit` — pipeline AGÉNTICO (D08) con split-commit y CHANGELOG por
+ * paquete (D09). Cutover limpio del map-reduce single-shot anterior: no hay
+ * dos pipelines en convivencia (D14).
+ *
+ * Lee SIEMPRE el estado de índice (`git diff --cached`), no el árbol de
+ * trabajo: el mensaje tiene que describir lo que se va a commitear, y si
+ * describiera además lo que no está en el índice sería un mensaje falso desde
+ * el primer día.
+ *
+ * Y no commitea por su cuenta salvo `--hacer`. Por defecto imprime la
+ * propuesta por stdout y ya: así se puede canalizar (`ada-cli commit | git
+ * commit -F -`), revisar antes, o meterla en un editor. Un comando que escribe
+ * en la historia de git sin que se lo pidan se desinstala el primer día que se
+ * equivoca.
+ *
+ * LOS TRES ESTADOS, que aquí son códigos de salida distintos:
+ *   - índice vacío        → no hay nada que describir  (stderr, salida 1)
+ *   - el modelo falla     → no se ha podido describir  (stderr, salida 1)
+ *   - titular genérico    → se ha descrito mal         (stderr, salida 1)
+ * En los tres casos stdout queda VACÍO. Es lo que impide que un fallo se
+ * encadene a `git commit -F -` y acabe en la historia como si fuera un éxito.
+ */
+/** La primera línea con contenido de lo que git escupió por stderr. */
+export declare function primeraLineaDelFallo(error: unknown): string;
+export interface DependenciasCommit {
+    /** Llama al modelo. Debe LANZAR si falla; devolver "" cuenta como fallo. */
+    llamar: (sistema: string, usuario: string) => Promise<string>;
+    cwd?: string;
+}
+/** Devuelve true si consumió los argumentos. */
+export declare function runCommitCommand(args: string[], deps: DependenciasCommit): Promise<boolean>;
+//# sourceMappingURL=commit-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commit-command.d.ts","sourceRoot":"","sources":["../../src/cli/commit-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAiCH,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM3D;AAmBD,MAAM,WAAW,kBAAkB;IAClC,4EAA4E;IAC5E,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AACD,gDAAgD;AAChD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuHjG"}

package/dist/cli/commit-command.js

@@ -0,0 +1,190 @@
+/**
+ * `ada-cli commit` — pipeline AGÉNTICO (D08) con split-commit y CHANGELOG por
+ * paquete (D09). Cutover limpio del map-reduce single-shot anterior: no hay
+ * dos pipelines en convivencia (D14).
+ *
+ * Lee SIEMPRE el estado de índice (`git diff --cached`), no el árbol de
+ * trabajo: el mensaje tiene que describir lo que se va a commitear, y si
+ * describiera además lo que no está en el índice sería un mensaje falso desde
+ * el primer día.
+ *
+ * Y no commitea por su cuenta salvo `--hacer`. Por defecto imprime la
+ * propuesta por stdout y ya: así se puede canalizar (`ada-cli commit | git
+ * commit -F -`), revisar antes, o meterla en un editor. Un comando que escribe
+ * en la historia de git sin que se lo pidan se desinstala el primer día que se
+ * equivoca.
+ *
+ * LOS TRES ESTADOS, que aquí son códigos de salida distintos:
+ *   - índice vacío        → no hay nada que describir  (stderr, salida 1)
+ *   - el modelo falla     → no se ha podido describir  (stderr, salida 1)
+ *   - titular genérico    → se ha descrito mal         (stderr, salida 1)
+ * En los tres casos stdout queda VACÍO. Es lo que impide que un fallo se
+ * encadene a `git commit -F -` y acabe en la historia como si fuera un éxito.
+ */
+import { execFileSync } from "node:child_process";
+import { ErrorDeCommit, generarMensajeAgentic } from "../core/commits/agentic.js";
+import { aplicarEntradas, proponerEntradasChangelog } from "../core/commits/changelog.js";
+import { diffDelIndice } from "../core/commits/git.js";
+import { proponerCommitsSeparados } from "../core/commits/split.js";
+const AYUDA = `Uso:
+  ada-cli commit [--split] [--hacer] [--model <p/m>] [--detalle]
+
+Lee lo que hay EN EL ÍNDICE (git add) y genera el mensaje con una sesión
+agéntica: el modelo mira los diffs que necesita (diff_de_fichero), imita el
+estilo de los últimos commits (commits_recientes) y propone. La propuesta se
+valida CONTRA EL DIFF REAL: un fichero citado que no esté en el índice es un
+error estructurado que se le devuelve al modelo (hasta 3 recordatorios). Si al
+final no hay propuesta válida, sale un mensaje determinista desde el diff,
+marcado como degradación por stderr.
+
+  --split      Agrupa los ficheros por tema (paquete/ámbito) y propone UN
+               COMMIT POR GRUPO, cada uno con su mensaje validado, más las
+               entradas Keep-a-Changelog para el CHANGELOG.md más cercano a
+               cada grupo ([Unreleased], dedupe case-insensitive)
+  --hacer      Además de imprimirlo, lo ejecuta (con --split: reset del índice,
+               stage y commit por grupo, entradas de changelog incluidas)
+  --model      Usa un modelo concreto (proveedor/modelo)
+  --detalle    Escribe por stderr avisos de validación y ficheros omitidos
+
+Sin --hacer solo imprime. Se puede encadenar:  ada-cli commit | git commit -F -
+
+Sale con código 1 y stdout VACÍO si el índice está vacío o el modelo falla: un
+mensaje que no se ha podido generar no debe poder colarse en la historia.`;
+/** La primera línea con contenido de lo que git escupió por stderr. */
+export function primeraLineaDelFallo(error) {
+    const stderr = error?.stderr;
+    const texto = typeof stderr === "string" ? stderr : "";
+    const linea = texto.split("\n").find((l) => l.trim() !== "");
+    if (linea)
+        return linea.trim();
+    return (error instanceof Error ? error.message : String(error)).split("\n")[0].trim();
+}
+/** Ejecuta el stage+commit de un grupo del split. Devuelve el hash del commit. */
+function commitearGrupo(cwd, ficheros, changelogsTocados, mensaje) {
+    execFileSync("git", ["add", "--", ...ficheros, ...changelogsTocados], {
+        cwd,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    // El stdin tiene que ser PIPE: con "ignore", git lee su mensaje de
+    // /dev/null y aborta con «empty commit message» — el mensaje que le pasamos
+    // por `input` nunca llega.
+    return execFileSync("git", ["commit", "-F", "-"], {
+        cwd,
+        input: mensaje,
+        encoding: "utf8",
+        stdio: ["pipe", "pipe", "pipe"],
+    }).trim();
+}
+/** Devuelve true si consumió los argumentos. */
+export async function runCommitCommand(args, deps) {
+    if (args[0] !== "commit")
+        return false;
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(AYUDA);
+        return true;
+    }
+    const cwd = deps.cwd ?? process.cwd();
+    const hacer = args.includes("--hacer");
+    const partir = args.includes("--split");
+    const detalle = args.includes("--detalle");
+    let diff;
+    try {
+        diff = diffDelIndice(cwd);
+    }
+    catch (error) {
+        // «No he podido mirar» es un tercer estado: no es un índice vacío. Fuera
+        // de un repositorio git, decir "no hay nada en el índice" mandaría al
+        // usuario a hacer `git add` de algo que no tiene dónde añadirse.
+        console.error(`No se ha podido leer el índice de git: ${primeraLineaDelFallo(error)}`);
+        process.exitCode = 1;
+        return true;
+    }
+    if (diff.trim() === "") {
+        console.error("No hay nada en el índice. Añade lo que quieras commitear con `git add` y vuelve a intentarlo.");
+        process.exitCode = 1;
+        return true;
+    }
+    const agenticDeps = {
+        llamar: deps.llamar,
+        ejecutarGit: (argv) => execFileSync("git", ["-c", "core.quotepath=false", ...argv], {
+            cwd,
+            encoding: "utf8",
+            maxBuffer: 64 * 1024 * 1024,
+            stdio: ["ignore", "pipe", "pipe"],
+        }),
+    };
+    try {
+        if (!partir) {
+            const generada = await generarMensajeAgentic(diff, agenticDeps);
+            if (generada.usedFallback) {
+                console.error("AVISO: el modelo no dio una propuesta válida; mensaje determinista desde el diff (usedFallback).");
+            }
+            for (const aviso of generada.avisos)
+                console.error(`aviso [${aviso.codigo}]: ${aviso.detalle}`);
+            console.log(generada.mensaje);
+            if (hacer) {
+                try {
+                    execFileSync("git", ["commit", "-F", "-"], {
+                        cwd,
+                        input: generada.mensaje,
+                        stdio: ["pipe", "inherit", "inherit"],
+                    });
+                }
+                catch (error) {
+                    console.error(`El commit falló: ${error instanceof Error ? error.message : String(error)}`);
+                    process.exitCode = 1;
+                }
+            }
+            return true;
+        }
+        const propuestas = await proponerCommitsSeparados(diff, agenticDeps);
+        const entradasPorCommit = proponerEntradasChangelog(cwd, propuestas);
+        for (const p of propuestas) {
+            console.log(`--- ${p.tema} (${p.ficheros.length} fichero(s))${p.usedFallback ? " [usedFallback]" : ""}`);
+            console.log(p.mensaje);
+            if (detalle)
+                for (const aviso of p.avisos)
+                    console.error(`  aviso [${aviso.codigo}]: ${aviso.detalle}`);
+        }
+        console.log("--- CHANGELOG propuesto:");
+        for (const entrada of entradasPorCommit) {
+            console.log(`  ${entrada.destino}${entrada.crear ? " (nuevo)" : ""}\n    ${entrada.seccion}: ${entrada.linea}`);
+        }
+        if (!hacer)
+            return true;
+        // Ejecución atómica por grupo: primero las entradas de changelog (que van
+        // DENTRO de su commit), luego reset del índice y stage+commit por grupo.
+        const tocados = aplicarEntradas(cwd, entradasPorCommit);
+        const relativos = (absoluto) => absoluto.startsWith(`${cwd}/`) ? absoluto.slice(cwd.length + 1) : absoluto;
+        execFileSync("git", ["reset"], { cwd, stdio: ["ignore", "ignore", "pipe"] });
+        let hechos = 0;
+        for (let i = 0; i < propuestas.length; i++) {
+            const p = propuestas[i];
+            const changelogs = entradasPorCommit[i] && tocados.includes(entradasPorCommit[i].destino)
+                ? [relativos(entradasPorCommit[i].destino)]
+                : [];
+            const hash = commitearGrupo(cwd, p.ficheros, changelogs, p.mensaje);
+            hechos++;
+            console.error(`  commit ${p.tema}: ${hash.split("\n")[0]}`);
+        }
+        const residual = execFileSync("git", ["diff", "--cached", "--name-only"], { cwd, encoding: "utf8" }).trim();
+        if (residual !== "") {
+            console.error(`Quedó STAGED sin commitear:\n${residual}`);
+            process.exitCode = 1;
+        }
+        console.error(`${hechos} commit(s) creados.`);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof ErrorDeCommit && error.causa === "diff-vacio") {
+            console.error("No hay nada en el índice. Añade lo que quieras commitear con `git add` y vuelve a intentarlo.");
+        }
+        else {
+            console.error(`No se ha podido generar la propuesta. El índice sigue intacto.\n${error instanceof Error ? error.message : String(error)}`);
+        }
+        process.exitCode = 1;
+        return true;
+    }
+}
+//# sourceMappingURL=commit-command.js.map

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

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

package/dist/cli/completion.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generador de completions para bash/zsh/fish.
+ *
+ * Patrón de omp `cli/completion-gen.ts:164`: descriptores declarativos +
+ * `__complete <kind>` dinámico. Cada flag nuevo que se añada al descriptor
+ * se propaga a las completions sin tocar el generador.
+ *
+ * Uso:
+ *   ada-cli completion bash >> ~/.bashrc
+ *   ada-cli completion zsh  >> ~/.zshrc
+ *   ada-cli __complete models  → lista tab-separada de modelos disponibles
+ */
+export type Shell = "bash" | "zsh" | "fish";
+export interface CompletionSpec {
+    bin: string;
+    commands: string[];
+    flags: string[];
+}
+export declare function generateCompletion(shell: Shell, spec?: CompletionSpec): string;
+//# sourceMappingURL=completion.d.ts.map

package/dist/cli/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/cli/completion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAkBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,cAAqB,GAAG,MAAM,CAiDpF"}