@mmmbuto/nexuscli 0.9.11 → 0.9.12

package/CHANGELOG.md

@@ -2,14 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.9.10] - 2026-01-09
+## [0.9.12] - 2026-01-09
 ### Fixed
-- Added PTY dependency check in postinstall to verify node-pty installation
-- Added pty-termux-utils verification to ensure .cjs files are built
-- Platform detection now installs correct PTY provider:
-  - `@mmmbuto/node-pty-android-arm64` for Termux
-  - `@lydell/node-pty-linux-arm64` for Linux ARM64
-- Provides helpful error messages when PTY dependencies are missing
+- Guard PTY utils loading to avoid hard crash when dependency is broken or missing
+- Safer fallback adapter when native PTY stack is unavailable
+- Updated @mmmbuto/pty-termux-utils to ^1.1.3
+
 ## [0.9.11] - 2026-01-09
 ### Fixed
 - Added PTY dependency verification in postinstall
@@ -18,6 +16,14 @@ All notable changes to this project will be documented in this file.
 - All PTY dependencies now verified during npm install
 - Updated @mmmbuto/pty-termux-utils to ^1.1.2
 
+## [0.9.10] - 2026-01-09
+### Fixed
+- Added PTY dependency check in postinstall to verify node-pty installation
+- Added pty-termux-utils verification to ensure .cjs files are built
+- Platform detection now installs correct PTY provider:
+  - `@mmmbuto/node-pty-android-arm64` for Termux
+  - `@lydell/node-pty-linux-arm64` for Linux ARM64
+- Provides helpful error messages when PTY dependencies are missing
 
 
 ## [0.9.9] - 2026-01-01

package/README.md

@@ -1,20 +1,15 @@
-# NexusCLI — AI Terminal Cockpit
-
-<p align="center">
-  <img src=".github/header/header.png" width="900" />
-</p>
-
----
+## Overview
 
-[![npm](https://img.shields.io/npm/v/@mmmbuto/nexuscli?style=flat-square&logo=npm)](https://www.npmjs.com/package/@mmmbuto/nexuscli)
-[![downloads](https://img.shields.io/npm/dt/@mmmbuto/nexuscli?style=flat-square)](https://www.npmjs.com/package/@mmmbuto/nexuscli)
-[![ko-fi](https://img.shields.io/badge/☕_Support-Ko--fi-FF5E5B?style=flat-square&logo=ko-fi)](https://ko-fi.com/dionanos)
+NexusCLI is a lightweight, Termux-first AI cockpit that orchestrates Claude Code, Codex CLI, Gemini CLI, and Qwen Code CLI from a single web/terminal UI. It supports live streaming, interrupts, session resume, workspace isolation, and remote voice input with auto HTTPS setup.
 
 ---
 
-## Overview
+## Screenshots
 
-NexusCLI is a lightweight, Termux-first AI cockpit that orchestrates Claude Code, Codex CLI, Gemini CLI, and Qwen Code CLI from a single web/terminal UI. It supports live streaming, interrupts, session resume, workspace isolation, and remote voice input with auto HTTPS setup.
+<p align="center">
+  <img src="docs/assets/screenshots/nexuscli-multilang-preview.png" width="45%" />
+  <img src="docs/assets/screenshots/nexuscli-mobile-glm.png" width="45%" />
+</p>
 
 ---
 
@@ -46,20 +41,11 @@ NexusCLI is a lightweight, Termux-first AI cockpit that orchestrates Claude Code
 
 ---
 
-## Screenshots
-
-<p align="center">
-  <img src="docs/assets/screenshots/nexuscli-multilang-preview.png" width="45%" />
-  <img src="docs/assets/screenshots/nexuscli-mobile-glm.png" width="45%" />
-</p>
-
----
-
 ## Install
 
 ```bash
 # From npm
-npm install -g @mmmbuto/nexuscli
+npm install -g @mmmbuto/nexuscli@0.9.12
 
 # From GitHub
 npm install -g github:DioNanos/nexuscli
@@ -69,7 +55,7 @@ npm install -g github:DioNanos/nexuscli
 
 ```bash
 # Latest (default)
-npm install -g @mmmbuto/nexuscli
+npm install -g @mmmbuto/nexuscli@0.9.12
 
 # Stable channel (pinned)
 npm install -g @mmmbuto/nexuscli@stable

package/lib/server/lib/getPty.js

@@ -10,7 +10,10 @@
  * @version 1.1.0
  */
 
-const { getPty: getSharedPty, logDebug } = require('@mmmbuto/pty-termux-utils');
+const { getPtyFn, getLogDebugFn } = require('./pty-utils-loader');
+
+const getSharedPty = getPtyFn();
+const logDebug = getLogDebugFn();
 const tryRequire = (moduleName) => {
   try {
     require(moduleName);

package/lib/server/lib/pty-adapter.js

@@ -6,7 +6,9 @@
  * @version 1.0.0
  */
 
-const { createFallbackAdapter } = require('@mmmbuto/pty-termux-utils');
+const { getPtyFn, getFallbackAdapter } = require('./pty-utils-loader');
+
+const getSharedPty = getPtyFn();
 const tryRequire = (moduleName) => {
   try {
     require(moduleName);
@@ -17,7 +19,7 @@ const tryRequire = (moduleName) => {
 };
 
 // Create shared fallback adapter (always uses child_process)
-const fallbackAdapter = createFallbackAdapter();
+const fallbackAdapter = getFallbackAdapter();
 
 // Cache for native PTY (sync access)
 let cachedNativePty = null;
@@ -31,8 +33,7 @@ async function initNativePty() {
   }
   
   try {
-    const { getPty } = require('@mmmbuto/pty-termux-utils');
-    cachedNativePty = await getPty();
+    cachedNativePty = await getSharedPty();
     return cachedNativePty;
   } catch (e) {
     cachedNativePty = false; // Error loading

package/lib/server/lib/pty-provider.js

@@ -6,7 +6,14 @@
  * @version 1.0.0
  */
 
-const { getPty: getSharedPty, createFallbackAdapter } = require('@mmmbuto/pty-termux-utils');
+const {
+  getPtyFn,
+  getSpawnPtyFn,
+  getFallbackAdapter: getSafeFallbackAdapter
+} = require('./pty-utils-loader');
+
+const getSharedPty = getPtyFn();
+const spawnPty = getSpawnPtyFn();
 const tryRequire = (moduleName) => {
   try {
     require(moduleName);
@@ -33,7 +40,7 @@ async function getPty() {
  * @returns {Object} Adapter with spawn method
  */
 function getFallbackAdapter() {
-  return createFallbackAdapter();
+  return getSafeFallbackAdapter();
 }
 
 /**
@@ -52,5 +59,5 @@ module.exports = {
   getFallbackAdapter,
   isPtyAvailable,
   // Re-export from shared library
-  spawnPty: require('@mmmbuto/pty-termux-utils').spawnPty,
+  spawnPty,
 };

package/lib/server/lib/pty-utils-loader.js

@@ -0,0 +1,136 @@
+/**
+ * Safe loader for @mmmbuto/pty-termux-utils with fallback adapter.
+ * Prevents hard crashes if the dependency is missing or broken.
+ */
+
+const { spawn } = require('child_process');
+
+let cachedUtils;
+let warned = false;
+
+function warnOnce(error) {
+  if (warned) return;
+  warned = true;
+  const message = error && error.message ? error.message : String(error);
+  console.warn('[PTY] Failed to load @mmmbuto/pty-termux-utils. Using fallback adapter.');
+  console.warn(`[PTY] Reason: ${message}`);
+}
+
+function loadPtyUtils() {
+  if (cachedUtils !== undefined) return cachedUtils;
+  try {
+    cachedUtils = require('@mmmbuto/pty-termux-utils');
+  } catch (err) {
+    warnOnce(err);
+    cachedUtils = null;
+  }
+  return cachedUtils;
+}
+
+function ensurePtyInterface(proc) {
+  if (!proc) return proc;
+  if (typeof proc.onData === 'function' && typeof proc.onExit === 'function') {
+    return proc;
+  }
+
+  const hasChildStd = !!(proc.stdout || proc.stderr);
+  const dataHandlers = [];
+  const exitHandlers = [];
+
+  if (typeof proc.on === 'function' && !hasChildStd) {
+    proc.on('data', (data) => {
+      dataHandlers.forEach((fn) => fn(data));
+    });
+    proc.on('exit', (code, signal) => {
+      exitHandlers.forEach((fn) => fn({ exitCode: code, signal }));
+    });
+  } else {
+    proc.stdout?.on('data', (data) => {
+      dataHandlers.forEach((fn) => fn(data.toString()));
+    });
+    proc.stderr?.on('data', (data) => {
+      dataHandlers.forEach((fn) => fn(data.toString()));
+    });
+    proc.on?.('exit', (code, signal) => {
+      exitHandlers.forEach((fn) => fn({ exitCode: code ?? -1, signal }));
+    });
+  }
+
+  proc.onData = (fn) => dataHandlers.push(fn);
+  proc.onExit = (fn) => exitHandlers.push(fn);
+
+  if (typeof proc.onError !== 'function' && typeof proc.on === 'function') {
+    proc.onError = (fn) => proc.on('error', fn);
+  }
+  if (typeof proc.write !== 'function') {
+    proc.write = (data) => proc.stdin?.write(data);
+  }
+  if (typeof proc.sendEsc !== 'function') {
+    proc.sendEsc = () => {
+      if (proc.stdin?.writable) {
+        proc.stdin.write('\x1B');
+        return true;
+      }
+      return false;
+    };
+  }
+  if (typeof proc.resize !== 'function') {
+    proc.resize = () => {};
+  }
+  if (typeof proc.kill !== 'function' && proc.process?.kill) {
+    proc.kill = (signal = 'SIGTERM') => proc.process.kill(signal);
+  }
+  if (proc.pid == null && proc.process?.pid != null) {
+    proc.pid = proc.process.pid;
+  }
+
+  return proc;
+}
+
+function createLocalFallbackAdapter() {
+  return {
+    spawn: (file, args, options = {}) => {
+      const child = spawn(file, args, {
+        cwd: options.cwd,
+        env: options.env ? { ...process.env, ...options.env } : undefined,
+      });
+      return ensurePtyInterface(child);
+    }
+  };
+}
+
+function getPtyFn() {
+  const utils = loadPtyUtils();
+  return utils?.getPty ? utils.getPty : async () => null;
+}
+
+function getSpawnPtyFn() {
+  const utils = loadPtyUtils();
+  return utils?.spawnPty
+    ? utils.spawnPty
+    : async () => { throw new Error('Native PTY utilities unavailable'); };
+}
+
+function getLogDebugFn() {
+  const utils = loadPtyUtils();
+  return utils?.logDebug ? utils.logDebug : () => {};
+}
+
+function getFallbackAdapter() {
+  const utils = loadPtyUtils();
+  if (utils?.createFallbackAdapter) {
+    const base = utils.createFallbackAdapter();
+    return {
+      spawn: (...args) => ensurePtyInterface(base.spawn(...args))
+    };
+  }
+  return createLocalFallbackAdapter();
+}
+
+module.exports = {
+  getPtyFn,
+  getSpawnPtyFn,
+  getLogDebugFn,
+  getFallbackAdapter,
+  ensurePtyInterface
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmmbuto/nexuscli",
-  "version": "0.9.11",
+  "version": "0.9.12",
   "description": "NexusCLI - TRI CLI Control Plane (Claude/Codex/Gemini/Qwen)",
   "main": "lib/server/server.js",
   "bin": {
@@ -59,7 +59,7 @@
     "x64"
   ],
   "dependencies": {
-    "@mmmbuto/pty-termux-utils": "^1.1.2",
+    "@mmmbuto/pty-termux-utils": "^1.1.3",
     "bcryptjs": "^3.0.3",
     "chalk": "^4.1.2",
     "commander": "^12.1.0",
@@ -81,4 +81,4 @@
   "optionalDependencies": {
     "@mmmbuto/node-pty-android-arm64": "~1.1.0"
   }
-}
+}