@icarusmx/creta 1.5.7 → 1.5.9

package/bin/creta.js

@@ -12,6 +12,7 @@ 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'
+import { executeSintaxis } from '../lib/executors/sintaxis-executor.js'
 import { LessonBuilder } from '../lib/builders/LessonBuilder.js'
 import { LESSON_1_SYSTEM_DECOMPOSITION } from '../lib/data/lessons/lesson1-system-decomposition.js'
 import { LESSON_2_OBJECT_REQUESTS } from '../lib/data/lessons/lesson2-object-requests.js'
@@ -84,7 +85,7 @@ console.log(`
 █   █   █   █   █   █   █
 █████████████████████████
 
-Bienvenido a la escuela de software de icarus.mx
+Bienvenido al taller de software
 Salgamos de este laberinto 🏛️
 `)
 
@@ -106,6 +107,9 @@ if (command.startsWith('portafolio')) {
 } else if (command === 'enunciados') {
   // Start enunciados selector
   await startEnunciadosSelector()
+} else if (command === 'sintaxis') {
+  // Start sintaxis selector with interactive sandbox lessons
+  await startSintaxisSelector()
 } else if (command === 'code') {
   // Start interactive coding session
   const session = new CretaCodeSession()
@@ -607,20 +611,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 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")
-  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() {
@@ -696,7 +707,7 @@ Salgamos de este laberinto 🏛️
       if (key === 'q' || key === '\x03') { // q or Ctrl+C
         process.stdin.setRawMode(false)
         process.stdin.removeListener('data', onKeyPress)
-        console.log("\nHecho con <3 por icarus.mx")
+        console.log("\nHecho con <3")
         resolve()
         return
       }
@@ -727,6 +738,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
@@ -766,7 +817,7 @@ async function startMainMenuFallback() {
     const respuesta = await askQuestion("Elige una opción (1-5) o 'q' para salir: ")
 
     if (respuesta.toLowerCase() === 'q') {
-      console.log("Hecho con <3 por icarus.mx")
+      console.log("Hecho con <3")
       rl.close()
       return
     }
@@ -889,7 +940,7 @@ async function startEnunciadosSelectorInteractive() {
       if (key === 'q' || key === '\x03') { // q or Ctrl+C
         process.stdin.setRawMode(false)
         process.stdin.removeListener('data', onKeyPress)
-        console.log("\nHecho con <3 por icarus.mx")
+        console.log("\nHecho con <3")
         resolve()
         return
       }
@@ -1047,6 +1098,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
@@ -1099,7 +1171,7 @@ async function startEnunciadosSelectorFallback() {
     const respuesta = await askQuestion("Elige un número (1-7) o 'q' para salir: ")
 
     if (respuesta.toLowerCase() === 'q') {
-      console.log("Hecho con <3 por icarus.mx")
+      console.log("Hecho con <3")
       rl.close()
       return
     }
@@ -1262,33 +1334,7 @@ async function startEnunciadosSelectorFallback() {
 
 
 async function startSintaxisSelector() {
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout
-  })
-
-  console.log("Sintaxis: estudia el modo en que se combinan las palabras y los distintos grupos que forman para expresar significado.")
-
-  await new Promise((resolve) => {
-    rl.question("\nPresiona Enter para comenzar...", () => {
-      rl.close()
-      resolve()
-    })
-  })
-
-  console.log("\nEn esta sección aprenderemos algo más que palabras, aprenderemos comandos.")
-  console.log("")
-  console.log("Al final del día un comando es una palabra, la diferencia es que está dotada de un significado que tu computadora entiende.")
-  console.log("")
-  console.log("🚀 Próximamente:")
-  console.log("- Terminal básico (pwd, ls, cd, mkdir, touch, cat)")
-  console.log("- Git básico (init, status, add, commit)")
-  console.log("- Git colaboración (remote, push, pull, clone)")
-  console.log("- Git avanzado (branch, checkout, merge)")
-  console.log("")
-  console.log("Este es tu primer comando: ls")
-  console.log("")
-  console.log("Presiona ctrl + c para terminar esta sesión y después ejecuta el comando ls en tu terminal")
+  await executeSintaxis()
 }
 
 async function startProyectosSelector() {
@@ -1354,7 +1400,7 @@ async function startProyectosSelectorInteractive() {
       if (key === 'q' || key === '\x03') { // q or Ctrl+C
         process.stdin.setRawMode(false)
         process.stdin.removeListener('data', onKeyPress)
-        console.log("\nHecho con <3 por icarus.mx")
+        console.log("\nHecho con <3")
         resolve()
         return
       }
@@ -1379,6 +1425,40 @@ async function startProyectosSelectorInteractive() {
         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
+      }
+
       // Handle arrow keys (escape sequences)
       if (key === '\u001b[A') { // Up arrow
         selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : projects.length - 1
@@ -1416,7 +1496,7 @@ async function returnToMainMenu() {
     console.clear()
     await startMainMenu()
   } else {
-    console.log("\nHecho con <3 por icarus.mx")
+    console.log("\nHecho con <3")
     rl.close()
   }
 }
@@ -1445,7 +1525,7 @@ async function startProyectosSelectorFallback() {
     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")
+      console.log("Hecho con <3")
       rl.close()
       return
     }
@@ -1540,7 +1620,7 @@ async function startPortfolioSelectorInteractive() {
       if (key === 'q' || key === '\x03') { // q or Ctrl+C
         process.stdin.setRawMode(false)
         process.stdin.removeListener('data', onKeyPress)
-        console.log("\nHecho con <3 por icarus.mx")
+        console.log("\nHecho con <3")
         resolve()
         return
       }
@@ -1565,6 +1645,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
@@ -1604,7 +1718,7 @@ async function startPortfolioSelectorFallback() {
     const respuesta = await askQuestion("Elige una opción (1-4) o 'q' para salir: ")
 
     if (respuesta.toLowerCase() === 'q') {
-      console.log("Hecho con <3 por icarus.mx")
+      console.log("Hecho con <3")
       rl.close()
       return
     }

package/lib/cli/index.js

@@ -16,7 +16,7 @@ async function executeMainMenu() {
   while (true) {
     const choice = await menu.show()
     if (!choice) {
-      console.log('\nHecho con <3 por icarus.mx')
+      console.log('\nHecho con <3')
       return
     }
 

package/lib/data/messages.js

@@ -5,7 +5,7 @@ export const WELCOME_BANNER = `
 █   █   █   █   █   █   █
 █████████████████████████
 
-Bienvenido a la escuela de software de icarus.mx
+Bienvenido al taller de software
 Salgamos de este laberinto 🏛️
 `
 

package/lib/executors/ExercisesExecutor.js

@@ -99,7 +99,7 @@ export class ExercisesExecutor {
         if (key === 'q' || key === '\x03') { // q or Ctrl+C
           process.stdin.setRawMode(false)
           process.stdin.removeListener('data', onKeyPress)
-          console.log("\nHecho con <3 por icarus.mx")
+          console.log("\nHecho con <3")
           resolve()
           return
         }
@@ -163,7 +163,7 @@ export class ExercisesExecutor {
       const respuesta = await askQuestion(`Elige una opción (1-${this.exercises.length}) o 'q' para salir: `)
 
       if (respuesta.toLowerCase() === 'q') {
-        console.log("Hecho con <3 por icarus.mx")
+        console.log("Hecho con <3")
         rl.close()
         return
       }

package/lib/papers/PapersExecutor.js

@@ -86,7 +86,7 @@ export class PapersExecutor {
         if (key === 'q' || key === '\x03') {
           process.stdin.setRawMode(false)
           process.stdin.removeListener('data', onKeyPress)
-          console.log(chalk.dim('\nHecho con <3 por icarus.mx'))
+          console.log(chalk.dim('\nHecho con <3'))
           resolve()
           return
         }
@@ -179,7 +179,7 @@ export class PapersExecutor {
       const answer = await askQuestion('Elige un número (1-3) o \'q\' para salir: ')
 
       if (answer.toLowerCase() === 'q') {
-        console.log(chalk.dim('\nHecho con <3 por icarus.mx'))
+        console.log(chalk.dim('\nHecho con <3'))
         rl.close()
         return
       }

package/lib/vim-setup-tutorial.js

@@ -346,7 +346,7 @@ export class VimSetupTutorial {
     console.log('  • Creta CLI: ' + chalk.yellow('creta') + ' (este programa)')
     console.log('  • Comunidad Icarus: https://icarus.mx')
 
-    console.log('\n' + chalk.gray('Hecho con <3 por icarus.mx') + ' - Salgamos de este laberinto 🏛️')
+    console.log('\n' + chalk.gray('Hecho con <3') + ' - Salgamos de este laberinto 🏛️')
     console.log()
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icarusmx/creta",
-  "version": "1.5.7",
+  "version": "1.5.9",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {