@koda-sl/baker-cli 0.151.0-dev.4932063cd → 0.152.0

package/README.md

@@ -300,11 +300,22 @@ When a query fails, the error includes a `fix` object with the exact corrected c
 
 ### `baker ads google changes`
 
-Get recent change logs for an account.
+Read the change history of an account.
+
+Google keeps account history in two layers, and neither reaches past 90 days:
+
+| Scope       | Reach   | What you get                                                        |
+|-------------|---------|---------------------------------------------------------------------|
+| `detail`    | 30 days | What changed, old → new value, and who changed it                   |
+| `summary`   | 90 days | Which resources were added, changed or removed — no values, no user  |
+
+Beyond 90 days there is no API. Infer the change from a monthly spend trend per campaign
+instead, or ask the user to check the change history in the Google Ads web UI.
 
 ```bash
 baker ads google changes --customer-id 1234567890
 baker ads google changes --customer-id 1234567890 --days 14 --resource-type CAMPAIGN
+baker ads google changes --customer-id 1234567890 --days 60 --scope summary
 ```
 
 **Flags:**
@@ -312,8 +323,9 @@ baker ads google changes --customer-id 1234567890 --days 14 --resource-type CAMP
 | Flag              | Description                                                   |
 |-------------------|---------------------------------------------------------------|
 | `--customer-id`   | Google Ads customer ID. Falls back to `BAKER_GOOGLE_ADS_CUSTOMER_ID` env var. |
-| `--days`          | Lookback days (default 7, max 90)                             |
-| `--resource-type` | Filter: CAMPAIGN, AD_GROUP, AD_GROUP_AD, AD_GROUP_CRITERION   |
+| `--scope`         | `detail` (default, 30 days) or `summary` (90 days)            |
+| `--days`          | Lookback days, counted inclusive of today (default 7). Max 30 with `detail`, 90 with `summary` |
+| `--resource-type` | Filter: CAMPAIGN, CAMPAIGN_CRITERION, AD_GROUP, AD_GROUP_AD, AD_GROUP_CRITERION |
 | `--limit`         | Max results (default 50)                                      |
 | `--output`        | Format: `json` \| `csv` \| `jsonl` \| `md`                   |
 
@@ -846,6 +858,7 @@ audit --format md              # deliverable-ready markdown table
 
 campaign-groups create|update|pause|resume|duplicate    # staged writes (see below)
 campaigns create|update|pause|resume|archive|duplicate
+campaigns url-params <ad-set-id>                        # UTMs for every ad in the ad set
 creatives create|update|pause|resume|duplicate
 audiences create|upload
 conversions create|update
@@ -868,6 +881,12 @@ baker ads linkedin campaigns create --name "ABM Tier-1" --group li_temp_x1 \
 baker ads linkedin creatives create --campaign li_temp_x2 --format image \
   --image-id <bakerImageId> --headline "Book a demo" --landing-url https://example.com/demo --cta REQUEST_DEMO
 
+# UTMs belong on the ad set — LinkedIn appends them to every ad in it, live ones included
+baker ads linkedin campaigns url-params 123456 \
+  --param "utm_source=linkedin&utm_medium=paid-social" \
+  --dynamic utm_campaign=CAMPAIGN_NAME --dynamic utm_content=CREATIVE_ID
+baker ads linkedin campaigns url-params 123456 --clear        # remove them all
+
 # Fix the classic audit findings
 baker ads linkedin campaigns update 123456 --audience-expansion off --lan off
 baker ads linkedin campaigns update 123456 --bid 7.50 --daily-budget 100 --currency USD
@@ -3396,7 +3415,6 @@ Generate video. Async with polling. Two curated models.
 | `first_frame` | image | no | Starting keyframe (image-to-video) |
 | `last_frame` | image | no | Ending keyframe |
 | `reference` | image | no | Alternative to `first_frame` when only one image is given |
-| `references` | image[] | no | Reference-to-video: several images used as visual guidance (this person, this product) instead of an exact opening frame. **Mutually exclusive with `first_frame`** — when both are wired the frame wins and these are ignored, so pick one mode. |
 
 Accepted ref-image MIMEs vary by model — see per-model sections below.
 
@@ -4658,8 +4676,29 @@ baker landing critique spring-offer --full   # also print advisory-tier findings
 - **BRAND.md is the allowlist.** A font, hue, or ground that the client's `src/brand/BRAND.md` (mirrored into `src/styles/global.css` `@theme`, hex or oklch) commits is a decision, not a tell — matched values downgrade to advisory `brandDrift` so the critic never fights a real brand.
 - **Records a freshness snapshot** to `.cache/landing-critique/<slug>.json` (the source hash it scored). The publish quality gate reads it to enforce that every changed landing was critiqued and ships no block-tier tell. Re-run after edits so the snapshot stays fresh.
 
+- **Agent washing is a copy tell.** A page that claims autonomy ("fully autonomous", "while you sleep", "no human intervention") and never says anywhere what the buyer approves, overrides, or audits scores an `agent-washing` warn. One signal about oversight of the agent's actions — approval, review, override, undo/rollback, audit log, escalation — anywhere on the page clears it; the rule is page-scope precisely because the hero can defer the trust story to a section below it. Generic privacy boilerplate ("GDPR", "encrypted", "your data") deliberately does **not** clear it, since it appears in most footers and says nothing about who is in charge of the agent.
+
 Output is the standard envelope `{ ok, data, hints }` with `data = { advisory, slug, overall, counts, dimensions, findings }`. `dimensions` scores seven design families (typography, color, borders_depth, motion, spacing, copy, integrity) 0–1 (higher is better); `counts` is the block/warn/advisory tally.
 
+## Brand Fonts (`baker brand fonts`)
+
+Verifies that a brand's typefaces really load, and self-hosts them. A font that isn't actually available never announces itself — the browser substitutes its nearest fallback, so the page renders fine and is quietly off-brand. Reading a family name off a live site tells you what the CSS *asks for*, never what loads.
+
+```bash
+baker brand fonts check                                    # are the brand's fonts real?
+baker brand fonts fetch "DM Sans"                          # self-host, weights taken from global.css
+baker brand fonts fetch "Manrope" --weights 500,700        # self-host specific weights
+baker brand fonts fetch "Inter" --subsets latin,latin-ext  # add accented-glyph coverage
+```
+
+- **`check`** asks Google Fonts what it *actually* serves for every family and weight `src/styles/global.css` requests, and reports `requested` / `served` / `missing` plus the available unicode subsets. It exits 2 with `FONT_NOT_SERVED` when the brand asks for something Google won't serve, and distinguishes an unknown family name from a family that exists at other weights — the fix differs.
+- **Failures carry the numbers, so nothing needs a second call.** `check`'s error keeps the full per-family breakdown at `error.fix.families` (healthy families included, so a multi-family brand shows what not to touch), and both commands probe the standard weights to report the ones that *do* exist at `error.fix.served` — the remediation is "retry with one of these" rather than "run `check`", which would be the command that just failed.
+- **`fetch`** downloads the family into `src/brand/fonts/` and prints the `@font-face` block to paste above `@theme`. Defaults to the `latin` subset; `--subsets latin,latin-ext` adds accented-glyph coverage for Spanish and Portuguese copy. One file per weight *and* subset, since Google ships them separately and `unicode-range` is carried through verbatim.
+- **It does not edit `global.css` for you.** Paste the block, then drop that family from the Google `@import` — otherwise the page self-hosts *and* still calls Google. Record the weights in `src/brand/BRAND.md` in the same change.
+- **Licensing:** Google Fonts are open-licensed and safe to self-host. A client's own commercial typeface is not — confirm before re-hosting one.
+
+Complements the offline `validate-brand-fonts` check that runs in the scaffold's `verify`: that one compares what `global.css` declares against what provides it, with no network. Only the network can answer whether Google really serves a given family and weight.
+
 ## Help & Discovery
 
 Every command supports `--help` for usage info:
@@ -4698,6 +4737,8 @@ This CLI is designed for AI agent consumption. Key patterns:
 - **0.116.0**: `lead-forms create` models the full Campaign Manager form — `locale`, form banner image (`formImageId`/`formImageUrn`), predefined profile-field questions (validated enum) vs custom questions (`SINGLE_LINE_TEXT`/`MULTIPLE_CHOICE` with `options`, ≤3 custom), `privacyPolicyText`, disclosure `consents[]` (≤5), tracking `hiddenFields[]` (≤20), and `thankYou` confirmation CTA + landing/appointment link. Staged preview surfaces best-practice warnings (no qualifying question, no confirmation, no consent). No breaking flag changes.
 - **0.121.0**: `lead-forms create` drops the `privacyPolicyText` field — LinkedIn's versioned lead-form API has no privacy-policy-text slot, so it was silently discarded on publish. Use `legalDisclaimer` (shown under the form) or `consents[]` (disclosure checkboxes) instead. (Companion backend fix: staged lead-form questions were serialized in a shape LinkedIn dropped — they now publish correctly, and the staged preview lists each question.)
 - **0.119.0**: `draft amend`/`draft show` land on both `baker ads google` and `baker ads linkedin` — a generic JSON-merge-patch to update any staged op in place plus a full-payload receipt, replacing remove+recreate as the correction path. Google gains `assets update` and `asset-groups create|update` (Performance Max asset groups are now their own entity — `ads create --format performanceMaxAssetGroup` never worked and is gone); `ads create --format video` moves from a bare YouTube id to `--video-assets` refs (**breaking flag change** — stage the video as an asset first); `--format demandGen` gains `--image-assets`/`--square-image-assets`/`--logo-image-assets` and flag-building for headlines/descriptions. LinkedIn's `draft list` now renders a readable Campaign group ▸ Campaign ▸ Creative tree by default (`--json` for raw), `creatives update` gains `--campaign` (re-parent while staged), and `campaigns update` passes create-only fields (`--group`/`--type`/`--locale`/`--associated-entity`) through when amending a `li_temp_*` staged create instead of always stripping them.
+- **0.150.0**: `baker landing critique` gains an `agent-washing` rule in the `copy` family — an autonomy claim ("fully autonomous", "while you sleep", "no human intervention") with no signal anywhere on the page about who oversees the agent (approval, review, override, undo/rollback, audit log, escalation) scores a warn. Page-scope, so a hero may defer the trust story to a later section; generic privacy boilerplate does not clear it. `CRITIC_VERSION` bumps to `2`.
+- **0.152.0**: `baker ads linkedin campaigns url-params <ad-set-id>` stages an ad set's URL tracking parameters (LinkedIn's `adTrackingParameters`) — `--param key=value` for fixed values (repeatable or `&`-joined), `--dynamic key=PLACEHOLDER` for values LinkedIn fills in per ad (`CAMPAIGN_NAME`, `CREATIVE_ID`, …), `--clear` to remove them. LinkedIn appends these to the landing URL of every ad in the ad set, including ads already running, so this replaces stamping the same UTM onto each ad's `--landing-url` — which missed later ads and double-appended keys the ad set already set. Account-level parameters remain UI-only (LinkedIn exposes no API for them).
 
 ## Publishing
 

package/dist/{chunk-S43JQWI2.js → chunk-OO5BDH3J.js}

@@ -7,9 +7,9 @@ import {
   __toESM
 } from "./chunk-RK67WL4O.js";
 
-// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/810146e81bae4e3a061fe487864f2fde80c4b03b886877dc0f1fffbc6480b67e/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/810146e81bae4e3a061fe487864f2fde80c4b03b886877dc0f1fffbc6480b67e/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();
@@ -1070,7 +1070,7 @@ function resolveAdaptFormats(params) {
   return params.formats ?? [];
 }
 
-// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/810146e81bae4e3a061fe487864f2fde80c4b03b886877dc0f1fffbc6480b67e/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;
@@ -1119,7 +1119,6 @@ var OPENROUTER_IMAGE_SIZE = ["1K", "2K", "4K"];
 var OPENROUTER_IMAGE_SIZE_EXTENDED = ["0.5K", ...OPENROUTER_IMAGE_SIZE];
 var OPENROUTER_IMAGE_QUALITY = ["auto", "low", "medium", "high"];
 var SEEDANCE_DURATIONS = [4, 5, 6, 8, 10, 12, 15];
-var KLING_DURATIONS = [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15];
 var ELEVENLABS_OUTPUT_FORMATS = [
   "mp3_22050_32",
   "mp3_44100_32",
@@ -1413,7 +1412,7 @@ var MODEL_REGISTRY = {
         prompt: { kind: "string" },
         negative_prompt: { kind: "string" },
         aspect_ratio: { kind: "string", enum: ["16:9", "9:16"] },
-        resolution: { kind: "string", enum: ["720p", "1080p", "4K"] },
+        resolution: { kind: "string", enum: ["720p", "1080p"] },
         duration: { kind: "number", enum: [4, 6, 8] },
         seed: { kind: "number" },
         generate_audio: { kind: "boolean" },
@@ -1425,14 +1424,9 @@ var MODEL_REGISTRY = {
     "kwaivgi/kling-v3.0-pro": {
       // Motion-transfer / dynamic multi-shot beats. Reachable through the default
       // OpenRouter gateway (generic video body — no google-vertex block), so it
-      // needs no direct-provider exception. `cfg_scale` trades prompt adherence
-      // vs motion freedom; higher = closer to prompt.
-      //
-      // Params below are the ones OpenRouter actually advertises for this model
-      // (GET /api/v1/videos/models). Three were wrong before and each was a free
-      // 400 or a silently unsupported knob: it renders 720p ONLY (1080p was
-      // offered and rejected), it takes ANY duration from 3-15s (we allowed just
-      // 5 and 10), and it does not support `seed` at all.
+      // needs no direct-provider exception. Cost is usage-based (known from the
+      // provider response), so it has no pre-flight cost estimate. `cfg_scale`
+      // trades prompt adherence vs motion freedom; higher = closer to prompt.
       label: "Kling 3.0",
       inputs: [],
       optional_inputs: [{ kind: "image", mimes: OPENROUTER_IMAGE_MIMES }],
@@ -1442,9 +1436,10 @@ var MODEL_REGISTRY = {
         // over-length prompt fails validate (free) not the billed call.
         prompt: { kind: "string", maxLength: 2500 },
         negative_prompt: { kind: "string" },
-        aspect_ratio: { kind: "string", enum: ["16:9", "9:16", "1:1"] },
-        resolution: { kind: "string", enum: ["720p"] },
-        duration: { kind: "number", enum: KLING_DURATIONS },
+        aspect_ratio: { kind: "string", enum: ["1:1", "16:9", "9:16"] },
+        resolution: { kind: "string", enum: ["720p", "1080p"] },
+        duration: { kind: "number", enum: [5, 10] },
+        seed: { kind: "number" },
         generate_audio: { kind: "boolean" },
         cfg_scale: { kind: "number", min: 0, max: 1 }
       }
@@ -1460,7 +1455,7 @@ var MODEL_REGISTRY = {
         prompt: { kind: "string" },
         negative_prompt: { kind: "string" },
         aspect_ratio: { kind: "string", enum: ["16:9", "9:16"] },
-        resolution: { kind: "string", enum: ["720p", "1080p", "4K"] },
+        resolution: { kind: "string", enum: ["720p", "1080p"] },
         duration: { kind: "number", enum: [4, 6, 8] },
         seed: { kind: "number" },
         generate_audio: { kind: "boolean" },
@@ -1782,58 +1777,6 @@ function validateValue(key, value, schema, model) {
   }
 }
 
-// ../canvas-contract/src/videoCost.ts
-var CREDITS_PER_USD = 100;
-var SEEDANCE_USD_PER_SECOND = {
-  "480p": 0.18,
-  "720p": 0.5,
-  "1080p": 0.62,
-  "4k": 0.62
-};
-var DEFAULT_VIDEO_RESOLUTION = "720p";
-var DEFAULT_VIDEO_DURATION_S = 5;
-function isSeedanceModel(model) {
-  return model.startsWith("bytedance/seedance");
-}
-var FALLBACK_USD_PER_SECOND = 0.5;
-function seedanceUsdPerSecond(resolution) {
-  return SEEDANCE_USD_PER_SECOND[resolution ?? DEFAULT_VIDEO_RESOLUTION] ?? FALLBACK_USD_PER_SECOND;
-}
-var USD_PER_SECOND = {
-  // Kling publishes one flat rate across every resolution and mode.
-  "kwaivgi/kling-v3.0-pro": { silent: 0.112, audio: 0.168 },
-  // Veo prices 4K far above the base tier — and 4K is a selectable resolution,
-  // so folding it into the base rate under-quotes the dearest clip we can make.
-  "google/veo-3.1": {
-    silent: 0.2,
-    audio: 0.4,
-    byResolution: { "4K": { silent: 0.4, audio: 0.6 } }
-  },
-  "google/veo-3.1-fast": {
-    silent: 0.1,
-    audio: 0.12,
-    byResolution: {
-      "720p": { silent: 0.08, audio: 0.1 },
-      "4K": { silent: 0.25, audio: 0.3 }
-    }
-  }
-};
-function estimateVideoCostUsd({ model, duration, resolution, generateAudio }) {
-  const seconds = duration ?? DEFAULT_VIDEO_DURATION_S;
-  if (isSeedanceModel(model)) return seedanceUsdPerSecond(resolution) * seconds;
-  const published = USD_PER_SECOND[model];
-  if (published) {
-    const rate = (resolution ? published.byResolution?.[resolution] : void 0) ?? published;
-    return (generateAudio ? rate.audio : rate.silent) * seconds;
-  }
-  const dearestKnownRate = Math.max(...Object.values(SEEDANCE_USD_PER_SECOND));
-  return dearestKnownRate * seconds;
-}
-function estimateVideoCredits(input) {
-  const credits = estimateVideoCostUsd(input) * CREDITS_PER_USD;
-  return Math.ceil(Number(credits.toFixed(6)));
-}
-
 // src/engine/lib/concurrency.ts
 var DEFAULT_CONCURRENCY = 8;
 function resolveConcurrency(...candidates) {
@@ -2630,7 +2573,7 @@ function looksLikeHttpUrl(value) {
 var VEO_PERSON_GENERATION = "allow_adult";
 var VEO_NEGATIVE_PROMPT = "subtitles, captions, on-screen text, watermark, logo, warped face, distorted hands, extra fingers, low quality";
 var VEO_DURATIONS = [4, 6, 8];
-var KLING_DURATIONS2 = [5, 10];
+var KLING_DURATIONS = [5, 10];
 var KLING_NEGATIVE_PROMPT = "warped face, distorted hands, extra fingers, morphing, flicker, on-screen text, watermark, low quality";
 var KLING_CFG_SCALE = 0.7;
 var SPEAKS_PROSE = (line) => `The person speaks to camera; lip-sync follows the dialogue verbatim, with delivery and emotion carried in the wording itself (no bracketed cues). Dialogue: "${line}"`;
@@ -2676,7 +2619,7 @@ var KLING_PROFILE = {
   // Kling takes a negative_prompt PARAM instead (paramDefaults).
   keyframeInstruction: "Preserve the composition and colors of the first frame; animate the motion described.",
   wordBudget: 200,
-  durationSet: KLING_DURATIONS2,
+  durationSet: KLING_DURATIONS,
   paramDefaults: { negative_prompt: KLING_NEGATIVE_PROMPT, cfg_scale: KLING_CFG_SCALE }
 };
 function clipProfileFor(modelId) {
@@ -7510,33 +7453,12 @@ var videoGenerateNode = delegated({
   inputs: z28.object({
     first_frame: ImageRef.optional(),
     last_frame: ImageRef.optional(),
-    reference: ImageRef.optional(),
-    /**
-     * Reference-to-video: several images the model uses as visual guidance
-     * (this person, this product) instead of an exact opening frame. Mutually
-     * exclusive with `first_frame` — OpenRouter treats a request carrying both
-     * as image-to-video and ignores these, so wire one or the other.
-     */
-    references: z28.array(ImageRef).optional()
+    reference: ImageRef.optional()
   }).loose(),
   params: VideoGenerateParams,
   outputs: z28.object({ video: VideoRef }).strict(),
   outputKinds: { video: "video" },
-  // Priced from the shared contract, so `validate`'s quote and the charge the
-  // backend applies come from ONE table. A flat number here under-quoted a
-  // 1080p 8s clip by ~10x, and the agent reads this out to the user as "this
-  // will cost N" before spending it.
-  cost: ({ params }) => ({
-    credits: estimateVideoCredits({
-      model: params.model,
-      duration: params.duration,
-      resolution: params.resolution,
-      // Audio bills at a separate, higher rate on every model that offers it
-      // (Veo 3.1 doubles), so omitting it quotes half the real cost.
-      generateAudio: params.generate_audio
-    }),
-    seconds_estimate: 120
-  })
+  cost: () => ({ credits: 50, seconds_estimate: 120 })
 });
 
 // src/engine/nodes/remote/videoBackgroundRemove.ts
@@ -8019,4 +7941,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-S43JQWI2.js.map
+//# sourceMappingURL=chunk-OO5BDH3J.js.map