specleap-framework 2.1.0 → 2.1.5

package/scripts/quality-healing.sh

@@ -0,0 +1,241 @@
+#!/bin/bash
+# SpecLeap — Healing telemetry log per feature
+# Writes JSONL entries to .quality/evidence/[feature]/healing.jsonl
+#
+# Verbs:
+#   log    append a new entry
+#   show   print last N entries (default 20)
+#   stats  count entries by severity, phase and action
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+source "$ROOT/.specleap/i18n.sh"
+
+EVIDENCE_DIR="$ROOT/.quality/evidence"
+
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# -----------------------------------------------------------------------------
+# Argument parser (long options only)
+# Sets: ARG_FEATURE, ARG_PHASE, ARG_SEVERITY, ARG_ACTION, ARG_DETAIL, ARG_FILE, ARG_LAST
+# -----------------------------------------------------------------------------
+parse_args() {
+    ARG_FEATURE=""
+    ARG_PHASE=""
+    ARG_SEVERITY=""
+    ARG_ACTION=""
+    ARG_DETAIL=""
+    ARG_FILE=""
+    ARG_LAST="20"
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --feature)  ARG_FEATURE="$2"; shift 2 ;;
+            --phase)    ARG_PHASE="$2"; shift 2 ;;
+            --severity) ARG_SEVERITY="$2"; shift 2 ;;
+            --action)   ARG_ACTION="$2"; shift 2 ;;
+            --detail)   ARG_DETAIL="$2"; shift 2 ;;
+            --file)     ARG_FILE="$2"; shift 2 ;;
+            --last)     ARG_LAST="$2"; shift 2 ;;
+            *)          shift ;;
+        esac
+    done
+}
+
+# -----------------------------------------------------------------------------
+# Resolve path to the healing.jsonl of a given feature
+# Outputs path via stdout; returns non-zero if evidence folder missing
+# -----------------------------------------------------------------------------
+log_path_for() {
+    local feature="$1"
+    local dir="$EVIDENCE_DIR/$feature"
+    if [ ! -d "$dir" ]; then
+        return 1
+    fi
+    echo "$dir/healing.jsonl"
+}
+
+# -----------------------------------------------------------------------------
+# JSON-escape a string (wraps jq)
+# -----------------------------------------------------------------------------
+json_escape() {
+    if command -v jq &> /dev/null; then
+        jq -Rn --arg s "$1" '$s'
+    else
+        # Fallback: crude escaping for common cases
+        local s="$1"
+        s="${s//\\/\\\\}"
+        s="${s//\"/\\\"}"
+        s="${s//$'\n'/\\n}"
+        s="${s//$'\t'/\\t}"
+        echo "\"$s\""
+    fi
+}
+
+cmd_log() {
+    parse_args "$@"
+
+    if [ -z "$ARG_FEATURE" ]; then
+        echo -e "${RED}$(t 'quality.healing.missing_feature')${NC}"
+        echo "$(t 'quality.healing.usage_log')"
+        exit 1
+    fi
+    if [ -z "$ARG_PHASE" ]; then
+        echo -e "${RED}$(t 'quality.healing.missing_phase')${NC}"
+        exit 1
+    fi
+    if [ -z "$ARG_ACTION" ]; then
+        echo -e "${RED}$(t 'quality.healing.missing_action')${NC}"
+        exit 1
+    fi
+
+    # Default severity = info
+    [ -z "$ARG_SEVERITY" ] && ARG_SEVERITY="info"
+
+    case "$ARG_SEVERITY" in
+        info|warn|error) ;;
+        *)
+            echo -e "${RED}$(t 'quality.healing.severity_invalid')${NC} $ARG_SEVERITY"
+            exit 1
+            ;;
+    esac
+
+    local log_file
+    if ! log_file=$(log_path_for "$ARG_FEATURE"); then
+        echo -e "${RED}$(t 'quality.healing.no_evidence')${NC} $ARG_FEATURE"
+        echo "$(t 'quality.healing.run_new_evidence_first')"
+        exit 1
+    fi
+
+    local ts
+    ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+    # Build JSON entry one line
+    local entry
+    if command -v jq &> /dev/null; then
+        entry=$(jq -cn \
+            --arg ts "$ts" \
+            --arg phase "$ARG_PHASE" \
+            --arg severity "$ARG_SEVERITY" \
+            --arg action "$ARG_ACTION" \
+            --arg detail "$ARG_DETAIL" \
+            --arg file "$ARG_FILE" \
+            '{ts: $ts, phase: $phase, severity: $severity, action: $action, detail: $detail, file: $file}
+             | if .file == "" then del(.file) else . end
+             | if .detail == "" then del(.detail) else . end')
+    else
+        # Fallback without jq
+        local json="{\"ts\":$(json_escape "$ts"),\"phase\":$(json_escape "$ARG_PHASE"),\"severity\":$(json_escape "$ARG_SEVERITY"),\"action\":$(json_escape "$ARG_ACTION")"
+        [ -n "$ARG_DETAIL" ] && json="$json,\"detail\":$(json_escape "$ARG_DETAIL")"
+        [ -n "$ARG_FILE" ] && json="$json,\"file\":$(json_escape "$ARG_FILE")"
+        json="$json}"
+        entry="$json"
+    fi
+
+    echo "$entry" >> "$log_file"
+
+    echo -e "${GREEN}$(t 'quality.healing.log_done')${NC} $log_file"
+}
+
+cmd_show() {
+    parse_args "$@"
+
+    if [ -z "$ARG_FEATURE" ]; then
+        echo -e "${RED}$(t 'quality.healing.missing_feature')${NC}"
+        echo "$(t 'quality.healing.usage_show')"
+        exit 1
+    fi
+
+    local log_file
+    if ! log_file=$(log_path_for "$ARG_FEATURE"); then
+        echo -e "${RED}$(t 'quality.healing.no_evidence')${NC} $ARG_FEATURE"
+        exit 1
+    fi
+
+    if [ ! -f "$log_file" ]; then
+        echo -e "${YELLOW}$(t 'quality.healing.no_log')${NC} $ARG_FEATURE"
+        exit 0
+    fi
+
+    local total
+    total=$(wc -l < "$log_file" | tr -d ' ')
+
+    echo "healing.jsonl — $ARG_FEATURE — $total $(t 'quality.healing.entries')"
+    echo ""
+
+    if command -v jq &> /dev/null; then
+        tail -n "$ARG_LAST" "$log_file" | jq -r '"[\(.ts)] \(.severity | ascii_upcase)  \(.phase) / \(.action)\t\(.detail // "")"'
+    else
+        tail -n "$ARG_LAST" "$log_file"
+    fi
+}
+
+cmd_stats() {
+    parse_args "$@"
+
+    if [ -z "$ARG_FEATURE" ]; then
+        echo -e "${RED}$(t 'quality.healing.missing_feature')${NC}"
+        echo "$(t 'quality.healing.usage_stats')"
+        exit 1
+    fi
+
+    local log_file
+    if ! log_file=$(log_path_for "$ARG_FEATURE"); then
+        echo -e "${RED}$(t 'quality.healing.no_evidence')${NC} $ARG_FEATURE"
+        exit 1
+    fi
+
+    if [ ! -f "$log_file" ]; then
+        echo -e "${YELLOW}$(t 'quality.healing.no_log')${NC} $ARG_FEATURE"
+        exit 0
+    fi
+
+    if ! command -v jq &> /dev/null; then
+        echo -e "${RED}$(t 'quality.healing.jq_required')${NC}"
+        exit 1
+    fi
+
+    local total
+    total=$(wc -l < "$log_file" | tr -d ' ')
+
+    echo "healing.jsonl — $ARG_FEATURE"
+    echo "$(t 'quality.healing.total_entries'): $total"
+    echo ""
+
+    echo "$(t 'quality.healing.by_severity'):"
+    jq -r '.severity' "$log_file" | sort | uniq -c | sort -rn | awk '{printf "  %-8s %s\n", $2, $1}'
+    echo ""
+
+    echo "$(t 'quality.healing.by_phase'):"
+    jq -r '.phase' "$log_file" | sort | uniq -c | sort -rn | awk '{printf "  %-20s %s\n", $2, $1}'
+    echo ""
+
+    echo "$(t 'quality.healing.by_action'):"
+    jq -r '.action' "$log_file" | sort | uniq -c | sort -rn | awk '{printf "  %-25s %s\n", $2, $1}'
+}
+
+# Dispatch
+case "${1:-}" in
+    log)
+        shift
+        cmd_log "$@"
+        ;;
+    show)
+        shift
+        cmd_show "$@"
+        ;;
+    stats)
+        shift
+        cmd_stats "$@"
+        ;;
+    *)
+        echo "$(t 'quality.healing.usage')"
+        exit 1
+        ;;
+esac

package/setup.sh

@@ -72,7 +72,7 @@ if [ "$LANG" = "es" ]; then
     MSG_REQUIREMENTS="Verificando requisitos del sistema..."
     MSG_GITHUB="Paso 2/6: Configuración GitHub"
     MSG_ASANA="Paso 3/6: Configuración Asana (Obligatorio)"
-    MSG_SKILLS="Paso 4/6: Agent Skills (20 skills)"
+    MSG_SKILLS="Paso 4/6: Agent Skills (34 skills)"
     MSG_CODERABBIT="Paso 5/6: CodeRabbit"
     MSG_FINAL="Paso 6/6: Finalizando"
     MSG_SUCCESS="✅ ¡Instalación completa!"
@@ -84,7 +84,7 @@ else
     MSG_REQUIREMENTS="Checking system requirements..."
     MSG_GITHUB="Step 2/6: GitHub Setup"
     MSG_ASANA="Step 3/6: Asana Setup (Required)"
-    MSG_SKILLS="Step 4/6: Agent Skills (20 skills)"
+    MSG_SKILLS="Step 4/6: Agent Skills (34 skills)"
     MSG_CODERABBIT="Step 5/6: CodeRabbit"
     MSG_FINAL="Step 6/6: Finishing"
     MSG_SUCCESS="✅ Installation complete!"
@@ -290,7 +290,7 @@ echo ""
 sleep 1
 
 # ============================================
-# PASO 4: Agent Skills (20 TIER 1)
+# PASO 4: Agent Skills (34 skills: 20 TIER 1 + 14 TIER 2)
 # ============================================
 
 echo -e "${CYAN}${LINE}${NC}"

package/scripts/lib/jira-project-utils.sh

@@ -1,222 +0,0 @@
-#!/usr/bin/env bash
-
-# SpecLeap — Utilidades para gestión de proyectos Jira
-# Funciones para crear/verificar proyectos Jira independientes
-
-set -euo pipefail
-
-# Colores
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-RESET='\033[0m'
-
-print_success() {
-    echo -e "${GREEN}✅ $1${RESET}" >&2
-}
-
-print_error() {
-    echo -e "${RED}❌ Error: $1${RESET}" >&2
-}
-
-print_warning() {
-    echo -e "${YELLOW}⚠️  $1${RESET}" >&2
-}
-
-print_info() {
-    echo -e "${CYAN}ℹ️  $1${RESET}" >&2
-}
-
-# ============================================================================
-# GENERACIÓN DE PROJECT KEY
-# ============================================================================
-
-generate_project_key() {
-    local project_name="$1"
-    
-    # Convertir nombre a key válida de Jira:
-    # - Solo mayúsculas
-    # - Sin guiones ni espacios (reemplazar con nada)
-    # - Máximo 10 caracteres
-    # - Mínimo 2 caracteres
-    
-    # Ejemplos:
-    # "casa-de-peli" → "CASADEPELI" → "CASADEPEL" (10 chars)
-    # "mi-app" → "MIAPP" (5 chars)
-    # "e-commerce" → "ECOMMERCE" → "ECOMMERCE" (9 chars)
-    
-    local key=$(echo "$project_name" | tr '[:lower:]' '[:upper:]' | tr -d '-_ ' | head -c 10)
-    
-    # Validar longitud mínima
-    if [[ ${#key} -lt 2 ]]; then
-        print_error "Project key muy corto: $key (mínimo 2 caracteres)"
-        return 1
-    fi
-    
-    echo "$key"
-}
-
-# ============================================================================
-# VERIFICACIÓN DE PROYECTO JIRA
-# ============================================================================
-
-jira_project_exists() {
-    local project_key="$1"
-    
-    # Intentar obtener info del proyecto vía MCP Jira
-    # Si el proyecto no existe, el comando fallará
-    
-    # Método 1: Usar MCP Jira (si está configurado)
-    if command -v mcp-jira &> /dev/null; then
-        if mcp-jira get-project "$project_key" &> /dev/null; then
-            return 0  # Proyecto existe
-        else
-            return 1  # Proyecto no existe
-        fi
-    fi
-    
-    # Método 2: Usar Jira CLI (si está instalado)
-    if command -v jira &> /dev/null; then
-        if jira project view "$project_key" &> /dev/null 2>&1; then
-            return 0
-        else
-            return 1
-        fi
-    fi
-    
-    # Método 3: Verificación manual (sin herramientas)
-    print_warning "No se puede verificar proyecto automáticamente (MCP Jira no encontrado)"
-    print_info "Por favor verifica manualmente si el proyecto $project_key existe en Jira"
-    
-    # Preguntar al usuario
-    read -p "¿El proyecto $project_key existe en Jira? [s/N]: " -n 1 -r >&2
-    echo >&2
-    
-    if [[ $REPLY =~ ^[Ss]$ ]]; then
-        return 0
-    else
-        return 1
-    fi
-}
-
-# ============================================================================
-# CREACIÓN DE PROYECTO JIRA
-# ============================================================================
-
-create_jira_project() {
-    local project_key="$1"
-    local project_name="$2"
-    local project_description="$3"
-    local lead_email="${4:-}"  # Opcional
-    
-    print_info "Intentando crear proyecto Jira: $project_key ($project_name)"
-    
-    # Método 1: Usar MCP Jira (si está configurado)
-    if command -v mcp-jira &> /dev/null; then
-        print_info "Usando MCP Jira para crear proyecto..."
-        
-        if mcp-jira create-project \
-            --key "$project_key" \
-            --name "$project_name" \
-            --description "$project_description" \
-            --type scrum \
-            ${lead_email:+--lead "$lead_email"} 2>&1; then
-            
-            print_success "Proyecto $project_key creado exitosamente"
-            return 0
-        else
-            print_error "Fallo al crear proyecto con MCP Jira"
-            return 1
-        fi
-    fi
-    
-    # Método 2: Usar Jira CLI (si está instalado)
-    if command -v jira &> /dev/null; then
-        print_info "Usando Jira CLI para crear proyecto..."
-        
-        if jira project create \
-            --key "$project_key" \
-            --name "$project_name" \
-            --template "Scrum software development" \
-            ${lead_email:+--lead "$lead_email"} 2>&1; then
-            
-            print_success "Proyecto $project_key creado exitosamente"
-            return 0
-        else
-            print_error "Fallo al crear proyecto con Jira CLI"
-            return 1
-        fi
-    fi
-    
-    # Método 3: Instrucciones manuales (sin herramientas)
-    print_warning "No se puede crear proyecto automáticamente (herramientas no encontradas)"
-    print_info ""
-    print_info "Por favor crea el proyecto manualmente en Jira:"
-    print_info ""
-    print_info "  1. Ve a Jira → Proyectos → Crear proyecto"
-    print_info "  2. Selecciona: Scrum software development"
-    print_info "  3. Clave del proyecto: $project_key"
-    print_info "  4. Nombre del proyecto: $project_name"
-    print_info "  5. Descripción: $project_description"
-    print_info ""
-    
-    read -p "¿Ya creaste el proyecto $project_key en Jira? [s/N]: " -n 1 -r >&2
-    echo >&2
-    
-    if [[ $REPLY =~ ^[Ss]$ ]]; then
-        print_success "Proyecto $project_key confirmado"
-        return 0
-    else
-        print_error "Operación cancelada. Crea el proyecto en Jira y vuelve a ejecutar."
-        return 1
-    fi
-}
-
-# ============================================================================
-# FLUJO COMPLETO: VERIFICAR O CREAR PROYECTO
-# ============================================================================
-
-ensure_jira_project_exists() {
-    local project_key="$1"
-    local project_name="$2"
-    local project_description="$3"
-    local lead_email="${4:-}"  # Opcional
-    
-    print_info "Verificando proyecto Jira: $project_key"
-    
-    if jira_project_exists "$project_key"; then
-        print_success "Proyecto $project_key ya existe"
-        return 0
-    else
-        print_warning "Proyecto $project_key no existe. Creando..."
-        
-        if create_jira_project "$project_key" "$project_name" "$project_description" "$lead_email"; then
-            return 0
-        else
-            print_error "No se pudo crear el proyecto $project_key"
-            return 1
-        fi
-    fi
-}
-
-# ============================================================================
-# VALIDACIÓN DE KEY
-# ============================================================================
-
-validate_project_key() {
-    local key="$1"
-    
-    # Reglas de Jira para project keys:
-    # - Solo letras mayúsculas (A-Z)
-    # - Longitud: 2-10 caracteres
-    # - Debe empezar con letra
-    
-    if [[ ! "$key" =~ ^[A-Z][A-Z0-9]{1,9}$ ]]; then
-        print_error "Project key inválida: $key"
-        print_error "Debe contener solo mayúsculas, 2-10 caracteres, empezar con letra"
-        return 1
-    fi
-    
-    return 0
-}