g360-cli 1.2.2 → 1.3.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 11.1.0
+- **UI**: Chalk 5.3.0 (colores), Ora 7.0.1 (spinners), Inquirer 9.2.15 (prompts)
+- **Filesystem**: fs-extra 11.2.0
+- **Build**: pkg 5.8.1 (portable .exe)
+- **Distribución**: npm global
 
 ---
 
@@ -627,6 +655,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 +713,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.3.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')\"",

package/src/cli.js

@@ -2,6 +2,9 @@
 
 import { Command } from 'commander';
 import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
 import { init } from './commands/init.js';
 import { setSkill } from './commands/set-skill.js';
 import { bring } from './commands/bring.js';
@@ -14,12 +17,15 @@ import { update } from './commands/update.js';
 import { convert } from './commands/convert.js';
 import { signature } from './commands/signature.js';
 
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = fs.readJsonSync(path.join(__dirname, '../package.json'));
+
 const program = new Command();
 
 program
   .name('g360')
   .description('CLI tool for bootstrapping G360 ecosystem projects')
-  .version('1.2.2');
+  .version(pkg.version);
 
 program
   .command('init')

package/src/commands/init.js

@@ -55,9 +55,12 @@ export async function init(name, options) {
     await fs.copy(templateDir, targetDir);
     await manifest.init(targetDir, { name, template, version: '1.0.0' });
     
-    // Aplicar el skill pasando el directorio destino explícitamente
+     // Aplicar el skill pasando el directorio destino explícitamente
     await setSkill(skill, { force: true, verbose: options.verbose, cwd: targetDir });
 
+    // Crear estructura estándar G360 para auditoría y desarrollo guiado
+    await createG360Structure(targetDir, templatesPath);
+
     progressBar.stop();
     
     console.log(chalk.green('\n✅ Project created successfully!\n'));
@@ -65,8 +68,37 @@ export async function init(name, options) {
     console.log(`  ${chalk.cyan('cd')} ${name}`);
     console.log(`  ${chalk.cyan('g360 bring')}`);
     console.log(`  ${chalk.cyan('g360 present')}\n`);
-  } catch (error) {
+} catch (error) {
     progressBar.stop();
     console.error(chalk.red(`\n❌ Error: ${error.message}`));
   }
 }
+
+async function createG360Structure(projectPath, assetsDir) {
+  try {
+    const g360Dir = path.join(projectPath, 'g360');
+    await fs.ensureDir(g360Dir);
+    
+    const subdirs = ['skills', 'snippets', 'samples', 'config', 'engine'];
+    for (const dir of subdirs) {
+      await fs.ensureDir(path.join(g360Dir, dir));
+    }
+    
+    const skillJsonPath = path.join(g360Dir, 'skill.json');
+    if (!fs.existsSync(skillJsonPath)) {
+      const exampleSkillPath = path.join(assetsDir, 'config/skills.json');
+      if (fs.existsSync(exampleSkillPath)) {
+        await fs.copy(exampleSkillPath, skillJsonPath);
+      }
+    }
+    
+    const snippetsDir = path.join(g360Dir, 'snippets');
+    const exampleSnippetsPath = path.join(assetsDir, 'snippets/snippets.json');
+    if (fs.existsSync(exampleSnippetsPath) && !fs.existsSync(path.join(snippetsDir, 'snippets.json'))) {
+      await fs.copy(exampleSnippetsPath, path.join(snippetsDir, 'snippets.json'));
+    }
+    
+  } catch (error) {
+    console.log(chalk.yellow(`Warning: Could not create G360 structure: ${error.message}`));
+  }
+}

package/src/lib/auditor.js

@@ -46,7 +46,25 @@ export const auditor = {
     if (fs.existsSync(manifestPath)) {
       return { status: 'pass', details: 'Manifest found' };
     }
-    return { status: 'warn', issue: { file: 'g360-manifest.json', message: 'No manifest found' } };
+    
+    const pkgPath = path.join(projectDir, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        const isG360Tool = 
+          pkg.name?.startsWith('g360-') || 
+          (pkg.keywords && pkg.keywords.some(k => k.includes('g360'))) ||
+          pkg.name === 'g360-cli';
+        
+        if (isG360Tool) {
+          return { status: 'pass', details: 'G360 tool/package - manifest optional' };
+        }
+      } catch (e) {
+        // Continue to warning
+      }
+    }
+    
+    return { status: 'warn', issue: { file: 'g360-manifest.json', message: 'No manifest found - run "g360 bring" to initialize' } };
   },
 
   checkStructure(projectDir) {
@@ -54,7 +72,26 @@ export const auditor = {
     if (fs.existsSync(g360Dir)) {
       return { status: 'pass', details: 'G360 assets directory found' };
     }
-    return { status: 'warn', issue: { file: 'g360/', message: 'No G360 assets found' } };
+    
+    // Check if this is a G360 tool/package - structure optional
+    const pkgPath = path.join(projectDir, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        const isG360Tool = 
+          pkg.name?.startsWith('g360-') || 
+          (pkg.keywords && pkg.keywords.some(k => k.includes('g360'))) ||
+          pkg.name === 'g360-cli';
+        
+        if (isG360Tool) {
+          return { status: 'pass', details: 'G360 tool/package - G360 structure optional' };
+        }
+      } catch (e) {
+        // If package.json is invalid, continue to warning
+      }
+    }
+    
+    return { status: 'warn', issue: { file: 'g360/', message: 'No G360 assets found - run "g360 bring" to initialize assets' } };
   },
 
   checkConfig(projectDir) {