@icarusmx/creta 1.4.17 → 1.4.19

package/lib/cli/index.js

@@ -8,6 +8,7 @@ import { showHelp } from '../commands/help.js'
 import { CretaCodeSession } from '../session.js'
 import { greetUser } from '../utils/greeting.js'
 import { SandboxManager } from '../sandbox/SandboxManager.js'
+import TerminalCustomizer from '../customizers/TerminalCustomizer.js'
 
 async function executeMainMenu() {
   const menu = new MenuBuilder(getMainMenuConfig())
@@ -40,6 +41,16 @@ async function resetUserState() {
   console.log('✅ Estado de usuario reiniciado. La próxima vez que ejecutes creta, se te pedirá tu nombre de nuevo.')
 }
 
+async function customizeTerminal() {
+  const customizer = new TerminalCustomizer()
+  await customizer.customize()
+}
+
+async function revertTerminal() {
+  const customizer = new TerminalCustomizer()
+  await customizer.revert()
+}
+
 const COMMANDS = new Map([
   ['enunciados', () => executeEnunciados()],
   ['sintaxis', () => executeSintaxis()],
@@ -47,6 +58,8 @@ const COMMANDS = new Map([
   ['portafolio', () => executePortfolio(0)],
   ['code', () => runCodeSession()],
   ['reset', () => resetUserState()],
+  ['icarus-terminal', () => customizeTerminal()],
+  ['revert-terminal', () => revertTerminal()],
   ['help', () => showHelp()],
   ['ayuda', () => showHelp()]
 ])

package/lib/customizers/TerminalCustomizer.js

@@ -0,0 +1,275 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { execSync } from 'child_process';
+import { UserState } from '../utils/user-state.js';
+
+class TerminalCustomizer {
+  constructor() {
+    this.homeDir = os.homedir();
+    this.zshrcPath = path.join(this.homeDir, '.zshrc');
+    this.icarusZshPath = path.join(this.homeDir, '.icarus-zsh');
+    this.tips = this.initializeTips();
+  }
+
+  initializeTips() {
+    return {
+      'terminal-basico': [
+        '💡 Usa "cd -" para volver al directorio anterior',
+        '💡 "pwd" muestra tu ubicación actual en el sistema',
+        '💡 "ls -la" muestra archivos ocultos y permisos',
+        '💡 Usa Tab para autocompletar nombres de archivos'
+      ],
+      'git-basico': [
+        '💡 Siempre usa "git status" antes de hacer commit',
+        '💡 "git log --oneline" muestra el historial compacto',
+        '💡 "git diff" te muestra los cambios antes de commit',
+        '💡 Commits frecuentes = mejor historial'
+      ],
+      'piping-redireccion': [
+        '💡 El pipe "|" conecta la salida de un comando con otro',
+        '💡 ">" sobrescribe archivos, ">>" agrega al final',
+        '💡 "grep" es tu mejor amigo para buscar en texto'
+      ],
+      'bash-scripts': [
+        '💡 Usa "chmod +x script.sh" para hacer ejecutable tu script',
+        '💡 Siempre empieza con "#!/bin/bash" en la primera línea',
+        '💡 "$?" te dice el código de salida del último comando'
+      ],
+      'portafolio': [
+        '💡 "npm run dev" para ver cambios en tiempo real',
+        '💡 Tailwind CSS usa clases utilitarias, no CSS custom',
+        '💡 Usa "md:" para breakpoints responsive en Tailwind',
+        '💡 SvelteKit recarga automáticamente al guardar cambios'
+      ],
+      'general': [
+        '💡 Lee los errores completos, suelen decirte qué hacer',
+        '💡 Google es tu amigo, pero StackOverflow más',
+        '💡 Commits pequeños y frecuentes > commits gigantes',
+        '💡 Comenta tu código como si fueras a olvidarlo mañana'
+      ]
+    };
+  }
+
+  getContextualTip() {
+    const userState = UserState.get();
+    const recentLessons = userState.lessonsCompleted.slice(-3);
+
+    // Try to get a tip from recently completed lessons
+    for (const lesson of recentLessons.reverse()) {
+      const lessonId = typeof lesson === 'object' ? lesson.id : lesson;
+      if (this.tips[lessonId] && this.tips[lessonId].length > 0) {
+        const tips = this.tips[lessonId];
+        return tips[Math.floor(Math.random() * tips.length)];
+      }
+    }
+
+    // Fallback to general tips
+    const generalTips = this.tips.general;
+    return generalTips[Math.floor(Math.random() * generalTips.length)];
+  }
+
+  async customize() {
+    console.log('\n🏛️  Configurando tu terminal Creta...\n');
+
+    try {
+      // Backup existing .zshrc if it exists
+      if (fs.existsSync(this.zshrcPath)) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const backupPath = `${this.zshrcPath}.backup.${timestamp}`;
+        fs.copyFileSync(this.zshrcPath, backupPath);
+        console.log(`✅ Backup creado: ${backupPath}`);
+      }
+
+      // Create ~/.icarus-zsh with custom configuration
+      this.createIcarusZsh();
+      console.log(`✅ Configuración creada: ${this.icarusZshPath}`);
+
+      // Add source line to .zshrc if not already present
+      this.updateZshrc();
+      console.log(`✅ Terminal configurado`);
+
+      // Apply changes instantly
+      this.applyChanges();
+
+      console.log('\n🎉 ¡Terminal Creta configurado exitosamente!');
+      console.log('💡 Reinicia tu terminal o ejecuta: source ~/.zshrc\n');
+
+    } catch (error) {
+      console.error('❌ Error al configurar el terminal:', error.message);
+      throw error;
+    }
+  }
+
+  createIcarusZsh() {
+    const tip = this.getContextualTip();
+    const roadmapHint = this.getRoadmapHint();
+
+    // Use template literal with escaped $ to prevent Node.js interpolation
+    const config = `# ========================================
+# 🏛️  Creta Terminal Configuration
+# ========================================
+
+# Custom prompt with color #007acc
+autoload -U colors && colors
+setopt PROMPT_SUBST
+
+# Prompt color codes
+CRETA_BLUE='%F{39}'
+RESET='%f'
+GIT_BRANCH_COLOR='%F{245}'  # Gray for branch
+
+# Git branch detection function
+function git_branch_name() {
+  git symbolic-ref --short HEAD 2>/dev/null || echo ""
+}
+
+function git_prompt_info() {
+  local branch=\$(git_branch_name)
+  if [[ -n "\$branch" ]]; then
+    echo " | \${branch}"
+  fi
+}
+
+# Custom prompt: [🏛️ creta | branch] ~/path $
+PROMPT="\${CRETA_BLUE}[🏛️  creta\${GIT_BRANCH_COLOR}\$(git_prompt_info)\${CRETA_BLUE}]\${RESET} %~ $ "
+
+# Welcome message function
+function creta_welcome() {
+  print ""
+  print -P "\${CRETA_BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\${RESET}"
+  print -P "\${CRETA_BLUE}   🏛️  Bienvenido a Creta Terminal\${RESET}"
+  print -P "\${CRETA_BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\${RESET}"
+  print ""
+
+  # Show contextual tip
+  echo "${tip.replace(/"/g, '\\"')}"
+
+  # Show roadmap hint if available
+  if [[ -f "roadmap.txt" ]]; then
+    local next_item=\$(grep -v "^#" roadmap.txt | head -n 1)
+    if [[ -n "\$next_item" ]]; then
+      echo ""
+      echo "📋 Siguiente en roadmap: \$next_item"
+    fi
+  fi
+
+  print ""
+}
+
+# Show welcome message
+creta_welcome
+`;
+
+    fs.writeFileSync(this.icarusZshPath, config, 'utf8');
+  }
+
+  getRoadmapHint() {
+    // This is a placeholder - actual parsing happens in the shell script
+    // We could potentially read roadmap.txt here if we want to customize the message
+    return null;
+  }
+
+  updateZshrc() {
+    const sourceLine = '\n# Source Creta terminal configuration\n[ -f ~/.icarus-zsh ] && source ~/.icarus-zsh\n';
+
+    // Create .zshrc if it doesn't exist
+    if (!fs.existsSync(this.zshrcPath)) {
+      fs.writeFileSync(this.zshrcPath, sourceLine, 'utf8');
+      return;
+    }
+
+    // Check if already sourced
+    const currentContent = fs.readFileSync(this.zshrcPath, 'utf8');
+    if (currentContent.includes('source ~/.icarus-zsh') || currentContent.includes('. ~/.icarus-zsh')) {
+      console.log('⚠️  Creta ya estaba configurado en .zshrc (actualizando)');
+      return;
+    }
+
+    // Append source line
+    fs.appendFileSync(this.zshrcPath, sourceLine, 'utf8');
+  }
+
+  applyChanges() {
+    try {
+      // Note: This won't change the current terminal session's prompt,
+      // but it will be applied in new sessions
+      execSync('source ~/.zshrc', { shell: '/bin/zsh', stdio: 'inherit' });
+    } catch (error) {
+      // Source command may fail in some contexts, but config is still written
+      // User can manually source or restart terminal
+    }
+  }
+
+  async revert() {
+    console.log('\n🔄 Revirtiendo configuración de Creta Terminal...\n');
+
+    try {
+      let changesMade = false;
+
+      // Remove ~/.icarus-zsh if it exists
+      if (fs.existsSync(this.icarusZshPath)) {
+        fs.unlinkSync(this.icarusZshPath);
+        console.log('✅ Archivo ~/.icarus-zsh eliminado');
+        changesMade = true;
+      }
+
+      // Remove source line from .zshrc
+      if (fs.existsSync(this.zshrcPath)) {
+        const currentContent = fs.readFileSync(this.zshrcPath, 'utf8');
+
+        if (currentContent.includes('source ~/.icarus-zsh') || currentContent.includes('. ~/.icarus-zsh')) {
+          // Remove the entire Creta block (comment + source line)
+          const cleanedContent = currentContent
+            .replace(/\n# Source Creta terminal configuration\n\[ -f ~\/\.icarus-zsh \] && source ~\/\.icarus-zsh\n/g, '')
+            .replace(/\n# Source Icarus terminal configuration\n\[ -f ~\/\.icarus-zsh \] && source ~\/\.icarus-zsh\n/g, '');
+
+          fs.writeFileSync(this.zshrcPath, cleanedContent, 'utf8');
+          console.log('✅ Configuración eliminada de ~/.zshrc');
+          changesMade = true;
+        }
+      }
+
+      if (!changesMade) {
+        console.log('⚠️  No se encontró configuración de Creta para revertir');
+        return;
+      }
+
+      // Show available backups
+      this.showBackups();
+
+      console.log('\n🎉 ¡Configuración revertida exitosamente!');
+      console.log('💡 Reinicia tu terminal o ejecuta: source ~/.zshrc\n');
+
+    } catch (error) {
+      console.error('❌ Error al revertir configuración:', error.message);
+      throw error;
+    }
+  }
+
+  showBackups() {
+    try {
+      const backupFiles = fs.readdirSync(this.homeDir)
+        .filter(file => file.startsWith('.zshrc.backup.'))
+        .sort()
+        .reverse()
+        .slice(0, 5); // Show last 5 backups
+
+      if (backupFiles.length > 0) {
+        console.log('\n📦 Backups disponibles (últimos 5):');
+        backupFiles.forEach((file, index) => {
+          const filepath = path.join(this.homeDir, file);
+          const stats = fs.statSync(filepath);
+          const date = stats.mtime.toLocaleString('es-MX');
+          console.log(`   ${index + 1}. ${file} (${date})`);
+        });
+        console.log('\n💡 Para restaurar un backup manualmente:');
+        console.log('   cp ~/.zshrc.backup.TIMESTAMP ~/.zshrc');
+      }
+    } catch (error) {
+      // Silent fail - backups are optional
+    }
+  }
+}
+
+export default TerminalCustomizer;

package/package.json

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

package/wea-fome-qlia.sh

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# Summarize a repository's architecture via codex using lightweight bash reconnaissance.
+set -euo pipefail
+
+show_help() {
+  cat <<'USAGE'
+Usage: wea-fome-qlia.sh [path-to-repo]
+
+Collects structural signals from the repository using basic shell commands
+and streams them into `codex -p` to obtain a five-sentence architecture summary.
+Set the SUMMARIZER_PROMPT environment variable to override the default prompt.
+USAGE
+}
+
+if [[ ${1:-} == "-h" || ${1:-} == "--help" ]]; then
+  show_help
+  exit 0
+fi
+
+if (( $# > 1 )); then
+  echo "Only zero or one path argument is supported." >&2
+  exit 1
+fi
+
+REPO_DIR=${1:-.}
+if [[ ! -d "$REPO_DIR" ]]; then
+  echo "The path '$REPO_DIR' is not a directory." >&2
+  exit 1
+fi
+
+if [[ -z ${BASH_VERSION:-} ]]; then
+  echo "This script requires bash. Run it as './wea-fome-qlia.sh' or 'bash wea-fome-qlia.sh'." >&2
+  exit 1
+fi
+
+if ! command -v codex >/dev/null 2>&1; then
+  echo "The 'codex' CLI is required but was not found in PATH." >&2
+  exit 1
+fi
+
+REPO_DIR=$(cd "$REPO_DIR" && pwd)
+TEMP_INPUT=$(mktemp)
+trap 'rm -f "$TEMP_INPUT"' EXIT
+
+MAX_DIRS=8
+MAX_ITEMS=12
+PROMPT=${SUMMARIZER_PROMPT:-"You are a senior software architect. Using the repository signals provided, write exactly five sentences that explain the current architecture, main modules, dominant technologies, notable build or tooling traits, and any potential work-in-progress areas."}
+
+{
+  echo "Repository: $REPO_DIR"
+  echo
+  echo "Top-level entries (ls):"
+  ls -1A "$REPO_DIR" | sed 's/^/  - /'
+
+  echo
+  echo "Directory snapshots:"
+  dir_count=0
+  while IFS= read -r entry; do
+    [[ -z "$entry" ]] && continue
+    path="$REPO_DIR/$entry"
+    if [[ -d "$path" ]]; then
+      ((dir_count++))
+      echo "* $entry"
+      ls -1A "$path" | head -n "$MAX_ITEMS" | sed 's/^/    /'
+      if command -v git >/dev/null 2>&1; then
+        echo "    (files: $(ls -1A "$path" | wc -l | tr -d ' '))"
+      fi
+      echo
+    fi
+    if (( dir_count >= MAX_DIRS )); then
+      break
+    fi
+  done <<EOF
+$(ls -1A "$REPO_DIR")
+EOF
+
+  if command -v git >/dev/null 2>&1 && git -C "$REPO_DIR" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+    echo "Git status:"
+    git -C "$REPO_DIR" status -sb
+
+    echo
+    echo "Recent commits:"
+    git -C "$REPO_DIR" log -5 --oneline
+  fi
+} > "$TEMP_INPUT"
+
+{
+  printf '%s\n\n' "$PROMPT"
+  echo '--- Repository signals start ---'
+  cat "$TEMP_INPUT"
+  echo '--- Repository signals end ---'
+} | codex exec -