@koda-sl/baker-cli 0.15.0 → 0.16.0

package/dist/commands/gsc/query.js

@@ -0,0 +1,196 @@
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../client.js";
+import { registerSchema } from "../../schemas.js";
+import { buildQueryCacheKey, cacheGet, cacheSet, getQueryTtl } from "../ads/cache.js";
+import { toCsvRow, writeAdsOutput, writeJsonEnvelope } from "../ads/output.js";
+import { GSC_PRESETS } from "./presets.js";
+import { resolveSiteUrl } from "./resolve.js";
+registerSchema({
+    command: "gsc.query",
+    description: "Run GSC Search Analytics queries. Use --preset for playbook-aligned queries (primary usage) or --dimensions for free-form queries.",
+    args: {
+        "site-url": { type: "string", description: "Site URL (auto-resolved if not provided)", required: false },
+        preset: {
+            type: "string",
+            description: "Named preset (cannibalization, missed-revenue, brand-halo, negative-keywords, top-pages, top-queries)",
+            required: false,
+        },
+        brand: { type: "string", description: "Brand name (required for brand-halo preset)", required: false },
+        dimensions: {
+            type: "string",
+            description: "Comma-separated dimensions (escape hatch: query, page, country, device, date)",
+            required: false,
+        },
+        days: { type: "string", description: "Lookback window in days (default: 28)", required: false },
+        "start-date": { type: "string", description: "Explicit start date (YYYY-MM-DD)", required: false },
+        "end-date": { type: "string", description: "Explicit end date (YYYY-MM-DD)", required: false },
+        "row-limit": { type: "string", description: "Max rows (default: 1000, max: 25000)", required: false },
+        type: { type: "string", description: "Search type: web|image|video|news|discover (default: web)", required: false },
+        filter: { type: "string", description: "Dimension filter groups as JSON string", required: false },
+        "list-presets": { type: "boolean", description: "List available presets", required: false },
+        out: { type: "string", description: "Write data to file (.csv, .jsonl, .json)", required: false },
+        append: { type: "boolean", description: "Append to existing file", required: false },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+});
+function extractFields(rows) {
+    const first = rows[0];
+    return first ? Object.keys(first) : [];
+}
+function writeRowsToFile(filePath, rows, append) {
+    const fields = extractFields(rows);
+    const ext = filePath.split(".").pop()?.toLowerCase();
+    if (ext === "csv") {
+        if (!append || !existsSync(filePath)) {
+            writeFileSync(filePath, `${toCsvRow(fields)}\n`, "utf-8");
+        }
+        const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? ""))));
+        appendFileSync(filePath, `${csvRows.join("\n")}\n`, "utf-8");
+    }
+    else if (ext === "jsonl") {
+        const content = `${rows.map((row) => JSON.stringify(row)).join("\n")}\n`;
+        if (append && existsSync(filePath)) {
+            appendFileSync(filePath, content, "utf-8");
+        }
+        else {
+            writeFileSync(filePath, content, "utf-8");
+        }
+    }
+    else if (append && existsSync(filePath)) {
+        const existing = JSON.parse(readFileSync(filePath, "utf-8"));
+        writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
+    }
+    else {
+        writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
+    }
+}
+function outputRows(rows, args, response, cached) {
+    if (args.out) {
+        const filePath = resolve(args.out);
+        writeRowsToFile(filePath, rows, !!args.append);
+        writeJsonEnvelope({ ok: true, file: filePath, rows: rows.length, ...(cached && { cached: true }) });
+        return;
+    }
+    const format = args.output || "json";
+    if (format !== "json") {
+        writeAdsOutput(rows, format);
+        return;
+    }
+    writeJsonEnvelope({ ...response, ...(cached && { cached: true }) });
+}
+function buildRequestBody(args, siteUrl, useCache) {
+    const body = { siteUrl };
+    if (args.preset)
+        body.preset = args.preset;
+    if (args.brand)
+        body.brand = args.brand;
+    if (args.dimensions)
+        body.dimensions = args.dimensions.split(",").map((d) => d.trim());
+    if (args.days)
+        body.days = Number(args.days);
+    if (args["start-date"])
+        body.startDate = args["start-date"];
+    if (args["end-date"])
+        body.endDate = args["end-date"];
+    if (args["row-limit"])
+        body.rowLimit = Number(args["row-limit"]);
+    if (args.type)
+        body.type = args.type;
+    if (args.filter)
+        body.filter = args.filter;
+    if (!useCache)
+        body.skipCache = true;
+    return body;
+}
+function handleError(err) {
+    if (err instanceof ApiError) {
+        writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+    }
+    writeJsonEnvelope({
+        ok: false,
+        error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" },
+    });
+    process.exit(1);
+}
+export const queryCommand = defineCommand({
+    meta: {
+        name: "query",
+        description: `Run GSC Search Analytics queries. Preset-first with free-form escape hatch.
+
+Presets (primary usage):
+  baker gsc query --preset cannibalization
+  baker gsc query --preset brand-halo --brand "Acme" --days 90
+  baker gsc query --list-presets
+
+Free-form (escape hatch):
+  baker gsc query --dimensions "query,page" --days 28
+  baker gsc query --dimensions "query" --row-limit 25000 --out keywords.csv`,
+    },
+    args: {
+        "site-url": { type: "string", description: "Site URL", required: false },
+        preset: { type: "string", description: "Named preset", required: false },
+        brand: { type: "string", description: "Brand name for brand-halo preset", required: false },
+        dimensions: { type: "string", description: "Comma-separated dimensions", required: false },
+        days: { type: "string", description: "Lookback days (default: 28)", required: false },
+        "start-date": { type: "string", description: "Start date override", required: false },
+        "end-date": { type: "string", description: "End date override", required: false },
+        "row-limit": { type: "string", description: "Max rows (default: 1000)", required: false },
+        type: { type: "string", description: "Search type (default: web)", required: false },
+        filter: { type: "string", description: "Filter JSON", required: false },
+        "list-presets": { type: "boolean", description: "List presets", required: false },
+        out: { type: "string", description: "Output file path", required: false },
+        append: { type: "boolean", description: "Append to file", required: false },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+    run: async ({ args }) => {
+        if (args["list-presets"]) {
+            writeJsonEnvelope({
+                ok: true,
+                data: GSC_PRESETS.map((p) => ({
+                    name: p.name,
+                    description: p.description,
+                    playbook: p.playbook,
+                    ...(p.requiresBrand && { requiresBrand: true }),
+                })),
+            });
+            return;
+        }
+        if (!args.preset && !args.dimensions) {
+            writeJsonEnvelope({
+                ok: false,
+                error: {
+                    code: "VALIDATION_ERROR",
+                    message: "Provide --preset or --dimensions. Run --list-presets to see options.",
+                },
+            });
+            process.exit(1);
+        }
+        const siteUrl = await resolveSiteUrl(args);
+        const useCache = !args["no-cache"];
+        const body = buildRequestBody(args, siteUrl, useCache);
+        const cacheKey = buildQueryCacheKey(siteUrl, JSON.stringify(body));
+        if (useCache) {
+            const cached = cacheGet("gsc-queries", cacheKey);
+            if (cached) {
+                outputRows(cached.data.data ?? [], args, cached.data, true);
+                return;
+            }
+        }
+        try {
+            const response = await apiPost("/api/gsc/query", body);
+            if (useCache) {
+                cacheSet("gsc-queries", cacheKey, response, getQueryTtl(JSON.stringify(body)));
+            }
+            outputRows(response.data ?? [], args, response, false);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    },
+});
+//# sourceMappingURL=query.js.map

package/dist/commands/gsc/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/commands/gsc/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,cAAc,CAAC;IACb,OAAO,EAAE,WAAW;IACpB,WAAW,EACT,oIAAoI;IACtI,IAAI,EAAE;QACJ,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE,QAAQ,EAAE,KAAK,EAAE;QACxG,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uGAAuG;YACzG,QAAQ,EAAE,KAAK;SAChB;QACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE,QAAQ,EAAE,KAAK,EAAE;QACtG,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+EAA+E;YAC5F,QAAQ,EAAE,KAAK;SAChB;QACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC/F,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAClG,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC9F,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE,QAAQ,EAAE,KAAK,EAAE;QACrG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE,QAAQ,EAAE,KAAK,EAAE;QACnH,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAClG,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,wBAAwB,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC3F,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE,QAAQ,EAAE,KAAK,EAAE;QACjG,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE,QAAQ,EAAE,KAAK,EAAE;QACpF,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,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE;KAC5E;CACF,CAAC,CAAC;AASH,SAAS,aAAa,CAAC,IAAoC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB,EAAE,IAAoC,EAAE,MAAe;IAC9F,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IACrD,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,aAAa,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,cAAc,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;SAAM,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACzE,IAAI,MAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;SAAM,IAAI,MAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAc,CAAC;QAC1E,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CACjB,IAAoC,EACpC,IAA6B,EAC7B,QAA0B,EAC1B,MAAe;IAEf,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,GAAa,CAAC,CAAC;QAC7C,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACpG,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,MAAM,CAAC;IACjD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO;IACT,CAAC;IACD,iBAAiB,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA6B,EAAE,OAAe,EAAE,QAAiB;IACzF,MAAM,IAAI,GAA4B,EAAE,OAAO,EAAE,CAAC;IAClD,IAAI,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3C,IAAI,IAAI,CAAC,KAAK;QAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACxC,IAAI,IAAI,CAAC,UAAU;QAAE,IAAI,CAAC,UAAU,GAAI,IAAI,CAAC,UAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnG,IAAI,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,YAAY,CAAC;QAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IAC5D,IAAI,IAAI,CAAC,UAAU,CAAC;QAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,WAAW,CAAC;QAAE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACrC,IAAI,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3C,IAAI,CAAC,QAAQ;QAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAC5B,iBAAiB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,iBAAiB,CAAC;QAChB,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,EAAE;KACnG,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;IACxC,IAAI,EAAE;QACJ,IAAI,EAAE,OAAO;QACb,WAAW,EAAE;;;;;;;;;4EAS2D;KACzE;IACD,IAAI,EAAE;QACJ,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE;QACxE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE;QACxE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC3F,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC1F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE,QAAQ,EAAE,KAAK,EAAE;QACrF,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE,QAAQ,EAAE,KAAK,EAAE;QACrF,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAE;QACjF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE,QAAQ,EAAE,KAAK,EAAE;QACzF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE,QAAQ,EAAE,KAAK,EAAE;QACpF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE;QACvE,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE;QACjF,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE;QACzE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC3E,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,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE;KAC5E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,IAAI,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YACzB,iBAAiB,CAAC;gBAChB,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,GAAG,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;iBAChD,CAAC,CAAC;aACJ,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrC,iBAAiB,CAAC;gBAChB,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,sEAAsE;iBAChF;aACF,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAEnE,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,QAAQ,CAAmB,aAAa,EAAE,QAAQ,CAAC,CAAC;YACnE,IAAI,MAAM,EAAE,CAAC;gBACX,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC5D,OAAO;YACT,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAmB,gBAAgB,EAAE,IAAI,CAAC,CAAC;YACzE,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjF,CAAC;YACD,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/gsc/resolve.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveSiteUrl(args: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/commands/gsc/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/commands/gsc/resolve.ts"],"names":[],"mappings":"AAyBA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCnF"}

package/dist/commands/gsc/resolve.js

@@ -0,0 +1,57 @@
+import { apiGet } from "../../client.js";
+import { getEnv } from "../../env.js";
+import { cacheGet, cacheSet } from "../ads/cache.js";
+import { writeJsonEnvelope } from "../ads/output.js";
+async function fetchSites(useCache = true) {
+    if (useCache) {
+        const cached = cacheGet("gsc-sites", "list");
+        if (cached)
+            return cached.data;
+    }
+    const params = !useCache ? { "skip-cache": "true" } : undefined;
+    const data = await apiGet("/api/gsc/sites", params);
+    if (useCache) {
+        cacheSet("gsc-sites", "list", data, 60 * 60 * 1000);
+    }
+    return data;
+}
+import { handleConnectionError } from "../../error-handler.js";
+export async function resolveSiteUrl(args) {
+    const fromArgs = args["site-url"];
+    const fromEnv = getEnv().BAKER_GSC_SITE_URL;
+    const siteUrl = fromArgs || fromEnv;
+    if (siteUrl)
+        return siteUrl;
+    const useCache = !args["no-cache"];
+    try {
+        const sites = await fetchSites(useCache);
+        const [single] = sites;
+        if (sites.length === 1 && single) {
+            process.stderr.write(`Using site "${single.siteUrl}"\n`);
+            return single.siteUrl;
+        }
+        if (sites.length === 0) {
+            handleConnectionError("gsc");
+        }
+        const list = sites.map((s) => `  ${s.siteUrl}  (${s.permissionLevel})`).join("\n");
+        writeJsonEnvelope({
+            ok: false,
+            error: {
+                code: "MULTIPLE_SITES",
+                message: `Multiple sites found. Pass --site-url or set BAKER_GSC_SITE_URL:\n${list}`,
+            },
+        });
+        process.exit(1);
+    }
+    catch {
+        writeJsonEnvelope({
+            ok: false,
+            error: {
+                code: "RESOLUTION_ERROR",
+                message: "Could not auto-detect site. Pass --site-url or set BAKER_GSC_SITE_URL.",
+            },
+        });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=resolve.js.map

package/dist/commands/gsc/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/commands/gsc/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD,KAAK,UAAU,UAAU,CAAC,QAAQ,GAAG,IAAI;IACvC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,QAAQ,CAAY,WAAW,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACjC,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAY,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC/D,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAA6B;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAuB,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,kBAAkB,CAAC;IAC5C,MAAM,OAAO,GAAG,QAAQ,IAAI,OAAO,CAAC;IAEpC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QACvB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC;YACzD,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnF,iBAAiB,CAAC;YAChB,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,qEAAqE,IAAI,EAAE;aACrF;SACF,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB,CAAC;YAChB,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,wEAAwE;aAClF;SACF,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/gsc/sitemaps.d.ts

@@ -0,0 +1,19 @@
+export declare const sitemapsCommand: import("citty").CommandDef<{
+    readonly "site-url": {
+        readonly type: "string";
+        readonly description: "Site URL";
+        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|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=sitemaps.d.ts.map

package/dist/commands/gsc/sitemaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemaps.d.ts","sourceRoot":"","sources":["../../../src/commands/gsc/sitemaps.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;EAiD1B,CAAC"}

package/dist/commands/gsc/sitemaps.js

@@ -0,0 +1,65 @@
+import { defineCommand } from "citty";
+import { ApiError, apiGet } from "../../client.js";
+import { registerSchema } from "../../schemas.js";
+import { cacheGet, cacheSet } from "../ads/cache.js";
+import { writeAdsOutput, writeJsonEnvelope } from "../ads/output.js";
+import { resolveSiteUrl } from "./resolve.js";
+registerSchema({
+    command: "gsc.sitemaps",
+    description: "List sitemaps for a Search Console site. Check sitemap health and errors.",
+    args: {
+        "site-url": { type: "string", description: "Site URL (auto-resolved if not provided)", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false },
+    },
+});
+export const sitemapsCommand = defineCommand({
+    meta: {
+        name: "sitemaps",
+        description: `List sitemaps for a site. Check health and errors.
+
+Examples:
+  baker gsc sitemaps
+  baker gsc sitemaps --site-url "https://example.com/"`,
+    },
+    args: {
+        "site-url": { type: "string", description: "Site URL", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+        output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" },
+    },
+    run: async ({ args }) => {
+        const siteUrl = await resolveSiteUrl(args);
+        const useCache = !args["no-cache"];
+        const cacheKey = `sitemaps:${siteUrl}`;
+        if (useCache) {
+            const cached = cacheGet("gsc-sitemaps", cacheKey);
+            if (cached) {
+                writeJsonEnvelope({ ok: true, data: cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const params = { "site-url": siteUrl };
+            if (!useCache)
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/gsc/sitemaps", params);
+            if (useCache) {
+                cacheSet("gsc-sitemaps", cacheKey, data, 6 * 60 * 60 * 1000);
+            }
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeAdsOutput(data, format);
+                return;
+            }
+            writeJsonEnvelope({ ok: true, data });
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+                process.exit(1);
+            }
+            writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=sitemaps.js.map

package/dist/commands/gsc/sitemaps.js.map

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

package/dist/commands/gsc/sites.d.ts

@@ -0,0 +1,14 @@
+export declare const sitesCommand: import("citty").CommandDef<{
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip cache";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=sites.d.ts.map

package/dist/commands/gsc/sites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sites.d.ts","sourceRoot":"","sources":["../../../src/commands/gsc/sites.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,YAAY;;;;;;;;;;;;EA+CvB,CAAC"}

package/dist/commands/gsc/sites.js

@@ -0,0 +1,61 @@
+import { defineCommand } from "citty";
+import { ApiError, apiGet } from "../../client.js";
+import { registerSchema } from "../../schemas.js";
+import { cacheGet, cacheSet } from "../ads/cache.js";
+import { writeAdsOutput, writeJsonEnvelope } from "../ads/output.js";
+registerSchema({
+    command: "gsc.sites",
+    description: "List all verified Google Search Console sites. Returns site URLs needed for query and sitemaps commands.",
+    args: {
+        "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false },
+    },
+});
+import { handleConnectionError } from "../../error-handler.js";
+export const sitesCommand = defineCommand({
+    meta: {
+        name: "sites",
+        description: `List verified Search Console sites.
+
+Examples:
+  baker gsc sites`,
+    },
+    args: {
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+        output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" },
+    },
+    run: async ({ args }) => {
+        const useCache = !args["no-cache"];
+        if (useCache) {
+            const cached = cacheGet("gsc-sites", "list");
+            if (cached) {
+                writeJsonEnvelope({ ok: true, data: cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const params = !useCache ? { "skip-cache": "true" } : undefined;
+            const data = await apiGet("/api/gsc/sites", params);
+            if (useCache) {
+                cacheSet("gsc-sites", "list", data, 60 * 60 * 1000);
+            }
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeAdsOutput(data, format);
+                return;
+            }
+            writeJsonEnvelope({ ok: true, data });
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                if (err.code === "UNAUTHORIZED" || err.code === "NOT_FOUND") {
+                    handleConnectionError("gsc", err.message);
+                }
+                writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+                process.exit(1);
+            }
+            writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=sites.js.map

package/dist/commands/gsc/sites.js.map

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

package/dist/env.d.ts

@@ -2,6 +2,8 @@ type Env = {
     BAKER_API_KEY: string;
     BAKER_API_URL: string;
     BAKER_GOOGLE_ADS_CUSTOMER_ID?: string;
+    BAKER_GA4_PROPERTY_ID?: string;
+    BAKER_GSC_SITE_URL?: string;
 };
 export declare function getEnv(): Env;
 export {};

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,KAAK,GAAG,GAAG;IACT,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B,CAAC,EAAE,MAAM,CAAC;CACvC,CAAC;AAIF,wBAAgB,MAAM,IAAI,GAAG,CAe5B"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,KAAK,GAAG,GAAG;IACT,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAIF,wBAAgB,MAAM,IAAI,GAAG,CAiB5B"}

package/dist/env.js

@@ -11,6 +11,8 @@ export function getEnv() {
                     .string()
                     .regex(/^\d{10}$/)
                     .optional(),
+                BAKER_GA4_PROPERTY_ID: z.string().optional(),
+                BAKER_GSC_SITE_URL: z.string().optional(),
             },
             runtimeEnv: process.env,
         });

package/dist/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,IAAI,MAAuB,CAAC;AAE5B,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,SAAS,CAAC;YACjB,MAAM,EAAE;gBACN,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,+BAA+B,CAAC;gBAC5E,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,mCAAmC,CAAC;gBACzD,4BAA4B,EAAE,CAAC;qBAC5B,MAAM,EAAE;qBACR,KAAK,CAAC,UAAU,CAAC;qBACjB,QAAQ,EAAE;aACd;YACD,UAAU,EAAE,OAAO,CAAC,GAAG;SACxB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,IAAI,MAAuB,CAAC;AAE5B,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,SAAS,CAAC;YACjB,MAAM,EAAE;gBACN,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,+BAA+B,CAAC;gBAC5E,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,mCAAmC,CAAC;gBACzD,4BAA4B,EAAE,CAAC;qBAC5B,MAAM,EAAE;qBACR,KAAK,CAAC,UAAU,CAAC;qBACjB,QAAQ,EAAE;gBACb,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC5C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC1C;YACD,UAAU,EAAE,OAAO,CAAC,GAAG;SACxB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/error-handler.d.ts

@@ -0,0 +1,8 @@
+type ConnectionPlatform = "google_ads" | "ga4" | "gsc";
+/**
+ * Shared error handler for "No Connection" scenarios.
+ * Provides a structured error for AI agents with a suggested fix and alternative commands.
+ */
+export declare function handleConnectionError(platform: ConnectionPlatform, originalMessage?: string): never;
+export {};
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAEA,KAAK,kBAAkB,GAAG,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAkCnG"}

package/dist/error-handler.js

@@ -0,0 +1,37 @@
+import { writeJsonEnvelope } from "./commands/ads/output.js";
+/**
+ * Shared error handler for "No Connection" scenarios.
+ * Provides a structured error for AI agents with a suggested fix and alternative commands.
+ */
+export function handleConnectionError(platform, originalMessage) {
+    const platformName = {
+        google_ads: "Google Ads",
+        ga4: "Google Analytics 4",
+        gsc: "Google Search Console",
+    }[platform];
+    const alternative = {
+        google_ads: "keywords-for-site or research advertisers",
+        ga4: "lighthouse for page performance",
+        gsc: "keywords-for-site or research keyword-gap",
+    }[platform];
+    const code = {
+        google_ads: "NO_GOOGLE_ADS_CONNECTION",
+        ga4: "NO_GA4_CONNECTION",
+        gsc: "NO_GSC_CONNECTION",
+    }[platform];
+    const envelope = {
+        ok: false,
+        error: {
+            code,
+            message: originalMessage || `No ${platformName} connection found for this company.`,
+            fix: {
+                action: "authenticate",
+                explanation: `AGENT INSTRUCTION: You cannot resolve this error programmatically. The user has not connected their ${platformName} account. Step 1: Inform the user that they must connect ${platformName} in their Baker dashboard settings for direct data queries. Step 2: Do not fail the overall audit or playbook. Document the missing connection, skip this specific check, and proceed with the rest of your tasks. (Optional fallback: use 'baker research ${alternative}' for estimated external insights).`,
+            },
+            retryable: false,
+        },
+    };
+    writeJsonEnvelope(envelope);
+    process.exit(1);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAA4B,EAAE,eAAwB;IAC1F,MAAM,YAAY,GAAG;QACnB,UAAU,EAAE,YAAY;QACxB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,uBAAuB;KAC7B,CAAC,QAAQ,CAAC,CAAC;IAEZ,MAAM,WAAW,GAAG;QAClB,UAAU,EAAE,2CAA2C;QACvD,GAAG,EAAE,iCAAiC;QACtC,GAAG,EAAE,2CAA2C;KACjD,CAAC,QAAQ,CAAC,CAAC;IAEZ,MAAM,IAAI,GAAG;QACX,UAAU,EAAE,0BAA0B;QACtC,GAAG,EAAE,mBAAmB;QACxB,GAAG,EAAE,mBAAmB;KACzB,CAAC,QAAQ,CAAC,CAAC;IAEZ,MAAM,QAAQ,GAAG;QACf,EAAE,EAAE,KAAK;QACT,KAAK,EAAE;YACL,IAAI;YACJ,OAAO,EAAE,eAAe,IAAI,MAAM,YAAY,qCAAqC;YACnF,GAAG,EAAE;gBACH,MAAM,EAAE,cAAc;gBACtB,WAAW,EAAE,uGAAuG,YAAY,4DAA4D,YAAY,8PAA8P,WAAW,qCAAqC;aACvf;YACD,SAAS,EAAE,KAAK;SACjB;KACF,CAAC;IAEF,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koda-sl/baker-cli",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "AI-agent-first CLI for interacting with Baker",
   "type": "module",
   "bin": {