gufi-cli 0.1.49 → 0.1.51

package/docs/mcp/09-examples.md

@@ -0,0 +1,453 @@
+# Ejemplos Practicos
+
+Ejemplos listos para copiar/adaptar.
+
+## Agregar campo a entidad existente
+
+```javascript
+gufi_schema_modify({
+  company_id: "116",
+  operations: [{
+    op: "add_field",
+    entity: "ventas.pedidos",  // modulo.entidad
+    field: {
+      name: "fecha_entrega",
+      type: "date",
+      label: "Fecha de Entrega",
+      required: false
+    }
+  }]
+})
+```
+
+## Crear entidad completa
+
+```javascript
+gufi_schema_modify({
+  company_id: "116",
+  operations: [{
+    op: "add_entity",
+    module: "inventario",
+    entity: {
+      name: "productos",
+      label: "Productos",
+      kind: "table",
+      fields: [
+        { name: "nombre", type: "text", label: "Nombre", required: true },
+        { name: "sku", type: "barcode", label: "SKU" },
+        { name: "descripcion", type: "text", label: "Descripcion" },
+        { name: "precio", type: "currency", label: "Precio" },
+        { name: "stock", type: "number_int", label: "Stock" },
+        { name: "categoria", type: "select", label: "Categoria", options: [
+          { value: "electronica", label: "Electronica", color: "blue" },
+          { value: "hogar", label: "Hogar", color: "green" },
+          { value: "ropa", label: "Ropa", color: "purple" }
+        ]},
+        { name: "activo", type: "boolean", label: "Activo" }
+      ],
+      permissions: {
+        admin: "*",
+        almacen: ["entity:view", "entity:create", "entity:update"],
+        ventas: ["entity:view"]
+      }
+    }
+  }]
+})
+```
+
+## Automation: Email al crear
+
+```javascript
+// 1. Crear el script
+gufi_automation_scripts({
+  action: "create",
+  company_id: "116",
+  name: "notificar_pedido_nuevo",
+  description: "Envia email cuando se crea un pedido",
+  code: `
+async function notificar_pedido_nuevo(gufi) {
+  const { row, env } = gufi.context;
+
+  gufi.logger.info('Nuevo pedido', { id: row.id });
+
+  await gufi.integrations.notifications.email({
+    to: env.VENTAS_EMAIL,
+    subject: \`Nuevo pedido #\${row.id}\`,
+    html: \`
+      <h2>Nuevo Pedido</h2>
+      <p><strong>Cliente:</strong> \${row.cliente__display || 'N/A'}</p>
+      <p><strong>Total:</strong> \${row.total || 0} EUR</p>
+      <p><strong>Estado:</strong> \${row.estado__display || row.estado}</p>
+      <p><a href="https://app.gogufi.com/pedidos/\${row.id}">Ver pedido</a></p>
+    \`,
+    user: env.EMAIL_USER,
+    pass: env.EMAIL_PASS,
+    from: env.EMAIL_FROM,
+  });
+
+  return { success: true, message: 'Email enviado' };
+}
+`
+})
+
+// 2. Vincular a entidad
+gufi_automation_meta({
+  entity_id: "16192",
+  company_id: "116",
+  automations: [
+    { trigger: "insert", function_name: "notificar_pedido_nuevo" }
+  ]
+})
+```
+
+## Automation: Webhook externo
+
+```javascript
+gufi_automation_scripts({
+  action: "create",
+  company_id: "116",
+  name: "sync_to_external",
+  code: `
+async function sync_to_external(gufi) {
+  const { row, old_row, env } = gufi.context;
+
+  // Solo si cambio el estado
+  if (row.estado === old_row?.estado) {
+    return { success: true, message: 'Sin cambios' };
+  }
+
+  try {
+    const response = await gufi.http(env.WEBHOOK_URL, {
+      method: 'POST',
+      headers: {
+        'Authorization': \`Bearer \${env.API_TOKEN}\`,
+        'Content-Type': 'application/json'
+      },
+      body: JSON.stringify({
+        event: 'status_changed',
+        record_id: row.id,
+        old_status: old_row?.estado,
+        new_status: row.estado,
+        timestamp: new Date().toISOString()
+      })
+    });
+
+    gufi.logger.info('Webhook response', response);
+    return { success: true };
+
+  } catch (err) {
+    gufi.logger.error('Webhook failed', { error: err.message });
+    return { success: false, message: err.message };
+  }
+}
+`
+});
+```
+
+## Vista: Lista con filtros
+
+```typescript
+// index.tsx
+import React, { useState, useEffect, useMemo } from 'react';
+import { Search, Filter } from 'lucide-react';
+import {
+  cn,
+  useDebouncedValue,
+  formatNumber,
+  formatCurrency,
+  toastError,
+  tUI,
+  type FeatureProps
+} from '@/sdk';
+
+export { featureConfig } from './core/dataProvider';
+
+export default function ListaFiltros({ id, gufi }: FeatureProps) {
+  const { dataProvider, context, seedData } = gufi;
+  const isPreview = context?.isPreview;
+
+  // 💜 Nombre lógico - dataProvider lo resuelve automáticamente
+  const itemsTable = 'ventas.items';
+
+  const [data, setData] = useState<any[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [search, setSearch] = useState('');
+  const [filter, setFilter] = useState<string>('all');
+
+  const debouncedSearch = useDebouncedValue(search, 200);
+
+  // Cargar datos
+  useEffect(() => {
+    const load = async () => {
+      setLoading(true);
+
+      if (isPreview && seedData?.data) {
+        setData(seedData.data.items || []);
+        setLoading(false);
+        return;
+      }
+
+      if (!dataProvider) {
+        setLoading(false);
+        return;
+      }
+
+      try {
+        const res = await dataProvider.getList({
+          resource: itemsTable,  // 💜 Nombre lógico
+          pagination: { current: 1, pageSize: 200 },
+          sort: { field: 'created_at', order: 'DESC' }
+        });
+        setData(res.data || []);
+      } catch (err) {
+        toastError('Error cargando datos');
+      }
+      setLoading(false);
+    };
+
+    load();
+  }, [dataProvider, itemsTable, seedData, isPreview]);
+
+  // Filtrar datos
+  const filtered = useMemo(() => {
+    let result = data;
+
+    // Filtro por estado
+    if (filter !== 'all') {
+      result = result.filter(item => item.estado === filter);
+    }
+
+    // Busqueda
+    if (debouncedSearch) {
+      const term = debouncedSearch.toLowerCase();
+      result = result.filter(item =>
+        item.nombre?.toLowerCase().includes(term) ||
+        item.cliente__display?.toLowerCase().includes(term)
+      );
+    }
+
+    return result;
+  }, [data, filter, debouncedSearch]);
+
+  if (loading) {
+    return (
+      <div className="p-4 space-y-2">
+        {[...Array(5)].map((_, i) => (
+          <div key={i} className="h-16 bg-gray-100 rounded animate-pulse" />
+        ))}
+      </div>
+    );
+  }
+
+  return (
+    <div className="flex flex-col h-[100dvh] bg-gradient-to-br from-violet-50/40 via-white to-purple-50/40">
+      {/* Header con busqueda */}
+      <div className="p-4 border-b bg-white/80 backdrop-blur">
+        <div className="flex gap-2">
+          <div className="flex-1 relative">
+            <Search className="absolute left-3 top-1/2 -translate-y-1/2 w-4 h-4 text-gray-400" />
+            <input
+              type="text"
+              value={search}
+              onChange={(e) => setSearch(e.target.value)}
+              placeholder={tUI('common.search')}
+              className="w-full pl-10 pr-4 py-2 border rounded-lg focus:ring-2 focus:ring-violet-500"
+            />
+          </div>
+          <select
+            value={filter}
+            onChange={(e) => setFilter(e.target.value)}
+            className="px-3 py-2 border rounded-lg"
+          >
+            <option value="all">Todos</option>
+            <option value="pendiente">Pendientes</option>
+            <option value="completado">Completados</option>
+          </select>
+        </div>
+      </div>
+
+      {/* Lista */}
+      <div className="flex-1 overflow-auto">
+        <div className="p-4 text-sm text-gray-500">
+          {formatNumber(filtered.length)} resultados
+        </div>
+
+        {filtered.map(item => (
+          <div
+            key={item.id}
+            className="mx-4 mb-2 p-4 bg-white rounded-lg border hover:border-violet-300 transition-colors"
+          >
+            <div className="flex justify-between items-start">
+              <div>
+                <h3 className="font-medium">{item.nombre}</h3>
+                <p className="text-sm text-gray-500">{item.cliente__display}</p>
+              </div>
+              <div className="text-right">
+                <div className="font-semibold text-violet-600">
+                  {formatCurrency(item.total || 0, 'EUR')}
+                </div>
+                <span className={cn(
+                  "text-xs px-2 py-0.5 rounded-full",
+                  item.estado === 'completado' ? "bg-green-100 text-green-700" : "bg-yellow-100 text-yellow-700"
+                )}>
+                  {item.estado__display || item.estado}
+                </span>
+              </div>
+            </div>
+          </div>
+        ))}
+      </div>
+    </div>
+  );
+}
+```
+
+```typescript
+// core/dataProvider.ts
+import type { FeatureConfig } from '@/sdk';
+
+export const featureConfig: FeatureConfig = {
+  dataSources: {
+    mainTable: {
+      type: 'table',
+      module: 'ventas',
+      entity: 'pedidos',
+      label: 'Pedidos'
+    }
+  },
+  inputs: {},
+  seedData: {
+    description: { es: 'Lista de pedidos', en: 'Orders list' },
+    data: {
+      items: [
+        { id: 1, nombre: 'Pedido #001', cliente__display: 'Empresa A', total: 1500, estado: 'pendiente', estado__display: 'Pendiente' },
+        { id: 2, nombre: 'Pedido #002', cliente__display: 'Empresa B', total: 2300, estado: 'completado', estado__display: 'Completado' }
+      ]
+    },
+    order: ['items']
+  }
+};
+```
+
+## Crear registro con todos los tipos
+
+```javascript
+gufi_data({
+  action: "create",
+  table: "ventas.productos",
+  company_id: "116",
+  data: {
+    // Texto
+    nombre: "Mi Producto",
+    email: "contacto@empresa.com",
+    url: "https://ejemplo.com",
+    codigo_barras: "8414533043847",
+
+    // Numeros
+    cantidad: 100,
+    precio: 150.50,
+    descuento: 0.15,  // 15%
+
+    // Fechas
+    fecha_alta: "2024-01-15",
+    hora_apertura: "09:00:00",
+
+    // Seleccion (incluir __display!)
+    estado: "activo",
+    estado__display: "Activo",
+    categorias: ["electronica", "hogar"],
+    activo: true,
+
+    // Relaciones (incluir __display!)
+    cliente_id: 45,
+    cliente_id__display: "Empresa ABC",
+    responsables: [16, 23],
+
+    // Complejos
+    telefono: { prefix: "+34", number: "612345678" },
+    direccion: {
+      street: "Gran Via",
+      number: "1",
+      city: "Madrid",
+      postal_code: "28013",
+      country: "ES"
+    }
+  }
+})
+```
+
+## Consulta SQL en automation
+
+```javascript
+gufi_automation_scripts({
+  action: "create",
+  company_id: "116",
+  name: "reporte_ventas",
+  code: `
+async function reporte_ventas(gufi) {
+  const { env } = gufi.context;
+
+  // Obtener resumen de ventas del mes
+  const rows = await gufi.query(\`
+    SELECT
+      DATE_TRUNC('day', created_at) as fecha,
+      COUNT(*) as num_pedidos,
+      SUM(total) as total_ventas,
+      AVG(total) as ticket_medio
+    FROM m360_t16192
+    WHERE created_at >= DATE_TRUNC('month', CURRENT_DATE)
+    GROUP BY DATE_TRUNC('day', created_at)
+    ORDER BY fecha DESC
+  \`);
+
+  // Formatear reporte
+  const reporteHtml = rows.map(r => \`
+    <tr>
+      <td>\${new Date(r.fecha).toLocaleDateString('es-ES')}</td>
+      <td>\${r.num_pedidos}</td>
+      <td>\${Number(r.total_ventas).toFixed(2)} EUR</td>
+      <td>\${Number(r.ticket_medio).toFixed(2)} EUR</td>
+    </tr>
+  \`).join('');
+
+  await gufi.integrations.notifications.email({
+    to: env.ADMIN_EMAIL,
+    subject: 'Reporte de Ventas Mensual',
+    html: \`
+      <h2>Reporte de Ventas</h2>
+      <table border="1" cellpadding="5">
+        <tr><th>Fecha</th><th>Pedidos</th><th>Total</th><th>Ticket Medio</th></tr>
+        \${reporteHtml}
+      </table>
+    \`,
+    user: env.EMAIL_USER,
+    pass: env.EMAIL_PASS,
+    from: env.EMAIL_FROM,
+  });
+
+  return { success: true, message: \`Reporte enviado con \${rows.length} dias\` };
+}
+`
+});
+```
+
+## Editar vista localmente
+
+```javascript
+// 1. Descargar vista a ~/gufi-dev/view_13/
+gufi_view_pull({ view_id: 13 })
+
+// 2. Editar archivos con Read/Edit tools
+// Read("~/gufi-dev/view_13/index.tsx")
+// Edit("~/gufi-dev/view_13/index.tsx", ...)
+
+// 3. Subir cambios
+gufi_view_push({ view_id: 13, message: "Changed table name" })
+
+// 4. Testear en headless browser (OBLIGATORIO antes de publicar)
+gufi_view_test({ view_id: 13, company_id: "116" })
+// Ver errores JS, console logs, screenshot
+
+// 5. Si todo OK, publicar package
+gufi_package({ action: "publish", id: "19" })
+```

package/docs/mcp/README.md

@@ -0,0 +1,71 @@
+# Documentación Gufi para Consultores y Developers
+
+> **Para usuarios de la plataforma Gufi**: Si estás creando ERPs personalizados con Gufi (módulos, vistas, automations), esta es tu documentación.
+
+Esta carpeta contiene la documentación para trabajar con Gufi usando el CLI y MCP (Model Context Protocol) con Claude AI.
+
+## 🚀 Comienza aquí
+
+**Nuevo en Gufi?** Lee `00-overview.md` primero para entender qué es y cómo funciona.
+
+**Ya conoces Gufi?** Salta directo al archivo que necesites según la tabla de abajo.
+
+## 📚 Índice de Documentación
+
+| Archivo | Qué aprenderás | Cuándo consultarlo |
+|---------|----------------|-------------------|
+| **[00-overview.md](./00-overview.md)** | Qué es Gufi, arquitectura básica, flujo de trabajo típico | 👉 **Empieza aquí** si eres nuevo |
+| **[01-architecture.md](./01-architecture.md)** | Arquitectura técnica completa (backend, BD, real-time) | Necesitas entender cómo conectan los componentes |
+| **[02-modules.md](./02-modules.md)** | Crear/modificar módulos y entidades (estructura de datos) | Vas a crear o cambiar tablas |
+| **[03-fields.md](./03-fields.md)** | Tipos de campos y `gufi.CB.*` builders | Vas a crear/actualizar registros |
+| **[04-views.md](./04-views.md)** | Sistema de vistas React (UI personalizada) | Vas a crear o modificar interfaces |
+| **[05-automations.md](./05-automations.md)** | Escribir automations (lógica de negocio) | Necesitas automatizar procesos |
+| **[06-api.md](./06-api.md)** | API endpoints y métodos disponibles | Vas a integrar con APIs externas |
+| **[07-packages.md](./07-packages.md)** | Crear y publicar packages en Marketplace | Vas a distribuir tu solución |
+| **[08-common-errors.md](./08-common-errors.md)** | Errores comunes y cómo solucionarlos | 🐛 Algo no funciona |
+| **[09-examples.md](./09-examples.md)** | Ejemplos prácticos completos | Necesitas código de referencia |
+
+## 🛠️ Cómo usar esta documentación
+
+### Desde CLI
+
+```bash
+# Ver contexto completo de un package
+gufi context --package 14
+
+# Consultar documentación específica
+gufi docs overview       # Lee 00-overview.md
+gufi docs fields         # Lee 03-fields.md
+gufi docs automations    # Lee 05-automations.md
+```
+
+### Desde Claude AI (MCP)
+
+Si usas Claude con el plugin Gufi MCP:
+
+```typescript
+// Claude puede consultar automáticamente:
+gufi_docs({ topic: "views" })        // Lee 04-views.md
+gufi_docs({ topic: "fields" })       // Lee 03-fields.md
+gufi_docs({ search: "currency" })    // Busca término en todos los docs
+```
+
+## 💡 Casos de uso típicos
+
+| Quiero... | Lee esto |
+|-----------|----------|
+| Crear un módulo de inventario | `02-modules.md` → `03-fields.md` |
+| Hacer una vista personalizada de reportes | `04-views.md` → `09-examples.md` |
+| Automatizar envío de emails al crear pedido | `05-automations.md` |
+| Entender errores de `gufi.CB.currency()` | `03-fields.md` → `08-common-errors.md` |
+| Publicar mi solución en Marketplace | `07-packages.md` |
+
+## ⚠️ Nota importante
+
+Esta documentación es para **usar Gufi** (crear ERPs), no para **desarrollar el codebase de Gufi**.
+
+Si estás desarrollando el codebase interno, consulta `/docs/claude/` en vez de `/docs/mcp/`.
+
+---
+
+**Última actualización**: 2025-01-14

package/docs/mcp/tool-descriptions.json

@@ -0,0 +1,64 @@
+{
+  "_comment": "Gufi MCP - 15 tools. Para usuarios que construyen ERPs con Gufi.",
+  "_env_note": "El entorno se configura con 'gufi config:local' o 'gufi config:prod' + 'gufi login'. El parametro env:'dev' es un OVERRIDE que requiere tener credenciales guardadas para ese entorno.",
+
+  "gufi_context": {
+    "description": "THE ONE TOOL FOR CONTEXT. Llama esto PRIMERO.\n\nUsos:\n  gufi_context({ company_id: '146' }) - Schema COMPLETO de empresa\n  gufi_context({ view_id: '13' }) - Contexto de vista\n  gufi_context({ package_id: '14' }) - Contexto de package\n\nSiempre devuelve contexto completo: campos, tipos, relaciones, automations, permisos."
+  },
+
+  "gufi_whoami": {
+    "description": "Ver usuario actual y entorno (dev/prod). Usa para verificar autenticación."
+  },
+
+  "gufi_schema_modify": {
+    "description": "Modificar schema. Operaciones atómicas para módulos, entities, fields y sections.\n\nMÓDULOS:\n  add_module: { op: 'add_module', module: { name: 'inventario', label: 'Inventario' } }\n  remove_module: { op: 'remove_module', module: 'inventario' } ⚠️ Borra TODO el módulo y sus datos\n\nSECCIONES (submodules):\n  add_submodule: { op: 'add_submodule', module: 'ventas', submodule: { name: 'reportes', label: 'Reportes' } }\n  remove_submodule: { op: 'remove_submodule', module: 'ventas', submodule: 'reportes' } → Mueve entities a 'general'\n\nENTIDADES:\n  add_entity: { op: 'add_entity', module: 'ventas', entity: { name: 'facturas', label: 'Facturas' } }\n  update_entity: { op: 'update_entity', entity: 'clientes', changes: { label: 'Clientes VIP' } }\n  remove_entity: { op: 'remove_entity', entity: 'clientes' } ⚠️ Borra tabla y datos\n\n💜 CREAR VISTAS (Custom Views):\n  add_entity con kind='marketplace_view': { op: 'add_entity', module: 'ventas', entity: { name: 'mi_dashboard', label: 'Mi Dashboard', kind: 'marketplace_view' } }\n  Luego usa gufi_view_pull({ view_id: <id> }) para descargar el template y empezar a codear.\n\nCAMPOS:\n  add_field: { op: 'add_field', entity: 'clientes', field: { name: 'phone', type: 'phone', label: 'Teléfono' } }\n  update_field: { op: 'update_field', entity: 'clientes', field_name: 'phone', changes: { required: true } }\n  remove_field: { op: 'remove_field', entity: 'clientes', field_name: 'old_field' } ⚠️ Borra columna y datos\n\nCAMPOS RELATION (FK):\n  { op: 'add_field', entity: 'pedidos', field: { name: 'cliente_id', type: 'relation', ref: 'ventas.clientes', display: 'nombre', label: 'Cliente' } }\n  ⚠️ IMPORTANTE: ref usa formato 'modulo.entidad', NO { entity, module }\n\nTipos de campo: text, email, number_int, number_float, currency, date, select, multiselect, relation, phone, location, file, boolean, json\nAliases automáticos: textarea→text, varchar→text, int→number_int, float→number_float, bool→boolean, timestamp→datetime\n\nReferencias: Usa nombre lógico ('ventas.clientes') o ID numérico.\nPreview: Usa preview: true para ver qué haría sin ejecutar.\nBatch: Usa skip_existing: true para saltar campos/entidades que ya existen (no falla)."
+  },
+
+  "gufi_docs": {
+    "description": "Leer documentación de Gufi. USA ESTO cuando no sepas cómo funciona algo.\n\nTopics: overview, fields, views, automations, errors, examples, api, modules, packages"
+  },
+
+  "gufi_automation_scripts": {
+    "description": "CRUD de automation scripts.\n\nAcciones:\n  list: gufi_automation_scripts({ action: 'list', company_id: '146' })\n  get: gufi_automation_scripts({ action: 'get', company_id: '146', id: '5' })\n  create: gufi_automation_scripts({ action: 'create', company_id: '146', name: 'mi_script', code: '...' })\n  update: gufi_automation_scripts({ action: 'update', company_id: '146', name: 'mi_script', code: '...' })\n  delete: gufi_automation_scripts({ action: 'delete', company_id: '146', name: 'mi_script' })\n\nIMPORTANTE: api.query() retorna rows directamente (no { rows })."
+  },
+
+  "gufi_automation_script_test": {
+    "description": "Ejecutar/testear un automation script manualmente.\n\nParámetros:\n- entity: Nombre lógico (module.entity). Opcional para scripts standalone.\n- row: Datos de la fila (incluir id). Opcional si usas input.\n- input: Datos adicionales (van a context.input). Opcional si usas row.\n\nEjemplo con entidad:\ngufi_automation_script_test({\n  company_id: '116',\n  script_name: 'send_email',\n  entity: 'ventas.facturas',\n  trigger_event: 'on_click',\n  row: { id: 1, total: 150 },\n  input: { email_to: 'test@example.com' }\n})\n\nEjemplo standalone (sin entidad):\ngufi_automation_script_test({\n  company_id: '116',\n  script_name: 'daily_report',\n  trigger_event: 'scheduled',\n  input: { date: '2024-01-15' }\n})"
+  },
+
+  "gufi_automation_meta": {
+    "description": "Ver/configurar triggers de entidades.\n\nVer: gufi_automation_meta({ entity_id: '123', company_id: '146' })\nSet: gufi_automation_meta({ entity_id: '123', company_id: '146', automations: [{ trigger: 'insert', function_name: 'my_script' }] })\n\nTriggers válidos: insert, update, delete, click, scheduled, custom\n\n💜 CUSTOM: Para vistas, no configures manualmente. Usa core/automations.ts y gufi_view_push lo registra automáticamente."
+  },
+
+  "gufi_automation_integrations": {
+    "description": "List Gufi's built-in integrations (Stripe, Nayax, etc.) and their api.* methods. These are pre-built by Gufi - users can also create custom integrations directly in their automations using api.http() for any external service. Credentials are passed using env.* variables."
+  },
+
+  "gufi_automation_executions": {
+    "description": "Ver historial de ejecuciones de automations. Útil para debugging."
+  },
+
+  "gufi_data": {
+    "description": "CRUD unificado para datos.\n\nAcciones:\n  list: gufi_data({ action: 'list', table: 'ventas.productos', company_id: '146' })\n  get: gufi_data({ action: 'get', table: '...', id: 123 })\n  create: gufi_data({ action: 'create', table: '...', data: {...} })\n  update: gufi_data({ action: 'update', table: '...', id: 123, data: {...} })\n  delete: gufi_data({ action: 'delete', table: '...', id: 123 })\n\nAnalytics:\n  aggregate: gufi_data({ action: 'aggregate', table: 'ventas.pedidos', agg: 'sum', field: 'total' })\n  - agg: 'count', 'sum', 'avg', 'min', 'max'\n  - groupBy: gufi_data({ action: 'aggregate', table: '...', agg: 'sum', field: 'total', groupBy: 'cliente_id' })\n  - filter: gufi_data({ action: 'aggregate', table: '...', agg: 'count', filter: 'estado=activo' })\n  - dateField: gufi_data({ action: 'aggregate', table: '...', agg: 'sum', field: 'total', groupBy: 'cliente_id', dateField: 'fecha', dateFrom: '2025-12-01', dateTo: '2025-12-31' })\n\nOpciones list:\n  - fields: ['id', 'nombre'] - Solo columnas específicas\n  - compact: true - Respuesta mínima (solo data)"
+  },
+
+  "gufi_env": {
+    "description": "Variables de entorno. Se usan en automations como process.env.KEY.\n\nAcciones:\n  list: gufi_env({ action: 'list', company_id: '146' })\n  set: gufi_env({ action: 'set', company_id: '146', key: 'API_KEY', value: '...' })\n  delete: gufi_env({ action: 'delete', company_id: '146', key: 'API_KEY' })"
+  },
+
+  "gufi_view_pull": {
+    "description": "📥 Descargar vista a local para editarla.\n\nDescarga a: ~/gufi-dev/view_<id>/\n\n💜 FLUJO COMPLETO (crear + desarrollar):\n1. CREAR vista con gufi_schema_modify:\n   gufi_schema_modify({ company_id: '146', operations: [{ op: 'add_entity', module: 'ventas', entity: { name: 'mi_dashboard', label: 'Mi Dashboard', kind: 'marketplace_view' } }] })\n   → Retorna el view_id de la nueva vista\n2. gufi_view_pull({ view_id: <id> }) - Descargar template\n3. Editar archivos con Read/Edit\n4. gufi_view_push({ view_id: <id> }) - Subir\n5. gufi_view_test({ view_id: <id>, company_id: '146' }) - Verificar\n6. gufi_package({ action: 'publish', id: '19' }) - Publicar\n\nEjemplo: gufi_view_pull({ view_id: 13 })"
+  },
+
+  "gufi_view_push": {
+    "description": "📤 Subir cambios (sync completo).\n\nSube TODOS los archivos locales. El servidor borra los que no vengan.\n\n💜 AUTOMATIONS: Si existe core/automations.ts, las automations declaradas se registran en __automation_meta__ con trigger_event='CUSTOM'. Solo automations declaradas pueden llamarse con gufi.automation().\n\n⚠️ IMPORTANTE: Después de push, SIEMPRE usar gufi_view_test para verificar que la vista carga sin errores antes de publicar.\n\nFlujo:\n1. Crear scripts: gufi_automation_scripts({ action: 'create', name: 'mi_script' })\n2. Declarar en core/automations.ts: export const automations = [{ name: 'mi_script' }]\n3. gufi_view_push({ view_id: 13 }) → Registra automations\n4. gufi_view_test({ view_id: 13, company_id: '116' }) ← OBLIGATORIO\n5. Si OK → gufi_package({ action: 'publish', id: '19' })\n\nEjemplo: gufi_view_push({ view_id: 13, message: 'Fix bug' })"
+  },
+
+  "gufi_view_test": {
+    "description": "🧪 Test view in headless browser. Returns console logs, JS errors, API calls, and screenshot.\n\n⚠️ SIEMPRE ejecutar después de gufi_view_push para verificar que todo funciona.\n\nFlujo típico:\n1. Editar código localmente\n2. gufi_view_push({ view_id: 45 }) - Subir\n3. gufi_view_test({ view_id: 45, company_id: '150' }) - Verificar\n4. Ver errores/screenshot → Arreglar si hay problemas\n5. Repetir hasta que funcione\n6. gufi_package({ action: 'publish' }) - Publicar\n\nAcciones opcionales después de cargar:\n  actions: [\n    { type: 'click', selector: '.my-button' },\n    { type: 'fill', selector: 'input[name=search]', value: 'test' },\n    { type: 'wait', selector: '.results' },\n    { type: 'delay', ms: 1000 }\n  ]\n\nEjemplo: gufi_view_test({ view_id: 45, company_id: '150' })"
+  },
+
+  "gufi_package": {
+    "description": "Gestión de packages.\n\nAcciones:\n  list: gufi_package({ action: 'list' })\n  get: gufi_package({ action: 'get', id: '19' })\n  create: gufi_package({ action: 'create', name: 'Mi Package' })\n  delete: gufi_package({ action: 'delete', id: '19' })\n  add_module: gufi_package({ action: 'add_module', id: '19', module_id: '5', company_id: '146' })\n  remove_module: gufi_package({ action: 'remove_module', id: '19', module_id: '5' })\n  publish: gufi_package({ action: 'publish', id: '19' })"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gufi-cli",
-  "version": "0.1.49",
+  "version": "0.1.51",
   "description": "CLI for developing Gufi Marketplace views locally with Claude Code",
   "bin": {
     "gufi": "./bin/gufi.js"
@@ -8,6 +8,7 @@
   "files": [
     "bin",
     "dist",
+    "docs",
     "CLAUDE.md"
   ],
   "repository": {
@@ -17,7 +18,7 @@
   "homepage": "https://gogufi.com",
   "type": "module",
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && mkdir -p docs/mcp docs/dev-guide && cp -r ../../docs/mcp/* docs/mcp/ && cp -r ../../docs/dev-guide/* docs/dev-guide/",
     "dev": "tsc -w",
     "start": "node bin/gufi.js"
   },