orquestra-mcp 1.16.1 → 1.16.3

package/README.md

@@ -1,6 +1,6 @@
 # orquestra-mcp
 
-Servidor MCP (Model Context Protocol) para Orquestra. Expone **38 tools**
+Servidor MCP (Model Context Protocol) para Orquestra. Expone **89 tools**
 que llaman a la API de `orquestra-infra`: lectura de contexto/dashboard/
 workspace/infra/paridad/listados, escritura de tareas/ideas/changelog/
 notas/docs/módulos/flujo/categorías/infra/proyectos, y corridas de QA —
@@ -192,11 +192,13 @@ create/update sigue siendo criterio del agente y del humano.
 
 ## Estado
 
-38 tools: 9 de lectura (contexto/tasks/search + dashboard/workspace/infra/
-paridad/setup guide/stage playbook) + 6 `list_*` + 19 de creación/edición
-(tasks/ideas/changelog/notes/docs + módulos/flujo/categorías/servicios/
-entornos/distribuciones/proyecto) + 2 de Agentes (create_agent_run/get_agent_run) +
-2 compuestas (init_project, apply_stage_playbook). No hay `delete_*`, ni
-`update_idea`/`update_note`/`update_doc`/`update_changelog_entry`
-todavía. Publicado en npm como `orquestra-mcp` (unscoped) -- `npx
-orquestra-mcp setup`.
+89 tools: lectura (contexto, dashboard, workspace, infra, paridad, standup,
+sync report, setup guide, playbooks de etapa y de plataforma, catálogo de
+skills, search) + `list_*` de cada colección + creación/edición de tareas
+(con checklist, tiempo, adjuntos, merge), ideas (con comentarios), notas,
+docs, changelog (con corte de versión), módulos, flujo, categorías,
+infraestructura, proyecto, contenido (canales, campañas, contenido,
+Postproxy), agentes, skills y sugerencias + compuestas (init_project,
+apply_stage_playbook, apply_platform_playbook, install_skill). Sin
+`delete_*` salvo adjuntos e ítems de checklist. Publicado en npm como
+`orquestra-mcp` (unscoped) -- `npx orquestra-mcp setup`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.16.1",
+  "version": "1.16.3",
   "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/platformPlaybooks.mjs

@@ -102,7 +102,7 @@ export const PLATFORM_PLAYBOOKS = {
       {
         title:       'Preparar capturas de pantalla en los tamaños exactos que pide App Store Connect',
         description: 'Las dimensiones válidas cambian con cada generación de iPhone/iPad -- si App Store Connect rechaza una captura al subirla, el mensaje de error indica el tamaño exacto que espera para ese dispositivo; ajusta según ese mensaje real, no de memoria.',
-        type: 'business', priority: 'medium', tags: ['publicacion', 'ios'], offsetDays: 7,
+        type: 'business', priority: 'medium', tags: ['publicacion', 'ios'], offsetDays: 7, checklistTool: 'screenshots',
       },
       {
         title:       'Completar el cuestionario de privacidad de la tienda (Data Collection)',
@@ -251,7 +251,7 @@ export const PLATFORM_PLAYBOOKS = {
       {
         title:       'Preparar capturas de pantalla en los tamaños exactos que pide Play Console',
         description: 'Mínimo 2 capturas de teléfono, más el gráfico destacado (1024x500) y el ícono (512x512) -- Play Console valida las dimensiones al subir, ajusta según lo que rechace.',
-        type: 'business', priority: 'medium', tags: ['publicacion', 'android'], offsetDays: 7,
+        type: 'business', priority: 'medium', tags: ['publicacion', 'android'], offsetDays: 7, checklistTool: 'screenshots',
       },
       {
         title:       'Completar el formulario de seguridad de los datos (Data safety)',

package/src/server.mjs

@@ -10,6 +10,10 @@ import { PLATFORM_PLAYBOOKS } from './platformPlaybooks.mjs'
 import { SKILLS_CATALOG } from './skillsCatalog.mjs'
 import { parseSource, previewSkill, installSkill } from './skillInstall.mjs'
 
+// Versión leída de package.json (3 sep 2026) -- antes estaba hardcodeada
+// acá y quedaba atrás en cada bump (decía 1.16.0 con package.json en 1.16.2).
+const PKG_VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version
+
 function errorResult(err) {
   const text = err instanceof ApiError ? `Error (${err.status}): ${err.message}` : `Error: ${err.message}`
   return { content: [{ type: 'text', text }], isError: true }
@@ -115,7 +119,7 @@ Si el usuario pregunta explícito qué Claude Skills de terceros le faltan (o pi
 
 export function createServer() {
   const config = loadConfig()
-  const server = new McpServer({ name: 'orquestra-mcp', version: '1.16.0' }, { instructions: SERVER_INSTRUCTIONS })
+  const server = new McpServer({ name: 'orquestra-mcp', version: PKG_VERSION }, { instructions: SERVER_INSTRUCTIONS })
 
   function resolveProjectId(projectId) {
     if (config.defaultProjectId) return config.defaultProjectId
@@ -613,10 +617,10 @@ export function createServer() {
   server.registerTool(
     'connect_postproxy_channel',
     {
-      description: 'Inicia la conexión de un canal (facebook/instagram/tiktok) 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} -- solo pasa con facebook, cuando ya hay un login de Facebook conectado en la cuenta (una sola cuenta da acceso a varias Pages, no hace falta repetir el OAuth) y hace falta elegir cuál Page 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. No confundir con connect_channel_to_buttondown -- esto es solo para los tipos que soporta Postproxy.',
+      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.',
       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'),
+        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")'),
       },
     },
@@ -1518,7 +1522,7 @@ export function createServer() {
 
   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'),
+    type: z.string().optional().describe('facebook | instagram | tiktok | linkedin | x | blog | newsletter | other -- libre. facebook/instagram/tiktok/linkedin se conectan después con connect_postproxy_channel'),
     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'),
@@ -1632,24 +1636,26 @@ export function createServer() {
   // Un agente tiene un `kind` atado a una máquina (runnerId); los 3 kinds de
   // hoy (23 ago 2026: qa/security/performance) exigen stack+localPath (un
   // checkout real en esa máquina), y performance además perfUrl (URL viva
-  // contra la que corre Lighthouse). Los 3 solo tienen lógica real para
-  // stack="web" por ahora. "orquestra-qa-agent setup" crea/actualiza solo
-  // agentes kind="qa" -- security/performance se crean a mano acá o desde
-  // la web.
-  const AGENT_KINDS = ['qa', 'security', 'performance']
+  // contra la que corre Lighthouse). qa/security/performance solo tienen
+  // lógica real para stack="web" por ahora; screenshots es lo inverso, solo
+  // stack="ios"|"android" (captura automática para el checklist de
+  // publicación, ver ScreenshotChecklist.jsx en orquestra-web). "orquestra-qa-agent
+  // setup" crea/actualiza solo agentes kind="qa" -- el resto se crean a
+  // mano acá o desde la web.
+  const AGENT_KINDS = ['qa', 'security', 'performance', 'screenshots']
   const AGENT_STACKS = ['web', 'ios', 'android', 'node', 'nestjs']
 
   registerRead('list_agents', '/v1/agents',
     'Lista los agentes (kind+máquina+stack+ruta local) configurados en un proyecto. Úsala antes de create_agent o de create_agent_run con stack, para saber si ya existe uno.',
-    { kind: z.enum(AGENT_KINDS).optional().describe('Filtra por kind: "qa" (lint/test/build/E2E), "security" (npm audit + gitleaks) o "performance" (build size + Lighthouse)') },
+    { kind: z.enum(AGENT_KINDS).optional().describe('Filtra por kind: "qa" (lint/test/build/E2E), "security" (npm audit + gitleaks), "performance" (build size + Lighthouse) o "screenshots" (captura de pantallas para el checklist de publicación, solo ios/android)') },
     (args, projectId) => ({ projectId }))
 
-  registerCreate('create_agent', '/v1/agents', 'Crea un agente: asocia un kind ("qa" | "security" | "performance") a una máquina (runner, ver Workspace → Máquinas), un stack de este proyecto y una ruta de checkout en ESA máquina. kind="performance" además necesita perfUrl.', {
+  registerCreate('create_agent', '/v1/agents', 'Crea un agente: asocia un kind ("qa" | "security" | "performance" | "screenshots") a una máquina (runner, ver Workspace → Máquinas), un stack de este proyecto y una ruta de checkout en ESA máquina. kind="performance" además necesita perfUrl.', {
     name: z.string().describe('Nombre a mostrar, ej. "Agente web"'),
-    kind: z.enum(AGENT_KINDS).default('qa').describe('"qa" (lint/test/build/E2E), "security" (npm audit + gitleaks) o "performance" (build size + Lighthouse) -- default "qa"'),
+    kind: z.enum(AGENT_KINDS).default('qa').describe('"qa" (lint/test/build/E2E), "security" (npm audit + gitleaks), "performance" (build size + Lighthouse) o "screenshots" (captura de pantallas para tiendas, solo stack ios/android) -- default "qa"'),
     runnerId: z.string().describe('ID de la máquina emparejada -- ver list_agents o Workspace → Máquinas'),
-    stack: z.enum(AGENT_STACKS).optional().describe('Requerido para los 3 kinds -- security/performance solo tienen lógica real para "web" hoy'),
-    localPath: z.string().optional().describe('Requerido para los 3 kinds -- ruta absoluta del checkout en esa máquina'),
+    stack: z.enum(AGENT_STACKS).optional().describe('Requerido para los 4 kinds. security/performance solo tienen lógica real para "web" hoy; screenshots solo para "ios"/"android"'),
+    localPath: z.string().optional().describe('Requerido para los 4 kinds -- ruta absoluta del checkout en esa máquina'),
     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(),
@@ -1684,7 +1690,7 @@ export function createServer() {
     minPerfScore: z.number().optional(),
   })
 
-  registerCreate('create_agent_run', '/v1/agent-runs', 'Dispara una corrida de agente (qa: lint/tests/build/E2E; security: npm audit + gitleaks; performance: build size + Lighthouse) en la rama indicada. Necesita al menos un agente activo para el stack (o falla explícito -- ver list_agents/create_agent). La corrida queda "queued" -- nunca asumas que pasó, confirma con get_agent_run.', {
+  registerCreate('create_agent_run', '/v1/agent-runs', 'Dispara una corrida de agente (qa: lint/tests/build/E2E; security: npm audit + gitleaks; performance: build size + Lighthouse; screenshots: captura de pantallas para el checklist de publicación) en la rama indicada. Necesita al menos un agente activo para el stack (o falla explícito -- ver list_agents/create_agent). La corrida queda "queued" -- nunca asumas que pasó, confirma con get_agent_run.', {
     agentId: z.string().optional().describe('Agente específico -- si se manda, gana sobre stack/kind'),
     branch: z.string().optional().describe('Rama a probar -- default: la del agente, o "main"'),
     commit: z.string().optional(),
@@ -1692,7 +1698,7 @@ export function createServer() {
     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_agent) o más de 1 (usa agentId o suma kind para desambiguar).'),
     kind: z.enum(AGENT_KINDS).optional().describe('Desambigua junto con stack cuando el proyecto tiene más de un agente para el mismo stack (ej. un "qa" y un "security", ambos "web") -- sin esto, resuelve por stack solo y falla explícito si hay más de uno.'),
     runnerId: z.string().optional().describe('Máquina específica -- si se manda, gana sobre la del agente resuelto'),
-    taskId: z.string().optional().describe('Acota la revisión con IA (si el agente la tiene activada) a esta tarea en vez de "revisa todo el proyecto" -- útil para pedir "corre QA de esto que acabo de hacer". Sin efecto en los pasos de script (lint/test/build corren igual siempre). No combinar con moduleId.'),
+    taskId: z.string().optional().describe('Acota la revisión con IA (si el agente la tiene activada) a esta tarea en vez de "revisa todo el proyecto" -- útil para pedir "corre QA de esto que acabo de hacer". Sin efecto en los pasos de script (lint/test/build corren igual siempre). Para kind="screenshots" es además OBLIGATORIO en la práctica: es la tarea a la que se van a adjuntar solas las capturas al terminar la corrida -- sin taskId, las capturas se suben pero nadie las liga a nada. No combinar con moduleId.'),
     moduleId: z.string().optional().describe('Igual que taskId pero acota a un módulo completo. No combinar con taskId.'),
   })