@koda-sl/baker-cli 0.412.0 → 0.414.0

package/dist/cli.js

@@ -21715,7 +21715,7 @@ var require_entry_node = __commonJS({
 });
 
 // src/cli.ts
-import { defineCommand as defineCommand279, runMain } from "citty";
+import { defineCommand as defineCommand285, runMain } from "citty";
 
 // src/cache-flag.ts
 var NO_CACHE_ARG = {
@@ -26265,6 +26265,9 @@ var chatChangeTypeSchema = z13.enum([
   // A connected social account feeding the image and video libraries, keyed
   // on `platform:handle`. Immediate — see convex/mediaSources/mutations.ts.
   "media-source",
+  // A review site listing feeding the testimonials library, keyed on the
+  // source's id. Immediate — see convex/testimonials/mutations.ts.
+  "testimonial-source",
   // A landing page saved to the reference library, keyed on the page.
   "landing-reference",
   // One Studio batch — the takes of one brief, as a set. See convex/lib/validators.ts.
@@ -28445,6 +28448,13 @@ var imageSourceSchema = z25.enum([
   "website",
   "google_testimonial",
   "trustpilot_testimonial",
+  "yelp_testimonial",
+  "tripadvisor_testimonial",
+  "g2_testimonial",
+  "capterra_testimonial",
+  "amazon_testimonial",
+  "app_store_testimonial",
+  "google_play_testimonial",
   "instagram",
   "tiktok",
   "linkedin",
@@ -30262,7 +30272,17 @@ var tagChangeToolResultSchema = z33.object({
 
 // ../api/src/testimonials.ts
 import { z as z34 } from "zod";
-var testimonialSourceTypeSchema = z34.enum(["google", "trustpilot"]);
+var testimonialSourceTypeSchema = z34.enum([
+  "google",
+  "trustpilot",
+  "yelp",
+  "tripadvisor",
+  "g2",
+  "capterra",
+  "amazon",
+  "app_store",
+  "google_play"
+]);
 var testimonialStatusSchema = z34.enum(["pending", "processing", "ready", "error"]);
 var testimonialSentimentSchema = z34.enum(["positive", "neutral", "negative"]);
 var testimonialDocSchema = z34.object({
@@ -30330,6 +30350,35 @@ var testimonialsOutscraperWebhookResponseSchema = z34.object({
   ok: z34.literal(true),
   note: z34.string().optional()
 });
+var testimonialSourceRefreshIntervalSchema = z34.enum(["never", "daily", "weekly", "monthly"]);
+var testimonialSourceSummarySchema = z34.object({
+  id: z34.string(),
+  platform: testimonialSourceTypeSchema,
+  platformLabel: z34.string(),
+  label: z34.string(),
+  pageUrl: z34.string().optional(),
+  status: z34.enum(["importing", "idle", "error"]),
+  reviews: z34.number(),
+  refreshInterval: z34.string(),
+  lastSyncedAt: z34.number().optional(),
+  error: z34.string().optional(),
+  createdAt: z34.number()
+});
+var testimonialSourcesAddRequestSchema = z34.object({
+  /** The review page's link; for Google Maps also the business name. */
+  input: z34.string().trim().min(1, "Pass the review page's link, or a business name for Google Maps"),
+  /** Needed only to force a site: a business name is Google, a link names its own site. */
+  platform: testimonialSourceTypeSchema.optional(),
+  /** Auto-sync cadence. Omitted = never, like the dashboard. */
+  every: testimonialSourceRefreshIntervalSchema.optional()
+});
+var sourceIdSchema = z34.string().trim().min(1, "Pass a source id from `baker testimonials sources list`");
+var testimonialSourcesSyncRequestSchema = z34.object({ id: sourceIdSchema });
+var testimonialSourcesRemoveRequestSchema = z34.object({ id: sourceIdSchema });
+var testimonialSourcesScheduleRequestSchema = z34.object({
+  id: sourceIdSchema,
+  every: testimonialSourceRefreshIntervalSchema
+});
 
 // ../api/src/videos.ts
 import { z as z35 } from "zod";
@@ -60294,7 +60343,7 @@ var SOURCE_KINDS = ["webhook", "hubspot"];
 var SOURCE_STATUSES = ["learning", "counting", "paused"];
 var SOURCE_NAME_MAX = 80;
 var sourceNameSchema = z49.string().trim().min(1).max(SOURCE_NAME_MAX).refine((name) => validateEventName(name) === null, REJECTION_MESSAGES.invalid_name);
-var sourceIdSchema = z49.string().min(1);
+var sourceIdSchema2 = z49.string().min(1);
 var sourceMappingSchema = z49.record(z49.string(), z49.string().min(1)).superRefine((mapping, ctx) => {
   for (const row2 of Object.keys(mapping)) {
     const problem = mappingRowProblem(row2);
@@ -60392,7 +60441,7 @@ var sourcesRequestSchema = z49.strictObject({
   }).optional(),
   /** Change what a HubSpot event watches. It counts from now on under the new trigger; the rows stay. The object cannot change: the rows read it. */
   setTrigger: z49.strictObject({
-    sourceId: sourceIdSchema,
+    sourceId: sourceIdSchema2,
     trigger: hubspotTriggerInputSchema,
     contacts: hubspotDealContactsSchema.optional()
   }).optional(),
@@ -60400,7 +60449,7 @@ var sourcesRequestSchema = z49.strictObject({
   preview: hubspotPreviewRequestSchema.optional(),
   /** Change where a HubSpot-read source takes its amount from; no `amountProperty` clears it. Sugar over `map`. */
   setAmount: z49.strictObject({
-    sourceId: sourceIdSchema,
+    sourceId: sourceIdSchema2,
     amountProperty: z49.string().trim().min(1).optional(),
     currency: currencyCodeSchema.optional()
   }).optional(),
@@ -60414,7 +60463,7 @@ var sourcesRequestSchema = z49.strictObject({
    * has a timestamp for, so nothing is invented. Dry unless `write`.
    */
   backfill: z49.strictObject({
-    sourceId: sourceIdSchema,
+    sourceId: sourceIdSchema2,
     /** ISO instant, or Unix milliseconds. Bounded by the 400 days the store keeps. */
     since: z49.union([z49.string().trim().min(1), z49.number()]),
     /**
@@ -60433,10 +60482,10 @@ var sourcesRequestSchema = z49.strictObject({
     /** Without it, nothing is counted and the answer says what would be. */
     write: z49.boolean().optional()
   }).optional(),
-  map: z49.strictObject({ sourceId: sourceIdSchema, mapping: sourceMappingSchema }).optional(),
-  pause: z49.strictObject({ sourceId: sourceIdSchema }).optional(),
-  resume: z49.strictObject({ sourceId: sourceIdSchema }).optional(),
-  remove: z49.strictObject({ sourceId: sourceIdSchema }).optional()
+  map: z49.strictObject({ sourceId: sourceIdSchema2, mapping: sourceMappingSchema }).optional(),
+  pause: z49.strictObject({ sourceId: sourceIdSchema2 }).optional(),
+  resume: z49.strictObject({ sourceId: sourceIdSchema2 }).optional(),
+  remove: z49.strictObject({ sourceId: sourceIdSchema2 }).optional()
 });
 var sourceRefusalSchema = z49.strictObject({
   at: z49.number(),
@@ -97338,7 +97387,7 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand258 } from "citty";
+import { defineCommand as defineCommand264 } from "citty";
 
 // src/commands/testimonials/get.ts
 import { defineCommand as defineCommand255 } from "citty";
@@ -97402,7 +97451,7 @@ function resolveEmptyReason({
   }
   return sourceCount === 0 ? "no_corpus_connected" : "corpus_empty";
 }
-var NO_CORPUS_EXIT = 'Testimonials are ingested from the client\'s Google/Trustpilot reviews \u2014 an agent cannot write one \u2014 so no rewording will find quotes. Stop searching and source proof another way: a result or case study the client already published, a named-customer logo (`baker images logo`), or a founder claim attributed as a claim. Otherwise ship without a testimonial block and file the gap: `baker actions create --name "Collect customer quotes for <page>" --priority medium --tags <slug>`. Never invent, paraphrase-into-existence, or pad with unrelated praise.';
+var NO_CORPUS_EXIT = "Testimonials are ingested from the client's public review pages \u2014 an agent cannot write one \u2014 so no rewording will find quotes. If the user named the client's own review page (Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store, Google Play), add it with `baker testimonials sources add <link>` \u2014 its reviews arrive over the next minutes, not in this turn. Stop searching and source proof another way: a result or case study the client already published, a named-customer logo (`baker images logo`), or a founder claim attributed as a claim. Otherwise ship without a testimonial block and file the gap: `baker actions create --name \"Collect customer quotes for <page>\" --priority medium --tags <slug>`. Never invent, paraphrase-into-existence, or pad with unrelated praise.";
 function emptyReasonDetail(reason, sourceCount, activeFilters) {
   if (reason === "filtered_out") {
     return `No rows matched, and ${activeFilters.join(", ")} narrowed this read. The corpus was not checked \u2014 drop every filter to see whether the library itself is empty.`;
@@ -97494,9 +97543,9 @@ registerSchema({
   args: {
     source: {
       type: "string",
-      description: "Filter by source: google|trustpilot",
+      description: `Filter by source: ${testimonialSourceTypeSchema.options.join("|")}`,
       required: false,
-      enum: ["google", "trustpilot"]
+      enum: [...testimonialSourceTypeSchema.options]
     },
     "rating-min": { type: "number", description: "Minimum star rating (1-5)", required: false },
     "rating-max": { type: "number", description: "Maximum star rating (1-5)", required: false },
@@ -97549,7 +97598,11 @@ var listCommand22 = defineCommand256({
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
   },
   args: {
-    source: { type: "string", description: "Filter by source: google|trustpilot", required: false },
+    source: {
+      type: "string",
+      description: `Filter by source: ${testimonialSourceTypeSchema.options.join("|")}`,
+      required: false
+    },
     "rating-min": { type: "string", description: "Minimum star rating (1-5)", required: false },
     "rating-max": { type: "string", description: "Maximum star rating (1-5)", required: false },
     status: { type: "string", description: "Filter by status: pending|processing|ready|error", required: false },
@@ -97632,9 +97685,9 @@ registerSchema({
     limit: { type: "number", description: "Maximum results to return", required: false, default: 10 },
     source: {
       type: "string",
-      description: "Filter by source: google|trustpilot",
+      description: `Filter by source: ${testimonialSourceTypeSchema.options.join("|")}`,
       required: false,
-      enum: ["google", "trustpilot"]
+      enum: [...testimonialSourceTypeSchema.options]
     },
     "rating-min": { type: "number", description: "Minimum star rating (1-5)", required: false },
     "rating-max": { type: "number", description: "Maximum star rating (1-5)", required: false },
@@ -97690,7 +97743,11 @@ var searchCommand4 = defineCommand257({
   args: {
     query: { type: "positional", description: "Search query text", required: false },
     limit: { type: "string", description: "Max results (default 10)", required: false },
-    source: { type: "string", description: "Filter by source: google|trustpilot", required: false },
+    source: {
+      type: "string",
+      description: `Filter by source: ${testimonialSourceTypeSchema.options.join("|")}`,
+      required: false
+    },
     "rating-min": { type: "string", description: "Minimum star rating (1-5)", required: false },
     "rating-max": { type: "string", description: "Maximum star rating (1-5)", required: false },
     status: { type: "string", description: "Filter by status: pending|processing|ready|error", required: false },
@@ -97742,14 +97799,276 @@ var searchCommand4 = defineCommand257({
   }
 });
 
+// src/commands/testimonials/sources/index.ts
+import { defineCommand as defineCommand263 } from "citty";
+
+// src/commands/testimonials/sources/add.ts
+import { defineCommand as defineCommand258 } from "citty";
+
+// src/commands/testimonials/sources/shared.ts
+function reportError3(err) {
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+function reportInvalid(issue) {
+  writeJson({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: issue ? `${issue.path.map(String).join(".") || "input"}: ${issue.message}` : "Invalid request"
+    }
+  });
+  process.exit(1);
+}
+function compactSource2(source) {
+  return {
+    id: source.id,
+    platform: source.platform,
+    label: source.label,
+    ...source.pageUrl ? { url: source.pageUrl } : {},
+    status: source.status,
+    reviews: source.reviews,
+    autoSync: source.refreshInterval,
+    ...source.lastSyncedAt ? { lastSyncedAt: new Date(source.lastSyncedAt).toISOString() } : {},
+    ...source.error ? { error: source.error } : {}
+  };
+}
+
+// src/commands/testimonials/sources/add.ts
+var SITES = testimonialSourceTypeSchema.options.join("|");
+registerSchema({
+  command: "testimonials.sources.add",
+  description: "Add a review page as a testimonial source \u2014 Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store or Google Play. Pass the page's link (it names its own site), or a business name for Google Maps. Its reviews (up to 700) are imported, tagged and made searchable in the background over the next minutes. Each imported review costs a little, so add only the client's own listings the user asked for. Applies immediately and shows on the chat as an already-applied change. Adding a listing that is already a source is a no-op that starts a fresh import.",
+  args: {
+    input: {
+      type: "string",
+      description: "The review page's link, or a business name (Google Maps only)",
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: `Only to force a site: ${SITES}. A bare domain with trustpilot is that company's Trustpilot page.`,
+      required: false
+    },
+    every: {
+      type: "string",
+      description: `Auto-sync cadence: ${testimonialSourceRefreshIntervalSchema.options.join("|")} (default never)`,
+      required: false
+    }
+  }
+});
+function addSourceHints(input, { created, source }) {
+  const hints2 = [
+    created ? `Added ${source.label} on ${source.platformLabel}. Its reviews are importing in the background \u2014 they become searchable with \`baker testimonials search\` as each one is analysed, usually within a few minutes. Don't wait on them in this turn; check with \`baker testimonials sources list\`.` : `${source.label} on ${source.platformLabel} was already a source; a fresh import was started if one wasn't running.`
+  ];
+  if (created && source.platform === "google" && !/^https?:\/\/|\.[a-z]{2,}\//i.test(input.trim())) {
+    hints2.push(
+      `Matched the name to ${source.label} on Google Maps (${source.pageUrl ?? "no link"}). If that is not the client's business, run \`baker testimonials sources remove ${source.id}\` at once and add the listing's Google Maps link instead.`
+    );
+  }
+  if (source.refreshInterval === "never") {
+    hints2.push(
+      `Auto-sync is off. If the user wants new reviews to keep arriving: \`baker testimonials sources schedule ${source.id} --every monthly\`.`
+    );
+  }
+  return hints2;
+}
+var addCommand4 = defineCommand258({
+  meta: {
+    name: "add",
+    description: `Add a review page as a testimonial source. Start here with the page's link; for Google Maps a business name also works.
+
+Examples:
+  baker testimonials sources add https://www.yelp.com/biz/acme-bakery-madrid
+  baker testimonials sources add https://www.g2.com/products/acme --every monthly
+  baker testimonials sources add "Acme Bakery Madrid"          # Google Maps, found by name
+  baker testimonials sources add acme.com --platform trustpilot`
+  },
+  args: {
+    input: { type: "positional", description: "Review page link, or a business name for Google Maps", required: true },
+    platform: { type: "string", description: `Force a site: ${SITES}`, required: false },
+    every: { type: "string", description: "Auto-sync: never|daily|weekly|monthly", required: false }
+  },
+  run: async ({ args: args8 }) => {
+    const parsed = testimonialSourcesAddRequestSchema.safeParse({
+      input: String(args8.input ?? ""),
+      platform: args8.platform ? String(args8.platform).toLowerCase().replace(/[\s-]/g, "_") : void 0,
+      every: args8.every ? String(args8.every).toLowerCase() : void 0
+    });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/add", parsed.data, {
+        timeoutMs: 12e4
+      });
+      const hints2 = addSourceHints(parsed.data.input, data);
+      writeJson({ ok: true, data: { created: data.created, source: compactSource2(data.source) }, hints: hints2 });
+    } catch (err) {
+      reportError3(err);
+    }
+  }
+});
+
+// src/commands/testimonials/sources/list.ts
+import { defineCommand as defineCommand259 } from "citty";
+registerSchema({
+  command: "testimonials.sources.list",
+  description: "List the review pages feeding the testimonials library: each one's id, site, import status and how many reviews it has brought in.",
+  args: {}
+});
+function listSourceHints(sources) {
+  if (sources.length === 0) {
+    return [
+      "No review sources yet. If the client has a public review page (Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store, Google Play), add it with `baker testimonials sources add <link>`."
+    ];
+  }
+  const hints2 = sources.filter((source) => source.status === "error").map(
+    (source) => `${source.label} on ${source.platformLabel} did not import: ${source.error ?? "the last import failed"} Retry once with \`baker testimonials sources sync ${source.id}\`; if it fails again, tell the user in plain words and carry on with the other sources.`
+  );
+  if (sources.some((source) => source.status === "importing")) {
+    hints2.push("Some sources are still importing \u2014 their review counts will grow over the next minutes.");
+  }
+  return hints2;
+}
+var listCommand23 = defineCommand259({
+  meta: {
+    name: "list",
+    description: "List testimonial sources (id, site, import status, reviews imported).\n\nExample: baker testimonials sources list"
+  },
+  args: {},
+  run: async () => {
+    try {
+      const sources = await apiGet("/api/testimonials/sources/list");
+      const hints2 = listSourceHints(sources);
+      writeJson({ ok: true, data: sources.map(compactSource2), hints: hints2.length > 0 ? hints2 : void 0 });
+    } catch (err) {
+      reportError3(err);
+    }
+  }
+});
+
+// src/commands/testimonials/sources/remove.ts
+import { defineCommand as defineCommand260 } from "citty";
+registerSchema({
+  command: "testimonials.sources.remove",
+  description: "Remove a review source AND every testimonial it imported (and their pictures). Applies immediately and cannot be undone \u2014 only when the user asked for it.",
+  args: { id: { type: "string", description: "Source id from `testimonials sources list`", required: true } }
+});
+var removeCommand8 = defineCommand260({
+  meta: {
+    name: "remove",
+    description: "Remove a review source and all its testimonials (cannot be undone).\n\nExample: baker testimonials sources remove <source-id>"
+  },
+  args: { id: { type: "positional", description: "Source id from `testimonials sources list`", required: true } },
+  run: async ({ args: args8 }) => {
+    const parsed = testimonialSourcesRemoveRequestSchema.safeParse({ id: String(args8.id ?? "") });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/remove", parsed.data);
+      writeJson({ ok: true, data });
+    } catch (err) {
+      reportError3(err);
+    }
+  }
+});
+
+// src/commands/testimonials/sources/schedule.ts
+import { defineCommand as defineCommand261 } from "citty";
+var INTERVALS = testimonialSourceRefreshIntervalSchema.options.join("|");
+registerSchema({
+  command: "testimonials.sources.schedule",
+  description: "Set how often a review source imports its new reviews on its own.",
+  args: {
+    id: { type: "string", description: "Source id from `testimonials sources list`", required: true },
+    every: { type: "string", description: `Auto-sync cadence: ${INTERVALS}`, required: true }
+  }
+});
+var scheduleCommand2 = defineCommand261({
+  meta: {
+    name: "schedule",
+    description: "Set a review source's auto-sync cadence.\n\nExample: baker testimonials sources schedule <source-id> --every monthly"
+  },
+  args: {
+    id: { type: "positional", description: "Source id from `testimonials sources list`", required: true },
+    every: { type: "string", description: INTERVALS, required: true }
+  },
+  run: async ({ args: args8 }) => {
+    const parsed = testimonialSourcesScheduleRequestSchema.safeParse({
+      id: String(args8.id ?? ""),
+      every: String(args8.every ?? "").toLowerCase()
+    });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/schedule", parsed.data);
+      writeJson({ ok: true, data: { id: data.id, autoSync: parsed.data.every } });
+    } catch (err) {
+      reportError3(err);
+    }
+  }
+});
+
+// src/commands/testimonials/sources/sync.ts
+import { defineCommand as defineCommand262 } from "citty";
+registerSchema({
+  command: "testimonials.sources.sync",
+  description: "Import a review source's new reviews now. Only reviews newer than the last import are read where the site allows it.",
+  args: { id: { type: "string", description: "Source id from `testimonials sources list`", required: true } }
+});
+var syncCommand2 = defineCommand262({
+  meta: {
+    name: "sync",
+    description: "Import a review source's new reviews now.\n\nExample: baker testimonials sources sync <source-id>"
+  },
+  args: { id: { type: "positional", description: "Source id from `testimonials sources list`", required: true } },
+  run: async ({ args: args8 }) => {
+    const parsed = testimonialSourcesSyncRequestSchema.safeParse({ id: String(args8.id ?? "") });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/sync", parsed.data);
+      writeJson({
+        ok: true,
+        data,
+        hints: data.started ? void 0 : ["An import was already running for this source; nothing new was started."]
+      });
+    } catch (err) {
+      reportError3(err);
+    }
+  }
+});
+
+// src/commands/testimonials/sources/index.ts
+var sourcesCommand2 = defineCommand263({
+  meta: {
+    name: "sources",
+    description: `The review pages the testimonials come from: Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store, Google Play. Subcommands: add, list, sync, schedule, remove.
+
+Examples:
+  baker testimonials sources add https://www.trustpilot.com/review/acme.com
+  baker testimonials sources list
+  baker testimonials sources sync <source-id>
+  baker testimonials sources schedule <source-id> --every monthly
+  baker testimonials sources remove <source-id>`
+  },
+  subCommands: {
+    add: addCommand4,
+    list: listCommand23,
+    sync: syncCommand2,
+    schedule: scheduleCommand2,
+    remove: removeCommand8
+  }
+});
+
 // src/commands/testimonials/tags.ts
 var tagsCommand5 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand258({
+var testimonialsCommand = defineCommand264({
   meta: {
     name: "testimonials",
-    description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
+    description: `Find and browse testimonials in Baker, and manage the review pages they come from. Subcommands: search, get, list, tags, sources.
 
 Examples:
   baker testimonials search "great customer service" --limit 5
@@ -97757,21 +98076,23 @@ Examples:
   baker testimonials get <testimonial-id>
   baker testimonials list --source google --sentiment positive
   baker testimonials tags
+  baker testimonials sources add https://www.yelp.com/biz/acme-bakery-madrid
 Full guide: __tooling__/docs/tools/baker/testimonials.md`
   },
   subCommands: {
     get: getCommand6,
     search: searchCommand4,
     list: listCommand22,
-    tags: tagsCommand5
+    tags: tagsCommand5,
+    sources: sourcesCommand2
   }
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand267 } from "citty";
+import { defineCommand as defineCommand273 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand259 } from "citty";
+import { defineCommand as defineCommand265 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -97785,7 +98106,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand4 = defineCommand259({
+var deleteCommand4 = defineCommand265({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -97826,7 +98147,7 @@ var deleteCommand4 = defineCommand259({
 });
 
 // src/commands/videos/describe.ts
-import { defineCommand as defineCommand260 } from "citty";
+import { defineCommand as defineCommand266 } from "citty";
 var DESCRIPTION_HELP2 = "What the clip actually shows, in the words someone would search for it by. This is what `baker videos search` retrieves on.";
 registerSchema({
   command: "videos.describe",
@@ -97843,7 +98164,7 @@ registerSchema({
     full: { type: "boolean", description: "Return the whole library row, not just what changed", required: false }
   }
 });
-var describeCommand2 = defineCommand260({
+var describeCommand2 = defineCommand266({
   meta: {
     name: "describe",
     description: `Correct what the library says a video is. Only the fields you pass change; the rest keep their current values.
@@ -97905,7 +98226,7 @@ import { constants } from "fs";
 import { copyFile as copyFile2, mkdir as mkdir17, mkdtemp as mkdtemp3, rm as rm10 } from "fs/promises";
 import { tmpdir as tmpdir4 } from "os";
 import path56 from "path";
-import { defineCommand as defineCommand261 } from "citty";
+import { defineCommand as defineCommand267 } from "citty";
 
 // src/commands/videos/videoPlatforms.ts
 var PLATFORM_DOMAINS = {
@@ -98043,7 +98364,7 @@ function positiveInt(value2) {
   const parsed = typeof value2 === "string" ? Number.parseInt(value2, 10) : Number.NaN;
   return Number.isInteger(parsed) && parsed > 0 ? parsed : void 0;
 }
-var fetchCommand2 = defineCommand261({
+var fetchCommand2 = defineCommand267({
   meta: {
     name: "fetch",
     description: "Download a video page to a local .mp4 without adding it to the library. Same downloader as `ingest` (proxy fallback, duration check).\n\nExample: baker videos fetch https://www.youtube.com/watch?v=abc123 --out ./clips"
@@ -98129,7 +98450,7 @@ async function placeInto(outDir, source, stem) {
 }
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand262 } from "citty";
+import { defineCommand as defineCommand268 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -98137,7 +98458,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand7 = defineCommand262({
+var getCommand7 = defineCommand268({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -98174,7 +98495,7 @@ var getCommand7 = defineCommand262({
 });
 
 // src/commands/videos/group.ts
-import { defineCommand as defineCommand263 } from "citty";
+import { defineCommand as defineCommand269 } from "citty";
 registerSchema({
   command: "videos.group",
   description: "List every clip and image that arrived in the same set as this video (carousel slides, one page)",
@@ -98183,7 +98504,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand2 = defineCommand263({
+var groupCommand2 = defineCommand269({
   meta: {
     name: "group",
     description: "List every asset that arrived in the same set as this clip \u2014 the other slides of the Instagram post it came from, stills included. A carousel is authored to be read in order, so a clip pulled out of one is usually missing half its meaning. Example: baker videos group <videoId>"
@@ -98206,7 +98527,7 @@ var groupCommand2 = defineCommand263({
 import { mkdtemp as mkdtemp4, rm as rm11, stat as stat12 } from "fs/promises";
 import { tmpdir as tmpdir5 } from "os";
 import path57 from "path";
-import { defineCommand as defineCommand264 } from "citty";
+import { defineCommand as defineCommand270 } from "citty";
 
 // src/lib/streamUpload.ts
 import { createHash as createHash3 } from "crypto";
@@ -98259,7 +98580,7 @@ registerSchema({
     "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
   }
 });
-var ingestCommand2 = defineCommand264({
+var ingestCommand2 = defineCommand270({
   meta: {
     name: "ingest",
     description: "Add a video to the library from a URL. A direct file URL is handed straight to Baker, which fetches it. A page URL (YouTube, TikTok, Vimeo, Instagram) is downloaded here first, then uploaded \u2014 and a direct URL that Baker cannot fetch falls back to that same path automatically.\n\nExample: baker videos ingest https://www.youtube.com/watch?v=abc123"
@@ -98521,7 +98842,7 @@ async function uploadToAssetStore(filePath, sizeBytes) {
 }
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand265 } from "citty";
+import { defineCommand as defineCommand271 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -98547,7 +98868,7 @@ function searchHints(results) {
   }
   return hints2.length > 0 ? hints2 : void 0;
 }
-var searchCommand5 = defineCommand265({
+var searchCommand5 = defineCommand271({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -98599,7 +98920,7 @@ var tagsCommand6 = makeTagsCommand("videos", "video", "/api/videos/tags");
 // src/commands/videos/upload.ts
 import { stat as stat13 } from "fs/promises";
 import { basename as basename4 } from "path";
-import { defineCommand as defineCommand266 } from "citty";
+import { defineCommand as defineCommand272 } from "citty";
 registerSchema({
   command: "videos.upload",
   description: "Upload a video to Baker \u2014 a local file (via Mux direct upload) or a remote http(s) URL.",
@@ -98626,7 +98947,7 @@ registerSchema({
 function isRemoteUrl3(value2) {
   return /^https?:\/\//i.test(value2);
 }
-var uploadCommand2 = defineCommand266({
+var uploadCommand2 = defineCommand272({
   meta: {
     name: "upload",
     description: "Upload a video to Baker \u2014 accepts a local file path OR a remote http(s) URL.\n\nLocal: auto-detects content type and uploads via Mux direct upload.\nRemote: hands off to `videos ingest` (direct fetch, or download-then-upload for a YouTube/TikTok/Vimeo page).\n\nExamples:\n  baker videos upload ./demo.mp4\n  baker videos upload https://www.youtube.com/watch?v=abc123"
@@ -98695,7 +99016,7 @@ var uploadCommand2 = defineCommand266({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand267({
+var videosCommand = defineCommand273({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, fetch, describe, delete, tags.
@@ -98726,10 +99047,10 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand278 } from "citty";
+import { defineCommand as defineCommand284 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand268 } from "citty";
+import { defineCommand as defineCommand274 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList4(value2) {
@@ -98738,7 +99059,7 @@ function splitList4(value2) {
   }
   return value2.split(",").map((v) => v.trim()).filter(Boolean);
 }
-function reportError3(err) {
+function reportError4(err) {
   if (err instanceof ApiError) {
     writeJson({ ok: false, error: { code: err.code, message: err.message } });
     process.exit(1);
@@ -98782,7 +99103,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand268({
+var advertisersCommand2 = defineCommand274({
   meta: {
     name: "advertisers",
     description: 'List corpus advertisers by name or domain. Find your own advertiser for --exclude-advertiser, or a competitor for --advertiser-id / winners. Example: baker winning-ads advertisers "Deel" --output md'
@@ -98834,13 +99155,13 @@ var advertisersCommand2 = defineCommand268({
         advertiserNormalizer
       );
     } catch (err) {
-      reportError3(err);
+      reportError4(err);
     }
   }
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand269 } from "citty";
+import { defineCommand as defineCommand275 } from "citty";
 registerSchema({
   command: "winning-ads.content",
   description: "Read what's INSIDE one winning ad: the spoken transcript, the on-screen text, and the ad copy. Use this after `search`/`winners`/`feed` return a shortlist \u2014 pass an ad_id to understand a reference before reproducing it. Static and carousel ads return the text drawn into the image with the job each piece does (headline, benefit, cta\u2026), the card it sits on, and their format_pattern. Add --full for how it is built (composition, colours, CTA, markers), how it persuades (awareness, mechanism, pains, desires, proof, objections), what it offers (offer type, price, guarantee, urgency), plus speech, pacing and soundtrack for video.",
@@ -98853,7 +99174,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand269({
+var contentCommand = defineCommand275({
   meta: {
     name: "content",
     description: "Read the transcript + on-screen text + copy of one winning ad; --full adds its build, persuasion and offer. Example: baker winning-ads content adg_123 --platform meta --full --output md"
@@ -98896,13 +99217,13 @@ var contentCommand = defineCommand269({
         adContentNormalizer
       );
     } catch (err) {
-      reportError3(err);
+      reportError4(err);
     }
   }
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand270 } from "citty";
+import { defineCommand as defineCommand276 } from "citty";
 function buildFeedParams(input) {
   const params = {};
   const advertiser = splitList4(input.advertiser);
@@ -98954,7 +99275,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand2 = defineCommand270({
+var feedCommand2 = defineCommand276({
   meta: {
     name: "feed",
     description: "Winners across every brand you follow (browse, then trim per advertiser). Example: baker winning-ads feed --per-advertiser 5 --output md"
@@ -99033,13 +99354,13 @@ var feedCommand2 = defineCommand270({
 `);
       }
     } catch (err) {
-      reportError3(err);
+      reportError4(err);
     }
   }
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand271 } from "citty";
+import { defineCommand as defineCommand277 } from "citty";
 var PLATFORMS = adLibraryPlatformSchema.options;
 registerSchema({
   command: "winning-ads.follow",
@@ -99054,7 +99375,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand271({
+var followCommand = defineCommand277({
   meta: {
     name: "follow",
     description: 'Follow a brand to track ALL its ads \u2014 every platform and country. --platform is how we read your input, not a limit. A domain tracks every platform we can resolve. Example: baker winning-ads follow "deel.com" --platform meta'
@@ -99095,13 +99416,13 @@ var followCommand = defineCommand271({
       }
       writeJson({ ok: true, data, hints: hints2 });
     } catch (err) {
-      reportError3(err);
+      reportError4(err);
     }
   }
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand272 } from "citty";
+import { defineCommand as defineCommand278 } from "citty";
 var PLATFORMS2 = adLibraryPlatformSchema.options;
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -99134,7 +99455,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand272({
+var followCompetitorsCommand = defineCommand278({
   meta: {
     name: "follow-competitors",
     description: 'Follow many brands at once by domain \u2014 add every competitor in one call. Example: baker winning-ads follow-competitors "deel.com,notion.so,hubspot.com"'
@@ -99203,13 +99524,13 @@ var followCompetitorsCommand = defineCommand272({
       }
       writeJson({ ok: true, data, hints: hints2.length > 0 ? hints2 : void 0 });
     } catch (err) {
-      reportError3(err);
+      reportError4(err);
     }
   }
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand273 } from "citty";
+import { defineCommand as defineCommand279 } from "citty";
 registerSchema({
   command: "winning-ads.following",
   description: "List the brands you follow in your ad-dna library, with each one's status (ready vs still adding) and cached ad counts. A brand still adding has counts that are a lie in progress; one with `discovery_failed` has counts that are short because we couldn't finish looking, which is not the same as it running no ads.",
@@ -99263,7 +99584,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand273({
+var followingCommand = defineCommand279({
   meta: {
     name: "following",
     description: "List brands you follow, with status (ready / adding\u2026) and cached counts. A brand's counts are only final once it is ready. Example: baker winning-ads following --output md"
@@ -99293,13 +99614,13 @@ var followingCommand = defineCommand273({
         followingNormalizer
       );
     } catch (err) {
-      reportError3(err);
+      reportError4(err);
     }
   }
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand274 } from "citty";
+import { defineCommand as defineCommand280 } from "citty";
 registerSchema({
   command: "winning-ads.search",
   description: "Search the ad-dna corpus of scored winning ads, the company's followed brands first. Returns a lean shortlist (advertiser, summary, scores, days_active/active/winner_category as proof, media_url, and visual/container/mechanism when known) to pick a reference to reproduce. Each search is a paid reranker + judge call: one strong search, at most one adjusted retry. A value outside a closed list (--platform, --format, --winner-category, --awareness, --format-pattern, --sort) is refused with error.fix.validValues.",
@@ -99485,7 +99806,7 @@ function reportSearchError(err) {
     writeJson({ ok: false, error: { code: err.code, message: err.message, fix } });
     process.exit(1);
   }
-  reportError3(err);
+  reportError4(err);
 }
 var FLAG_FOR_FIELD = {
   limit: "--limit",
@@ -99577,7 +99898,7 @@ function writeSearchResult(data, opts) {
   writeOutput({ ok: true, data: rawResults, ...withHints2 }, opts.output, opts.fields, opts.full, winningAdNormalizer);
 }
 var SEARCH_TIMEOUT_MS = 12e4;
-var searchCommand6 = defineCommand274({
+var searchCommand6 = defineCommand280({
   meta: {
     name: "search",
     description: "Search winning reference ads, the company's followed brands first. Start here: baker winning-ads search 'B2B SaaS before/after AI automation' --platform meta --format static --exclude-advertiser adv_123 --output md. A set of references for N concepts in one call: add --diverse --limit N. The best proven ad in one container from any category: --format-pattern comparison_table (no query needed; add --sort longest_running to order by staying power). Each search is a paid reranker + judge call: one strong search, at most one adjusted retry."
@@ -99703,7 +100024,7 @@ var searchCommand6 = defineCommand274({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand275 } from "citty";
+import { defineCommand as defineCommand281 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -99731,7 +100052,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand275({
+  return defineCommand281({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -99758,7 +100079,7 @@ function makeSeedCommand(opts) {
         }
         writeOutput({ ok: true, data: projected }, output);
       } catch (err) {
-        reportError3(err);
+        reportError4(err);
       }
     }
   });
@@ -99780,7 +100101,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand276 } from "citty";
+import { defineCommand as defineCommand282 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -99788,7 +100109,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand276({
+var unfollowCommand = defineCommand282({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -99803,13 +100124,13 @@ var unfollowCommand = defineCommand276({
       });
       writeJson({ ok: true, data });
     } catch (err) {
-      reportError3(err);
+      reportError4(err);
     }
   }
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand277 } from "citty";
+import { defineCommand as defineCommand283 } from "citty";
 registerSchema({
   command: "winning-ads.winners",
   description: "Top winning ads for one advertiser id (from `advertisers` or `following`). Returns lean winner cards; add --full for DNA + longevity.",
@@ -99819,7 +100140,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin|tiktok", required: false }
   }
 });
-var winnersCommand = defineCommand277({
+var winnersCommand = defineCommand283({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -99863,13 +100184,13 @@ var winnersCommand = defineCommand277({
         winningAdNormalizer
       );
     } catch (err) {
-      reportError3(err);
+      reportError4(err);
     }
   }
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand278({
+var winningAdsCommand = defineCommand284({
   meta: {
     name: "winning-ads",
     description: `Search the ad-dna corpus of scored "winning" ads for reference creatives to reproduce, and manage the brands your library tracks. Proxied through the Baker backend (BAKER_API_KEY) \u2014 no separate token needed.
@@ -99937,7 +100258,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand279({
+var main = defineCommand285({
   meta: {
     name: "baker",
     version: getCliVersion(),