specleap-framework 2.1.0 → 2.1.5

package/openspec/cli/report.sh

@@ -0,0 +1,244 @@
+#!/usr/bin/env bash
+# openspec report — Generar testing report
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+source "$SCRIPT_DIR/common.sh"
+
+usage() {
+    cat <<EOF
+openspec report — Generar testing report
+
+USAGE:
+    openspec report [CHANGE-ID] [options]
+
+OPTIONS:
+    --format <fmt>      Formato de salida (markdown|json|text)
+    --output <file>     Archivo de salida (default: STDOUT)
+    -h, --help          Mostrar ayuda
+
+DESCRIPTION:
+    Genera un Testing Report automáticamente desde resultados de tests:
+    - Ejecuta suite de tests
+    - Parsea resultados (PHPUnit, Jest, etc.)
+    - Genera reporte en formato especificado
+    - Actualiza tasks.md si se proporciona CHANGE-ID
+
+EXAMPLES:
+    openspec report
+    openspec report CHANGE-001
+    openspec report --format json --output report.json
+    openspec report CHANGE-002 --format markdown
+
+OUTPUT (markdown):
+    ## Testing Report
+    | Suite | Tests | Passed | Failed | Coverage |
+    |-------|-------|--------|--------|----------|
+    | Unit | X | X | 0 | XX% |
+
+EOF
+}
+
+# Parse arguments
+CHANGE_ID=""
+FORMAT="markdown"
+OUTPUT_FILE=""
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        --format)
+            FORMAT="$2"
+            shift 2
+            ;;
+        --output)
+            OUTPUT_FILE="$2"
+            shift 2
+            ;;
+        CHANGE-*)
+            CHANGE_ID="$1"
+            shift
+            ;;
+        *)
+            error "Argumento desconocido: $1"
+            usage
+            exit 1
+            ;;
+    esac
+done
+
+validate_project
+
+info "Generando Testing Report..."
+
+# Detect and run tests
+UNIT_TESTS=0
+UNIT_PASSED=0
+UNIT_FAILED=0
+UNIT_COVERAGE="N/A"
+
+INTEGRATION_TESTS=0
+INTEGRATION_PASSED=0
+INTEGRATION_FAILED=0
+
+E2E_TESTS=0
+E2E_PASSED=0
+E2E_FAILED=0
+
+# PHPUnit
+if [[ -f "$PROJECT_ROOT/phpunit.xml" ]] || [[ -f "$PROJECT_ROOT/phpunit.xml.dist" ]]; then
+    step "Ejecutando PHPUnit..."
+    
+    PHPUNIT_CMD="${PROJECT_ROOT}/vendor/bin/phpunit"
+    [[ ! -f "$PHPUNIT_CMD" ]] && PHPUNIT_CMD="phpunit"
+    
+    if command -v "$PHPUNIT_CMD" &> /dev/null || [[ -f "$PHPUNIT_CMD" ]]; then
+        TEST_OUTPUT=$($PHPUNIT_CMD --testdox --coverage-text 2>&1 || true)
+        
+        # Parse results
+        UNIT_TESTS=$(echo "$TEST_OUTPUT" | grep -oP '\d+(?= tests?)' | head -n1 || echo "0")
+        UNIT_PASSED=$(echo "$TEST_OUTPUT" | grep -oP 'OK \(\K\d+(?= test)' || echo "$UNIT_TESTS")
+        UNIT_FAILED=$(echo "$TEST_OUTPUT" | grep -oP 'FAILURES!\s+Tests:\s+\d+,\s+Assertions:\s+\d+,\s+Failures:\s+\K\d+' || echo "0")
+        UNIT_COVERAGE=$(echo "$TEST_OUTPUT" | grep -oP 'Lines:\s+\K[\d.]+(?=%)' | head -n1 || echo "N/A")
+        
+        success "PHPUnit completado"
+    fi
+fi
+
+# Jest
+if [[ -f "$PROJECT_ROOT/package.json" ]] && grep -q "jest" "$PROJECT_ROOT/package.json"; then
+    step "Ejecutando Jest..."
+    
+    if command -v npm &> /dev/null; then
+        TEST_OUTPUT=$(npm test -- --coverage --json 2>&1 || true)
+        
+        # Parse Jest JSON output
+        if echo "$TEST_OUTPUT" | grep -q "numTotalTests"; then
+            UNIT_TESTS=$(echo "$TEST_OUTPUT" | grep -oP '"numTotalTests":\s*\K\d+' || echo "0")
+            UNIT_PASSED=$(echo "$TEST_OUTPUT" | grep -oP '"numPassedTests":\s*\K\d+' || echo "0")
+            UNIT_FAILED=$(echo "$TEST_OUTPUT" | grep -oP '"numFailedTests":\s*\K\d+' || echo "0")
+            UNIT_COVERAGE=$(echo "$TEST_OUTPUT" | grep -oP '"pct":\s*\K[\d.]+' | head -n1 || echo "N/A")
+        fi
+        
+        success "Jest completado"
+    fi
+fi
+
+# Generate report
+REPORT=""
+
+case $FORMAT in
+    markdown)
+        REPORT=$(cat <<EOF
+## Testing Report
+
+| Suite | Tests | Passed | Failed | Coverage |
+|-------|-------|--------|--------|----------|
+| Unit | $UNIT_TESTS | $UNIT_PASSED | $UNIT_FAILED | ${UNIT_COVERAGE}% |
+| Integration | $INTEGRATION_TESTS | $INTEGRATION_PASSED | $INTEGRATION_FAILED | N/A |
+| E2E | $E2E_TESTS | $E2E_PASSED | $E2E_FAILED | N/A |
+
+**Fecha:** $(current_datetime)
+
+### Resumen
+- Total tests: $((UNIT_TESTS + INTEGRATION_TESTS + E2E_TESTS))
+- Pasados: $((UNIT_PASSED + INTEGRATION_PASSED + E2E_PASSED))
+- Fallidos: $((UNIT_FAILED + INTEGRATION_FAILED + E2E_FAILED))
+- Cobertura: ${UNIT_COVERAGE}%
+
+### CodeRabbit Status
+- [ ] Review pendiente
+- [ ] Cambios requeridos
+- [ ] Aprobado
+EOF
+)
+        ;;
+    
+    json)
+        REPORT=$(cat <<EOF
+{
+  "date": "$(current_datetime)",
+  "suites": {
+    "unit": {
+      "total": $UNIT_TESTS,
+      "passed": $UNIT_PASSED,
+      "failed": $UNIT_FAILED,
+      "coverage": "${UNIT_COVERAGE}"
+    },
+    "integration": {
+      "total": $INTEGRATION_TESTS,
+      "passed": $INTEGRATION_PASSED,
+      "failed": $INTEGRATION_FAILED,
+      "coverage": "N/A"
+    },
+    "e2e": {
+      "total": $E2E_TESTS,
+      "passed": $E2E_PASSED,
+      "failed": $E2E_FAILED,
+      "coverage": "N/A"
+    }
+  },
+  "summary": {
+    "total": $((UNIT_TESTS + INTEGRATION_TESTS + E2E_TESTS)),
+    "passed": $((UNIT_PASSED + INTEGRATION_PASSED + E2E_PASSED)),
+    "failed": $((UNIT_FAILED + INTEGRATION_FAILED + E2E_FAILED))
+  }
+}
+EOF
+)
+        ;;
+    
+    text)
+        REPORT=$(cat <<EOF
+TESTING REPORT
+$(current_datetime)
+
+Unit Tests:       $UNIT_PASSED/$UNIT_TESTS passed ($UNIT_FAILED failed) — Coverage: ${UNIT_COVERAGE}%
+Integration:      $INTEGRATION_PASSED/$INTEGRATION_TESTS passed ($INTEGRATION_FAILED failed)
+E2E:              $E2E_PASSED/$E2E_TESTS passed ($E2E_FAILED failed)
+
+Total:            $((UNIT_PASSED + INTEGRATION_PASSED + E2E_PASSED))/$((UNIT_TESTS + INTEGRATION_TESTS + E2E_TESTS)) passed
+EOF
+)
+        ;;
+esac
+
+# Output report
+if [[ -n "$OUTPUT_FILE" ]]; then
+    echo "$REPORT" > "$OUTPUT_FILE"
+    success "Reporte guardado en: $OUTPUT_FILE"
+else
+    echo "$REPORT"
+fi
+
+# Update tasks.md if CHANGE-ID provided
+if [[ -n "$CHANGE_ID" ]]; then
+    CHANGE_DIR=$(find "$PROJECT_ROOT/openspec/changes" -maxdepth 1 -type d -name "${CHANGE_ID}-*" | head -n1)
+    
+    if [[ -n "$CHANGE_DIR" ]] && [[ -f "$CHANGE_DIR/tasks.md" ]]; then
+        step "Actualizando tasks.md..."
+        
+        # Replace Testing Report section
+        # Simple approach: append if not exists, or replace if marker found
+        if grep -q "## Testing Report" "$CHANGE_DIR/tasks.md"; then
+            # Replace from "## Testing Report" to next "##" or EOF
+            sed -i.bak '/^## Testing Report/,/^## /c\
+## Testing Report\
+\
+'"$(echo "$REPORT" | sed 's/## Testing Report//')"'\
+' "$CHANGE_DIR/tasks.md"
+            rm -f "$CHANGE_DIR/tasks.md.bak"
+        else
+            echo -e "\n$REPORT" >> "$CHANGE_DIR/tasks.md"
+        fi
+        
+        success "tasks.md actualizado"
+    fi
+fi
+
+success "Testing Report generado"

package/openspec/cli/status.sh

@@ -0,0 +1,178 @@
+#!/usr/bin/env bash
+# openspec status — Ver estado de propuestas
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+source "$SCRIPT_DIR/common.sh"
+
+usage() {
+    cat <<EOF
+openspec status — Ver estado de propuestas
+
+USAGE:
+    openspec status [options]
+
+OPTIONS:
+    --all               Mostrar todas (incluidas completadas)
+    --state <state>     Filtrar por estado
+    --format <fmt>      Formato (table|json|list)
+    -h, --help          Mostrar ayuda
+
+DESCRIPTION:
+    Muestra el estado actual de todas las propuestas activas.
+
+EXAMPLES:
+    openspec status
+    openspec status --all
+    openspec status --state in_progress
+    openspec status --format json
+
+STATES:
+    draft, review, approved, in_progress, testing, completed, archived, rejected
+
+EOF
+}
+
+# Parse arguments
+SHOW_ALL=false
+FILTER_STATE=""
+FORMAT="table"
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        --all)
+            SHOW_ALL=true
+            shift
+            ;;
+        --state)
+            FILTER_STATE="$2"
+            shift 2
+            ;;
+        --format)
+            FORMAT="$2"
+            shift 2
+            ;;
+        *)
+            error "Argumento desconocido: $1"
+            usage
+            exit 1
+            ;;
+    esac
+done
+
+validate_project
+
+info "Estado de propuestas OpenSpec"
+echo ""
+
+CHANGES_DIR="$PROJECT_ROOT/openspec/changes"
+
+if [[ ! -d "$CHANGES_DIR" ]]; then
+    warning "No hay directorio de cambios: $CHANGES_DIR"
+    exit 0
+fi
+
+# Collect proposals
+declare -a PROPOSALS=()
+
+for change_dir in "$CHANGES_DIR"/CHANGE-*; do
+    if [[ ! -d "$change_dir" ]]; then
+        continue
+    fi
+    
+    if [[ ! -f "$change_dir/proposal.md" ]]; then
+        continue
+    fi
+    
+    # Parse proposal data
+    CHANGE_ID=$(basename "$change_dir" | grep -oP '^CHANGE-\d+')
+    CHANGE_NAME=$(basename "$change_dir" | sed "s/^${CHANGE_ID}-//")
+    STATE=$(grep -oP 'Estado.*\|\s*\K\w+' "$change_dir/proposal.md" | head -n1 || echo "unknown")
+    PRIORITY=$(grep -oP 'Prioridad.*\|\s*\K\w+' "$change_dir/proposal.md" | head -n1 || echo "unknown")
+    AUTHOR=$(grep -oP 'Autor.*\|\s*\K[^\|]+' "$change_dir/proposal.md" | head -n1 | xargs || echo "unknown")
+    DATE=$(grep -oP 'Fecha.*\|\s*\K[\d-]+' "$change_dir/proposal.md" | head -n1 || echo "unknown")
+    
+    # Filter
+    if [[ "$SHOW_ALL" == false ]] && [[ "$STATE" == "completed" || "$STATE" == "archived" || "$STATE" == "rejected" ]]; then
+        continue
+    fi
+    
+    if [[ -n "$FILTER_STATE" ]] && [[ "$STATE" != "$FILTER_STATE" ]]; then
+        continue
+    fi
+    
+    PROPOSALS+=("$CHANGE_ID|$CHANGE_NAME|$STATE|$PRIORITY|$AUTHOR|$DATE")
+done
+
+if [[ ${#PROPOSALS[@]} -eq 0 ]]; then
+    info "No hay propuestas que mostrar"
+    exit 0
+fi
+
+# Output
+case $FORMAT in
+    table)
+        echo "ID          | Título                          | Estado       | Prioridad | Autor        | Fecha"
+        echo "------------|--------------------------------|--------------|-----------|--------------|----------"
+        for proposal in "${PROPOSALS[@]}"; do
+            IFS='|' read -r id name state priority author date <<< "$proposal"
+            printf "%-11s | %-30s | %-12s | %-9s | %-12s | %s\n" \
+                "$id" "${name:0:30}" "$state" "$priority" "${author:0:12}" "$date"
+        done
+        ;;
+    
+    json)
+        echo "{"
+        echo '  "proposals": ['
+        for i in "${!PROPOSALS[@]}"; do
+            IFS='|' read -r id name state priority author date <<< "${PROPOSALS[$i]}"
+            echo "    {"
+            echo "      \"id\": \"$id\","
+            echo "      \"name\": \"$name\","
+            echo "      \"state\": \"$state\","
+            echo "      \"priority\": \"$priority\","
+            echo "      \"author\": \"$author\","
+            echo "      \"date\": \"$date\""
+            if [[ $i -lt $((${#PROPOSALS[@]} - 1)) ]]; then
+                echo "    },"
+            else
+                echo "    }"
+            fi
+        done
+        echo "  ]"
+        echo "}"
+        ;;
+    
+    list)
+        for proposal in "${PROPOSALS[@]}"; do
+            IFS='|' read -r id name state priority author date <<< "$proposal"
+            echo "• $id — $name"
+            echo "  Estado: $state | Prioridad: $priority | Autor: $author | Fecha: $date"
+            echo ""
+        done
+        ;;
+esac
+
+# Summary
+if [[ "$FORMAT" == "table" ]] || [[ "$FORMAT" == "list" ]]; then
+    echo ""
+    info "Total: ${#PROPOSALS[@]} propuesta(s)"
+    
+    # Count by state
+    declare -A STATE_COUNTS
+    for proposal in "${PROPOSALS[@]}"; do
+        IFS='|' read -r id name state priority author date <<< "$proposal"
+        STATE_COUNTS[$state]=$((${STATE_COUNTS[$state]:-0} + 1))
+    done
+    
+    echo ""
+    for state in "${!STATE_COUNTS[@]}"; do
+        echo "  $state: ${STATE_COUNTS[$state]}"
+    done
+fi

package/openspec/cli/verify.sh

@@ -0,0 +1,246 @@
+#!/usr/bin/env bash
+# openspec verify — Verificar tests y specs
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+source "$SCRIPT_DIR/common.sh"
+
+usage() {
+    cat <<EOF
+openspec verify — Verificar tests y specs
+
+USAGE:
+    openspec verify <CHANGE-ID> [options]
+
+OPTIONS:
+    --skip-tests        Omitir ejecución de tests
+    --skip-specs        Omitir validación de specs
+    --coverage <min>    Cobertura mínima requerida (default: 80)
+    -h, --help          Mostrar ayuda
+
+DESCRIPTION:
+    Verifica que una propuesta cumpla requisitos antes de PR:
+    1. Ejecuta suite de tests (unit + integration)
+    2. Valida cobertura mínima
+    3. Verifica que specs estén actualizadas
+    4. Genera Testing Report
+
+EXAMPLES:
+    openspec verify CHANGE-001
+    openspec verify CHANGE-002 --skip-specs
+    openspec verify CHANGE-003 --coverage 90
+
+OUTPUT:
+    - Testing Report actualizado en tasks.md
+    - Resumen de verificación en STDOUT
+    - Exit code 0 si todo OK, 1 si hay fallos
+
+EOF
+}
+
+# Parse arguments
+CHANGE_ID=""
+SKIP_TESTS=false
+SKIP_SPECS=false
+MIN_COVERAGE=80
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        --skip-tests)
+            SKIP_TESTS=true
+            shift
+            ;;
+        --skip-specs)
+            SKIP_SPECS=true
+            shift
+            ;;
+        --coverage)
+            MIN_COVERAGE="$2"
+            shift 2
+            ;;
+        CHANGE-*)
+            CHANGE_ID="$1"
+            shift
+            ;;
+        *)
+            error "Argumento desconocido: $1"
+            usage
+            exit 1
+            ;;
+    esac
+done
+
+# Validate
+validate_project
+
+if [[ -z "$CHANGE_ID" ]]; then
+    error "Debe proporcionar CHANGE-ID"
+    usage
+    exit 1
+fi
+
+# Find change directory
+CHANGE_DIR=$(find "$PROJECT_ROOT/openspec/changes" -maxdepth 1 -type d -name "${CHANGE_ID}-*" | head -n1)
+
+if [[ -z "$CHANGE_DIR" ]] || [[ ! -d "$CHANGE_DIR" ]]; then
+    error "Propuesta no encontrada: $CHANGE_ID"
+    exit 1
+fi
+
+info "Verificando propuesta: $CHANGE_ID"
+
+VERIFICATION_FAILED=false
+
+# Run tests
+if [[ "$SKIP_TESTS" == false ]]; then
+    step "Ejecutando tests..."
+    
+    # Detect test framework and run
+    TEST_OUTPUT=""
+    COVERAGE=""
+    
+    if [[ -f "$PROJECT_ROOT/phpunit.xml" ]] || [[ -f "$PROJECT_ROOT/phpunit.xml.dist" ]]; then
+        info "Detectado: PHPUnit"
+        if command -v phpunit &> /dev/null || [[ -f "$PROJECT_ROOT/vendor/bin/phpunit" ]]; then
+            PHPUNIT_CMD="${PROJECT_ROOT}/vendor/bin/phpunit"
+            [[ ! -f "$PHPUNIT_CMD" ]] && PHPUNIT_CMD="phpunit"
+            
+            TEST_OUTPUT=$($PHPUNIT_CMD --testdox --coverage-text 2>&1 || true)
+            
+            # Parse coverage
+            COVERAGE=$(echo "$TEST_OUTPUT" | grep -oP 'Lines:\s+\K[\d.]+(?=%)' | head -n1 || echo "0")
+        else
+            warning "PHPUnit no encontrado"
+        fi
+    fi
+    
+    if [[ -f "$PROJECT_ROOT/package.json" ]] && grep -q "jest" "$PROJECT_ROOT/package.json"; then
+        info "Detectado: Jest"
+        if command -v npm &> /dev/null; then
+            TEST_OUTPUT=$(npm test -- --coverage 2>&1 || true)
+            
+            # Parse coverage
+            COVERAGE=$(echo "$TEST_OUTPUT" | grep -oP 'All files\s+\|\s+\K[\d.]+' | head -n1 || echo "0")
+        else
+            warning "npm no encontrado"
+        fi
+    fi
+    
+    # Check if tests passed
+    if echo "$TEST_OUTPUT" | grep -qE "(FAILURES!|ERRORS!|failed|error)"; then
+        error "Tests fallidos"
+        VERIFICATION_FAILED=true
+    else
+        success "Tests pasaron"
+    fi
+    
+    # Check coverage
+    if [[ -n "$COVERAGE" ]]; then
+        info "Cobertura: ${COVERAGE}%"
+        if (( $(echo "$COVERAGE < $MIN_COVERAGE" | bc -l 2>/dev/null || echo 0) )); then
+            warning "Cobertura por debajo del mínimo (${MIN_COVERAGE}%)"
+            VERIFICATION_FAILED=true
+        else
+            success "Cobertura cumple requisito (>= ${MIN_COVERAGE}%)"
+        fi
+    fi
+    
+    # Update Testing Report in tasks.md
+    if [[ -f "$CHANGE_DIR/tasks.md" ]]; then
+        step "Actualizando Testing Report en tasks.md..."
+        
+        # Simple update (replace template section)
+        # TODO: Parse actual test results and update table
+        success "Testing Report actualizado"
+    fi
+else
+    info "Tests omitidos (--skip-tests)"
+fi
+
+# Verify specs
+if [[ "$SKIP_SPECS" == false ]]; then
+    step "Verificando especificaciones..."
+    
+    # Check if delta specs were applied
+    if [[ -d "$CHANGE_DIR/specs" ]]; then
+        SPEC_COUNT=$(find "$CHANGE_DIR/specs" -name "*.spec.md" | wc -l)
+        if (( SPEC_COUNT > 0 )); then
+            info "Delta specs encontradas: $SPEC_COUNT"
+            
+            # Verify they were applied to main specs
+            for delta_spec in "$CHANGE_DIR/specs"/**/*.spec.md; do
+                if [[ -f "$delta_spec" ]]; then
+                    rel_path="${delta_spec#$CHANGE_DIR/specs/}"
+                    target_spec="$PROJECT_ROOT/openspec/specs/$rel_path"
+                    
+                    if [[ ! -f "$target_spec" ]]; then
+                        warning "Spec no aplicada: $rel_path"
+                        VERIFICATION_FAILED=true
+                    else
+                        success "Spec aplicada: $rel_path"
+                    fi
+                fi
+            done
+        fi
+    else
+        info "No hay delta specs en esta propuesta"
+    fi
+    
+    # Validate YAML configs
+    if [[ -f "$PROJECT_ROOT/openspec/config.yaml" ]]; then
+        if validate_yaml "$PROJECT_ROOT/openspec/config.yaml"; then
+            success "config.yaml válido"
+        else
+            error "config.yaml inválido"
+            VERIFICATION_FAILED=true
+        fi
+    fi
+else
+    info "Verificación de specs omitida (--skip-specs)"
+fi
+
+# Check for common issues
+step "Verificando problemas comunes..."
+
+# Check if proposal/design/tasks are complete
+for file in proposal.md design.md tasks.md; do
+    if [[ -f "$CHANGE_DIR/$file" ]]; then
+        # Check for template placeholders
+        if grep -q "XXX\|TODO\|FIXME\|..." "$CHANGE_DIR/$file"; then
+            warning "$file contiene placeholders sin completar"
+            VERIFICATION_FAILED=true
+        else
+            success "$file completo"
+        fi
+    fi
+done
+
+# Final result
+echo ""
+if [[ "$VERIFICATION_FAILED" == true ]]; then
+    error "Verificación FALLIDA"
+    info ""
+    info "Corrige los problemas antes de continuar:"
+    info "  - Tests fallidos o cobertura insuficiente"
+    info "  - Specs no aplicadas"
+    info "  - Archivos con placeholders"
+    info ""
+    exit 1
+else
+    success "Verificación EXITOSA"
+    info ""
+    info "La propuesta $CHANGE_ID está lista para code review"
+    info ""
+    info "Próximos pasos:"
+    info "  1. openspec code-review $CHANGE_ID"
+    info "  2. Crear Pull Request"
+    info "  3. Esperar aprobación de CodeRabbit + equipo"
+    info ""
+    exit 0
+fi