specleap-framework 2.1.9 → 2.1.10

package/CHANGELOG.md

@@ -7,6 +7,23 @@ 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

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.9 · **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

@@ -6,9 +6,19 @@ const fs = require('fs');
 const readline = require('readline');
 const os = require('os');
 
-// 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';
+// 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, '..');
@@ -26,49 +36,104 @@ function resolveBasePath(input) {
   return path.resolve(process.cwd(), trimmed);
 }
 
-// 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
-    });
+// Crea una interfaz readline reutilizable; cerramos al final del flujo.
+function createPrompt() {
+  return readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+}
+
+function ask(rl, question) {
+  return new Promise((resolve) => rl.question(question, (a) => resolve(a)));
+}
+
+// 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);
+}
+
+// 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('📁 ¿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(`❌ 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('');
-
-    rl.question('Carpeta base / Base folder: ', (answer) => {
-      rl.close();
-      resolve(resolveBasePath(answer));
-    });
-  });
+  }
 }
 
 async function main() {
-  // Argumento CLI opcional: `npx specleap-framework@latest ~/Downloads`
-  const args = process.argv.slice(2);
-  const argBase = args.find((a) => !a.startsWith('-'));
-
-  // 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());
+  // 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];
+
+  // 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);
+  }
+
+  // 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)
@@ -83,21 +148,20 @@ async function main() {
     }
   }
 
-  // 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);
+  // 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 base o elimina la existente.');
-    console.error('   Choose another base folder or delete the existing one.\n');
+    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);
   }
 

package/package.json

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