@icarusmx/creta 0.5.3 → 0.6.0

package/bin/creta.js

@@ -7,6 +7,45 @@ import path from 'path'
 import { fileURLToPath } from 'url'
 import { CretaCodeSession } from '../lib/session.js'
 
+const ENUNCIADOS = [
+  {
+    id: 1,
+    texto: "La parte difícil del diseño orientado a objetos es descomponer un sistema como un conjunto de objetos que interactúan entre sí.",
+    nivel: "Fundacional",
+    enfoque: "Descomposición de sistemas"
+  },
+  {
+    id: 2,
+    texto: "Los objetos interactúan entre sí a través de solicitudes.",
+    nivel: "Interacción",
+    enfoque: "Comunicación entre objetos"
+  },
+  {
+    id: 3,
+    texto: "Las solicitudes son la única forma de conseguir que un objeto lleve a cabo una operación.",
+    nivel: "Operaciones",
+    enfoque: "Mecanismo de ejecución"
+  },
+  {
+    id: 4,
+    texto: "Cada operación declarada por un objeto debe incluir: a) nombre de la operación; b) insumos necesarios para realizar la operación; c) el valor que regresa tras ejecutar la operación. Estos tres elementos constituyen la firma de operación.",
+    nivel: "Firmas",
+    enfoque: "Contratos de operación"
+  },
+  {
+    id: 5,
+    texto: "La interfaz de un objeto es el conjunto de todas sus firmas de operación.",
+    nivel: "Interfaces",
+    enfoque: "Definición de contratos"
+  },
+  {
+    id: 6,
+    texto: "El énfasis al diseñar los objetos debe estar en la definición de sus solicitudes e interfaces.",
+    nivel: "Diseño",
+    enfoque: "Metodología de desarrollo"
+  }
+]
+
 const args = process.argv.slice(2)
 const command = args[0]
 
@@ -14,14 +53,8 @@ console.log("¡Bienvenida de vuelta! 🏛️")
 console.log("Retomemos desde donde nos quedamos: hagamos tu portafolio.\n")
 
 if (!command) {
-  console.log("Comandos disponibles:")
-  console.log("  creta portafolio    - Crea tu portafolio personal (reto completo)")
-  console.log("  creta portafolio-1  - Desbloquea nivel 1 (navbar) 🔓")
-  console.log("  creta portafolio-2  - Desbloquea nivel 2 (navbar + hero) 🔓")
-  console.log("  creta portafolio-3  - Desbloquea nivel 3 (solución completa) 🔓")
-  console.log("  creta code          - Inicia sesión interactiva de programación 🤖")
-  console.log("\n💡 Tip: Si estás dentro de un proyecto existente, los comandos")
-  console.log("    portafolio-1/2/3 actualizarán tus archivos directamente")
+  // Default behavior: show enunciados selector
+  await startEnunciadosSelector()
   process.exit(0)
 }
 
@@ -34,12 +67,19 @@ if (command.startsWith('portafolio')) {
   } else {
     await createPortfolioProject(level)
   }
+} else if (command === 'enunciados') {
+  // Start enunciados selector
+  await startEnunciadosSelector()
 } else if (command === 'code') {
   // Start interactive coding session
   const session = new CretaCodeSession()
   await session.start()
+} else if (command === 'help' || command === 'ayuda') {
+  // Show available commands
+  showHelp()
 } else {
   console.log(`Comando no reconocido: ${command}`)
+  console.log("Escribe 'creta help' para ver comandos disponibles")
   process.exit(1)
 }
 
@@ -521,3 +561,81 @@ async function unstuckProject(level) {
     process.exit(1)
   }
 }
+
+function showHelp() {
+  console.log("\n📚 Comandos disponibles:")
+  console.log("  creta                - Explora los 6 enunciados fundamentales (comando principal) 🧠")
+  console.log("  creta enunciados     - Explora los 6 enunciados fundamentales 🧠")
+  console.log("  creta portafolio     - Crea tu portafolio personal (reto completo)")
+  console.log("  creta portafolio-1   - Desbloquea nivel 1 (navbar) 🔓")
+  console.log("  creta portafolio-2   - Desbloquea nivel 2 (navbar + hero) 🔓")
+  console.log("  creta portafolio-3   - Desbloquea nivel 3 (solución completa) 🔓")
+  console.log("  creta code           - Inicia sesión interactiva de programación 🤖")
+  console.log("  creta help           - Muestra esta ayuda")
+  console.log("\n💡 Tip: Si estás dentro de un proyecto existente, los comandos")
+  console.log("    portafolio-1/2/3 actualizarán tus archivos directamente")
+  console.log("\n🎯 La filosofía Creta: partir de enunciados que generan 'ruido' para")
+  console.log("   construir comprensión real, no solo sintaxis.")
+}
+
+async function startEnunciadosSelector() {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  })
+
+  const askQuestion = (question) => {
+    return new Promise((resolve) => {
+      rl.question(question, resolve)
+    })
+  }
+
+  try {
+    console.log("\n🧠 Los 6 Enunciados Fundamentales de Programación Orientada a Objetos")
+    console.log("=" .repeat(70))
+    console.log("¿Cuál de estos enunciados te genera más 'ruido' (curiosidad/confusión)?")
+    console.log("")
+
+    ENUNCIADOS.forEach((enunciado, index) => {
+      console.log(`${index + 1}. [${enunciado.nivel}] ${enunciado.enfoque}`)
+      console.log(`   "${enunciado.texto}"`)
+      console.log("")
+    })
+
+    const respuesta = await askQuestion("Elige un número (1-6) o 'q' para salir: ")
+
+    if (respuesta.toLowerCase() === 'q') {
+      console.log("¡Hasta la vista! 👋")
+      rl.close()
+      return
+    }
+
+    const numeroSeleccionado = parseInt(respuesta)
+
+    if (numeroSeleccionado >= 1 && numeroSeleccionado <= 6) {
+      const enunciadoSeleccionado = ENUNCIADOS[numeroSeleccionado - 1]
+
+      console.log(`\n🎯 Has seleccionado el enunciado ${numeroSeleccionado}:`)
+      console.log(`"${enunciadoSeleccionado.texto}"`)
+      console.log(`\n💡 Enfoque: ${enunciadoSeleccionado.enfoque}`)
+      console.log(`📚 Nivel: ${enunciadoSeleccionado.nivel}`)
+
+      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")
+
+      console.log("\n💭 Por ahora, reflexiona: ¿qué parte específica de este enunciado")
+      console.log("   te genera más curiosidad o confusión?")
+
+    } else {
+      console.log("❌ Opción no válida. Elige un número entre 1 y 6.")
+    }
+
+    rl.close()
+  } catch (error) {
+    console.error('Error:', error.message)
+    rl.close()
+    process.exit(1)
+  }
+}

package/package.json

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

package/CLAUDE.md

@@ -1,118 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-This is "@icarusmx/creta" - a CLI tool for the Icarus software school that helps reconnect with former students by providing them with guided challenges to build personal portfolios. The tool generates SvelteKit 5 + Tailwind CSS 4 boilerplates with instructional comments in Spanish.
-
-## Purpose and Mission
-
-Creta is a Spanish-speaking software school focused on learn-by-building approach. This CLI tool serves as a reconnection mechanism with former students, encouraging them to complete their education by building personal websites. The tool provides progressive difficulty levels where students can skip ahead or get solutions for different components.
-
-## Architecture
-
-- **Entry point**: `bin/creta.js` - Interactive Node.js CLI that collects student names and generates projects
-- **Package**: Published as `@icarusmx/creta` on npm with public access (current version: 0.2.2)
-- **Language**: JavaScript ES modules (no TypeScript)
-- **Templates**: SvelteKit 5 + Tailwind CSS 4 portfolio boilerplate in `/templates/sveltekit-portfolio/`
-
-## Available Commands
-
-- `creta portafolio` - Full challenge with instructional comments (level 0)
-- `creta portafolio-1` - Navbar completed (level 1) 
-- `creta portafolio-2` - Navbar + hero completed (level 2)
-- `creta portafolio-3` - Complete solution (level 3)
-
-## Technology Stack
-
-### Frontend Template
-- **SvelteKit 5**: Using new syntax with `{@render children?.()}` instead of `<slot />`
-- **Tailwind CSS 4**: Using `@tailwindcss/vite` plugin (no config files needed)
-- **Vite**: Build tool and dev server
-
-### Template Structure
-```
-templates/sveltekit-portfolio/
-├── package.json           # SvelteKit 5 + Tailwind 4 dependencies
-├── vite.config.js        # Vite config with Tailwind plugin
-├── svelte.config.js      # SvelteKit configuration
-├── src/
-│   ├── app.html         # HTML template
-│   ├── app.css          # Tailwind directives
-│   └── routes/
-│       ├── +layout.svelte # Layout with navbar/footer challenges
-│       └── +page.svelte   # Hero section challenge
-└── static/
-    └── favicon.png
-```
-
-## Key Features
-
-### Interactive Project Generation
-- Prompts for student name using readline interface
-- Generates project directory named `{name}-portafolio`
-- Replaces `{{STUDENT_NAME}}` and `{{PROJECT_NAME}}` placeholders
-- Copies template files with level-specific modifications
-
-### Progressive Difficulty System
-The `applyLevelModifications()` function provides solutions based on level:
-- **Level 1+**: Complete navbar with navigation links
-- **Level 2+**: Complete hero section with student's name
-- **Level 3+**: Complete footer with copyright and Creta attribution
-
-### Spanish Instructional Design
-- All comments and instructions in Spanish
-- Detailed Tailwind CSS patterns and tips
-- Encouraging messages for returning students
-- HTML structure examples in code blocks (using `[placeholders]` to avoid parsing issues)
-
-## Development Commands
-
-```bash
-# Test CLI locally
-node bin/creta.js
-
-# Test specific commands
-node bin/creta.js portafolio
-node bin/creta.js portafolio-1
-
-# Publish to npm (increment version first)
-npm publish
-```
-
-## Current State (v0.2.2)
-
-The CLI is fully functional with:
-- ✅ Interactive name collection
-- ✅ SvelteKit 5 + Tailwind 4 template generation
-- ✅ Progressive difficulty levels (0-3)
-- ✅ Spanish instructional comments
-- ✅ Proper Svelte 5 syntax (`{@render children?.()}`)
-- ✅ HTML parsing issue fixes
-- ✅ Encouraging welcome message for returning students
-
-## Recent Fixes and Updates
-
-### Version History
-- **0.2.2**: Fixed Svelte 5 syntax and updated welcome message
-- **0.2.1**: Fixed HTML comment parsing errors in Svelte templates
-- **0.2.0**: Updated to Tailwind 4, changed command to "portafolio", new greeting
-- **0.1.1**: Fixed template path resolution for global installs
-- **0.1.0**: Initial working version with template generation
-- **0.0.2**: Basic CLI structure
-
-### Known Issues Resolved
-- ✅ HTML comments in code examples causing Svelte parsing errors (fixed by using `[placeholders]`)
-- ✅ Svelte 5 syntax compatibility (`<slot />` → `{@render children?.()}`)
-- ✅ Tailwind 4 migration (removed config files, updated to Vite plugin)
-- ✅ Template path resolution for global npm installs
-
-## Message and Tone
-
-The CLI uses encouraging Spanish messages:
-- Welcome: "¡Bienvenido de vuelta! 🏛️"
-- Mission: "Retomemos desde donde nos quedamos: hagamos tu portafolio."
-- Hero message: "Gracias por seguir aquí. Abre el proyecto usando `code .` y sigue las instrucciones. Si tienes dudas, apóyate en el equipo"
-
-This reflects Creta's supportive approach to bringing students back to complete their learning journey.