orquestra-mcp 1.9.0 → 1.10.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.9.0",
-  "description": "Servidor MCP de Orquestra -- 71 tools para leer y escribir tareas, ideas, changelog, infraestructura, contenido, QA y más desde un agente de IA",
+  "version": "1.10.0",
+  "description": "Servidor MCP de Orquestra -- 72 tools para leer y escribir tareas, ideas, changelog, infraestructura, contenido, QA y más desde un agente de IA",
   "type": "module",
   "bin": {
     "orquestra-mcp": "./bin/orquestra-mcp.mjs"

package/src/foundations.mjs

@@ -0,0 +1,50 @@
+// Checklist de "fundamentos olvidados" -- prácticas chicas que casi ningún
+// proyecto instrumenta por su cuenta pero suman mucho cuando faltan (idea
+// de José, 21 ago 2026, a raíz de auditar Orquestra mismo y encontrar
+// analytics/crash reporting ausentes en las 4 apps). Constantes estáticas,
+// sin acceso a red ni a la base de datos -- mismo criterio que stages.mjs.
+// get_foundations_checklist las expone tal cual; el agente conectado hace
+// la detección real (grep del repo local) y usa report_foundation_gap para
+// cada una que confirme ausente -- ver SERVER_INSTRUCTIONS.
+export const FOUNDATIONS = [
+  {
+    key: 'analytics',
+    label: 'Analytics de producto',
+    category: 'observabilidad',
+    why: 'Sin eventos básicos (pantallas, acciones clave) no hay forma de saber qué usa la gente ni de tomar decisiones con datos.',
+    detectionHint: 'Buscar SDKs de analytics en dependencias (Firebase Analytics, Segment, Amplitude, PostHog, Mixpanel) o gtag/GA4 en el HTML -- y confirmar que de verdad se llame (logEvent/track), no solo que esté listada la dependencia.',
+    scales: ['app', 'platform'],
+  },
+  {
+    key: 'crash_reporting',
+    label: 'Reporte de errores y crashes',
+    category: 'observabilidad',
+    why: 'Sin esto, los crashes de usuarios reales son invisibles -- solo se enteran si alguien reporta a mano.',
+    detectionHint: 'Buscar Crashlytics/Sentry/Bugsnag en dependencias, y confirmar inicialización real en el entrypoint de la app (no solo la dependencia listada y sin usar).',
+    scales: ['app', 'platform'],
+  },
+  {
+    key: 'error_alerting',
+    label: 'Alertas de error del backend',
+    category: 'observabilidad',
+    why: 'Un log que nadie lee no es monitoreo -- sin una alarma real, un backend caído puede tardar horas o días en notarse.',
+    detectionHint: 'Buscar alarmas de CloudWatch con AlarmActions/SNS, integraciones de Sentry/PagerDuty, o un webhook de errores a Slack/email en la infraestructura.',
+    scales: ['platform'],
+  },
+  {
+    key: 'dependency_scanning',
+    label: 'Escaneo de vulnerabilidades de dependencias',
+    category: 'seguridad',
+    why: 'Dependencias con vulnerabilidades conocidas quedan sin parchear indefinidamente si nada avisa cuando aparecen.',
+    detectionHint: 'Buscar .github/dependabot.yml, renovate.json, o un paso de audit (npm audit / pip-audit / similar) en el CI.',
+    scales: ['app', 'platform'],
+  },
+  {
+    key: 'ci_pipeline',
+    label: 'CI antes de mergear',
+    category: 'calidad',
+    why: 'Sin lint/tests/build automáticos en cada PR, cada regresión depende de que alguien la note a mano antes de mergear.',
+    detectionHint: 'Buscar workflows de CI (.github/workflows/*.yml, GitLab CI, CircleCI) con jobs que corran en pull_request, no solo en push a main.',
+    scales: ['app', 'platform'],
+  },
+]

package/src/server.mjs

@@ -2,6 +2,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 import { z } from 'zod'
 import { loadConfig, apiGet, apiPost, apiPatch, apiDelete, ApiError } from './api.mjs'
 import { STAGES, PLAYBOOKS } from './stages.mjs'
+import { FOUNDATIONS } from './foundations.mjs'
 
 function errorResult(err) {
   const text = err instanceof ApiError ? `Error (${err.status}): ${err.message}` : `Error: ${err.message}`
@@ -86,7 +87,9 @@ Si el usuario pide "sincronizar"/"revisar que todo esté al día"/"verificar el
 
 No le preguntes al usuario por workspaceId ni projectId -- ya están configurados. Solo pregúntale por el proyecto si tiene más de uno y no queda claro a cuál te refieres.
 
-No crees tareas ni entradas de changelog por preguntas triviales o exploración sin cambios reales -- solo por trabajo que de verdad avanza el proyecto.`
+No crees tareas ni entradas de changelog por preguntas triviales o exploración sin cambios reales -- solo por trabajo que de verdad avanza el proyecto.
+
+Si estás iniciando una sesión de trabajo real en un proyecto que YA tiene código (no un "vacío" recién conectado, ver arriba) y hace rato no se corrió este chequeo, o el usuario pide explícito "revisa fundamentos"/"qué le falta a este proyecto" (no lo hagas en cada mensaje ni en exploración sin cambios): llamá a get_foundations_checklist y, con acceso real al filesystem del repo (grep de dependencias, archivos de config, workflows de CI -- seguí el detectionHint de cada ítem), confirmá cuáles de verdad faltan -- filtrá por "scales" contra el scale real del proyecto (ver project.scale en get_project_context; un ítem con scales:["platform"] no aplica a una landing). Por cada uno que confirmes ausente con evidencia concreta, llamá a report_foundation_gap con esa evidencia específica -- nunca lo reportes solo porque el checklist lo menciona, sin haber revisado el código de verdad. No repitas un chequeo ya hecho recientemente en la misma sesión.`
 
 export function createServer() {
   const config = loadConfig()
@@ -318,6 +321,41 @@ export function createServer() {
     }
   )
 
+  server.registerTool(
+    'get_foundations_checklist',
+    {
+      description: 'Checklist de "fundamentos olvidados" -- prácticas chicas (analytics, crash reporting, alertas de error, escaneo de dependencias, CI) que casi ningún proyecto instrumenta por su cuenta pero suman mucho cuando faltan. No llama a la API -- datos estáticos. Cada ítem trae "scales" (a qué project.scale aplica -- "landing" queda afuera de la mayoría a propósito) y "detectionHint" para que TÚ (con acceso real al filesystem del repo) confirmes si de verdad falta antes de reportarlo con report_foundation_gap -- ver SERVER_INSTRUCTIONS para cuándo correr este chequeo.',
+    },
+    async () => textResult(FOUNDATIONS)
+  )
+
+  server.registerTool(
+    'report_foundation_gap',
+    {
+      description: 'Reporta un ítem de get_foundations_checklist que confirmaste ausente con evidencia real del repo (no lo llames sin haber revisado el código de verdad). Crea una sugerencia "foundation_gap", visible en el drawer "Sugerencias de IA" de la web -- aceptarla crea una tarea real (mismo mecanismo que accept_suggestion). Si ese foundationKey ya tiene una sugerencia (pending, aceptada o descartada) no crea una duplicada -- descartar una no la hace reaparecer en el siguiente chequeo.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        foundationKey: z.string().describe('key del ítem de get_foundations_checklist, ej. "analytics"'),
+        title: z.string().describe('Título corto y específico al proyecto real, ej. "Falta Crashlytics en la app iOS" -- no copies el label genérico del checklist tal cual.'),
+        reason: z.string().describe('Evidencia concreta que encontraste (qué buscaste, qué NO encontraste) y por qué importa acá -- no una explicación genérica del ítem.'),
+      },
+    },
+    async ({ projectId, foundationKey, title, reason }) => {
+      try {
+        const resolvedProjectId = resolveProjectId(projectId)
+        const data = await apiPost(config, '/v1/suggestions', {
+          projectId: resolvedProjectId,
+          kind: 'foundation_gap',
+          foundationKey, title, reason,
+          idempotencyKey: `foundation:${resolvedProjectId}:${foundationKey}`,
+        })
+        return textResult(data)
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
   // ═══ ESCRITURA (existentes) ═════════════════════════════════════════════════
 
   registerCreate(
@@ -700,7 +738,7 @@ export function createServer() {
   registerRead(
     'list_suggestions',
     '/v1/suggestions',
-    'Lista las sugerencias de IA de un proyecto (reescrituras de changelog, tareas que avanzaron/cerraron por evidencia, hallazgos de QA, gaps de setup/contenido/publicidad, fusiones de tareas sugeridas, ángulos de contenido). Por default solo trae las "pending" -- usá status="all" para ver también las ya aceptadas/descartadas, o un status puntual.',
+    'Lista las sugerencias de IA de un proyecto (reescrituras de changelog, tareas que avanzaron/cerraron por evidencia, hallazgos de QA, gaps de setup/contenido/publicidad/fundamentos, fusiones de tareas sugeridas, ángulos de contenido). Por default solo trae las "pending" -- usá status="all" para ver también las ya aceptadas/descartadas, o un status puntual.',
     { status: z.string().optional().describe('Default "pending". "all" trae todas, o un status puntual ("accepted"/"dismissed").') },
     (args, projectId) => ({ projectId, status: args.status })
   )
@@ -712,8 +750,8 @@ export function createServer() {
       inputSchema: {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
         suggestionId: z.string().describe('Ver list_suggestions'),
-        moduleId: z.string().optional().describe('Solo para kind="qa_finding" -- ese branch crea una tarea nueva, que exige moduleId real (mismas reglas que create_task). Ignorado en el resto de los kinds.'),
-        dueDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'Formato esperado: YYYY-MM-DD').optional().describe('Solo para kind="qa_finding" -- mismo motivo que moduleId arriba.'),
+        moduleId: z.string().optional().describe('Solo para kind="qa_finding"|"foundation_gap" -- esos branches crean una tarea nueva, que exige moduleId real (mismas reglas que create_task). Ignorado en el resto de los kinds.'),
+        dueDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'Formato esperado: YYYY-MM-DD').optional().describe('Solo para kind="qa_finding"|"foundation_gap" -- mismo motivo que moduleId arriba.'),
         overrides: z.record(z.any()).optional().describe('Solo para kind="content_angle" -- el form final de la pieza de contenido a crear (puede diferir de lo que propuso la IA). Mismos campos que create_content.'),
       },
     },