pull-request-split-advisor 3.1.2

package/dist/git/executor.js

@@ -0,0 +1,378 @@
+/**
+ * executor.ts — Aplicación del plan de ramas y commits al repositorio git.
+ *
+ * ### Modelo: stacked branches
+ * Cada rama se crea desde la punta (HEAD) de la rama anterior, heredando
+ * todos sus commits y añadiendo los propios. El flujo es:
+ *
+ * ```
+ * 1. sourceBranch          → añade commits del existingBasePlan
+ * 2. derived-1  (from tip de sourceBranch)  → añade commits propios
+ * 3. derived-2  (from tip de derived-1)     → hereda todo + añade commits propios
+ * 4. volver a sourceBranch y limpiar staged
+ * ```
+ *
+ * ### Rollback
+ * Si cualquier paso falla:
+ * 1. `git checkout sourceBranch`
+ * 2. `git reset --hard <sha-original>` — deshace commits parciales en sourceBranch
+ * 3. `git clean -fd` — limpia working tree (incluyendo archivos untracked del plan)
+ * 4. `git branch -D` de cada rama derivada ya creada
+ */
+import { addFiles, branchExists, commit as gitCommit, detectRemote, getCurrentBranch, pushBranch, q, run, shSafe } from "./git.js";
+import { ui } from "../output/ui.js";
+// Centinela que indica que la rama de respaldo no pudo crearse en esta ejecución.
+const BACKUP_FAILED = null;
+/**
+ * Elimina una rama local de forma segura, capturando el error si falla
+ * (ej. la rama ya fue eliminada manualmente).
+ *
+ * @param branchName - Nombre de la rama a eliminar.
+ */
+function deleteBranch(branchName) {
+    try {
+        run(`git branch -D ${q(branchName)}`);
+    }
+    catch {
+        ui.warn(`No se pudo eliminar la rama ${branchName} durante el rollback.`);
+    }
+}
+/**
+ * Deshace todas las ramas creadas durante un `applyPlan` fallido.
+ *
+ * Pasos del rollback:
+ * 1. Vuelve a `sourceBranch` con `git checkout`.
+ * 2. `git reset --hard <originalHeadSha>` — deshace cualquier commit parcial
+ *    que PASO 1 hubiera hecho en sourceBranch antes del fallo.
+ * 3. Limpia el working tree y el index (`git clean -fd` incluye archivos untracked).
+ * 4. Elimina con `git branch -D` cada rama derivada ya creada.
+ *
+ * @param createdBranches  - Nombres de ramas derivadas ya creadas.
+ * @param sourceBranch     - Rama origen a la que volver.
+ * @param originalHeadSha  - SHA del HEAD de sourceBranch antes de empezar.
+ */
+function rollback(createdBranches, sourceBranch, originalHeadSha) {
+    ui.section("ROLLBACK TOTAL", "#");
+    ui.warn(`Algo fallo. Restaurando el repositorio a la rama origen '${sourceBranch}'...`);
+    try {
+        run(`git checkout ${q(sourceBranch)}`);
+        run(`git reset --hard ${q(originalHeadSha)}`);
+        run("git restore --staged .");
+        run("git clean -fd");
+        ui.ok(`Repositorio restaurado correctamente a '${sourceBranch}' (SHA: ${originalHeadSha.slice(0, 7)}).`);
+    }
+    catch {
+        ui.warn("No se pudo restaurar el working tree completamente. Revisalo manualmente.");
+    }
+    if (createdBranches.length) {
+        ui.warn(`Eliminando ${createdBranches.length} rama(s) creadas durante el proceso...`);
+        for (const branch of createdBranches) {
+            deleteBranch(branch);
+            ui.muted(`  Rama eliminada: ${branch}`);
+        }
+    }
+    ui.ok("Rollback completado. El repositorio queda exactamente como al inicio.");
+}
+/**
+ * Crea una nueva rama local desde la posición actual del HEAD.
+ * En el modelo apilado cada rama se crea desde la punta de la anterior,
+ * por lo que no es necesario hacer checkout antes de llamar a esta función.
+ *
+ * @throws {Error} Si la rama ya existe localmente.
+ */
+function createBranchFromSource(targetBranch) {
+    if (branchExists(targetBranch)) {
+        throw new Error(`La rama destino ya existe: ${targetBranch}. Elíminala o usa otro nombre antes de ejecutar apply.`);
+    }
+    run(`git checkout -b ${q(targetBranch)}`);
+}
+/**
+ * Crea una rama de respaldo con un commit que captura todo el working tree
+ * (archivos modificados + no rastreados) tal como estaba antes del apply.
+ *
+ * ### Estrategia: git plumbing sin checkout
+ * Usamos `git write-tree` / `git commit-tree` para crear el objeto commit
+ * directamente en el object store, sin cambiar HEAD ni la rama activa.
+ * Así el working tree queda intacto para el apply que viene después.
+ *
+ * Pasos:
+ * 1. `git add -A`             → stagea toda la copia de trabajo
+ * 2. `git write-tree`         → crea un objeto tree desde el index → hash
+ * 3. `git commit-tree`        → crea el commit con ese tree → hash
+ * 4. `git branch <name> <sha>`→ apunta la rama de respaldo al nuevo commit
+ * 5. `git restore --staged .` → devuelve el index a HEAD (working tree sin cambios)
+ *
+ * La rama NO se incluye en `createdBranches`, por lo que el rollback
+ * automático nunca la elimina — es exactamente el punto de restauración.
+ *
+ * Formato del nombre: `<sourceBranch>-backup-<YYYY-MM-DDTHH-mm-ss>`
+ *
+ * @param sourceBranch    - Nombre de la rama origen.
+ * @param originalHeadSha - SHA del HEAD antes del apply.
+ * @returns El nombre de la rama de respaldo creada, o `null` si no pudo crearse.
+ */
+async function createBackupBranch(sourceBranch, originalHeadSha) {
+    // El nombre mantiene el prefijo de tipo (feature/, fix/, etc.) y añade
+    // "-backup-<timestamp>" al final para agruparse junto a la rama origen.
+    const iso = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+    const backupName = `${sourceBranch}-backup-${iso}`;
+    ui.section("RAMA DE RESPALDO", "#");
+    try {
+        // Paso 1: stagear toda la copia de trabajo (tracked + untracked)
+        run("git add -A");
+        // Paso 2: construir el objeto tree desde el index actual
+        const treeHash = shSafe("git write-tree").trim();
+        if (!treeHash)
+            throw new Error("git write-tree no devolvió un hash válido.");
+        // Paso 3: crear el objeto commit (sin modificar HEAD ni la rama activa)
+        const isoMsg = new Date().toISOString();
+        const commitMsg = `chore(backup): snapshot of working tree before apply (${isoMsg})`;
+        const backupCommitHash = shSafe(`git commit-tree ${q(treeHash)} -p ${q(originalHeadSha)} -m ${q(commitMsg)}`).trim();
+        if (!backupCommitHash)
+            throw new Error("git commit-tree no devolvió un hash válido.");
+        // Paso 4: apuntar la nueva rama al commit de respaldo
+        run(`git branch ${q(backupName)} ${q(backupCommitHash)}`);
+        // Paso 5: destagear todo → index vuelve a HEAD, working tree sin cambios
+        run("git restore --staged .");
+        ui.ok(`Rama de respaldo creada: '${backupName}'`);
+        ui.muted(`  Commit de respaldo: ${backupCommitHash.slice(0, 7)} — snapshot completo del working tree`);
+    }
+    catch (err) {
+        // Asegurarse de limpiar el index si algo falló a mitad
+        try {
+            run("git restore --staged .");
+        }
+        catch { /* ignorar */ }
+        ui.warn(`No se pudo crear la rama de respaldo '${backupName}': ${err.message}`);
+        ui.warn("Continuando sin respaldo.");
+        return BACKUP_FAILED;
+    }
+    // Intentar publicar en remoto (no bloqueante)
+    const remote = detectRemote(sourceBranch);
+    try {
+        run(`git push ${q(remote)} ${q(backupName)}`);
+        ui.ok(`Respaldo publicado en '${remote}'.`);
+    }
+    catch {
+        ui.warn(`No se pudo publicar el respaldo en '${remote}'. Queda disponible localmente.`);
+    }
+    ui.info("Para recuperar archivos o commits desde el respaldo:");
+    ui.muted(`  git checkout ${q(backupName)} -- <archivo>  → restaurar un archivo concreto`);
+    ui.muted(`  git diff ${q(backupName)}                   → ver qué cambió`);
+    ui.muted(`  git cherry-pick <sha>                       → traer un commit específico`);
+    return backupName;
+}
+/**
+ * Construye el mensaje del commit para una posición específica del plan.
+ *
+ * Usa `commit.suggestedMessage` si está disponible (lo estará siempre en el
+ * flujo normal). El fallback es código defensivo para planes construidos
+ * externamente sin pasar por `buildCommitPlan`.
+ *
+ * @param plan        - Plan de rama que contiene el array de commits.
+ * @param commitIndex - Índice base-0 dentro de `plan.commitPlan`.
+ */
+function buildCommitMessage(plan, commitIndex) {
+    const commit = plan.commitPlan[commitIndex];
+    if (commit?.suggestedMessage) {
+        return commit.suggestedMessage;
+    }
+    return `chore(split): ${plan.name} commit ${commitIndex + 1}`;
+}
+// ---------------------------------------------------------------------------
+// apply
+// ---------------------------------------------------------------------------
+/**
+ * Aplica el plan de ramas al repositorio git.
+ *
+ * Siempre muestra prompts para el nombre de cada rama y el mensaje de cada
+ * commit. Presionar Enter acepta el valor sugerido.
+ *
+ * ### Flujo
+ * 1. Commits del existingBasePlan directamente en sourceBranch.
+ * 2. Ramas derivadas en cascada (stacked): cada una hereda la anterior.
+ * 3. Volver a sourceBranch y limpiar el index.
+ * 4. Preguntar si publicar en remoto.
+ *
+ * Si cualquier paso falla: rollback automático (`git reset --hard <sha>`).
+ *
+ * @param plans  - Lista de planes devuelta por `findBestPlan`.
+ * @param config - Configuración activa (usado para mostrar contexto de nomenclatura).
+ */
+export async function applyPlan(plans, config) {
+    const sourceBranch = getCurrentBranch();
+    const existingBasePlan = plans.find((plan) => plan.isExistingBaseBranch);
+    const derivedPlans = plans.filter((plan) => !plan.isExistingBaseBranch);
+    ui.section("APLICANDO PLAN", "#");
+    ui.kv("Rama origen", sourceBranch);
+    if (config.branchNamingContext) {
+        ui.kv("Tipo de rama", config.branchNamingContext.branchType);
+        ui.kv("Código de equipo", config.branchNamingContext.teamCode);
+        ui.kv("Número de historia", config.branchNamingContext.storyNumber);
+    }
+    if (existingBasePlan) {
+        ui.info(`La rama base existente se usara como PR inicial: ${existingBasePlan.name}`);
+    }
+    // Si no hay ramas derivadas que crear: la rama actual ya es suficientemente buena
+    if (derivedPlans.length === 0) {
+        ui.section("ANALISIS DE CALIDAD", "#");
+        if (existingBasePlan) {
+            const score = existingBasePlan.score?.toFixed(2) ?? "—";
+            const recommendation = existingBasePlan.recommendation ?? "";
+            ui.ok(`La rama '${sourceBranch}' tiene buena calidad y no necesita dividirse.`);
+            ui.kv("Puntaje obtenido", `${score} / 5.00`);
+            if (recommendation) {
+                ui.info(recommendation);
+            }
+        }
+        else {
+            ui.ok(`La rama '${sourceBranch}' ya es suficiente para un solo PR.`);
+        }
+        return;
+    }
+    ui.info(`Se crearán ${derivedPlans.length} ramas derivadas desde '${sourceBranch}'.`);
+    ui.info("Personaliza el nombre de cada rama y el mensaje de cada commit.");
+    ui.muted("  Presiona Enter para aceptar el valor sugerido.");
+    const createdBranches = [];
+    // Conjunto de nombres ya reservados en esta sesión (incluye la rama origen
+    // y las ramas derivadas confirmadas). Permite detectar duplicados ANTES de
+    // llamar a createBranchFromSource y evitar el rollback por colisión.
+    const reservedNames = new Set([sourceBranch]);
+    // Guardar SHA antes de tocar nada — usado en rollback para deshacer
+    // cualquier commit parcial que se haya hecho en sourceBranch (PASO 1).
+    // Si el comando falla (repo vacío u otro estado inválido) lanzamos un error
+    // inmediato: continuar sin el SHA haría que el rollback NO pueda deshacer
+    // los commits ya hechos en sourceBranch (git reset --hard HEAD no retrocede).
+    const rawSha = shSafe("git rev-parse HEAD").trim();
+    if (!rawSha) {
+        throw new Error("No se pudo obtener el SHA del HEAD actual. " +
+            "Asegúrate de que el repositorio tenga al menos un commit antes de ejecutar apply.");
+    }
+    const originalHeadSha = rawSha;
+    // Crear rama de respaldo ANTES del bloque try para que el rollback nunca la elimine.
+    // Es el punto de recuperación si el plan cambia de alcance o algo falla inesperadamente.
+    // Puede ser null si la creación falló (ya se imprimió un aviso).
+    const backupBranchName = await createBackupBranch(sourceBranch, originalHeadSha);
+    try {
+        // ── PASO 1: Commitear los archivos de la rama base original ────────────────
+        // Los archivos están en el working tree como cambios unstaged.
+        // Los commitamos directamente en sourceBranch.
+        if (existingBasePlan && existingBasePlan.commitPlan.length > 0) {
+            ui.section(`RAMA BASE: ${sourceBranch}`, "#");
+            ui.info("Aplicando commits de la rama base original...");
+            for (let i = 0; i < existingBasePlan.commitPlan.length; i++) {
+                const commit = existingBasePlan.commitPlan[i];
+                let commitMessage = buildCommitMessage(existingBasePlan, i);
+                commitMessage = await ui.prompt(`  Commit ${commit.index} — mensaje`, commitMessage);
+                ui.subsection(`Commit ${commit.index}`);
+                ui.muted(`Mensaje: ${commitMessage}`);
+                ui.fileList(commit.files, 100);
+                addFiles(commit.files);
+                // Bug fix 4: si git add fue no-op (archivos ya commiteados por aheadCount > 0)
+                // no hay nada staged y git commit fallaría. Omitir el commit y avisar.
+                const staged = shSafe("git diff --cached --name-only").trim();
+                if (!staged) {
+                    ui.warn(`  Commit ${commit.index} omitido: ningún archivo del commit tiene cambios en el working tree (puede que ya estén commiteados).`);
+                    continue;
+                }
+                gitCommit(commitMessage);
+            }
+            ui.ok(`Rama base '${sourceBranch}' lista.`);
+        }
+        // ── PASO 2: Crear ramas derivadas en cascada (stacked branches) ───────────
+        for (const plan of derivedPlans) {
+            const totalAssigned = plan.commitPlan.flatMap(c => c.files).length;
+            // Bug fix 3: mostrar el prompt ANTES de ui.section para que el header
+            // refleje el nombre FINAL elegido por el usuario, no el sugerido.
+            ui.muted(`\n  Rama sugerida: ${plan.name}  (${totalAssigned} archivos asignados)`);
+            let targetBranch = await ui.prompt("Nombre de la rama", plan.name);
+            // Validar unicidad: re-pedir si el nombre ya está reservado en esta sesión
+            // o ya existe como rama local. Evita el crash y rollback por colisión.
+            while (reservedNames.has(targetBranch) || branchExists(targetBranch)) {
+                if (reservedNames.has(targetBranch)) {
+                    ui.warn(`El nombre '${targetBranch}' ya fue usado para otra rama en este apply. Elige un nombre diferente.`);
+                }
+                else {
+                    ui.warn(`La rama local '${targetBranch}' ya existe. Elíminala primero o elige otro nombre.`);
+                }
+                targetBranch = await ui.prompt("Nombre de la rama", `${targetBranch}-2`);
+            }
+            reservedNames.add(targetBranch);
+            ui.section(`RAMA: ${targetBranch}`, "#");
+            // Crear la rama desde el HEAD actual (punta de la rama anterior).
+            // No hacemos checkout ni reset: los archivos del working tree permanecen.
+            createBranchFromSource(targetBranch);
+            createdBranches.push(targetBranch);
+            for (let i = 0; i < plan.commitPlan.length; i++) {
+                const commit = plan.commitPlan[i];
+                let commitMessage = buildCommitMessage(plan, i);
+                commitMessage = await ui.prompt(`  Commit ${commit.index} — mensaje`, commitMessage);
+                ui.subsection(`Commit ${commit.index}`);
+                ui.muted(`Mensaje: ${commitMessage}`);
+                ui.fileList(commit.files, 100);
+                addFiles(commit.files);
+                // Bug fix 4: misma guardia que en PASO 1 — evita git commit vacío.
+                const staged = shSafe("git diff --cached --name-only").trim();
+                if (!staged) {
+                    ui.warn(`  Commit ${commit.index} omitido: ningún archivo tiene cambios en el working tree.`);
+                    continue;
+                }
+                gitCommit(commitMessage);
+            }
+            ui.ok(`Rama lista: ${targetBranch}`);
+        }
+        // ── PASO 3: Volver a la rama origen y liberar el index ──────────────────
+        // NO se llama git clean -fd aquí (éxito): evita borrar archivos del usuario
+        // que no forman parte del plan y que git checkout no toca.
+        // Solo se limpia el index por si algo quedó staged sin commitear.
+        run(`git checkout ${q(sourceBranch)}`);
+        run("git restore --staged .");
+        // ── PASO 4: Preguntar si publicar en remoto ────────────────────────────
+        const allCreated = [
+            ...(existingBasePlan ? [sourceBranch] : []),
+            ...createdBranches,
+        ];
+        if (allCreated.length) {
+            const remote = detectRemote(sourceBranch);
+            ui.info(`Ramas listas para PR:`);
+            for (const branch of allCreated) {
+                ui.muted(`  • ${branch}`);
+            }
+            const publish = await ui.confirm(`¿Deseas publicar las ${allCreated.length} rama(s) en '${remote}'?`);
+            if (publish) {
+                ui.section("PUBLICANDO RAMAS EN REMOTO", "#");
+                for (const branch of allCreated) {
+                    ui.muted(`  → ${branch}`);
+                    try {
+                        pushBranch(branch, remote);
+                        ui.ok(`${branch} publicada correctamente.`);
+                    }
+                    catch (pushErr) {
+                        ui.warn(`No se pudo publicar ${branch}: ${pushErr.message}`);
+                    }
+                }
+            }
+            else {
+                ui.warn("Ramas no publicadas. Puedes publicarlas después con:  git push <remoto> <rama>");
+            }
+        }
+        ui.ok("Apply finalizado.");
+    }
+    catch (err) {
+        ui.error(`Error durante apply: ${err.message}`);
+        rollback(createdBranches, sourceBranch, originalHeadSha);
+        // Bug fix 2: solo mostrar instrucciones de recuperación si el backup
+        // fue realmente creado en esta ejecución (no null).
+        if (backupBranchName) {
+            ui.info(`Rama de respaldo disponible: '${backupBranchName}'`);
+            ui.muted(`  Para inspeccionar el estado anterior al apply:`);
+            ui.muted(`    git checkout ${q(backupBranchName)}`);
+            ui.muted(`  Para recuperar un archivo específico:`);
+            ui.muted(`    git checkout ${q(backupBranchName)} -- <archivo>`);
+        }
+        else {
+            ui.warn("No hay rama de respaldo disponible. Verifica el estado del repositorio manualmente.");
+        }
+        throw err;
+    }
+}

package/dist/git/git.js

@@ -0,0 +1,239 @@
+/**
+ * git.ts — Capa de abstracción sobre los comandos git de bajo nivel.
+ *
+ * Este módulo es el único punto del proyecto que ejecuta procesos git directamente.
+ * Todos los demás módulos (executor.ts, file-stats.ts, dependency.ts, etc.)
+ * deben pasar por aquí, lo que facilita:
+ * - el testeo (solo hay un lugar donde mockear `execSync`)
+ * - el manejo uniforme de errores
+ *
+ * ### Funciones exportadas
+ * - `q`                 — escapa un valor para usarlo dentro de comillas en shell
+ * - `shSafe`            — ejecuta un comando y devuelve `""` si falla (no lanza)
+ * - `run`               — ejecuta un comando con `stdio: inherit`
+ * - `requireGitRepo`    — falla si el directorio actual no es un repositorio git
+ * - `requireCleanIndex` — falla si hay cambios staged sin commitear
+ * - `getCurrentBranch`  — devuelve el nombre de la rama activa
+ * - `branchExists`      — comprueba si una rama local existe
+ * - `addFiles`          — hace `git add` de una lista de archivos
+ * - `commit`            — hace `git commit` con un mensaje dado
+ */
+import { execSync } from "node:child_process";
+/**
+ * Escapa un valor para usarlo de forma segura dentro de comillas dobles en
+ * una cadena de comando shell. Escapa: `"`, `\`, `$`, `` ` ``.
+ *
+ * **¿Por qué no usar `shell: true` directamente?** Porque nombres de rama o
+ * rutas con espacios, dólares o comillas rompergían el comando sin este escaping.
+ *
+ * @param value - Cadena a escapar (nombre de rama, ruta de archivo, mensaje de commit…).
+ * @returns     La cadena envuelta en comillas dobles con caracteres especiales escapados.
+ */
+export function q(value) {
+    return `"${value.replace(/(["\\$`])/g, "\\$1")}"`;
+}
+/** Ejecuta un comando shell y devuelve su salida (sin trailing newline). Lanza excepción si el proceso retorna código ≠ 0. */
+function sh(cmd) {
+    return execSync(cmd, {
+        encoding: "utf8",
+        stdio: ["pipe", "pipe", "ignore"]
+    }).trim();
+}
+/**
+ * Como {@link sh} pero devuelve `""` en lugar de lanzar excepción si el comando falla.
+ *
+ * Usar en consultas git que pueden fallar legítimamente (ej. el repositorio
+ * no existe todavía, el archivo no está en el HEAD, etc.). El parámetro `verbose`
+ * permite escribir el error a stderr para depuración.
+ *
+ * @param cmd     - Comando shell a ejecutar.
+ * @param options - `verbose: true` escribe el error a stderr en lugar de silenciarlo.
+ */
+export function shSafe(cmd, { verbose = false } = {}) {
+    try {
+        return sh(cmd);
+    }
+    catch (err) {
+        if (verbose) {
+            process.stderr.write(`[git warn] command failed: ${cmd}\n${err.message}\n`);
+        }
+        return "";
+    }
+}
+/**
+ * Ejecuta un comando shell con `stdio: "inherit"` para que la salida del proceso
+ * hijo sea visible directamente en la terminal.
+ *
+ * A diferencia de `sh`, esta función se usa para comandos que modifican estado
+ * (checkout, commit, restore, etc.) donde la visibilidad de la salida es importante.
+ *
+ * @param cmd - Comando shell a ejecutar.
+ */
+export function run(cmd) {
+    execSync(cmd, { stdio: "inherit" });
+}
+/**
+ * Verifica que el directorio actual sea un repositorio git válido.
+ * Lanza un `Error` con mensaje en español si no lo es.
+ * Debe llamarse al comienzo de la ejecución del CLI para evitar errores
+ * crípticos más adelante.
+ */
+export function requireGitRepo() {
+    const res = shSafe("git rev-parse --is-inside-work-tree");
+    if (res !== "true") {
+        throw new Error("Este directorio no es un repositorio git.");
+    }
+}
+/**
+ * Verifica que el índice git esté limpio (sin cambios staged).
+ *
+ * La herramienta trabaja con el working tree, no con el índice. Si hay cambios
+ * staged al iniciar, el flujo de `git restore --source` y `git add` puede
+ * sobrescribirlos silenciosamente. Esta guardia lo previene.
+ *
+ * Lanza un `Error` si hay cambios staged pendientes.
+ */
+export function requireCleanIndex() {
+    try {
+        execSync("git diff --cached --quiet");
+    }
+    catch {
+        throw new Error("Tienes cambios staged en el index. Limpia el index antes de ejecutar.");
+    }
+}
+/**
+ * Devuelve el nombre de la rama activa en el repositorio.
+ * Equivale a `git rev-parse --abbrev-ref HEAD`.
+ *
+ * @throws {Error} Si el comando falla (repositorio vacío, HEAD detached, etc.).
+ */
+export function getCurrentBranch() {
+    return sh("git rev-parse --abbrev-ref HEAD");
+}
+/**
+ * Comprueba si una rama local con el nombre dado existe en el repositorio.
+ *
+ * Usa `git show-ref` en lugar de `git branch --list` para ser más rápido
+ * (no necesita listar todas las ramas, solo verificar la ref específica).
+ *
+ * @param name - Nombre de la rama a verificar (sin `refs/heads/`).
+ * @returns    `true` si la rama existe localmente, `false` en caso contrario.
+ */
+export function branchExists(name) {
+    try {
+        execSync(`git show-ref --verify --quiet ${q(`refs/heads/${name}`)}`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Añade los archivos indicados al índice con `git add`.
+ *
+ * Si la lista está vacía, no ejecuta ningún comando (guarda un proceso git).
+ * Cada ruta se escapa con {@link q} para soportar nombres con espacios o
+ * caracteres especiales.
+ *
+ * @param files - Rutas relativas de los archivos a añadir al índice.
+ */
+export function addFiles(files) {
+    if (!files.length)
+        return;
+    const quoted = files.map((f) => q(f)).join(" ");
+    run(`git add -- ${quoted}`);
+}
+/**
+ * Crea un commit con el mensaje dado.
+ *
+ * El mensaje se escapa con {@link q} para soportar comillas, saltos de línea
+ * y caracteres especiales en el cuerpo del commit.
+ *
+ * @param message - Mensaje del commit (idealmente en formato Conventional Commits).
+ */
+export function commit(message) {
+    run(`git commit -m ${q(message)}`);
+}
+// ─── v2.0.11 — Funciones de remoto ──────────────────────────────────────────────
+/**
+ * Hace `git fetch <remote> <branch> --quiet`, actualizando la ref de tracking
+ * remota (`refs/remotes/<remote>/<branch>`) sin emitir salida normal.
+ *
+ * Puede lanzar una excepción si no hay red o si el remoto no existe;
+ * el llamador debe capturarla si quiere un comportamiento degradado.
+ *
+ * @param remote - Nombre del remoto (ej. `"origin"`).
+ * @param branch - Nombre de la rama a actualizar.
+ */
+export function fetchQuiet(remote, branch) {
+    run(`git fetch ${q(remote)} ${q(branch)} --quiet`);
+}
+/**
+ * Devuelve `true` si la ref de tracking `refs/remotes/<remote>/<branch>`
+ * existe en el repo local (indica que la rama existe en el remoto y fue
+ * descargada en algún momento).
+ *
+ * @param branch - Nombre de la rama remota.
+ * @param remote - Nombre del remoto (ej. `"origin"`).
+ */
+export function remoteTrackingExists(branch, remote) {
+    return shSafe(`git rev-parse --verify ${q(`refs/remotes/${remote}/${branch}`)}`).length > 0;
+}
+/**
+ * Devuelve cuántos commits tiene la rama remota que la local NO tiene.
+ * Un valor > 0 indica que la rama local está desactualizada (detrás del remoto).
+ *
+ * @param branch - Nombre de la rama local/remota.
+ * @param remote - Nombre del remoto (ej. `"origin"`).
+ * @returns Número de commits pendientes de `git pull`, o 0 si está al día.
+ */
+export function localBehindCount(branch, remote) {
+    const count = shSafe(`git rev-list ${q(branch)}..${q(`${remote}/${branch}`)} --count`);
+    return parseInt(count, 10) || 0;
+}
+/**
+ * Detecta el nombre del remoto configurado para la rama indicada.
+ *
+ * Orden de resolución:
+ * 1. Upstream tracking de la rama: `git rev-parse --abbrev-ref --symbolic-full-name <branch>@{u}`
+ *    devuelve p.ej. `origin/feature/ABC-123` → toma la primera parte antes de `/`.
+ * 2. Primer remoto listado por `git remote`.
+ * 3. Fallback: `"origin"`.
+ *
+ * @param branch - Nombre de la rama cuyo upstream se consulta.
+ * @returns Nombre del remoto detectado.
+ */
+export function detectRemote(branch) {
+    const upstream = shSafe(`git rev-parse --abbrev-ref --symbolic-full-name ${q(`${branch}@{u}`)}`);
+    if (upstream) {
+        const remote = upstream.split("/")[0].trim();
+        if (remote && remote !== upstream)
+            return remote;
+    }
+    const firstRemote = shSafe("git remote").split("\n")[0].trim();
+    if (firstRemote)
+        return firstRemote;
+    return "origin";
+}
+/**
+ * Devuelve cuántos commits tiene la rama actual (HEAD) que `baseBranch` NO tiene.
+ * Un valor > 0 indica que la rama ya tiene commits propios respecto a la base.
+ *
+ * @param baseBranch - Rama base del PR (ej. `"master"`, `"main"`).
+ * @returns Número de commits adelantados en HEAD, o 0 si está al mismo nivel.
+ */
+export function localAheadCount(baseBranch) {
+    const count = shSafe(`git rev-list ${q(baseBranch)}..HEAD --count`);
+    return parseInt(count, 10) || 0;
+}
+/**
+ * Hace push de una rama local al remoto indicado.
+ *
+ * @param branch - Nombre de la rama local a publicar.
+ * @param remote - Nombre del remoto destino (ej. `"origin"`).
+ */
+export function pushBranch(branch, remote) {
+    // --set-upstream configura el tracking para que `git push` sin argumentos
+    // funcione correctamente en usos posteriores de la rama.
+    run(`git push --set-upstream ${q(remote)} ${q(branch)}`);
+}

package/dist/output/report-styles.generated.js

@@ -0,0 +1,10 @@
+/**
+ * ⚠️  ARCHIVO GENERADO AUTOMÁTICAMENTE — NO EDITAR MANUALMENTE.
+ *
+ * Generado por:  scripts/compile-styles.cjs
+ * Fuente SCSS:   src/output/report.scss
+ *
+ * Para aplicar cambios editá `src/output/report.scss` y ejecutá:
+ *   npm run build:styles
+ */
+export const reportStyles = `@import"https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap";:root{--bg: #f0f4f8;--surface: #ffffff;--surface-soft: #f7f9fc;--border: #dde3ed;--text: #1e293b;--muted: #64748b;--green: #15803d;--green-soft: #dcfce7;--green-border: #86efac;--yellow: #a16207;--yellow-soft: #fef3c7;--yellow-border: #fde68a;--orange: #c2410c;--orange-soft: #ffedd5;--orange-border: #fdba74;--red: #b91c1c;--red-soft: #fee2e2;--red-border: #fca5a5;--blue: #1d4ed8;--blue-soft: #dbeafe;--blue-border: #93c5fd;--purple: #6d28d9;--purple-soft: #ede9fe;--shadow-sm: 0 1px 3px rgba(15, 23, 42, 0.07), 0 1px 2px rgba(15, 23, 42, 0.05);--shadow: 0 4px 16px rgba(15, 23, 42, 0.08), 0 1px 3px rgba(15, 23, 42, 0.05);--shadow-lg: 0 10px 40px rgba(15, 23, 42, 0.12), 0 2px 8px rgba(15, 23, 42, 0.06);--radius: 14px;--radius-sm: 8px}*,*::before,*::after{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;padding:0;background:var(--bg);color:var(--text);font-family:"Inter",-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;font-size:15px;line-height:1.6}.container{max-width:1320px;margin:0 auto;padding:32px 24px 80px}.hero{background:linear-gradient(135deg, #0f172a 0%, #1e3a6e 50%, #1d4ed8 100%);color:#fff;border-radius:24px;padding:36px 36px 28px;box-shadow:var(--shadow-lg);margin-bottom:28px;position:relative;overflow:hidden}.hero::before{content:"";position:absolute;inset:0;background:url("data:image/svg+xml,%3Csvg width='60' height='60' viewBox='0 0 60 60' xmlns='http://www.w3.org/2000/svg'%3E%3Cg fill='none' fill-rule='evenodd'%3E%3Cg fill='%23ffffff' fill-opacity='0.03'%3E%3Cpath d='M36 34v-4h-2v4h-4v2h4v4h2v-4h4v-2h-4zm0-30V0h-2v4h-4v2h4v4h2V6h4V4h-4zM6 34v-4H4v4H0v2h4v4h2v-4h4v-2H6zM6 4V0H4v4H0v2h4v4h2V6h4V4H6z'/%3E%3C/g%3E%3C/g%3E%3C/svg%3E");pointer-events:none}.hero-top{display:flex;align-items:flex-start;justify-content:space-between;gap:20px;flex-wrap:wrap}.hero-title-area h1{margin:0 0 6px;font-size:34px;font-weight:800;letter-spacing:-0.5px;line-height:1.1}.hero-title-area p{margin:0;color:hsla(0,0%,100%,.75);font-size:14px;max-width:500px}.hero-timestamp{background:hsla(0,0%,100%,.12);border:1px solid hsla(0,0%,100%,.2);border-radius:10px;padding:8px 14px;font-size:12px;color:hsla(0,0%,100%,.85);white-space:nowrap}.hero-grid{margin-top:24px;display:grid;grid-template-columns:repeat(auto-fit, minmax(200px, 1fr));gap:12px}.hero-item{background:hsla(0,0%,100%,.11);border:1px solid hsla(0,0%,100%,.16);border-radius:14px;padding:14px 18px;backdrop-filter:blur(4px);transition:background .2s}.hero-item:hover{background:hsla(0,0%,100%,.17)}.hero-item .label{font-size:11px;text-transform:uppercase;letter-spacing:.08em;opacity:.7;margin-bottom:5px}.hero-item .value{font-size:17px;font-weight:700;word-break:break-word}.disclaimer-banner{display:flex;align-items:flex-start;gap:16px;margin:24px 0 0;padding:20px 24px;background:#fefce8;border:2px solid #f59e0b;border-radius:12px;box-shadow:0 2px 8px rgba(245,158,11,.18)}.disclaimer-banner .disclaimer-icon{font-size:32px;line-height:1;flex-shrink:0;margin-top:2px}.disclaimer-banner .disclaimer-body{flex:1;color:#78350f}.disclaimer-banner .disclaimer-body strong:first-child{display:block;font-size:15px;font-weight:800;letter-spacing:.5px;text-transform:uppercase;color:#92400e;margin-bottom:8px}.disclaimer-banner .disclaimer-body p{margin:0 0 8px;font-size:14px;line-height:1.6}.disclaimer-banner .disclaimer-body p:last-child{margin-bottom:0}.disclaimer-banner .disclaimer-body ul{margin:6px 0 10px 18px;padding:0;font-size:14px;line-height:1.7}.disclaimer-banner .disclaimer-body .disclaimer-footer{font-size:12px;font-style:italic;color:#a16207;margin-top:8px}.section{margin-top:36px}.section-heading{display:flex;align-items:center;gap:10px;margin:0 0 16px;font-size:20px;font-weight:700;color:#0f172a}.section-heading::after{content:"";flex:1;height:1px;background:var(--border)}.summary-grid{display:grid;grid-template-columns:repeat(auto-fit, minmax(190px, 1fr));gap:12px}.stat-card{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:16px 18px;box-shadow:var(--shadow-sm);display:flex;flex-direction:column;gap:4px;transition:box-shadow .2s,transform .2s}.stat-card:hover{box-shadow:var(--shadow);transform:translateY(-1px)}.stat-card .label{font-size:12px;color:var(--muted);font-weight:500;text-transform:uppercase;letter-spacing:.04em}.stat-card .value{font-size:26px;font-weight:800;line-height:1.2}.stat-card .sub{font-size:12px;color:var(--muted)}.stat-card.blue .value{color:var(--blue)}.stat-card.green .value{color:var(--green)}.stat-card.yellow .value{color:var(--yellow)}.stat-card.red .value{color:var(--red)}.stat-card.purple .value{color:var(--purple)}.card{background:var(--surface);border:1px solid var(--border);border-radius:18px;padding:22px;box-shadow:var(--shadow);margin-bottom:20px}.badges{display:flex;flex-wrap:wrap;gap:8px}.badge{display:inline-flex;align-items:center;gap:5px;padding:5px 12px;border-radius:999px;font-size:11px;font-weight:700;letter-spacing:.06em;text-transform:uppercase;border:1px solid rgba(0,0,0,0)}.badge.green{background:var(--green-soft);color:var(--green);border-color:var(--green-border)}.badge.yellow{background:var(--yellow-soft);color:var(--yellow);border-color:var(--yellow-border)}.badge.orange{background:var(--orange-soft);color:var(--orange);border-color:var(--orange-border)}.badge.red{background:var(--red-soft);color:var(--red);border-color:var(--red-border)}.badge.blue{background:var(--blue-soft);color:var(--blue);border-color:var(--blue-border)}.badge.purple{background:var(--purple-soft);color:var(--purple);border-color:#c4b5fd}table{width:100%;border-collapse:collapse;background:var(--surface);border:1px solid var(--border);border-radius:14px;overflow:hidden;box-shadow:var(--shadow-sm);margin:10px 0 20px}table thead th{background:#f1f5fd;color:#374151;font-size:12px;font-weight:700;text-transform:uppercase;letter-spacing:.04em;text-align:left;padding:11px 14px;border-bottom:1px solid var(--border)}table tbody td{padding:10px 14px;border-bottom:1px solid #e9eff7;vertical-align:middle;font-size:13px}table tbody tr:last-child td{border-bottom:none}table tbody tr:nth-child(even){background:#fafbff}table tbody tr:hover{background:#f0f6ff}.num-cell{text-align:right;font-variant-numeric:tabular-nums;font-weight:600}code{background:#eef2ff;color:#312e81;padding:2px 7px;border-radius:6px;font-size:12px;font-family:"SF Mono","Fira Code","Cascadia Code",monospace;word-break:break-word}.muted{color:var(--muted);font-size:13px}.toc-box{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:16px 20px;box-shadow:var(--shadow-sm);margin-bottom:20px}.toc-title{font-size:13px;font-weight:700;color:var(--muted);text-transform:uppercase;letter-spacing:.06em;margin-bottom:10px}.toc-list{list-style:none;margin:0;padding:0;display:flex;flex-wrap:wrap;gap:6px}.toc-link{display:inline-flex;align-items:center;gap:6px;padding:6px 12px;border-radius:999px;font-size:12px;font-weight:600;text-decoration:none;border:1px solid rgba(0,0,0,0);transition:opacity .15s}.toc-link:hover{opacity:.8;text-decoration:none}.toc-ok{background:var(--green-soft);color:var(--green);border-color:var(--green-border)}.toc-warn{background:var(--yellow-soft);color:var(--yellow);border-color:var(--yellow-border)}.toc-bad{background:var(--red-soft);color:var(--red);border-color:var(--red-border)}.toc-score{background:rgba(0,0,0,.08);border-radius:999px;padding:1px 7px;font-size:11px;font-weight:800}.plan-card{border-radius:20px;overflow:hidden;box-shadow:var(--shadow);border:1px solid var(--border);margin-bottom:28px}.plan-card-header{display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:16px;padding:22px 26px}.plan-card-body{background:var(--surface);padding:22px 26px}.plan-header-green{background:linear-gradient(135deg, #f0fdf4 0%, #dcfce7 100%);border-bottom:1px solid #86efac}.plan-header-yellow{background:linear-gradient(135deg, #fffbeb 0%, #fef3c7 100%);border-bottom:1px solid #fde68a}.plan-header-red{background:linear-gradient(135deg, #fff1f2 0%, #fee2e2 100%);border-bottom:1px solid #fca5a5}.plan-header-left{display:flex;align-items:center;gap:14px}.plan-branch-icon{font-size:28px;width:48px;height:48px;display:flex;align-items:center;justify-content:center;background:rgba(0,0,0,.06);border-radius:14px;flex-shrink:0}.plan-branch-name{font-size:17px;font-weight:800;color:#0f172a;word-break:break-all;display:flex;align-items:center;gap:8px;flex-wrap:wrap}.plan-branch-sub{font-size:13px;color:var(--muted);margin-top:2px}.existing-badge{display:inline-block;background:#dbeafe;color:#1e40af;border:1px solid #93c5fd;padding:1px 8px;border-radius:999px;font-size:11px;font-weight:700;margin-right:4px}.plan-header-right{display:flex;flex-direction:column;align-items:center;gap:4px}.gauge-svg{display:block}.plan-score-label{font-size:11px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.score-label-green{color:var(--green)}.score-label-yellow{color:var(--yellow)}.score-label-red{color:var(--red)}.kpi-row{display:flex;flex-wrap:wrap;gap:12px;margin:16px 0 24px}.kpi{background:var(--surface-soft);border:1px solid var(--border);border-radius:12px;padding:10px 16px;min-width:90px;text-align:center}.kpi-v{font-size:22px;font-weight:800;color:#0f172a;line-height:1.1}.kpi-k{font-size:11px;color:var(--muted);margin-top:3px;text-transform:uppercase;letter-spacing:.04em}.recommendation-box{display:flex;align-items:flex-start;gap:10px;background:#f0f9ff;border:1px solid #bae6fd;border-radius:12px;padding:12px 16px;margin-bottom:16px;font-size:14px;color:#0369a1}.exclusion-note{display:flex;align-items:flex-start;gap:8px;background:#fffbeb;border:1px solid #fde68a;border-radius:10px;padding:10px 14px;margin-bottom:16px;font-size:13px;color:#92400e}.rec-icon{font-size:16px;flex-shrink:0}.section-title{font-size:14px;font-weight:700;color:#0f172a;margin:28px 0 10px;display:flex;align-items:center;gap:6px}.metrics-table thead th{background:#f8faff}.metric-code{background:#e0e7ff;color:#3730a3;font-weight:700}.metric-label{font-size:13px}.metric-value{font-weight:600;color:#374151}.metric-weight{font-weight:600;color:var(--muted)}.metric-contrib{font-weight:700;color:#0f172a;font-variant-numeric:tabular-nums}.pts-bar-wrap{height:6px;background:#e2e8f0;border-radius:999px;overflow:hidden;width:80px;display:inline-block;vertical-align:middle;margin-right:6px}.pts-bar{height:100%;border-radius:999px;transition:width .4s ease}.pts-good{color:var(--green);font-weight:700}.pts-warn{color:var(--yellow);font-weight:700}.pts-bad{color:var(--red);font-weight:700}.metrics-total-row td{background:#f8faff;font-size:13px}.metric-total-value{font-size:16px;font-weight:800;color:#0f172a}.ct-badge{display:inline-block;padding:3px 10px;border-radius:999px;font-size:11px;font-weight:700;letter-spacing:.04em;text-transform:uppercase}.ct-added{background:#dcfce7;color:#15803d;border:1px solid #86efac}.ct-untracked{background:#ede9fe;color:#6d28d9;border:1px solid #c4b5fd}.ct-modified{background:#dbeafe;color:#1d4ed8;border:1px solid #93c5fd}.ct-deleted{background:#fee2e2;color:#b91c1c;border:1px solid #fca5a5}.ct-renamed{background:#fef3c7;color:#a16207;border:1px solid #fde68a}.ct-default{background:#f1f5f9;color:#475569}.ct-feat{background:#dbeafe;color:#1d4ed8}.ct-fix{background:#fee2e2;color:#b91c1c}.ct-chore{background:#f1f5f9;color:#475569}.ct-docs{background:#fef3c7;color:#a16207}.ct-test{background:#ede9fe;color:#6d28d9}.ct-refactor{background:#f0fdfa;color:#0f766e}.ct-style{background:#fdf4ff;color:#9333ea}.ct-perf{background:#fff7ed;color:#c2410c}.file-path code{max-width:380px;display:inline-block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.diff-bar{display:inline-flex;height:8px;border-radius:4px;overflow:hidden;background:#e2e8f0;vertical-align:middle;min-width:4px}.diff-add{background:#4ade80;height:100%}.diff-del{background:#f87171;height:100%}.diff-labels{font-size:11px;margin-left:6px;font-variant-numeric:tabular-nums}.add-lbl{color:var(--green);font-weight:700}.del-lbl{color:var(--red);font-weight:700;margin-left:3px}.prio-dot{display:inline-flex;align-items:center;justify-content:center;width:24px;height:24px;border-radius:999px;font-size:12px;font-weight:800}.prio-1{background:#fee2e2;color:#b91c1c}.prio-2{background:#ffedd5;color:#c2410c}.prio-3{background:#fef3c7;color:#a16207}.prio-4{background:#dbeafe;color:#1d4ed8}.prio-5{background:#f1f5f9;color:#475569}.divisible-yes{color:var(--green);font-size:13px;font-weight:700}.divisible-no{color:var(--red);font-size:13px;font-weight:700}.block-id{background:#f1f5f9;color:#334155;font-size:11px}.block-files code{font-size:10px;margin:1px}.timeline{position:relative;padding-left:28px}.timeline::before{content:"";position:absolute;left:9px;top:16px;bottom:16px;width:2px;background:#e2e8f0;border-radius:999px}.timeline-item{position:relative;margin-bottom:20px}.timeline-dot{position:absolute;left:-24px;top:14px;width:12px;height:12px;background:#3b82f6;border:2px solid #fff;border-radius:999px;box-shadow:0 0 0 2px #bfdbfe}.timeline-body{background:var(--surface-soft);border:1px solid var(--border);border-radius:12px;padding:12px 16px}.timeline-header{display:flex;align-items:center;flex-wrap:wrap;gap:8px;margin-bottom:6px}.commit-index{background:#e2e8f0;color:#475569;padding:2px 8px;border-radius:999px;font-size:11px;font-weight:800}.commit-type-badge{padding:3px 10px;border-radius:999px;font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:.04em}.commit-msg{font-size:13px;color:#0f172a;background:#f8fafc;border:1px solid #e2e8f0;padding:2px 8px;border-radius:6px;word-break:break-word}.timeline-meta{display:flex;flex-wrap:wrap;gap:12px;font-size:12px;color:var(--muted);margin-bottom:8px}.timeline-meta span{display:flex;align-items:center;gap:3px}.commit-files-list{margin:0;padding-left:16px;list-style:disc}.commit-files-list li{margin:2px 0;font-size:12px}.commit-files-list code{font-size:11px;padding:1px 5px}.dep-arrow{color:var(--muted);font-size:16px;vertical-align:middle}.footer{margin-top:48px;border-top:1px solid var(--border);padding-top:20px;text-align:center;font-size:12px;color:var(--muted)}.copy-btn{background:none;border:1px solid rgba(0,0,0,.12);border-radius:6px;padding:1px 6px;cursor:pointer;font-size:11px;color:#64748b;line-height:1.4;transition:background .15s,color .15s;flex-shrink:0;vertical-align:middle}.copy-btn:hover{background:#f1f5f9;color:#0f172a;border-color:#94a3b8}.commit-type-pills{display:flex;flex-wrap:wrap;gap:4px;margin-top:4px}.commit-type-pill{display:inline-block;padding:1px 8px;border-radius:999px;font-size:10px;font-weight:700;text-transform:uppercase;letter-spacing:.03em;opacity:.85}.toc-bar-wrap{width:50px;height:4px;background:rgba(0,0,0,.1);border-radius:999px;overflow:hidden;flex-shrink:0}.toc-bar{height:100%;border-radius:999px;transition:width .4s ease}.toc-bar-ok{background:var(--green)}.toc-bar-warn{background:var(--yellow)}.toc-bar-bad{background:var(--red)}.toc-commits{font-size:11px;opacity:.65;font-weight:500;white-space:nowrap}.back-to-top{text-align:right;padding-top:12px;border-top:1px solid var(--border);margin-top:20px}.back-link{font-size:12px;color:var(--muted);text-decoration:none;font-weight:600}.back-link:hover{color:#3b82f6;text-decoration:underline}.git-commands-block{background:#0f172a;border-radius:14px;padding:18px 20px;overflow-x:auto;margin-top:8px;box-shadow:inset 0 1px 4px rgba(0,0,0,.3)}.git-commands-block pre{margin:0;font-family:"JetBrains Mono","Fira Mono",ui-monospace,monospace;font-size:12px;line-height:1.8;color:#e2e8f0;white-space:pre}.git-commands-block .gc-comment{color:#4b6988;font-style:italic}.git-commands-block .gc-cmd{color:#7dd3fc;font-weight:700}.git-commands-block .gc-branch{color:#86efac}.git-commands-block .gc-file{color:#fca5a5}.git-commands-block .gc-msg{color:#fde68a}.ct-ci{background:#ecfdf5;color:#059669}.ct-revert{background:#fdf4ff;color:#c026d3}@media(max-width: 960px){.hero{padding:24px 20px}.hero-title-area h1{font-size:26px}.plan-card-header{padding:18px}.plan-card-body{padding:18px}.file-path code{max-width:200px}}@media(max-width: 640px){.container{padding:16px 12px 60px}.kpi-row{gap:8px}.kpi{padding:8px 12px;min-width:72px}.kpi-v{font-size:18px}}@media print{body{background:#fff;font-size:12px}.container{max-width:100%;padding:0}.hero{border-radius:0;box-shadow:none}.plan-card,.card,.stat-card,table{box-shadow:none;break-inside:avoid}.section{break-before:auto}a{color:inherit;text-decoration:none}}`;