specleap-framework 2.1.8 → 2.1.9

package/CHANGELOG.md

@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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.9 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
 
 ---
 

package/bin/specleap

@@ -3,48 +3,137 @@
 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 fijo de la carpeta destino. NO es configurable: si el usuario
+// quiere otro nombre, renombra la carpeta a posteriori con `mv`.
+const FOLDER_NAME = 'specleap-framework';
+
+// 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');
+// Pregunta interactiva al usuario por la carpeta base.
+// Bilingüe en el prompt porque el idioma de SpecLeap se elige más tarde
+// dentro de setup.sh — aquí todavía no lo sabemos.
+function askBasePath(defaultBase) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
 
-console.log('\n🚀 Copiando SpecLeap Framework...\n');
+    console.log('');
+    console.log('📁 ¿En qué carpeta base instalar SpecLeap?');
+    console.log('   Where do you want to install SpecLeap?');
+    console.log('');
+    console.log(`   Se creará / Will create: <base>/${FOLDER_NAME}`);
+    console.log(`   Default: ${defaultBase}`);
+    console.log('');
+    console.log('   Ejemplos / Examples:');
+    console.log('     ~/Downloads        →  ~/Downloads/specleap-framework');
+    console.log('     ~/Desktop/work     →  ~/Desktop/work/specleap-framework');
+    console.log('     .                  →  ./specleap-framework');
+    console.log('     (Enter)            →  default arriba');
+    console.log('');
 
-// 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);
+    rl.question('Carpeta base / Base folder: ', (answer) => {
+      rl.close();
+      resolve(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);
-}
+async function main() {
+  // Argumento CLI opcional: `npx specleap-framework@latest ~/Downloads`
+  const args = process.argv.slice(2);
+  const argBase = args.find((a) => !a.startsWith('-'));
 
-// Ejecutar setup.sh DESDE el directorio copiado
-const setupPath = path.join(targetDir, 'setup.sh');
+  // Si no hay argumento, preguntar interactivamente con default = cwd
+  let basePath;
+  if (argBase) {
+    basePath = resolveBasePath(argBase);
+    console.log(`\n📁 Carpeta base: ${basePath}`);
+  } else {
+    basePath = await askBasePath(process.cwd());
+  }
 
-const setup = spawn('bash', [setupPath], {
-  stdio: 'inherit',
-  cwd: targetDir
-});
+  // 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);
+    }
+  }
+
+  // Verificar que sea un directorio (no un archivo con ese nombre)
+  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);
+  }
+
+  // Construir el destino final: <basePath>/specleap-framework
+  const targetDir = path.join(basePath, FOLDER_NAME);
 
-setup.on('close', (code) => {
-  process.exit(code);
+  // No sobrescribir si ya existe
+  if (fs.existsSync(targetDir)) {
+    console.error(`\n❌ Ya existe / Already exists: ${targetDir}`);
+    console.error('   Elige otra carpeta base o elimina la existente.');
+    console.error('   Choose another base folder 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.9",
   "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