@icarusmx/creta 1.3.4 → 1.4.0

package/lib/executors/portfolio-executor.js

@@ -0,0 +1,167 @@
+import fs from 'fs'
+import path from 'path'
+import { MenuBuilder } from '../builders/MenuBuilder.js'
+import { ProjectBuilder } from '../builders/ProjectBuilder.js'
+import { PORTFOLIO_MENU_CONFIG } from '../data/menus.js'
+import { createPromptInterface, askQuestion } from '../utils/input.js'
+import { SVELTEKIT_PORTFOLIO_TEMPLATE_PATH } from '../constants/paths.js'
+import { LevelModifier } from '../templates/LevelModifier.js'
+
+const DEFAULT_STUDENT_NAME = 'Tu nombre'
+
+function getLevelDescription(level) {
+  const descriptions = {
+    1: 'navbar',
+    2: 'navbar + hero',
+    3: 'todo el portafolio'
+  }
+  return descriptions[level] || 'reto completo'
+}
+
+function slugifyName(name) {
+  return name.trim().toLowerCase().replace(/\s+/g, '-') || 'creta-portafolio'
+}
+
+function deriveStudentName(packageJsonPath) {
+  try {
+    const raw = fs.readFileSync(packageJsonPath, 'utf8')
+    const data = JSON.parse(raw)
+    if (typeof data.name === 'string' && data.name.includes('-portafolio')) {
+      return data.name
+        .replace('-portafolio', '')
+        .split('-')
+        .map(segment => segment.charAt(0).toUpperCase() + segment.slice(1))
+        .join(' ')
+    }
+  } catch (error) {
+    // ignore and fall back to default name
+  }
+  return DEFAULT_STUDENT_NAME
+}
+
+function isInCretaProject() {
+  let cwd
+  try {
+    cwd = process.cwd()
+  } catch (error) {
+    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(cwd, 'package.json')
+  const layoutPath = path.join(cwd, 'src/routes/+layout.svelte')
+  const pagePath = path.join(cwd, 'src/routes/+page.svelte')
+
+  if (!fs.existsSync(packageJsonPath) || !fs.existsSync(layoutPath) || !fs.existsSync(pagePath)) {
+    return false
+  }
+
+  try {
+    const layoutContent = fs.readFileSync(layoutPath, 'utf8')
+    return layoutContent.includes('RETO CRETA') || layoutContent.includes('🧭 RETO 1: NAVBAR')
+  } catch (error) {
+    return false
+  }
+}
+
+async function promptStudentName() {
+  const rl = createPromptInterface()
+  const name = await askQuestion(rl, '¿Cuál es tu nombre? ') || DEFAULT_STUDENT_NAME
+  rl.close()
+  return name
+}
+
+function applyLevelToFile(filePath, level, studentName) {
+  if (!fs.existsSync(filePath)) {
+    return false
+  }
+
+  const modifier = new LevelModifier(level)
+  let content = fs.readFileSync(filePath, 'utf8')
+  content = modifier.apply(content, path.basename(filePath))
+
+  const projectSlug = slugifyName(studentName)
+  content = content.replace(/\{\{STUDENT_NAME\}\}/g, studentName)
+  content = content.replace(/\{\{PROJECT_NAME\}\}/g, `${projectSlug}-portafolio`)
+
+  fs.writeFileSync(filePath, content)
+  return true
+}
+
+async function createPortfolioProject(level) {
+  const name = await promptStudentName()
+  const projectSlug = slugifyName(name)
+  const projectName = `${projectSlug}-portafolio`
+  const targetPath = path.join(process.cwd(), projectName)
+
+  console.log(`\n🚀 Creando proyecto: ${projectName}`)
+  console.log(`📚 Nivel: ${level === 0 ? 'Reto completo' : `Con ${getLevelDescription(level)} completado`}`)
+
+  const builder = new ProjectBuilder(SVELTEKIT_PORTFOLIO_TEMPLATE_PATH)
+  builder.createProject(targetPath, 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')
+}
+
+async function unlockExistingProject(level) {
+  console.log(`\n🔓 ¡Te ayudo a desbloquear el nivel ${level}!`)
+  console.log(`📚 Agregando código para: ${getLevelDescription(level)}`)
+
+  let cwd
+  try {
+    cwd = process.cwd()
+  } catch (error) {
+    throw new Error('No se puede acceder al directorio actual. Asegúrate de estar en un directorio válido.')
+  }
+
+  const packageJsonPath = path.join(cwd, 'package.json')
+  const studentName = deriveStudentName(packageJsonPath)
+
+  const layoutPath = path.join(cwd, 'src/routes/+layout.svelte')
+  const pagePath = path.join(cwd, 'src/routes/+page.svelte')
+
+  if (applyLevelToFile(layoutPath, level, studentName)) {
+    console.log('✅ Actualizado: src/routes/+layout.svelte')
+  }
+
+  if (applyLevelToFile(pagePath, level, studentName)) {
+    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')
+}
+
+async function runPortfolioFlow(level) {
+  try {
+    if (level > 0 && isInCretaProject()) {
+      await unlockExistingProject(level)
+    } else {
+      await createPortfolioProject(level)
+    }
+  } catch (error) {
+    console.error('Error al preparar el portafolio:', error.message)
+    throw error
+  }
+}
+
+export async function executePortfolio(level = 0) {
+  await runPortfolioFlow(level)
+}
+
+export async function executePortfolioMenu() {
+  const menu = new MenuBuilder(PORTFOLIO_MENU_CONFIG)
+  const choice = await menu.show()
+
+  if (!choice) {
+    return
+  }
+
+  const level = typeof choice.level === 'number' ? choice.level : choice.id || 0
+  await runPortfolioFlow(level)
+}

package/lib/executors/proyectos-executor.js

@@ -0,0 +1,23 @@
+import { MenuBuilder } from '../builders/MenuBuilder.js'
+import { PROYECTOS_MENU_CONFIG } from '../data/menus.js'
+import { PullRequestTutorial } from '../pr-tutorial.js'
+import { executePortfolioMenu } from './portfolio-executor.js'
+
+export async function executeProyectos() {
+  const menu = new MenuBuilder(PROYECTOS_MENU_CONFIG)
+  const choice = await menu.show()
+
+  if (!choice) {
+    return
+  }
+
+  if (choice.id === 'pr') {
+    const tutorial = new PullRequestTutorial()
+    await tutorial.start()
+    return
+  }
+
+  if (choice.id === 'portfolio') {
+    await executePortfolioMenu()
+  }
+}

package/lib/executors/sintaxis-executor.js

@@ -0,0 +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/templates/LevelModifier.js

@@ -0,0 +1,287 @@
+export class LevelModifier {
+  constructor(level) {
+    this.level = level
+  }
+
+  apply(content, filename) {
+    if (this.level === 0) {
+      return content
+    }
+
+    if (filename === '+layout.svelte') {
+      return this.applyLayoutModifications(content)
+    }
+
+    if (filename === '+page.svelte') {
+      return this.applyPageModifications(content)
+    }
+
+    return content
+  }
+
+  applyLayoutModifications(content) {
+    if (this.level >= 1) {
+      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 (this.level >= 3) {
+      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
+  }
+
+  applyPageModifications(content) {
+    if (this.level >= 2) {
+      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 (this.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
+  }
+}

package/lib/utils/file-utils.js

@@ -0,0 +1,18 @@
+import path from 'path'
+
+export const BINARY_EXTENSIONS = new Set([
+  '.png',
+  '.jpg',
+  '.jpeg',
+  '.gif',
+  '.svg',
+  '.ico',
+  '.woff',
+  '.woff2',
+  '.ttf',
+  '.eot'
+])
+
+export function isBinaryFile(filePath) {
+  return BINARY_EXTENSIONS.has(path.extname(filePath).toLowerCase())
+}

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/input.js

@@ -0,0 +1,15 @@
+import { createInterface } from 'readline'
+
+export function createPromptInterface(options = {}) {
+  return createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    ...options
+  })
+}
+
+export function askQuestion(rl, question) {
+  return new Promise((resolve) => {
+    rl.question(question, resolve)
+  })
+}

package/lib/utils/output.js

@@ -0,0 +1,4 @@
+export function clearConsole() {
+  process.stdout.write('\x1b[2J')
+  process.stdout.write('\x1b[H')
+}

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
+    }
+  }
+}