@znmin/claude-remote-cli 0.3.2 → 0.4.1

package/src/local/workspace.js

@@ -1,225 +1,225 @@
-import * as fs from 'node:fs/promises';
-import path from 'node:path';
-import { execFile } from 'node:child_process';
-import { createHash, randomUUID } from 'node:crypto';
-import { rename } from '../system.js';
-
-const hash = text => createHash('sha256').update(text).digest('hex');
-// Windows paths are case-insensitive: C:\Project and c:\project are the same folder.
-const fold = process.platform === 'win32' ? value => value.toLowerCase() : value => value;
-const inside = (root, target) => fold(target) === fold(root) || fold(target).startsWith(fold(root) + path.sep);
-// Lines are shown without a trailing \r, so CRLF files read like LF files.
-const stripCR = line => line.endsWith('\r') ? line.slice(0, -1) : line;
-
-// Keep read_file results below the MCP response limit (JSON escaping adds overhead).
-const READ_BUDGET = 28000;
-const SKIPPED = new Set(['.git', 'node_modules', '.venv', '__pycache__']);
-const MAX_FILES = 10000;
-const escapeRegExp = text => text.replace(/[.+^${}()|[\]\\*?]/g, '\\$&');
-
-// Minimal glob: *, **, ?, {a,b}. Without a slash it matches the file name only.
-export function globMatcher(glob) {
-  let source = '';
-  for (let i = 0; i < glob.length; i++) {
-    const char = glob[i];
-    if (char === '*' && glob[i + 1] === '*') {
-      i++;
-      if (glob[i + 1] === '/') { i++; source += '(?:.*/)?'; } else source += '.*';
-    } else if (char === '*') source += '[^/]*';
-    else if (char === '?') source += '[^/]';
-    else if (char === '{' && glob.indexOf('}', i) > i) {
-      const end = glob.indexOf('}', i);
-      source += '(?:' + glob.slice(i + 1, end).split(',').map(escapeRegExp).join('|') + ')';
-      i = end;
-    } else source += escapeRegExp(char);
-  }
-  const pattern = new RegExp('^' + source + '$');
-  const byName = !glob.includes('/');
-  return relative => pattern.test(byName ? path.posix.basename(relative) : relative);
-}
-
-function gitFiles(directory) {
-  return new Promise(resolve => {
-    execFile('git', ['-C', directory, 'ls-files', '-z', '--cached', '--others', '--exclude-standard'],
-      { maxBuffer: 64 * 1024 * 1024, timeout: 15000 }, (error, stdout) => {
-        resolve(error ? null : stdout.split('\0').filter(Boolean));
-      });
-  });
-}
-
-export class Workspace {
-  constructor(root) { this.root = root; }
-
-  async resolve(input = '.', writing = false) {
-    const candidate = path.resolve(this.root, input);
-    if (!inside(this.root, candidate)) throw new Error('文件路径必须位于当前项目内。');
-    let canonical;
-    try { canonical = await fs.realpath(candidate); }
-    catch (error) {
-      if (error.code !== 'ENOENT' || !writing) throw error;
-      let parent = path.dirname(candidate);
-      while (true) {
-        try { canonical = path.join(await fs.realpath(parent), path.relative(parent, candidate)); break; }
-        catch (e) {
-          if (e.code !== 'ENOENT' || parent === path.dirname(parent)) throw e;
-          parent = path.dirname(parent);
-        }
-      }
-    }
-    if (!inside(this.root, canonical)) throw new Error('符号链接指向项目外部，无法访问。');
-    return canonical;
-  }
-
-  async read(file, offset = 1, limit = 200) {
-    const target = await this.resolve(file);
-    const stat = await fs.stat(target);
-    if (!stat.isFile() || stat.size > 2 * 1024 * 1024) throw new Error('仅支持读取 2 MiB 以内的文本文件。');
-    const content = await fs.readFile(target, 'utf8');
-    if (content.includes('\0')) throw new Error('这是二进制文件，请通过终端或专用工具处理。');
-    const lines = content.split('\n');
-    if (lines.length > 1 && lines.at(-1) === '') lines.pop(); // A trailing newline is not an extra line.
-    const total = content === '' ? 0 : lines.length;
-    const output = [];
-    let used = 0, sizeLimited = false;
-    for (let i = offset - 1; i < Math.min(total, offset - 1 + limit); i++) {
-      const line = `${i + 1}: ${stripCR(lines[i])}`;
-      if (used + line.length > READ_BUDGET) {
-        sizeLimited = true;
-        if (!output.length) output.push(line.slice(0, READ_BUDGET) + ` …[本行过长已截断，共 ${lines[i].length} 字符，请用终端查看]`);
-        break;
-      }
-      output.push(line);
-      used += line.length + 1;
-    }
-    const next = offset + output.length;
-    return { path: path.relative(this.root, target), sha256: hash(content), total_lines: total,
-      content: output.join('\n'),
-      ...(content.includes('\r\n') ? { line_endings: 'crlf' } : {}),
-      ...(next <= total ? { next_offset: next } : {}),
-      ...(sizeLimited ? { truncated_by_size: true } : {}) };
-  }
-
-  async atomicWrite(target, content, mode = 0o644) {
-    await fs.mkdir(path.dirname(target), { recursive: true });
-    const temp = path.join(path.dirname(target), '.claude-write-' + randomUUID());
-    try {
-      await fs.writeFile(temp, content, { flag: 'wx', mode });
-      await rename(temp, target);
-    } finally { await fs.rm(temp, { force: true }); }
-    return { path: path.relative(this.root, target), sha256: hash(content), bytes: Buffer.byteLength(content) };
-  }
-
-  async write(file, content, expectedSha256) {
-    const target = await this.resolve(file, true);
-    let mode;
-    try {
-      if ((await fs.stat(target)).size > 2 * 1024 * 1024) throw new Error('覆盖文件大小上限为 2 MiB。');
-      const old = await fs.readFile(target, 'utf8');
-      mode = (await fs.stat(target)).mode & 0o777;
-      if (!expectedSha256 || hash(old) !== expectedSha256)
-        throw new Error('文件已存在或发生变化；先 read_file，再提供匹配的 expected_sha256。');
-    } catch (error) { if (error.code !== 'ENOENT') throw error; }
-    return this.atomicWrite(target, content, mode);
-  }
-
-  async edit(file, oldText, newText, replaceAll = false) {
-    const target = await this.resolve(file);
-    const stat = await fs.stat(target);
-    if (stat.size > 2 * 1024 * 1024) throw new Error('编辑文件大小上限为 2 MiB。');
-    const content = await fs.readFile(target, 'utf8');
-    // read_file hides \r, so text copied from it uses \n; match CRLF files too.
-    if (!content.includes(oldText) && content.includes('\r\n') && !oldText.includes('\r')) {
-      oldText = oldText.replaceAll('\n', '\r\n');
-      newText = newText.replaceAll('\r\n', '\n').replaceAll('\n', '\r\n');
-    }
-    const matches = content.split(oldText).length - 1;
-    if (!matches) throw new Error('找不到 old_text，请重新读取文件。');
-    if (matches > 1 && !replaceAll) throw new Error('old_text 出现多次，请提供更精确的上下文或使用 replace_all。');
-    const next = replaceAll ? content.split(oldText).join(newText) : content.replace(oldText, () => newText);
-    return this.atomicWrite(target, next, stat.mode & 0o777);
-  }
-
-  async list(directory = '.') {
-    const target = await this.resolve(directory);
-    const entries = await fs.readdir(target, { withFileTypes: true });
-    return { path: path.relative(this.root, target) || '.', truncated: entries.length > 500,
-      entries: entries.sort((a, b) => a.name.localeCompare(b.name)).slice(0, 500).map(entry => ({
-        name: entry.name, type: entry.isSymbolicLink() ? 'symlink' : entry.isDirectory() ? 'directory' : 'file'
-      })) };
-  }
-
-  // Candidate files relative to `directory`. Inside a Git work tree this follows
-  // .gitignore; otherwise it walks the tree and skips common dependency folders.
-  async candidates(directory) {
-    const fromGit = await gitFiles(directory);
-    // An empty list usually means the directory itself is ignored; search it explicitly.
-    if (fromGit?.length) {
-      const files = fromGit.filter(file => !file.split('/').some(part => SKIPPED.has(part))).sort();
-      return { files: files.slice(0, MAX_FILES), limited: files.length > MAX_FILES, errors: 0, source: 'git' };
-    }
-    const files = [];
-    let errors = 0, limited = false;
-    const walk = async relative => {
-      let entries;
-      try { entries = await fs.readdir(path.join(directory, relative), { withFileTypes: true }); }
-      catch { errors++; return; }
-      entries.sort((a, b) => a.name.localeCompare(b.name));
-      for (const entry of entries) {
-        if (files.length >= MAX_FILES) { limited = true; return; }
-        const child = relative ? relative + '/' + entry.name : entry.name;
-        if (entry.isDirectory()) { if (!SKIPPED.has(entry.name)) await walk(child); }
-        else if (entry.isFile()) files.push(child);
-      }
-    };
-    await walk('');
-    return { files, limited, errors, source: 'walk' };
-  }
-
-  async search(pattern, directory = '.', maxResults = 100, caseSensitive = true, { regex = false, glob } = {}) {
-    const root = await this.resolve(directory);
-    let test;
-    if (regex) {
-      let expression;
-      try { expression = new RegExp(pattern, caseSensitive ? '' : 'i'); }
-      catch (error) { throw new Error('正则表达式无效：' + error.message); }
-      test = line => expression.test(line);
-    } else {
-      const needle = caseSensitive ? pattern : pattern.toLowerCase();
-      test = line => (caseSensitive ? line : line.toLowerCase()).includes(needle);
-    }
-    const matchesGlob = glob ? globMatcher(glob) : () => true;
-    const rootStat = await fs.stat(root);
-    const listing = rootStat.isFile() ? { files: [''], limited: false, errors: 0, source: 'file' } : await this.candidates(root);
-    const files = listing.files.filter(file => file === '' || matchesGlob(file));
-    const results = [];
-    let scanned = 0, errors = listing.errors, truncated = listing.limited;
-    const scan = async relative => {
-      const target = relative ? path.join(root, relative) : root;
-      try {
-        const stat = await fs.lstat(target);
-        if (!stat.isFile() || stat.size > 1024 * 1024) return null;
-        const text = await fs.readFile(target, 'utf8');
-        scanned++;
-        if (text.includes('\0')) return null;
-        const found = [];
-        for (const [i, line] of text.split('\n').entries())
-          if (test(stripCR(line))) found.push({ path: path.relative(this.root, target), line: i + 1, text: stripCR(line).slice(0, 1000) });
-        return found;
-      } catch (error) {
-        if (error.code !== 'ENOENT') errors++; // Deleted tracked files are not errors.
-        return null;
-      }
-    };
-    // Read in parallel batches but keep results in a stable path order.
-    for (let i = 0; i < files.length && !truncated; i += 32) {
-      for (const found of await Promise.all(files.slice(i, i + 32).map(scan))) {
-        for (const match of found || []) {
-          if (results.length >= maxResults) { truncated = true; break; }
-          results.push(match);
-        }
-        if (truncated) break;
-      }
-    }
-    return { results, scanned_files: scanned, truncated, source: listing.source, ...(errors ? { unreadable: errors } : {}) };
-  }
-}
+import * as fs from 'node:fs/promises';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { createHash, randomUUID } from 'node:crypto';
+import { rename } from '../system.js';
+
+const hash = text => createHash('sha256').update(text).digest('hex');
+// Windows paths are case-insensitive: C:\Project and c:\project are the same folder.
+const fold = process.platform === 'win32' ? value => value.toLowerCase() : value => value;
+const inside = (root, target) => fold(target) === fold(root) || fold(target).startsWith(fold(root) + path.sep);
+// Lines are shown without a trailing \r, so CRLF files read like LF files.
+const stripCR = line => line.endsWith('\r') ? line.slice(0, -1) : line;
+
+// Keep read_file results below the MCP response limit (JSON escaping adds overhead).
+const READ_BUDGET = 28000;
+const SKIPPED = new Set(['.git', 'node_modules', '.venv', '__pycache__']);
+const MAX_FILES = 10000;
+const escapeRegExp = text => text.replace(/[.+^${}()|[\]\\*?]/g, '\\$&');
+
+// Minimal glob: *, **, ?, {a,b}. Without a slash it matches the file name only.
+export function globMatcher(glob) {
+  let source = '';
+  for (let i = 0; i < glob.length; i++) {
+    const char = glob[i];
+    if (char === '*' && glob[i + 1] === '*') {
+      i++;
+      if (glob[i + 1] === '/') { i++; source += '(?:.*/)?'; } else source += '.*';
+    } else if (char === '*') source += '[^/]*';
+    else if (char === '?') source += '[^/]';
+    else if (char === '{' && glob.indexOf('}', i) > i) {
+      const end = glob.indexOf('}', i);
+      source += '(?:' + glob.slice(i + 1, end).split(',').map(escapeRegExp).join('|') + ')';
+      i = end;
+    } else source += escapeRegExp(char);
+  }
+  const pattern = new RegExp('^' + source + '$');
+  const byName = !glob.includes('/');
+  return relative => pattern.test(byName ? path.posix.basename(relative) : relative);
+}
+
+function gitFiles(directory) {
+  return new Promise(resolve => {
+    execFile('git', ['-C', directory, 'ls-files', '-z', '--cached', '--others', '--exclude-standard'],
+      { maxBuffer: 64 * 1024 * 1024, timeout: 15000 }, (error, stdout) => {
+        resolve(error ? null : stdout.split('\0').filter(Boolean));
+      });
+  });
+}
+
+export class Workspace {
+  constructor(root) { this.root = root; }
+
+  async resolve(input = '.', writing = false) {
+    const candidate = path.resolve(this.root, input);
+    if (!inside(this.root, candidate)) throw new Error('文件路径必须位于当前项目内。');
+    let canonical;
+    try { canonical = await fs.realpath(candidate); }
+    catch (error) {
+      if (error.code !== 'ENOENT' || !writing) throw error;
+      let parent = path.dirname(candidate);
+      while (true) {
+        try { canonical = path.join(await fs.realpath(parent), path.relative(parent, candidate)); break; }
+        catch (e) {
+          if (e.code !== 'ENOENT' || parent === path.dirname(parent)) throw e;
+          parent = path.dirname(parent);
+        }
+      }
+    }
+    if (!inside(this.root, canonical)) throw new Error('符号链接指向项目外部，无法访问。');
+    return canonical;
+  }
+
+  async read(file, offset = 1, limit = 200) {
+    const target = await this.resolve(file);
+    const stat = await fs.stat(target);
+    if (!stat.isFile() || stat.size > 2 * 1024 * 1024) throw new Error('仅支持读取 2 MiB 以内的文本文件。');
+    const content = await fs.readFile(target, 'utf8');
+    if (content.includes('\0')) throw new Error('这是二进制文件，请通过终端或专用工具处理。');
+    const lines = content.split('\n');
+    if (lines.length > 1 && lines.at(-1) === '') lines.pop(); // A trailing newline is not an extra line.
+    const total = content === '' ? 0 : lines.length;
+    const output = [];
+    let used = 0, sizeLimited = false;
+    for (let i = offset - 1; i < Math.min(total, offset - 1 + limit); i++) {
+      const line = `${i + 1}: ${stripCR(lines[i])}`;
+      if (used + line.length > READ_BUDGET) {
+        sizeLimited = true;
+        if (!output.length) output.push(line.slice(0, READ_BUDGET) + ` …[本行过长已截断，共 ${lines[i].length} 字符，请用终端查看]`);
+        break;
+      }
+      output.push(line);
+      used += line.length + 1;
+    }
+    const next = offset + output.length;
+    return { path: path.relative(this.root, target), sha256: hash(content), total_lines: total,
+      content: output.join('\n'),
+      ...(content.includes('\r\n') ? { line_endings: 'crlf' } : {}),
+      ...(next <= total ? { next_offset: next } : {}),
+      ...(sizeLimited ? { truncated_by_size: true } : {}) };
+  }
+
+  async atomicWrite(target, content, mode = 0o644) {
+    await fs.mkdir(path.dirname(target), { recursive: true });
+    const temp = path.join(path.dirname(target), '.claude-write-' + randomUUID());
+    try {
+      await fs.writeFile(temp, content, { flag: 'wx', mode });
+      await rename(temp, target);
+    } finally { await fs.rm(temp, { force: true }); }
+    return { path: path.relative(this.root, target), sha256: hash(content), bytes: Buffer.byteLength(content) };
+  }
+
+  async write(file, content, expectedSha256) {
+    const target = await this.resolve(file, true);
+    let mode;
+    try {
+      if ((await fs.stat(target)).size > 2 * 1024 * 1024) throw new Error('覆盖文件大小上限为 2 MiB。');
+      const old = await fs.readFile(target, 'utf8');
+      mode = (await fs.stat(target)).mode & 0o777;
+      if (!expectedSha256 || hash(old) !== expectedSha256)
+        throw new Error('文件已存在或发生变化；先 read_file，再提供匹配的 expected_sha256。');
+    } catch (error) { if (error.code !== 'ENOENT') throw error; }
+    return this.atomicWrite(target, content, mode);
+  }
+
+  async edit(file, oldText, newText, replaceAll = false) {
+    const target = await this.resolve(file);
+    const stat = await fs.stat(target);
+    if (stat.size > 2 * 1024 * 1024) throw new Error('编辑文件大小上限为 2 MiB。');
+    const content = await fs.readFile(target, 'utf8');
+    // read_file hides \r, so text copied from it uses \n; match CRLF files too.
+    if (!content.includes(oldText) && content.includes('\r\n') && !oldText.includes('\r')) {
+      oldText = oldText.replaceAll('\n', '\r\n');
+      newText = newText.replaceAll('\r\n', '\n').replaceAll('\n', '\r\n');
+    }
+    const matches = content.split(oldText).length - 1;
+    if (!matches) throw new Error('找不到 old_text，请重新读取文件。');
+    if (matches > 1 && !replaceAll) throw new Error('old_text 出现多次，请提供更精确的上下文或使用 replace_all。');
+    const next = replaceAll ? content.split(oldText).join(newText) : content.replace(oldText, () => newText);
+    return this.atomicWrite(target, next, stat.mode & 0o777);
+  }
+
+  async list(directory = '.') {
+    const target = await this.resolve(directory);
+    const entries = await fs.readdir(target, { withFileTypes: true });
+    return { path: path.relative(this.root, target) || '.', truncated: entries.length > 500,
+      entries: entries.sort((a, b) => a.name.localeCompare(b.name)).slice(0, 500).map(entry => ({
+        name: entry.name, type: entry.isSymbolicLink() ? 'symlink' : entry.isDirectory() ? 'directory' : 'file'
+      })) };
+  }
+
+  // Candidate files relative to `directory`. Inside a Git work tree this follows
+  // .gitignore; otherwise it walks the tree and skips common dependency folders.
+  async candidates(directory) {
+    const fromGit = await gitFiles(directory);
+    // An empty list usually means the directory itself is ignored; search it explicitly.
+    if (fromGit?.length) {
+      const files = fromGit.filter(file => !file.split('/').some(part => SKIPPED.has(part))).sort();
+      return { files: files.slice(0, MAX_FILES), limited: files.length > MAX_FILES, errors: 0, source: 'git' };
+    }
+    const files = [];
+    let errors = 0, limited = false;
+    const walk = async relative => {
+      let entries;
+      try { entries = await fs.readdir(path.join(directory, relative), { withFileTypes: true }); }
+      catch { errors++; return; }
+      entries.sort((a, b) => a.name.localeCompare(b.name));
+      for (const entry of entries) {
+        if (files.length >= MAX_FILES) { limited = true; return; }
+        const child = relative ? relative + '/' + entry.name : entry.name;
+        if (entry.isDirectory()) { if (!SKIPPED.has(entry.name)) await walk(child); }
+        else if (entry.isFile()) files.push(child);
+      }
+    };
+    await walk('');
+    return { files, limited, errors, source: 'walk' };
+  }
+
+  async search(pattern, directory = '.', maxResults = 100, caseSensitive = true, { regex = false, glob } = {}) {
+    const root = await this.resolve(directory);
+    let test;
+    if (regex) {
+      let expression;
+      try { expression = new RegExp(pattern, caseSensitive ? '' : 'i'); }
+      catch (error) { throw new Error('正则表达式无效：' + error.message); }
+      test = line => expression.test(line);
+    } else {
+      const needle = caseSensitive ? pattern : pattern.toLowerCase();
+      test = line => (caseSensitive ? line : line.toLowerCase()).includes(needle);
+    }
+    const matchesGlob = glob ? globMatcher(glob) : () => true;
+    const rootStat = await fs.stat(root);
+    const listing = rootStat.isFile() ? { files: [''], limited: false, errors: 0, source: 'file' } : await this.candidates(root);
+    const files = listing.files.filter(file => file === '' || matchesGlob(file));
+    const results = [];
+    let scanned = 0, errors = listing.errors, truncated = listing.limited;
+    const scan = async relative => {
+      const target = relative ? path.join(root, relative) : root;
+      try {
+        const stat = await fs.lstat(target);
+        if (!stat.isFile() || stat.size > 1024 * 1024) return null;
+        const text = await fs.readFile(target, 'utf8');
+        scanned++;
+        if (text.includes('\0')) return null;
+        const found = [];
+        for (const [i, line] of text.split('\n').entries())
+          if (test(stripCR(line))) found.push({ path: path.relative(this.root, target), line: i + 1, text: stripCR(line).slice(0, 1000) });
+        return found;
+      } catch (error) {
+        if (error.code !== 'ENOENT') errors++; // Deleted tracked files are not errors.
+        return null;
+      }
+    };
+    // Read in parallel batches but keep results in a stable path order.
+    for (let i = 0; i < files.length && !truncated; i += 32) {
+      for (const found of await Promise.all(files.slice(i, i + 32).map(scan))) {
+        for (const match of found || []) {
+          if (results.length >= maxResults) { truncated = true; break; }
+          results.push(match);
+        }
+        if (truncated) break;
+      }
+    }
+    return { results, scanned_files: scanned, truncated, source: listing.source, ...(errors ? { unreadable: errors } : {}) };
+  }
+}