Skip to content

让 CLI 返回准确表达执行状态、结果范围与配置生效情况 - #135

Merged
Disdjj merged 4 commits into
mainfrom
Disdjj/booming-algebra
Sep 5, 2026
Merged

让 CLI 返回准确表达执行状态、结果范围与配置生效情况#135
Disdjj merged 4 commits into
mainfrom
Disdjj/booming-algebra

Conversation

@Disdjj

@Disdjj Disdjj commented Sep 5, 2026

Copy link
Copy Markdown
Member

CLI 先前会把 HTTP 成功、异步受理与执行完成混在一起,部分空页还会隐藏后续 cursor。本次让返回直接说明实际状态与结果范围,减少使用者根据字段或短句猜测。

  • 设备调用和查询共用真实生命周期说明:202 展示实际状态,取消申请不等于执行停止,结果未知不宣称已执行或未执行。
  • 网络、超时和协议失败明确表示未取得可靠结果;空 feedback 不再追加提交邀请,根帮助把 feedback 定位为按需排障。
  • search/ctx/store 空页保留分页信号,partial 搜索明确不完整;config 文本区分已保存配置与响应副本实际生效配置。

升级行为变化(CLI 0.32.0,0.x minor):

  • tb status --jsonok 改为与健康检查退出码一致;新增 httpOk 表示 HTTP 成功,缺少有效健康字段时 healthynull
  • 传输超时、网络和协议失败不再输出推测的 retryable: true,改为 kindoutcome: "unknown";服务端 HTTP 错误的 retryable 保留。
  • config 默认文本输出为状态摘要与配置对照;--json 保留原服务端结果。普通工具 JSON 和显式 delivery 的既有 wrapper 保持不变。

验证:pnpm verifypnpm turbo run build 全绿;CLI 443 项测试通过。重建入口确认版本为 0.32.0;使用仓库统一 pack verifier 验证最终 tarball、仓库外干净安装及 tb --version / tb --help。CLI llmdoc 契约同步,公开 Agent Skill 现有恢复规则与本轮一致。未调用真实生产网关、上游或 S3。

仅 CLI 的发布内容变化。合入 main 后逐个推送 cli-v0.32.0 tag,并核对 npm 精确版本与发布产物。

升级后 status 的 ok 与健康检查退出码一致,HTTP 成功另用 httpOk 表达;未知健康返回 null。传输和协议失败省略无法证明的 retryable 标记,使用 kind/outcome 表达未知结果,避免重复副作用。设备返回依据真实生命周期解释取消、过期和幂等重放,普通工具 JSON 仍保持原义。
空页仍可能有后续 cursor,配置保存也不等于已应用;文本返回直接交代这两类边界并保留原始 JSON 数据。CLI 升至 0.32.0:健康检查和传输失败的机器输出含义有变化,按 0.x minor 交付以便消费者显式升级。verify、全仓 build、最终 tarball 干净安装与 bin 烟测已通过。
@Disdjj
Disdjj merged commit 7d4e7be into main Sep 5, 2026
2 checks passed
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