@icarusmx/creta 1.5.12 → 1.5.14

package/bin/creta.js

@@ -139,6 +139,34 @@ if (command.startsWith('portafolio')) {
   // Show AWS billing detective guide
   const viewer = new AWSGuideViewer()
   await viewer.start()
+} else if (command === 'aws-ec2') {
+  const subcommand = args[1]
+
+  if (subcommand === 'all') {
+    // Execute the AWS EC2 audit script
+    showLogo()
+    console.log('🔍 Ejecutando auditoría de EC2 y volúmenes EBS en todas las regiones...\n')
+
+    const __filename = fileURLToPath(import.meta.url)
+    const __dirname = path.dirname(__filename)
+    const scriptPath = path.join(__dirname, '../lib/scripts/aws-ec2-all.sh')
+
+    try {
+      execSync(`bash "${scriptPath}"`, { stdio: 'inherit' })
+    } catch (error) {
+      console.error('\n❌ Error ejecutando el script:', error.message)
+      console.log('\n💡 Asegúrate de tener AWS CLI configurado: aws configure')
+    }
+  } else if (subcommand === 'help' || !subcommand) {
+    // Show help via CommandHelpExecutor
+    const executor = new CommandHelpExecutor(['aws-ec2'])
+    await executor.execute()
+  } else {
+    console.log(`❌ Subcomando no reconocido: ${subcommand}`)
+    console.log('\nComandos disponibles:')
+    console.log('  creta aws-ec2 all   - Audita todas las regiones')
+    console.log('  creta aws-ec2 help  - Muestra ayuda')
+  }
 } else if (command === 'reset') {
   // Reset user state with confirmation
   const rl = createInterface({ input: process.stdin, output: process.stdout })
@@ -652,6 +680,8 @@ function showHelp() {
 
   console.log("📖 Documentación de comandos:")
   console.log("  creta ls             - Documentación en español del comando ls")
+  console.log("  creta grep           - Documentación en español del comando grep")
+  console.log("  creta lz             - Localiza recursos (alias de curl)")
   console.log("  creta cd             - Documentación en español del comando cd")
   console.log("  creta curl           - Documentación en español del comando curl")
   console.log("  creta git status     - Documentación en español de git status")
@@ -1875,7 +1905,7 @@ async function startVimSetupTutorial() {
 // Helper function to detect command help requests
 function isCommandHelpRequest(args) {
   // List of supported commands for help
-  const basicCommands = ['ls', 'cd', 'mkdir', 'touch', 'wc', 'curl']
+  const basicCommands = ['ls', 'cd', 'mkdir', 'touch', 'wc', 'curl', 'grep', 'lz']
   const gitCommands = ['git status', 'git add', 'git commit', 'git push', 'git log']
 
   const commandString = args.join(' ')

package/lib/data/command-help/aws-ec2.js

@@ -0,0 +1,34 @@
+export const awsEc2 = {
+  command: 'aws-ec2',
+  description: 'Herramienta para auditar instancias EC2 y volúmenes EBS en AWS - encuentra recursos olvidados que te están costando dinero',
+  usage: 'creta aws-ec2 [comando]',
+  commonOptions: [
+    {
+      flag: 'all',
+      description: 'Escanea TODAS las regiones de AWS buscando instancias EC2 y volúmenes EBS'
+    },
+    {
+      flag: 'help',
+      description: 'Muestra esta ayuda'
+    }
+  ],
+  examples: [
+    {
+      command: 'creta aws-ec2 all',
+      description: 'Audita todas las regiones - encuentra instancias y volúmenes que no conocías'
+    },
+    {
+      command: 'creta aws-ec2 help',
+      description: 'Muestra esta documentación'
+    }
+  ],
+  relatedLesson: 'AWS Billing Detective',
+  tips: [
+    'Este comando puede tardar 1-2 minutos - está escaneando ~20 regiones',
+    'Volúmenes AVAILABLE (no attached) = DINERO DESPERDICIADO cada mes',
+    'Si encuentras instancias corriendo que no conocías, ¡apágalas!',
+    'Pro tip: ejecuta esto mensualmente para evitar cargos sorpresa en tu bill de AWS',
+    'Requiere que tengas AWS CLI configurado: aws configure',
+    'El script destaca los volúmenes "AVAILABLE" porque esos son los que te cuestan sin usarlos'
+  ]
+}

package/lib/data/command-help/grep.js

@@ -0,0 +1,76 @@
+export const grep = {
+  command: 'grep',
+  description: 'Busca patrones de texto en archivos o entrada de texto',
+  usage: 'grep [opciones] "patrón" [archivo(s)]',
+  commonOptions: [
+    {
+      flag: '-i',
+      description: 'Ignora mayúsculas/minúsculas (case insensitive)'
+    },
+    {
+      flag: '-r',
+      description: 'Búsqueda recursiva en carpetas'
+    },
+    {
+      flag: '-n',
+      description: 'Muestra números de línea'
+    },
+    {
+      flag: '-v',
+      description: 'Invierte búsqueda (muestra líneas que NO coinciden)'
+    },
+    {
+      flag: '-c',
+      description: 'Cuenta líneas que coinciden'
+    },
+    {
+      flag: '-q',
+      description: 'Modo silencioso (no imprime nada, solo devuelve código de salida)'
+    },
+    {
+      flag: '-l',
+      description: 'Solo muestra nombres de archivos con coincidencias'
+    },
+    {
+      flag: '-A',
+      description: 'Muestra N líneas DESPUÉS de la coincidencia'
+    },
+    {
+      flag: '-B',
+      description: 'Muestra N líneas ANTES de la coincidencia'
+    }
+  ],
+  examples: [
+    {
+      command: 'grep "error" app.log',
+      description: 'Busca la palabra "error" en el archivo app.log'
+    },
+    {
+      command: 'grep -i "warning" *.log',
+      description: 'Busca "warning" ignorando mayúsculas en todos los .log'
+    },
+    {
+      command: 'grep -r "TODO" src/',
+      description: 'Busca "TODO" recursivamente en la carpeta src/'
+    },
+    {
+      command: 'grep -n "function" script.js',
+      description: 'Busca "function" y muestra números de línea'
+    },
+    {
+      command: 'grep -c "import" *.js',
+      description: 'Cuenta cuántas líneas tienen "import" en cada .js'
+    },
+    {
+      command: 'grep -v "test" file.txt',
+      description: 'Muestra todas las líneas que NO contienen "test"'
+    }
+  ],
+  relatedLesson: 'Pipes y redirecciones',
+  tips: [
+    'Pro tip: combina con pipes → `cat file.log | grep "error" | wc -l`',
+    'Usa comillas dobles para buscar frases: `grep "syntax error" file.js`',
+    'grep -r es tu amigo: busca en todo un proyecto rápidamente',
+    'Combina -A y -B para contexto: `grep -A 3 -B 2 "error"` muestra líneas alrededor'
+  ]
+}

package/lib/data/command-help/index.js

@@ -5,6 +5,8 @@ export { mkdir } from './mkdir.js'
 export { touch } from './touch.js'
 export { wc } from './wc.js'
 export { curl } from './curl.js'
+export { grep } from './grep.js'
+export { lz } from './lz.js'
 
 // Git commands
 export { gitStatus } from './git-status.js'
@@ -13,6 +15,9 @@ export { gitCommit } from './git-commit.js'
 export { gitPush } from './git-push.js'
 export { gitLog } from './git-log.js'
 
+// AWS commands
+export { awsEc2 } from './aws-ec2.js'
+
 // Command mapping for lookup
 export const commandMap = {
   // Basic
@@ -22,11 +27,16 @@ export const commandMap = {
   'touch': 'touch',
   'wc': 'wc',
   'curl': 'curl',
+  'grep': 'grep',
+  'lz': 'lz',
 
   // Git
   'git status': 'gitStatus',
   'git add': 'gitAdd',
   'git commit': 'gitCommit',
   'git push': 'gitPush',
-  'git log': 'gitLog'
+  'git log': 'gitLog',
+
+  // AWS
+  'aws-ec2': 'awsEc2'
 }

package/lib/data/command-help/lz.js

@@ -0,0 +1,57 @@
+export const lz = {
+  command: 'lz',
+  description: 'Localiza un recurso en la web (alias didáctico de curl)',
+  usage: 'lz [url]',
+  commonOptions: [
+    {
+      flag: '-O',
+      description: 'Guarda el archivo con su nombre original'
+    },
+    {
+      flag: '-o archivo',
+      description: 'Guarda el contenido en el archivo especificado'
+    },
+    {
+      flag: '-L',
+      description: 'Sigue redirecciones automáticamente'
+    },
+    {
+      flag: '-I',
+      description: 'Solo muestra los headers (encabezados)'
+    },
+    {
+      flag: '-s',
+      description: 'Modo silencioso (no muestra progreso)'
+    }
+  ],
+  examples: [
+    {
+      command: 'lz icarus.mx/README.md',
+      description: 'Localiza y muestra el contenido del README'
+    },
+    {
+      command: 'lz -O icarus.mx/logo.png',
+      description: 'Descarga logo.png con su nombre original'
+    },
+    {
+      command: 'lz -o mi-archivo.json api.ejemplo.com/data',
+      description: 'Guarda la respuesta en mi-archivo.json'
+    },
+    {
+      command: 'lz -I icarus.mx',
+      description: 'Muestra solo los headers del sitio'
+    },
+    {
+      command: 'lz -sL api.ejemplo.com | grep "version"',
+      description: 'Busca "version" en la respuesta (silencioso + sigue redirects)'
+    }
+  ],
+  relatedLesson: 'Curl y pipes',
+  tips: [
+    '🧠 lz = "localiza recurso" - Alias en español para curl',
+    'curl significa "Client URL" - Cliente para Localizar Recursos Universales',
+    'Lo "universal" viene del protocolo HTTP (HyperText Transfer Protocol)',
+    'En la terminal real usa curl, pero lz te ayuda a pensar en español',
+    'Pro tip: lz es perfecto para probar APIs rápidamente'
+  ]
+}

package/lib/executors/CommandHelpExecutor.js

@@ -79,15 +79,20 @@ export class CommandHelpExecutor {
     console.log('')
 
     console.log(chalk.bold('  Básicos:'))
-    console.log(chalk.cyan('    ls, cd, mkdir, touch, wc'))
+    console.log(chalk.cyan('    ls, cd, mkdir, touch, wc, curl'))
     console.log('')
 
     console.log(chalk.bold('  Git:'))
     console.log(chalk.cyan('    git status, git add, git commit, git push, git log'))
     console.log('')
 
+    console.log(chalk.bold('  AWS:'))
+    console.log(chalk.cyan('    aws-ec2'))
+    console.log('')
+
     console.log(chalk.dim('💡 Ejemplo: creta ls'))
     console.log(chalk.dim('💡 Ejemplo: creta git status'))
+    console.log(chalk.dim('💡 Ejemplo: creta aws-ec2'))
     console.log('')
   }
 }

package/lib/exercises/.claude/settings.local.json

@@ -0,0 +1,12 @@
+{
+  "permissions": {
+    "allow": [
+      "Read(//Users/guillermo/icarus/creta/cli/bin/**)",
+      "Read(//Users/guillermo/icarus/creta/cli/**)",
+      "Bash(chmod:*)",
+      "Bash(/Users/guillermo/icarus/creta/cli/lib/exercises/test-curl-examples.sh)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}