orquestra-mcp 1.29.0 → 1.31.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.29.0",
+  "version": "1.31.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": {

package/src/server.mjs

@@ -301,9 +301,9 @@ export function createServer() {
   registerRead(
     'get_parity_summary',
     '/v1/parity',
-    'Desfases de paridad multiplataforma: tareas y módulos cuyo scope avanza en una distribución pero sigue pendiente en otra HERMANA (mismo productKey -- ver productGroups en la respuesta; si configured=false, el proyecto nunca marcó qué plataformas son el mismo producto y todas se comparan entre sí: sugiérele al usuario configurarlo con update_distribution/productKey). singleDoneItems trae las candidatas a portar con missingDistIds concretos.',
+    'Desfases de paridad multiplataforma: tareas y módulos cuyo scope avanza en una distribución pero sigue pendiente en otra HERMANA (mismo productKey -- ver productGroups en la respuesta; si configured=false, el proyecto nunca marcó qué plataformas son el mismo producto y todas se comparan entre sí: sugiérele al usuario configurarlo con update_distribution/productKey). singleDoneItems trae las candidatas a portar con missingDistIds concretos. Solo cuentan tareas de producto: se excluyen bugs, tareas fusionadas, canceladas/archivadas y las marcadas parityExempt; las candidatas a portar son solo feature/improvement/design (nunca módulos). Un gap es una señal, no un veredicto: el done por plataforma es un flag manual y el trabajo móvil suele existir ya bajo otra tarea -- verifica en el código real de esa plataforma antes de decir que falta algo o de crear una tarea. La respuesta viene compacta: el detalle de gapItems/singleDoneItems está en combined; tasks y modules solo traen totales.',
     {},
-    (args, projectId) => ({ projectId })
+    (args, projectId) => ({ projectId, compact: '1' })
   )
 
   registerRead(
@@ -1224,7 +1224,7 @@ export function createServer() {
   server.registerTool(
     'add_attachment',
     {
-      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.',
+      description: 'Adjunta evidencia (una imagen, un video o un pedazo de código) a una task/note/idea/doc/content de Orquestra. OJO: en una pieza de Contenido esto NO la deja como media (no se ve ni se publica) -- para eso usa add_content_media. 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'),
@@ -1286,6 +1286,45 @@ export function createServer() {
     }
   )
 
+  // Media de una pieza de Contenido (ORQ-283) -- distinto de add_attachment:
+  // un adjunto es evidencia privada, esto es el mediaFiles que Contenido
+  // muestra y Postproxy publica. Mismo criterio de bytes: este server lee el
+  // archivo y lo sube él mismo, nunca base64 por el input.
+  server.registerTool(
+    'add_content_media',
+    {
+      description: 'Pone una imagen o video como MEDIA de una pieza de Contenido (lo que se ve en la pieza y lo que se publica en redes) -- usa esto y NO add_attachment para contenido; add_attachment solo guarda evidencia privada que Contenido no muestra. Sube el archivo local (png/jpg/jpeg/gif/webp/mp4/mov/webm) y lo agrega al mediaFiles sin pisar el que ya haya. Sin channelId lo agrega a todos los canales de la pieza; con channelId solo a esa variante.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        contentId: z.string().describe('ID de la pieza (list_content)'),
+        filePath: z.string().describe('Ruta local a la imagen o video'),
+        channelId: z.string().optional().describe('Solo si quieres el archivo en un canal específico de una pieza multi-canal'),
+        fileName: z.string().optional().describe('Nombre a mostrar -- default: el del archivo'),
+      },
+    },
+    async ({ projectId, contentId, filePath, channelId, fileName }) => {
+      try {
+        const resolvedProjectId = resolveProjectId(projectId)
+        const stat = statSync(filePath)
+        const ext = path.extname(filePath).slice(1).toLowerCase()
+        const mime = ATTACHMENT_IMAGE_MIME_BY_EXT[ext] || ATTACHMENT_VIDEO_MIME_BY_EXT[ext]
+        if (!mime) throw new Error('Solo imágenes (png/jpg/jpeg/gif/webp) o videos (mp4/mov/webm)')
+        if (stat.size > MAX_ATTACHMENT_VIDEO_BYTES) throw new Error(`El archivo supera el máximo de ${MAX_ATTACHMENT_VIDEO_BYTES / 1024 / 1024}MB`)
+        const name = fileName || path.basename(filePath)
+        const { uploadUrl, key } = await apiPost(config, '/v1/content/media-upload-url', {
+          projectId: resolvedProjectId, fileName: name, fileType: mime, fileSize: stat.size,
+        })
+        await putToPresignedUrl(uploadUrl, readFileSync(filePath), mime)
+        const data = await apiPost(config, `/v1/content/${contentId}/media`, {
+          projectId: resolvedProjectId, key, name, type: mime, size: stat.size, ...(channelId ? { channelId } : {}),
+        })
+        return textResult(data)
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
   // Segunda excepción real a "creación + edición, nunca borrado" (junto a
   // delete_checklist_item, ver CLAUDE.md) -- decisión consciente de José:
   // un agente puede subir evidencia equivocada (screenshot que no era,