@icarusmx/creta 1.4.18 → 1.5.1

package/lib/data/command-help/git-commit.js

@@ -0,0 +1,39 @@
+export const gitCommit = {
+  command: 'git commit',
+  description: 'Guarda los cambios en staging con un mensaje descriptivo',
+  usage: 'git commit [opciones]',
+  commonOptions: [
+    {
+      flag: '-m "mensaje"',
+      description: 'Commit con mensaje directo (sin abrir editor)'
+    },
+    {
+      flag: '-am "mensaje"',
+      description: 'Add + commit de archivos ya rastreados en un solo paso'
+    },
+    {
+      flag: '--amend',
+      description: 'Modificar el último commit (agregar cambios o cambiar mensaje)'
+    }
+  ],
+  examples: [
+    {
+      command: 'git commit -m "add login feature"',
+      description: 'Commit con mensaje descriptivo'
+    },
+    {
+      command: 'git commit -am "fix header bug"',
+      description: 'Agregar y hacer commit en un paso (solo archivos tracked)'
+    },
+    {
+      command: 'git commit --amend -m "nuevo mensaje"',
+      description: 'Cambiar el mensaje del último commit'
+    }
+  ],
+  relatedLesson: 'Git básico',
+  tips: [
+    'Mensajes claros y descriptivos: "add" "fix" "update" "remove"',
+    'Un commit = un cambio lógico (no mezclar features diferentes)',
+    'Usa git log para ver tu historial de commits'
+  ]
+}

package/lib/data/command-help/git-log.js

@@ -0,0 +1,47 @@
+export const gitLog = {
+  command: 'git log',
+  description: 'Muestra el historial de commits del repositorio',
+  usage: 'git log [opciones]',
+  commonOptions: [
+    {
+      flag: '--oneline',
+      description: 'Vista compacta (un commit por línea)'
+    },
+    {
+      flag: '-n 5',
+      description: 'Mostrar solo los últimos N commits'
+    },
+    {
+      flag: '--graph',
+      description: 'Muestra un gráfico ASCII de las ramas'
+    },
+    {
+      flag: '--author="nombre"',
+      description: 'Filtrar commits por autor'
+    }
+  ],
+  examples: [
+    {
+      command: 'git log',
+      description: 'Ver historial completo de commits'
+    },
+    {
+      command: 'git log --oneline',
+      description: 'Vista compacta (más legible)'
+    },
+    {
+      command: 'git log --oneline -10',
+      description: 'Solo los últimos 10 commits'
+    },
+    {
+      command: 'git log --graph --oneline',
+      description: 'Ver gráfico de ramas con commits'
+    }
+  ],
+  relatedLesson: 'Git básico',
+  tips: [
+    'Presiona "q" para salir de git log',
+    'git log --oneline es el más útil para ver historial rápido',
+    'Combina con grep: git log --oneline | grep "fix"'
+  ]
+}

package/lib/data/command-help/git-push.js

@@ -0,0 +1,35 @@
+export const gitPush = {
+  command: 'git push',
+  description: 'Envía tus commits locales al repositorio remoto (GitHub, etc.)',
+  usage: 'git push [remoto] [rama]',
+  commonOptions: [
+    {
+      flag: '-u origin main',
+      description: 'Primera vez: establece tracking entre rama local y remota'
+    },
+    {
+      flag: '--force',
+      description: '⚠️ PELIGROSO: fuerza el push (sobrescribe historial remoto)'
+    }
+  ],
+  examples: [
+    {
+      command: 'git push',
+      description: 'Enviar commits al remoto (si ya hay tracking configurado)'
+    },
+    {
+      command: 'git push -u origin main',
+      description: 'Primera vez: conectar rama local main con origin/main'
+    },
+    {
+      command: 'git push origin feature-branch',
+      description: 'Push de una rama específica'
+    }
+  ],
+  relatedLesson: 'Git colaboración',
+  tips: [
+    'Primero commit local, luego push al remoto',
+    'Si da error: probablemente necesitas hacer git pull primero',
+    'NUNCA uses --force en main/master a menos que sepas exactamente qué haces'
+  ]
+}

package/lib/data/command-help/git-status.js

@@ -0,0 +1,31 @@
+export const gitStatus = {
+  command: 'git status',
+  description: 'Muestra el estado actual de tu repositorio (archivos modificados, staging, branch)',
+  usage: 'git status',
+  commonOptions: [
+    {
+      flag: '-s',
+      description: 'Formato corto (short) - vista compacta'
+    },
+    {
+      flag: '-b',
+      description: 'Muestra la rama actual'
+    }
+  ],
+  examples: [
+    {
+      command: 'git status',
+      description: 'Ver todos los cambios y archivos sin seguimiento'
+    },
+    {
+      command: 'git status -s',
+      description: 'Vista compacta (M = modificado, A = agregado, ?? = sin seguimiento)'
+    }
+  ],
+  relatedLesson: 'Git básico',
+  tips: [
+    'Ejecuta git status SIEMPRE antes de hacer commit',
+    'Te dice en qué branch estás y qué cambios tienes',
+    'Rojo = cambios sin agregar, Verde = cambios en staging listos para commit'
+  ]
+}

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

@@ -0,0 +1,30 @@
+// Basic commands
+export { ls } from './ls.js'
+export { cd } from './cd.js'
+export { mkdir } from './mkdir.js'
+export { touch } from './touch.js'
+export { wc } from './wc.js'
+
+// Git commands
+export { gitStatus } from './git-status.js'
+export { gitAdd } from './git-add.js'
+export { gitCommit } from './git-commit.js'
+export { gitPush } from './git-push.js'
+export { gitLog } from './git-log.js'
+
+// Command mapping for lookup
+export const commandMap = {
+  // Basic
+  'ls': 'ls',
+  'cd': 'cd',
+  'mkdir': 'mkdir',
+  'touch': 'touch',
+  'wc': 'wc',
+
+  // Git
+  'git status': 'gitStatus',
+  'git add': 'gitAdd',
+  'git commit': 'gitCommit',
+  'git push': 'gitPush',
+  'git log': 'gitLog'
+}

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

@@ -0,0 +1,51 @@
+export const ls = {
+  command: 'ls',
+  description: 'Lista archivos y carpetas en el directorio actual',
+  usage: 'ls [opciones] [directorio]',
+  commonOptions: [
+    {
+      flag: '-l',
+      description: 'Formato largo (permisos, tamaño, fecha)'
+    },
+    {
+      flag: '-a',
+      description: 'Muestra archivos ocultos (.files)'
+    },
+    {
+      flag: '-h',
+      description: 'Tamaños legibles (KB, MB, GB) - usar con -l'
+    },
+    {
+      flag: '-t',
+      description: 'Ordena por fecha de modificación (más reciente primero)'
+    },
+    {
+      flag: '-r',
+      description: 'Orden inverso'
+    }
+  ],
+  examples: [
+    {
+      command: 'ls',
+      description: 'Ver archivos en directorio actual'
+    },
+    {
+      command: 'ls -la',
+      description: 'Ver TODO incluyendo ocultos en formato largo'
+    },
+    {
+      command: 'ls -lh',
+      description: 'Ver con tamaños legibles (1.2M en vez de 1234567)'
+    },
+    {
+      command: 'ls -lt',
+      description: 'Ver ordenado por fecha (archivos más recientes arriba)'
+    }
+  ],
+  relatedLesson: 'Primeros comandos',
+  tips: [
+    'Pro tip: usa `ls -la` casi siempre para ver archivos ocultos como .git',
+    'Los archivos que empiezan con . están ocultos por defecto',
+    'Combina opciones: `ls -lath` = largo + todo + legible + por fecha'
+  ]
+}

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

@@ -0,0 +1,31 @@
+export const mkdir = {
+  command: 'mkdir',
+  description: 'Crea un nuevo directorio (carpeta)',
+  usage: 'mkdir [opciones] nombre_directorio',
+  commonOptions: [
+    {
+      flag: '-p',
+      description: 'Crea directorios padres si no existen'
+    }
+  ],
+  examples: [
+    {
+      command: 'mkdir proyectos',
+      description: 'Crear carpeta llamada "proyectos"'
+    },
+    {
+      command: 'mkdir -p proyectos/frontend/components',
+      description: 'Crear estructura completa de carpetas'
+    },
+    {
+      command: 'mkdir proyecto-1 proyecto-2',
+      description: 'Crear múltiples carpetas a la vez'
+    }
+  ],
+  relatedLesson: 'Primeros comandos',
+  tips: [
+    'Usa -p para crear carpetas anidadas sin errores',
+    'Los nombres con espacios necesitan comillas: mkdir "Mi Proyecto"',
+    'Convención: usa guiones (-) en vez de espacios en nombres'
+  ]
+}

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

@@ -0,0 +1,26 @@
+export const touch = {
+  command: 'touch',
+  description: 'Crea un archivo vacío o actualiza su fecha de modificación',
+  usage: 'touch nombre_archivo',
+  commonOptions: [],
+  examples: [
+    {
+      command: 'touch index.js',
+      description: 'Crear archivo index.js vacío'
+    },
+    {
+      command: 'touch style.css script.js',
+      description: 'Crear múltiples archivos a la vez'
+    },
+    {
+      command: 'touch src/components/Header.svelte',
+      description: 'Crear archivo en una ruta específica'
+    }
+  ],
+  relatedLesson: 'Primeros comandos',
+  tips: [
+    'Si el archivo ya existe, touch solo actualiza su fecha (no lo modifica)',
+    'Útil para crear archivos rápidamente antes de editarlos',
+    'Para crear carpetas usa mkdir, no touch'
+  ]
+}

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