g360-cli 1.15.8 → 1.17.0

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

@@ -0,0 +1,397 @@
+/**
+ * Template Manual de App G360 — formato 16:9 widescreen, estilo ventas-pulse.
+ *
+ * Estructura:
+ * 1.   Portada
+ * 2.   ¿Qué es? (descripcion + tarjetas usuario/tecnico)
+ * 3.   Módulos (tabla de modulos + capturas)
+ * 4.   Flujo de trabajo (pasos numerados + capturas)
+ * 5-N. Funcionalidades (una por modulo UI detectado)
+ * N+1. Flujos de trabajo (modales)
+ * N+2. Arquitectura
+ * N+3. Buenas prácticas
+ * N+4. Límites conocidos (si el proyecto define appData.limits)
+ * N+5. Resumen
+ */
+import path from 'path';
+import { createTheme } from '../themes/index.js';
+import {
+  coverSlide,
+  addSectionHeader,
+  addFooter,
+  card,
+  phoneShot,
+  featureSlide,
+  workflowSlide,
+  limitsSlide,
+  checklistSlide,
+  kpiSlide,
+  architectureSlide,
+  modulesTable,
+} from '../layouts/base.js';
+
+const MAX_FEATURES = 6;
+
+/** Descripciones genericas por clase UI conocida */
+const FEATURE_DESC = {
+  KpiCard: 'Indicadores clave del negocio en tiempo real, con estados de alerta y recuento por categoría.',
+  Dashboard: 'Vista principal con el resumen operativo: KPIs, listados y accesos a los módulos de trabajo.',
+  WarehouseCard: 'Tarjeta de almacén con existencias y estado por depósito.',
+  SearchOverlay: 'Buscador flotante global: localiza registros de cualquier módulo sin salir de la vista.',
+  ExportModal: 'Exportación a Excel con formato corporativo para seguimiento y auditoría.',
+  SkuDetailModal: 'Detalle de SKU: existencias, movimientos y atributos relevantes.',
+  TrasladosModal: 'Traslados entre almacenes con validación de stock disponible.',
+  SinStockModal: 'Productos sin stock: prioriza reposición y alternativas.',
+  AppSidebar: 'Barra lateral de navegación entre módulos.',
+};
+
+function featureDesc(feature) {
+  return feature.desc
+    || FEATURE_DESC[feature.name]
+    || `Módulo de interfaz ubicado en src/ui/${feature.file}, integrado al flujo principal de la aplicación.`;
+}
+
+function classify(feature) {
+  if (feature.name.includes('Kpi') || feature.name.includes('Card')) return 'kpi';
+  if (feature.name.includes('Modal') || feature.name.includes('Dialog')) return 'workflow';
+  if (feature.name.includes('Dashboard')) return 'screenshot';
+  return 'feature';
+}
+
+/**
+ * Genera un manual PPTX completo para una app G360 (16:9).
+ *
+ * @param {object} appData — resultado de analyzeApp()
+ * @param {object} options — { mode, theme, outPath }
+ * @returns {Promise<string>} — ruta del archivo .pptx generado
+ */
+export async function generateManualPptx(appData, options = {}) {
+  const { mode = 'manual' } = options;
+  const themeName = options.theme || appData.brand || 'g360';
+  const theme = createTheme(themeName === 'cipsa' ? 'cipsa' : themeName);
+  const { pptx, colors } = theme;
+  const S = theme.spacing;
+
+  const appName = appData.name || 'Mi Aplicación G360';
+  const features = appData.features.slice(0, MAX_FEATURES);
+  const hasModals = (appData.hasModals?.length || 0) > 0;
+  const hasLimits = Array.isArray(appData.limits) && appData.limits.length > 0;
+
+  const totalSlides = 4
+    + features.length
+    + (hasModals ? 1 : 0)
+    + 3
+    + (hasLimits ? 1 : 0);
+
+  let slideNum = 0;
+  const bg = { color: colors.bg };
+  const newSlide = () => {
+    const s = pptx.addSlide();
+    s.background = bg;
+    return s;
+  };
+
+  const screenshotFor = (feature) => {
+    if (feature.screenshotIndex >= 0 && appData.screenshots?.[feature.screenshotIndex]) {
+      return appData.screenshots[feature.screenshotIndex].path;
+    }
+    const shot = appData.screenshots?.find((s) =>
+      s.filename.toLowerCase().includes(feature.name.toLowerCase().slice(0, 4)),
+    );
+    return shot?.path || null;
+  };
+
+  // ===== 1. Portada =====
+  let slide = newSlide();
+  coverSlide(slide, {
+    appName,
+    description: appData.description || 'Documentación de uso y funcionalidades',
+    tagline: buildTagline(appData),
+    version: appData.version,
+    brand: themeName,
+  }, theme);
+  addFooter(slide, theme, ++slideNum, totalSlides);
+
+  // ===== 2. ¿Qué es? =====
+  slide = newSlide();
+  addSectionHeader(slide, 'INTRODUCCIÓN', theme, ++slideNum, totalSlides);
+  slide.addText(`¿Qué es ${appName}?`, {
+    x: S.marginX, y: 1.05, w: S.contentWidth, h: 0.45,
+    fontSize: 15, bold: true, color: colors.text, fontFace: theme.font,
+  });
+  slide.addText(appData.description || 'Aplicación construida con los estándares G360.', {
+    x: S.marginX, y: 1.5, w: S.contentWidth, h: 0.85,
+    fontSize: theme.typo.sizes.body, color: colors.text,
+    valign: 'top', fontFace: theme.font,
+  });
+  card(slide, {
+    x: S.marginX, y: 2.55, w: (S.contentWidth - S.cardGap) / 2, h: 2.0,
+    title: 'Para el usuario',
+    body: features.length > 0
+      ? features.slice(0, 4).map((f) => f.display || f.name)
+      : ['Acceso a los módulos principales de la app'],
+  }, theme);
+  card(slide, {
+    x: S.marginX + (S.contentWidth - S.cardGap) / 2 + S.cardGap, y: 2.55,
+    w: (S.contentWidth - S.cardGap) / 2, h: 2.0,
+    title: 'Bajo el capó',
+    body: buildTechBullets(appData, features),
+  }, theme);
+  slide.addText(buildCapabilityLine(appData), {
+    x: S.marginX, y: 4.85, w: S.contentWidth, h: 1.6,
+    fontSize: theme.typo.sizes.body, color: colors.textMuted, valign: 'top', fontFace: theme.font,
+  });
+
+  // ===== 3. Módulos =====
+  slide = newSlide();
+  addSectionHeader(slide, 'MÓDULOS', theme, ++slideNum, totalSlides);
+  modulesTable(slide, {
+    rows: features.map((f) => ({
+      name: f.display || f.name,
+      route: f.file,
+      desc: featureDesc(f),
+    })),
+  }, theme);
+  const shots = features.map(screenshotFor).filter(Boolean);
+  if (shots[0]) {
+    phoneShot(slide, {
+      x: S.page.width - S.marginX - 3.95, y: S.contentTopY,
+      w: 1.85, h: 4.0, imagePath: shots[0],
+      label: `Captura de ${features[0].display || features[0].name}`,
+    }, theme);
+  }
+  if (shots[1]) {
+    phoneShot(slide, {
+      x: S.page.width - S.marginX - 1.9, y: S.contentTopY,
+      w: 1.85, h: 4.0, imagePath: shots[1],
+      label: `Captura de ${features[1]?.display || 'módulo'}`,
+    }, theme);
+  }
+  slide.addText('Cada módulo se detalla en las siguientes páginas.', {
+    x: S.marginX, y: S.contentTopY + features.length * 1.12 + 0.1, w: S.contentWidth - 4.35, h: 0.5,
+    fontSize: theme.typo.sizes.caption, color: colors.textMuted, fontFace: theme.font,
+  });
+
+  // ===== 4. Flujo de trabajo =====
+  slide = newSlide();
+  addSectionHeader(slide, 'FLUJO DE TRABAJO', theme, ++slideNum, totalSlides);
+  workflowSlide(slide, {
+    textWidth: S.contentWidth - 0.65 - 4.9,
+    steps: buildWorkflowSteps(appData),
+  }, theme);
+  if (shots[2]) {
+    phoneShot(slide, {
+      x: S.page.width - S.marginX - 4.75, y: S.contentTopY + 0.15,
+      w: 2.25, h: 4.9, imagePath: shots[2],
+      label: 'Pantalla de inicio / login',
+    }, theme);
+  }
+  if (shots[3]) {
+    phoneShot(slide, {
+      x: S.page.width - S.marginX - 2.3, y: S.contentTopY + 0.15,
+      w: 2.25, h: 4.9, imagePath: shots[3],
+      label: 'Vista principal en uso',
+    }, theme);
+  }
+
+  // ===== 5-N. Features =====
+  for (const feature of features) {
+    slide = newSlide();
+    addSectionHeader(slide, 'FUNCIONALIDAD', theme, ++slideNum, totalSlides);
+    const kind = classify(feature);
+    const shotPath = screenshotFor(feature);
+    const textW = shotPath ? S.contentWidth - 5.1 : S.contentWidth;
+
+    if (kind === 'kpi') {
+      kpiSlide(slide, {
+        title: feature.display || feature.name,
+        kpis: [
+          { label: 'Registros', value: '—', color: colors.accent },
+          { label: 'Activos', value: '—', color: colors.success },
+          { label: 'Alertas', value: '—', color: colors.warning },
+          { label: 'Críticos', value: '—', color: colors.danger },
+        ],
+      }, theme);
+    } else {
+      featureSlide(slide, {
+        title: feature.display || feature.name,
+        description: featureDesc(feature),
+        bullets: kind === 'workflow'
+          ? ['Se abre desde el módulo principal', 'Interacción guiada paso a paso', 'Confirmación con resumen del resultado']
+          : feature.kind === 'route'
+            ? [
+                `Ruta accesible desde la navegación principal (${feature.file})`,
+                'Estado sincronizado con los datos del negocio',
+                'Diseño responsive y táctil',
+              ]
+            : feature.kind === 'component'
+              ? [
+                  `Componente web en ${feature.file}`,
+                  'Integrado al flujo principal de la app',
+                  'Reutilizable y con estados de carga/error',
+                ]
+              : [
+                  `Clase ${feature.name} exportada desde src/ui/${feature.file}`,
+                  'Integrada al Dashboard principal',
+                  'Respeta el tema claro/oscuro del sistema',
+                ],
+      }, theme);
+      // limitar ancho del texto si hay captura
+      if (shotPath) {
+        slide.addText(`${feature.display || feature.name}`, {
+          x: S.marginX, y: 1.05, w: textW, h: 0.6,
+          fontSize: 15, bold: true, color: colors.text, fontFace: theme.font,
+        });
+      }
+    }
+
+    if (shotPath) {
+      phoneShot(slide, {
+        x: S.page.width - S.marginX - 2.6, y: 1.25,
+        w: 2.55, h: 4.9, imagePath: shotPath,
+        label: `Captura de ${feature.display || feature.name}`,
+      }, theme);
+    } else {
+      phoneShot(slide, {
+        x: S.page.width - S.marginX - 2.6, y: 1.25,
+        w: 2.55, h: 4.9, imagePath: null,
+        label: `Captura de ${feature.display || feature.name} en uso`,
+      }, theme);
+    }
+    addFooter(slide, theme, slideNum, totalSlides);
+  }
+
+  // ===== N+1. Flujos (modales) =====
+  if (hasModals) {
+    slide = newSlide();
+    addSectionHeader(slide, 'FLUJOS DE TRABAJO', theme, ++slideNum, totalSlides);
+    workflowSlide(slide, {
+      textWidth: S.contentWidth - 0.65,
+      steps: appData.hasModals.slice(0, 6).map((m) => ({
+        title: m.replace(/([a-z])([A-Z])/g, '$1 $2'),
+        desc: 'Flujo de usuario con confirmación y resultado trazable.',
+      })),
+    }, theme);
+    addFooter(slide, theme, slideNum, totalSlides);
+  }
+
+  // ===== N+2. Arquitectura =====
+  slide = newSlide();
+  addSectionHeader(slide, 'ARQUITECTURA', theme, ++slideNum, totalSlides);
+  architectureSlide(slide, {
+    layers: [
+      { name: 'UI', desc: 'Dashboard, Cards, Modals, Overlays (src/ui/)', color: colors.accent },
+      { name: 'Core', desc: 'Lógica de negocio y procesamiento (src/core/)', color: colors.info },
+      { name: 'Config', desc: 'Tema, constantes y metadata (skill.json)', color: colors.violet },
+      { name: 'Datos', desc: 'API ERP, catálogo y cache local', color: colors.success },
+    ],
+  }, theme);
+  addFooter(slide, theme, slideNum, totalSlides);
+
+  // ===== N+3. Buenas prácticas =====
+  slide = newSlide();
+  addSectionHeader(slide, 'BUENAS PRÁCTICAS', theme, ++slideNum, totalSlides);
+  checklistSlide(slide, {
+    items: [
+      'Mantener la sesión activa solo mientras se usa la app',
+      'Actualizar datos antes de decidir (auto-refresh o botón de recarga)',
+      'Usar la exportación a Excel para seguimiento y auditoría',
+      'Reportar anomalías al administrador con el registro específico',
+      'Compartir el dispositivo solo con sesión cerrada',
+      'Verificar conectividad si los datos aparecen desactualizados',
+    ],
+  }, theme);
+  addFooter(slide, theme, slideNum, totalSlides);
+
+  // ===== N+4. Límites (opcional, definidos por el proyecto) =====
+  if (hasLimits) {
+    slide = newSlide();
+    addSectionHeader(slide, 'LÍMITES CONOCIDOS', theme, ++slideNum, totalSlides);
+    limitsSlide(slide, { items: appData.limits }, theme);
+    addFooter(slide, theme, slideNum, totalSlides);
+  }
+
+  // ===== Resumen =====
+  slide = newSlide();
+  addSectionHeader(slide, 'RESUMEN', theme, ++slideNum, totalSlides);
+  checklistSlide(slide, {
+    startY: 1.5,
+    items: [
+      `Nombre: ${appName}`,
+      `Versión: ${appData.version || '1.0.0'}`,
+      `Framework: ${appData.framework || 'N/A'}`,
+      `Módulos UI: ${appData.features.length}`,
+      appData.hasAutoRefresh ? 'Auto-refresh de datos activado' : 'Actualización manual de datos',
+      appData.hasSearch ? 'Buscador global disponible' : null,
+      appData.hasExport ? 'Exportación a Excel disponible' : null,
+      hasModals ? `${appData.hasModals.length} flujos con modales de trabajo` : null,
+    ].filter(Boolean).map((t) => ({ text: t, checked: true })),
+  }, theme);
+  slide.addText('Documentación completa: README.md · powered by G360', {
+    x: S.marginX, y: 6.6, w: S.contentWidth, h: 0.4,
+    fontSize: theme.typo.sizes.bodySmall, color: colors.textMuted,
+    align: 'center', fontFace: theme.font,
+  });
+
+  // Save — por defecto dentro del repo de la app (cada PPTX es propio de su repo)
+  const slug = appName.toLowerCase().replace(/\s+/g, '-');
+  const defaultDir = options.targetDir || process.cwd();
+  const outPath = options.outPath
+    || path.join(defaultDir, mode === 'demo' ? `${slug}-demo.pptx` : `${slug}-manual.pptx`);
+  await pptx.writeFile({ fileName: outPath });
+  return outPath;
+}
+
+function buildTagline(appData) {
+  const bits = [];
+  if (appData.framework) bits.push(appData.framework);
+  if (appData.features.length) bits.push(`${appData.features.length} módulos UI`);
+  if (appData.hasModals?.length) bits.push(`${appData.hasModals.length} flujos de trabajo`);
+  if (appData.type === 'web' && appData.hasPwa) bits.push('PWA instalable');
+  return bits.join('  ·  ');
+}
+
+function buildTechBullets(appData, features) {
+  const bullets = [];
+  if (appData.framework) bullets.push(`Framework: ${appData.framework}`);
+  bullets.push(`${appData.features.length} módulos UI detectados`);
+  if (appData.hasModals?.length) bullets.push(`${appData.hasModals.length} modales de trabajo en src/ui/modals/`);
+  if (appData.hasExport) bullets.push('Exportación a Excel integrada');
+  if (appData.hasAutoRefresh) bullets.push('Auto-refresh de datos (~15 min)');
+  if (appData.hasSupabase) bullets.push('Datos en tiempo real vía Supabase');
+  if (appData.hasPwa) bullets.push('PWA instalable con cache offline');
+  if (appData.hasCharts) bullets.push('Visualización de datos con gráficos');
+  if (appData.hasSearch) bullets.push('Búsqueda global con overlay flotante');
+  bullets.push('Metadata y eventos declarados en skill.json');
+  return bullets.slice(0, 6);
+}
+
+function buildCapabilityLine(appData) {
+  const caps = [];
+  if (appData.hasAutoRefresh) caps.push('datos en tiempo real');
+  if (appData.hasSearch) caps.push('búsqueda global');
+  if (appData.hasExport) caps.push('export a Excel');
+  if (appData.hasSource1 || appData.hasSupabase) caps.push('conexión a ERP/Supabase');
+  if (appData.hasPwa) caps.push('modo offline (PWA)');
+  if (appData.hasCharts) caps.push('gráficos interactivos');
+  return caps.length > 0
+    ? `Capacidades destacadas: ${caps.join(' · ')}.`
+    : 'Revisa los módulos en las siguientes páginas para conocer las capacidades de la app.';
+}
+
+function buildWorkflowSteps(appData) {
+  if (appData.templates?.length >= 4) {
+    return appData.templates.slice(0, 6).map((t, i) => ({
+      title: `${i + 1} · ${t.display}`,
+      desc: `Interacción "${t.name.replace(/^_on_/, '').replace(/_/g, ' ')}" registrada en src/app.py.`,
+    }));
+  }
+  return [
+    { title: 'Ingresar', desc: 'Abre la app y autentícate si el proyecto lo requiere.' },
+    { title: 'Revisar el dashboard', desc: 'El resumen principal concentra KPIs y accesos a los módulos.' },
+    { title: 'Explorar módulos', desc: 'Cada módulo cubre una parte del flujo operativo del negocio.' },
+    { title: 'Operar', desc: 'Registra, edita o consulta según el módulo de trabajo.' },
+    { title: 'Exportar / compartir', desc: 'Genera reportes en Excel cuando el proyecto lo integre.' },
+    { title: 'Cerrar sesión', desc: 'Si compartes el dispositivo, cierra tu sesión al terminar.' },
+  ];
+}

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

@@ -0,0 +1,8 @@
+/**
+ * Tema base — fabrica generica. Wrapper de compat sobre themes/index.js.
+ */
+export {
+  createTheme,
+  createCorporateTheme,
+  registerLayouts,
+} from './index.js';

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

@@ -0,0 +1,4 @@
+/**
+ * Tema CIPSA — verde corporativo. Wrapper de compat sobre themes/index.js.
+ */
+export { createCipsaTheme as default, createCipsaTheme } from './index.js';

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

@@ -0,0 +1,4 @@
+/**
+ * Tema G360 — paleta esmeralda. Wrapper de compat sobre themes/index.js.
+ */
+export { createG360Theme as default, createG360Theme } from './index.js';

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

@@ -0,0 +1,87 @@
+/**
+ * Fabrica de temas G360 para pptxgenjs.
+ * Consumen design-tokens.js (fuente unica de verdad de paletas/estilos).
+ */
+import PptxGenJS from 'pptxgenjs';
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+import {
+  PALETTES,
+  TYPO,
+  SPACING,
+  DEFAULT_LAYOUT,
+  resolvePalette,
+} from '../design-tokens.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/** Layout 16:9 registrado por las fabricas de tema */
+export function registerLayouts(pptx) {
+  pptx.defineLayout({
+    name: DEFAULT_LAYOUT,
+    width: SPACING.page.width,
+    height: SPACING.page.height,
+  });
+  pptx.layout = DEFAULT_LAYOUT;
+}
+
+/**
+ * Crea un tema completo para pptxgenjs.
+ * @param {string} name — 'g360' | 'cipsa' | 'corporate'
+ */
+export function createTheme(name = 'g360') {
+  const colors = resolvePalette(name);
+  const pptx = new PptxGenJS();
+  registerLayouts(pptx);
+
+  pptx.author = 'g360-cli';
+  pptx.company = name === 'cipsa' ? 'CIPSA' : 'G360';
+  pptx.subject = 'Manual de aplicacion generado por g360-cli';
+
+  return {
+    pptx,
+    colors,
+    typo: TYPO,
+    spacing: SPACING,
+    layout: DEFAULT_LAYOUT,
+    font: TYPO.font,
+    fallbackFont: TYPO.fallback,
+    name,
+    /**
+     * Logo de marca (PNG) si existe; null si no.
+     */
+    logo() {
+      const candidates = name === 'cipsa'
+        ? [
+            path.join(process.cwd(), 'assets', 'images', 'Logo_cipsa_solid.png'),
+            path.join(__dirname, '..', 'brand', 'cipsa', 'logotypes', 'Logo_cipsa_solid.png'),
+          ]
+        : [
+            path.join(process.cwd(), 'assets', 'images', 'logo-g360-dark.png'),
+            path.join(__dirname, '..', 'brand', 'g360', 'logotypes', 'logo-g360-dark.png'),
+          ];
+      for (const p of candidates) {
+        if (fs.existsSync(p)) return { path: p, w: 1.5, h: 0.5 };
+      }
+      return null;
+    },
+  };
+}
+
+/** Compat: tema G360 (esmeralda) */
+export function createG360Theme() {
+  return createTheme('g360');
+}
+
+/** Compat: tema CIPSA (verde corporativo) */
+export function createCipsaTheme() {
+  return createTheme('cipsa');
+}
+
+/** Compat: tema Corporate (azul marino) */
+export function createCorporateTheme() {
+  return createTheme('corporate');
+}
+
+export { PALETTES };

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,91 @@
+/**
+ * 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.resolve(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 (¿Qué es?)'));
+    console.log(chalk.gray('  [3] Módulos (tabla + capturas)'));
+    console.log(chalk.gray('  [4] Flujo de trabajo'));
+    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] Límites conocidos (si aplica)'));
+    console.log(chalk.gray('  [N+5] Resumen'));
+    console.log(chalk.gray(`\nFormato: 16:9 widescreen · Theme: ${themeName || detectedBrand}`));
+    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,
+      targetDir: targetDir,
+      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(`   Formato: 16:9 widescreen (modo ${mode})`));
+    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);
+  }
+}