分層設定解析器

json_patch.merge_patch 只合併兩份文件,``config_sync`` 以 last-write-wins 時間戳解析, AssetStore 則是每環境的扁平結構。它們都無法組成一個有序的 defaults < file < env < CLI 優先序 堆疊並做深度 dict 合併,也無法回報*每個鍵由哪一層勝出*。本功能補上這個 12-factor 解析器。

純標準函式庫(copy);不匯入 PySide6。各層為呼叫端提供的純 mapping(env 層由外部傳入,絕不 隱含讀取 os.environ),因此解析在 CI 中具決定性。

無頭 API

from je_auto_control import LayeredConfig, deep_merge

cfg = (LayeredConfig()
       .add_layer("defaults", {"db": {"host": "local", "port": 5432}})
       .add_layer("file", file_values, priority=10)
       .add_layer("env", env_values, priority=20))

settings = cfg.resolve()                  # {"db": {"host": ..., "port": ...}}
host = cfg.get("db.host")
trace = cfg.explain("db.host")            # SourceTrace(value=..., layer="env")

add_layer 註冊一個具名層;``priority`` 越高越勝出(預設為插入順序,因此後加的層覆蓋先前的)。 resolve 依優先序由低到高深度合併每一層 —— 巢狀 dict 遞迴合併,而純量與 list 直接取代。get 以 點分鍵從解析後設定讀取並帶預設值;``explain`` 回傳 SourceTrace,標明點分鍵的勝出層(不存在時拋 KeyError)。deep_merge 另以獨立的雙 mapping 輔助函式提供。

執行器命令

AC_resolve_config 把 layers 清單(每筆 {name, mapping, priority?})深度合併成 {config}。AC_explain_config 對點分 key 回傳 {trace}``(值與勝出層)。兩者皆以 MCP 工具 (``ac_resolve_config / ac_explain_config)以及 Script Builder 中 Data 分類下的命令提供。