@alexis-reillo/git-helper 0.1.0 → 0.2.0

package/README.md

@@ -1,32 +1,75 @@
 # git-helper (CLI)
 
-Analiza Pull Requests de GitHub usando Inteligencia Artificial, directamente desde la terminal.
+Analiza Pull Requests de GitHub usando Inteligencia Artificial, directamente desde
+la terminal — con una **interfaz interactiva a pantalla completa** estilo Claude Code.
 
 ## Instalación
 
 ```bash
 # Uso puntual, sin instalar
-npx @alexis-reillo/git-helper analyze -o vercel -r next.js -p 12345
+npx @alexis-reillo/git-helper
 
 # Instalación global
 npm i -g @alexis-reillo/git-helper
-git-helper analyze -o vercel -r next.js -p 12345
+git-helper
 ```
 
 Requiere **Node.js >= 18**.
 
-## Uso
+## Inicio rápido (interfaz interactiva)
 
-### Comandos
+Ejecuta `git-helper` **sin argumentos** para abrir la TUI a pantalla completa:
+
+```bash
+git-helper
+```
+
+- La **primera vez** te pedirá tu **token de GitHub** (no hace falta configurarlo
+  a mano antes): lo pegas, se guarda y entras directo. Ver
+  [Token de GitHub](#token-de-github-primer-uso).
+- Verás la lista de tus **PRs pendientes**. Navega con `↑↓`, pulsa `⏎` para
+  analizar uno con IA, `r` para refrescar y `q` para salir.
+
+> **Tip visual:** usa una terminal moderna (Windows Terminal, iTerm2…) con una
+> [Nerd Font](https://www.nerdfonts.com/) para que la mascota y los iconos se
+> vean perfectos.
+
+## Token de GitHub (primer uso)
+
+git-helper necesita un **personal access token** de GitHub para listar tus Pull
+Requests pendientes. Tienes tres formas de dárselo (de más a menos cómoda):
+
+1. **Automática (recomendada):** abre `git-helper` y, si no hay token, la propia
+   interfaz te lo pedirá y lo guardará por ti. Nada más que hacer.
+2. **Con el comando `config`** (persiste en `~/.config/git-helper/.env`, permisos `0600`):
+   ```bash
+   git-helper config set GITHUB_TOKEN ghp_xxx
+   ```
+3. **Variable de entorno** (puntual, no se guarda):
+   ```bash
+   export GITHUB_TOKEN=ghp_xxx      # bash/zsh
+   $env:GITHUB_TOKEN="ghp_xxx"      # PowerShell
+   ```
+
+**Cómo crear el token:** ve a
+[github.com/settings/tokens](https://github.com/settings/tokens) → *Generate new
+token* → marca el scope **`repo`** (o un fine-grained con lectura de repos y PRs).
+
+> El token se guarda **solo en tu equipo**. Para verlo/borrarlo:
+> `git-helper config list` (enmascarado) · `git-helper config unset GITHUB_TOKEN`.
+
+## Comandos (modo no interactivo)
+
+Además de la TUI, todo está disponible como comandos sueltos (útil para scripting):
 
 | Comando             | Alias     | Descripción                                  |
 | ------------------- | --------- | -------------------------------------------- |
-| `git-helper`        | —         | Muestra el banner y la ayuda.                |
-| `git-helper list`   | `ls`      | Lista tus Pull Requests pendientes de revisar (requiere `GITHUB_TOKEN`). |
+| `git-helper`        | —         | Abre la interfaz interactiva a pantalla completa. |
+| `git-helper list`   | `ls`      | Lista tus Pull Requests pendientes (requiere `GITHUB_TOKEN`). |
 | `git-helper review` | `analyze` | Analiza un PR concreto con IA.               |
 | `git-helper config` | —         | Gestiona la configuración guardada (claves y tokens). |
 
-#### `review`
+### `review`
 
 ```bash
 git-helper review --owner <owner> --repo <repo> --pr <number>
@@ -39,53 +82,33 @@ git-helper review --owner <owner> --repo <repo> --pr <number>
 | `--pr <number>`   | `-p`  | Número del Pull Request              |
 | `--json`          | —     | Imprime el resultado en JSON (sin formato visual) |
 
-#### `list`
+### `list`
 
 ```bash
-export GITHUB_TOKEN=ghp_...
 git-helper list           # tabla bonita
 git-helper list --json    # salida JSON para scripts
 ```
 
-#### `config`
-
-Guarda tus claves de forma persistente en `~/.config/git-helper/.env` (permisos
-`0600`), como alternativa a exportar variables de entorno cada vez.
+### `config`
 
 ```bash
 git-helper config set GITHUB_TOKEN ghp_...
-git-helper config set AI_PROVIDER gemini
 git-helper config set GOOGLE_GENERATIVE_AI_API_KEY ...
 git-helper config list     # secretos enmascarados
 git-helper config unset OPENAI_API_KEY
 git-helper config path     # ruta del archivo
 ```
 
-Prioridad de configuración: **variables de entorno reales** > `.env` del directorio
-actual > config global guardada.
-
-> **Tip visual:** la interfaz usa color truecolor y arte ASCII. Para que la
-> mascota y los iconos se vean perfectos, usa una terminal moderna (Windows
-> Terminal, iTerm2…) con una [Nerd Font](https://www.nerdfonts.com/).
-
 ## Configuración (variables de entorno)
 
-La CLI lee la configuración del entorno del sistema (o de un archivo `.env` en el
-directorio actual). Necesitas, como mínimo, la clave del proveedor de IA elegido.
+Prioridad: **variables de entorno reales** > `.env` del directorio actual >
+config global guardada (`config set`).
 
 | Variable                          | Requerida           | Descripción                                                    |
 | --------------------------------- | ------------------- | -------------------------------------------------------------- |
+| `GITHUB_TOKEN`                    | Para `list` y la TUI | Token de GitHub (scope `repo`). Sube el rate limit y permite repos privados. |
 | `AI_PROVIDER`                     | No (`gemini`)       | Proveedor de IA: `gemini` u `openai`.                          |
 | `GOOGLE_GENERATIVE_AI_API_KEY`    | Si `AI_PROVIDER=gemini` | Clave de [Google AI Studio](https://aistudio.google.com/apikey). |
 | `OPENAI_API_KEY`                  | Si `AI_PROVIDER=openai` | Clave de OpenAI.                                          |
 | `AI_MODEL`                        | No                  | Fuerza un modelo concreto (por defecto `gemini-2.5-flash` / `gpt-4o-mini`). |
 | `AI_ENSEMBLE_RUNS`                | No (`3`)            | Nº de ejecuciones del ensemble por análisis (mediana). `1` lo desactiva. |
-| `GITHUB_TOKEN`                    | No                  | Sube el rate limit y permite analizar repos privados.          |
-
-Ejemplo en bash:
-
-```bash
-export AI_PROVIDER=gemini
-export GOOGLE_GENERATIVE_AI_API_KEY=tu_clave
-git-helper analyze -o vercel -r next.js -p 12345
-```

package/dist/chunk-QR7XJSI6.js

@@ -0,0 +1,334 @@
+#!/usr/bin/env node
+
+// ../../packages/core/src/index.ts
+import { Octokit } from "@octokit/rest";
+import { generateObject } from "ai";
+import { openai } from "@ai-sdk/openai";
+import { google } from "@ai-sdk/google";
+import { z } from "zod";
+var RECOMENDACIONES = [
+  "aprobar",
+  "cambios_menores",
+  "cambios_mayores",
+  "bloqueado"
+];
+var PRAnalysisSchema = z.object({
+  resumen_ejecutivo: z.string().describe("Resumen de 2 frases de lo que hace el PR"),
+  posibles_bugs: z.array(z.string()).describe("Lista de posibles bugs o errores l\xF3gicos"),
+  apto_para_merge: z.boolean().describe("True si no hay bugs cr\xEDticos ni mayores"),
+  puntuacion_codigo: z.number().min(1).max(10).describe("Puntuaci\xF3n de calidad del 1 al 10"),
+  recomendacion: z.enum(RECOMENDACIONES).describe("Recomendaci\xF3n categ\xF3rica de revisi\xF3n")
+});
+var DEFAULT_MODELS = {
+  gemini: "gemini-2.5-flash",
+  // Rápido y con free tier en Google AI Studio
+  openai: "gpt-4o-mini"
+  // Rápido y barato
+};
+function resolveModel(provider, model) {
+  const selected = (provider ?? process.env.AI_PROVIDER ?? "gemini").toLowerCase();
+  const modelName = model ?? process.env.AI_MODEL;
+  switch (selected) {
+    case "gemini":
+    case "google":
+      if (!process.env.GOOGLE_GENERATIVE_AI_API_KEY) {
+        throw new Error(
+          'Falta la variable de entorno GOOGLE_GENERATIVE_AI_API_KEY requerida para el proveedor "gemini".'
+        );
+      }
+      return google(modelName ?? DEFAULT_MODELS.gemini);
+    case "openai":
+      if (!process.env.OPENAI_API_KEY) {
+        throw new Error(
+          'Falta la variable de entorno OPENAI_API_KEY requerida para el proveedor "openai".'
+        );
+      }
+      return openai(modelName ?? DEFAULT_MODELS.openai);
+    default:
+      throw new Error(
+        `AI_PROVIDER desconocido: "${selected}". Valores v\xE1lidos: "gemini" u "openai".`
+      );
+  }
+}
+var SCORING_RUBRIC = `Eres un ingeniero de software Senior revisando un Pull Request. Eval\xFAa \xDANICAMENTE el diff proporcionado.
+
+Criterios a revisar, por orden de importancia (basados en el est\xE1ndar de Google):
+1. Dise\xF1o: \xBFencajan e interact\xFAan bien las piezas del cambio? \xBFpertenece aqu\xED y se integra con el resto del sistema?
+2. Complejidad / over-engineering: \xBFes m\xE1s complejo o gen\xE9rico de lo necesario? \xBFse entiende r\xE1pido al leerlo?
+3. Correctitud y bugs: errores l\xF3gicos, casos l\xEDmite, concurrencia.
+4. Seguridad: inyecci\xF3n, fuga de secretos, autenticaci\xF3n y permisos.
+5. Manejo de errores y casos l\xEDmite.
+6. Tests: \xBFhay pruebas correctas para los cambios?
+7. Legibilidad/mantenibilidad y rendimiento.
+
+Clasifica cada problema que encuentres por severidad, de forma ESTRICTA y CONSISTENTE:
+- "critico": bug que rompe funcionalidad, vulnerabilidad de seguridad, fuga de secretos, o cualquier cosa que bloquee el merge.
+- "mayor": problema notable que conviene resolver (dise\xF1o deficiente, validaci\xF3n ausente, manejo de errores pobre, deuda t\xE9cnica relevante, regresi\xF3n funcional, l\xF3gica nueva sin tests).
+- "menor": mejora opcional no bloqueante (estilo, naming, micro-optimizaci\xF3n, documentaci\xF3n).
+
+Ejemplos de calibraci\xF3n (para anclar la severidad de forma consistente):
+- "Concatena entrada del usuario en una query SQL sin parametrizar" => critico (seguridad).
+- "Expone una clave/API key o secreto en el c\xF3digo" => critico (fuga de secretos).
+- "No comprueba si el array est\xE1 vac\xEDo antes de acceder a [0]" => mayor (caso l\xEDmite no manejado).
+- "A\xF1ade una rama de error nueva pero ning\xFAn test que la cubra" => mayor (tests ausentes en l\xF3gica relevante).
+- "Abstracci\xF3n gen\xE9rica para un \xFAnico caso de uso actual" => mayor (over-engineering).
+- "Variable poco descriptiva como 'x' o falta un comentario" => menor (legibilidad).
+
+Reglas obligatorias:
+- Incluye SOLO problemas reales y concretos presentes en el diff; nada gen\xE9rico ni especulativo. Prioriza precisi\xF3n sobre exhaustividad (menos ruido, m\xE1s se\xF1al).
+- El mismo diff debe producir SIEMPRE la misma lista de problemas con la misma severidad. S\xE9 reproducible y objetivo.
+- Si el diff est\xE1 truncado, eval\xFAa solo lo visible y no penalices por lo que falte.
+- "resumen_ejecutivo": 2 frases neutrales sobre qu\xE9 hace el PR.
+- NO asignes una puntuaci\xF3n num\xE9rica: la calcula el sistema a partir de tus problemas. Tu trabajo es detectarlos y clasificarlos correctamente.`;
+var ReviewModelSchema = z.object({
+  resumen_ejecutivo: z.string().describe("Resumen de 2 frases de lo que hace el PR"),
+  problemas: z.array(
+    z.object({
+      severidad: z.enum(["critico", "mayor", "menor"]),
+      descripcion: z.string().describe("Problema concreto y real presente en el diff")
+    })
+  ).describe("Lista de problemas detectados; vac\xEDa si no hay ninguno")
+});
+var PENALIZACION = {
+  critico: 3,
+  mayor: 1.5,
+  menor: 0.5
+};
+function computeScore(problemas) {
+  const criticos = problemas.filter((p) => p.severidad === "critico").length;
+  const mayores = problemas.filter((p) => p.severidad === "mayor").length;
+  const menores = problemas.filter((p) => p.severidad === "menor").length;
+  const penalizacion = problemas.reduce(
+    (acc, p) => acc + PENALIZACION[p.severidad],
+    0
+  );
+  const puntuacion = Math.max(1, Math.min(10, Math.round(10 - penalizacion)));
+  let recomendacion;
+  if (criticos > 0) {
+    recomendacion = "bloqueado";
+  } else if (mayores > 0) {
+    recomendacion = "cambios_mayores";
+  } else if (menores > 0) {
+    recomendacion = "cambios_menores";
+  } else {
+    recomendacion = "aprobar";
+  }
+  const apto = criticos === 0 && mayores === 0;
+  return { puntuacion, apto, recomendacion };
+}
+var DEFAULT_ENSEMBLE_RUNS = 3;
+var GitHubAIService = class {
+  // Aceptamos el token, pero si no se pasa, funciona para repos públicos (con límite de peticiones).
+  // aiOptions permite forzar proveedor/modelo/nº de ejecuciones; si se omite, se usa la config por entorno.
+  constructor(token, aiOptions) {
+    this.token = token;
+    this.aiOptions = aiOptions;
+    this.octokit = new Octokit({ auth: token });
+  }
+  // Obtener el diff (código añadido/borrado) de un PR
+  async getPRDiff(owner, repo, prNumber) {
+    const response = await this.octokit.pulls.get({
+      owner,
+      repo,
+      pull_number: prNumber,
+      mediaType: { format: "diff" }
+      // Mágia de Octokit para pedir el diff en texto plano
+    });
+    return response.data;
+  }
+  // Comprueba que tenemos un token antes de llamar a endpoints que requieren un usuario autenticado.
+  requireAuth(accion) {
+    if (!this.token) {
+      throw new Error(`Se requiere autenticaci\xF3n de GitHub para ${accion}.`);
+    }
+  }
+  // Obtiene los datos del usuario autenticado (sirve para verificar el token y mostrar quién está logueado)
+  async getAuthenticatedUser() {
+    this.requireAuth("obtener tu usuario de GitHub");
+    const { data } = await this.octokit.users.getAuthenticated();
+    return {
+      login: data.login,
+      name: data.name ?? null,
+      avatar_url: data.avatar_url
+    };
+  }
+  // Lista los repositorios del usuario autenticado, ordenados por última actualización
+  async listUserRepos() {
+    this.requireAuth("listar tus repositorios");
+    const { data } = await this.octokit.repos.listForAuthenticatedUser({
+      per_page: 100,
+      sort: "updated"
+    });
+    return data.map((repo) => ({
+      owner: repo.owner.login,
+      name: repo.name,
+      full_name: repo.full_name,
+      private: repo.private,
+      description: repo.description ?? null,
+      updated_at: repo.updated_at ?? null
+    }));
+  }
+  // Lista los Pull Requests abiertos de un repositorio
+  async listOpenPullRequests(owner, repo) {
+    const { data } = await this.octokit.pulls.list({
+      owner,
+      repo,
+      state: "open"
+    });
+    return data.map((pull) => ({
+      number: pull.number,
+      title: pull.title,
+      author: pull.user?.login ?? null,
+      created_at: pull.created_at,
+      url: pull.html_url
+    }));
+  }
+  // Lista los Pull Requests abiertos en los repos del usuario autenticado
+  // (los que tiene "pendientes de aceptar/revisar"). Usa la búsqueda de GitHub
+  // para resolverlo en una sola petición en lugar de iterar repo por repo.
+  async listPendingPullRequests() {
+    const { login } = await this.getAuthenticatedUser();
+    const { data } = await this.octokit.search.issuesAndPullRequests({
+      q: `is:pr is:open archived:false user:${login}`,
+      sort: "updated",
+      order: "desc",
+      per_page: 50
+    });
+    return data.items.map((item) => {
+      const segments = item.repository_url.split("/");
+      const repo = segments.pop() ?? "";
+      const owner = segments.pop() ?? "";
+      return {
+        owner,
+        repo,
+        full_name: `${owner}/${repo}`,
+        number: item.number,
+        title: item.title,
+        author: item.user?.login ?? null,
+        created_at: item.created_at,
+        url: item.html_url,
+        draft: item.draft ?? false
+      };
+    });
+  }
+  // Una única revisión: pide al modelo los problemas y deriva el análisis.
+  async runReview(model, diff) {
+    const { object } = await generateObject({
+      model,
+      schema: ReviewModelSchema,
+      // temperature 0 = detección (casi) determinista
+      temperature: 0,
+      // Los estándares van como `system` (estable); el diff como `prompt` (variable)
+      system: SCORING_RUBRIC,
+      prompt: `Detecta y clasifica los problemas del siguiente diff siguiendo los est\xE1ndares.
+
+Diff:
+${diff}`
+    });
+    const { puntuacion, apto, recomendacion } = computeScore(object.problemas);
+    return {
+      resumen_ejecutivo: object.resumen_ejecutivo,
+      // Prefijamos cada bug con su severidad para que sea visible en la UI
+      posibles_bugs: object.problemas.map(
+        (p) => `[${p.severidad}] ${p.descripcion}`
+      ),
+      apto_para_merge: apto,
+      puntuacion_codigo: puntuacion,
+      recomendacion
+    };
+  }
+  // El método que une GitHub + IA.
+  // Ejecuta el análisis varias veces (ensemble) y se queda con el resultado
+  // de la MEDIANA por puntuación, lo que filtra ejecuciones atípicas y reduce
+  // la varianza entre sesiones (práctica recomendada en LLM-as-a-judge).
+  async analyzePR(owner, repo, prNumber) {
+    console.log(`[Core] Descargando diff de ${owner}/${repo}#${prNumber}...`);
+    const diff = await this.getPRDiff(owner, repo, prNumber);
+    const diffLimitado = diff.substring(0, 2e4);
+    if (diffLimitado.trim().length === 0) {
+      throw new Error("El PR no tiene cambios de c\xF3digo (diff vac\xEDo).");
+    }
+    const model = resolveModel(this.aiOptions?.provider, this.aiOptions?.model);
+    const envRuns = Number(process.env.AI_ENSEMBLE_RUNS);
+    const configuredRuns = this.aiOptions?.ensembleRuns ?? (Number.isFinite(envRuns) && envRuns > 0 ? envRuns : DEFAULT_ENSEMBLE_RUNS);
+    const runs = Math.max(1, configuredRuns);
+    console.log(`[Core] Analizando con ${runs} ejecuci\xF3n(es) (${diffLimitado.length} caracteres)...`);
+    const settled = await Promise.allSettled(
+      Array.from({ length: runs }, () => this.runReview(model, diffLimitado))
+    );
+    const exitosas = settled.filter(
+      (r) => r.status === "fulfilled"
+    ).map((r) => r.value);
+    if (exitosas.length === 0) {
+      const motivo = settled[0]?.status === "rejected" ? settled[0].reason : "desconocido";
+      throw new Error(
+        `No se pudo completar el an\xE1lisis: ${motivo instanceof Error ? motivo.message : motivo}`
+      );
+    }
+    exitosas.sort((a, b) => a.puntuacion_codigo - b.puntuacion_codigo);
+    return exitosas[Math.floor(exitosas.length / 2)];
+  }
+};
+
+// src/config.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import dotenv from "dotenv";
+var CONFIG_DIR = join(homedir(), ".config", "git-helper");
+var CONFIG_FILE = join(CONFIG_DIR, ".env");
+var CONFIG_KEYS = [
+  "AI_PROVIDER",
+  "AI_MODEL",
+  "AI_ENSEMBLE_RUNS",
+  "GOOGLE_GENERATIVE_AI_API_KEY",
+  "OPENAI_API_KEY",
+  "GITHUB_TOKEN"
+];
+var SECRET_KEYS = /* @__PURE__ */ new Set([
+  "GOOGLE_GENERATIVE_AI_API_KEY",
+  "OPENAI_API_KEY",
+  "GITHUB_TOKEN"
+]);
+var isConfigKey = (k) => CONFIG_KEYS.includes(k);
+function maskValue(key, value) {
+  if (!SECRET_KEYS.has(key) || value.length <= 4) return value;
+  return "\u2022".repeat(Math.min(6, value.length - 4)) + value.slice(-4);
+}
+function loadGlobalConfig() {
+  if (existsSync(CONFIG_FILE)) {
+    dotenv.config({ path: CONFIG_FILE, quiet: true });
+  }
+}
+function readConfig() {
+  if (!existsSync(CONFIG_FILE)) return {};
+  return dotenv.parse(readFileSync(CONFIG_FILE));
+}
+function writeConfig(values) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  const body = CONFIG_KEYS.filter((k) => values[k] !== void 0).map((k) => `${k}=${values[k]}`).join("\n") + "\n";
+  writeFileSync(CONFIG_FILE, body, { mode: 384 });
+}
+function setConfig(key, value) {
+  const current = readConfig();
+  current[key] = value;
+  writeConfig(current);
+}
+function unsetConfig(key) {
+  const current = readConfig();
+  if (current[key] === void 0) return;
+  delete current[key];
+  writeConfig(current);
+}
+
+export {
+  GitHubAIService,
+  CONFIG_FILE,
+  CONFIG_KEYS,
+  isConfigKey,
+  maskValue,
+  loadGlobalConfig,
+  readConfig,
+  setConfig,
+  unsetConfig
+};

package/dist/index.js

@@ -1,330 +1,48 @@
 #!/usr/bin/env node
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
+import {
+  CONFIG_FILE,
+  CONFIG_KEYS,
+  GitHubAIService,
+  isConfigKey,
+  loadGlobalConfig,
+  maskValue,
+  readConfig,
+  setConfig,
+  unsetConfig
+} from "./chunk-QR7XJSI6.js";
 
 // src/index.ts
-var import_dotenv2 = __toESM(require("dotenv"));
-var import_commander = require("commander");
-var import_ora = __toESM(require("ora"));
-
-// ../../packages/core/src/index.ts
-var import_rest = require("@octokit/rest");
-var import_ai = require("ai");
-var import_openai = require("@ai-sdk/openai");
-var import_google = require("@ai-sdk/google");
-var import_zod = require("zod");
-var RECOMENDACIONES = [
-  "aprobar",
-  "cambios_menores",
-  "cambios_mayores",
-  "bloqueado"
-];
-var PRAnalysisSchema = import_zod.z.object({
-  resumen_ejecutivo: import_zod.z.string().describe("Resumen de 2 frases de lo que hace el PR"),
-  posibles_bugs: import_zod.z.array(import_zod.z.string()).describe("Lista de posibles bugs o errores l\xF3gicos"),
-  apto_para_merge: import_zod.z.boolean().describe("True si no hay bugs cr\xEDticos ni mayores"),
-  puntuacion_codigo: import_zod.z.number().min(1).max(10).describe("Puntuaci\xF3n de calidad del 1 al 10"),
-  recomendacion: import_zod.z.enum(RECOMENDACIONES).describe("Recomendaci\xF3n categ\xF3rica de revisi\xF3n")
-});
-var DEFAULT_MODELS = {
-  gemini: "gemini-2.5-flash",
-  // Rápido y con free tier en Google AI Studio
-  openai: "gpt-4o-mini"
-  // Rápido y barato
-};
-function resolveModel(provider, model) {
-  const selected = (provider ?? process.env.AI_PROVIDER ?? "gemini").toLowerCase();
-  const modelName = model ?? process.env.AI_MODEL;
-  switch (selected) {
-    case "gemini":
-    case "google":
-      if (!process.env.GOOGLE_GENERATIVE_AI_API_KEY) {
-        throw new Error(
-          'Falta la variable de entorno GOOGLE_GENERATIVE_AI_API_KEY requerida para el proveedor "gemini".'
-        );
-      }
-      return (0, import_google.google)(modelName ?? DEFAULT_MODELS.gemini);
-    case "openai":
-      if (!process.env.OPENAI_API_KEY) {
-        throw new Error(
-          'Falta la variable de entorno OPENAI_API_KEY requerida para el proveedor "openai".'
-        );
-      }
-      return (0, import_openai.openai)(modelName ?? DEFAULT_MODELS.openai);
-    default:
-      throw new Error(
-        `AI_PROVIDER desconocido: "${selected}". Valores v\xE1lidos: "gemini" u "openai".`
-      );
-  }
-}
-var SCORING_RUBRIC = `Eres un ingeniero de software Senior revisando un Pull Request. Eval\xFAa \xDANICAMENTE el diff proporcionado.
-
-Criterios a revisar, por orden de importancia (basados en el est\xE1ndar de Google):
-1. Dise\xF1o: \xBFencajan e interact\xFAan bien las piezas del cambio? \xBFpertenece aqu\xED y se integra con el resto del sistema?
-2. Complejidad / over-engineering: \xBFes m\xE1s complejo o gen\xE9rico de lo necesario? \xBFse entiende r\xE1pido al leerlo?
-3. Correctitud y bugs: errores l\xF3gicos, casos l\xEDmite, concurrencia.
-4. Seguridad: inyecci\xF3n, fuga de secretos, autenticaci\xF3n y permisos.
-5. Manejo de errores y casos l\xEDmite.
-6. Tests: \xBFhay pruebas correctas para los cambios?
-7. Legibilidad/mantenibilidad y rendimiento.
-
-Clasifica cada problema que encuentres por severidad, de forma ESTRICTA y CONSISTENTE:
-- "critico": bug que rompe funcionalidad, vulnerabilidad de seguridad, fuga de secretos, o cualquier cosa que bloquee el merge.
-- "mayor": problema notable que conviene resolver (dise\xF1o deficiente, validaci\xF3n ausente, manejo de errores pobre, deuda t\xE9cnica relevante, regresi\xF3n funcional, l\xF3gica nueva sin tests).
-- "menor": mejora opcional no bloqueante (estilo, naming, micro-optimizaci\xF3n, documentaci\xF3n).
-
-Ejemplos de calibraci\xF3n (para anclar la severidad de forma consistente):
-- "Concatena entrada del usuario en una query SQL sin parametrizar" => critico (seguridad).
-- "Expone una clave/API key o secreto en el c\xF3digo" => critico (fuga de secretos).
-- "No comprueba si el array est\xE1 vac\xEDo antes de acceder a [0]" => mayor (caso l\xEDmite no manejado).
-- "A\xF1ade una rama de error nueva pero ning\xFAn test que la cubra" => mayor (tests ausentes en l\xF3gica relevante).
-- "Abstracci\xF3n gen\xE9rica para un \xFAnico caso de uso actual" => mayor (over-engineering).
-- "Variable poco descriptiva como 'x' o falta un comentario" => menor (legibilidad).
-
-Reglas obligatorias:
-- Incluye SOLO problemas reales y concretos presentes en el diff; nada gen\xE9rico ni especulativo. Prioriza precisi\xF3n sobre exhaustividad (menos ruido, m\xE1s se\xF1al).
-- El mismo diff debe producir SIEMPRE la misma lista de problemas con la misma severidad. S\xE9 reproducible y objetivo.
-- Si el diff est\xE1 truncado, eval\xFAa solo lo visible y no penalices por lo que falte.
-- "resumen_ejecutivo": 2 frases neutrales sobre qu\xE9 hace el PR.
-- NO asignes una puntuaci\xF3n num\xE9rica: la calcula el sistema a partir de tus problemas. Tu trabajo es detectarlos y clasificarlos correctamente.`;
-var ReviewModelSchema = import_zod.z.object({
-  resumen_ejecutivo: import_zod.z.string().describe("Resumen de 2 frases de lo que hace el PR"),
-  problemas: import_zod.z.array(
-    import_zod.z.object({
-      severidad: import_zod.z.enum(["critico", "mayor", "menor"]),
-      descripcion: import_zod.z.string().describe("Problema concreto y real presente en el diff")
-    })
-  ).describe("Lista de problemas detectados; vac\xEDa si no hay ninguno")
-});
-var PENALIZACION = {
-  critico: 3,
-  mayor: 1.5,
-  menor: 0.5
-};
-function computeScore(problemas) {
-  const criticos = problemas.filter((p) => p.severidad === "critico").length;
-  const mayores = problemas.filter((p) => p.severidad === "mayor").length;
-  const menores = problemas.filter((p) => p.severidad === "menor").length;
-  const penalizacion = problemas.reduce(
-    (acc, p) => acc + PENALIZACION[p.severidad],
-    0
-  );
-  const puntuacion = Math.max(1, Math.min(10, Math.round(10 - penalizacion)));
-  let recomendacion;
-  if (criticos > 0) {
-    recomendacion = "bloqueado";
-  } else if (mayores > 0) {
-    recomendacion = "cambios_mayores";
-  } else if (menores > 0) {
-    recomendacion = "cambios_menores";
-  } else {
-    recomendacion = "aprobar";
-  }
-  const apto = criticos === 0 && mayores === 0;
-  return { puntuacion, apto, recomendacion };
-}
-var DEFAULT_ENSEMBLE_RUNS = 3;
-var GitHubAIService = class {
-  // Aceptamos el token, pero si no se pasa, funciona para repos públicos (con límite de peticiones).
-  // aiOptions permite forzar proveedor/modelo/nº de ejecuciones; si se omite, se usa la config por entorno.
-  constructor(token, aiOptions) {
-    this.token = token;
-    this.aiOptions = aiOptions;
-    this.octokit = new import_rest.Octokit({ auth: token });
-  }
-  // Obtener el diff (código añadido/borrado) de un PR
-  async getPRDiff(owner, repo, prNumber) {
-    const response = await this.octokit.pulls.get({
-      owner,
-      repo,
-      pull_number: prNumber,
-      mediaType: { format: "diff" }
-      // Mágia de Octokit para pedir el diff en texto plano
-    });
-    return response.data;
-  }
-  // Comprueba que tenemos un token antes de llamar a endpoints que requieren un usuario autenticado.
-  requireAuth(accion) {
-    if (!this.token) {
-      throw new Error(`Se requiere autenticaci\xF3n de GitHub para ${accion}.`);
-    }
-  }
-  // Obtiene los datos del usuario autenticado (sirve para verificar el token y mostrar quién está logueado)
-  async getAuthenticatedUser() {
-    this.requireAuth("obtener tu usuario de GitHub");
-    const { data } = await this.octokit.users.getAuthenticated();
-    return {
-      login: data.login,
-      name: data.name ?? null,
-      avatar_url: data.avatar_url
-    };
-  }
-  // Lista los repositorios del usuario autenticado, ordenados por última actualización
-  async listUserRepos() {
-    this.requireAuth("listar tus repositorios");
-    const { data } = await this.octokit.repos.listForAuthenticatedUser({
-      per_page: 100,
-      sort: "updated"
-    });
-    return data.map((repo) => ({
-      owner: repo.owner.login,
-      name: repo.name,
-      full_name: repo.full_name,
-      private: repo.private,
-      description: repo.description ?? null,
-      updated_at: repo.updated_at ?? null
-    }));
-  }
-  // Lista los Pull Requests abiertos de un repositorio
-  async listOpenPullRequests(owner, repo) {
-    const { data } = await this.octokit.pulls.list({
-      owner,
-      repo,
-      state: "open"
-    });
-    return data.map((pull) => ({
-      number: pull.number,
-      title: pull.title,
-      author: pull.user?.login ?? null,
-      created_at: pull.created_at,
-      url: pull.html_url
-    }));
-  }
-  // Lista los Pull Requests abiertos en los repos del usuario autenticado
-  // (los que tiene "pendientes de aceptar/revisar"). Usa la búsqueda de GitHub
-  // para resolverlo en una sola petición en lugar de iterar repo por repo.
-  async listPendingPullRequests() {
-    const { login } = await this.getAuthenticatedUser();
-    const { data } = await this.octokit.search.issuesAndPullRequests({
-      q: `is:pr is:open archived:false user:${login}`,
-      sort: "updated",
-      order: "desc",
-      per_page: 50
-    });
-    return data.items.map((item) => {
-      const segments = item.repository_url.split("/");
-      const repo = segments.pop() ?? "";
-      const owner = segments.pop() ?? "";
-      return {
-        owner,
-        repo,
-        full_name: `${owner}/${repo}`,
-        number: item.number,
-        title: item.title,
-        author: item.user?.login ?? null,
-        created_at: item.created_at,
-        url: item.html_url,
-        draft: item.draft ?? false
-      };
-    });
-  }
-  // Una única revisión: pide al modelo los problemas y deriva el análisis.
-  async runReview(model, diff) {
-    const { object } = await (0, import_ai.generateObject)({
-      model,
-      schema: ReviewModelSchema,
-      // temperature 0 = detección (casi) determinista
-      temperature: 0,
-      // Los estándares van como `system` (estable); el diff como `prompt` (variable)
-      system: SCORING_RUBRIC,
-      prompt: `Detecta y clasifica los problemas del siguiente diff siguiendo los est\xE1ndares.
-
-Diff:
-${diff}`
-    });
-    const { puntuacion, apto, recomendacion } = computeScore(object.problemas);
-    return {
-      resumen_ejecutivo: object.resumen_ejecutivo,
-      // Prefijamos cada bug con su severidad para que sea visible en la UI
-      posibles_bugs: object.problemas.map(
-        (p) => `[${p.severidad}] ${p.descripcion}`
-      ),
-      apto_para_merge: apto,
-      puntuacion_codigo: puntuacion,
-      recomendacion
-    };
-  }
-  // El método que une GitHub + IA.
-  // Ejecuta el análisis varias veces (ensemble) y se queda con el resultado
-  // de la MEDIANA por puntuación, lo que filtra ejecuciones atípicas y reduce
-  // la varianza entre sesiones (práctica recomendada en LLM-as-a-judge).
-  async analyzePR(owner, repo, prNumber) {
-    console.log(`[Core] Descargando diff de ${owner}/${repo}#${prNumber}...`);
-    const diff = await this.getPRDiff(owner, repo, prNumber);
-    const diffLimitado = diff.substring(0, 2e4);
-    if (diffLimitado.trim().length === 0) {
-      throw new Error("El PR no tiene cambios de c\xF3digo (diff vac\xEDo).");
-    }
-    const model = resolveModel(this.aiOptions?.provider, this.aiOptions?.model);
-    const envRuns = Number(process.env.AI_ENSEMBLE_RUNS);
-    const configuredRuns = this.aiOptions?.ensembleRuns ?? (Number.isFinite(envRuns) && envRuns > 0 ? envRuns : DEFAULT_ENSEMBLE_RUNS);
-    const runs = Math.max(1, configuredRuns);
-    console.log(`[Core] Analizando con ${runs} ejecuci\xF3n(es) (${diffLimitado.length} caracteres)...`);
-    const settled = await Promise.allSettled(
-      Array.from({ length: runs }, () => this.runReview(model, diffLimitado))
-    );
-    const exitosas = settled.filter(
-      (r) => r.status === "fulfilled"
-    ).map((r) => r.value);
-    if (exitosas.length === 0) {
-      const motivo = settled[0]?.status === "rejected" ? settled[0].reason : "desconocido";
-      throw new Error(
-        `No se pudo completar el an\xE1lisis: ${motivo instanceof Error ? motivo.message : motivo}`
-      );
-    }
-    exitosas.sort((a, b) => a.puntuacion_codigo - b.puntuacion_codigo);
-    return exitosas[Math.floor(exitosas.length / 2)];
-  }
-};
+import dotenv from "dotenv";
+import { Command } from "commander";
+import ora from "ora";
 
 // src/ui/banner.ts
-var import_figlet = __toESM(require("figlet"));
+import figlet from "figlet";
 
 // src/ui/theme.ts
-var import_chalk = __toESM(require("chalk"));
-var import_gradient_string = __toESM(require("gradient-string"));
+import chalk from "chalk";
+import gradient from "gradient-string";
 var PURPLE = "#8b5cf6";
 var PURPLE_DARK = "#6d28d9";
 var PURPLE_LIGHT = "#a78bfa";
 var c = {
-  purple: import_chalk.default.hex(PURPLE),
-  purpleBold: import_chalk.default.hex(PURPLE).bold,
-  light: import_chalk.default.hex(PURPLE_LIGHT),
-  dim: import_chalk.default.hex("#6b7280"),
+  purple: chalk.hex(PURPLE),
+  purpleBold: chalk.hex(PURPLE).bold,
+  light: chalk.hex(PURPLE_LIGHT),
+  dim: chalk.hex("#6b7280"),
   // gray-500
-  gray: import_chalk.default.hex("#9ca3af"),
+  gray: chalk.hex("#9ca3af"),
   // gray-400
-  white: import_chalk.default.whiteBright,
-  bold: import_chalk.default.bold,
-  ok: import_chalk.default.hex("#22c55e"),
+  white: chalk.whiteBright,
+  bold: chalk.bold,
+  ok: chalk.hex("#22c55e"),
   // green-500
-  bad: import_chalk.default.hex("#ef4444"),
+  bad: chalk.hex("#ef4444"),
   // red-500
-  warn: import_chalk.default.hex("#f59e0b")
+  warn: chalk.hex("#f59e0b")
   // amber-500
 };
-var purpleGradient = (text) => (0, import_gradient_string.default)([PURPLE_LIGHT, PURPLE, PURPLE_DARK]).multiline(text);
+var purpleGradient = (text) => gradient([PURPLE_LIGHT, PURPLE, PURPLE_DARK]).multiline(text);
 
 // src/ui/banner.ts
 var OCTOPUS = [
@@ -372,7 +90,7 @@ function boxify(lines) {
   return [top, ...body, bottom];
 }
 function renderBanner() {
-  const title = import_figlet.default.textSync("Git-Helper", { font: "Standard" }).replace(/\s+$/gm, "").split("\n").filter((l) => l.length > 0);
+  const title = figlet.textSync("Git-Helper", { font: "Standard" }).replace(/\s+$/gm, "").split("\n").filter((l) => l.length > 0);
   const composed = joinSideBySide(OCTOPUS, title, 3);
   const blockWidth = Math.max(...composed.map((l) => l.length));
   const tagPad = Math.max(0, Math.floor((blockWidth - TAGLINE.length) / 2));
@@ -382,7 +100,7 @@ function renderBanner() {
 }
 
 // src/ui/render.ts
-var import_cli_table3 = __toESM(require("cli-table3"));
+import Table from "cli-table3";
 var ANSI = /\[[0-9;]*m/g;
 var visibleLen = (s) => s.replace(ANSI, "").length;
 var padVisible = (s, w) => s + " ".repeat(Math.max(0, w - visibleLen(s)));
@@ -473,7 +191,7 @@ function analysisCard(ref, a) {
   return box(lines, ref);
 }
 function pendingTable(prs) {
-  const table = new import_cli_table3.default({
+  const table = new Table({
     head: ["", "Repo", "PR", "T\xEDtulo", "Autor", "Abierto"].map(
       (h) => c.purpleBold(h)
     ),
@@ -509,65 +227,14 @@ function pendingTable(prs) {
   return table.toString().split("\n").map((l) => l.replace(/[╭╮╰╯─┬┴├┤┼│]/g, (ch) => c.dim(ch))).join("\n");
 }
 
-// src/config.ts
-var import_node_fs = require("fs");
-var import_node_os = require("os");
-var import_node_path = require("path");
-var import_dotenv = __toESM(require("dotenv"));
-var CONFIG_DIR = (0, import_node_path.join)((0, import_node_os.homedir)(), ".config", "git-helper");
-var CONFIG_FILE = (0, import_node_path.join)(CONFIG_DIR, ".env");
-var CONFIG_KEYS = [
-  "AI_PROVIDER",
-  "AI_MODEL",
-  "AI_ENSEMBLE_RUNS",
-  "GOOGLE_GENERATIVE_AI_API_KEY",
-  "OPENAI_API_KEY",
-  "GITHUB_TOKEN"
-];
-var SECRET_KEYS = /* @__PURE__ */ new Set([
-  "GOOGLE_GENERATIVE_AI_API_KEY",
-  "OPENAI_API_KEY",
-  "GITHUB_TOKEN"
-]);
-var isConfigKey = (k) => CONFIG_KEYS.includes(k);
-function maskValue(key, value) {
-  if (!SECRET_KEYS.has(key) || value.length <= 4) return value;
-  return "\u2022".repeat(Math.min(6, value.length - 4)) + value.slice(-4);
-}
-function loadGlobalConfig() {
-  if ((0, import_node_fs.existsSync)(CONFIG_FILE)) {
-    import_dotenv.default.config({ path: CONFIG_FILE, quiet: true });
-  }
-}
-function readConfig() {
-  if (!(0, import_node_fs.existsSync)(CONFIG_FILE)) return {};
-  return import_dotenv.default.parse((0, import_node_fs.readFileSync)(CONFIG_FILE));
-}
-function writeConfig(values) {
-  (0, import_node_fs.mkdirSync)(CONFIG_DIR, { recursive: true });
-  const body = CONFIG_KEYS.filter((k) => values[k] !== void 0).map((k) => `${k}=${values[k]}`).join("\n") + "\n";
-  (0, import_node_fs.writeFileSync)(CONFIG_FILE, body, { mode: 384 });
-}
-function setConfig(key, value) {
-  const current = readConfig();
-  current[key] = value;
-  writeConfig(current);
-}
-function unsetConfig(key) {
-  const current = readConfig();
-  if (current[key] === void 0) return;
-  delete current[key];
-  writeConfig(current);
-}
-
 // src/index.ts
-import_dotenv2.default.config({ quiet: true });
+dotenv.config({ quiet: true });
 loadGlobalConfig();
-var program = new import_commander.Command();
-program.name("git-helper").description("Code review de Pull Requests de GitHub con IA, desde la terminal").version("0.1.0", "-V, --version", "muestra la versi\xF3n").addHelpText("beforeAll", renderBanner());
+var program = new Command();
+program.name("git-helper").description("Code review de Pull Requests de GitHub con IA, desde la terminal").version("0.2.0", "-V, --version", "muestra la versi\xF3n").addHelpText("beforeAll", renderBanner());
 program.command("review").alias("analyze").description("Analiza un PR concreto con IA").requiredOption("-o, --owner <owner>", "propietario del repo (ej: vercel)").requiredOption("-r, --repo <repo>", "nombre del repositorio (ej: next.js)").requiredOption("-p, --pr <number>", "n\xFAmero del Pull Request", (v) => parseInt(v, 10)).option("--json", "imprime el resultado en JSON (sin formato visual)").action(async (opts) => {
   const ref = `${opts.owner}/${opts.repo} #${opts.pr}`;
-  const spinner = opts.json ? null : (0, import_ora.default)({ text: c.gray(`Analizando ${ref} con IA\u2026`), color: "magenta" }).start();
+  const spinner = opts.json ? null : ora({ text: c.gray(`Analizando ${ref} con IA\u2026`), color: "magenta" }).start();
   const service = new GitHubAIService(process.env.GITHUB_TOKEN);
   try {
     const analysis = await service.analyzePR(opts.owner, opts.repo, opts.pr);
@@ -591,7 +258,7 @@ program.command("list").alias("ls").description("Lista tus Pull Requests pendien
     process.exitCode = 1;
     return;
   }
-  const spinner = opts.json ? null : (0, import_ora.default)({ text: c.gray("Buscando tus PRs pendientes\u2026"), color: "magenta" }).start();
+  const spinner = opts.json ? null : ora({ text: c.gray("Buscando tus PRs pendientes\u2026"), color: "magenta" }).start();
   const service = new GitHubAIService(process.env.GITHUB_TOKEN);
   try {
     const prs = await service.listPendingPullRequests();
@@ -652,7 +319,8 @@ config.command("unset <key>").description("Elimina una clave de configuraci\xF3n
 });
 config.command("path").description("Muestra la ruta del archivo de configuraci\xF3n").action(() => console.log(CONFIG_FILE));
 config.action(() => config.help());
-program.action(() => {
-  program.help();
+program.action(async () => {
+  const { runTui } = await import("./run-3BP46L5I.js");
+  await runTui(process.env.GITHUB_TOKEN);
 });
 program.parse();

package/dist/run-3BP46L5I.js

@@ -0,0 +1,286 @@
+#!/usr/bin/env node
+import {
+  GitHubAIService,
+  setConfig
+} from "./chunk-QR7XJSI6.js";
+
+// src/tui/run.tsx
+import { render } from "ink";
+
+// src/tui/App.tsx
+import { useEffect, useState } from "react";
+import { Box, Text, useApp, useInput, useStdout } from "ink";
+import Spinner from "ink-spinner";
+import TextInput from "ink-text-input";
+
+// src/tui/theme.ts
+var colors = {
+  purple: "#8b5cf6",
+  purpleLight: "#a78bfa",
+  dim: "#6b7280",
+  gray: "#9ca3af",
+  fg: "#e5e7eb",
+  ok: "#22c55e",
+  warn: "#f59e0b",
+  bad: "#ef4444",
+  sky: "#38bdf8"
+};
+
+// src/tui/App.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function timeAgo(iso) {
+  const mins = Math.floor((Date.now() - new Date(iso).getTime()) / 6e4);
+  if (mins < 60) return `${mins}m`;
+  const h = Math.floor(mins / 60);
+  if (h < 24) return `${h}h`;
+  return `${Math.floor(h / 24)}d`;
+}
+var RECO_LABEL = {
+  aprobar: "Aprobar",
+  cambios_menores: "Cambios menores",
+  cambios_mayores: "Cambios mayores",
+  bloqueado: "Bloqueado"
+};
+var RECO_COLOR = {
+  aprobar: colors.ok,
+  cambios_menores: colors.sky,
+  cambios_mayores: colors.warn,
+  bloqueado: colors.bad
+};
+function Header() {
+  return /* @__PURE__ */ jsxs(
+    Box,
+    {
+      borderStyle: "round",
+      borderColor: colors.purple,
+      paddingX: 1,
+      justifyContent: "space-between",
+      children: [
+        /* @__PURE__ */ jsxs(Box, { children: [
+          /* @__PURE__ */ jsx(Text, { color: colors.purpleLight, children: "\u2B21 " }),
+          /* @__PURE__ */ jsx(Text, { color: colors.purple, bold: true, children: "Git-Helper" }),
+          /* @__PURE__ */ jsx(Text, { color: colors.dim, children: "  \xB7  code review con IA" })
+        ] }),
+        /* @__PURE__ */ jsx(Text, { color: colors.dim, children: "\u{1F419}" })
+      ]
+    }
+  );
+}
+function StatusBar({ view }) {
+  const keys = view === "list" ? [
+    ["\u2191\u2193", "navegar"],
+    ["\u23CE", "analizar"],
+    ["r", "refrescar"],
+    ["q", "salir"]
+  ] : view === "analysis" ? [
+    ["esc", "volver"],
+    ["q", "salir"]
+  ] : [
+    ["\u23CE", "guardar"],
+    ["ctrl+c", "salir"]
+  ];
+  return /* @__PURE__ */ jsx(Box, { paddingX: 1, gap: 2, children: keys.map(([k, label]) => /* @__PURE__ */ jsxs(Box, { children: [
+    /* @__PURE__ */ jsx(Text, { color: colors.purpleLight, bold: true, children: k }),
+    /* @__PURE__ */ jsx(Text, { color: colors.dim, children: ` ${label}` })
+  ] }, k)) });
+}
+function TokenPrompt({ onSubmit }) {
+  const [value, setValue] = useState("");
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [
+    /* @__PURE__ */ jsx(Text, { color: colors.fg, bold: true, children: "Configura tu token de GitHub" }),
+    /* @__PURE__ */ jsxs(Box, { marginTop: 1, flexDirection: "column", children: [
+      /* @__PURE__ */ jsx(Text, { color: colors.gray, children: "Lo necesito para listar tus Pull Requests pendientes." }),
+      /* @__PURE__ */ jsx(Text, { color: colors.dim, children: "Cr\xE9alo en https://github.com/settings/tokens (scope: repo) y p\xE9galo aqu\xED." })
+    ] }),
+    /* @__PURE__ */ jsxs(Box, { marginTop: 1, children: [
+      /* @__PURE__ */ jsx(Text, { color: colors.purpleLight, children: "GITHUB_TOKEN \u25B8 " }),
+      /* @__PURE__ */ jsx(
+        TextInput,
+        {
+          value,
+          onChange: setValue,
+          onSubmit,
+          mask: "\u2022",
+          placeholder: "ghp_\u2026"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text, { color: colors.dim, children: "Se guardar\xE1 en ~/.config/git-helper/.env (solo en tu equipo)." }) })
+  ] });
+}
+function PRListView({
+  prs,
+  selected,
+  loading,
+  error
+}) {
+  if (loading) {
+    return /* @__PURE__ */ jsxs(Box, { paddingX: 1, paddingY: 1, children: [
+      /* @__PURE__ */ jsx(Text, { color: colors.purple, children: /* @__PURE__ */ jsx(Spinner, { type: "dots" }) }),
+      /* @__PURE__ */ jsx(Text, { color: colors.gray, children: " Cargando tus PRs pendientes\u2026" })
+    ] });
+  }
+  if (error) {
+    return /* @__PURE__ */ jsx(Box, { paddingX: 1, paddingY: 1, children: /* @__PURE__ */ jsx(Text, { color: colors.bad, children: `\u2717 ${error}` }) });
+  }
+  if (prs.length === 0) {
+    return /* @__PURE__ */ jsx(Box, { paddingX: 1, paddingY: 1, children: /* @__PURE__ */ jsx(Text, { color: colors.ok, children: "\u2713 No tienes PRs pendientes. \xA1Todo limpio!" }) });
+  }
+  return /* @__PURE__ */ jsx(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: prs.map((pr, i) => {
+    const active = i === selected;
+    return /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsx(Text, { color: active ? colors.purple : colors.dim, children: active ? "\u25B6 " : "  " }),
+      /* @__PURE__ */ jsx(Box, { width: 50, children: /* @__PURE__ */ jsx(
+        Text,
+        {
+          color: active ? colors.fg : colors.gray,
+          bold: active,
+          wrap: "truncate-end",
+          children: pr.title
+        }
+      ) }),
+      /* @__PURE__ */ jsx(Text, { color: colors.dim, children: `  ${pr.full_name} #${pr.number} \xB7 ${timeAgo(pr.created_at)}` })
+    ] }, `${pr.full_name}#${pr.number}`);
+  }) });
+}
+function AnalysisView({
+  refLabel,
+  analyzing,
+  analysis,
+  error
+}) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [
+    /* @__PURE__ */ jsx(Text, { color: colors.purpleLight, bold: true, children: refLabel }),
+    /* @__PURE__ */ jsx(Box, { marginTop: 1, flexDirection: "column", children: analyzing ? /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsx(Text, { color: colors.purple, children: /* @__PURE__ */ jsx(Spinner, { type: "dots" }) }),
+      /* @__PURE__ */ jsx(Text, { color: colors.gray, children: " Analizando con IA\u2026" })
+    ] }) : error ? /* @__PURE__ */ jsx(Text, { color: colors.bad, children: `\u2717 ${error}` }) : analysis ? /* @__PURE__ */ jsxs(Box, { flexDirection: "column", gap: 1, children: [
+      /* @__PURE__ */ jsxs(Box, { children: [
+        /* @__PURE__ */ jsx(Text, { color: colors.dim, children: "Puntuaci\xF3n  " }),
+        /* @__PURE__ */ jsx(
+          Text,
+          {
+            color: analysis.puntuacion_codigo >= 8 ? colors.ok : analysis.puntuacion_codigo >= 5 ? colors.warn : colors.bad,
+            bold: true,
+            children: `${analysis.puntuacion_codigo}/10`
+          }
+        ),
+        /* @__PURE__ */ jsx(Text, { color: colors.dim, children: "   Veredicto  " }),
+        /* @__PURE__ */ jsx(Text, { color: RECO_COLOR[analysis.recomendacion], bold: true, children: `\u25CF ${RECO_LABEL[analysis.recomendacion]}` })
+      ] }),
+      /* @__PURE__ */ jsx(Text, { color: colors.gray, children: analysis.resumen_ejecutivo }),
+      analysis.posibles_bugs.length > 0 ? /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsx(Text, { color: colors.warn, children: "Posibles bugs:" }),
+        analysis.posibles_bugs.map((b, i) => /* @__PURE__ */ jsx(Text, { color: colors.fg, children: `  \u2022 ${b}` }, i))
+      ] }) : /* @__PURE__ */ jsx(Text, { color: colors.ok, children: "\u2713 Sin bugs evidentes." })
+    ] }) : null })
+  ] });
+}
+function App({ token: initialToken }) {
+  const { exit } = useApp();
+  const { stdout } = useStdout();
+  const rows = stdout?.rows ?? 24;
+  const [token, setToken] = useState(initialToken);
+  const [prs, setPrs] = useState([]);
+  const [loading, setLoading] = useState(Boolean(initialToken));
+  const [listError, setListError] = useState(null);
+  const [selected, setSelected] = useState(0);
+  const [view, setView] = useState(initialToken ? "list" : "token");
+  const [refLabel, setRefLabel] = useState("");
+  const [analysis, setAnalysis] = useState(null);
+  const [analyzing, setAnalyzing] = useState(false);
+  const [analyzeError, setAnalyzeError] = useState(null);
+  async function loadList(tok) {
+    setLoading(true);
+    setListError(null);
+    try {
+      const data = await new GitHubAIService(tok).listPendingPullRequests();
+      setPrs(data);
+      setSelected(0);
+    } catch (e) {
+      setListError(e?.message ?? String(e));
+    } finally {
+      setLoading(false);
+    }
+  }
+  useEffect(() => {
+    if (initialToken) void loadList(initialToken);
+  }, []);
+  function handleToken(value) {
+    const t = value.trim();
+    if (!t) return;
+    setConfig("GITHUB_TOKEN", t);
+    process.env.GITHUB_TOKEN = t;
+    setToken(t);
+    setView("list");
+    void loadList(t);
+  }
+  async function analyze(pr) {
+    if (!token) return;
+    setRefLabel(`${pr.full_name} #${pr.number}`);
+    setView("analysis");
+    setAnalysis(null);
+    setAnalyzeError(null);
+    setAnalyzing(true);
+    try {
+      const result = await new GitHubAIService(token).analyzePR(
+        pr.owner,
+        pr.repo,
+        pr.number
+      );
+      setAnalysis(result);
+    } catch (e) {
+      setAnalyzeError(e?.message ?? String(e));
+    } finally {
+      setAnalyzing(false);
+    }
+  }
+  useInput(
+    (input, key) => {
+      if (input === "q") {
+        exit();
+        return;
+      }
+      if (view === "list") {
+        if (key.upArrow) setSelected((s) => Math.max(0, s - 1));
+        if (key.downArrow) setSelected((s) => Math.min(prs.length - 1, s + 1));
+        if (key.return && prs[selected]) void analyze(prs[selected]);
+        if (input === "r" && token) void loadList(token);
+      } else if (view === "analysis") {
+        if (key.escape) setView("list");
+      }
+    },
+    // En la vista de token, el TextInput gestiona el teclado (no capturamos 'q').
+    { isActive: view !== "token" }
+  );
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", height: rows, children: [
+    /* @__PURE__ */ jsx(Header, {}),
+    /* @__PURE__ */ jsx(Box, { flexGrow: 1, flexDirection: "column", children: view === "token" ? /* @__PURE__ */ jsx(TokenPrompt, { onSubmit: handleToken }) : view === "list" ? /* @__PURE__ */ jsx(PRListView, { prs, selected, loading, error: listError }) : /* @__PURE__ */ jsx(
+      AnalysisView,
+      {
+        refLabel,
+        analyzing,
+        analysis,
+        error: analyzeError
+      }
+    ) }),
+    /* @__PURE__ */ jsx(StatusBar, { view })
+  ] });
+}
+
+// src/tui/run.tsx
+import { jsx as jsx2 } from "react/jsx-runtime";
+async function runTui(token) {
+  const enterAltScreen = "\x1B[?1049h\x1B[H";
+  const leaveAltScreen = "\x1B[?1049l";
+  process.stdout.write(enterAltScreen);
+  const { waitUntilExit } = render(/* @__PURE__ */ jsx2(App, { token }));
+  try {
+    await waitUntilExit();
+  } finally {
+    process.stdout.write(leaveAltScreen);
+  }
+}
+export {
+  runTui
+};

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@alexis-reillo/git-helper",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Analiza Pull Requests de GitHub usando Inteligencia Artificial, desde la terminal.",
   "license": "MIT",
+  "type": "module",
   "bin": {
     "git-helper": "./dist/index.js"
   },
@@ -27,13 +28,19 @@
     "dotenv": "^17.4.2",
     "figlet": "^1.8.0",
     "gradient-string": "^2.0.2",
+    "ink": "^7.1.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
     "ora": "^5.4.1",
+    "react": "^19.2.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/figlet": "^1.7.0",
     "@types/gradient-string": "^1.1.6",
     "@types/node": "^20",
+    "@types/react": "^19.0.0",
+    "ink-testing-library": "^4.0.0",
     "tsup": "^8.0.0",
     "tsx": "^4.7.0",
     "vitest": "^2.1.9",