specleap-framework 2.1.7 → 2.1.8

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.8] - 2026-04-26
+
+### Fixed
+
+- **`setup.sh` token validation no longer aborts on the first wrong input.** Both the GitHub and the Asana token prompts now retry up to 3 times before asking the user whether to retry the round again or cancel the installation. Empty input doesn't consume an attempt (it's almost always a paste/typo, not a real failure). Reported by Styng during a manual test where pasting a partial Asana token killed the installer outright with no recovery path.
+
+#### Behavioural details
+
+- 3 attempts per round, then the installer prints the actual count and asks `[R]eintentar / [C]ancelar` (Spanish) or `[R]etry / [C]ancel` (English) depending on the chosen language.
+- Choosing `R` (default) resets the attempt counter and lets the user try 3 more times — useful when they realise mid-prompt that they grabbed the wrong token.
+- Choosing `C` exits cleanly with code 1 and the message `Instalación cancelada por el usuario` / `Installation cancelled by user`.
+- After every invalid token, a tip is printed reminding the user about required scopes (GitHub: `repo`, `workflow`) or token format (Asana: Personal Access Token).
+- Empty token input prints a localised reminder of the expected format and re-prompts without spending an attempt.
+
+No changes to the validation logic itself (still calls `https://api.github.com/user` and `https://app.asana.com/api/1.0/workspaces`), so behaviour with valid tokens is unchanged.
+
 ## [2.1.7] - 2026-04-25
 
 ### 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.7 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
+**Versión actual:** 2.1.8 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
 
 ---
 

package/package.json

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

package/setup.sh

@@ -167,22 +167,70 @@ else
     echo ""
 fi
 
-read -p "$(echo -e ${YELLOW}GitHub Token:${NC} )" GITHUB_TOKEN
-echo ""
+# Validación con reintentos: hasta 3 intentos antes de pedir abort/reintentar
+GITHUB_USER=""
+GITHUB_ATTEMPT=0
+GITHUB_MAX_ATTEMPTS=3
 
-if [ -z "$GITHUB_TOKEN" ]; then
-    echo -e "${RED}$MSG_ERROR GitHub token is required${NC}"
-    exit 1
-fi
+while [ -z "$GITHUB_USER" ]; do
+    GITHUB_ATTEMPT=$((GITHUB_ATTEMPT + 1))
 
-# Verificar token
-echo -ne "Verificando token... "
-GITHUB_USER=$(curl -s -H "Authorization: token $GITHUB_TOKEN" https://api.github.com/user | grep -o '"login": "[^"]*' | cut -d'"' -f4)
+    read -p "$(echo -e ${YELLOW}GitHub Token:${NC} )" GITHUB_TOKEN
+    echo ""
 
-if [ -z "$GITHUB_USER" ]; then
-    echo -e "${RED}❌ Token inválido${NC}"
-    exit 1
-fi
+    if [ -z "$GITHUB_TOKEN" ]; then
+        if [ "$LANG" = "es" ]; then
+            echo -e "${RED}❌ Token vacío. Pega tu token de GitHub.${NC}"
+        else
+            echo -e "${RED}❌ Empty token. Paste your GitHub token.${NC}"
+        fi
+        echo ""
+        # No cuenta como intento si está vacío (probable typo / pegado mal)
+        GITHUB_ATTEMPT=$((GITHUB_ATTEMPT - 1))
+        continue
+    fi
+
+    # Verificar token contra la API de GitHub
+    echo -ne "Verificando token... "
+    GITHUB_USER=$(curl -s -H "Authorization: token $GITHUB_TOKEN" https://api.github.com/user | grep -o '"login": "[^"]*' | cut -d'"' -f4)
+
+    if [ -z "$GITHUB_USER" ]; then
+        echo -e "${RED}❌ Token inválido${NC}"
+        echo ""
+
+        if [ "$GITHUB_ATTEMPT" -ge "$GITHUB_MAX_ATTEMPTS" ]; then
+            if [ "$LANG" = "es" ]; then
+                echo -e "${YELLOW}⚠️  Has fallado $GITHUB_MAX_ATTEMPTS veces.${NC}"
+                read -p "$(echo -e ${YELLOW}¿[R]eintentar o [C]ancelar instalación? [R/c]:${NC} )" RETRY_CHOICE
+            else
+                echo -e "${YELLOW}⚠️  You've failed $GITHUB_MAX_ATTEMPTS times.${NC}"
+                read -p "$(echo -e ${YELLOW}[R]etry or [C]ancel installation? [R/c]:${NC} )" RETRY_CHOICE
+            fi
+
+            if [[ "$RETRY_CHOICE" =~ ^[Cc]$ ]]; then
+                if [ "$LANG" = "es" ]; then
+                    echo -e "${RED}Instalación cancelada por el usuario.${NC}"
+                else
+                    echo -e "${RED}Installation cancelled by user.${NC}"
+                fi
+                exit 1
+            fi
+            # Reset contador para nueva ronda de 3 intentos
+            GITHUB_ATTEMPT=0
+            echo ""
+            continue
+        fi
+
+        if [ "$LANG" = "es" ]; then
+            echo "Intenta de nuevo (intento $((GITHUB_ATTEMPT + 1))/$GITHUB_MAX_ATTEMPTS)."
+            echo "Verifica que el token tenga los permisos: repo, workflow."
+        else
+            echo "Try again (attempt $((GITHUB_ATTEMPT + 1))/$GITHUB_MAX_ATTEMPTS)."
+            echo "Make sure the token has the scopes: repo, workflow."
+        fi
+        echo ""
+    fi
+done
 
 echo -e "${GREEN}✅ Token válido (Usuario: $GITHUB_USER)${NC}"
 echo ""
@@ -227,65 +275,113 @@ else
     echo ""
 fi
 
-read -p "$(echo -e ${YELLOW}Asana Token:${NC} )" ASANA_TOKEN
-echo ""
-
-if [ -z "$ASANA_TOKEN" ]; then
-    echo -e "${RED}$MSG_ERROR Asana token is required${NC}"
-    exit 1
-fi
+# Validación con reintentos: hasta 3 intentos antes de pedir abort/reintentar
+ASANA_VALID=""
+ASANA_ATTEMPT=0
+ASANA_MAX_ATTEMPTS=3
 
-# Verificar token y obtener workspace
-echo -ne "Verificando token Asana... "
-ASANA_RESPONSE=$(curl -s -H "Authorization: Bearer $ASANA_TOKEN" https://app.asana.com/api/1.0/workspaces)
+while [ -z "$ASANA_VALID" ]; do
+    ASANA_ATTEMPT=$((ASANA_ATTEMPT + 1))
 
-if echo "$ASANA_RESPONSE" | grep -q '"gid"'; then
-    echo -e "${GREEN}✅ Token válido${NC}"
+    read -p "$(echo -e ${YELLOW}Asana Token:${NC} )" ASANA_TOKEN
     echo ""
-    
-    # Listar workspaces disponibles
-    if [ "$LANG" = "es" ]; then
-        echo "Workspaces disponibles:"
-    else
-        echo "Available workspaces:"
+
+    if [ -z "$ASANA_TOKEN" ]; then
+        if [ "$LANG" = "es" ]; then
+            echo -e "${RED}❌ Token vacío. Pega tu token de Asana (empieza con '0/' o '1/' o '2/').${NC}"
+        else
+            echo -e "${RED}❌ Empty token. Paste your Asana token (starts with '0/' or '1/' or '2/').${NC}"
+        fi
+        echo ""
+        ASANA_ATTEMPT=$((ASANA_ATTEMPT - 1))
+        continue
     fi
-    echo ""
-    
-    # Extraer workspaces (simple parsing)
-    WORKSPACE_COUNT=0
-    while IFS= read -r line; do
-        if echo "$line" | grep -q '"gid"'; then
-            WORKSPACE_COUNT=$((WORKSPACE_COUNT + 1))
-            WS_GID=$(echo "$line" | grep -o '"gid":"[^"]*' | cut -d'"' -f4)
-            WS_NAME=$(echo "$ASANA_RESPONSE" | grep -A1 "\"gid\":\"$WS_GID\"" | grep '"name"' | grep -o '"name":"[^"]*' | cut -d'"' -f4)
-            echo "  $WORKSPACE_COUNT) $WS_NAME (ID: $WS_GID)"
-            
-            # Guardar primer workspace como default
-            if [ $WORKSPACE_COUNT -eq 1 ]; then
-                DEFAULT_WORKSPACE_ID="$WS_GID"
+
+    # Verificar token y obtener workspace
+    echo -ne "Verificando token Asana... "
+    ASANA_RESPONSE=$(curl -s -H "Authorization: Bearer $ASANA_TOKEN" https://app.asana.com/api/1.0/workspaces)
+
+    if echo "$ASANA_RESPONSE" | grep -q '"gid"'; then
+        echo -e "${GREEN}✅ Token válido${NC}"
+        ASANA_VALID="yes"
+    else
+        echo -e "${RED}❌ Token inválido${NC}"
+        echo ""
+
+        if [ "$ASANA_ATTEMPT" -ge "$ASANA_MAX_ATTEMPTS" ]; then
+            if [ "$LANG" = "es" ]; then
+                echo -e "${YELLOW}⚠️  Has fallado $ASANA_MAX_ATTEMPTS veces.${NC}"
+                read -p "$(echo -e ${YELLOW}¿[R]eintentar o [C]ancelar instalación? [R/c]:${NC} )" RETRY_CHOICE
+            else
+                echo -e "${YELLOW}⚠️  You've failed $ASANA_MAX_ATTEMPTS times.${NC}"
+                read -p "$(echo -e ${YELLOW}[R]etry or [C]ancel installation? [R/c]:${NC} )" RETRY_CHOICE
+            fi
+
+            if [[ "$RETRY_CHOICE" =~ ^[Cc]$ ]]; then
+                if [ "$LANG" = "es" ]; then
+                    echo -e "${RED}Instalación cancelada por el usuario.${NC}"
+                else
+                    echo -e "${RED}Installation cancelled by user.${NC}"
+                fi
+                exit 1
             fi
+            ASANA_ATTEMPT=0
+            echo ""
+            continue
         fi
-    done < <(echo "$ASANA_RESPONSE" | grep '"gid"')
-    
-    echo ""
-    if [ "$LANG" = "es" ]; then
-        read -p "$(echo -e ${YELLOW}Workspace ID [Enter para usar el primero]:${NC} )" ASANA_WORKSPACE_INPUT
-    else
-        read -p "$(echo -e ${YELLOW}Workspace ID [Enter to use first]:${NC} )" ASANA_WORKSPACE_INPUT
+
+        if [ "$LANG" = "es" ]; then
+            echo "Intenta de nuevo (intento $((ASANA_ATTEMPT + 1))/$ASANA_MAX_ATTEMPTS)."
+            echo "Verifica que el token sea Personal Access Token de Asana."
+        else
+            echo "Try again (attempt $((ASANA_ATTEMPT + 1))/$ASANA_MAX_ATTEMPTS)."
+            echo "Make sure the token is an Asana Personal Access Token."
+        fi
+        echo ""
     fi
-    
-    if [ -z "$ASANA_WORKSPACE_INPUT" ]; then
-        ASANA_WORKSPACE_ID="$DEFAULT_WORKSPACE_ID"
-    else
-        ASANA_WORKSPACE_ID="$ASANA_WORKSPACE_INPUT"
+done
+
+echo ""
+
+# Listar workspaces disponibles
+if [ "$LANG" = "es" ]; then
+    echo "Workspaces disponibles:"
+else
+    echo "Available workspaces:"
+fi
+echo ""
+
+# Extraer workspaces (simple parsing)
+WORKSPACE_COUNT=0
+while IFS= read -r line; do
+    if echo "$line" | grep -q '"gid"'; then
+        WORKSPACE_COUNT=$((WORKSPACE_COUNT + 1))
+        WS_GID=$(echo "$line" | grep -o '"gid":"[^"]*' | cut -d'"' -f4)
+        WS_NAME=$(echo "$ASANA_RESPONSE" | grep -A1 "\"gid\":\"$WS_GID\"" | grep '"name"' | grep -o '"name":"[^"]*' | cut -d'"' -f4)
+        echo "  $WORKSPACE_COUNT) $WS_NAME (ID: $WS_GID)"
+
+        # Guardar primer workspace como default
+        if [ $WORKSPACE_COUNT -eq 1 ]; then
+            DEFAULT_WORKSPACE_ID="$WS_GID"
+        fi
     fi
-    
-    echo -e "${GREEN}✅ Workspace seleccionado: $ASANA_WORKSPACE_ID${NC}"
+done < <(echo "$ASANA_RESPONSE" | grep '"gid"')
+
+echo ""
+if [ "$LANG" = "es" ]; then
+    read -p "$(echo -e ${YELLOW}Workspace ID [Enter para usar el primero]:${NC} )" ASANA_WORKSPACE_INPUT
 else
-    echo -e "${RED}❌ Token inválido${NC}"
-    exit 1
+    read -p "$(echo -e ${YELLOW}Workspace ID [Enter to use first]:${NC} )" ASANA_WORKSPACE_INPUT
+fi
+
+if [ -z "$ASANA_WORKSPACE_INPUT" ]; then
+    ASANA_WORKSPACE_ID="$DEFAULT_WORKSPACE_ID"
+else
+    ASANA_WORKSPACE_ID="$ASANA_WORKSPACE_INPUT"
 fi
 
+echo -e "${GREEN}✅ Workspace seleccionado: $ASANA_WORKSPACE_ID${NC}"
+
 echo ""
 sleep 1