specleap-framework 2.0.0

package/scripts/install-skills.sh

@@ -0,0 +1,130 @@
+#!/bin/bash
+# SpecLeap — Instalador de Agent Skills TIER 1
+# Versión 2.0 — Robusto y con progreso visual
+
+set -e
+
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+echo -e "${BLUE}━━━ Installing Agent Skills TIER 1 ━━━${NC}"
+echo ""
+
+# Lista de skills (repo:path:name)
+SKILLS=(
+    # Consistencia (3) - obra/superpowers
+    "obra/superpowers:skills/verification-before-completion:verification-before-completion"
+    "obra/superpowers:skills/systematic-debugging:systematic-debugging"
+    "obra/superpowers:skills/requesting-code-review:requesting-code-review"
+    
+    # Backend (7) - jeffallan/claude-skills
+    "jeffallan/claude-skills:skills/laravel-specialist:laravel-specialist"
+    "jeffallan/claude-skills:skills/api-designer:api-designer"
+    "jeffallan/claude-skills:skills/database-optimizer:database-optimizer"
+    "jeffallan/claude-skills:skills/code-reviewer:code-reviewer"
+    "jeffallan/claude-skills:skills/debugging-wizard:debugging-wizard"
+    "jeffallan/claude-skills:skills/python-pro:python-pro"
+    "jeffallan/claude-skills:skills/react-expert:react-expert"
+    
+    # Diseño (4) - anthropics/skills
+    "anthropics/skills:skills/frontend-design:frontend-design"
+    "anthropics/skills:skills/skill-creator:skill-creator"
+    "anthropics/skills:skills/canvas-design:canvas-design"
+    "anthropics/skills:skills/algorithmic-art:algorithmic-art"
+    
+    # DevOps (3) - jeffallan/claude-skills
+    "jeffallan/claude-skills:skills/devops-engineer:devops-engineer"
+    "jeffallan/claude-skills:skills/cloud-architect:cloud-architect"
+    "jeffallan/claude-skills:skills/architecture-designer:architecture-designer"
+    
+    # Testing (2) - obra/superpowers
+    "obra/superpowers:skills/test-driven-development:test-driven-development"
+    "obra/superpowers:skills/receiving-code-review:receiving-code-review"
+    
+    # Frontend (1) - jeffallan/claude-skills
+    "jeffallan/claude-skills:skills/typescript-pro:typescript-pro"
+)
+
+TOTAL=${#SKILLS[@]}
+INSTALLED=0
+FAILED=0
+SKIPPED=0
+
+SKILLS_DIR="$HOME/.skills"
+TMP_DIR="/tmp/specleap-skills-$$"
+
+mkdir -p "$SKILLS_DIR"
+mkdir -p "$TMP_DIR"
+
+# Función para limpiar temporal
+cleanup() {
+    rm -rf "$TMP_DIR"
+}
+trap cleanup EXIT
+
+echo -e "Installing to: ${GREEN}$SKILLS_DIR${NC}"
+echo ""
+
+for i in "${!SKILLS[@]}"; do
+    IFS=':' read -r repo path name <<< "${SKILLS[$i]}"
+    num=$((i + 1))
+    
+    printf "  [%2d/%2d] %-40s " "$num" "$TOTAL" "$name"
+    
+    # Skip si ya existe
+    if [ -d "$SKILLS_DIR/$name" ]; then
+        echo -e "${YELLOW}SKIP${NC} (already installed)"
+        ((SKIPPED++))
+        continue
+    fi
+    
+    # Clonar repo si no existe
+    repo_dir="$TMP_DIR/$(echo $repo | tr '/' '_')"
+    if [ ! -d "$repo_dir" ]; then
+        if ! git clone -q "https://github.com/$repo.git" "$repo_dir" 2>/dev/null; then
+            echo -e "${RED}FAIL${NC} (repo not accessible)"
+            ((FAILED++))
+            continue
+        fi
+    fi
+    
+    # Verificar SKILL.md
+    if [ ! -f "$repo_dir/$path/SKILL.md" ]; then
+        echo -e "${RED}FAIL${NC} (SKILL.md not found)"
+        ((FAILED++))
+        continue
+    fi
+    
+    # Copiar skill
+    cp -r "$repo_dir/$path" "$SKILLS_DIR/$name"
+    echo -e "${GREEN}OK${NC}"
+    ((INSTALLED++))
+done
+
+echo ""
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+echo -e "${GREEN}✅ Installed:${NC} $INSTALLED"
+if [ $SKIPPED -gt 0 ]; then
+    echo -e "${YELLOW}⚠️  Skipped:${NC} $SKIPPED (already existed)"
+fi
+if [ $FAILED -gt 0 ]; then
+    echo -e "${RED}❌ Failed:${NC} $FAILED"
+fi
+echo ""
+
+if [ $INSTALLED -eq 0 ] && [ $SKIPPED -eq $TOTAL ]; then
+    echo -e "${GREEN}All skills already installed!${NC}"
+    exit 0
+fi
+
+if [ $FAILED -gt 0 ]; then
+    echo -e "${YELLOW}Warning: Some skills failed to install${NC}"
+    echo "This may affect code quality. Check network connection and try again."
+    exit 1
+fi
+
+echo -e "${GREEN}Agent Skills installation complete!${NC}"

package/scripts/lib/asana-utils.sh

@@ -0,0 +1,191 @@
+#!/usr/bin/env bash
+
+# SpecLeap — Utilidades para Asana API
+# Funciones helper para interactuar con Asana
+
+# Verificar token
+asana_check_auth() {
+    if [[ -z "${ASANA_ACCESS_TOKEN:-}" ]]; then
+        echo "❌ Error: ASANA_ACCESS_TOKEN no configurado" >&2
+        return 1
+    fi
+}
+
+# Obtener workspace por defecto
+asana_get_default_workspace() {
+    asana_check_auth || return 1
+    
+    local response=$(curl -s \
+        -H "Authorization: Bearer $ASANA_ACCESS_TOKEN" \
+        "https://app.asana.com/api/1.0/users/me")
+    
+    echo "$response" | jq -r '.data.workspaces[0].gid'
+}
+
+# Crear proyecto
+# Uso: asana_create_project "Nombre del Proyecto"
+asana_create_project() {
+    local project_name="$1"
+    asana_check_auth || return 1
+    
+    if [[ -z "${ASANA_WORKSPACE_GID:-}" ]]; then
+        echo "❌ Error: ASANA_WORKSPACE_GID no configurado" >&2
+        return 1
+    fi
+    
+    local payload=$(jq -n \
+        --arg name "$project_name" \
+        --arg workspace "$ASANA_WORKSPACE_GID" \
+        '{
+            data: {
+                name: $name,
+                workspace: $workspace,
+                notes: "Proyecto generado por SpecLeap",
+                color: "dark-blue",
+                layout: "list"
+            }
+        }')
+    
+    local response=$(curl -s \
+        -X POST \
+        -H "Authorization: Bearer $ASANA_ACCESS_TOKEN" \
+        -H "Content-Type: application/json" \
+        -d "$payload" \
+        "https://app.asana.com/api/1.0/projects")
+    
+    local project_gid=$(echo "$response" | jq -r '.data.gid')
+    
+    if [[ "$project_gid" == "null" || -z "$project_gid" ]]; then
+        echo "❌ Error al crear proyecto: $(echo "$response" | jq -r '.errors[0].message')" >&2
+        return 1
+    fi
+    
+    echo "$project_gid"
+}
+
+# Crear sección en un proyecto
+# Uso: asana_create_section "PROJECT_GID" "Nombre Sección"
+asana_create_section() {
+    local project_gid="$1"
+    local section_name="$2"
+    asana_check_auth || return 1
+    
+    local payload=$(jq -n \
+        --arg name "$section_name" \
+        '{
+            data: {
+                name: $name
+            }
+        }')
+    
+    local response=$(curl -s \
+        -X POST \
+        -H "Authorization: Bearer $ASANA_ACCESS_TOKEN" \
+        -H "Content-Type: application/json" \
+        -d "$payload" \
+        "https://app.asana.com/api/1.0/projects/$project_gid/sections")
+    
+    local section_gid=$(echo "$response" | jq -r '.data.gid')
+    
+    if [[ "$section_gid" == "null" || -z "$section_gid" ]]; then
+        echo "❌ Error al crear sección: $(echo "$response" | jq -r '.errors[0].message')" >&2
+        return 1
+    fi
+    
+    echo "$section_gid"
+}
+
+# Crear tarea
+# Uso: asana_create_task "PROJECT_GID" "Nombre Tarea" "SECTION_GID" POINTS
+asana_create_task() {
+    local project_gid="$1"
+    local task_name="$2"
+    local section_gid="${3:-}"
+    local points="${4:-3}"
+    asana_check_auth || return 1
+    
+    local payload=$(jq -n \
+        --arg name "$task_name" \
+        --arg project "$project_gid" \
+        --arg points "$points" \
+        '{
+            data: {
+                name: $name,
+                projects: [$project],
+                notes: ("Story Points: " + $points)
+            }
+        }')
+    
+    local response=$(curl -s \
+        -X POST \
+        -H "Authorization: Bearer $ASANA_ACCESS_TOKEN" \
+        -H "Content-Type: application/json" \
+        -d "$payload" \
+        "https://app.asana.com/api/1.0/tasks")
+    
+    local task_gid=$(echo "$response" | jq -r '.data.gid')
+    
+    if [[ "$task_gid" == "null" || -z "$task_gid" ]]; then
+        echo "❌ Error al crear tarea: $(echo "$response" | jq -r '.errors[0].message')" >&2
+        return 1
+    fi
+    
+    # Si se especificó sección, mover la tarea ahí
+    if [[ -n "$section_gid" ]]; then
+        curl -s \
+            -X POST \
+            -H "Authorization: Bearer $ASANA_ACCESS_TOKEN" \
+            -H "Content-Type: application/json" \
+            -d "{\"data\": {\"task\": \"$task_gid\"}}" \
+            "https://app.asana.com/api/1.0/sections/$section_gid/addTask" \
+            > /dev/null
+    fi
+    
+    echo "$task_gid"
+}
+
+# Listar proyectos
+asana_list_projects() {
+    asana_check_auth || return 1
+    
+    if [[ -z "${ASANA_WORKSPACE_GID:-}" ]]; then
+        echo "❌ Error: ASANA_WORKSPACE_GID no configurado" >&2
+        return 1
+    fi
+    
+    curl -s \
+        -H "Authorization: Bearer $ASANA_ACCESS_TOKEN" \
+        "https://app.asana.com/api/1.0/projects?workspace=$ASANA_WORKSPACE_GID" \
+        | jq -r '.data[] | "\(.gid)\t\(.name)"'
+}
+
+# Buscar proyecto por nombre
+# Uso: asana_find_project "Nombre"
+asana_find_project() {
+    local project_name="$1"
+    asana_list_projects | grep -i "$project_name" | head -1 | cut -f1
+}
+
+# Listar secciones de un proyecto
+# Uso: asana_list_sections "PROJECT_GID"
+asana_list_sections() {
+    local project_gid="$1"
+    asana_check_auth || return 1
+    
+    curl -s \
+        -H "Authorization: Bearer $ASANA_ACCESS_TOKEN" \
+        "https://app.asana.com/api/1.0/projects/$project_gid/sections" \
+        | jq -r '.data[] | "\(.gid)\t\(.name)"'
+}
+
+# Listar tareas de un proyecto
+# Uso: asana_list_tasks "PROJECT_GID"
+asana_list_tasks() {
+    local project_gid="$1"
+    asana_check_auth || return 1
+    
+    curl -s \
+        -H "Authorization: Bearer $ASANA_ACCESS_TOKEN" \
+        "https://app.asana.com/api/1.0/projects/$project_gid/tasks" \
+        | jq -r '.data[] | "\(.gid)\t\(.name)"'
+}

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

@@ -0,0 +1,222 @@
+#!/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
+}