@icarusmx/creta 1.5.14 → 1.5.16

package/lib/readers/exercise-reader.js

@@ -0,0 +1,285 @@
+import { readFileSync, readdirSync, existsSync, mkdirSync, copyFileSync, statSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+import { homedir } from 'os'
+import chalk from 'chalk'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+export class ExerciseReader {
+  constructor() {
+    this.exercisesDir = join(__dirname, '../exercises')
+    this.bibliotecaDir = join(homedir(), '.creta', 'biblioteca')
+  }
+
+  /**
+   * Ensure biblioteca directory exists and sync exercises
+   */
+  syncBiblioteca(silent = false) {
+    try {
+      // Create directory if needed
+      if (!existsSync(this.bibliotecaDir)) {
+        mkdirSync(this.bibliotecaDir, { recursive: true })
+        if (!silent) {
+          console.log(chalk.cyan('\n📚 Creando biblioteca en ~/.creta/biblioteca...'))
+        }
+      }
+
+      // Get all exercise files
+      const exercises = this.getAvailableExercises()
+      let copied = 0
+      let updated = 0
+      let skipped = 0
+
+      exercises.forEach(exercise => {
+        const sourcePath = join(this.exercisesDir, exercise.filename)
+        const destPath = join(this.bibliotecaDir, exercise.filename)
+
+        // Check if destination exists and is up to date
+        if (existsSync(destPath)) {
+          const sourceStats = statSync(sourcePath)
+          const destStats = statSync(destPath)
+
+          if (sourceStats.mtime > destStats.mtime) {
+            copyFileSync(sourcePath, destPath)
+            updated++
+          } else {
+            skipped++
+          }
+        } else {
+          copyFileSync(sourcePath, destPath)
+          copied++
+        }
+      })
+
+      if (!silent) {
+        console.log(chalk.green('\n✅ Biblioteca sincronizada'))
+        if (copied > 0) console.log(chalk.gray(`   ${copied} ejercicio${copied !== 1 ? 's' : ''} copiado${copied !== 1 ? 's' : ''}`))
+        if (updated > 0) console.log(chalk.gray(`   ${updated} ejercicio${updated !== 1 ? 's' : ''} actualizado${updated !== 1 ? 's' : ''}`))
+        if (skipped > 0) console.log(chalk.gray(`   ${skipped} ejercicio${skipped !== 1 ? 's' : ''} sin cambios`))
+        console.log(chalk.cyan(`\n💡 Abre ejercicios con: nvim ~/.creta/biblioteca/<archivo>.md`))
+        console.log(chalk.gray(`   Ejemplo: nvim ~/.creta/biblioteca/14-gh-fundamentals.md\n`))
+      }
+
+      return { copied, updated, skipped, total: exercises.length }
+    } catch (error) {
+      if (!silent) {
+        console.error(chalk.red('\n❌ Error sincronizando biblioteca:'), error.message)
+      }
+      return { copied: 0, updated: 0, skipped: 0, total: 0, error }
+    }
+  }
+
+  /**
+   * Check if biblioteca needs initialization (show tip on first read)
+   */
+  checkBiblioteca() {
+    if (!existsSync(this.bibliotecaDir)) {
+      return {
+        exists: false,
+        message: chalk.dim(`\n💡 Tip: Ejecuta ${chalk.cyan('creta biblioteca')} para copiar ejercicios a ~/.creta/biblioteca/\n   Así podrás abrirlos en nvim con fold markers.`)
+      }
+    }
+    return { exists: true, message: null }
+  }
+
+  /**
+   * Get all available exercises
+   */
+  getAvailableExercises() {
+    try {
+      const files = readdirSync(this.exercisesDir)
+      return files
+        .filter(f => f.endsWith('.md') && f !== 'README.md' && f !== 'API_CHANGES.md')
+        .map(f => ({
+          filename: f,
+          id: f.replace('.md', ''),
+          number: this.extractNumber(f),
+          title: this.extractTitle(f)
+        }))
+        .sort((a, b) => (a.number || 999) - (b.number || 999))
+    } catch (error) {
+      return []
+    }
+  }
+
+  /**
+   * Extract number from filename (e.g., "01-" -> 1)
+   */
+  extractNumber(filename) {
+    const match = filename.match(/^(\d+)-/)
+    return match ? parseInt(match[1], 10) : null
+  }
+
+  /**
+   * Extract title from filename (e.g., "01-developing-muscle-for-nvim" -> "Developing Muscle for Nvim")
+   */
+  extractTitle(filename) {
+    const withoutExt = filename.replace('.md', '')
+    const withoutNumber = withoutExt.replace(/^\d+-/, '')
+    return withoutNumber
+      .split('-')
+      .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+      .join(' ')
+  }
+
+  /**
+   * Find exercise by ID (number or slug)
+   */
+  findExercise(query) {
+    const exercises = this.getAvailableExercises()
+
+    // Try exact match by ID first
+    let exercise = exercises.find(e => e.id === query)
+    if (exercise) return exercise
+
+    // Try by number
+    const queryNum = parseInt(query, 10)
+    if (!isNaN(queryNum)) {
+      exercise = exercises.find(e => e.number === queryNum)
+      if (exercise) return exercise
+    }
+
+    // Try partial match (fuzzy)
+    const queryLower = query.toLowerCase()
+    exercise = exercises.find(e =>
+      e.id.toLowerCase().includes(queryLower) ||
+      e.title.toLowerCase().includes(queryLower)
+    )
+
+    return exercise || null
+  }
+
+  /**
+   * Read and display exercise
+   */
+  read(query) {
+    const exercise = this.findExercise(query)
+
+    if (!exercise) {
+      this.showExerciseNotFound(query)
+      return false
+    }
+
+    try {
+      const filepath = join(this.exercisesDir, exercise.filename)
+      const content = readFileSync(filepath, 'utf-8')
+
+      this.displayExercise(exercise, content)
+
+      // Show biblioteca tip on first read
+      const bibliotecaStatus = this.checkBiblioteca()
+      if (!bibliotecaStatus.exists && bibliotecaStatus.message) {
+        console.log(bibliotecaStatus.message)
+      }
+
+      return true
+    } catch (error) {
+      console.error(chalk.red('❌ Error leyendo ejercicio:'), error.message)
+      return false
+    }
+  }
+
+  /**
+   * Display exercise with formatting
+   */
+  displayExercise(exercise, content) {
+    console.clear()
+
+    // Header
+    console.log(chalk.cyan('\n📚 Ejercicio Creta'))
+    console.log(chalk.gray('═'.repeat(70)))
+    console.log(chalk.bold(`\n${exercise.number ? `${exercise.number}. ` : ''}${exercise.title}`))
+    console.log(chalk.gray('─'.repeat(70)))
+
+    // Content (render markdown as-is, terminal will handle it)
+    console.log('\n' + content + '\n')
+
+    // Footer
+    console.log(chalk.gray('─'.repeat(70)))
+    console.log(chalk.dim('💡 Tip: Abre este archivo en nvim para usar fold markers: {{{ }}}'))
+    console.log(chalk.dim(`   Archivo: lib/exercises/${exercise.filename}`))
+    console.log(chalk.gray('═'.repeat(70)) + '\n')
+  }
+
+  /**
+   * Show error when exercise not found
+   */
+  showExerciseNotFound(query) {
+    console.log(chalk.red(`\n❌ Ejercicio "${query}" no encontrado\n`))
+    console.log(chalk.yellow('📚 Ejercicios disponibles:\n'))
+
+    const exercises = this.getAvailableExercises()
+    exercises.forEach(e => {
+      const num = e.number ? chalk.cyan(`${e.number}.`.padEnd(4)) : '    '
+      const title = chalk.white(e.title)
+      const id = chalk.gray(`(${e.id})`)
+      console.log(`  ${num}${title} ${id}`)
+    })
+
+    console.log(chalk.gray('\n💡 Uso: creta read <número|nombre>'))
+    console.log(chalk.gray('   Ejemplos:'))
+    console.log(chalk.gray('     creta read 1'))
+    console.log(chalk.gray('     creta read gh-fundamentals'))
+    console.log(chalk.gray('     creta read nvim\n'))
+  }
+
+  /**
+   * List all available exercises
+   */
+  list() {
+    console.log(chalk.cyan('\n📚 Ejercicios Disponibles en Creta'))
+    console.log(chalk.gray('═'.repeat(70)))
+
+    const exercises = this.getAvailableExercises()
+
+    if (exercises.length === 0) {
+      console.log(chalk.yellow('\n⚠️  No hay ejercicios disponibles\n'))
+      return
+    }
+
+    console.log()
+    exercises.forEach(e => {
+      const num = e.number ? chalk.cyan(`${e.number}.`.padEnd(4)) : '    '
+      const title = chalk.bold(e.title)
+      const id = chalk.gray(`(${e.id})`)
+      console.log(`  ${num}${title}`)
+      console.log(`      ${id}`)
+    })
+
+    console.log(chalk.gray('\n💡 Para leer un ejercicio:'))
+    console.log(chalk.yellow('   creta read <número|nombre>'))
+    console.log(chalk.gray('   Ejemplo: creta read 14\n'))
+  }
+}
+
+/**
+ * CLI entry point
+ */
+export async function readExercise(query) {
+  const reader = new ExerciseReader()
+
+  if (!query) {
+    reader.list()
+    return
+  }
+
+  reader.read(query)
+}
+
+/**
+ * List exercises CLI entry point
+ */
+export async function listExercises() {
+  const reader = new ExerciseReader()
+  reader.list()
+}
+
+/**
+ * Sync biblioteca CLI entry point
+ */
+export async function syncBiblioteca() {
+  const reader = new ExerciseReader()
+  reader.syncBiblioteca()
+}

package/package.json

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