1# 自訂實作（看似合理，實則隱藏成本）
 2class LazyFileHandler(logging.FileHandler):
 3    """延遲建立檔案的 Handler"""
 4    def __init__(self, filename, mode='a', encoding=None):
 5        self.filename = filename
 6        self.mode = mode
 7        self._file_created = False
 8        # 不呼叫 super().__init__() 以避免建立檔案
 9        logging.Handler.__init__(self)
10
11    def emit(self, record):
12        if not self._file_created:
13            os.makedirs(os.path.dirname(self.filename), exist_ok=True)
14            self._file_created = True
15        super().emit(record)
16        # AttributeError: 'LazyFileHandler' has no attribute 'stream'

11. 開發成本：寫自訂類別          ~30 分鐘
22. 除錯成本：追蹤 AttributeError  ~1 小時
33. 修復成本：派發 hotfix 任務      ~2 小時
44. 驗證成本：確認修復後無迴歸      ~30 分鐘
5─────────────────────────────────
6   總成本：~4 小時

1# 一行解決
2handler = logging.FileHandler(filename, delay=True)
3# delay=True：延遲到第一次 emit 時才建立檔案
4# Python 3.0 就已存在，經過 15+ 年的穩定性驗證

1# 這段程式碼出現在 11 個 Hook 檔案中
2def read_json_from_stdin():
3    import sys, json
4    try:
5        return json.loads(sys.stdin.read())
6    except Exception:
7        return {}

 1# 修改後的版本
 2def read_json_from_stdin():
 3    import sys, json, logging
 4    logger = logging.getLogger(__name__)
 5    try:
 6        data = sys.stdin.read()
 7        return json.loads(data)
 8    except json.JSONDecodeError as e:
 9        logger.warning("stdin JSON 解析失敗: %s", e)
10        return {}
11    except Exception as e:
12        logger.error("stdin 讀取異常: %s", e)
13        return {}

1第 1 次修改：11 處 x 5 分鐘 = 55 分鐘
2第 2 次修改：11 處 x 5 分鐘 + 排查第 1 次遺漏的 bug = 75 分鐘
3第 3 次修改：11 處 x 5 分鐘 + 排查前兩次的行為不一致 = 120 分鐘
4...

 1# lib/hook_io.py（共用模組）
 2def read_json_from_stdin() -> dict:
 3    """
 4    從 stdin 讀取 JSON 資料。
 5
 6    Returns:
 7        解析後的字典，失敗時返回空字典
 8    """
 9    import sys, json, logging
10    logger = logging.getLogger(__name__)
11    try:
12        data = sys.stdin.read()
13        return json.loads(data)
14    except json.JSONDecodeError as e:
15        logger.warning("stdin JSON 解析失敗: %s", e)
16        return {}
17    except Exception as e:
18        logger.error("stdin 讀取異常: %s", e)
19        return {}

1# 每個 Hook 檔案中
2from lib.hook_io import read_json_from_stdin
3
4input_data = read_json_from_stdin()

1# 「安全」的錯誤處理（實際上是最危險的）
2def run_hook_safely(hook_func):
3    try:
4        hook_func()
5    except Exception as e:
6        # 只寫入檔案日誌，不通知任何人
7        log_to_file(f"Hook 失敗: {e}")

11. 發現問題            0 分鐘（偶然發現，否則可能更久）
22. 確認哪些 Hook 失敗    30 分鐘（需要手動逐一檢查）
33. 找到失敗原因          2 小時（沒有日誌可看，只能猜測）
44. 修復失敗的 Hook       1 小時
55. 驗證修復效果          30 分鐘
66. 確認沒有其他受影響的部分  1 小時
7─────────────────────────
8   總成本：~5 小時（且可能仍有遺漏）

1def run_hook_safely(hook_func, hook_name: str):
2    try:
3        hook_func()
4    except Exception as e:
5        # 寫入檔案日誌（完整追蹤）
6        log_to_file(f"Hook 失敗: {e}", traceback=True)
7        # 輸出到 stderr（確保使用者可見）
8        print(f"[Hook Error] {hook_name}: {e}", file=sys.stderr)

11. 發現問題           0 分鐘（stderr 立即可見）
22. 確認失敗原因        5 分鐘（日誌有完整的 traceback）
33. 修復失敗的 Hook     30 分鐘
44. 驗證修復效果        10 分鐘
5─────────────────────────
6   總成本：~45 分鐘

 1# 方案 A：每次都清理
 2def run_hook():
 3    execute_hook_logic()
 4    cleanup_old_logs()  # 每次 Hook 執行後都清理
 5
 6# 方案 B：每 N 次清理一次
 7LOG_CLEANUP_TRIGGER_FREQUENCY = 10
 8
 9def run_hook():
10    execute_hook_logic()
11    state["execution_count"] += 1
12    if state["execution_count"] % LOG_CLEANUP_TRIGGER_FREQUENCY == 0:
13        cleanup_old_logs()
14
15# 方案 C：外部排程清理
16# 由 cron job 或系統排程器負責
17# Hook 本身不做任何清理

 1LOG_CLEANUP_TRIGGER_FREQUENCY = 10
 2
 3def maybe_cleanup_logs(execution_count: int, log_dir: Path) -> None:
 4    """
 5    根據執行次數決定是否清理舊日誌。
 6
 7    每 LOG_CLEANUP_TRIGGER_FREQUENCY 次觸發一次清理，
 8    在精確度和 I/O 成本之間取得平衡。
 9    """
10    if execution_count % LOG_CLEANUP_TRIGGER_FREQUENCY != 0:
11        return
12    cleanup_old_logs(log_dir)

 1# 方案 A：直接執行，失敗再處理
 2def dispatch_task(task):
 3    try:
 4        result = execute(task)  # 消耗資源
 5    except PermissionError:
 6        # 失敗了，資源已經浪費
 7        log("任務失敗：權限不足")
 8        return None
 9
10# 方案 B：預先驗證
11def dispatch_task(task):
12    if not has_required_permissions(task):
13        log("跳過：權限不足")
14        return None
15    result = execute(task)  # 確認可行才消耗資源

1預驗證成本 = 驗證時間 x 每次派發
2失敗成本 = 任務執行時間 x 失敗機率
3
4當 失敗成本 > 預驗證成本 時，預驗證是值得的

1總成本 = 開發成本 + 維護成本 + 修復成本 + 機會成本