@foxden-app/foxclaw 0.5.3 → 0.5.4

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.4 - 2026-06-04
+
+### 中文
+- 修复 `/update` 遗留 `self-update.json` pending 后永久显示“升级已经在进行中”的问题：pending 超过 15 分钟会自动转为失败状态，Telegram 会回报失败，下一次 `/update` 可以重新发起。
+- 这个补丁专门兜底 0.5.2 在 `KillMode=control-group` 下被杀掉的旧 updater，以及任何未来被外部中断、没有写完成状态的升级进程。
+
+### English
+- Fixed `/update` getting permanently stuck on "update already running" after a leftover `self-update.json` pending state: pending updates now expire as failed after 15 minutes, Telegram reports the failure, and the next `/update` can start again.
+- This specifically recovers from the 0.5.2 updater killed by `KillMode=control-group`, and from any future updater interruption that fails to write a terminal status.
+
 ## 0.5.3 - 2026-06-04
 
 ### 中文

package/dist/update.d.ts

@@ -1,4 +1,5 @@
 import type { AppLocale } from './types.js';
+export declare const SELF_UPDATE_PENDING_TIMEOUT_MS: number;
 export type SelfUpdateState = 'pending' | 'succeeded' | 'failed';
 export interface SelfUpdateStatus {
     state: SelfUpdateState;
@@ -31,6 +32,8 @@ interface CreateSelfUpdateRuntimeOptions {
     statusPath: string;
     logPath: string;
     codexCliBin?: string;
+    pendingTimeoutMs?: number;
+    now?: () => Date;
 }
 interface PerformSelfUpdateOptions {
     entryPoint: string;

package/dist/update.js

@@ -5,6 +5,7 @@ import { spawn, spawnSync } from 'node:child_process';
 const PACKAGE_SPEC = '@foxden-app/foxclaw@latest';
 const CODEX_PACKAGE_SPEC = '@openai/codex@latest';
 const UPDATE_STATUS_FILENAME = 'self-update.json';
+export const SELF_UPDATE_PENDING_TIMEOUT_MS = 15 * 60_000;
 export function selfUpdateStatusPath(statusPath) {
     return path.join(path.dirname(statusPath), UPDATE_STATUS_FILENAME);
 }
@@ -148,11 +149,33 @@ export function writeSelfUpdateStatus(statusFile, status) {
     fs.writeFileSync(temporaryFile, `${JSON.stringify(status, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
     fs.renameSync(temporaryFile, statusFile);
 }
+function readNormalizedSelfUpdateStatus(statusFile, pendingTimeoutMs, now) {
+    const status = readSelfUpdateStatus(statusFile);
+    if (!status || status.state !== 'pending' || pendingTimeoutMs <= 0) {
+        return status;
+    }
+    const updatedAtMs = Date.parse(status.updatedAt);
+    const nowMs = now().getTime();
+    const isStale = Number.isNaN(updatedAtMs) || nowMs - updatedAtMs > pendingTimeoutMs;
+    if (!isStale) {
+        return status;
+    }
+    const failed = {
+        ...status,
+        state: 'failed',
+        error: `self-update timed out after ${Math.round(pendingTimeoutMs / 60_000)} minute(s) without writing a completion status; the previous updater may have been interrupted`,
+        updatedAt: new Date(nowMs).toISOString(),
+    };
+    writeSelfUpdateStatus(statusFile, failed);
+    return failed;
+}
 export function createSelfUpdateRuntime(options) {
     const statusFile = selfUpdateStatusPath(options.statusPath);
+    const pendingTimeoutMs = options.pendingTimeoutMs ?? SELF_UPDATE_PENDING_TIMEOUT_MS;
+    const now = options.now ?? (() => new Date());
     return {
         async launch(scopeId, locale) {
-            const current = readSelfUpdateStatus(statusFile);
+            const current = readNormalizedSelfUpdateStatus(statusFile, pendingTimeoutMs, now);
             if (current?.state === 'pending') {
                 throw new Error('A FoxClaw update is already running.');
             }
@@ -219,7 +242,7 @@ export function createSelfUpdateRuntime(options) {
             }
         },
         async readStatus() {
-            return readSelfUpdateStatus(statusFile);
+            return readNormalizedSelfUpdateStatus(statusFile, pendingTimeoutMs, now);
         },
         async clearStatus() {
             fs.rmSync(statusFile, { force: true });

package/package.json

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