@icarusmx/creta 1.4.19 → 1.5.3

package/lib/data/command-help/wc.js

@@ -0,0 +1,43 @@
+export const wc = {
+  command: 'wc',
+  description: 'Cuenta líneas, palabras y caracteres en archivos (Word Count)',
+  usage: 'wc [opciones] archivo',
+  commonOptions: [
+    {
+      flag: '-l',
+      description: 'Solo contar líneas'
+    },
+    {
+      flag: '-w',
+      description: 'Solo contar palabras'
+    },
+    {
+      flag: '-c',
+      description: 'Solo contar caracteres (bytes)'
+    }
+  ],
+  examples: [
+    {
+      command: 'wc archivo.txt',
+      description: 'Contar líneas, palabras y caracteres'
+    },
+    {
+      command: 'wc -l archivo.txt',
+      description: 'Solo contar cuántas líneas tiene el archivo'
+    },
+    {
+      command: 'ls | wc -l',
+      description: 'Contar cuántos archivos hay en el directorio'
+    },
+    {
+      command: 'wc -l *.js',
+      description: 'Contar líneas de todos los archivos .js'
+    }
+  ],
+  relatedLesson: 'Piping y redirección',
+  tips: [
+    'Muy útil con pipes para contar resultados',
+    'Ejemplo: git log --oneline | wc -l = contar commits',
+    'Puedes usar wc con múltiples archivos para ver totales'
+  ]
+}

package/lib/data/messages.js

@@ -11,17 +11,29 @@ Salgamos de este laberinto 🏛️
 
 export const HELP_TEXT = `
 📚 Comandos disponibles:
-  creta                - Explora los 7 enunciados fundamentales (comando principal) 🧠
-  creta enunciados     - Explora los 7 enunciados fundamentales 🧠
+
+🎓 Aprendizaje:
+  creta                - Menú principal (recomendado para empezar)
+  creta sintaxis       - Aprende terminal, Git, piping y scripts (¡con práctica interactiva!) 💻
+  creta enunciados     - Explora los 7 enunciados fundamentales (conceptos OOP) 🧠
+  creta proyectos      - Ver proyectos disponibles
+
+🚀 Portafolios:
   creta portafolio     - Crea tu portafolio personal (reto completo)
   creta portafolio-1   - Desbloquea nivel 1 (navbar) 🔓
   creta portafolio-2   - Desbloquea nivel 2 (navbar + hero) 🔓
   creta portafolio-3   - Desbloquea nivel 3 (solución completa) 🔓
+
+🛠️ Utilidades:
   creta code           - Inicia sesión interactiva de programación 🤖
+  creta reset          - Reinicia tu estado de usuario (nombre, progreso) 🗑️
+  creta icarus-terminal  - Personaliza tu terminal con tema de Icarus
+  creta revert-terminal  - Revertir personalización de terminal
   creta help           - Muestra esta ayuda
 
-💡 Tip: Si estás dentro de un proyecto existente, los comandos
-    portafolio-1/2/3 actualizarán tus archivos directamente
+💾 Datos locales:
+  ~/.creta/user.json           - Tu perfil (usa 'creta reset' para borrar)
+  /tmp/creta-practice-*        - Sandboxes temporales (limpieza automática)
 
 🎯 La filosofía Creta: partir de enunciados que generan 'ruido' para
    construir comprensión real, no solo sintaxis.

package/lib/executors/CommandHelpExecutor.js

@@ -0,0 +1,93 @@
+import chalk from 'chalk'
+import * as commandHelp from '../data/command-help/index.js'
+
+export class CommandHelpExecutor {
+  constructor(commandArgs) {
+    this.commandArgs = commandArgs // e.g., ['ls'] or ['git', 'status']
+  }
+
+  async execute() {
+    const commandKey = this.commandArgs.join(' ')
+    const helpDataKey = commandHelp.commandMap[commandKey]
+
+    if (!helpDataKey) {
+      this.showNotFound(commandKey)
+      return
+    }
+
+    const helpData = commandHelp[helpDataKey]
+    this.renderHelp(helpData)
+  }
+
+  renderHelp(data) {
+    console.log('')
+    console.log(chalk.bold.cyan(`📘 ${data.command}`))
+    console.log(chalk.dim('─'.repeat(60)))
+    console.log('')
+
+    // Description
+    console.log(chalk.white(data.description))
+    console.log('')
+
+    // Usage
+    console.log(chalk.bold('Uso:'))
+    console.log(chalk.yellow(`  ${data.usage}`))
+    console.log('')
+
+    // Common Options
+    if (data.commonOptions && data.commonOptions.length > 0) {
+      console.log(chalk.bold('Opciones comunes:'))
+      data.commonOptions.forEach(opt => {
+        console.log(chalk.cyan(`  ${opt.flag}`))
+        console.log(chalk.dim(`    ${opt.description}`))
+      })
+      console.log('')
+    }
+
+    // Examples
+    if (data.examples && data.examples.length > 0) {
+      console.log(chalk.bold('Ejemplos:'))
+      data.examples.forEach(ex => {
+        console.log(chalk.green(`  $ ${ex.command}`))
+        console.log(chalk.dim(`    ${ex.description}`))
+        console.log('')
+      })
+    }
+
+    // Tips
+    if (data.tips && data.tips.length > 0) {
+      console.log(chalk.bold.yellow('💡 Tips:'))
+      data.tips.forEach(tip => {
+        console.log(chalk.yellow(`  • ${tip}`))
+      })
+      console.log('')
+    }
+
+    // Related Lesson
+    if (data.relatedLesson) {
+      console.log(chalk.dim(`📚 Lección relacionada: ${data.relatedLesson}`))
+      console.log(chalk.dim(`   Ejecuta: creta sintaxis`))
+      console.log('')
+    }
+  }
+
+  showNotFound(commandKey) {
+    console.log('')
+    console.log(chalk.red(`❌ No tenemos ayuda para: ${chalk.bold(commandKey)}`))
+    console.log('')
+    console.log(chalk.dim('Comandos disponibles:'))
+    console.log('')
+
+    console.log(chalk.bold('  Básicos:'))
+    console.log(chalk.cyan('    ls, cd, mkdir, touch, wc'))
+    console.log('')
+
+    console.log(chalk.bold('  Git:'))
+    console.log(chalk.cyan('    git status, git add, git commit, git push, git log'))
+    console.log('')
+
+    console.log(chalk.dim('💡 Ejemplo: creta ls'))
+    console.log(chalk.dim('💡 Ejemplo: creta git status'))
+    console.log('')
+  }
+}

package/lib/papers/AccessControl.js

@@ -0,0 +1,121 @@
+import fs from 'fs'
+import path from 'path'
+import os from 'os'
+
+export class AccessControl {
+  constructor() {
+    this.userFilePath = path.join(os.homedir(), '.creta', 'user.json')
+  }
+
+  getUserData() {
+    try {
+      if (!fs.existsSync(this.userFilePath)) {
+        return this.getDefaultUser()
+      }
+      const data = fs.readFileSync(this.userFilePath, 'utf8')
+      return JSON.parse(data)
+    } catch (error) {
+      return this.getDefaultUser()
+    }
+  }
+
+  getDefaultUser() {
+    return {
+      name: 'guest',
+      lessonsCompleted: [],
+      projectsCreated: [],
+      papersCompleted: []
+    }
+  }
+
+  // Paper unlock requirements
+  getPaperRequirements() {
+    return {
+      'mapreduce': {
+        name: 'MapReduce (2004)',
+        description: 'Procesamiento de datos en paralelo',
+        requirement: 'Completa 3+ lecciones de sintaxis',
+        check: (user) => {
+          const sintaxisLessons = user.lessonsCompleted.filter(l =>
+            l.id && l.id.includes('sintaxis')
+          ).length
+          return sintaxisLessons >= 3
+        }
+      },
+      'bitcoin': {
+        name: 'Bitcoin (2008)',
+        description: 'Blockchain y consenso descentralizado',
+        requirement: 'Completa MapReduce + 1 proyecto',
+        check: (user) => {
+          const hasMapReduce = user.papersCompleted?.some(p => p.id === 'mapreduce')
+          const hasProject = user.projectsCreated.length >= 1
+          return hasMapReduce && hasProject
+        }
+      },
+      'spark': {
+        name: 'Spark (2010)',
+        description: 'MapReduce en memoria (RDDs)',
+        requirement: 'Completa MapReduce + Bitcoin',
+        check: (user) => {
+          const hasMapReduce = user.papersCompleted?.some(p => p.id === 'mapreduce')
+          const hasBitcoin = user.papersCompleted?.some(p => p.id === 'bitcoin')
+          return hasMapReduce && hasBitcoin
+        }
+      }
+    }
+  }
+
+  isUnlocked(paperId) {
+    const user = this.getUserData()
+    const requirements = this.getPaperRequirements()
+    const paper = requirements[paperId]
+
+    if (!paper) return false
+
+    return paper.check(user)
+  }
+
+  getAvailablePapers() {
+    const user = this.getUserData()
+    const requirements = this.getPaperRequirements()
+
+    return Object.keys(requirements).map(paperId => ({
+      id: paperId,
+      ...requirements[paperId],
+      unlocked: requirements[paperId].check(user),
+      completed: user.papersCompleted?.some(p => p.id === paperId) || false
+    }))
+  }
+
+  markPaperCompleted(paperId) {
+    const user = this.getUserData()
+
+    // Initialize papersCompleted if it doesn't exist
+    if (!user.papersCompleted) {
+      user.papersCompleted = []
+    }
+
+    // Check if already completed
+    const alreadyCompleted = user.papersCompleted.some(p => p.id === paperId)
+    if (alreadyCompleted) {
+      return
+    }
+
+    // Add completion record
+    user.papersCompleted.push({
+      id: paperId,
+      completedAt: new Date().toISOString()
+    })
+
+    // Save to file
+    try {
+      const dir = path.dirname(this.userFilePath)
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true })
+      }
+      fs.writeFileSync(this.userFilePath, JSON.stringify(user, null, 2))
+    } catch (error) {
+      console.error('Error saving user progress:', error.message)
+    }
+  }
+}

package/lib/papers/PapersExecutor.js

@@ -0,0 +1,276 @@
+import { createInterface } from 'readline'
+import { spawnSync } from 'child_process'
+import chalk from 'chalk'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { AccessControl } from './AccessControl.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+export class PapersExecutor {
+  constructor() {
+    this.accessControl = new AccessControl()
+  }
+
+  async execute() {
+    // Try interactive mode first
+    try {
+      await this.showInteractiveMenu()
+    } catch (error) {
+      // Fallback to numbered selection
+      await this.showFallbackMenu()
+    }
+  }
+
+  async showInteractiveMenu() {
+    // Check if setRawMode is available
+    if (typeof process.stdin.setRawMode !== 'function') {
+      throw new Error('setRawMode not available')
+    }
+
+    const papers = this.accessControl.getAvailablePapers()
+    let selectedIndex = 0
+
+    // Enable raw mode
+    process.stdin.setRawMode(true)
+    process.stdin.resume()
+    process.stdin.setEncoding('utf8')
+
+    const renderMenu = () => {
+      process.stdout.write('\x1b[2J')
+      process.stdout.write('\x1b[H')
+
+      console.log(chalk.bold.cyan('\n📄 Papers Clásicos de Computer Science\n'))
+      console.log(chalk.dim('Recrea los papers que cambiaron la historia de la tecnología'))
+      console.log(chalk.dim('─'.repeat(60)))
+      console.log('')
+
+      papers.forEach((paper, index) => {
+        const isSelected = index === selectedIndex
+        const prefix = isSelected ? '▶ ' : '  '
+
+        let statusIcon = ''
+        let statusColor = chalk.white
+
+        if (paper.completed) {
+          statusIcon = '✅ '
+          statusColor = chalk.green
+        } else if (paper.unlocked) {
+          statusIcon = '🔓 '
+          statusColor = chalk.cyan
+        } else {
+          statusIcon = '🔒 '
+          statusColor = chalk.dim
+        }
+
+        const highlight = isSelected ? statusColor.bold : statusColor
+
+        console.log(highlight(`${prefix}${statusIcon}${paper.name}`))
+        console.log(highlight(`     ${paper.description}`))
+
+        if (!paper.unlocked) {
+          console.log(chalk.dim(`     Requisito: ${paper.requirement}`))
+        }
+
+        console.log('')
+      })
+
+      console.log(chalk.dim('\n↑↓: Navegar | Enter: Seleccionar | q: Salir'))
+    }
+
+    return new Promise((resolve) => {
+      renderMenu()
+
+      const onKeyPress = async (key) => {
+        if (key === 'q' || key === '\x03') {
+          process.stdin.setRawMode(false)
+          process.stdin.removeListener('data', onKeyPress)
+          console.log(chalk.dim('\nHecho con <3 por icarus.mx'))
+          resolve()
+          return
+        }
+
+        if (key === '\r' || key === '\n') {
+          const selectedPaper = papers[selectedIndex]
+
+          if (!selectedPaper.unlocked) {
+            process.stdout.write('\x1b[2J')
+            process.stdout.write('\x1b[H')
+            console.log(chalk.yellow(`\n🔒 Este paper está bloqueado\n`))
+            console.log(chalk.dim(`Requisito: ${selectedPaper.requirement}\n`))
+
+            const rl = createInterface({
+              input: process.stdin,
+              output: process.stdout
+            })
+
+            process.stdin.setRawMode(false)
+            process.stdin.removeListener('data', onKeyPress)
+
+            await new Promise(r => {
+              rl.question(chalk.dim('Presiona Enter para volver...'), () => {
+                rl.close()
+                r()
+              })
+            })
+
+            process.stdin.setRawMode(true)
+            process.stdin.on('data', onKeyPress)
+            renderMenu()
+            return
+          }
+
+          process.stdin.setRawMode(false)
+          process.stdin.removeListener('data', onKeyPress)
+
+          await this.launchPaper(selectedPaper.id)
+          resolve()
+          return
+        }
+
+        // Arrow keys
+        if (key === '\u001b[A') {
+          selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : papers.length - 1
+          renderMenu()
+        } else if (key === '\u001b[B') {
+          selectedIndex = selectedIndex < papers.length - 1 ? selectedIndex + 1 : 0
+          renderMenu()
+        }
+      }
+
+      process.stdin.on('data', onKeyPress)
+    })
+  }
+
+  async showFallbackMenu() {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+
+    const askQuestion = (question) => {
+      return new Promise((resolve) => {
+        rl.question(question, resolve)
+      })
+    }
+
+    try {
+      console.log(chalk.bold.cyan('\n📄 Papers Clásicos de Computer Science\n'))
+      console.log(chalk.dim('Recrea los papers que cambiaron la historia de la tecnología'))
+      console.log(chalk.dim('─'.repeat(60)))
+      console.log('')
+
+      const papers = this.accessControl.getAvailablePapers()
+
+      papers.forEach((paper, index) => {
+        let statusIcon = paper.completed ? '✅' : (paper.unlocked ? '🔓' : '🔒')
+
+        console.log(`${index + 1}. ${statusIcon} ${paper.name}`)
+        console.log(`   ${paper.description}`)
+
+        if (!paper.unlocked) {
+          console.log(chalk.dim(`   Requisito: ${paper.requirement}`))
+        }
+
+        console.log('')
+      })
+
+      const answer = await askQuestion('Elige un número (1-3) o \'q\' para salir: ')
+
+      if (answer.toLowerCase() === 'q') {
+        console.log(chalk.dim('\nHecho con <3 por icarus.mx'))
+        rl.close()
+        return
+      }
+
+      const selectedIndex = parseInt(answer) - 1
+
+      if (selectedIndex >= 0 && selectedIndex < papers.length) {
+        const selectedPaper = papers[selectedIndex]
+
+        if (!selectedPaper.unlocked) {
+          console.log(chalk.yellow(`\n🔒 Este paper está bloqueado\n`))
+          console.log(chalk.dim(`Requisito: ${selectedPaper.requirement}\n`))
+          rl.close()
+          return
+        }
+
+        rl.close()
+        await this.launchPaper(selectedPaper.id)
+      } else {
+        console.log(chalk.red('❌ Opción inválida'))
+        rl.close()
+      }
+
+    } catch (error) {
+      console.error('Error:', error.message)
+      rl.close()
+    }
+  }
+
+  async launchPaper(paperId) {
+    process.stdout.write('\x1b[2J')
+    process.stdout.write('\x1b[H')
+
+    // Get paper markdown path
+    const paperPath = path.join(__dirname, paperId, `${paperId}.md`)
+
+    // Show intro message
+    const papers = this.accessControl.getPaperRequirements()
+    const paper = papers[paperId]
+
+    console.log(chalk.bold.cyan(`\n📄 ${paper.name}`))
+    console.log(chalk.dim(paper.description))
+    console.log(chalk.dim('─'.repeat(60)))
+    console.log('')
+    console.log(chalk.yellow('💡 Vim Tips para empezar:'))
+    console.log(chalk.white('  zM  - Cierra todos los folds (empieza aquí)'))
+    console.log(chalk.white('  za  - Abre/cierra fold bajo el cursor'))
+    console.log(chalk.white('  }   - Salta al siguiente párrafo'))
+    console.log(chalk.white('  ]]  - Salta a la siguiente sección'))
+    console.log('')
+    console.log(chalk.green('Presiona Enter para abrir en Neovim...'))
+    console.log(chalk.dim('(El paper se marcará completo al cerrar Neovim)'))
+
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+
+    await new Promise(resolve => {
+      rl.question('', () => {
+        rl.close()
+        resolve()
+      })
+    })
+
+    // Launch nvim
+    console.log(chalk.dim('\nAbriendo Neovim...\n'))
+
+    const result = spawnSync('nvim', ['+zM', paperPath], {
+      stdio: 'inherit',
+      shell: true
+    })
+
+    // Mark as completed after closing nvim
+    if (result.status === 0 || result.status === null) {
+      this.accessControl.markPaperCompleted(paperId)
+
+      console.log('')
+      console.log(chalk.bold.green('🎉 ¡Paper completado!'))
+      console.log(chalk.dim('Tu progreso ha sido guardado en ~/.creta/user.json'))
+      console.log('')
+
+      // Check what's unlocked now
+      const availablePapers = this.accessControl.getAvailablePapers()
+      const nextPaper = availablePapers.find(p => !p.completed && p.unlocked)
+
+      if (nextPaper) {
+        console.log(chalk.cyan(`✨ Desbloqueaste: ${nextPaper.name}`))
+        console.log(chalk.dim(`   ${nextPaper.description}`))
+        console.log('')
+      }
+    }
+  }
+}

package/lib/utils/user-state.js

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

package/package.json

@@ -1,14 +1,11 @@
 {
   "name": "@icarusmx/creta",
-  "version": "1.4.19",
+  "version": "1.5.3",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {
     "creta": "./bin/creta.js"
   },
-  "scripts": {
-    "test": "node --test"
-  },
   "keywords": [
     "cli",
     "icarus",