karnel-termux 4.17.5 → 4.17.6

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.16.1-0078D4?style=for-the-badge" alt="Version">
+    <img src="https://img.shields.io/badge/version-4.17.6-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">
@@ -64,7 +64,7 @@ Core agent contributions by **devcorex**.
 ### Via checksummed GitHub release (recommended)
 
 ```bash
-version=4.16.1
+version=4.17.6
 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"

package/docs/{ARCHITECTURE.md → ARCHITECTURE/index.md}

@@ -31,14 +31,18 @@ karnel-termux/
 │   │   ├── lang/               # 8 languages
 │   │   ├── db/                 # 5 databases
 │   │   ├── dev/                # 22 dev tools
-│   │   ├── editor/             # Code editor
-│   │   ├── npm/                # Global npm packages
-│   │   ├── shell/              # ZSH plugins
-│   │   ├── ui/                 # Termux UI
-│   │   ├── auto/               # Automation
-│   │   ├── deploy/             # Deploy CLIs
+│   │   ├── editor/             # code-server, Neovim, NvChad
+│   │   ├── npm/                # 11 global npm packages
+│   │   ├── shell/              # ZSH + 10 plugins
+│   │   ├── ui/                 # 4 UI components
+│   │   ├── auto/               # n8n automation
+│   │   ├── deploy/             # 4 deploy CLIs
+│   │   ├── games/              # 6 games
 │   │   ├── network/            # 2 network tools (dark, dedsec-network)
 │   │   ├── utils/              # 12 utility tools (fconv, notes, zork, SuperFile, etc.)
+│   │   ├── security/           # 30 security tools
+│   │   ├── voice/              # Speech-to-agent via Termux:API
+│   │   ├── plugins/            # Built-in plugin manager
 │   │   └── osint/              # Robin OSINT integration
 │   └── utils/                  # Shared utilities
 │       ├── bootstrap.sh        # Import mechanism, shell detection
@@ -105,7 +109,9 @@ on the caller's dynamic scope.
 
 ## Module System
 
-Each module (`lang`, `db`, `ai`, `dev`, etc.) has:
+Each module (`ai`, `auto`, `db`, `deploy`, `dev`, `editor`, `games`, `lang`,
+`network`, `npm`, `osint`, `security`, `shell`, `ui`, `utils`, `voice`,
+`plugin`) has:
 
 1. A **module orchestrator** in `karnel/modules/<name>.sh` — handles installation logic
 2. Individual **tool installers** in `karnel/tools/<name>/<tool>/install.sh` — each installs one tool
@@ -133,4 +139,4 @@ _tool_postinstall() { ... }      # Post-installation setup
 
 ## Doctor Subsystem Architecture
 
-See [Doctor System](./doctor/README.md) for the complete breakdown of the doctor code analysis engine.
+See [Doctor System](./doctor/) for the complete breakdown of the doctor code analysis engine.

package/docs/_config.yml

@@ -0,0 +1,8 @@
+title: Karnel Termux
+description: Modular Dev Environment for Termux — install languages, databases, AI agents, editors, and more with one command.
+theme: jekyll-theme-cayman
+markdown: kramdown
+exclude:
+  - vendor
+  - Gemfile
+  - Gemfile.lock

package/docs/index.md

@@ -0,0 +1,39 @@
+# Karnel Termux Documentation
+
+> Modular Dev Environment for Termux — install languages, databases, AI agents, editors, and more with one command
+
+## Quick Links
+
+- [CLI Commands](./cli/) — All `karnel` subcommands
+- [Doctor System](./doctor/) — Environment diagnosis and code analysis
+- [Troubleshooting](./troubleshooting/) — Common issues and fixes
+- [Architecture Overview](./ARCHITECTURE/)
+- [Bug Fixes & Changelog](./CHANGELOG.md)
+- [Published Documentation Site](https://israelmarques1024-dotcom.github.io/karnel-termux/)
+
+## What is Karnel?
+
+Karnel Termux transforms your Android device into a complete development workstation.
+With a single CLI (`karnel`), you can install and manage 43 AI tools, 8 languages,
+5 databases, 22 dev tools, 11 npm packages, 10 shell plugins, 4 UI components,
+4 deploy CLIs, 6 games, 2 network tools, 12 utility tools, 30 security tools,
+responsible OSINT, a second brain, voice commands, and reviewed plugins — all
+from modules: `ai`, `auto`, `db`, `deploy`, `dev`, `editor`, `games`, `lang`,
+`network`, `npm`, `osint`, `security`, `shell`, `ui`, `utils`, `voice`, `plugin`.
+
+## Sections
+
+- **[CLI Commands](./cli/)** — Full reference for every `karnel` subcommand
+- **[Doctor System](./doctor/)** — How `karnel doctor` works, code analysis engine, environment checks
+- **[Robin OSINT](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/osint/robin/README.md)** — Responsible use, lifecycle, data locations, and troubleshooting
+- **[Network Tools](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/network/dark/README.md)** — dark, dedsec-network
+- **[KeelCode](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/ai/keelcode/README.md)** — Hosted coding-agent CLI: `karnel install ai --keelcode`
+- **[SuperFile](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/utils/superfile/README.md)** — Terminal file manager: `karnel install utils --superfile`
+- **[Utility Scripts](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/utils/fconv/README.md)** — fconv, notes, treex, SuperFile, passman, applaunch, splash, httptmux, zork, qrcode and more
+- **[Supabase CLI](./cli/#supabase--remote-project-helpers)** — `karnel supabase` remote-project helpers
+- **[Architecture](./ARCHITECTURE/)** — Project structure, module system, import mechanism
+- **[Changelog](./CHANGELOG.md)** — Version history, bug fixes, known issues
+
+## Credits
+
+Created by **Israel Marques**. Core agent contributions by **devcorex**.

package/karnel/RELEASE_COMMIT

@@ -1 +1 @@
-2e76f74b21de6f9a01911b2c06b96ac09d12359d
+0b701b2757116687f7022e331187baa382cf63a9

package/karnel/cli/commands/pg.sh

@@ -4,9 +4,19 @@ import "@/utils/log"
 import "@/utils/colors"
 
 # Variáveis globais do PostgreSQL
+: "${PREFIX:=/data/data/com.termux/files/usr}"
 PG_DATA_DEFAULT="$PREFIX/var/lib/postgresql"
 PG_LOG="$KARNEL_CACHE/postgresql.log"
-PG_USER="postgres"
+# Termux PostgreSQL creates the superuser role from the OS user, not "postgres".
+PG_USER="$(id -un 2>/dev/null || whoami 2>/dev/null || echo postgres)"
+PGPORT="5432"
+# Prefer the local Unix socket; fall back to TCP only when the socket is absent.
+if [[ -d "$PREFIX/var/run/postgresql" ]]; then
+	PGHOST="$PREFIX/var/run/postgresql"
+else
+	PGHOST="localhost"
+fi
+export PGUSER="$PG_USER" PGPORT="$PGPORT" PGHOST="$PGHOST" PGDATABASE="postgres"
 
 # Função para exportar variáveis de ambiente do PostgreSQL
 pg_export_env() {
@@ -15,7 +25,7 @@ pg_export_env() {
 		export PGDATA="$data_dir"
 		export PGUSER="$PG_USER"
 		export PGPORT="5432"
-		export PGHOST="localhost"
+		export PGHOST="$PGHOST"
 		export PGDATABASE="postgres"
 		# Adicionar binários do PostgreSQL ao PATH se necessário
 		if [[ -d "$PREFIX/bin" ]]; then
@@ -116,11 +126,7 @@ pg_init() {
 		log_success "PostgreSQL initialized successfully"
 		echo
 		list_item "Data directory: $PG_DATA_DEFAULT"
-		list_item "OS user: $os_user (superuser)"
-		list_item "PostgreSQL user: $PG_USER (may need to be created)"
-		echo
-		log_info "To create the 'postgres' role:"
-		list_item "${D_CYAN}psql -d postgres -c \"CREATE ROLE $PG_USER LOGIN SUPERUSER;\"${NC}"
+		list_item "Superuser role: $PG_USER (the Termux OS user)"
 		echo
 		log_info "Start PostgreSQL with: ${D_CYAN}karnel pg start${NC}"
 	else

package/karnel/modules/shell.sh

@@ -51,10 +51,12 @@ install_oh_my_zsh() (
 			log_error "Unable to pin the Oh My Zsh clone"
 			return 1
 		fi
-		if ! CHSH=no RUNZSH=no BRANCH="$OH_MY_ZSH_REF" sh "$temp_file" &>>"$LOG_FILE"; then
+		if ! CHSH=no RUNZSH=no BRANCH="master" sh "$temp_file" &>>"$LOG_FILE"; then
 			log_error "Failed to install Oh My Zsh"
 			return 1
 		fi
+		# Record Karnel ownership so uninstall only removes a Karnel-managed install.
+		: >"$OH_MY_ZSH_DIR/.karnel-managed"
 		log_success "Oh My Zsh installed successfully"
 		return 0
 	else
@@ -159,16 +161,25 @@ install_shell() {
 
 	mkdir -p "$(dirname "$LOG_FILE")"
 
-	loading "Installing base packages" install_termux_packages
-	log_success "Base packages installed"
+	local rc=0
+	if ! loading "Installing base packages" install_termux_packages; then
+		log_error "Base package installation failed"
+		rc=1
+	fi
 	echo
 
-	install_oh_my_zsh
+	if ! install_oh_my_zsh; then
+		log_error "Oh My Zsh installation failed"
+		rc=1
+	fi
 	echo
 
-	local rc=0
 	_install_shell_plugins_wrapper || rc=$?
-	log_success "ZSH plugins installed"
+	if (( rc == 0 )); then
+		log_success "ZSH plugins installed"
+	else
+		log_warn "ZSH plugin(s) failed to install"
+	fi
 	echo
 
 	setup_zsh_aliases
@@ -245,7 +256,7 @@ uninstall_oh_my_zsh() {
 	log_info "Uninstalling Oh My Zsh..."
 
 	local remove_rc=0
-	confirm_remove_paths "Oh My Zsh" "$OH_MY_ZSH_DIR" &>>"$LOG_FILE" || remove_rc=$?
+	confirm_remove_paths "Oh My Zsh" "$OH_MY_ZSH_DIR" || remove_rc=$?
 	if [[ "$remove_rc" -eq 0 ]]; then
 		log_success "Oh My Zsh uninstalled"
 	elif [[ "$remove_rc" -eq 2 ]]; then

package/karnel/tools/db/mongodb/install.sh

@@ -13,6 +13,9 @@ _install_mongodb_impl() {
 			log_error "Failed to install tur-repo"
 			return 1
 		fi
+		if ! pkg update -y &>>"$LOG_FILE"; then
+			log_warn "pkg update after adding tur-repo failed (see $LOG_FILE)"
+		fi
 	fi
 
 	if pkg install mongodb -y &>>"$LOG_FILE"; then

package/karnel/tools/deploy/netlify/install.sh

@@ -3,12 +3,22 @@
 import "@/utils/log"
 import "@/utils/version"
 
+LOG_FILE="${LOG_FILE:-${KARNEL_CACHE:-$HOME/.cache/karnel}/install_deploy.log}"
+
 NETLIFY_VERSION="27.1.1"
+NETLIFY_MARKER="$PREFIX/share/karnel-installers/netlify"
+
+_netlify_is_owned() {
+  command -v netlify &>/dev/null && [[ -f "$NETLIFY_MARKER" ]] || return 1
+}
 
 _netlify_node_supported() {
-  local version
+  local version required
   version="$(node --version 2>/dev/null | sed 's/^v//')"
-  [[ -n "$version" ]] && [[ "$(printf '%s\n%s\n' '22.13.0' "$version" | sort -V | head -1)" == "22.13.0" ]]
+  [[ -n "$version" ]] || return 1
+  required="$(npm view "netlify-cli@$NETLIFY_VERSION" engines.node 2>/dev/null | tr -d "'" | sed 's/[<>=~^ ]//g')"
+  required="${required:-18.0.0}"
+  [[ "$(printf '%s\n%s\n' "$required" "$version" | sort -V | head -1)" == "$required" ]]
 }
 
 install_netlify() {
@@ -16,6 +26,7 @@ install_netlify() {
     log_info "Netlify CLI is already installed"
     return 2
   fi
+  mkdir -p "$(dirname "$LOG_FILE")"
   if ! command -v node &>/dev/null || ! command -v npm &>/dev/null; then
     log_info "Installing Node.js..."
     if ! pkg install -y nodejs-lts &>>"$LOG_FILE"; then
@@ -23,29 +34,35 @@ install_netlify() {
       return 1
     fi
   fi
-	if ! _netlify_node_supported; then
-		log_error "Netlify CLI requires Node.js 22.13.0 or newer. Update Node.js and retry."
-		return 1
-	fi
+  if ! _netlify_node_supported; then
+    log_error "Netlify CLI requires Node.js (see: npm view netlify-cli@$NETLIFY_VERSION engines.node); update Node.js and retry."
+    return 1
+  fi
   log_info "Installing Netlify CLI..."
-  npm install -g "netlify-cli@$NETLIFY_VERSION" &>/dev/null || {
-    log_error "Failed to install Netlify CLI"
+  if ! npm install -g "netlify-cli@$NETLIFY_VERSION" --legacy-peer-deps &>>"$LOG_FILE"; then
+    log_error "Failed to install Netlify CLI (see $LOG_FILE)"
     return 1
-  }
+  fi
   command -v termux-fix-shebang &>/dev/null && termux-fix-shebang "$(command -v netlify)" &>/dev/null
-	if ! netlify --version &>/dev/null; then
-		log_error "Netlify CLI did not start after installation"
-		return 1
-	fi
+  if ! netlify --version &>/dev/null; then
+    log_error "Netlify CLI did not start after installation"
+    return 1
+  fi
+  mkdir -p "$(dirname "$NETLIFY_MARKER")" && : >"$NETLIFY_MARKER"
   log_success "Netlify CLI installed"
 }
 
 uninstall_netlify() {
+  if ! _netlify_is_owned; then
+    log_warn "Preserving Netlify CLI not managed by Karnel"
+    return 2
+  fi
   log_info "Uninstalling Netlify CLI..."
-  npm uninstall -g netlify-cli &>/dev/null || {
-    log_error "Failed to uninstall Netlify CLI"
+  if ! npm uninstall -g netlify-cli &>>"$LOG_FILE"; then
+    log_error "Failed to uninstall Netlify CLI (see $LOG_FILE)"
     return 1
-  }
+  fi
+  rm -f "$NETLIFY_MARKER"
   log_success "Netlify CLI uninstalled"
 }
 
@@ -54,15 +71,21 @@ update_netlify() {
 }
 
 _do_update_netlify() {
-  npm update -g netlify-cli &>/dev/null || {
-    log_error "Failed to update Netlify CLI"
+  if ! _netlify_is_owned; then
+    log_warn "Skipping update: Netlify CLI not managed by Karnel"
+    return 2
+  fi
+  if ! npm update -g netlify-cli --legacy-peer-deps &>>"$LOG_FILE"; then
+    log_error "Failed to update Netlify CLI (see $LOG_FILE)"
     return 1
-  }
+  fi
   command -v termux-fix-shebang &>/dev/null && termux-fix-shebang "$(command -v netlify)" &>/dev/null
   return 0
 }
 
 reinstall_netlify() {
   uninstall_netlify
+  local rc=$?
+  [[ "$rc" == 0 || "$rc" == 2 ]] || return "$rc"
   install_netlify
 }

package/karnel/tools/deploy/supabase/install.sh

@@ -1,5 +1,8 @@
 #!/usr/bin/env bash
 
+import "@/utils/log"
+import "@/utils/version"
+
 _SUPABASE_VERSION="2.20.8"
 _SUPABASE_RELEASE_URL="https://github.com/supabase/cli/releases/download/v${_SUPABASE_VERSION}"
 _SUPABASE_BIN="$PREFIX/bin/supabase"
@@ -142,6 +145,8 @@ update_supabase() {
 }
 
 reinstall_supabase() {
-  uninstall_supabase || return $?
+  uninstall_supabase
+  local rc=$?
+  [[ "$rc" == 0 || "$rc" == 2 ]] || return "$rc"
   install_supabase
 }

package/karnel/tools/deploy/vercel/install.sh

@@ -3,13 +3,20 @@
 import "@/utils/log"
 import "@/utils/version"
 
-VERCEL_BIN="$PREFIX/lib/node_modules/vercel/dist/vc.js"
+LOG_FILE="${LOG_FILE:-${KARNEL_CACHE:-$HOME/.cache/karnel}/install_deploy.log}"
+
+VERCEL_MARKER="$PREFIX/share/karnel-installers/vercel"
+
+_vercel_is_owned() {
+  command -v vercel &>/dev/null && [[ -f "$VERCEL_MARKER" ]] || return 1
+}
 
 install_vercel() {
-  if [[ -f "$VERCEL_BIN" ]]; then
+  if command -v vercel &>/dev/null; then
     log_info "Vercel CLI is already installed"
     return 2
   fi
+  mkdir -p "$(dirname "$LOG_FILE")"
   if ! command -v node &>/dev/null || ! command -v npm &>/dev/null; then
     log_info "Installing Node.js..."
     if ! pkg install -y nodejs-lts &>>"$LOG_FILE"; then
@@ -18,20 +25,26 @@ install_vercel() {
     fi
   fi
   log_info "Installing Vercel CLI..."
-  npm install -g vercel &>/dev/null || {
-    log_error "Failed to install Vercel CLI"
+  if ! npm install -g vercel --legacy-peer-deps &>>"$LOG_FILE"; then
+    log_error "Failed to install Vercel CLI (see $LOG_FILE)"
     return 1
-  }
+  fi
   command -v termux-fix-shebang &>/dev/null && termux-fix-shebang "$(command -v vercel)" &>/dev/null
+  mkdir -p "$(dirname "$VERCEL_MARKER")" && : >"$VERCEL_MARKER"
   log_success "Vercel CLI installed"
 }
 
 uninstall_vercel() {
+  if ! _vercel_is_owned; then
+    log_warn "Preserving Vercel CLI not managed by Karnel"
+    return 2
+  fi
   log_info "Uninstalling Vercel CLI..."
-  npm uninstall -g vercel &>/dev/null || {
-    log_error "Failed to uninstall Vercel CLI"
+  if ! npm uninstall -g vercel &>>"$LOG_FILE"; then
+    log_error "Failed to uninstall Vercel CLI (see $LOG_FILE)"
     return 1
-  }
+  fi
+  rm -f "$VERCEL_MARKER"
   log_success "Vercel CLI uninstalled"
 }
 
@@ -40,15 +53,21 @@ update_vercel() {
 }
 
 _do_update_vercel() {
-  npm update -g vercel &>/dev/null || {
-    log_error "Failed to update Vercel CLI"
+  if ! _vercel_is_owned; then
+    log_warn "Skipping update: Vercel CLI not managed by Karnel"
+    return 2
+  fi
+  if ! npm update -g vercel --legacy-peer-deps &>>"$LOG_FILE"; then
+    log_error "Failed to update Vercel CLI (see $LOG_FILE)"
     return 1
-  }
+  fi
   command -v termux-fix-shebang &>/dev/null && termux-fix-shebang "$(command -v vercel)" &>/dev/null
   return 0
 }
 
 reinstall_vercel() {
   uninstall_vercel
+  local rc=$?
+  [[ "$rc" == 0 || "$rc" == 2 ]] || return "$rc"
   install_vercel
 }

package/karnel/tools/editor/code-server/install.sh

@@ -3,6 +3,8 @@
 import "@/utils/log"
 import "@/utils/version"
 
+LOG_FILE="${LOG_FILE:-${KARNEL_CACHE:-$HOME/.cache/karnel}/install_editor.log}"
+
 # code-server - VS Code in the browser for Termux
 # Official docs: https://coder.com/docs/code-server
 # Termux install: pkg install tur-repo && pkg install code-server
@@ -17,16 +19,23 @@ install_code_server() {
 
   log_info "Installing code-server (VS Code for Termux)..."
 
+  mkdir -p "$(dirname "$LOG_FILE")"
+
   # Add tur-repo if not present (required for code-server on Termux)
   if ! pkg list-installed 2>/dev/null | grep -q tur-repo; then
     log_info "Adding tur-repo (required for code-server)..."
-    pkg install -y tur-repo 2>/dev/null
+    if ! pkg install -y tur-repo &>>"$LOG_FILE"; then
+      log_error "Failed to add tur-repo (see $LOG_FILE)"
+      return 1
+    fi
   fi
 
-  pkg install -y code-server 2>/dev/null
-  local rc=$?
+  if ! pkg update -y &>>"$LOG_FILE"; then
+    log_error "Failed to refresh package lists (see $LOG_FILE)"
+    return 1
+  fi
 
-  if [[ $rc -eq 0 ]] && command -v code-server &>/dev/null; then
+  if pkg install -y code-server &>>"$LOG_FILE" && command -v code-server &>/dev/null; then
     # Do not replace a user-managed configuration or its password.
     mkdir -p "$HOME/.config/code-server"
     chmod 700 "$HOME/.config/code-server"
@@ -47,7 +56,7 @@ CONF
     log_info "The generated password is stored in ~/.config/code-server/config.yaml (chmod 600)"
     return 0
   else
-    log_error "code-server installation failed"
+    log_error "code-server installation failed (see $LOG_FILE)"
     return 1
   fi
 }
@@ -59,8 +68,11 @@ uninstall_code_server() {
   fi
 
   log_info "Uninstalling code-server..."
-  pkg uninstall -y code-server 2>/dev/null
-  return $?
+  if ! pkg uninstall -y code-server &>>"$LOG_FILE"; then
+    log_error "Failed to uninstall code-server (see $LOG_FILE)"
+    return 1
+  fi
+  return 0
 }
 
 update_code_server() {
@@ -80,7 +92,7 @@ _update_code_server_impl() {
 }
 
 reinstall_code_server() {
-  uninstall_code_server 2>/dev/null
+  uninstall_code_server
   install_code_server
   return $?
 }

package/karnel/tools/lang/rust/install.sh

@@ -18,7 +18,7 @@ _install_rust_pkg_impl() {
 }
 
 install_rust() {
-	if command -v rust &>/dev/null; then
+	if command -v rustc &>/dev/null; then
 		log_info "Rust is already installed"
 		return 2
 	fi

package/karnel/tools/npm/live-server/install.sh

@@ -13,7 +13,9 @@ _live_server_dependencies() {
 
   log_info "Installing Nodejs..."
   mkdir -p "$(dirname "$LOG_FILE")"
-  pkg install nodejs-lts -y &>>"$LOG_FILE"
+  if ! pkg install nodejs-lts -y &>>"$LOG_FILE"; then
+    log_error "Failed to install Node.js (required by this tool)"; return 1
+  fi
 }
 
 _install_live_server_npm() {
@@ -37,8 +39,7 @@ install_live_server() {
 
   log_info "Installing Live Server..."
 
-  _live_server_dependencies
-
+  _live_server_dependencies || return 1
   mkdir -p "$(dirname "$LOG_FILE")"
 
   _install_live_server_npm || return 1

package/karnel/tools/npm/localtunnel/install.sh

@@ -28,7 +28,9 @@ _localtunnel_dependencies() {
   log_info "Installing Nodejs..."
 
   mkdir -p "$(dirname "$LOG_FILE")"
-  pkg install nodejs-lts -y &>>"$LOG_FILE"
+  if ! pkg install nodejs-lts -y &>>"$LOG_FILE"; then
+    log_error "Failed to install Node.js (required by this tool)"; return 1
+  fi
 }
 
 _install_localtunnel_npm() {
@@ -53,8 +55,7 @@ install_localtunnel() {
   fi
   log_info "Installing Localtunnel..."
 
-  _localtunnel_dependencies
-
+  _localtunnel_dependencies || return 1
   mkdir -p "$(dirname "$LOG_FILE")"
 
   _install_localtunnel_npm || return 1

package/karnel/tools/npm/markserv/install.sh

@@ -13,7 +13,9 @@ _markserv_dependencies() {
 
   log_info "Installing Nodejs..."
   mkdir -p "$(dirname "$LOG_FILE")"
-  pkg install nodejs-lts -y &>>"$LOG_FILE"
+  if ! pkg install nodejs-lts -y &>>"$LOG_FILE"; then
+    log_error "Failed to install Node.js (required by this tool)"; return 1
+  fi
 }
 
 _install_markserv_npm() {
@@ -36,8 +38,7 @@ install_markserv() {
   fi
   log_info "Installing Markserv..."
 
-  _markserv_dependencies
-
+  _markserv_dependencies || return 1
   mkdir -p "$(dirname "$LOG_FILE")"
 
   _install_markserv_npm || return 1

package/karnel/tools/npm/ncu/install.sh

@@ -13,7 +13,9 @@ _ncu_dependencies() {
 
   log_info "Installing Nodejs..."
   mkdir -p "$(dirname "$LOG_FILE")"
-  pkg install nodejs-lts -y &>>"$LOG_FILE"
+  if ! pkg install nodejs-lts -y &>>"$LOG_FILE"; then
+    log_error "Failed to install Node.js (required by this tool)"; return 1
+  fi
 }
 
 _install_ncu_npm() {
@@ -36,8 +38,7 @@ install_ncu() {
   fi
   log_info "Installing NPM Check Updates..."
 
-  _ncu_dependencies
-
+  _ncu_dependencies || return 1
   mkdir -p "$(dirname "$LOG_FILE")"
 
   _install_ncu_npm || return 1

package/karnel/tools/npm/nestjs/install.sh

@@ -13,7 +13,9 @@ _nestjs_dependencies() {
 
   log_info "Installing Nodejs..."
   mkdir -p "$(dirname "$LOG_FILE")"
-  pkg install nodejs-lts -y &>>"$LOG_FILE"
+  if ! pkg install nodejs-lts -y &>>"$LOG_FILE"; then
+    log_error "Failed to install Node.js (required by this tool)"; return 1
+  fi
 }
 
 _install_nestjs_npm() {
@@ -36,8 +38,7 @@ install_nestjs() {
   fi
   log_info "Installing NestJS CLI..."
 
-  _nestjs_dependencies
-
+  _nestjs_dependencies || return 1
   mkdir -p "$(dirname "$LOG_FILE")"
 
   _install_nestjs_npm || return 1

package/karnel/tools/npm/ngrok/install.sh

@@ -13,7 +13,9 @@ _ngrok_dependencies() {
 
   log_info "Installing Nodejs..."
   mkdir -p "$(dirname "$LOG_FILE")"
-  pkg install nodejs-lts -y &>>"$LOG_FILE"
+  if ! pkg install nodejs-lts -y &>>"$LOG_FILE"; then
+    log_error "Failed to install Node.js (required by this tool)"; return 1
+  fi
 }
 
 _install_ngrok_npm() {
@@ -36,8 +38,7 @@ install_ngrok() {
   fi
   log_info "Installing Ngrok..."
 
-  _ngrok_dependencies
-
+  _ngrok_dependencies || return 1
   mkdir -p "$(dirname "$LOG_FILE")"
 
   _install_ngrok_npm || return 1

package/karnel/tools/npm/prettier/install.sh

@@ -13,7 +13,9 @@ _prettier_dependencies() {
 
   log_info "Installing Nodejs..."
   mkdir -p "$(dirname "$LOG_FILE")"
-  pkg install nodejs-lts -y &>>"$LOG_FILE"
+  if ! pkg install nodejs-lts -y &>>"$LOG_FILE"; then
+    log_error "Failed to install Node.js (required by this tool)"; return 1
+  fi
 }
 
 _install_prettier_npm() {
@@ -36,8 +38,7 @@ install_prettier() {
   fi
   log_info "Installing Prettier..."
 
-  _prettier_dependencies
-
+  _prettier_dependencies || return 1
   mkdir -p "$(dirname "$LOG_FILE")"
 
   _install_prettier_npm || return 1

package/karnel/tools/npm/psqlformat/install.sh

@@ -13,7 +13,9 @@ _psqlformat_dependencies() {
 
   log_info "Installing Nodejs and Perl..."
   mkdir -p "$(dirname "$LOG_FILE")"
-  pkg install nodejs-lts perl -y &>>"$LOG_FILE"
+  if ! pkg install nodejs-lts -y &>>"$LOG_FILE"; then
+    log_error "Failed to install Node.js (required by this tool)"; return 1
+  fi
 }
 
 _install_psqlformat_npm() {
@@ -36,8 +38,7 @@ install_psqlformat() {
   fi
   log_info "Installing PSQL Format..."
 
-  _psqlformat_dependencies
-
+  _psqlformat_dependencies || return 1
   mkdir -p "$(dirname "$LOG_FILE")"
 
   _install_psqlformat_npm || return 1

package/karnel/tools/npm/typescript/install.sh

@@ -13,7 +13,9 @@ _typescript_dependencies() {
 
   log_info "Installing Nodejs..."
   mkdir -p "$(dirname "$LOG_FILE")"
-  pkg install nodejs-lts -y &>>"$LOG_FILE"
+  if ! pkg install nodejs-lts -y &>>"$LOG_FILE"; then
+    log_error "Failed to install Node.js (required by this tool)"; return 1
+  fi
 }
 
 _install_typescript_npm() {
@@ -36,8 +38,7 @@ install_typescript() {
   fi
   log_info "Installing TypeScript..."
 
-  _typescript_dependencies
-
+  _typescript_dependencies || return 1
   mkdir -p "$(dirname "$LOG_FILE")"
 
   _install_typescript_npm || return 1

package/karnel/tools/npm/vercel/install.sh

@@ -13,7 +13,9 @@ _vercel_dependencies() {
 
   log_info "Installing Nodejs..."
   mkdir -p "$(dirname "$LOG_FILE")"
-  pkg install nodejs-lts -y &>>"$LOG_FILE"
+  if ! pkg install nodejs-lts -y &>>"$LOG_FILE"; then
+    log_error "Failed to install Node.js (required by this tool)"; return 1
+  fi
 }
 
 _install_vercel_npm() {
@@ -36,8 +38,7 @@ install_vercel() {
   fi
   log_info "Installing Vercel CLI..."
 
-  _vercel_dependencies
-
+  _vercel_dependencies || return 1
   mkdir -p "$(dirname "$LOG_FILE")"
 
   _install_vercel_npm || return 1

package/karnel/tools/voice/uninstall.sh

@@ -3,6 +3,15 @@
 import "@/utils/log"
 
 _uninstall_voice_tool() {
-  log_info "Termux:API can be removed with: pkg uninstall termux-api"
+  if command -v termux-api &>/dev/null; then
+    log_info "Removing Termux:API..."
+    if ! pkg uninstall -y termux-api &>>"$LOG_FILE"; then
+      log_error "Failed to remove Termux:API (see $LOG_FILE)"
+      return 1
+    fi
+    log_success "Termux:API removed"
+  else
+    log_info "Termux:API is not installed"
+  fi
   return 0
 }

package/karnel/utils/log.sh

@@ -436,11 +436,11 @@ loading() {
 
 	printf "    ${CYAN}⠋${D_CYAN} %s${NC}" "$message"
 
+	mkdir -p "$KARNEL_CACHE"
+
 	"$@" >"$tmpfile" 2>&1 &
 	cmd_pid=$!
 
-	mkdir -p "$KARNEL_CACHE"
-
 	local frame_idx=0
 	while kill -0 "$cmd_pid" 2>/dev/null; do
 		printf "\r    ${CYAN}%s${D_CYAN} %s${NC}" "${frames[$frame_idx]}" "$message"

package/karnel/utils/uninstall.sh

@@ -8,9 +8,23 @@ confirm_remove_paths() {
   local -a existing=()
 
   for path in "$@"; do
-    [[ -e "$path" || -L "$path" ]] && existing+=("$path")
+    [[ -e "$path" || -L "$path" ]] || continue
+    # Ownership gate: refuse to remove a path that is not managed by Karnel unless
+    # explicitly forced. This prevents silently deleting a user's own directory
+    # (e.g. a pre-existing ~/.oh-my-zsh or ~/.zsh-plugins/<plugin>).
+    if [[ -z "${KARNEL_FORCE:-}" ]]; then
+      local owned=0
+      for marker in "$path/.karnel-managed" "$path/.karnel-pinned-git" "$path/.managed-by-karnel"; do
+        [[ -f "$marker" ]] && owned=1 && break
+      done
+      if (( owned == 0 )); then
+        log_warn "Preserving $label at $path (not managed by Karnel)"
+        continue
+      fi
+    fi
+    existing+=("$path")
   done
-  (( ${#existing[@]} > 0 )) || return 0
+  (( ${#existing[@]} > 0 )) || return 2
 
   read_confirm_default "Remove $label configuration and data?" "$default" answer || return 2
   [[ "$answer" == "y" ]] || return 2

package/karnel/utils/version.sh

@@ -176,31 +176,31 @@ _check_update_needed() {
   local remote_ver="$3"
   local update_func="$4"
 
-  if [ -z "$installed_ver" ]; then
-    log_warn "$display_name: could not detect installed version"
-    echo
-    local confirm_var
-    read_confirm_default "Update $display_name anyway?" "y" confirm_var
-    if [ "$confirm_var" = "y" ]; then
-      $update_func
-      return $?
-    fi
-    log_info "Skipped $display_name"
-    return 0
-  fi
-
-  if [ -z "$remote_ver" ]; then
-    log_warn "$display_name: could not detect remote version"
-    echo
-    local confirm_var
-    read_confirm_default "Update $display_name anyway?" "y" confirm_var
-    if [ "$confirm_var" = "y" ]; then
-      $update_func
-      return $?
-    fi
-    log_info "Skipped $display_name"
-    return 0
-  fi
+	if [ -z "$installed_ver" ]; then
+		log_warn "$display_name: could not detect installed version"
+		echo
+		local confirm_var
+		read_confirm_default "Update $display_name anyway?" "n" confirm_var
+		if [ "$confirm_var" = "y" ]; then
+			$update_func
+			return $?
+		fi
+		log_info "Skipped $display_name"
+		return 0
+	fi
+
+	if [ -z "$remote_ver" ]; then
+		log_warn "$display_name: could not detect remote version"
+		echo
+		local confirm_var
+		read_confirm_default "Update $display_name anyway?" "n" confirm_var
+		if [ "$confirm_var" = "y" ]; then
+			$update_func
+			return $?
+		fi
+		log_info "Skipped $display_name"
+		return 0
+	fi
 
   if _compare_versions "$installed_ver" "$remote_ver"; then
     log_success "$display_name is already up to date (${D_GREEN}v${installed_ver}${D_NC})"

package/package.json

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

package/docs/README.md

@@ -1,35 +0,0 @@
-# Karnel Termux Documentation
-
-> Modular Dev Environment for Termux — install languages, databases, AI agents, editors, and more with one command
-
-## Quick Links
-
-- [CLI Commands](./cli/README.md) — All `karnel` subcommands
-- [Doctor System](./doctor/README.md) — Environment diagnosis and code analysis
-- [Troubleshooting](./troubleshooting.md) — Common issues and fixes
-- [Architecture Overview](./ARCHITECTURE.md)
-- [Bug Fixes & Changelog](./CHANGELOG.md)
-- [Official Documentation Site](https://karneltermux.vercel.app/karnel/doctor)
-
-## What is Karnel?
-
-Karnel Termux transforms your Android device into a complete development workstation.
-With a single CLI (`karnel`), you can install and manage 43 AI tools, 8 languages,
-5 databases, 22 dev tools, 12 utility tools, 2 network tools, 6 games, responsible OSINT, and more.
-
-## Sections
-
-- **[CLI Commands](./cli/README.md)** — Full reference for every `karnel` subcommand
-- **[Doctor System](./doctor/README.md)** — How `karnel doctor` works, code analysis engine, environment checks
-- **[Robin OSINT](../karnel/tools/osint/robin/README.md)** — Responsible use, lifecycle, data locations, and troubleshooting
-- **[Network Tools](../karnel/tools/network/dark/README.md)** — dark, dedsec-network
-- **[KeelCode](../karnel/tools/ai/keelcode/README.md)** — Hosted coding-agent CLI: `karnel install ai --keelcode`
-- **[SuperFile](../karnel/tools/utils/superfile/README.md)** — Terminal file manager: `karnel install utils --superfile`
-- **[Utility Scripts](../karnel/tools/utils/fconv/README.md)** — fconv, notes, treex, SuperFile, passman, applaunch, splash, httptmux, zork, qrcode and more
-- **[Supabase CLI](./cli/README.md#supabase--remote-project-helpers)** — `karnel supabase` remote-project helpers
-- **[Architecture](./ARCHITECTURE.md)** — Project structure, module system, import mechanism
-- **[Changelog](./CHANGELOG.md)** — Version history, bug fixes, known issues
-
-## Credits
-
-Created by **Israel Marques**. Core agent contributions by **devcorex**.