orquestra-mcp 1.26.0 → 1.29.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.26.0",
-  "description": "Servidor MCP de Orquestra -- 109 tools para leer y escribir tareas, ideas, changelog, infraestructura, contenido, QA y más desde un agente de IA",
+  "version": "1.29.0",
+  "description": "Servidor MCP de Orquestra -- 115 tools para leer y escribir tareas, ideas, changelog, infraestructura, contenido, QA y más desde un agente de IA",
   "type": "module",
   "bin": {
     "orquestra-mcp": "bin/orquestra-mcp.mjs"
@@ -26,6 +26,6 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
-    "zod": "^3.23.8"
+    "zod": "^4.6.5"
   }
 }

package/src/server.mjs

@@ -46,13 +46,15 @@ const PLATFORM_TYPES = ['android', 'ios', 'web', 'desktop-mac', 'desktop-win', '
 const INFRA_STATUSES = ['operational', 'degraded', 'down']
 const STAGE_IDS = STAGES.map(s => s.id)
 
-// Adjuntos -- entityType en la tool es singular (task/note/idea/doc, más
-// natural para el modelo), la API usa el plural de la colección de
-// Firestore (tasks/notes/ideas/docs) -- este mapa traduce entre los dos.
-const ATTACHMENT_ENTITY_PATH = { task: 'tasks', note: 'notes', idea: 'ideas', doc: 'docs' }
+// Adjuntos -- entityType en la tool es singular (task/note/idea/doc/content,
+// más natural para el modelo), la API usa el plural de la colección de
+// Firestore (tasks/notes/ideas/docs/content) -- este mapa traduce entre los dos.
+const ATTACHMENT_ENTITY_PATH = { task: 'tasks', note: 'notes', idea: 'ideas', doc: 'docs', content: 'content' }
 const ATTACHMENT_ENTITY_TYPES = Object.keys(ATTACHMENT_ENTITY_PATH)
 const ATTACHMENT_IMAGE_MIME_BY_EXT = { png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif', webp: 'image/webp' }
+const ATTACHMENT_VIDEO_MIME_BY_EXT = { mp4: 'video/mp4', mov: 'video/quicktime', webm: 'video/webm' }
 const MAX_ATTACHMENT_IMAGE_BYTES = 15 * 1024 * 1024
+const MAX_ATTACHMENT_VIDEO_BYTES = 500 * 1024 * 1024
 const MAX_ATTACHMENT_CODE_CHARS = 200_000
 
 const SETUP_GUIDE = {
@@ -750,6 +752,84 @@ export function createServer() {
     }
   )
 
+  // Crear rama + abrir PR borrador desde una tarea (ORQ-204, 10 oct 2026):
+  // requiere que la GitHub App de ese repo tenga permisos de escritura en
+  // Contents/Pull requests -- si no, el servidor responde 502/403 con el
+  // detalle de GitHub. "Crear rama" guarda el nombre en task.branch (lo que
+  // ya lee sync_task_from_github); "Abrir PR" exige que la tarea ya tenga
+  // branch (de este tool o puesto a mano).
+  server.registerTool(
+    'create_task_branch',
+    {
+      description: 'Crea una rama en GitHub para esta tarea (ej. "ORQ-123-arregla-el-login") desde la rama base de la integración, y la guarda en task.branch. Idempotente: si la rama ya existe, no falla. Si el proyecto tiene varios repos conectados, pasa integrationId (list_github_integrations).',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        taskId: z.string().describe('ID de la tarea'),
+        integrationId: z.string().optional().describe('Integración (repo) concreta; opcional si solo hay una'),
+        branchName: z.string().optional().describe('Nombre de rama explícito; por default "<shortCode>-<slug del título>"'),
+      },
+    },
+    async ({ projectId, taskId, integrationId, branchName }) => {
+      try {
+        return textResult(await apiPost(config, `/v1/tasks/${taskId}/github-branch`, { projectId: resolveProjectId(projectId), ...(integrationId ? { integrationId } : {}), ...(branchName ? { branchName } : {}) }))
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
+  server.registerTool(
+    'open_task_pr',
+    {
+      description: 'Abre un PR borrador en GitHub desde task.branch hacia la rama base de la integración, con el shortCode y el link a la tarea en el título/cuerpo, y guarda prNumber/prUrl en la tarea. Requiere que la tarea ya tenga branch (create_task_branch primero, o uno puesto a mano). Idempotente: si ya hay un PR abierto para esa rama, devuelve ESE en vez de fallar.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        taskId: z.string().describe('ID de la tarea'),
+        integrationId: z.string().optional().describe('Integración (repo) concreta; opcional si solo hay una'),
+      },
+    },
+    async ({ projectId, taskId, integrationId }) => {
+      try {
+        return textResult(await apiPost(config, `/v1/tasks/${taskId}/github-pr`, { projectId: resolveProjectId(projectId), ...(integrationId ? { integrationId } : {}) }))
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
+  // Sync de Issues de GitHub <-> tareas (ORQ-203, 10 oct 2026): opt-in POR
+  // INTEGRACIÓN (apagado por default). Prenderlo exige issuesModuleId (a
+  // qué módulo van las tareas que crea un issue nuevo) -- sin eso, create_task
+  // no puede cumplir con "toda tarea requiere módulo". Una vez prendido:
+  // issues.opened crea una tarea tipo bug con el link del issue; cerrar la
+  // tarea cierra el issue y cerrar el issue cierra la tarea (sin bucles,
+  // ambos lados son idempotentes). mirrorComments (opcional, aparte) espeja
+  // comentarios nuevos del issue como comentario de sistema en la tarea --
+  // solo en ese sentido, comentar en Orquestra no escribe de vuelta en GitHub.
+  server.registerTool(
+    'update_github_issues_sync',
+    {
+      description: 'Prende/apaga el sync de Issues<->tareas de un repo conectado (opt-in por integración). issuesSync:true exige issuesModuleId (módulo donde caen las tareas que crea un issue nuevo). mirrorComments es opcional y aparte: espeja comentarios nuevos del issue como comentario de sistema en la tarea (solo en ese sentido).',
+      inputSchema: {
+        integrationId: z.string().describe('Integración (repo conectado) a configurar -- list_github_integrations'),
+        issuesSync: z.boolean().optional().describe('Prender/apagar la creación automática de tareas desde issues y el cierre cruzado'),
+        issuesModuleId: z.string().optional().describe('Módulo donde crear las tareas que originan los issues -- obligatorio para prender issuesSync'),
+        mirrorComments: z.boolean().optional().describe('Espejar comentarios nuevos del issue como comentario de sistema en la tarea (GitHub -> Orquestra, no al revés)'),
+      },
+    },
+    async ({ integrationId, issuesSync, issuesModuleId, mirrorComments }) => {
+      try {
+        return textResult(await apiPatchPath(config, `/v1/github-integrations/${integrationId}/github-issues`, {
+          ...(issuesSync !== undefined ? { issuesSync } : {}),
+          ...(issuesModuleId !== undefined ? { issuesModuleId } : {}),
+          ...(mirrorComments !== undefined ? { mirrorComments } : {}),
+        }))
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
   server.registerTool(
     'run_closure_scan',
     {
@@ -924,7 +1004,7 @@ export function createServer() {
   server.registerTool(
     'publish_content_postproxy',
     {
-      description: 'Publica o programa una pieza de Contenido en redes sociales vía Postproxy -- solo funciona si la pieza tiene al menos una variante en estatus "approved" y su canal ya está conectado (ver connect_postproxy_channel/list_channels). Respeta approvalRequired -- no la llames para saltarte una aprobación pendiente. Cada variante aprobada va en SU PROPIO post de Postproxy (caption/media/fecha propios); antes de cada uno el server verifica el perfil EN VIVO y rechaza con un 400 claro si la cuenta está vencida, ya no existe, o (Instagram/TikTok) vive en el group de Postproxy de otro proyecto -- es decir, el canal apunta a la cuenta de otro proyecto y hay que reconectarlo. Devuelve {posts:[{channelId, postproxyPostId, status}], failed:[{channelId, channelName, error}]}: con éxito parcial responde 200 igual, así que revisa `failed` y cuéntaselo al usuario -- cada variante queda con su externalGuid o su publishError en la pieza.',
+      description: 'Publica o programa una pieza de Contenido en redes sociales vía Postproxy -- solo funciona si la pieza tiene al menos una variante en estatus "approved" y su canal ya está conectado (ver connect_postproxy_channel/list_channels). Si el workspace todavía no tiene Postproxy habilitado (BAJO SOLICITUD, ver connect_postproxy_channel), responde 403 `postproxy_not_enabled` -- no reintentes, dile al usuario que un admin lo solicite desde Contenido → Cuentas conectadas → "Solicitar conexión". Respeta approvalRequired -- no la llames para saltarte una aprobación pendiente. Cada variante aprobada va en SU PROPIO post de Postproxy (caption/media/fecha propios); antes de cada uno el server verifica el perfil EN VIVO y rechaza con un 400 claro si la cuenta está vencida, ya no existe, o (Instagram/TikTok) vive en el group de Postproxy de otro proyecto -- es decir, el canal apunta a la cuenta de otro proyecto y hay que reconectarlo. Devuelve {posts:[{channelId, postproxyPostId, status}], failed:[{channelId, channelName, error}]}: con éxito parcial responde 200 igual, así que revisa `failed` y cuéntaselo al usuario -- cada variante queda con su externalGuid o su publishError en la pieza.',
       inputSchema: {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
         contentId: z.string().describe('Pieza de Contenido a publicar (ver list_content)'),
@@ -941,6 +1021,79 @@ export function createServer() {
     }
   )
 
+  // sync_content_postproxy / reschedule_content_postproxy (10 oct 2026, a
+  // pedido de José: "todo esto que estamos haciendo en web, también se
+  // puede hacer por MCP?") -- paridad con los botones "Consultar ahora" y
+  // "Reagendar en Postproxy" de ContentDetail.jsx, que hasta ahora solo
+  // existían en la web. Mismo criterio que publish_content_postproxy
+  // (server.registerTool directo, no CRUD estándar).
+  server.registerTool(
+    'sync_content_postproxy',
+    {
+      description: 'Pide el estado REAL de Postproxy para las variantes ya enviadas de una pieza (con externalGuid), en vez de esperar pasivamente el webhook -- usala si una pieza quedó "esperando confirmación" más tiempo del esperado (el webhook de Postproxy se perdió o tardó) o si el usuario pregunta "¿ya se publicó?" y querés confirmarlo ahora en vez de asumir. Actualiza status/publishedAt/postproxyPermalink/publishError en Firestore si Postproxy tiene novedades, y siempre estampa lastPostproxyCheckAt aunque no haya cambios -- también si la pieza ya está agendada a futuro (scheduledAt), en cuyo caso Postproxy SIEMPRE va a responder "todavía no", no es un error ni señal de que algo falló. Devuelve {checked}: cuántas variantes con externalGuid se consultaron (0 si la pieza nunca se envió a Postproxy). Después de llamarla, volvé a leer la pieza con list_content para ver si cambió -- la respuesta de esta tool no trae el contenido actualizado.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        contentId: z.string().describe('Pieza de Contenido a consultar (ver list_content)'),
+      },
+    },
+    async ({ projectId, contentId }) => {
+      try {
+        const data = await apiPost(config, `/v1/content/${contentId}/sync-postproxy`, { projectId: resolveProjectId(projectId) })
+        return textResult(data)
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
+  server.registerTool(
+    'reschedule_content_postproxy',
+    {
+      description: 'Reagenda en Postproxy un canal de una pieza YA enviado (con externalGuid). Cambiar scheduledAt con update_content SOLO escribe Firestore -- el post real en Postproxy sigue en la hora VIEJA hasta llamar esta tool, así que después de mover la fecha con update_content llamá siempre a esta para que el cambio aplique de verdad. Postproxy solo deja editar drafts o posts programados a MÁS de 5 minutos de su hora real de publicación -- devuelve 422 "Post cannot be edited..." si ya se publicó o está a menos de 5 minutos, ese mensaje sube tal cual, no hay forma de evitarlo. Si sale bien, también actualiza scheduledAt en Firestore para esa variante (no hace falta un update_content aparte). channelId tiene que ser un canal que la pieza YA tenga y que ya esté enviado a Postproxy (ver list_content) -- si no tiene externalGuid todavía, falla con 400 explicando que primero hay que publish_content_postproxy.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        contentId: z.string().describe('Pieza de Contenido a reagendar (ver list_content)'),
+        channelId: z.string().describe('Canal ya enviado a Postproxy (con externalGuid) dentro de esa pieza'),
+        scheduledAt: z.number().describe('Nuevo timestamp en ms de cuándo debe publicarse'),
+      },
+    },
+    async ({ projectId, contentId, channelId, scheduledAt }) => {
+      try {
+        const data = await apiPost(config, `/v1/content/${contentId}/reschedule-postproxy`, { projectId: resolveProjectId(projectId), channelId, scheduledAt })
+        return textResult(data)
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
+  // backfill_channel_content (10 oct 2026, a pedido de José: "agregar canal
+  // y agregar los contenidos que aún no se publican... para que todos
+  // estén parejos") -- recorre TODO el proyecto en un solo llamado, no una
+  // pieza a la vez (equivalente en bulk al botón "Copiar contenido acá" de
+  // ContentDetail.jsx en la web, que solo opera sobre una pieza). No es CRUD
+  // estándar (no crea ni edita UNA entidad con un id propio), así que va
+  // con server.registerTool directo, mismo criterio que publish_content_postproxy.
+  server.registerTool(
+    'backfill_channel_content',
+    {
+      description: 'Agrega un canal a TODAS las piezas de Contenido del proyecto que todavía no lo tienen, copiando caption/media/prompts/formato de otro canal que sí los tenga -- para que un canal recién conectado (ej. LinkedIn) no arranque en blanco pieza por pieza. Solo toca piezas pendientes: se SALTEA automáticamente una pieza si el canal fuente ya está en estatus "published" ahí, si el canal fuente no tiene contenido real que copiar, o si la pieza ya tiene el canal destino. NUNCA pisa fecha (scheduledAt)/aprobación/estatus/desempeño -- el canal nuevo arranca siempre en estatus "idea", sin fecha, cada canal programa/aprueba por separado. Devuelve {updated, updatedIds, skipped, skippedDetail:[{id,title,reason}], failed}: revisa `failed` (reintentos que fallaron la escritura) y contale al usuario cuántas piezas se saltearon y por qué, no asumas que "updated" es el total de piezas del proyecto.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        channelId: z.string().describe('Canal a agregar donde falte (ver list_channels) -- recién conectado o con pocas piezas todavía'),
+        sourceChannelId: z.string().describe('Canal del que copiar el contenido en cada pieza (ver list_channels) -- tiene que ser distinto de channelId'),
+      },
+    },
+    async ({ projectId, channelId, sourceChannelId }) => {
+      try {
+        const data = await apiPost(config, '/v1/content/backfill-channel', { projectId: resolveProjectId(projectId), channelId, sourceChannelId })
+        return textResult(data)
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
   // Checklist de una tarea -- registradas directo con server.registerTool
   // (no con registerCreate/registerUpdate) porque su ruta necesita DOS ids
   // dinámicos (taskId + itemId del checklist), y esos helpers solo arman
@@ -1043,11 +1196,11 @@ export function createServer() {
   server.registerTool(
     'list_attachments',
     {
-      description: 'Lista los adjuntos (imágenes + código) de una task/note/idea/doc de Orquestra.',
+      description: 'Lista los adjuntos (imágenes + video + código) de una task/note/idea/doc/content de Orquestra.',
       inputSchema: {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
         entityType: z.enum(ATTACHMENT_ENTITY_TYPES).describe('Tipo de entidad dueña de los adjuntos'),
-        entityId: z.string().describe('ID de la entidad (task/note/idea/doc)'),
+        entityId: z.string().describe('ID de la entidad (task/note/idea/doc/content)'),
       },
     },
     async ({ projectId, entityType, entityId }) => {
@@ -1071,12 +1224,12 @@ export function createServer() {
   server.registerTool(
     'add_attachment',
     {
-      description: 'Adjunta evidencia (una imagen o un pedazo de código) a una task/note/idea/doc de Orquestra. Manda EXACTAMENTE uno de filePath (ruta local -- una imagen png/jpg/jpeg/gif/webp se sube a S3, cualquier otra extensión se lee como texto/código) o content (texto/código directo, sin tocar el filesystem). Nunca mandes bytes de imagen en base64 dentro de content -- usa filePath para que este server los suba él mismo.',
+      description: 'Adjunta evidencia (una imagen, un video o un pedazo de código) a una task/note/idea/doc/content de Orquestra. Manda EXACTAMENTE uno de filePath (ruta local -- una imagen png/jpg/jpeg/gif/webp o un video mp4/mov/webm se sube a S3, cualquier otra extensión se lee como texto/código) o content (texto/código directo, sin tocar el filesystem). Nunca mandes bytes de imagen/video en base64 dentro de content -- usa filePath para que este server los suba él mismo.',
       inputSchema: {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
         entityType: z.enum(ATTACHMENT_ENTITY_TYPES).describe('Tipo de entidad a la que se adjunta'),
-        entityId: z.string().describe('ID de la entidad (task/note/idea/doc)'),
-        filePath: z.string().optional().describe('Ruta local a un archivo -- imagen (png/jpg/jpeg/gif/webp) o código/texto.'),
+        entityId: z.string().describe('ID de la entidad (task/note/idea/doc/content)'),
+        filePath: z.string().optional().describe('Ruta local a un archivo -- imagen (png/jpg/jpeg/gif/webp), video (mp4/mov/webm) o código/texto.'),
         content: z.string().optional().describe('Texto/código a adjuntar directo, sin leer un archivo.'),
         language: z.string().optional().describe('Label libre del lenguaje del snippet (ej. "python", "diff") -- solo informativo, no tokeniza (Orquestra no resalta sintaxis).'),
         fileName: z.string().optional().describe('Nombre a mostrar -- si no se manda, sale de filePath o de un default genérico.'),
@@ -1099,11 +1252,15 @@ export function createServer() {
         } else {
           const stat = statSync(filePath)
           const ext = path.extname(filePath).slice(1).toLowerCase()
-          const mime = ATTACHMENT_IMAGE_MIME_BY_EXT[ext]
+          const imageMime = ATTACHMENT_IMAGE_MIME_BY_EXT[ext]
+          const videoMime = ATTACHMENT_VIDEO_MIME_BY_EXT[ext]
+          const mime = imageMime || videoMime
+          const kind = imageMime ? 'image' : videoMime ? 'video' : null
           const resolvedFileName = fileName || path.basename(filePath)
           if (mime) {
-            if (stat.size > MAX_ATTACHMENT_IMAGE_BYTES) {
-              throw new Error(`La imagen supera el máximo de ${MAX_ATTACHMENT_IMAGE_BYTES / 1024 / 1024}MB`)
+            const maxBytes = kind === 'video' ? MAX_ATTACHMENT_VIDEO_BYTES : MAX_ATTACHMENT_IMAGE_BYTES
+            if (stat.size > maxBytes) {
+              throw new Error(`El archivo supera el máximo de ${maxBytes / 1024 / 1024}MB`)
             }
             const buffer = readFileSync(filePath)
             const { uploadUrl, key } = await apiPost(config, '/v1/attachments/upload-url', {
@@ -1111,7 +1268,7 @@ export function createServer() {
               fileName: resolvedFileName, fileType: mime, fileSize: stat.size,
             })
             await putToPresignedUrl(uploadUrl, buffer, mime)
-            body = { kind: 'image', key, fileName: resolvedFileName, fileType: mime, fileSize: stat.size, caption }
+            body = { kind, key, fileName: resolvedFileName, fileType: mime, fileSize: stat.size, caption }
           } else {
             const text = readFileSync(filePath, 'utf8')
             if (text.length > MAX_ATTACHMENT_CODE_CHARS) {
@@ -1138,11 +1295,11 @@ export function createServer() {
   server.registerTool(
     'delete_attachment',
     {
-      description: 'Borra un adjunto (imagen o código) de una task/note/idea/doc de Orquestra -- limpia también el objeto en S3 si era una imagen. Segunda excepción a "nunca borrado" (junto a delete_checklist_item) -- usalo para limpiar evidencia subida por error, no como reemplazo de mantener historial.',
+      description: 'Borra un adjunto (imagen, video o código) de una task/note/idea/doc/content de Orquestra -- limpia también el objeto en S3 si era imagen o video. Segunda excepción a "nunca borrado" (junto a delete_checklist_item) -- usalo para limpiar evidencia subida por error, no como reemplazo de mantener historial.',
       inputSchema: {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
         entityType: z.enum(ATTACHMENT_ENTITY_TYPES).describe('Tipo de entidad dueña del adjunto'),
-        entityId: z.string().describe('ID de la entidad (task/note/idea/doc)'),
+        entityId: z.string().describe('ID de la entidad (task/note/idea/doc/content)'),
         attachmentId: z.string().describe('ID del adjunto a borrar (ver list_attachments)'),
       },
     },