karnel-termux 4.17.41 → 4.17.43

package/README.md

@@ -8,7 +8,7 @@
 
 <p align="center">
   <a href="https://github.com/israelmarques1024-dotcom/karnel-termux">
-    <img src="https://img.shields.io/badge/version-4.17.41-0078D4?style=for-the-badge" alt="Version">
+    <img src="https://img.shields.io/badge/version-4.17.43-0078D4?style=for-the-badge" alt="Version">
   </a>
   <a href="https://www.npmjs.com/package/karnel-termux">
     <img src="https://img.shields.io/npm/v/karnel-termux?style=for-the-badge&logo=npm&color=cb3837" alt="npm">
@@ -78,7 +78,7 @@ Why it's great:
 ### Via checksummed GitHub release (recommended)
 
 ```bash
-version=4.17.41
+version=4.17.43
 tmpdir=$(mktemp -d) && trap 'rm -rf "$tmpdir"' EXIT
 base="https://github.com/israelmarques1024-dotcom/karnel-termux/releases/download/v$version"
 curl -fsSL "$base/karnel-termux-install.sh" -o "$tmpdir/karnel-termux-install.sh"
@@ -142,6 +142,7 @@ aliases, or options; use `karnel help` and the CLI reference for the full set.
 | `karnel upgrade` | Upgrade the framework (self-update) |
 | `karnel ia` | Manage AI agent sessions, install tools, show launchers |
 | `karnel search <query>` | Search tools and Brain memories |
+| `karnel stats` | System overview: versions, modules, disk usage, tool counts |
 | `karnel status` | System health dashboard (disk, RAM, services, connectivity) |
 | `karnel start editor [port]` | Start code-server (VS Code in browser) |
 | `karnel start robin` | Start Robin OSINT (Tor + web UI) |
@@ -157,6 +158,10 @@ aliases, or options; use `karnel help` and the CLI reference for the full set.
 | `karnel deploy` | Run Vercel, Railway, Netlify, or Supabase CLI commands |
 | `karnel supabase` | Manage the Supabase CLI and remote-project helpers |
 | `karnel robin` | Manage the Robin OSINT service |
+| `karnel backup` | Backup Termux configs and package metadata |
+| `karnel restore` | Restore Termux from a backup |
+| `karnel cleanup` | Clean caches, logs, and temp files |
+| `karnel plugin` | Plugin manager — search, install, enable, disable, config |
 | `karnel --version` | Show installed version |
 
 ### Modules

package/karnel/RELEASE_COMMIT

@@ -1 +1 @@
-4277f0390226e9a4b99f13cb14a6938bd071b29e
+3b64b17a6f9d7a93bcbfbcd7f0c86e858cd5195d

package/karnel/cli/commands/ia.sh

@@ -4,8 +4,8 @@ import "@/utils/log"
 import "@/utils/colors"
 
 # AI Manager (karnel ia) — router for all AI agents and sessions
-IA_SESSIONS_DIR="$HOME/.local/share/karnel-data/ia/sessions"
-IA_DATA_DIR="$HOME/.local/share/karnel-data/ia"
+IA_SESSIONS_DIR="${KARNEL_DATA:-$HOME/.local/share/karnel-data}/ia/sessions"
+IA_DATA_DIR="${KARNEL_DATA:-$HOME/.local/share/karnel-data}/ia"
 
 ia_help() {
 	echo
@@ -30,13 +30,7 @@ ia_help() {
 
 # List all AI sessions from known tools
 ia_sessions() {
-	# $1 was historically `--all`; agent names are always shown now, so the
-	# flag is accepted for back-compat and ignored.
-	local show_all="${1:-0}"
-	if [[ "$show_all" == "--all" ]]; then
-		show_all=0
-	fi
-
+	# $1 was historically `--all`; agent names are always shown now.
 	mkdir -p "$IA_SESSIONS_DIR"
 
 	local -a sessions=()

package/karnel/cli/commands/reinstall.sh

@@ -131,8 +131,8 @@ _reinstall_full_module() {
     reinstall_auto
     ;;
   games)
-    import "@/tools/games/all"
-    reinstall_all_games
+    import "@/modules/games"
+    reinstall_games
     ;;
   deploy)
     import "@/modules/deploy"
@@ -683,10 +683,10 @@ _reinstall_specific_tools() {
     _batch_tool_action "utils" "reinstall" "${tools[@]}" || return 1
     ;;
   security|deploy)
-    _batch_tool_action "$module" "reinstall" "${tools[@]}" || return 1
+    _batch_tool_action "$target" "reinstall" "${tools[@]}" || return 1
     ;;
   *)
-    log_warn "Unknown reinstall target: $module"
+    log_warn "Unknown reinstall target: $target"
     echo "Run 'karnel reinstall' to see available targets"
     return 1
     ;;

package/karnel/cli/commands/stats.sh

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+import "@/utils/colors"
+
+stats_main() {
+  separator
+  box "◈ KARNEL STATS ◈"
+  separator
+  echo
+
+  _stats_version
+  echo
+  _stats_modules
+  echo
+  _stats_disk
+  echo
+  _stats_tools
+  echo
+}
+
+_stats_version() {
+  printf "  ${D_CYAN}%-14s${NC} v%s\n" "Version:" "$KARNEL_VERSION"
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "KARNEL_PATH:" "$KARNEL_PATH"
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "Shell:" "${SHELL##*/}"
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "Node:" "$(node -v 2>/dev/null || echo 'not installed')"
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "npm:" "$(npm -v 2>/dev/null || echo 'not installed')"
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "Python:" "$(python3 -V 2>/dev/null | awk '{print $2}' || echo 'not installed')"
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "Go:" "$(go version 2>/dev/null | awk '{print $3}' || echo 'not installed')"
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "Rust:" "$(rustc --version 2>/dev/null | awk '{print $2}' || echo 'not installed')"
+}
+
+_stats_modules() {
+  log_info "Installed Modules"
+  echo
+  local -a modules=(ai auto db deploy dev editor games lang network npm osint plugin security shell ui utils voice)
+  local installed=0
+  local not_installed=0
+  local status
+
+  for mod in "${modules[@]}"; do
+    local marker="${KARNEL_DATA:-$HOME/.local/share/karnel-data}/${mod}/.installed"
+    if [[ -f "$marker" ]]; then
+      status="${GREEN}installed${NC}"
+      ((installed++))
+    else
+      status="${D_RED}—${NC}"
+      ((not_installed++))
+    fi
+    printf "    %-12s %b\n" "$mod" "$status"
+  done
+  echo
+  printf "  ${D_CYAN}Total:${NC} %d installed, %d not installed\n" "$installed" "$not_installed"
+}
+
+_stats_disk() {
+  log_info "Disk Usage"
+  echo
+  local karnel_size data_size cache_size config_size
+
+  karnel_size=$(du -sh "$KARNEL_PATH/.." 2>/dev/null | awk '{print $1}')
+  data_size=$(du -sh "${KARNEL_DATA:-$HOME/.local/share/karnel-data}" 2>/dev/null | awk '{print $1}')
+  cache_size=$(du -sh "$KARNEL_CACHE" 2>/dev/null | awk '{print $1}')
+  config_size=$(du -sh "${KARNEL_CONFIG:-$HOME/.config/karnel}" 2>/dev/null | awk '{print $1}')
+
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "Framework:" "${karnel_size:-0}"
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "Data:" "${data_size:-0}"
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "Cache:" "${cache_size:-0}"
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "Config:" "${config_size:-0}"
+
+  local total_storage
+  total_storage=$(du -sh "$KARNEL_PATH/.." "${KARNEL_DATA:-$HOME/.local/share/karnel-data}" "$KARNEL_CACHE" 2>/dev/null | tail -1 | awk '{print $1}')
+  echo
+  printf "  ${D_CYAN}%-14s${NC} %s\n" "Total:" "${total_storage:-unknown}"
+}
+
+_stats_tools() {
+  log_info "Tool Counts"
+  echo
+  local -A tool_counts=(
+    [ai]=0 [auto]=0 [db]=0 [deploy]=0 [dev]=0 [editor]=0
+    [games]=0 [lang]=0 [network]=0 [npm]=0 [osint]=0
+    [plugin]=0 [security]=0 [shell]=0 [ui]=0 [utils]=0 [voice]=0
+  )
+
+  local total=0
+  for mod in "${!tool_counts[@]}"; do
+    local tools_dir="$KARNEL_PATH/tools/$mod"
+    if [[ -d "$tools_dir" ]]; then
+      local count
+      count=$(find "$tools_dir" -maxdepth 1 -mindepth 1 -type d 2>/dev/null | wc -l)
+      tool_counts[$mod]=$count
+      ((total += count))
+    fi
+  done
+
+  for mod in ai auto db deploy dev editor games lang network npm osint plugin security shell ui utils voice; do
+    local count=${tool_counts[$mod]:-0}
+    [[ "$count" -gt 0 ]] && printf "    %-12s %d tools\n" "$mod" "$count"
+  done
+  echo
+  printf "  ${D_CYAN}%-14s${NC} %d tools across %d modules\n" "Total:" "$total" "${#tool_counts[@]}"
+}

package/karnel/cli/commands/uninstall.sh

@@ -149,8 +149,8 @@ _uninstall_full_module() {
     uninstall_security
     ;;
   games)
-    import "@/tools/games/all"
-    uninstall_all_games
+    import "@/modules/games"
+    uninstall_games
     ;;
   supabase)
     import "@/tools/deploy/supabase/install"

package/karnel/cli/commands/update.sh

@@ -131,8 +131,8 @@ _update_full_module() {
     update_auto
     ;;
   games)
-    import "@/tools/games/all"
-    update_all_games
+    import "@/modules/games"
+    update_games
     ;;
   osint)
     import "@/modules/osint"

package/karnel/cli/commands/upgrade.sh

@@ -26,7 +26,11 @@ upgrade_main() {
   echo
   log_info "Running cleanup..."
   import "@/cli/commands/cleanup"
-  cleanup_main
+  local cleanup_rc=0
+  cleanup_main || cleanup_rc=$?
+  if [[ "$cleanup_rc" -ne 0 ]]; then
+    log_warn "Cleanup completed with warnings"
+  fi
   echo
   log_success "Karnel is up to date (v$KARNEL_VERSION)"
   echo

package/karnel/cli/karnel.sh

@@ -115,6 +115,7 @@ karnel_help() {
   printf "    ${D_CYAN}%-18s${NC} %s\n" "search <query>" "Search across all tools and memories"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "show <module> [--tool]" "Show README/docs for a tool"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "start [editor,robin]" "Start services (code-server, etc.)"
+  printf "    ${D_CYAN}%-18s${NC} %s\n" "stats" "System overview: modules, tools, disk usage"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "status" "Quick system overview"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "supabase [doctor,types,migrate,link,remote,remote-status,install,uninstall]" "Supabase CLI (types, migrate, functions, secrets)"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "uninstall <module>" "Remove installed modules"

package/karnel/modules/security.sh

@@ -1,25 +1,65 @@
 #!/usr/bin/env bash
 # shellcheck shell=bash
 
+import "@/utils/log"
+import "@/utils/colors"
+
+LOG_FILE="$KARNEL_CACHE/install_security.log"
+
 install_security() {
   separator
   box "Installing Security Tools"
   separator
+  echo
+  log_info "Installing security tools..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+  local rc=0
   import "@/tools/security/all"
-  install_all_security
+  install_all_security || rc=$?
+  separator
+  [[ "$rc" -eq 0 ]] && log_success "Security tools installed" || log_warn "$rc security tool(s) failed to install"
+  return "$rc"
 }
 
 uninstall_security() {
+  separator
+  box "Uninstalling Security Tools"
+  separator
+  echo
+  log_info "Uninstalling security tools..."
+  local rc=0
   import "@/tools/security/all"
-  uninstall_all_security
+  uninstall_all_security || rc=$?
+  separator
+  [[ "$rc" -eq 0 ]] && log_success "Security tools uninstalled" || log_warn "$rc security tool(s) failed to uninstall"
+  return "$rc"
 }
 
 update_security() {
+  separator
+  box "Updating Security Tools"
+  separator
+  echo
+  log_info "Updating security tools..."
+  local rc=0
   import "@/tools/security/all"
-  update_all_security
+  update_all_security || rc=$?
+  separator
+  [[ "$rc" -eq 0 ]] && log_success "Security tools updated" || log_warn "$rc security tool(s) failed to update"
+  return "$rc"
 }
 
 reinstall_security() {
+  separator
+  box "Reinstalling Security Tools"
+  separator
+  echo
+  log_info "Reinstalling security tools..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+  local rc=0
   import "@/tools/security/all"
-  reinstall_all_security
+  reinstall_all_security || rc=$?
+  separator
+  [[ "$rc" -eq 0 ]] && log_success "Security tools reinstalled" || log_warn "$rc security tool(s) failed to reinstall"
+  return "$rc"
 }

package/karnel/modules/ui.sh

@@ -4,13 +4,8 @@ import "@/utils/log"
 import "@/utils/colors"
 
 TERMUX_DIR="$HOME/.termux"
-TERMUX_ASSETS_DIR="$(dirname "$KARNEL_PATH")/assets"
 LOG_FILE="$KARNEL_CACHE/install_ui.log"
 
-install_ui() {
-	setup_ui
-}
-
 setup_ui() {
 	separator
 	box "Configuring Termux UI"

package/karnel/utils/install.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-LOG_FILE="${LOG_FILE:-$KARNEL_CACHE/install_ai.log}"
+LOG_FILE="${LOG_FILE:-$KARNEL_CACHE/install.log}"
 
 # ── Dependency installation ────────────────────────────────────
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karnel-termux",
-  "version": "4.17.41",
+  "version": "4.17.43",
   "description": "Modular Dev Environment for Termux — install languages, databases, AI agents, editors, and more with one command",
   "bin": {
     "karnel": "karnel/bin/karnel"

package/scripts/completion.bash

@@ -35,7 +35,7 @@ _karnel_completions() {
   local cur prev words cword
   _init_completion || return
 
-  local commands="agent backup brain cleanup deploy doctor env help ia init install list open pg plugin reinstall restore robin search show start status supabase uninstall update upgrade version voice"
+  local commands="agent backup brain cleanup deploy doctor env help ia init install list open pg plugin reinstall restore robin search show start stats status supabase uninstall update upgrade version voice"
   local modules="ai auto db deploy dev editor games lang network npm osint plugin security shell ui utils voice"
   local install_targets="$modules supabase"
   local update_targets="$modules supabase karnel"

package/scripts/completion.zsh

@@ -28,6 +28,7 @@ _karnel_commands() {
     'search:Search tools and memories'
     'show:Show tool documentation'
     'start:Start a service'
+    'stats:System overview with versions, modules, and tool counts'
     'status:Show a quick system overview'
     'supabase:Manage Supabase CLI remote workflows'
     'uninstall:Remove modules and tools'