@foxden-app/foxclaw 0.5.13 → 0.5.14

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable FoxClaw changes are listed here. Each release note is bilingual so GitHub Releases and the npm package are useful to both Chinese and English readers.
 
+## 0.5.14 - 2026-06-08
+
+### 中文
+- Linux `foxclaw start` / `foxclaw restart` / `install-systemd` 现在如果检测到自己正运行在 `foxclaw.service` cgroup 内，会通过一次性的 `systemd-run --user` helper 在服务外执行重启，避免命令执行者被自己重启时杀掉导致半截输出或不确定状态。
+- 继续保留 systemd 作为稳定守护层：主 service 仍由 `Restart=always`、`KillMode=control-group` 和 user linger 保活；重启编排则交给短生命周期 helper，避免再引入一个更脆弱的常驻 Node 守护进程。
+
+### English
+- On Linux, `foxclaw start`, `foxclaw restart`, and `install-systemd` now detect when they are running inside the `foxclaw.service` cgroup and delegate the actual restart to a one-shot `systemd-run --user` helper outside that cgroup, avoiding half-written output or uncertain state when the caller would otherwise kill itself.
+- systemd remains the stable supervisor with `Restart=always`, `KillMode=control-group`, and user linger; restart orchestration moves to a short-lived helper instead of adding another long-running Node watchdog.
+
 ## 0.5.13 - 2026-06-08
 
 ### 中文

package/dist/main.js

@@ -10,7 +10,7 @@ import { fileURLToPath } from 'node:url';
 import { APP_HOME, DEFAULT_CODEX_TELEGRAM_HOME, DEFAULT_ENV_PATH, DEFAULT_LOG_PATH, DEFAULT_STATUS_PATH, getLoadedEnvPath, loadConfig, loadEnv, } from './config.js';
 import { acquireProcessLock, LockHeldError } from './lock.js';
 import { readRuntimeStatus, writeRuntimeStatus } from './runtime.js';
-import { buildFoxclawSystemdUnitText, refreshFoxclawExecStartDropIns, removeFoxclawExecStartDropIns } from './systemd.js';
+import { buildFoxclawSystemdUnitText, buildSystemdRestartHelperArgs, cgroupContainsSystemdUnit, refreshFoxclawExecStartDropIns, removeFoxclawExecStartDropIns, } from './systemd.js';
 import { createSelfUpdateRuntime, inferPnpmHomeFromEntryPoint, performSelfUpdate, readSelfUpdateStatus, writeSelfUpdateStatus, } from './update.js';
 const rawCommand = process.argv[2];
 const command = rawCommand || 'serve';
@@ -1305,13 +1305,46 @@ function installSystemd() {
     ensureSystemdUserLingerEnabled();
     spawnChecked('systemctl', ['--user', 'daemon-reload']);
     spawnChecked('systemctl', ['--user', 'enable', unitName]);
+    restartSystemdUnit(unitName);
+    console.log(`Installed ${unitPath}`);
+    console.log(`Status: systemctl --user status ${unitName}`);
+    console.log(`Logs:   journalctl --user -u ${unitName} -f`);
+}
+function restartSystemdUnit(unitName) {
+    if (isCurrentProcessInSystemdUnit(unitName)) {
+        const systemdRun = resolveCommand('systemd-run');
+        if (systemdRun) {
+            const helperUnitName = `foxclaw-restart-${process.pid}-${Date.now()}`;
+            const result = spawnSync(systemdRun, buildSystemdRestartHelperArgs({
+                unitName,
+                helperUnitName,
+                delaySeconds: 1,
+            }), { stdio: 'inherit' });
+            if (result.status === 0) {
+                console.log(`[OK] scheduled ${unitName} restart via transient systemd helper: ${helperUnitName}`);
+                return;
+            }
+            console.log('[WARN] transient systemd restart helper failed; falling back to direct restart.');
+        }
+        else {
+            console.log('[WARN] systemd-run not found; falling back to direct restart.');
+        }
+    }
     const restarted = spawnSync('systemctl', ['--user', 'restart', unitName], { stdio: 'inherit' });
     if (restarted.status !== 0) {
         spawnChecked('systemctl', ['--user', 'start', unitName]);
     }
-    console.log(`Installed ${unitPath}`);
-    console.log(`Status: systemctl --user status ${unitName}`);
-    console.log(`Logs:   journalctl --user -u ${unitName} -f`);
+}
+function isCurrentProcessInSystemdUnit(unitName) {
+    if (process.platform !== 'linux') {
+        return false;
+    }
+    try {
+        return cgroupContainsSystemdUnit(fs.readFileSync('/proc/self/cgroup', 'utf8'), unitName);
+    }
+    catch {
+        return false;
+    }
 }
 function ensureSystemdUserLingerEnabled() {
     if (process.platform !== 'linux') {

package/dist/systemd.d.ts

@@ -11,7 +11,14 @@ export interface FoxclawSystemdUnitTextOptions {
     pathValue: string;
     execStart: string;
 }
+export interface SystemdRestartHelperOptions {
+    unitName: string;
+    helperUnitName: string;
+    delaySeconds: number;
+}
 export declare function buildFoxclawSystemdUnitText(options: FoxclawSystemdUnitTextOptions): string;
+export declare function cgroupContainsSystemdUnit(cgroupText: string, unitName: string): boolean;
+export declare function buildSystemdRestartHelperArgs(options: SystemdRestartHelperOptions): string[];
 export declare function refreshFoxclawExecStartDropIns(userSystemdDir: string, unitName: string, escapedEntryPoint: string): SystemdDropInUpdate[];
 export declare function removeFoxclawExecStartDropIns(userSystemdDir: string, unitName: string): SystemdDropInUpdate[];
 export declare function refreshFoxclawExecStartText(text: string, escapedEntryPoint: string): {

package/dist/systemd.js

@@ -29,6 +29,23 @@ KillMode=control-group
 WantedBy=default.target
 `;
 }
+export function cgroupContainsSystemdUnit(cgroupText, unitName) {
+    const escapedUnitName = unitName.replace(/-/g, '\\x2d');
+    return cgroupText
+        .split(/\r?\n/)
+        .some((line) => line.includes(`/${unitName}`) || line.includes(`/${escapedUnitName}`));
+}
+export function buildSystemdRestartHelperArgs(options) {
+    return [
+        '--user',
+        '--collect',
+        `--unit=${options.helperUnitName}`,
+        '--description=Restart FoxClaw service outside foxclaw.service cgroup',
+        '/bin/sh',
+        '-lc',
+        `sleep ${Math.max(0, options.delaySeconds)}; exec systemctl --user restart ${options.unitName}`,
+    ];
+}
 export function refreshFoxclawExecStartDropIns(userSystemdDir, unitName, escapedEntryPoint) {
     const dropInDir = path.join(userSystemdDir, `${unitName}.d`);
     let names;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxden-app/foxclaw",
-  "version": "0.5.13",
+  "version": "0.5.14",
   "description": "Foxden local execution claw for controlling Codex from trusted chat interfaces.",
   "type": "module",
   "main": "dist/main.js",