orquestra-mcp 1.0.5 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.0.5",
+  "version": "1.2.0",
   "description": "Servidor MCP de Orquestra -- 35 tools para leer y escribir tareas, ideas, changelog, infraestructura y más desde un agente de IA",
   "type": "module",
   "bin": {

package/src/server.mjs

@@ -38,9 +38,33 @@ const SETUP_GUIDE = {
   ],
 }
 
+// Instrucciones a nivel de servidor (campo "instructions" del protocolo MCP)
+// -- la mayoría de los clientes (Claude Code/Desktop, Cursor, Gemini CLI...)
+// las inyectan solas como contexto del modelo al conectarse, sin que el
+// usuario tenga que escribir nada en su CLAUDE.md/AGENTS.md. Acá vive el
+// "modo automático": cuándo respaldar trabajo como tarea/changelog sin que
+// se lo pidan, cómo llenar un proyecto vacío la primera vez, y cuándo sí
+// preguntar en vez de adivinar.
+const SERVER_INSTRUCTIONS = `Este server conecta con Orquestra, la app de gestión de proyectos del usuario -- úsalo para mantener su proyecto sincronizado con el trabajo real, sin que tenga que pedírtelo cada vez.
+
+Al empezar una sesión de trabajo en este proyecto, llama una vez a get_project_context para saber en qué fase está, qué tareas hay abiertas/vencidas/bloqueadas y qué se hizo recientemente. Úsalo como contexto de fondo, no lo repitas en cada mensaje.
+
+Si get_project_context devuelve un proyecto vacío (sin módulos ni tareas), es la primera vez que se usa este MCP aquí -- pero "vacío en Orquestra" NO significa "recién empezado en la realidad". Antes de ofrecer nada, pregúntale al usuario: ¿este proyecto es una idea nueva, o ya existe y solo lo estás conectando por primera vez? Según la respuesta:
+- Si es una idea nueva: llama a get_setup_guide y ofrece un playbook de etapa "pre" (get_stage_playbook + apply_stage_playbook).
+- Si ya existe y está avanzado: usa update_project para poner la fase real (mvp/v1/beta/producción, no "idea"), crea una distribution por cada plataforma real que te mencione, y ofrece el playbook de etapa "build" en vez de "pre" -- no le apliques la plantilla de idea/diseño a un proyecto que ya está en desarrollo activo.
+
+Durante el trabajo normal de código, sin que el usuario te lo pida explícitamente:
+- Si te pide una funcionalidad o arreglo real (no una pregunta rápida ni exploración de código sin cambios), revisa con list_tasks/search si ya existe una tarea relacionada; si no, créala con create_task antes de empezar a trabajar.
+- Al terminar, mueve la tarea de estatus con update_task y registra una entrada de changelog con create_changelog_entry -- así el usuario nunca tiene que documentar esto a mano.
+- Antes de crear un módulo/estatus/categoría/servicio/entorno/distribución, revisa con el list_* correspondiente que no exista ya uno con ese nombre.
+
+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.`
+
 export function createServer() {
   const config = loadConfig()
-  const server = new McpServer({ name: 'orquestra-mcp', version: '1.0.0' })
+  const server = new McpServer({ name: 'orquestra-mcp', version: '1.0.0' }, { instructions: SERVER_INSTRUCTIONS })
 
   function resolveProjectId(projectId) {
     if (config.defaultProjectId) return config.defaultProjectId
@@ -509,6 +533,29 @@ 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.',
+      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(),
+        url: z.string().optional(),
+      },
+    },
+    async ({ projectId, ...body }) => {
+      try {
+        const data = await apiPatch(config, '/v1/projects', { id: resolveProjectId(projectId), ...body })
+        return textResult(data)
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
   server.registerTool(
     'apply_stage_playbook',
     {