docs+test：空輸出判決 #37——維持 []／null、補 stalled 空輸出測試

2026-09-12 23:43:29 +08:00
parent d689107eea
commit 9e699f3b4e
2 changed files with 25 additions and 3 deletions
@@ -299,7 +299,7 @@ teai whoami               # 目前帳號（讀 tea 組態）

 | 碼 | 意義 |
 | --- | --- |
-| 0 | 成功（含「沒有工作」→ 輸出 `null`／`[]`） |
+| 0 | 成功（含「沒有結果」→ 清單類命令輸出 `[]`、`next` 輸出 `null`；#37 判決） |
 | 2 | 用法錯誤（未知命令／參數） |
 | 3 | API 錯誤（連線失敗、401、403、5xx） |

@@ -318,8 +318,12 @@ teai whoami               # 目前帳號（讀 tea 組態）
 已知輸出差異（刻意保留，機器可讀優先）：

 - **空清單**：`gitea.py` 的 `_dump` 對空清單**不輸出任何內容**；teai 的清單類命令
-  （`mine`／`pulls`／`milestones` 總覽）空清單輸出 `[]`。對 JSON 消費者來說 `[]` 比「無輸出」更明確，
-  交叉驗證時以此差異為準。`next` 兩者語義相同（無工作 → `null`／「沒有未完成的工作」）。
+  （`mine`／`pulls`／`stalled`／`milestones` 總覽）空清單一律輸出 `[]`（exit 0）。對 JSON
+  消費者來說 `[]` 比「無輸出」更明確（可區分「沒有結果」與「查詢失敗無輸出」），交叉驗證時
+  以此差異為準。`next` 兩者語義相同：無工作時 teai 輸出 `null`（exit 0）、`gitea.py` 印
+  「沒有未完成的工作」。**判決 #37：維持 teai 現行 JSON 一致性（方向 2）**——消費端
+  （agents 倉庫巡邏提示與觸發腳本）應以「輸出 `[]`／`null` 且 exit 0」為「沒有」判據，
+  不得以「無輸出」判斷；`members [--has-work]` 維持逐行帳號、空時無輸出（兩者一致，不受影響）。
 - **清單欄位集（`mine`／`pulls`）**：`gitea.py` 直接傾倒完整 Gitea API 物件
  （`_dump` 的副作用，欄位集隨 Gitea 版本浮動）；teai 輸出策展摘要欄位
  （`mine`：repo／number／title／url；`pulls`：number／title／state／author／