非推奨の通知が出た朝、設定を書き換える前にバージョンを確かめた話

#!/usr/bin/env python3
"""管理構成 JSON に残った旧い綴りを、対処の順番ごとに仕分けします。
使い方: python3 audit_config.py bootstrap.json [more.json ...]
終了コード: 0=旧綴りなし / 1=B か C の項目あり / 2=A のみ"""
import json, sys
 
# (旧綴り, 新綴り, 箱)
#   A = 先に書き換えてよい / B = クライアントを上げてから / C = 触らなくても意味が変わる
RENAMES = [
    ("inferenceGatewayHeaders", "inferenceCustomHeaders",              "A"),
    ("trustBootstrapLocalExec", "trustBootstrapDelivery",              "A"),
    ("enduserAttribution",      "endUserAttribution",                  "A"),
    ("isDxtEnabled",            "isDesktopExtensionEnabled",           "A"),
    ("isDxtSignatureRequired",  "isDesktopExtensionSignatureRequired", "A"),
    ("authorityHost",           'azureCloud: "us-gov-high"',           "A"),
]
HEADER_MAPS = ["inferenceCustomHeaders", "otlpHeaders",
               "otlpResourceAttributes", "bootstrapHeaders"]
 
 
def walk(node, path=""):
    """ネストした dict / list を (パス, キー, 値) で平坦に辿ります。"""
    if isinstance(node, dict):
        for k, v in node.items():
            here = f"{path}.{k}" if path else k
            yield here, k, v
            yield from walk(v, here)
    elif isinstance(node, list):
        for i, v in enumerate(node):
            here = f"{path}[{i}]"
            yield here, None, v
            yield from walk(v, here)
 
 
def audit(cfg):
    found = []
    for path, key, value in walk(cfg):
        if key is None:
            continue
        for old, new, bucket in RENAMES:
            if key == old:
                found.append((bucket, path, f"{old} -> {new}"))
        # ヘッダ類は JSON オブジェクトでなければ受け付けられなくなります
        if key in HEADER_MAPS and not isinstance(value, dict):
            found.append(("A", path,
                          f"{key} が {type(value).__name__} です -> JSON オブジェクトへ"))
        # record 形式の orgPluginSettings は array 形式へ。ただし配布側を先に上げます
        if key == "orgPluginSettings" and isinstance(value, dict):
            found.append(("B", path,
                          "orgPluginSettings が record 形式です -> array 形式へ"
                          "（配布中の Desktop を 1.15200.0 より後へ上げてから）"))
        # ask-session は ask へ
        if key in ("builtinToolPolicy", "toolPolicy", "permission"):
            vals = value.values() if isinstance(value, dict) else [value]
            if any(v == "ask-session" for v in vals):
                found.append(("A", path, "ask-session -> ask"))
        # Vertex: ネストした JSON で配っているなら、全台が上がるまで oauth のまま
        if key == "inferenceCredentialKind" and value == "oauth":
            found.append(("B", path,
                          'inferenceCredentialKind: "oauth" -> "interactive"'
                          "（ネスト配布なら全台を上げ切ってから）"))
    # 触らなくても 10/07 に解釈が変わる組み合わせ
    if (cfg.get("inferenceCredentialKind") == "interactive"
            and "inferenceVertexWorkforceAudience" in cfg
            and "inferenceVertexOAuthClientId" not in cfg):
        found.append(("C", "(top level)",
                      "いまは Workforce Identity と読まれますが、10/07 以降は "
                      "Google サインインになります -> workforce を明示"))
    return found
 
 
def main(paths):
    buckets = {"A": [], "B": [], "C": []}
    for p in paths:
        with open(p, encoding="utf-8") as fh:
            cfg = json.load(fh)
        for bucket, path, msg in audit(cfg):
            buckets[bucket].append(f"{p}:{path}  {msg}")
    labels = {"A": "A 先に書き換えてよいもの",
              "B": "B クライアントを上げてから書き換えるもの",
              "C": "C 書き換えなくても期限後に意味が変わるもの"}
    for b in ("A", "B", "C"):
        print(f"\n## {labels[b]}  ({len(buckets[b])} 件)")
        for line in buckets[b] or ["  （該当なし）"]:
            print("  " + line if not line.startswith("  ") else line)
    if buckets["B"] or buckets["C"]:
        return 1
    return 2 if buckets["A"] else 0
 
 
if __name__ == "__main__":
    sys.exit(main(sys.argv[1:]))

## A 先に書き換えてよいもの  (4 件)
  sample.json:inferenceGatewayHeaders  inferenceGatewayHeaders -> inferenceCustomHeaders
  sample.json:otlpHeaders  otlpHeaders が str です -> JSON オブジェクトへ
  sample.json:isDxtEnabled  isDxtEnabled -> isDesktopExtensionEnabled
  sample.json:managedMcpServers[0].toolPolicy  ask-session -> ask
 
## B クライアントを上げてから書き換えるもの  (1 件)
  sample.json:orgPluginSettings  orgPluginSettings が record 形式です -> array 形式へ（配布中の Desktop を 1.15200.0 より後へ上げてから）
 
## C 書き換えなくても期限後に意味が変わるもの  (1 件)
  sample.json:(top level)  いまは Workforce Identity と読まれますが、10/07 以降は Google サインインになります -> workforce を明示