orquestra-mcp 1.20.0 → 1.23.0

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.0",
   "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 }:
@@ -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
 }