@icarusmx/creta 1.5.14 → 1.5.15

package/lib/readers/exercise-reader.js

@@ -0,0 +1,197 @@
+import { readFileSync, readdirSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+import chalk from 'chalk'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+export class ExerciseReader {
+  constructor() {
+    this.exercisesDir = join(__dirname, '../exercises')
+  }
+
+  /**
+   * 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)
+      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()
+}

package/package.json

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