@koda-sl/baker-cli 0.447.0-dev.f5788a631 → 0.448.0-dev.0d67e41b9

package/README.md

@@ -723,7 +723,7 @@ Command groups: `budgets`, `campaigns`, `ad-groups`, `keywords` (add/update/remo
 
 **A device criterion can be added, but never removed** — `campaign-criteria add` with a device criterion works, but Google then rejects `campaign-criteria remove` on it forever, including on a criterion you added yourself (and Baker refuses the removal before publish). Adjust it instead with `campaign-criteria update customers/<cid>/campaignCriteria/<campaignId>~<criterionId> --bid-modifier <n>`: `1` for no adjustment, `1.25` to bid 25% more, `0.9` to bid 10% less, `0` to stop serving on that device. Locations, languages and ad schedules remove normally.
 
-**Images on a Search campaign** — `assets create` with an image publishes it into the advertiser's Google Ads asset library, but Google refuses the asset link that puts an image extension on a Search campaign (`AD_IMAGE` and every marketing-image field type, at campaign, ad group and customer level alike), so `assets attach` **skips** it at stage time and names what to do instead — the op is never stored, the rest of a batch stages normally, and the skipped link is what records which images belong on which campaign. Staging an image, or asking to link one the account already holds, therefore also stages a **Task** — "Add N images to <campaign> in Google Ads" — which applies with the rest of the chat, so the one step Google keeps inside its own interface is tracked rather than mentioned. Attach the image to a Performance Max asset group (`asset-groups attach`) and the Task withdraws itself. The one image a Search campaign does take through a link is the advertiser's logo: `BUSINESS_LOGO`, at campaign or customer level, on a verified account.
+**Images on a Search campaign** — `assets create` with an image publishes it into the advertiser's Google Ads asset library, and `assets attach` with field type `AD_IMAGE` (campaign or ad group level) puts it on a Search campaign. Google opens Search image links per advertiser account, so staging asks Google with a check that changes nothing: an account that takes them stages the link, which applies at publish like a sitelink; one that does not — or that Google could not confirm either way — has the link **skipped** — never stored, the rest of a batch stages normally — and a **Task** is staged instead, "Add N images to <campaign> in Google Ads", which applies with the rest of the chat. An image staged with no accepted link raises that Task too, and it withdraws itself once an accepted link (or a Performance Max `asset-groups attach`) names the image. `MARKETING_IMAGE` and its square/portrait variants are Performance Max asset-group slots and are sent back to `AD_IMAGE`. The image must be 1.91:1 or 1:1; another shape is sent back to be cropped. The advertiser's logo links as `BUSINESS_LOGO`, at campaign or customer level, on a verified account.
 
 **Primary vs secondary conversion actions** — `conversions update <id> --primary` makes an action a primary action (automated bidding optimizes toward it); `--no-primary` (or `--primary=false`) demotes it to secondary (reported only) — the spaced form `--primary false` is rejected, since a boolean flag written with a space is set to true and the word dropped. `conversions create` stages a new action as **secondary** unless its `--file` payload sets `"primaryForGoal": true`, so a new action never silently joins the bidding target of a Maximize Conversions or Target CPA campaign. The staged card shows an "Action optimization" row with the before/after role.
 
@@ -1858,7 +1858,7 @@ baker creatives learn [--days <n>] [--dry-run]                 # what each idea'
 - `brief` returns a verdict, not raw numbers: `account.bottleneck` is `hook`, `after_click`, `none` or `too_little_data`. A part that cannot be read says `unavailable`; the market searches (the followed brands, and the library for what COMPANY.md's first line says the company sells, in a few words) run at once and get 12 seconds, so a slow ad library leaves them out rather than holding the brief. With few customer quotes on file it runs `research customers` itself alongside the reads (about 30 s) and returns what it wrote; `--no-research` skips that. With no ideas on file, its hint lists the values `awareness`, `angle` and `format` take. `market` says what competitors' ads already say (the followed brands, else the library), how sophisticated the market is, and which awareness stages nobody speaks to.
 - `ideas` is local and nearly free: two readings of the words go to the decision model (a fraction of a cent, billed with the workspace's next run, answers kept in `canvas/.cache/`). An insight filed as `observed` reads as `interpreted` when its source cannot be opened or its quote is a statistic about people rather than someone's words ("39% de los propietarios…"), and a new idea is warned when its message says what a failed idea said, however reworded or translated. Without an answer, an insight keeps its status and only the same words count as the same message. 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` builds one idea, on a proven winning ad whenever one fits. A static searches the idea's container on the idea's message for our viewer, then for the container's strongest winners from any category (no query, by winner score), pools the candidates (each ad once, the better search first), checks up to six with `winning-ads fit`, three at a time (the next only once one does not fit), and keeps the best-ranked one that fits as soon as it and every better one have answered. The fit says what made that ad a winner, so what the creative carries of it (`reference.carry`: `whole_ad`, `layout`, `hook` or `angle`); make seeds it into `prompt.json` as `concept`, the canvas keeps the ad as its `original` node, and the renders see it for its structure only at `whole_ad` or `layout`. The first hint names the ad and what it carries (for a `--reference` chosen by hand, only the ad: nothing checked what made it win); if the concept could not be written into `prompt.json`, a hint says so and how to write it from the fit already made. 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). Finding, checking and describing a reference gets 150 seconds; past that the build is stopped and the static starts from the idea (`REFERENCE_SLOW`). 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`. Only when no proven ad fits (or with `--from-idea`) does a static start from the idea itself, and the first hint says why (none in the container, what the ones checked won on that the company lacks, the time ran out, or the proven ad it picked could not be read; a `--reference` chosen by hand that cannot be read fails instead): `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.
 - `translate --slug <ad> --to <langs>` makes the ad in other languages as ads of the series it leads: one creative per language or country variant, `<ad>-<lang>` (the BCP-47 tag in lowercase: `-es-mx`), whose `_definition.md` says `series: <ad>` and `language: <lang>` (canonical case, `es-MX`, as the spec's market and the dashboard store it; tags are compared without case) and whose `prompt.json` is the ad's as last drawn with its words translated. Every language is translated in one text call (transcreated, each regional tag in that country's own variety and form of address, `es-MX` and `es-CO` two ads, each line keeping its role and about its length, brand names, prices and numbers kept, a customer's quote and the name on it never translated, and the ad's `message` translated with the lines; the spend is billed with the workspace's next run), or read from `--copy-file`: `{"<lang>": ["line 1", …]}` is every line with no model call, `{"<lang>": {"headline": "…", "3": "…"}}` only the lines given (by role or number), the model writing the rest. `--note` is the agent's brief for the translator (tone, form of address, terms to keep). Each made language lists the lines it `kept` as a customer said them, and the answer warns when the ad's `prompt.json` changed after its last render, since translations are made from the version rendered. The ad may itself be an ad of a series (an angle ad), so angles × languages stay one design. A language already made is left as it is, so adding one later re-renders nothing; `--again` translates it again. Then `baker canvas run --series <ad>` renders them; a new version of the ad reaches every language on the next `--series` run.
 
@@ -3511,8 +3511,10 @@ baker winning-ads fit a_12345 --platform meta
 
 Returns `why_it_wins` in five layers (`disguise`, `voice`, `trigger`, `attention`, `logic`), the `load_bearing`
 elements that carry them (each with what it `needs`, whether the company has it: `have` | `adapt` | `missing`, and
-`ours`, what replaces it), and a `verdict`: `use`, `adapt` or `reject`. The company's Knowledge, reviews and market
-ground the answer. `baker canvas scaffold-static-ad --source-ad-id <adId> --source-platform <platform>` reads the cached
+`ours`, what replaces it), a `verdict`: `use`, `adapt` or `reject`, and what made the ad a winner, so what an ad built
+on it carries (`carry`: `whole_ad`, `layout`, `hook` or `angle`, with `carry_why`; renders see the reference's picture
+only at `whole_ad` or `layout`). The company's Knowledge, reviews and market, and the library's evidence that the ad won
+(its winner category, angle, hook and composition), ground the answer. `baker canvas scaffold-static-ad --source-ad-id <adId> --source-platform <platform>` reads the cached
 answer, writes it into `prompt.json` as `concept`, and refuses a `reject` with `concept_does_not_fit` before anything is
 billed; the hint names the platform the fit was asked on, so a TikTok or LinkedIn reference is read from its own library.
 
@@ -6081,7 +6083,9 @@ The two scaffold passes are billed (the full `video_deconstruct` is the heavy on
 
 Turn a source/inspiration image into a **runnable, self-validated static-ad canvas** — the static counterpart of `scaffold-video`. It runs **billed Gemini passes** up front:
 
-1. **`image_describe`** (`~google/gemini-pro-latest`) — reverse-engineers the image (layout by what fills each region, copy verbatim, typefaces, capture in words, the `mechanism` and the `audience` it is built for) and writes it next to the canvas as **`prompt.json`**, an **ad spec** (`"schema": "baker-static-ad/3"`; `/2` still reads) you rewrite into the ad you want: `viewer` (who sees it and what they already know), `message` (the one thing it tells them, never printed), `copy` (each line with `lettering`: `in_scene`, written on something in the picture (`on`, `look`), or `designed`, set in the brand's face), `scene` (`description`, `look`: photo | designed | illustration, `capture` in words, `mood`, `layout`), `brand`, `colors` (each tied to an object, from the brand palette), `references` (one picture each, labelled by role: `PERSON_1`, `ANIMAL_1`, `PRODUCT_1`, `BADGE_1`, `PROP_1`), `logo` (and `logo_position`), `third_party_brands` (other brands the offer is about, a car brand on a car loan: `name`, `what`, and `logo` naming the `BADGE_n` reference of its logo; their logos may appear), an optional `direction`, the `mechanism` to rebuild for our brand, and in `/3`: `viewer.market` (`country`, `language`, `currency`), `brand_presence` (`standard` | `native`: a native disguise carries the logo as its sender and no big button), `recognition` (the kind of product a stranger must take it for at a glance, never the format), `native` (the ad is a screen people know, drawn exactly from HTML at every size by the free `static_native` node instead of painted: `x_post` (a post or a thread, with `reply_to`), `whatsapp`, `imessage`, `trustpilot`, `google_reviews`, `notes`, `slack`; on a 9:16 the app is drawn full screen as a phone shows it: status bar and app header pinned at the top, the reply bar and tab bar (or a keyboard under a chat or note) pinned at the bottom, the posts or messages as large as the clear band holds, and the frame's headline, caption and logo a card in the brand's colours under the app's header; a wall of reviews (`trustpilot`, `google_reviews`) takes up to 16 real reviews, the first two (`FEATURED_REVIEWS`) the ad's copy set whole in the safe area and the rest filling the whole frame behind them as large, sharp cards, turned and cut by its edges, because a wall wins on how many there are; a review longer than 160 characters is shown cut at a word with "…", and that cut text is the copy the review reads back; a chat (`whatsapp`, `imessage`) on a 9:16 never shrinks below about 62% of the phone scale: its earliest messages scroll up under the header, as the app does, the node's optional `scrolled` output lists the copy lines scrolled off that size, and the run review expects those lines nowhere on it; a logo file whose drawing runs off its own edge is set aside for a whole one, and a square mark where a wordmark goes is drawn larger; the run review never flags the app's own interface words (status bar, keyboard) as under Reels; those words ("Today", "Verified", "Post your reply") are printed in the viewer's language: Spanish, Portuguese and English as checked against the apps, any other written once by a text model and cached per language (`scripts/interface-words-evals`), English when it cannot; the image model renders only the screen's `photos`, each a plain phone photo of ordinary people of the market; adding the block switches an existing ad on its next run, `--fix` does not apply, an invented brand handle or a rating the Knowledge does not hold (either decimal mark) is refused as `native_screen_invalid`, and a photo of ours goes in as its `image`: a native photo takes no `avatar`, since nothing would cast it), a role on each third-party brand (`partner` | `proof` | `category_signal`), a reference's `image` (wired as a picture of ours) and a person's `avatar` (the company avatar cast), and `concept` (`why_it_wins` in five layers, `load_bearing` elements with `have`/`adapt`/`missing` and `ours`, `verdict` `use`|`adapt`|`reject`, `transfer_note`; seeded from `baker winning-ads fit`). Every render keeps the load-bearing elements; `validate`/`run` refuse a `reject` or a `missing` element with nothing named (`concept_does_not_fit`) and a rating, or a promised price, share, multiple or time, the Knowledge does not hold with that unit, or a superlative it does not make (`proof_without_source`), in any language or several in one ad: a text model reads each claim of the copy and of the Knowledge as a kind, a number and a unit (cached by text, billed with the next run), code compares them exactly, and the decision model (Jev) judges a superlative; with no model, every number the copy writes in digits must be in the Knowledge (`claim-check.ts`, eval: `scripts/claim-check-evals`); a line citing a review platform gets its real badge wired (Trustpilot, G2 and the like by name; Google, Google Play or the App Store when the line shows stars or a score, or the decision model reads it as citing them for reviews in any language, `scripts/review-citation-evals`). **You never write a model prompt**: every render prompt is compiled from this file for the model it runs on (short labelled sections for gpt-image, sentences with reasons for Gemini; each line quoted once; pictures numbered with one role each; colours from the brand; realism as capture cues; the safe area from its one owner; constraints last), on every `validate` and `run`, and shown on its node. A `prompt.json` written before the ad spec (the describe blueprint) is read through an adapter and keeps working. The source's own read (`source`, and the library's `reference`) stays as bookkeeping and is never sent to a model.
+**A library ad is read once for every company.** With `--source-ad-id` and the library's own picture (no `<image>`, `--context`, `--describe-model` or `--select-model`), both passes below come from `POST /api/ad-library/reference-read`: the backend reads the ad from Ad DNA's picture, grounded in its full DNA, and keeps the read for every company. The first build on an ad pays for it (~40 s); every later one, in any company, gets it at once and free. When the shared read cannot be had, the passes run here as before.
+
+1. **`image_describe`** (`~google/gemini-flash-latest`) — reverse-engineers the image (layout by what fills each region, copy verbatim, typefaces, capture in words, the `mechanism` and the `audience` it is built for) and writes it next to the canvas as **`prompt.json`**, an **ad spec** (`"schema": "baker-static-ad/3"`; `/2` still reads) you rewrite into the ad you want: `viewer` (who sees it and what they already know), `message` (the one thing it tells them, never printed), `copy` (each line with `lettering`: `in_scene`, written on something in the picture (`on`, `look`), or `designed`, set in the brand's face), `scene` (`description`, `look`: photo | designed | illustration, `capture` in words, `mood`, `layout`), `brand`, `colors` (each tied to an object, from the brand palette), `references` (one picture each, labelled by role: `PERSON_1`, `ANIMAL_1`, `PRODUCT_1`, `BADGE_1`, `PROP_1`), `logo` (and `logo_position`), `third_party_brands` (other brands the offer is about, a car brand on a car loan: `name`, `what`, and `logo` naming the `BADGE_n` reference of its logo; their logos may appear), an optional `direction`, the `mechanism` to rebuild for our brand, and in `/3`: `viewer.market` (`country`, `language`, `currency`), `brand_presence` (`standard` | `native`: a native disguise carries the logo as its sender and no big button), `recognition` (the kind of product a stranger must take it for at a glance, never the format), `native` (the ad is a screen people know, drawn exactly from HTML at every size by the free `static_native` node instead of painted: `x_post` (a post or a thread, with `reply_to`), `whatsapp`, `imessage`, `trustpilot`, `google_reviews`, `notes`, `slack`; on a 9:16 the app is drawn full screen as a phone shows it: status bar and app header pinned at the top, the reply bar and tab bar (or a keyboard under a chat or note) pinned at the bottom, the posts or messages as large as the clear band holds, and the frame's headline, caption and logo a card in the brand's colours under the app's header; a wall of reviews (`trustpilot`, `google_reviews`) takes up to 16 real reviews, the first two (`FEATURED_REVIEWS`) the ad's copy set whole in the safe area and the rest filling the whole frame behind them as large, sharp cards, turned and cut by its edges, because a wall wins on how many there are; a review longer than 160 characters is shown cut at a word with "…", and that cut text is the copy the review reads back; a chat (`whatsapp`, `imessage`) on a 9:16 never shrinks below about 62% of the phone scale: its earliest messages scroll up under the header, as the app does, the node's optional `scrolled` output lists the copy lines scrolled off that size, and the run review expects those lines nowhere on it; a logo file whose drawing runs off its own edge is set aside for a whole one, and a square mark where a wordmark goes is drawn larger; the run review never flags the app's own interface words (status bar, keyboard) as under Reels; those words ("Today", "Verified", "Post your reply") are printed in the viewer's language: Spanish, Portuguese and English as checked against the apps, any other written once by a text model and cached per language (`scripts/interface-words-evals`), English when it cannot; the image model renders only the screen's `photos`, each a plain phone photo of ordinary people of the market; adding the block switches an existing ad on its next run, `--fix` does not apply, an invented brand handle or a rating the Knowledge does not hold (either decimal mark) is refused as `native_screen_invalid`, and a photo of ours goes in as its `image`: a native photo takes no `avatar`, since nothing would cast it), a role on each third-party brand (`partner` | `proof` | `category_signal`), a reference's `image` (wired as a picture of ours) and a person's `avatar` (the company avatar cast), and `concept` (`why_it_wins` in five layers, `load_bearing` elements with `have`/`adapt`/`missing` and `ours`, `verdict` `use`|`adapt`|`reject`, `transfer_note`; seeded from `baker winning-ads fit`). Every render keeps the load-bearing elements; `validate`/`run` refuse a `reject` or a `missing` element with nothing named (`concept_does_not_fit`) and a rating, or a promised price, share, multiple or time, the Knowledge does not hold with that unit, or a superlative it does not make (`proof_without_source`), in any language or several in one ad: a text model reads each claim of the copy and of the Knowledge as a kind, a number and a unit (cached by text, billed with the next run), code compares them exactly, and the decision model (Jev) judges a superlative; with no model, every number the copy writes in digits must be in the Knowledge (`claim-check.ts`, eval: `scripts/claim-check-evals`); a line citing a review platform gets its real badge wired (Trustpilot, G2 and the like by name; Google, Google Play or the App Store when the line shows stars or a score, or the decision model reads it as citing them for reviews in any language, `scripts/review-citation-evals`). **You never write a model prompt**: every render prompt is compiled from this file for the model it runs on (short labelled sections for gpt-image, sentences with reasons for Gemini; each line quoted once; pictures numbered with one role each; colours from the brand; realism as capture cues; the safe area from its one owner; constraints last), on every `validate` and `run`, and shown on its node. A `prompt.json` written before the ad spec (the describe blueprint) is read through an adapter and keeps working. The source's own read (`source`, and the library's `reference`) stays as bookkeeping and is never sent to a model.
 2. **element selection** (`~google/gemini-flash-latest`) — picks the **main, identity-critical** elements (the brand logo, a showcased product, a trust badge) **plus any foreground/hero person or animal** — the emotional focal point — even a generic one, because a free-generated face/muzzle reads as AI and grows artifacts; the emotional hero always gets a real-reference slot. When the advertiser's logo appears in **more than one lockup** (a square/icon **mark** and a horizontal **wordmark**), each is emitted as its **own** element (e.g. `LOGO_MARK`, `LOGO_WORDMARK`). The describe pass also records the ad's **typography** (each typeface's classification, a best-guess family, and its weight/case), which seeds the spec's `brand.typeface`. Background extras are dropped. Each element becomes a `references` entry in the spec, named by its role and naming the canvas slot it fills, so the file says which slot grounds which subject.
 
 It then scaffolds a canvas on which **the image model designs the finished ad**, holding only what `prompt.json` holds; no element is mandatory:
@@ -6672,20 +6676,20 @@ Each creative reports `spend`, `impressions`, `ctr` (percent), `cpc`, `results`,
 
 ### `baker creatives feedback [--slug <slug>] [--full]`
 
-What reviewers said about creative versions in Baker (Approve, or Not this one with reasons and a note; choosing a version to keep counts as an approval). Compact by default: approved and rejected counts, the top rejection reasons, what approved versions share (format, platform, option) and the 8 latest verdicts, plus `hints[]` saying what to do differently. `--slug` narrows to one creative; `--full` returns every verdict (up to 200) with whole notes.
+What people said about creative versions in their chats (an approval, or a rejection with reasons and a note; keeping a version counts as an approval). Compact by default: approved and rejected counts, the top rejection reasons, what approved versions share (format, platform, option) and the 8 latest verdicts, plus `hints[]` saying what to do differently. `--slug` narrows to one creative; `--full` returns every verdict (up to 200) with whole notes.
 
 ```bash
 baker creatives feedback
 baker creatives feedback --slug spring-offer --full
 ```
 
-Each entry carries its `source`: `review` (the buttons in Baker), `selection` (choosing or saving the version) or `chat` (what the person wrote in a chat, recorded with `feedback record`).
+Each entry carries its `source`: `review` (the review buttons Baker had before, kept on older verdicts), `selection` (choosing or saving the version) or `chat` (what the person wrote in a chat, recorded with `feedback record`).
 
 When the person asks in the chat for another variant of a version, make every size from it with `baker canvas run --slug <slug> --use-variant <sha256> --from <runId>`; Baker has no control to choose one.
 
 ### `baker creatives feedback record`
 
-Record what the person said about one version in a chat: an approval, or a rejection with reasons and their own words. It is stored like the Approve / Not this one buttons, as the verdict of the person who wrote the chat's latest message (`recordedFor: "sender"`), or of the chat itself when nobody has written in it (`"chat"`). One verdict per person per version or option: a later one replaces theirs. Must run from a chat.
+Record what the person said about one version in a chat: an approval, or a rejection with reasons and their own words. It is stored as the verdict of the person who wrote the chat's latest message (`recordedFor: "sender"`), or of the chat itself when nobody has written in it (`"chat"`). One verdict per person per version or option: a later one replaces theirs. Must run from a chat.
 
 ```bash
 baker creatives feedback record --slug spring-offer --verdict rejected \

package/dist/{account-PCEZQUK7.js → account-DTHGTZCN.js}

@@ -2,7 +2,7 @@ import {
   csvOrJson,
   handleLinkedinError,
   resolveAccountIdArg
-} from "./chunk-CKU4WYTF.js";
+} from "./chunk-QVJDPOEB.js";
 import {
   writeAdsJson,
   writeAdsOutput
@@ -10,11 +10,11 @@ import {
 import {
   NO_CACHE_ARG
 } from "./chunk-X7ZODEXJ.js";
-import "./chunk-6HJAHLLA.js";
+import "./chunk-K6WVV74H.js";
 import "./chunk-GXDLWBOY.js";
-import "./chunk-WYCVJIHD.js";
+import "./chunk-TEINLN64.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import {
   apiGet
 } from "./chunk-XBOK23HI.js";
@@ -68,7 +68,7 @@ Examples:
   },
   subCommands: {
     detail: accountDetailCommand,
-    "url-params": () => import("./write-commands-CLJOD2XF.js").then((m) => m.accountUrlParamsCommand)
+    "url-params": () => import("./write-commands-CE4FIQ6Y.js").then((m) => m.accountUrlParamsCommand)
   },
   args: accountDetailCommand.args,
   default: "detail"
@@ -76,4 +76,4 @@ Examples:
 export {
   accountCommand
 };
-//# sourceMappingURL=account-PCEZQUK7.js.map
+//# sourceMappingURL=account-DTHGTZCN.js.map

package/dist/{accounts-5AXLYU7P.js → accounts-5RLG6BBA.js}

@@ -1,7 +1,7 @@
 import {
   csvOrJson,
   handleLinkedinError
-} from "./chunk-CKU4WYTF.js";
+} from "./chunk-QVJDPOEB.js";
 import {
   connectedResourceHints
 } from "./chunk-P4NSJS54.js";
@@ -16,11 +16,11 @@ import {
 import {
   NO_CACHE_ARG
 } from "./chunk-X7ZODEXJ.js";
-import "./chunk-6HJAHLLA.js";
+import "./chunk-K6WVV74H.js";
 import "./chunk-GXDLWBOY.js";
-import "./chunk-WYCVJIHD.js";
+import "./chunk-TEINLN64.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import {
   apiGet
 } from "./chunk-XBOK23HI.js";
@@ -74,4 +74,4 @@ Examples:
 export {
   accountsCommand
 };
-//# sourceMappingURL=accounts-5AXLYU7P.js.map
+//# sourceMappingURL=accounts-5RLG6BBA.js.map

package/dist/{accounts-OSXDZZLY.js → accounts-6LSBBXKA.js}

@@ -9,7 +9,7 @@ import {
   accountsInfluencedRequestSchema,
   influenceParams,
   warmAccounts
-} from "./chunk-RB5DB3WN.js";
+} from "./chunk-RB5CVIK6.js";
 import "./chunk-GRQ2AXDX.js";
 import {
   TABLE_OUTPUT_FORMATS,
@@ -19,12 +19,12 @@ import {
 } from "./chunk-VFIOJD5M.js";
 import {
   failApi
-} from "./chunk-NTPXZU3V.js";
-import "./chunk-6HJAHLLA.js";
+} from "./chunk-ZDNOCKKY.js";
+import "./chunk-K6WVV74H.js";
 import "./chunk-GXDLWBOY.js";
-import "./chunk-WYCVJIHD.js";
+import "./chunk-TEINLN64.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import {
   ApiError,
   apiPost
@@ -602,10 +602,10 @@ var accountsCommand = defineCommand({
     warm: warmCommand,
     company: companyCommand,
     campaigns: campaignsCommand,
-    crm: () => import("./crm-JP4UOPMN.js").then((m) => m.crmCommand)
+    crm: () => import("./crm-SNIUADNK.js").then((m) => m.crmCommand)
   }
 });
 export {
   accountsCommand
 };
-//# sourceMappingURL=accounts-OSXDZZLY.js.map
+//# sourceMappingURL=accounts-6LSBBXKA.js.map

package/dist/{actions-HM4VVTGW.js → actions-WH5C6Q7I.js}

@@ -30,26 +30,26 @@ Examples:
 Full guide: __tooling__/docs/tools/baker/actions.md`
   },
   subCommands: {
-    list: () => import("./list-TOUUGHMS.js").then((m) => m.listCommand),
-    log: () => import("./log-UGVWSK7Z.js").then((m) => m.logCommand),
-    draft: () => import("./draft-S2FSQOJN.js").then((m) => m.draftCommand),
-    get: () => import("./get-N7FR6NFX.js").then((m) => m.getCommand),
-    status: () => import("./status-M47G5HD4.js").then((m) => m.statusCommand),
-    claim: () => import("./claim-CIASHKMC.js").then((m) => m.claimCommand),
-    release: () => import("./release-3WCBAHPO.js").then((m) => m.releaseCommand),
-    create: () => import("./create-OYT76OMJ.js").then((m) => m.createCommand),
-    update: () => import("./update-RCP7F5L5.js").then((m) => m.updateCommand),
-    complete: () => import("./complete-32CPBFIG.js").then((m) => m.completeCommand),
-    discard: () => import("./discard-ZX5TLFYH.js").then((m) => m.discardCommand),
-    reopen: () => import("./reopen-PZI5H4X2.js").then((m) => m.reopenCommand),
-    assign: () => import("./assign-IIAVNATI.js").then((m) => m.assignCommand),
-    members: () => import("./members-VAX6KAFN.js").then((m) => m.membersCommand),
-    link: () => import("./link-AEU6BV75.js").then((m) => m.linkCommand),
-    unlink: () => import("./unlink-PLOOAGM3.js").then((m) => m.unlinkCommand),
-    tags: () => import("./tags-MRG56YOE.js").then((m) => m.tagsCommand)
+    list: () => import("./list-AQMGXI4N.js").then((m) => m.listCommand),
+    log: () => import("./log-MUPKKYSJ.js").then((m) => m.logCommand),
+    draft: () => import("./draft-GCUXNPVH.js").then((m) => m.draftCommand),
+    get: () => import("./get-6RQFDAIN.js").then((m) => m.getCommand),
+    status: () => import("./status-ZX5WM5PJ.js").then((m) => m.statusCommand),
+    claim: () => import("./claim-25JJM4AG.js").then((m) => m.claimCommand),
+    release: () => import("./release-C74JOYDA.js").then((m) => m.releaseCommand),
+    create: () => import("./create-2D7AIFJI.js").then((m) => m.createCommand),
+    update: () => import("./update-PNRNYXUW.js").then((m) => m.updateCommand),
+    complete: () => import("./complete-DRMOTC2W.js").then((m) => m.completeCommand),
+    discard: () => import("./discard-JS2YJUIM.js").then((m) => m.discardCommand),
+    reopen: () => import("./reopen-XI53RP7R.js").then((m) => m.reopenCommand),
+    assign: () => import("./assign-O6QNAZD5.js").then((m) => m.assignCommand),
+    members: () => import("./members-3U6GINDF.js").then((m) => m.membersCommand),
+    link: () => import("./link-4GGAQAVH.js").then((m) => m.linkCommand),
+    unlink: () => import("./unlink-KMWDKVIC.js").then((m) => m.unlinkCommand),
+    tags: () => import("./tags-4PXXFIPU.js").then((m) => m.tagsCommand)
   }
 });
 export {
   actionsCommand
 };
-//# sourceMappingURL=actions-HM4VVTGW.js.map
+//# sourceMappingURL=actions-WH5C6Q7I.js.map

package/dist/{add-4J2EF54O.js → add-BZ4QPLK4.js}

@@ -7,11 +7,11 @@ import {
   testimonialSourceRefreshIntervalSchema,
   testimonialSourceTypeSchema,
   testimonialSourcesAddRequestSchema
-} from "./chunk-6HJAHLLA.js";
+} from "./chunk-K6WVV74H.js";
 import "./chunk-GXDLWBOY.js";
-import "./chunk-WYCVJIHD.js";
+import "./chunk-TEINLN64.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -101,4 +101,4 @@ export {
   addCommand,
   addSourceHints
 };
-//# sourceMappingURL=add-4J2EF54O.js.map
+//# sourceMappingURL=add-BZ4QPLK4.js.map

package/dist/{add-VZAY57M4.js → add-TRSKOIO6.js}

@@ -6,16 +6,16 @@ import {
   stepNameKey,
   walkNodes,
   writeFlowTree
-} from "./chunk-EPMN4BK7.js";
+} from "./chunk-L5J3S6B6.js";
 import {
   flowCatalogEntry,
   flowCatalogTypes,
   flowNodeTriggers
-} from "./chunk-6HJAHLLA.js";
+} from "./chunk-K6WVV74H.js";
 import "./chunk-GXDLWBOY.js";
-import "./chunk-WYCVJIHD.js";
+import "./chunk-TEINLN64.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import {
   registerSchema,
   writeJson
@@ -149,6 +149,29 @@ function freeSideEffectId(type, taken) {
     if (!taken.has(candidate)) return candidate;
   }
 }
+function sameTrackingSideEffect(node, type, triggerId) {
+  if (flowCatalogEntry("side-effect", type)?.owners?.tagIds !== "tags") return null;
+  const effects = Array.isArray(node.sideEffects) ? node.sideEffects : [];
+  for (const raw of effects) {
+    const effect = raw;
+    if (effect?.type === type && effect.triggerId === triggerId) return effect;
+  }
+  return null;
+}
+function refuseSecondPixel(slug, node, type, triggerId) {
+  const already = sameTrackingSideEffect(node, type, triggerId);
+  if (!already) return;
+  const event = typeof already.eventName === "string" ? ` (event "${already.eventName}")` : "";
+  writeJson({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: `"${String(node.name ?? node.id)}" already reports \`${triggerId}\` to ${type} as "${String(already.id)}"${event}. A second one would count every conversion twice.`,
+      fix: `Edit "${String(already.id)}" in ${flowDataPath(slug)} instead of adding another.`
+    }
+  });
+  process.exit(1);
+}
 function pendingItem(target, nodeId, kind, sideEffectId) {
   return {
     target,
@@ -167,7 +190,7 @@ function configureHints(slug, nodeId, id, type, needsCard) {
 }
 registerSchema({
   command: "flows.add-side-effect",
-  description: "Add a side effect to a step with a valid skeleton \u2014 encryptedConfig:null for a CRM, a tagIds slot for a pixel, and no oauthProviderId key. Configure the confidential half with request_flow_input afterwards.",
+  description: "Add a side effect to a step with a valid skeleton \u2014 encryptedConfig:null for a CRM, a tagIds slot for a pixel, and no oauthProviderId key. Then set where it sends with `baker flows connect` (an email: --email/--subject, written by you); only a typed secret goes to request_flow_input.",
   args: {
     slug: { type: "positional", description: "Form slug", required: true },
     node: { type: "string", description: "Id of the step that fires it", required: true },
@@ -239,6 +262,7 @@ var addSideEffectCommand = defineCommand({
       process.exit(1);
     }
     const triggerId = trigger.triggerId;
+    refuseSecondPixel(slug, node, type, triggerId);
     const sideEffect = concrete(entry.skeleton, { id, triggerId });
     existing.push(sideEffect);
     writeFlowTree(slug, tree);
@@ -260,7 +284,7 @@ var addSideEffectCommand = defineCommand({
           String(node.id),
           id,
           type,
-          needsUser.some(([, owner]) => owner === "request_flow_input")
+          needsUser.some(([, owner]) => owner === "request_flow_input" || owner === "connect")
         ),
         ...needsUser.some(([, owner]) => owner === "tags") ? [
           "Fill `tagIds` with a real ref from `baker tags list`, or stage the tag first with the `tags` skill. Never invent one."
@@ -275,6 +299,7 @@ export {
   addSideEffectCommand,
   freeSideEffectId,
   resolveTrigger,
+  sameTrackingSideEffect,
   stepNameRefusal
 };
-//# sourceMappingURL=add-VZAY57M4.js.map
+//# sourceMappingURL=add-TRSKOIO6.js.map

package/dist/add-TRSKOIO6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/flows/add.ts"],"sourcesContent":["/**\n * `add-node` and `add-side-effect`: emit a valid skeleton and splice it in.\n *\n * The point is not to save typing — it is that the skeleton is right. A node\n * needs a fresh UUID, an explicit `condition: null`, the correct `nodeData`\n * discriminator, and — for a widget — `form.external: null` rather than an\n * invented resource. A side effect needs `encryptedConfig: null` and no\n * `oauthProviderId` key at all. Every one of those is a rule the flow-builder\n * skill used to spend prose on, and each was a real defect when got wrong.\n *\n * Deliberately scoped to creating the skeleton. Copy, conditions, autofill and\n * the `ai` field stay hand-edited: they are judgement, and a flag-based API for\n * them would be worse than JSON.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { type FlowConfigStatus, flowCatalogEntry, flowCatalogTypes, flowNodeTriggers } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport {\n  flowDataPath,\n  isUsableStepNameKey,\n  readFlowTree,\n  requestFlowInputCall,\n  stepNameKey,\n  walkNodes,\n  writeFlowTree,\n} from \"./shared.ts\";\n\ntype AnyRecord = Record<string, unknown>;\n\nfunction unknownType(kind: \"node\" | \"side-effect\", type: string): never {\n  writeJson({\n    ok: false,\n    error: {\n      code: \"VALIDATION_ERROR\",\n      message: `No ${kind} type \"${type}\".`,\n      fix: `Known types: ${flowCatalogTypes(kind).join(\", \")}. See: baker flows schema ${kind}`,\n    },\n  });\n  process.exit(1);\n}\n\n/** Replace the catalog's `<placeholder>` strings with real values where we have them. */\nfunction concrete(skeleton: AnyRecord, replacements: Record<string, unknown>): AnyRecord {\n  return { ...structuredClone(skeleton), ...replacements };\n}\n\n/**\n * Whether this name can be a step in this form, and why not when it cannot.\n *\n * Both answers are about the same fact: the name becomes a constant in the\n * form's generated `_query.ts` (`export const <KEY> = \"<node id>\";`), and\n * `flow-typed.mjs` writes it without checking either that it parses or that no\n * other step already produced it. So both failures land on a generated file\n * rather than on the name that caused them — one as a syntax error, one as\n * `Duplicate flow node name` — and `_query.ts` stops regenerating for the whole\n * form. A name is minted once, here, which makes here the only cheap place to\n * say so.\n *\n * Returns `null` when the name is fine.\n */\nexport function stepNameRefusal(nodes: readonly AnyRecord[], name: string): { message: string; fix: string } | null {\n  const key = stepNameKey(name);\n  if (!isUsableStepNameKey(key)) {\n    return {\n      message: `\"${name}\" cannot be a step name: it becomes the constant \\`${key || \"(empty)\"}\\`, which is not a valid identifier.`,\n      fix: 'A step name becomes `export const <NAME> = …` in the form\\'s generated code, so it must start with a letter and hold only letters, digits, spaces and dashes. Try \"Your Details\" rather than \"1. Your details\".',\n    };\n  }\n  const clash = nodes.find((node) => typeof node.name === \"string\" && stepNameKey(node.name) === key);\n  if (!clash) return null;\n  return {\n    message: `This form already has a step named \"${clash.name}\", which collides with \"${name}\".`,\n    fix: `Both become the constant \\`${key}\\`, and the form's generated code cannot hold it twice. Pick a name that differs by more than case, spacing or punctuation.`,\n  };\n}\n\nregisterSchema({\n  command: \"flows.add-node\",\n  description:\n    \"Add a step to a form with a valid skeleton — fresh UUID, explicit condition, correct nodeData discriminator, and form.external:null for a widget. Author its copy and conditions afterwards by editing _data.json.\",\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    type: { type: \"string\", description: \"Node type (see: baker flows schema node)\", required: true },\n    name: { type: \"string\", description: \"Step name — unique, Title Case\", required: true },\n    parent: { type: \"string\", description: \"Parent node id. Omit to append to the root's children.\", required: false },\n  },\n});\n\nexport const addNodeCommand = defineCommand({\n  meta: {\n    name: \"add-node\",\n    description:\n      'Add a step to a form, with the skeleton its type requires. Example: baker flows add-node contact --type customForm --name \"Contact Info\"',\n  },\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    type: { type: \"string\", description: \"Node type\", required: true },\n    name: { type: \"string\", description: \"Step name — unique, Title Case\", required: true },\n    parent: { type: \"string\", description: \"Parent node id (default: the root)\" },\n  },\n  run: ({ args }) => {\n    const slug = String(args.slug);\n    const type = String(args.type);\n    // Trimmed before anything reads it, because the generator does not trim:\n    // ` Contact Info ` becomes the constant `_CONTACT_INFO_`, which is legal,\n    // permanent, and not what anyone typed.\n    const name = String(args.name).trim();\n    const entry = flowCatalogEntry(\"node\", type) ?? unknownType(\"node\", type);\n\n    const tree = readFlowTree(slug);\n    const nodes = walkNodes(tree);\n\n    const refusal = stepNameRefusal(nodes, name);\n    if (refusal) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: refusal.message.replace(\"This form\", `\"${slug}\"`),\n          fix: refusal.fix,\n        },\n      });\n      process.exit(1);\n    }\n\n    const parent = args.parent ? nodes.find((node) => node.id === String(args.parent)) : tree;\n    if (!parent) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"NOT_FOUND\",\n          message: `No node with id \"${args.parent}\" in \"${slug}\".`,\n          fix: `Nodes in this form: ${nodes.map((node) => `${node.id} (${node.name})`).join(\", \")}`,\n        },\n      });\n      process.exit(1);\n    }\n\n    const node = concrete(entry.skeleton, { id: randomUUID(), name });\n    if (!Array.isArray(parent.children)) parent.children = [];\n    (parent.children as AnyRecord[]).push(node);\n    writeFlowTree(slug, tree);\n\n    writeJson({\n      ok: true,\n      data: { slug, nodeId: node.id, type, parentId: parent.id ?? null, path: flowDataPath(slug) },\n      hints: [\n        `Now fill in this step's \\`ai\\` field and its copy by editing ${flowDataPath(slug)}.`,\n        // Said on every step added, because the moment a Form's shape changes\n        // is the moment its outcome can move — and a Form nobody named an\n        // outcome for reports zero conversions rather than an error.\n        `Say what this Form counts before you finish: \\`baker analytics conversions --flow ${slug}\\` lists every ending already spelled as an event key, including this step's. Nothing in _data.json decides it.`,\n        ...(entry.owners?.[\"nodeData.form.external\"] === \"request_flow_input\"\n          ? [\n              `Pick this ${type} step's resource: ${requestFlowInputCall(slug, pendingItem(\"node\", String(node.id), type))}.`,\n            ]\n          : []),\n        ...(entry.gotcha ? [entry.gotcha] : []),\n      ],\n    });\n  },\n});\n\n/**\n * The `triggerId` a side effect on this step has to carry.\n *\n * This is the one field on a side effect that is decided by its STEP rather\n * than by its own type, and getting it wrong is silent in every direction:\n * `fireSideEffects` filters on `triggerId` equality, so a mismatch means the\n * side effect never runs — no error, no log, nothing half-written. Every\n * validator in the repo passes, because the file is valid; it just does nothing.\n *\n * Taking the skeleton's default was that failure. `SIDE_EFFECT_ENVELOPE` carries\n * `customForm.onFormSubmitted`, which is right for a `customForm` step and wrong\n * for the five widget types that raise an id of their own — so the command that\n * exists to emit a skeleton the agent cannot get wrong emitted a dead side\n * effect on any booking or embedded-form step.\n */\nexport type TriggerChoice = { ok: true; triggerId: string } | { ok: false; message: string; fix: string };\n\nexport function resolveTrigger(node: AnyRecord, requested: string | undefined): TriggerChoice {\n  const triggers = flowNodeTriggers(node.nodeData);\n  const where = `Step \"${String(node.name ?? node.id)}\"${triggers.type ? ` (a ${triggers.type} step)` : \"\"}`;\n  const raises = triggers.available.length > 0 ? `It raises: ${triggers.available.join(\", \")}.` : (triggers.why ?? \"\");\n  const no = (message: string, fix: string): TriggerChoice => ({ ok: false, message, fix });\n\n  // A node type the table does not cover is a table that has fallen behind, not\n  // a form that is wrong — so an explicit trigger is taken at its word there.\n  // Refusing instead would let a stale table reject a form the engine handles.\n  if (!triggers.known) {\n    return requested\n      ? { ok: true, triggerId: requested }\n      : no(`${where} is not a node type this command knows, so --trigger is required.`, triggers.why ?? \"\");\n  }\n\n  if (requested) {\n    return triggers.available.includes(requested)\n      ? { ok: true, triggerId: requested }\n      : no(\n          `${where} never raises \\`${requested}\\`, so a side effect carrying it would be written, pass every check, and never run.`,\n          raises,\n        );\n  }\n\n  return triggers.completion\n    ? { ok: true, triggerId: triggers.completion }\n    : no(`${where} has no trigger a side effect can answer.`, raises);\n}\n\n/**\n * The first `se-{type}-{n}` nobody is using.\n *\n * Counting the same-type side effects instead was wrong whenever the numbering\n * had a gap — a form holding `se-hubspotForm-1` and `se-hubspotForm-3`, or one\n * where `se-meta-1` was deleted and `se-meta-2` left behind. The count then\n * names an id that already exists and the command refuses, which is the one\n * outcome a skeleton-minting command should never produce for a form it can see\n * in full.\n */\nexport function freeSideEffectId(type: string, taken: ReadonlySet<string>): string {\n  for (let n = 1; ; n++) {\n    const candidate = `se-${type}-${n}`;\n    if (!taken.has(candidate)) return candidate;\n  }\n}\n\n/**\n * The pixel already reporting this step's moment to the same platform, if any.\n *\n * A second one double-counts every conversion, and its own `--id` slips past the\n * id check. Only pixel types (those fed a tag ref) are one-per-moment: two\n * emails or two CRMs on one step are a real need.\n */\nexport function sameTrackingSideEffect(node: AnyRecord, type: string, triggerId: string): AnyRecord | null {\n  if (flowCatalogEntry(\"side-effect\", type)?.owners?.tagIds !== \"tags\") return null;\n  const effects = Array.isArray(node.sideEffects) ? (node.sideEffects as unknown[]) : [];\n  for (const raw of effects) {\n    const effect = raw as AnyRecord | null;\n    if (effect?.type === type && effect.triggerId === triggerId) return effect;\n  }\n  return null;\n}\n\n/** Exits when this step already reports the moment to the same platform. */\nfunction refuseSecondPixel(slug: string, node: AnyRecord, type: string, triggerId: string): void {\n  const already = sameTrackingSideEffect(node, type, triggerId);\n  if (!already) return;\n  const event = typeof already.eventName === \"string\" ? ` (event \"${already.eventName}\")` : \"\";\n  writeJson({\n    ok: false,\n    error: {\n      code: \"VALIDATION_ERROR\",\n      message: `\"${String(node.name ?? node.id)}\" already reports \\`${triggerId}\\` to ${type} as \"${String(already.id)}\"${event}. A second one would count every conversion twice.`,\n      fix: `Edit \"${String(already.id)}\" in ${flowDataPath(slug)} instead of adding another.`,\n    },\n  });\n  process.exit(1);\n}\n\n/** The one row `requestFlowInputCall` needs, for an item this command just added unconfigured. */\nfunction pendingItem(\n  target: \"node\" | \"sideEffect\",\n  nodeId: string,\n  kind: string,\n  sideEffectId?: string,\n): FlowConfigStatus {\n  return {\n    target,\n    nodeId,\n    kind,\n    status: `${kind} — not configured`,\n    needsInput: true,\n    ...(sideEffectId ? { sideEffectId } : {}),\n  };\n}\n\nfunction configureHints(slug: string, nodeId: string, id: string, type: string, needsCard: boolean): string[] {\n  if (!needsCard) return [];\n  return [\n    `Configure it: ${requestFlowInputCall(slug, pendingItem(\"sideEffect\", nodeId, type, id))}. Read the destination off that call's result.`,\n  ];\n}\n\nregisterSchema({\n  command: \"flows.add-side-effect\",\n  description:\n    \"Add a side effect to a step with a valid skeleton — encryptedConfig:null for a CRM, a tagIds slot for a pixel, and no oauthProviderId key. Then set where it sends with `baker flows connect` (an email: --email/--subject, written by you); only a typed secret goes to request_flow_input.\",\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    node: { type: \"string\", description: \"Id of the step that fires it\", required: true },\n    type: { type: \"string\", description: \"Side-effect type (see: baker flows schema side-effect)\", required: true },\n    id: { type: \"string\", description: \"Side-effect id. Defaults to se-{type}-{n}.\", required: false },\n    trigger: {\n      type: \"string\",\n      description:\n        \"triggerId. Defaults to the moment the step named by --node completes, which is a different id per node type. Pass this only for a non-completion moment (a HubSpot form's onFormReady, a Calendly page view, one of several iframe events); an id the step never raises is refused.\",\n      required: false,\n    },\n  },\n});\n\nexport const addSideEffectCommand = defineCommand({\n  meta: {\n    name: \"add-side-effect\",\n    description:\n      \"Add a side effect to a step, with the skeleton its type requires. Example: baker flows add-side-effect contact --node <id> --type googleSpreadsheet\",\n  },\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    node: { type: \"string\", description: \"Id of the step that fires it\", required: true },\n    type: { type: \"string\", description: \"Side-effect type\", required: true },\n    id: { type: \"string\", description: \"Side-effect id (default se-{type}-{n})\" },\n    trigger: {\n      type: \"string\",\n      description: \"triggerId, for a non-completion moment. Default: whatever the step named by --node raises\",\n    },\n  },\n  run: ({ args }) => {\n    const slug = String(args.slug);\n    const type = String(args.type);\n    const entry = flowCatalogEntry(\"side-effect\", type) ?? unknownType(\"side-effect\", type);\n\n    const tree = readFlowTree(slug);\n    const nodes = walkNodes(tree);\n    const node = nodes.find((candidate) => candidate.id === String(args.node));\n    if (!node) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"NOT_FOUND\",\n          message: `No node with id \"${args.node}\" in \"${slug}\".`,\n          fix: `Nodes in this form: ${nodes.map((candidate) => `${candidate.id} (${candidate.name})`).join(\", \")}`,\n        },\n      });\n      process.exit(1);\n    }\n\n    if (!Array.isArray(node.sideEffects)) node.sideEffects = [];\n    const existing = node.sideEffects as AnyRecord[];\n    const takenIds = new Set(\n      nodes.flatMap((n) => ((n.sideEffects as AnyRecord[] | undefined) ?? []).map((se) => String(se?.id ?? \"\"))),\n    );\n    const id = args.id ? String(args.id) : freeSideEffectId(type, takenIds);\n\n    // Only an id the caller chose can still collide — the generated one is free\n    // by construction.\n    if (takenIds.has(id)) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: `\"${slug}\" already has a side effect with id \"${id}\".`,\n          fix: `Drop --id to be given a free one (${freeSideEffectId(type, takenIds)}), or pick another.`,\n        },\n      });\n      process.exit(1);\n    }\n\n    const trigger = resolveTrigger(node, args.trigger ? String(args.trigger) : undefined);\n    if (!trigger.ok) {\n      writeJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: trigger.message, ...(trigger.fix ? { fix: trigger.fix } : {}) },\n      });\n      process.exit(1);\n    }\n    const triggerId = trigger.triggerId;\n\n    refuseSecondPixel(slug, node, type, triggerId);\n\n    const sideEffect = concrete(entry.skeleton, { id, triggerId });\n    existing.push(sideEffect);\n    writeFlowTree(slug, tree);\n\n    const needsUser = Object.entries(entry.owners ?? {}).filter(([, owner]) => owner !== \"agent\");\n    writeJson({\n      ok: true,\n      data: { slug, nodeId: node.id, sideEffectId: id, type, triggerId, path: flowDataPath(slug) },\n      hints: [\n        `Fires on \\`${triggerId}\\` — the moment \"${String(node.name ?? node.id)}\" raises. A side effect only runs when its triggerId is the one its own step raises, so this is set from the step, never from the side-effect type.`,\n        // A pixel side effect is the thing most often mistaken for \"setting the\n        // conversion\". It tells the ad platform; it tells Baker nothing, and a\n        // Form can fire every pixel it has while every Baker report says it\n        // converted nobody.\n        ...(needsUser.some(([, owner]) => owner === \"tags\")\n          ? [\n              `This reports the conversion to ${type}. It does NOT make Baker count anything: what Baker counts is a named event, set with \\`baker analytics conversions --flow ${slug}\\`. Do both — they are two different systems asked the same question.`,\n            ]\n          : []),\n        ...configureHints(\n          slug,\n          String(node.id),\n          id,\n          type,\n          needsUser.some(([, owner]) => owner === \"request_flow_input\" || owner === \"connect\"),\n        ),\n        ...(needsUser.some(([, owner]) => owner === \"tags\")\n          ? [\n              \"Fill `tagIds` with a real ref from `baker tags list`, or stage the tag first with the `tags` skill. Never invent one.\",\n            ]\n          : []),\n        ...(entry.gotcha ? [entry.gotcha] : []),\n      ],\n    });\n  },\n});\n"],"mappings":"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","names":["node"]}

package/dist/{ads-NUME2UXH.js → ads-6UG66KA5.js}

@@ -27,14 +27,14 @@ Examples:
 Full guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedin|x|chatgpt)`
   },
   subCommands: {
-    google: () => import("./google-NYRI2NDZ.js").then((m) => m.googleCommand),
+    google: () => import("./google-M7KEXVK5.js").then((m) => m.googleCommand),
     meta: () => import("./meta-A7KM6TF5.js").then((m) => m.metaCommand),
-    linkedin: () => import("./linkedin-WCB2H5NH.js").then((m) => m.linkedinCommand),
-    x: () => import("./x-EBKLJJPJ.js").then((m) => m.xCommand),
+    linkedin: () => import("./linkedin-I6JDSTRB.js").then((m) => m.linkedinCommand),
+    x: () => import("./x-YXABYM5U.js").then((m) => m.xCommand),
     chatgpt: () => import("./chatgpt-7W75X3ER.js").then((m) => m.chatgptCommand)
   }
 });
 export {
   adsCommand
 };
-//# sourceMappingURL=ads-NUME2UXH.js.map
+//# sourceMappingURL=ads-6UG66KA5.js.map

package/dist/{advertisers-WSNHNCBQ.js → advertisers-OABQDELT.js}

@@ -1,19 +1,23 @@
 import {
   advertisersHints
-} from "./chunk-PIWMNKWI.js";
+} from "./chunk-NECTN6N7.js";
 import {
   RESEARCH_DATA_NOTE,
   handleResearchError,
   writeResearchHints,
   writeResearchJson,
   writeResearchOutput
-} from "./chunk-TBEUMOEL.js";
+} from "./chunk-WNFIJAUO.js";
 import {
   buildResearchQueryContext,
   warnDefaults
-} from "./chunk-2SCPDSFN.js";
-import "./chunk-EVYXTT7V.js";
-import "./chunk-XML7AJM3.js";
+} from "./chunk-LIQ4SQ2T.js";
+import "./chunk-XCM6XWOB.js";
+import "./chunk-K6WVV74H.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -28,7 +32,7 @@ import "./chunk-YQSBHWOI.js";
 import { defineCommand } from "citty";
 registerSchema({
   command: "research.advertisers",
-  description: 'Returns a ranked list of domains competing for one keyword in Google, with avg SERP position, relevance rating, estimated traffic value and visibility \u2014 domain economics, not ad copy. Despite the name it returns no headlines, descriptions or creative of any kind; for a competitor\'s actual ad copy use `baker winning-ads content <adId>` (Meta/LinkedIn only \u2014 Google SERP ad copy is not available anywhere in Baker). Start here: `baker research advertisers "<keyword>" --location <cc> --language <code>` to size up who owns a term. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.',
+  description: 'Returns a ranked list of domains competing for one keyword in Google, with avg SERP position, relevance rating, estimated traffic value and visibility \u2014 domain economics, not ad copy. Despite the name it returns no headlines, descriptions or creative of any kind; for a competitor\'s actual ad copy use `baker research google-ads <competitor.com> --copy` (Google) or `baker winning-ads content <adId>` (Meta/LinkedIn). Start here: `baker research advertisers "<keyword>" --location <cc> --language <code>` to size up who owns a term. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.',
   args: {
     keyword: {
       type: "string",
@@ -59,7 +63,7 @@ var FIELDS = {
 var advertisersCommand = defineCommand({
   meta: {
     name: "advertisers",
-    description: `Domains competing for a keyword in Google SERPs, with position, relevance, traffic value and visibility. Returns NO ad copy \u2014 for a competitor's headlines and body copy use \`baker winning-ads content <adId>\` (Meta/LinkedIn only).
+    description: `Domains competing for a keyword in Google SERPs, with position, relevance, traffic value and visibility. Returns NO ad copy \u2014 for a competitor's headlines and body copy use \`baker research google-ads <competitor.com> --copy\` (Google) or \`baker winning-ads content <adId>\` (Meta/LinkedIn).
 
 Examples:
   baker research advertisers "running shoes"
@@ -113,4 +117,4 @@ Examples:
 export {
   advertisersCommand
 };
-//# sourceMappingURL=advertisers-WSNHNCBQ.js.map
+//# sourceMappingURL=advertisers-OABQDELT.js.map

package/dist/advertisers-OABQDELT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/advertisers.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { buildResearchQueryContext, warnDefaults } from \"../../geo-context.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { advertisersHints } from \"./hints.ts\";\nimport {\n  handleResearchError,\n  RESEARCH_DATA_NOTE,\n  writeResearchHints,\n  writeResearchJson,\n  writeResearchOutput,\n} from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.advertisers\",\n  description:\n    'Returns a ranked list of domains competing for one keyword in Google, with avg SERP position, relevance rating, estimated traffic value and visibility — domain economics, not ad copy. Despite the name it returns no headlines, descriptions or creative of any kind; for a competitor\\'s actual ad copy use `baker research google-ads <competitor.com> --copy` (Google) or `baker winning-ads content <adId>` (Meta/LinkedIn). Start here: `baker research advertisers \"<keyword>\" --location <cc> --language <code>` to size up who owns a term. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.',\n  args: {\n    keyword: {\n      type: \"string\",\n      description:\n        \"Keyword to search (positional). One search term, not a brand or a domain — this is a SERP query, not an advertiser lookup\",\n      required: true,\n    },\n    location: {\n      type: \"string\",\n      description:\n        \"Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted — always set this for non-US markets\",\n      required: false,\n    },\n    language: {\n      type: \"string\",\n      description:\n        \"Language code or name (en, es, spanish...). Defaults to en (English) if omitted — always set this for non-English markets\",\n      required: false,\n    },\n    limit: { type: \"string\", description: \"Max results (default: 20, max: 100)\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n});\n\ninterface Advertiser {\n  domain: string;\n  avg_position: number;\n  rating: number;\n  etv: number;\n  visibility: number;\n}\n\nconst FIELDS: Record<string, string> = {\n  domain: \"Competing domain (no ad copy is returned — see hints)\",\n  avg_position: \"Average SERP position (1 = top)\",\n  rating: \"Domain relevance rating (0-100)\",\n  etv: \"Estimated traffic value (USD)\",\n  visibility: \"SERP visibility score (0-1)\",\n};\n\nexport const advertisersCommand = defineCommand({\n  meta: {\n    name: \"advertisers\",\n    description: `Domains competing for a keyword in Google SERPs, with position, relevance, traffic value and visibility. Returns NO ad copy — for a competitor's headlines and body copy use \\`baker research google-ads <competitor.com> --copy\\` (Google) or \\`baker winning-ads content <adId>\\` (Meta/LinkedIn).\n\nExamples:\n  baker research advertisers \"running shoes\"\n  baker research advertisers \"crm software\" --location uk --limit 10\n  baker research advertisers \"zapatos\" --location es --language spanish`,\n  },\n  args: {\n    keyword: { type: \"positional\", description: \"Keyword to search\", required: true },\n    location: { type: \"string\", description: \"Country code or location code (default: us)\", required: false },\n    language: { type: \"string\", description: \"Language code or name (default: en)\", required: false },\n    limit: { type: \"string\", description: \"Max results (default: 20, max: 100)\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n  run: async ({ args }) => {\n    const keyword = args.keyword as string;\n    const location = (args.location as string) || undefined;\n    const language = (args.language as string) || undefined;\n    const limit = args.limit ? Number(args.limit) : undefined;\n    const skipCache = args[\"no-cache\"] ? true : undefined;\n    const queryContext = buildResearchQueryContext(location, language);\n\n    try {\n      const data = await apiPost<Advertiser[]>(\"/api/research/advertisers\", {\n        keyword,\n        location,\n        language,\n        limit,\n        skipCache,\n      });\n\n      warnDefaults(queryContext);\n      const format = (args.output as string) || \"json\";\n      const hints = advertisersHints(data.length, queryContext);\n      if (format !== \"json\") {\n        writeResearchOutput(data as unknown as Array<Record<string, unknown>>, format);\n        writeResearchHints(hints, format);\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        data,\n        fields: FIELDS,\n        note: RESEARCH_DATA_NOTE,\n        query_context: queryContext,\n        hints,\n      });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAa9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAC7F,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AACF,CAAC;AAUD,IAAM,SAAiC;AAAA,EACrC,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,YAAY;AACd;AAEO,IAAM,qBAAqB,cAAc;AAAA,EAC9C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf;AAAA,EACA,MAAM;AAAA,IACJ,SAAS,EAAE,MAAM,cAAc,aAAa,qBAAqB,UAAU,KAAK;AAAA,IAChF,UAAU,EAAE,MAAM,UAAU,aAAa,+CAA+C,UAAU,MAAM;AAAA,IACxG,UAAU,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAChG,OAAO,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAC7F,QAAQ,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,OAAO,SAAS,OAAO;AAAA,IACrG,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,UAAU,KAAK;AACrB,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,QAAQ,KAAK,QAAQ,OAAO,KAAK,KAAK,IAAI;AAChD,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO;AAC5C,UAAM,eAAe,0BAA0B,UAAU,QAAQ;AAEjE,QAAI;AACF,YAAM,OAAO,MAAM,QAAsB,6BAA6B;AAAA,QACpE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,mBAAa,YAAY;AACzB,YAAM,SAAU,KAAK,UAAqB;AAC1C,YAAM,QAAQ,iBAAiB,KAAK,QAAQ,YAAY;AACxD,UAAI,WAAW,QAAQ;AACrB,4BAAoB,MAAmD,MAAM;AAC7E,2BAAmB,OAAO,MAAM;AAChC;AAAA,MACF;AACA,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,QACA,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,eAAe;AAAA,QACf;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/{analytics-QTR2ZITZ.js → analytics-3YAWQF5K.js}

@@ -1,13 +1,13 @@
 import {
   flowEventKeys,
   flowNodes
-} from "./chunk-7JUUKYKG.js";
+} from "./chunk-4Z7DEN75.js";
 import {
   flowDataPath,
   flowExists,
   listFlowSlugs,
   readFlowTree
-} from "./chunk-EPMN4BK7.js";
+} from "./chunk-L5J3S6B6.js";
 import {
   peopleArgs,
   peopleLimitError
@@ -19,7 +19,7 @@ import {
   INGEST_ARRIVALS_MAX,
   eventIngestUrl,
   ingestBrief
-} from "./chunk-FGH4Z5K5.js";
+} from "./chunk-DQMZXK27.js";
 import "./chunk-GRQ2AXDX.js";
 import {
   ConversionArgsError,
@@ -47,11 +47,11 @@ import {
 } from "./chunk-VFIOJD5M.js";
 import {
   flowNodeTriggers
-} from "./chunk-6HJAHLLA.js";
+} from "./chunk-K6WVV74H.js";
 import "./chunk-GXDLWBOY.js";
-import "./chunk-WYCVJIHD.js";
+import "./chunk-TEINLN64.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import {
   ApiError,
   apiPost
@@ -1941,7 +1941,7 @@ Full guide: __tooling__/docs/tools/baker/analytics.md`
     tracking: trackingCommand,
     arrivals: arrivalsCommand,
     "sending-events": sendingEventsCommand,
-    sources: () => import("./sources-MLDLMEDT.js").then((m) => m.sourcesCommand),
+    sources: () => import("./sources-GEB6OEGY.js").then((m) => m.sourcesCommand),
     "website-tag": websiteTagCommand,
     sites: sitesCommand,
     presets: presetsCommand
@@ -1955,4 +1955,4 @@ export {
   requestBody,
   sendingEventsAddress
 };
-//# sourceMappingURL=analytics-QTR2ZITZ.js.map
+//# sourceMappingURL=analytics-3YAWQF5K.js.map