@icarusmx/creta 1.5.6 → 1.5.8

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()
@@ -601,19 +607,27 @@ async function unstuckProject(level) {
 }
 
 function showHelp() {
-  console.log("\n📚 Comandos disponibles:")
-  console.log("  creta                - Explora los 7 enunciados fundamentales (comando principal) 🧠")
-  console.log("  creta enunciados     - Explora los 7 enunciados fundamentales 🧠")
-  console.log("  creta portafolio     - Crea tu portafolio personal (reto completo)")
-  console.log("  creta portafolio-1   - Desbloquea nivel 1 (navbar) 🔓")
-  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 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")
-  console.log("\n🎯 La filosofía Creta: partir de enunciados que generan 'ruido' para")
-  console.log("   construir comprensión real, no solo sintaxis.")
+  console.log("\nCreta es una herramienta de CLI desarrollada por icarus.mx.")
+  console.log("El propósito de esta herramienta es acompañar a aprendices y")
+  console.log("constructores del taller en su camino de aprendizaje.\n")
+
+  console.log("📖 Documentación de comandos:")
+  console.log("  creta ls             - Documentación en español del comando ls")
+  console.log("  creta cd             - Documentación en español del comando cd")
+  console.log("  creta git status     - Documentación en español de git status")
+  console.log("  creta [comando]      - Documentación de cualquier comando soportado\n")
+
+  console.log("🎓 Aprendizaje:")
+  console.log("  creta                - Menú principal interactivo")
+  console.log("  creta sintaxis       - Aprende comandos de terminal y Git")
+  console.log("  creta enunciados     - Explora los 7 enunciados fundamentales de OOP")
+  console.log("  creta papers         - Recrea papers clásicos de Computer Science\n")
+
+  console.log("🛠️  Proyectos:")
+  console.log("  creta portafolio     - Crea tu portafolio personal")
+  console.log("  creta code           - Sesión interactiva de programación con IA\n")
+
+  console.log("💡 Usa 'creta' sin argumentos para ver el menú principal.")
 }
 
 async function startMainMenu() {
@@ -720,6 +734,46 @@ Salgamos de este laberinto 🏛️
         return
       }
 
+      // Handle vim-style navigation
+      if (key === 'k' || key === 'K') { // Vim: up
+        selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : options.length - 1
+        renderOptions()
+        return
+      } else if (key === 'j' || key === 'J') { // Vim: down
+        selectedIndex = selectedIndex < options.length - 1 ? selectedIndex + 1 : 0
+        renderOptions()
+        return
+      }
+
+      // Handle number key selection
+      const num = parseInt(key)
+      if (num >= 1 && num <= options.length) {
+        selectedIndex = num - 1
+        process.stdin.setRawMode(false)
+        process.stdin.removeListener('data', onKeyPress)
+
+        const selectedOption = options[selectedIndex]
+
+        // Clear screen
+        process.stdout.write('\x1b[2J')
+        process.stdout.write('\x1b[H')
+
+        if (selectedOption.id === 1) {
+          startSintaxisSelector().then(resolve)
+        } else if (selectedOption.id === 2) {
+          startEnunciadosSelector().then(resolve)
+        } else if (selectedOption.id === 3) {
+          startProyectosSelector().then(resolve)
+        } else if (selectedOption.id === 4) {
+          const executor = new PapersExecutor()
+          executor.execute().then(resolve)
+        } else if (selectedOption.id === 5) {
+          const executor = new ExercisesExecutor()
+          executor.execute().then(resolve)
+        }
+        return
+      }
+
       // Handle arrow keys (escape sequences)
       if (key === '\u001b[A') { // Up arrow
         selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : options.length - 1
@@ -1040,6 +1094,27 @@ async function startEnunciadosSelectorInteractive() {
         return
       }
 
+      // Handle vim-style navigation
+      if (key === 'k' || key === 'K') { // Vim: up
+        selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : ENUNCIADOS.length - 1
+        renderOptions()
+        return
+      } else if (key === 'j' || key === 'J') { // Vim: down
+        selectedIndex = selectedIndex < ENUNCIADOS.length - 1 ? selectedIndex + 1 : 0
+        renderOptions()
+        return
+      }
+
+      // Handle number key selection (1-7)
+      const num = parseInt(key)
+      if (num >= 1 && num <= ENUNCIADOS.length) {
+        selectedIndex = num - 1
+        // Simulate Enter key press to execute the selected option
+        const enterEvent = '\r'
+        onKeyPress(enterEvent)
+        return
+      }
+
       // Handle arrow keys (escape sequences)
       if (key === '\u001b[A') { // Up arrow
         selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : ENUNCIADOS.length - 1
@@ -1306,7 +1381,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 +1441,42 @@ async function startProyectosSelectorInteractive() {
           startPullRequestTutorial().then(resolve)
         } else if (selectedProject.type === 'portfolio') {
           startPortfolioSelector().then(resolve)
+        } else if (selectedProject.type === 'vim') {
+          startVimSetupTutorial().then(resolve)
+        }
+        return
+      }
+
+      // Handle vim-style navigation
+      if (key === 'k' || key === 'K') { // Vim: up
+        selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : projects.length - 1
+        renderOptions()
+        return
+      } else if (key === 'j' || key === 'J') { // Vim: down
+        selectedIndex = selectedIndex < projects.length - 1 ? selectedIndex + 1 : 0
+        renderOptions()
+        return
+      }
+
+      // Handle number key selection
+      const num = parseInt(key)
+      if (num >= 1 && num <= projects.length) {
+        selectedIndex = num - 1
+        process.stdin.setRawMode(false)
+        process.stdin.removeListener('data', onKeyPress)
+
+        const selectedProject = projects[selectedIndex]
+
+        // Clear screen
+        process.stdout.write('\x1b[2J')
+        process.stdout.write('\x1b[H')
+
+        if (selectedProject.type === 'pr') {
+          startPullRequestTutorial().then(resolve)
+        } else if (selectedProject.type === 'portfolio') {
+          startPortfolioSelector().then(resolve)
+        } else if (selectedProject.type === 'vim') {
+          startVimSetupTutorial().then(resolve)
         }
         return
       }
@@ -1429,9 +1541,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 +1560,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()
     }
 
@@ -1551,6 +1667,40 @@ async function startPortfolioSelectorInteractive() {
         return
       }
 
+      // Handle vim-style navigation
+      if (key === 'k' || key === 'K') { // Vim: up
+        selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : projects.length - 1
+        renderOptions()
+        return
+      } else if (key === 'j' || key === 'J') { // Vim: down
+        selectedIndex = selectedIndex < projects.length - 1 ? selectedIndex + 1 : 0
+        renderOptions()
+        return
+      }
+
+      // Handle number key selection
+      const num = parseInt(key)
+      if (num >= 1 && num <= projects.length) {
+        selectedIndex = num - 1
+        process.stdin.setRawMode(false)
+        process.stdin.removeListener('data', onKeyPress)
+
+        const selectedProject = projects[selectedIndex]
+        const level = selectedProject.level
+
+        // Clear screen
+        process.stdout.write('\x1b[2J')
+        process.stdout.write('\x1b[H')
+
+        // Check if we're in an existing Creta project
+        if (level > 0 && isInCretaProject()) {
+          unstuckProject(level).then(resolve)
+        } else {
+          createPortfolioProject(level).then(resolve)
+        }
+        return
+      }
+
       // Handle arrow keys (escape sequences)
       if (key === '\u001b[A') { // Up arrow
         selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : projects.length - 1
@@ -1648,6 +1798,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/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"]
       }
     ]
   }