specleap-framework 2.1.0 → 2.1.5

package/openspec/cli/ff.sh

@@ -0,0 +1,329 @@
+#!/usr/bin/env bash
+# openspec ff — Fast-forward: generar propuesta completa 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 ff — Fast-forward: generar propuesta completa con AI
+
+USAGE:
+    openspec ff <CHANGE-ID> [options]
+
+OPTIONS:
+    --model <model>     Modelo AI a usar (default: auto)
+    --skip-proposal     Omitir generación de proposal.md
+    --skip-design       Omitir generación de design.md
+    --skip-tasks        Omitir generación de tasks.md
+    -h, --help          Mostrar ayuda
+
+DESCRIPTION:
+    Genera automáticamente con AI:
+    - proposal.md completo (si tiene user story base)
+    - design.md técnico (arquitectura, API, datos)
+    - tasks.md desglosado (tareas + estimaciones)
+
+    IMPORTANTE: Revisa y ajusta la salida del AI antes de aplicar.
+
+EXAMPLES:
+    openspec ff CHANGE-001
+    openspec ff CHANGE-002 --model anthropic/claude-sonnet-4
+    openspec ff CHANGE-003 --skip-tasks
+
+PREREQUISITES:
+    - Propuesta creada con: openspec new
+    - Al menos proposal.md con contexto básico
+
+EOF
+}
+
+# Parse arguments
+CHANGE_ID=""
+MODEL="auto"
+SKIP_PROPOSAL=false
+SKIP_DESIGN=false
+SKIP_TASKS=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        --model)
+            MODEL="$2"
+            shift 2
+            ;;
+        --skip-proposal)
+            SKIP_PROPOSAL=true
+            shift
+            ;;
+        --skip-design)
+            SKIP_DESIGN=true
+            shift
+            ;;
+        --skip-tasks)
+            SKIP_TASKS=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"
+    info "Use: openspec new $CHANGE_ID <título>"
+    exit 1
+fi
+
+info "Generando propuesta completa para: $CHANGE_ID"
+info "Directorio: $CHANGE_DIR"
+
+# Read current proposal for context
+PROPOSAL_FILE="$CHANGE_DIR/proposal.md"
+if [[ ! -f "$PROPOSAL_FILE" ]]; then
+    error "proposal.md no encontrado en $CHANGE_DIR"
+    exit 1
+fi
+
+PROPOSAL_CONTENT=$(cat "$PROPOSAL_FILE")
+
+# Detect AI CLI
+AI_CMD=""
+if command -v oracle &> /dev/null; then
+    AI_CMD="oracle"
+elif command -v ai-cli &> /dev/null; then
+    AI_CMD="ai-cli"
+else
+    error "No se encontró CLI de AI (oracle, ai-cli)"
+    exit 1
+fi
+
+# Generate design.md
+if [[ "$SKIP_DESIGN" == false ]]; then
+    step "Generando design.md con AI..."
+    
+    DESIGN_PROMPT=$(cat <<EOF
+Eres un arquitecto de software experto.
+
+Basándote en esta PROPUESTA:
+
+---
+$PROPOSAL_CONTENT
+---
+
+Genera un DISEÑO TÉCNICO completo siguiendo este formato:
+
+# [$CHANGE_ID] Diseño Técnico: [Título]
+
+## Resumen del Diseño
+Descripción técnica de alto nivel.
+
+## Arquitectura
+
+### Diagrama de Componentes
+\`\`\`
+[Diagrama ASCII de componentes y flujo]
+\`\`\`
+
+### Componentes Afectados
+| Componente | Tipo de Cambio | Descripción |
+|------------|----------------|-------------|
+| ... | ... | ... |
+
+## Modelo de Datos
+
+### Nuevas Entidades
+\`\`\`typescript
+interface NuevaEntidad {
+  // ...
+}
+\`\`\`
+
+### Migraciones de Base de Datos
+\`\`\`sql
+-- Migration: ...
+\`\`\`
+
+## API / Interfaces
+
+### Nuevos Endpoints
+\`\`\`
+POST /api/v1/...
+GET  /api/v1/...
+\`\`\`
+
+### Contratos de API
+\`\`\`typescript
+interface Request { ... }
+interface Response { ... }
+\`\`\`
+
+## Seguridad
+- Autenticación/autorización
+- Validación de inputs
+- Consideraciones de seguridad
+
+## Performance
+- Estimaciones de carga
+- Optimizaciones necesarias
+
+## Testing Strategy
+- Unit tests
+- Integration tests
+- E2E tests (si aplica)
+
+Usa español técnico. Sé específico y pragmático.
+EOF
+)
+
+    DESIGN_CONTENT=""
+    case $AI_CMD in
+        oracle)
+            DESIGN_CONTENT=$(echo "$DESIGN_PROMPT" | oracle --model "$MODEL" --no-stream)
+            ;;
+        ai-cli)
+            DESIGN_CONTENT=$(echo "$DESIGN_PROMPT" | ai-cli prompt --model "$MODEL")
+            ;;
+    esac
+    
+    if [[ -n "$DESIGN_CONTENT" ]]; then
+        echo "$DESIGN_CONTENT" > "$CHANGE_DIR/design.md"
+        success "design.md generado"
+    else
+        warning "No se pudo generar design.md"
+    fi
+fi
+
+# Generate tasks.md
+if [[ "$SKIP_TASKS" == false ]]; then
+    step "Generando tasks.md con AI..."
+    
+    # Read design for context
+    DESIGN_CONTENT=""
+    if [[ -f "$CHANGE_DIR/design.md" ]]; then
+        DESIGN_CONTENT=$(cat "$CHANGE_DIR/design.md")
+    fi
+    
+    TASKS_PROMPT=$(cat <<EOF
+Eres un Tech Lead experto en planificación de desarrollo.
+
+Basándote en:
+
+PROPUESTA:
+---
+$PROPOSAL_CONTENT
+---
+
+DISEÑO:
+---
+$DESIGN_CONTENT
+---
+
+Genera un DESGLOSE DE TAREAS completo siguiendo este formato:
+
+# [$CHANGE_ID] Tareas: [Título]
+
+## Resumen
+Total de tareas: X
+Estimación total: X story points
+
+## Tareas
+
+### 🏗️ Setup & Scaffolding
+
+#### TASK-001: [Título de tarea]
+- **Estimación:** X SP
+- **Estado:** ⬜ Pendiente
+- **Branch:** \`feat/$CHANGE_ID-...\`
+
+**Subtareas:**
+- [ ] Subtarea 1
+- [ ] Subtarea 2
+
+**Criterios de aceptación:**
+- [ ] Criterio 1
+- [ ] Criterio 2
+
+---
+
+### 📊 Backend / API
+[Tareas de backend]
+
+### 🎨 Frontend / UI
+[Tareas de frontend]
+
+### 🧪 Testing
+[Tareas de testing]
+
+### 📚 Documentación
+[Tareas de documentación]
+
+## Dependencias entre Tareas
+\`\`\`
+TASK-001 → TASK-002 → TASK-003
+\`\`\`
+
+## Testing Report (Template)
+| Suite | Tests | Passed | Failed | Coverage |
+|-------|-------|--------|--------|----------|
+| Unit | 0 | 0 | 0 | 0% |
+
+Usa español. Estima realísticamente (1-5 SP por tarea).
+EOF
+)
+
+    TASKS_CONTENT=""
+    case $AI_CMD in
+        oracle)
+            TASKS_CONTENT=$(echo "$TASKS_PROMPT" | oracle --model "$MODEL" --no-stream)
+            ;;
+        ai-cli)
+            TASKS_CONTENT=$(echo "$TASKS_PROMPT" | ai-cli prompt --model "$MODEL")
+            ;;
+    esac
+    
+    if [[ -n "$TASKS_CONTENT" ]]; then
+        echo "$TASKS_CONTENT" > "$CHANGE_DIR/tasks.md"
+        success "tasks.md generado"
+    else
+        warning "No se pudo generar tasks.md"
+    fi
+fi
+
+success "Fast-forward completado para $CHANGE_ID"
+info ""
+info "IMPORTANTE: Revisa y ajusta los archivos generados antes de continuar"
+info ""
+info "Archivos actualizados:"
+[[ "$SKIP_DESIGN" == false ]] && info "  - design.md"
+[[ "$SKIP_TASKS" == false ]] && info "  - tasks.md"
+info ""
+info "Próximos pasos:"
+info "  1. Revisar y ajustar diseño/tareas"
+info "  2. openspec verify $CHANGE_ID"
+info "  3. openspec apply $CHANGE_ID"

package/openspec/cli/new.sh

@@ -0,0 +1,260 @@
+#!/usr/bin/env bash
+# openspec new — Crear nueva propuesta de cambio
+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 new — Crear nueva propuesta de cambio
+
+USAGE:
+    openspec new [CHANGE-ID] <título> [options]
+    openspec new --auto <título>
+
+OPTIONS:
+    --auto              Generar ID automáticamente
+    --from <file>       Crear desde user story refinada
+    --ticket <id>       Asociar con un ID de ticket (ej: app-tienda-23)
+    --priority <level>  Prioridad (critical/high/medium/low)
+    --author <name>     Autor (default: git user)
+    -h, --help          Mostrar ayuda
+
+DESCRIPTION:
+    Crea una nueva propuesta de cambio con estructura completa:
+    - proposal.md (QUÉ y POR QUÉ)
+    - design.md (CÓMO técnico)
+    - tasks.md (Tareas y Testing Report)
+    - specs/ (Delta specs si aplica)
+
+EXAMPLES:
+    openspec new CHANGE-001 "Implementar autenticación JWT"
+    openspec new --auto "Sistema de notificaciones" --ticket app-tienda-23
+    openspec new CHANGE-002 --from stories/auth-refined.md
+
+OUTPUT:
+    openspec/changes/CHANGE-XXX-nombre/
+    ├── proposal.md
+    ├── design.md
+    ├── tasks.md
+    └── specs/  (si aplica)
+
+EOF
+}
+
+# Parse arguments
+CHANGE_ID=""
+TITLE=""
+AUTO_ID=false
+FROM_FILE=""
+TICKET_ID=""
+PRIORITY="medium"
+AUTHOR=$(git config user.name 2>/dev/null || echo "Unknown")
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        --auto)
+            AUTO_ID=true
+            shift
+            ;;
+        --from)
+            FROM_FILE="$2"
+            shift 2
+            ;;
+        --ticket)
+            TICKET_ID="$2"
+            shift 2
+            ;;
+        --priority)
+            PRIORITY="$2"
+            shift 2
+            ;;
+        --author)
+            AUTHOR="$2"
+            shift 2
+            ;;
+        CHANGE-*)
+            CHANGE_ID="$1"
+            shift
+            ;;
+        *)
+            if [[ -z "$TITLE" ]]; then
+                TITLE="$1"
+            else
+                error "Argumento inesperado: $1"
+                exit 1
+            fi
+            shift
+            ;;
+    esac
+done
+
+# Validate inputs
+validate_project
+
+if [[ -z "$TITLE" ]]; then
+    error "Debe proporcionar un título para la propuesta"
+    usage
+    exit 1
+fi
+
+# Generate or validate ID
+if [[ "$AUTO_ID" == true ]]; then
+    CHANGE_NUM=$(get_next_id "change")
+    CHANGE_ID="CHANGE-$CHANGE_NUM"
+    info "ID generado automáticamente: $CHANGE_ID"
+elif [[ -z "$CHANGE_ID" ]]; then
+    error "Debe proporcionar CHANGE-ID o usar --auto"
+    usage
+    exit 1
+elif [[ ! $CHANGE_ID =~ ^CHANGE-[0-9]{4}$ ]]; then
+    error "Formato de ID inválido. Use: CHANGE-XXXX (ej: CHANGE-0001)"
+    exit 1
+fi
+
+# Create slug from title
+SLUG=$(echo "$TITLE" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-//' | sed 's/-$//')
+CHANGE_DIR="$PROJECT_ROOT/openspec/changes/${CHANGE_ID}-${SLUG}"
+
+# Check if already exists
+if [[ -d "$CHANGE_DIR" ]]; then
+    error "La propuesta ya existe: $CHANGE_DIR"
+    exit 1
+fi
+
+info "Creando propuesta: $CHANGE_ID — $TITLE"
+
+# Create directory structure
+ensure_dir "$CHANGE_DIR"
+ensure_dir "$CHANGE_DIR/specs"
+
+# Get current date
+DATE=$(current_date)
+
+# Create proposal.md from template
+step "Creando proposal.md..."
+TEMPLATE_PROPOSAL="$PROJECT_ROOT/openspec/templates/proposal.md"
+cp "$TEMPLATE_PROPOSAL" "$CHANGE_DIR/proposal.md"
+
+# Replace placeholders
+sed -i.bak \
+    -e "s/CHANGE-XXX/$CHANGE_ID/g" \
+    -e "s/Título del Cambio/$TITLE/g" \
+    -e "s/YYYY-MM-DD/$DATE/g" \
+    -e "s/nombre/$AUTHOR/g" \
+    -e "s/TICKET-XXX/${TICKET_ID:-TICKET-XXX}/g" \
+    -e "s/medium/$PRIORITY/g" \
+    "$CHANGE_DIR/proposal.md"
+rm "$CHANGE_DIR/proposal.md.bak"
+
+# Create design.md from template
+step "Creando design.md..."
+TEMPLATE_DESIGN="$PROJECT_ROOT/openspec/templates/design.md"
+cp "$TEMPLATE_DESIGN" "$CHANGE_DIR/design.md"
+
+sed -i.bak \
+    -e "s/CHANGE-XXX/$CHANGE_ID/g" \
+    -e "s/Título del Cambio/$TITLE/g" \
+    -e "s/YYYY-MM-DD/$DATE/g" \
+    -e "s/nombre/$AUTHOR/g" \
+    "$CHANGE_DIR/design.md"
+rm "$CHANGE_DIR/design.md.bak"
+
+# Create tasks.md from template
+step "Creando tasks.md..."
+TEMPLATE_TASKS="$PROJECT_ROOT/openspec/templates/tasks.md"
+cp "$TEMPLATE_TASKS" "$CHANGE_DIR/tasks.md"
+
+sed -i.bak \
+    -e "s/CHANGE-XXX/$CHANGE_ID/g" \
+    -e "s/Título del Cambio/$TITLE/g" \
+    -e "s/YYYY-MM-DD/$DATE/g" \
+    -e "s/TICKET-XXX/${TICKET_ID:-TICKET-XXX}/g" \
+    "$CHANGE_DIR/tasks.md"
+rm "$CHANGE_DIR/tasks.md.bak"
+
+# If created from refined user story, populate proposal
+if [[ -n "$FROM_FILE" ]]; then
+    if [[ -f "$FROM_FILE" ]]; then
+        step "Importando user story refinada desde $FROM_FILE..."
+        # Append refined content to proposal
+        echo -e "\n## User Story Refinada (Importada)\n" >> "$CHANGE_DIR/proposal.md"
+        cat "$FROM_FILE" >> "$CHANGE_DIR/proposal.md"
+    else
+        warning "Archivo no encontrado: $FROM_FILE"
+    fi
+fi
+
+# Create README in change folder
+cat > "$CHANGE_DIR/README.md" <<EOF
+# $CHANGE_ID — $TITLE
+
+| Campo | Valor |
+|-------|-------|
+| ID | $CHANGE_ID |
+| Título | $TITLE |
+| Estado | draft |
+| Autor | $AUTHOR |
+| Fecha | $DATE |
+| Prioridad | $PRIORITY |
+| Ticket | ${TICKET_ID:-N/A} |
+
+## Archivos
+
+- [proposal.md](./proposal.md) — QUÉ y POR QUÉ
+- [design.md](./design.md) — CÓMO (diseño técnico)
+- [tasks.md](./tasks.md) — Tareas y Testing Report
+- specs/ — Delta specs (si aplica)
+
+## Próximos Pasos
+
+1. Completar \`proposal.md\` (contexto, problema, solución, alcance)
+2. Completar \`design.md\` (arquitectura, API, datos, seguridad)
+3. Desglosar tareas en \`tasks.md\`
+4. Crear delta specs si modifica specs existentes
+5. Solicitar aprobación: \`openspec verify $CHANGE_ID\`
+6. Implementar: \`openspec apply $CHANGE_ID\`
+
+## Comandos
+
+\`\`\`bash
+# Fast-forward: generar propuesta completa con AI
+openspec ff $CHANGE_ID
+
+# Aplicar propuesta (crear branch, implementar)
+openspec apply $CHANGE_ID
+
+# Verificar tests y specs
+openspec verify $CHANGE_ID
+
+# Code review
+openspec code-review $CHANGE_ID
+
+# Archivar al completar
+openspec archive $CHANGE_ID
+\`\`\`
+EOF
+
+success "Propuesta creada exitosamente: $CHANGE_DIR"
+info ""
+info "Archivos creados:"
+info "  - proposal.md"
+info "  - design.md"
+info "  - tasks.md"
+info "  - README.md"
+info ""
+info "Próximos pasos:"
+info "  1. Editar proposal.md (QUÉ y POR QUÉ)"
+info "  2. Editar design.md (CÓMO)"
+info "  3. Desglosar tareas en tasks.md"
+info "  4. (Opcional) openspec ff $CHANGE_ID para generar rápido con AI"
+info ""
+info "Cuando esté listo:"
+info "  openspec apply $CHANGE_ID"

package/openspec/cli/openspec

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+# OpenSpec CLI — Spec-Driven Development
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Helper functions
+info() { echo -e "${BLUE}ℹ${NC} $*"; }
+success() { echo -e "${GREEN}✓${NC} $*"; }
+warning() { echo -e "${YELLOW}⚠${NC} $*"; }
+error() { echo -e "${RED}✗${NC} $*" >&2; }
+
+usage() {
+    cat <<EOF
+OpenSpec CLI — Spec-Driven Development
+
+USAGE:
+    openspec <command> [options]
+
+COMMANDS:
+    enrich       Refinar user story con AI
+    new          Crear nueva propuesta de cambio
+    ff           Fast-forward: generar propuesta completa
+    apply        Implementar propuesta aprobada
+    verify       Verificar tests y specs
+    implement    Aplicar cambios de code review
+    code-review  Solicitar review de CodeRabbit
+    archive      Archivar propuesta completada
+    report       Generar testing report
+    status       Ver estado de propuestas activas
+
+OPTIONS:
+    -h, --help   Mostrar esta ayuda
+    -v, --version Mostrar versión
+
+EXAMPLES:
+    openspec enrich "Como usuario quiero login"
+    openspec new CHANGE-001 "Implementar autenticación"
+    openspec ff CHANGE-001
+    openspec apply CHANGE-001
+    openspec verify CHANGE-001
+    openspec code-review CHANGE-001
+    openspec archive CHANGE-001
+
+DOCS:
+    openspec/README.md
+    https://github.com/ConceptualCreative/specleap-framework
+
+EOF
+}
+
+# Parse command
+COMMAND="${1:-}"
+if [[ -z "$COMMAND" ]] || [[ "$COMMAND" == "-h" ]] || [[ "$COMMAND" == "--help" ]]; then
+    usage
+    exit 0
+fi
+
+if [[ "$COMMAND" == "-v" ]] || [[ "$COMMAND" == "--version" ]]; then
+    echo "OpenSpec CLI v1.0.0"
+    exit 0
+fi
+
+# Dispatch to subcommand
+SUBCOMMAND_SCRIPT="$SCRIPT_DIR/$COMMAND.sh"
+if [[ ! -f "$SUBCOMMAND_SCRIPT" ]]; then
+    error "Comando desconocido: $COMMAND"
+    echo ""
+    usage
+    exit 1
+fi
+
+shift
+exec "$SUBCOMMAND_SCRIPT" "$@"