@mmmbuto/nexuscli 0.5.0

package/lib/setup/postinstall.js

@@ -0,0 +1,216 @@
+#!/usr/bin/env node
+/**
+ * NexusCLI Post-Install Script
+ * Termux-only: auto-run wizard if not configured
+ */
+
+const { execSync, spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+// Check if running in Termux
+const isTermux =
+  process.env.PREFIX?.includes('com.termux') ||
+  fs.existsSync('/data/data/com.termux') ||
+  process.env.TERMUX_VERSION !== undefined;
+
+// ANSI colors (chalk-free for postinstall)
+const colors = {
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+  bold: (s) => `\x1b[1m${s}\x1b[0m`,
+  gray: (s) => `\x1b[90m${s}\x1b[0m`
+};
+
+function log(msg) {
+  console.log(msg);
+}
+
+function success(msg) {
+  console.log(colors.green(`  ✓ ${msg}`));
+}
+
+function warn(msg) {
+  console.log(colors.yellow(`  ⚠ ${msg}`));
+}
+
+function error(msg) {
+  console.log(colors.red(`  ✗ ${msg}`));
+}
+
+/**
+ * Check if NexusCLI is already configured
+ */
+function isConfigured() {
+  const configPath = path.join(process.env.HOME || '', '.nexuscli', 'config.json');
+  return fs.existsSync(configPath);
+}
+
+/**
+ * Run the setup wizard
+ */
+function runWizard() {
+  return new Promise((resolve, reject) => {
+    // Find nexuscli binary
+    let nexuscliPath;
+    try {
+      nexuscliPath = execSync('which nexuscli', { encoding: 'utf8' }).trim();
+    } catch {
+      // Fallback to relative path
+      nexuscliPath = path.join(__dirname, '..', '..', 'bin', 'nexuscli.js');
+    }
+
+    console.log('');
+    console.log(colors.cyan('Running setup wizard...'));
+    console.log('');
+
+    const child = spawn('node', [nexuscliPath, 'init'], {
+      stdio: 'inherit'
+    });
+
+    child.on('close', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`Wizard exited with code ${code}`));
+      }
+    });
+
+    child.on('error', (err) => {
+      reject(err);
+    });
+  });
+}
+
+function installPackage(pkg) {
+  try {
+    // Check if already installed
+    try {
+      execSync(`which ${pkg}`, { stdio: 'ignore' });
+      success(`${pkg} already installed`);
+      return true;
+    } catch {
+      // Not installed, proceed
+    }
+
+    log(`  Installing ${pkg}...`);
+    execSync(`pkg install -y ${pkg}`, { stdio: 'inherit' });
+    success(`${pkg} installed`);
+    return true;
+  } catch (err) {
+    warn(`${pkg} installation failed (may need manual install)`);
+    return false;
+  }
+}
+
+async function main() {
+  console.log('');
+
+  // ============================================
+  // TERMUX CHECK - CRITICAL
+  // ============================================
+  if (!isTermux) {
+    console.log(colors.bold('╔═══════════════════════════════════════════════════╗'));
+    console.log(colors.bold('║  ') + colors.red('NOT COMPATIBLE') + colors.bold('                                ║'));
+    console.log(colors.bold('╚═══════════════════════════════════════════════════╝'));
+    console.log('');
+    console.log(colors.yellow('  NexusCLI is designed for Termux on Android only.'));
+    console.log(colors.yellow('  Linux/macOS/Windows support is not available in this version.'));
+    console.log('');
+    console.log(colors.gray('  For more information: https://npmjs.com/package/@mmmbuto/nexuscli'));
+    console.log('');
+    process.exit(1);
+  }
+
+  // ============================================
+  // TERMUX INSTALLATION
+  // ============================================
+  console.log(colors.bold('╔═══════════════════════════════════════════════════╗'));
+  console.log(colors.bold('║  📱 NexusCLI TRI CLI v0.4.0                       ║'));
+  console.log(colors.bold('║     Claude • Codex • Gemini                       ║'));
+  console.log(colors.bold('╚═══════════════════════════════════════════════════╝'));
+  console.log('');
+
+  // Required packages
+  const packages = ['termux-api', 'termux-tools'];
+
+  log(colors.cyan('Installing Termux packages:'));
+  for (const pkg of packages) {
+    installPackage(pkg);
+  }
+  console.log('');
+
+  // Create directories
+  const HOME = process.env.HOME;
+  const dirs = [
+    path.join(HOME, '.nexuscli'),
+    path.join(HOME, '.nexuscli', 'data'),
+    path.join(HOME, '.nexuscli', 'logs'),
+    path.join(HOME, '.nexuscli', 'engines'),
+    path.join(HOME, '.termux', 'boot')
+  ];
+
+  log(colors.cyan('Creating directories:'));
+  for (const dir of dirs) {
+    try {
+      fs.mkdirSync(dir, { recursive: true });
+      success(dir.replace(HOME, '~'));
+    } catch (err) {
+      warn(`Failed to create ${dir}`);
+    }
+  }
+  console.log('');
+
+  // Check Termux:API app
+  log(colors.cyan('Checking Termux apps:'));
+  try {
+    execSync('termux-battery-status', { timeout: 5000, stdio: 'ignore' });
+    success('Termux:API app working');
+  } catch {
+    warn('Termux:API app not detected');
+    console.log('      Install from F-Droid for notifications & wake-lock');
+  }
+  console.log('');
+
+  // ============================================
+  // AUTO-RUN WIZARD IF NOT CONFIGURED
+  // ============================================
+  if (!isConfigured()) {
+    console.log(colors.bold('╔═══════════════════════════════════════════════════╗'));
+    console.log(colors.bold('║  First time setup - Running wizard...             ║'));
+    console.log(colors.bold('╚═══════════════════════════════════════════════════╝'));
+
+    try {
+      await runWizard();
+      console.log('');
+      console.log(colors.green('  ✓ Setup complete!'));
+      console.log('');
+      console.log(`  Run ${colors.cyan('nexuscli start')} to launch the server`);
+      console.log('');
+    } catch (err) {
+      console.log('');
+      warn('Setup wizard failed or was cancelled');
+      console.log(`  Run ${colors.cyan('nexuscli init')} to complete setup manually`);
+      console.log('');
+    }
+  } else {
+    // Already configured
+    console.log(colors.bold('╔═══════════════════════════════════════════════════╗'));
+    console.log(colors.bold('║  ✅ NexusCLI updated!                              ║'));
+    console.log(colors.bold('╚═══════════════════════════════════════════════════╝'));
+    console.log('');
+    console.log(`  Run ${colors.cyan('nexuscli start')} to launch the server`);
+    console.log('');
+    console.log(colors.yellow('  Optional apps (install from F-Droid):'));
+    console.log('    • Termux:API   - notifications & wake-lock');
+    console.log('    • Termux:Boot  - auto-start on device boot');
+    console.log('');
+  }
+}
+
+main().catch(err => {
+  console.error('Postinstall error:', err.message);
+  process.exit(0); // Don't fail npm install
+});

package/lib/utils/paths.js

@@ -0,0 +1,107 @@
+/**
+ * Standard Paths for NexusCLI
+ * Termux Mobile First - all paths relative to $HOME
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const HOME = process.env.HOME || os.homedir();
+
+/**
+ * NexusCLI standard paths
+ */
+const PATHS = {
+  // Main config directory
+  CONFIG_DIR: path.join(HOME, '.nexuscli'),
+
+  // Config file
+  CONFIG_FILE: path.join(HOME, '.nexuscli', 'config.json'),
+
+  // Data directory (database, cache)
+  DATA_DIR: path.join(HOME, '.nexuscli', 'data'),
+
+  // Database file
+  DATABASE: path.join(HOME, '.nexuscli', 'data', 'nexuscli.db'),
+
+  // Logs directory
+  LOGS_DIR: path.join(HOME, '.nexuscli', 'logs'),
+
+  // Server log
+  SERVER_LOG: path.join(HOME, '.nexuscli', 'logs', 'server.log'),
+
+  // PID file for daemon
+  PID_FILE: path.join(HOME, '.nexuscli', 'nexuscli.pid'),
+
+  // Engines config directory
+  ENGINES_DIR: path.join(HOME, '.nexuscli', 'engines'),
+
+  // Termux boot script
+  BOOT_SCRIPT: path.join(HOME, '.termux', 'boot', 'nexuscli-start.sh'),
+
+  // Claude CLI history (read-only)
+  CLAUDE_HISTORY: path.join(HOME, '.claude', 'history.jsonl'),
+  CLAUDE_PROJECTS: path.join(HOME, '.claude', 'projects'),
+
+  // Default workspace
+  DEFAULT_WORKSPACE: path.join(HOME, 'Dev')
+};
+
+/**
+ * Ensure all required directories exist
+ */
+function ensureDirectories() {
+  const dirs = [
+    PATHS.CONFIG_DIR,
+    PATHS.DATA_DIR,
+    PATHS.LOGS_DIR,
+    PATHS.ENGINES_DIR
+  ];
+
+  for (const dir of dirs) {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+  }
+}
+
+/**
+ * Ensure Termux boot directory exists
+ */
+function ensureBootDirectory() {
+  const bootDir = path.join(HOME, '.termux', 'boot');
+  if (!fs.existsSync(bootDir)) {
+    fs.mkdirSync(bootDir, { recursive: true });
+  }
+  return bootDir;
+}
+
+/**
+ * Get path resolving ~ to HOME
+ */
+function resolvePath(p) {
+  if (p.startsWith('~')) {
+    return path.join(HOME, p.slice(1));
+  }
+  return path.resolve(p);
+}
+
+/**
+ * Get relative path from HOME (for display)
+ */
+function toDisplayPath(p) {
+  if (p.startsWith(HOME)) {
+    return '~' + p.slice(HOME.length);
+  }
+  return p;
+}
+
+module.exports = {
+  PATHS,
+  HOME,
+  ensureDirectories,
+  ensureBootDirectory,
+  resolvePath,
+  toDisplayPath
+};

package/lib/utils/termux.js

@@ -0,0 +1,145 @@
+/**
+ * Termux Detection and Utilities
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync, spawn } = require('child_process');
+
+/**
+ * Check if running in Termux environment
+ */
+function isTermux() {
+  return (
+    process.env.PREFIX?.includes('com.termux') ||
+    fs.existsSync('/data/data/com.termux') ||
+    process.env.TERMUX_VERSION !== undefined
+  );
+}
+
+/**
+ * Get Termux prefix path
+ */
+function getPrefix() {
+  return process.env.PREFIX || '/data/data/com.termux/files/usr';
+}
+
+/**
+ * Check if a Termux package is installed
+ */
+function isPackageInstalled(pkg) {
+  try {
+    execSync(`which ${pkg}`, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Install a Termux package
+ */
+function installPackage(pkg) {
+  try {
+    execSync(`pkg install -y ${pkg}`, { stdio: 'inherit' });
+    return true;
+  } catch (error) {
+    return false;
+  }
+}
+
+/**
+ * Check if Termux:API app is working
+ */
+function isTermuxApiWorking() {
+  try {
+    execSync('termux-battery-status', { timeout: 5000, stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check if Termux:Boot is available
+ */
+function isTermuxBootAvailable() {
+  const bootDir = path.join(process.env.HOME, '.termux', 'boot');
+  return fs.existsSync(bootDir);
+}
+
+/**
+ * Acquire Termux wake lock
+ */
+function acquireWakeLock() {
+  if (!isTermux()) return false;
+  try {
+    spawn('termux-wake-lock', [], { detached: true, stdio: 'ignore' }).unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Release Termux wake lock
+ */
+function releaseWakeLock() {
+  if (!isTermux()) return false;
+  try {
+    spawn('termux-wake-unlock', [], { detached: true, stdio: 'ignore' }).unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Send Termux notification
+ */
+function sendNotification(title, content, id = 'nexuscli') {
+  if (!isTermux()) return false;
+  try {
+    execSync(`termux-notification --id ${id} --title "${title}" --content "${content}"`, {
+      stdio: 'ignore'
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get required Termux packages
+ */
+function getRequiredPackages() {
+  return ['termux-api', 'termux-tools'];
+}
+
+/**
+ * Check all required packages
+ */
+function checkRequiredPackages() {
+  const packages = getRequiredPackages();
+  const status = {};
+
+  for (const pkg of packages) {
+    status[pkg] = isPackageInstalled(pkg);
+  }
+
+  return status;
+}
+
+module.exports = {
+  isTermux,
+  getPrefix,
+  isPackageInstalled,
+  installPackage,
+  isTermuxApiWorking,
+  isTermuxBootAvailable,
+  acquireWakeLock,
+  releaseWakeLock,
+  sendNotification,
+  getRequiredPackages,
+  checkRequiredPackages
+};

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@mmmbuto/nexuscli",
+  "version": "0.5.0",
+  "private": false,
+  "description": "Mobile-first AI Control Plane - Web UI for Claude/Codex/Gemini CLI",
+  "main": "lib/server/server.js",
+  "bin": {
+    "nexuscli": "./bin/nexuscli.js"
+  },
+  "scripts": {
+    "start": "node lib/server/server.js",
+    "dev": "node lib/server/server.js",
+    "postinstall": "node lib/setup/postinstall.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "build:frontend": "cd frontend && npm run build"
+  },
+  "keywords": [
+    "nexuscli",
+    "termux",
+    "cli",
+    "ai",
+    "claude",
+    "codex",
+    "gemini",
+    "control-plane",
+    "mobile-first",
+    "android"
+  ],
+  "author": "DioNanos",
+  "license": "MIT",
+  "homepage": "https://github.com/DioNanos/nexuscli",
+  "bugs": {
+    "url": "https://github.com/DioNanos/nexuscli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DioNanos/nexuscli.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "frontend/dist/",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "linux",
+    "android"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "dependencies": {
+    "bcryptjs": "^3.0.3",
+    "chalk": "^4.1.2",
+    "commander": "^12.1.0",
+    "cors": "^2.8.5",
+    "express": "^4.18.2",
+    "express-rate-limit": "^8.2.1",
+    "inquirer": "^8.2.6",
+    "jsonwebtoken": "^9.0.2",
+    "multer": "^2.0.2",
+    "node-cache": "^5.1.2",
+    "ora": "^5.4.1",
+    "sql.js": "^1.13.0",
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0"
+  }
+}