@dami_deleon/rikudo 1.0.1-alpha.0

package/README.md

@@ -0,0 +1,62 @@
+# 🌀 Rikudo: El Sabio de los Commits
+
+**Rikudo** es una herramienta de terminal (CLI) potenciada por Inteligencia Artificial (Google Gemini) diseñada para automatizar y estandarizar el flujo de trabajo de Git y la gestión de tareas en Redmine. 
+
+Inspirado en el Sabio de los Seis Caminos, Rikudo utiliza seis módulos especializados para observar tu código, entender el contexto de tus tareas y mantener la armonía en el repositorio siguiendo estrictamente las convenciones del equipo.
+
+---
+
+## 🚀 Los 6 Caminos de Rikudo
+
+1.  **Camino Deva (Git):** Control total sobre el stage y los commits.
+2.  **Camino Humano (Gemini AI):** Inteligencia profunda para redactar mensajes técnicos precisos.
+3.  **Camino Animal (Redmine):** Invocación y sincronización con el Project Manager.
+4.  **Camino Preta (Summarizer):** Absorción y síntesis de archivos de gran tamaño.
+5.  **Camino Naraka (Cache):** Memoria persistente basada en hashes de Git para optimizar tokens.
+6.  **Camino Asura (Rate Limiter):** Gestión de poder para respetar los límites de las APIs.
+
+---
+
+## 🛠️ Requisitos Previos
+
+- **Node.js** (v18 o superior)
+- **Git** instalado y configurado.
+- Una **API Key de Google Gemini**.
+- Acceso a la **API de Redmine** de tu organización.
+
+---
+
+## 📦 Instalación
+
+1.  **Clonar y preparar el proyecto:**
+    ```bash
+    git clone <url-de-tu-repo-rikudo>
+    cd rikudo
+    npm install
+    ```
+
+2.  **Compilar e Instalar Globalmente:**
+    ```bash
+    npm run build
+    npm link
+    ```
+
+Ahora el comando `rikudo` estará disponible en cualquier terminal de tu sistema.
+
+---
+
+## ⚙️ Configuración
+
+### 1. Variables de Entorno (`.env`)
+Crea un archivo `.env` en la raíz del proyecto (no olvides agregarlo a tu `.gitignore` global):
+
+```env
+# Credenciales
+GEMINI_API_KEY=tu_clave_aqui
+REDMINE_URL=[https://redmine.tuempresa.com](https://redmine.tuempresa.com)
+REDMINE_API_KEY=tu_clave_de_redmine
+
+# Límites de la API (Evita el error 429)
+AI_REQUESTS_PER_DAY=1500
+AI_REQUESTS_PER_MINUTE=15
+AI_TOKENS_PER_MINUTE=1000000

package/dist/ai/drivers/claude.js

@@ -0,0 +1,62 @@
+import { getFromEnv, testEnvVar } from "../../utils/config.js";
+import Anthropic from "@anthropic-ai/sdk";
+function getAnthropic() {
+    const { CLAUDE_API_KEY } = getFromEnv("CLAUDE_API_KEY");
+    const client = new Anthropic({
+        apiKey: CLAUDE_API_KEY,
+    });
+    return client;
+}
+async function getModels() {
+    return [
+        "claude-opus-4-6",
+        "claude-opus-4-5-20251101",
+        "claude-opus-4-5",
+        "claude-3-7-sonnet-latest",
+        "claude-3-7-sonnet-20250219",
+        "claude-3-5-haiku-latest",
+        "claude-3-5-haiku-20241022",
+        "claude-haiku-4-5",
+        "claude-haiku-4-5-20251001",
+        "claude-sonnet-4-20250514",
+        "claude-sonnet-4-0",
+        "claude-4-sonnet-20250514",
+        "claude-sonnet-4-5",
+        "claude-sonnet-4-5-20250929",
+        "claude-opus-4-0",
+        "claude-opus-4-20250514",
+        "claude-4-opus-20250514",
+        "claude-opus-4-1-20250805",
+        "claude-3-opus-latest",
+        "claude-3-opus-20240229",
+        "claude-3-haiku-20240307",
+    ];
+}
+async function validateSettings() {
+    return testEnvVar("CLAUDE_API_KEY");
+}
+async function generate(model, prompt) {
+    const client = getAnthropic();
+    const message = await client.messages.create({
+        model: model,
+        messages: [
+            {
+                role: "user",
+                content: prompt,
+            },
+        ],
+        max_tokens: 1000,
+    });
+    return message.content
+        .map((m) => (m.type === "text" ? m.text : ""))
+        .join(" ");
+}
+export function ClaudeDriver(modelSelected = "claude-2") {
+    return {
+        name: "claude",
+        modelSelected: modelSelected || "claude-2",
+        getModels,
+        generate: (prompt) => generate(modelSelected, prompt),
+        validateSettings,
+    };
+}

package/dist/ai/drivers/gemini.js

@@ -0,0 +1,50 @@
+import { GoogleGenerativeAI } from "@google/generative-ai";
+import { getConfig, testEnvVar } from "../../utils/config.js";
+import { RateLimiter } from "../../services/rateLimiter.js";
+const limiter = new RateLimiter();
+const getGoogleAI = async () => {
+    const config = getConfig();
+    return new GoogleGenerativeAI(config.GEMINI_API_KEY);
+};
+// Estimación burda de tokens (4 caracteres ~= 1 token) para el check previo
+const estimateTokens = (text) => Math.ceil(text.length / 4);
+const generateContent = async (modelName, prompt) => {
+    const estimatedInputTokens = estimateTokens(prompt);
+    await limiter.checkLimit(estimatedInputTokens);
+    try {
+        const genAI = await getGoogleAI();
+        const model = genAI.getGenerativeModel({ model: modelName });
+        const result = await model.generateContent(prompt);
+        const response = result.response;
+        const outputText = response.text();
+        const totalTokens = estimatedInputTokens + estimateTokens(outputText);
+        limiter.logRequest(totalTokens);
+        return outputText;
+    }
+    catch (error) {
+        throw error;
+    }
+};
+const validateSettings = async () => {
+    return testEnvVar("GEMINI_API_KEY");
+};
+async function getModels() {
+    return [
+        "gemini-flash-lite-latest",
+        "gemini-2.5-flash-lite",
+        "gemini-2.5-flash",
+        "gemini-2.5-pro",
+        "gemini-3-pro-preview",
+        "gemini-3-flash-preview",
+        "gemma-3-27b-it",
+    ];
+}
+export function GeminiDriver(modelSelected = "gemini-2.5-flash-lite") {
+    return {
+        name: "gemini",
+        modelSelected: modelSelected || "gemini-2.5-flash-lite",
+        getModels,
+        generate: (prompt) => generateContent(modelSelected, prompt),
+        validateSettings,
+    };
+}

package/dist/ai/drivers/ollama.js

@@ -0,0 +1,30 @@
+import ollama from "ollama";
+export function OllamaDriver(model = '') {
+    return {
+        name: "Ollama (Local)",
+        modelSelected: model,
+        getModels: async () => {
+            const listResponse = await ollama.list();
+            return listResponse.models.map((modelResponse) => modelResponse.name);
+        },
+        generate: async (prompt) => {
+            if (model === '') {
+                throw new Error("Modelo de Ollama no seleccionado, seleccione uno en la configuración.");
+            }
+            const response = await ollama.chat({
+                model: model,
+                messages: [
+                    {
+                        role: "user",
+                        content: prompt,
+                    },
+                ],
+            });
+            return response.message.content;
+        },
+        validateSettings: async () => {
+            const listResponse = await ollama.list();
+            return listResponse.models.length > 0;
+        },
+    };
+}

package/dist/ai/drivers/openai.js

@@ -0,0 +1,24 @@
+import OpenAI from "openai";
+import { getFromEnv, testEnvVar } from "../../utils/config.js";
+export function OpenAIDriver(model = "gpt-5-nano") {
+    return {
+        name: "OpenAI",
+        modelSelected: model,
+        getModels: async () => {
+            return ["gpt-5.2", "gpt-5-mini", "gpt-5-nano", "gpt-4.1"];
+        },
+        generate: async (prompt) => {
+            const openai = new OpenAI({
+                apiKey: getFromEnv("OPENAI_API_KEY").OPENAI_API_KEY,
+            });
+            const response = await openai.responses.create({
+                model: model,
+                input: prompt,
+            });
+            return response.output_text;
+        },
+        validateSettings: async () => {
+            return testEnvVar("OPENAI_API_KEY");
+        },
+    };
+}

package/dist/ai/factory.js

@@ -0,0 +1,39 @@
+import { GeminiDriver } from "./drivers/gemini.js";
+import { getAIPreferenceConfig } from "../services/configManager.js";
+import { OllamaDriver } from "./drivers/ollama.js";
+import { OpenAIDriver } from "./drivers/openai.js";
+import { ClaudeDriver } from "./drivers/claude.js";
+const Providers = {
+    gemini: {
+        name: "gemini",
+        label: "Google Gemini",
+        driver: GeminiDriver,
+    },
+    ollama: {
+        name: "ollama",
+        label: "Ollama (local)",
+        driver: OllamaDriver,
+    },
+    openai: {
+        name: "openai",
+        label: "OpenAI",
+        driver: OpenAIDriver,
+    },
+    claude: {
+        name: "claude",
+        label: "Claude Anthropic",
+        driver: ClaudeDriver,
+    }
+};
+export function getAIProviders() {
+    return Providers;
+}
+export function getAIProvider() {
+    const { provider, model } = getAIPreferenceConfig();
+    if (provider in Providers) {
+        return Providers[provider].driver(model);
+    }
+    throw new Error(`Proveedores disponibles: ${Object.values(getAIProviders())
+        .map((p) => p.label)
+        .join(", ")}`);
+}

package/dist/ai/gemini.js

@@ -0,0 +1,79 @@
+import { GoogleGenerativeAI } from '@google/generative-ai';
+import { config, getConventions, getPRTemplate } from '../utils/config.js';
+import { RateLimiter } from '../services/rateLimiter.js';
+const genAI = new GoogleGenerativeAI(config.GEMINI_API_KEY);
+const model = genAI.getGenerativeModel({ model: "gemini-2.5-flash" });
+const limiter = new RateLimiter();
+// Estimación burda de tokens (4 caracteres ~= 1 token) para el check previo
+const estimateTokens = (text) => Math.ceil(text.length / 4);
+export const generateContent = async (prompt) => {
+    // 1. Verificar Límites antes de llamar
+    const estimatedInputTokens = estimateTokens(prompt);
+    await limiter.checkLimit(estimatedInputTokens);
+    try {
+        const result = await model.generateContent(prompt);
+        const response = result.response;
+        // 2. Registrar consumo real (Gemini a veces devuelve metadata de uso, 
+        // si no, usamos la estimación de salida + entrada)
+        const outputText = response.text();
+        const totalTokens = estimatedInputTokens + estimateTokens(outputText);
+        limiter.logRequest(totalTokens);
+        return outputText;
+    }
+    catch (error) {
+        // Si Gemini devuelve 429, es bueno capturarlo aquí también
+        throw error;
+    }
+};
+export const generateCommitMessage = async (diff, ticketInfo, fileContext) => {
+    const conventions = getConventions();
+    const ticketContext = ticketInfo
+        ? `Contexto del Ticket #${ticketInfo.id}: ${ticketInfo.subject} - ${ticketInfo.description}`
+        : "No hay ticket asociado.";
+    const prompt = `
+    Actúa como un Senior Software Engineer. Genera un mensaje de commit siguiendo ESTRICTAMENTE estas convenciones:
+    ${conventions}
+
+    ${ticketInfo ? `IMPORTANTE: El commit debe incluir la referencia al ticket #${ticketInfo.id} según las convenciones.` : ''}
+
+    INFORMACIÓN DE ENTRADA:
+    1. Contexto de la Tarea (Redmine): ${ticketContext}
+    2. Resumen de archivos modificados: ${fileContext}
+    3. Git Diff (Cambios exactos):
+    ${diff.slice(0, 10000)} (Truncado si es muy largo)
+
+    SALIDA:
+    Solo devuelve el mensaje del commit, sin explicaciones extra, ni bloques de código markdown.
+  `;
+    return await generateContent(prompt);
+};
+export const generatePRDescription = async (commits, ticketInfo, templatePath) => {
+    const template = getPRTemplate(templatePath);
+    const ticketContext = ticketInfo
+        ? `Ticket #${ticketInfo.id}: ${ticketInfo.subject}\nDescripción: ${ticketInfo.description}`
+        : "No hay ticket asociado.";
+    const prompt = `
+    Actúa como un Tech Lead. Tu tarea es completar la plantilla de Pull Request basándote en los commits realizados y la tarea original.
+
+    ENTRADA:
+    1. Historial de Commits recientes:
+    ${commits}
+
+    2. Información de la Tarea (Redmine):
+    ${ticketContext}
+
+    3. PLANTILLA A RELLENAR (Formato Markdown):
+    ${template}
+
+    INSTRUCCIONES:
+    - Rellena la plantilla con información relevante extraída de los commits y el ticket.
+    - Sé profesional pero directo.
+    - Si la plantilla tiene checkboxes [ ], marca los que apliquen con [x].
+    - NO inventes funcionalidades que no estén en los commits.
+    - Manten el formato Markdown.
+
+    SALIDA:
+    Solo el contenido de la plantilla rellena.
+  `;
+    return await generateContent(prompt);
+};

package/dist/ai/interfaces.js

@@ -0,0 +1 @@
+export {};

package/dist/ai/prompts.js

@@ -0,0 +1,70 @@
+import { getConfig } from "../utils/config.js";
+export function generateCommitMessagePrompt(diff, conventions, ticketInfo, fileContext) {
+    const { REDMINE_URL } = getConfig();
+    const ticketContext = ticketInfo
+        ? `Contexto del Ticket #${ticketInfo.id}: ${ticketInfo.subject} - ${ticketInfo.description}
+URL del ticket: ${REDMINE_URL}/issues/${ticketInfo.id}`
+        : "No hay ticket asociado.";
+    const prompt = `
+Actúa como un Senior Software Engineer. Genera un mensaje de commit siguiendo ESTRICTAMENTE estas convenciones:
+${conventions}
+
+${ticketInfo ? `IMPORTANTE: El commit debe incluir la referencia al ticket #${ticketInfo.id} según las convenciones.` : ""}
+
+INFORMACIÓN DE ENTRADA:
+1. Contexto de la Tarea (Redmine): ${ticketContext}
+---
+
+2. Resumen de archivos modificados: ${fileContext}
+---
+
+3. Git Diff (Cambios exactos):
+${diff.slice(0, 20000)} (Truncado si es muy largo)
+
+SALIDA:
+Solo devuelve el mensaje del commit, sin explicaciones extra, ni bloques de código markdown.`;
+    return prompt;
+}
+export function generateProjectManagerCommentPrompt(ticketInfo, commitMessage) {
+    return `Actúa como un Project Manager profesional. Debes escribir un comentario ejecutivo, directo, claro y conciso, para ser publicado en un comentario del ticket de Redmine.
+El comentario debe servir como un resumen de estado para stakeholders, sintetizando la información técnica del último commit en un lenguaje accesible.
+
+Contexto y Datos del Ticket:
+ID y Asunto del Ticket: ${ticketInfo.tracker}  #${ticketInfo.id} - ${ticketInfo.subject}
+Descripción Original: ${ticketInfo.description}
+Registro del Último Commit (Log Técnico): ${commitMessage}
+
+SALIDA:
+Solo devuelve el comentario, sin títulos o subtítulos o lineas de saludos.
+
+`;
+}
+export function generatePullRequestMessagePrompt(commits, ticketInfo, template) {
+    const ticketContext = ticketInfo
+        ? `Ticket #${ticketInfo.id}: ${ticketInfo.subject}\nDescripción: ${ticketInfo.description}`
+        : "No hay ticket asociado.";
+    const prompt = `
+Actúa como un Tech Lead. Tu tarea es completar la plantilla de Pull Request basándote en los commits realizados y la tarea original.
+
+ENTRADA:
+1. Historial de Commits recientes:
+${commits}
+
+2. Información de la Tarea (Redmine):
+${ticketContext}
+
+3. PLANTILLA A RELLENAR (Formato Markdown):
+${template}
+
+INSTRUCCIONES:
+- Rellena la plantilla con información relevante extraída de los commits y el ticket.
+- Sé profesional pero directo.
+- Si la plantilla tiene checkboxes [ ], marca los que apliquen con [x].
+- NO inventes funcionalidades que no estén en los commits.
+- Mantener el formato Markdown.
+
+SALIDA:
+Solo el contenido de la plantilla rellena.
+  `;
+    return prompt;
+}

package/dist/const/paths.js

@@ -0,0 +1,4 @@
+const COMMIT_CONVENTIONS_PATH = "./conventions.txt";
+const PULL_REQUEST_TEMPLATE_PATH = "./pull-request-template.txt";
+const ENV_PATH = "./.env";
+export { COMMIT_CONVENTIONS_PATH, PULL_REQUEST_TEMPLATE_PATH, ENV_PATH };