sync-models

Sync Models — Mantenimiento de la metadata del MCP

Esta skill es la herramienta de mantenimiento del catálogo de modelos del plugin fs-mcp. Úsala cuando:

• Quieras añadir un modelo nuevo del core de FacturaScripts o de un plugin privado.
• Hayas actualizado FacturaScripts (o un plugin) y quieras revisar si algún modelo ya configurado tiene columnas nuevas, modificadas o eliminadas.
• Quieras hacer un refresh masivo de todos los modelos del catálogo y actualizar la versión registrada del core.

La skill respeta la separación entre core y privados:

• Core → modifica archivos del repo del MCP (server/src/...) y compila.
• Privados → modifica archivos en la ruta privada del usuario (<outputBase>/...); no compila (los privados se cargan dinámicamente al arrancar el servidor).

---

Cómo invocar

El usuario te indicará tres datos por cada modelo:

1. Nombre del modelo en snake_case (ej: cliente, factura_cliente, task).
2. Tipo: core o private.
3. Origen (de dónde leer la fuente):
   • Ruta local absoluta: ej. /Users/yo/facturascripts o /Users/yo/facturascripts/Plugins/Forja.
   • URL de GitHub: ej. https://github.com/NeoRazorX/facturascripts o de un plugin.

Ejemplos de invocación habituales:

• Revisa el modelo cliente del core, fuente /Users/yo/facturascripts
• Revisa los modelos cliente, producto y factura_cliente, todos en /Users/yo/facturascripts
• Revisa task y publication, ambos privados, en /Users/yo/facturascripts/Plugins/Forja
• Revisa task del plugin privado en https://github.com/X/Forja
• Refresca todos los modelos del core desde /Users/yo/facturascripts y actualiza la versión

Si el usuario no aporta alguno de los tres datos, pregúntale antes de continuar.

---

Conceptos previos

Lo primero que debes hacer es familiarizarte con el estado actual del MCP si no lo has hecho ya:

Archivo	Rol
server/src/scripts/generate-metadata.ts	Genera la metadata (modo CORE y modo PLUGIN). Contiene MODEL_CATALOG con los modelos del core.
server/src/metadata/descriptions-overrides.json	Descripciones contextuales del core. Single source of truth (committed).
server/src/metadata/models/*.ts	Metadata generada por modelo (CORE). No editar a mano.
server/src/metadata/index.ts	Agregador auto-generado.
<outputBase>/manifest.json	Manifest del plugin privado (declara los modelos del plugin). Siempre se llama manifest.json, nunca manifest-nombre.json.
<outputBase>/descriptions.json	Descripciones del plugin privado. Siempre se llama descriptions.json, nunca nombre-descriptions.json.
<outputBase>/<modelo>/metadata.js	Metadata generada del modelo privado. No editar a mano.
<outputBase>/<modelo>/index.js	Loader del módulo privado. Re-exporta modelMetadata desde ./metadata.js.