@icarusmx/creta 1.4.19 → 1.5.3

package/bin/creta.js

@@ -1,40 +1,1661 @@
 #!/usr/bin/env node
 
-import { runCLI } from '../lib/cli/index.js'
+import { createInterface } from 'readline'
+import { execSync } from 'child_process'
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+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 { 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'
 
-// Setup process exit handlers for sandbox cleanup
-function setupExitHandlers() {
-  const cleanup = () => {
-    // Cleanup will be handled by individual SandboxManager instances
-    // and by the cleanupOldSessions call on startup
+const ENUNCIADOS = [
+  {
+    id: 1,
+    texto: "La parte difícil del diseño orientado a objetos es descomponer un sistema como un conjunto de objetos que interactúan entre sí.",
+    nivel: "Fundacional",
+    enfoque: "Descomposición de sistemas"
+  },
+  {
+    id: 2,
+    texto: "Los objetos interactúan entre sí a través de solicitudes.",
+    nivel: "Interacción",
+    enfoque: "Comunicación entre objetos"
+  },
+  {
+    id: 3,
+    texto: "Las solicitudes son la única forma de conseguir que un objeto lleve a cabo una operación.",
+    nivel: "Operaciones",
+    enfoque: "Mecanismo de ejecución"
+  },
+  {
+    id: 4,
+    texto: "Cada operación declarada por un objeto debe incluir:\na) nombre de la operación\nb) insumos necesarios para realizar la operación\nc) el valor que regresa tras ejecutar la operación\n\nEstos tres elementos constituyen la firma de operación.",
+    nivel: "Firmas",
+    enfoque: "Contratos de operación"
+  },
+  {
+    id: 5,
+    texto: "La interfaz de un objeto es el conjunto de todas sus firmas de operación.",
+    nivel: "Interfaces",
+    enfoque: "Definición de contratos"
+  },
+  {
+    id: 6,
+    texto: "El énfasis al diseñar los objetos debe estar en la definición de sus solicitudes e interfaces.",
+    nivel: "Diseño",
+    enfoque: "Metodología de desarrollo"
+  },
+  {
+    id: 7,
+    texto: "Un objeto es un conjunto de datos y procedimientos que operan sobre esos datos.",
+    nivel: "Definición",
+    enfoque: "Naturaleza del objeto"
   }
+]
 
-  // Handle Ctrl+C
-  process.on('SIGINT', () => {
-    cleanup()
-    process.exit(0)
+const args = process.argv.slice(2)
+const command = args[0]
+
+// Check if this is a command help request (Phase 2: Desarrollador mode)
+if (command && isCommandHelpRequest(args)) {
+  const executor = new CommandHelpExecutor(args)
+  await executor.execute()
+  process.exit(0)
+}
+
+// ASCII Logo
+console.log(`
+█████████████████████████
+█   █   █   █   █   █   █
+█ C █ R █ E █ T █ A █ █ █
+█   █   █   █   █   █   █
+█████████████████████████
+
+Bienvenido a la escuela de software de icarus.mx
+Salgamos de este laberinto 🏛️
+`)
+
+if (!command) {
+  // Default behavior: show main menu
+  await startMainMenu()
+  process.exit(0)
+}
+
+if (command.startsWith('portafolio')) {
+  const level = command === 'portafolio' ? 0 : parseInt(command.split('-')[1]) || 0
+  
+  // Check if we're in an existing Creta project
+  if (level > 0 && isInCretaProject()) {
+    await unstuckProject(level)
+  } else {
+    await createPortfolioProject(level)
+  }
+} else if (command === 'enunciados') {
+  // Start enunciados selector
+  await startEnunciadosSelector()
+} else if (command === 'code') {
+  // Start interactive coding session
+  const session = new CretaCodeSession()
+  await session.start()
+} else if (command === 'papers') {
+  // Start papers selector
+  const executor = new PapersExecutor()
+  await executor.execute()
+} else if (command === 'help' || command === 'ayuda') {
+  // Show available commands
+  showHelp()
+} else {
+  console.log(`Comando no reconocido: ${command}`)
+  console.log("Escribe 'creta help' para ver comandos disponibles")
+  process.exit(1)
+}
+
+async function createPortfolioProject(level) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  })
+
+  const askQuestion = (question) => {
+    return new Promise((resolve) => {
+      rl.question(question, resolve)
+    })
+  }
+
+  try {
+    const name = await askQuestion("¿Cuál es tu nombre? ")
+    const projectName = `${name.toLowerCase().replace(/\s+/g, '-')}-portafolio`
+    
+    console.log(`\n🚀 Creando proyecto: ${projectName}`)
+    console.log(`📚 Nivel: ${level === 0 ? 'Reto completo' : `Con ${getLevelDescription(level)} completado`}`)
+    
+    await createProjectFiles(projectName, name, level)
+    
+    console.log(`\n✨ ¡Proyecto creado exitosamente!`)
+    console.log(`\n📁 Ingresa a tu proyecto: cd ${projectName}`)
+    console.log(`📦 Instala dependencias: npm install`)  
+    console.log(`🚀 Inicia el servidor: npm run dev`)
+    console.log(`\n💡 Lee los comentarios en los archivos para saber qué hacer`)
+    
+    rl.close()
+  } catch (error) {
+    console.error('Error:', error.message)
+    rl.close()
+    process.exit(1)
+  }
+}
+
+async function createProjectFiles(projectName, studentName, level) {
+  const __filename = fileURLToPath(import.meta.url)
+  const __dirname = path.dirname(__filename)
+  const templatePath = path.join(__dirname, '../templates/sveltekit-portfolio')
+  const targetPath = path.join(process.cwd(), projectName)
+  
+  // Check if template exists
+  if (!fs.existsSync(templatePath)) {
+    console.error(`Debug info:`)
+    console.error(`  - CLI location: ${__filename}`)
+    console.error(`  - Template path: ${templatePath}`)
+    console.error(`  - Template exists: ${fs.existsSync(templatePath)}`)
+    throw new Error('Template no encontrado. Es posible que necesites reinstalar el paquete: npm uninstall -g @icarusmx/creta && npm install -g @icarusmx/creta')
+  }
+  
+  // Create target directory
+  if (fs.existsSync(targetPath)) {
+    throw new Error(`El directorio ${projectName} ya existe`)
+  }
+  
+  fs.mkdirSync(targetPath, { recursive: true })
+  
+  // Copy template files
+  await copyTemplate(templatePath, targetPath, projectName, studentName, level)
+}
+
+async function copyTemplate(src, dest, projectName, studentName, level) {
+  const items = fs.readdirSync(src)
+  
+  for (const item of items) {
+    const srcPath = path.join(src, item)
+    const destPath = path.join(dest, item)
+    
+    if (fs.statSync(srcPath).isDirectory()) {
+      fs.mkdirSync(destPath, { recursive: true })
+      await copyTemplate(srcPath, destPath, projectName, studentName, level)
+    } else {
+      // Check if this is a binary file
+      const binaryExtensions = ['.png', '.jpg', '.jpeg', '.gif', '.svg', '.ico', '.woff', '.woff2', '.ttf', '.eot']
+      const ext = path.extname(srcPath).toLowerCase()
+      
+      if (binaryExtensions.includes(ext)) {
+        // Copy binary files directly without text processing
+        fs.copyFileSync(srcPath, destPath)
+      } else {
+        // Process text files with placeholders
+        let content = fs.readFileSync(srcPath, 'utf8')
+        
+        // Apply level-specific modifications first
+        if (level > 0) {
+          content = applyLevelModifications(content, item, level)
+        }
+        
+        // Then replace placeholders
+        content = content.replace(/\{\{PROJECT_NAME\}\}/g, projectName)
+        content = content.replace(/\{\{STUDENT_NAME\}\}/g, studentName)
+        
+        fs.writeFileSync(destPath, content)
+      }
+    }
+  }
+}
+
+function applyLevelModifications(content, filename, level) {
+  if (filename === '+layout.svelte') {
+    return applyLayoutModifications(content, level)
+  }
+  
+  if (filename === '+page.svelte') {
+    return applyPageModifications(content, level)
+  }
+  
+  return content
+}
+
+function applyLayoutModifications(content, level) {
+  if (level >= 1) {
+    // Replace navbar placeholder with complete solution
+    content = content.replace(
+      '<nav class="bg-white shadow-sm">\n  <!-- ⚠️ COMPLETA AQUÍ LA NAVEGACIÓN -->\n</nav>',
+      `<nav class="bg-white shadow-sm">
+  <div class="max-w-7xl mx-auto px-4">
+    <div class="flex justify-between items-center py-3">
+      <div class="flex items-center space-x-3">
+        <img src="https://icarus.mx/logo.png" alt="Logo" class="w-8 h-8">
+        <span class="text-xl font-bold text-gray-900">{{STUDENT_NAME}}</span>
+      </div>
+      <div class="hidden md:flex space-x-6">
+        <a href="#inicio" class="text-gray-600 hover:text-blue-600">Inicio</a>
+        <a href="#sobre-mi" class="text-gray-600 hover:text-blue-600">Sobre mí</a>
+        <a href="#proyectos" class="text-gray-600 hover:text-blue-600">Proyectos</a>
+        <a href="#contacto" class="text-gray-600 hover:text-blue-600">Contacto</a>
+      </div>
+      <button class="md:hidden">
+        <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16"></path>
+        </svg>
+      </button>
+    </div>
+  </div>
+</nav>`
+    )
+  }
+  
+  if (level >= 3) {
+    // Replace footer placeholder with complete solution
+    content = content.replace(
+      '<footer class="bg-gray-50 border-t">\n  <!-- ⚠️ COMPLETA AQUÍ EL FOOTER -->\n</footer>',
+      `<footer class="bg-gray-50 border-t">
+  <div class="max-w-7xl mx-auto py-8 px-4">
+    <div class="text-center text-gray-600 text-sm space-y-2">
+      <p>© ${new Date().getFullYear()} {{STUDENT_NAME}}. Todos los derechos reservados.</p>
+      <p>Hecho con ❤️ en <a href="https://creta.school" class="text-blue-600 hover:underline">Creta</a></p>
+    </div>
+  </div>
+</footer>`
+    )
+  }
+  
+  return content
+}
+
+function applyPageModifications(content, level) {
+  if (level >= 2) {
+    // Replace hero placeholder with complete solution
+    content = content.replace(
+      `<section class="min-h-screen flex items-center justify-center bg-gradient-to-br from-blue-50 to-indigo-100">
+  <!-- ⚠️ COMPLETA AQUÍ LA SECCIÓN HERO -->
+  <div class="max-w-4xl mx-auto px-4 text-center">
+    <h1 class="text-4xl md:text-6xl font-bold text-gray-900 mb-6">
+      Gracias por seguir aquí
+    </h1>
+    <p class="text-lg text-gray-600 mb-8">
+      Abre el proyecto usando <code>code .</code> y sigue las instrucciones. Si tienes dudas, apóyate en el equipo
+    </p>
+  </div>
+</section>`,
+      `<section id="inicio" class="min-h-screen flex items-center justify-center bg-gradient-to-br from-blue-50 to-indigo-100">
+  <div class="max-w-4xl mx-auto px-4 text-center">
+    <div class="animate-fade-in">
+      <h1 class="text-4xl md:text-6xl font-bold text-gray-900 mb-6">
+        Hola, soy {{STUDENT_NAME}}
+      </h1>
+      <p class="text-lg text-gray-600 mb-8 max-w-2xl mx-auto">
+        Soy un desarrollador apasionado por crear productos digitales que impacten positivamente. 
+        Aprendo construyendo y siempre busco nuevos desafíos.
+      </p>
+      <div class="flex justify-center space-x-4">
+        <a href="#proyectos" class="bg-blue-600 hover:bg-blue-700 text-white px-8 py-3 rounded-lg transition-colors duration-200 font-medium">
+          Ver proyectos
+        </a>
+        <a href="#contacto" class="border border-blue-600 text-blue-600 hover:bg-blue-50 px-8 py-3 rounded-lg transition-colors duration-200 font-medium">
+          Contáctame
+        </a>
+      </div>
+    </div>
+  </div>
+</section>`
+    )
+  }
+  
+  if (level >= 3) {
+    // Add complete sections for level 3
+    content = content.replace(
+      `<!-- ⚠️ AQUÍ VAN LAS DEMÁS SECCIONES (SOBRE MÍ, PROYECTOS, CONTACTO) -->
+<!-- Revisa los comentarios arriba para saber qué crear -->`,
+      `<!-- Sobre mí -->
+<section id="sobre-mi" class="py-20 bg-white">
+  <div class="max-w-4xl mx-auto px-4">
+    <div class="text-center mb-16">
+      <h2 class="text-3xl md:text-4xl font-bold text-gray-900 mb-6">Sobre mí</h2>
+      <div class="w-20 h-1 bg-blue-600 mx-auto mb-8"></div>
+    </div>
+    
+    <div class="grid md:grid-cols-2 gap-12 items-center">
+      <div>
+        <div class="bg-gray-100 aspect-square rounded-lg flex items-center justify-center mb-6 md:mb-0">
+          <span class="text-gray-500 text-lg">Tu foto aquí</span>
+        </div>
+      </div>
+      <div>
+        <p class="text-lg text-gray-600 mb-6 leading-relaxed">
+          Soy un desarrollador apasionado por crear productos digitales que impacten positivamente. 
+          Aprendo construyendo y siempre busco nuevos desafíos que me permitan crecer profesionalmente.
+        </p>
+        <div class="grid grid-cols-2 gap-4">
+          <div class="bg-blue-50 p-4 rounded-lg text-center">
+            <div class="text-2xl font-bold text-blue-600">2+</div>
+            <div class="text-sm text-gray-600">Años aprendiendo</div>
+          </div>
+          <div class="bg-green-50 p-4 rounded-lg text-center">
+            <div class="text-2xl font-bold text-green-600">5+</div>
+            <div class="text-sm text-gray-600">Proyectos</div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</section>
+
+<!-- Proyectos -->
+<section id="proyectos" class="py-20 bg-gray-50">
+  <div class="max-w-6xl mx-auto px-4">
+    <div class="text-center mb-16">
+      <h2 class="text-3xl md:text-4xl font-bold text-gray-900 mb-6">Mis Proyectos</h2>
+      <div class="w-20 h-1 bg-blue-600 mx-auto mb-8"></div>
+      <p class="text-lg text-gray-600 max-w-2xl mx-auto">
+        Algunos de los proyectos en los que he trabajado y que demuestran mis habilidades
+      </p>
+    </div>
+    
+    <div class="grid md:grid-cols-2 lg:grid-cols-3 gap-8">
+      <!-- Proyecto 1 -->
+      <div class="bg-white rounded-lg shadow-md overflow-hidden hover:shadow-lg transition-shadow duration-200 project-card">
+        <div class="bg-gradient-to-br from-blue-400 to-blue-600 h-48 flex items-center justify-center">
+          <span class="text-white text-lg font-medium">Proyecto 1</span>
+        </div>
+        <div class="p-6">
+          <h3 class="text-xl font-semibold text-gray-900 mb-3">Nombre del Proyecto</h3>
+          <p class="text-gray-600 mb-4">Descripción breve del proyecto y las tecnologías utilizadas.</p>
+          <div class="flex space-x-3">
+            <a href="#" class="text-blue-600 hover:text-blue-700 text-sm font-medium">Ver código</a>
+            <a href="#" class="text-blue-600 hover:text-blue-700 text-sm font-medium">Ver demo</a>
+          </div>
+        </div>
+      </div>
+      
+      <!-- Proyecto 2 -->
+      <div class="bg-white rounded-lg shadow-md overflow-hidden hover:shadow-lg transition-shadow duration-200 project-card">
+        <div class="bg-gradient-to-br from-green-400 to-green-600 h-48 flex items-center justify-center">
+          <span class="text-white text-lg font-medium">Proyecto 2</span>
+        </div>
+        <div class="p-6">
+          <h3 class="text-xl font-semibold text-gray-900 mb-3">Nombre del Proyecto</h3>
+          <p class="text-gray-600 mb-4">Descripción breve del proyecto y las tecnologías utilizadas.</p>
+          <div class="flex space-x-3">
+            <a href="#" class="text-blue-600 hover:text-blue-700 text-sm font-medium">Ver código</a>
+            <a href="#" class="text-blue-600 hover:text-blue-700 text-sm font-medium">Ver demo</a>
+          </div>
+        </div>
+      </div>
+      
+      <!-- Proyecto 3 -->
+      <div class="bg-white rounded-lg shadow-md overflow-hidden hover:shadow-lg transition-shadow duration-200 project-card">
+        <div class="bg-gradient-to-br from-purple-400 to-purple-600 h-48 flex items-center justify-center">
+          <span class="text-white text-lg font-medium">Proyecto 3</span>
+        </div>
+        <div class="p-6">
+          <h3 class="text-xl font-semibold text-gray-900 mb-3">Nombre del Proyecto</h3>
+          <p class="text-gray-600 mb-4">Descripción breve del proyecto y las tecnologías utilizadas.</p>
+          <div class="flex space-x-3">
+            <a href="#" class="text-blue-600 hover:text-blue-700 text-sm font-medium">Ver código</a>
+            <a href="#" class="text-blue-600 hover:text-blue-700 text-sm font-medium">Ver demo</a>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</section>
+
+<!-- Contacto -->
+<section id="contacto" class="py-20 bg-white">
+  <div class="max-w-4xl mx-auto px-4">
+    <div class="text-center mb-16">
+      <h2 class="text-3xl md:text-4xl font-bold text-gray-900 mb-6">Contacto</h2>
+      <div class="w-20 h-1 bg-blue-600 mx-auto mb-8"></div>
+      <p class="text-lg text-gray-600 max-w-2xl mx-auto">
+        ¿Tienes un proyecto en mente? ¡Hablemos y veamos cómo puedo ayudarte!
+      </p>
+    </div>
+    
+    <div class="grid md:grid-cols-2 gap-12">
+      <div>
+        <h3 class="text-xl font-semibold text-gray-900 mb-6">Información de contacto</h3>
+        <div class="space-y-4">
+          <div class="flex items-center space-x-3">
+            <div class="w-10 h-10 bg-blue-100 rounded-lg flex items-center justify-center">
+              <svg class="w-5 h-5 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 8l7.89 4.26a2 2 0 002.22 0L21 8M5 19h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z"></path>
+              </svg>
+            </div>
+            <div>
+              <p class="text-gray-900 font-medium">Email</p>
+              <p class="text-gray-600">tu.email@ejemplo.com</p>
+            </div>
+          </div>
+          
+          <div class="flex items-center space-x-3">
+            <div class="w-10 h-10 bg-blue-100 rounded-lg flex items-center justify-center">
+              <svg class="w-5 h-5 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17.657 16.657L13.414 20.9a1.998 1.998 0 01-2.827 0l-4.244-4.243a8 8 0 1111.314 0z"></path>
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 11a3 3 0 11-6 0 3 3 0 016 0z"></path>
+              </svg>
+            </div>
+            <div>
+              <p class="text-gray-900 font-medium">Ubicación</p>
+              <p class="text-gray-600">Tu ciudad, País</p>
+            </div>
+          </div>
+        </div>
+        
+        <div class="mt-8">
+          <h4 class="text-lg font-medium text-gray-900 mb-4">Sígueme</h4>
+          <div class="flex space-x-4">
+            <a href="#" class="w-10 h-10 bg-gray-100 hover:bg-blue-100 rounded-lg flex items-center justify-center transition-colors duration-200">
+              <span class="text-gray-600 hover:text-blue-600">LI</span>
+            </a>
+            <a href="#" class="w-10 h-10 bg-gray-100 hover:bg-blue-100 rounded-lg flex items-center justify-center transition-colors duration-200">
+              <span class="text-gray-600 hover:text-blue-600">GH</span>
+            </a>
+            <a href="#" class="w-10 h-10 bg-gray-100 hover:bg-blue-100 rounded-lg flex items-center justify-center transition-colors duration-200">
+              <span class="text-gray-600 hover:text-blue-600">TW</span>
+            </a>
+          </div>
+        </div>
+      </div>
+      
+      <div>
+        <form class="space-y-6">
+          <div>
+            <label for="name" class="block text-sm font-medium text-gray-700 mb-2">Nombre</label>
+            <input type="text" id="name" name="name" class="w-full px-4 py-3 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-600 focus:border-transparent">
+          </div>
+          <div>
+            <label for="email" class="block text-sm font-medium text-gray-700 mb-2">Email</label>
+            <input type="email" id="email" name="email" class="w-full px-4 py-3 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-600 focus:border-transparent">
+          </div>
+          <div>
+            <label for="message" class="block text-sm font-medium text-gray-700 mb-2">Mensaje</label>
+            <textarea id="message" name="message" rows="4" class="w-full px-4 py-3 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-600 focus:border-transparent"></textarea>
+          </div>
+          <button type="submit" class="w-full bg-blue-600 hover:bg-blue-700 text-white px-8 py-3 rounded-lg transition-colors duration-200 font-medium">
+            Enviar mensaje
+          </button>
+        </form>
+      </div>
+    </div>
+  </div>
+</section>`
+    )
+  }
+  
+  return content
+}
+
+function getLevelDescription(level) {
+  const descriptions = {
+    1: 'navbar',
+    2: 'navbar + hero',
+    3: 'todo el portafolio'
+  }
+  return descriptions[level] || 'nivel desconocido'
+}
+
+function isInCretaProject() {
+  // Check if we're in a Creta project by looking for key files
+  let currentDir
+  try {
+    currentDir = process.cwd()
+  } catch (error) {
+    // If we can't get the current directory, we're definitely not in a Creta project
+    console.error('Error: No se puede acceder al directorio actual. Asegúrate de estar en un directorio válido.')
+    return false
+  }
+  
+  const packageJsonPath = path.join(currentDir, 'package.json')
+  const layoutPath = path.join(currentDir, 'src/routes/+layout.svelte')
+  const pagePath = path.join(currentDir, 'src/routes/+page.svelte')
+  
+  // Must have package.json and SvelteKit structure
+  if (!fs.existsSync(packageJsonPath) || !fs.existsSync(layoutPath) || !fs.existsSync(pagePath)) {
+    return false
+  }
+  
+  // Check if layout contains Creta comments
+  try {
+    const layoutContent = fs.readFileSync(layoutPath, 'utf8')
+    return layoutContent.includes('RETO CRETA') || layoutContent.includes('🧭 RETO 1: NAVBAR')
+  } catch (error) {
+    return false
+  }
+}
+
+async function unstuckProject(level) {
+  console.log(`\n🔓 ¡Te ayudo a desbloquear el nivel ${level}!`)
+  console.log(`📚 Agregando código para: ${getLevelDescription(level)}`)
+  
+  try {
+    let currentDir
+    try {
+      currentDir = process.cwd()
+    } catch (error) {
+      console.error('Error: No se puede acceder al directorio actual. Asegúrate de estar en un directorio válido.')
+      process.exit(1)
+    }
+    const layoutPath = path.join(currentDir, 'src/routes/+layout.svelte')
+    const pagePath = path.join(currentDir, 'src/routes/+page.svelte')
+    
+    // Get student name from package.json title if possible
+    let studentName = 'Tu nombre'
+    try {
+      const packageJsonPath = path.join(currentDir, 'package.json')
+      const packageContent = fs.readFileSync(packageJsonPath, 'utf8')
+      const packageJson = JSON.parse(packageContent)
+      if (packageJson.name && packageJson.name.includes('-portafolio')) {
+        studentName = packageJson.name.replace('-portafolio', '').split('-').map(word => 
+          word.charAt(0).toUpperCase() + word.slice(1)
+        ).join(' ')
+      }
+    } catch (error) {
+      // Use default if can't parse
+    }
+    
+    // Apply modifications to existing files
+    if (fs.existsSync(layoutPath)) {
+      let layoutContent = fs.readFileSync(layoutPath, 'utf8')
+      layoutContent = applyLayoutModifications(layoutContent, level)
+      // Replace placeholders in layout
+      layoutContent = layoutContent.replace(/\{\{STUDENT_NAME\}\}/g, studentName)
+      layoutContent = layoutContent.replace(/\{\{PROJECT_NAME\}\}/g, `${studentName.toLowerCase().replace(/\s+/g, '-')}-portafolio`)
+      fs.writeFileSync(layoutPath, layoutContent)
+      console.log(`✅ Actualizado: src/routes/+layout.svelte`)
+    }
+    
+    if (fs.existsSync(pagePath)) {
+      let pageContent = fs.readFileSync(pagePath, 'utf8')
+      pageContent = applyPageModifications(pageContent, level)
+      // Replace placeholders in page
+      pageContent = pageContent.replace(/\{\{STUDENT_NAME\}\}/g, studentName)
+      pageContent = pageContent.replace(/\{\{PROJECT_NAME\}\}/g, `${studentName.toLowerCase().replace(/\s+/g, '-')}-portafolio`)
+      fs.writeFileSync(pagePath, pageContent)
+      console.log(`✅ Actualizado: src/routes/+page.svelte`)
+    }
+    
+    console.log(`\n🎉 ¡Listo! Ahora tienes el código del nivel ${level}`)
+    console.log(`💡 Revisa los archivos actualizados para ver qué se agregó`)
+    console.log(`🚀 Continúa con: npm run dev`)
+    
+  } catch (error) {
+    console.error('Error al actualizar el proyecto:', error.message)
+    process.exit(1)
+  }
+}
+
+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 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.")
+}
+
+async function startMainMenu() {
+  // Always try interactive mode first, fall back only if it fails
+  try {
+    return await startMainMenuInteractive()
+  } catch (error) {
+    // If interactive mode fails, fall back to numbered selection
+    console.log('\nModo interactivo no disponible, usando selección numérica...\n')
+    return await startMainMenuFallback()
+  }
+}
+
+async function startMainMenuInteractive() {
+  // Check if setRawMode is available before trying to use it
+  if (typeof process.stdin.setRawMode !== 'function') {
+    throw new Error('setRawMode not available')
+  }
+
+  console.log("Te ofrecemos las siguientes opciones:")
+
+  const options = [
+    { 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" }
+  ]
+
+  let selectedIndex = 0
+
+  // Enable raw mode to capture arrow keys
+  try {
+    process.stdin.setRawMode(true)
+    process.stdin.resume()
+    process.stdin.setEncoding('utf8')
+  } catch (error) {
+    throw new Error('Failed to enable raw mode: ' + error.message)
+  }
+
+  const renderOptions = () => {
+    // Clear previous output and move cursor to top
+    process.stdout.write('\x1b[2J')
+    process.stdout.write('\x1b[H')
+
+    console.log(`
+█████████████████████████
+█   █   █   █   █   █   █
+█ C █ R █ E █ T █ A █ █ █
+█   █   █   █   █   █   █
+█████████████████████████
+
+Bienvenido a la escuela de software de icarus.mx
+Salgamos de este laberinto 🏛️
+`)
+    console.log("Te ofrecemos las siguientes opciones:")
+
+    options.forEach((option, index) => {
+      const isSelected = index === selectedIndex
+      const prefix = isSelected ? '▶ ' : '  '
+      const highlight = isSelected ? '\x1b[36m' : '\x1b[37m' // cyan for selected, white for normal
+      const reset = '\x1b[0m'
+
+      console.log(`${highlight}${prefix}${index + 1}. ${option.title}${reset}`)
+      console.log("")
+    })
+  }
+
+  return new Promise((resolve) => {
+    renderOptions()
+
+    const onKeyPress = (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 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)
+        }
+        return
+      }
+
+      // Handle arrow keys (escape sequences)
+      if (key === '\u001b[A') { // Up arrow
+        selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : options.length - 1
+        renderOptions()
+      } else if (key === '\u001b[B') { // Down arrow
+        selectedIndex = selectedIndex < options.length - 1 ? selectedIndex + 1 : 0
+        renderOptions()
+      }
+    }
+
+    process.stdin.on('data', onKeyPress)
   })
+}
 
-  // Handle kill signal
-  process.on('SIGTERM', () => {
-    cleanup()
-    process.exit(0)
+async function startMainMenuFallback() {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
   })
 
-  // Handle uncaught exceptions
-  process.on('uncaughtException', (error) => {
-    console.error('\n❌ Error inesperado:', error.message)
-    cleanup()
+  const askQuestion = (question) => {
+    return new Promise((resolve) => {
+      rl.question(question, resolve)
+    })
+  }
+
+  try {
+    console.log("Te ofrecemos las siguientes opciones:")
+    console.log("")
+    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("")
+
+    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")
+      rl.close()
+      return
+    }
+
+    const opcionSeleccionada = parseInt(respuesta)
+
+    if (opcionSeleccionada === 1) {
+      rl.close()
+      await startSintaxisSelector()
+    } else if (opcionSeleccionada === 2) {
+      rl.close()
+      await startEnunciadosSelector()
+    } else if (opcionSeleccionada === 3) {
+      rl.close()
+      await startProyectosSelector()
+    } else if (opcionSeleccionada === 4) {
+      rl.close()
+      const executor = new PapersExecutor()
+      await executor.execute()
+    } else {
+      console.log("❌ Opción no válida. Elige 1, 2, 3 o 4.")
+      rl.close()
+    }
+
+  } catch (error) {
+    console.error('Error:', error.message)
+    rl.close()
     process.exit(1)
+  }
+}
+
+async function startEnunciadosSelector() {
+  // Always try interactive mode first, fall back only if it fails
+  try {
+    return await startEnunciadosSelectorInteractive()
+  } catch (error) {
+    // If interactive mode fails, fall back to numbered selection
+    console.log('\nModo interactivo no disponible, usando selección numérica...\n')
+    return await startEnunciadosSelectorFallback()
+  }
+}
+
+async function startEnunciadosSelectorInteractive() {
+  // Check if setRawMode is available before trying to use it
+  if (typeof process.stdin.setRawMode !== 'function') {
+    throw new Error('setRawMode not available')
+  }
+
+  console.log("Los enunciados fundamentales son un conjunto de afirmaciones que tienen el propósito de ejercitar el pensamiento orientado a objetos de los estudiantes de Creta.")
+  console.log("")
+  console.log("Escogimos estos enunciados porque creemos que exhaustan los conceptos mínimos necesarios para entender el paradigma de la programación orientada a objetos.")
+
+  // Wait for user to press Enter before showing the list
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  })
+
+  await new Promise((resolve) => {
+    rl.question("\nPresiona Enter para comenzar...", () => {
+      rl.close()
+      resolve()
+    })
+  })
+
+  console.log("\n\n")
+  console.log("Elige qué enunciado te gustaría explorar:")
+  console.log("")
+
+  let selectedIndex = 0
+  let running = true
+
+  // Enable raw mode to capture arrow keys
+  try {
+    process.stdin.setRawMode(true)
+    process.stdin.resume()
+    process.stdin.setEncoding('utf8')
+  } catch (error) {
+    throw new Error('Failed to enable raw mode: ' + error.message)
+  }
+
+  const renderOptions = () => {
+    // Clear previous output and move cursor to top
+    process.stdout.write('\x1b[2J')
+    process.stdout.write('\x1b[H')
+
+    console.log("Los enunciados fundamentales son un conjunto de afirmaciones que tienen el propósito de ejercitar el pensamiento orientado a objetos de los estudiantes de Creta.")
+  console.log("")
+  console.log("Escogimos estos enunciados porque creemos que exhaustan los conceptos mínimos necesarios para entender el paradigma de la programación orientada a objetos.")
+    console.log("")
+    console.log("Elige qué enunciado te gustaría explorar:")
+    console.log("")
+
+    ENUNCIADOS.forEach((enunciado, index) => {
+      const isSelected = index === selectedIndex
+      const prefix = isSelected ? '▶ ' : '  '
+      const highlight = isSelected ? '\x1b[36m' : '\x1b[37m' // cyan for selected, white for normal
+      const reset = '\x1b[0m'
+
+      // Format the enunciado text with proper indentation for lists
+      let formattedText = enunciado.texto
+      if (enunciado.id === 4) {
+        // Special formatting for enunciado 4 with list items
+        formattedText = formattedText.replace(/\n([abc])\)/g, '\n         $1)')
+        formattedText = formattedText.replace(/\n\nEstos tres elementos/g, '\n\n         Estos tres elementos')
+      }
+      console.log(`${highlight}${prefix}${index + 1}. ${formattedText}${reset}`)
+      console.log("")
+    })
+  }
+
+  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 enunciadoSeleccionado = ENUNCIADOS[selectedIndex]
+
+        // Clear screen and show selection
+        process.stdout.write('\x1b[2J')
+        process.stdout.write('\x1b[H')
+
+        // Check if we have a lesson implementation for this enunciado
+        if (enunciadoSeleccionado.id === 1) {
+          console.log(`${enunciadoSeleccionado.texto}`)
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson1 = new LessonBuilder(LESSON_1_SYSTEM_DECOMPOSITION)
+            await lesson1.start()
+            await returnToMainMenu()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+            await returnToMainMenu()
+          }
+        } else if (enunciadoSeleccionado.id === 1) {
+          console.log(`${enunciadoSeleccionado.texto}`)
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson1 = new LessonBuilder(LESSON_1_SYSTEM_DECOMPOSITION)
+            await lesson1.start()
+            await returnToMainMenu()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+            await returnToMainMenu()
+          }
+        } else if (enunciadoSeleccionado.id === 2) {
+          console.log(`${enunciadoSeleccionado.texto}`)
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson2 = new LessonBuilder(LESSON_2_OBJECT_REQUESTS)
+            await lesson2.start()
+            await returnToMainMenu()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+            await returnToMainMenu()
+          }
+        } else if (enunciadoSeleccionado.id === 3) {
+          console.log(`${enunciadoSeleccionado.texto}`)
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson3 = new LessonBuilder(LESSON_3_ONLY_WAY)
+            await lesson3.start()
+            await returnToMainMenu()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+            await returnToMainMenu()
+          }
+        } else if (enunciadoSeleccionado.id === 4) {
+          console.log(`${enunciadoSeleccionado.texto}`)
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson4 = new LessonBuilder(LESSON_4_OPERATION_SIGNATURES)
+            await lesson4.start()
+            await returnToMainMenu()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+            await returnToMainMenu()
+          }
+        } else if (enunciadoSeleccionado.id === 5) {
+          console.log(`${enunciadoSeleccionado.texto}`)
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson5 = new LessonBuilder(LESSON_5_INTERFACE_SET)
+            await lesson5.start()
+            await returnToMainMenu()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+            await returnToMainMenu()
+          }
+        } else if (enunciadoSeleccionado.id === 6) {
+          console.log(`${enunciadoSeleccionado.texto}`)
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson6 = new LessonBuilder(LESSON_6_INTERFACE_DESIGN)
+            await lesson6.start()
+            await returnToMainMenu()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+            await returnToMainMenu()
+          }
+        } else if (enunciadoSeleccionado.id === 7) {
+          console.log(`${enunciadoSeleccionado.texto}`)
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson7 = new LessonBuilder(LESSON_7_OBJECT_DEFINITION)
+            await lesson7.start()
+            await returnToMainMenu()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+            await returnToMainMenu()
+          }
+        } else {
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+
+          console.log("\n💭 Por ahora, reflexiona: ¿qué parte específica de este enunciado")
+          console.log("   te genera más curiosidad o confusión?")
+        }
+
+        resolve()
+        return
+      }
+
+      // Handle arrow keys (escape sequences)
+      if (key === '\u001b[A') { // Up arrow
+        selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : ENUNCIADOS.length - 1
+        renderOptions()
+      } else if (key === '\u001b[B') { // Down arrow
+        selectedIndex = selectedIndex < ENUNCIADOS.length - 1 ? selectedIndex + 1 : 0
+        renderOptions()
+      }
+    }
+
+    process.stdin.on('data', onKeyPress)
   })
 }
 
-setupExitHandlers()
+async function startEnunciadosSelectorFallback() {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  })
 
-try {
-  const exitCode = await runCLI(process.argv.slice(2))
-  process.exit(exitCode)
-} catch (error) {
-  console.error('\n❌ Ocurrió un error inesperado:', error.message)
-  process.exit(1)
+  const askQuestion = (question) => {
+    return new Promise((resolve) => {
+      rl.question(question, resolve)
+    })
+  }
+
+  try {
+    console.log("Los enunciados fundamentales son un conjunto de afirmaciones que tienen el propósito de ejercitar el pensamiento orientado a objetos de los estudiantes de Creta.")
+  console.log("")
+  console.log("Escogimos estos enunciados porque creemos que exhaustan los conceptos mínimos necesarios para entender el paradigma de la programación orientada a objetos.")
+
+    await askQuestion("\nPresiona Enter para comenzar...")
+
+    console.log("\n\n")
+    console.log("Elige qué enunciado te gustaría explorar:")
+    console.log("")
+
+    ENUNCIADOS.forEach((enunciado, index) => {
+      // Format the enunciado text with proper indentation for lists
+      let formattedText = enunciado.texto
+      if (enunciado.id === 4) {
+        // Special formatting for enunciado 4 with list items
+        formattedText = formattedText.replace(/\n([abc])\)/g, '\n      $1)')
+        formattedText = formattedText.replace(/\n\nEstos tres elementos/g, '\n\n      Estos tres elementos')
+      }
+      console.log(`${index + 1}. ${formattedText}`)
+      console.log("")
+    })
+
+    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")
+      rl.close()
+      return
+    }
+
+    const numeroSeleccionado = parseInt(respuesta)
+
+    if (numeroSeleccionado >= 1 && numeroSeleccionado <= 7) {
+      const enunciadoSeleccionado = ENUNCIADOS[numeroSeleccionado - 1]
+
+      // Check if we have a lesson implementation for this enunciado
+      if (enunciadoSeleccionado.id === 1) {
+        console.log(`${enunciadoSeleccionado.texto}`)
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson1 = new LessonBuilder(LESSON_1_SYSTEM_DECOMPOSITION)
+          await lesson1.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 1) {
+        console.log(`${enunciadoSeleccionado.texto}`)
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson1 = new LessonBuilder(LESSON_1_SYSTEM_DECOMPOSITION)
+          await lesson1.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 2) {
+        console.log(`${enunciadoSeleccionado.texto}`)
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson2 = new LessonBuilder(LESSON_2_OBJECT_REQUESTS)
+          await lesson2.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 3) {
+        console.log(`${enunciadoSeleccionado.texto}`)
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson3 = new LessonBuilder(LESSON_3_ONLY_WAY)
+          await lesson3.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 4) {
+        console.log(`${enunciadoSeleccionado.texto}`)
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson4 = new LessonBuilder(LESSON_4_OPERATION_SIGNATURES)
+          await lesson4.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 5) {
+        console.log(`${enunciadoSeleccionado.texto}`)
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson5 = new LessonBuilder(LESSON_5_INTERFACE_SET)
+          await lesson5.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 6) {
+        console.log(`${enunciadoSeleccionado.texto}`)
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson6 = new LessonBuilder(LESSON_6_INTERFACE_DESIGN)
+          await lesson6.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 7) {
+        console.log(`${enunciadoSeleccionado.texto}`)
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson7 = new LessonBuilder(LESSON_7_OBJECT_DEFINITION)
+          await lesson7.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else {
+        console.log("\n🚀 Próximamente:")
+        console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+        console.log("- Ejercicios prácticos que ilustren el concepto")
+        console.log("- Proyectos específicos para internalizar la idea")
+
+        console.log("\n💭 Por ahora, reflexiona: ¿qué parte específica de este enunciado")
+        console.log("   te genera más curiosidad o confusión?")
+      }
+
+    } else {
+      console.log("❌ Opción no válida. Elige un número entre 1 y 7.")
+    }
+
+    rl.close()
+  } catch (error) {
+    console.error('Error:', error.message)
+    rl.close()
+    process.exit(1)
+  }
+}
+
+
+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")
+}
+
+async function startProyectosSelector() {
+  // Always try interactive mode first, fall back only if it fails
+  try {
+    return await startProyectosSelectorInteractive()
+  } catch (error) {
+    // If interactive mode fails, fall back to numbered selection
+    console.log('\nModo interactivo no disponible, usando selección numérica...\n')
+    return await startProyectosSelectorFallback()
+  }
+}
+
+async function startProyectosSelectorInteractive() {
+  // Check if setRawMode is available before trying to use it
+  if (typeof process.stdin.setRawMode !== 'function') {
+    throw new Error('setRawMode not available')
+  }
+
+  console.log("\n🚀 Construir Proyectos")
+  console.log("Elige qué proyecto quieres construir:")
+
+  const projects = [
+    { id: 1, title: "🔀 Construye una pull-request", type: 'pr' },
+    { id: 2, title: "🎨 Construye tu portafolio", type: 'portfolio' }
+  ]
+
+  let selectedIndex = 0
+
+  // Enable raw mode to capture arrow keys
+  try {
+    process.stdin.setRawMode(true)
+    process.stdin.resume()
+    process.stdin.setEncoding('utf8')
+  } catch (error) {
+    throw new Error('Failed to enable raw mode: ' + error.message)
+  }
+
+  const renderOptions = () => {
+    // Clear previous output and move cursor to top
+    process.stdout.write('\x1b[2J')
+    process.stdout.write('\x1b[H')
+
+    console.log("🚀 Construir Proyectos")
+    console.log("Elige qué proyecto quieres construir:")
+
+    projects.forEach((project, index) => {
+      const isSelected = index === selectedIndex
+      const prefix = isSelected ? '▶ ' : '  '
+      const highlight = isSelected ? '\x1b[36m' : '\x1b[37m' // cyan for selected, white for normal
+      const reset = '\x1b[0m'
+
+      console.log(`${highlight}${prefix}${project.title}${reset}`)
+      console.log("")
+    })
+  }
+
+  return new Promise((resolve) => {
+    renderOptions()
+
+    const onKeyPress = (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 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)
+        }
+        return
+      }
+
+      // Handle arrow keys (escape sequences)
+      if (key === '\u001b[A') { // Up arrow
+        selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : projects.length - 1
+        renderOptions()
+      } else if (key === '\u001b[B') { // Down arrow
+        selectedIndex = selectedIndex < projects.length - 1 ? selectedIndex + 1 : 0
+        renderOptions()
+      }
+    }
+
+    process.stdin.on('data', onKeyPress)
+  })
+}
+
+async function returnToMainMenu() {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  })
+
+  const askQuestion = (question) => {
+    return new Promise((resolve) => {
+      rl.question(question, resolve)
+    })
+  }
+
+  console.log("\n🏠 ¿Qué te gustaría hacer ahora?")
+  console.log("1. Volver al menú principal")
+  console.log("2. Salir")
+
+  const respuesta = await askQuestion("\nElige una opción (1-2): ")
+
+  if (respuesta === '1') {
+    rl.close()
+    console.clear()
+    await startMainMenu()
+  } else {
+    console.log("\nHecho con <3 por icarus.mx")
+    rl.close()
+  }
+}
+
+async function startProyectosSelectorFallback() {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  })
+
+  const askQuestion = (question) => {
+    return new Promise((resolve) => {
+      rl.question(question, resolve)
+    })
+  }
+
+  try {
+    console.log("\n🚀 Construir Proyectos")
+    console.log("Elige qué proyecto quieres construir:")
+    console.log("")
+    console.log("1. 🔀 Construye una pull-request")
+    console.log("2. 🎨 Construye tu portafolio")
+    console.log("")
+
+    const respuesta = await askQuestion("Elige una opción (1-2) 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) {
+      rl.close()
+      await startPullRequestTutorial()
+    } else if (opcionSeleccionada === 2) {
+      rl.close()
+      await startPortfolioSelector()
+    } else {
+      console.log("❌ Opción no válida. Elige 1 o 2.")
+      rl.close()
+    }
+
+  } catch (error) {
+    console.error('Error:', error.message)
+    rl.close()
+    process.exit(1)
+  }
+}
+
+async function startPortfolioSelector() {
+  // Always try interactive mode first, fall back only if it fails
+  try {
+    return await startPortfolioSelectorInteractive()
+  } catch (error) {
+    // If interactive mode fails, fall back to numbered selection
+    console.log('\nModo interactivo no disponible, usando selección numérica...\n')
+    return await startPortfolioSelectorFallback()
+  }
+}
+
+async function startPortfolioSelectorInteractive() {
+  // Check if setRawMode is available before trying to use it
+  if (typeof process.stdin.setRawMode !== 'function') {
+    throw new Error('setRawMode not available')
+  }
+
+  console.log("\n🎨 Construye tu Portafolio")
+  console.log("Elige el nivel:")
+
+  const projects = [
+    { id: 1, title: "🎨 Portafolio Personal", description: "Reto completo", level: 0 },
+    { id: 2, title: "🔓 Portafolio Nivel 1", description: "Solo navbar", level: 1 },
+    { id: 3, title: "🔓 Portafolio Nivel 2", description: "Navbar + hero", level: 2 },
+    { id: 4, title: "🔓 Portafolio Nivel 3", description: "Solución completa", level: 3 }
+  ]
+
+  let selectedIndex = 0
+
+  // Enable raw mode to capture arrow keys
+  try {
+    process.stdin.setRawMode(true)
+    process.stdin.resume()
+    process.stdin.setEncoding('utf8')
+  } catch (error) {
+    throw new Error('Failed to enable raw mode: ' + error.message)
+  }
+
+  const renderOptions = () => {
+    // Clear previous output and move cursor to top
+    process.stdout.write('\x1b[2J')
+    process.stdout.write('\x1b[H')
+
+    console.log("🎨 Construye tu Portafolio")
+    console.log("Elige el nivel:")
+
+    projects.forEach((project, index) => {
+      const isSelected = index === selectedIndex
+      const prefix = isSelected ? '▶ ' : '  '
+      const highlight = isSelected ? '\x1b[36m' : '\x1b[37m' // cyan for selected, white for normal
+      const reset = '\x1b[0m'
+
+      console.log(`${highlight}${prefix}${project.title}${reset}`)
+      if (isSelected) {
+        console.log(`${highlight}     ${project.description}${reset}`)
+      }
+      console.log("")
+    })
+  }
+
+  return new Promise((resolve) => {
+    renderOptions()
+
+    const onKeyPress = (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 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
+        renderOptions()
+      } else if (key === '\u001b[B') { // Down arrow
+        selectedIndex = selectedIndex < projects.length - 1 ? selectedIndex + 1 : 0
+        renderOptions()
+      }
+    }
+
+    process.stdin.on('data', onKeyPress)
+  })
+}
+
+async function startPortfolioSelectorFallback() {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  })
+
+  const askQuestion = (question) => {
+    return new Promise((resolve) => {
+      rl.question(question, resolve)
+    })
+  }
+
+  try {
+    console.log("\n🎨 Construye tu Portafolio")
+    console.log("Elige el nivel:")
+    console.log("")
+    console.log("1. 🎨 Portafolio Personal - Reto completo")
+    console.log("2. 🔓 Portafolio Nivel 1 - Solo navbar")
+    console.log("3. 🔓 Portafolio Nivel 2 - Navbar + hero")
+    console.log("4. 🔓 Portafolio Nivel 3 - Solución completa")
+    console.log("")
+
+    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")
+      rl.close()
+      return
+    }
+
+    const opcionSeleccionada = parseInt(respuesta)
+
+    if (opcionSeleccionada >= 1 && opcionSeleccionada <= 4) {
+      rl.close()
+
+      // Map selection to portfolio level
+      const level = opcionSeleccionada === 1 ? 0 : opcionSeleccionada - 1
+
+      // Check if we're in an existing Creta project
+      if (level > 0 && isInCretaProject()) {
+        await unstuckProject(level)
+      } else {
+        await createPortfolioProject(level)
+      }
+    } else {
+      console.log("❌ Opción no válida. Elige un número entre 1 y 4.")
+      rl.close()
+    }
+
+  } catch (error) {
+    console.error('Error:', error.message)
+    rl.close()
+    process.exit(1)
+  }
+}
+
+async function startPullRequestTutorial() {
+  try {
+    const tutorial = new PullRequestTutorial()
+    await tutorial.start()
+
+    // Volver al menú principal después de completar el tutorial
+    await returnToMainMenu()
+  } catch (error) {
+    console.error("\n❌ Error al ejecutar el tutorial:", error.message)
+    console.log("\nSi el problema persiste, contacta al equipo de Creta.")
+
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+
+    await new Promise((resolve) => {
+      rl.question("\nPresiona Enter para volver al menú principal...", () => {
+        rl.close()
+        resolve()
+      })
+    })
+
+    await startMainMenu()
+  }
+}
+
+// Helper function to detect command help requests
+function isCommandHelpRequest(args) {
+  // List of supported commands for help
+  const basicCommands = ['ls', 'cd', 'mkdir', 'touch', 'wc']
+  const gitCommands = ['git status', 'git add', 'git commit', 'git push', 'git log']
+
+  const commandString = args.join(' ')
+
+  // Check basic commands
+  if (basicCommands.includes(args[0])) {
+    return true
+  }
+
+  // Check git commands (two words)
+  if (args[0] === 'git' && args.length >= 2) {
+    const gitCommand = `${args[0]} ${args[1]}`
+    return gitCommands.includes(gitCommand)
+  }
+
+  return false
 }