backtrace-console 0.0.2 → 0.0.3

package/README.md

@@ -1,6 +1,6 @@
 # backtrace-console
 
-CLI for querying Backtrace fingerprints, collecting artifacts, and generating repair plans.
+Server manager for [backtrace-console](https://github.com/your-org/backtrace-console) — start, stop, and manage the Express server process from the command line.
 
 ## Install
 
@@ -8,15 +8,32 @@ CLI for querying Backtrace fingerprints, collecting artifacts, and generating re
 npm install -g backtrace-console
 ```
 
-## Commands
+## Usage
+
+Run all commands from the **backtrace-console project root directory**.
 
 ```bash
-backtrace list
-backtrace fingerprint --fingerprint <value>
-backtrace collect --fingerprint <value>
-backtrace summarize-errors --fingerprint <value>
-backtrace fix-plan --fingerprint <value>
-backtrace apply-fix --fingerprint <value>
+# 前台启动（Ctrl+C 停止）
+backtrace-server run
+
+# 后台守护进程启动
+backtrace-server start
+
+# 停止后台进程
+backtrace-server stop
+
+# 查看运行状态
+backtrace-server status
 ```
 
-Run `backtrace --help` for the full option list.
+## How it works
+
+- `run` — loads `.env` in the current directory and starts `bin/www` in the foreground.
+- `start` — spawns `bin/www` as a detached background process. PID is saved to `.backtrace-server.pid` and logs are appended to `.backtrace-server.log`.
+- `stop` — reads `.backtrace-server.pid` and sends `SIGTERM` to the process.
+- `status` — checks whether the recorded PID is still alive.
+
+## Requirements
+
+- Node.js 18+
+- Must be run inside a `backtrace-console` project directory (i.e. `bin/www` must exist).

package/bin/backtrace-server.js

@@ -2,31 +2,38 @@
 
 'use strict';
 
-require('dotenv').config();
-
 var path = require('node:path');
 var fs = require('node:fs');
 var { spawn } = require('node:child_process');
 
-var ROOT = path.resolve(__dirname, '..');
-var PID_FILE = path.join(ROOT, '.backtrace-server.pid');
-var LOG_FILE = path.join(ROOT, '.backtrace-server.log');
-var WWW = path.join(__dirname, 'www');
+// 在当前工作目录下查找项目入口
+var CWD = process.cwd();
+var WWW = path.join(CWD, 'bin', 'www');
+var PID_FILE = path.join(CWD, '.backtrace-server.pid');
+var LOG_FILE = path.join(CWD, '.backtrace-server.log');
 
 var cmd = process.argv[2];
 
+if (cmd === 'run' || cmd === 'start') {
+  if (!fs.existsSync(WWW)) {
+    console.error('[backtrace-server] 未找到入口文件: ' + WWW);
+    console.error('[backtrace-server] 请在 backtrace-console 项目根目录下运行此命令');
+    process.exit(1);
+  }
+}
+
 if (cmd === 'run') {
-  // 前台运行，直接 require www（同进程）
-  require('./www');
+  // 前台运行，加载 .env 后直接 require 入口
+  try { require('dotenv').config({ path: path.join(CWD, '.env') }); } catch (_) {}
+  require(WWW);
   return;
 }
 
 if (cmd === 'start') {
-  // 检查是否已在运行
   if (fs.existsSync(PID_FILE)) {
     var existingPid = parseInt(fs.readFileSync(PID_FILE, 'utf8').trim(), 10);
     if (existingPid && isRunning(existingPid)) {
-      console.log('[backtrace] server already running, pid=' + existingPid);
+      console.log('[backtrace-server] already running, pid=' + existingPid);
       process.exit(0);
     }
     fs.unlinkSync(PID_FILE);
@@ -37,31 +44,31 @@ if (cmd === 'start') {
     detached: true,
     stdio: ['ignore', logFd, logFd],
     env: process.env,
-    cwd: ROOT,
+    cwd: CWD,
   });
   child.unref();
   fs.writeFileSync(PID_FILE, String(child.pid), 'utf8');
-  console.log('[backtrace] server started, pid=' + child.pid + ', log=' + LOG_FILE);
+  console.log('[backtrace-server] started, pid=' + child.pid + ', log=' + LOG_FILE);
   process.exit(0);
 }
 
 if (cmd === 'stop') {
   if (!fs.existsSync(PID_FILE)) {
-    console.log('[backtrace] server is not running (no pid file)');
+    console.log('[backtrace-server] not running (no pid file)');
     process.exit(0);
   }
   var pid = parseInt(fs.readFileSync(PID_FILE, 'utf8').trim(), 10);
   if (!pid || !isRunning(pid)) {
-    console.log('[backtrace] server is not running (pid=' + pid + ')');
+    console.log('[backtrace-server] not running (pid=' + pid + ')');
     fs.unlinkSync(PID_FILE);
     process.exit(0);
   }
   try {
     process.kill(pid, 'SIGTERM');
     fs.unlinkSync(PID_FILE);
-    console.log('[backtrace] server stopped, pid=' + pid);
+    console.log('[backtrace-server] stopped, pid=' + pid);
   } catch (err) {
-    console.error('[backtrace] failed to stop server:', err.message);
+    console.error('[backtrace-server] failed to stop:', err.message);
     process.exit(1);
   }
   process.exit(0);
@@ -69,14 +76,14 @@ if (cmd === 'stop') {
 
 if (cmd === 'status') {
   if (!fs.existsSync(PID_FILE)) {
-    console.log('[backtrace] server is not running');
+    console.log('[backtrace-server] not running');
     process.exit(0);
   }
   var statusPid = parseInt(fs.readFileSync(PID_FILE, 'utf8').trim(), 10);
   if (statusPid && isRunning(statusPid)) {
-    console.log('[backtrace] server is running, pid=' + statusPid);
+    console.log('[backtrace-server] running, pid=' + statusPid);
   } else {
-    console.log('[backtrace] server is not running (stale pid=' + statusPid + ')');
+    console.log('[backtrace-server] not running (stale pid=' + statusPid + ')');
     fs.unlinkSync(PID_FILE);
   }
   process.exit(0);
@@ -84,18 +91,15 @@ if (cmd === 'status') {
 
 console.log([
   'Usage:',
-  '  backtrace-server run     前台启动服务器',
+  '  backtrace-server run     前台启动（Ctrl+C 停止）',
   '  backtrace-server start   后台守护进程启动',
   '  backtrace-server stop    停止后台进程',
   '  backtrace-server status  查看运行状态',
+  '',
+  '请在 backtrace-console 项目根目录下运行。',
 ].join('\n'));
 process.exit(1);
 
 function isRunning(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (_) {
-    return false;
-  }
+  try { process.kill(pid, 0); return true; } catch (_) { return false; }
 }

package/package.json

@@ -1,17 +1,12 @@
 {
   "name": "backtrace-console",
-  "version": "0.0.2",
-  "description": "CLI for querying Backtrace fingerprints, collecting artifacts, and generating repair plans.",
+  "version": "0.0.3",
+  "description": "CLI server manager for backtrace-console — run/start/stop the Express server.",
   "private": false,
   "files": [
-    "app.js",
-    "bin",
-    "lib",
-    "public",
-    "routes"
+    "bin/backtrace-server.js"
   ],
   "bin": {
-    "backtrace": "bin/backtrace-cli.js",
     "backtrace-server": "bin/backtrace-server.js"
   },
   "scripts": {
@@ -22,12 +17,12 @@
     "server:stop": "node ./bin/backtrace-server.js stop",
     "server:status": "node ./bin/backtrace-server.js status"
   },
-  "dependencies": {
+  "devDependencies": {
     "@openai/codex-sdk": "^0.128.0",
     "cookie-parser": "~1.4.4",
     "debug": "~2.6.9",
     "dotenv": "^17.4.1",
-    "express": "~4.16.1",
+    "express": "~4.21.0",
     "morgan": "~1.9.1",
     "node-cron": "^4.2.1",
     "undici": "^7.24.8"

package/app.js

@@ -1,23 +0,0 @@
-var express = require('express');
-var path = require('path');
-var cookieParser = require('cookie-parser');
-var logger = require('morgan');
-
-var indexRouter = require('./routes/index');
-var usersRouter = require('./routes/users');
-var backtraceRouter = require('./routes/backtrace');
-
-var app = express();
-
-app.use(logger('dev'));
-app.use(express.json({ limit: '50mb' }));
-app.use(express.urlencoded({ extended: false, limit: '50mb' }));
-app.use(cookieParser());
-app.use(express.static(path.join(__dirname, 'public')));
-
-app.use('/', indexRouter);
-app.use('/users', usersRouter);
-
-app.use('/api/backtrace', backtraceRouter);
-
-module.exports = app;

package/bin/backtrace-cli.js

@@ -1,22 +0,0 @@
-#!/usr/bin/env node
-
-require("dotenv").config();
-
-const { parseCliArgs, printCliUsage } = require("../lib/cli/args");
-const { runCliCommand } = require("../lib/cli/run");
-
-async function main() {
-  const parsed = parseCliArgs(process.argv.slice(2));
-  if (parsed.help) {
-    printCliUsage();
-    return;
-  }
-  await runCliCommand(parsed.options);
-  process.exit(0);
-}
-
-main().catch((error) => {
-  console.error("backtrace-cli failed:");
-  console.error(error instanceof Error ? error.stack || error.message : error);
-  process.exit(1);
-});

package/bin/www

@@ -1,93 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Module dependencies.
- */
-require("dotenv").config();
-
-var app = require('../app');
-var debug = require('debug')('backtrace-console:server');
-var http = require('http');
-
-/**
- * Get port from environment and store in Express.
- */
-
-var port = normalizePort(process.env.PORT || '3000');
-app.set('port', port);
-
-/**
- * Create HTTP server.
- */
-
-var server = http.createServer(app);
-
-/**
- * Listen on provided port, on all network interfaces.
- */
-
-server.listen(port);
-server.on('error', onError);
-server.on('listening', onListening);
-
-require('../lib/scheduler').start();
-
-/**
- * Normalize a port into a number, string, or false.
- */
-
-function normalizePort(val) {
-  var port = parseInt(val, 10);
-
-  if (isNaN(port)) {
-    // named pipe
-    return val;
-  }
-
-  if (port >= 0) {
-    // port number
-    return port;
-  }
-
-  return false;
-}
-
-/**
- * Event listener for HTTP server "error" event.
- */
-
-function onError(error) {
-  if (error.syscall !== 'listen') {
-    throw error;
-  }
-
-  var bind = typeof port === 'string'
-    ? 'Pipe ' + port
-    : 'Port ' + port;
-
-  // handle specific listen errors with friendly messages
-  switch (error.code) {
-    case 'EACCES':
-      console.error(bind + ' requires elevated privileges');
-      process.exit(1);
-      break;
-    case 'EADDRINUSE':
-      console.error(bind + ' is already in use');
-      process.exit(1);
-      break;
-    default:
-      throw error;
-  }
-}
-
-/**
- * Event listener for HTTP server "listening" event.
- */
-
-function onListening() {
-  var addr = server.address();
-  var bind = typeof addr === 'string'
-    ? 'pipe ' + addr
-    : 'port ' + addr.port;
-  debug('Listening on ' + bind);
-}

package/lib/BacktraceCodexTool.js

@@ -1,32 +0,0 @@
-// 保留历史导入入口，实际能力全部委托给
-// lib/backtrace 和 lib/analysis 下的新模块实现。
-const {
-  DEFAULT_QUERY_URL,
-  DEFAULT_WORKDIR,
-  DEFAULT_PROXY,
-  DEFAULT_SELECT,
-  DEFAULT_LIMIT,
-  DEFAULT_DOWNLOAD_CONCURRENCY,
-  DEFAULT_RETRIES,
-  DEFAULT_STORAGE_DIR,
-} = require("./backtrace/constants");
-const { printUsage, parseArgs, createOptions } = require("./backtrace/options");
-const { printList } = require("./backtrace/analysis");
-const { BacktraceCodexTool, runBacktraceCommand } = require("./backtrace/tool");
-
-module.exports = {
-  BacktraceCodexTool,
-  runBacktraceCommand,
-  createOptions,
-  parseArgs,
-  printUsage,
-  printList,
-  DEFAULT_QUERY_URL,
-  DEFAULT_WORKDIR,
-  DEFAULT_PROXY,
-  DEFAULT_SELECT,
-  DEFAULT_LIMIT,
-  DEFAULT_DOWNLOAD_CONCURRENCY,
-  DEFAULT_RETRIES,
-  DEFAULT_STORAGE_DIR,
-};