addashboard-cli 0.14.0 → 0.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "addashboard-cli",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "webgram CLI — ad-dashboard (https://macchiato.site) を Claude Code / Codex CLI から操作するための CLI",
   "bin": {
     "webgram": "./dist/index.js"

package/skills/ad-ops/SKILL.md

@@ -72,6 +72,32 @@ skills/ad-ops/scripts/adops.sh preflight yda <accountId>
 * ユーザーの依頼にアカウント名・媒体が明示されていれば、確認を省いて既定として提示してよい
 * ここで決まった `platform` / アカウント名は**以降の全分岐で使い回す。下流で再度聞かない**（旧 Step 3 の「入稿先アカウント名」はこのステップに前倒しした）
 
+#### 媒体の素材を参照表に取り込む（アカウントが決まった直後・#161）
+
+**サムネ取得より先に実行する。** 参照表を更新してから落とせば、増えた素材のサムネも同じ回で揃う。
+
+```bash
+skills/ad-ops/scripts/adops.sh assets-sync <platform> <accountId>           # 差分を見るだけ
+skills/ad-ops/scripts/adops.sh assets-sync <platform> <accountId> --write   # 参照表へ反映する
+```
+
+**参照表（`refs.media`）には「初回に作る」手順しか無く、後から増えた素材が入らない。** 媒体にはあるのにプランナーの素材一覧に出ない、という状態がこれで起きる（#325 は 1200×628 が入っていなかった例）。
+
+判断の目安:
+
+| 状況 | どうするか |
+|---|---|
+| 差分 0 件 | **何も言わずに次へ進む。** 参照表は最新 |
+| 追加がある | **件数を伝えてから `--write` する。** 既存の番号・値は変更されない |
+| 取得件数が上限（500）に達した | **書き込まない。** 全件取れていない可能性がある（ページング未対応）。その旨を伝えて先へ進む |
+| 取得に失敗した（403 等） | **書き込まない。** 既存の参照表のまま先へ進む。入稿自体は従来どおりできる |
+| 参照表がまだ無いアカウント | 先に「アカウント取込プロンプト」で作る（このコマンドは既存ファイルへの追記専用） |
+
+* **既存の番号・値は絶対に変更しない。** 画像番号は広告名（`957c-jv_Cac_148`）と `creative=` に焼き込まれており、振り直すと過去の実績と突き合わせられなくなる
+* **振り分けはファイル名ではなく実寸（`aspectRatio`）で行う。** 実測では `-1080` という名前の 96% が 600×600 で、名前は当てにならない
+* **否認済み（`PRE_DISAPPROVED` / `POST_DISAPPROVED`）は取り込まない。** 入れると「選べるのに入稿で落ちる」状態になる
+* 既存と違う mediaId が媒体にあった場合は**上書きせず報告する**。媒体側で差し替えられた可能性があるため、人が判断する
+
 #### 素材のサムネを取得する（アカウントが決まった直後・#157）
 
 **アカウントJSON にトップレベル `thumbs` が無ければ、確認せずに取得してよい。**
@@ -905,6 +931,12 @@ npx -y addashboard-cli@latest list --platform yda --resource ads \
 - モード: **新規**（12,000円/日・1CP=1AG=1広告を量産）/ **既存ASC**（5万〜10万円/日・まとめ入稿）/ 既存-広告グループ追加 / 既存-広告追加。
 - **YDA のバナー(静止画・固定サイズ)は API 入稿に対応済**（2026-08-19 本番実機で `AdGroupAdService/add` 成功）。プランナーの広告行「広告タイプ」列で **レスポンシブ / バナー** を選ぶだけで、レスポンシブと同じ入稿計画JSON → `submit-plan` に乗る（**手入稿フラグという仕組みは存在しない**。過去のドキュメント記述だけが残っていた）。
   - **画像プールは共用**: YDA のメディアはアカウントに1ライブラリだけで「バナー用/レスポンシブ用」の区分は無い。バナー行も参照表 `refs.media[画像番号].card` / `.sq` をそのまま引く（形式列 = 画像サイズ Card/SQ）。**広告タイプ（レスポンシブ/バナー）と 形式（Card/SQ）は独立した2軸**。
+  - **【重要】バナーに Card(1200×628) は使えない。使えるのは SQ だけ**（2026-10-13 確定・#161）。**Yahoo がバナー広告で 1.91:1 に対応していない**ためで、ツールの制約ではない:
+    - 公式の入稿規定でバナー(画像)の対応アスペクト比は 1:1 / 6:5 等。**1.91:1 はレスポンシブ側のサイズ**として載っている（広告事業部に確認済み）
+    - 実 API は `220115 Unexpected aspect ratio of an image.` で弾く。**dry-run は実 API を叩かないので通ってしまう**
+    - 本番実測（24アカウント・980広告）でも **BANNER_AD × 1200×628 は 0 件**。1200×628 を使う 322 件はすべて RESPONSIVE_AD で、バナーが使っているのは SQUARE_600(374件) と IAB_UAP_MEDIUM_RECTANGLE(42件) だけ
+    - **1200×628 を使いたいなら広告タイプをレスポンシブにする。** プランナーが書き出しの手前で止め（`BANNER_CARD_UNSUPPORTED`）、`adops.sh plan` の lint も ERROR で止める（二重）
+    - 2026-08-19 の実機検証で add に成功したバナーは **SQUARE_600 / 1080×1080**（コミット `f28e003`）。Card では試されていなかった
   - **命名**: バナーはタイトル/説明文が存在しないので L 区間を出さない → `{画像番号}{c|s}-{paramCode}`（例 `957c-jv_Cac_148`）。レスポンシブは従来どおり `957c-45L60-jv_Cac_148`。
   - 入稿計画JSON では `adType:"BANNER_AD"` が載り、`headlines` / `descriptions` / `principal` / `buttonText` は出さない（`adType` 省略時は `RESPONSIVE_AD` 扱い＝旧プラン後方互換）。
 - **YDA のレスポンシブ動画もプランナーから入稿できる**（2026-09-21・#324）。広告行の**形式列で「動画」**を選ぶ（広告タイプはレスポンシブのまま）。API 上は `RESPONSIVE_AD + mainMediaFormat:VIDEO`。

package/skills/ad-ops/ad-planner.html

@@ -918,7 +918,7 @@ finalUrl = baseURL + paramCode + "?ad=" + paramCode + "&creative=" + …
    （cli/test/unit/plannerVersion.test.ts が package.json との一致を検証するので、
    手で書き換えて放置するとテストが落ちる）。
    利用者が「どの版のプランナーを開いているか」を言えないと、不具合報告が噛み合わない。 */
-const APP_VERSION = '0.14.0'; /* version:sync */
+const APP_VERSION = '0.15.0'; /* version:sync */
 /* 案A: embed廃止。参照データ(refs)・初期プラン・共通設定は外部JSONから起動時に読み込む。
    同梱デフォルト: アカウント/<媒体>/index.json の先頭アカウント (refs+principal+projectName+baseArticleUrl) と サンプルプラン.json (project+campaigns)。
    固有名詞はハードコードせず、すべて外部JSON由来にする。 */
@@ -1189,6 +1189,7 @@ const EC = {
   THUMB_MISSING:'THUMB_MISSING'           /* YDA は動画からサムネを自動生成しないので必ず要る */,
   VIDEO_PATH_IGNORED:'VIDEO_PATH_IGNORED' /* 動画 mediaID が解決済みなのにローカル動画パスも入力 (warn) */,
   BANNER_VIDEO_UNSUPPORTED:'BANNER_VIDEO_UNSUPPORTED' /* 広告タイプ=バナー × 形式=動画 は未対応 */,
+  BANNER_CARD_UNSUPPORTED:'BANNER_CARD_UNSUPPORTED'   /* 広告タイプ=バナー × 形式=Card(1200x628) は Yahoo が拒否する */,
   /* ByteDance (TikTok) 固有 */
   IDENTITY_MISSING:'IDENTITY_MISSING'  /* 広告主として表示する TikTok アカウント未設定 = 広告が作れない */,
   IDENTITY_BC_MISSING:'IDENTITY_BC_MISSING' /* identityType=BC_AUTH_TT なのに BC ID が無い (実運用の identity はほぼ BC_AUTH_TT) */,
@@ -1771,6 +1772,15 @@ PLATFORMS.yda = {
        ・**サムネは必須**。YDA は動画からサムネを自動生成しないので (本番実測)、
          mediaId かローカルパスのどちらかが無いと広告作成が R0001 で落ちる
        ・バナー × 動画 は backend の zod が弾く組み合わせ。dry-run より手前で気づけるよう err にする */
+    /* バナー × Card(1200x628) は **Yahoo が受け付けない組み合わせ**。
+       公式の入稿規定でバナー(画像)の対応アスペクト比に 1.91:1 は無く (1:1 / 6:5 等のみ)、
+       1200x628 はレスポンシブのサイズとして載っている。2026-10-13 に広告事業部へ確認済み。
+       本番実測でも 24アカウント・980広告のうち BANNER_AD × 1200x628 は 0 件で、
+       1200x628 を使う 322 件はすべて RESPONSIVE_AD だった。
+       実 API は 220115 Unexpected aspect ratio で弾くが、**dry-run は実 API を叩かないので通る**。
+       バナー × 動画 と同じく、書き出しの手前で止める。 */
+    if(isBanner && !isVideo && fmt.mediaKey==='card')
+      pushErr('バナー×Card(1200)は入稿不可（レスポンシブにするか SQ を使う）', EC.BANNER_CARD_UNSUPPORTED);
     const videoPath=String(ad.videoPath||'').trim();
     const thumbnailPath=String(ad.thumbnailPath||'').trim();
     if(isVideo){

package/skills/ad-ops/scripts/adops.sh

@@ -8,6 +8,7 @@
 #                                               --wait は入稿ボタンが押されるまで待ってから処理する
 #   adops.sh open <platform> <accountId> [resource]  管理画面を開く (URLを手で組み立てない)
 #   adops.sh refs-import <platform> <accountId> [--write]  実アカウントから参照表を取り込む
+#   adops.sh assets-sync <platform> <accountId> [--write]  媒体の素材を参照表(refs.media)へ取り込む
 #   adops.sh refs-import google <accountId> --from-plan <入稿計画.json> [--write]
 #                                                        入稿で作ったロゴを取り込む（実APIを叩かない）
 #
@@ -357,6 +358,13 @@ cmd_refs_import() {
   python3 "${SKILL_DIR}/scripts/refs_import.py" "$@"
 }
 
+# 媒体に登録済みの素材を参照表（refs.media）へ取り込む。
+# refs-import は見出し/説明文/オーディエンス/配置面だけで media を扱わないため分けてある。
+# --write なしは差分表示のみ（dry-run 既定）。
+cmd_assets_sync() {
+  python3 "${SKILL_DIR}/scripts/assets_sync.py" "$@"
+}
+
 # 素材のサムネイルを落として アカウント/<媒体>/サムネ/<accountId>/ に置く。
 # プランナーの素材選択でサムネを出すために使う。保存先は .gitignore 済み。
 cmd_thumbs() {
@@ -369,6 +377,7 @@ case "${1:-}" in
   plan)        shift; cmd_plan "$@" ;;
   open)        shift; cmd_open "$@" ;;
   refs-import) shift; cmd_refs_import "$@" ;;
+  assets-sync) shift; cmd_assets_sync "$@" ;;
   thumbs)      shift; cmd_thumbs "$@" ;;
   *)
     cat >&2 <<EOF
@@ -386,6 +395,9 @@ usage:
   adops.sh refs-import <platform> <accountId> [--write] [--campaign-id <id>]
   adops.sh refs-import google <accountId> --from-plan <入稿計画.json> [--write]
                                               実アカウントから参照表を取り込む（既定 dry-run）
+  adops.sh assets-sync <platform> <accountId> [--write]
+                                              媒体の素材を参照表(refs.media)へ取り込む（既定 dry-run）
+                                              既存の番号・値は変更せず、足りない分だけ足す
   adops.sh thumbs <platform> <accountId> [--force] [--limit N]
                                               素材のサムネイルを落として素材選択で見られるようにする
                                               （保存先は アカウント/<媒体>/サムネ/。追跡・公開しない）

package/skills/ad-ops/scripts/assets_sync.py

@@ -0,0 +1,277 @@
+#!/usr/bin/env python3
+"""媒体に登録済みの素材を参照表（refs.media）へ取り込む。
+
+`adops.sh assets-sync <platform> <accountId> [--write]` から呼ばれる。単体でも動く:
+
+    python3 assets_sync.py yda <accountId> [--write]
+
+refs_import.py が見出し・説明文・オーディエンス・配置面を扱うのに対し、
+こちらは **media 専用**。両者は番号空間も取得元も違うので分けてある。
+
+━━ なぜ要るか ━━
+参照表は「初回に作る」手順（プランナーの ❓使い方 → アカウント取込プロンプト）はあるが、
+**後から追記する手段が無かった**。媒体に素材を足してもプランナーの選択肢に出ないため、
+「媒体にはあるのに入稿できない」という状態になる（#325）。
+
+━━ 振り分けはファイル名ではなく実寸で行う ━━
+mediaName の `-1080` / `-1200` は実サイズとズレている（実測: `-1080` の 96% が 600x600、
+`-1200` で 2400x1256 のものもある）。アップロード時に `元ファイル名 + contentHash` へ
+加工される経路もあるので、名前は振り分けの根拠にしない。
+
+  aspectRatio が 1.91:1 系 → card
+  aspectRatio が 1:1 系    → sq
+  それ以外                 → 取り込まない（件数だけ報告）
+
+━━ 既存は絶対に触らない ━━
+画像番号は広告名（`957c-jv_Cac_148`）と計測パラメータ（`creative=`）に焼き込まれている。
+番号がずれると過去の実績と突き合わせられなくなるので、
+
+  * 既存の番号は振り直さない
+  * 既存の値は上書きしない（違う mediaId を見つけても報告だけ）
+  * 媒体から消えたものは削除しない
+
+━━ 取りきれていないときは書かない ━━
+backend の MediaService 取得は 500 件固定でページング未対応。全件取れていない状態で
+書き込むと「媒体に無い」と誤認した欠落データを正にしてしまう。取得が怪しいときは
+書き込まずに報告して終わる（呼び出し側は既存の参照表のまま先へ進める）。
+"""
+import argparse
+import glob
+import json
+import os
+import re
+import shutil
+import subprocess
+import sys
+from datetime import datetime
+
+SKILL_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+CLI = os.environ.get("ADOPS_CLI", "npx -y addashboard-cli@latest")
+
+# backend の MediaService 取得が 1 回で返す上限。ここに達していたら全件取れていない
+# 可能性があるので書き込まない（connector 側が thumbnailFlg 等を間引くため、
+# 見える件数が上限未満でも取りこぼしはありうる。あくまで「明らかに怪しい」の検知）。
+FETCH_LIMIT = 500
+
+# 取り込んでよい審査状態。
+#   APPROVED               … 承認済み
+#   PENDING_UNSPECIFIED_AD … まだ広告に使われていないだけ。否認ではない
+# PRE_DISAPPROVED / POST_DISAPPROVED を入れると「選べるのに入稿で落ちる」状態になる。
+USABLE_APPROVAL = {"APPROVED", "PENDING_UNSPECIFIED_AD"}
+
+# aspectRatio → 参照表のスロット。媒体の表記ゆれ（AR_191_100 / AR_1200_628）を吸収する。
+SLOT_BY_ASPECT = {
+    "AR_191_100": "card",
+    "AR_1200_628": "card",
+    "AR_1_1": "sq",
+}
+
+
+def fetch_media(platform: str, account_id: str) -> list | None:
+    """登録済み素材の一覧を取る。取れなければ None（空配列と区別する）。
+
+    「取得失敗」を「素材が0件」と取り違えると、参照表を空にしかねない。
+    """
+    cmd = [*CLI.split(), "list", "--platform", platform,
+           "--resource", "media", "--account-id", account_id]
+    print("▸ 媒体の素材一覧を取得中...", file=sys.stderr)
+    try:
+        proc = subprocess.run(cmd, capture_output=True, text=True, timeout=600)
+    except Exception as e:  # noqa: BLE001
+        print(f"  ✗ 取得に失敗: {e}", file=sys.stderr)
+        return None
+    if proc.returncode != 0:
+        print(f"  ✗ 取得に失敗 (exit {proc.returncode}): {proc.stderr.strip()[:400]}",
+              file=sys.stderr)
+        return None
+    try:
+        data = json.loads(proc.stdout)
+    except Exception as e:  # noqa: BLE001
+        print(f"  ✗ 応答を解釈できません: {e}", file=sys.stderr)
+        return None
+    media = data.get("media")
+    if not isinstance(media, list):
+        print("  ✗ 応答に media がありません", file=sys.stderr)
+        return None
+    return media
+
+
+def find_account(platform: str, account_id: str) -> tuple[str | None, dict]:
+    """accountId から参照表のパスと内容を引く（sample_account は最後に回す）。"""
+    paths = [p for p in glob.glob(os.path.join(SKILL_DIR, "アカウント", platform, "*.json"))
+             if os.path.basename(p) != "index.json"]
+    paths.sort(key=lambda p: os.path.basename(p) == "sample_account.json")
+    for path in paths:
+        try:
+            data = json.load(open(path, encoding="utf-8"))
+        except Exception:  # noqa: BLE001
+            continue
+        if str(data.get("accountId", "")) == str(account_id):
+            return path, data
+    return None, {}
+
+
+def image_no(media_name: object) -> str | None:
+    """素材名の先頭の数字を画像番号として取る（`183-1200.jpg` → `183`）。
+
+    先頭が数字でないものは番号を決められないので取り込まない。推測で番号を振ると
+    既存の番号体系を壊すため、ここは厳格にする。
+    """
+    m = re.match(r"(\d+)", str(media_name or ""))
+    return m.group(1) if m else None
+
+
+def classify(media: list) -> dict:
+    """素材一覧を (番号, スロット) → mediaId の候補表に畳む。
+
+    同じ組み合わせに複数の素材が当たったら、どれを採るか機械的に決められないので
+    候補をすべて残して呼び出し側に判断させる（自動採用しない）。
+    """
+    out = {
+        "candidates": {},      # (no, slot) -> [mediaId, ...]
+        "skipped_approval": 0,  # 否認済み
+        "skipped_aspect": 0,    # card/sq に当てはまらない比率
+        "skipped_name": 0,      # 番号を取れない
+    }
+    for m in media:
+        mid = str(m.get("mediaId") or "")
+        if not mid:
+            continue
+        if (m.get("approvalStatus") or "") not in USABLE_APPROVAL:
+            out["skipped_approval"] += 1
+            continue
+        slot = SLOT_BY_ASPECT.get(m.get("aspectRatio") or "")
+        if not slot:
+            out["skipped_aspect"] += 1
+            continue
+        no = image_no(m.get("mediaName"))
+        if not no:
+            out["skipped_name"] += 1
+            continue
+        out["candidates"].setdefault((no, slot), []).append(mid)
+    return out
+
+
+def merge(refs_media: dict, classified: dict) -> tuple[dict, list[str], dict]:
+    """既存を保ったまま不足分だけ足す。
+
+    returns (merged, report, stats)
+    """
+    merged = {k: dict(v) if isinstance(v, dict) else v for k, v in (refs_media or {}).items()}
+    added, ambiguous, conflicts = [], [], []
+
+    for (no, slot), ids in sorted(classified["candidates"].items(), key=lambda x: (int(x[0][0]), x[0][1])):
+        cur = merged.get(no)
+        if cur is not None and not isinstance(cur, dict):
+            continue  # 想定外の形。触らない
+        if len(ids) > 1:
+            # どれが正か決められない。既に値があるならそのまま、無ければ空けておく
+            ambiguous.append((no, slot, ids))
+            continue
+        mid = ids[0]
+        if cur is None:
+            merged[no] = {slot: mid}
+            added.append((no, slot, mid, "新規番号"))
+        elif slot not in cur:
+            cur[slot] = mid
+            added.append((no, slot, mid, "枠を追加"))
+        elif str(cur[slot]) != mid:
+            # 既存の値は上書きしない。媒体側で差し替わっている可能性を報告だけする
+            conflicts.append((no, slot, str(cur[slot]), mid))
+
+    report = []
+    report.append(f"追加: {len(added)} 件"
+                  f"（card {sum(1 for a in added if a[1] == 'card')} / "
+                  f"sq {sum(1 for a in added if a[1] == 'sq')}）")
+    if ambiguous:
+        report.append(f"⚠ 同じ番号・同じ形式に候補が複数あるため取り込みませんでした: {len(ambiguous)} 件")
+        for no, slot, ids in ambiguous[:5]:
+            report.append(f"    番号 {no} / {slot}: {', '.join(ids)}")
+    if conflicts:
+        report.append(f"⚠ 既存と違う mediaId が媒体にあります（上書きしていません）: {len(conflicts)} 件")
+        for no, slot, old, new in conflicts[:5]:
+            report.append(f"    番号 {no} / {slot}: 参照表 {old} / 媒体 {new}")
+    for key, label in (("skipped_approval", "審査で否認された素材"),
+                       ("skipped_aspect", "card/sq に当てはまらない比率の素材"),
+                       ("skipped_name", "名前から番号を取れない素材")):
+        if classified[key]:
+            report.append(f"除外: {label} {classified[key]} 件")
+
+    stats = {"added": len(added), "ambiguous": len(ambiguous), "conflicts": len(conflicts)}
+    return merged, report, stats
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(description="媒体の素材を参照表（refs.media）へ取り込む")
+    ap.add_argument("platform", choices=["yda"],
+                    help="現在は yda のみ。媒体ごとに番号の付け方が違うため横展開はしない")
+    ap.add_argument("account_id")
+    ap.add_argument("--write", action="store_true", help="参照表へ書き込む（既定は差分表示のみ）")
+    args = ap.parse_args()
+
+    path, account = find_account(args.platform, args.account_id)
+    if not path:
+        print(f"✗ accountId {args.account_id} の参照表が見つかりません", file=sys.stderr)
+        print("  初めて使うアカウントは、先にアカウント取込プロンプトで作成してください",
+              file=sys.stderr)
+        return 1
+
+    media = fetch_media(args.platform, args.account_id)
+    if media is None:
+        print("✗ 素材一覧を取得できなかったため、参照表は変更していません")
+        return 1
+
+    print(f"  媒体の素材: {len(media)} 件")
+
+    # 取得上限に達している = 全件取れていない可能性がある。欠落したまま書くと危険なので止める。
+    truncated = len(media) >= FETCH_LIMIT
+    classified = classify(media)
+    refs = (account.get("refs") or {}).get("media") or {}
+    merged, report, stats = merge(refs, classified)
+
+    print(f"\n── {os.path.basename(path)} ──")
+    before_card = sum(1 for v in refs.values() if isinstance(v, dict) and v.get("card"))
+    before_sq = sum(1 for v in refs.values() if isinstance(v, dict) and v.get("sq"))
+    after_card = sum(1 for v in merged.values() if isinstance(v, dict) and v.get("card"))
+    after_sq = sum(1 for v in merged.values() if isinstance(v, dict) and v.get("sq"))
+    print(f"  画像番号  {len(refs)} → {len(merged)}")
+    print(f"  card      {before_card} → {after_card}")
+    print(f"  sq        {before_sq} → {after_sq}")
+    for line in report:
+        print(f"  {line}")
+
+    if truncated:
+        print(f"\n✗ 取得件数が上限（{FETCH_LIMIT}）に達しています。全件取れていない可能性が"
+              "あるため書き込みません。")
+        print("  ページング対応が入るまで、このアカウントは手動で参照表を整えてください。")
+        return 2
+
+    if stats["added"] == 0:
+        print("\n（参照表は最新です）")
+        return 0
+
+    if not args.write:
+        print("\n（dry-run: 書き込んでいません。反映するには --write を付けてください）")
+        return 0
+
+    # 書き込み前に必ず退避する。固定名だと2回目の write で最初の退避が消えるので世代を残す。
+    stamp = datetime.now().strftime("%Y%m%d-%H%M%S")
+    backup, n = f"{path}.{stamp}.bak", 1
+    while os.path.exists(backup):
+        backup, n = f"{path}.{stamp}-{n}.bak", n + 1
+    shutil.copy2(path, backup)
+
+    account.setdefault("refs", {})["media"] = merged
+    # 一時ファイルへ書いてから rename する。途中で落ちても元が壊れない
+    tmp = f"{path}.tmp"
+    with open(tmp, "w", encoding="utf-8") as f:
+        json.dump(account, f, indent=1, ensure_ascii=False)
+        f.write("\n")
+    os.replace(tmp, path)
+    print(f"\n✓ 書き込みました: {path}")
+    print(f"  退避: {os.path.basename(backup)}（元に戻すならこれを上書きコピー）")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/skills/ad-ops/scripts/plan_lint.py

@@ -467,6 +467,14 @@ def lint(plan: dict, plan_path: str = "") -> None:
     # refs の鮮度と無関係にローカルで確定する
     plan_cp_names: set[str] = set()
 
+    # YDA のバナー広告は 1200x628 (Card) を受け付けない。入稿計画JSONに画像サイズは
+    # 載らないので、参照表の card 側に登録されている mediaId を集めて逆引きする。
+    card_media_ids = {
+        str(v.get("card"))
+        for v in (account.get("refs", {}).get("media") or {}).values()
+        if isinstance(v, dict) and v.get("card")
+    }
+
     if not base:
         warn(f"アカウントJSONに baseArticleUrl がありません（{platform}/{plan.get('accountId')}）。"
              " finalUrl が相対パスになる原因になります")
@@ -579,6 +587,22 @@ def lint(plan: dict, plan_path: str = "") -> None:
                             f"        → 解決先 {resolved}（相対パスの基準は計画JSONのディレクトリ "
                             f"{base_dir}）")
 
+                # YDA のバナー広告 (BANNER_AD) に 1200x628 の画像は使えない。
+                # 公式の入稿規定でバナー(画像)の対応アスペクト比は 1:1 / 6:5 等で、
+                # 1.91:1 はレスポンシブ側のサイズ (2026-10-13 に広告事業部へ確認済み)。
+                # 実 API は 220115 Unexpected aspect ratio で弾くが dry-run は通るので、
+                # プランナーと二重に止める (プランナーを経由しない計画にも効かせる)。
+                if platform == "yda" and (a.get("adType") or "RESPONSIVE_AD") == "BANNER_AD":
+                    banner_cards = [
+                        str(m) for m in (a.get("mediaIds") or []) if str(m) in card_media_ids
+                    ]
+                    if banner_cards:
+                        err(f"CP「{name}」のバナー広告に Card(1200x628) の画像が指定されています"
+                            f"（{a.get('adName') or ''} / mediaId {', '.join(banner_cards)}）\n"
+                            f"        → Yahoo はバナー広告の 1200x628 を受け付けません"
+                            f"（220115 Unexpected aspect ratio）。"
+                            f"広告タイプをレスポンシブにするか、形式を SQ にしてください")
+
                 # Google (Demand Gen) の動画は「動画IDかローカルパスのどちらか一方」。
                 # 両方あると CLI が余計にアップロードし、使われない動画が YouTube に残る。
                 # backend も superRefine で 400 にするが、CLI はその手前でアップロードを

package/skills/ad-ops/scripts/test_assets_sync.py

@@ -0,0 +1,132 @@
+#!/usr/bin/env python3
+"""assets_sync.py の単体テスト（実 API を叩かない）。
+
+    python3 test_assets_sync.py
+
+媒体のレスポンスを固定データで与え、振り分け・除外・マージの判断を確かめる。
+参照表は「既存を絶対に壊さない」のが最重要なので、そこを厚く見る。
+"""
+import json
+import os
+import subprocess
+import sys
+import tempfile
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+import assets_sync as S  # noqa: E402
+
+ok = 0
+ng = []
+
+
+def check(name: str, cond: bool, detail: str = "") -> None:
+    global ok
+    if cond:
+        ok += 1
+        print(f"  ✓ {name}")
+    else:
+        ng.append(f"{name}{(': ' + detail) if detail else ''}")
+        print(f"  ✗ {name}{(': ' + detail) if detail else ''}")
+
+
+def media(mid, name, aspect, approval="APPROVED"):
+    return {"mediaId": mid, "mediaName": name, "aspectRatio": aspect,
+            "approvalStatus": approval}
+
+
+print("── 振り分け（実寸で判定し、名前は使わない） ──")
+c = S.classify([
+    media("1001", "10-1200.jpg", "AR_191_100"),
+    media("1002", "10-1080.jpg", "AR_1_1"),
+    media("1003", "11-1200.jpg", "AR_1200_628"),   # 表記ゆれも card に寄せる
+])
+check("1.91:1 は card", c["candidates"].get(("10", "card")) == ["1001"])
+check("1:1 は sq", c["candidates"].get(("10", "sq")) == ["1002"])
+check("AR_1200_628 も card", c["candidates"].get(("11", "card")) == ["1003"])
+
+# 名前が -1080 でも実寸が 1.91:1 なら card。実データの96%が名前とズレているため
+c = S.classify([media("2001", "20-1080.jpg", "AR_191_100")])
+check("名前が -1080 でも実寸が 1.91:1 なら card",
+      c["candidates"].get(("20", "card")) == ["2001"])
+
+print("\n── 除外 ──")
+c = S.classify([
+    media("3001", "30-1200.jpg", "AR_191_100", "PRE_DISAPPROVED"),
+    media("3002", "31-1200.jpg", "AR_191_100", "POST_DISAPPROVED"),
+    media("3003", "32-1200.jpg", "AR_191_100", "PENDING_UNSPECIFIED_AD"),
+])
+check("否認済み(PRE/POST)は取り込まない", c["skipped_approval"] == 2)
+check("審査保留(PENDING)は取り込む", ("32", "card") in c["candidates"])
+
+c = S.classify([media("4001", "40-xx.jpg", "AR_4_5")])
+check("card/sq 以外の比率は取り込まない", c["skipped_aspect"] == 1 and not c["candidates"])
+
+c = S.classify([media("5001", "banner-1200.jpg", "AR_191_100")])
+check("名前から番号を取れないものは取り込まない",
+      c["skipped_name"] == 1 and not c["candidates"])
+
+print("\n── 既存を壊さない ──")
+existing = {"10": {"card": "9999"}, "20": {"sq": "8888"}}
+c = S.classify([
+    media("1001", "10-1200.jpg", "AR_191_100"),   # 既存と違う mediaId
+    media("1002", "10-1080.jpg", "AR_1_1"),       # 空いている枠
+    media("2002", "20-1080.jpg", "AR_1_1"),       # 既存と違う mediaId
+])
+merged, report, stats = S.merge(existing, c)
+check("既存の値を上書きしない", merged["10"]["card"] == "9999",
+      f'got {merged["10"]["card"]}')
+check("空いている枠には足す", merged["10"].get("sq") == "1002")
+check("食い違いを報告する", stats["conflicts"] == 2, f'got {stats["conflicts"]}')
+check("追加件数が合う", stats["added"] == 1, f'got {stats["added"]}')
+
+print("\n── 同じ番号・同じ形式に候補が複数 ──")
+c = S.classify([
+    media("6001", "60-1200.jpg", "AR_191_100"),
+    media("6002", "60-1200_dup.jpg", "AR_191_100"),
+])
+merged, report, stats = S.merge({}, c)
+check("どれが正か決められないので取り込まない", "60" not in merged)
+check("候補が複数あることを報告する", stats["ambiguous"] == 1)
+
+print("\n── 新規番号 ──")
+c = S.classify([media("7001", "70-1200.jpg", "AR_191_100")])
+merged, report, stats = S.merge({}, c)
+check("参照表に無い番号は新規に作る", merged.get("70") == {"card": "7001"})
+
+print("\n── CLI の挙動（実 API は叩かない） ──")
+with tempfile.TemporaryDirectory() as td:
+    acc_dir = os.path.join(td, "アカウント", "yda")
+    os.makedirs(acc_dir)
+    acc_path = os.path.join(acc_dir, "テスト案件.json")
+    with open(acc_path, "w", encoding="utf-8") as f:
+        json.dump({"accountId": "999", "refs": {"media": {"1": {"sq": "111"}}}},
+                  f, ensure_ascii=False)
+    before = open(acc_path, encoding="utf-8").read()
+
+    env = {**os.environ, "ADOPS_CLI": "false"}  # 必ず失敗する CLI を使わせる
+    script = os.path.join(os.path.dirname(os.path.abspath(__file__)), "assets_sync.py")
+    # SKILL_DIR を一時ディレクトリに向けるため、スクリプトを一時側へ写して実行する
+    tmp_scripts = os.path.join(td, "scripts")
+    os.makedirs(tmp_scripts)
+    import shutil
+    shutil.copy2(script, os.path.join(tmp_scripts, "assets_sync.py"))
+    p = subprocess.run([sys.executable, os.path.join(tmp_scripts, "assets_sync.py"),
+                        "yda", "999", "--write"],
+                       capture_output=True, text=True, env=env)
+    check("取得に失敗したら書き込まない（終了コード1）", p.returncode == 1,
+          f"exit={p.returncode}")
+    check("取得に失敗しても参照表が変わらない",
+          open(acc_path, encoding="utf-8").read() == before)
+
+    p = subprocess.run([sys.executable, os.path.join(tmp_scripts, "assets_sync.py"),
+                        "yda", "不明なID"],
+                       capture_output=True, text=True, env=env)
+    check("参照表が無いアカウントはエラーで止まる", p.returncode == 1)
+
+print()
+if ng:
+    print(f"✗ {len(ng)} 件failed / {ok} 件passed")
+    for n in ng:
+        print(f"    - {n}")
+    sys.exit(1)
+print(f"✓ {ok} 件すべて passed")