衛生批次:lint 全綠(3 error+3 warning 清零)+ smoke 加 Direct-Map 未啟用警示¶

背景¶

兩件技術債:

1. npm run lint 長期紅燈(3 error + 3 warning,皆為 #413 之前的舊病)——
   紅燈狀態下 lint 無法當品質門檻用,新增警告會被舊噪音淹沒
2. 2026-08-06 發生「確定碼靜靜消失」事故:backend 重啟漏帶 ICD_DIRECTMAP=on
   (該開關當時只存在 shell 環境變數、不在 .env),smoke test 56 項照樣全 PASS
   (7.0 檢查刻意設計成 on/off 都合法)→ 環境缺配走漏,靠人工發現

變更內容¶

lint 清零(行為不變的重構)¶

• lib/auth-context.tsx、components/HistorySidebar.tsx:effect 內同步 setState
  (react-hooks/set-state-in-effect error)→ 改 async + await Promise.resolve()
  微任務模式(與 app/plugin/page.tsx 既有 idiom 一致)+ cancelled 防護
• components/ReviewTab.tsx:cleanPartName 的 let cleaned → const(prefer-const)
• app/page.tsx:移除未使用的 useCallback import
• components/SoftTissueTab.tsx:移除死碼 renderPath(前/後視圖統一改用
  overlay 渲染後即未再被呼叫)與未使用的 FRONT_VIEWBOX import

smoke test 加 Direct-Map 未啟用警示¶

• 7.0 檢查後偵測到 Direct-Map off 時印醒目警告區塊(不算 FAIL —— off 是
  合法 rollback 狀態),提示部署機檢查 backend/.env 的 ICD_DIRECTMAP=on
• 「程式碼與環境設定必須成對」的守門零件(同型教訓:向量庫 cosine 重建)

驗收標準¶

• npm run lint exit 0、零 error 零 warning(首次全綠)
• tsc --noEmit 過;npm run build 過
• smoke test 全 PASS;Direct-Map on 時無警告輸出(off 分支語法檢查通過)
• 登入還原/病歷列表載入行為不變(純 lint 合規重構,無語意變更)