aads-cli 1.0.0

package/dist/analysis/campaign-structure.js

@@ -0,0 +1,51 @@
+import { safeDivide } from "../core/normalizer.js";
+export const buildCampaignStructure = (records) => {
+    const campaigns = new Map();
+    for (const record of records) {
+        const campaignKey = record.campaignId || record.campaignName;
+        if (!campaignKey)
+            continue;
+        const campaign = campaigns.get(campaignKey) ??
+            {
+                campaignId: record.campaignId,
+                campaignName: record.campaignName,
+                adGroups: new Map(),
+            };
+        const adGroupKey = record.adGroupId || record.adGroupName || "__unknown__";
+        const adGroup = campaign.adGroups.get(adGroupKey) ??
+            {
+                adGroupId: record.adGroupId,
+                adGroupName: record.adGroupName,
+                keywordCount: 0,
+                productTargetCount: 0,
+                spend: 0,
+                sales: 0,
+            };
+        if (record.keywordText)
+            adGroup.keywordCount += 1;
+        if (record.productTargetingExpression)
+            adGroup.productTargetCount += 1;
+        adGroup.spend += record.spend;
+        adGroup.sales += record.sales;
+        campaign.adGroups.set(adGroupKey, adGroup);
+        campaigns.set(campaignKey, campaign);
+    }
+    return [...campaigns.values()]
+        .map((campaign) => ({
+        campaignId: campaign.campaignId,
+        campaignName: campaign.campaignName,
+        adGroups: [...campaign.adGroups.values()]
+            .map((adGroup) => ({
+            adGroupId: adGroup.adGroupId,
+            adGroupName: adGroup.adGroupName,
+            keywordCount: adGroup.keywordCount,
+            productTargetCount: adGroup.productTargetCount,
+            spend: adGroup.spend,
+            sales: adGroup.sales,
+            acos: safeDivide(adGroup.spend, adGroup.sales),
+        }))
+            .sort((a, b) => b.spend - a.spend),
+    }))
+        .sort((a, b) => a.campaignName.localeCompare(b.campaignName));
+};
+//# sourceMappingURL=campaign-structure.js.map

package/dist/analysis/campaign-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-structure.js","sourceRoot":"","sources":["../../src/analysis/campaign-structure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAiBnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAA2B,EAA2B,EAAE;IAC7F,MAAM,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEzD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,YAAY,CAAC;QAC7D,IAAI,CAAC,WAAW;YAAE,SAAS;QAE3B,MAAM,QAAQ,GACZ,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC;YACzB;gBACC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,QAAQ,EAAE,IAAI,GAAG,EAA8B;aACjB,CAAC;QAEnC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,WAAW,IAAI,aAAa,CAAC;QAC3E,MAAM,OAAO,GACX,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC;YAChC;gBACC,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,YAAY,EAAE,CAAC;gBACf,kBAAkB,EAAE,CAAC;gBACrB,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;aACqB,CAAC;QAElC,IAAI,MAAM,CAAC,WAAW;YAAE,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,0BAA0B;YAAE,OAAO,CAAC,kBAAkB,IAAI,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;QAC9B,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;QAE9B,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC3C,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;SAC3B,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;aACtC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACjB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;SAC/C,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;KACrC,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC"}

package/dist/analysis/cpc-optimizer.d.ts

@@ -0,0 +1,11 @@
+import type { CpcRecommendation, NormalizedRecord, SkuClassification } from "../pipeline/types.js";
+import type { SeoRankingData } from "../ranking/types.js";
+import type { OptimisationConfig } from "../config/optimisation-config.js";
+export interface CpcOptimizerOptions {
+    minClicks: number;
+    targetAcos: number;
+    seoRankingData?: SeoRankingData;
+    seoConfig?: OptimisationConfig["seo"];
+}
+export declare const generateCpcRecommendations: (records: NormalizedRecord[], skuClassifications: SkuClassification[], options: CpcOptimizerOptions) => CpcRecommendation[];
+//# sourceMappingURL=cpc-optimizer.d.ts.map

package/dist/analysis/cpc-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpc-optimizer.d.ts","sourceRoot":"","sources":["../../src/analysis/cpc-optimizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACnG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAI3E,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;CACvC;AAED,eAAO,MAAM,0BAA0B,GACrC,SAAS,gBAAgB,EAAE,EAC3B,oBAAoB,iBAAiB,EAAE,EACvC,SAAS,mBAAmB,KAC3B,iBAAiB,EA8CnB,CAAC"}

package/dist/analysis/cpc-optimizer.js

@@ -0,0 +1,46 @@
+import { normalizeMatchType, safeDivide } from "../core/normalizer.js";
+import { applySeoAdjustment } from "../ranking/seo-factor.js";
+export const generateCpcRecommendations = (records, skuClassifications, options) => {
+    const skuAdjust = new Map();
+    skuClassifications.forEach((item) => skuAdjust.set(item.sku, item.bidAdjust));
+    const result = [];
+    for (const record of records) {
+        if (!record.keywordText && !record.productTargetingExpression)
+            continue;
+        if (record.clicks < options.minClicks)
+            continue;
+        const avgCpc = safeDivide(record.spend, record.clicks);
+        const acos = safeDivide(record.spend, record.sales);
+        const acosFactor = acos > 0 ? options.targetAcos / acos : 1;
+        const skuFactor = skuAdjust.get(record.sku) ?? 1;
+        const currentBid = record.bid === "" ? avgCpc : Number(record.bid);
+        const recommendedBid = Math.max(1, Math.round(currentBid * acosFactor * skuFactor));
+        result.push({
+            campaignId: record.campaignId,
+            campaignName: record.campaignName,
+            adGroupId: record.adGroupId,
+            adGroupName: record.adGroupName,
+            keywordId: record.keywordId,
+            keywordText: record.keywordText || record.productTargetingExpression,
+            matchType: normalizeMatchType(record.matchType),
+            sku: record.sku,
+            clicks: record.clicks,
+            avgCpc,
+            currentBid,
+            recommendedBid,
+            bidAdjust: skuFactor,
+            reason: `targetAcos=${options.targetAcos.toFixed(2)} skuFactor=${skuFactor.toFixed(2)}`,
+        });
+    }
+    const sorted = result.sort((a, b) => b.clicks - a.clicks);
+    // Apply SEO adjustment if ranking data is available
+    if (options.seoRankingData && options.seoConfig?.enabled) {
+        return applySeoAdjustment(sorted, options.seoRankingData, {
+            enabled: options.seoConfig.enabled,
+            seoFactors: options.seoConfig.factors,
+            cpcCeiling: options.seoConfig.cpcCeiling,
+        });
+    }
+    return sorted;
+};
+//# sourceMappingURL=cpc-optimizer.js.map

package/dist/analysis/cpc-optimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpc-optimizer.js","sourceRoot":"","sources":["../../src/analysis/cpc-optimizer.ts"],"names":[],"mappings":"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"}

package/dist/analysis/performance-analyzer.d.ts

@@ -0,0 +1,3 @@
+import type { CampaignMetrics, NormalizedRecord } from "../pipeline/types.js";
+export declare const analyzePerformance: (records: NormalizedRecord[]) => CampaignMetrics[];
+//# sourceMappingURL=performance-analyzer.d.ts.map

package/dist/analysis/performance-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-analyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/performance-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAiB9E,eAAO,MAAM,kBAAkB,GAAI,SAAS,gBAAgB,EAAE,KAAG,eAAe,EA8D/E,CAAC"}

package/dist/analysis/performance-analyzer.js

@@ -0,0 +1,58 @@
+import { safeDivide } from "../core/normalizer.js";
+export const analyzePerformance = (records) => {
+    const campaigns = new Map();
+    for (const record of records) {
+        const key = record.campaignId || record.campaignName;
+        if (!key)
+            continue;
+        const current = campaigns.get(key) ??
+            {
+                campaignId: record.campaignId,
+                campaignName: record.campaignName,
+                targetingType: record.targetingType,
+                state: record.state,
+                clicks: 0,
+                impressions: 0,
+                spend: 0,
+                sales: 0,
+                orders: 0,
+                budget: 0,
+                budgetCount: 0,
+            };
+        current.clicks += record.clicks;
+        current.impressions += record.impressions;
+        current.spend += record.spend;
+        current.sales += record.sales;
+        current.orders += record.orders;
+        if (record.dailyBudget !== "") {
+            current.budget += record.dailyBudget;
+            current.budgetCount += 1;
+        }
+        campaigns.set(key, current);
+    }
+    return [...campaigns.values()]
+        .map((item) => {
+        const ctr = safeDivide(item.clicks, item.impressions);
+        const cvr = safeDivide(item.orders, item.clicks);
+        const acos = safeDivide(item.spend, item.sales);
+        const roas = safeDivide(item.sales, item.spend);
+        return {
+            campaignId: item.campaignId,
+            campaignName: item.campaignName,
+            targetingType: item.targetingType,
+            state: item.state,
+            clicks: item.clicks,
+            impressions: item.impressions,
+            spend: item.spend,
+            sales: item.sales,
+            orders: item.orders,
+            ctr,
+            cvr,
+            acos,
+            roas,
+            dailyBudget: item.budgetCount > 0 ? item.budget / item.budgetCount : "",
+        };
+    })
+        .sort((a, b) => b.sales - a.sales);
+};
+//# sourceMappingURL=performance-analyzer.js.map

package/dist/analysis/performance-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-analyzer.js","sourceRoot":"","sources":["../../src/analysis/performance-analyzer.ts"],"names":[],"mappings":"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"}

package/dist/analysis/sku-classifier.d.ts

@@ -0,0 +1,3 @@
+import type { NormalizedRecord, SkuClassification } from "../pipeline/types.js";
+export declare const classifySkus: (records: NormalizedRecord[]) => SkuClassification[];
+//# sourceMappingURL=sku-classifier.d.ts.map

package/dist/analysis/sku-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sku-classifier.d.ts","sourceRoot":"","sources":["../../src/analysis/sku-classifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA+DhF,eAAO,MAAM,YAAY,GAAI,SAAS,gBAAgB,EAAE,KAAG,iBAAiB,EAa3E,CAAC"}

package/dist/analysis/sku-classifier.js

@@ -0,0 +1,64 @@
+import { SKU_LABEL_RULES } from "../config/constants.js";
+import { safeDivide } from "../core/normalizer.js";
+const classifyOne = (sku, agg) => {
+    const cvr = safeDivide(agg.orders, agg.clicks);
+    const acos = safeDivide(agg.spend, agg.sales);
+    if (agg.clicks < 5) {
+        return {
+            sku,
+            label: "improve",
+            bidAdjust: SKU_LABEL_RULES.improve.bidAdjust,
+            budgetAdjust: SKU_LABEL_RULES.improve.budgetAdjust,
+            reason: "data-insufficient(clicks<5)",
+        };
+    }
+    if (acos <= SKU_LABEL_RULES.focus.maxAcos && cvr >= SKU_LABEL_RULES.focus.minCvr) {
+        return {
+            sku,
+            label: "focus",
+            bidAdjust: SKU_LABEL_RULES.focus.bidAdjust,
+            budgetAdjust: SKU_LABEL_RULES.focus.budgetAdjust,
+            reason: "high-performance",
+        };
+    }
+    if (acos <= SKU_LABEL_RULES.nurture.maxAcos && cvr >= SKU_LABEL_RULES.nurture.minCvr) {
+        return {
+            sku,
+            label: "nurture",
+            bidAdjust: SKU_LABEL_RULES.nurture.bidAdjust,
+            budgetAdjust: SKU_LABEL_RULES.nurture.budgetAdjust,
+            reason: "stable-growth",
+        };
+    }
+    if (acos > SKU_LABEL_RULES.prune.minAcos || cvr < SKU_LABEL_RULES.prune.maxCvr) {
+        return {
+            sku,
+            label: "prune",
+            bidAdjust: SKU_LABEL_RULES.prune.bidAdjust,
+            budgetAdjust: SKU_LABEL_RULES.prune.budgetAdjust,
+            reason: "low-efficiency",
+        };
+    }
+    return {
+        sku,
+        label: "improve",
+        bidAdjust: SKU_LABEL_RULES.improve.bidAdjust,
+        budgetAdjust: SKU_LABEL_RULES.improve.budgetAdjust,
+        reason: "default",
+    };
+};
+export const classifySkus = (records) => {
+    const bySku = new Map();
+    for (const record of records) {
+        if (!record.sku)
+            continue;
+        const prev = bySku.get(record.sku) ?? { clicks: 0, spend: 0, sales: 0, orders: 0 };
+        prev.clicks += record.clicks;
+        prev.spend += record.spend;
+        prev.sales += record.sales;
+        prev.orders += record.orders;
+        bySku.set(record.sku, prev);
+    }
+    return [...bySku.entries()].map(([sku, agg]) => classifyOne(sku, agg)).sort((a, b) => a.sku.localeCompare(b.sku));
+};
+//# sourceMappingURL=sku-classifier.js.map

package/dist/analysis/sku-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sku-classifier.js","sourceRoot":"","sources":["../../src/analysis/sku-classifier.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "dotenv/config";
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/cli.js

@@ -0,0 +1,351 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { Command } from "commander";
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { loadCampaignLayerPolicy } from "./config/campaign-layer-policy.js";
+import { loadOptimisationConfig } from "./config/optimisation-config.js";
+import { Logger } from "./utils/logger.js";
+import { runAnalyzePipeline } from "./pipeline/analyze-pipeline.js";
+import { writeXlsx } from "./io/excel-writer.js";
+import { timestampForFilename } from "./utils/date-utils.js";
+const logger = new Logger(process.env.LOG_LEVEL === "debug" ? "debug" : "info");
+const toPct = (value) => `${(value * 100).toFixed(2)}%`;
+const printLayerSummary = async (result, layerPolicyPath) => {
+    if (!result.layerClassification || result.layerClassification.length === 0)
+        return;
+    const policy = await loadCampaignLayerPolicy(layerPolicyPath);
+    if (!policy)
+        return;
+    const LAYER_ORDER = ["L0", "L1", "L2", "L3", "L4"];
+    const metricsMap = new Map(result.campaignMetrics.map((m) => [m.campaignName, m]));
+    const layerAgg = LAYER_ORDER.map((layerId) => {
+        const layer = policy.layers[layerId];
+        const classified = result.layerClassification.filter((c) => c.layer === layerId);
+        let totalSpend = 0;
+        let totalSales = 0;
+        let allPaused = true;
+        for (const c of classified) {
+            const m = metricsMap.get(c.campaignName);
+            if (m) {
+                totalSpend += m.spend;
+                totalSales += m.sales;
+                if (m.state !== "paused")
+                    allPaused = false;
+            }
+        }
+        const acos = totalSales > 0 ? totalSpend / totalSales : 0;
+        return {
+            layer: layerId,
+            name: layer.name,
+            campaigns: classified.length,
+            spend: totalSpend,
+            sales: totalSales,
+            acos,
+            paused: classified.length > 0 && allPaused,
+        };
+    });
+    const totalSpend = layerAgg.reduce((sum, l) => sum + l.spend, 0);
+    console.log("\nLayer Summary");
+    console.table(layerAgg.map((row) => ({
+        Layer: row.layer,
+        Name: row.name,
+        Campaigns: row.campaigns,
+        Spend: `¥${Math.round(row.spend).toLocaleString()}`,
+        Sales: `¥${Math.round(row.sales).toLocaleString()}`,
+        ACOS: row.sales > 0 ? toPct(row.acos) : "-",
+        "Budget%": totalSpend > 0 ? toPct(row.spend / totalSpend) : "-",
+        Note: row.paused ? "(paused)" : "",
+    })));
+    const lowConfidence = result.layerClassification.filter((c) => c.confidence === "low");
+    if (lowConfidence.length > 0) {
+        console.log(`\n⚠ ${lowConfidence.length} campaign(s) classified with low confidence (fallback):`);
+        for (const c of lowConfidence) {
+            console.log(`  - ${c.campaignName} → ${c.layer}`);
+        }
+    }
+};
+const toOutputFormat = (value, fallback = "console") => {
+    const raw = String(value ?? fallback)
+        .trim()
+        .toLowerCase();
+    if (raw === "console" || raw === "json" || raw === "markdown" || raw === "xlsx") {
+        return raw;
+    }
+    return fallback;
+};
+const writeTextFile = async (filePath, content) => {
+    const resolved = path.resolve(filePath);
+    await mkdir(path.dirname(resolved), { recursive: true });
+    await writeFile(resolved, content, "utf8");
+};
+const program = new Command();
+program
+    .name("aads")
+    .description("CLI tool for analyzing Amazon Ads Sponsored Products campaign performance")
+    .version("1.0.0");
+program
+    .command("analyze")
+    .description("Analyze bulk sheet KPIs (CTR, CVR, ACOS, ROAS)")
+    .requiredOption("--input <pattern>", "Input Excel/CSV path or wildcard pattern")
+    .option("--layer-policy <file>", "Campaign layer policy JSON path")
+    .action(async (options) => {
+    const config = loadOptimisationConfig();
+    const result = await runAnalyzePipeline(options.input, config, {
+        layerPolicyPath: options.layerPolicy,
+    });
+    const totals = result.records.reduce((acc, row) => {
+        acc.clicks += row.clicks;
+        acc.impressions += row.impressions;
+        acc.spend += row.spend;
+        acc.sales += row.sales;
+        acc.orders += row.orders;
+        return acc;
+    }, { clicks: 0, impressions: 0, spend: 0, sales: 0, orders: 0 });
+    logger.info("Analyze completed", {
+        files: result.input.length,
+        rows: result.records.length,
+        period: result.dateRange
+            ? `${result.dateRange.startDate} ~ ${result.dateRange.endDate} (${result.dateRange.days}d)`
+            : "unknown",
+        campaigns: result.campaignMetrics.length,
+        clicks: totals.clicks,
+        impressions: totals.impressions,
+        spend: totals.spend,
+        sales: totals.sales,
+        orders: totals.orders,
+        ctr: toPct(totals.impressions > 0 ? totals.clicks / totals.impressions : 0),
+        cvr: toPct(totals.clicks > 0 ? totals.orders / totals.clicks : 0),
+        acos: toPct(totals.sales > 0 ? totals.spend / totals.sales : 0),
+        roas: totals.spend > 0 ? (totals.sales / totals.spend).toFixed(2) : "0.00",
+    });
+});
+program
+    .command("summary")
+    .description("Campaign structure summary with layer-level aggregation")
+    .requiredOption("--input <pattern>", "Input Excel/CSV path or wildcard pattern")
+    .option("--layer-policy <file>", "Campaign layer policy JSON path")
+    .action(async (options) => {
+    const config = loadOptimisationConfig();
+    const result = await runAnalyzePipeline(options.input, config, {
+        layerPolicyPath: options.layerPolicy,
+    });
+    console.log("\nCampaign KPI Summary");
+    console.table(result.campaignMetrics.slice(0, 20).map((item) => ({
+        campaign: item.campaignName,
+        clicks: item.clicks,
+        spend: Math.round(item.spend),
+        sales: Math.round(item.sales),
+        acos: toPct(item.acos),
+        roas: item.roas.toFixed(2),
+    })));
+    console.log("\nStructure Summary");
+    console.table(result.structure.slice(0, 20).map((campaign) => ({
+        campaign: campaign.campaignName,
+        adGroups: campaign.adGroups.length,
+        keywords: campaign.adGroups.reduce((sum, g) => sum + g.keywordCount, 0),
+        productTargets: campaign.adGroups.reduce((sum, g) => sum + g.productTargetCount, 0),
+    })));
+    await printLayerSummary(result, options.layerPolicy);
+});
+program
+    .command("cpc-report")
+    .description("CPC bid optimization report with SEO ranking integration")
+    .requiredOption("--input <pattern>", "Input Excel/CSV path or wildcard pattern")
+    .requiredOption("--output <file>", "Output xlsx path")
+    .option("--ranking-db <path>", "A_rank SQLite DB path for SEO-based CPC adjustment")
+    .action(async (options) => {
+    const config = loadOptimisationConfig();
+    const analyzed = await runAnalyzePipeline(options.input, config, {
+        rankingDbPath: options.rankingDb,
+    });
+    const header = [
+        "Campaign",
+        "Ad Group",
+        "Keyword",
+        "Clicks(14d)",
+        "AvgCPC(14d)",
+        "CurrentBid",
+        "RecommendedBid",
+        "BidAdjust",
+        "OrganicPos",
+        "SeoFactor",
+        "Reason",
+    ];
+    const rows = analyzed.cpcRecommendations.map((item) => [
+        item.campaignName,
+        item.adGroupName,
+        item.keywordText,
+        item.clicks,
+        Math.round(item.avgCpc),
+        Math.round(item.currentBid),
+        item.recommendedBid,
+        item.bidAdjust.toFixed(2),
+        item.organicPosition != null ? `#${item.organicPosition}` : "-",
+        item.seoFactor != null ? item.seoFactor.toFixed(2) : "-",
+        item.reason,
+    ]);
+    await writeXlsx(options.output, [{ name: "CPC_Optimisation_Report", header, rows }]);
+    logger.info("CPC report completed", {
+        output: options.output,
+        rows: rows.length,
+        seoEnabled: Boolean(analyzed.seoRankingData),
+    });
+});
+program
+    .command("promotion-report")
+    .description("Auto-to-Manual promotion candidates and negative keyword suggestions")
+    .requiredOption("--input <pattern>", "Input Excel/CSV path or wildcard pattern")
+    .requiredOption("--output <file>", "Output xlsx path")
+    .action(async (options) => {
+    const config = loadOptimisationConfig();
+    const analyzed = await runAnalyzePipeline(options.input, config);
+    const promotionHeader = [
+        "Auto Campaign",
+        "Ad Group",
+        "Search Term",
+        "Clicks",
+        "Spend",
+        "CVR(%)",
+        "Suggested Match Type",
+        "Suggested Bid",
+        "Suggested Ad Group",
+    ];
+    const promotionRows = analyzed.promotionCandidates.map((item) => [
+        item.campaignName,
+        item.adGroupName,
+        item.keywordText,
+        item.clicks,
+        Math.round(item.spend),
+        (item.cvr * 100).toFixed(2),
+        item.matchType,
+        item.recommendedBid,
+        item.recommendedAdGroupName,
+    ]);
+    const negativeHeader = ["Campaign", "Ad Group", "Term", "MatchType", "Reason"];
+    const negativeRows = analyzed.negativeCandidates.map((item) => [
+        item.campaignName,
+        item.adGroupName,
+        item.keywordText,
+        item.matchType,
+        item.reason,
+    ]);
+    await writeXlsx(options.output, [
+        { name: "AutoToManual_Report", header: promotionHeader, rows: promotionRows },
+        { name: "Negative_Keyword_Optimisation", header: negativeHeader, rows: negativeRows },
+    ]);
+    logger.info("Promotion report completed", {
+        output: options.output,
+        promotionRows: promotionRows.length,
+        negativeRows: negativeRows.length,
+    });
+});
+program
+    .command("seo-report")
+    .description("SEO ranking vs ad keyword integrated report")
+    .requiredOption("--input <pattern>", "Input Excel/CSV path or wildcard pattern")
+    .requiredOption("--ranking-db <path>", "A_rank SQLite DB path")
+    .option("--output <file>", "Output xlsx path")
+    .option("--format <type>", "console | json | xlsx", "console")
+    .action(async (options) => {
+    const config = loadOptimisationConfig();
+    const analyzed = await runAnalyzePipeline(options.input, config, {
+        rankingDbPath: options.rankingDb,
+    });
+    if (!analyzed.seoRankingData) {
+        logger.error("No SEO ranking data available. Check --ranking-db path and SEO_ENABLED setting.");
+        process.exitCode = 1;
+        return;
+    }
+    const seoItems = analyzed.cpcRecommendations.map((rec) => ({
+        campaign: rec.campaignName,
+        adGroup: rec.adGroupName,
+        keyword: rec.keywordText,
+        clicks: rec.clicks,
+        avgCpc: Math.round(rec.avgCpc),
+        currentBid: Math.round(rec.currentBid),
+        recommendedBid: rec.recommendedBid,
+        organicPos: rec.organicPosition != null ? rec.organicPosition : null,
+        seoFactor: rec.seoFactor ?? 1.0,
+        reason: rec.reason,
+    }));
+    const format = toOutputFormat(options.format, "console");
+    if (format === "json") {
+        const content = JSON.stringify({
+            dbPath: analyzed.seoRankingData.dbPath,
+            snapshotDate: analyzed.seoRankingData.snapshotDate,
+            matchedKeywords: analyzed.seoRankingData.rankings.size,
+            items: seoItems,
+        }, null, 2);
+        if (options.output) {
+            await writeTextFile(options.output, content);
+            logger.info("SEO report JSON saved", { output: options.output });
+        }
+        else {
+            console.log(content);
+        }
+        return;
+    }
+    if (format === "xlsx" || (options.output && options.output.toLowerCase().endsWith(".xlsx"))) {
+        const outputPath = options.output ?? path.resolve("output", `seo-report-${timestampForFilename()}.xlsx`);
+        const header = [
+            "Campaign",
+            "Ad Group",
+            "Keyword",
+            "Clicks(14d)",
+            "AvgCPC",
+            "CurrentBid",
+            "RecommendedBid",
+            "OrganicPos",
+            "SeoFactor",
+            "Reason",
+        ];
+        const rows = seoItems.map((item) => [
+            item.campaign,
+            item.adGroup,
+            item.keyword,
+            item.clicks,
+            item.avgCpc,
+            item.currentBid,
+            item.recommendedBid,
+            item.organicPos != null ? item.organicPos : "-",
+            item.seoFactor.toFixed(2),
+            item.reason,
+        ]);
+        await writeXlsx(outputPath, [{ name: "SEO_Report", header, rows }]);
+        logger.info("SEO report generated", {
+            output: outputPath,
+            rows: rows.length,
+            matchedKeywords: analyzed.seoRankingData.rankings.size,
+        });
+        return;
+    }
+    // Console output
+    console.log("\nSEO Ranking Report");
+    console.log(`DB: ${analyzed.seoRankingData.dbPath}`);
+    console.log(`Snapshot: ${analyzed.seoRankingData.snapshotDate}`);
+    console.log(`Matched keywords: ${analyzed.seoRankingData.rankings.size}`);
+    console.log("");
+    const seoAdjusted = seoItems.filter((item) => item.seoFactor < 1.0);
+    if (seoAdjusted.length > 0) {
+        console.log("SEO-adjusted keywords:");
+        console.table(seoAdjusted.map((item) => ({
+            keyword: item.keyword,
+            organicPos: item.organicPos != null ? `#${item.organicPos}` : "-",
+            seoFactor: item.seoFactor.toFixed(2),
+            currentBid: item.currentBid,
+            recommendedBid: item.recommendedBid,
+        })));
+    }
+    else {
+        console.log("No keywords with SEO adjustment (all factors = 1.0)");
+    }
+    console.log(`\nTotal CPC recommendations: ${seoItems.length}`);
+    console.log(`SEO-adjusted: ${seoAdjusted.length}`);
+});
+program.parseAsync(process.argv).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error("Command failed", { error: message });
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map