zugzbot-sdd 1.5.0

package/sdd

@@ -0,0 +1,1228 @@
+#!/bin/bash
+# ==============================================================================
+#  sdd
+#  Spec-Driven Development (SDD) Local Control Utility
+# ==============================================================================
+#
+# Scoped local command-line helper for SDD.
+#
+# Version: 1.4.0
+
+set -e
+
+# Ensure we run from the project root directory (parent of .openspec)
+SCRIPT_DIR="$(pwd)"
+cd "$SCRIPT_DIR"
+
+# Curated HSL-tailored premium ANSI colors
+COLOR_BORDER='\033[38;5;239m'   # Charcoal grey
+COLOR_HEADER='\033[38;5;81m'    # Premium electric cyan
+COLOR_MUTED='\033[38;5;244m'     # Soft grey
+COLOR_SUCCESS='\033[38;5;120m'  # Bright vivid green
+COLOR_WARNING='\033[38;5;214m'  # Warm amber orange
+COLOR_ERROR='\033[38;5;196m'    # Deep crimson red
+COLOR_ACTIVE='\033[38;5;220m'   # Vibrant bright yellow
+NC='\033[0m'                    # Reset
+
+LOCKFILE=".openspec/sdd-lock.json"
+# Fallback to older name if hidden openspec doesn't exist yet
+if [ ! -f "$LOCKFILE" ]; then
+    LOCKFILE="openspec/sdd-lock.json"
+fi
+
+# Helper functions to parse JSON without jq dependency (maximum portability)
+get_json_val() {
+    local key=$1
+    local file=$2
+    if [ -f "$file" ] && [ -s "$file" ]; then
+        local val=$(grep -o '"'"$key"'"[[:space:]]*:[[:space:]]*"[^"]*"' "$file" 2>/dev/null | head -n1 | cut -d'"' -f4)
+        echo "${val:-}"
+    else
+        echo ""
+    fi
+}
+
+get_json_num() {
+    local key=$1
+    local file=$2
+    if [ -f "$file" ] && [ -s "$file" ]; then
+        local val=$(grep -o '"'"$key"'"[[:space:]]*:[[:space:]]*[-0-9]*' "$file" 2>/dev/null | head -n1 | grep -o '[-0-9]*')
+        if [ -n "$val" ] && [ "$val" != "-" ]; then
+            echo "$val"
+        else
+            echo "0"
+        fi
+    else
+        echo "0"
+    fi
+}
+
+get_json_bool() {
+    local key=$1
+    local file=$2
+    if [ -f "$file" ] && [ -s "$file" ]; then
+        local val=$(grep -o '"'"$key"'"[[:space:]]*:[[:space:]]*[a-zA-Z]*' "$file" 2>/dev/null | head -n1 | awk -F: '{print $2}' | xargs 2>/dev/null || echo "")
+        if [ "$val" = "true" ] || [ "$val" = "false" ] || [ "$val" = "null" ]; then
+            echo "$val"
+        else
+            echo "false"
+        fi
+    else
+        echo "false"
+    fi
+}
+
+print_header() {
+    echo -e "${COLOR_BORDER}┌──────────────────────────────────────────────────────────────┐${NC}"
+    echo -e "${COLOR_BORDER}│${NC}  ${COLOR_HEADER}Zugzbot SDD Monitor${NC} ${COLOR_MUTED}• Control de Metodología Local${NC}      ${COLOR_BORDER}│${NC}"
+    echo -e "${COLOR_BORDER}└──────────────────────────────────────────────────────────────┘${NC}"
+}
+
+show_status() {
+    if [ ! -f "$LOCKFILE" ]; then
+        echo -e "  ${COLOR_ERROR}❌ Error: No se encuentra el archivo de bloqueo '${LOCKFILE}'.${NC}"
+        echo -e "     Asegúrate de inicializar el arnés o iniciar un ciclo SDD.\n"
+        exit 1
+    fi
+
+    # Read status variables
+    local change_name=$(get_json_val "change_name" "$LOCKFILE")
+    local phase_num=$(get_json_num "active_phase" "$LOCKFILE")
+    local subagent=$(get_json_val "active_subagent" "$LOCKFILE")
+    local status=$(get_json_val "status" "$LOCKFILE")
+    local auto_pilot=$(get_json_bool "auto_pilot" "$LOCKFILE")
+
+    echo -e "  ${COLOR_MUTED}▪ Cambio Activo:${NC}   ${COLOR_SUCCESS}${change_name:-Ninguno}${NC}"
+    echo -e "  ${COLOR_MUTED}▪ Modo de Vuelo:${NC}   $( [ "$auto_pilot" = "true" ] && echo -e "${COLOR_WARNING}✈ PILOTO AUTOMÁTICO (--auto)${NC}" || echo -e "${COLOR_HEADER}⚓ INTERACTIVO / ESTÁNDAR${NC}" )"
+    local status_upper=$(echo "${status:-idle}" | tr '[:lower:]' '[:upper:]')
+    echo -e "  ${COLOR_MUTED}▪ Estado Actual:${NC}   ${COLOR_SUCCESS}${status_upper}${NC}\n"
+
+    echo -e "  ${COLOR_HEADER}📈 PROGRESO DE LOS 5 HITOS (SDD: F0 + 4 FASES):${NC}"
+    echo -e "  ${COLOR_BORDER}──────────────────────────────────────────────────────────────${NC}"
+
+    # Define phases mapping (index 0-4 → Fase 0 to Fase 4)
+    local phases=(
+        "F0: Diagnóstico e Indexación       (@sdd-explorer)"
+        "F1: Planificación e Interrogación  (@sdd-planner)"
+        "F2: Construcción Lógica/Estética   (@sdd-builder)"
+        "F3: Pruebas y Despliegue           (@sdd-tester)"
+        "F4: Documentación y Cierre          (@sdd-archiver)"
+    )
+
+    print_phase() {
+        local idx=$1
+        local active=$2
+        if [ "$idx" -lt "$active" ]; then
+            echo -e "      ${COLOR_SUCCESS}✓${NC} ${COLOR_MUTED}${phases[$idx]}${NC}"
+        elif [ "$idx" -eq "$active" ]; then
+            echo -e "      ${COLOR_ACTIVE}➡️  ⚡${NC} ${COLOR_ACTIVE}${phases[$idx]}${NC}"
+        else
+            echo -e "      ${COLOR_MUTED}▪${NC} ${COLOR_MUTED}${phases[$idx]}${NC}"
+        fi
+    }
+
+    # Hito 0 (Diagnóstico e Indexación)
+    if [ "$phase_num" -le 0 ]; then
+        echo -e "  ${COLOR_ACTIVE}➡️  ⚡ [Hito 0: Diagnóstico e Indexación]${NC}"
+    else
+        echo -e "    ${COLOR_SUCCESS}✓ [Hito 0: Diagnóstico e Indexación]${NC}"
+    fi
+    print_phase 0 "$phase_num"
+    echo ""
+
+    # Hito A (Planificación e Interrogación)
+    if [ "$phase_num" -eq 1 ]; then
+        echo -e "  ${COLOR_ACTIVE}➡️  ⚡ [Hito A: Planificación e Interrogatorio]${NC}"
+    elif [ "$phase_num" -gt 1 ]; then
+        echo -e "    ${COLOR_SUCCESS}✓ [Hito A: Planificación e Interrogatorio]${NC}"
+    else
+        echo -e "    ${COLOR_BORDER}▪ [Hito A: Planificación e Interrogatorio]${NC}"
+    fi
+    print_phase 1 "$phase_num"
+    echo ""
+
+    # Hito B (Construcción Lógica/Estética)
+    if [ "$phase_num" -eq 2 ]; then
+        echo -e "  ${COLOR_ACTIVE}➡️  ⚡ [Hito B: Construcción Lógica/Estética]${NC}"
+    elif [ "$phase_num" -gt 2 ]; then
+        echo -e "    ${COLOR_SUCCESS}✓ [Hito B: Construcción Lógica/Estética]${NC}"
+    else
+        echo -e "    ${COLOR_BORDER}▪ [Hito B: Construcción Lógica/Estética]${NC}"
+    fi
+    print_phase 2 "$phase_num"
+    echo ""
+
+    # Hito C (Pruebas y Despliegue)
+    if [ "$phase_num" -eq 3 ]; then
+        echo -e "  ${COLOR_ACTIVE}➡️  ⚡ [Hito C: Pruebas y Despliegue]${NC}"
+    elif [ "$phase_num" -gt 3 ]; then
+        echo -e "    ${COLOR_SUCCESS}✓ [Hito C: Pruebas y Despliegue]${NC}"
+    else
+        echo -e "    ${COLOR_BORDER}▪ [Hito C: Pruebas y Despliegue]${NC}"
+    fi
+    print_phase 3 "$phase_num"
+    echo ""
+
+    # Hito D (Documentación y Cierre)
+    if [ "$phase_num" -ge 4 ]; then
+        echo -e "  ${COLOR_ACTIVE}➡️  ⚡ [Hito D: Documentación y Cierre]${NC}"
+    else
+        echo -e "    ${COLOR_BORDER}▪ [Hito D: Documentación y Cierre]${NC}"
+    fi
+    print_phase 4 "$phase_num"
+
+    echo -e "${COLOR_BORDER}  ──────────────────────────────────────────────────────────────${NC}\n"
+
+    # Print dynamic tasks if they exist in sdd-lock.json
+    node -e '
+      const fs = require("fs");
+      if (!fs.existsSync("'"$LOCKFILE"'")) process.exit(0);
+      try {
+        const lock = JSON.parse(fs.readFileSync("'"$LOCKFILE"'", "utf-8"));
+        if (!lock.tasks || lock.tasks.length === 0) process.exit(0);
+        console.log("  \x1b[38;5;81m📋 TAREAS DEL CAMBIO ACTIVO (Criterios de Aceptación/QA):\x1b[0m");
+        console.log("  \x1b[38;5;239m──────────────────────────────────────────────────────────────\x1b[0m");
+        lock.tasks.forEach(t => {
+          const statusIcon = t.status === "completed" ? "\x1b[38;5;120m[✓]\x1b[0m" : "\x1b[38;5;244m[ ]\x1b[0m";
+          const textStyle = t.status === "completed" ? "\x1b[38;5;244m" : "\x1b[38;5;220m";
+          console.log(`    ${statusIcon} ${textStyle}${t.desc}\x1b[0m`);
+        });
+        console.log("  \x1b[38;5;239m──────────────────────────────────────────────────────────────\x1b[0m\n");
+      } catch(e) {}
+    '
+}
+
+perform_rollback() {
+    echo -e "  ${COLOR_WARNING}⚠ ATENCIÓN: Se procederá a descartar todos los cambios locales${NC}"
+    echo -e "  no guardados en Git para regresar al checkpoint limpio del ciclo SDD."
+    echo -n "  ¿Estás seguro de continuar con el rollback? (s/n): "
+    read -r confirmation
+    if [[ "$confirmation" =~ ^[sS]$ ]]; then
+        echo -e "  ${COLOR_MUTED}▪ Descartando modificaciones de espacio de trabajo...${NC}"
+        set +e
+        git reset --hard HEAD 2>/dev/null && git clean -fd 2>/dev/null
+        local git_status=$?
+        set -e
+        if [ $git_status -eq 0 ]; then
+            echo -e "  ${COLOR_SUCCESS}✓ Espacio de trabajo restaurado limpiamente.${NC}\n"
+        else
+            echo -e "  ${COLOR_MUTED}▪ No había cambios para descartar orepo no es un git repo.${NC}\n"
+        fi
+    else
+        echo -e "  ${COLOR_MUTED}▪ Rollback abortado por el usuario.${NC}\n"
+    fi
+}
+
+perform_clean() {
+    echo -e "  ${COLOR_MUTED}▪ Purgando archivos de registro temporal y logs...${NC}"
+    rm -f .openspec/changes/*/failure_log.md 2>/dev/null || true
+    rm -rf .tmp/ 2>/dev/null || true
+    
+    # Reset lockfile to Phase 0 (ready for sdd-explorer)
+    if [ -f "$LOCKFILE" ]; then
+        cat > "$LOCKFILE" << 'EOF'
+{
+  "change_name": "nuevo-cambio",
+  "active_phase": 0,
+  "active_subagent": "sdd-explorer",
+  "status": "idle",
+  "auto_pilot": false,
+  "iteration": 0,
+  "last_updated": "",
+  "orchestrator_mode": "delegation_only",
+  "direction": "forward",
+  "last_successful_phase": 0,
+  "retry_count": 0,
+  "corrective_loop_active": false,
+  "fresh_task": false,
+  "checkpoints": [],
+  "tasks": [],
+  "complexity": "medium",
+  "last_checkpoint_id": null,
+  "last_restored_from": null
+}
+EOF
+    fi
+    echo -e "  ${COLOR_SUCCESS}✓ Caché SDD purgada y reseteada a Fase 0 (Diagnóstico).${NC}\n"
+}
+
+validate_schemas() {
+    echo -e "  ${COLOR_HEADER}🔍 Validando Artefactos del Cambio Activo...${NC}"
+    local active_change=$(get_json_val "change_name" "$LOCKFILE")
+    if [ -z "$active_change" ] || [ "$active_change" = "nuevo-cambio" ]; then
+        echo -e "  ${COLOR_WARNING}⚠ No hay un cambio de desarrollo activo registrado en el lockfile.${NC}\n"
+        exit 0
+    fi
+
+    local change_path=".openspec/changes/$active_change"
+    local has_errors=false
+
+    echo -ne "  ▪ Validando carpeta del cambio ($change_path)... "
+    if [ -d "$change_path" ]; then
+        echo -e "${COLOR_SUCCESS}OK${NC}"
+    else
+        echo -e "${COLOR_ERROR}FALLIDO (Directorio no existe)${NC}"
+        has_errors=true
+    fi
+
+    # Check proposal.md
+    if [ -f "$change_path/proposal.md" ]; then
+        echo -ne "  ▪ Validando propuesta (proposal.md)... "
+        if grep -q "## " "$change_path/proposal.md" 2>/dev/null; then
+            echo -e "${COLOR_SUCCESS}OK (Secciones estructuradas)${NC}"
+        else
+            echo -e "${COLOR_WARNING}ADVERTENCIA (Falta estructura de títulos)${NC}"
+        fi
+    fi
+
+    # Check specs/spec.md
+    if [ -f "$change_path/specs/spec.md" ]; then
+        echo -ne "  ▪ Validando especificación BDD (spec.md)... "
+        if grep -q "Scenario:" "$change_path/specs/spec.md" 2>/dev/null || grep -q "Escenario:" "$change_path/specs/spec.md" 2>/dev/null; then
+            echo -e "${COLOR_SUCCESS}OK (Escenarios BDD detectados)${NC}"
+        else
+            echo -e "${COLOR_WARNING}ADVERTENCIA (Faltan palabras clave 'Scenario/Escenario')${NC}"
+        fi
+    fi
+
+    if [ "$has_errors" = "true" ]; then
+        echo -e "  ${COLOR_ERROR}❌ Se encontraron inconsistencias estructurales en los artefactos.${NC}\n"
+    else
+        echo -e "  ${COLOR_SUCCESS}✓ Todos los artefactos detectados están en orden estructural.${NC}\n"
+    fi
+}
+
+run_test() {
+    echo -e "  ${COLOR_HEADER}🧪 Ejecutando Suite de Pruebas...${NC}"
+    echo -e "  ${COLOR_BORDER}──────────────────────────────────────────────────────────────${NC}"
+    
+    # Ejecutar validadores estáticos universales si existen
+    if [ -f "tests/static/tag_balance.js" ]; then
+        echo -e "  ${COLOR_MUTED}▪ [Estático] Ejecutando tests/static/tag_balance.js...${NC}"
+        node tests/static/tag_balance.js
+    fi
+    if [ -f "tests/static/dom_structure.js" ]; then
+        echo -e "  ${COLOR_MUTED}▪ [Estático] Ejecutando tests/static/dom_structure.js...${NC}"
+        node tests/static/dom_structure.js
+    fi
+
+    if [ -f "package.json" ]; then
+        if grep -q '"test"' package.json; then
+            npm run test
+        elif [ -d "node_modules/vitest" ] || grep -q '"vitest"' package.json; then
+            npx vitest run
+        elif [ -d "node_modules/jest" ] || grep -q '"jest"' package.json; then
+            npx jest
+        else
+            echo -e "  ${COLOR_WARNING}⚠ package.json detectado pero no hay framework de test estándar configurado.${NC}"
+        fi
+    elif [ -f "requirements.txt" ] || [ -f "pyproject.toml" ] || [ -f "Pipfile" ]; then
+        if command -v pytest &>/dev/null; then
+            pytest
+        else
+            python -m unittest discover
+        fi
+    elif [ -f "go.mod" ]; then
+        go test ./...
+    elif [ -f "Cargo.toml" ]; then
+        cargo test
+    else
+        echo -e "  ${COLOR_WARNING}⚠ No se detectó suite de pruebas automatizadas estandarizada para este stack.${NC}"
+        echo -e "  Configura un script en tu proyecto o actualiza el Cerebro.${NC}"
+    fi
+    echo -e "  ${COLOR_BORDER}──────────────────────────────────────────────────────────────${NC}"
+    echo -e "  ${COLOR_SUCCESS}✓ Pruebas completadas exitosamente.${NC}\n"
+}
+
+run_lint() {
+    echo -e "  ${COLOR_HEADER}🔍 Ejecutando Auditoría Estática (Linter)...${NC}"
+    echo -e "  ${COLOR_BORDER}──────────────────────────────────────────────────────────────${NC}"
+    
+    # Ejecutar validadores estáticos de balance de etiquetas e IDs duplicados si existen
+    if [ -f "tests/static/tag_balance.js" ]; then
+        echo -e "  ${COLOR_MUTED}▪ [Estático] Ejecutando tests/static/tag_balance.js...${NC}"
+        node tests/static/tag_balance.js
+    fi
+    if [ -f "tests/static/dom_structure.js" ]; then
+        echo -e "  ${COLOR_MUTED}▪ [Estático] Ejecutando tests/static/dom_structure.js...${NC}"
+        node tests/static/dom_structure.js
+    fi
+
+    if [ -f "package.json" ]; then
+        if grep -q '"lint"' package.json; then
+            npm run lint
+        elif [ -d "node_modules/eslint" ] || grep -q '"eslint"' package.json; then
+            npx eslint . --max-warnings=0
+        else
+            echo -e "  ${COLOR_SUCCESS}✓ package.json detectado pero linter no está preconfigurado (saltando linter estático).${NC}"
+        fi
+    elif [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; then
+        if command -v flake8 &>/dev/null; then
+            flake8 .
+        elif command -v pylint &>/dev/null; then
+            pylint src/
+        else
+            echo -e "  ${COLOR_SUCCESS}✓ Entorno Python sin linters estáticos instalados (saltando linter estático).${NC}"
+        fi
+    elif [ -f "go.mod" ]; then
+        if command -v golangci-lint &>/dev/null; then
+            golangci-lint run
+        else
+            go vet ./...
+        fi
+    else
+        echo -e "  ${COLOR_SUCCESS}✓ No se requiere linter específico para este entorno.${NC}"
+    fi
+    echo -e "  ${COLOR_BORDER}──────────────────────────────────────────────────────────────${NC}"
+    echo -e "  ${COLOR_SUCCESS}✓ Linter completado sin errores críticos.${NC}\n"
+}
+
+generate_and_open_dashboard() {
+    echo -e "  ${COLOR_HEADER}📺 Generando Dashboard Web Local Premium...${NC}"
+    
+    if [ ! -f "$LOCKFILE" ]; then
+        echo -e "  ${COLOR_ERROR}❌ Error: No se encuentra el archivo de bloqueo '${LOCKFILE}'.${NC}"
+        exit 1
+    fi
+
+    # Read status variables
+    local change_name=$(get_json_val "change_name" "$LOCKFILE")
+    local phase_num=$(get_json_num "active_phase" "$LOCKFILE")
+    local subagent=$(get_json_val "active_subagent" "$LOCKFILE")
+    local status=$(get_json_val "status" "$LOCKFILE")
+    local auto_pilot=$(get_json_bool "auto_pilot" "$LOCKFILE")
+
+    local dest_dir=$(dirname "$LOCKFILE")
+    local dashboard_file="$dest_dir/dashboard.html"
+
+    # Define phases mapping for the HTML
+    local phases_json=(
+        "F0: Diagnóstico e Indexación"
+        "F1: Planificación e Interrogación"
+        "F2: Construcción"
+        "F3: Pruebas"
+        "F4: Despliegue"
+        "F5: Documentación y Cierre"
+    )
+
+    local phases_agents=(
+        "@sdd-explorer"
+        "@sdd-planner"
+        "@sdd-builder"
+        "@sdd-tester"
+        "@sdd-deployer"
+        "@sdd-archiver"
+    )
+
+    # Build the phases list dynamically in HTML
+    local phases_html=""
+    local idx=0
+    for ((i=0; i<4; i++)); do
+        local phase_title="${phases_json[$i]}"
+        local agent_name="${phases_agents[$i]}"
+        local status_class="pending"
+        local status_icon="○"
+        local phase_val=$((i))
+        
+        if [ "$phase_val" -lt "$phase_num" ]; then
+            status_class="completed"
+            status_icon="✓"
+        elif [ "$phase_val" -eq "$phase_num" ]; then
+            status_class="active"
+            status_icon="⚡"
+        fi
+        
+        phases_html+='<div class="phase-card '$status_class'">
+            <div class="phase-icon">'$status_icon'</div>
+            <div class="phase-details">
+                <span class="phase-title">'$phase_title'</span>
+                <span class="phase-subagent">'$agent_name'</span>
+            </div>
+        </div>'
+    done
+
+    # Percentage calculation (6 phases: 0-5)
+    local percentage=$(( (phase_num * 100) / 5 ))
+    if [ $percentage -gt 100 ]; then percentage=100; fi
+
+    # Autopilot text & class
+    local autopilot_badge=""
+    if [ "$auto_pilot" = "true" ]; then
+        autopilot_badge='<span class="badge autopilot">✈ PILOTO AUTOMÁTICO</span>'
+    else
+        autopilot_badge='<span class="badge standard">⚓ INTERACTIVO</span>'
+    fi
+
+    # Read phase_history if available, format as HTML logs
+    local history_html=""
+    local history_file="$dest_dir/phase_history.jsonl"
+    if [ -f "$history_file" ]; then
+        history_html=$(tail -n 10 "$history_file" | while read -r line; do
+            local ts=$(echo "$line" | grep -o '"timestamp"[[:space:]]*:[[:space:]]*"[^"]*"' | head -n1 | cut -d'"' -f4 | cut -d'T' -f2 | cut -d'.' -f1 || echo "")
+            local ph=$(echo "$line" | grep -o '"phase"[[:space:]]*:[[:space:]]*[0-9]*' | head -n1 | grep -o '[0-9]*' || echo "")
+            local reas=$(echo "$line" | grep -o '"reason"[[:space:]]*:[[:space:]]*"[^"]*"' | head -n1 | cut -d'"' -f4 || echo "")
+            if [ -n "$reas" ]; then
+                echo '<div class="log-item"><span class="log-time">['$ts']</span> Fase '$ph': '$reas'</div>'
+            fi
+        done)
+    fi
+
+    if [ -z "$history_html" ]; then
+        history_html='<div class="log-item empty">Aún no se registran transiciones de fases en este ciclo.</div>'
+    fi
+
+    # Write the premium HTML dashboard
+    cat > "$dashboard_file" <<EOF
+<!DOCTYPE html>
+<html lang="es">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Zugzbot SDD Monitor & Dashboard</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;600;700&display=swap" rel="stylesheet">
+    <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
+    <script>
+        mermaid.initialize({
+            startOnLoad: true,
+            theme: 'dark',
+            themeVariables: {
+                background: '#0f172a',
+                primaryColor: '#38bdf8',
+                primaryTextColor: '#f8fafc',
+                lineColor: '#475569'
+            }
+        });
+    </script>
+    <style>
+        :root {
+            --bg-main: #0b0f19;
+            --bg-card: #151c2c;
+            --bg-active: rgba(56, 189, 248, 0.08);
+            --border-color: #223049;
+            --color-primary: #38bdf8;
+            --color-success: #4ade80;
+            --color-warning: #fbbf24;
+            --color-text-main: #f1f5f9;
+            --color-text-muted: #94a3b8;
+            --font-family: 'Outfit', -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+        }
+
+        * {
+            box-sizing: border-box;
+            margin: 0;
+            padding: 0;
+        }
+
+        body {
+            background-color: var(--bg-main);
+            color: var(--color-text-main);
+            font-family: var(--font-family);
+            line-height: 1.5;
+            padding: 2rem;
+        }
+
+        header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            border-bottom: 1px solid var(--border-color);
+            padding-bottom: 1.5rem;
+            margin-bottom: 2rem;
+        }
+
+        .header-title h1 {
+            font-size: 1.8rem;
+            font-weight: 700;
+            background: linear-gradient(135deg, var(--color-primary), #a855f7);
+            -webkit-background-clip: text;
+            -webkit-text-fill-color: transparent;
+        }
+
+        .header-title p {
+            color: var(--color-text-muted);
+            font-size: 0.95rem;
+            margin-top: 0.25rem;
+        }
+
+        .badges {
+            display: flex;
+            gap: 0.75rem;
+            align-items: center;
+        }
+
+        .badge {
+            padding: 0.35rem 0.75rem;
+            border-radius: 9999px;
+            font-size: 0.75rem;
+            font-weight: 600;
+            text-transform: uppercase;
+            letter-spacing: 0.05em;
+        }
+
+        .badge.autopilot {
+            background-color: rgba(251, 191, 36, 0.15);
+            color: var(--color-warning);
+            border: 1px solid rgba(251, 191, 36, 0.3);
+        }
+
+        .badge.standard {
+            background-color: rgba(56, 189, 248, 0.15);
+            color: var(--color-primary);
+            border: 1px solid rgba(56, 189, 248, 0.3);
+        }
+
+        .grid-container {
+            display: grid;
+            grid-template-columns: 1fr 1fr;
+            gap: 2rem;
+            margin-bottom: 2rem;
+        }
+
+        @media (max-width: 1024px) {
+            .grid-container {
+                grid-template-columns: 1fr;
+            }
+        }
+
+        .card {
+            background-color: var(--bg-card);
+            border: 1px solid var(--border-color);
+            border-radius: 16px;
+            padding: 1.5rem;
+            box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.3);
+        }
+
+        .card h2 {
+            font-size: 1.25rem;
+            font-weight: 600;
+            margin-bottom: 1.25rem;
+            color: var(--color-text-main);
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            border-bottom: 1px solid var(--border-color);
+            padding-bottom: 0.75rem;
+        }
+
+        /* Progress Bar */
+        .progress-section {
+            margin-bottom: 1.5rem;
+        }
+
+        .progress-info {
+            display: flex;
+            justify-content: space-between;
+            margin-bottom: 0.5rem;
+            font-size: 0.9rem;
+        }
+
+        .progress-bar-container {
+            background-color: var(--bg-main);
+            border-radius: 9999px;
+            height: 10px;
+            overflow: hidden;
+            border: 1px solid var(--border-color);
+        }
+
+        .progress-bar-fill {
+            background: linear-gradient(90deg, var(--color-primary), var(--color-success));
+            height: 100%;
+            border-radius: 9999px;
+            width: ${percentage}%;
+            transition: width 0.8s cubic-bezier(0.4, 0, 0.2, 1);
+        }
+
+        /* Phase Cards */
+        .phases-list {
+            display: flex;
+            flex-direction: column;
+            gap: 0.5rem;
+        }
+
+        .phase-card {
+            display: flex;
+            align-items: center;
+            padding: 0.75rem 1rem;
+            border-radius: 8px;
+            border: 1px solid transparent;
+            background-color: var(--bg-main);
+            transition: all 0.2s ease;
+        }
+
+        .phase-card.completed {
+            border-color: rgba(74, 222, 128, 0.15);
+            background-color: rgba(74, 222, 128, 0.02);
+        }
+
+        .phase-card.completed .phase-icon {
+            color: var(--color-success);
+            background-color: rgba(74, 222, 128, 0.1);
+            border-color: var(--color-success);
+        }
+
+        .phase-card.completed .phase-title {
+            color: var(--color-text-muted);
+            text-decoration: line-through;
+        }
+
+        .phase-card.active {
+            border-color: var(--color-primary);
+            background-color: var(--bg-active);
+            box-shadow: 0 0 15px rgba(56, 189, 248, 0.1);
+        }
+
+        .phase-card.active .phase-icon {
+            color: var(--color-primary);
+            background-color: rgba(56, 189, 248, 0.15);
+            border-color: var(--color-primary);
+            animation: pulse 2s infinite;
+        }
+
+        .phase-card.active .phase-title {
+            color: var(--color-text-main);
+            font-weight: 600;
+        }
+
+        .phase-card.pending {
+            opacity: 0.5;
+            border-color: var(--border-color);
+        }
+
+        .phase-icon {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            width: 28px;
+            height: 28px;
+            border-radius: 50%;
+            border: 1px solid var(--border-color);
+            margin-right: 1rem;
+            font-size: 0.8rem;
+            font-weight: 600;
+            color: var(--color-text-muted);
+        }
+
+        .phase-details {
+            display: flex;
+            flex-direction: column;
+        }
+
+        .phase-title {
+            font-size: 0.925rem;
+            color: var(--color-text-main);
+        }
+
+        .phase-subagent {
+            font-size: 0.75rem;
+            color: var(--color-text-muted);
+            margin-top: 0.1rem;
+        }
+
+        /* Log / History Styles */
+        .logs-container {
+            display: flex;
+            flex-direction: column;
+            gap: 0.5rem;
+            max-height: 380px;
+            overflow-y: auto;
+            padding-right: 0.5rem;
+        }
+
+        .log-item {
+            font-family: monospace;
+            font-size: 0.825rem;
+            padding: 0.6rem 0.8rem;
+            background-color: var(--bg-main);
+            border-left: 3px solid var(--color-primary);
+            border-radius: 0 6px 6px 0;
+            color: var(--color-text-main);
+        }
+
+        .log-item.empty {
+            border-left-color: var(--border-color);
+            color: var(--color-text-muted);
+            text-align: center;
+            padding: 2rem;
+        }
+
+        .log-time {
+            color: var(--color-primary);
+            margin-right: 0.5rem;
+        }
+
+        /* Mermaid Graph Styles */
+        .mermaid-card {
+            grid-column: 1 / -1;
+        }
+
+        .mermaid-container {
+            background-color: var(--bg-main);
+            border-radius: 12px;
+            padding: 1.5rem;
+            border: 1px solid var(--border-color);
+            display: flex;
+            justify-content: center;
+            overflow-x: auto;
+        }
+
+        @keyframes pulse {
+            0% {
+                box-shadow: 0 0 0 0 rgba(56, 189, 248, 0.4);
+            }
+            70% {
+                box-shadow: 0 0 0 10px rgba(56, 189, 248, 0);
+            }
+            100% {
+                box-shadow: 0 0 0 0 rgba(56, 189, 248, 0);
+            }
+        }
+    </style>
+</head>
+<body>
+    <header>
+        <div class="header-title">
+            <h1>Zugzbot SDD Monitor</h1>
+            <p>Visualización del ciclo de vida Spec-Driven Development local</p>
+        </div>
+        <div class="badges">
+            <span class="badge" style="background-color: rgba(74, 222, 128, 0.15); color: var(--color-success); border: 1px solid rgba(74, 222, 128, 0.3);">Cambio: ${change_name:-Ninguno}</span>
+            ${autopilot_badge}
+        </div>
+    </header>
+
+    <div class="grid-container">
+        <!-- Fases del Flujo SDD -->
+        <div class="card">
+            <h2>
+                <span>Progreso del Flujo</span>
+                <span style="font-size: 0.9rem; color: var(--color-primary); font-weight: normal;">Fase ${phase_num} de 3</span>
+            </h2>
+            <div class="progress-section">
+                <div class="progress-info">
+                    <span>Completado</span>
+                    <span>${percentage}%</span>
+                </div>
+                <div class="progress-bar-container">
+                    <div class="progress-bar-fill"></div>
+                </div>
+            </div>
+            <div class="phases-list">
+                ${phases_html}
+            </div>
+        </div>
+
+        <!-- Historial y Métricas -->
+        <div class="card" style="display: flex; flex-direction: column;">
+            <h2>Historial de Fase (phase_history.jsonl)</h2>
+            <div class="logs-container" style="flex-grow: 1;">
+                ${history_html}
+            </div>
+        </div>
+
+        <!-- Arquitectura del Ciclo SDD en Mermaid -->
+        <div class="card mermaid-card">
+            <h2>Arquitectura y Roles del Ciclo SDD</h2>
+            <div class="mermaid-container">
+                <pre class="mermaid">
+graph TD
+    subgraph HitoA [Hito A: Planificación e Interrogación]
+        F1[F1: Planificación e Interrogatorio]
+    end
+    subgraph HitoB [Hito B: Construcción y Despliegue]
+        F1 --> F2[F2: Construcción y Despliegue]
+    end
+    subgraph HitoC [Hito C: Documentación y Cierre]
+        F2 --> F3[F3: Documentación y Cierre]
+    end
+    
+    style HitoA fill:#111827,stroke:#374151,stroke-width:2px
+    style HitoB fill:#111827,stroke:#374151,stroke-width:2px
+    style HitoC fill:#111827,stroke:#374151,stroke-width:2px
+    
+    classDef default fill:#1f2937,stroke:#4b5563,color:#f3f4f6;
+    classDef activePhase fill:#1e3a8a,stroke:#3b82f6,stroke-width:2px,color:#eff6ff;
+                </pre>
+            </div>
+        </div>
+    </div>
+</body>
+</html>
+EOF
+
+    echo -e "  ${COLOR_SUCCESS}✓ Dashboard generado en '${dashboard_file}'.${NC}"
+    echo -e "  ${COLOR_MUTED}▪ Abriendo en tu navegador por defecto...${NC}\n"
+    
+    # Open on macOS
+    open "$dashboard_file"
+}
+
+perform_init() {
+    echo -e "  ${COLOR_HEADER}⚙️  Inicializando el Arnés de Agentes SDD...${NC}"
+    echo -e "  ${COLOR_BORDER}──────────────────────────────────────────────────────────────${NC}"
+    
+    # 1. Ejecutar el instalador install-plugin.sh de forma automática en el directorio actual
+    local installer_path="./install-plugin.sh"
+    if [ ! -f "$installer_path" ]; then
+        # Intentar buscarlo en el directorio del script
+        installer_path="$(dirname "$0")/../../install-plugin.sh"
+    fi
+
+    if [ -f "$installer_path" ]; then
+        echo -e "  ${COLOR_MUTED}▪ Ejecutando instalador...${NC}"
+        bash "$installer_path" "$(pwd)"
+    else
+        echo -e "  ${COLOR_ERROR}❌ Error: No se encontró 'install-plugin.sh' para la instalación automática.${NC}"
+        exit 1
+    fi
+
+    # 2. Inicializar .openspec/ e indexar en Fase 0
+    echo -e "\n  ${COLOR_HEADER}📈 Iniciando Paso 0 (Diagnóstico e Indexación)...${NC}"
+    echo -e "  ${COLOR_BORDER}──────────────────────────────────────────────────────────────${NC}"
+    
+    # Reset lockfile a Fase 0
+    if [ -f "$LOCKFILE" ]; then
+        cat > "$LOCKFILE" << 'EOF'
+{
+  "change_name": "nuevo-cambio",
+  "active_phase": 0,
+  "active_subagent": "sdd-explorer",
+  "status": "in_progress",
+  "auto_pilot": false,
+  "iteration": 0,
+  "last_updated": "",
+  "orchestrator_mode": "delegation_only",
+  "direction": "forward",
+  "last_successful_phase": 0,
+  "retry_count": 0,
+  "corrective_loop_active": false,
+  "fresh_task": false,
+  "checkpoints": [],
+  "tasks": [],
+  "complexity": "medium",
+  "last_checkpoint_id": null,
+  "last_restored_from": null
+}
+EOF
+    fi
+
+    # Crear o actualizar diagnostics.md simulando o guiando al agente sdd-explorer
+    local dest_dir=$(dirname "$LOCKFILE")
+    mkdir -p "$dest_dir/changes/nuevo-cambio"
+    
+    # Generar un diagnostics.md básico si no existe para que sdd-explorer / el proyecto esté listo
+    local diagnostics_file="$dest_dir/changes/nuevo-cambio/diagnostics.md"
+    if [ ! -f "$diagnostics_file" ]; then
+        cat > "$diagnostics_file" << 'EOF'
+# Diagnóstico Técnico del Proyecto: nuevo-cambio
+
+Este diagnóstico fue inicializado automáticamente con `sdd init`.
+
+## 1. Estado del Proyecto
+- Arnés de agentes SDD de Zugzbot instalado y configurado de forma óptima.
+- Linters (`eslint`, `typescript`, etc.) preconfigurados e instalados en la raíz.
+- El script de utilidad local `./sdd` está activo y listo para ser utilizado.
+
+## 2. Archivos e Infraestructura Detectados
+- `package.json` (Raíz)
+- `tsconfig.json` (Raíz)
+- `eslint.config.js` (Raíz)
+- `zugz-models.json` (Raíz)
+EOF
+    fi
+
+    echo -e "  ${COLOR_SUCCESS}✓ Arnés SDD inicializado con éxito y en Fase 0 (Diagnóstico).${NC}"
+    echo -e "  ${COLOR_MUTED}▪ Puedes consultar el estado actual con:${NC} ${COLOR_ACTIVE}./sdd status${NC}"
+    echo -e "  ${COLOR_MUTED}▪ Y comenzar tu ciclo de desarrollo en OpenCode llamando a:${NC} ${COLOR_ACTIVE}@sdd-explorer o @zugzbot${NC}\n"
+}
+
+show_interactive_menu() {
+    while true; do
+        clear 2>/dev/null || true
+        print_header
+        echo -e "  ${COLOR_ACTIVE}Selecciona una opción del menú interactivo:${NC}\n"
+        echo -e "    ${COLOR_HEADER}[1]${NC} 📊  Ver Estado y Progreso de Hitos"
+        echo -e "    ${COLOR_HEADER}[2]${NC} 🔍  Validar Artefactos (BDD / Propuestas)"
+        echo -e "    ${COLOR_HEADER}[3]${NC} 🧪  Ejecutar Pruebas Automatizadas (sdd test)"
+        echo -e "    ${COLOR_HEADER}[4]${NC} 🧹  Ejecutar Auditoría Estática (sdd lint)"
+        echo -e "    ${COLOR_HEADER}[5]${NC} 📺  Abrir Dashboard Web Local (sdd dashboard)"
+        echo -e "    ${COLOR_HEADER}[6]${NC} 🔄  Hacer Rollback de Cambios Locales"
+        echo -e "    ${COLOR_HEADER}[7]${NC} 🧹  Limpiar Caché y Reiniciar a Fase 0"
+        echo -e "    ${COLOR_HEADER}[8]${NC} ❓  Ver Tarjeta Informativa de Comandos"
+        echo -e "    ${COLOR_HEADER}[9]${NC} ❌  Salir del Monitor"
+        echo ""
+        echo -ne "  ${COLOR_MUTED}Ingresa tu opción [1-9]:${NC} "
+        read -r choice
+        echo ""
+        
+        case "$choice" in
+            1)
+                clear 2>/dev/null || true
+                print_header
+                show_status
+                echo -ne "  ${COLOR_MUTED}Presiona [Enter] para continuar...${NC}"
+                read -r
+                ;;
+            2)
+                clear 2>/dev/null || true
+                print_header
+                validate_schemas
+                echo -ne "  ${COLOR_MUTED}Presiona [Enter] para continuar...${NC}"
+                read -r
+                ;;
+            3)
+                clear 2>/dev/null || true
+                print_header
+                run_test || true
+                echo -ne "  ${COLOR_MUTED}Presiona [Enter] para continuar...${NC}"
+                read -r
+                ;;
+            4)
+                clear 2>/dev/null || true
+                print_header
+                run_lint || true
+                echo -ne "  ${COLOR_MUTED}Presiona [Enter] para continuar...${NC}"
+                read -r
+                ;;
+            5)
+                clear 2>/dev/null || true
+                print_header
+                generate_and_open_dashboard || true
+                echo -ne "  ${COLOR_MUTED}Presiona [Enter] para continuar...${NC}"
+                read -r
+                ;;
+            6)
+                clear 2>/dev/null || true
+                print_header
+                perform_rollback
+                echo -ne "  ${COLOR_MUTED}Presiona [Enter] para continuar...${NC}"
+                read -r
+                ;;
+            7)
+                clear 2>/dev/null || true
+                print_header
+                perform_clean
+                echo -ne "  ${COLOR_MUTED}Presiona [Enter] para continuar...${NC}"
+                read -r
+                ;;
+            8)
+                clear 2>/dev/null || true
+                print_header
+                echo -e "  ${COLOR_HEADER}Uso no interactivo:${NC} ./sdd [comando] u oculto: ./.openspec/sdd [comando]"
+                echo ""
+                echo -e "  ${COLOR_HEADER}Comandos r\u00e1pidos directos:${NC}"
+                echo -e "    ${COLOR_SUCCESS}status${NC}    - Muestra el progreso del ciclo agrupado en hitos directamente"
+                echo -e "    ${COLOR_SUCCESS}validate${NC}  - Audita estructuralmente las especificaciones"
+                echo -e "    ${COLOR_SUCCESS}test${NC}      - Corre las pruebas locales de forma automatizada"
+                echo -e "    ${COLOR_SUCCESS}lint${NC}      - Audita el linter de c\u00f3digo local"
+                echo -e "    ${COLOR_SUCCESS}dashboard${NC} - Abre el dashboard interactivo en tu navegador"
+                echo -e "    ${COLOR_SUCCESS}rollback${NC}  - Descarta cambios Git locales no confirmados"
+                echo -e "    ${COLOR_SUCCESS}clean${NC}     - Puga logs, archivos temporales y resetea a Fase 0"
+                echo -e "    ${COLOR_SUCCESS}models${NC}    - Gestiona modelos de IA (apply/status/preset)"
+                echo -e "    ${COLOR_SUCCESS}help${NC}      - Muestra esta tarjeta de comandos"
+                echo ""
+                echo -ne "  ${COLOR_MUTED}Presiona [Enter] para continuar...${NC}"
+                read -r
+                ;;
+            9)
+                echo -e "  ${COLOR_SUCCESS}\u00a1Nos vemos! \u00c9xito en tu ciclo de desarrollo. \ud83d\ude80${NC}\n"
+                break
+                ;;
+            *)
+                echo -e "  ${COLOR_ERROR}\u274c Opci\u00f3n no v\u00e1lida. Int\u00e9ntalo de nuevo.${NC}"
+                sleep 1
+                ;;
+        esac
+    done
+}
+
+manage_models() {
+    local subcommand="${1:-status}"
+    # Resolve models file — look in project root or script dir
+    local models_file="zugz-models.json"
+    if [ ! -f "$models_file" ]; then
+        models_file="$(dirname "$0")/../../zugz-models.json"
+    fi
+    if [ ! -f "$models_file" ]; then
+        echo -e "  ${COLOR_ERROR}\u274c No se encontró 'zugz-models.json'.${NC}"
+        echo -e "  Crea uno en la raíz del proyecto con el template de 8 agentes:\n"
+        echo -e '  {\n    "presets": {\n      "default": {\n        "zugzbot": "google/gemini-3.5-flash",\n        "sdd-explorer": "google/gemini-3.5-flash",\n        "sdd-planner": "google/gemini-3.5-flash",\n        "sdd-builder": "deepseek/deepseek-v4-pro",\n        "sdd-tester": "google/gemini-3.5-flash",\n        "sdd-archiver": "google/gemini-3.5-flash",\n        "aux-handyman": "google/gemini-3.5-flash",\n        "aux-oracle": "google/gemini-3.5-flash"\n      },\n      "free": {\n        "zugzbot": "opencode/deepseek-v4-flash-free",\n        "sdd-explorer": "opencode/deepseek-v4-flash-free",\n        "sdd-planner": "opencode/deepseek-v4-flash-free",\n        "sdd-builder": "opencode/deepseek-v4-flash-free",\n        "sdd-tester": "opencode/deepseek-v4-flash-free",\n        "sdd-archiver": "opencode/deepseek-v4-flash-free",\n        "aux-handyman": "opencode/deepseek-v4-flash-free",\n        "aux-oracle": "opencode/deepseek-v4-flash-free"\n      },\n      "balanced": {\n        "zugzbot": "google/gemini-3.5-flash",\n        "sdd-explorer": "google/gemini-3.5-flash",\n        "sdd-planner": "google/gemini-3.5-flash",\n        "sdd-builder": "deepseek/deepseek-v4-pro",\n        "sdd-tester": "google/gemini-3.5-flash",\n        "sdd-archiver": "google/gemini-3.5-flash",\n        "aux-handyman": "google/gemini-3.5-flash",\n        "aux-oracle": "google/gemini-3.5-flash"\n      },\n      "turbo": {\n        "zugzbot": "anthropic/claude-3.5-sonnet",\n        "sdd-explorer": "anthropic/claude-3.5-sonnet",\n        "sdd-planner": "anthropic/claude-3.5-sonnet",\n        "sdd-builder": "anthropic/claude-3.5-sonnet",\n        "sdd-tester": "google/gemini-3.5-flash",\n        "sdd-archiver": "google/gemini-3.5-flash",\n        "aux-handyman": "google/gemini-3.5-flash",\n        "aux-oracle": "google/gemini-3.5-flash"\n      }\n    }\n  }'
+        exit 1
+    fi
+
+    # Resolve agents dir — prefer local .opencode, fallback to zugz-plugin
+    local agents_dir=".opencode/agents"
+    if [ ! -d "$agents_dir" ]; then
+        agents_dir="zugz-plugin/agents"
+    fi
+    if [ ! -d "$agents_dir" ]; then
+        echo -e "  ${COLOR_ERROR}\u274c No se encontr\u00f3 el directorio de agentes.${NC}"
+        exit 1
+    fi
+
+    case "$subcommand" in
+        apply)
+            echo -e "  ${COLOR_HEADER}🤖 Aplicando modelos desde ${models_file}...${NC}"
+            echo -e "  ${COLOR_BORDER}──────────────────────────────────────────────────────────────${NC}"
+            node -e '
+              const fs = require("fs");
+              const path = require("path");
+              const modelsFile = "'"$models_file"'";
+              const destAgentsDir = "'"$agents_dir"'";
+              try {
+                const data = JSON.parse(fs.readFileSync(modelsFile, "utf-8"));
+                const models = data.presets?.default || data.presets?.balanced || data.agents || {};
+                let changed = 0;
+                Object.entries(models).forEach(([agentKey, modelVal]) => {
+                  const agentFile = path.join(destAgentsDir, `${agentKey}.md`);
+                  if (fs.existsSync(agentFile)) {
+                    let content = fs.readFileSync(agentFile, "utf-8");
+                    if (content.match(/^model:/m)) {
+                      content = content.replace(/^model:.*/m, `model: ${modelVal}`);
+                      fs.writeFileSync(agentFile, content, "utf-8");
+                      console.log(`  \x1b[32m✓\x1b[0m \x1b[90m${agentKey}\x1b[0m \x1b[34m→\x1b[0m \x1b[1;36m${modelVal}\x1b[0m`);
+                      changed++;
+                    }
+                  } else {
+                    console.log(`  \x1b[90m▪ ${agentKey}.md no encontrado (saltando)\x1b[0m`);
+                  }
+                });
+                console.log("  \x1b[38;5;239m──────────────────────────────────────────────────────────────\x1b[0m");
+                console.log(`  \x1b[32m✓ ${changed} agente(s) actualizados correctamente.\x1b[0m\n`);
+              } catch (e) {
+                console.log(`  \x1b[31m⚠ Error aplicando modelos: ${e.message}\x1b[0m`);
+              }
+            '
+            ;;
+        status)
+            echo -e "  ${COLOR_HEADER}📊 Modelos actuales por agente:${NC}"
+            echo -e "  ${COLOR_BORDER}──────────────────────────────────────────────────────────────${NC}"
+            for f in "${agents_dir}"/*.md; do
+                local name model
+                name=$(basename "$f" .md)
+                model=$(grep '^model:' "$f" 2>/dev/null | head -n1 | sed 's/^model:[[:space:]]*//')
+                if [ -n "$model" ]; then
+                    printf "  ${COLOR_MUTED}%-20s${NC} ${COLOR_HEADER}%s${NC}\n" "$name" "$model"
+                fi
+            done
+            echo -e "  ${COLOR_BORDER}──────────────────────────────────────────────────────────────${NC}"
+            echo -e "  ${COLOR_MUTED}Archivo de config:${NC} ${models_file}\n"
+            ;;
+        preset)
+            local preset_name="${2:-default}"
+            echo -e "  ${COLOR_HEADER}🎨 Aplicando preset '${preset_name}' desde ${models_file}...${NC}"
+            echo -e "  ${COLOR_BORDER}──────────────────────────────────────────────────────────────${NC}"
+            node -e '
+              const fs = require("fs");
+              const path = require("path");
+              const modelsFile = "'"$models_file"'";
+              const destAgentsDir = "'"$agents_dir"'";
+              const presetName = "'"$preset_name"'";
+              try {
+                const data = JSON.parse(fs.readFileSync(modelsFile, "utf-8"));
+                const models = data.presets?.[presetName] || {};
+                if (Object.keys(models).length === 0) {
+                  throw new Error(`Preset "${presetName}" no encontrado en el archivo de modelos.`);
+                }
+                let changed = 0;
+                Object.entries(models).forEach(([agentKey, modelVal]) => {
+                  const agentFile = path.join(destAgentsDir, `${agentKey}.md`);
+                  if (fs.existsSync(agentFile)) {
+                    let content = fs.readFileSync(agentFile, "utf-8");
+                    if (content.match(/^model:/m)) {
+                      content = content.replace(/^model:.*/m, `model: ${modelVal}`);
+                      fs.writeFileSync(agentFile, content, "utf-8");
+                      console.log(`  \x1b[32m✓\x1b[0m \x1b[90m${agentKey}\x1b[0m \x1b[34m→\x1b[0m \x1b[1;36m${modelVal}\x1b[0m`);
+                      changed++;
+                    }
+                  } else {
+                    console.log(`  \x1b[90m▪ ${agentKey}.md no encontrado (saltando)\x1b[0m`);
+                  }
+                });
+                console.log("  \x1b[38;5;239m──────────────────────────────────────────────────────────────\x1b[0m");
+                console.log(`  \x1b[32m✓ Preset "${presetName}" aplicado correctamente en ${changed} agente(s).\x1b[0m\n`);
+              } catch (e) {
+                console.log(`  \x1b[31m⚠ Error aplicando preset: ${e.message}\x1b[0m`);
+              }
+            '
+            ;;
+        *)
+            echo -e "  ${COLOR_ERROR}\u274c Subcomando desconocido: '${subcommand}'${NC}"
+            echo -e "  Uso: ./sdd models [apply|status|preset <nombre>]\n"
+            exit 1
+            ;;
+    esac
+}
+
+# Entry point
+case "$1" in
+    status)
+        print_header
+        show_status
+        ;;
+    init)
+        print_header
+        perform_init
+        ;;
+    "")
+        if [ -t 0 ] && [ -t 1 ]; then
+            show_interactive_menu
+        else
+            print_header
+            show_status
+        fi
+        ;;
+    rollback)
+        print_header
+        perform_rollback
+        ;;
+    clean)
+        print_header
+        perform_clean
+        ;;
+    validate)
+        print_header
+        validate_schemas
+        ;;
+    test)
+        print_header
+        run_test
+        ;;
+    lint)
+        print_header
+        run_lint
+        ;;
+    dashboard)
+        print_header
+        generate_and_open_dashboard
+        ;;
+    models)
+        print_header
+        manage_models "${2:-status}" "$3"
+        ;;
+    help|--help|-h)
+        print_header
+        echo -e "  ${COLOR_HEADER}Uso:${NC} ./sdd [comando] o ./.openspec/sdd [comando]"
+        echo ""
+        echo -e "  ${COLOR_HEADER}Comandos v\u00e1lidos:${NC}"
+        echo -e "    ${COLOR_SUCCESS}init${NC}             - Inicializa el arnés, instala dependencias/linters y corre el Paso 0"
+        echo -e "    ${COLOR_SUCCESS}status${NC}           - Muestra la barra de progreso agrupada en hitos (por defecto)"
+        echo -e "    ${COLOR_SUCCESS}validate${NC}         - Audita estructuralmente las especificaciones y archivos de cambio"
+        echo -e "    ${COLOR_SUCCESS}test${NC}             - Ejecuta de forma nativa la suite de pruebas del proyecto"
+        echo -e "    ${COLOR_SUCCESS}lint${NC}             - Ejecuta el linter o verificador est\u00e1tico de c\u00f3digo local"
+        echo -e "    ${COLOR_SUCCESS}dashboard${NC}        - Abre el dashboard interactivo en tu navegador"
+        echo -e "    ${COLOR_SUCCESS}rollback${NC}         - Descarta de forma segura cambios Git locales no confirmados"
+        echo -e "    ${COLOR_SUCCESS}clean${NC}            - Purga logs de fallos, registros temporales y resetea a Fase 0"
+        echo -e "    ${COLOR_SUCCESS}models status${NC}    - Muestra el modelo activo de cada agente"
+        echo -e "    ${COLOR_SUCCESS}models apply${NC}     - Aplica los modelos de zugz-models.json a los agentes"
+        echo -e "    ${COLOR_SUCCESS}models preset X${NC}  - Aplica un preset (free / balanced / turbo)"
+        echo -e "    ${COLOR_SUCCESS}help${NC}             - Muestra esta tarjeta informativa de comandos"
+        echo ""
+        ;;
+    *)
+        echo -e "${COLOR_ERROR}Comando no reconocido: '$1'${NC}"
+        echo -e "Usa './sdd help' para ver la lista de comandos disponibles."
+        exit 1
+        ;;
+esac