specleap-framework 2.1.0 → 2.1.5

package/openspec/cli/code-review.sh

@@ -0,0 +1,207 @@
+#!/usr/bin/env bash
+# openspec code-review — Solicitar review de CodeRabbit
+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 code-review — Solicitar review de CodeRabbit
+
+USAGE:
+    openspec code-review <CHANGE-ID> [options]
+
+OPTIONS:
+    --create-pr         Crear Pull Request automáticamente
+    --base <branch>     Branch base para PR (default: develop)
+    --draft             Crear PR como draft
+    -h, --help          Mostrar ayuda
+
+DESCRIPTION:
+    Solicita code review para una propuesta:
+    1. Verifica que tests pasen (openspec verify)
+    2. Crea PR en GitHub (si --create-pr)
+    3. CodeRabbit hace review automático
+    4. Genera reporte de review
+
+EXAMPLES:
+    openspec code-review CHANGE-001
+    openspec code-review CHANGE-002 --create-pr
+    openspec code-review CHANGE-003 --create-pr --draft
+
+PREREQUISITES:
+    - Branch feature creado
+    - Tests pasando
+    - GitHub CLI configurado (gh)
+    - CodeRabbit activo en el repo
+
+EOF
+}
+
+# Parse arguments
+CHANGE_ID=""
+CREATE_PR=false
+BASE_BRANCH="develop"
+DRAFT=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        --create-pr)
+            CREATE_PR=true
+            shift
+            ;;
+        --base)
+            BASE_BRANCH="$2"
+            shift 2
+            ;;
+        --draft)
+            DRAFT=true
+            shift
+            ;;
+        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
+
+CHANGE_NAME=$(basename "$CHANGE_DIR" | sed "s/^${CHANGE_ID}-//")
+
+info "Solicitando code review para: $CHANGE_ID — $CHANGE_NAME"
+
+# Run verification first
+step "Verificando tests y specs..."
+if ! "$SCRIPT_DIR/verify.sh" "$CHANGE_ID"; then
+    error "La verificación falló. Corrige los problemas antes de solicitar review."
+    exit 1
+fi
+
+# Check Git status
+CURRENT_BRANCH=$(git_current_branch)
+if [[ "$CURRENT_BRANCH" == "main" ]] || [[ "$CURRENT_BRANCH" == "master" ]] || [[ "$CURRENT_BRANCH" == "develop" ]]; then
+    error "No puedes crear PR desde branch principal: $CURRENT_BRANCH"
+    info "Usa: openspec apply $CHANGE_ID para crear feature branch"
+    exit 1
+fi
+
+# Push current branch
+step "Pusheando branch a remoto..."
+if ! git push -u origin "$CURRENT_BRANCH" 2>&1; then
+    # Branch may already exist
+    if ! git push origin "$CURRENT_BRANCH" 2>&1; then
+        error "No se pudo pushear branch"
+        exit 1
+    fi
+fi
+success "Branch pusheado: $CURRENT_BRANCH"
+
+# Create PR if requested
+if [[ "$CREATE_PR" == true ]]; then
+    require_command "gh" "Instalar GitHub CLI: https://cli.github.com"
+    
+    step "Creando Pull Request..."
+    
+    # Extract ticket id from proposal
+    TICKET_ID=$(grep -oP 'Ticket.*\|\s*\K[a-zA-Z0-9-]+-\d+' "$CHANGE_DIR/proposal.md" || echo "")
+
+    # PR title
+    PR_TITLE="$CHANGE_ID: $CHANGE_NAME"
+    if [[ -n "$TICKET_ID" ]]; then
+        PR_TITLE="$TICKET_ID — $CHANGE_NAME"
+    fi
+    
+    # PR body from proposal
+    PR_BODY=$(cat <<EOF
+## Propuesta
+$CHANGE_ID — $CHANGE_NAME
+
+## Descripción
+$(grep -A 10 "## Resumen Ejecutivo" "$CHANGE_DIR/proposal.md" | tail -n +2 || echo "Ver propuesta completa en openspec/changes/$CHANGE_ID-$CHANGE_NAME/")
+
+## Archivos Clave
+- \`openspec/changes/$CHANGE_ID-$CHANGE_NAME/proposal.md\` — QUÉ y POR QUÉ
+- \`openspec/changes/$CHANGE_ID-$CHANGE_NAME/design.md\` — CÓMO (diseño técnico)
+- \`openspec/changes/$CHANGE_ID-$CHANGE_NAME/tasks.md\` — Tareas y Testing Report
+
+## Testing Report
+Ver \`tasks.md\` para resultados completos.
+
+## Referencias
+- Propuesta: openspec/changes/$CHANGE_ID-$CHANGE_NAME/
+$(if [[ -n "$TICKET_ID" ]]; then echo "- Ticket: $TICKET_ID"; fi)
+
+---
+**Code Review:** CodeRabbit está activo. Revisa comentarios automáticos.
+EOF
+)
+    
+    # Create PR
+    PR_ARGS=(
+        --base "$BASE_BRANCH"
+        --head "$CURRENT_BRANCH"
+        --title "$PR_TITLE"
+        --body "$PR_BODY"
+    )
+    
+    if [[ "$DRAFT" == true ]]; then
+        PR_ARGS+=(--draft)
+    fi
+    
+    PR_URL=$(gh pr create "${PR_ARGS[@]}" 2>&1)
+    
+    if [[ $? -eq 0 ]]; then
+        success "Pull Request creado: $PR_URL"
+        
+        # Update proposal state
+        sed -i.bak 's/Estado | in_progress/Estado | testing/' "$CHANGE_DIR/proposal.md"
+        rm -f "$CHANGE_DIR/proposal.md.bak"
+        
+        git add "$CHANGE_DIR/proposal.md"
+        git commit -m "chore(openspec): PR creado para $CHANGE_ID" || true
+        git push origin "$CURRENT_BRANCH" || true
+    else
+        error "No se pudo crear PR"
+        echo "$PR_URL"
+        exit 1
+    fi
+else
+    info "Para crear PR manualmente:"
+    info "  gh pr create --base $BASE_BRANCH --head $CURRENT_BRANCH"
+fi
+
+success "Code review solicitado para $CHANGE_ID"
+info ""
+info "CodeRabbit revisará automáticamente el PR"
+info "Revisa los comentarios y aplica cambios sugeridos"
+info ""
+info "Cuando el review esté aprobado:"
+info "  openspec archive $CHANGE_ID"

package/openspec/cli/common.sh

@@ -0,0 +1,171 @@
+#!/usr/bin/env bash
+# Common functions for OpenSpec CLI
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Output helpers
+info() { echo -e "${BLUE}ℹ${NC} $*"; }
+success() { echo -e "${GREEN}✓${NC} $*"; }
+warning() { echo -e "${YELLOW}⚠${NC} $*"; }
+error() { echo -e "${RED}✗${NC} $*" >&2; }
+step() { echo -e "${CYAN}→${NC} $*"; }
+
+# Validate project structure
+validate_project() {
+    if [[ ! -f "$PROJECT_ROOT/openspec/config.yaml" ]]; then
+        error "No se encuentra openspec/config.yaml"
+        error "Asegúrate de estar en la raíz del proyecto"
+        exit 1
+    fi
+}
+
+# Get next ID for spec/change
+get_next_id() {
+    local type="$1"  # "spec" or "change"
+    local dir=""
+    
+    case $type in
+        spec)
+            dir="$PROJECT_ROOT/openspec/specs"
+            ;;
+        change)
+            dir="$PROJECT_ROOT/openspec/changes"
+            ;;
+        *)
+            error "Tipo desconocido: $type"
+            return 1
+            ;;
+    esac
+    
+    # Find highest existing ID
+    local max_id=0
+    if [[ -d "$dir" ]]; then
+        for item in "$dir"/*; do
+            if [[ -d "$item" ]] || [[ -f "$item" ]]; then
+                local basename=$(basename "$item")
+                if [[ $basename =~ ^(SPEC|CHANGE)-([0-9]+) ]]; then
+                    local num="${BASH_REMATCH[2]}"
+                    if (( num > max_id )); then
+                        max_id=$num
+                    fi
+                fi
+            fi
+        done
+    fi
+    
+    # Next ID
+    local next_id=$((max_id + 1))
+    printf "%04d" "$next_id"
+}
+
+# Check if command exists
+require_command() {
+    local cmd="$1"
+    local install_hint="${2:-}"
+    
+    if ! command -v "$cmd" &> /dev/null; then
+        error "Comando requerido no encontrado: $cmd"
+        if [[ -n "$install_hint" ]]; then
+            info "$install_hint"
+        fi
+        exit 1
+    fi
+}
+
+# Validate YAML file
+validate_yaml() {
+    local file="$1"
+    
+    if ! command -v yq &> /dev/null; then
+        warning "yq no instalado, omitiendo validación YAML"
+        return 0
+    fi
+    
+    if ! yq eval "$file" > /dev/null 2>&1; then
+        error "YAML inválido: $file"
+        return 1
+    fi
+    
+    return 0
+}
+
+# Parse config value from config.yaml
+get_config() {
+    local key="$1"
+    local config_file="$PROJECT_ROOT/openspec/config.yaml"
+    
+    if command -v yq &> /dev/null; then
+        yq eval ".$key" "$config_file" 2>/dev/null || echo ""
+    else
+        # Fallback: simple grep
+        grep "^${key}:" "$config_file" | cut -d':' -f2 | xargs
+    fi
+}
+
+# Create directory if not exists
+ensure_dir() {
+    local dir="$1"
+    if [[ ! -d "$dir" ]]; then
+        mkdir -p "$dir"
+    fi
+}
+
+# Copy template with replacements
+copy_template() {
+    local template="$1"
+    local output="$2"
+    shift 2
+    local replacements=("$@")
+    
+    if [[ ! -f "$template" ]]; then
+        error "Template no encontrado: $template"
+        return 1
+    fi
+    
+    local content=$(cat "$template")
+    
+    # Apply replacements
+    for replacement in "${replacements[@]}"; do
+        local key="${replacement%%=*}"
+        local value="${replacement#*=}"
+        content="${content//$key/$value}"
+    done
+    
+    echo "$content" > "$output"
+}
+
+# Git helpers
+git_current_branch() {
+    git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown"
+}
+
+git_is_clean() {
+    [[ -z $(git status --porcelain) ]]
+}
+
+git_has_changes() {
+    ! git_is_clean
+}
+
+# Ticket integration helpers
+parse_ticket_id() {
+    local text="$1"
+    if [[ $text =~ ([a-zA-Z0-9-]+-[0-9]+) ]]; then
+        echo "${BASH_REMATCH[1]}"
+    fi
+}
+
+# Date helpers
+current_date() {
+    date +%Y-%m-%d
+}
+
+current_datetime() {
+    date +%Y-%m-%d\ %H:%M:%S
+}

package/openspec/cli/enrich.sh

@@ -0,0 +1,188 @@
+#!/usr/bin/env bash
+# openspec enrich — Refinar user story con AI
+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 enrich — Refinar user story con AI
+
+USAGE:
+    openspec enrich <user-story> [options]
+    openspec enrich --file <path>
+
+OPTIONS:
+    --file <path>       Leer user story desde archivo
+    --output <path>     Guardar resultado (default: STDOUT)
+    --model <model>     Modelo AI a usar (default: auto)
+    -h, --help          Mostrar ayuda
+
+DESCRIPTION:
+    Toma una user story simple y la enriquece con:
+    - Contexto técnico
+    - Criterios de aceptación detallados
+    - Edge cases identificados
+    - Estimación de complejidad
+
+EXAMPLE:
+    openspec enrich "Como usuario quiero hacer login"
+    openspec enrich --file stories/US-123.md --output stories/US-123-refined.md
+
+OUTPUT:
+    User story refinada en formato markdown con:
+    - Título y descripción
+    - Contexto del negocio
+    - Criterios de aceptación (GIVEN/WHEN/THEN)
+    - Casos de uso adicionales
+    - Estimación inicial
+
+EOF
+}
+
+# Parse arguments
+USER_STORY=""
+INPUT_FILE=""
+OUTPUT_FILE=""
+MODEL="auto"
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        --file)
+            INPUT_FILE="$2"
+            shift 2
+            ;;
+        --output)
+            OUTPUT_FILE="$2"
+            shift 2
+            ;;
+        --model)
+            MODEL="$2"
+            shift 2
+            ;;
+        -*)
+            error "Opción desconocida: $1"
+            usage
+            exit 1
+            ;;
+        *)
+            USER_STORY="$1"
+            shift
+            ;;
+    esac
+done
+
+# Read input
+if [[ -n "$INPUT_FILE" ]]; then
+    if [[ ! -f "$INPUT_FILE" ]]; then
+        error "Archivo no encontrado: $INPUT_FILE"
+        exit 1
+    fi
+    USER_STORY=$(cat "$INPUT_FILE")
+elif [[ -z "$USER_STORY" ]]; then
+    error "Debe proporcionar una user story o usar --file"
+    usage
+    exit 1
+fi
+
+info "Refinando user story con AI..."
+
+# Prompt para el AI
+PROMPT=$(cat <<EOF
+Eres un Product Owner experto en Spec-Driven Development.
+
+Refina la siguiente user story básica en una especificación detallada:
+
+---
+$USER_STORY
+---
+
+Genera una user story refinada con este formato:
+
+# [ID] Título Descriptivo
+
+## User Story
+Como [rol], quiero [acción] para [beneficio]
+
+## Contexto del Negocio
+Por qué esta funcionalidad es importante.
+
+## Criterios de Aceptación
+
+### Escenario 1: [Nombre del escenario]
+- **GIVEN** [contexto inicial]
+- **WHEN** [acción del usuario]
+- **THEN** [resultado esperado]
+- **AND** [condición adicional]
+
+### Escenario 2: [Edge case]
+...
+
+## Casos de Uso Adicionales
+- Caso 1: Descripción
+- Caso 2: Descripción
+
+## Requisitos No Funcionales
+- Performance: ...
+- Seguridad: ...
+- UX: ...
+
+## Estimación Inicial
+- **Complejidad:** Baja / Media / Alta
+- **Esfuerzo:** S / M / L / XL
+- **Riesgos:** ...
+
+## Fuera de Alcance
+- Qué NO incluye esta user story
+
+Usa español técnico claro y preciso.
+EOF
+)
+
+# Detect available AI CLI
+AI_CMD=""
+if command -v oracle &> /dev/null; then
+    AI_CMD="oracle"
+elif command -v gh &> /dev/null && gh copilot --version &> /dev/null 2>&1; then
+    AI_CMD="gh_copilot"
+elif command -v ai-cli &> /dev/null; then
+    AI_CMD="ai-cli"
+else
+    error "No se encontró CLI de AI disponible (oracle, gh copilot, ai-cli)"
+    exit 1
+fi
+
+# Execute AI enrichment
+REFINED_STORY=""
+case $AI_CMD in
+    oracle)
+        info "Usando Oracle CLI..."
+        REFINED_STORY=$(echo "$PROMPT" | oracle --model "${MODEL}" --no-stream)
+        ;;
+    gh_copilot)
+        info "Usando GitHub Copilot CLI..."
+        REFINED_STORY=$(echo "$PROMPT" | gh copilot suggest -t shell)
+        ;;
+    ai-cli)
+        info "Usando AI CLI..."
+        # Use sessions_send or direct prompt
+        REFINED_STORY=$(echo "$PROMPT" | ai-cli prompt)
+        ;;
+esac
+
+# Output result
+if [[ -n "$OUTPUT_FILE" ]]; then
+    echo "$REFINED_STORY" > "$OUTPUT_FILE"
+    success "User story refinada guardada en: $OUTPUT_FILE"
+else
+    echo "$REFINED_STORY"
+fi
+
+success "User story refinada exitosamente"