gufi-cli 0.1.17 → 0.1.18

package/CLAUDE.md

@@ -1,2107 +1,206 @@
-# Gufi CLI - Documentación Completa para Claude
+# Gufi CLI - Documentación para Claude
 
-## ¿Qué es Gufi?
+> **Documentación centralizada en `docs/claude/`**
+>
+> Este archivo es un puntero. Para documentación completa del CLI, lee:
+> - [docs/claude/06-cli.md](../../docs/claude/06-cli.md) - Comandos del CLI
+> - [docs/claude/00-index.md](../../docs/claude/00-index.md) - Overview de Gufi
+> - [docs/claude/05-automations.md](../../docs/claude/05-automations.md) - Automations
+> - [docs/claude/04-views.md](../../docs/claude/04-views.md) - Sistema de vistas
 
-Gufi es un **ERP multi-tenant** donde cada empresa (company) tiene su propia base de datos aislada. Los consultores pueden crear módulos personalizados sin programar - solo definiendo JSONs que describen la estructura de datos.
-
-**Filosofía**: "Simple · Professional · Elegance" - El Apple de los ERPs
-
-### Arquitectura General
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                         GUFI ERP                                │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│   Company 116 (Fitvending)     Company 146 (Gufi)              │
-│   ├── Schema: company_116      ├── Schema: company_146         │
-│   ├── Módulo: Nayax (308)      ├── Módulo: Tareas (360)        │
-│   │   └── Tablas: m308_t4136   │   └── Tablas: m360_t16192     │
-│   └── Módulo: Stock (310)      └── Módulo: Incidencias (361)   │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│   core.modules        → Definiciones JSON de módulos            │
-│   core.entities       → Metadatos (permissions, automations)    │
-│   core.entities.automations → FUENTE DE VERDAD de automations   │
-│   core.automation_scripts → Código JavaScript de automations    │
-│   core.automation_meta    → Índice para worker (sync auto)      │
-├─────────────────────────────────────────────────────────────────┤
-│   marketplace.packages    → Paquetes publicados                 │
-│   marketplace.views       → Vistas React/TypeScript             │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Nomenclatura de Tablas
-
-Las tablas físicas en PostgreSQL siguen el patrón:
-```
-m{moduleId}_t{entityId}
-```
-
-Ejemplo:
-- Módulo "Tareas" tiene ID 360
-- Entidad "asignaciones" tiene ID 16192
-- Tabla física: `m360_t16192` en schema `company_146`
-
----
-
-## 💜 Core Database - Relaciones Importantes
-
-### Diagrama de Relaciones
-
-```
-┌─────────────────────────────────────────────────────────────────────────────┐
-│                           SCHEMA: core                                       │
-├─────────────────────────────────────────────────────────────────────────────┤
-│                                                                             │
-│  companies (1)                                                              │
-│  ├── id: 116                                                                │
-│  ├── name: "Fitvending"                                                     │
-│  └── schema: "company_116"                                                  │
-│           │                                                                 │
-│           │ 1:N                                                             │
-│           ▼                                                                 │
-│  modules (N)                        users (N)                               │
-│  ├── id: 308                        ├── id: 16                              │
-│  ├── company_id: 116 ◄──────────    ├── email: "juan@gufi.es"               │
-│  ├── name: "nayax"                  └── platform_role: "admin"              │
-│  └── json_definition: {...}                  │                              │
-│           │                                  │ N:M                          │
-│           │ 1:N                              ▼                              │
-│           ▼                         company_users                           │
-│  entities (N)                       ├── user_id: 16                         │
-│  ├── id: 4136                       ├── company_id: 116                     │
-│  ├── module_id: 308 ◄───────────    └── roles: ["Admin"]                    │
-│  ├── company_id: 116                                                        │
-│  ├── name: "machines"                                                       │
-│  ├── permissions: {"Admin": "*"}    ◄── Permisos por rol                    │
-│  └── automations: [{...}]           ◄── JSONB array de triggers             │
-│           │                                                                 │
-│           │ N:1 (via script_id en automations)                              │
-│           ▼                                                                 │
-│  automation_scripts (N)                                                     │
-│  ├── id: 15                                                                 │
-│  ├── company_id: 116                                                        │
-│  ├── name: "sync_machines"                                                  │
-│  └── code: "async function..."      ◄── El JavaScript                      │
-│           │                                                                 │
-│           │ (sync automático)                                               │
-│           ▼                                                                 │
-│  automation_meta (índice para worker)                                       │
-│  automation_executions (historial)                                          │
-│                                                                             │
-└─────────────────────────────────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────────────────────────────────┐
-│                        SCHEMA: company_116                                   │
-├─────────────────────────────────────────────────────────────────────────────┤
-│                                                                             │
-│  m308_t4136 (machines)     m308_t4137 (products)    m308_t4140 (sales)     │
-│  ├── id                    ├── id                    ├── id                 │
-│  ├── name                  ├── name                  ├── machine_id (FK)    │
-│  └── ...                   └── ...                   └── ...                │
-│                                                                             │
-│  __audit_log__ (historial de cambios)                                       │
-│                                                                             │
-└─────────────────────────────────────────────────────────────────────────────┘
-```
-
-### Tablas Core Principales
-
-| Tabla | Descripción | Relaciones |
-|-------|-------------|------------|
-| `companies` | Empresas/tenants | 1 company → N modules, N users |
-| `users` | Usuarios globales | N:M con companies via company_users |
-| `company_users` | Membresía usuario-empresa | Contiene roles[] del usuario en esa company |
-| `modules` | Definición JSON de módulos | 1 module → N entities |
-| `entities` | Metadatos de tablas | Contiene permissions, automations, config |
-| `automation_scripts` | Código JavaScript | 1 script → N entities pueden usarlo |
-| `automation_meta` | Índice para worker | Generado auto desde entities.automations |
-
-### Flujo de Datos
-
-```
-Usuario hace login
-       │
-       ▼
-JWT contiene: { user_id, company_id, roles[], platform_role }
-       │
-       ▼
-Backend: SET search_path TO company_116, core;
-       │
-       ▼
-Queries van automáticamente al schema correcto
-```
-
-### IDs Importantes para CLI
-
-| Quiero trabajar con... | Necesito el ID de... | Cómo obtenerlo |
-|------------------------|---------------------|----------------|
-| Datos de una tabla | entity (tabla física: m308_t4136) | `gufi schema -c 116` |
-| Estructura de módulo | module_id | `gufi modules 116` |
-| Código de automation | script_id | `gufi automations -c 116` |
-| Triggers de una entity | entity_id | `gufi schema -c 116` |
-
----
-
-## Estructura de un Módulo (JSON)
-
-Un módulo es un JSON que define **toda la estructura de datos** de una funcionalidad. Gufi lee este JSON y automáticamente:
-1. Crea las tablas en PostgreSQL
-2. Genera la UI (formularios, listas, filtros)
-3. Configura permisos
-4. Vincula relaciones entre tablas
-
-### JSON Completo de Ejemplo
-
-```json
-{
-  "name": "ventas",
-  "displayName": "Gestión de Ventas",
-  "icon": "ShoppingCart",
-  "submodules": [
-    {
-      "name": "maestros",
-      "label": "Datos Maestros",
-      "icon": "Database",
-      "entities": [
-        {
-          "kind": "table",
-          "name": "clientes",
-          "label": "Clientes",
-          "fields": [
-            {
-              "name": "nombre",
-              "type": "text",
-              "label": "Nombre",
-              "required": true,
-              "searchable": true
-            },
-            {
-              "name": "email",
-              "type": "email",
-              "label": "Email",
-              "unique": true
-            },
-            {
-              "name": "telefono",
-              "type": "phone",
-              "label": "Teléfono"
-            },
-            {
-              "name": "tipo",
-              "type": "select",
-              "label": "Tipo de Cliente",
-              "options": [
-                { "value": "particular", "label": "Particular" },
-                { "value": "empresa", "label": "Empresa" },
-                { "value": "vip", "label": "VIP" }
-              ],
-              "default": "particular"
-            },
-            {
-              "name": "limite_credito",
-              "type": "currency",
-              "label": "Límite de Crédito",
-              "currency": "EUR"
-            },
-            {
-              "name": "activo",
-              "type": "boolean",
-              "label": "Activo",
-              "default": true
-            },
-            {
-              "name": "notas",
-              "type": "textarea",
-              "label": "Notas"
-            },
-            {
-              "name": "comercial_id",
-              "type": "users",
-              "label": "Comercial Asignado"
-            }
-          ],
-          "ui": {
-            "defaultSort": { "field": "nombre", "order": "ASC" },
-            "searchFields": ["nombre", "email"],
-            "listFields": ["nombre", "tipo", "comercial_id", "activo"]
-          }
-        },
-        {
-          "kind": "table",
-          "name": "productos",
-          "label": "Productos",
-          "fields": [
-            {
-              "name": "codigo",
-              "type": "text",
-              "label": "Código",
-              "required": true,
-              "unique": true
-            },
-            {
-              "name": "nombre",
-              "type": "text",
-              "label": "Nombre",
-              "required": true
-            },
-            {
-              "name": "precio",
-              "type": "currency",
-              "label": "Precio",
-              "currency": "EUR",
-              "required": true
-            },
-            {
-              "name": "stock",
-              "type": "number",
-              "label": "Stock",
-              "default": 0,
-              "min": 0
-            },
-            {
-              "name": "categoria",
-              "type": "multiselect",
-              "label": "Categorías",
-              "options": [
-                { "value": "electronica", "label": "Electrónica" },
-                { "value": "ropa", "label": "Ropa" },
-                { "value": "hogar", "label": "Hogar" }
-              ]
-            },
-            {
-              "name": "imagen",
-              "type": "image",
-              "label": "Imagen"
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "name": "operaciones",
-      "label": "Operaciones",
-      "icon": "FileText",
-      "entities": [
-        {
-          "kind": "table",
-          "name": "pedidos",
-          "label": "Pedidos",
-          "fields": [
-            {
-              "name": "numero",
-              "type": "text",
-              "label": "Nº Pedido",
-              "required": true,
-              "unique": true,
-              "autoGenerate": "PED-{YYYY}{MM}-{SEQ:5}"
-            },
-            {
-              "name": "cliente_id",
-              "type": "relation",
-              "label": "Cliente",
-              "ref": "clientes",
-              "display": "nombre",
-              "required": true
-            },
-            {
-              "name": "fecha",
-              "type": "date",
-              "label": "Fecha",
-              "default": "today"
-            },
-            {
-              "name": "estado",
-              "type": "select",
-              "label": "Estado",
-              "options": [
-                { "value": "borrador", "label": "Borrador", "color": "gray" },
-                { "value": "confirmado", "label": "Confirmado", "color": "blue" },
-                { "value": "enviado", "label": "Enviado", "color": "yellow" },
-                { "value": "entregado", "label": "Entregado", "color": "green" },
-                { "value": "cancelado", "label": "Cancelado", "color": "red" }
-              ],
-              "default": "borrador"
-            },
-            {
-              "name": "total",
-              "type": "currency",
-              "label": "Total",
-              "currency": "EUR",
-              "computed": true
-            },
-            {
-              "name": "responsable_id",
-              "type": "users",
-              "label": "Responsable"
-            },
-            {
-              "name": "observaciones",
-              "type": "textarea",
-              "label": "Observaciones"
-            }
-          ],
-          "automations": [
-            {
-              "trigger": "insert",
-              "function_name": "notificar_nuevo_pedido"
-            },
-            {
-              "trigger": "update",
-              "condition": "estado = 'confirmado'",
-              "function_name": "procesar_pedido"
-            },
-            {
-              "trigger": "click",
-              "function_name": "generar_factura",
-              "label": "Generar Factura",
-              "icon": "FileText",
-              "showWhen": "estado = 'entregado'"
-            }
-          ]
-        },
-        {
-          "kind": "table",
-          "name": "lineas_pedido",
-          "label": "Líneas de Pedido",
-          "fields": [
-            {
-              "name": "pedido_id",
-              "type": "relation",
-              "label": "Pedido",
-              "ref": "pedidos",
-              "required": true,
-              "cascade": true
-            },
-            {
-              "name": "producto_id",
-              "type": "relation",
-              "label": "Producto",
-              "ref": "productos",
-              "display": "nombre",
-              "required": true
-            },
-            {
-              "name": "cantidad",
-              "type": "number",
-              "label": "Cantidad",
-              "required": true,
-              "min": 1,
-              "default": 1
-            },
-            {
-              "name": "precio_unitario",
-              "type": "currency",
-              "label": "Precio Unit.",
-              "currency": "EUR"
-            },
-            {
-              "name": "subtotal",
-              "type": "currency",
-              "label": "Subtotal",
-              "currency": "EUR",
-              "computed": "cantidad * precio_unitario"
-            }
-          ],
-          "ui": {
-            "inline": true,
-            "parentField": "pedido_id"
-          }
-        }
-      ]
-    }
-  ]
-}
-```
-
-### Tipos de Campos Disponibles
-
-| Tipo | PostgreSQL | Descripción | Opciones |
-|------|------------|-------------|----------|
-| `text` | VARCHAR(255) | Texto corto | `maxLength`, `minLength`, `pattern` |
-| `textarea` | TEXT | Texto largo | `rows`, `maxLength` |
-| `number` | NUMERIC | Número | `min`, `max`, `decimals`, `step` |
-| `currency` | NUMERIC(15,2) | Dinero | `currency` (EUR, USD, etc.) |
-| `date` | DATE | Fecha | `min`, `max`, `default: "today"` |
-| `datetime` | TIMESTAMP | Fecha y hora | `min`, `max` |
-| `time` | TIME | Solo hora | - |
-| `select` | VARCHAR | Selector único | `options: [{value, label, color}]` |
-| `multiselect` | TEXT[] | Selector múltiple | `options: [{value, label}]` |
-| `relation` | INTEGER (FK) | Relación a otra tabla | `ref`, `display`, `cascade` |
-| `users` | INTEGER/INT[] | Usuario(s) del sistema | `multiple: true` |
-| `boolean` | BOOLEAN | Sí/No | `default` |
-| `email` | VARCHAR | Email validado | - |
-| `phone` | VARCHAR | Teléfono | `format` |
-| `url` | VARCHAR | URL | - |
-| `image` | TEXT | URL de imagen (GCS) | `maxSize`, `allowedTypes` |
-| `file` | TEXT | URL de archivo (GCS) | `maxSize`, `allowedTypes` |
-| `json` | JSONB | Objeto JSON | `schema` |
-| `color` | VARCHAR(7) | Color hex | - |
-| `rating` | SMALLINT | Puntuación 1-5 | `max` |
-| `percentage` | NUMERIC | Porcentaje | `min`, `max` |
-
-### Opciones de Campo
-
-```json
-{
-  "name": "campo",
-  "type": "text",
-  "label": "Etiqueta visible",
-  "required": true,           // Campo obligatorio
-  "unique": true,             // Valor único en la tabla
-  "default": "valor",         // Valor por defecto
-  "searchable": true,         // Incluir en búsqueda global
-  "hidden": false,            // Ocultar en UI
-  "readonly": false,          // Solo lectura
-  "computed": "expr",         // Calculado (no editable)
-  "autoGenerate": "pattern",  // Auto-generar valor
-  "validation": {             // Validaciones custom
-    "pattern": "^[A-Z]{3}",
-    "message": "Debe ser 3 letras mayúsculas"
-  }
-}
-```
-
-### Permisos por Rol
-
-> **⚠️ IMPORTANTE**: Los permisos ya NO se definen en el JSON del módulo.
-> Se gestionan exclusivamente via la columna `permissions` de `core.entities`.
-
-Al crear una entidad nueva, el Admin obtiene `"*"` (full access) automáticamente.
-Los permisos se gestionan desde la UI de permisos o directamente en la base de datos:
-
-```sql
--- Ejemplo: Configurar permisos de una entidad
-UPDATE core.entities
-SET permissions = '{"Admin": "*", "Manager": "crud", "User": "read"}'::jsonb
-WHERE id = 6420;
-```
-
-| Valor | Significado |
-|-------|-------------|
-| `"*"` | Full access |
-| `"crud"` | Create, Read, Update, Delete |
-| `"read"` | Solo lectura |
-| `""` | Sin acceso |
-
----
-
-## Automations (Código JavaScript)
-
-Las automations son **funciones JavaScript** almacenadas en la base de datos que se ejecutan en respuesta a eventos.
-
-### 💜 Nueva Arquitectura (2025)
-
-Las automations se almacenan en **tres lugares que trabajan juntos**:
-
-```
-core.entities.automations (JSONB)     ← FUENTE DE VERDAD
-        │                                (configuración de triggers)
-        │
-        ▼ (sync automático)
-core.automation_meta                  ← ÍNDICE PARA WORKER
-        │                                (sincronizado automáticamente)
-        │
-        ▼ (referencias)
-core.automation_scripts               ← CÓDIGO JAVASCRIPT
-                                         (la función que se ejecuta)
-```
-
-### Dónde se almacena cada cosa
-
-```sql
--- CONFIGURACIÓN: Qué automations tiene cada entity (triggers, enabled, etc.)
-SELECT id, name, automations FROM core.entities WHERE id = 4589;
-
--- CÓDIGO: El JavaScript de cada automation
-SELECT function_name, js_code FROM core.automation_scripts WHERE company_id = 116;
-
--- ÍNDICE: Lo que consulta el worker (sincronizado automáticamente)
-SELECT * FROM core.automation_meta WHERE company_id = 116;
-```
-
-### Tipos de Triggers
-
-| Trigger | Cuándo se ejecuta |
-|---------|-------------------|
-| `insert` | Al crear un registro |
-| `update` | Al modificar un registro |
-| `delete` | Al eliminar un registro |
-| `click` / `click` | Botón manual en la UI |
-| `scheduled` | Cron job (ej: "0 9 * * *") |
-
-### Formato de entities.automations
-
-```json
-[
-  {
-    "trigger": "insert",
-    "function_name": "procesar_pedido",
-    "script_id": 42,
-    "enabled": true
-  },
-  {
-    "trigger": "click",
-    "function_name": "generar_factura",
-    "label": "Generar Factura",
-    "enabled": true
-  }
-]
-```
-
-### Estructura de una Automation
-
-```javascript
-/**
- * Función: procesar_pedido
- * Trigger: update cuando estado = 'confirmado'
- *
- * @param {Object} context - Contexto de ejecución
- * @param {Object} api - API para interactuar con el sistema
- * @param {Object} logger - Logger para debugging
- */
-async function procesar_pedido(context, api, logger) {
-  // ═══════════════════════════════════════════════════════════
-  // CONTEXT - Información del evento
-  // ═══════════════════════════════════════════════════════════
-  const {
-    company_id,      // ID de la company (ej: 116)
-    module_id,       // ID del módulo (ej: 308)
-    entity_id,       // ID de la entidad/tabla (ej: 4136)
-    table,           // Nombre físico de tabla (ej: "m308_t4136")
-    row,             // Registro actual (después del cambio)
-    old_row,         // Registro anterior (solo en update)
-    input,           // Input del usuario (solo en click)
-    env,             // Variables de entorno de la company
-    user             // Usuario que disparó el evento
-  } = context;
-
-  logger.info('Procesando pedido', { pedido_id: row.id, estado: row.estado });
-
-  // ═══════════════════════════════════════════════════════════
-  // API.QUERY - Consultas SQL
-  // ═══════════════════════════════════════════════════════════
-
-  // Obtener líneas del pedido
-  const { rows: lineas } = await api.query(
-    `SELECT lp.*, p.nombre as producto_nombre, p.stock
-     FROM ${context.schema}.m308_t4137 lp  -- lineas_pedido
-     JOIN ${context.schema}.m308_t4138 p ON p.id = lp.producto_id
-     WHERE lp.pedido_id = $1`,
-    [row.id]
-  );
-
-  // Actualizar stock de productos
-  for (const linea of lineas) {
-    await api.query(
-      `UPDATE ${context.schema}.m308_t4138
-       SET stock = stock - $1
-       WHERE id = $2`,
-      [linea.cantidad, linea.producto_id]
-    );
-
-    logger.debug('Stock actualizado', {
-      producto: linea.producto_nombre,
-      cantidad: linea.cantidad
-    });
-  }
-
-  // ═══════════════════════════════════════════════════════════
-  // API.EMAIL - Enviar emails
-  // ═══════════════════════════════════════════════════════════
-
-  // Obtener datos del cliente
-  const { rows: [cliente] } = await api.query(
-    `SELECT * FROM ${context.schema}.m308_t4135 WHERE id = $1`,
-    [row.cliente_id]
-  );
-
-  await api.email({
-    to: cliente.email,
-    subject: `Pedido ${row.numero} confirmado`,
-    body: `
-      Hola ${cliente.nombre},
-
-      Tu pedido ${row.numero} ha sido confirmado.
-
-      Total: ${row.total}€
-
-      Gracias por tu compra.
-    `,
-    // O usar HTML:
-    html: `<h1>Pedido Confirmado</h1><p>...</p>`
-  });
-
-  // ═══════════════════════════════════════════════════════════
-  // API.HTTP - Llamadas a APIs externas
-  // ═══════════════════════════════════════════════════════════
-
-  // Webhook a sistema externo
-  if (env.WEBHOOK_URL) {
-    const response = await api.http(env.WEBHOOK_URL, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'Authorization': `Bearer ${env.WEBHOOK_TOKEN}`
-      },
-      body: JSON.stringify({
-        event: 'pedido_confirmado',
-        pedido: row,
-        cliente: cliente
-      })
-    });
-
-    logger.info('Webhook enviado', { status: response.status });
-  }
-
-  // ═══════════════════════════════════════════════════════════
-  // RETURN - Resultado de la automation
-  // ═══════════════════════════════════════════════════════════
-
-  return {
-    success: true,
-    message: `Pedido ${row.numero} procesado correctamente`,
-    data: {
-      lineas_procesadas: lineas.length,
-      email_enviado: true
-    }
-  };
-}
-```
-
-### Variables de Entorno (env)
-
-Cada company puede tener variables de entorno configuradas en `core.company_env_variables`:
-
-```javascript
-// Acceso en automations
-const apiKey = env.STRIPE_API_KEY;
-const webhookUrl = env.SLACK_WEBHOOK;
-const emailFrom = env.EMAIL_FROM || 'noreply@gufi.com';
-```
-
-### Automation con Input del Usuario (Click)
-
-```javascript
-// Definición en el JSON del módulo:
-{
-  "trigger": "click",
-  "function_name": "enviar_recordatorio",
-  "label": "Enviar Recordatorio",
-  "icon": "Mail",
-  "input_schema": {
-    "mensaje": {
-      "type": "textarea",
-      "label": "Mensaje personalizado",
-      "required": true
-    },
-    "urgente": {
-      "type": "boolean",
-      "label": "Marcar como urgente",
-      "default": false
-    }
-  }
-}
-
-// La función recibe el input:
-async function enviar_recordatorio(context, api, logger) {
-  const { row, input } = context;
-
-  // input.mensaje contiene el texto del usuario
-  // input.urgente contiene true/false
-
-  await api.email({
-    to: row.cliente_email,
-    subject: input.urgente ? '🚨 URGENTE: ' + row.numero : row.numero,
-    body: input.mensaje
-  });
-
-  return { success: true };
-}
-```
-
----
-
-## Views (Vistas del Marketplace)
-
-Las Views son **componentes React/TypeScript** que los consultores escriben en el navegador y se almacenan en PostgreSQL. Se ejecutan dinámicamente en el frontend.
-
-### Dónde se almacenan
-
-```sql
-SELECT id, name, code FROM marketplace.views WHERE package_id = 14;
-```
-
-### Estructura de Archivos de una View
-
-Cuando descargas una view con `gufi view:pull <id>`, obtienes:
-
-```
-~/gufi-dev/view_<id>/
-├── index.tsx              # Entry point - exporta featureConfig y default
-├── types.ts               # Interfaces TypeScript
-│
-├── core/
-│   ├── dataProvider.ts    # 💜 dataSources + featureConfig (MUY IMPORTANTE)
-│   └── permissions.ts     # 💜 Sistema de permisos dinámico
-│
-├── metadata/
-│   ├── inputs.ts          # 💜 Inputs configurables por usuario
-│   ├── help.es.ts         # Documentación en español
-│   └── help.en.ts         # Documentación en inglés
-│
-├── components/
-│   ├── MiComponente.tsx   # Componentes React
-│   └── DevPermissionSwitcher.tsx  # 💜 Testing de permisos en dev
-│
-├── views/
-│   └── page.tsx           # Página principal
-│
-└── automations/           # Opcional: automations de la vista
-    └── mi_automation.js
-```
-
----
-
-### 💜 dataSources - Declarar qué Tablas Necesita la Vista
-
-El archivo `core/dataProvider.ts` define qué tablas necesita la vista.
-
-**Arquitectura:**
-1. Se declaran en código (`core/dataProvider.ts`)
-2. Se editan con CLI: `gufi pull` → editar → `gufi push`
-3. Developer Center los muestra como **solo lectura**
-4. Al instalar la vista, el sistema mapea nombres lógicos automáticamente
-
-```typescript
-// core/dataProvider.ts
-// 💜 Mi Vista - Data Sources & Feature Configuration
-
-/* ============================================================================
-   💜 Data Sources - Tablas que necesita esta vista
-============================================================================ */
-export const dataSources = [
-  {
-    key: 'tareasTable',             // Identificador único
-    type: 'table',                   // Siempre 'table'
-    label: { es: 'Tabla de Tareas', en: 'Tasks Table' },
-    description: {
-      es: 'Tabla principal de tareas',
-      en: 'Main tasks table'
-    },
-    required: true,                  // true = obligatorio
-  },
-  {
-    key: 'proyectosTable',
-    type: 'table',
-    label: { es: 'Proyectos', en: 'Projects' },
-    description: {
-      es: 'Tabla de proyectos (opcional)',
-      en: 'Projects table (optional)'
-    },
-    required: false,                 // false = opcional
-  },
-  {
-    key: 'comentariosTable',
-    type: 'table',
-    label: { es: 'Comentarios', en: 'Comments' },
-    description: {
-      es: 'Comentarios en tareas',
-      en: 'Task comments'
-    },
-    required: false,
-  },
-] as const;
-
-/* ============================================================================
-   💜 Feature Config - EXPORTAR SIEMPRE
-============================================================================ */
-import { featureInputs } from '../metadata/inputs';
-
-export const featureConfig = {
-  dataSources,
-  inputs: featureInputs,
-};
-
-// También exporta funciones de carga de datos...
-```
-
-**En el index.tsx:**
-```typescript
-// index.tsx
-export { featureConfig } from './core/dataProvider';
-export default function MiVista({ gufi }) { ... }
-```
-
-**Cómo acceder a las tablas configuradas:**
-```typescript
-export default function MiVista({ gufi }) {
-  const viewSpec = gufi?.context?.viewSpec || {};
-
-  // Keys de dataSources → NOMBRES LÓGICOS (nunca IDs físicos)
-  const tareasTable = viewSpec.tareasTable;      // "tareas.asignaciones"
-  const proyectosTable = viewSpec.proyectosTable; // "tareas.proyectos" o undefined
-
-  // Usar para queries
-  const res = await gufi.dataProvider.getList({
-    resource: tareasTable,
-    pagination: { current: 1, pageSize: 100 },
-  });
-}
-```
-
----
-
-### 💜 inputs (featureInputs) - Configuración del Usuario
-
-Permite que el usuario configure opciones de la vista sin tocar código.
-
-```typescript
-// metadata/inputs.ts
-// 💜 Mi Vista - Inputs Configurables
-
-export const featureInputs = [
-  // BOOLEAN - Checkbox
-  {
-    key: 'showCompleted',
-    type: 'boolean',
-    label: { es: 'Mostrar completadas', en: 'Show completed' },
-    description: {
-      es: 'Incluir tareas completadas',
-      en: 'Include completed tasks'
-    },
-    default: false,
-  },
-
-  // SELECT - Dropdown estático
-  {
-    key: 'defaultView',
-    type: 'select',
-    label: { es: 'Vista por defecto', en: 'Default view' },
-    description: {
-      es: 'Panel inicial al abrir',
-      en: 'Initial panel on open'
-    },
-    options: [
-      { value: 'list', label: { es: 'Lista', en: 'List' } },
-      { value: 'kanban', label: { es: 'Kanban', en: 'Kanban' } },
-      { value: 'calendar', label: { es: 'Calendario', en: 'Calendar' } },
-    ],
-    default: 'list',
-  },
-
-  // NUMBER - Input numérico
-  {
-    key: 'lowStockThreshold',
-    type: 'number',
-    label: { es: 'Umbral stock bajo (%)', en: 'Low stock threshold (%)' },
-    description: {
-      es: 'Porcentaje para alertas',
-      en: 'Percentage for alerts'
-    },
-    placeholder: '40',
-    default: 40,
-  },
-
-  // TEXT - Input de texto
-  {
-    key: 'emailCc',
-    type: 'text',
-    label: { es: 'Email CC', en: 'CC Email' },
-    description: {
-      es: 'Email en copia',
-      en: 'CC email'
-    },
-    placeholder: 'admin@empresa.com',
-  },
-
-  // SELECT con opciones de otra tabla (dinámico)
-  {
-    key: 'defaultWarehouse',
-    type: 'select',
-    label: { es: 'Almacén por defecto', en: 'Default warehouse' },
-    description: {
-      es: 'Almacén seleccionado al abrir',
-      en: 'Warehouse on open'
-    },
-    optionsFrom: 'warehousesTable',  // 💜 Carga opciones del dataSource
-    default: 'all',
-  },
-] as const;
-```
-
-**Acceder a inputs en runtime:**
-```typescript
-export default function MiVista({ gufi }) {
-  const viewSpec = gufi?.context?.viewSpec || {};
-
-  // Los inputs están directamente en viewSpec
-  const showCompleted = viewSpec.showCompleted ?? false;
-  const defaultView = viewSpec.defaultView ?? 'list';
-  const threshold = viewSpec.lowStockThreshold ?? 40;
-  const emailCc = viewSpec.emailCc;
-}
-```
-
----
-
-### 💜 help - Documentación para Usuarios
-
-Crea archivos de ayuda que aparecen en el botón "?" de la vista.
-
-```typescript
-// metadata/help.es.ts
-export const help = {
-  // Para Admin/Consultant
-  consultant: {
-    title: "Mi Vista",
-    description: "Descripción breve de la vista.",
-    sections: [
-      {
-        id: "overview",
-        title: "Descripción General",
-        content: `
-**Funcionalidades:**
-- Lista de tareas con filtros
-- Vista Kanban por proyecto
-- Sistema de comentarios
-
-**Tablas requeridas:**
-| DataSource | Descripción |
-|------------|-------------|
-| tareasTable | Tabla principal de tareas |
-| proyectosTable | Proyectos (opcional) |
-        `.trim(),
-      },
-      {
-        id: "configuration",
-        title: "Configuración",
-        content: `
-**Campos requeridos en tareas:**
-- titulo (text)
-- estado (select: pendiente, en_progreso, completada)
-- asignado_a (users)
-- proyecto_id (relation, opcional)
-        `.trim(),
-      },
-      {
-        id: "permissions",
-        title: "Permisos",
-        content: `
-| Permiso | Efecto |
-|---------|--------|
-| * | Acceso completo |
-| entity:view | Solo lectura |
-| create_tasks | Puede crear tareas |
-        `.trim(),
-      },
-    ],
-  },
-
-  // Para usuarios finales
-  user: {
-    title: "Guía de Uso",
-    sections: [
-      {
-        id: "basics",
-        title: "Uso Básico",
-        content: `
-1. **Mis Tareas**: Tareas asignadas a ti
-2. **Proyectos**: Vista Kanban por proyecto
-3. **Gestión**: Tareas que has asignado
-
-Para crear tarea, pulsa el botón **+**
-        `.trim(),
-      },
-    ],
-  },
-};
-```
-
----
-
-### 💜 permissions - Sistema de Permisos Explícitos (Sin Wildcards)
-
-Las vistas usan un sistema de **permisos explícitos** - sin wildcards, sin magia. Cada permiso es un string específico que existe o no en el array de permisos del usuario.
-
-> ⚠️ **Importante**: Eliminamos el soporte de wildcards (`*`) porque causaba problemas de integridad entre el estado de la UI y los permisos reales. Siempre usa strings de permisos explícitos.
-
-**1. Declarar permisos en `metadata/permissions.ts`:**
-```typescript
-// metadata/permissions.ts
-export const permissions = [
-  // Permisos estáticos - toggles simples
-  {
-    key: 'send_orders',
-    label: { es: 'Enviar pedidos', en: 'Send orders' },
-    description: { es: 'Puede enviar pedidos a proveedores', en: 'Can send orders' },
-  },
-  {
-    key: 'view_costs',
-    label: { es: 'Ver costos', en: 'View costs' },
-    description: { es: 'Puede ver precios de compra', en: 'Can see purchase prices' },
-  },
-
-  // Permisos dinámicos - se resuelven en runtime
-  {
-    key: 'warehouse:*',  // Placeholder, se resuelve a warehouse:madrid, warehouse:barcelona, etc.
-    label: { es: 'Acceso a almacén', en: 'Warehouse access' },
-    description: { es: 'Almacenes a los que tiene acceso', en: 'Warehouses user can access' },
-    dynamic: true,  // Marca este como dinámico
-  },
-] as const;
-```
-
-**2. Crear `core/permissions.ts` (sin wildcards):**
-```typescript
-// core/permissions.ts
-// SIN WILDCARDS - solo permisos explícitos
-
-export interface PermissionsConfig {
-  userPermissions: string[];  // Permisos del usuario (resueltos desde su rol)
-  isDevMode: boolean;
-  devPermissions: string[];   // Override en modo dev para testing
-}
-
-// Obtener permisos efectivos (dev mode override)
-function getEffectivePermissions(config: PermissionsConfig): string[] {
-  const { userPermissions, isDevMode, devPermissions } = config;
-  return (isDevMode && devPermissions.length > 0) ? devPermissions : userPermissions;
-}
-
-// Check simple - ¿tiene exactamente este permiso?
-export function hasPermission(config: PermissionsConfig, permission: string): boolean {
-  const perms = getEffectivePermissions(config);
-  return perms.includes(permission);
-}
-
-// Helpers específicos de la vista
-export function canSendOrders(config: PermissionsConfig): boolean {
-  return hasPermission(config, 'send_orders');
-}
-
-export function canViewCosts(config: PermissionsConfig): boolean {
-  return hasPermission(config, 'view_costs');
-}
-
-// Obtener warehouses permitidos (null si no hay restricciones)
-export function getAllowedWarehouses(config: PermissionsConfig): string[] | null {
-  const perms = getEffectivePermissions(config);
-
-  const warehouses: string[] = [];
-  for (const perm of perms) {
-    if (perm.startsWith('warehouse:')) {
-      warehouses.push(perm.slice('warehouse:'.length));
-    }
-  }
-
-  return warehouses.length > 0 ? warehouses : null;
-}
-```
-
-**3. Usar en el componente con inicialización correcta:**
-```typescript
-import { useState, useEffect, useRef } from 'react';
-import { DevPermissionSwitcher } from '../components/DevPermissionSwitcher';
-import { canSendOrders, getAllowedWarehouses } from '../core/permissions';
-
-export default function MiVista({ gufi }) {
-  const lang = gufi?.context?.lang || 'es';
-  const isDevMode = gufi?.context?.isPreview || window.location.hostname === 'localhost';
-
-  // 💜 IMPORTANTE: Inicializar vacío, poblar cuando los datos carguen
-  const [devPermissions, setDevPermissions] = useState<string[]>([]);
-  const devPermissionsInitialized = useRef(false);
-
-  // Cargar warehouses de tu data source
-  const [warehouses, setWarehouses] = useState([]);
-
-  // Inicializar permisos cuando warehouses carguen (una sola vez)
-  useEffect(() => {
-    if (isDevMode && !devPermissionsInitialized.current && warehouses.length > 0) {
-      devPermissionsInitialized.current = true;
-
-      // Otorgar todos los permisos explícitos
-      const allPerms = [
-        'send_orders',
-        'view_costs',
-        ...warehouses.map(w => `warehouse:${w.name.toLowerCase()}`),
-      ];
-      setDevPermissions(allPerms);
-    }
-  }, [isDevMode, warehouses]);
-
-  // Construir config de permisos
-  const permissionsConfig = {
-    userPermissions: gufi?.context?.user?.permissions || [],
-    isDevMode,
-    devPermissions,
-  };
-
-  // Usar helpers de permisos
-  const showCosts = canViewCosts(permissionsConfig);
-  const allowedWarehouses = getAllowedWarehouses(permissionsConfig);
-
-  return (
-    <div>
-      {showCosts && <CostsColumn />}
-
-      {/* DevPermissionSwitcher - solo en dev mode */}
-      {isDevMode && (
-        <DevPermissionSwitcher
-          lang={lang}
-          activePermissions={devPermissions}
-          onPermissionsChange={setDevPermissions}
-          dynamicValues={{
-            warehouse: warehouses.map(w => w.name.toLowerCase())
-          }}
-        />
-      )}
-    </div>
-  );
-}
-```
-
-**DevPermissionSwitcher**: Botón flotante **purple** (💜 Gufi style) que permite:
-- Toggle individual de permisos on/off
-- Botón "Todos" en el header para acceso completo
-- Permisos dinámicos expandibles (ej: warehouses individuales)
-- Integridad total: UI siempre refleja el estado real
-
-### 💜 DevPermissionSwitcher AUTOMÁTICO (LivePreviewPage)
-
-**¡Ya no necesitas incluir DevPermissionSwitcher en tu código!** LivePreviewPage detecta automáticamente si tu vista tiene `featureConfig.permissions` y muestra el botón DEV.
-
-**Cómo funciona:**
-1. Declara permisos en `metadata/permissions.ts`
-2. Expórtalos en `featureConfig`:
-   ```typescript
-   // core/dataProvider.ts
-   import { permissions } from '../metadata/permissions';
-
-   export const featureConfig = {
-     dataSources,
-     inputs: featureInputs,
-     permissions,  // 💜 Solo añadir esto
-   };
-   ```
-3. LivePreviewPage lo detecta y muestra el botón DEV automáticamente
-
-**Usar devPermissions del contexto:**
-```typescript
-export default function MiVista({ gufi }) {
-  // 💜 LivePreviewPage provee devPermissions automáticamente
-  const effectiveDevPermissions = gufi?.context?.devPermissions || [];
-
-  const permissionsConfig = {
-    userPermissions: gufi?.context?.userPermissions || [],
-    isDevMode: gufi?.context?.isPreview || gufi?.context?.isDev,
-    devPermissions: effectiveDevPermissions,
-  };
-
-  // Usar helpers de permisos normalmente
-  const canSend = hasPermission(permissionsConfig, 'send_orders');
-}
-```
-
-**Cuándo incluir DevPermissionSwitcher manualmente:**
-- Solo si la vista se ejecuta fuera de LivePreviewPage (ej: vista nativa del frontend)
-- Para vistas del marketplace en Developer Center → **NO necesario**, es automático
-
-**Principio clave**: Inicializar con `[]` vacío, luego usar `useEffect` para otorgar todos los permisos cuando los valores dinámicos (como warehouses) terminen de cargar. Esto garantiza integridad UI.
-
----
-
-### 💜 automations en Vistas
-
-Las vistas pueden incluir automations que se ejecutan al hacer click.
-
-**Archivo de automation:**
-```javascript
-// automations/send_notification.js
-/**
- * 💜 Automation: send_notification
- * Trigger: CLICK (desde la vista)
- */
-async function send_notification(context, api, logger) {
-  const { input, env } = context;
-  const { tarea_id, mensaje } = input;
-
-  // Obtener tarea
-  const { rows } = await api.query(
-    'SELECT titulo, asignado_a FROM tareas WHERE id = $1',
-    [tarea_id]
-  );
-
-  // Obtener email del asignado
-  const { rows: users } = await api.query(
-    'SELECT email FROM core.users WHERE id = $1',
-    [rows[0].asignado_a]
-  );
-
-  // Enviar email
-  await api.email({
-    to: users[0].email,
-    subject: `Notificación: ${rows[0].titulo}`,
-    html: `<p>${mensaje}</p>`,
-    cc: env.NOTIFICATION_CC,
-  });
-
-  logger.info('Notificación enviada', { tarea_id });
-  return { success: true };
-}
-```
-
-**Llamar automation desde React:**
-```typescript
-const handleNotify = async (tareaId: number) => {
-  try {
-    const result = await gufi.utils.runClickAutomation({
-      functionName: 'send_notification',
-      input: {
-        tarea_id: tareaId,
-        mensaje: 'Tu tarea ha sido actualizada',
-      },
-    });
-
-    if (result.success) {
-      gufi.utils.toastSuccess('Notificación enviada');
-    }
-  } catch (err) {
-    gufi.utils.toastError(err.message);
-  }
-};
-```
-
----
-
-### 💜 El Objeto `gufi` - Props Completas
-
-Toda vista recibe `gufi` con todo lo necesario:
-
-```typescript
-interface GufiProps {
-  context: {
-    user: { id, email, name, role };
-    lang: 'es' | 'en';
-    viewSpec: {
-      // dataSources configurados
-      tareasTable: string;
-      proyectosTable?: string;
-      // inputs configurados
-      showCompleted: boolean;
-      defaultView: string;
-      lowStockThreshold: number;
-    };
-    companyId: number;
-    moduleId: number;
-    entityId: number;
-  };
-
-  dataProvider: {
-    getList({ resource, pagination, filters, sorters });
-    getOne({ resource, id });
-    create({ resource, variables });
-    update({ resource, id, variables });
-    deleteOne({ resource, id });
-  };
-
-  utils: {
-    toastSuccess(msg: string);
-    toastError(msg: string);
-    toastInfo(msg: string);
-    runClickAutomation({ functionName, input });
-  };
-}
-```
-
----
-
-### 💜 seedData - Datos de Ejemplo para Demo/Testing
-
-Las vistas pueden incluir datos de ejemplo que se cargan automáticamente al instalar. Esto es útil para demos, testing, y onboarding de nuevos usuarios.
-
-```typescript
-// metadata/seedData.ts
-export interface SeedDataConfig {
-  description: { es: string; en: string };
-  data: { [dataSourceKey: string]: Array<Record<string, any>> };
-  order: string[];  // Orden de creación (importante para referencias)
-}
-
-export const seedData: SeedDataConfig = {
-  description: {
-    es: 'Crea empresas de ejemplo (Singular, FitVending), proyectos y tareas de prueba',
-    en: 'Creates sample companies, projects and test tasks',
-  },
-
-  // Orden de creación - tablas con referencias van después
-  order: ['empresasTable', 'proyectosTable', 'tareasTable'],
-
-  data: {
-    // Empresas/Clientes
-    empresasTable: [
-      {
-        nombre: 'Singular',
-        contacto: 'Contacto Singular',
-        email: 'contacto@singular.es',
-        estado: 'activo'
-      },
-      {
-        nombre: 'FitVending',
-        contacto: 'Equipo FitVending',
-        email: 'info@fitvending.es',
-        estado: 'activo'
-      },
-    ],
-
-    // Proyectos
-    proyectosTable: [
-      {
-        nombre: 'Gufi ERP',
-        descripcion: 'Desarrollo del ERP Gufi',
-        color: '#8B5CF6',
-        estado: 'activo',
-      },
-    ],
-
-    // Tareas - con referencias a otras tablas
-    tareasTable: [
-      {
-        titulo: 'Revisar bug crítico',
-        descripcion: 'Los usuarios reportan problemas',
-        asignado_a: '@currentUser',      // 💜 Token especial: usuario actual
-        asignado_por: '@currentUser',
-        prioridad: 'urgente',
-        estado: 'pendiente',
-        fecha_limite: '@today',           // 💜 Token especial: fecha de hoy
-        proyecto_id: '@ref:proyectosTable.0',  // 💜 Referencia: ID del primer proyecto
-        empresa_id: '@ref:empresasTable.0',    // 💜 Referencia: ID de primera empresa
-      },
-      {
-        titulo: 'Preparar demo',
-        descripcion: 'Demo del módulo de facturación',
-        asignado_a: '@currentUser',
-        prioridad: 'alta',
-        fecha_limite: '@tomorrow',        // 💜 Token especial: mañana
-        empresa_id: '@ref:empresasTable.1',
-      },
-    ],
-  },
-};
-```
-
-**Tokens Especiales:**
-| Token | Descripción |
-|-------|-------------|
-| `@currentUser` | ID del usuario actual (para campos users) |
-| `@today` | Fecha de hoy (YYYY-MM-DD) |
-| `@tomorrow` | Fecha de mañana |
-| `@nextWeek` | Fecha dentro de 7 días |
-| `@ref:tableKey.index` | ID del registro creado en otra tabla |
-
-**Agregar a featureConfig:**
-```typescript
-// core/dataProvider.ts
-import { seedData } from '../metadata/seedData';
-
-export const featureConfig = {
-  dataSources,
-  inputs: featureInputs,
-  seedData,  // 💜 Agregar aquí
-};
-```
-
-**Cargar desde Developer Center:**
-En la página de edición de vista, el Developer Center muestra un botón "Load Sample Data" que ejecuta el seedData en la company seleccionada.
-
----
-
-### 💜 Checklist para Nueva Vista
-
-1. [ ] `core/dataProvider.ts` - dataSources + export featureConfig
-2. [ ] `metadata/inputs.ts` - featureInputs configurables
-3. [ ] `metadata/seedData.ts` - Datos de ejemplo (opcional pero recomendado)
-4. [ ] `metadata/help.es.ts` y `help.en.ts` - Documentación
-5. [ ] `index.tsx` - export featureConfig y default component
-6. [ ] Usar `gufi?.context?.viewSpec` para tablas e inputs
-7. [ ] Usar `gufi?.dataProvider` para CRUD
-8. [ ] Usar `gufi?.utils?.toast*` para notificaciones
-9. [ ] Si hay automation: carpeta `automations/` con .js
-
-### View.tsx - Componente Principal
-
-```tsx
-import React, { useState, useEffect } from 'react';
-import { useList, useUpdate, useCreate } from '@refinedev/core';
-
-// ═══════════════════════════════════════════════════════════════
-// PROPS que recibe toda View
-// ═══════════════════════════════════════════════════════════════
-interface ViewProps {
-  // Configuración de la vista
-  viewSpec: {
-    id: number;
-    name: string;
-    config: Record<string, any>;  // Config guardada por el usuario
-  };
-
-  // Contexto de la company
-  context: {
-    companyId: number;
-    moduleId: number;
-    entityId: number;
-  };
-
-  // Usuario actual
-  user: {
-    id: number;
-    email: string;
-    name: string;
-    role: string;
-  };
-
-  // Notificaciones
-  toastSuccess: (message: string) => void;
-  toastError: (message: string) => void;
-  toastInfo: (message: string) => void;
-}
-
-// ═══════════════════════════════════════════════════════════════
-// COMPONENTE PRINCIPAL
-// ═══════════════════════════════════════════════════════════════
-export default function MiVista({ viewSpec, context, user, toastSuccess, toastError }: ViewProps) {
-  const [filtro, setFiltro] = useState('todos');
-
-  // ─────────────────────────────────────────────────────────────
-  // useList - Obtener lista de registros
-  // ─────────────────────────────────────────────────────────────
-  const { data, isLoading, refetch } = useList({
-    resource: 'm360_t16192',  // Nombre físico de la tabla
-    pagination: { current: 1, pageSize: 100 },
-    filters: filtro !== 'todos' ? [
-      { field: 'estado', operator: 'eq', value: filtro }
-    ] : [],
-    sorters: [
-      { field: 'created_at', order: 'desc' }
-    ]
-  });
-
-  // ─────────────────────────────────────────────────────────────
-  // useUpdate - Actualizar registros
-  // ─────────────────────────────────────────────────────────────
-  const { mutate: updateRecord } = useUpdate();
-
-  const handleStatusChange = (id: number, newStatus: string) => {
-    updateRecord(
-      {
-        resource: 'm360_t16192',
-        id,
-        values: { estado: newStatus }
-      },
-      {
-        onSuccess: () => {
-          toastSuccess('Estado actualizado');
-          refetch();
-        },
-        onError: (error) => {
-          toastError('Error al actualizar: ' + error.message);
-        }
-      }
-    );
-  };
-
-  // ─────────────────────────────────────────────────────────────
-  // useCreate - Crear registros
-  // ─────────────────────────────────────────────────────────────
-  const { mutate: createRecord } = useCreate();
-
-  const handleCreate = (data: any) => {
-    createRecord(
-      {
-        resource: 'm360_t16192',
-        values: data
-      },
-      {
-        onSuccess: () => {
-          toastSuccess('Registro creado');
-          refetch();
-        }
-      }
-    );
-  };
-
-  // ─────────────────────────────────────────────────────────────
-  // RENDER
-  // ─────────────────────────────────────────────────────────────
-  if (isLoading) {
-    return (
-      <div className="flex items-center justify-center h-64">
-        <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-violet-600" />
-      </div>
-    );
-  }
-
-  return (
-    <div className="p-6 bg-gradient-to-br from-violet-50/40 via-white to-purple-50/40 min-h-screen">
-      {/* Header */}
-      <div className="flex items-center justify-between mb-6">
-        <h1 className="text-2xl font-bold text-gray-900">
-          {viewSpec.name}
-        </h1>
-        <div className="flex gap-2">
-          <select
-            value={filtro}
-            onChange={(e) => setFiltro(e.target.value)}
-            className="px-3 py-2 border rounded-lg"
-          >
-            <option value="todos">Todos</option>
-            <option value="pendiente">Pendientes</option>
-            <option value="completado">Completados</option>
-          </select>
-        </div>
-      </div>
-
-      {/* Lista */}
-      <div className="grid gap-4">
-        {data?.data.map((item: any) => (
-          <div
-            key={item.id}
-            className="p-4 bg-white rounded-xl shadow-sm border border-gray-100 hover:shadow-md transition-shadow"
-          >
-            <div className="flex items-center justify-between">
-              <div>
-                <h3 className="font-medium text-gray-900">{item.titulo}</h3>
-                <p className="text-sm text-gray-500">{item.descripcion}</p>
-              </div>
-              <button
-                onClick={() => handleStatusChange(item.id, 'completado')}
-                className="px-4 py-2 bg-violet-600 text-white rounded-lg hover:bg-violet-700"
-              >
-                Completar
-              </button>
-            </div>
-          </div>
-        ))}
-      </div>
-
-      {/* Empty state */}
-      {data?.data.length === 0 && (
-        <div className="text-center py-12 text-gray-500">
-          No hay registros que mostrar
-        </div>
-      )}
-    </div>
-  );
-}
-```
-
-### dataProvider.ts - Lógica de Datos Custom
-
-```typescript
-// core/dataProvider.ts
-import { DataProvider } from '@refinedev/core';
-
-// Puedes extender el dataProvider por defecto
-export const customDataProvider = (baseProvider: DataProvider): DataProvider => ({
-  ...baseProvider,
-
-  // Override getList para transformar datos
-  getList: async (params) => {
-    const result = await baseProvider.getList(params);
-
-    // Transformar datos antes de devolverlos
-    return {
-      ...result,
-      data: result.data.map(item => ({
-        ...item,
-        // Agregar campos calculados
-        diasPendiente: calcularDias(item.created_at),
-        prioridadColor: getPrioridadColor(item.prioridad)
-      }))
-    };
-  },
-
-  // Custom method para operaciones especiales
-  custom: async ({ url, method, payload }) => {
-    const response = await fetch(url, {
-      method,
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload)
-    });
-    return response.json();
-  }
-});
-
-function calcularDias(fecha: string): number {
-  const diff = Date.now() - new Date(fecha).getTime();
-  return Math.floor(diff / (1000 * 60 * 60 * 24));
-}
-
-function getPrioridadColor(prioridad: string): string {
-  const colores: Record<string, string> = {
-    alta: 'red',
-    media: 'yellow',
-    baja: 'green'
-  };
-  return colores[prioridad] || 'gray';
-}
-```
-
----
-
-## Packages del Marketplace
-
-Un Package agrupa múltiples Views y módulos relacionados para distribuirlos.
-
-### Estructura en Base de Datos
-
-```sql
--- Package publicado
-SELECT * FROM marketplace.packages WHERE id = 14;
--- { id: 14, name: "Stock Management", version: "1.2.0", published_at: ... }
-
--- Vistas del package
-SELECT id, name FROM marketplace.views WHERE package_id = 14;
--- { id: 5, name: "Stock Overview" }
--- { id: 6, name: "Inventory Report" }
-
--- Módulos incluidos (snapshot)
-SELECT * FROM marketplace.package_modules WHERE package_id = 14;
-```
-
-### Flujo de Desarrollo → Publicación
-
-```
-1. DESARROLLO (en tu company)
-   └── Creas módulo "Stock" en company 116
-   └── Creas views en Developer Center
-   └── Testas todo localmente
-
-2. CREAR PACKAGE
-   └── Developer Center → Packages → New Package
-   └── Agregas módulo "Stock"
-   └── Agregas views "Stock Overview", "Inventory Report"
-
-3. PUBLICAR
-   └── Click "Publish to Marketplace"
-   └── Sistema crea snapshot inmutable
-   └── Versión 1.0.0 disponible
-
-4. INSTALACIÓN (otra company)
-   └── Company 200 instala el package
-   └── Sistema crea módulo "Stock" en company_200
-   └── Views disponibles en su menú
-```
-
----
-
-## Comandos del CLI
-
-### 💜 Resumen Rápido para Claude
-
-**El CLI gestiona companies, módulos, automations y datos. Todo es dinámico - detecta la company automáticamente.**
-
-| Quiero... | Comando |
-|-----------|---------|
-| Ver companies | `gufi companies` |
-| Ver módulos de company | `gufi modules 146` |
-| Ver/editar módulo | `gufi module 360` |
-| Ver registros | `gufi rows m308_t4136` |
-| Listar scripts | `gufi automations` |
-| Ver/editar script | `gufi automation 15` |
-| **Ver índice del worker** | `gufi automations:meta` |
-| **Ver ejecuciones** | `gufi automations:executions` |
-| **Ver/editar triggers** | `gufi entity:automations 4136` |
-| **Ver mis packages** | `gufi packages` |
-| **Ver package** | `gufi package 14` |
-| **Crear package** | `gufi package:create "Nombre"` |
-| **Desarrollar view** | `gufi pull 13` → `gufi watch` → `gufi logs` |
-
-**3 cosas que saber:**
-1. **Auto-login**: `gufi login` guarda credenciales → funciona para siempre (logout NO las borra)
-2. **Auto-detección**: `module`, `automation`, `rows` detectan la company automáticamente
-3. **Sin prefijos**: `gufi pull/push/watch/logs` (no `view:pull`, etc.)
-
-### Instalación
+## Quick Reference
 
 ```bash
-npm install -g gufi-cli
-gufi login
-```
-
-### 💜 Autenticación Persistente (Auto-Login)
+# Contexto y diagnóstico
+gufi context              # Genera contexto para Claude
+gufi doctor               # Diagnóstico del sistema
 
-El CLI guarda las credenciales en `~/.gufi/config.json` y hace **auto-login automático** cuando es necesario:
-
-```json
-{
-  "apiUrl": "https://gogufi.com",
-  "email": "user@example.com",
-  "password": "secreto",
-  "token": "eyJ...",
-  "refreshToken": "eyJ..."
-}
-```
+# Entornos
+gufi config               # Ver entornos
+gufi config:local         # Cambiar a localhost
+gufi config:prod          # Cambiar a producción
 
-**Flujo automático:**
-1. `gufi login` → pide email/password → los guarda permanentemente
-2. Cualquier comando → si token expiró → auto-login con credenciales guardadas
-3. `gufi logout` → borra TODO (token + credenciales)
+# Módulos
+gufi modules 146          # Ver módulos
+gufi module 360 --edit    # Editar con $EDITOR
 
-**Resultado:** Una vez haces `gufi login`, el CLI funciona para siempre sin volver a pedir credenciales. Si el token expira, hace auto-login automáticamente.
+# Automations
+gufi automations          # Ver scripts
+gufi automation 15 --edit # Editar script
+gufi entity:automations 4136  # Ver triggers
 
-**Nota:** Si haces login en el navegador web, el refreshToken del CLI se invalida, pero el CLI hace auto-login automáticamente con las credenciales guardadas.
+# Vistas
+gufi view:pull 13         # Descargar
+gufi view:push            # Subir cambios
+gufi view:watch           # Auto-sync
 
-### Gestión de Companies y Módulos
-
-```bash
-# Ver companies
-gufi companies
-
-# Ver módulos de una company
-gufi modules 146
-
-# Ver JSON de un módulo (auto-detecta company)
-gufi module 360
-
-# Editar módulo con tu editor
-gufi module 360 --edit
-
-# Guardar JSON a archivo
-gufi module 360 --file modulo.json
-
-# Actualizar módulo desde archivo
-gufi module:update 360 modulo.json -c 146
-
-# Validar sin aplicar cambios
-gufi module:update 360 modulo.json -c 146 --dry-run
-
-# Crear nueva company
-gufi company:create "Mi Empresa"
-```
-
-### Automations (Scripts Globales)
-
-```bash
-# Listar automation scripts
-gufi automations -c 116
-
-# Ver código de una automation
-gufi automation calcular_stock -c 116
-
-# Editar con tu editor
-gufi automation calcular_stock -c 116 --edit
-
-# Guardar a archivo
-gufi automation calcular_stock -c 116 --file script.js
-
-# Crear/actualizar automation desde archivo JS
-gufi automation:create calcular_stock script.js -c 116
-
-# 💜 Debugging - Ver índice del worker (auto-synced desde entities.automations)
-gufi automations:meta -c 116
-
-# 💜 Ver historial de ejecuciones
-gufi automations:executions -c 116
-gufi automations:executions -c 116 --limit 50
-gufi automations:executions -c 116 --script sync_nayax
+# Datos
+gufi rows m360_t16192     # Listar registros
+gufi row:create table --data '{...}'
 ```
 
-### Entity Automations (Automations por Entidad)
+## Output JSON (para Claude/scripts)
 
-Las automations de entidad están vinculadas a una entidad específica (tabla) y se almacenan en `core.entities.automations`.
+Todos los comandos de lectura soportan `--json` para output estructurado sin colores ni emojis:
 
 ```bash
-# Ver automations de una entidad (auto-detecta company)
-gufi entity:automations 4589
-
-# Editar automations con tu editor ($EDITOR)
-gufi entity:automations 4589 --edit
-
-# Guardar automations a archivo JSON
-gufi entity:automations 4589 --file automations.json
-
-# Actualizar automations desde archivo JSON
-gufi entity:automations:update 4589 automations.json
-```
-
-**Formato del JSON de automations:**
-```json
-[
-  {
-    "trigger": "insert",
-    "function_name": "notificar_nuevo",
-    "enabled": true
-  },
-  {
-    "trigger": "click",
-    "function_name": "generar_factura",
-    "label": "Generar Factura",
-    "enabled": true
-  },
-  {
-    "trigger": "scheduled",
-    "function_name": "sync_diario",
-    "interval_ms": 86400000,
-    "enabled": true
-  }
-]
-```
-
-**Triggers disponibles:**
-| Trigger | Descripción |
-|---------|-------------|
-| `insert` | Al crear registro |
-| `update` | Al modificar registro |
-| `delete` | Al eliminar registro |
-| `click` | Botón manual en UI |
-| `scheduled` | Intervalo programado |
-
-### Environment Variables
-
-```bash
-# Ver variables de entorno de la company
-gufi env
-
-# Crear/actualizar variable
-gufi env:set STRIPE_API_KEY sk-live-xxx
-
-# Eliminar variable
-gufi env:delete STRIPE_API_KEY
-```
-
-### Schema (Estructura de Tablas)
-
-```bash
-# Ver todas las tablas de la company
-gufi schema
-
-# Filtrar por módulo
-gufi schema -m 360
-```
-
-### Row CRUD (Datos de Tablas)
-
-> 💜 **Auto-detección de Company**: El CLI detecta automáticamente a qué company pertenece una tabla
-> analizando el nombre (ej: `m308_t4136` → módulo 308 → busca en qué company está).
-> Ya no necesitas usar `-c` en la mayoría de casos.
-
-```bash
-# Listar registros de una tabla (auto-detecta company)
-gufi rows m360_t16192                    # Últimos 20 registros
-gufi rows m360_t16192 -l 50              # Últimos 50 registros
-gufi rows m360_t16192 -f estado=activo   # Filtrar por campo
-
-# Ver un registro específico
-gufi row m360_t16192 123
-
-# Crear registro
-gufi row:create m360_t16192 --data '{"nombre":"Test","estado":"activo"}'
-gufi row:create m360_t16192 --file nuevo.json
-
-# Actualizar registro
-gufi row:update m360_t16192 123 --data '{"estado":"completado"}'
-gufi row:update m360_t16192 123 --file cambios.json
-
-# Eliminar registro
-gufi row:delete m360_t16192 123
-
-# Duplicar registro (copia sin id/timestamps)
-gufi row:duplicate m360_t16192 123
-
-# Crear múltiples registros desde archivo JSON
-gufi rows:create m360_t16192 --file datos.json
-# datos.json debe ser un array: [{"nombre":"A"},{"nombre":"B"}]
-
-# Si necesitas forzar una company específica, usa -c
-gufi rows m360_t16192 -c 146
+gufi companies --json           # Lista companies en JSON
+gufi modules 146 --json         # Lista módulos en JSON
+gufi module 360 --json          # JSON del módulo
+gufi automations --json         # Lista automations en JSON
+gufi automation 15 --json       # Código y metadata del automation
+gufi schema --json              # Estructura de tablas en JSON
+gufi rows m360_t16192 --json    # Registros en JSON
+gufi row m360_t16192 5 --json   # Registro específico en JSON
+gufi packages --json            # Lista packages en JSON
+gufi package 14 --json          # Detalles del package en JSON
 ```
 
-### Desarrollo de Views
-
-```bash
-# Ver tus views del Marketplace (muestra ID de cada vista)
-gufi views
-#   📦 Gestión de Tareas (ID: 14)
-#      └─ 13 Tasks Manager (custom)
-
-# Descargar view por ID (se guarda en ~/gufi-dev/view_<id>/)
-gufi view:pull 13
-
-# Auto-sync al guardar archivos
-gufi view:watch
-
-# Ver console.log del LivePreview
-gufi view:logs
+Usar `--json` cuando necesites parsear el output programáticamente.
 
-# Subir cambios manualmente
-gufi view:push
+## MCP Server (Model Context Protocol)
 
-# Ver estado de sincronización
-gufi view:status
-```
+El CLI incluye un servidor MCP que permite a Claude interactuar **directamente** con Gufi sin ejecutar comandos manualmente.
 
-### Packages del Marketplace
+### Configuración (una sola vez)
 
 ```bash
-# Ver mis packages
-gufi packages
-
-# Ver detalles de un package (módulos, views, estado)
-gufi package 14
-
-# Crear nuevo package
-gufi package:create "Mi Package" --description "Descripción opcional"
-
-# Añadir módulo de una company al package
-gufi package:add-module 14 --company 146 --module 360
-# O interactivo (muestra companies disponibles)
-gufi package:add-module 14
-
-# Ver cambios pendientes en módulos
-gufi package:check 14
-
-# Sincronizar versión (actualiza snapshots de módulos)
-gufi package:sync 14
-
-# Publicar package al Marketplace
-gufi package:publish 14
-
-# Despublicar
-gufi package:unpublish 14
-
-# Gestionar views del package
-gufi package:views 14
-gufi package:add-view 14 <viewId>
-gufi package:remove-view 14 <packageViewId>
-
-# Eliminar módulo o package
-gufi package:remove-module 14 <moduleId>
-gufi package:delete 14
+claude mcp add --transport stdio gufi -- gufi mcp
+```
+
+### Tools disponibles (42 tools)
+
+**Contexto e Info (EMPEZAR AQUÍ):**
+- `gufi_context` - **USAR PRIMERO** - Genera contexto inteligente del proyecto
+- `gufi_whoami` - Usuario y entorno actual
+- `gufi_schema` - Estructura de tablas/campos
+
+**Companies:**
+- `gufi_companies` - Listar companies
+- `gufi_company_create` - Crear company
+
+**Módulos (estructura de datos):**
+- `gufi_modules` - Listar módulos de una company
+- `gufi_module` - Ver JSON completo de un módulo
+- `gufi_module_update` - **Modificar módulo** (añadir campos, entidades)
+- `gufi_module_create` - Crear módulo nuevo
+
+**Automations (lógica de negocio):**
+- `gufi_automations` - Listar scripts
+- `gufi_automation` - Ver código JS de un script
+- `gufi_automation_create` - **Crear/actualizar script**
+- `gufi_entity_automations` - Ver triggers de una entidad
+- `gufi_entity_automations_update` - **Configurar triggers**
+- `gufi_automations_executions` - Ver historial de ejecuciones
+
+**Datos (CRUD):**
+- `gufi_rows` - Listar registros de una tabla
+- `gufi_row` - Ver un registro
+- `gufi_row_create` - Crear registro
+- `gufi_row_update` - Actualizar registro
+- `gufi_row_delete` - Eliminar registro
+
+**Environment Variables:**
+- `gufi_env` - Listar variables
+- `gufi_env_set` - Crear/actualizar variable
+- `gufi_env_delete` - Eliminar variable
+
+**Vistas (React/TSX):**
+- `gufi_view_files` - Ver archivos de una vista
+- `gufi_view_file_update` - **Modificar archivo de vista**
+- `gufi_view_files_update` - Modificar múltiples archivos
+
+**Packages (Marketplace):**
+- `gufi_packages` - Listar packages
+- `gufi_package` - Ver detalles
+- `gufi_package_create` - Crear package
+- `gufi_package_publish` - Publicar
+- `gufi_package_sync` - Sincronizar versión
+- `gufi_package_add_module` / `gufi_package_remove_module`
+- `gufi_package_add_view` / `gufi_package_remove_view`
+
+**Package Migrations:**
+- `gufi_package_migrations` - Listar migraciones
+- `gufi_package_migration_create` - Crear migración SQL
+- `gufi_package_entities` - Listar entidades para target_entity
+
+### Ejemplos de uso con Claude
+
+```
+Usuario: "Agrega un campo 'fecha_entrega' tipo date al módulo de pedidos"
+Claude: [usa gufi_module para leer] → [modifica JSON] → [usa gufi_module_update]
+        "Listo, agregué el campo fecha_entrega al módulo de pedidos"
+
+Usuario: "Crea un automation que envíe email cuando un pedido pase a 'enviado'"
+Claude: [usa gufi_automations para ver existentes]
+        [escribe código JS]
+        [usa gufi_automation_create]
+        [usa gufi_entity_automations_update para configurar trigger]
+        "Listo, creé el automation 'email_pedido_enviado' con trigger on_update"
+
+Usuario: "¿Cuántos clientes hay en la empresa 116?"
+Claude: [usa gufi_schema para encontrar tabla de clientes]
+        [usa gufi_rows para consultar]
+        "Hay 234 clientes en la tabla m360_t4136"
+```
+
+### Tipos de Campo (@gufi/column-types)
+
+Al crear o actualizar datos, usa los formatos correctos:
+
+**Simples:**
+- text, textarea, email, url, barcode: `"string"`
+- number_int: `42` | number_float: `3.14` | percentage: `0.75`
+- boolean: `true/false`
+- date: `"2024-01-15"` | datetime: `"2024-01-15T10:30:00Z"` | time: `"14:30:00"`
+- select: `"value"` | relation: `123`
+
+**Arrays:**
+- multiselect: `["value1", "value2"]`
+- users: `[16, 23]`
+
+**JSONB (objetos complejos):**
+- currency: `{ "currency": "EUR", "amount": 150.00 }`
+- phone: `{ "prefix": "+34", "number": "612345678" }`
+- location: `{ "street": "Mayor", "number": "15", "city": "Madrid", "lat": 40.41 }`
+- file: `[{ "url": "company_130/doc.pdf", "name": "doc.pdf" }]`
+
+En vistas usa `gufi.CB.*` para formatear correctamente:
+```typescript
+gufi.CB.currency(150)     // → { currency: 'EUR', amount: 150 }
+gufi.CB.phone('612345678') // → { prefix: '+34', number: '612345678' }
+gufi.CB.date()            // → '2024-01-15' (hoy)
+gufi.CB.multiselect('a', 'b') // → ['a', 'b']
 ```
 
-### Opciones Globales
-
-| Opción | Descripción |
-|--------|-------------|
-| `-c, --company <id>` | ID de company (solo para `modules`, `automations`, `*:create`) |
-| `-e, --edit` | Abrir en editor ($EDITOR) |
-| `-f, --file <path>` | Guardar a archivo |
-| `--dry-run` | Validar sin aplicar |
-| `-h, --help` | Ayuda del comando |
-
-**Auto-detección:** `module`, `module:update`, `automation`, `entity:automations`, `rows` detectan company automáticamente del ID.
-
----
-
-## Tips para Claude
-
-### 💜 Flujo de Trabajo Recomendado
-
-```bash
-# 1. Primero, oriéntate
-gufi companies                    # Ver companies disponibles
-gufi modules 146                  # Ver módulos de una company
+### Seguridad
 
-# 2. Para ver/modificar datos (auto-detecta company)
-gufi rows m308_t4136              # Auto-detecta company del módulo 308
-gufi row m308_t4136 123           # Ver registro específico
-gufi row:update m308_t4136 123 --data '{"status":"done"}'
+- Usa las credenciales del CLI (`gufi login`)
+- Solo accede a resources con permisos del usuario
+- Todo corre localmente (stdio), no hay servidor público
 
-# 3. Para editar estructura (módulos - auto-detecta company)
-gufi module 360 --edit            # Abre JSON en tu $EDITOR
+## Comandos Esenciales
 
-# 4. Para editar lógica (automations - auto-detecta company)
-gufi automation 15                # Busca por script_id
-gufi automation 15 --edit         # Editar código JS
-```
-
-### Cuándo usar cada comando
-
-| El usuario quiere... | Comando |
-|---------------------|---------|
+| Quiero... | Comando |
+|-----------|---------|
+| **Contexto para Claude** | `gufi context` |
+| **Diagnóstico** | `gufi doctor` |
 | Ver companies | `gufi companies` |
-| Ver módulos de company | `gufi modules 146` |
-| Ver/editar módulo | `gufi module 360` |
-| Ver/editar automation | `gufi automation 15` |
-| Ver/editar datos | `gufi rows m308_t4136` |
-| Desarrollar vista | `gufi pull "Mi Vista"` → `gufi watch` → `gufi logs` |
-
-### Auto-detección
-
-Todo automático:
-- `gufi module 360` → detecta company del módulo
-- `gufi automation 15` → detecta company del script
-- `gufi rows m308_t4136` → detecta company de la tabla
-
-### Automations: 4 tablas que trabajan juntas
-
-```
-automation_scripts (id=15)     ← CÓDIGO JavaScript
-         │
-         └── entities.automations  ← CONFIGURACIÓN (qué trigger, cuándo ejecutar)
-                   │
-                   ▼ (sync automático)
-         automation_meta           ← ÍNDICE para worker
-                   │
-                   ▼
-         automation_executions     ← HISTORIAL de ejecuciones
-```
-
-| Tabla | Qué guarda | CLI |
-|-------|------------|-----|
-| `automation_scripts` | Código JS | `gufi automation 15` |
-| `entities.automations` | Triggers (on_insert, on_click...) | `gufi entity:automations 4136` |
-| `automation_meta` | Índice para worker (auto-sync) | `gufi automations:meta` |
-| `automation_executions` | Historial de ejecuciones | `gufi automations:executions` |
-
-**Ejemplo:** Un script puede usarse en varias entities:
-```
-script 15 "sync_nayax" → machines (on_click), products (scheduled), sales (on_insert)
-```
-
-**Flujo típico:**
-```bash
-gufi automations                # Ver scripts
-gufi automation 15 --edit       # Editar código
-gufi entity:automations 4136    # Ver/editar triggers
-gufi automations:meta           # Ver qué tiene el worker indexado (debugging)
-gufi automations:executions     # Ver historial de ejecuciones
-```
-
-### Errores comunes
-
-| Error | Solución |
-|-------|----------|
-| "No estás logueado" | `gufi login` (guarda credenciales para auto-login) |
-| "Módulo no encontrado" | Verificar que el ID existe con `gufi modules <company>` |
-| "Token expirado" | Automático: refresh o auto-login con credenciales guardadas |
-| "JSON inválido" | Validar estructura del JSON |
-| "API Error 404" | Verificar nombre de tabla (formato: `m{moduleId}_t{entityId}`) |
-
-### Conceptos clave
-
-- **Multi-tenant**: Cada company = schema aislado en PostgreSQL
-- **Tablas físicas**: `m{moduleId}_t{entityId}` (ej: `m308_t4136`)
-- **Módulos**: JSON que define estructura → Gufi crea tablas/UI
-- **Automations**: JS en DB, ejecutado por worker (pg-boss)
-- **Views**: React/TS en DB, ejecutado en frontend dinámicamente
-- **Marketplace**: Sistema de distribución de packages
-
-### Companies Importantes
+| Ver módulos | `gufi modules 146` |
+| Editar módulo | `gufi module 360 --edit` |
+| Ver automations | `gufi automations` |
+| Desarrollar vista | `gufi view:pull 13` → `gufi view:push` |
 
-| ID | Nombre | Uso |
-|----|--------|-----|
-| 101 | Demo | Pruebas generales |
-| 116 | Fitvending | Producción - cliente real |
-| 146 | Gufi | Desarrollo interno |
-| 147 | Apuestas Pro | Cliente real |
+## Tips
 
----
+1. **`gufi context`**: Úsalo al inicio de cualquier tarea
+2. **Auto-detección**: `module`, `automation`, `rows` detectan company automáticamente
+3. **--edit**: Abre en `$EDITOR`
+4. **Entornos separados**: Cada uno con sus credenciales
+5. **Auto-login**: CLI refresca tokens automáticamente
 
-## Links
+## Documentación Completa
 
-- **Web**: https://gogufi.com
-- **Docs**: https://github.com/juanbp23/gogufi/blob/main/docs/guide/05-marketplace.md
+Para documentación detallada de cada comando, arquitectura, y patrones, ve a:
+- `docs/claude/` - Fuente de verdad para Claude
+- `docs/guide/27-gufi-cli.md` - Guía técnica del CLI