起動を止める一つのファイル — config.json の破損に備える設定健全性ガード

# config_guard.py — 実行前の設定健全性ガード
import json
import os
import sys
 
CONFIG_PATH = os.path.expanduser("~/.gemini/config/config.json")
 
# 「これが無いと起動できない」最小限のキーだけを宣言する。
# 過剰に縛ると、正当な設定変更を誤って壊れ扱いしてしまう。
REQUIRED_KEYS = ("model", "permissions")
 
def load_and_validate(path):
    """パースと最小スキーマの照合。壊れていれば理由を返す。"""
    if not os.path.exists(path):
        return None, "not_found"
    if os.path.getsize(path) == 0:
        return None, "empty"
    try:
        with open(path, "r", encoding="utf-8") as f:
            data = json.load(f)
    except json.JSONDecodeError as e:
        return None, f"invalid_json: {e}"
    if not isinstance(data, dict):
        return None, "not_object"
    missing = [k for k in REQUIRED_KEYS if k not in data]
    if missing:
        return None, f"missing_keys: {missing}"
    return data, None

import hashlib
import shutil
import time
 
BACKUP_DIR = os.path.expanduser("~/.gemini/config/.known_good")
KEEP = 3  # 直近3世代だけ残す
 
def sha256_of(path):
    h = hashlib.sha256()
    with open(path, "rb") as f:
        for chunk in iter(lambda: f.read(8192), b""):
            h.update(chunk)
    return h.hexdigest()
 
def snapshot_good(path):
    """検証を通った設定を、内容が新しいときだけ控える。"""
    os.makedirs(BACKUP_DIR, exist_ok=True)
    digest = sha256_of(path)
    existing = sorted(os.listdir(BACKUP_DIR))
    # 直近の控えと同じ内容なら、何もしない。
    if existing and existing[-1].endswith(f"{digest[:12]}.json"):
        return
    stamp = time.strftime("%Y%m%dT%H%M%S")
    dst = os.path.join(BACKUP_DIR, f"{stamp}.{digest[:12]}.json")
    shutil.copy2(path, dst)
    # 古い世代を刈る。
    keep = sorted(os.listdir(BACKUP_DIR))[-KEEP:]
    for name in os.listdir(BACKUP_DIR):
        if name not in keep:
            os.remove(os.path.join(BACKUP_DIR, name))

def atomic_restore(path, src):
    """src の内容を、一時ファイル経由でアトミックに path へ戻す。"""
    tmp = path + ".tmp"
    shutil.copy2(src, tmp)
    # ここまでで tmp は完全な内容を持つ。最後の一手だけが本番に触れる。
    os.replace(tmp, path)  # 同一FS上ならアトミック
 
def recover(path):
    """良い状態が残っていれば新しい順に戻す。戻せたら True。"""
    if not os.path.isdir(BACKUP_DIR):
        return False
    for name in sorted(os.listdir(BACKUP_DIR), reverse=True):
        candidate = os.path.join(BACKUP_DIR, name)
        data, err = load_and_validate(candidate)
        if err is None:
            atomic_restore(path, candidate)
            return True
    return False

MINIMAL_DEFAULT = {
    "model": "gemini-3.5-flash",
    "permissions": {"mode": "ask"},  # 迷ったら安全側。自動承認しない。
}
 
def write_minimal_default(path):
    tmp = path + ".tmp"
    with open(tmp, "w", encoding="utf-8") as f:
        json.dump(MINIMAL_DEFAULT, f, ensure_ascii=False, indent=2)
    os.replace(tmp, path)
 
def guard():
    data, err = load_and_validate(CONFIG_PATH)
    if err is None:
        snapshot_good(CONFIG_PATH)
        print("config ok")
        return 0
    print(f"config broken: {err}", file=sys.stderr)
    if recover(CONFIG_PATH):
        print("restored from known-good", file=sys.stderr)
        return 0
    write_minimal_default(CONFIG_PATH)
    # 終了コード 2 は「起動は通したが、要確認」の合図として使う。
    print("NO known-good; wrote minimal default. REVIEW REQUIRED", file=sys.stderr)
    return 2
 
if __name__ == "__main__":
    sys.exit(guard())

#!/usr/bin/env bash
set -euo pipefail
 
python3 "$HOME/bin/config_guard.py"
rc=$?
 
if [ "$rc" -eq 2 ]; then
  # 起動は通せる状態にしたが、設定が既定に落ちている。人間へ一報。
  printf 'config fell back to minimal default at %s\n' "$(date)" \
    | mail -s "[antigravity] config review required" you@example.com || true
fi
 
# rc が 0 でも 2 でも起動は通す。復旧不能なら guard 内で非0（他値）を返す設計。
agy -p "run nightly job"