elsabro 2.3.0 → 3.8.0

package/hooks/skill-discovery.sh

@@ -0,0 +1,539 @@
+#!/bin/bash
+# skill-discovery.sh - ELSABRO Hook para descubrir skills externos antes del planning
+#
+# Uso: bash ./hooks/skill-discovery.sh "descripción de tarea" "complejidad"
+# Output: JSON con skills descubiertos, validados y rankeados
+#
+# Responsabilidades:
+# 1. Extraer keywords de la descripción
+# 2. Buscar skills en ELSABRO interno
+# 3. Buscar skills en marketplace externo (skills.sh)
+# 4. Validar y rankear resultados
+# 5. Retornar JSON con estructura normalizada
+
+set -e
+
+# ============================================================================
+# CONFIGURACIÓN Y CONSTANTES
+# ============================================================================
+
+# Directorios
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+ELSABRO_SKILLS_DIR="${PROJECT_ROOT}/skills"
+SKILLS_CACHE_FILE="${PROJECT_ROOT}/.cache/skills-discovery-cache.json"
+SKILLS_REGISTRY="${HOME}/.elsabro/skills-registry.json"
+
+# Configuración de descubrimiento
+KEYWORDS_MIN_MATCH=1
+MAX_SKILLS_RETURN=10
+EXTERNAL_API_TIMEOUT=15
+CACHE_TTL_SECONDS=3600
+
+# Colores para stderr (feedback visual)
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Prefijo de logs
+PREFIX="[ELSABRO:skill-discovery]"
+
+# ============================================================================
+# UTILIDADES
+# ============================================================================
+
+log_info() {
+    echo -e "${BLUE}${PREFIX}${NC} $1" >&2
+}
+
+log_success() {
+    echo -e "${GREEN}${PREFIX}${NC} ✓ $1" >&2
+}
+
+log_warn() {
+    echo -e "${YELLOW}${PREFIX}${NC} ⚠ $1" >&2
+}
+
+log_error() {
+    echo -e "${RED}${PREFIX}${NC} ✗ $1" >&2
+}
+
+# Crear directorios si no existen
+ensure_dirs() {
+    mkdir -p "$(dirname "$SKILLS_CACHE_FILE")" 2>/dev/null || true
+}
+
+# Verificar si caché es válido
+is_cache_valid() {
+    local cache_file="$1"
+
+    if [ ! -f "$cache_file" ]; then
+        return 1
+    fi
+
+    # Verificar edad del caché (en segundos)
+    local file_age=$(($(date +%s) - $(stat -f%m "$cache_file" 2>/dev/null || echo 0)))
+
+    if [ "$file_age" -gt "$CACHE_TTL_SECONDS" ]; then
+        return 1
+    fi
+
+    return 0
+}
+
+# ============================================================================
+# 1. EXTRACCIÓN DE KEYWORDS
+# ============================================================================
+
+# Extrae palabras clave de la descripción de tarea
+# Entrada: string (descripción)
+# Salida: JSON array con keywords encontradas
+extract_keywords() {
+    local task_description="$1"
+
+    # Convertir a lowercase para búsqueda insensible
+    local lowercase=$(echo "$task_description" | tr '[:upper:]' '[:lower:]')
+
+    # Definir patrones de keywords por categoría
+    # Formato: categoria|sinónimo1|sinónimo2|sinónimo3
+    local keyword_patterns=(
+        "api|api|backend|endpoint|rest|graphql|http|server"
+        "auth|auth|login|signin|oauth|jwt|session|password|signup|credential"
+        "db|database|db|postgres|postgresql|mysql|mongodb|firebase|sql|orm"
+        "payments|payment|stripe|paypal|billing|checkout|commerce|transaction"
+        "mobile|mobile|expo|react-native|ios|android|app|swift|kotlin"
+        "web|website|web|nextjs|react|vue|angular|frontend|ui|ux|html|css"
+        "devops|devops|docker|kubernetes|k8s|ci|cd|github|gitlab|deploy"
+        "testing|test|jest|vitest|mocha|pytest|coverage|unit|e2e|qa"
+        "security|security|encrypt|https|cors|ssl|tls|hash|salt|breach"
+        "monitoring|monitor|sentry|logging|logs|error|analytics|observability"
+        "cli|cli|command|tool|script|automation|terminal|bash|shell"
+        "ai|ai|machine-learning|ml|gpt|claude|llm|nlp|transformer"
+    )
+
+    # Array para guardar keywords encontrados
+    local found_keywords=()
+    local found_categories=()
+
+    # Buscar cada patrón en la descripción
+    for pattern in "${keyword_patterns[@]}"; do
+        IFS='|' read -r category synmap <<< "$pattern"
+
+        # Crear regex de sinónimos
+        local regex=$(echo "$synmap" | sed 's/|/\\|/g')
+
+        # Buscar con grep case-insensitive
+        if echo "$lowercase" | grep -qiE "\b($regex)\b"; then
+            found_keywords+=("\"$category\"")
+            found_categories+=("$category")
+        fi
+    done
+
+    # Retornar como JSON array
+    # Si no encontró keywords, retornar array vacío
+    if [ ${#found_keywords[@]} -eq 0 ]; then
+        echo "[]"
+    else
+        printf "["
+        printf "%s" "${found_keywords[0]}"
+        for kw in "${found_keywords[@]:1}"; do
+            printf ",$kw"
+        done
+        printf "]\n"
+    fi
+}
+
+# ============================================================================
+# 2. DESCUBRIMIENTO DE SKILLS - FUENTE 1: ELSABRO INTERNO
+# ============================================================================
+
+# Busca skills en ./skills/*.md
+# Entrada: JSON array de keywords
+# Salida: JSON array con skills ELSABRO encontrados
+discover_elsabro_skills() {
+    local keywords="$1"
+
+    local skills_found=()
+
+    # Verificar que directorio existe
+    if [ ! -d "$ELSABRO_SKILLS_DIR" ]; then
+        echo "[]"
+        return
+    fi
+
+    # Iterar sobre cada archivo .md en skills/
+    for skill_file in "$ELSABRO_SKILLS_DIR"/*.md; do
+        [ -f "$skill_file" ] || continue
+
+        local skill_name=$(basename "$skill_file" .md)
+        local skill_content=$(cat "$skill_file")
+
+        # ---- Extraer metadata YAML ----
+        # Buscar secciones YAML en el front matter
+
+        local description=$(
+            echo "$skill_content" | sed -n '/^description:/s/^description: *//p' | head -1
+        )
+        description="${description:0:80}"  # Limitar a 80 caracteres
+
+        local difficulty=$(
+            echo "$skill_content" | sed -n '/^difficulty:/s/^difficulty: *//p' | head -1
+        )
+        difficulty="${difficulty:-intermediate}"
+
+        local estimated_time=$(
+            echo "$skill_content" | sed -n '/^estimated_time:/s/^estimated_time: *//p' | head -1
+        )
+
+        # Extraer tags (múltiples líneas)
+        local tags=$(
+            echo "$skill_content" |
+            sed -n '/^tags:/,/^[^ -]/p' |
+            grep "^  - " |
+            sed 's/^  - //' |
+            head -10
+        )
+
+        # ---- Calcular match score ----
+        # Score = cantidad de keywords que coinciden con tags/description
+
+        local match_score=0
+
+        # Convertir keywords de JSON array a array bash
+        local kw_array=()
+        if command -v jq &> /dev/null; then
+            while IFS= read -r kw; do
+                kw_array+=("$kw")
+            done < <(echo "$keywords" | jq -r '.[]' 2>/dev/null)
+        fi
+
+        # Buscar keywords en tags y descripción
+        for keyword in "${kw_array[@]}"; do
+            if echo "$tags" | grep -qi "$keyword"; then
+                ((match_score++))
+            fi
+            if echo "$description" | grep -qi "$keyword"; then
+                ((match_score++))
+            fi
+        done
+
+        # Solo incluir si hay al menos un match
+        if [ "$match_score" -ge "$KEYWORDS_MIN_MATCH" ]; then
+            # Construir objeto skill JSON
+            local tags_json=$(echo "$tags" | jq -R -s -c 'split("\n") | map(select(length > 0))')
+
+            local skill_obj=$(cat <<EOF
+{
+  "id": "$skill_name",
+  "source": "elsabro",
+  "status": "available",
+  "match_score": $match_score,
+  "description": "$description",
+  "difficulty": "$difficulty",
+  "estimated_time": "$estimated_time",
+  "tags": $tags_json,
+  "rank": 0
+}
+EOF
+            )
+
+            skills_found+=("$skill_obj")
+        fi
+    done
+
+    # Retornar como JSON array
+    if [ ${#skills_found[@]} -eq 0 ]; then
+        echo "[]"
+    else
+        # Usar jq para construir array válido
+        printf '%s\n' "${skills_found[@]}" | jq -s '.'
+    fi
+}
+
+# ============================================================================
+# 3. DESCUBRIMIENTO DE SKILLS - FUENTE 2: MARKETPLACE EXTERNO
+# ============================================================================
+
+# Consulta API de skills.sh para encontrar skills externos
+# Entrada: JSON array de keywords
+# Salida: JSON array con skills de marketplace
+discover_external_skills() {
+    local keywords="$1"
+
+    # Si no está disponible curl o jq, retornar array vacío
+    if ! command -v curl &> /dev/null || ! command -v jq &> /dev/null; then
+        log_warn "curl o jq no disponible, saltando external skills"
+        echo "[]"
+        return
+    fi
+
+    # URL de la API
+    local api_url="https://api.skills.sh/v1/discover"
+
+    # Payload: array de keywords
+    local payload=$(echo "$keywords" | jq -c '.')
+
+    log_info "Consultando API: $api_url con keywords: $payload"
+
+    # Hacer petición HTTP con timeout
+    local response=$(
+        timeout "$EXTERNAL_API_TIMEOUT" curl -s \
+            -X POST "$api_url" \
+            -H "Content-Type: application/json" \
+            -d "{\"keywords\": $payload}" \
+            2>/dev/null || echo "[]"
+    )
+
+    # Procesar respuesta (asumir estructura: { "skills": [...] })
+    if echo "$response" | jq empty 2>/dev/null; then
+        # Extractar y enriquecer skills
+        echo "$response" | jq -c '
+            .skills[]? // empty |
+            . + {
+              status: "available",
+              rank: 0,
+              install_command: ("curl -s https://skills.sh/install/" + .id + " | bash")
+            }
+        ' | jq -s '.'
+    else
+        log_warn "API response inválido, retornando array vacío"
+        echo "[]"
+    fi
+}
+
+# ============================================================================
+# 4. VALIDACIÓN Y RANKING
+# ============================================================================
+
+# Valida y rankea todos los skills descubiertos
+# Entrada: JSON array de skills
+# Salida: JSON array validado y ordenado por rank
+validate_and_rank_skills() {
+    local all_skills="$1"
+
+    if ! command -v jq &> /dev/null; then
+        log_warn "jq no disponible, retornando skills sin validación"
+        echo "$all_skills"
+        return
+    fi
+
+    # Validar y rankear con jq
+    echo "$all_skills" | jq -c '
+        # Filtrar skills válidos
+        map(
+            select(
+                .id != null and
+                .source != null and
+                (.status == "available" or .status == "installable")
+            )
+        ) |
+        # Agregar score de ranking
+        map(
+            . + {
+                rank: (
+                    # Base: match_score
+                    (.match_score // 0) * 100 +
+                    # Bonus por dificultad (beginner > advanced)
+                    (if .difficulty == "beginner" then 50 else
+                     if .difficulty == "intermediate" then 30 else
+                     if .difficulty == "advanced" then 10 else 0 end end) +
+                    # Bonus por source (elsabro es más confiable)
+                    (if .source == "elsabro" then 20 else 0 end) +
+                    # Penalty por external que requiere instalación
+                    (if (.install_command != null) then 0 else 5 end)
+                )
+            }
+        ) |
+        # Ordenar por ranking descendente
+        sort_by(.rank) | reverse |
+        # Limitar a top 10
+        .[0:10]
+    '
+}
+
+# ============================================================================
+# 5. CACHÉ
+# ============================================================================
+
+# Intenta obtener skills del caché
+# Entrada: keywords (string)
+# Salida: JSON array con skills si caché válido, "null" si no
+get_from_cache() {
+    local keywords="$1"
+    local keywords_hash=$(echo -n "$keywords" | md5 2>/dev/null || echo "$keywords" | md5sum | awk '{print $1}')
+
+    if ! is_cache_valid "$SKILLS_CACHE_FILE"; then
+        return 1
+    fi
+
+    # Buscar en caché con jq
+    if command -v jq &> /dev/null; then
+        local cached=$(
+            jq --arg hash "$keywords_hash" '.cache[$hash]?' "$SKILLS_CACHE_FILE" 2>/dev/null
+        )
+
+        if [ "$cached" != "null" ] && [ -n "$cached" ]; then
+            log_success "Skill cache hit"
+            echo "$cached"
+            return 0
+        fi
+    fi
+
+    return 1
+}
+
+# Guardar resultado en caché
+save_to_cache() {
+    local keywords="$1"
+    local skills="$2"
+    local keywords_hash=$(echo -n "$keywords" | md5 2>/dev/null || echo "$keywords" | md5sum | awk '{print $1}')
+
+    ensure_dirs
+
+    # Crear o actualizar caché
+    if [ -f "$SKILLS_CACHE_FILE" ]; then
+        jq --arg hash "$keywords_hash" --argjson skills "$skills" \
+            '.cache[$hash] = $skills' "$SKILLS_CACHE_FILE" > "$SKILLS_CACHE_FILE.tmp"
+        mv "$SKILLS_CACHE_FILE.tmp" "$SKILLS_CACHE_FILE"
+    else
+        # Crear caché nuevo
+        jq -n --arg hash "$keywords_hash" --argjson skills "$skills" \
+            '{cache: {($hash): $skills}}' > "$SKILLS_CACHE_FILE"
+    fi
+}
+
+# ============================================================================
+# 6. OUTPUT Y FORMATEO
+# ============================================================================
+
+# Formatea output final como JSON normalizado
+# Entrada: keywords, skills de cada fuente, skills rankeados
+# Salida: JSON con estructura completa
+format_discovery_output() {
+    local keywords="$1"
+    local elsabro_skills="$2"
+    local external_skills="$3"
+    local ranked_skills="$4"
+
+    if ! command -v jq &> /dev/null; then
+        # Fallback si jq no está disponible
+        cat <<EOF
+{
+  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+  "status": "error",
+  "message": "jq not available"
+}
+EOF
+        return 1
+    fi
+
+    # Contar elementos
+    local elsabro_count=$(echo "$elsabro_skills" | jq 'length')
+    local external_count=$(echo "$external_skills" | jq 'length')
+    local ranked_count=$(echo "$ranked_skills" | jq 'length')
+
+    # Extraer top 3 recomendaciones
+    local recommendations=$(
+        echo "$ranked_skills" | jq -r '.[0:3] | map(.id) | .[]' | jq -Rs 'split("\n") | map(select(length > 0))'
+    )
+
+    # Construir output final
+    cat <<EOF | jq -c '.'
+{
+  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+  "keywords_detected": $keywords,
+  "discovery": {
+    "elsabro": {
+      "count": $elsabro_count,
+      "skills": $elsabro_skills
+    },
+    "external": {
+      "count": $external_count,
+      "skills": $external_skills
+    }
+  },
+  "ranked": {
+    "count": $ranked_count,
+    "skills": $ranked_skills,
+    "recommendations": $recommendations
+  },
+  "status": "success"
+}
+EOF
+}
+
+# ============================================================================
+# 7. FUNCIÓN PRINCIPAL
+# ============================================================================
+
+main() {
+    local task_description="${1:-}"
+    local complexity="${2:-medium}"
+
+    # Validación de entrada
+    if [ -z "$task_description" ]; then
+        cat <<EOF | jq -c '.'
+{
+  "status": "error",
+  "message": "Task description required",
+  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+}
+EOF
+        exit 1
+    fi
+
+    log_info "Analizando: $task_description (complejidad: $complexity)"
+
+    # ---- FASE 1: Extraer keywords ----
+    log_info "Extrayendo keywords..."
+    local keywords=$(extract_keywords "$task_description")
+    log_success "Keywords: $(echo $keywords | jq -r 'join(", ")')"
+
+    # ---- FASE 2: Buscar skills (con caché) ----
+    local keywords_str=$(echo "$keywords" | jq -r 'join(",")')
+    local cached_result=""
+
+    if cached_result=$(get_from_cache "$keywords_str"); then
+        log_success "Usando resultados del caché"
+        # Output y exit
+        echo "$cached_result"
+        exit 0
+    fi
+
+    # ---- FASE 3: Descubrir skills de múltiples fuentes ----
+    log_info "Descubriendo skills internos (ELSABRO)..."
+    local elsabro_skills=$(discover_elsabro_skills "$keywords")
+    log_success "ELSABRO skills encontrados: $(echo $elsabro_skills | jq 'length')"
+
+    log_info "Descubriendo skills externos (skills.sh)..."
+    local external_skills=$(discover_external_skills "$keywords")
+    log_success "External skills encontrados: $(echo $external_skills | jq 'length')"
+
+    # ---- FASE 4: Combinar y rankear ----
+    log_info "Combinando y rankeando skills..."
+    local all_skills=$(echo "[$elsabro_skills, $external_skills]" | jq -s 'add // []')
+    local ranked=$(validate_and_rank_skills "$all_skills")
+    log_success "Skills rankeados: $(echo $ranked | jq 'length')"
+
+    # ---- FASE 5: Formatear output ----
+    log_info "Formateando output..."
+    local output=$(format_discovery_output "$keywords" "$elsabro_skills" "$external_skills" "$ranked")
+
+    # Guardar en caché
+    save_to_cache "$keywords_str" "$output"
+
+    # Output final (STDOUT) - esto es lo que captura el Flow Engine
+    echo "$output"
+
+    log_success "Discovery completado"
+    exit 0
+}
+
+# ============================================================================
+# EJECUCIÓN
+# ============================================================================
+
+main "$@"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elsabro",
-  "version": "2.3.0",
-  "description": "Sistema de desarrollo AI-powered para Claude Code - El mejor asistente para crear apps sin experiencia previa",
+  "version": "3.8.0",
+  "description": "Sistema de desarrollo AI-powered para Claude Code - Orquestación avanzada con checkpointing, memoria multi-nivel y flows declarativos",
   "bin": {
     "elsabro": "bin/install.js"
   },
@@ -12,6 +12,7 @@
     "skills",
     "templates",
     "workflows",
+    "flows",
     "references",
     "hooks",
     "scripts"