specleap-framework 2.1.13 → 2.1.14

package/CHANGELOG.md

@@ -7,6 +7,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.14] - 2026-05-01
+
+### Changed
+
+- **`setup.sh` ahora pregunta SIEMPRE el nombre de la carpeta como Paso 0**, antes de la selección de idioma y antes de pedir cualquier token. Si el usuario escribe un nombre distinto al actual, el script renombra la carpeta in-place (`mv`) y sigue trabajando desde el nuevo path. Si pulsa Enter, se mantiene el nombre que ya tiene.
+- El warning condicional introducido en v2.1.13 (que solo aparecía cuando la carpeta se llamaba exactamente `specleap-framework`) se elimina: el nuevo prompt activo lo reemplaza por completo, sin importar cómo se llame la carpeta de partida.
+
+#### Por qué
+
+Reportado por Styng tras testear v2.1.13: él esperaba un prompt activo, no un warning condicional. Con `git clone <url> mi-proyecto && cd mi-proyecto && bash setup.sh`, la v2.1.13 no preguntaba nada porque la carpeta no se llamaba `specleap-framework` (el filtro original era demasiado estrecho). Ahora el flujo es uniforme: el usuario siempre tiene la oportunidad de elegir el nombre, sin tener que recordar la sintaxis del segundo argumento de `git clone`.
+
+#### Detalles del flujo
+
+- Validación del nombre: letras, números, `-`, `_` y `.`, no puede empezar con `.`, máximo 100 caracteres. El prompt re-pregunta hasta que sea válido.
+- Si el nombre escrito coincide con el actual, no hace `mv` (no-op), simplemente continúa.
+- Si el nuevo path ya existe, se mantiene el nombre actual y se imprime un aviso (no aborta el setup).
+- Si `SPECLEAP_INSTALL_PATH` ya está set (caso `npx` que pasa por `bin/specleap`), el bloque se salta entero — `bin/specleap` ya pidió el nombre antes de copiar archivos.
+- El proceso bash sobrevive al `mv` del directorio activo porque mantiene el inode, no el path; tras el rename hace `cd` al nuevo path antes de continuar.
+
+#### Tests cubiertos (4 escenarios, todos pasaron)
+
+1. Enter en una carpeta llamada `specleap-framework` → mantiene nombre, no renombra.
+2. Carpeta `mi-proyecto` + nombre nuevo `tienda-online` → renombra, vieja desaparece, nueva existe.
+3. Carpeta `inicio` + nombre inválido `mi proyecto con espacios` + nombre válido `mi-proyecto-valido` → re-pregunta y luego renombra.
+4. Carpeta `specleap-framework` + `SPECLEAP_INSTALL_PATH` set → no pregunta, va directo a Paso 1/6.
+
+### Updated
+
+- `README.md` y `SETUP.md`: la sección "Opción B: vía git clone" ahora explica que `setup.sh` pregunta el nombre como Paso 0 y que pasarlo a `git clone` es solo un atajo, no una obligación.
+
 ## [2.1.13] - 2026-05-01
 
 ### Fixed

package/README.md

@@ -20,7 +20,7 @@
 
 SpecLeap convierte cualquier IDE con asistente de IA en un entorno de desarrollo spec-first. Combina un contrato de proyecto inmutable, agentes conversacionales especializados, 34 Agent Skills profesionales y un pipeline de validación en tres capas para entregar código consistente y probado sin improvisación.
 
-**Versión actual:** 2.1.13 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
+**Versión actual:** 2.1.14 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
 
 ---
 
@@ -68,17 +68,24 @@ Nombre: mi-app-tienda
 → Resultado: /Users/tu-usuario/Downloads/mi-app-tienda/
 ```
 
-### Opción B: Vía git clone (control directo, sin prompts)
+### Opción B: Vía git clone (control desde la terminal)
 
 ```bash
-git clone https://github.com/ConceptualCreative/specleap-framework.git mi-proyecto
-cd mi-proyecto
+git clone https://github.com/ConceptualCreative/specleap-framework.git
+cd specleap-framework
 bash setup.sh
 ```
 
-Aquí **tú decides el nombre** pasándolo como segundo argumento de `git clone`. El setup arranca directo, sin preguntar carpeta/nombre porque ya estás dentro del repo donde quieres.
+Cuando arranque `setup.sh` lo primero que te preguntará es **cómo quieres que se llame la carpeta** del proyecto. Si pulsas Enter mantiene el nombre que tiene (`specleap-framework` por default de git clone). Si escribes otro nombre, **el setup renombra la carpeta automáticamente** y continúa desde ahí. Después sigue con idioma, tokens, skills y CodeRabbit.
 
-Si haces `git clone <url>` sin segundo argumento, la carpeta se llamará `specleap-framework` (default de git). El setup te avisará por si querías otro nombre.
+Atajo: si ya sabes el nombre, lo pasas a `git clone` para evitar el rename:
+
+```bash
+git clone https://github.com/ConceptualCreative/specleap-framework.git mi-proyecto
+cd mi-proyecto
+bash setup.sh
+# El setup pregunta el nombre igualmente; pulsa Enter para mantener "mi-proyecto".
+```
 
 ### Diferencias rápidas
 

package/SETUP.md

@@ -46,15 +46,21 @@ Nombre: mi-app-tienda
 ### Opción B: vía git clone
 
 ```bash
-# Clona el repo con el nombre que tú quieras (segundo argumento de git clone)
-git clone https://github.com/ConceptualCreative/specleap-framework.git mi-proyecto
-cd mi-proyecto
+git clone https://github.com/ConceptualCreative/specleap-framework.git
+cd specleap-framework
 bash setup.sh
 ```
 
-Aquí **no hay prompts de carpeta o nombre** — ya estás dentro de `mi-proyecto/` que tú nombraste con git. El `setup.sh` arranca directo con la selección de idioma.
+**El primer paso del setup pregunta cómo quieres llamar la carpeta** (Paso 0). Pulsas Enter para mantenerla con el nombre que tiene, o escribes otro nombre y el setup renombra la carpeta automáticamente antes de seguir con idioma/tokens.
 
-Si haces `git clone <url>` **sin segundo argumento**, la carpeta se llamará `specleap-framework` por defecto. El setup te avisará por si esperabas otro nombre y te ofrecerá cancelar.
+Atajo: si ya sabes el nombre, pásaselo a `git clone` y luego pulsas Enter en el Paso 0 para mantenerlo:
+
+```bash
+git clone https://github.com/ConceptualCreative/specleap-framework.git mi-proyecto
+cd mi-proyecto
+bash setup.sh
+# Paso 0: pulsa Enter para mantener "mi-proyecto"
+```
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specleap-framework",
-  "version": "2.1.13",
+  "version": "2.1.14",
   "description": "Spec-Driven Development Framework — Transform VSCode, Cursor, JetBrains into spec-first development machines",
   "keywords": [
     "spec-driven-development",

package/setup.sh

@@ -49,33 +49,82 @@ echo -e "${CYAN}${LINE}${NC}"
 echo ""
 
 # ============================================
-# PRE-CHECK: Aviso si la carpeta se llama "specleap-framework"
+# PASO 0: Nombre de la carpeta del proyecto
 # ============================================
-# Si el usuario clonó con `git clone <url>` (sin segundo argumento), la
-# carpeta se llamará "specleap-framework" por defecto. Le avisamos por si
-# quería otro nombre, antes de empezar el setup interactivo.
-# Solo aplica cuando setup.sh se ejecuta directamente (no via bin/specleap,
-# que ya pregunta nombre interactivamente). Detectamos este caso por
-# ausencia de la variable SPECLEAP_INSTALL_PATH (que solo la pone bin/specleap).
-
-CURRENT_FOLDER_NAME="$(basename "$(pwd)")"
-
-if [ -z "${SPECLEAP_INSTALL_PATH:-}" ] && [ "$CURRENT_FOLDER_NAME" = "specleap-framework" ]; then
-    echo "ℹ️  Esta carpeta se llama 'specleap-framework' (nombre por defecto de git clone)."
-    echo "   This folder is named 'specleap-framework' (git clone default)."
-    echo ""
-    echo "   Si querías otro nombre / If you wanted a different name:"
-    echo "     1) Cancela con Ctrl+C / Cancel with Ctrl+C"
-    echo "     2) Vuelve a ejecutar / Run again with:"
-    echo "        git clone https://github.com/ConceptualCreative/specleap-framework.git mi-proyecto"
-    echo "        cd mi-proyecto"
-    echo "        bash setup.sh"
-    echo ""
-    read -p "¿Continuar con el nombre 'specleap-framework'? / Continue with 'specleap-framework'? [S/n]: " CONTINUE_DEFAULT
-    if [[ "$CONTINUE_DEFAULT" =~ ^[Nn]$ ]]; then
+# Solo se pregunta cuando setup.sh se ejecuta DIRECTAMENTE (`bash setup.sh`
+# tras `git clone …`). Si vienes desde `bin/specleap` (vía `npx`) ese script
+# ya preguntó nombre y ya creó la carpeta — entonces SPECLEAP_INSTALL_PATH
+# está set y saltamos este bloque para no preguntar dos veces.
+#
+# Si el usuario escribe un nombre distinto al actual, el script RENOMBRA
+# la carpeta in-place: `mv` del directorio actual al nuevo y `cd` al nuevo.
+# El proceso bash sigue vivo durante el rename porque se aferra al inode,
+# no al path.
+
+CURRENT_PATH="$(pwd)"
+CURRENT_FOLDER_NAME="$(basename "$CURRENT_PATH")"
+PARENT_PATH="$(dirname "$CURRENT_PATH")"
+
+is_valid_folder_name() {
+    local name="$1"
+    [ -z "$name" ] && return 1
+    [ ${#name} -gt 100 ] && return 1
+    [[ "$name" == .* ]] && return 1
+    [[ "$name" =~ ^[A-Za-z0-9_][A-Za-z0-9_.\-]*$ ]] && return 0
+    return 1
+}
+
+if [ -z "${SPECLEAP_INSTALL_PATH:-}" ]; then
+    echo "📝 ¿Cómo quieres que se llame la carpeta del proyecto?"
+    echo "   What name do you want for the project folder?"
+    echo ""
+    echo "   Carpeta actual / Current: $CURRENT_FOLDER_NAME"
+    echo "   Default si pulsas Enter / Default on Enter: specleap-framework"
+    echo "   Permitido / Allowed: letras, números, '-', '_', '.'"
+    echo ""
+
+    while true; do
+        read -p "Nombre / Name: " RAW_NAME
+        # Si Enter vacío → default 'specleap-framework'
+        # Excepto si ya se llama así y el user pulsa Enter, mantenemos
+        if [ -z "$RAW_NAME" ]; then
+            NEW_NAME="specleap-framework"
+        else
+            NEW_NAME="$RAW_NAME"
+        fi
+
+        if is_valid_folder_name "$NEW_NAME"; then
+            break
+        fi
+
+        echo ""
+        echo "❌ Nombre inválido / Invalid name: \"$NEW_NAME\""
+        echo "   Usa solo letras, números, '-', '_' y '.' (no empezar con '.')"
+        echo "   Use only letters, numbers, '-', '_' and '.' (cannot start with '.')"
         echo ""
-        echo "Cancelado por el usuario / Cancelled by user."
-        exit 0
+    done
+
+    # Si el nombre coincide con el actual, no renombramos
+    if [ "$NEW_NAME" = "$CURRENT_FOLDER_NAME" ]; then
+        echo ""
+        echo "✅ Carpeta: $CURRENT_FOLDER_NAME"
+        SPECLEAP_INSTALL_PATH="$CURRENT_PATH"
+    else
+        NEW_PATH="$PARENT_PATH/$NEW_NAME"
+        if [ -e "$NEW_PATH" ]; then
+            echo ""
+            echo "❌ Ya existe / Already exists: $NEW_PATH"
+            echo "   Se mantiene el nombre actual / Keeping current name: $CURRENT_FOLDER_NAME"
+            SPECLEAP_INSTALL_PATH="$CURRENT_PATH"
+        else
+            mv "$CURRENT_PATH" "$NEW_PATH"
+            cd "$NEW_PATH"
+            CURRENT_PATH="$NEW_PATH"
+            CURRENT_FOLDER_NAME="$NEW_NAME"
+            SPECLEAP_INSTALL_PATH="$NEW_PATH"
+            echo ""
+            echo "✅ Carpeta renombrada / Folder renamed: $NEW_NAME"
+        fi
     fi
     echo ""
 fi