 jkooe
|
419f6dca13
|
fix(agent): 看门狗日志按 1MB×4 轮换 —— 修常驻被控端的无界增长
startup-guard.log 一直是 appendFileSync 无限追加。看门狗常驻被控端，
「坏版本 + supervisor 反复重启」时写得很快，磁盘写满会连带把 agent 的
审计写入一起拖死（看门狗自己就在同一台机器上）。
- core（零依赖纯函数）：shouldRotate（严格大于阈值，NaN 不触发）+ rotationTargets；
- guard：超阈值先丢最旧 .N → 逐个后移 → 当前滚为 .1，滚动与写入均失败静默
（日志问题绝不能反过来拦住被控端启动）；
- 单测 +3：阈值边界（含恰好等于/Nan）、命名序列、真实滚存三轮（验证只留 3 份、
当前日志重新开始、未超阈值只追加）。
|
2026-10-27 08:04:20 +08:00 |
|
|
jkooe
|
aad137f04a
|
fix(startup-guard): 强制向被看守进程注入 NODEAGENT_HOME = --data-dir
全局一致性审查发现：Windows 计划任务的 New-ScheduledTaskAction 无法
携带环境变量，若安装进程持有进程级 NODEAGENT_HOME，agent 运行时的
agentDir()（LKG/状态文件所在地）会与守卫的 --data-dir 漂移 ——
守卫读不到 LKG/状态文件（安全退化为 no-lkg 放行，但看门狗白养）。
由 spawnEnv 在 spawn 时把 data-dir 显式注入被看守进程，三端行为与
supervisor 环境解耦且一致（Linux unit / macOS plist 的
EnvironmentVariables 本就是同值，双保险，幂等无害）。
新增 spawnEnv 单测；真机验证子进程可见注入值。
|
2026-10-26 00:17:15 +08:00 |
|
|
jkooe
|
cb468df7da
|
feat(agent): 看门狗自动恢复 LKG —— 启动连续失败 N 次从 LKG 恢复（决策 R-1）
scripts/startup-guard.mjs + scripts/lib/startup-guard-core.mjs（新增）：
- 被控端启动连续失败 N 次（默认 3）自动从 LKG 指纹匹配的备份恢复入口脚本
- 30s 启动宽限期 + 端口探活，避免计划内重启与 supervisor 重启撞车被误计数
- 无 LKG / 无指纹匹配只记日志放行，绝不擦除 install-dir
- 恢复成功或服务已就绪均归零失败计数；被控端启动成功后 resetStartupGuardState 归零
（apps/agent/src/index.ts 为本任务对 agent 的唯一改动点）
三端 supervisor 接入：
- Windows install.ps1：计划任务包一层 guard，RestartCount 3→10（保证阈值可达）
- Linux install-linux.sh：systemd unit 的 ExecStart 包一层 guard
- macOS launchd：无安装器，docs/DEVELOPMENT.md §7.4 给出完整接法
docs：DELIVERY-PIPELINE §6 由「不做自动回滚」收窄为
「手动 rollback + 看门狗自动恢复 + 边界明示」，附录 C 同步；
DEVELOPMENT.md 新增 §7.4 三端 supervisor 接入说明。
|
2026-10-26 00:09:56 +08:00 |
|