@icarusmx/creta 1.5.4 → 1.5.7

package/bin/creta.js

@@ -7,6 +7,8 @@ import path from 'path'
 import { fileURLToPath } from 'url'
 import { CretaCodeSession } from '../lib/session.js'
 import { PullRequestTutorial } from '../lib/pr-tutorial.js'
+import { VimSetupTutorial } from '../lib/vim-setup-tutorial.js'
+import { AWSGuideViewer } from '../lib/aws-guide-viewer.js'
 import { CommandHelpExecutor } from '../lib/executors/CommandHelpExecutor.js'
 import { PapersExecutor } from '../lib/papers/PapersExecutor.js'
 import { ExercisesExecutor } from '../lib/executors/ExercisesExecutor.js'
@@ -112,6 +114,10 @@ if (command.startsWith('portafolio')) {
   // Start papers selector
   const executor = new PapersExecutor()
   await executor.execute()
+} else if (command === 'aws') {
+  // Show AWS billing detective guide
+  const viewer = new AWSGuideViewer()
+  await viewer.start()
 } else if (command === 'help' || command === 'ayuda') {
   // Show available commands
   showHelp()
@@ -609,6 +615,7 @@ function showHelp() {
   console.log("  creta portafolio-2   - Desbloquea nivel 2 (navbar + hero) 🔓")
   console.log("  creta portafolio-3   - Desbloquea nivel 3 (solución completa) 🔓")
   console.log("  creta code           - Inicia sesión interactiva de programación 🤖")
+  console.log("  creta aws            - Guía de AWS Billing Detective 🕵️")
   console.log("  creta help           - Muestra esta ayuda")
   console.log("\n💡 Tip: Si estás dentro de un proyecto existente, los comandos")
   console.log("    portafolio-1/2/3 actualizarán tus archivos directamente")
@@ -1306,7 +1313,8 @@ async function startProyectosSelectorInteractive() {
 
   const projects = [
     { id: 1, title: "🔀 Construye una pull-request", type: 'pr' },
-    { id: 2, title: "🎨 Construye tu portafolio", type: 'portfolio' }
+    { id: 2, title: "🎨 Construye tu portafolio", type: 'portfolio' },
+    { id: 3, title: "⌨️  Configura Creta Vim", type: 'vim' }
   ]
 
   let selectedIndex = 0
@@ -1365,6 +1373,8 @@ async function startProyectosSelectorInteractive() {
           startPullRequestTutorial().then(resolve)
         } else if (selectedProject.type === 'portfolio') {
           startPortfolioSelector().then(resolve)
+        } else if (selectedProject.type === 'vim') {
+          startVimSetupTutorial().then(resolve)
         }
         return
       }
@@ -1429,9 +1439,10 @@ async function startProyectosSelectorFallback() {
     console.log("")
     console.log("1. 🔀 Construye una pull-request")
     console.log("2. 🎨 Construye tu portafolio")
+    console.log("3. ⌨️  Configura Creta Vim")
     console.log("")
 
-    const respuesta = await askQuestion("Elige una opción (1-2) o 'q' para salir: ")
+    const respuesta = await askQuestion("Elige una opción (1-3) o 'q' para salir: ")
 
     if (respuesta.toLowerCase() === 'q') {
       console.log("Hecho con <3 por icarus.mx")
@@ -1447,8 +1458,11 @@ async function startProyectosSelectorFallback() {
     } else if (opcionSeleccionada === 2) {
       rl.close()
       await startPortfolioSelector()
+    } else if (opcionSeleccionada === 3) {
+      rl.close()
+      await startVimSetupTutorial()
     } else {
-      console.log("❌ Opción no válida. Elige 1 o 2.")
+      console.log("❌ Opción no válida. Elige 1, 2 o 3.")
       rl.close()
     }
 
@@ -1648,6 +1662,33 @@ async function startPullRequestTutorial() {
   }
 }
 
+async function startVimSetupTutorial() {
+  try {
+    const tutorial = new VimSetupTutorial()
+    await tutorial.start()
+
+    // Volver al menú principal después de completar el tutorial
+    await returnToMainMenu()
+  } catch (error) {
+    console.error("\n❌ Error al ejecutar el tutorial:", error.message)
+    console.log("\nSi el problema persiste, contacta al equipo de Creta.")
+
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+
+    await new Promise((resolve) => {
+      rl.question("\nPresiona Enter para volver al menú principal...", () => {
+        rl.close()
+        resolve()
+      })
+    })
+
+    await startMainMenu()
+  }
+}
+
 // Helper function to detect command help requests
 function isCommandHelpRequest(args) {
   // List of supported commands for help

package/lib/aws-guide-viewer.js

@@ -0,0 +1,179 @@
+import { createInterface } from 'readline'
+import { execSync } from 'child_process'
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import chalk from 'chalk'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+export class AWSGuideViewer {
+  constructor() {
+    this.guidePath = path.join(__dirname, 'exercises', 'aws-billing-detective.md')
+  }
+
+  async start() {
+    console.clear()
+    this.showWelcome()
+    await this.showOptions()
+  }
+
+  showWelcome() {
+    console.log(chalk.cyan('\n🕵️  AWS Billing Detective'))
+    console.log(chalk.gray('═'.repeat(60)))
+    console.log('\n' + chalk.bold('El misterio: "Apagué todo pero AWS me sigue cobrando"'))
+    console.log('\nGuía completa para encontrar cargos ocultos de AWS:')
+    console.log('  • Obtener credenciales de AWS (IAM)')
+    console.log('  • Instalar y configurar AWS CLI')
+    console.log('  • Comandos de auditoría región por región')
+    console.log('  • Los sospechosos habituales (EBS, Elastic IPs, NAT Gateways)')
+    console.log('  • Scripts de prevención')
+    console.log('\n' + chalk.yellow('📍 Ubicación: ') + this.guidePath)
+    console.log(chalk.gray('\n588 líneas de guía paso a paso\n'))
+  }
+
+  async showOptions() {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+
+    const askQuestion = (question) => {
+      return new Promise((resolve) => {
+        rl.question(question, resolve)
+      })
+    }
+
+    // Check if file exists
+    if (!fs.existsSync(this.guidePath)) {
+      console.log(chalk.red('❌ Error: No se encontró la guía de AWS'))
+      console.log(chalk.gray('\nAsegúrate de estar ejecutando Creta desde el directorio correcto'))
+      rl.close()
+      return
+    }
+
+    console.log(chalk.bold('📚 Opciones:'))
+    console.log('')
+    console.log('1. Abrir con nvim ' + chalk.gray('(recomendado, usa fold markers)'))
+    console.log('2. Mostrar la ruta ' + chalk.gray('(para copiar)'))
+    console.log('3. Ver primeros 30 líneas ' + chalk.gray('(preview)'))
+    console.log('4. Ver tabla de contenido')
+    console.log('')
+
+    const choice = await askQuestion(chalk.cyan('Elige una opción (1-4) o Enter para nvim: '))
+    rl.close()
+
+    if (choice === '' || choice === '1') {
+      await this.openWithNvim()
+    } else if (choice === '2') {
+      this.showPath()
+    } else if (choice === '3') {
+      this.showPreview()
+    } else if (choice === '4') {
+      this.showTableOfContents()
+    }
+  }
+
+  async openWithNvim() {
+    console.log('\n' + chalk.cyan('🚀 Abriendo con nvim...'))
+    console.log(chalk.gray('💡 Tip: Usa ') + chalk.yellow('zM') + chalk.gray(' para cerrar todos los folds'))
+    console.log(chalk.gray('     Usa ') + chalk.yellow('zR') + chalk.gray(' para abrir todos los folds'))
+    console.log(chalk.gray('     Usa ') + chalk.yellow('za') + chalk.gray(' para toggle fold en la línea actual'))
+    console.log('')
+
+    try {
+      execSync(`nvim "${this.guidePath}"`, { stdio: 'inherit' })
+    } catch (error) {
+      console.log('\n' + chalk.yellow('⚠️  No se pudo abrir nvim. Intentando con el editor por defecto...'))
+      try {
+        execSync(`$EDITOR "${this.guidePath}" || vi "${this.guidePath}"`, { stdio: 'inherit' })
+      } catch (fallbackError) {
+        console.log('\n' + chalk.red('❌ No se pudo abrir ningún editor.'))
+        console.log(chalk.yellow('📍 Abre manualmente: ') + this.guidePath)
+      }
+    }
+  }
+
+  showPath() {
+    console.log('\n' + chalk.cyan('📋 Ruta del archivo:'))
+    console.log(chalk.yellow(this.guidePath))
+    console.log('')
+    console.log(chalk.gray('💡 Tip: Usa este comando para abrirlo:'))
+    console.log(chalk.yellow(`   nvim "${this.guidePath}"`))
+    console.log('')
+
+    // Try to copy to clipboard (macOS)
+    try {
+      execSync(`echo "${this.guidePath}" | pbcopy`, { stdio: 'ignore' })
+      console.log(chalk.green('✓ Ruta copiada al portapapeles (macOS)'))
+    } catch (error) {
+      // Silently fail if pbcopy not available
+    }
+    console.log('')
+  }
+
+  showPreview() {
+    console.log('\n' + chalk.cyan('📄 Primeras 30 líneas:'))
+    console.log(chalk.gray('═'.repeat(60)))
+    try {
+      const preview = execSync(`head -30 "${this.guidePath}"`, { encoding: 'utf8' })
+      console.log(preview)
+    } catch (error) {
+      console.log(chalk.red('❌ Error al leer el archivo'))
+    }
+    console.log(chalk.gray('═'.repeat(60)))
+    console.log('')
+    console.log(chalk.gray('💡 Abre el archivo completo con: ') + chalk.yellow(`creta aws`))
+    console.log(chalk.gray('   O directamente: ') + chalk.yellow(`nvim "${this.guidePath}"`))
+    console.log('')
+  }
+
+  showTableOfContents() {
+    console.log('\n' + chalk.cyan('📚 Tabla de Contenido'))
+    console.log(chalk.gray('═'.repeat(60)))
+    console.log('')
+
+    const toc = [
+      { section: 'El Misterio', description: 'Por qué AWS cobra después de apagar todo' },
+      { section: 'Parte 1', description: 'Obtener tus AWS Access Keys del console' },
+      { section: 'Parte 2', description: 'Instalar y configurar AWS CLI' },
+      { section: 'Parte 3', description: 'Auditoría completa de billing' },
+      { section: '', description: '  • EC2 instances' },
+      { section: '', description: '  • EBS volumes (el culpable #1)' },
+      { section: '', description: '  • Elastic IPs ($3.60/mes cada una)' },
+      { section: '', description: '  • NAT Gateways ($32/mes cada uno!)' },
+      { section: '', description: '  • Load Balancers' },
+      { section: '', description: '  • RDS databases' },
+      { section: '', description: '  • Snapshots' },
+      { section: '', description: '  • S3 buckets' },
+      { section: '', description: '  • CloudWatch logs' },
+      { section: 'Parte 4', description: 'Script de auditoría multi-región' },
+      { section: 'Parte 5', description: 'Cost Explorer (interfaz web)' },
+      { section: 'Parte 6', description: 'Alertas de billing (prevención)' },
+      { section: 'Quick Reference', description: 'Comandos más comunes' },
+      { section: 'Troubleshooting', description: 'Solución de problemas' },
+      { section: 'Checklist', description: 'Lista de prevención' },
+    ]
+
+    toc.forEach(({ section, description }) => {
+      if (section) {
+        console.log(chalk.bold(section.padEnd(15)) + chalk.gray(description))
+      } else {
+        console.log(chalk.gray(description))
+      }
+    })
+
+    console.log('')
+    console.log(chalk.gray('─'.repeat(60)))
+    console.log('')
+    console.log(chalk.yellow('💡 La guía completa tiene 588 líneas con:'))
+    console.log('   • Comandos copy-paste listos para usar')
+    console.log('   • Explicaciones de qué hace cada servicio')
+    console.log('   • Estimaciones de costo por servicio')
+    console.log('   • Scripts para automatizar la auditoría')
+    console.log('')
+    console.log(chalk.gray('Abre con: ') + chalk.yellow('nvim "' + this.guidePath + '"'))
+    console.log('')
+  }
+}

package/lib/builders/MenuBuilder.js

@@ -53,12 +53,13 @@ export class MenuBuilder {
 
   renderOption(option, isSelected, index) {
     const prefix = isSelected ? '▶ ' : '  '
+    const number = `${index + 1}.`
     const label = option.title || option.label || `Opción ${index + 1}`
 
     if (isSelected) {
-      console.log(`\x1b[36m${prefix}${label}\x1b[0m`)
+      console.log(`\x1b[36m${prefix}${number} ${label}\x1b[0m`)
     } else {
-      console.log(`${prefix}${label}`)
+      console.log(`${prefix}${number} ${label}`)
     }
 
     if (option.description) {
@@ -117,10 +118,28 @@ export class MenuBuilder {
           return
         }
 
-        if (key === '\u001b[A') {
+        // Handle number keys (1-9)
+        const numberMatch = key.match(/^[1-9]$/)
+        if (numberMatch) {
+          const num = parseInt(key, 10)
+          const targetIndex = num - 1
+
+          // Check if the number is within range
+          if (targetIndex >= 0 && targetIndex < this.config.options.length) {
+            const choice = this.config.options[targetIndex]
+            cleanup()
+            resolve(choice)
+            return
+          }
+        }
+
+        // Arrow keys or vim-style navigation
+        if (key === '\u001b[A' || key === 'k') {
+          // Up arrow or 'k'
           selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : this.config.options.length - 1
           render()
-        } else if (key === '\u001b[B') {
+        } else if (key === '\u001b[B' || key === 'j') {
+          // Down arrow or 'j'
           selectedIndex = selectedIndex < this.config.options.length - 1 ? selectedIndex + 1 : 0
           render()
         }

package/lib/executors/ExercisesExecutor.js

@@ -33,6 +33,14 @@ export class ExercisesExecutor {
         file: "railway-deployment.md",
         lines: 500,
         topics: ["Railway", "Deployment", "Node.js", "DevOps"]
+      },
+      {
+        id: 4,
+        title: "AWS Billing Detective",
+        description: "Hunt down AWS charges and prevent surprises",
+        file: "aws-billing-detective.md",
+        lines: 588,
+        topics: ["AWS", "CLI", "Cost Management", "DevOps"]
       }
     ]
   }