Skip to content

feat(runtime): unify outcome diagnostics on top of bootstrap policy#5

Merged
Li-Sanze merged 1 commit into
mainfrom
feature/plan-b1-diagnostics-surface
Apr 2, 2026
Merged

feat(runtime): unify outcome diagnostics on top of bootstrap policy#5
Li-Sanze merged 1 commit into
mainfrom
feature/plan-b1-diagnostics-surface

Conversation

@Li-Sanze
Copy link
Copy Markdown
Collaborator

@Li-Sanze Li-Sanze commented Apr 2, 2026

概要

基于 feature/plan-b1-bootstrap-policy,继续把 installer / runtime 的诊断输出收口成一套统一 contract。

如果说前一个 PR 解决的是“什么时候允许 bootstrap、什么时候必须拦住”,这个 PR 解决的就是“这些判断产出的结果,如何以一致、稳定、可机器消费的方式暴露出
来”。

核心是把 runtime/install outcome 统一到一组最小字段:

  • primary_code
  • action_level
  • evidence
  • hint

CLI 渲染层也收口到这组稳定字段,不再依赖分散的 legacy reason/message 分支。

相对 policy 分支的增量

  • 新增共享 outcome contract:installer/outcome_contract.py
  • 新增统一 gate 文本渲染层:runtime/gate_output.py
  • 对齐 bootstrap、inspection、distribution、workspace preflight、runtime gate 的 outcome 语义
  • 固化 primary_codeaction_level 的映射,减少不同入口各自定义结果语义的情况
  • 补充 dual-host、monorepo、ingress contract 场景的测试覆盖
  • 调整 install payload smoke 语义:
    • workspace 只校验 thin stub
    • global bundle 单独校验完整 helper contract
  • 更新 README 中关于 status / doctor / 迁移路径的诊断说明

为什么要做

在 policy 层把 bootstrap 边界收紧之后,下一步问题就变成:不同入口是否仍然在用不同方式表达“同一个结果”。

之前同一个场景,可能会在:

  • bootstrap 输出
  • status / doctor
  • workspace preflight
  • runtime gate

里分别表现成不同的 reason code、提示文案和继续策略。这样虽然逻辑本身接近,但宿主侧行为、CLI 展示和测试断言都更难稳定。

这个 PR 的作用,就是把这些结果统一成一层稳定诊断面:

  • 机器侧看统一 contract
  • CLI 侧看统一渲染输入
  • 文档和测试围绕同一套 outcome 语义建立

验证情况

  • 定向 unittest 已通过:tests.test_runtime_gate
  • 定向 unittest 已通过:tests.test_installer_status_doctor
  • 定向 unittest 已通过:tests.test_distribution
  • install payload smoke 已通过:codex:zh-CN
  • install payload smoke 已通过:claude:zh-CN
  • commit 阶段 preflight、完整测试与 release sync 已通过

Release-Sync: yes

Release-Version: 2026-04-02.130950

Release-Date: 2026-04-02
@Li-Sanze Li-Sanze merged commit 4819089 into main Apr 2, 2026
2 of 4 checks passed
@Li-Sanze Li-Sanze deleted the feature/plan-b1-diagnostics-surface branch April 15, 2026 10:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant