specleap-framework 2.1.8 → 2.1.10

package/CHANGELOG.md

@@ -7,6 +7,47 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.10] - 2026-04-30
+
+### Added
+
+- **Installer now also asks for the folder name**, on top of the base folder prompt added in v2.1.9. The user can keep `specleap-framework` (the default) or pick a custom name like `mi-app-tienda` straight from the prompt — no more renaming after install with `mv`.
+- **Two-argument CLI form:** `npx specleap-framework@latest <base> [<name>]`. Both positional. If `<name>` is omitted, the prompt asks. If `<base>` is also omitted, both prompts run interactively.
+- **Folder name validation:** allows letters, numbers, `-`, `_` and `.`, must not start with `.`, must be ≤100 chars. Invalid input on the prompt re-asks until valid; invalid input on the CLI argument aborts with a clear bilingual error and exit 1.
+
+### Changed
+
+- The "ya existe" abort message now reads "elige otra carpeta o nombre" (instead of just "elige otra carpeta base"), matching the new flexibility.
+
+### Notes
+
+- Backwards compatible with v2.1.9: same env var (`SPECLEAP_INSTALL_PATH`) handed off to `setup.sh`, same final summary block, same fallback behaviour for direct `bash setup.sh` invocations.
+- Decision rationale: keep the prompt-based flow (no native GUI dialog) so the installer keeps working over SSH, in CI/CD pipelines and inside containers — exactly the kind of environments where a Mac-only `osascript` dialog would have broken things.
+
+## [2.1.9] - 2026-04-30
+
+### Added
+
+- **Interactive base-folder prompt during `npx specleap-framework@latest`.** The installer now asks where to install before copying anything. Previously it dropped the `specleap-framework/` folder silently into the user's current working directory, leaving them unsure of the final location.
+
+#### How it works
+
+- `bin/specleap` (the entry point invoked by `npx`) now accepts an optional CLI argument with the base folder, e.g. `npx specleap-framework@latest ~/Downloads`. If the argument is omitted, an interactive bilingual prompt asks for the base folder, with the current working directory as default.
+- The folder name is **always** `specleap-framework` (not configurable). If the user wants a different name, they rename it after install with `mv`.
+- The base path supports `~`, `~/relative`, plain relative paths, and absolute paths. The resolved path is shown back to the user before copying.
+- If the resolved target already exists, the installer aborts with a clear bilingual message instead of silently overwriting.
+- The installer creates the base folder if it does not exist.
+
+### Changed
+
+- **Final summary of `setup.sh` now prints the absolute install path prominently.** Block at the end of the installer reads `📍 SpecLeap instalado en: <ruta>` (or `📍 SpecLeap installed at: <path>` in English). Reported by Styng during v2.1.8 testing — after a long setup, the path was effectively lost in the scrollback.
+- **Next-steps list now starts with `cd "<install_path>"`** so the user knows how to reach the project regardless of where they ran `npx` from.
+
+### Notes
+
+- Backwards compatible: existing scripts that depend on `setup.sh` running from the project root still work — the env var `SPECLEAP_INSTALL_PATH` is set by `bin/specleap` but `setup.sh` falls back to `pwd` if absent.
+- The folder-name decision (always `specleap-framework`) keeps documentation, generated paths and tutorials consistent across users.
+
 ## [2.1.8] - 2026-04-26
 
 ### 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.8 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
+**Versión actual:** 2.1.10 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
 
 ---
 

package/bin/specleap

@@ -3,48 +3,201 @@
 const { spawn, execSync } = require('child_process');
 const path = require('path');
 const fs = require('fs');
+const readline = require('readline');
+const os = require('os');
 
-// Directorio del paquete npm (donde están todos los archivos)
+// Nombre por defecto de la carpeta destino. El usuario puede cambiarlo
+// en el prompt; si pulsa Enter, se usa este valor.
+const DEFAULT_FOLDER_NAME = 'specleap-framework';
+
+// Validador de nombre de carpeta: caracteres seguros para sistemas de
+// archivos cross-platform (sin `/`, sin nulos, sin barras). Permite letras,
+// números, guiones, guiones bajos y puntos. No puede empezar con punto.
+function isValidFolderName(name) {
+  if (!name || name.length === 0) return false;
+  if (name.length > 100) return false;
+  if (name.startsWith('.')) return false;
+  return /^[A-Za-z0-9_][A-Za-z0-9_.\-]*$/.test(name);
+}
+
+// Directorio del paquete npm (donde están todos los archivos a copiar)
 const packageDir = path.join(__dirname, '..');
 
-// Directorio donde el usuario ejecutó npx (su directorio de trabajo)
-const userCwd = process.cwd();
+// Resolver una ruta base introducida por el usuario:
+// - "~" o "~/algo" → expande a $HOME
+// - relativa → se resuelve contra cwd
+// - absoluta → se queda igual
+function resolveBasePath(input) {
+  const trimmed = input.trim();
+  if (!trimmed) return process.cwd();
+  if (trimmed === '~') return os.homedir();
+  if (trimmed.startsWith('~/')) return path.join(os.homedir(), trimmed.slice(2));
+  if (path.isAbsolute(trimmed)) return trimmed;
+  return path.resolve(process.cwd(), trimmed);
+}
 
-// Carpeta de destino
-const targetDir = path.join(userCwd, 'specleap-framework');
+// Crea una interfaz readline reutilizable; cerramos al final del flujo.
+function createPrompt() {
+  return readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+}
 
-console.log('\n🚀 Copiando SpecLeap Framework...\n');
+function ask(rl, question) {
+  return new Promise((resolve) => rl.question(question, (a) => resolve(a)));
+}
 
-// Verificar si ya existe
-if (fs.existsSync(targetDir)) {
-  console.error(`❌ Error: El directorio '${targetDir}' ya existe.`);
-  console.error('   Por favor elimínalo primero o ejecuta desde otro directorio.\n');
-  process.exit(1);
+// Pregunta la carpeta base donde poner el proyecto. Bilingüe porque el
+// idioma de SpecLeap se elige después dentro de setup.sh.
+async function askBasePath(rl, defaultBase) {
+  console.log('');
+  console.log('📁 ¿En qué carpeta base instalar SpecLeap?');
+  console.log('   Where do you want to install SpecLeap?');
+  console.log('');
+  console.log(`   Default: ${defaultBase}`);
+  console.log('');
+  console.log('   Ejemplos / Examples:');
+  console.log('     ~/Downloads        →  ~/Downloads/<nombre>');
+  console.log('     ~/Desktop/work     →  ~/Desktop/work/<nombre>');
+  console.log('     .                  →  ./<nombre>');
+  console.log('     (Enter)            →  default arriba');
+  console.log('');
+
+  const answer = await ask(rl, 'Carpeta base / Base folder: ');
+  return resolveBasePath(answer);
 }
 
-// Crear directorio destino
-try {
-  fs.mkdirSync(targetDir, { recursive: true });
-  
-  // Copiar todos los archivos del paquete
-  execSync(`cp -R "${packageDir}"/* "${targetDir}"/`, { stdio: 'inherit' });
-  execSync(`cp -R "${packageDir}"/.??* "${targetDir}"/ 2>/dev/null || true`, { stdio: 'ignore' });
-  
-  console.log(`✅ Archivos copiados a: ${targetDir}\n`);
-  
-} catch (err) {
-  console.error('❌ Error copiando archivos:', err.message);
-  process.exit(1);
+// Pregunta el nombre de la carpeta. Default = "specleap-framework".
+// Reintenta si el nombre tiene caracteres inválidos.
+async function askFolderName(rl) {
+  console.log('');
+  console.log('📝 ¿Qué nombre quieres para la carpeta?');
+  console.log('   What name do you want for the folder?');
+  console.log('');
+  console.log(`   Default: ${DEFAULT_FOLDER_NAME}`);
+  console.log('   Permitido / Allowed: letras, números, guiones, guiones bajos, puntos');
+  console.log('   No permitido / Not allowed: espacios, "/", caracteres especiales');
+  console.log('');
+
+  while (true) {
+    const answer = await ask(rl, 'Nombre / Name: ');
+    const name = answer.trim();
+
+    // Enter → default
+    if (!name) return DEFAULT_FOLDER_NAME;
+
+    if (isValidFolderName(name)) return name;
+
+    console.log('');
+    console.log(`❌ Nombre inválido / Invalid name: "${name}"`);
+    console.log('   Usa solo letras, números, "-", "_" y "." (sin empezar con ".")');
+    console.log('   Use only letters, numbers, "-", "_" and "." (cannot start with ".")');
+    console.log('');
+  }
 }
 
-// Ejecutar setup.sh DESDE el directorio copiado
-const setupPath = path.join(targetDir, 'setup.sh');
+async function main() {
+  // Argumentos CLI opcionales:
+  //   npx specleap-framework@latest <carpeta-base> [<nombre>]
+  //   p.ej.  npx specleap-framework@latest ~/Downloads
+  //          npx specleap-framework@latest ~/Downloads mi-app
+  const args = process.argv.slice(2).filter((a) => !a.startsWith('-'));
+  const argBase = args[0];
+  const argName = args[1];
 
-const setup = spawn('bash', [setupPath], {
-  stdio: 'inherit',
-  cwd: targetDir
-});
+  // Validar el nombre del argumento CLI antes de seguir
+  if (argName && !isValidFolderName(argName)) {
+    console.error(`\n❌ Nombre inválido / Invalid name: "${argName}"`);
+    console.error('   Usa solo letras, números, "-", "_" y "." (sin empezar con ".")');
+    console.error('   Use only letters, numbers, "-", "_" and "." (cannot start with ".")\n');
+    process.exit(1);
+  }
 
-setup.on('close', (code) => {
-  process.exit(code);
+  // Si hay argumentos CLI, no abrimos prompt; si faltan, preguntamos
+  let basePath, folderName;
+  const rl = (!argBase || !argName) ? createPrompt() : null;
+
+  try {
+    if (argBase) {
+      basePath = resolveBasePath(argBase);
+      console.log(`\n📁 Carpeta base: ${basePath}`);
+    } else {
+      basePath = await askBasePath(rl, process.cwd());
+    }
+
+    if (argName) {
+      folderName = argName;
+      console.log(`📝 Nombre de carpeta: ${folderName}`);
+    } else {
+      folderName = await askFolderName(rl);
+    }
+  } finally {
+    if (rl) rl.close();
+  }
+
+  // Verificar que la carpeta base existe (o se puede crear)
+  if (!fs.existsSync(basePath)) {
+    try {
+      fs.mkdirSync(basePath, { recursive: true });
+      console.log(`📂 Carpeta base creada / Base folder created: ${basePath}`);
+    } catch (err) {
+      console.error(`\n❌ No se pudo crear la carpeta base / Could not create base folder: ${basePath}`);
+      console.error(`   ${err.message}\n`);
+      process.exit(1);
+    }
+  }
+
+  const baseStat = fs.statSync(basePath);
+  if (!baseStat.isDirectory()) {
+    console.error(`\n❌ La ruta no es una carpeta / Path is not a directory: ${basePath}\n`);
+    process.exit(1);
+  }
+
+  // Destino final: <basePath>/<folderName>
+  const targetDir = path.join(basePath, folderName);
+
+  // No sobrescribir si ya existe
+  if (fs.existsSync(targetDir)) {
+    console.error(`\n❌ Ya existe / Already exists: ${targetDir}`);
+    console.error('   Elige otra carpeta o nombre, o elimina la existente.');
+    console.error('   Choose another folder or name, or delete the existing one.\n');
+    process.exit(1);
+  }
+
+  console.log(`\n🚀 Copiando SpecLeap Framework a / Copying SpecLeap Framework to:`);
+  console.log(`   ${targetDir}\n`);
+
+  // Crear destino y copiar archivos
+  try {
+    fs.mkdirSync(targetDir, { recursive: true });
+    execSync(`cp -R "${packageDir}"/* "${targetDir}"/`, { stdio: 'inherit' });
+    execSync(`cp -R "${packageDir}"/.??* "${targetDir}"/ 2>/dev/null || true`, { stdio: 'ignore' });
+    console.log(`✅ Archivos copiados / Files copied\n`);
+  } catch (err) {
+    console.error('❌ Error copiando archivos / Error copying files:', err.message);
+    process.exit(1);
+  }
+
+  // Ejecutar setup.sh DESDE el directorio copiado, exportando la ruta
+  // para que setup.sh la use en el mensaje final.
+  const setupPath = path.join(targetDir, 'setup.sh');
+
+  const setup = spawn('bash', [setupPath], {
+    stdio: 'inherit',
+    cwd: targetDir,
+    env: {
+      ...process.env,
+      SPECLEAP_INSTALL_PATH: targetDir
+    }
+  });
+
+  setup.on('close', (code) => {
+    process.exit(code);
+  });
+}
+
+main().catch((err) => {
+  console.error('\n❌ Error inesperado / Unexpected error:', err.message);
+  process.exit(1);
 });

package/package.json

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

package/setup.sh

@@ -516,43 +516,63 @@ echo "   ✅ $MSG_SUCCESS"
 echo -e "${NC}${GREEN}${LINE}${NC}"
 echo ""
 
+# Ruta de instalación: viene de bin/specleap como env var SPECLEAP_INSTALL_PATH.
+# Fallback a $PWD si alguien ejecutó setup.sh directamente sin pasar por bin.
+INSTALL_PATH="${SPECLEAP_INSTALL_PATH:-$(pwd)}"
+
+if [ "$LANG" = "es" ]; then
+    echo -e "${CYAN}${BOLD}📍 SpecLeap instalado en:${NC}"
+else
+    echo -e "${CYAN}${BOLD}📍 SpecLeap installed at:${NC}"
+fi
+echo -e "   ${BOLD}${GREEN}$INSTALL_PATH${NC}"
+echo ""
+echo -e "${CYAN}${LINE}${NC}"
+echo ""
+
 echo -e "${YELLOW}${BOLD}$MSG_NEXT_STEPS${NC}"
 echo ""
 
 if [ "$LANG" = "es" ]; then
-    echo "  ${BOLD}1. Instalar CodeRabbit en GitHub:${NC}"
+    echo "  ${BOLD}1. Entra a la carpeta del proyecto:${NC}"
+    echo "     ${GREEN}cd \"$INSTALL_PATH\"${NC}"
+    echo ""
+    echo "  ${BOLD}2. Instalar CodeRabbit en GitHub:${NC}"
     echo "     ${CYAN}https://github.com/apps/coderabbitai${NC}"
     echo ""
-    echo "  ${BOLD}2. Ejecutar cuestionario (20 min):${NC}"
+    echo "  ${BOLD}3. Ejecutar cuestionario (20 min):${NC}"
     echo "     ${GREEN}./scripts/generate-contrato.sh${NC}"
     echo ""
-    echo "  ${BOLD}3. Push a GitHub:${NC}"
+    echo "  ${BOLD}4. Push a GitHub:${NC}"
     echo "     ${GREEN}git init && git add . && git commit -m 'init: SpecLeap setup'${NC}"
     echo "     ${GREEN}git push origin main${NC}"
     echo ""
-    echo "  ${BOLD}4. Abrir en tu IDE:${NC}"
+    echo "  ${BOLD}5. Abrir en tu IDE:${NC}"
     echo "     ${GREEN}code .${NC}  (VSCode)"
     echo "     ${GREEN}cursor .${NC}  (Cursor)"
     echo ""
-    echo "  ${BOLD}5. En el chat con la IA, escribe:${NC}"
+    echo "  ${BOLD}6. En el chat con la IA, escribe:${NC}"
     echo "     ${GREEN}ayuda${NC}"
     echo ""
 else
-    echo "  ${BOLD}1. Install CodeRabbit on GitHub:${NC}"
+    echo "  ${BOLD}1. Enter the project folder:${NC}"
+    echo "     ${GREEN}cd \"$INSTALL_PATH\"${NC}"
+    echo ""
+    echo "  ${BOLD}2. Install CodeRabbit on GitHub:${NC}"
     echo "     ${CYAN}https://github.com/apps/coderabbitai${NC}"
     echo ""
-    echo "  ${BOLD}2. Run questionnaire (20 min):${NC}"
+    echo "  ${BOLD}3. Run questionnaire (20 min):${NC}"
     echo "     ${GREEN}./scripts/generate-contrato.sh${NC}"
     echo ""
-    echo "  ${BOLD}3. Push to GitHub:${NC}"
+    echo "  ${BOLD}4. Push to GitHub:${NC}"
     echo "     ${GREEN}git init && git add . && git commit -m 'init: SpecLeap setup'${NC}"
     echo "     ${GREEN}git push origin main${NC}"
     echo ""
-    echo "  ${BOLD}4. Open in your IDE:${NC}"
+    echo "  ${BOLD}5. Open in your IDE:${NC}"
     echo "     ${GREEN}code .${NC}  (VSCode)"
     echo "     ${GREEN}cursor .${NC}  (Cursor)"
     echo ""
-    echo "  ${BOLD}5. In AI chat, type:${NC}"
+    echo "  ${BOLD}6. In AI chat, type:${NC}"
     echo "     ${GREEN}ayuda${NC}"
     echo ""
 fi