rl-rockcli 0.0.8 → 0.0.10

package/commands/attach/ink-repl/utils/atCompletion.js

@@ -0,0 +1,346 @@
+/**
+ * @ Trigger File Completion Module
+ * Provides file path auto-completion triggered by @ symbol
+ * 
+ * Supported commands:
+ * - /upload @<local-path> @<remote-path>
+ *   First @ completes local files, second @ completes remote files
+ * 
+ * - /download @<remote-path> @<local-path>
+ *   First @ completes remote files, second @ completes local files
+ */
+
+import fs from 'fs';
+import path from 'path';
+import {
+  hasDangerousShellChars,
+  shellEscapePosix,
+  findFirstUnescapedSpace,
+  escapeSpaces,
+} from './remotePathSafety.js';
+
+/**
+ * Maximum number of completion items to show
+ */
+const MAX_COMPLETIONS = 20;
+
+/**
+ * Parse @ completion context from input buffer
+ * Determines if we're completing local (first @) or remote (second @) path
+ *
+ * @param {string} buffer - Current input buffer
+ * @param {number} cursorPos - Cursor position (defaults to end of buffer)
+ * @returns {Object|null} Context object or null if no @ completion needed
+ */
+export function parseAtContext(buffer, cursorPos = buffer.length) {
+  if (!buffer) {
+    return null;
+  }
+  
+  // Support both /upload and /download commands
+  const isUploadCmd = buffer.startsWith('/upload');
+  const isDownloadCmd = buffer.startsWith('/download');
+  
+  if (!isUploadCmd && !isDownloadCmd) {
+    return null;
+  }
+
+  // Find all @ positions in the buffer
+  const atPositions = [];
+  for (let i = 0; i < buffer.length; i++) {
+    if (buffer[i] === '@') {
+      atPositions.push(i);
+    }
+  }
+
+  if (atPositions.length === 0) {
+    return null;
+  }
+
+  // Find which @ the cursor is in (cursor is after @, before next space or end)
+  let activeAtIndex = -1;
+  let activeAtPosition = -1;
+
+  for (let i = atPositions.length - 1; i >= 0; i--) {
+    const atPos = atPositions[i];
+    if (atPos < cursorPos) {
+      // Check if cursor is still within this @ argument (no space between @ and cursor)
+      const textAfterAt = buffer.substring(atPos + 1, cursorPos);
+      if (findFirstUnescapedSpace(textAfterAt) === -1) {
+        activeAtIndex = i;
+        activeAtPosition = atPos;
+        break;
+      }
+    }
+  }
+
+  if (activeAtIndex === -1) {
+    return null;
+  }
+
+  // Extract partial path after @ (up to cursor position)
+  const afterAt = buffer.substring(activeAtPosition + 1);
+  const spaceIdx = findFirstUnescapedSpace(afterAt);
+
+  // Calculate the end of the current @ argument
+  const argEndInAfterAt = spaceIdx === -1 ? afterAt.length : spaceIdx;
+  const argEndInBuffer = activeAtPosition + 1 + argEndInAfterAt;
+
+  // Partial path is from @ to cursor (or end of argument if cursor is past it)
+  const cursorRelativeToAt = cursorPos - (activeAtPosition + 1);
+  const partialPathEnd = Math.min(cursorRelativeToAt, argEndInAfterAt);
+  const partialPath = afterAt.substring(0, partialPathEnd);
+
+  // For /upload: First @ = local file, second @ = remote file
+  // For /download: First @ = remote file, second @ = local file
+  const isLocal = isUploadCmd ? (activeAtIndex === 0) : (activeAtIndex === 1);
+
+  // Calculate replace range (from @ to end of argument)
+  const replaceStart = activeAtPosition;
+  const replaceEnd = argEndInBuffer;
+
+  return {
+    atIndex: activeAtIndex,
+    atPosition: activeAtPosition,
+    isLocal,
+    partialPath,
+    replaceStart,
+    replaceEnd,
+  };
+}
+
+/**
+ * Fuzzy match filter - checks if query characters appear in order in target
+ * @param {string} target - String to search in
+ * @param {string} query - Query to match
+ * @returns {boolean}
+ */
+export function fuzzyMatch(target, query) {
+  if (!query) return true;
+
+  const lowerTarget = target.toLowerCase();
+  const lowerQuery = query.toLowerCase();
+
+  let queryIdx = 0;
+  for (let i = 0; i < lowerTarget.length && queryIdx < lowerQuery.length; i++) {
+    if (lowerTarget[i] === lowerQuery[queryIdx]) {
+      queryIdx++;
+    }
+  }
+
+  return queryIdx === lowerQuery.length;
+}
+
+/**
+ * Parse directory and file prefix from partial path
+ * @param {string} partialPath - Path like "src/comp" or "test/"
+ * @returns {{ dirPath: string, filePrefix: string }}
+ */
+export function parsePartialPath(partialPath) {
+  if (!partialPath) {
+    return { dirPath: '.', filePrefix: '' };
+  }
+
+  if (partialPath.endsWith('/')) {
+    return { dirPath: partialPath, filePrefix: '' };
+  }
+
+  const lastSlash = partialPath.lastIndexOf('/');
+  if (lastSlash === -1) {
+    return { dirPath: '.', filePrefix: partialPath };
+  }
+
+  return {
+    dirPath: partialPath.substring(0, lastSlash + 1) || '.',
+    filePrefix: partialPath.substring(lastSlash + 1),
+  };
+}
+
+/**
+ * Get local file completions
+ * @param {string} partialPath - Partial path entered after @
+ * @param {string} cwd - Current working directory
+ * @returns {Array<{label: string, value: string, description: string, isDir: boolean}>}
+ */
+export function getLocalCompletions(partialPath, cwd = process.cwd()) {
+  const { dirPath, filePrefix } = parsePartialPath(partialPath);
+
+  // Resolve directory path
+  let resolvedDir;
+  if (path.isAbsolute(dirPath)) {
+    resolvedDir = dirPath;
+  } else if (dirPath === '.') {
+    resolvedDir = cwd;
+  } else {
+    resolvedDir = path.resolve(cwd, dirPath);
+  }
+
+  try {
+    const entries = fs.readdirSync(resolvedDir, { withFileTypes: true });
+
+    const results = [];
+    for (const entry of entries) {
+      const name = entry.name;
+
+      // Skip hidden files unless user typed a dot
+      if (name.startsWith('.') && !filePrefix.startsWith('.')) {
+        continue;
+      }
+
+      // Apply fuzzy filter
+      if (!fuzzyMatch(name, filePrefix)) {
+        continue;
+      }
+
+      const isDir = entry.isDirectory();
+
+      // Skip exact match for files - path is already complete
+      if (!isDir && name === filePrefix) {
+        continue;
+      }
+
+      const displayName = isDir ? `${name}/` : name;
+
+      // Build the full value to replace
+      const valuePath = dirPath === '.'
+        ? (isDir ? `${name}/` : name)
+        : (isDir ? `${dirPath}${name}/` : `${dirPath}${name}`);
+
+      results.push({
+        label: displayName,
+        value: `@${escapeSpaces(valuePath)}`,
+        description: isDir ? 'directory' : 'file',
+        isDir,
+      });
+
+      if (results.length >= MAX_COMPLETIONS) {
+        break;
+      }
+    }
+
+    // Sort: directories first, then alphabetically
+    results.sort((a, b) => {
+      if (a.isDir !== b.isDir) {
+        return a.isDir ? -1 : 1;
+      }
+      return a.label.localeCompare(b.label);
+    });
+
+    return results;
+  } catch (err) {
+    // Directory doesn't exist or not readable
+    return [];
+  }
+}
+
+/**
+ * Get remote file completions from sandbox
+ * @param {Object} sessionManager - Session manager for sandbox communication
+ * @param {string} partialPath - Partial path entered after @
+ * @returns {Promise<Array<{label: string, value: string, description: string, isDir: boolean}>>}
+ */
+export async function getRemoteCompletions(sessionManager, partialPath, options = {}) {
+  const signal = options && options.signal ? options.signal : null;
+  if (!sessionManager) {
+    return [];
+  }
+
+  if (signal?.aborted) {
+    return [];
+  }
+
+  if (hasDangerousShellChars(partialPath)) {
+    return [];
+  }
+
+  const { dirPath, filePrefix } = parsePartialPath(partialPath);
+
+  // Use absolute path for remote, default to /
+  const remoteDirPath = dirPath === '.' ? '/' : dirPath;
+
+  try {
+    // Use ls -1Ap to get files with / suffix for directories
+    const result = await sessionManager.execute(`ls -1Ap -- ${shellEscapePosix(remoteDirPath)} 2>/dev/null`);
+
+    if (signal?.aborted) {
+      return [];
+    }
+
+    if (!result.output) {
+      return [];
+    }
+
+    const entries = result.output
+      .split(/[\r\n]+/)
+      .filter(f => f.trim())
+      .slice(0, 100)
+      .map(name => ({
+        name: name.endsWith('/') ? name.slice(0, -1) : name,
+        isDir: name.endsWith('/'),
+      }));
+
+    const results = [];
+    for (const entry of entries) {
+      const name = entry.name;
+
+      // Skip hidden files unless user typed a dot
+      if (name.startsWith('.') && !filePrefix.startsWith('.')) {
+        continue;
+      }
+
+      // Apply fuzzy filter
+      if (!fuzzyMatch(name, filePrefix)) {
+        continue;
+      }
+
+      // Skip exact match for files - path is already complete
+      if (!entry.isDir && name === filePrefix) {
+        continue;
+      }
+
+      const displayName = entry.isDir ? `${name}/` : name;
+
+      // Build the full value to replace
+      const valuePath = dirPath === '.'
+        ? (entry.isDir ? `/${name}/` : `/${name}`)
+        : (entry.isDir ? `${remoteDirPath}${name}/` : `${remoteDirPath}${name}`);
+
+      results.push({
+        label: displayName,
+        value: `@${escapeSpaces(valuePath)}`,
+        description: entry.isDir ? 'remote directory' : 'remote file',
+        isDir: entry.isDir,
+      });
+
+      if (results.length >= MAX_COMPLETIONS) {
+        break;
+      }
+    }
+
+    // Sort: directories first, then alphabetically
+    results.sort((a, b) => {
+      if (a.isDir !== b.isDir) {
+        return a.isDir ? -1 : 1;
+      }
+      return a.label.localeCompare(b.label);
+    });
+
+    return results;
+  } catch (err) {
+    return [];
+  }
+}
+
+/**
+ * Replace the @ path in buffer with selected value
+ * @param {string} buffer - Current buffer
+ * @param {Object} atContext - Context from parseAtContext
+ * @param {string} selectedValue - Selected completion value (including @)
+ * @returns {string} New buffer with replaced path
+ */
+export function replaceAtPath(buffer, atContext, selectedValue) {
+  const before = buffer.substring(0, atContext.replaceStart);
+  const after = buffer.substring(atContext.replaceEnd);
+
+  return before + selectedValue + after;
+}

package/commands/attach/ink-repl/utils/clipboard.js

@@ -0,0 +1,50 @@
+/**
+ * Clipboard utilities for terminal
+ * Uses native commands (pbcopy on macOS, xclip on Linux)
+ */
+
+import { spawn } from 'child_process';
+import os from 'os';
+
+/**
+ * Copy text to system clipboard
+ * @param {string} text Text to copy
+ * @returns {Promise<boolean>} Success status
+ */
+export async function copyToClipboard(text) {
+  const platform = os.platform();
+
+  let command;
+  let args = [];
+
+  if (platform === 'darwin') {
+    command = 'pbcopy';
+  } else if (platform === 'linux') {
+    // Try xclip first, fallback to xsel
+    command = 'xclip';
+    args = ['-selection', 'clipboard'];
+  } else if (platform === 'win32') {
+    command = 'clip';
+  } else {
+    return false;
+  }
+
+  return new Promise((resolve) => {
+    try {
+      const proc = spawn(command, args, { stdio: ['pipe', 'ignore', 'ignore'] });
+
+      proc.stdin.write(text);
+      proc.stdin.end();
+
+      proc.on('close', (code) => {
+        resolve(code === 0);
+      });
+
+      proc.on('error', () => {
+        resolve(false);
+      });
+    } catch {
+      resolve(false);
+    }
+  });
+}

package/commands/attach/ink-repl/utils/consoleLogger.js

@@ -0,0 +1,81 @@
+/**
+ * Console Logger - Global logger for InkREPL console panel
+ *
+ * Usage:
+ *   import { consoleLogger } from './utils/consoleLogger.js';
+ *   consoleLogger.info('Message');
+ *   consoleLogger.warn('Warning');
+ *   consoleLogger.error('Error');
+ *   consoleLogger.debug('Debug info');
+ */
+
+// Store the setState function reference
+let _setStateRef = null;
+
+/**
+ * Initialize the console logger with setState function
+ * Called from InkREPL component
+ */
+export function initConsoleLogger(setState) {
+  _setStateRef = setState;
+}
+
+/**
+ * Clear the console logger reference
+ * Called when InkREPL unmounts
+ */
+export function clearConsoleLogger() {
+  _setStateRef = null;
+}
+
+// Console height (visible lines) - should match Console component
+const CONSOLE_HEIGHT = 7;
+
+/**
+ * Add a log entry to the console
+ * Auto-scrolls to bottom to show latest logs
+ * @param {string} level - Log level
+ * @param {string} message - Display message (may be truncated)
+ * @param {string} fullMessage - Full message for copying (optional)
+ */
+function addLog(level, message, fullMessage = null) {
+  if (!_setStateRef) {
+    // Fallback to real console if not initialized
+    const method = level === 'error' ? 'error' : level === 'warn' ? 'warn' : 'log';
+    console[method](`[ConsoleLogger] ${message}`);
+    return;
+  }
+
+  _setStateRef(state => {
+    const newLog = {
+      id: `log-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+      level,
+      message: String(message),
+      fullMessage: fullMessage ? String(fullMessage) : String(message), // For copying
+      timestamp: new Date(),
+    };
+    const newLogs = [...state.consoleLogs, newLog];
+    // Auto-scroll to bottom: offset = total logs - visible lines
+    const newScrollOffset = Math.max(0, newLogs.length - CONSOLE_HEIGHT);
+
+    return {
+      ...state,
+      consoleLogs: newLogs,
+      consoleScrollOffset: newScrollOffset,
+    };
+  });
+}
+
+/**
+ * Console Logger API
+ * Each method accepts optional fullMessage for copying
+ */
+export const consoleLogger = {
+  info: (message, fullMessage) => addLog('info', message, fullMessage),
+  warn: (message, fullMessage) => addLog('warn', message, fullMessage),
+  error: (message, fullMessage) => addLog('error', message, fullMessage),
+  debug: (message, fullMessage) => addLog('debug', message, fullMessage),
+  log: (message, fullMessage) => addLog('info', message, fullMessage),
+};
+
+export default consoleLogger;

package/commands/attach/ink-repl/utils/exitCodeHandler.js

@@ -0,0 +1,49 @@
+/**
+ * Handle abnormal exit codes with helpful messages.
+ *
+ * @param {number} exitCode - The exit code from command execution
+ * @param {string} output - The original output (can be empty)
+ * @returns {{ output: string, hint: string|null }} - Processed output and optional hint
+ */
+export function handleAbnormalExitCode(exitCode, output = '') {
+  let hint = null;
+
+  if (exitCode === -1) {
+    // -1 typically indicates process was killed or internal error
+    hint = 'Command terminated abnormally (exit code -1). This may indicate a timeout, signal termination, or internal error.';
+    if (!output) {
+      return { output: hint, hint };
+    }
+    return { output, hint };
+  }
+
+  if (exitCode === 137) {
+    // 128 + 9 (SIGKILL) - often OOM killed
+    hint = '[Process killed (exit code 137). Possibly OOM or manually terminated.]';
+    return {
+      output: output ? `${output}\n${hint}` : hint,
+      hint
+    };
+  }
+
+  if (exitCode === 143) {
+    // 128 + 15 (SIGTERM) - graceful termination
+    hint = '[Process terminated (exit code 143). Received SIGTERM.]';
+    return {
+      output: output ? `${output}\n${hint}` : hint,
+      hint
+    };
+  }
+
+  return { output, hint: null };
+}
+
+/**
+ * Check if exit code indicates an abnormal termination.
+ *
+ * @param {number} exitCode - The exit code
+ * @returns {boolean} - True if abnormal
+ */
+export function isAbnormalExitCode(exitCode) {
+  return exitCode === -1 || exitCode === 137 || exitCode === 143;
+}

package/commands/attach/ink-repl/utils/exitCodeTips.js

@@ -0,0 +1,56 @@
+/**
+ * 退出码提示工具
+ * 根据退出码提供用户友好的提示信息
+ */
+
+export const EXIT_CODE_TIPS = {
+  zh: {
+    0: null, // 成功无提示
+    '-1': '命令执行异常（超时/网络/会话失效）',
+    1: '命令执行失败，请检查参数或路径是否正确',
+    2: '命令用法错误，使用 --help 查看帮助',
+    126: '没有执行权限，尝试 chmod +x 或检查权限',
+    127: '命令不存在，请检查拼写或是否已安装',
+    128: '无效的参数，请检查命令语法',
+    130: '命令被用户中断',
+    137: '命令被强制终止（可能是 OOM）',
+    139: '程序发生段错误（Segmentation Fault）',
+    143: '命令被终止信号终止',
+  },
+  en: {
+    0: null,
+    '-1': 'Command execution failed (timeout/network/session expired)',
+    1: 'Command failed. Please check arguments or path',
+    2: 'Command usage error. Use --help for help',
+    126: 'No execute permission. Try chmod +x or check permissions',
+    127: 'Command not found. Check spelling or if installed',
+    128: 'Invalid argument. Check command syntax',
+    130: 'Command interrupted by user',
+    137: 'Command killed (possibly OOM)',
+    139: 'Segmentation fault',
+    143: 'Command terminated by signal',
+  },
+};
+
+/**
+ * 获取退出码对应的提示
+ * @param {number} exitCode - 退出码
+ * @param {string} locale - 'zh' | 'en'
+ * @returns {string|null}
+ */
+export function getExitCodeTips(exitCode, locale = 'zh') {
+  const tips = EXIT_CODE_TIPS[locale] || EXIT_CODE_TIPS.zh;
+  
+  // 将 exitCode 转换为字符串进行查找（因为对象的键是字符串）
+  const exitCodeStr = String(exitCode);
+  
+  if (tips[exitCodeStr] !== undefined) {
+    return tips[exitCodeStr];
+  }
+  
+  // 未知退出码
+  if (locale === 'en') {
+    return `Command exited with code: ${exitCode}`;
+  }
+  return `命令返回非零状态码: ${exitCode}`;
+}

package/commands/attach/ink-repl/utils/formatTime.js

@@ -0,0 +1,12 @@
+/**
+ * Format timestamp to HH:MM:SS
+ * @param {number} timestamp - Unix timestamp in milliseconds
+ * @returns {string} Formatted time string
+ */
+export function formatTimestamp(timestamp) {
+  const date = new Date(timestamp);
+  const hours = String(date.getHours()).padStart(2, '0');
+  const minutes = String(date.getMinutes()).padStart(2, '0');
+  const seconds = String(date.getSeconds()).padStart(2, '0');
+  return `${hours}:${minutes}:${seconds}`;
+}