@znmin/claude-remote-cli 0.3.2 → 0.4.1

package/src/system.js

@@ -1,179 +1,179 @@
-import { spawn } from 'node:child_process';
-import { constants } from 'node:fs';
-import * as fs from 'node:fs/promises';
-import os from 'node:os';
-import path from 'node:path';
-import { randomUUID } from 'node:crypto';
-import lockfile from 'proper-lockfile';
-
-export const quote = value => "'" + String(value).replaceAll("'", "'\"'\"'") + "'";
-export const shellJoin = args => args.map(quote).join(' ');
-
-export async function exists(file) {
-  try { await fs.access(file); return true; }
-  catch (error) { if (error.code === 'ENOENT') return false; throw error; }
-}
-
-// On Windows, try the same extensions as spawn() does (.com, .exe); there is no
-// execute permission bit, so existence is the check.
-export async function which(name, search = process.env.PATH || '', { platform = process.platform } = {}) {
-  const windows = platform === 'win32';
-  const names = windows && !path.extname(name) ? [name + '.com', name + '.exe'] : [name];
-  for (const entry of search.split(windows ? ';' : path.delimiter)) {
-    const directory = windows ? entry.replace(/^"(.*)"$/, '$1') : entry;
-    for (const candidate of names) {
-      const file = path.resolve(directory || '.', candidate);
-      try {
-        await fs.access(file, windows ? constants.F_OK : constants.X_OK);
-        if ((await fs.stat(file)).isFile()) return file;
-      } catch (error) { if (!['ENOENT', 'EACCES', 'ENOTDIR', 'EINVAL'].includes(error.code)) throw error; }
-    }
-  }
-  return null;
-}
-
-// Windows refuses to replace a file another process (editor, antivirus,
-// indexer) briefly holds open; retry a few times before giving up.
-export async function rename(from, to, { platform = process.platform, attempts = 10 } = {}) {
-  for (let attempt = 1; ; attempt++) {
-    try { return await fs.rename(from, to); }
-    catch (error) {
-      if (platform !== 'win32' || attempt >= attempts || !['EPERM', 'EACCES', 'EBUSY'].includes(error.code)) throw error;
-      await new Promise(resolve => setTimeout(resolve, 20 * attempt));
-    }
-  }
-}
-
-export async function readJSON(file, fallback) {
-  try { return JSON.parse(await fs.readFile(file, 'utf8')); }
-  catch (error) { if (error.code === 'ENOENT') return fallback; throw error; }
-}
-
-export async function writeJSON(file, value) {
-  await fs.mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
-  const temp = file + '.' + randomUUID() + '.tmp';
-  try {
-    await fs.writeFile(temp, JSON.stringify(value, null, 2) + '\n', { mode: 0o600, flag: 'wx' });
-    await rename(temp, file);
-  } finally { await fs.rm(temp, { force: true }); }
-}
-
-// Children and cleanup callbacks that must not outlive this CLI when the
-// terminal closes (SIGHUP) or the process is asked to stop (SIGTERM).
-const trackedChildren = new Set();
-const cleanups = new Set();
-let terminating = null;
-
-export function trackChild(child) {
-  trackedChildren.add(child);
-  child.once('close', () => trackedChildren.delete(child));
-  child.once('error', () => trackedChildren.delete(child));
-  return child;
-}
-
-export function onCleanup(callback) {
-  cleanups.add(callback);
-  return () => cleanups.delete(callback);
-}
-
-export function terminate(signal, { exit = code => process.exit(code), graceMs = 10000, terminal = process.stdout } = {}) {
-  if (terminating) return terminating;
-  const code = 128 + (os.constants.signals[signal] || 15);
-  terminating = (async () => {
-    // Cleanups first: they may still need live SSH connections (e.g. to delete
-    // remote temporary files). Whatever is left afterwards is stopped.
-    const pending = Promise.allSettled([...cleanups].map(callback => callback()));
-    let timer;
-    const limit = new Promise(resolve => { timer = setTimeout(resolve, graceMs); timer.unref?.(); });
-    await Promise.race([pending, limit]);
-    clearTimeout(timer);
-    for (const child of trackedChildren) {
-      try { child.kill('SIGTERM'); } catch { /* already gone */ }
-    }
-    restoreTerminal(terminal);
-    exit(code);
-  })();
-  return terminating;
-}
-
-// A remote full-screen program that loses its connection cannot switch off the
-// terminal modes it enabled, so mouse moves, focus changes and keys show up as
-// stray escape codes. Every sequence here only turns a mode off and is a no-op
-// when the mode is already off. The alternate screen (?1049l) is deliberately
-// left alone: leaving it when not active can move the cursor on some terminals.
-export const TERMINAL_RESET = [
-  '\x1b[?1000l', '\x1b[?1002l', '\x1b[?1003l', '\x1b[?1005l', '\x1b[?1006l', '\x1b[?1015l', // mouse reporting
-  '\x1b[?1004l', // focus in/out events
-  '\x1b[?2004l', // bracketed paste
-  '\x1b[=0;1u', '\x1b[<99u', // kitty keyboard protocol: clear flags, pop pushed levels
-  '\x1b[>4m', // xterm modifyOtherKeys
-  '\x1b[?1l', '\x1b>', // normal cursor keys and keypad
-  '\x1b[0m', '\x1b[?25h' // plain text attributes, visible cursor
-].join('');
-
-export function restoreTerminal(stream = process.stdout) {
-  if (!stream?.isTTY) return false;
-  try { stream.write(TERMINAL_RESET); return true; }
-  catch { return false; } // The terminal may already be gone (SIGHUP).
-}
-
-export function installSignalHandlers() {
-  for (const signal of ['SIGHUP', 'SIGTERM']) process.on(signal, () => { terminate(signal); });
-}
-
-// `prompt` captures stdout but leaves stdin and stderr on the terminal, so a
-// password or host-key prompt from ssh stays visible and answerable.
-export function execute(command, args = [], { capture = false, timeout = 0, check = true, env = process.env, input, prompt = false } = {}) {
-  return new Promise((resolve, reject) => {
-    const stdio = prompt ? ['inherit', 'pipe', 'inherit'] : [input !== undefined ? 'pipe' : capture ? 'ignore' : 'inherit',
-      capture ? 'pipe' : 'inherit', capture ? 'pipe' : 'inherit'];
-    const child = trackChild(spawn(command, args, { stdio, env }));
-    if (input !== undefined) {
-      child.stdin.on('error', () => {}); // An early remote failure is reported by the exit status.
-      child.stdin.end(input);
-    }
-    let stdout = '', stderr = '', timedOut = false, overflow = false, killTimer;
-    // The Windows console already delivers Ctrl+C to the child, and kill()
-    // there would terminate it outright instead of interrupting it.
-    const interrupt = () => { if (process.platform !== 'win32') child.kill('SIGINT'); };
-    process.on('SIGINT', interrupt);
-    const timer = timeout ? setTimeout(() => {
-      timedOut = true;
-      child.kill('SIGTERM');
-      killTimer = setTimeout(() => child.kill('SIGKILL'), 2000);
-    }, timeout) : null;
-    const cleanup = () => {
-      clearTimeout(timer); clearTimeout(killTimer);
-      process.off('SIGINT', interrupt);
-    };
-    if (child.stdout) {
-      child.stdout.setEncoding('utf8');
-      child.stdout.on('data', chunk => {
-        stdout += chunk;
-        if (stdout.length > 32 * 1024 * 1024) { overflow = true; child.kill('SIGKILL'); }
-      });
-    }
-    if (child.stderr) {
-      child.stderr.setEncoding('utf8');
-      child.stderr.on('data', chunk => { stderr = (stderr + chunk).slice(-65536); });
-    }
-    child.once('error', error => { cleanup(); reject(new Error(`无法执行 ${command}：${error.message}`)); });
-    child.once('close', (status, signal) => {
-      cleanup();
-      const code = status ?? (signal === 'SIGINT' ? 130 : 1);
-      if (timedOut) reject(new Error(`${path.basename(command)} 执行超时；请检查连接或同步状态。`));
-      else if (overflow) reject(new Error('命令输出过大，请使用 claude-remote status 检查。'));
-      else if (check && code) reject(new Error(`${path.basename(command)} 执行失败（${code}）${stderr ? '：' + stderr.trim() : ''}`));
-      else resolve({ code, stdout, stderr });
-    });
-  });
-}
-
-// Heartbeat locks survive long downloads and recover after an interrupted process.
-export async function withLock(directory, callback) {
-  await fs.mkdir(path.dirname(directory), { recursive: true, mode: 0o700 });
-  const release = await lockfile.lock(directory, { realpath: false, stale: 30000, update: 10000,
-    retries: { retries: 240, minTimeout: 1000, maxTimeout: 1000 } });
-  try { return await callback(); }
-  finally { await release(); }
-}
+import { spawn } from 'node:child_process';
+import { constants } from 'node:fs';
+import * as fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import lockfile from 'proper-lockfile';
+
+export const quote = value => "'" + String(value).replaceAll("'", "'\"'\"'") + "'";
+export const shellJoin = args => args.map(quote).join(' ');
+
+export async function exists(file) {
+  try { await fs.access(file); return true; }
+  catch (error) { if (error.code === 'ENOENT') return false; throw error; }
+}
+
+// On Windows, try the same extensions as spawn() does (.com, .exe); there is no
+// execute permission bit, so existence is the check.
+export async function which(name, search = process.env.PATH || '', { platform = process.platform } = {}) {
+  const windows = platform === 'win32';
+  const names = windows && !path.extname(name) ? [name + '.com', name + '.exe'] : [name];
+  for (const entry of search.split(windows ? ';' : path.delimiter)) {
+    const directory = windows ? entry.replace(/^"(.*)"$/, '$1') : entry;
+    for (const candidate of names) {
+      const file = path.resolve(directory || '.', candidate);
+      try {
+        await fs.access(file, windows ? constants.F_OK : constants.X_OK);
+        if ((await fs.stat(file)).isFile()) return file;
+      } catch (error) { if (!['ENOENT', 'EACCES', 'ENOTDIR', 'EINVAL'].includes(error.code)) throw error; }
+    }
+  }
+  return null;
+}
+
+// Windows refuses to replace a file another process (editor, antivirus,
+// indexer) briefly holds open; retry a few times before giving up.
+export async function rename(from, to, { platform = process.platform, attempts = 10 } = {}) {
+  for (let attempt = 1; ; attempt++) {
+    try { return await fs.rename(from, to); }
+    catch (error) {
+      if (platform !== 'win32' || attempt >= attempts || !['EPERM', 'EACCES', 'EBUSY'].includes(error.code)) throw error;
+      await new Promise(resolve => setTimeout(resolve, 20 * attempt));
+    }
+  }
+}
+
+export async function readJSON(file, fallback) {
+  try { return JSON.parse(await fs.readFile(file, 'utf8')); }
+  catch (error) { if (error.code === 'ENOENT') return fallback; throw error; }
+}
+
+export async function writeJSON(file, value) {
+  await fs.mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+  const temp = file + '.' + randomUUID() + '.tmp';
+  try {
+    await fs.writeFile(temp, JSON.stringify(value, null, 2) + '\n', { mode: 0o600, flag: 'wx' });
+    await rename(temp, file);
+  } finally { await fs.rm(temp, { force: true }); }
+}
+
+// Children and cleanup callbacks that must not outlive this CLI when the
+// terminal closes (SIGHUP) or the process is asked to stop (SIGTERM).
+const trackedChildren = new Set();
+const cleanups = new Set();
+let terminating = null;
+
+export function trackChild(child) {
+  trackedChildren.add(child);
+  child.once('close', () => trackedChildren.delete(child));
+  child.once('error', () => trackedChildren.delete(child));
+  return child;
+}
+
+export function onCleanup(callback) {
+  cleanups.add(callback);
+  return () => cleanups.delete(callback);
+}
+
+export function terminate(signal, { exit = code => process.exit(code), graceMs = 10000, terminal = process.stdout } = {}) {
+  if (terminating) return terminating;
+  const code = 128 + (os.constants.signals[signal] || 15);
+  terminating = (async () => {
+    // Cleanups first: they may still need live SSH connections (e.g. to delete
+    // remote temporary files). Whatever is left afterwards is stopped.
+    const pending = Promise.allSettled([...cleanups].map(callback => callback()));
+    let timer;
+    const limit = new Promise(resolve => { timer = setTimeout(resolve, graceMs); timer.unref?.(); });
+    await Promise.race([pending, limit]);
+    clearTimeout(timer);
+    for (const child of trackedChildren) {
+      try { child.kill('SIGTERM'); } catch { /* already gone */ }
+    }
+    restoreTerminal(terminal);
+    exit(code);
+  })();
+  return terminating;
+}
+
+// A remote full-screen program that loses its connection cannot switch off the
+// terminal modes it enabled, so mouse moves, focus changes and keys show up as
+// stray escape codes. Every sequence here only turns a mode off and is a no-op
+// when the mode is already off. The alternate screen (?1049l) is deliberately
+// left alone: leaving it when not active can move the cursor on some terminals.
+export const TERMINAL_RESET = [
+  '\x1b[?1000l', '\x1b[?1002l', '\x1b[?1003l', '\x1b[?1005l', '\x1b[?1006l', '\x1b[?1015l', // mouse reporting
+  '\x1b[?1004l', // focus in/out events
+  '\x1b[?2004l', // bracketed paste
+  '\x1b[=0;1u', '\x1b[<99u', // kitty keyboard protocol: clear flags, pop pushed levels
+  '\x1b[>4m', // xterm modifyOtherKeys
+  '\x1b[?1l', '\x1b>', // normal cursor keys and keypad
+  '\x1b[0m', '\x1b[?25h' // plain text attributes, visible cursor
+].join('');
+
+export function restoreTerminal(stream = process.stdout) {
+  if (!stream?.isTTY) return false;
+  try { stream.write(TERMINAL_RESET); return true; }
+  catch { return false; } // The terminal may already be gone (SIGHUP).
+}
+
+export function installSignalHandlers() {
+  for (const signal of ['SIGHUP', 'SIGTERM']) process.on(signal, () => { terminate(signal); });
+}
+
+// `prompt` captures stdout but leaves stdin and stderr on the terminal, so a
+// password or host-key prompt from ssh stays visible and answerable.
+export function execute(command, args = [], { capture = false, timeout = 0, check = true, env = process.env, input, prompt = false } = {}) {
+  return new Promise((resolve, reject) => {
+    const stdio = prompt ? ['inherit', 'pipe', 'inherit'] : [input !== undefined ? 'pipe' : capture ? 'ignore' : 'inherit',
+      capture ? 'pipe' : 'inherit', capture ? 'pipe' : 'inherit'];
+    const child = trackChild(spawn(command, args, { stdio, env }));
+    if (input !== undefined) {
+      child.stdin.on('error', () => {}); // An early remote failure is reported by the exit status.
+      child.stdin.end(input);
+    }
+    let stdout = '', stderr = '', timedOut = false, overflow = false, killTimer;
+    // The Windows console already delivers Ctrl+C to the child, and kill()
+    // there would terminate it outright instead of interrupting it.
+    const interrupt = () => { if (process.platform !== 'win32') child.kill('SIGINT'); };
+    process.on('SIGINT', interrupt);
+    const timer = timeout ? setTimeout(() => {
+      timedOut = true;
+      child.kill('SIGTERM');
+      killTimer = setTimeout(() => child.kill('SIGKILL'), 2000);
+    }, timeout) : null;
+    const cleanup = () => {
+      clearTimeout(timer); clearTimeout(killTimer);
+      process.off('SIGINT', interrupt);
+    };
+    if (child.stdout) {
+      child.stdout.setEncoding('utf8');
+      child.stdout.on('data', chunk => {
+        stdout += chunk;
+        if (stdout.length > 32 * 1024 * 1024) { overflow = true; child.kill('SIGKILL'); }
+      });
+    }
+    if (child.stderr) {
+      child.stderr.setEncoding('utf8');
+      child.stderr.on('data', chunk => { stderr = (stderr + chunk).slice(-65536); });
+    }
+    child.once('error', error => { cleanup(); reject(new Error(`无法执行 ${command}：${error.message}`)); });
+    child.once('close', (status, signal) => {
+      cleanup();
+      const code = status ?? (signal === 'SIGINT' ? 130 : 1);
+      if (timedOut) reject(new Error(`${path.basename(command)} 执行超时；请检查连接或同步状态。`));
+      else if (overflow) reject(new Error('命令输出过大，请使用 claude-remote status 检查。'));
+      else if (check && code) reject(new Error(`${path.basename(command)} 执行失败（${code}）${stderr ? '：' + stderr.trim() : ''}`));
+      else resolve({ code, stdout, stderr });
+    });
+  });
+}
+
+// Heartbeat locks survive long downloads and recover after an interrupted process.
+export async function withLock(directory, callback) {
+  await fs.mkdir(path.dirname(directory), { recursive: true, mode: 0o700 });
+  const release = await lockfile.lock(directory, { realpath: false, stale: 30000, update: 10000,
+    retries: { retries: 240, minTimeout: 1000, maxTimeout: 1000 } });
+  try { return await callback(); }
+  finally { await release(); }
+}