orquestra-mcp 1.8.0 → 1.9.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.8.0",
-  "description": "Servidor MCP de Orquestra -- 69 tools para leer y escribir tareas, ideas, changelog, infraestructura, contenido, QA y más desde un agente de IA",
+  "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",
   "type": "module",
   "bin": {
     "orquestra-mcp": "./bin/orquestra-mcp.mjs"

package/src/server.mjs

@@ -44,7 +44,7 @@ const SETUP_GUIDE = {
     { step: 4, section: 'Módulos', check: 'list_modules', createOrUpdate: 'create_module / update_module', matchBy: 'name', dependsOn: ['statusId (paso 1)', 'categoryId (paso 2)'] },
     { step: 5, section: 'Tareas', check: 'list_tasks', createOrUpdate: 'create_task / update_task', matchBy: 'title', dependsOn: ['statusId', 'categoryId', 'moduleId'] },
     { step: 6, section: 'Ideas', check: 'search', createOrUpdate: 'create_idea / update_idea / convert_idea_to_task', matchBy: 'title' },
-    { step: 7, section: 'Notas', check: 'search', createOrUpdate: 'create_note (sin update_note todavía)', matchBy: 'title' },
+    { step: 7, section: 'Notas', check: 'list_notes', createOrUpdate: 'create_note / update_note', matchBy: 'title' },
     { step: 8, section: 'Changelog', check: 'list_changelog', createOrUpdate: 'create_changelog_entry / update_changelog_entry', matchBy: 'text' },
     { step: 9, section: 'Docs', check: 'search', createOrUpdate: 'create_doc (sin update_doc todavía)', matchBy: 'title' },
   ],
@@ -796,6 +796,10 @@ export function createServer() {
     }
   )
 
+  registerRead('list_notes', '/v1/notes',
+    '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 }))
+
   registerCreate(
     'create_note',
     '/v1/notes',
@@ -816,6 +820,24 @@ export function createServer() {
     }
   )
 
+  registerUpdate('update_note', '/v1/notes',
+    'Edita una nota existente. Todos los campos son opcionales -- solo se cambian los que mandes.',
+    {
+      title: z.string().optional(),
+      body: z.string().optional(),
+      pinned: z.boolean().optional(),
+      moduleId: z.string().optional(),
+      taskId: z.string().optional(),
+      type: z.enum(NOTE_TYPES).optional(),
+      alternativesConsidered: z.string().optional(),
+      wouldRevertIf: z.string().optional(),
+      visibility: z.enum(NOTE_VISIBILITY).optional(),
+      relatedNoteId: z.string().optional(),
+      adrDocId: z.string().optional().describe('Liga esta nota a un doc ADR ya creado. No lo mandes junto con publishAsAdr.'),
+      publishAsAdr: z.boolean().optional().describe('Genera el doc ADR recién ahora (útil si la nota se marcó "decision" después de creada) y liga adrDocId -- falla si la nota ya tiene uno.'),
+    }
+  )
+
   registerCreate(
     'create_doc',
     '/v1/docs',
@@ -1251,6 +1273,7 @@ export function createServer() {
         description: z.string().optional(),
         phase: z.string().optional().describe('idea | mvp | v1 | v2 | beta | produccion (default: idea)'),
         projectType: z.enum(['code', 'content', 'hybrid']).optional().describe('Default: hybrid'),
+        scale: z.enum(['landing', 'app', 'platform']).optional().describe('Default implícito: app. Eje ORTOGONAL a projectType -- "landing" es una página estática sin backend/auth/db propios (evita que las sugerencias de setup propongan infra que no aplica).'),
         url: z.string().optional(),
         distributions: z.array(z.enum(PLATFORM_TYPES)).optional().describe('Plataformas a crear, ej: ["web","ios"]'),
         categories: z.array(z.string()).optional().describe('Nombres de categorías a crear (default: ["General"])'),
@@ -1269,13 +1292,14 @@ export function createServer() {
   server.registerTool(
     'update_project',
     {
-      description: 'Edita el proyecto configurado (name, description, phase, projectType, url). Útil para sincronizar la fase real de un proyecto que ya estaba avanzado antes de conectarlo a Orquestra -- get_project_context puede verse "vacío" (sin módulos/tareas) sin que eso signifique que el proyecto recién empieza.',
+      description: 'Edita el proyecto configurado (name, description, phase, projectType, scale, url). Útil para sincronizar la fase real de un proyecto que ya estaba avanzado antes de conectarlo a Orquestra -- get_project_context puede verse "vacío" (sin módulos/tareas) sin que eso signifique que el proyecto recién empieza.',
       inputSchema: {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
         name: z.string().optional(),
         description: z.string().optional(),
         phase: z.string().optional().describe('idea | mvp | v1 | v2 | beta | produccion'),
         projectType: z.enum(['code', 'content', 'hybrid']).optional(),
+        scale: z.enum(['landing', 'app', 'platform']).optional().describe('Eje ORTOGONAL a projectType, no lo reemplaza -- "landing" es una página estática sin backend/auth/db propios (ej. un portafolio o sitio de marketing): marcalo así si el proyecto es claramente eso, para que las sugerencias de setup dejen de proponer backend/auth/database. Default implícito "app" si no se manda -- sin este campo, el comportamiento es igual que antes.'),
         url: z.string().optional(),
       },
     },