エージェントの実効スコープを書き出しておくと、既定が変わった日に気づけます

#!/usr/bin/env python3
"""agent_scope_snapshot.py — Markdown 定義エージェントの実効スコープを書き出す。
 
  python3 agent_scope_snapshot.py --inherit-default off <config_dir> > before.json
  python3 agent_scope_snapshot.py --inherit-default on  <config_dir> > after.json
  python3 agent_scope_snapshot.py --diff before.json after.json
"""
import argparse, json, sys
from pathlib import Path
 
POOLS = ("skills", "rules", "subagents")
 
 
def read_front_matter(path):
    lines = path.read_text(encoding="utf-8").splitlines()
    if not lines or lines[0].strip() != "---":
        return {}
    fm = {}
    for line in lines[1:]:
        if line.strip() == "---":
            break
        if ":" not in line:
            continue
        key, _, raw = line.partition(":")
        val = raw.strip()
        if val.startswith("[") and val.endswith("]"):
            val = [v.strip().strip("'\"") for v in val[1:-1].split(",") if v.strip()]
        elif val.lower() in ("true", "false"):
            val = val.lower() == "true"
        else:
            val = val.strip("'\"")
        fm[key.strip()] = val
    return fm
 
 
def pool_names(root, pool):
    d = root / pool
    return sorted(p.stem for p in d.glob("*.md")) if d.is_dir() else []
 
 
def snapshot(root, inherit_default):
    root = Path(root)
    pools = {p: pool_names(root, p) for p in POOLS}
    agents = {}
    for path in sorted((root / "agents").glob("*.md")):
        fm = read_front_matter(path)
        inherit = fm.get("inheritCustomizations", inherit_default)
        entry = {"inherit": bool(inherit), "declared": "inheritCustomizations" in fm}
        for pool in POOLS:
            explicit = fm.get(pool) or []
            if isinstance(explicit, str):
                explicit = [explicit]
            entry[pool] = (sorted(set(explicit) | set(pools[pool])) if inherit
                           else sorted(set(explicit)))
        agents[fm.get("name", path.stem)] = entry
    return {"inherit_default": inherit_default, "agents": agents}
 
 
def diff(before, after):
    rows = []
    for name in sorted(set(before["agents"]) | set(after["agents"])):
        b, a = before["agents"].get(name), after["agents"].get(name)
        if b is None or a is None:
            rows.append((name, "agent", "added" if b is None else "removed", ""))
            continue
        if b["inherit"] != a["inherit"]:
            rows.append((name, "inherit", str(b["inherit"]), str(a["inherit"])))
        for pool in POOLS:
            for g in sorted(set(a[pool]) - set(b[pool])):
                rows.append((name, pool, "", "+" + g))
            for l in sorted(set(b[pool]) - set(a[pool])):
                rows.append((name, pool, "-" + l, ""))
    return rows
 
 
def main():
    ap = argparse.ArgumentParser()
    ap.add_argument("config_dir", nargs="?")
    ap.add_argument("--inherit-default", choices=["on", "off"], default="on")
    ap.add_argument("--diff", nargs=2, metavar=("BEFORE", "AFTER"))
    args = ap.parse_args()
 
    if args.diff:
        before = json.loads(Path(args.diff[0]).read_text(encoding="utf-8"))
        after = json.loads(Path(args.diff[1]).read_text(encoding="utf-8"))
        rows = diff(before, after)
        if not rows:
            print("no change")
            return 0
        for name, field, was, now in rows:
            print(f"{name}\t{field}\t{was}\t{now}")
        return 1
 
    if not args.config_dir:
        ap.error("config_dir is required")
    print(json.dumps(snapshot(args.config_dir, args.inherit_default == "on"),
                     ensure_ascii=False, indent=2, sort_keys=True))
    return 0
 
 
if __name__ == "__main__":
    sys.exit(main())