orquestra-mcp 1.48.0 → 1.49.0

package/README.md

@@ -1,6 +1,7 @@
 # orquestra-mcp
 
-Servidor MCP (Model Context Protocol) para Orquestra. Expone **135 tools**
+Servidor MCP (Model Context Protocol) para Orquestra. Expone **144 tools**
+(conteo al 24 oct 2026, v1.49.0; la lista real está en `src/server.mjs`)
 que llaman a la API de `orquestra-infra`: lectura de contexto/dashboard/
 workspace/infra/paridad/listados, escritura de tareas/ideas/changelog/
 notas/docs/módulos/flujo/categorías/infra/proyectos, y corridas de QA —
@@ -47,7 +48,7 @@ vez de contra producción).
 
 ## Setup manual (alternativa, sin el flujo de navegador)
 
-Si preferís generar el token vos mismo en vez de usar `setup`:
+Si prefieres generar el token tú mismo en vez de usar `setup`:
 
 1. **Cuenta + workspace en `orquestra-web`**: entra a la app, si no tienes
    `workspaceId` te manda al wizard de onboarding.
@@ -75,7 +76,7 @@ Variables de entorno (todas opcionales si ya corriste `setup` — se leen de
 | `ORQUESTRA_API_TOKEN` | sí | — |
 | `ORQUESTRA_WORKSPACE_ID` | sí | — |
 | `ORQUESTRA_DEFAULT_PROJECT_ID` | no | — |
-| `ORQUESTRA_API_BASE` | no | `ApiBaseUrl` de producción |
+| `ORQUESTRA_API_BASE` | no | `https://api.orquestra.me` |
 | `ORQUESTRA_WEB_URL` (solo `setup`) | no | `https://app.orquestra.me` |
 
 ### Claude Code
@@ -152,23 +153,24 @@ Lectura de contexto:
 | `get_platform_playbook` | `platform` | Guía de referencia + checklist de publicación en tienda (`ios`\|`android`) — sin red |
 | `get_skills_catalog` | — | Catálogo de Claude Skills de terceros recomendadas — sin red |
 | `preview_skill` | `key?` / `sourceRepo?`+`sourcePath?` | Trae el SKILL.md real de una skill de terceros, sin instalar nada |
-| `install_skill` | `key?` / `sourceRepo?`+`sourcePath?`, `scope`, `confirmed` | Descarga e instala una skill en `.claude/skills/` — solo después de `preview_skill` + confirmación del usuario; además registra la instalación en Orquestra (best-effort) |
+| `install_skill` | `key?` / `sourceRepo?`+`sourcePath?`, `scope`, `confirmed` | Descarga e instala una skill en `.claude/skills/{key}/` de la carpeta actual (`scope:'project'`) o en `~/.claude/skills/{key}/` (`scope:'global'`) — solo después de `preview_skill` + confirmación del usuario; además registra la instalación en Orquestra (best-effort) |
 | `list_installed_skills` | `projectId?` | Registros reales de skills instaladas en el proyecto (colección `skills`, no el catálogo) |
 | `create_skill_install` / `update_skill_install` | ver server.mjs | Self-report manual de una skill instalada a mano, fuera del flujo de `install_skill` |
 | `get_setup_guide` | — | Orden recomendado (flujo→categorías→infra→módulos→tareas→ideas→notas→changelog→docs) para configurar/sincronizar sin duplicar — sin red |
 | `list_modules` / `list_statuses` / `list_categories` / `list_services` / `list_environments` / `list_distributions` | `projectId?` | Lista completa de cada entidad — revísalos antes de `create_*` para no duplicar (patrón upsert) |
 
 Creación (`create_*`) y edición (`update_*`) — mismo patrón en todos, solo
-crear/editar, sin `delete_*`:
+crear/editar (los únicos borrados acotados están en "Estado", abajo). Tabla
+parcial: la lista completa está en `src/server.mjs`:
 
 | Entidad | Tools | Notas |
 |---|---|---|
 | Tareas | `create_task`, `update_task` | `update_task` incluye `scope` — úsalo para resolver desfases de paridad |
 | Verificaciones por plataforma | `list_verifications`, `add_verification`, `update_verification`, `delete_verification`, `verify_with_agent` | Confirmaciones (humanas o de agente) de que la tarea quedó bien en web/iOS/Android/API — NO van en el checklist. La tarea no cierra con verificaciones abiertas y se cierra sola al aprobarse la última; `failed` (con `note`) la regresa a su estatus anterior. También: `verifications` en `create_task`, `waiveVerifications` en `update_task` (solo con confirmación del usuario) y `verificationId` en `create_agent_run` |
-| Ideas | `create_idea` | |
-| Changelog | `create_changelog_entry` | Estilo Keep a Changelog |
-| Notas | `create_note` | |
-| Docs | `create_doc` | |
+| Ideas | `list_ideas`, `create_idea`, `update_idea` | |
+| Changelog | `list_changelog`, `create_changelog_entry`, `update_changelog_entry` | Estilo Keep a Changelog |
+| Notas | `list_notes`, `create_note`, `update_note` | |
+| Docs | `create_doc`, `get_doc`, `update_doc` | |
 | Módulos | `create_module`, `update_module` | `scope` también editable |
 | Flujo (estatus) | `create_status`, `update_status` | `nextIds` define las transiciones válidas |
 | Categorías | `create_category`, `update_category` | |
@@ -181,7 +183,7 @@ Compuestas:
 | Tool | Args | Descripción |
 |---|---|---|
 | `init_project` | `name`, `description?`, `phase?`, `projectType?`, `distributions?`, `categories?` | Crea un proyecto nuevo en el workspace — categorías+distribuciones+flujo conectado en un paso |
-| `apply_stage_playbook` | `stageId`, `moduleName?`, `includeDates?` | Crea el módulo + todas las tareas de la plantilla de una etapa |
+| `apply_stage_playbook` | `stageId`, `moduleName?` | Crea el módulo + todas las tareas de la plantilla de una etapa |
 
 Los campos enum (`type`, `priority`, `status`, etc.) están fijos y
 documentados en el `inputSchema` de cada tool — el modelo los ve sin
@@ -227,7 +229,7 @@ create/update sigue siendo criterio del agente y del humano.
 
 ## Estado
 
-135 tools: lectura (contexto, dashboard, workspace, infra, paridad, standup,
+144 tools (ver arriba): lectura (contexto, dashboard, workspace, infra, paridad, standup,
 sync report, setup guide, playbooks de etapa y de plataforma, catálogo de
 skills, search) + `list_*` de cada colección + creación/edición de tareas
 (con checklist, verificaciones por plataforma, tiempo, adjuntos, merge), ideas (con comentarios), notas,
@@ -236,6 +238,8 @@ infraestructura, proyecto, contenido (canales, campañas, contenido,
 Postproxy), agentes, skills, sugerencias y vínculos entre ítems
 (`link_items`/`unlink_items`/`list_relations`) + compuestas (init_project,
 apply_stage_playbook, apply_platform_playbook, install_skill). Sin
-`delete_*` salvo adjuntos, ítems de checklist, verificaciones y vínculos
-(`unlink_items`). Publicado en npm como
+`delete_*` salvo adjuntos, ítems de checklist, verificaciones, vínculos
+(`unlink_items`) y el link del portal del cliente (`revoke_client_portal_link`).
+Comando extra de CLI (no tool): `npx orquestra-mcp vault sync <carpeta> [--apply]`
+(base de conocimiento ↔ vault de Obsidian). Publicado en npm como
 `orquestra-mcp` (unscoped) -- `npx orquestra-mcp setup`.

package/package.json

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

@@ -89,7 +89,7 @@ const SETUP_GUIDE = {
     { step: 6, section: 'Ideas', check: 'list_ideas', createOrUpdate: 'create_idea / update_idea / convert_idea_to_task', 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' },
+    { step: 9, section: 'Docs', check: 'search', createOrUpdate: 'create_doc / update_doc (get_doc para leer el texto completo)', matchBy: 'title' },
   ],
 }
 
@@ -2335,6 +2335,36 @@ export function createServer() {
     }
   )
 
+  // Editar docs (ORQ-409): get_doc trae el texto completo (search solo da fragmentos) para que
+  // update_doc no pise el contenido con una versión recortada.
+  server.registerTool(
+    'get_doc',
+    {
+      description: 'Lee un documento completo del proyecto (contenido, tipo, carpeta, módulo, visibilidad). Úsala antes de update_doc: content se reemplaza entero, así que parte del texto actual. El id sale de search (types=["doc"]).',
+      inputSchema: { projectId: z.string().optional().describe(PROJECT_ID_DESC), id: z.string() },
+    },
+    async ({ projectId, id }) => {
+      try { return textResult(await apiGet(config, `/v1/docs/${id}`, { projectId: resolveProjectId(projectId) })) } catch (err) { return errorResult(err) }
+    }
+  )
+
+  registerUpdate('update_doc', '/v1/docs',
+    '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.'),
+      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\'.'),
+      adrConsequences: z.string().optional().describe('Solo para type=\'adr\'.'),
+      moduleId: z.string().optional(),
+      folder: z.enum(DOC_FOLDERS).optional(),
+      visibility: z.enum(DOC_VISIBILITY).optional().describe('"team" | "workspace" | "public" (expone el doc sin sesión).'),
+      reviewOwnerUid: z.string().optional(),
+      reviewIntervalDays: z.number().optional(),
+    }
+  )
+
   // ═══ ESCRITURA (nivel B -- módulos, flujo, categorías, infra) ═══════════════
 
   const SCOPE_SCHEMA = z.array(z.object({ distId: z.string(), layer: z.string().optional(), done: z.boolean().optional(), ...SCOPE_EVIDENCE })).optional()