@icarusmx/creta 1.4.8 → 1.4.10

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

@@ -4,11 +4,26 @@ export const GIT_BASICO = {
 
   intro: {
     definition: 'Git es un sistema de registro y control de versiones que te permite gestionar los distintos estados de un proyecto a lo largo de su desarrollo.',
-    explanation: 'Imagina un álbum de fotos: cada commit es una foto de todos tus archivos en un momento específico.',
-    detail: 'Con Git puedes hojear el álbum completo, volver a cualquier foto anterior, o tomar nuevas fotos conforme avanzas. Esto te permite experimentar sin miedo porque siempre puedes regresar.'
+    explanation: 'Un proyecto es un conjunto de archivos. Un estado del proyecto es un arreglo específico de esos archivos: qué contiene cada uno, cuáles existen, cuáles no.',
+    detail: 'Git guarda estos estados como si fueran fotos en un álbum: cada foto es una captura del estado del proyecto en un momento específico.'
   },
 
   steps: [
+    {
+      type: 'text',
+      text: 'Cada registro de esto es un commit.'
+    },
+    {
+      type: 'text',
+      text: 'Un commit es un objeto que contiene los cambios realizados, quién los hizo, cuándo y por qué.'
+    },
+    {
+      type: 'text',
+      text: 'Al final del día, Git es una cadena de commits (commit chain): cada uno apunta al anterior, formando la historia completa de tu proyecto.'
+    },
+    {
+      type: 'pause'
+    },
     {
       type: 'command-intro',
       command: 'git init',

package/lib/data/lessons/sintaxis/piping-redireccion.js

@@ -9,11 +9,89 @@ export const PIPING_REDIRECCION = {
   },
 
   steps: [
+    {
+      type: 'text',
+      content: 'Primero, entendamos los 3 canales de comunicación que tiene cada programa.'
+    },
+    {
+      type: 'pause'
+    },
+    {
+      type: 'text',
+      content: 'Cada comando que ejecutas tiene 3 "streams" (flujos) estándar:'
+    },
+    {
+      type: 'text',
+      content: '• stdin (standard input) - Canal 0: Por donde entra información'
+    },
+    {
+      type: 'text',
+      content: '• stdout (standard output) - Canal 1: Por donde sale información normal'
+    },
+    {
+      type: 'text',
+      content: '• stderr (standard error) - Canal 2: Por donde salen mensajes de error'
+    },
+    {
+      type: 'pause'
+    },
+    {
+      type: 'text',
+      content: 'Por defecto:'
+    },
+    {
+      type: 'text',
+      content: '• stdin lee del teclado'
+    },
+    {
+      type: 'text',
+      content: '• stdout y stderr escriben a la pantalla'
+    },
+    {
+      type: 'pause'
+    },
+    {
+      type: 'text',
+      content: 'Pero con piping y redirección puedes cambiar estos destinos.'
+    },
+    {
+      type: 'pause'
+    },
+    {
+      type: 'code',
+      title: 'Los 3 streams en acción',
+      code: `# ls produce salida normal (stdout)
+ls archivo.txt
+# → archivo.txt (aparece en pantalla)
+
+# ls con archivo inexistente produce error (stderr)
+ls archivo-que-no-existe
+# → ls: archivo-que-no-existe: No such file or directory (aparece en pantalla)
+
+# read espera entrada (stdin)
+read NOMBRE
+# → [cursor esperando que escribas]`,
+      after: [
+        '',
+        'Aunque ambos aparecen en pantalla, stdout y stderr son canales separados.',
+        'Esto te permite tratarlos diferente con redirección.'
+      ]
+    },
+    {
+      type: 'pause'
+    },
+    {
+      type: 'text',
+      content: 'Ahora veamos cómo manipular estos streams.'
+    },
+    {
+      type: 'pause'
+    },
     {
       type: 'command-intro',
       command: '|',
       description: 'El pipe (tubería)',
-      explanation: 'El símbolo | toma la salida de un comando y la envía como entrada a otro.',
+      explanation: 'El símbolo | conecta el stdout de un comando al stdin de otro.',
       example: 'ls | grep ".js"\ncat archivo.txt | wc -l',
       instruction: 'Úsalo para encadenar comandos. La salida del izquierdo entra al derecho.'
     },
@@ -68,19 +146,56 @@ export const PIPING_REDIRECCION = {
     {
       type: 'command-intro',
       command: '2>',
-      description: 'Redirección de errores',
-      explanation: '2> redirige los mensajes de error (stderr) a un archivo.',
+      description: 'Redirección de errores (stderr)',
+      explanation: 'El 2 se refiere al file descriptor de stderr. 2> redirige solo los errores a un archivo.',
       example: 'npm install 2> errores.log\nls archivo-que-no-existe 2> /dev/null',
       instruction: '/dev/null es como un "agujero negro" - descarta todo lo que le envíes.'
     },
+    {
+      type: 'text',
+      content: 'También puedes redirigir stdout explícitamente con 1> (aunque > solo es equivalente).'
+    },
+    {
+      type: 'pause'
+    },
     {
       type: 'command-intro',
       command: '&>',
-      description: 'Redirección de salida Y errores',
-      explanation: '&> redirige tanto la salida normal como los errores al mismo destino.',
+      description: 'Redirección de stdout Y stderr',
+      explanation: '&> redirige ambos canales (1 y 2) al mismo destino. Es como hacer 1> archivo 2>&1',
       example: 'npm install &> install-log.txt\ngit pull &> pull.log',
       instruction: 'Útil cuando quieres capturar todo lo que un comando produce.'
     },
+    {
+      type: 'pause'
+    },
+    {
+      type: 'code',
+      title: 'Standard streams en acción',
+      code: `# Separar stdout y stderr en diferentes archivos
+ls archivo.txt archivo-inexistente 1> salidas.txt 2> errores.txt
+# → archivo.txt va a salidas.txt
+# → el error va a errores.txt
+
+# Guardar salida, descartar errores
+npm install 1> install.log 2> /dev/null
+
+# Redirigir stderr a stdout, luego todo a un archivo
+ls archivo-inexistente 2>&1 | grep "No such"
+# → El error se convierte en stdout y puede ser procesado por grep
+
+# Capturar todo en un solo archivo (equivalentes)
+comando &> todo.log
+comando > todo.log 2>&1`,
+      after: [
+        '',
+        'Entender los file descriptors (0, 1, 2) te da control total del flujo de datos.',
+        'Puedes separar, combinar, o descartar cualquier stream según necesites.'
+      ]
+    },
+    {
+      type: 'pause'
+    },
     {
       type: 'code',
       title: 'Ejemplo real: Procesando una versión',

package/package.json

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

package/.claude/settings.local.json

@@ -1,16 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Read(//private/tmp/**)",
-      "Bash(node:*)",
-      "WebFetch(domain:github.com)",
-      "Bash(npm install)",
-      "Bash(npm run dev:*)",
-      "Bash(rm:*)",
-      "Bash(npm publish:*)",
-      "Bash(npm view:*)"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}

package/deploy-patch.sh

@@ -1,30 +0,0 @@
-#!/bin/bash
-
-# Get current version from package.json
-CURRENT_VERSION=$(node -p "require('./package.json').version")
-
-# Split version into parts
-IFS='.' read -r -a VERSION_PARTS <<< "$CURRENT_VERSION"
-MAJOR="${VERSION_PARTS[0]}"
-MINOR="${VERSION_PARTS[1]}"
-PATCH="${VERSION_PARTS[2]}"
-
-# Increment patch
-NEW_PATCH=$((PATCH + 1))
-NEW_VERSION="$MAJOR.$MINOR.$NEW_PATCH"
-
-echo "📦 Bumping version: $CURRENT_VERSION → $NEW_VERSION"
-
-# Update package.json
-sed -i '' "s/\"version\": \"$CURRENT_VERSION\"/\"version\": \"$NEW_VERSION\"/" package.json
-
-echo "🚀 Publishing to npm..."
-npm publish
-
-if [ $? -eq 0 ]; then
-    echo "✅ Successfully published @icarusmx/creta@$NEW_VERSION"
-else
-    echo "❌ Publish failed, reverting version..."
-    sed -i '' "s/\"version\": \"$NEW_VERSION\"/\"version\": \"$CURRENT_VERSION\"/" package.json
-    exit 1
-fi