@koda-sl/baker-cli 0.466.0 → 0.468.0

package/dist/query-TWNH6GV7.js

@@ -0,0 +1,247 @@
+import {
+  resolveSiteUrl
+} from "./chunk-IWNZCYWI.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getQueryTtl,
+  handleConnectionError,
+  isNotConnectedError,
+  toCsvRow,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-6SL6463H.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/gsc/query.ts
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { defineCommand } from "citty";
+
+// src/commands/gsc/presets.ts
+var GSC_PRESETS = [
+  {
+    name: "cannibalization",
+    description: "PPC-SEO arbitrage \u2014 find queries ranking #1-2 organically where you also pay for ads",
+    playbook: "[05] PPC-SEO Arbitrage"
+  },
+  {
+    name: "missed-revenue",
+    description: "High-impression queries with no PPC coverage (position > 10)",
+    playbook: "[05] Opportunity Finder"
+  },
+  {
+    name: "brand-halo",
+    description: "Brand search volume trends \u2014 proves upper-funnel awareness lift",
+    playbook: "[21] YouTube/DG ROI",
+    requiresBrand: true
+  },
+  {
+    name: "negative-keywords",
+    description: "Discover negative keyword candidates (login, support, cancel queries)",
+    playbook: "Negative Keyword Discovery"
+  },
+  {
+    name: "top-pages",
+    description: "Top performing pages by clicks",
+    playbook: "General"
+  },
+  {
+    name: "top-queries",
+    description: "Top search queries by clicks",
+    playbook: "General"
+  }
+];
+
+// src/commands/gsc/query.ts
+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)}
+`, "utf-8");
+    }
+    const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? ""))));
+    appendFileSync(filePath, `${csvRows.join("\n")}
+`, "utf-8");
+  } else if (ext === "jsonl") {
+    const content = `${rows.map((row) => JSON.stringify(row)).join("\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) {
+    if (isNotConnectedError(err.code, err.message)) {
+      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: err instanceof Error ? err.message : "Unexpected error" }
+  });
+  process.exit(1);
+}
+var 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);
+    }
+  }
+});
+export {
+  queryCommand
+};
+//# sourceMappingURL=query-TWNH6GV7.js.map

package/dist/questionnaire-A5CAIIQW.js

@@ -0,0 +1,93 @@
+import {
+  questionnaireErrorEnvelope
+} from "./chunk-WJQZQBGR.js";
+import "./chunk-SSJK7FEV.js";
+import "./chunk-EDLZGTGN.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-6SL6463H.js";
+import {
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// ../api/src/analytics/questionnaire.ts
+import { z } from "zod";
+var questionnaireObservationSchema = z.object({
+  attemptId: z.string().min(1).max(100),
+  version: z.string().min(1).max(100),
+  stepId: z.string().max(100),
+  sequence: z.number().int().positive(),
+  phase: z.enum(["start", "view", "complete", "skip", "finish"]),
+  timestamp: z.number().finite()
+}).refine(
+  (event) => ["start", "finish"].includes(event.phase) || event.stepId.length > 0,
+  "A question event needs its stable step id"
+);
+var questionnaireRequestSchema = z.object({
+  eventName: z.string().min(1).max(100).default("questionnaire_step"),
+  days: z.number().int().min(1).max(90).default(7),
+  inactivityMinutes: z.number().int().min(5).max(1440).default(30)
+});
+var stepSchema = z.object({
+  version: z.string(),
+  stepId: z.string(),
+  reached: z.number(),
+  completed: z.number(),
+  skipped: z.number(),
+  abandoned: z.number(),
+  pending: z.number(),
+  incomplete: z.number()
+});
+var questionnaireResponseSchema = z.object({
+  ok: z.literal(true),
+  data: z.object({
+    steps: z.array(stepSchema),
+    attempts: z.number(),
+    excludedAttempts: z.number(),
+    unmeasuredEvents: z.number(),
+    observationEndsAt: z.string(),
+    inactivityMinutes: z.number()
+  }),
+  hints: z.array(z.string())
+});
+
+// src/commands/analytics/questionnaire.ts
+import { defineCommand } from "citty";
+var description = "Question-level drop-off from the external questionnaire contract: start, viewed, completed, skipped and finished per attempt, version and sequence. Reports actual reached questions and the last unanswered one after inactivity; deduplicates repeated visits. Refuses a truncated feed (maximum 600 events), so narrow --days if needed. No events is not proof of zero abandonment. The contract is in analytics.md.";
+var args = {
+  name: { type: "string", description: "Event name (default questionnaire_step)", required: false },
+  days: { type: "string", description: "Observation window in days (default 7, maximum 90)", required: false },
+  inactivity: {
+    type: "string",
+    description: "Minutes without an event before abandonment (default 30)",
+    required: false
+  }
+};
+registerSchema({ command: "analytics.questionnaire", description, args });
+var questionnaireCommand = defineCommand({
+  meta: { name: "questionnaire", description },
+  args,
+  run: async ({ args: args2 }) => {
+    try {
+      const body = questionnaireRequestSchema.parse({
+        ...args2.name ? { eventName: args2.name } : {},
+        ...args2.days ? { days: Number(args2.days) } : {},
+        ...args2.inactivity ? { inactivityMinutes: Number(args2.inactivity) } : {}
+      });
+      writeJsonEnvelope(questionnaireResponseSchema.parse(await apiPost("/api/analytics/questionnaire", body)));
+    } catch (error) {
+      writeJsonEnvelope({ ok: false, error: questionnaireErrorEnvelope(error) });
+      process.exitCode = 1;
+    }
+  }
+});
+export {
+  questionnaireCommand
+};
+//# sourceMappingURL=questionnaire-A5CAIIQW.js.map

package/dist/read-2AGRYWXU.js

@@ -0,0 +1,141 @@
+import {
+  TAG_MANAGER_TIMEOUT_MS,
+  handleError
+} from "./chunk-KL5VTXIK.js";
+import "./chunk-D5FY4FAK.js";
+import {
+  connectedResourceHints
+} from "./chunk-P4NSJS54.js";
+import {
+  AVAILABLE_ARG,
+  writeAvailableAccounts
+} from "./chunk-EESOZY5S.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-6SL6463H.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/tag-manager/read.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "tagManager.containers",
+  description: "List the Google Tag Manager containers this company selected. There can be several, and Baker may read and change all of them. Start here to confirm which containers you are managing.",
+  args: { available: AVAILABLE_ARG }
+});
+registerSchema({
+  command: "tagManager.read",
+  description: "Read what is currently inside a Tag Manager container: tags, triggers, variables, folders and enabled built-in variables. Start here before proposing any change, so you edit what exists instead of duplicating it. Pass --container when the company connected more than one. Compact by default; pass --full for raw Tag Manager objects.",
+  args: {
+    container: {
+      type: "string",
+      description: "Numeric container id (optional only when one container is connected)",
+      required: false
+    },
+    workspace: { type: "string", description: "Workspace id (defaults to the default workspace)", required: false },
+    entities: {
+      type: "string",
+      description: "Comma-separated subset: tag,trigger,variable,folder,builtInVariable",
+      required: false
+    },
+    full: { type: "boolean", description: "Include the raw Tag Manager object for each entity", required: false }
+  }
+});
+function containersHints(containers, unavailableContainers = []) {
+  const hints = connectedResourceHints({
+    plural: "Tag Manager containers",
+    singular: "Tag Manager container",
+    flag: "--container",
+    resources: containers.map((container) => ({
+      id: container.containerId,
+      label: `${container.publicId} \xB7 ${container.name}`
+    }))
+  });
+  if (unavailableContainers.length > 0) {
+    const [available] = containers;
+    if (containers.length === 1 && available) {
+      hints.length = 0;
+      hints.push(
+        `Use --container ${available.containerId} for ${available.publicId} (${available.name}); another selected container cannot be opened.`
+      );
+    }
+    hints.push(
+      `Tag Manager cannot open ${unavailableContainers.map((container) => `${container.publicId} (${container.name})`).join(", ")}. Ask the user to reconnect with a Google account that has access to these containers.`
+    );
+  }
+  return hints;
+}
+var containersCommand = defineCommand({
+  meta: {
+    name: "containers",
+    description: `List Tag Manager containers selected by this company.
+
+Start here:
+  baker tag-manager containers
+  baker tag-manager containers --available   # every container the login reaches, selected or not`
+  },
+  args: { available: AVAILABLE_ARG },
+  run: async ({ args }) => {
+    if (args.available) return writeAvailableAccounts("google-tag-manager", handleError);
+    try {
+      const data = await apiGet("/api/tag-manager/containers");
+      writeJsonEnvelope({ ok: true, data, hints: containersHints(data.containers, data.unavailableContainers) });
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+var readCommand = defineCommand({
+  meta: {
+    name: "read",
+    description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
+
+Examples:
+  baker tag-manager read
+  baker tag-manager read --entities tag,trigger
+  baker tag-manager read --full`
+  },
+  args: {
+    container: { type: "string", description: "Numeric container id", required: false },
+    workspace: { type: "string", description: "Workspace id", required: false },
+    entities: { type: "string", description: "Comma-separated entity subset", required: false },
+    full: { type: "boolean", description: "Include raw Tag Manager objects", required: false }
+  },
+  run: async ({ args }) => {
+    const entities = typeof args.entities === "string" && args.entities.length > 0 ? args.entities.split(",").map((entry) => entry.trim()) : void 0;
+    try {
+      const data = await apiPost(
+        "/api/tag-manager/read",
+        { containerId: args.container, workspaceId: args.workspace, entities, full: args.full === true },
+        { timeoutMs: TAG_MANAGER_TIMEOUT_MS }
+      );
+      const hints = [
+        `This is container ${data.container.containerId} ${data.container.publicId} (${data.container.name}). Stage changes for it with --container ${data.container.containerId}.`
+      ];
+      if (data.publicationWarning) hints.push(data.publicationWarning);
+      if (data.installedContainerMismatch) {
+        hints.push(data.installedContainerMismatch);
+      }
+      hints.push(
+        "Reference an existing trigger or variable by its numeric id or {{Name}}. To reference something you are staging in this same chat, use its gtm_temp_* ref and the executor resolves it at publish."
+      );
+      writeJsonEnvelope({ ok: true, data, hints });
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+export {
+  containersCommand,
+  containersHints,
+  readCommand
+};
+//# sourceMappingURL=read-2AGRYWXU.js.map

package/dist/reddit-5RDOPHJQ.js

@@ -0,0 +1,26 @@
+import {
+  findSubreddits,
+  redditCommand,
+  searchReddit,
+  subredditsFromArgs
+} from "./chunk-RVFB5JDH.js";
+import "./chunk-YT74ZEVP.js";
+import "./chunk-JZP5IODJ.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  findSubreddits,
+  redditCommand,
+  searchReddit,
+  subredditsFromArgs
+};
+//# sourceMappingURL=reddit-5RDOPHJQ.js.map

package/dist/refresh-TPOFMA45.js

@@ -0,0 +1,94 @@
+import {
+  reportError
+} from "./chunk-ICJFL7DU.js";
+import {
+  adLibraryRefreshRequestSchema
+} from "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/refresh.ts
+import { defineCommand } from "citty";
+function refreshEnvelope(data) {
+  if (data.queued) {
+    return {
+      ok: true,
+      data,
+      hints: [
+        "Re-scrape started \u2014 new ads arrive over the next minutes. Check progress with `baker winning-ads following`; carry on with the ads already there meanwhile."
+      ]
+    };
+  }
+  if (data.collecting) {
+    return {
+      ok: true,
+      data,
+      hints: [
+        `${data.label}'s ads are still being collected from the follow or the last refresh, so there is nothing to refresh yet. Check progress with \`baker winning-ads following\` and use what is there meanwhile.`
+      ]
+    };
+  }
+  if (data.nextAllowedAt !== void 0) {
+    const next = new Date(data.nextAllowedAt).toISOString();
+    return {
+      ok: false,
+      error: {
+        code: "RATE_LIMITED",
+        message: `${data.label} was refreshed less than 6 hours ago.`,
+        fix: `Use the ads already collected for ${data.label}; it can be refreshed again after ${next}. Do not retry before then.`
+      }
+    };
+  }
+  return {
+    ok: true,
+    data,
+    hints: ["Nothing new to look for on this brand right now; its ads are already up to date."]
+  };
+}
+registerSchema({
+  command: "winning-ads.refresh",
+  description: "Re-scrape a brand this company follows so its newest ads land in the library. At most once every 6 hours per brand, and not while its ads are still being collected; it costs a fresh scrape, so use it only when the user wants the latest ads.",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id of a followed brand (from `following`)", required: true }
+  }
+});
+var refreshCommand = defineCommand({
+  meta: {
+    name: "refresh",
+    description: "Re-scrape a followed brand for its newest ads (at most once every 6 hours). Example: baker winning-ads refresh adv_123"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id of a followed brand", required: true }
+  },
+  run: async ({ args }) => {
+    const parsed = adLibraryRefreshRequestSchema.safeParse({ advertiser_id: String(args.advertiser ?? "") });
+    if (!parsed.success) {
+      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: parsed.error.issues[0]?.message ?? "" } });
+      process.exit(1);
+    }
+    try {
+      const envelope = refreshEnvelope(await apiPost("/api/ad-library/refresh", parsed.data));
+      writeJson(envelope);
+      if (!envelope.ok) process.exit(1);
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  refreshCommand,
+  refreshEnvelope
+};
+//# sourceMappingURL=refresh-TPOFMA45.js.map

package/dist/refresh-TPOFMA45.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/refresh.ts"],"sourcesContent":["import { type AdLibraryRefreshResponse, adLibraryRefreshRequestSchema } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { reportError } from \"./shared.ts\";\n\ntype RefreshEnvelope =\n  | { ok: true; data: AdLibraryRefreshResponse; hints?: string[] }\n  | { ok: false; error: { code: \"RATE_LIMITED\"; message: string; fix: string } };\n\n/**\n * What the agent reads back. A refresh inside the cooldown is a refusal with a\n * `fix` naming when the brand can be refreshed again — never something to retry\n * in a loop, and never a reason to stop: the ads already collected are usable.\n */\nexport function refreshEnvelope(data: AdLibraryRefreshResponse): RefreshEnvelope {\n  if (data.queued) {\n    return {\n      ok: true,\n      data,\n      hints: [\n        \"Re-scrape started — new ads arrive over the next minutes. Check progress with `baker winning-ads following`; carry on with the ads already there meanwhile.\",\n      ],\n    };\n  }\n  if (data.collecting) {\n    return {\n      ok: true,\n      data,\n      hints: [\n        `${data.label}'s ads are still being collected from the follow or the last refresh, so there is nothing to refresh yet. Check progress with \\`baker winning-ads following\\` and use what is there meanwhile.`,\n      ],\n    };\n  }\n  if (data.nextAllowedAt !== undefined) {\n    const next = new Date(data.nextAllowedAt).toISOString();\n    return {\n      ok: false,\n      error: {\n        code: \"RATE_LIMITED\",\n        message: `${data.label} was refreshed less than 6 hours ago.`,\n        fix: `Use the ads already collected for ${data.label}; it can be refreshed again after ${next}. Do not retry before then.`,\n      },\n    };\n  }\n  return {\n    ok: true,\n    data,\n    hints: [\"Nothing new to look for on this brand right now; its ads are already up to date.\"],\n  };\n}\n\nregisterSchema({\n  command: \"winning-ads.refresh\",\n  description:\n    \"Re-scrape a brand this company follows so its newest ads land in the library. At most once every 6 hours per brand, and not while its ads are still being collected; it costs a fresh scrape, so use it only when the user wants the latest ads.\",\n  args: {\n    advertiser: { type: \"string\", description: \"Advertiser id of a followed brand (from `following`)\", required: true },\n  },\n});\n\nexport const refreshCommand = defineCommand({\n  meta: {\n    name: \"refresh\",\n    description:\n      \"Re-scrape a followed brand for its newest ads (at most once every 6 hours). Example: baker winning-ads refresh adv_123\",\n  },\n  args: {\n    advertiser: { type: \"positional\", description: \"Advertiser id of a followed brand\", required: true },\n  },\n  run: async ({ args }) => {\n    const parsed = adLibraryRefreshRequestSchema.safeParse({ advertiser_id: String(args.advertiser ?? \"\") });\n    if (!parsed.success) {\n      writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: parsed.error.issues[0]?.message ?? \"\" } });\n      process.exit(1);\n    }\n    try {\n      const envelope = refreshEnvelope(await apiPost<AdLibraryRefreshResponse>(\"/api/ad-library/refresh\", parsed.data));\n      writeJson(envelope);\n      if (!envelope.ok) process.exit(1);\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAevB,SAAS,gBAAgB,MAAiD;AAC/E,MAAI,KAAK,QAAQ;AACf,WAAO;AAAA,MACL,IAAI;AAAA,MACJ;AAAA,MACA,OAAO;AAAA,QACL;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,MAAI,KAAK,YAAY;AACnB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ;AAAA,MACA,OAAO;AAAA,QACL,GAAG,KAAK,KAAK;AAAA,MACf;AAAA,IACF;AAAA,EACF;AACA,MAAI,KAAK,kBAAkB,QAAW;AACpC,UAAM,OAAO,IAAI,KAAK,KAAK,aAAa,EAAE,YAAY;AACtD,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS,GAAG,KAAK,KAAK;AAAA,QACtB,KAAK,qCAAqC,KAAK,KAAK,qCAAqC,IAAI;AAAA,MAC/F;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ;AAAA,IACA,OAAO,CAAC,kFAAkF;AAAA,EAC5F;AACF;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,YAAY,EAAE,MAAM,UAAU,aAAa,wDAAwD,UAAU,KAAK;AAAA,EACpH;AACF,CAAC;AAEM,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,YAAY,EAAE,MAAM,cAAc,aAAa,qCAAqC,UAAU,KAAK;AAAA,EACrG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,SAAS,8BAA8B,UAAU,EAAE,eAAe,OAAO,KAAK,cAAc,EAAE,EAAE,CAAC;AACvG,QAAI,CAAC,OAAO,SAAS;AACnB,gBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,oBAAoB,SAAS,OAAO,MAAM,OAAO,CAAC,GAAG,WAAW,GAAG,EAAE,CAAC;AAC5G,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,QAAI;AACF,YAAM,WAAW,gBAAgB,MAAM,QAAkC,2BAA2B,OAAO,IAAI,CAAC;AAChH,gBAAU,QAAQ;AAClB,UAAI,CAAC,SAAS,GAAI,SAAQ,KAAK,CAAC;AAAA,IAClC,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/release-VMPOB45V.js

@@ -0,0 +1,60 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-6KD4HB6Y.js";
+import "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import {
+  requireChatId
+} from "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/release.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.release",
+  description: "Release an action you previously claimed (no-op if you don't own the claim).",
+  args: {
+    id: { type: "string", description: "Action ID", required: true }
+  }
+});
+var releaseCommand = defineCommand({
+  meta: {
+    name: "release",
+    description: "Release a claim you made on an action. Example: baker actions release <action-id>"
+  },
+  args: {
+    id: { type: "positional", description: "Action ID", required: false },
+    "action-id": { type: "string", description: "Action ID", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      validateConvexId(id);
+      const chatId = requireChatId();
+      await apiPost("/api/actions/release", { actionId: id, chatId });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  releaseCommand
+};
+//# sourceMappingURL=release-VMPOB45V.js.map

package/dist/release-VMPOB45V.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/actions/release.ts"],"sourcesContent":["import type { ActionsReleaseResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost, validateConvexId } from \"../../client.ts\";\nimport { requireChatId } from \"../../env.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi, failValidation, writeOk } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"actions.release\",\n  description: \"Release an action you previously claimed (no-op if you don't own the claim).\",\n  args: {\n    id: { type: \"string\", description: \"Action ID\", required: true },\n  },\n});\n\nexport const releaseCommand = defineCommand({\n  meta: {\n    name: \"release\",\n    description: \"Release a claim you made on an action. Example: baker actions release <action-id>\",\n  },\n  args: {\n    id: { type: \"positional\", description: \"Action ID\", required: false },\n    \"action-id\": { type: \"string\", description: \"Action ID\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const id = (args.id as string | undefined) || (args[\"action-id\"] as string | undefined);\n      if (!id) {\n        failValidation(\"Action ID is required.\");\n      }\n      validateConvexId(id);\n      const chatId = requireChatId();\n      await apiPost<ActionsReleaseResponse>(\"/api/actions/release\", { actionId: id, chatId });\n      writeOk();\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,UAAU,aAAa,aAAa,UAAU,KAAK;AAAA,EACjE;AACF,CAAC;AAEM,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,aAAa,UAAU,MAAM;AAAA,IACpE,aAAa,EAAE,MAAM,UAAU,aAAa,aAAa,UAAU,MAAM;AAAA,EAC3E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,KAAM,KAAK,MAA8B,KAAK,WAAW;AAC/D,UAAI,CAAC,IAAI;AACP,uBAAe,wBAAwB;AAAA,MACzC;AACA,uBAAiB,EAAE;AACnB,YAAM,SAAS,cAAc;AAC7B,YAAM,QAAgC,wBAAwB,EAAE,UAAU,IAAI,OAAO,CAAC;AACtF,cAAQ;AAAA,IACV,SAAS,KAAK;AACZ,cAAQ,GAAG;AAAA,IACb;AAAA,EACF;AACF,CAAC;","names":[]}