orquestra-mcp 1.44.0 → 1.46.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.44.0",
+  "version": "1.46.0",
   "description": "Servidor MCP de Orquestra -- 135 tools para leer y escribir tareas, ideas, changelog, infraestructura, contenido, QA y más desde un agente de IA",
   "type": "module",
   "bin": {
@@ -15,7 +15,7 @@
   "engines": {
     "node": ">=18"
   },
-  "homepage": "https://orquestra.me/mcp",
+  "homepage": "https://www.orquestra.me/mcp",
   "keywords": [
     "mcp",
     "model-context-protocol",

package/src/platformPlaybooks.mjs

@@ -526,7 +526,7 @@ export const PLATFORM_PLAYBOOKS = {
       {
         title:       'Medir y corregir Core Web Vitals en PageSpeed Insights (móvil)',
         description: 'Correr PageSpeed Insights sobre la home y las páginas clave. Objetivo: LCP < 2.5s, CLS < 0.1, INP < 200ms. Atacar primero imágenes sin comprimir, fuentes bloqueantes y JS sin dividir.',
-        type: 'tech', priority: 'medium', tags: ['seo', 'web', 'performance'], offsetDays: 5,
+        type: 'tech', priority: 'medium', tags: ['seo', 'web', 'performance'], offsetDays: 5, checkKey: 'core_web_vitals',
       },
       {
         title:       'Fijar dominio canónico y redirecciones 301 (www / http → https)',

package/src/server.mjs

@@ -337,6 +337,26 @@ export function createServer() {
     {}
   )
 
+  // PageSpeed Insights por distribución web (ORQ-377). La última medición
+  // también viene en list_distributions (campo `pagespeed` de cada una).
+  registerRead(
+    'get_pagespeed',
+    '/v1/pagespeed',
+    'Historial de mediciones de PageSpeed Insights (móvil) de una distribución web, más reciente primero: scores de Performance/Accesibilidad/Buenas prácticas/SEO, métricas de laboratorio (LCP, CLS, TBT), Core Web Vitals de usuarios reales (CrUX: LCP, INP, CLS con categoría FAST/AVERAGE/SLOW; null si el sitio no tiene tráfico suficiente), oportunidades con ahorro estimado y auditorías que fallan. Se mide solo cada lunes; para una medición nueva usa measure_pagespeed.',
+    {
+      distributionId: z.string().describe('Distribución type="web" con domain configurado (ver list_distributions)'),
+      limit: z.number().int().min(1).max(100).optional().describe('Cuántas mediciones traer (default 20)'),
+    },
+    (args, projectId) => ({ projectId, distributionId: args.distributionId, limit: args.limit })
+  )
+
+  registerCreate(
+    'measure_pagespeed',
+    '/v1/pagespeed',
+    'Pide una medición nueva de PageSpeed Insights (móvil) para una distribución web con dominio. Corre en segundo plano (10-40 s): responde de inmediato con status "running"; el resultado aparece después en el campo `pagespeed` de la distribución (list_distributions) y en get_pagespeed. 409 si ya hay una en curso.',
+    { distributionId: z.string().describe('Distribución type="web" con domain configurado') }
+  )
+
   registerRead(
     'get_infra_status',
     '/v1/infra',
@@ -2637,12 +2657,12 @@ export function createServer() {
 
   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), "performance" (build size + Lighthouse) o "screenshots" (captura de pantallas para el checklist de publicación, solo ios/android)') },
+    { kind: z.enum(AGENT_KINDS).optional().describe('Filtra por kind: "qa" (lint/test/build/E2E), "security" (npm audit + gitleaks), "performance" (build size + Lighthouse: performance/accesibilidad/buenas prácticas/SEO + LCP/CLS/TBT) o "screenshots" (captura de pantallas para el checklist de publicación, solo ios/android)') },
     (args, projectId) => ({ projectId, ...(args.kind ? { kind: args.kind } : {}) }))
 
   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), "performance" (build size + Lighthouse) o "screenshots" (captura de pantallas para tiendas, solo stack ios/android) -- default "qa"'),
+    kind: z.enum(AGENT_KINDS).default('qa').describe('"qa" (lint/test/build/E2E), "security" (npm audit + gitleaks), "performance" (build size + Lighthouse: performance/accesibilidad/buenas prácticas/SEO + LCP/CLS/TBT) 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 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'),
@@ -2657,7 +2677,14 @@ export function createServer() {
     plannedRunAt: z.string().optional().describe('YYYY-MM-DD -- recordatorio manual de "próxima corrida planeada". Ningún kind tiene scheduling real (todo trigger es manual/push): esto NO dispara ninguna corrida sola, solo alimenta el calendario global.'),
     perfUrl: z.string().optional().describe('Requerido si kind="performance" -- URL viva (ej. staging/prod) contra la que corre Lighthouse'),
     maxBundleSizeKb: z.number().optional().describe('Específico de kind="performance" -- umbral en KB para el paso de tamaño de build (default 5000)'),
-    minPerfScore: z.number().optional().describe('Específico de kind="performance" -- score mínimo de Lighthouse (0-100) para pasar (default 50)'),
+    minPerfScore: z.number().optional().describe('Específico de kind="performance" -- score mínimo de Lighthouse en Performance (0-100) para pasar (default 50)'),
+    perfUrls: z.array(z.string()).optional().describe('Específico de kind="performance" -- URLs ADICIONALES a perfUrl (ej. /precios, /blog): Lighthouse corre un paso por cada una'),
+    minAccessibilityScore: z.number().optional().describe('Específico de kind="performance" -- score mínimo de Accesibilidad (0-100, default 90)'),
+    minBestPracticesScore: z.number().optional().describe('Específico de kind="performance" -- score mínimo de Buenas prácticas (0-100, default 90)'),
+    minSeoScore: z.number().optional().describe('Específico de kind="performance" -- score mínimo de SEO (0-100, default 90)'),
+    maxLcpMs: z.number().optional().describe('Específico de kind="performance" -- LCP máximo en ms (default 2500, umbral "bueno" de Google)'),
+    maxCls: z.number().optional().describe('Específico de kind="performance" -- CLS máximo (default 0.1)'),
+    maxTbtMs: z.number().optional().describe('Específico de kind="performance" -- TBT máximo en ms (default 200, proxy de laboratorio de INP)'),
   })
 
   registerUpdate('update_agent', '/v1/agents', 'Edita un agente existente.', {
@@ -2678,6 +2705,13 @@ export function createServer() {
     perfUrl: z.string().optional().describe('Ver create_agent -- específico de kind="performance"'),
     maxBundleSizeKb: z.number().optional(),
     minPerfScore: z.number().optional(),
+    perfUrls: z.array(z.string()).optional().describe('Ver create_agent -- reemplaza la lista completa, [] la vacía'),
+    minAccessibilityScore: z.number().optional(),
+    minBestPracticesScore: z.number().optional(),
+    minSeoScore: z.number().optional(),
+    maxLcpMs: z.number().optional(),
+    maxCls: z.number().optional(),
+    maxTbtMs: 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; 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.', {

package/src/setup.mjs

@@ -78,22 +78,72 @@ export async function runSetup() {
   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}`, 'Content-Type': 'application/json' },
-    body: JSON.stringify({ agentLabel }),
-  })
-  const body = await res.json()
-  if (!res.ok) throw new Error(body?.error || `HTTP ${res.status}`)
+  // askIfMissing: si no hay workspace la API no crea nada solo -- avisa
+  // (needsWorkspace) y aquí se le pide el nombre al usuario.
+  const callBootstrap = async (extra = {}) => {
+    const res = await fetch(`${apiBase}/v1/bootstrap`, {
+      method: 'POST',
+      headers: { Authorization: `Bearer ${idToken}`, 'Content-Type': 'application/json' },
+      body: JSON.stringify({ agentLabel, askIfMissing: true, ...extra }),
+    })
+    const body = await res.json()
+    if (!res.ok) throw new Error(body?.error || `HTTP ${res.status}`)
+    return body
+  }
+  const askName = async (question) => {
+    for (;;) {
+      const name = (await prompt(question)).trim()
+      if (name) return name
+      console.log('El nombre no puede estar vacío.')
+    }
+  }
+
+  let body = await callBootstrap()
+  if (body.needsWorkspaceChoice) {
+    // Miembro de varios workspaces: elegir aquí no cambia el workspace
+    // actual de la web, solo a cuál queda conectada esta carpeta.
+    const { workspaces, currentWorkspaceId } = body
+    console.log('\nPerteneces a varios workspaces. ¿En cuál quieres trabajar desde esta carpeta?')
+    workspaces.forEach((w, i) => console.log(`  ${i + 1}. ${w.name}${w.id === currentWorkspaceId ? ' (el que tienes abierto en la web)' : ''}`))
+    const currentIdx = workspaces.findIndex(w => w.id === currentWorkspaceId) + 1
+    let idx
+    for (;;) {
+      const answer = (await prompt(currentIdx ? `Número [Enter para usar "${workspaces[currentIdx - 1].name}"]: ` : 'Número: ')).trim()
+      idx = answer === '' && currentIdx ? currentIdx : parseInt(answer, 10)
+      if (idx >= 1 && idx <= workspaces.length) break
+      console.log('Selección inválida.')
+    }
+    body = await callBootstrap({ workspaceId: workspaces[idx - 1].id })
+  } else if (body.needsWorkspace) {
+    console.log('\nTodavía no tienes un workspace en Orquestra. Primero vamos a crearlo')
+    console.log('(agrupa todos tus proyectos: tu empresa, tu equipo o tu nombre si trabajas solo).')
+    const workspaceName = await askName('Nombre del workspace: ')
+    body = await callBootstrap({ workspaceName })
+    console.log(`Workspace "${workspaceName}" creado.`)
+  }
 
-  const { workspaceId, token, created, projects } = body
+  const { workspaceId, token, projects } = body
+  // La API de producción anterior a ORQ-388 no manda workspaceName.
+  const wsLabel = body.workspaceName ? ` del workspace "${body.workspaceName}"` : ''
   let defaultProjectId
 
-  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.`)
+  const createProject = async (name) => {
+    const res2 = await fetch(`${apiBase}/v1/projects?workspaceId=${workspaceId}`, {
+      method: 'POST',
+      headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
+      body: JSON.stringify({ name }),
+    })
+    const newProject = await res2.json()
+    if (!res2.ok) throw new Error(newProject?.error || `HTTP ${res2.status}`)
+    console.log(`Proyecto "${newProject.name}"${wsLabel} creado y configurado como default.`)
+    return newProject.id
+  }
+
+  if (projects.length === 0) {
+    console.log(`\nAhora crea el proyecto${wsLabel} que este MCP va a usar (puedes agregar más después).`)
+    defaultProjectId = await createProject(await askName('Nombre del proyecto: '))
   } else {
-    console.log('\nElige el proyecto que este MCP va a usar por default:')
+    console.log(`\nElige el proyecto${wsLabel} 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 singleDefaultIdx = projects.length === 1 ? 1 : null
@@ -105,20 +155,10 @@ export async function runSetup() {
     if (Number.isNaN(idx) || idx < 0 || idx > projects.length) throw new Error('Selección inválida')
 
     if (idx === 0) {
-      const name = await prompt('Nombre del proyecto nuevo: ')
-      if (!name.trim()) throw new Error('El nombre no puede estar vacío')
-      const res2 = await fetch(`${apiBase}/v1/projects?workspaceId=${workspaceId}`, {
-        method: 'POST',
-        headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
-        body: JSON.stringify({ name: name.trim() }),
-      })
-      const newProject = await res2.json()
-      if (!res2.ok) throw new Error(newProject?.error || `HTTP ${res2.status}`)
-      defaultProjectId = newProject.id
-      console.log(`Proyecto "${newProject.name}" creado y configurado como default.`)
+      defaultProjectId = await createProject(await askName('Nombre del proyecto nuevo: '))
     } else {
       defaultProjectId = projects[idx - 1].id
-      console.log(`Usando tu proyecto "${projects[idx - 1].name}" como default.`)
+      console.log(`Usando tu proyecto "${projects[idx - 1].name}"${wsLabel} como default.`)
     }
   }
 
@@ -141,6 +181,6 @@ export async function runSetup() {
   console.log('  Claude Desktop -- agrega esto a tu claude_desktop_config.json:')
   console.log('    { "mcpServers": { "orquestra": { "command": "npx", "args": ["orquestra-mcp"] } } }\n')
   console.log('  ¿Usas Cursor, ChatGPT/Codex o Gemini CLI? La config de cada uno está en:')
-  console.log('    https://orquestra.me/mcp#instalacion\n')
-  console.log('Docs completas y las 35 tools disponibles: https://orquestra.me/mcp')
+  console.log('    https://www.orquestra.me/mcp#instalacion\n')
+  console.log('Docs completas y todas las tools disponibles: https://www.orquestra.me/mcp')
 }