@koda-sl/baker-cli 0.34.1 → 0.34.2

package/dist/commands/research/index.js

@@ -0,0 +1,50 @@
+import { defineCommand } from "citty";
+import { advertisersCommand } from "./advertisers.js";
+import { autocompleteCommand } from "./autocomplete.js";
+import { countriesCommand } from "./countries.js";
+import { intentCommand } from "./intent.js";
+import { keywordGapCommand } from "./keyword-gap.js";
+import { keywordsForSiteCommand } from "./keywords-for-site.js";
+import { languagesCommand } from "./languages.js";
+import { lighthouseCommand } from "./lighthouse.js";
+import { relevantPagesCommand } from "./relevant-pages.js";
+import { webCommand } from "./web.js";
+export const researchCommand = defineCommand({
+    meta: {
+        name: "research",
+        description: `Competitive intelligence and AI-powered research commands.
+
+Commands:
+  web                — Search the web with AI (ask any question)
+  advertisers        — Who's bidding on a keyword?
+  autocomplete       — Google Autocomplete suggestions
+  intent             — Google Search intent classification
+  keywords-for-site  — Keywords a domain bids on
+  keyword-gap        — Keywords they have that we don't
+  relevant-pages     — Top pages of a competitor domain
+  lighthouse         — Landing page performance audit
+  countries          — List supported country codes
+  languages          — List supported language codes
+
+Examples:
+  baker research web "Who are the main competitors of HubSpot?"
+  baker research web "What is the ICP for CRM buyers?" --depth high
+  baker research advertisers "running shoes"
+  baker research intent "buy running shoes,best running shoes 2026"
+  baker research keywords-for-site "competitor.com"
+  baker research keyword-gap "them.com" "us.com"`,
+    },
+    subCommands: {
+        web: webCommand,
+        advertisers: advertisersCommand,
+        autocomplete: autocompleteCommand,
+        countries: countriesCommand,
+        intent: intentCommand,
+        "keywords-for-site": keywordsForSiteCommand,
+        "keyword-gap": keywordGapCommand,
+        languages: languagesCommand,
+        lighthouse: lighthouseCommand,
+        "relevant-pages": relevantPagesCommand,
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/commands/research/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/research/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;iDAoBgC;KAC9C;IACD,WAAW,EAAE;QACX,GAAG,EAAE,UAAU;QACf,WAAW,EAAE,kBAAkB;QAC/B,YAAY,EAAE,mBAAmB;QACjC,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,mBAAmB,EAAE,sBAAsB;QAC3C,aAAa,EAAE,iBAAiB;QAChC,SAAS,EAAE,gBAAgB;QAC3B,UAAU,EAAE,iBAAiB;QAC7B,gBAAgB,EAAE,oBAAoB;KACvC;CACF,CAAC,CAAC"}

package/dist/commands/research/intent.d.ts

@@ -0,0 +1,24 @@
+export declare const intentCommand: import("citty").CommandDef<{
+    readonly keywords: {
+        readonly type: "positional";
+        readonly description: "Comma-separated keywords";
+        readonly required: true;
+    };
+    readonly language: {
+        readonly type: "string";
+        readonly description: "Language code or name (default: en)";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|md|jsonl";
+        readonly required: false;
+        readonly default: "json";
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip server cache, hit API directly";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=intent.d.ts.map

package/dist/commands/research/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../src/commands/research/intent.ts"],"names":[],"mappings":"AAsCA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;EAoDxB,CAAC"}

package/dist/commands/research/intent.js

@@ -0,0 +1,78 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../client.js";
+import { buildResearchQueryContext, warnDefaults } from "../../geo-context.js";
+import { registerSchema } from "../../schemas.js";
+import { handleResearchError, writeResearchJson, writeResearchOutput } from "./output.js";
+registerSchema({
+    command: "research.intent",
+    description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. IMPORTANT: If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
+    args: {
+        keywords: {
+            type: "string",
+            description: "Comma-separated keywords (min 3 chars each, max 1000 keywords)",
+            required: true,
+        },
+        language: {
+            type: "string",
+            description: "Language code or name. DEFAULTS TO en (English) if omitted — always set this for non-English keywords",
+            required: false,
+        },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+});
+const FIELDS = {
+    keyword: "The keyword analyzed",
+    intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
+    probability: "Confidence score 0.0-1.0",
+};
+export const intentCommand = defineCommand({
+    meta: {
+        name: "intent",
+        description: `Classify Google Search intent for keywords. Returns intent type and confidence.
+
+Examples:
+  baker research intent "buy running shoes,best running shoes 2026,how to tie running shoes"
+  baker research intent "crm software" --language spanish`,
+    },
+    args: {
+        keywords: { type: "positional", description: "Comma-separated keywords", required: true },
+        language: { type: "string", description: "Language code or name (default: en)", required: false },
+        output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+    run: async ({ args }) => {
+        const rawKeywords = args.keywords;
+        const keywords = rawKeywords
+            .split(",")
+            .map((k) => k.trim())
+            .filter((k) => k.length >= 3);
+        if (keywords.length === 0) {
+            writeResearchJson({
+                ok: false,
+                error: { code: "VALIDATION_ERROR", message: "Provide at least one keyword (min 3 chars each)" },
+            });
+            process.exit(1);
+        }
+        const language = args.language || undefined;
+        const skipCache = args["no-cache"] ? true : undefined;
+        const queryContext = buildResearchQueryContext(undefined, language, { skipLocation: true });
+        try {
+            const data = await apiPost("/api/research/intent", {
+                keywords,
+                language,
+                skipCache,
+            });
+            warnDefaults(queryContext);
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeResearchOutput(data, format);
+                return;
+            }
+            writeResearchJson({ ok: true, data, fields: FIELDS, query_context: queryContext });
+        }
+        catch (err) {
+            handleResearchError(err);
+        }
+    },
+});
+//# sourceMappingURL=intent.js.map

package/dist/commands/research/intent.js.map

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

package/dist/commands/research/keyword-gap.d.ts

@@ -0,0 +1,49 @@
+export declare const keywordGapCommand: import("citty").CommandDef<{
+    readonly competitor: {
+        readonly type: "positional";
+        readonly description: "Competitor domain";
+        readonly required: true;
+    };
+    readonly ours: {
+        readonly type: "positional";
+        readonly description: "Your domain";
+        readonly required: true;
+    };
+    readonly location: {
+        readonly type: "string";
+        readonly description: "Country code or location code (default: us)";
+        readonly required: false;
+    };
+    readonly language: {
+        readonly type: "string";
+        readonly description: "Language code or name (default: en)";
+        readonly required: false;
+    };
+    readonly type: {
+        readonly type: "string";
+        readonly description: "Filter: paid, organic, all (default: all)";
+        readonly required: false;
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max results per page (default: 50, max: 1000)";
+        readonly required: false;
+    };
+    readonly offset: {
+        readonly type: "string";
+        readonly description: "Pagination offset (default: 0)";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|md|jsonl";
+        readonly required: false;
+        readonly default: "json";
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip server cache, hit API directly";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=keyword-gap.d.ts.map

package/dist/commands/research/keyword-gap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-gap.d.ts","sourceRoot":"","sources":["../../../src/commands/research/keyword-gap.ts"],"names":[],"mappings":"AA8CA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0E5B,CAAC"}

package/dist/commands/research/keyword-gap.js

@@ -0,0 +1,107 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../client.js";
+import { buildResearchQueryContext, warnDefaults } from "../../geo-context.js";
+import { registerSchema } from "../../schemas.js";
+import { handleResearchError, RESEARCH_DATA_NOTE, writeResearchJson, writeResearchOutput } from "./output.js";
+registerSchema({
+    command: "research.keyword-gap",
+    description: "Find keywords a competitor ranks for (organic or paid) that you don't. Discovers expansion opportunities. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
+    args: {
+        competitor: { type: "string", description: "Competitor domain (positional 1)", required: true },
+        ours: { type: "string", description: "Your domain (positional 2)", required: true },
+        location: {
+            type: "string",
+            description: "Country code (us, uk, es, de...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted — always set this for non-US markets",
+            required: false,
+        },
+        language: {
+            type: "string",
+            description: "Language code or name. DEFAULTS TO en (English) if omitted — always set this for non-English markets",
+            required: false,
+        },
+        type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+        limit: { type: "string", description: "Max results per page (default: 50, max: 1000)", required: false },
+        offset: { type: "string", description: "Pagination offset (default: 0)", required: false },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+});
+const FIELDS = {
+    keyword: "Keyword in the gap (they rank, you don't)",
+    search_volume: "Monthly search volume",
+    cpc: "Cost per click USD",
+    their_position: "Competitor's ranking position",
+};
+export const keywordGapCommand = defineCommand({
+    meta: {
+        name: "keyword-gap",
+        description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
+
+Examples:
+  baker research keyword-gap "competitor.com" "mysite.com"
+  baker research keyword-gap "competitor.com" "mysite.com" --type paid --limit 100
+  baker research keyword-gap "competitor.com" "mysite.com" --offset 50 --limit 50`,
+    },
+    args: {
+        competitor: { type: "positional", description: "Competitor domain", required: true },
+        ours: { type: "positional", description: "Your domain", required: true },
+        location: { type: "string", description: "Country code or location code (default: us)", required: false },
+        language: { type: "string", description: "Language code or name (default: en)", required: false },
+        type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+        limit: { type: "string", description: "Max results per page (default: 50, max: 1000)", required: false },
+        offset: { type: "string", description: "Pagination offset (default: 0)", required: false },
+        output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+    run: async ({ args }) => {
+        const competitor = args.competitor;
+        const ours = args.ours;
+        const location = args.location || undefined;
+        const language = args.language || undefined;
+        const type = args.type || undefined;
+        const limit = args.limit ? Number(args.limit) : undefined;
+        const offset = args.offset ? Number(args.offset) : undefined;
+        const skipCache = args["no-cache"] ? true : undefined;
+        const queryContext = buildResearchQueryContext(location, language);
+        try {
+            const result = await apiPost("/api/research/keyword-gap", {
+                competitor,
+                ours,
+                location,
+                language,
+                type,
+                limit,
+                offset,
+                skipCache,
+            });
+            const currentOffset = offset ?? 0;
+            const currentLimit = limit ?? 50;
+            const hasMore = currentOffset + result.data.length < result.total_count;
+            warnDefaults(queryContext);
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeResearchOutput(result.data, format);
+                return;
+            }
+            writeResearchJson({
+                ok: true,
+                your_domain: ours,
+                competitor_domain: competitor,
+                data: result.data,
+                fields: FIELDS,
+                note: RESEARCH_DATA_NOTE,
+                total_count: result.total_count,
+                query_context: queryContext,
+                pagination: {
+                    offset: currentOffset,
+                    limit: currentLimit,
+                    has_more: hasMore,
+                    next_offset: hasMore ? currentOffset + currentLimit : undefined,
+                },
+            });
+        }
+        catch (err) {
+            handleResearchError(err);
+        }
+    },
+});
+//# sourceMappingURL=keyword-gap.js.map

package/dist/commands/research/keyword-gap.js.map

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

package/dist/commands/research/keywords-for-site.d.ts

@@ -0,0 +1,44 @@
+export declare const keywordsForSiteCommand: import("citty").CommandDef<{
+    readonly target: {
+        readonly type: "positional";
+        readonly description: "Domain or URL to analyze";
+        readonly required: true;
+    };
+    readonly location: {
+        readonly type: "string";
+        readonly description: "Country code or location code (default: us)";
+        readonly required: false;
+    };
+    readonly language: {
+        readonly type: "string";
+        readonly description: "Language code or name (default: en)";
+        readonly required: false;
+    };
+    readonly sort: {
+        readonly type: "string";
+        readonly description: "Sort: relevance, search_volume, competition, cpc";
+        readonly required: false;
+    };
+    readonly type: {
+        readonly type: "string";
+        readonly description: "Filter: paid, organic, all (default: all)";
+        readonly required: false;
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max results (default: 50, max: 1000)";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|md|jsonl";
+        readonly required: false;
+        readonly default: "json";
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip server cache, hit API directly";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=keywords-for-site.d.ts.map

package/dist/commands/research/keywords-for-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywords-for-site.d.ts","sourceRoot":"","sources":["../../../src/commands/research/keywords-for-site.ts"],"names":[],"mappings":"AAmDA,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDjC,CAAC"}

package/dist/commands/research/keywords-for-site.js

@@ -0,0 +1,90 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../client.js";
+import { buildResearchQueryContext, warnDefaults } from "../../geo-context.js";
+import { registerSchema } from "../../schemas.js";
+import { handleResearchError, RESEARCH_DATA_NOTE, writeResearchJson, writeResearchOutput } from "./output.js";
+registerSchema({
+    command: "research.keywords-for-site",
+    description: "Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
+    args: {
+        target: { type: "string", description: "Domain or URL to analyze (positional)", required: true },
+        location: {
+            type: "string",
+            description: "Country code (us, uk, es, de...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted — always set this for non-US markets",
+            required: false,
+        },
+        language: {
+            type: "string",
+            description: "Language code or name. DEFAULTS TO en (English) if omitted — always set this for non-English markets",
+            required: false,
+        },
+        sort: {
+            type: "string",
+            description: "Sort: relevance, search_volume, competition, cpc (default: search_volume)",
+            required: false,
+        },
+        type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+        limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+});
+const FIELDS = {
+    keyword: "Keyword the site targets",
+    search_volume: "Monthly search volume",
+    cpc: "Cost per click in USD",
+    competition: "LOW, MEDIUM, or HIGH",
+    competition_index: "Competition score 0-100",
+};
+export const keywordsForSiteCommand = defineCommand({
+    meta: {
+        name: "keywords-for-site",
+        description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
+
+Examples:
+  baker research keywords-for-site "competitor.com"
+  baker research keywords-for-site "competitor.com" --type paid --limit 20
+  baker research keywords-for-site "competitor.com" --type organic --location uk`,
+    },
+    args: {
+        target: { type: "positional", description: "Domain or URL to analyze", required: true },
+        location: { type: "string", description: "Country code or location code (default: us)", required: false },
+        language: { type: "string", description: "Language code or name (default: en)", required: false },
+        sort: { type: "string", description: "Sort: relevance, search_volume, competition, cpc", required: false },
+        type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+        limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
+        output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+    run: async ({ args }) => {
+        const target = args.target;
+        const location = args.location || undefined;
+        const language = args.language || undefined;
+        const sort = args.sort || undefined;
+        const type = args.type || undefined;
+        const limit = args.limit ? Number(args.limit) : undefined;
+        const skipCache = args["no-cache"] ? true : undefined;
+        const queryContext = buildResearchQueryContext(location, language);
+        try {
+            const data = await apiPost("/api/research/keywords-for-site", {
+                target,
+                location,
+                language,
+                sort,
+                type,
+                limit,
+                skipCache,
+            });
+            warnDefaults(queryContext);
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeResearchOutput(data, format);
+                return;
+            }
+            writeResearchJson({ ok: true, data, fields: FIELDS, note: RESEARCH_DATA_NOTE, query_context: queryContext });
+        }
+        catch (err) {
+            handleResearchError(err);
+        }
+    },
+});
+//# sourceMappingURL=keywords-for-site.js.map

package/dist/commands/research/keywords-for-site.js.map

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

package/dist/commands/research/languages.d.ts

@@ -0,0 +1,2 @@
+export declare const languagesCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=languages.d.ts.map

package/dist/commands/research/languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../../src/commands/research/languages.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,gBAAgB,qDAQ3B,CAAC"}

package/dist/commands/research/languages.js

@@ -0,0 +1,42 @@
+import { defineCommand } from "citty";
+import { registerSchema } from "../../schemas.js";
+import { writeResearchJson } from "./output.js";
+registerSchema({
+    command: "research.languages",
+    description: "List all supported language codes for --language flag in research commands.",
+    args: {},
+});
+const LANGUAGES = [
+    { code: "en", name: "english" },
+    { code: "es", name: "spanish" },
+    { code: "fr", name: "french" },
+    { code: "de", name: "german" },
+    { code: "it", name: "italian" },
+    { code: "pt", name: "portuguese" },
+    { code: "nl", name: "dutch" },
+    { code: "ja", name: "japanese" },
+    { code: "ko", name: "korean" },
+    { code: "zh", name: "chinese" },
+    { code: "ar", name: "arabic" },
+    { code: "ru", name: "russian" },
+    { code: "pl", name: "polish" },
+    { code: "tr", name: "turkish" },
+    { code: "sv", name: "swedish" },
+    { code: "no", name: "norwegian" },
+    { code: "da", name: "danish" },
+    { code: "fi", name: "finnish" },
+];
+const FIELDS = {
+    code: "Language code to pass as --language",
+    name: "Language name (also accepted by --language)",
+};
+export const languagesCommand = defineCommand({
+    meta: {
+        name: "languages",
+        description: "List all supported language codes for --language flag.",
+    },
+    run: () => {
+        writeResearchJson({ ok: true, data: LANGUAGES, fields: FIELDS });
+    },
+});
+//# sourceMappingURL=languages.js.map

package/dist/commands/research/languages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.js","sourceRoot":"","sources":["../../../src/commands/research/languages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,cAAc,CAAC;IACb,OAAO,EAAE,oBAAoB;IAC7B,WAAW,EAAE,6EAA6E;IAC1F,IAAI,EAAE,EAAE;CACT,CAAC,CAAC;AAEH,MAAM,SAAS,GAA0C;IACvD,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE;IAClC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE;IAC7B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE;IAChC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE;IACjC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;CAChC,CAAC;AAEF,MAAM,MAAM,GAA2B;IACrC,IAAI,EAAE,qCAAqC;IAC3C,IAAI,EAAE,6CAA6C;CACpD,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,wDAAwD;KACtE;IACD,GAAG,EAAE,GAAG,EAAE;QACR,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/research/lighthouse.d.ts

@@ -0,0 +1,24 @@
+export declare const lighthouseCommand: import("citty").CommandDef<{
+    readonly url: {
+        readonly type: "positional";
+        readonly description: "Full URL to audit (with https://)";
+        readonly required: true;
+    };
+    readonly mobile: {
+        readonly type: "string";
+        readonly description: "Test as mobile: true|false (default: true)";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|md|jsonl";
+        readonly required: false;
+        readonly default: "json";
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip server cache, hit API directly";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=lighthouse.d.ts.map

package/dist/commands/research/lighthouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lighthouse.d.ts","sourceRoot":"","sources":["../../../src/commands/research/lighthouse.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;EAqC5B,CAAC"}

package/dist/commands/research/lighthouse.js

@@ -0,0 +1,60 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../client.js";
+import { registerSchema } from "../../schemas.js";
+import { handleResearchError, writeResearchJson, writeResearchOutput } from "./output.js";
+registerSchema({
+    command: "research.lighthouse",
+    description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
+    args: {
+        url: { type: "string", description: "Full URL to audit (with https://)", required: true },
+        mobile: { type: "boolean", description: "Test as mobile (default: true)", required: false },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+});
+const FIELDS = {
+    url: "URL that was audited",
+    performance_score: "Lighthouse performance score 0-100 (aim for 90+)",
+    fcp_ms: "First Contentful Paint in ms (good: < 1800)",
+    lcp_ms: "Largest Contentful Paint in ms (good: < 2500)",
+    cls: "Cumulative Layout Shift (good: < 0.1)",
+    speed_index_ms: "Speed Index in ms (good: < 3400)",
+    interactive_ms: "Time to Interactive in ms (good: < 3800)",
+};
+export const lighthouseCommand = defineCommand({
+    meta: {
+        name: "lighthouse",
+        description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
+
+Examples:
+  baker research lighthouse "https://example.com/landing"
+  baker research lighthouse "https://example.com" --mobile false`,
+    },
+    args: {
+        url: { type: "positional", description: "Full URL to audit (with https://)", required: true },
+        mobile: { type: "string", description: "Test as mobile: true|false (default: true)", required: false },
+        output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+    run: async ({ args }) => {
+        const url = args.url;
+        const mobile = args.mobile === "false" ? false : undefined;
+        const skipCache = args["no-cache"] ? true : undefined;
+        try {
+            const data = await apiPost("/api/research/lighthouse", {
+                url,
+                mobile,
+                skipCache,
+            });
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeResearchOutput([data], format);
+                return;
+            }
+            writeResearchJson({ ok: true, data, fields: FIELDS });
+        }
+        catch (err) {
+            handleResearchError(err);
+        }
+    },
+});
+//# sourceMappingURL=lighthouse.js.map

package/dist/commands/research/lighthouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lighthouse.js","sourceRoot":"","sources":["../../../src/commands/research/lighthouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE1F,cAAc,CAAC;IACb,OAAO,EAAE,qBAAqB;IAC9B,WAAW,EAAE,+FAA+F;IAC5G,IAAI,EAAE;QACJ,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzF,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gCAAgC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC3F,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,qCAAqC,EAAE,QAAQ,EAAE,KAAK,EAAE;KACrG;CACF,CAAC,CAAC;AAYH,MAAM,MAAM,GAA2B;IACrC,GAAG,EAAE,sBAAsB;IAC3B,iBAAiB,EAAE,kDAAkD;IACrE,MAAM,EAAE,6CAA6C;IACrD,MAAM,EAAE,+CAA+C;IACvD,GAAG,EAAE,uCAAuC;IAC5C,cAAc,EAAE,kCAAkC;IAClD,cAAc,EAAE,0CAA0C;CAC3D,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;IAC7C,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE;;;;iEAIgD;KAC9D;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,mCAAmC,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE,QAAQ,EAAE,KAAK,EAAE;QACtG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE;QACtG,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,qCAAqC,EAAE,QAAQ,EAAE,KAAK,EAAE;KACrG;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAa,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAEtD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAmB,0BAA0B,EAAE;gBACvE,GAAG;gBACH,MAAM;gBACN,SAAS;aACV,CAAC,CAAC;YAEH,MAAM,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,MAAM,CAAC;YACjD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,mBAAmB,CAAC,CAAC,IAA0C,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;YACD,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}