@icarusmx/creta 1.3.5 → 1.4.1

package/lib/builders/LessonBuilder.js

@@ -1,5 +1,6 @@
 import { createPromptInterface, askQuestion } from '../utils/input.js'
 import { clearConsole } from '../utils/output.js'
+import { UserState } from '../utils/user-state.js'
 
 const DEFAULT_WAIT_MESSAGE = '\nPresiona Enter para continuar...'
 
@@ -19,6 +20,11 @@ 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
@@ -85,6 +91,9 @@ export class LessonBuilder {
       case 'command-intro':
         await this.handleCommandIntro(action)
         break
+      case 'maze-completion':
+        await this.handleMazeCompletion(action)
+        break
       case 'text':
       default:
         this.handleText(action)
@@ -194,21 +203,27 @@ export class LessonBuilder {
     }
 
     // Wait for Enter
-    await askQuestion(this.rl, '\nPresiona Enter para comenzar...')
+    await askQuestion(this.rl, '\nPresiona Enter para continuar...')
 
-    // Show explanation and detail
+    // Clear screen and show explanation
     if (action.explanation) {
-      console.log(`\n${action.explanation}`)
+      clearConsole()
+      console.log(action.explanation)
+      await askQuestion(this.rl, '\nPresiona Enter para continuar...')
     }
 
+    // Clear screen and show detail
     if (action.detail) {
-      console.log('')
+      clearConsole()
       console.log(action.detail)
+      await askQuestion(this.rl, '\nPresiona Enter para continuar...')
     }
   }
 
   async handleCommandIntro(action) {
-    console.log('')
+    // Clear screen before showing command
+    clearConsole()
+
     console.log(action.description)
     console.log('')
     console.log(action.explanation)
@@ -222,7 +237,152 @@ export class LessonBuilder {
     console.log(action.instruction)
 
     if (!action.exitOnComplete) {
-      await askQuestion(this.rl, DEFAULT_WAIT_MESSAGE)
+      await askQuestion(this.rl, '\nPresiona Enter para continuar...')
+    }
+  }
+
+  async handleMazeCompletion(action) {
+    const frames = [
+      // Frame 1: Cow enters maze
+      [
+        '███████████████',
+        '█🐄░░░███░░░░░█',
+        '█░███░███░███░█',
+        '█░███░░░░░███░█',
+        '█░░░░░███░░░░░█',
+        '███████████████'
+      ],
+      // Frame 2: Cow moves forward
+      [
+        '███████████████',
+        '█░🐄░░███░░░░░█',
+        '█░███░███░███░█',
+        '█░███░░░░░███░█',
+        '█░░░░░███░░░░░█',
+        '███████████████'
+      ],
+      // Frame 3: Cow continues
+      [
+        '███████████████',
+        '█░░🐄░███░░░░░█',
+        '█░███░███░███░█',
+        '█░███░░░░░███░█',
+        '█░░░░░███░░░░░█',
+        '███████████████'
+      ],
+      // Frame 4: Cow turns down
+      [
+        '███████████████',
+        '█░░░🐄███░░░░░█',
+        '█░███░███░███░█',
+        '█░███░░░░░███░█',
+        '█░░░░░███░░░░░█',
+        '███████████████'
+      ],
+      // Frame 5: Cow goes down
+      [
+        '███████████████',
+        '█░░░░░███░░░░░█',
+        '█░███🐄███░███░█',
+        '█░███░░░░░███░█',
+        '█░░░░░███░░░░░█',
+        '███████████████'
+      ],
+      // Frame 6: Cow continues down
+      [
+        '███████████████',
+        '█░░░░░███░░░░░█',
+        '█░███░███░███░█',
+        '█░███🐄░░░███░█',
+        '█░░░░░███░░░░░█',
+        '███████████████'
+      ],
+      // Frame 7: Cow moves right
+      [
+        '███████████████',
+        '█░░░░░███░░░░░█',
+        '█░███░███░███░█',
+        '█░███░🐄░░███░█',
+        '█░░░░░███░░░░░█',
+        '███████████████'
+      ],
+      // Frame 8: Cow reaches bottom
+      [
+        '███████████████',
+        '█░░░░░███░░░░░█',
+        '█░███░███░███░█',
+        '█░███░░🐄░███░█',
+        '█░░░░░███░░░░░█',
+        '███████████████'
+      ],
+      // Frame 9: Cow moves down to exit
+      [
+        '███████████████',
+        '█░░░░░███░░░░░█',
+        '█░███░███░███░█',
+        '█░███░░░░░███░█',
+        '█░░░░🐄███░░░░█',
+        '███████████████'
+      ],
+      // Frame 10: Cow approaches exit
+      [
+        '███████████████',
+        '█░░░░░███░░░░░█',
+        '█░███░███░███░█',
+        '█░███░░░░░███░█',
+        '█░░░░░███🐄░░░█',
+        '███████████████'
+      ],
+      // Frame 11: Cow exits!
+      [
+        '███████████████',
+        '█░░░░░███░░░░░█',
+        '█░███░███░███░█',
+        '█░███░░░░░███░█',
+        '█░░░░░███░░🐄░█',
+        '███████████████'
+      ],
+      // Frame 12: Cow is free!
+      [
+        '███████████████',
+        '█░░░░░███░░░░░█',
+        '█░███░███░███░█',
+        '█░███░░░░░███░█',
+        '█░░░░░███░░░🐄█',
+        '███████████████'
+      ],
+      // Frame 13: Cow outside the maze
+      [
+        '███████████████',
+        '█░░░░░███░░░░░█',
+        '█░███░███░███░█',
+        '█░███░░░░░███░█',
+        '█░░░░░███░░░░░█',
+        '███████████████  🐄'
+      ]
+    ]
+
+    console.log('\n')
+
+    // Animate through frames
+    for (const frame of frames) {
+      clearConsole()
+      console.log('')
+      frame.forEach(line => console.log('  ' + line))
+      await new Promise(resolve => setTimeout(resolve, 300))
+    }
+
+    // Show completion message
+    await new Promise(resolve => setTimeout(resolve, 500))
+    console.log('')
+    console.log(`  ✓ ${action.message}`)
+
+    if (action.unlocked) {
+      await new Promise(resolve => setTimeout(resolve, 300))
+      console.log(`  🔓 Desbloqueaste: ${action.unlocked}`)
     }
+
+    console.log('')
+    await askQuestion(this.rl, '\nPresiona Enter para continuar...')
   }
 }

package/lib/cli/index.js

@@ -6,6 +6,7 @@ import { executeSintaxis } from '../executors/sintaxis-executor.js'
 import { executePortfolio } from '../executors/portfolio-executor.js'
 import { showHelp } from '../commands/help.js'
 import { CretaCodeSession } from '../session.js'
+import { greetUser } from '../utils/greeting.js'
 
 async function executeMainMenu() {
   const menu = new MenuBuilder(MAIN_MENU_CONFIG)
@@ -71,6 +72,9 @@ 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()
+
   if (!command) {
     await executeMainMenu()
     return 0

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

@@ -115,27 +115,13 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
       type: 'text'
     },
     {
-      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' +
+      code: 'interface Book {\n' +
+        '  isAvailable(): boolean\n' +
+        '  markAsLoaned(): void\n' +
+        '  markAsReturned(): void\n' +
         '}',
-      title: '📄 Clase Book',
+      title: '📄 Objeto: Book',
+      after: 'Responsabilidad: Conocer su propio estado de disponibilidad',
       type: 'code'
     },
     {
@@ -143,28 +129,13 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
       type: 'pause'
     },
     {
-      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' +
+      code: 'interface User {\n' +
+        '  canBorrow(): boolean\n' +
+        '  addLoan(loan: Loan): void\n' +
+        '  removeLoan(loan: Loan): void\n' +
         '}',
-      title: '📄 Clase User',
+      title: '📄 Objeto: User',
+      after: 'Responsabilidad: Conocer sus propios límites de préstamo',
       type: 'code'
     },
     {
@@ -172,32 +143,13 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
       type: 'pause'
     },
     {
-      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' +
+      code: 'interface Loan {\n' +
+        '  isOverdue(): boolean\n' +
+        '  calculateFine(): number\n' +
+        '  returnBook(): void\n' +
         '}',
-      title: '📄 Clase Loan',
+      title: '📄 Objeto: Loan',
+      after: 'Responsabilidad: Gestionar la relación temporal entre usuario y libro',
       type: 'code'
     },
     {
@@ -205,36 +157,14 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
       type: 'pause'
     },
     {
-      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'
+      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'
     },
     {
       message: '\nPresiona Enter para ver la interacción...',
@@ -245,25 +175,29 @@ export const LESSON_1_SYSTEM_DECOMPOSITION = {
     },
     {
       lines: [
-        'Ejemplo de uso:',
+        '🔄 Interacciones entre objetos:',
+        '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
         '',
-        'const library = new Library()',
-        "const book = new Book('1984', 'George Orwell', '978-0451524935')",
-        "const user = new User('Ana García', 'ana@email.com')",
+        '1. Library solicita a User:',
+        '   → user.canBorrow()',
+        '   ← 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)',
+        '2. Library solicita a Book:',
+        '   → book.isAvailable()',
+        '   ← responde: true/false',
         '',
-        '// Simular libro vencido',
-        'loan.dueDate = new Date(Date.now() - 24 * 60 * 60 * 1000)',
-        'console.log(loan.isOverdue())    // true',
-        'console.log(loan.calculateFine()) // 5',
+        '3. Library crea Loan y coordina:',
+        '   → book.markAsLoaned()',
+        '   → user.addLoan(loan)',
         '',
-        '// Devolver libro',
-        'const fine = library.returnBook(loan)',
-        'console.log(book.isAvailable())  // true'
+        '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.'
       ],
       type: 'text'
     },
@@ -290,10 +224,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 - responsabilidad de estado propio',
-        '• User - responsabilidad de sus límites',
-        '• Loan - responsabilidad de la relación temporal',
-        '• Library - responsabilidad de coordinació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',
         '\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',
@@ -307,6 +241,11 @@ 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,6 +313,11 @@ 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,6 +344,11 @@ 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,6 +327,11 @@ 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,6 +336,11 @@ 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,6 +402,11 @@ 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,6 +370,11 @@ 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/terminal-basico.js

@@ -1,7 +1,6 @@
 // Terminal Básico - Comandos fundamentales de navegación
 export const TERMINAL_BASICO = {
   id: 'terminal-basico',
-  title: 'Terminal Básico',
 
   intro: {
     definition: 'Sintaxis: estudia el modo en que se combinan las palabras y los distintos grupos que forman para expresar significado.',
@@ -41,6 +40,11 @@ export const TERMINAL_BASICO = {
       explanation: 'mkdir crea un nuevo directorio (carpeta).',
       example: 'mkdir mi-proyecto',
       instruction: 'Crea una carpeta nueva. Prueba: mkdir prueba'
+    },
+    {
+      type: 'maze-completion',
+      message: 'Terminal básico completado!',
+      unlocked: 'Git básico'
     }
   ]
 }

package/lib/executors/enunciados-executor.js

@@ -3,6 +3,7 @@ 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:',
@@ -30,6 +31,15 @@ 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,7 +1,18 @@
 import { LessonBuilder } from '../builders/LessonBuilder.js'
 import { TERMINAL_BASICO } from '../data/lessons/sintaxis/terminal-basico.js'
+import { clearConsole } from '../utils/output.js'
 
 export async function executeSintaxis() {
+  // Show selection confirmation
+  console.log('\nElegiste: Aprender sintaxis')
+  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)
   await lesson.start()
 }

package/lib/utils/greeting.js

@@ -0,0 +1,32 @@
+import chalk from 'chalk'
+import { UserState } from './user-state.js'
+import { askQuestion, createPromptInterface } from './input.js'
+
+export async function greetUser() {
+  const state = UserState.updateLastSeen()
+
+  // First time user - ask for name
+  if (!state.name) {
+    const rl = createPromptInterface()
+
+    console.log('')
+    const name = await askQuestion(rl, chalk.cyan('👋 ¿Cómo te llamas? '))
+
+    if (name && name.trim()) {
+      UserState.setName(name.trim())
+      console.log(chalk.green(`\n¡Bienvenido, ${name.trim()}!`))
+    }
+
+    rl.close()
+    console.log('')
+    return
+  }
+
+  // Returning user - show personalized greeting
+  const lessonsCount = state.lessonsCompleted.length
+  const greeting = lessonsCount > 0
+    ? `¡Hola de vuelta, ${state.name}! 📊 ${lessonsCount} ${lessonsCount === 1 ? 'lección completada' : 'lecciones completadas'}`
+    : `¡Hola de vuelta, ${state.name}!`
+
+  console.log(chalk.cyan(`\n${greeting}\n`))
+}

package/lib/utils/user-state.js

@@ -0,0 +1,115 @@
+import fs from 'fs'
+import path from 'path'
+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()
+    }
+  }
+
+  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
+    }
+  }
+
+  static createDefault() {
+    return {
+      name: null,
+      createdAt: new Date().toISOString(),
+      lessonsCompleted: [],
+      projectsCreated: [],
+      discord: null,
+      stats: {
+        totalSessions: 0,
+        lastSeen: null
+      }
+    }
+  }
+
+  static updateLastSeen() {
+    const state = this.load()
+    state.stats.lastSeen = new Date().toISOString()
+    state.stats.totalSessions += 1
+    this.save(state)
+    return state
+  }
+
+  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()
+    })
+
+    this.save(state)
+    return state
+  }
+
+  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
+  }
+
+  static setName(name) {
+    const state = this.load()
+    state.name = name
+    this.save(state)
+    return state
+  }
+
+  static getPath() {
+    return STATE_FILE
+  }
+
+  static hasName() {
+    const state = this.load()
+    return state.name !== null && state.name.trim() !== ''
+  }
+
+  static getName() {
+    const state = this.load()
+    return state.name
+  }
+
+  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
+    }
+  }
+}

package/package.json

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