termdock 1.4.260 → 1.4.262

package/dist/server/utils/supervisorProtocol.js

@@ -0,0 +1,159 @@
+/**
+ * supervisor ↔ server ↔ launcher 的协议，以及**纯函数**决策逻辑。
+ *
+ * 决策逻辑刻意与进程操作分开：判"这次退出算什么"必须能脱离真实进程单测，
+ * 否则唯一验证手段就只剩"手动 kill 一下看看"。
+ */
+export const SUPERVISOR_STATE_VERSION = 1;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+export function isReadyMessage(value) {
+    return isRecord(value) && value.type === 'termdock-ready';
+}
+export function isServerIntentMessage(value) {
+    if (!isRecord(value) || value.type !== 'termdock-intent')
+        return false;
+    return value.intent === 'restart-after-update' || value.intent === 'stop';
+}
+const NATIVE_CRASH_SIGNALS = new Set(['SIGSEGV', 'SIGABRT', 'SIGBUS', 'SIGILL', 'SIGFPE']);
+function exitDetail(exitCode, signal) {
+    if (signal)
+        return `signal ${signal}`;
+    if (exitCode !== null)
+        return `exit code ${exitCode}`;
+    return 'unknown termination';
+}
+/**
+ * 决定一次子进程退出意味着什么。判定顺序即优先级，改动前先想清楚：
+ * - 停止请求（supervisor 收到 SIGTERM）优先于一切，否则 `--stop` 会被当成崩溃重启，
+ *   变成"用户刚停，它自己又回来"。
+ * - 卡死判定优先于信号判定：wedge 是我们自己 SIGTERM/SIGKILL 的，否则会被
+ *   误读成"被外部终止"从而不重启。
+ * - 更新重启优先于端口冲突/未就绪：更新重启的退出码可能是 0 也可能非 0。
+ * - 手动重启排在更新重启之后：两者都是"我们让子进程重启"，但记录里要分得清
+ *   是应用了更新还是人在敲 `td --restart`。
+ */
+export function classifyChildExit(observation) {
+    const { intent, exitCode, signal, becameReady, supervisorStopRequested, restartRequested, wedge, portConflict, } = observation;
+    if (supervisorStopRequested || intent === 'stop') {
+        return {
+            event: 'stop',
+            detail: supervisorStopRequested ? 'supervisor stop requested' : 'server requested stop',
+            restart: false,
+            countAsCrash: false,
+            resetBackoff: true,
+        };
+    }
+    if (wedge) {
+        return {
+            event: 'wedge',
+            detail: 'health probes stopped responding',
+            restart: true,
+            countAsCrash: true,
+            resetBackoff: false,
+        };
+    }
+    if (intent === 'restart-after-update') {
+        return {
+            event: 'update-restart',
+            detail: 'restart requested after update',
+            restart: true,
+            countAsCrash: false,
+            resetBackoff: true,
+        };
+    }
+    if (restartRequested) {
+        return {
+            event: 'manual-restart',
+            detail: 'restart requested by termdock --restart',
+            restart: true,
+            countAsCrash: false,
+            resetBackoff: true,
+        };
+    }
+    if (portConflict) {
+        return {
+            event: 'port-conflict',
+            detail: 'port already in use',
+            restart: true,
+            countAsCrash: true,
+            resetBackoff: false,
+        };
+    }
+    if (!becameReady) {
+        return {
+            event: 'startup-failure',
+            detail: `exited before becoming ready (${exitDetail(exitCode, signal)})`,
+            restart: true,
+            countAsCrash: true,
+            resetBackoff: false,
+        };
+    }
+    if (signal) {
+        const detail = exitDetail(exitCode, signal);
+        // SIGTERM/SIGINT 但没有 intent = 有人主动停它（部署脚本的 pkill 兜底、关机流程）。
+        // 重启它会把一次有意的停机变成重启风暴，所以只记录、不重启。
+        if (signal === 'SIGTERM' || signal === 'SIGINT') {
+            return {
+                event: 'terminated-externally',
+                detail,
+                restart: false,
+                countAsCrash: false,
+                resetBackoff: true,
+            };
+        }
+        if (signal === 'SIGKILL') {
+            return {
+                event: 'killed',
+                detail,
+                restart: true,
+                countAsCrash: true,
+                resetBackoff: false,
+            };
+        }
+        if (NATIVE_CRASH_SIGNALS.has(signal)) {
+            return {
+                event: 'crash-native',
+                detail,
+                restart: true,
+                countAsCrash: true,
+                resetBackoff: false,
+            };
+        }
+        return {
+            event: 'crash',
+            detail,
+            restart: true,
+            countAsCrash: true,
+            resetBackoff: false,
+        };
+    }
+    if (exitCode === 0) {
+        return {
+            event: 'exit-zero-unexpected',
+            detail: 'exit code 0 without a stop request',
+            restart: true,
+            countAsCrash: true,
+            resetBackoff: false,
+        };
+    }
+    return {
+        event: 'crash',
+        detail: exitDetail(exitCode, signal),
+        restart: true,
+        countAsCrash: true,
+        resetBackoff: false,
+    };
+}
+export const DEFAULT_MAX_CONSECUTIVE_CRASHES = 5;
+/** 连续健康这么久就认为稳住了，把崩溃计数清零。 */
+export const CRASH_COUNTER_RESET_MS = 60_000;
+export function shouldGiveUp(consecutiveCrashes, maxCrashes = DEFAULT_MAX_CONSECUTIVE_CRASHES) {
+    return consecutiveCrashes >= maxCrashes;
+}
+export function isSupervisorState(value) {
+    return isRecord(value)
+        && value.version === SUPERVISOR_STATE_VERSION
+        && typeof value.pid === 'number';
+}

package/dist/server/utils/termdockState.js

@@ -0,0 +1,62 @@
+/**
+ * 单一来源的 Termdock 状态目录 + 原子写。CLI、supervisor、server 三方都读这里，
+ * 避免每处各拼一次路径再写出一套略有出入的读写逻辑。
+ *
+ * 依赖保持轻量（node stdlib only）：supervisor 是独立入口，不能通过这里
+ * 间接把 server 的重依赖拖进来。
+ */
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+export const TERMDOCK_DIR = path.join(os.homedir(), '.termdock');
+export const SERVER_STATE_PATH = path.join(TERMDOCK_DIR, 'server.json');
+export const SUPERVISOR_STATE_PATH = path.join(TERMDOCK_DIR, 'supervisor.json');
+export const SERVER_LOG_PATH = path.join(TERMDOCK_DIR, 'server.log');
+export const RUNTIME_METRICS_PATH = path.join(TERMDOCK_DIR, 'runtime-metrics.log');
+/** 记录"用户已看过某时刻之前的服务异常"，供界面红点判定未读。 */
+export const INCIDENT_DISMISSED_PATH = path.join(TERMDOCK_DIR, 'incident-dismissed.json');
+/** 发 SIGTERM 后等进程自行退出的宽限期，超时才 SIGKILL。CLI 与 supervisor 共用。 */
+export const STOP_GRACE_MS = 5_000;
+export function isProcessRunning(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function readJsonFile(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 原子替换（tmp + rename + 0600），照 utils/autoUpdate.ts 的 persistState 写法。
+ * 读方要么看到旧文件要么看到新文件，绝不会读到写了一半的 JSON。
+ */
+export function writeJsonStateAtomic(filePath, value) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true, mode: 0o700 });
+    const temporaryPath = `${filePath}.${process.pid}.tmp`;
+    fs.writeFileSync(temporaryPath, `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600 });
+    fs.renameSync(temporaryPath, filePath);
+}
+export function removeJsonState(filePath) {
+    try {
+        fs.rmSync(filePath, { force: true });
+    }
+    catch {
+        // 清理失败不该影响调用方。
+    }
+}
+export function readServerState() {
+    const state = readJsonFile(SERVER_STATE_PATH);
+    if (!state || typeof state.pid !== 'number')
+        return null;
+    return state;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termdock",
-  "version": "1.4.260",
+  "version": "1.4.262",
   "description": "A complete web-based terminal application with modern UI",
   "type": "module",
   "main": ".desktop-dist/main.js",

package/runtime-manifest.json

@@ -1,13 +1,13 @@
 {
   "schemaVersion": 1,
   "packageName": "termdock",
-  "version": "1.4.260",
+  "version": "1.4.262",
   "runtimeProtocolVersion": 1,
   "minimumDesktopVersion": "1.4.46",
   "nodeMajor": 22,
   "dependencyHash": "sha256-K4KyYJuVoQDpZsBM8ZX1Rw3MddOxAzVdp/cPm0iGZz0=",
-  "serverBundleHash": "sha256-IgrnWiH2Y+b7jVZaD+sWKUT0O2YEpFUTc4LGRTgKg3M=",
-  "clientBundleHash": "sha256-eIj8Fc/sbzIRJVaMs95IizyTIdYjeBKx1DOGhOYYea8=",
+  "serverBundleHash": "sha256-I9rQMvrynOSrnhBqpRpX37buC7ybvVvS119dRrb8xUU=",
+  "clientBundleHash": "sha256-ZWDYKA+JI6MtKpt2xQzBeBG68zE/LXhSuDvj5wKb0Pg=",
   "entrypoint": "dist/server/cli.js",
   "clientEntrypoint": "dist/client/index.html"
 }