壁紙アプリの夜間アセット更新を Background Agent に任せる — 時間予算・重複検出・完了ゲートまで含めた運用設計

# .antigravity/tasks/nightly-asset-update.yaml
task: nightly-asset-update
schedule: "0 22 * * *"        # JST 22:00 起動
budget:
  wall_clock: "7h"            # 翌朝 5:00 までに必ず終える
  hard_stop: "04:50"          # これを過ぎたら処理中でも中断しレポート
scope:
  source: "assets/wallpapers/incoming"
  lookback_days: 30           # 重複検出は直近30日分のみを対象に
steps:
  - validate_assets
  - resize_profiles
  - draft_metadata
  - write_report
on_uncertain: halt            # 迷ったら止める（自動ロールバックはしない）
report: "_logs/nightly/{{date}}.md"

# scripts/detect_duplicates.py
from pathlib import Path
from datetime import datetime, timedelta
from PIL import Image
import imagehash
 
LOOKBACK_DAYS = 30
THRESHOLD = 5  # ハミング距離。5以下は「ほぼ同一」とみなす
 
def recent_assets(root: Path, days: int):
    cutoff = datetime.now() - timedelta(days=days)
    for p in root.rglob("*.png"):
        if datetime.fromtimestamp(p.stat().st_mtime) >= cutoff:
            yield p
 
def scan(root: Path):
    hashes = {}
    flagged = []
    for path in recent_assets(root, LOOKBACK_DAYS):
        h = imagehash.phash(Image.open(path))
        for known_path, known_h in hashes.items():
            distance = h - known_h
            if distance <= THRESHOLD:
                flagged.append((path, known_path, distance))
        hashes[path] = h
    return flagged
 
if __name__ == "__main__":
    for dup, original, dist in scan(Path("assets/wallpapers")):
        print(f"NEAR-DUP: {dup.name} ~ {original.name} (distance={dist})")

# scripts/resize_profiles.py
from pathlib import Path
from PIL import Image, ImageCms
 
PROFILES = {
    "iphone-17-pro-max": (1320, 2868),
    "iphone-17":         (1206, 2622),
    "iphone-se":         (750, 1334),
    "ipad-pro-13":       (2064, 2752),
    "android-1080p":     (1080, 1920),
    "android-1440p":     (1440, 3120),
    # ... 全12プロファイル
}
 
def export_all(src: Path, out_root: Path):
    img = Image.open(src).convert("RGB")
    for name, (w, h) in PROFILES.items():
        resized = img.resize((w, h), Image.LANCZOS)
        out_dir = out_root / name
        out_dir.mkdir(parents=True, exist_ok=True)
        resized.save(out_dir / src.name, "PNG", optimize=True)
    return len(PROFILES)

# Nightly Report 2026-05-22
 
## Status
- Total assets processed: 18
- Resize variants generated: 216 (18 × 12 device profiles)
- Metadata drafts: 9 languages × 18 = 162 files
- Duplicates flagged: 1 (needs human review)
- Color space anomalies: 0
 
## Needs Your Review (今朝の判断が必要なもの)
1. assets/wallpapers/2026-05/aurora-014.png
   - Detected as near-duplicate of aurora-009 (perceptual hash distance: 4)
   - Action requested: Keep both? Replace? Skip?
 
## All Clear (確認不要)
- aurora-001 ... aurora-013, aurora-015 ... aurora-018: 規定通り処理完了
- Metadata drafts: 全件文体チェック通過（最終承認は人）
 
## Time
- Started: 22:03
- Completed: 04:48
- Total: 6h 45m

# 夜間だけスリープを抑止（22:00 から 8 時間）
caffeinate -i -t 28800 &

# scripts/completion_gate.py
from pathlib import Path
import sys
 
EXPECTED_PROFILES = 12
 
def verify(out_root: Path, source_count: int) -> bool:
    expected = source_count * EXPECTED_PROFILES
    actual = sum(1 for _ in out_root.rglob("*.png"))
    if actual != expected:
        print(f"GATE FAILED: expected {expected} files, found {actual}")
        return False
    print(f"GATE OK: {actual} files")
    return True
 
if __name__ == "__main__":
    ok = verify(Path("assets/output"), int(sys.argv[1]))
    sys.exit(0 if ok else 1)