@icarusmx/creta 0.10.1 → 0.11.0

package/bin/creta.js

@@ -7,6 +7,7 @@ import path from 'path'
 import { fileURLToPath } from 'url'
 import { CretaCodeSession } from '../lib/session.js'
 import { Lesson1SystemDecomposition } from '../lessons/lesson1-system-decomposition.js'
+import { Lesson2ObjectRequests } from '../lessons/lesson2-object-requests.js'
 import { Lesson6InterfaceDesign } from '../lessons/lesson6-interface-design.js'
 
 const ENUNCIADOS = [
@@ -827,6 +828,34 @@ async function startEnunciadosSelectorInteractive() {
             console.log("- Ejercicios prácticos que ilustren el concepto")
             console.log("- Proyectos específicos para internalizar la idea")
           }
+        } else if (enunciadoSeleccionado.id === 1) {
+          console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson1 = new Lesson1SystemDecomposition()
+            await lesson1.start()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+          }
+        } else if (enunciadoSeleccionado.id === 2) {
+          console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson2 = new Lesson2ObjectRequests()
+            await lesson2.start()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+          }
         } else if (enunciadoSeleccionado.id === 6) {
           console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
           await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
@@ -926,6 +955,38 @@ async function startEnunciadosSelectorFallback() {
           console.log("- Proyectos específicos para internalizar la idea")
         }
         return
+      } else if (enunciadoSeleccionado.id === 1) {
+        console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson1 = new Lesson1SystemDecomposition()
+          await lesson1.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 2) {
+        console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson2 = new Lesson2ObjectRequests()
+          await lesson2.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
       } else if (enunciadoSeleccionado.id === 6) {
         console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
         rl.close()

package/lessons/lesson1-system-decomposition.js

@@ -52,27 +52,46 @@ export class Lesson1SystemDecomposition {
 
   async step2_ApplyDefinitions() {
     console.clear()
-    console.log("Sistema: Biblioteca Digital")
-
-    console.log("\nReglas del dominio:")
-    console.log("• Un libro puede estar disponible o prestado")
-    console.log("• Un usuario puede tener máximo N libros prestados")
-    console.log("• Un préstamo tiene fecha de inicio y vencimiento")
-    console.log("• Solo usuarios registrados pueden solicitar préstamos")
-    console.log("• Un libro prestado no puede prestarse a otro usuario")
-    console.log("• Los préstamos vencidos generan multas")
-
-    await this.waitForEnter("\nPresiona Enter para ver los componentes...")
-
-    console.log("\nComponentes que colaboran:")
-    console.log("• Catálogo de libros disponibles")
-    console.log("• Sistema de usuarios registrados")
-    console.log("• Proceso de préstamos y devoluciones")
-    console.log("• Control de fechas y multas")
-    console.log("• Búsqueda y recomendaciones")
-    console.log("• Reportes de uso y estadísticas")
-
-    await this.waitForEnter("\nPresiona Enter para ver la descomposición...")
+    console.log("🏛️ EJEMPLO: Biblioteca Digital")
+    console.log("=" .repeat(40))
+
+    console.log("\n📚 DEFINICIÓN 1 - Totalidad deductiva de discurso:")
+    console.log("Partiendo de 'Biblioteca Digital', ¿qué se deduce naturalmente?")
+    await this.waitForEnter("\nPresiona Enter para ver la primera deducción...")
+
+    console.log("\n🔍 Primera deducción:")
+    console.log("• De 'Biblioteca' → contiene LIBROS")
+    console.log("• De 'Digital' → acceso remoto por USUARIOS")
+
+    await this.waitForEnter("\nPresiona Enter para ver la deducción clave...")
+
+    console.log("\n⚡ Deducción clave:")
+    console.log("• LIBROS + USUARIOS → deben INTERACTUAR")
+    console.log("• ¿Cómo? → préstamos, búsquedas, devoluciones")
+    console.log("\n💡 Conclusión: De 'biblioteca digital' se deduce naturalmente")
+    console.log("   un conjunto de libros y usuarios interactuando")
+
+    await this.waitForEnter("\nPresiona Enter para la segunda definición...")
+
+    console.clear()
+    console.log("🎯 DEFINICIÓN 2 - Conjunto de cosas con propósito:")
+    console.log("¿Qué elementos relacionados contribuyen al propósito?")
+
+    console.log("\n📖 Elementos del sistema:")
+    console.log("• LIBROS - recursos que se prestan")
+    console.log("• USUARIOS - quienes solicitan préstamos")
+    console.log("• PRÉSTAMOS - relación temporal entre libro y usuario")
+    console.log("• BIBLIOTECA - coordina todo el proceso")
+
+    console.log("\n🎯 Propósito determinado:")
+    console.log("Facilitar el acceso organizado a recursos bibliográficos")
+
+    console.log("\n🔗 Relaciones ordenadas:")
+    console.log("• Usuario solicita → Biblioteca evalúa → Préstamo se crea")
+    console.log("• Libro cambia estado → Usuario recibe acceso → Plazo se establece")
+    console.log("• Vencimiento llega → Usuario devuelve → Libro se libera")
+
+    await this.waitForEnter("\nPresiona Enter para ver la descomposición en objetos...")
   }
 
   async step3_ObjectIdentification() {
@@ -210,27 +229,39 @@ export class Lesson1SystemDecomposition {
 
   async conclusion() {
     console.clear()
-    console.log("CONCLUSIÓN")
+    console.log("🎓 CONCLUSIÓN: La Descomposición de Sistemas")
     console.log("=" .repeat(50))
-    console.log("Vimos cómo un sistema puede entenderse desde dos perspectivas:")
-    console.log("1. Como totalidad deductiva de discurso (reglas lógicas)")
-    console.log("2. Como conjunto de cosas que colaboran hacia un propósito")
+    console.log("🎯 Hemos demostrado que:")
+
+    console.log("\n1️⃣ SISTEMA como totalidad deductiva:")
+    console.log("   • De 'biblioteca digital' se deduce naturalmente: libros + usuarios")
+    console.log("   • Esta deducción revela la interacción fundamental del sistema")
+
+    console.log("\n2️⃣ SISTEMA como conjunto con propósito:")
+    console.log("   • Elementos identificados: Book, User, Loan, Library")
+    console.log("   • Relaciones ordenadas: solicitud → evaluación → préstamo → devolución")
+    console.log("   • Propósito determinado: acceso organizado a recursos")
+
+    console.log("\n⚡ LA PARTE DIFÍCIL:")
+    console.log("¿Cómo decidimos que necesitábamos exactamente estos 4 objetos?")
+    console.log("¿Por qué no 3? ¿Por qué no 10? ¿Cuál es el criterio?")
 
-    console.log("\nLa biblioteca digital se descompuso en objetos que:")
-    console.log("• Book - maneja su propio estado de disponibilidad")
-    console.log("• User - controla sus límites de préstamo")
-    console.log("• Loan - calcula multas y fechas de vencimiento")
-    console.log("• Library - coordina las interacciones entre todos")
+    console.log("\n🔍 Criterio de descomposición:")
+    console.log("• Book - responsabilidad de estado propio")
+    console.log("• User - responsabilidad de sus límites")
+    console.log("• Loan - responsabilidad de la relación temporal")
+    console.log("• Library - responsabilidad de coordinación")
 
-    console.log("\nCada objeto encapsula parte de las reglas del sistema")
-    console.log("y colabora con otros para cumplir el propósito general.")
+    console.log("\n📚 Conexión con lecciones siguientes:")
+    console.log("• Lección 2: Los objetos interactúan a través de solicitudes")
+    console.log("• Lección 3: Las solicitudes son la única forma de ejecutar operaciones")
+    console.log("• Lección 4-6: Cómo definir esas interacciones correctamente")
 
-    console.log("\nConexión con lecciones siguientes:")
-    console.log("• Lección 2: Cómo estos objetos interactúan")
-    console.log("• Lección 3: El mecanismo de las solicitudes")
-    console.log("• Lección 4-6: Cómo definir esas interacciones")
+    console.log("\n💭 Reflexión:")
+    console.log("La descomposición en objetos es difícil porque requiere identificar")
+    console.log("las responsabilidades naturales que se deducen del sistema.")
 
-    await this.waitForEnter("\nLección 1 completada. Presiona Enter para salir...")
+    await this.waitForEnter("\n✨ ¡Lección 1 completada! Presiona Enter para salir...")
   }
 
   async waitForEnter(message) {

package/lessons/lesson2-object-requests.js

@@ -0,0 +1,312 @@
+#!/usr/bin/env node
+
+// LECCIÓN 2: Los objetos interactúan entre sí a través de solicitudes
+// Enfoque práctico: Demostrar cómo los objetos se comunican sin acceder directamente a datos internos
+
+import { createInterface } from 'readline'
+
+export class Lesson2ObjectRequests {
+  constructor() {
+    this.rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+  }
+
+  async start() {
+    console.log("🎯 LECCIÓN 2: Interacción a través de Solicitudes")
+    console.log("=" .repeat(50))
+    console.log("📚 Enunciado: Los objetos interactúan entre sí a través de solicitudes.")
+    console.log("\n💡 ¿Qué significa esto exactamente?")
+    console.log("- Los objetos NO acceden directamente a los datos de otros objetos")
+    console.log("- En lugar de eso, hacen SOLICITUDES específicas")
+    console.log("- Cada solicitud tiene un propósito claro y definido")
+
+    await this.waitForEnter("\nPresiona Enter para comenzar el ejercicio práctico...")
+
+    await this.practicalExercise()
+    await this.conclusion()
+
+    this.rl.close()
+  }
+
+  async practicalExercise() {
+    console.clear()
+    console.log("🛠️ EJERCICIO PRÁCTICO: Sistema de Mensajería")
+    console.log("=" .repeat(50))
+    console.log("🎯 Vamos a ver cómo los objetos se solicitan información sin acceso directo")
+    console.log("\nSistema: Chat entre usuarios")
+    console.log("Objetos: User, Message, ChatRoom")
+
+    await this.waitForEnter("\nPresiona Enter para ver el ANTI-PATRÓN...")
+
+    await this.step1_ShowAntiPattern()
+    await this.step2_ShowCorrectPattern()
+    await this.step3_RequestTypes()
+    await this.step4_ComplexInteraction()
+  }
+
+  async step1_ShowAntiPattern() {
+    console.clear()
+    console.log("❌ ANTI-PATRÓN: Acceso Directo (INCORRECTO)")
+    console.log("=" .repeat(45))
+    console.log("Veamos qué NO debemos hacer:")
+
+    console.log("\n// ❌ MALO: Acceso directo a datos internos")
+    console.log(`class ChatRoom {
+  addMessage(user, text) {
+    // ❌ Accediendo directamente a user.name
+    if (user.name && user.name.length > 0) {
+      // ❌ Accediendo directamente a user.isActive
+      if (user.isActive === true) {
+        const message = new Message(user.name, text)
+        this.messages.push(message)
+      }
+    }
+  }
+}`)
+
+    console.log("\n🚨 Problemas del acceso directo:")
+    console.log("• ChatRoom conoce la estructura interna de User")
+    console.log("• Si User cambia, ChatRoom se rompe")
+    console.log("• No hay control sobre qué se accede")
+    console.log("• Violación de encapsulación")
+
+    await this.waitForEnter("\nPresiona Enter para ver la forma CORRECTA...")
+  }
+
+  async step2_ShowCorrectPattern() {
+    console.clear()
+    console.log("✅ PATRÓN CORRECTO: Solicitudes (CORRECTO)")
+    console.log("=" .repeat(45))
+    console.log("Ahora veamos cómo debe ser:")
+
+    console.log("\n// ✅ BUENO: Comunicación a través de solicitudes")
+    console.log(`class User {
+  constructor(name) {
+    this.#name = name
+    this.#isActive = true
+  }
+
+  // 🔑 SOLICITUD: getName()
+  getName() {
+    return this.#name
+  }
+
+  // 🔑 SOLICITUD: isCurrentlyActive()
+  isCurrentlyActive() {
+    return this.#isActive
+  }
+
+  // 🔑 SOLICITUD: canSendMessage()
+  canSendMessage() {
+    return this.#isActive && this.#name.length > 0
+  }
+}`)
+
+    await this.waitForEnter("\nPresiona Enter para ver cómo ChatRoom usa las solicitudes...")
+
+    console.log("\n// ✅ ChatRoom usa SOLICITUDES, no acceso directo")
+    console.log(`class ChatRoom {
+  addMessage(user, text) {
+    // ✅ SOLICITUD: ¿puede enviar mensajes?
+    if (user.canSendMessage()) {
+      // ✅ SOLICITUD: dame tu nombre
+      const userName = user.getName()
+      const message = new Message(userName, text)
+      this.messages.push(message)
+    }
+  }
+
+  getActiveUsers() {
+    return this.users.filter(user =>
+      // ✅ SOLICITUD: ¿estás activo?
+      user.isCurrentlyActive()
+    )
+  }
+}`)
+
+    console.log("\n🌟 Beneficios de las solicitudes:")
+    console.log("• ChatRoom no conoce la estructura interna de User")
+    console.log("• User controla qué información expone")
+    console.log("• Cambios internos en User no afectan ChatRoom")
+    console.log("• Cada solicitud tiene un propósito específico")
+
+    await this.waitForEnter("\nPresiona Enter para ver tipos de solicitudes...")
+  }
+
+  async step3_RequestTypes() {
+    console.clear()
+    console.log("🔍 TIPOS DE SOLICITUDES")
+    console.log("=" .repeat(30))
+    console.log("Las solicitudes pueden ser de diferentes tipos:")
+
+    console.log("\n1️⃣ SOLICITUDES DE CONSULTA (Query)")
+    console.log("   • user.getName() → devuelve información")
+    console.log("   • user.isCurrentlyActive() → devuelve estado")
+    console.log("   • message.getTimestamp() → devuelve dato")
+
+    console.log("\n2️⃣ SOLICITUDES DE ACCIÓN (Command)")
+    console.log("   • user.setActive(false) → cambia estado")
+    console.log("   • message.markAsRead() → ejecuta acción")
+    console.log("   • chatRoom.addUser(user) → modifica colección")
+
+    console.log("\n3️⃣ SOLICITUDES DE VALIDACIÓN (Validation)")
+    console.log("   • user.canSendMessage() → verifica capacidad")
+    console.log("   • message.isValid() → verifica integridad")
+    console.log("   • chatRoom.hasPermission(user) → verifica acceso")
+
+    await this.waitForEnter("\nPresiona Enter para ver una interacción compleja...")
+
+    console.clear()
+    console.log("💬 EJEMPLO: Enviar mensaje con validaciones")
+    console.log("=" .repeat(45))
+
+    console.log("\n// Los objetos colaboran solo a través de solicitudes")
+    console.log(`function sendMessage(chatRoom, user, text) {
+  // 🔍 SOLICITUD: ¿el usuario puede enviar?
+  if (!user.canSendMessage()) {
+    console.log("Usuario no puede enviar mensajes")
+    return false
+  }
+
+  // 🔍 SOLICITUD: ¿el usuario tiene permisos en este chat?
+  if (!chatRoom.hasPermission(user)) {
+    console.log("Sin permisos en este chat")
+    return false
+  }
+
+  // 🔍 SOLICITUD: ¿el texto es válido?
+  const message = new Message(user.getName(), text)
+  if (!message.isValid()) {
+    console.log("Mensaje inválido")
+    return false
+  }
+
+  // ⚡ SOLICITUD: agregar el mensaje
+  chatRoom.addMessage(user, text)
+
+  // 🔍 SOLICITUD: notificar a usuarios activos
+  const activeUsers = chatRoom.getActiveUsers()
+  activeUsers.forEach(activeUser => {
+    // 🔍 SOLICITUD: notificar
+    activeUser.notifyNewMessage(message)
+  })
+
+  return true
+}`)
+
+    console.log("\n🎯 Observa: En ningún momento accedemos directamente a")
+    console.log("    user.#name, user.#isActive, chatRoom.#messages, etc.")
+    console.log("    Todo pasa por SOLICITUDES específicas.")
+
+    await this.waitForEnter("\nPresiona Enter para la demostración final...")
+  }
+
+  async step4_ComplexInteraction() {
+    console.clear()
+    console.log("🎭 DEMOSTRACIÓN: Interacción Completa")
+    console.log("=" .repeat(40))
+    console.log("Veamos todos los objetos interactuando:")
+
+    console.log("\n// Crear objetos")
+    console.log("const chatRoom = new ChatRoom('Desarrollo')")
+    console.log("const ana = new User('Ana')")
+    console.log("const carlos = new User('Carlos')")
+    console.log("")
+    console.log("// Agregar usuarios al chat")
+    console.log("chatRoom.addUser(ana)    // SOLICITUD")
+    console.log("chatRoom.addUser(carlos) // SOLICITUD")
+    console.log("")
+    console.log("// Ana envía mensaje")
+    console.log("sendMessage(chatRoom, ana, 'Hola a todos!')")
+    console.log("")
+    console.log("// Secuencia de SOLICITUDES que se ejecutan:")
+    console.log("// 1. ana.canSendMessage() → true")
+    console.log("// 2. chatRoom.hasPermission(ana) → true")
+    console.log("// 3. ana.getName() → 'Ana'")
+    console.log("// 4. message.isValid() → true")
+    console.log("// 5. chatRoom.addMessage(ana, text)")
+    console.log("// 6. chatRoom.getActiveUsers() → [ana, carlos]")
+    console.log("// 7. carlos.notifyNewMessage(message)")
+
+    console.log("\n💡 Resultado:")
+    console.log("✅ Ana: Mensaje enviado")
+    console.log("📬 Carlos: Notificación recibida")
+
+    await this.waitForEnter("\nPresiona Enter para ver qué pasa si Carlos se desconecta...")
+
+    console.log("\n// Carlos se desconecta")
+    console.log("carlos.setActive(false)  // SOLICITUD")
+    console.log("")
+    console.log("// Ana envía otro mensaje")
+    console.log("sendMessage(chatRoom, ana, 'Carlos, ¿estás ahí?')")
+    console.log("")
+    console.log("// Secuencia de SOLICITUDES:")
+    console.log("// 1-5. Igual que antes...")
+    console.log("// 6. chatRoom.getActiveUsers() → [ana]  // ¡Carlos ya no aparece!")
+    console.log("// 7. Solo ana.notifyNewMessage() se ejecuta")
+
+    console.log("\n💡 Resultado:")
+    console.log("✅ Ana: Mensaje enviado")
+    console.log("😴 Carlos: No recibe notificación (está inactivo)")
+
+    console.log("\n🎯 Observación clave:")
+    console.log("Los objetos cambian su comportamiento interno, pero las")
+    console.log("SOLICITUDES siguen siendo las mismas. La interacción es estable.")
+
+    await this.waitForEnter("\nPresiona Enter para la conclusión...")
+  }
+
+  async conclusion() {
+    console.clear()
+    console.log("🎓 CONCLUSIÓN: Interacción a través de Solicitudes")
+    console.log("=" .repeat(50))
+    console.log("🎯 Hemos demostrado que:")
+
+    console.log("\n1️⃣ Los objetos NUNCA acceden directamente a datos internos")
+    console.log("2️⃣ Toda comunicación ocurre a través de SOLICITUDES específicas")
+    console.log("3️⃣ Cada solicitud tiene un propósito claro y definido")
+    console.log("4️⃣ Los objetos controlan qué información exponen")
+
+    console.log("\n🔑 Tipos de solicitudes vistas:")
+    console.log("• CONSULTA: getName(), isCurrentlyActive()")
+    console.log("• ACCIÓN: setActive(), addMessage()")
+    console.log("• VALIDACIÓN: canSendMessage(), hasPermission()")
+
+    console.log("\n🌟 Beneficios fundamentales:")
+    console.log("• Encapsulación preservada")
+    console.log("• Flexibilidad para cambios internos")
+    console.log("• Interacciones estables y predecibles")
+    console.log("• Control total sobre el acceso a datos")
+
+    console.log("\n📚 Conexión con otras lecciones:")
+    console.log("• Lección 1: Los objetos que identificamos ahora interactúan")
+    console.log("• Lección 3: Las solicitudes son la ÚNICA forma de ejecutar operaciones")
+    console.log("• Lecciones 4-6: Cómo definir formalmente estas solicitudes")
+
+    console.log("\n💭 Reflexión:")
+    console.log("¿Te imaginas un mundo donde pudieras acceder directamente")
+    console.log("a la cuenta bancaria de cualquier persona? ¡Sería un caos!")
+    console.log("Los objetos funcionan igual: solicitudes controladas, acceso seguro.")
+
+    console.log("\n🏆 Ahora entiendes por qué los objetos interactúan a través")
+    console.log("de solicitudes: es la base de la comunicación segura y ordenada.")
+
+    await this.waitForEnter("\n✨ ¡Lección 2 completada! Presiona Enter para salir...")
+  }
+
+  async waitForEnter(message) {
+    return new Promise((resolve) => {
+      this.rl.question(message, () => {
+        resolve()
+      })
+    })
+  }
+}
+
+// Para usar la lección independientemente
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const lesson = new Lesson2ObjectRequests()
+  await lesson.start()
+}

package/package.json

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