orquestra-mcp 1.6.4 → 1.7.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.6.4",
-  "description": "Servidor MCP de Orquestra -- 38 tools para leer y escribir tareas, ideas, changelog, infraestructura, QA y más desde un agente de IA",
+  "version": "1.7.0",
+  "description": "Servidor MCP de Orquestra -- 51 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"

package/src/server.mjs

@@ -14,10 +14,11 @@ function textResult(data) {
 
 const PROJECT_ID_DESC = 'ID del proyecto dentro del workspace configurado. Si hay un proyecto default configurado (via "setup" o ORQUESTRA_DEFAULT_PROJECT_ID), este argumento se ignora -- el server queda fijo a ese proyecto y no puede leer/escribir otro.'
 
-const TASK_TYPES = ['feature', 'bug', 'improvement', 'tech', 'docs', 'idea', 'meeting', 'call', 'followup', 'business']
+const TASK_TYPES = ['feature', 'bug', 'improvement', 'tech', 'docs', 'idea', 'design', 'security', 'meeting', 'call', 'followup', 'business']
 const TASK_PRIORITIES = ['high', 'medium', 'low']
 const CHANGELOG_SECTIONS = ['Added', 'Changed', 'Deprecated', 'Removed', 'Fixed', 'Security']
 const DOC_TYPES = ['readme', 'usecase', 'diagram', 'env', 'adr', 'runbook', 'api']
+const ADR_STATUSES = ['propuesto', 'aceptado', 'deprecado', 'rechazado']
 const SERVICE_TYPES = ['backend', 'database', 'auth', 'storage', 'push', 'email', 'payments', 'analytics', 'realtime', 'search', 'maps', 'flags', 'admin', 'cdn', 'queue']
 const PLATFORM_TYPES = ['android', 'ios', 'web', 'desktop-mac', 'desktop-win', 'backend', 'extension', 'other']
 const INFRA_STATUSES = ['operational', 'degraded', 'down']
@@ -62,6 +63,13 @@ Durante el trabajo normal de código, sin que el usuario te lo pida explícitame
 - 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í, 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 (manda taskId si el trabajo era de una tarea puntual -- si el agente tiene la revisión con IA activada, la acota a eso en vez de "revisa todo el proyecto"), 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.
 
+Si el usuario pide "sincronizar"/"revisar que todo esté al día"/"verificar el proyecto" (o algo equivalente -- una auditoría manual, no el trabajo normal de arriba), hacé una "revisión de sincronización" completa, de cero, no un vistazo rápido:
+1. Llamá a get_sync_report -- devuelve lo objetivo (tareas sin moduleId, tareas activas sin dueDate, referencias huérfanas a un módulo/categoría/tarea/estatus que ya no existe) y activeTasksSnapshot (TODAS las tareas activas, no solo las incompletas).
+2. Para cada tarea en tasksMissingModule: buscá con list_modules si hay uno que aplique de verdad; si no, create_module antes de asignarlo -- nunca dejes una sin módulo (ver moduleId obligatorio en create_task, esto es limpiar deuda vieja de antes de esa regla).
+3. Para CADA tarea de activeTasksSnapshot (no solo las que tienen dueDate/priority en blanco -- una prioridad "medium" puesta por default nunca se distingue de una elegida a propósito): revisá el contexto real (código, conversación, changelog, dependencias vía relatedTaskId) y asigná una fecha límite realista y un nivel de urgencia real con update_task si el valor actual no refleja la urgencia/plazo real -- no inventes una fecha arbitraria sin ninguna base ("en 3 días" porque sí); si genuinamente no hay forma de estimar una fecha con la información disponible, dejala en blanco en vez de inventar una.
+4. Las referencias huérfanas (tasksWithOrphanModuleId/CategoryId/RelatedTaskId/StatusId) casi nunca se pueden arreglar solas con criterio -- no adivines a qué debería apuntar. Marcalas para el resumen final, y si es obvio por contexto a qué debió apuntar, proponéselo al usuario en vez de aplicarlo directo.
+5. Cerrá SIEMPRE con un resumen estructurado en 3 grupos, aunque algún grupo quede vacío: **No tiene sentido / necesita tu decisión** (referencias huérfanas, contradicciones que encontraste), **Se llenó** (campos que estaban vacíos y ahora tienen un valor real, con qué tarea y qué campo), **Se completó** (lo que quedó totalmente resuelto en esta pasada -- ej. una tarea que ya tenía todo en orden, o un hueco que se cerró del todo). Si tocaste tareas de verdad (no solo leíste el reporte), dejá rastro con un comment en cada una vía update_task explicando qué cambiaste y por qué -- mismo criterio que un cambio de statusId, no debería quedar invisible.
+
 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.
 
 No crees tareas ni entradas de changelog por preguntas triviales o exploración sin cambios reales -- solo por trabajo que de verdad avanza el proyecto.`
@@ -187,6 +195,14 @@ export function createServer() {
     (args, projectId) => ({ projectId })
   )
 
+  registerRead(
+    'get_sync_report',
+    '/v1/sync-report',
+    'Auditoría de integridad de un proyecto para una "revisión de sincronización" completa: tareas sin moduleId, tareas activas sin dueDate, y referencias huérfanas (moduleId/categoryId/relatedTaskId/statusId que ya no existen). También devuelve activeTasksSnapshot -- TODAS las tareas activas con su moduleId/priority/dueDate actuales, no solo las que tienen un campo en blanco, para que reevalúes fecha límite y urgencia con criterio real (ver flujo de "revisión de sincronización" en las instrucciones de este server).',
+    {},
+    (args, projectId) => ({ projectId })
+  )
+
   server.registerTool(
     'get_workspace_summary',
     {
@@ -276,7 +292,7 @@ export function createServer() {
   registerCreate(
     'create_task',
     '/v1/tasks',
-    'Crea una tarea en un proyecto de Orquestra.',
+    'Crea una tarea en un proyecto de Orquestra. moduleId es OBLIGATORIO -- revisa list_modules primero; si ninguno aplica, creá uno con create_module antes de crear la tarea (nunca la dejes sin agrupar).',
     {
       title: z.string().describe('Título de la tarea'),
       description: z.string().optional(),
@@ -284,10 +300,24 @@ export function createServer() {
       priority: z.enum(TASK_PRIORITIES).optional().describe('Default: medium'),
       statusId: z.string().optional().describe('Default: el primer estatus del proyecto'),
       categoryId: z.string().optional(),
-      moduleId: z.string().optional(),
+      moduleId: z.string().describe('OBLIGATORIO -- módulo al que pertenece esta tarea, para poder agruparla/revisarla después. Si no existe uno relacionado, llamá primero a list_modules (para no duplicar) y create_module.'),
       dueDate: z.string().optional().describe('YYYY-MM-DD'),
       assignedTo: z.string().optional().describe('uid del miembro asignado'),
       tags: z.array(z.string()).optional(),
+      relatedTaskId: z.string().optional().describe('"Bloqueada por" -- id de otra tarea. Esta tarea se muestra como bloqueada mientras esa otra no llegue a un estatus final (isFinal). Úsalo cuando el trabajo real depende de que otra tarea termine primero.'),
+      location: z.string().optional().describe('Solo relevante para type "meeting"/"call" (plataforma o lugar, ej. "Zoom", "Oficina") o "followup"/"business" (contexto libre) -- ignóralo para el resto de los tipos.'),
+      estimatedDays: z.number().optional().describe('Estimación en días de trabajo.'),
+      stack: z.array(z.string()).optional().describe('Tecnologías involucradas (mismo vocabulario que el stack de una distribución, ej. "node", "react", "postgres").'),
+      branch: z.string().optional().describe('Branch de código asociado a esta tarea.'),
+      prNumber: z.string().optional().describe('Número del Pull Request asociado (sin el "#").'),
+      prUrl: z.string().optional(),
+      prStatus: z.string().optional().describe('"open" | "merged" | "closed", o lo que corresponda -- texto libre.'),
+      commitCount: z.number().optional(),
+      lastCommitAt: z.number().optional().describe('Timestamp en ms del último commit conocido.'),
+      resolvedCommitSha: z.string().optional().describe('SHA del commit que de verdad resolvió esta tarea, si ya lo sabes (ej. lo corriste tú). No lo inventes ni lo copies de otra tarea -- si no estás seguro, mejor déjalo vacío y usa "Actualizar desde GitHub" en el detalle (busca por shortCode).'),
+      resolvedCommitMessage: z.string().optional(),
+      resolvedCommitUrl: z.string().optional(),
+      resolvedCommitAt: z.number().optional().describe('Timestamp en ms del commit resolutor.'),
     }
   )
 
@@ -308,7 +338,88 @@ export function createServer() {
       tags: z.array(z.string()).optional(),
       scope: z.array(z.object({ distId: z.string(), layer: z.string().optional(), done: z.boolean() })).optional()
         .describe('Alcance por distribución -- usa get_parity_summary para ver el scope actual antes de editarlo'),
+      relatedTaskId: z.string().optional().describe('"Bloqueada por" -- id de otra tarea, o "" para quitar el bloqueo. Ver create_task.'),
+      location: z.string().optional().describe('Solo relevante para type "meeting"/"call"/"followup"/"business". Ver create_task.'),
       comment: z.string().optional().describe('Explica qué hiciste o por qué cambia la tarea -- queda como comentario visible en ella. Obligatorio en la práctica cuando mandas statusId: sin esto, alguien ve que la tarea cambió de estatus pero no por qué.'),
+      estimatedDays: z.number().optional().describe('Estimación en días de trabajo.'),
+      stack: z.array(z.string()).optional().describe('Tecnologías involucradas -- ver create_task.'),
+      branch: z.string().optional().describe('Branch de código asociado a esta tarea -- útil setearlo apenas empiezas a trabajar, así "Actualizar desde GitHub" en el detalle puede traer PR/commits reales después.'),
+      prNumber: z.string().optional().describe('Número del Pull Request asociado (sin el "#").'),
+      prUrl: z.string().optional(),
+      prStatus: z.string().optional().describe('"open" | "merged" | "closed", o lo que corresponda -- texto libre.'),
+      commitCount: z.number().optional(),
+      lastCommitAt: z.number().optional().describe('Timestamp en ms del último commit conocido.'),
+      resolvedCommitSha: z.string().optional().describe('SHA del commit que de verdad resolvió esta tarea, si ya lo sabes (ej. lo corriste tú). No lo inventes ni lo copies de otra tarea -- si no estás seguro, mejor déjalo vacío y usa "Actualizar desde GitHub" en el detalle (busca por shortCode).'),
+      resolvedCommitMessage: z.string().optional(),
+      resolvedCommitUrl: z.string().optional(),
+      resolvedCommitAt: z.number().optional().describe('Timestamp en ms del commit resolutor.'),
+    }
+  )
+
+  // 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
+  // `${path}/${id}` con uno.
+  server.registerTool(
+    'list_checklist_items',
+    {
+      description: 'Lista los ítems del checklist de una tarea de Orquestra (texto, hecho/pendiente, responsable).',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        taskId: z.string().describe('ID de la tarea'),
+      },
+    },
+    async ({ projectId, taskId }) => {
+      try {
+        const data = await apiGet(config, `/v1/tasks/${taskId}/checklist`, { projectId: resolveProjectId(projectId) })
+        return textResult(data)
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
+  server.registerTool(
+    'add_checklist_item',
+    {
+      description: 'Agrega un ítem al checklist de una tarea de Orquestra, opcionalmente con un responsable.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        taskId: z.string().describe('ID de la tarea'),
+        text: z.string().describe('Texto del ítem'),
+        assignedTo: z.string().optional().describe('uid del miembro responsable de este ítem (opcional)'),
+      },
+    },
+    async ({ projectId, taskId, ...body }) => {
+      try {
+        const data = await apiPost(config, `/v1/tasks/${taskId}/checklist`, { projectId: resolveProjectId(projectId), ...body })
+        return textResult(data)
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
+  server.registerTool(
+    'update_checklist_item',
+    {
+      description: 'Edita un ítem del checklist de una tarea de Orquestra: texto, hecho/pendiente, o responsable.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        taskId: z.string().describe('ID de la tarea'),
+        itemId: z.string().describe('ID del ítem del checklist a editar'),
+        text: z.string().optional(),
+        done: z.boolean().optional(),
+        assignedTo: z.string().optional().describe('uid del miembro responsable, o "" para quitarlo'),
+      },
+    },
+    async ({ projectId, taskId, itemId, ...body }) => {
+      try {
+        const data = await apiPatch(config, `/v1/tasks/${taskId}/checklist`, { projectId: resolveProjectId(projectId), id: itemId, ...body })
+        return textResult(data)
+      } catch (err) {
+        return errorResult(err)
+      }
     }
   )
 
@@ -357,6 +468,9 @@ export function createServer() {
       type: z.enum(DOC_TYPES).describe('Tipo de documento'),
       title: z.string().describe('Título del documento'),
       content: z.string().optional(),
+      adrStatus: z.enum(ADR_STATUSES).optional().describe('Solo para type=\'adr\'. "aceptado" es lo único que alimenta Material (Contenido) como fuente de ángulos -- ver adrContext.'),
+      adrContext: z.string().optional().describe('Solo para type=\'adr\'. Qué problema/situación llevó a la decisión, en texto estructurado (no el markdown libre de content).'),
+      adrConsequences: z.string().optional().describe('Solo para type=\'adr\'. Qué cambia de ahora en adelante.'),
     }
   )
 
@@ -372,6 +486,10 @@ export function createServer() {
     scope: SCOPE_SCHEMA.describe('Alcance por distribución, ej: [{distId, layer, done}]'),
     tags: z.array(z.string()).optional(),
     dueDate: z.string().optional().describe('YYYY-MM-DD'),
+    shippedVersion: z.string().optional().describe('Versión del changelog en la que se envió, ej: "1.4.0"'),
+    ownerUid: z.string().optional().describe('uid del miembro responsable del avance del módulo'),
+    dependsOnModuleIds: z.array(z.string()).optional().describe('IDs de módulos de los que este depende (dependencia planeada, manual)'),
+    closureCriteria: z.string().optional().describe('Texto libre: cuándo se considera verdaderamente cerrado'),
   })
   registerUpdate('update_module', '/v1/modules', 'Edita un módulo existente (incluido su scope multiplataforma).', {
     name: z.string().optional(),
@@ -381,6 +499,10 @@ export function createServer() {
     scope: SCOPE_SCHEMA,
     tags: z.array(z.string()).optional(),
     dueDate: z.string().optional().describe('YYYY-MM-DD'),
+    shippedVersion: z.string().optional().describe('Versión del changelog en la que se envió, ej: "1.4.0"'),
+    ownerUid: z.string().optional().describe('uid del miembro responsable del avance del módulo'),
+    dependsOnModuleIds: z.array(z.string()).optional().describe('IDs de módulos de los que este depende (dependencia planeada, manual)'),
+    closureCriteria: z.string().optional().describe('Texto libre: cuándo se considera verdaderamente cerrado'),
   })
 
   registerCreate('create_status', '/v1/statuses', 'Crea un estatus (columna del flujo de tareas) en un proyecto.', {
@@ -455,14 +577,20 @@ export function createServer() {
     name: z.string().describe('Nombre del servicio'),
     status: z.enum(INFRA_STATUSES).optional().describe('Default: operational'),
     notes: z.string().optional(),
+    ownerUid: z.string().optional().describe('uid del miembro responsable del servicio'),
+    moduleId: z.string().optional().describe('a qué módulo de producto pertenece este servicio -- ver list_modules'),
+    affectedTaskIds: z.array(z.string()).optional().describe('IDs de tareas que este servicio bloquea/afecta -- ver list_tasks'),
     ...SERVICE_SPECIFIC_SCHEMA,
   })
-  registerUpdate('update_service', '/v1/services', 'Edita un servicio de infraestructura existente (status, campos específicos por tipo, incidente...).', {
+  registerUpdate('update_service', '/v1/services', 'Edita un servicio de infraestructura existente (status, campos específicos por tipo, incidente...). Un cambio de `status` queda logueado solo en el historial real de incidentes del servicio -- no hace falta nada más para eso. Los demás campos editados quedan logueados en el registro de cambios real del servicio.', {
     type: z.enum(SERVICE_TYPES).optional(),
     name: z.string().optional(),
     status: z.enum(INFRA_STATUSES).optional(),
     notes: z.string().optional(),
     lastIncident: z.string().optional(),
+    ownerUid: z.string().optional().describe('uid del miembro responsable del servicio'),
+    moduleId: z.string().optional().describe('a qué módulo de producto pertenece este servicio -- ver list_modules'),
+    affectedTaskIds: z.array(z.string()).optional().describe('IDs de tareas que este servicio bloquea/afecta -- ver list_tasks'),
     ...SERVICE_SPECIFIC_SCHEMA,
   })
 
@@ -474,8 +602,11 @@ export function createServer() {
     status: z.enum(INFRA_STATUSES).optional().describe('Default: operational'),
     notes: z.string().optional(),
     lastDeploy: z.string().optional().describe('Texto libre, ej. "hace 2 días" -- no es una fecha estructurada'),
+    lastDeployAt: z.number().optional().describe('Timestamp en ms del último deploy -- mándalo junto con lastDeployBy al confirmar un deploy real'),
+    lastDeployBy: z.string().optional().describe('uid de un miembro, o texto libre tipo "CI" para deploys automáticos'),
+    affectedTaskIds: z.array(z.string()).optional().describe('IDs de tareas que este entorno bloquea/afecta -- ver list_tasks'),
   })
-  registerUpdate('update_environment', '/v1/environments', 'Edita un entorno existente (útil para actualizar su status/version tras un deploy).', {
+  registerUpdate('update_environment', '/v1/environments', 'Edita un entorno existente (útil para actualizar su status/version tras un deploy). Un cambio de `status` queda logueado solo en el historial real de incidentes del entorno.', {
     name: z.string().optional(),
     url: z.string().optional(),
     version: z.string().optional(),
@@ -483,6 +614,9 @@ export function createServer() {
     status: z.enum(INFRA_STATUSES).optional(),
     notes: z.string().optional(),
     lastDeploy: z.string().optional(),
+    lastDeployAt: z.number().optional().describe('Timestamp en ms del último deploy'),
+    lastDeployBy: z.string().optional().describe('uid de un miembro, o texto libre tipo "CI"'),
+    affectedTaskIds: z.array(z.string()).optional().describe('IDs de tareas que este entorno bloquea/afecta -- ver list_tasks'),
   })
 
   registerCreate('create_distribution', '/v1/distributions', 'Crea una distribución/plataforma (iOS, Android, Web, etc.) en un proyecto.', {
@@ -525,6 +659,115 @@ export function createServer() {
     knowledgeSource: z.string().optional().describe('Doc libre tipo CLAUDE.md para el agente de QA de esta distribución.'),
   })
 
+  // ═══ Contenido (Fase 1 del rediseño, 11 ago 2026) ═══════════════════════════
+  // Un canal = una cuenta real (o a conectar) donde se publica. Una
+  // publicación (content) = un canal (channelId), no varios -- para
+  // publicar en N canales a la vez, crea N piezas de contenido con
+  // create_content, una por channelId.
+  const CONTENT_STATUSES = ['idea', 'draft', 'review', 'approved', 'published']
+
+  registerRead('list_channels', '/v1/channels',
+    'Lista los canales (cuentas de redes/blog/newsletter, reales o a conectar) de un proyecto. Úsala antes de create_channel para no duplicar, y antes de create_content para saber qué channelId usar.',
+    {}, (args, projectId) => ({ projectId }))
+
+  registerCreate('create_channel', '/v1/channels', 'Crea un canal (cuenta de contenido) en un proyecto -- ej. "LinkedIn", "Blog de Atlas". No conecta ninguna cuenta real todavía (eso es OAuth, fuera de alcance por ahora); solo registra el canal para poder programar contenido en él.', {
+    name: z.string().describe('Ej. "LinkedIn"'),
+    type: z.string().optional().describe('linkedin | x | blog | newsletter | instagram | other -- libre'),
+    handle: z.string().optional().describe('Ej. "@atlaspagos" o una URL/dominio'),
+    color: z.string().optional(),
+    cadenceCount: z.number().optional().describe('Ritmo objetivo de publicaciones, ej. 2'),
+    cadenceUnit: z.enum(['week', 'month']).optional(),
+  })
+
+  registerUpdate('update_channel', '/v1/channels', 'Edita un canal existente.', {
+    name: z.string().optional(),
+    type: z.string().optional(),
+    handle: z.string().optional(),
+    color: z.string().optional(),
+    cadenceCount: z.number().optional(),
+    cadenceUnit: z.enum(['week', 'month']).optional(),
+  })
+
+  // Fase 3 de Contenido (11 ago 2026) -- una campaña es una pieza de
+  // contenido con plata atrás. budget/spent/leads son casi siempre
+  // entrada manual: Orquestra no tiene ninguna integración con
+  // plataformas de anuncios para traerlos solos.
+  const CAMPAIGN_STATUSES = ['active', 'paused', 'completed']
+
+  registerRead('list_campaigns', '/v1/campaigns',
+    'Lista las campañas (pauta paga) de un proyecto. Úsala antes de create_campaign para no duplicar.',
+    {}, (args, projectId) => ({ projectId }))
+
+  registerCreate('create_campaign', '/v1/campaigns', 'Crea una campaña de pauta paga en un proyecto.', {
+    name: z.string(),
+    channelId: z.string().optional().describe('Canal donde corre la campaña -- ver list_channels'),
+    budget: z.number().optional().describe('Presupuesto asignado a esta campaña'),
+    spent: z.number().optional().describe('Gastado hasta hoy -- entrada manual, no hay integración con la plataforma de ads'),
+    leads: z.number().optional().describe('"Registros" generados -- entrada manual'),
+    status: z.enum(CAMPAIGN_STATUSES).optional().describe('Default: active. Pasa a paused sola si spent llega al tope (ver update_campaign).'),
+  })
+
+  registerUpdate('update_campaign', '/v1/campaigns', 'Edita una campaña existente -- típicamente para actualizar spent/leads a medida que se revisan en la plataforma de ads real.', {
+    name: z.string().optional(),
+    channelId: z.string().optional(),
+    budget: z.number().optional(),
+    spent: z.number().optional(),
+    leads: z.number().optional(),
+    status: z.enum(CAMPAIGN_STATUSES).optional(),
+  })
+
+  registerRead('list_content', '/v1/content',
+    'Lista las publicaciones de contenido (posts programados/publicados) de un proyecto.',
+    {}, (args, projectId) => ({ projectId }))
+
+  registerCreate('create_content', '/v1/content', 'Crea una publicación de contenido en un canal (ver list_channels/create_channel). Para publicar la misma pieza en varios canales, llama a esto una vez por cada channelId.', {
+    channelId: z.string().describe('Canal donde se publica -- ver list_channels'),
+    title: z.string().describe('Referencia interna, no es lo que se publica'),
+    format: z.string().optional().describe('Ej. "Post", "Reel", "Hilo" -- texto libre según el canal'),
+    status: z.enum(CONTENT_STATUSES).optional().describe('Default: idea'),
+    caption: z.string().optional().describe('Texto real de la publicación'),
+    hashtags: z.array(z.string()).optional(),
+    scheduledAt: z.number().optional().describe('Timestamp en ms de cuándo se programa publicar'),
+    approvalRequired: z.boolean().optional(),
+    approverUid: z.string().optional().describe('uid de quien debe aprobar antes de publicar'),
+    changelogVersion: z.string().optional().describe('Versión del changelog que esta publicación anuncia ("Atada a") -- ver list_tasks/create_changelog_entry'),
+    moduleId: z.string().optional(),
+    ideaId: z.string().optional().describe('Si esta pieza viene de una idea existente'),
+    campaignId: z.string().optional().describe('Campaña de pauta a la que pertenece -- ver list_campaigns'),
+    organicRate: z.number().optional().describe('% de interacción, medido a mano por el usuario en la plataforma real -- solo tiene sentido con status published'),
+    leads: z.number().optional().describe('"Registros" atribuidos a esta pieza orgánica -- entrada manual'),
+    reach: z.number().optional().describe('Alcance absoluto -- entrada manual, Fase 4 de Resultados'),
+    clicksToSite: z.number().optional().describe('Clics al sitio/docs -- entrada manual'),
+    saves: z.number().optional().describe('Guardados -- entrada manual, típico de X/Instagram'),
+    avgReadMinutes: z.number().optional().describe('Minutos de lectura media -- entrada manual, típico de blog'),
+    language: z.string().optional().describe('\'en\' si esta pieza es la traducción de otra. Sin valor = idioma original.'),
+    translationOf: z.string().optional().describe('Si esta pieza es una traducción, id del content original'),
+  })
+
+  registerUpdate('update_content', '/v1/content', 'Edita una publicación de contenido existente. Al pasar status a "approved" o "published" el server estampa quién/cuándo solo -- no lo mandes tú.', {
+    channelId: z.string().optional(),
+    title: z.string().optional(),
+    format: z.string().optional(),
+    status: z.enum(CONTENT_STATUSES).optional(),
+    caption: z.string().optional(),
+    hashtags: z.array(z.string()).optional(),
+    scheduledAt: z.number().optional(),
+    approvalRequired: z.boolean().optional(),
+    approverUid: z.string().optional(),
+    changelogVersion: z.string().optional(),
+    moduleId: z.string().optional(),
+    ideaId: z.string().optional(),
+    campaignId: z.string().optional(),
+    organicRate: z.number().optional(),
+    leads: z.number().optional(),
+    reach: z.number().optional(),
+    clicksToSite: z.number().optional(),
+    saves: z.number().optional(),
+    avgReadMinutes: z.number().optional(),
+    language: z.string().optional(),
+    translationOf: z.string().optional(),
+  })
+
   // ═══ 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.
@@ -544,9 +787,14 @@ export function createServer() {
     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'),
+    branch: z.string().optional().describe('Rama de este agente -- default "main" si no se manda'),
     distributionId: z.string().optional().describe('Distribución vinculada (repo/fuente de conocimiento)'),
     enabled: z.boolean().optional(),
+    createTasks: z.boolean().optional().describe('Si los fallos de este agente generan tareas automáticas -- default true'),
+    openStatusId: z.string().optional().describe('Estatus donde se abren los bugs de este agente -- default: estatus inicial del proyecto'),
+    closeStatusId: z.string().optional().describe('Estatus donde se mueven los bugs de este agente al cerrarse solos -- default: primer estatus final'),
+    testUserEmail: z.string().optional().describe('Cuenta de prueba DEDICADA (no una credencial real) que la revisión con IA puede usar para iniciar sesión y revisar pantallas autenticadas'),
+    testUserPassword: z.string().optional().describe('Password de testUserEmail'),
   })
 
   registerUpdate('update_qa_agent', '/v1/qaAgents', 'Edita un agente de QA existente.', {
@@ -557,11 +805,16 @@ export function createServer() {
     branch: z.string().optional(),
     distributionId: z.string().optional(),
     enabled: z.boolean().optional(),
+    createTasks: z.boolean().optional(),
+    openStatusId: z.string().optional(),
+    closeStatusId: z.string().optional(),
+    testUserEmail: z.string().optional().describe('Cuenta de prueba DEDICADA (no una credencial real) para que la revisión con IA inicie sesión'),
+    testUserPassword: z.string().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 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.', {
+  registerCreate('create_qa_run', '/v1/qa/runs', 'Dispara una corrida de QA (lint/tests/build/E2E según el stack) en la rama indicada. Necesita al menos un agente de QA activo 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"'),
+    branch: z.string().optional().describe('Rama a probar -- default: la del agente, 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") -- 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).'),

package/src/setup.mjs

@@ -75,9 +75,13 @@ export async function runSetup() {
   const idToken = await idTokenPromise
   console.log('Login recibido, configurando...')
 
+  const agentLabelAnswer = await prompt('¿Cómo se llama este agente/herramienta? [Claude Code]: ')
+  const agentLabel = agentLabelAnswer.trim() || 'Claude Code'
+
   const res = await fetch(`${apiBase}/v1/bootstrap`, {
     method: 'POST',
-    headers: { Authorization: `Bearer ${idToken}` },
+    headers: { Authorization: `Bearer ${idToken}`, 'Content-Type': 'application/json' },
+    body: JSON.stringify({ agentLabel }),
   })
   const body = await res.json()
   if (!res.ok) throw new Error(body?.error || `HTTP ${res.status}`)