@koda-sl/baker-cli 0.346.0 → 0.347.0-dev.043fc924c

package/dist/cli.js

@@ -67,7 +67,7 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-YBD3W4M7.js";
+} from "./chunk-D5P4COPD.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -76,7 +76,7 @@ import {
   resolveAccountIdArg,
   resolveEffectiveStatus,
   todayIso
-} from "./chunk-NA5CPMUA.js";
+} from "./chunk-JWMLQSGK.js";
 import {
   buildQueryCacheKey,
   cacheGet,
@@ -92,42 +92,33 @@ import {
   writeAdsJson,
   writeAdsOutput,
   writeJsonEnvelope
-} from "./chunk-2IC3CGQO.js";
+} from "./chunk-KGDL7F7M.js";
 import {
   ApiError,
   apiGet,
   apiGetWithHeaders,
   apiPost,
   validateConvexId
-} from "./chunk-4QXKWIFC.js";
+} from "./chunk-XPUSSDLR.js";
 import {
   installExitRecord,
   installStreamTaps,
   logInvocation
-} from "./chunk-XWHHYHKQ.js";
+} from "./chunk-PWGY347J.js";
 import {
-  adContentNormalizer,
   captureBudgetMs,
   captureProxyCredentials,
   captureVimeoCookie,
-  compactImage,
-  compactVideo,
   getEnv,
   hasOpenRouterKey,
   isProxyFailure,
   openRouterKey,
-  optionalChatId,
   plannedRoutes,
   refuseNonPublicUrl,
   requireChatId,
   resolveChatId,
-  shouldEscalate,
-  testimonialNormalizer,
-  videoNormalizer,
-  winningAdNormalizer,
-  writeJson,
-  writeOutput
-} from "./chunk-2OKSJNLA.js";
+  shouldEscalate
+} from "./chunk-4VP5WWPR.js";
 
 // src/cli.ts
 import { defineCommand as defineCommand245, runMain } from "citty";
@@ -168,6 +159,420 @@ import { defineCommand as defineCommand18 } from "citty";
 // src/commands/actions/claim.ts
 import { defineCommand } from "citty";
 
+// src/output.ts
+var ASPECT_RATIO_MAP = {
+  "1:1": 1,
+  "16:9": 16 / 9,
+  "9:16": 9 / 16,
+  "2:3": 2 / 3,
+  "3:4": 3 / 4,
+  "1:2": 1 / 2,
+  "2:1": 2,
+  "4:5": 4 / 5,
+  "3:2": 3 / 2,
+  "4:3": 4 / 3
+};
+var ASPECT_RATIO_TOLERANCE = 0.08;
+function formatAspectRatio(ratio) {
+  if (ratio === void 0 || ratio === null) {
+    return null;
+  }
+  for (const [label, value] of Object.entries(ASPECT_RATIO_MAP)) {
+    if (Math.abs(ratio - value) / value < ASPECT_RATIO_TOLERANCE) {
+      return label;
+    }
+  }
+  return null;
+}
+function groupSummary(record) {
+  const key = record.groupKey;
+  if (typeof key !== "string" || !key) {
+    return null;
+  }
+  const index = typeof record.groupIndex === "number" ? record.groupIndex : null;
+  const size = typeof record.groupSize === "number" ? record.groupSize : null;
+  return {
+    key,
+    kind: typeof record.groupKind === "string" ? record.groupKind : null,
+    position: index === null ? null : size === null ? `${index + 1}` : `${index + 1} of ${size}`,
+    title: typeof record.groupTitle === "string" ? record.groupTitle : null,
+    url: typeof record.groupUrl === "string" ? record.groupUrl : null
+  };
+}
+function peopleLines(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.flatMap((entry) => {
+    const person = asRecord(entry);
+    const role = typeof person.role === "string" ? person.role : "";
+    if (!role) {
+      return [];
+    }
+    const identity = typeof person.identity === "string" && person.identity ? ` \u2014 ${person.identity}` : "";
+    const appearance = typeof person.appearance === "string" && person.appearance ? ` (${person.appearance})` : "";
+    const speaking = person.speaking === true ? " [speaking]" : "";
+    return [`${role}${identity}${appearance}${speaking}`];
+  });
+}
+function compactImage(image) {
+  const analysis = asRecord(image.analysis);
+  return {
+    _id: String(image._id ?? ""),
+    name: String(image.name ?? ""),
+    imageUrl: String(image.imageUrl ?? ""),
+    description: String(image.description ?? ""),
+    tags: Array.isArray(image.tags) ? image.tags : [],
+    // Two numbers that are not about choosing the image but about placing it.
+    // A remote <BakerImage> with no width/height makes Astro DOWNLOAD the file
+    // at build time just to measure it — one request per image per build, on a
+    // build that is otherwise offline, and a single dropped connection there
+    // fails a client's whole verify. They are cheap enough to always carry, and
+    // burying them behind --full meant the agent placing the image never had
+    // them.
+    width: typeof image.width === "number" ? image.width : null,
+    height: typeof image.height === "number" ? image.height : null,
+    // The facts that decide a pick, so choosing does not need a second call:
+    // whose brand it is, who is in it, and what text is burned in.
+    subject: typeof analysis.subject === "string" ? analysis.subject : null,
+    brandOwnership: typeof analysis.brandOwnership === "string" ? analysis.brandOwnership : null,
+    people: peopleLines(analysis.people),
+    textInImage: Array.isArray(analysis.textInImage) ? analysis.textInImage : [],
+    group: groupSummary(image)
+  };
+}
+function fullImage(image) {
+  const compact3 = compactImage(image);
+  return {
+    ...compact3,
+    aspectRatio: formatAspectRatio(image.aspectRatio),
+    dominantColor: image.dominantColor ?? null,
+    imagePalette: Array.isArray(image.imagePalette) ? image.imagePalette : [],
+    source: String(image.source ?? ""),
+    externalUrl: image.externalUrl ?? null,
+    originalFilename: image.originalFilename ?? null,
+    descriptionContext: image.descriptionContext ?? null,
+    style: typeof asRecord(image.analysis).style === "string" ? asRecord(image.analysis).style : null,
+    composition: typeof asRecord(image.analysis).composition === "string" ? asRecord(image.analysis).composition : null,
+    usageNotes: typeof asRecord(image.analysis).usageNotes === "string" ? asRecord(image.analysis).usageNotes : null,
+    createdAt: image.createdAt ?? null
+  };
+}
+function imageNormalizer(record, full) {
+  if (full) {
+    return fullImage(record);
+  }
+  return compactImage(record);
+}
+function compactVideo(video) {
+  const analysis = asRecord(video.analysis);
+  const sceneCount = typeof video.sceneCount === "number" ? video.sceneCount : Array.isArray(video.scenes) ? video.scenes.length : 0;
+  return {
+    _id: String(video._id ?? ""),
+    name: String(video.name ?? ""),
+    thumbnailUrl: String(video.thumbnailUrl ?? ""),
+    description: String(video.description ?? ""),
+    tags: Array.isArray(video.tags) ? video.tags : [],
+    status: String(video.status ?? ""),
+    // What decides whether this clip is usable, without a second call: who is
+    // on camera and in what role, what language they speak, how it opens, and
+    // how many beats there are to cut from.
+    subject: typeof analysis.subject === "string" ? analysis.subject : null,
+    brandOwnership: typeof analysis.brandOwnership === "string" ? analysis.brandOwnership : null,
+    people: peopleLines(analysis.people),
+    spokenLanguages: Array.isArray(analysis.spokenLanguages) ? analysis.spokenLanguages : [],
+    hook: typeof analysis.hook === "string" ? analysis.hook : null,
+    sceneCount,
+    group: groupSummary(video)
+  };
+}
+function sceneDecoration(scene) {
+  const shot = typeof scene.shot === "string" && scene.shot ? ` [${scene.shot}]` : "";
+  const change = typeof scene.visualChange === "string" && scene.visualChange ? ` <${scene.visualChange}>` : "";
+  const overlayText = Array.isArray(scene.onScreenText) ? scene.onScreenText.filter(Boolean) : [];
+  let overlay = "";
+  if (scene.hasOverlay === true) {
+    overlay = overlayText.length > 0 ? ` \u2014 banner: "${overlayText.join('" / "')}"` : " \u2014 banner";
+  } else if (scene.hasOverlay === false) {
+    overlay = " \u2014 clean frame";
+  }
+  const spoken = typeof scene.spoken === "string" && scene.spoken ? ` \u2014 says: "${scene.spoken}"` : "";
+  return `${shot}${change}${overlay}${spoken}`;
+}
+function sceneLines(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.flatMap((s) => {
+    const scene = asRecord(s);
+    const title = typeof scene.title === "string" ? scene.title : "";
+    if (!title) {
+      return [];
+    }
+    const start = round2(scene.startSecond);
+    const end = round2(scene.endSecond);
+    const range = start !== null && end !== null ? ` (${start}-${end}s)` : "";
+    return [`${title}${range}${sceneDecoration(scene)}`];
+  });
+}
+function fullVideo(video) {
+  const compact3 = compactVideo(video);
+  return {
+    ...compact3,
+    duration: video.duration ?? null,
+    muxPlaybackId: String(video.muxPlaybackId ?? ""),
+    source: String(video.source ?? ""),
+    // The spoken transcript + AI scene breakdown of the client's own clip — the
+    // "understand what's in this video" payload. Kept out of the compact/search
+    // projection (too large for a list) and surfaced here on --full.
+    transcript: video.transcript ?? null,
+    transcript_segment_count: Array.isArray(video.transcriptSegments) ? video.transcriptSegments.length : 0,
+    scenes: sceneLines(video.scenes),
+    originalFilename: video.originalFilename ?? null,
+    descriptionContext: video.descriptionContext ?? null,
+    shotStyle: typeof asRecord(video.analysis).shotStyle === "string" ? asRecord(video.analysis).shotStyle : null,
+    audioStyle: typeof asRecord(video.analysis).audioStyle === "string" ? asRecord(video.analysis).audioStyle : null,
+    onScreenText: Array.isArray(asRecord(video.analysis).onScreenText) ? asRecord(video.analysis).onScreenText : [],
+    usageNotes: typeof asRecord(video.analysis).usageNotes === "string" ? asRecord(video.analysis).usageNotes : null,
+    createdAt: video.createdAt ?? null
+  };
+}
+function videoNormalizer(record, full) {
+  if (full) {
+    return fullVideo(record);
+  }
+  return compactVideo(record);
+}
+function truncate(text2, maxLength) {
+  if (text2.length <= maxLength) return text2;
+  return `${text2.slice(0, maxLength)}...`;
+}
+function compactTestimonial(record) {
+  return {
+    _id: String(record._id ?? ""),
+    reviewerName: String(record.reviewerName ?? ""),
+    reviewText: truncate(String(record.reviewText ?? ""), 200),
+    rating: record.rating ?? null,
+    sentiment: record.sentiment ?? null,
+    tags: Array.isArray(record.tags) ? record.tags : [],
+    sourceType: String(record.sourceType ?? "")
+  };
+}
+function fullTestimonial(record) {
+  const compact3 = compactTestimonial(record);
+  return {
+    ...compact3,
+    reviewText: String(record.reviewText ?? ""),
+    highlight: record.highlight ?? null,
+    summary: record.summary ?? null,
+    language: record.language ?? null,
+    reviewerImageUrl: record.reviewerImageUrl ?? null,
+    sourceUrl: record.sourceUrl ?? null,
+    reviewDate: record.reviewDate ?? null,
+    createdAt: record.createdAt ?? null,
+    status: String(record.status ?? "")
+  };
+}
+function testimonialNormalizer(record, full) {
+  if (full) {
+    return fullTestimonial(record);
+  }
+  return compactTestimonial(record);
+}
+function round2(value) {
+  if (typeof value !== "number" || Number.isNaN(value)) {
+    return null;
+  }
+  return Math.round(value * 100) / 100;
+}
+function asRecord(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function compactWinningAd(record) {
+  const dna = asRecord(record.dna);
+  return {
+    advertiser: String(record.advertiser ?? ""),
+    platform: String(record.platform ?? ""),
+    format: String(record.format ?? ""),
+    relevance: round2(record.relevance),
+    winner_score: round2(record.winner_score),
+    summary: String(dna.creative_concept ?? ""),
+    advertiser_id: String(record.advertiser_id ?? ""),
+    ad_id: String(record.ad_id ?? ""),
+    media_url: String(record.media_url ?? "")
+  };
+}
+function fullWinningAd(record) {
+  const compact3 = compactWinningAd(record);
+  const dna = asRecord(record.dna);
+  return {
+    ...compact3,
+    winner_category: String(record.winner_category ?? ""),
+    media_kind: record.media_kind ?? null,
+    days_active: record.days_active ?? null,
+    reach: record.reach ?? null,
+    active: typeof record.active === "boolean" ? record.active : null,
+    angle: dna.angle ?? null,
+    awareness_stage: dna.awareness_stage ?? null,
+    target_persona: dna.target_persona ?? null,
+    hook_archetype: dna.hook_archetype ?? null,
+    industry: dna.industry ?? null
+  };
+}
+function winningAdNormalizer(record, full) {
+  if (full) {
+    return fullWinningAd(record);
+  }
+  return compactWinningAd(record);
+}
+function overlayLines(value, detailed = false) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.flatMap((o) => {
+    const item = asRecord(o);
+    const text2 = typeof item.text === "string" ? item.text : "";
+    if (!text2) {
+      return [];
+    }
+    const at = round2(item.appears_at_s);
+    let line = at !== null ? `${text2} @${at}s` : text2;
+    if (detailed) {
+      const tags = [item.role, item.position].filter((t) => typeof t === "string" && t.length > 0);
+      if (tags.length) {
+        line += ` [${tags.join(", ")}]`;
+      }
+    }
+    return [line];
+  });
+}
+function compactAdContent(record) {
+  return {
+    ad_id: record.ad_id ?? null,
+    advertiser: record.advertiser ?? null,
+    format: record.format ?? null,
+    media_kind: record.media_kind ?? null,
+    media_url: record.media_url ?? null,
+    summary: record.summary ?? null,
+    transcript: record.transcript ?? null,
+    on_screen_text: overlayLines(record.on_screen_text),
+    has_captions: typeof record.has_captions === "boolean" ? record.has_captions : null,
+    primary_text: record.primary_text ?? null,
+    headline: record.headline ?? null,
+    cta: record.cta ?? null
+  };
+}
+function fullAdContent(record) {
+  const speech = asRecord(record.speech);
+  const pacing = asRecord(record.pacing);
+  const music = asRecord(record.music);
+  return {
+    ...compactAdContent(record),
+    platform: record.platform ?? null,
+    // Re-derive with role/position tags — the lean compact version dropped them.
+    on_screen_text: overlayLines(record.on_screen_text, true),
+    winner_score: round2(record.winner_score),
+    winner_category: record.winner_category ?? null,
+    angle: record.angle ?? null,
+    hook_archetype: record.hook_archetype ?? null,
+    caption_style: record.caption_style ?? null,
+    has_speech: typeof record.has_speech === "boolean" ? record.has_speech : null,
+    speech_pct_of_runtime: round2(speech.speech_pct_of_runtime),
+    speaker_count: speech.speaker_count ?? null,
+    voiceover_vs_sync: speech.voiceover_vs_sync ?? null,
+    is_direct_address: typeof speech.is_direct_address === "boolean" ? speech.is_direct_address : null,
+    speech_emotion_dominant: speech.speech_emotion_dominant ?? null,
+    scene_count: pacing.scene_count ?? null,
+    avg_shot_length_s: round2(pacing.avg_shot_length_s),
+    pacing_shape: pacing.pacing_shape ?? null,
+    hook_ends_at_s: round2(pacing.hook_ends_at_s),
+    cta_first_shown_at_s: round2(pacing.cta_first_shown_at_s),
+    product_first_appears_at_s: round2(pacing.product_first_appears_at_s),
+    music_track_title: music.track_title ?? null,
+    music_track_artist: music.track_artist ?? null
+  };
+}
+function adContentNormalizer(record, full) {
+  return full ? fullAdContent(record) : compactAdContent(record);
+}
+function applyFieldMask(data, fields) {
+  const result = {};
+  for (const field of fields) {
+    if (field in data) {
+      result[field] = data[field];
+    }
+  }
+  return result;
+}
+function write(text2) {
+  process.stdout.write(text2);
+}
+function writeJson(envelope) {
+  write(`${JSON.stringify(envelope, null, 2)}
+`);
+}
+function writeFiles(data, fields) {
+  write(`${fields.join("	")}
+`);
+  for (const item of data) {
+    const values = fields.map((f) => String(item[f] ?? ""));
+    write(`${values.join("	")}
+`);
+  }
+}
+function writeMd(data, fields) {
+  write(`| ${fields.join(" | ")} |
+`);
+  write(`| ${fields.map(() => "---").join(" | ")} |
+`);
+  for (const item of data) {
+    const values = fields.map((f) => String(item[f] ?? ""));
+    write(`| ${values.join(" | ")} |
+`);
+  }
+}
+function normalizeData(envelope, fields, full, normalizer) {
+  const raw = Array.isArray(envelope.data) ? envelope.data : [envelope.data];
+  const items = raw.map((item) => {
+    const record = item;
+    return normalizer(record, full);
+  });
+  if (fields) {
+    return items.map((item) => applyFieldMask(item, fields));
+  }
+  return items;
+}
+function writeOutput(envelope, format, fields, full, normalizer) {
+  if (!envelope.ok || "dryRun" in envelope) {
+    writeJson(envelope);
+    return;
+  }
+  if (format === "json") {
+    writeJson(envelope);
+    return;
+  }
+  if (format !== "files" && format !== "md") {
+    process.stderr.write(`Unknown --output "${String(format)}". Valid formats: json, files, md. Using json.
+`);
+    writeJson(envelope);
+    return;
+  }
+  const items = normalizeData(envelope, fields, full ?? false, normalizer ?? imageNormalizer);
+  const displayFields = fields ?? Object.keys(items[0] ?? {});
+  if (format === "files") {
+    writeFiles(items, displayFields);
+  } else {
+    writeMd(items, displayFields);
+  }
+  writeHints(envelope.hints);
+}
+function writeHints(hints2) {
+  for (const hint of hints2 ?? []) {
+    process.stderr.write(`${hint}
+`);
+  }
+}
+
 // src/schemas.ts
 var registry = /* @__PURE__ */ new Map();
 function registerSchema(schema) {
@@ -384,6 +789,50 @@ var actionsUpdateRequestSchema = z.object({
 var actionsUpdateResponseSchema = okOnlySchema();
 var ACTION_COMPLETE_NOTE_MIN = 20;
 var actionsCompleteNoteMessage = `A completion note (\u2265${ACTION_COMPLETE_NOTE_MIN} chars) describing what was done is required: what changed, where, and the outcome.`;
+var ACCOUNT_CONTEXT = "(?:account|accounts|cuenta|cuentas|customer|cliente|property|propiedad|meta|facebook|google|ads|linkedin|ga4|analytics|gtm|tag manager|id)";
+var COMPLETION_NOTE_INTERNALS = [
+  // Repo paths: rooted in a workspace directory, or a path or lowercase file name
+  // ending in a source extension (a product name like "Next.js" is not a file).
+  /(?:\.{0,2}\/)?(?:src|public|__tooling__|\.claude)\/[^\s,;:)`'"]*[^\s,;:)`'".]/g,
+  /(?:[\w.-]*\/[\w./-]*|\b[a-z_][\w-]*)\.(?:mdx?|astro|tsx?|jsx?|mjs|json|ya?ml)\b/g,
+  // Meta ad-account ids, Tag Manager containers and GA4 measurement ids.
+  /\bact_\d+\b/g,
+  /\bGTM-[A-Z0-9]{4,}\b/g,
+  /\bG-[A-Z0-9]{6,}\b/g,
+  // Google Ads customer ids (386-508-3115), LinkedIn, GA4 and bare Google Ads ids:
+  // a long number named next to a platform or an account, so a phone number or
+  // a figure elsewhere in the note is not one.
+  new RegExp(
+    String.raw`(?<=\b${ACCOUNT_CONTEXT}\b[^.\n\d]{0,20})(?<![\w-])(?:\d{3}-\d{3}-\d{4}|\d{7,})(?![\w-])`,
+    "gi"
+  ),
+  // Error codes: SCREAMING_SNAKE in the shapes platforms and Baker return them
+  // (NO_GOOGLE_ADS_CONNECTION, PERMISSION_DENIED, INVALID_ACCOUNT_ID).
+  /\b(?:(?:ERR|INVALID|MISSING)(?:_[A-Z0-9]+)+|[A-Z][A-Z0-9]*(?:_[A-Z0-9]+)*_(?:ERROR|CONNECTION|FAILED|NOT_FOUND|DENIED|REQUIRED|INVALID|EXPIRED|UNAVAILABLE|EXCEEDED|UNREACHABLE|UNAUTHORIZED|FORBIDDEN|TIMEOUT|TOKEN)|BAD_REQUEST|NOT_FOUND|RATE_LIMITED)\b/g,
+  // CLI invocations (`baker analytics flow`).
+  /\bbaker [a-z][a-z-]*/g
+];
+function completionNoteInternals(note) {
+  const hits = [];
+  for (const pattern of COMPLETION_NOTE_INTERNALS) {
+    for (const match of note.matchAll(pattern)) {
+      const index = match.index ?? 0;
+      hits.push({ index, end: index + match[0].length, text: match[0] });
+    }
+  }
+  hits.sort((a, b) => a.index - b.index || b.end - a.end);
+  const found = [];
+  let coveredUntil = -1;
+  for (const hit of hits) {
+    if (hit.index < coveredUntil) continue;
+    found.push(hit.text);
+    coveredUntil = hit.end;
+  }
+  return found;
+}
+function completionNoteInternalsMessage(internals) {
+  return `The completion note is read by the client on the Task, and it carries internal details they cannot use: ${internals.join(", ")}. Rewrite it in product terms \u2014 name the page, campaign or Knowledge entry instead of a file, the platform instead of an account id, and say what is missing instead of an error code.`;
+}
 var actionsCompleteRequestSchema = z.object({
   chatId: z.string(),
   actionRef: z.string().min(1, "actionRef is required"),
@@ -391,6 +840,11 @@ var actionsCompleteRequestSchema = z.object({
 }).transform((body) => ({ ...body, note: (body.note ?? "").trim() })).refine((body) => body.note.length >= ACTION_COMPLETE_NOTE_MIN, {
   message: actionsCompleteNoteMessage,
   path: ["note"]
+}).superRefine((body, ctx) => {
+  const internals = completionNoteInternals(body.note);
+  if (internals.length > 0) {
+    ctx.addIssue({ code: "custom", message: completionNoteInternalsMessage(internals), path: ["note"] });
+  }
 });
 var actionsCompleteResponseSchema = okOnlySchema();
 var actionsDiscardRequestSchema = z.object({
@@ -8055,12 +8509,12 @@ 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`. 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`.",
+  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 shown on the Task in Tasks and surfaced by `baker actions log`, so write it for a marketer, in the client\'s language and product terms: a few lines, no file paths, account ids, error codes or `baker` commands ("Weekly review saved in your Knowledge; Google Ads and LinkedIn are not connected yet", not "written to src/content/audits/\u2026md; NO_GOOGLE_ADS_CONNECTION"). A note carrying those is refused. 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: {
       type: "string",
-      description: "REQUIRED. Detailed description of what you did to resolve this: what changed, where, and the outcome. This is the durable, client-facing record shown by `baker actions log`.",
+      description: "REQUIRED. What you did to resolve this \u2014 what changed, where (in product terms: the page, the campaign, Knowledge), and the outcome \u2014 in a few lines. The client reads it on the Task: no file paths, account ids, error codes or `baker` commands.",
       required: true
     }
   }
@@ -8075,7 +8529,7 @@ var completeCommand = defineCommand2({
     "action-id": { type: "string", description: "Action ID or temp ID", required: false },
     note: {
       type: "string",
-      description: "REQUIRED. What you did to resolve this: what changed, where, and the outcome.",
+      description: "REQUIRED. What you did, where (in product terms) and the outcome \u2014 read by the client, so no file paths, account ids or error codes.",
       required: false
     }
   },
@@ -8094,6 +8548,10 @@ var completeCommand = defineCommand2({
           `--note is required and must describe what you did (\u2265${ACTION_COMPLETE_NOTE_MIN} chars): what changed, where, and the outcome. This becomes the client-facing record surfaced by \`baker actions log\`.`
         );
       }
+      const internals = completionNoteInternals(note);
+      if (internals.length > 0) {
+        failValidation(`--note: ${completionNoteInternalsMessage(internals)} Then run the same command again.`);
+      }
       const chatId = requireChatId();
       await apiPost("/api/actions/complete", { chatId, actionRef: id, note });
       writeOk();
@@ -12677,8 +13135,8 @@ var writeMdRows = (rows, fields, notices) => {
 };
 var ROW_WRITERS = { csv: writeCsvRows, jsonl: writeJsonlRows, md: writeMdRows };
 function writeRows(format, rows, columns, notices) {
-  const write = ROW_WRITERS[format] ?? writeMdRows;
-  write(rows, columns, notices);
+  const write2 = ROW_WRITERS[format] ?? writeMdRows;
+  write2(rows, columns, notices);
   if (rows.length > REPEAT_NOTICE_ABOVE_ROWS) {
     for (const line of notices) writeLine(line);
   }
@@ -21881,7 +22339,7 @@ Subcommands:
 
 // src/commands/ads/linkedin/creatives.ts
 import { defineCommand as defineCommand44 } from "citty";
-function asRecord(value) {
+function asRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
 }
 function asString(value) {
@@ -21891,12 +22349,12 @@ function creativeDestination(content) {
   if (!content) return { format: "unknown" };
   const reference = asString(content.reference);
   if (reference) return { format: "post", postUrn: reference };
-  const textAd = asRecord(content.textAd);
+  const textAd = asRecord2(content.textAd);
   if (textAd) return { format: "text", landingUrl: asString(textAd.landingPage) };
-  const spotlight = asRecord(content.spotlight);
+  const spotlight = asRecord2(content.spotlight);
   if (spotlight) return { format: "spotlight", landingUrl: asString(spotlight.landingPage) };
-  if (asRecord(content.follower)) return { format: "follower" };
-  if (asRecord(content.jobs)) return { format: "jobs" };
+  if (asRecord2(content.follower)) return { format: "follower" };
+  if (asRecord2(content.jobs)) return { format: "jobs" };
   return { format: "unknown" };
 }
 var COMPACT_COLUMNS = [
@@ -21927,7 +22385,7 @@ function compactRow(row) {
 function readPath(row, path48) {
   let current = row;
   for (const segment of path48.split(".")) {
-    const record = asRecord(current);
+    const record = asRecord2(current);
     if (!record) return void 0;
     current = record[segment];
   }
@@ -25300,10 +25758,10 @@ Example: baker ads meta ads retag 120252158038400247 --url-tags "utm_source={{si
     }
   },
   run: async ({ args: args5 }) => {
-    const { apiPost: apiPost2 } = await import("./client-ODCNYCP4.js");
-    const { requireChatId: requireChatId2 } = await import("./env-BSG7TY5Y.js");
-    const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-2XBCYF7L.js");
-    const { handleMetaError: handleMetaError2 } = await import("./shared-RYAF7Y7H.js");
+    const { apiPost: apiPost2 } = await import("./client-PWRZOA3Q.js");
+    const { requireChatId: requireChatId2 } = await import("./env-TQTHWLBN.js");
+    const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-HD63GTWI.js");
+    const { handleMetaError: handleMetaError2 } = await import("./shared-5662SBDW.js");
     try {
       const accountId = bareAccountId2(args5);
       const urlTags = typeof args5["url-tags"] === "string" ? args5["url-tags"] : void 0;
@@ -25448,10 +25906,10 @@ function duplicateCommand2(entity, label) {
       replace: { type: "boolean", description: "Pause the original once the copy publishes" }
     },
     run: async ({ args: args5 }) => {
-      const { apiPost: apiPost2 } = await import("./client-ODCNYCP4.js");
-      const { requireChatId: requireChatId2 } = await import("./env-BSG7TY5Y.js");
-      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-2XBCYF7L.js");
-      const { handleMetaError: handleMetaError2 } = await import("./shared-RYAF7Y7H.js");
+      const { apiPost: apiPost2 } = await import("./client-PWRZOA3Q.js");
+      const { requireChatId: requireChatId2 } = await import("./env-TQTHWLBN.js");
+      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-HD63GTWI.js");
+      const { handleMetaError: handleMetaError2 } = await import("./shared-5662SBDW.js");
       try {
         const accountId = bareAccountId2(args5);
         const chatId = requireChatId2();
@@ -33068,8 +33526,8 @@ var conversionsCommand3 = (() => {
         const args6 = parseConversionsArgs(raw, process.argv);
         for (const eventKey of args6.eventKeys) refuseUnmatchableKey(eventKey);
         const before = await apiPost("/api/analytics/conversions", {});
-        const write = conversionsWrite(args6, before.data.definitions);
-        const stored = write ? (await apiPost("/api/analytics/conversions", write)).data.definitions : before.data.definitions;
+        const write2 = conversionsWrite(args6, before.data.definitions);
+        const stored = write2 ? (await apiPost("/api/analytics/conversions", write2)).data.definitions : before.data.definitions;
         const report = await apiPost("/api/analytics/query", {
           preset: "conversions",
           days: args6.days
@@ -33445,7 +33903,11 @@ function rosterRow(avatar) {
   };
 }
 function chatIdFromEnv() {
-  return optionalChatId();
+  try {
+    return getEnv().BAKER_CHAT_ID || void 0;
+  } catch {
+    return void 0;
+  }
 }
 function rosterHints(roster, statusFilter) {
   if (roster.length === 0) {
@@ -38974,7 +39436,7 @@ function sceneSpokenText(scene) {
   return (scene.dialogue ?? []).map((d) => d.line?.trim()).filter((l) => Boolean(l)).join(" ") || null;
 }
 function buildMotionBoard(blueprint) {
-  const round4 = (n) => Math.round(n * 100) / 100;
+  const round5 = (n) => Math.round(n * 100) / 100;
   let cursor = 0;
   return blueprint.scenes.map((scene, i) => {
     const start_s = scene.start_s ?? cursor;
@@ -38986,15 +39448,15 @@ function buildMotionBoard(blueprint) {
     const graphics = [
       ...(overlays.success ? overlays.data : []).filter((ov) => ov.text?.trim()).map((ov) => ({
         kind: "text",
-        at_s: round4(ov.appears_at_s ?? start_s),
-        dur_s: round4(ov.duration_s ?? 2.5),
+        at_s: round5(ov.appears_at_s ?? start_s),
+        dur_s: round5(ov.duration_s ?? 2.5),
         position: ov.position ?? "bottom_center",
         text: ov.text?.trim()
       })),
       ...(floats.success ? floats.data : []).map((fe) => ({
         kind: "graphic",
-        at_s: round4(fe.appears_at_s ?? start_s),
-        dur_s: round4(fe.duration_s ?? 2.5),
+        at_s: round5(fe.appears_at_s ?? start_s),
+        dur_s: round5(fe.duration_s ?? 2.5),
         position: fe.position ?? "bottom_center",
         label: fe.brand_name || fe.what_it_represents || fe.description || fe.kind || "element"
       }))
@@ -39002,7 +39464,7 @@ function buildMotionBoard(blueprint) {
     return {
       scene: i,
       role: resolveSceneRole(scene, i, blueprint.scenes.length),
-      window_s: [round4(start_s), round4(end_s)],
+      window_s: [round5(start_s), round5(end_s)],
       // A continuation b-roll scene shares the previous scene's end frame as its start
       // (no own `s<i>_start` node), so point the storyboard at that shared keyframe.
       storyboard_frames: [scene.continues_previous && i > 0 ? `s${i - 1}_end` : `s${i}_start`],
@@ -40765,7 +41227,7 @@ ${describeRewrites(healed.rewrites)}
     // "edited since last render". Computed from the on-disk canvas.json +
     // prompt.json — the same helper the edit-sync uses, so the two are comparable.
     sourceSha: await computeSourceSha(filePath),
-    chatId: optionalChatId(),
+    chatId: getEnv().BAKER_CHAT_ID || void 0,
     canvasSnapshotUrl
   };
   if (client) {
@@ -44756,7 +45218,11 @@ function detectCreativeContentType(filePath) {
   });
 }
 function chatIdFromEnv2() {
-  return optionalChatId();
+  try {
+    return getEnv().BAKER_CHAT_ID || void 0;
+  } catch {
+    return void 0;
+  }
 }
 function parseOptionalUrl(value) {
   if (value === void 0 || value.trim() === "") {
@@ -52673,7 +53139,7 @@ var extractCommand = defineCommand149({
 import { defineCommand as defineCommand150 } from "citty";
 
 // src/commands/images/providerHits.ts
-function asRecord2(value) {
+function asRecord3(value) {
   return value && typeof value === "object" ? value : {};
 }
 function str(value) {
@@ -52698,7 +53164,7 @@ function providerHitNormalizer(record, full) {
   if (!full) {
     return compact3;
   }
-  const group = asRecord2(record.group);
+  const group = asRecord3(record.group);
   return {
     ...compact3,
     externalUrl: str(record.externalUrl),
@@ -56603,7 +57069,7 @@ function dedupe(findings) {
 
 // src/engine/landing/lib/critique.ts
 var FAMILIES = ["typography", "color", "borders_depth", "motion", "spacing", "copy", "integrity"];
-function round2(n) {
+function round4(n) {
   return Math.round(n * 100) / 100;
 }
 function clamp012(n) {
@@ -56640,11 +57106,11 @@ function critiqueLanding(input) {
   const dimensions = FAMILIES.map((family) => {
     const fam = findings.filter((f) => f.family === family);
     const penalty = fam.reduce((s, f) => s + SEVERITY_WEIGHT[f.severity], 0);
-    const score = round2(clamp012(1 - penalty));
+    const score = round4(clamp012(1 - penalty));
     const note = fam.length === 0 ? "clean" : `${fam.length} finding(s): ${describeCounts(fam)}`;
     return { dimension: family, score, note };
   });
-  const overall = round2(dimensions.reduce((s, d) => s + d.score, 0) / dimensions.length);
+  const overall = round4(dimensions.reduce((s, d) => s + d.score, 0) / dimensions.length);
   const counts = {
     block: findings.filter((f) => f.severity === "block").length,
     warn: findings.filter((f) => f.severity === "warn").length,
@@ -60803,7 +61269,7 @@ function writeJsonl(data) {
 `);
   }
 }
-function writeMd(data, fields) {
+function writeMd2(data, fields) {
   if (data.length === 0) return;
   const cols = fields ?? Object.keys(data[0] ?? {});
   process.stdout.write(`| ${cols.join(" | ")} |
@@ -60825,7 +61291,7 @@ function writeResearchOutput(data, format, fields) {
       writeJsonl(data);
       break;
     case "md":
-      writeMd(data, fields);
+      writeMd2(data, fields);
       break;
     default:
       writeResearchJson({ ok: true, data });