orquestra-mcp 1.56.0 → 1.58.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.56.0",
+  "version": "1.58.0",
   "description": "Servidor MCP de Orquestra -- 135 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

@@ -284,7 +284,7 @@ export function createServer() {
   registerRead(
     'list_tasks',
     '/v1/tasks',
-    'Lista las tareas de un proyecto de Orquestra, opcionalmente filtradas por estatus/módulo/tipo/prioridad/responsable/tag. Los filtros se combinan con AND -- pásalos en vez de traer todo el proyecto y filtrar tú mismo del lado del cliente. Por default excluye tareas cerradas (isFinal/isCancel/isArchive) -- un proyecto con historial acumula cientos, traerlas todas revienta el contexto sin que nadie las haya pedido. Si mandas statusId puntual, eso ya es una elección explícita y no se le suma este filtro (podés pedir "solo Listo"). Para historial/auditoría real, usa includeClosed=true. No incluye actividades (reuniones/llamadas/seguimientos) -- esas van con list_activities.',
+    'Lista las tareas de un proyecto de Orquestra, opcionalmente filtradas por estatus/módulo/tipo/prioridad/responsable/tag/groupKey (código de agrupación, ej. V2). Cada tarea trae su groupCode si lo tiene. Los filtros se combinan con AND -- pásalos en vez de traer todo el proyecto y filtrar tú mismo del lado del cliente. Por default excluye tareas cerradas (isFinal/isCancel/isArchive) -- un proyecto con historial acumula cientos, traerlas todas revienta el contexto sin que nadie las haya pedido. Si mandas statusId puntual, eso ya es una elección explícita y no se le suma este filtro (podés pedir "solo Listo"). Para historial/auditoría real, usa includeClosed=true. No incluye actividades (reuniones/llamadas/seguimientos) -- esas van con list_activities.',
     {
       statusId: z.string().optional().describe('ID de estatus para filtrar (opcional) -- pedir un estatus puntual (incluso uno cerrado) siempre se respeta tal cual, sin el filtro default de abiertas'),
       moduleId: z.string().optional().describe('ID de módulo para filtrar (opcional)'),
@@ -293,6 +293,7 @@ export function createServer() {
       assignedTo: z.string().optional().describe('uid del responsable para filtrar (opcional)'),
       tag: z.string().optional().describe('Un tag exacto para filtrar -- solo uno, no una lista (opcional)'),
       workCategory: z.enum(WORK_CATEGORIES).optional().describe('Categoría de trabajo para filtrar (opcional): plan | build | delivery | review'),
+      groupKey: z.string().max(10).optional().describe('Clave de agrupación exacta (ej. "V2") para traer solo las tareas de ese grupo (groupCode V2-1, V2-2...) -- úsalo antes de crear una tarea nueva de una iniciativa para reutilizar la clave y ver cuáles existen (opcional)'),
       includeClosed: z.boolean().optional().describe('Default false -- sin esto, tareas en un estatus isFinal/isCancel/isArchive quedan afuera. Ponelo en true solo si de verdad necesitás el historial cerrado (auditoría, "¿cuándo se hizo X?").'),
     },
     (args, projectId) => ({
@@ -304,6 +305,7 @@ export function createServer() {
       assignedTo: args.assignedTo,
       tag: args.tag,
       workCategory: args.workCategory,
+      groupKey: args.groupKey,
       includeClosed: args.includeClosed,
     })
   )
@@ -788,6 +790,7 @@ export function createServer() {
       skipParity: z.boolean().optional().describe('true = NO sumar las plataformas hermanas al scope aunque tengan el mismo productKey. Solo cuando el trabajo es genuinamente de UNA plataforma (ej. un ajuste de Gradle que no tiene contraparte en iOS) -- no lo mandes por default. Las tareas type="bug" nunca propagan, sin necesidad de esto.'),
       parityExempt: z.boolean().optional().describe('true = este trabajo es de UNA sola plataforma y no cuenta en get_parity_summary (se pone solo cuando skipParity va con scope de una sola dist). false para volver a contarla.'),
       parityOf: z.string().optional().describe('Folio: id de la tarea ORIGEN de la que esta es la hermana para otra plataforma (ej. la versión iOS de una tarea de Android). En paridad cuentan como UN item y al cerrar esta, su plataforma queda hecha en el origen. El origen no puede ser hermana de otra. "" lo quita.'),
+      groupKey: z.string().max(10).optional().describe('Código de agrupación (ORQ-464): clave corta de una iniciativa que cruza módulos (ej. "V2", "LANZ"; 2-10 letras/números, empieza con letra). El server asigna groupCode = clave + número ("V2-3"), separado del moduleCode y del folio ORQ-N. Úsalo cuando la tarea es parte de una iniciativa/entrega mayor que atraviesa varios módulos; propónlo tú al armar ese trabajo. Reutiliza la MISMA clave para todas las tareas del mismo grupo y revisa con list_tasks (groupKey) las que ya existen antes de inventar una nueva. No uses la clave de un módulo (400). Sin groupKey la tarea no lleva grupo.'),
       moduleCode: z.string().max(40).optional().describe('Clave de la tarea dentro de su módulo (ej. "AUTH-3"), ADEMÁS del folio ORQ-N. NO la mandes normalmente: si el módulo tiene clave (key), el server la asigna sola. Solo para conservar la clave que ya traía de otro sistema al importar (ej. "PROJ-128" de Jira/Linear).'),
       relatedTaskId: z.string().optional().describe('"Bloqueada por" -- id de otra tarea. LEGACY desde ORQ-248: si vas a bloquear por más de una tarea, usa blockedByIds en vez de esto (relatedTaskId se sigue llenando solo, como blockedByIds[0], para paridad con iOS/Android).'),
       blockedByIds: z.array(z.string()).optional().describe('"Bloqueada por" -- ids de otras tareas (puede ser más de una). Esta tarea se muestra como bloqueada mientras ALGUNA de esas no llegue a un estatus final (isFinal). Reemplaza a relatedTaskId para bloqueos múltiples -- preferí este campo, no relatedTaskId, salvo que de verdad sea un solo bloqueador.'),
@@ -836,6 +839,7 @@ export function createServer() {
         .describe('Alcance por distribución -- usa get_parity_summary para ver el scope actual antes de editarlo'),
       parityExempt: z.boolean().optional().describe('true = este trabajo es de UNA sola plataforma y no cuenta en get_parity_summary; false para volver a contarla.'),
       parityOf: z.string().optional().describe('Folio: id de la tarea ORIGEN de la que esta es la hermana para otra plataforma (ej. la versión iOS de una tarea de Android). En paridad cuentan como UN item y al cerrar esta, su plataforma queda hecha en el origen. El origen no puede ser hermana de otra. "" lo quita.'),
+      groupKey: z.string().max(10).optional().describe('Código de agrupación (ORQ-464): clave corta de una iniciativa que cruza módulos (ej. "V2"; 2-10 letras/números, empieza con letra). Estable: editar la tarea sin groupKey NO cambia su groupCode ni se gasta número si mandas la misma clave. Otra clave la reasigna (número nuevo de esa clave, ej. "LANZ-1"); "" quita el código. Reutiliza la misma clave para las tareas del mismo grupo y revisa antes con list_tasks (groupKey). No uses la clave de un módulo (400).'),
       moduleCode: z.string().max(40).optional().describe('Clave de la tarea dentro de su módulo (ej. "AUTH-3"), texto libre editable a mano. "" la quita. Mover la tarea a otro módulo (moduleId) NO la cambia: la clave es estable.'),
       relatedTaskId: z.string().optional().describe('"Bloqueada por" -- id de otra tarea, o "" para quitar el bloqueo. LEGACY, ver create_task -- preferí blockedByIds.'),
       blockedByIds: z.array(z.string()).optional().describe('"Bloqueada por" -- reemplaza el array COMPLETO (no hace merge), [] quita todos los bloqueos. Ver create_task.'),
@@ -872,8 +876,8 @@ export function createServer() {
     location: z.string().optional().describe('Plataforma o lugar ("Zoom", "Oficina del cliente") o contexto libre para un seguimiento.'),
     participants: z.array(z.string()).optional().describe('Nombres libres de quienes participan (cliente, equipo) -- no uids.'),
     description: z.string().optional().describe('Notas previas.'),
-    agendaItems: z.array(z.union([z.string(), z.object({ id: z.string().optional(), text: z.string(), group: z.string().max(60).optional(), createdAt: z.number().optional(), createdBy: z.string().optional() })])).optional()
-      .describe('Puntos a revisar en la reunión (ej. "Revisar [[ORQ-123]]"). Lista simple, NO checklist. Cada punto puede llevar group (agrupa puntos bajo un encabezado, máx. 60 caracteres). Reemplaza la lista COMPLETA: para agregar uno, lee la actual con list_activities y manda todos, con sus id para conservarlos Y con su group -- si reenvías un punto sin group, pierde su grupo.'),
+    agendaItems: z.array(z.union([z.string(), z.object({ id: z.string().optional(), text: z.string(), group: z.string().max(60).optional(), resolution: z.string().max(2000).optional(), resolutionStatus: z.enum(['pendiente', 'decidido', 'pospuesto', '']).optional(), createdAt: z.number().optional(), createdBy: z.string().optional() })])).optional()
+      .describe('Puntos a revisar en la reunión (ej. "Revisar [[ORQ-123]]"). Lista simple, NO checklist. Cada punto puede llevar group (agrupa puntos bajo un encabezado, máx. 60 caracteres). Reemplaza la lista COMPLETA: para agregar uno, lee la actual con list_activities y manda todos, con sus id para conservarlos Y con su group -- si reenvías un punto sin group, pierde su grupo. Cada punto puede llevar además resolution (qué se decidió, máx. 2000 caracteres) y resolutionStatus ("pendiente" | "decidido" | "pospuesto"): son informativos, NO bloquean el cierre de la actividad. Si reenvías un punto con su id sin esos campos, el server conserva los guardados; manda "" para borrarlos. list_activities los devuelve en cada punto.'),
     outcome: z.string().optional().describe('Resultado / minuta corta -- qué se acordó. Llénalo al marcarla hecha.'),
     nextStep: z.string().optional().describe('Siguiente paso acordado. Si es trabajo real, además crea la tarea con create_task y liga su id en nextStepTaskId.'),
     nextStepTaskId: z.string().optional().describe('id de la tarea creada desde nextStep.'),
@@ -1041,7 +1045,7 @@ export function createServer() {
   registerRead(
     'list_activities',
     '/v1/activities',
-    'Lista las actividades (reuniones, llamadas, seguimientos) de un proyecto de Orquestra. status "scheduled" = agenda (próximas primero), "done" = bitácora (más recientes primero); sin status trae todas. from/to acotan por día.',
+    'Lista las actividades (reuniones, llamadas, seguimientos) de un proyecto de Orquestra. status "scheduled" = agenda (próximas primero), "done" = bitácora (más recientes primero); sin status trae todas. from/to acotan por día. Cada punto de agendaItems puede traer resolution y resolutionStatus (pendiente/decidido/pospuesto).',
     {
       status: z.enum(ACTIVITY_STATUSES).optional(),
       type: z.enum(ACTIVITY_TYPES).optional(),