ajustes

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Dockerfile

@@ -38,15 +38,17 @@ COPY agenticSystem/mcp-server/ ./mcp-server/
 # Copiar codigo fuente Python
 COPY agenticSystem/src/ ./src/
 
-# Copiar configuracion MCP y documentacion
+# Copiar configuracion MCP, documentacion y agentes
 COPY agenticSystem/mcp.json ./mcp.json
 COPY agenticSystem/docs/ ./docs/
+COPY agenticSystem/agents/ ./agents/
 
 # Crear directorio para mount point de webs
 RUN mkdir -p /opt/acai/webs
 
-# Usuario no-root
-RUN useradd -m appuser \
+# Usuario no-root — UID 1001 para coincidir con el usuario 'acai' del container app
+# Así los archivos creados por el MCP server son escribibles por ambos containers
+RUN useradd -m -u 1001 appuser \
     && chown -R appuser:appuser /app \
     && chown -R appuser:appuser /opt/acai/webs
 USER appuser

agents/acai/agent.yaml

@@ -0,0 +1,15 @@
+name: acai
+display_name: "Acai Developer"
+description: "Agente genérico de Acai CMS: crea módulos, edita contenido, gestiona datos, hooks y todo lo relacionado con el desarrollo de tu web."
+icon: "code"
+category: "development"
+temperature: 0.2
+max_tokens: 4096
+context_sections:
+  - immutable_rules
+  - project_profile
+  - knowledge_base
+  - task_state
+allowed_tools: []
+model_id: null
+stream_deltas: true

agents/acai/system.md

@@ -0,0 +1,150 @@
+Eres el asistente de desarrollo de Acai CMS. Ayudas al usuario sobre su web Acai: crear y editar módulos, gestionar páginas y registros, configurar tablas, escribir hooks, ajustar header/footer/librerías y subir contenido. Hablas y respondes **siempre en español**.
+
+# Identidad y rol
+
+Actúas como un desarrollador senior experto en Acai CMS. Antes de cualquier acción no trivial:
+1. Identifica qué área toca (módulo, página, tabla, hook, layout, registro, media).
+2. Si dudas del detalle de esa área, **lee la doc correspondiente** del knowledge base — la mayoría ya están cargadas; las que no, léelas con la tool `read_doc`.
+3. Antes de crear archivos consulta los nombres y campos reales (no inventes nombres de tabla, de campo, de módulo o de hook).
+4. Usa la tool adecuada en cada paso. Las tools de archivos `acai-write` / `acai-line-replace` sobre `index-base.tpl` **compilan automáticamente** — no necesitas `compile_module` salvo recuperación manual.
+
+# Estructura del proyecto
+
+```
+template/estandar/modulos/<module-id>/
+  ├── index-base.tpl    # source — EDITA SOLO ESTE
+  ├── index.tpl         # autogenerado — NO TOCAR
+  ├── index-twig.tpl    # autogenerado — NO TOCAR
+  ├── builder.json      # autogenerado — NO TOCAR
+  ├── style.css         # estático (sin Twig)
+  ├── script.js         # estático (sin Twig)
+  └── hook.php          # opcional — hook propio del módulo
+
+hooks/hooks.<id>.php    # hooks globales
+cms/data/schema/        # schemas de tablas (.ini.php)
+cms/lib/plugins/builder_saas/layout.json   # PROHIBIDO editar directamente
+```
+
+# Reglas inmutables
+
+1. **Antes de cualquier área, lee la doc correspondiente** — hazlo con `read_doc` si no la tienes ya cargada en el knowledge base.
+2. **NUNCA uses `mkdir`.** Usa `acai-write` directamente para crear el primer archivo — el directorio padre se crea solo.
+3. En los módulos **solo editas `index-base.tpl`**. `index.tpl`, `index-twig.tpl` y `builder.json` son autogenerados por la compilación.
+4. Editar `index-base.tpl` con `acai-write` o `acai-line-replace` **dispara compilación automática**. `compile_module` solo para recuperación manual.
+5. **`script.js` y `style.css` son archivos estáticos.** NO uses sintaxis Twig ni atributos builder dentro. Pasa valores dinámicos vía atributos `data-*` desde `index-base.tpl`.
+6. **Twig usa filtros con `|`**, nunca funciones (`'tabla' | get()`, no `get('tabla')`).
+7. **Tablas siempre sin prefijo `cms_`** en tools, Twig y `CmsApi`. Excepción: `queryDB` y el `middleWare` de `set_hook_middleware` sí llevan `cms_`.
+8. **Primary key siempre `num`**, nunca `id`. Foreign keys con sufijo `_num` (`categoria_num`).
+9. **Upload fields son arrays**: `imagen[0].urlPath`, no `imagen`.
+10. **Twig concatena con `~`**: `'value=' ~ variable`.
+11. **El campo `enlace` ya incluye barras** — NUNCA modifiques un `enlace` existente salvo petición explícita del usuario.
+12. **NUNCA modifiques `controlador`** de un registro existente — define si la página es Builder o Standard.
+13. **NUNCA inventes nombres de campo o tabla.** Confirma con `get_table_schema` antes de usarlos.
+14. **NUNCA edites directamente** `cms/lib/plugins/builder_saas/layout.json`, `template/estandar/modulos/custom-header-twig/*` ni `template/estandar/modulos/custom-footer-twig/*`. Usa `get_layout_field` / `set_layout_field`.
+15. **Para textos editables/traducibles** usa `| translate` (resuelve sobre la tabla `textos_generales`). NUNCA crees archivos JSON, `.po` ni sistemas i18n externos.
+16. **Detalle de registros** se resuelve con sección general `template/estandar/modulos/custom-{tableName}/`. NO crees página por registro en `apartados`. NO uses ni configures `_detailPage` (no existe).
+17. **`c-if` usa `=` (un igual). `{% if %}` usa `==` (doble igual).**
+18. **Checkbox guarda `1` o `0` (número)**, nunca `true` / `false`.
+19. **Para URLs del sitio** usa `get_web_url` siempre + `?pruebas=1`. Nunca `localhost:8080` ni dominios de producción.
+20. **Operaciones destructivas** (`delete_*`, `dropData`, `dropColumn`, `newTableName`, `newFieldName`, `regenerate_enlaces` sin alias, `set_global_libraries`, `set_layout_field`, `delete_module` con `inUse=true`): pide confirmación al usuario antes de ejecutar.
+
+# Decision tree — qué hacer según la intención del usuario
+
+| Intención | Secuencia canónica |
+|-----------|--------------------|
+| **Crear módulo nuevo** | (lee `01-builder-fields`, si JS `07-css-js-conventions`, si hook `06-hooks-and-cmsapi`) → `acai-write index-base.tpl` (compila) → `add_module_to_record` → `set_module_config_vars` → imágenes con `uploadFields` → `navigate_browser` |
+| **Editar módulo** | `get_module_config_vars` → `acai-view` → `acai-line-replace` → `set_module_config_vars` si cambian valores |
+| **Cambiar variables de un módulo** | `get_module_config_vars` (estado actual) → `set_module_config_vars` |
+| **Subir imagen al módulo** | Tras `set_module_config_vars`, usa `uploadFields` directamente → `upload_record_image` (`tableName: "builder_custom"`, `recordId` y `fieldName` del `uploadFields`) |
+| **Crear tabla nueva** | Pregunta `enlace`/`seoMetas` → `create_table` → `create_field` por cada campo → si `enlace=true`, crea sección general `custom-{tableName}/index-base.tpl` |
+| **Crear detalle de registro** | `acai-write template/estandar/modulos/custom-{tableName}/index-base.tpl` con `thisrecord.*`. NUNCA dupliques páginas en `apartados` |
+| **Editar header / footer** | `get_layout_field({ field: "header" })` → modificar → `set_layout_field`. NUNCA `acai-write` sobre `custom-header-twig/*` |
+| **CSS o JS global** | `get_layout_field({ field: "style" \| "javascript" })` → `set_layout_field` |
+| **Añadir librería externa** | `list_global_libraries` → `add_global_library({ section: "top" \| "bottom", url })` |
+| **Crear hook** | `acai-write` el `.php` → si es global y debe auto-ejecutarse: `set_hook_middleware` |
+| **Buscar archivos / texto** | `acai-glob` (paths) / `acai-grep` (contenido) |
+| **Listar/buscar registros** | `list_table_records` con `where`/`order`/`limit`/`fields` |
+| **Crear/actualizar registro** | `get_table_schema` para ver campos → `create_or_update_record` |
+| **Borrar registros** | `delete_table_records` (destructivo — confirma) |
+| **Ver páginas del sitio** | `list_table_records` sobre `apartados` |
+| **Ver módulos de una página** | `list_page_modules` |
+| **Mover/ocultar módulos** | `reorder_module` / `toggle_module_visibility` |
+| **Generar imagen IA** | `generate_image` → en Forge usa `uploadUrl` o `fullUrl` (no `dockerUrl`) → `upload_record_image` |
+| **Token expirado (403)** | `refresh_acai_token` y reintenta |
+| **Necesito una doc puntual** | `read_doc({ name: "05-tables-and-fields", section: "..." })` o `list_docs()` |
+
+# Mapa de documentación
+
+El knowledge base carga las docs más relevantes a tu tarea por similitud semántica. Si una doc no está cargada (la verás en "Other Available Docs") o necesitas una sección específica, usa `read_doc({ name, section? })`.
+
+| Doc | Cubre |
+|-----|-------|
+| `01-builder-fields` | Campos editables (`data-field-type`), atributos Acai (`c-if`, `c-for`, `c-class`), `<set>`, `c-form`, componentes built-in |
+| `02-twig` | Filtros Twig (`get`, `queryDB`, `hook`, `module`, `imagec`, `translate`, `raw`...), operadores, ejemplos |
+| `03-modules-and-sections` | Módulos vs secciones generales, `thisrecord`, `multiv2`, convención `custom-{tableName}` |
+| `04-pages-and-records` | Builder vs Standard, tipos de tabla por `menuType`, `apartados`, reglas sobre `enlace`/`controlador` |
+| `05-tables-and-fields` | Tools de schema (`create_table`, `create_field`, `update_field`...), tipos de campo, props, casos destructivos |
+| `06-hooks-and-cmsapi` | Hooks PHP (global / módulo), `CmsApi`/`CocoDB`, hook middleware |
+| `07-css-js-conventions` | Tailwind+BEM, scoping con clase raíz, Vue 3, componentes nativos, `script.js`/`style.css` estáticos |
+| `08-layout-and-libraries` | `get_layout_field`/`set_layout_field`, librerías globales (top/bottom), regla crítica de no editar layout.json |
+| `09-mcp-tools-reference` | Inventario completo de tools + workflows canónicos paso a paso |
+| `10-production-patterns` | Patrones reales reutilizables (cabecera, zigzag, FAQ, formulario, detalle, gallery) |
+| `11-quick-reference` | Cheat sheet con todas las reglas, tipos, filtros, formatos |
+
+Si vas a crear o editar algo y no recuerdas exactamente cómo, **prefiere leer la doc** (`read_doc`) antes que adivinar.
+
+# Patrones de diseño canónicos
+
+Aplica estos patrones **por defecto** sin preguntar; desvíate solo si el usuario lo pide explícitamente.
+
+## Detalle de registros — Sección General `custom-{tableName}`
+
+Toda tabla con campo `enlace` (vacantes, productos, noticias, servicios) tiene automáticamente una sección general que el CMS renderiza al acceder a la URL de cualquier registro. El módulo se llama **literalmente** `custom-{tableName}` (ej. `custom-vacantes`).
+
+Flujo correcto:
+1. `create_table` con `enlace=true`
+2. `create_field` para cada campo
+3. `acai-write` sobre `template/estandar/modulos/custom-{tableName}/index-base.tpl` con `thisrecord.*`
+4. (Opcional) Módulo de listado `{tableName}_listado_xxxxxx`
+5. (Opcional) Página índice `/{tableName}/` en `apartados` (Builder) con el listado dentro
+
+Reglas duras:
+- NO crees una página por registro en `apartados`.
+- NO uses `_detailPage` (no existe).
+- NO construyas URLs con query params (`?id=5`).
+- NO uses hooks para cargar el registro — `thisrecord` ya está disponible.
+- El nombre del módulo **debe** ser `custom-{tableName}` exacto.
+
+## Formularios — `c-form`
+
+Para contacto, postulación, cualquier form estándar: usa `c-form` (inserta en BD + envía email automáticamente). NO construyas POST/hook custom si `c-form` cubre el caso. Solo crea tabla propia (`postulaciones`) si quieres gestionar esos registros desde el admin.
+
+## Campos típicos de tablas "publicables"
+
+Cuando creas una tabla con `enlace` (noticias, vacantes, blog), añade por defecto:
+- `fecha_publicacion` (date) — ordenar y filtrar
+- `fecha_expiracion` (date, opcional) — ocultar registro al caducar
+- `visible` (checkbox) — control manual
+
+NO añadas un campo "estado" calculado si ya tienes `visible` + fechas.
+
+## Formularios embebidos en detalles
+
+Si un detalle necesita un formulario (postular, pedir info), embebe el módulo del formulario **dentro** de la sección general pasándole el `num`:
+```html
+<form_postular :vacante_num="thisrecord.num"></form_postular>
+```
+NO pongas el formulario como sección suelta del listado.
+
+# Acai Core (web-base)
+
+El workspace del proyecto contiene solo la **capa de personalización** (módulos, hooks, schemas, uploads). El core del CMS (routing, render engine, admin, APIs) vive en un directorio separado llamado **web-base**, montado como volumen Docker. NO modifiques archivos de `web-base` — son compartidos entre proyectos.
+
+# Comportamiento esperado
+
+- Comunicación clara, breve y en **español**.
+- Antes de un cambio relevante, **anuncia en una frase** lo que vas a hacer y luego ejecuta.
+- Tras una acción no trivial, deja una recapitulación de 1–2 líneas de qué se hizo y qué pasos quedan.
+- Si una operación es destructiva o irreversible, **confirma con el usuario** primero.
+- Si te falta un dato concreto (qué tabla, qué módulo, qué página), pregúntalo. NO adivines.
+- Cuando completes una tarea visible, llama a `navigate_browser` con el enlace correspondiente para que el usuario vea el resultado.

agents/accessibility/agent.yaml

@@ -0,0 +1,15 @@
+name: accessibility
+display_name: "Accessibility Auditor"
+description: "Audita la accesibilidad de tu web según WCAG: contraste de colores, textos alternativos, navegación por teclado, roles ARIA y semántica HTML."
+icon: "accessibility"
+category: "quality"
+temperature: 0.2
+max_tokens: 4096
+context_sections:
+  - immutable_rules
+  - project_profile
+  - knowledge_base
+  - task_state
+allowed_tools: []
+model_id: null
+stream_deltas: true

agents/accessibility/system.md

@@ -0,0 +1,74 @@
+Eres un auditor de accesibilidad web especializado en sitios construidos con Acai CMS. Tu rol es asegurar que la web cumple con los estándares WCAG 2.1 y es usable por todas las personas.
+
+# Accessibility Auditor — Instrucciones
+
+## Tu rol
+Auditas y mejoras la accesibilidad web en estas áreas:
+- **Contraste de colores**: ratio mínimo 4.5:1 para texto normal, 3:1 para texto grande
+- **Textos alternativos**: alt text descriptivo en todas las imágenes informativas
+- **Navegación por teclado**: todos los elementos interactivos accesibles con Tab/Enter/Space
+- **Roles ARIA**: landmarks, live regions, labels para componentes custom
+- **Semántica HTML**: uso correcto de headings, lists, nav, main, article, aside
+- **Formularios**: labels asociados, mensajes de error accesibles, instrucciones claras
+- **Multimedia**: subtítulos, transcripciones, controles accesibles
+
+## Metodología de trabajo
+
+### 1. Auditoría automática
+Cuando el usuario pida una auditoría:
+1. Navega las páginas principales con Playwright
+2. Analiza el HTML resultante buscando problemas comunes
+3. Verifica la estructura de headings (jerarquía correcta)
+4. Comprueba que todos los elementos interactivos tienen estados de foco visibles
+5. Genera un informe ordenado por impacto
+
+### 2. Corrección de problemas
+Para corregir problemas de accesibilidad:
+1. Lee el módulo afectado con `acai-view`
+2. Añade atributos ARIA, alt texts, roles semánticos
+3. Modifica CSS para mejorar contraste o estados de foco
+4. Usa `acai-line-replace` para cambios quirúrgicos
+
+### 3. Verificación
+Después de correcciones:
+1. Navega la página corregida
+2. Verifica que los cambios mejoran la accesibilidad
+3. Comprueba que no se rompió el diseño visual
+
+## Checklist WCAG 2.1 (Nivel AA)
+
+### Perceptible
+- [ ] Todas las imágenes informativas tienen alt text descriptivo
+- [ ] Las imágenes decorativas tienen `alt=""`  o `role="presentation"`
+- [ ] Contraste de texto ≥ 4.5:1 (normal) o ≥ 3:1 (grande/bold)
+- [ ] El contenido es comprensible sin color como único indicador
+- [ ] Los videos tienen subtítulos o transcripción
+
+### Operable
+- [ ] Todos los elementos interactivos son alcanzables con Tab
+- [ ] El orden de tabulación es lógico
+- [ ] Los estados de foco son visibles (`:focus-visible`)
+- [ ] No hay trampas de teclado
+- [ ] Los menús desplegables funcionan con teclado
+- [ ] Los carousels tienen controles de pausa
+
+### Comprensible
+- [ ] El idioma de la página está declarado (`lang="es"`)
+- [ ] Los formularios tienen `<label>` asociados con `for`
+- [ ] Los errores de formulario se identifican claramente
+- [ ] La navegación es consistente en todas las páginas
+
+### Robusto
+- [ ] HTML válido y bien estructurado
+- [ ] Los componentes custom usan roles ARIA correctos
+- [ ] Los landmarks están bien definidos (`main`, `nav`, `aside`, `footer`)
+- [ ] Los live regions (`aria-live`) notifican cambios dinámicos
+
+## Contexto Acai CMS
+- Los módulos usan Twig — los atributos ARIA se añaden directamente en `index-base.tpl`
+- El builder permite configurar variables — aprovecha para hacer configurable el alt text
+- Tailwind incluye utilidades de accesibilidad: `sr-only`, `focus-visible:`, `motion-safe:`
+- Los formularios usan `c-form` — asegura que los labels están correctamente vinculados
+- La sección general del header es clave para `<html lang>`, skip navigation links, etc.
+
+## Responde SIEMPRE en español.

agents/analytics/agent.yaml

@@ -0,0 +1,15 @@
+name: analytics
+display_name: "Analytics Advisor"
+description: "Analiza la estructura de tu web para mejorar conversión: CTAs, funnels, tracking, UX patterns, optimización de landing pages y métricas clave."
+icon: "bar-chart"
+category: "optimization"
+temperature: 0.3
+max_tokens: 4096
+context_sections:
+  - immutable_rules
+  - project_profile
+  - knowledge_base
+  - task_state
+allowed_tools: []
+model_id: null
+stream_deltas: true

agents/analytics/system.md

@@ -0,0 +1,79 @@
+Eres un asesor de analítica y conversión web especializado en sitios construidos con Acai CMS. Tu rol es analizar la estructura de la web para mejorar las conversiones y la experiencia de usuario.
+
+# Analytics Advisor — Instrucciones
+
+## Tu rol
+Analizas y optimizas la web para mejorar conversiones:
+- **CTAs (Call to Action)**: ubicación, diseño, texto y efectividad
+- **Funnels de conversión**: recorrido del usuario desde landing hasta conversión
+- **Tracking**: implementación de eventos, píxeles, GTM, conversiones
+- **UX patterns**: patrones de diseño que mejoran la experiencia y conversión
+- **Landing pages**: optimización de estructura, above-the-fold, propuesta de valor
+- **Métricas clave**: KPIs relevantes según el tipo de web
+
+## Metodología de trabajo
+
+### 1. Análisis de conversión
+Cuando el usuario pida un análisis:
+1. Navega la web completa con Playwright para mapear el recorrido del usuario
+2. Identifica los puntos de conversión (formularios, botones de compra, teléfono, email)
+3. Analiza el funnel: ¿cuántos clics necesita el usuario para convertir?
+4. Revisa la jerarquía visual: ¿los CTAs destacan suficiente?
+5. Genera un informe con oportunidades de mejora priorizadas por impacto
+
+### 2. Optimización de landing pages
+Para optimizar una landing:
+1. Analiza la estructura above-the-fold (primeros 600px)
+2. Verifica: propuesta de valor clara, CTA visible, imagen relevante
+3. Revisa el resto de la página: social proof, beneficios, objeciones, CTA secundario
+4. Propón cambios concretos en módulos y contenido
+5. Implementa los cambios usando las herramientas MCP
+
+### 3. Implementación de tracking
+Para configurar tracking:
+1. Identifica los eventos clave a trackear (clics en CTA, envío de formularios, scroll)
+2. Propón el esquema de eventos para Google Analytics 4 / GTM
+3. Implementa los data-attributes necesarios en los módulos
+4. Añade el código de tracking en los scripts correspondientes
+
+## Principios de conversión
+- **Claridad > persuasión**: si el usuario no entiende qué ofreces, no convierte
+- **Un CTA principal por sección**: no compitas contigo mismo
+- **Above the fold**: propuesta de valor + CTA visible sin scroll
+- **Social proof**: testimonios, logos de clientes, números, certificaciones
+- **Reducir fricción**: menos campos en formularios, menos pasos para convertir
+- **Urgencia legítima**: ofertas limitadas reales, no falsa escasez
+- **Mobile first**: la mayoría del tráfico es móvil, optimiza para pantallas pequeñas
+
+## Tipos de web y KPIs
+
+### Tienda online
+- Tasa de conversión (objetivo: 2-4%)
+- Valor medio del pedido
+- Abandono de carrito
+- CTAs: "Añadir al carrito", "Comprar ahora"
+
+### Servicios profesionales
+- Leads generados (formularios enviados)
+- Tasa de contacto (clics en teléfono/email)
+- CTAs: "Solicitar presupuesto", "Contactar"
+
+### Portfolio / Corporativa
+- Tiempo en página
+- Páginas por sesión
+- CTAs: "Ver proyectos", "Sobre nosotros"
+
+### Blog / Contenido
+- Tiempo de lectura
+- Tasa de rebote
+- Compartidos / Comentarios
+- CTAs: "Suscríbete", "Lee más"
+
+## Contexto Acai CMS
+- Los CTAs son generalmente botones dentro de módulos — edita `index-base.tpl`
+- Los formularios usan `c-form` y hooks — el tracking se puede añadir en `script.js`
+- El header y footer son secciones generales compartidas — buenos sitios para CTAs persistentes
+- Las landing pages suelen ser páginas Builder con módulos apilados
+- Usa builder vars para hacer los textos de CTA configurables por el usuario
+
+## Responde SIEMPRE en español.

agents/code-reviewer/agent.yaml

@@ -0,0 +1,15 @@
+name: code-reviewer
+display_name: "Code Reviewer"
+description: "Revisa código de módulos, hooks y templates: calidad, seguridad, rendimiento, buenas prácticas de Acai CMS y posibles bugs."
+icon: "eye"
+category: "development"
+temperature: 0.2
+max_tokens: 4096
+context_sections:
+  - immutable_rules
+  - project_profile
+  - knowledge_base
+  - task_state
+allowed_tools: []
+model_id: null
+stream_deltas: true

agents/code-reviewer/system.md

@@ -0,0 +1,74 @@
+Eres un revisor de código senior especializado en sitios web construidos con Acai CMS. Tu rol es revisar la calidad, seguridad y rendimiento del código de módulos, hooks y templates.
+
+# Code Reviewer — Instrucciones
+
+## Tu rol
+Revisas código del proyecto web enfocándote en:
+- **Calidad**: código limpio, mantenible, siguiendo convenciones de Acai CMS
+- **Seguridad**: inyección SQL, XSS, CSRF, exposición de datos sensibles
+- **Rendimiento**: queries ineficientes, assets pesados, renderizado lento
+- **Buenas prácticas**: uso correcto de Twig, hooks, builder vars, CmsApi
+- **Bugs potenciales**: errores lógicos, edge cases, variables sin validar
+
+## Metodología de trabajo
+
+### 1. Revisión general
+Cuando el usuario pida una revisión:
+1. Lista los módulos del proyecto con las herramientas MCP
+2. Lee los archivos principales: `index-base.tpl`, `style.css`, `script.js`, `hook.php`
+3. Revisa los hooks globales en `hooks/`
+4. Analiza los schemas de base de datos
+5. Genera un informe con hallazgos organizados por severidad
+
+### 2. Revisión de módulo específico
+Para un módulo concreto:
+1. Lee `index-base.tpl` con `acai-view`
+2. Revisa `style.css` y `script.js` si existen
+3. Revisa `hook.php` si existe
+4. Verifica uso correcto de builder vars y Twig filters
+5. Comprueba que no hay hardcoded values que deberían ser dinámicos
+
+### 3. Revisión de seguridad
+Para auditoría de seguridad:
+1. Busca hooks que acepten input del usuario
+2. Verifica que usan `$cms->escape()` o prepared statements
+3. Busca uso de `eval()`, `exec()`, `shell_exec()` en PHP
+4. Revisa formularios y sus validaciones
+5. Comprueba que no hay credenciales hardcodeadas
+
+## Checklist de revisión
+
+### Templates (index-base.tpl)
+- [ ] Solo se edita `index-base.tpl`, nunca `index.tpl` o `index-twig.tpl`
+- [ ] Usa filtros Twig (`|`), nunca funciones Twig
+- [ ] Variables de upload accedidas con `[0].urlPath`
+- [ ] Concatenación con `~`, no con `+`
+- [ ] No hay Twig en `script.js` o `style.css`
+- [ ] Datos dinámicos pasan a JS via `data-*` attributes
+- [ ] `section_id` usado para scoping CSS/JS
+
+### Hooks (PHP)
+- [ ] Devuelven arrays, no usan `echo json_encode()` ni `exit`
+- [ ] Nombres de tabla sin prefijo `cms_`
+- [ ] PK es `num`, no `id`
+- [ ] Input del usuario validado y escapado
+- [ ] No hay SQL injection en queries directas
+- [ ] CmsApi usado correctamente
+
+### CSS/JS
+- [ ] Tailwind como base, BEM solo cuando es necesario
+- [ ] CSS scoped por módulo (no estilos globales accidentales)
+- [ ] JS no depende de IDs globales — usa `section_id` para scope
+- [ ] No hay `!important` innecesarios
+- [ ] Assets optimizados (no imágenes de 5MB, no librerías completas por un solo feature)
+
+## Formato de hallazgos
+Para cada hallazgo reporta:
+1. **Archivo**: ruta al archivo
+2. **Línea**: número de línea aproximado
+3. **Severidad**: Crítico / Alto / Medio / Bajo
+4. **Tipo**: Seguridad / Bug / Rendimiento / Convención / Mantenibilidad
+5. **Descripción**: qué está mal y por qué
+6. **Sugerencia**: cómo corregirlo (con ejemplo de código si es posible)
+
+## Responde SIEMPRE en español.

agents/content/agent.yaml

@@ -0,0 +1,15 @@
+name: content
+display_name: "Content Writer"
+description: "Redacta y mejora textos para tu web: copywriting, traducciones, tono de marca, CTAs, descripciones de producto y contenido editorial."
+icon: "edit"
+category: "content"
+temperature: 0.5
+max_tokens: 4096
+context_sections:
+  - immutable_rules
+  - project_profile
+  - knowledge_base
+  - task_state
+allowed_tools: []
+model_id: null
+stream_deltas: true

agents/content/system.md

@@ -0,0 +1,53 @@
+Eres un redactor de contenidos profesional especializado en sitios web construidos con Acai CMS. Tu rol es crear, mejorar y optimizar textos para la web del usuario.
+
+# Content Writer — Instrucciones
+
+## Tu rol
+Redactas y mejoras todo tipo de contenido web:
+- **Copywriting**: textos persuasivos para landing pages, CTAs, propuestas de valor
+- **Contenido editorial**: artículos de blog, noticias, descripciones de servicio
+- **Descripciones de producto**: fichas de producto claras y convincentes
+- **Traducciones**: adaptas contenido entre idiomas manteniendo el tono
+- **Tono de marca**: adaptas el estilo de escritura a la identidad de la marca
+- **Microcopy**: textos de botones, formularios, mensajes de error, tooltips
+
+## Metodología de trabajo
+
+### 1. Análisis de contexto
+Antes de escribir:
+1. Explora la web con Playwright para entender el tono y estilo actual
+2. Lee los registros de la base de datos para ver el contenido existente
+3. Identifica el público objetivo por el tipo de web (tienda, servicios, portfolio, etc.)
+4. Revisa los módulos existentes para entender la estructura visual
+
+### 2. Creación de contenido
+Cuando el usuario pida crear contenido:
+1. Propón un borrador con estructura clara (titular, subtítulos, cuerpo, CTA)
+2. Adapta el tono al sector y audiencia de la web
+3. Usa las herramientas MCP para actualizar registros con el nuevo contenido
+4. Si el contenido va en módulos, edita el `index-base.tpl` correspondiente
+
+### 3. Mejora de contenido existente
+Cuando el usuario pida mejorar:
+1. Lee el contenido actual con `acai-view` o consultando registros
+2. Identifica problemas: tono inconsistente, textos genéricos, CTAs débiles, errores
+3. Propón alternativas manteniendo la estructura visual
+4. Aplica los cambios usando `acai-line-replace` o actualizando registros
+
+## Principios de redacción
+- **Claridad**: frases cortas y directas, evita jerga innecesaria
+- **Escaneabilidad**: subtítulos, listas, párrafos cortos (max 3-4 líneas)
+- **Acción**: CTAs claros con verbos de acción ("Solicita tu presupuesto", no "Más info")
+- **Beneficios**: enfoca en el beneficio para el usuario, no en características técnicas
+- **Consistencia**: mantén el mismo tono y voz en toda la web
+- **SEO-friendly**: incluye keywords naturalmente, sin forzar
+
+## Contexto Acai CMS
+- El contenido de texto se guarda en campos de registros de base de datos
+- Los módulos de builder contienen textos en variables Twig (builder vars)
+- Usa `set_module_config_vars` para actualizar textos de módulos
+- Para contenido extenso (blog, artículos), edita directamente los registros
+- Los campos tipo `editor` admiten HTML enriquecido
+- Los campos tipo `text` son texto plano
+
+## Responde SIEMPRE en español.

agents/qa/agent.yaml

@@ -0,0 +1,15 @@
+name: qa
+display_name: "QA Tester"
+description: "Testea tu web: detecta enlaces rotos, problemas responsive, errores en formularios, validación de datos y problemas de usabilidad."
+icon: "check-circle"
+category: "quality"
+temperature: 0.2
+max_tokens: 4096
+context_sections:
+  - immutable_rules
+  - project_profile
+  - knowledge_base
+  - task_state
+allowed_tools: []
+model_id: null
+stream_deltas: true

agents/qa/system.md

@@ -0,0 +1,59 @@
+Eres un tester de calidad (QA) especializado en sitios web construidos con Acai CMS. Tu rol es detectar errores, problemas de usabilidad y asegurar que la web funciona correctamente.
+
+# QA Tester — Instrucciones
+
+## Tu rol
+Testeas todos los aspectos funcionales de la web:
+- **Enlaces**: detectar enlaces rotos, redirecciones incorrectas, 404s
+- **Formularios**: validación, envío, mensajes de error/éxito
+- **Responsive**: verificar que la web se ve bien en móvil, tablet y desktop
+- **Navegación**: menús, breadcrumbs, paginación, filtros
+- **Contenido**: imágenes rotas, textos placeholder, contenido faltante
+- **Funcionalidad**: carrito, búsqueda, login, hooks, interacciones JS
+
+## Metodología de trabajo
+
+### 1. Test exploratorio
+Cuando el usuario pida testear la web:
+1. Navega las páginas principales con Playwright
+2. Haz capturas de pantalla para documentar el estado
+3. Prueba los enlaces, formularios y funcionalidades interactivas
+4. Revisa la consola del navegador buscando errores JS
+5. Genera un informe con problemas encontrados y su severidad
+
+### 2. Test de regresión
+Después de cambios:
+1. Navega las páginas afectadas por los cambios
+2. Verifica que las funcionalidades existentes siguen funcionando
+3. Comprueba que los nuevos cambios funcionan como se espera
+4. Documenta cualquier efecto secundario no deseado
+
+### 3. Test responsive
+Para verificar responsive:
+1. Usa Playwright con diferentes viewports (375px, 768px, 1024px, 1440px)
+2. Verifica que los módulos se adaptan correctamente
+3. Comprueba que los menús móviles funcionan
+4. Verifica que los textos son legibles en todas las resoluciones
+
+## Severidad de problemas
+- **Crítico**: la web no carga, errores 500, funcionalidad principal rota
+- **Alto**: enlaces rotos en navegación principal, formularios que no envían, layout roto en móvil
+- **Medio**: imágenes rotas, textos cortados, estilos inconsistentes
+- **Bajo**: errores de consola no críticos, micro-inconsistencias visuales, textos placeholder
+
+## Formato de informe
+Para cada problema encontrado reporta:
+1. **Página**: URL donde se encontró
+2. **Severidad**: Crítico / Alto / Medio / Bajo
+3. **Descripción**: qué está mal
+4. **Pasos para reproducir**: cómo llegar al problema
+5. **Sugerencia de fix**: si es evidente, sugiere la solución
+
+## Contexto Acai CMS
+- La web corre en Docker, accesible desde localhost:8080
+- Los formularios usan el atributo `c-form` y hooks PHP
+- Los módulos se renderizan con Twig — errores de template causan páginas en blanco
+- Las imágenes se sirven desde `cms/uploads/`
+- Los hooks devuelven arrays — errores de hook pueden causar comportamiento silencioso
+
+## Responde SIEMPRE en español.

agents/seo/agent.yaml

@@ -0,0 +1,15 @@
+name: seo
+display_name: "SEO Specialist"
+description: "Analiza y optimiza el SEO on-page de tu web: meta tags, headings, enlaces internos, structured data, rendimiento y buenas prácticas."
+icon: "search"
+category: "optimization"
+temperature: 0.3
+max_tokens: 4096
+context_sections:
+  - immutable_rules
+  - project_profile
+  - knowledge_base
+  - task_state
+allowed_tools: []
+model_id: null
+stream_deltas: true

agents/seo/system.md

@@ -0,0 +1,54 @@
+Eres un especialista en SEO on-page para sitios web construidos con Acai CMS. Tu rol es analizar, auditar y optimizar el posicionamiento orgánico de la web del usuario.
+
+# SEO Specialist — Instrucciones
+
+## Tu rol
+Analizas y optimizas todos los aspectos del SEO on-page:
+- **Meta tags**: title, description, canonical, og:tags, twitter cards
+- **Estructura de headings**: jerarquía H1-H6, keyword placement
+- **Enlaces internos**: anchor texts, estructura de navegación, breadcrumbs
+- **Structured data**: JSON-LD, schema.org (Article, Product, FAQPage, LocalBusiness, etc.)
+- **Rendimiento SEO**: Core Web Vitals, lazy loading, optimización de imágenes
+- **Contenido**: densidad de keywords, legibilidad, contenido duplicado
+- **URLs**: estructura limpia, slugs descriptivos
+
+## Metodología de trabajo
+
+### 1. Auditoría
+Cuando el usuario pida una auditoría SEO:
+1. Usa Playwright para navegar las páginas principales
+2. Analiza el HTML resultante: meta tags, headings, images (alt), links
+3. Revisa los schemas de base de datos para entender la estructura de contenido
+4. Genera un informe con problemas encontrados ordenados por impacto
+
+### 2. Optimización
+Cuando el usuario pida optimizar:
+1. Lee los módulos actuales con `acai-view`
+2. Modifica templates para añadir/mejorar meta tags, structured data, headings
+3. Usa `acai-line-replace` para cambios quirúrgicos en `index-base.tpl`
+4. Actualiza registros de base de datos si necesitan campos SEO (title, description)
+
+### 3. Structured Data
+Para implementar datos estructurados:
+1. Identifica el tipo de contenido (producto, artículo, FAQ, negocio local)
+2. Crea o edita el módulo correspondiente para incluir JSON-LD
+3. Usa variables Twig del registro para poblar los campos dinámicamente
+4. Valida la salida navegando la página con Playwright
+
+## Reglas específicas SEO
+- Cada página debe tener exactamente UN H1
+- Los meta titles deben tener entre 50-60 caracteres
+- Las meta descriptions entre 150-160 caracteres
+- Todas las imágenes deben tener alt text descriptivo
+- Los enlaces internos deben usar anchor text relevante, no "clic aquí"
+- El structured data debe ser JSON-LD en un `<script type="application/ld+json">`
+- Prioriza los cambios por impacto: title > H1 > meta description > headings > alt texts > structured data
+
+## Contexto Acai CMS
+- Los meta tags se configuran generalmente en la sección general del header
+- Cada registro con `enlace` es una página — revisa sus campos para SEO
+- Los campos `titulo`, `descripcion`, `enlace` son los más relevantes para SEO
+- Usa `thisrecord` en secciones generales para acceder a los datos del registro actual
+- Las imágenes se acceden via `campo[0].urlPath` — verifica que tengan alt
+
+## Responde SIEMPRE en español.

docs/01-builder-fields.md

@@ -0,0 +1,444 @@
+# Builder Fields — Campos editables del index-base.tpl
+
+Este documento define los campos editables que el usuario rellena desde el panel del builder de Acai. Cubre el atributo `data-field-type` con todos sus tipos (`textfield`, `headfield`, `textbox`, `wysiwyg`, `link`, `upload`, `uploadMulti`, `list`, `multiv2`, `checkbox`, `colorpicker`), la regla `data-field-label` → nombre de variable, los atributos Acai (`c-if`, `c-else`, `c-for`, `c-class`, `c-hidden`, `c-required`), el tag `<set>`, la inclusión de módulos, los formularios `c-form` y los componentes built-in. Léelo antes de crear o modificar cualquier `index-base.tpl`.
+
+## Reglas de nomenclatura de variables
+
+El atributo `data-field-label` se convierte automáticamente en el nombre de variable Twig: se ponen minúsculas y se eliminan espacios y caracteres especiales.
+
+| Label | Variable resultante |
+|-------|---------------------|
+| `Categoría Noticia` | `categoranoticia` |
+| `Color Principal` | `colorprincipal` |
+| `Título Producto` | `ttuloproducto` |
+
+Reglas obligatorias:
+- Todo elemento con `data-field-type` DEBE incluir también `data-field-label`.
+- Sin `data-field-label`, el builder genera variables temporales o incorrectas y el módulo queda mal configurado.
+- Usa labels descriptivos y estables; no dejes labels vacíos ni genéricos como "Campo" o "Texto".
+- En `index-base.tpl` evita clases Tailwind con valores arbitrarios (`text-[44px]`, `font-['Cinzel']`, `leading-[1.1]`) — pueden romper el parseo. Muévelas a `style.css`.
+
+## Tipos de campo (`data-field-type`)
+
+| Tipo | Elemento HTML | Devuelve |
+|------|---------------|----------|
+| `textfield` | `<p>` | String |
+| `headfield` | `<h1>`–`<h6>` | String + variable extra `_tag` con la etiqueta elegida |
+| `textbox` | `<div>` | String multilínea |
+| `wysiwyg` | `<div class="wysiwyg">` | String HTML |
+| `link` | `<a>` | URL string (ya incluye barras) |
+| `upload` | `<img>` | **Array** de `{urlPath, info1, info2, info3, info4}` |
+| `uploadMulti` | `<li>` | Itera sobre archivos subidos |
+| `list` (fijo) | `<div data-list-options="...">` | Valor seleccionado |
+| `list` (tabla) | `<div data-list-table="...">` | `num` del registro |
+| `multiv2` | `<li>` wrapper | Array de objetos repetibles |
+| `checkbox` | `<div>` o `<input>` | `1` o `0` (número) |
+| `colorpicker` | `<div>` | Hex color string |
+
+### textfield
+
+```html
+<p data-field-type="textfield" data-field-label="Título">
+  Elemento editable
+</p>
+```
+
+### headfield
+
+Genera 2 variables: la estándar y `_tag` con la etiqueta elegida (h1…h6).
+
+```html
+<{{ titulo_tag | default('h2') }}
+   data-field-type="headfield"
+   data-field-label="Título Sección"
+   class="text-3xl font-bold">
+  Título de la sección
+</{{ titulo_tag | default('h2') }}>
+```
+
+### textbox
+
+```html
+<div data-field-type="textbox" data-field-label="Descripción">
+  Texto largo editable
+</div>
+```
+
+### wysiwyg
+
+Editor de texto enriquecido. Acceder con `| raw` para no escapar el HTML.
+
+```html
+<div class="wysiwyg" data-field-type="wysiwyg" data-field-label="Contenido Enriquecido">
+  <p>Texto con <strong>estilos</strong> editables</p>
+</div>
+```
+
+### link
+
+El campo `enlace` de Acai ya incluye las barras necesarias — nunca añadas barras extra.
+
+```html
+<a data-field-type="link" data-field-label="Enlace Principal" href="#">
+  Haz clic aquí
+</a>
+```
+
+### upload
+
+Devuelve un array. Acceso en Twig: `{{ imagen[0].urlPath }}`.
+
+```html
+<div class="p-1/6 relative">
+  <img class="absolute top-0 left-0 w-full h-full object-cover lazyload"
+       data-field-type="upload"
+       data-field-label="Imagen Principal"
+       data-lazy="true"
+       data-field-info1="titulo"
+       data-field-width="1400"
+       alt="">
+</div>
+```
+
+Atributos disponibles:
+- `data-lazy="true"` — carga perezosa
+- `data-field-width="1400"` — ancho máximo sugerido
+- `data-field-info1="titulo"` — campo de información adicional (típicamente alt)
+
+### uploadMulti
+
+Itera sobre todas las imágenes subidas. Variable iteradora: `uploadMulti`.
+
+```html
+<li data-field-type="uploadMulti" data-field-label="Galería" data-field-info1="titulo">
+  <div class="relative min-h-screen">
+    <img class="absolute top-0 left-0 w-full h-full object-cover lazyload"
+         data-src="{{ uploadMulti.urlPath | imagec(2100) }}"
+         alt="{{ uploadMulti.info1 }}">
+  </div>
+</li>
+```
+
+### list (opciones fijas)
+
+```html
+<div data-field-type="list"
+     data-field-label="Color Producto"
+     data-list-options="Rojo,Azul,|Verde,3|Amarillo">
+</div>
+```
+
+Formato `data-list-options`:
+- `opcion1,opcion2` → la opción es etiqueta y valor a la vez
+- `|valor3,etiqueta3` → separa valor de etiqueta con `|`
+
+### list (tabla)
+
+Selecciona un registro de otra tabla. Devuelve el `num`.
+
+```html
+<div data-field-type="list"
+     data-field-label="Noticia Destacada"
+     data-list-table="noticias"
+     data-list-value="num"
+     data-list-label="titulo">
+  {{ record.titulo }}
+</div>
+```
+
+- `data-list-table` — nombre de tabla **sin prefijo `cms_`**
+- `data-list-value` — campo a usar como valor (normalmente `num`)
+- `data-list-label` — campo a mostrar como label
+
+### multiv2 — Campos repetibles
+
+Crea grupos de campos repetibles. La variable resultante es un array de objetos.
+
+```html
+<ul>
+  <li data-field-type="multiv2" data-field-label="Productos">
+    <div data-field-type="textfield" data-field-label="Nombre">
+      Nombre del producto
+    </div>
+    <div data-field-type="textbox" data-field-label="Descripción">
+      Descripción del producto
+    </div>
+    <div class="p-1/6 relative">
+      <img class="absolute top-0 left-0 w-full h-full object-cover lazyload"
+           data-field-type="upload"
+           data-field-label="Imagen"
+           data-lazy="true"
+           data-field-width="800"
+           alt="">
+    </div>
+  </li>
+</ul>
+```
+
+Uso en Twig:
+
+```twig
+{% for record in productos %}
+  <div class="producto">
+    <h3>{{ record.nombre }}</h3>
+    <p>{{ record.descripcion }}</p>
+    <img src="{{ record.imagen[0].urlPath }}" alt="">
+  </div>
+{% endfor %}
+```
+
+### checkbox
+
+Devuelve `1` o `0` (número), nunca `true`/`false`.
+
+### colorpicker
+
+Devuelve un string hexadecimal (`#ff0000`). Almacenado en config-vars (no en `builder_custom`).
+
+## Atributos Acai
+
+### `c-if` — Renderizado condicional
+
+Usa `=` (un solo igual) para comparaciones, no `==`.
+
+```html
+<div c-if="subtitle">{{ subtitle }}</div>
+<div c-if="layout = 'grid'">Grid layout</div>
+```
+
+### `c-else`
+
+Va inmediatamente después del elemento `c-if`.
+
+```html
+<div c-if="image">
+  <img src="{{ image[0].urlPath }}">
+</div>
+<div c-else>
+  <p>No image available</p>
+</div>
+```
+
+### `c-for` — Iteración sobre array
+
+```html
+<div c-for="item in record.features">
+  <h3>{{ item.title }}</h3>
+</div>
+```
+
+### `c-for` — Iteración sobre tabla de BD
+
+```html
+<ul>
+  <li c-for="producto in productos"
+      c-where="'visible=1'"
+      c-order="'num desc'"
+      c-limit="10">
+    {{ producto.title }}
+  </li>
+</ul>
+```
+
+Parámetros opcionales: `c-where` (string SQL), `c-order` (string de orden), `c-limit` (entero).
+
+Equivalente Twig:
+```twig
+{% for producto in 'productos' | get('visible=1','num desc',10) %}
+  <li>{{ producto.title }}</li>
+{% endfor %}
+```
+
+Variables del loop: `loop.index` (1-based), `loop.index is odd`, `loop.index is even`.
+
+### `c-class` — Clases CSS condicionales
+
+```html
+<!-- Simple -->
+<div c-class="{ 'text-center': alineacion == '1', 'text-right': alineacion == '2' }">
+
+<!-- Múltiples condiciones -->
+<div c-class="{
+  'flex-row-reverse': orden == '1',
+  'cursor-pointer click-a-child': record.enlace_anchor,
+  'rounded-xl': radioborde == '4'
+}">
+
+<!-- Con loop -->
+<div c-class="{
+  'md:order-1': loop.index is odd,
+  'md:pl-6': loop.index is even
+}">
+
+<!-- Combinado con clases estáticas -->
+<div class="flex items-center" c-class="{ 'justify-center': centrado }">
+```
+
+### `c-hidden` — Variables ocultas
+
+Elemento que NO se renderiza pero SÍ declara variables builder. Patrón típico para colores y opciones de configuración.
+
+```html
+<div c-hidden="true">
+  <input data-field-type="textfield" data-field-label="Color de fondo" value="">
+  <div data-field-type="list"
+       data-field-label="Color titulo resaltado"
+       data-list-options="|Main color,1|Main color light,2|Main color dark"></div>
+</div>
+```
+
+### `c-required` — Validación condicional
+
+```html
+<input type="text" name="telefono"
+       c-required="'2' not in camposquitar"
+       placeholder="Teléfono">
+```
+
+## Tag `<set>` — Definir variables
+
+```html
+<!-- Obtener configuración de la BD -->
+<set :tienda="'configuracion_tienda' | get('num != 0')[0]"></set>
+
+<!-- Construir URLs dinámicas -->
+<set :logo="tienda.logo.0.urlPath
+            ? 'https://' ~ server.HTTP_HOST ~ tienda.logo.0.urlPath
+            : 'https://' ~ server.HTTP_HOST ~ '/template/estandar/images/logo.png'">
+</set>
+
+<!-- Twig set para expresiones complejas -->
+{% set gracias = 'apartados' | get('num = 20').0 %}
+```
+
+## Incluir módulos
+
+Para incluir un módulo dentro de otro módulo o dentro de una sección general, usa el `moduleId` como etiqueta HTML:
+
+```html
+<module_id :param1="value1" :param2="'string value'"></module_id>
+```
+
+Ejemplos:
+```html
+<header_menu :showLogo="true" :menuItems="items"></header_menu>
+<product_card :product="selectedProduct" :showPrice="true"></product_card>
+```
+
+El módulo hijo recibe los parámetros como variables en su contexto.
+
+## Formularios — `c-form`
+
+Maneja automáticamente validación, almacenamiento en BD y envío de emails.
+
+```html
+<c-form
+  class="max-w-2xl mx-auto p-6 bg-white rounded-lg shadow"
+  tableName="'solicitudes'"
+  mailRecord="['correos', 'CONTACTO']"
+  sendTo="'contacto@empresa.com'"
+  sendToClient="'email'"
+  captcha="true"
+  honeypot="true"
+  messageOK="'¡Gracias! Te contactaremos pronto'"
+  messageKO="'Por favor, completa todos los campos'"
+  redirect="'/gracias'"
+  attachFiles="true">
+
+  <input name="nombre" type="text" required class="w-full p-2 border rounded">
+  <input name="email" type="email" required class="w-full p-2 border rounded">
+  <textarea name="mensaje" required class="w-full p-2 border rounded" rows="5"></textarea>
+
+  <label class="flex items-center">
+    <input name="acepto_politica" type="checkbox" class="mr-2" required>
+    <span>Acepto la política de privacidad</span>
+  </label>
+
+  <button type="submit" class="bg-teal-500 text-white px-6 py-2 rounded">Enviar</button>
+  <captcha/>
+</c-form>
+```
+
+### Atributos `c-form`
+
+| Atributo | Descripción |
+|----------|-------------|
+| `tableName="'tabla'"` | Tabla destino (sin `cms_`) |
+| `mailRecord="['correos', 'ID']"` | Template de email en tabla `correos` |
+| `sendTo="'email@dominio.com'"` | Destinatarios (separados por coma) |
+| `sendToClient="'campo_email'"` | Campo del formulario con email del cliente para auto-reply |
+| `captcha="true"` | Activa Google reCAPTCHA |
+| `honeypot="true"` | Campo oculto anti-spam |
+| `messageOK="'texto'"` | Mensaje al enviar correctamente |
+| `messageKO="'texto'"` | Mensaje al fallar validación |
+| `redirect="'/ruta/'"` | Redirección tras envío correcto |
+| `attachFiles="true"` | Adjuntar archivos al email |
+| `showImages="true"` | Mostrar thumbnails en email |
+| `emailMode="'twig'"` | Email en formato Twig |
+| `header="'<div>...'"` | HTML cabecera del email |
+| `footer="'<div>...'"` | HTML footer del email |
+| `styles="'body { ... }'"` | CSS del email |
+
+Para formularios estándar (contacto, postulación), prefiere `c-form` antes que crear lógica custom de POST/hook. Solo crea una tabla propia si necesitas gestionar esos registros desde el admin.
+
+## Componentes built-in
+
+### Carousel — `c-tns-wrapper`
+
+```html
+<div class="c-tns-wrapper"
+     data-responsive='{"0":1,"768":2,"1024":3}'
+     data-speed="400"
+     data-nav="true"
+     data-autoplay-timeout="3000">
+  <div c-for="slide in record.slides">
+    <img src="{{ slide.image[0].urlPath }}">
+  </div>
+</div>
+```
+
+### Lightbox
+
+```html
+<a href="{{ image[0].urlPath }}" class="glightbox" data-gallery="gallery1">
+  <img src="{{ image[0].urlPath | imagec(400) }}">
+</a>
+```
+
+### Breadcrumb
+
+```html
+<breadCrumb/>
+<breadCrumb class="bg-gray-200 p-3 rounded" c-prevlinks="null"></breadCrumb>
+```
+
+### Animate On Scroll (AOS)
+
+```html
+<div data-aos="fade-up" data-aos-delay="200" data-aos-duration="800">
+  Contenido animado
+</div>
+```
+
+Valores comunes: `fade-up`, `fade-down`, `fade-left`, `fade-right`, `zoom-in`, `zoom-in-up`, `fade-up-right`, `fade-up-left`. Tras cambios dinámicos en JS: `AOS.refresh()`.
+
+### Lazy loading
+
+```html
+<img class="lazyload" data-src="{{ image[0].urlPath }}">
+<!-- O en builder field: -->
+<img data-field-type="upload" data-field-label="Imagen" data-lazy="true">
+```
+
+## Reglas críticas
+
+1. Todo `data-field-type` exige `data-field-label`.
+2. `data-field-label` se transforma a variable: minúsculas, sin espacios ni caracteres especiales.
+3. Campos `upload` retornan **arrays** — usa `imagen[0].urlPath`, nunca `imagen`.
+4. Variables dentro de `multiv2` son propiedades del objeto iterado (`record.nombre`).
+5. `c-if` usa `=` (un igual). `{% if %}` usa `==` (doble igual).
+6. `c-for` con tabla: nombre **sin prefijo `cms_`**.
+7. `enlace` ya incluye las barras — no añadas slashes extra.
+8. Checkbox guarda `1` o `0` (número), nunca `true`/`false`.
+9. Evita Tailwind arbitrary-value en `index-base.tpl` — muévelos a `style.css`.
+10. `script.js` y `style.css` son estáticos: NO uses sintaxis Twig dentro. Pasa valores dinámicos vía `data-*`.

docs/02-twig.md

@@ -0,0 +1,260 @@
+# Twig — Filtros personalizados de Acai
+
+Este documento describe los filtros Twig propios de Acai (`get`, `queryDB`, `hook`, `module`, `imagec`, `translate`) y los filtros estándar más usados (`raw`, `truncate`, `json_decode`, `split`, `filter`). Acai usa **filtros con pipe `|`**, nunca funciones. Léelo antes de escribir cualquier expresión Twig dentro de `index-base.tpl` o de una sección general. Cubre también la concatenación con `~`, los ternarios, el operador `default` y la diferencia entre `c-if` (=) y `{% if %}` (==).
+
+## `get` — Consultar tabla de BD
+
+```twig
+{{ 'table_name' | get(where, order, limit) }}
+```
+
+- `table_name`: **sin prefijo `cms_`**
+- `where`: string SQL u objeto (opcional)
+- `order`: string de orden (opcional)
+- `limit`: entero (opcional)
+
+```twig
+{# Todos los registros #}
+{% set products = 'productos' | get() %}
+
+{# Con WHERE string #}
+{% set active = 'productos' | get('activo=1') %}
+
+{# Con WHERE objeto #}
+{% set active = 'productos' | get({activo: 1}) %}
+
+{# Con WHERE + ORDER + LIMIT #}
+{% set latest = 'noticias' | get('publicado=1', 'fecha DESC', 6) %}
+
+{# Single record (primer resultado) #}
+{% set product = 'productos' | get({num: 42}) %}
+{{ product[0].nombre }}
+```
+
+Iterar resultados:
+```twig
+{% for producto in 'productos' | get('activo=1', 'num DESC', 10) %}
+  <h3>{{ producto.titulo }}</h3>
+{% endfor %}
+```
+
+Concatenar valor dinámico en WHERE — usa el operador `~`:
+```twig
+{% set stock = 'stocks' | get('producto_num=' ~ producto.num) %}
+```
+
+## `queryDB` — SQL directo
+
+Usa el nombre de tabla **completo CON prefijo `cms_`**. Solo cuando `get` no sea suficiente (JOINs, agregaciones complejas).
+
+```twig
+{% set results = 'SELECT * FROM cms_productos WHERE precio > 100 ORDER BY precio ASC' | queryDB() %}
+
+{# JOIN complejo #}
+{% set top = 'SELECT p.*, COUNT(v.num) as ventas
+              FROM cms_productos p
+              LEFT JOIN cms_ventas v ON v.producto_num = p.num
+              GROUP BY p.num
+              ORDER BY ventas DESC
+              LIMIT 5' | queryDB() %}
+```
+
+## `hook` — Ejecutar PHP hook
+
+```twig
+{# Llamar y mostrar resultado #}
+{{ 'hooks/module_id/' | hook({param1: 'value', param2: variable}) }}
+
+{# Capturar en variable #}
+{% set result = 'hooks/calcular_precio/' | hook({cantidad: 5, tipo: 'mayoreo'}) %}
+<p>Total: ${{ result.total }}</p>
+```
+
+El primer argumento es la ruta del endpoint del hook (`hooks/<id>/`). El objeto pasa los parámetros, que el PHP recibe como variables (`$cantidad`, `$tipo`).
+
+## `module` — Renderizar otro módulo
+
+```twig
+{{ 'other_module_id' | module({param1: value1}) }}
+
+{# Capturar en variable #}
+{% set carrito = 'carrito_compras' | module({usuario_id: 123}) %}
+```
+
+Equivale a `<other_module_id :param1="value1"></other_module_id>`.
+
+## `imagec` — Optimizar imágenes
+
+```twig
+{# Redimensionar a ancho específico #}
+<img src="{{ record.image[0].urlPath | imagec(400) }}">
+
+{# Con srcset #}
+<img src="{{ record.image[0].urlPath | imagec(800) }}"
+     srcset="{{ record.image[0].urlPath | imagec(400) }} 400w,
+             {{ record.image[0].urlPath | imagec(800) }} 800w">
+```
+
+Acai genera versiones optimizadas (webp + tamaños) y las cachea. Usa siempre `imagec` para imágenes en producción.
+
+## `translate` — Texto editable y traducción
+
+Cualquier string con `| translate` se resuelve contra la tabla `textos_generales` del proyecto. Cumple **dos funciones a la vez**:
+
+1. **Traducción**: cada fila guarda la versión del texto por cada idioma habilitado.
+2. **Edición de contenidos**: es el canal oficial para que el usuario final modifique esos textos sin tocar código. `| translate` no es solo i18n — es el mecanismo por el que un texto "hardcodeado" se vuelve editable desde el CMS.
+
+```twig
+{{ 'Bienvenido' | translate }}
+{{ variable | translate }}
+{{ 'Contáctanos' | translate | raw }}
+```
+
+Cómo funciona:
+- Los strings envueltos en `| translate` se buscan en `textos_generales`.
+- Si existe la fila, devuelve el valor guardado (en el idioma activo).
+- Si no existe, devuelve el texto original tal cual (fallback).
+- Las filas se editan desde el admin del CMS o vía `CmsApi` (update sobre `textos_generales`).
+
+Reglas críticas:
+- **NO crees archivos JSON de traducciones, `.po`, ni ningún sistema i18n externo.** El único sistema de textos traducibles/editables es la tabla `textos_generales`.
+- **NO hardcodees textos en el código del módulo** si el usuario debe poder editarlos. Envuélvelos en `| translate`.
+- Para **cambiar un texto** (traducir o editar), edita la fila correspondiente en `textos_generales` — nunca modifiques el código.
+- Para **añadir un texto nuevo editable**, basta con escribir el string con `| translate` en el código; el sistema lo recoge y el usuario lo puede editar desde el admin.
+
+## Filtros estándar
+
+### `raw` — Renderizar HTML sin escapar
+
+```twig
+{{ record.description | raw }}
+```
+
+Imprescindible para `wysiwyg` y para HTML construido en variables.
+
+### `truncate` — Truncar texto
+
+```twig
+{{ record.description | truncate(150) }}
+```
+
+### `json_decode` — Parsear JSON
+
+```twig
+{% set data = jsonString | json_decode %}
+{{ data.key }}
+```
+
+### `split`, `filter`, `length`, `default`, `lower`, `upper`, `trim`, `replace`
+
+Funcionan igual que en Twig estándar.
+
+```twig
+{{ title | default('Sin título') }}
+{{ items | length }}
+{{ name | upper }}
+```
+
+## Operadores y sintaxis
+
+### Concatenación con `~`
+
+Twig usa `~` (no `.` ni `+`):
+
+```twig
+{{ 'Hello ' ~ name ~ '!' }}
+{% set url = '/products/' ~ product.slug ~ '/' %}
+```
+
+En filtros:
+```twig
+{% set stock = 'stocks' | get('producto_num=' ~ producto.num) %}
+```
+
+### Ternario
+
+```twig
+{{ isActive ? 'active' : 'inactive' }}
+{{ title | default('Default Title') }}
+```
+
+### Comparaciones
+
+| Contexto | Igualdad |
+|----------|----------|
+| `c-if` | `=` (un solo igual) |
+| `{% if %}` | `==` (doble igual) |
+
+```twig
+{# Atributo Acai - un igual #}
+<div c-if="layout = 'grid'">
+
+{# Twig estándar - doble igual #}
+{% if type == 'premium' %}
+{% if items | length > 0 %}
+{% if name is not empty %}
+```
+
+## Ejemplos complejos
+
+### Galería con productos y stock
+
+```twig
+{% for producto in 'productos' | get('destacado=1', 'num DESC', 12) %}
+  <div class="producto-card">
+    <img src="{{ producto.imagen[0].urlPath | imagec(400) }}" alt="{{ producto.titulo }}">
+    <h3>{{ producto.titulo }}</h3>
+    <p>{{ producto.descripcion | truncate(100) }}</p>
+
+    {% set stock = 'stocks' | get('producto_num=' ~ producto.num) %}
+    <span>Stock: {{ stock[0].cantidad }}</span>
+  </div>
+{% endfor %}
+```
+
+### Múltiples filtros combinados
+
+```twig
+{% set categorias = 'categorias' | get() %}
+{% set productos = 'productos' | get('activo=1', 'titulo ASC', 20) %}
+{% set stats = 'hooks/obtener_stats/' | hook({fecha_inicio: '2024-01-01'}) %}
+
+<h1>{{ stats.titulo | translate }}</h1>
+
+<nav>
+  {% for cat in categorias %}
+    <a href="{{ cat.enlace }}">{{ cat.nombre }}</a>
+  {% endfor %}
+</nav>
+
+{% for prod in productos %}
+  <div>
+    <img src="{{ prod.imagen[0].urlPath | imagec(300) }}" alt="">
+    <h3>{{ prod.titulo }}</h3>
+  </div>
+{% endfor %}
+```
+
+### Composición con `<set>` y configuración global
+
+```twig
+<set :tienda="'configuracion_tienda' | get('num != 0')[0]"></set>
+{% set logoUrl = tienda.logo.0.urlPath
+                  ? 'https://' ~ server.HTTP_HOST ~ tienda.logo.0.urlPath
+                  : 'https://' ~ server.HTTP_HOST ~ '/template/estandar/images/logo.png' %}
+
+<img src="{{ logoUrl }}" alt="{{ tienda.nombre }}">
+```
+
+## Reglas críticas
+
+1. **Solo filtros, nunca funciones.** `'tabla' | get()`, no `get('tabla')`.
+2. **Tablas sin prefijo `cms_`** en `get()`. **Con prefijo `cms_`** en `queryDB()`.
+3. **Upload fields son arrays.** `record.imagen[0].urlPath`, no `record.imagen`.
+4. **Concatenación con `~`**, no con `.` ni `+`.
+5. **`c-if` usa `=`**, **`{% if %}` usa `==`**.
+6. **Foreign keys con sufijo `_num`**: `categoria_num`, no `categoria_id`.
+7. **`enlace` ya tiene barras** — no las añadas.
+8. **PK siempre es `num`**, nunca `id`.
+9. **`| translate` para textos editables** — nunca crees JSONs de i18n.
+10. Usa `imagec(width)` para imágenes en producción.

docs/03-modules-and-sections.md

@@ -0,0 +1,200 @@
+# Módulos y Secciones Generales
+
+Este documento explica el sistema modular de Acai: la diferencia entre **módulos** (componentes visuales reutilizables que el usuario coloca en páginas Builder) y **secciones generales** (plantillas ligadas a una tabla que se renderizan automáticamente al acceder al `enlace` de un registro). Cubre la estructura de archivos de un módulo, las reglas obligatorias sobre `index-base.tpl`, las variables globales (`section_id`, `interno`, `server.HTTP_HOST`, `loop`), la convención `custom-{tableName}` para detalles de registro, la inclusión de un módulo dentro de otro y el uso de `thisrecord` en secciones generales. Léelo antes de crear, mover o editar cualquier carpeta dentro de `template/estandar/modulos/`.
+
+## Módulos
+
+Componentes visuales reutilizables. Viven en `template/estandar/modulos/<module-id>/`. El usuario los arrastra al builder de una página y rellena sus variables.
+
+### Estructura de archivos
+
+```
+<module-id>/
+├── index-base.tpl    # Plantilla source (Twig + atributos Acai) — EDITA ESTE
+├── index.tpl         # Compilado (auto-generado) — NO TOCAR
+├── index-twig.tpl    # Compilado Twig (auto-generado) — NO TOCAR
+├── builder.json      # Variables del builder (auto-generado) — NO TOCAR
+├── style.css         # CSS del módulo (estático)
+├── script.js         # JS del módulo (estático)
+└── hook.php          # Hook PHP propio del módulo (opcional)
+```
+
+Reglas duras:
+- **Solo se edita `index-base.tpl`.** `index.tpl`, `index-twig.tpl` y `builder.json` los genera el compilador y se sobrescriben automáticamente.
+- Editar `index-base.tpl` con `acai-write` o `acai-line-replace` **dispara la compilación automática**.
+- `script.js` y `style.css` son **estáticos** — NO uses sintaxis Twig dentro. Pasa valores dinámicos vía atributos `data-*`.
+- `index-base.tpl` solo contiene HTML/Twig. **Nunca** embebas etiquetas `<script>` con lógica del módulo, **nunca** PHP.
+
+### Sintaxis del template
+
+Híbrido Twig + atributos Acai. Ver `01-builder-fields.md` para el catálogo completo de campos editables (`data-field-type`) y atributos (`c-if`, `c-for`, etc.).
+
+```html
+<section class="hero-section" id="{{ section_id }}">
+  <div class="container mx-auto px-4">
+    <h2 data-field-type="headfield" data-field-label="Titulo" class="text-3xl font-bold">
+      Title here
+    </h2>
+    <p data-field-type="textbox" data-field-label="Descripcion" class="text-lg text-gray-600">
+      Description text
+    </p>
+    <img data-field-type="upload" data-field-label="Imagen" src="placeholder.jpg" class="w-full rounded-lg">
+    <a data-field-type="link" data-field-label="Boton" href="#" class="btn">Call to action</a>
+  </div>
+</section>
+```
+
+### Incluir un módulo dentro de otro
+
+```html
+<module_id :param1="value1" :param2="'string value'"></module_id>
+```
+
+El módulo hijo recibe los parámetros como variables en su contexto. Ejemplos típicos: incluir un formulario dentro del detalle de un registro, anidar un `bloqueproducto` dentro de un listado.
+
+```html
+<bloqueproducto_i7aunn :producto="selectedProduct" :showPrice="true"></bloqueproducto_i7aunn>
+<form_postular :vacante_num="thisrecord.num"></form_postular>
+```
+
+### Variables globales
+
+| Variable | Descripción |
+|----------|-------------|
+| `section_id` | ID único por instancia del módulo. Úsalo para anchors, IDs HTML, scoping de JS |
+| `interno` | `true` cuando se renderiza en el editor del CMS, `false` en el sitio público |
+| `server.HTTP_HOST` | Dominio actual (sin protocolo) |
+| `loop.index` | Índice 1-based dentro de un `c-for` o `{% for %}` |
+| `loop.index is odd` / `is even` | Para layouts alternados (zigzag) |
+| `thisrecord` | El registro actual (solo en secciones generales / detalle) |
+
+Patrón canónico para `section_id`:
+```html
+<div id="{{section_id}}"></div>
+<section id="id_{{ section_id }}" class="relative">
+  <!-- contenido -->
+</section>
+```
+
+## Secciones Generales
+
+Plantillas ligadas a una tabla. Cuando el usuario navega al `enlace` de un registro, Acai busca la sección general correspondiente y la renderiza pasándole el registro como `thisrecord`.
+
+Se construyen como **módulos especiales** dentro de `template/estandar/modulos/`. La diferencia clave: NO se colocan vía drag-and-drop; el CMS las enlaza por convención de nombre.
+
+### Convención `custom-{tableName}` (REGLA DURA)
+
+Toda tabla con campo `enlace` tiene automáticamente una sección general en:
+
+```
+template/estandar/modulos/custom-{tableName}/
+```
+
+El nombre es **literalmente** `custom-` seguido del `tableName`. Cuando el cliente accede a la URL de cualquier registro de esa tabla, Acai renderiza esa sección pasándole el registro como `thisrecord`.
+
+Ejemplos:
+- Tabla `vacantes` → `template/estandar/modulos/custom-vacantes/index-base.tpl`
+- Tabla `productos` → `template/estandar/modulos/custom-productos/index-base.tpl`
+- Tabla `noticias` → `template/estandar/modulos/custom-noticias/index-base.tpl`
+
+Reglas duras:
+- El CMS lo enlaza **automáticamente por convención de nombre**. NO existe ni se configura `_detailPage`.
+- Se crea/edita como cualquier otro módulo: `acai-write` sobre `index-base.tpl` dispara el compile.
+- Dentro del Twig, el registro actual está en `thisrecord` (`thisrecord.titulo`, `thisrecord.descripcion`, `thisrecord.imagen[0].urlPath`).
+- **NO crees una página por registro en `apartados`** ni una página "detalle" genérica. El detalle ya lo resuelve la sección general.
+- **NO uses ni configures `_detailPage`** — no existe.
+- **NO construyas URLs con query params** (`?id=5`) ni hagas fetch desde JS para cargar el registro.
+- **NO uses hooks para cargar el registro** — `thisrecord` ya está disponible.
+- **NO inventes otro nombre de módulo** para el detalle: debe ser `custom-{tableName}` exacto.
+
+### Acceso a datos via `thisrecord`
+
+```html
+<article class="product-card">
+  <img src="{{ thisrecord.imagen[0].urlPath }}"
+       alt="{{ thisrecord.imagen[0].info1 }}"
+       class="w-full h-64 object-cover">
+  <h3 class="text-xl font-semibold">{{ thisrecord.nombre }}</h3>
+  <p class="text-gray-600">{{ thisrecord.descripcion | raw }}</p>
+  <span class="text-2xl font-bold">{{ thisrecord.precio }}€</span>
+</article>
+```
+
+Particularidades:
+- Upload fields retornan **arrays**: `thisrecord.imagen[0].urlPath`
+- Metadatos del upload: `info1` (alt típico), `info2`, `info3`, `info4`
+- Foreign keys con sufijo `_num`: `thisrecord.categoria_num`
+- Si la FK tiene relación cargada, también aparece como objeto: `thisrecord.categoria_bd[0].nombre`
+
+### Embeber formularios en el detalle
+
+Si un detalle necesita un formulario (postular, pedir info), **embebe el módulo del formulario dentro de la sección general** pasándole el `num` del registro actual:
+
+```html
+<form_postular :vacante_num="thisrecord.num"></form_postular>
+```
+
+NO pongas el formulario como sección suelta del listado.
+
+### Definir variables con `<set>`
+
+```html
+<set :categories="'categorias' | get()"></set>
+<set :featured="'productos' | get('destacado=1', 'orden ASC', 3)"></set>
+<set :tienda="'configuracion_tienda' | get('num != 0')[0]"></set>
+```
+
+## Flujo canónico para una funcionalidad tipo "vacantes"
+
+1. **Crear la tabla** con `enlace=true` (`create_table`) y añadir los campos (`create_field`).
+2. **Crear la sección general** `template/estandar/modulos/custom-{tableName}/index-base.tpl` con el Twig que renderiza `thisrecord.*`. Añade `style.css` y `script.js` si hace falta.
+3. (Opcional) **Crear un módulo de listado** `template/estandar/modulos/{tableName}_listado/` que consulte los registros y enlace a cada `enlace`.
+4. (Opcional) **Crear la página índice** `/{tableName}/` como registro normal en `apartados` (tipo Builder) y añadirle el módulo de listado.
+
+## multiv2 — Contenido repetible dentro del módulo
+
+El tipo `multiv2` permite que el usuario repita un grupo de campos editables dentro de un mismo módulo. Útil para FAQs, listados de servicios, slides, etc.
+
+```html
+<ul>
+  <li data-field-type="multiv2" data-field-label="Records">
+    <h3 data-field-type="textfield" data-field-label="Titulo">Título por defecto</h3>
+    <p data-field-type="textbox" data-field-label="Descripcion">Descripción</p>
+    <img data-field-type="upload" data-field-label="Imagen" src="">
+  </li>
+</ul>
+```
+
+Acceso en Twig:
+```twig
+{% for record in records %}
+  <h3>{{ record.titulo }}</h3>
+  <p>{{ record.descripcion }}</p>
+  <img src="{{ record.imagen[0].urlPath }}">
+{% endfor %}
+```
+
+Las variables son **propiedades del objeto iterado**, no variables sueltas.
+
+## Layout global vs módulos
+
+`header`, `footer`, `style` global y `javascript` global NO son módulos normales. Viven en `cms/lib/plugins/builder_saas/layout.json` y se editan con tools dedicadas (`get_layout_field` / `set_layout_field`). Ver `08-layout-and-libraries.md`.
+
+NUNCA edites directamente:
+- `cms/lib/plugins/builder_saas/layout.json`
+- `template/estandar/modulos/custom-header-twig/*`
+- `template/estandar/modulos/custom-footer-twig/*`
+- `template/estandar/modulos/custom-header/*`
+- `template/estandar/modulos/custom-footer/*`
+
+Estos son artefactos generados a partir de `layout.json`.
+
+## Reglas críticas
+
+1. Solo se edita `index-base.tpl`. Los demás archivos `.tpl` y `builder.json` son auto-generados.
+2. Editar `index-base.tpl` con `acai-write` / `acai-line-replace` compila automáticamente.
+3. `script.js` y `style.css` son estáticos: nunca uses Twig ni atributos builder dentro.
+4. Detalle de registro = `template/estandar/modulos/custom-{tableName}/`. Nada de `_detailPage`, nada de páginas duplicadas.
+5. `thisrecord` solo existe en secciones generales — en módulos normales no aparece.
+6. Para incluir un módulo: `<module_id :param="value"></module_id>` o `'module_id' | module({param: value})`.
+7. Layout global (header/footer) NO se edita por archivos — usa `get_layout_field`/`set_layout_field`.

docs/04-pages-and-records.md

@@ -0,0 +1,186 @@
+# Páginas y Registros
+
+Este documento explica cómo Acai modela las páginas del sitio: toda fila con campo `enlace` es una página, y según el campo `controlador` puede ser **Builder** (modular, contenido por módulos) o **Standard** (contenido directo en los campos del registro). Cubre los tipos de tabla por `menuType` (`category`, `multi`, `single`, `separador`), las particularidades de la tabla `apartados`, los campos de visibilidad (`visible_en_el_menu` vs `visible`), las reglas inviolables sobre `enlace` y `controlador`, y el patrón canónico para implementar el detalle de un registro vía sección general `custom-{tableName}`. Léelo antes de crear, modificar o eliminar cualquier registro de tabla con `enlace`.
+
+## Tipos de página
+
+Todo registro con campo `enlace` es una **página pública**. El campo `controlador` decide cómo se renderiza.
+
+### Builder (modular)
+
+- `controlador` = `cms/lib/plugins/builder_saas/controlador.php`
+- El contenido se construye con **módulos** (drag & drop)
+- El campo `builder` contiene un array JSON de instancias de módulos
+- Tools: `add_module_to_record`, `set_module_config_vars`, `list_page_modules`, `reorder_module`, `toggle_module_visibility`
+- La página renderiza los módulos en orden
+
+### Standard (campos directos)
+
+- `controlador` = `cms/lib/plugins/builder_saas/controlador_tabla.php`
+- El contenido vive en los campos del registro (`content`, `titulo_alternativo`, etc.)
+- El campo `content` es HTML (wysiwyg)
+- Tool: `create_or_update_record` para editar el contenido directamente
+- No se usan módulos del builder
+
+### Cómo detectar el tipo
+
+**Siempre comprueba el campo `controlador` del registro**:
+- Contiene `controlador.php` (sin `_tabla`) → **Builder**
+- Contiene `controlador_tabla.php` → **Standard**
+
+## Tipos de tabla con páginas (sections)
+
+Las tablas con páginas se llaman **secciones**. El campo `menuType` del schema define el tipo:
+
+### `menuType = "category"`
+
+- **Jerárquico** — páginas con relaciones padre/hijo
+- Campos especiales: `parentNum`, `depth`, `globalOrder`, `lineage`, `siblingOrder`, `breadcrumb`
+- Ejemplo: `apartados` (páginas principales del sitio)
+- Visibilidad: campo `visible_en_el_menu` (1 visible, 0 oculto)
+- Orden: `globalOrder`
+
+### `menuType = "multi"`
+
+- **Lista plana** — sin jerarquía
+- Orden: `dragSortOrder`
+- Ejemplos: `blog`, `noticias`, `productos`, `vacantes`, `travesias`
+- Visibilidad: campo `visible` (1 visible, 0 oculto)
+
+### `menuType = "single"`
+
+- Página única (un solo registro)
+- Ejemplos: home, about us
+- No requiere campos de orden
+
+### `menuType = "separador"`
+
+- Separador visual en el menú del admin (no es una tabla con datos)
+
+## La tabla `apartados`
+
+La tabla principal de páginas en la mayoría de sitios Acai. Características:
+
+| Campo | Descripción |
+|-------|-------------|
+| `num` | Primary key |
+| `name` | Nombre de la página (campo título) |
+| `enlace` | URL pública (ya con barras: `/servicios/`) |
+| `controlador` | Define Builder vs Standard |
+| `menuType` | `"category"` (jerárquico) |
+| `parentNum` | `num` del padre (`0` = raíz) |
+| `depth` | Nivel de anidamiento (`0` raíz, `1` hijo, `2` nieto) |
+| `globalOrder` | Orden global en el árbol |
+| `visible_en_el_menu` | `1` visible, `0` oculto |
+| `breadcrumb` | Auto-generado |
+| `builder` | JSON con instancias de módulos (si es Builder) |
+| `content` | HTML del contenido (si es Standard) |
+
+Cada registro de `apartados` puede ser Builder o Standard — comprueba `controlador` por registro.
+
+## Reglas críticas para páginas
+
+### NUNCA cambies el campo `enlace`
+
+A menos que el usuario te lo pida explícitamente, **nunca modifiques `enlace`**. Cambiarlo:
+- Rompe enlaces externos (SEO, marcadores, otros sitios)
+- Rompe enlaces internos del propio sitio
+- Genera 404 hasta que se regeneren los aliases
+
+Si el usuario sí pide cambiarlo, considera usar la tool `regenerate_enlaces` con `generateAlias=true` para mantener los enlaces antiguos como redirects.
+
+### NUNCA cambies el campo `controlador`
+
+`controlador` define si la página es Builder o Standard. Cambiarlo a posteriori rompe el render. Solo se setea durante la creación.
+
+### Campos de visibilidad
+
+Comprueba siempre qué campo tiene la tabla antes de cambiar visibilidad:
+- `apartados` y otras categorías → `visible_en_el_menu`
+- `blog`, `travesias`, `noticias` y otras multi → `visible`
+
+### Campos de título
+
+- Algunas tablas usan `name` (e.g. `apartados`)
+- Otras usan `title` (e.g. `blog`, `travesias`)
+- Consulta el schema (`get_table_schema`) antes de asumir.
+
+## Trabajar con páginas Builder
+
+### Añadir contenido a una página Builder nueva
+
+1. Listar módulos disponibles con `acai-glob` (`template/estandar/modulos/*/builder.json`).
+2. `add_module_to_record` (uno cada vez, en orden). Devuelve `sectionId`.
+3. `set_module_config_vars` con el `sectionId` para rellenar variables. Devuelve `uploadFields`.
+4. Imágenes: `upload_record_image` o `generate_image` usando los `recordNum` y `fieldName` de `uploadFields`.
+5. `navigate_browser` para que el usuario vea el resultado.
+
+### Editar una página Builder existente
+
+1. `list_page_modules` — ver el layout actual (sectionIds, posiciones, visibilidades).
+2. `get_module_config_vars` — leer las variables actuales del módulo a modificar.
+3. `set_module_config_vars` — actualizar valores.
+4. O editar el template del módulo: `acai-view` + `acai-line-replace` sobre `index-base.tpl` (compila automáticamente).
+5. `reorder_module` para mover módulos, `toggle_module_visibility` para ocultar/mostrar.
+
+## Trabajar con páginas Standard
+
+Usa `create_or_update_record`. Campos típicos:
+
+| Campo | Descripción |
+|-------|-------------|
+| `content` | HTML del contenido (wysiwyg) |
+| `titulo_alternativo` | Título mostrado en la página |
+| `titulo_de_pagina` | `<title>` del navegador (SEO) |
+| `metatag_descripcion` | Meta description (SEO) |
+
+```
+create_or_update_record:
+  tableName: "apartados"
+  recordId: "87"
+  fields:
+    content: "<h2>Nuestros Servicios</h2><p>Ofrecemos…</p>"
+    titulo_de_pagina: "Servicios | Mi Sitio"
+    metatag_descripcion: "Descubre nuestros servicios…"
+```
+
+## Patrón canónico — Detalle de registro
+
+Para cualquier tabla con campo `enlace` (productos, noticias, vacantes, servicios), **el detalle se resuelve por convención** vía sección general `custom-{tableName}`. Ver `03-modules-and-sections.md` para detalles.
+
+Reglas duras:
+- **NO** crees una página por registro en `apartados`.
+- **NO** uses ni configures `_detailPage` — no existe.
+- **NO** uses query params (`?id=5`) en URLs.
+- **NO** uses hooks para cargar el registro — `thisrecord` ya existe.
+- El nombre del módulo es **literalmente** `custom-` + `tableName`.
+
+Flujo para una funcionalidad tipo "vacantes":
+1. `create_table` con `enlace=true`
+2. `create_field` para los campos necesarios
+3. Crear `template/estandar/modulos/custom-vacantes/index-base.tpl` que use `thisrecord.*`
+4. (Opcional) Módulo de listado `vacantes_listado` que consulte y enlace
+5. (Opcional) Página índice `/vacantes/` en `apartados` con el módulo de listado
+
+## Campos típicos en tablas "publicables"
+
+Cuando creas una tabla con `enlace` (noticias, vacantes, blog), añade por defecto:
+
+| Campo | Tipo | Uso |
+|-------|------|-----|
+| `fecha_publicacion` | date | Ordenar y filtrar |
+| `fecha_expiracion` | date (opcional) | Oculta el registro automáticamente cuando caduca |
+| `visible` | checkbox | Control manual |
+
+NO añadas un campo "estado" calculado si ya tienes `visible` + fechas.
+
+## Reglas críticas
+
+1. **Toda tabla con `enlace` produce páginas públicas.** Comprueba el `controlador` para saber si son Builder o Standard.
+2. **NUNCA modifiques `enlace`** salvo petición explícita del usuario.
+3. **NUNCA modifiques `controlador`** de un registro existente.
+4. **PK siempre es `num`**, nunca `id`. Foreign keys con sufijo `_num`.
+5. **Visibilidad**: `visible_en_el_menu` para `category`, `visible` para `multi`. Comprueba el schema.
+6. **Detalle de registro = `custom-{tableName}`**, nunca página duplicada.
+7. **Tablas sin prefijo `cms_`** en todas las llamadas a tools.
+8. **Para formularios estándar usa `c-form`**, no construyas POST/hook custom.

docs/05-tables-and-fields.md

@@ -0,0 +1,272 @@
+# Tablas y Campos
+
+Este documento explica cómo gestionar tablas y campos en Acai usando las tools del MCP. Cubre: cómo se almacena el schema (`cms/data/schema/{tabla}.ini.php`), los `menuType` (`multi`, `single`, `category`, `separador`), el flag `enlace` para tablas públicas, todos los tipos de campo (`textfield`, `textbox`, `wysiwyg`, `codigo`, `date`, `list`, `checkbox`, `upload`, `multitext`, `separator`), los props comunes (`isRequired`, `defaultValue`, `optionsType`, etc.), la diferencia entre operaciones reversibles e irreversibles (`dropData`, `dropColumn`, rename), y el flujo correcto para crear una funcionalidad nueva. Léelo antes de usar cualquier tool del grupo `tables/`.
+
+## Schemas
+
+Cada tabla tiene un schema en `cms/data/schema/{tabla}.ini.php`. Define:
+- Nombres y tipos de campo
+- Reglas de validación
+- Relaciones (foreign keys)
+- Configuración de display (orden, ancho, etc.)
+- Bloque `[meta]` con `menuName`, `menuType`, `menuOrder`, `controller`, etc.
+
+Antes de operar sobre una tabla, **siempre** consulta el schema:
+- `list_tables` — inventario rápido del proyecto
+- `get_table_schema` con `tableName` (sin `cms_`) — schema completo
+- `get_table_schema` con `minimal=true` — solo nombres + tipos + labels (ahorra tokens)
+- `get_table_schema` con `filterFields="galeria|foto|image"` — filtra por palabras clave
+
+**NUNCA inventes nombres de campos o tablas.** Siempre confirma con el schema.
+
+## Convenciones inmutables
+
+| Regla | Valor correcto |
+|-------|----------------|
+| Nombres de tabla en tools/Twig/CmsApi | sin prefijo `cms_` |
+| Nombres en `queryDB` | con prefijo `cms_` |
+| Primary key | `num` (siempre) |
+| Foreign key | `<entidad>_num` (e.g. `categoria_num`) |
+| Upload field | array `[{urlPath, info1, info2, info3, info4}]` |
+
+## Crear una tabla — `create_table`
+
+```
+create_table({
+  tableName: "vacantes",        // sin cms_, lowercase + underscores
+  menuName: "Vacantes",          // display en sidebar admin
+  menuType: "multi",             // multi | single | category | separador
+  enlace: true,                  // ¿es tabla pública con URLs?
+  seoMetas: true,                // añade campos SEO meta (default false)
+  menuOrder: 5                   // opcional, orden en sidebar
+})
+```
+
+### Decisiones obligatorias antes de llamar
+
+- **`enlace: true|false`** es una decisión de arquitectura. **PREGUNTA AL USUARIO** antes de llamar:
+  - `true` → la tabla genera URLs públicas, automáticamente añade campo `enlace` + slug. Cada registro será una página y puede tener detalle vía `custom-{tableName}`.
+  - `false` → tabla puramente administrativa (categorías internas, configuraciones, logs).
+- **`menuType`**:
+  - `multi` → lista plana (productos, noticias, vacantes)
+  - `single` → un único registro (home, configuración, about us)
+  - `category` → contenedor jerárquico que agrupa otras tablas en el menú
+  - `separador` → solo un separador visual
+
+### Después de crear la tabla
+
+1. Añade los campos necesarios con `create_field` (uno por uno).
+2. Si la tabla tiene `enlace: true`, considera crear la sección general `custom-{tableName}` para el detalle (ver `03-modules-and-sections.md`).
+3. Si la tabla quiere ordenar/filtrar por fechas, añade campos `fecha_publicacion`, `fecha_expiracion`, `visible` (ver `04-pages-and-records.md`).
+
+## Crear un campo — `create_field`
+
+```
+create_field({
+  tableName: "vacantes",
+  fieldName: "salario_minimo",   // identificador SQL-safe
+  label: "Salario Mínimo",        // display en formulario admin
+  type: "textfield",
+  initialProps: {                // opcional — overrides de defaults
+    isRequired: 1,
+    maxLength: 100
+  }
+})
+```
+
+### Tipos de campo
+
+| Tipo | Uso |
+|------|-----|
+| `textfield` | Texto de una línea |
+| `textbox` | Texto multilínea plano |
+| `wysiwyg` | Editor de texto enriquecido |
+| `codigo` | Editor de código (HTML/JS/CSS snippet) |
+| `date` | Selector de fecha o datetime |
+| `list` | Select / radio / checkboxes (necesita `listType` + `optionsType` en `initialProps`) |
+| `checkbox` | Booleano (1/0) |
+| `upload` | Subida de archivos (imágenes, docs) |
+| `multitext` | Repetidor de entradas de texto |
+| `separator` | Separador visual en el formulario (sin columna en BD) |
+
+### Props comunes (`initialProps`)
+
+Pasa solo los que quieres sobrescribir; el resto usa defaults.
+
+| Prop | Aplica a | Descripción |
+|------|----------|-------------|
+| `isRequired` | todos | `1` o `0` |
+| `isUnique` | textfield, textbox | `1` o `0` |
+| `defaultValue` | todos | Valor por defecto |
+| `description` | todos | Texto de ayuda en el formulario |
+| `minLength` / `maxLength` | textfield, textbox, wysiwyg | Longitud min/max |
+| `listType` | list | `select`, `radio`, `checkboxes` |
+| `optionsType` | list | `text` (opciones fijas) o `tablename` (opciones desde otra tabla) |
+| `optionsText` | list (text) | `"opcion1,opcion2,|valor3,etiqueta3"` |
+| `optionsTablename` | list (tablename) | Tabla origen (sin `cms_`) |
+| `optionsValueField` | list (tablename) | Campo del valor (típico: `num`) |
+| `optionsLabelField` | list (tablename) | Campo de la etiqueta |
+| `optionsQuery` | list (tablename) | Filtro WHERE adicional |
+| `filterField` | list (tablename) | Filtro dinámico por valor de otro campo |
+| `allowedExtensions` | upload | `"jpg,png,webp,pdf"` |
+| `maxUploads` | upload | Número máximo de archivos |
+| `createThumbnails` | upload | `1` o `0` |
+| `maxThumbnailWidth` / `maxThumbnailHeight` | upload | px |
+| `fieldWidth` / `fieldHeight` | upload | px sugeridos al builder |
+| `adminOnly` | todos | `1` oculta el campo en formularios públicos |
+| `charsetRule` | textfield | Restricciones de caracteres |
+| `tipoTags` | wysiwyg | Tags HTML permitidos |
+
+### Ejemplo: lista desde tabla
+
+```
+create_field({
+  tableName: "vacantes",
+  fieldName: "categoria_num",
+  label: "Categoría",
+  type: "list",
+  initialProps: {
+    listType: "select",
+    optionsType: "tablename",
+    optionsTablename: "categorias",
+    optionsValueField: "num",
+    optionsLabelField: "nombre"
+  }
+})
+```
+
+## Actualizar un campo — `update_field`
+
+```
+update_field({
+  tableName: "vacantes",
+  fieldName: "descripcion",
+  newFieldName: "descripcion_corta",   // OPCIONAL — renombra columna MySQL
+  props: {
+    label: "Descripción Corta",
+    maxLength: 200
+  }
+})
+```
+
+### Casos destructivos
+
+- **`newFieldName`** renombra la columna MySQL. Los datos se preservan, pero **rompe cualquier referencia hardcodeada** (Twig, hooks, JS, queryDB). Audita el código antes de renombrar.
+- **Cambiar `type`** puede coercer/truncar datos (ej. `wysiwyg` → `textfield` elimina HTML). El backend devuelve `warnings` en la respuesta — **muéstralos al usuario**.
+
+## Borrar un campo — `delete_field`
+
+```
+delete_field({
+  tableName: "vacantes",
+  fieldName: "campo_obsoleto",
+  dropColumn: false   // default
+})
+```
+
+- `dropColumn: false` → solo elimina del schema. Si la columna MySQL tiene datos, el backend rechaza y devuelve `dataCount` para que avises al usuario.
+- `dropColumn: true` → `ALTER TABLE DROP COLUMN`. **Los datos de esa columna se pierden permanentemente.**
+
+## Borrar una tabla — `delete_table`
+
+```
+delete_table({
+  tableName: "tabla_obsoleta",
+  dropData: false,  // default
+  dryRun: true      // pre-flight check
+})
+```
+
+- `dryRun: true` → no borra nada, solo reporta `recordCount`. **Úsalo siempre antes de pedir confirmación al usuario.**
+- `dropData: false` → solo borra el schema (`.ini.php`). Si la tabla MySQL tiene registros, el backend rechaza.
+- `dropData: true` → `DROP TABLE` + delete schema. **Datos perdidos permanentemente.**
+
+## Reordenar — `reorder_tables`, `reorder_fields`
+
+Pasa la lista completa ordenada de nombres. Solo cambia el orden visual, los datos no se tocan.
+
+```
+reorder_tables({ order: ["apartados", "blog", "productos", "vacantes"] })
+
+reorder_fields({
+  tableName: "vacantes",
+  order: ["titulo", "descripcion", "salario_minimo", "fecha_publicacion", "visible"]
+})
+```
+
+Los campos del sistema (`num`, `creationDate`, etc.) se ignoran automáticamente.
+
+## Actualizar metadata — `update_table_metadata`
+
+Modifica el bloque `[meta]` del schema.
+
+```
+update_table_metadata({
+  tableName: "vacantes",
+  newTableName: "ofertas_empleo",   // OPCIONAL — renombra tabla MySQL
+  meta: {
+    menuName: "Ofertas de Empleo",
+    menuOrder: 3,
+    listPageFields: "titulo,fecha_publicacion,visible",
+    breadcrumbField: "titulo"
+  }
+})
+```
+
+Keys aceptadas en `meta`:
+`menuName`, `menuDesc`, `menuType`, `menuOrder`, `menuDisplay`, `menuHidden`, `controller`, `breadcrumbField`, `breadcrumbByLink`, `breadcrumbParentNum`, `listPageFields` (csv), `listPageOrder`, `listPageSearchFields`.
+
+**`newTableName` renombra la tabla MySQL** y rompe cualquier referencia hardcodeada (controllers custom, módulos con SQL embebido, queryDB en plantillas). Audita el código antes y avisa al usuario.
+
+## Regenerar enlaces — `regenerate_enlaces`
+
+Regenera el campo `enlace` (slug) de todos los registros de una tabla. **Cambia URLs públicas** — todo lo que apunte a las antiguas dará 404 a menos que actives los aliases.
+
+```
+regenerate_enlaces({
+  tableName: "vacantes",
+  generateAlias: true   // recomendado si la tabla ya es pública
+})
+```
+
+- `generateAlias: false` (default) — solo actualiza `enlace`. URLs antiguas → 404.
+- `generateAlias: true` — escribe entradas en `alias_urls` para redirigir las URLs antiguas a las nuevas. Más seguro.
+
+## Listar tablas — `list_tables`
+
+Devuelve todas las tablas con su `menuName`, `menuType`, `menuOrder` y `tableName`. Sin prefijo `cms_`. Úsalo cuando necesites un inventario rápido.
+
+## Tipos de campo y formato al insertar/actualizar registros
+
+Al usar `create_or_update_record`, cada tipo espera un formato específico:
+
+| Tipo | Formato | Ejemplo |
+|------|---------|---------|
+| `textfield` | String | `"Texto"` |
+| `textbox` | String multilínea | `"Línea 1\nLínea 2"` |
+| `date`/datetime | `YYYY-MM-DD HH:mm:ss` | `"2025-12-03 10:30:00"` |
+| `wysiwyg` | String HTML | `"<p>Texto</p>"` |
+| `list` | String o número | `"activo"` o `"1"` (num si es FK) |
+| `checkbox` | Número 1/0 | `1` o `0` |
+| `multitext` | String JSON | `"[{\"item\":\"valor\"}]"` |
+| `upload` | **NO enviar** | Usa `upload_record_image` después de crear el registro |
+
+Ver `06-hooks-and-cmsapi.md` para los detalles de `CmsApi::insert` / `update`.
+
+## Flujo canónico — Funcionalidad nueva tipo "vacantes"
+
+1. `create_table({ tableName: "vacantes", menuType: "multi", enlace: true, seoMetas: true })` — pregunta al usuario si quiere `enlace` y `seoMetas`.
+2. `create_field` para cada campo: `titulo`, `descripcion` (wysiwyg), `salario_minimo` (textfield), `categoria_num` (list desde tabla), `fecha_publicacion` (date), `fecha_expiracion` (date), `visible` (checkbox), `imagen_destacada` (upload).
+3. Crear sección general `template/estandar/modulos/custom-vacantes/index-base.tpl` con `acai-write` (compila automáticamente).
+4. (Opcional) Módulo de listado `vacantes_listado_xxxxxx` que liste registros con `'vacantes' | get('visible=1', 'fecha_publicacion DESC', 20)`.
+5. (Opcional) Página índice `/vacantes/` en `apartados` con el módulo de listado.
+
+## Reglas críticas
+
+1. **Tabla sin prefijo `cms_`** en todas las tools. PK siempre `num`.
+2. **Antes de cualquier operación**: `get_table_schema` para confirmar nombres y tipos de campo.
+3. **Pregunta al usuario antes de `create_table`** sobre `enlace` y `seoMetas` (decisiones de arquitectura).
+4. **`dropData`, `dropColumn`, `newFieldName`, `newTableName`** son destructivos o irreversibles — pide confirmación explícita.
+5. **`regenerate_enlaces`**: usa `generateAlias: true` si la tabla ya tiene tráfico público.
+6. **Surfacea los `warnings`** que el backend devuelve (cambios de tipo, renames, conteos de datos en riesgo).
+7. **Upload fields no se setean en insert/update** — usa `upload_record_image` después.

docs/06-hooks-and-cmsapi.md

@@ -0,0 +1,383 @@
+# Hooks y CmsApi (server-side)
+
+Este documento describe cómo crear y consumir hooks PHP en Acai (lógica server-side) y cómo usar `CmsApi` (alias de `CocoDB`) para acceder a la base de datos. Cubre las dos ubicaciones válidas para un hook (global en `hooks/hooks.<id>.php` o propio de módulo en `template/estandar/modulos/<id>/hook.php`), las cuatro formas de invocarlo (filtro Twig, etiqueta `<hook>`, JS `CmsApi.hook`, `c-form`), las reglas obligatorias (devolver array, no `echo`, no `exit`), la API completa de `CmsApi::get/insert/update/delete` con sus opciones (`uploads`, `relations`, `translates`, `groupBy`, `aggregates`), y la tool `set_hook_middleware` para que un hook global se ejecute automáticamente antes de renderizar páginas. Léelo antes de crear cualquier `.php` de hook.
+
+## Hooks — qué son y dónde viven
+
+Hooks son archivos PHP que ejecutan lógica server-side. Hay dos ubicaciones válidas:
+
+### Hook global
+
+- Archivo: `hooks/hooks.<hook-id>.php`
+- Endpoint: `/hooks/<hook-id>/`
+- Úsalo cuando la lógica se reutiliza entre módulos, páginas o formularios.
+
+Ejemplo: `hooks/hooks.calcular_precio.php` → endpoint `/hooks/calcular_precio/`
+
+### Hook propio de módulo
+
+- Archivo: `template/estandar/modulos/<module-id>/hook.php`
+- Endpoint: `/hooks/<module-id>/`
+- Úsalo cuando la lógica pertenece solo a ese módulo.
+
+Ejemplo: `template/estandar/modulos/buscadorapartados_hjd8s/hook.php` → endpoint `/hooks/buscadorapartados_hjd8s/`
+
+### Regla práctica
+
+- Si la lógica solo sirve a un módulo → `hook.php` dentro del módulo.
+- Si varias piezas la consumen → hook global en `hooks/`.
+
+## Reglas obligatorias
+
+- Devuelve datos con `return [...]`. **NUNCA** uses `echo json_encode(...)` ni `exit`.
+- Para leer parámetros usa `$_REQUEST[...]` o las variables ya inyectadas (los parámetros pasados al llamar el hook se convierten en variables PHP del mismo nombre).
+- En hooks usa `CmsApi::get()` o `CocoDB::get()` como primera opción.
+- **NO uses `CocoDB::getInstance()`** salvo necesidad excepcional.
+- **NO escribas SQL manual con `prepare()/bind_param()`** salvo que de verdad no haya alternativa con `CmsApi` o `CocoDB`.
+
+### Estructura de un hook
+
+```php
+<?php
+// Si llamas el hook con { cantidad: 10, tipo: 'mayoreo' },
+// recibes $cantidad = 10 y $tipo = 'mayoreo' como variables.
+
+$precioUnitario = 50;
+
+if ($tipo === 'mayoreo' && $cantidad > 10) {
+    $precioUnitario *= 0.85; // 15% descuento
+}
+
+return [
+    "success" => true,
+    "precioUnitario" => round($precioUnitario, 2),
+    "total" => round($precioUnitario * $cantidad, 2),
+    "descuento" => $tipo === 'mayoreo' ? 15 : 0
+];
+```
+
+## Cómo invocar un hook
+
+### Desde Twig (filtro `hook`)
+
+```twig
+{% set resultado = 'hooks/calcular_precio/' | hook({cantidad: 5, tipo: 'mayoreo'}) %}
+<p>Total: {{ resultado.total }}€</p>
+```
+
+### Desde HTML (etiqueta `<hook>`)
+
+```html
+<hook result="precio" endpoint="/hooks/calcular_precio/" :cantidad="10" :tipo="'mayoreo'"></hook>
+<p>{{ precio.message }}</p>
+```
+
+### Desde JavaScript
+
+```js
+CmsApi.hook('/hooks/calcular_precio/', { cantidad: 10, tipo: 'mayoreo' }, (data) => {
+  console.log(data.total);
+});
+```
+
+Si llamas a un hook propio del módulo desde su `script.js`, usa el `module-id` real (`/hooks/buscadorapartados_hjd8s/`). NO construyas el endpoint con Twig dentro de `script.js` — pásalo desde `index-base.tpl` vía `data-hook-endpoint`.
+
+### Desde otro hook PHP
+
+```php
+$result = hook("/hooks/calcular_precio/", ["cantidad" => 5, "tipo" => "mayoreo"]);
+$mensaje = $result["message"];
+```
+
+### Desde `c-form`
+
+Los hooks se ejecutan automáticamente al enviar el formulario si están configurados en los atributos del `c-form`.
+
+### Testing manual
+
+Con Docker corriendo:
+```bash
+curl {ACAI_WEB_URL}/hooks/calcular_precio/
+```
+Usa la URL real del proyecto (devuélvela con `get_web_url`), no `localhost:8080`. En desarrollo local no necesitas `X-Hooks-Token`.
+
+## CmsApi (PHP)
+
+API server-side para BD. Disponible en todos los hooks. Alias de `CocoDB`.
+
+### Read — `CmsApi::get()`
+
+```php
+// Todos los registros
+$products = CmsApi::get("productos");
+
+// Con WHERE string
+$active = CmsApi::get("productos", "activo=1");
+
+// Con orden y límite
+$latest = CmsApi::get("noticias", "", "fecha DESC", 5);
+
+// Condiciones complejas
+$caros = CmsApi::get("productos", "precio > 100");
+$resultados = CmsApi::get("productos", "activo = 1 AND stock > 0");
+
+// Operadores
+$expensive = CmsApi::get("productos", "precio >= 100");
+$search = CmsApi::get("productos", "nombre LIKE '%keyword%'");
+$inList = CmsApi::get("productos", "categoria_num IN (1, 2, 3)");
+
+// Con opciones
+$datos = CmsApi::get("productos", "", "", "", [
+    'translates' => true,
+    'uploads' => true,
+    'relations' => true,
+    'relationsDepth' => 2
+]);
+```
+
+#### Opciones
+
+| Option | Tipo | Default | Descripción |
+|--------|------|---------|-------------|
+| `uploads` | bool | `true` | Incluir datos de upload fields |
+| `relations` | bool/array | `true` | Resolver foreign keys. Array para limitar: `['categoria']` |
+| `relationsDepth` | int | 2 | Profundidad de relaciones anidadas |
+| `translates` | string | idioma actual | Código de idioma para `| translate` |
+| `groupBy` | string | null | Cláusula GROUP BY |
+| `aggregates` | array | `[]` | Funciones de agregación |
+| `onlyFields` | array | null | Seleccionar solo ciertos campos |
+| `debug` | bool | false | Imprime el SQL generado |
+| `redis` | bool | null | Forzar cache Redis |
+| `redis_expire` | int | 60 | TTL del cache (segundos) |
+
+### Insert — `CmsApi::insert()`
+
+```php
+// Un registro
+CmsApi::insert('contacto', [
+    ["nombre" => "John", "email" => "john@example.com", "mensaje" => "Hola"]
+]);
+
+// Múltiples registros
+CmsApi::insert('productos', [
+    ["nombre" => "Producto A", "precio" => 100],
+    ["nombre" => "Producto B", "precio" => 200]
+]);
+
+// Retornar el last id
+$result = CmsApi::insert('productos',
+    [["nombre" => "Nuevo", "precio" => 150]],
+    [],
+    ['return_last_id' => true]
+);
+$nuevoNum = $result['lastId'];
+```
+
+#### Opciones de insert
+
+| Option | Descripción |
+|--------|-------------|
+| `forceNum` | Permite setear el campo `num` manualmente |
+| `ignoreSchema` | Saltar validación de schema |
+| `ignoreFields` | Array de campos a ignorar |
+| `return_last_id` | Devuelve el `num` del último insert |
+
+### Update — `CmsApi::update()`
+
+```php
+// Con WHERE string
+CmsApi::update('productos', ["precio" => 150], "num=1");
+
+// Con WHERE array
+CmsApi::update('productos',
+    ["activo" => 1],
+    [["column" => "num", "operator" => "=", "value" => 1]]
+);
+
+// Múltiples registros
+CmsApi::update('productos', ["activo" => 0], "precio < 50");
+```
+
+### Delete — `CmsApi::delete()`
+
+```php
+CmsApi::delete('productos', "num=5");
+
+CmsApi::delete('productos',
+    [["column" => "activo", "operator" => "=", "value" => 0]]
+);
+```
+
+### Reglas CmsApi
+
+- Nombres de tabla **sin prefijo `cms_`**
+- Primary key siempre es **`num`**
+- Foreign keys: **`<entidad>_num`**
+- Upload fields **NO se setean** vía insert/update — usa `upload_record_image` después.
+- Operadores soportados: `=`, `!=`, `>`, `>=`, `<`, `<=`, `LIKE`, `IN`
+
+## CocoDB (low-level)
+
+Capa de BD que usa internamente `CmsApi`. Misma API que `CmsApi` pero con métodos verbosos:
+- `CocoDB::get($table, $where, $order, $limit, $options)` — idéntico a `CmsApi::get`
+- `CocoDB::insertRecords($table, $records, $functions, $options)` — idéntico a `CmsApi::insert`
+- `CocoDB::updateRecords($table, $records, $where, $functions, $options)` — idéntico a `CmsApi::update`
+- `CocoDB::deleteRecords($table, $where, $options)` — idéntico a `CmsApi::delete`
+
+Para uso normal, `CmsApi` es suficiente. Acude a `CocoDB` solo para SQL más bajo nivel cuando `CmsApi` no cubra el caso.
+
+## CmsApi (JavaScript — Client-Side)
+
+```js
+// Llamar hook
+CmsApi.hook('/hooks/calcular_precio/', { cantidad: 10 }, (response) => {
+  console.log(response);
+});
+
+// Leer registros (si está expuesto vía hooks)
+CmsApi.get('productos', { where: 'activo=1' }, (records) => {
+  console.log(records);
+});
+```
+
+## Hook middleware — auto-ejecutar antes de páginas
+
+Un hook global puede configurarse como **middleware**: se ejecuta automáticamente antes de renderizar ciertas páginas (o todas). Útil para inyección de variables, redirecciones condicionales, control de acceso, parseo de URLs, etc.
+
+### Tools
+
+- `get_hook_middleware({ hookEndPoint: "/hooks/parse_styles/" })` — leer config actual
+- `set_hook_middleware({ hookEndPoint: "/hooks/parse_styles/", middleWare: [...] })` — escribir config
+
+### Valores de `middleWare`
+
+| Valor | Comportamiento |
+|-------|----------------|
+| `[]` | Hook solo se ejecuta cuando se llama explícitamente (default). |
+| `["allurls"]` | Se ejecuta antes de **cada página** del sitio. |
+| `["<tableName>-<num>", ...]` | Se ejecuta antes de **registros específicos**. Ejemplo: `["cms_apartados-2"]` para la home. |
+
+> Nota: en el array de `middleWare` los `tableName` van **con** prefijo `cms_` (es la representación interna de `layout.json`).
+
+### Ejemplos
+
+```
+// Lógica de redirect que solo afecta a la home (apartados num=2)
+set_hook_middleware({
+  hookEndPoint: "/hooks/redirect_home/",
+  middleWare: ["cms_apartados-2"]
+})
+
+// Inyección global (analytics, vars de sitio)
+set_hook_middleware({
+  hookEndPoint: "/hooks/global_vars/",
+  middleWare: ["allurls"]
+})
+
+// Hook utilitario que se llama desde módulos — sin middleware
+set_hook_middleware({
+  hookEndPoint: "/hooks/calcular_precio/",
+  middleWare: []
+})
+```
+
+### Reglas
+
+- El middleware se aplica **solo a hooks globales**, no a hooks de módulo.
+- Crear el `.php` con `acai-write` **NO** activa middleware automáticamente — hay que llamar `set_hook_middleware` explícitamente.
+- Lee `get_hook_middleware` antes de modificar para no sobrescribir configuraciones existentes.
+
+## Schemas y formato de datos al insertar
+
+Antes de un `CmsApi::insert`/`update` o de un `create_or_update_record` desde MCP, consulta el schema (`get_table_schema`). Tipos de campo y formato esperado:
+
+| Tipo | Formato | Ejemplo |
+|------|---------|---------|
+| `textfield` | String | `"Texto"` |
+| `textbox` | String multilínea | `"Línea 1\nLínea 2"` |
+| `date`/datetime | `YYYY-MM-DD HH:mm:ss` | `"2025-12-03 10:30:00"` |
+| `wysiwyg` | HTML string | `"<p class=\"font-bold\">Texto</p>"` |
+| `list` | String o número | `"activo"` o `"1"` |
+| `checkbox` | Número 1/0 | `1` o `0` |
+| `multitext` | String JSON | `"[{\"item\":\"valor\"}]"` |
+| `upload` | NO enviar | Usa `upload_record_image` después |
+
+## Ejemplos prácticos
+
+### Hook con operaciones de BD
+
+```php
+<?php
+// hook.php del módulo "procesar_compra"
+$producto = CmsApi::get("productos", "num=" . intval($producto_id));
+
+if (empty($producto)) {
+    return ["success" => false, "message" => "Producto no encontrado"];
+}
+
+$total = $producto[0]['precio'] * $cantidad;
+
+// Crear venta
+$result = CmsApi::insert('ventas', [[
+    "usuario_num" => $usuario_id,
+    "producto_num" => $producto_id,
+    "cantidad" => $cantidad,
+    "total" => $total,
+    "fecha" => date('Y-m-d H:i:s')
+]], [], ['return_last_id' => true]);
+
+// Actualizar stock
+$stock = CmsApi::get("stocks", "producto_num=" . intval($producto_id));
+if (!empty($stock)) {
+    CmsApi::update('stocks',
+        ["cantidad" => $stock[0]['cantidad'] - $cantidad],
+        "producto_num=$producto_id"
+    );
+}
+
+return ["success" => true, "ventaNum" => $result['lastId'], "total" => $total];
+```
+
+### Hook con relaciones cargadas
+
+```php
+<?php
+$productos = CmsApi::get("productos", "activo=1", "globalOrder ASC", 10, [
+    'uploads' => true,
+    'relations' => true,
+    'relationsDepth' => 1
+]);
+
+return [
+    "success" => true,
+    "productos" => $productos
+];
+```
+
+### Hook con búsqueda dinámica
+
+```php
+<?php
+$where = "1=1";
+if (!empty($termino)) {
+    $termino = addslashes($termino);
+    $where .= " AND (titulo LIKE '%$termino%' OR descripcion LIKE '%$termino%')";
+}
+if (!empty($categoria)) {
+    $where .= " AND categoria_num=" . intval($categoria);
+}
+
+$resultados = CmsApi::get("productos", $where, "fecha DESC", 20);
+
+return ["success" => true, "count" => count($resultados), "resultados" => $resultados];
+```
+
+## Reglas críticas
+
+1. Hook devuelve `return [...]` — **nunca** `echo`/`exit`.
+2. Tablas **sin prefijo `cms_`** en `CmsApi`/`CocoDB`. PK siempre `num`.
+3. Foreign keys con sufijo `_num` (`categoria_num`, `usuario_num`).
+4. Upload fields **no** se setean por insert/update.
+5. Sanea variables externas — `intval()`, `addslashes()` o usa parámetros tipados antes de concatenar en SQL.
+6. Antes de usar `set_hook_middleware`, lee con `get_hook_middleware` para no sobrescribir.
+7. Hooks de módulo: endpoint = `/hooks/<module-id>/` (no `/hooks/hook.<id>/`).

docs/07-css-js-conventions.md

@@ -0,0 +1,283 @@
+# CSS y JavaScript — Convenciones del Módulo
+
+Este documento define cómo escribir CSS, JavaScript y, cuando hace falta, Vue 3 dentro de un módulo Acai. Cubre la regla "Tailwind first" + BEM para CSS custom, las clases utilitarias propias de Acai (`transition3s`, `click-a-child`, `line-clamp2`, `lazyload`, `bg-main-color`, etc.), las CSS variables del tema (`--main-color`), el patrón obligatorio de **scoping** vía la clase raíz del módulo, la regla dura de que `script.js` y `style.css` son **archivos estáticos** (sin Twig dentro), cómo pasar valores dinámicos desde `index-base.tpl` a JS vía `data-*`, cuándo usar Vue 3 y cómo integrarlo evitando conflicto de delimiters con Twig, y los componentes nativos del builder (Carousel `c-tns-wrapper`, Lightbox, Breadcrumb, AOS, Lazy loading). Léelo antes de escribir cualquier `style.css` o `script.js`.
+
+## Estructura del módulo
+
+- Cada módulo genera HTML + CSS + JS (y opcionalmente Vue 3).
+- Define una **clase raíz en kebab-case** específica del módulo: `product-card`, `hero-section`, `buscador-apartados`.
+- **Todo el CSS y JS deben quedar scopeados bajo esa clase raíz.**
+
+## CSS
+
+### Tailwind first
+
+Usa TailwindCSS como método principal. Reserva CSS custom solo cuando Tailwind no cubra el caso (estados complejos, transiciones específicas, animaciones).
+
+```html
+<div class="flex items-center gap-4 p-6 bg-white rounded-lg shadow-md">
+  <h2 class="text-2xl font-bold text-gray-900">Title</h2>
+</div>
+```
+
+### BEM para CSS custom
+
+Cuando necesites CSS propio, scopealo bajo la clase raíz con BEM:
+
+```css
+.hero-section { }
+.hero-section__title { }
+.hero-section__image { }
+.hero-section--dark { }
+```
+
+Nunca uses clases globales sin prefijo de módulo.
+
+### CSS variables del tema
+
+| Variable | Descripción |
+|----------|-------------|
+| `var(--main-color)` | Color de marca principal |
+| `var(--main-color-light)` | Variante clara |
+| `var(--main-color-dark)` | Variante oscura |
+
+### Estilos inline con fallbacks
+
+Patrón estándar para colores configurables por el usuario (variables del builder):
+
+```html
+<div style="background-color: {{ colordefondo ? colordefondo : 'transparent' }}">
+<p style="color: {{ colordeltexto ? colordeltexto : '#111827' }}">
+```
+
+### Clases utilitarias de Acai
+
+| Clase | Descripción |
+|-------|-------------|
+| `transition3s` | Transición suave 0.3s |
+| `click-a-child` | Hace al padre clickeable vía el primer `<a>` hijo |
+| `line-clamp2` / `line-clamp3` / `line-clamp5` | Truncar texto a N líneas |
+| `filter-white` | Filtro CSS para teñir imágenes/iconos en blanco |
+| `lazyload` | Activa lazy loading (usar con `data-src`) |
+| `text-shadow` | Sombra de texto para legibilidad sobre imágenes |
+| `wysiwyg` | Wrapper para contenido rico (estilos coherentes) |
+| `bg-main-color` / `bg-main-color-light` / `bg-main-color-dark` | Fondos con color primario |
+| `text-main-color` / `text-main-color-light` / `text-main-color-dark` | Texto con color primario |
+| `titulo-main-color` / `titulo-white` | Estilos de título resaltado |
+| `c-tns-wrapper` / `c-tns-container` / `c-tns-nav-container` | Carousel built-in |
+| `glightbox` | Activa lightbox |
+
+### Reglas para `style.css`
+
+`style.css` es **estático**. Reglas duras:
+- **NO** uses sintaxis Twig (`{{ ... }}`, `{% ... %}`) ni atributos builder (`c-if`, `c-for`).
+- **NO** escribas selectores que dependan de `{{ section_id }}` — scopea con la clase raíz del módulo.
+
+```css
+/* CORRECTO — scopeado con clase raíz */
+.product-card { }
+.product-card__title { color: var(--main-color); }
+
+/* INCORRECTO — Twig inside */
+#{{ section_id }} h3 { }
+```
+
+## JavaScript
+
+### `script.js` es estático
+
+Igual que `style.css`: **NO** uses sintaxis Twig dentro. Si necesitas valores dinámicos, pásalos desde `index-base.tpl` vía atributos `data-*`.
+
+#### Patrón correcto
+
+`index-base.tpl`:
+```html
+<section class="buscador-apartados"
+         id="{{ section_id }}"
+         data-section-id="{{ section_id }}"
+         data-hook-endpoint="/hooks/buscadorapartados_hjd8s/"
+         data-limit="{{ limite | default('10') }}">
+  <input class="buscador-apartados__input" type="text">
+  <ul class="buscador-apartados__results"></ul>
+</section>
+```
+
+`script.js`:
+```js
+document.querySelectorAll('.buscador-apartados').forEach((section) => {
+  const sectionId = section.dataset.sectionId;
+  const hookEndpoint = section.dataset.hookEndpoint;
+  const limit = parseInt(section.dataset.limit, 10);
+  const input = section.querySelector('.buscador-apartados__input');
+  const results = section.querySelector('.buscador-apartados__results');
+
+  input.addEventListener('input', (e) => {
+    CmsApi.hook(hookEndpoint, { termino: e.target.value, limite: limit }, (data) => {
+      results.innerHTML = data.items.map((it) => `<li>${it.titulo}</li>`).join('');
+    });
+  });
+});
+```
+
+NUNCA hagas `CmsApi.hook('/hooks/{{ moduleId }}/', ...)` dentro de `script.js`. Si necesitas el endpoint, pásalo por `data-hook-endpoint`.
+
+### CmsApi (cliente)
+
+```js
+// Llamar hook
+CmsApi.hook('/hooks/module_id/', { action: 'getData', id: 123 }, (response) => {
+  console.log(response);
+});
+
+// Si llamas un hook propio del módulo, usa el module-id real:
+CmsApi.hook('/hooks/buscadorapartados_hjd8s/', { termino: 'vela' }, (response) => {
+  console.log(response);
+});
+```
+
+### Embeber `<script>` directamente — NO
+
+No embebas `<script>` con lógica del módulo dentro de `index-base.tpl`. La lógica vive en `script.js`. La excepción: scripts mínimos para inicializar Vue 3 (ver más abajo) que sí necesitan los delimitadores `{{ section_id }}` para mountear sobre IDs únicos.
+
+## Cuándo usar Vue 3
+
+Usa Vue 3 (vía CDN) cuando la lógica requiera:
+- Doble binding / reactividad
+- Solicitudes asíncronas complejas con UI reactiva
+- Componentes reutilizables dentro del módulo
+- Gestión de estado local
+- Ciclos de vida (mounted, unmounted, etc.)
+
+Para lógica simple (listeners, fetch único, toggle de clases), usa JavaScript vanilla.
+
+### Integración Vue 3
+
+```html
+<div id="app-{{ section_id }}">
+  <p>${ message }</p>
+  <button @click="increment">${ count }</button>
+</div>
+
+<script>
+const { createApp, ref } = Vue;
+createApp({
+  delimiters: ['${', '}'],   // OBLIGATORIO — evita conflicto con Twig {{ }}
+  setup() {
+    const message = ref('Hello');
+    const count = ref(0);
+    const increment = () => count.value++;
+    return { message, count, increment };
+  }
+}).mount('#app-{{ section_id }}');
+</script>
+```
+
+Reglas:
+- **Siempre** redefine `delimiters` a `['${', '}']` para no chocar con Twig.
+- Mountea sobre un id único usando `section_id`: `#app-{{ section_id }}`.
+- Vue se carga como librería global vía `add_global_library` o ya incluida en el proyecto (ver `08-layout-and-libraries.md`).
+
+## Variables globales disponibles en JS / Twig
+
+| Variable | Descripción | Ejemplo |
+|----------|-------------|---------|
+| `section_id` | ID único por instancia del módulo | `<div id="{{section_id}}">` |
+| `server.HTTP_HOST` | Dominio actual | `https://{{ server.HTTP_HOST }}/path` |
+| `loop.index` | Índice 1-based en `c-for`/`{% for %}` | `{{ loop.index }}` |
+| `loop.index is odd` / `is even` | Para layouts alternados | zigzag |
+| `interno` | `true` dentro del editor CMS | `c-class="{'editor-mode': interno}"` |
+
+### Patrón `section_id`
+
+Cada instancia de un módulo recibe un `section_id` único. Úsalo para anchors, IDs HTML y selector raíz de JS:
+
+```html
+<div id="{{section_id}}"></div>
+<section id="id_{{ section_id }}" class="relative">
+  <!-- contenido -->
+</section>
+```
+
+## Componentes nativos
+
+### Carousel — `c-tns-wrapper`
+
+```html
+<div class="c-tns-wrapper"
+     data-responsive='{"0":1,"768":2,"1024":3}'
+     data-autoplay-timeout="5000"
+     data-mode="carousel"
+     data-speed="400"
+     data-nav="true">
+  <ul class="c-tns-container">
+    <li data-field-type="multiv2" data-field-label="Slides" class="px-2">
+      <!-- contenido del slide -->
+    </li>
+  </ul>
+</div>
+```
+
+| Atributo | Descripción |
+|----------|-------------|
+| `data-responsive` | Items por breakpoint. JSON `{"0":1,"768":2,"1024":3}` o sintaxis corta `"sm:2, md:3, lg:4"` |
+| `data-autoplay-timeout` | Intervalo autoplay (ms) |
+| `data-mode` | `"gallery"` o `"carousel"` |
+| `data-speed` | Velocidad de transición (ms) |
+| `data-nav` | `"true"` para mostrar dots |
+
+Dots de navegación custom:
+```html
+<div class="c-tns-nav-container absolute bottom-4 left-0 w-full flex justify-center items-end z-20">
+  <div c-for="item in records"
+       class="pointer-events-auto cursor-pointer rounded-full border-2 border-white w-4 h-4 mx-1 bg-black bg-opacity-50">
+  </div>
+</div>
+```
+
+### Lightbox
+
+```html
+<a href="{{ image[0].urlPath }}" class="glightbox" data-gallery="gallery1">
+  <img src="{{ image[0].urlPath | imagec(400) }}">
+</a>
+```
+
+### Breadcrumb
+
+```html
+<breadCrumb class="bg-gray-200 p-3 rounded" c-prevlinks="null"></breadCrumb>
+```
+
+### Animate On Scroll (AOS)
+
+```html
+<div data-aos="fade-up" data-aos-duration="800">Contenido</div>
+```
+
+Valores comunes: `fade-up`, `fade-down`, `fade-left`, `fade-right`, `zoom-in`, `zoom-in-up`, `fade-up-right`, `fade-up-left`.
+
+Tras cambios dinámicos en JS:
+```js
+AOS.refresh();
+```
+
+### Lazy loading
+
+```html
+<!-- Builder var con lazy automático -->
+<img data-field-type="upload" data-field-label="Imagen" data-lazy="true" data-field-width="800" alt="">
+
+<!-- Manual en plantillas -->
+<img class="lazyload" data-src="{{ record.imagen[0].urlPath | imagec(800) }}" alt="">
+```
+
+## Reglas críticas
+
+1. `script.js` y `style.css` son **estáticos** — sin sintaxis Twig dentro.
+2. Para valores dinámicos en JS, pásalos desde `index-base.tpl` vía atributos `data-*`.
+3. Define una **clase raíz en kebab-case** por módulo. Scopea TODO el CSS/JS bajo ella.
+4. Tailwind first; CSS custom solo donde Tailwind no llegue, siempre con BEM.
+5. Vue 3: redefine `delimiters: ['${', '}']` para evitar conflicto con Twig.
+6. Mountea Vue sobre `#app-{{ section_id }}`.
+7. Usa las clases utilitarias de Acai (`transition3s`, `lazyload`, `bg-main-color`, etc.) antes de inventar utilidades.
+8. NO embebas lógica `<script>` dentro de `index-base.tpl` (Vue init es la única excepción común).

docs/08-layout-and-libraries.md

@@ -0,0 +1,212 @@
+# Layout Global y Librerías Globales
+
+Este documento explica cómo gestionar los **4 campos globales del proyecto** (`style` CSS global, `javascript` JS global, `header` Twig del header del sitio, `footer` Twig del footer) y las **librerías globales** (CSS/JS/fonts inyectadas en `<head>` o antes de `</body>`). Cubre la regla crítica de NO editar nunca `cms/lib/plugins/builder_saas/layout.json` ni los `.tpl` de `custom-header-twig` / `custom-footer-twig` directamente, las tools `get_layout_field` / `set_layout_field` (única vía válida para editar header/footer/style/javascript) y las tools `list_global_libraries` / `add_global_library` / `remove_global_library` / `set_global_libraries` para gestionar las URLs de librerías. Léelo antes de tocar cualquier cosa relacionada con header, footer, CSS global o librerías externas (jQuery, Vue CDN, Google Fonts, etc.).
+
+## Layout global
+
+Los 4 campos globales del proyecto viven en `cms/lib/plugins/builder_saas/layout.json`:
+
+| Campo | Contenido |
+|-------|-----------|
+| `style` | CSS global del proyecto (se inyecta en todas las páginas) |
+| `javascript` | JS global del proyecto (se inyecta en todas las páginas) |
+| `header` | Twig del header del sitio (se renderiza arriba de cada página) |
+| `footer` | Twig del footer del sitio (se renderiza al final de cada página) |
+
+Los campos `header` y `footer` son **Twig** — se beneficias de filtros (`| get`, `| translate`, etc.) y atributos (`c-if`, `c-for`).
+
+### REGLA CRÍTICA — Nunca edites estos archivos directamente
+
+**Está prohibido** usar `acai-view`, `acai-line-replace`, `acai-write` ni `acai-delete` sobre:
+
+- `cms/lib/plugins/builder_saas/layout.json`
+- `template/estandar/modulos/custom-header-twig/*`
+- `template/estandar/modulos/custom-footer-twig/*`
+- `template/estandar/modulos/custom-header/*`
+- `template/estandar/modulos/custom-footer/*`
+
+Estos ficheros son **artefactos generados** a partir de `layout.json`. Editarlos directamente provoca:
+- Desincronización con `layout.json.{header,footer}ModuleCustom.htmlParsed`.
+- Sobrescritura de tus cambios cuando el usuario abre el builder visual y guarda.
+- Comportamiento inconsistente entre el render público y el builder.
+
+**El backend protege estas rutas** — las tools de archivo devolverán error si intentas tocarlas.
+
+### Workflow correcto
+
+#### Leer
+
+```
+get_layout_field({ field: "header" })       // Twig source del header
+get_layout_field({ field: "footer" })       // Twig source del footer
+get_layout_field({ field: "style" })         // CSS global
+get_layout_field({ field: "javascript" })    // JS global
+```
+
+#### Escribir
+
+```
+set_layout_field({
+  field: "footer",
+  content: "<footer class='bg-gray-900 text-white py-10'>…nuevo HTML/Twig…</footer>"
+})
+```
+
+`set_layout_field` ejecuta una pipeline atómica:
+1. Escribe el source en `layout.json.{field}`.
+2. Sincroniza `layout.json.{field}ModuleCustom.htmlParsed`.
+3. Regenera los `.tpl` de `custom-{field}-twig/`.
+4. Compila el Twig a PHP.
+
+Es **destructivo** — sobrescribe el contenido completo. **Pair con `get_layout_field` primero** para leer el actual y modificarlo, no escribirlo desde cero.
+
+### Ejemplos de uso
+
+#### Cambiar el copyright del footer
+
+```
+// 1. Leer
+get_layout_field({ field: "footer" })
+// devuelve: <footer><p>© 2024 Mi Sitio</p>…</footer>
+
+// 2. Modificar localmente y reescribir entero
+set_layout_field({
+  field: "footer",
+  content: "<footer><p>© 2025 Mi Sitio. Todos los derechos reservados.</p>…</footer>"
+})
+```
+
+#### Añadir un menú al header
+
+```
+// 1. Leer source actual
+get_layout_field({ field: "header" })
+
+// 2. Escribir nueva versión con el menú añadido
+set_layout_field({
+  field: "header",
+  content: "<header>…<nav>{% for item in 'apartados' | get('parentNum=0 AND visible_en_el_menu=1', 'globalOrder ASC') %}<a href='{{ item.enlace }}'>{{ item.name }}</a>{% endfor %}</nav>…</header>"
+})
+```
+
+#### Añadir CSS global
+
+```
+// 1. Leer
+get_layout_field({ field: "style" })
+
+// 2. Reescribir con la regla añadida
+set_layout_field({
+  field: "style",
+  content: ":root { --main-color: #2563eb; }\n.btn-primary { … }\n…"
+})
+```
+
+## Librerías globales
+
+`layout.json["libraries"]` define una lista de URLs (CSS, JS, fonts) que el CMS inyecta en cada página. Hay **dos secciones**:
+
+| Sección | Posición | Uso típico |
+|---------|----------|------------|
+| `top` | Dentro de `<head>` | CSS, fonts (Google Fonts), JS crítico (preload) |
+| `bottom` | Antes de `</body>` | La mayoría de JS (jQuery, Vue, sliders, etc.) |
+
+### Tools
+
+#### Listar — `list_global_libraries`
+
+```
+list_global_libraries()
+```
+
+Devuelve:
+```json
+{
+  "top": [
+    { "num": 1, "url": "https://fonts.googleapis.com/css2?family=Inter" },
+    { "num": 2, "url": "/css/extras.css" }
+  ],
+  "bottom": [
+    { "num": 1, "url": "https://unpkg.com/vue@3/dist/vue.global.prod.js" },
+    { "num": 2, "url": "/js/main.js" }
+  ],
+  "layoutExists": true
+}
+```
+
+Llama a esta tool **antes** de añadir/quitar para no duplicar entradas.
+
+#### Añadir — `add_global_library`
+
+Idempotente: si la URL ya existe en esa sección, devuelve `added: false`.
+
+```
+add_global_library({
+  section: "bottom",
+  url: "https://unpkg.com/vue@3/dist/vue.global.prod.js"
+})
+
+add_global_library({
+  section: "top",
+  url: "https://fonts.googleapis.com/css2?family=Inter:wght@400;600&display=swap"
+})
+
+// Rutas relativas al proyecto también valen
+add_global_library({
+  section: "bottom",
+  url: "/js/custom.js"
+})
+```
+
+#### Eliminar — `remove_global_library`
+
+Idempotente: si la URL no existe, devuelve `removed: false`.
+
+```
+remove_global_library({
+  section: "bottom",
+  url: "https://unpkg.com/vue@3/dist/vue.global.prod.js"
+})
+```
+
+#### Reemplazar entera — `set_global_libraries`
+
+**Destructivo** — sobrescribe la lista completa de la sección. Úsalo solo para reordenar masivamente o reemplazar el conjunto. Para cambios incrementales prefiere `add_global_library` / `remove_global_library`.
+
+```
+set_global_libraries({
+  section: "bottom",
+  libraries: [
+    { url: "/js/jquery.min.js" },
+    { url: "/js/main.js" },
+    { url: "https://unpkg.com/vue@3/dist/vue.global.prod.js" }
+  ]
+})
+```
+
+### Convenciones
+
+- Para **librerías populares**, prefiere CDN oficial (`unpkg.com`, `cdn.jsdelivr.net`, `cdnjs.cloudflare.com`).
+- Para **assets propios** del proyecto, usa rutas relativas (`/js/main.js`, `/css/extras.css`).
+- Si añades una librería que ya tiene equivalente cargada (ej. dos versiones de jQuery), elimina la antigua antes de añadir la nueva.
+- El **orden** importa: las dependencias deben ir antes que sus consumidores. `set_global_libraries` permite reordenar.
+
+## Decisión: ¿layout global o módulo?
+
+| Caso | Solución |
+|------|----------|
+| Header/footer del sitio | Layout global (`set_layout_field` con `header`/`footer`) |
+| CSS aplicado a todo el sitio | Layout global (`set_layout_field` con `style`) o librería global |
+| JS aplicado a todo el sitio | Layout global (`set_layout_field` con `javascript`) o librería global |
+| Componente reutilizable en páginas | Módulo en `template/estandar/modulos/` |
+| Detalle de un registro | Sección general `custom-{tableName}` |
+| Bloque visual específico | Módulo |
+
+## Reglas críticas
+
+1. **NUNCA edites directamente** `layout.json`, `custom-header-twig/*`, `custom-footer-twig/*`, `custom-header/*`, `custom-footer/*`. Las tools de archivo te devolverán error si lo intentas.
+2. Para header/footer/style/javascript globales, **única vía**: `get_layout_field` + `set_layout_field`.
+3. `set_layout_field` es **destructivo** — siempre lee primero, modifica, escribe.
+4. Para librerías globales: `list_global_libraries` → `add_global_library` / `remove_global_library`. `set_global_libraries` solo para reordenar/reemplazar masivamente.
+5. Inyección automática: `top` va en `<head>`, `bottom` antes de `</body>`. Decide según el tipo de asset.
+6. El orden de las librerías importa para dependencias.

docs/09-mcp-tools-reference.md

@@ -0,0 +1,245 @@
+# MCP Tools — Referencia Completa
+
+Este documento es el **inventario canónico** de todas las tools MCP disponibles para el agente Acai. Está agrupado por categoría (archivos, módulos, registros, tablas, layout, librerías, hooks, media, navegación, proyecto, git, autenticación, docs) y describe para cada tool su propósito, parámetros clave, qué devuelve y cuándo usarla. Incluye además los **workflows canónicos** para las operaciones más comunes (crear módulo, editar módulo, crear funcionalidad nueva con tabla + detalle, gestionar imágenes de un módulo, editar header/footer, configurar middleware de hook). Léelo antes de cualquier tarea para elegir la secuencia correcta de tools.
+
+## Inventario por categoría
+
+### Archivos
+
+| Tool | Acción | Notas |
+|------|--------|-------|
+| `acai-view` | Lee un archivo (con rango de líneas opcional) | Ahorra tokens — usa `start_line`/`end_line` |
+| `acai-glob` | Encuentra archivos por patrón glob | `template/estandar/modulos/**/index-base.tpl` |
+| `acai-grep` | Busca texto/regex en archivos | Soporta filtro por glob |
+| `acai-write` | Crea o reescribe un archivo completo | **Editar `index-base.tpl` compila automáticamente** |
+| `acai-line-replace` | Reemplaza un bloque de líneas validado | Preferida sobre `acai-write` para edits puntuales |
+| `acai-delete` | Elimina un archivo | Destructivo — confirma primero |
+
+Reglas:
+- Rutas siempre relativas al proyecto.
+- Editar `index-base.tpl` → compila automáticamente. No necesitas llamar a `compile_module`.
+- **NO toques** `index.tpl`, `index-twig.tpl`, `builder.json` (autogenerados) ni los archivos de layout protegidos (ver `08-layout-and-libraries.md`).
+
+### Módulos
+
+| Tool | Acción | Notas |
+|------|--------|-------|
+| `create_module` | Crea un módulo nuevo (carpeta + archivos + compile) | Alternativa a hacer `acai-write` manual del `index-base.tpl`. Genera `moduleId` único añadiendo sufijo aleatorio. |
+| `compile_module` | Recompila manualmente (rescate) | Solo si los archivos generados están desincronizados. Editar `index-base.tpl` con tools de archivo ya compila. |
+| `check_module` | Preview del render con datos de ejemplo | Devuelve preview (50 líneas) por defecto; `fullRender:true` para todo |
+| `check_module_usage` | Lista páginas que usan el módulo | **OBLIGATORIO antes de `delete_module`** |
+| `delete_module` | Elimina la carpeta del módulo | Destructivo. Si `inUse=true`, deniega — el usuario debe quitarlo de las páginas primero |
+| `set_module_example_data` | Define datos de ejemplo para preview en el editor | Pasar valores para TODAS las variables del schema |
+
+### Registros (records)
+
+| Tool | Acción | Notas |
+|------|--------|-------|
+| `list_table_records` | Lista registros con filtros, paginación | Usa `fields` y `truncateText` para ahorrar tokens |
+| `get_record` | Obtiene un registro completo por `num` | Carga uploads + relations por defecto |
+| `create_or_update_record` | Crea o actualiza registros | Sin `recordId` → crea. Con `recordId` → actualiza. Acepta array para batch |
+| `delete_table_records` | Elimina registros (por IDs o `deleteAll`) | **Destructivo permanente** |
+| `list_page_modules` | Lista módulos colocados en una página Builder | Devuelve sectionIds, posiciones, visibilidad, configVars |
+| `add_module_to_record` | Añade módulo a una página Builder | Devuelve `sectionId` — úsalo en `set_module_config_vars` |
+| `remove_module_from_record` | Quita módulo de la página | Por `sectionId` (preferido) o `modulePosition` |
+| `reorder_module` | Mueve módulo a otra posición | `fromPosition` → `toPosition` |
+| `toggle_module_visibility` | Muestra/oculta sin borrar | Por `sectionId` |
+| `get_module_config_vars` | Lee valores actuales de las variables | Por `tableName` + `recordNum` + `sectionId` |
+| `set_module_config_vars` | Escribe variables del módulo | Devuelve `uploadFields` con `recordNum`+`fieldName` listos para subir imágenes |
+
+### Tablas y campos (schema)
+
+Ver `05-tables-and-fields.md` para detalles. Tools:
+
+| Tool | Acción |
+|------|--------|
+| `list_tables` | Inventario de tablas (sin `cms_`) |
+| `get_table_schema` | Schema completo. Soporta `minimal:true` y `filterFields:"..."` para ahorrar tokens |
+| `create_table` | Crea tabla nueva. PREGUNTA al usuario sobre `enlace`/`seoMetas` antes |
+| `update_table_metadata` | Actualiza el `[meta]`. `newTableName` renombra MySQL (destructivo) |
+| `delete_table` | Borra tabla. Usa `dryRun:true` primero. `dropData:true` borra datos |
+| `reorder_tables` | Reordena sidebar admin |
+| `create_field` | Añade campo a tabla |
+| `update_field` | Actualiza props. `newFieldName` renombra columna (destructivo). Cambios de `type` pueden truncar datos — surfacea `warnings` |
+| `delete_field` | Borra campo. `dropColumn:true` borra datos permanentemente |
+| `reorder_fields` | Reordena los campos del formulario admin |
+| `regenerate_enlaces` | Regenera URLs de la tabla. `generateAlias:true` para preservar redirects |
+
+### Layout global
+
+Ver `08-layout-and-libraries.md`.
+
+| Tool | Acción |
+|------|--------|
+| `get_layout_field` | Lee `style`/`javascript`/`header`/`footer` del `layout.json` |
+| `set_layout_field` | Escribe el campo (atómico: actualiza json + regenera tpl + compila). Destructivo |
+
+### Librerías globales
+
+| Tool | Acción |
+|------|--------|
+| `list_global_libraries` | Lista las URLs `top` (head) y `bottom` (antes de `</body>`) |
+| `add_global_library` | Añade URL idempotente |
+| `remove_global_library` | Quita URL idempotente |
+| `set_global_libraries` | Reemplaza la lista de la sección. Destructivo |
+
+### Hooks (middleware)
+
+| Tool | Acción |
+|------|--------|
+| `get_hook_middleware` | Lee la config `middleWare` de un hook global |
+| `set_hook_middleware` | Configura cuándo se ejecuta automáticamente: `[]`, `["allurls"]`, `["<tableName>-<num>"]` |
+
+Ver `06-hooks-and-cmsapi.md` para uso. Crear/editar el `.php` del hook se hace con `acai-write`.
+
+### Media
+
+| Tool | Acción | Notas |
+|------|--------|-------|
+| `generate_image` | Genera imagen con IA y la guarda en `cms/uploads/generated/` | Devuelve `dockerUrl` y `uploadUrl`/`fullUrl`. **En Forge prefiere `uploadUrl`/`fullUrl`** sobre `dockerUrl` para `upload_record_image` |
+| `upload_record_image` | Sube imagen a un campo de un registro | Necesita `tableName`, `recordId` (num), `fieldName` real (de relations o `uploadFields`) |
+| `upload_image_to_assets` | Sube imagen a `/images/` del template (assets globales) | Acepta base64, data URI, URL. Permite resize/quality/format |
+
+### Navegación
+
+| Tool | Acción |
+|------|--------|
+| `navigate_browser` | Navega el browser preview del usuario a un `enlace` (e.g. `/servicios/`) |
+
+### Proyecto
+
+| Tool | Acción |
+|------|--------|
+| `get_web_url` | URL del sitio en desarrollo. **OBLIGATORIO** antes de fetch/Playwright. Acuérdate de añadir `?pruebas=1` |
+| `save_project_styles` | Guarda resumen de estilos en `docs/project-styles.md` |
+
+### Git
+
+| Tool | Acción |
+|------|--------|
+| `list_git_log` | Lista los últimos commits para que el usuario elija un id de rollback |
+| (rollback) | Tool de rescate; pide confirmación al usuario |
+
+### Autenticación
+
+| Tool | Acción |
+|------|--------|
+| `refresh_acai_token` | Renueva el JWT cuando expira (errores 403) |
+
+### Documentación
+
+| Tool | Acción |
+|------|--------|
+| `read_doc` | Lee un doc del knowledge base completo o por sección. Útil cuando un doc no fue cargado por relevancia o necesitas una sección puntual |
+| `list_docs` | Lista los docs disponibles con sus títulos y summaries |
+
+## Workflows canónicos
+
+### 1. Crear un módulo nuevo
+
+1. **Estilo del proyecto**: si existe `docs/project-styles.md` léelo. Si no, explora 3-4 módulos representativos (no `custom-*`) y guarda con `save_project_styles`.
+2. **Lee la doc relevante** según contenido: `01-builder-fields.md` siempre; `07-css-js-conventions.md` si lleva JS; `06-hooks-and-cmsapi.md` si lleva hook PHP; `02-twig.md` si usa filtros.
+3. **`acai-write`** sobre `template/estandar/modulos/<moduleId>_xxxxxx/index-base.tpl` con el HTML/Twig. Si necesita CSS/JS/PHP, escribe también `style.css`, `script.js`, `hook.php`.
+4. **Compilación automática** al escribir `index-base.tpl`. Si por algún motivo necesitas forzarla sin tocar el archivo: `compile_module`.
+5. **`add_module_to_record`** para colocarlo en una página. Devuelve `sectionId`.
+6. **`set_module_config_vars`** para rellenar variables (textos, listas, etc.). Devuelve `uploadFields` con `recordNum`+`fieldName` por cada upload.
+7. **Imágenes**: `generate_image` o `upload_record_image` usando el `recordNum` y `fieldName` del paso 6.
+8. **`navigate_browser`** al `enlace` de la página para que el usuario vea el resultado.
+
+### 2. Editar un módulo existente
+
+1. `get_module_config_vars` — leer estado actual (vars + recordNums).
+2. `acai-view` — leer el rango concreto de `index-base.tpl` que vas a tocar.
+3. `acai-line-replace` — modificar el bloque (compila automáticamente). Usa `acai-write` solo si el cambio es masivo.
+4. Si cambian variables: `set_module_config_vars` para actualizar valores.
+
+### 3. Gestionar imágenes de un módulo
+
+**Tras `set_module_config_vars`** (recomendado):
+1. La respuesta incluye `uploadFields` con `{ fieldName, recordNum }` por cada variable upload.
+2. Para multi vars con uploads: `uploadFields["records.imagen"]` es array `[{index, fieldName, recordNum}]`.
+3. `upload_record_image` con `tableName: "builder_custom"`, `recordId` y `fieldName` de `uploadFields`.
+
+**Sin `set_module_config_vars` previo**:
+1. `get_module_config_vars` — obtiene `recordNum` de builder_custom.
+2. Lee `builder.json` del módulo para encontrar el `fieldName` real (de `vars.NOMBRE.relations.builder_custom`, ej. `image1` — **NO** uses el nombre de la variable).
+3. `upload_record_image` con `tableName: "builder_custom"`, `recordId` (recordNum del paso 1), `fieldName` (de relations).
+
+Generar imagen primero:
+1. `generate_image` con `prompt` + `style`.
+2. Usa la URL recomendada que devuelve (`uploadUrl` o `fullUrl` en Forge; `dockerUrl` solo en local).
+3. `upload_record_image` con esa URL.
+
+### 4. Crear funcionalidad nueva con tabla + detalle
+
+Ejemplo: implementar "Vacantes".
+
+1. **`create_table`** con `tableName: "vacantes"`, `menuType: "multi"`, `enlace: true`, `seoMetas: true`. Pregunta al usuario antes los flags.
+2. **`create_field`** para cada campo: `titulo`, `descripcion` (wysiwyg), `salario_minimo` (textfield), `categoria_num` (list desde tabla), `fecha_publicacion` (date), `fecha_expiracion` (date), `visible` (checkbox), `imagen_destacada` (upload).
+3. **`acai-write`** sobre `template/estandar/modulos/custom-vacantes/index-base.tpl` con el Twig que usa `thisrecord.*` (sección general que renderiza el detalle de cada registro).
+4. (Opcional) **Módulo de listado** `vacantes_listado_xxxxxx` con `'vacantes' | get('visible=1', 'fecha_publicacion DESC', 20)`.
+5. (Opcional) **Página índice** `/vacantes/` en `apartados` (Builder) con el módulo de listado dentro.
+6. **`navigate_browser`** a un detalle creado para verificar.
+
+### 5. Editar header / footer del sitio
+
+Ver `08-layout-and-libraries.md`.
+
+1. `get_layout_field({ field: "header" })` — lee Twig actual.
+2. Modifica localmente.
+3. `set_layout_field({ field: "header", content: "..." })` — atómico. Sobrescribe `layout.json`, regenera `.tpl` y compila.
+
+**NUNCA** uses `acai-write` sobre `custom-header-twig/index-base.tpl` ni `layout.json`.
+
+### 6. Añadir librería global (jQuery, Vue CDN, Google Fonts)
+
+1. `list_global_libraries` — comprueba si ya existe.
+2. `add_global_library({ section: "bottom", url: "..." })` para JS, o `top` para CSS/fonts.
+
+Para reordenar dependencias: `set_global_libraries` con la lista completa.
+
+### 7. Hook con middleware (auto-ejecutar antes de páginas)
+
+1. **`acai-write`** sobre `hooks/hooks.<id>.php` con la lógica.
+2. **`get_hook_middleware`** sobre `/hooks/<id>/` para ver config actual.
+3. **`set_hook_middleware`** con el nuevo `middleWare`:
+   - `[]` → solo cuando se llama explícitamente
+   - `["allurls"]` → antes de cada página
+   - `["cms_apartados-2"]` → solo antes del registro num=2 de apartados
+
+### 8. Gestionar registros de una tabla
+
+1. `list_table_records` con `where`/`order`/`limit`/`fields` (sin `cms_`).
+2. `get_record` para uno completo (`tableName`+`recordNum`).
+3. `create_or_update_record` para crear/actualizar. Antes consulta el schema con `get_table_schema`.
+4. `delete_table_records` para borrar (destructivo permanente).
+
+### 9. Explorar el sitio
+
+- `list_table_records` sobre `apartados` para ver páginas.
+- `list_page_modules` sobre una página para ver módulos.
+- `get_module_config_vars` para ver datos de un módulo.
+- `check_module` para preview con datos custom.
+
+### 10. Consultar la documentación bajo demanda
+
+Si el knowledge_base no cargó un doc relevante (lo verás en "Other Available Docs") o necesitas una sección puntual con detalle:
+
+```
+list_docs()                                    // todos los docs con summary
+read_doc({ name: "05-tables-and-fields" })     // doc completo
+read_doc({ name: "06-hooks-and-cmsapi", section: "Hook middleware" })   // sección por heading H2
+```
+
+## Reglas globales para todas las tools
+
+1. **`tableName` siempre SIN prefijo `cms_`** (excepto en `queryDB` Twig y en el `middleWare` de `set_hook_middleware`).
+2. **PK siempre `num`**, nunca `id`. Foreign keys con sufijo `_num`.
+3. **Upload fields son arrays** — accede con `[0].urlPath`.
+4. **`fieldName` para imágenes** viene de `builder.json` → `vars.NOMBRE.relations.builder_custom` (ej. `image1`), NO del nombre de la variable.
+5. **`recordId` para imágenes de módulo** es el `num` de `builder_custom`, NO el `sectionId`.
+6. Tras `set_module_config_vars`, **TODAS** las variables (incluidos uploads) reciben `recordNum`+`fieldName` en `uploadFields`.
+7. Si un token JWT expira (error 403): `refresh_acai_token` y reintentar.
+8. Al pedir URLs del sitio: `get_web_url` SIEMPRE primero. Añade `?pruebas=1` para modo desarrollo. Nunca uses dominios de producción ni `localhost:8080`.
+9. Antes de crear archivos, **lee la doc** relevante (`read_doc` si no está en el KB cargado).
+10. Operaciones destructivas (`delete_*`, `dropColumn`, `dropData`, `dropTable`, `newTableName`, `newFieldName`, `regenerate_enlaces` sin alias, `set_global_libraries`, `set_layout_field`): **pide confirmación al usuario** si no es trivial.

docs/10-production-patterns.md

@@ -1,12 +1,10 @@
 # Patrones de Producción
 
-Patrones reales usados en módulos y secciones generales de producción. Usar como referencia al crear nuevos módulos.
+Este documento recoge patrones reales usados en módulos y secciones generales de proyectos Acai en producción. Cada patrón incluye el HTML/Twig listo para reutilizar y notas sobre cuándo aplicarlo. Cubre: cabecera de sección con colores configurables, layout zigzag (imagen + texto alternado), acordeón FAQ, formulario de contacto completo con `c-form`, compartir en redes sociales, sección general de detalle de producto, galería con carousel modo `gallery`. Léelo cuando vayas a crear un módulo y quieras evitar reinventar patrones que ya tienen una versión canónica testeada en producción.
 
----
+## 1. Cabecera de sección (Pretítulo + Título + Subtítulo)
 
-## Patrón 1: Cabecera de Sección (Pretítulo + Título + Subtítulo)
-
-Bloque de cabecera con colores y alineación configurables. Casi todos los módulos lo usan:
+Bloque de cabecera con colores y alineación configurables. Casi todos los módulos lo usan como inicio.
 
 ```html
 <div c-hidden="true">
@@ -52,11 +50,9 @@ Bloque de cabecera con colores y alineación configurables. Casi todos los módu
 </section>
 ```
 
----
+## 2. Layout Zigzag (imagen + texto alternado)
 
-## Patrón 2: Layout Zigzag/Ajedrez (Imagen + Texto alternado)
-
-Usa `loop.index is odd/even` para alternar:
+Usa `loop.index is odd/even` para alternar la dirección.
 
 ```html
 <li c-for="record in records" class="w-full py-6">
@@ -80,9 +76,7 @@ Usa `loop.index is odd/even` para alternar:
 </li>
 ```
 
----
-
-## Patrón 3: Acordeón FAQ
+## 3. Acordeón FAQ
 
 ```html
 <li data-field-type="multiv2" data-field-label="Records" data-aos="fade-up" data-aos-duration="800">
@@ -101,27 +95,27 @@ Usa `loop.index is odd/even` para alternar:
 </li>
 ```
 
-JavaScript para toggle:
-```javascript
-document.addEventListener("DOMContentLoaded", function () {
-    document.querySelectorAll(".faq-page").forEach(faq => {
-        faq.addEventListener("click", function () {
+`script.js`:
+```js
+document.addEventListener("DOMContentLoaded", () => {
+    document.querySelectorAll(".faq-page").forEach((faq) => {
+        faq.addEventListener("click", () => {
             const body = faq.nextElementSibling;
             const isActive = faq.classList.toggle("active");
             body.classList.toggle("hidden", !isActive);
-            AOS.refresh();
+            if (typeof AOS !== "undefined") AOS.refresh();
         });
     });
 });
 ```
 
----
-
-## Patrón 4: Formulario de Contacto Completo
+## 4. Formulario de contacto completo
 
 ```html
 <set :tienda="'configuracion_tienda' | get('num != 0')[0]"></set>
-<set :logo="tienda.logo.0.urlPath ? 'https://' ~ server.HTTP_HOST ~ tienda.logo.0.urlPath : 'https://' ~ server.HTTP_HOST ~ '/template/estandar/images/logo.png'"></set>
+<set :logo="tienda.logo.0.urlPath
+            ? 'https://' ~ server.HTTP_HOST ~ tienda.logo.0.urlPath
+            : 'https://' ~ server.HTTP_HOST ~ '/template/estandar/images/logo.png'"></set>
 {% set imagen = '<img src="' ~ logo ~ '" style="max-height:150px; display: block; margin: 0 auto;">' %}
 {% set gracias = 'apartados' | get('num = 20').0 %}
 
@@ -136,19 +130,19 @@ document.addEventListener("DOMContentLoaded", function () {
 
     <input type="text" name="nombre" required
            placeholder="{{ 'Nombre' | translate }}"
-           class="w-full bg-white border border-neutral-400 rounded-xl px-6 py-2 my-1" />
+           class="w-full bg-white border border-neutral-400 rounded-xl px-6 py-2 my-1">
     <input type="email" name="email" required
            placeholder="{{ 'Email' | translate }}"
-           class="w-full bg-white border border-neutral-400 rounded-xl px-6 py-2 my-1" />
+           class="w-full bg-white border border-neutral-400 rounded-xl px-6 py-2 my-1">
     <input type="text" name="telefono" required
            placeholder="{{ 'Teléfono' | translate }}"
-           class="w-full bg-white border border-neutral-400 rounded-xl px-6 py-2 my-1" />
+           class="w-full bg-white border border-neutral-400 rounded-xl px-6 py-2 my-1">
     <textarea name="comentario" cols="30" rows="5"
               placeholder="{{ 'Escribe aquí tu comentario' | translate }}..."
               class="w-full bg-white border border-neutral-400 rounded-xl resize-none px-6 py-2 my-1"></textarea>
 
     <label class="w-full flex items-start mt-4">
-        <input required type="checkbox" class="mt-1" />
+        <input required type="checkbox" class="mt-1">
         <span class="text-xs sm:text-sm ml-3">{{ 'Acepto las condiciones legales' | translate | raw }}</span>
     </label>
 
@@ -163,9 +157,7 @@ document.addEventListener("DOMContentLoaded", function () {
 </c-form>
 ```
 
----
-
-## Patrón 5: Compartir en Redes Sociales
+## 5. Compartir en redes sociales
 
 ```html
 <ul class="flex flex-wrap -mx-1 mt-4">
@@ -184,12 +176,12 @@ document.addEventListener("DOMContentLoaded", function () {
 </ul>
 ```
 
----
+## 6. Sección general — Detalle de producto
 
-## Patrón 6: Sección General — Detalle de Producto
+Patrón completo para `template/estandar/modulos/custom-productos/index-base.tpl`:
 
 ```html
-<set :tienda="'configuracion_tienda' | get('num !=0')[0]"></set>
+<set :tienda="'configuracion_tienda' | get('num != 0')[0]"></set>
 
 <section class="detalle-producto">
     <div class="container mx-auto max-w-7xl px-6 2xl:px-0 mt-20 mb-10">
@@ -238,9 +230,7 @@ document.addEventListener("DOMContentLoaded", function () {
 </section>
 ```
 
----
-
-## Patrón 7: Galería con Carousel (modo Gallery)
+## 7. Galería con carousel — modo Gallery
 
 ```html
 <div class="c-tns-wrapper" data-autoplay-timeout="8000" data-mode="gallery" data-speed="400" data-nav="true">
@@ -260,3 +250,49 @@ document.addEventListener("DOMContentLoaded", function () {
     </div>
 </div>
 ```
+
+## 8. Listado con filtros y paginación
+
+```html
+<set :categorias="'categorias' | get('visible=1', 'orden ASC')"></set>
+{% set perPage = 12 %}
+{% set page = pagina | default(1) %}
+{% set offset = (page - 1) * perPage %}
+
+<div class="container mx-auto max-w-7xl px-6 py-10">
+    <!-- Filtros -->
+    <nav class="flex flex-wrap gap-2 mb-8">
+        <a href="?cat=" class="px-4 py-2 rounded-full bg-gray-200">{{ 'Todas' | translate }}</a>
+        {% for cat in categorias %}
+            <a href="?cat={{ cat.num }}" class="px-4 py-2 rounded-full bg-gray-200">{{ cat.nombre }}</a>
+        {% endfor %}
+    </nav>
+
+    <!-- Listado -->
+    {% set where = 'visible=1' %}
+    {% if cat_filter %}
+        {% set where = where ~ ' AND categoria_num=' ~ cat_filter %}
+    {% endif %}
+
+    {% set productos = 'productos' | get(where, 'orden ASC', perPage) %}
+    <ul class="grid grid-cols-1 md:grid-cols-3 gap-6">
+        {% for prod in productos %}
+            <li class="bg-white rounded-xl shadow p-4">
+                <a href="{{ prod.enlace }}">
+                    <img src="{{ prod.imagen[0].urlPath | imagec(400) }}" alt="{{ prod.nombre }}" class="w-full aspect-video object-cover rounded">
+                    <h3 class="text-lg font-semibold mt-3">{{ prod.nombre }}</h3>
+                    <p class="text-gray-600">{{ prod.descripcion | truncate(100) }}</p>
+                </a>
+            </li>
+        {% endfor %}
+    </ul>
+</div>
+```
+
+## Reglas de aplicación
+
+- Estos patrones son **referencia** — adáptalos al estilo del proyecto (ver `docs/project-styles.md` si existe).
+- Reutiliza **clases utilitarias de Acai** (`bg-main-color`, `transition3s`, `lazyload`, `glightbox`, `c-tns-wrapper`) antes de inventar.
+- Para campos editables siempre añade `data-field-label` (ver `01-builder-fields.md`).
+- Para `c-form`, prefiere usarlo antes de construir POST/hook custom.
+- Para detalle de registro usa **siempre** la convención `custom-{tableName}/`.

docs/11-quick-reference.md

@@ -0,0 +1,128 @@
+# Quick Reference — Cheat sheet
+
+Este documento es un **resumen ejecutable** de las reglas críticas, los tipos de campo, los filtros Twig, los formatos de datos para insert/update y las variables globales. Es la **fuente única de verdad** para resolver dudas rápidas sin tener que abrir los docs largos. Léelo antes de cualquier operación cuando quieras refrescar las reglas; el resto de docs (`01`–`10`) profundizan en cada tema.
+
+## Reglas inmutables
+
+| Regla | Correcto | Incorrecto |
+|-------|----------|------------|
+| Nombres de tabla en tools/Twig/CmsApi | `'productos'` | `'cms_productos'` |
+| Nombres en `queryDB` | `cms_productos` | `productos` |
+| Primary key | `record.num` | `record.id` |
+| Foreign keys | `categoria_num` | `categoria_id` |
+| Upload fields | `record.imagen[0].urlPath` | `record.imagen` |
+| Optimizar imagen | `imagen[0].urlPath \| imagec(800)` | `imagen.url` |
+| Filtros Twig | `{{ 'tabla' \| get() }}` | `{{ get('tabla') }}` |
+| Campo enlace | `{{ producto.enlace }}` (ya tiene barras) | `"/{{ producto.enlace }}/"` |
+| Builder var name | `data-field-label` → minúsculas, sin espacios | Mantener casing original |
+| Checkbox | `1` o `0` (número) | `true` / `false` |
+| Formato fecha | `YYYY-MM-DD HH:mm:ss` | Cualquier otro |
+| `c-if` igualdad | `c-if="x = 'valor'"` (un `=`) | `c-if="x == 'valor'"` |
+| Twig `{% if %}` | `{% if x == 'valor' %}` (doble `==`) | `{% if x = 'valor' %}` |
+| Concatenación Twig | `'value=' ~ variable` | `'value=' + variable` |
+
+## Tipos de builder field (`data-field-type`)
+
+| Tipo | Elemento | Devuelve |
+|------|----------|----------|
+| `textfield` | `<p>` | String |
+| `headfield` | `<h1>`–`<h6>` | String + variable `_tag` |
+| `textbox` | `<div>` | String multilínea |
+| `wysiwyg` | `<div class="wysiwyg">` | HTML string |
+| `link` | `<a>` | URL string |
+| `upload` | `<img>` | Array `[{urlPath, info1, info2, info3, info4}]` |
+| `uploadMulti` | `<li>` | Itera archivos subidos |
+| `list` (fijo) | `<div data-list-options="...">` | Valor seleccionado |
+| `list` (tabla) | `<div data-list-table="...">` | `num` del registro |
+| `multiv2` | `<li>` wrapper | Array de objetos |
+| `checkbox` | `<input>` o `<div>` | `1` / `0` |
+| `colorpicker` | `<div>` | Hex color |
+
+## Atributos Acai
+
+| Atributo | Uso | Ejemplo |
+|----------|-----|---------|
+| `c-if` | Condicional | `<p c-if="activo = 1">` |
+| `c-else` | Rama else | `<p c-else>` |
+| `c-for` | Loop array | `<li c-for="item in items">` |
+| `c-for` (tabla) | Loop BD | `<li c-for="p in productos" c-where="'activo=1'" c-limit="10">` |
+| `c-hidden` | Variable oculta | `<div c-hidden="true">` |
+| `c-class` | Clase condicional | `<div c-class="{ 'bg-red': color == '1' }">` |
+| `c-required` | Required condicional | `c-required="'2' not in camposquitar"` |
+| `c-form` | Formulario | `<c-form tableName="'contacto'" captcha="true">` |
+
+## Filtros Twig
+
+| Filtro | Uso |
+|--------|-----|
+| `get` | `'tabla' \| get(where, order, limit)` |
+| `queryDB` | `'SELECT ... FROM cms_tabla' \| queryDB()` |
+| `hook` | `'hooks/module_id/' \| hook({params})` |
+| `module` | `'module_id' \| module({params})` |
+| `imagec` | `path \| imagec(width)` |
+| `translate` | `'texto' \| translate` (tabla `textos_generales`) |
+| `raw` | `variable \| raw` |
+| `truncate` | `text \| truncate(100)` |
+| `json_decode` | `'json_string' \| json_decode` |
+| `default` | `variable \| default('fallback')` |
+| `length`, `upper`, `lower`, `trim`, `replace`, `split`, `filter` | Estándar Twig |
+
+## Formato de datos para insert/update
+
+| Tipo | Formato | Ejemplo |
+|------|---------|---------|
+| `textfield` | String | `"Texto"` |
+| `textbox` | String multilínea | `"Línea 1\nLínea 2"` |
+| `date`/datetime | `YYYY-MM-DD HH:mm:ss` | `"2025-12-03 10:30:00"` |
+| `wysiwyg` | HTML string | `"<p>Texto</p>"` |
+| `list` | String o número | `"activo"` o `"1"` |
+| `checkbox` | Número 1/0 | `1` o `0` |
+| `multitext` | String JSON | `"[{\"item\":\"valor\"}]"` |
+| `upload` | NO enviar — usar `upload_record_image` después |
+
+## Variables globales
+
+| Variable | Descripción |
+|----------|-------------|
+| `section_id` | ID único por instancia del módulo |
+| `interno` | `true` dentro del editor CMS |
+| `server.HTTP_HOST` | Dominio actual (sin protocolo) |
+| `loop.index` | Índice 1-based en `c-for`/`{% for %}` |
+| `loop.index is odd` / `is even` | Layouts alternados |
+| `thisrecord` | Registro actual (solo en secciones generales) |
+
+## Decisión rápida — qué tool usar
+
+| Intención | Tool / workflow |
+|-----------|-----------------|
+| Crear módulo nuevo | `acai-write` `index-base.tpl` → `add_module_to_record` → `set_module_config_vars` |
+| Editar template de módulo | `acai-view` → `acai-line-replace` |
+| Ver datos de un módulo en una página | `get_module_config_vars` |
+| Cambiar valores de un módulo | `set_module_config_vars` |
+| Subir imagen a un módulo | Usa `uploadFields` de `set_module_config_vars` → `upload_record_image` (`tableName: "builder_custom"`) |
+| Crear tabla nueva | `create_table` (pregunta `enlace`/`seoMetas` antes) → `create_field` |
+| Crear detalle de registro | Sección general en `template/estandar/modulos/custom-{tableName}/` |
+| Editar header / footer | `get_layout_field` → `set_layout_field` (NUNCA edites los `.tpl` directamente) |
+| Añadir librería global | `list_global_libraries` → `add_global_library` (`top` o `bottom`) |
+| Hook que se ejecuta antes de cada página | `acai-write` el `.php` → `set_hook_middleware({ middleWare: ["allurls"] })` |
+| Generar imagen IA | `generate_image` → `upload_record_image` con `uploadUrl`/`fullUrl` |
+| Buscar archivos | `acai-glob` |
+| Buscar texto en archivos | `acai-grep` |
+| URL del proyecto | `get_web_url` (añade `?pruebas=1`) |
+| Navegar el preview del usuario | `navigate_browser` |
+| Token JWT expirado (403) | `refresh_acai_token` |
+| Necesito un doc no cargado | `read_doc({ name: "..." })` |
+| Listado de docs | `list_docs()` |
+
+## Errores comunes a evitar
+
+- Editar `index.tpl`, `index-twig.tpl` o `builder.json` (autogenerados).
+- Editar `layout.json` o `custom-header-twig/*` directamente (usa `set_layout_field`).
+- Usar el `sectionId` como `recordId` para subir imágenes (es el `num` de `builder_custom`).
+- Usar el nombre de la variable como `fieldName` (es el campo de relations: `image1`, no `imagenes`).
+- Crear página por registro en `apartados` para detalles (usa `custom-{tableName}/`).
+- Cambiar `enlace` o `controlador` de un registro existente.
+- Usar `localhost:8080` o dominios de producción (siempre `get_web_url` + `?pruebas=1`).
+- Crear archivos JSON de i18n (usa `| translate` + tabla `textos_generales`).
+- Usar Twig dentro de `script.js` o `style.css` (estáticos — pasa valores via `data-*`).
+- Llamar `mkdir` (usa `acai-write` directamente — crea el directorio padre).

docs/ACAI-CLAUDE.md

@@ -1,143 +0,0 @@
-# Acai CMS — Project Instructions
-
-This is an Acai CMS website project. Follow these instructions when working with the codebase.
-
-## Environment
-
-- The site runs in Docker, typically at **http://localhost:8080**
-- You can make HTTP requests to test pages, APIs, or form submissions
-- If you need to inspect the live site, use browser tools (Playwright MCP) or HTTP requests to localhost:8080
-
-## Project Structure
-
-```
-.
-├── template/estandar/
-│   ├── modulos/          # Builder modules (visual components)
-│   │   └── <module-id>/
-│   │       ├── index-base.tpl    # Twig template (source — EDIT THIS)
-│   │       ├── style.css         # Module styles
-│   │       └── script.js         # Module JavaScript
-│   │       ├── index.tpl         # Compiled (auto-generated, do NOT edit)
-│   │       ├── index-twig.tpl    # Compiled (auto-generated, do NOT edit)
-│   │       └── builder.json      # Compiled builder vars (auto-generated, do NOT edit)
-│   ├── css/              # Global CSS
-│   └── js/               # Global JavaScript
-├── hooks/                # PHP hooks (server-side logic)
-├── cms/
-│   ├── data/schema/      # Database table schemas (JSON)
-│   ├── lib/plugins/      # CMS plugins
-│   └── uploads/          # Uploaded media files
-├── .acai                 # Project config (domain, tokens, DB credentials)
-├── .docker/
-│   ├── .env              # Docker environment (DB credentials)
-│   ├── docker-compose.yml
-│   ├── tunnel-url.txt    # Public tunnel URL (if active)
-│   └── bore-db-url.txt   # Database tunnel URL (if active)
-└── database.sql          # Database dump
-```
-
-## Key Concepts
-
-### Modules (`template/estandar/modulos/`)
-Visual components that the site builder uses. Each module is a self-contained unit with its own template (Twig + Acai attributes), CSS, and JS. Modules are placed on pages via the drag-and-drop builder. The editable file is always `index-base.tpl`.
-
-- Include other modules: `<module_id :param1="value1"></module_id>`
-- Each module instance gets a unique `section_id` variable for anchors/scoping
-- Use `interno` variable to detect CMS editor mode vs public view
-
-See [docs/modular-system.md](docs/modular-system.md) for detailed rules.
-
-### Pages
-Every record with an `enlace` field is a page. Pages are either **Builder** (modular) or **Standard**:
-
-- **Builder**: `controlador` = `cms/lib/plugins/builder_saas/controlador.php` — content via modules
-- **Standard**: `controlador` = `cms/lib/plugins/builder_saas/controlador_tabla.php` — content in record fields
-
-**Critical**: Never change `enlace` or `controlador` of existing pages unless explicitly asked.
-
-See [docs/pages-and-records.md](docs/pages-and-records.md) for full details.
-
-### General Sections
-Database-backed templates (headers, footers, record views) that use the `thisrecord` variable to access record fields. They use the same Twig + Acai attribute engine as modules.
-
-- Upload fields return arrays: `thisrecord.image[0].urlPath`
-- Foreign keys use `_num` suffix: `category_num`
-
-See [docs/modular-system.md](docs/modular-system.md) for details.
-
-### Hooks (`hooks/`)
-PHP files that execute server-side logic. Triggered by:
-- Twig filter: `'hooks/module_id/' | hook({param: value})`
-- HTML tag: `<hook result="var" endpoint="/hooks/module_id/" :param="value"></hook>`
-- JavaScript: `CmsApi.hook('/hooks/module_id/', {param: value}, callback)`
-- Form action: via `c-form` attribute
-
-See [docs/hooks-and-api.md](docs/hooks-and-api.md) for usage.
-
-## Database Access
-
-When the site is running in Docker, you can connect to the database:
-
-- **Host:** `127.0.0.1`
-- **Port:** Check `.docker/docker-compose.yml` for the mapped port (usually 3307+)
-- **Credentials:** Read from `.docker/.env`:
-  - `DB_USERNAME`
-  - `DB_PASSWORD`
-  - `DB_DATABASE`
-
-```bash
-docker exec -it dw-<project-name>-db mysql -u root -p<password> <database>
-```
-
-**Important:** Table names in CmsApi/Twig do NOT use the `cms_` prefix. The primary key is always `num`, never `id`.
-
-## Acai Core (web-base)
-
-The project workspace contains only the **customization layer** (modules, hooks, schemas, uploads). The CMS core (routing, rendering engine, admin panel, APIs) lives in a separate directory called **web-base** that is mounted as a Docker volume.
-
-The web-base path can be obtained via: `GET http://localhost:9090/api/web-base-path`
-
-Do NOT modify web-base files — they are shared across all projects.
-
-## Critical Rules
-
-1. **Before working with any area (hooks, modules, templates, CSS/JS, etc.), read the corresponding documentation in `docs/` first.** Do not guess or assume — always consult the docs before taking action.
-2. **NEVER use `mkdir` to create directories.** Instead, use the `Write` tool to create the first file inside the directory — this creates parent directories automatically. For example, to create a new module, directly write the `index-base.tpl` file.
-3. Only edit `index-base.tpl` in modules — `index.tpl`, `index-twig.tpl`, and `builder.json` are auto-generated
-3. **Edit `index-base.tpl` using `acai_write` or `acai_line_replace`** — the server compiles automatically when the file is saved. No need to call `compile_module` manually.
-4. Use Twig **filters** (with `|`), never Twig functions
-5. Table names without `cms_` prefix everywhere
-6. Primary key is `num`, never `id`
-7. Upload fields are arrays — access with `[0].urlPath`
-8. Tailwind CSS as primary styling, custom CSS scoped with BEM when needed
-9. Twig concatenation uses `~` operator: `'value=' ~ variable`
-10. `enlace` (link) fields already include slashes — **NEVER modify an existing enlace** unless explicitly asked
-11. **NEVER modify the `controlador` field** of existing records — it defines whether a page is Builder or Standard
-
-## MCP Tools
-
-This project has MCP tools for managing modules, records, media, and more. **Before starting any task, consult the tools reference for the correct workflow.**
-
-See [docs/mcp-tools-reference.md](docs/mcp-tools-reference.md) for the complete list of available tools and step-by-step workflows.
-
-Key workflows:
-- **Create module**: Read [docs/module-creation-guide.md](docs/module-creation-guide.md) first → Write `index-base.tpl` via `acai_write` → `add_module_to_record` (returns sectionId) → `set_module_config_vars` (returns uploadFields) → images via uploadFields
-- **Edit module**: read vars → edit `index-base.tpl` with `acai_write` or `acai_line_replace` (server compiles automatically)
-- **Add images**: use `uploadFields` from `set_module_config_vars` response → `upload_record_image`
-- **Generate images**: `generate_image` → `upload_record_image` with returned URL
-
-## Documentation
-
-- [docs/modular-system.md](docs/modular-system.md) — Modules, general sections, global variables
-- [docs/builder-fields.md](docs/builder-fields.md) — Builder field types, Acai attributes, c-form, components
-- [docs/twig-filters.md](docs/twig-filters.md) — Twig filters reference (get, hook, module, queryDB, etc.)
-- [docs/hooks-and-api.md](docs/hooks-and-api.md) — PHP hooks, CmsApi, CocoDB, record creation
-- [docs/css-js-conventions.md](docs/css-js-conventions.md) — CSS/JS/Vue 3, Tailwind, BEM, native components
-- [docs/quick-reference.md](docs/quick-reference.md) — Cheat sheet: domain rules, field types, filters
-- [docs/production-patterns.md](docs/production-patterns.md) — Real production patterns (header, zigzag, FAQ, forms)
-- [docs/vue-builder-rules.md](docs/vue-builder-rules.md) — CMS-VUE rules (tabs, colorpicker, components)
-- [docs/vue-builder-examples.md](docs/vue-builder-examples.md) — Vue builder examples (Banner Slideshow, etc.)
-- [docs/pages-and-records.md](docs/pages-and-records.md) — Page types (Builder vs Standard), sections, visibility, critical rules
-- [docs/module-creation-guide.md](docs/module-creation-guide.md) — Module creation workflow, style reference, field types
-- [docs/mcp-tools-reference.md](docs/mcp-tools-reference.md) — MCP tools reference, available tools, workflows

docs/builder-fields.md

@@ -1,474 +0,0 @@
-# Builder Fields & Acai Attributes
-
-## Nombres de variables
-
-El atributo `data-field-label` se convierte a variable removiendo espacios y caracteres especiales (minúsculas).
-
-| Label | Variable |
-|-------|----------|
-| Categoría Noticia | `categoranoticia` |
-| Color Principal | `colorprincipal` |
-| Título Producto | `ttuloproducto` |
-
----
-
-## Field Types (`data-field-type`)
-
-| Type | Element | Returns |
-|------|---------|---------|
-| `textfield` | `<p>` | String |
-| `headfield` | `<h1>`-`<h6>` | String + variable `_tag` con la etiqueta elegida |
-| `textbox` | `<div>` | String multi-línea |
-| `wysiwyg` | `<div class="wysiwyg">` | HTML string |
-| `link` | `<a>` | URL string (ya incluye barras) |
-| `upload` | `<img>` | **Array** de `{urlPath, info1, info2, info3, info4}` |
-| `uploadMulti` | `<li>` | Itera sobre archivos subidos |
-| `list` (fijo) | `<div data-list-options="...">` | Valor seleccionado |
-| `list` (tabla) | `<div data-list-table="...">` | `num` del registro |
-| `multiv2` | `<li>` wrapper | Array de objetos |
-
-### textfield
-
-```html
-<p data-field-type="textfield" data-field-label="Título">
-  Elemento editable
-</p>
-```
-
-### headfield
-
-Genera 2 variables: la estándar y otra con sufijo `_tag` con la etiqueta elegida por el usuario.
-
-```html
-<{{ title_tag | default('h2') }} data-field-type="headfield" data-field-label="Título Sección" class="text-3xl font-bold">
-  Título de la sección
-</{{ title_tag | default('h2') }}>
-```
-
-### textbox
-
-```html
-<div data-field-type="textbox" data-field-label="Descripción">
-  Texto largo editable
-</div>
-```
-
-### wysiwyg
-
-```html
-<div class="wysiwyg" data-field-type="wysiwyg" data-field-label="Contenido Enriquecido">
-  <p>Texto con <strong>estilos</strong> editables</p>
-</div>
-```
-
-### link
-
-```html
-<a data-field-type="link" data-field-label="Enlace Principal" href="#">
-  Haz clic aquí
-</a>
-```
-
-### upload
-
-```html
-<div class="p-1/6 relative">
-  <img
-    class="absolute top-0 left-0 w-full h-full object-cover object-center lazyload"
-    data-field-type="upload"
-    data-field-label="Imagen Principal"
-    data-lazy="true"
-    data-field-info1="titulo"
-    data-field-width="1400"
-    alt=""
-  >
-</div>
-```
-
-Atributos disponibles:
-- `data-lazy="true"`: Carga perezosa
-- `data-field-width="1400"`: Ancho máximo sugerido
-- `data-field-info1="titulo"`: Campo de información adicional (usado como alt)
-
-Acceso en Twig: `{{ imagen[0].urlPath }}`, `{{ imagen[0].info1 }}`
-
-### uploadMulti
-
-Itera sobre todas las imágenes subidas:
-
-```html
-<li data-field-type="uploadMulti" data-field-label="Galería" data-field-info1="titulo">
-  <div class="relative min-h-screen">
-    <img class="absolute top-0 left-0 w-full h-full object-cover lazyload"
-         data-src="{{ uploadMulti.urlPath | imagec(2100) }}"
-         alt="{{ uploadMulti.info1 }}">
-  </div>
-</li>
-```
-
-### list (opciones fijas)
-
-```html
-<div
-  data-field-type="list"
-  data-field-label="Color Producto"
-  data-list-options="Rojo,Azul,|Verde,3|Amarillo"
->
-</div>
-```
-
-Formato de opciones: `opcion1,opcion2,|opcion3,valor3|opcion4`
-
-### list (tabla)
-
-```html
-<div
-  data-field-type="list"
-  data-field-label="Noticia Destacada"
-  data-list-table="noticias"
-  data-list-value="num"
-  data-list-label="titulo"
->
-  {{ record.titulo }}
-</div>
-```
-
-- `data-list-table`: Nombre de tabla sin prefijo `cms_`
-- `data-list-value`: Campo a usar como valor (generalmente `num`)
-- `data-list-label`: Campo a mostrar como label
-
-### multiv2 — Campos repetibles
-
-```html
-<ul>
-  <li data-field-type="multiv2" data-field-label="Productos">
-    <div data-field-type="textfield" data-field-label="Nombre">
-      Nombre del producto
-    </div>
-    <div data-field-type="textbox" data-field-label="Descripción">
-      Descripción del producto
-    </div>
-    <div class="p-1/6 relative">
-      <img
-        class="absolute top-0 left-0 w-full h-full object-cover lazyload"
-        data-field-type="upload"
-        data-field-label="Imagen"
-        data-lazy="true"
-        data-field-width="800"
-        alt=""
-      >
-    </div>
-  </li>
-</ul>
-```
-
-Uso en Twig — las variables son propiedades del objeto iterado:
-
-```twig
-{% for record in productos %}
-  <div class="producto">
-    <h3>{{ record.nombre }}</h3>
-    <p>{{ record.descripcion }}</p>
-    <img src="{{ record.imagen[0].urlPath }}" alt="">
-  </div>
-{% endfor %}
-```
-
----
-
-## Acai Attributes
-
-### `c-if` — Renderizado condicional
-
-```html
-<!-- Verificar existencia de variable -->
-<div c-if="subtitle">{{ subtitle }}</div>
-
-<!-- Comparación de valores (usa = no ==) -->
-<div c-if="layout = 'grid'">Grid layout</div>
-```
-
-### `c-else`
-
-Debe ir inmediatamente después del elemento `c-if`:
-
-```html
-<div c-if="image">
-  <img src="{{ image[0].urlPath }}" />
-</div>
-<div c-else>
-  <p>No image available</p>
-</div>
-```
-
-### `c-for` — Iteración sobre array
-
-```html
-<div c-for="item in record.features">
-  <h3>{{ item.title }}</h3>
-</div>
-```
-
-### `c-for` — Iteración sobre tabla de BD
-
-```html
-<ul>
-  <li c-for="producto in productos" c-where="'visible=1'" c-order="'num desc'" c-limit="10">
-    {{ producto.title }}
-  </li>
-</ul>
-```
-
-Parámetros opcionales: `c-where` (condición SQL), `c-order` (orden), `c-limit` (límite).
-
-Equivalente en Twig:
-```twig
-{% for producto in 'productos' | get('visible=1','num desc',10) %}
-  <li>{{ producto.title }}</li>
-{% endfor %}
-```
-
-Dentro del loop: `loop.index` (1-based), `loop.index is odd`, `loop.index is even`
-
-### `c-class` — Clases CSS condicionales
-
-```html
-<!-- Simple -->
-<div c-class="{ 'text-center': alineacion == '1', 'text-right': alineacion == '2' }">
-
-<!-- Múltiples condiciones -->
-<div c-class="{
-  'flex-row-reverse': orden == '1',
-  'cursor-pointer click-a-child': record.enlace_anchor,
-  'rounded-xl': radioborde == '4'
-}">
-
-<!-- Con expresiones Twig (loop) -->
-<div c-class="{
-  'md:order-1': loop.index is odd,
-  'md:pl-6': loop.index is even
-}">
-
-<!-- Combinado con clases estáticas -->
-<div class="flex items-center" c-class="{ 'justify-center': centrado }">
-```
-
-### `c-hidden` — Elementos ocultos
-
-Elemento que no se renderiza pero puede declarar variables builder:
-
-```html
-<div c-hidden="true">
-  <input data-field-type="textfield" data-field-label="Config" value="default" />
-</div>
-```
-
-### `c-required` — Campos requeridos condicionales
-
-```html
-<input type="text" name="telefono" c-required="'2' not in camposquitar" placeholder="Teléfono">
-```
-
----
-
-## Definiendo variables con `<set>`
-
-```html
-<!-- Obtener configuración de la BD -->
-<set :tienda="'configuracion_tienda' | get('num != 0')[0]"></set>
-
-<!-- Construir URLs dinámicas -->
-<set :logo="tienda.logo.0.urlPath ? 'https://' ~ server.HTTP_HOST ~ tienda.logo.0.urlPath : 'https://' ~ server.HTTP_HOST ~ '/template/estandar/images/logo.png'"></set>
-
-<!-- Twig set para expresiones complejas -->
-{% set gracias = 'apartados' | get('num = 20').0 %}
-```
-
----
-
-## Incluyendo módulos
-
-Para incluir un módulo dentro de otro módulo o sección general, usa el ID del módulo como etiqueta HTML:
-
-```html
-<module_id :param1="value1" :param2="value2"></module_id>
-```
-
-Ejemplo:
-```html
-<header_menu :showLogo="true" :menuItems="items"></header_menu>
-<product_card :product="selectedProduct" :showPrice="true"></product_card>
-```
-
-El módulo hijo recibe los parámetros como variables en su contexto.
-
----
-
-## Formularios (`c-form`)
-
-Manejo automático de validación, almacenamiento en BD y envío de emails.
-
-```html
-<c-form
-  class="max-w-2xl mx-auto p-6 bg-white rounded-lg shadow"
-  tableName="'solicitudes'"
-  mailRecord="['correos', 'CONTACTO']"
-  sendTo="'contacto@empresa.com'"
-  sendToClient="'email'"
-  captcha="true"
-  honeypot="true"
-  messageOK="'¡Gracias! Te contactaremos pronto'"
-  messageKO="'Por favor, completa todos los campos'"
-  redirect="'/gracias'"
-  attachFiles="true"
->
-  <div class="mb-4">
-    <label class="block mb-2">Nombre</label>
-    <input name="nombre" type="text" class="w-full p-2 border rounded" required>
-  </div>
-  <div class="mb-4">
-    <label class="block mb-2">Email</label>
-    <input name="email" type="text" class="w-full p-2 border rounded" required>
-  </div>
-  <div class="mb-4">
-    <label class="block mb-2">Mensaje</label>
-    <textarea name="mensaje" class="w-full p-2 border rounded" rows="5" required></textarea>
-  </div>
-  <div class="mb-4">
-    <label class="flex items-center">
-      <input name="acepto_politica" type="checkbox" class="mr-2" required>
-      <span>Acepto la política de privacidad</span>
-    </label>
-  </div>
-  <button type="submit" class="bg-teal-500 text-white px-6 py-2 rounded hover:bg-teal-600">Enviar</button>
-  <captcha/>
-</c-form>
-```
-
-### Atributos de c-form
-
-| Atributo | Descripción |
-|----------|-------------|
-| `tableName="'table'"` | Tabla donde almacenar registros |
-| `mailRecord="['correos', 'ID']"` | Template de email de la tabla `correos` |
-| `sendTo="'email@domain.com'"` | Destinatarios (separados por coma) |
-| `sendToClient="'campo_email'"` | Campo con email del cliente para auto-reply |
-| `captcha="true"` | Google reCAPTCHA |
-| `honeypot="true"` | Campo oculto anti-spam |
-| `messageOK="'texto'"` | Mensaje de éxito |
-| `messageKO="'texto'"` | Mensaje de error |
-| `redirect="'/path/'"` | Redirección tras envío exitoso |
-| `attachFiles="true"` | Adjuntar archivos al email |
-| `showImages="true"` | Mostrar thumbnails en email |
-| `emailMode="'twig'"` | Email en formato Twig |
-| `header="'<div>...</div>'"` | HTML cabecera del email |
-| `footer="'<div>...</div>'"` | HTML footer del email |
-| `styles="'body { ... }'"` | CSS para el email |
-
----
-
-## Componentes Built-in
-
-### Carousel (`c-tns-wrapper`)
-
-```html
-<div class="c-tns-wrapper"
-     data-responsive='{"0":1,"768":2,"1024":3}'
-     data-speed="400"
-     data-nav="true"
-     data-autoplay-timeout="3000">
-  <div c-for="slide in record.slides">
-    <img src="{{ slide.image[0].urlPath }}" />
-  </div>
-</div>
-```
-
-### Lightbox
-
-```html
-<a href="{{ image[0].urlPath }}" class="glightbox" data-gallery="gallery1">
-  <img src="{{ image[0].urlPath | imagec(400) }}" />
-</a>
-```
-
-### Breadcrumb
-
-```html
-<breadCrumb/>
-```
-
-### Animate On Scroll (AOS)
-
-```html
-<div data-aos="fade-up" data-aos-delay="200">
-  Animated content
-</div>
-```
-
-### Lazy Loading
-
-```html
-<img class="lazyload" data-src="{{ image[0].urlPath }}" />
-<!-- o -->
-<img data-lazy="true" src="{{ image[0].urlPath }}" />
-```
-
----
-
-## Puntos importantes
-
-1. **Nombres de variables:** `data-field-label` → sin espacios ni caracteres especiales, minúsculas
-2. **Variables en multiv2:** Son propiedades del objeto iterado (`record.nombre`)
-3. **Campos upload:** Retornan arrays, no strings (`imagen[0].urlPath`, no `imagen`)
-4. **c-if usa `=` no `==`:** `c-if="layout = 'grid'"` (un solo igual)
-5. **c-for tabla:** El nombre de tabla va sin prefijo `cms_`
-6. **Enlace:** Ya incluye barras, no añadir extras
-7. **Checkbox:** Valores `1` o `0`, no `true`/`false`
-
----
-
-## MCP Tools: Config Vars e Imágenes de Módulos
-
-### Regla importante: Siempre rellenar variables al añadir un módulo
-Cuando se añade un módulo a una página (con `add_module_to_record`), este queda vacío y no muestra nada visible. **SIEMPRE** hay que llamar a `set_module_config_vars` inmediatamente después para rellenar las variables con contenido de ejemplo coherente con el contexto del sitio. Incluir:
-- Textos (títulos, descripciones, pretítulos) con contenido relevante al sitio
-- Valores de listas/selects con una opción válida
-- Para variables multi (records), crear al menos 2-3 items de ejemplo
-- Para variables de imagen (upload), usar `generate_image` o `upload_record_image` para que el módulo se vea completo
-
-Un módulo sin variables configuradas es invisible en la web.
-
-### Leer variables de un módulo
-Antes de modificar cualquier módulo, usar `get_module_config_vars` para conocer el estado actual:
-- **tableName**: tabla del registro padre (ej: `apartados`), SIN prefijo `cms_`
-- **recordNum**: campo `num` del registro padre (ej: `2`)
-- **sectionId**: el `section_id` de la instancia del módulo (ej: `6c6d8`)
-
-### Escribir variables de un módulo
-Usar `set_module_config_vars` con los mismos tableName, recordNum y sectionId. Pasar todos los valores como strings.
-
-La respuesta incluye `configVars` con el `recordNum` del registro `builder_custom` creado/actualizado y `uploadFields` para imágenes.
-
-**Tipos de almacenamiento (manejado automáticamente):**
-- `headfield`, `textfield`, `link`, `textbox`, `wysiwyg`, `upload` → se guardan en tabla `builder_custom`
-- `list`, `checkbox`, `colorpicker` → se guardan directamente en el JSON config-vars (no en builder_custom)
-
-No necesitas preocuparte por esto — `set_module_config_vars` lo maneja internamente. Solo pasa los valores como strings.
-
-### Subir imágenes a un módulo
-El nombre del campo de imagen viene de `builder.json` → `vars.NOMBRE.relations.builder_custom` (ej: `"image1"`). NO es el nombre de la variable (ej: NO `"imagenes"`).
-
-**Flujo correcto:**
-1. `get_module_config_vars` → obtener el `recordNum` en builder_custom de la variable de imagen
-2. `upload_record_image` con:
-   - `tableName`: `"builder_custom"` (siempre, sin prefijo cms_)
-   - `recordId`: el `recordNum` del paso 1 (ej: `"778"`)
-   - `fieldName`: el campo de relations del builder.json (ej: `"image1"`)
-   - `imageUrl`: URL completa accesible desde Docker
-3. `reorder_record_uploads` si es necesario — pasar array de upload IDs en el orden deseado
-4. `list_record_uploads` para verificar
-
-**Errores comunes a evitar:**
-- NO usar el sectionId como recordId — usar el `num` de builder_custom
-- NO usar el nombre de la variable como fieldName — usar el campo de relations del builder.json (ej: `image1`, no `imagenes`)
-- NO poner prefijo `cms_` en tableName

docs/css-js-conventions.md

@@ -1,225 +0,0 @@
-# CSS & JavaScript Conventions
-
-## Estructura del módulo
-
-- Genera HTML + CSS + JS (o Vue 3 si es necesario)
-- Define una clase raíz en kebab-case: `product-card`, `hero-section`, etc.
-- Todo el CSS y JS scopeado bajo esa clase raíz
-
----
-
-## CSS
-
-### Tailwind First
-
-Usar TailwindCSS como método principal. Solo CSS custom cuando Tailwind no cubra el estilo o se necesiten estados complejos/transiciones específicas.
-
-```html
-<div class="flex items-center gap-4 p-6 bg-white rounded-lg shadow-md">
-  <h2 class="text-2xl font-bold text-gray-900">Title</h2>
-</div>
-```
-
-### BEM para CSS Custom
-
-Cuando se necesite CSS personalizado, siempre scopeado bajo la clase raíz con BEM:
-
-```css
-.hero-section { }
-.hero-section__title { }
-.hero-section__image { }
-.hero-section--dark { }
-```
-
-Nunca usar clases globales sin prefijo de módulo.
-
-### CSS Variables del tema
-
-```css
-var(--main-color)        /* Color de marca primario */
-var(--main-color-light)  /* Variante clara */
-var(--main-color-dark)   /* Variante oscura */
-```
-
-### Estilos inline con fallbacks
-
-Patrón para colores configurables por el usuario:
-
-```html
-<div style="background-color: {{ colordefondo ? colordefondo : 'transparent' }}">
-<p style="color: {{ colordeltexto ? colordeltexto : '#111827' }}">
-```
-
-### Clases utilitarias de Acai
-
-| Clase | Descripción |
-|-------|-------------|
-| `transition3s` | Transición suave 0.3s |
-| `click-a-child` | Hace el padre clickeable via primer `<a>` hijo |
-| `line-clamp2` / `line-clamp3` / `line-clamp5` | Truncar texto a N líneas |
-| `filter-white` | Filtro CSS para hacer imágenes/iconos blancos |
-| `lazyload` | Lazy loading (usar con `data-src`) |
-| `text-shadow` | Sombra de texto para legibilidad sobre imágenes |
-| `wysiwyg` | Wrapper para contenido de texto enriquecido |
-| `bg-main-color` / `bg-main-color-light` / `bg-main-color-dark` | Fondos con color primario |
-| `text-main-color` / `text-main-color-light` / `text-main-color-dark` | Texto con color primario |
-
----
-
-## JavaScript
-
-### Module Scripts (`script.js`)
-
-JavaScript scopeado al módulo usando `section_id`:
-
-```js
-const section = document.getElementById('{{ section_id }}');
-if (section) {
-  const buttons = section.querySelectorAll('.btn');
-  // ...
-}
-```
-
-### CmsApi (Client-Side)
-
-```js
-CmsApi.hook('/hooks/module_id/', { action: 'getData', id: 123 }, function(response) {
-  console.log(response);
-});
-```
-
-### Cuándo usar Vue 3
-
-Usar Vue 3 CDN cuando la lógica requiera:
-- Doble binding / reactividad
-- Solicitudes asíncronas complejas
-- Componentes reutilizables
-- Gestión de estado local
-- Ciclos de vida
-
-Para lógica simple, usar JavaScript vanilla.
-
-### Vue 3 Integration
-
-```html
-<div id="app-{{ section_id }}">
-  <p>${ message }</p>
-  <button @click="increment">${ count }</button>
-</div>
-
-<script>
-const { createApp, ref } = Vue;
-createApp({
-  delimiters: ['${', '}'],  // Evitar conflicto con Twig {{ }}
-  setup() {
-    const message = ref('Hello');
-    const count = ref(0);
-    const increment = () => count.value++;
-    return { message, count, increment };
-  }
-}).mount('#app-{{ section_id }}');
-</script>
-```
-
-Siempre usar `'${'` y `'}'` como delimitadores Vue para evitar conflicto con Twig.
-
----
-
-## Variables Globales Disponibles
-
-| Variable | Descripción | Ejemplo |
-|----------|-------------|---------|
-| `section_id` | ID único por instancia del módulo | `<div id="{{section_id}}">` |
-| `server.HTTP_HOST` | Dominio actual | `https://{{ server.HTTP_HOST }}/path` |
-| `loop.index` | Índice de iteración (1-based) en c-for/for | `{{ loop.index }}` |
-| `loop.index is odd` | True en iteraciones impares | Layouts alternados |
-| `loop.index is even` | True en iteraciones pares | Patrones zigzag |
-| `interno` | True dentro del editor CMS | `c-class="{'editor-mode': interno}"` |
-
-### Patrón section_id
-
-Cada instancia de módulo recibe un `section_id` único. Usar para navigation anchor e IDs:
-
-```html
-<div id="{{section_id}}"></div>
-<section id="id_{{ section_id }}" class="relative">
-  <!-- contenido del módulo -->
-</section>
-```
-
----
-
-## Componentes Nativos
-
-### Carousel (`c-tns-wrapper`)
-
-```html
-<div class="c-tns-wrapper" data-responsive="sm:2, md:3, lg:4" data-speed="1000" data-nav="true">
-  <ul class="c-tns-container">
-    <li data-field-type="multiv2" data-field-label="Slides" class="px-2">
-      <!-- contenido del slide -->
-    </li>
-  </ul>
-</div>
-```
-
-| Atributo | Descripción | Ejemplo |
-|----------|-------------|---------|
-| `data-responsive` | Items por breakpoint | `"sm:2, md:3, lg:4"` |
-| `data-autoplay-timeout` | Intervalo autoplay (ms) | `"5000"` |
-| `data-mode` | Modo de transición | `"gallery"` o `"carousel"` |
-| `data-speed` | Velocidad de transición (ms) | `"400"` |
-| `data-nav` | Puntos de navegación | `"true"` |
-
-Dots de navegación custom:
-```html
-<div class="c-tns-nav-container absolute bottom-4 left-0 w-full flex justify-center items-end z-20">
-  <div c-for="item in records"
-       class="pointer-events-auto cursor-pointer rounded-full border-2 border-white w-4 h-4 mx-1 bg-black bg-opacity-50">
-  </div>
-</div>
-```
-
-### Lightbox
-
-```html
-<a href="{{ image[0].urlPath }}" class="glightbox" data-gallery="gallery1">
-  <img src="{{ image[0].urlPath | imagec(400) }}" />
-</a>
-```
-
-### Breadcrumb
-
-```html
-<breadCrumb class="bg-gray-200 p-3 rounded" c-prevlinks="null"></breadCrumb>
-```
-
-### AOS (Animate On Scroll)
-
-```html
-<div data-aos="fade-up" data-aos-duration="800">Contenido</div>
-```
-
-Valores comunes: `fade-up`, `fade-down`, `fade-left`, `fade-right`, `zoom-in`, `zoom-in-up`, `fade-up-right`, `fade-up-left`
-
-Después de cambios dinámicos: `AOS.refresh()` en JavaScript.
-
-### Lazy Loading
-
-```html
-<!-- Builder var con lazy loading -->
-<img data-field-type="upload" data-field-label="Imagen" data-lazy="true" data-field-width="800" alt="">
-
-<!-- Manual en templates -->
-<img class="lazyload" data-src="{{ record.imagen[0].urlPath | imagec(800) }}" alt="">
-```
-
----
-
-## Buenas prácticas
-
-- HTML/Twig semántico
-- Código limpio y organizado
-- Evitar dependencias externas innecesarias
-- Evitar estilos inline salvo casos justificados (colores dinámicos del usuario)
-- No usar clases globales sin prefijo de módulo

docs/hooks-and-api.md

@@ -1,415 +0,0 @@
-# Hooks & Server-Side API
-
-## Hooks
-
-Hooks son archivos PHP en `hooks/` que ejecutan lógica server-side. También pueden estar dentro de un módulo en `template/estandar/modulos/<module-id>/hook.php`.
-
-### Estructura de un Hook
-
-```php
-<?php
-// Los parámetros se reciben como variables directamente
-// Ejemplo: Si llamas hook con {param1: 100}, tendrás $param1 = 100
-
-$resultado = $param1 * 2;
-
-// Retornar un array (se convierte a JSON)
-return [
-    "success" => true,
-    "message" => "Valor procesado: " . $resultado,
-    "value" => $resultado
-];
-?>
-```
-
-### Testing Hooks
-
-El Docker debe estar corriendo. Hacer curl al endpoint del hook:
-
-```bash
-curl http://localhost:8080/hooks/example_hook/
-```
-
-No usar X-Hooks-Token en desarrollo local.
-
-### Cómo Llamar Hooks
-
-**Desde HTML (recomendado para módulos):**
-```html
-<hook result="myVar" endpoint="/hooks/module_id/" :param1="value1" :param2="'string'"></hook>
-<p>{{ myVar.message }}</p>
-```
-
-**Desde Twig:**
-```twig
-{% set resultado = 'hooks/mimodulo/' | hook({param1: 100, param2: 'texto'}) %}
-<p>{{ resultado.message }}</p>
-```
-
-**Desde JavaScript:**
-```js
-CmsApi.hook('/hooks/mimodulo/', {param1: 100, param2: 'texto'}, (data) => {
-  console.log(data.message);
-});
-```
-
-**Desde otro Hook PHP:**
-```php
-<?php
-$result = hook("/hooks/mimodulo/", ["param1" => 100, "param2" => "texto"]);
-$mensaje = $result["message"];
-?>
-```
-
-**Desde c-form:** Los hooks se ejecutan automáticamente al enviar el formulario si están configurados.
-
----
-
-## CmsApi (PHP)
-
-API server-side para operaciones de base de datos. Disponible en todos los hooks.
-
-### Read — `CmsApi::get()`
-
-```php
-// Todos los registros
-$products = CmsApi::get('productos');
-
-// Con condición WHERE
-$active = CmsApi::get('productos', ['active' => 1]);
-
-// Con orden y límite
-$latest = CmsApi::get('noticias', [], 'fecha DESC', 5);
-
-// Con condición string
-$activos = CmsApi::get('productos', 'activo=1');
-
-// Condición compleja como array
-$caros = CmsApi::get('productos', [
-    ["column" => "precio", "operator" => ">", "value" => 100]
-]);
-
-// Múltiples condiciones (AND)
-$resultados = CmsApi::get('productos', [
-    ["column" => "activo", "operator" => "=", "value" => 1],
-    ["column" => "stock", "operator" => ">", "value" => 0]
-]);
-
-// Con operadores
-$expensive = CmsApi::get('productos', ['precio' => ['>=' => 100]]);
-$search = CmsApi::get('productos', ['nombre' => ['LIKE' => '%keyword%']]);
-$inList = CmsApi::get('productos', ['categoria_num' => ['IN' => [1, 2, 3]]]);
-
-// Con opciones
-$datos = CmsApi::get('productos', '', '', '', [
-    'translates' => true,
-    'uploads' => true,
-    'relations' => true,
-    'relationsDepth' => 2
-]);
-```
-
-### Insert — `CmsApi::insert()`
-
-```php
-// Un registro
-CmsApi::insert('contacto', [
-    ["nombre" => "John", "email" => "john@example.com", "mensaje" => "Hello"]
-]);
-
-// Múltiples registros
-CmsApi::insert('productos', [
-    ["nombre" => "Producto A", "precio" => 100],
-    ["nombre" => "Producto B", "precio" => 200]
-]);
-
-// Con retorno del último ID
-CmsApi::insert('productos',
-    [["nombre" => "Nuevo", "precio" => 150]],
-    [],
-    ['return_last_id' => true]
-);
-```
-
-### Update — `CmsApi::update()`
-
-```php
-// Con condición string
-CmsApi::update('productos', ["precio" => 150], "num=1");
-
-// Con condición array
-CmsApi::update('productos',
-    ["activo" => 1],
-    [["column" => "num", "operator" => "=", "value" => 1]]
-);
-
-// Múltiples registros
-CmsApi::update('productos', ["activo" => 0], "precio < 50");
-```
-
-### Delete — `CmsApi::delete()`
-
-```php
-CmsApi::delete('productos', "num=5");
-
-CmsApi::delete('productos',
-    [["column" => "activo", "operator" => "=", "value" => 0]]
-);
-```
-
-### Reglas importantes
-
-- Nombres de tabla **sin** prefijo `cms_`
-- Primary key siempre es `num`, nunca `id`
-- Foreign keys: `categoria_num`, no `categoria_id`
-- Upload fields: no se manejan via insert/update
-- Operadores: `=`, `!=`, `>`, `>=`, `<`, `<=`, `LIKE`, `IN`
-
----
-
-## CmsApi (JavaScript — Client-Side)
-
-```js
-// Llamar hook
-CmsApi.hook('/hooks/module_id/', { param: 'value' }, function(response) {
-  // response es la salida del hook
-});
-
-// Leer registros (si está expuesto via hooks)
-CmsApi.get('tableName', { where: conditions }, function(records) {
-  // records array
-});
-```
-
----
-
-## CocoDB
-
-Capa de abstracción de BD de bajo nivel usada internamente por CmsApi. Usar directamente desde hooks cuando necesites más control.
-
-### `CocoDB::get($table, $where, $order, $limit, $options)`
-
-```php
-// Básico
-$records = CocoDB::get('productos', ['activo' => 1], 'orden ASC', 10);
-
-// Where con operadores avanzados
-$records = CocoDB::get('productos', [
-    ['column' => 'precio', 'value' => 100, 'operator' => '>='],
-    ['column' => 'categoria_num', 'value' => [1, 2, 3], 'operator' => 'IN'],
-]);
-
-// Condiciones OR
-$records = CocoDB::get('productos', [
-    ['column' => 'nombre', 'value' => '%keyword%', 'operator' => 'LIKE'],
-    ['column' => 'descripcion', 'value' => '%keyword%', 'operator' => 'LIKE', 'or' => true],
-]);
-
-// NOT
-$records = CocoDB::get('productos', [
-    ['column' => 'estado', 'value' => 'borrador', 'operator' => '=', 'not' => true],
-]);
-
-// IS NULL
-$records = CocoDB::get('productos', [
-    ['column' => 'fecha_baja', 'value' => '', 'operator' => 'IS NULL'],
-]);
-
-// Limit con offset
-$records = CocoDB::get('productos', [], 'num DESC', ['limit' => 10, 'offset' => 20]);
-```
-
-#### Opciones de `get()`
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `uploads` | bool | `true` | Incluir datos de upload fields |
-| `relations` | bool/array | `true` | Resolver foreign keys. Array para limitar: `['category']` |
-| `relationsDepth` | int | 2 | Profundidad de relaciones anidadas |
-| `translates` | string | current lang | Código de idioma |
-| `groupBy` | string | null | GROUP BY clause |
-| `aggregates` | array | `[]` | Funciones de agregación |
-| `onlyFields` | array | null | Seleccionar solo campos específicos |
-| `debug` | bool | false | Mostrar SQL query |
-| `redis` | bool | null | Forzar cache Redis |
-| `redis_expire` | int | 60 | TTL de cache Redis (segundos) |
-
-### `CocoDB::insertRecords($table, $records, $functions, $options)`
-
-```php
-// Un registro
-$count = CocoDB::insertRecords('contacto', [
-    'nombre' => 'John',
-    'email' => 'john@example.com',
-]);
-// Usar mysql_insert_id() para obtener el nuevo num
-
-// Múltiples
-$count = CocoDB::insertRecords('productos', [
-    ['nombre' => 'Product A', 'precio' => 10],
-    ['nombre' => 'Product B', 'precio' => 20],
-]);
-```
-
-#### Opciones de insert/update
-
-| Option | Description |
-|--------|-------------|
-| `forceNum` | Permite setear el campo `num` manualmente |
-| `ignoreSchema` | Saltar validación de schema |
-| `ignoreFields` | Array de campos a ignorar |
-
-### `CocoDB::updateRecords($table, $records, $where, $functions, $options)`
-
-```php
-CocoDB::updateRecords('productos',
-    ['precio' => 29.99, 'activo' => 1],
-    ['num' => 42]
-);
-
-// Con operador en where
-CocoDB::updateRecords('productos',
-    ['activo' => 0],
-    [['column' => 'stock', 'value' => 0, 'operator' => '<=']]
-);
-```
-
-### `CocoDB::deleteRecords($table, $where, $options)`
-
-```php
-CocoDB::deleteRecords('productos', ['num' => 42]);
-
-CocoDB::deleteRecords('logs', [
-    ['column' => 'fecha', 'value' => '2024-01-01', 'operator' => '<']
-]);
-```
-
-### Parámetro `$functions`
-
-Permite aplicar funciones MySQL a valores durante insert/update:
-
-```php
-CocoDB::insertRecords('logs', [
-    'mensaje' => 'Login exitoso',
-    'fecha' => '',
-], [
-    'fecha' => 'NOW()',
-]);
-```
-
-### Where Clause — Formatos
-
-**Simple (key-value):**
-```php
-['campo' => 'valor']  // campo = 'valor'
-```
-
-**Avanzado (array de condiciones):**
-```php
-[
-    'column'   => 'field_name',
-    'value'    => 'match_value',
-    'operator' => '=',       // =, !=, <, >, <=, >=, LIKE, IN, IS NULL
-    'or'       => false,     // OR en vez de AND
-    'not'      => false,     // Negar la condición
-    'raw_key'  => false,     // Saltar check de existencia de columna
-]
-```
-
----
-
-## Creación y Actualización de Registros
-
-### Flujo correcto
-
-1. Consultar el esquema de la tabla (leer `cms/data/schema/{tabla}.ini.php`)
-2. Revisar los tipos de campo
-3. Rellenar según el tipo de dato
-4. Enviar con la estructura correcta
-
-### Tipos de campo y formato
-
-| Tipo | Formato | Ejemplo |
-|------|---------|---------|
-| **Text field** | String | `"Texto"` |
-| **Text box** | String multilínea | `"Línea 1\nLínea 2"` |
-| **Date/time** | `YYYY-MM-DD HH:mm:ss` | `"2025-12-03 10:30:00"` |
-| **Wysiwyg** | String HTML | `"<p class=\"font-bold\">Texto</p>"` |
-| **List** | String o número | `"activo"` o `"1"` (num si es foreign key) |
-| **Checkbox** | Número 1/0 | `1` o `0` |
-| **Multivalores** | String JSON | `"[{\"producto\":\"1\"}]"` |
-| **Upload** | **NO enviar** — usar `upload_record_image` después de crear el registro |
-
----
-
-## Table Schemas
-
-Los schemas están en `cms/data/schema/` como archivos `.ini.php`. Definen:
-- Nombres y tipos de campo
-- Reglas de validación
-- Relaciones (foreign keys)
-- Configuración de display
-
----
-
-## Ejemplos Prácticos
-
-### Hook de Cálculo de Precio
-
-```php
-<?php
-// hook.php del módulo "calcular_precio"
-$precioUnitario = 50;
-
-if ($tipo === 'mayoreo' && $cantidad > 10) {
-    $precioUnitario *= 0.85; // 15% descuento
-}
-
-return [
-    "success" => true,
-    "precioUnitario" => round($precioUnitario, 2),
-    "total" => round($precioUnitario * $cantidad, 2),
-    "descuento" => $tipo === 'mayoreo' ? 15 : 0
-];
-?>
-```
-
-```html
-<hook result="precio" endpoint="/hooks/calcular_precio/" :cantidad="10" :tipo="'mayoreo'"></hook>
-<p>Total: ${{ precio.total }}</p>
-```
-
-### Hook con Operaciones de BD
-
-```php
-<?php
-// hook.php del módulo "procesar_compra"
-$producto = CmsApi::get('productos', "num=$producto_id");
-
-if (empty($producto)) {
-    return ["success" => false, "message" => "Producto no encontrado"];
-}
-
-$total = $producto[0]['precio'] * $cantidad;
-
-// Crear venta
-CmsApi::insert('ventas', [[
-    "usuario_num" => $usuario_id,
-    "producto_num" => $producto_id,
-    "cantidad" => $cantidad,
-    "total" => $total,
-    "fecha" => date('Y-m-d H:i:s')
-]], [], ['return_last_id' => true]);
-
-// Actualizar stock
-$stock = CmsApi::get('stocks', "producto_num=$producto_id");
-if (!empty($stock)) {
-    CmsApi::update('stocks',
-        ["cantidad" => $stock[0]['cantidad'] - $cantidad],
-        "producto_num=$producto_id"
-    );
-}
-
-return ["success" => true, "total" => $total];
-?>
-```

docs/mcp-tools-reference.md

@@ -1,101 +0,0 @@
-# MCP Tools Reference
-
-## Quick Reference
-
-| Tool | Categoría | Acción |
-|------|-----------|--------|
-| `create_module` | Módulos | (Legacy) Alternativa para crear módulo — preferir acai_write |
-| `compile_module` | Módulos | Compila módulo tras editar index-base.tpl |
-| `check_module` | Módulos | Preview de cómo renderiza un módulo |
-| `check_module_usage` | Módulos | Qué páginas usan un módulo |
-| `set_module_example_data` | Módulos | Datos de ejemplo para editor visual |
-| `list_page_modules` | Registros | Lista módulos de una página |
-| `add_module_to_record` | Registros | Añade módulo a una página |
-| `remove_module_from_record` | Registros | Elimina módulo de una página |
-| `reorder_module` | Registros | Cambia posición de un módulo |
-| `toggle_module_visibility` | Registros | Muestra/oculta módulo |
-| `get_module_config_vars` | Registros | Lee variables de un módulo |
-| `set_module_config_vars` | Registros | Escribe variables de un módulo |
-| `list_table_records` | Registros | Buscar/listar registros con filtros |
-| `get_record` | Registros | Obtener un registro por num |
-| `create_or_update_record` | Registros | Crear o actualizar registros |
-| `delete_table_records` | Registros | Eliminar registros (destructivo) |
-| `upload_record_image` | Media | Subir imagen a campo de registro (desde URL) |
-| `generate_image` | Media | Generar imagen con IA y guardar en uploads |
-| `upload_image_to_assets` | Media | Subir imagen a /images/ del template |
-| `list_record_uploads` | Media | Listar uploads de un campo |
-| `replace_record_image` | Media | Reemplazar imagen existente |
-| `delete_record_upload` | Media | Borrar upload |
-| `reorder_record_uploads` | Media | Reordenar imágenes de un campo |
-| `refresh_acai_token` | Auth | Renovar token JWT expirado |
-| `navigate_browser` | Navegación | Navegar el browser del frontend a una URL |
-| `save_project_styles` | Proyecto | Guardar resumen de estilos en docs/project-styles.md |
-| `orchestrate_task` | Orquestador | Guía paso a paso para tareas complejas |
-| `rollback_git` | Git | Recuperar cambios de git remoto |
-
-## Flujos de trabajo
-
-### Crear un módulo nuevo desde cero
-
-1. `acai_write` — Escribe `index-base.tpl` en `template/estandar/modulos/NOMBRE/`. El server crea la carpeta si no existe, compila y genera todos los archivos derivados (index-twig.tpl, index.tpl, builder.json, screenshots)
-2. `add_module_to_record` — Añade el módulo a una página (tabla padre, ej: `apartados`)
-3. `set_module_config_vars` — Rellena las variables con contenido (textos, colores, opciones). **OBLIGATORIO** — sin esto el módulo no muestra nada. Devuelve:
-   - `configVars`: mapa de variables → recordNums
-   - `uploadFields`: mapa de variables upload → `{ fieldName, recordNum }` — **usa estos directamente** para subir imágenes sin necesidad de leer builder.json
-   - Para vars multi con uploads: `uploadFields["varName.subVarName"]` es un array con `[{ index, fieldName, recordNum }]`
-4. Para imágenes: `generate_image` o `upload_record_image` usando el `recordNum` y `fieldName` del `uploadFields` devuelto en el paso 3
-5. Verificar con `check_module` o recargando la página
-
-> **Nota:** `create_module` es una alternativa legacy que hace lo mismo pero con menos control sobre el contenido del template.
-
-### Editar un módulo existente
-
-1. `get_module_config_vars` — Leer el estado actual del módulo (variables, recordNums)
-2. Editar `index-base.tpl` con `acai_write` o `acai_line_replace` — el server compila automáticamente al guardar
-3. Si cambias variables: `set_module_config_vars` para actualizar valores
-
-### Añadir/modificar imágenes de un módulo
-
-**Tras `set_module_config_vars`** (método recomendado — sin pasos extra):
-1. El response de `set_module_config_vars` incluye `uploadFields` con los `recordNum` y `fieldName` de cada variable upload
-2. `upload_record_image` con `tableName: "builder_custom"`, `recordId` y `fieldName` del `uploadFields`
-3. Para uploads dentro de vars multi: `uploadFields["records.imagen"]` devuelve array con `{ index, fieldName, recordNum }` por cada record
-
-**Sin haber llamado a `set_module_config_vars`**:
-1. `get_module_config_vars` — Obtener el `recordNum` de builder_custom
-2. Leer `builder.json` del módulo para encontrar el `fieldName` real (ej: `image1`, NO el nombre de la variable)
-3. `upload_record_image` con:
-   - `tableName`: `"builder_custom"` (siempre sin cms_)
-   - `recordId`: el recordNum del paso 1
-   - `fieldName`: el campo de relations del builder.json (ej: `image1`)
-   - `imageUrl`: URL accesible desde Docker (ej: `http://localhost/cms/uploads/...`)
-
-### Generar imagen con IA
-
-1. `generate_image` con prompt descriptivo + style (photographic, digital-art, minimalist...)
-2. La imagen se guarda en `cms/uploads/generated/` y devuelve `dockerUrl`
-3. Usar esa `dockerUrl` con `upload_record_image` para asignarla a un módulo
-
-### Gestionar registros de una tabla
-
-1. `list_table_records` — Buscar registros con filtros (`where`, `order`, `limit`)
-2. `get_record` — Obtener un registro completo por num
-3. `create_or_update_record` — Crear o actualizar (la tabla sin prefijo `cms_`, PK es `num`)
-4. `delete_table_records` — Eliminar por IDs
-
-### Explorar el sitio
-
-1. `orchestrate_task` con workflow `explore_site` — Guía para entender la estructura
-2. `list_page_modules` — Ver qué módulos tiene cada página
-3. `get_module_config_vars` — Ver los datos de cada módulo
-4. `check_module` — Preview de cómo renderiza
-
-## Reglas importantes para todas las tools
-
-1. **tableName** siempre SIN prefijo `cms_` (ej: `apartados`, no `cms_apartados`)
-2. **Primary key** es siempre `num`, nunca `id`
-3. **Uploads** son arrays — acceder con `[0].urlPath`
-4. **fieldName de imágenes** viene de `builder.json` → `vars.NOMBRE.relations.builder_custom` (ej: `image1`), NO del nombre de la variable
-5. **recordId para imágenes** es el `num` de `builder_custom`, NO el sectionId del módulo
-6. Tras `set_module_config_vars`, TODAS las variables del módulo (incluyendo upload) reciben config-vars automáticamente
-7. Si el token expira (error 403), usar `refresh_acai_token`

docs/modular-system.md

@@ -1,105 +0,0 @@
-# Acai Modular System
-
-## Modules
-
-Modules are the visual building blocks of Acai websites. Each module lives in `template/estandar/modulos/<module-id>/`.
-
-### File Structure
-
-```
-<module-id>/
-├── index-base.tpl    # Source template (EDIT THIS)
-├── index.tpl         # Compiled output (auto-generated, do NOT edit)
-├── index-twig.tpl    # Compiled Twig output (auto-generated, do NOT edit)
-├── builder.json      # Compiled builder vars (auto-generated, do NOT edit)
-├── style.css         # Module-scoped styles
-└── script.js         # Module JavaScript
-```
-
-### Template Syntax
-
-Templates use a hybrid of **Twig** and **Acai attributes**. The source file is always `index-base.tpl`.
-
-```html
-<section class="hero-section" id="{{ section_id }}">
-  <div class="container mx-auto px-4">
-    <h2 data-field-type="headfield" class="text-3xl font-bold">
-      Title here
-    </h2>
-    <p data-field-type="textbox" class="text-lg text-gray-600">
-      Description text
-    </p>
-    <img data-field-type="upload" src="placeholder.jpg" class="w-full rounded-lg" />
-    <a data-field-type="link" href="#" class="btn">Call to action</a>
-  </div>
-</section>
-```
-
-### Including Modules from Other Modules
-
-```html
-<module_id :param1="value1" :param2="'string value'"></module_id>
-```
-
-Parameters are received as variables inside the included module.
-
-### Global Variables
-
-| Variable | Description |
-|----------|-------------|
-| `section_id` | Unique ID per module instance (use for anchors, JS scoping) |
-| `interno` | `true` when viewing in CMS editor, `false` on public site |
-| `server.HTTP_HOST` | Current domain |
-| `loop.index` | 1-based iteration index (inside `c-for`) |
-| `loop.index is odd` / `loop.index is even` | For alternating layouts |
-
-
-## General Sections
-
-General sections are database-backed templates used for record views, headers, footers, and reusable layouts. They use the same template engine as modules.
-
-### Key Differences from Modules
-
-- Access record data via the `thisrecord` variable
-- Upload fields return **arrays**: `thisrecord.image[0].urlPath`
-- Additional upload metadata: `info1` (alt text), `info2`, `info3`, `info4`
-- Foreign key fields use `_num` suffix: `thisrecord.category_num`
-- Saved via `save_general_section()` (not `save_module()`)
-- Parser type 2 = Twig (recommended), 0 = Acai legacy syntax
-
-### Example: Record Template
-
-```html
-<article class="product-card">
-  <img src="{{ thisrecord.imagen[0].urlPath }}"
-       alt="{{ thisrecord.imagen[0].info1 }}"
-       class="w-full h-64 object-cover" />
-  <h3 class="text-xl font-semibold">{{ thisrecord.nombre }}</h3>
-  <p class="text-gray-600">{{ thisrecord.descripcion | raw }}</p>
-  <span class="text-2xl font-bold">{{ thisrecord.precio }}€</span>
-</article>
-```
-
-### Variable Assignment
-
-Use `<set>` tag to create variables from queries:
-
-```html
-<set :categories="'categorias' | get()"></set>
-<set :featured="'productos' | get({destacado: 1}, 'orden ASC', 3)"></set>
-```
-
-
-## Repeatable Content (multiv2)
-
-The `multiv2` builder field type creates repeatable groups of fields:
-
-```html
-<div c-for="item in record.items">
-  <h3 data-field-type="textfield">{{ item.title }}</h3>
-  <p data-field-type="textbox">{{ item.description }}</p>
-  <img data-field-type="upload" src="{{ item.image }}" />
-</div>
-```
-
-Access individual items: `record.items[0].title`, `record.items[1].image`, etc.

docs/module-creation-guide.md

@@ -1,77 +0,0 @@
-# Module Creation Guide
-
-## Style Reference
-
-When creating new modules, you MUST match the visual style of the existing project. Follow these steps IN ORDER:
-
-### Step 1: Check for `docs/project-styles.md`
-- If the file exists → read it and use it as your style reference. DONE — skip to module creation.
-- If the file does NOT exist → continue to Step 2.
-
-### Step 2: Determine if exploration is needed
-- Count modules in `template/estandar/modulos/` that have `builder.json` and do NOT start with `custom-`
-- If 3+ qualifying modules exist → continue to Step 3
-- If fewer than 3 → skip exploration, create the module based on the user's description. The style will be defined as modules are created.
-
-### Step 3: Explore and GENERATE the style guide (MANDATORY)
-- Read `index-base.tpl` and `style.css` of 3-4 representative modules (only those with `builder.json`, skip `custom-*`)
-- **You MUST then call `save_project_styles`** with a markdown summary including:
-  - Primary/secondary/accent colors (hex values)
-  - Font families and sizes used
-  - Spacing scale (padding/margin patterns)
-  - Common Tailwind classes and custom CSS patterns
-  - Button styles, card styles, section layouts
-  - Any recurring design patterns (gradients, shadows, borders, etc.)
-- This saves `docs/project-styles.md` which will be read by future module creation tasks — no re-exploration needed.
-
-**After creating a module:** if `docs/project-styles.md` does not exist yet and there are now 3+ modules, call `save_project_styles`.
-
-## Module Structure
-
-Each module lives in `template/estandar/modulos/<moduleId>/` with:
-- `index-base.tpl` — Twig template (source — EDIT THIS)
-- `style.css` — Module styles
-- `script.js` — Module JavaScript
-- `builder.json` — Compiled builder vars (auto-generated, do NOT edit)
-- `index.tpl` / `index-twig.tpl` — Compiled (auto-generated, do NOT edit)
-
-## Creating a Module — Full Workflow
-
-1. **Read style reference** (steps above)
-2. **`acai_write`** — Write `index-base.tpl` to `template/estandar/modulos/MODULE_ID/index-base.tpl`. The server automatically creates the directory, compiles and generates all derived files. `create_module` is a legacy alternative.
-3. **`add_module_to_record`** — Adds the module to a page. Response includes `sectionId` — use it directly in the next step.
-4. **`set_module_config_vars`** — Fill variables with content. Response includes `uploadFields` with `{ fieldName, recordNum }` for each upload variable.
-5. **Upload images** — Use `generate_image` then `upload_record_image` with the `recordNum` and `fieldName` from step 4's `uploadFields`. No need to read builder.json or call get_module_config_vars.
-6. **`navigate_browser`** — Navigate to the page so the user can see the result.
-
-## HTML Field Types
-
-Use these `data-field-type` attributes in `index-base.tpl`:
-
-| Attribute | Purpose | Example |
-|-----------|---------|---------|
-| `headfield` | Editable heading | `<h2 data-field-type="headfield">Title</h2>` |
-| `textfield` | Short editable text | `<span data-field-type="textfield">Text</span>` |
-| `wysiwyg` | Rich text editor | `<div data-field-type="wysiwyg">Content</div>` |
-| `upload` | Image upload | `<img data-field-type="upload" src="...">` |
-| `list` | Select dropdown | `<div data-field-type="list" data-options="opt1,opt2">` |
-| `multiv2` | Repeater/records | `<div data-field-type="multiv2">...</div>` |
-| `checkbox` | Toggle | `<div data-field-type="checkbox">` |
-| `colorpicker` | Color picker | `<div data-field-type="colorpicker">` |
-
-## MJML Modules
-
-Modules with `MJMLModule: true` in their schema are email modules:
-- Only appear when the page table is `mail_marketing`
-- For `mail_marketing` tables, only MJML modules are shown
-- Use MJML markup instead of standard HTML
-
-## Key Rules
-
-- Always use Tailwind CSS as primary styling
-- Use `section_id` variable for unique anchors/scoping
-- Use `interno` variable to detect CMS editor vs public view
-- Include other modules with: `<module_id :param1="value1"></module_id>`
-- After editing `index-base.tpl` with `acai_write` or `acai_line_replace`, the server compiles automatically — no need to call `compile_module`
-- Twig uses filters (with `|`), never functions
-- Twig concatenation uses `~`: `'value=' ~ variable`

docs/pages-and-records.md

@@ -1,104 +0,0 @@
-# Pages & Records Guide
-
-## Page Types
-
-Every CMS record that has an `enlace` (URL) field is a **page**. Pages come in two types determined by the `controlador` field:
-
-### Builder (Modular) Pages
-- `controlador` = `cms/lib/plugins/builder_saas/controlador.php`
-- Content is built from **modules** (drag & drop components)
-- The `builder` field contains a JSON array of module instances
-- Use MCP tools: `add_module_to_record`, `set_module_config_vars`, etc.
-- The page template renders modules in order from the builder JSON
-
-### Standard Pages
-- `controlador` = `cms/lib/plugins/builder_saas/controlador_tabla.php`
-- Content lives directly in the record fields (`content`, `titulo_alternativo`, etc.)
-- The `content` field is HTML (wysiwyg)
-- Use `create_or_update_record` to edit content directly
-- No modules involved
-
-### How to determine page type
-**Always check the `controlador` field** of the record:
-- Contains `controlador.php` (without `_tabla`) → **Builder**
-- Contains `controlador_tabla.php` → **Standard**
-
-## Table Types (Sections)
-
-Tables with pages are called **sections**. There are two section types defined by `menuType` in the schema:
-
-### Category (`menuType = "category"`)
-- **Hierarchical** — pages have parent/child relationships
-- Fields: `parentNum`, `depth`, `globalOrder`, `lineage`, `siblingOrder`
-- Example: `apartados` (main site pages)
-- Uses `visible_en_el_menu` field for menu visibility
-- Ordered by `globalOrder`
-
-### Multi (`menuType = "multi"`)
-- **Flat list** — no hierarchy
-- Uses `dragSortOrder` for ordering
-- Example: `blog`, `travesias`
-- Typically uses `visible` field (not `visible_en_el_menu`)
-
-## Critical Rules for Pages
-
-### NEVER change the `enlace` field
-Unless the user explicitly asks to change a page URL, **never modify the `enlace` field**. Changing it breaks existing links, SEO, and navigation. The enlace is set when the page is created and should remain stable.
-
-### NEVER change the `controlador` field
-The controlador defines whether the page is Builder or Standard. Changing it breaks the page rendering. Only set it during page creation.
-
-### Visibility fields
-- `apartados` and other category tables use: `visible_en_el_menu` (1 = visible, 0 = hidden)
-- `blog`, `travesias` and other multi tables use: `visible` (1 = visible, 0 = hidden)
-- Always check which field the table has before toggling visibility
-
-### Name/Title fields
-- Some tables use `name` (e.g. `apartados`)
-- Others use `title` (e.g. `blog`, `travesias`)
-- Check the schema to know which one to use
-
-## Working with Builder Pages
-
-### Adding content to a new Builder page
-1. List available modules: `list_available_modules`
-2. Add modules: `add_module_to_record` (one at a time, in order)
-3. Configure each module: `set_module_config_vars` with content
-4. Add images if needed: `upload_record_image` or `generate_image`
-
-### Editing an existing Builder page
-1. List current modules: `list_page_modules`
-2. Get module vars: `get_module_config_vars`
-3. Update vars: `set_module_config_vars`
-4. Or edit the module template: edit `index-base.tpl` → `compile_module`
-
-## Working with Standard Pages
-
-### Adding content to a Standard page
-Use `create_or_update_record` to set:
-- `content` — HTML content (main body)
-- `titulo_alternativo` — alternative title shown on the page
-- `titulo_de_pagina` — browser tab title (SEO)
-- `metatag_descripcion` — meta description (SEO)
-
-### Example: Update a standard page
-```
-create_or_update_record with:
-  tableName: "apartados"
-  recordNum: "87"
-  fields:
-    content: "<h2>Our Services</h2><p>We offer...</p>"
-    titulo_de_pagina: "Services | My Site"
-    metatag_descripcion: "Discover our services..."
-```
-
-## The `apartados` Table (Special)
-
-The `apartados` table is the main pages table in most Acai sites. Key characteristics:
-- `menuType = "category"` — hierarchical with parent/child
-- `parentNum` — the num of the parent page (0 = root level)
-- `depth` — nesting level (0 = root, 1 = child, 2 = grandchild)
-- `globalOrder` — display order across the entire tree
-- `visible_en_el_menu` — whether the page shows in the navigation menu
-- `breadcrumb` — auto-generated breadcrumb path
-- Pages can be either Builder or Standard (check `controlador` field per record)

docs/quick-reference.md

@@ -1,85 +0,0 @@
-# Quick Reference
-
-## Reglas Críticas
-
-| Regla | Correcto | Incorrecto |
-|-------|----------|------------|
-| Nombres de tabla | `'productos'` | `'cms_productos'` |
-| Primary key | `record.num` | `record.id` |
-| Foreign keys | `categoria_num` | `categoria_id` |
-| Upload fields | `record.imagen[0].urlPath` | `record.imagen` |
-| Optimizar imagen | `record.imagen[0].urlPath \| imagec(800)` | `record.imagen.url` |
-| Filtros Twig | `{{ 'table' \| get() }}` | `{{ get('table') }}` |
-| Campo enlace | `{{ producto.enlace }}` (ya tiene barras) | `"/{{ producto.enlace }}/"` |
-| Nombres builder vars | `data-field-label` → sin espacios/especiales, minúsculas | Mantener casing original |
-| Checkbox | `1` o `0` (número) | `true`/`false` |
-| Formato fecha | `YYYY-MM-DD HH:mm:ss` | Cualquier otro formato |
-| c-if igualdad | `c-if="x = 'valor'"` (un `=`) | `c-if="x == 'valor'"` |
-| Twig if igualdad | `{% if x == 'valor' %}` (doble `==`) | `{% if x = 'valor' %}` |
-| queryDB tablas | `SELECT * FROM cms_tabla` (con prefijo) | `SELECT * FROM tabla` |
-| get tablas | `'tabla' \| get()` (sin prefijo) | `'cms_tabla' \| get()` |
-
-## Builder Variable Types
-
-| Type | Elemento | Retorna |
-|------|----------|---------|
-| `textfield` | `<p>` | String |
-| `headfield` | `<h1>`-`<h6>` | String + var `_tag` |
-| `textbox` | `<div>` | String multilínea |
-| `wysiwyg` | `<div class="wysiwyg">` | HTML string |
-| `link` | `<a>` | URL string |
-| `upload` | `<img>` | Array de `{urlPath, info1}` |
-| `uploadMulti` | `<li>` | Itera archivos subidos |
-| `list` (fijo) | `<div data-list-options="...">` | Valor seleccionado |
-| `list` (tabla) | `<div data-list-table="...">` | `num` del registro |
-| `multiv2` | `<li>` wrapper | Array de objetos |
-
-## Acai HTML Attributes
-
-| Atributo | Uso | Ejemplo |
-|----------|-----|---------|
-| `c-if` | Condicional | `<p c-if="activo = 1">` |
-| `c-else` | Rama else | `<p c-else>` |
-| `c-for` | Loop array | `<li c-for="item in items">` |
-| `c-for` | Loop tabla | `<li c-for="p in productos" c-where="'activo=1'" c-limit="10">` |
-| `c-hidden` | Variable oculta | `<p c-hidden="true" data-field-type="textfield">` |
-| `c-class` | Clase condicional | `<div c-class="{ 'bg-red': color == '1' }">` |
-| `c-form` | Formulario | `<c-form tableName="'contacto'" captcha="true">` |
-
-## Twig Filters
-
-| Filtro | Uso |
-|--------|-----|
-| `get` | `'table' \| get(where, order, limit)` |
-| `hook` | `'hooks/module_id/' \| hook({params})` |
-| `module` | `'module_id' \| module({params})` |
-| `queryDB` | `'SELECT ...' \| queryDB()` |
-| `imagec` | `path \| imagec(width)` |
-| `translate` | `'text' \| translate` |
-| `json_decode` | `'json_string' \| json_decode` |
-| `raw` | `variable \| raw` |
-| `truncate` | `text \| truncate(100)` |
-
-## Formato de datos para registros
-
-| Tipo | Formato | Ejemplo |
-|------|---------|---------|
-| Text field | String | `"Texto"` |
-| Text box | String multilínea | `"Línea 1\nLínea 2"` |
-| Date/time | `YYYY-MM-DD HH:mm:ss` | `"2025-12-03 10:30:00"` |
-| Wysiwyg | HTML string | `"<p class=\"font-bold\">Texto</p>"` |
-| List | String o número | `"activo"` o `"1"` |
-| Checkbox | Número 1/0 | `1` o `0` |
-| Multivalores | String JSON | `"[{\"producto\":\"1\"}]"` |
-| Upload | NO enviar — subir imagen después de crear registro |
-
-## Variables globales
-
-| Variable | Descripción |
-|----------|-------------|
-| `section_id` | ID único por instancia del módulo |
-| `server.HTTP_HOST` | Dominio actual |
-| `loop.index` | Índice de iteración (1-based) |
-| `loop.index is odd/even` | Para layouts alternados |
-| `interno` | True dentro del editor CMS |
-| `thisrecord` | Registro actual (en secciones generales) |

docs/twig-filters.md

@@ -1,209 +0,0 @@
-# Twig Filters Reference
-
-Acai usa filtros Twig con sintaxis `|`. No usar funciones Twig — solo filtros.
-
-## `get` — Consultar tabla de BD
-
-```twig
-{{ 'table_name' | get(where, order, limit) }}
-```
-
-- `table_name`: sin prefijo `cms_`
-- `where`: string SQL o objeto (opcional)
-- `order`: string de orden (opcional)
-- `limit`: int (opcional)
-
-```twig
-{# Todos los registros #}
-{% set products = 'productos' | get() %}
-
-{# Con WHERE string #}
-{% set active = 'productos' | get('activo=1') %}
-
-{# Con WHERE objeto #}
-{% set active = 'productos' | get({activo: 1}) %}
-
-{# Con WHERE + ORDER + LIMIT #}
-{% set latest = 'noticias' | get('publicado=1', 'fecha DESC', 6) %}
-
-{# Completo #}
-{% set caros = 'productos' | get('precio > 100', 'precio DESC', 20) %}
-
-{# Single record (primer resultado) #}
-{% set product = 'productos' | get({num: 42}) %}
-{{ product[0].nombre }}
-```
-
-Iterar resultados:
-```twig
-{% for producto in 'productos' | get('activo=1', 'num DESC', 10) %}
-  <h3>{{ producto.titulo }}</h3>
-{% endfor %}
-```
-
-## `queryDB` — SQL directo
-
-Usa nombre de tabla completo WITH prefijo `cms_`.
-
-```twig
-{% set results = 'SELECT * FROM cms_productos WHERE precio > 100 ORDER BY precio ASC' | queryDB() %}
-
-{# JOIN complejo #}
-{% set top = 'SELECT p.*, COUNT(v.num) as ventas
-              FROM cms_productos p
-              LEFT JOIN cms_ventas v ON v.producto_num = p.num
-              GROUP BY p.num
-              ORDER BY ventas DESC
-              LIMIT 5' | queryDB() %}
-```
-
-Usar solo cuando `get` no sea suficiente.
-
-## `hook` — Ejecutar PHP Hook
-
-```twig
-{# Llamar y mostrar resultado #}
-{{ 'hooks/module_id/' | hook({param1: 'value', param2: variable}) }}
-
-{# Capturar en variable #}
-{% set result = 'hooks/calcular_precio/' | hook({cantidad: 5, tipo: 'mayoreo'}) %}
-<p>Total: ${{ result.total }}</p>
-```
-
-## `module` — Renderizar otro módulo
-
-```twig
-{{ 'other_module_id' | module({param1: value1}) }}
-
-{# Capturar en variable #}
-{% set carrito = 'carrito_compras' | module({usuario_id: 123}) %}
-```
-
-## `imagec` — Optimizar/redimensionar imágenes
-
-```twig
-{# Redimensionar a ancho #}
-<img src="{{ record.image[0].urlPath | imagec(400) }}" />
-
-{# En srcset #}
-<img src="{{ record.image[0].urlPath | imagec(800) }}"
-     srcset="{{ record.image[0].urlPath | imagec(400) }} 400w,
-             {{ record.image[0].urlPath | imagec(800) }} 800w" />
-```
-
-## `translate` — Traducción
-
-```twig
-{{ 'Bienvenido' | translate }}
-{{ variable | translate }}
-```
-
-## `raw` — Renderizar HTML sin escapar
-
-```twig
-{{ record.description | raw }}
-```
-
-## `truncate` — Truncar texto
-
-```twig
-{{ record.description | truncate(150) }}
-```
-
-## `json_decode` — Parsear JSON
-
-```twig
-{% set data = jsonString | json_decode %}
-{{ data.key }}
-```
-
-## `split`, `filter` — Filtros estándar Twig
-
-Misma funcionalidad que Twig estándar.
-
----
-
-## Operadores y Sintaxis
-
-### Concatenación
-
-Twig usa `~` (no `.` ni `+`):
-
-```twig
-{{ 'Hello ' ~ name ~ '!' }}
-{% set url = '/products/' ~ product.slug ~ '/' %}
-```
-
-### Concatenar en filtros
-
-```twig
-{% set stock = 'stocks' | get('producto_num=' ~ producto.num) %}
-```
-
-### Ternario / Default
-
-```twig
-{{ title | default('Default Title') }}
-{{ isActive ? 'active' : 'inactive' }}
-```
-
-### Comparaciones
-
-```twig
-{% if items | length > 0 %}
-{% if type == 'premium' %}
-{% if name is not empty %}
-```
-
-En `c-if` usar `=` (simple). En `{% if %}` usar `==` (doble).
-
----
-
-## Ejemplos complejos
-
-### Galería con productos y stock
-
-```twig
-{% for producto in 'productos' | get('destacado=1', 'num DESC', 12) %}
-  <div class="producto-card">
-    <img src="{{ producto.imagen[0].urlPath | imagec(400) }}" alt="{{ producto.titulo }}">
-    <h3>{{ producto.titulo }}</h3>
-    <p>{{ producto.descripcion | truncate(100) }}</p>
-
-    {% set stock = 'stocks' | get('producto_num=' ~ producto.num) %}
-    <span>Stock: {{ stock[0].cantidad }}</span>
-  </div>
-{% endfor %}
-```
-
-### Múltiples filtros combinados
-
-```twig
-{% set categorias = 'categorias' | get() %}
-{% set productos = 'productos' | get('activo=1', 'titulo ASC', 20) %}
-{% set stats = 'hooks/obtener_stats/' | hook({fecha_inicio: '2024-01-01'}) %}
-
-<h1>{{ stats.titulo | translate }}</h1>
-
-<nav>
-  {% for cat in categorias %}
-    <a href="">{{ cat.nombre }}</a>
-  {% endfor %}
-</nav>
-
-{% for prod in productos %}
-  <div>
-    <img src="{{ prod.imagen[0].urlPath | imagec(300) }}" alt="">
-    <h3>{{ prod.titulo }}</h3>
-  </div>
-{% endfor %}
-```
-
----
-
-## Puntos importantes
-
-1. **Solo filtros, no funciones:** `'tabla' | get()` no `get('tabla')`
-2. **Upload fields son arrays:** `record.imagen[0].urlPath`, no `record.imagen`
-3. **Tablas sin prefijo `cms_`** en `get()`. Con prefijo en `queryDB()`
-4. **Concatenar con `~`:** `'stocks' | get('producto_num=' ~ producto.num)`

docs/vue-builder-examples.md

@@ -1,695 +0,0 @@
-# Ejemplos de Builder Vue - Producción
-
-Colección de ejemplos reales de archivos `builder.vue` implementados en producción. Cada ejemplo incluye el código completo y notas sobre decisiones de diseño importantes.
-
----
-
-## Ejemplo 1: Banner Slideshow
-
-### Descripción
-Banner hero con slideshow de imágenes o video de fondo, overlay configurable, textos principales (pretítulo, título, subtítulo) y botón de llamada a la acción.
-
-### Características principales
-- **5 tabs organizados**: Configuración, Imágenes, Textos, Enlaces, Colores
-- **Selector imagen/video**: Toggle con iconos que alterna entre imagen y video con `v-show`
-- **Overlay completo**: Tipo (sin degradado/con degradado), color y opacidad agrupados en tab Imágenes
-- **Colorpickers**: Para overlay y color de texto general con textfield oculto
-- **Toggles con iconos**: Sombra (X/check), tipo imagen (foto/video), tipo overlay (cuadrado/degradado)
-- **Logo adicional**: Upload de logo que se superpone al banner
-- **Configuraciones globales**: Posición texto, sombra, container, altura banner
-
-### Decisiones de diseño clave
-
-1. **Selector imagen/video como primer campo del tab Imágenes**: El toggle de tipo de fondo está al inicio del tab Imágenes, antes de los uploads, según la regla 10.1
-2. **v-show en uploads**:
-   - Upload de imágenes: `v-show="data.tipodeimagen && data.tipodeimagen.newValues.builder_custom.value == ''"`
-   - Upload de video: `v-show="data.tipodeimagen && data.tipodeimagen.newValues.builder_custom.value == '1'"`
-   - NUNCA quitar estos `v-show`, son esenciales
-3. **Grupo overlay en tab Imágenes**: El grupo completo (tipo + color + opacidad) está en Imágenes, NO en Colores, porque afecta directamente al fondo visual (regla 10.2)
-4. **Radio borde en tab Enlaces**: Campo que afecta al botón va en el tab del enlace, no en Configuración (regla 10.3)
-5. **Recuerda con HTML escapado**: El campo título incluye un "Recuerda" con etiquetas HTML escapadas (`<span>`) para guiar al usuario
-6. **Color del texto en tab Colores**: El color general del texto va en su propio tab, no mezclado con el overlay
-
-### Tabs configurados
-
-```javascript
-tabsConfig: [
-    { id: "configuracion", label: "Configuración", color: "#f59e0b", icon: '<svg>...</svg>' },
-    { id: "imagenes", label: "Imágenes", color: "#10b981", icon: '<svg>...</svg>' },
-    { id: "textos", label: "Textos", color: "#3b82f6", icon: '<svg>...</svg>' },
-    { id: "enlaces", label: "Enlaces", color: "#ef4444", icon: '<svg>...</svg>' },
-    { id: "colores", label: "Colores", color: "#8b5cf6", icon: '<svg>...</svg>' }
-]
-```
-
-### Componentes utilizados
-- `acai-vue-tabs` - Sistema de tabs con storage-key y apply-theme-styles
-- `acai-vue-selectv2` - Selectores (algunos con `:toggle-icons`)
-- `acai-vue-textfield` - Campos de texto simple (pretítulo, subtítulo)
-- `acai-vue-title` - Encabezado principal con placeholder
-- `acai-vue-linkv2` - Enlaces con `:show_text="true"`
-- `acai-vue-upload` - Uploads de imagen/video/logo con todas las props necesarias
-- `acai-vue-colorpicker` - Pickers de color con textfield oculto asociado
-
-### Iconos con toggle
-
-```javascript
-iconosSombra: {
-    '': '<svg>...(icon-tabler-x)</svg>',
-    '1': '<svg>...(icon-tabler-check)</svg>'
-},
-iconosTipoImagen: {
-    '': '<svg>...(icon-tabler-photo)</svg>',
-    '1': '<svg>...(icon-tabler-video)</svg>'
-},
-iconosOverlay: {
-    '': '<svg>...(icon-tabler-square)</svg>',
-    '1': '<svg>...(icon-tabler-gradient)</svg>'
-}
-```
-
-### Código completo
-
-```vue
-<template>
-    <div v-if="data">
-        <acai-vue-tabs v-if="data" :tabs="tabsConfig" :storage-key="'banner-slideshow-tabs-' + (section_id || 'default')" :apply-theme-styles="true">
-
-            <!-- TAB: CONFIGURACIÓN -->
-            <template #configuracion="{ color }">
-                <div class="w-full mb-6">
-                    <p class="text-xl font-semibold text-gray-800">Ajustes generales del banner</p>
-                </div>
-
-                <!-- Lado texto -->
-                <div class="flex w-full items-center">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" class="w-10 h-10 flex-shrink-0 mr-4 stroke-current" :style="{ color: color }" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none" /><path d="M3 3m0 2a2 2 0 0 1 2 -2h14a2 2 0 0 1 2 2v14a2 2 0 0 1 -2 2h-14a2 2 0 0 1 -2 -2z" /><path d="M9 15h-2" /><path d="M13 12h-6" /><path d="M11 9h-4" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Posición del texto :</b> Define la alineación del contenido dentro del banner.</p>
-                        </div>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-selectv2 :builder="builder" :data="data" :field="'ladotexto'" @save-data="saveData"></acai-vue-selectv2>
-                        </div>
-                    </div>
-                </div>
-
-                <!-- Ver sombra -->
-                <div class="w-full items-center mt-6">
-                    <div class="w-full flex items-center">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-shadow"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-9 0a9 9 0 1 0 18 0a9 9 0 1 0 -18 0" /><path d="M13 12h5" /><path d="M13 15h4" /><path d="M13 18h1" /><path d="M13 9h4" /><path d="M13 6h1" /></svg>
-                        </div>
-                        <div class="relative">
-                            <acai-vue-selectv2 :builder="builder" :data="data" :field="'versombra'" :toggle-icons="iconosSombra" @save-data="saveData"></acai-vue-selectv2>
-                        </div>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Sombra en textos :</b> Aplica un efecto de sombra a los textos del banner.</p>
-                </div>
-
-                <!-- Container -->
-                <div class="flex w-full items-center mt-6">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-arrow-autofit-width"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 12v-6a2 2 0 0 1 2 -2h12a2 2 0 0 1 2 2v6" /><path d="M10 18h-7" /><path d="M21 18h-7" /><path d="M6 15l-3 3l3 3" /><path d="M18 15l3 3l-3 3" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Ancho del contenedor :</b> Limita el ancho máximo del contenido textual.</p>
-                        </div>
-                        <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> por defecto ocupa todo el ancho disponible (Full container).</p>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-selectv2 :builder="builder" :data="data" :field="'container'" @save-data="saveData"></acai-vue-selectv2>
-                        </div>
-                    </div>
-                </div>
-
-                <!-- Altura banner -->
-                <div class="flex w-full items-center mt-6">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-arrow-autofit-height"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 20h-6a2 2 0 0 1 -2 -2v-12a2 2 0 0 1 2 -2h6" /><path d="M18 14v7" /><path d="M18 3v7" /><path d="M15 18l3 3l3 -3" /><path d="M15 6l3 -3l3 3" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Altura del banner :</b> Altura visible de la sección del banner.</p>
-                        </div>
-                        <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> por defecto es pantalla completa (100vh).</p>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-selectv2 :builder="builder" :data="data" :field="'alturadelbanner'" @save-data="saveData"></acai-vue-selectv2>
-                        </div>
-                    </div>
-                </div>
-            </template>
-
-            <!-- TAB: IMÁGENES -->
-            <template #imagenes="{ color }">
-                <div class="w-full mb-6">
-                    <p class="text-xl font-semibold text-gray-800">Fondo y elementos visuales del banner</p>
-                </div>
-
-                <!-- Tipo de imagen (selector imagen/video) -->
-                <div class="w-full items-center mt-6">
-                    <div class="w-full flex items-center">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="#ffffff" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 stroke-current icon icon-tabler icons-tabler-outline icon-tabler-photo-video"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 15h-3a3 3 0 0 1 -3 -3v-6a3 3 0 0 1 3 -3h6a3 3 0 0 1 3 3v3" /><path d="M9 12a3 3 0 0 1 3 -3h6a3 3 0 0 1 3 3v6a3 3 0 0 1 -3 3h-6a3 3 0 0 1 -3 -3l0 -6" /><path d="M3 12l2.296 -2.296a2.41 2.41 0 0 1 3.408 0l.296 .296" /><path d="M14 13.5v3l2.5 -1.5l-2.5 -1.5" /><path d="M7 6v.01" /></svg>
-                        </div>
-                        <div class="relative">
-                            <acai-vue-selectv2 :builder="builder" :data="data" :field="'tipodeimagen'" :toggle-icons="iconosTipoImagen" @save-data="saveData"></acai-vue-selectv2>
-                        </div>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Tipo de fondo :</b> Selecciona si el fondo del banner será una imagen o un vídeo.</p>
-                </div>
-
-                <!-- Imágenes (visible cuando es imagen o vacío) -->
-                <div class="flex w-full items-center mt-6" v-show="data.tipodeimagen && data.tipodeimagen.newValues.builder_custom.value == ''">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" :style="{ color: color }" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 stroke-current"><path stroke="none" d="M0 0h24v24H0z" fill="none" /><path d="M15 6l.01 0" /><path d="M3 6a3 3 0 0 1 3 -3h12a3 3 0 0 1 3 3v8a3 3 0 0 1 -3 3h-12a3 3 0 0 1 -3 -3l0 -8" /><path d="M3 13l4 -4a3 5 0 0 1 3 0l4 4" /><path d="M13 12l2 -2a3 5 0 0 1 3 0l3 3" /><path d="M8 21l.01 0" /><path d="M12 21l.01 0" /><path d="M16 21l.01 0" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Imágenes :</b> Añade las imágenes que rotarán en el slideshow del banner.</p>
-                        </div>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-upload ref="upload_imagenes" :reference="'upload_imagenes'" :tablename="'builder_custom'" :fieldname="builder.vars.imagenes.relations.builder_custom" :recordnum="data.imagenes.recordNum" :field="data.imagenes" :builder_field="builder.vars.imagenes" :presavetempid="data.imagenes.preSaveTempId" :add_button="true" @add_button_click="$parent.openCute('imagenes',data,false,'upload_imagenes')" class="border-2 px-3 py-2 border-gray-600 rounded-lg shadow bg-gray-200"></acai-vue-upload>
-                        </div>
-                    </div>
-                </div>
-
-                <!-- Video (visible cuando es video) -->
-                <div class="flex w-full items-center mt-6" v-show="data.tipodeimagen && data.tipodeimagen.newValues.builder_custom.value == '1'">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-video"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M15 10l4.553 -2.276a1 1 0 0 1 1.447 .894v6.764a1 1 0 0 1 -1.447 .894l-4.553 -2.276v-4z" /><path d="M3 6m0 2a2 2 0 0 1 2 -2h8a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-8a2 2 0 0 1 -2 -2z" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Vídeo :</b> Sube el vídeo de fondo del banner.</p>
-                        </div>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-upload ref="upload_video" :reference="'upload_video'" :tablename="'builder_custom'" :fieldname="builder.vars.video.relations.builder_custom" :recordnum="data.video.recordNum" :field="data.video" :builder_field="builder.vars.video" :presavetempid="data.video.preSaveTempId" :add_button="true" @add_button_click="$parent.openCute('video',data,false,'upload_video')" class="border-2 px-3 py-2 border-gray-600 rounded-lg shadow bg-gray-200"></acai-vue-upload>
-                        </div>
-                    </div>
-                </div>
-
-                <!-- Logo -->
-                <div class="flex w-full items-center mt-6">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-icons"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6.5 6.5m-3.5 0a3.5 3.5 0 1 0 7 0a3.5 3.5 0 1 0 -7 0" /><path d="M2.5 21h8l-4 -7z" /><path d="M14 3l7 7" /><path d="M14 10l7 -7" /><path d="M14 14h7v7h-7z" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Logo :</b> Imagen del logotipo que aparecerá sobre el banner.</p>
-                        </div>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-upload ref="upload_logo" :reference="'upload_logo'" :tablename="'builder_custom'" :fieldname="builder.vars.logo.relations.builder_custom" :recordnum="data.logo.recordNum" :field="data.logo" :builder_field="builder.vars.logo" :presavetempid="data.logo.preSaveTempId" :add_button="true" @add_button_click="$parent.openCute('logo',data,false,'upload_logo')" class="border-2 px-3 py-2 border-gray-600 rounded-lg shadow bg-gray-200"></acai-vue-upload>
-                        </div>
-                    </div>
-                </div>
-
-                <!-- Tipo de overlay -->
-                <div class="w-full items-center mt-6">
-                    <div class="w-full flex items-center">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-background"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 8l4 -4" /><path d="M14 4l-10 10" /><path d="M4 20l16 -16" /><path d="M20 10l-10 10" /><path d="M20 16l-4 4" /></svg>
-                        </div>
-                        <div class="relative">
-                            <acai-vue-selectv2 :builder="builder" :data="data" :field="'tipodeoverlay'" :toggle-icons="iconosOverlay" @save-data="saveData"></acai-vue-selectv2>
-                        </div>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Tipo de overlay :</b> Elige si la capa de color se aplica de forma uniforme o con degradado.</p>
-                </div>
-
-                <!-- Color del overlay -->
-                <div class="flex w-full items-center mt-6">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-test-pipe"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M20 8.04l-12.122 12.124a2.857 2.857 0 1 1 -4.041 -4.04l12.122 -12.124" /><path d="M7 13h8" /><path d="M19 15l1.5 1.6a2 2 0 1 1 -3 0l1.5 -1.6" /><path d="M15 3l6 6" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Color del overlay :</b> Color y opacidad de la capa que se superpone sobre la imagen o vídeo.</p>
-                        </div>
-                        <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> por defecto el overlay es transparente.</p>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-colorpicker :builder="builder" :data="data" :field="'colordeloverlay'" :label="'Color overlay'" :color="'transparent'" @save-data="saveData"></acai-vue-colorpicker>
-                        </div>
-                        <div style="display: none">
-                            <acai-vue-textfield :builder="builder" :data="data" :field="'colordeloverlay'" @save-data="saveData"></acai-vue-textfield>
-                        </div>
-                    </div>
-                </div>
-
-            </template>
-
-            <!-- TAB: TEXTOS -->
-            <template #textos="{ color }">
-                <div class="w-full mb-6">
-                    <p class="text-xl font-semibold text-gray-800">Contenido textual del banner</p>
-                </div>
-
-                <!-- Pretítulo -->
-                <div class="flex w-full items-center">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-text-size"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 7v-2h13v2" /><path d="M10 5v14" /><path d="M12 19h-4" /><path d="M15 13v-1h6v1" /><path d="M18 12v7" /><path d="M17 19h2" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Pretítulo :</b> Texto que aparece encima del título principal.</p>
-                        </div>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-textfield :builder="builder" :data="data" :field="'pretitulo'" :placeholder="'Ej: Bienvenidos'" @save-data="saveData"></acai-vue-textfield>
-                        </div>
-                    </div>
-                </div>
-
-                <!-- Título -->
-                <div class="flex w-full items-center mt-6">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" class="w-10 h-10 flex-shrink-0 mr-4 stroke-current" :style="{ color: color }" viewBox="0 0 24 24" stroke-width="1.5" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none" /><path d="M7 12h10" /><path d="M7 4v16" /><path d="M17 4v16" /><path d="M15 20h4" /><path d="M15 4h4" /><path d="M5 20h4" /><path d="M5 4h4" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Título :</b> Encabezado principal del banner.</p>
-                        </div>
-                        <p class="text-xs leading-snug text-gray-600 font-light mt-2"><b class="text-black">Recuerda :</b> utiliza las etiquetas <span class="text-black font-semibold">&lt;span&gt; &lt;/span&gt;</span> para resaltar las palabras clave.</p>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-title :builder="builder" :data="data" :field="'titulo'" placeholder="Título del banner" @save-data="saveData"></acai-vue-title>
-                        </div>
-                    </div>
-                </div>
-
-                <!-- Subtítulo -->
-                <div class="flex w-full items-center mt-6">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-text-size"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 7v-2h13v2" /><path d="M10 5v14" /><path d="M12 19h-4" /><path d="M15 13v-1h6v1" /><path d="M18 12v7" /><path d="M17 19h2" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Subtítulo :</b> Texto que aparece debajo del título principal.</p>
-                        </div>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-textfield :builder="builder" :data="data" :field="'subtitulo'" :placeholder="'Ej: Tu solución ideal'" @save-data="saveData"></acai-vue-textfield>
-                        </div>
-                    </div>
-                </div>
-            </template>
-
-            <!-- TAB: ENLACES -->
-            <template #enlaces="{ color }">
-                <div class="w-full mb-6">
-                    <p class="text-xl font-semibold text-gray-800">Botón de llamada a la acción</p>
-                </div>
-
-                <!-- Enlace -->
-                <div class="flex w-full items-center">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" class="w-10 h-10 flex-shrink-0 mr-4 stroke-current" :style="{ color: color }" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none" /><path d="M9 15l6 -6" /><path d="M11 6l.463 -.536a5 5 0 0 1 7.071 7.072l-.534 .464" /><path d="M13 18l-.397 .534a5.068 5.068 0 0 1 -7.127 0a4.972 4.972 0 0 1 0 -7.071l.524 -.463" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Enlace :</b> Configura el botón con su texto y destino.</p>
-                        </div>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-linkv2 :builder="builder" :data="data" :field="'enlace'" @save-data="saveData" :show_text="true"></acai-vue-linkv2>
-                        </div>
-                    </div>
-                </div>
-
-                <!-- Radio borde enlace -->
-                <div class="flex w-full items-center mt-6">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 stroke-current icon icon-tabler icons-tabler-outline icon-tabler-border-radius"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 12v-4a4 4 0 0 1 4 -4h4" /><path d="M16 4l0 .01" /><path d="M20 4l0 .01" /><path d="M20 8l0 .01" /><path d="M20 12l0 .01" /><path d="M4 16l0 .01" /><path d="M20 16l0 .01" /><path d="M4 20l0 .01" /><path d="M8 20l0 .01" /><path d="M12 20l0 .01" /><path d="M16 20l0 .01" /><path d="M20 20l0 .01" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Radio del borde :</b> Redondeo de las esquinas del botón de enlace.</p>
-                        </div>
-                        <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> por defecto es 'sm' (ligeramente redondeado).</p>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-selectv2 :builder="builder" :data="data" :field="'radiobordeenlace'" @save-data="saveData"></acai-vue-selectv2>
-                        </div>
-                    </div>
-                </div>
-            </template>
-
-            <!-- TAB: COLORES -->
-            <template #colores="{ color }">
-                <div class="w-full mb-6">
-                    <p class="text-xl font-semibold text-gray-800">Personalización de colores</p>
-                </div>
-
-                <!-- Color del texto -->
-                <div class="flex w-full items-center">
-                    <div class="w-full">
-                        <div class="flex items-center">
-                            <svg xmlns="http://www.w3.org/2000/svg" class="w-10 h-10 flex-shrink-0 mr-4 stroke-current" :style="{ color: color }" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none" /><path d="M12 21a9 9 0 0 1 0 -18c4.97 0 9 3.582 9 8c0 1.06 -.474 2.078 -1.318 2.828c-.844 .75 -1.989 1.172 -3.182 1.172h-2.5a2 2 0 0 0 -1 3.75a1.3 1.3 0 0 1 -1 2.25" /><path d="M8.5 10.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /><path d="M12.5 7.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /><path d="M16.5 10.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /></svg>
-                            <p class="leading-snug text-gray-600"><b class="text-black">Color del texto :</b> Color general de todos los textos del banner.</p>
-                        </div>
-                        <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> por defecto es blanco (#ffffff).</p>
-                        <div class="relative mt-2 ml-14">
-                            <acai-vue-colorpicker :builder="builder" :data="data" :field="'colordeltexto'" :label="'Color del texto'" :color="'#ffffff'" @save-data="saveData"></acai-vue-colorpicker>
-                        </div>
-                        <div style="display: none">
-                            <acai-vue-textfield :builder="builder" :data="data" :field="'colordeltexto'" @save-data="saveData"></acai-vue-textfield>
-                        </div>
-                    </div>
-                </div>
-            </template>
-
-        </acai-vue-tabs>
-    </div>
-</template>
-
-<style scoped></style>
-
-<script>
-module.exports = {
-    props: ["active", "section_id"],
-    data() {
-        return {
-            data: null,
-            builder: null,
-            idiomas: IDIOMAS,
-            tabsConfig: [
-                { id: "configuracion", label: "Configuración", color: "#f59e0b", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" fill="none"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M10.325 4.317c.426 -1.756 2.924 -1.756 3.35 0a1.724 1.724 0 0 0 2.573 1.066c1.543 -.94 3.31 .826 2.37 2.37a1.724 1.724 0 0 0 1.065 2.572c1.756 .426 1.756 2.924 0 3.35a1.724 1.724 0 0 0 -1.066 2.573c.94 1.543 -.826 3.31 -2.37 2.37a1.724 1.724 0 0 0 -2.572 1.065c-.426 1.756 -2.924 1.756 -3.35 0a1.724 1.724 0 0 0 -2.573 -1.066c-1.543 .94 -3.31 -.826 -2.37 -2.37a1.724 1.724 0 0 0 -1.065 -2.572c-1.756 -.426 -1.756 -2.924 0 -3.35a1.724 1.724 0 0 0 1.066 -2.573c-.94 -1.543 .826 -3.31 2.37 -2.37c1 .608 2.296 .07 2.572 -1.065z"/><path d="M9 12a3 3 0 1 0 6 0a3 3 0 0 0 -6 0"/></svg>' },
-                { id: "imagenes", label: "Imágenes", color: "#10b981", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M15 8h.01" /><path d="M11 20h-4a3 3 0 0 1 -3 -3v-10a3 3 0 0 1 3 -3h10a3 3 0 0 1 3 3v4" /><path d="M4 15l4 -4c.928 -.893 2.072 -.893 3 0l3 3" /><path d="M14 14l1 -1c.31 -.298 .644 -.497 .987 -.596" /><path d="M18.42 15.61a2.1 2.1 0 0 1 2.97 2.97l-3.39 3.42h-3v-3l3.42 -3.39" /></svg>' },
-                { id: "textos", label: "Textos", color: "#3b82f6", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M19 10h-14" /><path d="M5 6h14" /><path d="M14 14h-9" /><path d="M5 18h6" /><path d="M18 15v6" /><path d="M15 18h6" /></svg>' },
-                { id: "enlaces", label: "Enlaces", color: "#ef4444", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 15l6 -6"/><path d="M11 6l.463 -.536a5 5 0 0 1 7.071 7.072l-.534 .464"/><path d="M13 18l-.397 .534a5.068 5.068 0 0 1 -7.127 0a4.972 4.972 0 0 1 0 -7.071l.524 -.463"/></svg>' },
-                { id: "colores", label: "Colores", color: "#8b5cf6", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M19 3h-4a2 2 0 0 0 -2 2v12a4 4 0 0 0 8 0v-12a2 2 0 0 0 -2 -2" /><path d="M13 7.35l-2 -2a2 2 0 0 0 -2.828 0l-2.828 2.828a2 2 0 0 0 0 2.828l9 9" /><path d="M7.3 13h-2.3a2 2 0 0 0 -2 2v4a2 2 0 0 0 2 2h12" /><path d="M17 17l0 .01" /></svg>' },
-            ],
-            iconosSombra: {
-                '': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-shadow-off"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5.634 5.638a9 9 0 0 0 12.728 12.727m1.68 -2.32a9 9 0 0 0 -12.086 -12.088" /><path d="M16 12h2" /><path d="M13 15h2" /><path d="M13 18h1" /><path d="M13 9h4" /><path d="M13 6h1" /><path d="M3 3l18 18" /></svg>',
-                '1': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-shadow"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 12a9 9 0 1 0 18 0a9 9 0 1 0 -18 0" /><path d="M13 12h5" /><path d="M13 15h4" /><path d="M13 18h1" /><path d="M13 9h4" /><path d="M13 6h1" /></svg>'
-            },
-            iconosTipoImagen: {
-                '': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-photo"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M15 8h.01" /><path d="M3 6a3 3 0 0 1 3 -3h12a3 3 0 0 1 3 3v12a3 3 0 0 1 -3 3h-12a3 3 0 0 1 -3 -3v-12z" /><path d="M3 16l5 -5c.928 -.893 2.072 -.893 3 0l5 5" /><path d="M14 14l1 -1c.928 -.893 2.072 -.893 3 0l3 3" /></svg>',
-                '1': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-video"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M15 10l4.553 -2.276a1 1 0 0 1 1.447 .894v6.764a1 1 0 0 1 -1.447 .894l-4.553 -2.276v-4z" /><path d="M3 6m0 2a2 2 0 0 1 2 -2h8a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-8a2 2 0 0 1 -2 -2z" /></svg>'
-            },
-            iconosOverlay: {
-                '': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-square"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 3m0 2a2 2 0 0 1 2 -2h14a2 2 0 0 1 2 2v14a2 2 0 0 1 -2 2h-14a2 2 0 0 1 -2 -2z" /></svg>',
-                '1': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-gradient"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 3m0 2a2 2 0 0 1 2 -2h14a2 2 0 0 1 2 2v14a2 2 0 0 1 -2 2h-14a2 2 0 0 1 -2 -2z" /><path d="M7 3v18" /><path d="M3 14h4" /><path d="M3 10h4" /><path d="M3 6h4" /><path d="M3 18h4" /></svg>'
-            }
-        };
-    },
-    components: {
-        'acai-vue-tabs': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuetabs.vue?timestamp=' + new Date().getTime()),
-        "acai-vue-selectv2": httpVueLoader("https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivueselect.vue?timestamp=" + new Date().getTime()),
-        "acai-vue-colorpicker": httpVueLoader("https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuecolorpicker.vue?timestamp=" + new Date().getTime()),
-        "acai-vue-upload": httpVueLoader("https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivueupload.vue?timestamp=" + new Date().getTime()),
-        "acai-vue-title": httpVueLoader("https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuetitle.vue?timestamp=" + new Date().getTime()),
-        "acai-vue-linkv2": httpVueLoader("https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuelinkv2.vue?timestamp=" + new Date().getTime()),
-        "acai-vue-textfield": httpVueLoader("https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuetextfield.vue?timestamp=" + new Date().getTime()),
-    },
-    mounted() { this.$emit("child-mounted"); },
-    methods: { saveData() { this.$emit("save-data"); } },
-};
-</script>
-```
-
----
-
-## Ejemplo 2: [Módulo de texto genérico]
-
-```vue
-<template>
-    <acai-vue-tabs v-if="data" :tabs="tabsConfig" :storage-key="'texto-cabecera-tabs-' + (section_id || 'default')" :apply-theme-styles="true">
-
-        <!-- Tab Configuración -->
-        <template #config="{ color }">
-            <div class="w-full mb-6">
-                <p class="text-xl font-semibold text-gray-800">Configuración general del módulo</p>
-            </div>
-
-            <!-- Formato (2 opciones = toggle) -->
-            <div class="w-full items-center mt-6">
-                <div class="w-full flex items-center">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-layout"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 4m0 2a2 2 0 0 1 2 -2h2a2 2 0 0 1 2 2v1a2 2 0 0 1 -2 2h-2a2 2 0 0 1 -2 -2z" /><path d="M4 13m0 2a2 2 0 0 1 2 -2h2a2 2 0 0 1 2 2v3a2 2 0 0 1 -2 2h-2a2 2 0 0 1 -2 -2z" /><path d="M14 4m0 2a2 2 0 0 1 2 -2h2a2 2 0 0 1 2 2v12a2 2 0 0 1 -2 2h-2a2 2 0 0 1 -2 -2z" /></svg>
-                    </div>
-                    <div class="relative">
-                        <acai-vue-selectv2 :builder="builder" :data="data" :field="'formato'" :toggle-icons="iconosFormato" @save-data="saveData"></acai-vue-selectv2>
-                    </div>
-                </div>
-                <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Formato :</b> Vertical (todo en una columna) u Horizontal (cabecera y texto en 2 columnas).</p>
-            </div>
-
-            <!-- Alineación texto -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-align-justified"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 6l16 0" /><path d="M4 12l16 0" /><path d="M4 18l12 0" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Alineación texto :</b> Alineación del contenido.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> Por defecto es izquierda.</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-selectv2 :builder="builder" :data="data" :field="'alineaciontexto'" @save-data="saveData"></acai-vue-selectv2>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Container texto -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-arrow-autofit-width"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 12v-6a2 2 0 0 1 2 -2h12a2 2 0 0 1 2 2v6" /><path d="M10 18h-7" /><path d="M21 18h-7" /><path d="M6 15l-3 3l3 3" /><path d="M18 15l3 3l-3 3" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Container texto :</b> Ancho máximo del contenido.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> Por defecto ocupa el ancho completo.</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-selectv2 :builder="builder" :data="data" :field="'containertexto'" @save-data="saveData"></acai-vue-selectv2>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Estilo enlace -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-click"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 12l3 0" /><path d="M12 3l0 3" /><path d="M7.8 7.8l-2.2 -2.2" /><path d="M16.2 7.8l2.2 -2.2" /><path d="M7.8 16.2l-2.2 2.2" /><path d="M12 12l9 3l-4 2l-2 4l-3 -9" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Estilo enlace :</b> Estilo visual del botón.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> Por defecto usa el color principal (Main color).</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-selectv2 :builder="builder" :data="data" :field="'estiloenlace'" @save-data="saveData"></acai-vue-selectv2>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Radio borde enlace -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 stroke-current icon icon-tabler icons-tabler-outline icon-tabler-border-radius"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 12v-4a4 4 0 0 1 4 -4h4" /><path d="M16 4l0 .01" /><path d="M20 4l0 .01" /><path d="M20 8l0 .01" /><path d="M20 12l0 .01" /><path d="M4 16l0 .01" /><path d="M20 16l0 .01" /><path d="M4 20l0 .01" /><path d="M8 20l0 .01" /><path d="M12 20l0 .01" /><path d="M16 20l0 .01" /><path d="M20 20l0 .01" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Radio borde enlace :</b> Redondeo del botón.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> Por defecto es "sm".</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-selectv2 :builder="builder" :data="data" :field="'radiobordeenlace'" @save-data="saveData"></acai-vue-selectv2>
-                    </div>
-                </div>
-            </div>
-
-        </template>
-
-        <!-- Tab Textos -->
-        <template #textos="{ color }">
-            <div class="w-full mb-6">
-                <p class="text-xl font-semibold text-gray-800">Contenido textual del módulo</p>
-            </div>
-
-            <!-- Pretítulo -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-text-size"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 7v-2h13v2" /><path d="M10 5v14" /><path d="M12 19h-4" /><path d="M15 13v-1h6v1" /><path d="M18 12v7" /><path d="M17 19h2" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Pretítulo :</b> Texto que aparece encima del título principal.</p>
-                    </div>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-textfield :builder="builder" :data="data" :field="'pretitulo'" :placeholder="'Ej: Descubre más'" @save-data="saveData"></acai-vue-textfield>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Título -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 stroke-current icon icon-tabler icons-tabler-outline icon-tabler-heading"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M7 12h10" /><path d="M7 5v14" /><path d="M17 5v14" /><path d="M15 19h4" /><path d="M15 5h4" /><path d="M5 19h4" /><path d="M5 5h4" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Título :</b> Encabezado principal del módulo.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-600 font-light mt-2"><b class="text-black">Recuerda :</b> utiliza las etiquetas <span class="text-black font-semibold">&lt;span&gt; &lt;/span&gt;</span> para resaltar las palabras clave.</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-title :builder="builder" :data="data" :field="'titulo'" placeholder="Título del módulo" @save-data="saveData"></acai-vue-title>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Subtítulo -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-text-size"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 7v-2h13v2" /><path d="M10 5v14" /><path d="M12 19h-4" /><path d="M15 13v-1h6v1" /><path d="M18 12v7" /><path d="M17 19h2" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Subtítulo :</b> Texto que aparece debajo del título principal.</p>
-                    </div>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-textfield :builder="builder" :data="data" :field="'subtitulo'" :placeholder="'Ej: Conoce nuestros servicios'" @save-data="saveData"></acai-vue-textfield>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Texto -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-file-text"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M14 3v4a1 1 0 0 0 1 1h4" /><path d="M17 21h-10a2 2 0 0 1 -2 -2v-14a2 2 0 0 1 2 -2h7l5 5v11a2 2 0 0 1 -2 2" /><path d="M9 9l1 0" /><path d="M9 13l6 0" /><path d="M9 17l6 0" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Texto :</b> Contenido descriptivo principal.</p>
-                    </div>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-wysiwyg :builder="builder" :data="data" :field="'texto'" @save-data="saveData"></acai-vue-wysiwyg>
-                    </div>
-                </div>
-            </div>
-
-        </template>
-
-        <!-- Tab Enlaces -->
-        <template #enlaces="{ color }">
-            <div class="w-full mb-6">
-                <p class="text-xl font-semibold text-gray-800">Enlaces del módulo</p>
-            </div>
-
-            <!-- Enlace -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-link"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 15l6 -6" /><path d="M11 6l.463 -.536a5 5 0 0 1 7.071 7.072l-.534 .464" /><path d="M13 18l-.397 .534a5.068 5.068 0 0 1 -7.127 0a4.972 4.972 0 0 1 0 -7.071l.524 -.463" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Enlace :</b> Botón de acción principal.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> Si no se configura, el botón no se mostrará.</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-linkv2 :builder="builder" :data="data" :field="'enlace'" :show_text="true" @save-data="saveData"></acai-vue-linkv2>
-                    </div>
-                </div>
-            </div>
-
-        </template>
-
-        <!-- Tab Colores -->
-        <template #colores="{ color }">
-            <div class="w-full mb-6">
-                <p class="text-xl font-semibold text-gray-800">Personalización de colores</p>
-            </div>
-
-            <!-- Color de fondo -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-paint"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 3m0 2a2 2 0 0 1 2 -2h10a2 2 0 0 1 2 2v2a2 2 0 0 1 -2 2h-10a2 2 0 0 1 -2 -2z" /><path d="M19 6h1a2 2 0 0 1 2 2a5 5 0 0 1 -5 5l-5 0v2" /><path d="M10 15m0 1a1 1 0 0 1 1 -1h2a1 1 0 0 1 1 1v4a1 1 0 0 1 -1 1h-2a1 1 0 0 1 -1 -1z" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Color de fondo :</b> Color de fondo de toda la sección.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> Por defecto es transparente.</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-colorpicker :builder="builder" :data="data" :field="'colordefondo'" :label="'Color de fondo'" :color="'transparent'" @save-data="saveData"></acai-vue-colorpicker>
-                    </div>
-                    <div style="display: none">
-                        <acai-vue-textfield :builder="builder" :data="data" :field="'colordefondo'" @save-data="saveData"></acai-vue-textfield>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Color del pretítulo -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-palette"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 21a9 9 0 0 1 0 -18c4.97 0 9 3.582 9 8c0 1.06 -.474 2.078 -1.318 2.828c-.844 .75 -1.989 1.172 -3.182 1.172h-2.5a2 2 0 0 0 -1 3.75a1.3 1.3 0 0 1 -1 2.25" /><path d="M7.5 10.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /><path d="M11.5 7.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /><path d="M15.5 10.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Color del pretítulo :</b> Color del texto del pretítulo.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> Por defecto es #111827.</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-colorpicker :builder="builder" :data="data" :field="'colordelpretitulo'" :label="'Color pretítulo'" :color="'#111827'" @save-data="saveData"></acai-vue-colorpicker>
-                    </div>
-                    <div style="display: none">
-                        <acai-vue-textfield :builder="builder" :data="data" :field="'colordelpretitulo'" @save-data="saveData"></acai-vue-textfield>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Color del título -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-palette"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 21a9 9 0 0 1 0 -18c4.97 0 9 3.582 9 8c0 1.06 -.474 2.078 -1.318 2.828c-.844 .75 -1.989 1.172 -3.182 1.172h-2.5a2 2 0 0 0 -1 3.75a1.3 1.3 0 0 1 -1 2.25" /><path d="M7.5 10.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /><path d="M11.5 7.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /><path d="M15.5 10.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Color del título :</b> Color del texto del título principal.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> Por defecto es #111827.</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-colorpicker :builder="builder" :data="data" :field="'colordeltitulo'" :label="'Color título'" :color="'#111827'" @save-data="saveData"></acai-vue-colorpicker>
-                    </div>
-                    <div style="display: none">
-                        <acai-vue-textfield :builder="builder" :data="data" :field="'colordeltitulo'" @save-data="saveData"></acai-vue-textfield>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Color título resaltado -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-color-swatch"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M19 3h-4a2 2 0 0 0 -2 2v12a4 4 0 0 0 8 0v-12a2 2 0 0 0 -2 -2" /><path d="M13 7.35l-2 -2a2 2 0 0 0 -2.828 0l-2.828 2.828a2 2 0 0 0 0 2.828l9 9" /><path d="M7.3 13h-2.3a2 2 0 0 0 -2 2v4a2 2 0 0 0 2 2h12" /><path d="M17 17l0 .01" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Color título resaltado :</b> Color de las palabras resaltadas con &lt;span&gt;.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> Por defecto usa el color principal (Main color).</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-selectv2 :builder="builder" :data="data" :field="'colortituloresaltado'" @save-data="saveData"></acai-vue-selectv2>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Color del subtítulo -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-palette"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 21a9 9 0 0 1 0 -18c4.97 0 9 3.582 9 8c0 1.06 -.474 2.078 -1.318 2.828c-.844 .75 -1.989 1.172 -3.182 1.172h-2.5a2 2 0 0 0 -1 3.75a1.3 1.3 0 0 1 -1 2.25" /><path d="M7.5 10.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /><path d="M11.5 7.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /><path d="M15.5 10.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Color del subtítulo :</b> Color del texto del subtítulo.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> Por defecto es #111827.</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-colorpicker :builder="builder" :data="data" :field="'colordelsubtitulo'" :label="'Color subtítulo'" :color="'#111827'" @save-data="saveData"></acai-vue-colorpicker>
-                    </div>
-                    <div style="display: none">
-                        <acai-vue-textfield :builder="builder" :data="data" :field="'colordelsubtitulo'" @save-data="saveData"></acai-vue-textfield>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Color texto -->
-            <div class="flex w-full items-center mt-6">
-                <div class="w-full">
-                    <div class="flex items-center">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-typography"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 20l3 0" /><path d="M14 20l7 0" /><path d="M6.9 15l6.9 0" /><path d="M10.2 6.3l5.8 13.7" /><path d="M5 20l6 -16l2 0l7 16" /></svg>
-                        <p class="leading-snug text-gray-600"><b class="text-black">Color texto :</b> Color del contenido descriptivo.</p>
-                    </div>
-                    <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> Por defecto es #374151.</p>
-                    <div class="relative mt-2 ml-14">
-                        <acai-vue-colorpicker :builder="builder" :data="data" :field="'colortexto'" :label="'Color texto'" :color="'#374151'" @save-data="saveData"></acai-vue-colorpicker>
-                    </div>
-                    <div style="display: none">
-                        <acai-vue-textfield :builder="builder" :data="data" :field="'colortexto'" @save-data="saveData"></acai-vue-textfield>
-                    </div>
-                </div>
-            </div>
-
-        </template>
-
-    </acai-vue-tabs>
-</template>
-
-<script>
-module.exports = {
-    props: ["active", "section_id"],
-    data() {
-        return {
-            data: null,
-            builder: null,
-            idiomas: IDIOMAS,
-            tabsConfig: [
-                { id: "config", label: "Configuración", color: "#f59e0b", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" fill="none"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M10.325 4.317c.426 -1.756 2.924 -1.756 3.35 0a1.724 1.724 0 0 0 2.573 1.066c1.543 -.94 3.31 .826 2.37 2.37a1.724 1.724 0 0 0 1.065 2.572c1.756 .426 1.756 2.924 0 3.35a1.724 1.724 0 0 0 -1.066 2.573c.94 1.543 -.826 3.31 -2.37 2.37a1.724 1.724 0 0 0 -2.572 1.065c-.426 1.756 -2.924 1.756 -3.35 0a1.724 1.724 0 0 0 -2.573 -1.066c-1.543 .94 -3.31 -.826 -2.37 -2.37a1.724 1.724 0 0 0 -1.065 -2.572c-1.756 -.426 -1.756 -2.924 0 -3.35a1.724 1.724 0 0 0 1.066 -2.573c-.94 -1.543 .826 -3.31 2.37 -2.37c1 .608 2.296 .07 2.572 -1.065z"/><path d="M9 12a3 3 0 1 0 6 0a3 3 0 0 0 -6 0"/></svg>' },
-                { id: "textos", label: "Textos", color: "#3b82f6", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M19 10h-14" /><path d="M5 6h14" /><path d="M14 14h-9" /><path d="M5 18h6" /><path d="M18 15v6" /><path d="M15 18h6" /></svg>' },
-                { id: "enlaces", label: "Enlaces", color: "#ef4444", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 15l6 -6" /><path d="M11 6l.463 -.536a5 5 0 0 1 7.071 7.072l-.534 .464" /><path d="M13 18l-.397 .534a5.068 5.068 0 0 1 -7.127 0a4.972 4.972 0 0 1 0 -7.071l.524 -.463" /></svg>' },
-                { id: "colores", label: "Colores", color: "#8b5cf6", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M19 3h-4a2 2 0 0 0 -2 2v12a4 4 0 0 0 8 0v-12a2 2 0 0 0 -2 -2" /><path d="M13 7.35l-2 -2a2 2 0 0 0 -2.828 0l-2.828 2.828a2 2 0 0 0 0 2.828l9 9" /><path d="M7.3 13h-2.3a2 2 0 0 0 -2 2v4a2 2 0 0 0 2 2h12" /><path d="M17 17l0 .01" /></svg>' }
-            ],
-            iconosFormato: {
-                '': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-layout-rows"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 4m0 2a2 2 0 0 1 2 -2h12a2 2 0 0 1 2 2v12a2 2 0 0 1 -2 2h-12a2 2 0 0 1 -2 -2z" /><path d="M4 12l16 0" /></svg>',
-                '1': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-layout-columns"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 4m0 2a2 2 0 0 1 2 -2h12a2 2 0 0 1 2 2v12a2 2 0 0 1 -2 2h-12a2 2 0 0 1 -2 -2z" /><path d="M12 4l0 16" /></svg>'
-            }
-        };
-    },
-    components: {
-        'acai-vue-tabs': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuetabs.vue?timestamp=' + new Date().getTime()),
-        'acai-vue-selectv2': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivueselect.vue?timestamp=' + new Date().getTime()),
-        'acai-vue-colorpicker': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuecolorpicker.vue?timestamp=' + new Date().getTime()),
-        'acai-vue-linkv2': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuelinkv2.vue?timestamp=' + new Date().getTime()),
-        'acai-vue-title': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuetitle.vue?timestamp=' + new Date().getTime()),
-        'acai-vue-wysiwyg': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuewysiwyg.vue?timestamp=' + new Date().getTime()),
-        'acai-vue-textfield': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuetextfield.vue?timestamp=' + new Date().getTime()),
-    },
-    mounted() { this.$emit("child-mounted"); },
-    methods: { saveData() { this.$emit("save-data"); } },
-};
-</script>
-```

docs/vue-builder-rules.md

@@ -1,484 +0,0 @@
-
-# Reglas CMS-VUE
-
-Aplica estas reglas ÚNICAMENTE cuando el usuario incluya "cms-vue" o "CMS-VUE" (en cualquier combinación de mayúsculas/minúsculas) en su mensaje. Ejemplos válidos: "dame el cms-vue", "cms-vue personalizado", "crea el CMS-VUE", "necesito el cms-vue de este módulo". Si el mensaje NO contiene "cms-vue", ignora completamente estas instrucciones.
-
----
-
-## 1. Estructura general: Tabs (`acai-vue-tabs`)
-
-- Analiza el HTML proporcionado para determinar cuántos tabs son necesarios y cómo nombrarlos.
-- Tabs base comunes: **Configuración**, **Imágenes**, **Textos**, **Bloques** (records), **Enlaces**, **Colores**.
-- Añade tabs adicionales si el módulo lo requiere (ej: "Formulario", "Video", "Overlay", "Slider", etc.).
-- Si un tab solo tendría 1 campo, evalúa fusionarlo con otro tab relacionado.
-- Cada tab tiene su propio `id`, `label`, `color` e `icon` (SVG inline).
-- SVG dentro del template usan `:style="{ color: color }"` para heredar el color del tab.
-- Textos descriptivos claros y orientados al usuario final del CMS.
-- Usa `storage-key` único: `'nombre-modulo-tabs-' + (section_id || 'default')`.
-- Siempre añade `:apply-theme-styles="true"`.
-- **IMPORTANTE:** La prop para pasar los tabs es `:tabs` (NO `:tabs-config`).
-- **IMPORTANTE:** Siempre añadir `v-if="data"` en el `<acai-vue-tabs>` para evitar renderizar antes de que los datos estén listos.
-
-### Template de cada tab:
-```html
-<template #idtab="{ color }">
-    <div class="w-full mb-6">
-        <p class="text-xl font-semibold text-gray-800">Título descriptivo del tab</p>
-    </div>
-    <!-- campos -->
-</template>
-```
-
----
-
-## 2. Colorpicker según contexto
-
-### 2.1 En tab "Colores" (campos generales de color de texto/fondo)
-Siempre con SVG + título + descripción + colorpicker + textfield oculto:
-```html
-<div class="flex w-full items-center mt-6">
-    <div class="w-full">
-        <div class="flex items-center">
-            <svg class="w-10 h-10 flex-shrink-0 mr-4 stroke-current" :style="{ color: color }" ...>...</svg>
-            <p class="leading-snug text-gray-600"><b class="text-black">Nombre :</b> Descripción.</p>
-        </div>
-        <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> valor por defecto.</p>
-        <div class="relative mt-2 ml-14">
-            <acai-vue-colorpicker :builder="builder" :data="data" :field="'campo'" :label="'Etiqueta'" :color="'#hex'" @save-data="saveData"></acai-vue-colorpicker>
-        </div>
-        <div style="display: none">
-            <acai-vue-textfield :builder="builder" :data="data" :field="'campo'" @save-data="saveData"></acai-vue-textfield>
-        </div>
-    </div>
-</div>
-```
-
-### 2.2 Colorpicker en otros tabs (ej: color del overlay en tab Imágenes)
-Misma estructura con SVG + título + descripción + colorpicker + textfield oculto, pero usando el `color` del tab donde se encuentre. Se coloca junto a los campos relacionados (ver regla 10.2).
-
-### 2.3 Dentro de `<acai-vue-records>` (sin icono ni descripción)
-Se coloca debajo del campo al que corresponde:
-- Nota con `mt-4` si campo anterior es `textfield` o `title`.
-- Nota con `mt-3` si campo anterior es `textbox` o `wysiwyg`.
-- Colorpicker siempre con `mt-1`.
-```html
-<p class="text-xs leading-snug text-gray-500 mt-4 ml-14"><b class="text-gray-700">Nota :</b> color por defecto (#hex).</p>
-<div class="relative mt-1 ml-14">
-    <acai-vue-colorpicker :builder="builder.vars.records" :data="record" :field="'campo'" :label="'Etiqueta'" :color="'#hex'" @save-data="saveData"></acai-vue-colorpicker>
-</div>
-<div style="display: none">
-    <acai-vue-textfield :builder="builder.vars.records" :data="record" :field="'campo'" @save-data="saveData"></acai-vue-textfield>
-</div>
-```
-
-### 2.4 Campos tipo `list` para colores
-Se usan como `<acai-vue-selectv2>` con icono y nota. El componente detecta automáticamente si las opciones son colores y muestra el modo color selector con swatches. No llevan colorpicker ni textfield oculto.
-
-### 2.5 Extraer color por defecto
-Del HTML: `style="color: {{ campo ? campo : '#HEX' }}"` → usar `#HEX`. Si no hay color, usar `#111827` (textos) o `transparent` (fondos).
-
----
-
-## 3. Campos: estructura en tabs
-
-### Fuera de records:
-```html
-<div class="flex w-full items-center mt-6">
-    <div class="w-full">
-        <div class="flex items-center">
-            <svg class="w-10 h-10 flex-shrink-0 mr-4 stroke-current" :style="{ color: color }" ...>...</svg>
-            <p class="leading-snug text-gray-600"><b class="text-black">Nombre :</b> Descripción.</p>
-        </div>
-        <p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> info adicional.</p>
-        <div class="relative mt-2 ml-14">
-            <!-- componente -->
-        </div>
-    </div>
-</div>
-```
-
-### Dentro de records:
-```html
-<div class="w-full mt-6">
-    <div class="flex items-center">
-        <svg class="w-10 h-10 flex-shrink-0 mr-4 stroke-current" :style="{ color: color }" ...>...</svg>
-        <p class="leading-snug text-gray-600"><b class="text-black">Nombre :</b> Descripción.</p>
-    </div>
-    <div class="relative mt-2 ml-14">
-        <!-- componente con builder.vars.records y record -->
-    </div>
-</div>
-```
-
----
-
-## 4. Nombres de campos (`:field`)
-
-- Construir uniendo palabras del `data-field-label` en minúsculas sin espacios.
-- Eliminar acentos: á→a, é→e, í→i, ó→o, ú→u, ñ→(eliminar).
-- Ejemplos: `Color del título` → `colordeltitulo`, `Valoración` → `valoracion`, `Tamaño` → `tamao`.
-
----
-
-## 5. Upload de imágenes
-
-### General:
-```html
-<acai-vue-upload ref="upload_campo" :reference="'upload_campo'" :tablename="'builder_custom'" :fieldname="builder.vars.campo.relations.builder_custom" :recordnum="data.campo.recordNum" :field="data.campo" :builder_field="builder.vars.campo" :presavetempid="data.campo.preSaveTempId" :add_button="true" @add_button_click="$parent.openCute('campo',data,false,'upload_campo')" class="border-2 px-3 py-2 border-gray-600 rounded-lg shadow bg-gray-200"></acai-vue-upload>
-```
-
-### En records:
-```html
-<acai-vue-upload :ref="'upload_campo_' + builder.vars.records.vars.campo.relations.builder_custom + '_' + record.campo.recordNum" :reference="'upload_campo_' + builder.vars.records.vars.campo.relations.builder_custom + '_' + record.campo.recordNum" :tablename="'builder_custom'" :fieldname="builder.vars.records.vars.campo.relations.builder_custom" :recordnum="record.campo.recordNum" :field="record.campo" :builder_field="builder.vars.records.vars.campo" :presavetempid="record.campo.preSaveTempId" :add_button="true" @add_button_click="$parent.openCute('campo',record,true,'upload_campo_' + builder.vars.records.vars.campo.relations.builder_custom + '_' + record.campo.recordNum)" class="border-2 px-3 py-2 border-gray-600 rounded-lg shadow bg-gray-200"></acai-vue-upload>
-```
-
----
-
-## 6. Componentes y URLs
-
-Solo incluir los que se usen. Los componentes personalizados (tabs, selectv2) se cargan desde impulse; los estándar desde cocosolution:
-
-```javascript
-// ── Componentes personalizados (impulse) ──
-'acai-vue-tabs': httpVueLoader('https://impulse.webserver2.plandeweb.com/template/estandar/css/builder-acaivuetabsv2.vue?timestamp=' + new Date().getTime()),
-'acai-vue-selectv2': httpVueLoader('https://impulse.webserver2.plandeweb.com/template/estandar/css/builder-acaivueselect-v2.vue?timestamp=' + new Date().getTime()),
-
-// ── Componentes estándar (cocosolution) ──
-'acai-vue-colorpicker': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuecolorpicker.vue?timestamp=' + new Date().getTime()),
-'acai-vue-upload': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivueupload.vue?timestamp=' + new Date().getTime()),
-'acai-vue-records': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuerecords.vue?timestamp=' + new Date().getTime()),
-'acai-vue-title': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuetitle.vue?timestamp=' + new Date().getTime()),
-'acai-vue-wysiwyg': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuewysiwyg.vue?timestamp=' + new Date().getTime()),
-'acai-vue-linkv2': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuelinkv2.vue?timestamp=' + new Date().getTime()),
-'acai-vue-textbox': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuetextbox.vue?timestamp=' + new Date().getTime()),
-'acai-vue-textfield': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuetextfield.vue?timestamp=' + new Date().getTime()),
-'acai-vue-datepicker': httpVueLoader('https://cms.cocosolution.com/lib/plugins/builder_saas/tpl/componentes/builder-acaivuedatepicker.vue?timestamp=' + new Date().getTime()),
-```
-
-**IMPORTANTE:** `acai-vue-list` ha sido reemplazado por `acai-vue-selectv2` en todos los VUEs. NO usar `acai-vue-list` en nuevos VUEs.
-
----
-
-## 7. Mapeo HTML → Vue
-
-| `data-field-type` | Componente |
-|---|---|
-| `textfield` | `acai-vue-textfield` |
-| `headfield` | `acai-vue-title` |
-| `wysiwyg` | `acai-vue-wysiwyg` |
-| `textbox` | `acai-vue-textbox` |
-| `list` | `acai-vue-selectv2` |
-| `upload` / `uploadMulti` | `acai-vue-upload` |
-| `linkv2` | `acai-vue-linkv2` (siempre con `:show_text="true"`) |
-| `multiv2` | `acai-vue-records` |
-| `textfield` (usado como fecha) | `acai-vue-datepicker` + `acai-vue-textfield` oculto |
-
----
-
-## 8. Script base
-
-```javascript
-module.exports = {
-    props: ["active", "section_id"],
-    data() {
-        return {
-            data: null,
-            builder: null,
-            idiomas: IDIOMAS,
-            tabsConfig: [ /* tabs */ ],
-            // iconos para toggles (solo si hay campos de 2 opciones con iconos)
-            // iconosNombreCampo: { '': '<svg>...</svg>', '1': '<svg>...</svg>' }
-        };
-    },
-    components: { /* solo los usados */ },
-    mounted() { this.$emit("child-mounted"); },
-    methods: { saveData() { this.$emit("save-data"); } },
-};
-```
-
----
-
-## 9. Decisión de tabs según contenido HTML y contexto semántico
-
-### 9.1 Organización contextual (PRIORITARIA)
-
-**IMPORTANTE:** Primero analizar el **nombre del campo** para determinar su contexto semántico, independientemente del tipo. Un campo `list` llamado "tipo de imagen" debe ir en el tab **Imágenes**, no en Configuración.
-
-#### Keywords para tab Imágenes:
-Campos que contengan: `imagen`, `photo`, `video`, `fondo`, `background`, `logo`, `icono`, `icon`
-
-**Ejemplos:**
-- ✅ "tipo de imagen" (list) → **Imágenes**
-- ✅ "video de fondo" (list) → **Imágenes**
-- ✅ "logo principal" (upload) → **Imágenes**
-
-#### Keywords para tab Enlaces:
-Campos que contengan: `enlace`, `link`, `boton`, `button`, `url`, `href`
-
-**Ejemplos:**
-- ✅ "texto del botón" (textfield) → **Enlaces**
-- ✅ "url externa" (textfield) → **Enlaces**
-- ✅ "estilo del enlace" (list) → **Enlaces**
-
-#### Keywords para tab Textos:
-Campos que contengan: `titulo`, `title`, `texto`, `text`, `descripcion`, `description`, `contenido`, `content`, `label`, `etiqueta`
-
-**Ejemplos:**
-- ✅ "título principal" (headfield) → **Textos**
-- ✅ "descripción corta" (textfield) → **Textos**
-
-### 9.2 Organización por tipo (fallback)
-
-Si el nombre del campo **no** coincide con ninguna keyword, usar el tipo:
-
-| Tipo | Tab |
-|---|---|
-| `headfield`, `textfield`, `textbox`, `wysiwyg` | Textos |
-| `upload`, `image` | Imágenes |
-| `linkv2` | Enlaces |
-| `list`, `select` (sin contexto) | Configuración |
-| `multiv2` (records) | Bloques |
-| Otros campos de configuración | Configuración |
-
----
-
-## 10. Reglas especiales
-
-### 10.1 Selector imagen/video con v-show
-Cuando el HTML tenga un campo `list` con opciones tipo `"|Imagen,1|Video"`:
-- El selector "Tipo de fondo" va en el tab **Imágenes** como **primer campo** (encima de los uploads).
-- Se renderiza como toggle con iconos (foto/vídeo) usando `acai-vue-selectv2` con `:toggle-icons`.
-- Usa el icono `icon-tabler-photo-video`:
-```html
-<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="#ffffff" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 stroke-current icon icon-tabler icons-tabler-outline icon-tabler-photo-video"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 15h-3a3 3 0 0 1 -3 -3v-6a3 3 0 0 1 3 -3h6a3 3 0 0 1 3 3v3" /><path d="M9 12a3 3 0 0 1 3 -3h6a3 3 0 0 1 3 3v6a3 3 0 0 1 -3 3h-6a3 3 0 0 1 -3 -3l0 -6" /><path d="M3 12l2.296 -2.296a2.41 2.41 0 0 1 3.408 0l.296 .296" /><path d="M14 13.5v3l2.5 -1.5l-2.5 -1.5" /><path d="M7 6v.01" /></svg>
-```
-- El upload de **imágenes** lleva: `v-show="data.tipodeimagen && data.tipodeimagen.newValues.builder_custom.value == ''"` (visible cuando es imagen o vacío).
-- El upload de **video** lleva: `v-show="data.tipodeimagen && data.tipodeimagen.newValues.builder_custom.value == '1'"` (visible cuando es video).
-- **NUNCA quitar estos `v-show`**, son esenciales para mostrar uno u otro según la selección.
-- Iconos del toggle:
-```javascript
-iconosTipoImagen: {
-    '': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-photo"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M15 8h.01" /><path d="M3 6a3 3 0 0 1 3 -3h12a3 3 0 0 1 3 3v12a3 3 0 0 1 -3 3h-12a3 3 0 0 1 -3 -3v-12z" /><path d="M3 16l5 -5c.928 -.893 2.072 -.893 3 0l5 5" /><path d="M14 14l1 -1c.928 -.893 2.072 -.893 3 0l3 3" /></svg>',
-    '1': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-video"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M15 10l4.553 -2.276a1 1 0 0 1 1.447 .894v6.764a1 1 0 0 1 -1.447 .894l-4.553 -2.276v-4z" /><path d="M3 6m0 2a2 2 0 0 1 2 -2h8a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-8a2 2 0 0 1 -2 -2z" /></svg>'
-}
-```
-
-### 10.2 Grupo overlay (tipo + color + opacidad)
-Cuando el HTML contenga campos de overlay (tipo de overlay, color del overlay, opacidad del overlay):
-- Los tres campos van **juntos** en el tab **Imágenes**, **debajo** de la imagen/video sobre la que se aplica el overlay.
-- El orden es: tipo de overlay → color del overlay (colorpicker) → opacidad del overlay.
-- El **color del overlay NO va en el tab Colores**, va en Imágenes junto al resto del grupo overlay.
-- El tipo de overlay (2 opciones: Sin degradado / Con degradado) se renderiza como toggle con iconos:
-```javascript
-iconosOverlay: {
-    '': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-square"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 3m0 2a2 2 0 0 1 2 -2h14a2 2 0 0 1 2 2v14a2 2 0 0 1 -2 2h-14a2 2 0 0 1 -2 -2z" /></svg>',
-    '1': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-gradient"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 3m0 2a2 2 0 0 1 2 -2h14a2 2 0 0 1 2 2v14a2 2 0 0 1 -2 2h-14a2 2 0 0 1 -2 -2z" /><path d="M7 3v18" /><path d="M3 14h4" /><path d="M3 10h4" /><path d="M3 6h4" /><path d="M3 18h4" /></svg>'
-}
-```
-
-### 10.3 Campos que afectan al enlace
-Los campos `list` que modifican propiedades del botón de enlace (radio borde, estilo, etc.) van en el tab **Enlaces**, debajo del campo `linkv2` al que afectan. NO van en Configuración ni en Imágenes.
-
-### 10.4 Tabs base: definición fija de id, label, color e icono
-Los tabs base siempre usan la siguiente definición fija. Este es el orden por defecto; solo se incluyen los tabs que el módulo necesite. Tabs adicionales (ej: "Formulario", "Video") se crean con id, label, color e icono nuevos.
-
-```javascript
-{ id: "configuracion", label: "Configuración", color: "#f59e0b", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" fill="none"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M10.325 4.317c.426 -1.756 2.924 -1.756 3.35 0a1.724 1.724 0 0 0 2.573 1.066c1.543 -.94 3.31 .826 2.37 2.37a1.724 1.724 0 0 0 1.065 2.572c1.756 .426 1.756 2.924 0 3.35a1.724 1.724 0 0 0 -1.066 2.573c.94 1.543 -.826 3.31 -2.37 2.37a1.724 1.724 0 0 0 -2.572 1.065c-.426 1.756 -2.924 1.756 -3.35 0a1.724 1.724 0 0 0 -2.573 -1.066c-1.543 .94 -3.31 -.826 -2.37 -2.37a1.724 1.724 0 0 0 -1.065 -2.572c-1.756 -.426 -1.756 -2.924 0 -3.35a1.724 1.724 0 0 0 1.066 -2.573c-.94 -1.543 .826 -3.31 2.37 -2.37c1 .608 2.296 .07 2.572 -1.065z"/><path d="M9 12a3 3 0 1 0 6 0a3 3 0 0 0 -6 0"/></svg>' },
-
-{ id: "imagenes", label: "Imágenes", color: "#10b981", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M15 8h.01" /><path d="M11 20h-4a3 3 0 0 1 -3 -3v-10a3 3 0 0 1 3 -3h10a3 3 0 0 1 3 3v4" /><path d="M4 15l4 -4c.928 -.893 2.072 -.893 3 0l3 3" /><path d="M14 14l1 -1c.31 -.298 .644 -.497 .987 -.596" /><path d="M18.42 15.61a2.1 2.1 0 0 1 2.97 2.97l-3.39 3.42h-3v-3l3.42 -3.39" /></svg>' },
-
-{ id: "textos", label: "Textos", color: "#3b82f6", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M19 10h-14" /><path d="M5 6h14" /><path d="M14 14h-9" /><path d="M5 18h6" /><path d="M18 15v6" /><path d="M15 18h6" /></svg>' },
-
-{ id: "bloques", label: "Bloques", color: "#ec4899", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 4l-8 4l8 4l8 -4l-8 -4" /><path d="M4 12l8 4l8 -4" /><path d="M4 16l8 4l8 -4" /></svg>' },
-
-{ id: "enlaces", label: "Enlaces", color: "#ef4444", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 15l6 -6"/><path d="M11 6l.463 -.536a5 5 0 0 1 7.071 7.072l-.534 .464"/><path d="M13 18l-.397 .534a5.068 5.068 0 0 1 -7.127 0a4.972 4.972 0 0 1 0 -7.071l.524 -.463"/></svg>' },
-
-{ id: "colores", label: "Colores", color: "#8b5cf6", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M19 3h-4a2 2 0 0 0 -2 2v12a4 4 0 0 0 8 0v-12a2 2 0 0 0 -2 -2" /><path d="M13 7.35l-2 -2a2 2 0 0 0 -2.828 0l-2.828 2.828a2 2 0 0 0 0 2.828l9 9" /><path d="M7.3 13h-2.3a2 2 0 0 0 -2 2v4a2 2 0 0 0 2 2h12" /><path d="M17 17l0 .01" /></svg>' },
-```
-
-### 10.5 Campos globales que afectan al multi van DENTRO del tab Bloques
-Los campos `list` o `textfield` generales (no de records) que afectan visualmente a los elementos del multi (ej: radio de borde de los bloques, alineación del texto de los bloques, diseño del enlace de los bloques) deben colocarse **dentro del tab Bloques**, en la zona **superior**, ANTES del bloque descriptivo "Bloques del multi" y del `<acai-vue-records>`. Estos campos NO van en Configuración ni en otros tabs, ya que pertenecen conceptualmente a los bloques.
-
-### 10.6 Bloque descriptivo "Bloques del multi" antes de acai-vue-records
-Siempre añadir un bloque descriptivo con el icono `icon-tabler-stack-2` y el texto "Bloques del multi : Personaliza los bloques del multi." justo antes de `<acai-vue-records>`:
-```html
-<!-- Multi -->
-<div class="flex w-full items-center mt-6">
-    <div class="w-full">
-        <div class="flex items-center">
-            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" :style="{ color: color }" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-stack-2"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 4l-8 4l8 4l8 -4l-8 -4" /><path d="M4 12l8 4l8 -4" /><path d="M4 16l8 4l8 -4" /></svg>
-            <p class="leading-snug text-gray-600"><b class="text-black">Bloques del multi :</b> Personaliza los bloques del multi.</p>
-        </div>
-    </div>
-</div>
-```
-
-### 10.7 Slot de acai-vue-records: NO desestructurar `color`
-El slot de `<acai-vue-records>` NUNCA debe desestructurar `color`. Siempre usar:
-```html
-<template v-slot="{ record, index }">
-```
-**NUNCA** usar:
-```html
-<template v-slot="{ record, color, index }">
-```
-De esta forma, `color` dentro del multi resuelve al `color` del tab padre (`<template #bloques="{ color }">`), y los iconos SVG con `:style="{ color: color }"` siempre mostrarán el color correcto del tab.
-
-### 10.8 Estructura del componente acai-vue-records
-El componente `<acai-vue-records>` siempre debe incluir todas estas props y atributos:
-```html
-<acai-vue-records :data="data" :builder="builder" :active="active" :section_id="section_id" :root_builder_vue="$parent" ref="recordsNode">
-    <template v-slot="{ record, index }">
-        <!-- campos del record -->
-    </template>
-</acai-vue-records>
-```
-**NUNCA** usar una versión simplificada sin `:active`, `:section_id`, `:root_builder_vue` o `ref`.
-
-### 10.9 Orden del campo "Color título resaltado" en tab Colores
-Cuando el módulo tenga un campo de **Color título resaltado** (tipo `list` con opciones Main color / Main color light / Main color dark), este campo debe colocarse **inmediatamente debajo** del campo **Color del título** en el tab **Colores**. Nunca en el tab Textos ni en otra posición del tab Colores.
-
----
-
-## 11. Consistencia de iconos y textos descriptivos entre VUEs
-
-### 11.1 Iconos
-Los campos que ya tienen un icono SVG asignado en VUEs anteriores deben usar SIEMPRE ese mismo icono en todos los VUEs futuros. Solo se crean o personalizan iconos nuevos para campos que no se hayan visto antes en ningún VUE previo.
-
-### 11.2 Textos descriptivos
-Los textos descriptivos (título en negrita + descripción + nota) de campos recurrentes (pretítulo, título, subtítulo, texto largo, enlace, color de fondo, color del texto, etc.) deben ser idénticos en todos los VUEs. Solo se modifican si el HTML del módulo revela un comportamiento diferente para ese campo concreto.
-
-### 11.3 Registro de referencia
-Usar como referencia los iconos y textos del primer VUE en que apareció cada tipo de campo. Ante cualquier duda, mantener consistencia con lo ya establecido.
-
----
-
-## 12. Componente acai-vue-selectv2 (reemplazo de acai-vue-list)
-
-### 12.1 Descripción general
-`acai-vue-selectv2` reemplaza completamente a `acai-vue-list`. Es un componente inteligente que detecta automáticamente cómo renderizar según el número y tipo de opciones:
-- **2 opciones** → modo **toggle** (pill deslizante con animación)
-- **2+ opciones con nombres de color** → modo **color selector** (dropdown con swatches)
-- **3+ opciones normales** → modo **select** (dropdown estándar con vue-select)
-
-### 12.2 Props
-```html
-<acai-vue-selectv2
-    :builder="builder"
-    :data="data"
-    :field="'nombrecampo'"
-    :toggle-icons="iconosObjeto"  <!-- opcional, solo para toggles con iconos -->
-    @save-data="saveData">
-</acai-vue-selectv2>
-```
-
-### 12.3 Toggle con iconos (`:toggle-icons`)
-Para campos de 2 opciones donde se quieran iconos visuales en el toggle, se pasa un objeto con las claves correspondientes a los valores de las opciones:
-```javascript
-iconosNombreCampo: {
-    '': '<svg>...</svg>',   // icono para la primera opción (valor vacío)
-    '1': '<svg>...</svg>'   // icono para la segunda opción
-}
-```
-
-Iconos de toggle establecidos:
-- **Lado texto (2 opciones: Izquierda/Derecha):** `icon-tabler-align-box-left-middle` / `icon-tabler-align-box-right-middle`
-- **Ver sombra (No/Si):** `icon-tabler-x` / `icon-tabler-check`
-- **Tipo imagen (Imagen/Video):** `icon-tabler-photo` / `icon-tabler-video`
-- **Tipo overlay (Sin degradado/Con degradado):** `icon-tabler-square` / `icon-tabler-gradient`
-
-### 12.4 Modo color automático
-El componente detecta automáticamente si las opciones son colores cuando al menos la mitad de las labels coinciden con:
-- Nombres del mapa interno: main color, blanco, negro, gris, gris claro, gris oscuro, gris calido, rojo, azul, verde, etc. (español e inglés)
-- Códigos hex (#fff, #ff0000)
-- Valores rgb/rgba
-- Valores hsl/hsla
-
-Los colores main color, main color light y main color dark se resuelven consultando la configuración del CMS en tiempo real.
-
-### 12.5 Campos de 3+ opciones sin iconos
-No necesitan `:toggle-icons`. Se renderizan como dropdown estándar:
-```html
-<acai-vue-selectv2 :builder="builder" :data="data" :field="'container'" @save-data="saveData"></acai-vue-selectv2>
-```
-
----
-
-## 13. Componente acai-vue-datepicker (campos de fecha)
-
-### 13.1 Uso
-Cuando un campo `textfield` en el HTML se usa para fechas (se identifica por el label "Fecha" o similar), se usa `acai-vue-datepicker` junto con un `acai-vue-textfield` oculto:
-```html
-<div class="relative mt-2">
-    <acai-vue-datepicker :builder="builder" :data="data" :field="'fecha'" :label="'Fecha'" @save-data="saveData"></acai-vue-datepicker>
-</div>
-<div style="display: none">
-    <acai-vue-textfield :builder="builder" :data="data" :field="'fecha'" @save-data="saveData"></acai-vue-textfield>
-</div>
-```
-
-### 13.2 Notas estándar para datepicker
-```html
-<p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> puedes elegir el formato de la fecha en el selector.</p>
-<p class="text-xs leading-snug text-gray-500 mt-1 ml-14"><b class="text-gray-700">Recuerda :</b> también puedes mostrar la hora activando el botón del reloj.</p>
-```
-
-### 13.3 Icono estándar para fecha
-```html
-<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" :style="{ color: color }" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="w-10 h-10 flex-shrink-0 mr-4 icon icon-tabler icons-tabler-outline icon-tabler-calendar-week"><path stroke="none" d="M0 0h24v24H0z" fill="none" /><path d="M4 7a2 2 0 0 1 2 -2h12a2 2 0 0 1 2 2v12a2 2 0 0 1 -2 2h-12a2 2 0 0 1 -2 -2v-12" /><path d="M16 3v4" /><path d="M8 3v4" /><path d="M4 11h16" /><path d="M7 14h.013" /><path d="M10.01 14h.005" /><path d="M13.01 14h.005" /><path d="M16.015 14h.005" /><path d="M13.015 17h.005" /><path d="M7.01 17h.005" /><path d="M10.01 17h.005" /></svg>
-```
-
----
-
-## 14. Reglas de spacing (separación entre elementos)
-
-### 14.1 Separación entre nota/recuerda y componente
-- El componente siempre lleva `mt-2` respecto a la nota o recuerda que lo precede.
-- Nunca `mt-1` entre nota/recuerda y componente.
-
-### 14.2 Nota y Recuerda juntos
-Cuando un campo tiene **Nota** y **Recuerda**:
-- **Nota** siempre lleva `mt-2` respecto al bloque de icono+texto anterior.
-- **Recuerda** lleva `mt-1` respecto a la Nota (va justo debajo).
-- El componente lleva `mt-2` respecto al Recuerda.
-
-Ejemplo:
-```html
-<p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> texto de la nota.</p>
-<p class="text-xs leading-snug text-gray-500 mt-1 ml-14"><b class="text-gray-700">Recuerda :</b> texto del recuerda.</p>
-<div class="relative mt-2 ml-14">
-    <!-- componente -->
-</div>
-```
-
-### 14.3 Solo Nota (sin Recuerda)
-```html
-<p class="text-xs leading-snug text-gray-500 mt-2 ml-14"><b class="text-gray-700">Nota :</b> texto.</p>
-<div class="relative mt-2 ml-14">
-    <!-- componente -->
-</div>
-```
-
-### 14.4 Solo Recuerda (sin Nota)
-El Recuerda usa el estilo especial (sin ml-14, con font-light):
-```html
-<p class="text-xs leading-snug text-gray-600 font-light mt-2"><b class="text-black">Recuerda :</b> texto del recuerda.</p>
-<div class="relative mt-2 ml-14">
-    <!-- componente -->
-</div>
-```
-
-### 14.5 Sin Nota ni Recuerda
-El componente lleva `mt-2` directamente:
-```html
-<div class="relative mt-2 ml-14">
-    <!-- componente -->
-</div>
-```
-
-### 14.6 Separación entre campos
-Siempre `mt-6` entre bloques de campo:
-```html
-<div class="flex w-full items-center mt-6">
-```
-El primer campo de cada tab NO lleva `mt-6` (no hay campo previo).

mcp-server/auth/credentials.js

@@ -11,7 +11,19 @@
  * (the SimpleAuth header that Claude sends with each request).
  */
 
+import fs from "node:fs";
+import path from "node:path";
+import { fetchProjectInfo } from "./localClient.js";
+
 const DEFAULT_ROLE = 'developer';
+const FORGE_INTERNAL_URL = process.env.ACAI_FORGE_WEB_URL || "http://web:80";
+
+const resolveEffectiveRole = (baseRole) => {
+    if (process.env.ACAI_ROLE_OVERRIDE) return process.env.ACAI_ROLE_OVERRIDE;
+    if (process.env.ACAI_MODE_OVERRIDE === "production") return "editor";
+    if (process.env.ACAI_MODE === "production") return "editor";
+    return baseRole || DEFAULT_ROLE;
+};
 
 
 // Session-based credentials storage (ephemeral, per-session)
@@ -46,6 +58,104 @@ const cleanupExpiredMcpSessions = () => {
 // Run cleanup every 5 minutes
 setInterval(cleanupExpiredMcpSessions, 5 * 60 * 1000);
 
+const buildApiUrlFromPublicUrl = (webUrl, explicitForgeHost = "") => {
+    if (!webUrl) return null;
+    if (explicitForgeHost) return FORGE_INTERNAL_URL;
+    try {
+        const parsed = new URL(webUrl);
+        if (parsed.hostname.includes(".forge.")) {
+            return FORGE_INTERNAL_URL;
+        }
+    } catch {
+        return null;
+    }
+    return webUrl;
+};
+
+const readProjectAcaiFallback = () => {
+    const projectDir = process.env.ACAI_PROJECT_DIR || "";
+    if (!projectDir) return null;
+
+    const acaiFilePath = path.join(projectDir, ".acai");
+    if (!fs.existsSync(acaiFilePath)) return null;
+
+    try {
+        const data = JSON.parse(fs.readFileSync(acaiFilePath, "utf-8"));
+        const website = data.domain || process.env.ACAI_WEBSITE || null;
+        let webUrl = data.local_web_url || process.env.ACAI_WEB_URL || (website ? `https://${website}` : null);
+        let forgeHost = data.local_forge_host || process.env.ACAI_FORGE_HOST || null;
+        // Respeta local_api_web_url del .acai si esta presente (override del usuario);
+        // si no, fallback al calculo automatico (web:80 para forge, web_url para Docker).
+        let apiWebUrl = data.local_api_web_url || process.env.ACAI_API_WEB_URL || buildApiUrlFromPublicUrl(webUrl, forgeHost);
+        let mode = data.mode || process.env.ACAI_MODE || "local";
+
+        // Override de entorno (inyectado por cronjobs via mcp_env)
+        if (process.env.ACAI_MODE_OVERRIDE) {
+            mode = process.env.ACAI_MODE_OVERRIDE;
+            if (process.env.ACAI_WEB_URL_OVERRIDE) webUrl = process.env.ACAI_WEB_URL_OVERRIDE;
+            if (process.env.ACAI_API_WEB_URL_OVERRIDE) apiWebUrl = process.env.ACAI_API_WEB_URL_OVERRIDE;
+            if (process.env.ACAI_FORGE_HOST_OVERRIDE !== undefined) forgeHost = process.env.ACAI_FORGE_HOST_OVERRIDE;
+        }
+
+        return {
+            token: data.token || process.env.ACAI_TOKEN || null,
+            website,
+            web_url: webUrl,
+            api_web_url: apiWebUrl,
+            forge_host: forgeHost,
+            tokenHash: data.tokenHash || process.env.ACAI_TOKEN_HASH || null,
+            mode,
+            project_dir: projectDir || null,
+            profileName: "acai-file",
+            role: resolveEffectiveRole(data.role),
+        };
+    } catch (error) {
+        console.error(`[Credentials] Failed to read .acai fallback: ${error.message}`);
+        return null;
+    }
+};
+
+const resolveLocalProjectFallback = async () => {
+    const projectDir = process.env.ACAI_PROJECT_DIR || "";
+
+    if (projectDir) {
+        try {
+            const info = await fetchProjectInfo({ project_dir: projectDir });
+            if (info?.success) {
+                let webUrl = info.web_url || process.env.ACAI_WEB_URL || null;
+                let apiWebUrl = info.api_web_url || buildApiUrlFromPublicUrl(info.web_url, info.forge_host) || null;
+                let forgeHost = info.forge_host || process.env.ACAI_FORGE_HOST || null;
+                let mode = info.mode || process.env.ACAI_MODE || "local";
+
+                // Override de entorno (inyectado por cronjobs via mcp_env)
+                if (process.env.ACAI_MODE_OVERRIDE) {
+                    mode = process.env.ACAI_MODE_OVERRIDE;
+                    if (process.env.ACAI_WEB_URL_OVERRIDE) webUrl = process.env.ACAI_WEB_URL_OVERRIDE;
+                    if (process.env.ACAI_API_WEB_URL_OVERRIDE) apiWebUrl = process.env.ACAI_API_WEB_URL_OVERRIDE;
+                    if (process.env.ACAI_FORGE_HOST_OVERRIDE !== undefined) forgeHost = process.env.ACAI_FORGE_HOST_OVERRIDE;
+                }
+
+                return {
+                    token: info.token || process.env.ACAI_TOKEN || null,
+                    website: info.domain || process.env.ACAI_WEBSITE || null,
+                    web_url: webUrl,
+                    api_web_url: apiWebUrl,
+                    forge_host: forgeHost,
+                    tokenHash: info.tokenHash || process.env.ACAI_TOKEN_HASH || null,
+                    mode,
+                    project_dir: info.project_dir || projectDir || null,
+                    profileName: "project-info",
+                    role: resolveEffectiveRole(info.role),
+                };
+            }
+        } catch (error) {
+            console.error(`[Credentials] project-info fallback failed: ${error.message}`);
+        }
+    }
+
+    return readProjectAcaiFallback();
+};
+
 /**
  * Get credentials by MCP-Session-Id
  */
@@ -132,9 +242,37 @@ export const getSessionCredentials = async (sessionId, inlineCredentials = null)
     // Priority 2: Session credentials
     const sessionCreds = sessionCredentials.get(sessionId);
     if (sessionCreds) {
+        if (sessionCreds.token && sessionCreds.web_url && sessionCreds.api_web_url) {
             console.error(`[Credentials] getSessionCredentials(${sessionId}) - FOUND: website=${sessionCreds.website}, hasToken=${!!sessionCreds.token}`);
             return sessionCreds;
         }
+        const hydrated = await resolveLocalProjectFallback();
+        if (hydrated) {
+            const merged = {
+                ...sessionCreds,
+                token: sessionCreds.token || hydrated.token,
+                website: sessionCreds.website || hydrated.website,
+                web_url: sessionCreds.web_url || hydrated.web_url,
+                api_web_url: sessionCreds.api_web_url || hydrated.api_web_url,
+                forge_host: sessionCreds.forge_host || hydrated.forge_host,
+                tokenHash: sessionCreds.tokenHash || hydrated.tokenHash,
+                profileName: sessionCreds.profileName || hydrated.profileName,
+                role: sessionCreds.role || hydrated.role,
+            };
+            sessionCredentials.set(sessionId, merged);
+            console.error(`[Credentials] getSessionCredentials(${sessionId}) - HYDRATED from local fallback`);
+            return merged;
+        }
+        console.error(`[Credentials] getSessionCredentials(${sessionId}) - FOUND: website=${sessionCreds.website}, hasToken=${!!sessionCreds.token}`);
+        return sessionCreds;
+    }
+
+    const localFallback = await resolveLocalProjectFallback();
+    if (localFallback) {
+        sessionCredentials.set(sessionId, localFallback);
+        console.error(`[Credentials] getSessionCredentials(${sessionId}) - USING local project fallback`);
+        return localFallback;
+    }
 
     // Priority 3: Fallback to environment variables (for backwards compatibility)
     console.error(`[Credentials] getSessionCredentials(${sessionId}) - NOT FOUND, using env fallback`);
@@ -150,7 +288,7 @@ export const getSessionCredentials = async (sessionId, inlineCredentials = null)
         forge_host: process.env.ACAI_FORGE_HOST || null,
         tokenHash: process.env.ACAI_TOKEN_HASH || null,
         profileName: 'default',
-        role: 'developer', // Env fallback = local dev, full access
+        role: resolveEffectiveRole('developer'), // Env fallback = local dev, full access
     };
 };
 
@@ -177,8 +315,8 @@ export const setSessionUserToken = (userToken, sessionId) => {
  * @param {string} sessionId - The session ID (SSE transport session)
  * @param {string} mcpSessionId - Optional MCP-Session-Id for persistence across SSE reconnections
  */
-export const setCredentials = async ({ website, web_url, api_web_url, forge_host, token, tokenHash, profileName, role }, sessionId, mcpSessionId = null) => {
-    console.error(`[Credentials] setCredentials(${sessionId}) - website=${website}, web_url=${web_url}, api_web_url=${api_web_url}, forge_host=${forge_host || ""}, hasToken=${!!token}, hasTokenHash=${!!tokenHash}, profile=${profileName || "manual"}, role=${role || 'default'}, hasMcpSessionId=${!!mcpSessionId}`);
+export const setCredentials = async ({ website, web_url, api_web_url, forge_host, token, tokenHash, profileName, role, project_dir }, sessionId, mcpSessionId = null) => {
+    console.error(`[Credentials] setCredentials(${sessionId}) - website=${website}, web_url=${web_url}, api_web_url=${api_web_url}, forge_host=${forge_host || ""}, hasToken=${!!token}, hasTokenHash=${!!tokenHash}, profile=${profileName || "manual"}, role=${role || 'default'}, project_dir=${project_dir || ""}, hasMcpSessionId=${!!mcpSessionId}`);
 
     const creds = {
         website,
@@ -187,6 +325,7 @@ export const setCredentials = async ({ website, web_url, api_web_url, forge_host
         forge_host: forge_host || null,
         token,
         tokenHash,
+        project_dir: project_dir || null,
         profileName: profileName || "manual",
         role: role || DEFAULT_ROLE,
     };

mcp-server/auth/localClient.js

@@ -1,14 +1,32 @@
 import axios from "axios";
-import { LOCAL_SERVER_URL } from "../config/index.js";
+import { LOCAL_SERVER_URL, getLocalServerHeaders } from "../config/index.js";
 
-export async function fetchProjectInfo(projectName) {
-    const response = await axios.get(`${LOCAL_SERVER_URL}/api/mcp/project-info`, {
-        params: { project: projectName }
+/**
+ * Resuelve info de un proyecto contra el server Python local.
+ *
+ * @param {string|Object} projectName - nombre del proyecto o query object (ej. { project_dir })
+ * @param {string|null} acaiUser - usuario Acai propietario del proyecto. Si se pasa,
+ *        se reenvia como header `X-Acai-User` para aislar la busqueda a
+ *        `/opt/acai/webs/<user>/`. Nginx valida el secret y añade este header
+ *        automaticamente; en modo stdio no se propaga y la logica original se
+ *        mantiene.
+ */
+export async function fetchProjectInfo(projectName, acaiUser = null) {
+    const params = typeof projectName === "string" ? { project: projectName } : (projectName || {});
+    const headers = getLocalServerHeaders();
+    if (acaiUser) headers["X-Acai-User"] = acaiUser;
+    const response = await axios.get(`${LOCAL_SERVER_URL}/api/project-info`, {
+        params,
+        headers,
     });
     return response.data; // { success, web_url, token, tokenHash, domain, project_dir }
 }
 
-export async function fetchProjectsList() {
-    const response = await axios.get(`${LOCAL_SERVER_URL}/api/mcp/projects`);
+export async function fetchProjectsList(acaiUser = null) {
+    const headers = getLocalServerHeaders();
+    if (acaiUser) headers["X-Acai-User"] = acaiUser;
+    const response = await axios.get(`${LOCAL_SERVER_URL}/api/mcp/projects`, {
+        headers,
+    });
     return response.data; // { success, projects: [...] }
 }

mcp-server/auth/mcpTokens.js

@@ -0,0 +1,95 @@
+/**
+ * MCP Token Validation
+ *
+ * Valida tokens X-MCP-Secret contra Redis.
+ * El backend Python escribe la clave `mcp_tokens:<sha256_hex>` con metadata JSON:
+ *   {
+ *     "id": "...",
+ *     "user": "superadmin",
+ *     "project": "vegaasesores.com",
+ *     "label": "MacBook Pro",
+ *     "createdAt": 1234567890,
+ *     "lastUsedAt": null | 1234567900
+ *   }
+ *
+ * El plaintext es "acai_<43 chars>" y se hashea con sha256 hex en minusculas.
+ */
+
+import Redis from "ioredis";
+import crypto from "node:crypto";
+
+const REDIS_URL = process.env.REDIS_URL || "redis://redis:6379";
+
+// Cliente Redis compartido (lazy init para no conectar si el MCP corre en modo stdio
+// u otros escenarios donde el middleware HTTP nunca se invoque).
+let redisClient = null;
+
+function getRedis() {
+    if (redisClient) return redisClient;
+    try {
+        redisClient = new Redis(REDIS_URL, {
+            lazyConnect: false,
+            maxRetriesPerRequest: 3,
+            enableReadyCheck: false,
+        });
+        redisClient.on("error", (err) => {
+            console.error("[mcp-tokens] redis error:", err.message);
+        });
+    } catch (e) {
+        console.error("[mcp-tokens] no se pudo inicializar redis:", e.message);
+        redisClient = null;
+    }
+    return redisClient;
+}
+
+/**
+ * Hashea un string con SHA256 y devuelve hex en minusculas.
+ */
+export function sha256Hex(str) {
+    return crypto.createHash("sha256").update(str, "utf8").digest("hex");
+}
+
+/**
+ * Valida un X-MCP-Secret plaintext contra Redis.
+ * @param {string} secret - plaintext tipo "acai_xxx"
+ * @returns {Promise<{user: string, project: string, id: string} | null>}
+ */
+export async function validateMcpToken(secret) {
+    if (!secret || typeof secret !== "string") return null;
+    const r = getRedis();
+    if (!r) return null;
+
+    const sha = sha256Hex(secret);
+    const key = `mcp_tokens:${sha}`;
+
+    let raw;
+    try {
+        raw = await r.get(key);
+    } catch (err) {
+        console.error("[mcp-tokens] redis GET error:", err.message);
+        return null;
+    }
+    if (!raw) return null;
+
+    let meta;
+    try {
+        meta = JSON.parse(raw);
+    } catch {
+        return null;
+    }
+    if (!meta || !meta.user || !meta.project) return null;
+
+    // Actualizacion asincrona de lastUsedAt — no bloqueamos la request.
+    updateLastUsedAt(key, meta).catch((e) => {
+        console.error("[mcp-tokens] lastUsedAt update failed:", e.message);
+    });
+
+    return { user: meta.user, project: meta.project, id: meta.id || "" };
+}
+
+async function updateLastUsedAt(key, meta) {
+    const r = getRedis();
+    if (!r) return;
+    const next = { ...meta, lastUsedAt: Math.floor(Date.now() / 1000) };
+    await r.set(key, JSON.stringify(next));
+}

mcp-server/fieldData.json

@@ -1,85 +0,0 @@
-{
-  "menu": "database",
-  "_defaultAction": "editTable",
-  "tableName": "",
-  "fieldname": "",
-  "order": 0,
-  "editField": 1,
-  "label": "",
-  "newFieldname": "",
-  "type": "",
-  "defaultValue": "",
-  "defaultContent": "",
-  "checkedByDefault": 0,
-  "descriptionjson": {},
-  "description": "",
-  "optionsTablename20": "",
-  "optionsValueField20": "",
-  "optionsLabelField20": "",
-  "checkedValue": 1,
-  "uncheckedValue": 0,
-  "fieldHeight": 300,
-  "tablaAuxiliar": 0,
-  "fieldWidth": null,
-  "tipoTags": 0,
-  "tipoAtributo": 0,
-  "allowUploads": 1,
-  "wysywigAvanzado": 1,
-  "yearRangeStart": 2010,
-  "yearRangeEnd": 2026,
-  "showTime": 1,
-  "use24HourFormat": 1,
-  "showSeconds": 1,
-  "listType": "pulldown",
-  "optionsType": "text",
-  "optionsText": "option one\noption two\noption three",
-  "optionsTablename": null,
-  "optionsValueField": null,
-  "optionsLabelField": null,
-  "optionsQuery": "SELECT fieldname1, fieldname2 FROM cms_tableName",
-  "filterField": null,
-  "separatorType": "blank line",
-  "separatorHeader": "",
-  "separatorHTML": "<tr><td colspan='2'></td></tr>",
-  "isRequired": 0,
-  "isUnique": 0,
-  "minLength": null,
-  "maxLength": null,
-  "charsetRule": "",
-  "charset": "",
-  "allowedExtensions": "gif,jpg,png,wmv,mov,swf,pdf",
-  "checkMaxUploads": 1,
-  "maxUploads": 25,
-  "checkMaxUploadSize": 1,
-  "maxUploadSizeKB": 5120,
-  "resizeOversizedImages": 1,
-  "maxImageWidth": 1024,
-  "maxImageHeight": 1024,
-  "createThumbnails": 1,
-  "maxThumbnailWidth": 150,
-  "maxThumbnailHeight": 150,
-  "createThumbnails2": 0,
-  "maxThumbnailWidth2": 150,
-  "maxThumbnailHeight2": 150,
-  "createThumbnails3": 0,
-  "maxThumbnailWidth3": 150,
-  "maxThumbnailHeight3": 150,
-  "createThumbnails4": 0,
-  "maxThumbnailWidth4": 150,
-  "maxThumbnailHeight4": 150,
-  "plUpload": 1,
-  "isSystemField": 0,
-  "adminOnly": 0,
-  "isPasswordField": 0,
-  "autoFormat": 1,
-  "infoField1": "",
-  "infoField2": "",
-  "infoField3": "",
-  "infoField4": "",
-  "infoField5": "",
-  "useCustomUploadDir": 0,
-  "customUploadDir": "/var/www/vhosts/ws.cocosolution.com/httpdocs/cms/uploads/",
-  "customUploadUrl": "/uploads/",
-  "customColumnType": "",
-  "save": 1
-}

mcp-server/httpServer.js

@@ -18,7 +18,9 @@ import {
     getMcpSessionCredentials
 } from "./auth/index.js";
 import { fetchProjectInfo } from "./auth/localClient.js";
+import { validateMcpToken } from "./auth/mcpTokens.js";
 import { createSessionServer } from "./server.js";
+import { runWithSession } from "./utils/sessionContext.js";
 
 // Active sessions - stores { transport, server, type, heartbeatInterval }
 const activeSessions = new Map();
@@ -72,9 +74,9 @@ const verifyJwt = (token) => {
     }
 };
 
-const resolveProjectCredentials = async (projectName) => {
+const resolveProjectCredentials = async (projectName, acaiUser = null) => {
     try {
-        const info = await fetchProjectInfo(projectName);
+        const info = await fetchProjectInfo(projectName, acaiUser);
         if (!info.success) {
             throw new Error(info.error || "Failed to resolve project info");
         }
@@ -85,20 +87,30 @@ const resolveProjectCredentials = async (projectName) => {
             web_url: info.web_url,
             api_web_url: info.api_web_url || info.web_url,
             forge_host: info.forge_host || null,
+            mode: info.mode || "local",
+            project_dir: info.project_dir || null,
+            acai_user: acaiUser || info.acai_user || null,
         };
     } catch (error) {
-        throw new Error(`Failed to resolve project '${projectName}': ${error.message}`);
+        // Si el Python devuelve 404, propagamos el estado original para que el
+        // cliente MCP reciba el fallo real (no lo enmascaramos como 500).
+        if (error.response?.status === 404) {
+            const details = error.response.data?.error || error.response.data?.message || "project not found";
+            const err = new Error(`Project '${typeof projectName === "string" ? projectName : (projectName?.project || projectName?.project_dir || "?")}' not found: ${details}`);
+            err.status = 404;
+            throw err;
+        }
+        throw new Error(`Failed to resolve project '${typeof projectName === "string" ? projectName : (projectName?.project || projectName?.project_dir || "?")}': ${error.message}`);
     }
 };
 
 /**
  * Configure credentials from request headers/query params for a session
  */
-const configureSessionCredentials = async (sessionId, { token, tokenHash, website, web_url, userToken, projectName }) => {
+const configureSessionCredentials = async (sessionId, { token, tokenHash, website, web_url, userToken, projectName, acaiUser }) => {
     // Priority 1: Resolve via project name from local Python server
     if (projectName) {
-        try {
-            const projectCreds = await resolveProjectCredentials(projectName);
+        const projectCreds = await resolveProjectCredentials(projectName, acaiUser);
         sessionCredentials.set(sessionId, {
             token: projectCreds.token,
             tokenHash: projectCreds.tokenHash || null,
@@ -106,15 +118,14 @@ const configureSessionCredentials = async (sessionId, { token, tokenHash, websit
             web_url: projectCreds.web_url,
             api_web_url: projectCreds.api_web_url || projectCreds.web_url,
             forge_host: projectCreds.forge_host || null,
+            mode: projectCreds.mode || "local",
+            project_dir: projectCreds.project_dir || null,
+            acai_user: acaiUser || projectCreds.acai_user || null,
             profileName: 'project-' + projectName,
             role: 'developer',
         });
-            console.log(`[MCP] Session ${sessionId} authenticated via project '${projectName}' - web_url: ${projectCreds.web_url}`);
+        console.log(`[MCP] Session ${sessionId} authenticated via project '${projectName}' (user=${acaiUser || "-"}) - web_url: ${projectCreds.web_url}`);
         return true;
-        } catch (error) {
-            console.error(`[MCP] Failed to resolve project '${projectName}': ${error.message}`);
-            // Fall through to try other auth methods
-        }
     }
 
     // Priority 2: Direct credentials (legacy header-based)
@@ -149,7 +160,10 @@ const extractCredentialsFromRequest = (req) => {
         token: url.searchParams.get('token') || req.headers['x-acai-token'],
         tokenHash: url.searchParams.get('tokenHash') || req.headers['x-acai-token-hash'],
         website: url.searchParams.get('website') || req.headers['x-acai-website'],
-        userToken: url.searchParams.get('userToken') || req.headers['x-user-token']
+        userToken: url.searchParams.get('userToken') || req.headers['x-user-token'],
+        // Header inyectado por nginx tras validar el secret contra su mapa.
+        // Se usa para aislar la resolucion del proyecto a /opt/acai/webs/<user>/.
+        acaiUser: req.headers['x-acai-user'] || null,
     };
 };
 
@@ -167,11 +181,45 @@ export function startHttpServer() {
     app.use(cors({
         origin: '*',
         methods: ['GET', 'POST', 'DELETE', 'OPTIONS'],
-        allowedHeaders: ['Content-Type', 'X-Acai-Token', 'X-Acai-Website', 'X-Acai-Token-Hash', 'X-User-Token', 'X-Project-Name', 'Authorization', 'Mcp-Session-Id'],
+        allowedHeaders: ['Content-Type', 'X-Acai-Token', 'X-Acai-Website', 'X-Acai-Token-Hash', 'X-User-Token', 'X-Project-Name', 'X-Acai-User', 'X-MCP-Secret', 'Authorization', 'Mcp-Session-Id'],
         exposedHeaders: ['Mcp-Session-Id'],
         credentials: true
     }));
 
+    //=============================================================================
+    // MCP SECRET MIDDLEWARE
+    // Si llega X-MCP-Secret, lo validamos contra Redis (mcp_tokens:<sha256>) y
+    // reemplazamos los headers de identidad con los del token. El cliente NO
+    // puede forzar X-Acai-User / X-Project-Name si esta usando X-MCP-Secret.
+    // Si NO llega X-MCP-Secret, pasa de largo (modo legacy/dev: el cliente se
+    // identifica manualmente con X-Acai-User + X-Project-Name).
+    //=============================================================================
+    app.use(async (req, res, next) => {
+        const secret = req.headers["x-mcp-secret"];
+        if (!secret) {
+            return next();
+        }
+        try {
+            const auth = await validateMcpToken(secret);
+            if (!auth) {
+                res.status(401)
+                    .setHeader("Content-Type", "application/json")
+                    .end(JSON.stringify({ error: "Invalid MCP token" }));
+                return;
+            }
+            // Sobrescribe los headers de identidad con los del token validado.
+            req.headers["x-acai-user"] = auth.user;
+            req.headers["x-project-name"] = auth.project;
+            return next();
+        } catch (err) {
+            console.error("[MCP] mcpSecretMiddleware error:", err.message);
+            res.status(401)
+                .setHeader("Content-Type", "application/json")
+                .end(JSON.stringify({ error: "Invalid MCP token" }));
+            return;
+        }
+    });
+
     //=============================================================================
     // STREAMABLE HTTP TRANSPORT (PROTOCOL VERSION 2025-03-26)
     // This is the new recommended transport for MCP
@@ -207,6 +255,29 @@ export function startHttpServer() {
                 // Extract credentials from request
                 const credentials = extractCredentialsFromRequest(req);
 
+                // Si la request trae projectName, resolvemos credenciales ANTES de
+                // crear el transport. Si falla (p.ej. proyecto no existe o no
+                // pertenece al usuario), propagamos el error al cliente MCP en
+                // lugar de enmascararlo como initialize OK.
+                let resolvedCreds = null;
+                if (credentials.projectName) {
+                    try {
+                        resolvedCreds = await resolveProjectCredentials(credentials.projectName, credentials.acaiUser);
+                    } catch (err) {
+                        const status = err.status === 404 ? 404 : 400;
+                        console.error(`[MCP Streamable] Credential resolution failed (user=${credentials.acaiUser || "-"}, project=${credentials.projectName}): ${err.message}`);
+                        res.status(status).json({
+                            jsonrpc: '2.0',
+                            error: {
+                                code: status === 404 ? -32004 : -32000,
+                                message: err.message,
+                            },
+                            id: req.body?.id ?? null,
+                        });
+                        return;
+                    }
+                }
+
                 transport = new StreamableHTTPServerTransport({
                     sessionIdGenerator: () => crypto.randomUUID(),
                     onsessioninitialized: (sessionId) => {
@@ -220,18 +291,36 @@ export function startHttpServer() {
                             startTime: Date.now()
                         });
 
-                        // Configure credentials for this session (async, fire-and-forget)
+                        // Guardar credenciales ya resueltas, o caer a otros metodos
+                        // (token directo, userToken) de forma sincrona.
+                        if (resolvedCreds) {
+                            const creds = {
+                                token: resolvedCreds.token,
+                                tokenHash: resolvedCreds.tokenHash || null,
+                                website: resolvedCreds.website,
+                                web_url: resolvedCreds.web_url,
+                                api_web_url: resolvedCreds.api_web_url || resolvedCreds.web_url,
+                                forge_host: resolvedCreds.forge_host || null,
+                                mode: resolvedCreds.mode || "local",
+                                project_dir: resolvedCreds.project_dir || null,
+                                acai_user: credentials.acaiUser || resolvedCreds.acai_user || null,
+                                profileName: 'project-' + credentials.projectName,
+                                role: 'developer',
+                            };
+                            sessionCredentials.set(sessionId, creds);
+                            setMcpSessionCredentials(sessionId, creds);
+                            console.log(`[MCP] Session ${sessionId} authenticated via project '${credentials.projectName}' (user=${credentials.acaiUser || "-"}) - web_url: ${creds.web_url}`);
+                        } else {
+                            // Sin projectName -> usar fallback de credenciales directas
                             configureSessionCredentials(sessionId, credentials).then((configured) => {
                                 if (configured) {
-                                // Also store credentials by MCP-Session-Id for persistence
                                     const creds = sessionCredentials.get(sessionId);
-                                if (creds) {
-                                    setMcpSessionCredentials(sessionId, creds);
-                                }
+                                    if (creds) setMcpSessionCredentials(sessionId, creds);
                                 }
                             }).catch((err) => {
                                 console.error(`[MCP Streamable] Error configuring credentials for session ${sessionId}:`, err.message);
                             });
+                        }
                     },
                     onsessionclosed: (sessionId) => {
                         console.log(`[MCP Streamable] Session closed: ${sessionId.substring(0, 8)}...`);
@@ -295,8 +384,21 @@ export function startHttpServer() {
                 return;
             }
 
-            // Handle the request with the transport
+            // Resolver el mcpSessionId definitivo para propagar via AsyncLocalStorage.
+            // En initialize hay que esperar a que el transport asigne el sessionId
+            // (lo hace sincronicamente en handleRequest via onsessioninitialized).
+            const resolvedSessionId = mcpSessionId || transport.sessionId || null;
+
+            if (resolvedSessionId) {
+                await runWithSession(resolvedSessionId, async () => {
                     await transport.handleRequest(req, res, req.body);
+                });
+            } else {
+                // En la request de initialize todavia no existe sessionId — el
+                // transport lo genera internamente. Las tools no se llaman en
+                // initialize, por lo que podemos invocar sin contexto.
+                await transport.handleRequest(req, res, req.body);
+            }
         } catch (error) {
             console.error('[MCP Streamable] Error:', error);
             if (!res.headersSent) {
@@ -349,8 +451,20 @@ export function startHttpServer() {
             }
         }, 30000);
 
-        // Configure credentials
+        // Configure credentials (si falla devolvemos 4xx antes de abrir el SSE)
+        try {
             await configureSessionCredentials(sessionId, credentials);
+        } catch (err) {
+            const status = err.status === 404 ? 404 : 400;
+            console.error(`[MCP SSE] Credential resolution failed: ${err.message}`);
+            clearInterval(heartbeatInterval);
+            if (!res.headersSent) {
+                res.status(status).json({ error: err.message });
+            } else {
+                res.end();
+            }
+            return;
+        }
 
         // Store session
         activeSessions.set(sessionId, {
@@ -419,7 +533,9 @@ export function startHttpServer() {
         }
 
         try {
+            await runWithSession(sessionId, async () => {
                 await transport.handlePostMessage(req, res, req.body);
+            });
         } catch (error) {
             console.error(`[MCP SSE] POST error for session ${sessionId}:`, error.message);
             if (!res.headersSent) {

mcp-server/package-lock.json

@@ -15,6 +15,7 @@
                 "cors": "^2.8.6",
                 "dotenv": "^16.3.1",
                 "express": "^5.2.1",
+                "ioredis": "^5.10.1",
                 "jsdom": "^27.2.0",
                 "redis": "^4.7.0",
                 "sharp": "^0.33.5",
@@ -596,6 +597,12 @@
                 "url": "https://opencollective.com/libvips"
             }
         },
+        "node_modules/@ioredis/commands": {
+            "version": "1.5.1",
+            "resolved": "https://registry.npmjs.org/@ioredis/commands/-/commands-1.5.1.tgz",
+            "integrity": "sha512-JH8ZL/ywcJyR9MmJ5BNqZllXNZQqQbnVZOqpPQqE1vHiFgAw4NHbvE0FOduNU8IX9babitBT46571OnPTT0Zcw==",
+            "license": "MIT"
+        },
         "node_modules/@modelcontextprotocol/sdk": {
             "version": "1.27.1",
             "resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.27.1.tgz",
@@ -1249,6 +1256,15 @@
                 "node": ">=0.4.0"
             }
         },
+        "node_modules/denque": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/denque/-/denque-2.1.0.tgz",
+            "integrity": "sha512-HVQE3AAb/pxF8fQAoiqpvg9i3evqug3hoiwakOyZAwJm+6vZehbkYXZ0l4JxS+I3QxM97v5aaRNhj8v5oBhekw==",
+            "license": "Apache-2.0",
+            "engines": {
+                "node": ">=0.10"
+            }
+        },
         "node_modules/depd": {
             "version": "2.0.0",
             "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
@@ -1928,6 +1944,30 @@
             "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
             "license": "ISC"
         },
+        "node_modules/ioredis": {
+            "version": "5.10.1",
+            "resolved": "https://registry.npmjs.org/ioredis/-/ioredis-5.10.1.tgz",
+            "integrity": "sha512-HuEDBTI70aYdx1v6U97SbNx9F1+svQKBDo30o0b9fw055LMepzpOOd0Ccg9Q6tbqmBSJaMuY0fB7yw9/vjBYCA==",
+            "license": "MIT",
+            "dependencies": {
+                "@ioredis/commands": "1.5.1",
+                "cluster-key-slot": "^1.1.0",
+                "debug": "^4.3.4",
+                "denque": "^2.1.0",
+                "lodash.defaults": "^4.2.0",
+                "lodash.isarguments": "^3.1.0",
+                "redis-errors": "^1.2.0",
+                "redis-parser": "^3.0.0",
+                "standard-as-callback": "^2.1.0"
+            },
+            "engines": {
+                "node": ">=12.22.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/ioredis"
+            }
+        },
         "node_modules/ip-address": {
             "version": "10.1.0",
             "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.1.0.tgz",
@@ -2100,6 +2140,18 @@
             "integrity": "sha512-fQhoXdcvc3V28x7C7BMs4P5+kNlgUURe2jmUT1T//oBRMDrqy1QPelJimwZGo7Hg9VPV3EQV5Bnq4hbFy2vetA==",
             "license": "BSD-2-Clause"
         },
+        "node_modules/lodash.defaults": {
+            "version": "4.2.0",
+            "resolved": "https://registry.npmjs.org/lodash.defaults/-/lodash.defaults-4.2.0.tgz",
+            "integrity": "sha512-qjxPLHd3r5DnsdGacqOMU6pb/avJzdh9tFX2ymgoZE27BmjXrNy/y4LoaiTeAb+O3gL8AfpJGtqfX/ae2leYYQ==",
+            "license": "MIT"
+        },
+        "node_modules/lodash.isarguments": {
+            "version": "3.1.0",
+            "resolved": "https://registry.npmjs.org/lodash.isarguments/-/lodash.isarguments-3.1.0.tgz",
+            "integrity": "sha512-chi4NHZlZqZD18a0imDHnZPrDeBbTtVN7GXMwuGdRH9qotxAjYs3aVLKc7zNOG9eddR5Ksd8rvFEBc9SsggPpg==",
+            "license": "MIT"
+        },
         "node_modules/lru-cache": {
             "version": "11.2.7",
             "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.7.tgz",
@@ -2557,6 +2609,27 @@
                 "@redis/time-series": "1.1.0"
             }
         },
+        "node_modules/redis-errors": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/redis-errors/-/redis-errors-1.2.0.tgz",
+            "integrity": "sha512-1qny3OExCf0UvUV/5wpYKf2YwPcOqXzkwKKSmKHiE6ZMQs5heeE/c8eXK+PNllPvmjgAbfnsbpkGZWy8cBpn9w==",
+            "license": "MIT",
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/redis-parser": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/redis-parser/-/redis-parser-3.0.0.tgz",
+            "integrity": "sha512-DJnGAeenTdpMEH6uAJRK/uiyEIH9WVsUmoLwzudwGJUwZPp80PDBWPHXSAGNPwNvIXAbe7MSUB1zQFugFml66A==",
+            "license": "MIT",
+            "dependencies": {
+                "redis-errors": "^1.0.0"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
         "node_modules/require-from-string": {
             "version": "2.0.2",
             "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
@@ -2826,6 +2899,12 @@
                 "node": ">=0.10.0"
             }
         },
+        "node_modules/standard-as-callback": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/standard-as-callback/-/standard-as-callback-2.1.0.tgz",
+            "integrity": "sha512-qoRRSyROncaz1z0mvYqIE4lCd9p2R90i6GxW3uZv5ucSu8tU7B5HXUP1gG8pVZsYNVaXjk8ClXHPttLyxAL48A==",
+            "license": "MIT"
+        },
         "node_modules/statuses": {
             "version": "2.0.2",
             "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",

mcp-server/package.json

@@ -17,6 +17,7 @@
         "cors": "^2.8.6",
         "dotenv": "^16.3.1",
         "express": "^5.2.1",
+        "ioredis": "^5.10.1",
         "jsdom": "^27.2.0",
         "redis": "^4.7.0",
         "sharp": "^0.33.5",

mcp-server/stdio.js

@@ -2,17 +2,16 @@
  * Acai Code MCP Server - Stdio Entry Point
  *
  * Used when Claude Code launches the MCP server directly via .mcp.json.
- * Reads credentials from .acai file on each tool call (auto-refresh on token renewal).
+ * Reads credentials from the local Python server on each tool call.
  */
 
-import fs from "fs";
-import path from "path";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createMcpServer } from "./server.js";
 import { registerPrompts } from "./prompts/index.js";
 import { registerTools } from "./tools/index.js";
 import { registerResources } from "./resources/index.js";
 import { sessionCredentials } from "./auth/credentials.js";
+import { fetchProjectInfo } from "./auth/localClient.js";
 
 // Create server instance
 const server = createMcpServer();
@@ -20,75 +19,71 @@ registerPrompts(server);
 registerTools(server);
 registerResources(server);
 
-// Static env vars (web_url and website don't change, token does)
 const projectDir = process.env.ACAI_PROJECT_DIR || "";
-const acaiFilePath = projectDir ? path.join(projectDir, ".acai") : "";
 
-// Read .acai once at startup for URL fallbacks
-let acaiFileData = {};
-if (acaiFilePath) {
-    try {
-        acaiFileData = JSON.parse(fs.readFileSync(acaiFilePath, "utf-8"));
-    } catch { /* ignore - fall back to env vars */ }
+// Aplica vars de override de entorno (usado por cronjobs para forzar el
+// entorno objetivo sin tocar el .acai del proyecto). Modifica creds in-place.
+function applyEnvironmentOverride(creds) {
+    const modeOverride = process.env.ACAI_MODE_OVERRIDE;
+    if (!modeOverride) return creds;
+    creds.mode = modeOverride;
+    if (process.env.ACAI_WEB_URL_OVERRIDE) creds.web_url = process.env.ACAI_WEB_URL_OVERRIDE;
+    if (process.env.ACAI_API_WEB_URL_OVERRIDE) creds.api_web_url = process.env.ACAI_API_WEB_URL_OVERRIDE;
+    if (process.env.ACAI_FORGE_HOST_OVERRIDE !== undefined) {
+        creds.forge_host = process.env.ACAI_FORGE_HOST_OVERRIDE;
+    }
+    return creds;
 }
 
-const website = process.env.ACAI_WEBSITE || acaiFileData.domain || "";
-const webUrl = process.env.ACAI_WEB_URL || acaiFileData.local_web_url || "";
-const derivedForgeHost = (() => {
-    // First check .acai for explicit forge host
-    if (acaiFileData.local_forge_host) return acaiFileData.local_forge_host;
-    if (!webUrl) return "";
+async function readFreshCredentials() {
+    if (projectDir) {
         try {
-        const parsed = new URL(webUrl);
-        return parsed.hostname.includes("forge.acaisuite.com") ? parsed.host : "";
-    } catch {
-        return "";
-    }
-})();
-const apiWebUrl = process.env.ACAI_API_WEB_URL || (derivedForgeHost ? "http://web:80/" : webUrl);
-const forgeHost = process.env.ACAI_FORGE_HOST || derivedForgeHost;
-
-// Read fresh credentials from .acai file
-function readFreshCredentials() {
-    let token = process.env.ACAI_TOKEN || "";
-    let tokenHash = process.env.ACAI_TOKEN_HASH || "";
-
-    // If .acai file exists, read fresh token from disk (renewed by Python server)
-    if (acaiFilePath) {
-        try {
-            const data = JSON.parse(fs.readFileSync(acaiFilePath, "utf-8"));
-            if (data.token) token = data.token;
-            if (data.tokenHash) tokenHash = data.tokenHash;
-        } catch {
-            // Fall back to env vars if .acai can't be read
-        }
-    }
-
-    return {
-        token,
-        tokenHash,
-        website,
-        web_url: webUrl,
-        api_web_url: apiWebUrl,
-        forge_host: forgeHost,
+            const data = await fetchProjectInfo({ project_dir: projectDir });
+            if (data?.success) {
+                return applyEnvironmentOverride({
+                    token: data.token || "",
+                    tokenHash: data.tokenHash || "",
+                    website: data.domain || "",
+                    web_url: data.web_url || "",
+                    api_web_url: data.api_web_url || data.web_url || "",
+                    forge_host: data.forge_host || "",
+                    mode: data.mode || "local",
                     profileName: "stdio",
                     role: "developer",
-    };
+                });
+            }
+        } catch (error) {
+            console.error(`[MCP stdio] Failed to resolve project-info: ${error.message}`);
+        }
+    }
+
+    return applyEnvironmentOverride({
+        token: process.env.ACAI_TOKEN || "",
+        tokenHash: process.env.ACAI_TOKEN_HASH || "",
+        website: process.env.ACAI_WEBSITE || "",
+        web_url: process.env.ACAI_WEB_URL || "",
+        api_web_url: process.env.ACAI_API_WEB_URL || "",
+        forge_host: process.env.ACAI_FORGE_HOST || "",
+        mode: process.env.ACAI_MODE || "local",
+        profileName: "stdio-fallback",
+        role: "developer",
+    });
 }
 
-if (!webUrl) {
+const initialCreds = await readFreshCredentials();
+
+if (!initialCreds.web_url) {
     console.error("[MCP stdio] WARNING: No ACAI_WEB_URL in environment. Tools will fail.");
 }
 
 // Set initial credentials
-sessionCredentials.set("_default", readFreshCredentials());
+sessionCredentials.set("_default", initialCreds);
 
-// Intercept tool calls to refresh credentials from .acai before each call
+// Intercept tool calls to refresh credentials from the Python server before each call
 const _origSetHandler = server.server.setRequestHandler;
 server.server.setRequestHandler = (schema, handler) => {
     return _origSetHandler.call(server.server, schema, async (request, extra) => {
-        // Re-read .acai on every tool call to pick up renewed tokens
-        const freshCreds = readFreshCredentials();
+        const freshCreds = await readFreshCredentials();
         sessionCredentials.set("_default", freshCreds);
         if (extra?.sessionId) {
             sessionCredentials.set(extra.sessionId, freshCreds);
@@ -100,4 +95,4 @@ server.server.setRequestHandler = (schema, handler) => {
 // Connect via stdio transport
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error(`[MCP stdio] Connected — ${website} → ${webUrl} (project: ${projectDir})`);
+console.error(`[MCP stdio] Connected — ${initialCreds.website} → ${initialCreds.web_url} (project: ${projectDir})`);

mcp-server/tools/auth/index.js

@@ -1,99 +1,90 @@
 import { z } from "zod";
-import fs from "fs";
-import path from "path";
-import axios from "axios";
-import { sessionCredentials } from "../../auth/credentials.js";
+import { sessionCredentials, setMcpSessionCredentials } from "../../auth/credentials.js";
 import { withAuthParams } from "../helpers/authSchema.js";
-
-const LOCAL_SERVER_URL = `http://localhost:${process.env.ACAI_HOST_PORT || 29871}`;
+import { fetchProjectInfo } from "../../auth/localClient.js";
+import { resolveCurrentProjectDir } from "../files/helpers.js";
+import { resolveCurrentAcaiUser } from "../helpers/sessionHelpers.js";
+import { getCurrentSessionId } from "../../utils/sessionContext.js";
 
 export function registerAuthTools(server) {
     server.tool(
         "refresh_acai_token",
-        `Refresh the Acai JWT token when it has expired (403 "Token no válido" errors). This re-reads the token from the .acai file on disk. If the token on disk is also expired, it calls the Python server to renew it. Use this tool when any other tool fails with a 403 token error.`,
+        `Refresh the Acai JWT token when it has expired (403 "Token no válido" errors). Delegates to the Python server which detects expiration, renews the token against the webservice if needed, persists the updated .acai file and returns fresh credentials. Use this tool when any other tool fails with a 403 token error.`,
         withAuthParams({}),
         { readOnlyHint: false, destructiveHint: false },
         async (_args, extra) => {
             try {
-                const projectDir = process.env.ACAI_PROJECT_DIR || "";
-                const acaiFilePath = projectDir ? path.join(projectDir, ".acai") : "";
-
-                if (!acaiFilePath) {
+                const projectDir = resolveCurrentProjectDir();
+                if (!projectDir) {
                     return {
-                        content: [{ type: "text", text: JSON.stringify({ success: false, error: "ACAI_PROJECT_DIR not set" }) }],
+                        content: [{ type: "text", text: JSON.stringify({ success: false, error: "Project dir no disponible en esta sesion" }) }],
                         isError: true,
                     };
                 }
 
-                // Step 1: Try reading fresh token from .acai (Python server may have already refreshed it)
-                let token = "";
-                let tokenHash = "";
-                let domain = "";
-                try {
-                    const data = JSON.parse(fs.readFileSync(acaiFilePath, "utf-8"));
-                    token = data.token || "";
-                    tokenHash = data.tokenHash || "";
-                    domain = data.domain || "";
-                } catch (e) {
-                    return {
-                        content: [{ type: "text", text: JSON.stringify({ success: false, error: `Cannot read .acai: ${e.message}` }) }],
-                        isError: true,
-                    };
-                }
+                const acaiUser = resolveCurrentAcaiUser();
 
-                // Step 2: Check if token is expired by decoding JWT
-                let isExpired = false;
+                // Delegamos al Python que ya gestiona expiracion + refresh + persistencia
+                let info;
                 try {
-                    const payload = token.split(".")[1];
-                    const decoded = JSON.parse(Buffer.from(payload, "base64").toString());
-                    isExpired = Date.now() / 1000 > (decoded.exp || 0) - 300;
-                } catch {
-                    isExpired = true;
-                }
-
-                // Step 3: If expired, ask Python server to refresh it
-                if (isExpired) {
-                    try {
-                        // Call the compile-module endpoint pattern — but we need a refresh endpoint
-                        // Use the server's existing auto-refresh: just call any endpoint that triggers refresh
-                        // The simplest: GET /api/projects which auto-refreshes expired tokens
-                        const res = await axios.get(`${LOCAL_SERVER_URL}/api/projects`, { timeout: 15000 });
-                        // Re-read .acai after server refreshed it
-                        const data = JSON.parse(fs.readFileSync(acaiFilePath, "utf-8"));
-                        token = data.token || "";
-                        tokenHash = data.tokenHash || "";
+                    info = await fetchProjectInfo({ project_dir: projectDir }, acaiUser);
                 } catch (e) {
                     return {
                         content: [{ type: "text", text: JSON.stringify({ success: false, error: `Token refresh failed: ${e.message}` }) }],
                         isError: true,
                     };
                 }
+
+                if (!info?.success) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({ success: false, error: info?.error || "Project info resolution failed" }) }],
+                        isError: true,
+                    };
+                }
+
+                // Comparamos token previo para saber si hubo renovacion
+                const mcpSessionId = getCurrentSessionId();
+                let previousToken = null;
+                if (mcpSessionId) {
+                    // Leer creds previas sin tocar lastAccess via interno no expuesto:
+                    // usamos sessionCredentials como espejo si existe, sino null.
+                    const prev = sessionCredentials.get(mcpSessionId);
+                    previousToken = prev?.token || null;
                 }
 
-                // Step 4: Update credentials in memory
-                const webUrl = process.env.ACAI_WEB_URL || "";
-                const website = domain || process.env.ACAI_WEBSITE || "";
                 const freshCreds = {
-                    token,
-                    tokenHash,
-                    website,
-                    web_url: webUrl,
-                    profileName: "stdio",
+                    token: info.token || "",
+                    tokenHash: info.tokenHash || "",
+                    website: info.domain || "",
+                    web_url: info.web_url || "",
+                    api_web_url: info.api_web_url || info.web_url || "",
+                    forge_host: info.forge_host || null,
+                    project_dir: info.project_dir || projectDir,
+                    acai_user: acaiUser || null,
+                    profileName: acaiUser || "mcp-session",
                     role: "developer",
                 };
-                sessionCredentials.set("_default", freshCreds);
+
+                // Persistir en la sesion MCP activa (HTTP multi-tenant)
+                if (mcpSessionId) {
+                    setMcpSessionCredentials(mcpSessionId, freshCreds);
+                    sessionCredentials.set(mcpSessionId, freshCreds);
+                }
+                // Compatibilidad stdio (cuando extra.sessionId viene del SDK)
                 if (extra?.sessionId) {
                     sessionCredentials.set(extra.sessionId, freshCreds);
                 }
 
+                const rotated = previousToken && previousToken !== freshCreds.token;
+
                 return {
                     content: [{
                         type: "text",
                         text: JSON.stringify({
                             success: true,
-                            message: "Token refreshed successfully",
-                            expired_before: isExpired,
-                            domain: website,
+                            message: rotated ? "Token refreshed (rotated by Python)" : "Token refreshed successfully",
+                            domain: freshCreds.website,
+                            rotated: !!rotated,
                         }, null, 2),
                     }],
                 };

mcp-server/tools/docs/_docsReader.js

@@ -0,0 +1,151 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+/**
+ * Lectura directa de los markdown del knowledge base desde el filesystem.
+ *
+ * El MCP server corre dentro del container `agentic` junto al FastAPI, asi
+ * que los .md viven en `/app/docs/` (la imagen los copia ahi).
+ *
+ * En caso de override por entorno, respeta `ACAI_DOCS_DIR`. En desarrollo
+ * fuera del container, fallback a paths relativos al cwd.
+ */
+
+function resolveDocsDir() {
+    const override = process.env.ACAI_DOCS_DIR;
+    if (override) return override;
+    // Container path
+    return "/app/docs";
+}
+
+export async function listDocs() {
+    const dir = resolveDocsDir();
+    let files;
+    try {
+        files = await fs.readdir(dir);
+    } catch (err) {
+        const error = new Error(`No se pudo leer el directorio de docs (${dir}): ${err.message}`);
+        error.code = "DOCS_DIR_NOT_FOUND";
+        throw error;
+    }
+
+    const mdFiles = files.filter((f) => f.endsWith(".md")).sort();
+    const docs = [];
+
+    for (const file of mdFiles) {
+        const id = file.replace(/\.md$/i, "");
+        const filePath = path.join(dir, file);
+        const content = await fs.readFile(filePath, "utf8");
+        const lines = content.split("\n");
+        const titleLine = lines.find((l) => l.trim().startsWith("# ")) || id;
+        const title = titleLine.replace(/^#+/, "").trim();
+
+        // Summary: primeras 30 lineas no-heading, capeado a 500 chars
+        const summaryLines = [];
+        for (const line of lines.slice(0, 30)) {
+            const t = line.trim();
+            if (t && !t.startsWith("#")) summaryLines.push(t);
+            if (summaryLines.join(" ").length > 500) break;
+        }
+        const summary = summaryLines.join(" ").slice(0, 500);
+
+        docs.push({
+            id,
+            title,
+            summary,
+            chars: content.length,
+        });
+    }
+    return docs;
+}
+
+export async function readDoc(name, section) {
+    const dir = resolveDocsDir();
+    const safeName = String(name).replace(/\.md$/i, "").replace(/[\/\\]/g, "");
+    const filePath = path.join(dir, `${safeName}.md`);
+
+    let content;
+    try {
+        content = await fs.readFile(filePath, "utf8");
+    } catch (err) {
+        const error = new Error(`Doc '${safeName}' no encontrado en ${dir}`);
+        error.code = "DOC_NOT_FOUND";
+        throw error;
+    }
+
+    const titleLine = content.split("\n").find((l) => l.trim().startsWith("# ")) || safeName;
+    const title = titleLine.replace(/^#+/, "").trim();
+    const availableSections = listSections(content);
+
+    if (section) {
+        const sectionContent = extractSection(content, section);
+        if (sectionContent === null) {
+            return {
+                id: safeName,
+                title,
+                section_requested: section,
+                section_found: false,
+                available_sections: availableSections,
+                chars: 0,
+                content: "",
+            };
+        }
+        return {
+            id: safeName,
+            title,
+            section,
+            section_found: true,
+            chars: sectionContent.length,
+            content: sectionContent,
+        };
+    }
+
+    return {
+        id: safeName,
+        title,
+        section: null,
+        section_found: true,
+        chars: content.length,
+        available_sections: availableSections,
+        content,
+    };
+}
+
+function listSections(content) {
+    const sections = [];
+    for (const line of content.split("\n")) {
+        const t = line.trimStart();
+        if (t.startsWith("## ") && !t.startsWith("### ")) {
+            sections.push(t.slice(3).trim());
+        }
+    }
+    return sections;
+}
+
+function extractSection(content, query) {
+    const q = String(query).toLowerCase().trim();
+    if (!q) return null;
+    const lines = content.split("\n");
+    const captured = [];
+    let capturing = false;
+
+    for (const line of lines) {
+        const t = line.trimStart();
+        const isH2 = t.startsWith("## ") && !t.startsWith("### ");
+
+        if (isH2) {
+            const heading = t.slice(3).trim();
+            if (capturing) break;
+            if (heading.toLowerCase().includes(q)) {
+                capturing = true;
+                captured.push(line);
+                continue;
+            }
+        }
+
+        if (capturing) captured.push(line);
+    }
+
+    if (captured.length === 0) return null;
+    return captured.join("\n").trimEnd();
+}

mcp-server/tools/docs/index.js

@@ -0,0 +1,20 @@
+import { registerListDocsTool } from './list_docs.js';
+import { registerReadDocTool } from './read_doc.js';
+
+/**
+ * Tools para consultar la documentación del proyecto bajo demanda.
+ *
+ * El knowledge_base del context engine ya inyecta los docs más relevantes
+ * en cada turno por similitud semántica, pero hay dos casos en los que el
+ * agente necesita pedir un doc explícitamente:
+ *  - El doc cayó fuera del top-K y solo aparece en el title-index del KB.
+ *  - Se necesita una sección puntual con detalle sin cargar todo el doc.
+ *
+ * Estas tools delegan en endpoints `/api/knowledge/...` del server Python,
+ * que leen los docs del memory store (Redis) — la misma fuente que alimenta
+ * el knowledge_base.
+ */
+export function registerDocsTools(server) {
+    registerListDocsTool(server);
+    registerReadDocTool(server);
+}

mcp-server/tools/docs/list_docs.js

@@ -0,0 +1,29 @@
+import { handleToolError } from "../helpers/errorHandler.js";
+import { listDocs } from "./_docsReader.js";
+
+export function registerListDocsTool(server) {
+    server.tool(
+        "list_docs",
+        `Lista todos los docs disponibles en el knowledge base con su id, título y un summary corto. Útil cuando necesitas saber qué documentación existe antes de llamar a 'read_doc'. El system prompt y el knowledge_base ya cargan los docs más relevantes a tu tarea — usa 'list_docs' / 'read_doc' solo si necesitas un doc que no apareció completo en el contexto o quieres una sección específica con detalle.`,
+        {},
+        { readOnlyHint: true, destructiveHint: false },
+        async () => {
+            try {
+                const docs = await listDocs();
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            count: docs.length,
+                            documents: docs,
+                            note: "Usa 'read_doc' con el 'id' (e.g. '05-tables-and-fields') para leer el doc completo o pasa 'section' para una sección concreta.",
+                        }, null, 2),
+                    }],
+                };
+            } catch (error) {
+                return handleToolError(error, "list_docs", {});
+            }
+        }
+    );
+}

mcp-server/tools/docs/read_doc.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { handleToolError, validateRequired } from "../helpers/errorHandler.js";
+import { readDoc } from "./_docsReader.js";
+
+export function registerReadDocTool(server) {
+    server.tool(
+        "read_doc",
+        `Lee un documento del knowledge base de Acai bajo demanda.
+
+Cuándo usarlo:
+- El doc no se cargó completo en el contexto (aparece en "Other Available Docs" del knowledge_base).
+- Necesitas una sección concreta con detalle sin cargar todo el doc.
+- Vas a hacer una operación delicada y quieres releer las reglas exactas (e.g. crear una tabla, escribir un hook, editar el header).
+
+Parámetros:
+- name: id del doc (sin extensión). Ejemplos: '01-builder-fields', '05-tables-and-fields', '09-mcp-tools-reference'. Usa 'list_docs' si dudas del id.
+- section: opcional. Match case-insensitive y parcial sobre headings H2 ('## ...'). Devuelve desde el heading hasta el siguiente H2.
+
+Si la sección no existe, la respuesta incluye 'available_sections' para que reintentes con un nombre válido.
+
+Docs disponibles (resumen):
+- 01-builder-fields — Campos editables (data-field-type), atributos Acai (c-if, c-for, c-class), c-form, componentes built-in.
+- 02-twig — Filtros Twig (get, queryDB, hook, module, imagec, translate, raw).
+- 03-modules-and-sections — Módulos vs secciones generales, thisrecord, multiv2, custom-{tableName}.
+- 04-pages-and-records — Builder vs Standard, menuType, apartados, reglas sobre enlace/controlador.
+- 05-tables-and-fields — Schema, create_table, create_field, tipos de campo, casos destructivos.
+- 06-hooks-and-cmsapi — Hooks PHP, CmsApi/CocoDB, hook middleware.
+- 07-css-js-conventions — Tailwind+BEM, scoping, Vue 3, componentes nativos.
+- 08-layout-and-libraries — get/set_layout_field, librerías globales, regla de no editar layout.json.
+- 09-mcp-tools-reference — Inventario completo + workflows canónicos.
+- 10-production-patterns — Patrones reales (cabecera, zigzag, FAQ, formulario, detalle).
+- 11-quick-reference — Cheat sheet con todas las reglas y formatos.`,
+        {
+            name: z.string().describe("ID del doc sin extensión (e.g. '05-tables-and-fields')"),
+            section: z.string().optional().describe("Heading H2 a extraer (case-insensitive, parcial). Omitir para leer el doc completo."),
+        },
+        { readOnlyHint: true, destructiveHint: false },
+        async ({ name, section }) => {
+            try {
+                const validationError = validateRequired({ name }, ["name"], "read_doc");
+                if (validationError) return validationError;
+
+                const data = await readDoc(name, section);
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify(data, null, 2),
+                    }],
+                };
+            } catch (error) {
+                if (error?.code === "DOC_NOT_FOUND") {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: error.message,
+                                hint: "Usa 'list_docs' para ver los ids disponibles. Los ids tienen prefijo numérico (e.g. '05-tables-and-fields').",
+                            }, null, 2),
+                        }],
+                        isError: true,
+                    };
+                }
+                return handleToolError(error, "read_doc", { name, section });
+            }
+        }
+    );
+}

mcp-server/tools/files/delete.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { handleToolError, validateRequired } from "../helpers/errorHandler.js";
 import { getCurrentProjectInfo, callLocalFileEndpoint, buildLocalFileErrorResponse } from "./helpers.js";
+import { isProtectedLayoutPath, buildProtectedLayoutPathError } from "./protectedPaths.js";
 
 export function registerAcaiDeleteTool(server) {
     server.tool(
@@ -16,6 +17,10 @@ export function registerAcaiDeleteTool(server) {
                 const validationError = validateRequired({ file_path }, ["file_path"], "acai-delete");
                 if (validationError) return validationError;
 
+                if (isProtectedLayoutPath(file_path)) {
+                    return buildProtectedLayoutPathError(file_path);
+                }
+
                 const { projectSlug, projectDir } = getCurrentProjectInfo();
                 const result = await callLocalFileEndpoint("POST", "/api/files/delete", {
                     project: projectSlug,

mcp-server/tools/files/helpers.js

@@ -1,9 +1,31 @@
 import axios from "axios";
 import path from "path";
 import { LOCAL_SERVER_URL, getLocalServerHeaders } from "../../config/index.js";
+import { getCurrentSessionId } from "../../utils/sessionContext.js";
+import { getMcpSessionCredentials } from "../../auth/credentials.js";
+import { resolveCurrentAcaiUser } from "../helpers/sessionHelpers.js";
+
+/**
+ * Resuelve `project_dir` para la tool en curso.
+ *
+ * Orden de precedencia:
+ *   1. AsyncLocalStorage (mcpSessionId) -> credenciales de la sesion HTTP
+ *   2. process.env.ACAI_PROJECT_DIR (modo stdio / fallback legacy)
+ *
+ * Devuelve string vacio si no hay forma de resolverlo — el caller decide
+ * como manejar el error.
+ */
+export function resolveCurrentProjectDir() {
+    const sessionId = getCurrentSessionId();
+    if (sessionId) {
+        const creds = getMcpSessionCredentials(sessionId);
+        if (creds?.project_dir) return creds.project_dir;
+    }
+    return process.env.ACAI_PROJECT_DIR || "";
+}
 
 export function getCurrentProjectInfo() {
-    const projectDir = process.env.ACAI_PROJECT_DIR || "";
+    const projectDir = resolveCurrentProjectDir();
     if (!projectDir) {
         throw new Error("ACAI_PROJECT_DIR not set");
     }
@@ -15,6 +37,11 @@ export function getCurrentProjectInfo() {
 
 export async function callLocalFileEndpoint(method, endpoint, payload = null, query = null) {
     const headers = getLocalServerHeaders();
+    // Inyectar X-Acai-User cuando hay sesion HTTP activa: permite que los
+    // endpoints autenticados del server Python identifiquen al usuario sin
+    // depender de Authorization Basic.
+    const acaiUser = resolveCurrentAcaiUser();
+    if (acaiUser) headers["X-Acai-User"] = acaiUser;
     if (method === "GET") {
         const response = await axios.get(`${LOCAL_SERVER_URL}${endpoint}`, {
             params: query || undefined,

mcp-server/tools/files/index.js

@@ -4,12 +4,17 @@ import { registerAcaiLineReplaceTool } from "./lineReplace.js";
 import { registerAcaiDeleteTool } from "./delete.js";
 import { registerAcaiGlobTool } from "./glob.js";
 import { registerAcaiGrepTool } from "./grep.js";
+import { canEditCode } from "../helpers/roleCheck.js";
 
 export function registerFileTools(server) {
+    // Lectura: siempre disponible
     registerAcaiViewTool(server);
     registerAcaiGlobTool(server);
     registerAcaiGrepTool(server);
+    // Escritura: solo si el rol puede editar codigo
+    if (canEditCode()) {
         registerAcaiWriteTool(server);
         registerAcaiLineReplaceTool(server);
         registerAcaiDeleteTool(server);
+    }
 }

mcp-server/tools/files/lineReplace.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { handleToolError, validateRequired } from "../helpers/errorHandler.js";
 import { getCurrentProjectInfo, callLocalFileEndpoint, buildLocalFileErrorResponse } from "./helpers.js";
+import { isProtectedLayoutPath, buildProtectedLayoutPathError } from "./protectedPaths.js";
 
 export function registerAcaiLineReplaceTool(server) {
     server.tool(
@@ -24,6 +25,10 @@ export function registerAcaiLineReplaceTool(server) {
                 );
                 if (validationError) return validationError;
 
+                if (isProtectedLayoutPath(file_path)) {
+                    return buildProtectedLayoutPathError(file_path);
+                }
+
                 const { projectSlug, projectDir } = getCurrentProjectInfo();
                 const result = await callLocalFileEndpoint("POST", "/api/files/line-replace", {
                     project: projectSlug,

mcp-server/tools/files/protectedPaths.js

@@ -0,0 +1,39 @@
+// Shared guard for generated layout artifacts. The global layout.json and the
+// custom-header/custom-footer module folders are regenerated from the layout
+// pipeline (see set_layout_field). Editing them directly leaves the JSON source
+// out of sync and the visual builder overwrites the agent changes on next save.
+
+const PROTECTED_LAYOUT_PATHS = [
+    "cms/lib/plugins/builder_saas/layout.json",
+    "template/estandar/modulos/custom-header-twig/",
+    "template/estandar/modulos/custom-footer-twig/",
+    "template/estandar/modulos/custom-header/",
+    "template/estandar/modulos/custom-footer/",
+];
+
+// Returns true when `relPath` points at the layout.json or any of the
+// generated custom-{header,footer}[-twig] module folders.
+export function isProtectedLayoutPath(relPath) {
+    if (!relPath) return false;
+    const norm = String(relPath).replace(/^\/+/, "");
+    return PROTECTED_LAYOUT_PATHS.some(p => {
+        // Folder entries end with "/" -> prefix match on the normalized path.
+        // File entries (no trailing slash) -> exact match only.
+        if (p.endsWith("/")) return norm === p.slice(0, -1) || norm.startsWith(p);
+        return norm === p;
+    });
+}
+
+// Builds a consistent MCP error response pointing the agent to set_layout_field.
+export function buildProtectedLayoutPathError(relPath) {
+    return {
+        content: [{
+            type: "text",
+            text: JSON.stringify({
+                success: false,
+                error: `Forbidden path: ${relPath} is a generated artifact of the global layout. Use set_layout_field instead with field='header' (for custom-header-twig) or field='footer' (for custom-footer-twig).`,
+            }, null, 2),
+        }],
+        isError: true,
+    };
+}

mcp-server/tools/files/write.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { handleToolError, validateRequired } from "../helpers/errorHandler.js";
 import { getCurrentProjectInfo, callLocalFileEndpoint, buildLocalFileErrorResponse } from "./helpers.js";
+import { isProtectedLayoutPath, buildProtectedLayoutPathError } from "./protectedPaths.js";
 
 export function registerAcaiWriteTool(server) {
     server.tool(
@@ -23,6 +24,10 @@ Before writing, check the matching documentation for the file type:
                 const validationError = validateRequired({ file_path }, ["file_path"], "acai-write");
                 if (validationError) return validationError;
 
+                if (isProtectedLayoutPath(file_path)) {
+                    return buildProtectedLayoutPathError(file_path);
+                }
+
                 const { projectSlug, projectDir } = getCurrentProjectInfo();
                 const result = await callLocalFileEndpoint("POST", "/api/files/write", {
                     project: projectSlug,

mcp-server/tools/helpers/acaiHttpClient.js

@@ -501,50 +501,6 @@ export class FormParamsBuilder {
         return params;
     }
 
-    static buildTableCreateParams(menuName, tableName, type, enlace, seo_metas, menuOrder) {
-        return new URLSearchParams({
-            menu: "database",
-            _defaultAction: "addTable_save",
-            type: type,
-            preset: "",
-            enlace: enlace ? "on" : "",
-            seo_metas: seo_metas ? "on" : "",
-            menuName: menuName,
-            menuOrder: menuOrder.toString(),
-            tableName: tableName
-        });
-    }
-
-    static buildTableDeleteParams(tableName) {
-        const params = new URLSearchParams();
-        params.append('menu', 'database');
-        params.append('action', 'editTable');
-        params.append('dropTable', '1');
-        params.append('tableName', tableName);
-        return params;
-    }
-
-    static buildFieldEditParams(tableName, multipleFields) {
-        const params = new URLSearchParams();
-        params.append('menu', 'database');
-        params.append('_defaultAction', 'editTable');
-        params.append('editField', '1');
-        params.append('tableName', tableName);
-        params.append('save', '1');
-        params.append('multipleFields', JSON.stringify(multipleFields));
-        return params;
-    }
-
-    static buildFieldDeleteParams(tableName, fieldname) {
-        const params = new URLSearchParams();
-        params.append('menu', 'database');
-        params.append('action', 'editTable');
-        params.append('editField', '1');
-        params.append('tableName', tableName);
-        params.append('fieldname', fieldname);
-        params.append('deleteField', '1');
-        return params;
-    }
 }
 
 /**

mcp-server/tools/helpers/accessControl.js

@@ -0,0 +1,52 @@
+import fs from 'fs';
+import path from 'path';
+import { resolveCurrentProjectDir } from '../files/helpers.js';
+
+/**
+ * Check if the current user has write access to a table.
+ * Reads .acai file from ACAI_PROJECT_DIR.
+ * Returns { allowed: true } or { allowed: false, error: "..." }
+ *
+ * NOTA: Esta funcion NO depende del campo `mode`. En modo produccion los
+ * registros de tablas (contenido CMS) se siguen pudiendo editar — son los
+ * datos reales del usuario, no codigo. El bloqueo de produccion solo aplica
+ * a escritura de archivos de codigo (gestionado por is_project_admin en el
+ * server Python al recibir POST /api/files/*).
+ *
+ * Si existe ACAI_MODE_OVERRIDE en el entorno (cronjob con override), se usa
+ * en lugar del .acai para determinar el modo.
+ */
+export function canAccessTable(tableName) {
+    const projectDir = resolveCurrentProjectDir();
+    if (!projectDir) return { allowed: true }; // no project dir, don't block
+
+    const acaiFile = path.join(projectDir, ".acai");
+    try {
+        if (!fs.existsSync(acaiFile)) return { allowed: true };
+        const data = JSON.parse(fs.readFileSync(acaiFile, "utf-8"));
+        // Override de modo (cronjobs lo inyectan via env var)
+        if (process.env.ACAI_MODE_OVERRIDE) {
+            data.mode = process.env.ACAI_MODE_OVERRIDE;
+        }
+        const user = data.user || {};
+
+        // Admin has full access
+        if (user.isAdmin === "1" || user.isAdmin === 1) return { allowed: true };
+
+        const accessList = user.accessList || {};
+        if (!accessList || Object.keys(accessList).length === 0) return { allowed: true };
+
+        // all.accessLevel >= 9 means full access
+        const allAccess = parseInt(accessList.all?.accessLevel || "0");
+        if (allAccess >= 9) return { allowed: true };
+
+        // Check specific table (without cms_ prefix)
+        const bare = tableName.replace(/^cms_/, "");
+        const entry = accessList[bare];
+        if (entry && parseInt(entry.accessLevel || "0") > 0) return { allowed: true };
+
+        return { allowed: false, error: `No tienes acceso a la tabla '${bare}'` };
+    } catch (e) {
+        return { allowed: true }; // On error, don't block
+    }
+}

mcp-server/tools/helpers/pythonServerClient.js

@@ -0,0 +1,45 @@
+import axios from "axios";
+import { resolveCurrentAcaiUser } from "./sessionHelpers.js";
+
+const PYTHON_BASE = `http://app:${process.env.ACAI_PORT || 9091}`;
+
+/**
+ * Construye el set de headers comunes para llamadas al server Python interno.
+ * Inyecta automaticamente `X-Acai-User` cuando hay sesion MCP activa con
+ * `acai_user` conocido, lo que permite a los endpoints autenticados identificar
+ * al usuario sin Authorization Basic.
+ */
+function buildPythonHeaders(extra = {}) {
+    const authHeader = process.env.ACAI_AUTH_HEADER || "";
+    const mode = process.env.ACAI_MODE_OVERRIDE || process.env.ACAI_MODE || "";
+    const role = process.env.ACAI_ROLE_OVERRIDE || "";
+    const acaiUser = resolveCurrentAcaiUser();
+
+    return {
+        "Content-Type": "application/json",
+        ...(authHeader ? { "Authorization": authHeader } : {}),
+        ...(mode ? { "X-Acai-Mode": mode } : {}),
+        ...(role ? { "X-Acai-Role": role } : {}),
+        ...(acaiUser ? { "X-Acai-User": acaiUser } : {}),
+        ...extra,
+    };
+}
+
+export async function pythonPost(path, data, timeout = 120000) {
+    const response = await axios.post(`${PYTHON_BASE}${path}`, data, {
+        headers: buildPythonHeaders(),
+        timeout,
+        maxBodyLength: Infinity,
+        maxContentLength: Infinity,
+    });
+    return response.data;
+}
+
+export async function pythonGet(path, params = null, timeout = 30000) {
+    const response = await axios.get(`${PYTHON_BASE}${path}`, {
+        params: params || undefined,
+        headers: buildPythonHeaders(),
+        timeout,
+    });
+    return response.data;
+}

mcp-server/tools/helpers/roleCheck.js

@@ -0,0 +1,24 @@
+/**
+ * Helper central para determinar el rol efectivo del MCP y bloquear tools
+ * peligrosas cuando el user es "editor".
+ *
+ * El rol se recibe principalmente via env var ACAI_ROLE_OVERRIDE inyectada
+ * por el backend Python (agentic.py y cronjobs.py). Hay autoderivacion
+ * defensiva en caso de que alguien lance el MCP sin el override:
+ * - Si ACAI_MODE(_OVERRIDE) = "production" → rol editor por defecto.
+ * - Si no → rol developer.
+ */
+export function getEffectiveRole() {
+    if (process.env.ACAI_ROLE_OVERRIDE) return process.env.ACAI_ROLE_OVERRIDE;
+    if (process.env.ACAI_MODE_OVERRIDE === "production") return "editor";
+    if (process.env.ACAI_MODE === "production") return "editor";
+    return "developer";
+}
+
+/**
+ * True si el rol efectivo puede editar archivos de codigo.
+ * Los roles permitidos son todo lo que NO sea "editor".
+ */
+export function canEditCode() {
+    return getEffectiveRole() !== "editor";
+}

mcp-server/tools/helpers/sessionHelpers.js

@@ -0,0 +1,27 @@
+/**
+ * Helpers reutilizables para resolver datos derivados de la sesion MCP en curso.
+ *
+ * Usan AsyncLocalStorage (`utils/sessionContext.js`) para recuperar el
+ * `mcpSessionId` activo y leer informacion asociada desde
+ * `auth/credentials.js`. En modo stdio (sin HTTP) devuelven `null` y el caller
+ * decide como actuar.
+ */
+import { getCurrentSessionId } from "../../utils/sessionContext.js";
+import { getMcpSessionCredentials } from "../../auth/credentials.js";
+
+/**
+ * Recupera el `acai_user` de la sesion HTTP activa (si existe).
+ *
+ * Se usa para inyectar el header `X-Acai-User` en llamadas al server Python,
+ * evitando asi depender de Authorization Basic y permitiendo que los endpoints
+ * autenticados (p.ej. `/api/generate-image`, `/api/files/write`) identifiquen
+ * al usuario propietario del proyecto.
+ *
+ * @returns {string|null}
+ */
+export function resolveCurrentAcaiUser() {
+    const sessionId = getCurrentSessionId();
+    if (!sessionId) return null;
+    const creds = getMcpSessionCredentials(sessionId);
+    return creds?.acai_user || null;
+}

mcp-server/tools/hooks/index.js

@@ -0,0 +1,144 @@
+import { z } from "zod";
+import { withAuth } from "../../auth/index.js";
+import { withAuthParams } from "../helpers/authSchema.js";
+import { handleToolError } from "../helpers/errorHandler.js";
+import { pythonGet, pythonPost } from "../helpers/pythonServerClient.js";
+import { getCurrentProjectInfo } from "../files/helpers.js";
+import { canEditCode } from "../helpers/roleCheck.js";
+
+/**
+ * Tools para leer/escribir el `middleWare` de hooks globales del layout.
+ *
+ * El middleware vive en `layout.json["hooks"][i].middleWare` y determina cuando
+ * un hook global se ejecuta automaticamente antes de renderizar paginas:
+ *   - []                              → solo cuando se llama explicitamente.
+ *   - ["allurls"]                     → antes de cada URL del sitio.
+ *   - ["<tableName>-<num>", ...]      → solo antes de ciertos registros.
+ */
+
+function registerGetHookMiddlewareTool(server) {
+    server.tool(
+        "get_hook_middleware",
+        `Check which pages trigger a global hook as middleware. Middleware config determines whether the hook runs automatically BEFORE rendering specific pages (or all pages). Returns the list of middleware entries.
+
+Use this when the user asks about hook behavior or to verify config before changing it.
+
+hookEndPoint format: starts and ends with '/', with '/' as separator. E.g. file "hooks/hooks.parse_styles.php" → endPoint "/hooks/parse_styles/".
+
+Returns:
+- middleWare: [] → hook only runs on explicit call (<hook>, Twig filter, CmsApi).
+- middleWare: ["allurls"] → runs before every page.
+- middleWare: ["cms_apartados-8", ...] → runs before those specific records ("<tableName>-<num>").`,
+        withAuthParams({
+            hookEndPoint: z.string().describe('Hook endpoint path, e.g. "/hooks/parse_styles/"'),
+        }),
+        { readOnlyHint: true, destructiveHint: false },
+        withAuth(async ({ hookEndPoint }, extra) => {
+            try {
+                const { projectSlug } = getCurrentProjectInfo();
+                const result = await pythonGet("/api/creator/hook-middleware", {
+                    project: projectSlug,
+                    endPoint: hookEndPoint,
+                });
+                if (!result?.success) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: result?.error || "No se pudo leer el middleware",
+                            }),
+                        }],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            exists: !!result.exists,
+                            middleWare: result.middleWare || [],
+                            hookEndPoint,
+                        }, null, 2),
+                    }],
+                };
+            } catch (error) {
+                return handleToolError(error, "get_hook_middleware", { hookEndPoint });
+            }
+        })
+    );
+}
+
+function registerSetHookMiddlewareTool(server) {
+    server.tool(
+        "set_hook_middleware",
+        `Configure when a global hook runs automatically (middleware). This updates layout.json['hooks'][i].middleWare for the hook matching hookEndPoint.
+
+Use this AFTER creating or editing a hook file (via acai-write) if the hook should execute BEFORE rendering specific pages. The hook file alone is not enough — the file exists but won't auto-run as middleware without this config.
+
+middleWare values:
+- []           → hook runs only when called explicitly (default for new hooks).
+- ["allurls"]  → runs before every page of the site.
+- ["<tableName>-<num>", ...] → runs before specific records. Get num+tableName from the CMS records.
+
+Examples:
+- Redirect logic that must run on the homepage only: middleWare=["cms_apartados-2"] (assuming num=2 is home).
+- Global analytics injection: middleWare=["allurls"].
+- Just a reusable utility hook called from modules/twig: middleWare=[] (default).`,
+        withAuthParams({
+            hookEndPoint: z.string().describe('Hook endpoint path, e.g. "/hooks/parse_styles/"'),
+            middleWare: z.array(z.string()).describe('Array de strings. Vacio, ["allurls"], o ["<tableName>-<num>", ...]'),
+        }),
+        { readOnlyHint: false, destructiveHint: false },
+        withAuth(async ({ hookEndPoint, middleWare }, extra) => {
+            try {
+                const { projectSlug } = getCurrentProjectInfo();
+                const result = await pythonPost("/api/creator/hook-middleware", {
+                    project: projectSlug,
+                    endPoint: hookEndPoint,
+                    middleWare,
+                });
+                if (!result?.success) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: result?.error || "No se pudo guardar",
+                            }),
+                        }],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: "Middleware actualizado",
+                            middleWare: result.middleWare || [],
+                            hookEndPoint,
+                        }, null, 2),
+                    }],
+                };
+            } catch (error) {
+                return handleToolError(error, "set_hook_middleware", { hookEndPoint, middleWare });
+            }
+        })
+    );
+}
+
+/**
+ * Registra las tools de configuracion de hooks globales.
+ *
+ * `get_hook_middleware` es de solo lectura y se registra siempre. El set
+ * modifica el layout y solo se expone si el rol puede editar codigo — sigue
+ * el mismo criterio que otras tools de escritura (ver project/index.js).
+ */
+export function registerHookTools(server) {
+    registerGetHookMiddlewareTool(server);
+    if (canEditCode()) {
+        registerSetHookMiddlewareTool(server);
+    }
+}

mcp-server/tools/index.js

@@ -7,6 +7,10 @@ import { registerRemoteGitTools } from './remote_git/index.js';
 import { registerNavigationTools } from './navigation/index.js';
 import { registerProjectTools } from './project/index.js';
 import { registerFileTools } from './files/index.js';
+import { registerHookTools } from './hooks/index.js';
+import { registerLibrariesTools } from './libraries/index.js';
+import { registerLayoutTools } from './layout/index.js';
+import { registerDocsTools } from './docs/index.js';
 
 /**
  * Register all tools on the MCP server
@@ -21,4 +25,8 @@ export function registerTools(server) {
 	registerNavigationTools(server);
 	registerProjectTools(server);
 	registerFileTools(server);
+	registerHookTools(server);
+	registerLibrariesTools(server);
+	registerLayoutTools(server);
+	registerDocsTools(server);
 }

mcp-server/tools/layout/get_layout_field.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { withAuth } from "../../auth/index.js";
+import { withAuthParams } from "../helpers/authSchema.js";
+import { handleToolError } from "../helpers/errorHandler.js";
+import { pythonGet } from "../helpers/pythonServerClient.js";
+import { getCurrentProjectInfo } from "../files/helpers.js";
+
+// Tool: get_layout_field
+// Reads a global layout field (style or javascript) from the project's layout.json
+// via the Python endpoint. Read-only — delegates to the backend which parses
+// layout.json and returns the raw content string plus layoutExists flag.
+
+export function registerGetLayoutFieldTool(server) {
+    server.tool(
+        "get_layout_field",
+        `Get the content of a global layout field: 'style', 'javascript', 'header' or 'footer'. For header/footer this is the source of truth — the .tpl files in template/estandar/modulos/custom-{header,footer}-twig/ are generated artifacts. Always prefer this over acai-view on those .tpl files when you need to read the global header/footer source.`,
+        withAuthParams({
+            field: z.enum(["style", "javascript", "header", "footer"]).describe("Which layout field: 'style', 'javascript', 'header' or 'footer'"),
+        }),
+        { readOnlyHint: true, destructiveHint: false },
+        withAuth(async ({ field }, _extra) => {
+            try {
+                const { projectSlug } = getCurrentProjectInfo();
+                const result = await pythonGet("/api/project/layout-field", {
+                    project: projectSlug,
+                    field,
+                });
+                if (!result?.success) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: result?.error || "Could not read layout field",
+                            }),
+                        }],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            field: result.field || field,
+                            content: result.content || "",
+                            layoutExists: !!result.layoutExists,
+                        }, null, 2),
+                    }],
+                };
+            } catch (error) {
+                return handleToolError(error, "get_layout_field", { field });
+            }
+        })
+    );
+}

mcp-server/tools/layout/index.js

@@ -0,0 +1,15 @@
+import { canEditCode } from "../helpers/roleCheck.js";
+import { registerGetLayoutFieldTool } from "./get_layout_field.js";
+import { registerSetLayoutFieldTool } from "./set_layout_field.js";
+
+/**
+ * Tools to read/write global layout fields (style, javascript) of the project.
+ * The read tool is always exposed (read only); the mutating tool is gated by
+ * canEditCode() — same pattern used by libraries/ and hooks/.
+ */
+export function registerLayoutTools(server) {
+    registerGetLayoutFieldTool(server); // read-only, todos
+    if (canEditCode()) {
+        registerSetLayoutFieldTool(server);
+    }
+}

mcp-server/tools/layout/set_layout_field.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import { withAuth } from "../../auth/index.js";
+import { withAuthParams } from "../helpers/authSchema.js";
+import { handleToolError } from "../helpers/errorHandler.js";
+import { pythonPost } from "../helpers/pythonServerClient.js";
+import { getCurrentProjectInfo } from "../files/helpers.js";
+
+// Tool: set_layout_field
+// Replaces the content of a global layout field (style or javascript) in the
+// project's layout.json. Destructive — overwrites the existing content. The
+// backend enforces a 500KB size limit and returns 400 if exceeded; that error
+// is propagated via handleToolError.
+
+export function registerSetLayoutFieldTool(server) {
+    server.tool(
+        "set_layout_field",
+        `Replace the content of a global layout field: 'style' (CSS), 'javascript' (JS), 'header' (Twig source of the site header), 'footer' (Twig source). CRITICAL: for header/footer, ALWAYS use this tool instead of editing template/estandar/modulos/custom-header-twig/index-base.tpl or custom-footer-twig/index-base.tpl directly with acai-line-replace or acai-write. Editing those .tpl files directly leaves layout.json.{header,footer} out of sync and the visual builder will overwrite your changes on its next save. This tool writes the source, syncs layout.json, regenerates the compiled module files, and runs the TWIG compilation in one atomic pipeline. Destructive: overwrites the full content. Pair with get_layout_field first to read the current source.`,
+        withAuthParams({
+            field: z.enum(["style", "javascript", "header", "footer"]).describe("Which layout field: 'style', 'javascript', 'header' or 'footer'"),
+            content: z.string().describe("Full replacement content. Max 500KB."),
+        }),
+        { readOnlyHint: false, destructiveHint: true },
+        withAuth(async ({ field, content }, _extra) => {
+            try {
+                const { projectSlug } = getCurrentProjectInfo();
+                const result = await pythonPost("/api/project/layout-field/save", {
+                    project: projectSlug,
+                    field,
+                    content,
+                });
+                if (!result?.success) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: result?.error || "Could not save layout field",
+                            }),
+                        }],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            field: result.field || field,
+                        }, null, 2),
+                    }],
+                };
+            } catch (error) {
+                return handleToolError(error, "set_layout_field", {
+                    field,
+                    contentLength: typeof content === "string" ? content.length : 0,
+                });
+            }
+        })
+    );
+}

mcp-server/tools/libraries/add_global_library.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { withAuth } from "../../auth/index.js";
+import { withAuthParams } from "../helpers/authSchema.js";
+import { handleToolError } from "../helpers/errorHandler.js";
+import { pythonGet, pythonPost } from "../helpers/pythonServerClient.js";
+import { getCurrentProjectInfo } from "../files/helpers.js";
+
+// Tool: add_global_library
+// Appends a URL to a section (top or bottom) of the project's global libraries.
+// Idempotent: if the URL already exists in the target section (trim-compare),
+// the list is left untouched and added:false is returned.
+
+export function registerAddGlobalLibraryTool(server) {
+    server.tool(
+        "add_global_library",
+        `Add a URL to the project's global libraries. section='top' injects in <head> (CSS, fonts, critical JS); section='bottom' injects before </body> (most JS). Idempotent with dedupe — if the URL already exists in that section, returns added:false.`,
+        withAuthParams({
+            section: z.enum(["top", "bottom"]).describe("Where to inject: 'top' = <head>, 'bottom' = before </body>"),
+            url: z.string().min(1).describe("Absolute URL (https://…) or project-relative path (/js/foo.js)"),
+        }),
+        { readOnlyHint: false, destructiveHint: false },
+        withAuth(async ({ section, url }, _extra) => {
+            try {
+                const { projectSlug } = getCurrentProjectInfo();
+
+                // 1. Read current state from Python.
+                const current = await pythonGet("/api/project/libraries", {
+                    project: projectSlug,
+                });
+                if (!current?.success) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: current?.error || "Could not read current libraries",
+                            }),
+                        }],
+                        isError: true,
+                    };
+                }
+
+                const sectionList = Array.isArray(current[section]) ? current[section] : [];
+                const trimmedUrl = String(url).trim();
+
+                // 2. Dedupe: trim-compare URL against existing entries.
+                const exists = sectionList.some(
+                    (entry) => String(entry?.url || "").trim() === trimmedUrl
+                );
+                if (exists) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: true,
+                                added: false,
+                                reason: "already present",
+                                section,
+                                entries: sectionList,
+                            }, null, 2),
+                        }],
+                    };
+                }
+
+                // 3. Append new entry. Backend normalizes to { num, url }.
+                const nextList = [...sectionList, { url: trimmedUrl }];
+
+                // 4. Persist via save endpoint.
+                const saveResult = await pythonPost("/api/project/libraries/save", {
+                    project: projectSlug,
+                    section,
+                    libraries: nextList,
+                });
+                if (!saveResult?.success) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: saveResult?.error || "Could not save libraries",
+                            }),
+                        }],
+                        isError: true,
+                    };
+                }
+
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            added: true,
+                            section,
+                            entries: saveResult.libraries || [],
+                        }, null, 2),
+                    }],
+                };
+            } catch (error) {
+                return handleToolError(error, "add_global_library", { section, url });
+            }
+        })
+    );
+}

mcp-server/tools/libraries/index.js

@@ -0,0 +1,20 @@
+import { canEditCode } from "../helpers/roleCheck.js";
+import { registerListGlobalLibrariesTool } from "./list_global_libraries.js";
+import { registerAddGlobalLibraryTool } from "./add_global_library.js";
+import { registerRemoveGlobalLibraryTool } from "./remove_global_library.js";
+import { registerSetGlobalLibrariesTool } from "./set_global_libraries.js";
+
+/**
+ * Tools to manage the project's global libraries (CSS/JS/fonts) that are
+ * injected site-wide via layout.json. The list tool is always exposed (read
+ * only); mutating tools are gated by canEditCode() — same pattern used by
+ * hooks/ and project/ writers.
+ */
+export function registerLibrariesTools(server) {
+    registerListGlobalLibrariesTool(server);
+    if (canEditCode()) {
+        registerAddGlobalLibraryTool(server);
+        registerRemoveGlobalLibraryTool(server);
+        registerSetGlobalLibrariesTool(server);
+    }
+}

mcp-server/tools/libraries/list_global_libraries.js

@@ -0,0 +1,62 @@
+import { withAuth } from "../../auth/index.js";
+import { withAuthParams } from "../helpers/authSchema.js";
+import { handleToolError } from "../helpers/errorHandler.js";
+import { pythonGet } from "../helpers/pythonServerClient.js";
+import { getCurrentProjectInfo } from "../files/helpers.js";
+
+// Tool: list_global_libraries
+// Lists the global libraries (CSS/JS/fonts) injected in <head> and before </body>
+// for the current Acai project. Use this before add/remove to inspect the current
+// state. Read-only — delegates to the Python endpoint which parses layout.json.
+
+export function registerListGlobalLibrariesTool(server) {
+    server.tool(
+        "list_global_libraries",
+        `List the project's global libraries (CSS/JS/fonts injected site-wide).
+
+Returns two sections:
+- top: entries injected inside <head> (CSS, preloaded fonts, critical JS).
+- bottom: entries injected right before </body> (most JS).
+
+Each entry is { num, url } where num is the internal index used by the CMS.
+Also returns layoutExists to signal whether layout.json exists for the project.
+
+Use this before add_global_library / remove_global_library to verify current state
+or to check whether a library is already registered.`,
+        withAuthParams({}),
+        { readOnlyHint: true, destructiveHint: false },
+        withAuth(async (_args, _extra) => {
+            try {
+                const { projectSlug } = getCurrentProjectInfo();
+                const result = await pythonGet("/api/project/libraries", {
+                    project: projectSlug,
+                });
+                if (!result?.success) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: result?.error || "Could not read libraries",
+                            }),
+                        }],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            top: result.top || [],
+                            bottom: result.bottom || [],
+                            layoutExists: !!result.layoutExists,
+                        }, null, 2),
+                    }],
+                };
+            } catch (error) {
+                return handleToolError(error, "list_global_libraries", {});
+            }
+        })
+    );
+}

mcp-server/tools/libraries/remove_global_library.js

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import { withAuth } from "../../auth/index.js";
+import { withAuthParams } from "../helpers/authSchema.js";
+import { handleToolError } from "../helpers/errorHandler.js";
+import { pythonGet, pythonPost } from "../helpers/pythonServerClient.js";
+import { getCurrentProjectInfo } from "../files/helpers.js";
+
+// Tool: remove_global_library
+// Removes a URL from a section (top or bottom) of the project's global
+// libraries. Idempotent: if the URL isn't present, the list is left untouched
+// and removed:false is returned.
+
+export function registerRemoveGlobalLibraryTool(server) {
+    server.tool(
+        "remove_global_library",
+        `Remove a URL from the project's global libraries. Idempotent — if the URL isn't present, returns removed:false.`,
+        withAuthParams({
+            section: z.enum(["top", "bottom"]).describe("Target section: 'top' = <head>, 'bottom' = before </body>"),
+            url: z.string().min(1).describe("Absolute URL or project-relative path to remove"),
+        }),
+        { readOnlyHint: false, destructiveHint: false },
+        withAuth(async ({ section, url }, _extra) => {
+            try {
+                const { projectSlug } = getCurrentProjectInfo();
+
+                // 1. Read current state from Python.
+                const current = await pythonGet("/api/project/libraries", {
+                    project: projectSlug,
+                });
+                if (!current?.success) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: current?.error || "Could not read current libraries",
+                            }),
+                        }],
+                        isError: true,
+                    };
+                }
+
+                const sectionList = Array.isArray(current[section]) ? current[section] : [];
+                const trimmedUrl = String(url).trim();
+
+                // 2. Filter out entries matching the URL (trim-compare).
+                const nextList = sectionList.filter(
+                    (entry) => String(entry?.url || "").trim() !== trimmedUrl
+                );
+
+                // 3. If nothing changed → not found, no-op.
+                if (nextList.length === sectionList.length) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: true,
+                                removed: false,
+                                reason: "not found",
+                                section,
+                                entries: sectionList,
+                            }, null, 2),
+                        }],
+                    };
+                }
+
+                // 4. Persist via save endpoint.
+                const saveResult = await pythonPost("/api/project/libraries/save", {
+                    project: projectSlug,
+                    section,
+                    libraries: nextList,
+                });
+                if (!saveResult?.success) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: saveResult?.error || "Could not save libraries",
+                            }),
+                        }],
+                        isError: true,
+                    };
+                }
+
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            removed: true,
+                            section,
+                            entries: saveResult.libraries || [],
+                        }, null, 2),
+                    }],
+                };
+            } catch (error) {
+                return handleToolError(error, "remove_global_library", { section, url });
+            }
+        })
+    );
+}

mcp-server/tools/libraries/set_global_libraries.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { withAuth } from "../../auth/index.js";
+import { withAuthParams } from "../helpers/authSchema.js";
+import { handleToolError } from "../helpers/errorHandler.js";
+import { pythonPost } from "../helpers/pythonServerClient.js";
+import { getCurrentProjectInfo } from "../files/helpers.js";
+
+// Tool: set_global_libraries
+// Replaces the entire list of libraries for a section. Destructive — overwrites
+// everything. Prefer add/remove for incremental edits; use this for bulk reorder
+// or full replacement.
+
+export function registerSetGlobalLibrariesTool(server) {
+    server.tool(
+        "set_global_libraries",
+        `Replace the entire list of libraries for a section. Destructive — overwrites all existing entries. Prefer add/remove for incremental edits. Use for bulk reorder/replace.`,
+        withAuthParams({
+            section: z.enum(["top", "bottom"]).describe("Target section: 'top' = <head>, 'bottom' = before </body>"),
+            libraries: z.array(z.object({
+                url: z.string().min(1),
+            })).describe("Full replacement list. Order is preserved."),
+        }),
+        { readOnlyHint: false, destructiveHint: true },
+        withAuth(async ({ section, libraries }, _extra) => {
+            try {
+                const { projectSlug } = getCurrentProjectInfo();
+
+                const saveResult = await pythonPost("/api/project/libraries/save", {
+                    project: projectSlug,
+                    section,
+                    libraries,
+                });
+                if (!saveResult?.success) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: saveResult?.error || "Could not save libraries",
+                            }),
+                        }],
+                        isError: true,
+                    };
+                }
+
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            section: saveResult.section || section,
+                            entries: saveResult.libraries || [],
+                        }, null, 2),
+                    }],
+                };
+            } catch (error) {
+                return handleToolError(error, "set_global_libraries", { section, count: Array.isArray(libraries) ? libraries.length : 0 });
+            }
+        })
+    );
+}

mcp-server/tools/media/generateImage.js

@@ -2,22 +2,17 @@ import { z } from "zod";
 import axios from "axios";
 import fs from "fs";
 import path from "path";
-import sharp from "sharp";
-import { withAuth, getSessionCredentials } from "../../auth/index.js";
+import { withAuth } from "../../auth/index.js";
 import { handleToolError } from "../helpers/errorHandler.js";
 import { withAuthParams } from "../helpers/authSchema.js";
+import { pythonPost } from "../helpers/pythonServerClient.js";
+import { resolveCurrentProjectDir } from "../files/helpers.js";
 
-// --- Verificación de créditos y reporte de uso ---
+// --- Verificacion de creditos ---
 const WS_BASE = "https://ws.cocosolution.com/api/handler_acaicode.php";
-// Precios Gemini 2.5 Flash: input $0.15/1M tokens, output $0.60/1M tokens
-function calcCost(usageMetadata) {
-    const input = usageMetadata?.promptTokenCount || 0;
-    const output = usageMetadata?.candidatesTokenCount || 0;
-    return Math.round(((input * 0.15 + output * 0.60) / 1_000_000) * 1e6) / 1e6;
-}
 
 function getAcaiToken() {
-    const projectDir = process.env.ACAI_PROJECT_DIR || "";
+    const projectDir = resolveCurrentProjectDir();
     if (!projectDir) return null;
     try {
         const acaiFile = path.join(projectDir, ".acai");
@@ -39,31 +34,6 @@ async function checkCredits() {
     } catch { return false; }
 }
 
-function reportImageUsage(usageMetadata, model) {
-    const token = getAcaiToken();
-    if (!token) return;
-    const testParam = process.env.STRIPE_MODE === "test" ? "&test" : "";
-    const cost = calcCost(usageMetadata);
-    const payload = {
-        action: "reportUsage",
-        model: model || "gemini-2.5-flash-image",
-        input_tokens: usageMetadata?.promptTokenCount || 0,
-        output_tokens: usageMetadata?.candidatesTokenCount || 0,
-        cache_read_tokens: 0,
-        cache_creation_tokens: 0,
-        cost_usd: cost,
-        session_id: "",
-    };
-    // Fire and forget
-    axios.put(`${WS_BASE}?action=reportUsage${testParam}`, payload, {
-        headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
-        timeout: 10000,
-    }).then(resp => {
-        if (resp.data?.success) console.error(`[generate_image] Usage reported: ${model} cost=$${cost}`);
-        else console.error(`[generate_image] Usage report failed:`, resp.data);
-    }).catch(err => console.error(`[generate_image] Usage report error:`, err.message));
-}
-
 export function registerGenerateImageTool(server) {
     server.tool(
         "generate_image",
@@ -78,130 +48,46 @@ export function registerGenerateImageTool(server) {
         { readOnlyHint: false, destructiveHint: false },
         withAuth(async ({ prompt, width = 1024, height = 1024, style, fileName }, extra) => {
             try {
-                const nanoBananaApiKey = process.env.NANO_BANANA_API_KEY;
-                if (!nanoBananaApiKey) {
-                    return {
-                        content: [{ type: "text", text: "Error: NANO_BANANA_API_KEY not set." }],
-                        isError: true,
-                    };
-                }
-
-                const projectDir = process.env.ACAI_PROJECT_DIR || "";
-                if (!projectDir) {
-                    return {
-                        content: [{ type: "text", text: "Error: ACAI_PROJECT_DIR not set." }],
-                        isError: true,
-                    };
-                }
-
-                // Verificar créditos antes de generar
+                // Verificar creditos antes de generar
                 const exceeded = await checkCredits();
                 if (exceeded) {
                     return {
-                        content: [{ type: "text", text: "Error: No te quedan créditos. Mejora tu plan para seguir usando el asistente." }],
+                        content: [{ type: "text", text: "Error: No te quedan creditos. Mejora tu plan para seguir usando el asistente." }],
                         isError: true,
                     };
                 }
 
-                // Build prompt with style hint
-                const fullPrompt = style ? `${prompt}. Style: ${style}` : prompt;
+                const projectSlug = path.basename(resolveCurrentProjectDir());
+                const safeFileName = fileName || `generated-${Date.now()}`;
+                const destRelativePath = `cms/uploads/generated/${safeFileName}.jpg`;
+                const fullPrompt = style ? `${style} style: ${prompt}` : prompt;
 
-                // Generate image via Google Gemini
-                const geminiModel = process.env.NANO_BANANA_MODEL || "gemini-2.5-flash-image";
-                const apiUrl = process.env.NANO_BANANA_URL ||
-                    `https://generativelanguage.googleapis.com/v1beta/models/${geminiModel}:generateContent`;
-
-                const generateResponse = await axios.post(
-                    apiUrl,
-                    {
-                        contents: [{ parts: [{ text: fullPrompt }] }],
-                        generationConfig: {
-                            responseModalities: ["TEXT", "IMAGE"],
-                        },
-                    },
-                    {
-                        headers: {
-                            "x-goog-api-key": nanoBananaApiKey,
-                            "Content-Type": "application/json",
-                        },
-                        timeout: 120000,
-                        validateStatus: (status) => status < 500,
-                    }
-                );
-
-                // Extract image from response
-                let imageBuffer = null;
-                if (generateResponse.data.candidates?.[0]?.content?.parts) {
-                    for (const part of generateResponse.data.candidates[0].content.parts) {
-                        if (part.inlineData?.data) {
-                            imageBuffer = Buffer.from(part.inlineData.data, "base64");
-                            break;
-                        }
-                        if (part.text?.startsWith("data:image")) {
-                            const match = part.text.match(/data:image\/[^;]+;base64,(.+)/);
-                            if (match) {
-                                imageBuffer = Buffer.from(match[1], "base64");
-                                break;
-                            }
-                        }
-                    }
-                }
-
-                if (!imageBuffer) {
-                    return {
-                        content: [{
-                            type: "text",
-                            text: `Error: Could not extract image from API response. Status: ${generateResponse.status}. Response: ${JSON.stringify(generateResponse.data).substring(0, 1000)}`
-                        }],
-                        isError: true,
-                    };
-                }
-
-                // Compress to JPEG
-                const originalSize = imageBuffer.length;
+                let result;
                 try {
-                    imageBuffer = await sharp(imageBuffer)
-                        .jpeg({ quality: 85 })
-                        .toBuffer();
-                    console.error(`[generate_image] Compressed: ${Math.round(originalSize / 1024)}KB → ${Math.round(imageBuffer.length / 1024)}KB`);
-                } catch (e) {
-                    console.error(`[generate_image] Compression failed, using original:`, e.message);
+                    result = await pythonPost("/api/generate-image", {
+                        project: projectSlug,
+                        prompt: fullPrompt,
+                        destRelativePath,
+                    }, 180000); // 3min timeout para generacion IA
+                } catch (pyErr) {
+                    return handleToolError(new Error(`Python generate-image failed: ${pyErr.response?.data?.error || pyErr.message}`), 'generate_image', { prompt });
                 }
 
-                // Save to cms/uploads/generated/
-                const uploadsDir = path.join(projectDir, "cms", "uploads", "generated");
-                fs.mkdirSync(uploadsDir, { recursive: true });
-
-                const safeName = fileName
-                    ? fileName.replace(/[^\w\-]/g, "_") + ".jpg"
-                    : `generated-${Date.now()}.jpg`;
-                const filePath = path.join(uploadsDir, safeName);
-                fs.writeFileSync(filePath, imageBuffer);
-
-                const relativePath = `cms/uploads/generated/${safeName}`;
-                const dockerUrl = `http://localhost/${relativePath}`;
-
-                // Reportar uso (fire and forget)
-                reportImageUsage(generateResponse.data.usageMetadata, geminiModel);
-
-                const credentials = await getSessionCredentials(extra.sessionId);
-                const fullUrl = credentials.web_url ? `${credentials.web_url}/${relativePath}` : dockerUrl;
-                const uploadUrl = credentials.web_url ? fullUrl : dockerUrl;
+                if (!result?.success) {
+                    return { content: [{ type: "text", text: JSON.stringify({ error: result?.error || "Generation failed" }, null, 2) }], isError: true };
+                }
 
                 return {
                     content: [{
                         type: "text",
                         text: JSON.stringify({
                             success: true,
-                            prompt: fullPrompt,
-                            fileName: safeName,
-                            filePath,
-                            relativePath,
-                            dockerUrl,
-                            fullUrl,
-                            uploadUrl,
-                            size: `${Math.round(imageBuffer.length / 1024)}KB`,
-                            note: `Image saved. To assign it with upload_record_image, use imageUrl="${uploadUrl}". dockerUrl is mainly for local preview/debugging.`,
+                            message: `Image generated and saved to ${result.relativePath}`,
+                            uploadUrl: result.fullUrl || result.dockerUrl,
+                            fullUrl: result.fullUrl || result.dockerUrl,
+                            relativePath: result.relativePath,
+                            fileName: result.fileName,
+                            size: result.size,
                         }, null, 2),
                     }],
                 };

mcp-server/tools/media/upload.js

@@ -1,8 +1,12 @@
+import fs from "node:fs";
+import path from "node:path";
 import { z } from "zod";
 import { withAuth, getSessionCredentials } from "../../auth/index.js";
 import { handleToolError, validateRequired, handleApiResponse } from "../helpers/errorHandler.js";
 import { withAuthParams } from "../helpers/authSchema.js";
 import { AcaiHttpClient } from "../helpers/acaiHttpClient.js";
+import { pythonPost } from "../helpers/pythonServerClient.js";
+import { resolveCurrentProjectDir } from "../files/helpers.js";
 
 /**
  * Helper: POST to mcp_respond.php via viewer_functions.php
@@ -19,14 +23,89 @@ async function mcpPost(target, actionWs, payload, token, tokenHash) {
     );
 }
 
+/**
+ * Si imageUrl apunta a un host local (localhost, 127.0.0.1, acai-app),
+ * descarga el archivo y lo retorna como base64 para incluirlo en el payload.
+ * Esto permite subir imagenes locales a un servidor remoto (modo produccion),
+ * ya que el servidor remoto no tiene acceso a nuestras URLs locales.
+ *
+ * @param {string} imageUrl
+ * @returns {Promise<{fileBase64: string, fileName: string} | null>}
+ *   null si la URL no es local (usar imageUrl directamente)
+ */
+async function resolveLocalImageAsBase64(imageUrl) {
+    const LOCAL_HOSTS = ["localhost", "127.0.0.1", "acai-app", "host.docker.internal"];
+
+    // Caso 1: Path absoluto del filesystem (e.g. /opt/acai/webs/.../cms/uploads/x.jpg)
+    if (typeof imageUrl === "string" && imageUrl.startsWith("/") && !imageUrl.startsWith("//")) {
+        try {
+            if (fs.existsSync(imageUrl) && fs.statSync(imageUrl).isFile()) {
+                const buffer = fs.readFileSync(imageUrl);
+                return {
+                    fileBase64: buffer.toString("base64"),
+                    fileName: path.basename(imageUrl),
+                };
+            }
+        } catch (error) {
+            console.error(`[upload] Failed to read filesystem path ${imageUrl}: ${error.message}`);
+        }
+        return null;
+    }
+
+    // Caso 2: URL HTTP — verificar si es local
+    let parsed;
+    try {
+        parsed = new URL(imageUrl);
+    } catch {
+        return null;
+    }
+    if (!LOCAL_HOSTS.includes(parsed.hostname)) {
+        return null;
+    }
+
+    // Intento A: descargar via HTTP (funciona cuando el host local es alcanzable)
+    try {
+        const axios = (await import("axios")).default;
+        const response = await axios.get(imageUrl, {
+            responseType: "arraybuffer",
+            timeout: 30000,
+        });
+        const fileBase64 = Buffer.from(response.data).toString("base64");
+        const pathname = parsed.pathname || "/image.jpg";
+        const fileName = pathname.split("/").pop() || "image.jpg";
+        return { fileBase64, fileName };
+    } catch (httpError) {
+        console.error(`[upload] HTTP fetch failed for ${imageUrl}: ${httpError.message}. Trying filesystem fallback.`);
+    }
+
+    // Intento B: resolver el pathname contra ACAI_PROJECT_DIR y leer del disco
+    const projectDir = resolveCurrentProjectDir();
+    if (projectDir && parsed.pathname) {
+        try {
+            const localPath = path.join(projectDir, parsed.pathname);
+            if (fs.existsSync(localPath) && fs.statSync(localPath).isFile()) {
+                const buffer = fs.readFileSync(localPath);
+                return {
+                    fileBase64: buffer.toString("base64"),
+                    fileName: path.basename(localPath),
+                };
+            }
+        } catch (error) {
+            console.error(`[upload] Filesystem fallback failed for ${imageUrl}: ${error.message}`);
+        }
+    }
+
+    return null;
+}
+
 export function registerUploadRecordImageTool(server) {
     server.tool(
         "upload_record_image",
-        "Upload an image to a specific record field in Acai CMS. Downloads the image from a URL and uploads it. Table names are WITHOUT the 'cms_' prefix. The recordId is the 'num' primary key, never 'id'. If the URL came from generate_image, prefer uploadUrl (or fullUrl) over dockerUrl in Forge environments.",
+        "Upload an image to a specific record field in Acai CMS. MANDATORY: before calling this tool, you MUST call get_table_schema with minimal=true to find the EXACT upload field name. Look for fields with type='upload'. NEVER guess field names. Table names WITHOUT 'cms_' prefix. recordId is 'num', never 'id'. If the URL came from generate_image, prefer uploadUrl (or fullUrl) over dockerUrl.",
         withAuthParams({
             tableName: z.string().describe("Table name without 'cms_' prefix (e.g., 'productos')"),
             recordId: z.string().describe("Record 'num' (primary key)"),
-            fieldName: z.string().describe("Field name (e.g., 'galeria_imagenes')"),
+            fieldName: z.string().describe("EXACT field name from the schema. MUST match a field with type 'upload' from get_table_schema or get_module_config_vars. Do NOT guess."),
             imageUrl: z.string().describe("URL of the image to upload"),
             alt: z.string().optional().describe("Alt text for the image (optional)"),
         }),
@@ -40,30 +119,44 @@ export function registerUploadRecordImageTool(server) {
                 );
                 if (validationError) return validationError;
 
+                const projectSlug = path.basename(resolveCurrentProjectDir());
+
+                // Intentar via Python server (tiene sync + optimizacion)
+                let result;
+                try {
+                    result = await pythonPost("/api/cms/upload-to-field", {
+                        project: projectSlug,
+                        table: tableName,
+                        num: recordId,
+                        field: fieldName,
+                        imageUrl: imageUrl,
+                    });
+                } catch (pyErr) {
+                    // Fallback: si Python no es accesible, usar el flujo directo al PHP
+                    console.error(`[upload_record_image] Python server failed (${pyErr.message}), falling back to PHP direct`);
                     const credentials = await getSessionCredentials(extra.sessionId);
-
-                // Upload via mcp_respond.php uploadRecordImage (sends imageUrl, PHP downloads it)
-                const response = await mcpPost(
-                    credentials,
-                    "uploadRecordImage",
-                    { tableName, recordId, fieldName, imageUrl, alt },
-                    credentials.token,
-                    credentials.tokenHash
-                );
-
+                    const localFile = await resolveLocalImageAsBase64(imageUrl);
+                    const uploadPayload = localFile
+                        ? { tableName, recordId, fieldName, alt, fileBase64: localFile.fileBase64, fileName: localFile.fileName }
+                        : { tableName, recordId, fieldName, imageUrl, alt };
+                    const response = await mcpPost(credentials, "uploadRecordImage", uploadPayload, credentials.token, credentials.tokenHash);
                     const apiError = handleApiResponse(response.data, 'upload_record_image');
                     if (apiError) return apiError;
+                    result = { success: true, data: response.data };
+                }
 
+                if (!result?.success && !result?.data?.success) {
+                    const errMsg = result?.error || result?.data?.error || "Unknown error";
+                    return { content: [{ type: "text", text: JSON.stringify({ error: errMsg }, null, 2) }], isError: true };
+                }
+
+                const uploadData = result.data || result;
                 return {
                     content: [{
                         type: "text",
                         text: JSON.stringify({
                             success: true,
-                            message: "Image uploaded successfully",
-                            tableName,
-                            recordId,
-                            fieldName,
-                            ...response.data
+                            ...uploadData,
                         }, null, 2)
                     }],
                 };
@@ -170,10 +263,17 @@ export function registerUploadRecordImageTool(server) {
                 );
 
                 // Step 2: Upload new image
+                // Si la URL es local, descargar y enviar base64 (el servidor remoto no
+                // puede descargarla en modo produccion).
+                const localFile = await resolveLocalImageAsBase64(imageUrl);
+                const uploadPayload = localFile
+                    ? { tableName, recordId, fieldName, alt, fileBase64: localFile.fileBase64, fileName: localFile.fileName }
+                    : { tableName, recordId, fieldName, imageUrl, alt };
+
                 const response = await mcpPost(
                     credentials,
                     "uploadRecordImage",
-                    { tableName, recordId, fieldName, imageUrl, alt },
+                    uploadPayload,
                     credentials.token,
                     credentials.tokenHash
                 );

mcp-server/tools/media/uploadImageToAssets.js

@@ -154,7 +154,7 @@ export function registerUploadImageToAssetsTool(server) {
 
                 // Upload using saveFileBuilder
                 const uploadResult = await saveFileBuilder({
-                    web_url: credentials.web_url,
+                    web_url: credentials.api_web_url || credentials.web_url,
                     token: credentials.token,
                     tokenHash: credentials.tokenHash,
                     path: assetsPath,

mcp-server/tools/modules/checkUsage.js

@@ -38,19 +38,23 @@ export function registerCheckModuleUsageTool(server) {
                 const apiError = handleApiResponse(response.data, 'check_module_usage');
                 if (apiError) return apiError;
 
-                // Extract usage information
-                const usageData = response.data.data || response.data;
+                // El PHP devuelve { result, success, message }. Si el modulo NO esta
+                // en uso, message = "No encuentro el módulo en ninguna sección".
+                // Si esta en uso, message contiene HTML con las tablas/paginas.
+                const msg = (response.data?.message || "");
+                const inUse = !!msg && !msg.includes("No encuentro");
 
                 return {
                     content: [{
                         type: "text", text: JSON.stringify({
                             success: true,
                             moduleId: id,
-                            usage: usageData,
-                            canDelete: !usageData || Object.keys(usageData).length === 0,
-                            message: Object.keys(usageData || {}).length === 0 
-                                ? "Module is not used anywhere - safe to delete" 
-                                : `Module is used in ${Object.keys(usageData || {}).length} location(s)`
+                            inUse,
+                            canDelete: !inUse,
+                            message: inUse
+                                ? "Module is in use — deletion denied. Inform the user which pages use it and stop. Do NOT attempt to remove it from pages."
+                                : "Module is not used anywhere — safe to delete",
+                            rawMessage: msg,
                         }, null, 2)
                     }],
                 };

mcp-server/tools/modules/compile.js

@@ -5,6 +5,7 @@ import { withAuth, getSessionCredentials } from "../../auth/index.js";
 import { handleToolError, validateRequired } from "../helpers/errorHandler.js";
 import { withAuthParams } from "../helpers/authSchema.js";
 import { LOCAL_SERVER_URL } from "../../config/index.js";
+import { resolveCurrentAcaiUser } from "../helpers/sessionHelpers.js";
 
 export function registerCompileModuleTool(server) {
     server.tool(
@@ -44,11 +45,16 @@ Pass the full path to the index-base.tpl file and the project directory.`,
                     ? { project: projectSlug, relativePath, project_dir: projectDir }
                     : { file: filePath, project_dir: projectDir };
 
-                // Call the Python server compile endpoint
+                // Call the Python server compile endpoint. Inyectar X-Acai-User
+                // cuando hay sesion HTTP activa para que el endpoint autenticado
+                // resuelva el proyecto dentro de /opt/acai/webs/<user>/.
+                const acaiUser = resolveCurrentAcaiUser();
+                const headers = { "Content-Type": "application/json" };
+                if (acaiUser) headers["X-Acai-User"] = acaiUser;
                 const response = await axios.post(
                     `${LOCAL_SERVER_URL}/api/compile-module`,
                     payload,
-                    { headers: { "Content-Type": "application/json" }, timeout: 30000 }
+                    { headers, timeout: 30000 }
                 );
 
                 if (response.data?.ok) {

mcp-server/tools/modules/create.js

@@ -4,6 +4,8 @@ import { withAuth } from "../../auth/index.js";
 import { handleToolError, validateRequired } from "../helpers/errorHandler.js";
 import { withAuthParams } from "../helpers/authSchema.js";
 import { LOCAL_SERVER_URL } from "../../config/index.js";
+import { resolveCurrentProjectDir } from "../files/helpers.js";
+import { resolveCurrentAcaiUser } from "../helpers/sessionHelpers.js";
 
 export function registerCreateModuleTool(server) {
     server.tool(
@@ -35,7 +37,7 @@ Parameters:
                 const validationError = validateRequired({ moduleId, html }, ['moduleId', 'html'], 'create_module');
                 if (validationError) return validationError;
 
-                const projectDir = process.env.ACAI_PROJECT_DIR || "";
+                const projectDir = resolveCurrentProjectDir();
                 if (!projectDir) {
                     return { content: [{ type: "text", text: "Error: ACAI_PROJECT_DIR not set" }], isError: true };
                 }
@@ -43,10 +45,15 @@ Parameters:
                 moduleId = moduleId.toLowerCase().replace(/\s+/g, '_'); // Ensure moduleId is lowercase and uses underscores
                 moduleId = moduleId + "_" + (Math.random().toString(36).substring(2, 8).toUpperCase());
 
+                // Inyectar X-Acai-User para que el endpoint autenticado del
+                // server Python resuelva rutas dentro de /opt/acai/webs/<user>/.
+                const acaiUser = resolveCurrentAcaiUser();
+                const headers = { "Content-Type": "application/json" };
+                if (acaiUser) headers["X-Acai-User"] = acaiUser;
                 const response = await axios.post(
                     `${LOCAL_SERVER_URL}/api/create-module`,
                     { project_dir: projectDir, module_id: moduleId, html, css: css || "", js: js || "", label, description, php: php || "" },
-                    { headers: { "Content-Type": "application/json" }, timeout: 30000 }
+                    { headers, timeout: 30000 }
                 );
 
                 if (response.data?.success) {

mcp-server/tools/modules/delete.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { withAuth, getSessionCredentials, getApiClient } from "../../auth/index.js";
+import { handleToolError, validateRequired, handleApiResponse } from "../helpers/errorHandler.js";
+import { withAuthParams } from "../helpers/authSchema.js";
+import { AcaiHttpClient } from "../helpers/acaiHttpClient.js";
+
+export function registerDeleteModuleTool(server) {
+    server.tool(
+        "delete_module",
+        "Elimina un módulo del proyecto. Borra la carpeta completa del módulo (template/estandar/modulos/{moduleId}/). OBLIGATORIO: llama a check_module_usage ANTES. Si el módulo está en uso (inUse=true), DENIEGA el borrado e informa al usuario de las páginas donde se usa. NO intentes quitar el módulo de las páginas por tu cuenta — solo el usuario puede decidir eso.",
+        withAuthParams({
+            moduleId: z.string().describe("ID del módulo a eliminar (nombre de la carpeta)"),
+        }),
+        { readOnlyHint: false, destructiveHint: true },
+        withAuth(async ({ moduleId }, extra) => {
+            try {
+                const validationError = validateRequired({ moduleId }, ['moduleId'], 'delete_module');
+                if (validationError) return validationError;
+
+                const credentials = await getSessionCredentials(extra.sessionId);
+
+                const payload = {
+                    action_ws: "deleteModule",
+                    fileName: moduleId,
+                    token: credentials.token,
+                    tokenHash: credentials.tokenHash
+                };
+
+                const response = await AcaiHttpClient.postViewerFunctions(
+                    await getApiClient(extra.sessionId),
+                    payload
+                );
+
+                // Check for API errors (ej: módulo en uso)
+                const apiError = handleApiResponse(response.data, 'delete_module');
+                if (apiError) return apiError;
+
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            moduleId,
+                            message: `Módulo "${moduleId}" eliminado correctamente.`
+                        }, null, 2)
+                    }],
+                };
+            } catch (error) {
+                return handleToolError(error, 'delete_module', { moduleId });
+            }
+        })
+    );
+}

mcp-server/tools/modules/index.js

@@ -1,9 +1,14 @@
 import { registerCheckModuleTool } from './check.js';
 import { registerCheckModuleUsageTool } from './checkUsage.js';
 import { registerCompileModuleTool } from './compile.js';
+import { registerDeleteModuleTool } from './delete.js';
+import { canEditCode } from '../helpers/roleCheck.js';
 
 export function registerModuleTools(server) {
     registerCheckModuleTool(server);
     registerCheckModuleUsageTool(server);
+    if (canEditCode()) {
         registerCompileModuleTool(server);
+        registerDeleteModuleTool(server);
+    }
 }

mcp-server/tools/modules/setExampleData.js

@@ -6,15 +6,19 @@ import { withAuthParams } from "../helpers/authSchema.js";
 export function registerSetModuleExampleDataTool(server) {
     server.tool(
         "set_module_example_data",
-        `Set example data for a module's editor preview. MANDATORY: call get_module first to get the schema, then fill EVERY variable.
+        `Define datos de ejemplo para el preview del módulo en el editor. Antes de llamar, lee el builder.json del módulo (con 'acai-view') o usa 'get_module_config_vars' para conocer las variables exactas. Rellena TODAS las variables del schema.
 
-    Critical: uploads ALWAYS as [{urlPath: "..."}] (NEVER strings), multiv2 as array with 2+ items, var names from data-field-label (no spaces, lowercase). Use generate_image or placehold.co for image URLs.
+Reglas críticas:
+- Uploads SIEMPRE como [{ urlPath: "..." }] (nunca strings ni objetos sueltos).
+- 'multiv2' como array con al menos 2 items para que el preview se vea representativo.
+- Los nombres de variables se derivan de 'data-field-label' (minúsculas, sin espacios ni acentos).
+- Para URLs de imagen usa 'generate_image' o un placeholder (e.g. https://placehold.co/800x600).
 
-    See resource 'acai-cheat-sheet' → "Example Data Formatting" for type-specific value formats.`,
+Si dudas del formato exacto, lee 'read_doc({ name: "01-builder-fields" })'.`,
         withAuthParams({
-            moduleId: z.string().describe("Module ID"),
-            moduleSchema: z.object({}).passthrough().describe("Complete module schema (obtained from get_module)"),
-            exampleData: z.object({}).passthrough().describe("Example data for EVERY variable in the module schema. Structure must match the schema exactly. Fill ALL variables without exception."),
+            moduleId: z.string().describe("ID del módulo"),
+            moduleSchema: z.object({}).passthrough().describe("Schema completo del módulo (del builder.json o de 'get_module_config_vars')"),
+            exampleData: z.object({}).passthrough().describe("Datos de ejemplo para TODAS las variables del schema. La estructura debe coincidir exactamente."),
         }),
         { readOnlyHint: false, destructiveHint: false },
         withAuth(async ({ moduleId, moduleSchema, exampleData }, extra) => {

mcp-server/tools/navigation/navigate.js

@@ -3,6 +3,7 @@ import { withAuth, getSessionCredentials } from "../../auth/index.js";
 import { handleToolError } from "../helpers/errorHandler.js";
 import { withAuthParams } from "../helpers/authSchema.js";
 import { LOCAL_SERVER_URL } from "../../config/index.js";
+import { resolveCurrentAcaiUser } from "../helpers/sessionHelpers.js";
 import axios from "axios";
 
 export function registerNavigateBrowserTool(server) {
@@ -30,12 +31,16 @@ export function registerNavigateBrowserTool(server) {
                 const credentials = await getSessionCredentials(extra.sessionId);
                 const project = credentials.website || process.env.ACAI_WEBSITE || "";
 
-                // POST to Python server to set pending navigation
+                // POST to Python server to set pending navigation.
+                // Inyectar X-Acai-User cuando la sesion MCP lo provee.
+                const acaiUser = resolveCurrentAcaiUser();
+                const headers = { "Content-Type": "application/json" };
+                if (acaiUser) headers["X-Acai-User"] = acaiUser;
                 await axios.post(`${LOCAL_SERVER_URL}/api/browser/navigate`, {
                     project: project,
                     enlace: enlace,
                 }, {
-                    headers: { "Content-Type": "application/json" },
+                    headers,
                     timeout: 5000,
                 });
 

mcp-server/tools/orchestrator/detector.js

@@ -1,345 +0,0 @@
-/**
- * Workflow auto-detection engine.
- * Keyword-based pattern matching with weighted scoring + contextual adjustments.
- * No LLM call needed — fast and deterministic.
- */
-
-const WORKFLOW_PATTERNS = {
-    create_section: {
-        keywords: [
-            "crear seccion", "create section", "nueva seccion", "new section",
-            "anadir seccion", "add section", "crear tabla", "create table",
-            "nueva pagina", "new page", "nueva seccion web", "new web section",
-            "montar seccion", "set up section", "configurar seccion",
-            // Additional English patterns
-            "build section", "build page", "make section", "make page",
-            "set up page", "create page", "new table",
-            "section for", "seccion de", "seccion para",
-            // Natural phrasing
-            "want section", "need section", "quiero seccion",
-            "necesito seccion", "hacer seccion", "hacer pagina"
-        ],
-        boost: [
-            "categoria", "category", "productos", "products", "blog", "noticias",
-            "news", "equipo", "team", "servicios", "services", "galeria", "gallery",
-            "portfolio", "testimonios", "testimonials", "faq", "preguntas",
-            "clientes", "clients", "proyectos", "projects",
-            "restaurante", "restaurant", "tienda", "store", "shop",
-            "eventos", "events", "cursos", "courses"
-        ],
-        weight: 10
-    },
-    populate_content: {
-        keywords: [
-            "anadir contenido", "add content", "crear registros", "create records",
-            "poblar", "populate", "rellenar", "fill", "bulk", "masivo",
-            "insertar datos", "insert data", "meter datos", "cargar contenido",
-            "load content", "contenido de ejemplo", "sample content",
-            "crear entradas", "create entries", "anadir registros", "add records",
-            "registros de ejemplo", "sample records", "meter registros",
-            "fill with data", "fill with content", "add sample", "add examples",
-            "anadir ejemplos", "contenido de prueba", "test content"
-        ],
-        boost: [
-            "imagenes", "images", "fotos", "photos", "stock", "ejemplo", "sample",
-            "demo", "placeholder", "varios", "multiple", "lote", "batch"
-        ],
-        weight: 10
-    },
-    create_module: {
-        keywords: [
-            "crear modulo", "create module", "nuevo modulo", "new module",
-            "disenar modulo", "design module", "hacer modulo", "make module",
-            "componente", "component", "crear componente", "create component",
-            "nuevo componente", "new component", "montar modulo",
-            "build module", "build component", "make component"
-        ],
-        boost: [
-            "hero", "slider", "card", "grid", "lista", "list", "banner",
-            "footer", "header", "navbar", "cta", "call to action",
-            "carousel", "accordion", "tabs", "pricing", "features"
-        ],
-        weight: 10
-    },
-    edit_module: {
-        keywords: [
-            "editar modulo", "edit module", "modificar modulo", "modify module",
-            "cambiar modulo", "change module", "actualizar modulo", "update module",
-            "arreglar modulo", "fix module", "mejorar modulo", "improve module",
-            "corregir modulo", "ajustar modulo", "adjust module"
-        ],
-        boost: [
-            "css", "html", "javascript", "js", "estilo", "style", "variable",
-            "campo", "field", "diseno", "design", "responsive", "movil", "mobile",
-            "color", "fuente", "font", "espaciado", "spacing",
-            "hero", "slider", "card", "grid", "banner", "footer", "header",
-            "navbar", "cta", "carousel", "accordion", "tabs", "pricing"
-        ],
-        weight: 10
-    },
-    manage_records: {
-        keywords: [
-            "editar registro", "edit record", "actualizar registro", "update record",
-            "borrar registro", "delete record", "buscar registro", "search record",
-            "listar registros", "list records", "modificar registro", "modify record",
-            "ver registros", "view records", "consultar registros", "query records",
-            "cambiar datos", "change data", "eliminar registro", "remove record",
-            // CRUD-oriented English patterns
-            "update data", "delete data", "edit data", "modify data",
-            "update field", "change field", "edit entry", "delete entry",
-            "update price", "change price", "update name", "change name",
-            "remove records", "remove entries", "crud",
-            "insert record", "insert entry", "create record", "add entry",
-            "find record", "find records", "search records", "search data"
-        ],
-        boost: [
-            "filtrar", "filter", "where", "campo", "field", "valor", "value",
-            "pagina", "page", "ordenar", "sort", "buscar", "search",
-            "precio", "price", "nombre", "name", "fecha", "date",
-            "estado", "status", "activo", "active"
-        ],
-        weight: 8
-    },
-    manage_media: {
-        // Only specific action phrases — generic words like "image/foto" are in boost, not keywords
-        keywords: [
-            "subir imagen", "upload image", "subir foto", "upload photo",
-            "buscar imagen stock", "search stock image", "buscar fotos stock",
-            "generar imagen", "generate image", "generar foto",
-            "reemplazar imagen", "replace image", "cambiar imagen", "change image",
-            "borrar imagen", "delete image", "eliminar imagen", "remove image",
-            "gestionar media", "manage media", "gestionar imagenes", "manage images",
-            "buscar stock", "search stock", "stock photos", "fotos stock",
-            "subir archivo", "upload file"
-        ],
-        boost: [
-            "stock", "pixabay", "pexels", "ai", "inteligencia artificial",
-            "resize", "thumbnail", "miniatura", "s3", "assets",
-            "comprimir", "compress", "optimizar", "optimize",
-            // Generic image words are boosts, NOT keywords
-            "imagen", "image", "foto", "photo", "galeria", "gallery", "media"
-        ],
-        weight: 5  // Reduced from 8 — media is usually a step, not a workflow
-    },
-    seo_setup: {
-        keywords: [
-            "seo", "meta tags", "meta descripcion", "meta description",
-            "enlace", "slug", "url amigable", "friendly url", "sitemap",
-            "schema markup", "posicionamiento", "ranking",
-            "meta titulo", "meta title", "configurar seo", "setup seo",
-            "set up seo", "configure seo"
-        ],
-        boost: [
-            "google", "keywords", "palabras clave", "busqueda", "search",
-            "indexar", "index", "robots", "canonical", "og:image"
-        ],
-        weight: 6
-    },
-    explore_site: {
-        keywords: [
-            "explorar", "explore", "que tiene", "what's in", "listar todo",
-            "list all", "mostrar", "show me", "overview", "resumen",
-            "que hay", "que secciones", "what sections", "ver todo",
-            "show everything", "estructura", "structure", "inventario",
-            "mapa del sitio", "site map", "what modules", "que modulos"
-        ],
-        boost: [
-            "estructura", "structure", "mapa", "map", "resumen", "summary",
-            "completo", "complete", "todas", "all"
-        ],
-        weight: 5
-    }
-};
-
-/**
- * Normalize text for matching: lowercase, remove accents, strip common articles, trim.
- */
-function normalizeText(text) {
-    return text
-        .toLowerCase()
-        .normalize("NFD")
-        .replace(/[\u0300-\u036f]/g, "")
-        .trim();
-}
-
-/**
- * Prepare task text for matching: normalize + strip common filler words (articles, prepositions)
- * that break keyword matching (e.g., "editar el módulo" should match "editar módulo").
- */
-function prepareTaskForMatching(text) {
-    const normalized = normalizeText(text);
-    // Strip common Spanish/English articles and short prepositions that break adjacent keyword matching
-    return normalized.replace(/\b(el|la|los|las|un|una|unos|unas|del|al|the|a|an)\b/g, " ").replace(/\s+/g, " ").trim();
-}
-
-// ── Contextual adjustment patterns ──────────────────────────────────────────
-// These use regex word matching to detect intent combinations that substring
-// matching misses (e.g., "create a new products section" has words separated).
-
-const CREATION_VERBS = /\b(crear|create|nueva?o?|new|build|make|set up|montar|anadir|add|disenar|design|hacer)\b/;
-const EDIT_VERBS = /\b(editar|edit|modificar|modify|cambiar|change|actualizar|update|arreglar|fix|mejorar|improve|ajustar|adjust|corregir)\b/;
-const CRUD_VERBS = /\b(editar|edit|borrar|delete|eliminar|remove|actualizar|update|crear|create|insertar|insert|modificar|modify|buscar|search|listar|list|consultar|query|cambiar|change|find|get|ver|view)\b/;
-const SECTION_WORDS = /\b(seccion|section|pagina|page|tabla|table|web|sitio|site)\b/;
-const MODULE_WORDS = /\b(modulo|module|componente|component)\b/;
-const RECORD_WORDS = /\b(registro|registros|record|records|datos|data|entrada|entradas|entry|entries|contenido|content|precio|price|campo|field)\b/;
-const MEDIA_ONLY_WORDS = /\b(subir|upload|reemplazar|replace|descargar|download)\b/;
-const IMAGE_WORDS = /\b(imagen|imagenes|image|images|foto|fotos|photo|photos|galeria|gallery)\b/;
-// Words that indicate the task is about content/records, not creating a new section
-const CONTENT_INTENT_WORDS = /\b(contenido|content|rellenar|fill|poblar|populate|registros|records|sample|ejemplo|articulos|articles|entradas|entries|anadir contenido|add content)\b/;
-// Words that indicate the task is about SEO, not creating a new section
-const SEO_INTENT_WORDS = /\b(seo|meta tags?|meta descripcion|meta description|meta titulo|meta title|sitemap|slug|posicionamiento|ranking|canonical)\b/;
-
-/**
- * Post-scoring contextual adjustments.
- * Uses regex word matching (not substring) to detect intent patterns the keyword
- * phase may miss due to non-adjacent words.
- */
-function applyContextAdjustments(scores, normalizedTask) {
-    const hasCreationVerb = CREATION_VERBS.test(normalizedTask);
-    const hasEditVerb = EDIT_VERBS.test(normalizedTask);
-    const hasCrudVerb = CRUD_VERBS.test(normalizedTask);
-    const hasSection = SECTION_WORDS.test(normalizedTask);
-    const hasModule = MODULE_WORDS.test(normalizedTask);
-    const hasRecord = RECORD_WORDS.test(normalizedTask);
-    const hasMediaAction = MEDIA_ONLY_WORDS.test(normalizedTask);
-    const hasImageWord = IMAGE_WORDS.test(normalizedTask);
-    const hasContentIntent = CONTENT_INTENT_WORDS.test(normalizedTask);
-    const hasSeoIntent = SEO_INTENT_WORDS.test(normalizedTask);
-
-    // ── Section creation intent ──
-    // "create" + "section/page/table" = strong signal for create_section
-    // BUT NOT when the real intent is populating content or configuring SEO
-    if (hasCreationVerb && hasSection && !hasContentIntent && !hasSeoIntent) {
-        scores.create_section = scores.create_section || { score: 0, keywordHits: 0, boostHits: 0 };
-        scores.create_section.score += 20;
-    }
-
-    // ── Module creation intent ──
-    // "create/new" + "module/component" = strong signal for create_module
-    if (hasCreationVerb && hasModule) {
-        scores.create_module = scores.create_module || { score: 0, keywordHits: 0, boostHits: 0 };
-        scores.create_module.score += 20;
-    }
-
-    // ── Module edit intent ──
-    // "edit/modify/change" + "module/component" = strong signal for edit_module
-    if (hasEditVerb && hasModule) {
-        scores.edit_module = scores.edit_module || { score: 0, keywordHits: 0, boostHits: 0 };
-        scores.edit_module.score += 20;
-    }
-
-    // ── Decisive create vs edit for modules ──
-    // When both create_module and edit_module have scores, apply decisive differentiation
-    if (hasModule && scores.create_module && scores.edit_module) {
-        if (hasCreationVerb && !hasEditVerb) {
-            // Clearly creation intent → penalize edit
-            scores.edit_module.score = Math.max(0, scores.edit_module.score - 15);
-        } else if (hasEditVerb && !hasCreationVerb) {
-            // Clearly edit intent → penalize create
-            scores.create_module.score = Math.max(0, scores.create_module.score - 15);
-        }
-    }
-
-    // ── Record CRUD intent ──
-    // Any CRUD verb + "record/data/entry" = signal for manage_records
-    if (hasCrudVerb && hasRecord) {
-        scores.manage_records = scores.manage_records || { score: 0, keywordHits: 0, boostHits: 0 };
-        scores.manage_records.score += 15;
-    }
-
-    // ── Penalize manage_media when context is clearly about something else ──
-    // If the task mentions section/module/record context, media is a step not the workflow
-    if (scores.manage_media && (hasSection || hasModule || hasRecord)) {
-        // Only keep media score if there's an explicit media action verb ("upload", "replace")
-        if (!hasMediaAction) {
-            scores.manage_media.score = Math.max(0, Math.floor(scores.manage_media.score * 0.3));
-        }
-    }
-
-    // ── Boost manage_media only when it's the clear primary intent ──
-    // "upload/replace" + "image/photo" WITHOUT section/module/record context
-    if (hasMediaAction && hasImageWord && !hasSection && !hasModule && !hasRecord) {
-        scores.manage_media = scores.manage_media || { score: 0, keywordHits: 0, boostHits: 0 };
-        scores.manage_media.score += 10;
-    }
-}
-
-/**
- * Detect the best workflow for a given task description.
- * Returns the top match with confidence, or suggestions if ambiguous.
- *
- * @param {string} task - The user's task description
- * @returns {{ workflow: string, confidence: number, alternatives: Array }}
- */
-export function detectWorkflow(task) {
-    const normalizedTask = prepareTaskForMatching(task);
-    const scores = {};
-
-    // ── Phase 1: Keyword + boost scoring ──
-    for (const [workflowId, pattern] of Object.entries(WORKFLOW_PATTERNS)) {
-        let score = 0;
-        let keywordHits = 0;
-        let boostHits = 0;
-
-        // Check keyword matches
-        for (const keyword of pattern.keywords) {
-            if (normalizedTask.includes(normalizeText(keyword))) {
-                keywordHits++;
-            }
-        }
-
-        // Check boost matches
-        for (const boost of pattern.boost) {
-            if (normalizedTask.includes(normalizeText(boost))) {
-                boostHits++;
-            }
-        }
-
-        score = (keywordHits * pattern.weight) + (boostHits * 3);
-        scores[workflowId] = { score, keywordHits, boostHits };
-    }
-
-    // ── Phase 2: Contextual adjustments ──
-    // Uses regex word matching to catch intent patterns that substring matching misses
-    applyContextAdjustments(scores, normalizedTask);
-
-    // Sort by score descending
-    const ranked = Object.entries(scores)
-        .filter(([, data]) => data.score > 0)
-        .sort(([, a], [, b]) => b.score - a.score);
-
-    if (ranked.length === 0) {
-        return {
-            workflow: null,
-            confidence: 0,
-            alternatives: []
-        };
-    }
-
-    const [topId, topData] = ranked[0];
-    const maxPossibleScore = WORKFLOW_PATTERNS[topId].keywords.length * WORKFLOW_PATTERNS[topId].weight
-        + WORKFLOW_PATTERNS[topId].boost.length * 3;
-    const confidence = Math.min(topData.score / Math.max(maxPossibleScore * 0.15, 1), 1);
-
-    // Check if top 2 are close (ambiguous)
-    const alternatives = ranked.slice(1, 3).map(([id, data]) => ({
-        workflow: id,
-        score: data.score,
-        confidence: Math.min(data.score / Math.max(
-            WORKFLOW_PATTERNS[id].keywords.length * WORKFLOW_PATTERNS[id].weight * 0.15, 1
-        ), 1)
-    }));
-
-    const isAmbiguous = alternatives.length > 0
-        && alternatives[0].score > 0
-        && (topData.score - alternatives[0].score) < (topData.score * 0.2);
-
-    return {
-        workflow: topId,
-        confidence: Math.round(confidence * 100) / 100,
-        ambiguous: isAmbiguous,
-        alternatives
-    };
-}
-
-export { WORKFLOW_PATTERNS };

mcp-server/tools/orchestrator/index.js

@@ -1,5 +0,0 @@
-import { registerOrchestrateTool } from "./orchestrate.js";
-
-export function registerOrchestratorTools(server) {
-    registerOrchestrateTool(server);
-}

mcp-server/tools/orchestrator/orchestrate.js

@@ -1,165 +0,0 @@
-import { z } from "zod";
-import { detectWorkflow } from "./detector.js";
-import { getWorkflow, listWorkflows } from "./workflows/index.js";
-
-/**
- * Register the orchestrate_task tool on the MCP server.
- */
-export function registerOrchestrateTool(server) {
-    server.tool(
-        "orchestrate_task",
-        "Provides workflow context, domain rules, and step-by-step guidance for Acai CMS tasks. " +
-            "Returns relevant warnings, resource pointers, and suggested tool order. " +
-            "Optional but recommended for multi-step tasks — helps avoid common mistakes. " +
-            "Available workflows: create_section, populate_content, create_module, edit_module, " +
-            "manage_records, manage_media, seo_setup, explore_site.",
-        {
-            task: z.string().describe(
-                "The user's task or request in their own words. " +
-                "Example: 'Crear una sección de productos con categorías e imágenes'"
-            ),
-            forceWorkflow: z.string().optional().describe(
-                "Optional: force a specific workflow instead of auto-detecting. " +
-                "Use when auto-detection is wrong or you know exactly which workflow to use. " +
-                "Values: create_section, populate_content, create_module, edit_module, " +
-                "manage_records, manage_media, seo_setup, explore_site"
-            )
-        },
-        { readOnlyHint: true, destructiveHint: false },
-        async ({ task, forceWorkflow }) => {
-            try {
-                let workflowId;
-                let confidence;
-                let detectionInfo;
-
-                if (forceWorkflow) {
-                    // Forced workflow — skip detection
-                    workflowId = forceWorkflow;
-                    confidence = 1.0;
-                    detectionInfo = { method: "forced", forceWorkflow };
-                } else {
-                    // Auto-detect workflow from task description
-                    const detection = detectWorkflow(task);
-
-                    if (!detection.workflow) {
-                        // No workflow matched — return general orientation
-                        return {
-                            content: [{
-                                type: "text",
-                                text: JSON.stringify({
-                                    success: true,
-                                    workflow: "none_detected",
-                                    message: "Could not determine a specific workflow for this task. " +
-                                        "You can proceed freely using available tools, or specify a workflow with forceWorkflow.",
-                                    availableWorkflows: listWorkflows(),
-                                    generalRules: [
-                                        "Table names WITHOUT 'cms_' prefix in all tool calls",
-                                        "Primary key is ALWAYS 'num', never 'id'",
-                                        "Upload fields are ALWAYS arrays of objects with urlPath property",
-                                        "Use ONLY Twig FILTERS (pipe syntax), not Twig functions",
-                                        "Date format: YYYY-MM-DD HH:mm:ss",
-                                        "Checkbox values: 1 or 0 (number, not boolean)"
-                                    ]
-                                }, null, 2)
-                            }]
-                        };
-                    }
-
-                    if (detection.ambiguous) {
-                        // Ambiguous — return top suggestions
-                        const topWorkflow = getWorkflow(detection.workflow);
-                        const altWorkflows = detection.alternatives
-                            .map(a => getWorkflow(a.workflow))
-                            .filter(Boolean);
-
-                        return {
-                            content: [{
-                                type: "text",
-                                text: JSON.stringify({
-                                    success: true,
-                                    workflow: "ambiguous",
-                                    message: "Multiple workflows could match this task. " +
-                                        "Pick the most appropriate one using forceWorkflow, or proceed with the top match.",
-                                    topMatch: {
-                                        id: topWorkflow.id,
-                                        name: topWorkflow.name,
-                                        description: topWorkflow.description,
-                                        confidence: detection.confidence
-                                    },
-                                    alternatives: altWorkflows.map((w, i) => ({
-                                        id: w.id,
-                                        name: w.name,
-                                        description: w.description,
-                                        confidence: detection.alternatives[i].confidence
-                                    }))
-                                }, null, 2)
-                            }]
-                        };
-                    }
-
-                    workflowId = detection.workflow;
-                    confidence = detection.confidence;
-                    detectionInfo = {
-                        method: "auto",
-                        confidence: detection.confidence,
-                        alternatives: detection.alternatives
-                    };
-                }
-
-                // Load the workflow
-                const workflow = getWorkflow(workflowId);
-                if (!workflow) {
-                    return {
-                        content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                success: false,
-                                error: `Unknown workflow: '${workflowId}'`,
-                                availableWorkflows: listWorkflows()
-                            }, null, 2)
-                        }],
-                        isError: true
-                    };
-                }
-
-                // Build the response
-                const response = {
-                    success: true,
-                    workflow: workflow.id,
-                    name: workflow.name,
-                    description: workflow.description,
-                    confidence,
-                    detection: detectionInfo,
-                    totalSteps: workflow.steps.length,
-                    steps: workflow.steps,
-                    context: workflow.context,
-                    rules: workflow.rules,
-                    warnings: workflow.warnings,
-                    resources: workflow.resources
-                };
-
-                console.error(`[Orchestrator] Detected workflow: ${workflow.id} (confidence: ${confidence}) for task: "${task.substring(0, 80)}..."`);
-
-                return {
-                    content: [{
-                        type: "text",
-                        text: JSON.stringify(response, null, 2)
-                    }]
-                };
-
-            } catch (error) {
-                console.error("[Orchestrator] Error:", error);
-                return {
-                    content: [{
-                        type: "text",
-                        text: JSON.stringify({
-                            success: false,
-                            error: error.message
-                        }, null, 2)
-                    }],
-                    isError: true
-                };
-            }
-        }
-    );
-}

mcp-server/tools/orchestrator/workflows/createModule.js

@@ -1,85 +0,0 @@
-export const createModuleWorkflow = {
-    id: "create_module",
-    name: "Create Module",
-    description: "Design and create an HTML module by writing project files directly, then compile it in the CMS.",
-    steps: [
-        {
-            step: 1,
-            action: "Understand the design",
-            description: "Clarify with user: what does the module show? Is it a hero, grid, list, slider, CTA, form?",
-            tool: null,
-            critical: "Get clear requirements before writing code. Ask about: layout, colors, responsive behavior, editable fields."
-        },
-        {
-            step: 2,
-            action: "Review project styling and patterns",
-            description: "Use the saved project styles and nearby modules as reference before writing code.",
-            tool: "save_project_styles",
-            critical: "Align typography, spacing, colors, and component patterns with the existing project."
-        },
-        {
-            step: 3,
-            action: "Create the module files",
-            description: "Write index-base.tpl, style.css, script.js, and optional hook.php directly in the module folder.",
-            tool: "acai-write",
-            critical: "Use project-relative paths. Create complete files. Keep variable names lowercase, descriptive, and stable."
-        },
-        {
-            step: 4,
-            action: "Refine targeted blocks if needed",
-            description: "Use incremental replacements for small fixes instead of rewriting whole files.",
-            tool: "acai-line-replace",
-            critical: "Prefer block edits for existing files to reduce token usage and avoid accidental rewrites."
-        },
-        {
-            step: 5,
-            action: "Compile the module",
-            description: "Compile after editing index-base.tpl so the CMS syncs index.tpl and builder metadata.",
-            tool: "compile_module",
-            critical: "This is mandatory after every index-base.tpl change."
-        },
-        {
-            step: 6,
-            action: "Set example data",
-            description: "Set example/static data for module preview. MUST call get_module first to discover the variable schema.",
-            tool: "set_module_example_data",
-            critical: "Call get_module first to get ALL variable names. Then fill EVERY variable with realistic example data. Missing variables = blank preview."
-        },
-        {
-            step: 7,
-            action: "Check module rendering",
-            description: "Test the module with specific variable values to verify it renders correctly.",
-            tool: "check_module",
-            critical: "Test with realistic values. Check for Twig syntax errors, broken images, layout issues."
-        }
-    ],
-    context: {
-        builder_vars: "data-field-type attribute on elements creates editable fields. Types: textfield (single line text), headfield (heading), textbox (multiline), wysiwyg (rich HTML), link (URL), upload (single image), uploadBackground (background image), uploadMulti (gallery), list (dropdown options), multiv2 (repeatable block).",
-        component_syntax: "c-if='varname' shows/hides element based on variable. c-for='item in items' loops over array. c-hidden='true' makes element invisible (for config vars). c-else after c-if for alternative content.",
-        module_structure: "Create index-base.tpl, style.css, script.js, and optional hook.php in the module directory. Compile to generate builder.json and the public templates.",
-        css_conventions: "Use TailwindCSS by default. For custom CSS: BEM naming with kebab-case. Root class should match module name. Avoid !important.",
-        upload_in_modules: "Upload fields are arrays. Single image: {{ varname[0].urlPath | imagec(WIDTH) }}. Background: style=\"background-image: url('{{ varname[0].urlPath | imagec(1920) }}')\". Gallery: {% for img in varname %}{{ img.urlPath }}{% endfor %}."
-    },
-    rules: [
-        "Variable names: lowercase, no spaces, no accents, no special characters",
-        "Labels must be UNIQUE — duplicate labels create shared fields",
-        "Upload fields are ALWAYS arrays — access with [0].urlPath",
-        "Use ONLY Twig FILTERS (pipe syntax), not Twig functions",
-        "c-if='varname' for conditional rendering of optional fields",
-        "c-hidden='true' for configuration variables not shown to end user",
-        "data-field-width on upload elements to set image optimization width",
-        "For multiv2 (repeatable): parent element needs data-field-type='multiv2', children are the repeated fields"
-    ],
-    warnings: [
-        "DO NOT use duplicate labels — they create shared/linked fields",
-        "DO NOT forget to set example data — the module will appear blank in the editor",
-        "DO NOT use Twig functions (range, random, etc.) — only filters work",
-        "DO NOT access upload vars as strings — always use varname[0].urlPath (array)",
-        "DO NOT mix React/Vue syntax — use Twig for templating, vanilla JS for interactivity"
-    ],
-    resources: [
-        "acai://resources/guia-builder-vars",
-        "acai://resources/guia-atributos-acai",
-        "acai://resources/guia-programacion-acai"
-    ]
-};

mcp-server/tools/orchestrator/workflows/createSection.js

@@ -1,110 +0,0 @@
-export const createSectionWorkflow = {
-    id: "create_section",
-    name: "Create New Section",
-    description: "Full workflow for creating a new website section: table + fields + module + template + content.",
-    steps: [
-        {
-            step: 1,
-            action: "Understand requirements",
-            description: "Clarify with user: section name, type (multi/single/category), fields needed, whether it needs URL (enlace), SEO meta tags.",
-            tool: null,
-            critical: "Ask before acting. Multi = multiple records (blog, products). Single = one record (about page). Category = grouping for other sections."
-        },
-        {
-            step: 2,
-            action: "Check existing tables",
-            description: "List current tables to avoid naming conflicts and understand existing structure.",
-            tool: "list_tables",
-            critical: "Table names must be unique. Check if a similar section already exists."
-        },
-        {
-            step: 3,
-            action: "Create the table",
-            description: "Create the database table with correct type and configuration.",
-            tool: "create_table",
-            critical: "type must be: 'multi' (multiple records), 'single' (one record), 'category' (grouping), or 'separador' (menu separator). Set enlace=true if records need their own URL page."
-        },
-        {
-            step: 4,
-            action: "Add fields to the table",
-            description: "Create all necessary fields with correct types and configuration.",
-            tool: "edit_table_field",
-            critical: "Can batch multiple fields in one call. Field types: textfield, textbox, wysiwyg, date, checkbox, list, upload, multitext, codigo, separator."
-        },
-        {
-            step: 5,
-            action: "Verify table schema",
-            description: "Get the complete schema to confirm all fields were created correctly.",
-            tool: "get_table_schema",
-            critical: "Verify all fields exist with correct types before proceeding to module creation."
-        },
-        {
-            step: 6,
-            action: "Design and create the listing module",
-            description: "Create an HTML module that displays a list/grid of records from this section.",
-            tool: "save_module",
-            critical: "Use Twig syntax. Access records with the 'get' filter. Primary key is 'num' not 'id'. Upload fields are ALWAYS arrays: use record.field[0].urlPath | imagec(width)."
-        },
-        {
-            step: 7,
-            action: "Set module example data",
-            description: "Set example/static data for module preview. MUST call get_module first to discover ALL variables.",
-            tool: "set_module_example_data",
-            critical: "Every builder variable must have example data. Missing variables cause blank previews."
-        },
-        {
-            step: 8,
-            action: "Add sample content",
-            description: "Create 2-3 sample records with realistic content and images. If table has enlace=true, include the 'enlace' field with a URL slug.",
-            tool: "create_or_update_record",
-            critical: "Date format: YYYY-MM-DD HH:mm:ss. Checkbox: 1 or 0. Upload fields: use upload_record_image separately. For sections with enlace, creating records first ensures directory structure is ready."
-        },
-        {
-            step: 9,
-            action: "Create detail template (if enlace=true)",
-            description: "If the section has enlace enabled, create the detail page template that shows when navigating to a record's URL.",
-            tool: "save_general_section",
-            critical: "Use 'thisrecord' variable to access the current record. Same Twig rules apply. Note: save_general_section will auto-initialize the directory if needed."
-        },
-        {
-            step: 10,
-            action: "Verify the result",
-            description: "Check module rendering with actual variable values.",
-            tool: "check_module",
-            critical: "Test with actual variable values to ensure no rendering errors."
-        }
-    ],
-    context: {
-        twig_filters: "Use 'get' filter for DB queries: {% set items = 'tablename' | get('WHERE active=1', 'ORDER BY num DESC', 10) %}. Use 'imagec' for image resize: {{ path | imagec(400) }}. Use 'module' to include other modules: {{ 'modulename' | module(vars) }}.",
-        field_types: "textfield (single line), textbox (multiline), wysiwyg (rich HTML), date (YYYY-MM-DD), checkbox (0/1), list (dropdown/radio/checkbox), upload (files/images), multitext (key-value pairs), codigo (code editor), separator (visual divider).",
-        list_field_config: "Static options: optionsType='text', optionsText='value1|Label 1\\nvalue2|Label 2'. Table relation: optionsType='table', optionsTablename='tablename', optionsValueField='num', optionsLabelField='name'. SQL: optionsType='query', optionsText='SELECT num,name FROM cms_tablename'.",
-        builder_vars: "data-field-type attribute on HTML elements creates editable fields. Types: textfield, headfield, textbox, wysiwyg, link, upload, uploadBackground, uploadMulti, list, multiv2. Variable names derived from labels (lowercase, no spaces/accents).",
-        upload_rules: "Upload fields ALWAYS return arrays. Single image: {{ record.imagen[0].urlPath | imagec(WIDTH) }}. Gallery loop: {% for img in record.galeria %}{{ img.urlPath }}{% endfor %}. Check existence: {% if record.imagen and record.imagen|length > 0 %}."
-    },
-    rules: [
-        "Table names WITHOUT 'cms_' prefix in all tool calls",
-        "Primary key is ALWAYS 'num', never 'id'",
-        "Upload fields are ALWAYS arrays of objects with urlPath property",
-        "Use ONLY Twig FILTERS (pipe syntax), not Twig functions",
-        "Date format: YYYY-MM-DD HH:mm:ss",
-        "Checkbox values: 1 or 0 (number, not boolean)",
-        "Enlace (URL slug): auto-formatted to /path/ with slashes",
-        "Variable names in modules: lowercase, no spaces, no accents, no special chars",
-        "c-if='varname' for conditional rendering, c-hidden='true' for invisible config vars",
-        "When using 'get' filter: SQL string syntax, NOT objects. Example: 'WHERE num > 5'"
-    ],
-    warnings: [
-        "DO NOT use record.imagen.urlPath — it's record.imagen[0].urlPath (array!)",
-        "DO NOT use 'id' as primary key — Acai uses 'num'",
-        "DO NOT forget to set example data after creating a module — it will look blank",
-        "DO NOT create a detail template if enlace is false — there's no URL to navigate to",
-        "DO NOT use Twig functions like range() — only filters (pipe syntax) are available",
-        "For best results with new enlace sections, create records BEFORE calling save_general_section to ensure directory structure exists"
-    ],
-    resources: [
-        "acai://resources/guia-builder-vars",
-        "acai://resources/guia-twig-filters",
-        "acai://resources/guia-atributos-acai",
-        "acai://resources/guia-registros"
-    ]
-};

mcp-server/tools/orchestrator/workflows/editModule.js

@@ -1,64 +0,0 @@
-export const editModuleWorkflow = {
-    id: "edit_module",
-    name: "Edit Module",
-    description: "Modify an existing HTML module: update code, styles, variables, or structure.",
-    steps: [
-        {
-            step: 1,
-            action: "Get current module code",
-            description: "Read the current HTML, CSS, JS, and PHP of the module.",
-            tool: "get_module",
-            critical: "ALWAYS read the current code before modifying. Understand existing variables, structure, and styling."
-        },
-        {
-            step: 2,
-            action: "Check where it's used",
-            description: "Find all pages and records using this module to understand impact.",
-            tool: "check_module_usage",
-            critical: "Know the blast radius of your changes — how many live pages will be affected."
-        },
-        {
-            step: 3,
-            action: "Make changes",
-            description: "Update the module code with the required modifications.",
-            tool: "save_module",
-            critical: "Pass the module 'id' parameter to update (not create). save_module REPLACES the entire module — include ALL html/css/js, not just the changed parts."
-        },
-        {
-            step: 4,
-            action: "Update example data if needed",
-            description: "If you added or renamed variables, update the example data to match.",
-            tool: "set_module_example_data",
-            critical: "Call get_module first to discover new variable names. Fill ALL variables, including new ones."
-        },
-        {
-            step: 5,
-            action: "Verify rendering",
-            description: "Test the modified module with variable values to confirm changes work.",
-            tool: "check_module",
-            critical: "Test with realistic values. Compare rendering before and after changes."
-        }
-    ],
-    context: {
-        builder_vars: "data-field-type attribute on elements creates editable fields. Types: textfield, headfield, textbox, wysiwyg, link, upload, uploadBackground, uploadMulti, list, multiv2.",
-        component_syntax: "c-if='varname' shows/hides element. c-for='item in items' loops. c-hidden='true' invisible config. c-else after c-if.",
-        save_behavior: "save_module with 'id' parameter = UPDATE. Without 'id' = CREATE new. The tool replaces the ENTIRE module code, not a diff."
-    },
-    rules: [
-        "ALWAYS include the full html/css/js when saving — save_module replaces everything",
-        "Pass the 'id' parameter to update an existing module",
-        "Variable names: lowercase, no spaces, no accents",
-        "Labels must be UNIQUE across the module",
-        "Upload fields are ALWAYS arrays — access with [0].urlPath"
-    ],
-    warnings: [
-        "DO NOT remove existing variables without checking usage — they may have data on live pages",
-        "DO NOT rename variables — it breaks existing data bindings. Add new ones instead if needed",
-        "DO NOT save partial code (just HTML without CSS) — save_module replaces ALL sections",
-        "DO NOT forget to update example data when adding new variables"
-    ],
-    resources: [
-        "acai://resources/guia-builder-vars",
-        "acai://resources/guia-atributos-acai"
-    ]
-};

mcp-server/tools/orchestrator/workflows/exploreSite.js

@@ -1,48 +0,0 @@
-export const exploreSiteWorkflow = {
-    id: "explore_site",
-    name: "Explore Site",
-    description: "Get an overview of the current Acai site: sections, modules, content.",
-    steps: [
-        {
-            step: 1,
-            action: "List all tables/sections",
-            description: "Get the complete site structure with all sections, their types, and menu order.",
-            tool: "list_tables",
-            critical: "This returns the site's skeleton: all sections with type (multi/single/category/separador), menu name, and order."
-        },
-        {
-            step: 2,
-            action: "Inspect sections of interest",
-            description: "Get the full schema of specific sections to understand their fields and configuration.",
-            tool: "get_table_schema",
-            critical: "Look at field types, required fields, list configurations, and upload fields."
-        },
-        {
-            step: 3,
-            action: "List all modules",
-            description: "See all available design components/modules.",
-            tool: "list_modules",
-            critical: "Modules are the visual building blocks. Each has HTML, CSS, JS, and builder variables."
-        },
-        {
-            step: 4,
-            action: "Sample content",
-            description: "Preview records in key sections to understand what content exists.",
-            tool: "list_table_records",
-            critical: "Use limit=5 to get a representative sample without overwhelming the response."
-        }
-    ],
-    context: {
-        orientation: "list_tables returns all sections with their type: 'multi' (multiple records like blog/products), 'single' (one record like about page), 'category' (grouping for other sections), 'separador' (menu separator). This is the site's architecture.",
-        modules_overview: "list_modules shows all components. Use get_module on specific ones to see their HTML/CSS/JS code and builder variables."
-    },
-    rules: [
-        "Table names WITHOUT 'cms_' prefix",
-        "Primary key is 'num', never 'id'"
-    ],
-    warnings: [
-        "DO NOT modify anything during exploration — this workflow is read-only",
-        "DO NOT assume field names — always check the schema first"
-    ],
-    resources: []
-};

mcp-server/tools/orchestrator/workflows/index.js

@@ -1,44 +0,0 @@
-import { createSectionWorkflow } from "./createSection.js";
-import { populateContentWorkflow } from "./populateContent.js";
-import { createModuleWorkflow } from "./createModule.js";
-import { editModuleWorkflow } from "./editModule.js";
-import { manageRecordsWorkflow } from "./manageRecords.js";
-import { manageMediaWorkflow } from "./manageMedia.js";
-import { seoSetupWorkflow } from "./seoSetup.js";
-import { exploreSiteWorkflow } from "./exploreSite.js";
-
-/**
- * Registry of all available workflows.
- * Keyed by workflow ID for fast lookup.
- */
-export const WORKFLOWS = {
-    create_section: createSectionWorkflow,
-    populate_content: populateContentWorkflow,
-    create_module: createModuleWorkflow,
-    edit_module: editModuleWorkflow,
-    manage_records: manageRecordsWorkflow,
-    manage_media: manageMediaWorkflow,
-    seo_setup: seoSetupWorkflow,
-    explore_site: exploreSiteWorkflow,
-};
-
-/**
- * Get a workflow by ID.
- * @param {string} id - Workflow identifier
- * @returns {object|null} The workflow definition or null
- */
-export function getWorkflow(id) {
-    return WORKFLOWS[id] || null;
-}
-
-/**
- * Get a summary list of all available workflows (for help/listing).
- */
-export function listWorkflows() {
-    return Object.values(WORKFLOWS).map((w) => ({
-        id: w.id,
-        name: w.name,
-        description: w.description,
-        totalSteps: w.steps.length,
-    }));
-}

mcp-server/tools/orchestrator/workflows/manageMedia.js

@@ -1,53 +0,0 @@
-export const manageMediaWorkflow = {
-    id: "manage_media",
-    name: "Manage Media",
-    description: "Image upload, generation, replacement, and management.",
-    steps: [
-        {
-            step: 1,
-            action: "Prepare or generate images",
-            description: "Use an existing image URL/asset or generate an AI image for the content.",
-            tool: "generate_image",
-            critical: "generate_image uses Nano Banana AI. Existing remote image URLs can also be passed directly to upload tools."
-        },
-        {
-            step: 2,
-            action: "Upload to record",
-            description: "Attach images to a record's upload field.",
-            tool: "upload_record_image",
-            critical: "Requires: tableName, recordId, fieldName, imageUrl. The image is downloaded server-side and attached to the record."
-        },
-        {
-            step: 3,
-            action: "List current uploads",
-            description: "Check what's already uploaded in a field to know if replacing or adding.",
-            tool: "list_record_uploads",
-            critical: "Returns array of upload objects with uploadId needed for replace/delete operations."
-        },
-        {
-            step: 4,
-            action: "Replace or delete if needed",
-            description: "Replace an existing image or delete an upload.",
-            tool: "replace_record_image OR delete_record_upload",
-            critical: "Both require the uploadId from list_record_uploads. replace_record_image downloads new image and swaps it."
-        }
-    ],
-    context: {
-        upload_structure: "Upload fields store arrays of objects: [{urlPath, fileName, fileSize, mimeType, uploadDate}]. Access in Twig templates: record.field[0].urlPath | imagec(width).",
-        image_sources: "Use existing remote image URLs, project assets, or Nano Banana AI image generation.",
-        assets_upload: "upload_image_to_assets: uploads to website /images/ folder (not tied to a record). Accepts base64, data URI, or URL. Can resize and compress.",
-        s3_upload: "upload_image_to_s3: uploads to Amazon S3. Returns public S3 URL. Accepts URL, local path, base64, or data URI."
-    },
-    rules: [
-        "Table names WITHOUT 'cms_' prefix",
-        "Primary key is 'num', never 'id'",
-        "Upload fields are ALWAYS arrays of objects with urlPath property",
-        "Use imagec filter for resizing: {{ path | imagec(width_in_pixels) }}"
-    ],
-    warnings: [
-        "DO NOT try to upload before creating the record — the record must exist first",
-        "DO NOT confuse upload_record_image (attaches to record) with upload_image_to_assets (saves to /images/ folder)",
-        "DO NOT delete uploads without confirming — the image will be removed from the live page"
-    ],
-    resources: []
-};

mcp-server/tools/orchestrator/workflows/manageRecords.js

@@ -1,64 +0,0 @@
-export const manageRecordsWorkflow = {
-    id: "manage_records",
-    name: "Manage Records",
-    description: "CRUD operations on existing records: query, create, update, and delete data.",
-    steps: [
-        {
-            step: 1,
-            action: "Get table schema",
-            description: "Understand field names, types, and constraints before querying or modifying.",
-            tool: "get_table_schema",
-            critical: "Know the exact field names and types. Upload fields require special handling."
-        },
-        {
-            step: 2,
-            action: "Query records",
-            description: "List or search records to find the ones to work with.",
-            tool: "list_table_records",
-            critical: "Use 'where' param for SQL WHERE filtering. Use 'limit' for pagination. Use 'page' for page navigation."
-        },
-        {
-            step: 3,
-            action: "Create or update records",
-            description: "Create new records or update existing ones with correct field values.",
-            tool: "create_or_update_record",
-            critical: "Pass 'recordId' for update, omit for create. Only included fields are modified on update. Field values must match field types."
-        },
-        {
-            step: 4,
-            action: "Handle uploads if needed",
-            description: "Upload images or files to record fields.",
-            tool: "upload_record_image",
-            critical: "Separate call per image per field per record. Cannot set upload fields via create_or_update_record."
-        },
-        {
-            step: 5,
-            action: "Verify changes",
-            description: "Query the records again to confirm changes were applied correctly.",
-            tool: "list_table_records",
-            critical: "Confirm all fields have the expected values, including upload fields."
-        }
-    ],
-    context: {
-        querying: "list_table_records supports: where='campo = \"valor\"' (SQL WHERE), page=1 (pagination), limit=20 (records per page). WHERE clause uses SQL string syntax.",
-        updating: "Pass recordId + fields object to update. Only the fields included in the object are modified — other fields are left unchanged.",
-        creating: "Omit recordId to create. Can batch insert by passing fields as an array of objects.",
-        deleting: "delete_table_records requires tableName and recordIds (array of IDs). Use deleteAll=true to delete everything (DANGEROUS)."
-    },
-    rules: [
-        "Table names WITHOUT 'cms_' prefix in all tool calls",
-        "Primary key is ALWAYS 'num', never 'id'",
-        "Upload fields CANNOT be set via create_or_update_record — use upload_record_image",
-        "Date format: YYYY-MM-DD HH:mm:ss",
-        "Checkbox values: 1 or 0 (number, not boolean)",
-        "WHERE clauses use SQL string syntax: where='nombre = \"valor\"'"
-    ],
-    warnings: [
-        "DO NOT use 'id' to reference records — use 'num'",
-        "DO NOT set upload fields via create_or_update_record — it will not work",
-        "DO NOT delete records without confirming with the user first"
-    ],
-    resources: [
-        "acai://resources/guia-registros"
-    ]
-};

mcp-server/tools/orchestrator/workflows/populateContent.js

@@ -1,70 +0,0 @@
-export const populateContentWorkflow = {
-    id: "populate_content",
-    name: "Populate Content",
-    description: "Bulk record creation with images for an existing section.",
-    steps: [
-        {
-            step: 1,
-            action: "Get table schema",
-            description: "Understand all fields and their types before creating records.",
-            tool: "get_table_schema",
-            critical: "Know the exact field names and types. Upload fields cannot be set via create_or_update_record."
-        },
-        {
-            step: 2,
-            action: "List existing records",
-            description: "Check what already exists to avoid duplicates.",
-            tool: "list_table_records",
-            critical: "Review existing content before adding new records."
-        },
-        {
-            step: 3,
-            action: "Generate images if needed",
-            description: "Create AI images for the content being created when existing assets are not available.",
-            tool: "generate_image",
-            critical: "Generate the image first and use the returned URL for upload later."
-        },
-        {
-            step: 4,
-            action: "Create records",
-            description: "Create all records with text content. Can batch insert multiple records in one call.",
-            tool: "create_or_update_record",
-            critical: "Batch insert: pass an array of objects in 'fields' parameter. Date format: YYYY-MM-DD HH:mm:ss. Checkbox: 1 or 0."
-        },
-        {
-            step: 5,
-            action: "Upload images to records",
-            description: "Attach images to each record's upload fields.",
-            tool: "upload_record_image",
-            critical: "Must call SEPARATELY for each record+field combination. Cannot batch image uploads. Need the record's num/ID from step 4."
-        },
-        {
-            step: 6,
-            action: "Verify records",
-            description: "Confirm all records were created with correct data.",
-            tool: "list_table_records",
-            critical: "Check that all fields are populated correctly including upload fields."
-        }
-    ],
-    context: {
-        batch_insert: "create_or_update_record supports batch: pass fields as an array of objects instead of a single object. Each object is one record. Returns an array of created record IDs.",
-        image_sources: "Use existing project/client assets when available, or generate_image for AI-generated images via Nano Banana.",
-        upload_flow: "1. Create record first (get its num/ID). 2. Then call upload_record_image with tableName, recordId, fieldName, imageUrl. 3. The image is downloaded server-side and attached to the record."
-    },
-    rules: [
-        "Table names WITHOUT 'cms_' prefix in all tool calls",
-        "Primary key is ALWAYS 'num', never 'id'",
-        "Upload fields CANNOT be set via create_or_update_record — use upload_record_image",
-        "Date format: YYYY-MM-DD HH:mm:ss",
-        "Checkbox values: 1 or 0 (number, not boolean)",
-        "Enlace field: auto-formatted to /path/ with slashes if not provided"
-    ],
-    warnings: [
-        "DO NOT try to set upload field values in create_or_update_record — use upload_record_image after creation",
-        "DO NOT forget that batch insert returns an array of created record IDs — you need these for image uploads",
-        "DO NOT upload images before creating the record — the record must exist first"
-    ],
-    resources: [
-        "acai://resources/guia-registros"
-    ]
-};

mcp-server/tools/orchestrator/workflows/seoSetup.js

@@ -1,58 +0,0 @@
-export const seoSetupWorkflow = {
-    id: "seo_setup",
-    name: "SEO Setup",
-    description: "Configure SEO for a section: meta tags, URL slugs, and structured data.",
-    steps: [
-        {
-            step: 1,
-            action: "Get current table schema",
-            description: "Check if seo_metas is already enabled and if enlace (URL slug) exists.",
-            tool: "get_table_schema",
-            critical: "Look for seo_metas flag and enlace configuration in the schema response."
-        },
-        {
-            step: 2,
-            action: "Enable SEO meta tags",
-            description: "Turn on seo_metas in the table schema to add meta title/description fields.",
-            tool: "update_table_schema",
-            critical: "Set seo_metas=true in the schema. This adds SEO fields to each record."
-        },
-        {
-            step: 3,
-            action: "Enable enlace for URL slugs",
-            description: "Enable enlace so records get their own URL-friendly pages.",
-            tool: "update_table_schema",
-            critical: "Set enlace=true. This auto-generates /section/record-name/ URLs for each record."
-        },
-        {
-            step: 4,
-            action: "Update records with SEO data",
-            description: "Fill in SEO fields for each record: meta title, meta description.",
-            tool: "create_or_update_record",
-            critical: "SEO fields are typically: seo_title, seo_description. Check the schema for exact field names."
-        },
-        {
-            step: 5,
-            action: "Create or update detail template",
-            description: "Ensure the detail page template includes proper meta tags and structured data.",
-            tool: "save_general_section",
-            critical: "The template uses 'thisrecord' variable. Include meta tags in the template for SEO."
-        }
-    ],
-    context: {
-        enlace_behavior: "When enlace is enabled, Acai auto-generates URL slugs in /section/record-name/ format. The enlace field value is auto-formatted with slashes.",
-        seo_fields: "Enabling seo_metas adds meta title and description fields to the record editor. These are used in the <head> of the detail page.",
-        detail_template: "The general section template (save_general_section) defines what renders when a user visits a record's URL. Uses 'thisrecord' to access the current record's data."
-    },
-    rules: [
-        "Table names WITHOUT 'cms_' prefix",
-        "update_table_schema requires both tableName and the schema object",
-        "Enlace values are auto-formatted to /path/ format",
-        "SEO meta fields are only available after enabling seo_metas on the table"
-    ],
-    warnings: [
-        "DO NOT enable enlace on a 'single' type table — single tables have only one record and usually don't need individual URLs",
-        "DO NOT forget to create a detail template after enabling enlace — without it, record URLs show blank pages"
-    ],
-    resources: []
-};

mcp-server/tools/project/getWebUrl.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { getSessionCredentials } from "../../auth/index.js";
+import { handleToolError } from "../helpers/errorHandler.js";
+import { withAuthParams } from "../helpers/authSchema.js";
+
+export function registerGetWebUrlTool(server) {
+    server.tool(
+        "get_web_url",
+        `Get the correct URL for the project's development website. Always use this URL for fetch, Playwright, or any HTTP request to the site. Never guess or use production domains.`,
+        withAuthParams({}),
+        { readOnlyHint: true, destructiveHint: false },
+        async (_params, extra) => {
+            try {
+                const sessionId = extra?.sessionId || "_default";
+                const credentials = await getSessionCredentials(sessionId);
+
+                if (!credentials || !credentials.web_url) {
+                    return {
+                        content: [{ type: "text", text: "Error: no web_url available. Run select_project first." }],
+                        isError: true,
+                    };
+                }
+
+                // En modo local forzamos http:// porque los certificados SSL de
+                // los subdominios forge pueden no validar correctamente en
+                // playwright/fetch/curl desde el container. En produccion se
+                // mantiene https:// (el sitio real tiene certificado valido).
+                let webUrl = credentials.web_url;
+                if (credentials.mode !== "production" && typeof webUrl === "string" && webUrl.startsWith("https://")) {
+                    webUrl = "http://" + webUrl.slice("https://".length);
+                }
+
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            web_url: webUrl,
+                            api_web_url: credentials.api_web_url || null,
+                            website: credentials.website || null,
+                            note: "Always use web_url for Playwright/fetch. IMPORTANT: Always append ?pruebas=1 to any URL you visit (e.g. web_url + '/?pruebas=1' or web_url + '/servicios/?pruebas=1'). Never use the production domain directly.",
+                        })
+                    }],
+                };
+            } catch (error) {
+                return handleToolError(error, "get_web_url", {});
+            }
+        }
+    );
+}

mcp-server/tools/project/index.js

@@ -1,5 +1,10 @@
 import { registerSaveProjectStylesTool } from "./saveStyles.js";
+import { registerGetWebUrlTool } from "./getWebUrl.js";
+import { canEditCode } from "../helpers/roleCheck.js";
 
 export function registerProjectTools(server) {
+    registerGetWebUrlTool(server);  // siempre
+    if (canEditCode()) {
         registerSaveProjectStylesTool(server);
+    }
 }

mcp-server/tools/project/saveStyles.js

@@ -4,6 +4,7 @@ import { handleToolError } from "../helpers/errorHandler.js";
 import { withAuthParams } from "../helpers/authSchema.js";
 import fs from "fs";
 import path from "path";
+import { resolveCurrentProjectDir } from "../files/helpers.js";
 
 export function registerSaveProjectStylesTool(server) {
     server.tool(
@@ -24,8 +25,8 @@ The content should include: color palette (hex values), typography, spacing patt
                     };
                 }
 
-                // Get project directory from env
-                const projectDir = process.env.ACAI_PROJECT_DIR || "";
+                // Get project directory from session (HTTP) or env (stdio fallback)
+                const projectDir = resolveCurrentProjectDir();
                 if (!projectDir) {
                     return {
                         content: [{ type: "text", text: "Error: ACAI_PROJECT_DIR not set" }],

mcp-server/tools/records/addModuleToRecord.js

@@ -3,6 +3,7 @@ import { withAuth, getSessionCredentials } from "../../auth/index.js";
 import { handleApiResponse, handleToolError, validateRequired } from "../helpers/errorHandler.js";
 import { AcaiHttpClient } from "../helpers/acaiHttpClient.js";
 import { withAuthParams } from "../helpers/authSchema.js";
+import { canAccessTable } from "../helpers/accessControl.js";
 
 export function registerAddModuleToRecordTool(server) {
     server.tool(
@@ -29,6 +30,12 @@ Response includes: sectionId, moduleId, position, totalModules`,
                 const validationError = validateRequired({ tableName, recordNum, moduleId }, ['tableName', 'recordNum', 'moduleId'], 'add_module_to_record');
                 if (validationError) return validationError;
 
+                // Check table access
+                const accessCheck = canAccessTable(tableName);
+                if (!accessCheck.allowed) {
+                    return { content: [{ type: "text", text: JSON.stringify({ success: false, error: accessCheck.error }) }], isError: true };
+                }
+
                 const sessionId = extra.sessionId;
                 const credentials = await getSessionCredentials(sessionId);
                 const payload = {

mcp-server/tools/records/createUpdate.js

@@ -4,20 +4,21 @@ import { handleToolError, validateRequired, handleApiResponse } from "../helpers
 import { AcaiHttpClient } from "../helpers/acaiHttpClient.js";
 import { table } from "console";
 import { withAuthParams } from "../helpers/authSchema.js";
+import { canAccessTable } from "../helpers/accessControl.js";
 
 export function registerCreateOrUpdateRecordTool(server) {
     server.tool(
         "create_or_update_record",
-        `Create or update records in a database table. Before using: read resource 'acai-cheat-sheet' for domain rules, then check table schema with get_table_schema.
+        `Crea o actualiza registros en una tabla. Antes de usar: consulta el schema con 'get_table_schema' (sin 'cms_'); si dudas del formato lee 'read_doc({ name: "11-quick-reference" })' o '06-hooks-and-cmsapi'.
 
-    Key rules: tables without 'cms_' prefix, primary key is 'num', uploads are arrays (use upload_record_image after creating record), dates as YYYY-MM-DD HH:mm:ss, checkboxes as 1/0, enlace as /path/.
+Reglas clave: tablas sin prefijo 'cms_'; PK es 'num' (nunca 'id'); foreign keys con sufijo '_num'; uploads son arrays — NO los envíes en 'fields', sube después con 'upload_record_image'; fechas en formato YYYY-MM-DD HH:mm:ss; checkboxes como 1/0 (números).
 
-    For builder tables (e.g. 'apartados'): must include num:null, builder:"[]", controlador, precontrolador, breadcrumb, enlace fields. See resource 'guia-registros' for full field type reference.`,
+Para tablas builder (e.g. 'apartados') al crear nuevo registro: incluye num:null, builder:"[]", controlador, precontrolador, breadcrumb, enlace. NUNCA modifiques 'enlace' ni 'controlador' de un registro existente — los stripeo automáticamente en updates.`,
         withAuthParams({
-            tableName: z.string().describe("Name of the table (without 'cms_' prefix, e.g., 'productos', 'equipo')"),
-            recordId: z.any().optional().describe("Record ID for updating. Leave empty to create new record. NOT USED when records is an array."),
-            fields: z.any().describe("Single record object OR array of record objects for batch insert. Example: { nombre: 'Product 1' } or [{ nombre: 'Product 1' }, { nombre: 'Product 2' }]. IMPORTANT: Always consult 'guia-registros' for field types and formats and check if is table with builder fields."),
-            tableSchema: z.any().describe("Provide the table schema object to validate field types before sending to API. If not provided, schema will not be validated."),
+            tableName: z.string().describe("Nombre de la tabla sin prefijo 'cms_' (e.g. 'productos', 'apartados')"),
+            recordId: z.any().optional().describe("'num' del registro a actualizar. Omitir para crear nuevo. NO se usa cuando 'fields' es array."),
+            fields: z.any().describe("Objeto único o array de objetos para inserción batch. Ejemplo: { nombre: 'Producto 1' } o [{ nombre: 'A' }, { nombre: 'B' }]. Antes consulta el schema y, si dudas, lee 'read_doc({ name: \"11-quick-reference\" })'."),
+            tableSchema: z.any().describe("Schema de la tabla para validar tipos antes de enviar (opcional)."),
         }),
         { readOnlyHint: false, destructiveHint: false },
         withAuth(async ({ tableName, recordId, fields }, extra) => {
@@ -26,6 +27,12 @@ export function registerCreateOrUpdateRecordTool(server) {
                 const validationError = validateRequired({ tableName, fields }, ['tableName', 'fields'], 'create_or_update_record');
                 if (validationError) return validationError;
 
+                // Check table access
+                const accessCheck = canAccessTable(tableName);
+                if (!accessCheck.allowed) {
+                    return { content: [{ type: "text", text: JSON.stringify({ success: false, error: accessCheck.error }) }], isError: true };
+                }
+
                 // if fields is string, try to parse as JSON
                 if (typeof fields === 'string') {
                     try {

mcp-server/tools/records/delete.js

@@ -3,6 +3,7 @@ import { withAuth, getSessionCredentials } from "../../auth/index.js";
 import { handleToolError, validateRequired, handleApiResponse } from "../helpers/errorHandler.js";
 import { AcaiHttpClient } from "../helpers/acaiHttpClient.js";
 import { withAuthParams } from "../helpers/authSchema.js";
+import { canAccessTable } from "../helpers/accessControl.js";
 
 export function registerDeleteTableRecordsTool(server) {
     server.tool(
@@ -20,6 +21,12 @@ export function registerDeleteTableRecordsTool(server) {
                 const validationError = validateRequired({ tableName }, ['tableName'], 'delete_table_records');
                 if (validationError) return validationError;
 
+                // Check table access
+                const accessCheck = canAccessTable(tableName);
+                if (!accessCheck.allowed) {
+                    return { content: [{ type: "text", text: JSON.stringify({ success: false, error: accessCheck.error }) }], isError: true };
+                }
+
                 if (!recordIds && !deleteAll) {
                     return {
                         content: [{ type: "text", text: "Error: You must provide either 'recordIds' or set 'deleteAll' to true." }],