orquestra-mcp 1.49.0 → 1.50.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.49.0",
+  "version": "1.50.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": {

package/src/server.mjs

@@ -25,6 +25,8 @@ function textResult(data) {
 }
 
 const PROJECT_ID_DESC = 'ID del proyecto dentro del workspace configurado. Si hay un proyecto default configurado (via "setup" o ORQUESTRA_DEFAULT_PROJECT_ID), este argumento se ignora -- el server queda fijo a ese proyecto y no puede leer/escribir otro.'
+// ORQ-411: los textos largos de idea, riesgo y módulo también cuentan para [[...]] y "Mencionado en".
+const WIKILINK_DESC = 'Admite [[Título]], [[Título|texto]] o [[ORQ-123]] para enlazar otra nota, doc, tarea, reunión, idea, riesgo, módulo, contenido o distribución del proyecto.'
 
 const TASK_TYPES = ['feature', 'bug', 'improvement', 'tech', 'docs', 'idea', 'design', 'security', 'meeting', 'call', 'followup', 'business']
 // Actividades (ORQ-295): reunión/llamada/seguimiento. 'business' sigue siendo tarea (entregable). Mismas listas que
@@ -1008,10 +1010,10 @@ export function createServer() {
   registerRead(
     'get_backlinks',
     '/v1/backlinks',
-    'Backlinks ("Mencionado en"): qué notas, docs, tareas e ideas enlazan con [[...]] a la entidad pedida. Útil antes de editar o cerrar algo para ver qué depende de eso.',
+    'Backlinks ("Mencionado en"): qué notas, docs, tareas, reuniones, ideas, riesgos y módulos enlazan con [[...]] a la entidad pedida (también cuentan los puntos a revisar de una reunión y las instrucciones de las verificaciones). Útil antes de editar o cerrar algo para ver qué depende de eso.',
     {
-      type: z.enum(['note', 'doc', 'task', 'idea']),
-      id: z.string().describe('id de la nota/doc/tarea/idea'),
+      type: z.enum(['note', 'doc', 'task', 'activity', 'idea', 'risk', 'module', 'content', 'distribution']).describe('"activity" para reunión/llamada/seguimiento'),
+      id: z.string().describe('id del ítem'),
     },
     (args, projectId) => ({ projectId, type: args.type, id: args.id })
   )
@@ -1993,7 +1995,7 @@ export function createServer() {
     {
       relatedTo: RELATED_TO,
       title: z.string().describe('Título de la idea'),
-      description: z.string().optional(),
+      description: z.string().optional().describe(WIKILINK_DESC),
       priority: z.enum(TASK_PRIORITIES).optional().describe('Default: medium -- se puede derivar de impact+effort si los mandas (alto+bajo→high, alto+alto o bajo+bajo→medium, bajo+alto→low).'),
       categoryId: z.string().optional(),
       dueDate: z.string().optional().describe('YYYY-MM-DD'),
@@ -2014,7 +2016,7 @@ export function createServer() {
 
   registerUpdate('update_idea', '/v1/ideas', 'Edita una idea existente. Todos los campos son opcionales -- solo se cambian los que mandes.', {
     title: z.string().optional(),
-    description: z.string().optional(),
+    description: z.string().optional().describe(WIKILINK_DESC),
     priority: z.enum(TASK_PRIORITIES).optional(),
     categoryId: z.string().optional(),
     dueDate: z.string().optional().describe('YYYY-MM-DD'),
@@ -2236,14 +2238,19 @@ export function createServer() {
     'Lista TODAS las notas de un proyecto de Orquestra, con todos sus campos -- a diferencia de get_project_context/search (resumen recortado), útil para auditar o encontrar el id exacto antes de update_note.',
     {}, (args, projectId) => ({ projectId }))
 
+  // ORQ-414: puntos de la idea, mismo shape que agendaItems de las actividades.
+  const NOTE_ITEMS = z.array(z.union([z.string(), z.object({ id: z.string().optional(), text: z.string() })])).optional()
+    .describe('Puntos de la idea, debajo de la descripción (body). Lista simple, NO checklist (sin palomitas). Reemplaza la lista COMPLETA: para agregar uno, lee la actual con list_notes y manda todos (con sus id para conservarlos).')
+
   registerCreate(
     'create_note',
     '/v1/notes',
-    'Crea una nota en un proyecto de Orquestra. En el texto, [[Título]] o [[Título|texto]] enlaza otra nota, doc, tarea o idea del proyecto (o [[ORQ-123]] por folio) -- úsalo para conectar el conocimiento en vez de pegar ids.',
+    'Crea una nota en un proyecto de Orquestra. En el texto, [[Título]] o [[Título|texto]] enlaza otra nota, doc, tarea, reunión, idea, riesgo, módulo, contenido o distribución del proyecto (o [[ORQ-123]] por folio) -- úsalo para conectar el conocimiento en vez de pegar ids.',
     {
       relatedTo: RELATED_TO,
       title: z.string().describe('Título de la nota'),
-      body: z.string().optional(),
+      body: z.string().optional().describe('Descripción de la nota.'),
+      noteItems: NOTE_ITEMS,
       pinned: z.boolean().optional(),
       moduleId: z.string().optional().describe('Módulo relacionado, si la nota es sobre uno específico -- ligarla ayuda a encontrarla después (ver list_modules)'),
       taskId: z.string().optional().describe('Tarea relacionada, si la nota es sobre una específica (ver list_tasks)'),
@@ -2265,6 +2272,7 @@ export function createServer() {
     {
       title: z.string().optional(),
       body: z.string().optional(),
+      noteItems: NOTE_ITEMS,
       pinned: z.boolean().optional(),
       moduleId: z.string().optional(),
       taskId: z.string().optional(),
@@ -2315,7 +2323,7 @@ export function createServer() {
   registerCreate(
     'create_doc',
     '/v1/docs',
-    'Crea un documento en un proyecto de Orquestra. En el texto, [[Título]] o [[Título|texto]] enlaza otra nota, doc, tarea o idea del proyecto (o [[ORQ-123]] por folio) -- úsalo para conectar el conocimiento en vez de pegar ids.',
+    'Crea un documento en un proyecto de Orquestra. En el texto, [[Título]] o [[Título|texto]] enlaza otra nota, doc, tarea, reunión, idea, riesgo, módulo, contenido o distribución del proyecto (o [[ORQ-123]] por folio) -- úsalo para conectar el conocimiento en vez de pegar ids.',
     {
       relatedTo: RELATED_TO,
       type: z.enum(DOC_TYPES).optional().describe('Tipo de documento -- obligatorio salvo que mandes templateId (la plantilla trae su tipo)'),
@@ -2352,7 +2360,7 @@ export function createServer() {
     'Edita un documento existente. Solo se cambian los campos que mandes; content REEMPLAZA el texto entero (lee primero con get_doc y manda el documento completo, no solo el cambio). La versión anterior queda en el historial del doc ("Versiones"). Si cambias el título, los [[Título viejo]] de todo el proyecto se reescriben solos.',
     {
       title: z.string().optional(),
-      content: z.string().optional().describe('Markdown completo del doc. [[Título]] enlaza otra nota, doc, tarea o idea.'),
+      content: z.string().optional().describe('Markdown completo del doc. [[Título]] enlaza otra nota, doc, tarea, reunión, idea, riesgo, módulo, contenido o distribución.'),
       type: z.enum(DOC_TYPES).optional(),
       adrStatus: z.enum(ADR_STATUSES).optional().describe('Solo para type=\'adr\'.'),
       adrContext: z.string().optional().describe('Solo para type=\'adr\'.'),
@@ -2372,7 +2380,7 @@ export function createServer() {
   const MODULE_KEY = z.string().optional().describe('Clave del módulo (ej. "AUTH", "PAGOS"): 2-10 letras/números, empieza con letra, única en el proyecto. Numera sus tareas (AUTH-1, AUTH-2...) en moduleCode, además del folio ORQ-N. Solo si el usuario la pidió o el proyecto ya usa claves -- no la inventes.')
   registerCreate('create_module', '/v1/modules', 'Crea un módulo en un proyecto de Orquestra.', {
     name: z.string().describe('Nombre del módulo'),
-    description: z.string().optional(),
+    description: z.string().optional().describe(WIKILINK_DESC),
     statusId: z.string().optional(),
     categoryId: z.string().optional(),
     scope: SCOPE_SCHEMA.describe('Alcance por distribución, ej: [{distId, layer, done}]'),
@@ -2381,12 +2389,12 @@ export function createServer() {
     shippedVersion: z.string().optional().describe('Versión del changelog en la que se envió, ej: "1.4.0"'),
     ownerUid: z.string().optional().describe('uid del miembro responsable del avance del módulo'),
     dependsOnModuleIds: z.array(z.string()).optional().describe('IDs de módulos de los que este depende (dependencia planeada, manual)'),
-    closureCriteria: z.string().optional().describe('Texto libre: cuándo se considera verdaderamente cerrado'),
+    closureCriteria: z.string().optional().describe(`Texto libre: cuándo se considera verdaderamente cerrado. ${WIKILINK_DESC}`),
     key: MODULE_KEY,
   })
   registerUpdate('update_module', '/v1/modules', 'Edita un módulo existente (incluido su scope multiplataforma).', {
     name: z.string().optional(),
-    description: z.string().optional(),
+    description: z.string().optional().describe(WIKILINK_DESC),
     statusId: z.string().optional(),
     categoryId: z.string().optional(),
     scope: SCOPE_SCHEMA,
@@ -2395,7 +2403,7 @@ export function createServer() {
     shippedVersion: z.string().optional().describe('Versión del changelog en la que se envió, ej: "1.4.0"'),
     ownerUid: z.string().optional().describe('uid del miembro responsable del avance del módulo'),
     dependsOnModuleIds: z.array(z.string()).optional().describe('IDs de módulos de los que este depende (dependencia planeada, manual)'),
-    closureCriteria: z.string().optional().describe('Texto libre: cuándo se considera verdaderamente cerrado'),
+    closureCriteria: z.string().optional().describe(`Texto libre: cuándo se considera verdaderamente cerrado. ${WIKILINK_DESC}`),
     key: MODULE_KEY.describe(`${MODULE_KEY.description} Poner o cambiar la clave numera las tareas del módulo que todavía no tienen una (por orden de creación; la respuesta trae assignedCodes). "" la quita: las tareas conservan la suya.`),
   })
 
@@ -2678,10 +2686,10 @@ export function createServer() {
   registerCreate('create_risk', '/v1/risks', 'Registra un riesgo/bloqueo a nivel de proyecto -- algo que puede hacer fallar o atrasar el proyecto en general, no el bloqueo puntual de una tarea (para eso usa relatedTaskId en update_task).', {
     relatedTo: RELATED_TO,
     title: z.string(),
-    description: z.string().optional(),
+    description: z.string().optional().describe(WIKILINK_DESC),
     probability: z.enum(RISK_LEVELS).optional().describe('Default: medium'),
     impact: z.enum(RISK_LEVELS).optional().describe('Default: medium'),
-    mitigation: z.string().optional().describe('Plan o texto libre de qué se hace para reducir este riesgo'),
+    mitigation: z.string().optional().describe(`Plan o texto libre de qué se hace para reducir este riesgo. ${WIKILINK_DESC}`),
     status: z.enum(RISK_STATUSES).optional().describe('Default: open. "closed" en vez de borrar -- nunca se borra un riesgo.'),
     ownerUid: z.string().optional().describe('Dueño del riesgo -- le avisa solo a esa persona al asignarla (ver list de miembros del workspace)'),
     moduleId: z.string().optional().describe('Módulo relacionado, si aplica (ver list_modules)'),
@@ -2689,10 +2697,10 @@ export function createServer() {
 
   registerUpdate('update_risk', '/v1/risks', 'Edita un riesgo existente -- típicamente para actualizar su mitigación o cerrarlo (status: "closed") cuando deja de aplicar.', {
     title: z.string().optional(),
-    description: z.string().optional(),
+    description: z.string().optional().describe(WIKILINK_DESC),
     probability: z.enum(RISK_LEVELS).optional(),
     impact: z.enum(RISK_LEVELS).optional(),
-    mitigation: z.string().optional(),
+    mitigation: z.string().optional().describe(WIKILINK_DESC),
     status: z.enum(RISK_STATUSES).optional(),
     ownerUid: z.string().optional(),
     moduleId: z.string().optional(),