specleap-framework 2.1.1 → 2.1.6

package/.specleap/i18n/en.json

@@ -0,0 +1,177 @@
+{
+  "installer": {
+    "welcome": "Welcome to SpecLeap!",
+    "setup_start": "Starting installation...",
+    "creating_config": "Creating configuration file...",
+    "installing_deps": "Installing dependencies...",
+    "setup_complete": "✅ Installation complete!",
+    "next_steps": "Next steps:",
+    "step_1": "1. Read SETUP.md for detailed configuration",
+    "step_2": "2. Run: npm install (if using landing/web components)",
+    "step_3": "3. Configure your project in proyectos/",
+    "step_4": "4. Run: ./scripts/generate-contrato.sh to start",
+    "enjoy": "Enjoy SpecLeap!"
+  },
+  "questionnaire": {
+    "title": "🎯 SpecLeap — CONTRACT.md Generator",
+    "subtitle": "Define your project specifications",
+    "intro_line1": "This questionnaire will ask you 58 questions to automatically",
+    "intro_line2": "generate your project's CONTRACT.md.",
+    "estimated_time": "⏱️  Estimated time: 15-20 minutes",
+    "auto_save": "💾 Auto-save every 10 questions",
+    "interrupt_msg": "🔄 You can interrupt with Ctrl+C and continue later",
+    "help_label": "💡",
+    "options_label": "📋 Options:",
+    "example_label": "📝 Example:",
+    "location_label": "📄 Location:",
+    "analysis_label": "📊 Analysis:",
+    "progress": "Progress",
+    "question": "Question",
+    "of": "of",
+    "skip": "Skip",
+    "back": "Back",
+    "next": "Next",
+    "finish": "Finish",
+    "generating_contract": "📝 Generating CONTRACT.md from responses...",
+    "contract_generated": "✅ CONTRACT.md generated successfully",
+    "save_progress": "💾 Saving progress...",
+    "loading_state": "📂 Loading previous state...",
+    "state_loaded": "✅ Session restored",
+    "welcome": "Welcome to the SpecLeap interactive questionnaire",
+    "instructions": "Answer the following questions to generate your CONTRACT.md",
+    "resume_question": "Continue from question",
+    "starting_fresh": "Starting new questionnaire...",
+    "checkpoint_saved": "Checkpoint saved (question",
+    "session_incomplete": "🔄 Incomplete session detected:",
+    "project_label": "Project:",
+    "progress_label": "Progress:",
+    "questions_label": "questions",
+    "last_update": "Last updated:",
+    "continue_prompt": "Continue from question",
+    "continue_yes_no": "[y/N]:",
+    "session_restored": "Session restored. Continuing from question",
+    "new_session": "Creating new session..."
+  },
+  "session": {
+    "analyzing_legacy": "Analyzing existing project",
+    "dir_not_found": "Directory not found:",
+    "cleanup_old": "Cleaning up old sessions..."
+  },
+  "scripts": {
+    "analyzing_project": "🔍 Analyzing project...",
+    "detecting_type": "🔎 Detecting project type...",
+    "generating_tasks": "📋 Generating tasks...",
+    "estimating_effort": "⏱️  Estimating effort...",
+    "creating_structure": "🏗️  Creating structure...",
+    "parsing_contract": "📄 Parsing CONTRACT.md...",
+    "generating_backlog": "📊 Generating backlog...",
+    "error": "❌ Error",
+    "success": "✅ Success",
+    "warning": "⚠️  Warning",
+    "info": "ℹ️  Info"
+  },
+  "errors": {
+    "no_path": "You must provide the project path",
+    "invalid_path": "The path does not exist",
+    "no_file": "File not found",
+    "no_contract": "CONTRACT.md not found",
+    "usage": "Usage",
+    "missing_token": "API token not configured",
+    "missing_config": "Configuration file not found"
+  },
+  "analyze": {
+    "header": "📊 SpecLeap — Legacy Project Analysis",
+    "scanning": "Scanning file structure...",
+    "detecting_stack": "Detecting technology stack...",
+    "calculating_debt": "Calculating technical debt...",
+    "estimating": "Estimating adoption effort...",
+    "generating_contract": "Generating CONTRACT-LEGACY.md...",
+    "complete": "✅ Analysis completed",
+    "results_saved": "Results saved in"
+  },
+  "asana": {
+    "header": "📊 SpecLeap — Asana Backlog Generator",
+    "checking_token": "Verifying Asana credentials...",
+    "selecting_workspace": "Select workspace",
+    "creating_project": "Creating project in Asana...",
+    "creating_sections": "Creating sections...",
+    "creating_tasks": "Creating tasks",
+    "complete": "✅ Backlog generated in Asana",
+    "view_project": "View project"
+  },
+  "parse": {
+    "header": "📄 SpecLeap — CONTRACT.md Parser",
+    "reading": "Reading CONTRACT.md...",
+    "extracting": "Extracting modules and features...",
+    "validating": "Validating structure...",
+    "generating_json": "Generating JSON...",
+    "complete": "✅ Parsing completed"
+  },
+  "quality": {
+    "baseline": {
+      "init_start": "Initializing quality baseline...",
+      "init_done": "Baseline created at .quality/baselines/baseline.json",
+      "already_exists": "Baseline already exists, not overwriting:",
+      "snapshot_start": "Generating repository snapshot...",
+      "snapshot_done": "Snapshot updated",
+      "missing_baseline": ".quality/baselines/baseline.json is missing",
+      "run_init_first": "Run first: bash scripts/quality-baseline.sh init",
+      "jq_required": "This command requires 'jq'. Install it with: brew install jq",
+      "evidence_start": "Creating evidence folder for",
+      "evidence_done": "Evidence structure created at",
+      "missing_slug": "Missing feature slug.",
+      "invalid_slug": "Slug can only contain lowercase letters, numbers and hyphens:",
+      "usage": "Usage: bash scripts/quality-baseline.sh [init|snapshot|new-evidence FEATURE-SLUG]"
+    },
+    "healing": {
+      "log_done": "Entry appended to",
+      "missing_feature": "Missing --feature argument",
+      "missing_phase": "Missing --phase argument",
+      "missing_action": "Missing --action argument",
+      "severity_invalid": "Invalid severity (must be info/warn/error):",
+      "no_evidence": "No evidence folder for feature:",
+      "run_new_evidence_first": "Run first: bash scripts/quality-baseline.sh new-evidence FEATURE-SLUG",
+      "no_log": "No healing.jsonl yet for:",
+      "jq_required": "This command requires 'jq'. Install it with: brew install jq",
+      "entries": "entries",
+      "total_entries": "Total",
+      "by_severity": "By severity",
+      "by_phase": "By phase",
+      "by_action": "By action",
+      "usage_log": "Usage: bash scripts/quality-healing.sh log --feature SLUG --phase P --severity S --action A --detail D [--file F]",
+      "usage_show": "Usage: bash scripts/quality-healing.sh show --feature SLUG [--last N]",
+      "usage_stats": "Usage: bash scripts/quality-healing.sh stats --feature SLUG",
+      "usage": "Usage: bash scripts/quality-healing.sh [log|show|stats] --feature SLUG ..."
+    },
+    "spec_guard": {
+      "blocked_header": "SpecLeap: write blocked on protected branch",
+      "blocked_branch": "You are on protected branch:",
+      "hint_create_branch": "Create a feature branch before writing code:",
+      "hint_command": "git checkout -b feature/[project]-[ticket]-[description]",
+      "hint_example": "Example: git checkout -b feature/app-tienda-23-cart",
+      "hint_flow": "Flow: feature → stage → main (via PR)"
+    },
+    "compliance": {
+      "header": "SpecLeap Compliance Audit",
+      "version": "Version",
+      "skills": "Skills",
+      "i18n": "i18n",
+      "hooks": "Hooks",
+      "baseline": "Baseline",
+      "docs": "Docs",
+      "total": "Total",
+      "observations": "Observations",
+      "details_saved": "Details saved at:",
+      "version_mismatch": "package.json version does not match last tag:",
+      "skills_mismatch": "Skills count mismatch:",
+      "i18n_missing_file": "Missing i18n file (es.json or en.json)",
+      "i18n_missing_key": "Missing key in",
+      "hook_missing": "Hook file missing:",
+      "hook_not_shebang": "Missing proper shebang in:",
+      "hook_not_exec": "Not executable (chmod +x):",
+      "hook_not_in_template": "Hook not referenced in settings.json.template",
+      "baseline_stale": "repo_snapshot stale (run: bash scripts/quality-baseline.sh snapshot)",
+      "docs_residual": "Legacy brand residual in"
+    }
+  }
+}

package/.specleap/i18n/es.json

@@ -0,0 +1,177 @@
+{
+  "installer": {
+    "welcome": "¡Bienvenido a SpecLeap!",
+    "setup_start": "Iniciando instalación...",
+    "creating_config": "Creando archivo de configuración...",
+    "installing_deps": "Instalando dependencias...",
+    "setup_complete": "✅ Instalación completa!",
+    "next_steps": "Próximos pasos:",
+    "step_1": "1. Lee SETUP.md para configuración detallada",
+    "step_2": "2. Ejecuta: npm install (si usas landing/componentes web)",
+    "step_3": "3. Configura tu proyecto en proyectos/",
+    "step_4": "4. Ejecuta: ./scripts/generate-contrato.sh para empezar",
+    "enjoy": "¡Disfruta SpecLeap!"
+  },
+  "questionnaire": {
+    "title": "🎯 SpecLeap — Generador de CONTRATO.md",
+    "subtitle": "Define las especificaciones de tu proyecto",
+    "intro_line1": "Este cuestionario te hará 58 preguntas para generar",
+    "intro_line2": "automáticamente el CONTRATO.md de tu proyecto.",
+    "estimated_time": "⏱️  Tiempo estimado: 15-20 minutos",
+    "auto_save": "💾 Guardado automático cada 10 preguntas",
+    "interrupt_msg": "🔄 Puedes interrumpir con Ctrl+C y continuar después",
+    "help_label": "💡",
+    "options_label": "📋 Opciones:",
+    "example_label": "📝 Ejemplo:",
+    "location_label": "📄 Ubicación:",
+    "analysis_label": "📊 Análisis:",
+    "progress": "Progreso",
+    "question": "Pregunta",
+    "of": "de",
+    "skip": "Omitir",
+    "back": "Atrás",
+    "next": "Siguiente",
+    "finish": "Finalizar",
+    "generating_contract": "📝 Generando CONTRATO.md desde respuestas...",
+    "contract_generated": "✅ CONTRATO.md generado exitosamente",
+    "save_progress": "💾 Guardando progreso...",
+    "loading_state": "📂 Cargando estado anterior...",
+    "state_loaded": "✅ Sesión restaurada",
+    "welcome": "Bienvenido al cuestionario interactivo de SpecLeap",
+    "instructions": "Responde las siguientes preguntas para generar tu CONTRATO.md",
+    "resume_question": "¿Continuar desde la pregunta",
+    "starting_fresh": "Empezando nuevo cuestionario...",
+    "checkpoint_saved": "Checkpoint guardado (pregunta",
+    "session_incomplete": "🔄 Sesión incompleta detectada:",
+    "project_label": "Proyecto:",
+    "progress_label": "Progreso:",
+    "questions_label": "preguntas",
+    "last_update": "Última actualización:",
+    "continue_prompt": "¿Continuar desde la pregunta",
+    "continue_yes_no": "[s/N]:",
+    "session_restored": "Sesión restaurada. Continuando desde pregunta",
+    "new_session": "Creando nueva sesión..."
+  },
+  "session": {
+    "analyzing_legacy": "Analizando proyecto existente",
+    "dir_not_found": "Directorio no encontrado:",
+    "cleanup_old": "Limpiando sesiones antiguas..."
+  },
+  "scripts": {
+    "analyzing_project": "🔍 Analizando proyecto...",
+    "detecting_type": "🔎 Detectando tipo de proyecto...",
+    "generating_tasks": "📋 Generando tareas...",
+    "estimating_effort": "⏱️  Estimando esfuerzo...",
+    "creating_structure": "🏗️  Creando estructura...",
+    "parsing_contract": "📄 Parseando CONTRATO.md...",
+    "generating_backlog": "📊 Generando backlog...",
+    "error": "❌ Error",
+    "success": "✅ Éxito",
+    "warning": "⚠️  Advertencia",
+    "info": "ℹ️  Info"
+  },
+  "errors": {
+    "no_path": "Debes proporcionar la ruta del proyecto",
+    "invalid_path": "La ruta no existe",
+    "no_file": "Archivo no encontrado",
+    "no_contract": "CONTRATO.md no encontrado",
+    "usage": "Uso",
+    "missing_token": "Token de API no configurado",
+    "missing_config": "Archivo de configuración no encontrado"
+  },
+  "analyze": {
+    "header": "📊 SpecLeap — Análisis de Proyecto Legacy",
+    "scanning": "Escaneando estructura de archivos...",
+    "detecting_stack": "Detectando stack tecnológico...",
+    "calculating_debt": "Calculando deuda técnica...",
+    "estimating": "Estimando esfuerzo de adopción...",
+    "generating_contract": "Generando CONTRATO-LEGACY.md...",
+    "complete": "✅ Análisis completado",
+    "results_saved": "Resultados guardados en"
+  },
+  "asana": {
+    "header": "📊 SpecLeap — Generador de Backlog Asana",
+    "checking_token": "Verificando credenciales Asana...",
+    "selecting_workspace": "Selecciona workspace",
+    "creating_project": "Creando proyecto en Asana...",
+    "creating_sections": "Creando secciones...",
+    "creating_tasks": "Creando tareas",
+    "complete": "✅ Backlog generado en Asana",
+    "view_project": "Ver proyecto"
+  },
+  "parse": {
+    "header": "📄 SpecLeap — Parser de CONTRATO.md",
+    "reading": "Leyendo CONTRATO.md...",
+    "extracting": "Extrayendo módulos y features...",
+    "validating": "Validando estructura...",
+    "generating_json": "Generando JSON...",
+    "complete": "✅ Parsing completado"
+  },
+  "quality": {
+    "baseline": {
+      "init_start": "Inicializando baseline de calidad...",
+      "init_done": "Baseline creado en .quality/baselines/baseline.json",
+      "already_exists": "El baseline ya existe, no se sobrescribe:",
+      "snapshot_start": "Generando snapshot del repositorio...",
+      "snapshot_done": "Snapshot actualizado",
+      "missing_baseline": "Falta .quality/baselines/baseline.json",
+      "run_init_first": "Ejecuta primero: bash scripts/quality-baseline.sh init",
+      "jq_required": "Este comando requiere 'jq'. Instálalo con: brew install jq",
+      "evidence_start": "Creando carpeta de evidence para",
+      "evidence_done": "Estructura evidence creada en",
+      "missing_slug": "Falta el nombre de la feature.",
+      "invalid_slug": "El slug solo puede contener minúsculas, números y guiones:",
+      "usage": "Uso: bash scripts/quality-baseline.sh [init|snapshot|new-evidence FEATURE-SLUG]"
+    },
+    "healing": {
+      "log_done": "Entrada añadida a",
+      "missing_feature": "Falta el argumento --feature",
+      "missing_phase": "Falta el argumento --phase",
+      "missing_action": "Falta el argumento --action",
+      "severity_invalid": "Severity no válido (info/warn/error):",
+      "no_evidence": "No existe carpeta evidence para la feature:",
+      "run_new_evidence_first": "Ejecuta primero: bash scripts/quality-baseline.sh new-evidence FEATURE-SLUG",
+      "no_log": "No hay healing.jsonl todavía para:",
+      "jq_required": "Este comando requiere 'jq'. Instálalo con: brew install jq",
+      "entries": "entradas",
+      "total_entries": "Total",
+      "by_severity": "Por severidad",
+      "by_phase": "Por fase",
+      "by_action": "Por acción",
+      "usage_log": "Uso: bash scripts/quality-healing.sh log --feature SLUG --phase P --severity S --action A --detail D [--file F]",
+      "usage_show": "Uso: bash scripts/quality-healing.sh show --feature SLUG [--last N]",
+      "usage_stats": "Uso: bash scripts/quality-healing.sh stats --feature SLUG",
+      "usage": "Uso: bash scripts/quality-healing.sh [log|show|stats] --feature SLUG ..."
+    },
+    "spec_guard": {
+      "blocked_header": "SpecLeap: escritura bloqueada en rama protegida",
+      "blocked_branch": "Estás en la rama protegida:",
+      "hint_create_branch": "Crea una feature branch antes de escribir código:",
+      "hint_command": "git checkout -b feature/[proyecto]-[ticket]-[descripción]",
+      "hint_example": "Ejemplo: git checkout -b feature/app-tienda-23-cart",
+      "hint_flow": "Flujo: feature → stage → main (vía PR)"
+    },
+    "compliance": {
+      "header": "SpecLeap Compliance Audit",
+      "version": "Version",
+      "skills": "Skills",
+      "i18n": "i18n",
+      "hooks": "Hooks",
+      "baseline": "Baseline",
+      "docs": "Docs",
+      "total": "Total",
+      "observations": "Observaciones",
+      "details_saved": "Detalle guardado en:",
+      "version_mismatch": "Versión del package.json no coincide con el último tag:",
+      "skills_mismatch": "Conteo de skills discrepa:",
+      "i18n_missing_file": "Falta archivo de i18n (es.json o en.json)",
+      "i18n_missing_key": "Clave ausente en",
+      "hook_missing": "Falta el archivo del hook:",
+      "hook_not_shebang": "Falta shebang correcto en:",
+      "hook_not_exec": "No es ejecutable (chmod +x):",
+      "hook_not_in_template": "Hook no referenciado en settings.json.template",
+      "baseline_stale": "repo_snapshot desactualizado (ejecuta: bash scripts/quality-baseline.sh snapshot)",
+      "docs_residual": "Residuo de marca pasada en"
+    }
+  }
+}

package/.specleap/i18n.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+# SpecLeap i18n Helper
+# Carga traducciones según el idioma configurado
+
+# Detectar directorio raíz de SpecLeap
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SPECLEAP_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Detectar idioma configurado
+if [ -f "$SPECLEAP_ROOT/.specleap/config.json" ]; then
+    SPECLEAP_LANG=$(grep -o '"language": "[^"]*"' "$SPECLEAP_ROOT/.specleap/config.json" | cut -d'"' -f4)
+else
+    SPECLEAP_LANG="${SPECLEAP_LANG:-es}"
+fi
+
+# Archivo de traducciones
+I18N_FILE="$SPECLEAP_ROOT/.specleap/i18n/${SPECLEAP_LANG}.json"
+
+# Función para obtener traducción
+# Uso: t "questionnaire.title"
+#      t "errors.no_path"
+t() {
+    local key=$1
+    
+    if [ ! -f "$I18N_FILE" ]; then
+        echo "$key"
+        return
+    fi
+    
+    # Dividir la clave en partes (ej: "questionnaire.title" → ["questionnaire", "title"])
+    IFS='.' read -ra PARTS <<< "$key"
+    
+    # Usar jq si está disponible (más robusto)
+    if command -v jq &> /dev/null; then
+        local jq_query=".${PARTS[0]}"
+        for (( i=1; i<${#PARTS[@]}; i++ )); do
+            jq_query="${jq_query}.${PARTS[$i]}"
+        done
+        local value=$(jq -r "$jq_query" "$I18N_FILE" 2>/dev/null)
+        
+        if [ "$value" != "null" ] && [ -n "$value" ]; then
+            echo "$value"
+        else
+            echo "$key"
+        fi
+    else
+        # Fallback: grep simple (menos robusto, pero funciona sin jq)
+        local search_key="${PARTS[-1]}"
+        local value=$(grep "\"$search_key\":" "$I18N_FILE" | head -1 | sed 's/.*: "\(.*\)".*/\1/')
+        
+        if [ -n "$value" ]; then
+            echo "$value"
+        else
+            echo "$key"
+        fi
+    fi
+}
+
+# Exportar variables y funciones
+export SPECLEAP_LANG
+export SPECLEAP_ROOT
+export I18N_FILE
+export -f t 2>/dev/null || true