karnel-termux 4.17.44 → 4.18.0

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/israelmarques1024-dotcom/karnel-termux/main/assets/images/karnel-logo.png" alt="Karnel Termux Logo" width="400">
+  <img src="https://raw.githubusercontent.com/karnel-termuxOFC/karnel-termux/main/assets/images/karnel-logo.png" alt="Karnel Termux Logo" width="400">
 </p>
 
 <p align="center">
@@ -7,8 +7,8 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux">
-    <img src="https://img.shields.io/badge/version-4.17.44-0078D4?style=for-the-badge" alt="Version">
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux">
+    <img src="https://img.shields.io/badge/version-4.18.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">
@@ -16,7 +16,7 @@
   <a href="https://www.npmjs.com/package/karnel-termux">
   <img src="https://img.shields.io/npm/dt/karnel-termux?style=for-the-badge&logo=npm&color=cb3837" alt="npm downloads">
 </a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/LICENSE">
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/LICENSE">
     <img src="https://img.shields.io/badge/license-MIT-0078D4?style=for-the-badge" alt="License">
   </a>
   <a href="https://termux.dev/">
@@ -78,9 +78,9 @@ Why it's great:
 ### Via checksummed GitHub release (recommended)
 
 ```bash
-version=4.17.44
+version=4.18.0
 tmpdir=$(mktemp -d) && trap 'rm -rf "$tmpdir"' EXIT
-base="https://github.com/israelmarques1024-dotcom/karnel-termux/releases/download/v$version"
+base="https://github.com/karnel-termuxOFC/karnel-termux/releases/download/v$version"
 curl -fsSL "$base/karnel-termux-install.sh" -o "$tmpdir/karnel-termux-install.sh"
 curl -fsSL "$base/karnel-termux-install.sh.sha256" -o "$tmpdir/karnel-termux-install.sh.sha256"
 (cd "$tmpdir" && sha256sum -c karnel-termux-install.sh.sha256) && bash "$tmpdir/karnel-termux-install.sh" --ref "v$version"
@@ -250,7 +250,7 @@ optional checksum, and informational capabilities. Native command names and
 plugin-to-plugin command collisions are rejected.
 
 The installed plugin directory is `${XDG_DATA_HOME:-$HOME/.local/share}/karnel-data/plugins`.
-See the [official plugin registry](https://github.com/israelmarques1024-dotcom/karnel-plugins)
+See the [official plugin registry](https://github.com/karnel-termuxOFC/karnel-plugins)
 for schemas, review policy, and safe publication requirements.
 
 ## AI CLIs
@@ -408,7 +408,7 @@ definitions across 68 distinct tool labels. It detects subprojects, executes
 checks in the matching project or subproject directory, preserves command exit status, and writes
 timestamped text reports under `$KARNEL_DATA/doctor_code_reports/`.
 
-Read the **[complete Doctor reference](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/doctor/index.md)** for modes,
+Read the **[complete Doctor reference](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/doctor/index.md)** for modes,
 supported ecosystems, tool coverage, JSON schema, reports, and auto-fix safety.
 
 ---
@@ -565,12 +565,12 @@ Documentation loads from https://karneltermux.vercel.app.
 
 ## Documentation
 
-- [Documentation index](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/index.md)
-- [CLI reference](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/cli/index.md)
-- [Doctor reference](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/doctor/index.md)
-- [Troubleshooting](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/troubleshooting/index.md)
-- [Architecture](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/ARCHITECTURE/index.md)
-- [Documentation changelog](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/CHANGELOG.md)
+- [Documentation index](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/index.md)
+- [CLI reference](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/cli/index.md)
+- [Doctor reference](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/doctor/index.md)
+- [Troubleshooting](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/troubleshooting/index.md)
+- [Architecture](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/ARCHITECTURE/index.md)
+- [Documentation changelog](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/CHANGELOG.md)
 - [Official website](https://karneltermux.vercel.app)
 
 ---

package/docs/CHANGELOG.md

@@ -6,6 +6,22 @@ layout: base
 
 # Documentation Changelog
 
+## 4.18.0
+
+- **Three-tier compatibility layer:** a foreign glibc binary is no longer handled by one fixed trick. `compat_adapt` wraps, probes and climbs to the cheapest tier that actually starts the tool — the glibc loader alone (free, installs nothing), the glibc userland (`$PREFIX/glibc/bin`, 383 glibc tools, prepended to `PATH` together with the glibc exec shim so child processes resolve the same way), or proot over a synthetic `/lib`, `/usr` and `/etc` assembled from the sysroot already on the device. That last tier replaces `proot-distro install ubuntu` for binaries that merely hardcode an absolute path, and it downloads nothing. A tier that cannot be reached is refused before the wrapper is written, so `proot -r ''` can never ship, and every step unwraps back to `<path>.karnel-real`.
+- **Shebang repair that survives symlinks:** `compat_fix_shebang` edits the target of a link rather than the link itself. `sed -i` unlinks its argument, so repairing `$PREFIX/bin/npm` used to replace that symlink with a detached copy of `npm-cli.js` whose relative `require('../lib/cli.js')` then resolved from `$PREFIX/bin` — one broken `npm` traded for another. The same bug was live in `karnel doctor`, whose `_fix_npm_shebangs` ran `sed -i` over every entry in `$PREFIX/bin`.
+- **`npm` and the CLIs on top of it were dead on arrival:** Android has no `/usr`, so `#!/usr/bin/env node` exits 126 with `bad interpreter` even though node is installed, and none of the three `termux-exec` preloads intercepts the kernel's shebang resolution. `npm`, `npx`, `kc`, `kcode`, `keel`, `snyk`, `httptmuxd`, `gdbus-codegen`, `glib-genmarshal` and `glib-mkenums` all now resolve to their Termux interpreter; `$PREFIX/bin` reports 0 unresolvable shebangs.
+- **Doctor:** the check asks whether the interpreter path exists instead of grepping for the literal `#!/usr/bin/env`, so a stale absolute path is caught and a resolvable `env` line is left alone; the fix delegates to the compatibility layer; a new *Android Compatibility Layer* section reports the glibc sysroot, how many tools are riding a wrapper, whether proot is reachable for the FHS tier, and any shebang that still does not resolve.
+- **Tests:** `tests/android-compat.sh` covers classification, wrapping, re-tiering without disturbing the parked original, escalation, falling back when no tier helps, building the FHS root exactly once, refusing tier 4 without a root, shebang repair through a symlink, and agreement with `readelf` (17 cases).
+
+## 4.17.45
+
+- **npm on a real Termux host:** every npm call goes through `karnel_npm()`, which runs npm through `node` when its `#!/usr/bin/env node` shebang cannot be executed (Termux ships no `/usr`, so the kernel answered `bad interpreter`) and retries with `--force` only on `EBADPLATFORM`. The remaining bare `npm install/uninstall/update/view/ls` calls in the installers were converted; guests inside proot keep plain npm.
+- **Installers that could never succeed:** wpscan and wafw00f read their recorded backend with a redirection-only command (`< file`) that prints nothing, so update and uninstall always failed; KeelCode validated the base package digest instead of the `linux-arm64` release it actually downloads; Cline, Command Code, Copilot Termux and Walkie repaired the shebang on the failure branch, leaving the installed binary unrunnable.
+- **Stub detection:** `karnel_is_stub_binary()` replaces a word-list heuristic that reported real CLIs (`supercode`, `python-config`) as offline placeholders right after a successful install.
+- **Test harness:** `run_test` runs the body under `set -e` so intermediate failures surface. This exposed a Turbopack contract that always failed on the x86_64 CI runner, a Kilo Code install aborted by a `tar` stub and an Odysseus uninstall that had to assert its refusal explicitly.
+- **Output noise:** the version spinner probes `/dev/tty` for real instead of trusting `-c`, which passed without a controlling terminal and leaked `No such device or address` into every `karnel update`.
+
 ## 4.17.44
 
 - **CLI correctness:** `karnel search` builds its catalog from tool READMEs in one pass instead of per-directory subshells; `karnel stats` counts modules that actually carry install markers and prints `not installed` instead of empty probes; `karnel open` gained routes for `doctor`, `brain`, `pg`, `init`, `env`, `backup`, `show`, `cleanup`, `supabase`, `linux`, `plugin`, `voice`, `security`, `osint`, `termux`, `termux-api` and `terms`.

package/docs/_layouts/base.html

@@ -9,7 +9,7 @@ layout: default
   <a href="{{ '/troubleshooting/' | relative_url }}">Troubleshooting</a>
   <a href="{{ '/ARCHITECTURE/' | relative_url }}">Architecture</a>
   <a href="{{ '/CHANGELOG/' | relative_url }}">Changelog</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux">GitHub</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux">GitHub</a>
 </nav>
 
 {{ content }}

package/docs/cli/index.md

@@ -349,7 +349,7 @@ karnel robin doctor --network
 karnel robin purge-data --yes
 ```
 
-See the [Robin reference](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/osint/robin/README.md) for detailed
+See the [Robin reference](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/osint/robin/README.md) for detailed
 lifecycle, data locations, and troubleshooting.
 
 ---

package/docs/index.md

@@ -37,11 +37,11 @@ Open its docs with `karnel open herdr`.
   <a href="./cli/">CLI Commands — full reference for every <code>karnel</code> subcommand</a>
   <a href="./doctor/">Doctor System — environment checks and the code-analysis engine</a>
   <a href="./troubleshooting/">Troubleshooting — common issues and fixes</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/osint/robin/README.md">Robin OSINT — responsible use, lifecycle, data locations</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/network/dark/README.md">Network Tools — dark, dedsec-network</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/ai/keelcode/README.md">KeelCode — hosted coding-agent CLI</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/utils/superfile/README.md">SuperFile — terminal file manager</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/utils/fconv/README.md">Utility Scripts — fconv, notes, treex, and more</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/osint/robin/README.md">Robin OSINT — responsible use, lifecycle, data locations</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/network/dark/README.md">Network Tools — dark, dedsec-network</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/ai/keelcode/README.md">KeelCode — hosted coding-agent CLI</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/utils/superfile/README.md">SuperFile — terminal file manager</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/utils/fconv/README.md">Utility Scripts — fconv, notes, treex, and more</a>
   <a href="./cli/#supabase--remote-project-helpers">Supabase CLI — remote-project helpers</a>
   <a href="./CHANGELOG/">Changelog — version history and fixes</a>
 </div>

package/docs/karnel/ai/index.md

@@ -12,6 +12,6 @@ AI coding agents and assistants (Claude Code, Codex, Cline, Goose, and many more
 | `ai`      | `--qwen-code`, `--gemini-cli`, `--claude-code`, `--mistral-vibe`, `--openclaude`, `--openclaw`, `--ollama`, `--codex`, `--opencode`, `--mimocode`, `--engram`, `--codegraph`, `--pi`, `--antigravity-cli`, `--minimax-cli`, `--gentle-ai`, `--gga`, `--hermes-agent`, `--kimi-code`, `--command-code`, `--codebuff`, `--freebuff`, `--kilocode-cli`, `--kiro`, `--crush`, `--cline`, `--odysseus`, `--kimchi-code`, `--omni-route`, `--ctx7`, `--openspec`, `--supercode-cli`, `--puter`, `--keelcode`, `--copilot-termux`, `--qoder`, `--ampcode`, `--cursor-cli`, `--oh-my-pi`, `--goose`, `--droid`, `--cactus`, `--cactus-needle`, `--walkie`, `--hugging-face` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#ai) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/ai.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/ai.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/auto/index.md

@@ -12,6 +12,6 @@ Automation and workflow tooling (n8n).
 | `auto`    | `--n8n` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#auto) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/auto.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/auto.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/db/index.md

@@ -12,6 +12,6 @@ Databases such as PostgreSQL, MongoDB, Redis and companions.
 | `db`      | `--postgresql`, `--mariadb`, `--sqlite`, `--mongodb`, `--redis` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#db) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/db.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/db.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/deploy/index.md

@@ -12,6 +12,6 @@ Deploy CLIs (Railway, Netlify, Vercel, Supabase).
 | `deploy`  | `--vercel`, `--railway`, `--netlify`, `--supabase` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#deploy) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/deploy.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/deploy.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/dev/index.md

@@ -12,6 +12,6 @@ General development utilities (fzf, bat, make, proot, tmux, and more).
 | `dev`     | `--gh`, `--wget`, `--curl`, `--lsd`, `--bat`, `--proot`, `--ncurses`, `--tmate`, `--openssh`, `--tmux`, `--cloudflared`, `--translate`, `--html2text`, `--jq`, `--bc`, `--tree`, `--fzf`, `--imagemagick`, `--shfmt`, `--make`, `--udocker`, `--snyk` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#dev) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/dev.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/dev.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/editor/index.md

@@ -12,6 +12,6 @@ Terminal and browser-based editors (code-server, Neovim, and more).
 | `editor`  | `--code-server`, `--neovim`, `--nvchad` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#editor) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/editor.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/editor.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/games/index.md

@@ -12,6 +12,6 @@ Terminal games to relax between sessions.
 | `games`   | `--buzz`, `--ctfgod`, `--detective`, `--pet-friends`, `--tamagotchi`, `--arcade` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#games) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/games.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/games.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/lang/index.md

@@ -12,6 +12,6 @@ Programming-language runtimes (Python, Node.js, Rust, Go, and more).
 | `lang`    | `--bun`, `--nodejs`, `--python`, `--perl`, `--php`, `--rust`, `--clang`, `--golang` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#lang) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/lang.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/lang.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/network/index.md

@@ -12,6 +12,6 @@ Network utilities (dark, dedsec-network).
 | `network` | `--dark`, `--dedsec-network` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#network) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/network.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/network.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/npm/index.md

@@ -12,6 +12,6 @@ Node.js packages and JavaScript tooling.
 | `npm`     | `--typescript`, `--nestjs`, `--prettier`, `--live-server`, `--localtunnel`, `--vercel`, `--markserv`, `--psqlformat`, `--ncu`, `--ngrok`, `--turbopack` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#npm) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/npm.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/npm.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/osint/index.md

@@ -12,6 +12,6 @@ OSINT tooling, centered on Robin.
 | `osint`   | Robin OSINT |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#osint) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/osint.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/osint.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/plugin/index.md

@@ -12,6 +12,6 @@ The plugin system and manager.
 | `plugin`         | Plugin system |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#plugin) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/plugin.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/plugin.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/security/index.md

@@ -12,6 +12,6 @@ Security and pentest tooling (30 tools).
 | `security`       | Security tools |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#security) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/security.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/security.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/shell/index.md

@@ -12,6 +12,6 @@ Shell enhancements (ZSH, Oh My Zsh, zoxide).
 | `shell`   | `--powerlevel10k`, `--zsh-defer`, `--zsh-autosuggestions`, `--zsh-syntax-highlighting`, `--history-substring`, `--zsh-completions`, `--fzf-tab`, `--you-should-use`, `--zsh-autopair`, `--better-npm` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#shell) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/shell.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/shell.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/ui/index.md

@@ -12,6 +12,6 @@ Termux UI components.
 | `ui`      | `--font`, `--extra-keys`, `--cursor`, `--banner` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#ui) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/ui.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/ui.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/utils/index.md

@@ -16,6 +16,6 @@ and tracked with Karnel ownership markers so `karnel uninstall utils --herdr` is
 | `utils`   | `--fconv`, `--filecheck`, `--websites`, `--notes`, `--treex`, `--passman`, `--applaunch`, `--splash`, `--httptmux`, `--zork`, `--qrcode`, `--superfile`, `--herdr` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#utils) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/utils.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/utils.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/voice/index.md

@@ -12,6 +12,6 @@ Voice commands for AI agents.
 | `voice`          | Voice command |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#voice) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/voice.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/voice.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/troubleshooting/index.md

@@ -40,7 +40,7 @@ Create an npm **granular access token** with:
 - **Permissions**: Automation (Bypass 2FA)
 
 Save it as the `NPM_TOKEN` Actions secret in the
-`israelmarques1024-dotcom/karnel-termux` repository. Never paste a token into
+`karnel-termuxOFC/karnel-termux` repository. Never paste a token into
 issues, chat, shell history, or screenshots. If a token is ever exposed,
 revoke it immediately at https://www.npmjs.com/settings/<user>/tokens.
 
@@ -58,7 +58,7 @@ the Vercel production site, `https://karneltermux.vercel.app`. The `Publish Docs
 workflow (`.github/workflows/docs.yml`) runs `actions/jekyll-build-pages` on
 every push to `main` that changes `docs/**`, uploads the result as a Pages
 artifact and deploys it to the `github-pages` environment; that mirror,
-`https://israelmarques1024-dotcom.github.io/karnel-termux/`, is served only
+`https://karnel-termuxOFC.github.io/karnel-termux/`, is served only
 while GitHub Pages is enabled for the repository.
 
 If a build fails, open the Actions run for the failing job and read the Jekyll

package/install.sh

@@ -11,7 +11,7 @@ readonly P_FAIL='\e[1;31m'
 readonly P_HL='\e[38;5;213m'
 readonly P_NC='\e[0m'
 
-REPO="https://github.com/israelmarques1024-dotcom/karnel-termux"
+REPO="https://github.com/karnel-termuxOFC/karnel-termux"
 BRANCH="main"
 RELEASE_REF=""
 INSTALL_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

package/karnel/RELEASE_COMMIT

@@ -1 +1 @@
-993646aa095b290adc04835c38c98a56ff05c212
+a6c1aeb11507e48d4e14c3f6c2eb9bd9e9f969da

package/karnel/bin/karnel

@@ -90,7 +90,7 @@ check_for_updates() {
     fi
     if ! _valid_semver "$remote_version"; then
       remote_version=""
-      if remote_output=$(curl -fsSL --max-time 5 "https://raw.githubusercontent.com/israelmarques1024-dotcom/karnel-termux/main/package.json" 2>/dev/null); then
+      if remote_output=$(curl -fsSL --max-time 5 "https://raw.githubusercontent.com/karnel-termuxOFC/karnel-termux/main/package.json" 2>/dev/null); then
         remote_version=$(printf '%s\n' "$remote_output" | sed -nE 's/^[[:space:]]*"version":[[:space:]]*"([^"]+)".*/\1/p' | head -1)
       fi
     fi

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

@@ -4,6 +4,7 @@
 import "@/utils/log"
 import "@/utils/colors"
 import "@/utils/install"
+import "@/utils/compat"
 
 _fix_storage() {
   termux-setup-storage 2>/dev/null
@@ -219,19 +220,13 @@ _fix_pip_check() {
 }
 
 _fix_npm_shebangs() {
-  local fixed=0
-  for f in "$PREFIX/bin/"*; do
-    [[ -f "$f" ]] || continue
-    local shebang
-		shebang=$(head -1 "$f" 2>/dev/null | tr -d '\0\r' | xargs)
-		if [[ "$shebang" == "#!/usr/bin/env node" ]]; then
-      sed -i "1s|^.*$|#!$PREFIX/bin/node|" "$f" && ((fixed++))
-    elif [[ "$shebang" == "#!/usr/bin/env bash" ]] || [[ "$shebang" == "#!/usr/bin/env sh" ]]; then
-      sed -i "1s|^.*$|#!$PREFIX/bin/bash|" "$f" && ((fixed++))
-    elif [[ "$shebang" == "#!/usr/bin/env python3" ]] || [[ "$shebang" == "#!/usr/bin/env python" ]]; then
-      sed -i "1s|^.*$|#!$PREFIX/bin/python3|" "$f" && ((fixed++))
-    fi
-  done
+  # Delegates to the compatibility layer instead of sed-ing $PREFIX/bin
+  # itself: most of those entries are symlinks into node_modules, and
+  # `sed -i` unlinks its argument, which would replace npm's symlink with a
+  # detached copy whose relative require() resolves from the wrong directory.
+  # compat_fix_shebang edits the target and copes with any interpreter, not
+  # just node/bash/python3.
+  compat_fix_shebangs "$PREFIX/bin" >/dev/null 2>&1
   return 0
 }
 

package/karnel/cli/commands/doctor.sh

@@ -2,6 +2,7 @@
 
 import "@/utils/log"
 import "@/utils/colors"
+import "@/utils/compat"
 
 doctor_main() {
   local subcommand="${1:-termux}"
@@ -769,19 +770,31 @@ doctor_termux() {
   separator_section "Binary & Shebang Health"
   echo
 
-  # Check for bad shebangs (#!/usr/bin/env) in PREFIX/bin (fast grep)
+  # Interpreters that do not exist on this device. Android has no /usr, so
+  # every "#!/usr/bin/env node" the kernel meets answers ENOENT and the shell
+  # reports 126, even though node itself is installed. The check is on the
+  # interpreter path rather than on the literal "#!/usr/bin/env" prefix, so a
+  # shebang pointing at a stale absolute path is caught too.
   local bad_shebangs=0
-  local bad_files
-  bad_files=$(timeout 10 rg -l "^#!/usr/bin/env" "$PREFIX/bin/" 2>/dev/null || true)
-  if [[ -n "$bad_files" ]]; then
-    bad_shebangs=$(echo "$bad_files" | wc -l)
-    log_warn "$bad_shebangs binary(s) with #!/usr/bin/env — will fail on Termux"
-    echo "$bad_files" | while IFS= read -r f; do
-      list_item "$(basename "$f")"
+  bad_shebangs="$(timeout 20 compat_count_broken_shebangs "$PREFIX/bin" 2>/dev/null)"
+  bad_shebangs="${bad_shebangs:-0}"
+  if [[ "$bad_shebangs" =~ ^[0-9]+$ ]] && ((bad_shebangs > 0)); then
+    log_warn "$bad_shebangs binary(s) point at an interpreter that does not exist"
+    local sb_file sb_name
+    for sb_file in "$PREFIX/bin"/*; do
+      [[ -f "$sb_file" && -r "$sb_file" ]] || continue
+      IFS= read -r sb_head <"$sb_file" 2>/dev/null || continue
+      [[ "$sb_head" == '#!'* ]] || continue
+      sb_name="${sb_head#\#!}"
+      sb_name="${sb_name# }"
+      sb_name="${sb_name%% *}"
+      if [[ "$sb_name" == /* && ! -x "$sb_name" ]]; then
+        list_item "$(basename "$sb_file") ($sb_name)"
+      fi
     done
     ((warnings++))
-    fix_commands+=("karnel install npm 2>/dev/null || true")
-    fix_descriptions+=("Reinstall npm tools to fix shebangs")
+    fix_commands+=("karnel doctor --fix")
+    fix_descriptions+=("Repoint $bad_shebangs shebang(s) at their Termux interpreter")
     fix_callbacks+=("_fix_npm_shebangs")
   else
     log_success "All binaries have valid shebangs"
@@ -963,6 +976,53 @@ doctor_termux() {
     log_info "proot not installed (optional)"
   fi
 
+  # ===== ANDROID COMPATIBILITY LAYER =====
+  echo
+  separator_section "Android Compatibility Layer"
+  echo
+  # A foreign (glibc) binary cannot be started by the Android kernel at all;
+  # karnel hands it to the loader from the glibc sysroot instead. This block
+  # reports which of the three tiers are reachable and how many tools are
+  # currently riding them.
+  local compat_root compat_wrapped=0 compat_entry compat_fixable
+  if compat_glibc_ready; then
+    compat_root="$(compat_glibc_root)"
+    log_success "glibc sysroot: available ($compat_root)"
+  else
+    log_info "glibc sysroot: not installed (required to run glibc-only tools)"
+    fix_commands+=("pkg install -y glibc-repo glibc")
+    fix_descriptions+=("Install the glibc sysroot so foreign binaries can run")
+    fix_callbacks+=("_fix_pkg_install")
+  fi
+
+  for compat_entry in "$PREFIX/bin"/*; do
+    [[ -f "$compat_entry" ]] || continue
+    if _compat_is_wrapper "$compat_entry"; then
+      compat_wrapped=$((compat_wrapped + 1))
+    fi
+  done
+  if ((compat_wrapped > 0)); then
+    log_success "$compat_wrapped tool(s) running through the compatibility wrapper"
+  else
+    log_info "no tool on PATH currently needs a compatibility wrapper"
+  fi
+
+  if compat_proot_available; then
+    log_success "proot: available (tier 4 for binaries that hardcode /usr or /etc)"
+  elif command -v proot >/dev/null 2>&1; then
+    log_info "proot: installed, but the FHS root could not be assembled"
+  else
+    log_info "proot: not installed (optional; only needed for absolute-path tools)"
+  fi
+
+  compat_fixable="$(timeout 20 compat_count_broken_shebangs "$PREFIX/bin" 2>/dev/null)"
+  compat_fixable="${compat_fixable:-0}"
+  if [[ "$compat_fixable" =~ ^[0-9]+$ ]] && ((compat_fixable > 0)); then
+    log_warn "$compat_fixable shebang(s) still point at a missing interpreter"
+  else
+    log_success "every shebang in $PREFIX/bin resolves"
+  fi
+
   # ===== TERMUX:API =====
   echo
   separator_section "Termux:API"

package/karnel/cli/commands/init.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 
+import "@/utils/npm"
 import "@/utils/log"
 import "@/utils/colors"
 
@@ -169,8 +170,8 @@ EOF
 }
 
 _install_next_deps() {
-	npm install axios lucide-react framer-motion sonner zod react-hook-form @hookform/resolvers @tanstack/react-query zustand tailwindcss &>"$LOG_FILE"
-	npm install -D prettier prettier-plugin-tailwindcss &>>"$LOG_FILE"
+	karnel_npm install axios lucide-react framer-motion sonner zod react-hook-form @hookform/resolvers @tanstack/react-query zustand tailwindcss &>"$LOG_FILE"
+	karnel_npm install -D prettier prettier-plugin-tailwindcss &>>"$LOG_FILE"
 }
 
 # ===== REACT + VITE =====
@@ -295,8 +296,8 @@ EOF
 }
 
 _install_react_deps() {
-	npm install axios lucide-react framer-motion sonner zod react-hook-form @hookform/resolvers @tanstack/react-query zustand tailwindcss clsx tailwind-merge &>"$LOG_FILE"
-	npm install -D prettier prettier-plugin-tailwindcss &>>"$LOG_FILE"
+	karnel_npm install axios lucide-react framer-motion sonner zod react-hook-form @hookform/resolvers @tanstack/react-query zustand tailwindcss clsx tailwind-merge &>"$LOG_FILE"
+	karnel_npm install -D prettier prettier-plugin-tailwindcss &>>"$LOG_FILE"
 }
 
 # ===== EXPRESS.JS =====
@@ -355,11 +356,11 @@ configure_express() {
 }
 
 _install_express_deps() {
-	npm install express pg typeorm reflect-metadata jsonwebtoken cookie-parser morgan cors bcryptjs helmet cloudinary multer express-rate-limit tsconfig-paths zod &>"$LOG_FILE"
+	karnel_npm install express pg typeorm reflect-metadata jsonwebtoken cookie-parser morgan cors bcryptjs helmet cloudinary multer express-rate-limit tsconfig-paths zod &>"$LOG_FILE"
 }
 
 _install_express_dev() {
-	npm install -D typescript ts-node-dev tsconfig-paths tsc-alias @types/node @types/multer @types/morgan @types/jsonwebtoken @types/helmet @types/express @types/cors @types/cookie-parser @types/bcryptjs &>>"$LOG_FILE"
+	karnel_npm install -D typescript ts-node-dev tsconfig-paths tsc-alias @types/node @types/multer @types/morgan @types/jsonwebtoken @types/helmet @types/express @types/cors @types/cookie-parser @types/bcryptjs &>>"$LOG_FILE"
 }
 
 _setup_express_structure() {
@@ -578,8 +579,8 @@ configure_nest() {
 }
 
 _install_nest_deps() {
-	npm install @nestjs/typeorm typeorm pg @nestjs/jwt @nestjs/passport passport passport-jwt passport-local class-validator class-transformer bcryptjs helmet cloudinary &>>"$LOG_FILE"
-	npm install -D @types/passport-jwt @types/passport-local @types/bcryptjs &>>"$LOG_FILE"
+	karnel_npm install @nestjs/typeorm typeorm pg @nestjs/jwt @nestjs/passport passport passport-jwt passport-local class-validator class-transformer bcryptjs helmet cloudinary &>>"$LOG_FILE"
+	karnel_npm install -D @types/passport-jwt @types/passport-local @types/bcryptjs &>>"$LOG_FILE"
 }
 
 configure_python() {

package/karnel/cli/commands/install.sh

@@ -3,6 +3,7 @@
 import "@/utils/log"
 import "@/utils/colors"
 import "@/utils/tools"
+import "@/utils/compat"
 
 install_main() {
 
@@ -235,18 +236,19 @@ _install_specific_tools() {
             IFS=',' read -ra _bin_list <<< "$bins"
             for _bin in "${_bin_list[@]}"; do
               if command -v "$_bin" &>/dev/null; then
-                # Check if it is a stub
                 local _bin_path
                 _bin_path=$(command -v "$_bin")
-                if [ -f "$_bin_path" ] && [ -x "$_bin_path" ]; then
-                  if ! grep -qiE "offline|unreachable|not.available|stub|indisponivel|inacessivel" "$_bin_path" 2>/dev/null || [ "$(head -c 2 "$_bin_path")" != "#!" ]; then
-                    found_bin="$_bin"
-                    break
-                  fi
+                if [ -f "$_bin_path" ] && [ -x "$_bin_path" ] && ! karnel_is_stub_binary "$_bin_path"; then
+                  found_bin="$_bin"
+                  break
                 fi
               fi
             done
             if [ -n "$found_bin" ]; then
+              for _bin in "${_bin_list[@]}"; do
+                declare -f compat_adapt_installed >/dev/null 2>&1 &&
+                  compat_adapt_installed "$_bin" || true
+              done
               ((installed_count++))
             else
               log_warn "$tool: binary not found in PATH after installation"

package/karnel/cli/commands/reinstall.sh

@@ -3,6 +3,7 @@
 import "@/utils/log"
 import "@/utils/colors"
 import "@/utils/tools"
+import "@/utils/compat"
 
 reinstall_main() {