superpowers-mcp 6.4.2 → 6.4.3

package/README.es.md

@@ -0,0 +1,258 @@
+# Guía de uso del Toolpack Superpowers MCP
+
+[English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
+
+[![Versión](https://img.shields.io/badge/version-6.4.3-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
+[![Licencia](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+Este documento resume la información y las instrucciones de uso para empaquetar las habilidades (skills) de Superpowers y el sistema de flujos de trabajo autónomos en un servidor **Model Context Protocol (MCP)** independiente, de alto rendimiento y seguro.
+
+---
+
+## 🚀 Cómo instalar y usar
+
+### Entornos y plataformas compatibles
+
+- **Editores de código e IDE con IA**: **Antigravity (AGY)**, **Cursor**, **VSCode** (GitHub Copilot), **VSCode Insiders** (GitHub Copilot), **Devin Desktop**, **Trae**, **Cline**, **Kilo Code**, **Qoder**, **Kiro**, **MiniMax Code Desktop** (configuración manual), **Codex**.
+- **Aplicaciones de escritorio y plataformas de agentes IA**: **Claude Desktop**, **Pi Desktop**, **QwenPaw**, **Hermes Desktop**, **Kimi Work**, **Goose**, **OpenClaw**.
+- **Plataformas de IA locales y autoalojadas**: **AnythingLLM**, **LibreChat**.
+
+### Funcionalidades MCP incluidas
+
+| Función del protocolo | Elementos / Cantidad | Descripción |
+| :--- | :--- | :--- |
+| **Tools** | `list_skills`, `read_skill` | Descubre, busca y carga las instrucciones completas y listas de verificación de cada skill bajo demanda. |
+| **Prompts** | 9 Native Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `spec-reviewer`, `plan-reviewer` |
+| **Resources** | 15 Skill URIs + 1 Guide | `skill://superpowers/<skill-name>` además de `guide://superpowers/skill-compositions` |
+
+### Conversar con el agente de IA (uso básico)
+
+Una vez instalado o configurado, tu cliente MCP puede descubrir las herramientas, prompts y recursos de Superpowers. Los prompts MCP los invoca el usuario; selecciónalos desde el menú de MCP Prompts de tu cliente. Después, la carga de skills depende de que el agente siga el prompt seleccionado y llame a `read_skill`.
+
+**Ejemplos básicos de interacción:**
+- **Inicializar la disciplina de ingeniería:** «Aplica el prompt `session-start`» (inyecta las reglas y el contexto de Superpowers)
+- **Descubrir los skills disponibles:** «Lista todos los skills de superpowers»
+- **Cargar un skill atómico:** «Usa `read_skill` para cargar el skill `brainstorming` y ayúdame a explorar los requisitos»
+
+---
+
+## ⚡ Configuración dirigida con un clic
+
+Para empezar a usar Superpowers al instante, sin modificaciones intrusivas en segundo plano, utiliza nuestra herramienta de configuración con un clic, **dirigida y respetuosa con la privacidad**.
+
+> [!NOTE]
+> **Ejecútalo desde cualquier directorio**: NO necesitas clonar este repositorio ni navegar a una carpeta específica. Puedes ejecutar estos comandos directamente desde **cualquier directorio** de tu terminal. El instalador apunta automáticamente a los archivos de configuración globales en tu directorio personal (`~`), habilitando Superpowers en todos tus espacios de trabajo al instante.
+
+ChatWise y Cherry Studio requieren importación manual, consulta la [guía de importación de escritorio](docs/desktop-setup.md).
+
+### 1. Elige tu agente / editor de IA (comando dirigido)
+
+Selecciona tu cliente y ejecuta el comando correspondiente en tu terminal:
+
+| Plataforma / Cliente | SO compatibles | Comando de configuración con un clic | Ubicación de la configuración global |
+| :--- | :--- | :--- | :--- |
+| **LM Studio** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target lmstudio` | `~/.lmstudio/mcp.json` |
+| **Roo Code (VS Code Desktop)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target roo` | `.../rooveterinaryinc.roo-cline/settings/mcp_settings.json` |
+| **Antigravity (Google DeepMind)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target antigravity` | `~/.gemini/config/mcp_config.json` |
+| **Pi Desktop / Pi Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target pi-desktop` | `~/.pi/agent/mcp.json` |
+| **Cursor** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cursor` | `~/.cursor/mcp.json` |
+| **GitHub Copilot (VS Code)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot` | `Code/User/mcp.json` *(esquema `servers` de VS Code)* |
+| **GitHub Copilot (VS Code Insiders)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot-insiders` | `Code - Insiders/User/mcp.json` *(esquema `servers` de VS Code)* |
+| **Hermes Desktop / Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target hermes` | `~/.hermes/config.yaml` *(Win: `%LOCALAPPDATA%\hermes`)* |
+| **Kimi Work / Kimi Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kimi` | `~/.kimi-code/mcp.json` |
+| **Claude Desktop** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target claude` | `Claude/claude_desktop_config.json` |
+| **Devin Desktop (antes Windsurf)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target devin` | `~/.config/devin/mcp_config.json` *(o `windsurf`)* |
+| **QwenPaw (estación de trabajo personal)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qwenpaw` | `~/.qwenpaw/config.json` *(alias: `copaw`)* |
+| **Cline (VS Code / CLI)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cline` | `.../saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
+| **Kilo Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kilo` | `~/.config/kilo/kilo.jsonc` *(esquema nativo `mcp`)* |
+| **Qoder** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qoder` | `~/.qoder/settings.json` |
+| **Kiro** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kiro` | `~/.kiro/settings/mcp.json` |
+| **Trae** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target trae` | `.../Trae/User/mcp.json` *(compatible con Trae CN)* |
+| **Codex** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target codex` | `~/.codex/config.toml` *(TOML `[mcp_servers]`)* |
+| **OpenClaw** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target openclaw` | `~/.openclaw/openclaw.json` *(JSON5 `mcp.servers`)* |
+| **Goose** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target goose` | `~/.config/goose/config.yaml` *(Win: `%APPDATA%\Block\goose\config\config.yaml`)* |
+
+*(Si usas Bun, añade `--bun` para un arranque más rápido, p. ej. `npx -y superpowers-mcp setup --target cursor --bun`)*
+
+---
+
+### 2. Configuración con Curl o PowerShell
+
+- **macOS / Linux (con Curl y objetivo explícito):**
+  ```bash
+  curl -fsSL https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.sh | bash -s -- --target cursor
+  ```
+
+- **Windows (con PowerShell y objetivo explícito):**
+  ```powershell
+  & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.ps1))) -Target cursor
+  ```
+
+#### Opciones avanzadas:
+- `--dry-run`: Muestra los cambios sin escribir en disco.
+- `--remove`: Elimina de forma segura la configuración de Superpowers del cliente seleccionado.
+- `--backup`: Crea una copia de seguridad `.bak` con marca de tiempo antes de modificar (por defecto: desactivado, cero contaminación).
+- `--bun`: Usa `bunx` en lugar de `npx` en la configuración generada.
+- `--target <name>`: Nombre explícito del objetivo (se admiten alias, p. ej. `code`, `vscode`, `kimi-code`).
+
+---
+
+## 🛠️ Configuración manual de MCP
+
+Si prefieres configurar manualmente, añade los siguientes ajustes a tu IDE o cliente MCP (p. ej. Cursor, Antigravity, VSCode, AnythingLLM, etc.).
+
+### Método: NPX / BUNX (recomendado)
+
+Es la forma más sencilla, ya que resuelve las rutas automáticamente.
+
+#### Con Bun (más rápido)
+```json
+{
+  "superpowers": {
+    "command": "bunx",
+    "args": ["-y", "superpowers-mcp"]
+  }
+}
+```
+
+#### Con Node/NPM
+```json
+{
+  "superpowers": {
+    "command": "npx",
+    "args": ["-y", "superpowers-mcp"]
+  }
+}
+```
+
+---
+
+## 🔄 Composición de skills y flujos de trabajo
+
+Para tareas de ingeniería complejas, usa estos **lanzadores de flujo de trabajo interactivos**. Inician un proceso guiado por el agente y se detienen en las decisiones de diseño, revisión del plan y finalización de la rama; no se ejecutan en el servidor ni de forma desatendida. Consulta la [`Guía de composición de skills`](docs/skill-compositions.es.md) publicada, también disponible como recurso MCP `guide://superpowers/skill-compositions`.
+
+### 1. Flujo de desarrollo de nuevas funcionalidades
+```
+brainstorming ➔ writing-plans ➔ using-git-worktrees ➔ subagent-driven-development (TDD) ➔ verification-before-completion ➔ requesting-code-review ➔ finishing-a-development-branch
+```
+- **Cómo iniciarlo:** Selecciona `feature-pipeline` en el menú de MCP Prompts de tu cliente e indica `feature_name` y, opcionalmente, `requirements`.
+- **Flujo:** Aclara los requisitos (Spec) ➔ espera la aprobación del diseño ➔ crea un plan revisable ➔ espera la aprobación del plan ➔ aísla un worktree ➔ implementa con SDD o la alternativa integrada y TDD ➔ verifica ➔ revisa ➔ pregunta cómo finalizar la rama.
+- **Alternativa:** Si el host no dispone de herramientas multiagente, el flujo usa `executing-plans` en lugar de afirmar que despacha subagentes.
+
+### 2. Flujo estructurado de resolución de problemas
+```
+systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔ test-driven-development ➔ verification-before-completion ➔ requesting-code-review ➔ finishing-a-development-branch
+```
+- **Cómo iniciarlo:** Selecciona `structured-debug` en el menú de MCP Prompts de tu cliente e indica el problema o las pruebas que fallan.
+- **Flujo:** Formula hipótesis de causa raíz ➔ aísla worktrees para agentes en paralelo ➔ crea pruebas de reproducción que fallan ➔ aplica la corrección específica ➔ confirma cero regresiones ➔ revisa la corrección ➔ finaliza la rama.
+
+### 3. Guía dinámica de flujos de trabajo
+- **Cómo iniciarla:** Selecciona `skill-composition` para obtener un flujo recomendado para refactorización, migración o un código heredado. Estos escenarios no tienen actualmente prompts lanzadores dedicados.
+- **Flujo:** Recomienda dinámicamente la composición óptima de varios skills para grandes refactorizaciones, redes de seguridad de migración o incorporación:
+  - **Refactorización y migración grandes:** `brainstorming` ➔ `writing-plans (skeleton-first)` ➔ `using-git-worktrees` ➔ `subagent-driven-development` ➔ `verification-before-completion` ➔ `requesting-code-review` ➔ `finishing-a-development-branch`
+  - **Red de seguridad para código heredado:** `brainstorming` ➔ `writing-plans` ➔ `test-driven-development (characterization)` ➔ `systematic-debugging` ➔ `verification-before-completion`
+
+
+---
+
+## 📋 Resumen de skills compatibles (15 skills principales y escenarios)
+
+Para ayudarte a elegir el skill adecuado, hemos estructurado los 15 skills a lo largo del ciclo de vida del desarrollo de software (SDLC), combinando capacidades principales y escenarios recomendados por la comunidad:
+
+| # | Fase del SDLC | Nombre del skill | Qué hace (propósito y valor principal) | Escenario recomendado |
+| :-: | :--- | :--- | :--- | :--- |
+| 1 | **🚀 Planificación y diseño** | **`brainstorming`** | **Requisitos y diseño de arquitectura**: Explora opciones y restricciones antes de programar; produce especificaciones de diseño; incluye revisión de IU en el navegador con Visual Companion. | Antes de empezar cualquier funcionalidad nueva o cambio importante; evita saltar directamente al código. |
+| 2 | **🚀 Planificación y diseño** | **`writing-plans`** | **Planificación de la implementación**: Descompone las especificaciones en tareas pequeñas y verificables, con skills recomendados y contratos de archivos. | Antes de refactorizaciones multifichero, migraciones complejas o implementaciones grandes. |
+| 3 | **💻 Implementación** | **`executing-plans`** | **Ejecución del plan en la sesión**: Ejecuta cada tarea paso a paso en la sesión actual y luego hace una revisión de toda la rama al final. | Ejecución de planes por lotes dentro de la misma sesión sin crear subagentes. |
+| 4 | **💻 Implementación** | **`subagent-driven-development`** | **Desarrollo dirigido por subagentes (SDD)**: Despacha subagentes nuevos y aislados por tarea, con revisiones adversariales de doble capa. | Modelo de ejecución recomendado para planes complejos, sin contaminación de contexto. |
+| 5 | **💻 Implementación** | **`test-driven-development`** | **Desarrollo guiado por pruebas (TDD)**: Aplica ciclos estrictos de Rojo ➔ Verde ➔ Refactorización para una cobertura sólida. | Al implementar funcionalidades lógicamente difíciles o algoritmos críticos. |
+| 6 | **🔍 Depuración** | **`systematic-debugging`** | **Depuración sistemática de causa raíz**: Descompone errores complejos en hipótesis verificables con experimentos de validación. | Ante cualquier error inesperado, fallo de pruebas o bug intermitente. |
+| 7 | **🛡️ Calidad y revisión** | **`verification-before-completion`** | **Verificación basada en evidencia**: Exige ejecutar toda la suite de pruebas, el linter y las comprobaciones de tipos. | Antes de afirmar «funciona» o «está listo»; aporta pruebas tangibles de finalización. |
+| 8 | **🛡️ Calidad y revisión** | **`requesting-code-review`** | **Inicio de revisiones de código**: Empaqueta diffs e informes para revisiones multidimensionales de arquitectura y calidad. | Antes de fusionar ramas o finalizar tareas, para garantizar la integridad arquitectónica. |
+| 9 | **🛡️ Calidad y revisión** | **`receiving-code-review`** | **Gestión de comentarios de revisión**: Evalúa sistemáticamente los comentarios, aplica correcciones y registra las decisiones. | Al abordar hallazgos de revisión de forma sistemática y sin perder contexto. |
+| 10 | **🛡️ Calidad y revisión** | **`finishing-a-development-branch`** | **Integración y limpieza de la rama**: Gestiona el PR/merge, limpia los worktrees de Git y elimina ramas temporales. | Cuando pasan todas las verificaciones, para integrar la funcionalidad en la rama principal. |
+| 11 | **🌿 Control de versiones** | **`using-git-worktrees`** | **Aislamiento físico con Git**: Crea directorios worktree aislados para funcionalidades o depuración, evitando condiciones de carrera. | Al trabajar en tareas concurrentes o investigaciones paralelas con varios agentes. |
+| 12 | **🤖 Agentes avanzados** | **`dispatching-parallel-agents`** | **Orquestación de agentes en paralelo**: Despacha subagentes concurrentes en espacios aislados para investigar varias hipótesis a la vez. | Cuando fallan varias pruebas o se investigan teorías independientes en paralelo. |
+| 13 | **🤖 Agentes avanzados** | **`using-superpowers`** | **Fundamentos y disciplina de Superpowers**: Establece la disciplina obligatoria de descubrimiento y carga de skills y las reglas de prioridad. | Se carga automáticamente al iniciar la sesión para imponer los estándares de ingeniería. |
+| 14 | **🤖 Agentes avanzados** | **`writing-skills`** | **Creación y mantenimiento de skills**: Guía la creación, prueba y empaquetado de nuevos skills de Superpowers. | Al crear skills personalizados o mejorar las instrucciones existentes. |
+| 15 | **🤖 Agentes avanzados** | **`diagnosing-superpowers`** | **Forense de sesiones e informes**: Reconstruye qué falló en una sesión a partir de transcripciones en disco con evidencia citada; prepara paquetes depurados e issues de GitHub. | Cuando una sesión se desvió y necesitas evidencia del porqué, o un informe para los mantenedores. |
+
+## 🆕 Novedades recientes
+
+### v6.4.3 (versión actual)
+
+- **Target Codex y limpieza de docs (2026-09-28)**:
+  - Nuevo target `codex`: `setup --target codex` escribe `~/.codex/config.toml` (`[mcp_servers.superpowers]`) con fusión TOML sin dependencias; soporta `--dry-run` / `--backup` / `--bun` / `--remove`.
+  - Nuevos targets `openclaw` / `goose`: el primero escribe `~/.openclaw/openclaw.json` (`mcp.servers`); el segundo el bloque `extensions` del `config.yaml` de goose (se preservan `enabled`/`timeout`/`envs` del usuario).
+  - Eliminado el bloque TIP redundante de transparencia del setup (duplicaba el encabezado); los detalles de seguridad quedan en Advanced Flags y SECURITY.md.
+  - `docs/desktop-setup.md` ahora es la guía de importación en inglés para ChatWise y Cherry Studio (`setup --print-config`); LM Studio / Roo Code siguen en la tabla de un clic. Eliminada la nota obsoleta de "opciones sin publicar" (`lmstudio`, `roo` y `--print-config` se publicaron en v6.3.9).
+  - Publicados la navegación en 7 idiomas (nuevos README ES / PT-BR / HI), las guías de skill-composition ES / PT-BR / HI y la corrección de negritas adyacentes a CJK.
+  - MiniMax Code Desktop figura como (configuración manual) (ruta sin verificar).
+  - Verificación: `npm test` en verde, base ahora 389/389 (+17 casos setup-target), `npm audit` 0 vulnerabilidades.
+
+### v6.4.2
+
+- **Auditoría de seguridad y revisión de código v6.4.2 (2026-09-24)**: se cerraron los hallazgos de auditoría en el servidor MCP, los scripts de configuración, el pipeline de compilación y el arnés de pruebas (detalles en [SECURITY.md](SECURITY.md)).
+  - **Recorrido de rutas e higiene de errores**: los nombres de skill se decodifican *antes* de la validación contra la lista permitida, por lo que cargas con doble codificación `..%2f` / `%2e%2e` se rechazan con `InvalidParams`; las herramientas y prompts desconocidos ahora devuelven errores `InvalidParams` accionables en lugar de `MethodNotFound`.
+  - **Defensa TOCTOU y contra rutas destructivas**: las rutas canónicas se verifican de nuevo tras comprobar symlinks, la limpieza de caché está protegida por el manifiesto de copia (los skills propios del fork nunca se eliminan) y los registros de drift/coverage se escriben de forma atómica con archivo temporal + rename.
+  - **Compilaciones sin carreras y sincronización tolerante**: la compilación de `out/setup.js` usa bloqueo exclusivo con revalidación de staleness por mtime, la salida en modo watch recibe chmod ejecutable y las fuentes upstream faltantes terminan limpiamente en lugar de generar falsos drifts.
+  - **Arnés de pruebas honesto**: un watchdog con ref más manejadores `exit`/`close` del servidor terminan los bloqueos silenciosos, las pruebas de drift se ejecutan con protección de red y los saltos por privilegios limitados ya no cuentan como aprobados — el piso de regresión se mantiene en **365/365** aserciones.
+
+### v6.4.1
+
+- **Sincronización upstream con obra/superpowers v6.4.1**:
+  - **Ejecución nativa del plan en línea**: el `executing-plans` reescrito ejecuta todo el plan con los nuevos ayudantes `task-start` / `task-done` y luego hace una sola revisión de toda la rama, sin check-ins intermedios.
+  - **Nuevo skill: `diagnosing-superpowers`**: forense de sesiones desde transcripciones en disco con evidencia citada, además de paquetes depurados y borradores de GitHub issues (15 skills en total).
+  - **Comportamiento de revisión**: califica el comportamiento no especificado según la expectativa razonable del usuario, lista `Declined to judge`, `BASE_SHA` vía `git merge-base origin/main HEAD`.
+  - **Foco de revisión del plan**: nueva sección de plantilla y elemento de autorrevisión que vinculan los casos borde implícitos en la spec con sus tareas responsables.
+  - **Nuevas referencias de plataformas**: asignaciones de herramientas de Muse y Claude Code; se conservan las refs de Devin/OpenCode.
+  - Los scripts se invocan a través de su intérprete (`bash` / `node`) para que el empaquetado del marketplace no los rompa.
+- **Paridad en Windows y piso de regresión**:
+  - Nuevos ports `task-start.ps1` / `task-done.ps1` con suites de simetría sh/ps1.
+  - Se conserva todo el contenido durable de los PR adoptados (libro Discoveries, contrato de archivos de revisión, scripts greenfield, seguridad remota); baseline de drift regrabada con cero drift.
+- **Auditoría de seguridad integral y piso de regresión automatizado** ([`SECURITY.md`](SECURITY.md)):
+  - 100 % verificado en **365 aserciones de pruebas automatizadas** (Node.js 170, Bash 67, PowerShell 128), 0 vulnerabilidades, 0 secretos hardcodeados.
+  - El `task-done` en línea ejecuta las pruebas elegidas por el operador como argv (`"$@"` / `& $exe @rest`), no como shell; el texto del libro es solo informativo.
+  - `diagnosing-superpowers` es de solo lectura local y exportación controlada; la redacción es best-effort — revisa cada archivo antes de compartirlo.
+  - La exportación de hallazgos diferidos ahora incluye `Final: minor (deferred):` sin contar parked de líneas de finalización.
+  - La configuración local de Devin (`.devin/`) está en gitignore.
+
+### v6.3.10
+
+- **Resolución de conflictos de claves de configuración universales y preservación sin pérdidas**:
+  - Descubre automáticamente declaraciones existentes en claves reconocidas (`servers`, `mcp`, `mcpServers`), evitando configuraciones duplicadas en conflicto.
+  - Fusiona y preserva con seguridad los campos creados por el usuario (`env`, `cwd`, `disabled`, `alwaysAllow`, `args`) al reinstalar.
+  - Elimina estados contradictorios entre flags opuestas (`disabled: true` frente a `enabled: true`).
+  - Rechaza flags desconocidas y argumentos posicionales inesperados con código de salida 1; estandariza en `process.exitCode` para no truncar la salida en pipes Unix.
+- **Verificación de caché del motor de skills con stat rápido y protección de época de escaneo**:
+  - Implementa verificación rápida con un solo stat (`dev`, `ino`, `size`, `mtimeMs`) en rutas cacheadas, invalidando al instante si los symlinks redirigen sin reescanear todo el árbol.
+  - El `scanEpoch` monotónico creciente y el reinicio de `loadingEpoch` en `clearCache()` impiden que escaneos async pendientes repueblen cachés vaciadas.
+  - La verificación con descriptor de archivo autoritativo (`readFileNoFollow`) evita intercambios de descriptor TOCTOU.
+- **Robustez y deduplicación de plantillas de prompts MCP**:
+  - Se detiene con `McpError(ErrorCode.InternalError)` y diagnóstico estructurado en stderr cuando faltan plantillas o están vacías.
+  - Rastrea sustituciones aplicadas con `appliedInterpolations`, evitando anexos redundantes de argumentos.
+- **Auditoría de seguridad integral y piso de regresión automatizado**:
+  - 100 % verificado en **292 aserciones de pruebas automatizadas** (Node.js 163, Bash 35, PowerShell 94), 0 vulnerabilidades, 0 secretos hardcodeados.
+
+### v6.3.9
+
+- **Defensa permanente contra ReDoS (CodeQL Alert #4 resuelto)**:
+  - Reemplazó el backtracking ambiguo de regex en el parseo YAML (`updateYamlConfig`) con coincidencia de prefijo sin ambigüedad y `String.prototype.trim()` nativo.
+  - Añadió escaneo lineal `extractInlineComment` ($O(N)$), evitando backtracking polinómico con entradas rellenas de espacios largos. CodeQL Alert #4 (`js/polynomial-redos`) formalmente cerrado.
+  - Añadida suite de regresión en `tests/setup_test.js` que valida procesamiento lineal (<1 ms) contra 60 000 espacios.
+- **Expansión de clientes (17 clientes de agentes IA)**:
+  - Añadidos objetivos para **LM Studio** (`lmstudio`, `~/.lmstudio/mcp.json`) y **Roo Code** en VS Code Desktop (`roo`, `rooveterinaryinc.roo-cline/settings/mcp_settings.json`) en macOS, Windows y Linux.
+  - Parser YAML mejorado para preservar comentarios en línea en `mcp_servers:` y `superpowers:`.
+- **Herramientas de importación de escritorio e integridad del exit code**:
+  - Añadido `setup --print-config` (opcional `--bun`) para salida JSON limpia para importación en clientes de escritorio (ChatWise, Cherry Studio, etc.) sin escribir archivos.
+  - La delegación de setup en `src/server.ts` ahora preserva el `process.exitCode` de los comandos CLI.
+- **Guía de configuración de escritorio**:
+  - Añadida la guía completa [`docs/desktop-setup.md`](docs/desktop-setup.md) para LM Studio, Roo Code, ChatWise y Cherry Studio.
+
+👉 *Para el historial completo de versiones, consulta [CHANGELOG.md](CHANGELOG.md).*
+
+---
+
+## 🙏 Agradecimientos
+
+Este proyecto es un fork y adaptación del proyecto original [Superpowers](https://github.com/obra/superpowers) de [obra](https://github.com/obra). Agradecemos su trabajo pionero en la definición del framework de skills agénticas y la metodología de desarrollo que impulsa este servidor MCP.

package/README.hi.md

@@ -0,0 +1,258 @@
+# Superpowers MCP टूलपैक उपयोग मार्गदर्शिका
+
+[English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
+
+[![संस्करण](https://img.shields.io/badge/version-6.4.3-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
+[![लाइसेंस](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+यह दस्तावेज़ Superpowers skills लाइब्रेरी और स्वायत्त वर्कफ़्लो सिस्टम को एक स्वतंत्र, उच्च-प्रदर्शन और सुरक्षित **Model Context Protocol (MCP)** सर्वर के रूप में पैकेज करने की जानकारी और उपयोग निर्देशों का सारांश है।
+
+---
+
+## 🚀 इंस्टॉल और उपयोग कैसे करें
+
+### समर्थित वातावरण और प्लेटफ़ॉर्म
+
+- **AI कोड एडिटर और IDE**: **Antigravity (AGY)**, **Cursor**, **VSCode** (GitHub Copilot), **VSCode Insiders** (GitHub Copilot), **Devin Desktop**, **Trae**, **Cline**, **Kilo Code**, **Qoder**, **Kiro**, **MiniMax Code Desktop** (मैन्युअल सेटअप), **Codex**।
+- **AI डेस्कटॉप ऐप और एजेंट प्लेटफ़ॉर्म**: **Claude Desktop**, **Pi Desktop**, **QwenPaw**, **Hermes Desktop**, **Kimi Work**, **Goose**, **OpenClaw**।
+- **लोकल और सेल्फ-होस्टेड AI प्लेटफ़ॉर्म**: **AnythingLLM**, **LibreChat**।
+
+### उपलब्ध MCP क्षमताएँ
+
+| प्रोटोकॉल सुविधा | आइटम / संख्या | विवरण |
+| :--- | :--- | :--- |
+| **Tools** | `list_skills`, `read_skill` | माँग पर हर skill के पूर्ण निर्देश और चेकलिस्ट खोजें, पढ़ें और लोड करें। |
+| **Prompts** | 9 Native Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `spec-reviewer`, `plan-reviewer` |
+| **Resources** | 15 Skill URIs + 1 Guide | `skill://superpowers/<skill-name>` तथा `guide://superpowers/skill-compositions` |
+
+### AI एजेंट से बातचीत (बुनियादी उपयोग)
+
+इंस्टॉल या कॉन्फ़िगर होने के बाद आपका MCP क्लाइंट Superpowers के tools, prompts और resources खोज सकता है। MCP prompt उपयोगकर्ता द्वारा चलाए जाते हैं; अपने क्लाइंट के MCP Prompts मेनू से चुनें। इसके बाद skill लोड होना इस पर निर्भर करता है कि एजेंट चुने गए prompt का पालन करके `read_skill` कॉल करे।
+
+**बुनियादी संवाद उदाहरण:**
+- **इंजीनियरिंग अनुशासन शुरू करें:** "`session-start` prompt लगाएँ" (Superpowers नियम व संदर्भ इंजेक्ट करता है)
+- **उपलब्ध skills खोजें:** "सभी superpowers skills की सूची दिखाओ"
+- **एक skill लोड करें:** "`read_skill` से `brainstorming` skill लोड करो और आवश्यकताओं का विश्लेषण करने में मदद करो"
+
+---
+
+## ⚡ लक्षित वन-क्लिक सेटअप
+
+बिना किसी छिपे हुए बैकग्राउंड बदलाव के Superpowers तुरंत शुरू करने के लिए हमारे **लक्षित, गोपनीयता-सम्मानजनक** वन-क्लिक सेटअप टूल का उपयोग करें।
+
+> [!NOTE]
+> **किसी भी डायरेक्टरी से चलाएँ**: आपको यह रिपॉज़िटरी क्लोन करने या किसी खास फ़ोल्डर में जाने की ज़रूरत नहीं है। आप अपने टर्मिनल में **किसी भी डायरेक्टरी** से सीधे ये कमांड चला सकते हैं। इंस्टॉलर आपके होम डायरेक्टरी (`~`) में ग्लोबल कॉन्फ़िग फ़ाइलों को स्वतः लक्षित करता है और सभी workspaces में Superpowers तुरंत सक्षम कर देता है।
+
+ChatWise और Cherry Studio में मैन्युअल इम्पोर्ट आवश्यक है, [डेस्कटॉप इम्पोर्ट गाइड](docs/desktop-setup.md) देखें।
+
+### 1. अपना AI एजेंट / एडिटर चुनें (लक्षित वन-लाइनर)
+
+अपना क्लाइंट चुनें और टर्मिनल में संबंधित कमांड चलाएँ:
+
+| प्लेटफ़ॉर्म / क्लाइंट | समर्थित OS | वन-क्लिक सेटअप कमांड | ग्लोबल कॉन्फ़िग स्थान |
+| :--- | :--- | :--- | :--- |
+| **LM Studio** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target lmstudio` | `~/.lmstudio/mcp.json` |
+| **Roo Code (VS Code Desktop)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target roo` | `.../rooveterinaryinc.roo-cline/settings/mcp_settings.json` |
+| **Antigravity (Google DeepMind)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target antigravity` | `~/.gemini/config/mcp_config.json` |
+| **Pi Desktop / Pi Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target pi-desktop` | `~/.pi/agent/mcp.json` |
+| **Cursor** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cursor` | `~/.cursor/mcp.json` |
+| **GitHub Copilot (VS Code)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot` | `Code/User/mcp.json` *(VS Code `servers` स्कीमा)* |
+| **GitHub Copilot (VS Code Insiders)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot-insiders` | `Code - Insiders/User/mcp.json` *(VS Code `servers` स्कीमा)* |
+| **Hermes Desktop / Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target hermes` | `~/.hermes/config.yaml` *(Win: `%LOCALAPPDATA%\hermes`)* |
+| **Kimi Work / Kimi Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kimi` | `~/.kimi-code/mcp.json` |
+| **Claude Desktop** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target claude` | `Claude/claude_desktop_config.json` |
+| **Devin Desktop (पूर्व Windsurf)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target devin` | `~/.config/devin/mcp_config.json` *(या `windsurf`)* |
+| **QwenPaw (पर्सनल एजेंट वर्कस्टेशन)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qwenpaw` | `~/.qwenpaw/config.json` *(उपनाम: `copaw`)* |
+| **Cline (VS Code / CLI)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cline` | `.../saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
+| **Kilo Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kilo` | `~/.config/kilo/kilo.jsonc` *(नेटिव `mcp` स्कीमा)* |
+| **Qoder** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qoder` | `~/.qoder/settings.json` |
+| **Kiro** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kiro` | `~/.kiro/settings/mcp.json` |
+| **Trae** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target trae` | `.../Trae/User/mcp.json` *(Trae CN समर्थित)* |
+| **Codex** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target codex` | `~/.codex/config.toml` *(TOML `[mcp_servers]`)* |
+| **OpenClaw** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target openclaw` | `~/.openclaw/openclaw.json` *(JSON5 `mcp.servers`)* |
+| **Goose** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target goose` | `~/.config/goose/config.yaml` *(Win: `%APPDATA%\Block\goose\config\config.yaml`)* |
+
+*(यदि Bun उपयोग करते हैं, तेज़ स्टार्टअप के लिए `--bun` जोड़ें, उदा. `npx -y superpowers-mcp setup --target cursor --bun`)*
+
+---
+
+### 2. Curl या PowerShell द्वारा सेटअप
+
+- **macOS / Linux (स्पष्ट target के साथ Curl द्वारा):**
+  ```bash
+  curl -fsSL https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.sh | bash -s -- --target cursor
+  ```
+
+- **Windows (स्पष्ट target के साथ PowerShell द्वारा):**
+  ```powershell
+  & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.ps1))) -Target cursor
+  ```
+
+#### उन्नत फ़्लैग:
+- `--dry-run`: डिस्क पर लिखे बिना बदलावों का पूर्वावलोकन करें।
+- `--remove`: लक्षित क्लाइंट से Superpowers कॉन्फ़िगरेशन सुरक्षित रूप से हटाएँ।
+- `--backup`: संशोधन से पहले टाइमस्टैम्प वाला `.bak` बैकअप बनाएँ (डिफ़ॉल्ट: बंद, शून्य-प्रदूषण)।
+- `--bun`: जेनरेट की गई कॉन्फ़िगरेशन में `npx` के बजाय `bunx` उपयोग करें।
+- `--target <name>`: स्पष्ट लक्ष्य नाम (उपनाम समर्थित, उदा. `code`, `vscode`, `kimi-code`)।
+
+---
+
+## 🛠️ मैनुअल MCP कॉन्फ़िगरेशन
+
+यदि आप मैनुअल कॉन्फ़िगर करना पसंद करते हैं, तो अपने IDE या MCP क्लाइंट (उदा. Cursor, Antigravity, VSCode, AnythingLLM आदि) में निम्न सेटिंग जोड़ें।
+
+### विधि: NPX / BUNX (अनुशंसित)
+
+यह सबसे आसान तरीका है क्योंकि यह पाथ समाधान स्वतः संभालता है।
+
+#### Bun द्वारा (तेज़)
+```json
+{
+  "superpowers": {
+    "command": "bunx",
+    "args": ["-y", "superpowers-mcp"]
+  }
+}
+```
+
+#### Node/NPM द्वारा
+```json
+{
+  "superpowers": {
+    "command": "npx",
+    "args": ["-y", "superpowers-mcp"]
+  }
+}
+```
+
+---
+
+## 🔄 Skill संयोजन और वर्कफ़्लो पाइपलाइन
+
+जटिल इंजीनियरिंग कार्यों के लिए इन **इंटरैक्टिव वर्कफ़्लो लॉन्चरों** का उपयोग करें। ये एजेंट-निर्देशित प्रक्रिया शुरू करते हैं और डिज़ाइन, योजना-समीक्षा और ब्रांच-समापन निर्णयों पर रुकते हैं; ये सर्वर-साइड या बिना निगरानी नहीं चलते। प्रकाशित [`Skill Compositions मार्गदर्शिका`](docs/skill-compositions.hi.md) देखें, जो MCP resource `guide://superpowers/skill-compositions` के रूप में भी उपलब्ध है।
+
+### 1. नई सुविधा विकास पाइपलाइन
+```
+brainstorming ➔ writing-plans ➔ using-git-worktrees ➔ subagent-driven-development (TDD) ➔ verification-before-completion ➔ requesting-code-review ➔ finishing-a-development-branch
+```
+- **शुरू कैसे करें:** अपने क्लाइंट के MCP Prompts मेनू से `feature-pipeline` चुनें और `feature_name` तथा वैकल्पिक `requirements` दें।
+- **वर्कफ़्लो:** आवश्यकताएँ स्पष्ट करें (Spec) ➔ डिज़ाइन अनुमोदन की प्रतीक्षा करें ➔ समीक्षायोग्य योजना बनाएँ ➔ योजना अनुमोदन की प्रतीक्षा करें ➔ worktree अलग करें ➔ SDD या इनलाइन फ़ॉलबैक और TDD से कार्यान्वयन करें ➔ सत्यापित करें ➔ समीक्षा करें ➔ पूछें कि ब्रांच कैसे समाप्त करें।
+- **फ़ॉलबैक:** यदि होस्ट में मल्टी-एजेंट टूल नहीं हैं, तो वर्कफ़्लो subagents भेजने का दावा करने के बजाय `executing-plans` उपयोग करता है।
+
+### 2. संरचित समस्या-निवारण पाइपलाइन
+```
+systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔ test-driven-development ➔ verification-before-completion ➔ requesting-code-review ➔ finishing-a-development-branch
+```
+- **शुरू कैसे करें:** अपने क्लाइंट के MCP Prompts मेनू से `structured-debug` चुनें और समस्या या असफल टेस्ट बताएँ।
+- **वर्कफ़्लो:** मूल कारण परिकल्पनाएँ बनाएँ ➔ समानांतर एजेंटों के लिए worktrees अलग करें ➔ असफल पुनरुत्पादन टेस्ट लिखें ➔ लक्षित सुधार लागू करें ➔ शून्य रिग्रेशन की पुष्टि करें ➔ सुधार की समीक्षा करें ➔ ब्रांच समाप्त करें।
+
+### 3. गतिशील वर्कफ़्लो मार्गदर्शिका
+- **शुरू कैसे करें:** रीफ़ैक्टरिंग, माइग्रेशन या लेगेसी कोडबेस के लिए अनुशंसित वर्कफ़्लो पाने हेतु `skill-composition` चुनें। इन परिदृश्यों के लिए वर्तमान में कोई समर्पित लॉन्चर prompt नहीं है।
+- **वर्कफ़्लो:** बड़े रीफ़ैक्टर, माइग्रेशन सुरक्षा-जाल या ऑनबोर्डिंग के लिए इष्टतम मल्टी-skill संयोजन गतिशील रूप से अनुशंसित करता है:
+  - **बड़ा रीफ़ैक्टरिंग व माइग्रेशन:** `brainstorming` ➔ `writing-plans (skeleton-first)` ➔ `using-git-worktrees` ➔ `subagent-driven-development` ➔ `verification-before-completion` ➔ `requesting-code-review` ➔ `finishing-a-development-branch`
+  - **लेगेसी कोडबेस सुरक्षा-जाल:** `brainstorming` ➔ `writing-plans` ➔ `test-driven-development (characterization)` ➔ `systematic-debugging` ➔ `verification-before-completion`
+
+
+---
+
+## 📋 समर्थित Skills अवलोकन (15 मुख्य Skills और परिदृश्य)
+
+सही skill चुनने में मदद के लिए हमने सभी 15 skills को सॉफ़्टवेयर विकास जीवनचक्र (SDLC) में संरचित किया है, जिसमें मुख्य क्षमताएँ और समुदाय-अनुशंसित परिदृश्य समाहित हैं:
+
+| # | SDLC चरण | Skill नाम | यह क्या करता है (उद्देश्य व मुख्य मूल्य) | अनुशंसित परिदृश्य |
+| :-: | :--- | :--- | :--- | :--- |
+| 1 | **🚀 योजना व डिज़ाइन** | **`brainstorming`** | **आवश्यकता व आर्किटेक्चर डिज़ाइन**: कोडिंग से पहले विकल्पों और बाधाओं का पता लगाता है; डिज़ाइन Spec आउटपुट करता है; Visual Companion ब्राउज़र UI समीक्षा सहित। | किसी भी नई सुविधा या बड़े बदलाव से पहले; सीधे कोड में कूदने से रोकता है। |
+| 2 | **🚀 योजना व डिज़ाइन** | **`writing-plans`** | **कार्यान्वयन योजना**: Spec को छोटे, परीक्षणयोग्य कार्यों में बाँटता है, अनुशंसित Skills और फ़ाइल अनुबंधों सहित। | मल्टी-फ़ाइल रीफ़ैक्टर, जटिल माइग्रेशन या बड़े कार्यान्वयन से पहले। |
+| 3 | **💻 कार्यान्वयन** | **`executing-plans`** | **सत्र में योजना निष्पादन**: वर्तमान सत्र में हर नियोजित कार्य चरण-दर-चरण चलाता है, फिर अंत में पूरे ब्रांच की एक समीक्षा करता है। | बिना subagents बनाए उसी सत्र में योजनाओं का बैच निष्पादन। |
+| 4 | **💻 कार्यान्वयन** | **`subagent-driven-development`** | **Subagent-चालित विकास (SDD)**: प्रति कार्य ताज़ा, संदर्भ-पृथक subagents भेजता है, दोहरी प्रतिकूल समीक्षाओं सहित। | जटिल योजनाओं के लिए अनुशंसित निष्पादन मॉडल, संदर्भ प्रदूषण समाप्त करता है। |
+| 5 | **💻 कार्यान्वयन** | **`test-driven-development`** | **टेस्ट-चालित विकास (TDD)**: सख्त Red ➔ Green ➔ Refactor चक्र लागू करता है, मज़बूत टेस्ट कवरेज सुनिश्चित करता है। | तार्किक रूप से चुनौतीपूर्ण सुविधाओं या महत्वपूर्ण एल्गोरिदम लागू करते समय। |
+| 6 | **🔍 डिबगिंग** | **`systematic-debugging`** | **व्यवस्थित मूल-कारण डिबगिंग**: जटिल त्रुटियों को परीक्षणयोग्य परिकल्पनाओं में बाँटता है, सत्यापन प्रयोगों सहित। | किसी भी अप्रत्याशित त्रुटि, टेस्ट विफलता या रुक-रुक कर आने वाले बग पर। |
+| 7 | **🛡️ गुणवत्ता व समीक्षा** | **`verification-before-completion`** | **साक्ष्य-आधारित सत्यापन**: पूर्ण टेस्ट सूट, linter और टाइप जाँच चलाना अनिवार्य करता है। | "हो गया" या "ठीक है" कहने से पहले; पूर्णता का ठोस प्रमाण देता है। |
+| 8 | **🛡️ गुणवत्ता व समीक्षा** | **`requesting-code-review`** | **कोड समीक्षा प्रारंभ**: बहु-आयामी आर्किटेक्चर और गुणवत्ता समीक्षाओं के लिए diffs और रिपोर्ट पैकेज करता है। | ब्रांच मर्ज या कार्य अंतिम करने से पहले आर्किटेक्चर अखंडता सुनिश्चित करने हेतु। |
+| 9 | **🛡️ गुणवत्ता व समीक्षा** | **`receiving-code-review`** | **समीक्षा प्रतिक्रिया प्रसंस्करण**: समीक्षा प्रतिक्रिया का व्यवस्थित मूल्यांकन करता है, सुधार लागू करता है और निर्णय दर्ज करता है। | समीक्षा निष्कर्षों को संदर्भ खोए बिना व्यवस्थित रूप से संबोधित करते समय। |
+| 10 | **🛡️ गुणवत्ता व समीक्षा** | **`finishing-a-development-branch`** | **ब्रांच एकीकरण व सफ़ाई**: PR/merge प्रबंधित करता है, Git worktrees साफ़ करता है और अस्थायी ब्रांच हटाता है। | सभी सत्यापन पास होने के बाद सुविधा को मुख्य ब्रांच में साफ़-सुथरा एकीकृत करने हेतु। |
+| 11 | **🌿 संस्करण नियंत्रण** | **`using-git-worktrees`** | **भौतिक Git पृथक्करण**: सुविधाओं या डिबगिंग के लिए पृथक worktree डायरेक्टरी बनाता है, रेस कंडीशन रोकता है। | समवर्ती कार्यों या समानांतर मल्टी-एजेंट जाँच पर काम करते समय। |
+| 12 | **🤖 उन्नत एजेंट** | **`dispatching-parallel-agents`** | **समानांतर एजेंट ऑर्केस्ट्रेशन**: पृथक workspaces में समवर्ती subagents भेजकर कई परिकल्पनाओं की एक साथ जाँच करता है। | जब कई असफल टेस्ट हों या स्वतंत्र सिद्धांतों की समानांतर जाँच करनी हो। |
+| 13 | **🤖 उन्नत एजेंट** | **`using-superpowers`** | **Superpowers आधार व अनुशासन**: अनिवार्य skill खोज, लोडिंग अनुशासन और प्राथमिकता नियम स्थापित करता है। | सत्र प्रारंभ में स्वतः लोड होकर सॉफ़्टवेयर इंजीनियरिंग मानक लागू करता है। |
+| 14 | **🤖 उन्नत एजेंट** | **`writing-skills`** | **Skill लेखन व रखरखाव**: नई Superpowers skills बनाने, परीक्षण और पैकेजिंग का मार्गदर्शन करता है। | कस्टम skills बनाते या मौजूदा निर्देश बढ़ाते समय। |
+| 15 | **🤖 उन्नत एजेंट** | **`diagnosing-superpowers`** | **सत्र फॉरेंसिक व मेंटेनर रिपोर्ट**: डिस्क पर ट्रांसक्रिप्ट से उद्धृत साक्ष्य सहित गड़बड़ी का पुनर्निर्माण करता है; स्क्रब किए गए बंडल और GitHub issue मसौदे तैयार करता है। | जब सत्र बिगड़ जाए और कारण का साक्ष्य चाहिए हो, या मेंटेनरों को बग रिपोर्ट देनी हो। |
+
+## 🆕 हाल के अपडेट
+
+### v6.4.3 (नवीनतम)
+
+- **Codex टारगेट व डॉक्स सफ़ाई (2026-09-28)**:
+  - नया `codex` वन-क्लिक टारगेट: `setup --target codex`, `~/.codex/config.toml` (`[mcp_servers.superpowers]`) में लिखता है; शून्य-निर्भरता TOML मर्ज, `--dry-run` / `--backup` / `--bun` / `--remove` समर्थित।
+  - नए `openclaw` / `goose` टारगेट: पहला `~/.openclaw/openclaw.json` (`mcp.servers`) में लिखता है; दूसरा goose के `config.yaml` के `extensions` ब्लॉक में (उपयोगकर्ता के `enabled`/`timeout`/`envs` सुरक्षित)।
+  - सेटअप से अतिरिक्त पारदर्शिता TIP हटाया गया (शीर्षक की पुनरावृत्ति); सुरक्षा विवरण Advanced Flags व SECURITY.md में हैं।
+  - `docs/desktop-setup.md` अब ChatWise व Cherry Studio हेतु अंग्रेज़ी इम्पोर्ट गाइड है (`setup --print-config`); LM Studio / Roo Code वन-क्लिक तालिका में हैं। पुराना "अप्रकाशित" नोट हटाया गया (`lmstudio`, `roo`, `--print-config` v6.3.9 में जारी)।
+  - 7-भाषा README नेविगेशन (नए ES / PT-BR / HI README), ES / PT-BR / HI skill-composition गाइड व CJK बोल्ड-सीमांकक सुधार जारी।
+  - MiniMax Code Desktop (मैन्युअल सेटअप) अंकित है (पथ असत्यापित)।
+  - सत्यापन: `npm test` हरा, आधार अब 389/389 (+17 setup-target केस), `npm audit` 0 कमज़ोरियाँ।
+
+### v6.4.2
+
+- **v6.4.2 सुरक्षा ऑडिट व कोड समीक्षा (2026-09-24)**: MCP सर्वर, सेटअप स्क्रिप्ट, बिल्ड पाइपलाइन और टेस्ट हार्नेस में ऑडिट निष्कर्ष बंद किए गए (विवरण [SECURITY.md](SECURITY.md) में)।
+  - **Traversal व त्रुटि स्वच्छता**: skill नाम allowlist सत्यापन से *पहले* डिकोड किए जाते हैं, इसलिए डबल-एन्कोडेड `..%2f` / `%2e%2e` पेलोड `InvalidParams` से अस्वीकृत होते हैं; अज्ञात tools और prompts अब `MethodNotFound` के बजाय कार्रवाईयोग्य `InvalidParams` त्रुटियाँ लौटाते हैं।
+  - **TOCTOU व विनाशकारी-पाथ रक्षा**: symlink जाँच के बाद canonical path पुनः सत्यापित होते हैं, कैश सफ़ाई कॉपी मैनिफ़ेस्ट से नियंत्रित होती है (fork-विशिष्ट skills कभी हटाए नहीं जा सकते), और drift/coverage रिकॉर्ड temp फ़ाइल + rename द्वारा परमाणु रूप से लिखे जाते हैं।
+  - **रेस-मुक्त बिल्ड व सॉफ्ट-फ़ेल sync**: `out/setup.js` बिल्ड एक्सक्लूसिव लॉक के साथ mtime ताज़गी पुनः-जाँच लेता है, watch-मोड आउटपुट executable chmod पाता है, और गुम upstream स्रोत झूठा drift उठाने के बजाय साफ़-सुथरे समाप्त होते हैं।
+  - **ईमानदार टेस्ट हार्नेस**: ref'd watchdog तथा सर्वर `exit`/`close` हैंडलर मौन hangs समाप्त करते हैं, drift टेस्ट नेटवर्क गार्ड के पीछे चलते हैं, और सीमित-विशेषाधिकार skips अब पास नहीं गिने जाते — रिग्रेशन आधार **365/365** assertions पर बना है।
+
+### v6.4.1
+
+- **Upstream Sync obra/superpowers v6.4.1 तक**:
+  - **नेटिव इनलाइन योजना निष्पादन**: पुनर्लिखित `executing-plans` नए `task-start` / `task-done` सहायकों से पूरी योजना चलाता है, फिर एक बार पूरे ब्रांच की समीक्षा — बीच में कोई check-in नहीं।
+  - **नई skill: `diagnosing-superpowers`**: डिस्क पर ट्रांसक्रिप्ट से उद्धृत साक्ष्य सहित सत्र फॉरेंसिक, तथा स्क्रब किए गए बंडल और GitHub issue मसौदे (कुल 15 skills)।
+  - **समीक्षा व्यवहार**: अनिर्दिष्ट व्यवहार को उचित-उपयोगकर्ता अपेक्षा से आँकें, `Declined to judge` सूची, `BASE_SHA` हेतु `git merge-base origin/main HEAD`।
+  - **योजना समीक्षा फ़ोकस**: नया टेम्पलेट अनुभाग और स्व-समीक्षा आइटम, जो spec-निहित edge cases को स्वामी कार्यों से जोड़ते हैं।
+  - **नए हार्नेस संदर्भ**: Muse और Claude Code टूल मैपिंग; Devin/OpenCode संदर्भ बनाए रखे गए।
+  - स्क्रिप्ट अपने इंटरप्रेटर (`bash` / `node`) से आहूत होते हैं ताकि मार्केटप्लेस पैकेजिंग उन्हें तोड़ न सके।
+- **Windows समता व रिग्रेशन आधार**:
+  - नए `task-start.ps1` / `task-done.ps1` पोर्ट, sh/ps1 सममिति टेस्ट सूट सहित।
+  - सभी अपनाए गए-PR स्थायित्व सामग्री बरकरार (Discoveries बही, समीक्षा-फ़ाइल अनुबंध, greenfield स्क्रिप्ट, remote-सुरक्षा); drift आधार शून्य drift के साथ पुनः दर्ज।
+- **व्यापक सुरक्षा ऑडिट व स्वचालित रिग्रेशन आधार** ([`SECURITY.md`](SECURITY.md)):
+  - **365 स्वचालित टेस्ट assertions** (Node.js 170, Bash 67, PowerShell 128) में 100% सत्यापित, 0 भेद्यता, 0 hardcoded secrets।
+  - इनलाइन `task-done` ऑपरेटर-चुने टेस्ट argv के रूप में चलाता है (`"$@"` / `& $exe @rest`), शेल के रूप में नहीं; बही पाठ केवल प्रदर्शन हेतु।
+  - `diagnosing-superpowers` केवल स्थानीय-पठन और निर्यात-नियंत्रित है; redaction सर्वोत्तम-प्रयास है — साझा करने से पहले हर फ़ाइल समीक्षा करें।
+  - विलंबित-निष्कर्ष निर्यात में अब समापन-पंक्ति parked गणना से मिलाए बिना `Final: minor (deferred):` शामिल है।
+  - स्थानीय Devin कॉन्फ़िग (`.devin/`) gitignored है।
+
+### v6.3.10
+
+- **यूनिवर्सल सेटअप कुंजी संघर्ष समाधान व हानिरहित फ़ील्ड संरक्षण**:
+  - मान्य सर्वर कुंजियों (`servers`, `mcp`, `mcpServers`) में मौजूदा घोषणाएँ स्वतः खोजता है, जिससे डुप्लिकेट परस्पर-विरोधी कॉन्फ़िगरेशन रुकते हैं।
+  - पुनः-स्थापना पर उपयोगकर्ता-लिखित फ़ील्ड (`env`, `cwd`, `disabled`, `alwaysAllow`, `args`) सुरक्षित मर्ज और संरक्षित करता है।
+  - विरोधी फ़्लैगों (`disabled: true` बनाम `enabled: true`) के बीच विरोधाभासी स्थिति समाप्त करता है।
+  - अज्ञात फ़्लैग और अप्रत्याशित स्थितीय CLI तर्क exit code 1 से अस्वीकार करता है; Unix pipes पर बिना काटे आउटपुट हेतु `process.exitCode` पर मानकीकृत।
+- **Skills कोर इंजन फ़ास्ट-पाथ कैश stat सत्यापन व स्कैन epoch परिरक्षण**:
+  - कैश किए skill paths पर फ़ास्ट-पाथ single-stat सत्यापन (`dev`, `ino`, `size`, `mtimeMs`), यदि symlinks पुनर्निर्देशित हों तो पूरे ट्री को पुनः स्कैन किए बिना तुरंत अमान्य करता है।
+  - `clearCache()` पर एकदिश बढ़ता `scanEpoch` और `loadingEpoch` रीसेट, जिससे लंबित async स्कैन फ़्लश किए कैश को पुनः न भरें।
+  - प्रामाणिक खुला फ़ाइल डिस्क्रिप्टर सत्यापन (`readFileNoFollow`) TOCTOU डिस्क्रिप्टर अदला-बदली रोकता है।
+- **MCP Prompt टेम्पलेट मज़बूती व डुप्लीकेशन-रोक**:
+  - prompt टेम्पलेट फ़ाइलें गुम या खाली होने पर संरचित stderr निदान सहित `McpError(ErrorCode.InternalError)` से रुकता है।
+  - `appliedInterpolations` द्वारा लागू टेम्पलेट प्रतिस्थापन ट्रैक करता है, जिससे अनावश्यक तर्क पुनरावृत्ति रुकती है।
+- **व्यापक सुरक्षा ऑडिट व स्वचालित रिग्रेशन आधार**:
+  - **292 स्वचालित टेस्ट assertions** (Node.js 163, Bash 35, PowerShell 94) में 100% सत्यापित, 0 भेद्यता, 0 hardcoded secrets।
+
+### v6.3.9
+
+- **स्थायी ReDoS रक्षा (CodeQL Alert #4 समाधान)**:
+  - YAML पार्सिंग (`updateYamlConfig`) में अस्पष्ट regex backtracking को अस्पष्टता-रहित prefix कुंजी मिलान और नेटिव `String.prototype.trim()` से बदला।
+  - `extractInlineComment` रैखिक स्कैन ($O(N)$) जोड़ा, जिससे लंबे whitespace पैडिंग पर बहुपदीय backtracking रुकता है। CodeQL Alert #4 (`js/polynomial-redos`) औपचारिक रूप से बंद।
+  - `tests/setup_test.js` में 60,000 whitespace वर्णों के विरुद्ध रैखिक प्रसंस्करण (<1ms) मान्य करने वाला रिग्रेशन सूट जोड़ा।
+- **क्लाइंट सेटअप विस्तार (17 समर्थित AI एजेंट क्लाइंट)**:
+  - macOS, Windows और Linux पर **LM Studio** (`lmstudio`, `~/.lmstudio/mcp.json`) और VS Code Desktop में **Roo Code** (`roo`, `rooveterinaryinc.roo-cline/settings/mcp_settings.json`) लक्ष्य जोड़े।
+  - `mcp_servers:` और `superpowers:` पर इनलाइन टिप्पणियाँ संरक्षित रखने हेतु YAML कॉन्फ़िगरेशन पार्सर संवर्धित।
+- **डेस्कटॉप आयात टूलिंग व Delegation Exit Code अखंडता**:
+  - डेस्कटॉप क्लाइंट आयात (ChatWise, Cherry Studio आदि) हेतु फ़ाइलें लिखे बिना स्वच्छ MCP JSON आउटपुट के लिए `setup --print-config` (वैकल्पिक `--bun`) जोड़ा।
+  - `src/server.ts` setup delegation को CLI कमांडों से `process.exitCode` संरक्षित रखने हेतु सुदृढ़ किया।
+- **डेस्कटॉप सेटअप मार्गदर्शिका**:
+  - LM Studio, Roo Code, ChatWise और Cherry Studio सेटअप वाली व्यापक [`docs/desktop-setup.md`](docs/desktop-setup.md) जोड़ी।
+
+👉 *पूर्ण रिलीज़ इतिहास हेतु [CHANGELOG.md](CHANGELOG.md) देखें।*
+
+---
+
+## 🙏 आभार
+
+यह परियोजना [obra](https://github.com/obra) की मूल [Superpowers](https://github.com/obra/superpowers) परियोजना का fork और रूपांतरण है। Agentic skills ढाँचे और सॉफ़्टवेयर विकास पद्धति को परिभाषित करने वाले उनके अग्रणी कार्य के लिए हम आभारी हैं, जो इस MCP सर्वर को शक्ति देता है।