specleap-framework 2.1.12 → 2.1.14

package/CHANGELOG.md

@@ -7,6 +7,53 @@ 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
+
+- **Confusion between the two install flows.** Reported by Styng during testing: with `git clone … && bash setup.sh`, the installer was not asking the carpeta-base / folder-name prompts that `bin/specleap` (the npx entry point) does ask. That looked like a regression but it's by design — the prompts live in `bin/specleap` (Node), not in `setup.sh` (bash). When the user clones with git they already chose where the code lives, and the second positional argument of `git clone` is the canonical way to set a custom folder name. The fix is making the difference obvious in docs and in runtime.
+
+#### Changes
+
+- `setup.sh` now prints a bilingual heads-up at the very start (before the language step) when the current folder is named `specleap-framework` (the `git clone` default) AND the script was invoked without `bin/specleap` having set `SPECLEAP_INSTALL_PATH`. The user gets a one-second pause, an explanation of how to clone with a custom name (`git clone <url> mi-proyecto`), and a [S/n] confirmation before continuing. If they cancel, the script exits 0 cleanly.
+- `README.md`: rewrote the "Instalación Rápida" section as two clearly-labeled options (Opción A: vía npx — interactive prompts; Opción B: vía git clone — direct, name controlled by `git clone <url> <nombre>`) plus a comparison table so the reader picks intentionally.
+- `SETUP.md`: replicated the same comparison upfront in the Quick Start section, with full examples for each path.
+
+### Notes
+
+- No code-path change in the actual installation logic. `bin/specleap` keeps its prompts; `setup.sh` runs the same setup it always ran. Only documentation and a single pre-check in `setup.sh` change.
+- The pre-check in `setup.sh` is opt-out (Enter or `S` to continue), so users who really want a folder named `specleap-framework` aren't forced to do anything extra.
+
 ## [2.1.12] - 2026-04-30
 
 ### Added

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.12 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
+**Versión actual:** 2.1.14 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
 
 ---
 
@@ -44,13 +44,31 @@ SpecLeap convierte cualquier IDE con asistente de IA en un entorno de desarrollo
 
 ## Instalación Rápida
 
-### Vía npm (recomendado)
+Hay dos formas de instalar SpecLeap. Elige según tu preferencia:
+
+### Opción A: Vía npm (instalación interactiva, recomendado)
 
 ```bash
 npx specleap-framework@latest
 ```
 
-### Desde GitHub
+El instalador te **pregunta dónde quieres la carpeta y con qué nombre** antes de copiar nada. Ideal si quieres un setup guiado paso a paso.
+
+Ejemplo de lo que verás:
+
+```
+📁 ¿En qué carpeta base instalar SpecLeap?
+   Default: /Users/tu-usuario/Desktop
+Carpeta base: ~/Downloads
+
+📝 ¿Qué nombre quieres para la carpeta?
+   Default: specleap-framework
+Nombre: mi-app-tienda
+
+→ Resultado: /Users/tu-usuario/Downloads/mi-app-tienda/
+```
+
+### Opción B: Vía git clone (control desde la terminal)
 
 ```bash
 git clone https://github.com/ConceptualCreative/specleap-framework.git
@@ -58,9 +76,32 @@ cd specleap-framework
 bash setup.sh
 ```
 
-El instalador interactivo solicita los tokens de GitHub y Asana, instala los 34 Agent Skills en `~/.skills/` y genera la estructura base. Tiempo total: 10 a 15 minutos.
+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.
+
+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
+
+| | Vía npm | Vía git clone |
+|---|---|---|
+| **Pregunta carpeta y nombre** | ✅ Sí, interactivo | ❌ No, lo decides con `cd` y `git clone <url> <nombre>` |
+| **Requiere Node.js** | ✅ Sí (≥ 18) | ⛔ No, solo Git + Bash |
+| **Trae los archivos** | npm los descarga | git los clona del repo |
+| **Ideal para** | Empezar rápido, no recordar el flujo de git | Devs que ya manejan git fluidamente |
+
+A partir de aquí ambos flows son idénticos: el `setup.sh` solicita los tokens de GitHub y Asana, instala los 34 Agent Skills en `~/.skills/` y genera la estructura base. Tiempo total: 10 a 15 minutos.
+
+**Requisitos previos:**
 
-**Requisitos previos:** Node.js ≥ 18, Git, Bash.
+- Vía npm → Node.js ≥ 18, Git, Bash.
+- Vía git clone → Git, Bash.
 
 ---
 

package/SETUP.md

@@ -2,23 +2,76 @@
 
 ## ⚡ Quick Start (5 minutos)
 
-### Paso 1: Clonar el repositorio
+Hay **dos formas de instalar SpecLeap**. Elige la que prefieras según cómo te resulte más cómodo trabajar.
+
+### Comparativa rápida
+
+| | Opción A: vía npx | Opción B: vía git clone |
+|---|---|---|
+| **Pregunta carpeta y nombre** | ✅ Sí, prompt interactivo | ❌ No (lo decides con `cd` y `git clone <url> <nombre>`) |
+| **Requiere** | Node.js ≥ 18, Git, Bash | Git, Bash |
+| **Cuándo usar** | Quieres setup guiado | Manejas git fluidamente |
+
+---
+
+### Opción A: vía npx (recomendado para empezar)
+
+```bash
+cd ~/Downloads      # o donde quieras que vaya el proyecto
+npx specleap-framework@latest
+```
+
+El instalador te pregunta:
+1. **Carpeta base** (default = donde estás).
+2. **Nombre de la carpeta** (default = `specleap-framework`).
+
+Después continúa con el setup normal (idioma, GitHub token, Asana token, skills, CodeRabbit).
+
+**Ejemplo:**
+
+```
+📁 ¿En qué carpeta base instalar SpecLeap?
+   Default: /Users/tu-usuario/Downloads
+Carpeta base: (Enter para usar default)
+
+📝 ¿Qué nombre quieres para la carpeta?
+   Default: specleap-framework
+Nombre: mi-app-tienda
+
+→ Resultado final: /Users/tu-usuario/Downloads/mi-app-tienda/
+```
+
+---
+
+### Opción B: vía git clone
 
 ```bash
 git clone https://github.com/ConceptualCreative/specleap-framework.git
 cd specleap-framework
+bash setup.sh
 ```
 
-### Paso 2: Ejecutar instalador
+**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.
+
+Atajo: si ya sabes el nombre, pásaselo a `git clone` y luego pulsas Enter en el Paso 0 para mantenerlo:
 
 ```bash
-bash install.sh
+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"
 ```
 
-**Qué hace:**
+---
+
+### Después del setup (ambas opciones)
+
+**Qué hace `setup.sh`:**
 - Selecciona idioma (Español/English)
-- Crea estructura de carpetas
-- Genera archivos base
+- Pide tokens GitHub y Asana
+- Instala los 34 Agent Skills en `~/.skills/`
+- Configura CodeRabbit
+- Crea estructura base + archivos de configuración
 
 ### Paso 3: Responder cuestionario
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specleap-framework",
-  "version": "2.1.12",
+  "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

@@ -48,6 +48,87 @@ echo -e "${YELLOW}  v2.0.0 — Instalador Profesional${NC}"
 echo -e "${CYAN}${LINE}${NC}"
 echo ""
 
+# ============================================
+# PASO 0: Nombre de la carpeta del proyecto
+# ============================================
+# 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 ""
+    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
+
 # ============================================
 # PASO 1: Selección de Idioma
 # ============================================