backtrace-console 0.0.1 → 0.0.2

package/routes/backtrace-shared.js

@@ -0,0 +1,202 @@
+var fs = require('node:fs/promises');
+var path = require('node:path');
+var BacktraceCodexToolModule = require('../lib/BacktraceCodexTool');
+var RepairModule = require('../lib/backtrace/repair');
+
+var ROOT_DIR = process.cwd();
+var FINGERPRINTS_ROOT = path.join(ROOT_DIR, 'fingerprints');
+var DEFAULT_WORKDIR = BacktraceCodexToolModule.DEFAULT_WORKDIR;
+var DEFAULT_PROXY = BacktraceCodexToolModule.DEFAULT_PROXY;
+var UE_ENGINE_PATH = process.env.UE_ENGINE_PATH || process.env.UNREAL_ENGINE_PATH || '';
+var REPAIR_STATUS_FILE = '.repair-status.json';
+
+function toSafeAbsolute(rootDir, relativePath) {
+  var safeRelative = String(relativePath || '').replace(/[\\/]+/g, path.sep);
+  var targetPath = path.resolve(rootDir, safeRelative);
+  if (targetPath !== rootDir && !targetPath.startsWith(rootDir + path.sep)) {
+    throw new Error('Invalid path');
+  }
+  return targetPath;
+}
+
+async function pathExists(targetPath) {
+  try {
+    await fs.access(targetPath);
+    return true;
+  } catch (error) {
+    return false;
+  }
+}
+
+function normalizeFingerprintPath(fingerprint) {
+  var normalized = String(fingerprint || '').trim();
+  if (!normalized) {
+    throw new Error('fingerprint is required');
+  }
+  return normalized;
+}
+
+function formatChatSessionId(date) {
+  return [
+    date.getFullYear(),
+    String(date.getMonth() + 1).padStart(2, '0'),
+    String(date.getDate()).padStart(2, '0'),
+  ].join('') + '-' + [
+    String(date.getHours()).padStart(2, '0'),
+    String(date.getMinutes()).padStart(2, '0'),
+    String(date.getSeconds()).padStart(2, '0'),
+  ].join('');
+}
+
+async function listImmediateDirectories(rootDir, relativeDir) {
+  var absoluteDir = toSafeAbsolute(rootDir, relativeDir || '');
+  if (!(await pathExists(absoluteDir))) {
+    return [];
+  }
+  var entries = await fs.readdir(absoluteDir, { withFileTypes: true });
+  return entries.filter(function(entry) { return entry.isDirectory(); }).map(function(entry) {
+    return { name: entry.name, path: relativeDir ? path.join(relativeDir, entry.name) : entry.name };
+  });
+}
+
+async function listImmediateFiles(rootDir, relativeDir) {
+  var absoluteDir = toSafeAbsolute(rootDir, relativeDir || '');
+  if (!(await pathExists(absoluteDir))) {
+    return [];
+  }
+  var entries = await fs.readdir(absoluteDir, { withFileTypes: true });
+  return entries.filter(function(entry) { return entry.isFile(); }).map(function(entry) {
+    var childRelative = relativeDir ? path.join(relativeDir, entry.name) : entry.name;
+    return { name: entry.name, path: childRelative, ext: path.extname(entry.name).toLowerCase() };
+  }).sort(function(a, b) { return a.name.localeCompare(b.name); });
+}
+
+function buildFingerprintStatus(hasReports, hasCompletedRepair) {
+  if (!hasReports) {
+    return '未生成报告';
+  }
+  return hasCompletedRepair ? '已完成' : '未修复状态';
+}
+
+async function readRepairStatus(relativeFingerprintPath) {
+  var statusPath = toSafeAbsolute(FINGERPRINTS_ROOT, path.join(relativeFingerprintPath, 'reports', REPAIR_STATUS_FILE));
+  var raw = await fs.readFile(statusPath, 'utf8').catch(function() { return ''; });
+  if (!raw) {
+    return null;
+  }
+  try {
+    return JSON.parse(raw);
+  } catch (error) {
+    return null;
+  }
+}
+
+async function readFingerprintFetchedMeta(relativeFingerprintPath) {
+  var absolutePath = toSafeAbsolute(FINGERPRINTS_ROOT, relativeFingerprintPath);
+  var stats = await fs.stat(absolutePath);
+  var fetchedAtDate = stats.birthtimeMs ? new Date(stats.birthtimeMs) : new Date(stats.ctimeMs || stats.mtimeMs);
+  return { fetchedAt: fetchedAtDate.toISOString(), fetchedAtTs: fetchedAtDate.getTime() };
+}
+
+async function listTopLevelMergedDirectories() {
+  var fingerprintDirs = await listImmediateDirectories(FINGERPRINTS_ROOT, '');
+  var items = await Promise.all(fingerprintDirs.map(async function(item) {
+    var logDirs = await listImmediateDirectories(FINGERPRINTS_ROOT, path.join(item.path, 'logs'));
+    var reportFiles = await listImmediateFiles(FINGERPRINTS_ROOT, path.join(item.path, 'reports'));
+    var repairStatus = await readRepairStatus(item.path);
+    var fetchedMeta = await readFingerprintFetchedMeta(item.path);
+    var hasReports = reportFiles.length > 0;
+    var hasCompletedRepair = !!(repairStatus && repairStatus.completed);
+    return {
+      name: item.name,
+      path: item.path,
+      hasLogs: logDirs.length > 0,
+      hasReports: hasReports,
+      hasCompletedRepair: hasCompletedRepair,
+      status: buildFingerprintStatus(hasReports, hasCompletedRepair),
+      fetchedAt: fetchedMeta.fetchedAt,
+      fetchedAtTs: fetchedMeta.fetchedAtTs,
+    };
+  }));
+  return items.sort(function(a, b) {
+    var diff = Number(b.fetchedAtTs || 0) - Number(a.fetchedAtTs || 0);
+    return diff || b.name.localeCompare(a.name);
+  });
+}
+
+async function readFingerprintMeta(relativeFingerprintPath) {
+  var targetPath = toSafeAbsolute(FINGERPRINTS_ROOT, path.join(relativeFingerprintPath, 'meta.json'));
+  var raw = await fs.readFile(targetPath, 'utf8').catch(function(error) {
+    if (error && error.code === 'ENOENT') {
+      return '';
+    }
+    throw error;
+  });
+  if (!raw) {
+    return null;
+  }
+  return JSON.parse(raw);
+}
+
+async function writeFingerprintMeta(relativeFingerprintPath, payload) {
+  var fingerprintDir = toSafeAbsolute(FINGERPRINTS_ROOT, relativeFingerprintPath);
+  var targetPath = toSafeAbsolute(FINGERPRINTS_ROOT, path.join(relativeFingerprintPath, 'meta.json'));
+  await fs.mkdir(fingerprintDir, { recursive: true });
+  await fs.writeFile(targetPath, JSON.stringify(payload, null, 2), 'utf8');
+  return targetPath;
+}
+
+function getReportPriority(name) {
+  var lowerName = String(name || '').toLowerCase();
+  if (lowerName === 'error-line-summary.md') return 0;
+  if (lowerName.endsWith('.md')) return 1;
+  if (lowerName.endsWith('.json')) return 2;
+  return 3;
+}
+
+async function listFingerprintReports(relativeFingerprintPath) {
+  var files = await listImmediateFiles(FINGERPRINTS_ROOT, path.join(relativeFingerprintPath, 'reports'));
+  return files.filter(function(file) {
+    return ['.md', '.txt', '.json'].indexOf(file.ext) >= 0;
+  }).sort(function(a, b) {
+    return getReportPriority(a.name) - getReportPriority(b.name) || a.name.localeCompare(b.name);
+  });
+}
+
+function buildCodexChatPrompt(userPrompt, options) {
+  var workdir = options && options.workdir ? options.workdir : DEFAULT_WORKDIR;
+  var enginePath = options && options.enginePath ? options.enginePath : UE_ENGINE_PATH;
+  return [
+    '当前工程上下文：',
+    '项目工作目录：' + (workdir || '-'),
+    'UE 引擎目录：' + (enginePath || '-'),
+    '',
+    '请在分析和修改代码时优先使用上述路径。用户消息如下：',
+    '',
+    String(userPrompt || ''),
+  ].join('\n');
+}
+
+function resolveCodexProxy(proxyValue) {
+  return RepairModule.resolveCodexProxy(proxyValue || DEFAULT_PROXY);
+}
+
+module.exports = {
+  ROOT_DIR: ROOT_DIR,
+  FINGERPRINTS_ROOT: FINGERPRINTS_ROOT,
+  DEFAULT_WORKDIR: DEFAULT_WORKDIR,
+  UE_ENGINE_PATH: UE_ENGINE_PATH,
+  toSafeAbsolute: toSafeAbsolute,
+  normalizeFingerprintPath: normalizeFingerprintPath,
+  formatChatSessionId: formatChatSessionId,
+  listImmediateDirectories: listImmediateDirectories,
+  listImmediateFiles: listImmediateFiles,
+  listTopLevelMergedDirectories: listTopLevelMergedDirectories,
+  buildFingerprintStatus: buildFingerprintStatus,
+  readRepairStatus: readRepairStatus,
+  readFingerprintMeta: readFingerprintMeta,
+  writeFingerprintMeta: writeFingerprintMeta,
+  listFingerprintReports: listFingerprintReports,
+  buildCodexChatPrompt: buildCodexChatPrompt,
+  resolveCodexProxy: resolveCodexProxy,
+};