helixevo 0.2.36 → 0.2.37

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to HelixEvo are documented here.
 
+## [0.2.37] - 2026-03-23
+
+### Added
+- `helixevo dashboard --background` — run dashboard detached from terminal
+- `helixevo dashboard --stop` — stop a background dashboard
+- PID file tracking at `~/.helix/dashboard.pid`
+- Log file at `~/.helix/dashboard.log`
+
+### Fixed
+- Silence Next.js "multiple lockfiles" warning via `outputFileTracingRoot`
+- Cleaner terminal output during dashboard startup
+
 ## [0.2.36] - 2026-03-23
 
 ### Added — Enhanced Project Setup

package/dashboard/next.config.mjs

@@ -49,6 +49,8 @@ const nextConfig = {
   env: {
     HELIXEVO_VERSION: getVersion(),
   },
+  // Silence "multiple lockfiles" warning
+  outputFileTracingRoot: __dirname,
 }
 
 export default nextConfig

package/dist/cli.js

@@ -12451,7 +12451,7 @@ init_skills();
 init_data();
 var __filename = "/Users/tianchichen/Documents/GitHub/helixevo/src/commands/dashboard.ts";
 var HELIX_DASHBOARD_DIR = join15(homedir3(), ".helix", "dashboard");
-async function dashboardCommand() {
+async function dashboardCommand(options) {
   const dir = prepareDashboard();
   if (!dir) {
     console.error(`  Dashboard not found.
@@ -12473,6 +12473,36 @@ async function dashboardCommand() {
     }
   }
   ensureSkillGraph();
+  if (options.background) {
+    const logFile = join15(homedir3(), ".helix", "dashboard.log");
+    const out = __require("fs").openSync(logFile, "a");
+    const err = __require("fs").openSync(logFile, "a");
+    let currentVersion = VERSION;
+    try {
+      currentVersion = execSync2("helixevo --version 2>/dev/null", { encoding: "utf-8" }).trim() || VERSION;
+    } catch {}
+    const child = spawn2("npx", ["next", "dev", "--port", "3847"], {
+      cwd: dir,
+      stdio: ["ignore", out, err],
+      env: { ...process.env, HELIXEVO_VERSION: currentVersion },
+      detached: true
+    });
+    child.unref();
+    writeFileSync9(join15(homedir3(), ".helix", "dashboard.pid"), String(child.pid));
+    console.log(`  \uD83C\uDF10 HelixEvo Dashboard v${VERSION} running in background`);
+    console.log(`     http://localhost:3847`);
+    console.log(`     Logs: ${logFile}`);
+    console.log(`     Stop: helixevo dashboard --stop
+`);
+    setTimeout(() => {
+      try {
+        const platform = process.platform;
+        const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+        execSync2(`${cmd} http://localhost:3847`, { stdio: "ignore" });
+      } catch {}
+    }, 2000);
+    process.exit(0);
+  }
   console.log(`  \uD83C\uDF10 Starting HelixEvo Dashboard v${VERSION} at http://localhost:3847
 `);
   launchDashboard(dir, true);
@@ -13485,6 +13515,9 @@ function printUpdateBanner(latestVersion) {
 }
 
 // src/cli.ts
+import { join as join20 } from "node:path";
+import { homedir as homedir5 } from "node:os";
+import { existsSync as existsSync16, readFileSync as readFileSync13, rmSync as rmSync3 } from "node:fs";
 var program2 = new Command;
 program2.name("helixevo").description("Self-evolving skill ecosystem for AI agents").version(VERSION).addHelpText("after", `
 Examples:
@@ -13512,7 +13545,23 @@ program2.command("generalize").description("Promote cross-skill patterns to high
 program2.command("specialize").description("Create project-specific skills ↓ --project <name> [--dry-run] [--verbose]").requiredOption("--project <name>", "Project name").option("--dry-run", "Show candidates without applying").option("--verbose", "Show detailed analysis").action(specializeCommand);
 program2.command("graph").description("Skill network [--mermaid] [--obsidian <path>] [--rebuild] [--optimize]").option("--mermaid", "Render as Mermaid diagram in browser").option("--rebuild", "Force rebuild (re-infer relationships via LLM)").option("--obsidian <path>", "Sync to Obsidian vault at path").option("--optimize", "Run network optimization (merge/split/conflict detection)").option("--verbose", "Show detailed analysis").action(graphCommand);
 program2.command("research").description("Proactive research via web [--project <path>] [--dry-run] [--verbose]").option("--project <path>", "Project path for goal extraction").option("--dry-run", "Show discoveries without creating skills").option("--verbose", "Show detailed research steps").option("--max-hypotheses <n>", "Max hypotheses to test", "3").action(researchCommand);
-program2.command("dashboard").description("Open web dashboard at http://localhost:3847").action(dashboardCommand);
+program2.command("dashboard").description("Open web dashboard at http://localhost:3847").option("--background", "Run in background (detach from terminal)").option("--stop", "Stop a background dashboard").action(async (options) => {
+  if (options.stop) {
+    const pidFile = join20(homedir5(), ".helix", "dashboard.pid");
+    if (existsSync16(pidFile)) {
+      const pid = parseInt(readFileSync13(pidFile, "utf-8").trim());
+      try {
+        process.kill(pid, "SIGTERM");
+      } catch {}
+      rmSync3(pidFile);
+      console.log("  Dashboard stopped.");
+    } else {
+      console.log("  No background dashboard running.");
+    }
+    return;
+  }
+  dashboardCommand(options);
+});
 program2.command("status").description("Show frontier, skills, failures, and network health").action(statusCommand);
 program2.command("report").description("Evolution report [--days <n>] [--output <path>]").option("--days <n>", "Report period in days", "1").option("--output <path>", "Output path for report").action(reportCommand);
 program2.command("watch").description("Always-on learning: auto-capture corrections + auto-evolve").option("--project <name>", "Project name for captured failures").option("--events <path>", "Path to events.jsonl (default: ./events.jsonl)").option("--verbose", "Show detailed capture and metrics").option("--no-evolve", "Disable auto-evolution (capture only)").action(watchCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helixevo",
-  "version": "0.2.36",
+  "version": "0.2.37",
   "description": "Self-evolving skill ecosystem for AI agents. Skills and projects co-evolve through multi-judge evaluation and a Pareto frontier.",
   "type": "module",
   "bin": {