feature: startup banner 偵測「versioned claude host + EventKit 未授權」組合並主動提示 (sister concern from #170)

[kiki830621]

Problem

#170 診斷確認的緩解選項 2：每次 Claude Code 自動更新輪替 versioned binary path（~/.local/share/claude/versions/<N>），host 側 TCC grant 失效，使用者只會看到 tool call 突然 access denied，無主動提示。

#122 的 startup banner drift detector 已有「stale process / csreq mismatch」等 signal 家族；缺一個「host context 是 versioned claude binary 且 Calendar/Reminders notDetermined 或 denied」的組合 signal — 命中時主動提示使用者去 System Settings toggle 新版本號 entry（或觸發 re-prompt），把「昨天還能用今天壞了」的困惑收斂成一行可行動訊息。

Type

feature（drift detector 新 signal）

Expected

1. Banner 偵測邏輯：walk parent chain 找 ~/.local/share/claude/versions/ pattern（判定 host = Claude Code versioned binary）＋ 該 context 下 EventKit authorizationStatus 非 fullAccess → emit 提示行（含 troubleshoot-tcc 指引 pointer）
2. 沿用 [bug] v1.9.0: create_event 仍回 "denied" 即使 similar_events 讀取成功（read/write auth status 矛盾） #122 signal 慣例：advisory、stderr、非阻塞、可 CHE_ICAL_MCP_NO_BANNER 關閉
3. 測試：detector signal 的 fake-driven 單元測試（TCCDriftDetectorTests 家族慣例）

Dependency（Blocking）

Blocked on PR #174 merge（#169 的 ParentChainSource — parent chain 判定所需 primitive）。若 #174 被 reject，替代路徑：banner 內建輕量單層 getppid() + proc_pidpath 檢查（不 walk 全鏈，只認直系 parent 的 versions/ pattern）。

---

Source: surfaced during /idd-diagnose #170 sister concern surfacing (Step 3.6)

---

Current Status

Phase: closed
Last updated: 2026-07-10 by /idd-verify

• Diagnosis: comment
• Implementation: commits 80591bc + 37e4e94 + d3e51a8 on idd/175-banner-versioned-host-signal
• Verify: PASS (6-AI) — 3/3 FULLY；兩 MEDIUM（gate 全 EventKit 化、DA 淨新的 --setup 矛盾抑制）皆 in-scope 修畢；490 tests 0 failures
• PR: feat: startup banner 偵測「versioned Claude Code host + EventKit 未授權」並主動提示 (#175) #179
• Closed: 2026-07-10 — PR feat: startup banner 偵測「versioned Claude Code host + EventKit 未授權」並主動提示 (#175) #179 merged (a528992)

[kiki830621]

Diagnosis

Type

feature（#122 drift detector 新 signal）

Root Cause / Analysis

需求：#170 確認的緩解選項 2 — banner 在「host context 是 Claude Code versioned binary 且 EventKit 未授權（notDetermined/denied）」時主動提示，把更新後靜默斷線收斂成一行可行動訊息。

技術路徑（primitive 已在 #174/PR merge 後的 main）：

• Host 判定：ParentChainSource.captureChain(from: getppid()) walk 結果中任一 hop 的 command 匹配 /.local/share/claude/versions/ pattern → host = Claude Code versioned binary。banner 在 MCP server mode 下跑（emitStartupBanner()，main.swift），parent chain 即真實 host chain。
• 授權判定：banner 已有 LiveAuthorizationStatusSource().authorizationStatus(for: .event) cheap probe（Calendar TCC dialog never presents from --setup (bare CLI has no foreground NSApplication) #163 先例，main.swift:176），notDetermined/denied 直接可讀 — 在 MCP server mode 下這正是 host context 的授權（TCC 授權除了 CheICalMCP binary 本身，Claude Code app 本身的權限可能也是必要條件 #168 結論），兩信號組合即成。
• Signal 掛載：TCCDriftDetector 的 DriftSignal enum + signals.append(...) + formatBanner 慣例（[bug] v1.9.0: create_event 仍回 "denied" 即使 similar_events 讀取成功（read/write auth status 矛盾） #122/Drift detector: surface csreq-mismatch + empty-entitlements silent-denial signature — third member of #122 class (sister concern from #154) #155 先例：tccPathMismatch/csreqMismatch/staleProcesses）— 新增 case .versionedHostUngrated(hostPath: String, service: String)，訊息含「host binary rotates on every Claude Code update（Claude Code 自動更新使 TCC grant 隨 versioned binary path 失效，host 側授權反覆斷 (sister concern from #168) #170）→ System Settings toggle 最新版本號 entry / 觸發 re-prompt」+ troubleshoot-tcc pointer。

設計決策（實作時釘死）：

1. ParentChainSource 注入 detector 走 Test Seam Convention（narrow source 已存在，detector init 加參數 default LiveParentChainSource()）
2. ps 500ms timeout 已內建；banner 對 chain capture 失敗 → skipReasons append（不 block startup，[bug] v1.9.0: create_event 仍回 "denied" 即使 similar_events 讀取成功（read/write auth status 矛盾） #122 advisory 契約）
3. 只在「versioned claude host 匹配 AND 授權非 fullAccess」同時成立才 emit — 避免對已授權使用者製造噪音

Impact

• 影響檔案：TCCDriftDetector.swift（signal case + 判定 + format）、main.swift（emitStartupBanner 傳 chain 或 source）、TCCDriftDetectorTests.swift / TCCDriftFakes.swift（fake ParentChainSource + 判定測試）
• 使用者流程：Claude Code 更新後首次 tool call 前，banner 主動指路 — Claude Code 自動更新使 TCC grant 隨 versioned binary path 失效，host 側授權反覆斷 (sister concern from #168) #170 現象從「靜默壞掉」變「開機即提示」

Strategy

• TCCDriftFakes.swift 加 FakeParentChainSource；DriftSignal 新 case + detector 判定邏輯（TDD：fake chain 含/不含 versions/ pattern × 授權 granted/denied 四象限測試）
• formatBanner render 新 signal（訊息含 Claude Code 自動更新使 TCC grant 隨 versioned binary path 失效，host 側授權反覆斷 (sister concern from #168) #170 pointer + 行動指引）+ 測試
• main.swift 接線（detector init 注入 LiveParentChainSource）
• chain capture 失敗 → skipReasons（graceful，測試）

Conflict Class

C_shared_module_coord — 共享資源：ParentChainSource.swift（#173 polish bundle 會改 walk 語意/parse 行為）。序列化：#173 先、#175 後（本 feature 消費該 seam，等其穩定）。Blocked on PR #174 merge（primitive 上 main）。

Complexity

Simple — 完全跟 #122 signal 家族既有 pattern 走（enum case + fake + formatBanner + seam 注入都是第 N 個已知 instance）；Hard-gate: not triggered（3-4 檔同族 feature、無 shared abstraction 修改 — ParentChainSource 只消費）。

Risks

• versioned path pattern 匹配寫太窄（未來 Claude Code 改安裝佈局）→ pattern 常數化 + 註明來源，失配時自然靜默（advisory 容錯）
• banner 每次 startup 多一次 ps spawn（500ms cap）— 與 [bug] v1.9.0: create_event 仍回 "denied" 即使 similar_events 讀取成功（read/write auth status 矛盾） #122 的 ps inventory 同級成本，可接受；實作時考慮共用單次 snapshot（若 detector 已跑 ProcessInventory 的 ps，仍是兩次呼叫 — 優化留 residue）

Residue

• 「主動提示」不能代使用者完成 re-grant（TCC 對話框只能由使用者觸發/操作）— 提示層天花板
• ps snapshot 共用優化（detector 內兩個 ps 消費者）非本 issue 必要範圍

[kiki830621]

Verify: #175

Engine

manual fan-out (4 lens Agents + sequenced DA, model: opus, file-based output) + Codex (gpt-5.5 xhigh via codex-call), model: opus — 6/6 findings 齊備，無 process gap

要求覆蓋率

3 / 3 Expected FULLY addressed（含診斷設計決策逐項落實：seam 注入、gate 順序、advisory 契約、fake-driven 測試家族）

Findings（合併後）

#	Severity	Finding	Source	Action
1	MEDIUM	gate 只讀 Calendar（.event）但宣稱涵蓋 Reminders — Reminders-only 破損在 versioned host 下雙重靜默（#175 signal 與 #163 行都不 fire）；DA 舉證相鄰碼（--print-tcc-path/SetupWindow）皆雙服務探測，收窄非慣例	agents:requirements+logic+devils-advocate(DA-1)	In-scope fix — d3e51a8（gate 改 eventKitAccessGranted = Calendar AND Reminders，main.swift 讀雙 status）
2	MEDIUM	#175 signal 與 #163 --setup 行並存時給出互相矛盾的補救指示 — --setup 授權 CheICalMCP 自身 attribution，非輪替掉的 host grant，是該情境的死路（四 lens + Codex 全漏，DA 淨新）	agents:devils-advocate(DA-2)	In-scope fix — d3e51a8（versioned-host signal 命中時抑制 #163 行 + 對照測試釘死兩向行為）
3	LOW	「granted 零 subprocess」承諾僅結構性守住、不可觀察	codex + agents:logic(L3)	In-scope fix — d3e51a8（SpyParentChainSource 斷言 captureCallCount == 0）
4	LOW	pattern 硬編碼 fragment 對 Claude Code 安裝佈局的脆弱耦合（搬目錄→靜默 false negative）；ps comm 完整路徑假設無 real-subprocess 釘住	agents:logic(L1/L4) + requirements(F2)	記錄備查（#170 文件為現行最佳依據；誤報方向安全）
5	LOW	eventKitAccessGranted default true 的「未接線即靜默關閉」語意（未來第二個 caller 風險）；getppid seam 不可觀察	agents:regression + logic(L2)	記錄備查（現況唯一 caller 已正確接線）
6	INFO	signal 可被祖先 comm 偽造觸發 false positive（advisory、無 auto-action，無實質攻擊價值）	agents:security	記錄備查
7	—	DA-3 裁決：banner once-at-startup 時序對本 signal 的主失敗模式正好對齊（rotation 後新 host 重 spawn MCP 即重跑 banner），非缺陷；與 staleProcesses signal 互補足夠	agents:devils-advocate	無需行動

Scope Check

無 scope creep；既有三個 signal 家族行為不變（regression lens 實跑 49 detector tests + 6 banner spawn tests 全綠）；#163 行為僅在「versioned-host signal 同時命中」時讓位（DA-2 修正），一般 ungranted 情境原樣（對照測試釘住）。

Process Gaps

（無）

Verdict

PASS — 0 blocking。兩個 MEDIUM + 1 LOW 全數 in-scope 修畢（d3e51a8）。490 tests 0 failures。Commits: 80591bc（signal 主體）、37e4e94（changelog）、d3e51a8（verify fixes）。

Follow-up Findings Filed (v2.72.0+ #148)

（無新 issue — MEDIUM 全修，LOW/INFO 為記錄性質）

[kiki830621]

Verify: #175

Engine

manual fan-out (4 lens Agents + sequenced DA, model: opus, file-based output) + Codex (gpt-5.5 xhigh via codex-call), model: opus

要求覆蓋率

3 / 3 Expected FULLY addressed（含診斷設計決策全數落實：seam 注入、ps 500ms、capture 失敗 → skipReason、gate 短路零噪音）

Findings（合併後）

#	Severity	Finding	Source	Action
1	MEDIUM	gate 只讀 Calendar（.event）但 signal 宣稱涵蓋 Reminders — Reminders-only 破損在 versioned host 下雙重靜默（#175 signal 與 #163 行都不 fire）；DA 反例：相鄰碼（--print-tcc-path/SetupWindow）皆雙服務探測，收窄非既有慣例	agents:requirements+logic+devils-advocate	In-scope fix — d3e51a8（gate 改 eventKitAccessGranted = Calendar AND Reminders 皆授權才跳過；main.swift 讀雙 status）
2	MEDIUM	DA 淨新盲點（四 lens + Codex 全漏）：#175 signal 與 #163 --setup 行並存時給出互相矛盾的補救 — --setup 授權 CheICalMCP-as-foreground 的 attribution，不是輪替掉的 host grant，是該情境的死路	agents:devils-advocate	In-scope fix — d3e51a8（signal 命中時抑制 --setup 行 + 雙向控制測試）
3	INFO	Codex 建議：granted path 零 subprocess 承諾應可觀察地測	codex	In-scope fix — d3e51a8（SpyParentChainSource 零呼叫斷言）
4	LOW	pattern 匹配倚賴「ps comm 吐完整路徑」假設，無 real-ps 格式釘測；fragment 硬編碼對 Claude Code 佈局變更為脆弱耦合（漏報方向，安全）	agents:logic(L1/L4)	記錄備查（#173 已有 fixture 層測試；real-ps 格式釘測列 optional）
5	INFO	signal 可被祖先 comm 偽造（advisory、無 auto-action、攻擊者能力遠大於收益）；eventKitAccessGranted default true 的 opt-in 語意（未來新 caller 忘接線會靜默關閉）；getppid seam 對 fake 不可見	agents:security+regression+logic	記錄備查
6	—	DA-3 裁決：banner once-at-startup 時序對主失敗模式（更新→host 重啟→新 process 在新 context 下起動）正好對齊，非缺陷；與 staleProcesses signal 互補成立	agents:devils-advocate	無需行動

Scope Check

無 scope creep：既有三 signal 族行為不變（regression 實跑 49+6 tests）；#163 行為僅在「#175 signal 命中」的新情境下讓位（DA-2 修正），平常路徑照舊（控制測試釘住）；banner 跳過清單不受影響。

Process Gaps

（無 — 6/6 齊備）

Verdict

PASS — 0 blocking。兩個 MEDIUM 皆 in-scope 修畢（d3e51a8）。490 tests 0 failures。Commits: 80591bc（signal 主體）、37e4e94（changelog）、d3e51a8（verify fixes）。

Follow-up Findings Filed

（無新 issue — MEDIUM 全修畢，LOW/INFO 記錄於本 report 備查）

[kiki830621]

Closing Summary

Checklist gate

Diagnosis Strategy 4 項全數落實（verify master report 逐項核對 3/3 Expected FULLY + in-scope fixes）；0 blocking。

Need

#170 確認的緩解選項 2：Claude Code 每次更新輪替 versioned binary path、host 側 TCC grant 靜默失效 — 使用者只在 tool call 失敗時才發現。需要 startup banner 主動偵測並指路。

Solution（PR #179，squash a528992）

• 新 DriftSignal.versionedClaudeHostUngranted（[bug] v1.9.0: create_event 仍回 "denied" 即使 similar_events 讀取成功（read/write auth status 矛盾） #122 signal 家族第 4 個成員）：parent chain（ParentChainSource，feature: --print-tcc-path 應顯示執行 context（parent chain）與 context-dependence 警告 (sister concern from #168) #169）含 /.local/share/claude/versions/ pattern 且 EventKit 未完整授權（Calendar 或 Reminders 任一）→ banner 解釋輪替現象 + 行動指引（System Settings toggle 最新版本號 / re-prompt / troubleshoot-tcc）
• verify in-scope 強化（d3e51a8）：gate 全 EventKit 化（DA-1 — Reminders-only 破損不再雙重靜默）；signal 命中時抑制矛盾的 Calendar TCC dialog never presents from --setup (bare CLI has no foreground NSApplication) #163 --setup 行（DA-2 淨新盲點 — 該情境下 --setup 授權錯的 attribution 身分）；SpyParentChainSource 可觀察地釘住「授權完整者零 subprocess」承諾
• granted 使用者零噪音零成本；capture 失敗 → 可見 skipReason（[bug] v1.9.0: create_event 仍回 "denied" 即使 similar_events 讀取成功（read/write auth status 矛盾） #122 advisory 契約）

Verification

6-AI verify PASS（master report）：3/3 FULLY、兩 MEDIUM in-scope 修畢、490 tests 0 failures、CI 綠、merged。

Related / Residue

• 上游 root fix 追蹤：Claude Code 自動更新使 TCC grant 隨 versioned binary path 失效，host 側授權反覆斷 (sister concern from #168) #170（upstream Native-install auto-update rotates the versioned binary path, invalidating macOS TCC grants attributed to Claude Code (Calendar/Reminders observed) anthropics/claude-code#76246 已 filed）— 本 signal 是偵測層緩解，非根治
• LOW/INFO 記錄於 verify report 備查（real-ps comm 格式釘測 optional、fragment 對 Claude Code 佈局的脆弱耦合屬漏報方向安全）