> 📦 **Migrated from GitHub:** [aa22396584/quietinbox#32](https://github.com/aa22396584/quietinbox/issues/32) > 👤 **Original Author:** @aa22396584 > 📅 **Created At:** 2026-09-12T10:29:48Z > 🏷️ **Labels:** (none) > 🚦 **Original State:** OPEN --- > **Migrated from ImL1s/quietinbox#38** > Originally created: 2026-09-12T10:29:48Z ## 目標與使用方式 這是 **執行索引，不取代原票、不新增另一份產品需求**。將既有大票拆成可交給執行代理的小步；每次一個子項、先 RED 再 GREEN、交付可追溯證據。所有原始 audit ID、checkbox、既有 P1/P2 與歷史報告都保留，不能因整理就關票。 **第一個可直接開工的目標：#37 的 instrumented report gate。** 它不需 Android SDK 即可重現，先確保後续驗收工具不會把沒有測試當成功。這個執行先後不降低 #29／#30 的 P1；兩張 P1 的核心回歸應在後續擴充功能前核對。 ## 2026-09-12 本輪快照（執行前必須再讀 GitHub） - repository：`ImL1s/quietinbox`，只限這個專案。 - main：`3444d9b939651e9b0f1f88bea087d461495c7457`。 - PR #34：`review/vault-expiry-backup-abort`，head `1a6b3aa5bb9a8b1de0cce214bfd3cb3d6cf3d0df`，OPEN／未合併。 - PR #35：`fix/compatibility-evidence-20260912`，head `f6139a01fbedef09e16fae2b13d80b547d3b60a5`，OPEN／未合併，直接基於 main，**不是 stacked on #34**。 - PR #36 是已關閉的臨時 trigger 檢查，不重開、不合併。 - 本輪 #34／#35 的 head 及各自 test-merge check-runs 皆回傳 0；根因尚未證實，處理流程在 #32 C0。 - PR #34 的 body 還引用舊 HEAD／舊 run；已加 current-head 留言，歷史通過不是最新 SHA 通過。 本輪 issues collection／search 多次回傳空集合，但逐票 API 明確回傳下列 OPEN；因此**不宣稱整個 repo 只有這些票**。接手不能因清單空就刪票、重建同題、或說所有問題已解決；對已知票號直接讀取並保存查詢錯誤。 ## 本輪已寫回的執行包 | 追蹤票 | 可獨立執行的子項 | 目前證據與剩餘邊界 | |---|---|---| | **#37** | 正式 shell CLI 的 XML fail-closed 驗證與 subprocess 回歸 | **HOST_REPRODUCED**：10 fixtures，5 個 fail-open；未修 | | **#29（P1）** | B0 既有 assertions 對照；B1 預覽；B2 真實筆數；B3 韌性 | 已核對最新 backup 結構／測試入口；本輪未跑 Android | | **#30（P1）** | V0 expiry 回歸；V1 來源／gap；V2 搜尋；V3 操作；V4 重建 | 最新 source 已不是每秒昂貴重查；未做真機 profiling | | **#17（P2）** | S1 evidence resolver；S2 Health/onboarding；S3 正負測試 | 兩處 hasAdapter→verified 已 source-confirmed；真來源仍未知 | | **#33（P2）** | J1 原子 terminal API；J2 DECODE/PARSE；J3 相容性 | 現行 SQL 的兩個失敗形狀已 host 重現；真 Room 待驗 | | **#31（P2）** | A1 視窗；A2 focus/semantics；A3 TalkBack/Switch Access | 操作矩陣已具體化；本輪全為未執行 | | **#32（P2）** | C0 exact-head CI；C1 #37；C2 未來成品證據 | 查核與官方文件研究；未修改保護、未簽章／發版 | 直接讀取新增執行包： - #17：https://github.com/ImL1s/quietinbox/issues/17#issuecomment-5645309730 - #29：https://github.com/ImL1s/quietinbox/issues/29#issuecomment-5645313725 - #30：https://github.com/ImL1s/quietinbox/issues/30#issuecomment-5645317231 - #31：https://github.com/ImL1s/quietinbox/issues/31#issuecomment-5645319892 - #32：https://github.com/ImL1s/quietinbox/issues/32#issuecomment-5645324038 - #33：https://github.com/ImL1s/quietinbox/issues/33#issuecomment-5645290358 - PR #34 current-head：https://github.com/ImL1s/quietinbox/pull/34#issuecomment-5645327553 ## 第一輪：只交付 #37 的最小修正 1. 讀 #37 全文、`tools/check-instrumented.sh`、CI 中 caller，以及 PR #35 已新增的 `tools/tests`／CI 差異。 2. 重新取最新 main/PR refs，檢查工作樹。用獨立 branch/worktree，不 reset 或覆蓋使用者未提交檔；不在 #34／#35 上塞入不相關工作。 3. 執行 #37 的最小重現，建立 10 個正式 CLI subprocess regression。必須保留 good XML 的正對照；現行 faulty validator 要使新 regression suite RED。 4. 最小修改限 shell wrapper、XML parser、host regression，以及必要的 CI 接線。建議新檔名 `tools/check-instrumented.py`、`tools/tests/test_check_instrumented.py`；先確認不存在再新增。 5. XML 必須真的解析、逐 module 驗證 testcase/failure/error/skipped，格式損壞／數量矛盾／沒有 module／零執行不得 success；不能只把 sed 改成另一個 regex。 6. 修正後 regression GREEN；把 validator 換回原版本時同一負測試再 RED。不要把測試改成期待假成功。 7. 真實 API29/35 新報告相容性另驗；缺 Android 就標 BLOCKED_ENV，不阻止 host 修正交付，也不關閉整單。 8. 提交小 PR，提供實際 SHA／命令／rc／測試數／原始 log；使用 `Refs #37`，不自動關票、不合併。 ## 後續取票順序與依賴 - 先完成 #32 C0 的只讀核對，記錄 CI 阻擋，不反覆空 commit 或 close/reopen。 - 核對 #29 B0、#30 V0 的 P1 基線；有 SDK/device 就執行最新相關分支，沒有就明確標示缺哪個環境，不能把整個 backlog 都標 blocked。 - 在不修改上述基線的獨立工作上，先做 #17 S1/S2 這類範圍小的 UI 誠實標示；之後 #33 必須按 J1→J2→J3，每步都有交易／負對照，不能一次重寫 capture engine。 - #29 B1/B2/B3、#30 V1–V4 各自一個子項；完成來源 resolver 後共用，不複製第二套。 - #31 配合已修改畫面補可及／視窗驗收；真服務、真來源與 release runtime 另需裝置證據。 - C2 為未來發版準備，**本索引不授權建立公開 release、Play 發布或更改公開 tags**。 ## 證據分級（不可混用） - `SOURCE_REVIEWED`：讀到 code／斷言，不代表執行通過。 - `HOST_REPRODUCED`／`HOST_TEST_PASSED`：只代表明確列出的 host 程式與 fixture。 - `REFERENCE_DESIGN_ONLY`：另寫模型驗設計想法，不是 production 修正。 - `ANDROID_EMULATOR_PASSED`：必須有實際 APK、API、裝置與 instrumentation XML。 - 真來源／實機相容性依原 `COMPATIBILITY.md` 的精確 cohort gate；synthetic publisher 不能代替真 LINE／WhatsApp 等來源。 - 狀態可寫 `UNTESTED`、`PARTIAL`、`BLOCKED_ENV`、`FAIL`；不存在的證據不要補成 PASS。 #37 的 shell 以 Git blob `d8e72fe83568d5eee935d3231876a179bcfc32ea` 核對到與 main/#34 相同，再真正執行。#33 的 2 個 extracted-SQL 行為重現與 5 個 reference-design 控制案例分開記錄；**7 個 host 測試綠，不是 Room／SQLCipher 已修好**。 ## 每個子項的交付模板 ``` Issue / 子項： Baseline：main SHA、工作分支 head、相關 PR head/base/test-merge SHA 修改：實際檔案與行為，不只摘要 RED：命令、rc、測試數、失敗斷言、log GREEN：命令、rc、測試數、log 負對照：如何證明測試會抓到原缺陷 平台：HOST / ANDROID_EMULATOR / REAL_DEVICE；APK SHA256（適用時） 證據：artifact / XML / 截圖 / run/job links 未完成：具體 case、BLOCKED_ENV 原因、需要的最小環境 PR / commit：實際 URL 和 SHA 狀態：本子項完成到哪層；原 issue 保持 OPEN ``` ## 禁止捷徑 不刪改原票歷史、不降低 #29/#30 P1；不捏造 issue/test/file/run；不以 grep、mock、NO-SOURCE、0 tests、全 skipped、舊 XML、固定 sleep 負斷言當完整通過；不弱化斷言／timeout 門檻；不把 IOException、fatal Error、CancellationException 全吞成普通成功或 IO。 不自動關票，不用自動 close keywords，不 merge／force-push／發版；不改 required checks、分支保護或 app 身分。不要擴大通知／網路權限，不操作來源通知或使用真實聊天／恢復金鑰測試。每次只處理一個可驗收子項，做實作與測試，不停在另寫一份計畫。