backtrace-console 0.0.2 → 0.0.4

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,66 +2,80 @@
 
 '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');
+// 包自带的 bin/www，__dirname 指向全局安装目录下的 bin/
+var PKG_ROOT = path.resolve(__dirname, '..');
+var WWW = path.join(PKG_ROOT, 'bin', 'www');
+
+// PID/LOG 放在用户工作目录，方便多项目隔离
+var CWD = process.cwd();
+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') {
-  // 前台运行，直接 require www（同进程）
-  require('./www');
+  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);
   }
 
+  // 把当前目录的 .env 传给子进程
+  var env = Object.assign({}, process.env);
+  try {
+    var dotenvPath = path.join(CWD, '.env');
+    if (fs.existsSync(dotenvPath)) {
+      var lines = fs.readFileSync(dotenvPath, 'utf8').split('\n');
+      lines.forEach(function(line) {
+        var m = line.match(/^\s*([^#=\s][^=]*?)\s*=\s*(.*?)\s*$/);
+        if (m && !env[m[1]]) env[m[1]] = m[2].replace(/^['"]|['"]$/g, '');
+      });
+    }
+  } catch (_) {}
+
   var logFd = fs.openSync(LOG_FILE, 'a');
   var child = spawn(process.execPath, [WWW], {
     detached: true,
     stdio: ['ignore', logFd, logFd],
-    env: process.env,
-    cwd: ROOT,
+    env: env,
+    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 +83,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,7 +98,7 @@ if (cmd === 'status') {
 
 console.log([
   'Usage:',
-  '  backtrace-server run     前台启动服务器',
+  '  backtrace-server run     前台启动（Ctrl+C 停止）',
   '  backtrace-server start   后台守护进程启动',
   '  backtrace-server stop    停止后台进程',
   '  backtrace-server status  查看运行状态',
@@ -92,10 +106,5 @@ console.log([
 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,22 +1,21 @@
 {
   "name": "backtrace-console",
-  "version": "0.0.2",
-  "description": "CLI for querying Backtrace fingerprints, collecting artifacts, and generating repair plans.",
+  "version": "0.0.4",
+  "description": "CLI server manager for backtrace-console — run/start/stop the Express server.",
   "private": false,
   "files": [
+    "bin/backtrace-server.js",
+    "bin/www",
     "app.js",
-    "bin",
     "lib",
     "public",
     "routes"
   ],
   "bin": {
-    "backtrace": "bin/backtrace-cli.js",
     "backtrace-server": "bin/backtrace-server.js"
   },
   "scripts": {
     "start": "node ./bin/www",
-    "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",
@@ -27,7 +26,7 @@
     "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/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);
-});