g360-cli 1.15.8 → 1.16.0

package/README.md

@@ -97,7 +97,7 @@ CLI tool para el ecosistema G360 que permite inicializar proyectos con estructur
 
 ## Versión
 
-**Current: v1.15.8** — [Ver en npm](https://www.npmjs.com/package/g360-cli)
+**Current: v1.16.0** — [Ver en npm](https://www.npmjs.com/package/g360-cli)
 
 ---
 
@@ -1337,7 +1337,77 @@ g360 lint --project ./mi-proyecto
 
 ---
 
-## Integración con OpenCode
+### `g360 pptx`
+
+Genera manuales y presentaciones en PowerPoint (.pptx) desde una app G360.
+
+```bash
+g360 pptx [ruta] [opciones]
+```
+
+**Opciones:**
+
+| Opción | Descripción | Valor por defecto |
+|--------|-------------|-------------------|
+| `--mode <tipo>` | Modo de generacion (`manual`, `demo`, `onboarding`) | `manual` |
+| `--theme <nombre>` | Tema de marca (`g360`, `cipsa`) | auto-detected desde `skill.json` |
+| `--out <archivo>` | Ruta del archivo de salida | `{app-name}-manual.pptx` |
+| `--dry-run` | Solo muestra outline sin generar | `false` |
+
+**Modos:**
+
+| Modo | Proposito | Formato |
+|------|-----------|---------|
+| `manual` | Documentacion de usuario (A4 portrait) | Impresion/pdfs |
+| `demo` | Presentaciones comerciales (16:9) | Proyector/screens |
+| `onboarding` | Guia de inicio rapido | Pantalla |
+
+**Ejemplos:**
+
+```bash
+# Generar manual A4 para app CIPSA (auto-detected desde skill.json)
+g360 pptx ../mi-app --mode manual
+
+# Solo preview del outline
+g360 pptx . --dry-run
+
+# Presentacion 16:9 con tema G360
+g360 pptx . --mode demo --theme g360 --out demo.pptx
+
+# Onboarding en modo print
+g360 pptx . --mode onboarding --out onboarding.pptx
+```
+
+**Estructura generada (modo manual, A4):**
+
+| # | Slide | Contenido |
+|---|-------|-----------|
+| 1 | Portada | Nombre + descripcion + version |
+| 2 | ¿Que es? | Proposito de la app |
+| 3 | Instalacion | Pasos de inicio |
+| 4 | Dashboard | Screenshot principal (placeholder si no hay) |
+| 5-N | Features | Una por modulo UI detectado |
+| N+1 | Flujos | Modals y workflows |
+| N+2 | Arquitectura | Diagrama por capas |
+| N+3 | Buenas practicas | Checklist de uso |
+| N+4 | Resumen | Sintesis final |
+
+**Screenshots:**
+
+Colocar imagenes en `assets/screenshots/` para inclusion automatica:
+- `dashboard.png` — vista principal
+- `kpi-card.png`, `modal-export.png` — componentes relevantes
+
+Si no hay screenshots, se generan placeholders con marco punteado.
+
+**Temas disponibles:**
+
+- **`g360`**: Esmeralda #10B981, fondo claro
+- **`cipsa`**: Verde CIPSA #00d084, logo corporativo incluido
+
+---
+
+## Integracion con OpenCode
 
 g360-cli incluye integración con **OpenCode** para desarrollo asistido por IA. Esta integración permite que los agentes de IA tengan acceso a los recursos de g360-cli durante el desarrollo.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "g360-cli",
-  "version": "1.15.8",
+  "version": "1.16.0",
   "description": "CLI tool for bootstrapping G360 projects with standardized structure, assets, identity, and ERP data processing",
   "type": "module",
   "main": "src/cli.js",
@@ -54,6 +54,7 @@
     "fs-extra": "^11.3.4",
     "inquirer": "^13.4.2",
     "ora": "^9.4.0",
+    "pptxgenjs": "^4.0.1",
     "winston": "^3.19.0"
   },
   "devDependencies": {

package/src/assets/pptx/layouts/base.js

@@ -0,0 +1,239 @@
+/**
+ * Layouts reutilizables para slides G360.
+ * Cada layout recibe (slide, theme) y retorna el slide modificado.
+ */
+
+/**
+ * Cover slide — portada de la app
+ */
+export function coverSlide(slide, data, theme) {
+  const { pptx, colors } = theme;
+  slide.addText(data.appName || 'Mi App G360', [0.5, 1.5, 9, 1.2], {
+    fontSize: 44, bold: true, color: colors.text, fontFace: 'Inter',
+    align: 'center', margin: 0,
+  });
+  slide.addText(data.description || 'Aplicacion de gestion y monitoreo', [0.5, 3.0, 9, 0.8], {
+    fontSize: 20, color: colors.textLight, fontFace: 'Inter',
+    align: 'center', margin: 0,
+  });
+  if (data.version) {
+    slide.addText(`v${data.version}`, [0.5, 4.0, 9, 0.5], {
+      fontSize: 14, color: colors.accent, fontFace: 'Inter',
+      align: 'center', margin: 0,
+    });
+  }
+  if (data.brand && data.brand === 'cipsa') {
+    slide.addText('CIPSA', [0.5, 10.5, 9, 0.5], {
+      fontSize: 12, color: colors.textLight, fontFace: 'Inter',
+      align: 'center', margin: 0,
+    });
+  }
+  // Linea decorativa inferior
+  slide.addShape(pptx.ShapeType.rect, [0, 13.5, 10, 0.05], {
+    fill: { color: colors.accent }, line: { color: colors.accent },
+  });
+  return slide;
+}
+
+/**
+ * Screenshot slide — con placeholder flexible para imagen
+ * data: { title, description, screenshotPath?, screenshotIndex? }
+ */
+export function screenshotSlide(slide, data, theme) {
+  const { colors } = theme;
+  slide.addText(data.title || 'Captura de Pantalla', [0.5, 0.3, 9, 0.5], {
+    fontSize: 18, bold: true, color: colors.text, fontFace: 'Inter',
+  });
+  if (data.description) {
+    slide.addText(data.description, [0.5, 0.85, 9, 0.4], {
+      fontSize: 12, color: colors.textLight, fontFace: 'Inter',
+    });
+  }
+  // Area de imagen (80% ancho, centro)
+  const imgX = 0.5, imgY = 1.4, imgW = 9, imgH = 9.5;
+  if (data.screenshotPath) {
+    slide.addImage({ path: data.screenshotPath, x: imgX, y: imgY, w: imgW, h: imgH });
+  } else {
+    // Placeholder con borde punteado
+    slide.addShape('rect', [imgX, imgY, imgW, imgH], {
+      fill: { color: colors.surface },
+      line: { color: colors.border, width: 2, dashType: 'dash' },
+    });
+    slide.addText('📷 Insertar screenshot aquí', [imgX, imgY + 4, imgW, 1], {
+      fontSize: 16, color: colors.textLight, fontFace: 'Inter',
+      align: 'center', valign: 'middle',
+    });
+  }
+  return slide;
+}
+
+/**
+ * Feature slide — icono + titulo + descripcion
+ */
+export function featureSlide(slide, data, theme) {
+  const { colors } = theme;
+  slide.addText(data.title || 'Funcionalidad', [0.5, 0.3, 9, 0.6], {
+    fontSize: 22, bold: true, color: colors.text, fontFace: 'Inter',
+  });
+  // description como string unico (PptxGenJS no acepta array de strings plano)
+  const desc = data.description || '';
+  slide.addText(desc, [0.5, 1.0, 9, 1.5], { fontSize: 14, color: colors.text, fontFace: 'Inter' });
+  // bullets
+  if (data.bullets && Array.isArray(data.bullets) && data.bullets.length > 0) {
+    const bulletTexts = data.bullets.map(b => ({ text: b, options: { bullet: true } }));
+    slide.addText(bulletTexts, [0.5, 2.6, 9, data.bullets.length * 0.4], {
+      fontSize: 13, color: colors.text, fontFace: 'Inter',
+    });
+  }
+  return slide;
+}
+
+/**
+ * Workflow slide — pasos numerados con flechas
+ */
+export function workflowSlide(slide, data, theme) {
+  const { colors } = theme;
+  slide.addText(data.title || 'Flujo de trabajo', [0.5, 0.3, 9, 0.5], {
+    fontSize: 18, bold: true, color: colors.text, fontFace: 'Inter',
+  });
+  const steps = data.steps || [];
+  const stepHeight = 1.8;
+  const startY = 1.0;
+  steps.forEach((step, i) => {
+    const y = startY + i * stepHeight;
+    slide.addText(String(i + 1), [0.5, y, 0.5, 0.4], {
+      fontSize: 16, bold: true, color: colors.accent, fontFace: 'Inter',
+    });
+    slide.addText(step.title || '', [1.2, y, 3.5, 0.4], {
+      fontSize: 14, bold: true, color: colors.text, fontFace: 'Inter',
+    });
+    slide.addText(step.desc || '', [1.2, y + 0.4, 8, 0.6], {
+      fontSize: 12, color: colors.textLight, fontFace: 'Inter',
+    });
+    if (i < steps.length - 1) {
+      slide.addText('↓', [0.6, y + 0.85, 0.4, 0.4], {
+        fontSize: 18, color: colors.accent, fontFace: 'Inter',
+      });
+    }
+  });
+  return slide;
+}
+
+/**
+ * Architecture slide — diagrama por capas (core/ui/data)
+ */
+export function architectureSlide(slide, data, theme) {
+  const { colors } = theme;
+  slide.addText(data.title || 'Arquitectura', [0.5, 0.3, 9, 0.5], {
+    fontSize: 18, bold: true, color: colors.text, fontFace: 'Inter',
+  });
+  const layers = data.layers || [
+    { name: 'UI', desc: 'Dashboard, KPIs, Modals', color: colors.accent },
+    { name: 'Core', desc: 'Processor, Downloader, Models', color: colors.info },
+    { name: 'Data', desc: 'API S1, Catalogo, Cache', color: colors.violet },
+  ];
+  const layerH = 2.2;
+  const startY = 1.0;
+  layers.forEach((layer, i) => {
+    const y = startY + i * (layerH + 0.2);
+    slide.addShape('rect', [0.5, y, 9, layerH], {
+      fill: { color: layer.color + '20' },
+      line: { color: layer.color, width: 1.5 },
+    });
+    slide.addText(layer.name, [0.7, y + 0.3, 2.5, 0.5], {
+      fontSize: 16, bold: true, color: layer.color, fontFace: 'Inter',
+    });
+    slide.addText(layer.desc, [3.3, y + 0.35, 6, 0.4], {
+      fontSize: 13, color: colors.text, fontFace: 'Inter',
+    });
+    if (i < layers.length - 1) {
+      slide.addText('▼', [4.5, y + layerH + 0.05, 0.5, 0.2], {
+        fontSize: 10, color: colors.textLight, fontFace: 'Inter',
+      });
+    }
+  });
+  return slide;
+}
+
+/**
+ * Checklist slide — buenas practicas / resumen
+ */
+export function checklistSlide(slide, data, theme) {
+  const { colors } = theme;
+  slide.addText(data.title || 'Resumen', [0.5, 0.3, 9, 0.5], {
+    fontSize: 18, bold: true, color: colors.text, fontFace: 'Inter',
+  });
+  const items = data.items || [];
+  items.forEach((item, i) => {
+    const y = 0.9 + i * 0.55;
+    const checked = item.checked !== false;
+    slide.addText(checked ? '✓' : '○', [0.5, y, 0.4, 0.4], {
+      fontSize: 14, color: checked ? colors.success : colors.textLight, fontFace: 'Arial',
+    });
+    slide.addText(item.text || '', [1.0, y, 8.5, 0.4], {
+      fontSize: 13, color: colors.text, fontFace: 'Inter',
+    });
+  });
+  return slide;
+}
+
+/**
+ * KPI / metrics slide — para dashboards
+ */
+export function kpiSlide(slide, data, theme) {
+  const { colors } = theme;
+  slide.addText(data.title || 'Indicadores clave', [0.5, 0.3, 9, 0.5], {
+    fontSize: 18, bold: true, color: colors.text, fontFace: 'Inter',
+  });
+  const kpis = data.kpis || [];
+  const cols = Math.min(kpis.length, 4);
+  const colW = 9 / cols;
+  kpis.forEach((kpi, i) => {
+    const x = 0.5 + i * colW + colW * 0.1;
+    const w = colW * 0.8;
+    slide.addShape('rect', [x, 1.0, w, 2.5], {
+      fill: { color: (kpi.color || colors.accent) + '15' },
+      line: { color: kpi.color || colors.accent, width: 1 },
+    });
+    slide.addText(kpi.value || '—', [x, 1.1, w, 0.9], {
+      fontSize: 28, bold: true, color: kpi.color || colors.accent, fontFace: 'JetBrains Mono',
+      align: 'center',
+    });
+    slide.addText(kpi.label || '', [x, 2.0, w, 0.3], {
+      fontSize: 11, color: colors.textLight, fontFace: 'Inter', align: 'center',
+    });
+    if (kpi.sub) {
+      slide.addText(kpi.sub, [x, 2.35, w, 0.3], {
+        fontSize: 10, color: colors.textLight, fontFace: 'Inter', align: 'center',
+      });
+    }
+  });
+  return slide;
+}
+
+/**
+ * Footer con branding G360
+ */
+export function addFooter(slide, theme, slideNum, totalSlides) {
+  const { colors } = theme;
+  slide.addText('powered by G360', [7.5, 13.7, 2.2, 0.3], {
+    fontSize: 10, color: colors.textLight, fontFace: 'Inter', align: 'right',
+  });
+  slide.addText(`${slideNum} / ${totalSlides}`, [8.5, 13.9, 1, 0.25], {
+    fontSize: 9, color: colors.textLight, fontFace: 'Inter', align: 'right',
+  });
+}
+
+/**
+ * Helper: agregar seccion header comun
+ */
+export function addSectionHeader(slide, section, theme) {
+  const { colors } = theme;
+  slide.addText(section, [0.5, 0.15, 9, 0.35], {
+    fontSize: 10, bold: true, color: colors.accent, fontFace: 'Inter',
+    charSpacing: 2,
+  });
+  slide.addShape('rect', [0.5, 0.52, 9, 0.02], {
+    fill: { color: colors.accent }, line: { color: colors.accent },
+  });
+}

package/src/assets/pptx/layouts/index.js

@@ -0,0 +1,14 @@
+/**
+ * Layouts adicionales re-exportados desde base.js para compatibilidad.
+ */
+export {
+  coverSlide,
+  screenshotSlide,
+  featureSlide,
+  workflowSlide,
+  architectureSlide,
+  checklistSlide,
+  kpiSlide,
+  addFooter,
+  addSectionHeader,
+} from './base.js';

package/src/assets/pptx/scripts/analyze-app.js

@@ -0,0 +1,194 @@
+/**
+ * Analisis de app G360 — extrae features, screens y flujos de la estructura estandarizada.
+ * Aprovecha las convenciones FLET-NAMING-CONVENTIONS.md para parseo deterministico.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+
+/**
+ * Clases UI conocidas → nombre legible para el usuario.
+ */
+const UI_CLASS_MAP = {
+  'KpiCard': 'Indicadores KPI',
+  'Dashboard': 'Dashboard',
+  'WarehouseCard': 'Tarjeta de Almacen',
+  'SearchOverlay': 'Buscador Flotante',
+  'ExportModal': 'Exportar a Excel',
+  'SkuDetailModal': 'Detalle de SKU',
+  'TrasladosModal': 'Traslados entre Almacenes',
+  'SinStockModal': 'Productos Sin Stock',
+  'LineaSection': 'Seccion por Linea',
+  'AppSidebar': 'Barra Lateral',
+  'LoadingOverlay': 'Indicador de Carga',
+  'HealthBadge': 'Estado de Salud',
+};
+
+/**
+ * Patrón para detectar metodos desde src/app.py.
+ */
+const METHOD_PATTERN = /def\s+(_(?:setup|build|on|fetch|load|save|update|show|hide|toggle|validate|format)[_\w]*)/g;
+
+/**
+ * Patrón para detectar imports de clases UI.
+ */
+const IMPORT_UI_PATTERN = /from\s+src\.ui\.\w+\s+import\s+([\w,]+)/g;
+
+/**
+ * Analiza la estructura de una app G360.
+ */
+export async function analyzeApp(projectDir) {
+  const result = {
+    name: '',
+    version: '',
+    description: '',
+    brand: 'g360',
+    skill: '',
+    framework: '',
+    features: [],
+    screens: [],
+    workflows: [],
+    modules: [],
+    screenshots: [],
+    hasSource1: false,
+    hasSource2: false,
+    hasExport: false,
+    hasAutoRefresh: false,
+    hasSearch: false,
+    hasModals: [],
+    templates: [],
+  };
+
+  // 1. Leer skill.json
+  const skillPath = path.join(projectDir, 'skill.json');
+  if (await fs.pathExists(skillPath)) {
+    try {
+      const skill = await fs.readJson(skillPath);
+      result.name = skill.name || result.name;
+      result.description = skill.description || result.description;
+      result.brand = skill.brand || 'g360';
+      result.skill = skill.skill || skill.name || '';
+      result.framework = skill.framework || '';
+      result.version = skill.version || '';
+      result.events = skill.events || [];
+    } catch { /* ignorar */ }
+  }
+
+  // 2. Leer manifest
+  const manifestPath = path.join(projectDir, 'g360-manifest.json');
+  if (await fs.pathExists(manifestPath)) {
+    try {
+      const manifest = await fs.readJson(manifestPath);
+      result.name = manifest.name || result.name;
+      result.version = manifest.version || result.version;
+    } catch { /* ignorar */ }
+  }
+
+  // 3. Escanear src/ui/ para clases UI conocidas
+  const uiDir = path.join(projectDir, 'src', 'ui');
+  if (await fs.pathExists(uiDir)) {
+    const uiFiles = await fs.readdir(uiDir);
+    for (const file of uiFiles) {
+      if (file === '__pycache__' || file.endsWith('.pyc')) continue;
+      const filePath = path.join(uiDir, file);
+      if (await fs.pathExists(filePath)) {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const className = file.replace('.py', '');
+        const displayName = UI_CLASS_MAP[className] || className;
+        result.features.push({
+          name: className,
+          display: displayName,
+          file,
+          path: filePath,
+        });
+      }
+    }
+  }
+
+  // 4. Escanear modals
+  const modalsDir = path.join(projectDir, 'src', 'ui', 'modals');
+  if (await fs.pathExists(modalsDir)) {
+    const modalFiles = await fs.readdir(modalsDir);
+    for (const file of modalFiles) {
+      if (file === '__pycache__' || file.endsWith('.pyc')) continue;
+      const className = file.replace('.py', '');
+      const displayName = UI_CLASS_MAP[className] || className;
+      result.hasModals.push(className);
+      result.workflows.push({
+        name: className,
+        display: displayName,
+        steps: [`Abrir ${displayName}`, 'Interactuar con datos', 'Confirmar o cancelar'],
+      });
+    }
+  }
+
+  // 5. Detectar features desde src/app.py
+  const appPy = path.join(projectDir, 'src', 'app.py');
+  if (await fs.pathExists(appPy)) {
+    const content = await fs.readFile(appPy, 'utf-8');
+    
+    // Detectar auto-refresh
+    if (content.includes('auto_refresh') || content.includes('_auto_refresh')) {
+      result.hasAutoRefresh = true;
+    }
+    // Detectar busqueda
+    if (content.includes('search') || content.includes('SearchOverlay')) {
+      result.hasSearch = true;
+    }
+    // Detectar source1
+    if (content.includes('download_source1') || content.includes('source1')) {
+      result.hasSource1 = true;
+    }
+    // Detectar export
+    if (content.includes('export') || content.includes('excel') || content.includes('openpyxl')) {
+      result.hasExport = true;
+    }
+
+    // Extraer metodos _on_* como flujos de usuario
+    const methods = content.match(METHOD_PATTERN) || [];
+    for (const match of methods) {
+      const methodName = match.replace('def ', '').trim();
+      if (methodName.startsWith('_on_')) {
+        const displayName = methodName
+          .replace('_on_', '')
+          .replace(/_/g, ' ')
+          .replace(/\b\w/g, l => l.toUpperCase());
+        result.templates.push({
+          type: 'interaction',
+          name: methodName,
+          display: displayName,
+        });
+      }
+    }
+  }
+
+  // 6. Detectar Screenshots disponibles
+  const screenshotsDir = path.join(projectDir, 'assets', 'screenshots');
+  if (await fs.pathExists(screenshotsDir)) {
+    try {
+      const files = await fs.readdir(screenshotsDir);
+      result.screenshots = files.filter(f => /\.(png|jpg|jpeg|webp)$/i.test(f)).map(f => ({
+        filename: f,
+        path: path.join(screenshotsDir, f),
+      }));
+    } catch { /* ignorar */ }
+  }
+
+  // 7. Construir features list
+  result.features = result.features.map(f => ({
+    ...f,
+    screenshotIndex: result.screenshots.findIndex(s => s.filename.includes(f.name.toLowerCase().slice(0, 4))),
+  }));
+
+  return result;
+}
+
+/**
+ * Mapeo de clase UI → tipo de slide recomendado.
+ */
+export function classifyFeature(feature) {
+  if (feature.name.includes('Kpi') || feature.name.includes('Card')) return 'kpi';
+  if (feature.name.includes('Modal')) return 'workflow';
+  if (feature.name.includes('Dashboard')) return 'screenshot';
+  if (feature.name.includes('Search')) return 'feature';
+  return 'feature';
+}

package/src/assets/pptx/templates/app-manual.js

@@ -0,0 +1,275 @@
+/**
+ * Template Manual de App G360 — 12 slides A4.
+ * 
+ * Estructura:
+ * 1.  Portada
+ * 2.  ¿Qué es esta app?
+ * 3.  Requisitos / Instalacion
+ * 4.  Inicio — primera pantalla
+ * 5-N. Funcionalidades (una por feature detectada)
+ * N+1. Flujos de trabajo (modals)
+ * N+2. Arquitectura
+ * N+3. Buenas prácticas
+ * N+4. Resumen
+ */
+import PptxGenJS from 'pptxgenjs';
+import { createG360Theme, createCipsaTheme } from '../themes/index.js';
+import {
+  coverSlide,
+  screenshotSlide,
+  featureSlide,
+  workflowSlide,
+  architectureSlide,
+  checklistSlide,
+  kpiSlide,
+  addFooter,
+  addSectionHeader,
+} from '../layouts/base.js';
+
+/**
+ * Genera un manual PPTX completo para una app G360.
+ * 
+ * @param {object} appData — resultado de analyzeApp()
+ * @param {object} options — { mode, theme, outDir }
+ * @returns {Promise<string>} — ruta del archivo .pptx generado
+ */
+export async function generateManualPptx(appData, options = {}) {
+  const { mode = 'manual', theme: themeName = null } = options;
+  
+  // Seleccionar theme
+  const theme = themeName === 'cipsa' || (!themeName && appData.brand === 'cipsa')
+    ? createCipsaTheme()
+    : createG360Theme();
+  
+  const { pptx, colors } = theme;
+  
+  // Configurar tamaño segun modo
+  if (mode === 'demo') {
+    pptx.layout = 'LAYOUT_16x9';
+  } else {
+    pptx.layout = 'A4';
+  }
+
+  // ===== SLIDE 1: Portada =====
+  let slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  coverSlide(slide, {
+    appName: appData.name || 'Mi Aplicacion G360',
+    description: appData.description || 'Documentacion de uso y funcionalidades',
+    version: appData.version,
+    brand: appData.brand,
+  }, theme);
+  addFooter(slide, theme, 1, 12);
+
+  // ===== SLIDE 2: ¿Qué es? =====
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'INTRODUCCION', theme);
+  featureSlide(slide, {
+    title: '¿Qué es ' + (appData.name || 'esta app') + '?',
+    description: appData.description || 'Aplicacion de escritorio construida con Flet y los estandares G360.',
+    bullets: [
+      'Monitoriza datos en tiempo real desde el ERP',
+      'Genera reportes y analisis automaticos',
+      'Soporta dual theme (claro/oscuro)',
+      'Funciona offline con cache local',
+    ],
+  }, theme);
+  addFooter(slide, theme, 2, 12);
+
+  // ===== SLIDE 3: Instalacion =====
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'INSTALACION', theme);
+  const installSteps = [
+    { title: 'Ejecutar run.bat', desc: 'El launcher instala uv, Python 3.11, dependencias y crea acceso directo.' },
+    { title: 'O usar comando directo', desc: 'uv sync && uv run python main.py' },
+    { title: 'Version portable', desc: 'Descomprimir zip y ejecutar launch.vbs (sin dependencias).' },
+  ];
+  workflowSlide(slide, {
+    title: 'Como iniciar la aplicacion',
+    steps: installSteps,
+  }, theme);
+  addFooter(slide, theme, 3, 12);
+
+  // ===== SLIDES 4+: Features / Screenshots =====
+  let slideNum = 4;
+  const totalFeatures = Math.min(appData.features.length, 6); // max 6 features en manual
+  const totalSlides = 3 + totalFeatures + 3; // intro + features + workflows + arch + summary
+  
+  // Slide 4: Dashboard / inicio
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'PRIMERA VISTA', theme);
+  const dashScreen = appData.screenshots?.find(s => s.filename.toLowerCase().includes('dash'));
+  screenshotSlide(slide, {
+    title: 'Dashboard Principal',
+    description: appData.hasAutoRefresh
+      ? 'Vista principal con KPIs en tiempo real y auto-refresh cada 15 minutos.'
+      : 'Vista principal de la aplicacion con los indicadores clave del negocio.',
+    screenshotPath: dashScreen?.path,
+  }, theme);
+  addFooter(slide, theme, slideNum, totalSlides);
+  slideNum++;
+
+  // Features individual slides
+  for (const feature of appData.features.slice(0, totalFeatures)) {
+    slide = pptx.addSlide();
+    slide.background = { color: colors.bg };
+    addSectionHeader(slide, 'FUNCIONALIDAD', theme);
+    
+    const shot = appData.screenshots?.find(s =>
+      feature.name.toLowerCase().includes(s.filename.toLowerCase().slice(0, 6))
+    );
+    
+    const classification = classifyFeatureForSlide(feature);
+    
+    if (classification === 'kpi' && feature.name.includes('Kpi')) {
+      kpiSlide(slide, {
+        title: feature.display || feature.name,
+        kpis: generateKpiPlaceholders(feature),
+      }, theme);
+    } else if (classification === 'workflow') {
+      workflowSlide(slide, {
+        title: feature.display || feature.name,
+        steps: [`Acceder desde el menu principal`, 'Seleccionar opciones disponibles', 'Confirmar y generar resultado'],
+      }, theme);
+    } else {
+      featureSlide(slide, {
+        title: feature.display || feature.name,
+        description: `Module ubicado en src/ui/${feature.file}`,
+        bullets: [
+          'Clase exportada desde src/ui/',
+          'Integracion con Dashboard principal',
+          'Soporta dual theme automaticamente',
+        ],
+      }, theme);
+    }
+    
+    if (!shot) {
+      // Agregar placeholder si no hay screenshot
+      slide.addShape('rect', [1, 3.5, 8, 6], {
+        fill: { color: colors.surface },
+        line: { color: colors.border, width: 1, dashType: 'dash' },
+      });
+      slide.addText('📷 Screenshot: ' + (feature.display || feature.name), [1, 6, 8, 0.5], {
+        fontSize: 12, color: colors.textLight, fontFace: 'Inter', align: 'center',
+      });
+    } else {
+      screenshotSlide(slide, {
+        title: feature.display || feature.name,
+        description: `Módulo: src/ui/${feature.file}`,
+        screenshotPath: shot.path,
+      }, theme);
+      slide.clearShapes?.(); // remove placeholder
+    }
+    
+    addFooter(slide, theme, slideNum, totalSlides);
+    slideNum++;
+  }
+
+  // ===== Workflows (modals) =====
+  if (appData.hasModals.length > 0) {
+    slide = pptx.addSlide();
+    slide.background = { color: colors.bg };
+    addSectionHeader(slide, 'FLUJOS DE TRABAJO', theme);
+    
+    const steps = appData.hasModals.slice(0, 4).map((modal, i) => ({
+      title: `Modal: ${modal}`,
+      desc: 'Paso 1 → Paso 2 → Paso 3',
+    }));
+    
+    workflowSlide(slide, {
+      title: 'Modales y flujos de usuario',
+      steps,
+    }, theme);
+    addFooter(slide, theme, slideNum, totalSlides);
+    slideNum++;
+  }
+
+  // ===== Architecture =====
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'ARQUITECTURA', theme);
+  architectureSlide(slide, {
+    title: 'Estructura de capas',
+    layers: [
+      { name: 'UI', desc: 'Dashboard, Cards, Modals, Overlays', color: colors.accent },
+      { name: 'Core', desc: 'Processor, Downloader, Models', color: colors.info },
+      { name: 'Config', desc: 'Theme, Constants, Skill', color: colors.violet },
+      { name: 'Data', desc: 'API S1, Catalogo JSON, Cache', color: colors.success },
+    ],
+  }, theme);
+  addFooter(slide, theme, slideNum, totalSlides);
+  slideNum++;
+
+  // ===== Checklist / Buenas prácticas =====
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'BUENAS PRÁCTICAS', theme);
+  checklistSlide(slide, {
+    title: 'Recomendaciones de uso',
+    items: [
+      { text: 'Mantener nombres de clases siguiendo PascalCase (KpiCard, Dashboard)', checked: true },
+      { text: 'Usar theme.py para colores, nunca hardcodear #HEX', checked: true },
+      { text: 'Registrar eventos con publish_g360_event() para comunicacion entre apps', checked: true },
+      { text: 'Implementar shutdown() para limpieza de threads al cerrar', checked: true },
+      { text: 'Documentar funciones con docstrings en español', checked: true },
+      { text: 'Usar G360 Signature widget en el footer de la app', checked: true },
+    ],
+  }, theme);
+  addFooter(slide, theme, slideNum, totalSlides);
+  slideNum++;
+
+  // ===== Summary =====
+  slide = pptx.addSlide();
+  slide.background = { color: colors.bg };
+  addSectionHeader(slide, 'RESUMEN', theme);
+  
+  const summaryItems = [
+    `Nombre: ${appData.name || 'N/A'}`,
+    `Version: ${appData.version || '1.0.0'}`,
+    `Framework: ${appData.framework || 'Flet'}`,
+    `Skills: ${appData.skill || 'N/A'}`,
+    `Caracteristicas: ${appData.features.length} modulos UI`,
+    appData.hasAutoRefresh ? 'Auto-refresh activado' : '',
+    appData.hasSearch ? 'Buscador flotante implementado' : '',
+    appData.hasExport ? 'Exportacion a Excel disponible' : '',
+    appData.hasModals.length > 0 ? `${appData.hasModals.length} modales de trabajo` : '',
+  ].filter(Boolean);
+  
+  checklistSlide(slide, {
+    title: 'Resumen de la aplicacion',
+    items: summaryItems.map(t => ({ text: t, checked: true })),
+  }, theme);
+  addFooter(slide, theme, slideNum, totalSlides);
+
+  // Save
+  const outPath = options.outPath || path.join(process.cwd(), `${(appData.name || 'app').toLowerCase().replace(/\s+/g, '-')}-manual.pptx`);
+  await pptx.writeFile({ fileName: outPath });
+  return outPath;
+}
+
+/**
+ * Classifica feature para decidir que slide usar.
+ */
+function classifyFeatureForSlide(feature) {
+  if (feature.name.includes('Kpi')) return 'kpi';
+  if (feature.name.includes('Modal') || feature.name.includes('Dialog')) return 'workflow';
+  if (feature.name.includes('Dashboard')) return 'screenshot';
+  return 'feature';
+}
+
+/**
+ * Genera placeholders de KPIs basado en features detectadas.
+ */
+function generateKpiPlaceholders(feature) {
+  return [
+    { label: 'Total', value: '—', color: '#64748B' },
+    { label: 'Con Stock', value: '—', color: '#34D399' },
+    { label: 'Sin Stock', value: '—', color: '#EF4444' },
+    { label: 'Alertas', value: '—', color: '#F59E0B' },
+  ];
+}
+
+import path from 'path';

package/src/assets/pptx/themes/base.js

@@ -0,0 +1,63 @@
+/**
+ * Tema G360 — paleta esmeralda, fuente Inter, fondo oscuro/claro.
+ * Usa los colores definidos en skill.json del proyecto (fallback a valores G360).
+ */
+import PptxGenJS from 'pptxgenjs';
+
+export function createG360Theme() {
+  const colors = {
+    accent: '#10B981',
+    accentDark: '#047857',
+    success: '#34D399',
+    warning: '#F59E0B',
+    error: '#EF4444',
+    text: '#0F172A',
+    textLight: '#64748B',
+    bg: '#FFFFFF',
+    surface: '#F3F5F9',
+    border: '#E3E8F0',
+    darkBg: '#0A0F1E',
+    darkText: '#F1F5FB',
+    darkSurface: '#141D33',
+  };
+
+  // Definir layout A4 vertical para manual (portrait)
+  const pptx = new PptxGenJS();
+  pptx.defineLayout({ name: 'A4', width: 10, height: 14.28 }); // A4 portrait en pulgadas
+  pptx.defineLayout({ name: 'LAYOUT_16x9', width: 10, height: 5.625 });
+  pptx.defineLayout({ name: 'LAYOUT_4x3', width: 10, height: 7.5 });
+
+  // Usar A4 como default (manual mode)
+  pptx.layout = 'A4';
+
+  // Theme global
+  pptx.author = 'g360-cli';
+  pptx.title = '';
+  pptx.subject = 'Documentacion generada por g360-cli';
+
+  return {
+    pptx,
+    colors,
+    layout: 'A4',
+    fonts: ['Inter', 'Arial'],
+    /**
+     * Agregar logo de marca a la presentacion
+     */
+    setLogo(pptxObj, brand, width = 1.2, height = 0.6) {
+      const logoPath = brand === 'cipsa'
+        ? path.join(__dirname, '..', 'brand', 'cipsa', 'logotypes', 'Logo_cipsa_solid.svg')
+        : path.join(__dirname, '..', 'brand', 'g360', 'logotypes', 'logo-g360-light.svg');
+      // Nota: SVG no soportado nativamente por PptxGenJS; fallback a PNG
+      const pngPath = brand === 'cipsa'
+        ? path.join(__dirname, '..', 'brand', 'cipsa', 'logotypes', 'Logo_cipsa_solid.png')
+        : path.join(__dirname, '..', 'brand', 'g360', 'logotypes', 'logo-g360-dark.png');
+      if (require('fs').existsSync(pngPath)) {
+        return { path: pngPath, width, height };
+      }
+      return null;
+    },
+  };
+}
+
+import path from 'path';
+import fs from 'fs';

package/src/assets/pptx/themes/cipsa.js

@@ -0,0 +1,46 @@
+/**
+ * Tema CIPSA — verde corporativo con logo CIPSA.
+ */
+import PptxGenJS from 'pptxgenjs';
+import path from 'path';
+import fs from 'fs';
+
+export function createCipsaTheme() {
+  const colors = {
+    accent: '#00d084',
+    accentDark: '#00796B',
+    success: '#22c55e',
+    warning: '#f59e0b',
+    error: '#ef4444',
+    text: '#0F172A',
+    textLight: '#64748B',
+    bg: '#FFFFFF',
+    surface: '#F0F9F4',
+    border: '#CCF0E0',
+    darkBg: '#0d1117',
+    darkText: '#f0f6fc',
+    darkSurface: '#161b22',
+  };
+
+  const pptx = new PptxGenJS();
+  pptx.defineLayout({ name: 'A4', width: 10, height: 14.28 });
+  pptx.defineLayout({ name: 'LAYOUT_16x9', width: 10, height: 5.625 });
+  pptx.layout = 'A4';
+
+  pptx.author = 'g360-cli';
+  pptx.title = '';
+  pptx.subject = 'Documentacion CIPSA generada por g360-cli';
+
+  const cipsaLogo = path.join(process.cwd(), 'assets', 'images', 'Logo_cipsa_solid.png');
+  const fallbackLogo = fs.existsSync(cipsaLogo)
+    ? cipsaLogo
+    : path.join(__dirname, '..', '..', 'brand', 'cipsa', 'logotypes', 'Logo_cipsa_solid.png');
+
+  return {
+    pptx,
+    colors,
+    layout: 'A4',
+    fonts: ['Inter', 'Arial'],
+    logo: fs.existsSync(fallbackLogo) ? { path: fallbackLogo, width: 1.5, height: 0.5 } : null,
+  };
+}

package/src/assets/pptx/themes/g360.js

@@ -0,0 +1,32 @@
+/**
+ * Tema G360 — paleta esmeralda, fuente Inter.
+ */
+import PptxGenJS from 'pptxgenjs';
+
+const colors = {
+  accent: '#10B981',
+  accentDark: '#047857',
+  success: '#34D399',
+  warning: '#F59E0B',
+  error: '#EF4444',
+  info: '#3B82F6',
+  violet: '#8B5CF6',
+  text: '#0F172A',
+  textLight: '#64748B',
+  bg: '#FFFFFF',
+  surface: '#F3F5F9',
+  border: '#E3E8F0',
+};
+
+export function createG360Theme() {
+  const pptx = new PptxGenJS();
+  pptx.defineLayout({ name: 'A4', width: 10, height: 14.28 });
+  pptx.defineLayout({ name: 'LAYOUT_16x9', width: 10, height: 5.625 });
+  pptx.layout = 'A4';
+  pptx.author = 'g360-cli';
+  pptx.subject = 'Documentacion generada por g360-cli';
+
+  return { pptx, colors, layout: 'A4' };
+}
+
+export { colors };

package/src/assets/pptx/themes/index.js

@@ -0,0 +1,2 @@
+export { createG360Theme } from './g360.js';
+export { createCipsaTheme } from './cipsa.js';

package/src/cli.js

@@ -22,6 +22,7 @@ import { ingest } from './commands/ingest.js';
 import { addon } from './commands/addon.js';
 import { docs } from './commands/docs.js';
 import { lint } from './commands/lint.js';
+import { pptx } from './commands/pptx.js';
 
 // Comando config (no requiere archivo separado)
 function configAction(options) {
@@ -212,4 +213,14 @@ program
   .option('--project <path>', 'Project path', '.')
   .action(lint);
 
+program
+  .command('pptx')
+  .argument('[path]', 'Project path to generate presentation from', '.')
+  .option('-m, --mode <type>', 'Mode: manual, demo, onboarding', 'manual')
+  .option('-t, --theme <name>', 'Brand theme: g360, cipsa (auto-detected from skill.json)', null)
+  .option('-o, --out <file>', 'Output file path (default: {app-name}-manual.pptx)', null)
+  .option('--dry-run', 'Preview outline without generating')
+  .option('--screenshots <dir>', 'Custom screenshots directory', 'assets/screenshots')
+  .action(pptx);
+
 program.parse();

package/src/commands/pptx.js

@@ -0,0 +1,89 @@
+/**
+ * Comando: g360 pptx [path] [opciones]
+ * Genera presentacion/manual PPTX para una app G360.
+ */
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import ora from 'ora';
+
+import { analyzeApp } from '../assets/pptx/scripts/analyze-app.js';
+import { generateManualPptx } from '../assets/pptx/templates/app-manual.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export async function pptx(targetPath, options) {
+  const {
+    mode = 'manual',
+    theme: themeName = null,
+    out,
+    dryRun = false,
+    screenshots,
+  } = options;
+
+  const targetDir = path.join(process.cwd(), targetPath || '.');
+
+  if (!await fs.pathExists(targetDir)) {
+    console.error(chalk.red(`❌ Directorio no encontrado: ${targetDir}`));
+    return;
+  }
+
+  // Detectar branding desde skill.json
+  const skillPath = path.join(targetDir, 'skill.json');
+  let detectedBrand = 'g360';
+  if (await fs.pathExists(skillPath)) {
+    try {
+      const skill = await fs.readJson(skillPath);
+      detectedBrand = skill.brand || 'g360';
+      if (detectedBrand === 'cipsa' && !themeName) themeName = 'cipsa';
+    } catch {}
+  }
+
+  console.log(chalk.bold.cyan('\n📊 G360 App → PPTX Generator\n'));
+  console.log(chalk.gray(`  Proyecto: ${targetDir}`));
+  console.log(chalk.gray(`  Modo: ${mode}`));
+  console.log(chalk.gray(`  Theme: ${themeName || detectedBrand}`));
+  if (out) console.log(chalk.gray(`  Salida: ${out}`));
+  console.log('');
+
+  if (dryRun) {
+    console.log(chalk.yellow('📋 DRY RUN — Outline generado:\n'));
+    console.log(chalk.gray('  [1] Portada'));
+    console.log(chalk.gray('  [2] Introducción'));
+    console.log(chalk.gray('  [3] Instalación'));
+    console.log(chalk.gray('  [4] Dashboard / Inicio'));
+    console.log(chalk.gray('  [5-N] Funcionalidades (una por módulo UI detectado)'));
+    console.log(chalk.gray('  [N+1] Flujos de trabajo (modales)'));
+    console.log(chalk.gray('  [N+2] Arquitectura'));
+    console.log(chalk.gray('  [N+3] Buenas prácticas'));
+    console.log(chalk.gray('  [N+4] Resumen'));
+    console.log(chalk.gray(`\nTotal estimado: ~${12 + Math.min(6, 20)} slides A4`));
+    return;
+  }
+
+  const spinner = ora('Analizando aplicación...').start();
+  try {
+    const appData = await analyzeApp(targetDir);
+    spinner.text = `Generando ${mode} (${appData.features.length} módulos detectados)...`;
+
+    const pptxPath = await generateManualPptx(appData, {
+      mode,
+      theme: themeName || detectedBrand,
+      outPath: out,
+    });
+
+    spinner.succeed(chalk.green(`✅ PPTX generado: ${pptxPath}`));
+    console.log(chalk.gray(`   Tamaño: ${Math.round((await fs.stat(pptxPath)).size / 1024)} KB`));
+    console.log(chalk.gray(`   Slides: ~12 A4 (modo manual)`));
+    console.log('');
+    console.log(chalk.cyan('  Siguiente paso:'));
+    console.log(chalk.gray('    Revisar el archivo y reemplazar placeholders de screenshots'));
+    console.log(chalk.gray(`    con imágenes reales de la app en ${path.join(targetDir, 'assets', 'screenshots')}/`));
+    console.log('');
+  } catch (err) {
+    spinner.fail(chalk.red(`❌ Error: ${err.message}`));
+    console.error(err.stack);
+    process.exit(1);
+  }
+}