specleap-framework 2.0.0

package/scripts/lib/render-contrato.py

@@ -0,0 +1,195 @@
+#!/usr/bin/env python3
+"""
+ArchSpec — Renderizador de CONTRATO.md
+Convierte respuestas planas (project.name) a estructura anidada y renderiza con Jinja2
+"""
+
+import json
+import sys
+from datetime import datetime
+from jinja2 import Environment, FileSystemLoader
+import re
+
+def flatten_to_nested(flat_dict):
+    """
+    Convierte dict plano {'project.name': 'foo'} a anidado {'project': {'name': 'foo'}}
+    """
+    nested = {}
+    
+    for key, value in flat_dict.items():
+        parts = key.split('.')
+        current = nested
+        
+        for i, part in enumerate(parts):
+            if i == len(parts) - 1:
+                # Último nivel, asignar valor
+                current[part] = value
+            else:
+                # Crear nivel intermedio si no existe
+                if part not in current:
+                    current[part] = {}
+                current = current[part]
+    
+    return nested
+
+def convert_string_to_type(value, expected_type):
+    """
+    Convierte strings a su tipo apropiado (bool, int, array)
+    """
+    if expected_type == 'boolean':
+        if isinstance(value, bool):
+            return value
+        return value.lower() in ['true', '1', 'yes', 's', 'si']
+    
+    if expected_type == 'number':
+        try:
+            return int(value)
+        except:
+            return 0
+    
+    if expected_type == 'array':
+        if isinstance(value, list):
+            return value
+        # Si es string vacío, devolver array vacío
+        if value == "":
+            return []
+        # Si es JSON array string
+        if isinstance(value, str) and value.startswith('['):
+            try:
+                return json.loads(value)
+            except:
+                return []
+        return [value]
+    
+    return value
+
+def normalize_answers(answers_flat, questions_meta):
+    """
+    Normaliza respuestas según metadata de preguntas (tipos, defaults)
+    """
+    normalized = {}
+    
+    for q in questions_meta:
+        q_id = q['id']
+        q_type = q['type']
+        q_default = q.get('default', None)
+        
+        # Obtener valor o usar default
+        value = answers_flat.get(q_id, q_default)
+        
+        # Convertir a tipo apropiado
+        if value is not None:
+            value = convert_string_to_type(value, q_type)
+        
+        normalized[q_id] = value
+    
+    return normalized
+
+def add_computed_fields(nested_dict):
+    """
+    Agrega campos computados (fecha actual, contadores, etc.)
+    """
+    # Agregar fecha actual si no existe
+    if 'project' in nested_dict:
+        if not nested_dict['project'].get('created_at'):
+            nested_dict['project']['created_at'] = datetime.now().strftime('%Y-%m-%d')
+        
+        if not nested_dict['project'].get('status'):
+            nested_dict['project']['status'] = 'draft'
+        
+        if not nested_dict['project'].get('version'):
+            nested_dict['project']['version'] = '1.0'
+    
+    # Contar features
+    if 'features' in nested_dict and 'core' in nested_dict['features']:
+        core_count = len(nested_dict['features']['core']) if nested_dict['features']['core'] else 0
+        nested_dict['_computed'] = {'core_count': core_count}
+    
+    return nested_dict
+
+def main():
+    if len(sys.argv) < 4:
+        print("Uso: render-contrato.py <answers.json> <questions.json> <template.md> [output.md]")
+        sys.exit(1)
+    
+    answers_file = sys.argv[1]
+    questions_file = sys.argv[2]
+    template_file = sys.argv[3]
+    output_file = sys.argv[4] if len(sys.argv) > 4 else None
+    
+    # Leer archivos
+    with open(answers_file, 'r') as f:
+        answers_flat = json.load(f)
+    
+    with open(questions_file, 'r') as f:
+        questions_data = json.load(f)
+        questions_meta = questions_data['questions']
+    
+    # Normalizar respuestas según tipos
+    answers_normalized = normalize_answers(answers_flat, questions_meta)
+    
+    # Convertir plano a anidado
+    answers_nested = flatten_to_nested(answers_normalized)
+    
+    # Agregar campos computados
+    answers_nested = add_computed_fields(answers_nested)
+    
+    # Configurar Jinja2
+    template_dir = '/'.join(template_file.split('/')[:-1])
+    template_name = template_file.split('/')[-1]
+    
+    env = Environment(
+        loader=FileSystemLoader(template_dir),
+        trim_blocks=True,
+        lstrip_blocks=True,
+        keep_trailing_newline=True
+    )
+    
+    # Leer template (separar YAML frontmatter del contenido Jinja2)
+    with open(template_file, 'r') as f:
+        template_content = f.read()
+    
+    # Convertir placeholders tipo {VAR} a sintaxis Jinja2 {{ var }} para templates legacy
+    # Solo si no es el template principal (que ya usa Jinja2)
+    if 'LEGACY' in template_file or '{PROJECT_NAME}' in template_content:
+        import re
+        # Convertir {VAR_NAME} -> {{ var_name }}
+        def convert_placeholder(match):
+            var_name = match.group(1).lower().replace('_', '.')
+            return '{{ ' + var_name + ' }}'
+        template_content = re.sub(r'\{([A-Z_]+)\}', convert_placeholder, template_content)
+    
+    # Detectar frontmatter YAML
+    if template_content.startswith('---'):
+        parts = template_content.split('---', 2)
+        if len(parts) >= 3:
+            yaml_front = parts[1]
+            jinja_content = parts[2]
+        else:
+            yaml_front = ""
+            jinja_content = template_content
+    else:
+        yaml_front = ""
+        jinja_content = template_content
+    
+    # Renderizar YAML frontmatter
+    yaml_template = env.from_string(yaml_front)
+    yaml_rendered = yaml_template.render(**answers_nested)
+    
+    # Renderizar contenido Jinja2
+    content_template = env.from_string(jinja_content)
+    content_rendered = content_template.render(**answers_nested)
+    
+    # Combinar
+    final_output = f"---\n{yaml_rendered}---{content_rendered}"
+    
+    # Escribir output
+    if output_file:
+        with open(output_file, 'w') as f:
+            f.write(final_output)
+        print(f"✅ CONTRATO.md generado: {output_file}")
+    else:
+        print(final_output)
+
+if __name__ == '__main__':
+    main()

package/scripts/lib/validate.sh

@@ -0,0 +1,325 @@
+#!/usr/bin/env bash
+
+# SpecLeap — Funciones de validación avanzadas
+# Fase 2.2
+
+# ============================================================================
+# VALIDACIONES POR TIPO
+# ============================================================================
+
+validate_string_advanced() {
+    local value="$1"
+    local pattern="${2:-}"
+    local min_length="${3:-0}"
+    local max_length="${4:-999999}"
+    
+    local length=${#value}
+    
+    # Validar longitud mínima
+    if [[ $length -lt $min_length ]]; then
+        echo "ERROR:Debe tener al menos $min_length caracteres (actualmente: $length)"
+        return 1
+    fi
+    
+    # Validar longitud máxima
+    if [[ $length -gt $max_length ]]; then
+        echo "ERROR:Debe tener máximo $max_length caracteres (actualmente: $length)"
+        return 1
+    fi
+    
+    # Validar patrón regex
+    if [[ -n "$pattern" ]] && ! [[ "$value" =~ $pattern ]]; then
+        case "$pattern" in
+            '^[a-z0-9-]+$')
+                echo "ERROR:Solo se permiten letras minúsculas, números y guiones (sin espacios ni mayúsculas)"
+                ;;
+            '^#[0-9A-Fa-f]{6}$')
+                echo "ERROR:Debe ser un código hexadecimal válido (ejemplo: #3B82F6)"
+                ;;
+            *)
+                echo "ERROR:Formato inválido"
+                ;;
+        esac
+        return 1
+    fi
+    
+    return 0
+}
+
+validate_select_strict() {
+    local value="$1"
+    shift
+    local options=("$@")
+    
+    # Normalizar a minúsculas para comparación
+    local value_lower="${value,,}"
+    
+    for opt in "${options[@]}"; do
+        if [[ "${opt,,}" == "$value_lower" ]]; then
+            # Devolver el valor normalizado (minúsculas)
+            echo "$opt"
+            return 0
+        fi
+    done
+    
+    echo "ERROR:Opción inválida. Opciones válidas: ${options[*]}"
+    return 1
+}
+
+validate_multiselect() {
+    local value="$1"
+    shift
+    local valid_options=("$@")
+    
+    # Si está vacío, es válido (si no es required)
+    if [[ -z "$value" ]]; then
+        return 0
+    fi
+    
+    # Separar por comas
+    IFS=',' read -ra selected <<< "$value"
+    
+    for item in "${selected[@]}"; do
+        # Trim espacios
+        item="$(echo "$item" | xargs)"
+        item_lower="${item,,}"
+        
+        local found=false
+        for opt in "${valid_options[@]}"; do
+            if [[ "${opt,,}" == "$item_lower" ]]; then
+                found=true
+                break
+            fi
+        done
+        
+        if [[ "$found" == false ]]; then
+            echo "ERROR:Opción inválida '$item'. Opciones válidas: ${valid_options[*]}"
+            return 1
+        fi
+    done
+    
+    return 0
+}
+
+validate_boolean_strict() {
+    local value="$1"
+    
+    case "${value,,}" in
+        true|s|si|yes|y|1)
+            echo "true"
+            return 0
+            ;;
+        false|n|no|0)
+            echo "false"
+            return 0
+            ;;
+        *)
+            echo "ERROR:Respuesta inválida. Usa: s/n, true/false, yes/no, 1/0"
+            return 1
+            ;;
+    esac
+}
+
+validate_number_range() {
+    local value="$1"
+    local min="${2:-0}"
+    local max="${3:-999999999}"
+    
+    # Validar que sea número
+    if ! [[ "$value" =~ ^[0-9]+$ ]]; then
+        echo "ERROR:Debe ser un número entero"
+        return 1
+    fi
+    
+    # Validar rango
+    if [[ $value -lt $min ]]; then
+        echo "ERROR:Debe ser al menos $min"
+        return 1
+    fi
+    
+    if [[ $value -gt $max ]]; then
+        echo "ERROR:Debe ser máximo $max"
+        return 1
+    fi
+    
+    return 0
+}
+
+validate_array_items() {
+    local value="$1"
+    local min_items="${2:-0}"
+    local max_items="${3:-999}"
+    local separator="${4:-,}"
+    
+    # Contar items
+    if [[ -z "$value" ]]; then
+        local count=0
+    else
+        IFS="$separator" read -ra items <<< "$value"
+        local count=${#items[@]}
+    fi
+    
+    if [[ $count -lt $min_items ]]; then
+        echo "ERROR:Debes proporcionar al menos $min_items elemento(s)"
+        return 1
+    fi
+    
+    if [[ $count -gt $max_items ]]; then
+        echo "ERROR:Puedes proporcionar máximo $max_items elemento(s)"
+        return 1
+    fi
+    
+    return 0
+}
+
+# ============================================================================
+# CONDICIONES Y DEPENDENCIAS
+# ============================================================================
+
+should_skip_question() {
+    local skip_if_json="$1"
+    local answers_file="$2"
+    
+    # Si no hay skip_if, no skipear
+    if [[ "$skip_if_json" == "null" ]] || [[ -z "$skip_if_json" ]]; then
+        return 1
+    fi
+    
+    # Extraer campo y valor esperado
+    local skip_field=$(echo "$skip_if_json" | jq -r 'keys[0]')
+    local skip_value=$(echo "$skip_if_json" | jq -r '.[]')
+    
+    # Obtener valor actual del campo
+    local current_value=$(jq -r ".\"$skip_field\" // \"\"" "$answers_file")
+    
+    # Si el valor actual coincide con el valor de skip, saltamos
+    if [[ "$current_value" == "$skip_value" ]]; then
+        return 0  # Sí, skipear
+    fi
+    
+    return 1  # No skipear
+}
+
+get_auto_suggest() {
+    local auto_suggest_json="$1"
+    local dependent_field="$2"
+    local answers_file="$3"
+    
+    # Si no hay auto_suggest, devolver vacío
+    if [[ "$auto_suggest_json" == "null" ]] || [[ -z "$auto_suggest_json" ]]; then
+        echo ""
+        return
+    fi
+    
+    # Obtener valor del campo del que depende
+    local dep_value=$(jq -r ".\"$dependent_field\" // \"\"" "$answers_file")
+    
+    # Obtener sugerencia basada en ese valor
+    local suggestion=$(echo "$auto_suggest_json" | jq -r ".\"$dep_value\" // \"\"")
+    
+    echo "$suggestion"
+}
+
+# ============================================================================
+# VALIDADOR PRINCIPAL
+# ============================================================================
+
+validate_answer() {
+    local value="$1"
+    local question_json="$2"
+    local answers_file="$3"
+    
+    local q_type=$(echo "$question_json" | jq -r '.type')
+    local q_required=$(echo "$question_json" | jq -r '.required')
+    local q_validation=$(echo "$question_json" | jq -r '.validation // {}')
+    local q_options=$(echo "$question_json" | jq -r '.options // [] | join(" ")')
+    
+    # Si es vacío y no es requerido, OK
+    if [[ -z "$value" ]] && [[ "$q_required" == "false" ]]; then
+        echo "OK"
+        return 0
+    fi
+    
+    # Si es vacío y es requerido, ERROR
+    if [[ -z "$value" ]] && [[ "$q_required" == "true" ]]; then
+        echo "ERROR:Esta pregunta es obligatoria"
+        return 1
+    fi
+    
+    # Validar según tipo
+    case "$q_type" in
+        string)
+            local pattern=$(echo "$q_validation" | jq -r '.pattern // ""')
+            local min_length=$(echo "$q_validation" | jq -r '.min_length // 0')
+            local max_length=$(echo "$q_validation" | jq -r '.max_length // 999999')
+            
+            if ! validate_string_advanced "$value" "$pattern" "$min_length" "$max_length"; then
+                return 1
+            fi
+            echo "OK"
+            ;;
+            
+        text)
+            local max_length=$(echo "$q_validation" | jq -r '.max_length // 999999')
+            
+            if ! validate_string_advanced "$value" "" "0" "$max_length"; then
+                return 1
+            fi
+            echo "OK"
+            ;;
+            
+        select)
+            local opts_array=($(echo "$q_options"))
+            local result
+            if ! result=$(validate_select_strict "$value" "${opts_array[@]}"); then
+                echo "$result"
+                return 1
+            fi
+            echo "OK:$result"
+            ;;
+            
+        multiselect)
+            local opts_array=($(echo "$q_options"))
+            if ! validate_multiselect "$value" "${opts_array[@]}"; then
+                return 1
+            fi
+            echo "OK"
+            ;;
+            
+        boolean)
+            local result
+            if ! result=$(validate_boolean_strict "$value"); then
+                echo "$result"
+                return 1
+            fi
+            echo "OK:$result"
+            ;;
+            
+        number)
+            local min=$(echo "$q_validation" | jq -r '.min // 0')
+            local max=$(echo "$q_validation" | jq -r '.max // 999999999')
+            
+            if ! validate_number_range "$value" "$min" "$max"; then
+                return 1
+            fi
+            echo "OK"
+            ;;
+            
+        array)
+            local min_items=$(echo "$q_validation" | jq -r '.min_items // 0')
+            local max_items=$(echo "$q_validation" | jq -r '.max_items // 999')
+            local separator=$(echo "$q_validation" | jq -r '.separator // ","')
+            
+            if ! validate_array_items "$value" "$min_items" "$max_items" "$separator"; then
+                return 1
+            fi
+            echo "OK"
+            ;;
+            
+        *)
+            echo "OK"
+            ;;
+    esac
+    
+    return 0
+}

package/scripts/parse-contrato.sh

@@ -0,0 +1,190 @@
+#!/usr/bin/env bash
+
+# Cargar sistema i18n
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../.specleap/i18n.sh"
+
+# SpecLeap — Parser CONTRATO.md → JSON
+# Extrae YAML frontmatter y lo convierte a JSON para procesamiento
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Colores
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+CYAN='\033[0;36m'
+RESET='\033[0m'
+
+print_error() {
+    echo -e "${RED}$(t "scripts.error"): $1${RESET}" >&2
+}
+
+print_success() {
+    echo -e "${GREEN}$(t "scripts.success") $1${RESET}" >&2
+}
+
+print_info() {
+    echo -e "${CYAN}$(t "scripts.info") $1${RESET}" >&2
+}
+
+# ============================================================================
+# PARSER
+# ============================================================================
+
+parse_contrato() {
+    local contrato_file="$1"
+    local output_file="${2:-}"
+    
+    if [[ ! -f "$contrato_file" ]]; then
+        print_error "Archivo no encontrado: $contrato_file"
+        return 1
+    fi
+    
+    # Verificar que yq esté instalado
+    if ! command -v yq &> /dev/null; then
+        print_error "yq no está instalado. Instala con: brew install yq"
+        return 1
+    fi
+    
+    print_info "Parseando $contrato_file..."
+    
+    # Extraer solo el YAML frontmatter (entre --- ---)
+    # Usa awk para capturar solo el primer bloque entre --- (líneas 2 hasta el segundo ---)
+    local json_output
+    if json_output=$(awk '/^---$/{if(++n==2) exit; next} n==1' "$contrato_file" | yq eval -o=json '.' - 2>/dev/null); then
+        if [[ -n "$output_file" ]]; then
+            echo "$json_output" > "$output_file"
+            print_success "JSON exportado a: $output_file"
+        else
+            echo "$json_output"
+        fi
+        return 0
+    else
+        print_error "Fallo al parsear YAML frontmatter"
+        return 1
+    fi
+}
+
+# ============================================================================
+# VALIDACIÓN
+# ============================================================================
+
+validate_contrato() {
+    local contrato_file="$1"
+    
+    print_info "Validando estructura CONTRATO.md..."
+    
+    # Parsear a JSON
+    local json
+    if ! json=$(parse_contrato "$contrato_file"); then
+        return 1
+    fi
+    
+    # Validar campos obligatorios
+    local required_fields=(
+        ".project.name"
+        ".project.display_name"
+        ".identity.objective"
+        ".identity.problem_solved"
+        ".stack.backend.framework"
+        ".features.core"
+    )
+    
+    local errors=0
+    
+    for field in "${required_fields[@]}"; do
+        local value=$(echo "$json" | jq -r "$field // empty")
+        if [[ -z "$value" ]] || [[ "$value" == "null" ]]; then
+            print_error "Campo obligatorio faltante: $field"
+            errors=$((errors + 1))
+        fi
+    done
+    
+    if [[ $errors -eq 0 ]]; then
+        print_success "CONTRATO válido"
+        return 0
+    else
+        print_error "CONTRATO inválido: $errors campos faltantes"
+        return 1
+    fi
+}
+
+# ============================================================================
+# EXTRACCIÓN DE CAMPOS ESPECÍFICOS
+# ============================================================================
+
+get_project_name() {
+    local contrato_file="$1"
+    parse_contrato "$contrato_file" | jq -r '.project.name'
+}
+
+get_core_features() {
+    local contrato_file="$1"
+    parse_contrato "$contrato_file" | jq -r '.features.core[]'
+}
+
+get_backend_framework() {
+    local contrato_file="$1"
+    parse_contrato "$contrato_file" | jq -r '.stack.backend.framework'
+}
+
+get_frontend_framework() {
+    local contrato_file="$1"
+    parse_contrato "$contrato_file" | jq -r '.stack.frontend.framework'
+}
+
+# ============================================================================
+# MAIN
+# ============================================================================
+
+main() {
+    local command="${1:-parse}"
+    local contrato_file="${2:-}"
+    local output_file="${3:-}"
+    
+    case "$command" in
+        parse)
+            if [[ -z "$contrato_file" ]]; then
+                echo "Uso: $0 parse <CONTRATO.md> [output.json]"
+                exit 1
+            fi
+            parse_contrato "$contrato_file" "$output_file"
+            ;;
+        validate)
+            if [[ -z "$contrato_file" ]]; then
+                echo "Uso: $0 validate <CONTRATO.md>"
+                exit 1
+            fi
+            validate_contrato "$contrato_file"
+            ;;
+        get-name)
+            if [[ -z "$contrato_file" ]]; then
+                echo "Uso: $0 get-name <CONTRATO.md>"
+                exit 1
+            fi
+            get_project_name "$contrato_file"
+            ;;
+        get-features)
+            if [[ -z "$contrato_file" ]]; then
+                echo "Uso: $0 get-features <CONTRATO.md>"
+                exit 1
+            fi
+            get_core_features "$contrato_file"
+            ;;
+        *)
+            echo "Comandos disponibles:"
+            echo "  parse      <CONTRATO.md> [output.json]  — Parsear YAML → JSON"
+            echo "  validate   <CONTRATO.md>                — Validar estructura"
+            echo "  get-name   <CONTRATO.md>                — Obtener nombre proyecto"
+            echo "  get-features <CONTRATO.md>              — Listar features core"
+            exit 1
+            ;;
+    esac
+}
+
+# Ejecutar si se llama directamente
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi