"""Phase5-H Feature Flags (PRD §51 Stage 1 - Rollback)。

5 個 env-driven flag，全為「預設啟用、出問題可關掉」設計。

| Flag                    | env 名稱                | 預設 | 作用                                              |
|-------------------------|------------------------|------|--------------------------------------------------|
| 2FA 強制                | FEATURE_2FA            | true | false → admin/senior_manager 不再強制 2FA grace |
| senior_manager 角色 UI  | FEATURE_SENIOR_MANAGER | true | false → 不可建立 senior_manager 帳號（API+UI 雙鎖）|
| 垃圾桶頁 UI            | FEATURE_TRASH_UI       | true | false → 前端隱藏垃圾桶頁入口（後端仍可運作）       |
| 帳號管理進階篩選 UI    | FEATURE_ACCOUNT_FILTER | true | false → 前端退回簡化版使用者管理頁                |
| FTS5 全文檢索          | FEATURE_FTS5           | false| true → search.py 走 FTS5；其他模組此檔僅顯示狀態  |

註：`FEATURE_FTS5` 預設為 false（與 search.py L36 一致：中文 LIKE 較可靠）。
"""
from __future__ import annotations

import os
from typing import Any


def _truthy(env_name: str, default: bool) -> bool:
    raw = os.environ.get(env_name)
    if raw is None:
        return default
    return raw.strip().lower() in ("1", "true", "yes", "on")


def feature_2fa() -> bool:
    return _truthy("FEATURE_2FA", True)


def feature_senior_manager() -> bool:
    return _truthy("FEATURE_SENIOR_MANAGER", True)


def feature_trash_ui() -> bool:
    return _truthy("FEATURE_TRASH_UI", True)


def feature_account_filter() -> bool:
    return _truthy("FEATURE_ACCOUNT_FILTER", True)


def feature_fts5() -> bool:
    return _truthy("FEATURE_FTS5", False)


def feature_hsts() -> bool:
    """是否輸出 HSTS header。dev/http 預設 off；正式 HTTPS 部署設 KBV5_HSTS=1。"""
    return _truthy("KBV5_HSTS", False)


def get_all() -> dict[str, Any]:
    return {
        "FEATURE_2FA": feature_2fa(),
        "FEATURE_SENIOR_MANAGER": feature_senior_manager(),
        "FEATURE_TRASH_UI": feature_trash_ui(),
        "FEATURE_ACCOUNT_FILTER": feature_account_filter(),
        "FEATURE_FTS5": feature_fts5(),
    }