@dami_deleon/rikudo 1.1.0 → 2.0.1

package/README.md

@@ -1,107 +1,182 @@
 # 🌀 Rikudo: El Sabio de los Commits
 
-**Rikudo** es una herramienta de terminal (CLI) potenciada por Inteligencia Artificial diseñada para automatizar y estandarizar el flujo de trabajo de Git y la gestión de tareas en Redmine. 
+**Rikudo** es una herramienta CLI potenciada por Inteligencia Artificial, agnóstica del proveedor de IA, 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.
+Inspirado en el Sabio de los Seis Caminos, Rikudo utiliza módulos especializados para observar tu código, entender el contexto de tus tareas y mantener la armonía en el repositorio siguiendo 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.
+2.  **Camino Humano (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.
 
+---
 
-## ✨ Características Principales
+## ✨ Dos Modos de Uso
+
+Rikudo puede usarse de dos maneras:
+
+### Modo CLI
+Interactúa directamente desde la terminal con un menú interactivo o comandos directos.
+
+### Modo MCP (Model Context Protocol)
+Actúa como servidor MCP, exponiendo herramientas y prompts para que agentes de IA externos (Claude Code, Gemini CLI, Cursor, etc.) puedan invocar sus funcionalidades.
+
+---
 
-* **🧠 Multi-Provider AI:** Tú eliges el cerebro. Soporte nativo para:
-* **Google Gemini** (Rápido y eficiente)
-* **OpenAI GPT-4o / GPT-3.5** (El estándar)
-* **Anthropic Claude** (Gran capacidad de contexto)
-* **Ollama** (Privacidad total con modelos locales como Llama 3)
+## ✨ Características Principales
 
+* **🧠 Agnóstico de IA:** Tú eliges el cerebro. Soporte nativo para:
+  * **Google Gemini** (Rápido y eficiente)
+  * **OpenAI GPT-4o / GPT-3.5** (El estándar)
+  * **Anthropic Claude** (Gran capacidad de contexto)
+  * **Ollama** (Privacidad total con modelos locales como Llama 3)
 
 * **📝 Smart Commits:** Analiza tus `staged files` y genera mensajes siguiendo **Conventional Commits** basados en tus propias reglas.
 * **🚀 PR Generator:** Selecciona múltiples commits y genera una descripción de Pull Request completa siguiendo tu plantilla.
 * **⚙️ Configuración Flexible:** Define tus preferencias globales o por proyecto.
-* **🔍 Diagnóstico Integrado:** Herramienta `test` para verificar tus API Keys y conexión con servicios externos (Redmine, IA, etc.).
+* **🔍 Diagnóstico Integrado:** Herramienta `test` para verificar tus API Keys y conexión con servicios externos.
+* **🔌 Servidor MCP:** Actúa como skill library para agentes de IA externos mediante el protocolo MCP.
 
 ## 📦 Instalación
 
-Rikudo está disponible en npm (actualmente en Alpha).
-
-### Uso global (Recomendado)
-
 ```bash
-npm install -g @dami_deleon/rikudo@alpha
-
+npm install -g @dami_deleon/rikudo
 ```
 
 ### Ejecución única (sin instalar)
 
 ```bash
-npx @dami_deleon/rikudo@alpha
-
+npx @dami_deleon/rikudo
 ```
 
+---
+
 ## 🚀 Uso Rápido
 
-Simplemente ejecuta el comando en tu terminal dentro de cualquier repositorio git:
+### Modo CLI
+
+Ejecuta el comando en tu terminal dentro de cualquier repositorio git:
 
 ```bash
 rikudo
-
 ```
 
 Esto abrirá el **Menú Interactivo** donde podrás elegir entre crear commits, PRs o configurar la herramienta.
 
-### Comandos Directos
-
-Si eres un power-user, puedes usar atajos:
+#### Comandos Directos
 
 * **Crear Commit:**
 ```bash
 rikudo commit
 # O con ticket asociado:
 rikudo commit -t 1234
-
 ```
 
-
 * **Crear Pull Request:**
 ```bash
 rikudo pr
 # O con ticket asociado:
 rikudo pr -t 1234
-
 ```
 
-
 * **Diagnóstico de Conexión:**
 ```bash
 rikudo test
-
 ```
 
-
 * **Configuración:**
 ```bash
 rikudo config
+```
+
+---
+
+### Modo MCP
+
+Para usar Rikudo como servidor MCP con cualquier agente de IA compatible:
+
+```bash
+rikudo mcp
+```
+
+El servidor se comunica mediante **stdio**, permitiendo integrarse con cualquier cliente MCP.
+
+#### Herramientas Disponibles
+
+| Herramienta | Descripción |
+|------------|-------------|
+| `validate_configuration` | Verifica que las variables de entorno necesarias (Redmine, Gitea) estén configuradas correctamente. |
+| `get_ticket_context` | Obtiene el contexto completo de un ticket de Redmine (título, descripción, estado, prioridad). |
+| `get_git_diff` | Retorna el diff de los archivos que están en staging (`git add`). |
+| `shift_left_start` | Flujo shift-left completo: checkout a rama objetivo, crea nueva rama, commit vacío y abre Draft PR en Gitea. Soporta parámetro `isWip` para usar prefijo "WIP:" en el título. |
+| `update_pm_redmine` | Agrega un comentario a un ticket de Redmine para notificar al Project Manager. |
+
+#### Prompts Disponibles
+
+| Prompt | Descripción |
+|--------|-------------|
+| `start_feature` | Inicia el flujo de trabajo para una nueva feature. Obtiene contexto del ticket, genera nombre de rama y prepara el entorno en Gitea con PR en modo WIP. |
+| `review_and_comment` | Analiza los cambios staged, genera un comentario técnico y lo publica en Redmine. |
+
+#### Integración con Agentes IA
+
+Rikudo es compatible con cualquier herramienta de IA que soporte el protocolo MCP, como:
+- **Claude Code / Claude Desktop**
+- **Gemini CLI**
+- **Cursor**
+- **Windsurf**
+- **Continue**
+- Y cualquier otro cliente MCP
+
+Agrega esto en la configuración de tu cliente MCP:
+
+```json
+{
+  "mcpServers": {
+    "rikudo": {
+      "command": "rikudo",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+#### Variables de Entorno para MCP
+
+```env
+# Redmine
+RIKUDO_REDMINE_URL=https://redmine.tuempresa.com
+RIKUDO_REDMINE_API_KEY=tu_redmine_key
+
+# Gitea
+RIKUDO_GITEA_URL=https://gitea.tuempresa.com
+RIKUDO_GITEA_TOKEN=tu_gitea_token
+RIKUDO_GITEA_OWNER=tu_usuario_o_organizacion
+RIKUDO_GITEA_REPO=nombre_del_repositorio
+```
+
+#### Formato de Ramas
+
+Al usar `start_feature` o `shift_left_start`, el nombre de rama sigue el formato:
 
+```
+[numero-tarea]-[titulo-tarea-ingles-corto]
 ```
 
+Ejemplo: `1234-add-user-authentication`
 
+---
 
 ## ⚙️ Configuración
 
 Rikudo busca un archivo `.env` en la raíz de tu proyecto para las credenciales sensibles.
 
-Crea un archivo `.env` y añade las variables según el proveedor que quieras usar:
-
 ```env
 # --- Configuración General ---
 RIKUDO_AI_PROVIDER=gemini  # Opciones: gemini, openai, claude, ollama
@@ -115,41 +190,28 @@ RIKUDO_CLAUDE_API_KEY=tu_api_key_aqui
 RIKUDO_OLLAMA_URL=http://localhost:11434/api/generate
 RIKUDO_OLLAMA_MODEL=llama3
 
-# --- Integraciones (Opcional) ---
+# --- Integraciones ---
 RIKUDO_REDMINE_URL=https://redmine.tuempresa.com
 RIKUDO_REDMINE_API_KEY=tu_redmine_key
 
+# --- Gitea (para servidor MCP) ---
+RIKUDO_GITEA_URL=https://gitea.tuempresa.com
+RIKUDO_GITEA_TOKEN=tu_gitea_token
+RIKUDO_GITEA_OWNER=tu_usuario_o_organizacion
+RIKUDO_GITEA_REPO=nombre_del_repositorio
 ```
 
-### Plantillas Personalizadas (Templates)
-
-Puedes personalizar cómo Rikudo escribe. Coloca estos archivos en la raíz de tu proyecto:
+### Plantillas Personalizadas
 
 1. **`conventions.txt`**: Reglas para tus commits.
-* *Ejemplo:* "Usa emojis al inicio. Formato: <emoji> <tipo>: <mensaje>."
-
-
 2. **`pull-request-template.txt`**: Estructura para tus PRs.
-* *Ejemplo:*
-```markdown
-# Cambios
-- ...
-# Tickets Relacionados
-- ...
-
-```
-
-
-
 
+---
 
 ## 🛠️ Solución de Problemas
 
-Si tienes problemas de conexión o configuración, ejecuta el diagnóstico:
-
 ```bash
 rikudo test
-
 ```
 
 Esto validará:
@@ -160,4 +222,4 @@ Esto validará:
 
 ---
 
-Hecho con ❤️ y TypeScript.
+Hecho con ❤️ y TypeScript.

package/dist/ai/prompts.js

@@ -36,7 +36,6 @@ 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) {
@@ -65,6 +64,6 @@ INSTRUCCIONES:
 
 SALIDA:
 Solo el contenido de la plantilla rellena.
-  `;
+`;
     return prompt;
 }

package/dist/index.js

@@ -16,6 +16,7 @@ import { generateCommitMessagePrompt, generateProjectManagerCommentPrompt, gener
 import { getConventions, getPRTemplate } from "./utils/config.js";
 import { showIssueMenu } from "./menus/issueMenu.js";
 import { runDiagnostics } from "./test/connection.js";
+import { runMCPServer } from "./mcp/server.js";
 import { COMMIT_CONVENTIONS_PATH, ENV_PATH, PULL_REQUEST_TEMPLATE_PATH } from "./const/paths.js";
 // --- Setup ---
 const __filename = fileURLToPath(import.meta.url);
@@ -62,6 +63,14 @@ program
     .command("config")
     .description("Abrir menú de configuración")
     .action(() => showConfigMenu());
+// MCP Server
+program
+    .command("mcp")
+    .description("Iniciar servidor MCP (Model Context Protocol) para agentes de IA")
+    .action(async (options) => {
+    loadEnv(options.env);
+    await runMCPServer();
+});
 // --- Modo Interactivo (Default) ---
 program
     .description("Modo interactivo del Sabio Rikudo")

package/dist/mcp/server.js

@@ -0,0 +1,226 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { simpleGit } from "simple-git";
+import { getIssueDetails, updateIssueComment } from "../services/redmine.js";
+import { getStagedDiff } from "../services/git.js";
+import { createPullRequest } from "../services/gitea.js";
+import { loadEnv } from "../utils/env.js";
+import { getConfig } from "../utils/config.js";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packagePath = path.resolve(__dirname, "../../package.json");
+const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf-8"));
+const git = simpleGit();
+const server = new McpServer({
+    name: "rikudo-mcp-server",
+    version: packageJson.version || "1.0.0",
+});
+server.registerTool("get_ticket_context", {
+    title: "Get Ticket Context",
+    description: "Obtiene el contexto completo de un ticket de Redmine (título, descripción, estado, prioridad).",
+    inputSchema: z.object({
+        ticketId: z.string().describe("ID del ticket de Redmine (ej: '1234')"),
+    }),
+}, async ({ ticketId }) => {
+    try {
+        const ticket = await getIssueDetails(ticketId);
+        if (!ticket) {
+            return {
+                content: [{ type: "text", text: `No se pudo obtener el ticket #${ticketId}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: ticket.id,
+                        subject: ticket.subject,
+                        description: ticket.description,
+                        status: ticket.status,
+                        priority: ticket.priority,
+                        author: ticket.author,
+                        url: ticket.url,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Error desconocido";
+        return { content: [{ type: "text", text: `Error: ${errorMessage}` }], isError: true };
+    }
+});
+server.registerTool("get_git_diff", {
+    title: "Get Git Diff",
+    description: "Obtiene el diff de los cambios que están en staging (git add). Retorna el diff crudo.",
+    inputSchema: z.object({}),
+}, async () => {
+    try {
+        const diff = await getStagedDiff();
+        if (!diff) {
+            return {
+                content: [{ type: "text", text: "No hay cambios en staging. Ejecuta 'git add' primero." }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: diff }] };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Error desconocido";
+        return { content: [{ type: "text", text: `Error: ${errorMessage}` }], isError: true };
+    }
+});
+server.registerTool("validate_configuration", {
+    title: "Validate Configuration",
+    description: "Verifica si todas las variables de entorno necesarias para Rikudo (Redmine, Gitea y Proveedor de IA) están configuradas correctamente en el sistema del usuario. Llama a esta herramienta antes de intentar interactuar con tickets o repositorios.",
+    inputSchema: z.object({}),
+}, async () => {
+    const config = getConfig();
+    const missingVars = [];
+    if (!config.REDMINE_URL)
+        missingVars.push("RIKUDO_REDMINE_URL");
+    if (!config.REDMINE_API_KEY)
+        missingVars.push("RIKUDO_REDMINE_API_KEY");
+    if (!config.GITEA_URL)
+        missingVars.push("RIKUDO_GITEA_URL");
+    if (!config.GITEA_TOKEN)
+        missingVars.push("RIKUDO_GITEA_TOKEN");
+    if (missingVars.length === 0) {
+        return {
+            content: [{ type: "text", text: "✅ Configuración de entorno válida. Todos los sistemas listos." }],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `❌ Faltan las siguientes variables de entorno: ${missingVars.join(", ")}. Por favor, pide al usuario que las configure en su archivo .env antes de continuar.`,
+            },
+        ],
+        isError: true,
+    };
+});
+server.registerTool("shift_left_start", {
+    title: "Shift Left Start",
+    description: "Inicia un flujo shift-left: hace checkout a la rama objetivo, crea una nueva rama, hace commit vacío y abre un Draft PR en Gitea.",
+    inputSchema: z.object({
+        ticketId: z.string().describe("ID del ticket de Redmine (ej: '1234')"),
+        branchName: z.string().describe("Nombre de la nueva rama a crear (ej: '1234-add-user-auth')"),
+        targetBranch: z.string().default("alpha").describe("Rama base para hacer checkout (default: 'alpha')"),
+        isWip: z.boolean().default(false).describe("Si es true, el PR título lleva prefijo 'WIP:' (Work In Progress)"),
+    }),
+}, async ({ ticketId, branchName, targetBranch, isWip }) => {
+    try {
+        await git.checkout(targetBranch);
+        await git.pull("origin", targetBranch);
+        await git.checkoutLocalBranch(branchName);
+        await git.commit("chore: init #" + ticketId, ["--allow-empty"]);
+        await git.push(["-u", "origin", branchName]);
+        const ticket = await getIssueDetails(ticketId);
+        const prTitle = isWip
+            ? `WIP: ${ticket?.subject || `Ticket #${ticketId}`}`
+            : `Draft: ${ticket?.subject || `Ticket #${ticketId}`}`;
+        const prBody = `## Descripción\n\nTrabajo iniciado para el ticket #${ticketId}${ticket ? `\n\n**${ticket.subject}**` : ""}`;
+        const prResult = await createPullRequest({
+            title: prTitle,
+            head: branchName,
+            base: targetBranch,
+            body: prBody,
+            draft: true,
+        });
+        if (!prResult.success) {
+            return {
+                content: [{ type: "text", text: `Rama '${branchName}' creada y empujada a origin. Error al crear PR: ${prResult.error}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        branch: branchName,
+                        targetBranch,
+                        prUrl: prResult.url,
+                        prNumber: prResult.number,
+                        message: `Entorno preparado en rama '${branchName}'. Draft PR creado: ${prResult.url}`,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Error desconocido";
+        return { content: [{ type: "text", text: `Error en shift_left_start: ${errorMessage}` }], isError: true };
+    }
+});
+server.registerTool("update_pm_redmine", {
+    title: "Update PM Redmine",
+    description: "Agrega un comentario a un ticket de Redmine. Ideal para notificar al Project Manager.",
+    inputSchema: z.object({
+        ticketId: z.string().describe("ID del ticket de Redmine (ej: '1234')"),
+        commentMarkdown: z.string().describe("Comentario en formato Markdown/Textile para Redmine"),
+    }),
+}, async ({ ticketId, commentMarkdown }) => {
+    try {
+        await updateIssueComment(ticketId, commentMarkdown);
+        return {
+            content: [{ type: "text", text: `Comentario agregado exitosamente al ticket #${ticketId}` }],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Error desconocido";
+        return { content: [{ type: "text", text: `Error actualizando Redmine: ${errorMessage}` }], isError: true };
+    }
+});
+server.registerPrompt("start_feature", {
+    title: "Start Feature",
+    description: "Inicia el flujo de trabajo para una nueva feature. Obtiene contexto del ticket y prepara el entorno en Gitea.",
+    argsSchema: {
+        ticket_id: z.string().describe("ID del ticket de Redmine"),
+    },
+}, async ({ ticket_id }) => {
+    return {
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Eres un asistente de desarrollo. Llama a la herramienta 'get_ticket_context' para el ticket ${ticket_id}. Lee su título y descripción. Genera un nombre de rama en inglés, cortas y en minúsculas, con el formato '[numero-tarea]-[titulo-tarea-ingles-corto]' (ej: '1234-add-user-authentication'). Luego, llama obligatoriamente a la herramienta 'shift_left_start' con esos datos para preparar mi entorno de trabajo en Gitea.`,
+                },
+            },
+        ],
+    };
+});
+server.registerPrompt("review_and_comment", {
+    title: "Review and Comment",
+    description: "Analiza los cambios staged, genera un comentario técnico para el Project Manager y lo publica en Redmine.",
+    argsSchema: {
+        ticket_id: z.string().describe("ID del ticket de Redmine"),
+    },
+}, async ({ ticket_id }) => {
+    return {
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Llama a la herramienta 'get_git_diff'. Analiza profundamente los cambios de código. Redacta un comentario técnico formal para el Project Manager explicando qué se hizo. Finalmente, llama a la herramienta 'update_pm_redmine' con el ${ticket_id} y el comentario generado para notificar al equipo.`,
+                },
+            },
+        ],
+    };
+});
+export async function runMCPServer() {
+    loadEnv();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Rikudo MCP Server started");
+}

package/dist/services/gitea.js

@@ -0,0 +1,59 @@
+import axios, { AxiosError } from "axios";
+const getGiteaConfig = () => {
+    return {
+        url: process.env.RIKUDO_GITEA_URL || "",
+        token: process.env.RIKUDO_GITEA_TOKEN || "",
+        owner: process.env.RIKUDO_GITEA_OWNER || "",
+        repo: process.env.RIKUDO_GITEA_REPO || "",
+    };
+};
+const getGiteaClient = () => {
+    const config = getGiteaConfig();
+    return axios.create({
+        baseURL: config.url,
+        headers: {
+            Authorization: `token ${config.token}`,
+            "Content-Type": "application/json",
+        },
+    });
+};
+export const createPullRequest = async (payload) => {
+    const config = getGiteaConfig();
+    if (!config.url || !config.token || !config.owner || !config.repo) {
+        return {
+            success: false,
+            error: "Faltan variables de entorno de Gitea (RIKUDO_GITEA_URL, RIKUDO_GITEA_TOKEN, RIKUDO_GITEA_OWNER, RIKUDO_GITEA_REPO)",
+        };
+    }
+    try {
+        const client = getGiteaClient();
+        const endpoint = `/api/v1/repos/${config.owner}/${config.repo}/pulls`;
+        const response = await client.post(endpoint, {
+            title: payload.title,
+            head: payload.head,
+            base: payload.base,
+            body: payload.body,
+            draft: payload.draft ?? false,
+        });
+        return {
+            success: true,
+            url: response.data.html_url,
+            number: response.data.number,
+        };
+    }
+    catch (error) {
+        if (error instanceof AxiosError) {
+            return {
+                success: false,
+                error: `Error de Gitea: ${error.message} - ${error.response?.data?.message || ""}`,
+            };
+        }
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : "Error desconocido al crear PR",
+        };
+    }
+};
+export const Gitea = {
+    createPullRequest,
+};

package/dist/utils/config.js

@@ -17,6 +17,10 @@ export function getConfig() {
         REDMINE_URL: process.env.RIKUDO_REDMINE_URL || "",
         REDMINE_API_KEY: process.env.RIKUDO_REDMINE_API_KEY || "",
         PROJECT_ID: process.env.RIKUDO_REDMINE_PROJECT_ID || "",
+        GITEA_URL: process.env.RIKUDO_GITEA_URL || "",
+        GITEA_TOKEN: process.env.RIKUDO_GITEA_TOKEN || "",
+        GITEA_OWNER: process.env.RIKUDO_GITEA_OWNER || "",
+        GITEA_REPO: process.env.RIKUDO_GITEA_REPO || "",
     };
 }
 export function getLimits() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dami_deleon/rikudo",
-  "version": "1.1.0",
+  "version": "2.0.1",
   "description": "El Sabio de los Commits: AI Assistant con integración a Redmine",
   "main": "dist/index.js",
   "type": "module",
@@ -35,6 +35,7 @@
     "@anthropic-ai/sdk": "0.74.0",
     "@google/generative-ai": "0.24.1",
     "@inquirer/prompts": "8.2.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "@types/figlet": "1.7.0",
     "axios": "1.13.2",
     "chalk": "5.6.2",