siluzan-tso-cli 1.1.55 → 1.1.56-beta.1

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.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
   }
 });
 
@@ -103126,7 +103126,7 @@ function narrativeClaimsMobileSpendLeads(text2) {
   if (!t.includes("\u79FB\u52A8")) return false;
   return /移动(?:端|设备)?(?:为|是)主要消耗/.test(t) || /移动(?:端|设备)?为主要(?:消耗)?设备/.test(t) || /移动(?:端|设备)?(?:消耗|花费|费用|流量)?占比高/.test(t);
 }
-function asRecord16(value) {
+function asRecord17(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) return value;
   return null;
 }
@@ -103134,16 +103134,16 @@ function stringList(value) {
   return (Array.isArray(value) ? value : []).map((item) => typeof item === "string" ? item.trim() : "").filter(Boolean);
 }
 function collectOkkiNarrativeText(data) {
-  const narrative = asRecord16(data.narrative) ?? {};
+  const narrative = asRecord17(data.narrative) ?? {};
   const parts = [];
-  const sheetAnalysis = asRecord16(narrative.sheetAnalysis) ?? {};
+  const sheetAnalysis = asRecord17(narrative.sheetAnalysis) ?? {};
   for (const block of Object.values(sheetAnalysis)) {
-    const rec = asRecord16(block);
+    const rec = asRecord17(block);
     parts.push(...stringList(rec?.summary), ...stringList(rec?.suggestions));
   }
-  const review = asRecord16(narrative.review) ?? {};
+  const review = asRecord17(narrative.review) ?? {};
   for (const block of Object.values(review)) {
-    const rec = asRecord16(block);
+    const rec = asRecord17(block);
     for (const key of ["overview", "summary", "suggestion"]) {
       const value = rec?.[key];
       if (typeof value === "string" && value.trim()) parts.push(value.trim());
@@ -103160,7 +103160,7 @@ var init_okki_display = __esm({
 // src/commands/google-analysis/merge-snapshot.ts
 import * as fs27 from "fs/promises";
 import * as path32 from "path";
-function asRecord17(value) {
+function asRecord18(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -103256,7 +103256,7 @@ function periodMetricsFromRow(row) {
 }
 function items(envelope) {
   if (!envelope || !Array.isArray(envelope.items)) return [];
-  return envelope.items.filter((row) => asRecord17(row) !== null);
+  return envelope.items.filter((row) => asRecord18(row) !== null);
 }
 function record(envelope) {
   return envelope?.record ?? null;
@@ -103303,14 +103303,14 @@ function sumCampaignRowsToPeriodKpis(rows) {
 }
 async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
   const absDir = path32.resolve(snapshotDir);
-  const metaAccountId = typeof asRecord17(payload.meta)?.accountId === "string" ? asRecord17(payload.meta)?.accountId : void 0;
+  const metaAccountId = typeof asRecord18(payload.meta)?.accountId === "string" ? asRecord18(payload.meta)?.accountId : void 0;
   const manifest = await readManifest(snapshotDir, metaAccountId);
   if (!manifest) {
     throw new Error(`\u672A\u5728 ${absDir} \u627E\u5230 manifest*.json\uFF0C\u8BF7\u5148\u6267\u884C google-analysis --json-out`);
   }
   const accountId = manifest.googleAnalysis?.accountId ?? metaAccountId;
   const dateRange = manifest.googleAnalysis?.dateRange;
-  const preferredDateTag = dateTagFromRange(dateRange) ?? dateTagFromMeta(asRecord17(payload.meta) ?? void 0);
+  const preferredDateTag = dateTagFromRange(dateRange) ?? dateTagFromMeta(asRecord18(payload.meta) ?? void 0);
   const sectionMap = /* @__PURE__ */ new Map();
   for (const art of manifest.artifacts ?? []) {
     const data = await loadSectionFile(absDir, art.file);
@@ -103318,8 +103318,8 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
   }
   await recoverMissingReportSections(sectionMap, absDir, accountId, preferredDateTag);
   const overviewRecord = record(sectionMap.get("overview"));
-  const currentPeriod = asRecord17(overviewRecord?.currentPeriod);
-  const previousPeriod = asRecord17(overviewRecord?.previousPeriod);
+  const currentPeriod = asRecord18(overviewRecord?.currentPeriod);
+  const previousPeriod = asRecord18(overviewRecord?.previousPeriod);
   const meta = { ...payload.meta ?? {} };
   if (!meta.accountId && accountId) meta.accountId = accountId;
   if (!meta.currency) {
@@ -103465,7 +103465,7 @@ function textLen(value) {
 function asArray(value) {
   return Array.isArray(value) ? value : [];
 }
-function asRecord18(value) {
+function asRecord19(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -103479,7 +103479,7 @@ function pushMissing(missing, id, chapter, dimension, hint) {
 }
 function validateOkkiWeeklyReportContent(data) {
   const missing = [];
-  const meta = asRecord18(data.meta) ?? {};
+  const meta = asRecord19(data.meta) ?? {};
   if (!textLen(meta.accountId)) {
     pushMissing(
       missing,
@@ -103489,7 +103489,7 @@ function validateOkkiWeeklyReportContent(data) {
       "meta.accountId \u5FC5\u586B\uFF1B\u53EF\u7531 --snapshot-dir \u5408\u5E76 overview/manifest"
     );
   }
-  const snapshotSections = asRecord18(data.snapshot?.sections) ?? {};
+  const snapshotSections = asRecord19(data.snapshot?.sections) ?? {};
   const snapshotPresent = {};
   for (const section of OKKI_SNAPSHOT_SECTIONS) {
     const present = snapshotSections[section] === true;
@@ -103504,12 +103504,12 @@ function validateOkkiWeeklyReportContent(data) {
       );
     }
   }
-  const narrative = asRecord18(data.narrative) ?? {};
-  const sheetAnalysis = asRecord18(narrative.sheetAnalysis) ?? {};
-  const review = asRecord18(narrative.review) ?? {};
+  const narrative = asRecord19(data.narrative) ?? {};
+  const sheetAnalysis = asRecord19(narrative.sheetAnalysis) ?? {};
+  const review = asRecord19(narrative.review) ?? {};
   const sheetAnalysisCounts = {};
   for (const key of OKKI_SHEET_KEYS) {
-    const block = asRecord18(sheetAnalysis[key]);
+    const block = asRecord19(sheetAnalysis[key]);
     const summary = stringList2(block?.summary);
     const suggestions = stringList2(block?.suggestions);
     sheetAnalysisCounts[key] = { summary: summary.length, suggestions: suggestions.length };
@@ -103535,7 +103535,7 @@ function validateOkkiWeeklyReportContent(data) {
   }
   const reviewFilled = {};
   for (const key of OKKI_REVIEW_KEYS) {
-    const block = asRecord18(review[key]);
+    const block = asRecord19(review[key]);
     const overview = textLen(block?.overview);
     const summary = textLen(block?.summary);
     const suggestion = textLen(block?.suggestion);
@@ -103570,7 +103570,7 @@ function validateOkkiWeeklyReportContent(data) {
     }
   }
   const deviceRows2 = Array.isArray(data.tables?.devices) ? data.tables.devices : [];
-  const deviceSpend = summarizeOkkiDeviceSpend(deviceRows2.filter((row) => asRecord18(row) !== null));
+  const deviceSpend = summarizeOkkiDeviceSpend(deviceRows2.filter((row) => asRecord19(row) !== null));
   if (deviceSpend.total > 0 && deviceSpend.desktop >= deviceSpend.mobile && narrativeClaimsMobileSpendLeads(collectOkkiNarrativeText(data))) {
     pushMissing(
       missing,
@@ -103659,7 +103659,7 @@ function round25(value) {
 }
 function items2(envelope) {
   if (!envelope || !Array.isArray(envelope.items)) return [];
-  return envelope.items.filter((row) => asRecord18(row) !== null);
+  return envelope.items.filter((row) => asRecord19(row) !== null);
 }
 function dateTagFromRange2(dateRange) {
   if (!dateRange || dateRange.mode !== "range") return void 0;
@@ -103703,14 +103703,14 @@ async function loadSectionFile2(snapshotDir, file) {
 }
 async function mergeOkkiSnapshotIntoReport(payload, snapshotDir) {
   const absDir = path33.resolve(snapshotDir);
-  const metaAccountId = typeof asRecord18(payload.meta)?.accountId === "string" ? asRecord18(payload.meta)?.accountId : void 0;
+  const metaAccountId = typeof asRecord19(payload.meta)?.accountId === "string" ? asRecord19(payload.meta)?.accountId : void 0;
   const manifest = await readManifest2(absDir, metaAccountId);
   if (!manifest) {
     throw new Error(`\u672A\u5728 ${absDir} \u627E\u5230 manifest*.json\uFF0C\u8BF7\u5148\u6267\u884C google-analysis --json-out`);
   }
   const accountId = manifest.googleAnalysis?.accountId ?? metaAccountId;
   const dateRange = manifest.googleAnalysis?.dateRange;
-  const preferredDateTag = dateTagFromRange2(dateRange) ?? dateTagFromMeta2(asRecord18(payload.meta) ?? void 0);
+  const preferredDateTag = dateTagFromRange2(dateRange) ?? dateTagFromMeta2(asRecord19(payload.meta) ?? void 0);
   const sectionMap = /* @__PURE__ */ new Map();
   for (const art of manifest.artifacts ?? []) {
     const data = await loadSectionFile2(absDir, art.file);
@@ -103736,7 +103736,7 @@ async function mergeOkkiSnapshotIntoReport(payload, snapshotDir) {
     snapshotPresent[section] = sectionMap.has(section);
   }
   const overviewRecord = sectionMap.get("overview")?.record ?? null;
-  const currentPeriod = asRecord18(overviewRecord?.currentPeriod);
+  const currentPeriod = asRecord19(overviewRecord?.currentPeriod);
   const meta = { ...payload.meta ?? {} };
   if (!meta.accountId && accountId) meta.accountId = accountId;
   if (!meta.currency) {
@@ -103879,18 +103879,18 @@ function prefixLines(items3, firstPrefix) {
   });
 }
 function analysisLines(data, key) {
-  const block = asRecord18(asRecord18(data.narrative)?.sheetAnalysis)?.[key];
-  const rec = asRecord18(block);
+  const block = asRecord19(asRecord19(data.narrative)?.sheetAnalysis)?.[key];
+  const rec = asRecord19(block);
   return [
     ...prefixLines(stringList2(rec?.summary), "\u603B\u7ED3\uFF1A"),
     ...prefixLines(stringList2(rec?.suggestions), "\u5EFA\u8BAE\uFF1A")
   ];
 }
 function reviewLines(data) {
-  const review = asRecord18(asRecord18(data.narrative)?.review) ?? {};
+  const review = asRecord19(asRecord19(data.narrative)?.review) ?? {};
   const lines = [];
   OKKI_REVIEW_KEYS.forEach((key, idx) => {
-    const block = asRecord18(review[key]) ?? {};
+    const block = asRecord19(review[key]) ?? {};
     lines.push(`${idx + 1}\u3001${REVIEW_LABELS2[key]}\uFF1A${str(block.overview, "")}`);
     lines.push(`   \u603B\u7ED3\uFF1A${str(block.summary, "")}`);
     lines.push(`   \u5EFA\u8BAE\uFF1A${str(block.suggestion, "")}`);
@@ -104022,7 +104022,7 @@ function geoRows(data) {
   });
 }
 function buildOkkiWeeklySheetDrafts(data) {
-  const meta = asRecord18(data.meta) ?? {};
+  const meta = asRecord19(data.meta) ?? {};
   const period = formatOkkiZhDateRange(str(meta.startDate, ""), str(meta.endDate, ""));
   const campaigns = campaignRows(data);
   const drafts = {
@@ -104283,7 +104283,7 @@ function textLen2(value) {
 function asArray2(value) {
   return Array.isArray(value) ? value : [];
 }
-function asRecord19(value) {
+function asRecord20(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -104294,9 +104294,9 @@ function pushMissing2(missing, id, chapter, dimension, hint) {
 }
 function validateGooglePeriodReportContent(data) {
   const missing = [];
-  const meta = asRecord19(data.meta) ?? {};
-  const narrative = asRecord19(data.narrative) ?? {};
-  const sections = asRecord19(narrative.sections) ?? {};
+  const meta = asRecord20(data.meta) ?? {};
+  const narrative = asRecord20(data.narrative) ?? {};
+  const sections = asRecord20(narrative.sections) ?? {};
   if (!textLen2(meta.accountId)) {
     pushMissing2(
       missing,
@@ -104316,7 +104316,7 @@ function validateGooglePeriodReportContent(data) {
       "\u22651 \u6BB5\u6267\u884C\u6458\u8981\uFF0C\u6982\u8FF0\u672C\u671F\u6D88\u8017/\u8F6C\u5316/CTR/CPA \u8D70\u52BF"
     );
   }
-  const kpis = asRecord19(data.kpis);
+  const kpis = asRecord20(data.kpis);
   const hasCoreKpi = ["cost", "impressions", "clicks"].some(
     (key) => Number.isFinite(Number(kpis?.[key]))
   );
@@ -104332,7 +104332,7 @@ function validateGooglePeriodReportContent(data) {
   const sectionAnalysisCounts = {};
   const sectionSuggestionCounts = {};
   for (const key of SECTION_KEYS) {
-    const section = asRecord19(sections[key]);
+    const section = asRecord20(sections[key]);
     const analysis = asArray2(section?.analysis).filter((s) => textLen2(s) > 0);
     const suggestions = asArray2(section?.suggestions).filter((s) => textLen2(s) > 0);
     sectionAnalysisCounts[key] = analysis.length;
@@ -104358,7 +104358,7 @@ function validateGooglePeriodReportContent(data) {
   }
   const recommendations = asArray2(narrative.recommendations).filter((r) => {
     if (typeof r === "string") return textLen2(r) > 0;
-    const rec = asRecord19(r);
+    const rec = asRecord20(r);
     return textLen2(rec?.content) > 0;
   });
   if (recommendations.length < 3) {
@@ -104447,7 +104447,7 @@ async function readJsonFile3(filePath) {
     throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
   }
 }
-function asRecord20(value) {
+function asRecord21(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -104462,7 +104462,7 @@ function injectReportData2(html, payload) {
 }
 async function runGoogleAnalysisRender(opts) {
   const dataPath = path35.resolve(opts.dataFile);
-  let data = asRecord20(await readJsonFile3(dataPath));
+  let data = asRecord21(await readJsonFile3(dataPath));
   if (opts.snapshotDir?.trim()) {
     data = await mergeGoogleAnalysisSnapshotIntoReport(data, path35.resolve(opts.snapshotDir));
   }
@@ -133427,7 +133427,7 @@ function buildGoogleAdsDiagnosisCollectAgentHint(snapDir) {
     "Google Ads \u8BCA\u65AD collect \u5DF2\u5B8C\u6210\uFF08\u4EC5\u4E8B\u5B9E\u6570\u636E\uFF0C\u4E0D\u542B\u5EFA\u8BAE\u6027\u6587\u6848\uFF09\u3002",
     `1) Read ${dir}/${GOOGLE_ADS_DIAGNOSIS_DIGEST_BASENAME}\uFF1A\u5404 section \u7ED3\u6784\u3001\u884C\u6570\u3001\u5F85\u586B\u5B57\u6BB5\u6E05\u5355\u90FD\u5728\u91CC\u9762\uFF1B`,
     `2) ${dir}/${GOOGLE_ADS_DIAGNOSIS_REPORT_BASENAME} \u5DF2\u662F\u7EC8\u7A3F\u9AA8\u67B6\uFF08items \u4E8B\u5B9E\u884C\u5DF2\u586B\u597D\u3001\u53D9\u4E8B\u5B57\u6BB5\u7559\u7A7A\uFF09\uFF0C\u76F4\u63A5\u5728\u5B83\u4E0A\u9762\u586B\u7A7A\uFF1B`,
-    "3) Read references/report-templates/google-ads-diagnosis.md\uFF0C\u64B0\u5199\u5168\u90E8 analysis/suggestions\u3001diagnosisOverview\u3001summary\u3001accountInfo.businessModel/industry\u3001budgetCompetitiveness[].strategy\u3001newFeatures[].optimizerRecommendation\u3001adCreativeOptimization.items[].suggestion \u7B49\uFF1B",
+    "3) Read references/report-templates/google-ads-diagnosis.md\uFF0C\u64B0\u5199\u5168\u90E8 analysis/suggestions\u3001diagnosisOverview.advantages/disadvantages\uFF08\u6BCF\u6761 {title, description}\uFF0C\u7981\u6B62\u7EAF\u5B57\u7B26\u4E32\uFF09\u3001summary\u3001accountInfo.businessModel/industry\u3001budgetCompetitiveness[].strategy\u3001newFeatures[].optimizerRecommendation\u3001adCreativeOptimization.items[].suggestion \u7B49\uFF1B",
     `4) siluzan-tso google-ads-diagnosis render --data ${dir}/${GOOGLE_ADS_DIAGNOSIS_REPORT_BASENAME} --out ${dir}/google-ads-diagnosis-report.html\uFF08\u9ED8\u8BA4\u540C\u76EE\u5F55 collect \u81EA\u52A8\u6062\u590D\u88AB\u6539\u574F\u7684 items\uFF09\u3002`,
     `\u7981\u6B62\u7528 node -e \u9010\u6BB5 dump ${GOOGLE_ADS_DIAGNOSIS_COLLECT_BASENAME} \u6765\u6478\u7ED3\u6784\u2014\u2014\u7ED3\u6784\u770B digest\u3001\u6570\u5B57\u770B\u9AA8\u67B6\u6587\u4EF6\u5373\u53EF\u3002`,
     "\u7981\u6B62\u5199\u5165/\u8986\u76D6 campaigns/geographic/keywords \u7684 items \u884C\uFF0C\u53EA\u586B analysis/suggestions\u3002",
@@ -133494,7 +133494,7 @@ function buildGoogleAdsDiagnosisAgentBrief(input) {
     },
     agentDeliverable: {
       outputFile: "google-ads-diagnosis.json",
-      structure: "\u4E0E reportData \u540C\u7ED3\u6784\u7684 sectionData\uFF1B\u987B\u586B diagnosisOverview\u3001metrics.analysis/suggestions\u3001\u5404\u6A21\u5757 analysis/suggestions\u3001summary.keyIssues\u3001summary.optimizationRoadmap[]\uFF08priority/focusArea/actionItems/expectedOutcome\uFF09\u3001budgetCompetitiveness[].strategy\u3001newFeatures[].optimizerRecommendation \u7B49",
+      structure: "\u4E0E reportData \u540C\u7ED3\u6784\u7684 sectionData\uFF1B\u987B\u586B diagnosisOverview.advantages/disadvantages\uFF08\u6BCF\u6761 {title, description}\uFF09\u3001metrics.analysis/suggestions\u3001\u5404\u6A21\u5757 analysis/suggestions\u3001summary.keyIssues\u3001summary.optimizationRoadmap[]\uFF08priority/focusArea/actionItems/expectedOutcome\uFF09\u3001budgetCompetitiveness[].strategy\u3001newFeatures[].optimizerRecommendation \u7B49",
       thenRun: "siluzan-tso google-ads-diagnosis render --data ./<snap>/google-ads-diagnosis.json --out ./<snap>/google-ads-diagnosis-report.html"
     }
   };
@@ -134319,7 +134319,7 @@ function describeSectionShapes(reportData) {
 function narrativeChecklist(shapes) {
   const lines = [
     "- `accountInfo.businessModel`\u3001`accountInfo.industry`",
-    "- `diagnosisOverview.advantages`\u3001`diagnosisOverview.disadvantages`",
+    '- `diagnosisOverview.advantages`\u3001`diagnosisOverview.disadvantages`\uFF1A\u6BCF\u6761 `{"title":"\u77ED\u6807\u9898","description":"\u4F9D\u636E"}`\u3002\u7EAF\u5B57\u7B26\u4E32\u4F1A\u5728 render \u65F6\u6309\u7B2C\u4E00\u4E2A\u300C\uFF1A\u300D\u62C6\u5F00\uFF1B\u7F3A title \u6216 description \u5219\u62D2\u7EDD\u51FA HTML\uFF08\u5426\u5219\u9875\u9762\u663E\u793A\u300C\u672A\u586B\u5199\u300D\uFF09',
     "- `summary.keyIssues`\u3001`summary.optimizationRoadmap`"
   ];
   for (const shape of shapes) {
@@ -134720,6 +134720,26 @@ function validateNewFeatureRecommendations(data) {
   }
   return warnings;
 }
+function validateDiagnosisOverviewItems(data) {
+  const overview = asRecord10(data.diagnosisOverview);
+  if (!overview) return [];
+  const warnings = [];
+  for (const key of ["advantages", "disadvantages"]) {
+    const items3 = overview[key];
+    if (!Array.isArray(items3)) continue;
+    items3.forEach((item, index) => {
+      const row = asRecord10(item);
+      const title = String(row?.title ?? "").trim();
+      const description = String(row?.description ?? "").trim();
+      if (!title || !description) {
+        warnings.push(
+          `diagnosisOverview.${key}[${index}] \u987B\u542B\u975E\u7A7A title \u4E0E description\uFF08\u6A21\u677F\u53EA\u8BFB\u8FD9\u4E24\u4E2A\u5B57\u6BB5\uFF0C\u7F3A\u4E86\u4F1A\u663E\u793A\u300C\u672A\u586B\u5199\u300D\uFF09\u3002\u5199\u6210 {"title":"\u77ED\u6807\u9898","description":"\u4F9D\u636E"}\uFF0C\u6216\u300C\u6807\u9898\uFF1A\u8BF4\u660E\u300D`
+        );
+      }
+    });
+  }
+  return warnings;
+}
 function validateAdCreativeItemSuggestions(data) {
   const creative = asRecord10(data.adCreativeOptimization);
   if (!creative) return [];
@@ -134752,6 +134772,7 @@ function validateGoogleAdsDiagnosisContent(data) {
     }
   }
   warnings.push(
+    ...validateDiagnosisOverviewItems(data),
     ...validateBudgetCompetitivenessStrategies(data),
     ...validateNewFeatureRecommendations(data),
     ...validateAdCreativeItemSuggestions(data)
@@ -135063,8 +135084,75 @@ function getNarrativeConsistencyErrors(data) {
   return errors;
 }
 
-// src/commands/google-ads-diagnosis/render-report.ts
+// src/commands/google-ads-diagnosis/overview-items.ts
 function asRecord13(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return null;
+}
+function proseColonIndex(text2) {
+  const cn = text2.indexOf("\uFF1A");
+  if (cn > 0 && cn < text2.length - 1) return cn;
+  for (let i = 1; i < text2.length - 1; i++) {
+    if (text2[i] !== ":") continue;
+    if (text2[i + 1] === "/") continue;
+    const scheme = text2.slice(Math.max(0, i - 5), i);
+    if (/https?$/i.test(scheme)) continue;
+    return i;
+  }
+  return -1;
+}
+function splitOverviewProse(text2) {
+  const trimmed = text2.trim();
+  const cut = proseColonIndex(trimmed);
+  if (cut > 0) {
+    const title = trimmed.slice(0, cut).trim();
+    const description = trimmed.slice(cut + 1).trim();
+    if (title && description) return { title, description };
+  }
+  return { title: trimmed, description: trimmed };
+}
+function normalizeOverviewItem(item) {
+  if (typeof item === "string" || typeof item === "number") {
+    const text2 = String(item).trim();
+    if (!text2) return null;
+    return splitOverviewProse(text2);
+  }
+  const rec = asRecord13(item);
+  if (!rec) return null;
+  const title = String(rec.title ?? "").trim();
+  const description = String(rec.description ?? "").trim();
+  if (title && description) return { title, description };
+  const prose = title || description;
+  if (!prose) return null;
+  const split = splitOverviewProse(prose);
+  return {
+    title: title || split.title,
+    description: description || split.description
+  };
+}
+function normalizeDiagnosisOverview(data) {
+  const overview = asRecord13(data.diagnosisOverview);
+  if (!overview) return { data, coerced: [] };
+  const coerced = [];
+  const nextOverview = { ...overview };
+  for (const key of ["advantages", "disadvantages"]) {
+    const items3 = overview[key];
+    if (!Array.isArray(items3)) continue;
+    nextOverview[key] = items3.map((item) => {
+      if (typeof item === "string" || typeof item === "number") coerced.push(key);
+      return normalizeOverviewItem(item) ?? { title: "", description: "" };
+    });
+  }
+  return {
+    data: { ...data, diagnosisOverview: nextOverview },
+    coerced
+  };
+}
+
+// src/commands/google-ads-diagnosis/render-report.ts
+function asRecord14(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -135073,8 +135161,8 @@ function asRecord13(value) {
 async function tryLoadCollectReportData(collectPath) {
   try {
     const raw = JSON.parse(await fs22.readFile(collectPath, "utf8"));
-    const root = asRecord13(raw);
-    const reportData = asRecord13(root?.reportData);
+    const root = asRecord14(raw);
+    const reportData = asRecord14(root?.reportData);
     return reportData ?? root;
   } catch {
     return null;
@@ -135091,7 +135179,7 @@ async function runGoogleAdsDiagnosisRender(opts) {
 `);
     process.exit(1);
   }
-  let data = asRecord13(dataRaw);
+  let data = asRecord14(dataRaw);
   if (!opts.noMergeCollect) {
     const collectPath = path26.resolve(
       opts.collectFile ?? path26.join(path26.dirname(dataPath), GOOGLE_ADS_DIAGNOSIS_COLLECT_BASENAME)
@@ -135123,6 +135211,16 @@ async function runGoogleAdsDiagnosisRender(opts) {
       }
     }
   }
+  const overview = normalizeDiagnosisOverview(data);
+  data = overview.data;
+  if (overview.coerced.length > 0) {
+    const fields = [...new Set(overview.coerced)].join("\u3001");
+    console.log(
+      `
+\u2139\uFE0F  \u5DF2\u5C06 diagnosisOverview.${fields} \u7684\u7EAF\u5B57\u7B26\u4E32\u6309\u7B2C\u4E00\u4E2A\u5192\u53F7\u62C6\u6210 {title, description} \u518D\u6CE8\u5165 HTML\u3002
+`
+    );
+  }
   const narrativeErrors = getNarrativeConsistencyErrors(data);
   if (narrativeErrors.length > 0) {
     console.error("\n\u274C \u53D9\u4E8B\u6587\u6848\u4E0E\u4E8B\u5B9E\u5B57\u6BB5\u77DB\u76FE\uFF0C\u7981\u6B62\u6E32\u67D3\uFF1A\n");
@@ -136421,26 +136519,26 @@ import fs26 from "fs/promises";
 import path31 from "path";
 
 // src/commands/google-quarterly/report-content.ts
-function asRecord14(value) {
+function asRecord15(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
 function asStringArray(value) {
   return Array.isArray(value) ? value.map((x) => String(x).trim()).filter(Boolean) : [];
 }
 function validateQuarterlyNarrative(data) {
-  const root = asRecord14(data);
-  const narrative = asRecord14(root?.narrative);
+  const root = asRecord15(data);
+  const narrative = asRecord15(root?.narrative);
   const missing = [];
   if (!narrative) {
     return { ok: false, missing: ["narrative"] };
   }
   if (asStringArray(narrative.executiveSummary).length < 1) missing.push("narrative.executiveSummary");
-  const sections = asRecord14(narrative.sections);
+  const sections = asRecord15(narrative.sections);
   for (const key of ["efficiency", "adType", "region", "summary"]) {
-    const block = asRecord14(sections?.[key]);
+    const block = asRecord15(sections?.[key]);
     if (asStringArray(block?.analysis).length < 1) missing.push(`narrative.sections.${key}.analysis`);
   }
-  const plan = asRecord14(narrative.plan);
+  const plan = asRecord15(narrative.plan);
   if (asStringArray(plan?.analysis ?? plan?.goals).length < 1 && !String(plan?.text ?? "").trim()) {
     missing.push("narrative.plan");
   }
@@ -136453,8 +136551,8 @@ function mergeCollectFacts(agentData, collect) {
     ...facts,
     narrative: agentData.narrative ?? collect.narrative,
     meta: {
-      ...asRecord14(collect.meta) ?? {},
-      ...asRecord14(agentData.meta) ?? {}
+      ...asRecord15(collect.meta) ?? {},
+      ...asRecord15(agentData.meta) ?? {}
     }
   };
 }
@@ -136466,7 +136564,7 @@ import { fileURLToPath as fileURLToPath8 } from "url";
 var TSO_CLI_ROOT = path30.join(path30.dirname(fileURLToPath8(import.meta.url)), "../..");
 
 // src/commands/google-quarterly/render-report.ts
-function asRecord15(value) {
+function asRecord16(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -136495,7 +136593,7 @@ async function runGoogleQuarterlyRender(opts) {
 `);
     process.exit(1);
   }
-  const merged = mergeCollectFacts(asRecord15(agentRaw), asRecord15(collectRaw));
+  const merged = mergeCollectFacts(asRecord16(agentRaw), asRecord16(collectRaw));
   const check = validateQuarterlyNarrative(merged);
   if (!check.ok && !opts.lenient) {
     console.error("\n\u274C narrative \u4E0D\u5B8C\u6574\uFF0C\u62D2\u7EDD\u51FA HTML\uFF1A\n");
@@ -136659,7 +136757,7 @@ import * as fs33 from "fs/promises";
 import * as path40 from "path";
 
 // src/commands/facebook-analysis/report-metrics.ts
-function asRecord21(value) {
+function asRecord22(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -136796,7 +136894,7 @@ function localizeFacebookReportLabels(payload) {
   for (const rows of Object.values(tables)) {
     if (!Array.isArray(rows)) continue;
     for (const row of rows) {
-      localizeMetricLabels(asRecord21(row));
+      localizeMetricLabels(asRecord22(row));
     }
   }
   return payload;
@@ -136829,7 +136927,7 @@ async function readManifest3(snapshotDir) {
 async function loadSectionFile3(snapshotDir, file) {
   try {
     const raw = await fs33.readFile(path40.join(snapshotDir, file), "utf8");
-    return asRecord21(JSON.parse(raw));
+    return asRecord22(JSON.parse(raw));
   } catch {
     return null;
   }
@@ -136885,7 +136983,7 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
     if (data) sectionMap.set(art.section, data);
   }
   const overview = sectionMap.get("overview");
-  const current = asRecord21(overview?.currentPeriod);
+  const current = asRecord22(overview?.currentPeriod);
   const accountName = typeof overview?.accountName === "string" ? overview.accountName : void 0;
   const accountId = manifest.accountId ?? (typeof overview?.accountId === "string" ? overview.accountId : void 0);
   const kpis = { ...payload.kpis ?? {} };
@@ -137022,7 +137120,7 @@ function writeSimpleXlsx(filePath, sheets, opts = {}) {
 }
 
 // src/commands/facebook-analysis/render-excel.ts
-function asRecord22(value) {
+function asRecord23(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -137070,8 +137168,8 @@ function bullets(value) {
   return asArray3(value).map((item) => typeof item === "string" ? item.trim() : "").filter(Boolean);
 }
 function insightLines(section) {
-  const rec = asRecord22(section);
-  const insight = asRecord22(rec?.insight) ?? rec;
+  const rec = asRecord23(section);
+  const insight = asRecord23(rec?.insight) ?? rec;
   return [...bullets(insight?.analysis), ...bullets(insight?.advice)];
 }
 function numberedSection(index, title, lines) {
@@ -137080,15 +137178,15 @@ function numberedSection(index, title, lines) {
 ${body}`;
 }
 function buildSummaryNarrative(data) {
-  const kpis = asRecord22(data.kpis) ?? {};
-  const meta = asRecord22(data.meta) ?? {};
-  const sections = asRecord22(data.sections) ?? {};
+  const kpis = asRecord23(data.kpis) ?? {};
+  const meta = asRecord23(data.meta) ?? {};
+  const sections = asRecord23(data.sections) ?? {};
   const period = str2(meta.periodLabel) || `${str2(meta.startDate)} ~ ${str2(meta.endDate)}`.trim();
   const account = str2(meta.accountName) || "Facebook \u5E7F\u544A\u8D26\u6237";
   const campaign = str2(meta.campaignName);
   const resultLabel = displayResultType(kpis.resultType ?? meta.resultType) || "\u6210\u6548";
   const resultNoun = /潜在客户|lead/i.test(resultLabel) ? "\u4E2A\u6F5C\u5728\u5BA2\u6237\u8868\u5355" : `\u4E2A${resultLabel}`;
-  const firstQuestion = asRecord22(asArray3(data.fourQuestions)[0]);
+  const firstQuestion = asRecord23(asArray3(data.fourQuestions)[0]);
   const extra = str2(firstQuestion?.verdict);
   const spendLine = [
     campaign ? `\uFF08\u5E7F\u544A\u7CFB\u5217\uFF1A${campaign}\uFF09` : "",
@@ -137108,7 +137206,7 @@ function buildSummaryNarrative(data) {
     numberedSection(3, "\u5E7F\u544A\u9891\u6B21\u4E0E\u65E5\u8D8B\u52BF", insightLines(sections.daily))
   ].join("\n");
   const recBlocks = asArray3(data.recommendations).map((raw, i) => {
-    const rec = asRecord22(raw);
+    const rec = asRecord23(raw);
     if (!rec) return "";
     const title = [str2(rec.title), str2(rec.tag)].filter(Boolean).join(" \xB7 ");
     return numberedSection(i + 1, title || "\u4F18\u5316\u5EFA\u8BAE", bullets(rec.items));
@@ -137119,9 +137217,9 @@ function buildSummaryNarrative(data) {
   return [partOne, partTwo, partThree];
 }
 function buildMetaPeriodExcelSheets(data) {
-  const meta = asRecord22(data.meta) ?? {};
-  const kpis = asRecord22(data.kpis) ?? {};
-  const tables = asRecord22(data.tables) ?? {};
+  const meta = asRecord23(data.meta) ?? {};
+  const kpis = asRecord23(data.kpis) ?? {};
+  const tables = asRecord23(data.tables) ?? {};
   const currency = str2(meta.currency) || "USD";
   const resultType = displayResultType(kpis.resultType ?? meta.resultType);
   const attribution = displayAttribution(kpis.attributionSetting ?? meta.attributionSetting);
@@ -137140,19 +137238,19 @@ function buildMetaPeriodExcelSheets(data) {
   ];
   const dailyRows = [metricHeaders(currency, "\u5355\u65E5")];
   for (const raw of asArray3(tables.daily)) {
-    const row = asRecord22(raw);
+    const row = asRecord23(raw);
     if (!row) continue;
     dailyRows.push([normalizeInsightDate(row.date), ...metricCells(row)]);
   }
   const countryRows = [metricHeaders(currency, "\u56FD\u5BB6/\u5730\u533A")];
   for (const raw of asArray3(tables.countries)) {
-    const row = asRecord22(raw);
+    const row = asRecord23(raw);
     if (!row) continue;
     countryRows.push([str2(row.countryOrRegion), ...metricCells(row)]);
   }
   const campaignRows3 = [metricHeaders(currency, "\u5E7F\u544A\u7CFB\u5217\u540D\u79F0")];
   for (const raw of asArray3(tables.campaigns)) {
-    const row = asRecord22(raw);
+    const row = asRecord23(raw);
     if (!row) continue;
     campaignRows3.push([str2(row.campaignName), ...metricCells(row)]);
   }
@@ -137171,7 +137269,7 @@ function buildMetaPeriodExcelSheets(data) {
     ]
   ];
   for (const raw of asArray3(tables.audiences)) {
-    const row = asRecord22(raw);
+    const row = asRecord23(raw);
     if (!row) continue;
     audienceRows.push([str2(row.age), str2(row.gender), ...metricCells(row)]);
   }
@@ -137203,7 +137301,7 @@ function isFiniteNumber(value) {
 function asArray4(value) {
   return Array.isArray(value) ? value : [];
 }
-function asRecord23(value) {
+function asRecord24(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -137216,8 +137314,8 @@ function stringList3(value) {
   return asArray4(value).map((item) => typeof item === "string" ? item.trim() : "").filter(Boolean);
 }
 function insightLists(section) {
-  const rec = asRecord23(section);
-  const insight = asRecord23(rec?.insight) ?? rec;
+  const rec = asRecord24(section);
+  const insight = asRecord24(rec?.insight) ?? rec;
   return {
     analysis: stringList3(insight?.analysis),
     advice: stringList3(insight?.advice)
@@ -137247,11 +137345,11 @@ function requireInsight(missing, key, chapter, section, required) {
 }
 function validateMetaPeriodReportContent(data) {
   const missing = [];
-  const meta = asRecord23(data.meta) ?? {};
-  const kpis = asRecord23(data.kpis) ?? {};
-  const tables = asRecord23(data.tables) ?? {};
-  const charts = asRecord23(data.charts) ?? {};
-  const sections = asRecord23(data.sections) ?? {};
+  const meta = asRecord24(data.meta) ?? {};
+  const kpis = asRecord24(data.kpis) ?? {};
+  const tables = asRecord24(data.tables) ?? {};
+  const charts = asRecord24(data.charts) ?? {};
+  const sections = asRecord24(data.sections) ?? {};
   const fourQuestions = asArray4(data.fourQuestions);
   const recommendations = asArray4(data.recommendations);
   if (!textLen3(meta.accountName) && !textLen3(meta.accountId)) {
@@ -137330,7 +137428,7 @@ function validateMetaPeriodReportContent(data) {
       "\u987B\u6709 tables.audiences \u6570\u7EC4\uFF1B\u62C9\u6570\u52A0 --sections audience\uFF0Crender \u65F6\u4F20 --snapshot-dir\u3002\u672C\u671F\u65E0\u6D88\u8017\u53EF\u4E3A []"
     );
   }
-  const dailyChart = asRecord23(charts.daily);
+  const dailyChart = asRecord24(charts.daily);
   if (!Array.isArray(dailyChart?.labels)) {
     pushMissing3(
       missing,
@@ -137340,7 +137438,7 @@ function validateMetaPeriodReportContent(data) {
       "\u987B\u6709 charts.daily.labels \u6570\u7EC4\uFF1B\u53EF\u7531 --snapshot-dir \u5408\u5E76 daily\u3002\u672C\u671F\u65E0\u6D88\u8017\u53EF\u4E3A []"
     );
   }
-  const countryChart = asRecord23(charts.country);
+  const countryChart = asRecord24(charts.country);
   if (!Array.isArray(countryChart?.labels)) {
     pushMissing3(
       missing,
@@ -137350,7 +137448,7 @@ function validateMetaPeriodReportContent(data) {
       "\u987B\u6709 charts.country.labels \u6570\u7EC4\uFF1B\u53EF\u7531 --snapshot-dir \u5408\u5E76 country\u3002\u672C\u671F\u65E0\u6D88\u8017\u53EF\u4E3A []"
     );
   }
-  const audienceChart = asRecord23(charts.audience);
+  const audienceChart = asRecord24(charts.audience);
   if (!Array.isArray(audienceChart?.labels)) {
     pushMissing3(
       missing,
@@ -137369,7 +137467,7 @@ function validateMetaPeriodReportContent(data) {
       "\u5FC5\u987B\u6070\u597D 4 \u95EE\uFF1A\u94B1\u82B1\u5F97\u503C\u4E0D\u503C / \u8C01\u771F\u7684\u60F3\u4E70 / \u5E7F\u544A\u8FD8\u65B0\u9C9C\u5417 / \u7528\u6237\u4E3A\u4EC0\u4E48\u4E0D\u7559\u8D44"
     );
   } else {
-    const titles = fourQuestions.map((q) => asRecord23(q)?.title);
+    const titles = fourQuestions.map((q) => asRecord24(q)?.title);
     for (const title of FOUR_QUESTION_TITLES) {
       if (!titles.includes(title)) {
         pushMissing3(
@@ -137382,7 +137480,7 @@ function validateMetaPeriodReportContent(data) {
       }
     }
     for (let i = 0; i < fourQuestions.length; i++) {
-      const q = asRecord23(fourQuestions[i]);
+      const q = asRecord24(fourQuestions[i]);
       if (textLen3(q?.verdict) < 8) {
         pushMissing3(
           missing,
@@ -137422,7 +137520,7 @@ function validateMetaPeriodReportContent(data) {
     );
   } else {
     for (let i = 0; i < recommendations.length; i++) {
-      const rec = asRecord23(recommendations[i]);
+      const rec = asRecord24(recommendations[i]);
       if (textLen3(rec?.title) < 2) {
         pushMissing3(
           missing,
@@ -137515,7 +137613,7 @@ async function readJsonFile4(filePath) {
     throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
   }
 }
-function asRecord24(value) {
+function asRecord25(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -137544,7 +137642,7 @@ function defaultOutPath(dataPath, format, out) {
 }
 async function runFacebookAnalysisRender(opts) {
   const dataPath = path41.resolve(opts.dataFile);
-  let data = asRecord24(await readJsonFile4(dataPath));
+  let data = asRecord25(await readJsonFile4(dataPath));
   if (opts.snapshotDir?.trim()) {
     data = await mergeFacebookSnapshotIntoReport(data, path41.resolve(opts.snapshotDir));
   }
@@ -137608,7 +137706,7 @@ import { fileURLToPath as fileURLToPath11 } from "url";
 // src/commands/facebook-analysis/diagnosis-merge-snapshot.ts
 import * as fs35 from "fs/promises";
 import * as path42 from "path";
-function asRecord25(value) {
+function asRecord26(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -137619,7 +137717,7 @@ function num8(value) {
   return Number.isFinite(n) ? n : void 0;
 }
 function asRows(value) {
-  return Array.isArray(value) ? value.filter((r) => asRecord25(r) !== null) : [];
+  return Array.isArray(value) ? value.filter((r) => asRecord26(r) !== null) : [];
 }
 function pickMetricExtras(row, extras) {
   const out = {
@@ -137668,14 +137766,14 @@ async function readManifest4(snapshotDir, accountId) {
 async function loadSectionFile4(snapshotDir, file) {
   try {
     const raw = await fs35.readFile(path42.join(snapshotDir, file), "utf8");
-    return asRecord25(JSON.parse(raw));
+    return asRecord26(JSON.parse(raw));
   } catch {
     return null;
   }
 }
 async function mergeMetaDiagnosisSnapshotIntoReport(payload, snapshotDir) {
   const absDir = path42.resolve(snapshotDir);
-  const metaAccountId = typeof asRecord25(payload.meta)?.accountId === "string" ? asRecord25(payload.meta)?.accountId : void 0;
+  const metaAccountId = typeof asRecord26(payload.meta)?.accountId === "string" ? asRecord26(payload.meta)?.accountId : void 0;
   const manifest = await readManifest4(snapshotDir, metaAccountId);
   if (!manifest) {
     throw new Error(
@@ -137688,8 +137786,8 @@ async function mergeMetaDiagnosisSnapshotIntoReport(payload, snapshotDir) {
     if (data) sectionMap.set(art.section, data);
   }
   const overview = sectionMap.get("overview");
-  const currentPeriod = asRecord25(overview?.currentPeriod);
-  const previousPeriod = asRecord25(overview?.previousPeriod);
+  const currentPeriod = asRecord26(overview?.currentPeriod);
+  const previousPeriod = asRecord26(overview?.previousPeriod);
   const accountId = manifest.accountId ?? metaAccountId;
   const meta = { ...payload.meta ?? {} };
   if (!meta.accountId && accountId) meta.accountId = accountId;
@@ -137823,7 +137921,7 @@ function textLen4(value) {
 function asArray5(value) {
   return Array.isArray(value) ? value : [];
 }
-function asRecord26(value) {
+function asRecord27(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -137834,9 +137932,9 @@ function pushMissing4(missing, id, chapter, dimension, hint) {
 }
 function validateMetaDiagnosisReportContent(data) {
   const missing = [];
-  const meta = asRecord26(data.meta) ?? {};
-  const narrative = asRecord26(data.narrative) ?? {};
-  const sections = asRecord26(narrative.sections) ?? {};
+  const meta = asRecord27(data.meta) ?? {};
+  const narrative = asRecord27(data.narrative) ?? {};
+  const sections = asRecord27(narrative.sections) ?? {};
   if (!textLen4(meta.accountId)) {
     pushMissing4(missing, "meta-account", "\u5143\u4FE1\u606F", "\u8D26\u6237 ID", "meta.accountId \u5FC5\u586B");
   }
@@ -137854,7 +137952,7 @@ function validateMetaDiagnosisReportContent(data) {
   const sectionSuggestionCounts = {};
   const sectionNotAvailable = {};
   for (const key of NORMAL_SECTION_KEYS) {
-    const section = asRecord26(sections[key]);
+    const section = asRecord27(sections[key]);
     const analysis = asArray5(section?.analysis).filter((s) => textLen4(s) > 0);
     const suggestions = asArray5(section?.suggestions).filter((s) => textLen4(s) > 0);
     sectionAnalysisCounts[key] = analysis.length;
@@ -137880,7 +137978,7 @@ function validateMetaDiagnosisReportContent(data) {
     }
   }
   for (const key of NA_SECTION_KEYS) {
-    const section = asRecord26(sections[key]);
+    const section = asRecord27(sections[key]);
     const analysis = asArray5(section?.analysis).filter((s) => textLen4(s) > 0);
     const suggestions = asArray5(section?.suggestions).filter((s) => textLen4(s) > 0);
     const notAvailable = section?.notAvailable === true;
@@ -137902,7 +138000,7 @@ function validateMetaDiagnosisReportContent(data) {
   }
   const recommendations = asArray5(narrative.recommendations).filter((r) => {
     if (typeof r === "string") return textLen4(r) > 0;
-    const rec = asRecord26(r);
+    const rec = asRecord27(r);
     return textLen4(rec?.content) > 0;
   });
   if (recommendations.length < 3) {
@@ -137975,7 +138073,7 @@ async function readJsonFile5(filePath) {
     throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
   }
 }
-function asRecord27(value) {
+function asRecord28(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -137990,7 +138088,7 @@ function injectReportData4(html, payload) {
 }
 async function runFacebookAnalysisDiagnosisRender(opts) {
   const dataPath = path43.resolve(opts.dataFile);
-  let data = asRecord27(await readJsonFile5(dataPath));
+  let data = asRecord28(await readJsonFile5(dataPath));
   if (opts.snapshotDir?.trim()) {
     data = await mergeMetaDiagnosisSnapshotIntoReport(data, path43.resolve(opts.snapshotDir));
   }
@@ -138189,7 +138287,7 @@ function resolveFacebookPageSize(raw, fallback = FB_ENTITY_PAGE_SIZE_DEFAULT) {
   if (!Number.isFinite(n) || n <= 0) return fallback;
   return Math.min(Math.max(Math.floor(n), 1), FB_ENTITY_PAGE_SIZE_MAX);
 }
-function asRecord28(value) {
+function asRecord29(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
 function pickProp(obj, ...keys) {
@@ -138199,12 +138297,12 @@ function pickProp(obj, ...keys) {
   return void 0;
 }
 function unwrapFacebookPaged(raw) {
-  const rec = asRecord28(raw);
+  const rec = asRecord29(raw);
   if (!rec) return { items: [] };
   const data = pickProp(rec, "data", "Data");
   const items3 = Array.isArray(data) ? data : [];
-  const paging = asRecord28(pickProp(rec, "paging", "Paging"));
-  const cursors = paging ? asRecord28(pickProp(paging, "cursors", "Cursors")) : void 0;
+  const paging = asRecord29(pickProp(rec, "paging", "Paging"));
+  const cursors = paging ? asRecord29(pickProp(paging, "cursors", "Cursors")) : void 0;
   const afterRaw = cursors ? pickProp(cursors, "after", "After") : void 0;
   const after = typeof afterRaw === "string" && afterRaw.trim() ? afterRaw.trim() : void 0;
   return { items: items3, after };
@@ -138352,7 +138450,7 @@ async function fetchFacebookInsights(config, digits, level, opts) {
     opts.verbose
   );
   if (Array.isArray(raw)) return raw;
-  const rec = asRecord28(raw);
+  const rec = asRecord29(raw);
   const data = rec ? pickProp(rec, "data", "Data") : void 0;
   return Array.isArray(data) ? data : [];
 }
@@ -138361,7 +138459,7 @@ function sumActionArray(raw) {
   let sum = 0;
   let hit = false;
   for (const item of raw) {
-    const rec = asRecord28(item);
+    const rec = asRecord29(item);
     if (!rec) continue;
     const n = Number(rec.value);
     if (!Number.isFinite(n)) continue;
@@ -139640,7 +139738,7 @@ import { fileURLToPath as fileURLToPath12 } from "url";
 // src/commands/bing-analysis/merge-snapshot.ts
 import * as fs37 from "fs/promises";
 import * as path46 from "path";
-function asRecord29(value) {
+function asRecord30(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -139655,7 +139753,7 @@ function round27(value) {
 }
 function asRows2(value) {
   if (Array.isArray(value)) {
-    return value.filter((r) => asRecord29(r) !== null);
+    return value.filter((r) => asRecord30(r) !== null);
   }
   return [];
 }
@@ -139737,17 +139835,17 @@ function campaignStatusDisplay(status) {
   return status == null || status === "" ? "\u2014" : String(status);
 }
 function mapDeviceRows(payload) {
-  const obj = asRecord29(payload);
+  const obj = asRecord30(payload);
   return asRows2(obj?.devices).map((r) => pickMetrics(r, ["deviceType"]));
 }
 function mapGeographicRows(payload) {
-  const obj = asRecord29(payload);
+  const obj = asRecord30(payload);
   return asRows2(obj?.countries).map(
     (r) => pickMetrics(r, ["countryOrRegion", "countryCriteriaId", "regionName", "cityName"])
   );
 }
 function mapAudienceLabelRows(payload, labelKey) {
-  const obj = asRecord29(payload);
+  const obj = asRecord30(payload);
   return asRows2(obj?.audience).map((r) => {
     const m = pickMetrics(r, ["audience", "bidModifier"]);
     m[labelKey] = r.audience;
@@ -139755,7 +139853,7 @@ function mapAudienceLabelRows(payload, labelKey) {
   });
 }
 function mapAudienceFromMerged(payload) {
-  const data = asRecord29(asRecord29(payload)?.data);
+  const data = asRecord30(asRecord30(payload)?.data);
   return {
     audienceAge: mapAudienceLabelRows(data?.ageAudience, "ageRange"),
     audienceGender: mapAudienceLabelRows(data?.genderAudience, "gender")
@@ -139850,7 +139948,7 @@ function mapSearchTermRows(payload) {
 }
 async function mergeBingAnalysisSnapshotIntoReport(payload, snapshotDir) {
   const absDir = path46.resolve(snapshotDir);
-  const metaAccountId = typeof asRecord29(payload.meta)?.accountId === "string" ? asRecord29(payload.meta)?.accountId : void 0;
+  const metaAccountId = typeof asRecord30(payload.meta)?.accountId === "string" ? asRecord30(payload.meta)?.accountId : void 0;
   const manifest = await readManifest5(snapshotDir, metaAccountId);
   if (!manifest) {
     throw new Error(`\u672A\u5728 ${absDir} \u627E\u5230 report-manifest*.json\uFF0C\u8BF7\u5148\u6267\u884C bing-analysis --json-out`);
@@ -139860,9 +139958,9 @@ async function mergeBingAnalysisSnapshotIntoReport(payload, snapshotDir) {
     const data = await loadSectionPayload(absDir, art.file);
     if (data != null) sectionMap.set(art.section, data);
   }
-  const overview = asRecord29(sectionMap.get("overview"));
-  const currentPeriod = asRecord29(overview?.currentPeriod);
-  const previousPeriod = asRecord29(overview?.previousPeriod);
+  const overview = asRecord30(sectionMap.get("overview"));
+  const currentPeriod = asRecord30(overview?.currentPeriod);
+  const previousPeriod = asRecord30(overview?.previousPeriod);
   const accountId = manifest.accountId ?? metaAccountId;
   const campaignRows3 = mapCampaignRows2(sectionMap.get("campaigns"));
   const campaignKpis = sumBingCampaignRowsToPeriodKpis(campaignRows3);
@@ -139989,7 +140087,7 @@ function textLen5(value) {
 function asArray6(value) {
   return Array.isArray(value) ? value : [];
 }
-function asRecord30(value) {
+function asRecord31(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -140000,9 +140098,9 @@ function pushMissing5(missing, id, chapter, dimension, hint) {
 }
 function validateBingPeriodReportContent(data) {
   const missing = [];
-  const meta = asRecord30(data.meta) ?? {};
-  const narrative = asRecord30(data.narrative) ?? {};
-  const sections = asRecord30(narrative.sections) ?? {};
+  const meta = asRecord31(data.meta) ?? {};
+  const narrative = asRecord31(data.narrative) ?? {};
+  const sections = asRecord31(narrative.sections) ?? {};
   if (!textLen5(meta.accountId)) {
     pushMissing5(missing, "meta-account", "\u5143\u4FE1\u606F", "\u8D26\u6237 ID", "meta.accountId \u5FC5\u586B");
   }
@@ -140019,7 +140117,7 @@ function validateBingPeriodReportContent(data) {
   const sectionAnalysisCounts = {};
   const sectionSuggestionCounts = {};
   for (const key of SECTION_KEYS2) {
-    const section = asRecord30(sections[key]);
+    const section = asRecord31(sections[key]);
     const analysis = asArray6(section?.analysis).filter((s) => textLen5(s) > 0);
     const suggestions = asArray6(section?.suggestions).filter((s) => textLen5(s) > 0);
     sectionAnalysisCounts[key] = analysis.length;
@@ -140045,7 +140143,7 @@ function validateBingPeriodReportContent(data) {
   }
   const recommendations = asArray6(narrative.recommendations).filter((r) => {
     if (typeof r === "string") return textLen5(r) > 0;
-    const rec = asRecord30(r);
+    const rec = asRecord31(r);
     return textLen5(rec?.content) > 0;
   });
   if (recommendations.length < 3) {
@@ -140106,7 +140204,7 @@ async function readJsonFile6(filePath) {
     throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
   }
 }
-function asRecord31(value) {
+function asRecord32(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -140121,7 +140219,7 @@ function injectReportData5(html, payload) {
 }
 async function runBingAnalysisRender(opts) {
   const dataPath = path47.resolve(opts.dataFile);
-  let data = asRecord31(await readJsonFile6(dataPath));
+  let data = asRecord32(await readJsonFile6(dataPath));
   if (opts.snapshotDir?.trim()) {
     data = await mergeBingAnalysisSnapshotIntoReport(data, path47.resolve(opts.snapshotDir));
   }
@@ -140594,7 +140692,7 @@ import { fileURLToPath as fileURLToPath13 } from "url";
 // src/commands/tiktok-analysis/merge-snapshot.ts
 import * as fs39 from "fs/promises";
 import * as path49 from "path";
-function asRecord32(value) {
+function asRecord33(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -140772,7 +140870,7 @@ function mapAudienceMerged(payload) {
 }
 async function mergeTikTokAnalysisSnapshotIntoReport(payload, snapshotDir) {
   const absDir = path49.resolve(snapshotDir);
-  const metaAccountId = typeof asRecord32(payload.meta)?.accountId === "string" ? asRecord32(payload.meta)?.accountId : void 0;
+  const metaAccountId = typeof asRecord33(payload.meta)?.accountId === "string" ? asRecord33(payload.meta)?.accountId : void 0;
   const manifest = await readManifest6(snapshotDir, metaAccountId);
   if (!manifest) {
     throw new Error(
@@ -140886,7 +140984,7 @@ function textLen6(value) {
 function asArray7(value) {
   return Array.isArray(value) ? value : [];
 }
-function asRecord33(value) {
+function asRecord34(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -140897,9 +140995,9 @@ function pushMissing6(missing, id, chapter, dimension, hint) {
 }
 function validateTikTokPeriodReportContent(data) {
   const missing = [];
-  const meta = asRecord33(data.meta) ?? {};
-  const narrative = asRecord33(data.narrative) ?? {};
-  const sections = asRecord33(narrative.sections) ?? {};
+  const meta = asRecord34(data.meta) ?? {};
+  const narrative = asRecord34(data.narrative) ?? {};
+  const sections = asRecord34(narrative.sections) ?? {};
   if (!textLen6(meta.accountId)) {
     pushMissing6(missing, "meta-account", "\u5143\u4FE1\u606F", "\u8D26\u6237 ID", "meta.accountId \u5FC5\u586B");
   }
@@ -140916,7 +141014,7 @@ function validateTikTokPeriodReportContent(data) {
   const sectionAnalysisCounts = {};
   const sectionSuggestionCounts = {};
   for (const key of SECTION_KEYS3) {
-    const section = asRecord33(sections[key]);
+    const section = asRecord34(sections[key]);
     const analysis = asArray7(section?.analysis).filter((s) => textLen6(s) > 0);
     const suggestions = asArray7(section?.suggestions).filter((s) => textLen6(s) > 0);
     sectionAnalysisCounts[key] = analysis.length;
@@ -140942,7 +141040,7 @@ function validateTikTokPeriodReportContent(data) {
   }
   const recommendations = asArray7(narrative.recommendations).filter((r) => {
     if (typeof r === "string") return textLen6(r) > 0;
-    const rec = asRecord33(r);
+    const rec = asRecord34(r);
     return textLen6(rec?.content) > 0;
   });
   if (recommendations.length < 3) {
@@ -141003,7 +141101,7 @@ async function readJsonFile7(filePath) {
     throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
   }
 }
-function asRecord34(value) {
+function asRecord35(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -141018,7 +141116,7 @@ function injectReportData6(html, payload) {
 }
 async function runTikTokAnalysisRender(opts) {
   const dataPath = path50.resolve(opts.dataFile);
-  let data = asRecord34(await readJsonFile7(dataPath));
+  let data = asRecord35(await readJsonFile7(dataPath));
   if (opts.snapshotDir?.trim()) {
     data = await mergeTikTokAnalysisSnapshotIntoReport(data, path50.resolve(opts.snapshotDir));
   }
@@ -142117,7 +142215,7 @@ function endpointHintForYandexSection(def) {
 // src/commands/yandex-analysis/merge-snapshot.ts
 import * as fs41 from "fs/promises";
 import * as path51 from "path";
-function asRecord35(value) {
+function asRecord36(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -142137,11 +142235,11 @@ function normalizeYandexRoi(value) {
   return r === -1 ? void 0 : r;
 }
 function asItems(payload) {
-  const obj = asRecord35(payload);
+  const obj = asRecord36(payload);
   if (!obj) return [];
   const items3 = obj.items;
   if (!Array.isArray(items3)) return [];
-  return items3.filter((r) => asRecord35(r) !== null);
+  return items3.filter((r) => asRecord36(r) !== null);
 }
 function pickMetrics2(row, extras = []) {
   const spend = num12(row.spend) ?? 0;
@@ -142277,7 +142375,7 @@ function aggregateDailyToWeekly(dailyRows) {
   });
 }
 function prepareYandexDailyPayload(payload) {
-  const obj = asRecord35(payload) ?? {};
+  const obj = asRecord36(payload) ?? {};
   const items3 = asItems(obj).map((r) => {
     const date = normalizeYandexDailyDate(r.date);
     return date ? { ...r, date } : r;
@@ -142346,7 +142444,7 @@ function mapDeviceRows2(payload) {
 }
 async function mergeYandexAnalysisSnapshotIntoReport(payload, snapshotDir) {
   const absDir = path51.resolve(snapshotDir);
-  const metaAccountId = typeof asRecord35(payload.meta)?.accountId === "string" ? asRecord35(payload.meta)?.accountId : void 0;
+  const metaAccountId = typeof asRecord36(payload.meta)?.accountId === "string" ? asRecord36(payload.meta)?.accountId : void 0;
   const manifest = await readManifest7(snapshotDir, metaAccountId);
   if (!manifest) {
     throw new Error(
@@ -142358,8 +142456,8 @@ async function mergeYandexAnalysisSnapshotIntoReport(payload, snapshotDir) {
     const data = await loadSectionPayload3(absDir, art.file);
     if (data != null) sectionMap.set(art.section, data);
   }
-  const overview = asRecord35(sectionMap.get("overview"));
-  const totals = asRecord35(overview?.totals);
+  const overview = asRecord36(sectionMap.get("overview"));
+  const totals = asRecord36(overview?.totals);
   const accountId = manifest.accountId ?? metaAccountId;
   const meta = { ...payload.meta ?? {} };
   if (!meta.accountId && accountId) meta.accountId = accountId;
@@ -142581,7 +142679,7 @@ function textLen7(value) {
 function asArray8(value) {
   return Array.isArray(value) ? value : [];
 }
-function asRecord36(value) {
+function asRecord37(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -142594,23 +142692,23 @@ function normKey(value) {
   return String(value ?? "").trim().toLowerCase();
 }
 function insightMatchRecord(item) {
-  const rec = asRecord36(item);
+  const rec = asRecord37(item);
   if (!rec) return {};
-  return asRecord36(rec.match) ?? rec;
+  return asRecord37(rec.match) ?? rec;
 }
 function findRowInsight(list, primaryField, primaryValue, row) {
   const target = normKey(primaryValue);
   if (!target) return null;
   const candidates = list.filter((it) => normKey(insightMatchRecord(it)[primaryField]) === target);
-  if (candidates.length <= 1) return asRecord36(candidates[0]);
+  if (candidates.length <= 1) return asRecord37(candidates[0]);
   const campaign = normKey(row.campaignName);
   const narrowed = candidates.find(
     (it) => normKey(insightMatchRecord(it).campaignName) === campaign
   );
-  return asRecord36(narrowed ?? candidates[0]);
+  return asRecord37(narrowed ?? candidates[0]);
 }
 function topRowsBySpend(rows, limit) {
-  return rows.map((r) => asRecord36(r)).filter((r) => r != null).sort((a, b) => (Number(b.spend) || 0) - (Number(a.spend) || 0)).slice(0, limit);
+  return rows.map((r) => asRecord37(r)).filter((r) => r != null).sort((a, b) => (Number(b.spend) || 0) - (Number(a.spend) || 0)).slice(0, limit);
 }
 var ROW_INSIGHT_SPECS = [
   {
@@ -142625,17 +142723,17 @@ var ROW_INSIGHT_SPECS = [
 ];
 function validateYandexPeriodReportContent(data) {
   const missing = [];
-  const meta = asRecord36(data.meta) ?? {};
-  const narrative = asRecord36(data.narrative) ?? {};
-  const sections = asRecord36(narrative.sections) ?? {};
-  const kpis = asRecord36(data.kpis) ?? {};
+  const meta = asRecord37(data.meta) ?? {};
+  const narrative = asRecord37(data.narrative) ?? {};
+  const sections = asRecord37(narrative.sections) ?? {};
+  const kpis = asRecord37(data.kpis) ?? {};
   if (!textLen7(meta.accountId)) {
     pushMissing7(missing, "meta-account", "\u5143\u4FE1\u606F", "\u8D26\u6237 ID", "meta.accountId \u5FC5\u586B");
   }
   const sectionAnalysisCounts = {};
   const sectionSuggestionCounts = {};
   for (const key of SECTION_KEYS4) {
-    const section = asRecord36(sections[key]);
+    const section = asRecord37(sections[key]);
     const analysis = asArray8(section?.analysis).filter((s) => textLen7(s) > 0);
     const suggestions = asArray8(section?.suggestions).filter((s) => textLen7(s) > 0);
     sectionAnalysisCounts[key] = analysis.length;
@@ -142661,7 +142759,7 @@ function validateYandexPeriodReportContent(data) {
   }
   const recommendations = asArray8(narrative.recommendations).filter((r) => {
     if (typeof r === "string") return textLen7(r) > 0;
-    const rec = asRecord36(r);
+    const rec = asRecord37(r);
     return textLen7(rec?.content) > 0 || textLen7(rec?.text) > 0;
   });
   if (recommendations.length < 3) {
@@ -142683,8 +142781,8 @@ function validateYandexPeriodReportContent(data) {
       "\u81F3\u5C11\u4E00\u9879\u6709\u6548\u6570\u5B57\uFF08\u8BF7\u4F20 --snapshot-dir \u7531 CLI \u4ECE overview \u5408\u5E76\uFF09"
     );
   }
-  const tables = asRecord36(data.tables) ?? {};
-  const weeklyRows = asArray8(tables.weekly).map((r) => asRecord36(r)).filter((r) => r != null);
+  const tables = asRecord37(data.tables) ?? {};
+  const weeklyRows = asArray8(tables.weekly).map((r) => asRecord37(r)).filter((r) => r != null);
   for (const [i, row] of weeklyRows.entries()) {
     const label2 = `${row.weekLabel ?? ""} ${row.startDate ?? ""} ${row.endDate ?? ""}`;
     if (/nan/i.test(label2) || !normalizeYandexDailyDate(row.startDate) || !normalizeYandexDailyDate(row.endDate)) {
@@ -142697,7 +142795,7 @@ function validateYandexPeriodReportContent(data) {
       );
     }
   }
-  const rowInsights = asRecord36(narrative.rowInsights) ?? {};
+  const rowInsights = asRecord37(narrative.rowInsights) ?? {};
   const rowInsightCoverage = {};
   for (const spec of ROW_INSIGHT_SPECS) {
     const shown = topRowsBySpend(asArray8(tables[spec.tableKey]), spec.limit).filter(
@@ -142777,7 +142875,7 @@ async function readJsonFile8(filePath) {
     throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
   }
 }
-function asRecord37(value) {
+function asRecord38(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -142805,7 +142903,7 @@ function injectReportData7(html, payload) {
 }
 async function runYandexAnalysisRender(opts) {
   const dataPath = path53.resolve(opts.dataFile);
-  let data = asRecord37(await readJsonFile8(dataPath));
+  let data = asRecord38(await readJsonFile8(dataPath));
   if (opts.snapshotDir?.trim()) {
     data = await mergeYandexAnalysisSnapshotIntoReport(data, path53.resolve(opts.snapshotDir));
   }
@@ -143001,7 +143099,7 @@ function unwrapYandexItems(raw) {
   }
   return [];
 }
-function asRecord38(raw) {
+function asRecord39(raw) {
   return raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
 }
 
@@ -143080,7 +143178,7 @@ async function runYandexAccountStatus(opts) {
   } catch (err) {
     fail3("\u67E5\u8BE2 Yandex \u8D26\u6237\u603B\u89C8\u5931\u8D25", err);
   }
-  const row = asRecord38(result.raw);
+  const row = asRecord39(result.raw);
   await emitOrTable(opts, {
     section: "yandex-account-status",
     commandLabel: "yandex-analysis account-status",