gufi-cli 0.1.51 → 0.1.52

package/dist/index.js

@@ -428,6 +428,7 @@ program
 program
     .command("mcp")
     .description("Start MCP server for Claude integration (stdio transport)")
+    .option("--company <id>", "Company ID for role-based tool filtering (Workforce mode)")
     .action(startMcpServer);
 // ════════════════════════════════════════════════════════════════════
 // 💜 Claude Code Integration

package/dist/mcp.d.ts

@@ -10,4 +10,6 @@
  *
  * The MCP server exposes all CLI functionality as tools that Claude can call.
  */
-export declare function startMcpServer(): Promise<void>;
+export declare function startMcpServer(options?: {
+    company?: string;
+}): Promise<void>;

package/dist/mcp.js

@@ -585,6 +585,47 @@ function getDesc(toolName, fallback = "") {
 }
 // Environment parameter description (reused across tools)
 const ENV_PARAM = { type: "string", description: "Environment: 'prod' (default) or 'dev'. Use 'dev' for development against localhost:3000" };
+// ════════════════════════════════════════════════════════════════════════════
+// Workforce Mode - Role-based tool filtering
+// ════════════════════════════════════════════════════════════════════════════
+const ADMIN_ROLES = ['admin', 'superadmin', 'consultant'];
+function hasAdminAccess(roles) {
+    return roles.some(r => ADMIN_ROLES.includes(r.toLowerCase()));
+}
+// Tools that require Admin/Consultant role
+const ADMIN_ONLY_TOOLS = [
+    'gufi_schema_modify',
+    'gufi_env',
+    'gufi_automation_scripts',
+    'gufi_automation_meta',
+    'gufi_view_pull',
+    'gufi_view_push',
+    'gufi_view_test',
+    'gufi_browse',
+    'gufi_endpoints',
+];
+// Workforce state (null = developer mode, everything allowed)
+let workforceState = null;
+function checkEntityWritePermission(table, action, state) {
+    const entityPerms = state.entityPermissions[table];
+    if (!entityPerms)
+        return false;
+    const permMap = {
+        create: 'entity:edit',
+        update: 'entity:edit',
+        delete: 'entity:delete',
+    };
+    const required = permMap[action];
+    for (const role of state.roles) {
+        const perms = entityPerms[role];
+        if (perms === '*')
+            return true;
+        if (Array.isArray(perms) && (perms.includes(required) || perms.includes(`${required}_own`))) {
+            return true;
+        }
+    }
+    return false;
+}
 const TOOLS = [
     // ─────────────────────────────────────────────────────────────────────────
     // Context & Info
@@ -942,6 +983,61 @@ Examples:
         },
     },
     // ─────────────────────────────────────────────────────────────────────────
+    // Browse - Headless browser for any Gufi page
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: "gufi_browse",
+        description: `Browse any Gufi page in headless browser. Returns console logs, errors, API calls, and screenshot.
+
+Use to visually verify UI changes, test dialogs, check table layouts, etc.
+
+3 ways to specify the page:
+  entity: 'ventas.productos' → opens the table view (resolves module/entity automatically)
+  page: 'home' | 'automations' | 'audit' | 'views' | 'env-variables' | 'endpoints' | 'integrations' | 'agents' | 'organization' | 'database'
+  path: '/150/m308_t4136' → any raw frontend path
+
+Examples:
+  gufi_browse({ entity: 'ventas.productos', company_id: '150' })
+  gufi_browse({ page: 'home', company_id: '150' })
+  gufi_browse({ page: 'automations', company_id: '150' })
+  gufi_browse({ entity: 'ventas.productos', company_id: '150', actions: [{ type: 'click', selector: 'text:Exportar' }, { type: 'delay', ms: 500 }] })`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Raw URL path (e.g., '/150/m308_t4136'). Use entity or page shortcuts instead when possible." },
+                entity: { type: "string", description: "Entity shortcut in 'module.entity' format (e.g., 'ventas.productos'). Resolves to table view automatically." },
+                page: { type: "string", description: "Page shortcut: home, automations, audit, views, env-variables, endpoints, integrations, agents, organization, database" },
+                company_id: { type: "string", description: "Company ID for authentication context" },
+                timeout: { type: "number", description: "Navigation timeout in ms (default: 15000)" },
+                actions: {
+                    type: "array",
+                    description: `Actions to perform after page loads. Same as gufi_view_test.
+- Explore: {type:'explore'}
+- Click: {type:'click', selector:'text:Exportar'}
+- Screenshot: {type:'screenshot'}
+- Delay: {type:'delay', ms:1000}
+- Fill: {type:'fill', selector:'input[name=q]', value:'test'}`,
+                    items: {
+                        type: "object",
+                        properties: {
+                            type: { type: "string", description: "explore, click, closeModals, fill, clear, select, wait, waitForText, delay, scroll, hover, screenshot, getText, eval" },
+                            selector: { type: "string", description: "CSS selector OR 'text:Button Text'" },
+                            value: { type: "string", description: "Value for fill/select" },
+                            text: { type: "string", description: "Text to wait for (waitForText)" },
+                            ms: { type: "number", description: "Milliseconds for delay" },
+                            y: { type: "number", description: "Pixels to scroll" },
+                            timeout: { type: "number", description: "Timeout for wait (default 5000)" },
+                            code: { type: "string", description: "JS code for eval action" },
+                        },
+                    },
+                },
+                capture_screenshot: { type: "boolean", description: "Include base64 screenshot (default: true)" },
+                env: ENV_PARAM,
+            },
+            required: ["company_id"],
+        },
+    },
+    // ─────────────────────────────────────────────────────────────────────────
     // 💜 DISABLED: Packages (not actively used, keeping MCP simple)
     // ─────────────────────────────────────────────────────────────────────────
     // gufi_package → Re-enable when marketplace packages become priority
@@ -2163,6 +2259,58 @@ const toolHandlers = {
     },
     // gufi_view_create removed - views are created from UI, edited via pull/push
     // ─────────────────────────────────────────────────────────────────────────
+    // Browse - Headless browser for any page
+    // ─────────────────────────────────────────────────────────────────────────
+    async gufi_browse(params) {
+        const { path, entity, page, company_id, timeout, actions, capture_screenshot = true, env } = params;
+        if (!path && !entity && !page) {
+            return { error: "One of path, entity, or page is required" };
+        }
+        const result = await apiRequest("/api/cli/browse", {
+            method: "POST",
+            body: JSON.stringify({
+                path,
+                entity,
+                page,
+                company_id,
+                timeout: timeout || 15000,
+                actions: actions || [],
+                capture_screenshot,
+            }),
+        }, company_id, true, env);
+        const response = {
+            success: result.success,
+            url: result.url,
+            duration_ms: result.duration_ms,
+        };
+        if (result.console?.errors?.length > 0)
+            response.console_errors = result.console.errors;
+        if (result.console?.warnings?.length > 0)
+            response.console_warnings = result.console.warnings;
+        if (result.console?.logs?.length > 0)
+            response.console_logs = result.console.logs;
+        if (result.errors?.length > 0)
+            response.errors = result.errors;
+        const failedCalls = (result.api_calls || []).filter((c) => c.status >= 400);
+        if (failedCalls.length > 0)
+            response.failed_api_calls = failedCalls;
+        response.dom = result.dom;
+        if (result.actions?.length > 0)
+            response.actions = result.actions;
+        if (result.screenshot)
+            response.screenshot = result.screenshot;
+        if (!result.success) {
+            response._hint = `Browse failed: ${result.error}. Check console_errors and errors for details.`;
+        }
+        else if (result.errors?.length > 0 || result.console?.errors?.length > 0) {
+            response._hint = "Page loaded but has errors. Check console_errors and errors arrays.";
+        }
+        else {
+            response._hint = "Page loaded successfully. Check screenshot to verify visual appearance.";
+        }
+        return response;
+    },
+    // ─────────────────────────────────────────────────────────────────────────
     // Packages
     // ─────────────────────────────────────────────────────────────────────────
     async gufi_package(params) {
@@ -2664,16 +2812,71 @@ async function handleRequest(request) {
             case "notifications/initialized":
                 // No response needed for notifications
                 break;
-            case "tools/list":
+            case "tools/list": {
+                let visibleTools = TOOLS;
+                if (workforceState && !workforceState.isAdmin) {
+                    visibleTools = TOOLS.filter(t => !ADMIN_ONLY_TOOLS.includes(t.name));
+                    // Check if user has write on ANY entity - if not, adjust gufi_data description
+                    const hasAnyWrite = Object.values(workforceState.entityPermissions).some((perms) => {
+                        for (const role of workforceState.roles) {
+                            const p = perms[role];
+                            if (p === '*' || (Array.isArray(p) && p.some((x) => x.includes('edit'))))
+                                return true;
+                        }
+                        return false;
+                    });
+                    if (!hasAnyWrite) {
+                        visibleTools = visibleTools.map(t => {
+                            if (t.name !== 'gufi_data')
+                                return t;
+                            return {
+                                ...t,
+                                description: t.description.replace(/create:.*?delete:.*?\n/gs, '') + '\n\nNote: Your role only has read access (list, get, aggregate).',
+                            };
+                        });
+                    }
+                }
                 sendResponse({
                     jsonrpc: "2.0",
                     id,
-                    result: { tools: TOOLS },
+                    result: { tools: visibleTools },
                 });
                 break;
+            }
             case "tools/call": {
                 const toolName = params?.name;
                 const toolParams = params?.arguments || {};
+                // Workforce permission check
+                if (workforceState && !workforceState.isAdmin) {
+                    if (ADMIN_ONLY_TOOLS.includes(toolName)) {
+                        sendResponse({
+                            jsonrpc: "2.0",
+                            id,
+                            result: {
+                                content: [{ type: "text", text: JSON.stringify({
+                                            error: `Permission denied: tool '${toolName}' requires Admin/Consultant role. Your roles: [${workforceState.roles.join(', ')}]`
+                                        }, null, 2) }],
+                                isError: true,
+                            },
+                        });
+                        return;
+                    }
+                    if (toolName === 'gufi_data' && ['create', 'update', 'delete'].includes(toolParams.action)) {
+                        if (!checkEntityWritePermission(toolParams.table, toolParams.action, workforceState)) {
+                            sendResponse({
+                                jsonrpc: "2.0",
+                                id,
+                                result: {
+                                    content: [{ type: "text", text: JSON.stringify({
+                                                error: `Permission denied: your role cannot '${toolParams.action}' on table '${toolParams.table}'`
+                                            }, null, 2) }],
+                                    isError: true,
+                                },
+                            });
+                            return;
+                        }
+                    }
+                }
                 const handler = toolHandlers[toolName];
                 if (!handler) {
                     sendError(id, -32601, `Unknown tool: ${toolName}`);
@@ -2745,7 +2948,7 @@ async function handleRequest(request) {
         sendError(id, -32603, err.message);
     }
 }
-export async function startMcpServer() {
+export async function startMcpServer(options) {
     // Check if logged in
     if (!isLoggedIn()) {
         const token = await autoLogin();
@@ -2754,6 +2957,27 @@ export async function startMcpServer() {
             process.exit(1);
         }
     }
+    // Workforce mode: fetch user permissions for the specified company
+    if (options?.company) {
+        try {
+            const env = getDefaultEnv();
+            const perms = await apiRequestWithEnv("/api/cli/my-permissions", {}, options.company, env);
+            workforceState = {
+                companyId: options.company,
+                roles: perms.roles || [],
+                platformRole: perms.platform_role || 'client',
+                isAdmin: hasAdminAccess(perms.roles || []),
+                entityPermissions: Object.fromEntries((perms.entity_permissions || []).map((e) => [
+                    `${e.module_name}.${e.name}`, e.permissions
+                ])),
+            };
+            console.error(`[gufi-mcp] Workforce mode: company=${options.company}, roles=[${workforceState.roles}], admin=${workforceState.isAdmin}`);
+        }
+        catch (err) {
+            console.error(`[gufi-mcp] Failed to fetch permissions: ${err.message}`);
+            process.exit(1);
+        }
+    }
     const rl = readline.createInterface({
         input: process.stdin,
         output: process.stdout,

package/docs/dev-guide/1-01-architecture.md

@@ -34,7 +34,7 @@ Gufi follows a modern microservices architecture optimized for multi-tenancy, re
         │                   │                   │
         ▼                   ▼                   ▼
 ┌───────────────┐  ┌───────────────┐  ┌───────────────┐
-│  Backend ERP  │  │  Marketplace  │  │   WebSocket   │
+│  Backend ERP  │  │    Views      │  │   WebSocket   │
 │   (Express)   │  │   Backend     │  │    Server     │
 │    :3000      │  │    :3003      │  │    :4000      │
 └───────┬───────┘  └───────┬───────┘  └───────┬───────┘
@@ -74,9 +74,9 @@ The main API server handling:
 - Zod for validation
 - pg (node-postgres) for database
 
-### Marketplace Backend (Port 3003)
+### Views Backend (Port 3003)
 
-Handles marketplace-specific operations:
+Handles view-specific operations:
 
 - Package publishing and versioning
 - View code storage and retrieval

package/docs/mcp/00-overview.md

@@ -293,7 +293,7 @@ const { rows } = await gufi.query(...); // ERROR!
 | `architecture` | Componentes del sistema |
 | `modules` | Sistema de modulos |
 | `fields` | Tipos de campos y CB builders |
-| `views` | Vistas marketplace |
+| `views` | Custom Views |
 | `automations` | Scripts y triggers |
 | `api` | API REST |
 | `packages` | Sistema de packages |

package/docs/mcp/01-architecture.md

@@ -14,8 +14,7 @@ backend/src/features/
 ├── modules/        # Estructura de datos (JSON -> DDL)
 ├── tables/         # CRUD generico de registros
 ├── automations/    # Scripts y triggers
-├── views/          # Marketplace views API
-├── marketplace/    # Developer API (packages)
+├── views/          # Custom Views API
 ├── files/          # Upload/download GCS
 ├── imports/        # Import wizard (Excel)
 ├── exports/        # Export (Excel, PDF)
@@ -31,7 +30,6 @@ backend/src/features/
 - `/api/company/modules` - CRUD modulos
 - `/api/tables/:table/*` - CRUD registros
 - `/api/automation-scripts/*` - Scripts
-- `/api/marketplace/*` - Developer API
 - `/api/cli/*` - CLI endpoints
 
 ### Frontend (React + Vite) - Puerto 5173
@@ -42,7 +40,7 @@ frontend/src/
 │   ├── hooks/        # useViewData, useFeatureData
 │   ├── components/   # FeatureContainer, KPICard
 │   ├── utils/        # formatNumber, groupBy
-│   └── marketplace/  # processSeedData, etc.
+│   └── sdk/          # processSeedData, etc.
 ├── features/
 │   ├── core_views/   # table, dashboard
 │   ├── custom_views/ # Apps custom (delivery, machines)
@@ -79,7 +77,7 @@ Archivo: `backend/src/core/services/queue/pgBossWorkerV9.js`
 **Colas:**
 - `automation` - Ejecuta automations
 - `duplicate-company` - Duplica companies
-- `marketplace-install-package` - Instala packages
+- `install-package` - Instala packages
 - `geocode-batch` - Geocoding de imports
 
 **Flujo automation:**
@@ -90,9 +88,9 @@ Archivo: `backend/src/core/services/queue/pgBossWorkerV9.js`
 4. Resultado en automation_executions
 ```
 
-### Marketplace Server
+### Views Server
 
-Archivo: `marketplace/src/features/marketplace/views.controller.js`
+Archivo: `views/src/views.controller.js`
 
 **Funcionalidades:**
 - Compilar vistas (esbuild)
@@ -119,10 +117,6 @@ core.automation_scripts
 core.automation_meta
 core.automation_executions
 
--- Marketplace
-core.marketplace_packages
-core.marketplace_views
-core.marketplace_view_files
 
 -- Config
 core.company_env_variables
@@ -223,4 +217,4 @@ Frontend <--HTTP--> Backend <--SQL--> PostgreSQL
 | WebSocket | 4000 | Realtime |
 | PostgreSQL | 5432 | Base de datos |
 | Redis | 6379 | Cache (opcional) |
-| Marketplace | 3001 | Compilacion vistas |
+| Views | 3001 | Compilacion vistas |

package/docs/mcp/02-modules.md

@@ -90,7 +90,7 @@ gufi_data({
 | `table` | Tabla normal con CRUD | GenericTable |
 | `dashboard` | Dashboard de KPIs | DashboardView |
 | `config` | Configuracion (1 registro) | FormView |
-| `marketplace_view` | Vista del marketplace | MarketplaceView |
+| `custom_view` | Custom View | CustomView |
 | `custom` | Vista custom hardcoded | Plugin especifico |
 
 ## Operaciones con MCP
@@ -158,9 +158,9 @@ gufi_schema_modify({
 })
 ```
 
-### Crear Custom View (marketplace_view)
+### Crear Custom View
 
-Las Custom Views son entidades de tipo `marketplace_view`. Se crean igual que cualquier entidad:
+Las Custom Views son entidades de tipo `custom_view`. Se crean igual que cualquier entidad:
 
 ```javascript
 gufi_schema_modify({
@@ -171,7 +171,7 @@ gufi_schema_modify({
     entity: {
       name: "dashboard_ventas",
       label: "Dashboard de Ventas",
-      kind: "marketplace_view"  // <-- Esto crea una Custom View
+      kind: "custom_view"  // <-- Esto crea una Custom View
     }
   }]
 })

package/docs/mcp/04-views.md

@@ -1,4 +1,4 @@
-# Vistas Marketplace
+# Custom Views
 
 ## TL;DR
 
@@ -15,13 +15,13 @@ mi_vista/
 
 **Workflow MCP completo:**
 ```
-# 1. Crear la vista (es una entity de tipo marketplace_view)
+# 1. Crear la vista (es una entity de tipo custom_view)
 gufi_schema_modify({
   company_id: "116",
   operations: [{
     op: "add_entity",
     module: "ventas",
-    entity: { name: "mi_dashboard", label: "Mi Dashboard", kind: "marketplace_view" }
+    entity: { name: "mi_dashboard", label: "Mi Dashboard", kind: "custom_view" }
   }]
 })
 

package/docs/mcp/06-api.md

@@ -387,57 +387,6 @@ Response:
 ]
 ```
 
-## Marketplace
-
-### Mis packages
-
-```
-GET /api/marketplace/developer/packages
-
-Response:
-[
-  { "id": 14, "name": "Mi Package", "version": "1.0.0", "published": true }
-]
-```
-
-### Detalle package
-
-```
-GET /api/marketplace/packages/{packageId}
-
-Response:
-{
-  "id": 14,
-  "name": "Mi Package",
-  "modules": [...],
-  "views": [...]
-}
-```
-
-### Archivos de vista
-
-```
-GET /api/marketplace/views/{viewId}/files
-
-Response:
-{
-  "files": [
-    { "path": "index.tsx", "content": "...", "language": "typescript" }
-  ]
-}
-```
-
-### Actualizar archivos
-
-```
-PUT /api/marketplace/views/{viewId}/files
-{
-  "files": [
-    { "path": "index.tsx", "content": "..." }
-  ]
-}
-```
-
 ## Files
 
 ### Upload

package/docs/mcp/tool-descriptions.json

@@ -1,63 +1,48 @@
 {
   "_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)."
+    "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='custom_view': { op: 'add_entity', module: 'ventas', entity: { name: 'mi_dashboard', label: 'Mi Dashboard', kind: 'custom_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 })"
+    "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: 'custom_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.51",
+  "version": "0.1.52",
   "description": "CLI for developing Gufi Marketplace views locally with Claude Code",
   "bin": {
     "gufi": "./bin/gufi.js"