orquestra-mcp 1.1.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.1.0",
+  "version": "1.3.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/api.mjs

@@ -1,4 +1,4 @@
-import { readConfigFile, CONFIG_PATH } from './configFile.mjs'
+import { readConfigFile, resolveProjectForCwd, CONFIG_PATH } from './configFile.mjs'
 
 const DEFAULT_API_BASE = 'https://api.orquestra.me'
 
@@ -7,7 +7,16 @@ export function loadConfig() {
   const apiBase = process.env.ORQUESTRA_API_BASE || fileConfig?.apiBase || DEFAULT_API_BASE
   const apiToken = process.env.ORQUESTRA_API_TOKEN || fileConfig?.apiToken
   const workspaceId = process.env.ORQUESTRA_WORKSPACE_ID || fileConfig?.workspaceId
-  const defaultProjectId = process.env.ORQUESTRA_DEFAULT_PROJECT_ID || fileConfig?.defaultProjectId
+
+  // ORQUESTRA_DEFAULT_PROJECT_ID (env var, ej. desde un MCP config con
+  // scope local/project de Claude Code) siempre gana -- es una anulación
+  // explícita. Si no hay env var, se busca en el mapa carpeta->proyecto del
+  // config file, subiendo desde cwd (ver resolveProjectForCwd). Si ninguna
+  // carpeta ancestro está mapeada, defaultProjectId queda undefined a
+  // propósito -- resolveProjectId() en server.mjs debe fallar explícito en
+  // vez de usar el proyecto de otra carpeta.
+  const defaultProjectId = process.env.ORQUESTRA_DEFAULT_PROJECT_ID
+    || resolveProjectForCwd(fileConfig?.projects, process.cwd())
 
   const missing = []
   if (!apiToken) missing.push('ORQUESTRA_API_TOKEN')

package/src/configFile.mjs

@@ -1,6 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs'
 import { homedir } from 'os'
-import { join, dirname } from 'path'
+import { join, dirname, sep } from 'path'
 
 export const CONFIG_PATH = join(homedir(), '.orquestra', 'mcp-config.json')
 
@@ -17,3 +17,29 @@ export function writeConfigFile(data) {
   mkdirSync(dirname(CONFIG_PATH), { recursive: true })
   writeFileSync(CONFIG_PATH, JSON.stringify(data, null, 2), { mode: 0o600 })
 }
+
+// Guarda/actualiza el projectId de UNA carpeta sin pisar las demás -- setup
+// se puede correr varias veces, una por cada carpeta contenedora de repos
+// (ver resolveProjectForCwd), y cada corrida solo debe tocar su propia
+// entrada.
+export function upsertProjectMapping({ apiBase, apiToken, workspaceId, folderPath, projectId }) {
+  const existing = readConfigFile() || {}
+  const projects = { ...(existing.projects || {}) }
+  projects[folderPath] = projectId
+  writeConfigFile({ apiBase, apiToken, workspaceId, projects })
+}
+
+// Busca, subiendo desde cwd hacia la raíz, la carpeta mapeada más específica
+// -- mismo criterio que .editorconfig/.gitconfig: el ancestro más cercano
+// gana, así que un repo individual con su propio mapeo puede sobreescribir
+// el de la carpeta contenedora que lo engloba.
+export function resolveProjectForCwd(projects, cwd) {
+  if (!projects) return undefined
+  let best = null
+  for (const folderPath of Object.keys(projects)) {
+    const normalized = folderPath.endsWith(sep) ? folderPath.slice(0, -1) : folderPath
+    if (cwd !== normalized && !cwd.startsWith(normalized + sep)) continue
+    if (!best || normalized.length > best.length) best = normalized
+  }
+  return best ? projects[best] : undefined
+}

package/src/server.mjs

@@ -49,7 +49,9 @@ const SERVER_INSTRUCTIONS = `Este server conecta con Orquestra, la app de gesti
 
 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í -- antes de crear nada a mano, llama a get_setup_guide y ofrece al usuario aplicar un playbook de etapa (get_stage_playbook + apply_stage_playbook) o iniciar un proyecto nuevo (init_project).
+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.
@@ -66,7 +68,14 @@ export function createServer() {
 
   function resolveProjectId(projectId) {
     if (config.defaultProjectId) return config.defaultProjectId
-    if (!projectId) throw new Error('Falta projectId -- no hay proyecto default configurado, corre "npx orquestra-mcp setup" o pasa projectId explícito.')
+    if (!projectId) {
+      throw new Error(
+        `No hay ningún proyecto de Orquestra configurado para esta carpeta (${process.cwd()}). ` +
+        `No asumas que se refiere a otro proyecto que hayas visto en esta cuenta -- dile al usuario que ` +
+        `corra "npx orquestra-mcp setup" en esta carpeta (o en la carpeta contenedora, si este proyecto ` +
+        `vive repartido en varios repos) para conectarla.`
+      )
+    }
     return projectId
   }
 
@@ -531,6 +540,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',
     {

package/src/setup.mjs

@@ -2,7 +2,9 @@ import { createServer } from 'http'
 import { randomBytes } from 'crypto'
 import { exec } from 'child_process'
 import { createInterface } from 'readline'
-import { writeConfigFile, CONFIG_PATH } from './configFile.mjs'
+import { homedir } from 'os'
+import { resolve } from 'path'
+import { upsertProjectMapping, CONFIG_PATH } from './configFile.mjs'
 
 const DEFAULT_API_BASE = 'https://api.orquestra.me'
 const DEFAULT_WEB_URL = 'https://app.orquestra.me'
@@ -114,8 +116,19 @@ export async function runSetup() {
     }
   }
 
-  writeConfigFile({ apiBase, apiToken: token, workspaceId, defaultProjectId })
-  console.log(`\nListo. Configuración guardada en ${CONFIG_PATH}.`)
+  console.log(`\nEsta conexión se guarda por carpeta -- así puedes tener distintos proyectos de Orquestra`)
+  console.log(`en distintos repos sin que se mezclen entre sí.`)
+  const folderAnswer = await prompt(
+    `¿A qué carpeta aplica? [Enter para usar la actual: ${process.cwd()}]\n` +
+    `(usa la carpeta contenedora, ej. la que junta varios repos de un mismo proyecto, si aplica): `
+  )
+  const expanded = folderAnswer.trim().startsWith('~')
+    ? folderAnswer.trim().replace('~', homedir())
+    : folderAnswer.trim()
+  const folderPath = expanded ? resolve(expanded) : process.cwd()
+
+  upsertProjectMapping({ apiBase, apiToken: token, workspaceId, folderPath, projectId: defaultProjectId })
+  console.log(`\nListo. "${folderPath}" (y sus subcarpetas) ya apunta a este proyecto -- guardado en ${CONFIG_PATH}.`)
   console.log('\nSiguiente paso -- conéctalo a tu agente de IA:\n')
   console.log('  Claude Code:')
   console.log('    claude mcp add orquestra -- npx orquestra-mcp\n')