pull-request-split-advisor 3.1.2

package/LICENSE

@@ -0,0 +1,52 @@
+LICENCIA FREEWARE
+
+Copyright (c) 2026 Felix Junior Chacaliaza Gutierrez
+Contacto: felixchacaliaza@outlook.com
+
+Todos los derechos reservados.
+
+Este software y su documentación asociada (el "Software") son propiedad
+exclusiva de Felix Junior Chacaliaza Gutierrez.
+
+USO PERMITIDO
+
+Se concede permiso, de forma gratuita, a cualquier persona que obtenga una
+copia de este Software, para utilizarlo con fines personales, educativos o
+de uso interno en organizaciones, sujeto a las siguientes condiciones:
+
+  1. El aviso de copyright anterior y este aviso de permiso deben incluirse
+     en todas las copias o partes sustanciales del Software.
+
+RESTRICCIONES
+
+Las siguientes acciones están estrictamente prohibidas sin el consentimiento
+previo y por escrito del titular de los derechos:
+
+  1. MODIFICACIÓN — Queda prohibido alterar, adaptar, traducir o crear obras
+     derivadas basadas en el Software.
+
+  2. REDISTRIBUCIÓN — Queda prohibido copiar, distribuir, sublicenciar,
+     publicar o poner a disposición de terceros el Software, ya sea en su
+     forma original o modificada.
+
+  3. EXPLOTACIÓN COMERCIAL — Queda prohibido vender, alquilar, arrendar o
+     comercializar de cualquier forma el Software o cualquier parte del mismo.
+
+  4. INGENIERÍA INVERSA — Queda prohibido realizar ingeniería inversa,
+     desensamblar o descompilar el Software.
+
+  5. ELIMINACIÓN DE AVISOS — Queda prohibido eliminar o modificar cualquier
+     aviso de copyright, marca registrada u otro aviso de propiedad incluido
+     en el Software.
+
+Para solicitar autorización para cualquier uso no contemplado en esta
+licencia, contacte al titular en: felixchacaliaza@outlook.com
+
+DESCARGO DE RESPONSABILIDAD
+
+EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA
+O IMPLÍCITA, INCLUYENDO PERO NO LIMITADO A LAS GARANTÍAS DE COMERCIABILIDAD,
+IDONEIDAD PARA UN FIN DETERMINADO Y NO INFRACCIÓN. EN NINGÚN CASO EL TITULAR
+DE LOS DERECHOS SERÁ RESPONSABLE DE NINGUNA RECLAMACIÓN, DAÑO U OTRA
+RESPONSABILIDAD, YA SEA EN UNA ACCIÓN CONTRACTUAL, EXTRACONTRACTUAL O DE
+OTRO TIPO, QUE SURJA DE, O ESTÉ RELACIONADA CON EL SOFTWARE O SU USO.

package/README.md

@@ -0,0 +1,168 @@
+# Pull Request Split Advisor
+
+<p align="center">
+  <strong>Análisis estático de cambios Git para una división óptima en Pull Requests.</strong>
+</p>
+
+<p align="center">
+  <img alt="npm version" src="https://img.shields.io/npm/v/pull-request-split-advisor" />
+  <img alt="npm downloads" src="https://img.shields.io/npm/dm/pull-request-split-advisor" />
+  <img alt="Node.js ≥ 18" src="https://img.shields.io/badge/node-%E2%89%A518-brightgreen" />
+  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.x-blue" />
+  <img alt="Tests" src="https://img.shields.io/badge/tests-199%20passed-brightgreen" />
+  <img alt="License" src="https://img.shields.io/badge/license-Freeware-blue" />
+</p>
+
+---
+
+## Descripción
+
+`pr-split-advisor` examina los archivos modificados en la rama de trabajo respecto a la rama base, los agrupa en bloques semánticos mediante análisis heurístico de dependencias y calcula la distribución óptima en ramas y commits para maximizar la revisabilidad de cada Pull Request.
+
+A partir de la **v2.0.0**, la herramienta puede también **aplicar el plan directamente** en el repositorio: crea las ramas derivadas en cascada (*stacked branches*), realiza los commits con los archivos asignados y opcionalmente publica las ramas en el remoto. Si algo falla en mitad del proceso, ejecuta un rollback automático que deja el repositorio en el estado inicial.
+
+A partir de la **v3.0.0**, se incorpora una **capa de IA opcional** que enriquece los planes generados heurísticamente mediante un registro extensible de proveedores (`PROVIDER_REGISTRY`). Los prompts incluyen ejemplos few-shot y contexto de módulos para maximizar la calidad de las sugerencias. Proveedores disponibles: [Groq](https://console.groq.com) (Llama 3.3 70B, free tier) y **GitHub Copilot** (usa automáticamente las credenciales de `gh` CLI / VS Code, sin token adicional).
+
+La capa de IA ofrece tres puntos de enriquecimiento: **mejora de mensajes de commit** (subjects semánticos con imperative mood), **mejora de slugs de rama** (kebab-case descriptivo orientado al negocio) y **rebalanceo del plan** (redistribución de archivos entre commits y ramas por cohesión semántica — `features.planRebalance`). El rebalanceo es opt-in y está desactivado por defecto; cuando se activa, la IA recibe el plan completo y propone movimientos que pasan una validación estricta antes de aplicarse.
+
+La v3.0.0 también mejora el **apply**: rama de respaldo con snapshot completo del working tree, re-prompt en nombres duplicados en lugar de rollback, y nomenclatura de ramas con mayúsculas en la descripción (p. ej. `feature/TEAM-123-PRUEBA-IA`). Si la IA no está configurada o falla en cualquier punto, la herramienta continúa en modo heurístico sin interrupciones.
+
+A partir de la **v3.1.0**, el proyecto incluye una **suite completa de tests** (Vitest, 199 tests, 12 suites) que cubre todos los módulos core, AI, git y configuración con mocks de dependencias externas (git, fs). A partir de la **v3.1.1**, el proveedor `copilot` solo puede activarse dentro de **Visual Studio Code** — fuera del IDE se emite un aviso y se desactiva automáticamente sin interrumpir el análisis.
+
+---
+
+## Características principales
+
+- Detección automática de archivos modificados, creados, eliminados y renombrados
+- Agrupación semántica por dependencias, módulo y tipo de cambio
+- Cálculo de score de calidad por rama (0–5) con factores ponderados
+- Generación de nombres de rama y mensajes de commit convencionales
+- Reporte HTML interactivo exportado automáticamente (8 secciones: hero ejecutivo, resumen de cambios, TOC con barras de score, detalle de archivos, dependencias, bloques, plan de commits con línea de tiempo y comandos git listos para ejecutar) — ver [formato completo](docs/FEATURES.md#reporte-html-interactivo)
+- Exportación del plan en formato JSON para integraciones externas
+- Historial de scores con seguimiento entre análisis
+- Validaciones de nomenclatura de ramas y estado del working tree
+- **`--apply`**: aplicación del plan en git con ramas apiladas (*stacked branches*) y rollback automático ante fallos
+- **Capa de IA multi-proveedor** (v3.0.0+): tres niveles de enriquecimiento — mensajes de commit semánticos, slugs de rama orientados al negocio y **rebalanceo del plan** (redistribución de archivos entre commits y ramas por cohesión semántica) — soporta Groq (Llama 3.3 70B, free tier) y GitHub Copilot (sin token adicional, usa credenciales de VS Code / `gh` CLI) — sin configuración funciona en modo heurístico puro
+
+Consulte [docs/FEATURES.md](docs/FEATURES.md) para la descripción detallada de cada característica.
+
+---
+
+## Instalación
+
+```bash
+# Instalación global (recomendado)
+npm install -g pull-request-split-advisor
+
+# Como dependencia de desarrollo
+npm install --save-dev pull-request-split-advisor
+```
+
+Al instalar se genera automáticamente `pr-split-advisor.config.json` en la raíz del proyecto con todos los parámetros y sus valores por defecto. Si el archivo ya existe, no se sobreescribe.
+
+---
+
+## Uso rápido
+
+```bash
+# Analizar: al finalizar pregunta si deseas aplicar el plan (crear ramas y commits)
+pr-split-advisor
+
+# Saltarse la pregunta y aplicar el plan directamente
+pr-split-advisor --apply
+
+# Especificar rama base de forma explícita
+pr-split-advisor --base develop
+
+# Consultar historial de análisis anteriores
+pr-split-advisor --stats
+
+# Configurar la capa de IA interactivamente
+pr-split-advisor config
+```
+
+Consulte [docs/USAGE.md](docs/USAGE.md) para la referencia completa de comandos, opciones y configuración.
+
+---
+
+## Configuración
+
+`pr-split-advisor.config.json` en la raíz del proyecto:
+
+```jsonc
+{
+  "targetScore": 4,                // Score mínimo aceptable (0–5)
+  "baseBranch": "master",          // Rama base para el análisis
+  "maxFilesPerCommit": 8,          // Máximo de archivos por commit
+  "maxLinesPerCommitIdeal": 120,   // Líneas ideales por commit
+  "idealLinesPerPR": 99,           // Líneas ideales por PR
+  "largeFileThreshold": 400,       // Umbral para marcar archivos grandes
+  "maxCommitsPerBranchIdeal": 2,   // Commits ideales por rama
+  "hardMaxCommitsPerBranch": 4,    // Límite absoluto de commits por rama
+  "exportJson": true,              // Exportar plan a pr-split-plan.json
+  "verbose": false,                // Mostrar logs de diagnóstico
+
+  // ── Capa de IA (v3.0.0+ — opcional) ───────────────────────────────────────────────
+  // Si "enabled" es false o no hay credenciales, se usa el modo heurístico puro.
+  // Proveedores disponibles: "groq", "copilot"
+  // Nota: "copilot" solo funciona dentro de Visual Studio Code.
+  // Configura interactivamente con: pr-split-advisor config
+  "ai": {
+    "enabled": false,
+    "provider": "groq",              // "groq" | "copilot" (copilot: solo en VS Code)
+    "model": "llama-3.3-70b-versatile",
+    "apiKey": "",                    // API key literal (solo para "groq")
+    "features": {
+      "commitMessages": true,        // Mejorar subjects de commit (habilitado automáticamente)
+      "branchDescriptions": true,    // Mejorar slugs de nombre de rama (habilitado automáticamente)
+      "planRebalance": false         // Redistribuir archivos entre commits y ramas (opt-in)
+    },
+    "timeoutMs": 15000,
+    "maxTokens": 1024
+  }
+}
+```
+
+Configura el proveedor de IA con el asistente interactivo:
+
+```bash
+pr-split-advisor config
+```
+
+**Groq** (free tier, [console.groq.com](https://console.groq.com)) — la API key se guarda en `pr-split-advisor.config.json` mediante el wizard:
+```bash
+pr-split-advisor config
+```
+
+**GitHub Copilot** (sin token adicional — usa credenciales de VS Code / `gh` CLI):
+> ⚠️ El proveedor `copilot` solo está disponible dentro de **Visual Studio Code**. Fuera del IDE, la herramienta lo desactiva automáticamente y continúa en modo heurístico. Usa `groq` para entornos de CI/CD o terminal independiente.
+```bash
+# Solo requiere tener gh autenticado:
+gh auth login
+# Y suscripción activa a GitHub Copilot en tu cuenta GitHub
+```
+
+---
+
+## Requisitos
+
+| Requisito | Versión mínima |
+|-----------|---------------|
+| Node.js | ≥ 18 |
+| Git | Cualquier versión moderna en `PATH` |
+| Repositorio | Con rama base accesible en el remoto |
+
+---
+
+## Licencia
+
+© 2026 Felix Junior Chacaliaza Gutierrez — [felixchacaliaza@outlook.com](mailto:felixchacaliaza@outlook.com)
+
+Este software se distribuye bajo los términos de una **licencia freeware**:
+
+- ✅ Uso personal, educativo e interno permitido de forma gratuita
+- ❌ Modificación o creación de obras derivadas no permitida
+- ❌ Redistribución o publicación no permitida
+- ❌ Uso comercial o venta no permitidos
+
+Para cualquier uso no contemplado, contacte al autor. Consulte el archivo [LICENSE](LICENSE) para los términos completos.

package/dist/ai/config-wizard.js

@@ -0,0 +1,282 @@
+/**
+ * config-wizard.ts — Asistente interactivo para configurar pr-split-advisor.
+ *
+ * Invocado mediante el subcomando `pr-split-advisor config`.
+ * No requiere estar en un repositorio git.
+ *
+ * ### Flujo del asistente
+ * ```
+ * 1. Detectar si existe pr-split-advisor.config.json en el directorio actual.
+ * 2. Leer la configuración actual (o empezar desde cero).
+ * 3. Mostrar resumen del estado actual de IA.
+ * 4. Preguntar si se quiere habilitar / desactivar / actualizar la IA.
+ * 5. Recoger: proveedor, modelo, método de API key, features.
+ * 6. Escribir la sección `ai` actualizada en el archivo de configuración.
+ * ```
+ *
+ * ### Comportamiento con archivos inexistentes
+ * Si `pr-split-advisor.config.json` no existe en el CWD, el asistente crea
+ * un archivo nuevo con la sección `ai` configurada (útil en proyectos donde
+ * el postinstall no pudo crear el archivo).
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { execSync } from "node:child_process";
+import { ui } from "../output/ui.js";
+import { PROVIDER_REGISTRY, callAI } from "./provider.js";
+// ---------------------------------------------------------------------------
+// Constantes
+// ---------------------------------------------------------------------------
+const CONFIG_FILE = "pr-split-advisor.config.json";
+// ---------------------------------------------------------------------------
+// Lectura y escritura del archivo de configuración
+// ---------------------------------------------------------------------------
+function readConfigFile(configPath) {
+    if (!existsSync(configPath))
+        return {};
+    try {
+        return JSON.parse(readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function writeConfigFile(configPath, config) {
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+// ---------------------------------------------------------------------------
+// Validación de API key
+// ---------------------------------------------------------------------------
+/**
+ * Realiza una llamada mínima al proveedor para verificar que la API key es válida.
+ * Devuelve `null` si la conexión fue exitosa, o el mensaje de error en caso contrario.
+ */
+async function testApiKeyConnection(provider, model, apiKey, apiKeyEnvVar) {
+    // Construimos solo los campos que callAI realmente consume (config.ai)
+    const testConfig = {
+        ai: {
+            enabled: true,
+            provider,
+            model,
+            apiKey,
+            apiKeyEnvVar,
+            features: { commitMessages: false, branchDescriptions: false },
+            timeoutMs: 10000,
+            maxTokens: 16,
+        },
+    };
+    try {
+        await callAI([{ role: "user", content: "Reply with a json object: {\"ok\":true}" }], testConfig);
+        return null;
+    }
+    catch (err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers de display
+// ---------------------------------------------------------------------------
+function displayCurrentState(ai) {
+    ui.section("ESTADO ACTUAL DE LA CONFIGURACION IA", "#");
+    if (!ai || !ai.enabled) {
+        ui.warn("La IA NO está habilitada. Se utiliza el modo heurístico.");
+    }
+    else {
+        const providerDesc = PROVIDER_REGISTRY.get(ai.provider ?? "groq");
+        ui.ok("La IA está HABILITADA.");
+        ui.kv("Proveedor", providerDesc?.label ?? (ai.provider ?? "groq"));
+        ui.kv("Modelo", ai.model ?? providerDesc?.defaultModel ?? "llama-3.3-70b-versatile");
+        if (ai.provider === "copilot") {
+            ui.kv("Autenticación", "gh CLI automático (cuenta de VS Code)");
+        }
+        else {
+            ui.kv("API Key", ai.apiKey ? "*** (guardada en config)" : "no configurada");
+        }
+        ui.kv("Mensajes de commit con IA", ai.features?.commitMessages ? "Sí" : "No");
+        ui.kv("Descripciones de rama con IA", ai.features?.branchDescriptions ? "Sí" : "No");
+    }
+}
+// ---------------------------------------------------------------------------
+// Asistente principal
+// ---------------------------------------------------------------------------
+/**
+ * Ejecuta el asistente de configuración de forma interactiva.
+ * Escribe los cambios en `pr-split-advisor.config.json` del directorio actual.
+ */
+export async function runConfigWizard() {
+    const configPath = resolve(process.cwd(), CONFIG_FILE);
+    ui.section("ASISTENTE DE CONFIGURACION — pr-split-advisor", "#");
+    ui.info(existsSync(configPath)
+        ? `Archivo de configuración detectado: ${configPath}`
+        : `No se encontró ${CONFIG_FILE} — se creará uno nuevo.`);
+    const raw = readConfigFile(configPath);
+    const currentAi = (raw["ai"] ?? {});
+    displayCurrentState(currentAi);
+    // ── Paso 1: decisión según estado actual ─────────────────────────────────
+    if (currentAi.enabled) {
+        // IA ya configurada: preguntar si desea cambiar de proveedor
+        const changeProvider = await ui.confirm("¿Deseas cambiar de proveedor de IA?");
+        if (!changeProvider) {
+            ui.info("Sin cambios. La IA continúa activa con la configuración actual.");
+            return;
+        }
+    }
+    else {
+        // IA no configurada: preguntar si desea habilitarla
+        const enableAi = await ui.confirm("¿Habilitar la capa de IA para enriquecer los planes de PR?");
+        if (!enableAi) {
+            ui.info("Sin cambios. La herramienta continuará en modo heurístico.");
+            return;
+        }
+    }
+    // ── Paso 2: proveedor ────────────────────────────────────────────────────
+    ui.section("PROVEEDOR DE IA", "─");
+    ui.muted("  1. Groq (Llama 3.3 70B)  — API key gratuita en console.groq.com");
+    ui.muted("  2. GitHub Copilot        — usa tu cuenta de VS Code automáticamente");
+    const currentIsGroq = (currentAi.provider ?? "groq") !== "copilot";
+    const providerChoice = await ui.prompt("Elige proveedor (1 o 2)", currentIsGroq ? "1" : "2");
+    const provider = providerChoice.trim() === "2" ? "copilot" : "groq";
+    const providerDesc = PROVIDER_REGISTRY.get(provider);
+    ui.ok(`Proveedor: ${providerDesc.label}`);
+    // ── Paso 3: credenciales ─────────────────────────────────────────────────
+    let apiKey = "";
+    if (provider === "copilot") {
+        ui.section("AUTENTICACION COPILOT", "─");
+        ui.ok("GitHub Copilot usa tu cuenta de VS Code / gh CLI automáticamente.");
+        ui.info("No necesitas configurar ningún token adicional.");
+        try {
+            const ghToken = execSync("gh auth token", {
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"],
+            }).trim();
+            if (ghToken) {
+                ui.ok(`Cuenta de GitHub detectada (•••${ghToken.slice(-6)}).`);
+            }
+            else {
+                ui.error("gh CLI no tiene sesión activa — sin token no es posible usar GitHub Copilot.\n" +
+                    "Autentícate ejecutando: gh auth login\n" +
+                    "La configuración de IA no se ha guardado.");
+                return;
+            }
+        }
+        catch {
+            ui.error("gh CLI no está instalado o no responde.\n" +
+                "Instálalo desde https://cli.github.com y ejecuta: gh auth login\n" +
+                "La configuración de IA no se ha guardado.");
+            return;
+        }
+    }
+    else {
+        // Groq: solo pedir la key directamente
+        ui.section("API KEY DE GROQ", "─");
+        ui.info("Obtén tu API key gratuita en: https://console.groq.com");
+        const entered = await ui.prompt("Ingresa tu API key de Groq (Enter para cancelar)", "");
+        apiKey = entered.trim();
+        if (!apiKey) {
+            ui.error("No ingresaste una API key — sin ella no es posible usar Groq.\n" +
+                "Obtén una gratis en: https://console.groq.com\n" +
+                "La configuración de IA no se ha guardado.");
+            return;
+        }
+        ui.info("Verificando conexión con Groq…");
+        const connError = await testApiKeyConnection(provider, providerDesc.defaultModel, apiKey, "");
+        if (connError) {
+            ui.error(`La API key fue rechazada por Groq.\n` +
+                `Causa: ${connError}\n` +
+                `Verifica la key en https://console.groq.com\n` +
+                `La configuración de IA no se ha guardado.`);
+            return;
+        }
+        ui.ok("Conexión verificada correctamente.");
+    }
+    // ── Paso 4: escribir configuración ──────────────────────────────────────
+    const newAiConfig = {
+        enabled: true,
+        provider,
+        model: providerDesc.defaultModel,
+        apiKey,
+        apiKeyEnvVar: "",
+        features: { commitMessages: true, branchDescriptions: true, planRebalance: false },
+        timeoutMs: currentAi.timeoutMs ?? 15000,
+        maxTokens: currentAi.maxTokens ?? 1024,
+    };
+    raw["ai"] = newAiConfig;
+    writeConfigFile(configPath, raw);
+    ui.section("CONFIGURACION GUARDADA", "#");
+    ui.ok(`Archivo actualizado: ${configPath}`);
+    ui.kv("Proveedor", providerDesc.label);
+    ui.kv("Modelo", providerDesc.defaultModel);
+    if (provider === "copilot") {
+        ui.kv("Autenticación", "gh CLI automático (cuenta VS Code)");
+    }
+    else {
+        ui.kv("API Key", "*** (guardada en config)");
+        ui.warn(`La API key queda en texto plano en ${CONFIG_FILE}. Añádelo a .gitignore si el repo es público.`);
+    }
+    ui.kv("Mensajes de commit con IA", "Sí (automático)");
+    ui.kv("Descripciones de rama con IA", "Sí (automático)");
+    ui.info("\nPara verificar la integración ejecuta el análisis en un repositorio git:\n" +
+        "  pr-split-advisor");
+}
+// ---------------------------------------------------------------------------
+// Configuración rápida con API key directa (--api-key)
+// ---------------------------------------------------------------------------
+/**
+ * Configura pr-split-advisor con una API key pasada directamente, sin wizard interactivo.
+ *
+ * Valida la key contra el proveedor antes de guardar. Si falla, aborta con error.
+ *
+ * @param apiKey   - La API key del proveedor (literal, no nombre de env var).
+ * @param provider - ID del proveedor: "groq" | "github" | "copilot". Predeterminado: "groq".
+ */
+export async function runConfigWithKey(apiKey, provider = "groq") {
+    const configPath = resolve(process.cwd(), CONFIG_FILE);
+    const providerDesc = PROVIDER_REGISTRY.get(provider);
+    if (!providerDesc) {
+        ui.error(`Proveedor desconocido: "${provider}".\n` +
+            `Proveedores disponibles: groq, copilot`);
+        return;
+    }
+    const model = providerDesc.defaultModel;
+    ui.section("CONFIGURACION RAPIDA — pr-split-advisor", "#");
+    ui.kv("Proveedor", `${providerDesc.label} (${provider})`);
+    ui.kv("Modelo", model);
+    ui.kv("API Key", `${apiKey.slice(0, 8)}${"*".repeat(Math.max(0, apiKey.length - 8))}`);
+    ui.info("Verificando conexión con el proveedor…");
+    const connError = await testApiKeyConnection(provider, model, apiKey, "");
+    if (connError) {
+        ui.error(`La API key fue rechazada por ${providerDesc.label}.\n` +
+            `Causa: ${connError}\n` +
+            `Verifica que la key es correcta y vuelve a intentarlo.\n` +
+            `La configuración de IA no se ha guardado.`);
+        return;
+    }
+    ui.ok("Conexión verificada correctamente.");
+    const raw = readConfigFile(configPath);
+    const currentAi = (raw["ai"] ?? {});
+    const newAiConfig = {
+        enabled: true,
+        provider,
+        model,
+        apiKey,
+        apiKeyEnvVar: providerDesc.defaultApiKeyEnvVar,
+        features: {
+            commitMessages: currentAi.features?.commitMessages ?? true,
+            branchDescriptions: currentAi.features?.branchDescriptions ?? true,
+            planRebalance: currentAi.features?.planRebalance ?? false,
+        },
+        timeoutMs: currentAi.timeoutMs ?? 15000,
+        maxTokens: currentAi.maxTokens ?? 1024,
+    };
+    raw["ai"] = newAiConfig;
+    writeConfigFile(configPath, raw);
+    ui.section("CONFIGURACION GUARDADA", "#");
+    ui.ok(`Archivo actualizado: ${configPath}`);
+    ui.kv("Proveedor", `${providerDesc.label} (${provider})`);
+    ui.kv("Modelo", model);
+    ui.kv("API Key", "*** (literal en config)");
+    ui.kv("Mensajes de commit con IA", newAiConfig.features.commitMessages ? "Sí" : "No");
+    ui.kv("Descripciones de rama con IA", newAiConfig.features.branchDescriptions ? "Sí" : "No");
+    ui.warn("La API key está guardada en texto plano en el archivo de configuración.\n" +
+        `Añade ${CONFIG_FILE} a tu .gitignore si el proyecto es público.`);
+}