From c19ea76e562a57aa1095566415b5f176f0bd42bf Mon Sep 17 00:00:00 2001
From: Codex <codex@local>
Date: Sun, 12 Jul 2026 01:37:01 +0200
Subject: [PATCH] docs(mdtodo): track CLI progressive disclosure

---
 .../cli-output-progressive-disclosure.md      | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 docs/MDTODO/cli-output-progressive-disclosure.md

diff --git a/docs/MDTODO/cli-output-progressive-disclosure.md b/docs/MDTODO/cli-output-progressive-disclosure.md
new file mode 100644
index 00000000..26f9d9ab
--- /dev/null
+++ b/docs/MDTODO/cli-output-progressive-disclosure.md
@@ -0,0 +1,20 @@
+# CLI 输出渐进披露
+
+本文件长期跟踪 UniDesk 高频 CLI 的紧凑默认输出、语义化逐级披露、显式原始输出与错误可见性合同。单个命令、一次 dump 或一个 issue 作为 ITEM 纳入，不以临时故障扩散文件。
+
+
+## R1 [in_progress]
+
+解决 [UniDesk #1809](https://github.com/pikasTech/unidesk/issues/1809)：收敛 Gitea webhook status、trans --help 及未知/错误命令的高频 dump，建立 compact 默认输出、语义化 drill-down、显式 raw 和无 stack 错误合同；只改只读 CLI 可见性，不新增 mirror、sync、flush、trigger 或 apply。，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R1_Task_Report.md)。
+
+### R1.1 [in_progress]
+
+复现并冻结 [#1809](https://github.com/pikasTech/unidesk/issues/1809) 的输出合同：默认输出有界、repository key/deliveryId drill-down 语义化、--full 域聚合、--raw 显式；trans --help、未知子命令和可预测 option 错误不得回显内部 stack。，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R1.1_Task_Report.md)。
+
+### R1.2 [in_progress]
+
+实现共享 CLI 错误边界与 Gitea webhook 有界逐级披露，复用既有 formatter/命令路由；默认输出给出可执行的语义化 next，不依赖临时 dump，且不增加任何交付或 mirror 写入口。，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R1.2_Task_Report.md)。
+
+### R1.3
+
+覆盖 compact/full/raw、repository/deliveryId、错误参数和 trans --help 回归，完成静态验证、非草稿 PR、架构审查与自动交付后原入口验收。，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R1.3_Task_Report.md)。