API レベル 36 の期限に向けた、6本のアプリを上げる順番と段階公開の刻み方

#!/usr/bin/env python3
"""複数の Android プロジェクトを横断し、targetSdk と「触っている面」を1表にする。
 
使い方:
    python3 surface_audit.py ~/apps/*/
"""
import re
import sys
from pathlib import Path
 
# 挙動変更の影響を受けやすい面。左が表示名、右が (検出用の手がかり, 重み)。
SURFACES = {
    "media-write":  (r"WRITE_EXTERNAL_STORAGE|MediaStore\.", 3),
    "fg-service":   (r"FOREGROUND_SERVICE|startForeground", 3),
    "exact-alarm":  (r"SCHEDULE_EXACT_ALARM|setExactAndAllowWhileIdle", 2),
    "notification": (r"POST_NOTIFICATIONS|NotificationManagerCompat", 1),
    "edge-to-edge": (r"enableEdgeToEdge|WindowCompat\.setDecorFitsSystemWindows", 2),
    "native-lib":   (r"externalNativeBuild|\.so\b|ndkVersion", 3),
    "billing":      (r"com\.android\.billingclient", 2),
    "ads":          (r"play-services-ads|applovin|unity-ads|pangle", 2),
}
 
SDK_RE = re.compile(r"(targetSdk(?:Version)?|compileSdk(?:Version)?|minSdk(?:Version)?)"
                    r"\s*(?:=|\s)\s*['\"]?(\d{2})['\"]?")
 
 
def read_text(p: Path) -> str:
    try:
        return p.read_text(encoding="utf-8", errors="ignore")
    except OSError:
        return ""
 
 
def scan(root: Path) -> dict:
    blob = []
    sdk = {}
    for pattern in ("**/build.gradle", "**/build.gradle.kts",
                    "**/AndroidManifest.xml", "**/gradle/libs.versions.toml"):
        for f in root.glob(pattern):
            if "/build/" in str(f):      # ビルド生成物は読まない
                continue
            text = read_text(f)
            blob.append(text)
            for key, val in SDK_RE.findall(text):
                sdk.setdefault(key.replace("Version", ""), val)
    joined = "\n".join(blob)
    hits, score = [], 0
    for name, (rx, weight) in SURFACES.items():
        if re.search(rx, joined):
            hits.append(name)
            score += weight
    return {"name": root.name, "sdk": sdk, "hits": hits, "score": score}
 
 
def main() -> None:
    roots = [Path(a).expanduser() for a in sys.argv[1:]]
    if not roots:
        print("プロジェクトのルートを1つ以上渡してください", file=sys.stderr)
        raise SystemExit(2)
    rows = [scan(r) for r in roots if r.is_dir()]
    rows.sort(key=lambda r: -r["score"])
    print(f"{'app':<22}{'target':>7}{'min':>5}{'risk':>6}  surfaces")
    for r in rows:
        print(f"{r['name']:<22}{r['sdk'].get('targetSdk', '-'):>7}"
              f"{r['sdk'].get('minSdk', '-'):>5}{r['score']:>6}  {','.join(r['hits'])}")
 
 
if __name__ == "__main__":
    main()

#!/usr/bin/env python3
"""段階公開の刻み幅を、判断に必要な観測数から逆算する。
 
使い方:
    python3 rollout_sizing.py --dau 12000 --baseline 0.005 --tolerate 2.0
"""
import argparse
from statistics import NormalDist
 
ND = NormalDist()
 
 
def sessions_needed(p0: float, p1: float, alpha: float = 0.05, power: float = 0.80) -> float:
    """p0 から p1 への悪化を検出するのに必要な、片群あたりのセッション数。"""
    if p1 <= p0:
        raise ValueError("p1 は p0 より大きい必要があります")
    za = ND.inv_cdf(1 - alpha)          # 片側検定
    zb = ND.inv_cdf(power)
    pbar = (p0 + p1) / 2
    num = (za * (2 * pbar * (1 - pbar)) ** 0.5
           + zb * (p0 * (1 - p0) + p1 * (1 - p1)) ** 0.5) ** 2
    return num / (p1 - p0) ** 2
 
 
def zero_event_upper_bound(n: int) -> float:
    """n 件観測して 0 件だったときのクラッシュ率の 95% 上限（rule of three）。"""
    return 3.0 / n if n > 0 else 1.0
 
 
def main() -> None:
    ap = argparse.ArgumentParser()
    ap.add_argument("--dau", type=float, required=True, help="そのアプリの1日あたりセッション数")
    ap.add_argument("--baseline", type=float, default=0.005, help="現行版のクラッシュ率")
    ap.add_argument("--tolerate", type=float, default=2.0,
                    help="見逃したくない悪化の倍率（2.0 なら 2 倍まで）")
    ap.add_argument("--max-days", type=float, default=3.0, help="1段階に使える最大日数")
    args = ap.parse_args()
 
    p0 = args.baseline
    p1 = p0 * args.tolerate
    need = sessions_needed(p0, p1)
 
    print(f"現行クラッシュ率      : {p0 * 100:.3f}%")
    print(f"見逃したくない悪化    : {p1 * 100:.3f}%（{args.tolerate:.1f} 倍）")
    print(f"必要セッション数/群   : {need:,.0f}")
 
    for pct in (1, 5, 10, 20, 50, 100):
        per_day = args.dau * pct / 100
        days = need / per_day if per_day else float("inf")
        verdict = "◯" if days <= args.max_days else "×"
        bound = zero_event_upper_bound(int(per_day * args.max_days))
        print(f"  {pct:3d}% 配信 → {per_day:9,.0f} セッション/日 / "
              f"判定まで {days:6.1f} 日 {verdict} / "
              f"{args.max_days:.0f}日で0件なら上限 {bound * 100:.2f}%")
 
 
if __name__ == "__main__":
    main()