orquestra-mcp 1.16.0 → 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.0",
+  "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

@@ -71,6 +71,11 @@ export const PLATFORM_PLAYBOOKS = {
         title: 'Eliminar cuenta desde la app (Guideline 5.1.1(v))',
         body: 'Obligatorio desde 2022: si la app permite crear cuenta, tiene que permitir ELIMINARLA desde DENTRO de la app -- "escríbenos por correo" no cumple el requisito, aunque sea rápido y real. Verifica que exista un flujo de borrado self-service (botón "Eliminar cuenta" en Perfil/Ajustes, con confirmación) ANTES de enviar a revisión -- si no existe, Apple puede rechazar la app durante el review, incluso si el resto de la metadata está perfecta. Orquestra ya tiene este flujo (Zona de riesgo en Perfil, backend server-side que borra cuenta+datos), úsalo de referencia de implementación si tu app lo necesita desde cero.',
       },
+      {
+        key: 'sign_in_apple',
+        title: 'Sign in with Apple si hay login de terceros (Guideline 4.8)',
+        body: 'Si la app ofrece login con Google, Facebook u otro proveedor de terceros, Apple exige que TAMBIÉN ofrezcas "Sign in with Apple" como alternativa equivalente -- Guideline 4.8 ("Login Services"). No es una recomendación: si falta, Apple RECHAZA el build completo en revisión (motivo real, no hipotético) sin importar que el resto de la metadata esté perfecta. Implementación de referencia: botón nativo (`AuthenticationServices`, nonce) + capability "Sign in with Apple" habilitada en el App ID (Apple Developer Portal) + provider "Apple" activado en Firebase Auth si se usa Firebase. Si el login es solo email/password propio, sin ningún proveedor de terceros, esta regla no aplica.',
+      },
     ],
 
     tasks: [
@@ -97,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)',
@@ -114,6 +119,11 @@ export const PLATFORM_PLAYBOOKS = {
         description: 'Guideline 5.1.1(v), obligatorio -- "escríbenos por correo" NO cumple el requisito. Tiene que haber un botón real de "Eliminar cuenta" (con confirmación) en Perfil/Ajustes que borre la cuenta y los datos sin salir de la app. Si no existe, constrúyelo ANTES de mandar a revisión, no después de un rechazo.',
         type: 'security', priority: 'high', tags: ['publicacion', 'ios', 'compliance'], offsetDays: 1,
       },
+      {
+        title:       'Verificar que si hay login de terceros (Google/Facebook/etc.), también esté "Sign in with Apple"',
+        description: 'Guideline 4.8, obligatorio -- si la app ofrece login con Google, Facebook u otro proveedor externo, Apple rechaza la app en revisión si no ofrece también "Sign in with Apple" como alternativa. No aplica si el login es solo email/password propio, sin proveedores de terceros. Si falta, agrégalo ANTES de mandar a revisión, no después de un rechazo.',
+        type: 'security', priority: 'high', tags: ['publicacion', 'ios', 'compliance'], offsetDays: 1,
+      },
     ],
   },
 
@@ -190,6 +200,11 @@ export const PLATFORM_PLAYBOOKS = {
         title: 'App access / Sign-in details',
         body: 'Si la app requiere login, "Add sign in details" pide un set de credenciales de prueba REALES (nombre descriptivo del set, usuario/email, contraseña) que el reviewer va a usar de verdad para entrar -- tienen que funcionar y, si es posible, mostrar contenido de ejemplo real (no una cuenta vacía cayendo en un onboarding). Marca el checkbox de "esta cuenta da acceso completo a todas las funciones" si no hay niveles pagos/premium.',
       },
+      {
+        key: 'google_signin_sha1',
+        title: 'Google Sign-In: SHA-1 de las TRES firmas en Firebase (debug, upload key y Play App Signing)',
+        body: 'Si la app tiene "Continuar con Google", Google valida la firma del APK contra los SHA-1 registrados en Firebase → Configuración del proyecto → app Android → "Agregar huella digital". Son TRES firmas distintas y cada una necesita su SHA-1: (1) debug (`~/.android/debug.keystore`, builds locales), (2) upload key (el keystore con el que firmas el AAB, `assembleRelease`), y (3) Play App Signing -- la clave con la que Google RE-FIRMA los APK que instalan testers y usuarios desde Play; NO es la upload key, y es la que siempre se olvida. Se ve en Play Console → Test and release → App integrity → Play Store protection → Play app signing → "App signing key certificate" (columna Classical key). Las dos primeras salen de `./gradlew signingReport`. Síntoma si falta alguna: al elegir la cuenta "no pasa nada" -- Play Services lo reporta como cancelación del usuario, no como error de configuración, así que no hay ningún mensaje que te avise. Después de registrarlas, vuelve a descargar google-services.json.',
+      },
       {
         key: 'delete_account',
         title: 'Eliminar cuenta desde la app (política de borrado de cuenta de Google Play)',
@@ -228,10 +243,15 @@ export const PLATFORM_PLAYBOOKS = {
         description: 'Política de borrado de cuenta de Google Play (equivalente a la Guideline 5.1.1(v) de Apple) -- lo ideal es un flujo real dentro de la app, no solo la "Delete account URL" de la ficha. Si no existe, constrúyelo antes de publicar.',
         type: 'security', priority: 'high', tags: ['publicacion', 'android', 'compliance'], offsetDays: 1,
       },
+      {
+        title:       'Registrar en Firebase el SHA-1 de las TRES firmas (debug, upload key y Play App Signing) si la app usa Google Sign-In',
+        description: 'Gotcha real: cada firma distinta del APK necesita su propio SHA-1 en Firebase (Configuración del proyecto → app Android → "Agregar huella digital"), y la que siempre se olvida es la de Play App Signing -- Google re-firma con ella los APK que se instalan desde Play, así que un login con Google que funciona en debug y en el release local falla en el build de los testers sin ningún mensaje (Play Services lo reporta como cancelación). Debug y upload key: `./gradlew signingReport`. Play App Signing: Play Console → App integrity → Play app signing → "App signing key certificate". Al terminar, re-descargar google-services.json.',
+        type: 'tech', priority: 'high', tags: ['publicacion', 'android', 'google-sign-in'], offsetDays: 1,
+      },
       {
         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'),
@@ -1589,6 +1593,8 @@ export function createServer() {
     saves: z.number().optional().describe('Guardados -- entrada manual, típico de X/Instagram (solo con channelId suelto)'),
     avgReadMinutes: z.number().optional().describe('Minutos de lectura media -- entrada manual, típico de blog (solo con channelId suelto)'),
     imagePrompt: z.string().optional().describe('Descripción visual en inglés para generar la portada -- no genera la imagen, solo guarda el texto (solo con channelId suelto)'),
+    recommendedMedia: z.enum(['image', 'video']).optional().describe('Qué conviene más de portada para esta pieza -- puramente informativo, ningún flujo cambia solo por esto (solo con channelId suelto)'),
+    videoPrompt: z.string().optional().describe('Análogo a imagePrompt pero para video: descripción de la escena en movimiento, en inglés, para pegar en un generador de video externo -- Orquestra no genera video, solo guarda el texto (solo con channelId suelto)'),
     language: z.string().optional().describe('\'en\' si esta pieza es la traducción de otra. Sin valor = idioma original.'),
     translationOf: z.string().optional().describe('Si esta pieza es una traducción, id del content original'),
   })
@@ -1616,6 +1622,8 @@ export function createServer() {
     saves: z.number().optional(),
     avgReadMinutes: z.number().optional(),
     imagePrompt: z.string().optional(),
+    recommendedMedia: z.enum(['image', 'video']).optional(),
+    videoPrompt: z.string().optional(),
     language: z.string().optional(),
     translationOf: z.string().optional(),
   })
@@ -1628,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(),
@@ -1680,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(),
@@ -1688,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.'),
   })
 
@@ -1812,7 +1822,7 @@ export function createServer() {
   server.registerTool(
     'apply_platform_playbook',
     {
-      description: 'Aplica el Platform Playbook de publicación (iOS App Store / Google Play) sobre una distribución real: crea el módulo + tareas de la plantilla (igual que apply_stage_playbook) y, si mandás publishForm, también completa el formulario de la Guía de publicación de esa distribución (mismo dato que llena DistributionGuide.jsx en la web). Solo completá campos para los que tengas una base real del proyecto (código, get_project_context, servicios/entornos configurados) -- nunca inventes pricing, availability, package/bundle ID, cuentas demo para el reviewer, o el nombre exacto de la app; dejalos afuera de publishForm para que el usuario los complete a mano. Si la distribución YA tiene valores guardados en alguna de las claves que mandás, la tool NO los sobreescribe en silencio -- devuelve publishFormConflict con el valor actual vs. el propuesto por cada clave en conflicto, sin tocar publishForm. Mostrale ese conflicto al usuario y volvé a llamar con confirmReplace:true SOLO si confirma explícitamente el reemplazo.',
+      description: 'Aplica el Platform Playbook de publicación (iOS App Store / Google Play) sobre una distribución real: crea el módulo + tareas de la plantilla (igual que apply_stage_playbook) y, si mandás publishForm, también completa el formulario de la Guía de publicación de esa distribución (mismo dato que llena DistributionGuide.jsx en la web). Solo completá campos para los que tengas una base real del proyecto (código, get_project_context, servicios/entornos configurados) -- nunca inventes pricing, availability, package/bundle ID, cuentas demo para el reviewer, o el nombre exacto de la app; dejalos afuera de publishForm para que el usuario los complete a mano. Si la distribución YA tiene valores guardados en alguna de las claves que mandás, la tool NO los sobreescribe en silencio -- devuelve publishFormConflict con el valor actual vs. el propuesto por cada clave en conflicto, sin tocar publishForm. Mostrale ese conflicto al usuario y volvé a llamar con confirmReplace:true SOLO si confirma explícitamente el reemplazo. Si este playbook YA se aplicó antes sobre esta misma distribución (módulo+tareas ya creados), la tool lo detecta sola (mismo mecanismo que el badge "Ya aplicado" de DistributionGuide.jsx) y NO vuelve a crear módulo/tareas duplicados -- devuelve alreadyApplied:true. Volvé a llamar con force:true SOLO si el usuario pide explícitamente un checklist nuevo encima del que ya existe.',
       inputSchema: {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
         platform: z.enum(['ios', 'android']).describe('ios (App Store Connect) | android (Google Play Console) -- ver get_platform_playbook para el contenido'),
@@ -1820,40 +1830,58 @@ export function createServer() {
         moduleName: z.string().optional().describe('Nombre del módulo -- default: el de la plantilla'),
         publishForm: z.record(z.string()).optional().describe('Respuestas a completar, clave = key de referenceGuide (ver get_platform_playbook). Omitido o vacío = solo crea módulo + tareas, sin tocar el formulario.'),
         confirmReplace: z.boolean().optional().describe('Default false. Mandá true solo cuando el usuario ya confirmó explícitamente reemplazar valores existentes que te devolvió publishFormConflict en un llamado anterior.'),
+        force: z.boolean().optional().describe('Default false. Si este playbook ya se aplicó antes sobre esta distribución, por default la tool NO crea un segundo módulo/checklist -- mandá true solo cuando el usuario pidió explícitamente crear uno nuevo encima del que ya existe.'),
       },
     },
-    async ({ projectId, platform, distributionId, moduleName, publishForm, confirmReplace }) => {
+    async ({ projectId, platform, distributionId, moduleName, publishForm, confirmReplace, force }) => {
       try {
         const pid = resolveProjectId(projectId)
         const playbook = PLATFORM_PLAYBOOKS[platform]
-        const moduleData = await apiPost(config, '/v1/modules', {
-          projectId: pid,
-          name: moduleName || playbook.moduleName,
-          description: playbook.moduleDescription,
-          tags: playbook.moduleTags,
-        })
+        const appliedKey = `${distributionId}_publish`
 
-        const taskIds = []
-        for (const t of playbook.tasks) {
-          const dueDate = new Date(Date.now() + t.offsetDays * 86400000).toISOString().slice(0, 10)
-          const created = await apiPost(config, '/v1/tasks', {
+        const project = await apiGet(config, `/v1/projects/${pid}`, {})
+        const alreadyApplied = !!(project.appliedPlaybooks || {})[appliedKey]
+
+        const result = {}
+
+        if (alreadyApplied && !force) {
+          result.alreadyApplied = true
+          result.message = 'Este playbook ya se había aplicado antes sobre esta distribución (el módulo y sus tareas ya existen en el proyecto) -- no se creó nada de nuevo para no duplicarlo. Si el usuario pide explícitamente un checklist nuevo, volvé a llamar con force:true.'
+        } else {
+          const moduleData = await apiPost(config, '/v1/modules', {
             projectId: pid,
-            title: t.title,
-            description: t.description,
-            type: t.type,
-            priority: t.priority,
-            tags: t.tags,
-            moduleId: moduleData.id,
-            dueDate,
+            name: moduleName || playbook.moduleName,
+            description: playbook.moduleDescription,
+            tags: playbook.moduleTags,
           })
-          taskIds.push(created.id)
-        }
 
-        const result = { module: moduleData, tasksCreated: taskIds.length, taskIds }
+          const taskIds = []
+          for (const t of playbook.tasks) {
+            const dueDate = new Date(Date.now() + t.offsetDays * 86400000).toISOString().slice(0, 10)
+            const created = await apiPost(config, '/v1/tasks', {
+              projectId: pid,
+              title: t.title,
+              description: t.description,
+              type: t.type,
+              priority: t.priority,
+              tags: t.tags,
+              moduleId: moduleData.id,
+              dueDate,
+            })
+            taskIds.push(created.id)
+          }
+
+          result.module = moduleData
+          result.tasksCreated = taskIds.length
+          result.taskIds = taskIds
+
+          await apiPatch(config, '/v1/projects', { id: pid, appliedPlaybooks: { [appliedKey]: true } })
+          result.markedApplied = true
+        }
 
         if (publishForm && Object.keys(publishForm).length > 0) {
           const distributions = await apiGet(config, '/v1/distributions', { projectId: pid })
-          const dist = distributions.find(d => d.id === distributionId)
+          const dist = distributions.items.find(d => d.id === distributionId)
           if (!dist) {
             throw new Error(`No se encontró la distribución "${distributionId}" en este proyecto -- revisá list_distributions.`)
           }