setup-kapelu 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ⠀
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+<div align="center">
+<h1 style='margin: 0 0 2rem; font-size: 2.5rem;'>Post-Install</h1 >
+</div>
+<div align="center">
+
+![Bash](https://img.shields.io/badge/Bash-4%2B-blue)
+![Ubuntu](https://img.shields.io/badge/Ubuntu-22.04%2B-orange)
+![License](https://img.shields.io/badge/License-MIT-green)
+![Version](https://img.shields.io/badge/version-3.0-informational)
+
+</div>
+
+<div align="center">
+
+
+## Descripción general
+
+`script-setup` es una colección de utilidades de terminal ***post-install*** orientadas al rendimiento, diseñadas para mejorar la productividad de los desarrolladores en sistemas Ubuntu. El proyecto prioriza la baja sobrecarga, la arquitectura modular de Bash y un comportamiento de ejecución predecible.
+
+
+</div>
+
+<div align="center">
+
+## 📦 Modulos
+
+</div>
+
+### ***🧹 node-clean***
+
+Herramienta CLI interactiva para localizar y eliminar `node_modules` y `.next` dentro de un árbol de directorios. Se pueden agregar más carpetas o archivos.
+
+simplemente modificar la variable
+```bash
+TARGETS=("node_modules" ".next")()
+```
+### <u>Características:</u>
+- Interfaz TUI basada en `dialog`
+- Cálculo previo de espacio a liberar
+- Borrado total o selectivo
+- Soporte modo `--dry-run`
+- Restauración segura del estado de la terminal
+
+### <u>Uso</u>:
+```bash
+  node-clean [--dry-run]
+```
+
+------------------------------------------------------------------------
+### ***⚙️ Motor de prompts de Bash optimizado (.bashrc)***
+
+El archivo implementa un prompt dinámico optimizado con cacheo inteligente, orientado a entornos de desarrollo Node/Next.js.
+
+### <u>Características:</u>
+
+- Crea una carpeta llamada script donde se instalaran los script personalizables y ejecutables
+- Cache global
+- Busqueda de `package.json`
+- Detección inteligente del `package manager`
+- Detección inteligente de `git status`
+
+      🟢 → repo limpio
+      🟡 → cambios sin commit
+      🔴 → conflictos
+      🔵 → detached HEAD
+- Prompt contextual con heurística de proyecto
+
+</br>
+<div align="center">
+<p style='margin: 0 0 2rem; font-size: 1.5rem;'>📈 Comparación con <strong>.bashrc</strong> estándar de Ubuntu vs Prompt v2.0</p >
+</div>
+
+<div align="center">
+
+| Característica             |Ubuntu default|Versión 3.0|
+|----------------------------|--------------|-----------|
+| Prompt dinámico            | ❌           | ✔️        |
+| Rama Git                   | ❌           | ✔️        |
+| Detectar Node project      | ❌           | ✔️        |
+| Detectar package manager   | ❌           | ✔️        |
+| Cache de estado            | ❌           | ✔️        |
+| Optimización por PWD       | ❌           | ✔️        |
+
+
+#### Está más cerca de un mini framework de prompt que de un `.bashrc` común‼️
+</div>
+
+------------------------------------------------------------------------
+
+### ***🛡️ protect-main.json***
+
+Es un archivo `.json` que protege el main branch de un repositorio git, evitando pushes accidentales de terceroas.
+
+### <u>Características:</u>
+
+- `Estado de ejecución` Activo
+- `Lista de omisión` Repository admin
+- `Criterio de selección de rama` Default
+- `Restrict updates` Permitir que solo los usuarios con permisos de omisión actualicen las referencias coincidentes.
+- `Restrict deletions` Permitir que solo los usuarios con permisos de omisión eliminen referencias coincidentes.
+- `Require linear history` Evita que las confirmaciones de fusión se envíen a referencias coincidentes.
+- `Require a pull request before merging` Requerir que todas las confirmaciones se realicen en una rama distinta a la de destino y se envíen mediante una solicitud de extracción antes de que se puedan fusionar.
+- `Require conversation resolution before merging` Todas las conversaciones sobre el código deben resolverse antes de que se pueda fusionar una solicitud de extracción.
+- `Block force pushes` Evita que los usuarios con acceso de envío fuercen el envío a los árbitros.
+
+### <u>Uso</u>:
+
+Luego en el repositorio de `github` ir a `Settings` → `Branches` → `Add rule` → `Import` → `Upload JSON` y agregar → ***protect-main.json*** .
+
+------------------------------------------------------------------------
+
+------------------------------------------------------------------------
+
+### ***🤝 Contribuciones***
+
+Se agradecen las contribuciones.
+
+Para cambios importantes:
+- Abrir issue first
+- Debatimos el impacto en la arquitectura

package/config/.bashrc

@@ -0,0 +1,148 @@
+#!/usr/bin/env bash
+# ╔════════════════════════════════════════════════════╗
+# │ cerrar-sesion - Script para cerrar la sesión       │
+# │ Versión: 2.0                                       │
+# │ Autor: Daniel Calderon - Kapelu                    │
+# │ Fecha: 04/03/2026                                  │
+# │ WebSite: https://danielcalderon.vercel.app/        │
+# │ Github: https://github.com/Kapelu                  │
+# ╚════════════════════════════════════════════════════╝
+# Alias
+# =============================================================================
+alias ls='lsd'
+
+# Variables para cachear info de PWD, gestor y git branch
+# =============================================================================
+__LAST_PWD=""
+__PKG_MANAGER=""
+__GIT_BRANCH=""
+# Definir carpeta única
+#-----------------------------------------
+SCRIPT_DIR="$HOME/script"
+
+# Crear si no existe
+#-----------------------------------------
+[ -d "$SCRIPT_DIR" ] || mkdir -p "$SCRIPT_DIR"
+
+# Añadir al PATH solo si no está ya
+#-----------------------------------------
+case ":$PATH:" in
+  *":$SCRIPT_DIR:"*) ;;
+  *) export PATH="$PATH:$SCRIPT_DIR" ;;
+esac
+
+# Hacer ejecutables los existentes en script
+#-----------------------------------------
+find "$SCRIPT_DIR" -type f -exec chmod +x {} \;
+
+# Vigilar nuevos archivos para hacerlos ejecutables automáticamente
+# =============================================================================
+if command -v inotifywait >/dev/null 2>&1 && [ -z "$__SCRIPTS_WATCH_STARTED" ]; then
+  export __SCRIPTS_WATCH_STARTED=1
+  inotifywait -m -e create --format '%f' "$SCRIPT_DIR" 2>/dev/null |
+  while IFS= read -r file; do
+    chmod +x "$SCRIPT_DIR/$file"
+  done &
+fi
+
+# Función que busca recursivamente hacia arriba desde el directorio actual
+# =============================================================================
+find_package_json_upwards() {
+  local dir="$PWD"
+  while [ "$dir" != "/" ]; do
+    [ -f "$dir/package.json" ] && { echo "$dir/package.json"; return; }
+    dir=$(dirname "$dir")
+  done
+}
+
+# Función que detecta el gestor de paquetes basado en package.json o archivos lock
+# =============================================================================
+detect_package_manager() {
+  local pkg_json manager dir="$PWD"
+
+  pkg_json=$(find_package_json_upwards)
+  if [ -n "$pkg_json" ]; then
+    manager=$(grep '"packageManager"' "$pkg_json" 2>/dev/null | sed -E 's/.*"([^"]+)".*/\1/' | cut -d@ -f1)
+    [ -n "$manager" ] && { echo "$manager"; return; }
+  fi
+
+  while [ "$dir" != "/" ]; do
+    [ -f "$dir/pnpm-lock.yaml" ] && { echo "pnpm"; return; }
+    [ -f "$dir/yarn.lock" ] && { echo "yarn"; return; }
+    [ -f "$dir/package-lock.json" ] && { echo "npm"; return; }
+    dir=$(dirname "$dir")
+  done
+
+  echo "npm"
+}
+
+# Función que instala pnpm globalmente si detecta un pnpm-lock.yaml pero no encuentra pnpm en el PATH 
+# =============================================================================
+ensure_pnpm() {
+  [ ! -x "$(command -v pnpm)" ] && [ -f pnpm-lock.yaml ] && {
+    echo "📦 pnpm no está instalado. Instalando globalmente..."
+    npm install -g pnpm
+  }
+}
+
+# Estas funciones detectan el gestor de paquetes basado en el contexto del proyecto 
+# y ejecutan el comando correspondiente, asegurando pnpm si es necesario.
+# =============================================================================
+runpkg() { local gestor ; gestor=$(detect_package_manager); ensure_pnpm; command "$gestor" "$@"; }
+npm()  { local gestor; gestor=$(detect_package_manager); ensure_pnpm; command "$gestor" "$@"; }
+pnpm() { local gestor; gestor=$(detect_package_manager); ensure_pnpm; command "$gestor" "$@"; }
+
+# Función que obtiene el estado del repositorio git y lo muestra con colores en el prompt
+# =============================================================================
+git_prompt_status() {
+  git rev-parse --is-inside-work-tree &>/dev/null || return
+
+  local branch
+  branch=$(git symbolic-ref --short HEAD 2>/dev/null)
+
+  # 🔵 Detached HEAD
+	#-----------------------------------------
+  [ -z "$branch" ] && branch=$(git rev-parse --short HEAD 2>/dev/null) && \
+    { printf "\033[38;5;39m[%s]\033[0m" "$branch"; return; }
+
+  # 🔴 Conflictos
+	#-----------------------------------------
+  git ls-files -u | grep -q . && { printf "\033[38;5;196m[%s]\033[0m" "$branch"; return; }
+
+  # 🟡 Cambios sin commit
+	#-----------------------------------------
+  (! git diff --quiet || ! git diff --cached --quiet) && { printf "\033[38;5;220m[%s]\033[0m" "$branch"; return; }
+
+  # 🟢 Repo limpio
+	#-----------------------------------------
+  printf "\033[38;5;82m[%s]\033[0m" "$branch"
+}
+
+# Función que actualiza el cache solo si cambia pwd o 
+# git branch, para mejorar rendimiento del prompt
+# =============================================================================
+update_prompt_cache() {
+  [ "$PWD" != "$__LAST_PWD" ] && {
+    __LAST_PWD="$PWD"
+    local manager
+    manager=$(detect_package_manager)
+    __PKG_MANAGER=$([ -n "$manager" ] && echo "[$manager]" || echo "")
+  }
+
+  __GIT_BRANCH="$(git_prompt_status)"
+}
+
+PROMPT_COMMAND=update_prompt_cache
+
+# Diseño del prompt que muestra el gestor de paquetes, el branch de git 
+# y el directorio actual, con colores.
+# =============================================================================
+PS1=' \[\033[01;32m\]\h:\[\033[01;34m\]${__PKG_MANAGER}${__GIT_BRANCH} \[\033[00m\]\w \[\033[01;34m\]\$ \[\033[00m\]'
+
+# NVM_DIR="$HOME/.nvm"
+# =============================================================================
+export NVM_DIR="$HOME/.nvm"
+# shellcheck source=/dev/null
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+# shellcheck source=/dev/null
+[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

package/config/protect-main.json

@@ -0,0 +1,47 @@
+{
+  "id": 13362554,
+  "name": "protect-main",
+  "target": "branch",
+  "source_type": "Repository",
+  "source": "",
+  "enforcement": "active",
+  "conditions": {
+    "ref_name": {
+      "exclude": [],
+      "include": ["~DEFAULT_BRANCH"]
+    }
+  },
+  "rules": [
+    {
+      "type": "non_fast_forward"
+    },
+    {
+      "type": "pull_request",
+      "parameters": {
+        "required_approving_review_count": 0,
+        "dismiss_stale_reviews_on_push": false,
+        "required_reviewers": [],
+        "require_code_owner_review": false,
+        "require_last_push_approval": false,
+        "required_review_thread_resolution": true,
+        "allowed_merge_methods": ["squash", "merge"]
+      }
+    },
+    {
+      "type": "update"
+    },
+    {
+      "type": "required_linear_history"
+    },
+    {
+      "type": "deletion"
+    }
+  ],
+  "bypass_actors": [
+    {
+      "actor_id": 5,
+      "actor_type": "RepositoryRole",
+      "bypass_mode": "always"
+    }
+  ]
+}

package/index.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+
+const { execSync } = require("child_process");
+const pkg = require("./package.json");
+
+function exists(cmd) {
+  try {
+    execSync(`command -v ${cmd}`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function installNode() {
+  console.log("📦 Instalando Node.js y npm...\n");
+  execSync("sudo apt update", { stdio: "inherit" });
+  execSync("sudo apt install -y nodejs npm", { stdio: "inherit" });
+}
+
+function latestVersion() {
+  try {
+    return execSync(`npm view ${pkg.name} version`, {
+      stdio: ["ignore", "pipe", "ignore"],
+    })
+      .toString()
+      .trim();
+  } catch {
+    return null;
+  }
+}
+
+function updateIfNeeded() {
+  const current = pkg.version;
+  const latest = latestVersion();
+  if (!latest) return;
+
+  if (current !== latest) {
+    console.log(`⬆ Nueva versión disponible ${latest} (actual ${current})`);
+    console.log("Actualizando kapelu...\n");
+    execSync(`npm install -g ${pkg.name}`, { stdio: "inherit" });
+    process.exit(0);
+  }
+}
+
+function autoUpdateGitHub() {
+  // Si el script existe, hacer pull del repo para tener versión más reciente
+  try {
+    execSync(
+      `if [ -d "/tmp/script-setup" ]; then cd /tmp/script-setup && git pull --rebase; fi`,
+      { stdio: "inherit", shell: "/bin/bash" },
+    );
+  } catch {}
+}
+
+try {
+  console.log("🔎 Verificando Node.js y npm...");
+  if (!exists("node") || !exists("npm")) installNode();
+  console.log("✔ Node.js y npm OK\n");
+
+  console.log("🔎 Verificando actualizaciones en npm...");
+  updateIfNeeded();
+
+  console.log("🔎 Actualizando desde GitHub si existe repo local...");
+  autoUpdateGitHub();
+
+  console.log("🚀 Ejecutando install.sh\n");
+  execSync("bash install.sh", { stdio: "inherit" });
+} catch (err) {
+  console.error("\n❌ Error ejecutando Post-Install:", err.message);
+  process.exit(1);
+}
+
+
+
+
+//const { execSync } = require("child_process");
+//execSync("bash install.sh", { stdio: "inherit" });

package/install.sh

@@ -0,0 +1,164 @@
+#!/usr/bin/env bash
+# ╔════════════════════════════════════════════════════╗
+# │ Install - Script para comenzar la instalación.     │
+# │ Versión: 2.0                                       │
+# │ Autor: Daniel Calderon - Kapelu                    │
+# │ Fecha: 06/03/2026                                  │
+# │ WebSite: https://danielcalderon.vercel.app/        │
+# │ Github: https://github.com/Kapelu                  │
+# ╚════════════════════════════════════════════════════╝
+set -Eeuo pipefail
+IFS=$'\n\t'
+
+USER_NAME=$(whoami)
+HOME_DIR=$HOME
+DESKTOP_DIR=$(xdg-user-dir DESKTOP)
+TMP_DIR="/tmp/kape-setup-$RANDOM"
+REPO="https://github.com/Kapelu/kape-setup/tree/main"
+LOG_FILE="$HOME_DIR/setup-kape.log"
+green='\e[32m'
+reset='\e[0m'
+LOG="$HOME/post-install.log"
+
+log() {
+    echo -e "\033[0;32m✅ $1\033[0m"
+    echo "$1" >> "$LOG"
+}
+
+detect_distro(){
+
+ if [ ! -f /etc/os-release ]; then
+  log "Sistema no soportado"
+  exit 1
+ fi
+
+ source /etc/os-release
+
+ case "$ID" in
+   ubuntu|debian|linuxmint|pop)
+     log "Distribución detectada: $ID"
+   ;;
+   *)
+     log "Distribución no soportada"
+     exit 1
+ esac
+}
+
+check_git(){
+
+ if ! command -v git >/dev/null; then
+  log "Instalando git"
+  sudo apt update
+  sudo apt install -y git
+ fi
+}
+
+backup_bashrc(){
+
+ if [ -f "$HOME_DIR/.bashrc" ]; then
+   cp "$HOME_DIR/.bashrc" "$HOME_DIR/.bashrc.backup.$(date +%s)"
+   log "Backup de .bashrc creado"
+ fi
+}
+
+clone_repo(){
+
+ log "Clonando repositorio"
+
+ git clone "$REPO" "$TMP_DIR"
+}
+
+copy_scripts(){
+
+ mkdir -p "$HOME_DIR/script"
+
+ cp "$TMP_DIR/script/"* "$HOME_DIR/script/"
+
+ chmod +x "$HOME_DIR/script/"*
+}
+
+copy_config(){
+
+ cp "$TMP_DIR/config/.bashrc" "$HOME_DIR/.bashrc"
+
+ cp "$TMP_DIR/config/protect-main.json" "$HOME_DIR/"
+}
+
+create_desktop(){
+
+ mkdir -p "DESKTOP_DIR"
+
+cat <<EOF > "DESKTOP_DIR/btn_log.desktop"
+[Desktop Entry]
+Name=Logout
+Comment=Cierra sesión con barra visual de 15 segundos
+Exec=gnome-terminal --geometry=45x8 --hide-menubar -- bash -c "/home/$USER_NAME/script/btn-log.sh"
+Icon=system-log-out
+Terminal=false
+Type=Application
+Categories=Utility;
+EOF
+
+cat <<EOF > "DESKTOP_DIR/btn_shd.desktop"
+[Desktop Entry]
+Name=Apagar
+Comment=Apaga la computadora con barra visual de 15 segundos
+Exec=gnome-terminal --geometry=45x8 --hide-menubar -- bash -c "/home/$USER_NAME/script/btn-shd.sh"
+Icon=system-shutdown
+Terminal=false
+Type=Application
+Categories=System;
+EOF
+
+cat <<EOF > "DESKTOP_DIR/btn_sus.desktop"
+[Desktop Entry]
+Name=Suspender
+Comment=Suspender la máquina con barra visual de 15 segundos
+Exec=gnome-terminal --geometry=45x8 --hide-menubar -- bash -c "/home/$USER_NAME/script/btn-sus.sh"
+Icon=system-suspend
+Terminal=false
+Type=Application
+Categories=Utility;
+EOF
+}
+
+system_update(){ sudo apt update -y; sudo apt upgrade -y; sudo apt full-upgrade -y; }
+
+system_cleanup(){
+
+ sudo apt autoremove -y
+ sudo apt clean
+}
+
+cleanup(){ rm -rf "$TMP_DIR"; }
+
+run_setup(){
+
+printf "${green}📦 ¿Desea ejecutar setup.sh? (s/n): ${reset}"
+read RESP
+
+
+ if [ "$RESP" = "s" ]; then
+   bash "$HOME_DIR/script/setup.sh"
+ else
+   system_update
+   system_cleanup
+ fi
+}
+
+main(){
+
+ log "Iniciando Secuencia Post-Install setup-kape"
+
+ detect_distro
+ check_git
+ clone_repo
+ copy_scripts
+ backup_bashrc
+ copy_config
+ create_desktop
+ run_setup
+ cleanup
+
+}
+main

package/package.json

@@ -0,0 +1,33 @@
+{
+  
+  "name": "setup-kapelu",
+  "version": "3.0.0",
+  "description": "Script post-install de Ubuntu",
+  "type": "commonjs",
+  "bin": {
+    "kapelu": "index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Kapelu/kape-setup.git"
+  },
+  "keywords": [
+    "ubuntu",
+    "setup",
+    "post-install",
+    "cli",
+    "script"
+  ],
+  "author": "Daniel Calderon",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/Kapelu/kape-setup/issues"
+  },
+  "homepage": "https://github.com/Kapelu/kape-setup#readme",
+  "files": [
+    "cli.js",
+    "install.sh",
+    "script/",
+    "config/"
+  ]
+}