bgrun 3.10.1 → 3.10.2

package/dashboard/app/api/guard/route.ts

@@ -0,0 +1,50 @@
+/**
+ * POST /api/guard — Toggle BGR_KEEP_ALIVE for a process
+ * Body: { name: string, enabled: boolean }
+ * 
+ * When enabled=true, the built-in guard will auto-restart this process if it dies.
+ * When enabled=false, the process is left alone.
+ */
+import { getProcess, updateProcessEnv } from '../../../src/db';
+
+export async function POST(req: Request) {
+    try {
+        const body = await req.json() as { name: string; enabled: boolean };
+        if (!body.name) {
+            return Response.json({ error: 'Missing process name' }, { status: 400 });
+        }
+
+        const proc = getProcess(body.name);
+        if (!proc) {
+            return Response.json({ error: `Process "${body.name}" not found` }, { status: 404 });
+        }
+
+        // Parse existing env
+        let env: Record<string, string> = {};
+        if (proc.env) {
+            try { env = JSON.parse(proc.env); } catch { env = {}; }
+        }
+
+        // Toggle BGR_KEEP_ALIVE
+        if (body.enabled) {
+            env.BGR_KEEP_ALIVE = 'true';
+        } else {
+            delete env.BGR_KEEP_ALIVE;
+        }
+
+        // Save back
+        updateProcessEnv(body.name, JSON.stringify(env));
+
+        return Response.json({
+            ok: true,
+            name: body.name,
+            guarded: body.enabled
+        });
+    } catch (err: any) {
+        return Response.json({ error: err.message }, { status: 500 });
+    }
+}
+
+export async function GET() {
+    return Response.json({ error: 'Use POST to toggle guard' }, { status: 405 });
+}

package/dist/index.js

@@ -406,6 +406,7 @@ var init_utils = __esm(() => {
 var exports_db = {};
 __export(exports_db, {
   updateProcessPid: () => updateProcessPid,
+  updateProcessEnv: () => updateProcessEnv,
   retryDatabaseOperation: () => retryDatabaseOperation,
   removeProcessByName: () => removeProcessByName,
   removeProcess: () => removeProcess,
@@ -459,6 +460,12 @@ function removeAllProcesses() {
     db.process.delete(p.id);
   }
 }
+function updateProcessEnv(name, envJson) {
+  const proc = db.process.select().where({ name }).limit(1).get();
+  if (proc) {
+    db.process.update(proc.id, { env: envJson });
+  }
+}
 function getDbInfo() {
   return {
     dbPath,
@@ -753,9 +760,18 @@ function startGuard() {
       for (const proc of processes) {
         if (GUARD_SKIP_NAMES.has(proc.name))
           continue;
+        const env = proc.env ? typeof proc.env === "string" ? (() => {
+          try {
+            return JSON.parse(proc.env);
+          } catch {
+            return {};
+          }
+        })() : proc.env : {};
+        if (env.BGR_KEEP_ALIVE !== "true")
+          continue;
         const alive = await isProcessRunning(proc.pid, proc.command);
         if (!alive) {
-          console.log(`[guard] \u26A0 Process "${proc.name}" (PID ${proc.pid}) is dead, restarting...`);
+          console.log(`[guard] \u26A0 Guarded process "${proc.name}" (PID ${proc.pid}) is dead, restarting...`);
           try {
             await handleRun({
               action: "run",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bgrun",
-  "version": "3.10.1",
+  "version": "3.10.2",
   "description": "bgrun — A lightweight process manager for Bun",
   "type": "module",
   "main": "./src/api.ts",

package/src/db.ts

@@ -119,6 +119,14 @@ export function removeAllProcesses() {
     }
 }
 
+/** Update the stored env JSON for a process (used by guard toggle) */
+export function updateProcessEnv(name: string, envJson: string) {
+    const proc = db.process.select().where({ name }).limit(1).get();
+    if (proc) {
+        db.process.update(proc.id, { env: envJson });
+    }
+}
+
 // =============================================================================
 // DEBUG / INFO
 // =============================================================================

package/src/server.ts

@@ -44,15 +44,15 @@ export async function startServer() {
  * Built-in Process Guard
  * 
  * Runs as a background loop inside the dashboard process.
- * Every GUARD_INTERVAL_MS, it checks all registered bgrun processes.
- * If any process is dead (PID not running), it auto-restarts it using
- * handleRun with force=true (same as `bgrun --restart <name>`).
+ * Every GUARD_INTERVAL_MS, checks processes with BGR_KEEP_ALIVE=true
+ * in their env and auto-restarts any that died.
  * 
- * Why here and not as a separate process?
- * - No external dependency — the dashboard IS the guardian
- * - If the dashboard is running, all processes are monitored
- * - If the dashboard dies, `bgrun --dashboard` will restart everything
- * - Zero configuration — just works
+ * Only guarded processes (opted-in via dashboard toggle or env var) are
+ * monitored. Other processes are left alone even if they crash.
+ * 
+ * Toggle guard per-process:
+ *   - Dashboard UI: click the shield icon on any process row
+ *   - CLI: set BGR_KEEP_ALIVE=true in the process env/config
  */
 function startGuard() {
     console.log(`[guard] ✓ Built-in process guard started (checking every ${GUARD_INTERVAL_MS / 1000}s)`);
@@ -66,9 +66,13 @@ function startGuard() {
                 // Skip the dashboard itself
                 if (GUARD_SKIP_NAMES.has(proc.name)) continue;
 
+                // Only guard processes with BGR_KEEP_ALIVE=true
+                const env = proc.env ? (typeof proc.env === 'string' ? (() => { try { return JSON.parse(proc.env); } catch { return {}; } })() : proc.env) : {};
+                if (env.BGR_KEEP_ALIVE !== 'true') continue;
+
                 const alive = await isProcessRunning(proc.pid, proc.command);
                 if (!alive) {
-                    console.log(`[guard] ⚠ Process "${proc.name}" (PID ${proc.pid}) is dead, restarting...`);
+                    console.log(`[guard] ⚠ Guarded process "${proc.name}" (PID ${proc.pid}) is dead, restarting...`);
                     try {
                         await handleRun({
                             action: 'run',