`os doctor` 的 config 分析 catch 丢弃了 error 本身 —— 配置真坏掉时只说「载入不了」,不说为什么

[baozhoutao]

发现于 #5397(给 loadConfig() 套 .env* overlay)实施过程中的顺带核验;本单只记录,未在该 PR 里改 —— 原因写在下面。

事实

packages/cli/src/commands/doctor.ts:1212(origin/main 98369a8):

      } catch {
        printWarning('Could not load config for analysis (config checks skipped)');
        hasWarnings = true;
      }

catch 不带绑定,error 对象当场丢弃。载入失败的真实原因(语法错、import 解析不到、
配置自己抛的业务错、bundle-require 的 esbuild 报错)一个字都不到达终端,--verbose 也没有 ——
这条 warning 是 printWarning 直接打的,不走 HealthCheckResult.fix 那条能被 --verbose
展开的路径,所以没有任何旗标能让操作者看到更多。

后果

#5382 → #5387 → #5397 三单依次把这句话的归因修对了:先是把 posture 的抛错从这个 catch 里
挪出去(#5382),再让 env 派生检查读到 serve 的那份环境(#5387/PR #5398),最后让配置载入也在
serve 的环境下进行(#5397)。三单之后,这句话触发时配置确实坏了 —— os serve 同样载入不了。

但归因对了不等于可行动。操作者现在拿到的是一句「载入不了,检查跳过」,没有任何线索,而
os serve 在同一目录会把真实错误完整打出来。于是 doctor 这条路径的处境从「说错了话」变成
「说的话没有信息量」:诊断命令在它最该出力的一刻(配置坏了),给出的信息严格少于直接跑
os serve。

复现(真机,临时目录):

$ cat objectstack.config.ts
throw new Error('this config is genuinely broken');

$ os doctor
  → Loading configuration for analysis...
  ⚠ Could not load config for analysis (config checks skipped)

⚠️  Environment is functional but has some warnings.

this config is genuinely broken 不出现在任何地方。

为什么没有顺手改

#5397 的派发口径把判定面限定为「给 loadConfig() 套 overlay」,并明确要求这条 warning
照旧触发、不要过度静默;改写它打印什么属于另一处诊断输出的契约变化(要不要打印 cause、
打印多少、算 warning 还是 error),超出该单被限定的判定面。#5397 的 PR 在这个 catch 上留了
注释说明它现在归因正确,但没有动它的输出。

可能的方向(供分诊,不预设)

• 最小:catch (err) + 按 os doctor 对非法 OS_TENANCY_POSTURE 退出码 0 并报告「环境功能正常」—— 抛错被 config 分析的宽 catch 吞成一句「Could not load config」 #5382 既有体例把 cause 挂到 fix/--verbose(与 posture finding
  引回 resolveTenancyPosture() 原话同一姿态:引用上游的原始措辞,不改写);
• 或:同样引回 cause,但把它做成常规 HealthCheckResult,与 Environment files /
  Tenancy posture 一样走统一的渲染与 verbose 展开,而不是裸 printWarning。

与 #4801、cloud#1020 同属「诊断面与运行时不一致」家族的收尾;#5382 / #5387 / #5397 是同一句话
的前三单。

---

Generated by Claude Code

[baozhoutao]

认领:PM 循环第 1 轮(cli 车道)
会话:session_016FNvXhtSdnEGEfLEsMmvxh
分支:claude/issue-5403-doctor-config-error-cause
Worktree:objectstack-issue-5403
域:domain:cli
文件面:packages/cli/src/commands/doctor.ts + packages/cli/test/**

PM 方向裁定(否决窗口,维护者可否决):目标是「cause 可见」。优先取正文方案二 —— 把该 catch 做成常规 HealthCheckResult,与 Environment files / Tenancy posture 同走统一渲染与 --verbose 展开;若实现中发现与「warning 照旧触发、不过度静默」的既有语义冲突,退回最小改法(catch (err) + cause 挂 fix/--verbose)。两条轴的理由:统一渲染消灭第二条裸 printWarning 旁路(长远轴:诊断面单一出口),且级别与文案从此可测试、可门禁(防 AI 轴:契约收紧优于各处手打)。cause 引上游原始措辞,不改写(#5390 姿态)。范本 PR:#5390 / #5402。同日 churn 注记:#5402 / #5398 均动过本文件,以 origin/main(4b61cf3)为准。

---

Generated by Claude Code

[baozhoutao]

验收(cli 车道 PM,session_016FNvXhtSdnEGEfLEsMmvxh):ACCEPT → PR #5410。

• 前提核验先行:issue 引用行号因同日 churn 漂移(1212→1320),事实成立,dev 已核对 origin/main(4b61cf3)。
• 按 PM 裁定方案二落地:裸 printWarning 改为常规 HealthCheckResult,渲染规则提为 renderHealthCheckResult() 两处共用 —— 统一渲染 + 统一 --verbose 展开 + 消灭旁路,报告顺序未动;时序事实(环境块 forEach 已跑完)的处理属判定面内的合理工程判断。
• cause 原话照引不改写(fix(cli): os doctor 指名道姓报告非法 OS_TENANCY_POSTURE 并非零退出 (#5382) #5390 姿态);警戒语句原样保留为行首(兄弟测试以其缺席断言「载入成功」,改写会让断言空绿 —— 该取舍经复核成立)。档位保持 warning、exit 0。
• 测试:新增 13 例(builder 8 + e2e 5)全部显式 60s 超时;反向验证方向事前预测、逐条命中(3 正向红 / 2 否定式仍绿,如实报告了否定式断言结构上不可能察觉回退);全包 728 例绿、typecheck 绿、六项门禁绿。os doctor 载入 objectstack.config.ts 时不带 .env* overlay —— 配置文件自己读 process.env 时,doctor 报「Could not load config」而 os serve 同目录正常启动 #5397 async overlay 承重件未动并有正面钉住用例。
• 衍生:os doctor 的 installed-package ledger 读取 catch 把「损坏」和「没装」当成同一件事 —— D5e 建议因此静默少报,并打出「clean」 #5412(同文件 ledger catch 吞损坏,D5e false PASS)已立案,另行分诊,⛔ 与本 PR 同文件须串行其后。

下一步:CI 全绿后转 ready 并入合并队列,跟到 MERGED。

---

Generated by Claude Code