エージェント開発スタックの『既知の正常』を1枚のロックファイルで守る — 可動部が同時に動く時代の変更予算設計

#!/usr/bin/env python3
# preflight.py — 無人実行の直前に走らせ、変更予算の超過なら停止する
import subprocess
import sys
import yaml
 
 
def read_current_axes() -> dict:
    """現在のスタックから各軸の版を取得する。取得できない軸は 'unknown'。"""
    def sh(cmd: str) -> str:
        try:
            out = subprocess.run(
                cmd, shell=True, capture_output=True, text=True, timeout=20
            )
            return out.stdout.strip() or "unknown"
        except Exception:
            return "unknown"
 
    return {
        "antigravity_ide": sh("agy --ide-version 2>/dev/null"),
        "antigravity_cli": sh("agy --version 2>/dev/null | head -1"),
        "default_model": sh("agy config get default_model 2>/dev/null"),
        "node": sh("node --version 2>/dev/null | tr -d 'v'"),
    }
 
 
def diff_axes(known: dict, current: dict) -> list:
    """既知の正常と現在で食い違う軸名を返す。"""
    drifted = []
    for axis, good_value in known.items():
        now = current.get(axis, "unknown")
        if now != good_value:
            drifted.append((axis, good_value, now))
    return drifted
 
 
def main() -> int:
    with open("stack.known-good.yml", encoding="utf-8") as f:
        manifest = yaml.safe_load(f)
 
    budget = manifest.get("change_budget", 1)
    known = manifest["known_good"]["axes"]
    current = read_current_axes()
    drifted = diff_axes(known, current)
 
    if not drifted:
        print("preflight: 既知の正常と一致。無人実行を許可します。")
        return 0
 
    print(f"preflight: {len(drifted)} 軸が既知の正常から動いています（予算 {budget}）")
    for axis, good, now in drifted:
        print(f"  - {axis}: {good} -> {now}")
 
    if len(drifted) > budget:
        print("preflight: 変更予算を超過。無人実行を中止します。")
        print("  → 軸を1つずつ検証し、正常を確認できたら known-good を更新してください。")
        return 1
 
    print("preflight: 予算内。実行を許可しますが、この軸を今回の容疑者として記録します。")
    return 0
 
 
if __name__ == "__main__":
    sys.exit(main())

#!/usr/bin/env bash
# nightly.sh — 無人パイプラインの入口
set -euo pipefail
 
if ! python3 preflight.py; then
  echo "変更予算の超過により本日の無人実行を見送りました。" >&2
  # 失敗のみ通知（正常時は無音）
  exit 0
fi
 
# preflight を通過したときだけ本体を実行する
python3 generate_articles.py