orquestra-mcp 1.5.0 → 1.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "Servidor MCP de Orquestra -- 38 tools para leer y escribir tareas, ideas, changelog, infraestructura, QA y más desde un agente de IA",
   "type": "module",
   "bin": {

package/src/server.mjs

@@ -57,8 +57,9 @@ Durante el trabajo normal de código, sin que el usuario te lo pida explícitame
 - Si te pide una funcionalidad o arreglo real (no una pregunta rápida ni exploración de código sin cambios), revisa con list_tasks/search si ya existe una tarea relacionada; si no, créala con create_task antes de empezar a trabajar.
 - Al terminar, mueve la tarea de estatus con update_task y registra una entrada de changelog con create_changelog_entry -- así el usuario nunca tiene que documentar esto a mano.
 - Antes de crear un módulo/estatus/categoría/servicio/entorno/distribución, revisa con el list_* correspondiente que no exista ya uno con ese nombre.
+- Si una nota que vas a crear (create_note) es claramente sobre un módulo o una tarea específica -- por ejemplo durante un setup guiado donde acabas de crear ambos -- mándale moduleId/taskId para ligarla, en vez de dejarla suelta. No inventes la relación si no es clara.
 - Si tienes acceso al repo real de una distribución (ej. puedes correr "git remote get-url origin" en ese código), llena repoUrl en create_distribution/update_distribution sin preguntar -- es solo informativo, no requiere credenciales. Esto es distinto de conectar el repo con PAT para el changelog automático (Workspace → Conexiones en orquestra-web): eso sí es un paso deliberado del usuario, con una credencial real -- nunca lo hagas tú solo ni sugieras que ya está conectado por haber llenado repoUrl.
-- No todas las tareas necesitan una corrida de QA -- clasifica antes de disparar una: cambios que afectan comportamiento real (features, bugs, UI, lógica de negocio, endpoints/API) sí la necesitan; cambios que no alteran comportamiento (docs, comentarios, refactors sin cambio funcional, config/tooling interno, notas/reuniones/ideas) no. Si decides que sí, llama a create_qa_run en la rama real de ese trabajo y deja la tarea en "En revisión" -- NUNCA la muevas a "Listo" ni digas que "QA lo revisó" sin haber confirmado con get_qa_run un estatus terminal "passed" de verdad (las corridas son asíncronas, tardan minutos en otra máquina). Si tarda, dile al usuario que quedó en cola (con el runId) y que confirmas cuando termine -- no lo des por hecho nunca.
+- No todas las tareas necesitan una corrida de QA -- clasifica antes de disparar una: cambios que afectan comportamiento real (features, bugs, UI, lógica de negocio, endpoints/API) sí la necesitan; cambios que no alteran comportamiento (docs, comentarios, refactors sin cambio funcional, config/tooling interno, notas/reuniones/ideas) no. Si decides que sí, revisa primero con list_qa_agents que exista un agente para el stack que tocaste (si no hay ninguno, créalo con create_qa_agent -- necesita una máquina ya emparejada, ver Workspace → QA) y llama a create_qa_run en la rama real de ese trabajo, dejando la tarea en "En revisión" -- NUNCA la muevas a "Listo" ni digas que "QA lo revisó" sin haber confirmado con get_qa_run un estatus terminal "passed" de verdad (las corridas son asíncronas, tardan minutos en otra máquina). Si tarda, dile al usuario que quedó en cola (con el runId) y que confirmas cuando termine -- no lo des por hecho nunca.
 
 No le preguntes al usuario por workspaceId ni projectId -- ya están configurados. Solo pregúntale por el proyecto si tiene más de uno y no queda claro a cuál te refieres.
 
@@ -341,6 +342,8 @@ export function createServer() {
       title: z.string().describe('Título de la nota'),
       body: z.string().optional(),
       pinned: z.boolean().optional(),
+      moduleId: z.string().optional().describe('Módulo relacionado, si la nota es sobre uno específico -- ligarla ayuda a encontrarla después (ver list_modules)'),
+      taskId: z.string().optional().describe('Tarea relacionada, si la nota es sobre una específica (ver list_tasks)'),
     }
   )
 
@@ -521,13 +524,44 @@ export function createServer() {
   // ═══ QA (módulo de runners -- ver orquestra-qa-agent) ═══════════════════════
   // Asíncronas: una corrida puede tardar minutos en otra máquina. Ver
   // SERVER_INSTRUCTIONS para la regla de no asumir "passed" sin confirmar.
+  //
+  // Un agente = un stack de este proyecto (web/ios/android/node/nestjs)
+  // atado a una máquina (runnerId) y una ruta de checkout en ella
+  // (localPath) -- "orquestra-qa-agent setup" crea/actualiza el suyo solo;
+  // estas tools existen para revisarlos/crearlos desde acá también.
+  const QA_AGENT_STACKS = ['web', 'ios', 'android', 'node', 'nestjs']
+
+  registerRead('list_qa_agents', '/v1/qaAgents',
+    'Lista los agentes de QA (stack+máquina+ruta local) configurados en un proyecto. Úsala antes de create_qa_agent o de create_qa_run con stack, para saber si ya existe uno.',
+    {}, (args, projectId) => ({ projectId }))
+
+  registerCreate('create_qa_agent', '/v1/qaAgents', 'Crea un agente de QA: asocia un stack de este proyecto a una máquina (runner, ver Workspace → QA) y una ruta de checkout en ESA máquina.', {
+    name: z.string().describe('Nombre a mostrar, ej. "Agente web"'),
+    stack: z.enum(QA_AGENT_STACKS),
+    runnerId: z.string().describe('ID de la máquina emparejada -- ver list_qa_agents o Workspace → QA'),
+    localPath: z.string().describe('Ruta absoluta del checkout en esa máquina'),
+    branch: z.string().optional().describe('Override de rama para este agente -- default: la del proyecto'),
+    distributionId: z.string().optional().describe('Distribución vinculada (repo/fuente de conocimiento)'),
+    enabled: z.boolean().optional(),
+  })
+
+  registerUpdate('update_qa_agent', '/v1/qaAgents', 'Edita un agente de QA existente.', {
+    name: z.string().optional(),
+    stack: z.enum(QA_AGENT_STACKS).optional(),
+    runnerId: z.string().optional(),
+    localPath: z.string().optional(),
+    branch: z.string().optional(),
+    distributionId: z.string().optional(),
+    enabled: z.boolean().optional(),
+  })
 
-  registerCreate('create_qa_run', '/v1/qa/runs', 'Dispara una corrida de QA (lint/tests/build/E2E según el stack) en la rama indicada. El proyecto necesita QA activado (Workspace → QA + sección QA del proyecto) o falla explícito. La corrida queda "queued" -- nunca asumas que pasó, confirma con get_qa_run.', {
-    branch: z.string().optional().describe('Rama a probar -- default: la configurada para el proyecto, o "main"'),
+  registerCreate('create_qa_run', '/v1/qa/runs', 'Dispara una corrida de QA (lint/tests/build/E2E según el stack) en la rama indicada. El proyecto necesita QA activado y al menos un agente de QA para el stack (o falla explícito -- ver list_qa_agents/create_qa_agent). La corrida queda "queued" -- nunca asumas que pasó, confirma con get_qa_run.', {
+    agentId: z.string().optional().describe('Agente específico -- si se manda, gana sobre stack'),
+    branch: z.string().optional().describe('Rama a probar -- default: la del agente, o la del proyecto, o "main"'),
     commit: z.string().optional(),
     trigger: z.enum(['manual', 'push', 'schedule']).optional().describe('Default: manual'),
-    stack: z.string().optional().describe('Stack a probar (ej. "web", "ios", "android") cuando el proyecto tiene varios corriendo en máquinas distintas. Si el proyecto tiene qaConfig.runnerByStack configurado, resuelve solo la máquina de ese stack -- default: el runner/stack global del proyecto.'),
-    runnerId: z.string().optional().describe('Máquina específica -- si se manda, gana sobre la resuelta por stack. Default: la configurada para el proyecto/stack, o cualquiera disponible'),
+    stack: z.string().optional().describe('Stack a probar (ej. "web", "ios", "android") -- resuelve contra los agentes activos de ese stack. Falla si hay 0 (créalo con create_qa_agent) o más de 1 (usa agentId).'),
+    runnerId: z.string().optional().describe('Máquina específica -- si se manda, gana sobre la del agente resuelto'),
   })
 
   server.registerTool(