g360-cli 1.2.2 → 1.4.0

package/README.md

@@ -1,13 +1,15 @@
 # g360-cli
 
-> CLI tool for bootstrapping G360 ecosystem projects with standardized structure, assets, and best practices.
+> CLI tool for bootstrapping G360 projects with standardized structure, assets, and identity
 
 [![npm version](https://img.shields.io/npm/v/g360-cli)](https://www.npmjs.com/package/g360-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ## Tabla de Contenidos
 
+- [Descripción](#descripción)
 - [Características](#características)
+- [Tecnologías](#tecnologías)
 - [Instalación](#instalación)
 - [Inicio Rápido](#inicio-rápido)
 - [Comandos](#comandos)
@@ -16,8 +18,34 @@
 - [Skills](#skills)
 - [Configuración](#configuración)
 - [API](#api)
+- [Estructura](#estructura)
+- [Scripts](#scripts)
+- [Testing](#testing)
 - [Contribución](#contribución)
 - [Licencia](#licencia)
+- [Ecosistema G360](#ecosistema-g360)
+
+---
+
+## Descripción
+
+CLI tool para el ecosistema G360 que permite inicializar proyectos con estructura estándar, gestionar assets embebidos, y asegurar compliance mediante auditoría automática. Forma parte del núcleo del ecosistema y está disponible como paquete global de npm.
+
+**Tipo**: CLI Tool / Scaffolding / Generator  
+**Plataforma**: Node.js >= 18.0.0  
+**Distribución**: npm global (`npm install -g g360-cli`)
+
+---
+
+## Tecnologías
+
+- **Runtime**: Node.js >= 18.0.0
+- **Lenguaje**: JavaScript (ESModules)
+- **CLI Framework**: Commander 14.x
+- **UI**: Chalk 5.x (colores), Ora 9.x (spinners), Inquirer 13.x (prompts)
+- **Filesystem**: fs-extra 11.x
+- **Build**: pkg 5.8.1 (portable .exe)
+- **Distribución**: npm global
 
 ---
 
@@ -27,7 +55,8 @@
 - **Gestión de assets** - Trae componentes, skills y plantillas embebidas
 - **Auditoría** - Verifica compliance de proyectos G360
 - **Limpieza** - Elimina assets embebidos antes de deployment
-- **Multi-plantilla** - Web PWA, Python CLI, VBA Excel
+- **Multi-plantilla** - Web (Lit, Solid, Svelte, React), Python (CLI, Flet, CustomTkinter), VBA Excel
+- **Modo portable** - Proyectos Python con ejecución directa (sin PyInstaller)
 - **Modo offline** - Funciona sin conexión usando assets cacheados
 - **Preview** - Dry-run para previsualizar cambios
 
@@ -183,6 +212,33 @@ g360 convert . --skill corporativo-movil --force
 
 ---
 
+### `g360 signature`
+
+Instala el componente de firma oficial G360 en proyectos web.
+
+```bash
+g360 signature install [opciones]
+```
+
+**Opciones:**
+
+| Opción | Descripción | Valor por defecto |
+|--------|-------------|-------------------|
+| `-p, --path <ruta>` | Ruta al index.html | `.` |
+| `--force` | Reinstalar si ya existe | `false` |
+
+**Ejemplos:**
+
+```bash
+# Instalar en el directorio actual
+g360 signature install
+
+# Forzar reinstalación
+g360 signature install --force
+```
+
+---
+
 ### `g360 bring`
 
 Trae assets G360 al proyecto actual.
@@ -457,7 +513,7 @@ mi-proyecto/
 
 ### python-cli
 
-Plantilla CLI de Python.
+Plantilla CLI de Python con estructura argparse completa.
 
 ```
 mi-cli/
@@ -466,9 +522,55 @@ mi-cli/
 │   └── core/
 │       └── skill.json
 ├── requirements.txt
+├── run.bat
+├── build-portable.bat
+└── skill.json
+```
+
+### python-flet
+
+Plantilla GUI de escritorio con **Flet** (flask-like para Flutter).
+
+```
+mi-app/
+├── src/
+│   ├── main.py
+│   └── core/
+│       └── skill.json
+├── requirements.txt
+├── run.bat
+├── build-portable.bat
+└── skill.json
+```
+
+### python-flet-migrate
+
+Plantilla para migrar aplicaciones Tkinter/CTkinter a Flet.
+
+```
+mi-app/
+├── src/
+│   ├── main.py
+│   └── migrate_tkinter.py
+├── requirements.txt
 └── skill.json
 ```
 
+### python-customtkinter
+
+Plantilla GUI de escritorio con **CustomTkinter** (tema oscuro moderno).
+
+```
+mi-app/
+├── src/
+│   ├── main.py
+│   └── core/
+│       └── skill.json
+├── requirements.txt
+├── run.bat
+└── build-portable.bat
+```
+
 ### vba-excel
 
 Plantilla VBA para Excel.
@@ -564,6 +666,14 @@ Proyectos minimalistas - scripts, CLI, Python.
 
 Configuración personalizada - colores ajustables.
 
+### flet-desktop
+
+Aplicaciones de escritorio Flet - estilo moderno G360 (PC).
+
+### flet-desktop-corporativo
+
+Aplicaciones Flet para clientes - estilo corporativo conservador.
+
 ### Ejemplos de uso
 
 ```bash
@@ -627,6 +737,48 @@ await g360.clean({ path: '.', force: true });
 
 ---
 
+## Estructura
+
+```
+g360-cli/
+├── src/
+│   ├── cli.js           # Entrada principal CLI
+│   ├── commands/         # Comandos (init, bring, audit, etc.)
+│   ├── lib/             # Utilidades (assets, auditor, config)
+│   └── assets/          # Assets embebidos
+│       ├── templates/    # Plantillas de proyecto
+│       ├── components/   # Componentes G360
+│       ├── skills/      # Skills de identidad
+│       ├── engine/      # G360 Engine
+│       └── config/      # Configuraciones
+├── package.json
+├── README.md
+└── LICENSE
+```
+
+---
+
+## Scripts
+
+| Comando | Descripción |
+|---------|-------------|
+| `npm run build` | Build portable con pkg (g360.exe) |
+| `npm run build:portable` | Especificar target node18-win-x64 |
+| `npm test` | Ejecutar tests (actualmente placeholder) |
+| `npm run prepublishOnly` | Validación antes de publicar en npm |
+
+---
+
+## Testing
+
+```bash
+npm test
+```
+
+Actualmente configurado con un placeholder. Próximamente se integrará con Vitest para testing de comandos y utilidades.
+
+---
+
 ## Contribución
 
 1. Fork el repositorio
@@ -643,9 +795,36 @@ MIT License - ver [LICENSE](LICENSE) para más detalles.
 
 ---
 
+## Ecosistema G360
+
+Este proyecto forma parte de la familia de microherramientas **G360** para apoyo CRM y gestión de datos en escritorio, enfocadas en áreas como ventas, finanzas y logística.
+
+### Identidad Visual G360
+
+- **Isotipo**: 3 puntos verticales paralelos (gris-verde-gris) + chevron `>`
+- **Colores**: #00d084 (verde), #94a3b8 (gris)
+- **Marca**: G360 - Microherramientas para apoyo CRM y datos en escritorio
+- **Implementación**: Usar `g360-signature` para branding consistente
+
+### Herramientas Relacionadas
+
+- **[g360-signature](https://github.com/carloscus/g360-signature)**: Web component de branding G360
+- **[g360-order-xlsx](https://github.com/carloscus/g360-order-xlsx)**: Procesador de cotizaciones Excel
+- **[g360-day-calculator](https://github.com/carloscus/g360-day-calculator)**: Calculadora de días laborables
+- **[g360-master-data](https://github.com/carloscus/g360-master-data)**: Gestión de datos maestros
+
+---
+
 ## Enlaces
 
 - [npm](https://www.npmjs.com/package/g360-cli)
 - [GitHub](https://github.com/carloscus/g360-cli)
 - [Documentación](#)
 - [Reportar Issue](https://github.com/carloscus/g360-cli/issues)
+
+---
+**Marca**: G360
+**Isotipo**: 3 puntos verticales paralelos (gris-verde-gris) + chevron `>`
+**Autor**: Carlos Cusi
+**Desarrollo**: Con asistencia de herramientas de código IA (Vibe Code)
+**Powered by**: [g360-signature](https://github.com/carloscus/g360-signature)

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "g360-cli",
-  "version": "1.2.2",
-  "description": "CLI tool for bootstrapping G360 ecosystem projects",
+  "version": "1.4.0",
+  "description": "CLI tool for bootstrapping G360 projects with standardized structure, assets, and identity",
   "type": "module",
   "main": "src/cli.js",
   "bin": {
-    "g360": "./src/cli.js"
+    "g360": "src/cli.js"
   },
   "scripts": {
     "prepublishOnly": "node -e \"console.log('Use: npm install -g g360-cli')\"",
@@ -28,11 +28,11 @@
   "author": "Carlos Cusi",
   "license": "MIT",
   "dependencies": {
-    "chalk": "^5.3.0",
-    "commander": "^11.1.0",
-    "fs-extra": "^11.2.0",
-    "inquirer": "^9.2.15",
-    "ora": "^7.0.1"
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "fs-extra": "^11.3.4",
+    "inquirer": "^13.4.2",
+    "ora": "^9.4.0"
   },
   "devDependencies": {
     "pkg": "^5.8.1"

package/src/assets/config/g360-skills.json

@@ -167,6 +167,58 @@
         "mode": "custom",
         "text": "custom"
       }
+    },
+    {
+      "name": "flet-desktop",
+      "description": "Aplicaciones de escritorio Flet - estilo G360",
+      "device": "pc",
+      "colors": {
+        "bg": "#0b1220",
+        "surface": "#1a2332",
+        "accent": "#00d084",
+        "text": "#f0f4f8",
+        "muted": "#94a3b8",
+        "success": "#22c55e",
+        "warning": "#f59e0b",
+        "error": "#ef4444"
+      },
+      "effects": {
+        "glassmorphism": true,
+        "blur": "12px",
+        "rounded": "12px"
+      },
+      "signature": {
+        "mode": "own",
+        "text": "G360 Desktop"
+      },
+      "framework": "flet",
+      "portable": true
+    },
+    {
+      "name": "flet-desktop-corporativo",
+      "description": "Aplicaciones Flet para clientes - estilo corporativo",
+      "device": "pc",
+      "colors": {
+        "bg": "#ffffff",
+        "surface": "#f8fafc",
+        "accent": "#00796B",
+        "text": "#1e293b",
+        "muted": "#64748b",
+        "success": "#10b981",
+        "warning": "#f59e0b",
+        "error": "#dc2626"
+      },
+      "effects": {
+        "glassmorphism": false,
+        "blur": "0px",
+        "rounded": "8px"
+      },
+      "signature": {
+        "mode": "powered",
+        "text": "powered by G360"
+      },
+      "framework": "flet",
+      "portable": true
     }
   ]
 }

package/src/assets/config/project-types.json

@@ -21,6 +21,22 @@
       "framework": "python",
       "features": ["cli", "argparse", "rich"]
     },
+    {
+      "id": "python-flet",
+      "name": "Python Flet Desktop",
+      "description": "Python desktop app with Flet framework",
+      "framework": "flet",
+      "features": ["desktop", "gui", "cross-platform", "portable"],
+      "portable": true
+    },
+    {
+      "id": "python-flet-migrate",
+      "name": "Python Flet Migration",
+      "description": "Migrate tkinter/ctkinter app to Flet",
+      "framework": "flet",
+      "features": ["migration", "desktop", "gui", "portable"],
+      "portable": true
+    },
     {
       "id": "vba-excel",
       "name": "VBA Excel",

package/src/assets/config/skills.json

@@ -25,6 +25,18 @@
       "description": "Backend development agent",
       "files": []
     },
+    {
+      "name": "python-desktop",
+      "description": "Python Flet desktop development agent",
+      "files": [],
+      "capabilities": ["flet", "gui", "desktop", "portable", "migrate-tkinter", "migrate-ctkinter"]
+    },
+    {
+      "name": "python-calculations",
+      "description": "Python calculations and data processing agent",
+      "files": [],
+      "capabilities": ["python", "math", "data-processing", "statistics", "flet-ui"]
+    },
     {
       "name": "calculations",
       "description": "Calculations and data processing",

package/src/assets/snippets/snippets.json

@@ -1,5 +1,47 @@
 {
   "snippets": [
+    {
+      "name": "cli-argparse-basic",
+      "description": "Basic argparse CLI structure",
+      "language": "python",
+      "code": "import argparse\n\nparser = argparse.ArgumentParser(description='My CLI App')\nparser.add_argument('input', help='Input file')\nparser.add_argument('-v', '--verbose', action='store_true')\nparser.add_argument('-o', '--output', default='output.txt')\nargs = parser.parse_args()"
+    },
+    {
+      "name": "cli-subcommands",
+      "description": "CLI with subcommands (git-style)",
+      "language": "python",
+      "code": "import argparse\n\nparser = argparse.ArgumentParser()\nsubparsers = parser.add_subparsers()\n\ninit_parser = subparsers.add_parser('init')\ninit_parser.add_argument('name')\n\nrun_parser = subparsers.add_parser('run')\nrun_parser.add_argument('--watch', action='store_true')"
+    },
+    {
+      "name": "cli-logging",
+      "description": "Logging setup for CLI",
+      "language": "python",
+      "code": "import logging\nimport sys\n\ndef setup_logging(verbose=False):\n    level = logging.DEBUG if verbose else logging.INFO\n    logging.basicConfig(\n        level=level,\n        format='%(asctime)s - %(levelname)s - %(message)s',\n        handlers=[logging.StreamHandler(sys.stdout)]\n    )\n    return logging.getLogger(__name__)"
+    },
+    {
+      "name": "cli-config-json",
+      "description": "Load JSON config file",
+      "language": "python",
+      "code": "import json\nfrom pathlib import Path\n\ndef load_config(config_path='config.json'):\n    path = Path(config_path)\n    if not path.exists():\n        raise FileNotFoundError(f'Config not found: {config_path}')\n    with open(path) as f:\n        return json.load(f)"
+    },
+    {
+      "name": "cli-progress-bar",
+      "description": "Progress bar with tqdm",
+      "language": "python",
+      "code": "from tqdm import tqdm\n\nfor item in tqdm(items, desc='Processing', unit='item'):\n    # process item\n    pass"
+    },
+    {
+      "name": "cli-env-config",
+      "description": "Environment-based configuration",
+      "language": "python",
+      "code": "import os\nfrom pathlib import Path\n\ndef get_config():\n    env = os.getenv('APP_ENV', 'development')\n    config_dir = Path(__file__).parent / 'config'\n    config_file = config_dir / f'{env}.json'\n    return json.loads(config_file.read_text())"
+    },
+    {
+      "name": "cli-exit-codes",
+      "description": "Exit codes constants",
+      "language": "python",
+      "code": "EXIT_OK = 0\nEXIT_ERROR = 1\nEXIT_USAGE = 2\nEXIT_DATA = 3\n\n# Usage: sys.exit(EXIT_ERROR)"
+    },
     {
       "name": "g360-header",
       "description": "Standard G360 header",
@@ -19,6 +61,41 @@
       "name": "g360-badge",
       "description": "G360 status badge",
       "code": "<span class='g360-badge g360-badge-success'>Active</span>"
+    },
+    {
+      "name": "flet-page",
+      "description": "Flet page setup with G360 theme",
+      "code": "import flet as ft\n\ndef main(page: ft.Page):\n    page.title = 'G360 App'\n    page.theme_mode = ft.ThemeMode.DARK\n    page.bgcolor = '#0b1220'\n    page.padding = 20\n    page.add(ft.Text('G360 Desktop App', size=24, color='#00d084'))"
+    },
+    {
+      "name": "flet-card",
+      "description": "G360 styled Flet Card",
+      "code": "ft.Container(\n    content=ft.Column([...]),\n    bgcolor='#1a2332',\n    border_radius=12,\n    padding=15,\n    shadow=ft.BoxShadow(\n        spread_radius=1,\n        blur_radius=20,\n        color='#00d08420'\n    )\n)"
+    },
+    {
+      "name": "flet-button",
+      "description": "G360 styled Flet Button",
+      "code": "ft.ElevatedButton(\n    content=ft.Text('G360 Button', color='#0b1220'),\n    style=ft.ButtonStyle(\n        bgcolor='#00d084',\n        color='#0b1220',\n        shape=ft.RoundedRectangleBorder(radius=8),\n        padding=15\n    )\n)"
+    },
+    {
+      "name": "flet-nav-rail",
+      "description": "Flet navigation rail for desktop",
+      "code": "ft.NavigationRail(\n    selected_index=0,\n    label_type=ft.NavigationRailLabelType.ALL,\n    min_width=100,\n    min_extended_width=200,\n    destinations=[\n        ft.NavigationRailDestination(icon=ft.icons.HOME_OUTLINED, selected_icon=ft.icons.HOME, label='Home'),\n        ft.NavigationRailDestination(icon=ft.icons.SETTINGS_OUTLINED, selected_icon=ft.icons.SETTINGS, label='Settings'),\n    ]\n)"
+    },
+    {
+      "name": "flet-datatable",
+      "description": "Flet DataTable with G360 styling",
+      "code": "ft.DataTable(\n    heading_row_color='#00d084',\n    data_row_color='#1a2332',\n    columns=[\n        ft.DataColumn(ft.Text('SKU', color='#f0f4f8')),\n        ft.DataColumn(ft.Text('Descripción', color='#f0f4f8')),\n        ft.DataColumn(ft.Text('Cantidad', color='#f0f4f8')),\n    ],\n    rows=[]\n)"
+    },
+    {
+      "name": "flet-dialog",
+      "description": "Flet modal dialog",
+      "code": "def show_dialog(page, title, content):\n    dialog = ft.AlertDialog(\n        title=ft.Text(title, color='#00d084'),\n        content=ft.Container(content=content, padding=20),\n        actions=[\n            ft.TextButton('Cancelar', on_click=lambda _: page.close_dialog()),\n            ft.ElevatedButton('Aceptar', bgcolor='#00d084', color='#0b1220'),\n        ]\n    )\n    page.dialog = dialog\n    dialog.open = True\n    page.update()"
+    },
+    {
+      "name": "flet-chart-bar",
+      "description": "Flet bar chart for data visualization",
+      "code": "ft.BarChart(\n    bar_groups=[\n        ft.BarChartGroup(\n            x=0,\n            bar_rods=[\n                ft.BarChartRod(\n                    from_y=0,\n                    to_y=50,\n                    width=40,\n                    color='#00d084',\n                ),\n            ],\n        ),\n    ],\n    left_axis=ft.ChartAxis(labels_size=40),\n    bottom_axis=ft.ChartAxis(labels=[...]),\n)"
     }
   ]
 }

package/src/assets/templates/python-cli/build-portable.bat

@@ -0,0 +1,33 @@
+@echo off
+chcp 65001 >nul
+title G360 - Portable CLI Launcher
+
+echo.
+echo ==============================================
+echo   G360 CLI - Portable Version
+echo   (Requires Python installed)
+echo ==============================================
+echo.
+
+python --version >nul 2>&1
+if errorlevel 1 (
+    echo ERROR: Python no encontrado
+    echo Instala Python desde: https://python.org
+    echo O usa setup.bat para configurar ambiente
+    pause
+    exit /b 1
+)
+
+echo Buscando archivo principal...
+if not exist "src\main.py" (
+    echo ERROR: src\main.py no encontrado
+    pause
+    exit /b 1
+)
+
+echo Ejecutando G360 CLI...
+echo.
+python src\main.py %*
+
+echo.
+pause

package/src/assets/templates/python-cli/src/main.py

@@ -1,13 +1,117 @@
 #!/usr/bin/env python3
 """
 G360 Python CLI Application
+Main entry point with argparse-based CLI structure
 """
 
+import argparse
+import sys
+import os
+from pathlib import Path
+
+VERSION = "1.0.0"
+APP_NAME = "G360 CLI"
+AUTHOR = "Carlos Cusi"
+
+
+def setup_logging(verbose=False):
+    """Configure logging based on verbose flag"""
+    import logging
+    level = logging.DEBUG if verbose else logging.INFO
+    format_str = "%(asctime)s - %(levelname)s - %(message)s"
+    logging.basicConfig(level=level, format=format_str, datefmt="%H:%M:%S")
+    return logging.getLogger(__name__)
+
+
+def cmd_hello(args):
+    """Hello world command example"""
+    print(f"\n{APP_NAME} v{VERSION}")
+    print(f"Author: {AUTHOR}")
+    print(f"Working directory: {os.getcwd()}")
+    if args.name:
+        print(f"\nHello, {args.name}!")
+    print()
+
+
+def cmd_process(args):
+    """Process data command"""
+    logger = setup_logging(args.verbose)
+    logger.info(f"Processing: {args.input}")
+    
+    if not os.path.exists(args.input):
+        logger.error(f"Input file not found: {args.input}")
+        return 1
+    
+    output_dir = args.output or os.path.dirname(args.input) or "."
+    logger.info(f"Output directory: {output_dir}")
+    
+    print(f"✓ Processed {args.input}")
+    return 0
+
+
+def cmd_config(args):
+    """Show or edit configuration"""
+    config_path = Path("g360") / "config.json"
+    
+    if args.show:
+        if config_path.exists():
+            import json
+            with open(config_path) as f:
+                print(json.dumps(json.load(f), indent=2))
+        else:
+            print("No config file found. Run: g360 init")
+        return
+    
+    if args.set:
+        key, value = args.set.split("=")
+        print(f"Setting {key} = {value}")
+
 
 def main():
-    print("G360 CLI initialized")
-    print("Edit src/main.py to start building")
+    parser = argparse.ArgumentParser(
+        prog="g360",
+        description=f"{APP_NAME} - CLI tool for G360 ecosystem",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  g360 hello
+  g360 hello --name "World"
+  g360 process data.csv -o output/
+  g360 config --show
+        """
+    )
+    
+    parser.add_argument("-v", "--version", action="version", version=f"%(prog)s {VERSION}")
+    parser.add_argument("--verbose", "-V", action="store_true", help="Enable verbose output")
+    
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+    
+    hello_parser = subparsers.add_parser("hello", help="Say hello")
+    hello_parser.add_argument("--name", "-n", help="Name to greet")
+    
+    process_parser = subparsers.add_parser("process", help="Process input data")
+    process_parser.add_argument("input", help="Input file or directory")
+    process_parser.add_argument("-o", "--output", help="Output directory")
+    
+    config_parser = subparsers.add_parser("config", help="Manage configuration")
+    config_parser.add_argument("--show", action="store_true", help="Show current config")
+    config_parser.add_argument("--set", metavar="KEY=VALUE", help="Set config value")
+    
+    args = parser.parse_args()
+    
+    if not args.command:
+        parser.print_help()
+        return 0
+    
+    if args.command == "hello":
+        return cmd_hello(args)
+    elif args.command == "process":
+        return cmd_process(args)
+    elif args.command == "config":
+        return cmd_config(args)
+    
+    return 0
 
 
 if __name__ == "__main__":
-    main()
+    sys.exit(main())

package/src/assets/templates/python-customtkinter/README.md

@@ -0,0 +1,47 @@
+# G360 CustomTkinter Template
+
+Modern GUI desktop application with CustomTkinter and G360 theming.
+
+## Requisitos
+
+- Python 3.8+
+- customtkinter
+
+## Instalacion
+
+```bash
+pip install -r requirements.txt
+```
+
+## Ejecutar
+
+```bash
+run.bat
+```
+
+## Portable
+
+Ejecuta `build-portable.bat` - requiere Python instalado en el sistema.
+
+## Estructura
+
+```
+python-customtkinter/
+├── src/
+│   ├── main.py          # App principal
+│   └── core/
+│       └── skill.json  # Configuracion G360
+├── requirements.txt
+├── run.bat             # Ejecutar desarrollo
+└── build-portable.bat  # Version portable
+```
+
+## Caracteristicas
+
+- Tema oscuro G360 (#0b1220, #1a2332, #00d084)
+- UI moderna con CustomTkinter
+- Listo para expansion
+
+## License
+
+MIT - G360 Ecosystem