backtrace-console 0.0.1 → 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

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+'use strict';
+
+var path = require('node:path');
+var fs = require('node:fs');
+var { spawn } = require('node:child_process');
+
+// 在当前工作目录下查找项目入口
+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') {
+  // 前台运行，加载 .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);
+      process.exit(0);
+    }
+    fs.unlinkSync(PID_FILE);
+  }
+
+  var logFd = fs.openSync(LOG_FILE, 'a');
+  var child = spawn(process.execPath, [WWW], {
+    detached: true,
+    stdio: ['ignore', logFd, logFd],
+    env: process.env,
+    cwd: CWD,
+  });
+  child.unref();
+  fs.writeFileSync(PID_FILE, String(child.pid), 'utf8');
+  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] 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] 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);
+  } catch (err) {
+    console.error('[backtrace-server] failed to stop:', err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+if (cmd === 'status') {
+  if (!fs.existsSync(PID_FILE)) {
+    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] running, pid=' + statusPid);
+  } else {
+    console.log('[backtrace-server] not running (stale pid=' + statusPid + ')');
+    fs.unlinkSync(PID_FILE);
+  }
+  process.exit(0);
+}
+
+console.log([
+  'Usage:',
+  '  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; }
+}

package/package.json

@@ -1,29 +1,30 @@
 {
   "name": "backtrace-console",
-  "version": "0.0.1",
-  "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": {
     "start": "node ./bin/www",
-    "backtrace": "node ./bin/backtrace-cli.js"
+    "backtrace": "node ./bin/backtrace-cli.js",
+    "server:run": "node ./bin/backtrace-server.js run",
+    "server:start": "node ./bin/backtrace-server.js start",
+    "server:stop": "node ./bin/backtrace-server.js stop",
+    "server:status": "node ./bin/backtrace-server.js status"
   },
-  "dependencies": {
-    "@openai/codex-sdk": "^0.118.0",
+  "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,22 +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());
-app.use(express.urlencoded({ extended: false }));
-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,90 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Module dependencies.
- */
-
-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);
-
-/**
- * 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,
-};