@koda-sl/baker-cli 0.434.0-dev.ec5c827fe → 0.435.0

package/README.md

@@ -621,6 +621,18 @@ baker ads google campaigns create --customer-id 1234567890 --name "Brand — Sea
 # New campaigns are declared as NOT containing EU political advertising (Google requires the
 # declaration on every create); pass --eu-political-ads only when the campaign does contain it.
 # On update, --eu-political-ads / --eu-political-ads=false corrects an existing declaration.
+# Text guidelines (AI Max Search and Performance Max) stage on update only:
+baker ads google campaigns update <campaign-id> --customer-id 1234567890 \
+  --term-exclusion "cheap" --messaging-restriction "Never promise a delivery date"
+# --term-exclusion (repeatable, up to 25 × 30 chars) and --messaging-restriction (repeatable,
+# up to 40 × 300 chars) each REPLACE the campaign's list; --clear-term-exclusions /
+# --clear-messaging-restrictions empty one. A Search campaign needs AI Max with text
+# customization on (in the same update or before), or staging is refused with the reason.
+# AI Max for Search stages on create and update: --ai-max / --ai-max=false (off turns both
+# features off too), --ai-max-text (text customization, needs AI Max) and
+# --ai-max-url-expansion (final URL expansion, needs text customization). An omitted switch
+# keeps the campaign's value; a combination Google refuses is refused at staging.
+baker ads google campaigns update <campaign-id> --customer-id 1234567890 --ai-max --ai-max-text
 baker ads google ad-groups create --customer-id 1234567890 --name "Brand terms" --campaign-ref g_temp_<campaign>
 baker ads google keywords add --customer-id 1234567890 --ad-group-ref g_temp_<adgroup> --text "brand name" --match-type EXACT
 # Shared negative keyword list → attach to the campaign
@@ -1834,7 +1846,7 @@ Ads start from what customers said. Three commands carry the process; the agent
 ```bash
 baker creatives brief [--adset <id>] [--account-id act_<id>] [--no-research]   # one read: viewer, account bottleneck, what works, taste, customer quotes, ideas on file
 baker creatives ideas [--full]                                 # check and rank src/creatives/_ideas/*.md; build_next
-baker creatives make <idea> [--slug <s>] [--adset <id>] [--reference <adId>] [--spec <beats.json>] [--from-idea] [--series <lead>]
+baker creatives make <idea> [--slug <s>] [--adset <id>] [--reference <adId>] [--spec <beats.json>] [--from-idea]
 baker creatives learn [--days <n>] [--dry-run]                 # what each idea's ads did, written back onto the idea
 ```
 
@@ -1842,7 +1854,6 @@ baker creatives learn [--days <n>] [--dry-run]                 # what each idea'
 - `ideas` is free and local. An idea's `evidence` resolves to `src/content/insights/` entries, or it is an `explore` bet. Numbers must be in the Knowledge or our own customers' quotes (a Reddit, forum or web quote never sources a claim), no two ideas may share an angle and format, and a review or testimonial format needs a quote from our own customer.
 - `learn` pools each built idea's creatives, judges them against the rest of the account's cost per result and writes `status` (`winner`, `failed`, `inconclusive`, `testing`) and a frozen `result` onto the idea. `ideas` then warns when a new idea repeats a failed one.
 - `make` builds one idea. A static searches the idea's container for ads made for our viewer, checks the closest three with `winning-ads fit` and scaffolds from the first that fits. For a new creative it starts scaffolding the best-ranked one while the fits are asked (kept when it fits, stopped and removed whole when another or none is kept), so the reference's describe pass no longer waits for them. Finding and describing a reference gets 50 seconds; past that the build is stopped and the static starts from the idea (`REFERENCE_SLOW` in the hint). A creative whose ad is already written is never built over (`ALREADY_MADE`): edit its `prompt.json`, or pass `--slug` for another ad of the same idea. A video idea takes its beats spec. Either way it records the idea on `_definition.md`, sets `prompt.json`'s `message` and syncs the definition. Drafted copy lines claiming a figure the company never wrote come back first in `hints`. When no proven ad fits (or with `--from-idea`), a static starts from the idea itself: `prompt.json` holds the message and placeholders, and `canvas run` refuses to render until the scene and copy are written.
-- `make --series <lead>` makes a static idea as another ad of a series: several messages in one style. Nothing is searched or rendered; the ad's `_definition.md` names its lead (`series: <lead>`), its `prompt.json` starts as the lead's ready version with the idea's message, and only its `copy` is written. Its canvas is written from the lead's on every run: the lead's finished picture with this ad's words, every other size the lead's own size with the same words. `baker canvas run --series <lead>` renders every ad of the series at once, one reviewed and corrected run each, skipping an ad already ready from the lead's current version.
 
 ### Competitive Intelligence (`baker research`)
 
@@ -6591,7 +6602,7 @@ import {
 
 ## Creatives
 
-Save a finished canvas render as a Baker creative: a static image (PNG, JPG, WebP) or a finished video (MP4, MOV, WebM). Choose and save the best finished version without waiting for the user to choose, including in the turn that rendered it. Saving pins the version as the agent's choice without recording user approval or putting an ad live. An image uploads to the Baker image library (tagged `creative`); a video uploads to the Baker video library and is saved once it plays (bounded at 3 minutes). A creative record is created/updated, and the command prints the creative reference JSON the dashboard renders in chat.
+Publish an approved canvas render as a first-class Baker creative: a static image (PNG, JPG, WebP) or a finished video (MP4, MOV, WebM). An image uploads to the Baker image library (tagged `creative`); a video uploads to the Baker video library and is saved once it plays (bounded at 3 minutes). A creative record is created/updated, and the command prints the creative reference JSON the dashboard renders in chat.
 
 ```bash
 baker creatives publish --title "Spring Offer 4x5" \
@@ -6609,8 +6620,9 @@ baker creatives publish ./canvas/<run_id>/final.mp4 --title "Spring Offer Reel"
 | `<file>` | The image or video. For an image it is optional with `--run-id`: the run's own saved output (from its run record, sha-verified) is used instead, so a workspace that never had the run's folder can publish it. |
 | `--title <text>` | Required. Human title for the creative. |
 | `--slug <slug>` | Creative slug (`src/creatives/<slug>/`): attaches the image or video to that creative's row, marks it `published`. Required for a video. With `--run-id` an image publish also sets `status: published` in the creative's `_definition.md` (`definitionStatus` in the output). |
-| `--run-id <r_…>` | Pins the finished generation from the creative's run history as the saved one. |
+| `--run-id <r_…>` | Pins the approved generation from the creative's run history as the published one. |
 | `--output <label\|slot\|n>` | With `--run-id` and no file: which of the run's images to save when it made several (a label such as `4:5`, a slot, or a 1-based number). |
+| `--approved` | The person's own message asked to save it. Needed only for an image run rendered in the current chat turn (`BAKER_TURN_ID`), which they have not seen yet; without it that save is refused. |
 | `--source-reference-url <url>` | Original reference ad URL, recorded on the creative. |
 | `--context <text>` | Optional describe context for the uploaded image or video. |
 
@@ -6672,7 +6684,7 @@ After a rejection, `hints[]` restates what to change, starting from that version
 
 ### `baker creatives select`
 
-Record the user's choice of a creative version, or only some of its options, the way choosing it in Baker does: the creative shows that version as the chosen one, and the choice records the chat sender's approval (`source: "selection"`). Naming options replaces the earlier pick. It does not add the image to the library; that is `baker creatives publish`, which pins the agent's saved version without recording user approval. Use `select` only for a choice the user actually made; autonomous saving uses `publish`.
+Choose the version of a creative to keep, or only some of its options, the way choosing it in Baker does: the creative shows that version as the chosen one, and the choice records the chat sender's approval (`source: "selection"`). Naming options replaces the earlier pick. It does not add the image to the library; that is `baker creatives publish`, which, given `--run-id`, also counts as choosing that version.
 
 ```bash
 baker creatives select --slug spring-offer                      # the version it shows now

package/dist/{chunk-7I73A72J.js → chunk-6PP3MBGZ.js}

@@ -24,9 +24,9 @@ import {
   shouldEscalate
 } from "./chunk-F7LXMR73.js";
 
-// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js
+// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js
 var require_safe_stable_stringify = __commonJS({
-  "../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js"(exports, module) {
+  "../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js"(exports, module) {
     "use strict";
     var { hasOwnProperty } = Object.prototype;
     var stringify = configure2();
@@ -1408,7 +1408,7 @@ function resolveAdaptFormats(params) {
   return params.formats ?? [];
 }
 
-// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/esm/wrapper.js
+// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/esm/wrapper.js
 var import__ = __toESM(require_safe_stable_stringify(), 1);
 var configure = import__.default.configure;
 var wrapper_default = import__.default;
@@ -4398,15 +4398,7 @@ var CanvasMetadata = z4.object({
   // `scaffold-video`) so the editable checklist travels inside the canvas
   // instead of only printing to stdout. Ignored by the engine.
   todo: z4.unknown().optional(),
-  video: VideoMeta,
-  // A static ad of a series (`seriesMemberAd`): the lead ad its picture is an edit of, the
-  // lead's version, and the lead's words as that version drew them, which this ad's replace.
-  // Ignored by the engine; the brief projection reads it.
-  series: z4.object({
-    lead: z4.string().min(1),
-    run_id: z4.string().min(1),
-    copy: z4.array(z4.object({ text: z4.string(), role: z4.string().optional() }).strict())
-  }).strict().optional()
+  video: VideoMeta
 }).strict().optional();
 var CanvasSchema = z4.object({
   schema: z4.literal("baker-canvas/1"),
@@ -7472,7 +7464,7 @@ function pictureInstruction(p, ctx) {
   const keep = p.spec?.keep ? ` Keep ${plain(p.spec.keep, ctx.clean)}.` : "";
   switch (p.role) {
     case "base":
-      return ctx.job === "fix" ? "the current version of this ad, to edit." : ctx.job === "series" ? "the finished ad this series repeats, to copy exactly with new words." : "the finished ad, to re-lay for this shape.";
+      return ctx.job === "fix" ? "the current version of this ad, to edit." : "the finished ad, to re-lay for this shape.";
     case "identity":
       return identityInstruction(p, what, keep, ctx.flowing);
     // The user saw one label come back two ways (E4 gallery, BENCH.md § "E1 v2"): the label is the product's.
@@ -7851,10 +7843,6 @@ function deliverableSection(c) {
     const change = sentence(c.opts.instruction?.trim() || "correct what is wrong");
     return c.flowing ? `Image 1 is the current version of this ad. ${capitalize(change)} Keep everything else in Image 1 exactly the same, preserving its picture, layout, colours, lettering and every word.` : `Edit: Image 1 is the current version of this ad. ${capitalize(change)} Keep everything else exactly as it is in Image 1: the picture, the layout, the colours, the lettering and every word.`;
   }
-  if (c.job === "series") {
-    const change = sentence(c.opts.instruction?.trim() || "set the new words");
-    return c.flowing ? `Image 1 is a finished ad of this series. Make the next ad of the same series${forBrand}: ${change} Keep everything else in Image 1 exactly the same, preserving its picture, layout, background, shapes, colours, lettering style and logo, each word in the place and style of the one it replaces.` : `Edit: Image 1 is a finished ad of this series. Make the next ad of the same series${forBrand}. ${capitalize(change)} Keep everything else exactly as it is in Image 1: the picture, the layout, the background, the shapes, the colours, the lettering style and the logo, each new line in the place, size and style of the line it replaces.`;
-  }
   if (c.job === "relay") {
     return c.flowing ? `Image 1 is a finished ad. Recompose this same ad as a ${noun}${forBrand}: the same picture, colours, lettering and every word, rearranged for the new shape, with more of the scene revealed at the edges.` : `Deliverable: the same ad as Image 1, re-laid as a finished ${noun}${forBrand}. Keep the same picture, colours, lettering and every word, rearranged for the new shape; show more of the scene rather than cropping it.`;
   }
@@ -8525,7 +8513,6 @@ var STATIC_ADAPT_ROLE = "static_adapt";
 var STATIC_SAFE_FIT_ROLE = "static_safe_fit";
 var STATIC_PLACE_ROLE = "static_place";
 var LOGO_COMPOSITE_ROLE = "logo_composite";
-var SERIES_LEAD_ROLE = "series_lead";
 var STATIC_FIX_ROLE = "static_fix";
 var LOGO_COMPOSITE_DEFAULT = false;
 var ADAPT_IMAGE_SIZE = "2K";
@@ -18710,7 +18697,6 @@ export {
   STATIC_SAFE_FIT_ROLE,
   STATIC_PLACE_ROLE,
   LOGO_COMPOSITE_ROLE,
-  SERIES_LEAD_ROLE,
   STATIC_FIX_ROLE,
   LOGO_COMPOSITE_DEFAULT,
   nodesWithRole,
@@ -18772,4 +18758,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-7I73A72J.js.map
+//# sourceMappingURL=chunk-6PP3MBGZ.js.map