karnel-termux 4.7.7 → 4.9.0

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.7.6-0078D4?style=for-the-badge" alt="Version">
+    <img src="https://img.shields.io/badge/version-4.9.0-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">
@@ -36,8 +36,11 @@ Created by **Israel Marques**.
 - **31 AI agents** for coding — Claude, Gemini, OpenCode, Ollama, Cline, karnelRoute and more
 - **7 languages** — Node.js, Python, Go, Rust, C/C++, PHP, Perl
 - **5 databases** — PostgreSQL, MariaDB, SQLite, MongoDB, Redis
-- **24 dev tools** — gh, curl, fzf, bat, lsd, jq, tmux, openssh, snyk and more
+- **22 dev tools** — gh, curl, fzf, bat, lsd, jq, tmux, openssh, snyk and more
+- **11 utility scripts** — fconv, notes, treex, qrcode, zork and more
+- **2 network tools** — dark, dedsec-network
 - **3 deploy CLIs** — Vercel, Railway, Netlify
+- **Responsible OSINT** — Robin v2.8 through Tor with a loopback-only web UI
 - **Professional editor** — code-server (VS Code in browser)
 - **Second brain** — Memory system with AI search and idea graph
 - **Voice commands** — Speak to your AI agents
@@ -92,6 +95,7 @@ karnel
 | `karnel reinstall <module>` | Reinstall modules |
 | `karnel doctor termux` | Diagnose the Termux environment (30+ sections) |
 | `karnel doctor code` | Detect project ecosystems and run code checks |
+| `karnel doctor robin` | Diagnose Robin, Tor, dependencies, and local UI |
 | `karnel brain` | Second brain — memories and search |
 | `karnel env` | Manage environment variables |
 | `karnel voice` | Voice commands for AI agents |
@@ -99,6 +103,7 @@ karnel
 | `karnel pg` | PostgreSQL manager |
 | `karnel init <template>` | Initialize projects with templates |
 | `karnel deploy` | Deploy projects (Vercel, Railway, Netlify) |
+| `karnel robin` | Manage the Robin OSINT service |
 | `karnel --version` | Show installed version |
 
 ### Modules
@@ -115,6 +120,38 @@ karnel
 | `ui` | Font, cursor, extra-keys, banner | `karnel install ui` |
 | `auto` | Automation with n8n | `karnel install auto` |
 | `deploy` | Vercel, Railway, Netlify | `karnel install deploy` |
+| `games` | Buzz, CTF God, Detective, Tamagotchi and more | `karnel install games` |
+| `network` | Dark Web OSINT, DedSec Network Toolkit | `karnel install network` |
+| `utils` | fconv, notes, treex, passman, applaunch, qrcode, zork and more | `karnel install utils` |
+| `osint` | Robin v2.8, Tor, Streamlit, and LLM providers | `karnel install osint` |
+| `voice` | Speech-to-agent through Termux:API | `karnel install voice` |
+
+---
+
+## Robin OSINT
+
+Robin is an independent AI-assisted dark-web OSINT project. Karnel pins the
+tested `v2.8` release, installs native Termux scientific dependencies, binds the
+web interface only to `127.0.0.1`, and keeps application code separate from
+provider configuration and saved investigations.
+
+```bash
+karnel install osint --robin
+karnel robin config
+karnel robin start
+karnel robin doctor --network
+```
+
+Open `http://127.0.0.1:8501` only after the health check succeeds. Use Robin
+solely for lawful, authorized, and ethical research. Tor does not guarantee
+anonymity, external LLM traffic normally bypasses Tor, providers may process
+submitted data, and AI output is not verified evidence.
+
+Uninstall and reinstall preserve `$KARNEL_CONFIG/robin/.env` and
+`$KARNEL_DATA/robin/investigations`. Permanent deletion requires the explicit
+`karnel robin purge-data` command.
+
+See the bundled reference with `karnel show osint --robin`.
 
 ---
 
@@ -157,7 +194,7 @@ karnel install ai --opencode --ollama         # Install specific agents
 | **Odysseus** | `--odysseus` | Odysseus coding assistant |
 | **Kimchi CLI** | `--kimchi-code` | Kimchi AI agent |
 | **Cline CLI** | `--cline` | Autonomous coding agent (via proot-distro) |
-| **karnelRoute** | `--karnel-route` | AI Gateway with 236+ providers |
+| **omniRoute** | `--omni-route` | AI gateway with 236+ providers |
 | **Context7** | `--ctx7` | Documentation for AI assistants |
 | **OpenSpec** | `--openspec` | Spec-Driven Development |
 | **Copilot-Termux** | `--copilot-termux` | GitHub Copilot CLI adapted for Termux |
@@ -168,7 +205,7 @@ karnel install ai --opencode --ollama         # Install specific agents
 
 ## karnel doctor
 
-Doctor has exactly two operational subcommands:
+Doctor has three operational subcommands:
 
 ```bash
 karnel doctor termux                 # 30+ Termux/Karnel diagnostic sections
@@ -179,6 +216,8 @@ karnel doctor code                   # Quick project analysis
 karnel doctor code --standard .      # Add security, deps, coverage and complexity
 karnel doctor code --deep --json .   # All 76 definitions as standalone JSON
 karnel doctor code --fix .           # Apply fixes classified as safe
+karnel doctor robin                  # Robin/Tor/dependency diagnostics
+karnel doctor robin --network        # Also verify traffic through Tor
 ```
 
 Running `karnel doctor` without a subcommand defaults to `termux`.
@@ -393,12 +432,14 @@ karnel/
 │   │   ├── ai/        # 31 AI agents
 │   │   ├── lang/      # Languages
 │   │   ├── db/        # Databases
-│   │   ├── dev/       # Dev tools
+│   │   ├── dev/       # 22 dev tools
 │   │   ├── editor/    # Code editor
 │   │   ├── npm/       # Global npm packages
 │   │   ├── shell/     # ZSH plugins
 │   │   ├── ui/        # Termux interface
 │   │   ├── auto/      # Automation
+│   │   ├── network/   # 2 network tools
+│   │   ├── utils/     # 11 utility tools
 │   │   └── deploy/    # Deploy CLIs
 │   └── utils/         # Utilities (banner, log, env, etc.)
 ├── install.sh         # Installation script

package/install.sh

@@ -111,8 +111,8 @@ bootstrap_dependencies() {
 
 	if [[ $needed_tput -eq 1 ]]; then
 		echo -e "  ${P_BORDER}→${P_NC}  Installing ncurses-utils..."
-		pkg install -y ncurses-utils &>/dev/null
-		echo -e "  ${P_OK}✔${P_NC}  ncurses-utils installed"
+		pkg install -y ncurses &>/dev/null
+		echo -e "  ${P_OK}✔${P_NC}  ncurses installed"
 		echo
 	fi
 

package/karnel/cli/commands/backup.sh

@@ -2,6 +2,7 @@
 
 import "@/utils/log"
 import "@/utils/colors"
+import "@/tools/osint/robin/common"
 
 backup_main() {
   if [[ "$1" == "--help" || "$1" == "-h" ]]; then
@@ -46,7 +47,7 @@ backup_main() {
       local tool
       tool=$(basename "${t%/}")
       local bins
-      bins=$(grep "\"$tool:" "$m/all.sh" 2>/dev/null | cut -d: -f3 | tr -d '"')
+      bins=$(grep -F "\"$tool:" "$m/all.sh" 2>/dev/null | cut -d: -f3 | tr -d '"')
       local found=false
       for b in ${bins//,/ }; do
         command -v "$b" &>/dev/null && found=true && break
@@ -78,14 +79,24 @@ backup_main() {
       fi
     fi
   done
+  # Robin API keys and investigations are intentionally excluded from ordinary,
+  # unencrypted backups. The acknowledgement file is harmless to retain.
+  if [[ "$ROBIN_CONFIG_DIR" == "$HOME/.config/"* ]]; then
+    local robin_config_relative="${ROBIN_CONFIG_DIR#"$HOME/.config/"}"
+    rm -f "$tmp/config/config/$robin_config_relative"/.env* 2>/dev/null
+  fi
+  find "$tmp/config/config" -type f -path '*/karnel/robin/.env*' -delete 2>/dev/null
   [[ -f "$PREFIX/etc/apt/sources.list" ]] && cp "$PREFIX/etc/apt/sources.list" "$tmp/config/prefix-etc/" 2>/dev/null
 
   tar -czf "$file" -C "$tmp" . 2>/dev/null
   rm -rf "$tmp"
 
-  local size
+  local size checksum
   size=$(du -h "$file" | awk '{print $1}')
+  checksum=$(sha256sum "$file" | awk '{print $1}')
+  echo "$checksum" > "$file.sha256"
   log_success "Backup: $(basename "$file") ($size)"
+  log_success "Checksum (SHA256): ${checksum:0:16}...${checksum: -16}"
 
   # Cloud
   if $cloud; then

package/karnel/cli/commands/doctor/fixes.sh

@@ -134,6 +134,7 @@ _fix_banner() {
 
 $marker
 source "$KARNEL_UTILS/banner.sh"
+render_banner
 EOF
     return 0
   fi
@@ -273,19 +274,6 @@ _fix_proot_ubuntu() {
   return 1
 }
 
-_fix_dns() {
-  if command -v nslookup &>/dev/null && nslookup github.com &>/dev/null; then
-    return 0
-  fi
-  local resolv_conf="$PREFIX/etc/resolv.conf"
-  if [[ -w "$resolv_conf" ]] || [[ -w "$PREFIX/etc" ]]; then
-    cp "$resolv_conf" "${resolv_conf}.bak" 2>/dev/null
-    echo 'nameserver 8.8.8.8' > "$resolv_conf" 2>/dev/null && return 0
-    echo 'nameserver 8.8.4.4' >> "$resolv_conf" 2>/dev/null || true
-  fi
-  return 1
-}
-
 _fix_mirror() {
   if command -v termux-change-repo &>/dev/null; then
     termux-change-repo 2>/dev/null
@@ -325,3 +313,113 @@ _fix_url_quote_magic() {
     "$uqm_file" 2>/dev/null
   return $?
 }
+
+# ===== SCRIPT KEEPER FIX CALLBACKS =====
+
+_fix_script_symlinks() {
+  local fixed=0 module_dir tool_dir
+  while IFS= read -r -d '' module_dir; do
+    while IFS= read -r -d '' tool_dir; do
+      local installer="$tool_dir/install.sh"
+      [[ -f "$installer" ]] || continue
+      local tool_name
+      tool_name=$(basename "$tool_dir")
+      local bin_names
+      bin_names=$(grep -E '^local BIN_NAME=' "$installer" 2>/dev/null | head -1 | sed "s/.*BIN_NAME=\"\?//;s/\"\?$//")
+      [[ -z "$bin_names" ]] && bin_names="$tool_name"
+      for bin_name in $bin_names; do
+        local expected="$tool_dir/$bin_name.py"
+        local link="$PREFIX/bin/$bin_name"
+        if [[ -L "$link" ]]; then
+          local target
+          target=$(readlink "$link")
+          if [[ "$target" != "$expected" ]]; then
+            ln -sf "$expected" "$link" 2>/dev/null && ((fixed++))
+          fi
+        fi
+      done
+    done < <(find "$module_dir" -mindepth 1 -maxdepth 1 -type d -print0 2>/dev/null || true)
+  done < <(find "$KARNEL_PATH/tools/" -mindepth 1 -maxdepth 1 -type d -print0 2>/dev/null || true)
+  [[ $fixed -gt 0 ]] && log_success "Fixed $fixed symlink(s)"
+  return 0
+}
+
+_fix_script_shebangs() {
+  local fixed=0 f
+  while IFS= read -r -d '' f; do
+    local shebang
+    shebang=$(head -1 "$f" 2>/dev/null | tr -d '\0')
+    case "$shebang" in
+      "#!/usr/bin/env node")
+        sed -i "1s|^.*$|#!$PREFIX/bin/node|" "$f" && ((fixed++)) ;;
+      "#!/usr/bin/env bash"|"#!/usr/bin/env sh")
+        sed -i "1s|^.*$|#!$PREFIX/bin/bash|" "$f" && ((fixed++)) ;;
+      "#!/usr/bin/env python3"|"#!/usr/bin/env python")
+        sed -i "1s|^.*$|#!$PREFIX/bin/python3|" "$f" && ((fixed++)) ;;
+    esac
+  done < <(find "$PREFIX/bin" -maxdepth 1 -type f -print0 2>/dev/null || true)
+  [[ $fixed -gt 0 ]] && log_success "Fixed $fixed shebang(s)"
+  return 0
+}
+
+_fix_script_perms() {
+  local fixed=0 script module_dir tool_dir
+  while IFS= read -r -d '' module_dir; do
+    while IFS= read -r -d '' tool_dir; do
+      while IFS= read -r -d '' script; do
+        [[ -x "$script" ]] || { chmod +x "$script" 2>/dev/null && ((fixed++)); }
+      done < <(find "$tool_dir" -maxdepth 1 -type f \( -name '*.py' -o -name '*.sh' \) -print0 2>/dev/null || true)
+    done < <(find "$module_dir" -mindepth 1 -maxdepth 1 -type d -print0 2>/dev/null || true)
+  done < <(find "$KARNEL_PATH/tools/" -mindepth 1 -maxdepth 1 -type d -print0 2>/dev/null || true)
+  [[ $fixed -gt 0 ]] && log_success "Fixed $fixed script permission(s)"
+  return 0
+}
+
+_fix_script_missing() {
+  local fixed=0 total=0 module_dir tool_dir
+  while IFS= read -r -d '' module_dir; do
+    while IFS= read -r -d '' tool_dir; do
+      local installer="$tool_dir/install.sh"
+      [[ -f "$installer" ]] || continue
+      local tool_name
+      tool_name=$(basename "$tool_dir")
+      local module_name
+      module_name=$(basename "$module_dir")
+      local bin_names
+      bin_names=$(grep -E '^local BIN_NAME=' "$installer" 2>/dev/null | head -1 | sed "s/.*BIN_NAME=\"\?//;s/\"\?$//")
+      [[ -z "$bin_names" ]] && bin_names="$tool_name"
+      for bin_name in $bin_names; do
+        ((total++))
+        if ! command -v "$bin_name" &>/dev/null; then
+          karnel install "$module_name" "--$tool_name" &>/dev/null && ((fixed++))
+        fi
+      done
+    done < <(find "$module_dir" -mindepth 1 -maxdepth 1 -type d -print0 2>/dev/null || true)
+  done < <(find "$KARNEL_PATH/tools/" -mindepth 1 -maxdepth 1 -type d -print0 2>/dev/null || true)
+  [[ $fixed -gt 0 ]] && log_success "Reinstalled $fixed/$total missing tool(s)"
+  return 0
+}
+
+_fix_script_stale() {
+  local removed=0 bin_link
+  while IFS= read -r -d '' bin_link; do
+    if [[ -L "$bin_link" ]]; then
+      local target
+      target=$(readlink "$bin_link")
+      if echo "$target" | grep -q "$KARNEL_PATH/tools/" && [[ ! -f "$target" ]]; then
+        rm -f "$bin_link" 2>/dev/null && ((removed++))
+      fi
+    fi
+  done < <(find "$PREFIX/bin" -maxdepth 1 -print0 2>/dev/null || true)
+  [[ $removed -gt 0 ]] && log_success "Removed $removed stale symlink(s)"
+  return 0
+}
+
+_fix_keyring() {
+  pkg update -y &>/dev/null && pkg install -y termux-keyring &>/dev/null
+}
+
+_fix_apt_cache() {
+  rm -rf "$PREFIX/var/apt/lists"/* 2>/dev/null
+  pkg update -y &>/dev/null
+}

package/karnel/cli/commands/doctor.sh

@@ -17,6 +17,12 @@ doctor_main() {
       shift
       doctor_code "$@"
       ;;
+    robin)
+      shift
+      import "@/cli/commands/robin"
+      _robin_print_disclaimer
+      _robin_doctor "$@"
+      ;;
     --quick|-q)
       log_warn "Deprecated: use ${D_CYAN}karnel doctor termux --quick${NC}"
       doctor_termux "$@"
@@ -47,6 +53,7 @@ doctor_help() {
   echo
   printf "    ${D_CYAN}%-16s${NC} %s\n" "termux" "Diagnose Termux environment (full system check)"
   printf "    ${D_CYAN}%-16s${NC} %s\n" "code" "Analyze project code structure and tools"
+  printf "    ${D_CYAN}%-16s${NC} %s\n" "robin" "Diagnose Robin, Tor, dependencies, and local UI"
   echo
   separator_section "Termux Options"
   echo
@@ -57,6 +64,7 @@ doctor_help() {
   list_item "${D_CYAN}karnel doctor${NC} — Termux diagnostics (default)"
   list_item "${D_CYAN}karnel doctor termux --quick${NC} — Quick diagnostics"
   list_item "${D_CYAN}karnel doctor code${NC} — Analyze current project"
+  list_item "${D_CYAN}karnel doctor robin${NC} — Diagnose Robin locally"
   list_item "${D_CYAN}karnel doctor termux --fix${NC} — Diagnose + auto-fix"
   echo
 }
@@ -633,7 +641,110 @@ doctor_termux() {
     ((warnings++))
   fi
 
-  # ===== SHEBANG & BINARY HEALTH =====
+  # ===== SCRIPT KEEPER =====
+  echo
+  separator_section "Script Keeper — Karnel-managed Script Audit"
+  echo
+
+  local script_ok=0 script_warn=0 script_err=0
+  local found_symlink_issues=false found_shebang_issues=false
+  local found_perm_issues=false found_missing_issues=false found_stale_issues=false
+
+  for module_dir in "$KARNEL_PATH/tools/"*/; do
+    local module_name
+    module_name=$(basename "${module_dir%/}")
+    for tool_dir in "$module_dir"*/; do
+      [[ -d "$tool_dir" ]] || continue
+      local tool_name
+      tool_name=$(basename "${tool_dir%/}")
+      local installer="$tool_dir/install.sh"
+      [[ -f "$installer" ]] || continue
+
+      local bin_names
+      bin_names=$(grep -E '^local BIN_NAME=' "$installer" 2>/dev/null | head -1 | sed "s/.*BIN_NAME=\"\?//;s/\"\?$//")
+      [[ -z "$bin_names" ]] && bin_names="$tool_name"
+
+      for bin_name in $bin_names; do
+        local bin_path="$PREFIX/bin/$bin_name"
+        local tool_script="$tool_dir/$bin_name.py"
+
+        if [[ -L "$bin_path" ]]; then
+          local target
+          target=$(readlink "$bin_path")
+          if [[ "$target" == "$tool_script" ]]; then
+            log_success "$module_name/$tool_name → $bin_name (OK)"
+            ((script_ok++))
+          else
+            log_warn "$bin_name: symlink target changed (→ $target, expected $tool_script)"
+            ((script_warn++)); found_symlink_issues=true
+          fi
+
+          if [[ -f "$bin_path" ]] && head -1 "$bin_path" 2>/dev/null | grep -q "^#!/usr/bin/env"; then
+            log_warn "$bin_name: uses #!/usr/bin/env — will fail on Termux"
+            ((script_warn++)); found_shebang_issues=true
+          fi
+
+          if [[ -f "$tool_script" ]]; then
+            local perms
+            perms=$(stat -c "%a" "$tool_script" 2>/dev/null)
+            if [[ "$perms" != "755" ]] && [[ "$perms" != "555" ]] && [[ "$perms" != "775" ]]; then
+              log_warn "$bin_name: script permissions $perms (should be 755)"
+              ((script_warn++)); found_perm_issues=true
+            fi
+          fi
+        elif [[ -f "$bin_path" ]]; then
+          log_info "$bin_name: standalone binary (not Karnel-managed)"
+        else
+          log_warn "$module_name/$tool_name: $bin_name not found in PATH"
+          ((script_warn++)); found_missing_issues=true
+        fi
+      done
+    done
+  done
+
+  for bin_link in "$PREFIX/bin"/*; do
+    if [[ -L "$bin_link" ]]; then
+      local target
+      target=$(readlink "$bin_link")
+      if echo "$target" | grep -q "$KARNEL_PATH/tools/" && [[ ! -f "$target" ]]; then
+        log_warn "Stale symlink: $(basename "$bin_link") → $target (missing)"
+        ((script_warn++)); found_stale_issues=true
+      fi
+    fi
+  done
+
+  if $found_symlink_issues; then
+    fix_commands+=("_fix_script_symlinks")
+    fix_descriptions+=("Fix all Karnel tool symlinks")
+    fix_callbacks+=("_fix_script_symlinks")
+  fi
+  if $found_shebang_issues; then
+    fix_commands+=("_fix_script_shebangs")
+    fix_descriptions+=("Fix all Karnel tool shebangs for Termux")
+    fix_callbacks+=("_fix_script_shebangs")
+  fi
+  if $found_perm_issues; then
+    fix_commands+=("_fix_script_perms")
+    fix_descriptions+=("Fix all Karnel script permissions")
+    fix_callbacks+=("_fix_script_perms")
+  fi
+  if $found_missing_issues; then
+    fix_commands+=("_fix_script_missing")
+    fix_descriptions+=("Reinstall missing Karnel tools")
+    fix_callbacks+=("_fix_script_missing")
+  fi
+  if $found_stale_issues; then
+    fix_commands+=("_fix_script_stale")
+    fix_descriptions+=("Remove stale symlinks from PREFIX/bin")
+    fix_callbacks+=("_fix_script_stale")
+  fi
+
+  if (( script_err == 0 && script_warn == 0 )); then
+    log_success "All $script_ok Karnel-managed scripts healthy"
+  else
+    log_info "Scripts: $script_ok OK, $script_warn warnings, $script_err errors"
+  fi
+
   echo
   separator_section "Binary & Shebang Health"
   echo
@@ -1356,14 +1467,5 @@ EOF
   echo
 }
 
-_fix_keyring() {
-  pkg update -y &>/dev/null && pkg install -y termux-keyring &>/dev/null
-}
-
-_fix_apt_cache() {
-  rm -rf "$PREFIX/var/apt/lists"/* 2>/dev/null
-  pkg update -y &>/dev/null
-}
-
 import "@/cli/commands/doctor/fixes"
 import "@/cli/commands/doctor/code"

package/karnel/cli/commands/init.sh

@@ -1008,7 +1008,7 @@ EOF
 	# Create scripts/run.sh
 	cat >scripts/run.sh <<'EOF'
 #!/usr/bin/env bash
-cargo run
+go run cmd/api/main.go
 EOF
 	chmod +x scripts/run.sh
 
@@ -1192,7 +1192,7 @@ EOF
 	# Create scripts/run.sh
 	cat >scripts/run.sh <<'EOF'
 #!/usr/bin/env bash
-go run cmd/api/main.go
+cargo run
 EOF
 	chmod +x scripts/run.sh