karnel-termux 4.17.44 → 4.17.45

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.17.45-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.17.45
 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,14 @@ layout: base
 
 # Documentation Changelog
 
+## 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
+29fb2632bc7558b002e10d68272418bcb4450cb1

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/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

@@ -235,14 +235,11 @@ _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

package/karnel/cli/commands/update.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 
+import "@/utils/npm"
 import "@/utils/log"
 import "@/utils/colors"
 import "@/utils/tools"
@@ -213,10 +214,10 @@ _update_cleanup() {
 _update_release_commit() {
   local tag="$1" commit=""
   if command -v git &>/dev/null 2>&1; then
-    commit=$(git ls-remote "https://github.com/israelmarques1024-dotcom/karnel-termux.git" "refs/tags/${tag}^{}" 2>/dev/null | awk '{print $1}')
+    commit=$(git ls-remote "https://github.com/karnel-termuxOFC/karnel-termux.git" "refs/tags/${tag}^{}" 2>/dev/null | awk '{print $1}')
   fi
   if [[ -z "$commit" ]] && command -v curl &>/dev/null 2>&1; then
-    commit=$(curl -fsS -m 10 "https://api.github.com/repos/israelmarques1024-dotcom/karnel-termux/commits/${tag}" 2>/dev/null \
+    commit=$(curl -fsS -m 10 "https://api.github.com/repos/karnel-termuxOFC/karnel-termux/commits/${tag}" 2>/dev/null \
       | grep -m1 '"sha"' | sed -E 's/.*"sha":[[:space:]]*"([0-9a-f]{40})".*/\1/')
   fi
   [[ "$commit" =~ ^[0-9a-f]{40}$ ]] && echo "$commit"
@@ -233,7 +234,7 @@ _update_try_curl() {
   log_info "Trying the official curl installer..."
 
   if ! curl --fail --silent --show-error --location --proto '=https' --proto-redir '=https' \
-    "https://api.github.com/repos/israelmarques1024-dotcom/karnel-termux/releases/latest" \
+    "https://api.github.com/repos/karnel-termuxOFC/karnel-termux/releases/latest" \
     -o "$meta"; then
     rm -f "$meta" "$installer" "$sumfile"
     return 1
@@ -247,10 +248,10 @@ _update_try_curl() {
   fi
 
   if ! curl --fail --silent --show-error --location --proto '=https' --proto-redir '=https' \
-    "https://github.com/israelmarques1024-dotcom/karnel-termux/releases/download/$tag/karnel-termux-install.sh.sha256" \
+    "https://github.com/karnel-termuxOFC/karnel-termux/releases/download/$tag/karnel-termux-install.sh.sha256" \
     -o "$sumfile" ||
     ! curl --fail --silent --show-error --location --proto '=https' --proto-redir '=https' \
-    "https://github.com/israelmarques1024-dotcom/karnel-termux/releases/download/$tag/karnel-termux-install.sh" \
+    "https://github.com/karnel-termuxOFC/karnel-termux/releases/download/$tag/karnel-termux-install.sh" \
     -o "$installer"; then
     rm -f "$meta" "$installer" "$sumfile"
     return 1
@@ -366,7 +367,7 @@ _update_try_npm() {
     return 1
   fi
   log_info "Trying npm update..."
-  if npm update -g karnel-termux --ignore-scripts 2>/dev/null; then
+  if karnel_npm update -g karnel-termux --ignore-scripts 2>/dev/null; then
     local new_ver
     new_ver=$(_npm_installed_version)
     log_success "Updated to v$new_ver via npm"
@@ -383,7 +384,7 @@ _update_try_npm_install() {
     return 1
   fi
   log_info "Trying npm install..."
-  if npm install -g karnel-termux@latest --ignore-scripts 2>/dev/null; then
+  if karnel_npm install -g karnel-termux@latest --ignore-scripts 2>/dev/null; then
     local new_ver
     new_ver=$(_npm_installed_version)
     log_success "Updated to v$new_ver via npm install"
@@ -421,7 +422,7 @@ _update_karnel_repo() {
 
   origin=$(git -C "$repo_dir" remote get-url origin 2>/dev/null) || return 1
   case "${origin%.git}" in
-    https://github.com/israelmarques1024-dotcom/karnel-termux|git@github.com:israelmarques1024-dotcom/karnel-termux) ;;
+    https://github.com/karnel-termuxOFC/karnel-termux|https://github.com/israelmarques1024-dotcom/karnel-termux|git@github.com:karnel-termuxOFC/karnel-termux|git@github.com:israelmarques1024-dotcom/karnel-termux) ;;
     *) log_error "Refusing git update from an untrusted origin: $origin"; return 1 ;;
   esac
   if [[ -n "$(git -C "$repo_dir" status --porcelain --untracked-files=all 2>/dev/null)" ]]; then

package/karnel/tools/ai/10router/install.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 
+import "@/utils/npm"
 import "@/utils/log"
 import "@/utils/version"
 import "@/utils/npm-shebang"
@@ -15,7 +16,7 @@ _10router_dependencies() {
 }
 
 _install_10router_impl() {
-  if ! npm install -g "$TENROUTER_PACKAGE" &>>"$LOG_FILE"; then
+  if ! karnel_npm install -g "$TENROUTER_PACKAGE" &>>"$LOG_FILE"; then
     log_error "Failed to install 10Router"
     return 1
   fi
@@ -36,7 +37,7 @@ install_10router() {
 }
 
 _uninstall_10router_impl() {
-  npm uninstall -g "$TENROUTER_PACKAGE" &>>"$LOG_FILE"
+  karnel_npm uninstall -g "$TENROUTER_PACKAGE" &>>"$LOG_FILE"
 }
 
 uninstall_10router() {
@@ -49,7 +50,7 @@ uninstall_10router() {
 }
 
 _update_10router_impl() {
-  if ! npm update -g "$TENROUTER_PACKAGE" &>>"$LOG_FILE"; then
+  if ! karnel_npm update -g "$TENROUTER_PACKAGE" &>>"$LOG_FILE"; then
     log_error "Failed to update 10Router"
     return 1
   fi

package/karnel/tools/ai/all.sh

@@ -9,6 +9,7 @@
 
 import "@/utils/log"
 import "@/utils/colors"
+import "@/utils/tools"
 
 # KARNEL_CACHE e PREFIX são definidos via env.sh
 # Exportados aqui apenas como fallback para scripts que carregam all.sh diretamente
@@ -114,16 +115,9 @@ _validate_tool_installed() {
       # Verificação extra: se for um stub (shell script que só mostra erro), considera falha
       local bin_path
       bin_path=$(command -v "$bin")
-      if [[ -f "$bin_path" ]]; then
-        local first_line
-        first_line=$(head -1 "$bin_path" 2>/dev/null)
-        # Stubs geralmente começam com #! e contêm "offline" ou "unreachable"
-        if [[ "$first_line" == "#!"* ]]; then
-          if grep -qiE "offline|unreachable|not.available|stub|indisponivel|inacessivel" "$bin_path" 2>/dev/null; then
-            log_warn "$tool_name: instalado como stub offline (instalação real indisponível)"
-            return 2
-          fi
-        fi
+      if karnel_is_stub_binary "$bin_path"; then
+        log_warn "$tool_name: instalado como stub offline (instalação real indisponível)"
+        return 2
       fi
       local probe="${AI_TOOL_PROBES[$tool_id]:-}"
       if [[ -n "$probe" ]]; then

package/karnel/tools/ai/antigravity-cli/README.md

@@ -4,7 +4,7 @@ Lightweight, terminal-first surface for Antigravity agents
 
 **Package:** antigravity-cli  
 **Author:** israel marques  
-**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Repository:** https://github.com/karnel-termuxOFC/karnel-termux  
 **Official:** https://antigravity.google  
 **Type:** AI workflow assistant (Binary + glibc bootstrapper)  
 **License:** MIT

package/karnel/tools/ai/cactus-needle/README.md

@@ -4,7 +4,7 @@ An open 45M-parameter model for tool calling, device use and structured extracti
 
 **Package:** cactus-needle  
 **Author:** israel marques  
-**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Repository:** https://github.com/karnel-termuxOFC/karnel-termux  
 **Official:** https://github.com/cactus-compute/needle  
 **Type:** Python tool-calling model CLI (glibc/JAX adaptation)  
 **License:** See official repository (MIT)

package/karnel/tools/ai/claude-code/README.md

@@ -4,7 +4,7 @@ Anthropic's CLI tool with Claude AI
 
 **Package:** claude-code  
 **Author:** israel marques  
-**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Repository:** https://github.com/karnel-termuxOFC/karnel-termux  
 **Official:** https://github.com/anthropics/claude-code  
 **Type:** AI coding assistant (Binary + glibc bootstrapper)  
 **License:** MIT