orquestra-mcp 1.20.0 → 1.23.1

package/README.md

@@ -1,6 +1,6 @@
 # orquestra-mcp
 
-Servidor MCP (Model Context Protocol) para Orquestra. Expone **90 tools**
+Servidor MCP (Model Context Protocol) para Orquestra. Expone **99 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,7 +192,7 @@ create/update sigue siendo criterio del agente y del humano.
 
 ## Estado
 
-90 tools: lectura (contexto, dashboard, workspace, infra, paridad, standup,
+99 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,

package/package.json

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

@@ -1,6 +1,15 @@
 // Puerto exacto de orquestra-web/src/lib/platformPlaybooks.js (PLATFORM_PLAYBOOKS) --
 // constantes estaticas, sin acceso a red ni a la base de datos. get_platform_playbook
 // lo lee directo desde aca (mismo criterio que stages.mjs/foundations.mjs).
+// Puerto de TRACKING_TOOLS de la web: herramientas de medición conectables a una
+// distribución web. El ID vive en distributions.publishForm[key]. `pattern` valida
+// el formato (se serializa como string en la web, acá es el RegExp directo).
+export const TRACKING_TOOLS = [
+  { key: 'ga4_measurement_id', label: 'Google Analytics 4', idLabel: 'ID de medición', pattern: /^G-[A-Z0-9]{6,12}$/, example: 'G-ABC123DEF4', where: 'Google Analytics → Admin → Flujos de datos' },
+  { key: 'meta_pixel_id',      label: 'Meta Pixel',         idLabel: 'ID del Pixel',    pattern: /^\d{8,20}$/,          example: '1234567890123456', where: 'Meta Business → Events Manager' },
+  { key: 'gtm_container_id',   label: 'Google Tag Manager', idLabel: 'ID del contenedor', pattern: /^GTM-[A-Z0-9]{4,10}$/, example: 'GTM-ABC1234', where: 'Tag Manager → Administrador → ID del contenedor' },
+]
+
 export const PLATFORM_PLAYBOOKS = {
 
   ios: {
@@ -288,6 +297,11 @@ export const PLATFORM_PLAYBOOKS = {
         title: 'Google Analytics 4 / Firebase Analytics',
         body: 'Mide visitas, origen y conversiones. Si el sitio ya usa Firebase, activa Google Analytics en el proyecto y usa el SDK web (measurementId); si no, crea una propiedad GA4 y pega la etiqueta. Define al menos un evento de conversión (registro, clic en CTA, descarga). Si el sitio sirve a usuarios de la UE/México, acuerda el aviso de cookies y consentimiento antes de activar.',
       },
+      {
+        key: 'meta_pixel',
+        title: 'Meta Pixel (si harás anuncios)',
+        body: 'Solo si vas a pautar en Facebook/Instagram: crea el Pixel en Meta Business → Events Manager y pega su ID numérico abajo en "Conexiones de medición". Sirve para medir conversiones de los anuncios y armar audiencias de remarketing. Requiere consentimiento de cookies en la UE/México y debe mencionarse en la política de privacidad.',
+      },
       {
         key: 'bing_webmaster',
         title: 'Bing Webmaster Tools (opcional)',
@@ -339,7 +353,12 @@ export const PLATFORM_PLAYBOOKS = {
       {
         title:       'Instalar analítica (Google Analytics 4 / Firebase Analytics) y definir una conversión',
         description: 'Activar GA4 (o Google Analytics en el proyecto Firebase y usar el SDK web con measurementId), confirmar en Tiempo real que registra visitas propias y marcar al menos un evento como conversión (registro, CTA, descarga).',
-        type: 'tech', priority: 'high', tags: ['seo', 'web', 'analytics'], offsetDays: 2,
+        type: 'tech', priority: 'high', tags: ['seo', 'web', 'analytics'], offsetDays: 2, checkKey: 'analytics',
+      },
+      {
+        title:       'Instalar Meta Pixel y verificar el evento PageView',
+        description: 'Solo si habrá anuncios en Facebook/Instagram: crear el Pixel en Events Manager, instalarlo en el sitio y confirmar PageView con la extensión Meta Pixel Helper o la pestaña Probar eventos.',
+        type: 'tech', priority: 'low', tags: ['seo', 'web', 'analytics', 'meta'], offsetDays: 4, checkKey: 'meta_pixel',
       },
       {
         title:       'Verificar que sitemap.xml y robots.txt respondan 200 y no bloqueen el sitio',

package/src/server.mjs

@@ -6,7 +6,7 @@ import { z } from 'zod'
 import { loadConfig, apiGet, apiPost, apiPatch, apiDelete, putToPresignedUrl, ApiError } from './api.mjs'
 import { STAGES, PLAYBOOKS } from './stages.mjs'
 import { FOUNDATIONS } from './foundations.mjs'
-import { PLATFORM_PLAYBOOKS } from './platformPlaybooks.mjs'
+import { PLATFORM_PLAYBOOKS, TRACKING_TOOLS } from './platformPlaybooks.mjs'
 import { SKILLS_CATALOG } from './skillsCatalog.mjs'
 import { parseSource, previewSkill, installSkill } from './skillInstall.mjs'
 
@@ -89,6 +89,8 @@ Al aplicar un playbook con apply_stage_playbook -- sobre todo el de etapa "post"
 
 Al aplicar apply_platform_playbook (Platform Playbook de publicación iOS/Android) con publishForm: solo completa las claves para las que tengas base real del proyecto (código, get_project_context, servicios/entornos ya configurados) -- mismo criterio que el botón "Completar con IA" de la web: category/content_rights/data_collection/content_rating suelen inferirse bien para una app B2B sin ads/tracking, pero pricing, availability, package/bundle ID, cuentas demo para el reviewer o el nombre exacto de la app NUNCA se inventan -- dejalas fuera de publishForm para que el usuario las complete a mano. Si la tool devuelve publishFormConflict, la distribución ya tenía datos guardados en esas claves y no se escribió nada -- mostrale al usuario el valor actual vs. el propuesto de cada una, y repetí el llamado con confirmReplace:true solo si confirma explícito el reemplazo (no lo asumas ni lo repitas sin esa confirmación).
 
+Analítica y anuncios en un sitio web: antes de instalar o tocar Google Analytics 4, Meta Pixel o Tag Manager en el código, llama a get_tracking_ids -- si la distribución web ya tiene el ID guardado (ga4_measurement_id, meta_pixel_id, gtm_container_id), úsalo tal cual; nunca inventes un ID ni se lo vuelvas a pedir al usuario. Si falta y el usuario te lo da (o lo lees literal en el código/consola real), guárdalo con set_tracking_ids para que el resto de agentes y la guía web lo vean. Si ya hay uno distinto guardado, no lo reemplaces sin confirmación explícita (confirmReplace).
+
 Durante el trabajo normal de código, sin que el usuario te lo pida explícitamente y SIN ESPERAR a que lo mencione (si tienes esta tool disponible en la sesión, se usa por default en todo trabajo real, no solo cuando alguien dice "usa Orquestra"):
 - Si te pide una funcionalidad o arreglo real (no una pregunta rápida ni exploración de código sin cambios), revisa con list_tasks/search si ya existe una tarea relacionada; si no, créala con create_task ANTES de empezar a trabajar, en el estatus inicial del proyecto (ver list_statuses). Si no hay un proyecto default configurado para esta carpeta, no te rindas ahí -- usa get_workspace_summary para encontrar el proyecto correcto y pásalo explícito como projectId en cada llamada.
 - Mientras trabajas, mueve la tarea por los estatus reales según avanzas (no la dejes en el inicial hasta el final). Al terminar, muévela a su estatus final con update_task y registra una entrada de changelog con create_changelog_entry -- así el usuario nunca tiene que documentar esto a mano. Si sabes en qué repo real estás trabajando (podés correr "git remote get-url origin" o ya lo sabes por la carpeta), pásalo SIEMPRE como "repo" ("owner/name") -- encontrado real (17 ago 2026): ni el hook local ni el GitHub Action ni la reconciliación de orquestra-infra lo estaban mandando pese a que el campo existe hace rato, así que ninguna entrada automática sabía de qué repo/plataforma venía. Si además la distribución de ese repo ya está identificada (ver list_distributions), pásala en "distributions" -- sin esto el changelog no puede filtrar/agrupar por plataforma.
@@ -613,6 +615,126 @@ export function createServer() {
     }
   )
 
+  // Revisión de Contenido (ORQ-184, 2 oct 2026). Aprobar NO tiene tool propia:
+  // es update_content con status "approved" (el server estampa quién/cuándo).
+  // GitHub (ORQ-200, 3 oct 2026): las rutas aceptan token de servicio del proyecto.
+  // Crear/borrar integraciones NO se expone a propósito: maneja el PAT y exige
+  // sesión de miembro (web).
+  registerRead(
+    'list_github_integrations',
+    '/v1/github-integrations',
+    'Lista los repos de GitHub conectados a un proyecto (repo, rama, distribución vinculada, último error/chequeo). Úsala para saber qué repos alimentan el changelog antes de pedir actividad o un sync.',
+    {},
+    (args, projectId) => ({ projectId })
+  )
+
+  registerRead(
+    'get_github_activity',
+    '/v1/github-activity',
+    'Actividad reciente de GitHub por repo conectado del proyecto (commits, PRs). Sirve para saber qué se hizo realmente sin leer el repo a mano.',
+    { days: z.number().int().min(1).max(90).optional().describe('Ventana en días hacia atrás (default del servidor)') },
+    (args, projectId) => ({ projectId, days: args.days })
+  )
+
+  server.registerTool(
+    'sync_task_from_github',
+    {
+      description: 'Actualiza UNA tarea desde GitHub: busca commits/PRs que la mencionan (ORQ-###) y refleja su estado real. Si el proyecto tiene varios repos conectados, pasa integrationId (list_github_integrations).',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        taskId: z.string().describe('ID de la tarea'),
+        integrationId: z.string().optional().describe('Integración (repo) concreta; opcional si solo hay una'),
+      },
+    },
+    async ({ projectId, taskId, integrationId }) => {
+      try {
+        return textResult(await apiPost(config, `/v1/tasks/${taskId}/sync-github`, { projectId: resolveProjectId(projectId), ...(integrationId ? { integrationId } : {}) }))
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
+  server.registerTool(
+    'run_closure_scan',
+    {
+      description: 'Escanea la actividad reciente de GitHub y PROPONE cerrar tareas cuyo trabajo ya aparece hecho (sugerencias closure_proposal, nunca cierra nada sola). Revisa las propuestas con list_suggestions y acepta con accept_suggestion.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        days: z.number().int().min(1).max(90).optional().describe('Ventana en días hacia atrás (default del servidor)'),
+      },
+    },
+    async ({ projectId, days }) => {
+      try {
+        return textResult(await apiPost(config, '/v1/closure-scan', { projectId: resolveProjectId(projectId), ...(days ? { days } : {}) }))
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
+  server.registerTool(
+    'request_content_changes',
+    {
+      description: 'Pide cambios en una pieza de contenido que está en revisión: guarda tu comentario en el historial (reviewComments), la devuelve a borrador y avisa (push + correo) a quien la creó. No existe un estado "rechazado". En una pieza multi-canal (channels[]) channelId es obligatorio. Para aprobar usa update_content con status "approved".',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        contentId: z.string().describe('ID de la pieza (list_content)'),
+        text: z.string().describe('Qué hay que cambiar -- queda guardado como comentario de revisión'),
+        channelId: z.string().optional().describe('Solo si la pieza es multi-canal: el canal (variante) al que se refieren los cambios'),
+      },
+    },
+    async ({ projectId, contentId, text, channelId }) => {
+      try {
+        const data = await apiPost(config, `/v1/content/${contentId}/request-changes`, { projectId: resolveProjectId(projectId), text, ...(channelId ? { channelId } : {}) })
+        return textResult(data)
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
+  server.registerTool(
+    'ai_review_content',
+    {
+      description: 'Pre-revisión visual con IA de la imagen de una pieza contra el Brand Kit (colores, texto legible, voz de marca): deja un semáforo green/yellow/red con observaciones en aiPreReview. Es informativa, nunca aprueba ni rechaza sola. Cuesta 1 crédito de IA. Se corre sola antes del aviso al aprobador.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        contentId: z.string().describe('ID de la pieza (list_content)'),
+        channelId: z.string().optional().describe('Solo si la pieza es multi-canal'),
+      },
+    },
+    async ({ projectId, contentId, channelId }) => {
+      try {
+        return textResult(await apiPost(config, `/v1/content/${contentId}/ai-review`, { projectId: resolveProjectId(projectId), ...(channelId ? { channelId } : {}) }))
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
+  server.registerTool(
+    'regenerate_content_image',
+    {
+      description: 'Regenera la imagen de una pieza con IA usando su imagePrompt original MÁS tus comentarios (y los anteriores). Corre en segundo plano (la respuesta es inmediata, "regenerating"; el resultado aparece en la pieza en ~1 minuto: la imagen nueva queda en mediaFiles, la anterior en imageHistory, y la pieza vuelve a "review" avisando al aprobador). Gasta 5 créditos de IA del workspace (se reembolsan si falla) y hay un tope de 5 regeneraciones por pieza/canal. mode "reference" (default) edita la imagen actual para mantener la composición; "scratch" genera desde cero.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        contentId: z.string().describe('ID de la pieza (list_content)'),
+        text: z.string().describe('Comentarios para la nueva imagen (ej. "más luz, sin texto")'),
+        mode: z.enum(['reference', 'scratch']).optional().describe('reference (default) = editar la imagen actual; scratch = desde cero'),
+        channelId: z.string().optional().describe('Solo si la pieza es multi-canal: el canal (variante) cuya imagen se regenera'),
+      },
+    },
+    async ({ projectId, contentId, text, mode, channelId }) => {
+      try {
+        const data = await apiPost(config, `/v1/content/${contentId}/regenerate-image`, { projectId: resolveProjectId(projectId), text, ...(mode ? { mode } : {}), ...(channelId ? { channelId } : {}) })
+        return textResult(data)
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
   // Recordatorio con hora de una tarea (2 oct 2026, a pedido de José) --
   // "recuérdame en 5 horas revisar X con Ana" / "mañana revisa Y para poder
   // cerrarla". Azúcar sobre PATCH /v1/tasks { remindAt (epoch ms), remindNote }:
@@ -1030,7 +1152,7 @@ export function createServer() {
       effort: z.enum(IDEA_IMPACT_EFFORT).optional(),
       risk: z.enum(IDEA_IMPACT_EFFORT).optional().describe('Riesgo de esta idea (alto/bajo) -- agregado 12 ago 2026, alimenta la recomendación del detalle de idea junto con impact/effort.'),
       voteCount: z.number().optional().describe('Default: 1 + requestedBy.length'),
-      linkedTaskIds: z.array(z.string()).optional().describe('Tareas YA EXISTENTES relacionadas con esta idea (no creadas a partir de ella) -- ver list_tasks. Distinto de taskId (la tarea "principal"/de conversión, que solo se setea vía convert_idea_to_task): acá pueden ser varias. Reemplaza el array completo si ya tenía algo, no hace merge.'),
+      linkedTaskIds: z.array(z.string()).optional().describe('Tareas YA EXISTENTES relacionadas con esta idea (no creadas a partir de ella) -- ver list_tasks. Distinto de taskId (la tarea "principal"/de conversión, que solo se setea vía convert_idea_to_task): acá pueden ser varias. Ligar al menos una deja la idea en status "hecha" sin crear tarea (no pisa un status explícito ni resucita una descartada). Reemplaza el array completo si ya tenía algo, no hace merge.'),
     }
   )
 
@@ -1051,7 +1173,7 @@ export function createServer() {
     effort: z.enum(IDEA_IMPACT_EFFORT).optional(),
     risk: z.enum(IDEA_IMPACT_EFFORT).optional(),
     voteCount: z.number().optional(),
-    linkedTaskIds: z.array(z.string()).optional().describe('Tareas YA EXISTENTES relacionadas con esta idea (no creadas a partir de ella) -- ver list_tasks. Distinto de taskId (la tarea "principal"/de conversión, que solo se setea vía convert_idea_to_task): acá pueden ser varias. Reemplaza el array completo, no hace merge -- si querés agregar una sin perder las que ya tenía, primero mirá la idea con search/get_project_context.'),
+    linkedTaskIds: z.array(z.string()).optional().describe('Tareas YA EXISTENTES relacionadas con esta idea (no creadas a partir de ella) -- ver list_tasks. Distinto de taskId (la tarea "principal"/de conversión, que solo se setea vía convert_idea_to_task): acá pueden ser varias. Ligar al menos una deja la idea en status "hecha" sin crear tarea (no pisa un status explícito ni resucita una descartada). Reemplaza el array completo, no hace merge -- si querés agregar una sin perder las que ya tenía, primero mirá la idea con search/get_project_context.'),
   })
 
   // Convertir idea → tarea (21 ago 2026, gap encontrado: no había forma de
@@ -1990,5 +2112,96 @@ export function createServer() {
     }
   )
 
+  // ═══ IDs de medición (GA4 / Meta Pixel / GTM) de una distribución web ═══
+  // Viven en distributions.publishForm (mismo mapa que la Guía de publicación,
+  // ver TRACKING_TOOLS en platformPlaybooks.mjs). PATCH reemplaza el mapa
+  // completo, así que set_tracking_ids lee y mezcla antes de escribir.
+  server.registerTool(
+    'get_tracking_ids',
+    {
+      description: 'Lee los IDs de medición conectados a las distribuciones del proyecto: Google Analytics 4 (ID de medición G-…), Meta Pixel (ID numérico) y Google Tag Manager (GTM-…). Úsalo ANTES de instalar o editar analítica/anuncios en el código de un sitio: si hay un ID guardado, ese es el que debes usar -- nunca inventes ni pidas de nuevo uno que ya está. Devuelve por distribución los IDs presentes y cuáles faltan.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        distributionId: z.string().optional().describe('Solo esta distribución (ver list_distributions). Omitido = todas las de tipo web.'),
+      },
+    },
+    async ({ projectId, distributionId }) => {
+      try {
+        const pid = resolveProjectId(projectId)
+        const { items } = await apiGet(config, '/v1/distributions', { projectId: pid })
+        const dists = items.filter(d => distributionId ? d.id === distributionId : d.type === 'web')
+        if (distributionId && dists.length === 0) {
+          throw new Error(`No se encontró la distribución "${distributionId}" en este proyecto -- revisá list_distributions.`)
+        }
+        return textResult({
+          distributions: dists.map(d => {
+            const form = d.publishForm || {}
+            return {
+              distributionId: d.id,
+              name: d.name || d.label,
+              type: d.type,
+              domain: d.domain || null,
+              ids: Object.fromEntries(TRACKING_TOOLS.map(t => [t.key, form[t.key] || null])),
+              missing: TRACKING_TOOLS.filter(t => !form[t.key]).map(t => t.key),
+            }
+          }),
+          tools: TRACKING_TOOLS.map(t => ({ key: t.key, label: t.label, idLabel: t.idLabel, example: t.example, where: t.where })),
+        })
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
+  server.registerTool(
+    'set_tracking_ids',
+    {
+      description: 'Guarda (o quita) los IDs de medición de una distribución web: ga4_measurement_id (G-…), meta_pixel_id (solo dígitos) y gtm_container_id (GTM-…). Mezcla con lo ya guardado -- solo toca las claves que mandas; "" quita una. Valida el formato. SOLO guarda un ID que el usuario te dio o que leíste literal en el código/consola real del sitio -- nunca lo inventes. Si ya hay un valor distinto guardado y no mandas confirmReplace:true, no escribe y devuelve el conflicto: muéstraselo al usuario y repite con confirmReplace:true solo si confirma.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        distributionId: z.string().describe('Distribución web (ver list_distributions)'),
+        ga4_measurement_id: z.string().optional().describe('ID de medición de GA4, ej. G-ABC123DEF4. "" lo quita.'),
+        meta_pixel_id: z.string().optional().describe('ID numérico del Meta Pixel. "" lo quita.'),
+        gtm_container_id: z.string().optional().describe('ID del contenedor de Tag Manager, ej. GTM-ABC1234. "" lo quita.'),
+        confirmReplace: z.boolean().optional().describe('Default false. true solo si el usuario ya confirmó reemplazar un valor existente que te devolvió el conflicto.'),
+      },
+    },
+    async ({ projectId, distributionId, confirmReplace, ...ids }) => {
+      try {
+        const pid = resolveProjectId(projectId)
+        const { items } = await apiGet(config, '/v1/distributions', { projectId: pid })
+        const dist = items.find(d => d.id === distributionId)
+        if (!dist) throw new Error(`No se encontró la distribución "${distributionId}" en este proyecto -- revisá list_distributions.`)
+
+        const existing = dist.publishForm || {}
+        const patch = {}
+        const invalid = []
+        for (const t of TRACKING_TOOLS) {
+          if (ids[t.key] === undefined) continue
+          const raw = String(ids[t.key]).trim()
+          const v = t.key === 'meta_pixel_id' ? raw : raw.toUpperCase()
+          if (v && !t.pattern.test(v)) invalid.push({ key: t.key, value: raw, expected: t.example })
+          else patch[t.key] = v
+        }
+        if (invalid.length) throw new Error(`Formato inválido: ${invalid.map(i => `${i.key} "${i.value}" (ej. ${i.expected})`).join(', ')}`)
+        if (Object.keys(patch).length === 0) throw new Error('No mandaste ningún ID para guardar.')
+
+        const conflicts = Object.entries(patch)
+          .filter(([k, v]) => existing[k] && existing[k] !== v)
+          .map(([key, proposed]) => ({ key, current: existing[key], proposed: proposed || '(quitar)' }))
+        if (conflicts.length > 0 && !confirmReplace) {
+          return textResult({ updated: false, conflicts, message: 'Ya hay valores guardados distintos. No se escribió nada -- muéstraselos al usuario y repite con confirmReplace:true solo si confirma el reemplazo.' })
+        }
+
+        const merged = { ...existing }
+        for (const [k, v] of Object.entries(patch)) { if (v) merged[k] = v; else delete merged[k] }
+        await apiPatch(config, '/v1/distributions', { projectId: pid, id: distributionId, publishForm: merged })
+        return textResult({ updated: true, distributionId, written: patch })
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
   return server
 }