@icarusmx/creta 1.5.4 → 1.5.7

package/refactor.txt

@@ -1,581 +0,0 @@
-# CRETA CLI - REFACTORING STRATEGY v2.0
-# Data-Driven Architecture (Discord-Inspired)
-# bin/creta.js = 1616 líneas → Target: <100 líneas entry point
-
-## 🚨 PROBLEMA ACTUAL
-
-bin/creta.js ha crecido a 1616 líneas con **text y logic acoplados**:
-- Hardcoded messages mezclados con execution logic
-- Lessons con 280+ líneas de text + code
-- Difícil traducir a otros idiomas
-- Imposible reutilizar lesson logic
-- No hay separación clara data vs behavior
-
-## 💡 INSIGHT CLAVE (Discord API Pattern)
-
-```js
-// Discord approach: Data + Builder
-const embed = new EmbedBuilder()
-  .setTitle('Title here')
-  .setDescription('Description here')
-  .addFields({ name: 'Field', value: 'Value' })
-
-// Creta equivalent:
-const lesson = new LessonBuilder(TERMINAL_BASICO_DATA)
-  .withIntro()
-  .withSteps()
-  .start()
-```
-
-**Principio:** Separar QUÉ (data) de CÓMO (execution)
-
-## 🎯 OBJETIVO
-
-**Data-Driven Architecture:**
-- **Data:** Constants (text, config, lesson content) - easy to modify
-- **Builders:** Execution engines (lesson-builder, menu-builder) - reusable
-- **Orchestrators:** Coordinan builders con data - simple routing
-
-## 📁 NUEVA ESTRUCTURA
-
-```
-cli/
-├── bin/
-│   └── creta.js                    # <100 líneas - Pure orchestration
-│
-├── lib/
-│   ├── data/                       # 📝 ALL CONTENT HERE
-│   │   ├── enunciados.js          # ENUNCIADOS array
-│   │   ├── messages.js            # UI messages, help text
-│   │   ├── lessons/               # Lesson content (data only)
-│   │   │   ├── lesson1-data.js   # Sistema - text only
-│   │   │   ├── lesson2-data.js   # Solicitudes - text only
-│   │   │   ├── lesson7-data.js   # Definición - text only
-│   │   │   └── sintaxis/
-│   │   │       ├── terminal-basico.js
-│   │   │       ├── git-basico.js
-│   │   │       ├── git-colaboracion.js
-│   │   │       └── git-avanzado.js
-│   │   └── menus.js               # Menu configurations
-│   │
-│   ├── builders/                   # 🏗️ EXECUTION ENGINES
-│   │   ├── LessonBuilder.js       # Executes lesson data
-│   │   ├── MenuBuilder.js         # Renders menus from config
-│   │   ├── ProjectBuilder.js      # Creates projects from templates
-│   │   └── InteractiveBuilder.js  # Handles interactive flows
-│   │
-│   ├── executors/                  # 🎮 ORCHESTRATORS
-│   │   ├── enunciados-executor.js # Lesson selector + executor
-│   │   ├── sintaxis-executor.js   # Sintaxis lesson flow
-│   │   ├── proyectos-executor.js  # Project creation flow
-│   │   └── portfolio-executor.js  # Portfolio level flow
-│   │
-│   ├── templates/                  # 📋 TEMPLATE OPERATIONS
-│   │   ├── TemplateProcessor.js   # Copy & process templates
-│   │   ├── LevelModifier.js       # Apply level modifications
-│   │   └── PlaceholderReplacer.js # Replace {{VARIABLES}}
-│   │
-│   ├── utils/                      # 🔧 UTILITIES
-│   │   ├── input.js              # readline helpers
-│   │   ├── output.js             # console formatting
-│   │   ├── file-utils.js         # fs operations
-│   │   └── validators.js         # input validation
-│   │
-│   ├── session.js                  # Existing - no changes
-│   └── pr-tutorial.js              # Existing - no changes
-│
-├── lessons/                         # ❌ TO BE REMOVED
-│   └── lesson*.js                  # Migrate to data/ + LessonBuilder
-│
-└── templates/                       # ✅ KEEP AS IS
-```
-
-## 🏗️ CORE ARCHITECTURE PATTERNS
-
-### Pattern 1: Data Objects (Discord-style)
-
-```js
-// lib/data/lessons/sintaxis/terminal-basico.js
-export const TERMINAL_BASICO = {
-  id: 'terminal-basico',
-  title: 'Terminal Básico',
-
-  intro: {
-    definition: 'Sintaxis: estudia el modo en que se combinan las palabras...',
-    explanation: 'En esta sección aprenderemos algo más que palabras, aprenderemos comandos.',
-    detail: 'Al final del día un comando es una palabra, la diferencia es que está dotada de un significado que tu computadora entiende.'
-  },
-
-  steps: [
-    {
-      type: 'command',
-      command: 'ls',
-      description: 'Este es tu primer comando: ls',
-      instruction: 'Presiona ctrl + c para terminar esta sesión y después ejecuta el comando ls en tu terminal',
-      exitOnComplete: true
-    },
-    {
-      type: 'command',
-      command: 'pwd',
-      description: '¿Dónde estás? Usa pwd para descubrirlo',
-      expectedOutput: (output) => output.includes('/'),
-      onSuccess: '¡Correcto! Ahora sabes tu ubicación actual.'
-    },
-    {
-      type: 'interactive-challenge',
-      prompt: '¿Qué comando usarías para crear un directorio?',
-      answer: 'mkdir',
-      hint: 'Piensa en "make directory"',
-      onSuccess: '¡Exacto! mkdir crea directorios.'
-    }
-  ]
-}
-```
-
-### Pattern 2: Builders (Execution Logic)
-
-```js
-// lib/builders/LessonBuilder.js
-export class LessonBuilder {
-  constructor(lessonData) {
-    this.data = lessonData
-  }
-
-  async start() {
-    await this.showIntro()
-    await this.executeSteps()
-  }
-
-  async showIntro() {
-    console.log(this.data.intro.definition)
-    await this.waitForEnter()
-
-    if (this.data.intro.explanation) {
-      console.log(`\n${this.data.intro.explanation}`)
-      if (this.data.intro.detail) {
-        console.log(`\n${this.data.intro.detail}`)
-      }
-    }
-  }
-
-  async executeSteps() {
-    for (const step of this.data.steps) {
-      await this.executeStep(step)
-    }
-  }
-
-  async executeStep(step) {
-    switch(step.type) {
-      case 'command':
-        await this.showCommand(step)
-        break
-      case 'interactive-challenge':
-        await this.runChallenge(step)
-        break
-      case 'explanation':
-        await this.showExplanation(step)
-        break
-    }
-  }
-
-  async showCommand(step) {
-    console.log(`\n${step.description}`)
-    console.log(`\n${step.instruction}`)
-    if (step.exitOnComplete) {
-      // Don't wait, let them exit
-      return
-    }
-  }
-
-  async runChallenge(step) {
-    const rl = createPromptInterface()
-    const answer = await askQuestion(rl, `\n${step.prompt}: `)
-
-    if (answer.toLowerCase() === step.answer.toLowerCase()) {
-      console.log(`\n✅ ${step.onSuccess}`)
-    } else {
-      console.log(`\n💡 Hint: ${step.hint}`)
-    }
-    rl.close()
-  }
-
-  async waitForEnter() {
-    const rl = createPromptInterface()
-    await new Promise(resolve => {
-      rl.question('\nPresiona Enter para comenzar...', () => {
-        rl.close()
-        resolve()
-      })
-    })
-  }
-}
-```
-
-### Pattern 3: Executors (Orchestration)
-
-```js
-// lib/executors/sintaxis-executor.js
-import { TERMINAL_BASICO } from '../data/lessons/sintaxis/terminal-basico.js'
-import { GIT_BASICO } from '../data/lessons/sintaxis/git-basico.js'
-import { LessonBuilder } from '../builders/LessonBuilder.js'
-import { MenuBuilder } from '../builders/MenuBuilder.js'
-
-export async function executeSintaxis() {
-  // Step 1: Show lesson menu
-  const menuConfig = {
-    title: 'Aprender Sintaxis',
-    options: [
-      { id: 1, title: 'Terminal básico', data: TERMINAL_BASICO },
-      { id: 2, title: 'Git básico', data: GIT_BASICO },
-      // ...
-    ]
-  }
-
-  const menu = new MenuBuilder(menuConfig)
-  const selected = await menu.show()
-
-  // Step 2: Execute selected lesson
-  if (selected) {
-    const lesson = new LessonBuilder(selected.data)
-    await lesson.start()
-  }
-}
-```
-
-### Pattern 4: Minimal Entry Point
-
-```js
-// bin/creta.js (<100 lines)
-import { executeEnunciados } from '../lib/executors/enunciados-executor.js'
-import { executeSintaxis } from '../lib/executors/sintaxis-executor.js'
-import { executeProyectos } from '../lib/executors/proyectos-executor.js'
-import { showHelp } from '../lib/commands/help.js'
-import { WELCOME_BANNER } from '../lib/data/messages.js'
-
-console.log(WELCOME_BANNER)
-
-const args = process.argv.slice(2)
-const command = args[0]
-
-if (!command) {
-  const mainMenu = new MenuBuilder(MAIN_MENU_CONFIG)
-  const choice = await mainMenu.show()
-
-  switch(choice.id) {
-    case 1: await executeSintaxis(); break
-    case 2: await executeEnunciados(); break
-    case 3: await executeProyectos(); break
-  }
-  process.exit(0)
-}
-
-// Route commands
-const commands = {
-  'enunciados': executeEnunciados,
-  'portafolio': executePortfolio,
-  'help': showHelp
-}
-
-const handler = commands[command]
-if (handler) {
-  await handler(args)
-} else {
-  console.log(`Comando no reconocido: ${command}`)
-  process.exit(1)
-}
-```
-
-## 🔨 REFACTORING PHASES (Data-Driven)
-
-### PHASE 1: Create Data Layer (Zero Risk)
-**Goal:** Extract ALL content to data files
-
-1. **Create lib/data/enunciados.js**
-   - Move ENUNCIADOS array
-
-2. **Create lib/data/messages.js**
-   - WELCOME_BANNER
-   - HELP_TEXT
-   - All user-facing strings
-
-3. **Create lib/data/menus.js**
-   - MAIN_MENU_CONFIG
-   - ENUNCIADOS_MENU_CONFIG
-   - PROYECTOS_MENU_CONFIG
-
-4. **Create lib/data/lessons/lesson1-data.js → lesson7-data.js**
-   - Extract all text from lesson files
-   - Convert to data objects
-   ```js
-   export const LESSON_1_SISTEMA = {
-     enunciado: { id: 1, texto: '...', nivel: '...' },
-     intro: { ... },
-     challenges: [ ... ],
-     examples: [ ... ]
-   }
-   ```
-
-**Result:** All content centralized, easy to translate
-
-### PHASE 2: Create Builders (Low Risk)
-**Goal:** Reusable execution engines
-
-1. **Create lib/builders/LessonBuilder.js**
-   - Takes lesson data object
-   - Executes intro, steps, challenges
-   - ~150 lines
-
-2. **Create lib/builders/MenuBuilder.js**
-   - Takes menu config
-   - Renders interactive/fallback
-   - Handles selection
-   - ~120 lines
-
-3. **Create lib/builders/ProjectBuilder.js**
-   - Takes template config
-   - Creates/updates projects
-   - ~100 lines
-
-4. **Create lib/builders/InteractiveBuilder.js**
-   - Reusable interactive patterns
-   - Arrow keys, prompts, etc.
-   - ~80 lines
-
-**Result:** Reusable builders for all flows
-
-### PHASE 3: Create Template System (Medium Risk)
-**Goal:** Clean template operations
-
-1. **Create lib/templates/TemplateProcessor.js**
-   - Copy templates
-   - Binary file handling
-   - ~80 lines
-
-2. **Create lib/templates/LevelModifier.js**
-   - applyLevelModifications logic
-   - Layout/page modifications
-   - ~150 lines
-
-3. **Create lib/templates/PlaceholderReplacer.js**
-   - Replace {{VARIABLES}}
-   - Template string processing
-   - ~40 lines
-
-**Result:** Template operations modular
-
-### PHASE 4: Create Executors (Medium Risk)
-**Goal:** Orchestrate builders + data
-
-1. **Create lib/executors/enunciados-executor.js**
-   - Load lesson data
-   - Use MenuBuilder for selection
-   - Use LessonBuilder for execution
-   - ~80 lines
-
-2. **Create lib/executors/sintaxis-executor.js**
-   - Load sintaxis lessons
-   - Menu + execution flow
-   - ~60 lines
-
-3. **Create lib/executors/proyectos-executor.js**
-   - PR tutorial + portfolio
-   - Use ProjectBuilder
-   - ~80 lines
-
-4. **Create lib/executors/portfolio-executor.js**
-   - Level selection + creation
-   - ~60 lines
-
-**Result:** Clean orchestration layer
-
-### PHASE 5: Refactor Entry Point (Low Risk)
-**Goal:** Minimal bin/creta.js
-
-1. **Simplify bin/creta.js**
-   - Import executors
-   - Route commands
-   - Handle errors
-   - **Target: <100 lines**
-
-**Result:** Clean entry point
-
-### PHASE 6: Migrate Existing Lessons (High Impact)
-**Goal:** Replace lessons/* with data + LessonBuilder
-
-1. **For each lesson1-7:**
-   - Extract to data/lessons/lesson{N}-data.js
-   - Test with LessonBuilder
-   - Remove old lesson file
-
-2. **Update imports in executors**
-
-**Result:** All lessons use LessonBuilder
-
-### PHASE 7: Create Utils (Low Risk)
-**Goal:** Shared utilities
-
-1. **Create lib/utils/input.js**
-   - readline helpers
-   - ~40 lines
-
-2. **Create lib/utils/output.js**
-   - formatting, colors
-   - ~40 lines
-
-3. **Create lib/utils/file-utils.js**
-   - fs operations
-   - ~50 lines
-
-**Result:** Clean utility layer
-
-## 📊 EXPECTED RESULTS
-
-**Before:**
-- bin/creta.js: 1616 lines (mixed concerns)
-- lessons/: 7 files × ~200 lines = 1400 lines (text + logic)
-
-**After:**
-- bin/creta.js: <100 lines (pure routing)
-- lib/data/: ~1200 lines (content only, easy to translate)
-- lib/builders/: ~450 lines (4 reusable engines)
-- lib/executors/: ~280 lines (4 orchestrators)
-- lib/templates/: ~270 lines (3 template modules)
-- lib/utils/: ~130 lines (3 utilities)
-
-**Total:** ~2430 lines in 25+ focused modules
-**Key win:** Content separated from logic, reusable builders
-
-## 🎯 BENEFITS
-
-### For Content:
-✅ Easy to translate (just swap data files)
-✅ Non-developers can edit lessons
-✅ Version control friendly (small diffs)
-✅ A/B test different lesson flows
-
-### For Code:
-✅ Reusable builders for all lessons
-✅ Test builders once, works for all content
-✅ Add new lesson = just add data file
-✅ DRY - no repeated execution logic
-
-### For Maintenance:
-✅ Clear separation of concerns
-✅ Easy to find and fix bugs
-✅ Simple to add features
-✅ Refactor-friendly architecture
-
-## 🚀 EXECUTION STRATEGY
-
-### Approach: "Discord Pattern Migration"
-1. Create data structure for one lesson
-2. Create builder that executes it
-3. Verify it works identically
-4. Migrate next lesson
-5. Remove old code
-6. Repeat
-
-### Testing Each Phase:
-```bash
-# Test lesson with new builder
-node -e "
-import { LESSON_1_SISTEMA } from './lib/data/lessons/lesson1-data.js'
-import { LessonBuilder } from './lib/builders/LessonBuilder.js'
-const lesson = new LessonBuilder(LESSON_1_SISTEMA)
-await lesson.start()
-"
-
-# Test full flow
-node bin/creta.js enunciados
-node bin/creta.js portafolio
-```
-
-### Git Strategy:
-- Commit after each phase
-- Keep old code until new is tested
-- Easy rollback
-- Tag stable versions
-
-### Priority Order:
-1. Phase 1 (data layer) - Foundation
-2. Phase 2 (builders) - Core engines
-3. Phase 7 (utils) - Supporting tools
-4. Phase 4 (executors) - Orchestration
-5. Phase 3 (templates) - Template system
-6. Phase 5 (entry point) - Simplification
-7. Phase 6 (migrate lessons) - Final migration
-
-## 📝 ARCHITECTURAL PRINCIPLES
-
-### Data-Driven Design:
-1. **Data is King:** All content in data/
-2. **Builders Execute:** Logic in builders/
-3. **Executors Orchestrate:** Flow in executors/
-4. **Entry Routes:** bin/creta.js just routes
-
-### Simple Solutions:
-- No over-engineering
-- JavaScript objects (not complex schemas)
-- Readable, not clever
-- Maintainable over perfect
-
-### Discord-Inspired Patterns:
-```js
-// Instead of:
-class Lesson7 {
-  async start() {
-    console.log("hardcoded text...")
-    // logic
-  }
-}
-
-// Do this:
-const LESSON_7 = {
-  intro: { text: "..." },
-  steps: [...]
-}
-const lesson = new LessonBuilder(LESSON_7)
-await lesson.start()
-```
-
-## ✅ SUCCESS CRITERIA
-
-Refactoring complete when:
-1. ✅ bin/creta.js < 100 lines
-2. ✅ All content in lib/data/
-3. ✅ All lessons use LessonBuilder
-4. ✅ MenuBuilder handles all menus
-5. ✅ No text hardcoded in logic
-6. ✅ All existing commands work
-7. ✅ Easy to add new lessons (just add data)
-8. ✅ Easy to translate (just swap data files)
-
-## 🎯 LONG-TERM WINS
-
-### Easy Internationalization:
-```js
-// lib/data/lessons/en/lesson1-data.js
-// lib/data/lessons/es/lesson1-data.js
-// Just swap import based on locale
-```
-
-### CMS-Ready:
-- Data files could come from database
-- Non-technical content updates
-- A/B testing different lesson flows
-
-### Extensible:
-- New lesson types? Add to builder
-- New step types? Extend executeStep()
-- New templates? Add to ProjectBuilder
-
----
-
-**Philosophy:** "Text tells the story, builders bring it to life"
-
-**Start Date:** TBD
-**Target Completion:** 2-3 days (phased)
-**Estimated Effort:** 12-16 hours
-**Risk Level:** Low-Medium (data migration is safe, builders are reusable)
-
-Last updated: 2025-10-03

package/templates/sveltekit-portfolio/package.json

@@ -1,20 +0,0 @@
-{
-  "name": "{{PROJECT_NAME}}",
-  "version": "0.0.1",
-  "private": true,
-  "scripts": {
-    "build": "vite build",
-    "dev": "vite dev",
-    "preview": "vite preview"
-  },
-  "devDependencies": {
-    "@sveltejs/adapter-auto": "^3.0.0",
-    "@sveltejs/kit": "^2.0.0",
-    "@sveltejs/vite-plugin-svelte": "^4.0.0",
-    "svelte": "^5.0.0",
-    "tailwindcss": "^4.0.0",
-    "@tailwindcss/vite": "^4.0.0",
-    "vite": "^5.0.3"
-  },
-  "type": "module"
-}

package/templates/sveltekit-portfolio/src/app.css

@@ -1,51 +0,0 @@
-@import "tailwindcss";
-
-/* Animaciones personalizadas */
-@keyframes fade-in {
-  from {
-    opacity: 0;
-    transform: translateY(20px);
-  }
-  to {
-    opacity: 1;
-    transform: translateY(0);
-  }
-}
-
-.animate-fade-in {
-  animation: fade-in 1s ease-out;
-}
-
-/* Mejoras de scroll suave */
-html {
-  scroll-behavior: smooth;
-}
-
-/* Estilos personalizados para el código */
-code {
-  font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
-}
-
-/* Hover effects para las tarjetas de proyectos */
-.project-card {
-  transition: transform 0.2s ease-in-out;
-}
-
-.project-card:hover {
-  transform: translateY(-5px);
-}
-
-/* Efectos de focus mejorados */
-input:focus,
-textarea:focus {
-  outline: none;
-  box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
-}
-
-/* Gradientes personalizados */
-.gradient-text {
-  background: linear-gradient(45deg, #3b82f6, #8b5cf6);
-  -webkit-background-clip: text;
-  -webkit-text-fill-color: transparent;
-  background-clip: text;
-}

package/templates/sveltekit-portfolio/src/app.html

@@ -1,12 +0,0 @@
-<!doctype html>
-<html lang="es">
-	<head>
-		<meta charset="utf-8" />
-		<link rel="icon" href="%sveltekit.assets%/favicon.png" />
-		<meta name="viewport" content="width=device-width, initial-scale=1" />
-		%sveltekit.head%
-	</head>
-	<body data-sveltekit-preload-data="hover" class="antialiased">
-		<div style="display: contents">%sveltekit.body%</div>
-	</body>
-</html>