@koda-sl/baker-cli 0.364.0 → 0.365.0-dev.846b2e487

package/dist/cli.js

@@ -69,7 +69,7 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-AI4HWQVN.js";
+} from "./chunk-K2IKLMCM.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -78,7 +78,7 @@ import {
   resolveAccountIdArg,
   resolveEffectiveStatus,
   todayIso
-} from "./chunk-BLMXG42J.js";
+} from "./chunk-SR56QQTD.js";
 import {
   buildQueryCacheKey,
   cacheGet,
@@ -94,7 +94,7 @@ import {
   writeAdsJson,
   writeAdsOutput,
   writeJsonEnvelope
-} from "./chunk-A2LM5EDF.js";
+} from "./chunk-VVQLRFCI.js";
 import {
   ApiError,
   apiGet,
@@ -4394,7 +4394,7 @@ var CAPABILITY_SURFACE_SPECS = {
     provider: "google-analytics",
     resourceNoun: "property",
     // Like Tag Manager: staged during the chat, applied for real at publish,
-    // every time. A connection made before writes existed is
+    // with no simulated mode. A connection made before writes existed is
     // read-only until it is reconnected, and `access` does NOT say so — it
     // reports what the Baker app asks Google for, which is now app-wide
     // read-write. The per-company signal is `scopeBlockers`, which compares
@@ -8538,7 +8538,7 @@ var SURFACE_RULES = [
 ];
 var FAN_OUT_NUDGE_THRESHOLD = 2;
 var FAN_OUT_THRESHOLD = 3;
-var SCHEDULED_HINT = 'This reads as recurring/scheduled work. If it should run on a cadence or a future date, create a Scheduled agent instead \u2014 baker scheduled-agents create --cron "0 9 * * MON" (or --run-at, or --trigger for a reaction rather than a clock; guide: `__tooling__/docs/tools/baker/scheduled-agents.md`). Do not capture "set up a schedule" as a Work Action.';
+var SCHEDULED_HINT = 'This reads as recurring/scheduled work. If it should run on a cadence or a future date, create a Scheduled agent instead \u2014 baker scheduled-agents create --cron "0 9 * * MON" (or --run-at, or --trigger for a reaction rather than a clock; guide: `__tooling__/docs/tools/baker/scheduled-agents.md`). Do NOT capture "set up a schedule" as a Work Action.';
 function looksExecutable(name, description) {
   const foldedName = fold(name);
   const full = `${foldedName}
@@ -8789,7 +8789,7 @@ var claimCommand = defineCommand({
 import { defineCommand as defineCommand2 } from "citty";
 registerSchema({
   command: "actions.complete",
-  description: "Stage completion of an action (it was done). Accepts a real action ID (must be claimed) or a temp ID from the same draft. The action becomes completed when the chat is published. --note is required and must describe what you actually did to resolve it (what changed, where, and the outcome) \u2014 it is the client-facing record surfaced by `baker actions log`. Don't use this to drop an action you no longer want \u2014 to remove a staged op use `actions draft remove`, to close an unwanted published action use `actions discard`.",
+  description: "Stage completion of an action (it was DONE). Accepts a real action ID (must be claimed) or a temp ID from the same draft. The action becomes completed when the chat is published. --note is REQUIRED and must describe what you actually did to resolve it (what changed, where, and the outcome) \u2014 it is the client-facing record surfaced by `baker actions log`. Do NOT use this to drop an action you no longer want \u2014 to remove a staged op use `actions draft remove`, to close an unwanted published action use `actions discard`.",
   args: {
     id: { type: "string", description: "Action ID or temp ID", required: true },
     note: {
@@ -12529,7 +12529,7 @@ var PLANNER_FIELD_DESCRIPTIONS = {
 // src/commands/ads/google/keywords/discover.ts
 registerSchema({
   command: "ads.google.keywords.discover",
-  description: 'Discover keyword ideas from seed keywords or URLs. Returns { source: "keyword_planner_estimate", keywords, total_results, next_page_token? }. These are Keyword Planner estimates of total market search volume, not this account\'s data: every row carries a source column and every metric is prefixed planner_ (planner_avg_monthly_searches, planner_competition, ...). Never report a planner_ number as impressions, clicks or any account metric \u2014 read those with `baker ads google query` against the account. If --location and --language are omitted, they default to United States (2840) and English (1000); `query_context` shows which were used.',
+  description: 'Discover keyword ideas from seed keywords or URLs. Returns { source: "keyword_planner_estimate", keywords, total_results, next_page_token? }. THESE ARE ESTIMATES OF TOTAL MARKET SEARCH VOLUME, NOT THIS ACCOUNT\'S DATA: every row carries a source column and every metric is prefixed planner_ (planner_avg_monthly_searches, planner_competition, ...). Never report a planner_ number as impressions, clicks or any account metric \u2014 read those with `baker ads google query` against the account. IMPORTANT: If --location and --language are omitted, defaults to United States (2840) and English (1000). The response includes a query_context object showing which location/language were used.',
   args: {
     "customer-id": {
       type: "string",
@@ -12540,12 +12540,12 @@ registerSchema({
     url: { type: "string", description: "URL to extract keyword ideas from", required: false },
     location: {
       type: "string",
-      description: "Geo target ID. Defaults to 2840 (United States) if omitted \u2014 always set this for non-US markets",
+      description: "Geo target ID. DEFAULTS TO 2840 (United States) if omitted \u2014 always set this for non-US markets",
       required: false
     },
     language: {
       type: "string",
-      description: "Language ID. Defaults to 1000 (English) if omitted \u2014 always set this for non-English markets",
+      description: "Language ID. DEFAULTS TO 1000 (English) if omitted \u2014 always set this for non-English markets",
       required: false
     },
     limit: { type: "string", description: "Max keyword ideas (default: 20, max: 100)", required: false, default: 20 },
@@ -12706,7 +12706,7 @@ var locationsCommand = defineCommand25({
 import { defineCommand as defineCommand26 } from "citty";
 registerSchema({
   command: "ads.google.keywords.metrics",
-  description: 'Get historical market metrics for specific keywords. Returns { source: "keyword_planner_estimate", historical_metrics: [...] }. These are Keyword Planner estimates of total market search volume, not this account\'s data: every row carries a source column and every metric is prefixed planner_ (planner_avg_monthly_searches, planner_competition, ...). Never report a planner_ number as impressions, clicks or any account metric \u2014 read those with `baker ads google query` against the account. If --location and --language are omitted, they default to United States (2840) and English (1000); `query_context` shows which were used.',
+  description: 'Get historical market metrics for specific keywords. Returns { source: "keyword_planner_estimate", historical_metrics: [...] }. THESE ARE KEYWORD PLANNER ESTIMATES OF TOTAL MARKET SEARCH VOLUME, NOT THIS ACCOUNT\'S DATA: every row carries a source column and every metric is prefixed planner_ (planner_avg_monthly_searches, planner_competition, ...). Never report a planner_ number as impressions, clicks or any account metric \u2014 read those with `baker ads google query` against the account. IMPORTANT: If --location and --language are omitted, defaults to United States (2840) and English (1000). The response includes a query_context object showing which location/language were used.',
   args: {
     "customer-id": {
       type: "string",
@@ -12716,12 +12716,12 @@ registerSchema({
     keywords: { type: "string", description: "Comma-separated keywords to analyze (max 200)", required: true },
     location: {
       type: "string",
-      description: "Geo target ID. Defaults to 2840 (United States) if omitted \u2014 always set this for non-US markets",
+      description: "Geo target ID. DEFAULTS TO 2840 (United States) if omitted \u2014 always set this for non-US markets",
       required: false
     },
     language: {
       type: "string",
-      description: "Language ID. Defaults to 1000 (English) if omitted \u2014 always set this for non-English markets",
+      description: "Language ID. DEFAULTS TO 1000 (English) if omitted \u2014 always set this for non-English markets",
       required: false
     },
     output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
@@ -13635,7 +13635,7 @@ function completenessWarnings(read) {
   return [
     {
       code: "TRUNCATED_RESULTS",
-      message: `INCOMPLETE READ \u2014 ${cause} These rows are a page, not the data set. Don't count, total or describe them as the whole picture. ${fix}`
+      message: `INCOMPLETE READ \u2014 ${cause} These rows are a page, not the data set. Do NOT count, total or describe them as the whole picture. ${fix}`
     }
   ];
 }
@@ -18212,7 +18212,6 @@ var fileArg = {
     description: "The op payload: a JSON file path, or the JSON object inline (flags override it)"
   }
 };
-var STAGED_WRITE = "Stages only \u2014 applies to the live account when the chat is published. Field contract: `baker capabilities google-ads`.";
 var BUDGET_DEMAND_HINTS = [
   "Check this daily budget against the search volume you measured for these keywords, not against the plan you had before you measured it. A budget many times larger than the traffic the target pool can absorb never spends, and reads to the client as a number nobody costed.",
   "No volume measured yet? Pull it first \u2014 `baker ads google query --preset search-terms` for what the account already captures, `baker ads google keywords metrics` for the market estimate (those are planner figures, never account performance)."
@@ -18224,14 +18223,11 @@ var budgetsCommand = defineCommand31({
     // first. A budget several times what the target pool can absorb never spends, and reads to the
     // client as a plan nobody costed.
     create: defineCommand31({
-      meta: {
-        name: "create",
-        description: `Stage a daily campaign budget; campaigns reference it by the g_temp_* ref it returns (--budget-ref). ${STAGED_WRITE}`
-      },
+      meta: { name: "create", description: "Stage a campaign budget" },
       args: {
         ...customerIdArg,
         ...fileArg,
-        name: { type: "string", description: 'Budget name as shown in Google Ads (e.g. "Brand search \u2014 daily")' },
+        name: { type: "string", description: "Budget name" },
         amount: { type: "string", description: "Daily amount in major currency units (e.g. 50)" },
         delivery: { type: "string", description: "STANDARD | ACCELERATED" },
         shared: { type: "boolean", description: "Explicitly shared budget" }
@@ -18248,14 +18244,11 @@ var budgetsCommand = defineCommand31({
       }
     }),
     update: defineCommand31({
-      meta: {
-        name: "update",
-        description: `Stage a change to an existing budget's name, daily amount or delivery. ${STAGED_WRITE}`
-      },
+      meta: { name: "update", description: "Stage a budget update" },
       args: {
         ...customerIdArg,
         ...fileArg,
-        name: { type: "string", description: "New budget name as shown in Google Ads" },
+        name: { type: "string" },
         amount: { type: "string", description: "New daily amount in major currency units" },
         delivery: { type: "string" }
       },
@@ -18464,14 +18457,11 @@ var campaignsCommand = defineCommand31({
   meta: { name: "campaigns", description: "Stage campaign create/update/pause/resume/remove" },
   subCommands: {
     create: defineCommand31({
-      meta: {
-        name: "create",
-        description: `Stage a new campaign on a budget (--budget-ref); it is created paused unless --status ENABLED. ${STAGED_WRITE}`
-      },
+      meta: { name: "create", description: "Stage a campaign" },
       args: {
         ...customerIdArg,
         ...fileArg,
-        name: { type: "string", description: 'Campaign name, unique in the account (e.g. "Search \u2014 Brand \u2014 ES")' },
+        name: { type: "string" },
         "channel-type": {
           type: "string",
           description: "SEARCH | DISPLAY | SHOPPING | VIDEO | PERFORMANCE_MAX | DEMAND_GEN | \u2026"
@@ -18534,14 +18524,11 @@ var campaignsCommand = defineCommand31({
       }
     }),
     update: defineCommand31({
-      meta: {
-        name: "update",
-        description: `Stage a change to an existing campaign's name, budget, bidding or settings. ${STAGED_WRITE}`
-      },
+      meta: { name: "update", description: "Stage a campaign update" },
       args: {
         ...customerIdArg,
         ...fileArg,
-        name: { type: "string", description: "New campaign name, unique in the account" },
+        name: { type: "string" },
         "budget-ref": { type: "string" },
         "bidding-strategy": {
           type: "string",
@@ -18621,21 +18608,15 @@ var adGroupsCommand = defineCommand31({
   meta: { name: "ad-groups", description: "Stage ad group create/update/pause/resume/remove" },
   subCommands: {
     create: defineCommand31({
-      meta: {
-        name: "create",
-        description: `Stage a new ad group in a campaign (--campaign-ref); it is created paused unless --status ENABLED. ${STAGED_WRITE}`
-      },
+      meta: { name: "create", description: "Stage an ad group" },
       args: {
         ...customerIdArg,
         ...fileArg,
-        name: {
-          type: "string",
-          description: 'Ad group name, unique within its campaign (e.g. "Solar panels \u2014 price")'
-        },
+        name: { type: "string" },
         "campaign-ref": { type: "string", description: "Campaign ref (g_temp_*, id, or resource name)" },
         type: {
           type: "string",
-          description: "Ad group type \u2014 leave it out and Google derives it from the campaign's channel, which is required on a Demand Gen campaign (there is no Demand Gen ad group type). SEARCH_STANDARD | DISPLAY_STANDARD | SHOPPING_PRODUCT_ADS | VIDEO_*"
+          description: "Ad group type \u2014 leave it out and Google derives it from the campaign's channel, which is REQUIRED on a Demand Gen campaign (there is no Demand Gen ad group type). SEARCH_STANDARD | DISPLAY_STANDARD | SHOPPING_PRODUCT_ADS | VIDEO_*"
         },
         "cpc-bid": { type: "string", description: "Default CPC bid in major units" },
         status: { type: "string" }
@@ -18653,14 +18634,11 @@ var adGroupsCommand = defineCommand31({
       }
     }),
     update: defineCommand31({
-      meta: {
-        name: "update",
-        description: `Stage a change to an existing ad group's name, default CPC bid or status. ${STAGED_WRITE}`
-      },
+      meta: { name: "update", description: "Stage an ad group update" },
       args: {
         ...customerIdArg,
         ...fileArg,
-        name: { type: "string", description: "New ad group name, unique within its campaign" },
+        name: { type: "string" },
         "cpc-bid": { type: "string" },
         status: { type: "string" }
       },
@@ -19438,7 +19416,7 @@ var assetsCommand = defineCommand31({
     ),
     update: assetsUpdateCommand,
     attach: fileCreateCommand("attach", "google.assetLink.attach", "Attach an asset to a campaign/adGroup/customer", [
-      "Image extensions cannot be linked \u2014 Google refuses AD_IMAGE and every marketing-image field type at every level, on every API version \u2014 but stage the link anyway: it is skipped rather than stored, the rest of a batch is unaffected, and it is what records the handover Task naming those images and that campaign. That is the only record when the images are already in the account and you are uploading nothing. Then tell the user they are already in their Google Ads account and only need adding to the campaign under Assets; do not stage a second Task with `baker actions`. Two images that do link: the advertiser's logo through this command (`BUSINESS_LOGO`, campaign or customer level, on a verified account), and Performance Max asset-group images, which are a different mechanism (`asset-groups attach`)."
+      "Image extensions cannot be linked \u2014 Google refuses AD_IMAGE and every marketing-image field type at every level, on every API version \u2014 but stage the link anyway: it is skipped rather than stored, the rest of a batch is unaffected, and it is what records the handover Task naming those images and that campaign. That is the ONLY record when the images are already in the account and you are uploading nothing. Then tell the user they are already in their Google Ads account and only need adding to the campaign under Assets; do not stage a second Task with `baker actions`. Two images that DO link: the advertiser's logo through this command (`BUSINESS_LOGO`, campaign or customer level, on a verified account), and Performance Max asset-group images, which are a different mechanism (`asset-groups attach`)."
     ]),
     detach: statusCommand2("google.assetLink.detach", "asset link", [
       "Pass the resource name Google gave you \u2014 `SELECT campaign_asset.resource_name \u2026 FROM campaign_asset WHERE campaign_asset.status != 'REMOVED'` (or `ad_group_asset` / `customer_asset`) \u2014 never one composed out of an owner id and an asset id. A link's own status is not its campaign's and not its ad group's, so an inventory read scoped only to those lists extensions that are already detached, and a link between an asset and an owner that never held it parses fine and exists nowhere. Either way the target is read back before it is staged, and a detach of a link that is not there is refused here rather than at publish."
@@ -19448,14 +19426,14 @@ var assetsCommand = defineCommand31({
 var audienceModeArg = {
   mode: {
     type: "string",
-    description: "observation = the audience only adjusts bids, reach is unchanged | targeting = the ads are shown only to people in the audiences attached to this campaign/ad group"
+    description: "observation = the audience only adjusts bids, reach is unchanged | targeting = the ads are shown ONLY to people in the audiences attached to this campaign/ad group"
   }
 };
 function requireAudienceMode(value) {
   const mode = typeof value === "string" ? value.toLowerCase() : void 0;
   if (mode !== "observation" && mode !== "targeting") {
     failWriteValidation(
-      `pass --mode observation (the audience adjusts bids and reach is unchanged \u2014 the Google Ads interface's default) or --mode targeting (the ads are shown only to people in the audiences on this campaign/ad group). There is no safe default: the API's own default is targeting, which can cut a campaign's reach to the size of the list.`
+      `pass --mode observation (the audience adjusts bids and reach is unchanged \u2014 the Google Ads interface's default) or --mode targeting (the ads are shown ONLY to people in the audiences on this campaign/ad group). There is no safe default: the API's own default is targeting, which can cut a campaign's reach to the size of the list.`
     );
   }
   return mode === "observation" ? "OBSERVATION" : "TARGETING";
@@ -23949,7 +23927,7 @@ Performance \u2014 the workhorse (3 axes):
   baker ads linkedin analytics --list-intents
   baker ads linkedin analytics --list-pivots
 
-Staged writes (never hit LinkedIn directly \u2014 ops stage on this chat's draft,
+Staged writes (NEVER hit LinkedIn directly \u2014 ops stage on this chat's draft,
 show in the dashboard as pending LinkedIn changes, and apply when the chat is
 published, at which point they reach the real ad account):
   baker ads linkedin account url-params                             \u2014 UTMs for every ad in the account
@@ -26381,8 +26359,8 @@ Example: baker ads meta ads retag 120252158038400247 --url-tags "utm_source={{si
   run: async ({ args: args5 }) => {
     const { apiPost: apiPost2 } = await import("./client-3DGBQ2H3.js");
     const { requireChatId: requireChatId2 } = await import("./env-BSG7TY5Y.js");
-    const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-M2DBCZFG.js");
-    const { handleMetaError: handleMetaError2 } = await import("./shared-BROA3UXS.js");
+    const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-OSSBUGT7.js");
+    const { handleMetaError: handleMetaError2 } = await import("./shared-MSI4UMZ3.js");
     try {
       const accountId = bareAccountId2(args5);
       const urlTags = typeof args5["url-tags"] === "string" ? args5["url-tags"] : void 0;
@@ -26529,8 +26507,8 @@ function duplicateCommand2(entity, label) {
     run: async ({ args: args5 }) => {
       const { apiPost: apiPost2 } = await import("./client-3DGBQ2H3.js");
       const { requireChatId: requireChatId2 } = await import("./env-BSG7TY5Y.js");
-      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-M2DBCZFG.js");
-      const { handleMetaError: handleMetaError2 } = await import("./shared-BROA3UXS.js");
+      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-OSSBUGT7.js");
+      const { handleMetaError: handleMetaError2 } = await import("./shared-MSI4UMZ3.js");
       try {
         const accountId = bareAccountId2(args5);
         const chatId = requireChatId2();
@@ -33047,7 +33025,7 @@ var sourcesResponseSchema = z40.strictObject({
 import { defineCommand as defineCommand98 } from "citty";
 
 // src/commands/hubspot/refusal.ts
-var CONTINUE = "Keep going with the wider task: say which part you could not read, skip it, and finish everything else. If the `request_connection` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Tools \u2192 HubSpot.";
+var CONTINUE = "Do not abort the wider task: say which part you could not read, skip it, and finish everything else. If the `request_connection` tool is not available to you, point them at the dashboard, Brain -> Integrations -> Tools -> HubSpot.";
 function hubspotRefusal(code, message) {
   if (code === "NOT_FOUND" && message.includes(HUBSPOT_NOT_CONNECTED_MESSAGE)) {
     return {
@@ -33063,7 +33041,7 @@ function hubspotRefusal(code, message) {
       code: "HUBSPOT_RECONNECT_REQUIRED",
       fix: {
         action: "request_connection",
-        explanation: 'AGENT INSTRUCTION: HubSpot is connected \u2014 do not tell the user it is missing, and do not retry. Its access does not cover this read (it was connected before Baker asked for it, or the access was withdrawn), and only the user can widen it. Call the `request_connection` tool with { platform: "hubspot", reason } naming what you need to read; the card offers them a Reconnect button. Run this command again once they have. ' + CONTINUE
+        explanation: 'AGENT INSTRUCTION: HubSpot IS connected \u2014 do not tell the user it is missing, and do not retry. Its access does not cover this read (it was connected before Baker asked for it, or the access was withdrawn), and only the user can widen it. Call the `request_connection` tool with { platform: "hubspot", reason } naming what you need to read; the card offers them a Reconnect button. Run this command again once they have. ' + CONTINUE
       }
     };
   }
@@ -34566,8 +34544,8 @@ import { defineCommand as defineCommand105 } from "citty";
 import { defineCommand as defineCommand100 } from "citty";
 
 // src/commands/avatars/casting.ts
-var CAST_FLAG_RULE = "Cast with `--avatar <handle>` on `baker studio generate`, `baker studio animate`, `baker canvas scaffold-ad`, `baker canvas scaffold-static-ad` and `baker canvas scaffold-video`. Don't hand-roll it by pasting `subjectDescription` into the prompt or by passing the sheet through `--reference` \u2014 both render something that merely resembles them. `--avatar` is also the only thing that carries their accent and delivery into a clip. An avatar has no pinned voice by design (ADR 0005): the video model renders the voice, and the region on their profile is the only thing steering it \u2014 without the flag the clip is performed flat, in whatever accent the model picks on its own. `baker canvas scaffold-video` casts only their face: a reproduced video keeps the source ad's accent direction, so never tell the user it speaks in theirs.";
-var VERBATIM_RULE = "When you do write the description yourself \u2014 a hand-built canvas node, a landing image, anywhere `--avatar` does not exist \u2014 copy `subjectDescription` verbatim, word for word. Re-phrasing it per generation is the other reason a face drifts across a set.";
+var CAST_FLAG_RULE = "Cast with `--avatar <handle>` on `baker studio generate`, `baker studio animate`, `baker canvas scaffold-ad`, `baker canvas scaffold-static-ad` and `baker canvas scaffold-video`. Do NOT hand-roll it by pasting `subjectDescription` into the prompt or by passing the sheet through `--reference` \u2014 both render something that merely resembles them. `--avatar` is also the ONLY thing that carries their ACCENT and delivery into a clip. An avatar has no pinned voice by design (ADR 0005): the video model renders the voice, and the region on their profile is the only thing steering it \u2014 without the flag the clip is performed flat, in whatever accent the model picks on its own. `baker canvas scaffold-video` casts only their FACE: a reproduced video keeps the source ad's accent direction, so never tell the user it speaks in theirs.";
+var VERBATIM_RULE = "When you do write the description yourself \u2014 a hand-built canvas node, a landing image, anywhere `--avatar` does not exist \u2014 copy `subjectDescription` VERBATIM, word for word. Re-phrasing it per generation is the other reason a face drifts across a set.";
 var VIDEO_ROUTING = "In video, a photoreal presenter renders on `google/veo-3.1` (or `google/veo-3.1-fast`), never `bytedance/seedance-2.0` \u2014 it refuses photoreal human faces, AI-generated ones included. Reproducing a video the user gave you: `baker canvas scaffold-video \u2026 --avatar <handle> --real-face`.";
 function castingHints(avatar) {
   if (avatar.status === "generating" && avatar.needsFace) {
@@ -34661,7 +34639,7 @@ function creationHints(created, profile) {
   const casting = created.likeness === "synthetic" && created.faceChoice === "auto" ? [
     `No one was asked about this face \u2014 \`--face auto\` cast it and it is kept. Do not tell the user they chose it, and do not offer them a pick you are not going to run. If this should have been theirs, say so and create it again with \`--face ask\`.`
   ] : created.likeness === "synthetic" ? [
-    `The user is being shown real portraits of @${created.handle} right now, and the turn waits for them to pick \u2014 this happens on its own, triggered by the command you just ran. The picker is already showing, so don't call request_avatar_casting, don't ask about the face in a question of your own, and don't wait or poll: whatever you do next simply runs after they have chosen. Say what you created and get on with the work.`
+    `The user is being shown real portraits of @${created.handle} right now, and the turn waits for them to pick \u2014 this happens on its own, triggered by the command you just ran. Do NOT call request_avatar_casting, do not ask about the face in a question of your own, and do not wait or poll: whatever you do next simply runs after they have chosen. Say what you created and get on with the work.`
   ] : [];
   const hints2 = [
     ...casting,
@@ -34747,7 +34725,7 @@ function avatarFailureFix(err, handle, context = {}) {
   if (err.code === "CONFLICT" && handle) {
     return {
       action: "use_the_existing_avatar",
-      explanation: `@${handle} already exists in this company \u2014 avatars belong to the company, not to a chat, so one made in an earlier conversation is still here and still castable. If it is the person you want, use it as it is: \`--avatar ${handle}\`. Read it first with \`baker avatars get ${handle} --full\` and say who they already are. Do not create the same person under a second name: the user would be told about one avatar and handed another, and the company ends up with duplicates nobody chose a face for. If you genuinely need a different person, ask the user what to call them.`
+      explanation: `@${handle} already exists in THIS company \u2014 avatars belong to the company, not to a chat, so one made in an earlier conversation is still here and still castable. If it is the person you want, use it as it is: \`--avatar ${handle}\`. Read it first with \`baker avatars get ${handle} --full\` and say who they already are. Do NOT create the same person under a second name: the user would be told about one avatar and handed another, and the company ends up with duplicates nobody chose a face for. If you genuinely need a different person, ask the user what to call them.`
     };
   }
   return void 0;
@@ -34849,7 +34827,7 @@ registerSchema({
     },
     subject: {
       type: "string",
-      description: "The identity, reused verbatim in every render: one person, plainly described (age, build, hair, skin, face). No scene, no lighting, no camera, no wardrobe \u2014 those belong in the render prompt or in --wardrobe/--setting.",
+      description: "The identity, reused VERBATIM in every render: one person, plainly described (age, build, hair, skin, face). No scene, no lighting, no camera, no wardrobe \u2014 those belong in the render prompt or in --wardrobe/--setting.",
       required: true
     },
     persona: { type: "string", description: "Who they are on camera \u2014 role, attitude, energy", required: false },
@@ -35077,7 +35055,7 @@ async function waitForSheet(first, read, sleep4 = (ms) => new Promise((resolve5)
 // src/commands/avatars/get.ts
 registerSchema({
   command: "avatars.get",
-  description: "Read one avatar by handle \u2014 the command you run before casting it. Returns its status (only `ready` can be cast), the identity sheet URL every render must be grounded on via --reference, and the subject description that goes into the prompt verbatim. Add --full for the whole written profile (persona, speech, motion, wardrobe, setting, guardrails, voice, source photos).",
+  description: "Read one avatar by handle \u2014 the command you run before casting it. Returns its status (only `ready` can be cast), the identity sheet URL every render must be grounded on via --reference, and the subject description that goes into the prompt VERBATIM. Add --full for the whole written profile (persona, speech, motion, wardrobe, setting, guardrails, voice, source photos).",
   args: {
     handle: { type: "string", description: 'Avatar handle, e.g. "marta" (lowercase, dashes)', required: true },
     full: {
@@ -35326,7 +35304,7 @@ How casting works:
   2. baker avatars get <handle>               Status, identity sheet URL, subject description
   3. baker images generate "<scene>" --reference <sheetUrl>
                                               Ground the render on the identity sheet, never on a source photo,
-                                              and copy the subject description into the prompt verbatim
+                                              and copy the subject description into the prompt VERBATIM
 
 Examples:
   baker avatars list --status ready --output md
@@ -36186,7 +36164,7 @@ async function unresolvedAction(css, unresolved) {
   const { plans } = planFontAdoption(await astroSources(), unresolved);
   if (plans.length > 0) {
     const names = plans.map((p) => `"${p.family}"`).join(", ");
-    return `Run \`baker brand fonts adopt\` \u2014 ${names} is already self-hosted by ${plans[0]?.files.join(", ")}, so it only needs moving into ${GLOBAL_CSS} to load on every page. Don't fetch it: that downloads a different build of the same face.`;
+    return `Run \`baker brand fonts adopt\` \u2014 ${names} is already self-hosted by ${plans[0]?.files.join(", ")}, so it only needs moving into ${GLOBAL_CSS} to load on every page. Do NOT fetch it: that downloads a different build of the same face.`;
   }
   const viaFontsource = [...fontsourceFamilies(css)];
   const stranded = unresolved.filter((family) => viaFontsource.includes(family.toLowerCase()));
@@ -38652,7 +38630,7 @@ function emitScreenScene(i, scene, lengths, out, surfaceIngests, nodes, clips) {
       type: "ingest",
       params: {
         source: "path",
-        path: `[TODO: supply the real screen for "${label}" \u2014 never AI-generate a UI. Capture a clean, text-free screenshot with \`baker images screenshot https://<brand-domain>/<path>\` (image-library skill); spoken/overlay text rides the overlay layer, not the screenshot. Wire it in as a path relative to this canvas file, never an absolute path]`,
+        path: `[TODO: supply the REAL screen for "${label}" \u2014 NEVER AI-generate a UI. Capture a clean, text-free screenshot with \`baker images screenshot https://<brand-domain>/<path>\` (image-library skill); spoken/overlay text rides the overlay layer, not the screenshot. Wire it in as a path relative to this canvas file, never an absolute path]`,
         expect: "image"
       }
     });
@@ -38704,7 +38682,7 @@ function emitGraphicScene(i, scene, lengths, out, surfaceIngests, nodes, clips)
       type: "ingest",
       params: {
         source: "path",
-        path: `[TODO: supply the real designed graphic for "${label}" \u2014 never AI-generate a designed panel (its typography/wordmarks garble). Rebuild it as brand HTML in video-overlay-composition (the scene's text/logos are already seeded there), export the design from the brand kit, or source stock art; text rides the overlay layer, not this plate. Wire it in as a path relative to this canvas file, never an absolute path]`,
+        path: `[TODO: supply the REAL designed graphic for "${label}" \u2014 NEVER AI-generate a designed panel (its typography/wordmarks garble). Rebuild it as brand HTML in video-overlay-composition (the scene's text/logos are already seeded there), export the design from the brand kit, or source stock art; text rides the overlay layer, not this plate. Wire it in as a path relative to this canvas file, never an absolute path]`,
         expect: "image"
       }
     });
@@ -39787,13 +39765,13 @@ function uiSurfaceStub(blueprint, run, clock) {
   }) : [];
   const isGraphic = scenes.some((s) => (compositeRegionsOf(s) ?? []).some((r) => r.kind === "static_graphic"));
   const sourcing = isGraphic ? [
-    "     Build it as a real designed panel; never AI-generate its text/typography:",
+    "     Build it as a REAL designed panel, NEVER AI-generate its text/typography:",
     "       hand-build a brand-accurate HTML block in this composition (restyle the seeded",
     "       overlay text, or `npx hyperframes add <block>` for a ready-made card),",
     "     \u2014 OR drop the design asset (export it from the brand kit) as panel.png here;",
     "     then nest it as a timed clip:"
   ] : [
-    "     Build it as a real surface, never AI: capture the live page \u2014",
+    "     Build it as a REAL surface, NEVER AI: capture the live page \u2014",
     "       baker images screenshot https://<brand-domain>/<path>  (image-library skill)",
     "     \u2014 OR hand-build a brand-accurate HTML screen; then frame it in a phone mockup:",
     "       npx hyperframes add phone-scroll   (writes compositions/phone-scroll.html)",
@@ -40195,7 +40173,7 @@ function buildModelConstraints() {
     };
   }
   return {
-    note: "Switching a clip's video model has cross-node constraints. All video_generate nodes in one canvas must share one aspect_ratio (the composite silently crops otherwise). Each model's `duration` is a hard enum and differs per model \u2014 a scene longer than the model's max must be split. `person_generation` differs (Veo requires \"allow_all\"). `baker canvas validate` gates duration, aspect agreement, per-model params, and a scene-span-vs-model-max advisory before any billed run \u2014 run it after every model edit.",
+    note: "Switching a clip's video model has cross-node constraints. ALL video_generate nodes in one canvas MUST share ONE aspect_ratio (the composite silently crops otherwise). Each model's `duration` is a hard enum and differs per model \u2014 a scene longer than the model's max must be split. `person_generation` differs (Veo requires \"allow_all\"). `baker canvas validate` gates duration, aspect agreement, per-model params, AND a scene-span-vs-model-max advisory before any billed run \u2014 run it after every model edit.",
     models
   };
 }
@@ -40270,7 +40248,7 @@ function buildMotionBoard(blueprint) {
   });
 }
 var VIDEO_GUIDE = [
-  "Scaffolded by `baker canvas scaffold-video` \u2014 a runnable reproduction of your reference video, built like an editing timeline. It is a sequence of clear SHOTS separated at COMPLETE BREAKS (hard cuts): two adjacent presenter shots at a cut are TWO clips, never glued into one take. What stays continuous is the VOICE \u2014 a voiceover narration is ONE read across the b-roll it plays over, and a b-roll CUTAWAY between two on-camera moments leaves the presenter shot continuous with the insert sliced in \u2014 and each person keeps ONE brand voice (all their clips' native audio re-voiced in a single per-speaker pass), so timbre holds across the cuts. A presenter shot is ONE Seedance clip (native lip-sync + audio); a pure-voiceover stretch is one ElevenLabs tts read; a sub-2s flash is a still hold. A single shot too long for one clip splits into takes that share a boundary frame \u2014 the spine drops the duplicated frame (`--seam-dedup head|tail|off`). Every clip gets a CLEAN-PLATE start AND end keyframe (no baked text), RECAST to your dropped reference assets \u2014 Seedance interpolates real in-shot motion between them. Each frame grounds only on its own extracted frame + el_* slots (never another generated frame), so all frames render in PARALLEL (no cross-frame cascade). A SPLIT-SCREEN / PICTURE-IN-PICTURE / KEYED-PRESENTER scene is reproduced as one clip PER REGION, stacked or overlaid (see `metadata.todo.composition`). On-screen text/graphics are a separate HTML overlay layer you paint; audio is the voice + SFX + a ducked music bed, normalized stereo. It is a STARTING POINT, not a locked render: add, delete, reorder, split, merge, or re-time scenes freely \u2014 see `metadata.todo.full_flexibility`.",
+  "Scaffolded by `baker canvas scaffold-video` \u2014 a runnable reproduction of your reference video, built like an editing timeline. It is a sequence of clear SHOTS separated at COMPLETE BREAKS (hard cuts): two adjacent presenter shots at a cut are TWO clips, never glued into one take. What stays continuous is the VOICE \u2014 a voiceover narration is ONE read across the b-roll it plays over, and a b-roll CUTAWAY between two on-camera moments leaves the presenter shot continuous with the insert sliced in \u2014 and each person keeps ONE brand voice (all their clips' native audio re-voiced in a single per-speaker pass), so timbre holds across the cuts. A presenter shot is ONE Seedance clip (native lip-sync + audio); a pure-voiceover stretch is one ElevenLabs tts read; a sub-2s flash is a still hold. A single shot too long for one clip splits into takes that share a boundary frame \u2014 the spine drops the duplicated frame (`--seam-dedup head|tail|off`). Every clip gets a CLEAN-PLATE start AND end keyframe (no baked text), RECAST to your dropped reference assets \u2014 Seedance interpolates real in-shot motion between them. Each frame grounds ONLY on its own extracted frame + el_* slots (never another generated frame), so all frames render in PARALLEL (no cross-frame cascade). A SPLIT-SCREEN / PICTURE-IN-PICTURE / KEYED-PRESENTER scene is reproduced as one clip PER REGION, stacked or overlaid (see `metadata.todo.composition`). On-screen text/graphics are a separate HTML overlay layer you paint; audio is the voice + SFX + a ducked music bed, normalized stereo. It is a STARTING POINT, not a locked render: add, delete, reorder, split, merge, or re-time scenes freely \u2014 see `metadata.todo.full_flexibility`.",
   "",
   "WHAT TO DO NEXT:",
   "0. RE-CRAFT THE SCRIPT FIRST (don't clone). This reference already won in-market, but copying a video is much harder than a static: the hook is targeting and may not transfer, and the message must become TRUE for our brand. Work the `metadata.todo.script_recraft` checklist \u2014 for each scene judge its role (hook/body/CTA), decide keep/cut/reorder/replace, and re-author every line for OUR customer's pain + OUR offer. See `references/script-craft.md` (hook/body/CTA framework) and the `meta-ads-playbook` skill. Most of the work lives here.",
@@ -40311,7 +40289,7 @@ function recraftTextForRole(role, sceneIndex) {
     return `[RECRAFT HOOK \u2014 the #1 decision, but usually the LIGHTEST move wins: this hook already worked, so default to KEEPING it and building on top (swap only the specifics for ours). REBUILD only when it doesn't transfer \u2014 a claim we lack or a different funnel/awareness stage \u2014 by reaching for its deeper INNER MECHANIC and delivering that truthfully. DIAGNOSE (device + mechanic + stage) \u2192 DECIDE keep/adapt/rebuild \u2192 hold the opener to criteria: ${HOOK_OPENER_CRITERIA}. It lives on s${sceneIndex}_start (first frame) + the scene-${sceneIndex} overlay. See references/hook-craft.md + meta-ads-playbook \xA710/\xA739.]`;
   }
   if (role === "cta") {
-    return "[RECRAFT CTA \u2014 the close: state what to do (where to go) + what to expect (offer/bundle/discount) for OUR brand; soft for top-of-funnel, hard for bottom. Don't render the reference's words. See references/script-craft.md.]";
+    return "[RECRAFT CTA \u2014 the close: state what to do (where to go) + what to expect (offer/bundle/discount) for OUR brand; soft for top-of-funnel, hard for bottom. Do NOT render the reference's words. See references/script-craft.md.]";
   }
   return `[RECRAFT: rewrite this ${role} for OUR brand \u2014 true claims only; do NOT render the reference's words. See references/script-craft.md + meta-ads-playbook.]`;
 }
@@ -40394,7 +40372,7 @@ function buildVideoTodo(report, overlayCount, floatingCount, opts, blueprint) {
     // ALWAYS-ON safety net: the scaffold can only seed what the deconstruct
     // cataloged, and it under-detects on-image graphics + sound cues. Never trust
     // "none detected" — re-watch the reference and fill the gaps with the right tool.
-    completeness_check: 'The scaffold mirrors the deconstruct\'s catalog, which UNDER-DETECTS \u2014 never trust a 0 count. Re-watch the reference frame-by-frame and add anything missing: (1) ON-IMAGE GRAPHICS not in floating_elements (dollar/coin icons, emojis, checkmarks, rating stars, price tags, arrows, progress bars, app UI) \u2192 source each with `baker images icon "<desc>"` / `baker images sticker` / `baker images gif` / `baker images logo <domain>` and add it as an <img class="ov pos-* " data-start data-dur> in video-overlay-composition/index.html (never bake graphics into the frame plates). (2) SOUND CUES not in sound_effects (cha-ching/coin, whoosh, ding, pop, notification, keyboard) \u2192 add a `sound_effect` node (eleven_text_to_sound) and wire it onto `audio_mix` at its timestamp. (3) RECURRING people/animals/products/logos/sets with no el_* slot \u2192 add an `ingest` [TODO] slot and reference it from the frames they appear in. (4) Burned-in captions/text not in text_overlays \u2192 add an <img>-free <div class="ov"> in index.html. (5) ONE person playing MULTIPLE personas/wardrobes (skeptic vs believer, before vs after, two outfits) collapsed into a single el_* slot \u2192 split into one el_* slot PER look, each linked as the SAME individual via `same_as` so every outfit has its own reference image but the face/identity stays identical.',
+    completeness_check: 'The scaffold mirrors the deconstruct\'s catalog, which UNDER-DETECTS \u2014 never trust a 0 count. Re-watch the reference frame-by-frame and add anything missing: (1) ON-IMAGE GRAPHICS not in floating_elements (dollar/coin icons, emojis, checkmarks, rating stars, price tags, arrows, progress bars, app UI) \u2192 source each with `baker images icon "<desc>"` / `baker images sticker` / `baker images gif` / `baker images logo <domain>` and add it as an <img class="ov pos-* " data-start data-dur> in video-overlay-composition/index.html (NEVER bake graphics into the frame plates). (2) SOUND CUES not in sound_effects (cha-ching/coin, whoosh, ding, pop, notification, keyboard) \u2192 add a `sound_effect` node (eleven_text_to_sound) and wire it onto `audio_mix` at its timestamp. (3) RECURRING people/animals/products/logos/sets with no el_* slot \u2192 add an `ingest` [TODO] slot and reference it from the frames they appear in. (4) Burned-in captions/text not in text_overlays \u2192 add an <img>-free <div class="ov"> in index.html. (5) ONE person playing MULTIPLE personas/wardrobes (skeptic vs believer, before vs after, two outfits) collapsed into a single el_* slot \u2192 split into one el_* slot PER look, each linked as the SAME individual via `same_as` so every outfit has its own reference image but the face/identity stays identical.',
     scenes_clamped_to_15s: report.clamped_scenes,
     oversize_scenes: report.oversize_scenes.length > 0 ? {
       scenes: report.oversize_scenes,
@@ -42085,9 +42063,9 @@ ${describeRewrites(healed.rewrites)}
     }) : null;
     const hints2 = reviewable ? review === null ? [RENDER_REVIEW_UNAVAILABLE] : review.length === 0 ? ["Reviewed the finished video frame by frame \u2014 nothing to report."] : [
       `Reviewed the finished video and found ${review.length} thing${review.length === 1 ? "" : "s"} to fix. Show the user what is wrong before you show them the ad.`,
-      ...review.map((f) => `${f.severity === "blocking" ? "Must fix" : "Should fix"} \u2014 ${f.what}`),
+      ...review.map((f) => `${f.severity === "blocking" ? "MUST FIX" : "SHOULD FIX"} \u2014 ${f.what}`),
       ...review.some((f) => f.scene) ? [
-        `Anything about the mark or the closing card is a composition fix, not a re-render: both are drawn as HTML by the caption composition, so editing it and re-running re-renders only that pass \u2014 the clips are cached and no generation is paid for again. Fix them, then re-run: edit the \`show\` of the scene files named above \u2014 a shot with a person handling equipment is where limbs and objects go wrong, so widen it, move the hands out of frame, or drop the person from that beat. Re-running re-renders only the scenes you edited; everything else comes from the cache (this run: ${result.stats?.cached_nodes ?? 0} of ${result.stats?.total_nodes ?? 0} nodes were cached).`
+        `Anything about the MARK or the closing card is a composition fix, not a re-render: both are drawn as HTML by the caption composition, so editing it and re-running re-renders only that pass \u2014 the clips are cached and no generation is paid for again. Fix them, then re-run: edit the \`show\` of the scene files named above \u2014 a shot with a person handling equipment is where limbs and objects go wrong, so widen it, move the hands out of frame, or drop the person from that beat. Re-running re-renders ONLY the scenes you edited; everything else comes from the cache (this run: ${result.stats?.cached_nodes ?? 0} of ${result.stats?.total_nodes ?? 0} nodes were cached).`
       ] : []
     ] : [];
     if (poster) {
@@ -42991,12 +42969,12 @@ function fail3(code, message) {
   process.exit(2);
 }
 function resolveModels(args5) {
-  const pick = (flag, kind, fallback) => args5[flag] ? String(args5[flag]) : resolveModel(kind, fallback);
+  const pick2 = (flag, kind, fallback) => args5[flag] ? String(args5[flag]) : resolveModel(kind, fallback);
   return {
-    describeModel: pick("describe-model", "image_describe", "~google/gemini-pro-latest"),
-    selectModel: pick("select-model", "text_generate", "~google/gemini-flash-latest"),
-    layoutModel: pick("layout-model", "text_generate", "~google/gemini-flash-latest"),
-    genModel: pick("gen-model", "image_generate", "openai/gpt-image-2")
+    describeModel: pick2("describe-model", "image_describe", "~google/gemini-pro-latest"),
+    selectModel: pick2("select-model", "text_generate", "~google/gemini-flash-latest"),
+    layoutModel: pick2("layout-model", "text_generate", "~google/gemini-flash-latest"),
+    genModel: pick2("gen-model", "image_generate", "openai/gpt-image-2")
   };
 }
 var PLATFORM_PLACEMENTS = {
@@ -44197,7 +44175,7 @@ registerSchema({
     spec: {
       type: "string",
       required: true,
-      description: 'Path to the ad spec JSON. Shape: { format?, market?, brand?, cast?, end_card?, voice?, music?, beats: [{ say, show, on_camera?, cast? }] }. Fill `brand` from src/brand/BRAND.md \u2014 `palette` (its hex tokens, most important first) and `logo` (the repo path to the mark) are what make the ad look like the client rather than like stock. `market` is where the ad is set; omitted, it is inferred from the voice language, and getting it wrong is what fills a Spanish ad with British houses. `say` is one clause ending in its own punctuation \u2014 it becomes a caption card verbatim, so two sentences in one beat produce a card holding both. `show` is the shot brief for that line. Set `on_camera` only when that beat\'s subject talks to camera. A beat\'s `sound` is one sound effect for that shot, and most beats should not have one. Add it only where the picture shows a specific physical event the viewer expects to hear (a drill tightening a bolt, a door closing, rain on glass, a graphic snapping in). On a talking head or a calm lifestyle shot it reads as a stock sting, and one per beat turns a quiet ad into a noisy one. A music bed plus two well-placed effects beats eight. `voiceover: false` makes it a MUSIC-LED ad: nobody speaks, the `say` lines become on-screen text captioned straight from the script, and it needs `music`. `cast` is WHO the ad is about, and an ad with people in it needs one: `{ "avatar": "marta" }` names a cast avatar (`baker avatars list`) and every beat is grounded on that avatar\'s identity sheet with its subject description copied verbatim \u2014 the same face here as in the rest of the company\'s work. Without it each beat invents its own stranger, which is how one 28-second ad came back with five different men playing one customer. `{ "description": "..." }` is the fallback when there is no avatar, and it scaffolds a canvas that asks you to drop a photo before it can run \u2014 so prefer the avatar. A beat sets `cast: false` for a shot they are not in. `end_card` is on by default whenever `brand` is set: the last beat becomes a flat brand plate with the mark and a call to action drawn over it. `{ "cta": "..." }` sets the button copy \u2014 there is no default, so with no `cta` the card carries the mark alone, and a `cta` repeating the closing line is dropped rather than printed twice. `false` keeps the footage.'
+      description: 'Path to the ad spec JSON. Shape: { format?, market?, brand?, cast?, end_card?, voice?, music?, beats: [{ say, show, on_camera?, cast? }] }. Fill `brand` from src/brand/BRAND.md \u2014 `palette` (its hex tokens, most important first) and `logo` (the repo path to the mark) are what make the ad look like the client rather than like stock. `market` is where the ad is SET; omitted, it is inferred from the voice language, and getting it wrong is what fills a Spanish ad with British houses. `say` is ONE clause ending in its own punctuation \u2014 it becomes a caption card verbatim, so two sentences in one beat produce a card holding both. `show` is the shot brief for that line. Set `on_camera` ONLY when that beat\'s subject talks to camera. A beat\'s `sound` is one sound EFFECT for that shot \u2014 and MOST BEATS SHOULD NOT HAVE ONE. Add it only where the picture shows a specific physical event the viewer expects to hear (a drill tightening a bolt, a door closing, rain on glass, a graphic snapping in). On a talking head or a calm lifestyle shot it reads as a stock sting, and one per beat turns a quiet ad into a noisy one. A music bed plus two well-placed effects beats eight. `voiceover: false` makes it a MUSIC-LED ad: nobody speaks, the `say` lines become on-screen text captioned straight from the script, and it needs `music`. `cast` is WHO the ad is about, and an ad with people in it needs one: `{ "avatar": "marta" }` names a cast avatar (`baker avatars list`) and every beat is grounded on that avatar\'s identity sheet with its subject description copied verbatim \u2014 the same face here as in the rest of the company\'s work. Without it each beat invents its own stranger, which is how one 28-second ad came back with five different men playing one customer. `{ "description": "..." }` is the fallback when there is no avatar, and it scaffolds a canvas that asks you to drop a photo before it can run \u2014 so prefer the avatar. A beat sets `cast: false` for a shot they are not in. `end_card` is on by default whenever `brand` is set: the last beat becomes a flat brand plate with the mark and a call to action drawn over it. `{ "cta": "..." }` sets the button copy \u2014 there is no default, so with no `cta` the card carries the mark alone, and a `cta` repeating the closing line is dropped rather than printed twice. `false` keeps the footage.'
     },
     avatar: {
       type: "string",
@@ -44236,7 +44214,7 @@ function avatarVoiceBrief(avatar) {
 var scaffoldAdCommand = defineCommand115({
   meta: {
     name: "scaffold-ad",
-    description: 'Build a captioned vertical ad from a written spec, with no reference video to copy.\n\nA spec is a list of BEATS. One beat = one line the voice says + one shot on screen while it is said. That pairing is what keeps the ad honest: the caption card IS the line, so it can never end mid-sentence, and the picture can never drift from the read.\n\nTwo rules the spec enforces for you, both learned the expensive way:\n  \u2022 `say` is one clause with its own punctuation. Two sentences in a beat is rejected.\n  \u2022 Nobody in shot is speaking unless you set `on_camera` on that beat. A person visibly talking under a voice that is not theirs reads as bad dubbing.\n\nExample spec:\n  { "beats": [\n      { "say": "Mientras t\xFA sigues pagando la luz a precio de oro,", "show": "Aerial over Spanish rooftops at golden hour." },\n      { "say": "Haz clic en el enlace y reserva tu estudio gratuito.", "show": "A couple walking home at sunset." } ] }\n\nWho is in it:\n  `cast: { avatar: "marta" }` grounds every beat on that avatar\'s face \u2014 cast one with `baker avatars`.\n  Without a cast, each beat invents its own person and the ad reads as a stock-footage collage.\n\nHow it ends: with a `brand`, the last beat closes on a flat brand plate carrying the mark and the CTA.\n\nThen: baker canvas run <the canvas it writes>'
+    description: 'Build a captioned vertical ad from a written spec, with no reference video to copy.\n\nA spec is a list of BEATS. One beat = one line the voice says + one shot on screen while it is said. That pairing is what keeps the ad honest: the caption card IS the line, so it can never end mid-sentence, and the picture can never drift from the read.\n\nTwo rules the spec enforces for you, both learned the expensive way:\n  \u2022 `say` is ONE clause with its own punctuation. Two sentences in a beat is rejected.\n  \u2022 Nobody in shot is speaking unless you set `on_camera` on that beat. A person visibly talking under a voice that is not theirs reads as bad dubbing.\n\nExample spec:\n  { "beats": [\n      { "say": "Mientras t\xFA sigues pagando la luz a precio de oro,", "show": "Aerial over Spanish rooftops at golden hour." },\n      { "say": "Haz clic en el enlace y reserva tu estudio gratuito.", "show": "A couple walking home at sunset." } ] }\n\nWho is in it:\n  `cast: { avatar: "marta" }` grounds every beat on that avatar\'s face \u2014 cast one with `baker avatars`.\n  Without a cast, each beat invents its own person and the ad reads as a stock-footage collage.\n\nHow it ends: with a `brand`, the last beat closes on a flat brand plate carrying the mark and the CTA.\n\nThen: baker canvas run <the canvas it writes>'
   },
   args: {
     spec: { type: "string", required: true, description: "Path to the ad spec JSON" },
@@ -44422,7 +44400,7 @@ var scaffoldAdCommand = defineCommand115({
           message: resolvedLogo ? `The brand mark at \`${resolvedLogo}\` does not exist, so this ad has no logo to put on screen.` : `This company has no brand mark in \`${BRAND_DIR}/logos/\`, so an ad cannot carry its logo.`,
           // What the lookup against their own domain actually found, so the agent does not
           // go looking for the mark somewhere else — which is the loop this replaced.
-          fix: `${fetched?.reason ?? ""} Don't draw one or take one from an icon library: the mark is drawn on every frame and on the closing card, so a stand-in ships an ad wearing the wrong brand.`
+          fix: `${fetched?.reason ?? ""} Do NOT draw one and do NOT take one from an icon library: the mark is drawn on every frame and on the closing card, so a stand-in ships an ad wearing the wrong brand.`
         }
       });
       process.exit(1);
@@ -44603,7 +44581,7 @@ var scaffoldAdCommand = defineCommand115({
         // getting it wrong is expensive: the pictures cost a fraction of the clips, and
         // every defect anyone has caught in a finished ad was visible in them. The run
         // stops, the frames are shown, and continuing pays for none of them twice.
-        handle || staged ? `Wrote ${spec.data.beats.length} beats to ${outPath}. Run it with \`baker canvas run ${outPath} --until frames --brief "<what they asked for, their words>"\`, show the frames it returns and ask whether to carry on \u2014 then continue with the \`--run-id\` it gives you. This ad carries ${handle ? "a person's face" : "the client's mark"}, and a wrong look costs a whole ad to discover after the clips.` : `Wrote ${spec.data.beats.length} beats to ${outPath}. Run it with \`baker canvas run ${outPath} --brief "<what they asked for, their words>"\`.`,
+        handle || staged ? `Wrote ${spec.data.beats.length} beats to ${outPath}. Run it with \`baker canvas run ${outPath} --until frames --brief "<what they asked for, their words>"\`, SHOW the frames it returns and ask whether to carry on \u2014 then continue with the \`--run-id\` it gives you. This ad carries ${handle ? "a person's face" : "the client's mark"}, and a wrong look costs a whole ad to discover after the clips.` : `Wrote ${spec.data.beats.length} beats to ${outPath}. Run it with \`baker canvas run ${outPath} --brief "<what they asked for, their words>"\`.`,
         ...autoCast ? [
           `Cast \`${autoCast}\` \u2014 the spec described this person in words, and they are one of this company's avatars. Every shot now grounds on their identity sheet and carries their accent and delivery. Write \`"cast": { "avatar": "` + autoCast + '" }` yourself next time; a written description is for someone the company does not have.'
         ] : [],
@@ -44645,7 +44623,7 @@ var scaffoldAdCommand = defineCommand115({
           // ad with no palette and no mark anywhere in 28 seconds.
           `This spec has no ${!spec.data.brand?.palette?.length ? "`brand.palette`" : ""}${!spec.data.brand?.palette?.length && !spec.data.brand?.logo ? " and no " : ""}${!spec.data.brand?.logo ? "`brand.logo`" : ""}. Read src/brand/BRAND.md and re-run with them \u2014 a name alone leaves the ad in someone else's clothes.`
         ],
-        "`brand.palette` colours the closing plate the card sits on; `brand.logo` is the repo path to the mark, and it is drawn by the composition \u2014 top-left throughout and large on the closing card \u2014 never generated as a picture, so it cannot come back garbled. Give it whenever the client has one."
+        "`brand.palette` colours the closing plate the card sits on; `brand.logo` is the repo path to the mark, and it is DRAWN by the composition \u2014 top-left throughout and large on the closing card \u2014 never generated as a picture, so it cannot come back garbled. Give it whenever the client has one."
       ]
     });
   }
@@ -44653,7 +44631,7 @@ var scaffoldAdCommand = defineCommand115({
 function shortBeatHint(short, total) {
   if (short.length === 0) return [];
   return [
-    `Beat${short.length === 1 ? "" : "s"} ${short.join(", ")} of ${total} ${short.length === 1 ? "is" : "are"} a fragment rather than a line \u2014 a few words with a whole shot to themselves. Every beat's picture holds for at least ${SPOKEN_CLIP_DURATION_S}s, so a two-word beat buys six seconds of somebody standing still, and a run of those plays as a slideshow rather than an ad. Don't pad them. Merge them into the beat before or after, so each one carries a whole thought. Edit the spec and re-run this command.`
+    `Beat${short.length === 1 ? "" : "s"} ${short.join(", ")} of ${total} ${short.length === 1 ? "is" : "are"} a fragment rather than a line \u2014 a few words with a whole shot to themselves. Every beat's picture holds for at least ${SPOKEN_CLIP_DURATION_S}s, so a two-word beat buys six seconds of somebody standing still, and a run of those plays as a slideshow rather than an ad. Do NOT pad them. Merge them into the beat before or after, so each one carries a whole thought. Edit the spec and re-run this command.`
   ];
 }
 async function fetchClientLogo() {
@@ -45030,18 +45008,18 @@ function parseBudget(raw) {
   throw new Error(`--budget must be one of ${VIDEO_BUDGETS.join(", ")} (got "${v}")`);
 }
 function resolveModels2(args5) {
-  const pick = (flag, kind, fallback) => args5[flag] ? String(args5[flag]) : resolveModel2(kind, fallback);
+  const pick2 = (flag, kind, fallback) => args5[flag] ? String(args5[flag]) : resolveModel2(kind, fallback);
   return {
     // Flash by default: ~2-3× faster per call than Pro, which keeps each
     // per-scene deconstruct step well inside the action time budget and turns a
     // ~9 min run into ~3-4 min. Override with --deconstruct-model
     // ~google/gemini-pro-latest for the densest extraction when speed matters less.
-    deconstructModel: pick("deconstruct-model", "video_deconstruct", "~google/gemini-flash-latest"),
-    selectModel: pick("select-model", "text_generate", "~google/gemini-flash-latest"),
+    deconstructModel: pick2("deconstruct-model", "video_deconstruct", "~google/gemini-flash-latest"),
+    selectModel: pick2("select-model", "text_generate", "~google/gemini-flash-latest"),
     // Default to the strongest image model (matches the static-ad scaffold); the
     // frame generators need the most faithful text/identity reproduction. Override
     // with --image-model for a cheaper/faster pass.
-    imageModel: pick("image-model", "image_generate", "openai/gpt-image-2.5-sunburst")
+    imageModel: pick2("image-model", "image_generate", "openai/gpt-image-2.5-sunburst")
   };
 }
 function hasPhotorealCast(elements) {
@@ -45673,7 +45651,7 @@ function capabilityHints(surfaces, tools = []) {
   const immediate = surfaces.filter((surface) => surface.writeMode === "applies-at-publish");
   if (immediate.length > 0) {
     hints2.push(
-      `REAL AND IMMEDIATE: ${immediate.map((s) => s.label).join(", ")}. Completing this chat changes the user's live setup, so agree the changes before you finish, not after.`
+      `REAL AND IMMEDIATE: ${immediate.map((s) => s.label).join(", ")} \u2014 no simulated mode. Completing this chat changes the user's live setup, so agree the changes before you finish, not after.`
     );
   }
   const blocked = surfaces.filter((surface) => surface.blockers.length > 0);
@@ -50795,12 +50773,12 @@ function handleError5(err) {
         ...readOnly ? {
           fix: {
             action: "reconnect",
-            explanation: "The Google Analytics connection is read-only. Ask the user to reconnect Google Analytics \u2014 in the dashboard, Brain \u2192 Integrations \u2192 Tools \u2192 Google Analytics \u2014 which grants the permission to change the property. Reporting (`baker ga4 query`, `baker ga4 audit`) keeps working meanwhile, so carry on with the rest of the job and tell them what you will set up once they have reconnected. Don't claim anything was configured."
+            explanation: "The Google Analytics connection is read-only. Ask the user to reconnect Google Analytics \u2014 in the dashboard, Brain \u2192 Integrations \u2192 Tools \u2192 Google Analytics \u2014 which grants the permission to change the property. Reporting (`baker ga4 query`, `baker ga4 audit`) keeps working meanwhile, so carry on with the rest of the job and tell them what you will set up once they have reconnected. Do NOT claim anything was configured."
           }
         } : err.code === "UNAUTHORIZED" || err.code === "FORBIDDEN" && isNotConnectedError(err.code, err.message) ? {
           fix: {
             action: "request_connection",
-            explanation: 'Google Analytics is not connected for this company yet, or no property has been picked. Don\'t send the user to Settings \u2014 call the `request_connection` tool with { platform: "google-analytics", reason } and they connect and pick their property from inside the chat. If the `request_connection` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Tools \u2192 Google Analytics. Then carry on with the rest of the task.'
+            explanation: 'Google Analytics is not connected for this company yet, or no property has been picked. Do NOT send the user to Settings \u2014 call the `request_connection` tool with { platform: "google-analytics", reason } and they connect and pick their property from inside the chat. If `request_connection` is not available to you, say so plainly and point them at dashboard \u2192 Brain \u2192 Integrations \u2192 Tools \u2192 Google Analytics. Carry on with the rest of the task meanwhile.'
           }
         } : {},
         retryable: RETRYABLE_CODES.has(err.code)
@@ -51673,7 +51651,7 @@ Examples:
 });
 registerSchema({
   command: "ga4.audience",
-  description: "Create an audience (a saved group of users, e.g. everyone who started a demo but never finished), rename one, or archive one. Read `baker ga4 config` first to see the audiences that already exist. Everything that defines who is in an audience \u2014 the conditions, the membership window \u2014 is frozen the moment it is created and cannot be edited afterwards, so get it right in one go. An audience only reaches Google Ads for retargeting if the property is linked to a Google Ads account.",
+  description: "Create an audience (a saved group of users, e.g. everyone who started a demo but never finished), rename one, or archive one. Read `baker ga4 config` first to see the audiences that already exist. IMPORTANT: everything that defines who is in an audience \u2014 the conditions, the membership window \u2014 is frozen the moment it is created and cannot be edited afterwards, so get it right in one go. An audience only reaches Google Ads for retargeting if the property is linked to a Google Ads account.",
   args: {
     json: { type: "string", description: createJsonDescription("audience"), required: false },
     file: { type: "string", description: "Path to a JSON file with the definition", required: false },
@@ -58474,7 +58452,7 @@ var addCommand = defineCommand172({
         "This page was already in the library, so nothing was re-studied \u2014 its sections are searchable now.",
         `Search it with: baker landing inspiration search --domain ${new URL(data.canonicalUrl).hostname}`
       ] : [
-        "Studying this page takes a few minutes. Don't wait on it \u2014 carry on, and search for it later in the turn or in a later one.",
+        "Studying this page takes a few minutes. Do NOT wait on it \u2014 carry on, and search for it later in the turn or in a later one.",
         "Meanwhile, search what is already in the library: baker landing inspiration search '<what you want to see>' --scope all",
         "This is saved and being studied now, so it is listed as already applied \u2014 tell the user it is kept whatever they do with this chat.",
         // The save is not a promise that the study succeeded. An agent that
@@ -61820,7 +61798,7 @@ var variantCommand = defineCommand181({
       change: String(args5.change)
     });
     const hints2 = [
-      forks.length === 0 ? `MISSING --fork: ${variantSlug2} currently renders exactly ${controlSlug}, so a test between them cannot conclude anything. Re-run with --fork <Component>, or copy the one section your change touches into src/pages/${variantSlug2}/_components/ and repoint that import.` : `Edit only src/pages/${variantSlug2}/_components/${forks.join(", ")} \u2014 every other section is shared with ${controlSlug}, and editing a shared one changes both arms at once.`,
+      forks.length === 0 ? `MISSING --fork: ${variantSlug2} currently renders exactly ${controlSlug}, so a test between them cannot conclude anything. Re-run with --fork <Component>, or copy the one section your change touches into src/pages/${variantSlug2}/_components/ and repoint that import.` : `Edit ONLY src/pages/${variantSlug2}/_components/${forks.join(", ")} \u2014 every other section is shared with ${controlSlug}, and editing a shared one changes both arms at once.`,
       `Preview both at http://localhost:4321/${controlSlug}/ and http://localhost:4321/${variantSlug2}/ and check they differ only where you meant. Once it is live, only the first of those two answers \u2014 a variant has no public address of its own, and \`/${controlSlug}/?_bkr_preview=b\` is how anyone looks at it.`,
       `Then: baker experiment start --landing ${controlSlug} --variant ${variantSlug2} --because "${String(args5.because)}" --change "${String(args5.change)}". Nothing is split until the session is published \u2014 the person publishing is the review of this page.`
     ];
@@ -62137,7 +62115,7 @@ import { defineCommand as defineCommand196 } from "citty";
 import { defineCommand as defineCommand184 } from "citty";
 
 // src/commands/research/hints.ts
-var AD_COPY_ROUTE = 'This returns competing domains and their SERP economics \u2014 no ad copy, no headlines, no creative. For the actual copy of a competitor\'s ads: `baker winning-ads advertisers "<brand>"` \u2192 `baker winning-ads search "<brief>" --advertiser-id <id>` \u2192 `baker winning-ads content <adId>` (`primary_text` / `headline` / `cta`, plus the spoken transcript and on-screen text for video). That corpus is Meta and LinkedIn only \u2014 Google SERP ad copy is not available through any Baker command, so do not keep querying for it here.';
+var AD_COPY_ROUTE = 'This returns competing DOMAINS and their SERP economics \u2014 no ad copy, no headlines, no creative. For the actual copy of a competitor\'s ads: `baker winning-ads advertisers "<brand>"` \u2192 `baker winning-ads search "<brief>" --advertiser-id <id>` \u2192 `baker winning-ads content <adId>` (`primary_text` / `headline` / `cta`, plus the spoken transcript and on-screen text for video). That corpus is Meta and LinkedIn only \u2014 Google SERP ad copy is not available through any Baker command, so do not keep querying for it here.';
 function noSerpRowsHints(rowCount2, queryContext) {
   if (rowCount2 > 0) {
     return [];
@@ -62308,7 +62286,7 @@ function handleResearchError(err, fixFor) {
 // src/commands/research/advertisers.ts
 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 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. IMPORTANT: 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",
@@ -62317,12 +62295,12 @@ registerSchema({
     },
     location: {
       type: "string",
-      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted \u2014 always set this for non-US markets",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted \u2014 always set this for non-US markets",
       required: false
     },
     language: {
       type: "string",
-      description: "Language code or name (en, es, spanish...). Defaults to en (English) if omitted \u2014 always set this for non-English markets",
+      description: "Language code or name (en, es, spanish...). DEFAULTS TO en (English) if omitted \u2014 always set this for non-English markets",
       required: false
     },
     limit: { type: "string", description: "Max results (default: 20, max: 100)", required: false },
@@ -62395,17 +62373,17 @@ Examples:
 import { defineCommand as defineCommand185 } from "citty";
 registerSchema({
   command: "research.autocomplete",
-  description: "Get Google Autocomplete suggestions for a seed keyword. Useful for keyword expansion and discovering what people actually search for. If --location and --language are omitted, defaults to United States (us) and English (en).",
+  description: "Get Google Autocomplete suggestions for a seed keyword. Useful for keyword expansion and discovering what people actually search for. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en).",
   args: {
     keyword: { type: "string", description: "Seed keyword (positional)", required: true },
     location: {
       type: "string",
-      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted",
       required: false
     },
     language: {
       type: "string",
-      description: "Language code or name. Defaults to en (English) if omitted",
+      description: "Language code or name. DEFAULTS TO en (English) if omitted",
       required: false
     },
     limit: { type: "string", description: "Max suggestions (default: 10, max: 20)", required: false },
@@ -62691,7 +62669,7 @@ Examples:
 import { defineCommand as defineCommand188 } from "citty";
 registerSchema({
   command: "research.intent",
-  description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
+  description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. IMPORTANT: If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
   args: {
     keywords: {
       type: "string",
@@ -62700,7 +62678,7 @@ registerSchema({
     },
     language: {
       type: "string",
-      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English keywords",
+      description: "Language code or name. DEFAULTS TO en (English) if omitted \u2014 always set this for non-English keywords",
       required: false
     },
     "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
@@ -62762,18 +62740,18 @@ Examples:
 import { defineCommand as defineCommand189 } from "citty";
 registerSchema({
   command: "research.keyword-gap",
-  description: "Find keywords a competitor ranks for (organic or paid) that you don't. Discovers expansion opportunities. 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: "Find keywords a competitor ranks for (organic or paid) that you don't. Discovers expansion opportunities. IMPORTANT: 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: {
     competitor: { type: "string", description: "Competitor domain (positional 1)", required: true },
     ours: { type: "string", description: "Your domain (positional 2)", required: true },
     location: {
       type: "string",
-      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States); set it for any non-US market.",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted \u2014 always set this for non-US markets",
       required: false
     },
     language: {
       type: "string",
-      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English markets",
+      description: "Language code or name. DEFAULTS TO en (English) if omitted \u2014 always set this for non-English markets",
       required: false
     },
     type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
@@ -62913,7 +62891,7 @@ function keywordMetricsFields(options) {
 // src/commands/research/keyword-metrics.ts
 registerSchema({
   command: "research.keyword-metrics",
-  description: "Search volume, CPC, top-of-page bids and competition for a list of keywords you name \u2014 no domain needed. This is the command for sizing a market you have keywords for; the domain-bound ones (keywords-for-site, keyword-gap) answer a different question and should not be used as a workaround for this one. The volume is Google's Keyword Planner figure resold by DataForSEO, so it is not a second opinion on `baker ads google keywords metrics` \u2014 for that, pass --clickstream. 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: "Search volume, CPC, top-of-page bids and competition for a list of keywords YOU name \u2014 no domain needed. This is the command for sizing a market you have keywords for; the domain-bound ones (keywords-for-site, keyword-gap) answer a different question and should not be used as a workaround for this one. The volume is Google's Keyword Planner figure resold by DataForSEO, so it is NOT a second opinion on `baker ads google keywords metrics` \u2014 for that, pass --clickstream. IMPORTANT: 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: {
     keywords: {
       type: "string",
@@ -62922,12 +62900,12 @@ registerSchema({
     },
     location: {
       type: "string",
-      description: "Country code (us, mx, br, es...) or DataForSEO location code. Defaults to us (United States) if omitted \u2014 always set this for non-US markets",
+      description: "Country code (us, mx, br, es...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted \u2014 always set this for non-US markets",
       required: false
     },
     language: {
       type: "string",
-      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English markets",
+      description: "Language code or name. DEFAULTS TO en (English) if omitted \u2014 always set this for non-English markets",
       required: false
     },
     clickstream: {
@@ -63028,17 +63006,17 @@ Examples:
 import { defineCommand as defineCommand191 } from "citty";
 registerSchema({
   command: "research.keywords-for-site",
-  description: "Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. 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: "Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. IMPORTANT: 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: {
     target: { type: "string", description: "Domain or URL to analyze (positional)", required: true },
     location: {
       type: "string",
-      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted \u2014 always set this for non-US markets",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted \u2014 always set this for non-US markets",
       required: false
     },
     language: {
       type: "string",
-      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English markets",
+      description: "Language code or name. DEFAULTS TO en (English) if omitted \u2014 always set this for non-English markets",
       required: false
     },
     sort: {
@@ -63221,17 +63199,17 @@ Examples:
 import { defineCommand as defineCommand194 } from "citty";
 registerSchema({
   command: "research.relevant-pages",
-  description: "Get the top pages of a competitor domain with organic traffic and ranking data. Shows which pages drive the most traffic. If --location and --language are omitted, defaults to United States (us) and English (en).",
+  description: "Get the top pages of a competitor domain with organic traffic and ranking data. Shows which pages drive the most traffic. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en).",
   args: {
     target: { type: "string", description: "Domain to analyze (positional, e.g. competitor.com)", required: true },
     location: {
       type: "string",
-      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted",
       required: false
     },
     language: {
       type: "string",
-      description: "Language code or name. Defaults to en (English) if omitted",
+      description: "Language code or name. DEFAULTS TO en (English) if omitted",
       required: false
     },
     limit: { type: "string", description: "Max results (default: 20, max: 1000)", required: false },
@@ -65869,7 +65847,7 @@ function handleError8(err) {
         ...err.code === "UNAUTHORIZED" || err.code === "FORBIDDEN" && isNotConnectedError(err.code, err.message) ? {
           fix: {
             action: "request_connection",
-            explanation: 'Tag Manager is not connected for this company yet, or no container has been picked. Don\'t send the user to Settings \u2014 call the `request_connection` tool with { platform: "google-tag-manager", reason } and they connect and pick their containers (they can pick more than one) from inside the chat. `request_tag_input` is not the route: that form manages the container snippet on the site, not what runs inside the container, and it cannot pick a container. If the `request_connection` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Tools \u2192 Google Tag Manager, where they also pick the container. Then carry on with the rest of the task.'
+            explanation: 'Tag Manager is not connected for this company yet, or no container has been picked. Do NOT send the user to Settings \u2014 call the `request_connection` tool with { platform: "google-tag-manager", reason } and they connect and pick their containers (they can pick more than one) from inside the chat. `request_tag_input` is NOT the route: that form manages the container snippet on the site, not what runs inside the container, and it cannot pick a container. If `request_connection` is not available to you, say so plainly and point them at dashboard \u2192 Brain \u2192 Integrations \u2192 Tools \u2192 Google Tag Manager, where they also pick the container. Carry on with the rest of the task meanwhile.'
           }
         } : {},
         retryable: RETRYABLE_CODES2.has(err.code)
@@ -66383,7 +66361,7 @@ ${configLines.join("\n")}` : header;
 function tagsListHints() {
   return [
     "To create, edit or delete a tag, call the `request_tag_input` approval form (tool `mcp__baker_ui__request_tag_input`, server `baker_ui`) \u2014 it is attached to every turn of this chat and collects any secret values itself.",
-    "Don't conclude the form is unavailable from your tool list: call it, and report what it returns. And never file a tag change as a Task \u2014 a Task hands the user work this chat can stage in one call."
+    "Do NOT conclude the form is unavailable from your tool list: call it, and report what it returns. And never file a tag change as a Task \u2014 a Task hands the user work this chat can stage in one call."
   ];
 }
 
@@ -66455,7 +66433,7 @@ var tagsCommand4 = defineCommand222({
     name: "tags",
     description: `Read the client's marketing/analytics tags (Meta pixel, GA4, Google Ads, GTM, Clarity, Hotjar, \u2026) \u2014 production tags plus the changes staged in this chat.
 
-This command is read-only. Every tag change \u2014 create, edit, or delete \u2014 goes through the request_tag_input tool (baker_ui MCP server): propose one or more changes (each becomes a tab in one approval form), pre-fill the non-secret fields you know, and the user reviews, fills secrets, and approves or skips each. Secret values (accessToken, apiSecret, authorizationToken, apiKey, conversionToken, OAuth connections) never pass through the CLI or the chat.
+This command is READ-ONLY. Every tag change \u2014 create, edit, or delete \u2014 goes through the request_tag_input tool (baker_ui MCP server): propose one or more changes (each becomes a tab in one approval form), pre-fill the non-secret fields you know, and the user reviews, fills secrets, and approves or skips each. Secret values (accessToken, apiSecret, authorizationToken, apiKey, conversionToken, OAuth connections) never pass through the CLI or the chat.
 
 Refs: \`baker tags list\` prints each tag's ref \u2014 a real tag id, or tag_temp_* for creates staged in this chat. Use these refs as flow side-effect tagIds; they keep resolving after publish.
 
@@ -69246,6 +69224,141 @@ function outputFlagForCommand(root, argv) {
   });
 }
 
+// src/field-mask.ts
+var FLAG2 = "--fields";
+function parseFields(value) {
+  return value.split(",").map((field) => field.trim()).filter((field) => field.length > 0);
+}
+function takeFieldsFlag(root, argv) {
+  const end = argv.indexOf("--");
+  const limit = end === -1 ? argv.length : end;
+  const taken = /* @__PURE__ */ new Set();
+  const fields = [];
+  for (let index = 0; index < limit; index++) {
+    const token = argv[index] ?? "";
+    if (token.startsWith(`${FLAG2}=`)) {
+      taken.add(index);
+      fields.push(...parseFields(token.slice(FLAG2.length + 1)));
+    } else if (token === FLAG2) {
+      const value = argv[index + 1];
+      if (value === void 0 || index + 1 >= limit || value.startsWith("-")) {
+        return { argv, fields: null };
+      }
+      taken.add(index).add(index + 1);
+      fields.push(...parseFields(value));
+      index++;
+    }
+  }
+  if (taken.size === 0 || fields.length === 0) {
+    return { argv, fields: null };
+  }
+  const command = commandFor(root, argv);
+  if (!command || declaredArg(command, "fields") || PRINTS_NO_ENVELOPE.has(commandPathOf(root, argv))) {
+    return { argv, fields: null };
+  }
+  return { argv: argv.filter((_, index) => !taken.has(index)), fields };
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pick(record, fields) {
+  return Object.fromEntries(fields.filter((field) => field in record).map((field) => [field, record[field]]));
+}
+function wrappedList(data, fields) {
+  if (fields.some((field) => field in data)) {
+    return null;
+  }
+  const lists = Object.entries(data).filter(
+    ([, value]) => Array.isArray(value) && value.length > 0 && value.every((item) => isRecord3(item))
+  );
+  return lists.length === 1 ? lists[0]?.[0] ?? null : null;
+}
+function recordsOf(data, fields) {
+  if (Array.isArray(data)) {
+    return data;
+  }
+  if (!isRecord3(data)) {
+    return [];
+  }
+  const list = wrappedList(data, fields);
+  return list === null ? [data] : data[list];
+}
+function maskData(data, fields) {
+  const mask = (item) => isRecord3(item) ? pick(item, fields) : item;
+  if (Array.isArray(data)) {
+    return data.map(mask);
+  }
+  if (!isRecord3(data)) {
+    return data;
+  }
+  const list = wrappedList(data, fields);
+  return list === null ? pick(data, fields) : { ...data, [list]: recordsOf(data, fields).map(mask) };
+}
+function unmatchedHint(data, fields) {
+  const records = recordsOf(data, fields).filter(isRecord3);
+  if (records.length === 0) {
+    return null;
+  }
+  const carried = new Set(records.flatMap((record) => Object.keys(record)));
+  const unmatched = fields.filter((field) => !carried.has(field));
+  if (unmatched.length === 0) {
+    return null;
+  }
+  return `--fields matched nothing for: ${unmatched.join(", ")}. The keys data carries are: ${[...carried].join(", ")}.`;
+}
+function reprint(text2, envelope) {
+  const indent = text2.trimStart().startsWith("{\n") ? 2 : void 0;
+  return `${JSON.stringify(envelope, null, indent)}${text2.endsWith("\n") ? "\n" : ""}`;
+}
+function withHint(envelope, hint) {
+  return { ...envelope, hints: [...Array.isArray(envelope.hints) ? envelope.hints : [], hint] };
+}
+var NO_DATA_HINT = "--fields was not applied: this result carries no data to narrow, so it is printed whole. Drop --fields on this command.";
+function maskPrintedEnvelope(text2, fields) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text2);
+  } catch {
+    return null;
+  }
+  if (!isRecord3(parsed) || typeof parsed.ok !== "boolean") {
+    return null;
+  }
+  if (parsed.ok !== true || "dryRun" in parsed) {
+    return text2;
+  }
+  if (!("data" in parsed)) {
+    return reprint(text2, withHint(parsed, NO_DATA_HINT));
+  }
+  const masked = { ...parsed, data: maskData(parsed.data, fields) };
+  const miss = unmatchedHint(parsed.data, fields);
+  return reprint(text2, miss ? withHint(masked, miss) : masked);
+}
+function maskWrites(stream, fields) {
+  let applied = false;
+  const write = stream.write.bind(stream);
+  stream.write = (chunk, ...rest) => {
+    const masked = typeof chunk === "string" ? maskPrintedEnvelope(chunk, fields) : null;
+    if (masked === null) {
+      return write(chunk, ...rest);
+    }
+    applied = true;
+    return write(masked, ...rest);
+  };
+  return { sawEnvelope: () => applied };
+}
+function installFieldMask(fields, commandPath) {
+  const mask = maskWrites(process.stdout, fields);
+  process.on("exit", () => {
+    if (!mask.sawEnvelope()) {
+      process.stderr.write(
+        `--fields was not applied: \`baker ${commandPath}\` printed no JSON envelope to narrow. Add --output json to get the envelope, or drop --fields.
+`
+      );
+    }
+  });
+}
+
 // src/version.ts
 import { readFileSync as readFileSync21 } from "fs";
 function packageJsonUrl() {
@@ -69272,6 +69385,7 @@ var main = defineCommand248({
 Auth: Set BAKER_API_KEY (starts with bk_) and BAKER_API_URL environment variables.
 Chat: Set BAKER_CHAT_ID for action and scheduled-agent commands that stage changes against a chat.
 Output: All commands return JSON envelopes: { ok: true, data: ... } or { ok: false, error: { code, message } }.
+Fields: --fields a,b,c keeps only those keys of each record in data, on every command that prints the envelope.
 Formats: --output json works on every command that prints the envelope. --output md|files only where 'baker schema <command>' lists output. (The research commands additionally accept csv and jsonl.)
 Introspection: Run 'baker schema <command>' to inspect argument schemas.`
   },
@@ -69311,6 +69425,11 @@ installStreamTaps();
 logInvocation(process.argv.slice(2));
 installExitRecord();
 process.argv = [...process.argv.slice(0, 2), ...outputFlagForCommand(main, process.argv.slice(2))];
+var fieldsFlag = takeFieldsFlag(main, process.argv.slice(2));
+if (fieldsFlag.fields) {
+  process.argv = [...process.argv.slice(0, 2), ...fieldsFlag.argv];
+  installFieldMask(fieldsFlag.fields, commandPathOf(main, fieldsFlag.argv));
+}
 refuseUnknownFlags(main, process.argv.slice(2));
 process.argv = [...process.argv.slice(0, 2), ...cacheFlagForParser(process.argv.slice(2))];
 runMain(main);