siluzan-tso-cli 1.1.56-beta.3 → 1.1.56

package/dist/index.js

@@ -4049,7 +4049,7 @@ var DEFAULT_API_BASE;
 var init_defaults = __esm({
   "src/config/defaults.ts"() {
     "use strict";
-    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
   }
 });
 
@@ -113620,6 +113620,192 @@ import { readFileSync as readFileSync4 } from "fs";
 init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 init_cli_table();
+
+// src/commands/ad/write-verification.ts
+var CAMPAIGN_WRITE_SCOPE = "gateway-full-put";
+function sameWriteValue(expected, actual) {
+  if (expected === actual) return true;
+  if (typeof expected === "string" && typeof actual === "string") {
+    return expected.trim() === actual.trim();
+  }
+  if (typeof expected === "number" && typeof actual === "number") return expected === actual;
+  if (typeof expected === "boolean" && typeof actual === "boolean") return expected === actual;
+  if (Array.isArray(expected) && Array.isArray(actual)) {
+    if (expected.length !== actual.length) return false;
+    return expected.every((item, i) => sameWriteValue(item, actual[i]));
+  }
+  return false;
+}
+function fieldCheck(field, expected, actual, present) {
+  if (!present) return { field, expected, actual: void 0, state: "unread" };
+  return {
+    field,
+    expected,
+    actual,
+    state: sameWriteValue(expected, actual) ? "match" : "mismatch"
+  };
+}
+function classifyFieldChecks(checks, readFailed) {
+  if (readFailed) return "unknown";
+  if (checks.length === 0) return "submitted";
+  if (checks.some((c) => c.state === "unread")) return "unknown";
+  if (checks.every((c) => c.state === "match")) return "verified";
+  return "partial";
+}
+function describeUnmatchedChecks(checks) {
+  return checks.filter((c) => c.state !== "match").map((c) => {
+    const actual = c.state === "unread" ? "\uFF08\u672A\u8BFB\u5230\uFF09" : JSON.stringify(c.actual);
+    return `${c.field}\uFF1A\u671F\u671B ${JSON.stringify(c.expected)}\uFF0C\u8BFB\u5230 ${actual}`;
+  }).join("\uFF1B");
+}
+function writeVerificationHeadline(verification, detail) {
+  if (verification === "verified") return `\u2705 ${detail}`;
+  if (verification === "partial") return `\u26A0\uFE0F  \u90E8\u5206\u751F\u6548\uFF1A${detail}`;
+  return `\u26A0\uFE0F  \u5DF2\u63D0\u4EA4\uFF0C\u5C1A\u672A\u6838\u9A8C\uFF1A${detail}`;
+}
+function readBudgetSharedFlag(campaign) {
+  const raw = campaign["budgetShared"] ?? campaign["BudgetShared"];
+  if (typeof raw === "boolean") return raw;
+  return void 0;
+}
+function readCampaignBudgetCents(campaign) {
+  const raw = campaign["budget"] ?? campaign["Budget"];
+  if (typeof raw === "number" && Number.isFinite(raw)) return raw;
+  return void 0;
+}
+function readKey(obj, keys) {
+  for (const key of keys) {
+    if (Object.prototype.hasOwnProperty.call(obj, key)) return { present: true, value: obj[key] };
+  }
+  return { present: false, value: void 0 };
+}
+function evaluateCampaignReadback(after, expected, readFailed) {
+  if (readFailed || !after) return { verification: "unknown", checks: [] };
+  const checks = [];
+  const push = (field, expectedValue, keys) => {
+    if (expectedValue === void 0) return;
+    const found = readKey(after, keys);
+    checks.push(fieldCheck(field, expectedValue, found.value, found.present));
+  };
+  push("name", expected.name, ["name", "Name"]);
+  push("statusV2", expected.statusV2, ["statusV2", "StatusV2"]);
+  push("biddingStrategyTypeV2", expected.biddingStrategyTypeV2, [
+    "biddingStrategyTypeV2",
+    "BiddingStrategyTypeV2"
+  ]);
+  push("targetSpend_BidCeilingAmount", expected.targetSpendBidCeilingCents, [
+    "targetSpend_BidCeilingAmount",
+    "TargetSpend_BidCeilingAmount"
+  ]);
+  push("targetCpa_BidingAmount", expected.targetCpaCents, [
+    "targetCpa_BidingAmount",
+    "TargetCpa_BidingAmount"
+  ]);
+  push("targetRoas", expected.targetRoas, ["targetRoas", "TargetRoas"]);
+  push("manualCpc_EnhancedCpcEnabled", expected.manualCpcEnhanced, [
+    "manualCpc_EnhancedCpcEnabled",
+    "ManualCpc_EnhancedCpcEnabled"
+  ]);
+  push("targetSearchNetwork", expected.targetSearchNetwork, [
+    "targetSearchNetwork",
+    "TargetSearchNetwork"
+  ]);
+  push("targetContentNetwork", expected.targetContentNetwork, [
+    "targetContentNetwork",
+    "TargetContentNetwork"
+  ]);
+  if (expected.budgetWasRequested) {
+    push("budget", expected.budgetCents, ["budget", "Budget"]);
+  } else if (expected.budgetCentsBefore !== void 0) {
+    const found = readKey(after, ["budget", "Budget"]);
+    checks.push(fieldCheck("budget", expected.budgetCentsBefore, found.value, found.present));
+  }
+  return { verification: classifyFieldChecks(checks, false), checks };
+}
+function judgeBudgetAfterFailedPut(input) {
+  if (input.readFailed || input.budgetCentsBefore === void 0 || input.budgetCentsAfter === void 0) {
+    const present = !input.readFailed && input.budgetCentsAfter !== void 0;
+    const checks = input.budgetCentsBefore === void 0 ? [] : [fieldCheck("budget", input.budgetCentsBefore, input.budgetCentsAfter, present)];
+    return { kind: "unknown", verification: "unknown", checks };
+  }
+  if (input.budgetCentsBefore !== input.budgetCentsAfter) {
+    return {
+      kind: "partial",
+      verification: "partial",
+      checks: [fieldCheck("budget", input.budgetCentsBefore, input.budgetCentsAfter, true)]
+    };
+  }
+  return { kind: "unchanged" };
+}
+function coreKeyword(text2) {
+  const t = text2.trim();
+  if (t.length >= 2 && (t.startsWith('"') && t.endsWith('"') || t.startsWith("[") && t.endsWith("]"))) {
+    return t.slice(1, -1).trim();
+  }
+  return t;
+}
+function collectKeywordCores(value) {
+  if (typeof value === "string") {
+    const core = coreKeyword(value);
+    return core ? [core] : [];
+  }
+  if (!Array.isArray(value)) return [];
+  const cores = [];
+  for (const item of value) {
+    if (typeof item !== "string") continue;
+    const core = coreKeyword(item);
+    if (core) cores.push(core);
+  }
+  return cores;
+}
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function recordsFromResponse(response) {
+  if (Array.isArray(response)) return response.filter(isRecord);
+  if (!isRecord(response)) return [];
+  for (const key of ["data", "items", "keywords"]) {
+    const nested = response[key];
+    if (Array.isArray(nested)) return nested.filter(isRecord);
+  }
+  const cores = [
+    ...collectKeywordCores(response["keywordText"]),
+    ...collectKeywordCores(response["KeywordText"]),
+    ...collectKeywordCores(response["text"])
+  ];
+  if (cores.length > 0 || typeof response["id"] === "string") return [response];
+  return [];
+}
+function summarizeNegativeKeywordCreate(requested, response, listItems) {
+  const responseRecords = recordsFromResponse(response);
+  const pools = listItems == null ? responseRecords : [...responseRecords, ...listItems];
+  const matched = [];
+  const pending = [];
+  for (const text2 of requested) {
+    const core = coreKeyword(text2);
+    const hit = pools.find((item) => {
+      const cores = [
+        ...collectKeywordCores(item["keywordText"]),
+        ...collectKeywordCores(item["KeywordText"]),
+        ...collectKeywordCores(item["text"])
+      ];
+      return cores.includes(core);
+    });
+    if (!hit) {
+      pending.push(text2);
+      continue;
+    }
+    const idRaw = hit["id"] ?? hit["Id"];
+    matched.push({ text: text2, id: typeof idRaw === "string" ? idRaw : void 0 });
+  }
+  let verification;
+  if (requested.length > 0 && matched.length === requested.length) verification = "verified";
+  else if (matched.length > 0) verification = "partial";
+  else verification = "unknown";
+  return { verification, matchedCount: matched.length, matched, pending };
+}
+
+// src/commands/ad/keyword.ts
 function unwrapKeywordDisplayTextForEdit(raw) {
   const t = raw.trim();
   if (t.length >= 2 && t.startsWith('"') && t.endsWith('"')) {
@@ -113952,17 +114138,77 @@ async function runAdNegativeKeywordCreate(opts) {
   }
   const body = buildNegativeKeywordCreateBody(level, keywords, opts);
   const url = `${googleApiUrl}/negativekeywordmanagement/negativekeyword/${opts.account}`;
+  let response;
   try {
-    await apiFetch2(url, config, { method: "POST", body: JSON.stringify(body) }, opts.verbose);
+    response = await apiFetch2(
+      url,
+      config,
+      { method: "POST", body: JSON.stringify(body) },
+      opts.verbose
+    );
   } catch (err) {
     console.error(`
 \u274C \u6DFB\u52A0\u5426\u5B9A\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
 `);
     process.exit(1);
   }
+  const dateParams = new URLSearchParams();
+  dateParams.set("startDate", toGoogleDate(void 0, -30));
+  dateParams.set("endDate", toGoogleDate(void 0, 0));
+  const listUrl = `${googleApiUrl}/negativekeywordmanagement/v2/list/${opts.account}?${dateParams}`;
+  const readList = async () => {
+    try {
+      const listed = await apiFetch2(
+        listUrl,
+        config,
+        {},
+        opts.verbose
+      );
+      return listed.data ?? [];
+    } catch {
+      return null;
+    }
+  };
+  let listItems = await readList();
+  let summary = summarizeNegativeKeywordCreate(keywords, response, listItems);
+  if (summary.verification !== "verified") {
+    await new Promise((resolve25) => setTimeout(resolve25, 1e3));
+    listItems = await readList();
+    summary = summarizeNegativeKeywordCreate(keywords, response, listItems);
+  }
+  const nextQuery = `siluzan-tso ad keywords -a ${opts.account} --negative --json-out ./snap`;
+  const detail = summary.verification === "verified" ? `\u5DF2\u6838\u9A8C\u6DFB\u52A0 ${summary.matchedCount} \u4E2A\u5426\u5B9A\u5173\u952E\u8BCD\uFF08${negativeKeywordLevelLabel[level]}\uFF09` : `\u8BF7\u6C42 ${keywords.length} \u4E2A\uFF0C\u5BF9\u4E0A ${summary.matchedCount} \u4E2A${summary.pending.length ? `\uFF0C\u5C1A\u672A\u6838\u9A8C\uFF1A${summary.pending.join("\u3001")}` : ""}`;
+  const headline = writeVerificationHeadline(summary.verification, detail);
+  if (summary.verification !== "verified") {
+    console.error(`
+${headline}
+   \u8BF7\u518D\u67E5\uFF1A${nextQuery}
+`);
+  }
+  const payload = {
+    verification: summary.verification,
+    requestedCount: keywords.length,
+    matchedCount: summary.matchedCount,
+    matched: summary.matched,
+    pending: summary.pending,
+    nextQuery,
+    level,
+    response
+  };
+  if (await emitCliJsonOrSnapshot(opts, {
+    section: `ad-keyword-negative-create-${opts.account}`,
+    commandLabel: "ad keyword-negative-create",
+    commandHint: opts.account,
+    payload,
+    idSuffix: opts.account,
+    summaryExtras: { verification: summary.verification, matchedCount: summary.matchedCount }
+  })) {
+    return;
+  }
   console.log(
     `
-\u2705 \u5DF2\u5728${negativeKeywordLevelLabel[level]}\u5C42\u7EA7\u6DFB\u52A0 ${keywords.length} \u4E2A\u5426\u5B9A\u5173\u952E\u8BCD
+${headline}${summary.verification === "verified" ? "" : `
+   \u8BF7\u518D\u67E5\uFF1A${nextQuery}`}
 `
   );
 }
@@ -114058,7 +114304,7 @@ async function runAdKeywordEdit(opts) {
       currentId = returnedId;
       console.log(
         `
-\u2139\uFE0F \u7F51\u5173\u8FD4\u56DE\u7684\u5173\u952E\u8BCD id \u5DF2\u53D8\u66F4\u4E3A ${returnedId}\uFF08\u8BF7\u6C42\u65F6 id \u4E3A ${opts.id}\uFF09\uFF0C\u540E\u7EED\u67E5\u8BE2\u8BF7\u4F7F\u7528\u65B0 id\u3002
+\u2139\uFE0F \u7F51\u5173\u8FD4\u56DE\u7684\u5173\u952E\u8BCD id \u5DF2\u53D8\u66F4\u4E3A ${returnedId}\uFF08\u8BF7\u6C42\u65F6 id \u4E3A ${opts.id}\uFF0CchangeKind=replace\uFF09\uFF0C\u540E\u7EED\u67E5\u8BE2\u8BF7\u4F7F\u7528\u65B0 id\u3002
 `
       );
     }
@@ -114107,9 +114353,28 @@ ${mismatches.map((m) => `   - ${m}`).join("\n")}
       process.exit(1);
     }
   }
-  console.log(`
-\u2705 \u5173\u952E\u8BCD\u5DF2\u66F4\u65B0
+  const verifiedFields = [];
+  if (opts.finalUrl !== void 0) verifiedFields.push("finalURL");
+  if (opts.maxCpc !== void 0) verifiedFields.push("maxCPC");
+  if (opts.status !== void 0) verifiedFields.push("userStatusV2");
+  const changeKind = currentId !== opts.id ? "replace" : "update";
+  if (verifiedFields.length > 0) {
+    console.log(
+      `
+\u2705 \u5173\u952E\u8BCD\u5DF2\u6838\u9A8C\uFF08${verifiedFields.join("\u3001")}\uFF1BchangeKind=${changeKind}${changeKind === "replace" ? `\uFF0C\u65B0 id ${currentId}` : ""}\uFF09
+`
+    );
+  } else if (changeKind === "replace") {
+    console.log(
+      `
+\u2705 \u5173\u952E\u8BCD\u5DF2\u63D0\u4EA4\uFF08changeKind=replace\uFF0C\u65B0 id ${currentId}\uFF09\u3002\u8BCD\u9762\u6216\u5339\u914D\u7C7B\u578B\u4F1A\u65B0\u5EFA\u5E76\u79FB\u9664\u65E7\u8BCD\uFF0C\u8BF7\u7528 ad keywords \u6838\u5BF9\u65B0 id\u3002
+`
+    );
+  } else {
+    console.log(`
+\u2705 \u5173\u952E\u8BCD\u5DF2\u63D0\u4EA4\uFF08changeKind=update\uFF09\u3002\u8BF7\u7528 ad keywords \u6838\u5BF9\u8BCD\u9762\u3002
 `);
+  }
 }
 async function runAdKeywordStatus(opts) {
   opts = withResolvedAdAccount(opts);
@@ -115626,6 +115891,7 @@ async function resolveCampaignCustomerName(cfg, config, verbose) {
 }
 
 // src/commands/ad/campaign.ts
+var CAMPAIGN_READBACK_WAIT_MS = 1e3;
 function formatGoogleCampaignListStatus(row) {
   const raw = row.statusV2;
   if (raw == null || String(raw).trim() === "") return "-";
@@ -115735,6 +116001,108 @@ async function runAdCampaigns(opts) {
   printCliTable(rows, cols);
   console.log();
 }
+function unwrapCampaign(res) {
+  if (res && typeof res === "object" && "data" in res && res.data && typeof res.data === "object") {
+    return res.data;
+  }
+  return res;
+}
+async function fetchCampaignRecord(detailUrl, config, verbose) {
+  const res = await apiFetch2(
+    detailUrl,
+    config,
+    {},
+    verbose
+  );
+  return unwrapCampaign(res);
+}
+async function verifyCampaignAfterPut(detailUrl, config, expected, verbose) {
+  const readOnce = async () => {
+    try {
+      const after = await fetchCampaignRecord(detailUrl, config, verbose);
+      return evaluateCampaignReadback(after, expected, false);
+    } catch {
+      return evaluateCampaignReadback(void 0, expected, true);
+    }
+  };
+  let result = await readOnce();
+  if (result.verification !== "verified") {
+    await new Promise((resolve25) => setTimeout(resolve25, CAMPAIGN_READBACK_WAIT_MS));
+    result = await readOnce();
+  }
+  return result;
+}
+async function reportFailedCampaignPut(opts) {
+  const message = opts.err instanceof Error ? opts.err.message : String(opts.err);
+  let budgetCentsAfter;
+  let readFailed = false;
+  try {
+    const after = await fetchCampaignRecord(opts.detailUrl, opts.config, opts.verbose);
+    budgetCentsAfter = readCampaignBudgetCents(after);
+  } catch {
+    readFailed = true;
+  }
+  const judged = judgeBudgetAfterFailedPut({
+    readFailed,
+    budgetCentsBefore: opts.budgetCentsBefore,
+    budgetCentsAfter
+  });
+  if (judged.kind === "unchanged") {
+    console.error(`
+\u274C ${opts.failureLabel}\uFF1A${message}
+`);
+    process.exit(1);
+  }
+  const hint = judged.kind === "partial" ? "\u56DE\u8BFB\u9884\u7B97\u5DF2\u76F8\u5BF9\u63D0\u4EA4\u524D\u53D8\u5316\u3002\u9884\u7B97\u53EF\u80FD\u5DF2\u5199\u5165\uFF0C\u7CFB\u5217\u5176\u4F59\u66F4\u65B0\u672A\u5B8C\u6210\u3002\u4E0D\u8981\u6574\u5305\u91CD\u63D0\u3002" : "\u56DE\u8BFB\u5931\u8D25\u6216\u65E0\u6CD5\u5BF9\u6BD4\u9884\u7B97\uFF0C\u5199\u5165\u7ED3\u679C\u672A\u77E5\u3002\u4E0D\u8981\u6574\u5305\u91CD\u63D0\u3002";
+  await reportCampaignWrite({
+    jsonOut: opts.jsonOut,
+    account: opts.account,
+    id: opts.id,
+    section: opts.section,
+    commandLabel: opts.commandLabel,
+    verification: judged.verification,
+    checks: judged.checks,
+    detail: `${opts.failureLabel}\uFF1A${message}\u3002${hint}`
+  });
+}
+async function reportCampaignWrite(opts) {
+  const nextQuery = `siluzan-tso ad campaigns -a ${opts.account} --json-out ./snap`;
+  const unmatched = describeUnmatchedChecks(opts.checks);
+  const text2 = opts.verification === "verified" ? opts.detail : unmatched || opts.detail;
+  const headline = writeVerificationHeadline(opts.verification, text2);
+  if (opts.verification !== "verified") {
+    console.error(`
+${headline}
+   \u8BF7\u518D\u67E5\uFF1A${nextQuery}
+`);
+  }
+  const payload = {
+    id: opts.id,
+    writeScope: CAMPAIGN_WRITE_SCOPE,
+    verification: opts.verification,
+    nextQuery,
+    checks: opts.checks
+  };
+  if (await emitCliJsonOrSnapshot(
+    { jsonOut: opts.jsonOut },
+    {
+      section: opts.section,
+      commandLabel: opts.commandLabel,
+      commandHint: opts.account,
+      payload,
+      idSuffix: `${opts.account}-${opts.id}`,
+      summaryExtras: { verification: opts.verification, writeScope: CAMPAIGN_WRITE_SCOPE }
+    }
+  )) {
+    return;
+  }
+  console.log(
+    `
+${headline}${opts.verification === "verified" ? "" : `
+   \u8BF7\u518D\u67E5\uFF1A${nextQuery}`}
+`
+  );
+}
 async function runAdCampaignStatus(opts) {
   opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
@@ -115761,14 +116129,41 @@ async function runAdCampaignStatus(opts) {
   try {
     await apiFetch2(detailUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
   } catch (err) {
-    console.error(`
-\u274C \u72B6\u6001\u66F4\u65B0\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
+    await reportFailedCampaignPut({
+      err,
+      detailUrl,
+      config,
+      verbose: opts.verbose,
+      budgetCentsBefore: readCampaignBudgetCents(campaign),
+      jsonOut: opts.jsonOut,
+      account: opts.account,
+      id: opts.id,
+      section: "ad-campaign-status",
+      commandLabel: "ad campaign-status",
+      failureLabel: "\u72B6\u6001\u66F4\u65B0\u5931\u8D25"
+    });
+    return;
   }
-  console.log(`
-\u2705 \u5E7F\u544A\u7CFB\u5217 ${opts.id} \u5DF2\u8BBE\u7F6E\u4E3A ${opts.status}
-`);
+  const judged = await verifyCampaignAfterPut(
+    detailUrl,
+    config,
+    {
+      statusV2: opts.status,
+      budgetCentsBefore: readCampaignBudgetCents(campaign),
+      budgetWasRequested: false
+    },
+    opts.verbose
+  );
+  await reportCampaignWrite({
+    jsonOut: opts.jsonOut,
+    account: opts.account,
+    id: opts.id,
+    section: "ad-campaign-status",
+    commandLabel: "ad campaign-status",
+    verification: judged.verification,
+    checks: judged.checks,
+    detail: `\u5E7F\u544A\u7CFB\u5217 ${opts.id} \u72B6\u6001\u5DF2\u6838\u9A8C\u4E3A ${opts.status}`
+  });
 }
 async function runAdCampaignDelete(opts) {
   opts = withResolvedAdAccount(opts);
@@ -116069,13 +116464,29 @@ async function runAdCampaignEdit(opts) {
     console.error("\n\u274C \u8BF7\u81F3\u5C11\u6307\u5B9A\u4E00\u4E2A\u4FEE\u6539\u9879\uFF08--name / --budget / --bidding / \u2026\uFF09\n");
     process.exit(1);
   }
+  if (opts.budget !== void 0 && readBudgetSharedFlag(campaign) === true) {
+    console.error(
+      "\n\u274C \u8BE5\u7CFB\u5217\u6807\u8BB0\u4E3A\u5171\u4EAB\u9884\u7B97\uFF08budgetShared=true\uFF09\u3002campaign-edit \u4E0D\u4F1A\u53EA\u6539\u672C\u7CFB\u5217\u7684\u5171\u4EAB\u9884\u7B97\u91D1\u989D\uFF0C\u672C\u6B21\u672A\u63D0\u4EA4\u3002\n"
+    );
+    process.exit(1);
+  }
   try {
     await apiFetch2(detailUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
   } catch (err) {
-    console.error(`
-\u274C \u7F16\u8F91\u5E7F\u544A\u7CFB\u5217\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
+    await reportFailedCampaignPut({
+      err,
+      detailUrl,
+      config,
+      verbose: opts.verbose,
+      budgetCentsBefore: readCampaignBudgetCents(campaign),
+      jsonOut: opts.jsonOut,
+      account: opts.account,
+      id: opts.id,
+      section: "ad-campaign-edit",
+      commandLabel: "ad campaign-edit",
+      failureLabel: "\u7F16\u8F91\u5E7F\u544A\u7CFB\u5217\u5931\u8D25"
+    });
+    return;
   }
   const parts = [];
   if (opts.name !== void 0) parts.push(`\u540D\u79F0\u2192${opts.name}`);
@@ -116085,9 +116496,34 @@ async function runAdCampaignEdit(opts) {
   if (opts.targetSpendBidCeiling !== void 0) parts.push(`CPC\u4E0A\u9650\u2192${opts.targetSpendBidCeiling}`);
   if (opts.targetCpa !== void 0) parts.push(`\u76EE\u6807CPA\u2192${opts.targetCpa}`);
   if (opts.targetRoas !== void 0) parts.push(`\u76EE\u6807ROAS\u2192${opts.targetRoas}`);
-  console.log(`
-\u2705 \u5E7F\u544A\u7CFB\u5217 ${opts.id} \u5DF2\u66F4\u65B0${parts.length ? `\uFF08${parts.join("\uFF0C")}\uFF09` : ""}
-`);
+  const judged = await verifyCampaignAfterPut(
+    detailUrl,
+    config,
+    {
+      name: opts.name,
+      budgetCents: opts.budget !== void 0 ? toCentAmount(opts.budget) : void 0,
+      budgetWasRequested: opts.budget !== void 0,
+      budgetCentsBefore: readCampaignBudgetCents(campaign),
+      biddingStrategyTypeV2: opts.biddingStrategy?.toUpperCase(),
+      targetSpendBidCeilingCents: opts.targetSpendBidCeiling !== void 0 ? toCentAmount(opts.targetSpendBidCeiling) : void 0,
+      targetCpaCents: opts.targetCpa !== void 0 ? toCentAmount(opts.targetCpa) : void 0,
+      targetRoas: opts.targetRoas,
+      manualCpcEnhanced: opts.manualCpcEnhanced,
+      targetSearchNetwork: opts.targetSearchNetwork,
+      targetContentNetwork: opts.targetContentNetwork
+    },
+    opts.verbose
+  );
+  await reportCampaignWrite({
+    jsonOut: opts.jsonOut,
+    account: opts.account,
+    id: opts.id,
+    section: "ad-campaign-edit",
+    commandLabel: "ad campaign-edit",
+    verification: judged.verification,
+    checks: judged.checks,
+    detail: `\u5E7F\u544A\u7CFB\u5217 ${opts.id} \u5DF2\u6838\u9A8C${parts.length ? `\uFF08${parts.join("\uFF0C")}\uFF09` : ""}`
+  });
 }
 
 // src/commands/ad/adgroup.ts
@@ -123928,7 +124364,7 @@ function register21(program2) {
       });
     }
   );
-  adCmd.command("campaign-status").description("\u5207\u6362\u5E7F\u544A\u7CFB\u5217\u72B6\u6001\uFF08Enabled / Paused\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <campaignId>", "\u5E7F\u544A\u7CFB\u5217 ID").requiredOption("--status <status>", "\u76EE\u6807\u72B6\u6001\uFF1AEnabled | Paused").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  adCmd.command("campaign-status").description("\u5207\u6362\u5E7F\u544A\u7CFB\u5217\u72B6\u6001\uFF08Enabled / Paused\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <campaignId>", "\u5E7F\u544A\u7CFB\u5217 ID").requiredOption("--status <status>", "\u76EE\u6807\u72B6\u6001\uFF1AEnabled | Paused").option("--json-out <path>", "\u843D\u76D8\u6838\u9A8C\u7ED3\u679C\uFF08writeScope=gateway-full-put\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       if (opts.status !== "Enabled" && opts.status !== "Paused") {
         console.error("\n\u274C --status \u53EA\u63A5\u53D7 Enabled \u6216 Paused\n");
@@ -123939,6 +124375,7 @@ function register21(program2) {
         account: opts.account,
         id: opts.id,
         status: opts.status,
+        jsonOut: opts.jsonOut,
         verbose: opts.verbose
       });
     }
@@ -124124,7 +124561,7 @@ function register21(program2) {
   ).option(
     "--adgroup-id <id>",
     "\u5E7F\u544A\u7EC4 ID\uFF08level=AdGroup \u5FC5\u4F20\uFF1B\u672A\u4F20 --level \u65F6\u6307\u5B9A\u5373\u89C6\u4E3A AdGroup \u5C42\u7EA7\uFF09"
-  ).option("--adgroup-name <name>", "\u5E7F\u544A\u7EC4\u540D\u79F0").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  ).option("--adgroup-name <name>", "\u5E7F\u544A\u7EC4\u540D\u79F0").option("--json-out <path>", "\u843D\u76D8\u6838\u9A8C\u7ED3\u679C\uFF08\u6210\u529F\u6761\u6570\u6765\u81EA\u56DE\u8BFB\uFF0C\u4E0D\u662F\u8BF7\u6C42\u6761\u6570\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       if (opts.level && !["Account", "Campaign", "AdGroup"].includes(opts.level)) {
         console.error("\n\u274C --level \u53EA\u63A5\u53D7 Account | Campaign | AdGroup\n");
@@ -124141,6 +124578,7 @@ function register21(program2) {
         keywords: opts.keywords,
         keywordsFile: opts.keywordsFile,
         matchType: parseOptionalMatchType(opts.matchType),
+        jsonOut: opts.jsonOut,
         verbose: opts.verbose
       });
     }
@@ -124455,7 +124893,7 @@ function register21(program2) {
     "--search-network <bool>",
     "\u6295\u653E\u5230 Google \u641C\u7D22\uFF1Atrue | false",
     (v) => v === "true"
-  ).option("--content-network <bool>", "\u6295\u653E\u5230\u5C55\u793A\u7F51\u7EDC\uFF1Atrue | false", (v) => v === "true").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  ).option("--content-network <bool>", "\u6295\u653E\u5230\u5C55\u793A\u7F51\u7EDC\uFF1Atrue | false", (v) => v === "true").option("--json-out <path>", "\u843D\u76D8\u6838\u9A8C\u7ED3\u679C\uFF08writeScope=gateway-full-put\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       await runAdCampaignEdit({
         token: opts.token,
@@ -124470,6 +124908,7 @@ function register21(program2) {
         manualCpcEnhanced: opts.manualEcpc,
         targetSearchNetwork: opts.searchNetwork,
         targetContentNetwork: opts.contentNetwork,
+        jsonOut: opts.jsonOut,
         verbose: opts.verbose
       });
     }
@@ -125193,13 +125632,14 @@ function failMetaAd(action, err) {
 `);
   process.exit(1);
 }
-async function emitMetaJson(opts, section, commandLabel, payload, idSuffix) {
+async function emitMetaJson(opts, section, commandLabel, payload, idSuffix, summaryExtras) {
   return emitCliJsonOrSnapshot(opts, {
     section,
     commandLabel,
     commandHint: idSuffix,
     payload,
-    idSuffix
+    idSuffix,
+    summaryExtras
   });
 }
 function isHttpUrl(value) {
@@ -125480,6 +125920,10 @@ function buildUpdateAdSetBody(opts) {
   if (opts.startTime != null) body.start_time = opts.startTime;
   if (opts.endTime != null) body.end_time = opts.endTime;
   if (opts.status != null) body.status = opts.status;
+  if (opts.targeting && Object.keys(opts.targeting).length > 0) {
+    body.targeting = opts.targeting;
+    return body;
+  }
   const hasTargeting = opts.countries != null || opts.ageMin != null || opts.ageMax != null || opts.genders != null || opts.flexibleSpec != null || opts.advantageAudience != null;
   if (hasTargeting) {
     const targeting = {};
@@ -125490,17 +125934,221 @@ function buildUpdateAdSetBody(opts) {
     if (opts.ageMax != null) targeting.age_max = opts.ageMax;
     if (opts.genders) targeting.genders = opts.genders;
     if (opts.flexibleSpec != null) targeting.flexible_spec = opts.flexibleSpec;
-    applyLeadAdTargetingAutomation(
-      targeting,
-      resolveAdvantageAudience({
-        advantageAudience: opts.advantageAudience,
-        flexibleSpec: opts.flexibleSpec
-      })
-    );
+    if (opts.advantageAudience === 0 || opts.advantageAudience === 1) {
+      applyLeadAdTargetingAutomation(targeting, opts.advantageAudience);
+    }
     body.targeting = targeting;
   }
   return body;
 }
+var ADSET_TARGETING_TOP_KEYS = /* @__PURE__ */ new Set([
+  "geo_locations",
+  "age_min",
+  "age_max",
+  "genders",
+  "flexible_spec",
+  "targeting_automation"
+]);
+function isPlainObject(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function readFiniteNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string" && value.trim() !== "") {
+    const n = Number(value);
+    if (Number.isFinite(n)) return n;
+  }
+  return void 0;
+}
+function upperUnique(list) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of list) {
+    const code = raw.trim().toUpperCase();
+    if (!code || seen.has(code)) continue;
+    seen.add(code);
+    out.push(code);
+  }
+  return out;
+}
+function readCountries(targeting) {
+  const geo = targeting?.["geo_locations"];
+  if (!isPlainObject(geo) || !Array.isArray(geo["countries"])) return void 0;
+  const countries = upperUnique(geo["countries"].map((c) => String(c)));
+  return countries.length > 0 ? countries : void 0;
+}
+function readAdvantage(targeting) {
+  const auto = targeting?.["targeting_automation"];
+  if (!isPlainObject(auto)) return void 0;
+  const value = readFiniteNumber(auto["advantage_audience"]);
+  if (value === 0 || value === 1) return value;
+  return void 0;
+}
+function unsupportedTargetingKeys(current) {
+  if (!current) return [];
+  const keys = [];
+  for (const key of Object.keys(current)) {
+    if (!ADSET_TARGETING_TOP_KEYS.has(key)) keys.push(key);
+  }
+  const geo = current["geo_locations"];
+  if (isPlainObject(geo)) {
+    for (const key of Object.keys(geo)) {
+      if (key !== "countries") keys.push(`geo_locations.${key}`);
+    }
+  }
+  const auto = current["targeting_automation"];
+  if (isPlainObject(auto)) {
+    for (const key of Object.keys(auto)) {
+      if (key !== "advantage_audience") keys.push(`targeting_automation.${key}`);
+    }
+  }
+  return keys;
+}
+function snapshotSupported(targeting) {
+  const snap = {};
+  if (!targeting) return snap;
+  const countries = readCountries(targeting);
+  if (countries) snap.countries = countries;
+  const ageMin = readFiniteNumber(targeting["age_min"]);
+  const ageMax = readFiniteNumber(targeting["age_max"]);
+  if (ageMin !== void 0) snap.age_min = ageMin;
+  if (ageMax !== void 0) snap.age_max = ageMax;
+  if (Array.isArray(targeting["genders"])) snap.genders = targeting["genders"];
+  if (targeting["flexible_spec"] !== void 0) snap.flexible_spec = targeting["flexible_spec"];
+  const advantage = readAdvantage(targeting);
+  if (advantage !== void 0) snap.advantage_audience = advantage;
+  return snap;
+}
+function diffSnapshots(before, after) {
+  const fields = /* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(after)]);
+  const changes = [];
+  for (const field of fields) {
+    const from = before[field];
+    const to = after[field];
+    const changed = JSON.stringify(from) !== JSON.stringify(to);
+    changes.push({ field, from: from ?? null, to: to ?? null, changed });
+  }
+  return changes;
+}
+function mergeAdSetTargeting(current, patch, opts) {
+  const source = current ?? void 0;
+  const unsupported = unsupportedTargetingKeys(source);
+  if (unsupported.length > 0 && !opts?.allowDropUnsupported) {
+    return { ok: false, reason: "unsupported", unsupportedKeys: unsupported };
+  }
+  const before = snapshotSupported(source);
+  const next = {};
+  let countries = readCountries(source);
+  if (patch.countries) {
+    const incoming = upperUnique(patch.countries);
+    countries = (patch.countriesMode ?? "replace") === "append" && countries ? upperUnique([...countries, ...incoming]) : incoming;
+  }
+  if (countries && countries.length > 0) {
+    next.geo_locations = { countries };
+  }
+  const ageMin = patch.ageMin != null ? patch.ageMin : readFiniteNumber(source?.["age_min"]);
+  const ageMax = patch.ageMax != null ? patch.ageMax : readFiniteNumber(source?.["age_max"]);
+  if (ageMin !== void 0) next.age_min = ageMin;
+  if (ageMax !== void 0) next.age_max = ageMax;
+  const genders = patch.genders ?? source?.["genders"];
+  if (Array.isArray(genders)) next.genders = genders;
+  const flexible = patch.flexibleSpec ?? source?.["flexible_spec"];
+  if (flexible !== void 0 && Array.isArray(flexible)) next.flexible_spec = flexible;
+  const explicitAdvantage = patch.advantageAudience === 0 || patch.advantageAudience === 1 ? patch.advantageAudience : void 0;
+  const advantage = explicitAdvantage ?? readAdvantage(source);
+  if (advantage === void 0) {
+    return { ok: false, reason: "advantage_unset" };
+  }
+  next.targeting_automation = { advantage_audience: advantage };
+  return {
+    ok: true,
+    targeting: next,
+    changes: diffSnapshots(before, snapshotSupported(next)),
+    droppedKeys: opts?.allowDropUnsupported ? unsupported : []
+  };
+}
+function sortedCountries(value) {
+  if (!Array.isArray(value)) return [];
+  return upperUnique(value.map((c) => String(c))).sort();
+}
+function targetingReadbackChecks(expected, actual) {
+  const checks = [];
+  const parentRead = actual !== void 0;
+  if (expected["geo_locations"] !== void 0) {
+    const exp = sortedCountries(
+      isPlainObject(expected["geo_locations"]) ? expected["geo_locations"]["countries"] : []
+    );
+    const act = sortedCountries(
+      actual && isPlainObject(actual["geo_locations"]) ? actual["geo_locations"]["countries"] : []
+    );
+    checks.push(fieldCheck("targeting.countries", exp, parentRead ? act : void 0, parentRead));
+  }
+  for (const key of ["age_min", "age_max"]) {
+    if (expected[key] === void 0) continue;
+    const raw = actual?.[key];
+    checks.push(
+      fieldCheck(
+        `targeting.${key}`,
+        expected[key],
+        parentRead ? readFiniteNumber(raw) : void 0,
+        parentRead
+      )
+    );
+  }
+  if (expected["genders"] !== void 0) {
+    const exp = Array.isArray(expected["genders"]) ? [...expected["genders"]].sort() : [];
+    const act = actual && Array.isArray(actual["genders"]) ? [...actual["genders"]].sort() : [];
+    checks.push(fieldCheck("targeting.genders", exp, parentRead ? act : void 0, parentRead));
+  }
+  if (expected["flexible_spec"] !== void 0) {
+    const exp = expected["flexible_spec"];
+    const act = actual?.["flexible_spec"];
+    const match = JSON.stringify(exp) === JSON.stringify(act);
+    checks.push({
+      field: "targeting.flexible_spec",
+      expected: exp,
+      actual: parentRead ? act : void 0,
+      state: !parentRead ? "unread" : match ? "match" : "mismatch"
+    });
+  }
+  if (isPlainObject(expected["targeting_automation"])) {
+    const exp = expected["targeting_automation"]["advantage_audience"];
+    const act = isPlainObject(actual?.["targeting_automation"]) ? readFiniteNumber(actual["targeting_automation"]["advantage_audience"]) : void 0;
+    checks.push(fieldCheck("targeting.advantage_audience", exp, act, parentRead));
+  }
+  return checks;
+}
+var ADSET_SCALAR_READBACK_KEYS = [
+  "name",
+  "status",
+  "daily_budget",
+  "lifetime_budget",
+  "optimization_goal",
+  "bid_strategy",
+  "bid_amount"
+];
+function evaluateAdSetEditReadback(sentBody, actual, readFailed) {
+  if (readFailed || !actual) return { verification: "unknown", checks: [] };
+  const checks = [];
+  for (const key of ADSET_SCALAR_READBACK_KEYS) {
+    if (sentBody[key] === void 0) continue;
+    const present = Object.prototype.hasOwnProperty.call(actual, key);
+    const money2 = key === "daily_budget" || key === "lifetime_budget" || key === "bid_amount";
+    const expected = money2 ? String(sentBody[key]) : sentBody[key];
+    const actualValue = money2 && actual[key] != null && actual[key] !== "" ? String(actual[key]) : actual[key];
+    checks.push(fieldCheck(key, expected, actualValue, present));
+  }
+  if (isPlainObject(sentBody["targeting"])) {
+    const actualTargeting = isPlainObject(actual["targeting"]) ? actual["targeting"] : void 0;
+    checks.push(
+      ...targetingReadbackChecks(
+        sentBody["targeting"],
+        Object.prototype.hasOwnProperty.call(actual, "targeting") ? actualTargeting : void 0
+      )
+    );
+  }
+  return { verification: classifyFieldChecks(checks, false), checks };
+}
 function buildUpdateAdBody(opts) {
   const body = {};
   if (opts.name != null) body.name = opts.name;
@@ -125713,6 +126361,9 @@ function runMetaLeadValidation(cfg) {
   if (adset.bidAmount != null && !(Number.isFinite(adset.bidAmount) && adset.bidAmount > 0)) {
     errors.push("adset.bidAmount \u987B\u4E3A\u5927\u4E8E 0 \u7684\u6570\u5B57\uFF08\u4E3B\u5E01\u79CD\u5143\uFF09");
   }
+  if (adset.bidAmountOnRequired != null && !(Number.isFinite(adset.bidAmountOnRequired) && adset.bidAmountOnRequired > 0)) {
+    errors.push("adset.bidAmountOnRequired \u987B\u4E3A\u5927\u4E8E 0 \u7684\u6570\u5B57\uFF08\u4E3B\u5E01\u79CD\u5143\uFF09");
+  }
   if (adset.advantageAudience != null && adset.advantageAudience !== 0 && adset.advantageAudience !== 1) {
     errors.push("adset.advantageAudience \u53EA\u5141\u8BB8 0 \u6216 1\uFF08targeting_automation.advantage_audience\uFF09");
   }
@@ -125845,6 +126496,46 @@ async function runMetaAdValidate(opts) {
   console.log("\n\u2705 Meta Lead \u914D\u7F6E\u6821\u9A8C\u901A\u8FC7\uFF08\u672C\u5730\uFF0C\u672A\u8C03\u7F51\u5173\uFF09\n");
 }
 
+// src/commands/meta-ad/bid-recovery.ts
+function decideBidAmountRecovery(input) {
+  if (input.bidAmountAlreadySet) return { action: "abort" };
+  const authorized = input.authorizedBidAmount;
+  if (typeof authorized === "number" && Number.isFinite(authorized) && authorized > 0) {
+    return {
+      action: "retry",
+      bidStrategy: "LOWEST_COST_WITH_BID_CAP",
+      bidAmount: authorized,
+      recovery: {
+        applied: true,
+        fromStrategy: input.originalBidStrategy,
+        toStrategy: "LOWEST_COST_WITH_BID_CAP",
+        bidAmount: authorized
+      }
+    };
+  }
+  const budgetNote = [
+    input.dailyBudget != null ? `\u65E5\u9884\u7B97 ${input.dailyBudget}` : "",
+    input.lifetimeBudget != null ? `\u603B\u9884\u7B97 ${input.lifetimeBudget}` : "",
+    input.currency ? input.currency : ""
+  ].filter(Boolean).join(" ");
+  return {
+    action: "needs_decision",
+    needsDecision: {
+      code: "BID_AMOUNT_REQUIRED",
+      status: "needs_decision",
+      campaignId: input.campaignId,
+      originalBidStrategy: input.originalBidStrategy,
+      proposedBidStrategy: "LOWEST_COST_WITH_BID_CAP",
+      message: "\u8BE5\u6237\u8981\u6C42\u51FA\u4EF7\u4E0A\u9650\uFF08LOWEST_COST_WITH_BID_CAP\uFF09\u3002\u9884\u7B97\u91D1\u989D\u4E0D\u80FD\u5F53\u4F5C bid cap\u3002\u8BF7\u5355\u72EC\u586B\u5199\u51FA\u4EF7\u540E\u518D\u7EE7\u7EED\uFF1Acreate JSON \u7528 adset.bidAmountOnRequired\uFF0C\u6216 adset-create \u7528 --bid-amount-on-required\u3002" + (budgetNote ? ` \u5F53\u524D\u9884\u7B97\u4EC5\u4F5C\u4E0A\u4E0B\u6587\uFF08${budgetNote}\uFF09\uFF0C\u4E0D\u4F1A\u5199\u5165 bid_amount\u3002` : ""),
+      budgetContext: {
+        dailyBudget: input.dailyBudget,
+        lifetimeBudget: input.lifetimeBudget,
+        currency: input.currency
+      }
+    }
+  };
+}
+
 // src/commands/meta-ad/create.ts
 function resolveBesideConfig(configFile, p) {
   if (isAbsolute7(p)) return p;
@@ -126011,23 +126702,47 @@ async function runMetaAdCreate(opts) {
       );
     } catch (firstErr) {
       if (!isBidAmountRequired(firstErr) || cfg.adset.bidAmount != null) throw firstErr;
-      const retryMajor = cfg.campaign.dailyBudget ?? cfg.campaign.lifetimeBudget ?? cfg.adset.dailyBudget ?? cfg.adset.lifetimeBudget ?? 1;
-      if (!opts.jsonOut) {
-        console.warn(
+      const decision = decideBidAmountRecovery({
+        bidAmountAlreadySet: false,
+        authorizedBidAmount: cfg.adset.bidAmountOnRequired,
+        originalBidStrategy: baseAdset.bidStrategy,
+        dailyBudget: cfg.campaign.dailyBudget ?? cfg.adset.dailyBudget,
+        lifetimeBudget: cfg.campaign.lifetimeBudget ?? cfg.adset.lifetimeBudget,
+        currency,
+        campaignId: progress.campaignId
+      });
+      if (decision.action === "needs_decision") {
+        progress.failedStep = "adset";
+        progress.needsDecision = decision.needsDecision;
+        progress.error = decision.needsDecision.message;
+        await emitProgress();
+        console.error(
           `
-\u26A0\uFE0F  \u8BE5\u6237\u8981\u6C42 bid cap\uFF0C\u6309\u65E5/\u603B\u9884\u7B97 ${retryMajor} ${currency} \u5E26 LOWEST_COST_WITH_BID_CAP \u91CD\u8BD5\u5EFA\u7EC4
+\u26A0\uFE0F  ${decision.needsDecision.message}
+   \u5DF2\u5EFA\u6210\uFF1A${summarizeProgress(progress)}
+   \u539F\u7B56\u7565\uFF1A${decision.needsDecision.originalBidStrategy ?? "\uFF08\u672A\u6307\u5B9A\uFF09"}
+   \u62DF\u8BAE\u7B56\u7565\uFF1A${decision.needsDecision.proposedBidStrategy}
+   \u672C\u6B21\u672A\u6539\u51FA\u4EF7\uFF0C\u672A\u518D\u6B21\u5EFA\u7EC4\u3002
 `
         );
+        process.exit(2);
       }
+      if (decision.action !== "retry") throw firstErr;
+      console.warn(
+        `
+\u26A0\uFE0F  \u5DF2\u6309\u4E8B\u524D\u6388\u6743\u7684 bid cap ${decision.bidAmount} ${currency} \u4EE5 LOWEST_COST_WITH_BID_CAP \u91CD\u8BD5\u5EFA\u7EC4\uFF08\u539F\u7B56\u7565 ${decision.recovery.fromStrategy ?? "\u672A\u6307\u5B9A"}\uFF09
+`
+      );
+      progress.recovery = decision.recovery;
       data = await postJson(
         adsetUrl,
         config,
         buildCreateAdSetBody({
-          adset: { ...baseAdset, bidStrategy: "LOWEST_COST_WITH_BID_CAP" },
+          adset: { ...baseAdset, bidStrategy: decision.bidStrategy },
           campaignId: progress.campaignId,
           pageId,
           ...money2,
-          bidAmountMinor: toMinorUnitString(retryMajor, currency)
+          bidAmountMinor: toMinorUnitString(decision.bidAmount, currency)
         }),
         opts.verbose
       );
@@ -126856,6 +127571,28 @@ async function runMetaAdCampaignStatus(opts) {
 // src/commands/meta-ad/adset.ts
 init_cli_table();
 init_auth();
+var READBACK_WAIT_MS = 1e3;
+function parseCountriesMode(raw) {
+  if (!raw || raw === "replace") return "replace";
+  if (raw === "append") return "append";
+  throw new Error("--countries-mode \u53EA\u5141\u8BB8 append \u6216 replace");
+}
+function isRecord2(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function formatTargetingChange(change) {
+  const from = change.from == null ? "\uFF08\u65E0\uFF09" : JSON.stringify(change.from);
+  const to = change.to == null ? "\uFF08\u65E0\uFF09" : JSON.stringify(change.to);
+  return change.changed ? `${change.field}\uFF1A${from} \u2192 ${to}` : `${change.field}\uFF1A${to}\uFF08\u4FDD\u6301\uFF09`;
+}
+async function readAdSetForVerify(url, config, verbose) {
+  try {
+    const raw = await apiFetch2(url, config, {}, verbose);
+    return { adset: raw, readFailed: false };
+  } catch {
+    return { readFailed: true };
+  }
+}
 function parseGenders(raw) {
   if (!raw?.trim()) return void 0;
   const nums = raw.split(",").map((s) => Number(s.trim()));
@@ -127002,14 +127739,37 @@ async function runMetaAdAdsetCreate(opts) {
     if (!isBidAmountRequired(firstErr) || adset.bidAmount != null) {
       failMetaAd("\u5EFA\u5E7F\u544A\u7EC4\u5931\u8D25", firstErr);
     }
-    const retryMajor = daily ?? lifetime ?? 1;
-    if (!opts.jsonOut) {
-      console.warn(
+    const decision = decideBidAmountRecovery({
+      bidAmountAlreadySet: false,
+      authorizedBidAmount: opts.bidAmountOnRequired,
+      originalBidStrategy: adset.bidStrategy,
+      dailyBudget: daily,
+      lifetimeBudget: lifetime,
+      currency,
+      campaignId: opts.campaignId.trim()
+    });
+    if (decision.action === "needs_decision") {
+      const payload3 = { ...decision.needsDecision, currency };
+      console.error(
         `
-\u26A0\uFE0F  \u8BE5\u6237\u8981\u6C42 bid cap\uFF0C\u6309\u65E5/\u603B\u9884\u7B97 ${retryMajor} ${currency} \u5E26 LOWEST_COST_WITH_BID_CAP \u91CD\u8BD5\u5EFA\u7EC4
+\u26A0\uFE0F  ${decision.needsDecision.message}
+   \u539F\u7B56\u7565\uFF1A${decision.needsDecision.originalBidStrategy ?? "\uFF08\u672A\u6307\u5B9A\uFF09"}
+   \u62DF\u8BAE\u7B56\u7565\uFF1A${decision.needsDecision.proposedBidStrategy}
+   campaignId\uFF1A${opts.campaignId.trim()}
+   \u672C\u6B21\u672A\u6539\u51FA\u4EF7\uFF0C\u672A\u518D\u6B21\u5EFA\u7EC4\u3002
 `
       );
+      await emitMetaJson(opts, "meta-ad-adset-create", "meta-ad adset-create", payload3, digits, {
+        status: "needs_decision"
+      });
+      process.exit(2);
     }
+    if (decision.action !== "retry") failMetaAd("\u5EFA\u5E7F\u544A\u7EC4\u5931\u8D25", firstErr);
+    console.warn(
+      `
+\u26A0\uFE0F  \u5DF2\u6309\u4E8B\u524D\u6388\u6743\u7684 bid cap ${decision.bidAmount} ${currency} \u4EE5 LOWEST_COST_WITH_BID_CAP \u91CD\u8BD5\u5EFA\u7EC4\uFF08\u539F\u7B56\u7565 ${decision.recovery.fromStrategy ?? "\u672A\u6307\u5B9A"}\uFF09
+`
+    );
     try {
       data = await apiFetch2(
         adsetUrl,
@@ -127018,12 +127778,12 @@ async function runMetaAdAdsetCreate(opts) {
           method: "POST",
           body: JSON.stringify(
             buildCreateAdSetBody({
-              adset: { ...adset, bidStrategy: "LOWEST_COST_WITH_BID_CAP" },
+              adset: { ...adset, bidStrategy: decision.bidStrategy },
               campaignId: opts.campaignId.trim(),
               pageId: opts.pageId.trim(),
               dailyBudgetMinor: daily != null ? toMinorUnitString(daily, currency) : void 0,
               lifetimeBudgetMinor: lifetime != null ? toMinorUnitString(lifetime, currency) : void 0,
-              bidAmountMinor: toMinorUnitString(retryMajor, currency)
+              bidAmountMinor: toMinorUnitString(decision.bidAmount, currency)
             })
           )
         },
@@ -127032,6 +127792,15 @@ async function runMetaAdAdsetCreate(opts) {
     } catch (retryErr) {
       failMetaAd("\u5EFA\u5E7F\u544A\u7EC4\u5931\u8D25", retryErr);
     }
+    const id2 = extractCreatedId(data);
+    const payload2 = { ...data, id: id2, currency, recovery: decision.recovery };
+    if (await emitMetaJson(opts, "meta-ad-adset-create", "meta-ad adset-create", payload2, digits)) {
+      return;
+    }
+    console.log(`
+\u2705 \u5E7F\u544A\u7EC4\u5DF2\u521B\u5EFA\uFF1A${id2 ?? JSON.stringify(data)}
+`);
+    return;
   }
   const id = extractCreatedId(data);
   const payload = { ...data, id, currency };
@@ -127053,10 +127822,12 @@ async function runMetaAdAdsetEdit(opts) {
   let countries;
   let genders;
   let advantageAudience;
+  let countriesMode;
   try {
     if (opts.countries != null) countries = assertCountries(opts.countries);
     genders = parseGenders(opts.genders);
     advantageAudience = parseAdvantageAudience(opts.advantageAudience);
+    countriesMode = parseCountriesMode(opts.countriesMode);
   } catch (err) {
     console.error(`
 \u274C ${err instanceof Error ? err.message : String(err)}
@@ -127070,26 +127841,87 @@ async function runMetaAdAdsetEdit(opts) {
       process.exit(1);
     }
   }
+  const ageMin = parseOptionalNumber(opts.ageMin);
+  const ageMax = parseOptionalNumber(opts.ageMax);
+  const wantsTargeting = countries != null || ageMin != null || ageMax != null || genders != null || advantageAudience != null;
   const { config, facebookApiUrl } = metaAdContext(opts.token);
   const currency = await fetchAccountCurrency(facebookApiUrl, digits, config, opts.verbose);
   const bidAmount = parseOptionalNumber(opts.bidAmount);
+  const adsetUrl = adsUrl(facebookApiUrl, digits, `/adsets/${encodeURIComponent(opts.id)}`);
+  let targeting;
+  let targetingChanges;
+  let droppedKeys = [];
+  if (wantsTargeting) {
+    let currentRaw;
+    try {
+      currentRaw = await apiFetch2(adsetUrl, config, {}, opts.verbose);
+    } catch (err) {
+      console.error(
+        `
+\u274C \u8BFB\u53D6\u5F53\u524D\u5B9A\u5411\u5931\u8D25\uFF0C\u672A\u63D0\u4EA4\u4FEE\u6539\uFF1A${err instanceof Error ? err.message : String(err)}
+`
+      );
+      process.exit(1);
+    }
+    const currentTargeting = isRecord2(currentRaw["targeting"]) ? currentRaw["targeting"] : void 0;
+    const merged = mergeAdSetTargeting(
+      currentTargeting,
+      {
+        countries,
+        countriesMode: countries ? countriesMode : "replace",
+        ageMin,
+        ageMax,
+        genders,
+        advantageAudience
+      },
+      { allowDropUnsupported: opts.targetingReplace === true }
+    );
+    if (!merged.ok) {
+      const payload2 = merged.reason === "advantage_unset" ? {
+        status: "needs_decision",
+        code: "ADVANTAGE_AUDIENCE_UNSET",
+        id: opts.id,
+        message: "\u5F53\u524D\u7EC4\u8BFB\u4E0D\u5230 advantage_audience\uFF080 \u6216 1\uFF09\u3002\u7F51\u5173\u4F1A\u5728\u8FD9\u6B21\u5B9A\u5411\u66F4\u65B0\u91CC\u628A\u5B83\u5199\u6210 1\u3002\u8BF7\u663E\u5F0F\u4F20\u5165 --advantage-audience 0 \u6216 1 \u540E\u518D\u63D0\u4EA4\u3002\u672C\u6B21\u672A\u63D0\u4EA4\u4FEE\u6539\u3002"
+      } : {
+        status: "needs_decision",
+        code: "TARGETING_UNSUPPORTED",
+        id: opts.id,
+        unsupportedKeys: merged.unsupportedKeys,
+        message: "\u5F53\u524D\u5B9A\u5411\u542B\u672C\u547D\u4EE4\u4E0D\u80FD\u5B89\u5168\u5199\u56DE\u7684\u5B57\u6BB5\u3002\u6574\u4EFD\u66FF\u6362\u4F1A\u4E22\u6389\u5B83\u4EEC\u3002\u786E\u8BA4\u53EA\u4FDD\u7559\u56FD\u5BB6/\u5E74\u9F84/\u6027\u522B/flexible_spec/advantage_audience \u540E\uFF0C\u52A0\u4E0A --targeting-replace \u518D\u63D0\u4EA4\u3002\u672C\u6B21\u672A\u63D0\u4EA4\u4FEE\u6539\u3002"
+      };
+      const extra = merged.reason === "unsupported" ? `
+   \u4E0D\u80FD\u5199\u56DE\uFF1A${merged.unsupportedKeys.join("\u3001")}` : "";
+      console.error(`
+\u26A0\uFE0F  ${payload2.message}${extra}
+`);
+      await emitMetaJson(opts, "meta-ad-adset-edit", "meta-ad adset-edit", payload2, digits, {
+        status: "needs_decision"
+      });
+      process.exit(2);
+    }
+    targeting = merged.targeting;
+    targetingChanges = merged.changes;
+    droppedKeys = merged.droppedKeys;
+    const lines = merged.changes.map(formatTargetingChange);
+    if (droppedKeys.length > 0) lines.push(`\u5C06\u4E22\u5F03\uFF1A${droppedKeys.join("\u3001")}`);
+    console.error(`
+\u5B9A\u5411\u5DEE\u5F02\uFF1A
+   ${lines.join("\n   ")}
+`);
+  }
   let body;
   try {
     body = buildUpdateAdSetBody({
       name: opts.name?.trim() || void 0,
       dailyBudgetMinor: daily != null ? toMinorUnitString(daily, currency) : void 0,
       lifetimeBudgetMinor: lifetime != null ? toMinorUnitString(lifetime, currency) : void 0,
-      countries,
-      ageMin: parseOptionalNumber(opts.ageMin),
-      ageMax: parseOptionalNumber(opts.ageMax),
-      genders,
+      targeting,
       optimizationGoal: opts.optimizationGoal?.trim().toUpperCase(),
       bidStrategy: opts.bidStrategy,
       bidAmountMinor: bidAmount != null ? toMinorUnitString(bidAmount, currency) : void 0,
       startTime: opts.startTime,
       endTime: opts.endTime,
-      status: opts.status,
-      advantageAudience
+      status: opts.status
     });
   } catch (err) {
     console.error(`
@@ -127102,16 +127934,47 @@ async function runMetaAdAdsetEdit(opts) {
     process.exit(1);
   }
   const data = await metaAdPost(
-    adsUrl(facebookApiUrl, digits, `/adsets/${encodeURIComponent(opts.id)}`),
+    adsetUrl,
     config,
     body,
     opts.verbose,
     "\u6539\u5E7F\u544A\u7EC4\u5931\u8D25"
   );
-  const payload = { id: extractCreatedId(data) ?? opts.id, ...data };
-  if (await emitMetaJson(opts, "meta-ad-adset-edit", "meta-ad adset-edit", payload, digits)) return;
+  let read = await readAdSetForVerify(adsetUrl, config, opts.verbose);
+  let judged = evaluateAdSetEditReadback(body, read.adset, read.readFailed);
+  if (judged.verification !== "verified") {
+    await new Promise((r) => setTimeout(r, READBACK_WAIT_MS));
+    read = await readAdSetForVerify(adsetUrl, config, opts.verbose);
+    judged = evaluateAdSetEditReadback(body, read.adset, read.readFailed);
+  }
+  const verification = judged.verification;
+  const nextQuery = `siluzan-tso meta-ad adset -a ${digits} --id ${opts.id} --json-out ./snap`;
+  const unmatched = describeUnmatchedChecks(judged.checks);
+  const detail = verification === "verified" ? `\u5E7F\u544A\u7EC4 ${opts.id} \u5DF2\u6838\u9A8C` : unmatched || `\u5E7F\u544A\u7EC4 ${opts.id} \u7684\u5199\u5165\u7ED3\u679C\u5C1A\u672A\u6838\u9A8C`;
+  const headline = writeVerificationHeadline(verification, detail);
+  if (verification !== "verified") {
+    console.error(`
+${headline}
+   \u8BF7\u518D\u67E5\uFF1A${nextQuery}
+`);
+  }
+  const payload = {
+    id: extractCreatedId(data) ?? opts.id,
+    verification,
+    nextQuery,
+    targetingDiff: targetingChanges,
+    droppedKeys,
+    checks: judged.checks,
+    ...data
+  };
+  if (await emitMetaJson(opts, "meta-ad-adset-edit", "meta-ad adset-edit", payload, digits, {
+    verification
+  })) {
+    return;
+  }
   console.log(`
-\u2705 \u5E7F\u544A\u7EC4 ${opts.id} \u5DF2\u66F4\u65B0
+${headline}${verification === "verified" ? "" : `
+   \u8BF7\u518D\u67E5\uFF1A${nextQuery}`}
 `);
 }
 async function runMetaAdAdsetStatus(opts) {
@@ -127408,7 +128271,11 @@ function register22(program2) {
   );
   addCommon(
     addAccount(
-      meta.command("adset-create").description("\u5EFA\u7EBF\u7D22\u5E7F\u544A\u7EC4\uFF08destination=ON_AD\uFF1B\u9ED8\u8BA4 LEAD_GENERATION\uFF09").requiredOption("--campaign-id <id>", "\u7CFB\u5217 ID").requiredOption("--page-id <id>", "\u6295\u653E\u4E3B\u9875 ID").requiredOption("--name <name>", "\u7EC4\u540D\u79F0").requiredOption("--countries <list>", "ISO \u56FD\u5BB6\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u5982 US,GB\uFF09").option("--daily-budget <amount>", "\u65E5\u9884\u7B97\uFF0C\u4E3B\u5E01\u79CD\u5143\uFF08ABO\uFF09", parseFloat).option("--lifetime-budget <amount>", "\u603B\u9884\u7B97\uFF0C\u4E3B\u5E01\u79CD\u5143", parseFloat).option("--age-min <n>", "\u6700\u5C0F\u5E74\u9F84", parseInt).option("--age-max <n>", "\u6700\u5927\u5E74\u9F84", parseInt).option("--genders <list>", "1=\u7537,2=\u5973\uFF0C\u9017\u53F7\u5206\u9694").option("--optimization-goal <g>", "LEAD_GENERATION | QUALITY_LEAD").option("--bid-strategy <s>", "\u51FA\u4EF7\u7B56\u7565").option("--bid-amount <amount>", "\u51FA\u4EF7\u4E0A\u9650\uFF0C\u4E3B\u5E01\u79CD\u5143", parseFloat).option("--start-time <iso>", "\u5F00\u59CB\u65F6\u95F4").option("--end-time <iso>", "\u7ED3\u675F\u65F6\u95F4").option("--status <status>", "ACTIVE | PAUSED").option(
+      meta.command("adset-create").description("\u5EFA\u7EBF\u7D22\u5E7F\u544A\u7EC4\uFF08destination=ON_AD\uFF1B\u9ED8\u8BA4 LEAD_GENERATION\uFF09").requiredOption("--campaign-id <id>", "\u7CFB\u5217 ID").requiredOption("--page-id <id>", "\u6295\u653E\u4E3B\u9875 ID").requiredOption("--name <name>", "\u7EC4\u540D\u79F0").requiredOption("--countries <list>", "ISO \u56FD\u5BB6\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u5982 US,GB\uFF09").option("--daily-budget <amount>", "\u65E5\u9884\u7B97\uFF0C\u4E3B\u5E01\u79CD\u5143\uFF08ABO\uFF09", parseFloat).option("--lifetime-budget <amount>", "\u603B\u9884\u7B97\uFF0C\u4E3B\u5E01\u79CD\u5143", parseFloat).option("--age-min <n>", "\u6700\u5C0F\u5E74\u9F84", parseInt).option("--age-max <n>", "\u6700\u5927\u5E74\u9F84", parseInt).option("--genders <list>", "1=\u7537,2=\u5973\uFF0C\u9017\u53F7\u5206\u9694").option("--optimization-goal <g>", "LEAD_GENERATION | QUALITY_LEAD").option("--bid-strategy <s>", "\u51FA\u4EF7\u7B56\u7565").option("--bid-amount <amount>", "\u51FA\u4EF7\u4E0A\u9650\uFF0C\u4E3B\u5E01\u79CD\u5143", parseFloat).option(
+        "--bid-amount-on-required <amount>",
+        "\u4EC5\u5F53\u5EFA\u7EC4\u8FD4\u56DE BID_AMOUNT_REQUIRED \u65F6\u4F7F\u7528\u7684\u51FA\u4EF7\u4E0A\u9650\uFF08\u4E3B\u5E01\u79CD\u5143\uFF09\u3002\u4E0D\u4F20\u5219\u505C\u4E0B\uFF0C\u4E0D\u4F1A\u7528\u9884\u7B97\u4EE3\u66FF",
+        parseFloat
+      ).option("--start-time <iso>", "\u5F00\u59CB\u65F6\u95F4").option("--end-time <iso>", "\u7ED3\u675F\u65F6\u95F4").option("--status <status>", "ACTIVE | PAUSED").option(
         "--advantage-audience <n>",
         "0=\u7CBE\u786E\u5B9A\u5411 1=Advantage Audience\uFF08\u9ED8\u8BA4 1\uFF09",
         (v) => Number.parseInt(v, 10)
@@ -127421,11 +128288,13 @@ function register22(program2) {
   );
   addCommon(
     addAccount(
-      meta.command("adset-edit").description("\u6539\u5E7F\u544A\u7EC4\uFF08targeting \u6574\u4EFD\u66FF\u6362\uFF1A\u56FD\u5BB6/\u5E74\u9F84/\u6027\u522B/advantage_audience\uFF09").requiredOption("--id <adSetId>", "\u5E7F\u544A\u7EC4 ID").option("--name <name>", "\u65B0\u540D\u79F0").option("--daily-budget <amount>", "\u65E5\u9884\u7B97\uFF0C\u4E3B\u5E01\u79CD\u5143", parseFloat).option("--lifetime-budget <amount>", "\u603B\u9884\u7B97\uFF0C\u4E3B\u5E01\u79CD\u5143", parseFloat).option("--countries <list>", "ISO \u56FD\u5BB6\uFF0C\u9017\u53F7\u5206\u9694").option("--age-min <n>", "\u6700\u5C0F\u5E74\u9F84", parseInt).option("--age-max <n>", "\u6700\u5927\u5E74\u9F84", parseInt).option("--genders <list>", "1=\u7537,2=\u5973").option("--optimization-goal <g>", "LEAD_GENERATION | QUALITY_LEAD").option("--bid-strategy <s>", "\u51FA\u4EF7\u7B56\u7565").option("--bid-amount <amount>", "\u51FA\u4EF7\u4E0A\u9650\uFF0C\u4E3B\u5E01\u79CD\u5143", parseFloat).option("--start-time <iso>", "\u5F00\u59CB\u65F6\u95F4").option("--end-time <iso>", "\u7ED3\u675F\u65F6\u95F4").option("--status <status>", "\u72B6\u6001").option(
+      meta.command("adset-edit").description(
+        "\u6539\u5E7F\u544A\u7EC4\u3002\u56FD\u5BB6\u9ED8\u8BA4\u6574\u8868\u66FF\u6362\uFF1B\u8FFD\u52A0\u7528 --countries-mode append\u3002\u672A\u4F20 --advantage-audience \u65F6\u4FDD\u7559\u5F53\u524D\u503C\uFF0C\u4E0D\u5957\u521B\u5EFA\u9ED8\u8BA4"
+      ).requiredOption("--id <adSetId>", "\u5E7F\u544A\u7EC4 ID").option("--name <name>", "\u65B0\u540D\u79F0").option("--daily-budget <amount>", "\u65E5\u9884\u7B97\uFF0C\u4E3B\u5E01\u79CD\u5143", parseFloat).option("--lifetime-budget <amount>", "\u603B\u9884\u7B97\uFF0C\u4E3B\u5E01\u79CD\u5143", parseFloat).option("--countries <list>", "ISO \u56FD\u5BB6\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u9ED8\u8BA4\u66FF\u6362\u6574\u4EFD\u56FD\u5BB6\u5217\u8868\uFF09").option("--countries-mode <mode>", "replace\uFF08\u9ED8\u8BA4\uFF09| append\uFF08\u5E76\u4E0A\u5F53\u524D\u56FD\u5BB6\uFF09").option("--age-min <n>", "\u6700\u5C0F\u5E74\u9F84", parseInt).option("--age-max <n>", "\u6700\u5927\u5E74\u9F84", parseInt).option("--genders <list>", "1=\u7537,2=\u5973").option("--optimization-goal <g>", "LEAD_GENERATION | QUALITY_LEAD").option("--bid-strategy <s>", "\u51FA\u4EF7\u7B56\u7565").option("--bid-amount <amount>", "\u51FA\u4EF7\u4E0A\u9650\uFF0C\u4E3B\u5E01\u79CD\u5143", parseFloat).option("--start-time <iso>", "\u5F00\u59CB\u65F6\u95F4").option("--end-time <iso>", "\u7ED3\u675F\u65F6\u95F4").option("--status <status>", "\u72B6\u6001").option(
         "--advantage-audience <n>",
-        "0=\u7CBE\u786E\u5B9A\u5411 1=Advantage Audience",
+        "0 \u6216 1\u3002\u4E0D\u4F20\u5219\u4FDD\u7559\u5F53\u524D\u503C\uFF0C\u4E0D\u4F1A\u9ED8\u8BA4\u6210 1",
         (v) => Number.parseInt(v, 10)
-      )
+      ).option("--targeting-replace", "\u786E\u8BA4\u4E22\u6389\u5F53\u524D\u5B9A\u5411\u91CC\u672C\u547D\u4EE4\u4E0D\u80FD\u5199\u56DE\u7684\u5B57\u6BB5\u540E\u518D\u63D0\u4EA4", false)
     )
   ).action(
     async (opts) => {