自コードの Required Reason API 申告漏れを Claude Code で棚卸しする

#!/usr/bin/env python3
"""scan_required_reason.py — 自コードの Required Reason API を検出する。"""
import re
import sys
from pathlib import Path
 
# カテゴリ -> (検出シンボル, 個人開発でよく使う候補理由コード)
CATEGORIES = {
    "UserDefaults": (
        [r"\bUserDefaults\b", r"\bNSUserDefaults\b"],
        ["CA92.1"],
    ),
    "FileTimestamp": (
        [r"\.modificationDate\b", r"\.creationDate\b",
         r"\bcontentModificationDateKey\b", r"\bfstat\b", r"\bstat\("],
        ["C617.1", "3B52.1", "0A2A.1"],
    ),
    "DiskSpace": (
        [r"volumeAvailableCapacity\w*Key", r"\bsystemFreeSize\b",
         r"\bvolumeTotalCapacityKey\b"],
        ["85F4.1", "E174.1"],
    ),
    "SystemBootTime": (
        [r"\.systemUptime\b", r"\bmach_absolute_time\b"],
        ["35F9.1"],
    ),
}
 
def scan(root: Path):
    hits = {}  # category -> list[(file, line_no, snippet)]
    for swift in root.rglob("*.swift"):
        if "/Pods/" in str(swift) or "/.build/" in str(swift):
            continue
        for i, line in enumerate(swift.read_text(encoding="utf-8",
                                                 errors="ignore").splitlines(), 1):
            for cat, (patterns, _codes) in CATEGORIES.items():
                if any(re.search(p, line) for p in patterns):
                    hits.setdefault(cat, []).append(
                        (swift.name, i, line.strip()[:80]))
    return hits
 
if __name__ == "__main__":
    root = Path(sys.argv[1] if len(sys.argv) > 1 else ".")
    found = scan(root)
    if not found:
        print("該当なし。宣言が必要な自コード API は見つかりませんでした。")
        sys.exit(0)
    for cat, (_, codes) in CATEGORIES.items():
        if cat in found:
            print(f"\n[{cat}] 候補理由コード: {', '.join(codes)}")
            for name, ln, snip in found[cat]:
                print(f"  {name}:{ln}  {snip}")

<key>NSPrivacyAccessedAPITypes</key>
<array>
  <dict>
    <key>NSPrivacyAccessedAPIType</key>
    <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
    <key>NSPrivacyAccessedAPITypeReasons</key>
    <array>
      <string>CA92.1</string>
    </array>
  </dict>
  <dict>
    <key>NSPrivacyAccessedAPIType</key>
    <string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
    <key>NSPrivacyAccessedAPITypeReasons</key>
    <array>
      <string>C617.1</string>
    </array>
  </dict>
</array>