backtrace-console 0.0.3 → 0.0.5

package/routes/backtrace-fix-plan.js

@@ -0,0 +1,53 @@
+var express = require('express');
+var RepairModule = require('../lib/backtrace/repair');
+var shared = require('./backtrace-shared');
+
+var router = express.Router();
+
+router.post('/fix-plan/generate', async function(req, res) {
+  var body = req.body || {};
+  var reportPath = body.reportPath;
+  if (!reportPath) {
+    return res.status(400).json({ ok: false, error: 'reportPath is required' });
+  }
+  try {
+    var result = await RepairModule.generateRepairPlan({
+      reportPath: reportPath,
+    }, {
+      rootDir: shared.ROOT_DIR,
+      fingerprintsRoot: shared.FINGERPRINTS_ROOT,
+      workdir: body.workdir || shared.DEFAULT_WORKDIR,
+      proxy: shared.resolveCodexProxy(body.proxy),
+    });
+    return res.json(result);
+  } catch (error) {
+    return res.status(500).json({ ok: false, error: error instanceof Error ? error.message : String(error) });
+  }
+});
+
+router.post('/fix-plan/apply', async function(req, res) {
+  var body = req.body || {};
+  var reportPath = body.reportPath;
+  var planText = body.planText;
+  if (!reportPath || !planText) {
+    return res.status(400).json({ ok: false, error: 'reportPath and planText are required' });
+  }
+  try {
+    var result = await RepairModule.applyRepairPlan({
+      reportPath: reportPath,
+      planText: planText,
+      repairVersion: body.repairVersion,
+      repairPlanPath: body.repairPlanPath,
+    }, {
+      rootDir: shared.ROOT_DIR,
+      fingerprintsRoot: shared.FINGERPRINTS_ROOT,
+      workdir: body.workdir || shared.DEFAULT_WORKDIR,
+      proxy: shared.resolveCodexProxy(body.proxy),
+    });
+    return res.json(result);
+  } catch (error) {
+    return res.status(500).json({ ok: false, error: error instanceof Error ? error.message : String(error) });
+  }
+});
+
+module.exports = router;

package/routes/backtrace-run.js

@@ -0,0 +1,128 @@
+var express = require('express');
+var fs = require('node:fs/promises');
+var path = require('node:path');
+var BacktraceCodexTool = require('../lib/BacktraceCodexTool').BacktraceCodexTool;
+var { BacktraceSession, downloadItemLogs, fetchAttachmentList } = require('../lib/backtrace/query');
+var { createOptions } = require('../lib/backtrace/options');
+var shared = require('./backtrace-shared');
+
+var router = express.Router();
+
+router.post('/run', async function(req, res) {
+  var body = req.body || {};
+  var command = body.command || 'collect-all';
+  var tool = new BacktraceCodexTool();
+  try {
+    var result = await tool.run(command, body);
+    return res.json({ ok: true, command: command, result: result });
+  } catch (error) {
+    return res.status(500).json({ ok: false, command: command, error: error instanceof Error ? error.message : String(error) });
+  }
+});
+
+router.get('/fingerprint', async function(req, res) {
+  var fingerprint = String(req.query.fingerprint || '').trim();
+  if (!fingerprint) {
+    return res.status(400).json({ ok: false, error: 'fingerprint is required' });
+  }
+  try {
+    var relativeFingerprintPath = shared.normalizeFingerprintPath(fingerprint);
+    var result = await shared.readFingerprintMeta(relativeFingerprintPath);
+    if (!result) {
+      return res.status(404).json({ ok: false, error: 'fingerprint not found' });
+    }
+    var reports = await shared.listFingerprintReports(relativeFingerprintPath);
+    result.reportFiles = reports;
+    result.defaultReportPath = reports.length > 0 ? reports[0].path : '';
+    return res.json({ ok: true, command: 'fingerprint', result: result });
+  } catch (error) {
+    return res.status(500).json({ ok: false, command: 'fingerprint', error: error instanceof Error ? error.message : String(error) });
+  }
+});
+
+router.get('/list', async function(req, res) {
+  var tool = new BacktraceCodexTool();
+  var overrides = {
+    from: req.query.from,
+    to: req.query.to,
+    limit: req.query.limit,
+    offset: req.query.offset,
+    select: req.query.select,
+  };
+  try {
+    var result = await tool.list(overrides);
+    return res.json({ ok: true, command: 'list', result: result });
+  } catch (error) {
+    return res.status(500).json({ ok: false, command: 'list', error: error instanceof Error ? error.message : String(error) });
+  }
+});
+
+router.post('/download-object', async function(req, res) {
+  var body = req.body || {};
+  var fp = String(body.fingerprint || '').trim();
+  var objectIdHex = String(body.objectIdHex || '').trim();
+  if (!fp || !objectIdHex) {
+    return res.status(400).json({ ok: false, error: 'fingerprint and objectIdHex are required' });
+  }
+  try {
+    var options = createOptions({ command: 'collect-all', fingerprint: fp });
+    var session = new BacktraceSession(options);
+    await session.login();
+    var item = { objectIdHex: objectIdHex, objectIdDecimal: '', fingerprint: fp, values: { fingerprint: fp } };
+    var result = await downloadItemLogs(session, item, options);
+    return res.json({ ok: true, fingerprint: fp, objectIdHex: objectIdHex, downloadedFiles: result.downloadedFiles, targetDir: result.targetDir });
+  } catch (error) {
+    return res.status(500).json({ ok: false, error: error instanceof Error ? error.message : String(error) });
+  }
+});
+
+router.post('/query-object-attachments', async function(req, res) {
+  var body = req.body || {};
+  var fp = String(body.fingerprint || '').trim();
+  var objectIdHex = String(body.objectIdHex || '').trim();
+  if (!fp || !objectIdHex) {
+    return res.status(400).json({ ok: false, error: 'fingerprint and objectIdHex are required' });
+  }
+  try {
+    var options = createOptions({ command: 'collect-all', fingerprint: fp });
+    var session = new BacktraceSession(options);
+    await session.login();
+
+    // 查询远端附件列表
+    var attachmentResult = await fetchAttachmentList(session, options.queryUrl, objectIdHex);
+    var remoteAttachments = (attachmentResult && attachmentResult.attachments) ? attachmentResult.attachments : [];
+
+    // 读取本地已下载文件
+    var objDir = path.join(shared.FINGERPRINTS_ROOT, fp, 'logs', objectIdHex);
+    var localFiles = await fs.readdir(objDir).catch(function() { return []; });
+    var localFileSet = new Set(localFiles);
+
+    // 合并：逐文件检查本地是否已下载
+    var attachments = remoteAttachments.map(function(att) {
+      return {
+        id: att.id || '',
+        name: att.name || '',
+        size: att.size || 0,
+        content_type: att.content_type || '',
+        downloaded: localFileSet.has(att.name),
+      };
+    });
+
+    // 读取现有 object-meta.json，合并写回
+    var metaPath = path.join(objDir, 'object-meta.json');
+    var existingRaw = await fs.readFile(metaPath, 'utf8').catch(function() { return ''; });
+    var existing = {};
+    if (existingRaw) {
+      try { existing = JSON.parse(existingRaw); } catch (_) { existing = {}; }
+    }
+    var updated = Object.assign({}, existing, { attachments: attachments });
+    await fs.mkdir(objDir, { recursive: true });
+    await fs.writeFile(metaPath, JSON.stringify(updated, null, 2), 'utf8');
+
+    return res.json({ ok: true, fingerprint: fp, objectIdHex: objectIdHex, attachments: attachments });
+  } catch (error) {
+    return res.status(500).json({ ok: false, error: error instanceof Error ? error.message : String(error) });
+  }
+});
+
+module.exports = router;

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,
+};

package/routes/backtrace.js

@@ -0,0 +1,10 @@
+var express = require('express');
+
+var router = express.Router();
+
+router.use(require('./backtrace-files'));
+router.use(require('./backtrace-run'));
+router.use(require('./backtrace-fix-plan'));
+router.use(require('./backtrace-chat'));
+
+module.exports = router;

package/routes/index.js

@@ -0,0 +1,9 @@
+var express = require('express');
+var router = express.Router();
+
+/* GET home page. */
+router.get('/', function(req, res, next) {
+  res.render('index', { title: 'Express' });
+});
+
+module.exports = router;

package/routes/users.js

@@ -0,0 +1,9 @@
+var express = require('express');
+var router = express.Router();
+
+/* GET users listing. */
+router.get('/', function(req, res, next) {
+  res.send('respond with a resource');
+});
+
+module.exports = router;