@icarusmx/creta 1.2.1 → 1.3.1

package/bin/creta.js

@@ -6,6 +6,7 @@ import fs from 'fs'
 import path from 'path'
 import { fileURLToPath } from 'url'
 import { CretaCodeSession } from '../lib/session.js'
+import { PullRequestTutorial } from '../lib/pr-tutorial.js'
 import { Lesson1SystemDecomposition } from '../lessons/lesson1-system-decomposition.js'
 import { Lesson2ObjectRequests } from '../lessons/lesson2-object-requests.js'
 import { Lesson3OnlyWay } from '../lessons/lesson3-only-way.js'
@@ -621,8 +622,7 @@ async function startMainMenuInteractive() {
 
   const options = [
     { id: 1, title: "Aprender conceptos", description: "Explora los enunciados fundamentales" },
-    { id: 2, title: "Construir proyectos", description: "Crea tu portafolio personal" },
-    { id: 3, title: "Crea una pull-request", description: "Aprende el flujo de contribución con Git" }
+    { id: 2, title: "Construir proyectos", description: "Practica con proyectos reales" }
   ]
 
   let selectedIndex = 0
@@ -693,8 +693,6 @@ Salgamos de este laberinto 🏛️
           startEnunciadosSelector().then(resolve)
         } else if (selectedOption.id === 2) {
           startProyectosSelector().then(resolve)
-        } else if (selectedOption.id === 3) {
-          startPullRequestTutorial().then(resolve)
         }
         return
       }
@@ -729,11 +727,10 @@ async function startMainMenuFallback() {
     console.log("Te ofrecemos las siguientes opciones:")
     console.log("")
     console.log("1. Aprender conceptos - Explora los enunciados fundamentales")
-    console.log("2. Construir proyectos - Crea tu portafolio personal")
-    console.log("3. Crea una pull-request - Aprende el flujo de contribución con Git")
+    console.log("2. Construir proyectos - Practica con proyectos reales")
     console.log("")
 
-    const respuesta = await askQuestion("Elige una opción (1-3) o 'q' para salir: ")
+    const respuesta = await askQuestion("Elige una opción (1-2) o 'q' para salir: ")
 
     if (respuesta.toLowerCase() === 'q') {
       console.log("Hecho con <3 por icarus.mx")
@@ -749,11 +746,8 @@ async function startMainMenuFallback() {
     } else if (opcionSeleccionada === 2) {
       rl.close()
       await startProyectosSelector()
-    } else if (opcionSeleccionada === 3) {
-      rl.close()
-      await startPullRequestTutorial()
     } else {
-      console.log("❌ Opción no válida. Elige 1, 2 o 3.")
+      console.log("❌ Opción no válida. Elige 1 o 2.")
       rl.close()
     }
 
@@ -1240,14 +1234,12 @@ async function startProyectosSelectorInteractive() {
     throw new Error('setRawMode not available')
   }
 
-  console.log("\n🚀 Proyectos Disponibles")
-  console.log("¿Qué proyecto quieres crear?")
+  console.log("\n🚀 Construir Proyectos")
+  console.log("Elige qué proyecto quieres construir:")
 
   const projects = [
-    { id: 1, title: "🎨 Portafolio Personal", description: "Reto completo", level: 0 },
-    { id: 2, title: "🔓 Portafolio Nivel 1", description: "Solo navbar", level: 1 },
-    { id: 3, title: "🔓 Portafolio Nivel 2", description: "Navbar + hero", level: 2 },
-    { id: 4, title: "🔓 Portafolio Nivel 3", description: "Solución completa", level: 3 }
+    { id: 1, title: "🔀 Construye una pull-request", description: "Aprende Git y GitHub paso a paso", type: 'pr' },
+    { id: 2, title: "🎨 Construye tu portafolio", description: "Crea tu sitio web personal", type: 'portfolio' }
   ]
 
   let selectedIndex = 0
@@ -1266,8 +1258,8 @@ async function startProyectosSelectorInteractive() {
     process.stdout.write('\x1b[2J')
     process.stdout.write('\x1b[H')
 
-    console.log("🚀 Proyectos Disponibles")
-    console.log("¿Qué proyecto quieres crear?")
+    console.log("🚀 Construir Proyectos")
+    console.log("Elige qué proyecto quieres construir:")
 
     projects.forEach((project, index) => {
       const isSelected = index === selectedIndex
@@ -1300,17 +1292,15 @@ async function startProyectosSelectorInteractive() {
         process.stdin.removeListener('data', onKeyPress)
 
         const selectedProject = projects[selectedIndex]
-        const level = selectedProject.level
 
         // Clear screen
         process.stdout.write('\x1b[2J')
         process.stdout.write('\x1b[H')
 
-        // Check if we're in an existing Creta project
-        if (level > 0 && isInCretaProject()) {
-          unstuckProject(level).then(resolve)
-        } else {
-          createPortfolioProject(level).then(resolve)
+        if (selectedProject.type === 'pr') {
+          startPullRequestTutorial().then(resolve)
+        } else if (selectedProject.type === 'portfolio') {
+          startPortfolioSelector().then(resolve)
         }
         return
       }
@@ -1370,8 +1360,162 @@ async function startProyectosSelectorFallback() {
   }
 
   try {
-    console.log("\n🚀 Proyectos Disponibles")
-    console.log("¿Qué proyecto quieres crear?")
+    console.log("\n🚀 Construir Proyectos")
+    console.log("Elige qué proyecto quieres construir:")
+    console.log("")
+    console.log("1. 🔀 Construye una pull-request - Aprende Git y GitHub paso a paso")
+    console.log("2. 🎨 Construye tu portafolio - Crea tu sitio web personal")
+    console.log("")
+
+    const respuesta = await askQuestion("Elige una opción (1-2) o 'q' para salir: ")
+
+    if (respuesta.toLowerCase() === 'q') {
+      console.log("Hecho con <3 por icarus.mx")
+      rl.close()
+      return
+    }
+
+    const opcionSeleccionada = parseInt(respuesta)
+
+    if (opcionSeleccionada === 1) {
+      rl.close()
+      await startPullRequestTutorial()
+    } else if (opcionSeleccionada === 2) {
+      rl.close()
+      await startPortfolioSelector()
+    } else {
+      console.log("❌ Opción no válida. Elige 1 o 2.")
+      rl.close()
+    }
+
+  } catch (error) {
+    console.error('Error:', error.message)
+    rl.close()
+    process.exit(1)
+  }
+}
+
+async function startPortfolioSelector() {
+  // Always try interactive mode first, fall back only if it fails
+  try {
+    return await startPortfolioSelectorInteractive()
+  } catch (error) {
+    // If interactive mode fails, fall back to numbered selection
+    console.log('\nModo interactivo no disponible, usando selección numérica...\n')
+    return await startPortfolioSelectorFallback()
+  }
+}
+
+async function startPortfolioSelectorInteractive() {
+  // Check if setRawMode is available before trying to use it
+  if (typeof process.stdin.setRawMode !== 'function') {
+    throw new Error('setRawMode not available')
+  }
+
+  console.log("\n🎨 Construye tu Portafolio")
+  console.log("Elige el nivel:")
+
+  const projects = [
+    { id: 1, title: "🎨 Portafolio Personal", description: "Reto completo", level: 0 },
+    { id: 2, title: "🔓 Portafolio Nivel 1", description: "Solo navbar", level: 1 },
+    { id: 3, title: "🔓 Portafolio Nivel 2", description: "Navbar + hero", level: 2 },
+    { id: 4, title: "🔓 Portafolio Nivel 3", description: "Solución completa", level: 3 }
+  ]
+
+  let selectedIndex = 0
+
+  // Enable raw mode to capture arrow keys
+  try {
+    process.stdin.setRawMode(true)
+    process.stdin.resume()
+    process.stdin.setEncoding('utf8')
+  } catch (error) {
+    throw new Error('Failed to enable raw mode: ' + error.message)
+  }
+
+  const renderOptions = () => {
+    // Clear previous output and move cursor to top
+    process.stdout.write('\x1b[2J')
+    process.stdout.write('\x1b[H')
+
+    console.log("🎨 Construye tu Portafolio")
+    console.log("Elige el nivel:")
+
+    projects.forEach((project, index) => {
+      const isSelected = index === selectedIndex
+      const prefix = isSelected ? '▶ ' : '  '
+      const highlight = isSelected ? '\x1b[36m' : '\x1b[37m' // cyan for selected, white for normal
+      const reset = '\x1b[0m'
+
+      console.log(`${highlight}${prefix}${project.title}${reset}`)
+      if (isSelected) {
+        console.log(`${highlight}     ${project.description}${reset}`)
+      }
+      console.log("")
+    })
+  }
+
+  return new Promise((resolve) => {
+    renderOptions()
+
+    const onKeyPress = (key) => {
+      if (key === 'q' || key === '\x03') { // q or Ctrl+C
+        process.stdin.setRawMode(false)
+        process.stdin.removeListener('data', onKeyPress)
+        console.log("\nHecho con <3 por icarus.mx")
+        resolve()
+        return
+      }
+
+      if (key === '\r' || key === '\n') { // Enter
+        process.stdin.setRawMode(false)
+        process.stdin.removeListener('data', onKeyPress)
+
+        const selectedProject = projects[selectedIndex]
+        const level = selectedProject.level
+
+        // Clear screen
+        process.stdout.write('\x1b[2J')
+        process.stdout.write('\x1b[H')
+
+        // Check if we're in an existing Creta project
+        if (level > 0 && isInCretaProject()) {
+          unstuckProject(level).then(resolve)
+        } else {
+          createPortfolioProject(level).then(resolve)
+        }
+        return
+      }
+
+      // Handle arrow keys (escape sequences)
+      if (key === '\u001b[A') { // Up arrow
+        selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : projects.length - 1
+        renderOptions()
+      } else if (key === '\u001b[B') { // Down arrow
+        selectedIndex = selectedIndex < projects.length - 1 ? selectedIndex + 1 : 0
+        renderOptions()
+      }
+    }
+
+    process.stdin.on('data', onKeyPress)
+  })
+}
+
+async function startPortfolioSelectorFallback() {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  })
+
+  const askQuestion = (question) => {
+    return new Promise((resolve) => {
+      rl.question(question, resolve)
+    })
+  }
+
+  try {
+    console.log("\n🎨 Construye tu Portafolio")
+    console.log("Elige el nivel:")
     console.log("")
     console.log("1. 🎨 Portafolio Personal - Reto completo")
     console.log("2. 🔓 Portafolio Nivel 1 - Solo navbar")
@@ -1414,33 +1558,28 @@ async function startProyectosSelectorFallback() {
 }
 
 async function startPullRequestTutorial() {
-  console.clear()
-  console.log("🔀 Tutorial: Crea una Pull Request")
-  console.log("=" .repeat(50))
-  console.log("")
-  console.log("📚 Aprenderás:")
-  console.log("  • Cómo hacer fork de un repositorio")
-  console.log("  • Crear una rama (branch) para tu cambio")
-  console.log("  • Hacer commits con buenas prácticas")
-  console.log("  • Crear una pull request profesional")
-  console.log("")
-  console.log("🚧 [PRÓXIMAMENTE]")
-  console.log("")
-  console.log("Esta funcionalidad está en desarrollo.")
-  console.log("Pronto podrás practicar el flujo completo de contribución.")
-  console.log("")
+  try {
+    const tutorial = new PullRequestTutorial()
+    await tutorial.start()
 
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout
-  })
+    // Volver al menú principal después de completar el tutorial
+    await returnToMainMenu()
+  } catch (error) {
+    console.error("\n❌ Error al ejecutar el tutorial:", error.message)
+    console.log("\nSi el problema persiste, contacta al equipo de Creta.")
 
-  await new Promise((resolve) => {
-    rl.question("\nPresiona Enter para volver al menú principal...", () => {
-      rl.close()
-      resolve()
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
     })
-  })
 
-  await startMainMenu()
+    await new Promise((resolve) => {
+      rl.question("\nPresiona Enter para volver al menú principal...", () => {
+        rl.close()
+        resolve()
+      })
+    })
+
+    await startMainMenu()
+  }
 }

package/lib/pr-tutorial.js

@@ -0,0 +1,604 @@
+#!/usr/bin/env node
+
+// Tutorial interactivo: Crea una Pull Request
+// Guía paso a paso para aprender el flujo completo de contribución con Git
+
+import { createInterface } from 'readline'
+import { execSync } from 'child_process'
+import fs from 'fs'
+import path from 'path'
+
+export class PullRequestTutorial {
+  constructor() {
+    this.rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+
+    // Repo de práctica (usaremos el mismo repo de Creta)
+    this.practiceRepo = 'icarusmx/creta-practice'
+    this.repoUrl = `https://github.com/${this.practiceRepo}`
+    this.projectDir = null
+  }
+
+  async start() {
+    await this.introduction()
+    await this.checkPrerequisites()
+    await this.step1_ForkExplanation()
+    await this.step2_CloneRepo()
+    await this.step3_CreateBranch()
+    await this.step4_MakeChanges()
+    await this.step5_CommitChanges()
+    await this.step6_PushBranch()
+    await this.step7_CreatePR()
+    await this.conclusion()
+
+    this.rl.close()
+  }
+
+  async introduction() {
+    console.clear()
+    console.log("🔀 Tutorial: Crea tu primera Pull Request")
+    console.log("=" .repeat(50))
+    console.log("")
+    console.log("📚 En este tutorial aprenderás:")
+    console.log("")
+    console.log("1. Qué es una Pull Request y por qué son importantes")
+    console.log("2. Cómo hacer fork de un repositorio")
+    console.log("3. Cómo crear una rama (branch) para tu cambio")
+    console.log("4. Cómo hacer commits con buenas prácticas")
+    console.log("5. Cómo crear una Pull Request profesional")
+    console.log("")
+    console.log("⏱️  Duración estimada: 10-15 minutos")
+    console.log("")
+    console.log("💡 Tip: Tendrás que ejecutar comandos reales en tu terminal.")
+    console.log("   ¡No te preocupes! Te guiaremos paso a paso.")
+
+    await this.waitForEnter("\nPresiona Enter para comenzar...")
+  }
+
+  async checkPrerequisites() {
+    console.clear()
+    console.log("🔍 Verificando prerequisitos...")
+    console.log("=" .repeat(50))
+    console.log("")
+
+    // Check git
+    console.log("Verificando Git...")
+    try {
+      const gitVersion = execSync('git --version', { encoding: 'utf8' }).trim()
+      console.log(`✅ ${gitVersion}`)
+    } catch (error) {
+      console.log("❌ Git no está instalado")
+      console.log("")
+      console.log("Por favor instala Git:")
+      console.log("  macOS: brew install git")
+      console.log("  Linux: sudo apt install git")
+      console.log("  Windows: https://git-scm.com/download/win")
+      console.log("")
+      await this.waitForEnter("Presiona Enter para salir...")
+      process.exit(1)
+    }
+
+    console.log("")
+
+    // Check GitHub CLI
+    console.log("Verificando GitHub CLI (gh)...")
+    try {
+      const ghVersion = execSync('gh --version', { encoding: 'utf8' }).trim().split('\n')[0]
+      console.log(`✅ ${ghVersion}`)
+    } catch (error) {
+      console.log("❌ GitHub CLI (gh) no está instalado")
+      console.log("")
+      console.log("Por favor instala gh:")
+      console.log("  macOS: brew install gh")
+      console.log("  Linux: Ver https://github.com/cli/cli/blob/trunk/docs/install_linux.md")
+      console.log("  Windows: Ver https://github.com/cli/cli#installation")
+      console.log("")
+      console.log("Después de instalar, ejecuta: gh auth login")
+      console.log("")
+      await this.waitForEnter("Presiona Enter para salir...")
+      process.exit(1)
+    }
+
+    console.log("")
+
+    // Check gh authentication
+    console.log("Verificando autenticación en GitHub...")
+    try {
+      execSync('gh auth status', { encoding: 'utf8', stdio: 'pipe' })
+      console.log("✅ Autenticado en GitHub")
+    } catch (error) {
+      console.log("❌ No estás autenticado en GitHub")
+      console.log("")
+      console.log("Por favor ejecuta: gh auth login")
+      console.log("Y sigue las instrucciones para autenticarte.")
+      console.log("")
+      await this.waitForEnter("Presiona Enter para salir...")
+      process.exit(1)
+    }
+
+    console.log("")
+    console.log("🎉 ¡Todo listo! Tienes todas las herramientas necesarias.")
+
+    await this.waitForEnter("\nPresiona Enter para continuar...")
+  }
+
+  async step1_ForkExplanation() {
+    console.clear()
+    console.log("Paso 1: Entender el Fork")
+    console.log("=" .repeat(50))
+    console.log("")
+    console.log("🤔 ¿Qué es un fork?")
+    console.log("")
+    console.log("Un fork es una COPIA de un repositorio que queda en TU cuenta de GitHub.")
+    console.log("Es como sacar una fotocopia de un libro para poder escribir en él.")
+    console.log("")
+    console.log("¿Por qué necesitamos hacer fork?")
+    console.log("  • No tienes permisos para modificar el repositorio original")
+    console.log("  • Trabajas en tu copia sin afectar el original")
+    console.log("  • Después propones tus cambios mediante una Pull Request")
+
+    await this.waitForEnter("\nPresiona Enter para hacer el fork...")
+
+    console.log("")
+    console.log("📋 Vamos a hacer fork del repositorio de práctica de Creta:")
+    console.log(`   ${this.repoUrl}`)
+    console.log("")
+    console.log("Ejecutando: gh repo fork icarusmx/creta-practice --clone=false")
+    console.log("")
+
+    try {
+      // Primero verificar si el repo existe o si ya tiene un fork
+      try {
+        const checkFork = execSync(`gh repo view ${this.practiceRepo}`, {
+          encoding: 'utf8',
+          stdio: 'pipe'
+        })
+
+        // Si llegamos aquí, el repo existe, intentar hacer fork
+        try {
+          execSync(`gh repo fork ${this.practiceRepo} --clone=false`, {
+            encoding: 'utf8',
+            stdio: 'inherit'
+          })
+          console.log("✅ Fork creado exitosamente")
+        } catch (forkError) {
+          // Probablemente ya tiene un fork
+          console.log("ℹ️  Ya tienes un fork de este repositorio")
+        }
+      } catch (repoError) {
+        console.log("⚠️  El repositorio de práctica aún no existe.")
+        console.log("")
+        console.log("Por ahora, practicaremos con el repositorio de Creta CLI:")
+        this.practiceRepo = 'icarusmx/creta'
+        this.repoUrl = `https://github.com/${this.practiceRepo}`
+
+        console.log("")
+        console.log(`Haciendo fork de: ${this.repoUrl}`)
+        console.log("")
+
+        try {
+          execSync(`gh repo fork ${this.practiceRepo} --clone=false`, {
+            encoding: 'utf8',
+            stdio: 'inherit'
+          })
+          console.log("✅ Fork creado exitosamente")
+        } catch (forkError) {
+          console.log("ℹ️  Ya tienes un fork de este repositorio")
+        }
+      }
+    } catch (error) {
+      console.log("❌ Error al hacer fork:", error.message)
+      console.log("")
+      console.log("Puedes hacer fork manualmente en:")
+      console.log(`${this.repoUrl}`)
+      console.log("(Click en el botón 'Fork' en la esquina superior derecha)")
+    }
+
+    await this.waitForEnter("\nPresiona Enter para continuar al siguiente paso...")
+  }
+
+  async step2_CloneRepo() {
+    console.clear()
+    console.log("Paso 2: Clonar tu Fork")
+    console.log("=" .repeat(50))
+    console.log("")
+    console.log("🤔 ¿Qué es clonar?")
+    console.log("")
+    console.log("Clonar es DESCARGAR una copia del repositorio a tu computadora.")
+    console.log("Ahora trabajarás en tu máquina local, no en GitHub.")
+    console.log("")
+    console.log("¿Por qué clonar tu fork y no el original?")
+    console.log("  • Tu fork está en tu cuenta, puedes hacer push a él")
+    console.log("  • El original no aceptaría tus cambios directos")
+
+    await this.waitForEnter("\nPresiona Enter para clonar...")
+
+    console.log("")
+    console.log("🔧 Ahora necesitamos clonar TU fork (no el original)")
+    console.log("")
+
+    // Obtener el username de GitHub
+    let username
+    try {
+      const authStatus = execSync('gh api user --jq .login', { encoding: 'utf8' }).trim()
+      username = authStatus
+      console.log(`Tu usuario de GitHub: ${username}`)
+    } catch (error) {
+      console.log("No pudimos obtener tu usuario automáticamente.")
+      username = await this.askQuestion("¿Cuál es tu usuario de GitHub? ")
+    }
+
+    const forkUrl = `https://github.com/${username}/${this.practiceRepo.split('/')[1]}`
+    const projectName = this.practiceRepo.split('/')[1]
+
+    console.log("")
+    console.log(`Clonando: ${forkUrl}`)
+    console.log("")
+
+    try {
+      // Verificar si ya existe el directorio
+      if (fs.existsSync(projectName)) {
+        console.log(`ℹ️  El directorio '${projectName}' ya existe.`)
+        const useExisting = await this.askQuestion("¿Quieres usar este directorio? (s/n): ")
+
+        if (useExisting.toLowerCase() === 's') {
+          this.projectDir = path.resolve(projectName)
+          console.log(`✅ Usando directorio existente: ${this.projectDir}`)
+        } else {
+          console.log("Por favor elimina o renombra el directorio y vuelve a intentar.")
+          process.exit(0)
+        }
+      } else {
+        console.log(`Ejecutando: git clone ${forkUrl}`)
+        execSync(`git clone ${forkUrl}`, { encoding: 'utf8', stdio: 'inherit' })
+        this.projectDir = path.resolve(projectName)
+        console.log(`✅ Repositorio clonado en: ${this.projectDir}`)
+      }
+    } catch (error) {
+      console.log("❌ Error al clonar:", error.message)
+      process.exit(1)
+    }
+
+    await this.waitForEnter("\nPresiona Enter para continuar al siguiente paso...")
+  }
+
+  async step3_CreateBranch() {
+    console.clear()
+    console.log("Paso 3: Crear una Rama (Branch)")
+    console.log("=" .repeat(50))
+    console.log("")
+    console.log("🤔 ¿Qué es una rama?")
+    console.log("")
+    console.log("Una rama es una LÍNEA DE DESARROLLO independiente.")
+    console.log("Es como trabajar en una copia paralela del código.")
+    console.log("")
+    console.log("¿Por qué crear una rama?")
+    console.log("  • No modificas la rama principal (main) directamente")
+    console.log("  • Puedes experimentar sin romper nada")
+    console.log("  • Facilita el code review")
+    console.log("  • Es la práctica estándar en equipos profesionales")
+
+    await this.waitForEnter("\nPresiona Enter para crear tu rama...")
+
+    console.log("")
+    console.log("💡 Reglas para nombres de ramas:")
+    console.log("  • Descriptivos y cortos")
+    console.log("  • En minúsculas, separados por guiones")
+    console.log("  • Ejemplos: fix-navbar, add-login, update-readme")
+    console.log("")
+
+    const defaultBranchName = "mi-primera-contribucion"
+    const branchName = await this.askQuestion(`Nombre de tu rama [${defaultBranchName}]: `) || defaultBranchName
+
+    console.log("")
+    console.log(`Ejecutando: git checkout -b ${branchName}`)
+    console.log("")
+
+    try {
+      process.chdir(this.projectDir)
+      execSync(`git checkout -b ${branchName}`, { encoding: 'utf8', stdio: 'inherit' })
+      console.log(`✅ Rama '${branchName}' creada y seleccionada`)
+    } catch (error) {
+      console.log("❌ Error al crear rama:", error.message)
+      process.exit(1)
+    }
+
+    await this.waitForEnter("\nPresiona Enter para continuar al siguiente paso...")
+  }
+
+  async step4_MakeChanges() {
+    console.clear()
+    console.log("Paso 4: Hacer Cambios")
+    console.log("=" .repeat(50))
+    console.log("")
+    console.log("🤔 ¿Qué cambios haremos?")
+    console.log("")
+    console.log("Vamos a agregar tu nombre a un archivo de contribuidores.")
+    console.log("Este es un cambio simple y seguro para practicar.")
+    console.log("")
+
+    await this.waitForEnter("Presiona Enter para hacer el cambio...")
+
+    console.log("")
+
+    const contributorsFile = path.join(this.projectDir, 'CONTRIBUTORS.md')
+
+    // Crear archivo si no existe
+    if (!fs.existsSync(contributorsFile)) {
+      console.log("Creando archivo CONTRIBUTORS.md...")
+      fs.writeFileSync(contributorsFile, '# Contribuidores\n\nGracias a estas personas por contribuir al proyecto:\n\n')
+    }
+
+    const name = await this.askQuestion("¿Cómo te llamas? ")
+    const date = new Date().toISOString().split('T')[0]
+
+    console.log("")
+    console.log("Agregando tu nombre al archivo...")
+
+    try {
+      const content = fs.readFileSync(contributorsFile, 'utf8')
+      const newContent = content + `- ${name} (${date})\n`
+      fs.writeFileSync(contributorsFile, newContent)
+      console.log("✅ Cambio realizado exitosamente")
+      console.log("")
+      console.log(`Tu nombre fue agregado a: ${contributorsFile}`)
+    } catch (error) {
+      console.log("❌ Error al modificar archivo:", error.message)
+      process.exit(1)
+    }
+
+    console.log("")
+    console.log("🔍 Verificando cambios...")
+    console.log("")
+    console.log("Ejecutando: git status")
+    console.log("")
+
+    try {
+      execSync('git status', { encoding: 'utf8', stdio: 'inherit' })
+    } catch (error) {
+      // git status siempre funciona
+    }
+
+    await this.waitForEnter("\nPresiona Enter para continuar al siguiente paso...")
+  }
+
+  async step5_CommitChanges() {
+    console.clear()
+    console.log("Paso 5: Hacer Commit de los Cambios")
+    console.log("=" .repeat(50))
+    console.log("")
+    console.log("🤔 ¿Qué es un commit?")
+    console.log("")
+    console.log("Un commit es un PUNTO DE GUARDADO en la historia del proyecto.")
+    console.log("Es como tomar una fotografía del estado actual del código.")
+    console.log("")
+    console.log("Cada commit tiene:")
+    console.log("  • Los cambios que hiciste")
+    console.log("  • Un mensaje describiendo QUÉ y POR QUÉ")
+    console.log("  • Tu nombre y la fecha")
+
+    await this.waitForEnter("\nPresiona Enter para hacer el commit...")
+
+    console.log("")
+    console.log("📝 Primero agregamos el archivo al staging area:")
+    console.log("Ejecutando: git add CONTRIBUTORS.md")
+    console.log("")
+
+    try {
+      execSync('git add CONTRIBUTORS.md', { encoding: 'utf8', stdio: 'inherit' })
+      console.log("✅ Archivo agregado al staging area")
+    } catch (error) {
+      console.log("❌ Error al agregar archivo:", error.message)
+      process.exit(1)
+    }
+
+    console.log("")
+    console.log("💡 Ahora escribimos el mensaje del commit")
+    console.log("")
+    console.log("Reglas para buenos mensajes:")
+    console.log("  • Primera línea: resumen corto (50 caracteres)")
+    console.log("  • Usa imperativo: 'Agrega' no 'Agregué' ni 'Agregando'")
+    console.log("  • Sé específico: di QUÉ cambió y POR QUÉ")
+    console.log("")
+
+    const name = await this.askQuestion("¿Cómo te llamas? (para el mensaje del commit): ")
+    const commitMessage = `Agrega ${name} a la lista de contribuidores`
+
+    console.log("")
+    console.log(`Mensaje del commit: "${commitMessage}"`)
+    console.log("")
+    console.log(`Ejecutando: git commit -m "${commitMessage}"`)
+    console.log("")
+
+    try {
+      execSync(`git commit -m "${commitMessage}"`, { encoding: 'utf8', stdio: 'inherit' })
+      console.log("✅ Commit creado exitosamente")
+    } catch (error) {
+      console.log("❌ Error al crear commit:", error.message)
+      process.exit(1)
+    }
+
+    console.log("")
+    console.log("🎉 ¡Tu cambio ahora es parte de la historia del repositorio!")
+    console.log("")
+    console.log("Puedes verlo con: git log --oneline")
+
+    await this.waitForEnter("\nPresiona Enter para continuar al siguiente paso...")
+  }
+
+  async step6_PushBranch() {
+    console.clear()
+    console.log("Paso 6: Subir los Cambios a GitHub (Push)")
+    console.log("=" .repeat(50))
+    console.log("")
+    console.log("🤔 ¿Qué es push?")
+    console.log("")
+    console.log("Push es SUBIR tus commits locales a GitHub.")
+    console.log("Hasta ahora todo estaba solo en tu computadora.")
+    console.log("")
+    console.log("¿Por qué hacer push?")
+    console.log("  • Respalda tu trabajo en la nube")
+    console.log("  • Otros pueden ver tus cambios")
+    console.log("  • Es necesario para crear la Pull Request")
+
+    await this.waitForEnter("\nPresiona Enter para hacer push...")
+
+    console.log("")
+    console.log("🚀 Subiendo tu rama a GitHub...")
+    console.log("")
+
+    // Obtener el nombre de la rama actual
+    let branchName
+    try {
+      branchName = execSync('git branch --show-current', { encoding: 'utf8' }).trim()
+    } catch (error) {
+      branchName = 'tu-rama'
+    }
+
+    console.log(`Ejecutando: git push origin ${branchName}`)
+    console.log("")
+
+    try {
+      execSync(`git push -u origin ${branchName}`, { encoding: 'utf8', stdio: 'inherit' })
+      console.log("")
+      console.log("✅ Cambios subidos exitosamente a GitHub")
+    } catch (error) {
+      console.log("❌ Error al hacer push:", error.message)
+      console.log("")
+      console.log("Si el error es de autenticación, verifica que estés autenticado con gh.")
+      process.exit(1)
+    }
+
+    console.log("")
+    console.log("🎉 ¡Tu rama ya está en GitHub!")
+    console.log("Ahora cualquiera puede ver tus cambios.")
+
+    await this.waitForEnter("\nPresiona Enter para continuar al siguiente paso...")
+  }
+
+  async step7_CreatePR() {
+    console.clear()
+    console.log("Paso 7: Crear la Pull Request")
+    console.log("=" .repeat(50))
+    console.log("")
+    console.log("🤔 ¿Qué es una Pull Request (PR)?")
+    console.log("")
+    console.log("Una PR es una PROPUESTA de cambios al repositorio original.")
+    console.log("Es como decir: 'Mira los cambios que hice, ¿los aceptas?'")
+    console.log("")
+    console.log("¿Qué pasa después de crear una PR?")
+    console.log("  • Los mantenedores revisan tu código")
+    console.log("  • Pueden pedirte cambios")
+    console.log("  • Si todo está bien, la aceptan (merge)")
+    console.log("  • Tus cambios quedan en el proyecto original")
+
+    await this.waitForEnter("\nPresiona Enter para crear la PR...")
+
+    console.log("")
+    console.log("📝 Vamos a crear la PR con información descriptiva")
+    console.log("")
+
+    const prTitle = await this.askQuestion("Título de la PR [Agrega nuevo contribuidor]: ") || "Agrega nuevo contribuidor"
+
+    console.log("")
+    console.log("💡 El cuerpo de la PR debe explicar:")
+    console.log("  • QUÉ cambios hiciste")
+    console.log("  • POR QUÉ los hiciste")
+    console.log("  • CÓMO probaste que funcionan")
+    console.log("")
+
+    const prBody = `## Descripción
+
+Agregué mi nombre a la lista de contribuidores como parte del tutorial de Creta.
+
+## Checklist
+
+- [x] El código sigue las convenciones del proyecto
+- [x] He probado mis cambios localmente
+- [x] Los cambios no rompen funcionalidad existente
+
+---
+
+🏛️ Creado con [Creta](https://github.com/icarusmx/creta) - Tutorial de Pull Requests`
+
+    console.log("")
+    console.log(`Ejecutando: gh pr create --title "${prTitle}" --body "..."`)
+    console.log("")
+
+    try {
+      execSync(`gh pr create --title "${prTitle}" --body "${prBody}"`, {
+        encoding: 'utf8',
+        stdio: 'inherit'
+      })
+      console.log("")
+      console.log("✅ Pull Request creada exitosamente")
+    } catch (error) {
+      console.log("❌ Error al crear PR:", error.message)
+      console.log("")
+      console.log("Puedes crear la PR manualmente en GitHub:")
+      console.log(`${this.repoUrl}/pulls`)
+    }
+
+    await this.waitForEnter("\nPresiona Enter para ver la conclusión...")
+  }
+
+  async conclusion() {
+    console.clear()
+    console.log("🎉 ¡Felicidades! Completaste el Tutorial")
+    console.log("=" .repeat(50))
+    console.log("")
+    console.log("📚 Lo que aprendiste:")
+    console.log("")
+    console.log("✅ Qué es un fork y cómo hacerlo")
+    console.log("✅ Cómo clonar un repositorio")
+    console.log("✅ Cómo crear y trabajar en ramas")
+    console.log("✅ Cómo hacer commits con buenos mensajes")
+    console.log("✅ Cómo subir cambios con push")
+    console.log("✅ Cómo crear una Pull Request profesional")
+    console.log("")
+    console.log("🚀 Ahora estás listo para:")
+    console.log("")
+    console.log("• Contribuir a proyectos open source")
+    console.log("• Trabajar en equipos de desarrollo")
+    console.log("• Seguir las mejores prácticas de Git/GitHub")
+    console.log("")
+    console.log("💡 Próximos pasos:")
+    console.log("")
+    console.log("1. Espera feedback en tu PR")
+    console.log("2. Practica haciendo más PRs")
+    console.log("3. Busca proyectos open source para contribuir")
+    console.log("")
+    console.log("📖 Recursos adicionales:")
+    console.log("")
+    console.log("• GitHub Docs: https://docs.github.com/pull-requests")
+    console.log("• Git Book: https://git-scm.com/book/es")
+    console.log("• First Contributions: https://firstcontributions.github.io")
+
+    await this.waitForEnter("\n✨ Presiona Enter para finalizar...")
+  }
+
+  async waitForEnter(message) {
+    return new Promise((resolve) => {
+      this.rl.question(message, () => {
+        console.log("")
+        resolve()
+      })
+    })
+  }
+
+  async askQuestion(question) {
+    return new Promise((resolve) => {
+      this.rl.question(question, (answer) => {
+        resolve(answer)
+      })
+    })
+  }
+}
+
+// Para usar el tutorial independientemente
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const tutorial = new PullRequestTutorial()
+  await tutorial.start()
+}

package/package.json

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