specleap-framework 2.0.0

package/scripts/generate-asana-structure.sh

@@ -0,0 +1,262 @@
+#!/usr/bin/env bash
+
+# Cargar sistema i18n
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../.specleap/i18n.sh"
+
+# SpecLeap — Generador de estructura Asana
+# Convierte CONTRATO.md → proyecto Asana con secciones y tareas
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PARSE_SCRIPT="$SCRIPT_DIR/parse-contrato.sh"
+ASANA_UTILS="$SCRIPT_DIR/lib/asana-utils.sh"
+
+# Colores
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+MAGENTA='\033[0;35m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+source "$PARSE_SCRIPT"
+source "$ASANA_UTILS"
+
+print_header() {
+    echo -e "${CYAN}${BOLD}"
+    echo "════════════════════════════════════════════════════════════════"
+    echo "  $(t 'asana.header')"
+    echo "════════════════════════════════════════════════════════════════"
+    echo -e "${RESET}"
+}
+
+print_section() {
+    echo -e "\n${MAGENTA}${BOLD}━━━ $1 ━━━${RESET}\n" >&2
+}
+
+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
+}
+
+usage() {
+    cat << EOF
+Uso: $(basename "$0") [OPCIONES]
+
+Genera estructura completa en Asana desde CONTRATO.md
+
+OPCIONES:
+    -p, --proyecto RUTA     Ruta al proyecto (default: directorio actual)
+    -n, --nombre NOMBRE     Nombre del proyecto en Asana (sobreescribe CONTRATO)
+    -d, --dry-run          Modo simulación (no crea nada en Asana)
+    -h, --help             Muestra esta ayuda
+
+EJEMPLOS:
+    # Desde directorio del proyecto:
+    $(basename "$0")
+
+    # Especificar proyecto:
+    $(basename "$0") -p ~/proyectos/mi-app
+
+    # Modo simulación:
+    $(basename "$0") --dry-run
+
+CONFIGURACIÓN:
+    Variables de entorno requeridas:
+    - ASANA_ACCESS_TOKEN: Token de API personal
+    - ASANA_WORKSPACE_GID: ID del workspace (opcional, se detecta automáticamente)
+
+EOF
+}
+
+# Parsear argumentos
+PROYECTO_DIR="$(pwd)"
+NOMBRE_PROYECTO=""
+DRY_RUN=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -p|--proyecto)
+            PROYECTO_DIR="$2"
+            shift 2
+            ;;
+        -n|--nombre)
+            NOMBRE_PROYECTO="$2"
+            shift 2
+            ;;
+        -d|--dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        *)
+            print_error "Opción desconocida: $1"
+            usage
+            exit 1
+            ;;
+    esac
+done
+
+# Verificar token
+if [[ -z "${ASANA_ACCESS_TOKEN:-}" ]]; then
+    print_error "ASANA_ACCESS_TOKEN no está configurado"
+    echo ""
+    echo "Configúralo en ~/.zshrc o ~/.bashrc:"
+    echo "  export ASANA_ACCESS_TOKEN=\"tu-token-aqui\""
+    exit 1
+fi
+
+# Verificar CONTRATO.md
+CONTRATO_PATH="$PROYECTO_DIR/CONTRATO.md"
+if [[ ! -f "$CONTRATO_PATH" ]]; then
+    print_error "No se encontró CONTRATO.md en: $PROYECTO_DIR"
+    exit 1
+fi
+
+print_header
+
+# Parsear CONTRATO.md
+print_section "Analizando CONTRATO.md"
+CONTRATO_JSON=$(parse_contrato "$CONTRATO_PATH")
+
+# Extraer datos básicos
+PROJECT_NAME=$(echo "$CONTRATO_JSON" | jq -r '.project_name // "Proyecto Sin Nombre"')
+if [[ -n "$NOMBRE_PROYECTO" ]]; then
+    PROJECT_NAME="$NOMBRE_PROYECTO"
+fi
+
+print_info "Proyecto: $PROJECT_NAME"
+
+# Obtener workspace si no está configurado
+if [[ -z "${ASANA_WORKSPACE_GID:-}" ]]; then
+    print_info "Detectando workspace..."
+    ASANA_WORKSPACE_GID=$(asana_get_default_workspace)
+    export ASANA_WORKSPACE_GID
+fi
+
+print_info "Workspace: $ASANA_WORKSPACE_GID"
+
+if [[ "$DRY_RUN" == true ]]; then
+    print_warning "Modo DRY-RUN: no se creará nada en Asana"
+fi
+
+# Crear proyecto en Asana
+print_section "Creando proyecto en Asana"
+
+if [[ "$DRY_RUN" == false ]]; then
+    PROJECT_GID=$(asana_create_project "$PROJECT_NAME")
+    print_success "Proyecto creado: $PROJECT_GID"
+else
+    PROJECT_GID="DRY-RUN-PROJECT-123"
+    print_info "Proyecto (simulado): $PROJECT_GID"
+fi
+
+# Generar épicas como secciones
+print_section "Generando estructura de secciones y tareas"
+
+EPIC_COUNT=0
+STORY_COUNT=0
+
+# Épica 1: Infraestructura
+EPIC_COUNT=$((EPIC_COUNT + 1))
+if [[ "$DRY_RUN" == false ]]; then
+    INFRA_SECTION=$(asana_create_section "$PROJECT_GID" "🛠️ Infraestructura")
+    print_success "Sección: Infraestructura"
+    
+    # Tareas de infraestructura
+    asana_create_task "$PROJECT_GID" "Setup inicial del proyecto" "$INFRA_SECTION" 3
+    asana_create_task "$PROJECT_GID" "Configurar CI/CD" "$INFRA_SECTION" 5
+    asana_create_task "$PROJECT_GID" "Configurar entornos (dev/staging/prod)" "$INFRA_SECTION" 3
+    STORY_COUNT=$((STORY_COUNT + 3))
+else
+    print_info "  📋 Sección: Infraestructura (3 tareas)"
+    STORY_COUNT=$((STORY_COUNT + 3))
+fi
+
+# Épica 2: Backend
+EPIC_COUNT=$((EPIC_COUNT + 1))
+if [[ "$DRY_RUN" == false ]]; then
+    BACKEND_SECTION=$(asana_create_section "$PROJECT_GID" "⚙️ Backend")
+    print_success "Sección: Backend"
+    
+    # Tareas de backend desde CONTRATO
+    FEATURES=$(echo "$CONTRATO_JSON" | jq -r '.features[]? // empty')
+    if [[ -n "$FEATURES" ]]; then
+        while IFS= read -r feature; do
+            asana_create_task "$PROJECT_GID" "Implementar: $feature" "$BACKEND_SECTION" 5
+            STORY_COUNT=$((STORY_COUNT + 1))
+        done <<< "$FEATURES"
+    else
+        asana_create_task "$PROJECT_GID" "Implementar API REST básica" "$BACKEND_SECTION" 8
+        asana_create_task "$PROJECT_GID" "Implementar autenticación" "$BACKEND_SECTION" 5
+        asana_create_task "$PROJECT_GID" "Implementar autorización (roles)" "$BACKEND_SECTION" 5
+        STORY_COUNT=$((STORY_COUNT + 3))
+    fi
+else
+    print_info "  📋 Sección: Backend (~5-8 tareas)"
+    STORY_COUNT=$((STORY_COUNT + 5))
+fi
+
+# Épica 3: Frontend
+EPIC_COUNT=$((EPIC_COUNT + 1))
+if [[ "$DRY_RUN" == false ]]; then
+    FRONTEND_SECTION=$(asana_create_section "$PROJECT_GID" "🎨 Frontend")
+    print_success "Sección: Frontend"
+    
+    asana_create_task "$PROJECT_GID" "Implementar sistema de diseño base" "$FRONTEND_SECTION" 8
+    asana_create_task "$PROJECT_GID" "Implementar autenticación UI" "$FRONTEND_SECTION" 5
+    asana_create_task "$PROJECT_GID" "Implementar navegación principal" "$FRONTEND_SECTION" 3
+    STORY_COUNT=$((STORY_COUNT + 3))
+else
+    print_info "  📋 Sección: Frontend (3 tareas)"
+    STORY_COUNT=$((STORY_COUNT + 3))
+fi
+
+# Épica 4: Testing
+EPIC_COUNT=$((EPIC_COUNT + 1))
+if [[ "$DRY_RUN" == false ]]; then
+    TESTING_SECTION=$(asana_create_section "$PROJECT_GID" "🧪 Testing")
+    print_success "Sección: Testing"
+    
+    asana_create_task "$PROJECT_GID" "Tests unitarios backend (>=90% coverage)" "$TESTING_SECTION" 5
+    asana_create_task "$PROJECT_GID" "Tests E2E críticos" "$TESTING_SECTION" 5
+    asana_create_task "$PROJECT_GID" "Tests de integración" "$TESTING_SECTION" 3
+    STORY_COUNT=$((STORY_COUNT + 3))
+else
+    print_info "  📋 Sección: Testing (3 tareas)"
+    STORY_COUNT=$((STORY_COUNT + 3))
+fi
+
+# Resumen final
+print_section "Resumen"
+echo -e "${BOLD}Proyecto:${RESET} $PROJECT_NAME"
+echo -e "${BOLD}Secciones creadas:${RESET} $EPIC_COUNT"
+echo -e "${BOLD}Tareas creadas:${RESET} $STORY_COUNT"
+
+if [[ "$DRY_RUN" == false ]]; then
+    echo -e "\n${GREEN}${BOLD}✅ Estructura generada exitosamente en Asana${RESET}"
+    echo -e "\n📊 Ver proyecto: https://app.asana.com/0/$PROJECT_GID"
+else
+    echo -e "\n${YELLOW}${BOLD}ℹ️  Modo DRY-RUN: ningún cambio realizado${RESET}"
+    echo -e "Ejecuta sin --dry-run para crear la estructura real"
+fi
+
+echo ""

package/scripts/generate-contract.sh

@@ -0,0 +1,360 @@
+#!/bin/bash
+# generate-contract.sh
+# Genera CONTRATO.md desde archivo de respuestas YAML
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SPECLEAP_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+RESPONSES_FILE="${1:-}"
+OUTPUT_DIR="${2:-}"
+
+if [[ -z "$RESPONSES_FILE" || ! -f "$RESPONSES_FILE" ]]; then
+    echo "❌ Error: Archivo de respuestas no encontrado"
+    echo "Uso: $0 <responses.yaml> [output_dir]"
+    exit 1
+fi
+
+# Colores
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}📝 Generando CONTRATO.md desde respuestas...${NC}"
+echo ""
+
+# Extraer PROJECT_NAME
+PROJECT_NAME=$(grep "^project_name:" "$RESPONSES_FILE" | cut -d: -f2 | xargs)
+
+if [[ -z "$PROJECT_NAME" ]]; then
+    echo "❌ Error: project_name no encontrado en respuestas"
+    exit 1
+fi
+
+# Determinar OUTPUT_DIR si no se especificó
+if [[ -z "$OUTPUT_DIR" ]]; then
+    OUTPUT_DIR="$SPECLEAP_ROOT/proyectos/$PROJECT_NAME"
+fi
+
+# Crear directorio del proyecto
+mkdir -p "$OUTPUT_DIR"
+mkdir -p "$OUTPUT_DIR/context"
+mkdir -p "$OUTPUT_DIR/memory-bank"
+
+# Copiar template
+TEMPLATE="$SPECLEAP_ROOT/proyectos/_template/CONTRATO.md"
+OUTPUT_CONTRACT="$OUTPUT_DIR/CONTRATO.md"
+
+if [[ ! -f "$TEMPLATE" ]]; then
+    echo "❌ Error: Template CONTRATO.md no encontrado en $TEMPLATE"
+    exit 1
+fi
+
+echo -e "${GREEN}✓${NC} Copiando template..."
+cp "$TEMPLATE" "$OUTPUT_CONTRACT"
+
+# ===== FUNCIÓN: Reemplazar placeholders =====
+replace_placeholder() {
+    local key="$1"
+    local value="$2"
+    local file="$3"
+    
+    # Escapar caracteres especiales en value
+    value=$(echo "$value" | sed 's/[&/\]/\\&/g')
+    
+    # Reemplazar en el archivo
+    sed -i '' "s/{{ $key }}/$value/g" "$file"
+}
+
+# ===== EXTRAER VALORES DEL YAML =====
+echo -e "${GREEN}✓${NC} Extrayendo valores..."
+
+# Función para extraer valores del YAML
+get_yaml_value() {
+    local key="$1"
+    grep "^$key:" "$RESPONSES_FILE" | cut -d: -f2- | xargs
+}
+
+# Valores básicos
+PROJECT_DISPLAY_NAME=$(get_yaml_value "project_display_name")
+PROJECT_OBJECTIVE=$(get_yaml_value "project_objective")
+PROBLEM_SOLVED=$(get_yaml_value "problem_solved")
+TARGET_AUDIENCE=$(get_yaml_value "target_audience")
+COMPETITORS=$(get_yaml_value "competitors")
+BACKEND_FRAMEWORK=$(get_yaml_value "backend_framework")
+FRONTEND_FRAMEWORK=$(get_yaml_value "frontend_framework")
+DATABASE=$(get_yaml_value "database")
+HOSTING=$(get_yaml_value "hosting")
+VISUAL_STYLE=$(get_yaml_value "visual_style")
+TIME_LIMIT=$(get_yaml_value "time_limit")
+
+# Fecha actual
+CREATED_AT=$(date +%Y-%m-%d)
+
+# ===== GENERAR FRONTMATTER YAML =====
+echo -e "${GREEN}✓${NC} Generando frontmatter..."
+
+# Crear archivo temporal con el frontmatter
+TEMP_FRONTMATTER=$(mktemp)
+
+cat > "$TEMP_FRONTMATTER" << EOF
+---
+# ===== METADATA (Parseable por scripts) =====
+project:
+  name: "$PROJECT_NAME"
+  display_name: "$PROJECT_DISPLAY_NAME"
+  created_at: "$CREATED_AT"
+  status: draft
+  version: "1.0"
+  responsible: ""
+  
+identity:
+  objective: "$PROJECT_OBJECTIVE"
+  problem_solved: "$PROBLEM_SOLVED"
+  target_audience: "$TARGET_AUDIENCE"
+  competitors: "$COMPETITORS"
+  
+stack:
+  backend:
+    framework: "$BACKEND_FRAMEWORK"
+    language: ""
+    version: ""
+  frontend:
+    framework: "$FRONTEND_FRAMEWORK"
+    language: ""
+    build_tool: ""
+    ui_library: ""
+  database:
+    engine: "$DATABASE"
+    version: ""
+  devops:
+    hosting: "$HOSTING"
+    ci_cd: ""
+    containers: ""
+    
+features:
+  core: []
+  secondary: []
+  auth:
+    enabled: false
+    methods: []
+    two_factor: false
+  admin_panel:
+    enabled: false
+    level: ""
+  file_uploads:
+    enabled: false
+    storage: ""
+  payments:
+    enabled: false
+    providers: []
+  notifications:
+    email: false
+    push: false
+    in_app: false
+    
+users:
+  registration: false
+  roles: []
+  
+design:
+  color_palette: ""
+  primary_color: ""
+  secondary_color: ""
+  accent_color: ""
+  visual_style: "$VISUAL_STYLE"
+  dark_mode: false
+  responsive: true
+  
+architecture:
+  pattern: "mvc"
+  separation: "monolith"
+  
+deployment:
+  ssl: true
+  custom_domain: ""
+  environments: []
+  
+security:
+  level: "basic"
+  gdpr_compliant: false
+  sensitive_data: false
+  
+performance:
+  load_time_target: ""
+  api_response_target: ""
+  concurrent_users: 0
+  
+testing:
+  unit: false
+  integration: false
+  e2e: false
+  coverage_target: 0
+  
+constraints:
+  time_limit: "$TIME_LIMIT"
+  budget_limit: ""
+  out_of_scope: []
+  
+jira:
+  project_key: ""
+  epic_count: 0
+  story_count: 0
+  synced_at: ""
+---
+EOF
+
+# Reemplazar el frontmatter en el CONTRATO
+# (Eliminar frontmatter del template y agregar el nuevo)
+sed -i '' '1,/^---$/d' "$OUTPUT_CONTRACT"  # Eliminar primera sección ---
+sed -i '' '1,/^---$/d' "$OUTPUT_CONTRACT"  # Eliminar segunda sección ---
+
+# Agregar nuevo frontmatter al inicio
+cat "$TEMP_FRONTMATTER" "$OUTPUT_CONTRACT" > "${OUTPUT_CONTRACT}.tmp"
+mv "${OUTPUT_CONTRACT}.tmp" "$OUTPUT_CONTRACT"
+
+rm "$TEMP_FRONTMATTER"
+
+# ===== REEMPLAZAR PLACEHOLDERS EN MARKDOWN =====
+echo -e "${GREEN}✓${NC} Reemplazando placeholders..."
+
+# Reemplazos básicos (los que no están en frontmatter)
+sed -i '' "s/{{ project.name }}/$PROJECT_NAME/g" "$OUTPUT_CONTRACT"
+sed -i '' "s/{{ project.display_name }}/$PROJECT_DISPLAY_NAME/g" "$OUTPUT_CONTRACT"
+sed -i '' "s/{{ project.created_at }}/$CREATED_AT/g" "$OUTPUT_CONTRACT"
+sed -i '' "s/{{ identity.objective }}/$PROJECT_OBJECTIVE/g" "$OUTPUT_CONTRACT"
+
+# ===== GENERAR ARCHIVOS CONTEXT =====
+echo -e "${GREEN}✓${NC} Generando archivos context..."
+
+# brief.md
+cat > "$OUTPUT_DIR/context/brief.md" << EOF
+# Brief — $PROJECT_DISPLAY_NAME
+
+**Fecha:** $CREATED_AT
+
+## Resumen Ejecutivo
+
+$PROJECT_OBJECTIVE
+
+## Problema
+
+$PROBLEM_SOLVED
+
+## Público Objetivo
+
+$TARGET_AUDIENCE
+
+## Competencia / Referencias
+
+$COMPETITORS
+
+## Stack Tecnológico
+
+- **Backend:** $BACKEND_FRAMEWORK
+- **Frontend:** $FRONTEND_FRAMEWORK
+- **Base de Datos:** $DATABASE
+- **Hosting:** $HOSTING
+EOF
+
+# architecture.md (placeholder)
+cat > "$OUTPUT_DIR/context/architecture.md" << EOF
+# Arquitectura — $PROJECT_DISPLAY_NAME
+
+## Patrón de Arquitectura
+
+MVC (Model-View-Controller)
+
+## Capas
+
+- **Presentation:** Controllers, Views, Components
+- **Application:** Services, Use Cases
+- **Domain:** Models, Business Logic
+- **Infrastructure:** Database, External APIs
+
+## Decisiones Arquitectónicas
+
+[Se irán documentando durante el desarrollo]
+EOF
+
+# tech-stack.md
+cat > "$OUTPUT_DIR/context/tech-stack.md" << EOF
+# Stack Tecnológico — $PROJECT_DISPLAY_NAME
+
+## Backend
+
+**Framework:** $BACKEND_FRAMEWORK
+
+**Justificación:** [A definir]
+
+## Frontend
+
+**Framework:** $FRONTEND_FRAMEWORK
+
+**Justificación:** [A definir]
+
+## Base de Datos
+
+**Motor:** $DATABASE
+
+**Justificación:** [A definir]
+
+## Hosting
+
+**Proveedor:** $HOSTING
+
+**Justificación:** [A definir]
+EOF
+
+# conventions.md (placeholder)
+cat > "$OUTPUT_DIR/context/conventions.md" << EOF
+# Convenciones — $PROJECT_DISPLAY_NAME
+
+## Nomenclatura
+
+[A definir según el stack]
+
+## Estructura de Archivos
+
+[A definir]
+
+## Patrones de Código
+
+[A definir]
+EOF
+
+# decisions.md (vacío, se llena durante desarrollo)
+cat > "$OUTPUT_DIR/context/decisions.md" << EOF
+# Log de Decisiones — $PROJECT_DISPLAY_NAME
+
+## Formato
+
+Cada decisión sigue el formato ADR (Architecture Decision Record):
+
+### [YYYY-MM-DD] Título de la Decisión
+
+**Estado:** Propuesta | Aceptada | Rechazada | Obsoleta
+
+**Contexto:** ¿Por qué necesitamos tomar esta decisión?
+
+**Decisión:** ¿Qué decidimos?
+
+**Consecuencias:** ¿Qué implica esta decisión?
+
+---
+
+EOF
+
+echo ""
+echo -e "${GREEN}✅ CONTRATO.md generado exitosamente${NC}"
+echo ""
+echo -e "${BLUE}📁 Archivos creados:${NC}"
+echo "  - $OUTPUT_CONTRACT"
+echo "  - $OUTPUT_DIR/context/brief.md"
+echo "  - $OUTPUT_DIR/context/architecture.md"
+echo "  - $OUTPUT_DIR/context/tech-stack.md"
+echo "  - $OUTPUT_DIR/context/conventions.md"
+echo "  - $OUTPUT_DIR/context/decisions.md"
+echo ""
+echo -e "${YELLOW}Siguiente paso:${NC} Revisar y refinar el CONTRATO con /refinar"