aads-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yuuki-courage
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,159 @@
+# aads
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
+
+Amazon Ads スポンサープロダクト広告のパフォーマンス解析 CLI ツール。
+
+Amazon Ads のバルクシートエクスポート（Excel/CSV）を読み込み、CPC入札最適化レポート、Auto→Manual昇格候補、ネガティブキーワード提案、SEOランキング連携レポートを生成します。
+
+## 機能
+
+| コマンド | 説明 |
+|---------|------|
+| `analyze` | バルクシートからKPI（CTR, CVR, ACOS, ROAS）を集計 |
+| `summary` | キャンペーン構造サマリー + レイヤー別集計 |
+| `cpc-report` | CPC入札最適化レポート（SEOランキング連携対応） |
+| `promotion-report` | Auto→Manual昇格候補 + ネガティブキーワード提案 |
+| `seo-report` | SEOオーガニック順位 × 広告キーワード統合レポート |
+
+## インストール
+
+```bash
+npm install -g aads-cli
+```
+
+インストールせずに使う場合:
+
+```bash
+npx aads --help
+```
+
+## クイックスタート
+
+```bash
+# バルクシートを解析
+aads analyze --input "bulk-*.xlsx"
+
+# キャンペーン構造サマリーを表示
+aads summary --input "bulk-*.xlsx"
+
+# CPC最適化レポートを生成
+aads cpc-report --input "bulk-*.xlsx" --output cpc-report.xlsx
+
+# 昇格レポートを生成
+aads promotion-report --input "bulk-*.xlsx" --output promotion.xlsx
+
+# SEO統合レポートを生成
+aads seo-report --input "bulk-*.xlsx" --ranking-db ranking.db
+```
+
+## コマンド
+
+### `analyze`
+
+Amazon Ads バルクシートからキャンペーンKPIを集計します。
+
+```bash
+aads analyze --input <pattern> [--layer-policy <file>]
+```
+
+| オプション | 説明 |
+|-----------|------|
+| `--input <pattern>` | 入力Excel/CSVパスまたはワイルドカードパターン（必須） |
+| `--layer-policy <file>` | キャンペーンレイヤーポリシーJSONパス |
+
+### `summary`
+
+キャンペーン構造と広告グループの詳細、レイヤー分類を表示します。
+
+```bash
+aads summary --input <pattern> [--layer-policy <file>]
+```
+
+### `cpc-report`
+
+CPC入札最適化の推奨値をExcelレポートとして出力します。
+
+```bash
+aads cpc-report --input <pattern> --output <file> [--ranking-db <path>]
+```
+
+| オプション | 説明 |
+|-----------|------|
+| `--input <pattern>` | 入力Excel/CSVパスまたはワイルドカードパターン（必須） |
+| `--output <file>` | 出力xlsxパス（必須） |
+| `--ranking-db <path>` | SEO順位調整用のA_rank SQLite DBパス |
+
+### `promotion-report`
+
+Auto キャンペーンの検索語から Manual キャンペーンへの昇格候補を特定し、無駄な検索語にはネガティブキーワードを提案します。
+
+```bash
+aads promotion-report --input <pattern> --output <file>
+```
+
+### `seo-report`
+
+広告キーワードとオーガニックSEOランキングデータを照合し、オーガニック順位が強いキーワードの入札削減機会を特定します。
+
+```bash
+aads seo-report --input <pattern> --ranking-db <path> [--output <file>] [--format <type>]
+```
+
+| オプション | 説明 |
+|-----------|------|
+| `--input <pattern>` | 入力Excel/CSVパスまたはワイルドカードパターン（必須） |
+| `--ranking-db <path>` | A_rank SQLite DBパス（必須） |
+| `--output <file>` | 出力ファイルパス |
+| `--format <type>` | `console` \| `json` \| `xlsx`（デフォルト: `console`） |
+
+## 設定
+
+環境変数（または `.env` ファイル）で設定します:
+
+| 変数 | デフォルト | 説明 |
+|------|---------|------|
+| `TARGET_ACOS` | `0.25` | CPC最適化の目標ACOS |
+| `MIN_CLICKS_CPC` | `5` | CPC推奨の最小クリック数 |
+| `MIN_CLICKS_PROMOTION` | `5` | 昇格候補の最小クリック数 |
+| `MIN_CVR_PROMOTION` | `0.03` | 昇格候補の最小CVR |
+| `NEGATIVE_ACOS_THRESHOLD` | `0.4` | ネガティブキーワード提案のACOS閾値 |
+| `SEO_ENABLED` | `true` | SEOランキング連携を有効化 |
+| `SEO_CPC_CEILING` | `0` | CPC上限（0 = 自動） |
+| `RANKING_DB_PATH` | - | A_rank SQLite DBのデフォルトパス |
+| `LOG_LEVEL` | `info` | ログレベル（`debug` \| `info`） |
+
+テンプレートは [`.env.example`](.env.example) を参照してください。
+
+## SEO連携
+
+`cpc-report` と `seo-report` コマンドは、SQLiteデータベースに格納されたSEOランキングデータと連携できます（例: [A_rank](https://github.com/yuuki-courage/A_rank)）。
+
+広告キーワードのオーガニック順位が強い場合（1-4位）、推奨CPC入札額を自動的に削減します:
+
+| オーガニック順位 | SEO係数 | 入札削減率 |
+|---------------|---------|----------|
+| 1位 | 0.50 | -50% |
+| 2位 | 0.60 | -40% |
+| 3位 | 0.70 | -30% |
+| 4位 | 0.80 | -20% |
+| 5位以降 | 1.00 | 変更なし |
+
+## キャンペーンレイヤーポリシー
+
+`analyze` と `summary` コマンドは、JSONポリシーファイルによるキャンペーンレイヤー分類をサポートします:
+
+```bash
+aads summary --input "bulk-*.xlsx" --layer-policy data/campaign-layer-policy.json
+```
+
+デフォルトのポリシー構造は [`data/campaign-layer-policy.json`](data/campaign-layer-policy.json) を参照してください。
+
+## コントリビュート
+
+開発環境のセットアップとコントリビューションガイドラインは [CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。
+
+## ライセンス
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,159 @@
+# aads
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
+
+CLI tool for analyzing Amazon Ads Sponsored Products campaign performance.
+
+Reads Amazon Ads bulk sheet exports (Excel/CSV) and generates actionable optimization reports — CPC bid recommendations, auto-to-manual promotion candidates, negative keyword suggestions, and SEO ranking integration.
+
+## Features
+
+| Command | Description |
+|---------|-------------|
+| `analyze` | Aggregate KPIs (CTR, CVR, ACOS, ROAS) from bulk sheet data |
+| `summary` | Campaign structure overview with layer-level aggregation |
+| `cpc-report` | CPC bid optimization report with optional SEO ranking integration |
+| `promotion-report` | Auto-to-Manual promotion candidates + negative keyword suggestions |
+| `seo-report` | SEO organic ranking vs ad keyword integrated report |
+
+## Installation
+
+```bash
+npm install -g aads-cli
+```
+
+Or use without installing:
+
+```bash
+npx aads --help
+```
+
+## Quick Start
+
+```bash
+# Analyze a bulk sheet export
+aads analyze --input "bulk-*.xlsx"
+
+# Generate campaign structure summary
+aads summary --input "bulk-*.xlsx"
+
+# Generate CPC optimization report
+aads cpc-report --input "bulk-*.xlsx" --output cpc-report.xlsx
+
+# Generate promotion report
+aads promotion-report --input "bulk-*.xlsx" --output promotion.xlsx
+
+# Generate SEO-integrated report
+aads seo-report --input "bulk-*.xlsx" --ranking-db ranking.db
+```
+
+## Commands
+
+### `analyze`
+
+Aggregates campaign KPIs from Amazon Ads bulk sheet exports.
+
+```bash
+aads analyze --input <pattern> [--layer-policy <file>]
+```
+
+| Option | Description |
+|--------|-------------|
+| `--input <pattern>` | Input Excel/CSV path or wildcard pattern (required) |
+| `--layer-policy <file>` | Campaign layer policy JSON path |
+
+### `summary`
+
+Displays campaign structure with ad group details and layer classification.
+
+```bash
+aads summary --input <pattern> [--layer-policy <file>]
+```
+
+### `cpc-report`
+
+Generates CPC bid optimization recommendations as an Excel report.
+
+```bash
+aads cpc-report --input <pattern> --output <file> [--ranking-db <path>]
+```
+
+| Option | Description |
+|--------|-------------|
+| `--input <pattern>` | Input Excel/CSV path or wildcard pattern (required) |
+| `--output <file>` | Output xlsx path (required) |
+| `--ranking-db <path>` | A_rank SQLite DB path for SEO-based CPC adjustment |
+
+### `promotion-report`
+
+Identifies auto campaign search terms ready for manual campaign promotion and suggests negative keywords for wasteful terms.
+
+```bash
+aads promotion-report --input <pattern> --output <file>
+```
+
+### `seo-report`
+
+Cross-references ad keywords with organic SEO ranking data to identify opportunities for bid reduction where organic rankings are strong.
+
+```bash
+aads seo-report --input <pattern> --ranking-db <path> [--output <file>] [--format <type>]
+```
+
+| Option | Description |
+|--------|-------------|
+| `--input <pattern>` | Input Excel/CSV path or wildcard pattern (required) |
+| `--ranking-db <path>` | A_rank SQLite DB path (required) |
+| `--output <file>` | Output file path |
+| `--format <type>` | `console` \| `json` \| `xlsx` (default: `console`) |
+
+## Configuration
+
+Configuration is done via environment variables (or a `.env` file):
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `TARGET_ACOS` | `0.25` | Target ACOS for CPC optimization |
+| `MIN_CLICKS_CPC` | `5` | Minimum clicks for CPC recommendation |
+| `MIN_CLICKS_PROMOTION` | `5` | Minimum clicks for promotion candidate |
+| `MIN_CVR_PROMOTION` | `0.03` | Minimum CVR for promotion candidate |
+| `NEGATIVE_ACOS_THRESHOLD` | `0.4` | ACOS threshold for negative keyword suggestion |
+| `SEO_ENABLED` | `true` | Enable SEO ranking integration |
+| `SEO_CPC_CEILING` | `0` | CPC ceiling (0 = auto) |
+| `RANKING_DB_PATH` | - | Default path to A_rank SQLite DB |
+| `LOG_LEVEL` | `info` | Log level (`debug` \| `info`) |
+
+See [`.env.example`](.env.example) for a complete template.
+
+## SEO Integration
+
+The `cpc-report` and `seo-report` commands can integrate with SEO ranking data stored in a SQLite database (e.g., from [A_rank](https://github.com/yuuki-courage/A_rank)).
+
+When an ad keyword has strong organic ranking (positions 1-4), the tool automatically reduces the recommended CPC bid:
+
+| Organic Position | SEO Factor | Bid Reduction |
+|-----------------|------------|---------------|
+| #1 | 0.50 | -50% |
+| #2 | 0.60 | -40% |
+| #3 | 0.70 | -30% |
+| #4 | 0.80 | -20% |
+| #5+ | 1.00 | No change |
+
+## Campaign Layer Policy
+
+The `analyze` and `summary` commands support campaign layer classification using a JSON policy file:
+
+```bash
+aads summary --input "bulk-*.xlsx" --layer-policy data/campaign-layer-policy.json
+```
+
+See [`data/campaign-layer-policy.json`](data/campaign-layer-policy.json) for the default policy structure.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and contribution guidelines.
+
+## License
+
+[MIT](LICENSE)

package/data/campaign-layer-policy.json

@@ -0,0 +1,68 @@
+{
+  "version": "1.0",
+  "layers": {
+    "L0": {
+      "name": "DEF",
+      "nameJa": "防衛",
+      "purpose": "指名流入の取りこぼし防止",
+      "alwaysOn": true,
+      "budgetSharePct": 0.05,
+      "campaignPrefix": "SP_DEF_",
+      "targetAcos": 0.10
+    },
+    "L1": {
+      "name": "CORE",
+      "nameJa": "恒常主力",
+      "purpose": "安定売上・事業の軸",
+      "alwaysOn": true,
+      "budgetSharePct": 0.55,
+      "campaignPrefix": "SP_CORE_",
+      "targetAcos": 0.15
+    },
+    "L2": {
+      "name": "EXP",
+      "nameJa": "探索",
+      "purpose": "育成・昇格候補の蓄積",
+      "alwaysOn": true,
+      "budgetSharePct": 0.25,
+      "campaignPrefix": "SP_EXP_",
+      "targetAcos": 0.25
+    },
+    "L3": {
+      "name": "EVT",
+      "nameJa": "セール専用",
+      "purpose": "セール時の最大化",
+      "alwaysOn": false,
+      "budgetSharePct": 0.10,
+      "campaignPrefix": "SP_EVT_",
+      "targetAcos": 0.20
+    },
+    "L4": {
+      "name": "AUTO",
+      "nameJa": "オート",
+      "purpose": "新規発見＋既存性能維持",
+      "alwaysOn": true,
+      "budgetSharePct": 0.05,
+      "campaignPrefix": "SP_AUTO_",
+      "targetAcos": 0.30
+    }
+  },
+  "namingPatterns": [
+    { "pattern": "^SP_DEF_", "layer": "L0" },
+    { "pattern": "^SP_CORE_", "layer": "L1" },
+    { "pattern": "^SP_EXP_", "layer": "L2" },
+    { "pattern": "^SP_EVT_", "layer": "L3" },
+    { "pattern": "^SP_AUTO_", "layer": "L4" }
+  ],
+  "fallbackClassification": {
+    "auto": "L4",
+    "manual-exact": "L1",
+    "manual-phrase": "L2",
+    "manual-broad": "L2"
+  },
+  "promotionRules": [
+    { "from": "L4", "to": "L2", "description": "Auto→EXP: clicks>=5 AND orders>=1" },
+    { "from": "L2", "to": "L1", "description": "EXP→CORE: (CVR>=20% OR orders>=2) AND ACOS<=15%" },
+    { "from": "L2", "to": "L3", "description": "EXP→EVT: セール期間中にCVR改善" }
+  ]
+}

package/dist/analysis/anomaly-detection.d.ts

@@ -0,0 +1,16 @@
+import type { NormalizedRecord } from "../pipeline/types.js";
+export interface AnomalyThresholds {
+    impressionThreshold: number;
+    spendThreshold: number;
+    cpcThreshold: number;
+}
+export interface CampaignAnomaly {
+    campaignId: string;
+    campaignName: string;
+    anomalyTypes: string[];
+    impressionChangePct: number;
+    spendChangePct: number;
+    cpcChangePct: number;
+}
+export declare const detectAnomalies: (current: NormalizedRecord[], baseline: NormalizedRecord[], thresholds: AnomalyThresholds) => CampaignAnomaly[];
+//# sourceMappingURL=anomaly-detection.d.ts.map

package/dist/analysis/anomaly-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly-detection.d.ts","sourceRoot":"","sources":["../../src/analysis/anomaly-detection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AA8BD,eAAO,MAAM,eAAe,GAC1B,SAAS,gBAAgB,EAAE,EAC3B,UAAU,gBAAgB,EAAE,EAC5B,YAAY,iBAAiB,KAC5B,eAAe,EAkCjB,CAAC"}

package/dist/analysis/anomaly-detection.js

@@ -0,0 +1,55 @@
+import { safeDivide } from "../core/normalizer.js";
+const aggregateByCampaign = (records) => {
+    const map = new Map();
+    for (const record of records) {
+        const key = record.campaignId || record.campaignName;
+        if (!key)
+            continue;
+        const agg = map.get(key) ?? {
+            campaignId: record.campaignId,
+            campaignName: record.campaignName,
+            impressions: 0,
+            clicks: 0,
+            spend: 0,
+        };
+        agg.impressions += record.impressions;
+        agg.clicks += record.clicks;
+        agg.spend += record.spend;
+        map.set(key, agg);
+    }
+    return map;
+};
+export const detectAnomalies = (current, baseline, thresholds) => {
+    const currentMap = aggregateByCampaign(current);
+    const baselineMap = aggregateByCampaign(baseline);
+    const anomalies = [];
+    for (const [key, currentAgg] of currentMap.entries()) {
+        const base = baselineMap.get(key);
+        if (!base)
+            continue;
+        const currentCpc = safeDivide(currentAgg.spend, currentAgg.clicks);
+        const baselineCpc = safeDivide(base.spend, base.clicks);
+        const impressionChange = safeDivide(currentAgg.impressions - base.impressions, Math.max(base.impressions, 1));
+        const spendChange = safeDivide(currentAgg.spend - base.spend, Math.max(base.spend, 1));
+        const cpcChange = safeDivide(currentCpc - baselineCpc, Math.max(baselineCpc, 1e-9));
+        const types = [];
+        if (impressionChange > thresholds.impressionThreshold)
+            types.push(`impressions+${Math.round(impressionChange * 100)}%`);
+        if (spendChange > thresholds.spendThreshold)
+            types.push(`spend+${Math.round(spendChange * 100)}%`);
+        if (cpcChange > thresholds.cpcThreshold)
+            types.push(`cpc+${Math.round(cpcChange * 100)}%`);
+        if (types.length > 0) {
+            anomalies.push({
+                campaignId: currentAgg.campaignId,
+                campaignName: currentAgg.campaignName,
+                anomalyTypes: types,
+                impressionChangePct: impressionChange * 100,
+                spendChangePct: spendChange * 100,
+                cpcChangePct: cpcChange * 100,
+            });
+        }
+    }
+    return anomalies.sort((a, b) => b.spendChangePct - a.spendChangePct);
+};
+//# sourceMappingURL=anomaly-detection.js.map

package/dist/analysis/anomaly-detection.js.map

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

package/dist/analysis/auto-to-manual.d.ts

@@ -0,0 +1,11 @@
+import type { NegativeCandidate, NormalizedRecord, PromotionCandidate } from "../pipeline/types.js";
+export interface AutoToManualOptions {
+    minClicks: number;
+    minCvr: number;
+    negativeAcosThreshold: number;
+}
+export declare const analyzeAutoToManual: (records: NormalizedRecord[], options: AutoToManualOptions) => {
+    promotionCandidates: PromotionCandidate[];
+    negativeCandidates: NegativeCandidate[];
+};
+//# sourceMappingURL=auto-to-manual.d.ts.map

package/dist/analysis/auto-to-manual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-to-manual.d.ts","sourceRoot":"","sources":["../../src/analysis/auto-to-manual.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGpG,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAQD,eAAO,MAAM,mBAAmB,GAC9B,SAAS,gBAAgB,EAAE,EAC3B,SAAS,mBAAmB,KAC3B;IAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAAA;CAqDtF,CAAC"}

package/dist/analysis/auto-to-manual.js

@@ -0,0 +1,57 @@
+import { normalizeMatchType, safeDivide } from "../core/normalizer.js";
+const buildRecommendedAdGroupName = (adGroupName, matchType) => {
+    const suffix = normalizeMatchType(matchType).includes("exact") ? "manual-exact" : "manual-phrase";
+    const base = adGroupName || "adgroup";
+    return `${base}-${suffix}`.replace(/\s+/g, "-");
+};
+export const analyzeAutoToManual = (records, options) => {
+    const promotionCandidates = [];
+    const negativeCandidates = [];
+    for (const record of records) {
+        const isAuto = /auto/i.test(record.targetingType || "");
+        if (!isAuto)
+            continue;
+        // Auto: use customerSearchTerm (カスタマー検索用語), Manual: use keywordText (キーワードテキスト)
+        const term = isAuto ? record.customerSearchTerm : record.keywordText;
+        if (!term)
+            continue;
+        const cvr = safeDivide(record.orders, record.clicks);
+        const acos = safeDivide(record.spend, record.sales);
+        const avgCpc = safeDivide(record.spend, record.clicks);
+        const recommendedBid = Math.max(1, Math.round((record.bid === "" ? avgCpc : Number(record.bid)) * 1.05));
+        if (record.clicks >= options.minClicks && (record.orders > 0 || cvr >= options.minCvr)) {
+            promotionCandidates.push({
+                campaignId: record.campaignId,
+                campaignName: record.campaignName,
+                adGroupId: record.adGroupId,
+                adGroupName: record.adGroupName,
+                keywordText: term,
+                matchType: normalizeMatchType(record.matchType || "exact"),
+                sku: record.sku,
+                clicks: record.clicks,
+                spend: record.spend,
+                orders: record.orders,
+                cvr,
+                avgCpc,
+                recommendedBid,
+                recommendedAdGroupName: buildRecommendedAdGroupName(record.adGroupName, record.matchType),
+            });
+        }
+        if (record.clicks >= options.minClicks && record.orders === 0 && acos >= options.negativeAcosThreshold) {
+            negativeCandidates.push({
+                campaignId: record.campaignId,
+                campaignName: record.campaignName,
+                adGroupId: record.adGroupId,
+                adGroupName: record.adGroupName,
+                keywordText: term,
+                matchType: "negative phrase",
+                reason: `high_acos(${acos.toFixed(2)})`,
+            });
+        }
+    }
+    return {
+        promotionCandidates: promotionCandidates.sort((a, b) => b.clicks - a.clicks),
+        negativeCandidates: negativeCandidates.sort((a, b) => b.keywordText.localeCompare(a.keywordText)),
+    };
+};
+//# sourceMappingURL=auto-to-manual.js.map

package/dist/analysis/auto-to-manual.js.map

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

package/dist/analysis/campaign-layer-classifier.d.ts

@@ -0,0 +1,10 @@
+import type { CampaignLayerId, CampaignLayerPolicy } from "../config/campaign-layer-policy.js";
+import type { CampaignMetrics } from "../pipeline/types.js";
+export interface CampaignLayerClassification {
+    campaignName: string;
+    layer: CampaignLayerId;
+    confidence: "high" | "medium" | "low";
+    matchedBy: "naming" | "targeting" | "fallback";
+}
+export declare const classifyCampaignLayers: (metrics: CampaignMetrics[], policy: CampaignLayerPolicy) => CampaignLayerClassification[];
+//# sourceMappingURL=campaign-layer-classifier.d.ts.map

package/dist/analysis/campaign-layer-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-layer-classifier.d.ts","sourceRoot":"","sources":["../../src/analysis/campaign-layer-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,SAAS,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;CAChD;AAID,eAAO,MAAM,sBAAsB,GACjC,SAAS,eAAe,EAAE,EAC1B,QAAQ,mBAAmB,KAC1B,2BAA2B,EAkD7B,CAAC"}

package/dist/analysis/campaign-layer-classifier.js

@@ -0,0 +1,50 @@
+const DEFAULT_FALLBACK_LAYER = "L2";
+export const classifyCampaignLayers = (metrics, policy) => {
+    const compiledPatterns = policy.namingPatterns.map((np) => ({
+        regex: new RegExp(np.pattern),
+        layer: np.layer,
+    }));
+    return metrics.map((campaign) => {
+        // 1. Match by campaign name prefix
+        for (const { regex, layer } of compiledPatterns) {
+            if (regex.test(campaign.campaignName)) {
+                return {
+                    campaignName: campaign.campaignName,
+                    layer,
+                    confidence: "high",
+                    matchedBy: "naming",
+                };
+            }
+        }
+        // 2. Fallback by targeting type
+        const targetingType = campaign.targetingType.toLowerCase();
+        if (targetingType === "auto" && policy.fallbackClassification.auto) {
+            return {
+                campaignName: campaign.campaignName,
+                layer: policy.fallbackClassification.auto,
+                confidence: "medium",
+                matchedBy: "targeting",
+            };
+        }
+        if (targetingType === "manual") {
+            // Cannot determine exact/phrase/broad at campaign level, use generic manual fallback
+            const fallbackKey = "manual-exact";
+            if (policy.fallbackClassification[fallbackKey]) {
+                return {
+                    campaignName: campaign.campaignName,
+                    layer: policy.fallbackClassification[fallbackKey],
+                    confidence: "medium",
+                    matchedBy: "targeting",
+                };
+            }
+        }
+        // 3. Default fallback
+        return {
+            campaignName: campaign.campaignName,
+            layer: DEFAULT_FALLBACK_LAYER,
+            confidence: "low",
+            matchedBy: "fallback",
+        };
+    });
+};
+//# sourceMappingURL=campaign-layer-classifier.js.map

package/dist/analysis/campaign-layer-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-layer-classifier.js","sourceRoot":"","sources":["../../src/analysis/campaign-layer-classifier.ts"],"names":[],"mappings":"AAUA,MAAM,sBAAsB,GAAoB,IAAI,CAAC;AAErD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAA0B,EAC1B,MAA2B,EACI,EAAE;IACjC,MAAM,gBAAgB,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1D,KAAK,EAAE,IAAI,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC;QAC7B,KAAK,EAAE,EAAE,CAAC,KAAK;KAChB,CAAC,CAAC,CAAC;IAEJ,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC9B,mCAAmC;QACnC,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,gBAAgB,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACtC,OAAO;oBACL,YAAY,EAAE,QAAQ,CAAC,YAAY;oBACnC,KAAK;oBACL,UAAU,EAAE,MAAe;oBAC3B,SAAS,EAAE,QAAiB;iBAC7B,CAAC;YACJ,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;QAC3D,IAAI,aAAa,KAAK,MAAM,IAAI,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC;YACnE,OAAO;gBACL,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,KAAK,EAAE,MAAM,CAAC,sBAAsB,CAAC,IAAI;gBACzC,UAAU,EAAE,QAAiB;gBAC7B,SAAS,EAAE,WAAoB;aAChC,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;YAC/B,qFAAqF;YACrF,MAAM,WAAW,GAAG,cAAc,CAAC;YACnC,IAAI,MAAM,CAAC,sBAAsB,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/C,OAAO;oBACL,YAAY,EAAE,QAAQ,CAAC,YAAY;oBACnC,KAAK,EAAE,MAAM,CAAC,sBAAsB,CAAC,WAAW,CAAC;oBACjD,UAAU,EAAE,QAAiB;oBAC7B,SAAS,EAAE,WAAoB;iBAChC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,OAAO;YACL,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,KAAK,EAAE,sBAAsB;YAC7B,UAAU,EAAE,KAAc;YAC1B,SAAS,EAAE,UAAmB;SAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/analysis/campaign-structure.d.ts

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

package/dist/analysis/campaign-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-structure.d.ts","sourceRoot":"","sources":["../../src/analysis/campaign-structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAkBpF,eAAO,MAAM,sBAAsB,GAAI,SAAS,gBAAgB,EAAE,KAAG,qBAAqB,EAqDzF,CAAC"}