@koda-sl/baker-cli 0.34.1 → 0.34.2

package/dist/commands/ads/google/keywords/metrics.d.ts

@@ -0,0 +1,34 @@
+export declare const metricsCommand: import("citty").CommandDef<{
+    readonly "customer-id": {
+        readonly type: "string";
+        readonly description: "Google Ads customer ID";
+        readonly required: false;
+    };
+    readonly keywords: {
+        readonly type: "string";
+        readonly description: "Comma-separated keywords";
+        readonly required: true;
+    };
+    readonly location: {
+        readonly type: "string";
+        readonly description: "Geo target ID (default 2840)";
+        readonly required: false;
+    };
+    readonly language: {
+        readonly type: "string";
+        readonly description: "Language ID (default 1000)";
+        readonly required: false;
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip cache";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|jsonl|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/commands/ads/google/keywords/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ads/google/keywords/metrics.ts"],"names":[],"mappings":"AA+CA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgGzB,CAAC"}

package/dist/commands/ads/google/keywords/metrics.js

@@ -0,0 +1,123 @@
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../../../client.js";
+import { buildAdsQueryContext, warnDefaults } from "../../../../geo-context.js";
+import { registerSchema } from "../../../../schemas.js";
+import { buildQueryCacheKey, cacheGet, cacheSet, getManagerIdForCustomer } from "../../cache.js";
+import { resolveCustomerId, writeAdsJson, writeAdsOutput } from "../../output.js";
+registerSchema({
+    command: "ads.google.keywords.metrics",
+    description: "Get historical metrics for specific keywords. Returns { historical_metrics: [...] } with snake_case fields matching the Google Ads API. IMPORTANT: If --location and --language are omitted, defaults to United States (2840) and English (1000). The response includes a query_context object showing which location/language were used.",
+    args: {
+        "customer-id": {
+            type: "string",
+            description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+            required: false,
+        },
+        keywords: { type: "string", description: "Comma-separated keywords to analyze (max 200)", required: true },
+        location: {
+            type: "string",
+            description: "Geo target ID. DEFAULTS TO 2840 (United States) if omitted — always set this for non-US markets",
+            required: false,
+        },
+        language: {
+            type: "string",
+            description: "Language ID. DEFAULTS TO 1000 (English) if omitted — always set this for non-English markets",
+            required: false,
+        },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    },
+});
+export const metricsCommand = defineCommand({
+    meta: {
+        name: "metrics",
+        description: `Get historical search metrics for specific keywords.
+
+Examples:
+  baker ads google keywords metrics --customer-id 1234567890 --keywords "running shoes,nike shoes,adidas shoes"
+  baker ads google keywords metrics --customer-id 1234567890 --keywords "seo tools" --location 2826`,
+    },
+    args: {
+        "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
+        keywords: { type: "string", description: "Comma-separated keywords", required: true },
+        location: { type: "string", description: "Geo target ID (default 2840)", required: false },
+        language: { type: "string", description: "Language ID (default 1000)", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    },
+    run: async ({ args }) => {
+        const customerId = await resolveCustomerId(args);
+        const queryContext = buildAdsQueryContext(args.location, args.language);
+        const keywords = args.keywords
+            .split(",")
+            .map((k) => k.trim())
+            .filter(Boolean);
+        if (keywords.length === 0) {
+            writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "At least one keyword is required" } });
+            process.exit(1);
+        }
+        if (keywords.length > 200) {
+            writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Maximum 200 keywords per request" } });
+            process.exit(1);
+        }
+        const body = { customerId, keywords };
+        const managerId = getManagerIdForCustomer(customerId);
+        if (managerId)
+            body.managerId = managerId;
+        if (args.location)
+            body.locationIds = [args.location];
+        if (args.language)
+            body.languageId = args.language;
+        const useCache = !args["no-cache"];
+        if (!useCache)
+            body.skipCache = true;
+        const cacheKey = buildQueryCacheKey(customerId, JSON.stringify(body));
+        if (useCache) {
+            const cached = cacheGet("keywords", cacheKey);
+            if (cached) {
+                warnDefaults(queryContext);
+                writeAdsJson({ ok: true, data: cached.data, cached: true, query_context: queryContext });
+                return;
+            }
+        }
+        try {
+            const data = await apiPost("/api/ads/google/keywords/metrics", body);
+            if (useCache) {
+                cacheSet("keywords", cacheKey, data, 24 * 60 * 60 * 1000);
+            }
+            warnDefaults(queryContext);
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeAdsOutput(data.historical_metrics, format);
+                return;
+            }
+            const fields = {
+                keyword: "The keyword analyzed",
+                avg_monthly_searches: "Average monthly search volume as string (last 12 months)",
+                competition: "Competition level: LOW, MEDIUM, HIGH",
+                competition_index: "Competition index 0-100 as string (higher = more competitive)",
+                low_top_of_page_bid_micros: "Low-range CPC bid in micros (÷ 1,000,000 for currency)",
+                high_top_of_page_bid_micros: "High-range CPC bid in micros (÷ 1,000,000 for currency)",
+                monthly_search_volumes: "Monthly search volume breakdown (array of {year, month, monthly_searches})",
+            };
+            writeAdsJson({ ok: true, data, fields, query_context: queryContext });
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                const envelope = {
+                    ok: false,
+                    error: {
+                        code: err.code,
+                        message: err.message,
+                        fix: { action: "reject", explanation: err.message },
+                        retryable: err.code === "RATE_LIMITED",
+                    },
+                };
+                writeAdsJson(envelope);
+                process.exit(1);
+            }
+            writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=metrics.js.map

package/dist/commands/ads/google/keywords/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../../../src/commands/ads/google/keywords/metrics.ts"],"names":[],"mappings":"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"}

package/dist/commands/ads/google/library/index.d.ts

@@ -0,0 +1,3 @@
+export declare function looksLikeDomain(query: string): boolean;
+export declare const library: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/ads/google/library/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ads/google/library/index.ts"],"names":[],"mappings":"AAqGA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAmMD,eAAO,MAAM,OAAO,qDAclB,CAAC"}

package/dist/commands/ads/google/library/index.js

@@ -0,0 +1,279 @@
+import { defineCommand } from "citty";
+import { apiGet, apiPost } from "../../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../../output.js";
+const listAdvertisers = defineCommand({
+    meta: {
+        name: "list-advertisers",
+        description: "List tracked Google advertisers and their accounts",
+    },
+    args: {
+        output: { type: "string", description: "Format: json|csv|md", default: "json" },
+    },
+    async run({ args }) {
+        const data = await apiGet("/api/ads/google/library/advertisers");
+        if (args.output !== "json") {
+            writeAdsOutput(data, args.output);
+        }
+        else {
+            writeAdsJson({ ok: true, data });
+        }
+    },
+});
+const syncStatus = defineCommand({
+    meta: {
+        name: "sync-status",
+        description: "Check the sync status and ad counts of a Google account",
+    },
+    args: {
+        accountId: {
+            type: "positional",
+            description: "Account ID to check",
+            required: true,
+        },
+        output: { type: "string", description: "Format: json", default: "json" },
+    },
+    async run({ args }) {
+        const data = await apiGet("/api/ads/google/library/account-status", {
+            accountId: args.accountId,
+        });
+        writeAdsJson({ ok: true, data });
+    },
+});
+const searchAds = defineCommand({
+    meta: {
+        name: "search-ads",
+        description: "Search and filter Google ads for an account",
+    },
+    args: {
+        accountId: {
+            type: "positional",
+            description: "Account ID to search in",
+            required: true,
+        },
+        search: {
+            type: "string",
+            description: "Search term for ad text",
+        },
+        isActive: {
+            type: "boolean",
+            description: "Filter by active ads only",
+        },
+        mediaType: {
+            type: "string",
+            description: "Filter by media type (image, video, text)",
+        },
+        sort: {
+            type: "string",
+            description: "Sort by newest or oldest",
+        },
+        limit: {
+            type: "string",
+            description: "Maximum number of ads to return (default 20)",
+        },
+        cursor: {
+            type: "string",
+            description: "Pagination cursor",
+        },
+        output: { type: "string", description: "Format: json|csv|md", default: "json" },
+    },
+    async run({ args }) {
+        const data = await apiPost("/api/ads/google/library/ads/search", {
+            accountId: args.accountId,
+            search: args.search,
+            isActive: args.isActive,
+            mediaType: args.mediaType,
+            sort: args.sort,
+            numItems: args.limit ? Number.parseInt(args.limit, 10) : undefined,
+            cursor: args.cursor,
+        });
+        if (args.output !== "json" && Array.isArray(data.page)) {
+            writeAdsOutput(data.page, args.output);
+        }
+        else {
+            writeAdsJson({ ok: true, data });
+        }
+    },
+});
+export function looksLikeDomain(query) {
+    return !query.includes(" ") && query.includes(".");
+}
+const searchAdvertiser = defineCommand({
+    meta: {
+        name: "search-advertiser",
+        description: "Search for an advertiser on the Google Ads Transparency Center",
+    },
+    args: {
+        query: {
+            type: "positional",
+            description: "Company name or domain to search for. Strongly recommended: use the domain running the ads (e.g. example.com) for more accurate results",
+            required: true,
+        },
+        output: { type: "string", description: "Format: json|csv|md", default: "json" },
+    },
+    async run({ args }) {
+        const data = await apiPost("/api/ads/google/library/search-advertiser", {
+            query: args.query,
+        });
+        const advertisers = data.advertisers ?? data.results ?? [];
+        const looksLikeDomain = !args.query.includes(" ") && args.query.includes(".");
+        if (advertisers.length === 0 && !looksLikeDomain) {
+            process.stderr.write(`No advertisers found for "${args.query}". Try searching with the domain they run ads from instead.\n`);
+        }
+        if (args.output !== "json" && advertisers.length > 0) {
+            writeAdsOutput(advertisers, args.output);
+        }
+        else {
+            writeAdsJson({ ok: true, data });
+        }
+    },
+});
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+const track = defineCommand({
+    meta: {
+        name: "track",
+        description: "Track a new Google advertiser (from search results). Waits for initial sync to complete before returning.",
+    },
+    args: {
+        id: {
+            type: "positional",
+            description: "Google Advertiser ID (e.g. AR123...)",
+            required: true,
+        },
+        name: {
+            type: "positional",
+            description: "Display name for the advertiser",
+            required: true,
+        },
+        json: {
+            type: "boolean",
+            description: "Output in JSON format",
+        },
+    },
+    async run({ args }) {
+        const data = await apiPost("/api/ads/google/library/track", {
+            id: args.id,
+            name: args.name,
+        });
+        process.stderr.write(`Tracking "${args.name}" (${args.id}). Syncing ads...\n`);
+        const deadline = Date.now() + 600_000;
+        while (Date.now() < deadline) {
+            await sleep(5_000);
+            const status = await apiGet("/api/ads/google/library/account-status", {
+                accountId: data.accountId,
+            });
+            if (!status.syncStatus) {
+                process.stderr.write(`Sync complete. ${status.totalAdCount ?? 0} ads (${status.activeAdCount ?? 0} active)\n`);
+                if (args.json) {
+                    writeAdsJson({ ok: true, data: { ...data, ...status } });
+                }
+                return;
+            }
+            if (status.syncStatus === "error") {
+                process.stderr.write("Sync failed.\n");
+                writeAdsJson({ ok: false, error: { code: "SYNC_ERROR", message: "Initial sync failed" } });
+                process.exit(1);
+            }
+            process.stderr.write(`  syncing...\n`);
+        }
+        process.stderr.write("Sync timed out after 10 minutes.\n");
+        writeAdsJson({
+            ok: false,
+            error: { code: "TIMEOUT", message: "Sync did not complete within 10 minutes" },
+        });
+        process.exit(1);
+    },
+});
+const sync = defineCommand({
+    meta: {
+        name: "sync",
+        description: "Trigger an immediate sync for a Google account. Waits for completion before returning.",
+    },
+    args: {
+        accountId: {
+            type: "positional",
+            description: "Account ID to sync",
+            required: true,
+        },
+        output: { type: "string", description: "Format: json", default: "json" },
+    },
+    async run({ args }) {
+        await apiPost("/api/ads/google/library/sync", {
+            accountId: args.accountId,
+        });
+        process.stderr.write("Sync started. Polling...\n");
+        const deadline = Date.now() + 600_000;
+        while (Date.now() < deadline) {
+            await sleep(5_000);
+            const status = await apiGet("/api/ads/google/library/account-status", {
+                accountId: args.accountId,
+            });
+            if (!status.syncStatus) {
+                process.stderr.write(`Sync complete. ${status.totalAdCount ?? 0} ads (${status.activeAdCount ?? 0} active)\n`);
+                if (args.output === "json") {
+                    writeAdsJson({ ok: true, data: status });
+                }
+                return;
+            }
+            if (status.syncStatus === "error") {
+                process.stderr.write("Sync failed.\n");
+                writeAdsJson({ ok: false, error: { code: "SYNC_ERROR", message: "Sync failed" } });
+                process.exit(1);
+            }
+            process.stderr.write("  syncing...\n");
+        }
+        process.stderr.write("Sync timed out after 10 minutes.\n");
+        writeAdsJson({ ok: false, error: { code: "TIMEOUT", message: "Sync did not complete within 10 minutes" } });
+        process.exit(1);
+    },
+});
+const searchCompetitors = defineCommand({
+    meta: {
+        name: "search-competitors",
+        description: "Search for competitors running Google ads for a keyword (DataForSEO)",
+    },
+    args: {
+        keyword: {
+            type: "positional",
+            description: "Keyword to search for",
+            required: true,
+        },
+        location: {
+            type: "string",
+            description: "Location (name or code)",
+        },
+        json: {
+            type: "boolean",
+            description: "Output in JSON format",
+        },
+    },
+    async run({ args }) {
+        const data = await apiPost("/api/research/advertisers", {
+            keyword: args.keyword,
+            location: args.location,
+        });
+        if (args.json) {
+            writeAdsJson({ ok: true, data });
+        }
+        else {
+            writeAdsOutput(data, "md");
+        }
+    },
+});
+export const library = defineCommand({
+    meta: {
+        name: "library",
+        description: "Manage and search the Google Ads Library",
+    },
+    subCommands: {
+        "list-advertisers": listAdvertisers,
+        "sync-status": syncStatus,
+        "search-ads": searchAds,
+        "search-advertiser": searchAdvertiser,
+        "search-competitors": searchCompetitors,
+        track: track,
+        sync: sync,
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/commands/ads/google/library/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/ads/google/library/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/ads/google/library/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/commands/ads/google/library/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ads/google/library/index.test.ts"],"names":[],"mappings":""}

package/dist/commands/ads/google/library/index.test.js

@@ -0,0 +1,26 @@
+import { describe, expect, it } from "vitest";
+import { looksLikeDomain } from "./index.js";
+describe("looksLikeDomain", () => {
+    it("returns true for a bare domain", () => {
+        expect(looksLikeDomain("example.com")).toBe(true);
+    });
+    it("returns true for a subdomain", () => {
+        expect(looksLikeDomain("ads.example.com")).toBe(true);
+    });
+    it("returns false for a plain company name", () => {
+        expect(looksLikeDomain("upload-post")).toBe(false);
+    });
+    it("returns false for a brand name with dots and spaces", () => {
+        expect(looksLikeDomain("Dr. Pepper")).toBe(false);
+    });
+    it("returns false for a brand name like U.S. Army", () => {
+        expect(looksLikeDomain("U.S. Army")).toBe(false);
+    });
+    it("returns false for a domain-like name with Inc suffix", () => {
+        expect(looksLikeDomain("Amazon.com, Inc.")).toBe(false);
+    });
+    it("returns false for a name without dots", () => {
+        expect(looksLikeDomain("Nike")).toBe(false);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/commands/ads/google/library/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../../../src/commands/ads/google/library/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/ads/google/preflight.d.ts

@@ -0,0 +1,3 @@
+import type { PreflightResult } from "../types.ts";
+export declare function validatePreflight(query: string, customerId: string, limit?: number): PreflightResult;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/commands/ads/google/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/google/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,aAAa,CAAC;AAkD/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CA2FpG"}

package/dist/commands/ads/google/preflight.js

@@ -0,0 +1,122 @@
+function buildCommand(query, customerId) {
+    return `baker ads google query "${query}" --customer-id ${customerId}`;
+}
+function applyAutoFixes(query, limit) {
+    let corrected = query;
+    const warnings = [];
+    // keyword.text → ad_group_criterion.keyword.text
+    if (/\bkeyword\.text\b/.test(corrected) && !/ad_group_criterion\.keyword\.text/.test(corrected)) {
+        corrected = corrected.replace(/\bkeyword\.text\b/g, "ad_group_criterion.keyword.text");
+        warnings.push({ code: "FIELD_RENAMED", message: "keyword.text → ad_group_criterion.keyword.text" });
+    }
+    // keyword.match_type → ad_group_criterion.keyword.match_type
+    if (/\bkeyword\.match_type\b/.test(corrected) && !/ad_group_criterion\.keyword\.match_type/.test(corrected)) {
+        corrected = corrected.replace(/\bkeyword\.match_type\b/g, "ad_group_criterion.keyword.match_type");
+        warnings.push({ code: "FIELD_RENAMED", message: "keyword.match_type → ad_group_criterion.keyword.match_type" });
+    }
+    // shopping_performance_view.product_* → segments.product_*
+    if (/shopping_performance_view\.product_\w+/.test(corrected)) {
+        corrected = corrected.replace(/shopping_performance_view\.product_(\w+)/g, "segments.product_$1");
+        warnings.push({ code: "FIELD_RENAMED", message: "shopping_performance_view.product_* → segments.product_*" });
+    }
+    // campaign.status = 'ACTIVE' → 'ENABLED'
+    if (/campaign\.status\s*=\s*'ACTIVE'/i.test(corrected)) {
+        corrected = corrected.replace(/campaign\.status\s*=\s*'ACTIVE'/gi, "campaign.status = 'ENABLED'");
+        warnings.push({ code: "ENUM_CORRECTED", message: "campaign.status ACTIVE → ENABLED" });
+    }
+    // ad_group.status = 'ACTIVE' → 'ENABLED'
+    if (/ad_group\.status\s*=\s*'ACTIVE'/i.test(corrected)) {
+        corrected = corrected.replace(/ad_group\.status\s*=\s*'ACTIVE'/gi, "ad_group.status = 'ENABLED'");
+        warnings.push({ code: "ENUM_CORRECTED", message: "ad_group.status ACTIVE → ENABLED" });
+    }
+    // Missing LIMIT
+    if (!/\bLIMIT\b/i.test(corrected)) {
+        const effectiveLimit = limit ?? 200;
+        corrected = `${corrected.trimEnd()} LIMIT ${effectiveLimit}`;
+        warnings.push({ code: "AUTO_LIMIT", message: `Added LIMIT ${effectiveLimit}. Use --limit to override.` });
+    }
+    return { query: corrected, warnings };
+}
+export function validatePreflight(query, customerId, limit) {
+    const warnings = [];
+    const corrected = query;
+    // REJECT: Non-SELECT queries
+    const firstWord = corrected.trim().split(/\s+/)[0]?.toUpperCase();
+    if (firstWord && firstWord !== "SELECT") {
+        return {
+            valid: false,
+            warnings: [],
+            error: {
+                ok: false,
+                error: {
+                    code: "READ_ONLY",
+                    message: `Only SELECT queries are allowed. Got: ${firstWord}`,
+                    fix: {
+                        action: "reject",
+                        explanation: "This CLI only supports GAQL SELECT queries for reading data",
+                    },
+                    retryable: false,
+                },
+            },
+        };
+    }
+    // REJECT: CONTAINS usage
+    const containsMatch = corrected.match(/CONTAINS\s*\(\s*([^,]+),\s*'([^']+)'\s*\)/i);
+    if (containsMatch) {
+        const field = containsMatch[1]?.trim();
+        const value = containsMatch[2] ?? "";
+        const fixed = corrected.replace(/CONTAINS\s*\(\s*[^,]+,\s*'[^']+'\s*\)/i, `${field} LIKE '%${value}%'`);
+        return {
+            valid: false,
+            warnings: [],
+            error: {
+                ok: false,
+                error: {
+                    code: "INVALID_OPERATOR",
+                    message: "GAQL does not support CONTAINS. Use LIKE with % wildcards.",
+                    fix: {
+                        action: "change_operator",
+                        correctedCommand: buildCommand(fixed, customerId),
+                        explanation: "GAQL uses LIKE '%value%' for substring matching, not CONTAINS()",
+                    },
+                    retryable: false,
+                },
+            },
+        };
+    }
+    // REJECT: Open-ended date range
+    const openDateMatch = corrected.match(/segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i);
+    if (openDateMatch && !/BETWEEN/i.test(corrected)) {
+        const startDate = openDateMatch[1] ?? "";
+        const today = new Date().toISOString().slice(0, 10);
+        const fixed = corrected.replace(/segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i, `segments.date BETWEEN '${startDate}' AND '${today}'`);
+        return {
+            valid: false,
+            warnings: [],
+            error: {
+                ok: false,
+                error: {
+                    code: "OPEN_ENDED_DATE",
+                    message: "Open-ended date ranges are not supported. Use BETWEEN or DURING.",
+                    fix: {
+                        action: "narrow_date_range",
+                        correctedCommand: buildCommand(fixed, customerId),
+                        explanation: "Use BETWEEN with explicit start and end dates",
+                    },
+                    retryable: false,
+                },
+            },
+        };
+    }
+    // WARN: ad_group_criterion without negative field — positives and negatives will be mixed
+    if (/FROM\s+ad_group_criterion\b/i.test(corrected) && !/ad_group_criterion\.negative/i.test(corrected)) {
+        warnings.push({
+            code: "NEGATIVE_FIELD_MISSING",
+            message: "ad_group_criterion returns BOTH positive and negative keywords. Add ad_group_criterion.negative to SELECT or filter with WHERE ad_group_criterion.negative = FALSE (positives) / TRUE (negatives). Use --preset positive-keywords or negative-keywords instead.",
+        });
+    }
+    const { query: autoFixed, warnings: autoFixWarnings } = applyAutoFixes(corrected, limit);
+    warnings.push(...autoFixWarnings);
+    return { valid: true, correctedQuery: autoFixed, warnings };
+}
+//# sourceMappingURL=preflight.js.map