Repository navigation
v4.7.4
独立复审一轮,聚焦「上轮文档未覆盖」的缺口。两处并发/可见性缺陷均已实测复现后修复。单测 290(+7)。
修复
start/install报「退出码 null」,信号死亡的死因在启动路径上不可见:v4.7.3 补信号判据时把 status/doctor 的重复判断收口成describeAbnormalExit,却漏了runtime.assertServiceHealthy这第三个消费者——它仍自己拼退出码 ${exitCode},而信号死亡时 launchd 不写last exit code(整行消失,本轮用一次性 label + 桩内核再次实测确认),于是start期间被 OOM killer 杀掉的内核只显示「内核启动后立即退出(退出码 null)」,ServiceHealth.terminatingSignal一路传过来却无人读。判据现收口成describeExitCause(exitCode, signal)一份,三个消费者共用(isCrashed判有无、describeAbnormalExit供 status/doctor、assertServiceHealthy供 start/install),修复后文案为「被信号终止(Killed: 9)」。教训:把实测事实锚在注释里挡不住漏铺——注释锚在事实发生处,防线要铺在所有消费处,两者不重合时只有「判据收成一个函数」才真的有效service.lock放在会被整体删除的runtime/下,跨进程互斥可被打破:stop()的clearRuntime()与reset runtime都会rmrf(DIRS.runtime),把别的进程正持着的锁文件一起删掉——第三个进程随即openSync(..., 'wx')成功,两个进程同时进入临界区(已实测复现)。withFileLock的 token 所有权校验对此无效:它防的是「被强夺者误删新持有者的锁」,而这里锁是被第三方连目录一起删的,持锁方毫不知情。可达路径正是文档反复强调的那个——慢速start(订阅更新约 10s)持锁期间另一终端stop,后果是自启位终态与用户最后一条命令相反。锁现移到USER_DATA_DIR根下
测试
- 新增
describeExitCause判据本身的用例(5 例),含「不能退化成只看退出码」的锁定断言——直接对判据断言而非各消费者,避免再出现「收口了却漏一个消费者」 - 新增锁存放位置的用例(2 例):断言的是不变量「
service.lock不在任何会被rmrf的目录下」而非具体路径(后者会在目录结构调整时误报),另一例记录缺陷机制本身。已验证该测试对旧位置确实失败
变更
CLAUDE.md修正一处写反的记载:「内核下载的来源信任」的 quickstart.sh 对照表里写「无标准版资产时回退第一个匹配项(CLI 不回退)」,但kernel.ts是standardAsset || matchingAssets[0],且kernel.spec.ts有单测锁定回退行为——两侧其实一致,是文档写反了。这段文字的用途正是两侧对齐的对照表,写反会误导下次对齐。顺带指明真正不回退的是pickLatestRelease(全预发布时抛错)CLAUDE.md新增两条纪律:锁文件不能放在会被rmrf的目录里(附受影响目录清单);异常退出判据只有describeExitCause一份,别散写lastExitCode !== 0也别自己拼退出码文案- 去掉 4 处对同步函数(
bootoutService/withFileLock)的await——withFileLock明确要求fn同步(持锁期间让出事件循环等于没锁),await会暗示可传 async mutator - README 同步两处:
start失败报错会写明死因(与status同口径);数据目录树补上service.lock并注明为何放在根下