@dami_deleon/rikudo 2.0.0 → 2.0.1

package/README.md

@@ -1,115 +1,113 @@
 # 🌀 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.
-7.  **Camino MCP (Model Context Protocol):** Servidor MCP para integrar Rikudo con agentes de IA externos.
 
+---
 
-## ✨ Características Principales
+## ✨ Dos Modos de Uso
+
+Rikudo puede usarse de dos maneras:
 
-* **🧠 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)
+### 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.
+
+---
+
+## ✨ 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.).
-* **🔌 Servidor MCP:** Actúa como skill library para agentes de IA externos mediante el protocolo MCP (Model Context Protocol).
+* **🔍 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
-
 ```
 
+---
 
-## 🔌 Servidor MCP (Model Context Protocol)
-
-Rikudo funciona como un servidor MCP, exponiendo herramientas y prompts para que cualquier agente de IA externo compatible con MCP pueda interactuar con tu flujo de trabajo de desarrollo.
+### Modo MCP
 
-### Iniciar el Servidor
+Para usar Rikudo como servidor MCP con cualquier agente de IA compatible:
 
 ```bash
 rikudo mcp
 ```
 
-El servidor se comunica mediante **stdio** (entrada/salida estándar), lo que permite integrarlo con cualquier cliente MCP.
+El servidor se comunica mediante **stdio**, permitiendo integrarse con cualquier cliente MCP.
 
-### Herramientas Disponibles
+#### Herramientas Disponibles
 
 | Herramienta | Descripción |
 |------------|-------------|
@@ -119,14 +117,14 @@ El servidor se comunica mediante **stdio** (entrada/salida estándar), lo que pe
 | `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
+#### 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
+#### Integración con Agentes IA
 
 Rikudo es compatible con cualquier herramienta de IA que soporte el protocolo MCP, como:
 - **Claude Code / Claude Desktop**
@@ -136,8 +134,6 @@ Rikudo es compatible con cualquier herramienta de IA que soporte el protocolo MC
 - **Continue**
 - Y cualquier otro cliente MCP
 
-#### Configuración Genérica
-
 Agrega esto en la configuración de tu cliente MCP:
 
 ```json
@@ -151,9 +147,7 @@ Agrega esto en la configuración de tu cliente MCP:
 }
 ```
 
-### Variables de Entorno para MCP
-
-El servidor MCP requiere las siguientes variables de entorno:
+#### Variables de Entorno para MCP
 
 ```env
 # Redmine
@@ -167,7 +161,7 @@ RIKUDO_GITEA_OWNER=tu_usuario_o_organizacion
 RIKUDO_GITEA_REPO=nombre_del_repositorio
 ```
 
-### Formato de Ramas
+#### Formato de Ramas
 
 Al usar `start_feature` o `shift_left_start`, el nombre de rama sigue el formato:
 
@@ -177,14 +171,12 @@ Al usar `start_feature` o `shift_left_start`, el nombre de rama sigue el formato
 
 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
@@ -198,7 +190,7 @@ 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
 
@@ -207,38 +199,19 @@ 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á:
@@ -249,4 +222,4 @@ Esto validará:
 
 ---
 
-Hecho con ❤️ y TypeScript.
+Hecho con ❤️ y TypeScript.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dami_deleon/rikudo",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "El Sabio de los Commits: AI Assistant con integración a Redmine",
   "main": "dist/index.js",
   "type": "module",