dex-termux-cli 0.3.0-beta.2 → 0.3.0-beta.4

package/bin/dex-project-context

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { main } from '../src/app/main.js';
+
+const argv = process.argv.slice(2);
+
+if (argv.includes('--root')) {
+  await main(['--prompt-project-root']);
+} else if (argv.includes('--path')) {
+  await main(['--prompt-project-path']);
+} else {
+  await main(['--prompt-context']);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dex-termux-cli",
-  "version": "0.3.0-beta.2",
+  "version": "0.3.0-beta.4",
   "type": "module",
   "description": "Visual CLI for Termux and Linux with guided search, readable tree views, project context, version checks, Android mode, and safe flows for Python, Node, PHP, Ruby, Go, Rust, and Java.",
   "keywords": [
@@ -19,7 +19,8 @@
   ],
   "license": "MIT",
   "bin": {
-    "dex": "bin/dex"
+    "dex": "bin/dex",
+    "dex-project-context": "bin/dex-project-context"
   },
   "scripts": {
     "start": "node ./bin/dex",
@@ -29,6 +30,7 @@
   "author": "farllirs",
   "files": [
     "bin/dex",
+    "bin/dex-project-context",
     "src",
     "data/commands/explain.json",
     "README.md",

package/src/app/main.js

@@ -11,10 +11,12 @@ import { runTreeCommand } from '../commands/tree.js';
 import { runVersionCommand } from '../commands/version.js';
 import { printHelp, printProjectContextLine } from '../ui/output.js';
 import { detectProjectContext, formatProjectContext } from '../utils/project-context.js';
+import { resolvePlatformMode } from '../utils/platform.js';
 
 export async function main(argv = process.argv.slice(2)) {
   const parsed = parseArgs(argv);
   const config = await loadUserConfig();
+  const platformMode = resolvePlatformMode(config);
   const isPromptOnly = parsed.command === 'prompt-context' || parsed.command === 'prompt-project-root' || parsed.command === 'prompt-project-path';
   const isContextOnly = parsed.command === 'context';
   const isVersionOnly = parsed.command === 'version';
@@ -27,7 +29,7 @@ export async function main(argv = process.argv.slice(2)) {
   }
 
   if (parsed.help || !argv.length) {
-    printHelp();
+    printHelp(platformMode);
     return;
   }
 
@@ -91,5 +93,5 @@ export async function main(argv = process.argv.slice(2)) {
     return;
   }
 
-  printHelp();
+  printHelp(platformMode);
 }

package/src/commands/android-shell.js

@@ -197,18 +197,50 @@ function buildLinuxShellRc({ aliases, root, label, shellName }) {
     return [
       ...commonLines,
       '[[ -f "$HOME/.zshrc" ]] && source "$HOME/.zshrc"',
+      '_dex_linux_project_root_zsh() {',
+      '  local helper',
+      '  helper="$(command -v dex-project-context 2>/dev/null)"',
+      '  [[ -z "$helper" ]] && return',
+      '  "$helper" --root 2>/dev/null',
+      '}',
+      '_dex_linux_project_path_zsh() {',
+      '  local helper',
+      '  helper="$(command -v dex-project-context 2>/dev/null)"',
+      '  [[ -z "$helper" ]] && return',
+      '  "$helper" --path 2>/dev/null',
+      '}',
       '_dex_linux_project_badge_zsh() {',
-      '  local dex_bin context',
-      '  dex_bin="$(command -v dex 2>/dev/null)"',
-      '  [[ -z "$dex_bin" ]] && return',
-      '  context="$($dex_bin --prompt-context 2>/dev/null)"',
+      '  local helper context',
+      '  helper="$(command -v dex-project-context 2>/dev/null)"',
+      '  [[ -z "$helper" ]] && return',
+      '  context="$("$helper" 2>/dev/null)"',
       '  [[ -z "$context" ]] && return',
       '  print -n "%F{81}[$context]%f"',
       '}',
+      '_dex_linux_path_label_zsh() {',
+      '  local project_name project_path current relative',
+      '  project_name="$(_dex_linux_project_root_zsh)"',
+      '  project_path="$(_dex_linux_project_path_zsh)"',
+      '  current="$PWD"',
+      '  if [[ -n "$project_name" && -n "$project_path" ]]; then',
+      '    project_name="${project_name##*/}"',
+      '    if [[ "$current" == "$project_path" ]]; then',
+      '      print -r -- "$project_name"',
+      '      return',
+      '    fi',
+      '    relative="${current#$project_path/}"',
+      '    if [[ "$relative" != "$current" ]]; then',
+      '      print -r -- "$project_name/$relative"',
+      '      return',
+      '    fi',
+      '  fi',
+      '  print -r -- "%~"',
+      '}',
       '_dex_linux_prompt_zsh() {',
-      '  local badge',
+      '  local badge path_label',
       '  badge="$(_dex_linux_project_badge_zsh)"',
-      "  PROMPT=$'%F{45}Dex@linux%f %F{117}%~%f\\n%F{45}>%f '",
+      '  path_label="$(_dex_linux_path_label_zsh)"',
+      "  PROMPT=$'%F{45}Dex@linux%f %F{117}'\"${path_label}\"$'%f\\n%F{45}>%f '",
       '  RPROMPT="$badge"',
       '}',
       'autoload -Uz add-zsh-hook 2>/dev/null || true',
@@ -221,18 +253,50 @@ function buildLinuxShellRc({ aliases, root, label, shellName }) {
   if (shellName === 'bash') {
     return [
       ...commonLines,
+      '_dex_linux_project_root_bash() {',
+      '  local helper',
+      '  helper="$(command -v dex-project-context 2>/dev/null)"',
+      '  [[ -z "$helper" ]] && return',
+      '  "$helper" --root 2>/dev/null',
+      '}',
+      '_dex_linux_project_path_bash() {',
+      '  local helper',
+      '  helper="$(command -v dex-project-context 2>/dev/null)"',
+      '  [[ -z "$helper" ]] && return',
+      '  "$helper" --path 2>/dev/null',
+      '}',
       '_dex_linux_project_badge_bash() {',
-      '  local dex_bin context',
-      '  dex_bin="$(command -v dex 2>/dev/null)"',
-      '  [[ -z "$dex_bin" ]] && return',
-      '  context="$($dex_bin --prompt-context 2>/dev/null)"',
+      '  local helper context',
+      '  helper="$(command -v dex-project-context 2>/dev/null)"',
+      '  [[ -z "$helper" ]] && return',
+      '  context="$("$helper" 2>/dev/null)"',
       '  [[ -z "$context" ]] && return',
       '  printf "\\[\\e[38;5;81m\\][%s]\\[\\e[0m\\]" "$context"',
       '}',
+      '_dex_linux_path_label_bash() {',
+      '  local project_name project_path current relative',
+      '  project_name="$(_dex_linux_project_root_bash)"',
+      '  project_path="$(_dex_linux_project_path_bash)"',
+      '  current="$PWD"',
+      '  if [[ -n "$project_name" && -n "$project_path" ]]; then',
+      '    project_name="${project_name##*/}"',
+      '    if [[ "$current" == "$project_path" ]]; then',
+      '      printf "%s" "$project_name"',
+      '      return',
+      '    fi',
+      '    relative="${current#$project_path/}"',
+      '    if [[ "$relative" != "$current" ]]; then',
+      '      printf "%s/%s" "$project_name" "$relative"',
+      '      return',
+      '    fi',
+      '  fi',
+      '  printf "%s" "\\w"',
+      '}',
       '_dex_linux_prompt_bash() {',
-      '  local badge',
+      '  local badge path_label',
       '  badge="$(_dex_linux_project_badge_bash)"',
-      '  PS1="\\[\\e[38;5;45m\\]Dex@linux\\[\\e[0m\\] \\[\\e[38;5;117m\\]\\w\\[\\e[0m\\] ${badge}\\n\\[\\e[38;5;45m\\]>\\[\\e[0m\\] "',
+      '  path_label="$(_dex_linux_path_label_bash)"',
+      '  PS1="\\[\\e[38;5;45m\\]Dex@linux\\[\\e[0m\\] \\[\\e[38;5;117m\\]${path_label}\\[\\e[0m\\] ${badge}\\n\\[\\e[38;5;45m\\]>\\[\\e[0m\\] "',
       '}',
       'PROMPT_COMMAND=_dex_linux_prompt_bash',
       '_dex_linux_prompt_bash',

package/src/commands/menu.js

@@ -27,7 +27,8 @@ export async function runMenuCommand() {
     const action = await chooseMenuAction();
 
     if (action === 'help') {
-      printHelp();
+      const config = await loadUserConfig();
+      printHelp(resolvePlatformMode(config));
       return;
     }
 

package/src/core/scopes.js

@@ -30,6 +30,16 @@ export function getScopeOptions(platformMode) {
       root: getAndroidStorageRoot(platformMode),
       description: 'Busca dentro del almacenamiento compartido accesible.',
     });
+  } else {
+    const sharedRoot = getAndroidStorageRoot(platformMode);
+    if (sharedRoot) {
+      options.push({
+        key: 'shared',
+        label: 'Almacenamiento compartido',
+        root: sharedRoot,
+        description: 'Busca dentro del almacenamiento compartido montado en Linux.',
+      });
+    }
   }
 
   return options;

package/src/ui/output.js

@@ -1,5 +1,7 @@
 import path from 'node:path';
 import { getUserConfigPath } from '../core/config.js';
+import { getScopeOptions } from '../core/scopes.js';
+import { isHostTermux } from '../utils/platform.js';
 
 const ANSI = {
   bold: '\x1b[1m',
@@ -9,7 +11,7 @@ const ANSI = {
   reset: '\x1b[0m',
 };
 
-export function printHelp() {
+export function printHelp(platformMode = '') {
   printBanner();
   console.log('');
   console.log('  Explorar, entender y preparar proyectos desde Termux o Linux.');
@@ -37,11 +39,8 @@ export function printHelp() {
     'dex --prompt-project-path',
   ]);
 
-  printBlock('Scopes', [
-    'actual              carpeta donde estas parado',
-    'home                tu HOME del entorno actual',
-    'android             almacenamiento accesible en modo Termux',
-  ]);
+  const scopeOptions = getScopeOptions(platformMode || (isHostTermux() ? 'termux' : 'linux'));
+  printBlock('Scopes', scopeOptions.map((option) => `${option.key.padEnd(19, ' ')}${option.description}`));
 
   printBlock('Atajos', [
     '-h --help           ayuda',

package/src/utils/platform.js

@@ -1,12 +1,31 @@
+import fs from 'node:fs';
 import path from 'node:path';
 
 const TERMUX_HOME = '/data/data/com.termux/files/home';
 const ANDROID_STORAGE = '/sdcard';
+const SHARED_STORAGE_CANDIDATES = [
+  '/storage/emulated/0',
+  '/sdcard',
+];
 
 export function getHomeDirectory() {
   return process.env.HOME || TERMUX_HOME;
 }
 
+export function getSharedStorageRoot() {
+  for (const candidate of SHARED_STORAGE_CANDIDATES) {
+    try {
+      if (fs.existsSync(candidate)) {
+        return candidate;
+      }
+    } catch {
+      // ignore
+    }
+  }
+
+  return '';
+}
+
 export function isHostTermux() {
   const home = getHomeDirectory();
   return Boolean(process.env.TERMUX_VERSION) || home === TERMUX_HOME || home.startsWith(TERMUX_HOME + path.sep);
@@ -53,11 +72,21 @@ export function canUseAndroidFeatures(platformMode) {
 }
 
 export function getAndroidStorageRoot(platformMode) {
-  return canUseAndroidFeatures(platformMode) ? ANDROID_STORAGE : '';
+  if (canUseAndroidFeatures(platformMode)) {
+    return ANDROID_STORAGE;
+  }
+
+  return getSharedStorageRoot();
 }
 
 export function getQuickAccessRoot(platformMode) {
-  return platformMode === 'termux' ? ANDROID_STORAGE : getHomeDirectory();
+  const sharedStorage = getSharedStorageRoot();
+
+  if (platformMode === 'termux') {
+    return sharedStorage || ANDROID_STORAGE;
+  }
+
+  return sharedStorage || getHomeDirectory();
 }
 
 export function getQuickAccessTitle(platformMode) {
@@ -71,13 +100,17 @@ export function getQuickAccessModeDescription(platformMode) {
 }
 
 export function getQuickAccessLabel(platformMode) {
-  return platformMode === 'termux' ? 'ANDROID STORAGE' : 'LINUX HOME';
+  if (platformMode === 'termux') {
+    return 'ANDROID STORAGE';
+  }
+
+  return getSharedStorageRoot() ? 'SHARED STORAGE' : 'LINUX HOME';
 }
 
 export function getQuickAccessShortcutSummary(platformMode) {
   return platformMode === 'termux'
     ? 'dl, docs, dcim, pics, music, movies, shared'
-    : 'home, dl, docs, desk, pics, music, vids, tmp, shared';
+    : 'shared, home, dl, docs, desk, pics, music, vids, tmp';
 }
 
 export function getQuickAccessAliases(platformMode) {
@@ -94,15 +127,16 @@ export function getQuickAccessAliases(platformMode) {
   }
 
   const home = getHomeDirectory();
+  const shared = getSharedStorageRoot() || home;
   return {
     home,
-    shared: home,
-    dl: path.join(home, 'Downloads'),
-    docs: path.join(home, 'Documents'),
+    shared,
+    dl: path.join(shared, 'Download'),
+    docs: path.join(shared, 'Documents'),
     desk: path.join(home, 'Desktop'),
-    pics: path.join(home, 'Pictures'),
-    music: path.join(home, 'Music'),
-    vids: path.join(home, 'Videos'),
+    pics: path.join(shared, 'Pictures'),
+    music: path.join(shared, 'Music'),
+    vids: path.join(shared, 'Movies'),
     tmp: '/tmp',
   };
 }

package/src/utils/project-context.js

@@ -24,6 +24,8 @@ const LANGUAGE_META = {
 };
 
 const MAX_PARENT_LOOKUP = 16;
+const MAX_IMPLICIT_SCAN_DEPTH = 3;
+const MAX_IMPLICIT_SCAN_ENTRIES = 160;
 
 export async function detectProjectContext(cwd = process.cwd()) {
   const searchChain = buildSearchChain(cwd);
@@ -136,7 +138,7 @@ async function detectProjectContextAt(targetDir, cwd) {
     return createContext('ruby', cwd, targetDir, await detectRubyVersion(targetDir), 'implicit');
   }
 
-  const nestedImplicitType = await detectImplicitLanguageFromChildren(targetDir, entries);
+  const nestedImplicitType = await detectImplicitLanguageFromTree(targetDir);
   if (nestedImplicitType) {
     return createContext(nestedImplicitType, cwd, targetDir, await detectVersionForType(nestedImplicitType, targetDir), 'implicit');
   }
@@ -144,51 +146,60 @@ async function detectProjectContextAt(targetDir, cwd) {
   return null;
 }
 
-async function detectImplicitLanguageFromChildren(targetDir, entries) {
-  const childDirectories = entries
-    .filter((entry) => entry.isDirectory())
-    .slice(0, 8);
+async function detectImplicitLanguageFromTree(rootDir) {
+  const queue = [{ dir: rootDir, depth: 0 }];
+  let visitedEntries = 0;
 
-  for (const entry of childDirectories) {
-    const nestedEntries = await safeReadDir(path.join(targetDir, entry.name));
+  while (queue.length && visitedEntries < MAX_IMPLICIT_SCAN_ENTRIES) {
+    const current = queue.shift();
+    const nestedEntries = await safeReadDir(current.dir);
     if (!nestedEntries.length) {
       continue;
     }
 
-    if (nestedEntries.some((item) => !item.isDirectory() && item.name.endsWith('.py'))) {
-      return 'python';
-    }
+    for (const item of nestedEntries) {
+      visitedEntries += 1;
 
-    if (nestedEntries.some((item) => !item.isDirectory() && isNodeScript(item.name))) {
-      return 'node';
-    }
+      if (!item.isDirectory()) {
+        if (item.name.endsWith('.py')) {
+          return 'python';
+        }
 
-    if (nestedEntries.some((item) => !item.isDirectory() && item.name.endsWith('.php'))) {
-      return 'php';
-    }
+        if (isNodeScript(item.name)) {
+          return 'node';
+        }
 
-    if (nestedEntries.some((item) => !item.isDirectory() && item.name.endsWith('.rb'))) {
-      return 'ruby';
-    }
-  }
+        if (item.name.endsWith('.php')) {
+          return 'php';
+        }
 
-  return '';
-}
+        if (item.name.endsWith('.rb')) {
+          return 'ruby';
+        }
 
-function pickBestDetection(detections) {
-  let bestMatch = detections[0];
+        continue;
+      }
 
-  for (let index = 1; index < detections.length; index += 1) {
-    const current = detections[index];
+      if (current.depth + 1 > MAX_IMPLICIT_SCAN_DEPTH) {
+        continue;
+      }
 
-    if (current.type !== bestMatch.type) {
-      break;
-    }
+      if (shouldSkipImplicitDirectory(item.name)) {
+        continue;
+      }
 
-    bestMatch = current;
+      queue.push({
+        dir: path.join(current.dir, item.name),
+        depth: current.depth + 1,
+      });
+    }
   }
 
-  return bestMatch;
+  return '';
+}
+
+function pickBestDetection(detections) {
+  return detections[0];
 }
 
 function createContext(type, cwd, projectRoot, version, detectionKind) {
@@ -402,3 +413,17 @@ function firstNonEmptyLine(content) {
 function isNodeScript(name) {
   return name.endsWith('.js') || name.endsWith('.mjs') || name.endsWith('.cjs') || name.endsWith('.ts');
 }
+
+function shouldSkipImplicitDirectory(name) {
+  return [
+    '.git',
+    '.venv',
+    'node_modules',
+    '__pycache__',
+    '.mypy_cache',
+    '.pytest_cache',
+    '.ruff_cache',
+    'dist',
+    'build',
+  ].includes(name);
+}