@icarusmx/creta 1.5.1 → 1.5.4

package/bin/creta.js

@@ -9,13 +9,15 @@ import { CretaCodeSession } from '../lib/session.js'
 import { PullRequestTutorial } from '../lib/pr-tutorial.js'
 import { CommandHelpExecutor } from '../lib/executors/CommandHelpExecutor.js'
 import { PapersExecutor } from '../lib/papers/PapersExecutor.js'
-import { Lesson1SystemDecomposition } from '../lessons/lesson1-system-decomposition.js'
-import { Lesson2ObjectRequests } from '../lessons/lesson2-object-requests.js'
-import { Lesson3OnlyWay } from '../lessons/lesson3-only-way.js'
-import { Lesson4OperationSignatures } from '../lessons/lesson4-operation-signatures.js'
-import { Lesson5InterfaceSet } from '../lessons/lesson5-interface-set.js'
-import { Lesson6InterfaceDesign } from '../lessons/lesson6-interface-design.js'
-import { Lesson7ObjectDefinition } from '../lessons/lesson7-object-definition.js'
+import { ExercisesExecutor } from '../lib/executors/ExercisesExecutor.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'
+import { LESSON_3_ONLY_WAY } from '../lib/data/lessons/lesson3-only-way.js'
+import { LESSON_4_OPERATION_SIGNATURES } from '../lib/data/lessons/lesson4-operation-signatures.js'
+import { LESSON_5_INTERFACE_SET } from '../lib/data/lessons/lesson5-interface-set.js'
+import { LESSON_6_INTERFACE_DESIGN } from '../lib/data/lessons/lesson6-interface-design.js'
+import { LESSON_7_OBJECT_DEFINITION } from '../lib/data/lessons/lesson7-object-definition.js'
 
 const ENUNCIADOS = [
   {
@@ -637,7 +639,8 @@ async function startMainMenuInteractive() {
     { id: 1, title: "Aprender sintaxis" },
     { id: 2, title: "Aprender conceptos de diseño" },
     { id: 3, title: "Construir proyectos" },
-    { id: 4, title: "📄 Recrear papers clásicos" }
+    { id: 4, title: "Recrear papers clásicos" },
+    { id: 5, title: "Practicar con ejercicios" }
   ]
 
   let selectedIndex = 0
@@ -710,6 +713,9 @@ Salgamos de este laberinto 🏛️
         } 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
       }
@@ -746,10 +752,11 @@ async function startMainMenuFallback() {
     console.log("1. Aprender sintaxis")
     console.log("2. Aprender conceptos de diseño")
     console.log("3. Construir proyectos")
-    console.log("4. 📄 Recrear papers clásicos")
+    console.log("4. Recrear papers clásicos")
+    console.log("5. Practicar con ejercicios")
     console.log("")
 
-    const respuesta = await askQuestion("Elige una opción (1-4) o 'q' para salir: ")
+    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")
@@ -772,8 +779,12 @@ async function startMainMenuFallback() {
       rl.close()
       const executor = new PapersExecutor()
       await executor.execute()
+    } else if (opcionSeleccionada === 5) {
+      rl.close()
+      const executor = new ExercisesExecutor()
+      await executor.execute()
     } else {
-      console.log("❌ Opción no válida. Elige 1, 2, 3 o 4.")
+      console.log("❌ Opción no válida. Elige 1, 2, 3, 4 o 5.")
       rl.close()
     }
 
@@ -892,7 +903,7 @@ async function startEnunciadosSelectorInteractive() {
           await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
           try {
-            const lesson1 = new Lesson1SystemDecomposition()
+            const lesson1 = new LessonBuilder(LESSON_1_SYSTEM_DECOMPOSITION)
             await lesson1.start()
             await returnToMainMenu()
           } catch (error) {
@@ -908,7 +919,7 @@ async function startEnunciadosSelectorInteractive() {
           await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
           try {
-            const lesson1 = new Lesson1SystemDecomposition()
+            const lesson1 = new LessonBuilder(LESSON_1_SYSTEM_DECOMPOSITION)
             await lesson1.start()
             await returnToMainMenu()
           } catch (error) {
@@ -924,7 +935,7 @@ async function startEnunciadosSelectorInteractive() {
           await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
           try {
-            const lesson2 = new Lesson2ObjectRequests()
+            const lesson2 = new LessonBuilder(LESSON_2_OBJECT_REQUESTS)
             await lesson2.start()
             await returnToMainMenu()
           } catch (error) {
@@ -940,7 +951,7 @@ async function startEnunciadosSelectorInteractive() {
           await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
           try {
-            const lesson3 = new Lesson3OnlyWay()
+            const lesson3 = new LessonBuilder(LESSON_3_ONLY_WAY)
             await lesson3.start()
             await returnToMainMenu()
           } catch (error) {
@@ -956,7 +967,7 @@ async function startEnunciadosSelectorInteractive() {
           await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
           try {
-            const lesson4 = new Lesson4OperationSignatures()
+            const lesson4 = new LessonBuilder(LESSON_4_OPERATION_SIGNATURES)
             await lesson4.start()
             await returnToMainMenu()
           } catch (error) {
@@ -972,7 +983,7 @@ async function startEnunciadosSelectorInteractive() {
           await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
           try {
-            const lesson5 = new Lesson5InterfaceSet()
+            const lesson5 = new LessonBuilder(LESSON_5_INTERFACE_SET)
             await lesson5.start()
             await returnToMainMenu()
           } catch (error) {
@@ -988,7 +999,7 @@ async function startEnunciadosSelectorInteractive() {
           await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
           try {
-            const lesson6 = new Lesson6InterfaceDesign()
+            const lesson6 = new LessonBuilder(LESSON_6_INTERFACE_DESIGN)
             await lesson6.start()
             await returnToMainMenu()
           } catch (error) {
@@ -1004,7 +1015,7 @@ async function startEnunciadosSelectorInteractive() {
           await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
           try {
-            const lesson7 = new Lesson7ObjectDefinition()
+            const lesson7 = new LessonBuilder(LESSON_7_OBJECT_DEFINITION)
             await lesson7.start()
             await returnToMainMenu()
           } catch (error) {
@@ -1098,7 +1109,7 @@ async function startEnunciadosSelectorFallback() {
         await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
         try {
-          const lesson1 = new Lesson1SystemDecomposition()
+          const lesson1 = new LessonBuilder(LESSON_1_SYSTEM_DECOMPOSITION)
           await lesson1.start()
         } catch (error) {
           console.error("\n❌ Error al ejecutar la lección:", error.message)
@@ -1114,7 +1125,7 @@ async function startEnunciadosSelectorFallback() {
         await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
         try {
-          const lesson1 = new Lesson1SystemDecomposition()
+          const lesson1 = new LessonBuilder(LESSON_1_SYSTEM_DECOMPOSITION)
           await lesson1.start()
         } catch (error) {
           console.error("\n❌ Error al ejecutar la lección:", error.message)
@@ -1130,7 +1141,7 @@ async function startEnunciadosSelectorFallback() {
         await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
         try {
-          const lesson2 = new Lesson2ObjectRequests()
+          const lesson2 = new LessonBuilder(LESSON_2_OBJECT_REQUESTS)
           await lesson2.start()
         } catch (error) {
           console.error("\n❌ Error al ejecutar la lección:", error.message)
@@ -1146,7 +1157,7 @@ async function startEnunciadosSelectorFallback() {
         await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
         try {
-          const lesson3 = new Lesson3OnlyWay()
+          const lesson3 = new LessonBuilder(LESSON_3_ONLY_WAY)
           await lesson3.start()
         } catch (error) {
           console.error("\n❌ Error al ejecutar la lección:", error.message)
@@ -1162,7 +1173,7 @@ async function startEnunciadosSelectorFallback() {
         await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
         try {
-          const lesson4 = new Lesson4OperationSignatures()
+          const lesson4 = new LessonBuilder(LESSON_4_OPERATION_SIGNATURES)
           await lesson4.start()
         } catch (error) {
           console.error("\n❌ Error al ejecutar la lección:", error.message)
@@ -1178,7 +1189,7 @@ async function startEnunciadosSelectorFallback() {
         await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
         try {
-          const lesson5 = new Lesson5InterfaceSet()
+          const lesson5 = new LessonBuilder(LESSON_5_INTERFACE_SET)
           await lesson5.start()
         } catch (error) {
           console.error("\n❌ Error al ejecutar la lección:", error.message)
@@ -1194,7 +1205,7 @@ async function startEnunciadosSelectorFallback() {
         await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
         try {
-          const lesson6 = new Lesson6InterfaceDesign()
+          const lesson6 = new LessonBuilder(LESSON_6_INTERFACE_DESIGN)
           await lesson6.start()
         } catch (error) {
           console.error("\n❌ Error al ejecutar la lección:", error.message)
@@ -1210,7 +1221,7 @@ async function startEnunciadosSelectorFallback() {
         await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
         try {
-          const lesson7 = new Lesson7ObjectDefinition()
+          const lesson7 = new LessonBuilder(LESSON_7_OBJECT_DEFINITION)
           await lesson7.start()
         } catch (error) {
           console.error("\n❌ Error al ejecutar la lección:", error.message)

package/lib/executors/ExercisesExecutor.js

@@ -0,0 +1,271 @@
+import { createInterface } from 'readline'
+import { execSync } from 'child_process'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import fs from 'fs'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+export class ExercisesExecutor {
+  constructor() {
+    this.exercises = [
+      {
+        id: 1,
+        title: "Array & Object Manipulation Warmups",
+        description: "JavaScript fundamentals with LazyVim tips",
+        file: "array-object-manipulation.md",
+        lines: 1282,
+        topics: ["JavaScript", "Arrays", "Objects", "LazyVim"]
+      },
+      {
+        id: 2,
+        title: "Git Stash Workflow",
+        description: "Wrong branch recovery patterns",
+        file: "git-stash-workflow.md",
+        lines: 427,
+        topics: ["Git", "Stash", "Branching", "Workflow"]
+      },
+      {
+        id: 3,
+        title: "Railway Deployment Guide",
+        description: "Deploy Node.js apps with Railway CLI",
+        file: "railway-deployment.md",
+        lines: 500,
+        topics: ["Railway", "Deployment", "Node.js", "DevOps"]
+      }
+    ]
+  }
+
+  async execute() {
+    // Check if setRawMode is available
+    if (typeof process.stdin.setRawMode === 'function') {
+      return await this.executeInteractive()
+    } else {
+      return await this.executeFallback()
+    }
+  }
+
+  async executeInteractive() {
+    console.log("\n📝 Ejercicios de Práctica")
+    console.log("Elige qué ejercicio quieres practicar:")
+    console.log("")
+
+    let selectedIndex = 0
+
+    // Enable raw mode
+    process.stdin.setRawMode(true)
+    process.stdin.resume()
+    process.stdin.setEncoding('utf8')
+
+    const renderOptions = () => {
+      // Clear screen
+      process.stdout.write('\x1b[2J')
+      process.stdout.write('\x1b[H')
+
+      console.log("📝 Ejercicios de Práctica")
+      console.log("Elige qué ejercicio quieres practicar:")
+      console.log("")
+
+      this.exercises.forEach((exercise, index) => {
+        const isSelected = index === selectedIndex
+        const prefix = isSelected ? '▶ ' : '  '
+        const highlight = isSelected ? '\x1b[36m' : '\x1b[37m'
+        const reset = '\x1b[0m'
+
+        console.log(`${highlight}${prefix}${exercise.id}. ${exercise.title}${reset}`)
+        if (isSelected) {
+          console.log(`${highlight}     ${exercise.description} (${exercise.lines} líneas)${reset}`)
+        }
+        console.log("")
+      })
+
+      console.log("\n💡 Tip: Estos archivos están optimizados para LazyVim")
+      console.log("   Usa 'nvim' para abrirlos y aprovechar los fold markers")
+    }
+
+    return new Promise((resolve) => {
+      renderOptions()
+
+      const onKeyPress = async (key) => {
+        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")
+          resolve()
+          return
+        }
+
+        if (key === '\r' || key === '\n') { // Enter
+          process.stdin.setRawMode(false)
+          process.stdin.removeListener('data', onKeyPress)
+
+          const selectedExercise = this.exercises[selectedIndex]
+
+          // Clear screen
+          process.stdout.write('\x1b[2J')
+          process.stdout.write('\x1b[H')
+
+          await this.openExercise(selectedExercise)
+          resolve()
+          return
+        }
+
+        // Arrow keys
+        if (key === '\u001b[A') { // Up
+          selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : this.exercises.length - 1
+          renderOptions()
+        } else if (key === '\u001b[B') { // Down
+          selectedIndex = selectedIndex < this.exercises.length - 1 ? selectedIndex + 1 : 0
+          renderOptions()
+        }
+      }
+
+      process.stdin.on('data', onKeyPress)
+    })
+  }
+
+  async executeFallback() {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+
+    const askQuestion = (question) => {
+      return new Promise((resolve) => {
+        rl.question(question, resolve)
+      })
+    }
+
+    try {
+      console.log("\n📝 Ejercicios de Práctica")
+      console.log("Elige qué ejercicio quieres practicar:")
+      console.log("")
+
+      this.exercises.forEach((exercise) => {
+        console.log(`${exercise.id}. ${exercise.title}`)
+        console.log(`   ${exercise.description} (${exercise.lines} líneas)`)
+        console.log("")
+      })
+
+      console.log("💡 Tip: Estos archivos están optimizados para LazyVim")
+      console.log("   Usa 'nvim' para abrirlos y aprovechar los fold markers")
+      console.log("")
+
+      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")
+        rl.close()
+        return
+      }
+
+      const opcionSeleccionada = parseInt(respuesta)
+
+      if (opcionSeleccionada >= 1 && opcionSeleccionada <= this.exercises.length) {
+        const selectedExercise = this.exercises[opcionSeleccionada - 1]
+        rl.close()
+        await this.openExercise(selectedExercise)
+      } else {
+        console.log(`❌ Opción no válida. Elige un número entre 1 y ${this.exercises.length}.`)
+        rl.close()
+      }
+
+    } catch (error) {
+      console.error('Error:', error.message)
+      rl.close()
+      process.exit(1)
+    }
+  }
+
+  async openExercise(exercise) {
+    const exercisePath = path.join(__dirname, '..', 'exercises', exercise.file)
+
+    console.log(`\n📖 ${exercise.title}`)
+    console.log("=" .repeat(50))
+    console.log("")
+    console.log(`📍 Ubicación: ${exercisePath}`)
+    console.log(`📊 Líneas: ${exercise.lines}`)
+    console.log(`🏷️  Temas: ${exercise.topics.join(', ')}`)
+    console.log("")
+
+    // Check if file exists
+    if (!fs.existsSync(exercisePath)) {
+      console.log(`❌ Error: No se encontró el archivo ${exercise.file}`)
+      console.log("")
+      console.log("💡 Tip: Asegúrate de estar ejecutando Creta desde el directorio correcto")
+      return
+    }
+
+    console.log("📚 Opciones:")
+    console.log("")
+    console.log("1. Abrir con nvim (recomendado para aprovechar fold markers)")
+    console.log("2. Mostrar la ruta (copiar al portapapeles)")
+    console.log("3. Ver los primeros 20 líneas")
+    console.log("")
+
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+
+    const askQuestion = (question) => {
+      return new Promise((resolve) => {
+        rl.question(question, resolve)
+      })
+    }
+
+    const choice = await askQuestion("Elige una opción (1-3) o Enter para abrir con nvim: ")
+    rl.close()
+
+    if (choice === '' || choice === '1') {
+      // Open with nvim
+      console.log("\n🚀 Abriendo con nvim...")
+      console.log("💡 Tip: Usa 'zM' para cerrar todos los folds y ver la estructura")
+      console.log("")
+
+      try {
+        // Try to open with nvim
+        execSync(`nvim "${exercisePath}"`, { stdio: 'inherit' })
+      } catch (error) {
+        console.log("\n⚠️  No se pudo abrir nvim. Intentando con el editor por defecto...")
+        try {
+          execSync(`$EDITOR "${exercisePath}" || vi "${exercisePath}"`, { stdio: 'inherit' })
+        } catch (fallbackError) {
+          console.log("\n❌ No se pudo abrir ningún editor.")
+          console.log(`📍 Abre manualmente: ${exercisePath}`)
+        }
+      }
+    } else if (choice === '2') {
+      // Show path
+      console.log("\n📋 Ruta copiada al portapapeles (en algunos sistemas):")
+      console.log(exercisePath)
+      console.log("")
+      console.log("💡 Tip: Usa este comando para abrirlo:")
+      console.log(`   nvim "${exercisePath}"`)
+
+      // Try to copy to clipboard (macOS)
+      try {
+        execSync(`echo "${exercisePath}" | pbcopy`, { stdio: 'ignore' })
+        console.log("✓ Ruta copiada al portapapeles (macOS)")
+      } catch (error) {
+        // Silently fail if pbcopy not available
+      }
+    } else if (choice === '3') {
+      // Show preview
+      console.log("\n📄 Primeras 20 líneas:")
+      console.log("=" .repeat(50))
+      try {
+        const preview = execSync(`head -20 "${exercisePath}"`, { encoding: 'utf8' })
+        console.log(preview)
+      } catch (error) {
+        console.log("❌ Error al leer el archivo")
+      }
+      console.log("=" .repeat(50))
+      console.log("")
+      console.log(`💡 Abre el archivo completo con: nvim "${exercisePath}"`)
+    }
+
+    console.log("")
+  }
+}

package/lib/utils/user-state.js

@@ -66,6 +66,7 @@ export class UserState {
 
   static setName(name) {
     const state = loadState()
+    if (!state) return null
     state.name = name
     saveState(state)
     return state
@@ -73,6 +74,18 @@ export class UserState {
 
   static updateLastSeen() {
     const state = loadState()
+    if (!state) {
+      console.error('Warning: Could not load user state')
+      return {
+        name: null,
+        createdAt: new Date().toISOString(),
+        lessonsCompleted: [],
+        projectsCreated: [],
+        discord: null,
+        stats: { totalSessions: 0, lastSeen: null },
+        lastSeen: null
+      }
+    }
     const now = new Date().toISOString()
     state.lastSeen = now
     state.stats = state.stats || { totalSessions: 0, lastSeen: null }
@@ -84,6 +97,7 @@ export class UserState {
 
   static addCompletedLesson(lessonId) {
     const state = loadState()
+    if (!state) return null
     const alreadyCompleted = state.lessonsCompleted.some(
       lesson => typeof lesson === 'object' ? lesson.id === lessonId : lesson === lessonId
     )
@@ -100,6 +114,7 @@ export class UserState {
 
   static addProject(projectName) {
     const state = loadState()
+    if (!state) return null
     state.projectsCreated = state.projectsCreated || []
     state.projectsCreated.push({
       name: projectName,

package/package.json

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