@foxden-app/foxclaw 0.5.2 → 0.5.3

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.3 - 2026-06-04
+
+### 中文
+- 修复 0.5.2 中 `/update` 完成回报丢失的问题：Linux 自升级子进程现在通过独立的 user systemd transient service 运行，不再留在 `foxclaw.service` control group 里，因此 `KillMode=control-group` 重启服务时不会提前杀掉 updater。
+- 保留 `KillMode=control-group` 的 app-server 清理能力，同时让升级进程能在服务重启后继续写入完成状态，由新服务启动后的轮询发送 Telegram 成功/失败回报。
+
+### English
+- Fixed missing `/update` completion reports in 0.5.2: on Linux the self-update worker now runs in a separate user systemd transient service instead of the `foxclaw.service` control group, so `KillMode=control-group` no longer kills the updater during service restart.
+- Kept `KillMode=control-group` app-server cleanup while allowing the updater to write its final status after restart; the newly started service polls that status and sends the Telegram success/failure report.
+
 ## 0.5.2 - 2026-06-04
 
 ### 中文

package/dist/update.d.ts

@@ -40,6 +40,12 @@ interface PerformSelfUpdateOptions {
     codexCliBin?: string;
     env?: NodeJS.ProcessEnv;
 }
+export interface SelfUpdateLaunchCommand {
+    command: string;
+    args: string[];
+    env: NodeJS.ProcessEnv;
+    viaSystemdRun: boolean;
+}
 export interface SelfUpdateOutcome {
     ok: boolean;
     fromVersion: string;
@@ -53,5 +59,16 @@ export declare function resolveCodexUpdateInstaller(codexCliBin: string, nodePat
 export declare function readSelfUpdateStatus(statusFile: string): SelfUpdateStatus | null;
 export declare function writeSelfUpdateStatus(statusFile: string, status: SelfUpdateStatus): void;
 export declare function createSelfUpdateRuntime(options: CreateSelfUpdateRuntimeOptions): SelfUpdateRuntime;
+export declare function buildSelfUpdateLaunchCommand(options: {
+    entryPoint: string;
+    nodePath: string;
+    statusFile: string;
+    logPath: string;
+    codexCliBin?: string;
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+    systemdRunPath?: string | null;
+    unitName?: string;
+}): SelfUpdateLaunchCommand;
 export declare function performSelfUpdate(options: PerformSelfUpdateOptions): SelfUpdateOutcome;
 export {};

package/dist/update.js

@@ -171,12 +171,33 @@ export function createSelfUpdateRuntime(options) {
             fs.mkdirSync(path.dirname(options.logPath), { recursive: true });
             const logFd = fs.openSync(options.logPath, 'a', 0o600);
             try {
-                const child = spawn(options.nodePath, [options.entryPoint, 'update', '--notification-file', statusFile], {
-                    detached: true,
-                    stdio: ['ignore', logFd, logFd],
-                    env: options.codexCliBin ? { ...process.env, CODEX_CLI_BIN: options.codexCliBin } : process.env,
+                const launch = buildSelfUpdateLaunchCommand({
+                    entryPoint: options.entryPoint,
+                    nodePath: options.nodePath,
+                    statusFile,
+                    logPath: options.logPath,
+                    ...(options.codexCliBin ? { codexCliBin: options.codexCliBin } : {}),
                 });
-                child.unref();
+                if (launch.viaSystemdRun) {
+                    const result = spawnSync(launch.command, launch.args, {
+                        stdio: ['ignore', logFd, logFd],
+                        env: launch.env,
+                    });
+                    if (result.error) {
+                        throw result.error;
+                    }
+                    if (result.status !== 0) {
+                        throw new Error(`${launch.command} ${launch.args.join(' ')} exited with status ${result.status ?? 'unknown'}.`);
+                    }
+                }
+                else {
+                    const child = spawn(launch.command, launch.args, {
+                        detached: true,
+                        stdio: ['ignore', logFd, logFd],
+                        env: launch.env,
+                    });
+                    child.unref();
+                }
             }
             catch (error) {
                 writeSelfUpdateStatus(statusFile, {
@@ -205,6 +226,40 @@ export function createSelfUpdateRuntime(options) {
         },
     };
 }
+export function buildSelfUpdateLaunchCommand(options) {
+    const env = options.codexCliBin
+        ? { ...(options.env ?? process.env), CODEX_CLI_BIN: options.codexCliBin }
+        : { ...(options.env ?? process.env) };
+    const updateArgs = [options.entryPoint, 'update', '--notification-file', options.statusFile];
+    const platform = options.platform ?? process.platform;
+    const systemdRunPath = options.systemdRunPath === undefined
+        ? resolveCommand('systemd-run', env)
+        : options.systemdRunPath;
+    if (platform === 'linux' && systemdRunPath) {
+        const unitName = options.unitName ?? `foxclaw-update-${process.pid}-${Date.now()}`;
+        return {
+            command: systemdRunPath,
+            args: [
+                '--user',
+                '--collect',
+                `--unit=${unitName}`,
+                `--property=StandardOutput=append:${options.logPath}`,
+                `--property=StandardError=append:${options.logPath}`,
+                ...systemdSetEnvArgs(env),
+                options.nodePath,
+                ...updateArgs,
+            ],
+            env,
+            viaSystemdRun: true,
+        };
+    }
+    return {
+        command: options.nodePath,
+        args: updateArgs,
+        env,
+        viaSystemdRun: false,
+    };
+}
 export function performSelfUpdate(options) {
     const env = options.env ?? process.env;
     let toVersion = null;
@@ -295,6 +350,31 @@ function executableCandidates(commandName, nodePath, env, preferred = []) {
         ...(env.PATH || '').split(path.delimiter).filter(Boolean).map((dir) => path.join(dir, commandName)),
     ].filter((candidate, index, all) => candidate && all.indexOf(candidate) === index);
 }
+function resolveCommand(commandName, env) {
+    for (const directory of (env.PATH || '').split(path.delimiter).filter(Boolean)) {
+        const candidate = path.join(directory, commandName);
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    for (const fallback of ['/usr/bin', '/bin', '/usr/local/bin']) {
+        const candidate = path.join(fallback, commandName);
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+function systemdSetEnvArgs(env) {
+    return Object.entries(env)
+        .filter((entry) => {
+        const [key, value] = entry;
+        return /^[A-Za-z_][A-Za-z0-9_]*$/.test(key)
+            && typeof value === 'string'
+            && !value.includes('\0');
+    })
+        .map(([key, value]) => `--setenv=${key}=${value}`);
+}
 function buildInstallerEnv(entryPoint, installer, env) {
     const pnpmHome = installer.manager === 'pnpm'
         ? installer.pnpmHome ?? inferPnpmHomeFromEntryPoint(entryPoint)

package/package.json

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