@icarusmx/creta 1.4.2 → 1.4.4

package/lib/builders/LessonBuilder.js

@@ -20,11 +20,6 @@ export class LessonBuilder {
     try {
       const flow = this.collectActions()
       await this.executeActions(flow)
-
-      // Track lesson completion if lesson has an ID
-      if (this.lesson.id) {
-        UserState.completLesson(this.lesson.id)
-      }
     } finally {
       this.rl.close()
       this.rl = null
@@ -377,6 +372,11 @@ export class LessonBuilder {
     console.log('')
     console.log(`  ✓ ${action.message}`)
 
+    // Track lesson completion
+    if (this.lesson.id) {
+      UserState.addCompletedLesson(this.lesson.id)
+    }
+
     if (action.unlocked) {
       await new Promise(resolve => setTimeout(resolve, 300))
       console.log(`  🔓 Desbloqueaste: ${action.unlocked}`)

package/lib/builders/MenuBuilder.js

@@ -4,6 +4,7 @@ import { clearConsole } from '../utils/output.js'
 export class MenuBuilder {
   constructor(config) {
     this.config = config
+    this.firstRender = true
   }
 
   async show() {
@@ -23,8 +24,13 @@ export class MenuBuilder {
     }
   }
 
-  renderHeader() {
-    clearConsole()
+  renderHeader(skipClear = false) {
+    // Skip clear on first render if config says so, or if explicitly told to skip
+    const shouldClear = skipClear ? false : (this.firstRender ? this.config.clearConsole !== false : true)
+
+    if (shouldClear) {
+      clearConsole()
+    }
 
     if (this.config.banner) {
       console.log(this.config.banner)
@@ -41,6 +47,8 @@ export class MenuBuilder {
     if (this.config.title) {
       console.log(this.config.title)
     }
+
+    this.firstRender = false
   }
 
   renderOption(option, isSelected, index) {
@@ -65,12 +73,29 @@ export class MenuBuilder {
     }
 
     let selectedIndex = 0
+    let lineCount = 0
+
+    const render = (isFirstRender = false) => {
+      if (!isFirstRender && lineCount > 0) {
+        // Move cursor up and clear previous render
+        process.stdout.write(`\x1b[${lineCount}A`)
+        process.stdout.write('\x1b[0J')
+      }
 
-    const render = () => {
-      this.renderHeader()
+      // Never clear in renderHeader when doing cursor-based rendering
+      this.renderHeader(true)
       this.config.options.forEach((option, index) => {
         this.renderOption(option, index === selectedIndex, index)
       })
+
+      // Count lines for next render (approximate)
+      lineCount = 2 // title line + blank
+      if (this.config.description) {
+        lineCount += Array.isArray(this.config.description) ? this.config.description.length + 1 : 2
+      }
+      this.config.options.forEach(option => {
+        lineCount += option.description ? 3 : 2 // option + optional description + blank
+      })
     }
 
     return new Promise((resolve) => {
@@ -107,7 +132,7 @@ export class MenuBuilder {
       }
 
       process.stdin.on('data', onKeyPress)
-      render()
+      render(true)
     })
   }
 

package/lib/cli/index.js

@@ -1,5 +1,5 @@
 import { MenuBuilder } from '../builders/MenuBuilder.js'
-import { MAIN_MENU_CONFIG } from '../data/menus.js'
+import { getMainMenuConfig } from '../data/menus.js'
 import { executeEnunciados } from '../executors/enunciados-executor.js'
 import { executeProyectos } from '../executors/proyectos-executor.js'
 import { executeSintaxis } from '../executors/sintaxis-executor.js'
@@ -9,7 +9,7 @@ import { CretaCodeSession } from '../session.js'
 import { greetUser } from '../utils/greeting.js'
 
 async function executeMainMenu() {
-  const menu = new MenuBuilder(MAIN_MENU_CONFIG)
+  const menu = new MenuBuilder(getMainMenuConfig())
 
   while (true) {
     const choice = await menu.show()
@@ -33,12 +33,19 @@ async function runCodeSession() {
   await session.start()
 }
 
+async function resetUserState() {
+  const { UserState } = await import('../utils/user-state.js')
+  UserState.reset()
+  console.log('✅ Estado de usuario reiniciado. La próxima vez que ejecutes creta, se te pedirá tu nombre de nuevo.')
+}
+
 const COMMANDS = new Map([
   ['enunciados', () => executeEnunciados()],
   ['sintaxis', () => executeSintaxis()],
   ['proyectos', () => executeProyectos()],
   ['portafolio', () => executePortfolio(0)],
   ['code', () => runCodeSession()],
+  ['reset', () => resetUserState()],
   ['help', () => showHelp()],
   ['ayuda', () => showHelp()]
 ])
@@ -72,8 +79,10 @@ export async function handleCommand(command, args = []) {
 export async function runCLI(args = []) {
   const [command, ...rest] = args
 
-  // Greet user (ask name if first time, or show stats if returning)
-  await greetUser()
+  // Skip greeting for reset command
+  if (command !== 'reset') {
+    await greetUser()
+  }
 
   if (!command) {
     await executeMainMenu()

package/lib/data/lessons/lesson1-system-decomposition.js

@@ -115,13 +115,27 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
       type: 'text'
     },
     {
-      code: 'interface Book {\n' +
-        '  isAvailable(): boolean\n' +
-        '  markAsLoaned(): void\n' +
-        '  markAsReturned(): void\n' +
+      code: 'class Book {\n' +
+        '  constructor(title, author, isbn) {\n' +
+        '    this.title = title\n' +
+        '    this.author = author\n' +
+        '    this.isbn = isbn\n' +
+        '    this.isLoaned = false\n' +
+        '  }\n' +
+        '\n' +
+        '  isAvailable() {\n' +
+        '    return !this.isLoaned\n' +
+        '  }\n' +
+        '\n' +
+        '  markAsLoaned() {\n' +
+        '    this.isLoaned = true\n' +
+        '  }\n' +
+        '\n' +
+        '  markAsReturned() {\n' +
+        '    this.isLoaned = false\n' +
+        '  }\n' +
         '}',
-      title: '📄 Objeto: Book',
-      after: 'Responsabilidad: Conocer su propio estado de disponibilidad',
+      title: '📄 Clase Book',
       type: 'code'
     },
     {
@@ -129,13 +143,28 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
       type: 'pause'
     },
     {
-      code: 'interface User {\n' +
-        '  canBorrow(): boolean\n' +
-        '  addLoan(loan: Loan): void\n' +
-        '  removeLoan(loan: Loan): void\n' +
+      code: 'class User {\n' +
+        '  constructor(name, email, maxLoans = 3) {\n' +
+        '    this.name = name\n' +
+        '    this.email = email\n' +
+        '    this.maxLoans = maxLoans\n' +
+        '    this.currentLoans = []\n' +
+        '  }\n' +
+        '\n' +
+        '  canBorrow() {\n' +
+        '    return this.currentLoans.length < this.maxLoans\n' +
+        '  }\n' +
+        '\n' +
+        '  addLoan(loan) {\n' +
+        '    this.currentLoans.push(loan)\n' +
+        '  }\n' +
+        '\n' +
+        '  removeLoan(loan) {\n' +
+        '    const index = this.currentLoans.indexOf(loan)\n' +
+        '    if (index > -1) this.currentLoans.splice(index, 1)\n' +
+        '  }\n' +
         '}',
-      title: '📄 Objeto: User',
-      after: 'Responsabilidad: Conocer sus propios límites de préstamo',
+      title: '📄 Clase User',
       type: 'code'
     },
     {
@@ -143,13 +172,32 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
       type: 'pause'
     },
     {
-      code: 'interface Loan {\n' +
-        '  isOverdue(): boolean\n' +
-        '  calculateFine(): number\n' +
-        '  returnBook(): void\n' +
+      code: 'class Loan {\n' +
+        '  constructor(user, book, durationDays = 14) {\n' +
+        '    this.user = user\n' +
+        '    this.book = book\n' +
+        '    this.startDate = new Date()\n' +
+        '    this.dueDate = new Date(Date.now() + durationDays * 24 * 60 * 60 * 1000)\n' +
+        '    this.returned = false\n' +
+        '  }\n' +
+        '\n' +
+        '  isOverdue() {\n' +
+        '    return !this.returned && new Date() > this.dueDate\n' +
+        '  }\n' +
+        '\n' +
+        '  calculateFine() {\n' +
+        '    if (!this.isOverdue()) return 0\n' +
+        '    const daysLate = Math.ceil((new Date() - this.dueDate) / (24 * 60 * 60 * 1000))\n' +
+        '    return daysLate * 5 // $5 por día\n' +
+        '  }\n' +
+        '\n' +
+        '  returnBook() {\n' +
+        '    this.returned = true\n' +
+        '    this.book.markAsReturned()\n' +
+        '    this.user.removeLoan(this)\n' +
+        '  }\n' +
         '}',
-      title: '📄 Objeto: Loan',
-      after: 'Responsabilidad: Gestionar la relación temporal entre usuario y libro',
+      title: '📄 Clase Loan',
       type: 'code'
     },
     {
@@ -157,14 +205,36 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
       type: 'pause'
     },
     {
-      code: 'interface Library {\n' +
-        '  lendBook(user: User, book: Book): Loan\n' +
-        '  returnBook(loan: Loan): number\n' +
-        '  getOverdueLoans(): Loan[]\n' +
-        '}',
-      title: '📄 Objeto: Library',
-      after: 'Responsabilidad: Coordinar las operaciones del sistema',
-      type: 'code'
+      lines: [
+        '\nclass Library {',
+        '  constructor() {',
+        '    this.books = []',
+        '    this.users = []',
+        '    this.loans = []',
+        '  }',
+        '',
+        '  lendBook(user, book) {',
+        '    if (!user.canBorrow()) return null',
+        '    if (!book.isAvailable()) return null',
+        '',
+        '    const loan = new Loan(user, book)',
+        '    book.markAsLoaned()',
+        '    user.addLoan(loan)',
+        '    this.loans.push(loan)',
+        '    return loan',
+        '  }',
+        '',
+        '  returnBook(loan) {',
+        '    loan.returnBook()',
+        '    return loan.calculateFine()',
+        '  }',
+        '',
+        '  getOverdueLoans() {',
+        '    return this.loans.filter(loan => loan.isOverdue())',
+        '  }',
+        '}'
+      ],
+      type: 'text'
     },
     {
       message: '\nPresiona Enter para ver la interacción...',
@@ -175,29 +245,25 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
     },
     {
       lines: [
-        '🔄 Interacciones entre objetos:',
-        '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+        'Ejemplo de uso:',
         '',
-        '1. Library solicita a User:',
-        '   → user.canBorrow()',
-        '   ← responde: true/false',
+        'const library = new Library()',
+        "const book = new Book('1984', 'George Orwell', '978-0451524935')",
+        "const user = new User('Ana García', 'ana@email.com')",
         '',
-        '2. Library solicita a Book:',
-        '   → book.isAvailable()',
-        '   ← responde: true/false',
+        '// Los objetos interactúan entre sí',
+        'const loan = library.lendBook(user, book)',
+        'console.log(book.isAvailable())  // false',
+        'console.log(user.canBorrow())    // true (2 préstamos disponibles)',
         '',
-        '3. Library crea Loan y coordina:',
-        '   → book.markAsLoaned()',
-        '   → user.addLoan(loan)',
+        '// Simular libro vencido',
+        'loan.dueDate = new Date(Date.now() - 24 * 60 * 60 * 1000)',
+        'console.log(loan.isOverdue())    // true',
+        'console.log(loan.calculateFine()) // 5',
         '',
-        '4. Al devolver, Library solicita a Loan:',
-        '   → loan.isOverdue()',
-        '   ← responde: true/false',
-        '   → loan.calculateFine()',
-        '   ← responde: 25 (ejemplo)',
-        '',
-        '💡 Nota: Los objetos NO acceden directamente a datos de otros.',
-        '   Solo se comunican a través de solicitudes a sus interfaces.'
+        '// Devolver libro',
+        'const fine = library.returnBook(loan)',
+        'console.log(book.isAvailable())  // true'
       ],
       type: 'text'
     },
@@ -224,10 +290,10 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
         '¿Cómo decidimos que necesitábamos exactamente estos 4 objetos?',
         '¿Por qué no 3? ¿Por qué no 10? ¿Cuál es el criterio?',
         '\n🔍 Criterio de descomposición:',
-        '• Book - define operaciones para gestionar su disponibilidad',
-        '• User - define operaciones para gestionar sus límites',
-        '• Loan - define operaciones para gestionar la relación temporal',
-        '• Library - define operaciones para coordinar el sistema',
+        '• Book - responsabilidad de estado propio',
+        '• User - responsabilidad de sus límites',
+        '• Loan - responsabilidad de la relación temporal',
+        '• Library - responsabilidad de coordinación',
         '\n📚 Conexión con lecciones siguientes:',
         '• Lección 2: Los objetos interactúan a través de solicitudes',
         '• Lección 3: Las solicitudes son la única forma de ejecutar operaciones',
@@ -241,11 +307,6 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
     {
       message: '\n✨ ¡Lección 1 completada! Presiona Enter para continuar...',
       type: 'pause'
-    },
-    {
-      type: 'maze-completion',
-      message: 'Lección 1: Sistema completado!',
-      unlocked: 'Lección 2: Solicitudes'
     }
   ]
 }

package/lib/data/lessons/lesson2-object-requests.js

@@ -313,11 +313,6 @@ export const LESSON_2_OBJECT_REQUESTS = {
     {
       message: '\n✨ ¡Lección 2 completada! Presiona Enter para salir...',
       type: 'pause'
-    },
-    {
-      type: 'maze-completion',
-      message: 'Lección 2: Solicitudes completado!',
-      unlocked: 'Lección 3: Única forma'
     }
   ]
 }

package/lib/data/lessons/lesson3-only-way.js

@@ -344,11 +344,6 @@ export const LESSON_3_ONLY_WAY = {
     {
       message: '\n✨ ¡Lección 3 completada! Presiona Enter para salir...',
       type: 'pause'
-    },
-    {
-      type: 'maze-completion',
-      message: 'Lección 3: Única forma completado!',
-      unlocked: 'Lección 4: Firmas de operación'
     }
   ]
 }

package/lib/data/lessons/lesson4-operation-signatures.js

@@ -327,11 +327,6 @@ export const LESSON_4_OPERATION_SIGNATURES = {
     {
       message: '\n✨ ¡Lección 4 completada! Presiona Enter para salir...',
       type: 'pause'
-    },
-    {
-      type: 'maze-completion',
-      message: 'Lección 4: Firmas de operación completado!',
-      unlocked: 'Lección 5: Conjunto de firmas'
     }
   ]
 }

package/lib/data/lessons/lesson5-interface-set.js

@@ -336,11 +336,6 @@ export const LESSON_5_INTERFACE_SET = {
     {
       message: '\n✨ ¡Lección 5 completada! Presiona Enter para salir...',
       type: 'pause'
-    },
-    {
-      type: 'maze-completion',
-      message: 'Lección 5: Conjunto de firmas completado!',
-      unlocked: 'Lección 6: Énfasis en interfaces'
     }
   ]
 }

package/lib/data/lessons/lesson6-interface-design.js

@@ -402,11 +402,6 @@ export const LESSON_6_INTERFACE_DESIGN = {
     {
       message: '\n✨ ¡Lección 6 completada! Presiona Enter para salir...',
       type: 'pause'
-    },
-    {
-      type: 'maze-completion',
-      message: 'Lección 6: Énfasis en interfaces completado!',
-      unlocked: 'Lección 7: Definición de objeto'
     }
   ]
 }

package/lib/data/lessons/lesson7-object-definition.js

@@ -370,11 +370,6 @@ export const LESSON_7_OBJECT_DEFINITION = {
     {
       message: '\n✨ ¡Lección 7 completada! Presiona Enter para continuar...',
       type: 'pause'
-    },
-    {
-      type: 'maze-completion',
-      message: 'Lección 7: Definición de objeto completado!',
-      unlocked: '¡Completaste todos los enunciados fundamentales!'
     }
   ]
 }

package/lib/data/lessons/sintaxis/git-basico.js

@@ -0,0 +1,58 @@
+// Git Básico - Comandos fundamentales de control de versiones
+export const GIT_BASICO = {
+  id: 'git-basico',
+
+  intro: {
+    definition: 'Git es un sistema de control de versiones que te permite rastrear cambios en tu código.',
+    explanation: 'Con git puedes guardar "snapshots" de tu proyecto en diferentes momentos.',
+    detail: 'Esto te permite experimentar sin miedo, colaborar con otros, y volver atrás si algo sale mal.'
+  },
+
+  steps: [
+    {
+      type: 'command-intro',
+      command: 'git init',
+      description: 'Primer comando: git init',
+      explanation: 'git init inicializa un repositorio de git en tu carpeta actual.',
+      example: 'git init',
+      instruction: 'Úsalo una sola vez al crear un nuevo proyecto. Crea una carpeta oculta .git que rastrea cambios.'
+    },
+    {
+      type: 'command-intro',
+      command: 'git status',
+      description: 'Segundo comando: git status',
+      explanation: 'git status muestra el estado actual de tu repositorio.',
+      example: 'git status',
+      instruction: 'Te dice qué archivos han cambiado, cuáles están listos para commit, etc.'
+    },
+    {
+      type: 'command-intro',
+      command: 'git add',
+      description: 'Tercer comando: git add',
+      explanation: 'git add prepara archivos para ser guardados en el siguiente commit.',
+      example: 'git add archivo.js\ngit add .',
+      instruction: 'Usa "git add ." para agregar todos los cambios, o especifica archivos individuales.'
+    },
+    {
+      type: 'command-intro',
+      command: 'git commit',
+      description: 'Cuarto comando: git commit',
+      explanation: 'git commit guarda un snapshot de los cambios que agregaste con git add.',
+      example: 'git commit -m "Mensaje descriptivo"',
+      instruction: 'Siempre incluye un mensaje que describa qué cambiaste y por qué.'
+    },
+    {
+      type: 'command-intro',
+      command: 'git log',
+      description: 'Quinto comando: git log',
+      explanation: 'git log muestra el historial de commits de tu proyecto.',
+      example: 'git log\ngit log --oneline',
+      instruction: 'Usa --oneline para ver una versión compacta del historial.'
+    },
+    {
+      type: 'maze-completion',
+      message: 'Git básico completado!',
+      unlocked: 'Git colaboración (próximamente)'
+    }
+  ]
+}

package/lib/data/menus.js

@@ -1,16 +1,56 @@
-import { WELCOME_BANNER } from './messages.js'
 import { ENUNCIADOS } from './enunciados.js'
+import { UNLOCK_CONFIG, isUnlocked, hasCompletedLesson } from './progression.js'
+import { UserState } from '../utils/user-state.js'
 
-export const MAIN_MENU_CONFIG = {
-  banner: WELCOME_BANNER,
-  title: 'Te ofrecemos las siguientes opciones:',
+export const SINTAXIS_MENU_CONFIG = {
+  title: 'Elige qué lección de sintaxis te gustaría explorar:',
+  description: 'Aprende los comandos fundamentales de terminal y git.',
   options: [
-    { id: 'sintaxis', title: 'Aprender sintaxis' },
-    { id: 'enunciados', title: 'Aprender conceptos de diseño' },
-    { id: 'proyectos', title: 'Construir proyectos' }
+    { id: 'terminal-basico', title: '1. Terminal básico', description: 'ls, cd, mkdir' },
+    { id: 'git-basico', title: '2. Git básico', description: 'init, status, add, commit' }
   ]
 }
 
+const MENU_ITEMS = {
+  sintaxis: { baseTitle: 'Aprender sintaxis' },
+  enunciados: { baseTitle: 'Aprender conceptos de diseño' },
+  proyectos: { baseTitle: 'Construir proyectos' }
+}
+
+export function getMainMenuConfig() {
+  const state = UserState.get()
+  const options = []
+
+  for (const [id, itemConfig] of Object.entries(MENU_ITEMS)) {
+    const unlockConfig = UNLOCK_CONFIG.mainMenu[id]
+
+    if (!isUnlocked(id, unlockConfig)) continue
+
+    const showNew = typeof unlockConfig.showNewIndicator === 'function'
+      ? unlockConfig.showNewIndicator(state)
+      : unlockConfig.showNewIndicator
+
+    const description = typeof unlockConfig.description === 'function'
+      ? unlockConfig.description(state)
+      : unlockConfig.description
+
+    options.push({
+      id,
+      title: showNew ? `✨ ${itemConfig.baseTitle}` : itemConfig.baseTitle,
+      description
+    })
+  }
+
+  return {
+    clearConsole: false,
+    title: 'Te ofrecemos las siguientes opciones:',
+    options
+  }
+}
+
+// For backward compatibility
+export const MAIN_MENU_CONFIG = getMainMenuConfig()
+
 export const ENUNCIADOS_MENU_CONFIG = {
   title: 'Elige qué enunciado te gustaría explorar:',
   description: [

package/lib/data/messages.js

@@ -22,4 +22,7 @@ export const HELP_TEXT = `
 
 💡 Tip: Si estás dentro de un proyecto existente, los comandos
     portafolio-1/2/3 actualizarán tus archivos directamente
+
+🎯 La filosofía Creta: partir de enunciados que generan 'ruido' para
+   construir comprensión real, no solo sintaxis.
 `

package/lib/data/progression.js

@@ -0,0 +1,44 @@
+// Centralized progression and unlock logic
+import { UserState } from '../utils/user-state.js'
+
+export function hasCompletedLesson(lessonId) {
+  const state = UserState.get()
+  return state.lessonsCompleted.some(
+    lesson => typeof lesson === 'object' ? lesson.id === lessonId : lesson === lessonId
+  )
+}
+
+// Data-driven unlock configuration
+export const UNLOCK_CONFIG = {
+  mainMenu: {
+    sintaxis: {
+      alwaysVisible: true,
+      showNewIndicator: (state) =>
+        hasCompletedLesson('terminal-basico') && !hasCompletedLesson('git-basico'),
+      description: (state) =>
+        hasCompletedLesson('terminal-basico') && !hasCompletedLesson('git-basico')
+          ? 'Git básico desbloqueado'
+          : undefined
+    },
+    enunciados: {
+      unlockAfter: 'terminal-basico',
+      showNewIndicator: true,
+      description: '7 enunciados fundamentales de OOP'
+    },
+    proyectos: {
+      unlockAfter: 'git-basico',
+      showNewIndicator: true,
+      description: 'Portafolios y pull requests'
+    }
+  },
+  sintaxis: {
+    directToLesson: (state) =>
+      !hasCompletedLesson('terminal-basico') ? 'terminal-basico' : null
+  }
+}
+
+export function isUnlocked(itemKey, config) {
+  if (config.alwaysVisible) return true
+  if (!config.unlockAfter) return true
+  return hasCompletedLesson(config.unlockAfter)
+}

package/lib/executors/enunciados-executor.js

@@ -3,7 +3,6 @@ import { ENUNCIADOS_MENU_CONFIG } from '../data/menus.js'
 import { LESSONS_BY_ID } from '../data/lessons/index.js'
 import { LessonBuilder } from '../builders/LessonBuilder.js'
 import { createPromptInterface } from '../utils/input.js'
-import { clearConsole } from '../utils/output.js'
 
 const UPCOMING_MESSAGE = [
   '\n🚀 Próximamente:',
@@ -31,15 +30,6 @@ async function runLesson(lessonId, enunciadoTexto, { LessonCtor = LessonBuilder,
     return
   }
 
-  // Show selection confirmation (NEW UX PATTERN)
-  console.log(`\nElegiste: Enunciado ${lessonId}`)
-  console.log('Cargando...')
-  await new Promise((resolve) => delay(resolve, 1000))
-
-  // Clear screen but keep scroll history (NEW UX PATTERN)
-  clearConsole()
-
-  // Show enunciado text
   console.log(enunciadoTexto)
   await new Promise((resolve) => delay(resolve, 1500))
 

package/lib/executors/sintaxis-executor.js

@@ -1,18 +1,72 @@
+import { MenuBuilder } from '../builders/MenuBuilder.js'
+import { SINTAXIS_MENU_CONFIG } from '../data/menus.js'
 import { LessonBuilder } from '../builders/LessonBuilder.js'
 import { TERMINAL_BASICO } from '../data/lessons/sintaxis/terminal-basico.js'
+import { GIT_BASICO } from '../data/lessons/sintaxis/git-basico.js'
 import { clearConsole } from '../utils/output.js'
+import { createPromptInterface } from '../utils/input.js'
+import { UserState } from '../utils/user-state.js'
+import { UNLOCK_CONFIG } from '../data/progression.js'
 
-export async function executeSintaxis() {
-  // Show selection confirmation
-  console.log('\nElegiste: Aprender sintaxis')
+const LESSONS_BY_ID = new Map([
+  ['terminal-basico', TERMINAL_BASICO],
+  ['git-basico', GIT_BASICO]
+])
+
+function waitForEnter(message = '\nPresiona Enter para continuar...') {
+  const rl = createPromptInterface()
+  return new Promise((resolve) => {
+    rl.question(message, () => {
+      rl.close()
+      resolve()
+    })
+  })
+}
+
+async function runLesson(lessonId, lessonTitle) {
+  const lessonData = LESSONS_BY_ID.get(lessonId)
+
+  if (!lessonData) {
+    console.log('\n🚀 Próximamente: ' + lessonTitle)
+    return
+  }
+
+  console.log(`\nElegiste: ${lessonTitle}`)
   console.log('Cargando...')
 
   await new Promise(resolve => setTimeout(resolve, 1000))
 
-  // Clear screen but keep scroll history
   clearConsole()
 
-  // Start lesson
-  const lesson = new LessonBuilder(TERMINAL_BASICO)
+  const lesson = new LessonBuilder(lessonData)
   await lesson.start()
 }
+
+export async function executeSintaxis() {
+  const state = UserState.get()
+
+  // Check if we should go directly to a lesson
+  const directLesson = UNLOCK_CONFIG.sintaxis.directToLesson(state)
+
+  if (directLesson) {
+    await runLesson(directLesson, 'Terminal básico')
+
+    // After completing, show what was unlocked
+    console.log('\n✨ Ahora puedes acceder al menú de sintaxis para aprender Git básico')
+    await waitForEnter()
+    return
+  }
+
+  // Show menu
+  const menu = new MenuBuilder(SINTAXIS_MENU_CONFIG)
+
+  while (true) {
+    const choice = await menu.show()
+    if (!choice) {
+      return
+    }
+
+    await runLesson(choice.id, choice.title)
+    await waitForEnter('\nPresiona Enter para regresar al menú de sintaxis...')
+  }
+}

package/lib/utils/greeting.js

@@ -1,22 +1,32 @@
 import chalk from 'chalk'
 import { UserState } from './user-state.js'
 import { askQuestion, createPromptInterface } from './input.js'
+import { clearConsole } from './output.js'
 
 const BANNER_ART = `
 █████████████████████████
 █   █   █   █   █   █   █
 █ C █ R █ E █ T █ A █ █ █
 █   █   █   █   █   █   █
-█████████████████████████
+█████████████████████████`
+
+const FIRST_TIME_BANNER = `${BANNER_ART}
+
+Bienvenido a Creta, el taller de software de icarus.mx`
 
-Bienvenido a la escuela de software de icarus.mx`
+const WELCOME_BANNER = `${BANNER_ART}
+
+Bienvenido a Creta, el taller de software de icarus.mx`
 
 export async function greetUser() {
+  // Clear screen completely on startup
+  clearConsole()
+
   const state = UserState.updateLastSeen()
 
   // First time user - ask for name
   if (!state.name) {
-    console.log(BANNER_ART)
+    console.log(FIRST_TIME_BANNER)
 
     const rl = createPromptInterface()
 
@@ -25,20 +35,32 @@ export async function greetUser() {
 
     if (name && name.trim()) {
       UserState.setName(name.trim())
+
+      // Clear and show welcome banner with animation feel
+      await new Promise(resolve => setTimeout(resolve, 300))
+      clearConsole()
+      console.log(WELCOME_BANNER)
       console.log(chalk.cyan(`\nSalgamos de este laberinto, ${name.trim()} 🏛️`))
     }
 
     rl.close()
     console.log('')
+
+    // Small delay before showing menu
+    await new Promise(resolve => setTimeout(resolve, 800))
     return
   }
 
   // Returning user - show personalized greeting
+  console.log(WELCOME_BANNER)
+
   const lessonsCount = state.lessonsCompleted.length
   const greeting = lessonsCount > 0
     ? `¡Hola de vuelta, ${state.name}! 📊 ${lessonsCount} ${lessonsCount === 1 ? 'lección completada' : 'lecciones completadas'}`
     : `Salgamos de este laberinto, ${state.name} 🏛️`
 
-  console.log(BANNER_ART)
-  console.log(chalk.cyan(`${greeting}\n`))
+  console.log(chalk.cyan(`\n${greeting}\n`))
+
+  // Small delay before showing menu
+  await new Promise(resolve => setTimeout(resolve, 500))
 }

package/lib/utils/user-state.js

@@ -5,31 +5,16 @@ import os from 'os'
 const STATE_DIR = path.join(os.homedir(), '.creta')
 const STATE_FILE = path.join(STATE_DIR, 'user.json')
 
-export class UserState {
-  static load() {
-    try {
-      if (!fs.existsSync(STATE_FILE)) {
-        return this.createDefault()
-      }
-      return JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'))
-    } catch {
-      return this.createDefault()
-    }
+function ensureStateDir() {
+  if (!fs.existsSync(STATE_DIR)) {
+    fs.mkdirSync(STATE_DIR, { recursive: true })
   }
+}
 
-  static save(data) {
-    try {
-      if (!fs.existsSync(STATE_DIR)) {
-        fs.mkdirSync(STATE_DIR, { recursive: true })
-      }
-      fs.writeFileSync(STATE_FILE, JSON.stringify(data, null, 2))
-      return true
-    } catch {
-      return false
-    }
-  }
+function loadState() {
+  ensureStateDir()
 
-  static createDefault() {
+  if (!fs.existsSync(STATE_FILE)) {
     return {
       name: null,
       createdAt: new Date().toISOString(),
@@ -39,77 +24,94 @@ export class UserState {
       stats: {
         totalSessions: 0,
         lastSeen: null
-      }
+      },
+      lastSeen: null
     }
   }
 
-  static updateLastSeen() {
-    const state = this.load()
-    state.stats.lastSeen = new Date().toISOString()
-    state.stats.totalSessions += 1
-    this.save(state)
-    return state
+  try {
+    const data = fs.readFileSync(STATE_FILE, 'utf8')
+    return JSON.parse(data)
+  } catch (error) {
+    console.error('Error loading user state:', error.message)
+    return {
+      name: null,
+      createdAt: new Date().toISOString(),
+      lessonsCompleted: [],
+      projectsCreated: [],
+      discord: null,
+      stats: {
+        totalSessions: 0,
+        lastSeen: null
+      },
+      lastSeen: null
+    }
   }
+}
 
-  static completLesson(lessonId) {
-    const state = this.load()
-
-    // Check if already completed
-    const alreadyCompleted = state.lessonsCompleted.find(l => l.id === lessonId)
-    if (alreadyCompleted) return state
-
-    state.lessonsCompleted.push({
-      id: lessonId,
-      completedAt: new Date().toISOString()
-    })
+function saveState(state) {
+  ensureStateDir()
 
-    this.save(state)
-    return state
+  try {
+    fs.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2), 'utf8')
+  } catch (error) {
+    console.error('Error saving user state:', error.message)
   }
+}
 
-  static addProject(projectName, projectType, level = 0) {
-    const state = this.load()
-
-    state.projectsCreated.push({
-      name: projectName,
-      type: projectType,
-      level,
-      createdAt: new Date().toISOString()
-    })
-
-    this.save(state)
-    return state
+export class UserState {
+  static get() {
+    return loadState()
   }
 
   static setName(name) {
-    const state = this.load()
+    const state = loadState()
     state.name = name
-    this.save(state)
+    saveState(state)
     return state
   }
 
-  static getPath() {
-    return STATE_FILE
+  static updateLastSeen() {
+    const state = loadState()
+    const now = new Date().toISOString()
+    state.lastSeen = now
+    state.stats = state.stats || { totalSessions: 0, lastSeen: null }
+    state.stats.totalSessions = (state.stats.totalSessions || 0) + 1
+    state.stats.lastSeen = now
+    saveState(state)
+    return state
   }
 
-  static hasName() {
-    const state = this.load()
-    return state.name !== null && state.name.trim() !== ''
+  static addCompletedLesson(lessonId) {
+    const state = loadState()
+    const alreadyCompleted = state.lessonsCompleted.some(
+      lesson => typeof lesson === 'object' ? lesson.id === lessonId : lesson === lessonId
+    )
+
+    if (!alreadyCompleted) {
+      state.lessonsCompleted.push({
+        id: lessonId,
+        completedAt: new Date().toISOString()
+      })
+      saveState(state)
+    }
+    return state
   }
 
-  static getName() {
-    const state = this.load()
-    return state.name
+  static addProject(projectName) {
+    const state = loadState()
+    state.projectsCreated = state.projectsCreated || []
+    state.projectsCreated.push({
+      name: projectName,
+      createdAt: new Date().toISOString()
+    })
+    saveState(state)
+    return state
   }
 
-  static getStats() {
-    const state = this.load()
-    return {
-      name: state.name,
-      lessonsCompleted: state.lessonsCompleted.length,
-      projectsCreated: state.projectsCreated.length,
-      totalSessions: state.stats.totalSessions,
-      lastSeen: state.stats.lastSeen
+  static reset() {
+    if (fs.existsSync(STATE_FILE)) {
+      fs.unlinkSync(STATE_FILE)
     }
   }
 }

package/package.json

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