orquestra-mcp 1.17.0 → 1.18.1

package/package.json

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

@@ -508,6 +508,7 @@ export function createServer() {
       categoryId: 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().regex(/^\d{4}-\d{2}-\d{2}$/, 'Formato esperado: YYYY-MM-DD').describe('OBLIGATORIO -- fecha estimada de término (YYYY-MM-DD), calculada con criterio real según prioridad/tamaño del trabajo (mismo criterio que la "revisión de sincronización" de get_sync_report), nunca un valor arbitrario.'),
+      reviewDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'Formato esperado: YYYY-MM-DD').optional().describe('Fecha para volver a MIRAR esta tarea -- recordatorio, NO un entregable. Úsalo para tareas de espera sin deadline real (ej. "esperar respuesta de Apple y revisar en 5 días"): en ese caso NO llenes dueDate, llena reviewDate. Distinto de dueDate (fecha de término real de un entregable) -- una tarea puede tener ambos, uno solo, o ninguno. Dispara un aviso (notificación + correo) al assignedTo el día que llega, un solo disparo.'),
       assignedTo: z.string().optional().describe('uid del miembro asignado'),
       tags: z.array(z.string()).optional(),
       scope: z.array(z.object({ distId: z.string(), layer: z.string().optional(), done: z.boolean() })).optional()
@@ -543,6 +544,7 @@ export function createServer() {
       categoryId: z.string().optional(),
       moduleId: z.string().optional(),
       dueDate: z.string().optional().describe('YYYY-MM-DD'),
+      reviewDate: z.string().optional().describe('YYYY-MM-DD. Ver create_task -- recordatorio para volver a revisar, distinto de dueDate. Mandá "" para quitarlo.'),
       assignedTo: z.string().optional(),
       tags: z.array(z.string()).optional(),
       scope: z.array(z.object({ distId: z.string(), layer: z.string().optional(), done: z.boolean() })).optional()
@@ -620,16 +622,17 @@ export function createServer() {
   server.registerTool(
     'connect_postproxy_channel',
     {
-      description: 'Inicia la conexión de un canal (facebook/instagram/tiktok/linkedin) a Postproxy. Devuelve UNA de dos formas: {url} -- OAuth hosteado por Postproxy, el usuario tiene que abrirlo y completarlo a mano (el agente no puede terminar un OAuth por su cuenta), pásale esa URL tal cual; o {needsPageSelection, profileId, pages} -- pasa con facebook y linkedin, cuando ya hay un login de esa red conectado en la cuenta (un solo login da acceso a varias Pages de Facebook, o al perfil personal y las Organization Pages de LinkedIn, no hace falta repetir el OAuth) y hace falta elegir cuál corresponde a este canal. Esa elección hoy es un flujo de la web (Cuentas conectadas) -- si te llega `needsPageSelection`, dile al usuario que complete la selección ahí, esta tool no tiene una contraparte para elegir la página. Solo para los tipos que soporta Postproxy -- un canal newsletter (Buttondown) se conecta desde la web, no con esta tool.',
+      description: 'Inicia la conexión de un canal (facebook/instagram/tiktok/linkedin) a Postproxy. Devuelve UNA de dos formas: {url} -- OAuth hosteado por Postproxy, el usuario tiene que abrirlo y completarlo a mano (el agente no puede terminar un OAuth por su cuenta), pásale esa URL tal cual; o {needsPageSelection, profileId, profileLabel, pages} -- pasa con facebook y linkedin, cuando ya hay un login de esa red conectado en la cuenta (un solo login da acceso a varias Pages de Facebook, o al perfil personal y las Organization Pages de LinkedIn, no hace falta repetir el OAuth) y hace falta elegir cuál corresponde a este canal. Esa elección hoy es un flujo de la web (Cuentas conectadas) -- si te llega `needsPageSelection`, dile al usuario que complete la selección ahí, esta tool no tiene una contraparte para elegir la página. Modelo real de Postproxy: cada perfil (login) vive en UN solo profile group y Orquestra usa un group por proyecto -- el OAuth de esta tool deja el perfil nuevo en el group de este proyecto; una cuenta de Instagram/TikTok conectada desde otro proyecto NO se puede reusar acá (sería publicar en la cuenta de otro proyecto), hay que conectar la cuenta correcta. Solo para los tipos que soporta Postproxy -- un canal newsletter (Buttondown) se conecta desde la web, no con esta tool.',
       inputSchema: {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
         channelId: z.string().describe('Canal a conectar (ver list_channels) -- su `type` tiene que ser facebook/instagram/tiktok/linkedin'),
         platform: z.string().describe('Plataforma tal cual la espera Postproxy (mismo valor que channel.type -- ej. "instagram")'),
+        forceOAuth: z.boolean().optional().describe('true = iniciar un OAuth nuevo aunque ya exista un login de esa red en la cuenta de Postproxy (conectar OTRA cuenta de Facebook/LinkedIn, o reconectar una vencida). Sin esto, para facebook/linkedin se reusa el login existente y se devuelve needsPageSelection.'),
       },
     },
-    async ({ projectId, channelId, platform }) => {
+    async ({ projectId, channelId, platform, forceOAuth }) => {
       try {
-        const data = await apiPost(config, `/v1/channels/${channelId}/connect-postproxy`, { projectId: resolveProjectId(projectId), platform })
+        const data = await apiPost(config, `/v1/channels/${channelId}/connect-postproxy`, { projectId: resolveProjectId(projectId), platform, ...(forceOAuth ? { forceOAuth: true } : {}) })
         return textResult(data)
       } catch (err) {
         return errorResult(err)
@@ -640,15 +643,16 @@ 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.',
+      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.',
       inputSchema: {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
         contentId: z.string().describe('Pieza de Contenido a publicar (ver list_content)'),
+        channelId: z.string().optional().describe('Publica solo la variante de ese canal. Sin channelId se publican todas las variantes aprobadas de la pieza, cada una en su propio post.'),
       },
     },
-    async ({ projectId, contentId }) => {
+    async ({ projectId, contentId, channelId }) => {
       try {
-        const data = await apiPost(config, `/v1/content/${contentId}/publish-postproxy`, { projectId: resolveProjectId(projectId) })
+        const data = await apiPost(config, `/v1/content/${contentId}/publish-postproxy`, { projectId: resolveProjectId(projectId), ...(channelId ? { channelId } : {}) })
         return textResult(data)
       } catch (err) {
         return errorResult(err)
@@ -1136,7 +1140,7 @@ export function createServer() {
   )
 
   registerRead('list_changelog', '/v1/changelog',
-    'Lista TODAS las entradas de changelog de un proyecto, con todos sus campos (id, section, text, version, distributions, repo, taskId, createdAt, createdBy) -- a diferencia de get_dashboard_summary/get_project_context, que solo traen un resumen recortado (texto/título, sin repo ni distributions). Útil para auditar (ej. "¿qué entradas viejas no tienen repo?") antes de update_changelog_entry.',
+    'Lista TODAS las entradas de changelog de un proyecto, con todos sus campos (id, section, text, version, distributions, repo, taskId, moduleId, createdAt, createdBy) -- a diferencia de get_dashboard_summary/get_project_context, que solo traen un resumen recortado (texto/título, sin repo ni distributions). Útil para auditar (ej. "¿qué entradas viejas no tienen repo?") antes de update_changelog_entry.',
     {}, (args, projectId) => ({ projectId }))
 
   registerCreate(
@@ -1153,12 +1157,13 @@ export function createServer() {
       })).optional().describe('Distribuciones a las que aplica esta entrada (ver list_distributions) -- vacío/omitido = aplica a todo el proyecto. Cada una puede tener su propia versión dentro de esta entrada.'),
       repo: z.string().optional().describe('"owner/name" del repo de origen del commit/PR que generó esta entrada, si se sabe -- alimenta el chip de repo en la tarjeta de versión.'),
       taskId: z.string().optional().describe('Tarea que esta entrada documenta o cierra, si se sabe (ver list_tasks) -- alimenta el chip de tarea, clicable al detalle, en la tarjeta de versión.'),
+      moduleId: z.string().optional().describe('Módulo al que pertenece esta entrada, si se sabe (ver list_modules). Agregado ORQ-178 -- también se puede llenar después vía accept_suggestion sobre una sugerencia kind="module_match" que generó la reconciliación de orquestra-infra.'),
       plannedReleaseDate: z.string().optional().describe('YYYY-MM-DD -- fecha objetivo de corte de esta versión (solo tiene sentido si la entrada queda en Unreleased). Puramente informativo, alimenta el calendario global -- no dispara release_changelog_version solo.'),
     }
   )
 
   registerUpdate('update_changelog_entry', '/v1/changelog',
-    'Edita una entrada de changelog existente (section/text/version/distributions/repo/taskId) -- primera edición puntual por id que existe (antes solo había create + el bulk-update de release_changelog_version). Pensada sobre todo para backfill/corrección (ej. completar "repo" en entradas viejas que se crearon antes de que ese campo se mandara), no para reescribir historia -- si el usuario solo quiere corregir el texto de una entrada reciente por error de tipeo, esto también sirve.',
+    'Edita una entrada de changelog existente (section/text/version/distributions/repo/taskId/moduleId) -- primera edición puntual por id que existe (antes solo había create + el bulk-update de release_changelog_version). Pensada sobre todo para backfill/corrección (ej. completar "repo" en entradas viejas que se crearon antes de que ese campo se mandara), no para reescribir historia -- si el usuario solo quiere corregir el texto de una entrada reciente por error de tipeo, esto también sirve.',
     {
       section: z.enum(CHANGELOG_SECTIONS).optional(),
       text: z.string().optional(),
@@ -1169,6 +1174,7 @@ export function createServer() {
       })).optional(),
       repo: z.string().optional().describe('"owner/name" del repo de origen.'),
       taskId: z.string().optional(),
+      moduleId: z.string().optional().describe('Ver create_changelog_entry.'),
       plannedReleaseDate: z.string().optional().describe('YYYY-MM-DD -- ver create_changelog_entry.'),
     }
   )

package/src/setup.mjs

@@ -92,15 +92,16 @@ export async function runSetup() {
   if (created) {
     defaultProjectId = body.projectId
     console.log(`Se creó un workspace y un proyecto default para ti ("${projects[0].name}") -- puedes renombrarlos cuando quieras desde orquestra-web.`)
-  } else if (projects.length === 1) {
-    defaultProjectId = projects[0].id
-    console.log(`Usando tu proyecto "${projects[0].name}" como default.`)
   } else {
     console.log('\nElige el proyecto que este MCP va a usar por default:')
     console.log('  0. (crear un proyecto nuevo)')
     projects.forEach((p, i) => console.log(`  ${i + 1}. ${p.name}`))
-    const answer = await prompt('Número: ')
-    const idx = parseInt(answer, 10)
+    const singleDefaultIdx = projects.length === 1 ? 1 : null
+    const answer = await prompt(
+      singleDefaultIdx ? `Número [Enter para usar "${projects[0].name}"]: ` : 'Número: '
+    )
+    const trimmed = answer.trim()
+    const idx = trimmed === '' && singleDefaultIdx !== null ? singleDefaultIdx : parseInt(trimmed, 10)
     if (Number.isNaN(idx) || idx < 0 || idx > projects.length) throw new Error('Selección inválida')
 
     if (idx === 0) {
@@ -117,6 +118,7 @@ export async function runSetup() {
       console.log(`Proyecto "${newProject.name}" creado y configurado como default.`)
     } else {
       defaultProjectId = projects[idx - 1].id
+      console.log(`Usando tu proyecto "${projects[idx - 1].name}" como default.`)
     }
   }