@icarusmx/creta 1.4.14 → 1.4.16

package/bin/creta.js

@@ -2,6 +2,35 @@
 
 import { runCLI } from '../lib/cli/index.js'
 
+// Setup process exit handlers for sandbox cleanup
+function setupExitHandlers() {
+  const cleanup = () => {
+    // Cleanup will be handled by individual SandboxManager instances
+    // and by the cleanupOldSessions call on startup
+  }
+
+  // Handle Ctrl+C
+  process.on('SIGINT', () => {
+    cleanup()
+    process.exit(0)
+  })
+
+  // Handle kill signal
+  process.on('SIGTERM', () => {
+    cleanup()
+    process.exit(0)
+  })
+
+  // Handle uncaught exceptions
+  process.on('uncaughtException', (error) => {
+    console.error('\n❌ Error inesperado:', error.message)
+    cleanup()
+    process.exit(1)
+  })
+}
+
+setupExitHandlers()
+
 try {
   const exitCode = await runCLI(process.argv.slice(2))
   process.exit(exitCode)

package/lib/builders/LessonBuilder.js

@@ -1,6 +1,9 @@
 import { createPromptInterface, askQuestion } from '../utils/input.js'
 import { clearConsole } from '../utils/output.js'
 import { UserState } from '../utils/user-state.js'
+import { SandboxManager } from '../sandbox/SandboxManager.js'
+import { CommandValidator } from '../sandbox/CommandValidator.js'
+import { CommandExecutor } from '../sandbox/CommandExecutor.js'
 
 const DEFAULT_WAIT_MESSAGE = '\nPresiona Enter para continuar...'
 
@@ -8,6 +11,7 @@ export class LessonBuilder {
   constructor(lessonData) {
     this.lesson = lessonData
     this.rl = null
+    this.sandbox = null
   }
 
   async start() {
@@ -23,6 +27,12 @@ export class LessonBuilder {
     } finally {
       this.rl.close()
       this.rl = null
+
+      // Cleanup sandbox if it was created
+      if (this.sandbox) {
+        this.sandbox.cleanup()
+        this.sandbox = null
+      }
     }
   }
 
@@ -86,6 +96,9 @@ export class LessonBuilder {
       case 'command-intro':
         await this.handleCommandIntro(action)
         break
+      case 'interactive-command':
+        await this.handleInteractiveCommand(action)
+        break
       case 'maze-completion':
         await this.handleMazeCompletion(action)
         break
@@ -385,4 +398,48 @@ export class LessonBuilder {
     console.log('')
     await askQuestion(this.rl, '\nPresiona Enter para continuar...')
   }
+
+  async handleInteractiveCommand(action) {
+    // Initialize sandbox on first interactive command
+    if (!this.sandbox) {
+      this.sandbox = new SandboxManager(this.lesson.id)
+      this.sandbox.createSandbox(action.initialFiles || [])
+    }
+    // Sandbox state persists across interactive steps in the same lesson
+
+    const workingDir = this.sandbox.getPath()
+
+    // Interactive loop until user types correct command
+    let success = false
+    while (!success) {
+      console.log('')
+      const userInput = await askQuestion(this.rl, `💻 ${action.prompt}: `)
+
+      if (CommandValidator.matches(userInput, action.expectedCommand)) {
+        // Execute the command
+        const result = CommandExecutor.execute(action.expectedCommand, workingDir)
+
+        console.log('')
+        console.log('✓ Correcto!')
+        console.log('')
+
+        // Show command output
+        if (result.stdout) {
+          console.log(CommandExecutor.formatOutput(result))
+          console.log('')
+        }
+
+        // Show explanation
+        if (action.explanation) {
+          console.log(action.explanation)
+        }
+
+        success = true
+      } else {
+        // Show error message
+        console.log('')
+        console.log(CommandValidator.getErrorMessage(userInput, action.expectedCommand))
+      }
+    }
+  }
 }

package/lib/cli/index.js

@@ -7,6 +7,7 @@ import { executePortfolio } from '../executors/portfolio-executor.js'
 import { showHelp } from '../commands/help.js'
 import { CretaCodeSession } from '../session.js'
 import { greetUser } from '../utils/greeting.js'
+import { SandboxManager } from '../sandbox/SandboxManager.js'
 
 async function executeMainMenu() {
   const menu = new MenuBuilder(getMainMenuConfig())
@@ -79,6 +80,9 @@ export async function handleCommand(command, args = []) {
 export async function runCLI(args = []) {
   const [command, ...rest] = args
 
+  // Cleanup old sandbox sessions on startup
+  SandboxManager.cleanupOldSessions()
+
   // Skip greeting for reset command
   if (command !== 'reset') {
     await greetUser()

package/lib/data/lessons/sintaxis/terminal-basico.js

@@ -15,7 +15,17 @@ export const TERMINAL_BASICO = {
       description: 'Primer comando: ls',
       explanation: 'ls lista los archivos y carpetas en tu ubicación actual.',
       example: 'ls\nls -la',
-      instruction: 'Pruébalo en tu terminal. Con -la verás archivos ocultos y más detalles.'
+      instruction: 'Ahora vamos a practicarlo en un ambiente seguro.'
+    },
+    {
+      type: 'interactive-command',
+      prompt: 'Ejecuta el comando ls',
+      expectedCommand: 'ls',
+      explanation: 'El comando ls listó todos los archivos y carpetas en este directorio.',
+      initialFiles: ['proyecto.js', 'datos.txt', 'README.md']
+    },
+    {
+      type: 'pause'
     },
     {
       type: 'command-intro',
@@ -23,7 +33,25 @@ export const TERMINAL_BASICO = {
       description: 'Segundo comando: mkdir',
       explanation: 'mkdir crea un nuevo directorio (carpeta).',
       example: 'mkdir mi-carpeta\nmkdir proyectos/nuevo-proyecto',
-      instruction: 'Crea una carpeta nueva. Prueba: mkdir prueba'
+      instruction: 'Ahora vamos a crear una carpeta nueva.'
+    },
+    {
+      type: 'interactive-command',
+      prompt: 'Ejecuta el comando mkdir mi-directorio',
+      expectedCommand: 'mkdir mi-directorio',
+      explanation: 'Creaste una nueva carpeta llamada "mi-directorio".'
+    },
+    {
+      type: 'pause'
+    },
+    {
+      type: 'interactive-command',
+      prompt: 'Ejecuta ls de nuevo para ver tu nueva carpeta',
+      expectedCommand: 'ls',
+      explanation: '¡Ahí está! Ahora "mi-directorio" aparece en la lista junto con los otros archivos.'
+    },
+    {
+      type: 'pause'
     },
     {
       type: 'command-intro',

package/lib/sandbox/CommandExecutor.js

@@ -0,0 +1,55 @@
+import { execSync } from 'child_process'
+import { platform } from 'os'
+
+export class CommandExecutor {
+  /**
+   * Execute a command in the sandbox directory
+   * @param {string} command - The command to execute
+   * @param {string} workingDir - The sandbox directory path
+   * @returns {Object} - { stdout, stderr, success }
+   */
+  static execute(command, workingDir) {
+    try {
+      // Detect platform for shell selection
+      const isWindows = platform() === 'win32'
+      const shell = isWindows ? 'cmd.exe' : '/bin/bash'
+
+      const stdout = execSync(command, {
+        cwd: workingDir,
+        encoding: 'utf8',
+        shell,
+        // Inherit environment but ensure clean output
+        env: { ...process.env, FORCE_COLOR: '0' }
+      })
+
+      return {
+        stdout: stdout.trim(),
+        stderr: '',
+        success: true
+      }
+    } catch (error) {
+      return {
+        stdout: error.stdout ? error.stdout.toString().trim() : '',
+        stderr: error.stderr ? error.stderr.toString().trim() : error.message,
+        success: false
+      }
+    }
+  }
+
+  /**
+   * Format output for display to student
+   * @param {Object} result - Result from execute()
+   * @returns {string} - Formatted output
+   */
+  static formatOutput(result) {
+    if (!result.success && result.stderr) {
+      return `❌ Error:\n${result.stderr}`
+    }
+
+    if (result.stdout) {
+      return result.stdout
+    }
+
+    return '(sin salida)'
+  }
+}

package/lib/sandbox/CommandValidator.js

@@ -0,0 +1,32 @@
+export class CommandValidator {
+  /**
+   * Validate user input matches expected command (strict exact match)
+   * @param {string} userInput - What the user typed
+   * @param {string} expectedCommand - What we expect them to type
+   * @returns {boolean} - true if matches
+   */
+  static matches(userInput, expectedCommand) {
+    // Trim whitespace
+    const cleanInput = userInput.trim()
+    const cleanExpected = expectedCommand.trim()
+
+    // Strict exact match
+    return cleanInput === cleanExpected
+  }
+
+  /**
+   * Get a helpful error message when command doesn't match
+   * @param {string} userInput - What the user typed
+   * @param {string} expectedCommand - What we expect
+   * @returns {string} - Error message
+   */
+  static getErrorMessage(userInput, expectedCommand) {
+    const cleanInput = userInput.trim()
+
+    if (cleanInput === '') {
+      return 'No escribiste ningún comando.'
+    }
+
+    return `Ese no es el comando. Ejecuta: ${expectedCommand}`
+  }
+}

package/lib/sandbox/SandboxManager.js

@@ -0,0 +1,97 @@
+import { tmpdir } from 'os'
+import { join } from 'path'
+import { mkdirSync, writeFileSync, rmSync, existsSync, readdirSync } from 'fs'
+
+export class SandboxManager {
+  constructor(lessonId) {
+    this.lessonId = lessonId
+    this.sessionId = `${lessonId}-${Date.now()}`
+    this.sandboxPath = join(tmpdir(), `creta-practice-${this.sessionId}`)
+    this.initialState = null
+  }
+
+  /**
+   * Create the sandbox directory with initial files
+   * @param {string[]} initialFiles - Array of filenames to create
+   */
+  createSandbox(initialFiles = []) {
+    if (existsSync(this.sandboxPath)) {
+      this.cleanup()
+    }
+
+    mkdirSync(this.sandboxPath, { recursive: true })
+
+    // Create initial files (empty by default)
+    initialFiles.forEach((filename) => {
+      const filePath = join(this.sandboxPath, filename)
+      writeFileSync(filePath, `# ${filename}\nEste es un archivo de práctica.\n`)
+    })
+
+    // Store initial state for restoration
+    this.initialState = {
+      files: initialFiles,
+      directories: []
+    }
+
+    return this.sandboxPath
+  }
+
+  /**
+   * Restore sandbox to initial state
+   * Used before each validation step
+   */
+  restoreState() {
+    if (!this.initialState) return
+
+    // Remove everything
+    this.cleanup()
+
+    // Recreate with initial files
+    this.createSandbox(this.initialState.files)
+  }
+
+  /**
+   * Get the current sandbox path
+   */
+  getPath() {
+    return this.sandboxPath
+  }
+
+  /**
+   * Check if sandbox exists
+   */
+  exists() {
+    return existsSync(this.sandboxPath)
+  }
+
+  /**
+   * Cleanup this sandbox
+   */
+  cleanup() {
+    if (existsSync(this.sandboxPath)) {
+      rmSync(this.sandboxPath, { recursive: true, force: true })
+    }
+  }
+
+  /**
+   * Cleanup all old Creta practice sessions
+   * Called on CLI startup
+   */
+  static cleanupOldSessions() {
+    const tmpDir = tmpdir()
+    const allFiles = readdirSync(tmpDir)
+
+    const cretaSessions = allFiles.filter(name => name.startsWith('creta-practice-'))
+
+    cretaSessions.forEach((sessionDir) => {
+      const fullPath = join(tmpDir, sessionDir)
+      try {
+        rmSync(fullPath, { recursive: true, force: true })
+      } catch (err) {
+        // Ignore errors - session might be in use
+      }
+    })
+
+    return cretaSessions.length
+  }
+}

package/package.json

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