orquestra-mcp 1.2.0 → 1.3.2

package/package.json

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

@@ -50,13 +50,14 @@ 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í -- 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.
+- Si es una idea nueva: llama a get_setup_guide y ofrece un playbook de etapa "pre" (get_stage_playbook + apply_stage_playbook) -- ahí sí basta con eso, el proyecto de verdad no tiene nada más que sincronizar todavía.
+- Si ya existe y está avanzado: NO te limites a update_project ni a las distributions -- eso es solo el primer paso, no el trabajo completo. Llama a get_setup_guide y recorre sus 9 pasos en orden real (estatus/flujo, categorías, infraestructura completa -- servicios Y entornos, no solo distribuciones --, módulos, tareas, ideas, notas, changelog, docs), usando list_* de cada uno antes de crear para no duplicar. No asumas ni dejes vacío lo que no puedas inferir del código -- pregúntale al usuario los servicios/entornos reales, los módulos o áreas de trabajo, y las tareas pendientes reales que tenga en mente. Ofrece el playbook de etapa "build" (no "pre") solo como plantilla de módulo+tareas inicial, no como sustituto de sincronizar el resto.
 
 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.
+- Si tienes acceso al repo real de una distribución (ej. puedes correr "git remote get-url origin" en ese código), llena repoUrl en create_distribution/update_distribution sin preguntar -- es solo informativo, no requiere credenciales. Esto es distinto de conectar el repo con PAT para el changelog automático (Workspace → Conexiones en orquestra-web): eso sí es un paso deliberado del usuario, con una credencial real -- nunca lo hagas tú solo ni sugieras que ya está conectado por haber llenado repoUrl.
 
 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.
 
@@ -68,7 +69,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
   }
 
@@ -488,6 +496,7 @@ export function createServer() {
     stack: z.array(z.string()).optional(),
     version: z.string().optional().describe('Versión en store'),
     reviewVersion: z.string().optional().describe('Build en revisión -- apps'),
+    repoUrl: z.string().optional().describe('URL del repo de este código (ej. de "git remote get-url origin") -- solo informativo, no requiere credenciales. Distinto de conectar el repo con PAT (eso es Workspace → Conexiones, un paso deliberado del usuario, nunca lo hagas solo).'),
   })
   registerUpdate('update_distribution', '/v1/distributions', 'Edita una distribución existente.', {
     label: z.string().optional(),
@@ -505,6 +514,7 @@ export function createServer() {
     stack: z.array(z.string()).optional(),
     version: z.string().optional(),
     reviewVersion: z.string().optional(),
+    repoUrl: z.string().optional().describe('URL del repo de este código -- solo informativo, no requiere credenciales.'),
   })
 
   // ═══ COMPUESTAS (nivel C) ═══════════════════════════════════════════════════

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')